blob: dd9b5edc7630e02d216304cc2d6459d663d713f3 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * acpi_bus.h - ACPI Bus Driver ($Revision: 22 $)
3 *
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
6 *
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or (at
12 * your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
22 *
23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
24 */
25
26#ifndef __ACPI_BUS_H__
27#define __ACPI_BUS_H__
28
Patrick Mochel5b327262006-05-10 10:33:00 -040029#include <linux/device.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030
31#include <acpi/acpi.h>
32
Linus Torvalds1da177e2005-04-16 15:20:36 -070033/* TBD: Make dynamic */
34#define ACPI_MAX_HANDLES 10
35struct acpi_handle_list {
Len Brown4be44fc2005-08-05 00:44:28 -040036 u32 count;
37 acpi_handle handles[ACPI_MAX_HANDLES];
Linus Torvalds1da177e2005-04-16 15:20:36 -070038};
39
Linus Torvalds1da177e2005-04-16 15:20:36 -070040/* acpi_utils.h */
41acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040042acpi_extract_package(union acpi_object *package,
43 struct acpi_buffer *format, struct acpi_buffer *buffer);
Linus Torvalds1da177e2005-04-16 15:20:36 -070044acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040045acpi_evaluate_integer(acpi_handle handle,
46 acpi_string pathname,
Matthew Wilcox27663c52008-10-10 02:22:59 -040047 struct acpi_object_list *arguments, unsigned long long *data);
Linus Torvalds1da177e2005-04-16 15:20:36 -070048acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040049acpi_evaluate_reference(acpi_handle handle,
50 acpi_string pathname,
51 struct acpi_object_list *arguments,
52 struct acpi_handle_list *list);
Toshi Kani275c58d2012-05-23 20:25:19 -060053acpi_status
54acpi_evaluate_hotplug_ost(acpi_handle handle, u32 source_event,
55 u32 status_code, struct acpi_buffer *status_buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -070056
Matthew Garrett38ac0f12012-05-11 16:08:26 +080057acpi_status
Feng Tang8ede06a2012-08-21 09:56:58 +080058acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld);
Jiang Liu952c63e2013-06-29 00:24:38 +080059
60bool acpi_has_method(acpi_handle handle, char *name);
Jiang Liu0db98202013-06-29 00:24:39 +080061acpi_status acpi_execute_simple_method(acpi_handle handle, char *method,
62 u64 arg);
Jiang Liu7d2421f2013-06-29 00:24:40 +080063acpi_status acpi_evaluate_ej0(acpi_handle handle);
64acpi_status acpi_evaluate_lck(acpi_handle handle, int lock);
Jiang Liuebf4df82013-06-29 00:24:41 +080065bool acpi_ata_match(acpi_handle handle);
66bool acpi_bay_match(acpi_handle handle);
67bool acpi_dock_match(acpi_handle handle);
Jiang Liu952c63e2013-06-29 00:24:38 +080068
Jiang Liua65ac522013-12-19 20:38:10 +080069bool acpi_check_dsm(acpi_handle handle, const u8 *uuid, int rev, u64 funcs);
70union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const u8 *uuid,
71 int rev, int func, union acpi_object *argv4);
72
73static inline union acpi_object *
74acpi_evaluate_dsm_typed(acpi_handle handle, const u8 *uuid, int rev, int func,
75 union acpi_object *argv4, acpi_object_type type)
76{
77 union acpi_object *obj;
78
79 obj = acpi_evaluate_dsm(handle, uuid, rev, func, argv4);
80 if (obj && obj->type != type) {
81 ACPI_FREE(obj);
82 obj = NULL;
83 }
84
85 return obj;
86}
87
88#define ACPI_INIT_DSM_ARGV4(cnt, eles) \
89 { \
90 .package.type = ACPI_TYPE_PACKAGE, \
91 .package.count = (cnt), \
92 .package.elements = (eles) \
93 }
94
Len Brown76f58582005-08-24 12:10:49 -040095#ifdef CONFIG_ACPI
Linus Torvalds1da177e2005-04-16 15:20:36 -070096
97#include <linux/proc_fs.h>
98
99#define ACPI_BUS_FILE_ROOT "acpi"
Len Brown4be44fc2005-08-05 00:44:28 -0400100extern struct proc_dir_entry *acpi_root_dir;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102enum acpi_bus_device_type {
Len Brown4be44fc2005-08-05 00:44:28 -0400103 ACPI_BUS_TYPE_DEVICE = 0,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700104 ACPI_BUS_TYPE_POWER,
105 ACPI_BUS_TYPE_PROCESSOR,
106 ACPI_BUS_TYPE_THERMAL,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 ACPI_BUS_TYPE_POWER_BUTTON,
108 ACPI_BUS_TYPE_SLEEP_BUTTON,
109 ACPI_BUS_DEVICE_TYPE_COUNT
110};
111
112struct acpi_driver;
113struct acpi_device;
114
Linus Torvalds1da177e2005-04-16 15:20:36 -0700115/*
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100116 * ACPI Scan Handler
117 * -----------------
118 */
119
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100120enum acpi_hotplug_mode {
121 AHM_GENERIC = 0,
122 AHM_CONTAINER,
123 AHM_COUNT
124};
125
126struct acpi_hotplug_profile {
Rafael J. Wysocki3f8055c2013-03-03 23:08:16 +0100127 struct kobject kobj;
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100128 bool enabled:1;
Toshi Kanica499fc2013-11-20 14:25:34 +0100129 bool ignore:1;
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100130 enum acpi_hotplug_mode mode;
131};
132
Rafael J. Wysocki3f8055c2013-03-03 23:08:16 +0100133static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile(
134 struct kobject *kobj)
135{
136 return container_of(kobj, struct acpi_hotplug_profile, kobj);
137}
138
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100139struct acpi_scan_handler {
140 const struct acpi_device_id *ids;
141 struct list_head list_node;
142 int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id);
143 void (*detach)(struct acpi_device *dev);
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100144 struct acpi_hotplug_profile hotplug;
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100145};
146
147/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700148 * ACPI Driver
149 * -----------
150 */
151
Len Brown4be44fc2005-08-05 00:44:28 -0400152typedef int (*acpi_op_add) (struct acpi_device * device);
Rafael J. Wysocki51fac832013-01-24 00:24:48 +0100153typedef int (*acpi_op_remove) (struct acpi_device * device);
Bjorn Helgaas46ec8592009-03-30 17:48:13 +0000154typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700155
156struct acpi_device_ops {
Len Brown4be44fc2005-08-05 00:44:28 -0400157 acpi_op_add add;
158 acpi_op_remove remove;
Bjorn Helgaas46ec8592009-03-30 17:48:13 +0000159 acpi_op_notify notify;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700160};
161
Bjorn Helgaas6d278132009-04-30 09:35:37 -0600162#define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */
163
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164struct acpi_driver {
Len Brown4be44fc2005-08-05 00:44:28 -0400165 char name[80];
166 char class[80];
Thomas Renninger8c8eb782007-07-23 14:43:32 +0200167 const struct acpi_device_id *ids; /* Supported Hardware IDs */
Bjorn Helgaas6d278132009-04-30 09:35:37 -0600168 unsigned int flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400169 struct acpi_device_ops ops;
Patrick Mocheld43ec682006-12-07 20:56:23 +0800170 struct device_driver drv;
Patrick Mochel1890a972006-12-07 20:56:31 +0800171 struct module *owner;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172};
173
174/*
175 * ACPI Device
176 * -----------
177 */
178
179/* Status (_STA) */
180
181struct acpi_device_status {
Len Brown4be44fc2005-08-05 00:44:28 -0400182 u32 present:1;
183 u32 enabled:1;
184 u32 show_in_ui:1;
185 u32 functional:1;
186 u32 battery_present:1;
187 u32 reserved:27;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700188};
189
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190/* Flags */
191
192struct acpi_device_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400193 u32 dynamic_status:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400194 u32 removable:1;
195 u32 ejectable:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400196 u32 power_manageable:1;
Rafael J. Wysocki209d3b12012-12-21 00:36:48 +0100197 u32 match_driver:1;
Rafael J. Wysockif244d8b2013-12-31 13:39:42 +0100198 u32 no_hotplug:1;
199 u32 reserved:26;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700200};
201
Linus Torvalds1da177e2005-04-16 15:20:36 -0700202/* File System */
203
204struct acpi_device_dir {
Len Brown4be44fc2005-08-05 00:44:28 -0400205 struct proc_dir_entry *entry;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206};
207
208#define acpi_device_dir(d) ((d)->dir.entry)
209
Linus Torvalds1da177e2005-04-16 15:20:36 -0700210/* Plug and Play */
211
Zhao Yakui24c5c4c2009-05-21 16:25:35 +0800212typedef char acpi_bus_id[8];
Len Brown4be44fc2005-08-05 00:44:28 -0400213typedef unsigned long acpi_bus_address;
Len Brown4be44fc2005-08-05 00:44:28 -0400214typedef char acpi_device_name[40];
215typedef char acpi_device_class[20];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700216
Bjorn Helgaas7f47fa62009-09-21 13:35:19 -0600217struct acpi_hardware_id {
218 struct list_head list;
219 char *id;
220};
221
Toshi Kanid4e1a692013-03-04 21:30:41 +0000222struct acpi_pnp_type {
223 u32 hardware_id:1;
224 u32 bus_address:1;
225 u32 reserved:30;
226};
227
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228struct acpi_device_pnp {
Toshi Kanid4e1a692013-03-04 21:30:41 +0000229 acpi_bus_id bus_id; /* Object name */
230 struct acpi_pnp_type type; /* ID type */
Len Brown4be44fc2005-08-05 00:44:28 -0400231 acpi_bus_address bus_address; /* _ADR */
Toshi Kanid4e1a692013-03-04 21:30:41 +0000232 char *unique_id; /* _UID */
Bjorn Helgaas7f47fa62009-09-21 13:35:19 -0600233 struct list_head ids; /* _HID and _CIDs */
Len Brown4be44fc2005-08-05 00:44:28 -0400234 acpi_device_name device_name; /* Driver-determined */
235 acpi_device_class device_class; /* " */
Lance Ortizd1efe3c2012-10-02 12:43:23 -0600236 union acpi_object *str_obj; /* unicode string for _STR method */
Yasuaki Ishimatsubb74ac22012-11-16 02:56:59 +0100237 unsigned long sun; /* _SUN */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700238};
239
240#define acpi_device_bid(d) ((d)->pnp.bus_id)
241#define acpi_device_adr(d) ((d)->pnp.bus_address)
Thomas Renninger620e1122010-10-01 10:54:00 +0200242const char *acpi_device_hid(struct acpi_device *device);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700243#define acpi_device_name(d) ((d)->pnp.device_name)
244#define acpi_device_class(d) ((d)->pnp.device_class)
245
Linus Torvalds1da177e2005-04-16 15:20:36 -0700246/* Power Management */
247
248struct acpi_device_power_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400249 u32 explicit_get:1; /* _PSC present? */
250 u32 power_resources:1; /* Power resources */
251 u32 inrush_current:1; /* Serialize Dx->D0 */
252 u32 power_removed:1; /* Optimize Dx->D0 */
Mika Westerberg644f17a2013-10-10 13:28:46 +0300253 u32 ignore_parent:1; /* Power is independent of parent power state */
254 u32 reserved:27;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700255};
256
257struct acpi_device_power_state {
258 struct {
Len Brown4be44fc2005-08-05 00:44:28 -0400259 u8 valid:1;
Aaron Lu1399dfc2012-11-21 23:33:40 +0100260 u8 os_accessible:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400261 u8 explicit_set:1; /* _PSx present? */
262 u8 reserved:6;
263 } flags;
264 int power; /* % Power (compared to D0) */
265 int latency; /* Dx->D0 time (microseconds) */
Rafael J. Wysocki0b224522013-01-17 14:11:06 +0100266 struct list_head resources; /* Power resources referenced */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700267};
268
269struct acpi_device_power {
Len Brown4be44fc2005-08-05 00:44:28 -0400270 int state; /* Current state */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700271 struct acpi_device_power_flags flags;
Lin Mingb4a03b92011-06-01 23:54:02 +0800272 struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700273};
274
Linus Torvalds1da177e2005-04-16 15:20:36 -0700275/* Performance Management */
276
277struct acpi_device_perf_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400278 u8 reserved:8;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700279};
280
281struct acpi_device_perf_state {
282 struct {
Len Brown4be44fc2005-08-05 00:44:28 -0400283 u8 valid:1;
284 u8 reserved:7;
285 } flags;
286 u8 power; /* % Power (compared to P0) */
287 u8 performance; /* % Performance ( " ) */
288 int latency; /* Px->P0 time (microseconds) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700289};
290
291struct acpi_device_perf {
Len Brown4be44fc2005-08-05 00:44:28 -0400292 int state;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700293 struct acpi_device_perf_flags flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400294 int state_count;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700295 struct acpi_device_perf_state *states;
296};
297
298/* Wakeup Management */
299struct acpi_device_wakeup_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400300 u8 valid:1; /* Can successfully enable wakeup? */
301 u8 run_wake:1; /* Run-Wake GPE devices */
Rafael J. Wysockib67ea762010-02-17 23:44:09 +0100302 u8 notifier_present:1; /* Wake-up notify handler has been installed */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700303};
304
Linus Torvalds1da177e2005-04-16 15:20:36 -0700305struct acpi_device_wakeup {
Len Brown4be44fc2005-08-05 00:44:28 -0400306 acpi_handle gpe_device;
Lin Ming439913f2010-01-28 10:53:19 +0800307 u64 gpe_number;
308 u64 sleep_state;
Rafael J. Wysocki993cbe52013-01-17 14:11:06 +0100309 struct list_head resources;
Len Brown4be44fc2005-08-05 00:44:28 -0400310 struct acpi_device_wakeup_flags flags;
Rafael J. Wysocki9b83ccd2009-09-08 23:15:31 +0200311 int prepare_count;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700312};
313
Lan Tianyu1033f902012-08-17 14:44:09 +0800314struct acpi_device_physical_node {
Rafael J. Wysocki007ccfc2013-08-06 14:32:54 +0200315 unsigned int node_id;
Lan Tianyu1033f902012-08-17 14:44:09 +0800316 struct list_head node;
317 struct device *dev;
Rafael J. Wysocki683058e2013-05-03 00:26:16 +0200318 bool put_online:1;
Lan Tianyu1033f902012-08-17 14:44:09 +0800319};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700320
Lan Tianyu1033f902012-08-17 14:44:09 +0800321/* Device */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700322struct acpi_device {
Bjorn Helgaascaaa6ef2009-09-21 19:29:10 +0000323 int device_type;
324 acpi_handle handle; /* no handle for fixed hardware */
Len Brown4be44fc2005-08-05 00:44:28 -0400325 struct acpi_device *parent;
326 struct list_head children;
327 struct list_head node;
328 struct list_head wakeup_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329 struct acpi_device_status status;
330 struct acpi_device_flags flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400331 struct acpi_device_pnp pnp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700332 struct acpi_device_power power;
333 struct acpi_device_wakeup wakeup;
Len Brown4be44fc2005-08-05 00:44:28 -0400334 struct acpi_device_perf performance;
335 struct acpi_device_dir dir;
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100336 struct acpi_scan_handler *handler;
Len Brown4be44fc2005-08-05 00:44:28 -0400337 struct acpi_driver *driver;
338 void *driver_data;
Patrick Mochel5b327262006-05-10 10:33:00 -0400339 struct device dev;
Rafael J. Wysocki007ccfc2013-08-06 14:32:54 +0200340 unsigned int physical_node_count;
Lan Tianyu1033f902012-08-17 14:44:09 +0800341 struct list_head physical_node_list;
342 struct mutex physical_node_lock;
Rafael J. Wysockib1c0f992013-01-24 12:50:09 +0100343 void (*remove)(struct acpi_device *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700344};
345
Pavel Machekdb89b4f2008-09-22 14:37:34 -0700346static inline void *acpi_driver_data(struct acpi_device *d)
347{
348 return d->driver_data;
349}
350
Patrick Mocheld43ec682006-12-07 20:56:23 +0800351#define to_acpi_device(d) container_of(d, struct acpi_device, dev)
352#define to_acpi_driver(d) container_of(d, struct acpi_driver, drv)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700353
David Brownell55955aa2007-05-08 00:28:35 -0700354/* acpi_device.dev.bus == &acpi_bus_type */
355extern struct bus_type acpi_bus_type;
356
Linus Torvalds1da177e2005-04-16 15:20:36 -0700357/*
358 * Events
359 * ------
360 */
361
362struct acpi_bus_event {
Len Brown4be44fc2005-08-05 00:44:28 -0400363 struct list_head node;
364 acpi_device_class device_class;
365 acpi_bus_id bus_id;
366 u32 type;
367 u32 data;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700368};
369
Greg Kroah-Hartman99e0d2f2007-11-02 16:19:59 -0700370extern struct kobject *acpi_kobj;
Zhang Rui962ce8c2007-08-23 01:24:31 +0800371extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int);
Bob Moore8e4319c2009-06-29 13:43:27 +0800372void acpi_bus_private_data_handler(acpi_handle, void *);
Zhang Rui20733932008-01-17 15:51:21 +0800373int acpi_bus_get_private_data(acpi_handle, void **);
Rafael J. Wysockif244d8b2013-12-31 13:39:42 +0100374void acpi_bus_no_hotplug(acpi_handle handle);
Zhang Rui9ee85242008-01-25 14:48:06 +0800375extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32);
376extern int register_acpi_notifier(struct notifier_block *);
377extern int unregister_acpi_notifier(struct notifier_block *);
Shaohua Li6bd00a62008-08-28 10:04:29 +0800378
Linus Torvalds1da177e2005-04-16 15:20:36 -0700379/*
380 * External Functions
381 */
382
383int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device);
Bjorn Helgaas402ac532009-09-21 19:30:01 +0000384acpi_status acpi_bus_get_status_handle(acpi_handle handle,
385 unsigned long long *sta);
Len Brown4be44fc2005-08-05 00:44:28 -0400386int acpi_bus_get_status(struct acpi_device *device);
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100387
Len Brown4be44fc2005-08-05 00:44:28 -0400388int acpi_bus_set_power(acpi_handle handle, int state);
Rafael J. Wysocki96bfd3c2013-01-17 14:11:08 +0100389const char *acpi_power_state_string(int state);
Rafael J. Wysockiad0c3b02013-01-17 14:11:08 +0100390int acpi_device_get_power(struct acpi_device *device, int *state);
Rafael J. Wysocki078eb122012-11-02 01:40:45 +0100391int acpi_device_set_power(struct acpi_device *device, int state);
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100392int acpi_bus_init_power(struct acpi_device *device);
Rafael J. Wysockib9e95fc2013-06-19 00:45:34 +0200393int acpi_device_fix_up_power(struct acpi_device *device);
Rafael J. Wysocki25eed402010-11-25 00:09:15 +0100394int acpi_bus_update_power(acpi_handle handle, int *state_p);
Rafael J. Wysocki3737b2b2008-07-07 03:30:55 +0200395bool acpi_bus_power_manageable(acpi_handle handle);
Rafael J. Wysockiec4602a2013-05-16 22:29:28 +0200396
397#ifdef CONFIG_PM
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +0200398bool acpi_bus_can_wakeup(acpi_handle handle);
Rafael J. Wysockiec4602a2013-05-16 22:29:28 +0200399#else
400static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; }
401#endif
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100402
Rafael J. Wysocki3757b942013-02-13 14:36:47 +0100403void acpi_scan_lock_acquire(void);
404void acpi_scan_lock_release(void);
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100405int acpi_scan_add_handler(struct acpi_scan_handler *handler);
Len Brown4be44fc2005-08-05 00:44:28 -0400406int acpi_bus_register_driver(struct acpi_driver *driver);
Bjorn Helgaas06ea8e082006-04-27 05:25:00 -0400407void acpi_bus_unregister_driver(struct acpi_driver *driver);
Rafael J. Wysockib8bd7592013-01-19 01:27:35 +0100408int acpi_bus_scan(acpi_handle handle);
Rafael J. Wysockibfee26d2013-01-26 00:27:44 +0100409void acpi_bus_trim(struct acpi_device *start);
Len Brownfd350942007-05-09 23:34:35 -0400410acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd);
Thomas Renninger8c8eb782007-07-23 14:43:32 +0200411int acpi_match_device_ids(struct acpi_device *device,
412 const struct acpi_device_id *ids);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700413int acpi_create_dir(struct acpi_device *);
414void acpi_remove_dir(struct acpi_device *);
415
Rafael J. Wysocki7b981182013-11-07 01:45:40 +0100416typedef void (*acpi_hp_callback)(void *data, u32 src);
417
418acpi_status acpi_hotplug_execute(acpi_hp_callback func, void *data, u32 src);
Mika Westerberg0d2cf8f2012-09-07 10:31:38 +0300419
420/**
421 * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver
422 * @__acpi_driver: acpi_driver struct
423 *
424 * Helper macro for ACPI drivers which do not do anything special in module
425 * init/exit. This eliminates a lot of boilerplate. Each module may only
426 * use this macro once, and calling it replaces module_init() and module_exit()
427 */
428#define module_acpi_driver(__acpi_driver) \
429 module_driver(__acpi_driver, acpi_bus_register_driver, \
430 acpi_bus_unregister_driver)
431
David Shaohua Li4e10d122005-03-18 18:45:35 -0500432/*
433 * Bind physical devices with ACPI devices
434 */
David Shaohua Li4e10d122005-03-18 18:45:35 -0500435struct acpi_bus_type {
Len Brown4be44fc2005-08-05 00:44:28 -0400436 struct list_head list;
Rafael J. Wysocki53540092013-03-03 22:35:20 +0100437 const char *name;
438 bool (*match)(struct device *dev);
Len Brown4be44fc2005-08-05 00:44:28 -0400439 int (*find_device) (struct device *, acpi_handle *);
Rafael J. Wysocki11909ca2012-12-23 00:02:13 +0100440 void (*setup)(struct device *);
441 void (*cleanup)(struct device *);
David Shaohua Li4e10d122005-03-18 18:45:35 -0500442};
443int register_acpi_bus_type(struct acpi_bus_type *);
444int unregister_acpi_bus_type(struct acpi_bus_type *);
Thomas Renninger22c13f92008-08-01 17:37:54 +0200445
Alex Chiang76d56de2009-07-23 17:03:00 -0600446struct acpi_pci_root {
Alex Chiang76d56de2009-07-23 17:03:00 -0600447 struct acpi_device * device;
Alex Chiang76d56de2009-07-23 17:03:00 -0600448 struct pci_bus *bus;
449 u16 segment;
Bjorn Helgaas6ad95512010-03-11 12:20:06 -0700450 struct resource secondary; /* downstream bus range */
Alex Chiang76d56de2009-07-23 17:03:00 -0600451
452 u32 osc_support_set; /* _OSC state of support bits */
453 u32 osc_control_set; /* _OSC state of control bits */
Jiang Liuf4b57a32012-06-22 14:55:16 +0800454 phys_addr_t mcfg_addr;
Alex Chiang76d56de2009-07-23 17:03:00 -0600455};
456
David Shaohua Li4e10d122005-03-18 18:45:35 -0500457/* helper */
Rafael J. Wysocki60f75b82013-08-07 22:55:00 +0200458acpi_handle acpi_find_child(acpi_handle, u64, bool);
459static inline acpi_handle acpi_get_child(acpi_handle handle, u64 addr)
460{
461 return acpi_find_child(handle, addr, false);
462}
Rafael J. Wysocki7b199812013-11-11 22:41:56 +0100463void acpi_preset_companion(struct device *dev, acpi_handle parent, u64 addr);
Alexander Chiang27558202009-06-10 19:55:14 +0000464int acpi_is_root_bridge(acpi_handle);
Alex Chiang76d56de2009-07-23 17:03:00 -0600465struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle);
David Shaohua Li4e10d122005-03-18 18:45:35 -0500466
Rafael J. Wysockib67ea762010-02-17 23:44:09 +0100467int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state);
468int acpi_disable_wakeup_device_power(struct acpi_device *dev);
469
Rafael J. Wysockiaa338602011-02-11 00:06:54 +0100470#ifdef CONFIG_PM
Rafael J. Wysockiec2cd812012-11-02 01:40:09 +0100471acpi_status acpi_add_pm_notifier(struct acpi_device *adev,
472 acpi_notify_handler handler, void *context);
473acpi_status acpi_remove_pm_notifier(struct acpi_device *adev,
474 acpi_notify_handler handler);
Huang Yingee85f542012-06-23 10:23:48 +0800475int acpi_pm_device_sleep_state(struct device *, int *, int);
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200476#else
Rafael J. Wysockiec2cd812012-11-02 01:40:09 +0100477static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev,
478 acpi_notify_handler handler,
479 void *context)
480{
481 return AE_SUPPORT;
482}
483static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev,
484 acpi_notify_handler handler)
485{
486 return AE_SUPPORT;
487}
Rafael J. Wysockib25c77e2013-06-16 00:37:42 +0200488static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m)
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200489{
490 if (p)
491 *p = ACPI_STATE_D0;
Rafael J. Wysockib25c77e2013-06-16 00:37:42 +0200492
Rafael J. Wysocki8ad928d2013-07-30 14:36:20 +0200493 return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ?
494 m : ACPI_STATE_D0;
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200495}
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200496#endif
497
Rafael J. Wysockibdda27f2012-10-26 13:40:04 +0200498#ifdef CONFIG_PM_RUNTIME
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100499int __acpi_device_run_wake(struct acpi_device *, bool);
Lin Mingb24e5092012-03-27 15:43:25 +0800500int acpi_pm_device_run_wake(struct device *, bool);
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200501#else
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100502static inline int __acpi_device_run_wake(struct acpi_device *adev, bool en)
503{
504 return -ENODEV;
505}
Lin Mingb24e5092012-03-27 15:43:25 +0800506static inline int acpi_pm_device_run_wake(struct device *dev, bool enable)
507{
508 return -ENODEV;
509}
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200510#endif
511
512#ifdef CONFIG_PM_SLEEP
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100513int __acpi_device_sleep_wake(struct acpi_device *, u32, bool);
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200514int acpi_pm_device_sleep_wake(struct device *, bool);
David Howellsf7a1b862008-07-08 15:00:54 +0100515#else
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100516static inline int __acpi_device_sleep_wake(struct acpi_device *adev,
517 u32 target_state, bool enable)
David Howellsf7a1b862008-07-08 15:00:54 +0100518{
519 return -ENODEV;
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200520}
Shaohua Lifd4aff12007-07-17 22:40:25 +0200521static inline int acpi_pm_device_sleep_wake(struct device *dev, bool enable)
Len Brownfd350942007-05-09 23:34:35 -0400522{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523 return -ENODEV;
524}
525#endif
526
David Rientjes99926a82012-11-10 22:48:33 +0100527#ifdef CONFIG_ACPI_SLEEP
528u32 acpi_target_system_state(void);
529#else
530static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; }
531#endif
532
Rafael J. Wysocki078eb122012-11-02 01:40:45 +0100533static inline bool acpi_device_power_manageable(struct acpi_device *adev)
534{
535 return adev->flags.power_manageable;
536}
537
538static inline bool acpi_device_can_wakeup(struct acpi_device *adev)
539{
540 return adev->wakeup.flags.valid;
541}
542
Aaron Lu1399dfc2012-11-21 23:33:40 +0100543static inline bool acpi_device_can_poweroff(struct acpi_device *adev)
544{
545 return adev->power.states[ACPI_STATE_D3_COLD].flags.os_accessible;
546}
547
Matthew Garrett66886d62012-05-11 16:08:25 +0800548#else /* CONFIG_ACPI */
549
Len Brown7ae30982012-06-04 00:29:11 -0400550static inline int register_acpi_bus_type(void *bus) { return 0; }
551static inline int unregister_acpi_bus_type(void *bus) { return 0; }
Matthew Garrett66886d62012-05-11 16:08:25 +0800552
Linus Torvalds1da177e2005-04-16 15:20:36 -0700553#endif /* CONFIG_ACPI */
554
555#endif /*__ACPI_BUS_H__*/