1 /* SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 */ 2 /****************************************************************************** 3 * 4 * Name: actbl2.h - ACPI Table Definitions (tables not in ACPI spec) 5 * 6 * Copyright (C) 2000 - 2023, Intel Corp. 7 * 8 *****************************************************************************/ 9 10 #ifndef __ACTBL2_H__ 11 #define __ACTBL2_H__ 12 13 /******************************************************************************* 14 * 15 * Additional ACPI Tables (2) 16 * 17 * These tables are not consumed directly by the ACPICA subsystem, but are 18 * included here to support device drivers and the AML disassembler. 19 * 20 ******************************************************************************/ 21 22 /* 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. 26 */ 27 #define ACPI_SIG_AGDI "AGDI" /* Arm Generic Diagnostic Dump and Reset Device Interface */ 28 #define ACPI_SIG_APMT "APMT" /* Arm Performance Monitoring Unit table */ 29 #define ACPI_SIG_BDAT "BDAT" /* BIOS Data ACPI Table */ 30 #define ACPI_SIG_CCEL "CCEL" /* CC Event Log Table */ 31 #define ACPI_SIG_CDAT "CDAT" /* Coherent Device Attribute Table */ 32 #define ACPI_SIG_IORT "IORT" /* IO Remapping Table */ 33 #define ACPI_SIG_IVRS "IVRS" /* I/O Virtualization Reporting Structure */ 34 #define ACPI_SIG_LPIT "LPIT" /* Low Power Idle Table */ 35 #define ACPI_SIG_MADT "APIC" /* Multiple APIC Description Table */ 36 #define ACPI_SIG_MCFG "MCFG" /* PCI Memory Mapped Configuration table */ 37 #define ACPI_SIG_MCHI "MCHI" /* Management Controller Host Interface table */ 38 #define ACPI_SIG_MPAM "MPAM" /* Memory System Resource Partitioning and Monitoring Table */ 39 #define ACPI_SIG_MPST "MPST" /* Memory Power State Table */ 40 #define ACPI_SIG_MSDM "MSDM" /* Microsoft Data Management Table */ 41 #define ACPI_SIG_NFIT "NFIT" /* NVDIMM Firmware Interface Table */ 42 #define ACPI_SIG_NHLT "NHLT" /* Non HD Audio Link Table */ 43 #define ACPI_SIG_PCCT "PCCT" /* Platform Communications Channel Table */ 44 #define ACPI_SIG_PDTT "PDTT" /* Platform Debug Trigger Table */ 45 #define ACPI_SIG_PHAT "PHAT" /* Platform Health Assessment Table */ 46 #define ACPI_SIG_PMTT "PMTT" /* Platform Memory Topology Table */ 47 #define ACPI_SIG_PPTT "PPTT" /* Processor Properties Topology Table */ 48 #define ACPI_SIG_PRMT "PRMT" /* Platform Runtime Mechanism Table */ 49 #define ACPI_SIG_RASF "RASF" /* RAS Feature table */ 50 #define ACPI_SIG_RAS2 "RAS2" /* RAS2 Feature table */ 51 #define ACPI_SIG_RGRT "RGRT" /* Regulatory Graphics Resource Table */ 52 #define ACPI_SIG_RHCT "RHCT" /* RISC-V Hart Capabilities Table */ 53 #define ACPI_SIG_SBST "SBST" /* Smart Battery Specification Table */ 54 #define ACPI_SIG_SDEI "SDEI" /* Software Delegated Exception Interface Table */ 55 #define ACPI_SIG_SDEV "SDEV" /* Secure Devices table */ 56 #define ACPI_SIG_SVKL "SVKL" /* Storage Volume Key Location Table */ 57 #define ACPI_SIG_TDEL "TDEL" /* TD Event Log Table */ 58 59 /* 60 * All tables must be byte-packed to match the ACPI specification, since 61 * the tables are provided by the system BIOS. 62 */ 63 #pragma pack(1) 64 65 /* 66 * Note: C bitfields are not used for this reason: 67 * 68 * "Bitfields are great and easy to read, but unfortunately the C language 69 * does not specify the layout of bitfields in memory, which means they are 70 * essentially useless for dealing with packed data in on-disk formats or 71 * binary wire protocols." (Or ACPI tables and buffers.) "If you ask me, 72 * this decision was a design error in C. Ritchie could have picked an order 73 * and stuck with it." Norman Ramsey. 74 * See http://stackoverflow.com/a/1053662/41661 75 */ 76 77 /******************************************************************************* 78 * 79 * AEST - Arm Error Source Table 80 * 81 * Conforms to: ACPI for the Armv8 RAS Extensions 1.1(Sep 2020) and 82 * 2.0(May 2023) Platform Design Document. 83 * 84 ******************************************************************************/ 85 86 struct acpi_table_aest { 87 struct acpi_table_header header; 88 }; 89 90 /* Common Subtable header - one per Node Structure (Subtable) */ 91 92 struct acpi_aest_hdr { 93 u8 type; 94 u16 length; 95 u8 reserved; 96 u32 node_specific_offset; 97 u32 node_interface_offset; 98 u32 node_interrupt_offset; 99 u32 node_interrupt_count; 100 u64 timestamp_rate; 101 u64 reserved1; 102 u64 error_injection_rate; 103 }; 104 105 /* Values for Type above */ 106 107 #define ACPI_AEST_PROCESSOR_ERROR_NODE 0 108 #define ACPI_AEST_MEMORY_ERROR_NODE 1 109 #define ACPI_AEST_SMMU_ERROR_NODE 2 110 #define ACPI_AEST_VENDOR_ERROR_NODE 3 111 #define ACPI_AEST_GIC_ERROR_NODE 4 112 #define ACPI_AEST_PCIE_ERROR_NODE 5 113 #define ACPI_AEST_PROXY_ERROR_NODE 6 114 #define ACPI_AEST_NODE_TYPE_RESERVED 7 /* 7 and above are reserved */ 115 116 /* 117 * AEST subtables (Error nodes) 118 */ 119 120 /* 0: Processor Error */ 121 122 typedef struct acpi_aest_processor { 123 u32 processor_id; 124 u8 resource_type; 125 u8 reserved; 126 u8 flags; 127 u8 revision; 128 u64 processor_affinity; 129 130 } acpi_aest_processor; 131 132 /* Values for resource_type above, related structs below */ 133 134 #define ACPI_AEST_CACHE_RESOURCE 0 135 #define ACPI_AEST_TLB_RESOURCE 1 136 #define ACPI_AEST_GENERIC_RESOURCE 2 137 #define ACPI_AEST_RESOURCE_RESERVED 3 /* 3 and above are reserved */ 138 139 /* 0R: Processor Cache Resource Substructure */ 140 141 typedef struct acpi_aest_processor_cache { 142 u32 cache_reference; 143 u32 reserved; 144 145 } acpi_aest_processor_cache; 146 147 /* Values for cache_type above */ 148 149 #define ACPI_AEST_CACHE_DATA 0 150 #define ACPI_AEST_CACHE_INSTRUCTION 1 151 #define ACPI_AEST_CACHE_UNIFIED 2 152 #define ACPI_AEST_CACHE_RESERVED 3 /* 3 and above are reserved */ 153 154 /* 1R: Processor TLB Resource Substructure */ 155 156 typedef struct acpi_aest_processor_tlb { 157 u32 tlb_level; 158 u32 reserved; 159 160 } acpi_aest_processor_tlb; 161 162 /* 2R: Processor Generic Resource Substructure */ 163 164 typedef struct acpi_aest_processor_generic { 165 u32 resource; 166 167 } acpi_aest_processor_generic; 168 169 /* 1: Memory Error */ 170 171 typedef struct acpi_aest_memory { 172 u32 srat_proximity_domain; 173 174 } acpi_aest_memory; 175 176 /* 2: Smmu Error */ 177 178 typedef struct acpi_aest_smmu { 179 u32 iort_node_reference; 180 u32 subcomponent_reference; 181 182 } acpi_aest_smmu; 183 184 /* 3: Vendor Defined */ 185 186 typedef struct acpi_aest_vendor { 187 u32 acpi_hid; 188 u32 acpi_uid; 189 u8 vendor_specific_data[16]; 190 191 } acpi_aest_vendor; 192 193 struct acpi_aest_vendor_v2 { 194 char acpi_hid[8]; 195 u32 acpi_uid; 196 u8 vendor_specific_data[16]; 197 }; 198 199 /* 4: Gic Error */ 200 201 typedef struct acpi_aest_gic { 202 u32 interface_type; 203 u32 instance_id; 204 205 } acpi_aest_gic; 206 207 /* Values for interface_type above */ 208 209 #define ACPI_AEST_GIC_CPU 0 210 #define ACPI_AEST_GIC_DISTRIBUTOR 1 211 #define ACPI_AEST_GIC_REDISTRIBUTOR 2 212 #define ACPI_AEST_GIC_ITS 3 213 #define ACPI_AEST_GIC_RESERVED 4 /* 4 and above are reserved */ 214 215 /* 5: PCIe Error */ 216 217 struct acpi_aest_pcie { 218 u32 iort_node_reference; 219 }; 220 221 /* 6: Proxy Error */ 222 223 struct acpi_aest_proxy { 224 u64 node_address; 225 }; 226 227 /* Node Interface Structure */ 228 229 typedef struct acpi_aest_node_interface { 230 u8 type; 231 u8 reserved[3]; 232 u32 flags; 233 u64 address; 234 u32 error_record_index; 235 u32 error_record_count; 236 u64 error_record_implemented; 237 u64 error_status_reporting; 238 u64 addressing_mode; 239 240 } acpi_aest_node_interface; 241 242 /* Node Interface Structure V2 */ 243 244 struct acpi_aest_node_interface_header { 245 u8 type; 246 u8 group_format; 247 u8 reserved[2]; 248 u32 flags; 249 u64 address; 250 u32 error_record_index; 251 u32 error_record_count; 252 }; 253 254 #define ACPI_AEST_NODE_GROUP_FORMAT_4K 0 255 #define ACPI_AEST_NODE_GROUP_FORMAT_16K 1 256 #define ACPI_AEST_NODE_GROUP_FORMAT_64K 2 257 258 struct acpi_aest_node_interface_common { 259 u32 error_node_device; 260 u32 processor_affinity; 261 u64 error_group_register_base; 262 u64 fault_inject_register_base; 263 u64 interrupt_config_register_base; 264 }; 265 266 struct acpi_aest_node_interface_4k { 267 u64 error_record_implemented; 268 u64 error_status_reporting; 269 u64 addressing_mode; 270 struct acpi_aest_node_interface_common common; 271 }; 272 273 struct acpi_aest_node_interface_16k { 274 u64 error_record_implemented[4]; 275 u64 error_status_reporting[4]; 276 u64 addressing_mode[4]; 277 struct acpi_aest_node_interface_common common; 278 }; 279 280 struct acpi_aest_node_interface_64k { 281 u64 error_record_implemented[14]; 282 u64 error_status_reporting[14]; 283 u64 addressing_mode[14]; 284 struct acpi_aest_node_interface_common common; 285 }; 286 287 /* Values for Type field above */ 288 289 #define ACPI_AEST_NODE_SYSTEM_REGISTER 0 290 #define ACPI_AEST_NODE_MEMORY_MAPPED 1 291 #define ACPI_AEST_NODE_SINGLE_RECORD_MEMORY_MAPPED 2 292 #define ACPI_AEST_XFACE_RESERVED 3 /* 2 and above are reserved */ 293 294 /* Node Interrupt Structure */ 295 296 typedef struct acpi_aest_node_interrupt { 297 u8 type; 298 u8 reserved[2]; 299 u8 flags; 300 u32 gsiv; 301 u8 iort_id; 302 u8 reserved1[3]; 303 304 } acpi_aest_node_interrupt; 305 306 /* Node Interrupt Structure V2 */ 307 308 struct acpi_aest_node_interrupt_v2 { 309 u8 type; 310 u8 reserved[2]; 311 u8 flags; 312 u32 gsiv; 313 u8 reserved1[4]; 314 }; 315 316 /* Values for Type field above */ 317 318 #define ACPI_AEST_NODE_FAULT_HANDLING 0 319 #define ACPI_AEST_NODE_ERROR_RECOVERY 1 320 #define ACPI_AEST_XRUPT_RESERVED 2 /* 2 and above are reserved */ 321 322 /******************************************************************************* 323 * AGDI - Arm Generic Diagnostic Dump and Reset Device Interface 324 * 325 * Conforms to "ACPI for Arm Components 1.1, Platform Design Document" 326 * ARM DEN0093 v1.1 327 * 328 ******************************************************************************/ 329 struct acpi_table_agdi { 330 struct acpi_table_header header; /* Common ACPI table header */ 331 u8 flags; 332 u8 reserved[3]; 333 u32 sdei_event; 334 u32 gsiv; 335 }; 336 337 /* Mask for Flags field above */ 338 339 #define ACPI_AGDI_SIGNALING_MODE (1) 340 341 /******************************************************************************* 342 * 343 * APMT - ARM Performance Monitoring Unit Table 344 * 345 * Conforms to: 346 * ARM Performance Monitoring Unit Architecture 1.0 Platform Design Document 347 * ARM DEN0117 v1.0 November 25, 2021 348 * 349 ******************************************************************************/ 350 351 struct acpi_table_apmt { 352 struct acpi_table_header header; /* Common ACPI table header */ 353 }; 354 355 #define ACPI_APMT_NODE_ID_LENGTH 4 356 357 /* 358 * APMT subtables 359 */ 360 struct acpi_apmt_node { 361 u16 length; 362 u8 flags; 363 u8 type; 364 u32 id; 365 u64 inst_primary; 366 u32 inst_secondary; 367 u64 base_address0; 368 u64 base_address1; 369 u32 ovflw_irq; 370 u32 reserved; 371 u32 ovflw_irq_flags; 372 u32 proc_affinity; 373 u32 impl_id; 374 }; 375 376 /* Masks for Flags field above */ 377 378 #define ACPI_APMT_FLAGS_DUAL_PAGE (1<<0) 379 #define ACPI_APMT_FLAGS_AFFINITY (1<<1) 380 #define ACPI_APMT_FLAGS_ATOMIC (1<<2) 381 382 /* Values for Flags dual page field above */ 383 384 #define ACPI_APMT_FLAGS_DUAL_PAGE_NSUPP (0<<0) 385 #define ACPI_APMT_FLAGS_DUAL_PAGE_SUPP (1<<0) 386 387 /* Values for Flags processor affinity field above */ 388 #define ACPI_APMT_FLAGS_AFFINITY_PROC (0<<1) 389 #define ACPI_APMT_FLAGS_AFFINITY_PROC_CONTAINER (1<<1) 390 391 /* Values for Flags 64-bit atomic field above */ 392 #define ACPI_APMT_FLAGS_ATOMIC_NSUPP (0<<2) 393 #define ACPI_APMT_FLAGS_ATOMIC_SUPP (1<<2) 394 395 /* Values for Type field above */ 396 397 enum acpi_apmt_node_type { 398 ACPI_APMT_NODE_TYPE_MC = 0x00, 399 ACPI_APMT_NODE_TYPE_SMMU = 0x01, 400 ACPI_APMT_NODE_TYPE_PCIE_ROOT = 0x02, 401 ACPI_APMT_NODE_TYPE_ACPI = 0x03, 402 ACPI_APMT_NODE_TYPE_CACHE = 0x04, 403 ACPI_APMT_NODE_TYPE_COUNT 404 }; 405 406 /* Masks for ovflw_irq_flags field above */ 407 408 #define ACPI_APMT_OVFLW_IRQ_FLAGS_MODE (1<<0) 409 #define ACPI_APMT_OVFLW_IRQ_FLAGS_TYPE (1<<1) 410 411 /* Values for ovflw_irq_flags mode field above */ 412 413 #define ACPI_APMT_OVFLW_IRQ_FLAGS_MODE_LEVEL (0<<0) 414 #define ACPI_APMT_OVFLW_IRQ_FLAGS_MODE_EDGE (1<<0) 415 416 /* Values for ovflw_irq_flags type field above */ 417 418 #define ACPI_APMT_OVFLW_IRQ_FLAGS_TYPE_WIRED (0<<1) 419 420 /******************************************************************************* 421 * 422 * BDAT - BIOS Data ACPI Table 423 * 424 * Conforms to "BIOS Data ACPI Table", Interface Specification v4.0 Draft 5 425 * Nov 2020 426 * 427 ******************************************************************************/ 428 429 struct acpi_table_bdat { 430 struct acpi_table_header header; 431 struct acpi_generic_address gas; 432 }; 433 434 /******************************************************************************* 435 * 436 * CCEL - CC-Event Log 437 * From: "Guest-Host-Communication Interface (GHCI) for Intel 438 * Trust Domain Extensions (Intel TDX)". Feb 2022 439 * 440 ******************************************************************************/ 441 442 struct acpi_table_ccel { 443 struct acpi_table_header header; /* Common ACPI table header */ 444 u8 CCtype; 445 u8 Ccsub_type; 446 u16 reserved; 447 u64 log_area_minimum_length; 448 u64 log_area_start_address; 449 }; 450 451 /******************************************************************************* 452 * 453 * IORT - IO Remapping Table 454 * 455 * Conforms to "IO Remapping Table System Software on ARM Platforms", 456 * Document number: ARM DEN 0049E.e, Sep 2022 457 * 458 ******************************************************************************/ 459 460 struct acpi_table_iort { 461 struct acpi_table_header header; 462 u32 node_count; 463 u32 node_offset; 464 u32 reserved; 465 }; 466 467 /* 468 * IORT subtables 469 */ 470 struct acpi_iort_node { 471 u8 type; 472 u16 length; 473 u8 revision; 474 u32 identifier; 475 u32 mapping_count; 476 u32 mapping_offset; 477 char node_data[]; 478 }; 479 480 /* Values for subtable Type above */ 481 482 enum acpi_iort_node_type { 483 ACPI_IORT_NODE_ITS_GROUP = 0x00, 484 ACPI_IORT_NODE_NAMED_COMPONENT = 0x01, 485 ACPI_IORT_NODE_PCI_ROOT_COMPLEX = 0x02, 486 ACPI_IORT_NODE_SMMU = 0x03, 487 ACPI_IORT_NODE_SMMU_V3 = 0x04, 488 ACPI_IORT_NODE_PMCG = 0x05, 489 ACPI_IORT_NODE_RMR = 0x06, 490 }; 491 492 struct acpi_iort_id_mapping { 493 u32 input_base; /* Lowest value in input range */ 494 u32 id_count; /* Number of IDs */ 495 u32 output_base; /* Lowest value in output range */ 496 u32 output_reference; /* A reference to the output node */ 497 u32 flags; 498 }; 499 500 /* Masks for Flags field above for IORT subtable */ 501 502 #define ACPI_IORT_ID_SINGLE_MAPPING (1) 503 504 struct acpi_iort_memory_access { 505 u32 cache_coherency; 506 u8 hints; 507 u16 reserved; 508 u8 memory_flags; 509 }; 510 511 /* Values for cache_coherency field above */ 512 513 #define ACPI_IORT_NODE_COHERENT 0x00000001 /* The device node is fully coherent */ 514 #define ACPI_IORT_NODE_NOT_COHERENT 0x00000000 /* The device node is not coherent */ 515 516 /* Masks for Hints field above */ 517 518 #define ACPI_IORT_HT_TRANSIENT (1) 519 #define ACPI_IORT_HT_WRITE (1<<1) 520 #define ACPI_IORT_HT_READ (1<<2) 521 #define ACPI_IORT_HT_OVERRIDE (1<<3) 522 523 /* Masks for memory_flags field above */ 524 525 #define ACPI_IORT_MF_COHERENCY (1) 526 #define ACPI_IORT_MF_ATTRIBUTES (1<<1) 527 528 /* 529 * IORT node specific subtables 530 */ 531 struct acpi_iort_its_group { 532 u32 its_count; 533 u32 identifiers[]; /* GIC ITS identifier array */ 534 }; 535 536 struct acpi_iort_named_component { 537 u32 node_flags; 538 u64 memory_properties; /* Memory access properties */ 539 u8 memory_address_limit; /* Memory address size limit */ 540 char device_name[]; /* Path of namespace object */ 541 }; 542 543 /* Masks for Flags field above */ 544 545 #define ACPI_IORT_NC_STALL_SUPPORTED (1) 546 #define ACPI_IORT_NC_PASID_BITS (31<<1) 547 548 struct acpi_iort_root_complex { 549 u64 memory_properties; /* Memory access properties */ 550 u32 ats_attribute; 551 u32 pci_segment_number; 552 u8 memory_address_limit; /* Memory address size limit */ 553 u16 pasid_capabilities; /* PASID Capabilities */ 554 u8 reserved[]; /* Reserved, must be zero */ 555 }; 556 557 /* Masks for ats_attribute field above */ 558 559 #define ACPI_IORT_ATS_SUPPORTED (1) /* The root complex ATS support */ 560 #define ACPI_IORT_PRI_SUPPORTED (1<<1) /* The root complex PRI support */ 561 #define ACPI_IORT_PASID_FWD_SUPPORTED (1<<2) /* The root complex PASID forward support */ 562 563 /* Masks for pasid_capabilities field above */ 564 #define ACPI_IORT_PASID_MAX_WIDTH (0x1F) /* Bits 0-4 */ 565 566 struct acpi_iort_smmu { 567 u64 base_address; /* SMMU base address */ 568 u64 span; /* Length of memory range */ 569 u32 model; 570 u32 flags; 571 u32 global_interrupt_offset; 572 u32 context_interrupt_count; 573 u32 context_interrupt_offset; 574 u32 pmu_interrupt_count; 575 u32 pmu_interrupt_offset; 576 u64 interrupts[]; /* Interrupt array */ 577 }; 578 579 /* Values for Model field above */ 580 581 #define ACPI_IORT_SMMU_V1 0x00000000 /* Generic SMMUv1 */ 582 #define ACPI_IORT_SMMU_V2 0x00000001 /* Generic SMMUv2 */ 583 #define ACPI_IORT_SMMU_CORELINK_MMU400 0x00000002 /* ARM Corelink MMU-400 */ 584 #define ACPI_IORT_SMMU_CORELINK_MMU500 0x00000003 /* ARM Corelink MMU-500 */ 585 #define ACPI_IORT_SMMU_CORELINK_MMU401 0x00000004 /* ARM Corelink MMU-401 */ 586 #define ACPI_IORT_SMMU_CAVIUM_THUNDERX 0x00000005 /* Cavium thunder_x SMMUv2 */ 587 588 /* Masks for Flags field above */ 589 590 #define ACPI_IORT_SMMU_DVM_SUPPORTED (1) 591 #define ACPI_IORT_SMMU_COHERENT_WALK (1<<1) 592 593 /* Global interrupt format */ 594 595 struct acpi_iort_smmu_gsi { 596 u32 nsg_irpt; 597 u32 nsg_irpt_flags; 598 u32 nsg_cfg_irpt; 599 u32 nsg_cfg_irpt_flags; 600 }; 601 602 struct acpi_iort_smmu_v3 { 603 u64 base_address; /* SMMUv3 base address */ 604 u32 flags; 605 u32 reserved; 606 u64 vatos_address; 607 u32 model; 608 u32 event_gsiv; 609 u32 pri_gsiv; 610 u32 gerr_gsiv; 611 u32 sync_gsiv; 612 u32 pxm; 613 u32 id_mapping_index; 614 }; 615 616 /* Values for Model field above */ 617 618 #define ACPI_IORT_SMMU_V3_GENERIC 0x00000000 /* Generic SMMUv3 */ 619 #define ACPI_IORT_SMMU_V3_HISILICON_HI161X 0x00000001 /* hi_silicon Hi161x SMMUv3 */ 620 #define ACPI_IORT_SMMU_V3_CAVIUM_CN99XX 0x00000002 /* Cavium CN99xx SMMUv3 */ 621 622 /* Masks for Flags field above */ 623 624 #define ACPI_IORT_SMMU_V3_COHACC_OVERRIDE (1) 625 #define ACPI_IORT_SMMU_V3_HTTU_OVERRIDE (3<<1) 626 #define ACPI_IORT_SMMU_V3_PXM_VALID (1<<3) 627 #define ACPI_IORT_SMMU_V3_DEVICEID_VALID (1<<4) 628 629 struct acpi_iort_pmcg { 630 u64 page0_base_address; 631 u32 overflow_gsiv; 632 u32 node_reference; 633 u64 page1_base_address; 634 }; 635 636 struct acpi_iort_rmr { 637 u32 flags; 638 u32 rmr_count; 639 u32 rmr_offset; 640 }; 641 642 /* Masks for Flags field above */ 643 #define ACPI_IORT_RMR_REMAP_PERMITTED (1) 644 #define ACPI_IORT_RMR_ACCESS_PRIVILEGE (1<<1) 645 646 /* 647 * Macro to access the Access Attributes in flags field above: 648 * Access Attributes is encoded in bits 9:2 649 */ 650 #define ACPI_IORT_RMR_ACCESS_ATTRIBUTES(flags) (((flags) >> 2) & 0xFF) 651 652 /* Values for above Access Attributes */ 653 654 #define ACPI_IORT_RMR_ATTR_DEVICE_NGNRNE 0x00 655 #define ACPI_IORT_RMR_ATTR_DEVICE_NGNRE 0x01 656 #define ACPI_IORT_RMR_ATTR_DEVICE_NGRE 0x02 657 #define ACPI_IORT_RMR_ATTR_DEVICE_GRE 0x03 658 #define ACPI_IORT_RMR_ATTR_NORMAL_NC 0x04 659 #define ACPI_IORT_RMR_ATTR_NORMAL_IWB_OWB 0x05 660 661 struct acpi_iort_rmr_desc { 662 u64 base_address; 663 u64 length; 664 u32 reserved; 665 }; 666 667 /******************************************************************************* 668 * 669 * IVRS - I/O Virtualization Reporting Structure 670 * Version 1 671 * 672 * Conforms to "AMD I/O Virtualization Technology (IOMMU) Specification", 673 * Revision 1.26, February 2009. 674 * 675 ******************************************************************************/ 676 677 struct acpi_table_ivrs { 678 struct acpi_table_header header; /* Common ACPI table header */ 679 u32 info; /* Common virtualization info */ 680 u64 reserved; 681 }; 682 683 /* Values for Info field above */ 684 685 #define ACPI_IVRS_PHYSICAL_SIZE 0x00007F00 /* 7 bits, physical address size */ 686 #define ACPI_IVRS_VIRTUAL_SIZE 0x003F8000 /* 7 bits, virtual address size */ 687 #define ACPI_IVRS_ATS_RESERVED 0x00400000 /* ATS address translation range reserved */ 688 689 /* IVRS subtable header */ 690 691 struct acpi_ivrs_header { 692 u8 type; /* Subtable type */ 693 u8 flags; 694 u16 length; /* Subtable length */ 695 u16 device_id; /* ID of IOMMU */ 696 }; 697 698 /* Values for subtable Type above */ 699 700 enum acpi_ivrs_type { 701 ACPI_IVRS_TYPE_HARDWARE1 = 0x10, 702 ACPI_IVRS_TYPE_HARDWARE2 = 0x11, 703 ACPI_IVRS_TYPE_HARDWARE3 = 0x40, 704 ACPI_IVRS_TYPE_MEMORY1 = 0x20, 705 ACPI_IVRS_TYPE_MEMORY2 = 0x21, 706 ACPI_IVRS_TYPE_MEMORY3 = 0x22 707 }; 708 709 /* Masks for Flags field above for IVHD subtable */ 710 711 #define ACPI_IVHD_TT_ENABLE (1) 712 #define ACPI_IVHD_PASS_PW (1<<1) 713 #define ACPI_IVHD_RES_PASS_PW (1<<2) 714 #define ACPI_IVHD_ISOC (1<<3) 715 #define ACPI_IVHD_IOTLB (1<<4) 716 717 /* Masks for Flags field above for IVMD subtable */ 718 719 #define ACPI_IVMD_UNITY (1) 720 #define ACPI_IVMD_READ (1<<1) 721 #define ACPI_IVMD_WRITE (1<<2) 722 #define ACPI_IVMD_EXCLUSION_RANGE (1<<3) 723 724 /* 725 * IVRS subtables, correspond to Type in struct acpi_ivrs_header 726 */ 727 728 /* 0x10: I/O Virtualization Hardware Definition Block (IVHD) */ 729 730 struct acpi_ivrs_hardware_10 { 731 struct acpi_ivrs_header header; 732 u16 capability_offset; /* Offset for IOMMU control fields */ 733 u64 base_address; /* IOMMU control registers */ 734 u16 pci_segment_group; 735 u16 info; /* MSI number and unit ID */ 736 u32 feature_reporting; 737 }; 738 739 /* 0x11: I/O Virtualization Hardware Definition Block (IVHD) */ 740 741 struct acpi_ivrs_hardware_11 { 742 struct acpi_ivrs_header header; 743 u16 capability_offset; /* Offset for IOMMU control fields */ 744 u64 base_address; /* IOMMU control registers */ 745 u16 pci_segment_group; 746 u16 info; /* MSI number and unit ID */ 747 u32 attributes; 748 u64 efr_register_image; 749 u64 reserved; 750 }; 751 752 /* Masks for Info field above */ 753 754 #define ACPI_IVHD_MSI_NUMBER_MASK 0x001F /* 5 bits, MSI message number */ 755 #define ACPI_IVHD_UNIT_ID_MASK 0x1F00 /* 5 bits, unit_ID */ 756 757 /* 758 * Device Entries for IVHD subtable, appear after struct acpi_ivrs_hardware structure. 759 * Upper two bits of the Type field are the (encoded) length of the structure. 760 * Currently, only 4 and 8 byte entries are defined. 16 and 32 byte entries 761 * are reserved for future use but not defined. 762 */ 763 struct acpi_ivrs_de_header { 764 u8 type; 765 u16 id; 766 u8 data_setting; 767 }; 768 769 /* Length of device entry is in the top two bits of Type field above */ 770 771 #define ACPI_IVHD_ENTRY_LENGTH 0xC0 772 773 /* Values for device entry Type field above */ 774 775 enum acpi_ivrs_device_entry_type { 776 /* 4-byte device entries, all use struct acpi_ivrs_device4 */ 777 778 ACPI_IVRS_TYPE_PAD4 = 0, 779 ACPI_IVRS_TYPE_ALL = 1, 780 ACPI_IVRS_TYPE_SELECT = 2, 781 ACPI_IVRS_TYPE_START = 3, 782 ACPI_IVRS_TYPE_END = 4, 783 784 /* 8-byte device entries */ 785 786 ACPI_IVRS_TYPE_PAD8 = 64, 787 ACPI_IVRS_TYPE_NOT_USED = 65, 788 ACPI_IVRS_TYPE_ALIAS_SELECT = 66, /* Uses struct acpi_ivrs_device8a */ 789 ACPI_IVRS_TYPE_ALIAS_START = 67, /* Uses struct acpi_ivrs_device8a */ 790 ACPI_IVRS_TYPE_EXT_SELECT = 70, /* Uses struct acpi_ivrs_device8b */ 791 ACPI_IVRS_TYPE_EXT_START = 71, /* Uses struct acpi_ivrs_device8b */ 792 ACPI_IVRS_TYPE_SPECIAL = 72, /* Uses struct acpi_ivrs_device8c */ 793 794 /* Variable-length device entries */ 795 796 ACPI_IVRS_TYPE_HID = 240 /* Uses ACPI_IVRS_DEVICE_HID */ 797 }; 798 799 /* Values for Data field above */ 800 801 #define ACPI_IVHD_INIT_PASS (1) 802 #define ACPI_IVHD_EINT_PASS (1<<1) 803 #define ACPI_IVHD_NMI_PASS (1<<2) 804 #define ACPI_IVHD_SYSTEM_MGMT (3<<4) 805 #define ACPI_IVHD_LINT0_PASS (1<<6) 806 #define ACPI_IVHD_LINT1_PASS (1<<7) 807 808 /* Types 0-4: 4-byte device entry */ 809 810 struct acpi_ivrs_device4 { 811 struct acpi_ivrs_de_header header; 812 }; 813 814 /* Types 66-67: 8-byte device entry */ 815 816 struct acpi_ivrs_device8a { 817 struct acpi_ivrs_de_header header; 818 u8 reserved1; 819 u16 used_id; 820 u8 reserved2; 821 }; 822 823 /* Types 70-71: 8-byte device entry */ 824 825 struct acpi_ivrs_device8b { 826 struct acpi_ivrs_de_header header; 827 u32 extended_data; 828 }; 829 830 /* Values for extended_data above */ 831 832 #define ACPI_IVHD_ATS_DISABLED (1<<31) 833 834 /* Type 72: 8-byte device entry */ 835 836 struct acpi_ivrs_device8c { 837 struct acpi_ivrs_de_header header; 838 u8 handle; 839 u16 used_id; 840 u8 variety; 841 }; 842 843 /* Values for Variety field above */ 844 845 #define ACPI_IVHD_IOAPIC 1 846 #define ACPI_IVHD_HPET 2 847 848 /* Type 240: variable-length device entry */ 849 850 struct acpi_ivrs_device_hid { 851 struct acpi_ivrs_de_header header; 852 u64 acpi_hid; 853 u64 acpi_cid; 854 u8 uid_type; 855 u8 uid_length; 856 }; 857 858 /* Values for uid_type above */ 859 860 #define ACPI_IVRS_UID_NOT_PRESENT 0 861 #define ACPI_IVRS_UID_IS_INTEGER 1 862 #define ACPI_IVRS_UID_IS_STRING 2 863 864 /* 0x20, 0x21, 0x22: I/O Virtualization Memory Definition Block (IVMD) */ 865 866 struct acpi_ivrs_memory { 867 struct acpi_ivrs_header header; 868 u16 aux_data; 869 u64 reserved; 870 u64 start_address; 871 u64 memory_length; 872 }; 873 874 /******************************************************************************* 875 * 876 * LPIT - Low Power Idle Table 877 * 878 * Conforms to "ACPI Low Power Idle Table (LPIT)" July 2014. 879 * 880 ******************************************************************************/ 881 882 struct acpi_table_lpit { 883 struct acpi_table_header header; /* Common ACPI table header */ 884 }; 885 886 /* LPIT subtable header */ 887 888 struct acpi_lpit_header { 889 u32 type; /* Subtable type */ 890 u32 length; /* Subtable length */ 891 u16 unique_id; 892 u16 reserved; 893 u32 flags; 894 }; 895 896 /* Values for subtable Type above */ 897 898 enum acpi_lpit_type { 899 ACPI_LPIT_TYPE_NATIVE_CSTATE = 0x00, 900 ACPI_LPIT_TYPE_RESERVED = 0x01 /* 1 and above are reserved */ 901 }; 902 903 /* Masks for Flags field above */ 904 905 #define ACPI_LPIT_STATE_DISABLED (1) 906 #define ACPI_LPIT_NO_COUNTER (1<<1) 907 908 /* 909 * LPIT subtables, correspond to Type in struct acpi_lpit_header 910 */ 911 912 /* 0x00: Native C-state instruction based LPI structure */ 913 914 struct acpi_lpit_native { 915 struct acpi_lpit_header header; 916 struct acpi_generic_address entry_trigger; 917 u32 residency; 918 u32 latency; 919 struct acpi_generic_address residency_counter; 920 u64 counter_frequency; 921 }; 922 923 /******************************************************************************* 924 * 925 * MADT - Multiple APIC Description Table 926 * Version 3 927 * 928 ******************************************************************************/ 929 930 struct acpi_table_madt { 931 struct acpi_table_header header; /* Common ACPI table header */ 932 u32 address; /* Physical address of local APIC */ 933 u32 flags; 934 }; 935 936 /* Masks for Flags field above */ 937 938 #define ACPI_MADT_PCAT_COMPAT (1) /* 00: System also has dual 8259s */ 939 940 /* Values for PCATCompat flag */ 941 942 #define ACPI_MADT_DUAL_PIC 1 943 #define ACPI_MADT_MULTIPLE_APIC 0 944 945 /* Values for MADT subtable type in struct acpi_subtable_header */ 946 947 enum acpi_madt_type { 948 ACPI_MADT_TYPE_LOCAL_APIC = 0, 949 ACPI_MADT_TYPE_IO_APIC = 1, 950 ACPI_MADT_TYPE_INTERRUPT_OVERRIDE = 2, 951 ACPI_MADT_TYPE_NMI_SOURCE = 3, 952 ACPI_MADT_TYPE_LOCAL_APIC_NMI = 4, 953 ACPI_MADT_TYPE_LOCAL_APIC_OVERRIDE = 5, 954 ACPI_MADT_TYPE_IO_SAPIC = 6, 955 ACPI_MADT_TYPE_LOCAL_SAPIC = 7, 956 ACPI_MADT_TYPE_INTERRUPT_SOURCE = 8, 957 ACPI_MADT_TYPE_LOCAL_X2APIC = 9, 958 ACPI_MADT_TYPE_LOCAL_X2APIC_NMI = 10, 959 ACPI_MADT_TYPE_GENERIC_INTERRUPT = 11, 960 ACPI_MADT_TYPE_GENERIC_DISTRIBUTOR = 12, 961 ACPI_MADT_TYPE_GENERIC_MSI_FRAME = 13, 962 ACPI_MADT_TYPE_GENERIC_REDISTRIBUTOR = 14, 963 ACPI_MADT_TYPE_GENERIC_TRANSLATOR = 15, 964 ACPI_MADT_TYPE_MULTIPROC_WAKEUP = 16, 965 ACPI_MADT_TYPE_CORE_PIC = 17, 966 ACPI_MADT_TYPE_LIO_PIC = 18, 967 ACPI_MADT_TYPE_HT_PIC = 19, 968 ACPI_MADT_TYPE_EIO_PIC = 20, 969 ACPI_MADT_TYPE_MSI_PIC = 21, 970 ACPI_MADT_TYPE_BIO_PIC = 22, 971 ACPI_MADT_TYPE_LPC_PIC = 23, 972 ACPI_MADT_TYPE_RINTC = 24, 973 ACPI_MADT_TYPE_IMSIC = 25, 974 ACPI_MADT_TYPE_APLIC = 26, 975 ACPI_MADT_TYPE_PLIC = 27, 976 ACPI_MADT_TYPE_RESERVED = 28, /* 28 to 0x7F are reserved */ 977 ACPI_MADT_TYPE_OEM_RESERVED = 0x80 /* 0x80 to 0xFF are reserved for OEM use */ 978 }; 979 980 /* 981 * MADT Subtables, correspond to Type in struct acpi_subtable_header 982 */ 983 984 /* 0: Processor Local APIC */ 985 986 struct acpi_madt_local_apic { 987 struct acpi_subtable_header header; 988 u8 processor_id; /* ACPI processor id */ 989 u8 id; /* Processor's local APIC id */ 990 u32 lapic_flags; 991 }; 992 993 /* 1: IO APIC */ 994 995 struct acpi_madt_io_apic { 996 struct acpi_subtable_header header; 997 u8 id; /* I/O APIC ID */ 998 u8 reserved; /* reserved - must be zero */ 999 u32 address; /* APIC physical address */ 1000 u32 global_irq_base; /* Global system interrupt where INTI lines start */ 1001 }; 1002 1003 /* 2: Interrupt Override */ 1004 1005 struct acpi_madt_interrupt_override { 1006 struct acpi_subtable_header header; 1007 u8 bus; /* 0 - ISA */ 1008 u8 source_irq; /* Interrupt source (IRQ) */ 1009 u32 global_irq; /* Global system interrupt */ 1010 u16 inti_flags; 1011 }; 1012 1013 /* 3: NMI Source */ 1014 1015 struct acpi_madt_nmi_source { 1016 struct acpi_subtable_header header; 1017 u16 inti_flags; 1018 u32 global_irq; /* Global system interrupt */ 1019 }; 1020 1021 /* 4: Local APIC NMI */ 1022 1023 struct acpi_madt_local_apic_nmi { 1024 struct acpi_subtable_header header; 1025 u8 processor_id; /* ACPI processor id */ 1026 u16 inti_flags; 1027 u8 lint; /* LINTn to which NMI is connected */ 1028 }; 1029 1030 /* 5: Address Override */ 1031 1032 struct acpi_madt_local_apic_override { 1033 struct acpi_subtable_header header; 1034 u16 reserved; /* Reserved, must be zero */ 1035 u64 address; /* APIC physical address */ 1036 }; 1037 1038 /* 6: I/O Sapic */ 1039 1040 struct acpi_madt_io_sapic { 1041 struct acpi_subtable_header header; 1042 u8 id; /* I/O SAPIC ID */ 1043 u8 reserved; /* Reserved, must be zero */ 1044 u32 global_irq_base; /* Global interrupt for SAPIC start */ 1045 u64 address; /* SAPIC physical address */ 1046 }; 1047 1048 /* 7: Local Sapic */ 1049 1050 struct acpi_madt_local_sapic { 1051 struct acpi_subtable_header header; 1052 u8 processor_id; /* ACPI processor id */ 1053 u8 id; /* SAPIC ID */ 1054 u8 eid; /* SAPIC EID */ 1055 u8 reserved[3]; /* Reserved, must be zero */ 1056 u32 lapic_flags; 1057 u32 uid; /* Numeric UID - ACPI 3.0 */ 1058 char uid_string[]; /* String UID - ACPI 3.0 */ 1059 }; 1060 1061 /* 8: Platform Interrupt Source */ 1062 1063 struct acpi_madt_interrupt_source { 1064 struct acpi_subtable_header header; 1065 u16 inti_flags; 1066 u8 type; /* 1=PMI, 2=INIT, 3=corrected */ 1067 u8 id; /* Processor ID */ 1068 u8 eid; /* Processor EID */ 1069 u8 io_sapic_vector; /* Vector value for PMI interrupts */ 1070 u32 global_irq; /* Global system interrupt */ 1071 u32 flags; /* Interrupt Source Flags */ 1072 }; 1073 1074 /* Masks for Flags field above */ 1075 1076 #define ACPI_MADT_CPEI_OVERRIDE (1) 1077 1078 /* 9: Processor Local X2APIC (ACPI 4.0) */ 1079 1080 struct acpi_madt_local_x2apic { 1081 struct acpi_subtable_header header; 1082 u16 reserved; /* reserved - must be zero */ 1083 u32 local_apic_id; /* Processor x2APIC ID */ 1084 u32 lapic_flags; 1085 u32 uid; /* ACPI processor UID */ 1086 }; 1087 1088 /* 10: Local X2APIC NMI (ACPI 4.0) */ 1089 1090 struct acpi_madt_local_x2apic_nmi { 1091 struct acpi_subtable_header header; 1092 u16 inti_flags; 1093 u32 uid; /* ACPI processor UID */ 1094 u8 lint; /* LINTn to which NMI is connected */ 1095 u8 reserved[3]; /* reserved - must be zero */ 1096 }; 1097 1098 /* 11: Generic interrupt - GICC (ACPI 5.0 + ACPI 6.0 + ACPI 6.3 + ACPI 6.5 changes) */ 1099 1100 struct acpi_madt_generic_interrupt { 1101 struct acpi_subtable_header header; 1102 u16 reserved; /* reserved - must be zero */ 1103 u32 cpu_interface_number; 1104 u32 uid; 1105 u32 flags; 1106 u32 parking_version; 1107 u32 performance_interrupt; 1108 u64 parked_address; 1109 u64 base_address; 1110 u64 gicv_base_address; 1111 u64 gich_base_address; 1112 u32 vgic_interrupt; 1113 u64 gicr_base_address; 1114 u64 arm_mpidr; 1115 u8 efficiency_class; 1116 u8 reserved2[1]; 1117 u16 spe_interrupt; /* ACPI 6.3 */ 1118 u16 trbe_interrupt; /* ACPI 6.5 */ 1119 }; 1120 1121 /* Masks for Flags field above */ 1122 1123 /* ACPI_MADT_ENABLED (1) Processor is usable if set */ 1124 #define ACPI_MADT_PERFORMANCE_IRQ_MODE (1<<1) /* 01: Performance Interrupt Mode */ 1125 #define ACPI_MADT_VGIC_IRQ_MODE (1<<2) /* 02: VGIC Maintenance Interrupt mode */ 1126 #define ACPI_MADT_GICC_ONLINE_CAPABLE (1<<3) /* 03: Processor is online capable */ 1127 #define ACPI_MADT_GICC_NON_COHERENT (1<<4) /* 04: GIC redistributor is not coherent */ 1128 1129 /* 12: Generic Distributor (ACPI 5.0 + ACPI 6.0 changes) */ 1130 1131 struct acpi_madt_generic_distributor { 1132 struct acpi_subtable_header header; 1133 u16 reserved; /* reserved - must be zero */ 1134 u32 gic_id; 1135 u64 base_address; 1136 u32 global_irq_base; 1137 u8 version; 1138 u8 reserved2[3]; /* reserved - must be zero */ 1139 }; 1140 1141 /* Values for Version field above */ 1142 1143 enum acpi_madt_gic_version { 1144 ACPI_MADT_GIC_VERSION_NONE = 0, 1145 ACPI_MADT_GIC_VERSION_V1 = 1, 1146 ACPI_MADT_GIC_VERSION_V2 = 2, 1147 ACPI_MADT_GIC_VERSION_V3 = 3, 1148 ACPI_MADT_GIC_VERSION_V4 = 4, 1149 ACPI_MADT_GIC_VERSION_RESERVED = 5 /* 5 and greater are reserved */ 1150 }; 1151 1152 /* 13: Generic MSI Frame (ACPI 5.1) */ 1153 1154 struct acpi_madt_generic_msi_frame { 1155 struct acpi_subtable_header header; 1156 u16 reserved; /* reserved - must be zero */ 1157 u32 msi_frame_id; 1158 u64 base_address; 1159 u32 flags; 1160 u16 spi_count; 1161 u16 spi_base; 1162 }; 1163 1164 /* Masks for Flags field above */ 1165 1166 #define ACPI_MADT_OVERRIDE_SPI_VALUES (1) 1167 1168 /* 14: Generic Redistributor (ACPI 5.1) */ 1169 1170 struct acpi_madt_generic_redistributor { 1171 struct acpi_subtable_header header; 1172 u8 flags; 1173 u8 reserved; /* reserved - must be zero */ 1174 u64 base_address; 1175 u32 length; 1176 }; 1177 1178 #define ACPI_MADT_GICR_NON_COHERENT (1) 1179 1180 /* 15: Generic Translator (ACPI 6.0) */ 1181 1182 struct acpi_madt_generic_translator { 1183 struct acpi_subtable_header header; 1184 u8 flags; 1185 u8 reserved; /* reserved - must be zero */ 1186 u32 translation_id; 1187 u64 base_address; 1188 u32 reserved2; 1189 }; 1190 1191 #define ACPI_MADT_ITS_NON_COHERENT (1) 1192 1193 /* 16: Multiprocessor wakeup (ACPI 6.4) */ 1194 1195 struct acpi_madt_multiproc_wakeup { 1196 struct acpi_subtable_header header; 1197 u16 mailbox_version; 1198 u32 reserved; /* reserved - must be zero */ 1199 u64 base_address; 1200 }; 1201 1202 #define ACPI_MULTIPROC_WAKEUP_MB_OS_SIZE 2032 1203 #define ACPI_MULTIPROC_WAKEUP_MB_FIRMWARE_SIZE 2048 1204 1205 struct acpi_madt_multiproc_wakeup_mailbox { 1206 u16 command; 1207 u16 reserved; /* reserved - must be zero */ 1208 u32 apic_id; 1209 u64 wakeup_vector; 1210 u8 reserved_os[ACPI_MULTIPROC_WAKEUP_MB_OS_SIZE]; /* reserved for OS use */ 1211 u8 reserved_firmware[ACPI_MULTIPROC_WAKEUP_MB_FIRMWARE_SIZE]; /* reserved for firmware use */ 1212 }; 1213 1214 #define ACPI_MP_WAKE_COMMAND_WAKEUP 1 1215 1216 /* 17: CPU Core Interrupt Controller (ACPI 6.5) */ 1217 1218 struct acpi_madt_core_pic { 1219 struct acpi_subtable_header header; 1220 u8 version; 1221 u32 processor_id; 1222 u32 core_id; 1223 u32 flags; 1224 }; 1225 1226 /* Values for Version field above */ 1227 1228 enum acpi_madt_core_pic_version { 1229 ACPI_MADT_CORE_PIC_VERSION_NONE = 0, 1230 ACPI_MADT_CORE_PIC_VERSION_V1 = 1, 1231 ACPI_MADT_CORE_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1232 }; 1233 1234 /* 18: Legacy I/O Interrupt Controller (ACPI 6.5) */ 1235 1236 struct acpi_madt_lio_pic { 1237 struct acpi_subtable_header header; 1238 u8 version; 1239 u64 address; 1240 u16 size; 1241 u8 cascade[2]; 1242 u32 cascade_map[2]; 1243 }; 1244 1245 /* Values for Version field above */ 1246 1247 enum acpi_madt_lio_pic_version { 1248 ACPI_MADT_LIO_PIC_VERSION_NONE = 0, 1249 ACPI_MADT_LIO_PIC_VERSION_V1 = 1, 1250 ACPI_MADT_LIO_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1251 }; 1252 1253 /* 19: HT Interrupt Controller (ACPI 6.5) */ 1254 1255 struct acpi_madt_ht_pic { 1256 struct acpi_subtable_header header; 1257 u8 version; 1258 u64 address; 1259 u16 size; 1260 u8 cascade[8]; 1261 }; 1262 1263 /* Values for Version field above */ 1264 1265 enum acpi_madt_ht_pic_version { 1266 ACPI_MADT_HT_PIC_VERSION_NONE = 0, 1267 ACPI_MADT_HT_PIC_VERSION_V1 = 1, 1268 ACPI_MADT_HT_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1269 }; 1270 1271 /* 20: Extend I/O Interrupt Controller (ACPI 6.5) */ 1272 1273 struct acpi_madt_eio_pic { 1274 struct acpi_subtable_header header; 1275 u8 version; 1276 u8 cascade; 1277 u8 node; 1278 u64 node_map; 1279 }; 1280 1281 /* Values for Version field above */ 1282 1283 enum acpi_madt_eio_pic_version { 1284 ACPI_MADT_EIO_PIC_VERSION_NONE = 0, 1285 ACPI_MADT_EIO_PIC_VERSION_V1 = 1, 1286 ACPI_MADT_EIO_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1287 }; 1288 1289 /* 21: MSI Interrupt Controller (ACPI 6.5) */ 1290 1291 struct acpi_madt_msi_pic { 1292 struct acpi_subtable_header header; 1293 u8 version; 1294 u64 msg_address; 1295 u32 start; 1296 u32 count; 1297 }; 1298 1299 /* Values for Version field above */ 1300 1301 enum acpi_madt_msi_pic_version { 1302 ACPI_MADT_MSI_PIC_VERSION_NONE = 0, 1303 ACPI_MADT_MSI_PIC_VERSION_V1 = 1, 1304 ACPI_MADT_MSI_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1305 }; 1306 1307 /* 22: Bridge I/O Interrupt Controller (ACPI 6.5) */ 1308 1309 struct acpi_madt_bio_pic { 1310 struct acpi_subtable_header header; 1311 u8 version; 1312 u64 address; 1313 u16 size; 1314 u16 id; 1315 u16 gsi_base; 1316 }; 1317 1318 /* Values for Version field above */ 1319 1320 enum acpi_madt_bio_pic_version { 1321 ACPI_MADT_BIO_PIC_VERSION_NONE = 0, 1322 ACPI_MADT_BIO_PIC_VERSION_V1 = 1, 1323 ACPI_MADT_BIO_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1324 }; 1325 1326 /* 23: LPC Interrupt Controller (ACPI 6.5) */ 1327 1328 struct acpi_madt_lpc_pic { 1329 struct acpi_subtable_header header; 1330 u8 version; 1331 u64 address; 1332 u16 size; 1333 u8 cascade; 1334 }; 1335 1336 /* Values for Version field above */ 1337 1338 enum acpi_madt_lpc_pic_version { 1339 ACPI_MADT_LPC_PIC_VERSION_NONE = 0, 1340 ACPI_MADT_LPC_PIC_VERSION_V1 = 1, 1341 ACPI_MADT_LPC_PIC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1342 }; 1343 1344 /* 24: RISC-V INTC */ 1345 struct acpi_madt_rintc { 1346 struct acpi_subtable_header header; 1347 u8 version; 1348 u8 reserved; 1349 u32 flags; 1350 u64 hart_id; 1351 u32 uid; /* ACPI processor UID */ 1352 u32 ext_intc_id; /* External INTC Id */ 1353 u64 imsic_addr; /* IMSIC base address */ 1354 u32 imsic_size; /* IMSIC size */ 1355 }; 1356 1357 /* Values for RISC-V INTC Version field above */ 1358 1359 enum acpi_madt_rintc_version { 1360 ACPI_MADT_RINTC_VERSION_NONE = 0, 1361 ACPI_MADT_RINTC_VERSION_V1 = 1, 1362 ACPI_MADT_RINTC_VERSION_RESERVED = 2 /* 2 and greater are reserved */ 1363 }; 1364 1365 /* 25: RISC-V IMSIC */ 1366 struct acpi_madt_imsic { 1367 struct acpi_subtable_header header; 1368 u8 version; 1369 u8 reserved; 1370 u32 flags; 1371 u16 num_ids; 1372 u16 num_guest_ids; 1373 u8 guest_index_bits; 1374 u8 hart_index_bits; 1375 u8 group_index_bits; 1376 u8 group_index_shift; 1377 }; 1378 1379 /* 26: RISC-V APLIC */ 1380 struct acpi_madt_aplic { 1381 struct acpi_subtable_header header; 1382 u8 version; 1383 u8 id; 1384 u32 flags; 1385 u8 hw_id[8]; 1386 u16 num_idcs; 1387 u16 num_sources; 1388 u32 gsi_base; 1389 u64 base_addr; 1390 u32 size; 1391 }; 1392 1393 /* 27: RISC-V PLIC */ 1394 struct acpi_madt_plic { 1395 struct acpi_subtable_header header; 1396 u8 version; 1397 u8 id; 1398 u8 hw_id[8]; 1399 u16 num_irqs; 1400 u16 max_prio; 1401 u32 flags; 1402 u32 size; 1403 u64 base_addr; 1404 u32 gsi_base; 1405 }; 1406 1407 /* 80: OEM data */ 1408 1409 struct acpi_madt_oem_data { 1410 ACPI_FLEX_ARRAY(u8, oem_data); 1411 }; 1412 1413 /* 1414 * Common flags fields for MADT subtables 1415 */ 1416 1417 /* MADT Local APIC flags */ 1418 1419 #define ACPI_MADT_ENABLED (1) /* 00: Processor is usable if set */ 1420 #define ACPI_MADT_ONLINE_CAPABLE (2) /* 01: System HW supports enabling processor at runtime */ 1421 1422 /* MADT MPS INTI flags (inti_flags) */ 1423 1424 #define ACPI_MADT_POLARITY_MASK (3) /* 00-01: Polarity of APIC I/O input signals */ 1425 #define ACPI_MADT_TRIGGER_MASK (3<<2) /* 02-03: Trigger mode of APIC input signals */ 1426 1427 /* Values for MPS INTI flags */ 1428 1429 #define ACPI_MADT_POLARITY_CONFORMS 0 1430 #define ACPI_MADT_POLARITY_ACTIVE_HIGH 1 1431 #define ACPI_MADT_POLARITY_RESERVED 2 1432 #define ACPI_MADT_POLARITY_ACTIVE_LOW 3 1433 1434 #define ACPI_MADT_TRIGGER_CONFORMS (0) 1435 #define ACPI_MADT_TRIGGER_EDGE (1<<2) 1436 #define ACPI_MADT_TRIGGER_RESERVED (2<<2) 1437 #define ACPI_MADT_TRIGGER_LEVEL (3<<2) 1438 1439 /******************************************************************************* 1440 * 1441 * MCFG - PCI Memory Mapped Configuration table and subtable 1442 * Version 1 1443 * 1444 * Conforms to "PCI Firmware Specification", Revision 3.0, June 20, 2005 1445 * 1446 ******************************************************************************/ 1447 1448 struct acpi_table_mcfg { 1449 struct acpi_table_header header; /* Common ACPI table header */ 1450 u8 reserved[8]; 1451 }; 1452 1453 /* Subtable */ 1454 1455 struct acpi_mcfg_allocation { 1456 u64 address; /* Base address, processor-relative */ 1457 u16 pci_segment; /* PCI segment group number */ 1458 u8 start_bus_number; /* Starting PCI Bus number */ 1459 u8 end_bus_number; /* Final PCI Bus number */ 1460 u32 reserved; 1461 }; 1462 1463 /******************************************************************************* 1464 * 1465 * MCHI - Management Controller Host Interface Table 1466 * Version 1 1467 * 1468 * Conforms to "Management Component Transport Protocol (MCTP) Host 1469 * Interface Specification", Revision 1.0.0a, October 13, 2009 1470 * 1471 ******************************************************************************/ 1472 1473 struct acpi_table_mchi { 1474 struct acpi_table_header header; /* Common ACPI table header */ 1475 u8 interface_type; 1476 u8 protocol; 1477 u64 protocol_data; 1478 u8 interrupt_type; 1479 u8 gpe; 1480 u8 pci_device_flag; 1481 u32 global_interrupt; 1482 struct acpi_generic_address control_register; 1483 u8 pci_segment; 1484 u8 pci_bus; 1485 u8 pci_device; 1486 u8 pci_function; 1487 }; 1488 1489 /******************************************************************************* 1490 * 1491 * MPAM - Memory System Resource Partitioning and Monitoring 1492 * 1493 * Conforms to "ACPI for Memory System Resource Partitioning and Monitoring 2.0" 1494 * Document number: ARM DEN 0065, December, 2022. 1495 * 1496 ******************************************************************************/ 1497 1498 /* MPAM RIS locator types. Table 11, Location types */ 1499 enum acpi_mpam_locator_type { 1500 ACPI_MPAM_LOCATION_TYPE_PROCESSOR_CACHE = 0, 1501 ACPI_MPAM_LOCATION_TYPE_MEMORY = 1, 1502 ACPI_MPAM_LOCATION_TYPE_SMMU = 2, 1503 ACPI_MPAM_LOCATION_TYPE_MEMORY_CACHE = 3, 1504 ACPI_MPAM_LOCATION_TYPE_ACPI_DEVICE = 4, 1505 ACPI_MPAM_LOCATION_TYPE_INTERCONNECT = 5, 1506 ACPI_MPAM_LOCATION_TYPE_UNKNOWN = 0xFF 1507 }; 1508 1509 /* MPAM Functional dependency descriptor. Table 10 */ 1510 struct acpi_mpam_func_deps { 1511 u32 producer; 1512 u32 reserved; 1513 }; 1514 1515 /* MPAM Processor cache locator descriptor. Table 13 */ 1516 struct acpi_mpam_resource_cache_locator { 1517 u64 cache_reference; 1518 u32 reserved; 1519 }; 1520 1521 /* MPAM Memory locator descriptor. Table 14 */ 1522 struct acpi_mpam_resource_memory_locator { 1523 u64 proximity_domain; 1524 u32 reserved; 1525 }; 1526 1527 /* MPAM SMMU locator descriptor. Table 15 */ 1528 struct acpi_mpam_resource_smmu_locator { 1529 u64 smmu_interface; 1530 u32 reserved; 1531 }; 1532 1533 /* MPAM Memory-side cache locator descriptor. Table 16 */ 1534 struct acpi_mpam_resource_memcache_locator { 1535 u8 reserved[7]; 1536 u8 level; 1537 u32 reference; 1538 }; 1539 1540 /* MPAM ACPI device locator descriptor. Table 17 */ 1541 struct acpi_mpam_resource_acpi_locator { 1542 u64 acpi_hw_id; 1543 u32 acpi_unique_id; 1544 }; 1545 1546 /* MPAM Interconnect locator descriptor. Table 18 */ 1547 struct acpi_mpam_resource_interconnect_locator { 1548 u64 inter_connect_desc_tbl_off; 1549 u32 reserved; 1550 }; 1551 1552 /* MPAM Locator structure. Table 12 */ 1553 struct acpi_mpam_resource_generic_locator { 1554 u64 descriptor1; 1555 u32 descriptor2; 1556 }; 1557 1558 union acpi_mpam_resource_locator { 1559 struct acpi_mpam_resource_cache_locator cache_locator; 1560 struct acpi_mpam_resource_memory_locator memory_locator; 1561 struct acpi_mpam_resource_smmu_locator smmu_locator; 1562 struct acpi_mpam_resource_memcache_locator mem_cache_locator; 1563 struct acpi_mpam_resource_acpi_locator acpi_locator; 1564 struct acpi_mpam_resource_interconnect_locator interconnect_ifc_locator; 1565 struct acpi_mpam_resource_generic_locator generic_locator; 1566 }; 1567 1568 /* Memory System Component Resource Node Structure Table 9 */ 1569 struct acpi_mpam_resource_node { 1570 u32 identifier; 1571 u8 ris_index; 1572 u16 reserved1; 1573 u8 locator_type; 1574 union acpi_mpam_resource_locator locator; 1575 u32 num_functional_deps; 1576 }; 1577 1578 /* Memory System Component (MSC) Node Structure. Table 4 */ 1579 struct acpi_mpam_msc_node { 1580 u16 length; 1581 u8 interface_type; 1582 u8 reserved; 1583 u32 identifier; 1584 u64 base_address; 1585 u32 mmio_size; 1586 u32 overflow_interrupt; 1587 u32 overflow_interrupt_flags; 1588 u32 reserved1; 1589 u32 overflow_interrupt_affinity; 1590 u32 error_interrupt; 1591 u32 error_interrupt_flags; 1592 u32 reserved2; 1593 u32 error_interrupt_affinity; 1594 u32 max_nrdy_usec; 1595 u64 hardware_id_linked_device; 1596 u32 instance_id_linked_device; 1597 u32 num_resouce_nodes; 1598 }; 1599 1600 struct acpi_table_mpam { 1601 struct acpi_table_header header; /* Common ACPI table header */ 1602 }; 1603 1604 /******************************************************************************* 1605 * 1606 * MPST - Memory Power State Table (ACPI 5.0) 1607 * Version 1 1608 * 1609 ******************************************************************************/ 1610 1611 #define ACPI_MPST_CHANNEL_INFO \ 1612 u8 channel_id; \ 1613 u8 reserved1[3]; \ 1614 u16 power_node_count; \ 1615 u16 reserved2; 1616 1617 /* Main table */ 1618 1619 struct acpi_table_mpst { 1620 struct acpi_table_header header; /* Common ACPI table header */ 1621 ACPI_MPST_CHANNEL_INFO /* Platform Communication Channel */ 1622 }; 1623 1624 /* Memory Platform Communication Channel Info */ 1625 1626 struct acpi_mpst_channel { 1627 ACPI_MPST_CHANNEL_INFO /* Platform Communication Channel */ 1628 }; 1629 1630 /* Memory Power Node Structure */ 1631 1632 struct acpi_mpst_power_node { 1633 u8 flags; 1634 u8 reserved1; 1635 u16 node_id; 1636 u32 length; 1637 u64 range_address; 1638 u64 range_length; 1639 u32 num_power_states; 1640 u32 num_physical_components; 1641 }; 1642 1643 /* Values for Flags field above */ 1644 1645 #define ACPI_MPST_ENABLED 1 1646 #define ACPI_MPST_POWER_MANAGED 2 1647 #define ACPI_MPST_HOT_PLUG_CAPABLE 4 1648 1649 /* Memory Power State Structure (follows POWER_NODE above) */ 1650 1651 struct acpi_mpst_power_state { 1652 u8 power_state; 1653 u8 info_index; 1654 }; 1655 1656 /* Physical Component ID Structure (follows POWER_STATE above) */ 1657 1658 struct acpi_mpst_component { 1659 u16 component_id; 1660 }; 1661 1662 /* Memory Power State Characteristics Structure (follows all POWER_NODEs) */ 1663 1664 struct acpi_mpst_data_hdr { 1665 u16 characteristics_count; 1666 u16 reserved; 1667 }; 1668 1669 struct acpi_mpst_power_data { 1670 u8 structure_id; 1671 u8 flags; 1672 u16 reserved1; 1673 u32 average_power; 1674 u32 power_saving; 1675 u64 exit_latency; 1676 u64 reserved2; 1677 }; 1678 1679 /* Values for Flags field above */ 1680 1681 #define ACPI_MPST_PRESERVE 1 1682 #define ACPI_MPST_AUTOENTRY 2 1683 #define ACPI_MPST_AUTOEXIT 4 1684 1685 /* Shared Memory Region (not part of an ACPI table) */ 1686 1687 struct acpi_mpst_shared { 1688 u32 signature; 1689 u16 pcc_command; 1690 u16 pcc_status; 1691 u32 command_register; 1692 u32 status_register; 1693 u32 power_state_id; 1694 u32 power_node_id; 1695 u64 energy_consumed; 1696 u64 average_power; 1697 }; 1698 1699 /******************************************************************************* 1700 * 1701 * MSCT - Maximum System Characteristics Table (ACPI 4.0) 1702 * Version 1 1703 * 1704 ******************************************************************************/ 1705 1706 struct acpi_table_msct { 1707 struct acpi_table_header header; /* Common ACPI table header */ 1708 u32 proximity_offset; /* Location of proximity info struct(s) */ 1709 u32 max_proximity_domains; /* Max number of proximity domains */ 1710 u32 max_clock_domains; /* Max number of clock domains */ 1711 u64 max_address; /* Max physical address in system */ 1712 }; 1713 1714 /* subtable - Maximum Proximity Domain Information. Version 1 */ 1715 1716 struct acpi_msct_proximity { 1717 u8 revision; 1718 u8 length; 1719 u32 range_start; /* Start of domain range */ 1720 u32 range_end; /* End of domain range */ 1721 u32 processor_capacity; 1722 u64 memory_capacity; /* In bytes */ 1723 }; 1724 1725 /******************************************************************************* 1726 * 1727 * MSDM - Microsoft Data Management table 1728 * 1729 * Conforms to "Microsoft Software Licensing Tables (SLIC and MSDM)", 1730 * November 29, 2011. Copyright 2011 Microsoft 1731 * 1732 ******************************************************************************/ 1733 1734 /* Basic MSDM table is only the common ACPI header */ 1735 1736 struct acpi_table_msdm { 1737 struct acpi_table_header header; /* Common ACPI table header */ 1738 }; 1739 1740 /******************************************************************************* 1741 * 1742 * NFIT - NVDIMM Interface Table (ACPI 6.0+) 1743 * Version 1 1744 * 1745 ******************************************************************************/ 1746 1747 struct acpi_table_nfit { 1748 struct acpi_table_header header; /* Common ACPI table header */ 1749 u32 reserved; /* Reserved, must be zero */ 1750 }; 1751 1752 /* Subtable header for NFIT */ 1753 1754 struct acpi_nfit_header { 1755 u16 type; 1756 u16 length; 1757 }; 1758 1759 /* Values for subtable type in struct acpi_nfit_header */ 1760 1761 enum acpi_nfit_type { 1762 ACPI_NFIT_TYPE_SYSTEM_ADDRESS = 0, 1763 ACPI_NFIT_TYPE_MEMORY_MAP = 1, 1764 ACPI_NFIT_TYPE_INTERLEAVE = 2, 1765 ACPI_NFIT_TYPE_SMBIOS = 3, 1766 ACPI_NFIT_TYPE_CONTROL_REGION = 4, 1767 ACPI_NFIT_TYPE_DATA_REGION = 5, 1768 ACPI_NFIT_TYPE_FLUSH_ADDRESS = 6, 1769 ACPI_NFIT_TYPE_CAPABILITIES = 7, 1770 ACPI_NFIT_TYPE_RESERVED = 8 /* 8 and greater are reserved */ 1771 }; 1772 1773 /* 1774 * NFIT Subtables 1775 */ 1776 1777 /* 0: System Physical Address Range Structure */ 1778 1779 struct acpi_nfit_system_address { 1780 struct acpi_nfit_header header; 1781 u16 range_index; 1782 u16 flags; 1783 u32 reserved; /* Reserved, must be zero */ 1784 u32 proximity_domain; 1785 u8 range_guid[16]; 1786 u64 address; 1787 u64 length; 1788 u64 memory_mapping; 1789 u64 location_cookie; /* ACPI 6.4 */ 1790 }; 1791 1792 /* Flags */ 1793 1794 #define ACPI_NFIT_ADD_ONLINE_ONLY (1) /* 00: Add/Online Operation Only */ 1795 #define ACPI_NFIT_PROXIMITY_VALID (1<<1) /* 01: Proximity Domain Valid */ 1796 #define ACPI_NFIT_LOCATION_COOKIE_VALID (1<<2) /* 02: SPA location cookie valid (ACPI 6.4) */ 1797 1798 /* Range Type GUIDs appear in the include/acuuid.h file */ 1799 1800 /* 1: Memory Device to System Address Range Map Structure */ 1801 1802 struct acpi_nfit_memory_map { 1803 struct acpi_nfit_header header; 1804 u32 device_handle; 1805 u16 physical_id; 1806 u16 region_id; 1807 u16 range_index; 1808 u16 region_index; 1809 u64 region_size; 1810 u64 region_offset; 1811 u64 address; 1812 u16 interleave_index; 1813 u16 interleave_ways; 1814 u16 flags; 1815 u16 reserved; /* Reserved, must be zero */ 1816 }; 1817 1818 /* Flags */ 1819 1820 #define ACPI_NFIT_MEM_SAVE_FAILED (1) /* 00: Last SAVE to Memory Device failed */ 1821 #define ACPI_NFIT_MEM_RESTORE_FAILED (1<<1) /* 01: Last RESTORE from Memory Device failed */ 1822 #define ACPI_NFIT_MEM_FLUSH_FAILED (1<<2) /* 02: Platform flush failed */ 1823 #define ACPI_NFIT_MEM_NOT_ARMED (1<<3) /* 03: Memory Device is not armed */ 1824 #define ACPI_NFIT_MEM_HEALTH_OBSERVED (1<<4) /* 04: Memory Device observed SMART/health events */ 1825 #define ACPI_NFIT_MEM_HEALTH_ENABLED (1<<5) /* 05: SMART/health events enabled */ 1826 #define ACPI_NFIT_MEM_MAP_FAILED (1<<6) /* 06: Mapping to SPA failed */ 1827 1828 /* 2: Interleave Structure */ 1829 1830 struct acpi_nfit_interleave { 1831 struct acpi_nfit_header header; 1832 u16 interleave_index; 1833 u16 reserved; /* Reserved, must be zero */ 1834 u32 line_count; 1835 u32 line_size; 1836 u32 line_offset[]; /* Variable length */ 1837 }; 1838 1839 /* 3: SMBIOS Management Information Structure */ 1840 1841 struct acpi_nfit_smbios { 1842 struct acpi_nfit_header header; 1843 u32 reserved; /* Reserved, must be zero */ 1844 u8 data[]; /* Variable length */ 1845 }; 1846 1847 /* 4: NVDIMM Control Region Structure */ 1848 1849 struct acpi_nfit_control_region { 1850 struct acpi_nfit_header header; 1851 u16 region_index; 1852 u16 vendor_id; 1853 u16 device_id; 1854 u16 revision_id; 1855 u16 subsystem_vendor_id; 1856 u16 subsystem_device_id; 1857 u16 subsystem_revision_id; 1858 u8 valid_fields; 1859 u8 manufacturing_location; 1860 u16 manufacturing_date; 1861 u8 reserved[2]; /* Reserved, must be zero */ 1862 u32 serial_number; 1863 u16 code; 1864 u16 windows; 1865 u64 window_size; 1866 u64 command_offset; 1867 u64 command_size; 1868 u64 status_offset; 1869 u64 status_size; 1870 u16 flags; 1871 u8 reserved1[6]; /* Reserved, must be zero */ 1872 }; 1873 1874 /* Flags */ 1875 1876 #define ACPI_NFIT_CONTROL_BUFFERED (1) /* Block Data Windows implementation is buffered */ 1877 1878 /* valid_fields bits */ 1879 1880 #define ACPI_NFIT_CONTROL_MFG_INFO_VALID (1) /* Manufacturing fields are valid */ 1881 1882 /* 5: NVDIMM Block Data Window Region Structure */ 1883 1884 struct acpi_nfit_data_region { 1885 struct acpi_nfit_header header; 1886 u16 region_index; 1887 u16 windows; 1888 u64 offset; 1889 u64 size; 1890 u64 capacity; 1891 u64 start_address; 1892 }; 1893 1894 /* 6: Flush Hint Address Structure */ 1895 1896 struct acpi_nfit_flush_address { 1897 struct acpi_nfit_header header; 1898 u32 device_handle; 1899 u16 hint_count; 1900 u8 reserved[6]; /* Reserved, must be zero */ 1901 u64 hint_address[]; /* Variable length */ 1902 }; 1903 1904 /* 7: Platform Capabilities Structure */ 1905 1906 struct acpi_nfit_capabilities { 1907 struct acpi_nfit_header header; 1908 u8 highest_capability; 1909 u8 reserved[3]; /* Reserved, must be zero */ 1910 u32 capabilities; 1911 u32 reserved2; 1912 }; 1913 1914 /* Capabilities Flags */ 1915 1916 #define ACPI_NFIT_CAPABILITY_CACHE_FLUSH (1) /* 00: Cache Flush to NVDIMM capable */ 1917 #define ACPI_NFIT_CAPABILITY_MEM_FLUSH (1<<1) /* 01: Memory Flush to NVDIMM capable */ 1918 #define ACPI_NFIT_CAPABILITY_MEM_MIRRORING (1<<2) /* 02: Memory Mirroring capable */ 1919 1920 /* 1921 * NFIT/DVDIMM device handle support - used as the _ADR for each NVDIMM 1922 */ 1923 struct nfit_device_handle { 1924 u32 handle; 1925 }; 1926 1927 /* Device handle construction and extraction macros */ 1928 1929 #define ACPI_NFIT_DIMM_NUMBER_MASK 0x0000000F 1930 #define ACPI_NFIT_CHANNEL_NUMBER_MASK 0x000000F0 1931 #define ACPI_NFIT_MEMORY_ID_MASK 0x00000F00 1932 #define ACPI_NFIT_SOCKET_ID_MASK 0x0000F000 1933 #define ACPI_NFIT_NODE_ID_MASK 0x0FFF0000 1934 1935 #define ACPI_NFIT_DIMM_NUMBER_OFFSET 0 1936 #define ACPI_NFIT_CHANNEL_NUMBER_OFFSET 4 1937 #define ACPI_NFIT_MEMORY_ID_OFFSET 8 1938 #define ACPI_NFIT_SOCKET_ID_OFFSET 12 1939 #define ACPI_NFIT_NODE_ID_OFFSET 16 1940 1941 /* Macro to construct a NFIT/NVDIMM device handle */ 1942 1943 #define ACPI_NFIT_BUILD_DEVICE_HANDLE(dimm, channel, memory, socket, node) \ 1944 ((dimm) | \ 1945 ((channel) << ACPI_NFIT_CHANNEL_NUMBER_OFFSET) | \ 1946 ((memory) << ACPI_NFIT_MEMORY_ID_OFFSET) | \ 1947 ((socket) << ACPI_NFIT_SOCKET_ID_OFFSET) | \ 1948 ((node) << ACPI_NFIT_NODE_ID_OFFSET)) 1949 1950 /* Macros to extract individual fields from a NFIT/NVDIMM device handle */ 1951 1952 #define ACPI_NFIT_GET_DIMM_NUMBER(handle) \ 1953 ((handle) & ACPI_NFIT_DIMM_NUMBER_MASK) 1954 1955 #define ACPI_NFIT_GET_CHANNEL_NUMBER(handle) \ 1956 (((handle) & ACPI_NFIT_CHANNEL_NUMBER_MASK) >> ACPI_NFIT_CHANNEL_NUMBER_OFFSET) 1957 1958 #define ACPI_NFIT_GET_MEMORY_ID(handle) \ 1959 (((handle) & ACPI_NFIT_MEMORY_ID_MASK) >> ACPI_NFIT_MEMORY_ID_OFFSET) 1960 1961 #define ACPI_NFIT_GET_SOCKET_ID(handle) \ 1962 (((handle) & ACPI_NFIT_SOCKET_ID_MASK) >> ACPI_NFIT_SOCKET_ID_OFFSET) 1963 1964 #define ACPI_NFIT_GET_NODE_ID(handle) \ 1965 (((handle) & ACPI_NFIT_NODE_ID_MASK) >> ACPI_NFIT_NODE_ID_OFFSET) 1966 1967 /******************************************************************************* 1968 * 1969 * NHLT - Non HDAudio Link Table 1970 * Version 1 1971 * 1972 ******************************************************************************/ 1973 1974 struct acpi_table_nhlt { 1975 struct acpi_table_header header; /* Common ACPI table header */ 1976 u8 endpoints_count; 1977 /* 1978 * struct acpi_nhlt_endpoint endpoints[]; 1979 * struct acpi_nhlt_config oed_config; 1980 */ 1981 }; 1982 1983 struct acpi_nhlt_endpoint { 1984 u32 length; 1985 u8 link_type; 1986 u8 instance_id; 1987 u16 vendor_id; 1988 u16 device_id; 1989 u16 revision_id; 1990 u32 subsystem_id; 1991 u8 device_type; 1992 u8 direction; 1993 u8 virtual_bus_id; 1994 /* 1995 * struct acpi_nhlt_config device_config; 1996 * struct acpi_nhlt_formats_config formats_config; 1997 * struct acpi_nhlt_devices_info devices_info; 1998 */ 1999 }; 2000 2001 /* 2002 * Values for link_type field above 2003 * 2004 * Only types PDM and SSP are used 2005 */ 2006 #define ACPI_NHLT_LINKTYPE_HDA 0 2007 #define ACPI_NHLT_LINKTYPE_DSP 1 2008 #define ACPI_NHLT_LINKTYPE_PDM 2 2009 #define ACPI_NHLT_LINKTYPE_SSP 3 2010 #define ACPI_NHLT_LINKTYPE_SLIMBUS 4 2011 #define ACPI_NHLT_LINKTYPE_SDW 5 2012 #define ACPI_NHLT_LINKTYPE_UAOL 6 2013 2014 /* Values for device_id field above */ 2015 2016 #define ACPI_NHLT_DEVICEID_DMIC 0xAE20 2017 #define ACPI_NHLT_DEVICEID_BT 0xAE30 2018 #define ACPI_NHLT_DEVICEID_I2S 0xAE34 2019 2020 /* Values for device_type field above */ 2021 2022 /* 2023 * Device types unique to endpoint of link_type=PDM 2024 * 2025 * Type PDM used for all SKL+ platforms 2026 */ 2027 #define ACPI_NHLT_DEVICETYPE_PDM 0 2028 #define ACPI_NHLT_DEVICETYPE_PDM_SKL 1 2029 /* Device types unique to endpoint of link_type=SSP */ 2030 #define ACPI_NHLT_DEVICETYPE_BT 0 2031 #define ACPI_NHLT_DEVICETYPE_FM 1 2032 #define ACPI_NHLT_DEVICETYPE_MODEM 2 2033 #define ACPI_NHLT_DEVICETYPE_CODEC 4 2034 2035 /* Values for Direction field above */ 2036 2037 #define ACPI_NHLT_DIR_RENDER 0 2038 #define ACPI_NHLT_DIR_CAPTURE 1 2039 2040 struct acpi_nhlt_config { 2041 u32 capabilities_size; 2042 u8 capabilities[]; 2043 }; 2044 2045 struct acpi_nhlt_gendevice_config { 2046 u8 virtual_slot; 2047 u8 config_type; 2048 }; 2049 2050 /* Values for config_type field above */ 2051 2052 #define ACPI_NHLT_CONFIGTYPE_GENERIC 0 2053 #define ACPI_NHLT_CONFIGTYPE_MICARRAY 1 2054 2055 struct acpi_nhlt_micdevice_config { 2056 u8 virtual_slot; 2057 u8 config_type; 2058 u8 array_type; 2059 }; 2060 2061 /* Values for array_type field above */ 2062 2063 #define ACPI_NHLT_ARRAYTYPE_LINEAR2_SMALL 0xA 2064 #define ACPI_NHLT_ARRAYTYPE_LINEAR2_BIG 0xB 2065 #define ACPI_NHLT_ARRAYTYPE_LINEAR4_GEO1 0xC 2066 #define ACPI_NHLT_ARRAYTYPE_PLANAR4_LSHAPED 0xD 2067 #define ACPI_NHLT_ARRAYTYPE_LINEAR4_GEO2 0xE 2068 #define ACPI_NHLT_ARRAYTYPE_VENDOR 0xF 2069 2070 struct acpi_nhlt_vendor_mic_config { 2071 u8 type; 2072 u8 panel; 2073 u16 speaker_position_distance; /* mm */ 2074 u16 horizontal_offset; /* mm */ 2075 u16 vertical_offset; /* mm */ 2076 u8 frequency_low_band; /* 5*Hz */ 2077 u8 frequency_high_band; /* 500*Hz */ 2078 u16 direction_angle; /* -180 - +180 */ 2079 u16 elevation_angle; /* -180 - +180 */ 2080 u16 work_vertical_angle_begin; /* -180 - +180 with 2 deg step */ 2081 u16 work_vertical_angle_end; /* -180 - +180 with 2 deg step */ 2082 u16 work_horizontal_angle_begin; /* -180 - +180 with 2 deg step */ 2083 u16 work_horizontal_angle_end; /* -180 - +180 with 2 deg step */ 2084 }; 2085 2086 /* Values for Type field above */ 2087 2088 #define ACPI_NHLT_MICTYPE_OMNIDIRECTIONAL 0 2089 #define ACPI_NHLT_MICTYPE_SUBCARDIOID 1 2090 #define ACPI_NHLT_MICTYPE_CARDIOID 2 2091 #define ACPI_NHLT_MICTYPE_SUPERCARDIOID 3 2092 #define ACPI_NHLT_MICTYPE_HYPERCARDIOID 4 2093 #define ACPI_NHLT_MICTYPE_8SHAPED 5 2094 #define ACPI_NHLT_MICTYPE_RESERVED 6 2095 #define ACPI_NHLT_MICTYPE_VENDORDEFINED 7 2096 2097 /* Values for Panel field above */ 2098 2099 #define ACPI_NHLT_MICLOCATION_TOP 0 2100 #define ACPI_NHLT_MICLOCATION_BOTTOM 1 2101 #define ACPI_NHLT_MICLOCATION_LEFT 2 2102 #define ACPI_NHLT_MICLOCATION_RIGHT 3 2103 #define ACPI_NHLT_MICLOCATION_FRONT 4 2104 #define ACPI_NHLT_MICLOCATION_REAR 5 2105 2106 struct acpi_nhlt_vendor_micdevice_config { 2107 u8 virtual_slot; 2108 u8 config_type; 2109 u8 array_type; 2110 u8 mics_count; 2111 struct acpi_nhlt_vendor_mic_config mics[]; 2112 }; 2113 2114 union acpi_nhlt_device_config { 2115 u8 virtual_slot; 2116 struct acpi_nhlt_gendevice_config gen; 2117 struct acpi_nhlt_micdevice_config mic; 2118 struct acpi_nhlt_vendor_micdevice_config vendor_mic; 2119 }; 2120 2121 /* Inherited from Microsoft's WAVEFORMATEXTENSIBLE. */ 2122 struct acpi_nhlt_wave_formatext { 2123 u16 format_tag; 2124 u16 channel_count; 2125 u32 samples_per_sec; 2126 u32 avg_bytes_per_sec; 2127 u16 block_align; 2128 u16 bits_per_sample; 2129 u16 extra_format_size; 2130 u16 valid_bits_per_sample; 2131 u32 channel_mask; 2132 u8 subformat[16]; 2133 }; 2134 2135 struct acpi_nhlt_format_config { 2136 struct acpi_nhlt_wave_formatext format; 2137 struct acpi_nhlt_config config; 2138 }; 2139 2140 struct acpi_nhlt_formats_config { 2141 u8 formats_count; 2142 struct acpi_nhlt_format_config formats[]; 2143 }; 2144 2145 struct acpi_nhlt_device_info { 2146 u8 id[16]; 2147 u8 instance_id; 2148 u8 port_id; 2149 }; 2150 2151 struct acpi_nhlt_devices_info { 2152 u8 devices_count; 2153 struct acpi_nhlt_device_info devices[]; 2154 }; 2155 2156 /******************************************************************************* 2157 * 2158 * PCCT - Platform Communications Channel Table (ACPI 5.0) 2159 * Version 2 (ACPI 6.2) 2160 * 2161 ******************************************************************************/ 2162 2163 struct acpi_table_pcct { 2164 struct acpi_table_header header; /* Common ACPI table header */ 2165 u32 flags; 2166 u64 reserved; 2167 }; 2168 2169 /* Values for Flags field above */ 2170 2171 #define ACPI_PCCT_DOORBELL 1 2172 2173 /* Values for subtable type in struct acpi_subtable_header */ 2174 2175 enum acpi_pcct_type { 2176 ACPI_PCCT_TYPE_GENERIC_SUBSPACE = 0, 2177 ACPI_PCCT_TYPE_HW_REDUCED_SUBSPACE = 1, 2178 ACPI_PCCT_TYPE_HW_REDUCED_SUBSPACE_TYPE2 = 2, /* ACPI 6.1 */ 2179 ACPI_PCCT_TYPE_EXT_PCC_MASTER_SUBSPACE = 3, /* ACPI 6.2 */ 2180 ACPI_PCCT_TYPE_EXT_PCC_SLAVE_SUBSPACE = 4, /* ACPI 6.2 */ 2181 ACPI_PCCT_TYPE_HW_REG_COMM_SUBSPACE = 5, /* ACPI 6.4 */ 2182 ACPI_PCCT_TYPE_RESERVED = 6 /* 6 and greater are reserved */ 2183 }; 2184 2185 /* 2186 * PCCT Subtables, correspond to Type in struct acpi_subtable_header 2187 */ 2188 2189 /* 0: Generic Communications Subspace */ 2190 2191 struct acpi_pcct_subspace { 2192 struct acpi_subtable_header header; 2193 u8 reserved[6]; 2194 u64 base_address; 2195 u64 length; 2196 struct acpi_generic_address doorbell_register; 2197 u64 preserve_mask; 2198 u64 write_mask; 2199 u32 latency; 2200 u32 max_access_rate; 2201 u16 min_turnaround_time; 2202 }; 2203 2204 /* 1: HW-reduced Communications Subspace (ACPI 5.1) */ 2205 2206 struct acpi_pcct_hw_reduced { 2207 struct acpi_subtable_header header; 2208 u32 platform_interrupt; 2209 u8 flags; 2210 u8 reserved; 2211 u64 base_address; 2212 u64 length; 2213 struct acpi_generic_address doorbell_register; 2214 u64 preserve_mask; 2215 u64 write_mask; 2216 u32 latency; 2217 u32 max_access_rate; 2218 u16 min_turnaround_time; 2219 }; 2220 2221 /* 2: HW-reduced Communications Subspace Type 2 (ACPI 6.1) */ 2222 2223 struct acpi_pcct_hw_reduced_type2 { 2224 struct acpi_subtable_header header; 2225 u32 platform_interrupt; 2226 u8 flags; 2227 u8 reserved; 2228 u64 base_address; 2229 u64 length; 2230 struct acpi_generic_address doorbell_register; 2231 u64 preserve_mask; 2232 u64 write_mask; 2233 u32 latency; 2234 u32 max_access_rate; 2235 u16 min_turnaround_time; 2236 struct acpi_generic_address platform_ack_register; 2237 u64 ack_preserve_mask; 2238 u64 ack_write_mask; 2239 }; 2240 2241 /* 3: Extended PCC Master Subspace Type 3 (ACPI 6.2) */ 2242 2243 struct acpi_pcct_ext_pcc_master { 2244 struct acpi_subtable_header header; 2245 u32 platform_interrupt; 2246 u8 flags; 2247 u8 reserved1; 2248 u64 base_address; 2249 u32 length; 2250 struct acpi_generic_address doorbell_register; 2251 u64 preserve_mask; 2252 u64 write_mask; 2253 u32 latency; 2254 u32 max_access_rate; 2255 u32 min_turnaround_time; 2256 struct acpi_generic_address platform_ack_register; 2257 u64 ack_preserve_mask; 2258 u64 ack_set_mask; 2259 u64 reserved2; 2260 struct acpi_generic_address cmd_complete_register; 2261 u64 cmd_complete_mask; 2262 struct acpi_generic_address cmd_update_register; 2263 u64 cmd_update_preserve_mask; 2264 u64 cmd_update_set_mask; 2265 struct acpi_generic_address error_status_register; 2266 u64 error_status_mask; 2267 }; 2268 2269 /* 4: Extended PCC Slave Subspace Type 4 (ACPI 6.2) */ 2270 2271 struct acpi_pcct_ext_pcc_slave { 2272 struct acpi_subtable_header header; 2273 u32 platform_interrupt; 2274 u8 flags; 2275 u8 reserved1; 2276 u64 base_address; 2277 u32 length; 2278 struct acpi_generic_address doorbell_register; 2279 u64 preserve_mask; 2280 u64 write_mask; 2281 u32 latency; 2282 u32 max_access_rate; 2283 u32 min_turnaround_time; 2284 struct acpi_generic_address platform_ack_register; 2285 u64 ack_preserve_mask; 2286 u64 ack_set_mask; 2287 u64 reserved2; 2288 struct acpi_generic_address cmd_complete_register; 2289 u64 cmd_complete_mask; 2290 struct acpi_generic_address cmd_update_register; 2291 u64 cmd_update_preserve_mask; 2292 u64 cmd_update_set_mask; 2293 struct acpi_generic_address error_status_register; 2294 u64 error_status_mask; 2295 }; 2296 2297 /* 5: HW Registers based Communications Subspace */ 2298 2299 struct acpi_pcct_hw_reg { 2300 struct acpi_subtable_header header; 2301 u16 version; 2302 u64 base_address; 2303 u64 length; 2304 struct acpi_generic_address doorbell_register; 2305 u64 doorbell_preserve; 2306 u64 doorbell_write; 2307 struct acpi_generic_address cmd_complete_register; 2308 u64 cmd_complete_mask; 2309 struct acpi_generic_address error_status_register; 2310 u64 error_status_mask; 2311 u32 nominal_latency; 2312 u32 min_turnaround_time; 2313 }; 2314 2315 /* Values for doorbell flags above */ 2316 2317 #define ACPI_PCCT_INTERRUPT_POLARITY (1) 2318 #define ACPI_PCCT_INTERRUPT_MODE (1<<1) 2319 2320 /* 2321 * PCC memory structures (not part of the ACPI table) 2322 */ 2323 2324 /* Shared Memory Region */ 2325 2326 struct acpi_pcct_shared_memory { 2327 u32 signature; 2328 u16 command; 2329 u16 status; 2330 }; 2331 2332 /* Extended PCC Subspace Shared Memory Region (ACPI 6.2) */ 2333 2334 struct acpi_pcct_ext_pcc_shared_memory { 2335 u32 signature; 2336 u32 flags; 2337 u32 length; 2338 u32 command; 2339 }; 2340 2341 /******************************************************************************* 2342 * 2343 * PDTT - Platform Debug Trigger Table (ACPI 6.2) 2344 * Version 0 2345 * 2346 ******************************************************************************/ 2347 2348 struct acpi_table_pdtt { 2349 struct acpi_table_header header; /* Common ACPI table header */ 2350 u8 trigger_count; 2351 u8 reserved[3]; 2352 u32 array_offset; 2353 }; 2354 2355 /* 2356 * PDTT Communication Channel Identifier Structure. 2357 * The number of these structures is defined by trigger_count above, 2358 * starting at array_offset. 2359 */ 2360 struct acpi_pdtt_channel { 2361 u8 subchannel_id; 2362 u8 flags; 2363 }; 2364 2365 /* Flags for above */ 2366 2367 #define ACPI_PDTT_RUNTIME_TRIGGER (1) 2368 #define ACPI_PDTT_WAIT_COMPLETION (1<<1) 2369 #define ACPI_PDTT_TRIGGER_ORDER (1<<2) 2370 2371 /******************************************************************************* 2372 * 2373 * PHAT - Platform Health Assessment Table (ACPI 6.4) 2374 * Version 1 2375 * 2376 ******************************************************************************/ 2377 2378 struct acpi_table_phat { 2379 struct acpi_table_header header; /* Common ACPI table header */ 2380 }; 2381 2382 /* Common header for PHAT subtables that follow main table */ 2383 2384 struct acpi_phat_header { 2385 u16 type; 2386 u16 length; 2387 u8 revision; 2388 }; 2389 2390 /* Values for Type field above */ 2391 2392 #define ACPI_PHAT_TYPE_FW_VERSION_DATA 0 2393 #define ACPI_PHAT_TYPE_FW_HEALTH_DATA 1 2394 #define ACPI_PHAT_TYPE_RESERVED 2 /* 0x02-0xFFFF are reserved */ 2395 2396 /* 2397 * PHAT subtables, correspond to Type in struct acpi_phat_header 2398 */ 2399 2400 /* 0: Firmware Version Data Record */ 2401 2402 struct acpi_phat_version_data { 2403 struct acpi_phat_header header; 2404 u8 reserved[3]; 2405 u32 element_count; 2406 }; 2407 2408 struct acpi_phat_version_element { 2409 u8 guid[16]; 2410 u64 version_value; 2411 u32 producer_id; 2412 }; 2413 2414 /* 1: Firmware Health Data Record */ 2415 2416 struct acpi_phat_health_data { 2417 struct acpi_phat_header header; 2418 u8 reserved[2]; 2419 u8 health; 2420 u8 device_guid[16]; 2421 u32 device_specific_offset; /* Zero if no Device-specific data */ 2422 }; 2423 2424 /* Values for Health field above */ 2425 2426 #define ACPI_PHAT_ERRORS_FOUND 0 2427 #define ACPI_PHAT_NO_ERRORS 1 2428 #define ACPI_PHAT_UNKNOWN_ERRORS 2 2429 #define ACPI_PHAT_ADVISORY 3 2430 2431 /******************************************************************************* 2432 * 2433 * PMTT - Platform Memory Topology Table (ACPI 5.0) 2434 * Version 1 2435 * 2436 ******************************************************************************/ 2437 2438 struct acpi_table_pmtt { 2439 struct acpi_table_header header; /* Common ACPI table header */ 2440 u32 memory_device_count; 2441 /* 2442 * Immediately followed by: 2443 * MEMORY_DEVICE memory_device_struct[memory_device_count]; 2444 */ 2445 }; 2446 2447 /* Common header for PMTT subtables that follow main table */ 2448 2449 struct acpi_pmtt_header { 2450 u8 type; 2451 u8 reserved1; 2452 u16 length; 2453 u16 flags; 2454 u16 reserved2; 2455 u32 memory_device_count; /* Zero means no memory device structs follow */ 2456 /* 2457 * Immediately followed by: 2458 * u8 type_specific_data[] 2459 * MEMORY_DEVICE memory_device_struct[memory_device_count]; 2460 */ 2461 }; 2462 2463 /* Values for Type field above */ 2464 2465 #define ACPI_PMTT_TYPE_SOCKET 0 2466 #define ACPI_PMTT_TYPE_CONTROLLER 1 2467 #define ACPI_PMTT_TYPE_DIMM 2 2468 #define ACPI_PMTT_TYPE_RESERVED 3 /* 0x03-0xFE are reserved */ 2469 #define ACPI_PMTT_TYPE_VENDOR 0xFF 2470 2471 /* Values for Flags field above */ 2472 2473 #define ACPI_PMTT_TOP_LEVEL 0x0001 2474 #define ACPI_PMTT_PHYSICAL 0x0002 2475 #define ACPI_PMTT_MEMORY_TYPE 0x000C 2476 2477 /* 2478 * PMTT subtables, correspond to Type in struct acpi_pmtt_header 2479 */ 2480 2481 /* 0: Socket Structure */ 2482 2483 struct acpi_pmtt_socket { 2484 struct acpi_pmtt_header header; 2485 u16 socket_id; 2486 u16 reserved; 2487 }; 2488 /* 2489 * Immediately followed by: 2490 * MEMORY_DEVICE memory_device_struct[memory_device_count]; 2491 */ 2492 2493 /* 1: Memory Controller subtable */ 2494 2495 struct acpi_pmtt_controller { 2496 struct acpi_pmtt_header header; 2497 u16 controller_id; 2498 u16 reserved; 2499 }; 2500 /* 2501 * Immediately followed by: 2502 * MEMORY_DEVICE memory_device_struct[memory_device_count]; 2503 */ 2504 2505 /* 2: Physical Component Identifier (DIMM) */ 2506 2507 struct acpi_pmtt_physical_component { 2508 struct acpi_pmtt_header header; 2509 u32 bios_handle; 2510 }; 2511 2512 /* 0xFF: Vendor Specific Data */ 2513 2514 struct acpi_pmtt_vendor_specific { 2515 struct acpi_pmtt_header header; 2516 u8 type_uuid[16]; 2517 u8 specific[]; 2518 /* 2519 * Immediately followed by: 2520 * u8 vendor_specific_data[]; 2521 * MEMORY_DEVICE memory_device_struct[memory_device_count]; 2522 */ 2523 }; 2524 2525 /******************************************************************************* 2526 * 2527 * PPTT - Processor Properties Topology Table (ACPI 6.2) 2528 * Version 1 2529 * 2530 ******************************************************************************/ 2531 2532 struct acpi_table_pptt { 2533 struct acpi_table_header header; /* Common ACPI table header */ 2534 }; 2535 2536 /* Values for Type field above */ 2537 2538 enum acpi_pptt_type { 2539 ACPI_PPTT_TYPE_PROCESSOR = 0, 2540 ACPI_PPTT_TYPE_CACHE = 1, 2541 ACPI_PPTT_TYPE_ID = 2, 2542 ACPI_PPTT_TYPE_RESERVED = 3 2543 }; 2544 2545 /* 0: Processor Hierarchy Node Structure */ 2546 2547 struct acpi_pptt_processor { 2548 struct acpi_subtable_header header; 2549 u16 reserved; 2550 u32 flags; 2551 u32 parent; 2552 u32 acpi_processor_id; 2553 u32 number_of_priv_resources; 2554 }; 2555 2556 /* Flags */ 2557 2558 #define ACPI_PPTT_PHYSICAL_PACKAGE (1) 2559 #define ACPI_PPTT_ACPI_PROCESSOR_ID_VALID (1<<1) 2560 #define ACPI_PPTT_ACPI_PROCESSOR_IS_THREAD (1<<2) /* ACPI 6.3 */ 2561 #define ACPI_PPTT_ACPI_LEAF_NODE (1<<3) /* ACPI 6.3 */ 2562 #define ACPI_PPTT_ACPI_IDENTICAL (1<<4) /* ACPI 6.3 */ 2563 2564 /* 1: Cache Type Structure */ 2565 2566 struct acpi_pptt_cache { 2567 struct acpi_subtable_header header; 2568 u16 reserved; 2569 u32 flags; 2570 u32 next_level_of_cache; 2571 u32 size; 2572 u32 number_of_sets; 2573 u8 associativity; 2574 u8 attributes; 2575 u16 line_size; 2576 }; 2577 2578 /* 1: Cache Type Structure for PPTT version 3 */ 2579 2580 struct acpi_pptt_cache_v1 { 2581 u32 cache_id; 2582 }; 2583 2584 /* Flags */ 2585 2586 #define ACPI_PPTT_SIZE_PROPERTY_VALID (1) /* Physical property valid */ 2587 #define ACPI_PPTT_NUMBER_OF_SETS_VALID (1<<1) /* Number of sets valid */ 2588 #define ACPI_PPTT_ASSOCIATIVITY_VALID (1<<2) /* Associativity valid */ 2589 #define ACPI_PPTT_ALLOCATION_TYPE_VALID (1<<3) /* Allocation type valid */ 2590 #define ACPI_PPTT_CACHE_TYPE_VALID (1<<4) /* Cache type valid */ 2591 #define ACPI_PPTT_WRITE_POLICY_VALID (1<<5) /* Write policy valid */ 2592 #define ACPI_PPTT_LINE_SIZE_VALID (1<<6) /* Line size valid */ 2593 #define ACPI_PPTT_CACHE_ID_VALID (1<<7) /* Cache ID valid */ 2594 2595 /* Masks for Attributes */ 2596 2597 #define ACPI_PPTT_MASK_ALLOCATION_TYPE (0x03) /* Allocation type */ 2598 #define ACPI_PPTT_MASK_CACHE_TYPE (0x0C) /* Cache type */ 2599 #define ACPI_PPTT_MASK_WRITE_POLICY (0x10) /* Write policy */ 2600 2601 /* Attributes describing cache */ 2602 #define ACPI_PPTT_CACHE_READ_ALLOCATE (0x0) /* Cache line is allocated on read */ 2603 #define ACPI_PPTT_CACHE_WRITE_ALLOCATE (0x01) /* Cache line is allocated on write */ 2604 #define ACPI_PPTT_CACHE_RW_ALLOCATE (0x02) /* Cache line is allocated on read and write */ 2605 #define ACPI_PPTT_CACHE_RW_ALLOCATE_ALT (0x03) /* Alternate representation of above */ 2606 2607 #define ACPI_PPTT_CACHE_TYPE_DATA (0x0) /* Data cache */ 2608 #define ACPI_PPTT_CACHE_TYPE_INSTR (1<<2) /* Instruction cache */ 2609 #define ACPI_PPTT_CACHE_TYPE_UNIFIED (2<<2) /* Unified I & D cache */ 2610 #define ACPI_PPTT_CACHE_TYPE_UNIFIED_ALT (3<<2) /* Alternate representation of above */ 2611 2612 #define ACPI_PPTT_CACHE_POLICY_WB (0x0) /* Cache is write back */ 2613 #define ACPI_PPTT_CACHE_POLICY_WT (1<<4) /* Cache is write through */ 2614 2615 /* 2: ID Structure */ 2616 2617 struct acpi_pptt_id { 2618 struct acpi_subtable_header header; 2619 u16 reserved; 2620 u32 vendor_id; 2621 u64 level1_id; 2622 u64 level2_id; 2623 u16 major_rev; 2624 u16 minor_rev; 2625 u16 spin_rev; 2626 }; 2627 2628 /******************************************************************************* 2629 * 2630 * PRMT - Platform Runtime Mechanism Table 2631 * Version 1 2632 * 2633 ******************************************************************************/ 2634 2635 struct acpi_table_prmt { 2636 struct acpi_table_header header; /* Common ACPI table header */ 2637 }; 2638 2639 struct acpi_table_prmt_header { 2640 u8 platform_guid[16]; 2641 u32 module_info_offset; 2642 u32 module_info_count; 2643 }; 2644 2645 struct acpi_prmt_module_header { 2646 u16 revision; 2647 u16 length; 2648 }; 2649 2650 struct acpi_prmt_module_info { 2651 u16 revision; 2652 u16 length; 2653 u8 module_guid[16]; 2654 u16 major_rev; 2655 u16 minor_rev; 2656 u16 handler_info_count; 2657 u32 handler_info_offset; 2658 u64 mmio_list_pointer; 2659 }; 2660 2661 struct acpi_prmt_handler_info { 2662 u16 revision; 2663 u16 length; 2664 u8 handler_guid[16]; 2665 u64 handler_address; 2666 u64 static_data_buffer_address; 2667 u64 acpi_param_buffer_address; 2668 }; 2669 2670 /******************************************************************************* 2671 * 2672 * RASF - RAS Feature Table (ACPI 5.0) 2673 * Version 1 2674 * 2675 ******************************************************************************/ 2676 2677 struct acpi_table_rasf { 2678 struct acpi_table_header header; /* Common ACPI table header */ 2679 u8 channel_id[12]; 2680 }; 2681 2682 /* RASF Platform Communication Channel Shared Memory Region */ 2683 2684 struct acpi_rasf_shared_memory { 2685 u32 signature; 2686 u16 command; 2687 u16 status; 2688 u16 version; 2689 u8 capabilities[16]; 2690 u8 set_capabilities[16]; 2691 u16 num_parameter_blocks; 2692 u32 set_capabilities_status; 2693 }; 2694 2695 /* RASF Parameter Block Structure Header */ 2696 2697 struct acpi_rasf_parameter_block { 2698 u16 type; 2699 u16 version; 2700 u16 length; 2701 }; 2702 2703 /* RASF Parameter Block Structure for PATROL_SCRUB */ 2704 2705 struct acpi_rasf_patrol_scrub_parameter { 2706 struct acpi_rasf_parameter_block header; 2707 u16 patrol_scrub_command; 2708 u64 requested_address_range[2]; 2709 u64 actual_address_range[2]; 2710 u16 flags; 2711 u8 requested_speed; 2712 }; 2713 2714 /* Masks for Flags and Speed fields above */ 2715 2716 #define ACPI_RASF_SCRUBBER_RUNNING 1 2717 #define ACPI_RASF_SPEED (7<<1) 2718 #define ACPI_RASF_SPEED_SLOW (0<<1) 2719 #define ACPI_RASF_SPEED_MEDIUM (4<<1) 2720 #define ACPI_RASF_SPEED_FAST (7<<1) 2721 2722 /* Channel Commands */ 2723 2724 enum acpi_rasf_commands { 2725 ACPI_RASF_EXECUTE_RASF_COMMAND = 1 2726 }; 2727 2728 /* Platform RAS Capabilities */ 2729 2730 enum acpi_rasf_capabiliities { 2731 ACPI_HW_PATROL_SCRUB_SUPPORTED = 0, 2732 ACPI_SW_PATROL_SCRUB_EXPOSED = 1 2733 }; 2734 2735 /* Patrol Scrub Commands */ 2736 2737 enum acpi_rasf_patrol_scrub_commands { 2738 ACPI_RASF_GET_PATROL_PARAMETERS = 1, 2739 ACPI_RASF_START_PATROL_SCRUBBER = 2, 2740 ACPI_RASF_STOP_PATROL_SCRUBBER = 3 2741 }; 2742 2743 /* Channel Command flags */ 2744 2745 #define ACPI_RASF_GENERATE_SCI (1<<15) 2746 2747 /* Status values */ 2748 2749 enum acpi_rasf_status { 2750 ACPI_RASF_SUCCESS = 0, 2751 ACPI_RASF_NOT_VALID = 1, 2752 ACPI_RASF_NOT_SUPPORTED = 2, 2753 ACPI_RASF_BUSY = 3, 2754 ACPI_RASF_FAILED = 4, 2755 ACPI_RASF_ABORTED = 5, 2756 ACPI_RASF_INVALID_DATA = 6 2757 }; 2758 2759 /* Status flags */ 2760 2761 #define ACPI_RASF_COMMAND_COMPLETE (1) 2762 #define ACPI_RASF_SCI_DOORBELL (1<<1) 2763 #define ACPI_RASF_ERROR (1<<2) 2764 #define ACPI_RASF_STATUS (0x1F<<3) 2765 2766 /******************************************************************************* 2767 * 2768 * RAS2 - RAS2 Feature Table (ACPI 6.5) 2769 * Version 1 2770 * 2771 * 2772 ******************************************************************************/ 2773 2774 struct acpi_table_ras2 { 2775 struct acpi_table_header header; /* Common ACPI table header */ 2776 u16 reserved; 2777 u16 num_pcc_descs; 2778 }; 2779 2780 /* RAS2 Platform Communication Channel Descriptor */ 2781 2782 struct acpi_ras2_pcc_desc { 2783 u8 channel_id; 2784 u16 reserved; 2785 u8 feature_type; 2786 u32 instance; 2787 }; 2788 2789 /* RAS2 Platform Communication Channel Shared Memory Region */ 2790 2791 struct acpi_ras2_shared_memory { 2792 u32 signature; 2793 u16 command; 2794 u16 status; 2795 u16 version; 2796 u8 features[16]; 2797 u8 set_capabilities[16]; 2798 u16 num_parameter_blocks; 2799 u32 set_capabilities_status; 2800 }; 2801 2802 /* RAS2 Parameter Block Structure for PATROL_SCRUB */ 2803 2804 struct acpi_ras2_parameter_block { 2805 u16 type; 2806 u16 version; 2807 u16 length; 2808 }; 2809 2810 /* RAS2 Parameter Block Structure for PATROL_SCRUB */ 2811 2812 struct acpi_ras2_patrol_scrub_parameter { 2813 struct acpi_ras2_parameter_block header; 2814 u16 patrol_scrub_command; 2815 u64 requested_address_range[2]; 2816 u64 actual_address_range[2]; 2817 u32 flags; 2818 u32 scrub_params_out; 2819 u32 scrub_params_in; 2820 }; 2821 2822 /* Masks for Flags field above */ 2823 2824 #define ACPI_RAS2_SCRUBBER_RUNNING 1 2825 2826 /* RAS2 Parameter Block Structure for LA2PA_TRANSLATION */ 2827 2828 struct acpi_ras2_la2pa_translation_parameter { 2829 struct acpi_ras2_parameter_block header; 2830 u16 addr_translation_command; 2831 u64 sub_inst_id; 2832 u64 logical_address; 2833 u64 physical_address; 2834 u32 status; 2835 }; 2836 2837 /* Channel Commands */ 2838 2839 enum acpi_ras2_commands { 2840 ACPI_RAS2_EXECUTE_RAS2_COMMAND = 1 2841 }; 2842 2843 /* Platform RAS2 Features */ 2844 2845 enum acpi_ras2_features { 2846 ACPI_RAS2_PATROL_SCRUB_SUPPORTED = 0, 2847 ACPI_RAS2_LA2PA_TRANSLATION = 1 2848 }; 2849 2850 /* RAS2 Patrol Scrub Commands */ 2851 2852 enum acpi_ras2_patrol_scrub_commands { 2853 ACPI_RAS2_GET_PATROL_PARAMETERS = 1, 2854 ACPI_RAS2_START_PATROL_SCRUBBER = 2, 2855 ACPI_RAS2_STOP_PATROL_SCRUBBER = 3 2856 }; 2857 2858 /* RAS2 LA2PA Translation Commands */ 2859 2860 enum acpi_ras2_la2_pa_translation_commands { 2861 ACPI_RAS2_GET_LA2PA_TRANSLATION = 1, 2862 }; 2863 2864 /* RAS2 LA2PA Translation Status values */ 2865 2866 enum acpi_ras2_la2_pa_translation_status { 2867 ACPI_RAS2_LA2PA_TRANSLATION_SUCCESS = 0, 2868 ACPI_RAS2_LA2PA_TRANSLATION_FAIL = 1, 2869 }; 2870 2871 /* Channel Command flags */ 2872 2873 #define ACPI_RAS2_GENERATE_SCI (1<<15) 2874 2875 /* Status values */ 2876 2877 enum acpi_ras2_status { 2878 ACPI_RAS2_SUCCESS = 0, 2879 ACPI_RAS2_NOT_VALID = 1, 2880 ACPI_RAS2_NOT_SUPPORTED = 2, 2881 ACPI_RAS2_BUSY = 3, 2882 ACPI_RAS2_FAILED = 4, 2883 ACPI_RAS2_ABORTED = 5, 2884 ACPI_RAS2_INVALID_DATA = 6 2885 }; 2886 2887 /* Status flags */ 2888 2889 #define ACPI_RAS2_COMMAND_COMPLETE (1) 2890 #define ACPI_RAS2_SCI_DOORBELL (1<<1) 2891 #define ACPI_RAS2_ERROR (1<<2) 2892 #define ACPI_RAS2_STATUS (0x1F<<3) 2893 2894 /******************************************************************************* 2895 * 2896 * RGRT - Regulatory Graphics Resource Table 2897 * Version 1 2898 * 2899 * Conforms to "ACPI RGRT" available at: 2900 * https://microsoft.github.io/mu/dyn/mu_plus/ms_core_pkg/acpi_RGRT/feature_acpi_rgrt/ 2901 * 2902 ******************************************************************************/ 2903 2904 struct acpi_table_rgrt { 2905 struct acpi_table_header header; /* Common ACPI table header */ 2906 u16 version; 2907 u8 image_type; 2908 u8 reserved; 2909 u8 image[]; 2910 }; 2911 2912 /* image_type values */ 2913 2914 enum acpi_rgrt_image_type { 2915 ACPI_RGRT_TYPE_RESERVED0 = 0, 2916 ACPI_RGRT_IMAGE_TYPE_PNG = 1, 2917 ACPI_RGRT_TYPE_RESERVED = 2 /* 2 and greater are reserved */ 2918 }; 2919 2920 /******************************************************************************* 2921 * 2922 * RHCT - RISC-V Hart Capabilities Table 2923 * Version 1 2924 * 2925 ******************************************************************************/ 2926 2927 struct acpi_table_rhct { 2928 struct acpi_table_header header; /* Common ACPI table header */ 2929 u32 flags; /* RHCT flags */ 2930 u64 time_base_freq; 2931 u32 node_count; 2932 u32 node_offset; 2933 }; 2934 2935 /* RHCT Flags */ 2936 2937 #define ACPI_RHCT_TIMER_CANNOT_WAKEUP_CPU (1) 2938 /* 2939 * RHCT subtables 2940 */ 2941 struct acpi_rhct_node_header { 2942 u16 type; 2943 u16 length; 2944 u16 revision; 2945 }; 2946 2947 /* Values for RHCT subtable Type above */ 2948 2949 enum acpi_rhct_node_type { 2950 ACPI_RHCT_NODE_TYPE_ISA_STRING = 0x0000, 2951 ACPI_RHCT_NODE_TYPE_CMO = 0x0001, 2952 ACPI_RHCT_NODE_TYPE_MMU = 0x0002, 2953 ACPI_RHCT_NODE_TYPE_RESERVED = 0x0003, 2954 ACPI_RHCT_NODE_TYPE_HART_INFO = 0xFFFF, 2955 }; 2956 2957 /* 2958 * RHCT node specific subtables 2959 */ 2960 2961 /* ISA string node structure */ 2962 struct acpi_rhct_isa_string { 2963 u16 isa_length; 2964 char isa[]; 2965 }; 2966 2967 struct acpi_rhct_cmo_node { 2968 u8 reserved; /* Must be zero */ 2969 u8 cbom_size; /* CBOM size in powerof 2 */ 2970 u8 cbop_size; /* CBOP size in powerof 2 */ 2971 u8 cboz_size; /* CBOZ size in powerof 2 */ 2972 }; 2973 2974 struct acpi_rhct_mmu_node { 2975 u8 reserved; /* Must be zero */ 2976 u8 mmu_type; /* Virtual Address Scheme */ 2977 }; 2978 2979 enum acpi_rhct_mmu_type { 2980 ACPI_RHCT_MMU_TYPE_SV39 = 0, 2981 ACPI_RHCT_MMU_TYPE_SV48 = 1, 2982 ACPI_RHCT_MMU_TYPE_SV57 = 2 2983 }; 2984 2985 /* Hart Info node structure */ 2986 struct acpi_rhct_hart_info { 2987 u16 num_offsets; 2988 u32 uid; /* ACPI processor UID */ 2989 }; 2990 2991 /******************************************************************************* 2992 * 2993 * SBST - Smart Battery Specification Table 2994 * Version 1 2995 * 2996 ******************************************************************************/ 2997 2998 struct acpi_table_sbst { 2999 struct acpi_table_header header; /* Common ACPI table header */ 3000 u32 warning_level; 3001 u32 low_level; 3002 u32 critical_level; 3003 }; 3004 3005 /******************************************************************************* 3006 * 3007 * SDEI - Software Delegated Exception Interface Descriptor Table 3008 * 3009 * Conforms to "Software Delegated Exception Interface (SDEI)" ARM DEN0054A, 3010 * May 8th, 2017. Copyright 2017 ARM Ltd. 3011 * 3012 ******************************************************************************/ 3013 3014 struct acpi_table_sdei { 3015 struct acpi_table_header header; /* Common ACPI table header */ 3016 }; 3017 3018 /******************************************************************************* 3019 * 3020 * SDEV - Secure Devices Table (ACPI 6.2) 3021 * Version 1 3022 * 3023 ******************************************************************************/ 3024 3025 struct acpi_table_sdev { 3026 struct acpi_table_header header; /* Common ACPI table header */ 3027 }; 3028 3029 struct acpi_sdev_header { 3030 u8 type; 3031 u8 flags; 3032 u16 length; 3033 }; 3034 3035 /* Values for subtable type above */ 3036 3037 enum acpi_sdev_type { 3038 ACPI_SDEV_TYPE_NAMESPACE_DEVICE = 0, 3039 ACPI_SDEV_TYPE_PCIE_ENDPOINT_DEVICE = 1, 3040 ACPI_SDEV_TYPE_RESERVED = 2 /* 2 and greater are reserved */ 3041 }; 3042 3043 /* Values for flags above */ 3044 3045 #define ACPI_SDEV_HANDOFF_TO_UNSECURE_OS (1) 3046 #define ACPI_SDEV_SECURE_COMPONENTS_PRESENT (1<<1) 3047 3048 /* 3049 * SDEV subtables 3050 */ 3051 3052 /* 0: Namespace Device Based Secure Device Structure */ 3053 3054 struct acpi_sdev_namespace { 3055 struct acpi_sdev_header header; 3056 u16 device_id_offset; 3057 u16 device_id_length; 3058 u16 vendor_data_offset; 3059 u16 vendor_data_length; 3060 }; 3061 3062 struct acpi_sdev_secure_component { 3063 u16 secure_component_offset; 3064 u16 secure_component_length; 3065 }; 3066 3067 /* 3068 * SDEV sub-subtables ("Components") for above 3069 */ 3070 struct acpi_sdev_component { 3071 struct acpi_sdev_header header; 3072 }; 3073 3074 /* Values for sub-subtable type above */ 3075 3076 enum acpi_sac_type { 3077 ACPI_SDEV_TYPE_ID_COMPONENT = 0, 3078 ACPI_SDEV_TYPE_MEM_COMPONENT = 1 3079 }; 3080 3081 struct acpi_sdev_id_component { 3082 struct acpi_sdev_header header; 3083 u16 hardware_id_offset; 3084 u16 hardware_id_length; 3085 u16 subsystem_id_offset; 3086 u16 subsystem_id_length; 3087 u16 hardware_revision; 3088 u8 hardware_rev_present; 3089 u8 class_code_present; 3090 u8 pci_base_class; 3091 u8 pci_sub_class; 3092 u8 pci_programming_xface; 3093 }; 3094 3095 struct acpi_sdev_mem_component { 3096 struct acpi_sdev_header header; 3097 u32 reserved; 3098 u64 memory_base_address; 3099 u64 memory_length; 3100 }; 3101 3102 /* 1: PCIe Endpoint Device Based Device Structure */ 3103 3104 struct acpi_sdev_pcie { 3105 struct acpi_sdev_header header; 3106 u16 segment; 3107 u16 start_bus; 3108 u16 path_offset; 3109 u16 path_length; 3110 u16 vendor_data_offset; 3111 u16 vendor_data_length; 3112 }; 3113 3114 /* 1a: PCIe Endpoint path entry */ 3115 3116 struct acpi_sdev_pcie_path { 3117 u8 device; 3118 u8 function; 3119 }; 3120 3121 /******************************************************************************* 3122 * 3123 * SVKL - Storage Volume Key Location Table (ACPI 6.4) 3124 * From: "Guest-Host-Communication Interface (GHCI) for Intel 3125 * Trust Domain Extensions (Intel TDX)". 3126 * Version 1 3127 * 3128 ******************************************************************************/ 3129 3130 struct acpi_table_svkl { 3131 struct acpi_table_header header; /* Common ACPI table header */ 3132 u32 count; 3133 }; 3134 3135 struct acpi_svkl_key { 3136 u16 type; 3137 u16 format; 3138 u32 size; 3139 u64 address; 3140 }; 3141 3142 enum acpi_svkl_type { 3143 ACPI_SVKL_TYPE_MAIN_STORAGE = 0, 3144 ACPI_SVKL_TYPE_RESERVED = 1 /* 1 and greater are reserved */ 3145 }; 3146 3147 enum acpi_svkl_format { 3148 ACPI_SVKL_FORMAT_RAW_BINARY = 0, 3149 ACPI_SVKL_FORMAT_RESERVED = 1 /* 1 and greater are reserved */ 3150 }; 3151 3152 /******************************************************************************* 3153 * 3154 * TDEL - TD-Event Log 3155 * From: "Guest-Host-Communication Interface (GHCI) for Intel 3156 * Trust Domain Extensions (Intel TDX)". 3157 * September 2020 3158 * 3159 ******************************************************************************/ 3160 3161 struct acpi_table_tdel { 3162 struct acpi_table_header header; /* Common ACPI table header */ 3163 u32 reserved; 3164 u64 log_area_minimum_length; 3165 u64 log_area_start_address; 3166 }; 3167 3168 /* Reset to default packing */ 3169 3170 #pragma pack() 3171 3172 #endif /* __ACTBL2_H__ */ 3173