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