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_CPEP "CPEP" /* Corrected Platform Error Polling table */
32 #define ACPI_SIG_CSRT "CSRT" /* Core System Resource Table */
33 #define ACPI_SIG_DBG2 "DBG2" /* Debug Port table type 2 */
34 #define ACPI_SIG_DBGP "DBGP" /* Debug Port table */
35 #define ACPI_SIG_DMAR "DMAR" /* DMA Remapping table */
36 #define ACPI_SIG_DRTM "DRTM" /* Dynamic Root of Trust for Measurement table */
37 #define ACPI_SIG_ECDT "ECDT" /* Embedded Controller Boot Resources Table */
38 #define ACPI_SIG_EINJ "EINJ" /* Error Injection table */
39 #define ACPI_SIG_ERST "ERST" /* Error Record Serialization Table */
40 #define ACPI_SIG_FPDT "FPDT" /* Firmware Performance Data Table */
41 #define ACPI_SIG_GTDT "GTDT" /* Generic Timer Description Table */
42 #define ACPI_SIG_HEST "HEST" /* Hardware Error Source Table */
43 #define ACPI_SIG_HMAT "HMAT" /* Heterogeneous Memory Attributes Table */
44 #define ACPI_SIG_HPET "HPET" /* High Precision Event Timer table */
45 #define ACPI_SIG_IBFT "IBFT" /* iSCSI Boot Firmware Table */
47 #define ACPI_SIG_S3PT "S3PT" /* S3 Performance (sub)Table */
48 #define ACPI_SIG_PCCS "PCC" /* PCC Shared Memory Region */
50 /* Reserved table signatures */
52 #define ACPI_SIG_MATR "MATR" /* Memory Address Translation Table */
53 #define ACPI_SIG_MSDM "MSDM" /* Microsoft Data Management Table */
56 * These tables have been seen in the field, but no definition has been found
58 #ifdef ACPI_UNDEFINED_TABLES
59 #define ACPI_SIG_ATKG "ATKG"
60 #define ACPI_SIG_GSCI "GSCI" /* GMCH SCI table */
61 #define ACPI_SIG_IEIT "IEIT"
65 * All tables must be byte-packed to match the ACPI specification, since
66 * the tables are provided by the system BIOS.
71 * Note: C bitfields are not used for this reason:
73 * "Bitfields are great and easy to read, but unfortunately the C language
74 * does not specify the layout of bitfields in memory, which means they are
75 * essentially useless for dealing with packed data in on-disk formats or
76 * binary wire protocols." (Or ACPI tables and buffers.) "If you ask me,
77 * this decision was a design error in C. Ritchie could have picked an order
78 * and stuck with it." Norman Ramsey.
79 * See http://stackoverflow.com/a/1053662/41661
82 /*******************************************************************************
84 * Common subtable headers
86 ******************************************************************************/
88 /* Generic subtable header (used in MADT, SRAT, etc.) */
90 struct acpi_subtable_header {
95 /* Subtable header for WHEA tables (EINJ, ERST, WDAT) */
97 struct acpi_whea_header {
102 struct acpi_generic_address register_region;
103 u64 value; /* Value used with Read/Write register */
104 u64 mask; /* Bitmask required for this register instruction */
107 /*******************************************************************************
109 * ASF - Alert Standard Format table (Signature "ASF!")
112 * Conforms to the Alert Standard Format Specification V2.0, 23 April 2003
114 ******************************************************************************/
116 struct acpi_table_asf {
117 struct acpi_table_header header; /* Common ACPI table header */
120 /* ASF subtable header */
122 struct acpi_asf_header {
128 /* Values for Type field above */
131 ACPI_ASF_TYPE_INFO = 0,
132 ACPI_ASF_TYPE_ALERT = 1,
133 ACPI_ASF_TYPE_CONTROL = 2,
134 ACPI_ASF_TYPE_BOOT = 3,
135 ACPI_ASF_TYPE_ADDRESS = 4,
136 ACPI_ASF_TYPE_RESERVED = 5
143 /* 0: ASF Information */
145 struct acpi_asf_info {
146 struct acpi_asf_header header;
148 u8 min_poll_interval;
155 /* Masks for Flags field above */
157 #define ACPI_ASF_SMBUS_PROTOCOLS (1)
161 struct acpi_asf_alert {
162 struct acpi_asf_header header;
169 struct acpi_asf_alert_data {
184 /* 2: ASF Remote Control */
186 struct acpi_asf_remote {
187 struct acpi_asf_header header;
193 struct acpi_asf_control_data {
200 /* 3: ASF RMCP Boot Options */
202 struct acpi_asf_rmcp {
203 struct acpi_asf_header header;
215 struct acpi_asf_address {
216 struct acpi_asf_header header;
221 /*******************************************************************************
223 * BERT - Boot Error Record Table (ACPI 4.0)
226 ******************************************************************************/
228 struct acpi_table_bert {
229 struct acpi_table_header header; /* Common ACPI table header */
230 u32 region_length; /* Length of the boot error region */
231 u64 address; /* Physical address of the error region */
234 /* Boot Error Region (not a subtable, pointed to by Address field above) */
236 struct acpi_bert_region {
237 u32 block_status; /* Type of error information */
238 u32 raw_data_offset; /* Offset to raw error data */
239 u32 raw_data_length; /* Length of raw error data */
240 u32 data_length; /* Length of generic error data */
241 u32 error_severity; /* Severity code */
244 /* Values for block_status flags above */
246 #define ACPI_BERT_UNCORRECTABLE (1)
247 #define ACPI_BERT_CORRECTABLE (1<<1)
248 #define ACPI_BERT_MULTIPLE_UNCORRECTABLE (1<<2)
249 #define ACPI_BERT_MULTIPLE_CORRECTABLE (1<<3)
250 #define ACPI_BERT_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
252 /* Values for error_severity above */
254 enum acpi_bert_error_severity {
255 ACPI_BERT_ERROR_CORRECTABLE = 0,
256 ACPI_BERT_ERROR_FATAL = 1,
257 ACPI_BERT_ERROR_CORRECTED = 2,
258 ACPI_BERT_ERROR_NONE = 3,
259 ACPI_BERT_ERROR_RESERVED = 4 /* 4 and greater are reserved */
263 * Note: The generic error data that follows the error_severity field above
264 * uses the struct acpi_hest_generic_data defined under the HEST table below
267 /*******************************************************************************
269 * BGRT - Boot Graphics Resource Table (ACPI 5.0)
272 ******************************************************************************/
274 struct acpi_table_bgrt {
275 struct acpi_table_header header; /* Common ACPI table header */
284 /* Flags for Status field above */
286 #define ACPI_BGRT_DISPLAYED (1)
287 #define ACPI_BGRT_ORIENTATION_OFFSET (3 << 1)
289 /*******************************************************************************
291 * BOOT - Simple Boot Flag Table
294 * Conforms to the "Simple Boot Flag Specification", Version 2.1
296 ******************************************************************************/
298 struct acpi_table_boot {
299 struct acpi_table_header header; /* Common ACPI table header */
300 u8 cmos_index; /* Index in CMOS RAM for the boot register */
304 /*******************************************************************************
306 * CPEP - Corrected Platform Error Polling table (ACPI 4.0)
309 ******************************************************************************/
311 struct acpi_table_cpep {
312 struct acpi_table_header header; /* Common ACPI table header */
318 struct acpi_cpep_polling {
319 struct acpi_subtable_header header;
320 u8 id; /* Processor ID */
321 u8 eid; /* Processor EID */
322 u32 interval; /* Polling interval (msec) */
325 /*******************************************************************************
327 * CSRT - Core System Resource Table
330 * Conforms to the "Core System Resource Table (CSRT)", November 14, 2011
332 ******************************************************************************/
334 struct acpi_table_csrt {
335 struct acpi_table_header header; /* Common ACPI table header */
338 /* Resource Group subtable */
340 struct acpi_csrt_group {
348 u32 shared_info_length;
350 /* Shared data immediately follows (Length = shared_info_length) */
353 /* Shared Info subtable */
355 struct acpi_csrt_shared_info {
361 u8 interrupt_polarity;
364 u8 dma_address_width;
365 u16 base_request_line;
366 u16 num_handshake_signals;
369 /* Resource descriptors immediately follow (Length = Group length - shared_info_length) */
372 /* Resource Descriptor subtable */
374 struct acpi_csrt_descriptor {
380 /* Resource-specific information immediately follows */
385 #define ACPI_CSRT_TYPE_INTERRUPT 0x0001
386 #define ACPI_CSRT_TYPE_TIMER 0x0002
387 #define ACPI_CSRT_TYPE_DMA 0x0003
389 /* Resource Subtypes */
391 #define ACPI_CSRT_XRUPT_LINE 0x0000
392 #define ACPI_CSRT_XRUPT_CONTROLLER 0x0001
393 #define ACPI_CSRT_TIMER 0x0000
394 #define ACPI_CSRT_DMA_CHANNEL 0x0000
395 #define ACPI_CSRT_DMA_CONTROLLER 0x0001
397 /*******************************************************************************
399 * DBG2 - Debug Port Table 2
400 * Version 0 (Both main table and subtables)
402 * Conforms to "Microsoft Debug Port Table 2 (DBG2)", December 10, 2015
404 ******************************************************************************/
406 struct acpi_table_dbg2 {
407 struct acpi_table_header header; /* Common ACPI table header */
412 struct acpi_dbg2_header {
417 /* Debug Device Information Subtable */
419 struct acpi_dbg2_device {
422 u8 register_count; /* Number of base_address registers */
430 u16 base_address_offset;
431 u16 address_size_offset;
434 * base_address (required) - Each in 12-byte Generic Address Structure format.
435 * address_size (required) - Array of u32 sizes corresponding to each base_address register.
436 * Namepath (required) - Null terminated string. Single dot if not supported.
437 * oem_data (optional) - Length is oem_data_length.
441 /* Types for port_type field above */
443 #define ACPI_DBG2_SERIAL_PORT 0x8000
444 #define ACPI_DBG2_1394_PORT 0x8001
445 #define ACPI_DBG2_USB_PORT 0x8002
446 #define ACPI_DBG2_NET_PORT 0x8003
448 /* Subtypes for port_subtype field above */
450 #define ACPI_DBG2_16550_COMPATIBLE 0x0000
451 #define ACPI_DBG2_16550_SUBSET 0x0001
452 #define ACPI_DBG2_ARM_PL011 0x0003
453 #define ACPI_DBG2_ARM_SBSA_32BIT 0x000D
454 #define ACPI_DBG2_ARM_SBSA_GENERIC 0x000E
455 #define ACPI_DBG2_ARM_DCC 0x000F
456 #define ACPI_DBG2_BCM2835 0x0010
458 #define ACPI_DBG2_1394_STANDARD 0x0000
460 #define ACPI_DBG2_USB_XHCI 0x0000
461 #define ACPI_DBG2_USB_EHCI 0x0001
463 /*******************************************************************************
465 * DBGP - Debug Port table
468 * Conforms to the "Debug Port Specification", Version 1.00, 2/9/2000
470 ******************************************************************************/
472 struct acpi_table_dbgp {
473 struct acpi_table_header header; /* Common ACPI table header */
474 u8 type; /* 0=full 16550, 1=subset of 16550 */
476 struct acpi_generic_address debug_port;
479 /*******************************************************************************
481 * DMAR - DMA Remapping table
484 * Conforms to "Intel Virtualization Technology for Directed I/O",
485 * Version 2.3, October 2014
487 ******************************************************************************/
489 struct acpi_table_dmar {
490 struct acpi_table_header header; /* Common ACPI table header */
491 u8 width; /* Host Address Width */
496 /* Masks for Flags field above */
498 #define ACPI_DMAR_INTR_REMAP (1)
499 #define ACPI_DMAR_X2APIC_OPT_OUT (1<<1)
500 #define ACPI_DMAR_X2APIC_MODE (1<<2)
502 /* DMAR subtable header */
504 struct acpi_dmar_header {
509 /* Values for subtable type in struct acpi_dmar_header */
511 enum acpi_dmar_type {
512 ACPI_DMAR_TYPE_HARDWARE_UNIT = 0,
513 ACPI_DMAR_TYPE_RESERVED_MEMORY = 1,
514 ACPI_DMAR_TYPE_ROOT_ATS = 2,
515 ACPI_DMAR_TYPE_HARDWARE_AFFINITY = 3,
516 ACPI_DMAR_TYPE_NAMESPACE = 4,
517 ACPI_DMAR_TYPE_SATC = 5,
518 ACPI_DMAR_TYPE_RESERVED = 6 /* 6 and greater are reserved */
521 /* DMAR Device Scope structure */
523 struct acpi_dmar_device_scope {
531 /* Values for entry_type in struct acpi_dmar_device_scope - device types */
533 enum acpi_dmar_scope_type {
534 ACPI_DMAR_SCOPE_TYPE_NOT_USED = 0,
535 ACPI_DMAR_SCOPE_TYPE_ENDPOINT = 1,
536 ACPI_DMAR_SCOPE_TYPE_BRIDGE = 2,
537 ACPI_DMAR_SCOPE_TYPE_IOAPIC = 3,
538 ACPI_DMAR_SCOPE_TYPE_HPET = 4,
539 ACPI_DMAR_SCOPE_TYPE_NAMESPACE = 5,
540 ACPI_DMAR_SCOPE_TYPE_RESERVED = 6 /* 6 and greater are reserved */
543 struct acpi_dmar_pci_path {
549 * DMAR Subtables, correspond to Type in struct acpi_dmar_header
552 /* 0: Hardware Unit Definition */
554 struct acpi_dmar_hardware_unit {
555 struct acpi_dmar_header header;
559 u64 address; /* Register Base Address */
562 /* Masks for Flags field above */
564 #define ACPI_DMAR_INCLUDE_ALL (1)
566 /* 1: Reserved Memory Definition */
568 struct acpi_dmar_reserved_memory {
569 struct acpi_dmar_header header;
572 u64 base_address; /* 4K aligned base address */
573 u64 end_address; /* 4K aligned limit address */
576 /* Masks for Flags field above */
578 #define ACPI_DMAR_ALLOW_ALL (1)
580 /* 2: Root Port ATS Capability Reporting Structure */
582 struct acpi_dmar_atsr {
583 struct acpi_dmar_header header;
589 /* Masks for Flags field above */
591 #define ACPI_DMAR_ALL_PORTS (1)
593 /* 3: Remapping Hardware Static Affinity Structure */
595 struct acpi_dmar_rhsa {
596 struct acpi_dmar_header header;
599 u32 proximity_domain;
602 /* 4: ACPI Namespace Device Declaration Structure */
604 struct acpi_dmar_andd {
605 struct acpi_dmar_header header;
611 /* 5: SOC Integrated Address Translation Cache Reporting Structure */
613 struct acpi_dmar_satc {
614 struct acpi_dmar_header header;
619 /*******************************************************************************
621 * DRTM - Dynamic Root of Trust for Measurement table
622 * Conforms to "TCG D-RTM Architecture" June 17 2013, Version 1.0.0
625 ******************************************************************************/
627 struct acpi_table_drtm {
628 struct acpi_table_header header; /* Common ACPI table header */
629 u64 entry_base_address;
634 u64 log_area_address;
636 u64 arch_dependent_address;
640 /* Flag Definitions for above */
642 #define ACPI_DRTM_ACCESS_ALLOWED (1)
643 #define ACPI_DRTM_ENABLE_GAP_CODE (1<<1)
644 #define ACPI_DRTM_INCOMPLETE_MEASUREMENTS (1<<2)
645 #define ACPI_DRTM_AUTHORITY_ORDER (1<<3)
647 /* 1) Validated Tables List (64-bit addresses) */
649 struct acpi_drtm_vtable_list {
650 u32 validated_table_count;
651 u64 validated_tables[1];
654 /* 2) Resources List (of Resource Descriptors) */
656 /* Resource Descriptor */
658 struct acpi_drtm_resource {
664 struct acpi_drtm_resource_list {
666 struct acpi_drtm_resource resources[1];
669 /* 3) Platform-specific Identifiers List */
671 struct acpi_drtm_dps_id {
676 /*******************************************************************************
678 * ECDT - Embedded Controller Boot Resources Table
681 ******************************************************************************/
683 struct acpi_table_ecdt {
684 struct acpi_table_header header; /* Common ACPI table header */
685 struct acpi_generic_address control; /* Address of EC command/status register */
686 struct acpi_generic_address data; /* Address of EC data register */
687 u32 uid; /* Unique ID - must be same as the EC _UID method */
688 u8 gpe; /* The GPE for the EC */
689 u8 id[1]; /* Full namepath of the EC in the ACPI namespace */
692 /*******************************************************************************
694 * EINJ - Error Injection Table (ACPI 4.0)
697 ******************************************************************************/
699 struct acpi_table_einj {
700 struct acpi_table_header header; /* Common ACPI table header */
707 /* EINJ Injection Instruction Entries (actions) */
709 struct acpi_einj_entry {
710 struct acpi_whea_header whea_header; /* Common header for WHEA tables */
713 /* Masks for Flags field above */
715 #define ACPI_EINJ_PRESERVE (1)
717 /* Values for Action field above */
719 enum acpi_einj_actions {
720 ACPI_EINJ_BEGIN_OPERATION = 0,
721 ACPI_EINJ_GET_TRIGGER_TABLE = 1,
722 ACPI_EINJ_SET_ERROR_TYPE = 2,
723 ACPI_EINJ_GET_ERROR_TYPE = 3,
724 ACPI_EINJ_END_OPERATION = 4,
725 ACPI_EINJ_EXECUTE_OPERATION = 5,
726 ACPI_EINJ_CHECK_BUSY_STATUS = 6,
727 ACPI_EINJ_GET_COMMAND_STATUS = 7,
728 ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS = 8,
729 ACPI_EINJ_GET_EXECUTE_TIMINGS = 9,
730 ACPI_EINJ_ACTION_RESERVED = 10, /* 10 and greater are reserved */
731 ACPI_EINJ_TRIGGER_ERROR = 0xFF /* Except for this value */
734 /* Values for Instruction field above */
736 enum acpi_einj_instructions {
737 ACPI_EINJ_READ_REGISTER = 0,
738 ACPI_EINJ_READ_REGISTER_VALUE = 1,
739 ACPI_EINJ_WRITE_REGISTER = 2,
740 ACPI_EINJ_WRITE_REGISTER_VALUE = 3,
742 ACPI_EINJ_FLUSH_CACHELINE = 5,
743 ACPI_EINJ_INSTRUCTION_RESERVED = 6 /* 6 and greater are reserved */
746 struct acpi_einj_error_type_with_addr {
748 u32 vendor_struct_offset;
756 struct acpi_einj_vendor {
765 /* EINJ Trigger Error Action Table */
767 struct acpi_einj_trigger {
774 /* Command status return values */
776 enum acpi_einj_command_status {
777 ACPI_EINJ_SUCCESS = 0,
778 ACPI_EINJ_FAILURE = 1,
779 ACPI_EINJ_INVALID_ACCESS = 2,
780 ACPI_EINJ_STATUS_RESERVED = 3 /* 3 and greater are reserved */
783 /* Error types returned from ACPI_EINJ_GET_ERROR_TYPE (bitfield) */
785 #define ACPI_EINJ_PROCESSOR_CORRECTABLE (1)
786 #define ACPI_EINJ_PROCESSOR_UNCORRECTABLE (1<<1)
787 #define ACPI_EINJ_PROCESSOR_FATAL (1<<2)
788 #define ACPI_EINJ_MEMORY_CORRECTABLE (1<<3)
789 #define ACPI_EINJ_MEMORY_UNCORRECTABLE (1<<4)
790 #define ACPI_EINJ_MEMORY_FATAL (1<<5)
791 #define ACPI_EINJ_PCIX_CORRECTABLE (1<<6)
792 #define ACPI_EINJ_PCIX_UNCORRECTABLE (1<<7)
793 #define ACPI_EINJ_PCIX_FATAL (1<<8)
794 #define ACPI_EINJ_PLATFORM_CORRECTABLE (1<<9)
795 #define ACPI_EINJ_PLATFORM_UNCORRECTABLE (1<<10)
796 #define ACPI_EINJ_PLATFORM_FATAL (1<<11)
797 #define ACPI_EINJ_VENDOR_DEFINED (1<<31)
799 /*******************************************************************************
801 * ERST - Error Record Serialization Table (ACPI 4.0)
804 ******************************************************************************/
806 struct acpi_table_erst {
807 struct acpi_table_header header; /* Common ACPI table header */
813 /* ERST Serialization Entries (actions) */
815 struct acpi_erst_entry {
816 struct acpi_whea_header whea_header; /* Common header for WHEA tables */
819 /* Masks for Flags field above */
821 #define ACPI_ERST_PRESERVE (1)
823 /* Values for Action field above */
825 enum acpi_erst_actions {
826 ACPI_ERST_BEGIN_WRITE = 0,
827 ACPI_ERST_BEGIN_READ = 1,
828 ACPI_ERST_BEGIN_CLEAR = 2,
830 ACPI_ERST_SET_RECORD_OFFSET = 4,
831 ACPI_ERST_EXECUTE_OPERATION = 5,
832 ACPI_ERST_CHECK_BUSY_STATUS = 6,
833 ACPI_ERST_GET_COMMAND_STATUS = 7,
834 ACPI_ERST_GET_RECORD_ID = 8,
835 ACPI_ERST_SET_RECORD_ID = 9,
836 ACPI_ERST_GET_RECORD_COUNT = 10,
837 ACPI_ERST_BEGIN_DUMMY_WRIITE = 11,
838 ACPI_ERST_NOT_USED = 12,
839 ACPI_ERST_GET_ERROR_RANGE = 13,
840 ACPI_ERST_GET_ERROR_LENGTH = 14,
841 ACPI_ERST_GET_ERROR_ATTRIBUTES = 15,
842 ACPI_ERST_EXECUTE_TIMINGS = 16,
843 ACPI_ERST_ACTION_RESERVED = 17 /* 17 and greater are reserved */
846 /* Values for Instruction field above */
848 enum acpi_erst_instructions {
849 ACPI_ERST_READ_REGISTER = 0,
850 ACPI_ERST_READ_REGISTER_VALUE = 1,
851 ACPI_ERST_WRITE_REGISTER = 2,
852 ACPI_ERST_WRITE_REGISTER_VALUE = 3,
854 ACPI_ERST_LOAD_VAR1 = 5,
855 ACPI_ERST_LOAD_VAR2 = 6,
856 ACPI_ERST_STORE_VAR1 = 7,
858 ACPI_ERST_SUBTRACT = 9,
859 ACPI_ERST_ADD_VALUE = 10,
860 ACPI_ERST_SUBTRACT_VALUE = 11,
861 ACPI_ERST_STALL = 12,
862 ACPI_ERST_STALL_WHILE_TRUE = 13,
863 ACPI_ERST_SKIP_NEXT_IF_TRUE = 14,
865 ACPI_ERST_SET_SRC_ADDRESS_BASE = 16,
866 ACPI_ERST_SET_DST_ADDRESS_BASE = 17,
867 ACPI_ERST_MOVE_DATA = 18,
868 ACPI_ERST_INSTRUCTION_RESERVED = 19 /* 19 and greater are reserved */
871 /* Command status return values */
873 enum acpi_erst_command_status {
874 ACPI_ERST_SUCCESS = 0,
875 ACPI_ERST_NO_SPACE = 1,
876 ACPI_ERST_NOT_AVAILABLE = 2,
877 ACPI_ERST_FAILURE = 3,
878 ACPI_ERST_RECORD_EMPTY = 4,
879 ACPI_ERST_NOT_FOUND = 5,
880 ACPI_ERST_STATUS_RESERVED = 6 /* 6 and greater are reserved */
883 /* Error Record Serialization Information */
885 struct acpi_erst_info {
886 u16 signature; /* Should be "ER" */
890 /*******************************************************************************
892 * FPDT - Firmware Performance Data Table (ACPI 5.0)
895 ******************************************************************************/
897 struct acpi_table_fpdt {
898 struct acpi_table_header header; /* Common ACPI table header */
901 /* FPDT subtable header (Performance Record Structure) */
903 struct acpi_fpdt_header {
909 /* Values for Type field above */
911 enum acpi_fpdt_type {
912 ACPI_FPDT_TYPE_BOOT = 0,
913 ACPI_FPDT_TYPE_S3PERF = 1
920 /* 0: Firmware Basic Boot Performance Record */
922 struct acpi_fpdt_boot_pointer {
923 struct acpi_fpdt_header header;
928 /* 1: S3 Performance Table Pointer Record */
930 struct acpi_fpdt_s3pt_pointer {
931 struct acpi_fpdt_header header;
937 * S3PT - S3 Performance Table. This table is pointed to by the
938 * S3 Pointer Record above.
940 struct acpi_table_s3pt {
941 u8 signature[4]; /* "S3PT" */
946 * S3PT Subtables (Not part of the actual FPDT)
949 /* Values for Type field in S3PT header */
951 enum acpi_s3pt_type {
952 ACPI_S3PT_TYPE_RESUME = 0,
953 ACPI_S3PT_TYPE_SUSPEND = 1,
954 ACPI_FPDT_BOOT_PERFORMANCE = 2
957 struct acpi_s3pt_resume {
958 struct acpi_fpdt_header header;
964 struct acpi_s3pt_suspend {
965 struct acpi_fpdt_header header;
971 * FPDT Boot Performance Record (Not part of the actual FPDT)
973 struct acpi_fpdt_boot {
974 struct acpi_fpdt_header header;
979 u64 exit_services_entry;
980 u64 exit_services_exit;
983 /*******************************************************************************
985 * GTDT - Generic Timer Description Table (ACPI 5.1)
988 ******************************************************************************/
990 struct acpi_table_gtdt {
991 struct acpi_table_header header; /* Common ACPI table header */
992 u64 counter_block_addresss;
994 u32 secure_el1_interrupt;
995 u32 secure_el1_flags;
996 u32 non_secure_el1_interrupt;
997 u32 non_secure_el1_flags;
998 u32 virtual_timer_interrupt;
999 u32 virtual_timer_flags;
1000 u32 non_secure_el2_interrupt;
1001 u32 non_secure_el2_flags;
1002 u64 counter_read_block_address;
1003 u32 platform_timer_count;
1004 u32 platform_timer_offset;
1007 /* Flag Definitions: Timer Block Physical Timers and Virtual timers */
1009 #define ACPI_GTDT_INTERRUPT_MODE (1)
1010 #define ACPI_GTDT_INTERRUPT_POLARITY (1<<1)
1011 #define ACPI_GTDT_ALWAYS_ON (1<<2)
1013 struct acpi_gtdt_el2 {
1014 u32 virtual_el2_timer_gsiv;
1015 u32 virtual_el2_timer_flags;
1018 /* Common GTDT subtable header */
1020 struct acpi_gtdt_header {
1025 /* Values for GTDT subtable type above */
1027 enum acpi_gtdt_type {
1028 ACPI_GTDT_TYPE_TIMER_BLOCK = 0,
1029 ACPI_GTDT_TYPE_WATCHDOG = 1,
1030 ACPI_GTDT_TYPE_RESERVED = 2 /* 2 and greater are reserved */
1033 /* GTDT Subtables, correspond to Type in struct acpi_gtdt_header */
1035 /* 0: Generic Timer Block */
1037 struct acpi_gtdt_timer_block {
1038 struct acpi_gtdt_header header;
1045 /* Timer Sub-Structure, one per timer */
1047 struct acpi_gtdt_timer_entry {
1051 u64 el0_base_address;
1052 u32 timer_interrupt;
1054 u32 virtual_timer_interrupt;
1055 u32 virtual_timer_flags;
1059 /* Flag Definitions: timer_flags and virtual_timer_flags above */
1061 #define ACPI_GTDT_GT_IRQ_MODE (1)
1062 #define ACPI_GTDT_GT_IRQ_POLARITY (1<<1)
1064 /* Flag Definitions: common_flags above */
1066 #define ACPI_GTDT_GT_IS_SECURE_TIMER (1)
1067 #define ACPI_GTDT_GT_ALWAYS_ON (1<<1)
1069 /* 1: SBSA Generic Watchdog Structure */
1071 struct acpi_gtdt_watchdog {
1072 struct acpi_gtdt_header header;
1074 u64 refresh_frame_address;
1075 u64 control_frame_address;
1076 u32 timer_interrupt;
1080 /* Flag Definitions: timer_flags above */
1082 #define ACPI_GTDT_WATCHDOG_IRQ_MODE (1)
1083 #define ACPI_GTDT_WATCHDOG_IRQ_POLARITY (1<<1)
1084 #define ACPI_GTDT_WATCHDOG_SECURE (1<<2)
1086 /*******************************************************************************
1088 * HEST - Hardware Error Source Table (ACPI 4.0)
1091 ******************************************************************************/
1093 struct acpi_table_hest {
1094 struct acpi_table_header header; /* Common ACPI table header */
1095 u32 error_source_count;
1098 /* HEST subtable header */
1100 struct acpi_hest_header {
1105 /* Values for Type field above for subtables */
1107 enum acpi_hest_types {
1108 ACPI_HEST_TYPE_IA32_CHECK = 0,
1109 ACPI_HEST_TYPE_IA32_CORRECTED_CHECK = 1,
1110 ACPI_HEST_TYPE_IA32_NMI = 2,
1111 ACPI_HEST_TYPE_NOT_USED3 = 3,
1112 ACPI_HEST_TYPE_NOT_USED4 = 4,
1113 ACPI_HEST_TYPE_NOT_USED5 = 5,
1114 ACPI_HEST_TYPE_AER_ROOT_PORT = 6,
1115 ACPI_HEST_TYPE_AER_ENDPOINT = 7,
1116 ACPI_HEST_TYPE_AER_BRIDGE = 8,
1117 ACPI_HEST_TYPE_GENERIC_ERROR = 9,
1118 ACPI_HEST_TYPE_GENERIC_ERROR_V2 = 10,
1119 ACPI_HEST_TYPE_IA32_DEFERRED_CHECK = 11,
1120 ACPI_HEST_TYPE_RESERVED = 12 /* 12 and greater are reserved */
1124 * HEST substructures contained in subtables
1128 * IA32 Error Bank(s) - Follows the struct acpi_hest_ia_machine_check and
1129 * struct acpi_hest_ia_corrected structures.
1131 struct acpi_hest_ia_error_bank {
1133 u8 clear_status_on_init;
1136 u32 control_register;
1138 u32 status_register;
1139 u32 address_register;
1143 /* Common HEST sub-structure for PCI/AER structures below (6,7,8) */
1145 struct acpi_hest_aer_common {
1149 u32 records_to_preallocate;
1150 u32 max_sections_per_record;
1151 u32 bus; /* Bus and Segment numbers */
1156 u32 uncorrectable_mask;
1157 u32 uncorrectable_severity;
1158 u32 correctable_mask;
1159 u32 advanced_capabilities;
1162 /* Masks for HEST Flags fields */
1164 #define ACPI_HEST_FIRMWARE_FIRST (1)
1165 #define ACPI_HEST_GLOBAL (1<<1)
1166 #define ACPI_HEST_GHES_ASSIST (1<<2)
1169 * Macros to access the bus/segment numbers in Bus field above:
1170 * Bus number is encoded in bits 7:0
1171 * Segment number is encoded in bits 23:8
1173 #define ACPI_HEST_BUS(bus) ((bus) & 0xFF)
1174 #define ACPI_HEST_SEGMENT(bus) (((bus) >> 8) & 0xFFFF)
1176 /* Hardware Error Notification */
1178 struct acpi_hest_notify {
1181 u16 config_write_enable;
1184 u32 polling_threshold_value;
1185 u32 polling_threshold_window;
1186 u32 error_threshold_value;
1187 u32 error_threshold_window;
1190 /* Values for Notify Type field above */
1192 enum acpi_hest_notify_types {
1193 ACPI_HEST_NOTIFY_POLLED = 0,
1194 ACPI_HEST_NOTIFY_EXTERNAL = 1,
1195 ACPI_HEST_NOTIFY_LOCAL = 2,
1196 ACPI_HEST_NOTIFY_SCI = 3,
1197 ACPI_HEST_NOTIFY_NMI = 4,
1198 ACPI_HEST_NOTIFY_CMCI = 5, /* ACPI 5.0 */
1199 ACPI_HEST_NOTIFY_MCE = 6, /* ACPI 5.0 */
1200 ACPI_HEST_NOTIFY_GPIO = 7, /* ACPI 6.0 */
1201 ACPI_HEST_NOTIFY_SEA = 8, /* ACPI 6.1 */
1202 ACPI_HEST_NOTIFY_SEI = 9, /* ACPI 6.1 */
1203 ACPI_HEST_NOTIFY_GSIV = 10, /* ACPI 6.1 */
1204 ACPI_HEST_NOTIFY_SOFTWARE_DELEGATED = 11, /* ACPI 6.2 */
1205 ACPI_HEST_NOTIFY_RESERVED = 12 /* 12 and greater are reserved */
1208 /* Values for config_write_enable bitfield above */
1210 #define ACPI_HEST_TYPE (1)
1211 #define ACPI_HEST_POLL_INTERVAL (1<<1)
1212 #define ACPI_HEST_POLL_THRESHOLD_VALUE (1<<2)
1213 #define ACPI_HEST_POLL_THRESHOLD_WINDOW (1<<3)
1214 #define ACPI_HEST_ERR_THRESHOLD_VALUE (1<<4)
1215 #define ACPI_HEST_ERR_THRESHOLD_WINDOW (1<<5)
1221 /* 0: IA32 Machine Check Exception */
1223 struct acpi_hest_ia_machine_check {
1224 struct acpi_hest_header header;
1226 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1228 u32 records_to_preallocate;
1229 u32 max_sections_per_record;
1230 u64 global_capability_data;
1231 u64 global_control_data;
1232 u8 num_hardware_banks;
1236 /* 1: IA32 Corrected Machine Check */
1238 struct acpi_hest_ia_corrected {
1239 struct acpi_hest_header header;
1241 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1243 u32 records_to_preallocate;
1244 u32 max_sections_per_record;
1245 struct acpi_hest_notify notify;
1246 u8 num_hardware_banks;
1250 /* 2: IA32 Non-Maskable Interrupt */
1252 struct acpi_hest_ia_nmi {
1253 struct acpi_hest_header header;
1255 u32 records_to_preallocate;
1256 u32 max_sections_per_record;
1257 u32 max_raw_data_length;
1260 /* 3,4,5: Not used */
1262 /* 6: PCI Express Root Port AER */
1264 struct acpi_hest_aer_root {
1265 struct acpi_hest_header header;
1266 struct acpi_hest_aer_common aer;
1267 u32 root_error_command;
1270 /* 7: PCI Express AER (AER Endpoint) */
1272 struct acpi_hest_aer {
1273 struct acpi_hest_header header;
1274 struct acpi_hest_aer_common aer;
1277 /* 8: PCI Express/PCI-X Bridge AER */
1279 struct acpi_hest_aer_bridge {
1280 struct acpi_hest_header header;
1281 struct acpi_hest_aer_common aer;
1282 u32 uncorrectable_mask2;
1283 u32 uncorrectable_severity2;
1284 u32 advanced_capabilities2;
1287 /* 9: Generic Hardware Error Source */
1289 struct acpi_hest_generic {
1290 struct acpi_hest_header header;
1291 u16 related_source_id;
1294 u32 records_to_preallocate;
1295 u32 max_sections_per_record;
1296 u32 max_raw_data_length;
1297 struct acpi_generic_address error_status_address;
1298 struct acpi_hest_notify notify;
1299 u32 error_block_length;
1302 /* 10: Generic Hardware Error Source, version 2 */
1304 struct acpi_hest_generic_v2 {
1305 struct acpi_hest_header header;
1306 u16 related_source_id;
1309 u32 records_to_preallocate;
1310 u32 max_sections_per_record;
1311 u32 max_raw_data_length;
1312 struct acpi_generic_address error_status_address;
1313 struct acpi_hest_notify notify;
1314 u32 error_block_length;
1315 struct acpi_generic_address read_ack_register;
1316 u64 read_ack_preserve;
1320 /* Generic Error Status block */
1322 struct acpi_hest_generic_status {
1324 u32 raw_data_offset;
1325 u32 raw_data_length;
1330 /* Values for block_status flags above */
1332 #define ACPI_HEST_UNCORRECTABLE (1)
1333 #define ACPI_HEST_CORRECTABLE (1<<1)
1334 #define ACPI_HEST_MULTIPLE_UNCORRECTABLE (1<<2)
1335 #define ACPI_HEST_MULTIPLE_CORRECTABLE (1<<3)
1336 #define ACPI_HEST_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
1338 /* Generic Error Data entry */
1340 struct acpi_hest_generic_data {
1341 u8 section_type[16];
1346 u32 error_data_length;
1351 /* Extension for revision 0x0300 */
1353 struct acpi_hest_generic_data_v300 {
1354 u8 section_type[16];
1359 u32 error_data_length;
1365 /* Values for error_severity above */
1367 #define ACPI_HEST_GEN_ERROR_RECOVERABLE 0
1368 #define ACPI_HEST_GEN_ERROR_FATAL 1
1369 #define ACPI_HEST_GEN_ERROR_CORRECTED 2
1370 #define ACPI_HEST_GEN_ERROR_NONE 3
1372 /* Flags for validation_bits above */
1374 #define ACPI_HEST_GEN_VALID_FRU_ID (1)
1375 #define ACPI_HEST_GEN_VALID_FRU_STRING (1<<1)
1376 #define ACPI_HEST_GEN_VALID_TIMESTAMP (1<<2)
1378 /* 11: IA32 Deferred Machine Check Exception (ACPI 6.2) */
1380 struct acpi_hest_ia_deferred_check {
1381 struct acpi_hest_header header;
1383 u8 flags; /* See flags ACPI_HEST_GLOBAL, etc. above */
1385 u32 records_to_preallocate;
1386 u32 max_sections_per_record;
1387 struct acpi_hest_notify notify;
1388 u8 num_hardware_banks;
1392 /*******************************************************************************
1394 * HMAT - Heterogeneous Memory Attributes Table (ACPI 6.2)
1397 ******************************************************************************/
1399 struct acpi_table_hmat {
1400 struct acpi_table_header header; /* Common ACPI table header */
1404 /* Values for HMAT structure types */
1406 enum acpi_hmat_type {
1407 ACPI_HMAT_TYPE_PROXIMITY = 0, /* Memory proximity domain attributes */
1408 ACPI_HMAT_TYPE_LOCALITY = 1, /* System locality latency and bandwidth information */
1409 ACPI_HMAT_TYPE_CACHE = 2, /* Memory side cache information */
1410 ACPI_HMAT_TYPE_RESERVED = 3 /* 3 and greater are reserved */
1413 struct acpi_hmat_structure {
1420 * HMAT Structures, correspond to Type in struct acpi_hmat_structure
1423 /* 0: Memory proximity domain attributes */
1425 struct acpi_hmat_proximity_domain {
1426 struct acpi_hmat_structure header;
1429 u32 processor_PD; /* Processor proximity domain */
1430 u32 memory_PD; /* Memory proximity domain */
1436 /* Masks for Flags field above */
1438 #define ACPI_HMAT_PROCESSOR_PD_VALID (1) /* 1: processor_PD field is valid */
1439 #define ACPI_HMAT_MEMORY_PD_VALID (1<<1) /* 1: memory_PD field is valid */
1440 #define ACPI_HMAT_RESERVATION_HINT (1<<2) /* 1: Reservation hint */
1442 /* 1: System locality latency and bandwidth information */
1444 struct acpi_hmat_locality {
1445 struct acpi_hmat_structure header;
1449 u32 number_of_initiator_Pds;
1450 u32 number_of_target_Pds;
1452 u64 entry_base_unit;
1455 /* Masks for Flags field above */
1457 #define ACPI_HMAT_MEMORY_HIERARCHY (0x0F)
1459 /* Values for Memory Hierarchy flag */
1461 #define ACPI_HMAT_MEMORY 0
1462 #define ACPI_HMAT_LAST_LEVEL_CACHE 1
1463 #define ACPI_HMAT_1ST_LEVEL_CACHE 2
1464 #define ACPI_HMAT_2ND_LEVEL_CACHE 3
1465 #define ACPI_HMAT_3RD_LEVEL_CACHE 4
1467 /* Values for data_type field above */
1469 #define ACPI_HMAT_ACCESS_LATENCY 0
1470 #define ACPI_HMAT_READ_LATENCY 1
1471 #define ACPI_HMAT_WRITE_LATENCY 2
1472 #define ACPI_HMAT_ACCESS_BANDWIDTH 3
1473 #define ACPI_HMAT_READ_BANDWIDTH 4
1474 #define ACPI_HMAT_WRITE_BANDWIDTH 5
1476 /* 2: Memory side cache information */
1478 struct acpi_hmat_cache {
1479 struct acpi_hmat_structure header;
1483 u32 cache_attributes;
1485 u16 number_of_SMBIOShandles;
1488 /* Masks for cache_attributes field above */
1490 #define ACPI_HMAT_TOTAL_CACHE_LEVEL (0x0000000F)
1491 #define ACPI_HMAT_CACHE_LEVEL (0x000000F0)
1492 #define ACPI_HMAT_CACHE_ASSOCIATIVITY (0x00000F00)
1493 #define ACPI_HMAT_WRITE_POLICY (0x0000F000)
1494 #define ACPI_HMAT_CACHE_LINE_SIZE (0xFFFF0000)
1496 /* Values for cache associativity flag */
1498 #define ACPI_HMAT_CA_NONE (0)
1499 #define ACPI_HMAT_CA_DIRECT_MAPPED (1)
1500 #define ACPI_HMAT_CA_COMPLEX_CACHE_INDEXING (2)
1502 /* Values for write policy flag */
1504 #define ACPI_HMAT_CP_NONE (0)
1505 #define ACPI_HMAT_CP_WB (1)
1506 #define ACPI_HMAT_CP_WT (2)
1508 /*******************************************************************************
1510 * HPET - High Precision Event Timer table
1513 * Conforms to "IA-PC HPET (High Precision Event Timers) Specification",
1514 * Version 1.0a, October 2004
1516 ******************************************************************************/
1518 struct acpi_table_hpet {
1519 struct acpi_table_header header; /* Common ACPI table header */
1520 u32 id; /* Hardware ID of event timer block */
1521 struct acpi_generic_address address; /* Address of event timer block */
1522 u8 sequence; /* HPET sequence number */
1523 u16 minimum_tick; /* Main counter min tick, periodic mode */
1527 /* Masks for Flags field above */
1529 #define ACPI_HPET_PAGE_PROTECT_MASK (3)
1531 /* Values for Page Protect flags */
1533 enum acpi_hpet_page_protect {
1534 ACPI_HPET_NO_PAGE_PROTECT = 0,
1535 ACPI_HPET_PAGE_PROTECT4 = 1,
1536 ACPI_HPET_PAGE_PROTECT64 = 2
1539 /*******************************************************************************
1541 * IBFT - Boot Firmware Table
1544 * Conforms to "iSCSI Boot Firmware Table (iBFT) as Defined in ACPI 3.0b
1545 * Specification", Version 1.01, March 1, 2007
1547 * Note: It appears that this table is not intended to appear in the RSDT/XSDT.
1548 * Therefore, it is not currently supported by the disassembler.
1550 ******************************************************************************/
1552 struct acpi_table_ibft {
1553 struct acpi_table_header header; /* Common ACPI table header */
1557 /* IBFT common subtable header */
1559 struct acpi_ibft_header {
1567 /* Values for Type field above */
1569 enum acpi_ibft_type {
1570 ACPI_IBFT_TYPE_NOT_USED = 0,
1571 ACPI_IBFT_TYPE_CONTROL = 1,
1572 ACPI_IBFT_TYPE_INITIATOR = 2,
1573 ACPI_IBFT_TYPE_NIC = 3,
1574 ACPI_IBFT_TYPE_TARGET = 4,
1575 ACPI_IBFT_TYPE_EXTENSIONS = 5,
1576 ACPI_IBFT_TYPE_RESERVED = 6 /* 6 and greater are reserved */
1579 /* IBFT subtables */
1581 struct acpi_ibft_control {
1582 struct acpi_ibft_header header;
1584 u16 initiator_offset;
1591 struct acpi_ibft_initiator {
1592 struct acpi_ibft_header header;
1595 u8 primary_server[16];
1596 u8 secondary_server[16];
1601 struct acpi_ibft_nic {
1602 struct acpi_ibft_header header;
1604 u8 subnet_mask_prefix;
1608 u8 secondary_dns[16];
1617 struct acpi_ibft_target {
1618 struct acpi_ibft_header header;
1619 u8 target_ip_address[16];
1620 u16 target_ip_socket;
1621 u8 target_boot_lun[8];
1624 u16 target_name_length;
1625 u16 target_name_offset;
1626 u16 chap_name_length;
1627 u16 chap_name_offset;
1628 u16 chap_secret_length;
1629 u16 chap_secret_offset;
1630 u16 reverse_chap_name_length;
1631 u16 reverse_chap_name_offset;
1632 u16 reverse_chap_secret_length;
1633 u16 reverse_chap_secret_offset;
1636 /* Reset to default packing */
1640 #endif /* __ACTBL1_H__ */