972
edits
[unchecked revision] | [unchecked revision] |
No edit summary |
m (Bot: Replace deprecated source tag with syntaxhighlight) |
||
(20 intermediate revisions by 13 users not shown) | |||
Line 1:
{{ACPI}}
'''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.
Line 4 ⟶ 6:
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 (
==Validating the RSDT==
You only need to sum all the bytes in the table and compare the result to 0 (mod 0x100).
==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
The structure of the header is:
<
struct ACPISDTHeader {
char Signature[4];
char OEMID[6];
char OEMTableID[8];
};
</syntaxhighlight>
=== Header fields ===
==== Signature ====
All the ACPI tables have a 4 byte Signature field (except the RSDP which has an 8 byte one). Using the signature, you can determine what table are you working with.
==== Length ====
Total size of the table, inclusive of the header.
==== Checksum ====
A 8-bit checksum field of the whole table, inclusive of the header. All bytes of the table summed must be equal to 0 (mod 0x100). You should always do a checksum of the table before using it, even if you found the table linked by other tables.
<syntaxhighlight lang="c">
bool doChecksum(ACPISDTHeader *tableHeader)
{
unsigned char sum = 0;
for (int i = 0; i < tableHeader->Length; i++)
{
sum += ((char *) tableHeader)[i];
}▼
}
</syntaxhighlight>
=== Other fields ===
In case you used RsdtPointer, the complete table structure is:
<
struct RSDT {
struct ACPISDTHeader h;
};
</syntaxhighlight>
If you instead used the XsdtPointer, then the table is:
<
struct XSDT {
struct ACPISDTHeader h;
};
</syntaxhighlight>
== 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)
{
ACPISDTHeader *h = (ACPISDTHeader *) rsdt->PointerToOtherSDT[i];▼
for (int i = 0; i < entries; i++)
if (!strncmp(h->Signature, "FACP"))▼
{
▲ return (void *) h;
▲ ACPISDTHeader *h = (ACPISDTHeader *) rsdt->PointerToOtherSDT[i];
▲ }
▲ if (!strncmp(h->Signature, "FACP", 4))
return NULL;▼
return (void *) h;
}
// No FACP found
▲ return NULL;
}
</syntaxhighlight>
== What can you find? ==
=== Defined by ACPI ===
The ACPI Specification 5.0 has direct definitions for the following System Descriptor tables, identified by their signatures:
* "APIC": Multiple APIC Description Table ([[MADT]])
* "BERT": Boot Error Record Table ([[BERT]])
* "CPEP": Corrected Platform Error Polling Table ([[CPEP]])
* "DSDT": Differentiated System Description Table ([[DSDT]])
* "ECDT": Embedded Controller Boot Resources Table ([[ECDT]])
* "EINJ": Error Injection Table ([[EINJ]])
* "ERST": Error Record Serialization Table ([[ERST]])
* "FACP": Fixed ACPI Description Table ([[FADT]])
* "FACS": Firmware ACPI Control Structure ([[FACS]])
* "HEST": Hardware Error Source Table ([[HEST]])
* "MSCT": Maximum System Characteristics Table ([[MSCT]])
* "MPST": Memory Power State Table ([[MPST]])
* "OEMx": OEM Specific Information Tables (Any table with a signature beginning with "OEM" falls into this definition)
* "PMTT" Platform Memory Topology Table ([[PMTT]])
* "PSDT": Persistent System Description Table ([[PSDT]])
* "RASF": ACPI RAS Feature Table ([[RASF]])
* "RSDT": Root System Description Table (This wiki page; included for completeness)
* "SBST": Smart Battery Specification Table ([[SBST]])
* "SLIT": System Locality System Information Table ([[SLIT]])
* "SRAT": System Resource Affinity Table ([[SRAT]])
* "SSDT": Secondary System Description Table ([[SSDT]])
* "XSDT": Extended System Description Table ([[XSDT]]; 64-bit version of the RSDT)
=== Reserved by ACPI ===
The ACPI specification maintains reservations for additional third party defined description tables. Each third party submitting a request for a reservation also maintains a specification for these tables, located on individual sites. See the ACPI spec ([http://www.acpi.info/spec50.htm]) for more information.
== What's next? ==
You should now parse each table pointed by the
[[Category:
|