11da177e4SLinus Torvalds /* 21da177e4SLinus Torvalds * acpi_bus.h - ACPI Bus Driver ($Revision: 22 $) 31da177e4SLinus Torvalds * 41da177e4SLinus Torvalds * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com> 51da177e4SLinus Torvalds * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> 61da177e4SLinus Torvalds * 71da177e4SLinus Torvalds * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 81da177e4SLinus Torvalds * 91da177e4SLinus Torvalds * This program is free software; you can redistribute it and/or modify 101da177e4SLinus Torvalds * it under the terms of the GNU General Public License as published by 111da177e4SLinus Torvalds * the Free Software Foundation; either version 2 of the License, or (at 121da177e4SLinus Torvalds * your option) any later version. 131da177e4SLinus Torvalds * 141da177e4SLinus Torvalds * This program is distributed in the hope that it will be useful, but 151da177e4SLinus Torvalds * WITHOUT ANY WARRANTY; without even the implied warranty of 161da177e4SLinus Torvalds * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 171da177e4SLinus Torvalds * General Public License for more details. 181da177e4SLinus Torvalds * 191da177e4SLinus Torvalds * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 201da177e4SLinus Torvalds */ 211da177e4SLinus Torvalds 221da177e4SLinus Torvalds #ifndef __ACPI_BUS_H__ 231da177e4SLinus Torvalds #define __ACPI_BUS_H__ 241da177e4SLinus Torvalds 255b327265SPatrick Mochel #include <linux/device.h> 268a0662d9SRafael J. Wysocki #include <linux/property.h> 271da177e4SLinus Torvalds 281da177e4SLinus Torvalds /* TBD: Make dynamic */ 291da177e4SLinus Torvalds #define ACPI_MAX_HANDLES 10 301da177e4SLinus Torvalds struct acpi_handle_list { 311da177e4SLinus Torvalds u32 count; 321da177e4SLinus Torvalds acpi_handle handles[ACPI_MAX_HANDLES]; 331da177e4SLinus Torvalds }; 341da177e4SLinus Torvalds 351da177e4SLinus Torvalds /* acpi_utils.h */ 361da177e4SLinus Torvalds acpi_status 374be44fcdSLen Brown acpi_extract_package(union acpi_object *package, 384be44fcdSLen Brown struct acpi_buffer *format, struct acpi_buffer *buffer); 391da177e4SLinus Torvalds acpi_status 404be44fcdSLen Brown acpi_evaluate_integer(acpi_handle handle, 411da177e4SLinus Torvalds acpi_string pathname, 4227663c58SMatthew Wilcox struct acpi_object_list *arguments, unsigned long long *data); 431da177e4SLinus Torvalds acpi_status 444be44fcdSLen Brown acpi_evaluate_reference(acpi_handle handle, 451da177e4SLinus Torvalds acpi_string pathname, 461da177e4SLinus Torvalds struct acpi_object_list *arguments, 471da177e4SLinus Torvalds struct acpi_handle_list *list); 48275c58d7SToshi Kani acpi_status 4905730c19SJiang Liu acpi_evaluate_ost(acpi_handle handle, u32 source_event, u32 status_code, 5005730c19SJiang Liu struct acpi_buffer *status_buf); 511da177e4SLinus Torvalds 5238ac0f1bSMatthew Garrett acpi_status 538ede06abSFeng Tang acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld); 54952c63e9SJiang Liu 55952c63e9SJiang Liu bool acpi_has_method(acpi_handle handle, char *name); 560db98202SJiang Liu acpi_status acpi_execute_simple_method(acpi_handle handle, char *method, 570db98202SJiang Liu u64 arg); 587d2421f8SJiang Liu acpi_status acpi_evaluate_ej0(acpi_handle handle); 597d2421f8SJiang Liu acpi_status acpi_evaluate_lck(acpi_handle handle, int lock); 60ebf4df8dSJiang Liu bool acpi_ata_match(acpi_handle handle); 61ebf4df8dSJiang Liu bool acpi_bay_match(acpi_handle handle); 62ebf4df8dSJiang Liu bool acpi_dock_match(acpi_handle handle); 63952c63e9SJiang Liu 64a65ac520SJiang Liu bool acpi_check_dsm(acpi_handle handle, const u8 *uuid, int rev, u64 funcs); 65a65ac520SJiang Liu union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const u8 *uuid, 66a65ac520SJiang Liu int rev, int func, union acpi_object *argv4); 67a65ac520SJiang Liu 68a65ac520SJiang Liu static inline union acpi_object * 69a65ac520SJiang Liu acpi_evaluate_dsm_typed(acpi_handle handle, const u8 *uuid, int rev, int func, 70a65ac520SJiang Liu union acpi_object *argv4, acpi_object_type type) 71a65ac520SJiang Liu { 72a65ac520SJiang Liu union acpi_object *obj; 73a65ac520SJiang Liu 74a65ac520SJiang Liu obj = acpi_evaluate_dsm(handle, uuid, rev, func, argv4); 75a65ac520SJiang Liu if (obj && obj->type != type) { 76a65ac520SJiang Liu ACPI_FREE(obj); 77a65ac520SJiang Liu obj = NULL; 78a65ac520SJiang Liu } 79a65ac520SJiang Liu 80a65ac520SJiang Liu return obj; 81a65ac520SJiang Liu } 82a65ac520SJiang Liu 83a65ac520SJiang Liu #define ACPI_INIT_DSM_ARGV4(cnt, eles) \ 84a65ac520SJiang Liu { \ 85a65ac520SJiang Liu .package.type = ACPI_TYPE_PACKAGE, \ 86a65ac520SJiang Liu .package.count = (cnt), \ 87a65ac520SJiang Liu .package.elements = (eles) \ 88a65ac520SJiang Liu } 89a65ac520SJiang Liu 902d12b6b3SLukas Wunner bool acpi_dev_present(const char *hid); 912d12b6b3SLukas Wunner 9276f58584SLen Brown #ifdef CONFIG_ACPI 931da177e4SLinus Torvalds 941da177e4SLinus Torvalds #include <linux/proc_fs.h> 951da177e4SLinus Torvalds 961da177e4SLinus Torvalds #define ACPI_BUS_FILE_ROOT "acpi" 971da177e4SLinus Torvalds extern struct proc_dir_entry *acpi_root_dir; 981da177e4SLinus Torvalds 991da177e4SLinus Torvalds enum acpi_bus_device_type { 1001da177e4SLinus Torvalds ACPI_BUS_TYPE_DEVICE = 0, 1011da177e4SLinus Torvalds ACPI_BUS_TYPE_POWER, 1021da177e4SLinus Torvalds ACPI_BUS_TYPE_PROCESSOR, 1031da177e4SLinus Torvalds ACPI_BUS_TYPE_THERMAL, 1041da177e4SLinus Torvalds ACPI_BUS_TYPE_POWER_BUTTON, 1051da177e4SLinus Torvalds ACPI_BUS_TYPE_SLEEP_BUTTON, 1061da177e4SLinus Torvalds ACPI_BUS_DEVICE_TYPE_COUNT 1071da177e4SLinus Torvalds }; 1081da177e4SLinus Torvalds 1091da177e4SLinus Torvalds struct acpi_driver; 1101da177e4SLinus Torvalds struct acpi_device; 1111da177e4SLinus Torvalds 1121da177e4SLinus Torvalds /* 113ca589f94SRafael J. Wysocki * ACPI Scan Handler 114ca589f94SRafael J. Wysocki * ----------------- 115ca589f94SRafael J. Wysocki */ 116ca589f94SRafael J. Wysocki 117a33ec399SRafael J. Wysocki struct acpi_hotplug_profile { 1183f8055c3SRafael J. Wysocki struct kobject kobj; 1193338db00SRafael J. Wysocki int (*scan_dependent)(struct acpi_device *adev); 1208ab17fc9SRafael J. Wysocki void (*notify_online)(struct acpi_device *adev); 121d22ddcbcSRafael J. Wysocki bool enabled:1; 122d22ddcbcSRafael J. Wysocki bool demand_offline:1; 123a33ec399SRafael J. Wysocki }; 124a33ec399SRafael J. Wysocki 1253f8055c3SRafael J. Wysocki static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile( 1263f8055c3SRafael J. Wysocki struct kobject *kobj) 1273f8055c3SRafael J. Wysocki { 1283f8055c3SRafael J. Wysocki return container_of(kobj, struct acpi_hotplug_profile, kobj); 1293f8055c3SRafael J. Wysocki } 1303f8055c3SRafael J. Wysocki 131ca589f94SRafael J. Wysocki struct acpi_scan_handler { 132ca589f94SRafael J. Wysocki const struct acpi_device_id *ids; 133ca589f94SRafael J. Wysocki struct list_head list_node; 134636c19d3SRasmus Villemoes bool (*match)(const char *idstr, const struct acpi_device_id **matchid); 135ca589f94SRafael J. Wysocki int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id); 136ca589f94SRafael J. Wysocki void (*detach)(struct acpi_device *dev); 1379cb32acfSRafael J. Wysocki void (*bind)(struct device *phys_dev); 1389cb32acfSRafael J. Wysocki void (*unbind)(struct device *phys_dev); 139a33ec399SRafael J. Wysocki struct acpi_hotplug_profile hotplug; 140ca589f94SRafael J. Wysocki }; 141ca589f94SRafael J. Wysocki 142ca589f94SRafael J. Wysocki /* 1433c2cc7ffSRafael J. Wysocki * ACPI Hotplug Context 1443c2cc7ffSRafael J. Wysocki * -------------------- 1453c2cc7ffSRafael J. Wysocki */ 1463c2cc7ffSRafael J. Wysocki 1473c2cc7ffSRafael J. Wysocki struct acpi_hotplug_context { 1483c2cc7ffSRafael J. Wysocki struct acpi_device *self; 149be27b3dcSRafael J. Wysocki int (*notify)(struct acpi_device *, u32); 150be27b3dcSRafael J. Wysocki void (*uevent)(struct acpi_device *, u32); 15159b42fa0SRafael J. Wysocki void (*fixup)(struct acpi_device *); 1523c2cc7ffSRafael J. Wysocki }; 1533c2cc7ffSRafael J. Wysocki 1543c2cc7ffSRafael J. Wysocki /* 1551da177e4SLinus Torvalds * ACPI Driver 1561da177e4SLinus Torvalds * ----------- 1571da177e4SLinus Torvalds */ 1581da177e4SLinus Torvalds 1591da177e4SLinus Torvalds typedef int (*acpi_op_add) (struct acpi_device * device); 16051fac838SRafael J. Wysocki typedef int (*acpi_op_remove) (struct acpi_device * device); 16146ec8598SBjorn Helgaas typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event); 1621da177e4SLinus Torvalds 1631da177e4SLinus Torvalds struct acpi_device_ops { 1641da177e4SLinus Torvalds acpi_op_add add; 1651da177e4SLinus Torvalds acpi_op_remove remove; 16646ec8598SBjorn Helgaas acpi_op_notify notify; 1671da177e4SLinus Torvalds }; 1681da177e4SLinus Torvalds 1696d278131SBjorn Helgaas #define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */ 1706d278131SBjorn Helgaas 1711da177e4SLinus Torvalds struct acpi_driver { 1721da177e4SLinus Torvalds char name[80]; 1731da177e4SLinus Torvalds char class[80]; 1748c8eb78fSThomas Renninger const struct acpi_device_id *ids; /* Supported Hardware IDs */ 1756d278131SBjorn Helgaas unsigned int flags; 1761da177e4SLinus Torvalds struct acpi_device_ops ops; 177d43ec68eSPatrick Mochel struct device_driver drv; 1781890a97aSPatrick Mochel struct module *owner; 1791da177e4SLinus Torvalds }; 1801da177e4SLinus Torvalds 1811da177e4SLinus Torvalds /* 1821da177e4SLinus Torvalds * ACPI Device 1831da177e4SLinus Torvalds * ----------- 1841da177e4SLinus Torvalds */ 1851da177e4SLinus Torvalds 1861da177e4SLinus Torvalds /* Status (_STA) */ 1871da177e4SLinus Torvalds 1881da177e4SLinus Torvalds struct acpi_device_status { 1891da177e4SLinus Torvalds u32 present:1; 1901da177e4SLinus Torvalds u32 enabled:1; 1911da177e4SLinus Torvalds u32 show_in_ui:1; 1921da177e4SLinus Torvalds u32 functional:1; 1931da177e4SLinus Torvalds u32 battery_present:1; 1941da177e4SLinus Torvalds u32 reserved:27; 1951da177e4SLinus Torvalds }; 1961da177e4SLinus Torvalds 1971da177e4SLinus Torvalds /* Flags */ 1981da177e4SLinus Torvalds 1991da177e4SLinus Torvalds struct acpi_device_flags { 2001da177e4SLinus Torvalds u32 dynamic_status:1; 2011da177e4SLinus Torvalds u32 removable:1; 2021da177e4SLinus Torvalds u32 ejectable:1; 2031da177e4SLinus Torvalds u32 power_manageable:1; 204209d3b17SRafael J. Wysocki u32 match_driver:1; 205202317a5SRafael J. Wysocki u32 initialized:1; 206202317a5SRafael J. Wysocki u32 visited:1; 2073c2cc7ffSRafael J. Wysocki u32 hotplug_notify:1; 2081e2380cdSRafael J. Wysocki u32 is_dock_station:1; 2095c53b262SRafael J. Wysocki u32 of_compatible_ok:1; 210d0562674SSuthikulpanit, Suravee u32 coherent_dma:1; 211d0562674SSuthikulpanit, Suravee u32 cca_seen:1; 212d0562674SSuthikulpanit, Suravee u32 reserved:20; 2131da177e4SLinus Torvalds }; 2141da177e4SLinus Torvalds 2151da177e4SLinus Torvalds /* File System */ 2161da177e4SLinus Torvalds 2171da177e4SLinus Torvalds struct acpi_device_dir { 2181da177e4SLinus Torvalds struct proc_dir_entry *entry; 2191da177e4SLinus Torvalds }; 2201da177e4SLinus Torvalds 2211da177e4SLinus Torvalds #define acpi_device_dir(d) ((d)->dir.entry) 2221da177e4SLinus Torvalds 2231da177e4SLinus Torvalds /* Plug and Play */ 2241da177e4SLinus Torvalds 22524c5c4c2SZhao Yakui typedef char acpi_bus_id[8]; 2261da177e4SLinus Torvalds typedef unsigned long acpi_bus_address; 2271da177e4SLinus Torvalds typedef char acpi_device_name[40]; 2281da177e4SLinus Torvalds typedef char acpi_device_class[20]; 2291da177e4SLinus Torvalds 2307f47fa6cSBjorn Helgaas struct acpi_hardware_id { 2317f47fa6cSBjorn Helgaas struct list_head list; 232844142c3SRasmus Villemoes const char *id; 2337f47fa6cSBjorn Helgaas }; 2347f47fa6cSBjorn Helgaas 235d4e1a692SToshi Kani struct acpi_pnp_type { 236d4e1a692SToshi Kani u32 hardware_id:1; 237d4e1a692SToshi Kani u32 bus_address:1; 238549e6845SRafael J. Wysocki u32 platform_id:1; 239549e6845SRafael J. Wysocki u32 reserved:29; 240d4e1a692SToshi Kani }; 241d4e1a692SToshi Kani 2421da177e4SLinus Torvalds struct acpi_device_pnp { 2431da177e4SLinus Torvalds acpi_bus_id bus_id; /* Object name */ 244d4e1a692SToshi Kani struct acpi_pnp_type type; /* ID type */ 2451da177e4SLinus Torvalds acpi_bus_address bus_address; /* _ADR */ 24615b8dd53SBob Moore char *unique_id; /* _UID */ 2477f47fa6cSBjorn Helgaas struct list_head ids; /* _HID and _CIDs */ 2481da177e4SLinus Torvalds acpi_device_name device_name; /* Driver-determined */ 2491da177e4SLinus Torvalds acpi_device_class device_class; /* " */ 250d1efe3c3SLance Ortiz union acpi_object *str_obj; /* unicode string for _STR method */ 2511da177e4SLinus Torvalds }; 2521da177e4SLinus Torvalds 2531da177e4SLinus Torvalds #define acpi_device_bid(d) ((d)->pnp.bus_id) 2541da177e4SLinus Torvalds #define acpi_device_adr(d) ((d)->pnp.bus_address) 255620e112cSThomas Renninger const char *acpi_device_hid(struct acpi_device *device); 256359597cbSAdrian Hunter #define acpi_device_uid(d) ((d)->pnp.unique_id) 2571da177e4SLinus Torvalds #define acpi_device_name(d) ((d)->pnp.device_name) 2581da177e4SLinus Torvalds #define acpi_device_class(d) ((d)->pnp.device_class) 2591da177e4SLinus Torvalds 2601da177e4SLinus Torvalds /* Power Management */ 2611da177e4SLinus Torvalds 2621da177e4SLinus Torvalds struct acpi_device_power_flags { 2631da177e4SLinus Torvalds u32 explicit_get:1; /* _PSC present? */ 2641da177e4SLinus Torvalds u32 power_resources:1; /* Power resources */ 2651da177e4SLinus Torvalds u32 inrush_current:1; /* Serialize Dx->D0 */ 2661da177e4SLinus Torvalds u32 power_removed:1; /* Optimize Dx->D0 */ 267644f17adSMika Westerberg u32 ignore_parent:1; /* Power is independent of parent power state */ 268f25c0ae2SRafael J. Wysocki u32 dsw_present:1; /* _DSW present? */ 269f25c0ae2SRafael J. Wysocki u32 reserved:26; 2701da177e4SLinus Torvalds }; 2711da177e4SLinus Torvalds 2721da177e4SLinus Torvalds struct acpi_device_power_state { 2731da177e4SLinus Torvalds struct { 2741da177e4SLinus Torvalds u8 valid:1; 2751da177e4SLinus Torvalds u8 explicit_set:1; /* _PSx present? */ 2761da177e4SLinus Torvalds u8 reserved:6; 2771da177e4SLinus Torvalds } flags; 2781da177e4SLinus Torvalds int power; /* % Power (compared to D0) */ 2791da177e4SLinus Torvalds int latency; /* Dx->D0 time (microseconds) */ 2800b224527SRafael J. Wysocki struct list_head resources; /* Power resources referenced */ 2811da177e4SLinus Torvalds }; 2821da177e4SLinus Torvalds 2831da177e4SLinus Torvalds struct acpi_device_power { 2841da177e4SLinus Torvalds int state; /* Current state */ 2851da177e4SLinus Torvalds struct acpi_device_power_flags flags; 286b4a03b9aSLin Ming struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */ 2871da177e4SLinus Torvalds }; 2881da177e4SLinus Torvalds 2891da177e4SLinus Torvalds /* Performance Management */ 2901da177e4SLinus Torvalds 2911da177e4SLinus Torvalds struct acpi_device_perf_flags { 2921da177e4SLinus Torvalds u8 reserved:8; 2931da177e4SLinus Torvalds }; 2941da177e4SLinus Torvalds 2951da177e4SLinus Torvalds struct acpi_device_perf_state { 2961da177e4SLinus Torvalds struct { 2971da177e4SLinus Torvalds u8 valid:1; 2981da177e4SLinus Torvalds u8 reserved:7; 2991da177e4SLinus Torvalds } flags; 3001da177e4SLinus Torvalds u8 power; /* % Power (compared to P0) */ 3011da177e4SLinus Torvalds u8 performance; /* % Performance ( " ) */ 3021da177e4SLinus Torvalds int latency; /* Px->P0 time (microseconds) */ 3031da177e4SLinus Torvalds }; 3041da177e4SLinus Torvalds 3051da177e4SLinus Torvalds struct acpi_device_perf { 3061da177e4SLinus Torvalds int state; 3071da177e4SLinus Torvalds struct acpi_device_perf_flags flags; 3081da177e4SLinus Torvalds int state_count; 3091da177e4SLinus Torvalds struct acpi_device_perf_state *states; 3101da177e4SLinus Torvalds }; 3111da177e4SLinus Torvalds 3121da177e4SLinus Torvalds /* Wakeup Management */ 3131da177e4SLinus Torvalds struct acpi_device_wakeup_flags { 3141da177e4SLinus Torvalds u8 valid:1; /* Can successfully enable wakeup? */ 3151da177e4SLinus Torvalds u8 run_wake:1; /* Run-Wake GPE devices */ 316b67ea761SRafael J. Wysocki u8 notifier_present:1; /* Wake-up notify handler has been installed */ 317175f8e26SRafael J. Wysocki u8 enabled:1; /* Enabled for wakeup */ 3181da177e4SLinus Torvalds }; 3191da177e4SLinus Torvalds 320c072530fSRafael J. Wysocki struct acpi_device_wakeup_context { 321c072530fSRafael J. Wysocki struct work_struct work; 322c072530fSRafael J. Wysocki struct device *dev; 323c072530fSRafael J. Wysocki }; 324c072530fSRafael J. Wysocki 3251da177e4SLinus Torvalds struct acpi_device_wakeup { 3261da177e4SLinus Torvalds acpi_handle gpe_device; 327439913ffSLin Ming u64 gpe_number; 328439913ffSLin Ming u64 sleep_state; 329993cbe59SRafael J. Wysocki struct list_head resources; 3301da177e4SLinus Torvalds struct acpi_device_wakeup_flags flags; 331c072530fSRafael J. Wysocki struct acpi_device_wakeup_context context; 332c072530fSRafael J. Wysocki struct wakeup_source *ws; 3339b83ccd2SRafael J. Wysocki int prepare_count; 3341da177e4SLinus Torvalds }; 3351da177e4SLinus Torvalds 3361033f904SLan Tianyu struct acpi_device_physical_node { 337007ccfcfSRafael J. Wysocki unsigned int node_id; 3381033f904SLan Tianyu struct list_head node; 3391033f904SLan Tianyu struct device *dev; 340683058e3SRafael J. Wysocki bool put_online:1; 3411033f904SLan Tianyu }; 3421da177e4SLinus Torvalds 343ffdcd955SMika Westerberg /* ACPI Device Specific Data (_DSD) */ 344ffdcd955SMika Westerberg struct acpi_device_data { 345ffdcd955SMika Westerberg const union acpi_object *pointer; 346ffdcd955SMika Westerberg const union acpi_object *properties; 347733e6251SMika Westerberg const union acpi_object *of_compatible; 348445b0eb0SRafael J. Wysocki struct list_head subnodes; 349ffdcd955SMika Westerberg }; 350ffdcd955SMika Westerberg 351f028d524SRafael J. Wysocki struct acpi_gpio_mapping; 352f028d524SRafael J. Wysocki 3531033f904SLan Tianyu /* Device */ 3541da177e4SLinus Torvalds struct acpi_device { 355caaa6efbSBjorn Helgaas int device_type; 356caaa6efbSBjorn Helgaas acpi_handle handle; /* no handle for fixed hardware */ 3578a0662d9SRafael J. Wysocki struct fwnode_handle fwnode; 3581da177e4SLinus Torvalds struct acpi_device *parent; 3591da177e4SLinus Torvalds struct list_head children; 3601da177e4SLinus Torvalds struct list_head node; 3611da177e4SLinus Torvalds struct list_head wakeup_list; 362d783156eSRafael J. Wysocki struct list_head del_list; 3631da177e4SLinus Torvalds struct acpi_device_status status; 3641da177e4SLinus Torvalds struct acpi_device_flags flags; 3651da177e4SLinus Torvalds struct acpi_device_pnp pnp; 3661da177e4SLinus Torvalds struct acpi_device_power power; 3671da177e4SLinus Torvalds struct acpi_device_wakeup wakeup; 3681da177e4SLinus Torvalds struct acpi_device_perf performance; 3691da177e4SLinus Torvalds struct acpi_device_dir dir; 370ffdcd955SMika Westerberg struct acpi_device_data data; 371ca589f94SRafael J. Wysocki struct acpi_scan_handler *handler; 3723c2cc7ffSRafael J. Wysocki struct acpi_hotplug_context *hp; 3731da177e4SLinus Torvalds struct acpi_driver *driver; 374f028d524SRafael J. Wysocki const struct acpi_gpio_mapping *driver_gpios; 3751da177e4SLinus Torvalds void *driver_data; 3765b327265SPatrick Mochel struct device dev; 377007ccfcfSRafael J. Wysocki unsigned int physical_node_count; 37840e7fcb1SLan Tianyu unsigned int dep_unmet; 3791033f904SLan Tianyu struct list_head physical_node_list; 3801033f904SLan Tianyu struct mutex physical_node_lock; 381b1c0f99bSRafael J. Wysocki void (*remove)(struct acpi_device *); 3821da177e4SLinus Torvalds }; 3831da177e4SLinus Torvalds 384445b0eb0SRafael J. Wysocki /* Non-device subnode */ 385445b0eb0SRafael J. Wysocki struct acpi_data_node { 386445b0eb0SRafael J. Wysocki const char *name; 387263b4c1aSRafael J. Wysocki acpi_handle handle; 388445b0eb0SRafael J. Wysocki struct fwnode_handle fwnode; 389445b0eb0SRafael J. Wysocki struct acpi_device_data data; 390445b0eb0SRafael J. Wysocki struct list_head sibling; 391263b4c1aSRafael J. Wysocki struct kobject kobj; 392263b4c1aSRafael J. Wysocki struct completion kobj_done; 393445b0eb0SRafael J. Wysocki }; 394445b0eb0SRafael J. Wysocki 3958a0662d9SRafael J. Wysocki static inline bool is_acpi_node(struct fwnode_handle *fwnode) 3968a0662d9SRafael J. Wysocki { 3970224a4a3SHeikki Krogerus return !IS_ERR_OR_NULL(fwnode) && (fwnode->type == FWNODE_ACPI 3983a7a2ab8SRafael J. Wysocki || fwnode->type == FWNODE_ACPI_DATA); 3993a7a2ab8SRafael J. Wysocki } 4003a7a2ab8SRafael J. Wysocki 4013a7a2ab8SRafael J. Wysocki static inline bool is_acpi_device_node(struct fwnode_handle *fwnode) 4023a7a2ab8SRafael J. Wysocki { 4030224a4a3SHeikki Krogerus return !IS_ERR_OR_NULL(fwnode) && fwnode->type == FWNODE_ACPI; 4048a0662d9SRafael J. Wysocki } 4058a0662d9SRafael J. Wysocki 4063a7a2ab8SRafael J. Wysocki static inline struct acpi_device *to_acpi_device_node(struct fwnode_handle *fwnode) 4078a0662d9SRafael J. Wysocki { 4083a7a2ab8SRafael J. Wysocki return is_acpi_device_node(fwnode) ? 409ce793486SRafael J. Wysocki container_of(fwnode, struct acpi_device, fwnode) : NULL; 4108a0662d9SRafael J. Wysocki } 4118a0662d9SRafael J. Wysocki 4123a7a2ab8SRafael J. Wysocki static inline bool is_acpi_data_node(struct fwnode_handle *fwnode) 4133a7a2ab8SRafael J. Wysocki { 4143a7a2ab8SRafael J. Wysocki return fwnode && fwnode->type == FWNODE_ACPI_DATA; 4153a7a2ab8SRafael J. Wysocki } 4163a7a2ab8SRafael J. Wysocki 4173a7a2ab8SRafael J. Wysocki static inline struct acpi_data_node *to_acpi_data_node(struct fwnode_handle *fwnode) 4183a7a2ab8SRafael J. Wysocki { 4193a7a2ab8SRafael J. Wysocki return is_acpi_data_node(fwnode) ? 4203a7a2ab8SRafael J. Wysocki container_of(fwnode, struct acpi_data_node, fwnode) : NULL; 4213a7a2ab8SRafael J. Wysocki } 4223a7a2ab8SRafael J. Wysocki 4238a0662d9SRafael J. Wysocki static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev) 4248a0662d9SRafael J. Wysocki { 4258a0662d9SRafael J. Wysocki return &adev->fwnode; 4268a0662d9SRafael J. Wysocki } 4278a0662d9SRafael J. Wysocki 428db89b4f0SPavel Machek static inline void *acpi_driver_data(struct acpi_device *d) 429db89b4f0SPavel Machek { 430db89b4f0SPavel Machek return d->driver_data; 431db89b4f0SPavel Machek } 432db89b4f0SPavel Machek 433d43ec68eSPatrick Mochel #define to_acpi_device(d) container_of(d, struct acpi_device, dev) 434d43ec68eSPatrick Mochel #define to_acpi_driver(d) container_of(d, struct acpi_driver, drv) 4351da177e4SLinus Torvalds 43625db115bSRafael J. Wysocki static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta) 43725db115bSRafael J. Wysocki { 43825db115bSRafael J. Wysocki *((u32 *)&adev->status) = sta; 43925db115bSRafael J. Wysocki } 44025db115bSRafael J. Wysocki 4413c2cc7ffSRafael J. Wysocki static inline void acpi_set_hp_context(struct acpi_device *adev, 442ba574dc8SRafael J. Wysocki struct acpi_hotplug_context *hp) 4433c2cc7ffSRafael J. Wysocki { 4443c2cc7ffSRafael J. Wysocki hp->self = adev; 4453c2cc7ffSRafael J. Wysocki adev->hp = hp; 4463c2cc7ffSRafael J. Wysocki } 4473c2cc7ffSRafael J. Wysocki 4485d513205SRafael J. Wysocki void acpi_initialize_hp_context(struct acpi_device *adev, 4495d513205SRafael J. Wysocki struct acpi_hotplug_context *hp, 4505d513205SRafael J. Wysocki int (*notify)(struct acpi_device *, u32), 4515d513205SRafael J. Wysocki void (*uevent)(struct acpi_device *, u32)); 4525d513205SRafael J. Wysocki 45355955aadSDavid Brownell /* acpi_device.dev.bus == &acpi_bus_type */ 45455955aadSDavid Brownell extern struct bus_type acpi_bus_type; 45555955aadSDavid Brownell 4561da177e4SLinus Torvalds /* 4571da177e4SLinus Torvalds * Events 4581da177e4SLinus Torvalds * ------ 4591da177e4SLinus Torvalds */ 4601da177e4SLinus Torvalds 4611da177e4SLinus Torvalds struct acpi_bus_event { 4621da177e4SLinus Torvalds struct list_head node; 4631da177e4SLinus Torvalds acpi_device_class device_class; 4641da177e4SLinus Torvalds acpi_bus_id bus_id; 4651da177e4SLinus Torvalds u32 type; 4661da177e4SLinus Torvalds u32 data; 4671da177e4SLinus Torvalds }; 4681da177e4SLinus Torvalds 46999e0d2fcSGreg Kroah-Hartman extern struct kobject *acpi_kobj; 470962ce8caSZhang Rui extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int); 4718e4319c4SBob Moore void acpi_bus_private_data_handler(acpi_handle, void *); 47220733939SZhang Rui int acpi_bus_get_private_data(acpi_handle, void **); 47372013795SLan Tianyu int acpi_bus_attach_private_data(acpi_handle, void *); 47472013795SLan Tianyu void acpi_bus_detach_private_data(acpi_handle); 4759ee85241SZhang Rui extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32); 4769ee85241SZhang Rui extern int register_acpi_notifier(struct notifier_block *); 4779ee85241SZhang Rui extern int unregister_acpi_notifier(struct notifier_block *); 4786bd00a61SShaohua Li 4791da177e4SLinus Torvalds /* 4801da177e4SLinus Torvalds * External Functions 4811da177e4SLinus Torvalds */ 4821da177e4SLinus Torvalds 4831da177e4SLinus Torvalds int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device); 48478ea4639SRafael J. Wysocki struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle); 48578ea4639SRafael J. Wysocki void acpi_bus_put_acpi_device(struct acpi_device *adev); 486402ac536SBjorn Helgaas acpi_status acpi_bus_get_status_handle(acpi_handle handle, 487402ac536SBjorn Helgaas unsigned long long *sta); 4881da177e4SLinus Torvalds int acpi_bus_get_status(struct acpi_device *device); 4899ce4e607SRafael J. Wysocki 4901da177e4SLinus Torvalds int acpi_bus_set_power(acpi_handle handle, int state); 49196bfd3ceSRafael J. Wysocki const char *acpi_power_state_string(int state); 492ad0c3b0eSRafael J. Wysocki int acpi_device_get_power(struct acpi_device *device, int *state); 493078eb126SRafael J. Wysocki int acpi_device_set_power(struct acpi_device *device, int state); 4949ce4e607SRafael J. Wysocki int acpi_bus_init_power(struct acpi_device *device); 495b9e95fc6SRafael J. Wysocki int acpi_device_fix_up_power(struct acpi_device *device); 49625eed407SRafael J. Wysocki int acpi_bus_update_power(acpi_handle handle, int *state_p); 4972bb3a2bfSAaron Lu int acpi_device_update_power(struct acpi_device *device, int *state_p); 4983737b2b1SRafael J. Wysocki bool acpi_bus_power_manageable(acpi_handle handle); 499ec4602a9SRafael J. Wysocki 500ec4602a9SRafael J. Wysocki #ifdef CONFIG_PM 501eb9d0fe4SRafael J. Wysocki bool acpi_bus_can_wakeup(acpi_handle handle); 502ec4602a9SRafael J. Wysocki #else 503ec4602a9SRafael J. Wysocki static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; } 504ec4602a9SRafael J. Wysocki #endif 5059ce4e607SRafael J. Wysocki 5063757b948SRafael J. Wysocki void acpi_scan_lock_acquire(void); 5073757b948SRafael J. Wysocki void acpi_scan_lock_release(void); 508e525506fSRafael J. Wysocki void acpi_lock_hp_context(void); 509e525506fSRafael J. Wysocki void acpi_unlock_hp_context(void); 510ca589f94SRafael J. Wysocki int acpi_scan_add_handler(struct acpi_scan_handler *handler); 5111da177e4SLinus Torvalds int acpi_bus_register_driver(struct acpi_driver *driver); 51206ea8e08SBjorn Helgaas void acpi_bus_unregister_driver(struct acpi_driver *driver); 513b8bd759aSRafael J. Wysocki int acpi_bus_scan(acpi_handle handle); 514bfee26dbSRafael J. Wysocki void acpi_bus_trim(struct acpi_device *start); 515c8f7a62cSLen Brown acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd); 5168c8eb78fSThomas Renninger int acpi_match_device_ids(struct acpi_device *device, 5178c8eb78fSThomas Renninger const struct acpi_device_id *ids); 5181da177e4SLinus Torvalds int acpi_create_dir(struct acpi_device *); 5191da177e4SLinus Torvalds void acpi_remove_dir(struct acpi_device *); 5201da177e4SLinus Torvalds 521202317a5SRafael J. Wysocki static inline bool acpi_device_enumerated(struct acpi_device *adev) 522202317a5SRafael J. Wysocki { 523202317a5SRafael J. Wysocki return adev && adev->flags.initialized && adev->flags.visited; 524202317a5SRafael J. Wysocki } 525202317a5SRafael J. Wysocki 5260d2cf8f5SMika Westerberg /** 5270d2cf8f5SMika Westerberg * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver 5280d2cf8f5SMika Westerberg * @__acpi_driver: acpi_driver struct 5290d2cf8f5SMika Westerberg * 5300d2cf8f5SMika Westerberg * Helper macro for ACPI drivers which do not do anything special in module 5310d2cf8f5SMika Westerberg * init/exit. This eliminates a lot of boilerplate. Each module may only 5320d2cf8f5SMika Westerberg * use this macro once, and calling it replaces module_init() and module_exit() 5330d2cf8f5SMika Westerberg */ 5340d2cf8f5SMika Westerberg #define module_acpi_driver(__acpi_driver) \ 5350d2cf8f5SMika Westerberg module_driver(__acpi_driver, acpi_bus_register_driver, \ 5360d2cf8f5SMika Westerberg acpi_bus_unregister_driver) 5370d2cf8f5SMika Westerberg 5384e10d12aSDavid Shaohua Li /* 5394e10d12aSDavid Shaohua Li * Bind physical devices with ACPI devices 5404e10d12aSDavid Shaohua Li */ 5414e10d12aSDavid Shaohua Li struct acpi_bus_type { 5424e10d12aSDavid Shaohua Li struct list_head list; 54353540098SRafael J. Wysocki const char *name; 54453540098SRafael J. Wysocki bool (*match)(struct device *dev); 545e3f02c52SRafael J. Wysocki struct acpi_device * (*find_companion)(struct device *); 54611909ca1SRafael J. Wysocki void (*setup)(struct device *); 54711909ca1SRafael J. Wysocki void (*cleanup)(struct device *); 5484e10d12aSDavid Shaohua Li }; 5494e10d12aSDavid Shaohua Li int register_acpi_bus_type(struct acpi_bus_type *); 5504e10d12aSDavid Shaohua Li int unregister_acpi_bus_type(struct acpi_bus_type *); 551f1b1dc84SZhang Rui int acpi_bind_one(struct device *dev, struct acpi_device *adev); 552f1b1dc84SZhang Rui int acpi_unbind_one(struct device *dev); 55322c13f9dSThomas Renninger 55476d56de5SAlex Chiang struct acpi_pci_root { 55576d56de5SAlex Chiang struct acpi_device * device; 55676d56de5SAlex Chiang struct pci_bus *bus; 55776d56de5SAlex Chiang u16 segment; 5586ad95513SBjorn Helgaas struct resource secondary; /* downstream bus range */ 55976d56de5SAlex Chiang 56076d56de5SAlex Chiang u32 osc_support_set; /* _OSC state of support bits */ 56176d56de5SAlex Chiang u32 osc_control_set; /* _OSC state of control bits */ 562f4b57a3bSJiang Liu phys_addr_t mcfg_addr; 56376d56de5SAlex Chiang }; 56476d56de5SAlex Chiang 5654e10d12aSDavid Shaohua Li /* helper */ 566d9fef0c4SRafael J. Wysocki 567b84f196dSSuthikulpanit, Suravee bool acpi_dma_supported(struct acpi_device *adev); 568b84f196dSSuthikulpanit, Suravee enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev); 569b84f196dSSuthikulpanit, Suravee 570d9fef0c4SRafael J. Wysocki struct acpi_device *acpi_find_child_device(struct acpi_device *parent, 571d9fef0c4SRafael J. Wysocki u64 address, bool check_children); 57227558203SAlexander Chiang int acpi_is_root_bridge(acpi_handle); 57376d56de5SAlex Chiang struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle); 5744e10d12aSDavid Shaohua Li 575b67ea761SRafael J. Wysocki int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state); 576b67ea761SRafael J. Wysocki int acpi_disable_wakeup_device_power(struct acpi_device *dev); 577b67ea761SRafael J. Wysocki 578aa338601SRafael J. Wysocki #ifdef CONFIG_PM 579c072530fSRafael J. Wysocki acpi_status acpi_add_pm_notifier(struct acpi_device *adev, struct device *dev, 580c072530fSRafael J. Wysocki void (*work_func)(struct work_struct *work)); 581c072530fSRafael J. Wysocki acpi_status acpi_remove_pm_notifier(struct acpi_device *adev); 582ee85f543SHuang Ying int acpi_pm_device_sleep_state(struct device *, int *, int); 5835de21bb9SRafael J. Wysocki int acpi_pm_device_run_wake(struct device *, bool); 584761afb86SRafael J. Wysocki #else 585ec2cd81cSRafael J. Wysocki static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev, 586c072530fSRafael J. Wysocki struct device *dev, 587c072530fSRafael J. Wysocki void (*work_func)(struct work_struct *work)) 588ec2cd81cSRafael J. Wysocki { 589ec2cd81cSRafael J. Wysocki return AE_SUPPORT; 590ec2cd81cSRafael J. Wysocki } 591c072530fSRafael J. Wysocki static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev) 592ec2cd81cSRafael J. Wysocki { 593ec2cd81cSRafael J. Wysocki return AE_SUPPORT; 594ec2cd81cSRafael J. Wysocki } 595b25c77efSRafael J. Wysocki static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m) 596296699deSRafael J. Wysocki { 597296699deSRafael J. Wysocki if (p) 598296699deSRafael J. Wysocki *p = ACPI_STATE_D0; 599b25c77efSRafael J. Wysocki 6008ad928d5SRafael J. Wysocki return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ? 6018ad928d5SRafael J. Wysocki m : ACPI_STATE_D0; 602296699deSRafael J. Wysocki } 603b24e5098SLin Ming static inline int acpi_pm_device_run_wake(struct device *dev, bool enable) 604b24e5098SLin Ming { 605b24e5098SLin Ming return -ENODEV; 606b24e5098SLin Ming } 607761afb86SRafael J. Wysocki #endif 608761afb86SRafael J. Wysocki 609761afb86SRafael J. Wysocki #ifdef CONFIG_PM_SLEEP 610761afb86SRafael J. Wysocki int acpi_pm_device_sleep_wake(struct device *, bool); 611f7a1b860SDavid Howells #else 612f7a1b860SDavid Howells static inline int acpi_pm_device_sleep_wake(struct device *dev, bool enable) 613f7a1b860SDavid Howells { 614f7a1b860SDavid Howells return -ENODEV; 615f7a1b860SDavid Howells } 616761afb86SRafael J. Wysocki #endif 617fd4aff1aSShaohua Li 61899926a8cSDavid Rientjes #ifdef CONFIG_ACPI_SLEEP 61999926a8cSDavid Rientjes u32 acpi_target_system_state(void); 62099926a8cSDavid Rientjes #else 62199926a8cSDavid Rientjes static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; } 62299926a8cSDavid Rientjes #endif 62399926a8cSDavid Rientjes 624078eb126SRafael J. Wysocki static inline bool acpi_device_power_manageable(struct acpi_device *adev) 625078eb126SRafael J. Wysocki { 626078eb126SRafael J. Wysocki return adev->flags.power_manageable; 627078eb126SRafael J. Wysocki } 628078eb126SRafael J. Wysocki 629078eb126SRafael J. Wysocki static inline bool acpi_device_can_wakeup(struct acpi_device *adev) 630078eb126SRafael J. Wysocki { 631078eb126SRafael J. Wysocki return adev->wakeup.flags.valid; 632078eb126SRafael J. Wysocki } 633078eb126SRafael J. Wysocki 6341399dfcdSAaron Lu static inline bool acpi_device_can_poweroff(struct acpi_device *adev) 6351399dfcdSAaron Lu { 636cd7f84c0SKen Xue return adev->power.states[ACPI_STATE_D3_COLD].flags.valid || 637cd7f84c0SKen Xue ((acpi_gbl_FADT.header.revision < 6) && 638cd7f84c0SKen Xue adev->power.states[ACPI_STATE_D3_HOT].flags.explicit_set); 6391399dfcdSAaron Lu } 6401399dfcdSAaron Lu 64166886d6fSMatthew Garrett #else /* CONFIG_ACPI */ 64266886d6fSMatthew Garrett 6437ae30986SLen Brown static inline int register_acpi_bus_type(void *bus) { return 0; } 6447ae30986SLen Brown static inline int unregister_acpi_bus_type(void *bus) { return 0; } 64566886d6fSMatthew Garrett 64676f58584SLen Brown #endif /* CONFIG_ACPI */ 6471da177e4SLinus Torvalds 6481da177e4SLinus Torvalds #endif /*__ACPI_BUS_H__*/ 649