blob: 007fe99e29f51cbdc886f34861c6c3cd13eb4d64 [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
Linus Torvalds1da177e2005-04-16 15:20:36 -070031/* TBD: Make dynamic */
32#define ACPI_MAX_HANDLES 10
33struct acpi_handle_list {
Len Brown4be44fc2005-08-05 00:44:28 -040034 u32 count;
35 acpi_handle handles[ACPI_MAX_HANDLES];
Linus Torvalds1da177e2005-04-16 15:20:36 -070036};
37
Linus Torvalds1da177e2005-04-16 15:20:36 -070038/* acpi_utils.h */
39acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040040acpi_extract_package(union acpi_object *package,
41 struct acpi_buffer *format, struct acpi_buffer *buffer);
Linus Torvalds1da177e2005-04-16 15:20:36 -070042acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040043acpi_evaluate_integer(acpi_handle handle,
44 acpi_string pathname,
Matthew Wilcox27663c52008-10-10 02:22:59 -040045 struct acpi_object_list *arguments, unsigned long long *data);
Linus Torvalds1da177e2005-04-16 15:20:36 -070046acpi_status
Len Brown4be44fc2005-08-05 00:44:28 -040047acpi_evaluate_reference(acpi_handle handle,
48 acpi_string pathname,
49 struct acpi_object_list *arguments,
50 struct acpi_handle_list *list);
Toshi Kani275c58d2012-05-23 20:25:19 -060051acpi_status
52acpi_evaluate_hotplug_ost(acpi_handle handle, u32 source_event,
53 u32 status_code, struct acpi_buffer *status_buf);
Linus Torvalds1da177e2005-04-16 15:20:36 -070054
Matthew Garrett38ac0f12012-05-11 16:08:26 +080055acpi_status
Feng Tang8ede06a2012-08-21 09:56:58 +080056acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld);
Jiang Liu952c63e2013-06-29 00:24:38 +080057
58bool acpi_has_method(acpi_handle handle, char *name);
Jiang Liu0db98202013-06-29 00:24:39 +080059acpi_status acpi_execute_simple_method(acpi_handle handle, char *method,
60 u64 arg);
Jiang Liu7d2421f2013-06-29 00:24:40 +080061acpi_status acpi_evaluate_ej0(acpi_handle handle);
62acpi_status acpi_evaluate_lck(acpi_handle handle, int lock);
Jiang Liuebf4df82013-06-29 00:24:41 +080063bool acpi_ata_match(acpi_handle handle);
64bool acpi_bay_match(acpi_handle handle);
65bool acpi_dock_match(acpi_handle handle);
Jiang Liu952c63e2013-06-29 00:24:38 +080066
Jiang Liua65ac522013-12-19 20:38:10 +080067bool acpi_check_dsm(acpi_handle handle, const u8 *uuid, int rev, u64 funcs);
68union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const u8 *uuid,
69 int rev, int func, union acpi_object *argv4);
70
71static inline union acpi_object *
72acpi_evaluate_dsm_typed(acpi_handle handle, const u8 *uuid, int rev, int func,
73 union acpi_object *argv4, acpi_object_type type)
74{
75 union acpi_object *obj;
76
77 obj = acpi_evaluate_dsm(handle, uuid, rev, func, argv4);
78 if (obj && obj->type != type) {
79 ACPI_FREE(obj);
80 obj = NULL;
81 }
82
83 return obj;
84}
85
86#define ACPI_INIT_DSM_ARGV4(cnt, eles) \
87 { \
88 .package.type = ACPI_TYPE_PACKAGE, \
89 .package.count = (cnt), \
90 .package.elements = (eles) \
91 }
92
Len Brown76f58582005-08-24 12:10:49 -040093#ifdef CONFIG_ACPI
Linus Torvalds1da177e2005-04-16 15:20:36 -070094
95#include <linux/proc_fs.h>
96
97#define ACPI_BUS_FILE_ROOT "acpi"
Len Brown4be44fc2005-08-05 00:44:28 -040098extern struct proc_dir_entry *acpi_root_dir;
Linus Torvalds1da177e2005-04-16 15:20:36 -070099
Linus Torvalds1da177e2005-04-16 15:20:36 -0700100enum acpi_bus_device_type {
Len Brown4be44fc2005-08-05 00:44:28 -0400101 ACPI_BUS_TYPE_DEVICE = 0,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102 ACPI_BUS_TYPE_POWER,
103 ACPI_BUS_TYPE_PROCESSOR,
104 ACPI_BUS_TYPE_THERMAL,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700105 ACPI_BUS_TYPE_POWER_BUTTON,
106 ACPI_BUS_TYPE_SLEEP_BUTTON,
107 ACPI_BUS_DEVICE_TYPE_COUNT
108};
109
110struct acpi_driver;
111struct acpi_device;
112
Linus Torvalds1da177e2005-04-16 15:20:36 -0700113/*
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100114 * ACPI Scan Handler
115 * -----------------
116 */
117
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100118struct acpi_hotplug_profile {
Rafael J. Wysocki3f8055c2013-03-03 23:08:16 +0100119 struct kobject kobj;
Rafael J. Wysocki3338db02013-11-22 21:55:20 +0100120 int (*scan_dependent)(struct acpi_device *adev);
Rafael J. Wysockid22ddcb2013-12-29 15:25:35 +0100121 bool enabled:1;
122 bool demand_offline:1;
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100123};
124
Rafael J. Wysocki3f8055c2013-03-03 23:08:16 +0100125static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile(
126 struct kobject *kobj)
127{
128 return container_of(kobj, struct acpi_hotplug_profile, kobj);
129}
130
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100131struct acpi_scan_handler {
132 const struct acpi_device_id *ids;
133 struct list_head list_node;
134 int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id);
135 void (*detach)(struct acpi_device *dev);
Rafael J. Wysockia33ec392013-03-03 23:05:29 +0100136 struct acpi_hotplug_profile hotplug;
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100137};
138
139/*
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100140 * ACPI Hotplug Context
141 * --------------------
142 */
143
144struct acpi_hotplug_context {
145 struct acpi_device *self;
146 int (*event)(struct acpi_device *, u32);
Rafael J. Wysocki59b42fa2014-02-21 01:08:51 +0100147 void (*fixup)(struct acpi_device *);
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100148};
149
150/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151 * ACPI Driver
152 * -----------
153 */
154
Len Brown4be44fc2005-08-05 00:44:28 -0400155typedef int (*acpi_op_add) (struct acpi_device * device);
Rafael J. Wysocki51fac832013-01-24 00:24:48 +0100156typedef int (*acpi_op_remove) (struct acpi_device * device);
Bjorn Helgaas46ec8592009-03-30 17:48:13 +0000157typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700158
159struct acpi_device_ops {
Len Brown4be44fc2005-08-05 00:44:28 -0400160 acpi_op_add add;
161 acpi_op_remove remove;
Bjorn Helgaas46ec8592009-03-30 17:48:13 +0000162 acpi_op_notify notify;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700163};
164
Bjorn Helgaas6d278132009-04-30 09:35:37 -0600165#define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */
166
Linus Torvalds1da177e2005-04-16 15:20:36 -0700167struct acpi_driver {
Len Brown4be44fc2005-08-05 00:44:28 -0400168 char name[80];
169 char class[80];
Thomas Renninger8c8eb782007-07-23 14:43:32 +0200170 const struct acpi_device_id *ids; /* Supported Hardware IDs */
Bjorn Helgaas6d278132009-04-30 09:35:37 -0600171 unsigned int flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400172 struct acpi_device_ops ops;
Patrick Mocheld43ec682006-12-07 20:56:23 +0800173 struct device_driver drv;
Patrick Mochel1890a972006-12-07 20:56:31 +0800174 struct module *owner;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175};
176
177/*
178 * ACPI Device
179 * -----------
180 */
181
182/* Status (_STA) */
183
184struct acpi_device_status {
Len Brown4be44fc2005-08-05 00:44:28 -0400185 u32 present:1;
186 u32 enabled:1;
187 u32 show_in_ui:1;
188 u32 functional:1;
189 u32 battery_present:1;
190 u32 reserved:27;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700191};
192
Linus Torvalds1da177e2005-04-16 15:20:36 -0700193/* Flags */
194
195struct acpi_device_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400196 u32 dynamic_status:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400197 u32 removable:1;
198 u32 ejectable:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400199 u32 power_manageable:1;
Rafael J. Wysocki209d3b12012-12-21 00:36:48 +0100200 u32 match_driver:1;
Rafael J. Wysocki202317a2013-11-22 21:54:37 +0100201 u32 initialized:1;
202 u32 visited:1;
Rafael J. Wysockif244d8b2013-12-31 13:39:42 +0100203 u32 no_hotplug:1;
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100204 u32 hotplug_notify:1;
Rafael J. Wysocki1e2380c2014-02-16 01:51:01 +0100205 u32 is_dock_station:1;
206 u32 reserved:22;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700207};
208
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209/* File System */
210
211struct acpi_device_dir {
Len Brown4be44fc2005-08-05 00:44:28 -0400212 struct proc_dir_entry *entry;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700213};
214
215#define acpi_device_dir(d) ((d)->dir.entry)
216
Linus Torvalds1da177e2005-04-16 15:20:36 -0700217/* Plug and Play */
218
Zhao Yakui24c5c4c2009-05-21 16:25:35 +0800219typedef char acpi_bus_id[8];
Len Brown4be44fc2005-08-05 00:44:28 -0400220typedef unsigned long acpi_bus_address;
Len Brown4be44fc2005-08-05 00:44:28 -0400221typedef char acpi_device_name[40];
222typedef char acpi_device_class[20];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700223
Bjorn Helgaas7f47fa62009-09-21 13:35:19 -0600224struct acpi_hardware_id {
225 struct list_head list;
226 char *id;
227};
228
Toshi Kanid4e1a692013-03-04 21:30:41 +0000229struct acpi_pnp_type {
230 u32 hardware_id:1;
231 u32 bus_address:1;
232 u32 reserved:30;
233};
234
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235struct acpi_device_pnp {
Toshi Kanid4e1a692013-03-04 21:30:41 +0000236 acpi_bus_id bus_id; /* Object name */
237 struct acpi_pnp_type type; /* ID type */
Len Brown4be44fc2005-08-05 00:44:28 -0400238 acpi_bus_address bus_address; /* _ADR */
Toshi Kanid4e1a692013-03-04 21:30:41 +0000239 char *unique_id; /* _UID */
Bjorn Helgaas7f47fa62009-09-21 13:35:19 -0600240 struct list_head ids; /* _HID and _CIDs */
Len Brown4be44fc2005-08-05 00:44:28 -0400241 acpi_device_name device_name; /* Driver-determined */
242 acpi_device_class device_class; /* " */
Lance Ortizd1efe3c2012-10-02 12:43:23 -0600243 union acpi_object *str_obj; /* unicode string for _STR method */
Yasuaki Ishimatsubb74ac22012-11-16 02:56:59 +0100244 unsigned long sun; /* _SUN */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700245};
246
247#define acpi_device_bid(d) ((d)->pnp.bus_id)
248#define acpi_device_adr(d) ((d)->pnp.bus_address)
Thomas Renninger620e1122010-10-01 10:54:00 +0200249const char *acpi_device_hid(struct acpi_device *device);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700250#define acpi_device_name(d) ((d)->pnp.device_name)
251#define acpi_device_class(d) ((d)->pnp.device_class)
252
Linus Torvalds1da177e2005-04-16 15:20:36 -0700253/* Power Management */
254
255struct acpi_device_power_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400256 u32 explicit_get:1; /* _PSC present? */
257 u32 power_resources:1; /* Power resources */
258 u32 inrush_current:1; /* Serialize Dx->D0 */
259 u32 power_removed:1; /* Optimize Dx->D0 */
Mika Westerberg644f17a2013-10-10 13:28:46 +0300260 u32 ignore_parent:1; /* Power is independent of parent power state */
261 u32 reserved:27;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700262};
263
264struct acpi_device_power_state {
265 struct {
Len Brown4be44fc2005-08-05 00:44:28 -0400266 u8 valid:1;
Aaron Lu1399dfc2012-11-21 23:33:40 +0100267 u8 os_accessible:1;
Len Brown4be44fc2005-08-05 00:44:28 -0400268 u8 explicit_set:1; /* _PSx present? */
269 u8 reserved:6;
270 } flags;
271 int power; /* % Power (compared to D0) */
272 int latency; /* Dx->D0 time (microseconds) */
Rafael J. Wysocki0b224522013-01-17 14:11:06 +0100273 struct list_head resources; /* Power resources referenced */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700274};
275
276struct acpi_device_power {
Len Brown4be44fc2005-08-05 00:44:28 -0400277 int state; /* Current state */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700278 struct acpi_device_power_flags flags;
Lin Mingb4a03b92011-06-01 23:54:02 +0800279 struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700280};
281
Linus Torvalds1da177e2005-04-16 15:20:36 -0700282/* Performance Management */
283
284struct acpi_device_perf_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400285 u8 reserved:8;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286};
287
288struct acpi_device_perf_state {
289 struct {
Len Brown4be44fc2005-08-05 00:44:28 -0400290 u8 valid:1;
291 u8 reserved:7;
292 } flags;
293 u8 power; /* % Power (compared to P0) */
294 u8 performance; /* % Performance ( " ) */
295 int latency; /* Px->P0 time (microseconds) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700296};
297
298struct acpi_device_perf {
Len Brown4be44fc2005-08-05 00:44:28 -0400299 int state;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700300 struct acpi_device_perf_flags flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400301 int state_count;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700302 struct acpi_device_perf_state *states;
303};
304
305/* Wakeup Management */
306struct acpi_device_wakeup_flags {
Len Brown4be44fc2005-08-05 00:44:28 -0400307 u8 valid:1; /* Can successfully enable wakeup? */
308 u8 run_wake:1; /* Run-Wake GPE devices */
Rafael J. Wysockib67ea762010-02-17 23:44:09 +0100309 u8 notifier_present:1; /* Wake-up notify handler has been installed */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700310};
311
Linus Torvalds1da177e2005-04-16 15:20:36 -0700312struct acpi_device_wakeup {
Len Brown4be44fc2005-08-05 00:44:28 -0400313 acpi_handle gpe_device;
Lin Ming439913f2010-01-28 10:53:19 +0800314 u64 gpe_number;
315 u64 sleep_state;
Rafael J. Wysocki993cbe52013-01-17 14:11:06 +0100316 struct list_head resources;
Len Brown4be44fc2005-08-05 00:44:28 -0400317 struct acpi_device_wakeup_flags flags;
Rafael J. Wysocki9b83ccd2009-09-08 23:15:31 +0200318 int prepare_count;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700319};
320
Lan Tianyu1033f902012-08-17 14:44:09 +0800321struct acpi_device_physical_node {
Rafael J. Wysocki007ccfc2013-08-06 14:32:54 +0200322 unsigned int node_id;
Lan Tianyu1033f902012-08-17 14:44:09 +0800323 struct list_head node;
324 struct device *dev;
Rafael J. Wysocki683058e2013-05-03 00:26:16 +0200325 bool put_online:1;
Lan Tianyu1033f902012-08-17 14:44:09 +0800326};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700327
Lan Tianyu1033f902012-08-17 14:44:09 +0800328/* Device */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329struct acpi_device {
Bjorn Helgaascaaa6ef2009-09-21 19:29:10 +0000330 int device_type;
331 acpi_handle handle; /* no handle for fixed hardware */
Len Brown4be44fc2005-08-05 00:44:28 -0400332 struct acpi_device *parent;
333 struct list_head children;
334 struct list_head node;
335 struct list_head wakeup_list;
Rafael J. Wysockid7831562013-11-22 21:52:12 +0100336 struct list_head del_list;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700337 struct acpi_device_status status;
338 struct acpi_device_flags flags;
Len Brown4be44fc2005-08-05 00:44:28 -0400339 struct acpi_device_pnp pnp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700340 struct acpi_device_power power;
341 struct acpi_device_wakeup wakeup;
Len Brown4be44fc2005-08-05 00:44:28 -0400342 struct acpi_device_perf performance;
343 struct acpi_device_dir dir;
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100344 struct acpi_scan_handler *handler;
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100345 struct acpi_hotplug_context *hp;
Len Brown4be44fc2005-08-05 00:44:28 -0400346 struct acpi_driver *driver;
347 void *driver_data;
Patrick Mochel5b327262006-05-10 10:33:00 -0400348 struct device dev;
Rafael J. Wysocki007ccfc2013-08-06 14:32:54 +0200349 unsigned int physical_node_count;
Lan Tianyu1033f902012-08-17 14:44:09 +0800350 struct list_head physical_node_list;
351 struct mutex physical_node_lock;
Rafael J. Wysockib1c0f992013-01-24 12:50:09 +0100352 void (*remove)(struct acpi_device *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700353};
354
Pavel Machekdb89b4f2008-09-22 14:37:34 -0700355static inline void *acpi_driver_data(struct acpi_device *d)
356{
357 return d->driver_data;
358}
359
Patrick Mocheld43ec682006-12-07 20:56:23 +0800360#define to_acpi_device(d) container_of(d, struct acpi_device, dev)
361#define to_acpi_driver(d) container_of(d, struct acpi_driver, drv)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700362
Rafael J. Wysocki25db1152013-11-22 21:56:06 +0100363static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta)
364{
365 *((u32 *)&adev->status) = sta;
366}
367
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100368static inline void acpi_set_hp_context(struct acpi_device *adev,
369 struct acpi_hotplug_context *hp,
Rafael J. Wysocki59b42fa2014-02-21 01:08:51 +0100370 int (*event)(struct acpi_device *, u32),
371 void (*fixup)(struct acpi_device *))
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100372{
373 hp->self = adev;
374 hp->event = event;
Rafael J. Wysocki59b42fa2014-02-21 01:08:51 +0100375 hp->fixup = fixup;
Rafael J. Wysocki3c2cc7f2014-02-06 17:31:37 +0100376 adev->hp = hp;
377}
378
David Brownell55955aa2007-05-08 00:28:35 -0700379/* acpi_device.dev.bus == &acpi_bus_type */
380extern struct bus_type acpi_bus_type;
381
Linus Torvalds1da177e2005-04-16 15:20:36 -0700382/*
383 * Events
384 * ------
385 */
386
387struct acpi_bus_event {
Len Brown4be44fc2005-08-05 00:44:28 -0400388 struct list_head node;
389 acpi_device_class device_class;
390 acpi_bus_id bus_id;
391 u32 type;
392 u32 data;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700393};
394
Greg Kroah-Hartman99e0d2f2007-11-02 16:19:59 -0700395extern struct kobject *acpi_kobj;
Zhang Rui962ce8c2007-08-23 01:24:31 +0800396extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int);
Bob Moore8e4319c2009-06-29 13:43:27 +0800397void acpi_bus_private_data_handler(acpi_handle, void *);
Zhang Rui20733932008-01-17 15:51:21 +0800398int acpi_bus_get_private_data(acpi_handle, void **);
Rafael J. Wysockif244d8b2013-12-31 13:39:42 +0100399void acpi_bus_no_hotplug(acpi_handle handle);
Zhang Rui9ee85242008-01-25 14:48:06 +0800400extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32);
401extern int register_acpi_notifier(struct notifier_block *);
402extern int unregister_acpi_notifier(struct notifier_block *);
Shaohua Li6bd00a62008-08-28 10:04:29 +0800403
Linus Torvalds1da177e2005-04-16 15:20:36 -0700404/*
405 * External Functions
406 */
407
408int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device);
Rafael J. Wysocki78ea4632014-02-04 00:43:05 +0100409struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle);
410void acpi_bus_put_acpi_device(struct acpi_device *adev);
Bjorn Helgaas402ac532009-09-21 19:30:01 +0000411acpi_status acpi_bus_get_status_handle(acpi_handle handle,
412 unsigned long long *sta);
Len Brown4be44fc2005-08-05 00:44:28 -0400413int acpi_bus_get_status(struct acpi_device *device);
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100414
Len Brown4be44fc2005-08-05 00:44:28 -0400415int acpi_bus_set_power(acpi_handle handle, int state);
Rafael J. Wysocki96bfd3c2013-01-17 14:11:08 +0100416const char *acpi_power_state_string(int state);
Rafael J. Wysockiad0c3b02013-01-17 14:11:08 +0100417int acpi_device_get_power(struct acpi_device *device, int *state);
Rafael J. Wysocki078eb122012-11-02 01:40:45 +0100418int acpi_device_set_power(struct acpi_device *device, int state);
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100419int acpi_bus_init_power(struct acpi_device *device);
Rafael J. Wysockib9e95fc2013-06-19 00:45:34 +0200420int acpi_device_fix_up_power(struct acpi_device *device);
Rafael J. Wysocki25eed402010-11-25 00:09:15 +0100421int acpi_bus_update_power(acpi_handle handle, int *state_p);
Rafael J. Wysocki3737b2b2008-07-07 03:30:55 +0200422bool acpi_bus_power_manageable(acpi_handle handle);
Rafael J. Wysockiec4602a2013-05-16 22:29:28 +0200423
424#ifdef CONFIG_PM
Rafael J. Wysockieb9d0fe2008-07-07 03:34:48 +0200425bool acpi_bus_can_wakeup(acpi_handle handle);
Rafael J. Wysockiec4602a2013-05-16 22:29:28 +0200426#else
427static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; }
428#endif
Rafael J. Wysocki9ce4e602013-01-17 14:11:08 +0100429
Rafael J. Wysocki3757b942013-02-13 14:36:47 +0100430void acpi_scan_lock_acquire(void);
431void acpi_scan_lock_release(void);
Rafael J. Wysockie5255062014-02-04 00:43:17 +0100432void acpi_lock_hp_context(void);
433void acpi_unlock_hp_context(void);
Rafael J. Wysockica589f92013-01-30 14:27:29 +0100434int acpi_scan_add_handler(struct acpi_scan_handler *handler);
Len Brown4be44fc2005-08-05 00:44:28 -0400435int acpi_bus_register_driver(struct acpi_driver *driver);
Bjorn Helgaas06ea8e082006-04-27 05:25:00 -0400436void acpi_bus_unregister_driver(struct acpi_driver *driver);
Rafael J. Wysockib8bd7592013-01-19 01:27:35 +0100437int acpi_bus_scan(acpi_handle handle);
Rafael J. Wysockibfee26d2013-01-26 00:27:44 +0100438void acpi_bus_trim(struct acpi_device *start);
Len Brownfd350942007-05-09 23:34:35 -0400439acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd);
Thomas Renninger8c8eb782007-07-23 14:43:32 +0200440int acpi_match_device_ids(struct acpi_device *device,
441 const struct acpi_device_id *ids);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700442int acpi_create_dir(struct acpi_device *);
443void acpi_remove_dir(struct acpi_device *);
444
Rafael J. Wysocki202317a2013-11-22 21:54:37 +0100445static inline bool acpi_device_enumerated(struct acpi_device *adev)
446{
447 return adev && adev->flags.initialized && adev->flags.visited;
448}
449
Rafael J. Wysocki7b981182013-11-07 01:45:40 +0100450typedef void (*acpi_hp_callback)(void *data, u32 src);
451
452acpi_status acpi_hotplug_execute(acpi_hp_callback func, void *data, u32 src);
Mika Westerberg0d2cf8f2012-09-07 10:31:38 +0300453
454/**
455 * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver
456 * @__acpi_driver: acpi_driver struct
457 *
458 * Helper macro for ACPI drivers which do not do anything special in module
459 * init/exit. This eliminates a lot of boilerplate. Each module may only
460 * use this macro once, and calling it replaces module_init() and module_exit()
461 */
462#define module_acpi_driver(__acpi_driver) \
463 module_driver(__acpi_driver, acpi_bus_register_driver, \
464 acpi_bus_unregister_driver)
465
David Shaohua Li4e10d122005-03-18 18:45:35 -0500466/*
467 * Bind physical devices with ACPI devices
468 */
David Shaohua Li4e10d122005-03-18 18:45:35 -0500469struct acpi_bus_type {
Len Brown4be44fc2005-08-05 00:44:28 -0400470 struct list_head list;
Rafael J. Wysocki53540092013-03-03 22:35:20 +0100471 const char *name;
472 bool (*match)(struct device *dev);
Rafael J. Wysockie3f02c52013-11-29 16:27:34 +0100473 struct acpi_device * (*find_companion)(struct device *);
Rafael J. Wysocki11909ca2012-12-23 00:02:13 +0100474 void (*setup)(struct device *);
475 void (*cleanup)(struct device *);
David Shaohua Li4e10d122005-03-18 18:45:35 -0500476};
477int register_acpi_bus_type(struct acpi_bus_type *);
478int unregister_acpi_bus_type(struct acpi_bus_type *);
Thomas Renninger22c13f92008-08-01 17:37:54 +0200479
Alex Chiang76d56de2009-07-23 17:03:00 -0600480struct acpi_pci_root {
Alex Chiang76d56de2009-07-23 17:03:00 -0600481 struct acpi_device * device;
Alex Chiang76d56de2009-07-23 17:03:00 -0600482 struct pci_bus *bus;
483 u16 segment;
Bjorn Helgaas6ad95512010-03-11 12:20:06 -0700484 struct resource secondary; /* downstream bus range */
Alex Chiang76d56de2009-07-23 17:03:00 -0600485
486 u32 osc_support_set; /* _OSC state of support bits */
487 u32 osc_control_set; /* _OSC state of control bits */
Jiang Liuf4b57a32012-06-22 14:55:16 +0800488 phys_addr_t mcfg_addr;
Alex Chiang76d56de2009-07-23 17:03:00 -0600489};
490
David Shaohua Li4e10d122005-03-18 18:45:35 -0500491/* helper */
Rafael J. Wysockid9fef0c2013-11-28 23:57:58 +0100492
493struct acpi_device *acpi_find_child_device(struct acpi_device *parent,
494 u64 address, bool check_children);
Alexander Chiang27558202009-06-10 19:55:14 +0000495int acpi_is_root_bridge(acpi_handle);
Alex Chiang76d56de2009-07-23 17:03:00 -0600496struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle);
David Shaohua Li4e10d122005-03-18 18:45:35 -0500497
Rafael J. Wysockib67ea762010-02-17 23:44:09 +0100498int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state);
499int acpi_disable_wakeup_device_power(struct acpi_device *dev);
500
Rafael J. Wysockiaa338602011-02-11 00:06:54 +0100501#ifdef CONFIG_PM
Rafael J. Wysockiec2cd812012-11-02 01:40:09 +0100502acpi_status acpi_add_pm_notifier(struct acpi_device *adev,
503 acpi_notify_handler handler, void *context);
504acpi_status acpi_remove_pm_notifier(struct acpi_device *adev,
505 acpi_notify_handler handler);
Huang Yingee85f542012-06-23 10:23:48 +0800506int acpi_pm_device_sleep_state(struct device *, int *, int);
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200507#else
Rafael J. Wysockiec2cd812012-11-02 01:40:09 +0100508static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev,
509 acpi_notify_handler handler,
510 void *context)
511{
512 return AE_SUPPORT;
513}
514static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev,
515 acpi_notify_handler handler)
516{
517 return AE_SUPPORT;
518}
Rafael J. Wysockib25c77e2013-06-16 00:37:42 +0200519static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m)
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200520{
521 if (p)
522 *p = ACPI_STATE_D0;
Rafael J. Wysockib25c77e2013-06-16 00:37:42 +0200523
Rafael J. Wysocki8ad928d2013-07-30 14:36:20 +0200524 return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ?
525 m : ACPI_STATE_D0;
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200526}
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200527#endif
528
Rafael J. Wysockibdda27f2012-10-26 13:40:04 +0200529#ifdef CONFIG_PM_RUNTIME
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100530int __acpi_device_run_wake(struct acpi_device *, bool);
Lin Mingb24e5092012-03-27 15:43:25 +0800531int acpi_pm_device_run_wake(struct device *, bool);
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200532#else
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100533static inline int __acpi_device_run_wake(struct acpi_device *adev, bool en)
534{
535 return -ENODEV;
536}
Lin Mingb24e5092012-03-27 15:43:25 +0800537static inline int acpi_pm_device_run_wake(struct device *dev, bool enable)
538{
539 return -ENODEV;
540}
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200541#endif
542
543#ifdef CONFIG_PM_SLEEP
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100544int __acpi_device_sleep_wake(struct acpi_device *, u32, bool);
Rafael J. Wysocki296699d2007-07-29 23:27:18 +0200545int acpi_pm_device_sleep_wake(struct device *, bool);
David Howellsf7a1b862008-07-08 15:00:54 +0100546#else
Rafael J. Wysockidee83702012-11-02 01:40:36 +0100547static inline int __acpi_device_sleep_wake(struct acpi_device *adev,
548 u32 target_state, bool enable)
David Howellsf7a1b862008-07-08 15:00:54 +0100549{
550 return -ENODEV;
Rafael J. Wysocki761afb82010-10-14 23:24:13 +0200551}
Shaohua Lifd4aff12007-07-17 22:40:25 +0200552static inline int acpi_pm_device_sleep_wake(struct device *dev, bool enable)
Len Brownfd350942007-05-09 23:34:35 -0400553{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700554 return -ENODEV;
555}
556#endif
557
David Rientjes99926a82012-11-10 22:48:33 +0100558#ifdef CONFIG_ACPI_SLEEP
559u32 acpi_target_system_state(void);
560#else
561static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; }
562#endif
563
Rafael J. Wysocki078eb122012-11-02 01:40:45 +0100564static inline bool acpi_device_power_manageable(struct acpi_device *adev)
565{
566 return adev->flags.power_manageable;
567}
568
569static inline bool acpi_device_can_wakeup(struct acpi_device *adev)
570{
571 return adev->wakeup.flags.valid;
572}
573
Aaron Lu1399dfc2012-11-21 23:33:40 +0100574static inline bool acpi_device_can_poweroff(struct acpi_device *adev)
575{
576 return adev->power.states[ACPI_STATE_D3_COLD].flags.os_accessible;
577}
578
Matthew Garrett66886d62012-05-11 16:08:25 +0800579#else /* CONFIG_ACPI */
580
Len Brown7ae30982012-06-04 00:29:11 -0400581static inline int register_acpi_bus_type(void *bus) { return 0; }
582static inline int unregister_acpi_bus_type(void *bus) { return 0; }
Matthew Garrett66886d62012-05-11 16:08:25 +0800583
Linus Torvalds1da177e2005-04-16 15:20:36 -0700584#endif /* CONFIG_ACPI */
585
586#endif /*__ACPI_BUS_H__*/