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