xref: /openbmc/linux/include/acpi/acpi_bus.h (revision 35f9e773)
1c942fddfSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */
21da177e4SLinus Torvalds /*
31da177e4SLinus Torvalds  *  acpi_bus.h - ACPI Bus Driver ($Revision: 22 $)
41da177e4SLinus Torvalds  *
51da177e4SLinus Torvalds  *  Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
61da177e4SLinus Torvalds  *  Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
71da177e4SLinus Torvalds  */
81da177e4SLinus Torvalds 
91da177e4SLinus Torvalds #ifndef __ACPI_BUS_H__
101da177e4SLinus Torvalds #define __ACPI_BUS_H__
111da177e4SLinus Torvalds 
125b327265SPatrick Mochel #include <linux/device.h>
138a0662d9SRafael J. Wysocki #include <linux/property.h>
141da177e4SLinus Torvalds 
151da177e4SLinus Torvalds /* TBD: Make dynamic */
161da177e4SLinus Torvalds #define ACPI_MAX_HANDLES	10
171da177e4SLinus Torvalds struct acpi_handle_list {
181da177e4SLinus Torvalds 	u32 count;
191da177e4SLinus Torvalds 	acpi_handle handles[ACPI_MAX_HANDLES];
201da177e4SLinus Torvalds };
211da177e4SLinus Torvalds 
221da177e4SLinus Torvalds /* acpi_utils.h */
231da177e4SLinus Torvalds acpi_status
244be44fcdSLen Brown acpi_extract_package(union acpi_object *package,
254be44fcdSLen Brown 		     struct acpi_buffer *format, struct acpi_buffer *buffer);
261da177e4SLinus Torvalds acpi_status
274be44fcdSLen Brown acpi_evaluate_integer(acpi_handle handle,
281da177e4SLinus Torvalds 		      acpi_string pathname,
2927663c58SMatthew Wilcox 		      struct acpi_object_list *arguments, unsigned long long *data);
301da177e4SLinus Torvalds acpi_status
314be44fcdSLen Brown acpi_evaluate_reference(acpi_handle handle,
321da177e4SLinus Torvalds 			acpi_string pathname,
331da177e4SLinus Torvalds 			struct acpi_object_list *arguments,
341da177e4SLinus Torvalds 			struct acpi_handle_list *list);
35275c58d7SToshi Kani acpi_status
3605730c19SJiang Liu acpi_evaluate_ost(acpi_handle handle, u32 source_event, u32 status_code,
3705730c19SJiang Liu 		  struct acpi_buffer *status_buf);
381da177e4SLinus Torvalds 
3938ac0f1bSMatthew Garrett acpi_status
408ede06abSFeng Tang acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld);
41952c63e9SJiang Liu 
42952c63e9SJiang Liu bool acpi_has_method(acpi_handle handle, char *name);
430db98202SJiang Liu acpi_status acpi_execute_simple_method(acpi_handle handle, char *method,
440db98202SJiang Liu 				       u64 arg);
457d2421f8SJiang Liu acpi_status acpi_evaluate_ej0(acpi_handle handle);
467d2421f8SJiang Liu acpi_status acpi_evaluate_lck(acpi_handle handle, int lock);
47132565d8SHans de Goede acpi_status acpi_evaluate_reg(acpi_handle handle, u8 space_id, u32 function);
48ebf4df8dSJiang Liu bool acpi_ata_match(acpi_handle handle);
49ebf4df8dSJiang Liu bool acpi_bay_match(acpi_handle handle);
50ebf4df8dSJiang Liu bool acpi_dock_match(acpi_handle handle);
51952c63e9SJiang Liu 
5294116f81SAndy Shevchenko bool acpi_check_dsm(acpi_handle handle, const guid_t *guid, u64 rev, u64 funcs);
5394116f81SAndy Shevchenko union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const guid_t *guid,
54c7e16e52SJerry Hoemann 			u64 rev, u64 func, union acpi_object *argv4);
55a65ac520SJiang Liu 
56a65ac520SJiang Liu static inline union acpi_object *
5794116f81SAndy Shevchenko acpi_evaluate_dsm_typed(acpi_handle handle, const guid_t *guid, u64 rev,
5894116f81SAndy Shevchenko 			u64 func, union acpi_object *argv4,
5994116f81SAndy Shevchenko 			acpi_object_type type)
60a65ac520SJiang Liu {
61a65ac520SJiang Liu 	union acpi_object *obj;
62a65ac520SJiang Liu 
6394116f81SAndy Shevchenko 	obj = acpi_evaluate_dsm(handle, guid, rev, func, argv4);
64a65ac520SJiang Liu 	if (obj && obj->type != type) {
65a65ac520SJiang Liu 		ACPI_FREE(obj);
66a65ac520SJiang Liu 		obj = NULL;
67a65ac520SJiang Liu 	}
68a65ac520SJiang Liu 
69a65ac520SJiang Liu 	return obj;
70a65ac520SJiang Liu }
71a65ac520SJiang Liu 
72a65ac520SJiang Liu #define	ACPI_INIT_DSM_ARGV4(cnt, eles)			\
73a65ac520SJiang Liu 	{						\
74a65ac520SJiang Liu 	  .package.type = ACPI_TYPE_PACKAGE,		\
75a65ac520SJiang Liu 	  .package.count = (cnt),			\
76a65ac520SJiang Liu 	  .package.elements = (eles)			\
77a65ac520SJiang Liu 	}
78a65ac520SJiang Liu 
79c68ae33eSLukas Wunner bool acpi_dev_found(const char *hid);
808661423eSHans de Goede bool acpi_dev_present(const char *hid, const char *uid, s64 hrv);
818eb99e9aSHans de Goede bool acpi_reduced_hardware(void);
822d12b6b3SLukas Wunner 
8376f58584SLen Brown #ifdef CONFIG_ACPI
841da177e4SLinus Torvalds 
85df23e2beSPeter Zijlstra struct proc_dir_entry;
861da177e4SLinus Torvalds 
871da177e4SLinus Torvalds #define ACPI_BUS_FILE_ROOT	"acpi"
881da177e4SLinus Torvalds extern struct proc_dir_entry *acpi_root_dir;
891da177e4SLinus Torvalds 
901da177e4SLinus Torvalds enum acpi_bus_device_type {
911da177e4SLinus Torvalds 	ACPI_BUS_TYPE_DEVICE = 0,
921da177e4SLinus Torvalds 	ACPI_BUS_TYPE_POWER,
931da177e4SLinus Torvalds 	ACPI_BUS_TYPE_PROCESSOR,
941da177e4SLinus Torvalds 	ACPI_BUS_TYPE_THERMAL,
951da177e4SLinus Torvalds 	ACPI_BUS_TYPE_POWER_BUTTON,
961da177e4SLinus Torvalds 	ACPI_BUS_TYPE_SLEEP_BUTTON,
97a64a62ceSLv Zheng 	ACPI_BUS_TYPE_ECDT_EC,
981da177e4SLinus Torvalds 	ACPI_BUS_DEVICE_TYPE_COUNT
991da177e4SLinus Torvalds };
1001da177e4SLinus Torvalds 
1011da177e4SLinus Torvalds struct acpi_driver;
1021da177e4SLinus Torvalds struct acpi_device;
1031da177e4SLinus Torvalds 
1041da177e4SLinus Torvalds /*
105ca589f94SRafael J. Wysocki  * ACPI Scan Handler
106ca589f94SRafael J. Wysocki  * -----------------
107ca589f94SRafael J. Wysocki  */
108ca589f94SRafael J. Wysocki 
109a33ec399SRafael J. Wysocki struct acpi_hotplug_profile {
1103f8055c3SRafael J. Wysocki 	struct kobject kobj;
1113338db00SRafael J. Wysocki 	int (*scan_dependent)(struct acpi_device *adev);
1128ab17fc9SRafael J. Wysocki 	void (*notify_online)(struct acpi_device *adev);
113d22ddcbcSRafael J. Wysocki 	bool enabled:1;
114d22ddcbcSRafael J. Wysocki 	bool demand_offline:1;
115a33ec399SRafael J. Wysocki };
116a33ec399SRafael J. Wysocki 
1173f8055c3SRafael J. Wysocki static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile(
1183f8055c3SRafael J. Wysocki 						struct kobject *kobj)
1193f8055c3SRafael J. Wysocki {
1203f8055c3SRafael J. Wysocki 	return container_of(kobj, struct acpi_hotplug_profile, kobj);
1213f8055c3SRafael J. Wysocki }
1223f8055c3SRafael J. Wysocki 
123ca589f94SRafael J. Wysocki struct acpi_scan_handler {
124ca589f94SRafael J. Wysocki 	const struct acpi_device_id *ids;
125ca589f94SRafael J. Wysocki 	struct list_head list_node;
126636c19d3SRasmus Villemoes 	bool (*match)(const char *idstr, const struct acpi_device_id **matchid);
127ca589f94SRafael J. Wysocki 	int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id);
128ca589f94SRafael J. Wysocki 	void (*detach)(struct acpi_device *dev);
1299cb32acfSRafael J. Wysocki 	void (*bind)(struct device *phys_dev);
1309cb32acfSRafael J. Wysocki 	void (*unbind)(struct device *phys_dev);
131a33ec399SRafael J. Wysocki 	struct acpi_hotplug_profile hotplug;
132ca589f94SRafael J. Wysocki };
133ca589f94SRafael J. Wysocki 
134ca589f94SRafael J. Wysocki /*
1353c2cc7ffSRafael J. Wysocki  * ACPI Hotplug Context
1363c2cc7ffSRafael J. Wysocki  * --------------------
1373c2cc7ffSRafael J. Wysocki  */
1383c2cc7ffSRafael J. Wysocki 
1393c2cc7ffSRafael J. Wysocki struct acpi_hotplug_context {
1403c2cc7ffSRafael J. Wysocki 	struct acpi_device *self;
141be27b3dcSRafael J. Wysocki 	int (*notify)(struct acpi_device *, u32);
142be27b3dcSRafael J. Wysocki 	void (*uevent)(struct acpi_device *, u32);
14359b42fa0SRafael J. Wysocki 	void (*fixup)(struct acpi_device *);
1443c2cc7ffSRafael J. Wysocki };
1453c2cc7ffSRafael J. Wysocki 
1463c2cc7ffSRafael J. Wysocki /*
1471da177e4SLinus Torvalds  * ACPI Driver
1481da177e4SLinus Torvalds  * -----------
1491da177e4SLinus Torvalds  */
1501da177e4SLinus Torvalds 
1511da177e4SLinus Torvalds typedef int (*acpi_op_add) (struct acpi_device * device);
15251fac838SRafael J. Wysocki typedef int (*acpi_op_remove) (struct acpi_device * device);
15346ec8598SBjorn Helgaas typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event);
1541da177e4SLinus Torvalds 
1551da177e4SLinus Torvalds struct acpi_device_ops {
1561da177e4SLinus Torvalds 	acpi_op_add add;
1571da177e4SLinus Torvalds 	acpi_op_remove remove;
15846ec8598SBjorn Helgaas 	acpi_op_notify notify;
1591da177e4SLinus Torvalds };
1601da177e4SLinus Torvalds 
1616d278131SBjorn Helgaas #define ACPI_DRIVER_ALL_NOTIFY_EVENTS	0x1	/* system AND device events */
1626d278131SBjorn Helgaas 
1631da177e4SLinus Torvalds struct acpi_driver {
1641da177e4SLinus Torvalds 	char name[80];
1651da177e4SLinus Torvalds 	char class[80];
1668c8eb78fSThomas Renninger 	const struct acpi_device_id *ids; /* Supported Hardware IDs */
1676d278131SBjorn Helgaas 	unsigned int flags;
1681da177e4SLinus Torvalds 	struct acpi_device_ops ops;
169d43ec68eSPatrick Mochel 	struct device_driver drv;
1701890a97aSPatrick Mochel 	struct module *owner;
1711da177e4SLinus Torvalds };
1721da177e4SLinus Torvalds 
1731da177e4SLinus Torvalds /*
1741da177e4SLinus Torvalds  * ACPI Device
1751da177e4SLinus Torvalds  * -----------
1761da177e4SLinus Torvalds  */
1771da177e4SLinus Torvalds 
1781da177e4SLinus Torvalds /* Status (_STA) */
1791da177e4SLinus Torvalds 
1801da177e4SLinus Torvalds struct acpi_device_status {
1811da177e4SLinus Torvalds 	u32 present:1;
1821da177e4SLinus Torvalds 	u32 enabled:1;
1831da177e4SLinus Torvalds 	u32 show_in_ui:1;
1841da177e4SLinus Torvalds 	u32 functional:1;
1851da177e4SLinus Torvalds 	u32 battery_present:1;
1861da177e4SLinus Torvalds 	u32 reserved:27;
1871da177e4SLinus Torvalds };
1881da177e4SLinus Torvalds 
1891da177e4SLinus Torvalds /* Flags */
1901da177e4SLinus Torvalds 
1911da177e4SLinus Torvalds struct acpi_device_flags {
1921da177e4SLinus Torvalds 	u32 dynamic_status:1;
1931da177e4SLinus Torvalds 	u32 removable:1;
1941da177e4SLinus Torvalds 	u32 ejectable:1;
1951da177e4SLinus Torvalds 	u32 power_manageable:1;
196209d3b17SRafael J. Wysocki 	u32 match_driver:1;
197202317a5SRafael J. Wysocki 	u32 initialized:1;
198202317a5SRafael J. Wysocki 	u32 visited:1;
1993c2cc7ffSRafael J. Wysocki 	u32 hotplug_notify:1;
2001e2380cdSRafael J. Wysocki 	u32 is_dock_station:1;
2015c53b262SRafael J. Wysocki 	u32 of_compatible_ok:1;
202d0562674SSuthikulpanit, Suravee 	u32 coherent_dma:1;
203d0562674SSuthikulpanit, Suravee 	u32 cca_seen:1;
204d87fb091SJohn Garry 	u32 enumeration_by_parent:1;
205e4330d8bSJarkko Nikula 	u32 reserved:19;
2061da177e4SLinus Torvalds };
2071da177e4SLinus Torvalds 
2081da177e4SLinus Torvalds /* File System */
2091da177e4SLinus Torvalds 
2101da177e4SLinus Torvalds struct acpi_device_dir {
2111da177e4SLinus Torvalds 	struct proc_dir_entry *entry;
2121da177e4SLinus Torvalds };
2131da177e4SLinus Torvalds 
2141da177e4SLinus Torvalds #define acpi_device_dir(d)	((d)->dir.entry)
2151da177e4SLinus Torvalds 
2161da177e4SLinus Torvalds /* Plug and Play */
2171da177e4SLinus Torvalds 
21824c5c4c2SZhao Yakui typedef char acpi_bus_id[8];
219ca6f998cSPierre-Louis Bossart typedef u64 acpi_bus_address;
2201da177e4SLinus Torvalds typedef char acpi_device_name[40];
2211da177e4SLinus Torvalds typedef char acpi_device_class[20];
2221da177e4SLinus Torvalds 
2237f47fa6cSBjorn Helgaas struct acpi_hardware_id {
2247f47fa6cSBjorn Helgaas 	struct list_head list;
225844142c3SRasmus Villemoes 	const char *id;
2267f47fa6cSBjorn Helgaas };
2277f47fa6cSBjorn Helgaas 
228d4e1a692SToshi Kani struct acpi_pnp_type {
229d4e1a692SToshi Kani 	u32 hardware_id:1;
230d4e1a692SToshi Kani 	u32 bus_address:1;
231549e6845SRafael J. Wysocki 	u32 platform_id:1;
232549e6845SRafael J. Wysocki 	u32 reserved:29;
233d4e1a692SToshi Kani };
234d4e1a692SToshi Kani 
2351da177e4SLinus Torvalds struct acpi_device_pnp {
2361da177e4SLinus Torvalds 	acpi_bus_id bus_id;		/* Object name */
237eb50aaf9SAndy Shevchenko 	int instance_no;		/* Instance number of this object */
238d4e1a692SToshi Kani 	struct acpi_pnp_type type;	/* ID type */
2391da177e4SLinus Torvalds 	acpi_bus_address bus_address;	/* _ADR */
24015b8dd53SBob Moore 	char *unique_id;		/* _UID */
2417f47fa6cSBjorn Helgaas 	struct list_head ids;		/* _HID and _CIDs */
2421da177e4SLinus Torvalds 	acpi_device_name device_name;	/* Driver-determined */
2431da177e4SLinus Torvalds 	acpi_device_class device_class;	/*        "          */
244d1efe3c3SLance Ortiz 	union acpi_object *str_obj;	/* unicode string for _STR method */
2451da177e4SLinus Torvalds };
2461da177e4SLinus Torvalds 
2471da177e4SLinus Torvalds #define acpi_device_bid(d)	((d)->pnp.bus_id)
2481da177e4SLinus Torvalds #define acpi_device_adr(d)	((d)->pnp.bus_address)
249620e112cSThomas Renninger const char *acpi_device_hid(struct acpi_device *device);
250359597cbSAdrian Hunter #define acpi_device_uid(d)	((d)->pnp.unique_id)
2511da177e4SLinus Torvalds #define acpi_device_name(d)	((d)->pnp.device_name)
2521da177e4SLinus Torvalds #define acpi_device_class(d)	((d)->pnp.device_class)
2531da177e4SLinus Torvalds 
2541da177e4SLinus Torvalds /* Power Management */
2551da177e4SLinus Torvalds 
2561da177e4SLinus Torvalds struct acpi_device_power_flags {
2571da177e4SLinus Torvalds 	u32 explicit_get:1;	/* _PSC present? */
2581da177e4SLinus Torvalds 	u32 power_resources:1;	/* Power resources */
2591da177e4SLinus Torvalds 	u32 inrush_current:1;	/* Serialize Dx->D0 */
2601da177e4SLinus Torvalds 	u32 power_removed:1;	/* Optimize Dx->D0 */
261644f17adSMika Westerberg 	u32 ignore_parent:1;	/* Power is independent of parent power state */
262f25c0ae2SRafael J. Wysocki 	u32 dsw_present:1;	/* _DSW present? */
263f25c0ae2SRafael J. Wysocki 	u32 reserved:26;
2641da177e4SLinus Torvalds };
2651da177e4SLinus Torvalds 
2661da177e4SLinus Torvalds struct acpi_device_power_state {
2671da177e4SLinus Torvalds 	struct {
2681da177e4SLinus Torvalds 		u8 valid:1;
2691da177e4SLinus Torvalds 		u8 explicit_set:1;	/* _PSx present? */
2701da177e4SLinus Torvalds 		u8 reserved:6;
2711da177e4SLinus Torvalds 	} flags;
2721da177e4SLinus Torvalds 	int power;		/* % Power (compared to D0) */
2731da177e4SLinus Torvalds 	int latency;		/* Dx->D0 time (microseconds) */
2740b224527SRafael J. Wysocki 	struct list_head resources;	/* Power resources referenced */
2751da177e4SLinus Torvalds };
2761da177e4SLinus Torvalds 
2771da177e4SLinus Torvalds struct acpi_device_power {
2781da177e4SLinus Torvalds 	int state;		/* Current state */
2791da177e4SLinus Torvalds 	struct acpi_device_power_flags flags;
280b4a03b9aSLin Ming 	struct acpi_device_power_state states[ACPI_D_STATE_COUNT];	/* Power states (D0-D3Cold) */
281b340c7d6SSakari Ailus 	u8 state_for_enumeration; /* Deepest power state for enumeration */
2821da177e4SLinus Torvalds };
2831da177e4SLinus Torvalds 
284a9e10e58SDaniel Scally struct acpi_dep_data {
285a9e10e58SDaniel Scally 	struct list_head node;
286a9e10e58SDaniel Scally 	acpi_handle supplier;
287a9e10e58SDaniel Scally 	acpi_handle consumer;
288a9e10e58SDaniel Scally };
289a9e10e58SDaniel Scally 
2901da177e4SLinus Torvalds /* Performance Management */
2911da177e4SLinus Torvalds 
2921da177e4SLinus Torvalds struct acpi_device_perf_flags {
2931da177e4SLinus Torvalds 	u8 reserved:8;
2941da177e4SLinus Torvalds };
2951da177e4SLinus Torvalds 
2961da177e4SLinus Torvalds struct acpi_device_perf_state {
2971da177e4SLinus Torvalds 	struct {
2981da177e4SLinus Torvalds 		u8 valid:1;
2991da177e4SLinus Torvalds 		u8 reserved:7;
3001da177e4SLinus Torvalds 	} flags;
3011da177e4SLinus Torvalds 	u8 power;		/* % Power (compared to P0) */
3021da177e4SLinus Torvalds 	u8 performance;		/* % Performance (    "   ) */
3031da177e4SLinus Torvalds 	int latency;		/* Px->P0 time (microseconds) */
3041da177e4SLinus Torvalds };
3051da177e4SLinus Torvalds 
3061da177e4SLinus Torvalds struct acpi_device_perf {
3071da177e4SLinus Torvalds 	int state;
3081da177e4SLinus Torvalds 	struct acpi_device_perf_flags flags;
3091da177e4SLinus Torvalds 	int state_count;
3101da177e4SLinus Torvalds 	struct acpi_device_perf_state *states;
3111da177e4SLinus Torvalds };
3121da177e4SLinus Torvalds 
3131da177e4SLinus Torvalds /* Wakeup Management */
3141da177e4SLinus Torvalds struct acpi_device_wakeup_flags {
3151da177e4SLinus Torvalds 	u8 valid:1;		/* Can successfully enable wakeup? */
316b67ea761SRafael J. Wysocki 	u8 notifier_present:1;  /* Wake-up notify handler has been installed */
3171da177e4SLinus Torvalds };
3181da177e4SLinus Torvalds 
319c072530fSRafael J. Wysocki struct acpi_device_wakeup_context {
32064fd1c70SRafael J. Wysocki 	void (*func)(struct acpi_device_wakeup_context *context);
321c072530fSRafael J. Wysocki 	struct device *dev;
322c072530fSRafael J. Wysocki };
323c072530fSRafael J. Wysocki 
3241da177e4SLinus Torvalds struct acpi_device_wakeup {
3251da177e4SLinus Torvalds 	acpi_handle gpe_device;
326439913ffSLin Ming 	u64 gpe_number;
327439913ffSLin Ming 	u64 sleep_state;
328993cbe59SRafael J. Wysocki 	struct list_head resources;
3291da177e4SLinus Torvalds 	struct acpi_device_wakeup_flags flags;
330c072530fSRafael J. Wysocki 	struct acpi_device_wakeup_context context;
331c072530fSRafael J. Wysocki 	struct wakeup_source *ws;
3329b83ccd2SRafael J. Wysocki 	int prepare_count;
33399d8845eSRafael J. Wysocki 	int enable_count;
3341da177e4SLinus Torvalds };
3351da177e4SLinus Torvalds 
3361033f904SLan Tianyu struct acpi_device_physical_node {
337007ccfcfSRafael J. Wysocki 	unsigned int node_id;
3381033f904SLan Tianyu 	struct list_head node;
3391033f904SLan Tianyu 	struct device *dev;
340683058e3SRafael J. Wysocki 	bool put_online:1;
3411033f904SLan Tianyu };
3421da177e4SLinus Torvalds 
3435f5e4890SMika Westerberg struct acpi_device_properties {
3445f5e4890SMika Westerberg 	const guid_t *guid;
3455f5e4890SMika Westerberg 	const union acpi_object *properties;
3465f5e4890SMika Westerberg 	struct list_head list;
3475f5e4890SMika Westerberg };
3485f5e4890SMika Westerberg 
349ffdcd955SMika Westerberg /* ACPI Device Specific Data (_DSD) */
350ffdcd955SMika Westerberg struct acpi_device_data {
351ffdcd955SMika Westerberg 	const union acpi_object *pointer;
3525f5e4890SMika Westerberg 	struct list_head properties;
353733e6251SMika Westerberg 	const union acpi_object *of_compatible;
354445b0eb0SRafael J. Wysocki 	struct list_head subnodes;
355ffdcd955SMika Westerberg };
356ffdcd955SMika Westerberg 
357f028d524SRafael J. Wysocki struct acpi_gpio_mapping;
358f028d524SRafael J. Wysocki 
3591033f904SLan Tianyu /* Device */
3601da177e4SLinus Torvalds struct acpi_device {
361caaa6efbSBjorn Helgaas 	int device_type;
362caaa6efbSBjorn Helgaas 	acpi_handle handle;		/* no handle for fixed hardware */
3638a0662d9SRafael J. Wysocki 	struct fwnode_handle fwnode;
3641da177e4SLinus Torvalds 	struct acpi_device *parent;
3651da177e4SLinus Torvalds 	struct list_head children;
3661da177e4SLinus Torvalds 	struct list_head node;
3671da177e4SLinus Torvalds 	struct list_head wakeup_list;
368d783156eSRafael J. Wysocki 	struct list_head del_list;
3691da177e4SLinus Torvalds 	struct acpi_device_status status;
3701da177e4SLinus Torvalds 	struct acpi_device_flags flags;
3711da177e4SLinus Torvalds 	struct acpi_device_pnp pnp;
3721da177e4SLinus Torvalds 	struct acpi_device_power power;
3731da177e4SLinus Torvalds 	struct acpi_device_wakeup wakeup;
3741da177e4SLinus Torvalds 	struct acpi_device_perf performance;
3751da177e4SLinus Torvalds 	struct acpi_device_dir dir;
376ffdcd955SMika Westerberg 	struct acpi_device_data data;
377ca589f94SRafael J. Wysocki 	struct acpi_scan_handler *handler;
3783c2cc7ffSRafael J. Wysocki 	struct acpi_hotplug_context *hp;
3791da177e4SLinus Torvalds 	struct acpi_driver *driver;
380f028d524SRafael J. Wysocki 	const struct acpi_gpio_mapping *driver_gpios;
3811da177e4SLinus Torvalds 	void *driver_data;
3825b327265SPatrick Mochel 	struct device dev;
383007ccfcfSRafael J. Wysocki 	unsigned int physical_node_count;
38440e7fcb1SLan Tianyu 	unsigned int dep_unmet;
3851033f904SLan Tianyu 	struct list_head physical_node_list;
3861033f904SLan Tianyu 	struct mutex physical_node_lock;
387b1c0f99bSRafael J. Wysocki 	void (*remove)(struct acpi_device *);
3881da177e4SLinus Torvalds };
3891da177e4SLinus Torvalds 
390445b0eb0SRafael J. Wysocki /* Non-device subnode */
391445b0eb0SRafael J. Wysocki struct acpi_data_node {
392445b0eb0SRafael J. Wysocki 	const char *name;
393263b4c1aSRafael J. Wysocki 	acpi_handle handle;
394445b0eb0SRafael J. Wysocki 	struct fwnode_handle fwnode;
395dfa672fbSMika Westerberg 	struct fwnode_handle *parent;
396445b0eb0SRafael J. Wysocki 	struct acpi_device_data data;
397445b0eb0SRafael J. Wysocki 	struct list_head sibling;
398263b4c1aSRafael J. Wysocki 	struct kobject kobj;
399263b4c1aSRafael J. Wysocki 	struct completion kobj_done;
400445b0eb0SRafael J. Wysocki };
401445b0eb0SRafael J. Wysocki 
402db3e50f3SSakari Ailus extern const struct fwnode_operations acpi_device_fwnode_ops;
403db3e50f3SSakari Ailus extern const struct fwnode_operations acpi_data_fwnode_ops;
404db3e50f3SSakari Ailus extern const struct fwnode_operations acpi_static_fwnode_ops;
405db3e50f3SSakari Ailus 
4069e987b70SJohn Hubbard bool is_acpi_device_node(const struct fwnode_handle *fwnode);
4079e987b70SJohn Hubbard bool is_acpi_data_node(const struct fwnode_handle *fwnode);
4089e987b70SJohn Hubbard 
4098b9d6802SSakari Ailus static inline bool is_acpi_node(const struct fwnode_handle *fwnode)
4108a0662d9SRafael J. Wysocki {
4119e987b70SJohn Hubbard 	return (is_acpi_device_node(fwnode) || is_acpi_data_node(fwnode));
4128a0662d9SRafael J. Wysocki }
4138a0662d9SRafael J. Wysocki 
4148b9d6802SSakari Ailus #define to_acpi_device_node(__fwnode)					\
4158b9d6802SSakari Ailus 	({								\
4168b9d6802SSakari Ailus 		typeof(__fwnode) __to_acpi_device_node_fwnode = __fwnode; \
4178b9d6802SSakari Ailus 									\
4188b9d6802SSakari Ailus 		is_acpi_device_node(__to_acpi_device_node_fwnode) ?	\
4198b9d6802SSakari Ailus 			container_of(__to_acpi_device_node_fwnode,	\
4208b9d6802SSakari Ailus 				     struct acpi_device, fwnode) :	\
4218b9d6802SSakari Ailus 			NULL;						\
4228b9d6802SSakari Ailus 	})
4238a0662d9SRafael J. Wysocki 
4248b9d6802SSakari Ailus #define to_acpi_data_node(__fwnode)					\
4258b9d6802SSakari Ailus 	({								\
4268b9d6802SSakari Ailus 		typeof(__fwnode) __to_acpi_data_node_fwnode = __fwnode;	\
4278b9d6802SSakari Ailus 									\
4288b9d6802SSakari Ailus 		is_acpi_data_node(__to_acpi_data_node_fwnode) ?		\
4298b9d6802SSakari Ailus 			container_of(__to_acpi_data_node_fwnode,	\
4308b9d6802SSakari Ailus 				     struct acpi_data_node, fwnode) :	\
4318b9d6802SSakari Ailus 			NULL;						\
4328b9d6802SSakari Ailus 	})
4333a7a2ab8SRafael J. Wysocki 
4348b9d6802SSakari Ailus static inline bool is_acpi_static_node(const struct fwnode_handle *fwnode)
435db89b4f0SPavel Machek {
436db3e50f3SSakari Ailus 	return !IS_ERR_OR_NULL(fwnode) &&
437db3e50f3SSakari Ailus 		fwnode->ops == &acpi_static_fwnode_ops;
438db89b4f0SPavel Machek }
439d43ec68eSPatrick Mochel 
4408b9d6802SSakari Ailus static inline bool acpi_data_node_match(const struct fwnode_handle *fwnode,
441613e9721SAdam Thomson 					const char *name)
442613e9721SAdam Thomson {
443613e9721SAdam Thomson 	return is_acpi_data_node(fwnode) ?
444613e9721SAdam Thomson 		(!strcmp(to_acpi_data_node(fwnode)->name, name)) : false;
445613e9721SAdam Thomson }
446613e9721SAdam Thomson 
44725db115bSRafael J. Wysocki static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev)
4483c2cc7ffSRafael J. Wysocki {
449ba574dc8SRafael J. Wysocki 	return &adev->fwnode;
4503c2cc7ffSRafael J. Wysocki }
4513c2cc7ffSRafael J. Wysocki 
4523c2cc7ffSRafael J. Wysocki static inline void *acpi_driver_data(struct acpi_device *d)
4533c2cc7ffSRafael J. Wysocki {
4543c2cc7ffSRafael J. Wysocki 	return d->driver_data;
4555d513205SRafael J. Wysocki }
4565d513205SRafael J. Wysocki 
4575d513205SRafael J. Wysocki #define to_acpi_device(d)	container_of(d, struct acpi_device, dev)
4585d513205SRafael J. Wysocki #define to_acpi_driver(d)	container_of(d, struct acpi_driver, drv)
4595d513205SRafael J. Wysocki 
46055955aadSDavid Brownell static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta)
46155955aadSDavid Brownell {
46255955aadSDavid Brownell 	*((u32 *)&adev->status) = sta;
4631da177e4SLinus Torvalds }
4641da177e4SLinus Torvalds 
4651da177e4SLinus Torvalds static inline void acpi_set_hp_context(struct acpi_device *adev,
4661da177e4SLinus Torvalds 				       struct acpi_hotplug_context *hp)
4671da177e4SLinus Torvalds {
4681da177e4SLinus Torvalds 	hp->self = adev;
4691da177e4SLinus Torvalds 	adev->hp = hp;
4701da177e4SLinus Torvalds }
4711da177e4SLinus Torvalds 
4721da177e4SLinus Torvalds void acpi_initialize_hp_context(struct acpi_device *adev,
4731da177e4SLinus Torvalds 				struct acpi_hotplug_context *hp,
4741da177e4SLinus Torvalds 				int (*notify)(struct acpi_device *, u32),
4751da177e4SLinus Torvalds 				void (*uevent)(struct acpi_device *, u32));
47699e0d2fcSGreg Kroah-Hartman 
477962ce8caSZhang Rui /* acpi_device.dev.bus == &acpi_bus_type */
4788e4319c4SBob Moore extern struct bus_type acpi_bus_type;
47920733939SZhang Rui 
48072013795SLan Tianyu /*
48172013795SLan Tianyu  * Events
4829ee85241SZhang Rui  * ------
4839ee85241SZhang Rui  */
4849ee85241SZhang Rui 
4856bd00a61SShaohua Li struct acpi_bus_event {
4861da177e4SLinus Torvalds 	struct list_head node;
4871da177e4SLinus Torvalds 	acpi_device_class device_class;
4881da177e4SLinus Torvalds 	acpi_bus_id bus_id;
4891da177e4SLinus Torvalds 	u32 type;
4901da177e4SLinus Torvalds 	u32 data;
49178ea4639SRafael J. Wysocki };
49278ea4639SRafael J. Wysocki 
493402ac536SBjorn Helgaas extern struct kobject *acpi_kobj;
494402ac536SBjorn Helgaas extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int);
4951da177e4SLinus Torvalds void acpi_bus_private_data_handler(acpi_handle, void *);
4969ce4e607SRafael J. Wysocki int acpi_bus_get_private_data(acpi_handle, void **);
4971da177e4SLinus Torvalds int acpi_bus_attach_private_data(acpi_handle, void *);
49896bfd3ceSRafael J. Wysocki void acpi_bus_detach_private_data(acpi_handle);
499ad0c3b0eSRafael J. Wysocki extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32);
500078eb126SRafael J. Wysocki extern int register_acpi_notifier(struct notifier_block *);
5019ce4e607SRafael J. Wysocki extern int unregister_acpi_notifier(struct notifier_block *);
502b9e95fc6SRafael J. Wysocki 
50325eed407SRafael J. Wysocki /*
5042bb3a2bfSAaron Lu  * External Functions
5053737b2b1SRafael J. Wysocki  */
506ec4602a9SRafael J. Wysocki 
507ec4602a9SRafael J. Wysocki int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device);
508e3c963c4SRafael J. Wysocki struct acpi_device *acpi_fetch_acpi_dev(acpi_handle handle);
5091da177e4SLinus Torvalds acpi_status acpi_bus_get_status_handle(acpi_handle handle,
5101da177e4SLinus Torvalds 				       unsigned long long *sta);
5111da177e4SLinus Torvalds int acpi_bus_get_status(struct acpi_device *device);
5121da177e4SLinus Torvalds 
5131da177e4SLinus Torvalds int acpi_bus_set_power(acpi_handle handle, int state);
5141da177e4SLinus Torvalds const char *acpi_power_state_string(int state);
5151da177e4SLinus Torvalds int acpi_device_set_power(struct acpi_device *device, int state);
5161da177e4SLinus Torvalds int acpi_bus_init_power(struct acpi_device *device);
5171da177e4SLinus Torvalds int acpi_device_fix_up_power(struct acpi_device *device);
51814e04fb3SLen Brown int acpi_bus_update_power(acpi_handle handle, int *state_p);
519eb9d0fe4SRafael J. Wysocki int acpi_device_update_power(struct acpi_device *device, int *state_p);
52014e04fb3SLen Brown bool acpi_bus_power_manageable(acpi_handle handle);
5214533771cSMika Westerberg int acpi_device_power_add_dependent(struct acpi_device *adev,
5224533771cSMika Westerberg 				    struct device *dev);
5234533771cSMika Westerberg void acpi_device_power_remove_dependent(struct acpi_device *adev,
5244533771cSMika Westerberg 					struct device *dev);
5251da177e4SLinus Torvalds 
52614e04fb3SLen Brown #ifdef CONFIG_PM
52714e04fb3SLen Brown bool acpi_bus_can_wakeup(acpi_handle handle);
528ec4602a9SRafael J. Wysocki #else
529ec4602a9SRafael J. Wysocki static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; }
530ec4602a9SRafael J. Wysocki #endif
5319ce4e607SRafael J. Wysocki 
5323757b948SRafael J. Wysocki void acpi_scan_lock_acquire(void);
5333757b948SRafael J. Wysocki void acpi_scan_lock_release(void);
534e525506fSRafael J. Wysocki void acpi_lock_hp_context(void);
535e525506fSRafael J. Wysocki void acpi_unlock_hp_context(void);
536ca589f94SRafael J. Wysocki int acpi_scan_add_handler(struct acpi_scan_handler *handler);
5371da177e4SLinus Torvalds int acpi_bus_register_driver(struct acpi_driver *driver);
53806ea8e08SBjorn Helgaas void acpi_bus_unregister_driver(struct acpi_driver *driver);
539b8bd759aSRafael J. Wysocki int acpi_bus_scan(acpi_handle handle);
540bfee26dbSRafael J. Wysocki void acpi_bus_trim(struct acpi_device *start);
541c8f7a62cSLen Brown acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd);
5428c8eb78fSThomas Renninger int acpi_match_device_ids(struct acpi_device *device,
5438c8eb78fSThomas Renninger 			  const struct acpi_device_id *ids);
54451ede5d9SDan O'Donovan void acpi_set_modalias(struct acpi_device *adev, const char *default_id,
54551ede5d9SDan O'Donovan 		       char *modalias, size_t len);
5461da177e4SLinus Torvalds int acpi_create_dir(struct acpi_device *);
5471da177e4SLinus Torvalds void acpi_remove_dir(struct acpi_device *);
5481da177e4SLinus Torvalds 
549202317a5SRafael J. Wysocki static inline bool acpi_device_enumerated(struct acpi_device *adev)
550202317a5SRafael J. Wysocki {
551202317a5SRafael J. Wysocki 	return adev && adev->flags.initialized && adev->flags.visited;
552202317a5SRafael J. Wysocki }
553202317a5SRafael J. Wysocki 
5540d2cf8f5SMika Westerberg /**
5550d2cf8f5SMika Westerberg  * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver
5560d2cf8f5SMika Westerberg  * @__acpi_driver: acpi_driver struct
5570d2cf8f5SMika Westerberg  *
5580d2cf8f5SMika Westerberg  * Helper macro for ACPI drivers which do not do anything special in module
5590d2cf8f5SMika Westerberg  * init/exit. This eliminates a lot of boilerplate. Each module may only
5600d2cf8f5SMika Westerberg  * use this macro once, and calling it replaces module_init() and module_exit()
5610d2cf8f5SMika Westerberg  */
5620d2cf8f5SMika Westerberg #define module_acpi_driver(__acpi_driver) \
5630d2cf8f5SMika Westerberg 	module_driver(__acpi_driver, acpi_bus_register_driver, \
5640d2cf8f5SMika Westerberg 		      acpi_bus_unregister_driver)
5650d2cf8f5SMika Westerberg 
5664e10d12aSDavid Shaohua Li /*
5674e10d12aSDavid Shaohua Li  * Bind physical devices with ACPI devices
5684e10d12aSDavid Shaohua Li  */
5694e10d12aSDavid Shaohua Li struct acpi_bus_type {
5704e10d12aSDavid Shaohua Li 	struct list_head list;
57153540098SRafael J. Wysocki 	const char *name;
57253540098SRafael J. Wysocki 	bool (*match)(struct device *dev);
573e3f02c52SRafael J. Wysocki 	struct acpi_device * (*find_companion)(struct device *);
57411909ca1SRafael J. Wysocki 	void (*setup)(struct device *);
5754e10d12aSDavid Shaohua Li };
5764e10d12aSDavid Shaohua Li int register_acpi_bus_type(struct acpi_bus_type *);
5774e10d12aSDavid Shaohua Li int unregister_acpi_bus_type(struct acpi_bus_type *);
578f1b1dc84SZhang Rui int acpi_bind_one(struct device *dev, struct acpi_device *adev);
579f1b1dc84SZhang Rui int acpi_unbind_one(struct device *dev);
58022c13f9dSThomas Renninger 
58176d56de5SAlex Chiang struct acpi_pci_root {
58276d56de5SAlex Chiang 	struct acpi_device * device;
58376d56de5SAlex Chiang 	struct pci_bus *bus;
58476d56de5SAlex Chiang 	u16 segment;
5856ad95513SBjorn Helgaas 	struct resource secondary;	/* downstream bus range */
58676d56de5SAlex Chiang 
58776d56de5SAlex Chiang 	u32 osc_support_set;	/* _OSC state of support bits */
58876d56de5SAlex Chiang 	u32 osc_control_set;	/* _OSC state of control bits */
589f4b57a3bSJiang Liu 	phys_addr_t mcfg_addr;
59076d56de5SAlex Chiang };
59176d56de5SAlex Chiang 
5924e10d12aSDavid Shaohua Li /* helper */
593d9fef0c4SRafael J. Wysocki 
5943d7c821cSAndy Shevchenko bool acpi_dma_supported(const struct acpi_device *adev);
595b84f196dSSuthikulpanit, Suravee enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev);
59611a8c5e3SJean-Philippe Brucker int acpi_iommu_fwspec_init(struct device *dev, u32 id,
59711a8c5e3SJean-Philippe Brucker 			   struct fwnode_handle *fwnode,
59811a8c5e3SJean-Philippe Brucker 			   const struct iommu_ops *ops);
599c04ac679SLorenzo Pieralisi int acpi_dma_get_range(struct device *dev, u64 *dma_addr, u64 *offset,
600c04ac679SLorenzo Pieralisi 		       u64 *size);
601b8e069a2SLorenzo Pieralisi int acpi_dma_configure_id(struct device *dev, enum dev_dma_attr attr,
602b8e069a2SLorenzo Pieralisi 			   const u32 *input_id);
603b8e069a2SLorenzo Pieralisi static inline int acpi_dma_configure(struct device *dev,
604b8e069a2SLorenzo Pieralisi 				     enum dev_dma_attr attr)
605b8e069a2SLorenzo Pieralisi {
606b8e069a2SLorenzo Pieralisi 	return acpi_dma_configure_id(dev, attr, NULL);
607b8e069a2SLorenzo Pieralisi }
608d9fef0c4SRafael J. Wysocki struct acpi_device *acpi_find_child_device(struct acpi_device *parent,
609d9fef0c4SRafael J. Wysocki 					   u64 address, bool check_children);
61027558203SAlexander Chiang int acpi_is_root_bridge(acpi_handle);
61176d56de5SAlex Chiang struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle);
6124e10d12aSDavid Shaohua Li 
613b67ea761SRafael J. Wysocki int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state);
614b67ea761SRafael J. Wysocki int acpi_disable_wakeup_device_power(struct acpi_device *dev);
615b67ea761SRafael J. Wysocki 
616b7ecf663SHans de Goede #ifdef CONFIG_X86
617b7ecf663SHans de Goede bool acpi_device_always_present(struct acpi_device *adev);
618b7ecf663SHans de Goede #else
619b7ecf663SHans de Goede static inline bool acpi_device_always_present(struct acpi_device *adev)
620b7ecf663SHans de Goede {
621b7ecf663SHans de Goede 	return false;
622b7ecf663SHans de Goede }
623b7ecf663SHans de Goede #endif
624b7ecf663SHans de Goede 
625*35f9e773SHans de Goede #if IS_ENABLED(CONFIG_X86_ANDROID_TABLETS)
626*35f9e773SHans de Goede bool acpi_quirk_skip_i2c_client_enumeration(struct acpi_device *adev);
627*35f9e773SHans de Goede int acpi_quirk_skip_serdev_enumeration(struct device *controller_parent, bool *skip);
628*35f9e773SHans de Goede #else
629*35f9e773SHans de Goede static inline bool acpi_quirk_skip_i2c_client_enumeration(struct acpi_device *adev)
630*35f9e773SHans de Goede {
631*35f9e773SHans de Goede 	return false;
632*35f9e773SHans de Goede }
633*35f9e773SHans de Goede static inline int
634*35f9e773SHans de Goede acpi_quirk_skip_serdev_enumeration(struct device *controller_parent, bool *skip)
635*35f9e773SHans de Goede {
636*35f9e773SHans de Goede 	*skip = false;
637*35f9e773SHans de Goede 	return 0;
638*35f9e773SHans de Goede }
639*35f9e773SHans de Goede #endif
640*35f9e773SHans de Goede 
641aa338601SRafael J. Wysocki #ifdef CONFIG_PM
64233e4f80eSRafael J. Wysocki void acpi_pm_wakeup_event(struct device *dev);
643c072530fSRafael J. Wysocki acpi_status acpi_add_pm_notifier(struct acpi_device *adev, struct device *dev,
64464fd1c70SRafael J. Wysocki 			void (*func)(struct acpi_device_wakeup_context *context));
645c072530fSRafael J. Wysocki acpi_status acpi_remove_pm_notifier(struct acpi_device *adev);
6468370c2dcSRafael J. Wysocki bool acpi_pm_device_can_wakeup(struct device *dev);
647ee85f543SHuang Ying int acpi_pm_device_sleep_state(struct device *, int *, int);
6484d183d04SRafael J. Wysocki int acpi_pm_set_device_wakeup(struct device *dev, bool enable);
649761afb86SRafael J. Wysocki #else
65033e4f80eSRafael J. Wysocki static inline void acpi_pm_wakeup_event(struct device *dev)
65133e4f80eSRafael J. Wysocki {
65233e4f80eSRafael J. Wysocki }
653ec2cd81cSRafael J. Wysocki static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev,
654c072530fSRafael J. Wysocki 					       struct device *dev,
65533e4f80eSRafael J. Wysocki 					       void (*func)(struct acpi_device_wakeup_context *context))
656ec2cd81cSRafael J. Wysocki {
657ec2cd81cSRafael J. Wysocki 	return AE_SUPPORT;
658ec2cd81cSRafael J. Wysocki }
659c072530fSRafael J. Wysocki static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev)
660ec2cd81cSRafael J. Wysocki {
661ec2cd81cSRafael J. Wysocki 	return AE_SUPPORT;
662ec2cd81cSRafael J. Wysocki }
6638370c2dcSRafael J. Wysocki static inline bool acpi_pm_device_can_wakeup(struct device *dev)
6648370c2dcSRafael J. Wysocki {
6658370c2dcSRafael J. Wysocki 	return false;
6668370c2dcSRafael J. Wysocki }
667b25c77efSRafael J. Wysocki static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m)
668296699deSRafael J. Wysocki {
669296699deSRafael J. Wysocki 	if (p)
670296699deSRafael J. Wysocki 		*p = ACPI_STATE_D0;
671b25c77efSRafael J. Wysocki 
6728ad928d5SRafael J. Wysocki 	return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ?
6738ad928d5SRafael J. Wysocki 		m : ACPI_STATE_D0;
674296699deSRafael J. Wysocki }
6754d183d04SRafael J. Wysocki static inline int acpi_pm_set_device_wakeup(struct device *dev, bool enable)
676f7a1b860SDavid Howells {
677f7a1b860SDavid Howells 	return -ENODEV;
678f7a1b860SDavid Howells }
679761afb86SRafael J. Wysocki #endif
680fd4aff1aSShaohua Li 
681ad5a449bSDexuan Cui #ifdef CONFIG_ACPI_SYSTEM_POWER_STATES_SUPPORT
682ad5a449bSDexuan Cui bool acpi_sleep_state_supported(u8 sleep_state);
683ad5a449bSDexuan Cui #else
684ad5a449bSDexuan Cui static inline bool acpi_sleep_state_supported(u8 sleep_state) { return false; }
685ad5a449bSDexuan Cui #endif
686ad5a449bSDexuan Cui 
68799926a8cSDavid Rientjes #ifdef CONFIG_ACPI_SLEEP
68899926a8cSDavid Rientjes u32 acpi_target_system_state(void);
68999926a8cSDavid Rientjes #else
69099926a8cSDavid Rientjes static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; }
69199926a8cSDavid Rientjes #endif
69299926a8cSDavid Rientjes 
693078eb126SRafael J. Wysocki static inline bool acpi_device_power_manageable(struct acpi_device *adev)
694078eb126SRafael J. Wysocki {
695078eb126SRafael J. Wysocki 	return adev->flags.power_manageable;
696078eb126SRafael J. Wysocki }
697078eb126SRafael J. Wysocki 
698078eb126SRafael J. Wysocki static inline bool acpi_device_can_wakeup(struct acpi_device *adev)
699078eb126SRafael J. Wysocki {
700078eb126SRafael J. Wysocki 	return adev->wakeup.flags.valid;
701078eb126SRafael J. Wysocki }
702078eb126SRafael J. Wysocki 
7031399dfcdSAaron Lu static inline bool acpi_device_can_poweroff(struct acpi_device *adev)
7041399dfcdSAaron Lu {
705cd7f84c0SKen Xue 	return adev->power.states[ACPI_STATE_D3_COLD].flags.valid ||
706cd7f84c0SKen Xue 		((acpi_gbl_FADT.header.revision < 6) &&
707cd7f84c0SKen Xue 		adev->power.states[ACPI_STATE_D3_HOT].flags.explicit_set);
7081399dfcdSAaron Lu }
7091399dfcdSAaron Lu 
71035009c80SAndy Shevchenko bool acpi_dev_hid_uid_match(struct acpi_device *adev, const char *hid2, const char *uid2);
71135009c80SAndy Shevchenko 
712a9e10e58SDaniel Scally void acpi_dev_clear_dependencies(struct acpi_device *supplier);
713b83e2b30SDaniel Scally struct acpi_device *acpi_dev_get_first_consumer_dev(struct acpi_device *supplier);
714a814dcc2SAndy Shevchenko struct acpi_device *
715bf263f64SDaniel Scally acpi_dev_get_next_match_dev(struct acpi_device *adev, const char *hid, const char *uid, s64 hrv);
716bf263f64SDaniel Scally struct acpi_device *
717a814dcc2SAndy Shevchenko acpi_dev_get_first_match_dev(const char *hid, const char *uid, s64 hrv);
718a814dcc2SAndy Shevchenko 
71981eeb2f5SAndy Shevchenko /**
72081eeb2f5SAndy Shevchenko  * for_each_acpi_dev_match - iterate over ACPI devices that matching the criteria
72181eeb2f5SAndy Shevchenko  * @adev: pointer to the matching ACPI device, NULL at the end of the loop
72281eeb2f5SAndy Shevchenko  * @hid: Hardware ID of the device.
72381eeb2f5SAndy Shevchenko  * @uid: Unique ID of the device, pass NULL to not check _UID
72481eeb2f5SAndy Shevchenko  * @hrv: Hardware Revision of the device, pass -1 to not check _HRV
72581eeb2f5SAndy Shevchenko  *
72681eeb2f5SAndy Shevchenko  * The caller is responsible for invoking acpi_dev_put() on the returned device.
72781eeb2f5SAndy Shevchenko  */
728bf263f64SDaniel Scally #define for_each_acpi_dev_match(adev, hid, uid, hrv)			\
729bf263f64SDaniel Scally 	for (adev = acpi_dev_get_first_match_dev(hid, uid, hrv);	\
730bf263f64SDaniel Scally 	     adev;							\
731bf263f64SDaniel Scally 	     adev = acpi_dev_get_next_match_dev(adev, hid, uid, hrv))
732bf263f64SDaniel Scally 
7334cbaba4eSAndy Shevchenko static inline struct acpi_device *acpi_dev_get(struct acpi_device *adev)
7344cbaba4eSAndy Shevchenko {
7354cbaba4eSAndy Shevchenko 	return adev ? to_acpi_device(get_device(&adev->dev)) : NULL;
7364cbaba4eSAndy Shevchenko }
7374cbaba4eSAndy Shevchenko 
738fe066621SYueHaibing static inline void acpi_dev_put(struct acpi_device *adev)
739fe066621SYueHaibing {
740fc68f42aSLinus Torvalds 	if (adev)
741fe066621SYueHaibing 		put_device(&adev->dev);
742fe066621SYueHaibing }
7432d079514SRafael J. Wysocki 
7442d079514SRafael J. Wysocki struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle);
7452d079514SRafael J. Wysocki 
7462d079514SRafael J. Wysocki static inline void acpi_bus_put_acpi_device(struct acpi_device *adev)
7472d079514SRafael J. Wysocki {
7482d079514SRafael J. Wysocki 	acpi_dev_put(adev);
7492d079514SRafael J. Wysocki }
75066886d6fSMatthew Garrett #else	/* CONFIG_ACPI */
75166886d6fSMatthew Garrett 
7527ae30986SLen Brown static inline int register_acpi_bus_type(void *bus) { return 0; }
7537ae30986SLen Brown static inline int unregister_acpi_bus_type(void *bus) { return 0; }
75466886d6fSMatthew Garrett 
75576f58584SLen Brown #endif				/* CONFIG_ACPI */
7561da177e4SLinus Torvalds 
7571da177e4SLinus Torvalds #endif /*__ACPI_BUS_H__*/
758