VirtualBox

source: vbox/trunk/src/VBox/Devices/EFI/Firmware/MdePkg/Include/IndustryStandard/Acpi62.h

Last change on this file was 105670, checked in by vboxsync, 8 months ago

Devices/EFI/FirmwareNew: Merge edk2-stable-202405 and make it build on aarch64, bugref:4643
  • Property svn:eol-style set to native
File size: 100.7 KB
Line 
1/** @file
2 ACPI 6.2 definitions from the ACPI Specification Revision 6.2 May, 2017.
3
4 Copyright (c) 2017 - 2022, Intel Corporation. All rights reserved.<BR>
5 Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>
6 SPDX-License-Identifier: BSD-2-Clause-Patent
7**/
8
9#ifndef _ACPI_6_2_H_
10#define _ACPI_6_2_H_
11
12#include <IndustryStandard/Acpi61.h>
13
14//
15// Large Item Descriptor Name
16//
17#define ACPI_LARGE_PIN_FUNCTION_DESCRIPTOR_NAME 0x0D
18#define ACPI_LARGE_PIN_CONFIGURATION_DESCRIPTOR_NAME 0x0F
19#define ACPI_LARGE_PIN_GROUP_DESCRIPTOR_NAME 0x10
20#define ACPI_LARGE_PIN_GROUP_FUNCTION_DESCRIPTOR_NAME 0x11
21#define ACPI_LARGE_PIN_GROUP_CONFIGURATION_DESCRIPTOR_NAME 0x12
22
23//
24// Large Item Descriptor Value
25//
26#define ACPI_PIN_FUNCTION_DESCRIPTOR 0x8D
27#define ACPI_PIN_CONFIGURATION_DESCRIPTOR 0x8F
28#define ACPI_PIN_GROUP_DESCRIPTOR 0x90
29#define ACPI_PIN_GROUP_FUNCTION_DESCRIPTOR 0x91
30#define ACPI_PIN_GROUP_CONFIGURATION_DESCRIPTOR 0x92
31
32///
33/// _PSD Revision for ACPI 6.2
34///
35#define EFI_ACPI_6_2_AML_PSD_REVISION 0
36
37///
38/// _CPC Revision for ACPI 6.2
39///
40#define EFI_ACPI_6_2_AML_CPC_REVISION 3
41
42#pragma pack(1)
43
44///
45/// Pin Function Descriptor
46///
47typedef PACKED struct {
48 ACPI_LARGE_RESOURCE_HEADER Header;
49 UINT8 RevisionId;
50 UINT16 Flags;
51 UINT8 PinPullConfiguration;
52 UINT16 FunctionNumber;
53 UINT16 PinTableOffset;
54 UINT8 ResourceSourceIndex;
55 UINT16 ResourceSourceNameOffset;
56 UINT16 VendorDataOffset;
57 UINT16 VendorDataLength;
58} EFI_ACPI_PIN_FUNCTION_DESCRIPTOR;
59
60///
61/// Pin Configuration Descriptor
62///
63typedef PACKED struct {
64 ACPI_LARGE_RESOURCE_HEADER Header;
65 UINT8 RevisionId;
66 UINT16 Flags;
67 UINT8 PinConfigurationType;
68 UINT32 PinConfigurationValue;
69 UINT16 PinTableOffset;
70 UINT8 ResourceSourceIndex;
71 UINT16 ResourceSourceNameOffset;
72 UINT16 VendorDataOffset;
73 UINT16 VendorDataLength;
74} EFI_ACPI_PIN_CONFIGURATION_DESCRIPTOR;
75
76///
77/// Pin Group Descriptor
78///
79typedef PACKED struct {
80 ACPI_LARGE_RESOURCE_HEADER Header;
81 UINT8 RevisionId;
82 UINT16 Flags;
83 UINT16 PinTableOffset;
84 UINT16 ResourceLabelOffset;
85 UINT16 VendorDataOffset;
86 UINT16 VendorDataLength;
87} EFI_ACPI_PIN_GROUP_DESCRIPTOR;
88
89///
90/// Pin Group Function Descriptor
91///
92typedef PACKED struct {
93 ACPI_LARGE_RESOURCE_HEADER Header;
94 UINT8 RevisionId;
95 UINT16 Flags;
96 UINT16 FunctionNumber;
97 UINT8 ResourceSourceIndex;
98 UINT16 ResourceSourceNameOffset;
99 UINT16 ResourceSourceLabelOffset;
100 UINT16 VendorDataOffset;
101 UINT16 VendorDataLength;
102} EFI_ACPI_PIN_GROUP_FUNCTION_DESCRIPTOR;
103
104///
105/// Pin Group Configuration Descriptor
106///
107typedef PACKED struct {
108 ACPI_LARGE_RESOURCE_HEADER Header;
109 UINT8 RevisionId;
110 UINT16 Flags;
111 UINT8 PinConfigurationType;
112 UINT32 PinConfigurationValue;
113 UINT8 ResourceSourceIndex;
114 UINT16 ResourceSourceNameOffset;
115 UINT16 ResourceSourceLabelOffset;
116 UINT16 VendorDataOffset;
117 UINT16 VendorDataLength;
118} EFI_ACPI_PIN_GROUP_CONFIGURATION_DESCRIPTOR;
119
120#pragma pack()
121
122//
123// Ensure proper structure formats
124//
125#pragma pack(1)
126
127///
128/// ACPI 6.2 Generic Address Space definition
129///
130typedef struct {
131 UINT8 AddressSpaceId;
132 UINT8 RegisterBitWidth;
133 UINT8 RegisterBitOffset;
134 UINT8 AccessSize;
135 UINT64 Address;
136} EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE;
137
138//
139// Generic Address Space Address IDs
140//
141#define EFI_ACPI_6_2_SYSTEM_MEMORY 0
142#define EFI_ACPI_6_2_SYSTEM_IO 1
143#define EFI_ACPI_6_2_PCI_CONFIGURATION_SPACE 2
144#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER 3
145#define EFI_ACPI_6_2_SMBUS 4
146#define EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL 0x0A
147#define EFI_ACPI_6_2_FUNCTIONAL_FIXED_HARDWARE 0x7F
148
149//
150// Generic Address Space Access Sizes
151//
152#define EFI_ACPI_6_2_UNDEFINED 0
153#define EFI_ACPI_6_2_BYTE 1
154#define EFI_ACPI_6_2_WORD 2
155#define EFI_ACPI_6_2_DWORD 3
156#define EFI_ACPI_6_2_QWORD 4
157
158//
159// ACPI 6.2 table structures
160//
161
162///
163/// Root System Description Pointer Structure
164///
165typedef struct {
166 UINT64 Signature;
167 UINT8 Checksum;
168 UINT8 OemId[6];
169 UINT8 Revision;
170 UINT32 RsdtAddress;
171 UINT32 Length;
172 UINT64 XsdtAddress;
173 UINT8 ExtendedChecksum;
174 UINT8 Reserved[3];
175} EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER;
176
177///
178/// RSD_PTR Revision (as defined in ACPI 6.2 spec.)
179///
180#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02 ///< ACPISpec (Revision 6.2) says current value is 2
181
182///
183/// Common table header, this prefaces all ACPI tables, including FACS, but
184/// excluding the RSD PTR structure
185///
186typedef struct {
187 UINT32 Signature;
188 UINT32 Length;
189} EFI_ACPI_6_2_COMMON_HEADER;
190
191//
192// Root System Description Table
193// No definition needed as it is a common description table header, the same with
194// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.
195//
196
197///
198/// RSDT Revision (as defined in ACPI 6.2 spec.)
199///
200#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01
201
202//
203// Extended System Description Table
204// No definition needed as it is a common description table header, the same with
205// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.
206//
207
208///
209/// XSDT Revision (as defined in ACPI 6.2 spec.)
210///
211#define EFI_ACPI_6_2_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01
212
213///
214/// Fixed ACPI Description Table Structure (FADT)
215///
216typedef struct {
217 EFI_ACPI_DESCRIPTION_HEADER Header;
218 UINT32 FirmwareCtrl;
219 UINT32 Dsdt;
220 UINT8 Reserved0;
221 UINT8 PreferredPmProfile;
222 UINT16 SciInt;
223 UINT32 SmiCmd;
224 UINT8 AcpiEnable;
225 UINT8 AcpiDisable;
226 UINT8 S4BiosReq;
227 UINT8 PstateCnt;
228 UINT32 Pm1aEvtBlk;
229 UINT32 Pm1bEvtBlk;
230 UINT32 Pm1aCntBlk;
231 UINT32 Pm1bCntBlk;
232 UINT32 Pm2CntBlk;
233 UINT32 PmTmrBlk;
234 UINT32 Gpe0Blk;
235 UINT32 Gpe1Blk;
236 UINT8 Pm1EvtLen;
237 UINT8 Pm1CntLen;
238 UINT8 Pm2CntLen;
239 UINT8 PmTmrLen;
240 UINT8 Gpe0BlkLen;
241 UINT8 Gpe1BlkLen;
242 UINT8 Gpe1Base;
243 UINT8 CstCnt;
244 UINT16 PLvl2Lat;
245 UINT16 PLvl3Lat;
246 UINT16 FlushSize;
247 UINT16 FlushStride;
248 UINT8 DutyOffset;
249 UINT8 DutyWidth;
250 UINT8 DayAlrm;
251 UINT8 MonAlrm;
252 UINT8 Century;
253 UINT16 IaPcBootArch;
254 UINT8 Reserved1;
255 UINT32 Flags;
256 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE ResetReg;
257 UINT8 ResetValue;
258 UINT16 ArmBootArch;
259 UINT8 MinorVersion;
260 UINT64 XFirmwareCtrl;
261 UINT64 XDsdt;
262 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPm1aEvtBlk;
263 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPm1bEvtBlk;
264 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPm1aCntBlk;
265 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPm1bCntBlk;
266 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPm2CntBlk;
267 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XPmTmrBlk;
268 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XGpe0Blk;
269 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE XGpe1Blk;
270 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE SleepControlReg;
271 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE SleepStatusReg;
272 UINT64 HypervisorVendorIdentity;
273} EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE;
274
275///
276/// FADT Version (as defined in ACPI 6.2 spec.)
277///
278#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_REVISION 0x06
279#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION 0x02
280
281//
282// Fixed ACPI Description Table Preferred Power Management Profile
283//
284#define EFI_ACPI_6_2_PM_PROFILE_UNSPECIFIED 0
285#define EFI_ACPI_6_2_PM_PROFILE_DESKTOP 1
286#define EFI_ACPI_6_2_PM_PROFILE_MOBILE 2
287#define EFI_ACPI_6_2_PM_PROFILE_WORKSTATION 3
288#define EFI_ACPI_6_2_PM_PROFILE_ENTERPRISE_SERVER 4
289#define EFI_ACPI_6_2_PM_PROFILE_SOHO_SERVER 5
290#define EFI_ACPI_6_2_PM_PROFILE_APPLIANCE_PC 6
291#define EFI_ACPI_6_2_PM_PROFILE_PERFORMANCE_SERVER 7
292#define EFI_ACPI_6_2_PM_PROFILE_TABLET 8
293
294//
295// Fixed ACPI Description Table Boot Architecture Flags
296// All other bits are reserved and must be set to 0.
297//
298#define EFI_ACPI_6_2_LEGACY_DEVICES BIT0
299#define EFI_ACPI_6_2_8042 BIT1
300#define EFI_ACPI_6_2_VGA_NOT_PRESENT BIT2
301#define EFI_ACPI_6_2_MSI_NOT_SUPPORTED BIT3
302#define EFI_ACPI_6_2_PCIE_ASPM_CONTROLS BIT4
303#define EFI_ACPI_6_2_CMOS_RTC_NOT_PRESENT BIT5
304
305//
306// Fixed ACPI Description Table Arm Boot Architecture Flags
307// All other bits are reserved and must be set to 0.
308//
309#define EFI_ACPI_6_2_ARM_PSCI_COMPLIANT BIT0
310#define EFI_ACPI_6_2_ARM_PSCI_USE_HVC BIT1
311
312//
313// Fixed ACPI Description Table Fixed Feature Flags
314// All other bits are reserved and must be set to 0.
315//
316#define EFI_ACPI_6_2_WBINVD BIT0
317#define EFI_ACPI_6_2_WBINVD_FLUSH BIT1
318#define EFI_ACPI_6_2_PROC_C1 BIT2
319#define EFI_ACPI_6_2_P_LVL2_UP BIT3
320#define EFI_ACPI_6_2_PWR_BUTTON BIT4
321#define EFI_ACPI_6_2_SLP_BUTTON BIT5
322#define EFI_ACPI_6_2_FIX_RTC BIT6
323#define EFI_ACPI_6_2_RTC_S4 BIT7
324#define EFI_ACPI_6_2_TMR_VAL_EXT BIT8
325#define EFI_ACPI_6_2_DCK_CAP BIT9
326#define EFI_ACPI_6_2_RESET_REG_SUP BIT10
327#define EFI_ACPI_6_2_SEALED_CASE BIT11
328#define EFI_ACPI_6_2_HEADLESS BIT12
329#define EFI_ACPI_6_2_CPU_SW_SLP BIT13
330#define EFI_ACPI_6_2_PCI_EXP_WAK BIT14
331#define EFI_ACPI_6_2_USE_PLATFORM_CLOCK BIT15
332#define EFI_ACPI_6_2_S4_RTC_STS_VALID BIT16
333#define EFI_ACPI_6_2_REMOTE_POWER_ON_CAPABLE BIT17
334#define EFI_ACPI_6_2_FORCE_APIC_CLUSTER_MODEL BIT18
335#define EFI_ACPI_6_2_FORCE_APIC_PHYSICAL_DESTINATION_MODE BIT19
336#define EFI_ACPI_6_2_HW_REDUCED_ACPI BIT20
337#define EFI_ACPI_6_2_LOW_POWER_S0_IDLE_CAPABLE BIT21
338
339///
340/// Firmware ACPI Control Structure
341///
342typedef struct {
343 UINT32 Signature;
344 UINT32 Length;
345 UINT32 HardwareSignature;
346 UINT32 FirmwareWakingVector;
347 UINT32 GlobalLock;
348 UINT32 Flags;
349 UINT64 XFirmwareWakingVector;
350 UINT8 Version;
351 UINT8 Reserved0[3];
352 UINT32 OspmFlags;
353 UINT8 Reserved1[24];
354} EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE;
355
356///
357/// FACS Version (as defined in ACPI 6.2 spec.)
358///
359#define EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION 0x02
360
361///
362/// Firmware Control Structure Feature Flags
363/// All other bits are reserved and must be set to 0.
364///
365#define EFI_ACPI_6_2_S4BIOS_F BIT0
366#define EFI_ACPI_6_2_64BIT_WAKE_SUPPORTED_F BIT1
367
368///
369/// OSPM Enabled Firmware Control Structure Flags
370/// All other bits are reserved and must be set to 0.
371///
372#define EFI_ACPI_6_2_OSPM_64BIT_WAKE_F BIT0
373
374//
375// Differentiated System Description Table,
376// Secondary System Description Table
377// and Persistent System Description Table,
378// no definition needed as they are common description table header, the same with
379// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.
380//
381#define EFI_ACPI_6_2_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x02
382#define EFI_ACPI_6_2_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION 0x02
383
384///
385/// Multiple APIC Description Table header definition. The rest of the table
386/// must be defined in a platform specific manner.
387///
388typedef struct {
389 EFI_ACPI_DESCRIPTION_HEADER Header;
390 UINT32 LocalApicAddress;
391 UINT32 Flags;
392} EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;
393
394///
395/// MADT Revision (as defined in ACPI 6.2 spec.)
396///
397#define EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x04
398
399///
400/// Multiple APIC Flags
401/// All other bits are reserved and must be set to 0.
402///
403#define EFI_ACPI_6_2_PCAT_COMPAT BIT0
404
405//
406// Multiple APIC Description Table APIC structure types
407// All other values between 0x0D and 0x7F are reserved and
408// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.
409//
410#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC 0x00
411#define EFI_ACPI_6_2_IO_APIC 0x01
412#define EFI_ACPI_6_2_INTERRUPT_SOURCE_OVERRIDE 0x02
413#define EFI_ACPI_6_2_NON_MASKABLE_INTERRUPT_SOURCE 0x03
414#define EFI_ACPI_6_2_LOCAL_APIC_NMI 0x04
415#define EFI_ACPI_6_2_LOCAL_APIC_ADDRESS_OVERRIDE 0x05
416#define EFI_ACPI_6_2_IO_SAPIC 0x06
417#define EFI_ACPI_6_2_LOCAL_SAPIC 0x07
418#define EFI_ACPI_6_2_PLATFORM_INTERRUPT_SOURCES 0x08
419#define EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC 0x09
420#define EFI_ACPI_6_2_LOCAL_X2APIC_NMI 0x0A
421#define EFI_ACPI_6_2_GIC 0x0B
422#define EFI_ACPI_6_2_GICD 0x0C
423#define EFI_ACPI_6_2_GIC_MSI_FRAME 0x0D
424#define EFI_ACPI_6_2_GICR 0x0E
425#define EFI_ACPI_6_2_GIC_ITS 0x0F
426
427//
428// APIC Structure Definitions
429//
430
431///
432/// Processor Local APIC Structure Definition
433///
434typedef struct {
435 UINT8 Type;
436 UINT8 Length;
437 UINT8 AcpiProcessorUid;
438 UINT8 ApicId;
439 UINT32 Flags;
440} EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_STRUCTURE;
441
442///
443/// Local APIC Flags. All other bits are reserved and must be 0.
444///
445#define EFI_ACPI_6_2_LOCAL_APIC_ENABLED BIT0
446
447///
448/// IO APIC Structure
449///
450typedef struct {
451 UINT8 Type;
452 UINT8 Length;
453 UINT8 IoApicId;
454 UINT8 Reserved;
455 UINT32 IoApicAddress;
456 UINT32 GlobalSystemInterruptBase;
457} EFI_ACPI_6_2_IO_APIC_STRUCTURE;
458
459///
460/// Interrupt Source Override Structure
461///
462typedef struct {
463 UINT8 Type;
464 UINT8 Length;
465 UINT8 Bus;
466 UINT8 Source;
467 UINT32 GlobalSystemInterrupt;
468 UINT16 Flags;
469} EFI_ACPI_6_2_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;
470
471///
472/// Platform Interrupt Sources Structure Definition
473///
474typedef struct {
475 UINT8 Type;
476 UINT8 Length;
477 UINT16 Flags;
478 UINT8 InterruptType;
479 UINT8 ProcessorId;
480 UINT8 ProcessorEid;
481 UINT8 IoSapicVector;
482 UINT32 GlobalSystemInterrupt;
483 UINT32 PlatformInterruptSourceFlags;
484 UINT8 CpeiProcessorOverride;
485 UINT8 Reserved[31];
486} EFI_ACPI_6_2_PLATFORM_INTERRUPT_APIC_STRUCTURE;
487
488//
489// MPS INTI flags.
490// All other bits are reserved and must be set to 0.
491//
492#define EFI_ACPI_6_2_POLARITY (3 << 0)
493#define EFI_ACPI_6_2_TRIGGER_MODE (3 << 2)
494
495///
496/// Non-Maskable Interrupt Source Structure
497///
498typedef struct {
499 UINT8 Type;
500 UINT8 Length;
501 UINT16 Flags;
502 UINT32 GlobalSystemInterrupt;
503} EFI_ACPI_6_2_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;
504
505///
506/// Local APIC NMI Structure
507///
508typedef struct {
509 UINT8 Type;
510 UINT8 Length;
511 UINT8 AcpiProcessorUid;
512 UINT16 Flags;
513 UINT8 LocalApicLint;
514} EFI_ACPI_6_2_LOCAL_APIC_NMI_STRUCTURE;
515
516///
517/// Local APIC Address Override Structure
518///
519typedef struct {
520 UINT8 Type;
521 UINT8 Length;
522 UINT16 Reserved;
523 UINT64 LocalApicAddress;
524} EFI_ACPI_6_2_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;
525
526///
527/// IO SAPIC Structure
528///
529typedef struct {
530 UINT8 Type;
531 UINT8 Length;
532 UINT8 IoApicId;
533 UINT8 Reserved;
534 UINT32 GlobalSystemInterruptBase;
535 UINT64 IoSapicAddress;
536} EFI_ACPI_6_2_IO_SAPIC_STRUCTURE;
537
538///
539/// Local SAPIC Structure
540/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String
541///
542typedef struct {
543 UINT8 Type;
544 UINT8 Length;
545 UINT8 AcpiProcessorId;
546 UINT8 LocalSapicId;
547 UINT8 LocalSapicEid;
548 UINT8 Reserved[3];
549 UINT32 Flags;
550 UINT32 ACPIProcessorUIDValue;
551} EFI_ACPI_6_2_PROCESSOR_LOCAL_SAPIC_STRUCTURE;
552
553///
554/// Platform Interrupt Sources Structure
555///
556typedef struct {
557 UINT8 Type;
558 UINT8 Length;
559 UINT16 Flags;
560 UINT8 InterruptType;
561 UINT8 ProcessorId;
562 UINT8 ProcessorEid;
563 UINT8 IoSapicVector;
564 UINT32 GlobalSystemInterrupt;
565 UINT32 PlatformInterruptSourceFlags;
566} EFI_ACPI_6_2_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;
567
568///
569/// Platform Interrupt Source Flags.
570/// All other bits are reserved and must be set to 0.
571///
572#define EFI_ACPI_6_2_CPEI_PROCESSOR_OVERRIDE BIT0
573
574///
575/// Processor Local x2APIC Structure Definition
576///
577typedef struct {
578 UINT8 Type;
579 UINT8 Length;
580 UINT8 Reserved[2];
581 UINT32 X2ApicId;
582 UINT32 Flags;
583 UINT32 AcpiProcessorUid;
584} EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_STRUCTURE;
585
586///
587/// Local x2APIC NMI Structure
588///
589typedef struct {
590 UINT8 Type;
591 UINT8 Length;
592 UINT16 Flags;
593 UINT32 AcpiProcessorUid;
594 UINT8 LocalX2ApicLint;
595 UINT8 Reserved[3];
596} EFI_ACPI_6_2_LOCAL_X2APIC_NMI_STRUCTURE;
597
598///
599/// GIC Structure
600///
601typedef struct {
602 UINT8 Type;
603 UINT8 Length;
604 UINT16 Reserved;
605 UINT32 CPUInterfaceNumber;
606 UINT32 AcpiProcessorUid;
607 UINT32 Flags;
608 UINT32 ParkingProtocolVersion;
609 UINT32 PerformanceInterruptGsiv;
610 UINT64 ParkedAddress;
611 UINT64 PhysicalBaseAddress;
612 UINT64 GICV;
613 UINT64 GICH;
614 UINT32 VGICMaintenanceInterrupt;
615 UINT64 GICRBaseAddress;
616 UINT64 MPIDR;
617 UINT8 ProcessorPowerEfficiencyClass;
618 UINT8 Reserved2[3];
619} EFI_ACPI_6_2_GIC_STRUCTURE;
620
621///
622/// GIC Flags. All other bits are reserved and must be 0.
623///
624#define EFI_ACPI_6_2_GIC_ENABLED BIT0
625#define EFI_ACPI_6_2_PERFORMANCE_INTERRUPT_MODEL BIT1
626#define EFI_ACPI_6_2_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS BIT2
627
628///
629/// GIC Distributor Structure
630///
631typedef struct {
632 UINT8 Type;
633 UINT8 Length;
634 UINT16 Reserved1;
635 UINT32 GicId;
636 UINT64 PhysicalBaseAddress;
637 UINT32 SystemVectorBase;
638 UINT8 GicVersion;
639 UINT8 Reserved2[3];
640} EFI_ACPI_6_2_GIC_DISTRIBUTOR_STRUCTURE;
641
642///
643/// GIC Version
644///
645#define EFI_ACPI_6_2_GIC_V1 0x01
646#define EFI_ACPI_6_2_GIC_V2 0x02
647#define EFI_ACPI_6_2_GIC_V3 0x03
648#define EFI_ACPI_6_2_GIC_V4 0x04
649
650///
651/// GIC MSI Frame Structure
652///
653typedef struct {
654 UINT8 Type;
655 UINT8 Length;
656 UINT16 Reserved1;
657 UINT32 GicMsiFrameId;
658 UINT64 PhysicalBaseAddress;
659 UINT32 Flags;
660 UINT16 SPICount;
661 UINT16 SPIBase;
662} EFI_ACPI_6_2_GIC_MSI_FRAME_STRUCTURE;
663
664///
665/// GIC MSI Frame Flags. All other bits are reserved and must be 0.
666///
667#define EFI_ACPI_6_2_SPI_COUNT_BASE_SELECT BIT0
668
669///
670/// GICR Structure
671///
672typedef struct {
673 UINT8 Type;
674 UINT8 Length;
675 UINT16 Reserved;
676 UINT64 DiscoveryRangeBaseAddress;
677 UINT32 DiscoveryRangeLength;
678} EFI_ACPI_6_2_GICR_STRUCTURE;
679
680///
681/// GIC Interrupt Translation Service Structure
682///
683typedef struct {
684 UINT8 Type;
685 UINT8 Length;
686 UINT16 Reserved;
687 UINT32 GicItsId;
688 UINT64 PhysicalBaseAddress;
689 UINT32 Reserved2;
690} EFI_ACPI_6_2_GIC_ITS_STRUCTURE;
691
692///
693/// Smart Battery Description Table (SBST)
694///
695typedef struct {
696 EFI_ACPI_DESCRIPTION_HEADER Header;
697 UINT32 WarningEnergyLevel;
698 UINT32 LowEnergyLevel;
699 UINT32 CriticalEnergyLevel;
700} EFI_ACPI_6_2_SMART_BATTERY_DESCRIPTION_TABLE;
701
702///
703/// SBST Version (as defined in ACPI 6.2 spec.)
704///
705#define EFI_ACPI_6_2_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01
706
707///
708/// Embedded Controller Boot Resources Table (ECDT)
709/// The table is followed by a null terminated ASCII string that contains
710/// a fully qualified reference to the name space object.
711///
712typedef struct {
713 EFI_ACPI_DESCRIPTION_HEADER Header;
714 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE EcControl;
715 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE EcData;
716 UINT32 Uid;
717 UINT8 GpeBit;
718} EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;
719
720///
721/// ECDT Version (as defined in ACPI 6.2 spec.)
722///
723#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION 0x01
724
725///
726/// System Resource Affinity Table (SRAT). The rest of the table
727/// must be defined in a platform specific manner.
728///
729typedef struct {
730 EFI_ACPI_DESCRIPTION_HEADER Header;
731 UINT32 Reserved1; ///< Must be set to 1
732 UINT64 Reserved2;
733} EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;
734
735///
736/// SRAT Version (as defined in ACPI 6.2 spec.)
737///
738#define EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION 0x03
739
740//
741// SRAT structure types.
742// All other values between 0x05 an 0xFF are reserved and
743// will be ignored by OSPM.
744//
745#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY 0x00
746#define EFI_ACPI_6_2_MEMORY_AFFINITY 0x01
747#define EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_AFFINITY 0x02
748#define EFI_ACPI_6_2_GICC_AFFINITY 0x03
749#define EFI_ACPI_6_2_GIC_ITS_AFFINITY 0x04
750
751///
752/// Processor Local APIC/SAPIC Affinity Structure Definition
753///
754typedef struct {
755 UINT8 Type;
756 UINT8 Length;
757 UINT8 ProximityDomain7To0;
758 UINT8 ApicId;
759 UINT32 Flags;
760 UINT8 LocalSapicEid;
761 UINT8 ProximityDomain31To8[3];
762 UINT32 ClockDomain;
763} EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;
764
765///
766/// Local APIC/SAPIC Flags. All other bits are reserved and must be 0.
767///
768#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)
769
770///
771/// Memory Affinity Structure Definition
772///
773typedef struct {
774 UINT8 Type;
775 UINT8 Length;
776 UINT32 ProximityDomain;
777 UINT16 Reserved1;
778 UINT32 AddressBaseLow;
779 UINT32 AddressBaseHigh;
780 UINT32 LengthLow;
781 UINT32 LengthHigh;
782 UINT32 Reserved2;
783 UINT32 Flags;
784 UINT64 Reserved3;
785} EFI_ACPI_6_2_MEMORY_AFFINITY_STRUCTURE;
786
787//
788// Memory Flags. All other bits are reserved and must be 0.
789//
790#define EFI_ACPI_6_2_MEMORY_ENABLED (1 << 0)
791#define EFI_ACPI_6_2_MEMORY_HOT_PLUGGABLE (1 << 1)
792#define EFI_ACPI_6_2_MEMORY_NONVOLATILE (1 << 2)
793
794///
795/// Processor Local x2APIC Affinity Structure Definition
796///
797typedef struct {
798 UINT8 Type;
799 UINT8 Length;
800 UINT8 Reserved1[2];
801 UINT32 ProximityDomain;
802 UINT32 X2ApicId;
803 UINT32 Flags;
804 UINT32 ClockDomain;
805 UINT8 Reserved2[4];
806} EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;
807
808///
809/// GICC Affinity Structure Definition
810///
811typedef struct {
812 UINT8 Type;
813 UINT8 Length;
814 UINT32 ProximityDomain;
815 UINT32 AcpiProcessorUid;
816 UINT32 Flags;
817 UINT32 ClockDomain;
818} EFI_ACPI_6_2_GICC_AFFINITY_STRUCTURE;
819
820///
821/// GICC Flags. All other bits are reserved and must be 0.
822///
823#define EFI_ACPI_6_2_GICC_ENABLED (1 << 0)
824
825///
826/// GIC Interrupt Translation Service (ITS) Affinity Structure Definition
827///
828typedef struct {
829 UINT8 Type;
830 UINT8 Length;
831 UINT32 ProximityDomain;
832 UINT8 Reserved[2];
833 UINT32 ItsId;
834} EFI_ACPI_6_2_GIC_ITS_AFFINITY_STRUCTURE;
835
836///
837/// System Locality Distance Information Table (SLIT).
838/// The rest of the table is a matrix.
839///
840typedef struct {
841 EFI_ACPI_DESCRIPTION_HEADER Header;
842 UINT64 NumberOfSystemLocalities;
843} EFI_ACPI_6_2_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;
844
845///
846/// SLIT Version (as defined in ACPI 6.2 spec.)
847///
848#define EFI_ACPI_6_2_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION 0x01
849
850///
851/// Corrected Platform Error Polling Table (CPEP)
852///
853typedef struct {
854 EFI_ACPI_DESCRIPTION_HEADER Header;
855 UINT8 Reserved[8];
856} EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;
857
858///
859/// CPEP Version (as defined in ACPI 6.2 spec.)
860///
861#define EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01
862
863//
864// CPEP processor structure types.
865//
866#define EFI_ACPI_6_2_CPEP_PROCESSOR_APIC_SAPIC 0x00
867
868///
869/// Corrected Platform Error Polling Processor Structure Definition
870///
871typedef struct {
872 UINT8 Type;
873 UINT8 Length;
874 UINT8 ProcessorId;
875 UINT8 ProcessorEid;
876 UINT32 PollingInterval;
877} EFI_ACPI_6_2_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;
878
879///
880/// Maximum System Characteristics Table (MSCT)
881///
882typedef struct {
883 EFI_ACPI_DESCRIPTION_HEADER Header;
884 UINT32 OffsetProxDomInfo;
885 UINT32 MaximumNumberOfProximityDomains;
886 UINT32 MaximumNumberOfClockDomains;
887 UINT64 MaximumPhysicalAddress;
888} EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;
889
890///
891/// MSCT Version (as defined in ACPI 6.2 spec.)
892///
893#define EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01
894
895///
896/// Maximum Proximity Domain Information Structure Definition
897///
898typedef struct {
899 UINT8 Revision;
900 UINT8 Length;
901 UINT32 ProximityDomainRangeLow;
902 UINT32 ProximityDomainRangeHigh;
903 UINT32 MaximumProcessorCapacity;
904 UINT64 MaximumMemoryCapacity;
905} EFI_ACPI_6_2_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;
906
907///
908/// ACPI RAS Feature Table definition.
909///
910typedef struct {
911 EFI_ACPI_DESCRIPTION_HEADER Header;
912 UINT8 PlatformCommunicationChannelIdentifier[12];
913} EFI_ACPI_6_2_RAS_FEATURE_TABLE;
914
915///
916/// RASF Version (as defined in ACPI 6.2 spec.)
917///
918#define EFI_ACPI_6_2_RAS_FEATURE_TABLE_REVISION 0x01
919
920///
921/// ACPI RASF Platform Communication Channel Shared Memory Region definition.
922///
923typedef struct {
924 UINT32 Signature;
925 UINT16 Command;
926 UINT16 Status;
927 UINT16 Version;
928 UINT8 RASCapabilities[16];
929 UINT8 SetRASCapabilities[16];
930 UINT16 NumberOfRASFParameterBlocks;
931 UINT32 SetRASCapabilitiesStatus;
932} EFI_ACPI_6_2_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;
933
934///
935/// ACPI RASF PCC command code
936///
937#define EFI_ACPI_6_2_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND 0x01
938
939///
940/// ACPI RASF Platform RAS Capabilities
941///
942#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED BIT0
943#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED_AND_EXPOSED_TO_SOFTWARE BIT1
944#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT2
945#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT3
946#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING BIT4
947
948///
949/// ACPI RASF Parameter Block structure for PATROL_SCRUB
950///
951typedef struct {
952 UINT16 Type;
953 UINT16 Version;
954 UINT16 Length;
955 UINT16 PatrolScrubCommand;
956 UINT64 RequestedAddressRange[2];
957 UINT64 ActualAddressRange[2];
958 UINT16 Flags;
959 UINT8 RequestedSpeed;
960} EFI_ACPI_6_2_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;
961
962///
963/// ACPI RASF Patrol Scrub command
964///
965#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS 0x01
966#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER 0x02
967#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER 0x03
968
969///
970/// Memory Power State Table definition.
971///
972typedef struct {
973 EFI_ACPI_DESCRIPTION_HEADER Header;
974 UINT8 PlatformCommunicationChannelIdentifier;
975 UINT8 Reserved[3];
976 // Memory Power Node Structure
977 // Memory Power State Characteristics
978} EFI_ACPI_6_2_MEMORY_POWER_STATUS_TABLE;
979
980///
981/// MPST Version (as defined in ACPI 6.2 spec.)
982///
983#define EFI_ACPI_6_2_MEMORY_POWER_STATE_TABLE_REVISION 0x01
984
985///
986/// MPST Platform Communication Channel Shared Memory Region definition.
987///
988typedef struct {
989 UINT32 Signature;
990 UINT16 Command;
991 UINT16 Status;
992 UINT32 MemoryPowerCommandRegister;
993 UINT32 MemoryPowerStatusRegister;
994 UINT32 PowerStateId;
995 UINT32 MemoryPowerNodeId;
996 UINT64 MemoryEnergyConsumed;
997 UINT64 ExpectedAveragePowerComsuned;
998} EFI_ACPI_6_2_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;
999
1000///
1001/// ACPI MPST PCC command code
1002///
1003#define EFI_ACPI_6_2_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND 0x03
1004
1005///
1006/// ACPI MPST Memory Power command
1007///
1008#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE 0x01
1009#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE 0x02
1010#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED 0x03
1011#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED 0x04
1012
1013///
1014/// MPST Memory Power Node Table
1015///
1016typedef struct {
1017 UINT8 PowerStateValue;
1018 UINT8 PowerStateInformationIndex;
1019} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE;
1020
1021typedef struct {
1022 UINT8 Flag;
1023 UINT8 Reserved;
1024 UINT16 MemoryPowerNodeId;
1025 UINT32 Length;
1026 UINT64 AddressBase;
1027 UINT64 AddressLength;
1028 UINT32 NumberOfPowerStates;
1029 UINT32 NumberOfPhysicalComponents;
1030 // EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE MemoryPowerState[NumberOfPowerStates];
1031 // UINT16 PhysicalComponentIdentifier[NumberOfPhysicalComponents];
1032} EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE;
1033
1034#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE 0x01
1035#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED 0x02
1036#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE 0x04
1037
1038typedef struct {
1039 UINT16 MemoryPowerNodeCount;
1040 UINT8 Reserved[2];
1041} EFI_ACPI_6_2_MPST_MEMORY_POWER_NODE_TABLE;
1042
1043///
1044/// MPST Memory Power State Characteristics Table
1045///
1046typedef struct {
1047 UINT8 PowerStateStructureID;
1048 UINT8 Flag;
1049 UINT16 Reserved;
1050 UINT32 AveragePowerConsumedInMPS0;
1051 UINT32 RelativePowerSavingToMPS0;
1052 UINT64 ExitLatencyToMPS0;
1053} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;
1054
1055#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED 0x01
1056#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY 0x02
1057#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT 0x04
1058
1059typedef struct {
1060 UINT16 MemoryPowerStateCharacteristicsCount;
1061 UINT8 Reserved[2];
1062} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;
1063
1064///
1065/// Memory Topology Table definition.
1066///
1067typedef struct {
1068 EFI_ACPI_DESCRIPTION_HEADER Header;
1069 UINT32 Reserved;
1070} EFI_ACPI_6_2_MEMORY_TOPOLOGY_TABLE;
1071
1072///
1073/// PMTT Version (as defined in ACPI 6.2 spec.)
1074///
1075#define EFI_ACPI_6_2_MEMORY_TOPOLOGY_TABLE_REVISION 0x01
1076
1077///
1078/// Common Memory Aggregator Device Structure.
1079///
1080typedef struct {
1081 UINT8 Type;
1082 UINT8 Reserved;
1083 UINT16 Length;
1084 UINT16 Flags;
1085 UINT16 Reserved1;
1086} EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1087
1088///
1089/// Memory Aggregator Device Type
1090///
1091#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET 0x0
1092#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x1
1093#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM 0x2
1094
1095///
1096/// Socket Memory Aggregator Device Structure.
1097///
1098typedef struct {
1099 EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1100 UINT16 SocketIdentifier;
1101 UINT16 Reserved;
1102 // EFI_ACPI_6_2_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE MemoryController[];
1103} EFI_ACPI_6_2_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1104
1105///
1106/// MemoryController Memory Aggregator Device Structure.
1107///
1108typedef struct {
1109 EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1110 UINT32 ReadLatency;
1111 UINT32 WriteLatency;
1112 UINT32 ReadBandwidth;
1113 UINT32 WriteBandwidth;
1114 UINT16 OptimalAccessUnit;
1115 UINT16 OptimalAccessAlignment;
1116 UINT16 Reserved;
1117 UINT16 NumberOfProximityDomains;
1118 // UINT32 ProximityDomain[NumberOfProximityDomains];
1119 // EFI_ACPI_6_2_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE PhysicalComponent[];
1120} EFI_ACPI_6_2_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1121
1122///
1123/// DIMM Memory Aggregator Device Structure.
1124///
1125typedef struct {
1126 EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1127 UINT16 PhysicalComponentIdentifier;
1128 UINT16 Reserved;
1129 UINT32 SizeOfDimm;
1130 UINT32 SmbiosHandle;
1131} EFI_ACPI_6_2_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1132
1133///
1134/// Boot Graphics Resource Table definition.
1135///
1136typedef struct {
1137 EFI_ACPI_DESCRIPTION_HEADER Header;
1138 ///
1139 /// 2-bytes (16 bit) version ID. This value must be 1.
1140 ///
1141 UINT16 Version;
1142 ///
1143 /// 1-byte status field indicating current status about the table.
1144 /// Bits[7:1] = Reserved (must be zero)
1145 /// Bit [0] = Valid. A one indicates the boot image graphic is valid.
1146 ///
1147 UINT8 Status;
1148 ///
1149 /// 1-byte enumerated type field indicating format of the image.
1150 /// 0 = Bitmap
1151 /// 1 - 255 Reserved (for future use)
1152 ///
1153 UINT8 ImageType;
1154 ///
1155 /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy
1156 /// of the image bitmap.
1157 ///
1158 UINT64 ImageAddress;
1159 ///
1160 /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.
1161 /// (X, Y) display offset of the top left corner of the boot image.
1162 /// The top left corner of the display is at offset (0, 0).
1163 ///
1164 UINT32 ImageOffsetX;
1165 ///
1166 /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.
1167 /// (X, Y) display offset of the top left corner of the boot image.
1168 /// The top left corner of the display is at offset (0, 0).
1169 ///
1170 UINT32 ImageOffsetY;
1171} EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE;
1172
1173///
1174/// BGRT Revision
1175///
1176#define EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1
1177
1178///
1179/// BGRT Version
1180///
1181#define EFI_ACPI_6_2_BGRT_VERSION 0x01
1182
1183///
1184/// BGRT Status
1185///
1186#define EFI_ACPI_6_2_BGRT_STATUS_NOT_DISPLAYED 0x00
1187#define EFI_ACPI_6_2_BGRT_STATUS_DISPLAYED 0x01
1188
1189///
1190/// BGRT Image Type
1191///
1192#define EFI_ACPI_6_2_BGRT_IMAGE_TYPE_BMP 0x00
1193
1194///
1195/// FPDT Version (as defined in ACPI 6.2 spec.)
1196///
1197#define EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01
1198
1199///
1200/// FPDT Performance Record Types
1201///
1202#define EFI_ACPI_6_2_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER 0x0000
1203#define EFI_ACPI_6_2_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER 0x0001
1204
1205///
1206/// FPDT Performance Record Revision
1207///
1208#define EFI_ACPI_6_2_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER 0x01
1209#define EFI_ACPI_6_2_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01
1210
1211///
1212/// FPDT Runtime Performance Record Types
1213///
1214#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME 0x0000
1215#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND 0x0001
1216#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT 0x0002
1217
1218///
1219/// FPDT Runtime Performance Record Revision
1220///
1221#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME 0x01
1222#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND 0x01
1223#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT 0x02
1224
1225///
1226/// FPDT Performance Record header
1227///
1228typedef struct {
1229 UINT16 Type;
1230 UINT8 Length;
1231 UINT8 Revision;
1232} EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER;
1233
1234///
1235/// FPDT Performance Table header
1236///
1237typedef struct {
1238 UINT32 Signature;
1239 UINT32 Length;
1240} EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER;
1241
1242///
1243/// FPDT Firmware Basic Boot Performance Pointer Record Structure
1244///
1245typedef struct {
1246 EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER Header;
1247 UINT32 Reserved;
1248 ///
1249 /// 64-bit processor-relative physical address of the Basic Boot Performance Table.
1250 ///
1251 UINT64 BootPerformanceTablePointer;
1252} EFI_ACPI_6_2_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;
1253
1254///
1255/// FPDT S3 Performance Table Pointer Record Structure
1256///
1257typedef struct {
1258 EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER Header;
1259 UINT32 Reserved;
1260 ///
1261 /// 64-bit processor-relative physical address of the S3 Performance Table.
1262 ///
1263 UINT64 S3PerformanceTablePointer;
1264} EFI_ACPI_6_2_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;
1265
1266///
1267/// FPDT Firmware Basic Boot Performance Record Structure
1268///
1269typedef struct {
1270 EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER Header;
1271 UINT32 Reserved;
1272 ///
1273 /// Timer value logged at the beginning of firmware image execution.
1274 /// This may not always be zero or near zero.
1275 ///
1276 UINT64 ResetEnd;
1277 ///
1278 /// Timer value logged just prior to loading the OS boot loader into memory.
1279 /// For non-UEFI compatible boots, this field must be zero.
1280 ///
1281 UINT64 OsLoaderLoadImageStart;
1282 ///
1283 /// Timer value logged just prior to launching the previously loaded OS boot loader image.
1284 /// For non-UEFI compatible boots, the timer value logged will be just prior
1285 /// to the INT 19h handler invocation.
1286 ///
1287 UINT64 OsLoaderStartImageStart;
1288 ///
1289 /// Timer value logged at the point when the OS loader calls the
1290 /// ExitBootServices function for UEFI compatible firmware.
1291 /// For non-UEFI compatible boots, this field must be zero.
1292 ///
1293 UINT64 ExitBootServicesEntry;
1294 ///
1295 /// Timer value logged at the point just prior to when the OS loader gaining
1296 /// control back from calls the ExitBootServices function for UEFI compatible firmware.
1297 /// For non-UEFI compatible boots, this field must be zero.
1298 ///
1299 UINT64 ExitBootServicesExit;
1300} EFI_ACPI_6_2_FPDT_FIRMWARE_BASIC_BOOT_RECORD;
1301
1302///
1303/// FPDT Firmware Basic Boot Performance Table signature
1304///
1305#define EFI_ACPI_6_2_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE SIGNATURE_32('F', 'B', 'P', 'T')
1306
1307//
1308// FPDT Firmware Basic Boot Performance Table
1309//
1310typedef struct {
1311 EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER Header;
1312 //
1313 // one or more Performance Records.
1314 //
1315} EFI_ACPI_6_2_FPDT_FIRMWARE_BASIC_BOOT_TABLE;
1316
1317///
1318/// FPDT "S3PT" S3 Performance Table
1319///
1320#define EFI_ACPI_6_2_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE SIGNATURE_32('S', '3', 'P', 'T')
1321
1322//
1323// FPDT Firmware S3 Boot Performance Table
1324//
1325typedef struct {
1326 EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER Header;
1327 //
1328 // one or more Performance Records.
1329 //
1330} EFI_ACPI_6_2_FPDT_FIRMWARE_S3_BOOT_TABLE;
1331
1332///
1333/// FPDT Basic S3 Resume Performance Record
1334///
1335typedef struct {
1336 EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER Header;
1337 ///
1338 /// A count of the number of S3 resume cycles since the last full boot sequence.
1339 ///
1340 UINT32 ResumeCount;
1341 ///
1342 /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the
1343 /// OS waking vector. Only the most recent resume cycle's time is retained.
1344 ///
1345 UINT64 FullResume;
1346 ///
1347 /// Average timer value of all resume cycles logged since the last full boot
1348 /// sequence, including the most recent resume. Note that the entire log of
1349 /// timer values does not need to be retained in order to calculate this average.
1350 ///
1351 UINT64 AverageResume;
1352} EFI_ACPI_6_2_FPDT_S3_RESUME_RECORD;
1353
1354///
1355/// FPDT Basic S3 Suspend Performance Record
1356///
1357typedef struct {
1358 EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER Header;
1359 ///
1360 /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.
1361 /// Only the most recent suspend cycle's timer value is retained.
1362 ///
1363 UINT64 SuspendStart;
1364 ///
1365 /// Timer value recorded at the final firmware write to SLP_TYP (or other
1366 /// mechanism) used to trigger hardware entry to S3.
1367 /// Only the most recent suspend cycle's timer value is retained.
1368 ///
1369 UINT64 SuspendEnd;
1370} EFI_ACPI_6_2_FPDT_S3_SUSPEND_RECORD;
1371
1372///
1373/// Firmware Performance Record Table definition.
1374///
1375typedef struct {
1376 EFI_ACPI_DESCRIPTION_HEADER Header;
1377} EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_RECORD_TABLE;
1378
1379///
1380/// Generic Timer Description Table definition.
1381///
1382typedef struct {
1383 EFI_ACPI_DESCRIPTION_HEADER Header;
1384 UINT64 CntControlBasePhysicalAddress;
1385 UINT32 Reserved;
1386 UINT32 SecurePL1TimerGSIV;
1387 UINT32 SecurePL1TimerFlags;
1388 UINT32 NonSecurePL1TimerGSIV;
1389 UINT32 NonSecurePL1TimerFlags;
1390 UINT32 VirtualTimerGSIV;
1391 UINT32 VirtualTimerFlags;
1392 UINT32 NonSecurePL2TimerGSIV;
1393 UINT32 NonSecurePL2TimerFlags;
1394 UINT64 CntReadBasePhysicalAddress;
1395 UINT32 PlatformTimerCount;
1396 UINT32 PlatformTimerOffset;
1397} EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE;
1398
1399///
1400/// GTDT Version (as defined in ACPI 6.2 spec.)
1401///
1402#define EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x02
1403
1404///
1405/// Timer Flags. All other bits are reserved and must be 0.
1406///
1407#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE BIT0
1408#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1409#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY BIT2
1410
1411///
1412/// Platform Timer Type
1413///
1414#define EFI_ACPI_6_2_GTDT_GT_BLOCK 0
1415#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG 1
1416
1417///
1418/// GT Block Structure
1419///
1420typedef struct {
1421 UINT8 Type;
1422 UINT16 Length;
1423 UINT8 Reserved;
1424 UINT64 CntCtlBase;
1425 UINT32 GTBlockTimerCount;
1426 UINT32 GTBlockTimerOffset;
1427} EFI_ACPI_6_2_GTDT_GT_BLOCK_STRUCTURE;
1428
1429///
1430/// GT Block Timer Structure
1431///
1432typedef struct {
1433 UINT8 GTFrameNumber;
1434 UINT8 Reserved[3];
1435 UINT64 CntBaseX;
1436 UINT64 CntEL0BaseX;
1437 UINT32 GTxPhysicalTimerGSIV;
1438 UINT32 GTxPhysicalTimerFlags;
1439 UINT32 GTxVirtualTimerGSIV;
1440 UINT32 GTxVirtualTimerFlags;
1441 UINT32 GTxCommonFlags;
1442} EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_STRUCTURE;
1443
1444///
1445/// GT Block Physical Timers and Virtual Timers Flags. All other bits are reserved and must be 0.
1446///
1447#define EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE BIT0
1448#define EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1449
1450///
1451/// Common Flags Flags. All other bits are reserved and must be 0.
1452///
1453#define EFI_ACPI_6_2_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER BIT0
1454#define EFI_ACPI_6_2_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY BIT1
1455
1456///
1457/// SBSA Generic Watchdog Structure
1458///
1459typedef struct {
1460 UINT8 Type;
1461 UINT16 Length;
1462 UINT8 Reserved;
1463 UINT64 RefreshFramePhysicalAddress;
1464 UINT64 WatchdogControlFramePhysicalAddress;
1465 UINT32 WatchdogTimerGSIV;
1466 UINT32 WatchdogTimerFlags;
1467} EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;
1468
1469///
1470/// SBSA Generic Watchdog Timer Flags. All other bits are reserved and must be 0.
1471///
1472#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE BIT0
1473#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1474#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER BIT2
1475
1476//
1477// NVDIMM Firmware Interface Table definition.
1478//
1479typedef struct {
1480 EFI_ACPI_DESCRIPTION_HEADER Header;
1481 UINT32 Reserved;
1482} EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE;
1483
1484//
1485// NFIT Version (as defined in ACPI 6.2 spec.)
1486//
1487#define EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1
1488
1489//
1490// Definition for NFIT Table Structure Types
1491//
1492#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE 0
1493#define EFI_ACPI_6_2_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE_TYPE 1
1494#define EFI_ACPI_6_2_NFIT_INTERLEAVE_STRUCTURE_TYPE 2
1495#define EFI_ACPI_6_2_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE 3
1496#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE 4
1497#define EFI_ACPI_6_2_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE 5
1498#define EFI_ACPI_6_2_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE 6
1499#define EFI_ACPI_6_2_NFIT_PLATFORM_CAPABILITIES_STRUCTURE_TYPE 7
1500
1501//
1502// Definition for NFIT Structure Header
1503//
1504typedef struct {
1505 UINT16 Type;
1506 UINT16 Length;
1507} EFI_ACPI_6_2_NFIT_STRUCTURE_HEADER;
1508
1509//
1510// Definition for System Physical Address Range Structure
1511//
1512#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT BIT0
1513#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID BIT1
1514#define EFI_ACPI_6_2_NFIT_GUID_VOLATILE_MEMORY_REGION { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}
1515#define EFI_ACPI_6_2_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}
1516#define EFI_ACPI_6_2_NFIT_GUID_NVDIMM_CONTROL_REGION { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}
1517#define EFI_ACPI_6_2_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}
1518#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}
1519#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}
1520#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}
1521#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}
1522typedef struct {
1523 UINT16 Type;
1524 UINT16 Length;
1525 UINT16 SPARangeStructureIndex;
1526 UINT16 Flags;
1527 UINT32 Reserved_8;
1528 UINT32 ProximityDomain;
1529 GUID AddressRangeTypeGUID;
1530 UINT64 SystemPhysicalAddressRangeBase;
1531 UINT64 SystemPhysicalAddressRangeLength;
1532 UINT64 AddressRangeMemoryMappingAttribute;
1533} EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;
1534
1535//
1536// Definition for Memory Device to System Physical Address Range Mapping Structure
1537//
1538typedef struct {
1539 UINT32 DIMMNumber : 4;
1540 UINT32 MemoryChannelNumber : 4;
1541 UINT32 MemoryControllerID : 4;
1542 UINT32 SocketID : 4;
1543 UINT32 NodeControllerID : 12;
1544 UINT32 Reserved_28 : 4;
1545} EFI_ACPI_6_2_NFIT_DEVICE_HANDLE;
1546
1547#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL BIT0
1548#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL BIT1
1549#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL BIT2
1550#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF BIT3
1551#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF BIT4
1552#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS BIT5
1553#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_NOT_MAP_NVDIMM_TO_SPA BIT6
1554typedef struct {
1555 UINT16 Type;
1556 UINT16 Length;
1557 EFI_ACPI_6_2_NFIT_DEVICE_HANDLE NFITDeviceHandle;
1558 UINT16 NVDIMMPhysicalID;
1559 UINT16 NVDIMMRegionID;
1560 UINT16 SPARangeStructureIndex;
1561 UINT16 NVDIMMControlRegionStructureIndex;
1562 UINT64 NVDIMMRegionSize;
1563 UINT64 RegionOffset;
1564 UINT64 NVDIMMPhysicalAddressRegionBase;
1565 UINT16 InterleaveStructureIndex;
1566 UINT16 InterleaveWays;
1567 UINT16 NVDIMMStateFlags;
1568 UINT16 Reserved_46;
1569} EFI_ACPI_6_2_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE;
1570
1571//
1572// Definition for Interleave Structure
1573//
1574typedef struct {
1575 UINT16 Type;
1576 UINT16 Length;
1577 UINT16 InterleaveStructureIndex;
1578 UINT16 Reserved_6;
1579 UINT32 NumberOfLines;
1580 UINT32 LineSize;
1581 // UINT32 LineOffset[NumberOfLines];
1582} EFI_ACPI_6_2_NFIT_INTERLEAVE_STRUCTURE;
1583
1584//
1585// Definition for SMBIOS Management Information Structure
1586//
1587typedef struct {
1588 UINT16 Type;
1589 UINT16 Length;
1590 UINT32 Reserved_4;
1591 // UINT8 Data[];
1592} EFI_ACPI_6_2_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;
1593
1594//
1595// Definition for NVDIMM Control Region Structure
1596//
1597#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_VALID_FIELDS_MANUFACTURING BIT0
1598
1599#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED BIT0
1600typedef struct {
1601 UINT16 Type;
1602 UINT16 Length;
1603 UINT16 NVDIMMControlRegionStructureIndex;
1604 UINT16 VendorID;
1605 UINT16 DeviceID;
1606 UINT16 RevisionID;
1607 UINT16 SubsystemVendorID;
1608 UINT16 SubsystemDeviceID;
1609 UINT16 SubsystemRevisionID;
1610 UINT8 ValidFields;
1611 UINT8 ManufacturingLocation;
1612 UINT16 ManufacturingDate;
1613 UINT8 Reserved_22[2];
1614 UINT32 SerialNumber;
1615 UINT16 RegionFormatInterfaceCode;
1616 UINT16 NumberOfBlockControlWindows;
1617 UINT64 SizeOfBlockControlWindow;
1618 UINT64 CommandRegisterOffsetInBlockControlWindow;
1619 UINT64 SizeOfCommandRegisterInBlockControlWindows;
1620 UINT64 StatusRegisterOffsetInBlockControlWindow;
1621 UINT64 SizeOfStatusRegisterInBlockControlWindows;
1622 UINT16 NVDIMMControlRegionFlag;
1623 UINT8 Reserved_74[6];
1624} EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;
1625
1626//
1627// Definition for NVDIMM Block Data Window Region Structure
1628//
1629typedef struct {
1630 UINT16 Type;
1631 UINT16 Length;
1632 UINT16 NVDIMMControlRegionStructureIndex;
1633 UINT16 NumberOfBlockDataWindows;
1634 UINT64 BlockDataWindowStartOffset;
1635 UINT64 SizeOfBlockDataWindow;
1636 UINT64 BlockAccessibleMemoryCapacity;
1637 UINT64 BeginningAddressOfFirstBlockInBlockAccessibleMemory;
1638} EFI_ACPI_6_2_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;
1639
1640//
1641// Definition for Flush Hint Address Structure
1642//
1643typedef struct {
1644 UINT16 Type;
1645 UINT16 Length;
1646 EFI_ACPI_6_2_NFIT_DEVICE_HANDLE NFITDeviceHandle;
1647 UINT16 NumberOfFlushHintAddresses;
1648 UINT8 Reserved_10[6];
1649 // UINT64 FlushHintAddress[NumberOfFlushHintAddresses];
1650} EFI_ACPI_6_2_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;
1651
1652//
1653// Definition for Platform Capabilities Structure
1654//
1655typedef struct {
1656 UINT16 Type;
1657 UINT16 Length;
1658 UINT8 HighestValidCapability;
1659 UINT8 Reserved_5[3];
1660 UINT32 Capabilities;
1661 UINT8 Reserved_12[4];
1662} EFI_ACPI_6_2_NFIT_PLATFORM_CAPABILITIES_STRUCTURE;
1663
1664#define EFI_ACPI_6_2_NFIT_PLATFORM_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT0
1665#define EFI_ACPI_6_2_NFIT_PLATFORM_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT1
1666#define EFI_ACPI_6_2_NFIT_PLATFORM_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING BIT2
1667
1668///
1669/// Secure DEVices Table (SDEV)
1670///
1671typedef struct {
1672 EFI_ACPI_DESCRIPTION_HEADER Header;
1673} EFI_ACPI_6_2_SECURE_DEVICES_TABLE_HEADER;
1674
1675///
1676/// SDEV Revision (as defined in ACPI 6.2 spec.)
1677///
1678#define EFI_ACPI_6_2_SECURE_DEVICES_TABLE_REVISION 0x01
1679
1680///
1681/// Secure Device types
1682///
1683#define EFI_ACPI_6_2_SDEV_TYPE_PCIE_ENDPOINT_DEVICE 0x01
1684#define EFI_ACPI_6_2_SDEV_TYPE_ACPI_NAMESPACE_DEVICE 0x00
1685
1686///
1687/// Secure Device flags
1688///
1689#define EFI_ACPI_6_2_SDEV_FLAG_ALLOW_HANDOFF BIT0
1690
1691///
1692/// SDEV Structure Header
1693///
1694typedef struct {
1695 UINT8 Type;
1696 UINT8 Flags;
1697 UINT16 Length;
1698} EFI_ACPI_6_2_SDEV_STRUCTURE_HEADER;
1699
1700///
1701/// PCIe Endpoint Device based Secure Device Structure
1702///
1703typedef struct {
1704 UINT8 Type;
1705 UINT8 Flags;
1706 UINT16 Length;
1707 UINT16 PciSegmentNumber;
1708 UINT16 StartBusNumber;
1709 UINT16 PciPathOffset;
1710 UINT16 PciPathLength;
1711 UINT16 VendorSpecificDataOffset;
1712 UINT16 VendorSpecificDataLength;
1713} EFI_ACPI_6_2_SDEV_STRUCTURE_PCIE_ENDPOINT_DEVICE;
1714
1715///
1716/// ACPI_NAMESPACE_DEVICE based Secure Device Structure
1717///
1718typedef struct {
1719 UINT8 Type;
1720 UINT8 Flags;
1721 UINT16 Length;
1722 UINT16 DeviceIdentifierOffset;
1723 UINT16 DeviceIdentifierLength;
1724 UINT16 VendorSpecificDataOffset;
1725 UINT16 VendorSpecificDataLength;
1726} EFI_ACPI_6_2_SDEV_STRUCTURE_ACPI_NAMESPACE_DEVICE;
1727
1728///
1729/// Boot Error Record Table (BERT)
1730///
1731typedef struct {
1732 EFI_ACPI_DESCRIPTION_HEADER Header;
1733 UINT32 BootErrorRegionLength;
1734 UINT64 BootErrorRegion;
1735} EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_HEADER;
1736
1737///
1738/// BERT Version (as defined in ACPI 6.2 spec.)
1739///
1740#define EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_REVISION 0x01
1741
1742///
1743/// Boot Error Region Block Status Definition
1744///
1745typedef struct {
1746 UINT32 UncorrectableErrorValid : 1;
1747 UINT32 CorrectableErrorValid : 1;
1748 UINT32 MultipleUncorrectableErrors : 1;
1749 UINT32 MultipleCorrectableErrors : 1;
1750 UINT32 ErrorDataEntryCount : 10;
1751 UINT32 Reserved : 18;
1752} EFI_ACPI_6_2_ERROR_BLOCK_STATUS;
1753
1754///
1755/// Boot Error Region Definition
1756///
1757typedef struct {
1758 EFI_ACPI_6_2_ERROR_BLOCK_STATUS BlockStatus;
1759 UINT32 RawDataOffset;
1760 UINT32 RawDataLength;
1761 UINT32 DataLength;
1762 UINT32 ErrorSeverity;
1763} EFI_ACPI_6_2_BOOT_ERROR_REGION_STRUCTURE;
1764
1765//
1766// Boot Error Severity types
1767//
1768#define EFI_ACPI_6_2_ERROR_SEVERITY_RECOVERABLE 0x00
1769#define EFI_ACPI_6_2_ERROR_SEVERITY_FATAL 0x01
1770#define EFI_ACPI_6_2_ERROR_SEVERITY_CORRECTED 0x02
1771#define EFI_ACPI_6_2_ERROR_SEVERITY_NONE 0x03
1772//
1773// The term 'Correctable' is no longer being used as an error severity of the
1774// reported error since ACPI Specification Version 5.1 Errata B.
1775// The below macro is considered as deprecated and should no longer be used.
1776//
1777#define EFI_ACPI_6_2_ERROR_SEVERITY_CORRECTABLE 0x00
1778
1779///
1780/// Generic Error Data Entry Definition
1781///
1782typedef struct {
1783 UINT8 SectionType[16];
1784 UINT32 ErrorSeverity;
1785 UINT16 Revision;
1786 UINT8 ValidationBits;
1787 UINT8 Flags;
1788 UINT32 ErrorDataLength;
1789 UINT8 FruId[16];
1790 UINT8 FruText[20];
1791 UINT8 Timestamp[8];
1792} EFI_ACPI_6_2_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;
1793
1794///
1795/// Generic Error Data Entry Version (as defined in ACPI 6.2 spec.)
1796///
1797#define EFI_ACPI_6_2_GENERIC_ERROR_DATA_ENTRY_REVISION 0x0300
1798
1799///
1800/// HEST - Hardware Error Source Table
1801///
1802typedef struct {
1803 EFI_ACPI_DESCRIPTION_HEADER Header;
1804 UINT32 ErrorSourceCount;
1805} EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_HEADER;
1806
1807///
1808/// HEST Version (as defined in ACPI 6.2 spec.)
1809///
1810#define EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01
1811
1812//
1813// Error Source structure types.
1814//
1815#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION 0x00
1816#define EFI_ACPI_6_2_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK 0x01
1817#define EFI_ACPI_6_2_IA32_ARCHITECTURE_NMI_ERROR 0x02
1818#define EFI_ACPI_6_2_PCI_EXPRESS_ROOT_PORT_AER 0x06
1819#define EFI_ACPI_6_2_PCI_EXPRESS_DEVICE_AER 0x07
1820#define EFI_ACPI_6_2_PCI_EXPRESS_BRIDGE_AER 0x08
1821#define EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR 0x09
1822#define EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_VERSION_2 0x0A
1823#define EFI_ACPI_6_2_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK 0x0B
1824
1825//
1826// Error Source structure flags.
1827//
1828#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_FIRMWARE_FIRST (1 << 0)
1829#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_GLOBAL (1 << 1)
1830#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_GHES_ASSIST (1 << 2)
1831
1832///
1833/// IA-32 Architecture Machine Check Exception Structure Definition
1834///
1835typedef struct {
1836 UINT16 Type;
1837 UINT16 SourceId;
1838 UINT8 Reserved0[2];
1839 UINT8 Flags;
1840 UINT8 Enabled;
1841 UINT32 NumberOfRecordsToPreAllocate;
1842 UINT32 MaxSectionsPerRecord;
1843 UINT64 GlobalCapabilityInitData;
1844 UINT64 GlobalControlInitData;
1845 UINT8 NumberOfHardwareBanks;
1846 UINT8 Reserved1[7];
1847} EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;
1848
1849///
1850/// IA-32 Architecture Machine Check Bank Structure Definition
1851///
1852typedef struct {
1853 UINT8 BankNumber;
1854 UINT8 ClearStatusOnInitialization;
1855 UINT8 StatusDataFormat;
1856 UINT8 Reserved0;
1857 UINT32 ControlRegisterMsrAddress;
1858 UINT64 ControlInitData;
1859 UINT32 StatusRegisterMsrAddress;
1860 UINT32 AddressRegisterMsrAddress;
1861 UINT32 MiscRegisterMsrAddress;
1862} EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;
1863
1864///
1865/// IA-32 Architecture Machine Check Bank Structure MCA data format
1866///
1867#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32 0x00
1868#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64 0x01
1869#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64 0x02
1870
1871//
1872// Hardware Error Notification types. All other values are reserved
1873//
1874#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_POLLED 0x00
1875#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT 0x01
1876#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT 0x02
1877#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_SCI 0x03
1878#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_NMI 0x04
1879#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CMCI 0x05
1880#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_MCE 0x06
1881#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL 0x07
1882#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEA 0x08
1883#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEI 0x09
1884#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_GSIV 0x0A
1885#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_SOFTWARE_DELEGATED_EXCEPTION 0x0B
1886
1887///
1888/// Hardware Error Notification Configuration Write Enable Structure Definition
1889///
1890typedef struct {
1891 UINT16 Type : 1;
1892 UINT16 PollInterval : 1;
1893 UINT16 SwitchToPollingThresholdValue : 1;
1894 UINT16 SwitchToPollingThresholdWindow : 1;
1895 UINT16 ErrorThresholdValue : 1;
1896 UINT16 ErrorThresholdWindow : 1;
1897 UINT16 Reserved : 10;
1898} EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;
1899
1900///
1901/// Hardware Error Notification Structure Definition
1902///
1903typedef struct {
1904 UINT8 Type;
1905 UINT8 Length;
1906 EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE ConfigurationWriteEnable;
1907 UINT32 PollInterval;
1908 UINT32 Vector;
1909 UINT32 SwitchToPollingThresholdValue;
1910 UINT32 SwitchToPollingThresholdWindow;
1911 UINT32 ErrorThresholdValue;
1912 UINT32 ErrorThresholdWindow;
1913} EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;
1914
1915///
1916/// IA-32 Architecture Corrected Machine Check Structure Definition
1917///
1918typedef struct {
1919 UINT16 Type;
1920 UINT16 SourceId;
1921 UINT8 Reserved0[2];
1922 UINT8 Flags;
1923 UINT8 Enabled;
1924 UINT32 NumberOfRecordsToPreAllocate;
1925 UINT32 MaxSectionsPerRecord;
1926 EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
1927 UINT8 NumberOfHardwareBanks;
1928 UINT8 Reserved1[3];
1929} EFI_ACPI_6_2_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;
1930
1931///
1932/// IA-32 Architecture NMI Error Structure Definition
1933///
1934typedef struct {
1935 UINT16 Type;
1936 UINT16 SourceId;
1937 UINT8 Reserved0[2];
1938 UINT32 NumberOfRecordsToPreAllocate;
1939 UINT32 MaxSectionsPerRecord;
1940 UINT32 MaxRawDataLength;
1941} EFI_ACPI_6_2_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;
1942
1943///
1944/// PCI Express Root Port AER Structure Definition
1945///
1946typedef struct {
1947 UINT16 Type;
1948 UINT16 SourceId;
1949 UINT8 Reserved0[2];
1950 UINT8 Flags;
1951 UINT8 Enabled;
1952 UINT32 NumberOfRecordsToPreAllocate;
1953 UINT32 MaxSectionsPerRecord;
1954 UINT32 Bus;
1955 UINT16 Device;
1956 UINT16 Function;
1957 UINT16 DeviceControl;
1958 UINT8 Reserved1[2];
1959 UINT32 UncorrectableErrorMask;
1960 UINT32 UncorrectableErrorSeverity;
1961 UINT32 CorrectableErrorMask;
1962 UINT32 AdvancedErrorCapabilitiesAndControl;
1963 UINT32 RootErrorCommand;
1964} EFI_ACPI_6_2_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;
1965
1966///
1967/// PCI Express Device AER Structure Definition
1968///
1969typedef struct {
1970 UINT16 Type;
1971 UINT16 SourceId;
1972 UINT8 Reserved0[2];
1973 UINT8 Flags;
1974 UINT8 Enabled;
1975 UINT32 NumberOfRecordsToPreAllocate;
1976 UINT32 MaxSectionsPerRecord;
1977 UINT32 Bus;
1978 UINT16 Device;
1979 UINT16 Function;
1980 UINT16 DeviceControl;
1981 UINT8 Reserved1[2];
1982 UINT32 UncorrectableErrorMask;
1983 UINT32 UncorrectableErrorSeverity;
1984 UINT32 CorrectableErrorMask;
1985 UINT32 AdvancedErrorCapabilitiesAndControl;
1986} EFI_ACPI_6_2_PCI_EXPRESS_DEVICE_AER_STRUCTURE;
1987
1988///
1989/// PCI Express Bridge AER Structure Definition
1990///
1991typedef struct {
1992 UINT16 Type;
1993 UINT16 SourceId;
1994 UINT8 Reserved0[2];
1995 UINT8 Flags;
1996 UINT8 Enabled;
1997 UINT32 NumberOfRecordsToPreAllocate;
1998 UINT32 MaxSectionsPerRecord;
1999 UINT32 Bus;
2000 UINT16 Device;
2001 UINT16 Function;
2002 UINT16 DeviceControl;
2003 UINT8 Reserved1[2];
2004 UINT32 UncorrectableErrorMask;
2005 UINT32 UncorrectableErrorSeverity;
2006 UINT32 CorrectableErrorMask;
2007 UINT32 AdvancedErrorCapabilitiesAndControl;
2008 UINT32 SecondaryUncorrectableErrorMask;
2009 UINT32 SecondaryUncorrectableErrorSeverity;
2010 UINT32 SecondaryAdvancedErrorCapabilitiesAndControl;
2011} EFI_ACPI_6_2_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;
2012
2013///
2014/// Generic Hardware Error Source Structure Definition
2015///
2016typedef struct {
2017 UINT16 Type;
2018 UINT16 SourceId;
2019 UINT16 RelatedSourceId;
2020 UINT8 Flags;
2021 UINT8 Enabled;
2022 UINT32 NumberOfRecordsToPreAllocate;
2023 UINT32 MaxSectionsPerRecord;
2024 UINT32 MaxRawDataLength;
2025 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE ErrorStatusAddress;
2026 EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
2027 UINT32 ErrorStatusBlockLength;
2028} EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;
2029
2030///
2031/// Generic Hardware Error Source Version 2 Structure Definition
2032///
2033typedef struct {
2034 UINT16 Type;
2035 UINT16 SourceId;
2036 UINT16 RelatedSourceId;
2037 UINT8 Flags;
2038 UINT8 Enabled;
2039 UINT32 NumberOfRecordsToPreAllocate;
2040 UINT32 MaxSectionsPerRecord;
2041 UINT32 MaxRawDataLength;
2042 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE ErrorStatusAddress;
2043 EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
2044 UINT32 ErrorStatusBlockLength;
2045 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE ReadAckRegister;
2046 UINT64 ReadAckPreserve;
2047 UINT64 ReadAckWrite;
2048} EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_SOURCE_VERSION_2_STRUCTURE;
2049
2050///
2051/// Generic Error Status Definition
2052///
2053typedef struct {
2054 EFI_ACPI_6_2_ERROR_BLOCK_STATUS BlockStatus;
2055 UINT32 RawDataOffset;
2056 UINT32 RawDataLength;
2057 UINT32 DataLength;
2058 UINT32 ErrorSeverity;
2059} EFI_ACPI_6_2_GENERIC_ERROR_STATUS_STRUCTURE;
2060
2061///
2062/// IA-32 Architecture Deferred Machine Check Structure Definition
2063///
2064typedef struct {
2065 UINT16 Type;
2066 UINT16 SourceId;
2067 UINT8 Reserved0[2];
2068 UINT8 Flags;
2069 UINT8 Enabled;
2070 UINT32 NumberOfRecordsToPreAllocate;
2071 UINT32 MaxSectionsPerRecord;
2072 EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
2073 UINT8 NumberOfHardwareBanks;
2074 UINT8 Reserved1[3];
2075} EFI_ACPI_6_2_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK_STRUCTURE;
2076
2077///
2078/// HMAT - Heterogeneous Memory Attribute Table
2079///
2080typedef struct {
2081 EFI_ACPI_DESCRIPTION_HEADER Header;
2082 UINT8 Reserved[4];
2083} EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_HEADER;
2084
2085///
2086/// HMAT Revision (as defined in ACPI 6.2 spec.)
2087///
2088#define EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_REVISION 0x01
2089
2090///
2091/// HMAT types
2092///
2093#define EFI_ACPI_6_2_HMAT_TYPE_MEMORY_SUBSYSTEM_ADDRESS_RANGE 0x00
2094#define EFI_ACPI_6_2_HMAT_TYPE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO 0x01
2095#define EFI_ACPI_6_2_HMAT_TYPE_MEMORY_SIDE_CACHE_INFO 0x02
2096
2097///
2098/// HMAT Structure Header
2099///
2100typedef struct {
2101 UINT16 Type;
2102 UINT8 Reserved[2];
2103 UINT32 Length;
2104} EFI_ACPI_6_2_HMAT_STRUCTURE_HEADER;
2105
2106///
2107/// Memory Subsystem Address Range Structure flags
2108///
2109typedef struct {
2110 UINT16 ProcessorProximityDomainValid : 1;
2111 UINT16 MemoryProximityDomainValid : 1;
2112 UINT16 ReservationHint : 1;
2113 UINT16 Reserved : 13;
2114} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE_FLAGS;
2115
2116///
2117/// Memory Subsystem Address Range Structure
2118///
2119typedef struct {
2120 UINT16 Type;
2121 UINT8 Reserved[2];
2122 UINT32 Length;
2123 EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE_FLAGS Flags;
2124 UINT8 Reserved1[2];
2125 UINT32 ProcessorProximityDomain;
2126 UINT32 MemoryProximityDomain;
2127 UINT8 Reserved2[4];
2128 UINT64 SystemPhysicalAddressRangeBase;
2129 UINT64 SystemPhysicalAddressRangeLength;
2130} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE;
2131
2132///
2133/// System Locality Latency and Bandwidth Information Structure flags
2134///
2135typedef struct {
2136 UINT8 MemoryHierarchy : 5;
2137 UINT8 Reserved : 3;
2138} EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS;
2139
2140///
2141/// System Locality Latency and Bandwidth Information Structure
2142///
2143typedef struct {
2144 UINT16 Type;
2145 UINT8 Reserved[2];
2146 UINT32 Length;
2147 EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS Flags;
2148 UINT8 DataType;
2149 UINT8 Reserved1[2];
2150 UINT32 NumberOfInitiatorProximityDomains;
2151 UINT32 NumberOfTargetProximityDomains;
2152 UINT8 Reserved2[4];
2153 UINT64 EntryBaseUnit;
2154} EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO;
2155
2156///
2157/// Memory Side Cache Information Structure cache attributes
2158///
2159typedef struct {
2160 UINT32 TotalCacheLevels : 4;
2161 UINT32 CacheLevel : 4;
2162 UINT32 CacheAssociativity : 4;
2163 UINT32 WritePolicy : 4;
2164 UINT32 CacheLineSize : 16;
2165} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES;
2166
2167///
2168/// Memory Side Cache Information Structure
2169///
2170typedef struct {
2171 UINT16 Type;
2172 UINT8 Reserved[2];
2173 UINT32 Length;
2174 UINT32 MemoryProximityDomain;
2175 UINT8 Reserved1[4];
2176 UINT64 MemorySideCacheSize;
2177 EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES CacheAttributes;
2178 UINT8 Reserved2[2];
2179 UINT16 NumberOfSmbiosHandles;
2180} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO;
2181
2182///
2183/// ERST - Error Record Serialization Table
2184///
2185typedef struct {
2186 EFI_ACPI_DESCRIPTION_HEADER Header;
2187 UINT32 SerializationHeaderSize;
2188 UINT8 Reserved0[4];
2189 UINT32 InstructionEntryCount;
2190} EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;
2191
2192///
2193/// ERST Version (as defined in ACPI 6.2 spec.)
2194///
2195#define EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01
2196
2197///
2198/// ERST Serialization Actions
2199///
2200#define EFI_ACPI_6_2_ERST_BEGIN_WRITE_OPERATION 0x00
2201#define EFI_ACPI_6_2_ERST_BEGIN_READ_OPERATION 0x01
2202#define EFI_ACPI_6_2_ERST_BEGIN_CLEAR_OPERATION 0x02
2203#define EFI_ACPI_6_2_ERST_END_OPERATION 0x03
2204#define EFI_ACPI_6_2_ERST_SET_RECORD_OFFSET 0x04
2205#define EFI_ACPI_6_2_ERST_EXECUTE_OPERATION 0x05
2206#define EFI_ACPI_6_2_ERST_CHECK_BUSY_STATUS 0x06
2207#define EFI_ACPI_6_2_ERST_GET_COMMAND_STATUS 0x07
2208#define EFI_ACPI_6_2_ERST_GET_RECORD_IDENTIFIER 0x08
2209#define EFI_ACPI_6_2_ERST_SET_RECORD_IDENTIFIER 0x09
2210#define EFI_ACPI_6_2_ERST_GET_RECORD_COUNT 0x0A
2211#define EFI_ACPI_6_2_ERST_BEGIN_DUMMY_WRITE_OPERATION 0x0B
2212#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE 0x0D
2213#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH 0x0E
2214#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES 0x0F
2215#define EFI_ACPI_6_2_ERST_GET_EXECUTE_OPERATION_TIMINGS 0x10
2216
2217///
2218/// ERST Action Command Status
2219///
2220#define EFI_ACPI_6_2_ERST_STATUS_SUCCESS 0x00
2221#define EFI_ACPI_6_2_ERST_STATUS_NOT_ENOUGH_SPACE 0x01
2222#define EFI_ACPI_6_2_ERST_STATUS_HARDWARE_NOT_AVAILABLE 0x02
2223#define EFI_ACPI_6_2_ERST_STATUS_FAILED 0x03
2224#define EFI_ACPI_6_2_ERST_STATUS_RECORD_STORE_EMPTY 0x04
2225#define EFI_ACPI_6_2_ERST_STATUS_RECORD_NOT_FOUND 0x05
2226
2227///
2228/// ERST Serialization Instructions
2229///
2230#define EFI_ACPI_6_2_ERST_READ_REGISTER 0x00
2231#define EFI_ACPI_6_2_ERST_READ_REGISTER_VALUE 0x01
2232#define EFI_ACPI_6_2_ERST_WRITE_REGISTER 0x02
2233#define EFI_ACPI_6_2_ERST_WRITE_REGISTER_VALUE 0x03
2234#define EFI_ACPI_6_2_ERST_NOOP 0x04
2235#define EFI_ACPI_6_2_ERST_LOAD_VAR1 0x05
2236#define EFI_ACPI_6_2_ERST_LOAD_VAR2 0x06
2237#define EFI_ACPI_6_2_ERST_STORE_VAR1 0x07
2238#define EFI_ACPI_6_2_ERST_ADD 0x08
2239#define EFI_ACPI_6_2_ERST_SUBTRACT 0x09
2240#define EFI_ACPI_6_2_ERST_ADD_VALUE 0x0A
2241#define EFI_ACPI_6_2_ERST_SUBTRACT_VALUE 0x0B
2242#define EFI_ACPI_6_2_ERST_STALL 0x0C
2243#define EFI_ACPI_6_2_ERST_STALL_WHILE_TRUE 0x0D
2244#define EFI_ACPI_6_2_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE 0x0E
2245#define EFI_ACPI_6_2_ERST_GOTO 0x0F
2246#define EFI_ACPI_6_2_ERST_SET_SRC_ADDRESS_BASE 0x10
2247#define EFI_ACPI_6_2_ERST_SET_DST_ADDRESS_BASE 0x11
2248#define EFI_ACPI_6_2_ERST_MOVE_DATA 0x12
2249
2250///
2251/// ERST Instruction Flags
2252///
2253#define EFI_ACPI_6_2_ERST_PRESERVE_REGISTER 0x01
2254
2255///
2256/// ERST Serialization Instruction Entry
2257///
2258typedef struct {
2259 UINT8 SerializationAction;
2260 UINT8 Instruction;
2261 UINT8 Flags;
2262 UINT8 Reserved0;
2263 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE RegisterRegion;
2264 UINT64 Value;
2265 UINT64 Mask;
2266} EFI_ACPI_6_2_ERST_SERIALIZATION_INSTRUCTION_ENTRY;
2267
2268///
2269/// EINJ - Error Injection Table
2270///
2271typedef struct {
2272 EFI_ACPI_DESCRIPTION_HEADER Header;
2273 UINT32 InjectionHeaderSize;
2274 UINT8 InjectionFlags;
2275 UINT8 Reserved0[3];
2276 UINT32 InjectionEntryCount;
2277} EFI_ACPI_6_2_ERROR_INJECTION_TABLE_HEADER;
2278
2279///
2280/// EINJ Version (as defined in ACPI 6.2 spec.)
2281///
2282#define EFI_ACPI_6_2_ERROR_INJECTION_TABLE_REVISION 0x01
2283
2284///
2285/// EINJ Error Injection Actions
2286///
2287#define EFI_ACPI_6_2_EINJ_BEGIN_INJECTION_OPERATION 0x00
2288#define EFI_ACPI_6_2_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE 0x01
2289#define EFI_ACPI_6_2_EINJ_SET_ERROR_TYPE 0x02
2290#define EFI_ACPI_6_2_EINJ_GET_ERROR_TYPE 0x03
2291#define EFI_ACPI_6_2_EINJ_END_OPERATION 0x04
2292#define EFI_ACPI_6_2_EINJ_EXECUTE_OPERATION 0x05
2293#define EFI_ACPI_6_2_EINJ_CHECK_BUSY_STATUS 0x06
2294#define EFI_ACPI_6_2_EINJ_GET_COMMAND_STATUS 0x07
2295#define EFI_ACPI_6_2_EINJ_TRIGGER_ERROR 0xFF
2296
2297///
2298/// EINJ Action Command Status
2299///
2300#define EFI_ACPI_6_2_EINJ_STATUS_SUCCESS 0x00
2301#define EFI_ACPI_6_2_EINJ_STATUS_UNKNOWN_FAILURE 0x01
2302#define EFI_ACPI_6_2_EINJ_STATUS_INVALID_ACCESS 0x02
2303
2304///
2305/// EINJ Error Type Definition
2306///
2307#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_CORRECTABLE (1 << 0)
2308#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL (1 << 1)
2309#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL (1 << 2)
2310#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_CORRECTABLE (1 << 3)
2311#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL (1 << 4)
2312#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL (1 << 5)
2313#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE (1 << 6)
2314#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL (1 << 7)
2315#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL (1 << 8)
2316#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_CORRECTABLE (1 << 9)
2317#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL (1 << 10)
2318#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL (1 << 11)
2319
2320///
2321/// EINJ Injection Instructions
2322///
2323#define EFI_ACPI_6_2_EINJ_READ_REGISTER 0x00
2324#define EFI_ACPI_6_2_EINJ_READ_REGISTER_VALUE 0x01
2325#define EFI_ACPI_6_2_EINJ_WRITE_REGISTER 0x02
2326#define EFI_ACPI_6_2_EINJ_WRITE_REGISTER_VALUE 0x03
2327#define EFI_ACPI_6_2_EINJ_NOOP 0x04
2328
2329///
2330/// EINJ Instruction Flags
2331///
2332#define EFI_ACPI_6_2_EINJ_PRESERVE_REGISTER 0x01
2333
2334///
2335/// EINJ Injection Instruction Entry
2336///
2337typedef struct {
2338 UINT8 InjectionAction;
2339 UINT8 Instruction;
2340 UINT8 Flags;
2341 UINT8 Reserved0;
2342 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE RegisterRegion;
2343 UINT64 Value;
2344 UINT64 Mask;
2345} EFI_ACPI_6_2_EINJ_INJECTION_INSTRUCTION_ENTRY;
2346
2347///
2348/// EINJ Trigger Action Table
2349///
2350typedef struct {
2351 UINT32 HeaderSize;
2352 UINT32 Revision;
2353 UINT32 TableSize;
2354 UINT32 EntryCount;
2355} EFI_ACPI_6_2_EINJ_TRIGGER_ACTION_TABLE;
2356
2357///
2358/// Platform Communications Channel Table (PCCT)
2359///
2360typedef struct {
2361 EFI_ACPI_DESCRIPTION_HEADER Header;
2362 UINT32 Flags;
2363 UINT64 Reserved;
2364} EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;
2365
2366///
2367/// PCCT Version (as defined in ACPI 6.2 spec.)
2368///
2369#define EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x02
2370
2371///
2372/// PCCT Global Flags
2373///
2374#define EFI_ACPI_6_2_PCCT_FLAGS_PLATFORM_INTERRUPT BIT0
2375
2376//
2377// PCCT Subspace type
2378//
2379#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_GENERIC 0x00
2380#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS 0x01
2381#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS 0x02
2382#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_3_EXTENDED_PCC 0x03
2383#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_4_EXTENDED_PCC 0x04
2384
2385///
2386/// PCC Subspace Structure Header
2387///
2388typedef struct {
2389 UINT8 Type;
2390 UINT8 Length;
2391} EFI_ACPI_6_2_PCCT_SUBSPACE_HEADER;
2392
2393///
2394/// Generic Communications Subspace Structure
2395///
2396typedef struct {
2397 UINT8 Type;
2398 UINT8 Length;
2399 UINT8 Reserved[6];
2400 UINT64 BaseAddress;
2401 UINT64 AddressLength;
2402 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2403 UINT64 DoorbellPreserve;
2404 UINT64 DoorbellWrite;
2405 UINT32 NominalLatency;
2406 UINT32 MaximumPeriodicAccessRate;
2407 UINT16 MinimumRequestTurnaroundTime;
2408} EFI_ACPI_6_2_PCCT_SUBSPACE_GENERIC;
2409
2410///
2411/// Generic Communications Channel Shared Memory Region
2412///
2413
2414typedef struct {
2415 UINT8 Command;
2416 UINT8 Reserved : 7;
2417 UINT8 NotifyOnCompletion : 1;
2418} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;
2419
2420typedef struct {
2421 UINT8 CommandComplete : 1;
2422 UINT8 PlatformInterrupt : 1;
2423 UINT8 Error : 1;
2424 UINT8 PlatformNotification : 1;
2425 UINT8 Reserved : 4;
2426 UINT8 Reserved1;
2427} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;
2428
2429typedef struct {
2430 UINT32 Signature;
2431 EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND Command;
2432 EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS Status;
2433} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;
2434
2435#define EFI_ACPI_6_2_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_POLARITY BIT0
2436#define EFI_ACPI_6_2_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_MODE BIT1
2437
2438///
2439/// Type 1 HW-Reduced Communications Subspace Structure
2440///
2441typedef struct {
2442 UINT8 Type;
2443 UINT8 Length;
2444 UINT32 PlatformInterrupt;
2445 UINT8 PlatformInterruptFlags;
2446 UINT8 Reserved;
2447 UINT64 BaseAddress;
2448 UINT64 AddressLength;
2449 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2450 UINT64 DoorbellPreserve;
2451 UINT64 DoorbellWrite;
2452 UINT32 NominalLatency;
2453 UINT32 MaximumPeriodicAccessRate;
2454 UINT16 MinimumRequestTurnaroundTime;
2455} EFI_ACPI_6_2_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;
2456
2457///
2458/// Type 2 HW-Reduced Communications Subspace Structure
2459///
2460typedef struct {
2461 UINT8 Type;
2462 UINT8 Length;
2463 UINT32 PlatformInterrupt;
2464 UINT8 PlatformInterruptFlags;
2465 UINT8 Reserved;
2466 UINT64 BaseAddress;
2467 UINT64 AddressLength;
2468 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2469 UINT64 DoorbellPreserve;
2470 UINT64 DoorbellWrite;
2471 UINT32 NominalLatency;
2472 UINT32 MaximumPeriodicAccessRate;
2473 UINT16 MinimumRequestTurnaroundTime;
2474 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE PlatformInterruptAckRegister;
2475 UINT64 PlatformInterruptAckPreserve;
2476 UINT64 PlatformInterruptAckWrite;
2477} EFI_ACPI_6_2_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;
2478
2479///
2480/// Type 3 Extended PCC Subspace Structure
2481///
2482typedef struct {
2483 UINT8 Type;
2484 UINT8 Length;
2485 UINT32 PlatformInterrupt;
2486 UINT8 PlatformInterruptFlags;
2487 UINT8 Reserved;
2488 UINT64 BaseAddress;
2489 UINT32 AddressLength;
2490 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2491 UINT64 DoorbellPreserve;
2492 UINT64 DoorbellWrite;
2493 UINT32 NominalLatency;
2494 UINT32 MaximumPeriodicAccessRate;
2495 UINT32 MinimumRequestTurnaroundTime;
2496 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE PlatformInterruptAckRegister;
2497 UINT64 PlatformInterruptAckPreserve;
2498 UINT64 PlatformInterruptAckSet;
2499 UINT8 Reserved1[8];
2500 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE CommandCompleteCheckRegister;
2501 UINT64 CommandCompleteCheckMask;
2502 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE CommandCompleteUpdateRegister;
2503 UINT64 CommandCompleteUpdatePreserve;
2504 UINT64 CommandCompleteUpdateSet;
2505 EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE ErrorStatusRegister;
2506 UINT64 ErrorStatusMask;
2507} EFI_ACPI_6_2_PCCT_SUBSPACE_3_EXTENDED_PCC;
2508
2509///
2510/// Type 4 Extended PCC Subspace Structure
2511///
2512typedef EFI_ACPI_6_2_PCCT_SUBSPACE_3_EXTENDED_PCC EFI_ACPI_6_2_PCCT_SUBSPACE_4_EXTENDED_PCC;
2513
2514#define EFI_ACPI_6_2_PCCT_MASTER_SLAVE_COMMUNICATIONS_CHANNEL_FLAGS_NOTIFY_ON_COMPLETION BIT0
2515
2516typedef struct {
2517 UINT32 Signature;
2518 UINT32 Flags;
2519 UINT32 Length;
2520 UINT32 Command;
2521} EFI_ACPI_6_2_PCCT_EXTENDED_PCC_SHARED_MEMORY_REGION_HEADER;
2522
2523///
2524/// Platform Debug Trigger Table (PDTT)
2525///
2526typedef struct {
2527 EFI_ACPI_DESCRIPTION_HEADER Header;
2528 UINT8 TriggerCount;
2529 UINT8 Reserved[3];
2530 UINT32 TriggerIdentifierArrayOffset;
2531} EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_HEADER;
2532
2533///
2534/// PDTT Revision (as defined in ACPI 6.2 spec.)
2535///
2536#define EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_REVISION 0x00
2537
2538///
2539/// PDTT Platform Communication Channel Identifier Structure
2540///
2541typedef struct {
2542 UINT16 SubChannelIdentifer : 8;
2543 UINT16 Runtime : 1;
2544 UINT16 WaitForCompletion : 1;
2545 UINT16 Reserved : 6;
2546} EFI_ACPI_6_2_PDTT_PCC_IDENTIFIER;
2547
2548///
2549/// PCC Commands Codes used by Platform Debug Trigger Table
2550///
2551#define EFI_ACPI_6_2_PDTT_PCC_COMMAND_DOORBELL_ONLY 0x00
2552#define EFI_ACPI_6_2_PDTT_PCC_COMMAND_VENDOR_SPECIFIC 0x01
2553
2554///
2555/// PPTT Platform Communication Channel
2556///
2557typedef EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER EFI_ACPI_6_2_PDTT_PCC;
2558
2559///
2560/// Processor Properties Topology Table (PPTT)
2561///
2562typedef struct {
2563 EFI_ACPI_DESCRIPTION_HEADER Header;
2564} EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_HEADER;
2565
2566///
2567/// PPTT Revision (as defined in ACPI 6.2 spec.)
2568///
2569#define EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_REVISION 0x01
2570
2571///
2572/// PPTT types
2573///
2574#define EFI_ACPI_6_2_PPTT_TYPE_PROCESSOR 0x00
2575#define EFI_ACPI_6_2_PPTT_TYPE_CACHE 0x01
2576#define EFI_ACPI_6_2_PPTT_TYPE_ID 0x02
2577
2578///
2579/// PPTT Structure Header
2580///
2581typedef struct {
2582 UINT8 Type;
2583 UINT8 Length;
2584 UINT8 Reserved[2];
2585} EFI_ACPI_6_2_PPTT_STRUCTURE_HEADER;
2586
2587///
2588/// For PPTT struct processor flags
2589///
2590#define EFI_ACPI_6_2_PPTT_PROCESSOR_ID_INVALID 0x0
2591#define EFI_ACPI_6_2_PPTT_PROCESSOR_ID_VALID 0x1
2592
2593///
2594/// Processor hierarchy node structure flags
2595///
2596typedef struct {
2597 UINT32 PhysicalPackage : 1;
2598 UINT32 AcpiProcessorIdValid : 1;
2599 UINT32 Reserved : 30;
2600} EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR_FLAGS;
2601
2602///
2603/// Processor hierarchy node structure
2604///
2605typedef struct {
2606 UINT8 Type;
2607 UINT8 Length;
2608 UINT8 Reserved[2];
2609 EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR_FLAGS Flags;
2610 UINT32 Parent;
2611 UINT32 AcpiProcessorId;
2612 UINT32 NumberOfPrivateResources;
2613} EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR;
2614
2615///
2616/// Cache Type Structure flags
2617///
2618typedef struct {
2619 UINT32 SizePropertyValid : 1;
2620 UINT32 NumberOfSetsValid : 1;
2621 UINT32 AssociativityValid : 1;
2622 UINT32 AllocationTypeValid : 1;
2623 UINT32 CacheTypeValid : 1;
2624 UINT32 WritePolicyValid : 1;
2625 UINT32 LineSizeValid : 1;
2626 UINT32 Reserved : 25;
2627} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_FLAGS;
2628
2629///
2630/// For cache attributes
2631///
2632#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_READ 0x0
2633#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_WRITE 0x1
2634#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_READ_WRITE 0x2
2635#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_DATA 0x0
2636#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_INSTRUCTION 0x1
2637#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_UNIFIED 0x2
2638#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_BACK 0x0
2639#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_THROUGH 0x1
2640
2641///
2642/// Cache Type Structure cache attributes
2643///
2644typedef struct {
2645 UINT8 AllocationType : 2;
2646 UINT8 CacheType : 2;
2647 UINT8 WritePolicy : 1;
2648 UINT8 Reserved : 3;
2649} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_ATTRIBUTES;
2650
2651///
2652/// Cache Type Structure
2653///
2654typedef struct {
2655 UINT8 Type;
2656 UINT8 Length;
2657 UINT8 Reserved[2];
2658 EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_FLAGS Flags;
2659 UINT32 NextLevelOfCache;
2660 UINT32 Size;
2661 UINT32 NumberOfSets;
2662 UINT8 Associativity;
2663 EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_ATTRIBUTES Attributes;
2664 UINT16 LineSize;
2665} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE;
2666
2667///
2668/// ID structure
2669///
2670typedef struct {
2671 UINT8 Type;
2672 UINT8 Length;
2673 UINT8 Reserved[2];
2674 UINT32 VendorId;
2675 UINT64 Level1Id;
2676 UINT64 Level2Id;
2677 UINT16 MajorRev;
2678 UINT16 MinorRev;
2679 UINT16 SpinRev;
2680} EFI_ACPI_6_2_PPTT_STRUCTURE_ID;
2681
2682//
2683// Known table signatures
2684//
2685
2686///
2687/// "RSD PTR " Root System Description Pointer
2688///
2689#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')
2690
2691///
2692/// "APIC" Multiple APIC Description Table
2693///
2694#define EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('A', 'P', 'I', 'C')
2695
2696///
2697/// "BERT" Boot Error Record Table
2698///
2699#define EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_SIGNATURE SIGNATURE_32('B', 'E', 'R', 'T')
2700
2701///
2702/// "BGRT" Boot Graphics Resource Table
2703///
2704#define EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('B', 'G', 'R', 'T')
2705
2706///
2707/// "CPEP" Corrected Platform Error Polling Table
2708///
2709#define EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE SIGNATURE_32('C', 'P', 'E', 'P')
2710
2711///
2712/// "DSDT" Differentiated System Description Table
2713///
2714#define EFI_ACPI_6_2_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('D', 'S', 'D', 'T')
2715
2716///
2717/// "ECDT" Embedded Controller Boot Resources Table
2718///
2719#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE SIGNATURE_32('E', 'C', 'D', 'T')
2720
2721///
2722/// "EINJ" Error Injection Table
2723///
2724#define EFI_ACPI_6_2_ERROR_INJECTION_TABLE_SIGNATURE SIGNATURE_32('E', 'I', 'N', 'J')
2725
2726///
2727/// "ERST" Error Record Serialization Table
2728///
2729#define EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE SIGNATURE_32('E', 'R', 'S', 'T')
2730
2731///
2732/// "FACP" Fixed ACPI Description Table
2733///
2734#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('F', 'A', 'C', 'P')
2735
2736///
2737/// "FACS" Firmware ACPI Control Structure
2738///
2739#define EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE SIGNATURE_32('F', 'A', 'C', 'S')
2740
2741///
2742/// "FPDT" Firmware Performance Data Table
2743///
2744#define EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE SIGNATURE_32('F', 'P', 'D', 'T')
2745
2746///
2747/// "GTDT" Generic Timer Description Table
2748///
2749#define EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('G', 'T', 'D', 'T')
2750
2751///
2752/// "HEST" Hardware Error Source Table
2753///
2754#define EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE SIGNATURE_32('H', 'E', 'S', 'T')
2755
2756///
2757/// "HMAT" Heterogeneous Memory Attribute Table
2758///
2759#define EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_SIGNATURE SIGNATURE_32('H', 'M', 'A', 'T')
2760
2761///
2762/// "MPST" Memory Power State Table
2763///
2764#define EFI_ACPI_6_2_MEMORY_POWER_STATE_TABLE_SIGNATURE SIGNATURE_32('M', 'P', 'S', 'T')
2765
2766///
2767/// "MSCT" Maximum System Characteristics Table
2768///
2769#define EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE SIGNATURE_32('M', 'S', 'C', 'T')
2770
2771///
2772/// "NFIT" NVDIMM Firmware Interface Table
2773///
2774#define EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('N', 'F', 'I', 'T')
2775
2776///
2777/// "PDTT" Platform Debug Trigger Table
2778///
2779#define EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('P', 'D', 'T', 'T')
2780
2781///
2782/// "PMTT" Platform Memory Topology Table
2783///
2784#define EFI_ACPI_6_2_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE SIGNATURE_32('P', 'M', 'T', 'T')
2785
2786///
2787/// "PPTT" Processor Properties Topology Table
2788///
2789#define EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('P', 'P', 'T', 'T')
2790
2791///
2792/// "PSDT" Persistent System Description Table
2793///
2794#define EFI_ACPI_6_2_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('P', 'S', 'D', 'T')
2795
2796///
2797/// "RASF" ACPI RAS Feature Table
2798///
2799#define EFI_ACPI_6_2_ACPI_RAS_FEATURE_TABLE_SIGNATURE SIGNATURE_32('R', 'A', 'S', 'F')
2800
2801///
2802/// "RSDT" Root System Description Table
2803///
2804#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('R', 'S', 'D', 'T')
2805
2806///
2807/// "SBST" Smart Battery Specification Table
2808///
2809#define EFI_ACPI_6_2_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE SIGNATURE_32('S', 'B', 'S', 'T')
2810
2811///
2812/// "SDEV" Secure DEVices Table
2813///
2814#define EFI_ACPI_6_2_SECURE_DEVICES_TABLE_SIGNATURE SIGNATURE_32('S', 'D', 'E', 'V')
2815
2816///
2817/// "SLIT" System Locality Information Table
2818///
2819#define EFI_ACPI_6_2_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE SIGNATURE_32('S', 'L', 'I', 'T')
2820
2821///
2822/// "SRAT" System Resource Affinity Table
2823///
2824#define EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE SIGNATURE_32('S', 'R', 'A', 'T')
2825
2826///
2827/// "SSDT" Secondary System Description Table
2828///
2829#define EFI_ACPI_6_2_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('S', 'S', 'D', 'T')
2830
2831///
2832/// "XSDT" Extended System Description Table
2833///
2834#define EFI_ACPI_6_2_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('X', 'S', 'D', 'T')
2835
2836///
2837/// "BOOT" MS Simple Boot Spec
2838///
2839#define EFI_ACPI_6_2_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE SIGNATURE_32('B', 'O', 'O', 'T')
2840
2841///
2842/// "CSRT" MS Core System Resource Table
2843///
2844#define EFI_ACPI_6_2_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('C', 'S', 'R', 'T')
2845
2846///
2847/// "DBG2" MS Debug Port 2 Spec
2848///
2849#define EFI_ACPI_6_2_DEBUG_PORT_2_TABLE_SIGNATURE SIGNATURE_32('D', 'B', 'G', '2')
2850
2851///
2852/// "DBGP" MS Debug Port Spec
2853///
2854#define EFI_ACPI_6_2_DEBUG_PORT_TABLE_SIGNATURE SIGNATURE_32('D', 'B', 'G', 'P')
2855
2856///
2857/// "DMAR" DMA Remapping Table
2858///
2859#define EFI_ACPI_6_2_DMA_REMAPPING_TABLE_SIGNATURE SIGNATURE_32('D', 'M', 'A', 'R')
2860
2861///
2862/// "DPPT" DMA Protection Policy Table
2863///
2864#define EFI_ACPI_6_2_DMA_PROTECTION_POLICY_TABLE_SIGNATURE SIGNATURE_32('D', 'P', 'P', 'T')
2865
2866///
2867/// "DRTM" Dynamic Root of Trust for Measurement Table
2868///
2869#define EFI_ACPI_6_2_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE SIGNATURE_32('D', 'R', 'T', 'M')
2870
2871///
2872/// "ETDT" Event Timer Description Table
2873///
2874#define EFI_ACPI_6_2_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('E', 'T', 'D', 'T')
2875
2876///
2877/// "HPET" IA-PC High Precision Event Timer Table
2878///
2879#define EFI_ACPI_6_2_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE SIGNATURE_32('H', 'P', 'E', 'T')
2880
2881///
2882/// "iBFT" iSCSI Boot Firmware Table
2883///
2884#define EFI_ACPI_6_2_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE SIGNATURE_32('i', 'B', 'F', 'T')
2885
2886///
2887/// "IORT" I/O Remapping Table
2888///
2889#define EFI_ACPI_6_2_IO_REMAPPING_TABLE_SIGNATURE SIGNATURE_32('I', 'O', 'R', 'T')
2890
2891///
2892/// "IVRS" I/O Virtualization Reporting Structure
2893///
2894#define EFI_ACPI_6_2_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE SIGNATURE_32('I', 'V', 'R', 'S')
2895
2896///
2897/// "LPIT" Low Power Idle Table
2898///
2899#define EFI_ACPI_6_2_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('L', 'P', 'I', 'T')
2900
2901///
2902/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table
2903///
2904#define EFI_ACPI_6_2_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('M', 'C', 'F', 'G')
2905
2906///
2907/// "MCHI" Management Controller Host Interface Table
2908///
2909#define EFI_ACPI_6_2_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('M', 'C', 'H', 'I')
2910
2911///
2912/// "MSDM" MS Data Management Table
2913///
2914#define EFI_ACPI_6_2_DATA_MANAGEMENT_TABLE_SIGNATURE SIGNATURE_32('M', 'S', 'D', 'M')
2915
2916///
2917/// "PCCT" Platform Communications Channel Table
2918///
2919#define EFI_ACPI_6_2_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE SIGNATURE_32('P', 'C', 'C', 'T')
2920
2921///
2922/// "SDEI" Software Delegated Exceptions Interface Table
2923///
2924#define EFI_ACPI_6_2_SOFTWARE_DELEGATED_EXCEPTIONS_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('S', 'D', 'E', 'I')
2925
2926///
2927/// "SLIC" MS Software Licensing Table Specification
2928///
2929#define EFI_ACPI_6_2_SOFTWARE_LICENSING_TABLE_SIGNATURE SIGNATURE_32('S', 'L', 'I', 'C')
2930
2931///
2932/// "SPCR" Serial Port Console Redirection Table
2933///
2934#define EFI_ACPI_6_2_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE SIGNATURE_32('S', 'P', 'C', 'R')
2935
2936///
2937/// "SPMI" Server Platform Management Interface Table
2938///
2939#define EFI_ACPI_6_2_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('S', 'P', 'M', 'I')
2940
2941///
2942/// "STAO" _STA Override Table
2943///
2944#define EFI_ACPI_6_2_STA_OVERRIDE_TABLE_SIGNATURE SIGNATURE_32('S', 'T', 'A', 'O')
2945
2946///
2947/// "TCPA" Trusted Computing Platform Alliance Capabilities Table
2948///
2949#define EFI_ACPI_6_2_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE SIGNATURE_32('T', 'C', 'P', 'A')
2950
2951///
2952/// "TPM2" Trusted Computing Platform 1 Table
2953///
2954#define EFI_ACPI_6_2_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE SIGNATURE_32('T', 'P', 'M', '2')
2955
2956///
2957/// "UEFI" UEFI ACPI Data Table
2958///
2959#define EFI_ACPI_6_2_UEFI_ACPI_DATA_TABLE_SIGNATURE SIGNATURE_32('U', 'E', 'F', 'I')
2960
2961///
2962/// "WAET" Windows ACPI Emulated Devices Table
2963///
2964#define EFI_ACPI_6_2_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE SIGNATURE_32('W', 'A', 'E', 'T')
2965
2966///
2967/// "WDAT" Watchdog Action Table
2968///
2969#define EFI_ACPI_6_2_WATCHDOG_ACTION_TABLE_SIGNATURE SIGNATURE_32('W', 'D', 'A', 'T')
2970
2971///
2972/// "WDRT" Watchdog Resource Table
2973///
2974#define EFI_ACPI_6_2_WATCHDOG_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('W', 'D', 'R', 'T')
2975
2976///
2977/// "WPBT" MS Platform Binary Table
2978///
2979#define EFI_ACPI_6_2_PLATFORM_BINARY_TABLE_SIGNATURE SIGNATURE_32('W', 'P', 'B', 'T')
2980
2981///
2982/// "WSMT" Windows SMM Security Mitigation Table
2983///
2984#define EFI_ACPI_6_2_WINDOWS_SMM_SECURITY_MITIGATION_TABLE_SIGNATURE SIGNATURE_32('W', 'S', 'M', 'T')
2985
2986///
2987/// "XENV" Xen Project Table
2988///
2989#define EFI_ACPI_6_2_XEN_PROJECT_TABLE_SIGNATURE SIGNATURE_32('X', 'E', 'N', 'V')
2990
2991#pragma pack()
2992
2993#endif
Note: See TracBrowser for help on using the repository browser.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette