Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * drivers/base/power/main.c - Where the driver meets power management. | |
3 | * | |
4 | * Copyright (c) 2003 Patrick Mochel | |
5 | * Copyright (c) 2003 Open Source Development Lab | |
6 | * | |
7 | * This file is released under the GPLv2 | |
8 | * | |
9 | * | |
10 | * The driver model core calls device_pm_add() when a device is registered. | |
b595076a | 11 | * This will initialize the embedded device_pm_info object in the device |
1da177e4 LT |
12 | * and add it to the list of power-controlled devices. sysfs entries for |
13 | * controlling device power management will also be added. | |
14 | * | |
1eede070 RW |
15 | * A separate list is used for keeping track of power info, because the power |
16 | * domain dependencies may differ from the ancestral dependencies that the | |
17 | * subsystem list maintains. | |
1da177e4 LT |
18 | */ |
19 | ||
1da177e4 | 20 | #include <linux/device.h> |
cd59abfc | 21 | #include <linux/kallsyms.h> |
1b6bc32f | 22 | #include <linux/export.h> |
11048dcf | 23 | #include <linux/mutex.h> |
cd59abfc | 24 | #include <linux/pm.h> |
5e928f77 | 25 | #include <linux/pm_runtime.h> |
cd59abfc | 26 | #include <linux/resume-trace.h> |
2ed8d2b3 | 27 | #include <linux/interrupt.h> |
f2511774 | 28 | #include <linux/sched.h> |
5af84b82 | 29 | #include <linux/async.h> |
1e75227e | 30 | #include <linux/suspend.h> |
11048dcf | 31 | |
cd59abfc | 32 | #include "../base.h" |
1da177e4 LT |
33 | #include "power.h" |
34 | ||
775b64d2 | 35 | /* |
1eede070 | 36 | * The entries in the dpm_list list are in a depth first order, simply |
775b64d2 RW |
37 | * because children are guaranteed to be discovered after parents, and |
38 | * are inserted at the back of the list on discovery. | |
39 | * | |
8e9394ce GKH |
40 | * Since device_pm_add() may be called with a device lock held, |
41 | * we must never try to acquire a device lock while holding | |
775b64d2 RW |
42 | * dpm_list_mutex. |
43 | */ | |
44 | ||
1eede070 | 45 | LIST_HEAD(dpm_list); |
8a43a9ab RW |
46 | LIST_HEAD(dpm_prepared_list); |
47 | LIST_HEAD(dpm_suspended_list); | |
48 | LIST_HEAD(dpm_noirq_list); | |
1da177e4 | 49 | |
2a77c46d | 50 | struct suspend_stats suspend_stats; |
cd59abfc | 51 | static DEFINE_MUTEX(dpm_list_mtx); |
5af84b82 | 52 | static pm_message_t pm_transition; |
1da177e4 | 53 | |
098dff73 RW |
54 | static int async_error; |
55 | ||
5e928f77 | 56 | /** |
20d652d7 | 57 | * device_pm_init - Initialize the PM-related part of a device object. |
5e928f77 RW |
58 | * @dev: Device object being initialized. |
59 | */ | |
60 | void device_pm_init(struct device *dev) | |
61 | { | |
f76b168b | 62 | dev->power.is_prepared = false; |
6d0e0e84 | 63 | dev->power.is_suspended = false; |
5af84b82 | 64 | init_completion(&dev->power.completion); |
152e1d59 | 65 | complete_all(&dev->power.completion); |
074037ec RW |
66 | dev->power.wakeup = NULL; |
67 | spin_lock_init(&dev->power.lock); | |
5e928f77 | 68 | pm_runtime_init(dev); |
22110faf | 69 | INIT_LIST_HEAD(&dev->power.entry); |
1a9a9152 | 70 | dev->power.power_state = PMSG_INVALID; |
5e928f77 RW |
71 | } |
72 | ||
1eede070 | 73 | /** |
20d652d7 | 74 | * device_pm_lock - Lock the list of active devices used by the PM core. |
1eede070 RW |
75 | */ |
76 | void device_pm_lock(void) | |
77 | { | |
78 | mutex_lock(&dpm_list_mtx); | |
79 | } | |
80 | ||
81 | /** | |
20d652d7 | 82 | * device_pm_unlock - Unlock the list of active devices used by the PM core. |
1eede070 RW |
83 | */ |
84 | void device_pm_unlock(void) | |
85 | { | |
86 | mutex_unlock(&dpm_list_mtx); | |
87 | } | |
075c1771 | 88 | |
775b64d2 | 89 | /** |
20d652d7 RW |
90 | * device_pm_add - Add a device to the PM core's list of active devices. |
91 | * @dev: Device to add to the list. | |
775b64d2 | 92 | */ |
3b98aeaf | 93 | void device_pm_add(struct device *dev) |
1da177e4 | 94 | { |
1da177e4 | 95 | pr_debug("PM: Adding info for %s:%s\n", |
5c1a07ab | 96 | dev->bus ? dev->bus->name : "No Bus", dev_name(dev)); |
11048dcf | 97 | mutex_lock(&dpm_list_mtx); |
f76b168b | 98 | if (dev->parent && dev->parent->power.is_prepared) |
b64959e6 RW |
99 | dev_warn(dev, "parent %s should not be sleeping\n", |
100 | dev_name(dev->parent)); | |
3b98aeaf | 101 | list_add_tail(&dev->power.entry, &dpm_list); |
91ff4cb8 | 102 | dev_pm_qos_constraints_init(dev); |
1a9a9152 | 103 | mutex_unlock(&dpm_list_mtx); |
1da177e4 LT |
104 | } |
105 | ||
775b64d2 | 106 | /** |
20d652d7 RW |
107 | * device_pm_remove - Remove a device from the PM core's list of active devices. |
108 | * @dev: Device to be removed from the list. | |
775b64d2 | 109 | */ |
9cddad77 | 110 | void device_pm_remove(struct device *dev) |
1da177e4 LT |
111 | { |
112 | pr_debug("PM: Removing info for %s:%s\n", | |
5c1a07ab | 113 | dev->bus ? dev->bus->name : "No Bus", dev_name(dev)); |
5af84b82 | 114 | complete_all(&dev->power.completion); |
11048dcf | 115 | mutex_lock(&dpm_list_mtx); |
1a9a9152 | 116 | dev_pm_qos_constraints_destroy(dev); |
1da177e4 | 117 | list_del_init(&dev->power.entry); |
11048dcf | 118 | mutex_unlock(&dpm_list_mtx); |
074037ec | 119 | device_wakeup_disable(dev); |
5e928f77 | 120 | pm_runtime_remove(dev); |
775b64d2 RW |
121 | } |
122 | ||
ffa6a705 | 123 | /** |
20d652d7 RW |
124 | * device_pm_move_before - Move device in the PM core's list of active devices. |
125 | * @deva: Device to move in dpm_list. | |
126 | * @devb: Device @deva should come before. | |
ffa6a705 CH |
127 | */ |
128 | void device_pm_move_before(struct device *deva, struct device *devb) | |
129 | { | |
130 | pr_debug("PM: Moving %s:%s before %s:%s\n", | |
5c1a07ab RW |
131 | deva->bus ? deva->bus->name : "No Bus", dev_name(deva), |
132 | devb->bus ? devb->bus->name : "No Bus", dev_name(devb)); | |
ffa6a705 CH |
133 | /* Delete deva from dpm_list and reinsert before devb. */ |
134 | list_move_tail(&deva->power.entry, &devb->power.entry); | |
135 | } | |
136 | ||
137 | /** | |
20d652d7 RW |
138 | * device_pm_move_after - Move device in the PM core's list of active devices. |
139 | * @deva: Device to move in dpm_list. | |
140 | * @devb: Device @deva should come after. | |
ffa6a705 CH |
141 | */ |
142 | void device_pm_move_after(struct device *deva, struct device *devb) | |
143 | { | |
144 | pr_debug("PM: Moving %s:%s after %s:%s\n", | |
5c1a07ab RW |
145 | deva->bus ? deva->bus->name : "No Bus", dev_name(deva), |
146 | devb->bus ? devb->bus->name : "No Bus", dev_name(devb)); | |
ffa6a705 CH |
147 | /* Delete deva from dpm_list and reinsert after devb. */ |
148 | list_move(&deva->power.entry, &devb->power.entry); | |
149 | } | |
150 | ||
151 | /** | |
20d652d7 RW |
152 | * device_pm_move_last - Move device to end of the PM core's list of devices. |
153 | * @dev: Device to move in dpm_list. | |
ffa6a705 CH |
154 | */ |
155 | void device_pm_move_last(struct device *dev) | |
156 | { | |
157 | pr_debug("PM: Moving %s:%s to end of list\n", | |
5c1a07ab | 158 | dev->bus ? dev->bus->name : "No Bus", dev_name(dev)); |
ffa6a705 CH |
159 | list_move_tail(&dev->power.entry, &dpm_list); |
160 | } | |
161 | ||
875ab0b7 RW |
162 | static ktime_t initcall_debug_start(struct device *dev) |
163 | { | |
164 | ktime_t calltime = ktime_set(0, 0); | |
165 | ||
166 | if (initcall_debug) { | |
167 | pr_info("calling %s+ @ %i\n", | |
168 | dev_name(dev), task_pid_nr(current)); | |
169 | calltime = ktime_get(); | |
170 | } | |
171 | ||
172 | return calltime; | |
173 | } | |
174 | ||
175 | static void initcall_debug_report(struct device *dev, ktime_t calltime, | |
176 | int error) | |
177 | { | |
178 | ktime_t delta, rettime; | |
179 | ||
180 | if (initcall_debug) { | |
181 | rettime = ktime_get(); | |
182 | delta = ktime_sub(rettime, calltime); | |
183 | pr_info("call %s+ returned %d after %Ld usecs\n", dev_name(dev), | |
184 | error, (unsigned long long)ktime_to_ns(delta) >> 10); | |
185 | } | |
186 | } | |
187 | ||
5af84b82 RW |
188 | /** |
189 | * dpm_wait - Wait for a PM operation to complete. | |
190 | * @dev: Device to wait for. | |
191 | * @async: If unset, wait only if the device's power.async_suspend flag is set. | |
192 | */ | |
193 | static void dpm_wait(struct device *dev, bool async) | |
194 | { | |
195 | if (!dev) | |
196 | return; | |
197 | ||
0e06b4a8 | 198 | if (async || (pm_async_enabled && dev->power.async_suspend)) |
5af84b82 RW |
199 | wait_for_completion(&dev->power.completion); |
200 | } | |
201 | ||
202 | static int dpm_wait_fn(struct device *dev, void *async_ptr) | |
203 | { | |
204 | dpm_wait(dev, *((bool *)async_ptr)); | |
205 | return 0; | |
206 | } | |
207 | ||
208 | static void dpm_wait_for_children(struct device *dev, bool async) | |
209 | { | |
210 | device_for_each_child(dev, &async, dpm_wait_fn); | |
211 | } | |
212 | ||
1eede070 | 213 | /** |
20d652d7 RW |
214 | * pm_op - Execute the PM operation appropriate for given PM event. |
215 | * @dev: Device to handle. | |
216 | * @ops: PM operations to choose from. | |
217 | * @state: PM transition of the system being carried out. | |
1eede070 | 218 | */ |
d9ab7716 DT |
219 | static int pm_op(struct device *dev, |
220 | const struct dev_pm_ops *ops, | |
221 | pm_message_t state) | |
1eede070 RW |
222 | { |
223 | int error = 0; | |
875ab0b7 | 224 | ktime_t calltime; |
f2511774 | 225 | |
875ab0b7 | 226 | calltime = initcall_debug_start(dev); |
1eede070 RW |
227 | |
228 | switch (state.event) { | |
229 | #ifdef CONFIG_SUSPEND | |
230 | case PM_EVENT_SUSPEND: | |
231 | if (ops->suspend) { | |
232 | error = ops->suspend(dev); | |
233 | suspend_report_result(ops->suspend, error); | |
234 | } | |
235 | break; | |
236 | case PM_EVENT_RESUME: | |
237 | if (ops->resume) { | |
238 | error = ops->resume(dev); | |
239 | suspend_report_result(ops->resume, error); | |
240 | } | |
241 | break; | |
242 | #endif /* CONFIG_SUSPEND */ | |
1f112cee | 243 | #ifdef CONFIG_HIBERNATE_CALLBACKS |
1eede070 RW |
244 | case PM_EVENT_FREEZE: |
245 | case PM_EVENT_QUIESCE: | |
246 | if (ops->freeze) { | |
247 | error = ops->freeze(dev); | |
248 | suspend_report_result(ops->freeze, error); | |
249 | } | |
250 | break; | |
251 | case PM_EVENT_HIBERNATE: | |
252 | if (ops->poweroff) { | |
253 | error = ops->poweroff(dev); | |
254 | suspend_report_result(ops->poweroff, error); | |
255 | } | |
256 | break; | |
257 | case PM_EVENT_THAW: | |
258 | case PM_EVENT_RECOVER: | |
259 | if (ops->thaw) { | |
260 | error = ops->thaw(dev); | |
261 | suspend_report_result(ops->thaw, error); | |
262 | } | |
263 | break; | |
264 | case PM_EVENT_RESTORE: | |
265 | if (ops->restore) { | |
266 | error = ops->restore(dev); | |
267 | suspend_report_result(ops->restore, error); | |
268 | } | |
269 | break; | |
1f112cee | 270 | #endif /* CONFIG_HIBERNATE_CALLBACKS */ |
1eede070 RW |
271 | default: |
272 | error = -EINVAL; | |
273 | } | |
f2511774 | 274 | |
875ab0b7 | 275 | initcall_debug_report(dev, calltime, error); |
f2511774 | 276 | |
1eede070 RW |
277 | return error; |
278 | } | |
279 | ||
280 | /** | |
20d652d7 RW |
281 | * pm_noirq_op - Execute the PM operation appropriate for given PM event. |
282 | * @dev: Device to handle. | |
283 | * @ops: PM operations to choose from. | |
284 | * @state: PM transition of the system being carried out. | |
1eede070 | 285 | * |
20d652d7 RW |
286 | * The driver of @dev will not receive interrupts while this function is being |
287 | * executed. | |
1eede070 | 288 | */ |
d9ab7716 DT |
289 | static int pm_noirq_op(struct device *dev, |
290 | const struct dev_pm_ops *ops, | |
1eede070 RW |
291 | pm_message_t state) |
292 | { | |
293 | int error = 0; | |
2cbb3ce1 | 294 | ktime_t calltime = ktime_set(0, 0), delta, rettime; |
f2511774 AV |
295 | |
296 | if (initcall_debug) { | |
8cc6b39f RW |
297 | pr_info("calling %s+ @ %i, parent: %s\n", |
298 | dev_name(dev), task_pid_nr(current), | |
299 | dev->parent ? dev_name(dev->parent) : "none"); | |
f2511774 AV |
300 | calltime = ktime_get(); |
301 | } | |
1eede070 RW |
302 | |
303 | switch (state.event) { | |
304 | #ifdef CONFIG_SUSPEND | |
305 | case PM_EVENT_SUSPEND: | |
306 | if (ops->suspend_noirq) { | |
307 | error = ops->suspend_noirq(dev); | |
308 | suspend_report_result(ops->suspend_noirq, error); | |
309 | } | |
310 | break; | |
311 | case PM_EVENT_RESUME: | |
312 | if (ops->resume_noirq) { | |
313 | error = ops->resume_noirq(dev); | |
314 | suspend_report_result(ops->resume_noirq, error); | |
315 | } | |
316 | break; | |
317 | #endif /* CONFIG_SUSPEND */ | |
1f112cee | 318 | #ifdef CONFIG_HIBERNATE_CALLBACKS |
1eede070 RW |
319 | case PM_EVENT_FREEZE: |
320 | case PM_EVENT_QUIESCE: | |
321 | if (ops->freeze_noirq) { | |
322 | error = ops->freeze_noirq(dev); | |
323 | suspend_report_result(ops->freeze_noirq, error); | |
324 | } | |
325 | break; | |
326 | case PM_EVENT_HIBERNATE: | |
327 | if (ops->poweroff_noirq) { | |
328 | error = ops->poweroff_noirq(dev); | |
329 | suspend_report_result(ops->poweroff_noirq, error); | |
330 | } | |
331 | break; | |
332 | case PM_EVENT_THAW: | |
333 | case PM_EVENT_RECOVER: | |
334 | if (ops->thaw_noirq) { | |
335 | error = ops->thaw_noirq(dev); | |
336 | suspend_report_result(ops->thaw_noirq, error); | |
337 | } | |
338 | break; | |
339 | case PM_EVENT_RESTORE: | |
340 | if (ops->restore_noirq) { | |
341 | error = ops->restore_noirq(dev); | |
342 | suspend_report_result(ops->restore_noirq, error); | |
343 | } | |
344 | break; | |
1f112cee | 345 | #endif /* CONFIG_HIBERNATE_CALLBACKS */ |
1eede070 RW |
346 | default: |
347 | error = -EINVAL; | |
348 | } | |
f2511774 AV |
349 | |
350 | if (initcall_debug) { | |
351 | rettime = ktime_get(); | |
352 | delta = ktime_sub(rettime, calltime); | |
875ab0b7 RW |
353 | printk("initcall %s_i+ returned %d after %Ld usecs\n", |
354 | dev_name(dev), error, | |
355 | (unsigned long long)ktime_to_ns(delta) >> 10); | |
f2511774 AV |
356 | } |
357 | ||
1eede070 RW |
358 | return error; |
359 | } | |
360 | ||
361 | static char *pm_verb(int event) | |
362 | { | |
363 | switch (event) { | |
364 | case PM_EVENT_SUSPEND: | |
365 | return "suspend"; | |
366 | case PM_EVENT_RESUME: | |
367 | return "resume"; | |
368 | case PM_EVENT_FREEZE: | |
369 | return "freeze"; | |
370 | case PM_EVENT_QUIESCE: | |
371 | return "quiesce"; | |
372 | case PM_EVENT_HIBERNATE: | |
373 | return "hibernate"; | |
374 | case PM_EVENT_THAW: | |
375 | return "thaw"; | |
376 | case PM_EVENT_RESTORE: | |
377 | return "restore"; | |
378 | case PM_EVENT_RECOVER: | |
379 | return "recover"; | |
380 | default: | |
381 | return "(unknown PM event)"; | |
382 | } | |
383 | } | |
384 | ||
385 | static void pm_dev_dbg(struct device *dev, pm_message_t state, char *info) | |
386 | { | |
387 | dev_dbg(dev, "%s%s%s\n", info, pm_verb(state.event), | |
388 | ((state.event & PM_EVENT_SLEEP) && device_may_wakeup(dev)) ? | |
389 | ", may wakeup" : ""); | |
390 | } | |
391 | ||
392 | static void pm_dev_err(struct device *dev, pm_message_t state, char *info, | |
393 | int error) | |
394 | { | |
395 | printk(KERN_ERR "PM: Device %s failed to %s%s: error %d\n", | |
5c1a07ab | 396 | dev_name(dev), pm_verb(state.event), info, error); |
1eede070 RW |
397 | } |
398 | ||
ecf762b2 RW |
399 | static void dpm_show_time(ktime_t starttime, pm_message_t state, char *info) |
400 | { | |
401 | ktime_t calltime; | |
0702d9ee | 402 | u64 usecs64; |
ecf762b2 RW |
403 | int usecs; |
404 | ||
405 | calltime = ktime_get(); | |
406 | usecs64 = ktime_to_ns(ktime_sub(calltime, starttime)); | |
407 | do_div(usecs64, NSEC_PER_USEC); | |
408 | usecs = usecs64; | |
409 | if (usecs == 0) | |
410 | usecs = 1; | |
411 | pr_info("PM: %s%s%s of devices complete after %ld.%03ld msecs\n", | |
412 | info ?: "", info ? " " : "", pm_verb(state.event), | |
413 | usecs / USEC_PER_MSEC, usecs % USEC_PER_MSEC); | |
414 | } | |
415 | ||
cd59abfc AS |
416 | /*------------------------- Resume routines -------------------------*/ |
417 | ||
418 | /** | |
20d652d7 RW |
419 | * device_resume_noirq - Execute an "early resume" callback for given device. |
420 | * @dev: Device to handle. | |
421 | * @state: PM transition of the system being carried out. | |
cd59abfc | 422 | * |
20d652d7 RW |
423 | * The driver of @dev will not receive interrupts while this function is being |
424 | * executed. | |
cd59abfc | 425 | */ |
d1616302 | 426 | static int device_resume_noirq(struct device *dev, pm_message_t state) |
cd59abfc AS |
427 | { |
428 | int error = 0; | |
429 | ||
430 | TRACE_DEVICE(dev); | |
431 | TRACE_RESUME(0); | |
432 | ||
564b905a | 433 | if (dev->pm_domain) { |
7538e3db | 434 | pm_dev_dbg(dev, state, "EARLY power domain "); |
564b905a | 435 | error = pm_noirq_op(dev, &dev->pm_domain->ops, state); |
4d27e9dc | 436 | } else if (dev->type && dev->type->pm) { |
e7176a37 DB |
437 | pm_dev_dbg(dev, state, "EARLY type "); |
438 | error = pm_noirq_op(dev, dev->type->pm, state); | |
9659cc06 | 439 | } else if (dev->class && dev->class->pm) { |
e7176a37 DB |
440 | pm_dev_dbg(dev, state, "EARLY class "); |
441 | error = pm_noirq_op(dev, dev->class->pm, state); | |
9659cc06 RW |
442 | } else if (dev->bus && dev->bus->pm) { |
443 | pm_dev_dbg(dev, state, "EARLY "); | |
444 | error = pm_noirq_op(dev, dev->bus->pm, state); | |
e7176a37 DB |
445 | } |
446 | ||
775b64d2 RW |
447 | TRACE_RESUME(error); |
448 | return error; | |
449 | } | |
450 | ||
451 | /** | |
20d652d7 RW |
452 | * dpm_resume_noirq - Execute "early resume" callbacks for non-sysdev devices. |
453 | * @state: PM transition of the system being carried out. | |
775b64d2 | 454 | * |
20d652d7 RW |
455 | * Call the "noirq" resume handlers for all devices marked as DPM_OFF_IRQ and |
456 | * enable device drivers to receive interrupts. | |
775b64d2 | 457 | */ |
d1616302 | 458 | void dpm_resume_noirq(pm_message_t state) |
775b64d2 | 459 | { |
ecf762b2 | 460 | ktime_t starttime = ktime_get(); |
775b64d2 | 461 | |
32bdfac5 | 462 | mutex_lock(&dpm_list_mtx); |
8a43a9ab RW |
463 | while (!list_empty(&dpm_noirq_list)) { |
464 | struct device *dev = to_device(dpm_noirq_list.next); | |
5b219a51 | 465 | int error; |
d08a5ace RW |
466 | |
467 | get_device(dev); | |
5b219a51 RW |
468 | list_move_tail(&dev->power.entry, &dpm_suspended_list); |
469 | mutex_unlock(&dpm_list_mtx); | |
d08a5ace | 470 | |
5b219a51 | 471 | error = device_resume_noirq(dev, state); |
2a77c46d SL |
472 | if (error) { |
473 | suspend_stats.failed_resume_noirq++; | |
474 | dpm_save_failed_step(SUSPEND_RESUME_NOIRQ); | |
475 | dpm_save_failed_dev(dev_name(dev)); | |
5b219a51 | 476 | pm_dev_err(dev, state, " early", error); |
2a77c46d | 477 | } |
d08a5ace | 478 | |
5b219a51 | 479 | mutex_lock(&dpm_list_mtx); |
d08a5ace RW |
480 | put_device(dev); |
481 | } | |
32bdfac5 | 482 | mutex_unlock(&dpm_list_mtx); |
ecf762b2 | 483 | dpm_show_time(starttime, state, "early"); |
2ed8d2b3 | 484 | resume_device_irqs(); |
775b64d2 | 485 | } |
d1616302 | 486 | EXPORT_SYMBOL_GPL(dpm_resume_noirq); |
775b64d2 | 487 | |
875ab0b7 RW |
488 | /** |
489 | * legacy_resume - Execute a legacy (bus or class) resume callback for device. | |
0a884223 RD |
490 | * @dev: Device to resume. |
491 | * @cb: Resume callback to execute. | |
875ab0b7 RW |
492 | */ |
493 | static int legacy_resume(struct device *dev, int (*cb)(struct device *dev)) | |
494 | { | |
495 | int error; | |
496 | ktime_t calltime; | |
497 | ||
498 | calltime = initcall_debug_start(dev); | |
499 | ||
500 | error = cb(dev); | |
501 | suspend_report_result(cb, error); | |
502 | ||
503 | initcall_debug_report(dev, calltime, error); | |
504 | ||
505 | return error; | |
506 | } | |
507 | ||
775b64d2 | 508 | /** |
97df8c12 | 509 | * device_resume - Execute "resume" callbacks for given device. |
20d652d7 RW |
510 | * @dev: Device to handle. |
511 | * @state: PM transition of the system being carried out. | |
5af84b82 | 512 | * @async: If true, the device is being resumed asynchronously. |
775b64d2 | 513 | */ |
97df8c12 | 514 | static int device_resume(struct device *dev, pm_message_t state, bool async) |
775b64d2 RW |
515 | { |
516 | int error = 0; | |
1e2ef05b | 517 | bool put = false; |
775b64d2 RW |
518 | |
519 | TRACE_DEVICE(dev); | |
520 | TRACE_RESUME(0); | |
cd59abfc | 521 | |
5af84b82 | 522 | dpm_wait(dev->parent, async); |
8e9394ce | 523 | device_lock(dev); |
7a8d37a3 | 524 | |
f76b168b AS |
525 | /* |
526 | * This is a fib. But we'll allow new children to be added below | |
527 | * a resumed device, even if the device hasn't been completed yet. | |
528 | */ | |
529 | dev->power.is_prepared = false; | |
97df8c12 | 530 | |
6d0e0e84 AS |
531 | if (!dev->power.is_suspended) |
532 | goto Unlock; | |
533 | ||
1e2ef05b RW |
534 | pm_runtime_enable(dev); |
535 | put = true; | |
536 | ||
564b905a | 537 | if (dev->pm_domain) { |
7538e3db | 538 | pm_dev_dbg(dev, state, "power domain "); |
564b905a | 539 | error = pm_op(dev, &dev->pm_domain->ops, state); |
4d27e9dc | 540 | goto End; |
7538e3db RW |
541 | } |
542 | ||
9659cc06 RW |
543 | if (dev->type && dev->type->pm) { |
544 | pm_dev_dbg(dev, state, "type "); | |
545 | error = pm_op(dev, dev->type->pm, state); | |
546 | goto End; | |
cd59abfc AS |
547 | } |
548 | ||
1eede070 RW |
549 | if (dev->class) { |
550 | if (dev->class->pm) { | |
551 | pm_dev_dbg(dev, state, "class "); | |
552 | error = pm_op(dev, dev->class->pm, state); | |
9659cc06 | 553 | goto End; |
1eede070 RW |
554 | } else if (dev->class->resume) { |
555 | pm_dev_dbg(dev, state, "legacy class "); | |
875ab0b7 | 556 | error = legacy_resume(dev, dev->class->resume); |
9659cc06 | 557 | goto End; |
1eede070 | 558 | } |
cd59abfc | 559 | } |
9659cc06 RW |
560 | |
561 | if (dev->bus) { | |
562 | if (dev->bus->pm) { | |
563 | pm_dev_dbg(dev, state, ""); | |
564 | error = pm_op(dev, dev->bus->pm, state); | |
565 | } else if (dev->bus->resume) { | |
566 | pm_dev_dbg(dev, state, "legacy "); | |
567 | error = legacy_resume(dev, dev->bus->resume); | |
568 | } | |
569 | } | |
570 | ||
1eede070 | 571 | End: |
6d0e0e84 AS |
572 | dev->power.is_suspended = false; |
573 | ||
574 | Unlock: | |
8e9394ce | 575 | device_unlock(dev); |
5af84b82 | 576 | complete_all(&dev->power.completion); |
7a8d37a3 | 577 | |
cd59abfc | 578 | TRACE_RESUME(error); |
1e2ef05b RW |
579 | |
580 | if (put) | |
581 | pm_runtime_put_sync(dev); | |
582 | ||
cd59abfc AS |
583 | return error; |
584 | } | |
585 | ||
5af84b82 RW |
586 | static void async_resume(void *data, async_cookie_t cookie) |
587 | { | |
588 | struct device *dev = (struct device *)data; | |
589 | int error; | |
590 | ||
97df8c12 | 591 | error = device_resume(dev, pm_transition, true); |
5af84b82 RW |
592 | if (error) |
593 | pm_dev_err(dev, pm_transition, " async", error); | |
594 | put_device(dev); | |
595 | } | |
596 | ||
97df8c12 | 597 | static bool is_async(struct device *dev) |
5af84b82 | 598 | { |
97df8c12 RW |
599 | return dev->power.async_suspend && pm_async_enabled |
600 | && !pm_trace_is_enabled(); | |
5af84b82 RW |
601 | } |
602 | ||
775b64d2 | 603 | /** |
20d652d7 RW |
604 | * dpm_resume - Execute "resume" callbacks for non-sysdev devices. |
605 | * @state: PM transition of the system being carried out. | |
775b64d2 | 606 | * |
20d652d7 RW |
607 | * Execute the appropriate "resume" callback for all devices whose status |
608 | * indicates that they are suspended. | |
1eede070 | 609 | */ |
91e7c75b | 610 | void dpm_resume(pm_message_t state) |
1eede070 | 611 | { |
97df8c12 | 612 | struct device *dev; |
ecf762b2 | 613 | ktime_t starttime = ktime_get(); |
1eede070 | 614 | |
91e7c75b RW |
615 | might_sleep(); |
616 | ||
1eede070 | 617 | mutex_lock(&dpm_list_mtx); |
5af84b82 | 618 | pm_transition = state; |
098dff73 | 619 | async_error = 0; |
1eede070 | 620 | |
8a43a9ab | 621 | list_for_each_entry(dev, &dpm_suspended_list, power.entry) { |
97df8c12 RW |
622 | INIT_COMPLETION(dev->power.completion); |
623 | if (is_async(dev)) { | |
624 | get_device(dev); | |
625 | async_schedule(async_resume, dev); | |
626 | } | |
627 | } | |
628 | ||
8a43a9ab RW |
629 | while (!list_empty(&dpm_suspended_list)) { |
630 | dev = to_device(dpm_suspended_list.next); | |
1eede070 | 631 | get_device(dev); |
5b219a51 | 632 | if (!is_async(dev)) { |
1eede070 RW |
633 | int error; |
634 | ||
1eede070 RW |
635 | mutex_unlock(&dpm_list_mtx); |
636 | ||
97df8c12 | 637 | error = device_resume(dev, state, false); |
2a77c46d SL |
638 | if (error) { |
639 | suspend_stats.failed_resume++; | |
640 | dpm_save_failed_step(SUSPEND_RESUME); | |
641 | dpm_save_failed_dev(dev_name(dev)); | |
1eede070 | 642 | pm_dev_err(dev, state, "", error); |
2a77c46d | 643 | } |
5b219a51 RW |
644 | |
645 | mutex_lock(&dpm_list_mtx); | |
1eede070 RW |
646 | } |
647 | if (!list_empty(&dev->power.entry)) | |
8a43a9ab | 648 | list_move_tail(&dev->power.entry, &dpm_prepared_list); |
1eede070 RW |
649 | put_device(dev); |
650 | } | |
1eede070 | 651 | mutex_unlock(&dpm_list_mtx); |
5af84b82 | 652 | async_synchronize_full(); |
ecf762b2 | 653 | dpm_show_time(starttime, state, NULL); |
1eede070 RW |
654 | } |
655 | ||
656 | /** | |
20d652d7 RW |
657 | * device_complete - Complete a PM transition for given device. |
658 | * @dev: Device to handle. | |
659 | * @state: PM transition of the system being carried out. | |
1eede070 | 660 | */ |
d1616302 | 661 | static void device_complete(struct device *dev, pm_message_t state) |
1eede070 | 662 | { |
8e9394ce | 663 | device_lock(dev); |
1eede070 | 664 | |
564b905a | 665 | if (dev->pm_domain) { |
7538e3db | 666 | pm_dev_dbg(dev, state, "completing power domain "); |
564b905a RW |
667 | if (dev->pm_domain->ops.complete) |
668 | dev->pm_domain->ops.complete(dev); | |
4d27e9dc | 669 | } else if (dev->type && dev->type->pm) { |
1eede070 | 670 | pm_dev_dbg(dev, state, "completing type "); |
9659cc06 RW |
671 | if (dev->type->pm->complete) |
672 | dev->type->pm->complete(dev); | |
673 | } else if (dev->class && dev->class->pm) { | |
674 | pm_dev_dbg(dev, state, "completing class "); | |
675 | if (dev->class->pm->complete) | |
676 | dev->class->pm->complete(dev); | |
677 | } else if (dev->bus && dev->bus->pm) { | |
1eede070 | 678 | pm_dev_dbg(dev, state, "completing "); |
9659cc06 RW |
679 | if (dev->bus->pm->complete) |
680 | dev->bus->pm->complete(dev); | |
1eede070 RW |
681 | } |
682 | ||
8e9394ce | 683 | device_unlock(dev); |
1eede070 RW |
684 | } |
685 | ||
686 | /** | |
20d652d7 RW |
687 | * dpm_complete - Complete a PM transition for all non-sysdev devices. |
688 | * @state: PM transition of the system being carried out. | |
775b64d2 | 689 | * |
20d652d7 RW |
690 | * Execute the ->complete() callbacks for all devices whose PM status is not |
691 | * DPM_ON (this allows new devices to be registered). | |
cd59abfc | 692 | */ |
91e7c75b | 693 | void dpm_complete(pm_message_t state) |
cd59abfc | 694 | { |
1eede070 RW |
695 | struct list_head list; |
696 | ||
91e7c75b RW |
697 | might_sleep(); |
698 | ||
1eede070 | 699 | INIT_LIST_HEAD(&list); |
cd59abfc | 700 | mutex_lock(&dpm_list_mtx); |
8a43a9ab RW |
701 | while (!list_empty(&dpm_prepared_list)) { |
702 | struct device *dev = to_device(dpm_prepared_list.prev); | |
cd59abfc | 703 | |
1eede070 | 704 | get_device(dev); |
f76b168b | 705 | dev->power.is_prepared = false; |
5b219a51 RW |
706 | list_move(&dev->power.entry, &list); |
707 | mutex_unlock(&dpm_list_mtx); | |
1eede070 | 708 | |
5b219a51 | 709 | device_complete(dev, state); |
1eede070 | 710 | |
5b219a51 | 711 | mutex_lock(&dpm_list_mtx); |
1eede070 | 712 | put_device(dev); |
cd59abfc | 713 | } |
1eede070 | 714 | list_splice(&list, &dpm_list); |
cd59abfc AS |
715 | mutex_unlock(&dpm_list_mtx); |
716 | } | |
717 | ||
cd59abfc | 718 | /** |
20d652d7 RW |
719 | * dpm_resume_end - Execute "resume" callbacks and complete system transition. |
720 | * @state: PM transition of the system being carried out. | |
cd59abfc | 721 | * |
20d652d7 RW |
722 | * Execute "resume" callbacks for all devices and complete the PM transition of |
723 | * the system. | |
cd59abfc | 724 | */ |
d1616302 | 725 | void dpm_resume_end(pm_message_t state) |
cd59abfc | 726 | { |
1eede070 RW |
727 | dpm_resume(state); |
728 | dpm_complete(state); | |
cd59abfc | 729 | } |
d1616302 | 730 | EXPORT_SYMBOL_GPL(dpm_resume_end); |
cd59abfc AS |
731 | |
732 | ||
733 | /*------------------------- Suspend routines -------------------------*/ | |
734 | ||
1eede070 | 735 | /** |
20d652d7 RW |
736 | * resume_event - Return a "resume" message for given "suspend" sleep state. |
737 | * @sleep_state: PM message representing a sleep state. | |
738 | * | |
739 | * Return a PM message representing the resume event corresponding to given | |
740 | * sleep state. | |
1eede070 RW |
741 | */ |
742 | static pm_message_t resume_event(pm_message_t sleep_state) | |
cd59abfc | 743 | { |
1eede070 RW |
744 | switch (sleep_state.event) { |
745 | case PM_EVENT_SUSPEND: | |
746 | return PMSG_RESUME; | |
747 | case PM_EVENT_FREEZE: | |
748 | case PM_EVENT_QUIESCE: | |
749 | return PMSG_RECOVER; | |
750 | case PM_EVENT_HIBERNATE: | |
751 | return PMSG_RESTORE; | |
cd59abfc | 752 | } |
1eede070 | 753 | return PMSG_ON; |
cd59abfc AS |
754 | } |
755 | ||
756 | /** | |
20d652d7 RW |
757 | * device_suspend_noirq - Execute a "late suspend" callback for given device. |
758 | * @dev: Device to handle. | |
759 | * @state: PM transition of the system being carried out. | |
775b64d2 | 760 | * |
20d652d7 RW |
761 | * The driver of @dev will not receive interrupts while this function is being |
762 | * executed. | |
cd59abfc | 763 | */ |
d1616302 | 764 | static int device_suspend_noirq(struct device *dev, pm_message_t state) |
775b64d2 | 765 | { |
64e94aaf | 766 | int error = 0; |
e7176a37 | 767 | |
564b905a | 768 | if (dev->pm_domain) { |
4d27e9dc | 769 | pm_dev_dbg(dev, state, "LATE power domain "); |
564b905a | 770 | error = pm_noirq_op(dev, &dev->pm_domain->ops, state); |
4d27e9dc | 771 | } else if (dev->type && dev->type->pm) { |
e7176a37 DB |
772 | pm_dev_dbg(dev, state, "LATE type "); |
773 | error = pm_noirq_op(dev, dev->type->pm, state); | |
9659cc06 RW |
774 | } else if (dev->class && dev->class->pm) { |
775 | pm_dev_dbg(dev, state, "LATE class "); | |
776 | error = pm_noirq_op(dev, dev->class->pm, state); | |
9659cc06 | 777 | } else if (dev->bus && dev->bus->pm) { |
1eede070 RW |
778 | pm_dev_dbg(dev, state, "LATE "); |
779 | error = pm_noirq_op(dev, dev->bus->pm, state); | |
7538e3db RW |
780 | } |
781 | ||
64e94aaf | 782 | return error; |
775b64d2 RW |
783 | } |
784 | ||
785 | /** | |
20d652d7 RW |
786 | * dpm_suspend_noirq - Execute "late suspend" callbacks for non-sysdev devices. |
787 | * @state: PM transition of the system being carried out. | |
775b64d2 | 788 | * |
20d652d7 RW |
789 | * Prevent device drivers from receiving interrupts and call the "noirq" suspend |
790 | * handlers for all non-sysdev devices. | |
775b64d2 | 791 | */ |
d1616302 | 792 | int dpm_suspend_noirq(pm_message_t state) |
775b64d2 | 793 | { |
ecf762b2 | 794 | ktime_t starttime = ktime_get(); |
775b64d2 RW |
795 | int error = 0; |
796 | ||
2ed8d2b3 | 797 | suspend_device_irqs(); |
32bdfac5 | 798 | mutex_lock(&dpm_list_mtx); |
8a43a9ab RW |
799 | while (!list_empty(&dpm_suspended_list)) { |
800 | struct device *dev = to_device(dpm_suspended_list.prev); | |
d08a5ace RW |
801 | |
802 | get_device(dev); | |
803 | mutex_unlock(&dpm_list_mtx); | |
804 | ||
d1616302 | 805 | error = device_suspend_noirq(dev, state); |
d08a5ace RW |
806 | |
807 | mutex_lock(&dpm_list_mtx); | |
775b64d2 | 808 | if (error) { |
1eede070 | 809 | pm_dev_err(dev, state, " late", error); |
2a77c46d SL |
810 | suspend_stats.failed_suspend_noirq++; |
811 | dpm_save_failed_step(SUSPEND_SUSPEND_NOIRQ); | |
812 | dpm_save_failed_dev(dev_name(dev)); | |
d08a5ace | 813 | put_device(dev); |
775b64d2 RW |
814 | break; |
815 | } | |
d08a5ace | 816 | if (!list_empty(&dev->power.entry)) |
8a43a9ab | 817 | list_move(&dev->power.entry, &dpm_noirq_list); |
d08a5ace | 818 | put_device(dev); |
775b64d2 | 819 | } |
32bdfac5 | 820 | mutex_unlock(&dpm_list_mtx); |
775b64d2 | 821 | if (error) |
d1616302 | 822 | dpm_resume_noirq(resume_event(state)); |
ecf762b2 RW |
823 | else |
824 | dpm_show_time(starttime, state, "late"); | |
775b64d2 RW |
825 | return error; |
826 | } | |
d1616302 | 827 | EXPORT_SYMBOL_GPL(dpm_suspend_noirq); |
775b64d2 | 828 | |
875ab0b7 RW |
829 | /** |
830 | * legacy_suspend - Execute a legacy (bus or class) suspend callback for device. | |
0a884223 RD |
831 | * @dev: Device to suspend. |
832 | * @state: PM transition of the system being carried out. | |
833 | * @cb: Suspend callback to execute. | |
875ab0b7 RW |
834 | */ |
835 | static int legacy_suspend(struct device *dev, pm_message_t state, | |
836 | int (*cb)(struct device *dev, pm_message_t state)) | |
837 | { | |
838 | int error; | |
839 | ktime_t calltime; | |
840 | ||
841 | calltime = initcall_debug_start(dev); | |
842 | ||
843 | error = cb(dev, state); | |
844 | suspend_report_result(cb, error); | |
845 | ||
846 | initcall_debug_report(dev, calltime, error); | |
847 | ||
848 | return error; | |
849 | } | |
850 | ||
775b64d2 | 851 | /** |
20d652d7 RW |
852 | * device_suspend - Execute "suspend" callbacks for given device. |
853 | * @dev: Device to handle. | |
854 | * @state: PM transition of the system being carried out. | |
5af84b82 | 855 | * @async: If true, the device is being suspended asynchronously. |
775b64d2 | 856 | */ |
5af84b82 | 857 | static int __device_suspend(struct device *dev, pm_message_t state, bool async) |
cd59abfc AS |
858 | { |
859 | int error = 0; | |
860 | ||
5af84b82 | 861 | dpm_wait_for_children(dev, async); |
7a8d37a3 | 862 | |
5af84b82 | 863 | if (async_error) |
1e2ef05b RW |
864 | return 0; |
865 | ||
866 | pm_runtime_get_noresume(dev); | |
867 | if (pm_runtime_barrier(dev) && device_may_wakeup(dev)) | |
868 | pm_wakeup_event(dev, 0); | |
5af84b82 | 869 | |
d83f905e | 870 | if (pm_wakeup_pending()) { |
1e2ef05b | 871 | pm_runtime_put_sync(dev); |
d83f905e | 872 | async_error = -EBUSY; |
1e2ef05b | 873 | return 0; |
d83f905e RW |
874 | } |
875 | ||
1e2ef05b RW |
876 | device_lock(dev); |
877 | ||
564b905a | 878 | if (dev->pm_domain) { |
4d27e9dc | 879 | pm_dev_dbg(dev, state, "power domain "); |
564b905a | 880 | error = pm_op(dev, &dev->pm_domain->ops, state); |
4d27e9dc RW |
881 | goto End; |
882 | } | |
883 | ||
9659cc06 RW |
884 | if (dev->type && dev->type->pm) { |
885 | pm_dev_dbg(dev, state, "type "); | |
886 | error = pm_op(dev, dev->type->pm, state); | |
4d27e9dc | 887 | goto End; |
9659cc06 RW |
888 | } |
889 | ||
1eede070 RW |
890 | if (dev->class) { |
891 | if (dev->class->pm) { | |
892 | pm_dev_dbg(dev, state, "class "); | |
893 | error = pm_op(dev, dev->class->pm, state); | |
4d27e9dc | 894 | goto End; |
1eede070 RW |
895 | } else if (dev->class->suspend) { |
896 | pm_dev_dbg(dev, state, "legacy class "); | |
875ab0b7 | 897 | error = legacy_suspend(dev, state, dev->class->suspend); |
4d27e9dc | 898 | goto End; |
1eede070 | 899 | } |
cd59abfc AS |
900 | } |
901 | ||
1eede070 RW |
902 | if (dev->bus) { |
903 | if (dev->bus->pm) { | |
904 | pm_dev_dbg(dev, state, ""); | |
adf09493 | 905 | error = pm_op(dev, dev->bus->pm, state); |
1eede070 RW |
906 | } else if (dev->bus->suspend) { |
907 | pm_dev_dbg(dev, state, "legacy "); | |
875ab0b7 | 908 | error = legacy_suspend(dev, state, dev->bus->suspend); |
1eede070 | 909 | } |
7538e3db RW |
910 | } |
911 | ||
1eede070 | 912 | End: |
4ca46ff3 RW |
913 | if (!error) { |
914 | dev->power.is_suspended = true; | |
8b258cc8 RW |
915 | if (dev->power.wakeup_path |
916 | && dev->parent && !dev->parent->power.ignore_children) | |
4ca46ff3 RW |
917 | dev->parent->power.wakeup_path = true; |
918 | } | |
6d0e0e84 | 919 | |
8e9394ce | 920 | device_unlock(dev); |
5af84b82 | 921 | complete_all(&dev->power.completion); |
7a8d37a3 | 922 | |
1e2ef05b RW |
923 | if (error) { |
924 | pm_runtime_put_sync(dev); | |
098dff73 | 925 | async_error = error; |
1e2ef05b RW |
926 | } else if (dev->power.is_suspended) { |
927 | __pm_runtime_disable(dev, false); | |
928 | } | |
098dff73 | 929 | |
cd59abfc AS |
930 | return error; |
931 | } | |
932 | ||
5af84b82 RW |
933 | static void async_suspend(void *data, async_cookie_t cookie) |
934 | { | |
935 | struct device *dev = (struct device *)data; | |
936 | int error; | |
937 | ||
938 | error = __device_suspend(dev, pm_transition, true); | |
2a77c46d SL |
939 | if (error) { |
940 | dpm_save_failed_dev(dev_name(dev)); | |
5af84b82 | 941 | pm_dev_err(dev, pm_transition, " async", error); |
2a77c46d | 942 | } |
5af84b82 RW |
943 | |
944 | put_device(dev); | |
945 | } | |
946 | ||
947 | static int device_suspend(struct device *dev) | |
948 | { | |
949 | INIT_COMPLETION(dev->power.completion); | |
950 | ||
0e06b4a8 | 951 | if (pm_async_enabled && dev->power.async_suspend) { |
5af84b82 RW |
952 | get_device(dev); |
953 | async_schedule(async_suspend, dev); | |
954 | return 0; | |
955 | } | |
956 | ||
957 | return __device_suspend(dev, pm_transition, false); | |
958 | } | |
959 | ||
cd59abfc | 960 | /** |
20d652d7 RW |
961 | * dpm_suspend - Execute "suspend" callbacks for all non-sysdev devices. |
962 | * @state: PM transition of the system being carried out. | |
cd59abfc | 963 | */ |
91e7c75b | 964 | int dpm_suspend(pm_message_t state) |
cd59abfc | 965 | { |
ecf762b2 | 966 | ktime_t starttime = ktime_get(); |
cd59abfc AS |
967 | int error = 0; |
968 | ||
91e7c75b RW |
969 | might_sleep(); |
970 | ||
cd59abfc | 971 | mutex_lock(&dpm_list_mtx); |
5af84b82 RW |
972 | pm_transition = state; |
973 | async_error = 0; | |
8a43a9ab RW |
974 | while (!list_empty(&dpm_prepared_list)) { |
975 | struct device *dev = to_device(dpm_prepared_list.prev); | |
58aca232 | 976 | |
1eede070 | 977 | get_device(dev); |
cd59abfc | 978 | mutex_unlock(&dpm_list_mtx); |
1eede070 | 979 | |
5af84b82 | 980 | error = device_suspend(dev); |
1eede070 | 981 | |
1b3cbec1 | 982 | mutex_lock(&dpm_list_mtx); |
775b64d2 | 983 | if (error) { |
1eede070 | 984 | pm_dev_err(dev, state, "", error); |
2a77c46d | 985 | dpm_save_failed_dev(dev_name(dev)); |
1eede070 | 986 | put_device(dev); |
775b64d2 RW |
987 | break; |
988 | } | |
7a8d37a3 | 989 | if (!list_empty(&dev->power.entry)) |
8a43a9ab | 990 | list_move(&dev->power.entry, &dpm_suspended_list); |
1eede070 | 991 | put_device(dev); |
5af84b82 RW |
992 | if (async_error) |
993 | break; | |
cd59abfc AS |
994 | } |
995 | mutex_unlock(&dpm_list_mtx); | |
5af84b82 RW |
996 | async_synchronize_full(); |
997 | if (!error) | |
998 | error = async_error; | |
2a77c46d SL |
999 | if (error) { |
1000 | suspend_stats.failed_suspend++; | |
1001 | dpm_save_failed_step(SUSPEND_SUSPEND); | |
1002 | } else | |
ecf762b2 | 1003 | dpm_show_time(starttime, state, NULL); |
1eede070 RW |
1004 | return error; |
1005 | } | |
1006 | ||
1007 | /** | |
20d652d7 RW |
1008 | * device_prepare - Prepare a device for system power transition. |
1009 | * @dev: Device to handle. | |
1010 | * @state: PM transition of the system being carried out. | |
1011 | * | |
1012 | * Execute the ->prepare() callback(s) for given device. No new children of the | |
1013 | * device may be registered after this function has returned. | |
1eede070 | 1014 | */ |
d1616302 | 1015 | static int device_prepare(struct device *dev, pm_message_t state) |
1eede070 RW |
1016 | { |
1017 | int error = 0; | |
1018 | ||
8e9394ce | 1019 | device_lock(dev); |
1eede070 | 1020 | |
4ca46ff3 RW |
1021 | dev->power.wakeup_path = device_may_wakeup(dev); |
1022 | ||
564b905a | 1023 | if (dev->pm_domain) { |
4d27e9dc | 1024 | pm_dev_dbg(dev, state, "preparing power domain "); |
564b905a RW |
1025 | if (dev->pm_domain->ops.prepare) |
1026 | error = dev->pm_domain->ops.prepare(dev); | |
1027 | suspend_report_result(dev->pm_domain->ops.prepare, error); | |
4d27e9dc | 1028 | } else if (dev->type && dev->type->pm) { |
1eede070 | 1029 | pm_dev_dbg(dev, state, "preparing type "); |
9659cc06 RW |
1030 | if (dev->type->pm->prepare) |
1031 | error = dev->type->pm->prepare(dev); | |
1eede070 | 1032 | suspend_report_result(dev->type->pm->prepare, error); |
9659cc06 | 1033 | } else if (dev->class && dev->class->pm) { |
1eede070 | 1034 | pm_dev_dbg(dev, state, "preparing class "); |
9659cc06 RW |
1035 | if (dev->class->pm->prepare) |
1036 | error = dev->class->pm->prepare(dev); | |
1eede070 | 1037 | suspend_report_result(dev->class->pm->prepare, error); |
9659cc06 RW |
1038 | } else if (dev->bus && dev->bus->pm) { |
1039 | pm_dev_dbg(dev, state, "preparing "); | |
1040 | if (dev->bus->pm->prepare) | |
1041 | error = dev->bus->pm->prepare(dev); | |
1042 | suspend_report_result(dev->bus->pm->prepare, error); | |
1eede070 | 1043 | } |
7538e3db | 1044 | |
8e9394ce | 1045 | device_unlock(dev); |
1eede070 RW |
1046 | |
1047 | return error; | |
1048 | } | |
cd59abfc | 1049 | |
1eede070 | 1050 | /** |
20d652d7 RW |
1051 | * dpm_prepare - Prepare all non-sysdev devices for a system PM transition. |
1052 | * @state: PM transition of the system being carried out. | |
1eede070 | 1053 | * |
20d652d7 | 1054 | * Execute the ->prepare() callback(s) for all devices. |
1eede070 | 1055 | */ |
91e7c75b | 1056 | int dpm_prepare(pm_message_t state) |
1eede070 | 1057 | { |
1eede070 RW |
1058 | int error = 0; |
1059 | ||
91e7c75b RW |
1060 | might_sleep(); |
1061 | ||
1eede070 | 1062 | mutex_lock(&dpm_list_mtx); |
1eede070 RW |
1063 | while (!list_empty(&dpm_list)) { |
1064 | struct device *dev = to_device(dpm_list.next); | |
1065 | ||
1066 | get_device(dev); | |
1eede070 RW |
1067 | mutex_unlock(&dpm_list_mtx); |
1068 | ||
1e2ef05b | 1069 | error = device_prepare(dev, state); |
1eede070 RW |
1070 | |
1071 | mutex_lock(&dpm_list_mtx); | |
1072 | if (error) { | |
1eede070 RW |
1073 | if (error == -EAGAIN) { |
1074 | put_device(dev); | |
886a7a33 | 1075 | error = 0; |
1eede070 RW |
1076 | continue; |
1077 | } | |
1e75227e RW |
1078 | printk(KERN_INFO "PM: Device %s not prepared " |
1079 | "for power transition: code %d\n", | |
5c1a07ab | 1080 | dev_name(dev), error); |
1eede070 RW |
1081 | put_device(dev); |
1082 | break; | |
1083 | } | |
f76b168b | 1084 | dev->power.is_prepared = true; |
1eede070 | 1085 | if (!list_empty(&dev->power.entry)) |
8a43a9ab | 1086 | list_move_tail(&dev->power.entry, &dpm_prepared_list); |
1eede070 RW |
1087 | put_device(dev); |
1088 | } | |
1eede070 | 1089 | mutex_unlock(&dpm_list_mtx); |
cd59abfc AS |
1090 | return error; |
1091 | } | |
1092 | ||
775b64d2 | 1093 | /** |
20d652d7 RW |
1094 | * dpm_suspend_start - Prepare devices for PM transition and suspend them. |
1095 | * @state: PM transition of the system being carried out. | |
775b64d2 | 1096 | * |
20d652d7 RW |
1097 | * Prepare all non-sysdev devices for system PM transition and execute "suspend" |
1098 | * callbacks for them. | |
775b64d2 | 1099 | */ |
d1616302 | 1100 | int dpm_suspend_start(pm_message_t state) |
775b64d2 RW |
1101 | { |
1102 | int error; | |
cd59abfc | 1103 | |
1eede070 | 1104 | error = dpm_prepare(state); |
2a77c46d SL |
1105 | if (error) { |
1106 | suspend_stats.failed_prepare++; | |
1107 | dpm_save_failed_step(SUSPEND_PREPARE); | |
1108 | } else | |
1eede070 | 1109 | error = dpm_suspend(state); |
cd59abfc | 1110 | return error; |
cd59abfc | 1111 | } |
d1616302 | 1112 | EXPORT_SYMBOL_GPL(dpm_suspend_start); |
cd59abfc AS |
1113 | |
1114 | void __suspend_report_result(const char *function, void *fn, int ret) | |
1115 | { | |
c80cfb04 BH |
1116 | if (ret) |
1117 | printk(KERN_ERR "%s(): %pF returns %d\n", function, fn, ret); | |
cd59abfc AS |
1118 | } |
1119 | EXPORT_SYMBOL_GPL(__suspend_report_result); | |
f8824cee RW |
1120 | |
1121 | /** | |
1122 | * device_pm_wait_for_dev - Wait for suspend/resume of a device to complete. | |
1123 | * @dev: Device to wait for. | |
1124 | * @subordinate: Device that needs to wait for @dev. | |
1125 | */ | |
098dff73 | 1126 | int device_pm_wait_for_dev(struct device *subordinate, struct device *dev) |
f8824cee RW |
1127 | { |
1128 | dpm_wait(dev, subordinate->power.async_suspend); | |
098dff73 | 1129 | return async_error; |
f8824cee RW |
1130 | } |
1131 | EXPORT_SYMBOL_GPL(device_pm_wait_for_dev); |