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 6494116f81SAndy Shevchenko bool acpi_check_dsm(acpi_handle handle, const guid_t *guid, u64 rev, u64 funcs); 6594116f81SAndy Shevchenko union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const guid_t *guid, 66c7e16e52SJerry Hoemann u64 rev, u64 func, union acpi_object *argv4); 67a65ac520SJiang Liu 68a65ac520SJiang Liu static inline union acpi_object * 6994116f81SAndy Shevchenko acpi_evaluate_dsm_typed(acpi_handle handle, const guid_t *guid, u64 rev, 7094116f81SAndy Shevchenko u64 func, union acpi_object *argv4, 7194116f81SAndy Shevchenko acpi_object_type type) 72a65ac520SJiang Liu { 73a65ac520SJiang Liu union acpi_object *obj; 74a65ac520SJiang Liu 7594116f81SAndy Shevchenko obj = acpi_evaluate_dsm(handle, guid, rev, func, argv4); 76a65ac520SJiang Liu if (obj && obj->type != type) { 77a65ac520SJiang Liu ACPI_FREE(obj); 78a65ac520SJiang Liu obj = NULL; 79a65ac520SJiang Liu } 80a65ac520SJiang Liu 81a65ac520SJiang Liu return obj; 82a65ac520SJiang Liu } 83a65ac520SJiang Liu 84a65ac520SJiang Liu #define ACPI_INIT_DSM_ARGV4(cnt, eles) \ 85a65ac520SJiang Liu { \ 86a65ac520SJiang Liu .package.type = ACPI_TYPE_PACKAGE, \ 87a65ac520SJiang Liu .package.count = (cnt), \ 88a65ac520SJiang Liu .package.elements = (eles) \ 89a65ac520SJiang Liu } 90a65ac520SJiang Liu 91c68ae33eSLukas Wunner bool acpi_dev_found(const char *hid); 928661423eSHans de Goede bool acpi_dev_present(const char *hid, const char *uid, s64 hrv); 932d12b6b3SLukas Wunner 9476f58584SLen Brown #ifdef CONFIG_ACPI 951da177e4SLinus Torvalds 961da177e4SLinus Torvalds #include <linux/proc_fs.h> 971da177e4SLinus Torvalds 981da177e4SLinus Torvalds #define ACPI_BUS_FILE_ROOT "acpi" 991da177e4SLinus Torvalds extern struct proc_dir_entry *acpi_root_dir; 1001da177e4SLinus Torvalds 1011da177e4SLinus Torvalds enum acpi_bus_device_type { 1021da177e4SLinus Torvalds ACPI_BUS_TYPE_DEVICE = 0, 1031da177e4SLinus Torvalds ACPI_BUS_TYPE_POWER, 1041da177e4SLinus Torvalds ACPI_BUS_TYPE_PROCESSOR, 1051da177e4SLinus Torvalds ACPI_BUS_TYPE_THERMAL, 1061da177e4SLinus Torvalds ACPI_BUS_TYPE_POWER_BUTTON, 1071da177e4SLinus Torvalds ACPI_BUS_TYPE_SLEEP_BUTTON, 1081da177e4SLinus Torvalds ACPI_BUS_DEVICE_TYPE_COUNT 1091da177e4SLinus Torvalds }; 1101da177e4SLinus Torvalds 1111da177e4SLinus Torvalds struct acpi_driver; 1121da177e4SLinus Torvalds struct acpi_device; 1131da177e4SLinus Torvalds 1141da177e4SLinus Torvalds /* 115ca589f94SRafael J. Wysocki * ACPI Scan Handler 116ca589f94SRafael J. Wysocki * ----------------- 117ca589f94SRafael J. Wysocki */ 118ca589f94SRafael J. Wysocki 119a33ec399SRafael J. Wysocki struct acpi_hotplug_profile { 1203f8055c3SRafael J. Wysocki struct kobject kobj; 1213338db00SRafael J. Wysocki int (*scan_dependent)(struct acpi_device *adev); 1228ab17fc9SRafael J. Wysocki void (*notify_online)(struct acpi_device *adev); 123d22ddcbcSRafael J. Wysocki bool enabled:1; 124d22ddcbcSRafael J. Wysocki bool demand_offline:1; 125a33ec399SRafael J. Wysocki }; 126a33ec399SRafael J. Wysocki 1273f8055c3SRafael J. Wysocki static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile( 1283f8055c3SRafael J. Wysocki struct kobject *kobj) 1293f8055c3SRafael J. Wysocki { 1303f8055c3SRafael J. Wysocki return container_of(kobj, struct acpi_hotplug_profile, kobj); 1313f8055c3SRafael J. Wysocki } 1323f8055c3SRafael J. Wysocki 133ca589f94SRafael J. Wysocki struct acpi_scan_handler { 134ca589f94SRafael J. Wysocki const struct acpi_device_id *ids; 135ca589f94SRafael J. Wysocki struct list_head list_node; 136636c19d3SRasmus Villemoes bool (*match)(const char *idstr, const struct acpi_device_id **matchid); 137ca589f94SRafael J. Wysocki int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id); 138ca589f94SRafael J. Wysocki void (*detach)(struct acpi_device *dev); 1399cb32acfSRafael J. Wysocki void (*bind)(struct device *phys_dev); 1409cb32acfSRafael J. Wysocki void (*unbind)(struct device *phys_dev); 141a33ec399SRafael J. Wysocki struct acpi_hotplug_profile hotplug; 142ca589f94SRafael J. Wysocki }; 143ca589f94SRafael J. Wysocki 144ca589f94SRafael J. Wysocki /* 1453c2cc7ffSRafael J. Wysocki * ACPI Hotplug Context 1463c2cc7ffSRafael J. Wysocki * -------------------- 1473c2cc7ffSRafael J. Wysocki */ 1483c2cc7ffSRafael J. Wysocki 1493c2cc7ffSRafael J. Wysocki struct acpi_hotplug_context { 1503c2cc7ffSRafael J. Wysocki struct acpi_device *self; 151be27b3dcSRafael J. Wysocki int (*notify)(struct acpi_device *, u32); 152be27b3dcSRafael J. Wysocki void (*uevent)(struct acpi_device *, u32); 15359b42fa0SRafael J. Wysocki void (*fixup)(struct acpi_device *); 1543c2cc7ffSRafael J. Wysocki }; 1553c2cc7ffSRafael J. Wysocki 1563c2cc7ffSRafael J. Wysocki /* 1571da177e4SLinus Torvalds * ACPI Driver 1581da177e4SLinus Torvalds * ----------- 1591da177e4SLinus Torvalds */ 1601da177e4SLinus Torvalds 1611da177e4SLinus Torvalds typedef int (*acpi_op_add) (struct acpi_device * device); 16251fac838SRafael J. Wysocki typedef int (*acpi_op_remove) (struct acpi_device * device); 16346ec8598SBjorn Helgaas typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event); 1641da177e4SLinus Torvalds 1651da177e4SLinus Torvalds struct acpi_device_ops { 1661da177e4SLinus Torvalds acpi_op_add add; 1671da177e4SLinus Torvalds acpi_op_remove remove; 16846ec8598SBjorn Helgaas acpi_op_notify notify; 1691da177e4SLinus Torvalds }; 1701da177e4SLinus Torvalds 1716d278131SBjorn Helgaas #define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */ 1726d278131SBjorn Helgaas 1731da177e4SLinus Torvalds struct acpi_driver { 1741da177e4SLinus Torvalds char name[80]; 1751da177e4SLinus Torvalds char class[80]; 1768c8eb78fSThomas Renninger const struct acpi_device_id *ids; /* Supported Hardware IDs */ 1776d278131SBjorn Helgaas unsigned int flags; 1781da177e4SLinus Torvalds struct acpi_device_ops ops; 179d43ec68eSPatrick Mochel struct device_driver drv; 1801890a97aSPatrick Mochel struct module *owner; 1811da177e4SLinus Torvalds }; 1821da177e4SLinus Torvalds 1831da177e4SLinus Torvalds /* 1841da177e4SLinus Torvalds * ACPI Device 1851da177e4SLinus Torvalds * ----------- 1861da177e4SLinus Torvalds */ 1871da177e4SLinus Torvalds 1881da177e4SLinus Torvalds /* Status (_STA) */ 1891da177e4SLinus Torvalds 1901da177e4SLinus Torvalds struct acpi_device_status { 1911da177e4SLinus Torvalds u32 present:1; 1921da177e4SLinus Torvalds u32 enabled:1; 1931da177e4SLinus Torvalds u32 show_in_ui:1; 1941da177e4SLinus Torvalds u32 functional:1; 1951da177e4SLinus Torvalds u32 battery_present:1; 1961da177e4SLinus Torvalds u32 reserved:27; 1971da177e4SLinus Torvalds }; 1981da177e4SLinus Torvalds 1991da177e4SLinus Torvalds /* Flags */ 2001da177e4SLinus Torvalds 2011da177e4SLinus Torvalds struct acpi_device_flags { 2021da177e4SLinus Torvalds u32 dynamic_status:1; 2031da177e4SLinus Torvalds u32 removable:1; 2041da177e4SLinus Torvalds u32 ejectable:1; 2051da177e4SLinus Torvalds u32 power_manageable:1; 206209d3b17SRafael J. Wysocki u32 match_driver:1; 207202317a5SRafael J. Wysocki u32 initialized:1; 208202317a5SRafael J. Wysocki u32 visited:1; 2093c2cc7ffSRafael J. Wysocki u32 hotplug_notify:1; 2101e2380cdSRafael J. Wysocki u32 is_dock_station:1; 2115c53b262SRafael J. Wysocki u32 of_compatible_ok:1; 212d0562674SSuthikulpanit, Suravee u32 coherent_dma:1; 213d0562674SSuthikulpanit, Suravee u32 cca_seen:1; 214d0562674SSuthikulpanit, Suravee u32 reserved:20; 2151da177e4SLinus Torvalds }; 2161da177e4SLinus Torvalds 2171da177e4SLinus Torvalds /* File System */ 2181da177e4SLinus Torvalds 2191da177e4SLinus Torvalds struct acpi_device_dir { 2201da177e4SLinus Torvalds struct proc_dir_entry *entry; 2211da177e4SLinus Torvalds }; 2221da177e4SLinus Torvalds 2231da177e4SLinus Torvalds #define acpi_device_dir(d) ((d)->dir.entry) 2241da177e4SLinus Torvalds 2251da177e4SLinus Torvalds /* Plug and Play */ 2261da177e4SLinus Torvalds 22724c5c4c2SZhao Yakui typedef char acpi_bus_id[8]; 2281da177e4SLinus Torvalds typedef unsigned long acpi_bus_address; 2291da177e4SLinus Torvalds typedef char acpi_device_name[40]; 2301da177e4SLinus Torvalds typedef char acpi_device_class[20]; 2311da177e4SLinus Torvalds 2327f47fa6cSBjorn Helgaas struct acpi_hardware_id { 2337f47fa6cSBjorn Helgaas struct list_head list; 234844142c3SRasmus Villemoes const char *id; 2357f47fa6cSBjorn Helgaas }; 2367f47fa6cSBjorn Helgaas 237d4e1a692SToshi Kani struct acpi_pnp_type { 238d4e1a692SToshi Kani u32 hardware_id:1; 239d4e1a692SToshi Kani u32 bus_address:1; 240549e6845SRafael J. Wysocki u32 platform_id:1; 241549e6845SRafael J. Wysocki u32 reserved:29; 242d4e1a692SToshi Kani }; 243d4e1a692SToshi Kani 2441da177e4SLinus Torvalds struct acpi_device_pnp { 2451da177e4SLinus Torvalds acpi_bus_id bus_id; /* Object name */ 246d4e1a692SToshi Kani struct acpi_pnp_type type; /* ID type */ 2471da177e4SLinus Torvalds acpi_bus_address bus_address; /* _ADR */ 24815b8dd53SBob Moore char *unique_id; /* _UID */ 2497f47fa6cSBjorn Helgaas struct list_head ids; /* _HID and _CIDs */ 2501da177e4SLinus Torvalds acpi_device_name device_name; /* Driver-determined */ 2511da177e4SLinus Torvalds acpi_device_class device_class; /* " */ 252d1efe3c3SLance Ortiz union acpi_object *str_obj; /* unicode string for _STR method */ 2531da177e4SLinus Torvalds }; 2541da177e4SLinus Torvalds 2551da177e4SLinus Torvalds #define acpi_device_bid(d) ((d)->pnp.bus_id) 2561da177e4SLinus Torvalds #define acpi_device_adr(d) ((d)->pnp.bus_address) 257620e112cSThomas Renninger const char *acpi_device_hid(struct acpi_device *device); 258359597cbSAdrian Hunter #define acpi_device_uid(d) ((d)->pnp.unique_id) 2591da177e4SLinus Torvalds #define acpi_device_name(d) ((d)->pnp.device_name) 2601da177e4SLinus Torvalds #define acpi_device_class(d) ((d)->pnp.device_class) 2611da177e4SLinus Torvalds 2621da177e4SLinus Torvalds /* Power Management */ 2631da177e4SLinus Torvalds 2641da177e4SLinus Torvalds struct acpi_device_power_flags { 2651da177e4SLinus Torvalds u32 explicit_get:1; /* _PSC present? */ 2661da177e4SLinus Torvalds u32 power_resources:1; /* Power resources */ 2671da177e4SLinus Torvalds u32 inrush_current:1; /* Serialize Dx->D0 */ 2681da177e4SLinus Torvalds u32 power_removed:1; /* Optimize Dx->D0 */ 269644f17adSMika Westerberg u32 ignore_parent:1; /* Power is independent of parent power state */ 270f25c0ae2SRafael J. Wysocki u32 dsw_present:1; /* _DSW present? */ 271f25c0ae2SRafael J. Wysocki u32 reserved:26; 2721da177e4SLinus Torvalds }; 2731da177e4SLinus Torvalds 2741da177e4SLinus Torvalds struct acpi_device_power_state { 2751da177e4SLinus Torvalds struct { 2761da177e4SLinus Torvalds u8 valid:1; 2771da177e4SLinus Torvalds u8 explicit_set:1; /* _PSx present? */ 2781da177e4SLinus Torvalds u8 reserved:6; 2791da177e4SLinus Torvalds } flags; 2801da177e4SLinus Torvalds int power; /* % Power (compared to D0) */ 2811da177e4SLinus Torvalds int latency; /* Dx->D0 time (microseconds) */ 2820b224527SRafael J. Wysocki struct list_head resources; /* Power resources referenced */ 2831da177e4SLinus Torvalds }; 2841da177e4SLinus Torvalds 2851da177e4SLinus Torvalds struct acpi_device_power { 2861da177e4SLinus Torvalds int state; /* Current state */ 2871da177e4SLinus Torvalds struct acpi_device_power_flags flags; 288b4a03b9aSLin Ming struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */ 2891da177e4SLinus Torvalds }; 2901da177e4SLinus Torvalds 2911da177e4SLinus Torvalds /* Performance Management */ 2921da177e4SLinus Torvalds 2931da177e4SLinus Torvalds struct acpi_device_perf_flags { 2941da177e4SLinus Torvalds u8 reserved:8; 2951da177e4SLinus Torvalds }; 2961da177e4SLinus Torvalds 2971da177e4SLinus Torvalds struct acpi_device_perf_state { 2981da177e4SLinus Torvalds struct { 2991da177e4SLinus Torvalds u8 valid:1; 3001da177e4SLinus Torvalds u8 reserved:7; 3011da177e4SLinus Torvalds } flags; 3021da177e4SLinus Torvalds u8 power; /* % Power (compared to P0) */ 3031da177e4SLinus Torvalds u8 performance; /* % Performance ( " ) */ 3041da177e4SLinus Torvalds int latency; /* Px->P0 time (microseconds) */ 3051da177e4SLinus Torvalds }; 3061da177e4SLinus Torvalds 3071da177e4SLinus Torvalds struct acpi_device_perf { 3081da177e4SLinus Torvalds int state; 3091da177e4SLinus Torvalds struct acpi_device_perf_flags flags; 3101da177e4SLinus Torvalds int state_count; 3111da177e4SLinus Torvalds struct acpi_device_perf_state *states; 3121da177e4SLinus Torvalds }; 3131da177e4SLinus Torvalds 3141da177e4SLinus Torvalds /* Wakeup Management */ 3151da177e4SLinus Torvalds struct acpi_device_wakeup_flags { 3161da177e4SLinus Torvalds u8 valid:1; /* Can successfully enable wakeup? */ 3171da177e4SLinus Torvalds u8 run_wake:1; /* Run-Wake GPE devices */ 318b67ea761SRafael J. Wysocki u8 notifier_present:1; /* Wake-up notify handler has been installed */ 319175f8e26SRafael J. Wysocki u8 enabled:1; /* Enabled for wakeup */ 3201da177e4SLinus Torvalds }; 3211da177e4SLinus Torvalds 322c072530fSRafael J. Wysocki struct acpi_device_wakeup_context { 323c072530fSRafael J. Wysocki struct work_struct work; 324c072530fSRafael J. Wysocki struct device *dev; 325c072530fSRafael J. Wysocki }; 326c072530fSRafael J. Wysocki 3271da177e4SLinus Torvalds struct acpi_device_wakeup { 3281da177e4SLinus Torvalds acpi_handle gpe_device; 329439913ffSLin Ming u64 gpe_number; 330439913ffSLin Ming u64 sleep_state; 331993cbe59SRafael J. Wysocki struct list_head resources; 3321da177e4SLinus Torvalds struct acpi_device_wakeup_flags flags; 333c072530fSRafael J. Wysocki struct acpi_device_wakeup_context context; 334c072530fSRafael J. Wysocki struct wakeup_source *ws; 3359b83ccd2SRafael J. Wysocki int prepare_count; 3361da177e4SLinus Torvalds }; 3371da177e4SLinus Torvalds 3381033f904SLan Tianyu struct acpi_device_physical_node { 339007ccfcfSRafael J. Wysocki unsigned int node_id; 3401033f904SLan Tianyu struct list_head node; 3411033f904SLan Tianyu struct device *dev; 342683058e3SRafael J. Wysocki bool put_online:1; 3431033f904SLan Tianyu }; 3441da177e4SLinus Torvalds 345ffdcd955SMika Westerberg /* ACPI Device Specific Data (_DSD) */ 346ffdcd955SMika Westerberg struct acpi_device_data { 347ffdcd955SMika Westerberg const union acpi_object *pointer; 348ffdcd955SMika Westerberg const union acpi_object *properties; 349733e6251SMika Westerberg const union acpi_object *of_compatible; 350445b0eb0SRafael J. Wysocki struct list_head subnodes; 351ffdcd955SMika Westerberg }; 352ffdcd955SMika Westerberg 353f028d524SRafael J. Wysocki struct acpi_gpio_mapping; 354f028d524SRafael J. Wysocki 3551033f904SLan Tianyu /* Device */ 3561da177e4SLinus Torvalds struct acpi_device { 357caaa6efbSBjorn Helgaas int device_type; 358caaa6efbSBjorn Helgaas acpi_handle handle; /* no handle for fixed hardware */ 3598a0662d9SRafael J. Wysocki struct fwnode_handle fwnode; 3601da177e4SLinus Torvalds struct acpi_device *parent; 3611da177e4SLinus Torvalds struct list_head children; 3621da177e4SLinus Torvalds struct list_head node; 3631da177e4SLinus Torvalds struct list_head wakeup_list; 364d783156eSRafael J. Wysocki struct list_head del_list; 3651da177e4SLinus Torvalds struct acpi_device_status status; 3661da177e4SLinus Torvalds struct acpi_device_flags flags; 3671da177e4SLinus Torvalds struct acpi_device_pnp pnp; 3681da177e4SLinus Torvalds struct acpi_device_power power; 3691da177e4SLinus Torvalds struct acpi_device_wakeup wakeup; 3701da177e4SLinus Torvalds struct acpi_device_perf performance; 3711da177e4SLinus Torvalds struct acpi_device_dir dir; 372ffdcd955SMika Westerberg struct acpi_device_data data; 373ca589f94SRafael J. Wysocki struct acpi_scan_handler *handler; 3743c2cc7ffSRafael J. Wysocki struct acpi_hotplug_context *hp; 3751da177e4SLinus Torvalds struct acpi_driver *driver; 376f028d524SRafael J. Wysocki const struct acpi_gpio_mapping *driver_gpios; 3771da177e4SLinus Torvalds void *driver_data; 3785b327265SPatrick Mochel struct device dev; 379007ccfcfSRafael J. Wysocki unsigned int physical_node_count; 38040e7fcb1SLan Tianyu unsigned int dep_unmet; 3811033f904SLan Tianyu struct list_head physical_node_list; 3821033f904SLan Tianyu struct mutex physical_node_lock; 383b1c0f99bSRafael J. Wysocki void (*remove)(struct acpi_device *); 3841da177e4SLinus Torvalds }; 3851da177e4SLinus Torvalds 386445b0eb0SRafael J. Wysocki /* Non-device subnode */ 387445b0eb0SRafael J. Wysocki struct acpi_data_node { 388445b0eb0SRafael J. Wysocki const char *name; 389263b4c1aSRafael J. Wysocki acpi_handle handle; 390445b0eb0SRafael J. Wysocki struct fwnode_handle fwnode; 391dfa672fbSMika Westerberg struct fwnode_handle *parent; 392445b0eb0SRafael J. Wysocki struct acpi_device_data data; 393445b0eb0SRafael J. Wysocki struct list_head sibling; 394263b4c1aSRafael J. Wysocki struct kobject kobj; 395263b4c1aSRafael J. Wysocki struct completion kobj_done; 396445b0eb0SRafael J. Wysocki }; 397445b0eb0SRafael J. Wysocki 3988a0662d9SRafael J. Wysocki static inline bool is_acpi_node(struct fwnode_handle *fwnode) 3998a0662d9SRafael J. Wysocki { 4000224a4a3SHeikki Krogerus return !IS_ERR_OR_NULL(fwnode) && (fwnode->type == FWNODE_ACPI 4013a7a2ab8SRafael J. Wysocki || fwnode->type == FWNODE_ACPI_DATA); 4023a7a2ab8SRafael J. Wysocki } 4033a7a2ab8SRafael J. Wysocki 4043a7a2ab8SRafael J. Wysocki static inline bool is_acpi_device_node(struct fwnode_handle *fwnode) 4053a7a2ab8SRafael J. Wysocki { 4060224a4a3SHeikki Krogerus return !IS_ERR_OR_NULL(fwnode) && fwnode->type == FWNODE_ACPI; 4078a0662d9SRafael J. Wysocki } 4088a0662d9SRafael J. Wysocki 4093a7a2ab8SRafael J. Wysocki static inline struct acpi_device *to_acpi_device_node(struct fwnode_handle *fwnode) 4108a0662d9SRafael J. Wysocki { 4113a7a2ab8SRafael J. Wysocki return is_acpi_device_node(fwnode) ? 412ce793486SRafael J. Wysocki container_of(fwnode, struct acpi_device, fwnode) : NULL; 4138a0662d9SRafael J. Wysocki } 4148a0662d9SRafael J. Wysocki 4153a7a2ab8SRafael J. Wysocki static inline bool is_acpi_data_node(struct fwnode_handle *fwnode) 4163a7a2ab8SRafael J. Wysocki { 4173a7a2ab8SRafael J. Wysocki return fwnode && fwnode->type == FWNODE_ACPI_DATA; 4183a7a2ab8SRafael J. Wysocki } 4193a7a2ab8SRafael J. Wysocki 4203a7a2ab8SRafael J. Wysocki static inline struct acpi_data_node *to_acpi_data_node(struct fwnode_handle *fwnode) 4213a7a2ab8SRafael J. Wysocki { 4223a7a2ab8SRafael J. Wysocki return is_acpi_data_node(fwnode) ? 4233a7a2ab8SRafael J. Wysocki container_of(fwnode, struct acpi_data_node, fwnode) : NULL; 4243a7a2ab8SRafael J. Wysocki } 4253a7a2ab8SRafael J. Wysocki 426613e9721SAdam Thomson static inline bool acpi_data_node_match(struct fwnode_handle *fwnode, 427613e9721SAdam Thomson const char *name) 428613e9721SAdam Thomson { 429613e9721SAdam Thomson return is_acpi_data_node(fwnode) ? 430613e9721SAdam Thomson (!strcmp(to_acpi_data_node(fwnode)->name, name)) : false; 431613e9721SAdam Thomson } 432613e9721SAdam Thomson 4338a0662d9SRafael J. Wysocki static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev) 4348a0662d9SRafael J. Wysocki { 4358a0662d9SRafael J. Wysocki return &adev->fwnode; 4368a0662d9SRafael J. Wysocki } 4378a0662d9SRafael J. Wysocki 438db89b4f0SPavel Machek static inline void *acpi_driver_data(struct acpi_device *d) 439db89b4f0SPavel Machek { 440db89b4f0SPavel Machek return d->driver_data; 441db89b4f0SPavel Machek } 442db89b4f0SPavel Machek 443d43ec68eSPatrick Mochel #define to_acpi_device(d) container_of(d, struct acpi_device, dev) 444d43ec68eSPatrick Mochel #define to_acpi_driver(d) container_of(d, struct acpi_driver, drv) 4451da177e4SLinus Torvalds 44625db115bSRafael J. Wysocki static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta) 44725db115bSRafael J. Wysocki { 44825db115bSRafael J. Wysocki *((u32 *)&adev->status) = sta; 44925db115bSRafael J. Wysocki } 45025db115bSRafael J. Wysocki 4513c2cc7ffSRafael J. Wysocki static inline void acpi_set_hp_context(struct acpi_device *adev, 452ba574dc8SRafael J. Wysocki struct acpi_hotplug_context *hp) 4533c2cc7ffSRafael J. Wysocki { 4543c2cc7ffSRafael J. Wysocki hp->self = adev; 4553c2cc7ffSRafael J. Wysocki adev->hp = hp; 4563c2cc7ffSRafael J. Wysocki } 4573c2cc7ffSRafael J. Wysocki 4585d513205SRafael J. Wysocki void acpi_initialize_hp_context(struct acpi_device *adev, 4595d513205SRafael J. Wysocki struct acpi_hotplug_context *hp, 4605d513205SRafael J. Wysocki int (*notify)(struct acpi_device *, u32), 4615d513205SRafael J. Wysocki void (*uevent)(struct acpi_device *, u32)); 4625d513205SRafael J. Wysocki 46355955aadSDavid Brownell /* acpi_device.dev.bus == &acpi_bus_type */ 46455955aadSDavid Brownell extern struct bus_type acpi_bus_type; 46555955aadSDavid Brownell 4661da177e4SLinus Torvalds /* 4671da177e4SLinus Torvalds * Events 4681da177e4SLinus Torvalds * ------ 4691da177e4SLinus Torvalds */ 4701da177e4SLinus Torvalds 4711da177e4SLinus Torvalds struct acpi_bus_event { 4721da177e4SLinus Torvalds struct list_head node; 4731da177e4SLinus Torvalds acpi_device_class device_class; 4741da177e4SLinus Torvalds acpi_bus_id bus_id; 4751da177e4SLinus Torvalds u32 type; 4761da177e4SLinus Torvalds u32 data; 4771da177e4SLinus Torvalds }; 4781da177e4SLinus Torvalds 47999e0d2fcSGreg Kroah-Hartman extern struct kobject *acpi_kobj; 480962ce8caSZhang Rui extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int); 4818e4319c4SBob Moore void acpi_bus_private_data_handler(acpi_handle, void *); 48220733939SZhang Rui int acpi_bus_get_private_data(acpi_handle, void **); 48372013795SLan Tianyu int acpi_bus_attach_private_data(acpi_handle, void *); 48472013795SLan Tianyu void acpi_bus_detach_private_data(acpi_handle); 4859ee85241SZhang Rui extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32); 4869ee85241SZhang Rui extern int register_acpi_notifier(struct notifier_block *); 4879ee85241SZhang Rui extern int unregister_acpi_notifier(struct notifier_block *); 4886bd00a61SShaohua Li 4891da177e4SLinus Torvalds /* 4901da177e4SLinus Torvalds * External Functions 4911da177e4SLinus Torvalds */ 4921da177e4SLinus Torvalds 4931da177e4SLinus Torvalds int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device); 49478ea4639SRafael J. Wysocki struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle); 49578ea4639SRafael J. Wysocki void acpi_bus_put_acpi_device(struct acpi_device *adev); 496402ac536SBjorn Helgaas acpi_status acpi_bus_get_status_handle(acpi_handle handle, 497402ac536SBjorn Helgaas unsigned long long *sta); 4981da177e4SLinus Torvalds int acpi_bus_get_status(struct acpi_device *device); 4999ce4e607SRafael J. Wysocki 5001da177e4SLinus Torvalds int acpi_bus_set_power(acpi_handle handle, int state); 50196bfd3ceSRafael J. Wysocki const char *acpi_power_state_string(int state); 502ad0c3b0eSRafael J. Wysocki int acpi_device_get_power(struct acpi_device *device, int *state); 503078eb126SRafael J. Wysocki int acpi_device_set_power(struct acpi_device *device, int state); 5049ce4e607SRafael J. Wysocki int acpi_bus_init_power(struct acpi_device *device); 505b9e95fc6SRafael J. Wysocki int acpi_device_fix_up_power(struct acpi_device *device); 50625eed407SRafael J. Wysocki int acpi_bus_update_power(acpi_handle handle, int *state_p); 5072bb3a2bfSAaron Lu int acpi_device_update_power(struct acpi_device *device, int *state_p); 5083737b2b1SRafael J. Wysocki bool acpi_bus_power_manageable(acpi_handle handle); 509ec4602a9SRafael J. Wysocki 510ec4602a9SRafael J. Wysocki #ifdef CONFIG_PM 511eb9d0fe4SRafael J. Wysocki bool acpi_bus_can_wakeup(acpi_handle handle); 512ec4602a9SRafael J. Wysocki #else 513ec4602a9SRafael J. Wysocki static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; } 514ec4602a9SRafael J. Wysocki #endif 5159ce4e607SRafael J. Wysocki 5163757b948SRafael J. Wysocki void acpi_scan_lock_acquire(void); 5173757b948SRafael J. Wysocki void acpi_scan_lock_release(void); 518e525506fSRafael J. Wysocki void acpi_lock_hp_context(void); 519e525506fSRafael J. Wysocki void acpi_unlock_hp_context(void); 520ca589f94SRafael J. Wysocki int acpi_scan_add_handler(struct acpi_scan_handler *handler); 5211da177e4SLinus Torvalds int acpi_bus_register_driver(struct acpi_driver *driver); 52206ea8e08SBjorn Helgaas void acpi_bus_unregister_driver(struct acpi_driver *driver); 523b8bd759aSRafael J. Wysocki int acpi_bus_scan(acpi_handle handle); 524bfee26dbSRafael J. Wysocki void acpi_bus_trim(struct acpi_device *start); 525c8f7a62cSLen Brown acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd); 5268c8eb78fSThomas Renninger int acpi_match_device_ids(struct acpi_device *device, 5278c8eb78fSThomas Renninger const struct acpi_device_id *ids); 52851ede5d9SDan O'Donovan void acpi_set_modalias(struct acpi_device *adev, const char *default_id, 52951ede5d9SDan O'Donovan char *modalias, size_t len); 5301da177e4SLinus Torvalds int acpi_create_dir(struct acpi_device *); 5311da177e4SLinus Torvalds void acpi_remove_dir(struct acpi_device *); 5321da177e4SLinus Torvalds 533202317a5SRafael J. Wysocki static inline bool acpi_device_enumerated(struct acpi_device *adev) 534202317a5SRafael J. Wysocki { 535202317a5SRafael J. Wysocki return adev && adev->flags.initialized && adev->flags.visited; 536202317a5SRafael J. Wysocki } 537202317a5SRafael J. Wysocki 5380d2cf8f5SMika Westerberg /** 5390d2cf8f5SMika Westerberg * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver 5400d2cf8f5SMika Westerberg * @__acpi_driver: acpi_driver struct 5410d2cf8f5SMika Westerberg * 5420d2cf8f5SMika Westerberg * Helper macro for ACPI drivers which do not do anything special in module 5430d2cf8f5SMika Westerberg * init/exit. This eliminates a lot of boilerplate. Each module may only 5440d2cf8f5SMika Westerberg * use this macro once, and calling it replaces module_init() and module_exit() 5450d2cf8f5SMika Westerberg */ 5460d2cf8f5SMika Westerberg #define module_acpi_driver(__acpi_driver) \ 5470d2cf8f5SMika Westerberg module_driver(__acpi_driver, acpi_bus_register_driver, \ 5480d2cf8f5SMika Westerberg acpi_bus_unregister_driver) 5490d2cf8f5SMika Westerberg 5504e10d12aSDavid Shaohua Li /* 5514e10d12aSDavid Shaohua Li * Bind physical devices with ACPI devices 5524e10d12aSDavid Shaohua Li */ 5534e10d12aSDavid Shaohua Li struct acpi_bus_type { 5544e10d12aSDavid Shaohua Li struct list_head list; 55553540098SRafael J. Wysocki const char *name; 55653540098SRafael J. Wysocki bool (*match)(struct device *dev); 557e3f02c52SRafael J. Wysocki struct acpi_device * (*find_companion)(struct device *); 55811909ca1SRafael J. Wysocki void (*setup)(struct device *); 55911909ca1SRafael J. Wysocki void (*cleanup)(struct device *); 5604e10d12aSDavid Shaohua Li }; 5614e10d12aSDavid Shaohua Li int register_acpi_bus_type(struct acpi_bus_type *); 5624e10d12aSDavid Shaohua Li int unregister_acpi_bus_type(struct acpi_bus_type *); 563f1b1dc84SZhang Rui int acpi_bind_one(struct device *dev, struct acpi_device *adev); 564f1b1dc84SZhang Rui int acpi_unbind_one(struct device *dev); 56522c13f9dSThomas Renninger 56676d56de5SAlex Chiang struct acpi_pci_root { 56776d56de5SAlex Chiang struct acpi_device * device; 56876d56de5SAlex Chiang struct pci_bus *bus; 56976d56de5SAlex Chiang u16 segment; 5706ad95513SBjorn Helgaas struct resource secondary; /* downstream bus range */ 57176d56de5SAlex Chiang 57276d56de5SAlex Chiang u32 osc_support_set; /* _OSC state of support bits */ 57376d56de5SAlex Chiang u32 osc_control_set; /* _OSC state of control bits */ 574f4b57a3bSJiang Liu phys_addr_t mcfg_addr; 57576d56de5SAlex Chiang }; 57676d56de5SAlex Chiang 5774e10d12aSDavid Shaohua Li /* helper */ 578d9fef0c4SRafael J. Wysocki 579b84f196dSSuthikulpanit, Suravee bool acpi_dma_supported(struct acpi_device *adev); 580b84f196dSSuthikulpanit, Suravee enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev); 5815a1bb638SSricharan R int acpi_dma_configure(struct device *dev, enum dev_dma_attr attr); 582d760a1baSLorenzo Pieralisi void acpi_dma_deconfigure(struct device *dev); 583b84f196dSSuthikulpanit, Suravee 584d9fef0c4SRafael J. Wysocki struct acpi_device *acpi_find_child_device(struct acpi_device *parent, 585d9fef0c4SRafael J. Wysocki u64 address, bool check_children); 58627558203SAlexander Chiang int acpi_is_root_bridge(acpi_handle); 58776d56de5SAlex Chiang struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle); 5884e10d12aSDavid Shaohua Li 589b67ea761SRafael J. Wysocki int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state); 590b67ea761SRafael J. Wysocki int acpi_disable_wakeup_device_power(struct acpi_device *dev); 591b67ea761SRafael J. Wysocki 592b7ecf663SHans de Goede #ifdef CONFIG_X86 593b7ecf663SHans de Goede bool acpi_device_always_present(struct acpi_device *adev); 594b7ecf663SHans de Goede #else 595b7ecf663SHans de Goede static inline bool acpi_device_always_present(struct acpi_device *adev) 596b7ecf663SHans de Goede { 597b7ecf663SHans de Goede return false; 598b7ecf663SHans de Goede } 599b7ecf663SHans de Goede #endif 600b7ecf663SHans de Goede 601aa338601SRafael J. Wysocki #ifdef CONFIG_PM 602c072530fSRafael J. Wysocki acpi_status acpi_add_pm_notifier(struct acpi_device *adev, struct device *dev, 603c072530fSRafael J. Wysocki void (*work_func)(struct work_struct *work)); 604c072530fSRafael J. Wysocki acpi_status acpi_remove_pm_notifier(struct acpi_device *adev); 605ee85f543SHuang Ying int acpi_pm_device_sleep_state(struct device *, int *, int); 6065de21bb9SRafael J. Wysocki int acpi_pm_device_run_wake(struct device *, bool); 607761afb86SRafael J. Wysocki #else 608ec2cd81cSRafael J. Wysocki static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev, 609c072530fSRafael J. Wysocki struct device *dev, 610c072530fSRafael J. Wysocki void (*work_func)(struct work_struct *work)) 611ec2cd81cSRafael J. Wysocki { 612ec2cd81cSRafael J. Wysocki return AE_SUPPORT; 613ec2cd81cSRafael J. Wysocki } 614c072530fSRafael J. Wysocki static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev) 615ec2cd81cSRafael J. Wysocki { 616ec2cd81cSRafael J. Wysocki return AE_SUPPORT; 617ec2cd81cSRafael J. Wysocki } 618b25c77efSRafael J. Wysocki static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m) 619296699deSRafael J. Wysocki { 620296699deSRafael J. Wysocki if (p) 621296699deSRafael J. Wysocki *p = ACPI_STATE_D0; 622b25c77efSRafael J. Wysocki 6238ad928d5SRafael J. Wysocki return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ? 6248ad928d5SRafael J. Wysocki m : ACPI_STATE_D0; 625296699deSRafael J. Wysocki } 626b24e5098SLin Ming static inline int acpi_pm_device_run_wake(struct device *dev, bool enable) 627b24e5098SLin Ming { 628b24e5098SLin Ming return -ENODEV; 629b24e5098SLin Ming } 630761afb86SRafael J. Wysocki #endif 631761afb86SRafael J. Wysocki 632761afb86SRafael J. Wysocki #ifdef CONFIG_PM_SLEEP 633761afb86SRafael J. Wysocki int acpi_pm_device_sleep_wake(struct device *, bool); 634f7a1b860SDavid Howells #else 635f7a1b860SDavid Howells static inline int acpi_pm_device_sleep_wake(struct device *dev, bool enable) 636f7a1b860SDavid Howells { 637f7a1b860SDavid Howells return -ENODEV; 638f7a1b860SDavid Howells } 639761afb86SRafael J. Wysocki #endif 640fd4aff1aSShaohua Li 64199926a8cSDavid Rientjes #ifdef CONFIG_ACPI_SLEEP 64299926a8cSDavid Rientjes u32 acpi_target_system_state(void); 64399926a8cSDavid Rientjes #else 64499926a8cSDavid Rientjes static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; } 64599926a8cSDavid Rientjes #endif 64699926a8cSDavid Rientjes 647078eb126SRafael J. Wysocki static inline bool acpi_device_power_manageable(struct acpi_device *adev) 648078eb126SRafael J. Wysocki { 649078eb126SRafael J. Wysocki return adev->flags.power_manageable; 650078eb126SRafael J. Wysocki } 651078eb126SRafael J. Wysocki 652078eb126SRafael J. Wysocki static inline bool acpi_device_can_wakeup(struct acpi_device *adev) 653078eb126SRafael J. Wysocki { 654078eb126SRafael J. Wysocki return adev->wakeup.flags.valid; 655078eb126SRafael J. Wysocki } 656078eb126SRafael J. Wysocki 6571399dfcdSAaron Lu static inline bool acpi_device_can_poweroff(struct acpi_device *adev) 6581399dfcdSAaron Lu { 659cd7f84c0SKen Xue return adev->power.states[ACPI_STATE_D3_COLD].flags.valid || 660cd7f84c0SKen Xue ((acpi_gbl_FADT.header.revision < 6) && 661cd7f84c0SKen Xue adev->power.states[ACPI_STATE_D3_HOT].flags.explicit_set); 6621399dfcdSAaron Lu } 6631399dfcdSAaron Lu 66466886d6fSMatthew Garrett #else /* CONFIG_ACPI */ 66566886d6fSMatthew Garrett 6667ae30986SLen Brown static inline int register_acpi_bus_type(void *bus) { return 0; } 6677ae30986SLen Brown static inline int unregister_acpi_bus_type(void *bus) { return 0; } 66866886d6fSMatthew Garrett 66976f58584SLen Brown #endif /* CONFIG_ACPI */ 6701da177e4SLinus Torvalds 6711da177e4SLinus Torvalds #endif /*__ACPI_BUS_H__*/ 672