at v4.13 36 kB view raw
1/* 2 * acpi.h - ACPI Interface 3 * 4 * Copyright (C) 2001 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> 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 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 19 */ 20 21#ifndef _LINUX_ACPI_H 22#define _LINUX_ACPI_H 23 24#include <linux/errno.h> 25#include <linux/ioport.h> /* for struct resource */ 26#include <linux/resource_ext.h> 27#include <linux/device.h> 28#include <linux/property.h> 29#include <linux/uuid.h> 30 31#ifndef _LINUX 32#define _LINUX 33#endif 34#include <acpi/acpi.h> 35 36#ifdef CONFIG_ACPI 37 38#include <linux/list.h> 39#include <linux/mod_devicetable.h> 40#include <linux/dynamic_debug.h> 41#include <linux/module.h> 42#include <linux/mutex.h> 43 44#include <acpi/acpi_bus.h> 45#include <acpi/acpi_drivers.h> 46#include <acpi/acpi_numa.h> 47#include <acpi/acpi_io.h> 48#include <asm/acpi.h> 49 50static inline acpi_handle acpi_device_handle(struct acpi_device *adev) 51{ 52 return adev ? adev->handle : NULL; 53} 54 55#define ACPI_COMPANION(dev) to_acpi_device_node((dev)->fwnode) 56#define ACPI_COMPANION_SET(dev, adev) set_primary_fwnode(dev, (adev) ? \ 57 acpi_fwnode_handle(adev) : NULL) 58#define ACPI_HANDLE(dev) acpi_device_handle(ACPI_COMPANION(dev)) 59 60 61extern const struct fwnode_operations acpi_fwnode_ops; 62 63static inline struct fwnode_handle *acpi_alloc_fwnode_static(void) 64{ 65 struct fwnode_handle *fwnode; 66 67 fwnode = kzalloc(sizeof(struct fwnode_handle), GFP_KERNEL); 68 if (!fwnode) 69 return NULL; 70 71 fwnode->type = FWNODE_ACPI_STATIC; 72 fwnode->ops = &acpi_fwnode_ops; 73 74 return fwnode; 75} 76 77static inline void acpi_free_fwnode_static(struct fwnode_handle *fwnode) 78{ 79 if (WARN_ON(!fwnode || fwnode->type != FWNODE_ACPI_STATIC)) 80 return; 81 82 kfree(fwnode); 83} 84 85/** 86 * ACPI_DEVICE_CLASS - macro used to describe an ACPI device with 87 * the PCI-defined class-code information 88 * 89 * @_cls : the class, subclass, prog-if triple for this device 90 * @_msk : the class mask for this device 91 * 92 * This macro is used to create a struct acpi_device_id that matches a 93 * specific PCI class. The .id and .driver_data fields will be left 94 * initialized with the default value. 95 */ 96#define ACPI_DEVICE_CLASS(_cls, _msk) .cls = (_cls), .cls_msk = (_msk), 97 98static inline bool has_acpi_companion(struct device *dev) 99{ 100 return is_acpi_device_node(dev->fwnode); 101} 102 103static inline void acpi_preset_companion(struct device *dev, 104 struct acpi_device *parent, u64 addr) 105{ 106 ACPI_COMPANION_SET(dev, acpi_find_child_device(parent, addr, NULL)); 107} 108 109static inline const char *acpi_dev_name(struct acpi_device *adev) 110{ 111 return dev_name(&adev->dev); 112} 113 114struct device *acpi_get_first_physical_node(struct acpi_device *adev); 115 116enum acpi_irq_model_id { 117 ACPI_IRQ_MODEL_PIC = 0, 118 ACPI_IRQ_MODEL_IOAPIC, 119 ACPI_IRQ_MODEL_IOSAPIC, 120 ACPI_IRQ_MODEL_PLATFORM, 121 ACPI_IRQ_MODEL_GIC, 122 ACPI_IRQ_MODEL_COUNT 123}; 124 125extern enum acpi_irq_model_id acpi_irq_model; 126 127enum acpi_interrupt_id { 128 ACPI_INTERRUPT_PMI = 1, 129 ACPI_INTERRUPT_INIT, 130 ACPI_INTERRUPT_CPEI, 131 ACPI_INTERRUPT_COUNT 132}; 133 134#define ACPI_SPACE_MEM 0 135 136enum acpi_address_range_id { 137 ACPI_ADDRESS_RANGE_MEMORY = 1, 138 ACPI_ADDRESS_RANGE_RESERVED = 2, 139 ACPI_ADDRESS_RANGE_ACPI = 3, 140 ACPI_ADDRESS_RANGE_NVS = 4, 141 ACPI_ADDRESS_RANGE_COUNT 142}; 143 144 145/* Table Handlers */ 146 147typedef int (*acpi_tbl_table_handler)(struct acpi_table_header *table); 148 149typedef int (*acpi_tbl_entry_handler)(struct acpi_subtable_header *header, 150 const unsigned long end); 151 152/* Debugger support */ 153 154struct acpi_debugger_ops { 155 int (*create_thread)(acpi_osd_exec_callback function, void *context); 156 ssize_t (*write_log)(const char *msg); 157 ssize_t (*read_cmd)(char *buffer, size_t length); 158 int (*wait_command_ready)(bool single_step, char *buffer, size_t length); 159 int (*notify_command_complete)(void); 160}; 161 162struct acpi_debugger { 163 const struct acpi_debugger_ops *ops; 164 struct module *owner; 165 struct mutex lock; 166}; 167 168#ifdef CONFIG_ACPI_DEBUGGER 169int __init acpi_debugger_init(void); 170int acpi_register_debugger(struct module *owner, 171 const struct acpi_debugger_ops *ops); 172void acpi_unregister_debugger(const struct acpi_debugger_ops *ops); 173int acpi_debugger_create_thread(acpi_osd_exec_callback function, void *context); 174ssize_t acpi_debugger_write_log(const char *msg); 175ssize_t acpi_debugger_read_cmd(char *buffer, size_t buffer_length); 176int acpi_debugger_wait_command_ready(void); 177int acpi_debugger_notify_command_complete(void); 178#else 179static inline int acpi_debugger_init(void) 180{ 181 return -ENODEV; 182} 183 184static inline int acpi_register_debugger(struct module *owner, 185 const struct acpi_debugger_ops *ops) 186{ 187 return -ENODEV; 188} 189 190static inline void acpi_unregister_debugger(const struct acpi_debugger_ops *ops) 191{ 192} 193 194static inline int acpi_debugger_create_thread(acpi_osd_exec_callback function, 195 void *context) 196{ 197 return -ENODEV; 198} 199 200static inline int acpi_debugger_write_log(const char *msg) 201{ 202 return -ENODEV; 203} 204 205static inline int acpi_debugger_read_cmd(char *buffer, u32 buffer_length) 206{ 207 return -ENODEV; 208} 209 210static inline int acpi_debugger_wait_command_ready(void) 211{ 212 return -ENODEV; 213} 214 215static inline int acpi_debugger_notify_command_complete(void) 216{ 217 return -ENODEV; 218} 219#endif 220 221#define BAD_MADT_ENTRY(entry, end) ( \ 222 (!entry) || (unsigned long)entry + sizeof(*entry) > end || \ 223 ((struct acpi_subtable_header *)entry)->length < sizeof(*entry)) 224 225struct acpi_subtable_proc { 226 int id; 227 acpi_tbl_entry_handler handler; 228 int count; 229}; 230 231char * __acpi_map_table (unsigned long phys_addr, unsigned long size); 232void __acpi_unmap_table(char *map, unsigned long size); 233int early_acpi_boot_init(void); 234int acpi_boot_init (void); 235void acpi_boot_table_init (void); 236int acpi_mps_check (void); 237int acpi_numa_init (void); 238 239int acpi_table_init (void); 240int acpi_table_parse(char *id, acpi_tbl_table_handler handler); 241int __init acpi_table_parse_entries(char *id, unsigned long table_size, 242 int entry_id, 243 acpi_tbl_entry_handler handler, 244 unsigned int max_entries); 245int __init acpi_table_parse_entries_array(char *id, unsigned long table_size, 246 struct acpi_subtable_proc *proc, int proc_num, 247 unsigned int max_entries); 248int acpi_table_parse_madt(enum acpi_madt_type id, 249 acpi_tbl_entry_handler handler, 250 unsigned int max_entries); 251int acpi_parse_mcfg (struct acpi_table_header *header); 252void acpi_table_print_madt_entry (struct acpi_subtable_header *madt); 253 254/* the following numa functions are architecture-dependent */ 255void acpi_numa_slit_init (struct acpi_table_slit *slit); 256 257#if defined(CONFIG_X86) || defined(CONFIG_IA64) 258void acpi_numa_processor_affinity_init (struct acpi_srat_cpu_affinity *pa); 259#else 260static inline void 261acpi_numa_processor_affinity_init(struct acpi_srat_cpu_affinity *pa) { } 262#endif 263 264void acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa); 265 266#ifdef CONFIG_ARM64 267void acpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa); 268#else 269static inline void 270acpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa) { } 271#endif 272 273int acpi_numa_memory_affinity_init (struct acpi_srat_mem_affinity *ma); 274 275#ifndef PHYS_CPUID_INVALID 276typedef u32 phys_cpuid_t; 277#define PHYS_CPUID_INVALID (phys_cpuid_t)(-1) 278#endif 279 280static inline bool invalid_logical_cpuid(u32 cpuid) 281{ 282 return (int)cpuid < 0; 283} 284 285static inline bool invalid_phys_cpuid(phys_cpuid_t phys_id) 286{ 287 return phys_id == PHYS_CPUID_INVALID; 288} 289 290/* Validate the processor object's proc_id */ 291bool acpi_duplicate_processor_id(int proc_id); 292 293#ifdef CONFIG_ACPI_HOTPLUG_CPU 294/* Arch dependent functions for cpu hotplug support */ 295int acpi_map_cpu(acpi_handle handle, phys_cpuid_t physid, u32 acpi_id, 296 int *pcpu); 297int acpi_unmap_cpu(int cpu); 298#endif /* CONFIG_ACPI_HOTPLUG_CPU */ 299 300#ifdef CONFIG_ACPI_HOTPLUG_IOAPIC 301int acpi_get_ioapic_id(acpi_handle handle, u32 gsi_base, u64 *phys_addr); 302#endif 303 304int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base); 305int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base); 306int acpi_ioapic_registered(acpi_handle handle, u32 gsi_base); 307void acpi_irq_stats_init(void); 308extern u32 acpi_irq_handled; 309extern u32 acpi_irq_not_handled; 310extern unsigned int acpi_sci_irq; 311extern bool acpi_no_s5; 312#define INVALID_ACPI_IRQ ((unsigned)-1) 313static inline bool acpi_sci_irq_valid(void) 314{ 315 return acpi_sci_irq != INVALID_ACPI_IRQ; 316} 317 318extern int sbf_port; 319extern unsigned long acpi_realmode_flags; 320 321int acpi_register_gsi (struct device *dev, u32 gsi, int triggering, int polarity); 322int acpi_gsi_to_irq (u32 gsi, unsigned int *irq); 323int acpi_isa_irq_to_gsi (unsigned isa_irq, u32 *gsi); 324 325void acpi_set_irq_model(enum acpi_irq_model_id model, 326 struct fwnode_handle *fwnode); 327 328#ifdef CONFIG_X86_IO_APIC 329extern int acpi_get_override_irq(u32 gsi, int *trigger, int *polarity); 330#else 331#define acpi_get_override_irq(gsi, trigger, polarity) (-1) 332#endif 333/* 334 * This function undoes the effect of one call to acpi_register_gsi(). 335 * If this matches the last registration, any IRQ resources for gsi 336 * are freed. 337 */ 338void acpi_unregister_gsi (u32 gsi); 339 340struct pci_dev; 341 342int acpi_pci_irq_enable (struct pci_dev *dev); 343void acpi_penalize_isa_irq(int irq, int active); 344bool acpi_isa_irq_available(int irq); 345void acpi_penalize_sci_irq(int irq, int trigger, int polarity); 346void acpi_pci_irq_disable (struct pci_dev *dev); 347 348extern int ec_read(u8 addr, u8 *val); 349extern int ec_write(u8 addr, u8 val); 350extern int ec_transaction(u8 command, 351 const u8 *wdata, unsigned wdata_len, 352 u8 *rdata, unsigned rdata_len); 353extern acpi_handle ec_get_handle(void); 354 355extern bool acpi_is_pnp_device(struct acpi_device *); 356 357#if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE) 358 359typedef void (*wmi_notify_handler) (u32 value, void *context); 360 361extern acpi_status wmi_evaluate_method(const char *guid, u8 instance, 362 u32 method_id, 363 const struct acpi_buffer *in, 364 struct acpi_buffer *out); 365extern acpi_status wmi_query_block(const char *guid, u8 instance, 366 struct acpi_buffer *out); 367extern acpi_status wmi_set_block(const char *guid, u8 instance, 368 const struct acpi_buffer *in); 369extern acpi_status wmi_install_notify_handler(const char *guid, 370 wmi_notify_handler handler, void *data); 371extern acpi_status wmi_remove_notify_handler(const char *guid); 372extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out); 373extern bool wmi_has_guid(const char *guid); 374 375#endif /* CONFIG_ACPI_WMI */ 376 377#define ACPI_VIDEO_OUTPUT_SWITCHING 0x0001 378#define ACPI_VIDEO_DEVICE_POSTING 0x0002 379#define ACPI_VIDEO_ROM_AVAILABLE 0x0004 380#define ACPI_VIDEO_BACKLIGHT 0x0008 381#define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR 0x0010 382#define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO 0x0020 383#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR 0x0040 384#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO 0x0080 385#define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR 0x0100 386#define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO 0x0200 387#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR 0x0400 388#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO 0x0800 389 390extern char acpi_video_backlight_string[]; 391extern long acpi_is_video_device(acpi_handle handle); 392extern int acpi_blacklisted(void); 393extern void acpi_osi_setup(char *str); 394extern bool acpi_osi_is_win8(void); 395 396#ifdef CONFIG_ACPI_NUMA 397int acpi_map_pxm_to_online_node(int pxm); 398int acpi_get_node(acpi_handle handle); 399#else 400static inline int acpi_map_pxm_to_online_node(int pxm) 401{ 402 return 0; 403} 404static inline int acpi_get_node(acpi_handle handle) 405{ 406 return 0; 407} 408#endif 409extern int acpi_paddr_to_node(u64 start_addr, u64 size); 410 411extern int pnpacpi_disabled; 412 413#define PXM_INVAL (-1) 414 415bool acpi_dev_resource_memory(struct acpi_resource *ares, struct resource *res); 416bool acpi_dev_resource_io(struct acpi_resource *ares, struct resource *res); 417bool acpi_dev_resource_address_space(struct acpi_resource *ares, 418 struct resource_win *win); 419bool acpi_dev_resource_ext_address_space(struct acpi_resource *ares, 420 struct resource_win *win); 421unsigned long acpi_dev_irq_flags(u8 triggering, u8 polarity, u8 shareable); 422unsigned int acpi_dev_get_irq_type(int triggering, int polarity); 423bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index, 424 struct resource *res); 425 426void acpi_dev_free_resource_list(struct list_head *list); 427int acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list, 428 int (*preproc)(struct acpi_resource *, void *), 429 void *preproc_data); 430int acpi_dev_filter_resource_type(struct acpi_resource *ares, 431 unsigned long types); 432 433static inline int acpi_dev_filter_resource_type_cb(struct acpi_resource *ares, 434 void *arg) 435{ 436 return acpi_dev_filter_resource_type(ares, (unsigned long)arg); 437} 438 439struct acpi_device *acpi_resource_consumer(struct resource *res); 440 441int acpi_check_resource_conflict(const struct resource *res); 442 443int acpi_check_region(resource_size_t start, resource_size_t n, 444 const char *name); 445 446int acpi_resources_are_enforced(void); 447 448#ifdef CONFIG_HIBERNATION 449void __init acpi_no_s4_hw_signature(void); 450#endif 451 452#ifdef CONFIG_PM_SLEEP 453void __init acpi_old_suspend_ordering(void); 454void __init acpi_nvs_nosave(void); 455void __init acpi_nvs_nosave_s3(void); 456#endif /* CONFIG_PM_SLEEP */ 457 458struct acpi_osc_context { 459 char *uuid_str; /* UUID string */ 460 int rev; 461 struct acpi_buffer cap; /* list of DWORD capabilities */ 462 struct acpi_buffer ret; /* free by caller if success */ 463}; 464 465acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context); 466 467/* Indexes into _OSC Capabilities Buffer (DWORDs 2 & 3 are device-specific) */ 468#define OSC_QUERY_DWORD 0 /* DWORD 1 */ 469#define OSC_SUPPORT_DWORD 1 /* DWORD 2 */ 470#define OSC_CONTROL_DWORD 2 /* DWORD 3 */ 471 472/* _OSC Capabilities DWORD 1: Query/Control and Error Returns (generic) */ 473#define OSC_QUERY_ENABLE 0x00000001 /* input */ 474#define OSC_REQUEST_ERROR 0x00000002 /* return */ 475#define OSC_INVALID_UUID_ERROR 0x00000004 /* return */ 476#define OSC_INVALID_REVISION_ERROR 0x00000008 /* return */ 477#define OSC_CAPABILITIES_MASK_ERROR 0x00000010 /* return */ 478 479/* Platform-Wide Capabilities _OSC: Capabilities DWORD 2: Support Field */ 480#define OSC_SB_PAD_SUPPORT 0x00000001 481#define OSC_SB_PPC_OST_SUPPORT 0x00000002 482#define OSC_SB_PR3_SUPPORT 0x00000004 483#define OSC_SB_HOTPLUG_OST_SUPPORT 0x00000008 484#define OSC_SB_APEI_SUPPORT 0x00000010 485#define OSC_SB_CPC_SUPPORT 0x00000020 486#define OSC_SB_CPCV2_SUPPORT 0x00000040 487#define OSC_SB_PCLPI_SUPPORT 0x00000080 488#define OSC_SB_OSLPI_SUPPORT 0x00000100 489#define OSC_SB_CPC_DIVERSE_HIGH_SUPPORT 0x00001000 490 491extern bool osc_sb_apei_support_acked; 492extern bool osc_pc_lpi_support_confirmed; 493 494/* PCI Host Bridge _OSC: Capabilities DWORD 2: Support Field */ 495#define OSC_PCI_EXT_CONFIG_SUPPORT 0x00000001 496#define OSC_PCI_ASPM_SUPPORT 0x00000002 497#define OSC_PCI_CLOCK_PM_SUPPORT 0x00000004 498#define OSC_PCI_SEGMENT_GROUPS_SUPPORT 0x00000008 499#define OSC_PCI_MSI_SUPPORT 0x00000010 500#define OSC_PCI_SUPPORT_MASKS 0x0000001f 501 502/* PCI Host Bridge _OSC: Capabilities DWORD 3: Control Field */ 503#define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL 0x00000001 504#define OSC_PCI_SHPC_NATIVE_HP_CONTROL 0x00000002 505#define OSC_PCI_EXPRESS_PME_CONTROL 0x00000004 506#define OSC_PCI_EXPRESS_AER_CONTROL 0x00000008 507#define OSC_PCI_EXPRESS_CAPABILITY_CONTROL 0x00000010 508#define OSC_PCI_CONTROL_MASKS 0x0000001f 509 510#define ACPI_GSB_ACCESS_ATTRIB_QUICK 0x00000002 511#define ACPI_GSB_ACCESS_ATTRIB_SEND_RCV 0x00000004 512#define ACPI_GSB_ACCESS_ATTRIB_BYTE 0x00000006 513#define ACPI_GSB_ACCESS_ATTRIB_WORD 0x00000008 514#define ACPI_GSB_ACCESS_ATTRIB_BLOCK 0x0000000A 515#define ACPI_GSB_ACCESS_ATTRIB_MULTIBYTE 0x0000000B 516#define ACPI_GSB_ACCESS_ATTRIB_WORD_CALL 0x0000000C 517#define ACPI_GSB_ACCESS_ATTRIB_BLOCK_CALL 0x0000000D 518#define ACPI_GSB_ACCESS_ATTRIB_RAW_BYTES 0x0000000E 519#define ACPI_GSB_ACCESS_ATTRIB_RAW_PROCESS 0x0000000F 520 521extern acpi_status acpi_pci_osc_control_set(acpi_handle handle, 522 u32 *mask, u32 req); 523 524/* Enable _OST when all relevant hotplug operations are enabled */ 525#if defined(CONFIG_ACPI_HOTPLUG_CPU) && \ 526 defined(CONFIG_ACPI_HOTPLUG_MEMORY) && \ 527 defined(CONFIG_ACPI_CONTAINER) 528#define ACPI_HOTPLUG_OST 529#endif 530 531/* _OST Source Event Code (OSPM Action) */ 532#define ACPI_OST_EC_OSPM_SHUTDOWN 0x100 533#define ACPI_OST_EC_OSPM_EJECT 0x103 534#define ACPI_OST_EC_OSPM_INSERTION 0x200 535 536/* _OST General Processing Status Code */ 537#define ACPI_OST_SC_SUCCESS 0x0 538#define ACPI_OST_SC_NON_SPECIFIC_FAILURE 0x1 539#define ACPI_OST_SC_UNRECOGNIZED_NOTIFY 0x2 540 541/* _OST OS Shutdown Processing (0x100) Status Code */ 542#define ACPI_OST_SC_OS_SHUTDOWN_DENIED 0x80 543#define ACPI_OST_SC_OS_SHUTDOWN_IN_PROGRESS 0x81 544#define ACPI_OST_SC_OS_SHUTDOWN_COMPLETED 0x82 545#define ACPI_OST_SC_OS_SHUTDOWN_NOT_SUPPORTED 0x83 546 547/* _OST Ejection Request (0x3, 0x103) Status Code */ 548#define ACPI_OST_SC_EJECT_NOT_SUPPORTED 0x80 549#define ACPI_OST_SC_DEVICE_IN_USE 0x81 550#define ACPI_OST_SC_DEVICE_BUSY 0x82 551#define ACPI_OST_SC_EJECT_DEPENDENCY_BUSY 0x83 552#define ACPI_OST_SC_EJECT_IN_PROGRESS 0x84 553 554/* _OST Insertion Request (0x200) Status Code */ 555#define ACPI_OST_SC_INSERT_IN_PROGRESS 0x80 556#define ACPI_OST_SC_DRIVER_LOAD_FAILURE 0x81 557#define ACPI_OST_SC_INSERT_NOT_SUPPORTED 0x82 558 559extern void acpi_early_init(void); 560extern void acpi_subsystem_init(void); 561 562extern int acpi_nvs_register(__u64 start, __u64 size); 563 564extern int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *), 565 void *data); 566 567const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids, 568 const struct device *dev); 569 570extern bool acpi_driver_match_device(struct device *dev, 571 const struct device_driver *drv); 572int acpi_device_uevent_modalias(struct device *, struct kobj_uevent_env *); 573int acpi_device_modalias(struct device *, char *, int); 574void acpi_walk_dep_device_list(acpi_handle handle); 575 576struct platform_device *acpi_create_platform_device(struct acpi_device *, 577 struct property_entry *); 578#define ACPI_PTR(_ptr) (_ptr) 579 580static inline void acpi_device_set_enumerated(struct acpi_device *adev) 581{ 582 adev->flags.visited = true; 583} 584 585static inline void acpi_device_clear_enumerated(struct acpi_device *adev) 586{ 587 adev->flags.visited = false; 588} 589 590enum acpi_reconfig_event { 591 ACPI_RECONFIG_DEVICE_ADD = 0, 592 ACPI_RECONFIG_DEVICE_REMOVE, 593}; 594 595int acpi_reconfig_notifier_register(struct notifier_block *nb); 596int acpi_reconfig_notifier_unregister(struct notifier_block *nb); 597 598#ifdef CONFIG_ACPI_GTDT 599int acpi_gtdt_init(struct acpi_table_header *table, int *platform_timer_count); 600int acpi_gtdt_map_ppi(int type); 601bool acpi_gtdt_c3stop(int type); 602int acpi_arch_timer_mem_init(struct arch_timer_mem *timer_mem, int *timer_count); 603#endif 604 605#else /* !CONFIG_ACPI */ 606 607#define acpi_disabled 1 608 609#define ACPI_COMPANION(dev) (NULL) 610#define ACPI_COMPANION_SET(dev, adev) do { } while (0) 611#define ACPI_HANDLE(dev) (NULL) 612#define ACPI_DEVICE_CLASS(_cls, _msk) .cls = (0), .cls_msk = (0), 613 614struct fwnode_handle; 615 616static inline bool acpi_dev_found(const char *hid) 617{ 618 return false; 619} 620 621static inline bool acpi_dev_present(const char *hid, const char *uid, s64 hrv) 622{ 623 return false; 624} 625 626static inline bool is_acpi_node(struct fwnode_handle *fwnode) 627{ 628 return false; 629} 630 631static inline bool is_acpi_device_node(struct fwnode_handle *fwnode) 632{ 633 return false; 634} 635 636static inline struct acpi_device *to_acpi_device_node(struct fwnode_handle *fwnode) 637{ 638 return NULL; 639} 640 641static inline bool is_acpi_data_node(struct fwnode_handle *fwnode) 642{ 643 return false; 644} 645 646static inline struct acpi_data_node *to_acpi_data_node(struct fwnode_handle *fwnode) 647{ 648 return NULL; 649} 650 651static inline bool acpi_data_node_match(struct fwnode_handle *fwnode, 652 const char *name) 653{ 654 return false; 655} 656 657static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev) 658{ 659 return NULL; 660} 661 662static inline bool has_acpi_companion(struct device *dev) 663{ 664 return false; 665} 666 667static inline void acpi_preset_companion(struct device *dev, 668 struct acpi_device *parent, u64 addr) 669{ 670} 671 672static inline const char *acpi_dev_name(struct acpi_device *adev) 673{ 674 return NULL; 675} 676 677static inline struct device *acpi_get_first_physical_node(struct acpi_device *adev) 678{ 679 return NULL; 680} 681 682static inline void acpi_early_init(void) { } 683static inline void acpi_subsystem_init(void) { } 684 685static inline int early_acpi_boot_init(void) 686{ 687 return 0; 688} 689static inline int acpi_boot_init(void) 690{ 691 return 0; 692} 693 694static inline void acpi_boot_table_init(void) 695{ 696 return; 697} 698 699static inline int acpi_mps_check(void) 700{ 701 return 0; 702} 703 704static inline int acpi_check_resource_conflict(struct resource *res) 705{ 706 return 0; 707} 708 709static inline int acpi_check_region(resource_size_t start, resource_size_t n, 710 const char *name) 711{ 712 return 0; 713} 714 715struct acpi_table_header; 716static inline int acpi_table_parse(char *id, 717 int (*handler)(struct acpi_table_header *)) 718{ 719 return -ENODEV; 720} 721 722static inline int acpi_nvs_register(__u64 start, __u64 size) 723{ 724 return 0; 725} 726 727static inline int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *), 728 void *data) 729{ 730 return 0; 731} 732 733struct acpi_device_id; 734 735static inline const struct acpi_device_id *acpi_match_device( 736 const struct acpi_device_id *ids, const struct device *dev) 737{ 738 return NULL; 739} 740 741static inline bool acpi_driver_match_device(struct device *dev, 742 const struct device_driver *drv) 743{ 744 return false; 745} 746 747static inline union acpi_object *acpi_evaluate_dsm(acpi_handle handle, 748 const guid_t *guid, 749 int rev, int func, 750 union acpi_object *argv4) 751{ 752 return NULL; 753} 754 755static inline int acpi_device_uevent_modalias(struct device *dev, 756 struct kobj_uevent_env *env) 757{ 758 return -ENODEV; 759} 760 761static inline int acpi_device_modalias(struct device *dev, 762 char *buf, int size) 763{ 764 return -ENODEV; 765} 766 767static inline bool acpi_dma_supported(struct acpi_device *adev) 768{ 769 return false; 770} 771 772static inline enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev) 773{ 774 return DEV_DMA_NOT_SUPPORTED; 775} 776 777static inline int acpi_dma_configure(struct device *dev, 778 enum dev_dma_attr attr) 779{ 780 return 0; 781} 782 783static inline void acpi_dma_deconfigure(struct device *dev) { } 784 785#define ACPI_PTR(_ptr) (NULL) 786 787static inline void acpi_device_set_enumerated(struct acpi_device *adev) 788{ 789} 790 791static inline void acpi_device_clear_enumerated(struct acpi_device *adev) 792{ 793} 794 795static inline int acpi_reconfig_notifier_register(struct notifier_block *nb) 796{ 797 return -EINVAL; 798} 799 800static inline int acpi_reconfig_notifier_unregister(struct notifier_block *nb) 801{ 802 return -EINVAL; 803} 804 805static inline struct acpi_device *acpi_resource_consumer(struct resource *res) 806{ 807 return NULL; 808} 809 810#endif /* !CONFIG_ACPI */ 811 812#ifdef CONFIG_ACPI_HOTPLUG_IOAPIC 813int acpi_ioapic_add(acpi_handle root); 814#else 815static inline int acpi_ioapic_add(acpi_handle root) { return 0; } 816#endif 817 818#ifdef CONFIG_ACPI 819void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state, 820 u32 pm1a_ctrl, u32 pm1b_ctrl)); 821 822acpi_status acpi_os_prepare_sleep(u8 sleep_state, 823 u32 pm1a_control, u32 pm1b_control); 824 825void acpi_os_set_prepare_extended_sleep(int (*func)(u8 sleep_state, 826 u32 val_a, u32 val_b)); 827 828acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state, 829 u32 val_a, u32 val_b); 830 831#ifdef CONFIG_X86 832void arch_reserve_mem_area(acpi_physical_address addr, size_t size); 833#else 834static inline void arch_reserve_mem_area(acpi_physical_address addr, 835 size_t size) 836{ 837} 838#endif /* CONFIG_X86 */ 839#else 840#define acpi_os_set_prepare_sleep(func, pm1a_ctrl, pm1b_ctrl) do { } while (0) 841#endif 842 843#if defined(CONFIG_ACPI) && defined(CONFIG_PM) 844int acpi_dev_runtime_suspend(struct device *dev); 845int acpi_dev_runtime_resume(struct device *dev); 846int acpi_subsys_runtime_suspend(struct device *dev); 847int acpi_subsys_runtime_resume(struct device *dev); 848struct acpi_device *acpi_dev_pm_get_node(struct device *dev); 849int acpi_dev_pm_attach(struct device *dev, bool power_on); 850#else 851static inline int acpi_dev_runtime_suspend(struct device *dev) { return 0; } 852static inline int acpi_dev_runtime_resume(struct device *dev) { return 0; } 853static inline int acpi_subsys_runtime_suspend(struct device *dev) { return 0; } 854static inline int acpi_subsys_runtime_resume(struct device *dev) { return 0; } 855static inline struct acpi_device *acpi_dev_pm_get_node(struct device *dev) 856{ 857 return NULL; 858} 859static inline int acpi_dev_pm_attach(struct device *dev, bool power_on) 860{ 861 return -ENODEV; 862} 863#endif 864 865#if defined(CONFIG_ACPI) && defined(CONFIG_PM_SLEEP) 866int acpi_dev_suspend_late(struct device *dev); 867int acpi_dev_resume_early(struct device *dev); 868int acpi_subsys_prepare(struct device *dev); 869void acpi_subsys_complete(struct device *dev); 870int acpi_subsys_suspend_late(struct device *dev); 871int acpi_subsys_resume_early(struct device *dev); 872int acpi_subsys_suspend(struct device *dev); 873int acpi_subsys_freeze(struct device *dev); 874#else 875static inline int acpi_dev_suspend_late(struct device *dev) { return 0; } 876static inline int acpi_dev_resume_early(struct device *dev) { return 0; } 877static inline int acpi_subsys_prepare(struct device *dev) { return 0; } 878static inline void acpi_subsys_complete(struct device *dev) {} 879static inline int acpi_subsys_suspend_late(struct device *dev) { return 0; } 880static inline int acpi_subsys_resume_early(struct device *dev) { return 0; } 881static inline int acpi_subsys_suspend(struct device *dev) { return 0; } 882static inline int acpi_subsys_freeze(struct device *dev) { return 0; } 883#endif 884 885#ifdef CONFIG_ACPI 886__printf(3, 4) 887void acpi_handle_printk(const char *level, acpi_handle handle, 888 const char *fmt, ...); 889#else /* !CONFIG_ACPI */ 890static inline __printf(3, 4) void 891acpi_handle_printk(const char *level, void *handle, const char *fmt, ...) {} 892#endif /* !CONFIG_ACPI */ 893 894#if defined(CONFIG_ACPI) && defined(CONFIG_DYNAMIC_DEBUG) 895__printf(3, 4) 896void __acpi_handle_debug(struct _ddebug *descriptor, acpi_handle handle, const char *fmt, ...); 897#else 898#define __acpi_handle_debug(descriptor, handle, fmt, ...) \ 899 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__); 900#endif 901 902/* 903 * acpi_handle_<level>: Print message with ACPI prefix and object path 904 * 905 * These interfaces acquire the global namespace mutex to obtain an object 906 * path. In interrupt context, it shows the object path as <n/a>. 907 */ 908#define acpi_handle_emerg(handle, fmt, ...) \ 909 acpi_handle_printk(KERN_EMERG, handle, fmt, ##__VA_ARGS__) 910#define acpi_handle_alert(handle, fmt, ...) \ 911 acpi_handle_printk(KERN_ALERT, handle, fmt, ##__VA_ARGS__) 912#define acpi_handle_crit(handle, fmt, ...) \ 913 acpi_handle_printk(KERN_CRIT, handle, fmt, ##__VA_ARGS__) 914#define acpi_handle_err(handle, fmt, ...) \ 915 acpi_handle_printk(KERN_ERR, handle, fmt, ##__VA_ARGS__) 916#define acpi_handle_warn(handle, fmt, ...) \ 917 acpi_handle_printk(KERN_WARNING, handle, fmt, ##__VA_ARGS__) 918#define acpi_handle_notice(handle, fmt, ...) \ 919 acpi_handle_printk(KERN_NOTICE, handle, fmt, ##__VA_ARGS__) 920#define acpi_handle_info(handle, fmt, ...) \ 921 acpi_handle_printk(KERN_INFO, handle, fmt, ##__VA_ARGS__) 922 923#if defined(DEBUG) 924#define acpi_handle_debug(handle, fmt, ...) \ 925 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__) 926#else 927#if defined(CONFIG_DYNAMIC_DEBUG) 928#define acpi_handle_debug(handle, fmt, ...) \ 929do { \ 930 DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt); \ 931 if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \ 932 __acpi_handle_debug(&descriptor, handle, pr_fmt(fmt), \ 933 ##__VA_ARGS__); \ 934} while (0) 935#else 936#define acpi_handle_debug(handle, fmt, ...) \ 937({ \ 938 if (0) \ 939 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__); \ 940 0; \ 941}) 942#endif 943#endif 944 945struct acpi_gpio_params { 946 unsigned int crs_entry_index; 947 unsigned int line_index; 948 bool active_low; 949}; 950 951struct acpi_gpio_mapping { 952 const char *name; 953 const struct acpi_gpio_params *data; 954 unsigned int size; 955}; 956 957#if defined(CONFIG_ACPI) && defined(CONFIG_GPIOLIB) 958int acpi_dev_add_driver_gpios(struct acpi_device *adev, 959 const struct acpi_gpio_mapping *gpios); 960 961static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev) 962{ 963 if (adev) 964 adev->driver_gpios = NULL; 965} 966 967int devm_acpi_dev_add_driver_gpios(struct device *dev, 968 const struct acpi_gpio_mapping *gpios); 969void devm_acpi_dev_remove_driver_gpios(struct device *dev); 970 971bool acpi_gpio_get_irq_resource(struct acpi_resource *ares, 972 struct acpi_resource_gpio **agpio); 973int acpi_dev_gpio_irq_get(struct acpi_device *adev, int index); 974#else 975static inline int acpi_dev_add_driver_gpios(struct acpi_device *adev, 976 const struct acpi_gpio_mapping *gpios) 977{ 978 return -ENXIO; 979} 980static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev) {} 981 982static inline int devm_acpi_dev_add_driver_gpios(struct device *dev, 983 const struct acpi_gpio_mapping *gpios) 984{ 985 return -ENXIO; 986} 987static inline void devm_acpi_dev_remove_driver_gpios(struct device *dev) {} 988 989static inline bool acpi_gpio_get_irq_resource(struct acpi_resource *ares, 990 struct acpi_resource_gpio **agpio) 991{ 992 return false; 993} 994static inline int acpi_dev_gpio_irq_get(struct acpi_device *adev, int index) 995{ 996 return -ENXIO; 997} 998#endif 999 1000/* Device properties */ 1001 1002#define MAX_ACPI_REFERENCE_ARGS 8 1003struct acpi_reference_args { 1004 struct acpi_device *adev; 1005 size_t nargs; 1006 u64 args[MAX_ACPI_REFERENCE_ARGS]; 1007}; 1008 1009#ifdef CONFIG_ACPI 1010int acpi_dev_get_property(struct acpi_device *adev, const char *name, 1011 acpi_object_type type, const union acpi_object **obj); 1012int __acpi_node_get_property_reference(struct fwnode_handle *fwnode, 1013 const char *name, size_t index, size_t num_args, 1014 struct acpi_reference_args *args); 1015 1016static inline int acpi_node_get_property_reference(struct fwnode_handle *fwnode, 1017 const char *name, size_t index, 1018 struct acpi_reference_args *args) 1019{ 1020 return __acpi_node_get_property_reference(fwnode, name, index, 1021 MAX_ACPI_REFERENCE_ARGS, args); 1022} 1023 1024int acpi_node_prop_get(struct fwnode_handle *fwnode, const char *propname, 1025 void **valptr); 1026int acpi_dev_prop_read_single(struct acpi_device *adev, const char *propname, 1027 enum dev_prop_type proptype, void *val); 1028int acpi_node_prop_read(struct fwnode_handle *fwnode, const char *propname, 1029 enum dev_prop_type proptype, void *val, size_t nval); 1030int acpi_dev_prop_read(struct acpi_device *adev, const char *propname, 1031 enum dev_prop_type proptype, void *val, size_t nval); 1032 1033struct fwnode_handle *acpi_get_next_subnode(struct fwnode_handle *fwnode, 1034 struct fwnode_handle *child); 1035struct fwnode_handle *acpi_node_get_parent(struct fwnode_handle *fwnode); 1036 1037struct fwnode_handle *acpi_graph_get_next_endpoint(struct fwnode_handle *fwnode, 1038 struct fwnode_handle *prev); 1039int acpi_graph_get_remote_endpoint(struct fwnode_handle *fwnode, 1040 struct fwnode_handle **remote, 1041 struct fwnode_handle **port, 1042 struct fwnode_handle **endpoint); 1043 1044struct acpi_probe_entry; 1045typedef bool (*acpi_probe_entry_validate_subtbl)(struct acpi_subtable_header *, 1046 struct acpi_probe_entry *); 1047 1048#define ACPI_TABLE_ID_LEN 5 1049 1050/** 1051 * struct acpi_probe_entry - boot-time probing entry 1052 * @id: ACPI table name 1053 * @type: Optional subtable type to match 1054 * (if @id contains subtables) 1055 * @subtable_valid: Optional callback to check the validity of 1056 * the subtable 1057 * @probe_table: Callback to the driver being probed when table 1058 * match is successful 1059 * @probe_subtbl: Callback to the driver being probed when table and 1060 * subtable match (and optional callback is successful) 1061 * @driver_data: Sideband data provided back to the driver 1062 */ 1063struct acpi_probe_entry { 1064 __u8 id[ACPI_TABLE_ID_LEN]; 1065 __u8 type; 1066 acpi_probe_entry_validate_subtbl subtable_valid; 1067 union { 1068 acpi_tbl_table_handler probe_table; 1069 acpi_tbl_entry_handler probe_subtbl; 1070 }; 1071 kernel_ulong_t driver_data; 1072}; 1073 1074#define ACPI_DECLARE_PROBE_ENTRY(table, name, table_id, subtable, valid, data, fn) \ 1075 static const struct acpi_probe_entry __acpi_probe_##name \ 1076 __used __section(__##table##_acpi_probe_table) \ 1077 = { \ 1078 .id = table_id, \ 1079 .type = subtable, \ 1080 .subtable_valid = valid, \ 1081 .probe_table = (acpi_tbl_table_handler)fn, \ 1082 .driver_data = data, \ 1083 } 1084 1085#define ACPI_PROBE_TABLE(name) __##name##_acpi_probe_table 1086#define ACPI_PROBE_TABLE_END(name) __##name##_acpi_probe_table_end 1087 1088int __acpi_probe_device_table(struct acpi_probe_entry *start, int nr); 1089 1090#define acpi_probe_device_table(t) \ 1091 ({ \ 1092 extern struct acpi_probe_entry ACPI_PROBE_TABLE(t), \ 1093 ACPI_PROBE_TABLE_END(t); \ 1094 __acpi_probe_device_table(&ACPI_PROBE_TABLE(t), \ 1095 (&ACPI_PROBE_TABLE_END(t) - \ 1096 &ACPI_PROBE_TABLE(t))); \ 1097 }) 1098#else 1099static inline int acpi_dev_get_property(struct acpi_device *adev, 1100 const char *name, acpi_object_type type, 1101 const union acpi_object **obj) 1102{ 1103 return -ENXIO; 1104} 1105 1106static inline int 1107__acpi_node_get_property_reference(struct fwnode_handle *fwnode, 1108 const char *name, size_t index, size_t num_args, 1109 struct acpi_reference_args *args) 1110{ 1111 return -ENXIO; 1112} 1113 1114static inline int acpi_node_get_property_reference(struct fwnode_handle *fwnode, 1115 const char *name, size_t index, 1116 struct acpi_reference_args *args) 1117{ 1118 return -ENXIO; 1119} 1120 1121static inline int acpi_node_prop_get(struct fwnode_handle *fwnode, 1122 const char *propname, 1123 void **valptr) 1124{ 1125 return -ENXIO; 1126} 1127 1128static inline int acpi_dev_prop_get(struct acpi_device *adev, 1129 const char *propname, 1130 void **valptr) 1131{ 1132 return -ENXIO; 1133} 1134 1135static inline int acpi_dev_prop_read_single(struct acpi_device *adev, 1136 const char *propname, 1137 enum dev_prop_type proptype, 1138 void *val) 1139{ 1140 return -ENXIO; 1141} 1142 1143static inline int acpi_node_prop_read(struct fwnode_handle *fwnode, 1144 const char *propname, 1145 enum dev_prop_type proptype, 1146 void *val, size_t nval) 1147{ 1148 return -ENXIO; 1149} 1150 1151static inline int acpi_dev_prop_read(struct acpi_device *adev, 1152 const char *propname, 1153 enum dev_prop_type proptype, 1154 void *val, size_t nval) 1155{ 1156 return -ENXIO; 1157} 1158 1159static inline struct fwnode_handle * 1160acpi_get_next_subnode(struct fwnode_handle *fwnode, struct fwnode_handle *child) 1161{ 1162 return NULL; 1163} 1164 1165static inline struct fwnode_handle * 1166acpi_node_get_parent(struct fwnode_handle *fwnode) 1167{ 1168 return NULL; 1169} 1170 1171static inline struct fwnode_handle * 1172acpi_graph_get_next_endpoint(struct fwnode_handle *fwnode, 1173 struct fwnode_handle *prev) 1174{ 1175 return ERR_PTR(-ENXIO); 1176} 1177 1178static inline int 1179acpi_graph_get_remote_endpoint(struct fwnode_handle *fwnode, 1180 struct fwnode_handle **remote, 1181 struct fwnode_handle **port, 1182 struct fwnode_handle **endpoint) 1183{ 1184 return -ENXIO; 1185} 1186 1187#define ACPI_DECLARE_PROBE_ENTRY(table, name, table_id, subtable, valid, data, fn) \ 1188 static const void * __acpi_table_##name[] \ 1189 __attribute__((unused)) \ 1190 = { (void *) table_id, \ 1191 (void *) subtable, \ 1192 (void *) valid, \ 1193 (void *) fn, \ 1194 (void *) data } 1195 1196#define acpi_probe_device_table(t) ({ int __r = 0; __r;}) 1197#endif 1198 1199#ifdef CONFIG_ACPI_TABLE_UPGRADE 1200void acpi_table_upgrade(void); 1201#else 1202static inline void acpi_table_upgrade(void) { } 1203#endif 1204 1205#if defined(CONFIG_ACPI) && defined(CONFIG_ACPI_WATCHDOG) 1206extern bool acpi_has_watchdog(void); 1207#else 1208static inline bool acpi_has_watchdog(void) { return false; } 1209#endif 1210 1211#ifdef CONFIG_ACPI_SPCR_TABLE 1212extern bool qdf2400_e44_present; 1213int parse_spcr(bool earlycon); 1214#else 1215static inline int parse_spcr(bool earlycon) { return 0; } 1216#endif 1217 1218#if IS_ENABLED(CONFIG_ACPI_GENERIC_GSI) 1219int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res); 1220#else 1221static inline 1222int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res) 1223{ 1224 return -EINVAL; 1225} 1226#endif 1227 1228#endif /*_LINUX_ACPI_H*/