RSDT: Difference between revisions
Revision as of 16:09, 10 March 2011
RSDT (Root System Description Table) is a data structure used in the ACPI programming interface. This table contains pointers to all the other System Description Tables.
Detecting the RSDT
To find the RSDT you need first to locate and check the RSDP, then use the RsdtPointer for ACPI Version < 2.0 an XsdtPointer for any other case.
The ACPI standards state that an OS that complies with ACPI version 2.0 or later should use the XSDT instead of the RSDT, however I personally doubt that there is a difference on 80x86 computers. AFAIK the XSDT itself was introduced for Itanium's (IA64) and other 64 bit computers where it's likely that the BIOS (and ACPI tables) are above 4 GB. On 80x86 it's likely that the RSDT and the XSDT both point to the same tables below 4 GB for compatibility reasons (it doesn't make sense to have 2 versions of the same tables) -- Brendan.
Validating the RSDT
You only need to sum all the bytes in the table and compare the result to 0.
Structure
The RSDT is the main System Description Table. However there are many kinds of SDT. All the SDT may be split into two parts. One (the header) which is common to all the SDT an another (data) which is different for each table. The structure of the header is:
structACPISDTHeader{ charSignature[4]; uint32_tLength; uint8_tRevision; uint8_tChecksum; charOEMID[6]; charOEMTableID[8]; uint32_tOEMRevision; uint32_tCreatorID; uint32_tCreatorRevision; }
In case you used RsdtPointer, the complete table structure is:
structRSDT{ structACPISDTHeaderh; uint32_tPointerToOtherSDT[(h.Length-sizeof(h))/4]; }
If you instead used the XsdtPointer, then the table is:
structXSDT{ structACPISDTHeaderh; uint64_tPointerToOtherSDT[(h.Length-sizeof(h))/8]; }
How to use
Well, suppose you want to find the FADT. The FADT, being a SDT has a ACPISDTHeader. It's signature is "FACP". You may use this code:
void*findFACP(void*RootSDT){ RSDT*rsdt=(RSDT*)RootSDT; intn=(rsdt->h.Length-sizeof(rsdt->h))/4; for(inti=0;i<n;i++){ ACPISDTHeader*h=(ACPISDTHeader*)rsdt->PointerToOtherSDT[i]; if(!strncmp(h->Signature,"FACP")) return(void*)h; } returnNULL; }
What's next?
You should now parse each table pointed by the RSDP. (Probably you will need only the FADT, the SSDT and the MADT