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