1 /******************************************************************************
3 * Name: actbl1.h - Additional ACPI table definitions
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2014, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
48 /*******************************************************************************
50 * Additional ACPI Tables (1)
52 * These tables are not consumed directly by the ACPICA subsystem, but are
53 * included here to support device drivers and the AML disassembler.
55 * The tables in this file are fully defined within the ACPI specification.
57 ******************************************************************************/
61 * Values for description table header signatures for tables defined in this
62 * file. Useful because they make it more difficult to inadvertently type in
63 * the wrong signature.
65 #define ACPI_SIG_BERT "BERT" /* Boot Error Record Table */
66 #define ACPI_SIG_CPEP "CPEP" /* Corrected Platform Error Polling table */
67 #define ACPI_SIG_ECDT "ECDT" /* Embedded Controller Boot Resources Table */
68 #define ACPI_SIG_EINJ "EINJ" /* Error Injection table */
69 #define ACPI_SIG_ERST "ERST" /* Error Record Serialization Table */
70 #define ACPI_SIG_HEST "HEST" /* Hardware Error Source Table */
71 #define ACPI_SIG_MADT "APIC" /* Multiple APIC Description Table */
72 #define ACPI_SIG_MSCT "MSCT" /* Maximum System Characteristics Table */
73 #define ACPI_SIG_SBST "SBST" /* Smart Battery Specification Table */
74 #define ACPI_SIG_SLIT "SLIT" /* System Locality Distance Information Table */
75 #define ACPI_SIG_SRAT "SRAT" /* System Resource Affinity Table */
79 * All tables must be byte-packed to match the ACPI specification, since
80 * the tables are provided by the system BIOS.
85 * Note: C bitfields are not used for this reason:
87 * "Bitfields are great and easy to read, but unfortunately the C language
88 * does not specify the layout of bitfields in memory, which means they are
89 * essentially useless for dealing with packed data in on-disk formats or
90 * binary wire protocols." (Or ACPI tables and buffers.) "If you ask me,
91 * this decision was a design error in C. Ritchie could have picked an order
92 * and stuck with it." Norman Ramsey.
93 * See http://stackoverflow.com/a/1053662/41661
97 /*******************************************************************************
99 * Common subtable headers
101 ******************************************************************************/
103 /* Generic subtable header (used in MADT, SRAT, etc.) */
105 typedef struct acpi_subtable_header
110 } ACPI_SUBTABLE_HEADER;
113 /* Subtable header for WHEA tables (EINJ, ERST, WDAT) */
115 typedef struct acpi_whea_header
121 ACPI_GENERIC_ADDRESS RegisterRegion;
122 UINT64 Value; /* Value used with Read/Write register */
123 UINT64 Mask; /* Bitmask required for this register instruction */
128 /*******************************************************************************
130 * BERT - Boot Error Record Table (ACPI 4.0)
133 ******************************************************************************/
135 typedef struct acpi_table_bert
137 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
138 UINT32 RegionLength; /* Length of the boot error region */
139 UINT64 Address; /* Physical address of the error region */
144 /* Boot Error Region (not a subtable, pointed to by Address field above) */
146 typedef struct acpi_bert_region
148 UINT32 BlockStatus; /* Type of error information */
149 UINT32 RawDataOffset; /* Offset to raw error data */
150 UINT32 RawDataLength; /* Length of raw error data */
151 UINT32 DataLength; /* Length of generic error data */
152 UINT32 ErrorSeverity; /* Severity code */
156 /* Values for BlockStatus flags above */
158 #define ACPI_BERT_UNCORRECTABLE (1)
159 #define ACPI_BERT_CORRECTABLE (1<<1)
160 #define ACPI_BERT_MULTIPLE_UNCORRECTABLE (1<<2)
161 #define ACPI_BERT_MULTIPLE_CORRECTABLE (1<<3)
162 #define ACPI_BERT_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
164 /* Values for ErrorSeverity above */
166 enum AcpiBertErrorSeverity
168 ACPI_BERT_ERROR_CORRECTABLE = 0,
169 ACPI_BERT_ERROR_FATAL = 1,
170 ACPI_BERT_ERROR_CORRECTED = 2,
171 ACPI_BERT_ERROR_NONE = 3,
172 ACPI_BERT_ERROR_RESERVED = 4 /* 4 and greater are reserved */
176 * Note: The generic error data that follows the ErrorSeverity field above
177 * uses the ACPI_HEST_GENERIC_DATA defined under the HEST table below
181 /*******************************************************************************
183 * CPEP - Corrected Platform Error Polling table (ACPI 4.0)
186 ******************************************************************************/
188 typedef struct acpi_table_cpep
190 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
198 typedef struct acpi_cpep_polling
200 ACPI_SUBTABLE_HEADER Header;
201 UINT8 Id; /* Processor ID */
202 UINT8 Eid; /* Processor EID */
203 UINT32 Interval; /* Polling interval (msec) */
208 /*******************************************************************************
210 * ECDT - Embedded Controller Boot Resources Table
213 ******************************************************************************/
215 typedef struct acpi_table_ecdt
217 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
218 ACPI_GENERIC_ADDRESS Control; /* Address of EC command/status register */
219 ACPI_GENERIC_ADDRESS Data; /* Address of EC data register */
220 UINT32 Uid; /* Unique ID - must be same as the EC _UID method */
221 UINT8 Gpe; /* The GPE for the EC */
222 UINT8 Id[1]; /* Full namepath of the EC in the ACPI namespace */
227 /*******************************************************************************
229 * EINJ - Error Injection Table (ACPI 4.0)
232 ******************************************************************************/
234 typedef struct acpi_table_einj
236 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
245 /* EINJ Injection Instruction Entries (actions) */
247 typedef struct acpi_einj_entry
249 ACPI_WHEA_HEADER WheaHeader; /* Common header for WHEA tables */
253 /* Masks for Flags field above */
255 #define ACPI_EINJ_PRESERVE (1)
257 /* Values for Action field above */
261 ACPI_EINJ_BEGIN_OPERATION = 0,
262 ACPI_EINJ_GET_TRIGGER_TABLE = 1,
263 ACPI_EINJ_SET_ERROR_TYPE = 2,
264 ACPI_EINJ_GET_ERROR_TYPE = 3,
265 ACPI_EINJ_END_OPERATION = 4,
266 ACPI_EINJ_EXECUTE_OPERATION = 5,
267 ACPI_EINJ_CHECK_BUSY_STATUS = 6,
268 ACPI_EINJ_GET_COMMAND_STATUS = 7,
269 ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS = 8,
270 ACPI_EINJ_ACTION_RESERVED = 9, /* 9 and greater are reserved */
271 ACPI_EINJ_TRIGGER_ERROR = 0xFF /* Except for this value */
274 /* Values for Instruction field above */
276 enum AcpiEinjInstructions
278 ACPI_EINJ_READ_REGISTER = 0,
279 ACPI_EINJ_READ_REGISTER_VALUE = 1,
280 ACPI_EINJ_WRITE_REGISTER = 2,
281 ACPI_EINJ_WRITE_REGISTER_VALUE = 3,
283 ACPI_EINJ_FLUSH_CACHELINE = 5,
284 ACPI_EINJ_INSTRUCTION_RESERVED = 6 /* 6 and greater are reserved */
287 typedef struct acpi_einj_error_type_with_addr
290 UINT32 VendorStructOffset;
297 } ACPI_EINJ_ERROR_TYPE_WITH_ADDR;
299 typedef struct acpi_einj_vendor
311 /* EINJ Trigger Error Action Table */
313 typedef struct acpi_einj_trigger
322 /* Command status return values */
324 enum AcpiEinjCommandStatus
326 ACPI_EINJ_SUCCESS = 0,
327 ACPI_EINJ_FAILURE = 1,
328 ACPI_EINJ_INVALID_ACCESS = 2,
329 ACPI_EINJ_STATUS_RESERVED = 3 /* 3 and greater are reserved */
333 /* Error types returned from ACPI_EINJ_GET_ERROR_TYPE (bitfield) */
335 #define ACPI_EINJ_PROCESSOR_CORRECTABLE (1)
336 #define ACPI_EINJ_PROCESSOR_UNCORRECTABLE (1<<1)
337 #define ACPI_EINJ_PROCESSOR_FATAL (1<<2)
338 #define ACPI_EINJ_MEMORY_CORRECTABLE (1<<3)
339 #define ACPI_EINJ_MEMORY_UNCORRECTABLE (1<<4)
340 #define ACPI_EINJ_MEMORY_FATAL (1<<5)
341 #define ACPI_EINJ_PCIX_CORRECTABLE (1<<6)
342 #define ACPI_EINJ_PCIX_UNCORRECTABLE (1<<7)
343 #define ACPI_EINJ_PCIX_FATAL (1<<8)
344 #define ACPI_EINJ_PLATFORM_CORRECTABLE (1<<9)
345 #define ACPI_EINJ_PLATFORM_UNCORRECTABLE (1<<10)
346 #define ACPI_EINJ_PLATFORM_FATAL (1<<11)
347 #define ACPI_EINJ_VENDOR_DEFINED (1<<31)
350 /*******************************************************************************
352 * ERST - Error Record Serialization Table (ACPI 4.0)
355 ******************************************************************************/
357 typedef struct acpi_table_erst
359 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
367 /* ERST Serialization Entries (actions) */
369 typedef struct acpi_erst_entry
371 ACPI_WHEA_HEADER WheaHeader; /* Common header for WHEA tables */
375 /* Masks for Flags field above */
377 #define ACPI_ERST_PRESERVE (1)
379 /* Values for Action field above */
383 ACPI_ERST_BEGIN_WRITE = 0,
384 ACPI_ERST_BEGIN_READ = 1,
385 ACPI_ERST_BEGIN_CLEAR = 2,
387 ACPI_ERST_SET_RECORD_OFFSET = 4,
388 ACPI_ERST_EXECUTE_OPERATION = 5,
389 ACPI_ERST_CHECK_BUSY_STATUS = 6,
390 ACPI_ERST_GET_COMMAND_STATUS = 7,
391 ACPI_ERST_GET_RECORD_ID = 8,
392 ACPI_ERST_SET_RECORD_ID = 9,
393 ACPI_ERST_GET_RECORD_COUNT = 10,
394 ACPI_ERST_BEGIN_DUMMY_WRIITE = 11,
395 ACPI_ERST_NOT_USED = 12,
396 ACPI_ERST_GET_ERROR_RANGE = 13,
397 ACPI_ERST_GET_ERROR_LENGTH = 14,
398 ACPI_ERST_GET_ERROR_ATTRIBUTES = 15,
399 ACPI_ERST_ACTION_RESERVED = 16 /* 16 and greater are reserved */
402 /* Values for Instruction field above */
404 enum AcpiErstInstructions
406 ACPI_ERST_READ_REGISTER = 0,
407 ACPI_ERST_READ_REGISTER_VALUE = 1,
408 ACPI_ERST_WRITE_REGISTER = 2,
409 ACPI_ERST_WRITE_REGISTER_VALUE = 3,
411 ACPI_ERST_LOAD_VAR1 = 5,
412 ACPI_ERST_LOAD_VAR2 = 6,
413 ACPI_ERST_STORE_VAR1 = 7,
415 ACPI_ERST_SUBTRACT = 9,
416 ACPI_ERST_ADD_VALUE = 10,
417 ACPI_ERST_SUBTRACT_VALUE = 11,
418 ACPI_ERST_STALL = 12,
419 ACPI_ERST_STALL_WHILE_TRUE = 13,
420 ACPI_ERST_SKIP_NEXT_IF_TRUE = 14,
422 ACPI_ERST_SET_SRC_ADDRESS_BASE = 16,
423 ACPI_ERST_SET_DST_ADDRESS_BASE = 17,
424 ACPI_ERST_MOVE_DATA = 18,
425 ACPI_ERST_INSTRUCTION_RESERVED = 19 /* 19 and greater are reserved */
428 /* Command status return values */
430 enum AcpiErstCommandStatus
432 ACPI_ERST_SUCESS = 0,
433 ACPI_ERST_NO_SPACE = 1,
434 ACPI_ERST_NOT_AVAILABLE = 2,
435 ACPI_ERST_FAILURE = 3,
436 ACPI_ERST_RECORD_EMPTY = 4,
437 ACPI_ERST_NOT_FOUND = 5,
438 ACPI_ERST_STATUS_RESERVED = 6 /* 6 and greater are reserved */
442 /* Error Record Serialization Information */
444 typedef struct acpi_erst_info
446 UINT16 Signature; /* Should be "ER" */
452 /*******************************************************************************
454 * HEST - Hardware Error Source Table (ACPI 4.0)
457 ******************************************************************************/
459 typedef struct acpi_table_hest
461 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
462 UINT32 ErrorSourceCount;
467 /* HEST subtable header */
469 typedef struct acpi_hest_header
477 /* Values for Type field above for subtables */
481 ACPI_HEST_TYPE_IA32_CHECK = 0,
482 ACPI_HEST_TYPE_IA32_CORRECTED_CHECK = 1,
483 ACPI_HEST_TYPE_IA32_NMI = 2,
484 ACPI_HEST_TYPE_NOT_USED3 = 3,
485 ACPI_HEST_TYPE_NOT_USED4 = 4,
486 ACPI_HEST_TYPE_NOT_USED5 = 5,
487 ACPI_HEST_TYPE_AER_ROOT_PORT = 6,
488 ACPI_HEST_TYPE_AER_ENDPOINT = 7,
489 ACPI_HEST_TYPE_AER_BRIDGE = 8,
490 ACPI_HEST_TYPE_GENERIC_ERROR = 9,
491 ACPI_HEST_TYPE_RESERVED = 10 /* 10 and greater are reserved */
496 * HEST substructures contained in subtables
500 * IA32 Error Bank(s) - Follows the ACPI_HEST_IA_MACHINE_CHECK and
501 * ACPI_HEST_IA_CORRECTED structures.
503 typedef struct acpi_hest_ia_error_bank
506 UINT8 ClearStatusOnInit;
509 UINT32 ControlRegister;
511 UINT32 StatusRegister;
512 UINT32 AddressRegister;
515 } ACPI_HEST_IA_ERROR_BANK;
518 /* Common HEST sub-structure for PCI/AER structures below (6,7,8) */
520 typedef struct acpi_hest_aer_common
525 UINT32 RecordsToPreallocate;
526 UINT32 MaxSectionsPerRecord;
527 UINT32 Bus; /* Bus and Segment numbers */
530 UINT16 DeviceControl;
532 UINT32 UncorrectableMask;
533 UINT32 UncorrectableSeverity;
534 UINT32 CorrectableMask;
535 UINT32 AdvancedCapabilities;
537 } ACPI_HEST_AER_COMMON;
539 /* Masks for HEST Flags fields */
541 #define ACPI_HEST_FIRMWARE_FIRST (1)
542 #define ACPI_HEST_GLOBAL (1<<1)
545 * Macros to access the bus/segment numbers in Bus field above:
546 * Bus number is encoded in bits 7:0
547 * Segment number is encoded in bits 23:8
549 #define ACPI_HEST_BUS(Bus) ((Bus) & 0xFF)
550 #define ACPI_HEST_SEGMENT(Bus) (((Bus) >> 8) & 0xFFFF)
553 /* Hardware Error Notification */
555 typedef struct acpi_hest_notify
559 UINT16 ConfigWriteEnable;
562 UINT32 PollingThresholdValue;
563 UINT32 PollingThresholdWindow;
564 UINT32 ErrorThresholdValue;
565 UINT32 ErrorThresholdWindow;
569 /* Values for Notify Type field above */
571 enum AcpiHestNotifyTypes
573 ACPI_HEST_NOTIFY_POLLED = 0,
574 ACPI_HEST_NOTIFY_EXTERNAL = 1,
575 ACPI_HEST_NOTIFY_LOCAL = 2,
576 ACPI_HEST_NOTIFY_SCI = 3,
577 ACPI_HEST_NOTIFY_NMI = 4,
578 ACPI_HEST_NOTIFY_CMCI = 5, /* ACPI 5.0 */
579 ACPI_HEST_NOTIFY_MCE = 6, /* ACPI 5.0 */
580 ACPI_HEST_NOTIFY_RESERVED = 7 /* 7 and greater are reserved */
583 /* Values for ConfigWriteEnable bitfield above */
585 #define ACPI_HEST_TYPE (1)
586 #define ACPI_HEST_POLL_INTERVAL (1<<1)
587 #define ACPI_HEST_POLL_THRESHOLD_VALUE (1<<2)
588 #define ACPI_HEST_POLL_THRESHOLD_WINDOW (1<<3)
589 #define ACPI_HEST_ERR_THRESHOLD_VALUE (1<<4)
590 #define ACPI_HEST_ERR_THRESHOLD_WINDOW (1<<5)
597 /* 0: IA32 Machine Check Exception */
599 typedef struct acpi_hest_ia_machine_check
601 ACPI_HEST_HEADER Header;
605 UINT32 RecordsToPreallocate;
606 UINT32 MaxSectionsPerRecord;
607 UINT64 GlobalCapabilityData;
608 UINT64 GlobalControlData;
609 UINT8 NumHardwareBanks;
612 } ACPI_HEST_IA_MACHINE_CHECK;
615 /* 1: IA32 Corrected Machine Check */
617 typedef struct acpi_hest_ia_corrected
619 ACPI_HEST_HEADER Header;
623 UINT32 RecordsToPreallocate;
624 UINT32 MaxSectionsPerRecord;
625 ACPI_HEST_NOTIFY Notify;
626 UINT8 NumHardwareBanks;
629 } ACPI_HEST_IA_CORRECTED;
632 /* 2: IA32 Non-Maskable Interrupt */
634 typedef struct acpi_hest_ia_nmi
636 ACPI_HEST_HEADER Header;
638 UINT32 RecordsToPreallocate;
639 UINT32 MaxSectionsPerRecord;
640 UINT32 MaxRawDataLength;
645 /* 3,4,5: Not used */
647 /* 6: PCI Express Root Port AER */
649 typedef struct acpi_hest_aer_root
651 ACPI_HEST_HEADER Header;
652 ACPI_HEST_AER_COMMON Aer;
653 UINT32 RootErrorCommand;
655 } ACPI_HEST_AER_ROOT;
658 /* 7: PCI Express AER (AER Endpoint) */
660 typedef struct acpi_hest_aer
662 ACPI_HEST_HEADER Header;
663 ACPI_HEST_AER_COMMON Aer;
668 /* 8: PCI Express/PCI-X Bridge AER */
670 typedef struct acpi_hest_aer_bridge
672 ACPI_HEST_HEADER Header;
673 ACPI_HEST_AER_COMMON Aer;
674 UINT32 UncorrectableMask2;
675 UINT32 UncorrectableSeverity2;
676 UINT32 AdvancedCapabilities2;
678 } ACPI_HEST_AER_BRIDGE;
681 /* 9: Generic Hardware Error Source */
683 typedef struct acpi_hest_generic
685 ACPI_HEST_HEADER Header;
686 UINT16 RelatedSourceId;
689 UINT32 RecordsToPreallocate;
690 UINT32 MaxSectionsPerRecord;
691 UINT32 MaxRawDataLength;
692 ACPI_GENERIC_ADDRESS ErrorStatusAddress;
693 ACPI_HEST_NOTIFY Notify;
694 UINT32 ErrorBlockLength;
699 /* Generic Error Status block */
701 typedef struct acpi_hest_generic_status
704 UINT32 RawDataOffset;
705 UINT32 RawDataLength;
707 UINT32 ErrorSeverity;
709 } ACPI_HEST_GENERIC_STATUS;
711 /* Values for BlockStatus flags above */
713 #define ACPI_HEST_UNCORRECTABLE (1)
714 #define ACPI_HEST_CORRECTABLE (1<<1)
715 #define ACPI_HEST_MULTIPLE_UNCORRECTABLE (1<<2)
716 #define ACPI_HEST_MULTIPLE_CORRECTABLE (1<<3)
717 #define ACPI_HEST_ERROR_ENTRY_COUNT (0xFF<<4) /* 8 bits, error count */
720 /* Generic Error Data entry */
722 typedef struct acpi_hest_generic_data
724 UINT8 SectionType[16];
725 UINT32 ErrorSeverity;
727 UINT8 ValidationBits;
729 UINT32 ErrorDataLength;
733 } ACPI_HEST_GENERIC_DATA;
736 /*******************************************************************************
738 * MADT - Multiple APIC Description Table
741 ******************************************************************************/
743 typedef struct acpi_table_madt
745 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
746 UINT32 Address; /* Physical address of local APIC */
751 /* Masks for Flags field above */
753 #define ACPI_MADT_PCAT_COMPAT (1) /* 00: System also has dual 8259s */
755 /* Values for PCATCompat flag */
757 #define ACPI_MADT_DUAL_PIC 0
758 #define ACPI_MADT_MULTIPLE_APIC 1
761 /* Values for MADT subtable type in ACPI_SUBTABLE_HEADER */
765 ACPI_MADT_TYPE_LOCAL_APIC = 0,
766 ACPI_MADT_TYPE_IO_APIC = 1,
767 ACPI_MADT_TYPE_INTERRUPT_OVERRIDE = 2,
768 ACPI_MADT_TYPE_NMI_SOURCE = 3,
769 ACPI_MADT_TYPE_LOCAL_APIC_NMI = 4,
770 ACPI_MADT_TYPE_LOCAL_APIC_OVERRIDE = 5,
771 ACPI_MADT_TYPE_IO_SAPIC = 6,
772 ACPI_MADT_TYPE_LOCAL_SAPIC = 7,
773 ACPI_MADT_TYPE_INTERRUPT_SOURCE = 8,
774 ACPI_MADT_TYPE_LOCAL_X2APIC = 9,
775 ACPI_MADT_TYPE_LOCAL_X2APIC_NMI = 10,
776 ACPI_MADT_TYPE_GENERIC_INTERRUPT = 11,
777 ACPI_MADT_TYPE_GENERIC_DISTRIBUTOR = 12,
778 ACPI_MADT_TYPE_GENERIC_MSI_FRAME = 13,
779 ACPI_MADT_TYPE_GENERIC_REDISTRIBUTOR = 14,
780 ACPI_MADT_TYPE_RESERVED = 15 /* 15 and greater are reserved */
785 * MADT Subtables, correspond to Type in ACPI_SUBTABLE_HEADER
788 /* 0: Processor Local APIC */
790 typedef struct acpi_madt_local_apic
792 ACPI_SUBTABLE_HEADER Header;
793 UINT8 ProcessorId; /* ACPI processor id */
794 UINT8 Id; /* Processor's local APIC id */
797 } ACPI_MADT_LOCAL_APIC;
802 typedef struct acpi_madt_io_apic
804 ACPI_SUBTABLE_HEADER Header;
805 UINT8 Id; /* I/O APIC ID */
806 UINT8 Reserved; /* Reserved - must be zero */
807 UINT32 Address; /* APIC physical address */
808 UINT32 GlobalIrqBase; /* Global system interrupt where INTI lines start */
813 /* 2: Interrupt Override */
815 typedef struct acpi_madt_interrupt_override
817 ACPI_SUBTABLE_HEADER Header;
818 UINT8 Bus; /* 0 - ISA */
819 UINT8 SourceIrq; /* Interrupt source (IRQ) */
820 UINT32 GlobalIrq; /* Global system interrupt */
823 } ACPI_MADT_INTERRUPT_OVERRIDE;
828 typedef struct acpi_madt_nmi_source
830 ACPI_SUBTABLE_HEADER Header;
832 UINT32 GlobalIrq; /* Global system interrupt */
834 } ACPI_MADT_NMI_SOURCE;
837 /* 4: Local APIC NMI */
839 typedef struct acpi_madt_local_apic_nmi
841 ACPI_SUBTABLE_HEADER Header;
842 UINT8 ProcessorId; /* ACPI processor id */
844 UINT8 Lint; /* LINTn to which NMI is connected */
846 } ACPI_MADT_LOCAL_APIC_NMI;
849 /* 5: Address Override */
851 typedef struct acpi_madt_local_apic_override
853 ACPI_SUBTABLE_HEADER Header;
854 UINT16 Reserved; /* Reserved, must be zero */
855 UINT64 Address; /* APIC physical address */
857 } ACPI_MADT_LOCAL_APIC_OVERRIDE;
862 typedef struct acpi_madt_io_sapic
864 ACPI_SUBTABLE_HEADER Header;
865 UINT8 Id; /* I/O SAPIC ID */
866 UINT8 Reserved; /* Reserved, must be zero */
867 UINT32 GlobalIrqBase; /* Global interrupt for SAPIC start */
868 UINT64 Address; /* SAPIC physical address */
870 } ACPI_MADT_IO_SAPIC;
875 typedef struct acpi_madt_local_sapic
877 ACPI_SUBTABLE_HEADER Header;
878 UINT8 ProcessorId; /* ACPI processor id */
879 UINT8 Id; /* SAPIC ID */
880 UINT8 Eid; /* SAPIC EID */
881 UINT8 Reserved[3]; /* Reserved, must be zero */
883 UINT32 Uid; /* Numeric UID - ACPI 3.0 */
884 char UidString[1]; /* String UID - ACPI 3.0 */
886 } ACPI_MADT_LOCAL_SAPIC;
889 /* 8: Platform Interrupt Source */
891 typedef struct acpi_madt_interrupt_source
893 ACPI_SUBTABLE_HEADER Header;
895 UINT8 Type; /* 1=PMI, 2=INIT, 3=corrected */
896 UINT8 Id; /* Processor ID */
897 UINT8 Eid; /* Processor EID */
898 UINT8 IoSapicVector; /* Vector value for PMI interrupts */
899 UINT32 GlobalIrq; /* Global system interrupt */
900 UINT32 Flags; /* Interrupt Source Flags */
902 } ACPI_MADT_INTERRUPT_SOURCE;
904 /* Masks for Flags field above */
906 #define ACPI_MADT_CPEI_OVERRIDE (1)
909 /* 9: Processor Local X2APIC (ACPI 4.0) */
911 typedef struct acpi_madt_local_x2apic
913 ACPI_SUBTABLE_HEADER Header;
914 UINT16 Reserved; /* Reserved - must be zero */
915 UINT32 LocalApicId; /* Processor x2APIC ID */
917 UINT32 Uid; /* ACPI processor UID */
919 } ACPI_MADT_LOCAL_X2APIC;
922 /* 10: Local X2APIC NMI (ACPI 4.0) */
924 typedef struct acpi_madt_local_x2apic_nmi
926 ACPI_SUBTABLE_HEADER Header;
928 UINT32 Uid; /* ACPI processor UID */
929 UINT8 Lint; /* LINTn to which NMI is connected */
930 UINT8 Reserved[3]; /* Reserved - must be zero */
932 } ACPI_MADT_LOCAL_X2APIC_NMI;
935 /* 11: Generic Interrupt (ACPI 5.0) */
937 typedef struct acpi_madt_generic_interrupt
939 ACPI_SUBTABLE_HEADER Header;
940 UINT16 Reserved; /* Reserved - must be zero */
941 UINT32 CpuInterfaceNumber;
944 UINT32 ParkingVersion;
945 UINT32 PerformanceInterrupt;
946 UINT64 ParkedAddress;
948 UINT64 GicvBaseAddress;
949 UINT64 GichBaseAddress;
950 UINT32 VgicInterrupt;
951 UINT64 GicrBaseAddress;
954 } ACPI_MADT_GENERIC_INTERRUPT;
956 /* Masks for Flags field above */
958 /* ACPI_MADT_ENABLED (1) Processor is usable if set */
959 #define ACPI_MADT_PERFORMANCE_IRQ_MODE (1<<1) /* 01: Performance Interrupt Mode */
960 #define ACPI_MADT_VGIC_IRQ_MODE (1<<2) /* 02: VGIC Maintenance Interrupt mode */
963 /* 12: Generic Distributor (ACPI 5.0) */
965 typedef struct acpi_madt_generic_distributor
967 ACPI_SUBTABLE_HEADER Header;
968 UINT16 Reserved; /* Reserved - must be zero */
971 UINT32 GlobalIrqBase;
972 UINT32 Reserved2; /* Reserved - must be zero */
974 } ACPI_MADT_GENERIC_DISTRIBUTOR;
977 /* 13: Generic MSI Frame (ACPI 5.1) */
979 typedef struct acpi_madt_generic_msi_frame
981 ACPI_SUBTABLE_HEADER Header;
982 UINT16 Reserved; /* Reserved - must be zero */
989 } ACPI_MADT_GENERIC_MSI_FRAME;
991 /* Masks for Flags field above */
993 #define ACPI_MADT_OVERRIDE_SPI_VALUES (1)
996 /* 14: Generic Redistributor (ACPI 5.1) */
998 typedef struct acpi_madt_generic_redistributor
1000 ACPI_SUBTABLE_HEADER Header;
1001 UINT16 Reserved; /* reserved - must be zero */
1005 } ACPI_MADT_GENERIC_REDISTRIBUTOR;
1009 * Common flags fields for MADT subtables
1012 /* MADT Local APIC flags */
1014 #define ACPI_MADT_ENABLED (1) /* 00: Processor is usable if set */
1016 /* MADT MPS INTI flags (IntiFlags) */
1018 #define ACPI_MADT_POLARITY_MASK (3) /* 00-01: Polarity of APIC I/O input signals */
1019 #define ACPI_MADT_TRIGGER_MASK (3<<2) /* 02-03: Trigger mode of APIC input signals */
1021 /* Values for MPS INTI flags */
1023 #define ACPI_MADT_POLARITY_CONFORMS 0
1024 #define ACPI_MADT_POLARITY_ACTIVE_HIGH 1
1025 #define ACPI_MADT_POLARITY_RESERVED 2
1026 #define ACPI_MADT_POLARITY_ACTIVE_LOW 3
1028 #define ACPI_MADT_TRIGGER_CONFORMS (0)
1029 #define ACPI_MADT_TRIGGER_EDGE (1<<2)
1030 #define ACPI_MADT_TRIGGER_RESERVED (2<<2)
1031 #define ACPI_MADT_TRIGGER_LEVEL (3<<2)
1034 /*******************************************************************************
1036 * MSCT - Maximum System Characteristics Table (ACPI 4.0)
1039 ******************************************************************************/
1041 typedef struct acpi_table_msct
1043 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
1044 UINT32 ProximityOffset; /* Location of proximity info struct(s) */
1045 UINT32 MaxProximityDomains;/* Max number of proximity domains */
1046 UINT32 MaxClockDomains; /* Max number of clock domains */
1047 UINT64 MaxAddress; /* Max physical address in system */
1052 /* Subtable - Maximum Proximity Domain Information. Version 1 */
1054 typedef struct acpi_msct_proximity
1058 UINT32 RangeStart; /* Start of domain range */
1059 UINT32 RangeEnd; /* End of domain range */
1060 UINT32 ProcessorCapacity;
1061 UINT64 MemoryCapacity; /* In bytes */
1063 } ACPI_MSCT_PROXIMITY;
1066 /*******************************************************************************
1068 * SBST - Smart Battery Specification Table
1071 ******************************************************************************/
1073 typedef struct acpi_table_sbst
1075 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
1076 UINT32 WarningLevel;
1078 UINT32 CriticalLevel;
1083 /*******************************************************************************
1085 * SLIT - System Locality Distance Information Table
1088 ******************************************************************************/
1090 typedef struct acpi_table_slit
1092 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
1093 UINT64 LocalityCount;
1094 UINT8 Entry[1]; /* Real size = localities^2 */
1099 /*******************************************************************************
1101 * SRAT - System Resource Affinity Table
1104 ******************************************************************************/
1106 typedef struct acpi_table_srat
1108 ACPI_TABLE_HEADER Header; /* Common ACPI table header */
1109 UINT32 TableRevision; /* Must be value '1' */
1110 UINT64 Reserved; /* Reserved, must be zero */
1114 /* Values for subtable type in ACPI_SUBTABLE_HEADER */
1118 ACPI_SRAT_TYPE_CPU_AFFINITY = 0,
1119 ACPI_SRAT_TYPE_MEMORY_AFFINITY = 1,
1120 ACPI_SRAT_TYPE_X2APIC_CPU_AFFINITY = 2,
1121 ACPI_SRAT_TYPE_GICC_AFFINITY = 3,
1122 ACPI_SRAT_TYPE_RESERVED = 4 /* 4 and greater are reserved */
1126 * SRAT Subtables, correspond to Type in ACPI_SUBTABLE_HEADER
1129 /* 0: Processor Local APIC/SAPIC Affinity */
1131 typedef struct acpi_srat_cpu_affinity
1133 ACPI_SUBTABLE_HEADER Header;
1134 UINT8 ProximityDomainLo;
1137 UINT8 LocalSapicEid;
1138 UINT8 ProximityDomainHi[3];
1141 } ACPI_SRAT_CPU_AFFINITY;
1145 #define ACPI_SRAT_CPU_USE_AFFINITY (1) /* 00: Use affinity structure */
1148 /* 1: Memory Affinity */
1150 typedef struct acpi_srat_mem_affinity
1152 ACPI_SUBTABLE_HEADER Header;
1153 UINT32 ProximityDomain;
1154 UINT16 Reserved; /* Reserved, must be zero */
1159 UINT64 Reserved2; /* Reserved, must be zero */
1161 } ACPI_SRAT_MEM_AFFINITY;
1165 #define ACPI_SRAT_MEM_ENABLED (1) /* 00: Use affinity structure */
1166 #define ACPI_SRAT_MEM_HOT_PLUGGABLE (1<<1) /* 01: Memory region is hot pluggable */
1167 #define ACPI_SRAT_MEM_NON_VOLATILE (1<<2) /* 02: Memory region is non-volatile */
1170 /* 2: Processor Local X2_APIC Affinity (ACPI 4.0) */
1172 typedef struct acpi_srat_x2apic_cpu_affinity
1174 ACPI_SUBTABLE_HEADER Header;
1175 UINT16 Reserved; /* Reserved, must be zero */
1176 UINT32 ProximityDomain;
1182 } ACPI_SRAT_X2APIC_CPU_AFFINITY;
1184 /* Flags for ACPI_SRAT_CPU_AFFINITY and ACPI_SRAT_X2APIC_CPU_AFFINITY */
1186 #define ACPI_SRAT_CPU_ENABLED (1) /* 00: Use affinity structure */
1189 /* 3: GICC Affinity (ACPI 5.1) */
1191 typedef struct acpi_srat_gicc_affinity
1193 ACPI_SUBTABLE_HEADER Header;
1194 UINT32 ProximityDomain;
1195 UINT32 AcpiProcessorUid;
1199 } ACPI_SRAT_GICC_AFFINITY;
1201 /* Flags for ACPI_SRAT_GICC_AFFINITY */
1203 #define ACPI_SRAT_GICC_ENABLED (1) /* 00: Use affinity structure */
1205 /* Reset to default packing */
1209 #endif /* __ACTBL1_H__ */