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