xref: /OK3568_Linux_fs/kernel/drivers/acpi/power.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * drivers/acpi/power.c - ACPI Power Resources management.
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (C) 2001 - 2015 Intel Corp.
6*4882a593Smuzhiyun  * Author: Andy Grover <andrew.grover@intel.com>
7*4882a593Smuzhiyun  * Author: Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
8*4882a593Smuzhiyun  * Author: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
9*4882a593Smuzhiyun  */
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun /*
12*4882a593Smuzhiyun  * ACPI power-managed devices may be controlled in two ways:
13*4882a593Smuzhiyun  * 1. via "Device Specific (D-State) Control"
14*4882a593Smuzhiyun  * 2. via "Power Resource Control".
15*4882a593Smuzhiyun  * The code below deals with ACPI Power Resources control.
16*4882a593Smuzhiyun  *
17*4882a593Smuzhiyun  * An ACPI "power resource object" represents a software controllable power
18*4882a593Smuzhiyun  * plane, clock plane, or other resource depended on by a device.
19*4882a593Smuzhiyun  *
20*4882a593Smuzhiyun  * A device may rely on multiple power resources, and a power resource
21*4882a593Smuzhiyun  * may be shared by multiple devices.
22*4882a593Smuzhiyun  */
23*4882a593Smuzhiyun 
24*4882a593Smuzhiyun #include <linux/kernel.h>
25*4882a593Smuzhiyun #include <linux/module.h>
26*4882a593Smuzhiyun #include <linux/init.h>
27*4882a593Smuzhiyun #include <linux/types.h>
28*4882a593Smuzhiyun #include <linux/slab.h>
29*4882a593Smuzhiyun #include <linux/pm_runtime.h>
30*4882a593Smuzhiyun #include <linux/sysfs.h>
31*4882a593Smuzhiyun #include <linux/acpi.h>
32*4882a593Smuzhiyun #include "sleep.h"
33*4882a593Smuzhiyun #include "internal.h"
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun #define _COMPONENT			ACPI_POWER_COMPONENT
36*4882a593Smuzhiyun ACPI_MODULE_NAME("power");
37*4882a593Smuzhiyun #define ACPI_POWER_CLASS		"power_resource"
38*4882a593Smuzhiyun #define ACPI_POWER_DEVICE_NAME		"Power Resource"
39*4882a593Smuzhiyun #define ACPI_POWER_RESOURCE_STATE_OFF	0x00
40*4882a593Smuzhiyun #define ACPI_POWER_RESOURCE_STATE_ON	0x01
41*4882a593Smuzhiyun #define ACPI_POWER_RESOURCE_STATE_UNKNOWN 0xFF
42*4882a593Smuzhiyun 
43*4882a593Smuzhiyun struct acpi_power_dependent_device {
44*4882a593Smuzhiyun 	struct device *dev;
45*4882a593Smuzhiyun 	struct list_head node;
46*4882a593Smuzhiyun };
47*4882a593Smuzhiyun 
48*4882a593Smuzhiyun struct acpi_power_resource {
49*4882a593Smuzhiyun 	struct acpi_device device;
50*4882a593Smuzhiyun 	struct list_head list_node;
51*4882a593Smuzhiyun 	char *name;
52*4882a593Smuzhiyun 	u32 system_level;
53*4882a593Smuzhiyun 	u32 order;
54*4882a593Smuzhiyun 	unsigned int ref_count;
55*4882a593Smuzhiyun 	bool wakeup_enabled;
56*4882a593Smuzhiyun 	struct mutex resource_lock;
57*4882a593Smuzhiyun 	struct list_head dependents;
58*4882a593Smuzhiyun };
59*4882a593Smuzhiyun 
60*4882a593Smuzhiyun struct acpi_power_resource_entry {
61*4882a593Smuzhiyun 	struct list_head node;
62*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
63*4882a593Smuzhiyun };
64*4882a593Smuzhiyun 
65*4882a593Smuzhiyun static LIST_HEAD(acpi_power_resource_list);
66*4882a593Smuzhiyun static DEFINE_MUTEX(power_resource_list_lock);
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun /* --------------------------------------------------------------------------
69*4882a593Smuzhiyun                              Power Resource Management
70*4882a593Smuzhiyun    -------------------------------------------------------------------------- */
71*4882a593Smuzhiyun 
72*4882a593Smuzhiyun static inline
to_power_resource(struct acpi_device * device)73*4882a593Smuzhiyun struct acpi_power_resource *to_power_resource(struct acpi_device *device)
74*4882a593Smuzhiyun {
75*4882a593Smuzhiyun 	return container_of(device, struct acpi_power_resource, device);
76*4882a593Smuzhiyun }
77*4882a593Smuzhiyun 
acpi_power_get_context(acpi_handle handle)78*4882a593Smuzhiyun static struct acpi_power_resource *acpi_power_get_context(acpi_handle handle)
79*4882a593Smuzhiyun {
80*4882a593Smuzhiyun 	struct acpi_device *device;
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun 	if (acpi_bus_get_device(handle, &device))
83*4882a593Smuzhiyun 		return NULL;
84*4882a593Smuzhiyun 
85*4882a593Smuzhiyun 	return to_power_resource(device);
86*4882a593Smuzhiyun }
87*4882a593Smuzhiyun 
acpi_power_resources_list_add(acpi_handle handle,struct list_head * list)88*4882a593Smuzhiyun static int acpi_power_resources_list_add(acpi_handle handle,
89*4882a593Smuzhiyun 					 struct list_head *list)
90*4882a593Smuzhiyun {
91*4882a593Smuzhiyun 	struct acpi_power_resource *resource = acpi_power_get_context(handle);
92*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
93*4882a593Smuzhiyun 
94*4882a593Smuzhiyun 	if (!resource || !list)
95*4882a593Smuzhiyun 		return -EINVAL;
96*4882a593Smuzhiyun 
97*4882a593Smuzhiyun 	entry = kzalloc(sizeof(*entry), GFP_KERNEL);
98*4882a593Smuzhiyun 	if (!entry)
99*4882a593Smuzhiyun 		return -ENOMEM;
100*4882a593Smuzhiyun 
101*4882a593Smuzhiyun 	entry->resource = resource;
102*4882a593Smuzhiyun 	if (!list_empty(list)) {
103*4882a593Smuzhiyun 		struct acpi_power_resource_entry *e;
104*4882a593Smuzhiyun 
105*4882a593Smuzhiyun 		list_for_each_entry(e, list, node)
106*4882a593Smuzhiyun 			if (e->resource->order > resource->order) {
107*4882a593Smuzhiyun 				list_add_tail(&entry->node, &e->node);
108*4882a593Smuzhiyun 				return 0;
109*4882a593Smuzhiyun 			}
110*4882a593Smuzhiyun 	}
111*4882a593Smuzhiyun 	list_add_tail(&entry->node, list);
112*4882a593Smuzhiyun 	return 0;
113*4882a593Smuzhiyun }
114*4882a593Smuzhiyun 
acpi_power_resources_list_free(struct list_head * list)115*4882a593Smuzhiyun void acpi_power_resources_list_free(struct list_head *list)
116*4882a593Smuzhiyun {
117*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry, *e;
118*4882a593Smuzhiyun 
119*4882a593Smuzhiyun 	list_for_each_entry_safe(entry, e, list, node) {
120*4882a593Smuzhiyun 		list_del(&entry->node);
121*4882a593Smuzhiyun 		kfree(entry);
122*4882a593Smuzhiyun 	}
123*4882a593Smuzhiyun }
124*4882a593Smuzhiyun 
acpi_power_resource_is_dup(union acpi_object * package,unsigned int start,unsigned int i)125*4882a593Smuzhiyun static bool acpi_power_resource_is_dup(union acpi_object *package,
126*4882a593Smuzhiyun 				       unsigned int start, unsigned int i)
127*4882a593Smuzhiyun {
128*4882a593Smuzhiyun 	acpi_handle rhandle, dup;
129*4882a593Smuzhiyun 	unsigned int j;
130*4882a593Smuzhiyun 
131*4882a593Smuzhiyun 	/* The caller is expected to check the package element types */
132*4882a593Smuzhiyun 	rhandle = package->package.elements[i].reference.handle;
133*4882a593Smuzhiyun 	for (j = start; j < i; j++) {
134*4882a593Smuzhiyun 		dup = package->package.elements[j].reference.handle;
135*4882a593Smuzhiyun 		if (dup == rhandle)
136*4882a593Smuzhiyun 			return true;
137*4882a593Smuzhiyun 	}
138*4882a593Smuzhiyun 
139*4882a593Smuzhiyun 	return false;
140*4882a593Smuzhiyun }
141*4882a593Smuzhiyun 
acpi_extract_power_resources(union acpi_object * package,unsigned int start,struct list_head * list)142*4882a593Smuzhiyun int acpi_extract_power_resources(union acpi_object *package, unsigned int start,
143*4882a593Smuzhiyun 				 struct list_head *list)
144*4882a593Smuzhiyun {
145*4882a593Smuzhiyun 	unsigned int i;
146*4882a593Smuzhiyun 	int err = 0;
147*4882a593Smuzhiyun 
148*4882a593Smuzhiyun 	for (i = start; i < package->package.count; i++) {
149*4882a593Smuzhiyun 		union acpi_object *element = &package->package.elements[i];
150*4882a593Smuzhiyun 		acpi_handle rhandle;
151*4882a593Smuzhiyun 
152*4882a593Smuzhiyun 		if (element->type != ACPI_TYPE_LOCAL_REFERENCE) {
153*4882a593Smuzhiyun 			err = -ENODATA;
154*4882a593Smuzhiyun 			break;
155*4882a593Smuzhiyun 		}
156*4882a593Smuzhiyun 		rhandle = element->reference.handle;
157*4882a593Smuzhiyun 		if (!rhandle) {
158*4882a593Smuzhiyun 			err = -ENODEV;
159*4882a593Smuzhiyun 			break;
160*4882a593Smuzhiyun 		}
161*4882a593Smuzhiyun 
162*4882a593Smuzhiyun 		/* Some ACPI tables contain duplicate power resource references */
163*4882a593Smuzhiyun 		if (acpi_power_resource_is_dup(package, start, i))
164*4882a593Smuzhiyun 			continue;
165*4882a593Smuzhiyun 
166*4882a593Smuzhiyun 		err = acpi_add_power_resource(rhandle);
167*4882a593Smuzhiyun 		if (err)
168*4882a593Smuzhiyun 			break;
169*4882a593Smuzhiyun 
170*4882a593Smuzhiyun 		err = acpi_power_resources_list_add(rhandle, list);
171*4882a593Smuzhiyun 		if (err)
172*4882a593Smuzhiyun 			break;
173*4882a593Smuzhiyun 	}
174*4882a593Smuzhiyun 	if (err)
175*4882a593Smuzhiyun 		acpi_power_resources_list_free(list);
176*4882a593Smuzhiyun 
177*4882a593Smuzhiyun 	return err;
178*4882a593Smuzhiyun }
179*4882a593Smuzhiyun 
acpi_power_get_state(acpi_handle handle,int * state)180*4882a593Smuzhiyun static int acpi_power_get_state(acpi_handle handle, int *state)
181*4882a593Smuzhiyun {
182*4882a593Smuzhiyun 	acpi_status status = AE_OK;
183*4882a593Smuzhiyun 	unsigned long long sta = 0;
184*4882a593Smuzhiyun 	char node_name[5];
185*4882a593Smuzhiyun 	struct acpi_buffer buffer = { sizeof(node_name), node_name };
186*4882a593Smuzhiyun 
187*4882a593Smuzhiyun 
188*4882a593Smuzhiyun 	if (!handle || !state)
189*4882a593Smuzhiyun 		return -EINVAL;
190*4882a593Smuzhiyun 
191*4882a593Smuzhiyun 	status = acpi_evaluate_integer(handle, "_STA", NULL, &sta);
192*4882a593Smuzhiyun 	if (ACPI_FAILURE(status))
193*4882a593Smuzhiyun 		return -ENODEV;
194*4882a593Smuzhiyun 
195*4882a593Smuzhiyun 	*state = (sta & 0x01)?ACPI_POWER_RESOURCE_STATE_ON:
196*4882a593Smuzhiyun 			      ACPI_POWER_RESOURCE_STATE_OFF;
197*4882a593Smuzhiyun 
198*4882a593Smuzhiyun 	acpi_get_name(handle, ACPI_SINGLE_NAME, &buffer);
199*4882a593Smuzhiyun 
200*4882a593Smuzhiyun 	ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Resource [%s] is %s\n",
201*4882a593Smuzhiyun 			  node_name,
202*4882a593Smuzhiyun 				*state ? "on" : "off"));
203*4882a593Smuzhiyun 
204*4882a593Smuzhiyun 	return 0;
205*4882a593Smuzhiyun }
206*4882a593Smuzhiyun 
acpi_power_get_list_state(struct list_head * list,int * state)207*4882a593Smuzhiyun static int acpi_power_get_list_state(struct list_head *list, int *state)
208*4882a593Smuzhiyun {
209*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
210*4882a593Smuzhiyun 	int cur_state;
211*4882a593Smuzhiyun 
212*4882a593Smuzhiyun 	if (!list || !state)
213*4882a593Smuzhiyun 		return -EINVAL;
214*4882a593Smuzhiyun 
215*4882a593Smuzhiyun 	/* The state of the list is 'on' IFF all resources are 'on'. */
216*4882a593Smuzhiyun 	cur_state = 0;
217*4882a593Smuzhiyun 	list_for_each_entry(entry, list, node) {
218*4882a593Smuzhiyun 		struct acpi_power_resource *resource = entry->resource;
219*4882a593Smuzhiyun 		acpi_handle handle = resource->device.handle;
220*4882a593Smuzhiyun 		int result;
221*4882a593Smuzhiyun 
222*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
223*4882a593Smuzhiyun 		result = acpi_power_get_state(handle, &cur_state);
224*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
225*4882a593Smuzhiyun 		if (result)
226*4882a593Smuzhiyun 			return result;
227*4882a593Smuzhiyun 
228*4882a593Smuzhiyun 		if (cur_state != ACPI_POWER_RESOURCE_STATE_ON)
229*4882a593Smuzhiyun 			break;
230*4882a593Smuzhiyun 	}
231*4882a593Smuzhiyun 
232*4882a593Smuzhiyun 	ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Resource list is %s\n",
233*4882a593Smuzhiyun 			  cur_state ? "on" : "off"));
234*4882a593Smuzhiyun 
235*4882a593Smuzhiyun 	*state = cur_state;
236*4882a593Smuzhiyun 	return 0;
237*4882a593Smuzhiyun }
238*4882a593Smuzhiyun 
239*4882a593Smuzhiyun static int
acpi_power_resource_add_dependent(struct acpi_power_resource * resource,struct device * dev)240*4882a593Smuzhiyun acpi_power_resource_add_dependent(struct acpi_power_resource *resource,
241*4882a593Smuzhiyun 				  struct device *dev)
242*4882a593Smuzhiyun {
243*4882a593Smuzhiyun 	struct acpi_power_dependent_device *dep;
244*4882a593Smuzhiyun 	int ret = 0;
245*4882a593Smuzhiyun 
246*4882a593Smuzhiyun 	mutex_lock(&resource->resource_lock);
247*4882a593Smuzhiyun 	list_for_each_entry(dep, &resource->dependents, node) {
248*4882a593Smuzhiyun 		/* Only add it once */
249*4882a593Smuzhiyun 		if (dep->dev == dev)
250*4882a593Smuzhiyun 			goto unlock;
251*4882a593Smuzhiyun 	}
252*4882a593Smuzhiyun 
253*4882a593Smuzhiyun 	dep = kzalloc(sizeof(*dep), GFP_KERNEL);
254*4882a593Smuzhiyun 	if (!dep) {
255*4882a593Smuzhiyun 		ret = -ENOMEM;
256*4882a593Smuzhiyun 		goto unlock;
257*4882a593Smuzhiyun 	}
258*4882a593Smuzhiyun 
259*4882a593Smuzhiyun 	dep->dev = dev;
260*4882a593Smuzhiyun 	list_add_tail(&dep->node, &resource->dependents);
261*4882a593Smuzhiyun 	dev_dbg(dev, "added power dependency to [%s]\n", resource->name);
262*4882a593Smuzhiyun 
263*4882a593Smuzhiyun unlock:
264*4882a593Smuzhiyun 	mutex_unlock(&resource->resource_lock);
265*4882a593Smuzhiyun 	return ret;
266*4882a593Smuzhiyun }
267*4882a593Smuzhiyun 
268*4882a593Smuzhiyun static void
acpi_power_resource_remove_dependent(struct acpi_power_resource * resource,struct device * dev)269*4882a593Smuzhiyun acpi_power_resource_remove_dependent(struct acpi_power_resource *resource,
270*4882a593Smuzhiyun 				     struct device *dev)
271*4882a593Smuzhiyun {
272*4882a593Smuzhiyun 	struct acpi_power_dependent_device *dep;
273*4882a593Smuzhiyun 
274*4882a593Smuzhiyun 	mutex_lock(&resource->resource_lock);
275*4882a593Smuzhiyun 	list_for_each_entry(dep, &resource->dependents, node) {
276*4882a593Smuzhiyun 		if (dep->dev == dev) {
277*4882a593Smuzhiyun 			list_del(&dep->node);
278*4882a593Smuzhiyun 			kfree(dep);
279*4882a593Smuzhiyun 			dev_dbg(dev, "removed power dependency to [%s]\n",
280*4882a593Smuzhiyun 				resource->name);
281*4882a593Smuzhiyun 			break;
282*4882a593Smuzhiyun 		}
283*4882a593Smuzhiyun 	}
284*4882a593Smuzhiyun 	mutex_unlock(&resource->resource_lock);
285*4882a593Smuzhiyun }
286*4882a593Smuzhiyun 
287*4882a593Smuzhiyun /**
288*4882a593Smuzhiyun  * acpi_device_power_add_dependent - Add dependent device of this ACPI device
289*4882a593Smuzhiyun  * @adev: ACPI device pointer
290*4882a593Smuzhiyun  * @dev: Dependent device
291*4882a593Smuzhiyun  *
292*4882a593Smuzhiyun  * If @adev has non-empty _PR0 the @dev is added as dependent device to all
293*4882a593Smuzhiyun  * power resources returned by it. This means that whenever these power
294*4882a593Smuzhiyun  * resources are turned _ON the dependent devices get runtime resumed. This
295*4882a593Smuzhiyun  * is needed for devices such as PCI to allow its driver to re-initialize
296*4882a593Smuzhiyun  * it after it went to D0uninitialized.
297*4882a593Smuzhiyun  *
298*4882a593Smuzhiyun  * If @adev does not have _PR0 this does nothing.
299*4882a593Smuzhiyun  *
300*4882a593Smuzhiyun  * Returns %0 in case of success and negative errno otherwise.
301*4882a593Smuzhiyun  */
acpi_device_power_add_dependent(struct acpi_device * adev,struct device * dev)302*4882a593Smuzhiyun int acpi_device_power_add_dependent(struct acpi_device *adev,
303*4882a593Smuzhiyun 				    struct device *dev)
304*4882a593Smuzhiyun {
305*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
306*4882a593Smuzhiyun 	struct list_head *resources;
307*4882a593Smuzhiyun 	int ret;
308*4882a593Smuzhiyun 
309*4882a593Smuzhiyun 	if (!adev->flags.power_manageable)
310*4882a593Smuzhiyun 		return 0;
311*4882a593Smuzhiyun 
312*4882a593Smuzhiyun 	resources = &adev->power.states[ACPI_STATE_D0].resources;
313*4882a593Smuzhiyun 	list_for_each_entry(entry, resources, node) {
314*4882a593Smuzhiyun 		ret = acpi_power_resource_add_dependent(entry->resource, dev);
315*4882a593Smuzhiyun 		if (ret)
316*4882a593Smuzhiyun 			goto err;
317*4882a593Smuzhiyun 	}
318*4882a593Smuzhiyun 
319*4882a593Smuzhiyun 	return 0;
320*4882a593Smuzhiyun 
321*4882a593Smuzhiyun err:
322*4882a593Smuzhiyun 	list_for_each_entry(entry, resources, node)
323*4882a593Smuzhiyun 		acpi_power_resource_remove_dependent(entry->resource, dev);
324*4882a593Smuzhiyun 
325*4882a593Smuzhiyun 	return ret;
326*4882a593Smuzhiyun }
327*4882a593Smuzhiyun 
328*4882a593Smuzhiyun /**
329*4882a593Smuzhiyun  * acpi_device_power_remove_dependent - Remove dependent device
330*4882a593Smuzhiyun  * @adev: ACPI device pointer
331*4882a593Smuzhiyun  * @dev: Dependent device
332*4882a593Smuzhiyun  *
333*4882a593Smuzhiyun  * Does the opposite of acpi_device_power_add_dependent() and removes the
334*4882a593Smuzhiyun  * dependent device if it is found. Can be called to @adev that does not
335*4882a593Smuzhiyun  * have _PR0 as well.
336*4882a593Smuzhiyun  */
acpi_device_power_remove_dependent(struct acpi_device * adev,struct device * dev)337*4882a593Smuzhiyun void acpi_device_power_remove_dependent(struct acpi_device *adev,
338*4882a593Smuzhiyun 					struct device *dev)
339*4882a593Smuzhiyun {
340*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
341*4882a593Smuzhiyun 	struct list_head *resources;
342*4882a593Smuzhiyun 
343*4882a593Smuzhiyun 	if (!adev->flags.power_manageable)
344*4882a593Smuzhiyun 		return;
345*4882a593Smuzhiyun 
346*4882a593Smuzhiyun 	resources = &adev->power.states[ACPI_STATE_D0].resources;
347*4882a593Smuzhiyun 	list_for_each_entry_reverse(entry, resources, node)
348*4882a593Smuzhiyun 		acpi_power_resource_remove_dependent(entry->resource, dev);
349*4882a593Smuzhiyun }
350*4882a593Smuzhiyun 
__acpi_power_on(struct acpi_power_resource * resource)351*4882a593Smuzhiyun static int __acpi_power_on(struct acpi_power_resource *resource)
352*4882a593Smuzhiyun {
353*4882a593Smuzhiyun 	struct acpi_power_dependent_device *dep;
354*4882a593Smuzhiyun 	acpi_status status = AE_OK;
355*4882a593Smuzhiyun 
356*4882a593Smuzhiyun 	status = acpi_evaluate_object(resource->device.handle, "_ON", NULL, NULL);
357*4882a593Smuzhiyun 	if (ACPI_FAILURE(status))
358*4882a593Smuzhiyun 		return -ENODEV;
359*4882a593Smuzhiyun 
360*4882a593Smuzhiyun 	ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Power resource [%s] turned on\n",
361*4882a593Smuzhiyun 			  resource->name));
362*4882a593Smuzhiyun 
363*4882a593Smuzhiyun 	/*
364*4882a593Smuzhiyun 	 * If there are other dependents on this power resource we need to
365*4882a593Smuzhiyun 	 * resume them now so that their drivers can re-initialize the
366*4882a593Smuzhiyun 	 * hardware properly after it went back to D0.
367*4882a593Smuzhiyun 	 */
368*4882a593Smuzhiyun 	if (list_empty(&resource->dependents) ||
369*4882a593Smuzhiyun 	    list_is_singular(&resource->dependents))
370*4882a593Smuzhiyun 		return 0;
371*4882a593Smuzhiyun 
372*4882a593Smuzhiyun 	list_for_each_entry(dep, &resource->dependents, node) {
373*4882a593Smuzhiyun 		dev_dbg(dep->dev, "runtime resuming because [%s] turned on\n",
374*4882a593Smuzhiyun 			resource->name);
375*4882a593Smuzhiyun 		pm_request_resume(dep->dev);
376*4882a593Smuzhiyun 	}
377*4882a593Smuzhiyun 
378*4882a593Smuzhiyun 	return 0;
379*4882a593Smuzhiyun }
380*4882a593Smuzhiyun 
acpi_power_on_unlocked(struct acpi_power_resource * resource)381*4882a593Smuzhiyun static int acpi_power_on_unlocked(struct acpi_power_resource *resource)
382*4882a593Smuzhiyun {
383*4882a593Smuzhiyun 	int result = 0;
384*4882a593Smuzhiyun 
385*4882a593Smuzhiyun 	if (resource->ref_count++) {
386*4882a593Smuzhiyun 		ACPI_DEBUG_PRINT((ACPI_DB_INFO,
387*4882a593Smuzhiyun 				  "Power resource [%s] already on\n",
388*4882a593Smuzhiyun 				  resource->name));
389*4882a593Smuzhiyun 	} else {
390*4882a593Smuzhiyun 		result = __acpi_power_on(resource);
391*4882a593Smuzhiyun 		if (result)
392*4882a593Smuzhiyun 			resource->ref_count--;
393*4882a593Smuzhiyun 	}
394*4882a593Smuzhiyun 	return result;
395*4882a593Smuzhiyun }
396*4882a593Smuzhiyun 
acpi_power_on(struct acpi_power_resource * resource)397*4882a593Smuzhiyun static int acpi_power_on(struct acpi_power_resource *resource)
398*4882a593Smuzhiyun {
399*4882a593Smuzhiyun 	int result;
400*4882a593Smuzhiyun 
401*4882a593Smuzhiyun 	mutex_lock(&resource->resource_lock);
402*4882a593Smuzhiyun 	result = acpi_power_on_unlocked(resource);
403*4882a593Smuzhiyun 	mutex_unlock(&resource->resource_lock);
404*4882a593Smuzhiyun 	return result;
405*4882a593Smuzhiyun }
406*4882a593Smuzhiyun 
__acpi_power_off(struct acpi_power_resource * resource)407*4882a593Smuzhiyun static int __acpi_power_off(struct acpi_power_resource *resource)
408*4882a593Smuzhiyun {
409*4882a593Smuzhiyun 	acpi_status status;
410*4882a593Smuzhiyun 
411*4882a593Smuzhiyun 	status = acpi_evaluate_object(resource->device.handle, "_OFF",
412*4882a593Smuzhiyun 				      NULL, NULL);
413*4882a593Smuzhiyun 	if (ACPI_FAILURE(status))
414*4882a593Smuzhiyun 		return -ENODEV;
415*4882a593Smuzhiyun 
416*4882a593Smuzhiyun 	ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Power resource [%s] turned off\n",
417*4882a593Smuzhiyun 			  resource->name));
418*4882a593Smuzhiyun 	return 0;
419*4882a593Smuzhiyun }
420*4882a593Smuzhiyun 
acpi_power_off_unlocked(struct acpi_power_resource * resource)421*4882a593Smuzhiyun static int acpi_power_off_unlocked(struct acpi_power_resource *resource)
422*4882a593Smuzhiyun {
423*4882a593Smuzhiyun 	int result = 0;
424*4882a593Smuzhiyun 
425*4882a593Smuzhiyun 	if (!resource->ref_count) {
426*4882a593Smuzhiyun 		ACPI_DEBUG_PRINT((ACPI_DB_INFO,
427*4882a593Smuzhiyun 				  "Power resource [%s] already off\n",
428*4882a593Smuzhiyun 				  resource->name));
429*4882a593Smuzhiyun 		return 0;
430*4882a593Smuzhiyun 	}
431*4882a593Smuzhiyun 
432*4882a593Smuzhiyun 	if (--resource->ref_count) {
433*4882a593Smuzhiyun 		ACPI_DEBUG_PRINT((ACPI_DB_INFO,
434*4882a593Smuzhiyun 				  "Power resource [%s] still in use\n",
435*4882a593Smuzhiyun 				  resource->name));
436*4882a593Smuzhiyun 	} else {
437*4882a593Smuzhiyun 		result = __acpi_power_off(resource);
438*4882a593Smuzhiyun 		if (result)
439*4882a593Smuzhiyun 			resource->ref_count++;
440*4882a593Smuzhiyun 	}
441*4882a593Smuzhiyun 	return result;
442*4882a593Smuzhiyun }
443*4882a593Smuzhiyun 
acpi_power_off(struct acpi_power_resource * resource)444*4882a593Smuzhiyun static int acpi_power_off(struct acpi_power_resource *resource)
445*4882a593Smuzhiyun {
446*4882a593Smuzhiyun 	int result;
447*4882a593Smuzhiyun 
448*4882a593Smuzhiyun 	mutex_lock(&resource->resource_lock);
449*4882a593Smuzhiyun 	result = acpi_power_off_unlocked(resource);
450*4882a593Smuzhiyun 	mutex_unlock(&resource->resource_lock);
451*4882a593Smuzhiyun 	return result;
452*4882a593Smuzhiyun }
453*4882a593Smuzhiyun 
acpi_power_off_list(struct list_head * list)454*4882a593Smuzhiyun static int acpi_power_off_list(struct list_head *list)
455*4882a593Smuzhiyun {
456*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
457*4882a593Smuzhiyun 	int result = 0;
458*4882a593Smuzhiyun 
459*4882a593Smuzhiyun 	list_for_each_entry_reverse(entry, list, node) {
460*4882a593Smuzhiyun 		result = acpi_power_off(entry->resource);
461*4882a593Smuzhiyun 		if (result)
462*4882a593Smuzhiyun 			goto err;
463*4882a593Smuzhiyun 	}
464*4882a593Smuzhiyun 	return 0;
465*4882a593Smuzhiyun 
466*4882a593Smuzhiyun  err:
467*4882a593Smuzhiyun 	list_for_each_entry_continue(entry, list, node)
468*4882a593Smuzhiyun 		acpi_power_on(entry->resource);
469*4882a593Smuzhiyun 
470*4882a593Smuzhiyun 	return result;
471*4882a593Smuzhiyun }
472*4882a593Smuzhiyun 
acpi_power_on_list(struct list_head * list)473*4882a593Smuzhiyun static int acpi_power_on_list(struct list_head *list)
474*4882a593Smuzhiyun {
475*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
476*4882a593Smuzhiyun 	int result = 0;
477*4882a593Smuzhiyun 
478*4882a593Smuzhiyun 	list_for_each_entry(entry, list, node) {
479*4882a593Smuzhiyun 		result = acpi_power_on(entry->resource);
480*4882a593Smuzhiyun 		if (result)
481*4882a593Smuzhiyun 			goto err;
482*4882a593Smuzhiyun 	}
483*4882a593Smuzhiyun 	return 0;
484*4882a593Smuzhiyun 
485*4882a593Smuzhiyun  err:
486*4882a593Smuzhiyun 	list_for_each_entry_continue_reverse(entry, list, node)
487*4882a593Smuzhiyun 		acpi_power_off(entry->resource);
488*4882a593Smuzhiyun 
489*4882a593Smuzhiyun 	return result;
490*4882a593Smuzhiyun }
491*4882a593Smuzhiyun 
492*4882a593Smuzhiyun static struct attribute *attrs[] = {
493*4882a593Smuzhiyun 	NULL,
494*4882a593Smuzhiyun };
495*4882a593Smuzhiyun 
496*4882a593Smuzhiyun static const struct attribute_group attr_groups[] = {
497*4882a593Smuzhiyun 	[ACPI_STATE_D0] = {
498*4882a593Smuzhiyun 		.name = "power_resources_D0",
499*4882a593Smuzhiyun 		.attrs = attrs,
500*4882a593Smuzhiyun 	},
501*4882a593Smuzhiyun 	[ACPI_STATE_D1] = {
502*4882a593Smuzhiyun 		.name = "power_resources_D1",
503*4882a593Smuzhiyun 		.attrs = attrs,
504*4882a593Smuzhiyun 	},
505*4882a593Smuzhiyun 	[ACPI_STATE_D2] = {
506*4882a593Smuzhiyun 		.name = "power_resources_D2",
507*4882a593Smuzhiyun 		.attrs = attrs,
508*4882a593Smuzhiyun 	},
509*4882a593Smuzhiyun 	[ACPI_STATE_D3_HOT] = {
510*4882a593Smuzhiyun 		.name = "power_resources_D3hot",
511*4882a593Smuzhiyun 		.attrs = attrs,
512*4882a593Smuzhiyun 	},
513*4882a593Smuzhiyun };
514*4882a593Smuzhiyun 
515*4882a593Smuzhiyun static const struct attribute_group wakeup_attr_group = {
516*4882a593Smuzhiyun 	.name = "power_resources_wakeup",
517*4882a593Smuzhiyun 	.attrs = attrs,
518*4882a593Smuzhiyun };
519*4882a593Smuzhiyun 
acpi_power_hide_list(struct acpi_device * adev,struct list_head * resources,const struct attribute_group * attr_group)520*4882a593Smuzhiyun static void acpi_power_hide_list(struct acpi_device *adev,
521*4882a593Smuzhiyun 				 struct list_head *resources,
522*4882a593Smuzhiyun 				 const struct attribute_group *attr_group)
523*4882a593Smuzhiyun {
524*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
525*4882a593Smuzhiyun 
526*4882a593Smuzhiyun 	if (list_empty(resources))
527*4882a593Smuzhiyun 		return;
528*4882a593Smuzhiyun 
529*4882a593Smuzhiyun 	list_for_each_entry_reverse(entry, resources, node) {
530*4882a593Smuzhiyun 		struct acpi_device *res_dev = &entry->resource->device;
531*4882a593Smuzhiyun 
532*4882a593Smuzhiyun 		sysfs_remove_link_from_group(&adev->dev.kobj,
533*4882a593Smuzhiyun 					     attr_group->name,
534*4882a593Smuzhiyun 					     dev_name(&res_dev->dev));
535*4882a593Smuzhiyun 	}
536*4882a593Smuzhiyun 	sysfs_remove_group(&adev->dev.kobj, attr_group);
537*4882a593Smuzhiyun }
538*4882a593Smuzhiyun 
acpi_power_expose_list(struct acpi_device * adev,struct list_head * resources,const struct attribute_group * attr_group)539*4882a593Smuzhiyun static void acpi_power_expose_list(struct acpi_device *adev,
540*4882a593Smuzhiyun 				   struct list_head *resources,
541*4882a593Smuzhiyun 				   const struct attribute_group *attr_group)
542*4882a593Smuzhiyun {
543*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
544*4882a593Smuzhiyun 	int ret;
545*4882a593Smuzhiyun 
546*4882a593Smuzhiyun 	if (list_empty(resources))
547*4882a593Smuzhiyun 		return;
548*4882a593Smuzhiyun 
549*4882a593Smuzhiyun 	ret = sysfs_create_group(&adev->dev.kobj, attr_group);
550*4882a593Smuzhiyun 	if (ret)
551*4882a593Smuzhiyun 		return;
552*4882a593Smuzhiyun 
553*4882a593Smuzhiyun 	list_for_each_entry(entry, resources, node) {
554*4882a593Smuzhiyun 		struct acpi_device *res_dev = &entry->resource->device;
555*4882a593Smuzhiyun 
556*4882a593Smuzhiyun 		ret = sysfs_add_link_to_group(&adev->dev.kobj,
557*4882a593Smuzhiyun 					      attr_group->name,
558*4882a593Smuzhiyun 					      &res_dev->dev.kobj,
559*4882a593Smuzhiyun 					      dev_name(&res_dev->dev));
560*4882a593Smuzhiyun 		if (ret) {
561*4882a593Smuzhiyun 			acpi_power_hide_list(adev, resources, attr_group);
562*4882a593Smuzhiyun 			break;
563*4882a593Smuzhiyun 		}
564*4882a593Smuzhiyun 	}
565*4882a593Smuzhiyun }
566*4882a593Smuzhiyun 
acpi_power_expose_hide(struct acpi_device * adev,struct list_head * resources,const struct attribute_group * attr_group,bool expose)567*4882a593Smuzhiyun static void acpi_power_expose_hide(struct acpi_device *adev,
568*4882a593Smuzhiyun 				   struct list_head *resources,
569*4882a593Smuzhiyun 				   const struct attribute_group *attr_group,
570*4882a593Smuzhiyun 				   bool expose)
571*4882a593Smuzhiyun {
572*4882a593Smuzhiyun 	if (expose)
573*4882a593Smuzhiyun 		acpi_power_expose_list(adev, resources, attr_group);
574*4882a593Smuzhiyun 	else
575*4882a593Smuzhiyun 		acpi_power_hide_list(adev, resources, attr_group);
576*4882a593Smuzhiyun }
577*4882a593Smuzhiyun 
acpi_power_add_remove_device(struct acpi_device * adev,bool add)578*4882a593Smuzhiyun void acpi_power_add_remove_device(struct acpi_device *adev, bool add)
579*4882a593Smuzhiyun {
580*4882a593Smuzhiyun 	int state;
581*4882a593Smuzhiyun 
582*4882a593Smuzhiyun 	if (adev->wakeup.flags.valid)
583*4882a593Smuzhiyun 		acpi_power_expose_hide(adev, &adev->wakeup.resources,
584*4882a593Smuzhiyun 				       &wakeup_attr_group, add);
585*4882a593Smuzhiyun 
586*4882a593Smuzhiyun 	if (!adev->power.flags.power_resources)
587*4882a593Smuzhiyun 		return;
588*4882a593Smuzhiyun 
589*4882a593Smuzhiyun 	for (state = ACPI_STATE_D0; state <= ACPI_STATE_D3_HOT; state++)
590*4882a593Smuzhiyun 		acpi_power_expose_hide(adev,
591*4882a593Smuzhiyun 				       &adev->power.states[state].resources,
592*4882a593Smuzhiyun 				       &attr_groups[state], add);
593*4882a593Smuzhiyun }
594*4882a593Smuzhiyun 
acpi_power_wakeup_list_init(struct list_head * list,int * system_level_p)595*4882a593Smuzhiyun int acpi_power_wakeup_list_init(struct list_head *list, int *system_level_p)
596*4882a593Smuzhiyun {
597*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
598*4882a593Smuzhiyun 	int system_level = 5;
599*4882a593Smuzhiyun 
600*4882a593Smuzhiyun 	list_for_each_entry(entry, list, node) {
601*4882a593Smuzhiyun 		struct acpi_power_resource *resource = entry->resource;
602*4882a593Smuzhiyun 		acpi_handle handle = resource->device.handle;
603*4882a593Smuzhiyun 		int result;
604*4882a593Smuzhiyun 		int state;
605*4882a593Smuzhiyun 
606*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
607*4882a593Smuzhiyun 
608*4882a593Smuzhiyun 		result = acpi_power_get_state(handle, &state);
609*4882a593Smuzhiyun 		if (result) {
610*4882a593Smuzhiyun 			mutex_unlock(&resource->resource_lock);
611*4882a593Smuzhiyun 			return result;
612*4882a593Smuzhiyun 		}
613*4882a593Smuzhiyun 		if (state == ACPI_POWER_RESOURCE_STATE_ON) {
614*4882a593Smuzhiyun 			resource->ref_count++;
615*4882a593Smuzhiyun 			resource->wakeup_enabled = true;
616*4882a593Smuzhiyun 		}
617*4882a593Smuzhiyun 		if (system_level > resource->system_level)
618*4882a593Smuzhiyun 			system_level = resource->system_level;
619*4882a593Smuzhiyun 
620*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
621*4882a593Smuzhiyun 	}
622*4882a593Smuzhiyun 	*system_level_p = system_level;
623*4882a593Smuzhiyun 	return 0;
624*4882a593Smuzhiyun }
625*4882a593Smuzhiyun 
626*4882a593Smuzhiyun /* --------------------------------------------------------------------------
627*4882a593Smuzhiyun                              Device Power Management
628*4882a593Smuzhiyun    -------------------------------------------------------------------------- */
629*4882a593Smuzhiyun 
630*4882a593Smuzhiyun /**
631*4882a593Smuzhiyun  * acpi_device_sleep_wake - execute _DSW (Device Sleep Wake) or (deprecated in
632*4882a593Smuzhiyun  *                          ACPI 3.0) _PSW (Power State Wake)
633*4882a593Smuzhiyun  * @dev: Device to handle.
634*4882a593Smuzhiyun  * @enable: 0 - disable, 1 - enable the wake capabilities of the device.
635*4882a593Smuzhiyun  * @sleep_state: Target sleep state of the system.
636*4882a593Smuzhiyun  * @dev_state: Target power state of the device.
637*4882a593Smuzhiyun  *
638*4882a593Smuzhiyun  * Execute _DSW (Device Sleep Wake) or (deprecated in ACPI 3.0) _PSW (Power
639*4882a593Smuzhiyun  * State Wake) for the device, if present.  On failure reset the device's
640*4882a593Smuzhiyun  * wakeup.flags.valid flag.
641*4882a593Smuzhiyun  *
642*4882a593Smuzhiyun  * RETURN VALUE:
643*4882a593Smuzhiyun  * 0 if either _DSW or _PSW has been successfully executed
644*4882a593Smuzhiyun  * 0 if neither _DSW nor _PSW has been found
645*4882a593Smuzhiyun  * -ENODEV if the execution of either _DSW or _PSW has failed
646*4882a593Smuzhiyun  */
acpi_device_sleep_wake(struct acpi_device * dev,int enable,int sleep_state,int dev_state)647*4882a593Smuzhiyun int acpi_device_sleep_wake(struct acpi_device *dev,
648*4882a593Smuzhiyun 			   int enable, int sleep_state, int dev_state)
649*4882a593Smuzhiyun {
650*4882a593Smuzhiyun 	union acpi_object in_arg[3];
651*4882a593Smuzhiyun 	struct acpi_object_list arg_list = { 3, in_arg };
652*4882a593Smuzhiyun 	acpi_status status = AE_OK;
653*4882a593Smuzhiyun 
654*4882a593Smuzhiyun 	/*
655*4882a593Smuzhiyun 	 * Try to execute _DSW first.
656*4882a593Smuzhiyun 	 *
657*4882a593Smuzhiyun 	 * Three arguments are needed for the _DSW object:
658*4882a593Smuzhiyun 	 * Argument 0: enable/disable the wake capabilities
659*4882a593Smuzhiyun 	 * Argument 1: target system state
660*4882a593Smuzhiyun 	 * Argument 2: target device state
661*4882a593Smuzhiyun 	 * When _DSW object is called to disable the wake capabilities, maybe
662*4882a593Smuzhiyun 	 * the first argument is filled. The values of the other two arguments
663*4882a593Smuzhiyun 	 * are meaningless.
664*4882a593Smuzhiyun 	 */
665*4882a593Smuzhiyun 	in_arg[0].type = ACPI_TYPE_INTEGER;
666*4882a593Smuzhiyun 	in_arg[0].integer.value = enable;
667*4882a593Smuzhiyun 	in_arg[1].type = ACPI_TYPE_INTEGER;
668*4882a593Smuzhiyun 	in_arg[1].integer.value = sleep_state;
669*4882a593Smuzhiyun 	in_arg[2].type = ACPI_TYPE_INTEGER;
670*4882a593Smuzhiyun 	in_arg[2].integer.value = dev_state;
671*4882a593Smuzhiyun 	status = acpi_evaluate_object(dev->handle, "_DSW", &arg_list, NULL);
672*4882a593Smuzhiyun 	if (ACPI_SUCCESS(status)) {
673*4882a593Smuzhiyun 		return 0;
674*4882a593Smuzhiyun 	} else if (status != AE_NOT_FOUND) {
675*4882a593Smuzhiyun 		printk(KERN_ERR PREFIX "_DSW execution failed\n");
676*4882a593Smuzhiyun 		dev->wakeup.flags.valid = 0;
677*4882a593Smuzhiyun 		return -ENODEV;
678*4882a593Smuzhiyun 	}
679*4882a593Smuzhiyun 
680*4882a593Smuzhiyun 	/* Execute _PSW */
681*4882a593Smuzhiyun 	status = acpi_execute_simple_method(dev->handle, "_PSW", enable);
682*4882a593Smuzhiyun 	if (ACPI_FAILURE(status) && (status != AE_NOT_FOUND)) {
683*4882a593Smuzhiyun 		printk(KERN_ERR PREFIX "_PSW execution failed\n");
684*4882a593Smuzhiyun 		dev->wakeup.flags.valid = 0;
685*4882a593Smuzhiyun 		return -ENODEV;
686*4882a593Smuzhiyun 	}
687*4882a593Smuzhiyun 
688*4882a593Smuzhiyun 	return 0;
689*4882a593Smuzhiyun }
690*4882a593Smuzhiyun 
691*4882a593Smuzhiyun /*
692*4882a593Smuzhiyun  * Prepare a wakeup device, two steps (Ref ACPI 2.0:P229):
693*4882a593Smuzhiyun  * 1. Power on the power resources required for the wakeup device
694*4882a593Smuzhiyun  * 2. Execute _DSW (Device Sleep Wake) or (deprecated in ACPI 3.0) _PSW (Power
695*4882a593Smuzhiyun  *    State Wake) for the device, if present
696*4882a593Smuzhiyun  */
acpi_enable_wakeup_device_power(struct acpi_device * dev,int sleep_state)697*4882a593Smuzhiyun int acpi_enable_wakeup_device_power(struct acpi_device *dev, int sleep_state)
698*4882a593Smuzhiyun {
699*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
700*4882a593Smuzhiyun 	int err = 0;
701*4882a593Smuzhiyun 
702*4882a593Smuzhiyun 	if (!dev || !dev->wakeup.flags.valid)
703*4882a593Smuzhiyun 		return -EINVAL;
704*4882a593Smuzhiyun 
705*4882a593Smuzhiyun 	mutex_lock(&acpi_device_lock);
706*4882a593Smuzhiyun 
707*4882a593Smuzhiyun 	if (dev->wakeup.prepare_count++)
708*4882a593Smuzhiyun 		goto out;
709*4882a593Smuzhiyun 
710*4882a593Smuzhiyun 	list_for_each_entry(entry, &dev->wakeup.resources, node) {
711*4882a593Smuzhiyun 		struct acpi_power_resource *resource = entry->resource;
712*4882a593Smuzhiyun 
713*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
714*4882a593Smuzhiyun 
715*4882a593Smuzhiyun 		if (!resource->wakeup_enabled) {
716*4882a593Smuzhiyun 			err = acpi_power_on_unlocked(resource);
717*4882a593Smuzhiyun 			if (!err)
718*4882a593Smuzhiyun 				resource->wakeup_enabled = true;
719*4882a593Smuzhiyun 		}
720*4882a593Smuzhiyun 
721*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
722*4882a593Smuzhiyun 
723*4882a593Smuzhiyun 		if (err) {
724*4882a593Smuzhiyun 			dev_err(&dev->dev,
725*4882a593Smuzhiyun 				"Cannot turn wakeup power resources on\n");
726*4882a593Smuzhiyun 			dev->wakeup.flags.valid = 0;
727*4882a593Smuzhiyun 			goto out;
728*4882a593Smuzhiyun 		}
729*4882a593Smuzhiyun 	}
730*4882a593Smuzhiyun 	/*
731*4882a593Smuzhiyun 	 * Passing 3 as the third argument below means the device may be
732*4882a593Smuzhiyun 	 * put into arbitrary power state afterward.
733*4882a593Smuzhiyun 	 */
734*4882a593Smuzhiyun 	err = acpi_device_sleep_wake(dev, 1, sleep_state, 3);
735*4882a593Smuzhiyun 	if (err)
736*4882a593Smuzhiyun 		dev->wakeup.prepare_count = 0;
737*4882a593Smuzhiyun 
738*4882a593Smuzhiyun  out:
739*4882a593Smuzhiyun 	mutex_unlock(&acpi_device_lock);
740*4882a593Smuzhiyun 	return err;
741*4882a593Smuzhiyun }
742*4882a593Smuzhiyun 
743*4882a593Smuzhiyun /*
744*4882a593Smuzhiyun  * Shutdown a wakeup device, counterpart of above method
745*4882a593Smuzhiyun  * 1. Execute _DSW (Device Sleep Wake) or (deprecated in ACPI 3.0) _PSW (Power
746*4882a593Smuzhiyun  *    State Wake) for the device, if present
747*4882a593Smuzhiyun  * 2. Shutdown down the power resources
748*4882a593Smuzhiyun  */
acpi_disable_wakeup_device_power(struct acpi_device * dev)749*4882a593Smuzhiyun int acpi_disable_wakeup_device_power(struct acpi_device *dev)
750*4882a593Smuzhiyun {
751*4882a593Smuzhiyun 	struct acpi_power_resource_entry *entry;
752*4882a593Smuzhiyun 	int err = 0;
753*4882a593Smuzhiyun 
754*4882a593Smuzhiyun 	if (!dev || !dev->wakeup.flags.valid)
755*4882a593Smuzhiyun 		return -EINVAL;
756*4882a593Smuzhiyun 
757*4882a593Smuzhiyun 	mutex_lock(&acpi_device_lock);
758*4882a593Smuzhiyun 
759*4882a593Smuzhiyun 	if (--dev->wakeup.prepare_count > 0)
760*4882a593Smuzhiyun 		goto out;
761*4882a593Smuzhiyun 
762*4882a593Smuzhiyun 	/*
763*4882a593Smuzhiyun 	 * Executing the code below even if prepare_count is already zero when
764*4882a593Smuzhiyun 	 * the function is called may be useful, for example for initialisation.
765*4882a593Smuzhiyun 	 */
766*4882a593Smuzhiyun 	if (dev->wakeup.prepare_count < 0)
767*4882a593Smuzhiyun 		dev->wakeup.prepare_count = 0;
768*4882a593Smuzhiyun 
769*4882a593Smuzhiyun 	err = acpi_device_sleep_wake(dev, 0, 0, 0);
770*4882a593Smuzhiyun 	if (err)
771*4882a593Smuzhiyun 		goto out;
772*4882a593Smuzhiyun 
773*4882a593Smuzhiyun 	list_for_each_entry(entry, &dev->wakeup.resources, node) {
774*4882a593Smuzhiyun 		struct acpi_power_resource *resource = entry->resource;
775*4882a593Smuzhiyun 
776*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
777*4882a593Smuzhiyun 
778*4882a593Smuzhiyun 		if (resource->wakeup_enabled) {
779*4882a593Smuzhiyun 			err = acpi_power_off_unlocked(resource);
780*4882a593Smuzhiyun 			if (!err)
781*4882a593Smuzhiyun 				resource->wakeup_enabled = false;
782*4882a593Smuzhiyun 		}
783*4882a593Smuzhiyun 
784*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
785*4882a593Smuzhiyun 
786*4882a593Smuzhiyun 		if (err) {
787*4882a593Smuzhiyun 			dev_err(&dev->dev,
788*4882a593Smuzhiyun 				"Cannot turn wakeup power resources off\n");
789*4882a593Smuzhiyun 			dev->wakeup.flags.valid = 0;
790*4882a593Smuzhiyun 			break;
791*4882a593Smuzhiyun 		}
792*4882a593Smuzhiyun 	}
793*4882a593Smuzhiyun 
794*4882a593Smuzhiyun  out:
795*4882a593Smuzhiyun 	mutex_unlock(&acpi_device_lock);
796*4882a593Smuzhiyun 	return err;
797*4882a593Smuzhiyun }
798*4882a593Smuzhiyun 
acpi_power_get_inferred_state(struct acpi_device * device,int * state)799*4882a593Smuzhiyun int acpi_power_get_inferred_state(struct acpi_device *device, int *state)
800*4882a593Smuzhiyun {
801*4882a593Smuzhiyun 	int result = 0;
802*4882a593Smuzhiyun 	int list_state = 0;
803*4882a593Smuzhiyun 	int i = 0;
804*4882a593Smuzhiyun 
805*4882a593Smuzhiyun 	if (!device || !state)
806*4882a593Smuzhiyun 		return -EINVAL;
807*4882a593Smuzhiyun 
808*4882a593Smuzhiyun 	/*
809*4882a593Smuzhiyun 	 * We know a device's inferred power state when all the resources
810*4882a593Smuzhiyun 	 * required for a given D-state are 'on'.
811*4882a593Smuzhiyun 	 */
812*4882a593Smuzhiyun 	for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
813*4882a593Smuzhiyun 		struct list_head *list = &device->power.states[i].resources;
814*4882a593Smuzhiyun 
815*4882a593Smuzhiyun 		if (list_empty(list))
816*4882a593Smuzhiyun 			continue;
817*4882a593Smuzhiyun 
818*4882a593Smuzhiyun 		result = acpi_power_get_list_state(list, &list_state);
819*4882a593Smuzhiyun 		if (result)
820*4882a593Smuzhiyun 			return result;
821*4882a593Smuzhiyun 
822*4882a593Smuzhiyun 		if (list_state == ACPI_POWER_RESOURCE_STATE_ON) {
823*4882a593Smuzhiyun 			*state = i;
824*4882a593Smuzhiyun 			return 0;
825*4882a593Smuzhiyun 		}
826*4882a593Smuzhiyun 	}
827*4882a593Smuzhiyun 
828*4882a593Smuzhiyun 	*state = device->power.states[ACPI_STATE_D3_COLD].flags.valid ?
829*4882a593Smuzhiyun 		ACPI_STATE_D3_COLD : ACPI_STATE_D3_HOT;
830*4882a593Smuzhiyun 	return 0;
831*4882a593Smuzhiyun }
832*4882a593Smuzhiyun 
acpi_power_on_resources(struct acpi_device * device,int state)833*4882a593Smuzhiyun int acpi_power_on_resources(struct acpi_device *device, int state)
834*4882a593Smuzhiyun {
835*4882a593Smuzhiyun 	if (!device || state < ACPI_STATE_D0 || state > ACPI_STATE_D3_HOT)
836*4882a593Smuzhiyun 		return -EINVAL;
837*4882a593Smuzhiyun 
838*4882a593Smuzhiyun 	return acpi_power_on_list(&device->power.states[state].resources);
839*4882a593Smuzhiyun }
840*4882a593Smuzhiyun 
acpi_power_transition(struct acpi_device * device,int state)841*4882a593Smuzhiyun int acpi_power_transition(struct acpi_device *device, int state)
842*4882a593Smuzhiyun {
843*4882a593Smuzhiyun 	int result = 0;
844*4882a593Smuzhiyun 
845*4882a593Smuzhiyun 	if (!device || (state < ACPI_STATE_D0) || (state > ACPI_STATE_D3_COLD))
846*4882a593Smuzhiyun 		return -EINVAL;
847*4882a593Smuzhiyun 
848*4882a593Smuzhiyun 	if (device->power.state == state || !device->flags.power_manageable)
849*4882a593Smuzhiyun 		return 0;
850*4882a593Smuzhiyun 
851*4882a593Smuzhiyun 	if ((device->power.state < ACPI_STATE_D0)
852*4882a593Smuzhiyun 	    || (device->power.state > ACPI_STATE_D3_COLD))
853*4882a593Smuzhiyun 		return -ENODEV;
854*4882a593Smuzhiyun 
855*4882a593Smuzhiyun 	/*
856*4882a593Smuzhiyun 	 * First we reference all power resources required in the target list
857*4882a593Smuzhiyun 	 * (e.g. so the device doesn't lose power while transitioning).  Then,
858*4882a593Smuzhiyun 	 * we dereference all power resources used in the current list.
859*4882a593Smuzhiyun 	 */
860*4882a593Smuzhiyun 	if (state < ACPI_STATE_D3_COLD)
861*4882a593Smuzhiyun 		result = acpi_power_on_list(
862*4882a593Smuzhiyun 			&device->power.states[state].resources);
863*4882a593Smuzhiyun 
864*4882a593Smuzhiyun 	if (!result && device->power.state < ACPI_STATE_D3_COLD)
865*4882a593Smuzhiyun 		acpi_power_off_list(
866*4882a593Smuzhiyun 			&device->power.states[device->power.state].resources);
867*4882a593Smuzhiyun 
868*4882a593Smuzhiyun 	/* We shouldn't change the state unless the above operations succeed. */
869*4882a593Smuzhiyun 	device->power.state = result ? ACPI_STATE_UNKNOWN : state;
870*4882a593Smuzhiyun 
871*4882a593Smuzhiyun 	return result;
872*4882a593Smuzhiyun }
873*4882a593Smuzhiyun 
acpi_release_power_resource(struct device * dev)874*4882a593Smuzhiyun static void acpi_release_power_resource(struct device *dev)
875*4882a593Smuzhiyun {
876*4882a593Smuzhiyun 	struct acpi_device *device = to_acpi_device(dev);
877*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
878*4882a593Smuzhiyun 
879*4882a593Smuzhiyun 	resource = container_of(device, struct acpi_power_resource, device);
880*4882a593Smuzhiyun 
881*4882a593Smuzhiyun 	mutex_lock(&power_resource_list_lock);
882*4882a593Smuzhiyun 	list_del(&resource->list_node);
883*4882a593Smuzhiyun 	mutex_unlock(&power_resource_list_lock);
884*4882a593Smuzhiyun 
885*4882a593Smuzhiyun 	acpi_free_pnp_ids(&device->pnp);
886*4882a593Smuzhiyun 	kfree(resource);
887*4882a593Smuzhiyun }
888*4882a593Smuzhiyun 
resource_in_use_show(struct device * dev,struct device_attribute * attr,char * buf)889*4882a593Smuzhiyun static ssize_t resource_in_use_show(struct device *dev,
890*4882a593Smuzhiyun 				    struct device_attribute *attr,
891*4882a593Smuzhiyun 				    char *buf)
892*4882a593Smuzhiyun {
893*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
894*4882a593Smuzhiyun 
895*4882a593Smuzhiyun 	resource = to_power_resource(to_acpi_device(dev));
896*4882a593Smuzhiyun 	return sprintf(buf, "%u\n", !!resource->ref_count);
897*4882a593Smuzhiyun }
898*4882a593Smuzhiyun static DEVICE_ATTR_RO(resource_in_use);
899*4882a593Smuzhiyun 
acpi_power_sysfs_remove(struct acpi_device * device)900*4882a593Smuzhiyun static void acpi_power_sysfs_remove(struct acpi_device *device)
901*4882a593Smuzhiyun {
902*4882a593Smuzhiyun 	device_remove_file(&device->dev, &dev_attr_resource_in_use);
903*4882a593Smuzhiyun }
904*4882a593Smuzhiyun 
acpi_power_add_resource_to_list(struct acpi_power_resource * resource)905*4882a593Smuzhiyun static void acpi_power_add_resource_to_list(struct acpi_power_resource *resource)
906*4882a593Smuzhiyun {
907*4882a593Smuzhiyun 	mutex_lock(&power_resource_list_lock);
908*4882a593Smuzhiyun 
909*4882a593Smuzhiyun 	if (!list_empty(&acpi_power_resource_list)) {
910*4882a593Smuzhiyun 		struct acpi_power_resource *r;
911*4882a593Smuzhiyun 
912*4882a593Smuzhiyun 		list_for_each_entry(r, &acpi_power_resource_list, list_node)
913*4882a593Smuzhiyun 			if (r->order > resource->order) {
914*4882a593Smuzhiyun 				list_add_tail(&resource->list_node, &r->list_node);
915*4882a593Smuzhiyun 				goto out;
916*4882a593Smuzhiyun 			}
917*4882a593Smuzhiyun 	}
918*4882a593Smuzhiyun 	list_add_tail(&resource->list_node, &acpi_power_resource_list);
919*4882a593Smuzhiyun 
920*4882a593Smuzhiyun  out:
921*4882a593Smuzhiyun 	mutex_unlock(&power_resource_list_lock);
922*4882a593Smuzhiyun }
923*4882a593Smuzhiyun 
acpi_add_power_resource(acpi_handle handle)924*4882a593Smuzhiyun int acpi_add_power_resource(acpi_handle handle)
925*4882a593Smuzhiyun {
926*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
927*4882a593Smuzhiyun 	struct acpi_device *device = NULL;
928*4882a593Smuzhiyun 	union acpi_object acpi_object;
929*4882a593Smuzhiyun 	struct acpi_buffer buffer = { sizeof(acpi_object), &acpi_object };
930*4882a593Smuzhiyun 	acpi_status status;
931*4882a593Smuzhiyun 	int state, result = -ENODEV;
932*4882a593Smuzhiyun 
933*4882a593Smuzhiyun 	acpi_bus_get_device(handle, &device);
934*4882a593Smuzhiyun 	if (device)
935*4882a593Smuzhiyun 		return 0;
936*4882a593Smuzhiyun 
937*4882a593Smuzhiyun 	resource = kzalloc(sizeof(*resource), GFP_KERNEL);
938*4882a593Smuzhiyun 	if (!resource)
939*4882a593Smuzhiyun 		return -ENOMEM;
940*4882a593Smuzhiyun 
941*4882a593Smuzhiyun 	device = &resource->device;
942*4882a593Smuzhiyun 	acpi_init_device_object(device, handle, ACPI_BUS_TYPE_POWER,
943*4882a593Smuzhiyun 				ACPI_STA_DEFAULT);
944*4882a593Smuzhiyun 	mutex_init(&resource->resource_lock);
945*4882a593Smuzhiyun 	INIT_LIST_HEAD(&resource->list_node);
946*4882a593Smuzhiyun 	INIT_LIST_HEAD(&resource->dependents);
947*4882a593Smuzhiyun 	resource->name = device->pnp.bus_id;
948*4882a593Smuzhiyun 	strcpy(acpi_device_name(device), ACPI_POWER_DEVICE_NAME);
949*4882a593Smuzhiyun 	strcpy(acpi_device_class(device), ACPI_POWER_CLASS);
950*4882a593Smuzhiyun 	device->power.state = ACPI_STATE_UNKNOWN;
951*4882a593Smuzhiyun 
952*4882a593Smuzhiyun 	/* Evalute the object to get the system level and resource order. */
953*4882a593Smuzhiyun 	status = acpi_evaluate_object(handle, NULL, NULL, &buffer);
954*4882a593Smuzhiyun 	if (ACPI_FAILURE(status))
955*4882a593Smuzhiyun 		goto err;
956*4882a593Smuzhiyun 
957*4882a593Smuzhiyun 	resource->system_level = acpi_object.power_resource.system_level;
958*4882a593Smuzhiyun 	resource->order = acpi_object.power_resource.resource_order;
959*4882a593Smuzhiyun 
960*4882a593Smuzhiyun 	result = acpi_power_get_state(handle, &state);
961*4882a593Smuzhiyun 	if (result)
962*4882a593Smuzhiyun 		goto err;
963*4882a593Smuzhiyun 
964*4882a593Smuzhiyun 	printk(KERN_INFO PREFIX "%s [%s] (%s)\n", acpi_device_name(device),
965*4882a593Smuzhiyun 	       acpi_device_bid(device), state ? "on" : "off");
966*4882a593Smuzhiyun 
967*4882a593Smuzhiyun 	device->flags.match_driver = true;
968*4882a593Smuzhiyun 	result = acpi_device_add(device, acpi_release_power_resource);
969*4882a593Smuzhiyun 	if (result)
970*4882a593Smuzhiyun 		goto err;
971*4882a593Smuzhiyun 
972*4882a593Smuzhiyun 	if (!device_create_file(&device->dev, &dev_attr_resource_in_use))
973*4882a593Smuzhiyun 		device->remove = acpi_power_sysfs_remove;
974*4882a593Smuzhiyun 
975*4882a593Smuzhiyun 	acpi_power_add_resource_to_list(resource);
976*4882a593Smuzhiyun 	acpi_device_add_finalize(device);
977*4882a593Smuzhiyun 	return 0;
978*4882a593Smuzhiyun 
979*4882a593Smuzhiyun  err:
980*4882a593Smuzhiyun 	acpi_release_power_resource(&device->dev);
981*4882a593Smuzhiyun 	return result;
982*4882a593Smuzhiyun }
983*4882a593Smuzhiyun 
984*4882a593Smuzhiyun #ifdef CONFIG_ACPI_SLEEP
acpi_resume_power_resources(void)985*4882a593Smuzhiyun void acpi_resume_power_resources(void)
986*4882a593Smuzhiyun {
987*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
988*4882a593Smuzhiyun 
989*4882a593Smuzhiyun 	mutex_lock(&power_resource_list_lock);
990*4882a593Smuzhiyun 
991*4882a593Smuzhiyun 	list_for_each_entry(resource, &acpi_power_resource_list, list_node) {
992*4882a593Smuzhiyun 		int result, state;
993*4882a593Smuzhiyun 
994*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
995*4882a593Smuzhiyun 
996*4882a593Smuzhiyun 		result = acpi_power_get_state(resource->device.handle, &state);
997*4882a593Smuzhiyun 		if (result) {
998*4882a593Smuzhiyun 			mutex_unlock(&resource->resource_lock);
999*4882a593Smuzhiyun 			continue;
1000*4882a593Smuzhiyun 		}
1001*4882a593Smuzhiyun 
1002*4882a593Smuzhiyun 		if (state == ACPI_POWER_RESOURCE_STATE_OFF
1003*4882a593Smuzhiyun 		    && resource->ref_count) {
1004*4882a593Smuzhiyun 			dev_info(&resource->device.dev, "Turning ON\n");
1005*4882a593Smuzhiyun 			__acpi_power_on(resource);
1006*4882a593Smuzhiyun 		}
1007*4882a593Smuzhiyun 
1008*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
1009*4882a593Smuzhiyun 	}
1010*4882a593Smuzhiyun 
1011*4882a593Smuzhiyun 	mutex_unlock(&power_resource_list_lock);
1012*4882a593Smuzhiyun }
1013*4882a593Smuzhiyun 
acpi_turn_off_unused_power_resources(void)1014*4882a593Smuzhiyun void acpi_turn_off_unused_power_resources(void)
1015*4882a593Smuzhiyun {
1016*4882a593Smuzhiyun 	struct acpi_power_resource *resource;
1017*4882a593Smuzhiyun 
1018*4882a593Smuzhiyun 	mutex_lock(&power_resource_list_lock);
1019*4882a593Smuzhiyun 
1020*4882a593Smuzhiyun 	list_for_each_entry_reverse(resource, &acpi_power_resource_list, list_node) {
1021*4882a593Smuzhiyun 		int result, state;
1022*4882a593Smuzhiyun 
1023*4882a593Smuzhiyun 		mutex_lock(&resource->resource_lock);
1024*4882a593Smuzhiyun 
1025*4882a593Smuzhiyun 		result = acpi_power_get_state(resource->device.handle, &state);
1026*4882a593Smuzhiyun 		if (result) {
1027*4882a593Smuzhiyun 			mutex_unlock(&resource->resource_lock);
1028*4882a593Smuzhiyun 			continue;
1029*4882a593Smuzhiyun 		}
1030*4882a593Smuzhiyun 
1031*4882a593Smuzhiyun 		if (state == ACPI_POWER_RESOURCE_STATE_ON
1032*4882a593Smuzhiyun 		    && !resource->ref_count) {
1033*4882a593Smuzhiyun 			dev_info(&resource->device.dev, "Turning OFF\n");
1034*4882a593Smuzhiyun 			__acpi_power_off(resource);
1035*4882a593Smuzhiyun 		}
1036*4882a593Smuzhiyun 
1037*4882a593Smuzhiyun 		mutex_unlock(&resource->resource_lock);
1038*4882a593Smuzhiyun 	}
1039*4882a593Smuzhiyun 
1040*4882a593Smuzhiyun 	mutex_unlock(&power_resource_list_lock);
1041*4882a593Smuzhiyun }
1042*4882a593Smuzhiyun #endif
1043