1 /* 2 * acpi.h - ACPI Interface 3 * 4 * Copyright (C) 2001 Paul Diefenbaugh <[email protected]> 5 * 6 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License as published by 10 * the Free Software Foundation; either version 2 of the License, or 11 * (at your option) any later version. 12 * 13 * This program is distributed in the hope that it will be useful, 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of 15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 * GNU General Public License for more details. 17 * 18 * You should have received a copy of the GNU General Public License 19 * along with this program; if not, write to the Free Software 20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 21 * 22 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 23 */ 24 25 #ifndef _LINUX_ACPI_H 26 #define _LINUX_ACPI_H 27 28 #include <linux/config.h> 29 30 #ifdef CONFIG_ACPI 31 32 #ifndef _LINUX 33 #define _LINUX 34 #endif 35 36 #include <linux/list.h> 37 38 #include <acpi/acpi.h> 39 #include <acpi/acpi_bus.h> 40 #include <acpi/acpi_drivers.h> 41 #include <asm/acpi.h> 42 43 44 #ifdef CONFIG_ACPI 45 46 enum acpi_irq_model_id { 47 ACPI_IRQ_MODEL_PIC = 0, 48 ACPI_IRQ_MODEL_IOAPIC, 49 ACPI_IRQ_MODEL_IOSAPIC, 50 ACPI_IRQ_MODEL_COUNT 51 }; 52 53 extern enum acpi_irq_model_id acpi_irq_model; 54 55 56 /* Root System Description Pointer (RSDP) */ 57 58 struct acpi_table_rsdp { 59 char signature[8]; 60 u8 checksum; 61 char oem_id[6]; 62 u8 revision; 63 u32 rsdt_address; 64 } __attribute__ ((packed)); 65 66 struct acpi20_table_rsdp { 67 char signature[8]; 68 u8 checksum; 69 char oem_id[6]; 70 u8 revision; 71 u32 rsdt_address; 72 u32 length; 73 u64 xsdt_address; 74 u8 ext_checksum; 75 u8 reserved[3]; 76 } __attribute__ ((packed)); 77 78 typedef struct { 79 u8 type; 80 u8 length; 81 } __attribute__ ((packed)) acpi_table_entry_header; 82 83 /* Root System Description Table (RSDT) */ 84 85 struct acpi_table_rsdt { 86 struct acpi_table_header header; 87 u32 entry[8]; 88 } __attribute__ ((packed)); 89 90 /* Extended System Description Table (XSDT) */ 91 92 struct acpi_table_xsdt { 93 struct acpi_table_header header; 94 u64 entry[1]; 95 } __attribute__ ((packed)); 96 97 /* Fixed ACPI Description Table (FADT) */ 98 99 struct acpi_table_fadt { 100 struct acpi_table_header header; 101 u32 facs_addr; 102 u32 dsdt_addr; 103 /* ... */ 104 } __attribute__ ((packed)); 105 106 /* Multiple APIC Description Table (MADT) */ 107 108 struct acpi_table_madt { 109 struct acpi_table_header header; 110 u32 lapic_address; 111 struct { 112 u32 pcat_compat:1; 113 u32 reserved:31; 114 } flags; 115 } __attribute__ ((packed)); 116 117 enum acpi_madt_entry_id { 118 ACPI_MADT_LAPIC = 0, 119 ACPI_MADT_IOAPIC, 120 ACPI_MADT_INT_SRC_OVR, 121 ACPI_MADT_NMI_SRC, 122 ACPI_MADT_LAPIC_NMI, 123 ACPI_MADT_LAPIC_ADDR_OVR, 124 ACPI_MADT_IOSAPIC, 125 ACPI_MADT_LSAPIC, 126 ACPI_MADT_PLAT_INT_SRC, 127 ACPI_MADT_ENTRY_COUNT 128 }; 129 130 typedef struct { 131 u16 polarity:2; 132 u16 trigger:2; 133 u16 reserved:12; 134 } __attribute__ ((packed)) acpi_interrupt_flags; 135 136 struct acpi_table_lapic { 137 acpi_table_entry_header header; 138 u8 acpi_id; 139 u8 id; 140 struct { 141 u32 enabled:1; 142 u32 reserved:31; 143 } flags; 144 } __attribute__ ((packed)); 145 146 struct acpi_table_ioapic { 147 acpi_table_entry_header header; 148 u8 id; 149 u8 reserved; 150 u32 address; 151 u32 global_irq_base; 152 } __attribute__ ((packed)); 153 154 struct acpi_table_int_src_ovr { 155 acpi_table_entry_header header; 156 u8 bus; 157 u8 bus_irq; 158 u32 global_irq; 159 acpi_interrupt_flags flags; 160 } __attribute__ ((packed)); 161 162 struct acpi_table_nmi_src { 163 acpi_table_entry_header header; 164 acpi_interrupt_flags flags; 165 u32 global_irq; 166 } __attribute__ ((packed)); 167 168 struct acpi_table_lapic_nmi { 169 acpi_table_entry_header header; 170 u8 acpi_id; 171 acpi_interrupt_flags flags; 172 u8 lint; 173 } __attribute__ ((packed)); 174 175 struct acpi_table_lapic_addr_ovr { 176 acpi_table_entry_header header; 177 u8 reserved[2]; 178 u64 address; 179 } __attribute__ ((packed)); 180 181 struct acpi_table_iosapic { 182 acpi_table_entry_header header; 183 u8 id; 184 u8 reserved; 185 u32 global_irq_base; 186 u64 address; 187 } __attribute__ ((packed)); 188 189 struct acpi_table_lsapic { 190 acpi_table_entry_header header; 191 u8 acpi_id; 192 u8 id; 193 u8 eid; 194 u8 reserved[3]; 195 struct { 196 u32 enabled:1; 197 u32 reserved:31; 198 } flags; 199 } __attribute__ ((packed)); 200 201 struct acpi_table_plat_int_src { 202 acpi_table_entry_header header; 203 acpi_interrupt_flags flags; 204 u8 type; /* See acpi_interrupt_type */ 205 u8 id; 206 u8 eid; 207 u8 iosapic_vector; 208 u32 global_irq; 209 struct { 210 u32 cpei_override_flag:1; 211 u32 reserved:31; 212 } plint_flags; 213 } __attribute__ ((packed)); 214 215 enum acpi_interrupt_id { 216 ACPI_INTERRUPT_PMI = 1, 217 ACPI_INTERRUPT_INIT, 218 ACPI_INTERRUPT_CPEI, 219 ACPI_INTERRUPT_COUNT 220 }; 221 222 #define ACPI_SPACE_MEM 0 223 224 struct acpi_gen_regaddr { 225 u8 space_id; 226 u8 bit_width; 227 u8 bit_offset; 228 u8 resv; 229 u32 addrl; 230 u32 addrh; 231 } __attribute__ ((packed)); 232 233 struct acpi_table_hpet { 234 struct acpi_table_header header; 235 u32 id; 236 struct acpi_gen_regaddr addr; 237 u8 number; 238 u16 min_tick; 239 u8 page_protect; 240 } __attribute__ ((packed)); 241 242 /* 243 * Simple Boot Flags 244 * http://www.microsoft.com/whdc/hwdev/resources/specs/simp_bios.mspx 245 */ 246 struct acpi_table_sbf 247 { 248 u8 sbf_signature[4]; 249 u32 sbf_len; 250 u8 sbf_revision; 251 u8 sbf_csum; 252 u8 sbf_oemid[6]; 253 u8 sbf_oemtable[8]; 254 u8 sbf_revdata[4]; 255 u8 sbf_creator[4]; 256 u8 sbf_crearev[4]; 257 u8 sbf_cmos; 258 u8 sbf_spare[3]; 259 } __attribute__ ((packed)); 260 261 /* 262 * System Resource Affinity Table (SRAT) 263 * http://www.microsoft.com/whdc/hwdev/platform/proc/SRAT.mspx 264 */ 265 266 struct acpi_table_srat { 267 struct acpi_table_header header; 268 u32 table_revision; 269 u64 reserved; 270 } __attribute__ ((packed)); 271 272 enum acpi_srat_entry_id { 273 ACPI_SRAT_PROCESSOR_AFFINITY = 0, 274 ACPI_SRAT_MEMORY_AFFINITY, 275 ACPI_SRAT_ENTRY_COUNT 276 }; 277 278 struct acpi_table_processor_affinity { 279 acpi_table_entry_header header; 280 u8 proximity_domain; 281 u8 apic_id; 282 struct { 283 u32 enabled:1; 284 u32 reserved:31; 285 } flags; 286 u8 lsapic_eid; 287 u8 reserved[7]; 288 } __attribute__ ((packed)); 289 290 struct acpi_table_memory_affinity { 291 acpi_table_entry_header header; 292 u8 proximity_domain; 293 u8 reserved1[5]; 294 u32 base_addr_lo; 295 u32 base_addr_hi; 296 u32 length_lo; 297 u32 length_hi; 298 u32 memory_type; /* See acpi_address_range_id */ 299 struct { 300 u32 enabled:1; 301 u32 hot_pluggable:1; 302 u32 reserved:30; 303 } flags; 304 u64 reserved2; 305 } __attribute__ ((packed)); 306 307 enum acpi_address_range_id { 308 ACPI_ADDRESS_RANGE_MEMORY = 1, 309 ACPI_ADDRESS_RANGE_RESERVED = 2, 310 ACPI_ADDRESS_RANGE_ACPI = 3, 311 ACPI_ADDRESS_RANGE_NVS = 4, 312 ACPI_ADDRESS_RANGE_COUNT 313 }; 314 315 /* 316 * System Locality Information Table (SLIT) 317 * see http://devresource.hp.com/devresource/docs/techpapers/ia64/slit.pdf 318 */ 319 320 struct acpi_table_slit { 321 struct acpi_table_header header; 322 u64 localities; 323 u8 entry[1]; /* real size = localities^2 */ 324 } __attribute__ ((packed)); 325 326 /* Smart Battery Description Table (SBST) */ 327 328 struct acpi_table_sbst { 329 struct acpi_table_header header; 330 u32 warning; /* Warn user */ 331 u32 low; /* Critical sleep */ 332 u32 critical; /* Critical shutdown */ 333 } __attribute__ ((packed)); 334 335 /* Embedded Controller Boot Resources Table (ECDT) */ 336 337 struct acpi_table_ecdt { 338 struct acpi_table_header header; 339 struct acpi_generic_address ec_control; 340 struct acpi_generic_address ec_data; 341 u32 uid; 342 u8 gpe_bit; 343 char ec_id[0]; 344 } __attribute__ ((packed)); 345 346 /* PCI MMCONFIG */ 347 348 /* Defined in PCI Firmware Specification 3.0 */ 349 struct acpi_table_mcfg_config { 350 u32 base_address; 351 u32 base_reserved; 352 u16 pci_segment_group_number; 353 u8 start_bus_number; 354 u8 end_bus_number; 355 u8 reserved[4]; 356 } __attribute__ ((packed)); 357 struct acpi_table_mcfg { 358 struct acpi_table_header header; 359 u8 reserved[8]; 360 struct acpi_table_mcfg_config config[0]; 361 } __attribute__ ((packed)); 362 363 /* Table Handlers */ 364 365 enum acpi_table_id { 366 ACPI_TABLE_UNKNOWN = 0, 367 ACPI_APIC, 368 ACPI_BOOT, 369 ACPI_DBGP, 370 ACPI_DSDT, 371 ACPI_ECDT, 372 ACPI_ETDT, 373 ACPI_FADT, 374 ACPI_FACS, 375 ACPI_OEMX, 376 ACPI_PSDT, 377 ACPI_SBST, 378 ACPI_SLIT, 379 ACPI_SPCR, 380 ACPI_SRAT, 381 ACPI_SSDT, 382 ACPI_SPMI, 383 ACPI_HPET, 384 ACPI_MCFG, 385 ACPI_TABLE_COUNT 386 }; 387 388 typedef int (*acpi_table_handler) (unsigned long phys_addr, unsigned long size); 389 390 extern acpi_table_handler acpi_table_ops[ACPI_TABLE_COUNT]; 391 392 typedef int (*acpi_madt_entry_handler) (acpi_table_entry_header *header, const unsigned long end); 393 394 char * __acpi_map_table (unsigned long phys_addr, unsigned long size); 395 unsigned long acpi_find_rsdp (void); 396 int acpi_boot_init (void); 397 int acpi_boot_table_init (void); 398 int acpi_numa_init (void); 399 400 int acpi_table_init (void); 401 int acpi_table_parse (enum acpi_table_id id, acpi_table_handler handler); 402 int acpi_get_table_header_early (enum acpi_table_id id, struct acpi_table_header **header); 403 int acpi_table_parse_madt (enum acpi_madt_entry_id id, acpi_madt_entry_handler handler, unsigned int max_entries); 404 int acpi_table_parse_srat (enum acpi_srat_entry_id id, acpi_madt_entry_handler handler, unsigned int max_entries); 405 int acpi_parse_mcfg (unsigned long phys_addr, unsigned long size); 406 void acpi_table_print (struct acpi_table_header *header, unsigned long phys_addr); 407 void acpi_table_print_madt_entry (acpi_table_entry_header *madt); 408 void acpi_table_print_srat_entry (acpi_table_entry_header *srat); 409 410 /* the following four functions are architecture-dependent */ 411 void acpi_numa_slit_init (struct acpi_table_slit *slit); 412 void acpi_numa_processor_affinity_init (struct acpi_table_processor_affinity *pa); 413 void acpi_numa_memory_affinity_init (struct acpi_table_memory_affinity *ma); 414 void acpi_numa_arch_fixup(void); 415 416 #ifdef CONFIG_ACPI_HOTPLUG_CPU 417 /* Arch dependent functions for cpu hotplug support */ 418 int acpi_map_lsapic(acpi_handle handle, int *pcpu); 419 int acpi_unmap_lsapic(int cpu); 420 #endif /* CONFIG_ACPI_HOTPLUG_CPU */ 421 422 int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base); 423 int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base); 424 425 extern int acpi_mp_config; 426 427 extern struct acpi_table_mcfg_config *pci_mmcfg_config; 428 extern int pci_mmcfg_config_num; 429 430 extern int sbf_port ; 431 432 #else /* !CONFIG_ACPI */ 433 434 #define acpi_mp_config 0 435 436 #endif /* !CONFIG_ACPI */ 437 438 int acpi_register_gsi (u32 gsi, int edge_level, int active_high_low); 439 int acpi_gsi_to_irq (u32 gsi, unsigned int *irq); 440 441 /* 442 * This function undoes the effect of one call to acpi_register_gsi(). 443 * If this matches the last registration, any IRQ resources for gsi 444 * are freed. 445 */ 446 void acpi_unregister_gsi (u32 gsi); 447 448 #ifdef CONFIG_ACPI 449 450 struct acpi_prt_entry { 451 struct list_head node; 452 struct acpi_pci_id id; 453 u8 pin; 454 struct { 455 acpi_handle handle; 456 u32 index; 457 } link; 458 u32 irq; 459 }; 460 461 struct acpi_prt_list { 462 int count; 463 struct list_head entries; 464 }; 465 466 struct pci_dev; 467 468 int acpi_pci_irq_enable (struct pci_dev *dev); 469 void acpi_penalize_isa_irq(int irq, int active); 470 471 void acpi_pci_irq_disable (struct pci_dev *dev); 472 473 struct acpi_pci_driver { 474 struct acpi_pci_driver *next; 475 int (*add)(acpi_handle handle); 476 void (*remove)(acpi_handle handle); 477 }; 478 479 int acpi_pci_register_driver(struct acpi_pci_driver *driver); 480 void acpi_pci_unregister_driver(struct acpi_pci_driver *driver); 481 482 #endif /* CONFIG_ACPI */ 483 484 #ifdef CONFIG_ACPI_EC 485 486 extern int ec_read(u8 addr, u8 *val); 487 extern int ec_write(u8 addr, u8 val); 488 489 #endif /*CONFIG_ACPI_EC*/ 490 491 extern int acpi_blacklisted(void); 492 extern void acpi_bios_year(char *s); 493 494 #define ACPI_CSTATE_LIMIT_DEFINED /* for driver builds */ 495 #ifdef CONFIG_ACPI 496 497 /* 498 * Set highest legal C-state 499 * 0: C0 okay, but not C1 500 * 1: C1 okay, but not C2 501 * 2: C2 okay, but not C3 etc. 502 */ 503 504 extern unsigned int max_cstate; 505 506 static inline unsigned int acpi_get_cstate_limit(void) 507 { 508 return max_cstate; 509 } 510 static inline void acpi_set_cstate_limit(unsigned int new_limit) 511 { 512 max_cstate = new_limit; 513 return; 514 } 515 #else 516 static inline unsigned int acpi_get_cstate_limit(void) { return 0; } 517 static inline void acpi_set_cstate_limit(unsigned int new_limit) { return; } 518 #endif 519 520 #ifdef CONFIG_ACPI_NUMA 521 int acpi_get_pxm(acpi_handle handle); 522 #else 523 static inline int acpi_get_pxm(acpi_handle handle) 524 { 525 return 0; 526 } 527 #endif 528 529 extern int pnpacpi_disabled; 530 531 #else /* CONFIG_ACPI */ 532 533 static inline int acpi_boot_init(void) 534 { 535 return 0; 536 } 537 538 static inline int acpi_boot_table_init(void) 539 { 540 return 0; 541 } 542 543 #endif /* CONFIG_ACPI */ 544 #endif /*_LINUX_ACPI_H*/ 545