Gitiles
Code Review Sign In
review.coreboot.org / coreboot / 1ae366f071852ea3a3fd50aa23d1448ad57d0fb3 / . / src / vendorcode / intel / edk2 / edk2-stable202302 / MdePkg / Include / IndustryStandard / Acpi63.h
blob: 75f6ccbcef096563ea4fa8cc5af361329d2e8a7a [file] [log] [blame]
Ronak Kanabar1ae366f2023-06-07 01:21:56 +0530[diff] [blame^]1/** @file
2 ACPI 6.3 definitions from the ACPI Specification Revision 6.3 Jan, 2019.
3
4 Copyright (c) 2017 - 2022, Intel Corporation. All rights reserved.<BR>
5 Copyright (c) 2019 - 2020, ARM Ltd. All rights reserved.<BR>
6
7 SPDX-License-Identifier: BSD-2-Clause-Patent
8**/
9
10#ifndef _ACPI_6_3_H_
11#define _ACPI_6_3_H_
12
13#include <IndustryStandard/Acpi62.h>
14
15//
16// Ensure proper structure formats
17//
18#pragma pack(1)
19
20///
21/// ACPI 6.3 Generic Address Space definition
22///
23typedef struct {
24 UINT8 AddressSpaceId;
25 UINT8 RegisterBitWidth;
26 UINT8 RegisterBitOffset;
27 UINT8 AccessSize;
28 UINT64 Address;
29} EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE;
30
31//
32// Generic Address Space Address IDs
33//
34#define EFI_ACPI_6_3_SYSTEM_MEMORY 0x00
35#define EFI_ACPI_6_3_SYSTEM_IO 0x01
36#define EFI_ACPI_6_3_PCI_CONFIGURATION_SPACE 0x02
37#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER 0x03
38#define EFI_ACPI_6_3_SMBUS 0x04
39#define EFI_ACPI_6_3_SYSTEM_CMOS 0x05
40#define EFI_ACPI_6_3_PCI_BAR_TARGET 0x06
41#define EFI_ACPI_6_3_IPMI 0x07
42#define EFI_ACPI_6_3_GENERAL_PURPOSE_IO 0x08
43#define EFI_ACPI_6_3_GENERIC_SERIAL_BUS 0x09
44#define EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL 0x0A
45#define EFI_ACPI_6_3_FUNCTIONAL_FIXED_HARDWARE 0x7F
46
47//
48// Generic Address Space Access Sizes
49//
50#define EFI_ACPI_6_3_UNDEFINED 0
51#define EFI_ACPI_6_3_BYTE 1
52#define EFI_ACPI_6_3_WORD 2
53#define EFI_ACPI_6_3_DWORD 3
54#define EFI_ACPI_6_3_QWORD 4
55
56//
57// ACPI 6.3 table structures
58//
59
60///
61/// Root System Description Pointer Structure
62///
63typedef struct {
64 UINT64 Signature;
65 UINT8 Checksum;
66 UINT8 OemId[6];
67 UINT8 Revision;
68 UINT32 RsdtAddress;
69 UINT32 Length;
70 UINT64 XsdtAddress;
71 UINT8 ExtendedChecksum;
72 UINT8 Reserved[3];
73} EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER;
74
75///
76/// RSD_PTR Revision (as defined in ACPI 6.3 spec.)
77///
78#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02 ///< ACPISpec (Revision 6.3) says current value is 2
79
80///
81/// Common table header, this prefaces all ACPI tables, including FACS, but
82/// excluding the RSD PTR structure
83///
84typedef struct {
85 UINT32 Signature;
86 UINT32 Length;
87} EFI_ACPI_6_3_COMMON_HEADER;
88
89//
90// Root System Description Table
91// No definition needed as it is a common description table header, the same with
92// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.
93//
94
95///
96/// RSDT Revision (as defined in ACPI 6.3 spec.)
97///
98#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01
99
100//
101// Extended System Description Table
102// No definition needed as it is a common description table header, the same with
103// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.
104//
105
106///
107/// XSDT Revision (as defined in ACPI 6.3 spec.)
108///
109#define EFI_ACPI_6_3_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01
110
111///
112/// Fixed ACPI Description Table Structure (FADT)
113///
114typedef struct {
115 EFI_ACPI_DESCRIPTION_HEADER Header;
116 UINT32 FirmwareCtrl;
117 UINT32 Dsdt;
118 UINT8 Reserved0;
119 UINT8 PreferredPmProfile;
120 UINT16 SciInt;
121 UINT32 SmiCmd;
122 UINT8 AcpiEnable;
123 UINT8 AcpiDisable;
124 UINT8 S4BiosReq;
125 UINT8 PstateCnt;
126 UINT32 Pm1aEvtBlk;
127 UINT32 Pm1bEvtBlk;
128 UINT32 Pm1aCntBlk;
129 UINT32 Pm1bCntBlk;
130 UINT32 Pm2CntBlk;
131 UINT32 PmTmrBlk;
132 UINT32 Gpe0Blk;
133 UINT32 Gpe1Blk;
134 UINT8 Pm1EvtLen;
135 UINT8 Pm1CntLen;
136 UINT8 Pm2CntLen;
137 UINT8 PmTmrLen;
138 UINT8 Gpe0BlkLen;
139 UINT8 Gpe1BlkLen;
140 UINT8 Gpe1Base;
141 UINT8 CstCnt;
142 UINT16 PLvl2Lat;
143 UINT16 PLvl3Lat;
144 UINT16 FlushSize;
145 UINT16 FlushStride;
146 UINT8 DutyOffset;
147 UINT8 DutyWidth;
148 UINT8 DayAlrm;
149 UINT8 MonAlrm;
150 UINT8 Century;
151 UINT16 IaPcBootArch;
152 UINT8 Reserved1;
153 UINT32 Flags;
154 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE ResetReg;
155 UINT8 ResetValue;
156 UINT16 ArmBootArch;
157 UINT8 MinorVersion;
158 UINT64 XFirmwareCtrl;
159 UINT64 XDsdt;
160 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPm1aEvtBlk;
161 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPm1bEvtBlk;
162 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPm1aCntBlk;
163 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPm1bCntBlk;
164 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPm2CntBlk;
165 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XPmTmrBlk;
166 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XGpe0Blk;
167 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE XGpe1Blk;
168 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE SleepControlReg;
169 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE SleepStatusReg;
170 UINT64 HypervisorVendorIdentity;
171} EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE;
172
173///
174/// FADT Version (as defined in ACPI 6.3 spec.)
175///
176#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_REVISION 0x06
177#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION 0x03
178
179//
180// Fixed ACPI Description Table Preferred Power Management Profile
181//
182#define EFI_ACPI_6_3_PM_PROFILE_UNSPECIFIED 0
183#define EFI_ACPI_6_3_PM_PROFILE_DESKTOP 1
184#define EFI_ACPI_6_3_PM_PROFILE_MOBILE 2
185#define EFI_ACPI_6_3_PM_PROFILE_WORKSTATION 3
186#define EFI_ACPI_6_3_PM_PROFILE_ENTERPRISE_SERVER 4
187#define EFI_ACPI_6_3_PM_PROFILE_SOHO_SERVER 5
188#define EFI_ACPI_6_3_PM_PROFILE_APPLIANCE_PC 6
189#define EFI_ACPI_6_3_PM_PROFILE_PERFORMANCE_SERVER 7
190#define EFI_ACPI_6_3_PM_PROFILE_TABLET 8
191
192//
193// Fixed ACPI Description Table Boot Architecture Flags
194// All other bits are reserved and must be set to 0.
195//
196#define EFI_ACPI_6_3_LEGACY_DEVICES BIT0
197#define EFI_ACPI_6_3_8042 BIT1
198#define EFI_ACPI_6_3_VGA_NOT_PRESENT BIT2
199#define EFI_ACPI_6_3_MSI_NOT_SUPPORTED BIT3
200#define EFI_ACPI_6_3_PCIE_ASPM_CONTROLS BIT4
201#define EFI_ACPI_6_3_CMOS_RTC_NOT_PRESENT BIT5
202
203//
204// Fixed ACPI Description Table Arm Boot Architecture Flags
205// All other bits are reserved and must be set to 0.
206//
207#define EFI_ACPI_6_3_ARM_PSCI_COMPLIANT BIT0
208#define EFI_ACPI_6_3_ARM_PSCI_USE_HVC BIT1
209
210//
211// Fixed ACPI Description Table Fixed Feature Flags
212// All other bits are reserved and must be set to 0.
213//
214#define EFI_ACPI_6_3_WBINVD BIT0
215#define EFI_ACPI_6_3_WBINVD_FLUSH BIT1
216#define EFI_ACPI_6_3_PROC_C1 BIT2
217#define EFI_ACPI_6_3_P_LVL2_UP BIT3
218#define EFI_ACPI_6_3_PWR_BUTTON BIT4
219#define EFI_ACPI_6_3_SLP_BUTTON BIT5
220#define EFI_ACPI_6_3_FIX_RTC BIT6
221#define EFI_ACPI_6_3_RTC_S4 BIT7
222#define EFI_ACPI_6_3_TMR_VAL_EXT BIT8
223#define EFI_ACPI_6_3_DCK_CAP BIT9
224#define EFI_ACPI_6_3_RESET_REG_SUP BIT10
225#define EFI_ACPI_6_3_SEALED_CASE BIT11
226#define EFI_ACPI_6_3_HEADLESS BIT12
227#define EFI_ACPI_6_3_CPU_SW_SLP BIT13
228#define EFI_ACPI_6_3_PCI_EXP_WAK BIT14
229#define EFI_ACPI_6_3_USE_PLATFORM_CLOCK BIT15
230#define EFI_ACPI_6_3_S4_RTC_STS_VALID BIT16
231#define EFI_ACPI_6_3_REMOTE_POWER_ON_CAPABLE BIT17
232#define EFI_ACPI_6_3_FORCE_APIC_CLUSTER_MODEL BIT18
233#define EFI_ACPI_6_3_FORCE_APIC_PHYSICAL_DESTINATION_MODE BIT19
234#define EFI_ACPI_6_3_HW_REDUCED_ACPI BIT20
235#define EFI_ACPI_6_3_LOW_POWER_S0_IDLE_CAPABLE BIT21
236
237///
238/// Firmware ACPI Control Structure
239///
240typedef struct {
241 UINT32 Signature;
242 UINT32 Length;
243 UINT32 HardwareSignature;
244 UINT32 FirmwareWakingVector;
245 UINT32 GlobalLock;
246 UINT32 Flags;
247 UINT64 XFirmwareWakingVector;
248 UINT8 Version;
249 UINT8 Reserved0[3];
250 UINT32 OspmFlags;
251 UINT8 Reserved1[24];
252} EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE;
253
254///
255/// FACS Version (as defined in ACPI 6.3 spec.)
256///
257#define EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION 0x02
258
259///
260/// Firmware Control Structure Feature Flags
261/// All other bits are reserved and must be set to 0.
262///
263#define EFI_ACPI_6_3_S4BIOS_F BIT0
264#define EFI_ACPI_6_3_64BIT_WAKE_SUPPORTED_F BIT1
265
266///
267/// OSPM Enabled Firmware Control Structure Flags
268/// All other bits are reserved and must be set to 0.
269///
270#define EFI_ACPI_6_3_OSPM_64BIT_WAKE_F BIT0
271
272//
273// Differentiated System Description Table,
274// Secondary System Description Table
275// and Persistent System Description Table,
276// no definition needed as they are common description table header, the same with
277// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.
278//
279#define EFI_ACPI_6_3_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x02
280#define EFI_ACPI_6_3_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION 0x02
281
282///
283/// Multiple APIC Description Table header definition. The rest of the table
284/// must be defined in a platform specific manner.
285///
286typedef struct {
287 EFI_ACPI_DESCRIPTION_HEADER Header;
288 UINT32 LocalApicAddress;
289 UINT32 Flags;
290} EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;
291
292///
293/// MADT Revision (as defined in ACPI 6.3 spec.)
294///
295#define EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x05
296
297///
298/// Multiple APIC Flags
299/// All other bits are reserved and must be set to 0.
300///
301#define EFI_ACPI_6_3_PCAT_COMPAT BIT0
302
303//
304// Multiple APIC Description Table APIC structure types
305// All other values between 0x0D and 0x7F are reserved and
306// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.
307//
308#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC 0x00
309#define EFI_ACPI_6_3_IO_APIC 0x01
310#define EFI_ACPI_6_3_INTERRUPT_SOURCE_OVERRIDE 0x02
311#define EFI_ACPI_6_3_NON_MASKABLE_INTERRUPT_SOURCE 0x03
312#define EFI_ACPI_6_3_LOCAL_APIC_NMI 0x04
313#define EFI_ACPI_6_3_LOCAL_APIC_ADDRESS_OVERRIDE 0x05
314#define EFI_ACPI_6_3_IO_SAPIC 0x06
315#define EFI_ACPI_6_3_LOCAL_SAPIC 0x07
316#define EFI_ACPI_6_3_PLATFORM_INTERRUPT_SOURCES 0x08
317#define EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC 0x09
318#define EFI_ACPI_6_3_LOCAL_X2APIC_NMI 0x0A
319#define EFI_ACPI_6_3_GIC 0x0B
320#define EFI_ACPI_6_3_GICD 0x0C
321#define EFI_ACPI_6_3_GIC_MSI_FRAME 0x0D
322#define EFI_ACPI_6_3_GICR 0x0E
323#define EFI_ACPI_6_3_GIC_ITS 0x0F
324
325//
326// APIC Structure Definitions
327//
328
329///
330/// Processor Local APIC Structure Definition
331///
332typedef struct {
333 UINT8 Type;
334 UINT8 Length;
335 UINT8 AcpiProcessorUid;
336 UINT8 ApicId;
337 UINT32 Flags;
338} EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_STRUCTURE;
339
340///
341/// Local APIC Flags. All other bits are reserved and must be 0.
342///
343#define EFI_ACPI_6_3_LOCAL_APIC_ENABLED BIT0
344#define EFI_ACPI_6_3_LOCAL_APIC_ONLINE_CAPABLE BIT1
345
346///
347/// IO APIC Structure
348///
349typedef struct {
350 UINT8 Type;
351 UINT8 Length;
352 UINT8 IoApicId;
353 UINT8 Reserved;
354 UINT32 IoApicAddress;
355 UINT32 GlobalSystemInterruptBase;
356} EFI_ACPI_6_3_IO_APIC_STRUCTURE;
357
358///
359/// Interrupt Source Override Structure
360///
361typedef struct {
362 UINT8 Type;
363 UINT8 Length;
364 UINT8 Bus;
365 UINT8 Source;
366 UINT32 GlobalSystemInterrupt;
367 UINT16 Flags;
368} EFI_ACPI_6_3_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;
369
370///
371/// Platform Interrupt Sources Structure Definition
372///
373typedef struct {
374 UINT8 Type;
375 UINT8 Length;
376 UINT16 Flags;
377 UINT8 InterruptType;
378 UINT8 ProcessorId;
379 UINT8 ProcessorEid;
380 UINT8 IoSapicVector;
381 UINT32 GlobalSystemInterrupt;
382 UINT32 PlatformInterruptSourceFlags;
383 UINT8 CpeiProcessorOverride;
384 UINT8 Reserved[31];
385} EFI_ACPI_6_3_PLATFORM_INTERRUPT_APIC_STRUCTURE;
386
387//
388// MPS INTI flags.
389// All other bits are reserved and must be set to 0.
390//
391#define EFI_ACPI_6_3_POLARITY (3 << 0)
392#define EFI_ACPI_6_3_TRIGGER_MODE (3 << 2)
393
394///
395/// Non-Maskable Interrupt Source Structure
396///
397typedef struct {
398 UINT8 Type;
399 UINT8 Length;
400 UINT16 Flags;
401 UINT32 GlobalSystemInterrupt;
402} EFI_ACPI_6_3_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;
403
404///
405/// Local APIC NMI Structure
406///
407typedef struct {
408 UINT8 Type;
409 UINT8 Length;
410 UINT8 AcpiProcessorUid;
411 UINT16 Flags;
412 UINT8 LocalApicLint;
413} EFI_ACPI_6_3_LOCAL_APIC_NMI_STRUCTURE;
414
415///
416/// Local APIC Address Override Structure
417///
418typedef struct {
419 UINT8 Type;
420 UINT8 Length;
421 UINT16 Reserved;
422 UINT64 LocalApicAddress;
423} EFI_ACPI_6_3_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;
424
425///
426/// IO SAPIC Structure
427///
428typedef struct {
429 UINT8 Type;
430 UINT8 Length;
431 UINT8 IoApicId;
432 UINT8 Reserved;
433 UINT32 GlobalSystemInterruptBase;
434 UINT64 IoSapicAddress;
435} EFI_ACPI_6_3_IO_SAPIC_STRUCTURE;
436
437///
438/// Local SAPIC Structure
439/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String
440///
441typedef struct {
442 UINT8 Type;
443 UINT8 Length;
444 UINT8 AcpiProcessorId;
445 UINT8 LocalSapicId;
446 UINT8 LocalSapicEid;
447 UINT8 Reserved[3];
448 UINT32 Flags;
449 UINT32 ACPIProcessorUIDValue;
450} EFI_ACPI_6_3_PROCESSOR_LOCAL_SAPIC_STRUCTURE;
451
452///
453/// Platform Interrupt Sources Structure
454///
455typedef struct {
456 UINT8 Type;
457 UINT8 Length;
458 UINT16 Flags;
459 UINT8 InterruptType;
460 UINT8 ProcessorId;
461 UINT8 ProcessorEid;
462 UINT8 IoSapicVector;
463 UINT32 GlobalSystemInterrupt;
464 UINT32 PlatformInterruptSourceFlags;
465} EFI_ACPI_6_3_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;
466
467///
468/// Platform Interrupt Source Flags.
469/// All other bits are reserved and must be set to 0.
470///
471#define EFI_ACPI_6_3_CPEI_PROCESSOR_OVERRIDE BIT0
472
473///
474/// Processor Local x2APIC Structure Definition
475///
476typedef struct {
477 UINT8 Type;
478 UINT8 Length;
479 UINT8 Reserved[2];
480 UINT32 X2ApicId;
481 UINT32 Flags;
482 UINT32 AcpiProcessorUid;
483} EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_STRUCTURE;
484
485///
486/// Local x2APIC NMI Structure
487///
488typedef struct {
489 UINT8 Type;
490 UINT8 Length;
491 UINT16 Flags;
492 UINT32 AcpiProcessorUid;
493 UINT8 LocalX2ApicLint;
494 UINT8 Reserved[3];
495} EFI_ACPI_6_3_LOCAL_X2APIC_NMI_STRUCTURE;
496
497///
498/// GIC Structure
499///
500typedef struct {
501 UINT8 Type;
502 UINT8 Length;
503 UINT16 Reserved;
504 UINT32 CPUInterfaceNumber;
505 UINT32 AcpiProcessorUid;
506 UINT32 Flags;
507 UINT32 ParkingProtocolVersion;
508 UINT32 PerformanceInterruptGsiv;
509 UINT64 ParkedAddress;
510 UINT64 PhysicalBaseAddress;
511 UINT64 GICV;
512 UINT64 GICH;
513 UINT32 VGICMaintenanceInterrupt;
514 UINT64 GICRBaseAddress;
515 UINT64 MPIDR;
516 UINT8 ProcessorPowerEfficiencyClass;
517 UINT8 Reserved2;
518 UINT16 SpeOverflowInterrupt;
519} EFI_ACPI_6_3_GIC_STRUCTURE;
520
521///
522/// GIC Flags. All other bits are reserved and must be 0.
523///
524#define EFI_ACPI_6_3_GIC_ENABLED BIT0
525#define EFI_ACPI_6_3_PERFORMANCE_INTERRUPT_MODEL BIT1
526#define EFI_ACPI_6_3_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS BIT2
527
528///
529/// GIC Distributor Structure
530///
531typedef struct {
532 UINT8 Type;
533 UINT8 Length;
534 UINT16 Reserved1;
535 UINT32 GicId;
536 UINT64 PhysicalBaseAddress;
537 UINT32 SystemVectorBase;
538 UINT8 GicVersion;
539 UINT8 Reserved2[3];
540} EFI_ACPI_6_3_GIC_DISTRIBUTOR_STRUCTURE;
541
542///
543/// GIC Version
544///
545#define EFI_ACPI_6_3_GIC_V1 0x01
546#define EFI_ACPI_6_3_GIC_V2 0x02
547#define EFI_ACPI_6_3_GIC_V3 0x03
548#define EFI_ACPI_6_3_GIC_V4 0x04
549
550///
551/// GIC MSI Frame Structure
552///
553typedef struct {
554 UINT8 Type;
555 UINT8 Length;
556 UINT16 Reserved1;
557 UINT32 GicMsiFrameId;
558 UINT64 PhysicalBaseAddress;
559 UINT32 Flags;
560 UINT16 SPICount;
561 UINT16 SPIBase;
562} EFI_ACPI_6_3_GIC_MSI_FRAME_STRUCTURE;
563
564///
565/// GIC MSI Frame Flags. All other bits are reserved and must be 0.
566///
567#define EFI_ACPI_6_3_SPI_COUNT_BASE_SELECT BIT0
568
569///
570/// GICR Structure
571///
572typedef struct {
573 UINT8 Type;
574 UINT8 Length;
575 UINT16 Reserved;
576 UINT64 DiscoveryRangeBaseAddress;
577 UINT32 DiscoveryRangeLength;
578} EFI_ACPI_6_3_GICR_STRUCTURE;
579
580///
581/// GIC Interrupt Translation Service Structure
582///
583typedef struct {
584 UINT8 Type;
585 UINT8 Length;
586 UINT16 Reserved;
587 UINT32 GicItsId;
588 UINT64 PhysicalBaseAddress;
589 UINT32 Reserved2;
590} EFI_ACPI_6_3_GIC_ITS_STRUCTURE;
591
592///
593/// Smart Battery Description Table (SBST)
594///
595typedef struct {
596 EFI_ACPI_DESCRIPTION_HEADER Header;
597 UINT32 WarningEnergyLevel;
598 UINT32 LowEnergyLevel;
599 UINT32 CriticalEnergyLevel;
600} EFI_ACPI_6_3_SMART_BATTERY_DESCRIPTION_TABLE;
601
602///
603/// SBST Version (as defined in ACPI 6.3 spec.)
604///
605#define EFI_ACPI_6_3_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01
606
607///
608/// Embedded Controller Boot Resources Table (ECDT)
609/// The table is followed by a null terminated ASCII string that contains
610/// a fully qualified reference to the name space object.
611///
612typedef struct {
613 EFI_ACPI_DESCRIPTION_HEADER Header;
614 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE EcControl;
615 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE EcData;
616 UINT32 Uid;
617 UINT8 GpeBit;
618} EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;
619
620///
621/// ECDT Version (as defined in ACPI 6.3 spec.)
622///
623#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION 0x01
624
625///
626/// System Resource Affinity Table (SRAT). The rest of the table
627/// must be defined in a platform specific manner.
628///
629typedef struct {
630 EFI_ACPI_DESCRIPTION_HEADER Header;
631 UINT32 Reserved1; ///< Must be set to 1
632 UINT64 Reserved2;
633} EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;
634
635///
636/// SRAT Version (as defined in ACPI 6.3 spec.)
637///
638#define EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION 0x03
639
640//
641// SRAT structure types.
642// All other values between 0x06 an 0xFF are reserved and
643// will be ignored by OSPM.
644//
645#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY 0x00
646#define EFI_ACPI_6_3_MEMORY_AFFINITY 0x01
647#define EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_AFFINITY 0x02
648#define EFI_ACPI_6_3_GICC_AFFINITY 0x03
649#define EFI_ACPI_6_3_GIC_ITS_AFFINITY 0x04
650#define EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY 0x05
651
652///
653/// Processor Local APIC/SAPIC Affinity Structure Definition
654///
655typedef struct {
656 UINT8 Type;
657 UINT8 Length;
658 UINT8 ProximityDomain7To0;
659 UINT8 ApicId;
660 UINT32 Flags;
661 UINT8 LocalSapicEid;
662 UINT8 ProximityDomain31To8[3];
663 UINT32 ClockDomain;
664} EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;
665
666///
667/// Local APIC/SAPIC Flags. All other bits are reserved and must be 0.
668///
669#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)
670
671///
672/// Memory Affinity Structure Definition
673///
674typedef struct {
675 UINT8 Type;
676 UINT8 Length;
677 UINT32 ProximityDomain;
678 UINT16 Reserved1;
679 UINT32 AddressBaseLow;
680 UINT32 AddressBaseHigh;
681 UINT32 LengthLow;
682 UINT32 LengthHigh;
683 UINT32 Reserved2;
684 UINT32 Flags;
685 UINT64 Reserved3;
686} EFI_ACPI_6_3_MEMORY_AFFINITY_STRUCTURE;
687
688//
689// Memory Flags. All other bits are reserved and must be 0.
690//
691#define EFI_ACPI_6_3_MEMORY_ENABLED (1 << 0)
692#define EFI_ACPI_6_3_MEMORY_HOT_PLUGGABLE (1 << 1)
693#define EFI_ACPI_6_3_MEMORY_NONVOLATILE (1 << 2)
694
695///
696/// Processor Local x2APIC Affinity Structure Definition
697///
698typedef struct {
699 UINT8 Type;
700 UINT8 Length;
701 UINT8 Reserved1[2];
702 UINT32 ProximityDomain;
703 UINT32 X2ApicId;
704 UINT32 Flags;
705 UINT32 ClockDomain;
706 UINT8 Reserved2[4];
707} EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;
708
709///
710/// GICC Affinity Structure Definition
711///
712typedef struct {
713 UINT8 Type;
714 UINT8 Length;
715 UINT32 ProximityDomain;
716 UINT32 AcpiProcessorUid;
717 UINT32 Flags;
718 UINT32 ClockDomain;
719} EFI_ACPI_6_3_GICC_AFFINITY_STRUCTURE;
720
721///
722/// GICC Flags. All other bits are reserved and must be 0.
723///
724#define EFI_ACPI_6_3_GICC_ENABLED (1 << 0)
725
726///
727/// GIC Interrupt Translation Service (ITS) Affinity Structure Definition
728///
729typedef struct {
730 UINT8 Type;
731 UINT8 Length;
732 UINT32 ProximityDomain;
733 UINT8 Reserved[2];
734 UINT32 ItsId;
735} EFI_ACPI_6_3_GIC_ITS_AFFINITY_STRUCTURE;
736
737//
738// Generic Initiator Affinity Structure Device Handle Types
739// All other values between 0x02 an 0xFF are reserved and
740// will be ignored by OSPM.
741//
742#define EFI_ACPI_6_3_ACPI_DEVICE_HANDLE 0x00
743#define EFI_ACPI_6_3_PCI_DEVICE_HANDLE 0x01
744
745///
746/// Device Handle - ACPI
747///
748typedef struct {
749 UINT64 AcpiHid;
750 UINT32 AcpiUid;
751 UINT8 Reserved[4];
752} EFI_ACPI_6_3_DEVICE_HANDLE_ACPI;
753
754///
755/// Device Handle - PCI
756///
757typedef struct {
758 UINT16 PciSegment;
759 UINT16 PciBdfNumber;
760 UINT8 Reserved[12];
761} EFI_ACPI_6_3_DEVICE_HANDLE_PCI;
762
763///
764/// Generic Initiator Affinity Structure
765///
766typedef struct {
767 UINT8 Type;
768 UINT8 Length;
769 UINT8 Reserved1;
770 UINT8 DeviceHandleType;
771 UINT32 ProximityDomain;
772
773 union {
774 EFI_ACPI_6_3_DEVICE_HANDLE_ACPI Acpi;
775 EFI_ACPI_6_3_DEVICE_HANDLE_PCI Pci;
776 } DeviceHandle;
777
778 UINT32 Flags;
779 UINT8 Reserved2[4];
780} EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY_STRUCTURE;
781
782///
783/// Generic Initiator Affinity Structure Flags. All other bits are reserved
784/// and must be 0.
785///
786#define EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY_STRUCTURE_ENABLED (1 << 0)
787
788///
789/// System Locality Distance Information Table (SLIT).
790/// The rest of the table is a matrix.
791///
792typedef struct {
793 EFI_ACPI_DESCRIPTION_HEADER Header;
794 UINT64 NumberOfSystemLocalities;
795} EFI_ACPI_6_3_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;
796
797///
798/// SLIT Version (as defined in ACPI 6.3 spec.)
799///
800#define EFI_ACPI_6_3_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION 0x01
801
802///
803/// Corrected Platform Error Polling Table (CPEP)
804///
805typedef struct {
806 EFI_ACPI_DESCRIPTION_HEADER Header;
807 UINT8 Reserved[8];
808} EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;
809
810///
811/// CPEP Version (as defined in ACPI 6.3 spec.)
812///
813#define EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01
814
815//
816// CPEP processor structure types.
817//
818#define EFI_ACPI_6_3_CPEP_PROCESSOR_APIC_SAPIC 0x00
819
820///
821/// Corrected Platform Error Polling Processor Structure Definition
822///
823typedef struct {
824 UINT8 Type;
825 UINT8 Length;
826 UINT8 ProcessorId;
827 UINT8 ProcessorEid;
828 UINT32 PollingInterval;
829} EFI_ACPI_6_3_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;
830
831///
832/// Maximum System Characteristics Table (MSCT)
833///
834typedef struct {
835 EFI_ACPI_DESCRIPTION_HEADER Header;
836 UINT32 OffsetProxDomInfo;
837 UINT32 MaximumNumberOfProximityDomains;
838 UINT32 MaximumNumberOfClockDomains;
839 UINT64 MaximumPhysicalAddress;
840} EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;
841
842///
843/// MSCT Version (as defined in ACPI 6.3 spec.)
844///
845#define EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01
846
847///
848/// Maximum Proximity Domain Information Structure Definition
849///
850typedef struct {
851 UINT8 Revision;
852 UINT8 Length;
853 UINT32 ProximityDomainRangeLow;
854 UINT32 ProximityDomainRangeHigh;
855 UINT32 MaximumProcessorCapacity;
856 UINT64 MaximumMemoryCapacity;
857} EFI_ACPI_6_3_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;
858
859///
860/// ACPI RAS Feature Table definition.
861///
862typedef struct {
863 EFI_ACPI_DESCRIPTION_HEADER Header;
864 UINT8 PlatformCommunicationChannelIdentifier[12];
865} EFI_ACPI_6_3_RAS_FEATURE_TABLE;
866
867///
868/// RASF Version (as defined in ACPI 6.3 spec.)
869///
870#define EFI_ACPI_6_3_RAS_FEATURE_TABLE_REVISION 0x01
871
872///
873/// ACPI RASF Platform Communication Channel Shared Memory Region definition.
874///
875typedef struct {
876 UINT32 Signature;
877 UINT16 Command;
878 UINT16 Status;
879 UINT16 Version;
880 UINT8 RASCapabilities[16];
881 UINT8 SetRASCapabilities[16];
882 UINT16 NumberOfRASFParameterBlocks;
883 UINT32 SetRASCapabilitiesStatus;
884} EFI_ACPI_6_3_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;
885
886///
887/// ACPI RASF PCC command code
888///
889#define EFI_ACPI_6_3_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND 0x01
890
891///
892/// ACPI RASF Platform RAS Capabilities
893///
894#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED BIT0
895#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED_AND_EXPOSED_TO_SOFTWARE BIT1
896#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT2
897#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT3
898#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING BIT4
899
900///
901/// ACPI RASF Parameter Block structure for PATROL_SCRUB
902///
903typedef struct {
904 UINT16 Type;
905 UINT16 Version;
906 UINT16 Length;
907 UINT16 PatrolScrubCommand;
908 UINT64 RequestedAddressRange[2];
909 UINT64 ActualAddressRange[2];
910 UINT16 Flags;
911 UINT8 RequestedSpeed;
912} EFI_ACPI_6_3_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;
913
914///
915/// ACPI RASF Patrol Scrub command
916///
917#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS 0x01
918#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER 0x02
919#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER 0x03
920
921///
922/// Memory Power State Table definition.
923///
924typedef struct {
925 EFI_ACPI_DESCRIPTION_HEADER Header;
926 UINT8 PlatformCommunicationChannelIdentifier;
927 UINT8 Reserved[3];
928 // Memory Power Node Structure
929 // Memory Power State Characteristics
930} EFI_ACPI_6_3_MEMORY_POWER_STATUS_TABLE;
931
932///
933/// MPST Version (as defined in ACPI 6.3 spec.)
934///
935#define EFI_ACPI_6_3_MEMORY_POWER_STATE_TABLE_REVISION 0x01
936
937///
938/// MPST Platform Communication Channel Shared Memory Region definition.
939///
940typedef struct {
941 UINT32 Signature;
942 UINT16 Command;
943 UINT16 Status;
944 UINT32 MemoryPowerCommandRegister;
945 UINT32 MemoryPowerStatusRegister;
946 UINT32 PowerStateId;
947 UINT32 MemoryPowerNodeId;
948 UINT64 MemoryEnergyConsumed;
949 UINT64 ExpectedAveragePowerComsuned;
950} EFI_ACPI_6_3_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;
951
952///
953/// ACPI MPST PCC command code
954///
955#define EFI_ACPI_6_3_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND 0x03
956
957///
958/// ACPI MPST Memory Power command
959///
960#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE 0x01
961#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE 0x02
962#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED 0x03
963#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED 0x04
964
965///
966/// MPST Memory Power Node Table
967///
968typedef struct {
969 UINT8 PowerStateValue;
970 UINT8 PowerStateInformationIndex;
971} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE;
972
973typedef struct {
974 UINT8 Flag;
975 UINT8 Reserved;
976 UINT16 MemoryPowerNodeId;
977 UINT32 Length;
978 UINT64 AddressBase;
979 UINT64 AddressLength;
980 UINT32 NumberOfPowerStates;
981 UINT32 NumberOfPhysicalComponents;
982 // EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE MemoryPowerState[NumberOfPowerStates];
983 // UINT16 PhysicalComponentIdentifier[NumberOfPhysicalComponents];
984} EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE;
985
986#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE 0x01
987#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED 0x02
988#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE 0x04
989
990typedef struct {
991 UINT16 MemoryPowerNodeCount;
992 UINT8 Reserved[2];
993} EFI_ACPI_6_3_MPST_MEMORY_POWER_NODE_TABLE;
994
995///
996/// MPST Memory Power State Characteristics Table
997///
998typedef struct {
999 UINT8 PowerStateStructureID;
1000 UINT8 Flag;
1001 UINT16 Reserved;
1002 UINT32 AveragePowerConsumedInMPS0;
1003 UINT32 RelativePowerSavingToMPS0;
1004 UINT64 ExitLatencyToMPS0;
1005} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;
1006
1007#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED 0x01
1008#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY 0x02
1009#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT 0x04
1010
1011typedef struct {
1012 UINT16 MemoryPowerStateCharacteristicsCount;
1013 UINT8 Reserved[2];
1014} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;
1015
1016///
1017/// Memory Topology Table definition.
1018///
1019typedef struct {
1020 EFI_ACPI_DESCRIPTION_HEADER Header;
1021 UINT32 Reserved;
1022} EFI_ACPI_6_3_MEMORY_TOPOLOGY_TABLE;
1023
1024///
1025/// PMTT Version (as defined in ACPI 6.3 spec.)
1026///
1027#define EFI_ACPI_6_3_MEMORY_TOPOLOGY_TABLE_REVISION 0x01
1028
1029///
1030/// Common Memory Aggregator Device Structure.
1031///
1032typedef struct {
1033 UINT8 Type;
1034 UINT8 Reserved;
1035 UINT16 Length;
1036 UINT16 Flags;
1037 UINT16 Reserved1;
1038} EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1039
1040///
1041/// Memory Aggregator Device Type
1042///
1043#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET 0x0
1044#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x1
1045#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM 0x2
1046
1047///
1048/// Socket Memory Aggregator Device Structure.
1049///
1050typedef struct {
1051 EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1052 UINT16 SocketIdentifier;
1053 UINT16 Reserved;
1054 // EFI_ACPI_6_3_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE MemoryController[];
1055} EFI_ACPI_6_3_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1056
1057///
1058/// MemoryController Memory Aggregator Device Structure.
1059///
1060typedef struct {
1061 EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1062 UINT32 ReadLatency;
1063 UINT32 WriteLatency;
1064 UINT32 ReadBandwidth;
1065 UINT32 WriteBandwidth;
1066 UINT16 OptimalAccessUnit;
1067 UINT16 OptimalAccessAlignment;
1068 UINT16 Reserved;
1069 UINT16 NumberOfProximityDomains;
1070 // UINT32 ProximityDomain[NumberOfProximityDomains];
1071 // EFI_ACPI_6_3_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE PhysicalComponent[];
1072} EFI_ACPI_6_3_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1073
1074///
1075/// DIMM Memory Aggregator Device Structure.
1076///
1077typedef struct {
1078 EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE Header;
1079 UINT16 PhysicalComponentIdentifier;
1080 UINT16 Reserved;
1081 UINT32 SizeOfDimm;
1082 UINT32 SmbiosHandle;
1083} EFI_ACPI_6_3_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;
1084
1085///
1086/// Boot Graphics Resource Table definition.
1087///
1088typedef struct {
1089 EFI_ACPI_DESCRIPTION_HEADER Header;
1090 ///
1091 /// 2-bytes (16 bit) version ID. This value must be 1.
1092 ///
1093 UINT16 Version;
1094 ///
1095 /// 1-byte status field indicating current status about the table.
1096 /// Bits[7:1] = Reserved (must be zero)
1097 /// Bit [0] = Valid. A one indicates the boot image graphic is valid.
1098 ///
1099 UINT8 Status;
1100 ///
1101 /// 1-byte enumerated type field indicating format of the image.
1102 /// 0 = Bitmap
1103 /// 1 - 255 Reserved (for future use)
1104 ///
1105 UINT8 ImageType;
1106 ///
1107 /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy
1108 /// of the image bitmap.
1109 ///
1110 UINT64 ImageAddress;
1111 ///
1112 /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.
1113 /// (X, Y) display offset of the top left corner of the boot image.
1114 /// The top left corner of the display is at offset (0, 0).
1115 ///
1116 UINT32 ImageOffsetX;
1117 ///
1118 /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.
1119 /// (X, Y) display offset of the top left corner of the boot image.
1120 /// The top left corner of the display is at offset (0, 0).
1121 ///
1122 UINT32 ImageOffsetY;
1123} EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE;
1124
1125///
1126/// BGRT Revision
1127///
1128#define EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1
1129
1130///
1131/// BGRT Version
1132///
1133#define EFI_ACPI_6_3_BGRT_VERSION 0x01
1134
1135///
1136/// BGRT Status
1137///
1138#define EFI_ACPI_6_3_BGRT_STATUS_NOT_DISPLAYED 0x00
1139#define EFI_ACPI_6_3_BGRT_STATUS_DISPLAYED 0x01
1140
1141///
1142/// BGRT Image Type
1143///
1144#define EFI_ACPI_6_3_BGRT_IMAGE_TYPE_BMP 0x00
1145
1146///
1147/// FPDT Version (as defined in ACPI 6.3 spec.)
1148///
1149#define EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01
1150
1151///
1152/// FPDT Performance Record Types
1153///
1154#define EFI_ACPI_6_3_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER 0x0000
1155#define EFI_ACPI_6_3_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER 0x0001
1156
1157///
1158/// FPDT Performance Record Revision
1159///
1160#define EFI_ACPI_6_3_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER 0x01
1161#define EFI_ACPI_6_3_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01
1162
1163///
1164/// FPDT Runtime Performance Record Types
1165///
1166#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME 0x0000
1167#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND 0x0001
1168#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT 0x0002
1169
1170///
1171/// FPDT Runtime Performance Record Revision
1172///
1173#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME 0x01
1174#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND 0x01
1175#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT 0x02
1176
1177///
1178/// FPDT Performance Record header
1179///
1180typedef struct {
1181 UINT16 Type;
1182 UINT8 Length;
1183 UINT8 Revision;
1184} EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER;
1185
1186///
1187/// FPDT Performance Table header
1188///
1189typedef struct {
1190 UINT32 Signature;
1191 UINT32 Length;
1192} EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER;
1193
1194///
1195/// FPDT Firmware Basic Boot Performance Pointer Record Structure
1196///
1197typedef struct {
1198 EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER Header;
1199 UINT32 Reserved;
1200 ///
1201 /// 64-bit processor-relative physical address of the Basic Boot Performance Table.
1202 ///
1203 UINT64 BootPerformanceTablePointer;
1204} EFI_ACPI_6_3_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;
1205
1206///
1207/// FPDT S3 Performance Table Pointer Record Structure
1208///
1209typedef struct {
1210 EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER Header;
1211 UINT32 Reserved;
1212 ///
1213 /// 64-bit processor-relative physical address of the S3 Performance Table.
1214 ///
1215 UINT64 S3PerformanceTablePointer;
1216} EFI_ACPI_6_3_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;
1217
1218///
1219/// FPDT Firmware Basic Boot Performance Record Structure
1220///
1221typedef struct {
1222 EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER Header;
1223 UINT32 Reserved;
1224 ///
1225 /// Timer value logged at the beginning of firmware image execution.
1226 /// This may not always be zero or near zero.
1227 ///
1228 UINT64 ResetEnd;
1229 ///
1230 /// Timer value logged just prior to loading the OS boot loader into memory.
1231 /// For non-UEFI compatible boots, this field must be zero.
1232 ///
1233 UINT64 OsLoaderLoadImageStart;
1234 ///
1235 /// Timer value logged just prior to launching the previously loaded OS boot loader image.
1236 /// For non-UEFI compatible boots, the timer value logged will be just prior
1237 /// to the INT 19h handler invocation.
1238 ///
1239 UINT64 OsLoaderStartImageStart;
1240 ///
1241 /// Timer value logged at the point when the OS loader calls the
1242 /// ExitBootServices function for UEFI compatible firmware.
1243 /// For non-UEFI compatible boots, this field must be zero.
1244 ///
1245 UINT64 ExitBootServicesEntry;
1246 ///
1247 /// Timer value logged at the point just prior towhen the OS loader gaining
1248 /// control back from calls the ExitBootServices function for UEFI compatible firmware.
1249 /// For non-UEFI compatible boots, this field must be zero.
1250 ///
1251 UINT64 ExitBootServicesExit;
1252} EFI_ACPI_6_3_FPDT_FIRMWARE_BASIC_BOOT_RECORD;
1253
1254///
1255/// FPDT Firmware Basic Boot Performance Table signature
1256///
1257#define EFI_ACPI_6_3_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE SIGNATURE_32('F', 'B', 'P', 'T')
1258
1259//
1260// FPDT Firmware Basic Boot Performance Table
1261//
1262typedef struct {
1263 EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER Header;
1264 //
1265 // one or more Performance Records.
1266 //
1267} EFI_ACPI_6_3_FPDT_FIRMWARE_BASIC_BOOT_TABLE;
1268
1269///
1270/// FPDT "S3PT" S3 Performance Table
1271///
1272#define EFI_ACPI_6_3_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE SIGNATURE_32('S', '3', 'P', 'T')
1273
1274//
1275// FPDT Firmware S3 Boot Performance Table
1276//
1277typedef struct {
1278 EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER Header;
1279 //
1280 // one or more Performance Records.
1281 //
1282} EFI_ACPI_6_3_FPDT_FIRMWARE_S3_BOOT_TABLE;
1283
1284///
1285/// FPDT Basic S3 Resume Performance Record
1286///
1287typedef struct {
1288 EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER Header;
1289 ///
1290 /// A count of the number of S3 resume cycles since the last full boot sequence.
1291 ///
1292 UINT32 ResumeCount;
1293 ///
1294 /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the
1295 /// OS waking vector. Only the most recent resume cycle's time is retained.
1296 ///
1297 UINT64 FullResume;
1298 ///
1299 /// Average timer value of all resume cycles logged since the last full boot
1300 /// sequence, including the most recent resume. Note that the entire log of
1301 /// timer values does not need to be retained in order to calculate this average.
1302 ///
1303 UINT64 AverageResume;
1304} EFI_ACPI_6_3_FPDT_S3_RESUME_RECORD;
1305
1306///
1307/// FPDT Basic S3 Suspend Performance Record
1308///
1309typedef struct {
1310 EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER Header;
1311 ///
1312 /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.
1313 /// Only the most recent suspend cycle's timer value is retained.
1314 ///
1315 UINT64 SuspendStart;
1316 ///
1317 /// Timer value recorded at the final firmware write to SLP_TYP (or other
1318 /// mechanism) used to trigger hardware entry to S3.
1319 /// Only the most recent suspend cycle's timer value is retained.
1320 ///
1321 UINT64 SuspendEnd;
1322} EFI_ACPI_6_3_FPDT_S3_SUSPEND_RECORD;
1323
1324///
1325/// Firmware Performance Record Table definition.
1326///
1327typedef struct {
1328 EFI_ACPI_DESCRIPTION_HEADER Header;
1329} EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_RECORD_TABLE;
1330
1331///
1332/// Generic Timer Description Table definition.
1333///
1334typedef struct {
1335 EFI_ACPI_DESCRIPTION_HEADER Header;
1336 UINT64 CntControlBasePhysicalAddress;
1337 UINT32 Reserved;
1338 UINT32 SecurePL1TimerGSIV;
1339 UINT32 SecurePL1TimerFlags;
1340 UINT32 NonSecurePL1TimerGSIV;
1341 UINT32 NonSecurePL1TimerFlags;
1342 UINT32 VirtualTimerGSIV;
1343 UINT32 VirtualTimerFlags;
1344 UINT32 NonSecurePL2TimerGSIV;
1345 UINT32 NonSecurePL2TimerFlags;
1346 UINT64 CntReadBasePhysicalAddress;
1347 UINT32 PlatformTimerCount;
1348 UINT32 PlatformTimerOffset;
1349 UINT32 VirtualPL2TimerGSIV;
1350 UINT32 VirtualPL2TimerFlags;
1351} EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE;
1352
1353///
1354/// GTDT Version (as defined in ACPI 6.3 spec.)
1355///
1356#define EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x03
1357
1358///
1359/// Timer Flags. All other bits are reserved and must be 0.
1360///
1361#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE BIT0
1362#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1363#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY BIT2
1364
1365///
1366/// Platform Timer Type
1367///
1368#define EFI_ACPI_6_3_GTDT_GT_BLOCK 0
1369#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG 1
1370
1371///
1372/// GT Block Structure
1373///
1374typedef struct {
1375 UINT8 Type;
1376 UINT16 Length;
1377 UINT8 Reserved;
1378 UINT64 CntCtlBase;
1379 UINT32 GTBlockTimerCount;
1380 UINT32 GTBlockTimerOffset;
1381} EFI_ACPI_6_3_GTDT_GT_BLOCK_STRUCTURE;
1382
1383///
1384/// GT Block Timer Structure
1385///
1386typedef struct {
1387 UINT8 GTFrameNumber;
1388 UINT8 Reserved[3];
1389 UINT64 CntBaseX;
1390 UINT64 CntEL0BaseX;
1391 UINT32 GTxPhysicalTimerGSIV;
1392 UINT32 GTxPhysicalTimerFlags;
1393 UINT32 GTxVirtualTimerGSIV;
1394 UINT32 GTxVirtualTimerFlags;
1395 UINT32 GTxCommonFlags;
1396} EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_STRUCTURE;
1397
1398///
1399/// GT Block Physical Timers and Virtual Timers Flags. All other bits are reserved and must be 0.
1400///
1401#define EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE BIT0
1402#define EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1403
1404///
1405/// Common Flags Flags. All other bits are reserved and must be 0.
1406///
1407#define EFI_ACPI_6_3_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER BIT0
1408#define EFI_ACPI_6_3_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY BIT1
1409
1410///
1411/// SBSA Generic Watchdog Structure
1412///
1413typedef struct {
1414 UINT8 Type;
1415 UINT16 Length;
1416 UINT8 Reserved;
1417 UINT64 RefreshFramePhysicalAddress;
1418 UINT64 WatchdogControlFramePhysicalAddress;
1419 UINT32 WatchdogTimerGSIV;
1420 UINT32 WatchdogTimerFlags;
1421} EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;
1422
1423///
1424/// SBSA Generic Watchdog Timer Flags. All other bits are reserved and must be 0.
1425///
1426#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE BIT0
1427#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY BIT1
1428#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER BIT2
1429
1430//
1431// NVDIMM Firmware Interface Table definition.
1432//
1433typedef struct {
1434 EFI_ACPI_DESCRIPTION_HEADER Header;
1435 UINT32 Reserved;
1436} EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE;
1437
1438//
1439// NFIT Version (as defined in ACPI 6.3 spec.)
1440//
1441#define EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1
1442
1443//
1444// Definition for NFIT Table Structure Types
1445//
1446#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE 0
1447#define EFI_ACPI_6_3_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE_TYPE 1
1448#define EFI_ACPI_6_3_NFIT_INTERLEAVE_STRUCTURE_TYPE 2
1449#define EFI_ACPI_6_3_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE 3
1450#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE 4
1451#define EFI_ACPI_6_3_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE 5
1452#define EFI_ACPI_6_3_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE 6
1453#define EFI_ACPI_6_3_NFIT_PLATFORM_CAPABILITIES_STRUCTURE_TYPE 7
1454
1455//
1456// Definition for NFIT Structure Header
1457//
1458typedef struct {
1459 UINT16 Type;
1460 UINT16 Length;
1461} EFI_ACPI_6_3_NFIT_STRUCTURE_HEADER;
1462
1463//
1464// Definition for System Physical Address Range Structure
1465//
1466#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT BIT0
1467#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID BIT1
1468#define EFI_ACPI_6_3_NFIT_GUID_VOLATILE_MEMORY_REGION { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}
1469#define EFI_ACPI_6_3_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}
1470#define EFI_ACPI_6_3_NFIT_GUID_NVDIMM_CONTROL_REGION { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}
1471#define EFI_ACPI_6_3_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}
1472#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}
1473#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}
1474#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}
1475#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}
1476typedef struct {
1477 UINT16 Type;
1478 UINT16 Length;
1479 UINT16 SPARangeStructureIndex;
1480 UINT16 Flags;
1481 UINT32 Reserved_8;
1482 UINT32 ProximityDomain;
1483 GUID AddressRangeTypeGUID;
1484 UINT64 SystemPhysicalAddressRangeBase;
1485 UINT64 SystemPhysicalAddressRangeLength;
1486 UINT64 AddressRangeMemoryMappingAttribute;
1487} EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;
1488
1489//
1490// Definition for Memory Device to System Physical Address Range Mapping Structure
1491//
1492typedef struct {
1493 UINT32 DIMMNumber : 4;
1494 UINT32 MemoryChannelNumber : 4;
1495 UINT32 MemoryControllerID : 4;
1496 UINT32 SocketID : 4;
1497 UINT32 NodeControllerID : 12;
1498 UINT32 Reserved_28 : 4;
1499} EFI_ACPI_6_3_NFIT_DEVICE_HANDLE;
1500
1501#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL BIT0
1502#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL BIT1
1503#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL BIT2
1504#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF BIT3
1505#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF BIT4
1506#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS BIT5
1507#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_NOT_MAP_NVDIMM_TO_SPA BIT6
1508typedef struct {
1509 UINT16 Type;
1510 UINT16 Length;
1511 EFI_ACPI_6_3_NFIT_DEVICE_HANDLE NFITDeviceHandle;
1512 UINT16 NVDIMMPhysicalID;
1513 UINT16 NVDIMMRegionID;
1514 UINT16 SPARangeStructureIndex;
1515 UINT16 NVDIMMControlRegionStructureIndex;
1516 UINT64 NVDIMMRegionSize;
1517 UINT64 RegionOffset;
1518 UINT64 NVDIMMPhysicalAddressRegionBase;
1519 UINT16 InterleaveStructureIndex;
1520 UINT16 InterleaveWays;
1521 UINT16 NVDIMMStateFlags;
1522 UINT16 Reserved_46;
1523} EFI_ACPI_6_3_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE;
1524
1525//
1526// Definition for Interleave Structure
1527//
1528typedef struct {
1529 UINT16 Type;
1530 UINT16 Length;
1531 UINT16 InterleaveStructureIndex;
1532 UINT16 Reserved_6;
1533 UINT32 NumberOfLines;
1534 UINT32 LineSize;
1535 // UINT32 LineOffset[NumberOfLines];
1536} EFI_ACPI_6_3_NFIT_INTERLEAVE_STRUCTURE;
1537
1538//
1539// Definition for SMBIOS Management Information Structure
1540//
1541typedef struct {
1542 UINT16 Type;
1543 UINT16 Length;
1544 UINT32 Reserved_4;
1545 // UINT8 Data[];
1546} EFI_ACPI_6_3_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;
1547
1548//
1549// Definition for NVDIMM Control Region Structure
1550//
1551#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_VALID_FIELDS_MANUFACTURING BIT0
1552
1553#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED BIT0
1554typedef struct {
1555 UINT16 Type;
1556 UINT16 Length;
1557 UINT16 NVDIMMControlRegionStructureIndex;
1558 UINT16 VendorID;
1559 UINT16 DeviceID;
1560 UINT16 RevisionID;
1561 UINT16 SubsystemVendorID;
1562 UINT16 SubsystemDeviceID;
1563 UINT16 SubsystemRevisionID;
1564 UINT8 ValidFields;
1565 UINT8 ManufacturingLocation;
1566 UINT16 ManufacturingDate;
1567 UINT8 Reserved_22[2];
1568 UINT32 SerialNumber;
1569 UINT16 RegionFormatInterfaceCode;
1570 UINT16 NumberOfBlockControlWindows;
1571 UINT64 SizeOfBlockControlWindow;
1572 UINT64 CommandRegisterOffsetInBlockControlWindow;
1573 UINT64 SizeOfCommandRegisterInBlockControlWindows;
1574 UINT64 StatusRegisterOffsetInBlockControlWindow;
1575 UINT64 SizeOfStatusRegisterInBlockControlWindows;
1576 UINT16 NVDIMMControlRegionFlag;
1577 UINT8 Reserved_74[6];
1578} EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;
1579
1580//
1581// Definition for NVDIMM Block Data Window Region Structure
1582//
1583typedef struct {
1584 UINT16 Type;
1585 UINT16 Length;
1586 UINT16 NVDIMMControlRegionStructureIndex;
1587 UINT16 NumberOfBlockDataWindows;
1588 UINT64 BlockDataWindowStartOffset;
1589 UINT64 SizeOfBlockDataWindow;
1590 UINT64 BlockAccessibleMemoryCapacity;
1591 UINT64 BeginningAddressOfFirstBlockInBlockAccessibleMemory;
1592} EFI_ACPI_6_3_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;
1593
1594//
1595// Definition for Flush Hint Address Structure
1596//
1597typedef struct {
1598 UINT16 Type;
1599 UINT16 Length;
1600 EFI_ACPI_6_3_NFIT_DEVICE_HANDLE NFITDeviceHandle;
1601 UINT16 NumberOfFlushHintAddresses;
1602 UINT8 Reserved_10[6];
1603 // UINT64 FlushHintAddress[NumberOfFlushHintAddresses];
1604} EFI_ACPI_6_3_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;
1605
1606//
1607// Definition for Platform Capabilities Structure
1608//
1609typedef struct {
1610 UINT16 Type;
1611 UINT16 Length;
1612 UINT8 HighestValidCapability;
1613 UINT8 Reserved_5[3];
1614 UINT32 Capabilities;
1615 UINT8 Reserved_12[4];
1616} EFI_ACPI_6_3_NFIT_PLATFORM_CAPABILITIES_STRUCTURE;
1617
1618#define EFI_ACPI_6_3_NFIT_PLATFORM_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT0
1619#define EFI_ACPI_6_3_NFIT_PLATFORM_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS BIT1
1620#define EFI_ACPI_6_3_NFIT_PLATFORM_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING BIT2
1621
1622///
1623/// Secure DEVices Table (SDEV)
1624///
1625typedef struct {
1626 EFI_ACPI_DESCRIPTION_HEADER Header;
1627} EFI_ACPI_6_3_SECURE_DEVICES_TABLE_HEADER;
1628
1629///
1630/// SDEV Revision (as defined in ACPI 6.3 spec.)
1631///
1632#define EFI_ACPI_6_3_SECURE_DEVICES_TABLE_REVISION 0x01
1633
1634///
1635/// Secure Devcice types
1636///
1637#define EFI_ACPI_6_3_SDEV_TYPE_PCIE_ENDPOINT_DEVICE 0x01
1638#define EFI_ACPI_6_3_SDEV_TYPE_ACPI_NAMESPACE_DEVICE 0x00
1639
1640///
1641/// Secure Devcice flags
1642///
1643#define EFI_ACPI_6_3_SDEV_FLAG_ALLOW_HANDOFF BIT0
1644
1645///
1646/// SDEV Structure Header
1647///
1648typedef struct {
1649 UINT8 Type;
1650 UINT8 Flags;
1651 UINT16 Length;
1652} EFI_ACPI_6_3_SDEV_STRUCTURE_HEADER;
1653
1654///
1655/// PCIe Endpoint Device based Secure Device Structure
1656///
1657typedef struct {
1658 UINT8 Type;
1659 UINT8 Flags;
1660 UINT16 Length;
1661 UINT16 PciSegmentNumber;
1662 UINT16 StartBusNumber;
1663 UINT16 PciPathOffset;
1664 UINT16 PciPathLength;
1665 UINT16 VendorSpecificDataOffset;
1666 UINT16 VendorSpecificDataLength;
1667} EFI_ACPI_6_3_SDEV_STRUCTURE_PCIE_ENDPOINT_DEVICE;
1668
1669///
1670/// ACPI_NAMESPACE_DEVICE based Secure Device Structure
1671///
1672typedef struct {
1673 UINT8 Type;
1674 UINT8 Flags;
1675 UINT16 Length;
1676 UINT16 DeviceIdentifierOffset;
1677 UINT16 DeviceIdentifierLength;
1678 UINT16 VendorSpecificDataOffset;
1679 UINT16 VendorSpecificDataLength;
1680} EFI_ACPI_6_3_SDEV_STRUCTURE_ACPI_NAMESPACE_DEVICE;
1681
1682///
1683/// Boot Error Record Table (BERT)
1684///
1685typedef struct {
1686 EFI_ACPI_DESCRIPTION_HEADER Header;
1687 UINT32 BootErrorRegionLength;
1688 UINT64 BootErrorRegion;
1689} EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_HEADER;
1690
1691///
1692/// BERT Version (as defined in ACPI 6.3 spec.)
1693///
1694#define EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_REVISION 0x01
1695
1696///
1697/// Boot Error Region Block Status Definition
1698///
1699typedef struct {
1700 UINT32 UncorrectableErrorValid : 1;
1701 UINT32 CorrectableErrorValid : 1;
1702 UINT32 MultipleUncorrectableErrors : 1;
1703 UINT32 MultipleCorrectableErrors : 1;
1704 UINT32 ErrorDataEntryCount : 10;
1705 UINT32 Reserved : 18;
1706} EFI_ACPI_6_3_ERROR_BLOCK_STATUS;
1707
1708///
1709/// Boot Error Region Definition
1710///
1711typedef struct {
1712 EFI_ACPI_6_3_ERROR_BLOCK_STATUS BlockStatus;
1713 UINT32 RawDataOffset;
1714 UINT32 RawDataLength;
1715 UINT32 DataLength;
1716 UINT32 ErrorSeverity;
1717} EFI_ACPI_6_3_BOOT_ERROR_REGION_STRUCTURE;
1718
1719//
1720// Boot Error Severity types
1721//
1722#define EFI_ACPI_6_3_ERROR_SEVERITY_RECOVERABLE 0x00
1723#define EFI_ACPI_6_3_ERROR_SEVERITY_FATAL 0x01
1724#define EFI_ACPI_6_3_ERROR_SEVERITY_CORRECTED 0x02
1725#define EFI_ACPI_6_3_ERROR_SEVERITY_NONE 0x03
1726//
1727// The term 'Correctable' is no longer being used as an error severity of the
1728// reported error since ACPI Specification Version 5.1 Errata B.
1729// The below macro is considered as deprecated and should no longer be used.
1730//
1731#define EFI_ACPI_6_3_ERROR_SEVERITY_CORRECTABLE 0x00
1732
1733///
1734/// Generic Error Data Entry Definition
1735///
1736typedef struct {
1737 UINT8 SectionType[16];
1738 UINT32 ErrorSeverity;
1739 UINT16 Revision;
1740 UINT8 ValidationBits;
1741 UINT8 Flags;
1742 UINT32 ErrorDataLength;
1743 UINT8 FruId[16];
1744 UINT8 FruText[20];
1745 UINT8 Timestamp[8];
1746} EFI_ACPI_6_3_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;
1747
1748///
1749/// Generic Error Data Entry Version (as defined in ACPI 6.3 spec.)
1750///
1751#define EFI_ACPI_6_3_GENERIC_ERROR_DATA_ENTRY_REVISION 0x0300
1752
1753///
1754/// HEST - Hardware Error Source Table
1755///
1756typedef struct {
1757 EFI_ACPI_DESCRIPTION_HEADER Header;
1758 UINT32 ErrorSourceCount;
1759} EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_HEADER;
1760
1761///
1762/// HEST Version (as defined in ACPI 6.3 spec.)
1763///
1764#define EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01
1765
1766//
1767// Error Source structure types.
1768//
1769#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION 0x00
1770#define EFI_ACPI_6_3_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK 0x01
1771#define EFI_ACPI_6_3_IA32_ARCHITECTURE_NMI_ERROR 0x02
1772#define EFI_ACPI_6_3_PCI_EXPRESS_ROOT_PORT_AER 0x06
1773#define EFI_ACPI_6_3_PCI_EXPRESS_DEVICE_AER 0x07
1774#define EFI_ACPI_6_3_PCI_EXPRESS_BRIDGE_AER 0x08
1775#define EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR 0x09
1776#define EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_VERSION_2 0x0A
1777#define EFI_ACPI_6_3_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK 0x0B
1778
1779//
1780// Error Source structure flags.
1781//
1782#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_FIRMWARE_FIRST (1 << 0)
1783#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_GLOBAL (1 << 1)
1784#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_GHES_ASSIST (1 << 2)
1785
1786///
1787/// IA-32 Architecture Machine Check Exception Structure Definition
1788///
1789typedef struct {
1790 UINT16 Type;
1791 UINT16 SourceId;
1792 UINT8 Reserved0[2];
1793 UINT8 Flags;
1794 UINT8 Enabled;
1795 UINT32 NumberOfRecordsToPreAllocate;
1796 UINT32 MaxSectionsPerRecord;
1797 UINT64 GlobalCapabilityInitData;
1798 UINT64 GlobalControlInitData;
1799 UINT8 NumberOfHardwareBanks;
1800 UINT8 Reserved1[7];
1801} EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;
1802
1803///
1804/// IA-32 Architecture Machine Check Bank Structure Definition
1805///
1806typedef struct {
1807 UINT8 BankNumber;
1808 UINT8 ClearStatusOnInitialization;
1809 UINT8 StatusDataFormat;
1810 UINT8 Reserved0;
1811 UINT32 ControlRegisterMsrAddress;
1812 UINT64 ControlInitData;
1813 UINT32 StatusRegisterMsrAddress;
1814 UINT32 AddressRegisterMsrAddress;
1815 UINT32 MiscRegisterMsrAddress;
1816} EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;
1817
1818///
1819/// IA-32 Architecture Machine Check Bank Structure MCA data format
1820///
1821#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32 0x00
1822#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64 0x01
1823#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64 0x02
1824
1825//
1826// Hardware Error Notification types. All other values are reserved
1827//
1828#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_POLLED 0x00
1829#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT 0x01
1830#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT 0x02
1831#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_SCI 0x03
1832#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_NMI 0x04
1833#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CMCI 0x05
1834#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_MCE 0x06
1835#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL 0x07
1836#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEA 0x08
1837#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEI 0x09
1838#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_GSIV 0x0A
1839#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_SOFTWARE_DELEGATED_EXCEPTION 0x0B
1840
1841///
1842/// Hardware Error Notification Configuration Write Enable Structure Definition
1843///
1844typedef struct {
1845 UINT16 Type : 1;
1846 UINT16 PollInterval : 1;
1847 UINT16 SwitchToPollingThresholdValue : 1;
1848 UINT16 SwitchToPollingThresholdWindow : 1;
1849 UINT16 ErrorThresholdValue : 1;
1850 UINT16 ErrorThresholdWindow : 1;
1851 UINT16 Reserved : 10;
1852} EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;
1853
1854///
1855/// Hardware Error Notification Structure Definition
1856///
1857typedef struct {
1858 UINT8 Type;
1859 UINT8 Length;
1860 EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE ConfigurationWriteEnable;
1861 UINT32 PollInterval;
1862 UINT32 Vector;
1863 UINT32 SwitchToPollingThresholdValue;
1864 UINT32 SwitchToPollingThresholdWindow;
1865 UINT32 ErrorThresholdValue;
1866 UINT32 ErrorThresholdWindow;
1867} EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;
1868
1869///
1870/// IA-32 Architecture Corrected Machine Check Structure Definition
1871///
1872typedef struct {
1873 UINT16 Type;
1874 UINT16 SourceId;
1875 UINT8 Reserved0[2];
1876 UINT8 Flags;
1877 UINT8 Enabled;
1878 UINT32 NumberOfRecordsToPreAllocate;
1879 UINT32 MaxSectionsPerRecord;
1880 EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
1881 UINT8 NumberOfHardwareBanks;
1882 UINT8 Reserved1[3];
1883} EFI_ACPI_6_3_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;
1884
1885///
1886/// IA-32 Architecture NMI Error Structure Definition
1887///
1888typedef struct {
1889 UINT16 Type;
1890 UINT16 SourceId;
1891 UINT8 Reserved0[2];
1892 UINT32 NumberOfRecordsToPreAllocate;
1893 UINT32 MaxSectionsPerRecord;
1894 UINT32 MaxRawDataLength;
1895} EFI_ACPI_6_3_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;
1896
1897///
1898/// PCI Express Root Port AER Structure Definition
1899///
1900typedef struct {
1901 UINT16 Type;
1902 UINT16 SourceId;
1903 UINT8 Reserved0[2];
1904 UINT8 Flags;
1905 UINT8 Enabled;
1906 UINT32 NumberOfRecordsToPreAllocate;
1907 UINT32 MaxSectionsPerRecord;
1908 UINT32 Bus;
1909 UINT16 Device;
1910 UINT16 Function;
1911 UINT16 DeviceControl;
1912 UINT8 Reserved1[2];
1913 UINT32 UncorrectableErrorMask;
1914 UINT32 UncorrectableErrorSeverity;
1915 UINT32 CorrectableErrorMask;
1916 UINT32 AdvancedErrorCapabilitiesAndControl;
1917 UINT32 RootErrorCommand;
1918} EFI_ACPI_6_3_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;
1919
1920///
1921/// PCI Express Device AER Structure Definition
1922///
1923typedef struct {
1924 UINT16 Type;
1925 UINT16 SourceId;
1926 UINT8 Reserved0[2];
1927 UINT8 Flags;
1928 UINT8 Enabled;
1929 UINT32 NumberOfRecordsToPreAllocate;
1930 UINT32 MaxSectionsPerRecord;
1931 UINT32 Bus;
1932 UINT16 Device;
1933 UINT16 Function;
1934 UINT16 DeviceControl;
1935 UINT8 Reserved1[2];
1936 UINT32 UncorrectableErrorMask;
1937 UINT32 UncorrectableErrorSeverity;
1938 UINT32 CorrectableErrorMask;
1939 UINT32 AdvancedErrorCapabilitiesAndControl;
1940} EFI_ACPI_6_3_PCI_EXPRESS_DEVICE_AER_STRUCTURE;
1941
1942///
1943/// PCI Express Bridge AER Structure Definition
1944///
1945typedef struct {
1946 UINT16 Type;
1947 UINT16 SourceId;
1948 UINT8 Reserved0[2];
1949 UINT8 Flags;
1950 UINT8 Enabled;
1951 UINT32 NumberOfRecordsToPreAllocate;
1952 UINT32 MaxSectionsPerRecord;
1953 UINT32 Bus;
1954 UINT16 Device;
1955 UINT16 Function;
1956 UINT16 DeviceControl;
1957 UINT8 Reserved1[2];
1958 UINT32 UncorrectableErrorMask;
1959 UINT32 UncorrectableErrorSeverity;
1960 UINT32 CorrectableErrorMask;
1961 UINT32 AdvancedErrorCapabilitiesAndControl;
1962 UINT32 SecondaryUncorrectableErrorMask;
1963 UINT32 SecondaryUncorrectableErrorSeverity;
1964 UINT32 SecondaryAdvancedErrorCapabilitiesAndControl;
1965} EFI_ACPI_6_3_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;
1966
1967///
1968/// Generic Hardware Error Source Structure Definition
1969///
1970typedef struct {
1971 UINT16 Type;
1972 UINT16 SourceId;
1973 UINT16 RelatedSourceId;
1974 UINT8 Flags;
1975 UINT8 Enabled;
1976 UINT32 NumberOfRecordsToPreAllocate;
1977 UINT32 MaxSectionsPerRecord;
1978 UINT32 MaxRawDataLength;
1979 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE ErrorStatusAddress;
1980 EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
1981 UINT32 ErrorStatusBlockLength;
1982} EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;
1983
1984///
1985/// Generic Hardware Error Source Version 2 Structure Definition
1986///
1987typedef struct {
1988 UINT16 Type;
1989 UINT16 SourceId;
1990 UINT16 RelatedSourceId;
1991 UINT8 Flags;
1992 UINT8 Enabled;
1993 UINT32 NumberOfRecordsToPreAllocate;
1994 UINT32 MaxSectionsPerRecord;
1995 UINT32 MaxRawDataLength;
1996 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE ErrorStatusAddress;
1997 EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
1998 UINT32 ErrorStatusBlockLength;
1999 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE ReadAckRegister;
2000 UINT64 ReadAckPreserve;
2001 UINT64 ReadAckWrite;
2002} EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_SOURCE_VERSION_2_STRUCTURE;
2003
2004///
2005/// Generic Error Status Definition
2006///
2007typedef struct {
2008 EFI_ACPI_6_3_ERROR_BLOCK_STATUS BlockStatus;
2009 UINT32 RawDataOffset;
2010 UINT32 RawDataLength;
2011 UINT32 DataLength;
2012 UINT32 ErrorSeverity;
2013} EFI_ACPI_6_3_GENERIC_ERROR_STATUS_STRUCTURE;
2014
2015///
2016/// IA-32 Architecture Deferred Machine Check Structure Definition
2017///
2018typedef struct {
2019 UINT16 Type;
2020 UINT16 SourceId;
2021 UINT8 Reserved0[2];
2022 UINT8 Flags;
2023 UINT8 Enabled;
2024 UINT32 NumberOfRecordsToPreAllocate;
2025 UINT32 MaxSectionsPerRecord;
2026 EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE NotificationStructure;
2027 UINT8 NumberOfHardwareBanks;
2028 UINT8 Reserved1[3];
2029} EFI_ACPI_6_3_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK_STRUCTURE;
2030
2031///
2032/// HMAT - Heterogeneous Memory Attribute Table
2033///
2034typedef struct {
2035 EFI_ACPI_DESCRIPTION_HEADER Header;
2036 UINT8 Reserved[4];
2037} EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_HEADER;
2038
2039///
2040/// HMAT Revision (as defined in ACPI 6.3 spec.)
2041///
2042#define EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_REVISION 0x02
2043
2044///
2045/// HMAT types
2046///
2047#define EFI_ACPI_6_3_HMAT_TYPE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES 0x00
2048#define EFI_ACPI_6_3_HMAT_TYPE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO 0x01
2049#define EFI_ACPI_6_3_HMAT_TYPE_MEMORY_SIDE_CACHE_INFO 0x02
2050
2051///
2052/// HMAT Structure Header
2053///
2054typedef struct {
2055 UINT16 Type;
2056 UINT8 Reserved[2];
2057 UINT32 Length;
2058} EFI_ACPI_6_3_HMAT_STRUCTURE_HEADER;
2059
2060///
2061/// Memory Proximity Domain Attributes Structure flags
2062///
2063typedef struct {
2064 UINT16 InitiatorProximityDomainValid : 1;
2065 UINT16 Reserved : 15;
2066} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES_FLAGS;
2067
2068///
2069/// Memory Proximity Domain Attributes Structure
2070///
2071typedef struct {
2072 UINT16 Type;
2073 UINT8 Reserved[2];
2074 UINT32 Length;
2075 EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES_FLAGS Flags;
2076 UINT8 Reserved1[2];
2077 UINT32 InitiatorProximityDomain;
2078 UINT32 MemoryProximityDomain;
2079 UINT8 Reserved2[20];
2080} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES;
2081
2082///
2083/// System Locality Latency and Bandwidth Information Structure flags
2084///
2085typedef struct {
2086 UINT8 MemoryHierarchy : 4;
2087 UINT8 Reserved : 4;
2088} EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS;
2089
2090///
2091/// System Locality Latency and Bandwidth Information Structure
2092///
2093typedef struct {
2094 UINT16 Type;
2095 UINT8 Reserved[2];
2096 UINT32 Length;
2097 EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS Flags;
2098 UINT8 DataType;
2099 UINT8 Reserved1[2];
2100 UINT32 NumberOfInitiatorProximityDomains;
2101 UINT32 NumberOfTargetProximityDomains;
2102 UINT8 Reserved2[4];
2103 UINT64 EntryBaseUnit;
2104} EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO;
2105
2106///
2107/// Memory Side Cache Information Structure cache attributes
2108///
2109typedef struct {
2110 UINT32 TotalCacheLevels : 4;
2111 UINT32 CacheLevel : 4;
2112 UINT32 CacheAssociativity : 4;
2113 UINT32 WritePolicy : 4;
2114 UINT32 CacheLineSize : 16;
2115} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES;
2116
2117///
2118/// Memory Side Cache Information Structure
2119///
2120typedef struct {
2121 UINT16 Type;
2122 UINT8 Reserved[2];
2123 UINT32 Length;
2124 UINT32 MemoryProximityDomain;
2125 UINT8 Reserved1[4];
2126 UINT64 MemorySideCacheSize;
2127 EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES CacheAttributes;
2128 UINT8 Reserved2[2];
2129 UINT16 NumberOfSmbiosHandles;
2130} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO;
2131
2132///
2133/// ERST - Error Record Serialization Table
2134///
2135typedef struct {
2136 EFI_ACPI_DESCRIPTION_HEADER Header;
2137 UINT32 SerializationHeaderSize;
2138 UINT8 Reserved0[4];
2139 UINT32 InstructionEntryCount;
2140} EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;
2141
2142///
2143/// ERST Version (as defined in ACPI 6.3 spec.)
2144///
2145#define EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01
2146
2147///
2148/// ERST Serialization Actions
2149///
2150#define EFI_ACPI_6_3_ERST_BEGIN_WRITE_OPERATION 0x00
2151#define EFI_ACPI_6_3_ERST_BEGIN_READ_OPERATION 0x01
2152#define EFI_ACPI_6_3_ERST_BEGIN_CLEAR_OPERATION 0x02
2153#define EFI_ACPI_6_3_ERST_END_OPERATION 0x03
2154#define EFI_ACPI_6_3_ERST_SET_RECORD_OFFSET 0x04
2155#define EFI_ACPI_6_3_ERST_EXECUTE_OPERATION 0x05
2156#define EFI_ACPI_6_3_ERST_CHECK_BUSY_STATUS 0x06
2157#define EFI_ACPI_6_3_ERST_GET_COMMAND_STATUS 0x07
2158#define EFI_ACPI_6_3_ERST_GET_RECORD_IDENTIFIER 0x08
2159#define EFI_ACPI_6_3_ERST_SET_RECORD_IDENTIFIER 0x09
2160#define EFI_ACPI_6_3_ERST_GET_RECORD_COUNT 0x0A
2161#define EFI_ACPI_6_3_ERST_BEGIN_DUMMY_WRITE_OPERATION 0x0B
2162#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE 0x0D
2163#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH 0x0E
2164#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES 0x0F
2165#define EFI_ACPI_6_3_ERST_GET_EXECUTE_OPERATION_TIMINGS 0x10
2166
2167///
2168/// ERST Action Command Status
2169///
2170#define EFI_ACPI_6_3_ERST_STATUS_SUCCESS 0x00
2171#define EFI_ACPI_6_3_ERST_STATUS_NOT_ENOUGH_SPACE 0x01
2172#define EFI_ACPI_6_3_ERST_STATUS_HARDWARE_NOT_AVAILABLE 0x02
2173#define EFI_ACPI_6_3_ERST_STATUS_FAILED 0x03
2174#define EFI_ACPI_6_3_ERST_STATUS_RECORD_STORE_EMPTY 0x04
2175#define EFI_ACPI_6_3_ERST_STATUS_RECORD_NOT_FOUND 0x05
2176
2177///
2178/// ERST Serialization Instructions
2179///
2180#define EFI_ACPI_6_3_ERST_READ_REGISTER 0x00
2181#define EFI_ACPI_6_3_ERST_READ_REGISTER_VALUE 0x01
2182#define EFI_ACPI_6_3_ERST_WRITE_REGISTER 0x02
2183#define EFI_ACPI_6_3_ERST_WRITE_REGISTER_VALUE 0x03
2184#define EFI_ACPI_6_3_ERST_NOOP 0x04
2185#define EFI_ACPI_6_3_ERST_LOAD_VAR1 0x05
2186#define EFI_ACPI_6_3_ERST_LOAD_VAR2 0x06
2187#define EFI_ACPI_6_3_ERST_STORE_VAR1 0x07
2188#define EFI_ACPI_6_3_ERST_ADD 0x08
2189#define EFI_ACPI_6_3_ERST_SUBTRACT 0x09
2190#define EFI_ACPI_6_3_ERST_ADD_VALUE 0x0A
2191#define EFI_ACPI_6_3_ERST_SUBTRACT_VALUE 0x0B
2192#define EFI_ACPI_6_3_ERST_STALL 0x0C
2193#define EFI_ACPI_6_3_ERST_STALL_WHILE_TRUE 0x0D
2194#define EFI_ACPI_6_3_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE 0x0E
2195#define EFI_ACPI_6_3_ERST_GOTO 0x0F
2196#define EFI_ACPI_6_3_ERST_SET_SRC_ADDRESS_BASE 0x10
2197#define EFI_ACPI_6_3_ERST_SET_DST_ADDRESS_BASE 0x11
2198#define EFI_ACPI_6_3_ERST_MOVE_DATA 0x12
2199
2200///
2201/// ERST Instruction Flags
2202///
2203#define EFI_ACPI_6_3_ERST_PRESERVE_REGISTER 0x01
2204
2205///
2206/// ERST Serialization Instruction Entry
2207///
2208typedef struct {
2209 UINT8 SerializationAction;
2210 UINT8 Instruction;
2211 UINT8 Flags;
2212 UINT8 Reserved0;
2213 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE RegisterRegion;
2214 UINT64 Value;
2215 UINT64 Mask;
2216} EFI_ACPI_6_3_ERST_SERIALIZATION_INSTRUCTION_ENTRY;
2217
2218///
2219/// EINJ - Error Injection Table
2220///
2221typedef struct {
2222 EFI_ACPI_DESCRIPTION_HEADER Header;
2223 UINT32 InjectionHeaderSize;
2224 UINT8 InjectionFlags;
2225 UINT8 Reserved0[3];
2226 UINT32 InjectionEntryCount;
2227} EFI_ACPI_6_3_ERROR_INJECTION_TABLE_HEADER;
2228
2229///
2230/// EINJ Version (as defined in ACPI 6.3 spec.)
2231///
2232#define EFI_ACPI_6_3_ERROR_INJECTION_TABLE_REVISION 0x01
2233
2234///
2235/// EINJ Error Injection Actions
2236///
2237#define EFI_ACPI_6_3_EINJ_BEGIN_INJECTION_OPERATION 0x00
2238#define EFI_ACPI_6_3_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE 0x01
2239#define EFI_ACPI_6_3_EINJ_SET_ERROR_TYPE 0x02
2240#define EFI_ACPI_6_3_EINJ_GET_ERROR_TYPE 0x03
2241#define EFI_ACPI_6_3_EINJ_END_OPERATION 0x04
2242#define EFI_ACPI_6_3_EINJ_EXECUTE_OPERATION 0x05
2243#define EFI_ACPI_6_3_EINJ_CHECK_BUSY_STATUS 0x06
2244#define EFI_ACPI_6_3_EINJ_GET_COMMAND_STATUS 0x07
2245#define EFI_ACPI_6_3_EINJ_TRIGGER_ERROR 0xFF
2246
2247///
2248/// EINJ Action Command Status
2249///
2250#define EFI_ACPI_6_3_EINJ_STATUS_SUCCESS 0x00
2251#define EFI_ACPI_6_3_EINJ_STATUS_UNKNOWN_FAILURE 0x01
2252#define EFI_ACPI_6_3_EINJ_STATUS_INVALID_ACCESS 0x02
2253
2254///
2255/// EINJ Error Type Definition
2256///
2257#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_CORRECTABLE (1 << 0)
2258#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL (1 << 1)
2259#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL (1 << 2)
2260#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_CORRECTABLE (1 << 3)
2261#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL (1 << 4)
2262#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL (1 << 5)
2263#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE (1 << 6)
2264#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL (1 << 7)
2265#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL (1 << 8)
2266#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_CORRECTABLE (1 << 9)
2267#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL (1 << 10)
2268#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL (1 << 11)
2269
2270///
2271/// EINJ Injection Instructions
2272///
2273#define EFI_ACPI_6_3_EINJ_READ_REGISTER 0x00
2274#define EFI_ACPI_6_3_EINJ_READ_REGISTER_VALUE 0x01
2275#define EFI_ACPI_6_3_EINJ_WRITE_REGISTER 0x02
2276#define EFI_ACPI_6_3_EINJ_WRITE_REGISTER_VALUE 0x03
2277#define EFI_ACPI_6_3_EINJ_NOOP 0x04
2278
2279///
2280/// EINJ Instruction Flags
2281///
2282#define EFI_ACPI_6_3_EINJ_PRESERVE_REGISTER 0x01
2283
2284///
2285/// EINJ Injection Instruction Entry
2286///
2287typedef struct {
2288 UINT8 InjectionAction;
2289 UINT8 Instruction;
2290 UINT8 Flags;
2291 UINT8 Reserved0;
2292 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE RegisterRegion;
2293 UINT64 Value;
2294 UINT64 Mask;
2295} EFI_ACPI_6_3_EINJ_INJECTION_INSTRUCTION_ENTRY;
2296
2297///
2298/// EINJ Trigger Action Table
2299///
2300typedef struct {
2301 UINT32 HeaderSize;
2302 UINT32 Revision;
2303 UINT32 TableSize;
2304 UINT32 EntryCount;
2305} EFI_ACPI_6_3_EINJ_TRIGGER_ACTION_TABLE;
2306
2307///
2308/// Platform Communications Channel Table (PCCT)
2309///
2310typedef struct {
2311 EFI_ACPI_DESCRIPTION_HEADER Header;
2312 UINT32 Flags;
2313 UINT64 Reserved;
2314} EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;
2315
2316///
2317/// PCCT Version (as defined in ACPI 6.3 spec.)
2318///
2319#define EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x02
2320
2321///
2322/// PCCT Global Flags
2323///
2324#define EFI_ACPI_6_3_PCCT_FLAGS_PLATFORM_INTERRUPT BIT0
2325
2326//
2327// PCCT Subspace type
2328//
2329#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_GENERIC 0x00
2330#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS 0x01
2331#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS 0x02
2332#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_3_EXTENDED_PCC 0x03
2333#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_4_EXTENDED_PCC 0x04
2334
2335///
2336/// PCC Subspace Structure Header
2337///
2338typedef struct {
2339 UINT8 Type;
2340 UINT8 Length;
2341} EFI_ACPI_6_3_PCCT_SUBSPACE_HEADER;
2342
2343///
2344/// Generic Communications Subspace Structure
2345///
2346typedef struct {
2347 UINT8 Type;
2348 UINT8 Length;
2349 UINT8 Reserved[6];
2350 UINT64 BaseAddress;
2351 UINT64 AddressLength;
2352 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2353 UINT64 DoorbellPreserve;
2354 UINT64 DoorbellWrite;
2355 UINT32 NominalLatency;
2356 UINT32 MaximumPeriodicAccessRate;
2357 UINT16 MinimumRequestTurnaroundTime;
2358} EFI_ACPI_6_3_PCCT_SUBSPACE_GENERIC;
2359
2360///
2361/// Generic Communications Channel Shared Memory Region
2362///
2363
2364typedef struct {
2365 UINT8 Command;
2366 UINT8 Reserved : 7;
2367 UINT8 NotifyOnCompletion : 1;
2368} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;
2369
2370typedef struct {
2371 UINT8 CommandComplete : 1;
2372 UINT8 PlatformInterrupt : 1;
2373 UINT8 Error : 1;
2374 UINT8 PlatformNotification : 1;
2375 UINT8 Reserved : 4;
2376 UINT8 Reserved1;
2377} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;
2378
2379typedef struct {
2380 UINT32 Signature;
2381 EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND Command;
2382 EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS Status;
2383} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;
2384
2385#define EFI_ACPI_6_3_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_POLARITY BIT0
2386#define EFI_ACPI_6_3_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_MODE BIT1
2387
2388///
2389/// Type 1 HW-Reduced Communications Subspace Structure
2390///
2391typedef struct {
2392 UINT8 Type;
2393 UINT8 Length;
2394 UINT32 PlatformInterrupt;
2395 UINT8 PlatformInterruptFlags;
2396 UINT8 Reserved;
2397 UINT64 BaseAddress;
2398 UINT64 AddressLength;
2399 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2400 UINT64 DoorbellPreserve;
2401 UINT64 DoorbellWrite;
2402 UINT32 NominalLatency;
2403 UINT32 MaximumPeriodicAccessRate;
2404 UINT16 MinimumRequestTurnaroundTime;
2405} EFI_ACPI_6_3_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;
2406
2407///
2408/// Type 2 HW-Reduced Communications Subspace Structure
2409///
2410typedef struct {
2411 UINT8 Type;
2412 UINT8 Length;
2413 UINT32 PlatformInterrupt;
2414 UINT8 PlatformInterruptFlags;
2415 UINT8 Reserved;
2416 UINT64 BaseAddress;
2417 UINT64 AddressLength;
2418 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2419 UINT64 DoorbellPreserve;
2420 UINT64 DoorbellWrite;
2421 UINT32 NominalLatency;
2422 UINT32 MaximumPeriodicAccessRate;
2423 UINT16 MinimumRequestTurnaroundTime;
2424 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE PlatformInterruptAckRegister;
2425 UINT64 PlatformInterruptAckPreserve;
2426 UINT64 PlatformInterruptAckWrite;
2427} EFI_ACPI_6_3_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;
2428
2429///
2430/// Type 3 Extended PCC Subspace Structure
2431///
2432typedef struct {
2433 UINT8 Type;
2434 UINT8 Length;
2435 UINT32 PlatformInterrupt;
2436 UINT8 PlatformInterruptFlags;
2437 UINT8 Reserved;
2438 UINT64 BaseAddress;
2439 UINT32 AddressLength;
2440 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE DoorbellRegister;
2441 UINT64 DoorbellPreserve;
2442 UINT64 DoorbellWrite;
2443 UINT32 NominalLatency;
2444 UINT32 MaximumPeriodicAccessRate;
2445 UINT32 MinimumRequestTurnaroundTime;
2446 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE PlatformInterruptAckRegister;
2447 UINT64 PlatformInterruptAckPreserve;
2448 UINT64 PlatformInterruptAckSet;
2449 UINT8 Reserved1[8];
2450 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE CommandCompleteCheckRegister;
2451 UINT64 CommandCompleteCheckMask;
2452 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE CommandCompleteUpdateRegister;
2453 UINT64 CommandCompleteUpdatePreserve;
2454 UINT64 CommandCompleteUpdateSet;
2455 EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE ErrorStatusRegister;
2456 UINT64 ErrorStatusMask;
2457} EFI_ACPI_6_3_PCCT_SUBSPACE_3_EXTENDED_PCC;
2458
2459///
2460/// Type 4 Extended PCC Subspace Structure
2461///
2462typedef EFI_ACPI_6_3_PCCT_SUBSPACE_3_EXTENDED_PCC EFI_ACPI_6_3_PCCT_SUBSPACE_4_EXTENDED_PCC;
2463
2464#define EFI_ACPI_6_3_PCCT_MASTER_SLAVE_COMMUNICATIONS_CHANNEL_FLAGS_NOTIFY_ON_COMPLETION BIT0
2465
2466typedef struct {
2467 UINT32 Signature;
2468 UINT32 Flags;
2469 UINT32 Length;
2470 UINT32 Command;
2471} EFI_ACPI_6_3_PCCT_EXTENDED_PCC_SHARED_MEMORY_REGION_HEADER;
2472
2473///
2474/// Platform Debug Trigger Table (PDTT)
2475///
2476typedef struct {
2477 EFI_ACPI_DESCRIPTION_HEADER Header;
2478 UINT8 TriggerCount;
2479 UINT8 Reserved[3];
2480 UINT32 TriggerIdentifierArrayOffset;
2481} EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_HEADER;
2482
2483///
2484/// PDTT Revision (as defined in ACPI 6.3 spec.)
2485///
2486#define EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_REVISION 0x00
2487
2488///
2489/// PDTT Platform Communication Channel Identifier Structure
2490///
2491typedef struct {
2492 UINT16 SubChannelIdentifer : 8;
2493 UINT16 Runtime : 1;
2494 UINT16 WaitForCompletion : 1;
2495 UINT16 TriggerOrder : 1;
2496 UINT16 Reserved : 5;
2497} EFI_ACPI_6_3_PDTT_PCC_IDENTIFIER;
2498
2499///
2500/// PCC Commands Codes used by Platform Debug Trigger Table
2501///
2502#define EFI_ACPI_6_3_PDTT_PCC_COMMAND_DOORBELL_ONLY 0x00
2503#define EFI_ACPI_6_3_PDTT_PCC_COMMAND_VENDOR_SPECIFIC 0x01
2504
2505///
2506/// PPTT Platform Communication Channel
2507///
2508typedef EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER EFI_ACPI_6_3_PDTT_PCC;
2509
2510///
2511/// Processor Properties Topology Table (PPTT)
2512///
2513typedef struct {
2514 EFI_ACPI_DESCRIPTION_HEADER Header;
2515} EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_HEADER;
2516
2517///
2518/// PPTT Revision (as defined in ACPI 6.3 spec.)
2519///
2520#define EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_REVISION 0x02
2521
2522///
2523/// PPTT types
2524///
2525#define EFI_ACPI_6_3_PPTT_TYPE_PROCESSOR 0x00
2526#define EFI_ACPI_6_3_PPTT_TYPE_CACHE 0x01
2527#define EFI_ACPI_6_3_PPTT_TYPE_ID 0x02
2528
2529///
2530/// PPTT Structure Header
2531///
2532typedef struct {
2533 UINT8 Type;
2534 UINT8 Length;
2535 UINT8 Reserved[2];
2536} EFI_ACPI_6_3_PPTT_STRUCTURE_HEADER;
2537
2538///
2539/// For PPTT struct processor flags
2540///
2541#define EFI_ACPI_6_3_PPTT_PACKAGE_NOT_PHYSICAL 0x0
2542#define EFI_ACPI_6_3_PPTT_PACKAGE_PHYSICAL 0x1
2543#define EFI_ACPI_6_3_PPTT_PROCESSOR_ID_INVALID 0x0
2544#define EFI_ACPI_6_3_PPTT_PROCESSOR_ID_VALID 0x1
2545#define EFI_ACPI_6_3_PPTT_PROCESSOR_IS_NOT_THREAD 0x0
2546#define EFI_ACPI_6_3_PPTT_PROCESSOR_IS_THREAD 0x1
2547#define EFI_ACPI_6_3_PPTT_NODE_IS_NOT_LEAF 0x0
2548#define EFI_ACPI_6_3_PPTT_NODE_IS_LEAF 0x1
2549#define EFI_ACPI_6_3_PPTT_IMPLEMENTATION_NOT_IDENTICAL 0x0
2550#define EFI_ACPI_6_3_PPTT_IMPLEMENTATION_IDENTICAL 0x1
2551
2552///
2553/// Processor hierarchy node structure flags
2554///
2555typedef struct {
2556 UINT32 PhysicalPackage : 1;
2557 UINT32 AcpiProcessorIdValid : 1;
2558 UINT32 ProcessorIsAThread : 1;
2559 UINT32 NodeIsALeaf : 1;
2560 UINT32 IdenticalImplementation : 1;
2561 UINT32 Reserved : 27;
2562} EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR_FLAGS;
2563
2564///
2565/// Processor hierarchy node structure
2566///
2567typedef struct {
2568 UINT8 Type;
2569 UINT8 Length;
2570 UINT8 Reserved[2];
2571 EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR_FLAGS Flags;
2572 UINT32 Parent;
2573 UINT32 AcpiProcessorId;
2574 UINT32 NumberOfPrivateResources;
2575} EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR;
2576
2577///
2578/// For PPTT struct cache flags
2579///
2580#define EFI_ACPI_6_3_PPTT_CACHE_SIZE_INVALID 0x0
2581#define EFI_ACPI_6_3_PPTT_CACHE_SIZE_VALID 0x1
2582#define EFI_ACPI_6_3_PPTT_NUMBER_OF_SETS_INVALID 0x0
2583#define EFI_ACPI_6_3_PPTT_NUMBER_OF_SETS_VALID 0x1
2584#define EFI_ACPI_6_3_PPTT_ASSOCIATIVITY_INVALID 0x0
2585#define EFI_ACPI_6_3_PPTT_ASSOCIATIVITY_VALID 0x1
2586#define EFI_ACPI_6_3_PPTT_ALLOCATION_TYPE_INVALID 0x0
2587#define EFI_ACPI_6_3_PPTT_ALLOCATION_TYPE_VALID 0x1
2588#define EFI_ACPI_6_3_PPTT_CACHE_TYPE_INVALID 0x0
2589#define EFI_ACPI_6_3_PPTT_CACHE_TYPE_VALID 0x1
2590#define EFI_ACPI_6_3_PPTT_WRITE_POLICY_INVALID 0x0
2591#define EFI_ACPI_6_3_PPTT_WRITE_POLICY_VALID 0x1
2592#define EFI_ACPI_6_3_PPTT_LINE_SIZE_INVALID 0x0
2593#define EFI_ACPI_6_3_PPTT_LINE_SIZE_VALID 0x1
2594
2595///
2596/// Cache Type Structure flags
2597///
2598typedef struct {
2599 UINT32 SizePropertyValid : 1;
2600 UINT32 NumberOfSetsValid : 1;
2601 UINT32 AssociativityValid : 1;
2602 UINT32 AllocationTypeValid : 1;
2603 UINT32 CacheTypeValid : 1;
2604 UINT32 WritePolicyValid : 1;
2605 UINT32 LineSizeValid : 1;
2606 UINT32 Reserved : 25;
2607} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_FLAGS;
2608
2609///
2610/// For cache attributes
2611///
2612#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_READ 0x0
2613#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_WRITE 0x1
2614#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_READ_WRITE 0x2
2615#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_DATA 0x0
2616#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_INSTRUCTION 0x1
2617#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_UNIFIED 0x2
2618#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_BACK 0x0
2619#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_THROUGH 0x1
2620
2621///
2622/// Cache Type Structure cache attributes
2623///
2624typedef struct {
2625 UINT8 AllocationType : 2;
2626 UINT8 CacheType : 2;
2627 UINT8 WritePolicy : 1;
2628 UINT8 Reserved : 3;
2629} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_ATTRIBUTES;
2630
2631///
2632/// Cache Type Structure
2633///
2634typedef struct {
2635 UINT8 Type;
2636 UINT8 Length;
2637 UINT8 Reserved[2];
2638 EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_FLAGS Flags;
2639 UINT32 NextLevelOfCache;
2640 UINT32 Size;
2641 UINT32 NumberOfSets;
2642 UINT8 Associativity;
2643 EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_ATTRIBUTES Attributes;
2644 UINT16 LineSize;
2645} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE;
2646
2647///
2648/// ID structure
2649///
2650typedef struct {
2651 UINT8 Type;
2652 UINT8 Length;
2653 UINT8 Reserved[2];
2654 UINT32 VendorId;
2655 UINT64 Level1Id;
2656 UINT64 Level2Id;
2657 UINT16 MajorRev;
2658 UINT16 MinorRev;
2659 UINT16 SpinRev;
2660} EFI_ACPI_6_3_PPTT_STRUCTURE_ID;
2661
2662//
2663// Known table signatures
2664//
2665
2666///
2667/// "RSD PTR " Root System Description Pointer
2668///
2669#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')
2670
2671///
2672/// "APIC" Multiple APIC Description Table
2673///
2674#define EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('A', 'P', 'I', 'C')
2675
2676///
2677/// "BERT" Boot Error Record Table
2678///
2679#define EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_SIGNATURE SIGNATURE_32('B', 'E', 'R', 'T')
2680
2681///
2682/// "BGRT" Boot Graphics Resource Table
2683///
2684#define EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('B', 'G', 'R', 'T')
2685
2686///
2687/// "CDIT" Component Distance Information Table
2688///
2689#define EFI_ACPI_6_3_COMPONENT_DISTANCE_INFORMATION_TABLE_SIGNATURE SIGNATURE_32('C', 'D', 'I', 'T')
2690
2691///
2692/// "CPEP" Corrected Platform Error Polling Table
2693///
2694#define EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE SIGNATURE_32('C', 'P', 'E', 'P')
2695
2696///
2697/// "CRAT" Component Resource Attribute Table
2698///
2699#define EFI_ACPI_6_3_COMPONENT_RESOURCE_ATTRIBUTE_TABLE_SIGNATURE SIGNATURE_32('C', 'R', 'A', 'T')
2700
2701///
2702/// "DSDT" Differentiated System Description Table
2703///
2704#define EFI_ACPI_6_3_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('D', 'S', 'D', 'T')
2705
2706///
2707/// "ECDT" Embedded Controller Boot Resources Table
2708///
2709#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE SIGNATURE_32('E', 'C', 'D', 'T')
2710
2711///
2712/// "EINJ" Error Injection Table
2713///
2714#define EFI_ACPI_6_3_ERROR_INJECTION_TABLE_SIGNATURE SIGNATURE_32('E', 'I', 'N', 'J')
2715
2716///
2717/// "ERST" Error Record Serialization Table
2718///
2719#define EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE SIGNATURE_32('E', 'R', 'S', 'T')
2720
2721///
2722/// "FACP" Fixed ACPI Description Table
2723///
2724#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('F', 'A', 'C', 'P')
2725
2726///
2727/// "FACS" Firmware ACPI Control Structure
2728///
2729#define EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE SIGNATURE_32('F', 'A', 'C', 'S')
2730
2731///
2732/// "FPDT" Firmware Performance Data Table
2733///
2734#define EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE SIGNATURE_32('F', 'P', 'D', 'T')
2735
2736///
2737/// "GTDT" Generic Timer Description Table
2738///
2739#define EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('G', 'T', 'D', 'T')
2740
2741///
2742/// "HEST" Hardware Error Source Table
2743///
2744#define EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE SIGNATURE_32('H', 'E', 'S', 'T')
2745
2746///
2747/// "HMAT" Heterogeneous Memory Attribute Table
2748///
2749#define EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_SIGNATURE SIGNATURE_32('H', 'M', 'A', 'T')
2750
2751///
2752/// "MPST" Memory Power State Table
2753///
2754#define EFI_ACPI_6_3_MEMORY_POWER_STATE_TABLE_SIGNATURE SIGNATURE_32('M', 'P', 'S', 'T')
2755
2756///
2757/// "MSCT" Maximum System Characteristics Table
2758///
2759#define EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE SIGNATURE_32('M', 'S', 'C', 'T')
2760
2761///
2762/// "NFIT" NVDIMM Firmware Interface Table
2763///
2764#define EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('N', 'F', 'I', 'T')
2765
2766///
2767/// "PDTT" Platform Debug Trigger Table
2768///
2769#define EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('P', 'D', 'T', 'T')
2770
2771///
2772/// "PMTT" Platform Memory Topology Table
2773///
2774#define EFI_ACPI_6_3_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE SIGNATURE_32('P', 'M', 'T', 'T')
2775
2776///
2777/// "PPTT" Processor Properties Topology Table
2778///
2779#define EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('P', 'P', 'T', 'T')
2780
2781///
2782/// "PSDT" Persistent System Description Table
2783///
2784#define EFI_ACPI_6_3_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('P', 'S', 'D', 'T')
2785
2786///
2787/// "RASF" ACPI RAS Feature Table
2788///
2789#define EFI_ACPI_6_3_ACPI_RAS_FEATURE_TABLE_SIGNATURE SIGNATURE_32('R', 'A', 'S', 'F')
2790
2791///
2792/// "RSDT" Root System Description Table
2793///
2794#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('R', 'S', 'D', 'T')
2795
2796///
2797/// "SBST" Smart Battery Specification Table
2798///
2799#define EFI_ACPI_6_3_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE SIGNATURE_32('S', 'B', 'S', 'T')
2800
2801///
2802/// "SDEV" Secure DEVices Table
2803///
2804#define EFI_ACPI_6_3_SECURE_DEVICES_TABLE_SIGNATURE SIGNATURE_32('S', 'D', 'E', 'V')
2805
2806///
2807/// "SLIT" System Locality Information Table
2808///
2809#define EFI_ACPI_6_3_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE SIGNATURE_32('S', 'L', 'I', 'T')
2810
2811///
2812/// "SRAT" System Resource Affinity Table
2813///
2814#define EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE SIGNATURE_32('S', 'R', 'A', 'T')
2815
2816///
2817/// "SSDT" Secondary System Description Table
2818///
2819#define EFI_ACPI_6_3_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('S', 'S', 'D', 'T')
2820
2821///
2822/// "XSDT" Extended System Description Table
2823///
2824#define EFI_ACPI_6_3_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('X', 'S', 'D', 'T')
2825
2826///
2827/// "BOOT" MS Simple Boot Spec
2828///
2829#define EFI_ACPI_6_3_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE SIGNATURE_32('B', 'O', 'O', 'T')
2830
2831///
2832/// "CSRT" MS Core System Resource Table
2833///
2834#define EFI_ACPI_6_3_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('C', 'S', 'R', 'T')
2835
2836///
2837/// "DBG2" MS Debug Port 2 Spec
2838///
2839#define EFI_ACPI_6_3_DEBUG_PORT_2_TABLE_SIGNATURE SIGNATURE_32('D', 'B', 'G', '2')
2840
2841///
2842/// "DBGP" MS Debug Port Spec
2843///
2844#define EFI_ACPI_6_3_DEBUG_PORT_TABLE_SIGNATURE SIGNATURE_32('D', 'B', 'G', 'P')
2845
2846///
2847/// "DMAR" DMA Remapping Table
2848///
2849#define EFI_ACPI_6_3_DMA_REMAPPING_TABLE_SIGNATURE SIGNATURE_32('D', 'M', 'A', 'R')
2850
2851///
2852/// "DPPT" DMA Protection Policy Table
2853///
2854#define EFI_ACPI_6_3_DMA_PROTECTION_POLICY_TABLE_SIGNATURE SIGNATURE_32('D', 'P', 'P', 'T')
2855
2856///
2857/// "DRTM" Dynamic Root of Trust for Measurement Table
2858///
2859#define EFI_ACPI_6_3_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE SIGNATURE_32('D', 'R', 'T', 'M')
2860
2861///
2862/// "ETDT" Event Timer Description Table
2863///
2864#define EFI_ACPI_6_3_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('E', 'T', 'D', 'T')
2865
2866///
2867/// "HPET" IA-PC High Precision Event Timer Table
2868///
2869#define EFI_ACPI_6_3_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE SIGNATURE_32('H', 'P', 'E', 'T')
2870
2871///
2872/// "iBFT" iSCSI Boot Firmware Table
2873///
2874#define EFI_ACPI_6_3_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE SIGNATURE_32('i', 'B', 'F', 'T')
2875
2876///
2877/// "IORT" I/O Remapping Table
2878///
2879#define EFI_ACPI_6_3_IO_REMAPPING_TABLE_SIGNATURE SIGNATURE_32('I', 'O', 'R', 'T')
2880
2881///
2882/// "IVRS" I/O Virtualization Reporting Structure
2883///
2884#define EFI_ACPI_6_3_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE SIGNATURE_32('I', 'V', 'R', 'S')
2885
2886///
2887/// "LPIT" Low Power Idle Table
2888///
2889#define EFI_ACPI_6_3_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE SIGNATURE_32('L', 'P', 'I', 'T')
2890
2891///
2892/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table
2893///
2894#define EFI_ACPI_6_3_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE SIGNATURE_32('M', 'C', 'F', 'G')
2895
2896///
2897/// "MCHI" Management Controller Host Interface Table
2898///
2899#define EFI_ACPI_6_3_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('M', 'C', 'H', 'I')
2900
2901///
2902/// "MSDM" MS Data Management Table
2903///
2904#define EFI_ACPI_6_3_DATA_MANAGEMENT_TABLE_SIGNATURE SIGNATURE_32('M', 'S', 'D', 'M')
2905
2906///
2907/// "PCCT" Platform Communications Channel Table
2908///
2909#define EFI_ACPI_6_3_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE SIGNATURE_32('P', 'C', 'C', 'T')
2910
2911///
2912/// "SDEI" Software Delegated Exceptions Interface Table
2913///
2914#define EFI_ACPI_6_3_SOFTWARE_DELEGATED_EXCEPTIONS_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('S', 'D', 'E', 'I')
2915
2916///
2917/// "SLIC" MS Software Licensing Table Specification
2918///
2919#define EFI_ACPI_6_3_SOFTWARE_LICENSING_TABLE_SIGNATURE SIGNATURE_32('S', 'L', 'I', 'C')
2920
2921///
2922/// "SPCR" Serial Port Concole Redirection Table
2923///
2924#define EFI_ACPI_6_3_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE SIGNATURE_32('S', 'P', 'C', 'R')
2925
2926///
2927/// "SPMI" Server Platform Management Interface Table
2928///
2929#define EFI_ACPI_6_3_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE SIGNATURE_32('S', 'P', 'M', 'I')
2930
2931///
2932/// "STAO" _STA Override Table
2933///
2934#define EFI_ACPI_6_3_STA_OVERRIDE_TABLE_SIGNATURE SIGNATURE_32('S', 'T', 'A', 'O')
2935
2936///
2937/// "TCPA" Trusted Computing Platform Alliance Capabilities Table
2938///
2939#define EFI_ACPI_6_3_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE SIGNATURE_32('T', 'C', 'P', 'A')
2940
2941///
2942/// "TPM2" Trusted Computing Platform 1 Table
2943///
2944#define EFI_ACPI_6_3_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE SIGNATURE_32('T', 'P', 'M', '2')
2945
2946///
2947/// "UEFI" UEFI ACPI Data Table
2948///
2949#define EFI_ACPI_6_3_UEFI_ACPI_DATA_TABLE_SIGNATURE SIGNATURE_32('U', 'E', 'F', 'I')
2950
2951///
2952/// "WAET" Windows ACPI Emulated Devices Table
2953///
2954#define EFI_ACPI_6_3_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE SIGNATURE_32('W', 'A', 'E', 'T')
2955
2956///
2957/// "WDAT" Watchdog Action Table
2958///
2959#define EFI_ACPI_6_3_WATCHDOG_ACTION_TABLE_SIGNATURE SIGNATURE_32('W', 'D', 'A', 'T')
2960
2961///
2962/// "WDRT" Watchdog Resource Table
2963///
2964#define EFI_ACPI_6_3_WATCHDOG_RESOURCE_TABLE_SIGNATURE SIGNATURE_32('W', 'D', 'R', 'T')
2965
2966///
2967/// "WPBT" MS Platform Binary Table
2968///
2969#define EFI_ACPI_6_3_PLATFORM_BINARY_TABLE_SIGNATURE SIGNATURE_32('W', 'P', 'B', 'T')
2970
2971///
2972/// "WSMT" Windows SMM Security Mitigation Table
2973///
2974#define EFI_ACPI_6_3_WINDOWS_SMM_SECURITY_MITIGATION_TABLE_SIGNATURE SIGNATURE_32('W', 'S', 'M', 'T')
2975
2976///
2977/// "XENV" Xen Project Table
2978///
2979#define EFI_ACPI_6_3_XEN_PROJECT_TABLE_SIGNATURE SIGNATURE_32('X', 'E', 'N', 'V')
2980
2981#pragma pack()
2982
2983#endif