요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
===========
2
ACPI Tables
3
===========
5
The expectations of individual ACPI tables are discussed in the list that
6
follows.
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).
14
For ACPI on arm64, tables also fall into the following categories:
16
- Required: DSDT, FADT, GTDT, MADT, MCFG, RSDP, SPCR, XSDT
18
- Recommended: BERT, EINJ, ERST, HEST, PCCT, SSDT
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
24
- Not supported: AEST, APMT, BOOT, DBGP, DMAR, ETDT, HPET, IVRS, LPIT,
25
MSDM, OEMx, PDTT, PSDT, RAS2, RSDT, SLIC, WAET, WDAT, WDRT, WPBT
27
====== ========================================================================
28
Table Usage for ARMv8 Linux
29
====== ========================================================================
30
AEST Signature Reserved (signature == "AEST")
32
**Arm Error Source Table**
34
This table informs the OS of any error nodes in the system that are
35
compliant with the Arm RAS architecture.
37
AGDI Signature Reserved (signature == "AGDI")
39
**Arm Generic diagnostic Dump and Reset Device Interface Table**
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.
44
APMT Signature Reserved (signature == "APMT")
46
**Arm Performance Monitoring Table**
48
This table describes the properties of PMU support implemented by
49
components in the system.
51
BERT Section 18.3 (signature == "BERT")
53
**Boot Error Record Table**
55
Must be supplied if RAS support is provided by the platform. It
56
is recommended this table be supplied.
58
BOOT Signature Reserved (signature == "BOOT")
60
**simple BOOT flag table**
62
Microsoft only table, will not be supported.
64
BGRT Section 5.2.22 (signature == "BGRT")
66
**Boot Graphics Resource Table**
68
Optional, not currently supported, with no real use-case for an
69
ARM server.
71
CEDT Signature Reserved (signature == "CEDT")
73
**CXL Early Discovery Table**
75
This table allows the OS to discover any CXL Host Bridges and the Host
76
Bridge registers.
78
CPEP Section 5.2.18 (signature == "CPEP")
80
**Corrected Platform Error Polling table**
82
Optional, not currently supported, and not recommended until such
83
time as ARM-compatible hardware is available, and the specification
84
suitably modified.
86
CSRT Signature Reserved (signature == "CSRT")
88
**Core System Resources Table**
90
Optional, not currently supported.
92
DBG2 Signature Reserved (signature == "DBG2")
94
**DeBuG port table 2**
96
License has changed and should be usable. Optional if used instead
97
of earlycon=<device> on the command line.
99
DBGP Signature Reserved (signature == "DBGP")
101
**DeBuG Port table**
103
Microsoft only table, will not be supported.
105
DSDT Section 5.2.11.1 (signature == "DSDT")
107
**Differentiated System Description Table**
109
A DSDT is required; see also SSDT.
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.
115
DMAR Signature Reserved (signature == "DMAR")
117
**DMA Remapping table**
119
x86 only table, will not be supported.
121
DRTM Signature Reserved (signature == "DRTM")
123
**Dynamic Root of Trust for Measurement table**
125
Optional, not currently supported.
127
ECDT Section 5.2.16 (signature == "ECDT")
129
**Embedded Controller Description Table**
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.
136
EINJ Section 18.6 (signature == "EINJ")
138
**Error Injection table**
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.
146
ERST Section 18.5 (signature == "ERST")
148
**Error Record Serialization Table**
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.
155
ETDT Signature Reserved (signature == "ETDT")
157
**Event Timer Description Table**
159
Obsolete table, will not be supported.
161
FACS Section 5.2.10 (signature == "FACS")
163
**Firmware ACPI Control Structure**
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.
170
FADT Section 5.2.9 (signature == "FACP")
172
**Fixed ACPI Description Table**
173
Required for arm64.
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.
180
If an FACS table is provided, the X_FIRMWARE_CTRL field is to be
181
used, not FIRMWARE_CTRL.
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).
187
For the DSDT that is also required, the X_DSDT field is to be used,
188
not the DSDT field.
190
FPDT Section 5.2.23 (signature == "FPDT")
192
**Firmware Performance Data Table**
194
Optional, useful for boot performance profiling.
196
GTDT Section 5.2.24 (signature == "GTDT")
198
**Generic Timer Description Table**
200
Required for arm64.
202
HEST Section 18.3.2 (signature == "HEST")
204
**Hardware Error Source Table**
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.
212
Must be supplied if RAS support is provided by the platform. It
213
is recommended this table be supplied.
215
HMAT Section 5.2.28 (signature == "HMAT")
217
**Heterogeneous Memory Attribute Table**
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.
224
HPET Signature Reserved (signature == "HPET")
226
**High Precision Event timer Table**
228
x86 only table, will not be supported.
230
IBFT Signature Reserved (signature == "IBFT")
232
**iSCSI Boot Firmware Table**
234
Microsoft defined table, support TBD.
236
IORT Signature Reserved (signature == "IORT")
238
**Input Output Remapping Table**
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.
247
IVRS Signature Reserved (signature == "IVRS")
249
**I/O Virtualization Reporting Structure**
251
x86_64 (AMD) only table, will not be supported.
253
LPIT Signature Reserved (signature == "LPIT")
255
**Low Power Idle Table**
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).
262
MADT Section 5.2.12 (signature == "APIC")
264
**Multiple APIC Description Table**
266
Required for arm64. Only the GIC interrupt controller structures
267
should be used (types 0xA - 0xF).
269
MCFG Signature Reserved (signature == "MCFG")
271
**Memory-mapped ConFiGuration space**
273
If the platform supports PCI/PCIe, an MCFG table is required.
275
MCHI Signature Reserved (signature == "MCHI")
277
**Management Controller Host Interface table**
279
Optional, not currently supported.
281
MPAM Signature Reserved (signature == "MPAM")
283
**Memory Partitioning And Monitoring table**
285
This table allows the OS to discover the MPAM controls implemented by
286
the subsystems.
288
MPST Section 5.2.21 (signature == "MPST")
290
**Memory Power State Table**
292
Optional, not currently supported.
294
MSCT Section 5.2.19 (signature == "MSCT")
296
**Maximum System Characteristic Table**
298
Optional, not currently supported.
300
MSDM Signature Reserved (signature == "MSDM")
302
**Microsoft Data Management table**
304
Microsoft only table, will not be supported.
306
NFIT Section 5.2.25 (signature == "NFIT")
308
**NVDIMM Firmware Interface Table**
310
Optional, not currently supported.
312
OEMx Signature of "OEMx" only
314
**OEM Specific Tables**
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.
321
PCCT Section 14.1 (signature == "PCCT)
323
**Platform Communications Channel Table**
325
Recommend for use on arm64; use of PCC is recommended when using CPPC
326
to control performance and power for platform processors.
328
PDTT Section 5.2.29 (signature == "PDTT")
330
**Platform Debug Trigger Table**
332
This table describes PCC channels used to gather debug logs of
333
non-architectural features.
336
PMTT Section 5.2.21.12 (signature == "PMTT")
338
**Platform Memory Topology Table**
340
Optional, not currently supported.
342
PPTT Section 5.2.30 (signature == "PPTT")
344
**Processor Properties Topology Table**
346
This table provides the processor and cache topology.
348
PSDT Section 5.2.11.3 (signature == "PSDT")
350
**Persistent System Description Table**
352
Obsolete table, will not be supported.
354
RAS2 Section 5.2.21 (signature == "RAS2")
356
**RAS Features 2 table**
358
This table provides interfaces for the RAS capabilities implemented in
359
the platform.
361
RASF Section 5.2.20 (signature == "RASF")
363
**RAS Feature table**
365
Optional, not currently supported.
367
RSDP Section 5.2.5 (signature == "RSD PTR")
369
**Root System Description PoinTeR**
371
Required for arm64.
373
RSDT Section 5.2.7 (signature == "RSDT")
375
**Root System Description Table**
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.
380
SBST Section 5.2.14 (signature == "SBST")
382
**Smart Battery Subsystem Table**
384
Optional, not currently supported.
386
SDEI Signature Reserved (signature == "SDEI")
388
**Software Delegated Exception Interface table**
390
This table advertises the presence of the SDEI interface.
392
SLIC Signature Reserved (signature == "SLIC")
394
**Software LIcensing table**
396
Microsoft only table, will not be supported.
398
SLIT Section 5.2.17 (signature == "SLIT")
400
**System Locality distance Information Table**
402
Optional in general, but required for NUMA systems.
404
SPCR Signature Reserved (signature == "SPCR")
406
**Serial Port Console Redirection table**
408
Required for arm64.
410
SPMI Signature Reserved (signature == "SPMI")
412
**Server Platform Management Interface table**
414
Optional, not currently supported.
416
SRAT Section 5.2.16 (signature == "SRAT")
418
**System Resource Affinity Table**
420
Optional, but if used, only the GICC Affinity structures are read.
421
To support arm64 NUMA, this table is required.
423
SSDT Section 5.2.11.2 (signature == "SSDT")
425
**Secondary System Description Table**
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.
432
An SSDT can only ADD to the ACPI namespace. It cannot modify or
433
replace existing device descriptions already in the namespace.
435
These tables are optional, however. ACPI tables should contain only
436
one DSDT but can contain many SSDTs.
438
STAO Signature Reserved (signature == "STAO")
440
**_STA Override table**
442
Optional, but only necessary in virtualized environments in order to
443
hide devices from guest OSs.
445
TCPA Signature Reserved (signature == "TCPA")
447
**Trusted Computing Platform Alliance table**
449
Optional, not currently supported, and may need changes to fully
450
interoperate with arm64.
452
TPM2 Signature Reserved (signature == "TPM2")
454
**Trusted Platform Module 2 table**
456
Optional, not currently supported, and may need changes to fully
457
interoperate with arm64.
459
UEFI Signature Reserved (signature == "UEFI")
461
**UEFI ACPI data table**
463
Optional, not currently supported. No known use case for arm64,
464
at present.
466
WAET Signature Reserved (signature == "WAET")
468
**Windows ACPI Emulated devices Table**
470
Microsoft only table, will not be supported.
472
WDAT Signature Reserved (signature == "WDAT")
474
**Watch Dog Action Table**
476
Microsoft only table, will not be supported.
478
WDRT Signature Reserved (signature == "WDRT")
480
**Watch Dog Resource Table**
482
Microsoft only table, will not be supported.
484
WPBT Signature Reserved (signature == "WPBT")
486
**Windows Platform Binary Table**
488
Microsoft only table, will not be supported.
490
XENV Signature Reserved (signature == "XENV")
492
**Xen project table**
494
Optional, used only by Xen at present.
496
XSDT Section 5.2.8 (signature == "XSDT")
498
**eXtended System Description Table**
500
Required for arm64.
501
====== ========================================================================
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.
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.
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).
528
_CID 6.1.2 Use as needed, see also _HID.
530
_CLS 6.1.3 Use as needed, see also _HID.
532
_CPC 8.4.7.1 Use as needed, power management specific. CPPC is
533
recommended on arm64.
535
_CRS 6.2.2 Required on arm64.
537
_CSD 8.4.2.2 Use as needed, used only in conjunction with _CST.
539
_CST 8.4.2.1 Low power idle states (8.4.4) are recommended instead
540
of C-states.
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.
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.
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.
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.
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.
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.
571
\_GPE 5.3.1 This namespace is for x86 use only. Do not use it
572
on arm64.
574
_HID 6.1.5 This is the primary object to use in device probing,
575
though _CID and _CLS may also be used.
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.
581
_LPI 8.4.4.3 Recommended for use with processor definitions (_HID
582
ACPI0010) on arm64. See also _RDI.
584
_MLS 6.1.7 Highly recommended for use in internationalization.
586
_OFF 7.2.2 It is recommended to define this method for any device
587
that can be turned on or off.
589
_ON 7.2.3 It is recommended to define this method for any device
590
that can be turned on or off.
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.
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.
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.
615
_PDC 8.4.1 Deprecated, do not use on arm64.
617
\_PIC 5.8.1 The method should not be used. On arm64, the only
618
interrupt model available is GIC.
620
\_PR 5.3.1 This namespace is for x86 use only on legacy systems.
621
Do not use it on arm64.
623
_PRT 6.2.13 Required as part of the definition of all PCI root
624
devices.
626
_PRx 7.3.8-11 Use as needed; power management specific. If _PR0 is
627
defined, _PR3 must also be defined.
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.
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.
638
\_REV 5.7.4 Always returns the latest version of ACPI supported.
640
\_SB 5.3.1 Required on arm64; all devices must be defined in this
641
namespace.
643
_SLI 6.2.15 Use is recommended when SLIT table is in use.
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.
650
_SRS 6.2.16 Use as needed; see also _PRS.
652
_STR 6.1.10 Recommended for conveying device names to end users;
653
this is preferred over using _DDN.
655
_SUB 6.1.9 Use as needed; _HID or _CID are preferred.
657
_SUN 6.1.11 Use as needed, but recommended.
659
_SWS 7.4.3 Use as needed; power management specific; this may
660
require specification changes for use on arm64.
662
_UID 6.1.12 Recommended for distinguishing devices of the same
663
class; define it if at all possible.
664
===== ================ ========================================================
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.
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.
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.
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.
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.
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.
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.
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.
722
ACPI Platform Error Interfaces (APEI)
723
-------------------------------------
724
The APEI tables supported are described above.
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.
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.
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.
751
The following classes of objects are not supported:
753
- Section 9.2: ambient light sensor devices
755
- Section 9.3: battery devices
757
- Section 9.4: lids (e.g., laptop lids)
759
- Section 9.8.2: IDE controllers
761
- Section 9.9: floppy controllers
763
- Section 9.10: GPE block devices
765
- Section 9.15: PC/AT RTC/CMOS devices
767
- Section 9.16: user presence detection devices
769
- Section 9.17: I/O APIC devices; all GICs must be enumerable via MADT
771
- Section 9.18: time and alarm devices (see 9.15)
773
- Section 10: power source and power meter devices
775
- Section 11: thermal management
777
- Section 12: embedded controllers interface
779
- Section 13: SMBus interfaces
782
This also means that there is no support for the following objects:
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
==== =========================== ==== ==========
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ACPI 테이블 분류와 해석 기준
1-26이 문서가 기대하는 개별 ACPI 테이블의 사용 방식은 뒤의 목록에서 설명합니다.
절 번호가 적혀 있으면 그 객체를 정의한 ACPI 사양의 절을 뜻합니다. `Signature Reserved`라고 적힌 경우에는 사양이 테이블 signature, 즉 처음 4바이트만 인식하며 실제 테이블 정의는 UEFI Forum 밖에 있습니다. 자세한 기준은 사양 5.2.6절을 참조합니다.
arm64의 ACPI 테이블은 다음 네 가지 지원 등급으로 나뉩니다.
| 등급 | 테이블 |
|---|---|
| 필수(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` |
ACPI 테이블: AEST부터 EINJ까지
27-145다음 표는 원문의 첫 번째 테이블 구간을 signature 순서대로 번역한 것입니다.
| 테이블 | 사양 위치와 signature | 정식 이름 | 지원 등급 | ARMv8 Linux에서의 사용 |
|---|---|---|---|---|
| `AEST` | Signature Reserved (`signature == "AEST"`) | Arm Error Source Table | 미지원 | 시스템에 존재하는 Arm RAS 아키텍처 준수 error node를 OS에 알립니다. |
| `AGDI` | Signature Reserved (`signature == "AGDI"`) | Arm Generic diagnostic Dump and Reset Device Interface Table | 선택 | 플랫폼 펌웨어가 OS에 진단 dump 생성과 장치 reset을 요청할 때 사용하는 non-maskable event를 설명합니다. |
| `APMT` | Signature Reserved (`signature == "APMT"`) | Arm Performance Monitoring Table | 미지원 | 시스템 구성 요소가 구현한 PMU 지원의 속성을 설명합니다. |
| `BERT` | 18.3절 (`signature == "BERT"`) | Boot Error Record Table | 권장 | 플랫폼이 RAS를 지원하면 반드시 제공해야 하며, 이 테이블을 제공하는 것이 권장됩니다. |
| `BOOT` | Signature Reserved (`signature == "BOOT"`) | simple BOOT flag table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `BGRT` | 5.2.22절 (`signature == "BGRT"`) | Boot Graphics Resource Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. ARM server에는 실질적인 사용 사례가 없습니다. |
| `CEDT` | Signature Reserved (`signature == "CEDT"`) | CXL Early Discovery Table | 선택 | OS가 CXL Host Bridge와 그 Host Bridge register를 발견할 수 있게 합니다. |
| `CPEP` | 5.2.18절 (`signature == "CPEP"`) | Corrected Platform Error Polling table | 선택 | 현재 지원하지 않습니다. ARM 호환 hardware가 제공되고 사양이 알맞게 수정되기 전까지는 사용을 권장하지 않습니다. |
| `CSRT` | Signature Reserved (`signature == "CSRT"`) | Core System Resources Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `DBG2` | Signature Reserved (`signature == "DBG2"`) | DeBuG port table 2 | 선택 | License가 변경되어 사용할 수 있게 되었습니다. Command line의 `earlycon=<device>` 대신 사용할 때 선택 사항입니다. |
| `DBGP` | Signature Reserved (`signature == "DBGP"`) | DeBuG Port table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `DSDT` | 5.2.11.1절 (`signature == "DSDT"`) | Differentiated System Description Table | 필수 | DSDT는 필수입니다. ACPI 테이블에는 DSDT가 하나만 들어가지만 선택 사항인 SSDT는 하나 이상 들어갈 수 있습니다. 각 SSDT는 ACPI namespace에 항목을 추가할 수만 있고 DSDT의 어떤 항목도 수정하거나 대체할 수 없습니다. SSDT 설명도 함께 참조하십시오. |
| `DMAR` | Signature Reserved (`signature == "DMAR"`) | DMA Remapping table | 미지원 | x86 전용 테이블이므로 지원하지 않습니다. |
| `DRTM` | Signature Reserved (`signature == "DRTM"`) | Dynamic Root of Trust for Measurement table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `ECDT` | 5.2.16절 (`signature == "ECDT"`) | Embedded Controller Description Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. 다만 hardware reduced mode에는 GPE block 정의가 없으므로 `GPE_BIT` field를 IRQ 번호로 표현하는 경우에만 ARM에서 사용할 수 있습니다. 이를 위해서는 ACPI 사양의 수정이 필요합니다. |
| `EINJ` | 18.6절 (`signature == "EINJ"`) | Error Injection table | 권장 | 플랫폼의 오류 상태 대응을 시험하는 데 매우 유용하며 실제 오류가 발생한 것처럼 시스템에 오류를 주입할 수 있습니다. 그러나 production system에 포함해서는 안 됩니다. 시험할 때만 ACPICA tool로 동적으로 load하고 실행해야 합니다. |
ACPI 테이블: ERST부터 MCFG까지
146-274| 테이블 | 사양 위치와 signature | 정식 이름 | 지원 등급 | ARMv8 Linux에서의 사용 |
|---|---|---|---|---|
| `ERST` | 18.5절 (`signature == "ERST"`) | Error Record Serialization Table | 권장 | RAS를 지원하는 플랫폼이 UEFI 기반이 아니면 반드시 제공해야 하고, UEFI 기반이면 제공할 수 있습니다. 테이블이 없으면 UEFI runtime service를 사용해 hardware error 정보를 persistent store에 저장하고 그곳에서 가져옵니다. |
| `ETDT` | Signature Reserved (`signature == "ETDT"`) | Event Timer Description Table | 미지원 | 폐기된 테이블이므로 지원하지 않습니다. |
| `FACS` | 5.2.10절 (`signature == "FACS"`) | Firmware ACPI Control Structure | 선택 | 유용할 가능성이 낮습니다. 제공하더라도 Global Lock은 hardware reduced profile의 일부가 아니므로 사용하지 않으며, 64-bit address field만 유효한 것으로 간주합니다. |
| `FADT` | 5.2.9절 (`signature == "FACP"`) | Fixed ACPI Description Table | 필수 | arm64에 필수입니다. `HW_REDUCED_ACPI` flag를 설정하고 이 flag가 켜졌을 때 무시되는 모든 field를 0으로 설정해야 합니다. FACS를 제공하면 `FIRMWARE_CTRL`이 아니라 `X_FIRMWARE_CTRL`을 사용합니다. 권장되는 PSCI를 사용한다면 `ARM_BOOT_ARCH`를 올바르게 채워 `PSCI_COMPLIANT`를 설정하고 필요에 따라 `PSCI_USE_HVC`를 설정하거나 해제해야 합니다(표 5-37). 필수 DSDT에는 `DSDT` field가 아니라 `X_DSDT` field를 사용합니다. |
| `FPDT` | 5.2.23절 (`signature == "FPDT"`) | Firmware Performance Data Table | 선택 | 선택 사항이며 boot performance profiling에 유용합니다. |
| `GTDT` | 5.2.24절 (`signature == "GTDT"`) | Generic Timer Description Table | 필수 | arm64에 필수입니다. |
| `HEST` | 18.3.2절 (`signature == "HEST"`) | Hardware Error Source Table | 권장 | ARM 전용 error source 또는 PCI type 6(AER Root Port), 7(AER Endpoint), 8(AER Bridge), 혹은 type 9(Generic Hardware Error Source)를 사용하십시오. arm64에서 firmware-first error handling은 Trusted Firmware를 사용할 때만 가능합니다. 플랫폼이 RAS를 지원하면 반드시 제공해야 하며 제공을 권장합니다. |
| `HMAT` | 5.2.28절 (`signature == "HMAT"`) | Heterogeneous Memory Attribute Table | 선택 | Memory Proximity Domain과 관련된 memory-side cache 속성, bandwidth, latency 같은 memory attribute를 설명합니다. OS는 이 정보로 system memory 구성을 최적화합니다. |
| `HPET` | Signature Reserved (`signature == "HPET"`) | High Precision Event timer Table | 미지원 | x86 전용 테이블이므로 지원하지 않습니다. |
| `IBFT` | Signature Reserved (`signature == "IBFT"`) | iSCSI Boot Firmware Table | 선택 | Microsoft가 정의한 테이블이며 지원 여부는 미정(TBD)입니다. |
| `IORT` | Signature Reserved (`signature == "IORT"`) | Input Output Remapping Table | 선택 | arm64 전용 테이블입니다. IO topology, SMMU, GIC ITS와 이 구성 요소들의 연결 관계, 예를 들어 어떤 구성 요소가 어느 SMMU/ITS 뒤에 있는지를 설명합니다. GICv3-ITS와 SMMU를 사용하는 경우처럼 일부 SBSA 플랫폼에서만 필수이고, SBSA Level 0 플랫폼에서는 선택 사항입니다. |
| `IVRS` | Signature Reserved (`signature == "IVRS"`) | I/O Virtualization Reporting Structure | 미지원 | x86_64(AMD) 전용 테이블이므로 지원하지 않습니다. |
| `LPIT` | Signature Reserved (`signature == "LPIT"`) | Low Power Idle Table | 미지원 | ACPI 5.1까지는 x86 전용 테이블입니다. ACPI 6.0부터 ARM 플랫폼의 processor 설명과 power state는 DSDT를 사용하고 processor container device(`_HID ACPI0010`, 8.4절, 특히 8.4.3절과 8.4.4절)를 정의해야 합니다. |
| `MADT` | 5.2.12절 (`signature == "APIC"`) | Multiple APIC Description Table | 필수 | arm64에 필수이며 GIC interrupt controller structure(type `0xA`부터 `0xF`)만 사용해야 합니다. |
| `MCFG` | Signature Reserved (`signature == "MCFG"`) | Memory-mapped ConFiGuration space | 필수 | 플랫폼이 PCI/PCIe를 지원하면 MCFG 테이블이 필수입니다. |
ACPI 테이블: MCHI부터 SDEI까지
275-390| 테이블 | 사양 위치와 signature | 정식 이름 | 지원 등급 | ARMv8 Linux에서의 사용 |
|---|---|---|---|---|
| `MCHI` | Signature Reserved (`signature == "MCHI"`) | Management Controller Host Interface table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `MPAM` | Signature Reserved (`signature == "MPAM"`) | Memory Partitioning And Monitoring table | 선택 | OS가 subsystem에 구현된 MPAM control을 발견할 수 있게 합니다. |
| `MPST` | 5.2.21절 (`signature == "MPST"`) | Memory Power State Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `MSCT` | 5.2.19절 (`signature == "MSCT"`) | Maximum System Characteristic Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `MSDM` | Signature Reserved (`signature == "MSDM"`) | Microsoft Data Management table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `NFIT` | 5.2.25절 (`signature == "NFIT"`) | NVDIMM Firmware Interface Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `OEMx` | Signature가 `"OEMx"`인 경우 | OEM Specific Tables | 미지원 | Signature가 `"OEM"`으로 시작하는 모든 테이블은 OEM 용도로 예약됩니다. 일반 용도가 아니라 매우 특정한 최종 사용자에게 한정되므로 사용을 권장하지 않으며 arm64 kernel은 지원하지 않습니다. |
| `PCCT` | 14.1절 (`signature == "PCCT"`) | Platform Communications Channel Table | 권장 | arm64에서 사용을 권장합니다. 플랫폼 processor의 성능과 전력을 CPPC로 제어할 때 PCC 사용을 권장합니다. |
| `PDTT` | 5.2.29절 (`signature == "PDTT"`) | Platform Debug Trigger Table | 미지원 | 비아키텍처 기능의 debug log를 수집하는 데 쓰이는 PCC channel을 설명합니다. |
| `PMTT` | 5.2.21.12절 (`signature == "PMTT"`) | Platform Memory Topology Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `PPTT` | 5.2.30절 (`signature == "PPTT"`) | Processor Properties Topology Table | 선택 | Processor와 cache topology를 제공합니다. |
| `PSDT` | 5.2.11.3절 (`signature == "PSDT"`) | Persistent System Description Table | 미지원 | 폐기된 테이블이므로 지원하지 않습니다. |
| `RAS2` | 5.2.21절 (`signature == "RAS2"`) | RAS Features 2 table | 미지원 | 플랫폼에 구현된 RAS capability를 위한 interface를 제공합니다. |
| `RASF` | 5.2.20절 (`signature == "RASF"`) | RAS Feature table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `RSDP` | 5.2.5절 (`signature == "RSD PTR"`) | Root System Description PoinTeR | 필수 | arm64에 필수입니다. |
| `RSDT` | 5.2.7절 (`signature == "RSDT"`) | Root System Description Table | 미지원 | 32-bit address만 제공할 수 있으므로 arm64에서는 폐기되었고 사용하지 않습니다. 제공되어도 무시합니다. |
| `SBST` | 5.2.14절 (`signature == "SBST"`) | Smart Battery Subsystem Table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `SDEI` | Signature Reserved (`signature == "SDEI"`) | Software Delegated Exception Interface table | 선택 | SDEI interface가 있음을 알립니다. |
ACPI 테이블: SLIC부터 XSDT까지
391-501| 테이블 | 사양 위치와 signature | 정식 이름 | 지원 등급 | ARMv8 Linux에서의 사용 |
|---|---|---|---|---|
| `SLIC` | Signature Reserved (`signature == "SLIC"`) | Software LIcensing table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `SLIT` | 5.2.17절 (`signature == "SLIT"`) | System Locality distance Information Table | 선택 | 일반적으로는 선택 사항이지만 NUMA system에는 필수입니다. |
| `SPCR` | Signature Reserved (`signature == "SPCR"`) | Serial Port Console Redirection table | 필수 | arm64에 필수입니다. |
| `SPMI` | Signature Reserved (`signature == "SPMI"`) | Server Platform Management Interface table | 선택 | 선택 사항이며 현재 지원하지 않습니다. |
| `SRAT` | 5.2.16절 (`signature == "SRAT"`) | System Resource Affinity Table | 선택 | 선택 사항이지만 사용할 경우 GICC Affinity structure만 읽습니다. arm64 NUMA를 지원하려면 이 테이블이 필수입니다. |
| `SSDT` | 5.2.11.2절 (`signature == "SSDT"`) | Secondary System Description Table | 권장 | DSDT의 연속 부분입니다. 실행 중인 시스템에 추가할 수 있는 장치에 사용하기를 권장하며, 장치 설명을 관리하기 쉬운 조각으로 나누는 데도 쓸 수 있습니다. SSDT는 ACPI namespace에 항목을 추가할 수만 있고 기존 장치 설명을 수정하거나 대체할 수 없습니다. SSDT 자체는 선택 사항이며 ACPI 테이블에는 DSDT 하나와 여러 SSDT가 들어갈 수 있습니다. |
| `STAO` | Signature Reserved (`signature == "STAO"`) | _STA Override table | 선택 | 선택 사항이지만 guest OS에서 장치를 숨겨야 하는 virtualized environment에서만 필요합니다. |
| `TCPA` | Signature Reserved (`signature == "TCPA"`) | Trusted Computing Platform Alliance table | 선택 | 선택 사항이며 현재 지원하지 않습니다. arm64와 완전하게 상호 운용하려면 변경이 필요할 수 있습니다. |
| `TPM2` | Signature Reserved (`signature == "TPM2"`) | Trusted Platform Module 2 table | 선택 | 선택 사항이며 현재 지원하지 않습니다. arm64와 완전하게 상호 운용하려면 변경이 필요할 수 있습니다. |
| `UEFI` | Signature Reserved (`signature == "UEFI"`) | UEFI ACPI data table | 선택 | 선택 사항이며 현재 지원하지 않습니다. 현재 arm64에 알려진 사용 사례는 없습니다. |
| `WAET` | Signature Reserved (`signature == "WAET"`) | Windows ACPI Emulated devices Table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `WDAT` | Signature Reserved (`signature == "WDAT"`) | Watch Dog Action Table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `WDRT` | Signature Reserved (`signature == "WDRT"`) | Watch Dog Resource Table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `WPBT` | Signature Reserved (`signature == "WPBT"`) | Windows Platform Binary Table | 미지원 | Microsoft 전용 테이블이므로 지원하지 않습니다. |
| `XENV` | Signature Reserved (`signature == "XENV"`) | Xen project table | 선택 | 선택 사항이며 현재는 Xen만 사용합니다. |
| `XSDT` | 5.2.8절 (`signature == "XSDT"`) | eXtended System Description Table | 필수 | arm64에 필수입니다. |
ACPI 객체: _CCA부터 _LPI까지
502-583다음 목록은 실제 사용 가능성이 높은 개별 ACPI 객체의 arm64 기대 사항입니다. 아래에 명시하지 않은 객체는 power management나 PCI처럼 특정 플랫폼 또는 subsystem에 필요할 때 사용합니다.
| 이름 | 사양 절 | ARMv8 Linux에서의 사용 |
|---|---|---|
| `_CCA` | 6.2.17 | arm64의 모든 bus master에 반드시 정의해야 합니다. 장치가 cache coherent인지 아닌지에 관한 가정을 두지 않기 때문입니다. `_CCA` 값은 이 장치의 모든 descendant가 상속하므로 반복할 필요가 없습니다. arm64에서 `_CCA`가 없으면 kernel은 장치의 DMA를 어떻게 설정해야 하는지 알 수 없습니다. 이 method는 기본 cache coherency attribute를 제공하지만 SMMU가 이를 바꿀 수 있습니다. 예를 들어 master가 기본적으로 non-coherent여도 적절한 SMMU 구성으로 coherent하게 만들 수 있습니다. IORT 사양 표 17, Arm 문서 `DEN 0049B`를 참조하십시오. |
| `_CID` | 6.1.2 | 필요에 따라 사용합니다. `_HID`도 참조하십시오. |
| `_CLS` | 6.1.3 | 필요에 따라 사용합니다. `_HID`도 참조하십시오. |
| `_CPC` | 8.4.7.1 | Power management에 필요할 때 사용합니다. arm64에서는 CPPC를 권장합니다. |
| `_CRS` | 6.2.2 | arm64에 필수입니다. |
| `_CSD` | 8.4.2.2 | 필요에 따라 사용하며 `_CST`와 함께만 사용합니다. |
| `_CST` | 8.4.2.1 | C-state 대신 low-power idle state(8.4.4절)를 권장합니다. |
| `_DDN` | 6.1.4 | 장치 이름에 사용할 수 있습니다. 그러나 DOS device name, 예를 들면 `COM1`을 위한 field이므로 여러 OS에서 사용할 때 주의하십시오. |
| `_DSD` | 6.2.5 | 주의해서 사용해야 합니다. 이 객체를 사용한다면 이미 Device Properties UUID에 정의된 제약 안에서 사용하십시오. 새 `_DSD` UUID가 필요한 경우는 드물어야 합니다. 어느 경우든 특히 device property를 사용할 때는 driver patch와 함께 `_DSD` 정의를 제출해 논의하십시오. 대응하는 `_DSD` 설명이 없으면 driver는 완전한 것으로 간주되지 않습니다. Kernel maintainer의 승인을 받으면 UUID 또는 device property를 UEFI Forum에 등록해야 하며, 여러 OS가 항목을 등록하므로 이 과정에서 몇 차례 수정이 생길 수 있습니다. |
| `_DSM` | 9.1.1 | 사용하지 마십시오. 표준화되지 않았고 return value 문서가 부족하며 현재도 오류가 빈번하게 발생하는 원인입니다. |
| `\_GL` | 5.7.1 | Hardware reduced mode에서는 사용할 수 없으므로 arm64에서도 사용하지 않아야 합니다. |
| `_GLK` | 6.5.7 | Global Lock 정의가 필요하지만 hardware reduced mode로 실행되는 arm64에는 Global Lock이 없습니다. arm64에서 사용하지 마십시오. |
| `\_GPE` | 5.3.1 | x86 전용 namespace입니다. arm64에서 사용하지 마십시오. |
| `_HID` | 6.1.5 | 장치 probing에 사용하는 주 객체입니다. `_CID`와 `_CLS`도 사용할 수 있습니다. |
| `_INI` | 6.5.1 | 필수는 아니지만 UEFI가 driver probing 전에 driver가 기대하지 않는 상태로 장치를 남겼을 때 장치를 설정하는 데 유용할 수 있습니다. |
| `_LPI` | 8.4.4.3 | arm64의 processor 정의(`_HID ACPI0010`)와 함께 사용하기를 권장합니다. `_RDI`도 참조하십시오. |
ACPI 객체: _MLS부터 _UID까지
584-664| 이름 | 사양 절 | ARMv8 Linux에서의 사용 |
|---|---|---|
| `_MLS` | 6.1.7 | Internationalization을 위해 사용할 것을 강하게 권장합니다. |
| `_OFF` | 7.2.2 | 켜고 끌 수 있는 모든 장치에 이 method를 정의하기를 권장합니다. |
| `_ON` | 7.2.3 | 켜고 끌 수 있는 모든 장치에 이 method를 정의하기를 권장합니다. |
| `\_OS` | 5.7.3 | 기본으로 `Linux`를 반환합니다. 이는 Linux의 `ACPI_OS_NAME` macro 값입니다. Command line parameter `acpi_os=<string>`으로 다른 값을 설정할 수 있습니다. |
| `_OSC` | 6.2.11 | ACPI의 global method, 예를 들어 `\_SB._OSC`일 수도 있고, 특정 장치와 연결된 method, 예를 들어 `\_SB.DEV0._OSC`일 수도 있으며 두 형태를 모두 쓸 수도 있습니다. Global method로 사용할 때는 ACPI 사양에 공개된 capability만 허용합니다. Device-specific method로 사용할 때는 `_DSD` 사용 절차에 따라 `_OSC` 정의를 만들어야 하며 절차 밖의 사용은 허용하지 않습니다. 즉, kernel driver 제출에 device-specific `_OSC` 사용 설명을 포함하고 kernel community의 승인을 받은 다음 UEFI Forum에 등록해야 합니다. |
| `\_OSI` | 5.7.2 | ARM64에서는 폐기되었습니다. ACPI firmware는 `_OSI`로 시스템 종류나 제공 기능을 판단해서는 안 되며 대신 `_OSC` method를 사용해야 합니다. |
| `_PDC` | 8.4.1 | 폐기되었으므로 arm64에서 사용하지 마십시오. |
| `\_PIC` | 5.8.1 | 사용하지 않아야 합니다. arm64에서 사용할 수 있는 유일한 interrupt model은 GIC입니다. |
| `\_PR` | 5.3.1 | Legacy system의 x86 전용 namespace입니다. arm64에서 사용하지 마십시오. |
| `_PRT` | 6.2.13 | 모든 PCI root device 정의의 일부로 반드시 필요합니다. |
| `_PRx` | 7.3.8-11 | Power management에 필요할 때 사용합니다. `_PR0`을 정의하면 `_PR3`도 정의해야 합니다. |
| `_PSx` | 7.3.2-5 | Power management에 필요할 때 사용합니다. `_PS0`을 정의하면 `_PS3`도 정의해야 합니다. 전력 사용량에 맞추기 위해 clock이나 regulator 조정이 필요하면 이 method들에서 변경하십시오. |
| `_RDI` | 8.4.4.4 | arm64의 processor 정의(`_HID ACPI0010`)와 함께 사용하기를 권장합니다. `_LPI`와 함께만 사용해야 합니다. |
| `\_REV` | 5.7.4 | 지원되는 최신 ACPI version을 항상 반환합니다. |
| `\_SB` | 5.3.1 | arm64에 필수이며 모든 장치를 이 namespace에 정의해야 합니다. |
| `_SLI` | 6.2.15 | SLIT 테이블을 사용할 때 사용을 권장합니다. |
| `_STA` | 6.3.7, 7.2.4 | 켜고 끌 수 있는 모든 장치에 이 method를 정의하기를 권장합니다. Virtualized environment에서 장치를 숨기는 override를 제공하는 STAO 테이블도 참조하십시오. |
| `_SRS` | 6.2.16 | 필요에 따라 사용합니다. `_PRS`도 참조하십시오. |
| `_STR` | 6.1.10 | 최종 사용자에게 장치 이름을 전달하는 데 권장하며 `_DDN`보다 우선합니다. |
| `_SUB` | 6.1.9 | 필요에 따라 사용하지만 `_HID` 또는 `_CID`를 우선합니다. |
| `_SUN` | 6.1.11 | 필요에 따라 사용하며 사용을 권장합니다. |
| `_SWS` | 7.4.3 | Power management에 필요할 때 사용합니다. arm64에서 사용하려면 사양 변경이 필요할 수 있습니다. |
| `_UID` | 6.1.12 | 같은 class의 장치를 구분하는 데 권장합니다. 가능하다면 반드시 정의하십시오. |
ACPI 이벤트 모델
665-680GPE block device는 사용하지 마십시오. arm64가 사용하는 hardware reduced profile에서는 지원하지 않습니다. ARM 플랫폼용 GPE block 정의가 없으므로 ACPI event는 다른 방식으로 알려야 합니다.
선택지는 GPIO-signaled interrupt(5.6.5절)와 interrupt-signaled event(5.6.9절) 두 가지입니다. Interrupt-signaled event는 ACPI 6.1 사양에 추가된 기능입니다. 한 플랫폼에서 둘 중 하나 또는 둘 다 사용할 수 있고, 선택은 해당 SoC의 제약에 따라 달라질 수 있습니다. 가능하면 interrupt-signaled event를 권장합니다.
ACPI 프로세서 제어
681-713ACPI 사양 8절은 version 6.0에서 크게 바뀌었습니다. 이제 processor는 `_HID ACPI0007`을 가진 Device 객체로 정의해야 하며, ASL의 폐기된 Processor statement는 사용하지 마십시오. 모든 multiprocessor system은 Processor Container Device(8.4.3.1절, `_HID ACPI0010`)로 processor hierarchy도 정의해야 합니다. Processor topology를 설명하는 데 processor aggregator device(8.5절)를 사용하지 마십시오. 사양 8.4절은 이 객체 정의의 의미와 상호 관계를 설명합니다.
가장 중요한 점은 이 processor hierarchy가 플랫폼에서 사용할 수 있는 low-power idle state와 어느 processor를 어떤 조건에서 켜거나 끌 수 있는지 정하는 규칙까지 정의한다는 것입니다. 이 정보가 없으면 processor는 UEFI가 남긴 power state에서 그대로 실행됩니다.
정의된 processor Device 객체와 MADT의 GIC entry는 서로 일치해야 합니다. Device 객체의 `_UID`는 MADT에서 사용하는 processor ID와 대응해야 합니다.
arm64의 주 processor performance control model로 CPPC(8.4.5절)를 사용하기를 권장합니다. C-state와 P-state를 나중에 사용할 수 있게 될 수도 있지만 현재 설계 작업 대부분은 CPPC를 선호합니다.
또한 ARMv8 SoC가 완전히 동작하는 PSCI 구현을 제공하는 것이 필수입니다. ACPI가 CPU power state를 제어하기 위해 지원하는 유일한 메커니즘입니다. ACPI parking protocol로 secondary CPU를 boot할 수는 있지만 ARM server에서는 PSCI만 지원하므로 권장하지 않습니다.
ACPI 시스템 주소 맵 인터페이스
714-721ACPI 사양 15절은 memory resource 정보를 kernel에 전달할 수 있는 여러 메커니즘을 언급합니다. arm64에서는 ACPI 부팅에 UEFI만 지원하므로 UEFI `GetMemoryMap()` boot service만 사용합니다.
ACPI Platform Error Interfaces(APEI)
722-741지원되는 APEI 테이블은 앞에서 설명했습니다. APEI에는 ARMv8에서 SCI와 NMI에 해당하는 기능이 필요합니다. SCI는 발생했지만 수정할 수 있어 시스템이 성능 저하 상태일지라도 올바르게 계속 동작할 수 있는 오류를 OSPM에 알립니다. NMI는 수정할 수 없고 즉각적인 조치가 필요한 fatal error를 나타냅니다.
arm64에는 x86 SCI나 NMI와 정확히 같은 것이 없으므로 조금 다르게 처리합니다. SCI는 high-priority interrupt로 처리하며 보고 대상이 수정되었거나 수정 가능한 오류이므로 이것으로 충분합니다. NMI는 가능한 가장 높은 우선순위 interrupt로 emulate합니다. 더 높은 privilege level의 interrupt나 emulate된 NMI와 같은 우선순위의 interrupt가 있을 수 있으므로 주의해야 합니다. Linux에서는 이런 일이 없어야 하지만 발생 가능성은 알아 두어야 합니다.
ARM64에서 지원하지 않는 ACPI 객체 종류
742-781앞으로 바뀔 수는 있지만, 정의 가능하면서도 현재 ARM server 전반에는 관심 대상이 아닌 객체 종류가 여러 개 있습니다. 일부는 x86 대응물이 있어 ARM server에서도 의미가 있을 수 있으나, 현재 hardware가 없거나 non-ARM 구현조차 없을 수 있으므로 아직 지원하지 않습니다.
지원하지 않는 객체 종류는 다음과 같습니다.
- 9.2절: ambient light sensor device
- 9.3절: battery device
- 9.4절: lid, 예를 들면 laptop lid
- 9.8.2절: IDE controller
- 9.9절: floppy controller
- 9.10절: GPE block device
- 9.15절: PC/AT RTC/CMOS device
- 9.16절: user presence detection device
- 9.17절: I/O APIC device. 모든 GIC는 MADT로 열거할 수 있어야 합니다.
- 9.18절: time and alarm device. 9.15절도 참조하십시오.
- 10절: power source와 power meter device
- 11절: thermal management
- 12절: embedded controller interface
- 13절: SMBus interface
ARM64에서 지원하지 않는 개별 객체
782-809앞의 미지원 객체 종류에 따라 다음 개별 객체도 지원하지 않습니다. 원문의 두 쌍짜리 표 구조와 절 번호를 그대로 보존했습니다.
| 이름 | 사양 절 | 이름 | 사양 절 |
|---|---|---|---|
| `_ALC` | 9.3.4 | `_FDM` | 9.10.3 |
| `_ALI` | 9.3.2 | `_FIX` | 6.2.7 |
| `_ALP` | 9.3.6 | `_GAI` | 10.4.5 |
| `_ALR` | 9.3.5 | `_GHL` | 10.4.7 |
| `_ALT` | 9.3.3 | `_GTM` | 9.9.2.1.1 |
| `_BCT` | 10.2.2.10 | `_LID` | 9.5.1 |
| `_BDN` | 6.5.3 | `_PAI` | 10.4.4 |
| `_BIF` | 10.2.2.1 | `_PCL` | 10.3.2 |
| `_BIX` | 10.2.2.1 | `_PIF` | 10.3.3 |
| `_BLT` | 9.2.3 | `_PMC` | 10.4.1 |
| `_BMA` | 10.2.2.4 | `_PMD` | 10.4.8 |
| `_BMC` | 10.2.2.12 | `_PMM` | 10.4.3 |
| `_BMD` | 10.2.2.11 | `_PRL` | 10.3.4 |
| `_BMS` | 10.2.2.5 | `_PSR` | 10.3.1 |
| `_BST` | 10.2.2.6 | `_PTP` | 10.4.2 |
| `_BTH` | 10.2.2.7 | `_SBS` | 10.1.3 |
| `_BTM` | 10.2.2.9 | `_SHL` | 10.4.6 |
| `_BTP` | 10.2.2.8 | `_STM` | 9.9.2.1.1 |
| `_DCK` | 6.5.2 | `_UPD` | 9.16.1 |
| `_EC` | 12.12 | `_UPP` | 9.16.2 |
| `_FDE` | 9.10.1 | `_WPC` | 10.5.2 |
| `_FDI` | 9.10.2 | `_WPP` | 10.5.3 |
요약과 해설
acpi_object_usage.rst:1-809ARM64 ACPI는 hardware reduced profile을 전제로 합니다. 따라서 firmware가 필수 discovery table과 `_CCA`, `_CRS`, `\_SB` 같은 namespace 계약을 정확히 제공하고, processor power control은 PSCI와 CPPC 중심으로 구성해야 합니다.
65개 테이블을 platform firmware 구현 관점에서 네 등급으로 분류합니다.
Firmware가 discovery·namespace·runtime control 정보를 제공하고 Linux가 hardware reduced 규칙으로 소비합니다.
GPE block, legacy x86 processor namespace와 Global Lock을 사용하지 않는다는 점이 ARM64 ACPI 구현의 가장 중요한 경계입니다.