1 /* SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 */
2 /******************************************************************************
4 * Name: actbl1.h - Additional ACPI table definitions
6 * Copyright (C) 2000 - 2021, Intel Corp.
8 *****************************************************************************/
13 /*******************************************************************************
15 * Additional ACPI Tables
17 * These tables are not consumed directly by the ACPICA subsystem, but are
18 * included here to support device drivers and the AML disassembler.
20 ******************************************************************************/
23 * Values for description table header signatures for tables defined in this
24 * file. Useful because they make it more difficult to inadvertently type in
25 * the wrong signature.
27 #define ACPI_SIG_ASF "ASF!" /* Alert Standard Format table */
28 #define ACPI_SIG_BERT "BERT" /* Boot Error Record Table */
29 #define ACPI_SIG_BGRT "BGRT" /* Boot Graphics Resource Table */
30 #define ACPI_SIG_BOOT "BOOT" /* Simple Boot Flag Table */
31 #define ACPI_SIG_CEDT "CEDT" /* CXL Early Discovery Table */
32 #define ACPI_SIG_CPEP "CPEP" /* Corrected Platform Error Polling table */
33 #define ACPI_SIG_CSRT "CSRT" /* Core System Resource Table */
34 #define ACPI_SIG_DBG2 "DBG2" /* Debug Port table type 2 */
35 #define ACPI_SIG_DBGP "DBGP" /* Debug Port table */
36 #define ACPI_SIG_DMAR "DMAR" /* DMA Remapping table */
37 #define ACPI_SIG_DRTM "DRTM" /* Dynamic Root of Trust for Measurement table */
38 #define ACPI_SIG_ECDT "ECDT" /* Embedded Controller Boot Resources Table */
39 #define ACPI_SIG_EINJ "EINJ" /* Error Injection table */
40 #define ACPI_SIG_ERST "ERST" /* Error Record Serialization Table */
41 #define ACPI_SIG_FPDT "FPDT" /* Firmware Performance Data Table */
42 #define ACPI_SIG_GTDT "GTDT" /* Generic Timer Description Table */
43 #define ACPI_SIG_HEST "HEST" /* Hardware Error Source Table */
44 #define ACPI_SIG_HMAT "HMAT" /* Heterogeneous Memory Attributes Table */
45 #define ACPI_SIG_HPET "HPET" /* High Precision Event Timer table */
46 #define ACPI_SIG_IBFT "IBFT" /* iSCSI Boot Firmware Table */
48 #define ACPI_SIG_S3PT "S3PT" /* S3 Performance (sub)Table */
49 #define ACPI_SIG_PCCS "PCC" /* PCC Shared Memory Region */
51 /* Reserved table signatures */
53 #define ACPI_SIG_MATR "MATR" /* Memory Address Translation Table */
54 #define ACPI_SIG_MSDM "MSDM" /* Microsoft Data Management Table */
57 * These tables have been seen in the field, but no definition has been found
59 #ifdef ACPI_UNDEFINED_TABLES
60 #define ACPI_SIG_ATKG "ATKG"
61 #define ACPI_SIG_GSCI "GSCI" /* GMCH SCI table */
62 #define ACPI_SIG_IEIT "IEIT"
66 * All tables must be byte-packed to match the ACPI specification, since
67 * the tables are provided by the system BIOS.
72 * Note: C bitfields are not used for this reason:
74 * "Bitfields are great and easy to read, but unfortunately the C language
75 * does not specify the layout of bitfields in memory, which means they are
76 * essentially useless for dealing with packed data in on-disk formats or
77 * binary wire protocols." (Or ACPI tables and buffers.) "If you ask me,
78 * this decision was a design error in C. Ritchie could have picked an order
79 * and stuck with it." Norman Ramsey.
80 * See http://stackoverflow.com/a/1053662/41661
83 /*******************************************************************************
85 * Common subtable headers
87 ******************************************************************************/
89 /* Generic subtable header (used in MADT, SRAT, etc.) */
91 struct acpi_subtable_header {
96 /* Subtable header for WHEA tables (EINJ, ERST, WDAT) */
98 struct acpi_whea_header {
103 struct acpi_generic_address register_region;
104 u64 value; /* Value used with Read/Write register */
105 u64 mask; /* Bitmask required for this register instruction */
108 /*******************************************************************************
110 * ASF - Alert Standard Format table (Signature "ASF!")
113 * Conforms to the Alert Standard Format Specification V2.0, 23 April 2003
115 ******************************************************************************/
117 struct acpi_table_asf {
118 struct acpi_table_header header; /* Common ACPI table header */
121 /* ASF subtable header */
123 struct acpi_asf_header {
129 /* Values for Type field above */
132 ACPI_ASF_TYPE_INFO = 0,
133 ACPI_ASF_TYPE_ALERT = 1,
134 ACPI_ASF_TYPE_CONTROL = 2,
135 ACPI_ASF_TYPE_BOOT = 3,
136 ACPI_ASF_TYPE_ADDRESS = 4,
137 ACPI_ASF_TYPE_RESERVED = 5
144 /* 0: ASF Information */
146 struct acpi_asf_info {
147 struct acpi_asf_header header;
149 u8 min_poll_interval;
156 /* Masks for Flags field above */
158 #define ACPI_ASF_SMBUS_PROTOCOLS (1)
162 struct acpi_asf_alert {
163 struct acpi_asf_header header;
170 struct acpi_asf_alert_data {
185 /* 2: ASF Remote Control */
187 struct acpi_asf_remote {
188 struct acpi_asf_header header;
194 struct acpi_asf_control_data {
201 /* 3: ASF RMCP Boot Options */
203 struct acpi_asf_rmcp {
204 struct acpi_asf_header header;
216 struct acpi_asf_address {
217 struct acpi_asf_header header;
222 /*******************************************************************************
224 * BERT - Boot Error Record Table (ACPI 4.0)
227 ******************************************************************************/
229 struct acpi_table_bert {
230 struct acpi_table_header header; /* Common ACPI table header */
231 u32 region_length; /* Length of the boot error region */
232 u64 address; /* Physical address of the error region */
235 /* Boot Error Region (not a subtable, pointed to by Address field above) */
237 struct acpi_bert_region {
238 u32 block_status; /* Type of error information */
239 u32 raw_data_offset; /* Offset to raw error data */
240 u32 raw_data_length; /* Length of raw error data */
241 u32 data_length; /* Length of generic error data */
242 u32 error_severity; /* Severity code */
245 /* Values for block_status flags above */
247 #define ACPI_BERT_UNCORRECTABLE (1)
248 #define ACPI_BERT_CORRECTABLE (1<<1)
249 #define ACPI_BERT_MULTIPLE_UNCORRECTABLE (1<<2)
250 #define ACPI_BERT_MULTIPLE_CORRECTABLE (1<<3)
251 #define ACPI_BERT_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
253 /* Values for error_severity above */
255 enum acpi_bert_error_severity {
256 ACPI_BERT_ERROR_CORRECTABLE = 0,
257 ACPI_BERT_ERROR_FATAL = 1,
258 ACPI_BERT_ERROR_CORRECTED = 2,
259 ACPI_BERT_ERROR_NONE = 3,
260 ACPI_BERT_ERROR_RESERVED = 4 /* 4 and greater are reserved */
264 * Note: The generic error data that follows the error_severity field above
265 * uses the struct acpi_hest_generic_data defined under the HEST table below
268 /*******************************************************************************
270 * BGRT - Boot Graphics Resource Table (ACPI 5.0)
273 ******************************************************************************/
275 struct acpi_table_bgrt {
276 struct acpi_table_header header; /* Common ACPI table header */
285 /* Flags for Status field above */
287 #define ACPI_BGRT_DISPLAYED (1)
288 #define ACPI_BGRT_ORIENTATION_OFFSET (3 << 1)
290 /*******************************************************************************
292 * BOOT - Simple Boot Flag Table
295 * Conforms to the "Simple Boot Flag Specification", Version 2.1
297 ******************************************************************************/
299 struct acpi_table_boot {
300 struct acpi_table_header header; /* Common ACPI table header */
301 u8 cmos_index; /* Index in CMOS RAM for the boot register */
305 /*******************************************************************************
307 * CEDT - CXL Early Discovery Table
310 * Conforms to the "CXL Early Discovery Table" (CXL 2.0)
312 ******************************************************************************/
314 struct acpi_table_cedt {
315 struct acpi_table_header header; /* Common ACPI table header */
318 /* CEDT subtable header (Performance Record Structure) */
320 struct acpi_cedt_header {
326 /* Values for Type field above */
328 enum acpi_cedt_type {
329 ACPI_CEDT_TYPE_CHBS = 0,
330 ACPI_CEDT_TYPE_CFMWS = 1,
331 ACPI_CEDT_TYPE_RESERVED = 2,
334 /* Values for version field above */
336 #define ACPI_CEDT_CHBS_VERSION_CXL11 (0)
337 #define ACPI_CEDT_CHBS_VERSION_CXL20 (1)
339 /* Values for length field above */
341 #define ACPI_CEDT_CHBS_LENGTH_CXL11 (0x2000)
342 #define ACPI_CEDT_CHBS_LENGTH_CXL20 (0x10000)
348 /* 0: CXL Host Bridge Structure */
350 struct acpi_cedt_chbs {
351 struct acpi_cedt_header header;
359 /* 1: CXL Fixed Memory Window Structure */
361 struct acpi_cedt_cfmws {
362 struct acpi_cedt_header header;
367 u8 interleave_arithmetic;
372 u32 interleave_targets[];
375 /* Values for Interleave Arithmetic field above */
377 #define ACPI_CEDT_CFMWS_ARITHMETIC_MODULO (0)
379 /* Values for Restrictions field above */
381 #define ACPI_CEDT_CFMWS_RESTRICT_TYPE2 (1)
382 #define ACPI_CEDT_CFMWS_RESTRICT_TYPE3 (1<<1)
383 #define ACPI_CEDT_CFMWS_RESTRICT_VOLATILE (1<<2)
384 #define ACPI_CEDT_CFMWS_RESTRICT_PMEM (1<<3)
385 #define ACPI_CEDT_CFMWS_RESTRICT_FIXED (1<<4)
387 /*******************************************************************************
389 * CPEP - Corrected Platform Error Polling table (ACPI 4.0)
392 ******************************************************************************/
394 struct acpi_table_cpep {
395 struct acpi_table_header header; /* Common ACPI table header */
401 struct acpi_cpep_polling {
402 struct acpi_subtable_header header;
403 u8 id; /* Processor ID */
404 u8 eid; /* Processor EID */
405 u32 interval; /* Polling interval (msec) */
408 /*******************************************************************************
410 * CSRT - Core System Resource Table
413 * Conforms to the "Core System Resource Table (CSRT)", November 14, 2011
415 ******************************************************************************/
417 struct acpi_table_csrt {
418 struct acpi_table_header header; /* Common ACPI table header */
421 /* Resource Group subtable */
423 struct acpi_csrt_group {
431 u32 shared_info_length;
433 /* Shared data immediately follows (Length = shared_info_length) */
436 /* Shared Info subtable */
438 struct acpi_csrt_shared_info {
444 u8 interrupt_polarity;
447 u8 dma_address_width;
448 u16 base_request_line;
449 u16 num_handshake_signals;
452 /* Resource descriptors immediately follow (Length = Group length - shared_info_length) */
455 /* Resource Descriptor subtable */
457 struct acpi_csrt_descriptor {
463 /* Resource-specific information immediately follows */
468 #define ACPI_CSRT_TYPE_INTERRUPT 0x0001
469 #define ACPI_CSRT_TYPE_TIMER 0x0002
470 #define ACPI_CSRT_TYPE_DMA 0x0003
472 /* Resource Subtypes */
474 #define ACPI_CSRT_XRUPT_LINE 0x0000
475 #define ACPI_CSRT_XRUPT_CONTROLLER 0x0001
476 #define ACPI_CSRT_TIMER 0x0000
477 #define ACPI_CSRT_DMA_CHANNEL 0x0000
478 #define ACPI_CSRT_DMA_CONTROLLER 0x0001
480 /*******************************************************************************
482 * DBG2 - Debug Port Table 2
483 * Version 0 (Both main table and subtables)
485 * Conforms to "Microsoft Debug Port Table 2 (DBG2)", December 10, 2015
487 ******************************************************************************/
489 struct acpi_table_dbg2 {
490 struct acpi_table_header header; /* Common ACPI table header */
495 struct acpi_dbg2_header {
500 /* Debug Device Information Subtable */
502 struct acpi_dbg2_device {
505 u8 register_count; /* Number of base_address registers */
513 u16 base_address_offset;
514 u16 address_size_offset;
517 * base_address (required) - Each in 12-byte Generic Address Structure format.
518 * address_size (required) - Array of u32 sizes corresponding to each base_address register.
519 * Namepath (required) - Null terminated string. Single dot if not supported.
520 * oem_data (optional) - Length is oem_data_length.
524 /* Types for port_type field above */
526 #define ACPI_DBG2_SERIAL_PORT 0x8000
527 #define ACPI_DBG2_1394_PORT 0x8001
528 #define ACPI_DBG2_USB_PORT 0x8002
529 #define ACPI_DBG2_NET_PORT 0x8003
531 /* Subtypes for port_subtype field above */
533 #define ACPI_DBG2_16550_COMPATIBLE 0x0000
534 #define ACPI_DBG2_16550_SUBSET 0x0001
535 #define ACPI_DBG2_ARM_PL011 0x0003
536 #define ACPI_DBG2_ARM_SBSA_32BIT 0x000D
537 #define ACPI_DBG2_ARM_SBSA_GENERIC 0x000E
538 #define ACPI_DBG2_ARM_DCC 0x000F
539 #define ACPI_DBG2_BCM2835 0x0010
541 #define ACPI_DBG2_1394_STANDARD 0x0000
543 #define ACPI_DBG2_USB_XHCI 0x0000
544 #define ACPI_DBG2_USB_EHCI 0x0001
546 /*******************************************************************************
548 * DBGP - Debug Port table
551 * Conforms to the "Debug Port Specification", Version 1.00, 2/9/2000
553 ******************************************************************************/
555 struct acpi_table_dbgp {
556 struct acpi_table_header header; /* Common ACPI table header */
557 u8 type; /* 0=full 16550, 1=subset of 16550 */
559 struct acpi_generic_address debug_port;
562 /*******************************************************************************
564 * DMAR - DMA Remapping table
567 * Conforms to "Intel Virtualization Technology for Directed I/O",
568 * Version 2.3, October 2014
570 ******************************************************************************/
572 struct acpi_table_dmar {
573 struct acpi_table_header header; /* Common ACPI table header */
574 u8 width; /* Host Address Width */
579 /* Masks for Flags field above */
581 #define ACPI_DMAR_INTR_REMAP (1)
582 #define ACPI_DMAR_X2APIC_OPT_OUT (1<<1)
583 #define ACPI_DMAR_X2APIC_MODE (1<<2)
585 /* DMAR subtable header */
587 struct acpi_dmar_header {
592 /* Values for subtable type in struct acpi_dmar_header */
594 enum acpi_dmar_type {
595 ACPI_DMAR_TYPE_HARDWARE_UNIT = 0,
596 ACPI_DMAR_TYPE_RESERVED_MEMORY = 1,
597 ACPI_DMAR_TYPE_ROOT_ATS = 2,
598 ACPI_DMAR_TYPE_HARDWARE_AFFINITY = 3,
599 ACPI_DMAR_TYPE_NAMESPACE = 4,
600 ACPI_DMAR_TYPE_SATC = 5,
601 ACPI_DMAR_TYPE_RESERVED = 6 /* 6 and greater are reserved */
604 /* DMAR Device Scope structure */
606 struct acpi_dmar_device_scope {
614 /* Values for entry_type in struct acpi_dmar_device_scope - device types */
616 enum acpi_dmar_scope_type {
617 ACPI_DMAR_SCOPE_TYPE_NOT_USED = 0,
618 ACPI_DMAR_SCOPE_TYPE_ENDPOINT = 1,
619 ACPI_DMAR_SCOPE_TYPE_BRIDGE = 2,
620 ACPI_DMAR_SCOPE_TYPE_IOAPIC = 3,
621 ACPI_DMAR_SCOPE_TYPE_HPET = 4,
622 ACPI_DMAR_SCOPE_TYPE_NAMESPACE = 5,
623 ACPI_DMAR_SCOPE_TYPE_RESERVED = 6 /* 6 and greater are reserved */
626 struct acpi_dmar_pci_path {
632 * DMAR Subtables, correspond to Type in struct acpi_dmar_header
635 /* 0: Hardware Unit Definition */
637 struct acpi_dmar_hardware_unit {
638 struct acpi_dmar_header header;
642 u64 address; /* Register Base Address */
645 /* Masks for Flags field above */
647 #define ACPI_DMAR_INCLUDE_ALL (1)
649 /* 1: Reserved Memory Definition */
651 struct acpi_dmar_reserved_memory {
652 struct acpi_dmar_header header;
655 u64 base_address; /* 4K aligned base address */
656 u64 end_address; /* 4K aligned limit address */
659 /* Masks for Flags field above */
661 #define ACPI_DMAR_ALLOW_ALL (1)
663 /* 2: Root Port ATS Capability Reporting Structure */
665 struct acpi_dmar_atsr {
666 struct acpi_dmar_header header;
672 /* Masks for Flags field above */
674 #define ACPI_DMAR_ALL_PORTS (1)
676 /* 3: Remapping Hardware Static Affinity Structure */
678 struct acpi_dmar_rhsa {
679 struct acpi_dmar_header header;
682 u32 proximity_domain;
685 /* 4: ACPI Namespace Device Declaration Structure */
687 struct acpi_dmar_andd {
688 struct acpi_dmar_header header;
694 /* 5: SOC Integrated Address Translation Cache Reporting Structure */
696 struct acpi_dmar_satc {
697 struct acpi_dmar_header header;
702 /*******************************************************************************
704 * DRTM - Dynamic Root of Trust for Measurement table
705 * Conforms to "TCG D-RTM Architecture" June 17 2013, Version 1.0.0
708 ******************************************************************************/
710 struct acpi_table_drtm {
711 struct acpi_table_header header; /* Common ACPI table header */
712 u64 entry_base_address;
717 u64 log_area_address;
719 u64 arch_dependent_address;
723 /* Flag Definitions for above */
725 #define ACPI_DRTM_ACCESS_ALLOWED (1)
726 #define ACPI_DRTM_ENABLE_GAP_CODE (1<<1)
727 #define ACPI_DRTM_INCOMPLETE_MEASUREMENTS (1<<2)
728 #define ACPI_DRTM_AUTHORITY_ORDER (1<<3)
730 /* 1) Validated Tables List (64-bit addresses) */
732 struct acpi_drtm_vtable_list {
733 u32 validated_table_count;
734 u64 validated_tables[1];
737 /* 2) Resources List (of Resource Descriptors) */
739 /* Resource Descriptor */
741 struct acpi_drtm_resource {
747 struct acpi_drtm_resource_list {
749 struct acpi_drtm_resource resources[1];
752 /* 3) Platform-specific Identifiers List */
754 struct acpi_drtm_dps_id {
759 /*******************************************************************************
761 * ECDT - Embedded Controller Boot Resources Table
764 ******************************************************************************/
766 struct acpi_table_ecdt {
767 struct acpi_table_header header; /* Common ACPI table header */
768 struct acpi_generic_address control; /* Address of EC command/status register */
769 struct acpi_generic_address data; /* Address of EC data register */
770 u32 uid; /* Unique ID - must be same as the EC _UID method */
771 u8 gpe; /* The GPE for the EC */
772 u8 id[1]; /* Full namepath of the EC in the ACPI namespace */
775 /*******************************************************************************
777 * EINJ - Error Injection Table (ACPI 4.0)
780 ******************************************************************************/
782 struct acpi_table_einj {
783 struct acpi_table_header header; /* Common ACPI table header */
790 /* EINJ Injection Instruction Entries (actions) */
792 struct acpi_einj_entry {
793 struct acpi_whea_header whea_header; /* Common header for WHEA tables */
796 /* Masks for Flags field above */
798 #define ACPI_EINJ_PRESERVE (1)
800 /* Values for Action field above */
802 enum acpi_einj_actions {
803 ACPI_EINJ_BEGIN_OPERATION = 0,
804 ACPI_EINJ_GET_TRIGGER_TABLE = 1,
805 ACPI_EINJ_SET_ERROR_TYPE = 2,
806 ACPI_EINJ_GET_ERROR_TYPE = 3,
807 ACPI_EINJ_END_OPERATION = 4,
808 ACPI_EINJ_EXECUTE_OPERATION = 5,
809 ACPI_EINJ_CHECK_BUSY_STATUS = 6,
810 ACPI_EINJ_GET_COMMAND_STATUS = 7,
811 ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS = 8,
812 ACPI_EINJ_GET_EXECUTE_TIMINGS = 9,
813 ACPI_EINJ_ACTION_RESERVED = 10, /* 10 and greater are reserved */
814 ACPI_EINJ_TRIGGER_ERROR = 0xFF /* Except for this value */
817 /* Values for Instruction field above */
819 enum acpi_einj_instructions {
820 ACPI_EINJ_READ_REGISTER = 0,
821 ACPI_EINJ_READ_REGISTER_VALUE = 1,
822 ACPI_EINJ_WRITE_REGISTER = 2,
823 ACPI_EINJ_WRITE_REGISTER_VALUE = 3,
825 ACPI_EINJ_FLUSH_CACHELINE = 5,
826 ACPI_EINJ_INSTRUCTION_RESERVED = 6 /* 6 and greater are reserved */
829 struct acpi_einj_error_type_with_addr {
831 u32 vendor_struct_offset;
839 struct acpi_einj_vendor {
848 /* EINJ Trigger Error Action Table */
850 struct acpi_einj_trigger {
857 /* Command status return values */
859 enum acpi_einj_command_status {
860 ACPI_EINJ_SUCCESS = 0,
861 ACPI_EINJ_FAILURE = 1,
862 ACPI_EINJ_INVALID_ACCESS = 2,
863 ACPI_EINJ_STATUS_RESERVED = 3 /* 3 and greater are reserved */
866 /* Error types returned from ACPI_EINJ_GET_ERROR_TYPE (bitfield) */
868 #define ACPI_EINJ_PROCESSOR_CORRECTABLE (1)
869 #define ACPI_EINJ_PROCESSOR_UNCORRECTABLE (1<<1)
870 #define ACPI_EINJ_PROCESSOR_FATAL (1<<2)
871 #define ACPI_EINJ_MEMORY_CORRECTABLE (1<<3)
872 #define ACPI_EINJ_MEMORY_UNCORRECTABLE (1<<4)
873 #define ACPI_EINJ_MEMORY_FATAL (1<<5)
874 #define ACPI_EINJ_PCIX_CORRECTABLE (1<<6)
875 #define ACPI_EINJ_PCIX_UNCORRECTABLE (1<<7)
876 #define ACPI_EINJ_PCIX_FATAL (1<<8)
877 #define ACPI_EINJ_PLATFORM_CORRECTABLE (1<<9)
878 #define ACPI_EINJ_PLATFORM_UNCORRECTABLE (1<<10)
879 #define ACPI_EINJ_PLATFORM_FATAL (1<<11)
880 #define ACPI_EINJ_VENDOR_DEFINED (1<<31)
882 /*******************************************************************************
884 * ERST - Error Record Serialization Table (ACPI 4.0)
887 ******************************************************************************/
889 struct acpi_table_erst {
890 struct acpi_table_header header; /* Common ACPI table header */
896 /* ERST Serialization Entries (actions) */
898 struct acpi_erst_entry {
899 struct acpi_whea_header whea_header; /* Common header for WHEA tables */
902 /* Masks for Flags field above */
904 #define ACPI_ERST_PRESERVE (1)
906 /* Values for Action field above */
908 enum acpi_erst_actions {
909 ACPI_ERST_BEGIN_WRITE = 0,
910 ACPI_ERST_BEGIN_READ = 1,
911 ACPI_ERST_BEGIN_CLEAR = 2,
913 ACPI_ERST_SET_RECORD_OFFSET = 4,
914 ACPI_ERST_EXECUTE_OPERATION = 5,
915 ACPI_ERST_CHECK_BUSY_STATUS = 6,
916 ACPI_ERST_GET_COMMAND_STATUS = 7,
917 ACPI_ERST_GET_RECORD_ID = 8,
918 ACPI_ERST_SET_RECORD_ID = 9,
919 ACPI_ERST_GET_RECORD_COUNT = 10,
920 ACPI_ERST_BEGIN_DUMMY_WRIITE = 11,
921 ACPI_ERST_NOT_USED = 12,
922 ACPI_ERST_GET_ERROR_RANGE = 13,
923 ACPI_ERST_GET_ERROR_LENGTH = 14,
924 ACPI_ERST_GET_ERROR_ATTRIBUTES = 15,
925 ACPI_ERST_EXECUTE_TIMINGS = 16,
926 ACPI_ERST_ACTION_RESERVED = 17 /* 17 and greater are reserved */
929 /* Values for Instruction field above */
931 enum acpi_erst_instructions {
932 ACPI_ERST_READ_REGISTER = 0,
933 ACPI_ERST_READ_REGISTER_VALUE = 1,
934 ACPI_ERST_WRITE_REGISTER = 2,
935 ACPI_ERST_WRITE_REGISTER_VALUE = 3,
937 ACPI_ERST_LOAD_VAR1 = 5,
938 ACPI_ERST_LOAD_VAR2 = 6,
939 ACPI_ERST_STORE_VAR1 = 7,
941 ACPI_ERST_SUBTRACT = 9,
942 ACPI_ERST_ADD_VALUE = 10,
943 ACPI_ERST_SUBTRACT_VALUE = 11,
944 ACPI_ERST_STALL = 12,
945 ACPI_ERST_STALL_WHILE_TRUE = 13,
946 ACPI_ERST_SKIP_NEXT_IF_TRUE = 14,
948 ACPI_ERST_SET_SRC_ADDRESS_BASE = 16,
949 ACPI_ERST_SET_DST_ADDRESS_BASE = 17,
950 ACPI_ERST_MOVE_DATA = 18,
951 ACPI_ERST_INSTRUCTION_RESERVED = 19 /* 19 and greater are reserved */
954 /* Command status return values */
956 enum acpi_erst_command_status {
957 ACPI_ERST_SUCCESS = 0,
958 ACPI_ERST_NO_SPACE = 1,
959 ACPI_ERST_NOT_AVAILABLE = 2,
960 ACPI_ERST_FAILURE = 3,
961 ACPI_ERST_RECORD_EMPTY = 4,
962 ACPI_ERST_NOT_FOUND = 5,
963 ACPI_ERST_STATUS_RESERVED = 6 /* 6 and greater are reserved */
966 /* Error Record Serialization Information */
968 struct acpi_erst_info {
969 u16 signature; /* Should be "ER" */
973 /*******************************************************************************
975 * FPDT - Firmware Performance Data Table (ACPI 5.0)
978 ******************************************************************************/
980 struct acpi_table_fpdt {
981 struct acpi_table_header header; /* Common ACPI table header */
984 /* FPDT subtable header (Performance Record Structure) */
986 struct acpi_fpdt_header {
992 /* Values for Type field above */
994 enum acpi_fpdt_type {
995 ACPI_FPDT_TYPE_BOOT = 0,
996 ACPI_FPDT_TYPE_S3PERF = 1
1003 /* 0: Firmware Basic Boot Performance Record */
1005 struct acpi_fpdt_boot_pointer {
1006 struct acpi_fpdt_header header;
1011 /* 1: S3 Performance Table Pointer Record */
1013 struct acpi_fpdt_s3pt_pointer {
1014 struct acpi_fpdt_header header;
1020 * S3PT - S3 Performance Table. This table is pointed to by the
1021 * S3 Pointer Record above.
1023 struct acpi_table_s3pt {
1024 u8 signature[4]; /* "S3PT" */
1029 * S3PT Subtables (Not part of the actual FPDT)
1032 /* Values for Type field in S3PT header */
1034 enum acpi_s3pt_type {
1035 ACPI_S3PT_TYPE_RESUME = 0,
1036 ACPI_S3PT_TYPE_SUSPEND = 1,
1037 ACPI_FPDT_BOOT_PERFORMANCE = 2
1040 struct acpi_s3pt_resume {
1041 struct acpi_fpdt_header header;
1047 struct acpi_s3pt_suspend {
1048 struct acpi_fpdt_header header;
1054 * FPDT Boot Performance Record (Not part of the actual FPDT)
1056 struct acpi_fpdt_boot {
1057 struct acpi_fpdt_header header;
1062 u64 exit_services_entry;
1063 u64 exit_services_exit;
1066 /*******************************************************************************
1068 * GTDT - Generic Timer Description Table (ACPI 5.1)
1071 ******************************************************************************/
1073 struct acpi_table_gtdt {
1074 struct acpi_table_header header; /* Common ACPI table header */
1075 u64 counter_block_addresss;
1077 u32 secure_el1_interrupt;
1078 u32 secure_el1_flags;
1079 u32 non_secure_el1_interrupt;
1080 u32 non_secure_el1_flags;
1081 u32 virtual_timer_interrupt;
1082 u32 virtual_timer_flags;
1083 u32 non_secure_el2_interrupt;
1084 u32 non_secure_el2_flags;
1085 u64 counter_read_block_address;
1086 u32 platform_timer_count;
1087 u32 platform_timer_offset;
1090 /* Flag Definitions: Timer Block Physical Timers and Virtual timers */
1092 #define ACPI_GTDT_INTERRUPT_MODE (1)
1093 #define ACPI_GTDT_INTERRUPT_POLARITY (1<<1)
1094 #define ACPI_GTDT_ALWAYS_ON (1<<2)
1096 struct acpi_gtdt_el2 {
1097 u32 virtual_el2_timer_gsiv;
1098 u32 virtual_el2_timer_flags;
1101 /* Common GTDT subtable header */
1103 struct acpi_gtdt_header {
1108 /* Values for GTDT subtable type above */
1110 enum acpi_gtdt_type {
1111 ACPI_GTDT_TYPE_TIMER_BLOCK = 0,
1112 ACPI_GTDT_TYPE_WATCHDOG = 1,
1113 ACPI_GTDT_TYPE_RESERVED = 2 /* 2 and greater are reserved */
1116 /* GTDT Subtables, correspond to Type in struct acpi_gtdt_header */
1118 /* 0: Generic Timer Block */
1120 struct acpi_gtdt_timer_block {
1121 struct acpi_gtdt_header header;
1128 /* Timer Sub-Structure, one per timer */
1130 struct acpi_gtdt_timer_entry {
1134 u64 el0_base_address;
1135 u32 timer_interrupt;
1137 u32 virtual_timer_interrupt;
1138 u32 virtual_timer_flags;
1142 /* Flag Definitions: timer_flags and virtual_timer_flags above */
1144 #define ACPI_GTDT_GT_IRQ_MODE (1)
1145 #define ACPI_GTDT_GT_IRQ_POLARITY (1<<1)
1147 /* Flag Definitions: common_flags above */
1149 #define ACPI_GTDT_GT_IS_SECURE_TIMER (1)
1150 #define ACPI_GTDT_GT_ALWAYS_ON (1<<1)
1152 /* 1: SBSA Generic Watchdog Structure */
1154 struct acpi_gtdt_watchdog {
1155 struct acpi_gtdt_header header;
1157 u64 refresh_frame_address;
1158 u64 control_frame_address;
1159 u32 timer_interrupt;
1163 /* Flag Definitions: timer_flags above */
1165 #define ACPI_GTDT_WATCHDOG_IRQ_MODE (1)
1166 #define ACPI_GTDT_WATCHDOG_IRQ_POLARITY (1<<1)
1167 #define ACPI_GTDT_WATCHDOG_SECURE (1<<2)
1169 /*******************************************************************************
1171 * HEST - Hardware Error Source Table (ACPI 4.0)
1174 ******************************************************************************/
1176 struct acpi_table_hest {
1177 struct acpi_table_header header; /* Common ACPI table header */
1178 u32 error_source_count;
1181 /* HEST subtable header */
1183 struct acpi_hest_header {
1188 /* Values for Type field above for subtables */
1190 enum acpi_hest_types {
1191 ACPI_HEST_TYPE_IA32_CHECK = 0,
1192 ACPI_HEST_TYPE_IA32_CORRECTED_CHECK = 1,
1193 ACPI_HEST_TYPE_IA32_NMI = 2,
1194 ACPI_HEST_TYPE_NOT_USED3 = 3,
1195 ACPI_HEST_TYPE_NOT_USED4 = 4,
1196 ACPI_HEST_TYPE_NOT_USED5 = 5,
1197 ACPI_HEST_TYPE_AER_ROOT_PORT = 6,
1198 ACPI_HEST_TYPE_AER_ENDPOINT = 7,
1199 ACPI_HEST_TYPE_AER_BRIDGE = 8,
1200 ACPI_HEST_TYPE_GENERIC_ERROR = 9,
1201 ACPI_HEST_TYPE_GENERIC_ERROR_V2 = 10,
1202 ACPI_HEST_TYPE_IA32_DEFERRED_CHECK = 11,
1203 ACPI_HEST_TYPE_RESERVED = 12 /* 12 and greater are reserved */
1207 * HEST substructures contained in subtables
1211 * IA32 Error Bank(s) - Follows the struct acpi_hest_ia_machine_check and
1212 * struct acpi_hest_ia_corrected structures.
1214 struct acpi_hest_ia_error_bank {
1216 u8 clear_status_on_init;
1219 u32 control_register;
1221 u32 status_register;
1222 u32 address_register;
1226 /* Common HEST sub-structure for PCI/AER structures below (6,7,8) */
1228 struct acpi_hest_aer_common {
1232 u32 records_to_preallocate;
1233 u32 max_sections_per_record;
1234 u32 bus; /* Bus and Segment numbers */
1239 u32 uncorrectable_mask;
1240 u32 uncorrectable_severity;
1241 u32 correctable_mask;
1242 u32 advanced_capabilities;
1245 /* Masks for HEST Flags fields */
1247 #define ACPI_HEST_FIRMWARE_FIRST (1)
1248 #define ACPI_HEST_GLOBAL (1<<1)
1249 #define ACPI_HEST_GHES_ASSIST (1<<2)
1252 * Macros to access the bus/segment numbers in Bus field above:
1253 * Bus number is encoded in bits 7:0
1254 * Segment number is encoded in bits 23:8
1256 #define ACPI_HEST_BUS(bus) ((bus) & 0xFF)
1257 #define ACPI_HEST_SEGMENT(bus) (((bus) >> 8) & 0xFFFF)
1259 /* Hardware Error Notification */
1261 struct acpi_hest_notify {
1264 u16 config_write_enable;
1267 u32 polling_threshold_value;
1268 u32 polling_threshold_window;
1269 u32 error_threshold_value;
1270 u32 error_threshold_window;
1273 /* Values for Notify Type field above */
1275 enum acpi_hest_notify_types {
1276 ACPI_HEST_NOTIFY_POLLED = 0,
1277 ACPI_HEST_NOTIFY_EXTERNAL = 1,
1278 ACPI_HEST_NOTIFY_LOCAL = 2,
1279 ACPI_HEST_NOTIFY_SCI = 3,
1280 ACPI_HEST_NOTIFY_NMI = 4,
1281 ACPI_HEST_NOTIFY_CMCI = 5, /* ACPI 5.0 */
1282 ACPI_HEST_NOTIFY_MCE = 6, /* ACPI 5.0 */
1283 ACPI_HEST_NOTIFY_GPIO = 7, /* ACPI 6.0 */
1284 ACPI_HEST_NOTIFY_SEA = 8, /* ACPI 6.1 */
1285 ACPI_HEST_NOTIFY_SEI = 9, /* ACPI 6.1 */
1286 ACPI_HEST_NOTIFY_GSIV = 10, /* ACPI 6.1 */
1287 ACPI_HEST_NOTIFY_SOFTWARE_DELEGATED = 11, /* ACPI 6.2 */
1288 ACPI_HEST_NOTIFY_RESERVED = 12 /* 12 and greater are reserved */
1291 /* Values for config_write_enable bitfield above */
1293 #define ACPI_HEST_TYPE (1)
1294 #define ACPI_HEST_POLL_INTERVAL (1<<1)
1295 #define ACPI_HEST_POLL_THRESHOLD_VALUE (1<<2)
1296 #define ACPI_HEST_POLL_THRESHOLD_WINDOW (1<<3)
1297 #define ACPI_HEST_ERR_THRESHOLD_VALUE (1<<4)
1298 #define ACPI_HEST_ERR_THRESHOLD_WINDOW (1<<5)
1304 /* 0: IA32 Machine Check Exception */
1306 struct acpi_hest_ia_machine_check {
1307 struct acpi_hest_header header;
1309 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1311 u32 records_to_preallocate;
1312 u32 max_sections_per_record;
1313 u64 global_capability_data;
1314 u64 global_control_data;
1315 u8 num_hardware_banks;
1319 /* 1: IA32 Corrected Machine Check */
1321 struct acpi_hest_ia_corrected {
1322 struct acpi_hest_header header;
1324 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1326 u32 records_to_preallocate;
1327 u32 max_sections_per_record;
1328 struct acpi_hest_notify notify;
1329 u8 num_hardware_banks;
1333 /* 2: IA32 Non-Maskable Interrupt */
1335 struct acpi_hest_ia_nmi {
1336 struct acpi_hest_header header;
1338 u32 records_to_preallocate;
1339 u32 max_sections_per_record;
1340 u32 max_raw_data_length;
1343 /* 3,4,5: Not used */
1345 /* 6: PCI Express Root Port AER */
1347 struct acpi_hest_aer_root {
1348 struct acpi_hest_header header;
1349 struct acpi_hest_aer_common aer;
1350 u32 root_error_command;
1353 /* 7: PCI Express AER (AER Endpoint) */
1355 struct acpi_hest_aer {
1356 struct acpi_hest_header header;
1357 struct acpi_hest_aer_common aer;
1360 /* 8: PCI Express/PCI-X Bridge AER */
1362 struct acpi_hest_aer_bridge {
1363 struct acpi_hest_header header;
1364 struct acpi_hest_aer_common aer;
1365 u32 uncorrectable_mask2;
1366 u32 uncorrectable_severity2;
1367 u32 advanced_capabilities2;
1370 /* 9: Generic Hardware Error Source */
1372 struct acpi_hest_generic {
1373 struct acpi_hest_header header;
1374 u16 related_source_id;
1377 u32 records_to_preallocate;
1378 u32 max_sections_per_record;
1379 u32 max_raw_data_length;
1380 struct acpi_generic_address error_status_address;
1381 struct acpi_hest_notify notify;
1382 u32 error_block_length;
1385 /* 10: Generic Hardware Error Source, version 2 */
1387 struct acpi_hest_generic_v2 {
1388 struct acpi_hest_header header;
1389 u16 related_source_id;
1392 u32 records_to_preallocate;
1393 u32 max_sections_per_record;
1394 u32 max_raw_data_length;
1395 struct acpi_generic_address error_status_address;
1396 struct acpi_hest_notify notify;
1397 u32 error_block_length;
1398 struct acpi_generic_address read_ack_register;
1399 u64 read_ack_preserve;
1403 /* Generic Error Status block */
1405 struct acpi_hest_generic_status {
1407 u32 raw_data_offset;
1408 u32 raw_data_length;
1413 /* Values for block_status flags above */
1415 #define ACPI_HEST_UNCORRECTABLE (1)
1416 #define ACPI_HEST_CORRECTABLE (1<<1)
1417 #define ACPI_HEST_MULTIPLE_UNCORRECTABLE (1<<2)
1418 #define ACPI_HEST_MULTIPLE_CORRECTABLE (1<<3)
1419 #define ACPI_HEST_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
1421 /* Generic Error Data entry */
1423 struct acpi_hest_generic_data {
1424 u8 section_type[16];
1429 u32 error_data_length;
1434 /* Extension for revision 0x0300 */
1436 struct acpi_hest_generic_data_v300 {
1437 u8 section_type[16];
1442 u32 error_data_length;
1448 /* Values for error_severity above */
1450 #define ACPI_HEST_GEN_ERROR_RECOVERABLE 0
1451 #define ACPI_HEST_GEN_ERROR_FATAL 1
1452 #define ACPI_HEST_GEN_ERROR_CORRECTED 2
1453 #define ACPI_HEST_GEN_ERROR_NONE 3
1455 /* Flags for validation_bits above */
1457 #define ACPI_HEST_GEN_VALID_FRU_ID (1)
1458 #define ACPI_HEST_GEN_VALID_FRU_STRING (1<<1)
1459 #define ACPI_HEST_GEN_VALID_TIMESTAMP (1<<2)
1461 /* 11: IA32 Deferred Machine Check Exception (ACPI 6.2) */
1463 struct acpi_hest_ia_deferred_check {
1464 struct acpi_hest_header header;
1466 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1468 u32 records_to_preallocate;
1469 u32 max_sections_per_record;
1470 struct acpi_hest_notify notify;
1471 u8 num_hardware_banks;
1475 /*******************************************************************************
1477 * HMAT - Heterogeneous Memory Attributes Table (ACPI 6.2)
1480 ******************************************************************************/
1482 struct acpi_table_hmat {
1483 struct acpi_table_header header; /* Common ACPI table header */
1487 /* Values for HMAT structure types */
1489 enum acpi_hmat_type {
1490 ACPI_HMAT_TYPE_PROXIMITY = 0, /* Memory proximity domain attributes */
1491 ACPI_HMAT_TYPE_LOCALITY = 1, /* System locality latency and bandwidth information */
1492 ACPI_HMAT_TYPE_CACHE = 2, /* Memory side cache information */
1493 ACPI_HMAT_TYPE_RESERVED = 3 /* 3 and greater are reserved */
1496 struct acpi_hmat_structure {
1503 * HMAT Structures, correspond to Type in struct acpi_hmat_structure
1506 /* 0: Memory proximity domain attributes */
1508 struct acpi_hmat_proximity_domain {
1509 struct acpi_hmat_structure header;
1512 u32 processor_PD; /* Processor proximity domain */
1513 u32 memory_PD; /* Memory proximity domain */
1519 /* Masks for Flags field above */
1521 #define ACPI_HMAT_PROCESSOR_PD_VALID (1) /* 1: processor_PD field is valid */
1522 #define ACPI_HMAT_MEMORY_PD_VALID (1<<1) /* 1: memory_PD field is valid */
1523 #define ACPI_HMAT_RESERVATION_HINT (1<<2) /* 1: Reservation hint */
1525 /* 1: System locality latency and bandwidth information */
1527 struct acpi_hmat_locality {
1528 struct acpi_hmat_structure header;
1531 u8 min_transfer_size;
1533 u32 number_of_initiator_Pds;
1534 u32 number_of_target_Pds;
1536 u64 entry_base_unit;
1539 /* Masks for Flags field above */
1541 #define ACPI_HMAT_MEMORY_HIERARCHY (0x0F) /* Bits 0-3 */
1543 /* Values for Memory Hierarchy flags */
1545 #define ACPI_HMAT_MEMORY 0
1546 #define ACPI_HMAT_LAST_LEVEL_CACHE 1
1547 #define ACPI_HMAT_1ST_LEVEL_CACHE 2
1548 #define ACPI_HMAT_2ND_LEVEL_CACHE 3
1549 #define ACPI_HMAT_3RD_LEVEL_CACHE 4
1550 #define ACPI_HMAT_MINIMUM_XFER_SIZE 0x10 /* Bit 4: ACPI 6.4 */
1551 #define ACPI_HMAT_NON_SEQUENTIAL_XFERS 0x20 /* Bit 5: ACPI 6.4 */
1554 /* Values for data_type field above */
1556 #define ACPI_HMAT_ACCESS_LATENCY 0
1557 #define ACPI_HMAT_READ_LATENCY 1
1558 #define ACPI_HMAT_WRITE_LATENCY 2
1559 #define ACPI_HMAT_ACCESS_BANDWIDTH 3
1560 #define ACPI_HMAT_READ_BANDWIDTH 4
1561 #define ACPI_HMAT_WRITE_BANDWIDTH 5
1563 /* 2: Memory side cache information */
1565 struct acpi_hmat_cache {
1566 struct acpi_hmat_structure header;
1570 u32 cache_attributes;
1572 u16 number_of_SMBIOShandles;
1575 /* Masks for cache_attributes field above */
1577 #define ACPI_HMAT_TOTAL_CACHE_LEVEL (0x0000000F)
1578 #define ACPI_HMAT_CACHE_LEVEL (0x000000F0)
1579 #define ACPI_HMAT_CACHE_ASSOCIATIVITY (0x00000F00)
1580 #define ACPI_HMAT_WRITE_POLICY (0x0000F000)
1581 #define ACPI_HMAT_CACHE_LINE_SIZE (0xFFFF0000)
1583 /* Values for cache associativity flag */
1585 #define ACPI_HMAT_CA_NONE (0)
1586 #define ACPI_HMAT_CA_DIRECT_MAPPED (1)
1587 #define ACPI_HMAT_CA_COMPLEX_CACHE_INDEXING (2)
1589 /* Values for write policy flag */
1591 #define ACPI_HMAT_CP_NONE (0)
1592 #define ACPI_HMAT_CP_WB (1)
1593 #define ACPI_HMAT_CP_WT (2)
1595 /*******************************************************************************
1597 * HPET - High Precision Event Timer table
1600 * Conforms to "IA-PC HPET (High Precision Event Timers) Specification",
1601 * Version 1.0a, October 2004
1603 ******************************************************************************/
1605 struct acpi_table_hpet {
1606 struct acpi_table_header header; /* Common ACPI table header */
1607 u32 id; /* Hardware ID of event timer block */
1608 struct acpi_generic_address address; /* Address of event timer block */
1609 u8 sequence; /* HPET sequence number */
1610 u16 minimum_tick; /* Main counter min tick, periodic mode */
1614 /* Masks for Flags field above */
1616 #define ACPI_HPET_PAGE_PROTECT_MASK (3)
1618 /* Values for Page Protect flags */
1620 enum acpi_hpet_page_protect {
1621 ACPI_HPET_NO_PAGE_PROTECT = 0,
1622 ACPI_HPET_PAGE_PROTECT4 = 1,
1623 ACPI_HPET_PAGE_PROTECT64 = 2
1626 /*******************************************************************************
1628 * IBFT - Boot Firmware Table
1631 * Conforms to "iSCSI Boot Firmware Table (iBFT) as Defined in ACPI 3.0b
1632 * Specification", Version 1.01, March 1, 2007
1634 * Note: It appears that this table is not intended to appear in the RSDT/XSDT.
1635 * Therefore, it is not currently supported by the disassembler.
1637 ******************************************************************************/
1639 struct acpi_table_ibft {
1640 struct acpi_table_header header; /* Common ACPI table header */
1644 /* IBFT common subtable header */
1646 struct acpi_ibft_header {
1654 /* Values for Type field above */
1656 enum acpi_ibft_type {
1657 ACPI_IBFT_TYPE_NOT_USED = 0,
1658 ACPI_IBFT_TYPE_CONTROL = 1,
1659 ACPI_IBFT_TYPE_INITIATOR = 2,
1660 ACPI_IBFT_TYPE_NIC = 3,
1661 ACPI_IBFT_TYPE_TARGET = 4,
1662 ACPI_IBFT_TYPE_EXTENSIONS = 5,
1663 ACPI_IBFT_TYPE_RESERVED = 6 /* 6 and greater are reserved */
1666 /* IBFT subtables */
1668 struct acpi_ibft_control {
1669 struct acpi_ibft_header header;
1671 u16 initiator_offset;
1678 struct acpi_ibft_initiator {
1679 struct acpi_ibft_header header;
1682 u8 primary_server[16];
1683 u8 secondary_server[16];
1688 struct acpi_ibft_nic {
1689 struct acpi_ibft_header header;
1691 u8 subnet_mask_prefix;
1695 u8 secondary_dns[16];
1704 struct acpi_ibft_target {
1705 struct acpi_ibft_header header;
1706 u8 target_ip_address[16];
1707 u16 target_ip_socket;
1708 u8 target_boot_lun[8];
1711 u16 target_name_length;
1712 u16 target_name_offset;
1713 u16 chap_name_length;
1714 u16 chap_name_offset;
1715 u16 chap_secret_length;
1716 u16 chap_secret_offset;
1717 u16 reverse_chap_name_length;
1718 u16 reverse_chap_name_offset;
1719 u16 reverse_chap_secret_length;
1720 u16 reverse_chap_secret_offset;
1723 /* Reset to default packing */
1727 #endif /* __ACTBL1_H__ */