~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/arch/arm64/acpi_object_usage.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 ===========
  2 ACPI Tables
  3 ===========
  4 
  5 The expectations of individual ACPI tables are discussed in the list that
  6 follows.
  7 
  8 If a section number is used, it refers to a section number in the ACPI
  9 specification where the object is defined.  If "Signature Reserved" is used,
 10 the table signature (the first four bytes of the table) is the only portion
 11 of the table recognized by the specification, and the actual table is defined
 12 outside of the UEFI Forum (see Section 5.2.6 of the specification).
 13 
 14 For ACPI on arm64, tables also fall into the following categories:
 15 
 16        -  Required: DSDT, FADT, GTDT, MADT, MCFG, RSDP, SPCR, XSDT
 17 
 18        -  Recommended: BERT, EINJ, ERST, HEST, PCCT, SSDT
 19 
 20        -  Optional: AGDI, BGRT, CEDT, CPEP, CSRT, DBG2, DRTM, ECDT, FACS, FPDT,
 21           HMAT, IBFT, IORT, MCHI, MPAM, MPST, MSCT, NFIT, PMTT, PPTT, RASF, SBST,
 22           SDEI, SLIT, SPMI, SRAT, STAO, TCPA, TPM2, UEFI, XENV
 23 
 24        -  Not supported: AEST, APMT, BOOT, DBGP, DMAR, ETDT, HPET, IVRS, LPIT,
 25           MSDM, OEMx, PDTT, PSDT, RAS2, RSDT, SLIC, WAET, WDAT, WDRT, WPBT
 26 
 27 ====== ========================================================================
 28 Table  Usage for ARMv8 Linux
 29 ====== ========================================================================
 30 AEST   Signature Reserved (signature == "AEST")
 31 
 32        **Arm Error Source Table**
 33 
 34        This table informs the OS of any error nodes in the system that are
 35        compliant with the Arm RAS architecture.
 36 
 37 AGDI   Signature Reserved (signature == "AGDI")
 38 
 39        **Arm Generic diagnostic Dump and Reset Device Interface Table**
 40 
 41        This table describes a non-maskable event, that is used by the platform
 42        firmware, to request the OS to generate a diagnostic dump and reset the device.
 43 
 44 APMT   Signature Reserved (signature == "APMT")
 45 
 46        **Arm Performance Monitoring Table**
 47 
 48        This table describes the properties of PMU support implemented by
 49        components in the system.
 50 
 51 BERT   Section 18.3 (signature == "BERT")
 52 
 53        **Boot Error Record Table**
 54 
 55        Must be supplied if RAS support is provided by the platform.  It
 56        is recommended this table be supplied.
 57 
 58 BOOT   Signature Reserved (signature == "BOOT")
 59 
 60        **simple BOOT flag table**
 61 
 62        Microsoft only table, will not be supported.
 63 
 64 BGRT   Section 5.2.22 (signature == "BGRT")
 65 
 66        **Boot Graphics Resource Table**
 67 
 68        Optional, not currently supported, with no real use-case for an
 69        ARM server.
 70 
 71 CEDT   Signature Reserved (signature == "CEDT")
 72 
 73        **CXL Early Discovery Table**
 74 
 75        This table allows the OS to discover any CXL Host Bridges and the Host
 76        Bridge registers.
 77 
 78 CPEP   Section 5.2.18 (signature == "CPEP")
 79 
 80        **Corrected Platform Error Polling table**
 81 
 82        Optional, not currently supported, and not recommended until such
 83        time as ARM-compatible hardware is available, and the specification
 84        suitably modified.
 85 
 86 CSRT   Signature Reserved (signature == "CSRT")
 87 
 88        **Core System Resources Table**
 89 
 90        Optional, not currently supported.
 91 
 92 DBG2   Signature Reserved (signature == "DBG2")
 93 
 94        **DeBuG port table 2**
 95 
 96        License has changed and should be usable.  Optional if used instead
 97        of earlycon=<device> on the command line.
 98 
 99 DBGP   Signature Reserved (signature == "DBGP")
100 
101        **DeBuG Port table**
102 
103        Microsoft only table, will not be supported.
104 
105 DSDT   Section 5.2.11.1 (signature == "DSDT")
106 
107        **Differentiated System Description Table**
108 
109        A DSDT is required; see also SSDT.
110 
111        ACPI tables contain only one DSDT but can contain one or more SSDTs,
112        which are optional.  Each SSDT can only add to the ACPI namespace,
113        but cannot modify or replace anything in the DSDT.
114 
115 DMAR   Signature Reserved (signature == "DMAR")
116 
117        **DMA Remapping table**
118 
119        x86 only table, will not be supported.
120 
121 DRTM   Signature Reserved (signature == "DRTM")
122 
123        **Dynamic Root of Trust for Measurement table**
124 
125        Optional, not currently supported.
126 
127 ECDT   Section 5.2.16 (signature == "ECDT")
128 
129        **Embedded Controller Description Table**
130 
131        Optional, not currently supported, but could be used on ARM if and
132        only if one uses the GPE_BIT field to represent an IRQ number, since
133        there are no GPE blocks defined in hardware reduced mode.  This would
134        need to be modified in the ACPI specification.
135 
136 EINJ   Section 18.6 (signature == "EINJ")
137 
138        **Error Injection table**
139 
140        This table is very useful for testing platform response to error
141        conditions; it allows one to inject an error into the system as
142        if it had actually occurred.  However, this table should not be
143        shipped with a production system; it should be dynamically loaded
144        and executed with the ACPICA tools only during testing.
145 
146 ERST   Section 18.5 (signature == "ERST")
147 
148        **Error Record Serialization Table**
149 
150        On a platform supports RAS, this table must be supplied if it is not
151        UEFI-based; if it is UEFI-based, this table may be supplied. When this
152        table is not present, UEFI run time service will be utilized to save
153        and retrieve hardware error information to and from a persistent store.
154 
155 ETDT   Signature Reserved (signature == "ETDT")
156 
157        **Event Timer Description Table**
158 
159        Obsolete table, will not be supported.
160 
161 FACS   Section 5.2.10 (signature == "FACS")
162 
163        **Firmware ACPI Control Structure**
164 
165        It is unlikely that this table will be terribly useful.  If it is
166        provided, the Global Lock will NOT be used since it is not part of
167        the hardware reduced profile, and only 64-bit address fields will
168        be considered valid.
169 
170 FADT   Section 5.2.9 (signature == "FACP")
171 
172        **Fixed ACPI Description Table**
173        Required for arm64.
174 
175 
176        The HW_REDUCED_ACPI flag must be set.  All of the fields that are
177        to be ignored when HW_REDUCED_ACPI is set are expected to be set to
178        zero.
179 
180        If an FACS table is provided, the X_FIRMWARE_CTRL field is to be
181        used, not FIRMWARE_CTRL.
182 
183        If PSCI is used (as is recommended), make sure that ARM_BOOT_ARCH is
184        filled in properly - that the PSCI_COMPLIANT flag is set and that
185        PSCI_USE_HVC is set or unset as needed (see table 5-37).
186 
187        For the DSDT that is also required, the X_DSDT field is to be used,
188        not the DSDT field.
189 
190 FPDT   Section 5.2.23 (signature == "FPDT")
191 
192        **Firmware Performance Data Table**
193 
194        Optional, useful for boot performance profiling.
195 
196 GTDT   Section 5.2.24 (signature == "GTDT")
197 
198        **Generic Timer Description Table**
199 
200        Required for arm64.
201 
202 HEST   Section 18.3.2 (signature == "HEST")
203 
204        **Hardware Error Source Table**
205 
206        ARM-specific error sources have been defined; please use those or the
207        PCI types such as type 6 (AER Root Port), 7 (AER Endpoint), or 8 (AER
208        Bridge), or use type 9 (Generic Hardware Error Source).  Firmware first
209        error handling is possible if and only if Trusted Firmware is being
210        used on arm64.
211 
212        Must be supplied if RAS support is provided by the platform.  It
213        is recommended this table be supplied.
214 
215 HMAT   Section 5.2.28 (signature == "HMAT")
216 
217        **Heterogeneous Memory Attribute Table**
218 
219        This table describes the memory attributes, such as memory side cache
220        attributes and bandwidth and latency details, related to Memory Proximity
221        Domains. The OS uses this information to optimize the system memory
222        configuration.
223 
224 HPET   Signature Reserved (signature == "HPET")
225 
226        **High Precision Event timer Table**
227 
228        x86 only table, will not be supported.
229 
230 IBFT   Signature Reserved (signature == "IBFT")
231 
232        **iSCSI Boot Firmware Table**
233 
234        Microsoft defined table, support TBD.
235 
236 IORT   Signature Reserved (signature == "IORT")
237 
238        **Input Output Remapping Table**
239 
240        arm64 only table, required in order to describe IO topology, SMMUs,
241        and GIC ITSs, and how those various components are connected together,
242        such as identifying which components are behind which SMMUs/ITSs.
243        This table will only be required on certain SBSA platforms (e.g.,
244        when using GICv3-ITS and an SMMU); on SBSA Level 0 platforms, it
245        remains optional.
246 
247 IVRS   Signature Reserved (signature == "IVRS")
248 
249        **I/O Virtualization Reporting Structure**
250 
251        x86_64 (AMD) only table, will not be supported.
252 
253 LPIT   Signature Reserved (signature == "LPIT")
254 
255        **Low Power Idle Table**
256 
257        x86 only table as of ACPI 5.1; starting with ACPI 6.0, processor
258        descriptions and power states on ARM platforms should use the DSDT
259        and define processor container devices (_HID ACPI0010, Section 8.4,
260        and more specifically 8.4.3 and 8.4.4).
261 
262 MADT   Section 5.2.12 (signature == "APIC")
263 
264        **Multiple APIC Description Table**
265 
266        Required for arm64.  Only the GIC interrupt controller structures
267        should be used (types 0xA - 0xF).
268 
269 MCFG   Signature Reserved (signature == "MCFG")
270 
271        **Memory-mapped ConFiGuration space**
272 
273        If the platform supports PCI/PCIe, an MCFG table is required.
274 
275 MCHI   Signature Reserved (signature == "MCHI")
276 
277        **Management Controller Host Interface table**
278 
279        Optional, not currently supported.
280 
281 MPAM   Signature Reserved (signature == "MPAM")
282 
283        **Memory Partitioning And Monitoring table**
284 
285        This table allows the OS to discover the MPAM controls implemented by
286        the subsystems.
287 
288 MPST   Section 5.2.21 (signature == "MPST")
289 
290        **Memory Power State Table**
291 
292        Optional, not currently supported.
293 
294 MSCT   Section 5.2.19 (signature == "MSCT")
295 
296        **Maximum System Characteristic Table**
297 
298        Optional, not currently supported.
299 
300 MSDM   Signature Reserved (signature == "MSDM")
301 
302        **Microsoft Data Management table**
303 
304        Microsoft only table, will not be supported.
305 
306 NFIT   Section 5.2.25 (signature == "NFIT")
307 
308        **NVDIMM Firmware Interface Table**
309 
310        Optional, not currently supported.
311 
312 OEMx   Signature of "OEMx" only
313 
314        **OEM Specific Tables**
315 
316        All tables starting with a signature of "OEM" are reserved for OEM
317        use.  Since these are not meant to be of general use but are limited
318        to very specific end users, they are not recommended for use and are
319        not supported by the kernel for arm64.
320 
321 PCCT   Section 14.1 (signature == "PCCT)
322 
323        **Platform Communications Channel Table**
324 
325        Recommend for use on arm64; use of PCC is recommended when using CPPC
326        to control performance and power for platform processors.
327 
328 PDTT   Section 5.2.29 (signature == "PDTT")
329 
330        **Platform Debug Trigger Table**
331 
332        This table describes PCC channels used to gather debug logs of
333        non-architectural features.
334 
335 
336 PMTT   Section 5.2.21.12 (signature == "PMTT")
337 
338        **Platform Memory Topology Table**
339 
340        Optional, not currently supported.
341 
342 PPTT   Section 5.2.30 (signature == "PPTT")
343 
344        **Processor Properties Topology Table**
345 
346        This table provides the processor and cache topology.
347 
348 PSDT   Section 5.2.11.3 (signature == "PSDT")
349 
350        **Persistent System Description Table**
351 
352        Obsolete table, will not be supported.
353 
354 RAS2   Section 5.2.21 (signature == "RAS2")
355 
356        **RAS Features 2 table**
357 
358        This table provides interfaces for the RAS capabilities implemented in
359        the platform.
360 
361 RASF   Section 5.2.20 (signature == "RASF")
362 
363        **RAS Feature table**
364 
365        Optional, not currently supported.
366 
367 RSDP   Section 5.2.5 (signature == "RSD PTR")
368 
369        **Root System Description PoinTeR**
370 
371        Required for arm64.
372 
373 RSDT   Section 5.2.7 (signature == "RSDT")
374 
375        **Root System Description Table**
376 
377        Since this table can only provide 32-bit addresses, it is deprecated
378        on arm64, and will not be used.  If provided, it will be ignored.
379 
380 SBST   Section 5.2.14 (signature == "SBST")
381 
382        **Smart Battery Subsystem Table**
383 
384        Optional, not currently supported.
385 
386 SDEI   Signature Reserved (signature == "SDEI")
387 
388        **Software Delegated Exception Interface table**
389 
390        This table advertises the presence of the SDEI interface.
391 
392 SLIC   Signature Reserved (signature == "SLIC")
393 
394        **Software LIcensing table**
395 
396        Microsoft only table, will not be supported.
397 
398 SLIT   Section 5.2.17 (signature == "SLIT")
399 
400        **System Locality distance Information Table**
401 
402        Optional in general, but required for NUMA systems.
403 
404 SPCR   Signature Reserved (signature == "SPCR")
405 
406        **Serial Port Console Redirection table**
407 
408        Required for arm64.
409 
410 SPMI   Signature Reserved (signature == "SPMI")
411 
412        **Server Platform Management Interface table**
413 
414        Optional, not currently supported.
415 
416 SRAT   Section 5.2.16 (signature == "SRAT")
417 
418        **System Resource Affinity Table**
419 
420        Optional, but if used, only the GICC Affinity structures are read.
421        To support arm64 NUMA, this table is required.
422 
423 SSDT   Section 5.2.11.2 (signature == "SSDT")
424 
425        **Secondary System Description Table**
426 
427        These tables are a continuation of the DSDT; these are recommended
428        for use with devices that can be added to a running system, but can
429        also serve the purpose of dividing up device descriptions into more
430        manageable pieces.
431 
432        An SSDT can only ADD to the ACPI namespace.  It cannot modify or
433        replace existing device descriptions already in the namespace.
434 
435        These tables are optional, however.  ACPI tables should contain only
436        one DSDT but can contain many SSDTs.
437 
438 STAO   Signature Reserved (signature == "STAO")
439 
440        **_STA Override table**
441 
442        Optional, but only necessary in virtualized environments in order to
443        hide devices from guest OSs.
444 
445 TCPA   Signature Reserved (signature == "TCPA")
446 
447        **Trusted Computing Platform Alliance table**
448 
449        Optional, not currently supported, and may need changes to fully
450        interoperate with arm64.
451 
452 TPM2   Signature Reserved (signature == "TPM2")
453 
454        **Trusted Platform Module 2 table**
455 
456        Optional, not currently supported, and may need changes to fully
457        interoperate with arm64.
458 
459 UEFI   Signature Reserved (signature == "UEFI")
460 
461        **UEFI ACPI data table**
462 
463        Optional, not currently supported.  No known use case for arm64,
464        at present.
465 
466 WAET   Signature Reserved (signature == "WAET")
467 
468        **Windows ACPI Emulated devices Table**
469 
470        Microsoft only table, will not be supported.
471 
472 WDAT   Signature Reserved (signature == "WDAT")
473 
474        **Watch Dog Action Table**
475 
476        Microsoft only table, will not be supported.
477 
478 WDRT   Signature Reserved (signature == "WDRT")
479 
480        **Watch Dog Resource Table**
481 
482        Microsoft only table, will not be supported.
483 
484 WPBT   Signature Reserved (signature == "WPBT")
485 
486        **Windows Platform Binary Table**
487 
488        Microsoft only table, will not be supported.
489 
490 XENV   Signature Reserved (signature == "XENV")
491 
492        **Xen project table**
493 
494        Optional, used only by Xen at present.
495 
496 XSDT   Section 5.2.8 (signature == "XSDT")
497 
498        **eXtended System Description Table**
499 
500        Required for arm64.
501 ====== ========================================================================
502 
503 ACPI Objects
504 ------------
505 The expectations on individual ACPI objects that are likely to be used are
506 shown in the list that follows; any object not explicitly mentioned below
507 should be used as needed for a particular platform or particular subsystem,
508 such as power management or PCI.
509 
510 ===== ================ ========================================================
511 Name   Section         Usage for ARMv8 Linux
512 ===== ================ ========================================================
513 _CCA   6.2.17          This method must be defined for all bus masters
514                        on arm64 - there are no assumptions made about
515                        whether such devices are cache coherent or not.
516                        The _CCA value is inherited by all descendants of
517                        these devices so it does not need to be repeated.
518                        Without _CCA on arm64, the kernel does not know what
519                        to do about setting up DMA for the device.
520 
521                        NB: this method provides default cache coherency
522                        attributes; the presence of an SMMU can be used to
523                        modify that, however.  For example, a master could
524                        default to non-coherent, but be made coherent with
525                        the appropriate SMMU configuration (see Table 17 of
526                        the IORT specification, ARM Document DEN 0049B).
527 
528 _CID   6.1.2           Use as needed, see also _HID.
529 
530 _CLS   6.1.3           Use as needed, see also _HID.
531 
532 _CPC   8.4.7.1         Use as needed, power management specific.  CPPC is
533                        recommended on arm64.
534 
535 _CRS   6.2.2           Required on arm64.
536 
537 _CSD   8.4.2.2         Use as needed, used only in conjunction with _CST.
538 
539 _CST   8.4.2.1         Low power idle states (8.4.4) are recommended instead
540                        of C-states.
541 
542 _DDN   6.1.4           This field can be used for a device name.  However,
543                        it is meant for DOS device names (e.g., COM1), so be
544                        careful of its use across OSes.
545 
546 _DSD   6.2.5           To be used with caution.  If this object is used, try
547                        to use it within the constraints already defined by the
548                        Device Properties UUID.  Only in rare circumstances
549                        should it be necessary to create a new _DSD UUID.
550 
551                        In either case, submit the _DSD definition along with
552                        any driver patches for discussion, especially when
553                        device properties are used.  A driver will not be
554                        considered complete without a corresponding _DSD
555                        description.  Once approved by kernel maintainers,
556                        the UUID or device properties must then be registered
557                        with the UEFI Forum; this may cause some iteration as
558                        more than one OS will be registering entries.
559 
560 _DSM   9.1.1           Do not use this method.  It is not standardized, the
561                        return values are not well documented, and it is
562                        currently a frequent source of error.
563 
564 \_GL   5.7.1           This object is not to be used in hardware reduced
565                        mode, and therefore should not be used on arm64.
566 
567 _GLK   6.5.7           This object requires a global lock be defined; there
568                        is no global lock on arm64 since it runs in hardware
569                        reduced mode.  Hence, do not use this object on arm64.
570 
571 \_GPE  5.3.1           This namespace is for x86 use only.  Do not use it
572                        on arm64.
573 
574 _HID   6.1.5           This is the primary object to use in device probing,
575                        though _CID and _CLS may also be used.
576 
577 _INI   6.5.1           Not required, but can be useful in setting up devices
578                        when UEFI leaves them in a state that may not be what
579                        the driver expects before it starts probing.
580 
581 _LPI   8.4.4.3         Recommended for use with processor definitions (_HID
582                        ACPI0010) on arm64.  See also _RDI.
583 
584 _MLS   6.1.7           Highly recommended for use in internationalization.
585 
586 _OFF   7.2.2           It is recommended to define this method for any device
587                        that can be turned on or off.
588 
589 _ON    7.2.3           It is recommended to define this method for any device
590                        that can be turned on or off.
591 
592 \_OS   5.7.3           This method will return "Linux" by default (this is
593                        the value of the macro ACPI_OS_NAME on Linux).  The
594                        command line parameter acpi_os=<string> can be used
595                        to set it to some other value.
596 
597 _OSC   6.2.11          This method can be a global method in ACPI (i.e.,
598                        \_SB._OSC), or it may be associated with a specific
599                        device (e.g., \_SB.DEV0._OSC), or both.  When used
600                        as a global method, only capabilities published in
601                        the ACPI specification are allowed.  When used as
602                        a device-specific method, the process described for
603                        using _DSD MUST be used to create an _OSC definition;
604                        out-of-process use of _OSC is not allowed.  That is,
605                        submit the device-specific _OSC usage description as
606                        part of the kernel driver submission, get it approved
607                        by the kernel community, then register it with the
608                        UEFI Forum.
609 
610 \_OSI  5.7.2           Deprecated on ARM64.  As far as ACPI firmware is
611                        concerned, _OSI is not to be used to determine what
612                        sort of system is being used or what functionality
613                        is provided.  The _OSC method is to be used instead.
614 
615 _PDC   8.4.1           Deprecated, do not use on arm64.
616 
617 \_PIC  5.8.1           The method should not be used.  On arm64, the only
618                        interrupt model available is GIC.
619 
620 \_PR   5.3.1           This namespace is for x86 use only on legacy systems.
621                        Do not use it on arm64.
622 
623 _PRT   6.2.13          Required as part of the definition of all PCI root
624                        devices.
625 
626 _PRx   7.3.8-11        Use as needed; power management specific.  If _PR0 is
627                        defined, _PR3 must also be defined.
628 
629 _PSx   7.3.2-5         Use as needed; power management specific.  If _PS0 is
630                        defined, _PS3 must also be defined.  If clocks or
631                        regulators need adjusting to be consistent with power
632                        usage, change them in these methods.
633 
634 _RDI   8.4.4.4         Recommended for use with processor definitions (_HID
635                        ACPI0010) on arm64.  This should only be used in
636                        conjunction with _LPI.
637 
638 \_REV  5.7.4           Always returns the latest version of ACPI supported.
639 
640 \_SB   5.3.1           Required on arm64; all devices must be defined in this
641                        namespace.
642 
643 _SLI   6.2.15          Use is recommended when SLIT table is in use.
644 
645 _STA   6.3.7,          It is recommended to define this method for any device
646        7.2.4           that can be turned on or off.  See also the STAO table
647                        that provides overrides to hide devices in virtualized
648                        environments.
649 
650 _SRS   6.2.16          Use as needed; see also _PRS.
651 
652 _STR   6.1.10          Recommended for conveying device names to end users;
653                        this is preferred over using _DDN.
654 
655 _SUB   6.1.9           Use as needed; _HID or _CID are preferred.
656 
657 _SUN   6.1.11          Use as needed, but recommended.
658 
659 _SWS   7.4.3           Use as needed; power management specific; this may
660                        require specification changes for use on arm64.
661 
662 _UID   6.1.12          Recommended for distinguishing devices of the same
663                        class; define it if at all possible.
664 ===== ================ ========================================================
665 
666 
667 
668 
669 ACPI Event Model
670 ----------------
671 Do not use GPE block devices; these are not supported in the hardware reduced
672 profile used by arm64.  Since there are no GPE blocks defined for use on ARM
673 platforms, ACPI events must be signaled differently.
674 
675 There are two options: GPIO-signaled interrupts (Section 5.6.5), and
676 interrupt-signaled events (Section 5.6.9).  Interrupt-signaled events are a
677 new feature in the ACPI 6.1 specification.  Either - or both - can be used
678 on a given platform, and which to use may be dependent of limitations in any
679 given SoC.  If possible, interrupt-signaled events are recommended.
680 
681 
682 ACPI Processor Control
683 ----------------------
684 Section 8 of the ACPI specification changed significantly in version 6.0.
685 Processors should now be defined as Device objects with _HID ACPI0007; do
686 not use the deprecated Processor statement in ASL.  All multiprocessor systems
687 should also define a hierarchy of processors, done with Processor Container
688 Devices (see Section 8.4.3.1, _HID ACPI0010); do not use processor aggregator
689 devices (Section 8.5) to describe processor topology.  Section 8.4 of the
690 specification describes the semantics of these object definitions and how
691 they interrelate.
692 
693 Most importantly, the processor hierarchy defined also defines the low power
694 idle states that are available to the platform, along with the rules for
695 determining which processors can be turned on or off and the circumstances
696 that control that.  Without this information, the processors will run in
697 whatever power state they were left in by UEFI.
698 
699 Note too, that the processor Device objects defined and the entries in the
700 MADT for GICs are expected to be in synchronization.  The _UID of the Device
701 object must correspond to processor IDs used in the MADT.
702 
703 It is recommended that CPPC (8.4.5) be used as the primary model for processor
704 performance control on arm64.  C-states and P-states may become available at
705 some point in the future, but most current design work appears to favor CPPC.
706 
707 Further, it is essential that the ARMv8 SoC provide a fully functional
708 implementation of PSCI; this will be the only mechanism supported by ACPI
709 to control CPU power state.  Booting of secondary CPUs using the ACPI
710 parking protocol is possible, but discouraged, since only PSCI is supported
711 for ARM servers.
712 
713 
714 ACPI System Address Map Interfaces
715 ----------------------------------
716 In Section 15 of the ACPI specification, several methods are mentioned as
717 possible mechanisms for conveying memory resource information to the kernel.
718 For arm64, we will only support UEFI for booting with ACPI, hence the UEFI
719 GetMemoryMap() boot service is the only mechanism that will be used.
720 
721 
722 ACPI Platform Error Interfaces (APEI)
723 -------------------------------------
724 The APEI tables supported are described above.
725 
726 APEI requires the equivalent of an SCI and an NMI on ARMv8.  The SCI is used
727 to notify the OSPM of errors that have occurred but can be corrected and the
728 system can continue correct operation, even if possibly degraded.  The NMI is
729 used to indicate fatal errors that cannot be corrected, and require immediate
730 attention.
731 
732 Since there is no direct equivalent of the x86 SCI or NMI, arm64 handles
733 these slightly differently.  The SCI is handled as a high priority interrupt;
734 given that these are corrected (or correctable) errors being reported, this
735 is sufficient.  The NMI is emulated as the highest priority interrupt
736 possible.  This implies some caution must be used since there could be
737 interrupts at higher privilege levels or even interrupts at the same priority
738 as the emulated NMI.  In Linux, this should not be the case but one should
739 be aware it could happen.
740 
741 
742 ACPI Objects Not Supported on ARM64
743 -----------------------------------
744 While this may change in the future, there are several classes of objects
745 that can be defined, but are not currently of general interest to ARM servers.
746 Some of these objects have x86 equivalents, and may actually make sense in ARM
747 servers.  However, there is either no hardware available at present, or there
748 may not even be a non-ARM implementation yet.  Hence, they are not currently
749 supported.
750 
751 The following classes of objects are not supported:
752 
753        -  Section 9.2: ambient light sensor devices
754 
755        -  Section 9.3: battery devices
756 
757        -  Section 9.4: lids (e.g., laptop lids)
758 
759        -  Section 9.8.2: IDE controllers
760 
761        -  Section 9.9: floppy controllers
762 
763        -  Section 9.10: GPE block devices
764 
765        -  Section 9.15: PC/AT RTC/CMOS devices
766 
767        -  Section 9.16: user presence detection devices
768 
769        -  Section 9.17: I/O APIC devices; all GICs must be enumerable via MADT
770 
771        -  Section 9.18: time and alarm devices (see 9.15)
772 
773        -  Section 10: power source and power meter devices
774 
775        -  Section 11: thermal management
776 
777        -  Section 12: embedded controllers interface
778 
779        -  Section 13: SMBus interfaces
780 
781 
782 This also means that there is no support for the following objects:
783 
784 ====   =========================== ====   ==========
785 Name   Section                     Name   Section
786 ====   =========================== ====   ==========
787 _ALC   9.3.4                       _FDM   9.10.3
788 _ALI   9.3.2                       _FIX   6.2.7
789 _ALP   9.3.6                       _GAI   10.4.5
790 _ALR   9.3.5                       _GHL   10.4.7
791 _ALT   9.3.3                       _GTM   9.9.2.1.1
792 _BCT   10.2.2.10                   _LID   9.5.1
793 _BDN   6.5.3                       _PAI   10.4.4
794 _BIF   10.2.2.1                    _PCL   10.3.2
795 _BIX   10.2.2.1                    _PIF   10.3.3
796 _BLT   9.2.3                       _PMC   10.4.1
797 _BMA   10.2.2.4                    _PMD   10.4.8
798 _BMC   10.2.2.12                   _PMM   10.4.3
799 _BMD   10.2.2.11                   _PRL   10.3.4
800 _BMS   10.2.2.5                    _PSR   10.3.1
801 _BST   10.2.2.6                    _PTP   10.4.2
802 _BTH   10.2.2.7                    _SBS   10.1.3
803 _BTM   10.2.2.9                    _SHL   10.4.6
804 _BTP   10.2.2.8                    _STM   9.9.2.1.1
805 _DCK   6.5.2                       _UPD   9.16.1
806 _EC    12.12                       _UPP   9.16.2
807 _FDE   9.10.1                      _WPC   10.5.2
808 _FDI   9.10.2                      _WPP   10.5.3
809 ====   =========================== ====   ==========

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php