Documentation/arch/arm64/acpi_object_usage.rst

Source file repositories/reference/linux-study-clean/Documentation/arch/arm64/acpi_object_usage.rst

File Facts

System
Linux kernel
Corpus path
Documentation/arch/arm64/acpi_object_usage.rst
Extension
.rst
Size
29676 bytes
Lines
810
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

===========
ACPI Tables
===========

The expectations of individual ACPI tables are discussed in the list that
follows.

If a section number is used, it refers to a section number in the ACPI
specification where the object is defined.  If "Signature Reserved" is used,
the table signature (the first four bytes of the table) is the only portion
of the table recognized by the specification, and the actual table is defined
outside of the UEFI Forum (see Section 5.2.6 of the specification).

For ACPI on arm64, tables also fall into the following categories:

       -  Required: DSDT, FADT, GTDT, MADT, MCFG, RSDP, SPCR, XSDT

       -  Recommended: BERT, EINJ, ERST, HEST, PCCT, SSDT

       -  Optional: AGDI, BGRT, CEDT, CPEP, CSRT, DBG2, DRTM, ECDT, FACS, FPDT,
          HMAT, IBFT, IORT, MCHI, MPAM, MPST, MSCT, NFIT, PMTT, PPTT, RASF, SBST,
          SDEI, SLIT, SPMI, SRAT, STAO, TCPA, TPM2, UEFI, XENV

       -  Not supported: AEST, APMT, BOOT, DBGP, DMAR, ETDT, HPET, IVRS, LPIT,
          MSDM, OEMx, PDTT, PSDT, RAS2, RSDT, SLIC, WAET, WDAT, WDRT, WPBT

====== ========================================================================
Table  Usage for ARMv8 Linux
====== ========================================================================
AEST   Signature Reserved (signature == "AEST")

       **Arm Error Source Table**

       This table informs the OS of any error nodes in the system that are
       compliant with the Arm RAS architecture.

AGDI   Signature Reserved (signature == "AGDI")

       **Arm Generic diagnostic Dump and Reset Device Interface Table**

       This table describes a non-maskable event, that is used by the platform
       firmware, to request the OS to generate a diagnostic dump and reset the device.

APMT   Signature Reserved (signature == "APMT")

       **Arm Performance Monitoring Table**

       This table describes the properties of PMU support implemented by
       components in the system.

BERT   Section 18.3 (signature == "BERT")

       **Boot Error Record Table**

       Must be supplied if RAS support is provided by the platform.  It
       is recommended this table be supplied.

BOOT   Signature Reserved (signature == "BOOT")

       **simple BOOT flag table**

       Microsoft only table, will not be supported.

BGRT   Section 5.2.22 (signature == "BGRT")

       **Boot Graphics Resource Table**

       Optional, not currently supported, with no real use-case for an
       ARM server.

Annotation

Implementation Notes