2 GUIDs and definitions used for Common Platform Error Record.
4 Copyright (c) 2011 - 2016, Intel Corporation. All rights reserved.<BR>
5 (C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
14 @par Revision Reference:
15 GUIDs defined in UEFI 2.6 Specification.
19 #ifndef __CPER_GUID_H__
20 #define __CPER_GUID_H__
24 #define EFI_ERROR_RECORD_SIGNATURE_START SIGNATURE_32('C', 'P', 'E', 'R')
25 #define EFI_ERROR_RECORD_SIGNATURE_END 0xFFFFFFFF
27 #define EFI_ERROR_RECORD_REVISION 0x0101
30 /// Error Severity in Error Record Header and Error Section Descriptor
32 #define EFI_GENERIC_ERROR_RECOVERABLE 0x00000000
33 #define EFI_GENERIC_ERROR_FATAL 0x00000001
34 #define EFI_GENERIC_ERROR_CORRECTED 0x00000002
35 #define EFI_GENERIC_ERROR_INFO 0x00000003
39 /// The validation bit mask indicates the validity of the following fields
40 /// in Error Record Header.
42 #define EFI_ERROR_RECORD_HEADER_PLATFORM_ID_VALID BIT0
43 #define EFI_ERROR_RECORD_HEADER_TIME_STAMP_VALID BIT1
44 #define EFI_ERROR_RECORD_HEADER_PARTITION_ID_VALID BIT2
48 /// Timestamp is precise if this bit is set and correlates to the time of the
51 #define EFI_ERROR_TIME_STAMP_PRECISE BIT0
54 /// The timestamp correlates to the time when the error information was collected
55 /// by the system software and may not necessarily represent the time of the error
56 /// event. The timestamp contains the local time in BCD format.
67 } EFI_ERROR_TIME_STAMP
;
70 /// GUID value indicating the record association with an error event notification type.
72 #define EFI_EVENT_NOTIFICATION_TYEP_CMC_GUID \
74 0x2DCE8BB1, 0xBDD7, 0x450e, { 0xB9, 0xAD, 0x9C, 0xF4, 0xEB, 0xD4, 0xF8, 0x90 } \
76 #define EFI_EVENT_NOTIFICATION_TYEP_CPE_GUID \
78 0x4E292F96, 0xD843, 0x4a55, { 0xA8, 0xC2, 0xD4, 0x81, 0xF2, 0x7E, 0xBE, 0xEE } \
80 #define EFI_EVENT_NOTIFICATION_TYEP_MCE_GUID \
82 0xE8F56FFE, 0x919C, 0x4cc5, { 0xBA, 0x88, 0x65, 0xAB, 0xE1, 0x49, 0x13, 0xBB } \
84 #define EFI_EVENT_NOTIFICATION_TYEP_PCIE_GUID \
86 0xCF93C01F, 0x1A16, 0x4dfc, { 0xB8, 0xBC, 0x9C, 0x4D, 0xAF, 0x67, 0xC1, 0x04 } \
88 #define EFI_EVENT_NOTIFICATION_TYEP_INIT_GUID \
90 0xCC5263E8, 0x9308, 0x454a, { 0x89, 0xD0, 0x34, 0x0B, 0xD3, 0x9B, 0xC9, 0x8E } \
92 #define EFI_EVENT_NOTIFICATION_TYEP_NMI_GUID \
94 0x5BAD89FF, 0xB7E6, 0x42c9, { 0x81, 0x4A, 0xCF, 0x24, 0x85, 0xD6, 0xE9, 0x8A } \
96 #define EFI_EVENT_NOTIFICATION_TYEP_BOOT_GUID \
98 0x3D61A466, 0xAB40, 0x409a, { 0xA6, 0x98, 0xF3, 0x62, 0xD4, 0x64, 0xB3, 0x8F } \
100 #define EFI_EVENT_NOTIFICATION_TYEP_DMAR_GUID \
102 0x667DD791, 0xC6B3, 0x4c27, { 0x8A, 0x6B, 0x0F, 0x8E, 0x72, 0x2D, 0xEB, 0x41 } \
107 /// Error Record Header Flags
109 #define EFI_HW_ERROR_FLAGS_RECOVERED 0x00000001
110 #define EFI_HW_ERROR_FLAGS_PREVERR 0x00000002
111 #define EFI_HW_ERROR_FLAGS_SIMULATED 0x00000004
115 /// Common error record header
118 UINT32 SignatureStart
;
122 UINT32 ErrorSeverity
;
123 UINT32 ValidationBits
;
125 EFI_ERROR_TIME_STAMP TimeStamp
;
127 EFI_GUID PartitionID
;
129 EFI_GUID NotificationType
;
132 UINT64 PersistenceInfo
;
135 /// An array of SectionCount descriptors for the associated
136 /// sections. The number of valid sections is equivalent to the
137 /// SectionCount. The buffer size of the record may include
138 /// more space to dynamically add additional Section
139 /// Descriptors to the error record.
141 } EFI_COMMON_ERROR_RECORD_HEADER
;
143 #define EFI_ERROR_SECTION_REVISION 0x0100
146 /// Validity Fields in Error Section Descriptor.
148 #define EFI_ERROR_SECTION_FRU_ID_VALID BIT0
149 #define EFI_ERROR_SECTION_FRU_STRING_VALID BIT1
152 /// Flag field contains information that describes the error section
153 /// in Error Section Descriptor.
155 #define EFI_ERROR_SECTION_FLAGS_PRIMARY BIT0
156 #define EFI_ERROR_SECTION_FLAGS_CONTAINMENT_WARNING BIT1
157 #define EFI_ERROR_SECTION_FLAGS_RESET BIT2
158 #define EFI_ERROR_SECTION_FLAGS_ERROR_THRESHOLD_EXCEEDED BIT3
159 #define EFI_ERROR_SECTION_FLAGS_RESOURCE_NOT_ACCESSIBLE BIT4
160 #define EFI_ERROR_SECTION_FLAGS_LATENT_ERROR BIT5
163 /// Error Sectition Type GUIDs in Error Section Descriptor
165 #define EFI_ERROR_SECTION_PROCESSOR_GENERIC_GUID \
167 0x9876ccad, 0x47b4, 0x4bdb, { 0xb6, 0x5e, 0x16, 0xf1, 0x93, 0xc4, 0xf3, 0xdb } \
169 #define EFI_ERROR_SECTION_PROCESSOR_SPECIFIC_GUID \
171 0xdc3ea0b0, 0xa144, 0x4797, { 0xb9, 0x5b, 0x53, 0xfa, 0x24, 0x2b, 0x6e, 0x1d } \
173 #define EFI_ERROR_SECTION_PROCESSOR_SPECIFIC_IA32X64_GUID \
175 0xdc3ea0b0, 0xa144, 0x4797, { 0xb9, 0x5b, 0x53, 0xfa, 0x24, 0x2b, 0x6e, 0x1d } \
177 #define EFI_ERROR_SECTION_PROCESSOR_SPECIFIC_ARM_GUID \
179 0xe19e3d16, 0xbc11, 0x11e4, { 0x9c, 0xaa, 0xc2, 0x05, 0x1d, 0x5d, 0x46, 0xb0 } \
181 #define EFI_ERROR_SECTION_PLATFORM_MEMORY_GUID \
183 0xa5bc1114, 0x6f64, 0x4ede, { 0xb8, 0x63, 0x3e, 0x83, 0xed, 0x7c, 0x83, 0xb1 } \
185 #define EFI_ERROR_SECTION_PLATFORM_MEMORY2_GUID \
187 0x61EC04FC, 0x48E6, 0xD813, { 0x25, 0xC9, 0x8D, 0xAA, 0x44, 0x75, 0x0B, 0x12 } \
189 #define EFI_ERROR_SECTION_PCIE_GUID \
191 0xd995e954, 0xbbc1, 0x430f, { 0xad, 0x91, 0xb4, 0x4d, 0xcb, 0x3c, 0x6f, 0x35 } \
193 #define EFI_ERROR_SECTION_FW_ERROR_RECORD_GUID \
195 0x81212a96, 0x09ed, 0x4996, { 0x94, 0x71, 0x8d, 0x72, 0x9c, 0x8e, 0x69, 0xed } \
197 #define EFI_ERROR_SECTION_PCI_PCIX_BUS_GUID \
199 0xc5753963, 0x3b84, 0x4095, { 0xbf, 0x78, 0xed, 0xda, 0xd3, 0xf9, 0xc9, 0xdd } \
201 #define EFI_ERROR_SECTION_PCI_DEVICE_GUID \
203 0xeb5e4685, 0xca66, 0x4769, { 0xb6, 0xa2, 0x26, 0x06, 0x8b, 0x00, 0x13, 0x26 } \
205 #define EFI_ERROR_SECTION_DMAR_GENERIC_GUID \
207 0x5b51fef7, 0xc79d, 0x4434, { 0x8f, 0x1b, 0xaa, 0x62, 0xde, 0x3e, 0x2c, 0x64 } \
209 #define EFI_ERROR_SECTION_DIRECTED_IO_DMAR_GUID \
211 0x71761d37, 0x32b2, 0x45cd, { 0xa7, 0xd0, 0xb0, 0xfe, 0xdd, 0x93, 0xe8, 0xcf } \
213 #define EFI_ERROR_SECTION_IOMMU_DMAR_GUID \
215 0x036f84e1, 0x7f37, 0x428c, { 0xa7, 0x9e, 0x57, 0x5f, 0xdf, 0xaa, 0x84, 0xec } \
220 /// Error Section Descriptor
223 UINT32 SectionOffset
;
224 UINT32 SectionLength
;
229 EFI_GUID SectionType
;
233 } EFI_ERROR_SECTION_DESCRIPTOR
;
236 /// The validation bit mask indicates whether or not each of the following fields are
237 /// valid in Proessor Generic Error section.
239 #define EFI_GENERIC_ERROR_PROC_TYPE_VALID BIT0
240 #define EFI_GENERIC_ERROR_PROC_ISA_VALID BIT1
241 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_VALID BIT2
242 #define EFI_GENERIC_ERROR_PROC_OPERATION_VALID BIT3
243 #define EFI_GENERIC_ERROR_PROC_FLAGS_VALID BIT4
244 #define EFI_GENERIC_ERROR_PROC_LEVEL_VALID BIT5
245 #define EFI_GENERIC_ERROR_PROC_VERSION_VALID BIT6
246 #define EFI_GENERIC_ERROR_PROC_BRAND_VALID BIT7
247 #define EFI_GENERIC_ERROR_PROC_ID_VALID BIT8
248 #define EFI_GENERIC_ERROR_PROC_TARGET_ADDR_VALID BIT9
249 #define EFI_GENERIC_ERROR_PROC_REQUESTER_ID_VALID BIT10
250 #define EFI_GENERIC_ERROR_PROC_RESPONDER_ID_VALID BIT11
251 #define EFI_GENERIC_ERROR_PROC_INST_IP_VALID BIT12
255 /// The type of the processor architecture in Proessor Generic Error section.
257 #define EFI_GENERIC_ERROR_PROC_TYPE_IA32_X64 0x00
258 #define EFI_GENERIC_ERROR_PROC_TYPE_IA64 0x01
262 /// The type of the instruction set executing when the error occurred in Proessor
263 /// Generic Error section.
265 #define EFI_GENERIC_ERROR_PROC_ISA_IA32 0x00
266 #define EFI_GENERIC_ERROR_PROC_ISA_IA64 0x01
267 #define EFI_GENERIC_ERROR_PROC_ISA_X64 0x02
271 /// The type of error that occurred in Proessor Generic Error section.
273 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_UNKNOWN 0x00
274 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_CACHE 0x01
275 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_TLB 0x02
276 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_BUS 0x04
277 #define EFI_GENERIC_ERROR_PROC_ERROR_TYPE_MICRO_ARCH 0x08
281 /// The type of operation in Proessor Generic Error section.
283 #define EFI_GENERIC_ERROR_PROC_OPERATION_GENERIC 0x00
284 #define EFI_GENERIC_ERROR_PROC_OPERATION_DATA_READ 0x01
285 #define EFI_GENERIC_ERROR_PROC_OPERATION_DATA_WRITE 0x02
286 #define EFI_GENERIC_ERROR_PROC_OPERATION_INSTRUCTION_EXEC 0x03
290 /// Flags bit mask indicates additional information about the error in Proessor Generic
293 #define EFI_GENERIC_ERROR_PROC_FLAGS_RESTARTABLE BIT0
294 #define EFI_GENERIC_ERROR_PROC_FLAGS_PRECISE_IP BIT1
295 #define EFI_GENERIC_ERROR_PROC_FLAGS_OVERFLOW BIT2
296 #define EFI_GENERIC_ERROR_PROC_FLAGS_CORRECTED BIT3
300 /// Processor Generic Error Section
301 /// describes processor reported hardware errors for logical processors in the system.
313 CHAR8 BrandString
[128];
318 UINT64 InstructionIP
;
319 } EFI_PROCESSOR_GENERIC_ERROR_DATA
;
322 #if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
324 /// IA32 and x64 Specific definitions.
328 /// GUID value indicating the type of Processor Error Information structure
329 /// in IA32/X64 Processor Error Information Structure.
331 #define EFI_IA32_X64_ERROR_TYPE_CACHE_CHECK_GUID \
333 0xA55701F5, 0xE3EF, 0x43de, {0xAC, 0x72, 0x24, 0x9B, 0x57, 0x3F, 0xAD, 0x2C } \
335 #define EFI_IA32_X64_ERROR_TYPE_TLB_CHECK_GUID \
337 0xFC06B535, 0x5E1F, 0x4562, {0x9F, 0x25, 0x0A, 0x3B, 0x9A, 0xDB, 0x63, 0xC3 } \
339 #define EFI_IA32_X64_ERROR_TYPE_BUS_CHECK_GUID \
341 0x1CF3F8B3, 0xC5B1, 0x49a2, {0xAA, 0x59, 0x5E, 0xEF, 0x92, 0xFF, 0xA6, 0x3C } \
343 #define EFI_IA32_X64_ERROR_TYPE_MS_CHECK_GUID \
345 0x48AB7F57, 0xDC34, 0x4f6c, {0xA7, 0xD3, 0xB0, 0xB5, 0xB0, 0xA7, 0x43, 0x14 } \
350 /// The validation bit mask indicates which fields in the IA32/X64 Processor
351 /// Error Record structure are valid.
353 #define EFI_IA32_X64_PROCESSOR_ERROR_APIC_ID_VALID BIT0
354 #define EFI_IA32_X64_PROCESSOR_ERROR_CPU_ID_INFO_VALID BIT1
358 /// IA32/X64 Processor Error Record
364 } EFI_IA32_X64_PROCESSOR_ERROR_RECORD
;
367 /// The validation bit mask indicates which fields in the Cache Check structure
370 #define EFI_CACHE_CHECK_TRANSACTION_TYPE_VALID BIT0
371 #define EFI_CACHE_CHECK_OPERATION_VALID BIT1
372 #define EFI_CACHE_CHECK_LEVEL_VALID BIT2
373 #define EFI_CACHE_CHECK_CONTEXT_CORRUPT_VALID BIT3
374 #define EFI_CACHE_CHECK_UNCORRECTED_VALID BIT4
375 #define EFI_CACHE_CHECK_PRECISE_IP_VALID BIT5
376 #define EFI_CACHE_CHECK_RESTARTABLE_VALID BIT6
377 #define EFI_CACHE_CHECK_OVERFLOW_VALID BIT7
381 /// Type of cache error in the Cache Check structure
383 #define EFI_CACHE_CHECK_ERROR_TYPE_INSTRUCTION 0
384 #define EFI_CACHE_CHECK_ERROR_TYPE_DATA_ACCESS 1
385 #define EFI_CACHE_CHECK_ERROR_TYPE_GENERIC 2
389 /// Type of cache operation that caused the error in the Cache
392 #define EFI_CACHE_CHECK_OPERATION_TYPE_GENERIC 0
393 #define EFI_CACHE_CHECK_OPERATION_TYPE_GENERIC_READ 1
394 #define EFI_CACHE_CHECK_OPERATION_TYPE_GENERIC_WRITE 2
395 #define EFI_CACHE_CHECK_OPERATION_TYPE_DATA_READ 3
396 #define EFI_CACHE_CHECK_OPERATION_TYPE_DATA_WRITE 4
397 #define EFI_CACHE_CHECK_OPERATION_TYPE_INSTRUCTION_FETCH 5
398 #define EFI_CACHE_CHECK_OPERATION_TYPE_PREFETCH 6
399 #define EFI_CACHE_CHECK_OPERATION_TYPE_EVICTION 7
400 #define EFI_CACHE_CHECK_OPERATION_TYPE_SNOOP 8
404 /// IA32/X64 Cache Check Structure
407 UINT64 ValidFields
:16;
408 UINT64 TransactionType
:2;
411 UINT64 ContextCorrupt
:1;
412 UINT64 ErrorUncorrected
:1;
414 UINT64 RestartableIp
:1;
417 } EFI_IA32_X64_CACHE_CHECK_INFO
;
420 /// The validation bit mask indicates which fields in the TLB Check structure
423 #define EFI_TLB_CHECK_TRANSACTION_TYPE_VALID BIT0
424 #define EFI_TLB_CHECK_OPERATION_VALID BIT1
425 #define EFI_TLB_CHECK_LEVEL_VALID BIT2
426 #define EFI_TLB_CHECK_CONTEXT_CORRUPT_VALID BIT3
427 #define EFI_TLB_CHECK_UNCORRECTED_VALID BIT4
428 #define EFI_TLB_CHECK_PRECISE_IP_VALID BIT5
429 #define EFI_TLB_CHECK_RESTARTABLE_VALID BIT6
430 #define EFI_TLB_CHECK_OVERFLOW_VALID BIT7
434 /// Type of cache error in the TLB Check structure
436 #define EFI_TLB_CHECK_ERROR_TYPE_INSTRUCTION 0
437 #define EFI_TLB_CHECK_ERROR_TYPE_DATA_ACCESS 1
438 #define EFI_TLB_CHECK_ERROR_TYPE_GENERIC 2
442 /// Type of cache operation that caused the error in the TLB
445 #define EFI_TLB_CHECK_OPERATION_TYPE_GENERIC 0
446 #define EFI_TLB_CHECK_OPERATION_TYPE_GENERIC_READ 1
447 #define EFI_TLB_CHECK_OPERATION_TYPE_GENERIC_WRITE 2
448 #define EFI_TLB_CHECK_OPERATION_TYPE_DATA_READ 3
449 #define EFI_TLB_CHECK_OPERATION_TYPE_DATA_WRITE 4
450 #define EFI_TLB_CHECK_OPERATION_TYPE_INST_FETCH 5
451 #define EFI_TLB_CHECK_OPERATION_TYPE_PREFETCH 6
455 /// IA32/X64 TLB Check Structure
458 UINT64 ValidFields
:16;
459 UINT64 TransactionType
:2;
462 UINT64 ContextCorrupt
:1;
463 UINT64 ErrorUncorrected
:1;
465 UINT64 RestartableIp
:1;
468 } EFI_IA32_X64_TLB_CHECK_INFO
;
471 /// The validation bit mask indicates which fields in the MS Check structure
474 #define EFI_BUS_CHECK_TRANSACTION_TYPE_VALID BIT0
475 #define EFI_BUS_CHECK_OPERATION_VALID BIT1
476 #define EFI_BUS_CHECK_LEVEL_VALID BIT2
477 #define EFI_BUS_CHECK_CONTEXT_CORRUPT_VALID BIT3
478 #define EFI_BUS_CHECK_UNCORRECTED_VALID BIT4
479 #define EFI_BUS_CHECK_PRECISE_IP_VALID BIT5
480 #define EFI_BUS_CHECK_RESTARTABLE_VALID BIT6
481 #define EFI_BUS_CHECK_OVERFLOW_VALID BIT7
482 #define EFI_BUS_CHECK_PARTICIPATION_TYPE_VALID BIT8
483 #define EFI_BUS_CHECK_TIME_OUT_VALID BIT9
484 #define EFI_BUS_CHECK_ADDRESS_SPACE_VALID BIT10
488 /// Type of cache error in the Bus Check structure
490 #define EFI_BUS_CHECK_ERROR_TYPE_INSTRUCTION 0
491 #define EFI_BUS_CHECK_ERROR_TYPE_DATA_ACCESS 1
492 #define EFI_BUS_CHECK_ERROR_TYPE_GENERIC 2
496 /// Type of cache operation that caused the error in the Bus
499 #define EFI_BUS_CHECK_OPERATION_TYPE_GENERIC 0
500 #define EFI_BUS_CHECK_OPERATION_TYPE_GENERIC_READ 1
501 #define EFI_BUS_CHECK_OPERATION_TYPE_GENERIC_WRITE 2
502 #define EFI_BUS_CHECK_OPERATION_TYPE_DATA_READ 3
503 #define EFI_BUS_CHECK_OPERATION_TYPE_DATA_WRITE 4
504 #define EFI_BUS_CHECK_OPERATION_TYPE_INST_FETCH 5
505 #define EFI_BUS_CHECK_OPERATION_TYPE_PREFETCH 6
509 /// Type of Participation
511 #define EFI_BUS_CHECK_PARTICIPATION_TYPE_REQUEST 0
512 #define EFI_BUS_CHECK_PARTICIPATION_TYPE_RESPONDED 1
513 #define EFI_BUS_CHECK_PARTICIPATION_TYPE_OBSERVED 2
514 #define EFI_BUS_CHECK_PARTICIPATION_TYPE_GENERIC 3
518 /// Type of Address Space
520 #define EFI_BUS_CHECK_ADDRESS_SPACE_TYPE_MEMORY 0
521 #define EFI_BUS_CHECK_ADDRESS_SPACE_TYPE_RESERVED 1
522 #define EFI_BUS_CHECK_ADDRESS_SPACE_TYPE_IO 2
523 #define EFI_BUS_CHECK_ADDRESS_SPACE_TYPE_OTHER 3
527 /// IA32/X64 Bus Check Structure
530 UINT64 ValidFields
:16;
531 UINT64 TransactionType
:2;
534 UINT64 ContextCorrupt
:1;
535 UINT64 ErrorUncorrected
:1;
537 UINT64 RestartableIp
:1;
539 UINT64 ParticipationType
:2;
541 UINT64 AddressSpace
:2;
543 } EFI_IA32_X64_BUS_CHECK_INFO
;
546 /// The validation bit mask indicates which fields in the MS Check structure
549 #define EFI_MS_CHECK_ERROR_TYPE_VALID BIT0
550 #define EFI_MS_CHECK_CONTEXT_CORRUPT_VALID BIT1
551 #define EFI_MS_CHECK_UNCORRECTED_VALID BIT2
552 #define EFI_MS_CHECK_PRECISE_IP_VALID BIT3
553 #define EFI_MS_CHECK_RESTARTABLE_VALID BIT4
554 #define EFI_MS_CHECK_OVERFLOW_VALID BIT5
558 /// Error type identifies the operation that caused the error.
560 #define EFI_MS_CHECK_ERROR_TYPE_NO 0
561 #define EFI_MS_CHECK_ERROR_TYPE_UNCLASSIFIED 1
562 #define EFI_MS_CHECK_ERROR_TYPE_MICROCODE_PARITY 2
563 #define EFI_MS_CHECK_ERROR_TYPE_EXTERNAL 3
564 #define EFI_MS_CHECK_ERROR_TYPE_FRC 4
565 #define EFI_MS_CHECK_ERROR_TYPE_INTERNAL_UNCLASSIFIED 5
569 /// IA32/X64 MS Check Field Description
572 UINT64 ValidFields
:16;
574 UINT64 ContextCorrupt
:1;
575 UINT64 ErrorUncorrected
:1;
577 UINT64 RestartableIp
:1;
580 } EFI_IA32_X64_MS_CHECK_INFO
;
583 /// IA32/X64 Check Information Item
586 EFI_IA32_X64_CACHE_CHECK_INFO CacheCheck
;
587 EFI_IA32_X64_TLB_CHECK_INFO TlbCheck
;
588 EFI_IA32_X64_BUS_CHECK_INFO BusCheck
;
589 EFI_IA32_X64_MS_CHECK_INFO MsCheck
;
591 } EFI_IA32_X64_CHECK_INFO_ITEM
;
594 /// The validation bit mask indicates which fields in the IA32/X64 Processor Error
595 /// Information Structure are valid.
597 #define EFI_IA32_X64_ERROR_PROC_CHECK_INFO_VALID BIT0
598 #define EFI_IA32_X64_ERROR_PROC_TARGET_ADDR_VALID BIT1
599 #define EFI_IA32_X64_ERROR_PROC_REQUESTER_ID_VALID BIT2
600 #define EFI_IA32_X64_ERROR_PROC_RESPONDER_ID_VALID BIT3
601 #define EFI_IA32_X64_ERROR_PROC_INST_IP_VALID BIT4
605 /// IA32/X64 Processor Error Information Structure
610 EFI_IA32_X64_CHECK_INFO_ITEM CheckInfo
;
614 UINT64 InstructionIP
;
615 } EFI_IA32_X64_PROCESS_ERROR_INFO
;
618 /// IA32/X64 Processor Context Information Structure
624 UINT64 MmRegisterAddress
;
626 // This field will provide the contents of the actual registers or raw data.
627 // The number of Registers or size of the raw data reported is determined
628 // by (Array Size / 8) or otherwise specified by the context structure type
631 } EFI_IA32_X64_PROCESSOR_CONTEXT_INFO
;
634 /// Register Context Type
636 #define EFI_REG_CONTEXT_TYPE_UNCLASSIFIED 0x0000
637 #define EFI_REG_CONTEXT_TYPE_MSR 0x0001
638 #define EFI_REG_CONTEXT_TYPE_IA32 0x0002
639 #define EFI_REG_CONTEXT_TYPE_X64 0x0003
640 #define EFI_REG_CONTEXT_TYPE_FXSAVE 0x0004
641 #define EFI_REG_CONTEXT_TYPE_DR_IA32 0x0005
642 #define EFI_REG_CONTEXT_TYPE_DR_X64 0x0006
643 #define EFI_REG_CONTEXT_TYPE_MEM_MAP 0x0007
647 /// IA32 Register State
675 } EFI_CONTEXT_IA32_REGISTER_STATE
;
678 /// X64 Register State
715 } EFI_CONTEXT_X64_REGISTER_STATE
;
718 /// The validation bit mask indicates each of the following field is in IA32/X64
719 /// Processor Error Section.
722 UINT64 ApicIdValid
:1;
723 UINT64 CpuIdInforValid
:1;
724 UINT64 ErrorInfoNum
:6;
727 } EFI_IA32_X64_VALID_BITS
;
732 /// Error Status Fields
737 UINT64 AddressSignal
:1; ///< Error in Address signals or in Address portion of transaction
738 UINT64 ControlSignal
:1; ///< Error in Control signals or in Control portion of transaction
739 UINT64 DataSignal
:1; ///< Error in Data signals or in Data portion of transaction
740 UINT64 DetectedByResponder
:1; ///< Error detected by responder
741 UINT64 DetectedByRequester
:1; ///< Error detected by requestor
742 UINT64 FirstError
:1; ///< First Error in the sequence - option field
743 UINT64 OverflowNotLogged
:1; ///< Additional errors were not logged due to lack of resources
745 } EFI_GENERIC_ERROR_STATUS
;
752 /// General Internal errors
757 /// Component Internal errors
759 ErrorMemStorage
= 4, // Error in memory device
760 ErrorTlbStorage
= 5, // TLB error in cache
761 ErrorCacheStorage
= 6,
762 ErrorFunctionalUnit
= 7,
766 /// Bus internal errors
768 ErrorVirtualMap
= 17,
769 ErrorAccessInvalid
= 18, // Improper access
770 ErrorUnimplAccess
= 19, // Unimplemented memory access
771 ErrorLossOfLockstep
= 20,
772 ErrorResponseInvalid
= 21, // Response not associated with request
775 ErrorPath
= 24, // Detected path error
776 ErrorTimeout
= 25, // Bus timeout
777 ErrorPoisoned
= 26 // Read data poisoned
778 } EFI_GENERIC_ERROR_STATUS_ERROR_TYPE
;
781 /// Validation bit mask indicates which fields in the memory error record are valid
782 /// in Memory Error section
784 #define EFI_PLATFORM_MEMORY_ERROR_STATUS_VALID BIT0
785 #define EFI_PLATFORM_MEMORY_PHY_ADDRESS_VALID BIT1
786 #define EFI_PLATFORM_MEMORY_PHY_ADDRESS_MASK_VALID BIT2
787 #define EFI_PLATFORM_MEMORY_NODE_VALID BIT3
788 #define EFI_PLATFORM_MEMORY_CARD_VALID BIT4
789 #define EFI_PLATFORM_MEMORY_MODULE_VALID BIT5
790 #define EFI_PLATFORM_MEMORY_BANK_VALID BIT6
791 #define EFI_PLATFORM_MEMORY_DEVICE_VALID BIT7
792 #define EFI_PLATFORM_MEMORY_ROW_VALID BIT8
793 #define EFI_PLATFORM_MEMORY_COLUMN_VALID BIT9
794 #define EFI_PLATFORM_MEMORY_BIT_POS_VALID BIT10
795 #define EFI_PLATFORM_MEMORY_REQUESTOR_ID_VALID BIT11
796 #define EFI_PLATFORM_MEMORY_RESPONDER_ID_VALID BIT12
797 #define EFI_PLATFORM_MEMORY_TARGET_ID_VALID BIT13
798 #define EFI_PLATFORM_MEMORY_ERROR_TYPE_VALID BIT14
799 #define EFI_PLATFORM_MEMORY_ERROR_RANK_NUM_VALID BIT15
800 #define EFI_PLATFORM_MEMORY_ERROR_CARD_HANDLE_VALID BIT16
801 #define EFI_PLATFORM_MEMORY_ERROR_MODULE_HANDLE_VALID BIT17
802 #define EFI_PLATFORM_MEMORY_ERROR_EXTENDED_ROW_BIT_16_17_VALID BIT18
803 #define EFI_PLATFORM_MEMORY_ERROR_BANK_GROUP_VALID BIT19
804 #define EFI_PLATFORM_MEMORY_ERROR_BANK_ADDRESS_VALID BIT20
805 #define EFI_PLATFORM_MEMORY_ERROR_CHIP_IDENTIFICATION_VALID BIT21
809 /// Memory Error Type identifies the type of error that occurred in Memory
812 #define EFI_PLATFORM_MEMORY_ERROR_UNKNOWN 0x00
813 #define EFI_PLATFORM_MEMORY_ERROR_NONE 0x01
814 #define EFI_PLATFORM_MEMORY_ERROR_SINGLEBIT_ECC 0x02
815 #define EFI_PLATFORM_MEMORY_ERROR_MLTIBIT_ECC 0x03
816 #define EFI_PLATFORM_MEMORY_ERROR_SINGLESYMBOLS_CHIPKILL 0x04
817 #define EFI_PLATFORM_MEMORY_ERROR_MULTISYMBOL_CHIPKILL 0x05
818 #define EFI_PLATFORM_MEMORY_ERROR_MATER_ABORT 0x06
819 #define EFI_PLATFORM_MEMORY_ERROR_TARGET_ABORT 0x07
820 #define EFI_PLATFORM_MEMORY_ERROR_PARITY 0x08
821 #define EFI_PLATFORM_MEMORY_ERROR_WDT 0x09
822 #define EFI_PLATFORM_MEMORY_ERROR_INVALID_ADDRESS 0x0A
823 #define EFI_PLATFORM_MEMORY_ERROR_MIRROR_FAILED 0x0B
824 #define EFI_PLATFORM_MEMORY_ERROR_SPARING 0x0C
825 #define EFI_PLATFORM_MEMORY_ERROR_SCRUB_CORRECTED 0x0D
826 #define EFI_PLATFORM_MEMORY_ERROR_SCRUB_UNCORRECTED 0x0E
827 #define EFI_PLATFORM_MEMORY_ERROR_MEMORY_MAP_EVENT 0x0F
831 /// Memory Error Section
835 EFI_GENERIC_ERROR_STATUS ErrorStatus
;
836 UINT64 PhysicalAddress
; // Error physical address
837 UINT64 PhysicalAddressMask
; // Grnaularity
838 UINT16 Node
; // Node #
840 UINT16 ModuleRank
; // Module or Rank#
854 } EFI_PLATFORM_MEMORY_ERROR_DATA
;
857 /// Validation bit mask indicates which fields in the memory error record 2 are valid
858 /// in Memory Error section 2
860 #define EFI_PLATFORM_MEMORY2_ERROR_STATUS_VALID BIT0
861 #define EFI_PLATFORM_MEMORY2_PHY_ADDRESS_VALID BIT1
862 #define EFI_PLATFORM_MEMORY2_PHY_ADDRESS_MASK_VALID BIT2
863 #define EFI_PLATFORM_MEMORY2_NODE_VALID BIT3
864 #define EFI_PLATFORM_MEMORY2_CARD_VALID BIT4
865 #define EFI_PLATFORM_MEMORY2_MODULE_VALID BIT5
866 #define EFI_PLATFORM_MEMORY2_BANK_VALID BIT6
867 #define EFI_PLATFORM_MEMORY2_DEVICE_VALID BIT7
868 #define EFI_PLATFORM_MEMORY2_ROW_VALID BIT8
869 #define EFI_PLATFORM_MEMORY2_COLUMN_VALID BIT9
870 #define EFI_PLATFORM_MEMORY2_RANK_VALID BIT10
871 #define EFI_PLATFORM_MEMORY2_BIT_POS_VALID BIT11
872 #define EFI_PLATFORM_MEMORY2_CHIP_ID_VALID BIT12
873 #define EFI_PLATFORM_MEMORY2_MEMORY_ERROR_TYPE_VALID BIT13
874 #define EFI_PLATFORM_MEMORY2_STATUS_VALID BIT14
875 #define EFI_PLATFORM_MEMORY2_REQUESTOR_ID_VALID BIT15
876 #define EFI_PLATFORM_MEMORY2_RESPONDER_ID_VALID BIT16
877 #define EFI_PLATFORM_MEMORY2_TARGET_ID_VALID BIT17
878 #define EFI_PLATFORM_MEMORY2_CARD_HANDLE_VALID BIT18
879 #define EFI_PLATFORM_MEMORY2_MODULE_HANDLE_VALID BIT19
880 #define EFI_PLATFORM_MEMORY2_BANK_GROUP_VALID BIT20
881 #define EFI_PLATFORM_MEMORY2_BANK_ADDRESS_VALID BIT21
885 /// Memory Error Type identifies the type of error that occurred in Memory
888 #define EFI_PLATFORM_MEMORY2_ERROR_UNKNOWN 0x00
889 #define EFI_PLATFORM_MEMORY2_ERROR_NONE 0x01
890 #define EFI_PLATFORM_MEMORY2_ERROR_SINGLEBIT_ECC 0x02
891 #define EFI_PLATFORM_MEMORY2_ERROR_MLTIBIT_ECC 0x03
892 #define EFI_PLATFORM_MEMORY2_ERROR_SINGLESYMBOL_CHIPKILL 0x04
893 #define EFI_PLATFORM_MEMORY2_ERROR_MULTISYMBOL_CHIPKILL 0x05
894 #define EFI_PLATFORM_MEMORY2_ERROR_MASTER_ABORT 0x06
895 #define EFI_PLATFORM_MEMORY2_ERROR_TARGET_ABORT 0x07
896 #define EFI_PLATFORM_MEMORY2_ERROR_PARITY 0x08
897 #define EFI_PLATFORM_MEMORY2_ERROR_WDT 0x09
898 #define EFI_PLATFORM_MEMORY2_ERROR_INVALID_ADDRESS 0x0A
899 #define EFI_PLATFORM_MEMORY2_ERROR_MIRROR_BROKEN 0x0B
900 #define EFI_PLATFORM_MEMORY2_ERROR_MEMORY_SPARING 0x0C
901 #define EFI_PLATFORM_MEMORY2_ERROR_SCRUB_CORRECTED 0x0D
902 #define EFI_PLATFORM_MEMORY2_ERROR_SCRUB_UNCORRECTED 0x0E
903 #define EFI_PLATFORM_MEMORY2_ERROR_MEMORY_MAP_EVENT 0x0F
907 /// Memory Error Section 2
911 EFI_GENERIC_ERROR_STATUS ErrorStatus
;
912 UINT64 PhysicalAddress
; // Error physical address
913 UINT64 PhysicalAddressMask
; // Grnaularity
914 UINT16 Node
; // Node #
916 UINT16 Module
; // Module or Rank#
932 } EFI_PLATFORM_MEMORY2_ERROR_DATA
;
935 /// Validation bits mask indicates which of the following fields is valid
936 /// in PCI Express Error Record.
938 #define EFI_PCIE_ERROR_PORT_TYPE_VALID BIT0
939 #define EFI_PCIE_ERROR_VERSION_VALID BIT1
940 #define EFI_PCIE_ERROR_COMMAND_STATUS_VALID BIT2
941 #define EFI_PCIE_ERROR_DEVICE_ID_VALID BIT3
942 #define EFI_PCIE_ERROR_SERIAL_NO_VALID BIT4
943 #define EFI_PCIE_ERROR_BRIDGE_CRL_STS_VALID BIT5
944 #define EFI_PCIE_ERROR_CAPABILITY_INFO_VALID BIT6
945 #define EFI_PCIE_ERROR_AER_INFO_VALID BIT7
949 /// PCIe Device/Port Type as defined in the PCI Express capabilities register
951 #define EFI_PCIE_ERROR_PORT_PCIE_ENDPOINT 0x00000000
952 #define EFI_PCIE_ERROR_PORT_PCI_ENDPOINT 0x00000001
953 #define EFI_PCIE_ERROR_PORT_ROOT_PORT 0x00000004
954 #define EFI_PCIE_ERROR_PORT_UPSWITCH_PORT 0x00000005
955 #define EFI_PCIE_ERROR_PORT_DOWNSWITCH_PORT 0x00000006
956 #define EFI_PCIE_ERROR_PORT_PCIE_TO_PCI_BRIDGE 0x00000007
957 #define EFI_PCIE_ERROR_PORT_PCI_TO_PCIE_BRIDGE 0x00000008
958 #define EFI_PCIE_ERROR_PORT_ROOT_INT_ENDPOINT 0x00000009
959 #define EFI_PCIE_ERROR_PORT_ROOT_EVENT_COLLECTOR 0x0000000A
968 } EFI_GENERIC_ERROR_PCI_SLOT
;
971 /// PCIe Root Port PCI/bridge PCI compatible device number and
972 /// bus number information to uniquely identify the root port or
973 /// bridge. Default values for both the bus numbers is zero.
982 UINT8 PrimaryOrDeviceBus
;
984 EFI_GENERIC_ERROR_PCI_SLOT Slot
;
986 } EFI_GENERIC_ERROR_PCIE_DEV_BRIDGE_ID
;
989 /// PCIe Capability Structure
993 } EFI_PCIE_ERROR_DATA_CAPABILITY
;
996 /// PCIe Advanced Error Reporting Extended Capability Structure.
1000 } EFI_PCIE_ERROR_DATA_AER
;
1003 /// PCI Express Error Record
1009 UINT32 CommandStatus
;
1011 EFI_GENERIC_ERROR_PCIE_DEV_BRIDGE_ID DevBridge
;
1013 UINT32 BridgeControlStatus
;
1014 EFI_PCIE_ERROR_DATA_CAPABILITY Capability
;
1015 EFI_PCIE_ERROR_DATA_AER AerInfo
;
1016 } EFI_PCIE_ERROR_DATA
;
1019 /// Validation bits Indicates which of the following fields is valid
1020 /// in PCI/PCI-X Bus Error Section.
1022 #define EFI_PCI_PCIX_BUS_ERROR_STATUS_VALID BIT0
1023 #define EFI_PCI_PCIX_BUS_ERROR_TYPE_VALID BIT1
1024 #define EFI_PCI_PCIX_BUS_ERROR_BUS_ID_VALID BIT2
1025 #define EFI_PCI_PCIX_BUS_ERROR_BUS_ADDRESS_VALID BIT3
1026 #define EFI_PCI_PCIX_BUS_ERROR_BUS_DATA_VALID BIT4
1027 #define EFI_PCI_PCIX_BUS_ERROR_COMMAND_VALID BIT5
1028 #define EFI_PCI_PCIX_BUS_ERROR_REQUESTOR_ID_VALID BIT6
1029 #define EFI_PCI_PCIX_BUS_ERROR_COMPLETER_ID_VALID BIT7
1030 #define EFI_PCI_PCIX_BUS_ERROR_TARGET_ID_VALID BIT8
1034 /// PCI Bus Error Type in PCI/PCI-X Bus Error Section
1036 #define EFI_PCI_PCIX_BUS_ERROR_UNKNOWN 0x0000
1037 #define EFI_PCI_PCIX_BUS_ERROR_DATA_PARITY 0x0001
1038 #define EFI_PCI_PCIX_BUS_ERROR_SYSTEM 0x0002
1039 #define EFI_PCI_PCIX_BUS_ERROR_MASTER_ABORT 0x0003
1040 #define EFI_PCI_PCIX_BUS_ERROR_BUS_TIMEOUT 0x0004
1041 #define EFI_PCI_PCIX_BUS_ERROR_MASTER_DATA_PARITY 0x0005
1042 #define EFI_PCI_PCIX_BUS_ERROR_ADDRESS_PARITY 0x0006
1043 #define EFI_PCI_PCIX_BUS_ERROR_COMMAND_PARITY 0x0007
1047 /// PCI/PCI-X Bus Error Section
1051 EFI_GENERIC_ERROR_STATUS ErrorStatus
;
1061 } EFI_PCI_PCIX_BUS_ERROR_DATA
;
1064 /// Validation bits Indicates which of the following fields is valid
1065 /// in PCI/PCI-X Component Error Section.
1067 #define EFI_PCI_PCIX_DEVICE_ERROR_STATUS_VALID BIT0
1068 #define EFI_PCI_PCIX_DEVICE_ERROR_ID_INFO_VALID BIT1
1069 #define EFI_PCI_PCIX_DEVICE_ERROR_MEM_NUM_VALID BIT2
1070 #define EFI_PCI_PCIX_DEVICE_ERROR_IO_NUM_VALID BIT3
1071 #define EFI_PCI_PCIX_DEVICE_ERROR_REG_DATA_PAIR_VALID BIT4
1075 /// PCI/PCI-X Device Identification Information
1087 } EFI_GENERIC_ERROR_PCI_DEVICE_ID
;
1090 /// Identifies the type of firmware error record
1092 #define EFI_FIRMWARE_ERROR_TYPE_IPF_SAL 0x00
1095 /// Firmware Error Record Section
1101 } EFI_FIRMWARE_ERROR_DATA
;
1104 /// Fault Reason in DMAr Generic Error Section
1106 #define EFI_DMA_FAULT_REASON_TABLE_ENTRY_NOT_PRESENT 0x01
1107 #define EFI_DMA_FAULT_REASON_TABLE_ENTRY_INVALID 0x02
1108 #define EFI_DMA_FAULT_REASON_ACCESS_MAPPING_TABLE_ERROR 0x03
1109 #define EFI_DMA_FAULT_REASON_RESV_BIT_ERROR_IN_MAPPING_TABLE 0x04
1110 #define EFI_DMA_FAULT_REASON_ACCESS_ADDR_OUT_OF_SPACE 0x05
1111 #define EFI_DMA_FAULT_REASON_INVALID_ACCESS 0x06
1112 #define EFI_DMA_FAULT_REASON_INVALID_REQUEST 0x07
1113 #define EFI_DMA_FAULT_REASON_ACCESS_TRANSLATE_TABLE_ERROR 0x08
1114 #define EFI_DMA_FAULT_REASON_RESV_BIT_ERROR_IN_TRANSLATE_TABLE 0x09
1115 #define EFI_DMA_FAULT_REASON_INVALID_COMMAOND 0x0A
1116 #define EFI_DMA_FAULT_REASON_ACCESS_COMMAND_BUFFER_ERROR 0x0B
1120 /// DMA access type in DMAr Generic Error Section
1122 #define EFI_DMA_ACCESS_TYPE_READ 0x00
1123 #define EFI_DMA_ACCESS_TYPE_WRITE 0x01
1127 /// DMA address type in DMAr Generic Error Section
1129 #define EFI_DMA_ADDRESS_UNTRANSLATED 0x00
1130 #define EFI_DMA_ADDRESS_TRANSLATION 0x01
1134 /// Architecture type in DMAr Generic Error Section
1136 #define EFI_DMA_ARCH_TYPE_VT 0x01
1137 #define EFI_DMA_ARCH_TYPE_IOMMU 0x02
1141 /// DMAr Generic Error Section
1145 UINT16 SegmentNumber
;
1152 } EFI_DMAR_GENERIC_ERROR_DATA
;
1155 /// Intel VT for Directed I/O specific DMAr Errors
1162 UINT64 CapabilityEx
;
1163 UINT32 GlobalCommand
;
1164 UINT32 GlobalStatus
;
1167 UINT64 FaultRecord
[2];
1168 UINT64 RootEntry
[2];
1169 UINT64 ContextEntry
[2];
1176 } EFI_DIRECTED_IO_DMAR_ERROR_DATA
;
1179 /// IOMMU specific DMAr Errors
1187 UINT64 EventLogEntry
[2];
1189 UINT64 DeviceTableEntry
[4];
1196 } EFI_IOMMU_DMAR_ERROR_DATA
;
1200 extern EFI_GUID gEfiEventNotificationTypeCmcGuid
;
1201 extern EFI_GUID gEfiEventNotificationTypeCpeGuid
;
1202 extern EFI_GUID gEfiEventNotificationTypeMceGuid
;
1203 extern EFI_GUID gEfiEventNotificationTypePcieGuid
;
1204 extern EFI_GUID gEfiEventNotificationTypeInitGuid
;
1205 extern EFI_GUID gEfiEventNotificationTypeNmiGuid
;
1206 extern EFI_GUID gEfiEventNotificationTypeBootGuid
;
1207 extern EFI_GUID gEfiEventNotificationTypeDmarGuid
;
1209 extern EFI_GUID gEfiProcessorGenericErrorSectionGuid
;
1210 extern EFI_GUID gEfiProcessorSpecificErrorSectionGuid
;
1211 extern EFI_GUID gEfiIa32X64ProcessorErrorSectionGuid
;
1212 extern EFI_GUID gEfiArmProcessorErrorSectionGuid
;
1213 extern EFI_GUID gEfiPlatformMemoryErrorSectionGuid
;
1214 extern EFI_GUID gEfiPlatformMemory2ErrorSectionGuid
;
1215 extern EFI_GUID gEfiPcieErrorSectionGuid
;
1216 extern EFI_GUID gEfiFirmwareErrorSectionGuid
;
1217 extern EFI_GUID gEfiPciBusErrorSectionGuid
;
1218 extern EFI_GUID gEfiPciDevErrorSectionGuid
;
1219 extern EFI_GUID gEfiDMArGenericErrorSectionGuid
;
1220 extern EFI_GUID gEfiDirectedIoDMArErrorSectionGuid
;
1221 extern EFI_GUID gEfiIommuDMArErrorSectionGuid
;
1223 #if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
1225 /// IA32 and x64 Specific definitions.
1228 extern EFI_GUID gEfiIa32X64ErrorTypeCacheCheckGuid
;
1229 extern EFI_GUID gEfiIa32X64ErrorTypeTlbCheckGuid
;
1230 extern EFI_GUID gEfiIa32X64ErrorTypeBusCheckGuid
;
1231 extern EFI_GUID gEfiIa32X64ErrorTypeMsCheckGuid
;