]>
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. | |
11 | * This will intialize the embedded device_pm_info object in the device | |
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> |
11048dcf | 22 | #include <linux/mutex.h> |
cd59abfc | 23 | #include <linux/pm.h> |
5e928f77 | 24 | #include <linux/pm_runtime.h> |
cd59abfc | 25 | #include <linux/resume-trace.h> |
2ed8d2b3 | 26 | #include <linux/interrupt.h> |
f2511774 | 27 | #include <linux/sched.h> |
11048dcf | 28 | |
cd59abfc | 29 | #include "../base.h" |
1da177e4 LT |
30 | #include "power.h" |
31 | ||
775b64d2 | 32 | /* |
1eede070 | 33 | * The entries in the dpm_list list are in a depth first order, simply |
775b64d2 RW |
34 | * because children are guaranteed to be discovered after parents, and |
35 | * are inserted at the back of the list on discovery. | |
36 | * | |
775b64d2 RW |
37 | * Since device_pm_add() may be called with a device semaphore held, |
38 | * we must never try to acquire a device semaphore while holding | |
39 | * dpm_list_mutex. | |
40 | */ | |
41 | ||
1eede070 | 42 | LIST_HEAD(dpm_list); |
1da177e4 | 43 | |
cd59abfc | 44 | static DEFINE_MUTEX(dpm_list_mtx); |
1da177e4 | 45 | |
1eede070 RW |
46 | /* |
47 | * Set once the preparation of devices for a PM transition has started, reset | |
48 | * before starting to resume devices. Protected by dpm_list_mtx. | |
49 | */ | |
50 | static bool transition_started; | |
51 | ||
5e928f77 | 52 | /** |
20d652d7 | 53 | * device_pm_init - Initialize the PM-related part of a device object. |
5e928f77 RW |
54 | * @dev: Device object being initialized. |
55 | */ | |
56 | void device_pm_init(struct device *dev) | |
57 | { | |
58 | dev->power.status = DPM_ON; | |
59 | pm_runtime_init(dev); | |
60 | } | |
61 | ||
1eede070 | 62 | /** |
20d652d7 | 63 | * device_pm_lock - Lock the list of active devices used by the PM core. |
1eede070 RW |
64 | */ |
65 | void device_pm_lock(void) | |
66 | { | |
67 | mutex_lock(&dpm_list_mtx); | |
68 | } | |
69 | ||
70 | /** | |
20d652d7 | 71 | * device_pm_unlock - Unlock the list of active devices used by the PM core. |
1eede070 RW |
72 | */ |
73 | void device_pm_unlock(void) | |
74 | { | |
75 | mutex_unlock(&dpm_list_mtx); | |
76 | } | |
075c1771 | 77 | |
775b64d2 | 78 | /** |
20d652d7 RW |
79 | * device_pm_add - Add a device to the PM core's list of active devices. |
80 | * @dev: Device to add to the list. | |
775b64d2 | 81 | */ |
3b98aeaf | 82 | void device_pm_add(struct device *dev) |
1da177e4 | 83 | { |
1da177e4 | 84 | pr_debug("PM: Adding info for %s:%s\n", |
c48ea603 DT |
85 | dev->bus ? dev->bus->name : "No Bus", |
86 | kobject_name(&dev->kobj)); | |
11048dcf | 87 | mutex_lock(&dpm_list_mtx); |
1eede070 | 88 | if (dev->parent) { |
f5a6d958 RW |
89 | if (dev->parent->power.status >= DPM_SUSPENDING) |
90 | dev_warn(dev, "parent %s should not be sleeping\n", | |
1e0b2cf9 | 91 | dev_name(dev->parent)); |
1eede070 RW |
92 | } else if (transition_started) { |
93 | /* | |
94 | * We refuse to register parentless devices while a PM | |
95 | * transition is in progress in order to avoid leaving them | |
96 | * unhandled down the road | |
97 | */ | |
728f0893 | 98 | dev_WARN(dev, "Parentless device registered during a PM transaction\n"); |
58aca232 | 99 | } |
3b98aeaf AS |
100 | |
101 | list_add_tail(&dev->power.entry, &dpm_list); | |
11048dcf | 102 | mutex_unlock(&dpm_list_mtx); |
1da177e4 LT |
103 | } |
104 | ||
775b64d2 | 105 | /** |
20d652d7 RW |
106 | * device_pm_remove - Remove a device from the PM core's list of active devices. |
107 | * @dev: Device to be removed from the list. | |
775b64d2 | 108 | */ |
9cddad77 | 109 | void device_pm_remove(struct device *dev) |
1da177e4 LT |
110 | { |
111 | pr_debug("PM: Removing info for %s:%s\n", | |
c48ea603 DT |
112 | dev->bus ? dev->bus->name : "No Bus", |
113 | kobject_name(&dev->kobj)); | |
11048dcf | 114 | mutex_lock(&dpm_list_mtx); |
1da177e4 | 115 | list_del_init(&dev->power.entry); |
11048dcf | 116 | mutex_unlock(&dpm_list_mtx); |
5e928f77 | 117 | pm_runtime_remove(dev); |
775b64d2 RW |
118 | } |
119 | ||
ffa6a705 | 120 | /** |
20d652d7 RW |
121 | * device_pm_move_before - Move device in the PM core's list of active devices. |
122 | * @deva: Device to move in dpm_list. | |
123 | * @devb: Device @deva should come before. | |
ffa6a705 CH |
124 | */ |
125 | void device_pm_move_before(struct device *deva, struct device *devb) | |
126 | { | |
127 | pr_debug("PM: Moving %s:%s before %s:%s\n", | |
128 | deva->bus ? deva->bus->name : "No Bus", | |
129 | kobject_name(&deva->kobj), | |
130 | devb->bus ? devb->bus->name : "No Bus", | |
131 | kobject_name(&devb->kobj)); | |
132 | /* Delete deva from dpm_list and reinsert before devb. */ | |
133 | list_move_tail(&deva->power.entry, &devb->power.entry); | |
134 | } | |
135 | ||
136 | /** | |
20d652d7 RW |
137 | * device_pm_move_after - Move device in the PM core's list of active devices. |
138 | * @deva: Device to move in dpm_list. | |
139 | * @devb: Device @deva should come after. | |
ffa6a705 CH |
140 | */ |
141 | void device_pm_move_after(struct device *deva, struct device *devb) | |
142 | { | |
143 | pr_debug("PM: Moving %s:%s after %s:%s\n", | |
144 | deva->bus ? deva->bus->name : "No Bus", | |
145 | kobject_name(&deva->kobj), | |
146 | devb->bus ? devb->bus->name : "No Bus", | |
147 | kobject_name(&devb->kobj)); | |
148 | /* Delete deva from dpm_list and reinsert after devb. */ | |
149 | list_move(&deva->power.entry, &devb->power.entry); | |
150 | } | |
151 | ||
152 | /** | |
20d652d7 RW |
153 | * device_pm_move_last - Move device to end of the PM core's list of devices. |
154 | * @dev: Device to move in dpm_list. | |
ffa6a705 CH |
155 | */ |
156 | void device_pm_move_last(struct device *dev) | |
157 | { | |
158 | pr_debug("PM: Moving %s:%s to end of list\n", | |
159 | dev->bus ? dev->bus->name : "No Bus", | |
160 | kobject_name(&dev->kobj)); | |
161 | list_move_tail(&dev->power.entry, &dpm_list); | |
162 | } | |
163 | ||
1eede070 | 164 | /** |
20d652d7 RW |
165 | * pm_op - Execute the PM operation appropriate for given PM event. |
166 | * @dev: Device to handle. | |
167 | * @ops: PM operations to choose from. | |
168 | * @state: PM transition of the system being carried out. | |
1eede070 | 169 | */ |
d9ab7716 DT |
170 | static int pm_op(struct device *dev, |
171 | const struct dev_pm_ops *ops, | |
172 | pm_message_t state) | |
1eede070 RW |
173 | { |
174 | int error = 0; | |
f2511774 AV |
175 | ktime_t calltime, delta, rettime; |
176 | ||
177 | if (initcall_debug) { | |
178 | pr_info("calling %s+ @ %i\n", | |
179 | dev_name(dev), task_pid_nr(current)); | |
180 | calltime = ktime_get(); | |
181 | } | |
1eede070 RW |
182 | |
183 | switch (state.event) { | |
184 | #ifdef CONFIG_SUSPEND | |
185 | case PM_EVENT_SUSPEND: | |
186 | if (ops->suspend) { | |
187 | error = ops->suspend(dev); | |
188 | suspend_report_result(ops->suspend, error); | |
189 | } | |
190 | break; | |
191 | case PM_EVENT_RESUME: | |
192 | if (ops->resume) { | |
193 | error = ops->resume(dev); | |
194 | suspend_report_result(ops->resume, error); | |
195 | } | |
196 | break; | |
197 | #endif /* CONFIG_SUSPEND */ | |
198 | #ifdef CONFIG_HIBERNATION | |
199 | case PM_EVENT_FREEZE: | |
200 | case PM_EVENT_QUIESCE: | |
201 | if (ops->freeze) { | |
202 | error = ops->freeze(dev); | |
203 | suspend_report_result(ops->freeze, error); | |
204 | } | |
205 | break; | |
206 | case PM_EVENT_HIBERNATE: | |
207 | if (ops->poweroff) { | |
208 | error = ops->poweroff(dev); | |
209 | suspend_report_result(ops->poweroff, error); | |
210 | } | |
211 | break; | |
212 | case PM_EVENT_THAW: | |
213 | case PM_EVENT_RECOVER: | |
214 | if (ops->thaw) { | |
215 | error = ops->thaw(dev); | |
216 | suspend_report_result(ops->thaw, error); | |
217 | } | |
218 | break; | |
219 | case PM_EVENT_RESTORE: | |
220 | if (ops->restore) { | |
221 | error = ops->restore(dev); | |
222 | suspend_report_result(ops->restore, error); | |
223 | } | |
224 | break; | |
225 | #endif /* CONFIG_HIBERNATION */ | |
226 | default: | |
227 | error = -EINVAL; | |
228 | } | |
f2511774 AV |
229 | |
230 | if (initcall_debug) { | |
231 | rettime = ktime_get(); | |
232 | delta = ktime_sub(rettime, calltime); | |
233 | pr_info("call %s+ returned %d after %Ld usecs\n", dev_name(dev), | |
234 | error, (unsigned long long)ktime_to_ns(delta) >> 10); | |
235 | } | |
236 | ||
1eede070 RW |
237 | return error; |
238 | } | |
239 | ||
240 | /** | |
20d652d7 RW |
241 | * pm_noirq_op - Execute the PM operation appropriate for given PM event. |
242 | * @dev: Device to handle. | |
243 | * @ops: PM operations to choose from. | |
244 | * @state: PM transition of the system being carried out. | |
1eede070 | 245 | * |
20d652d7 RW |
246 | * The driver of @dev will not receive interrupts while this function is being |
247 | * executed. | |
1eede070 | 248 | */ |
d9ab7716 DT |
249 | static int pm_noirq_op(struct device *dev, |
250 | const struct dev_pm_ops *ops, | |
1eede070 RW |
251 | pm_message_t state) |
252 | { | |
253 | int error = 0; | |
f2511774 AV |
254 | ktime_t calltime, delta, rettime; |
255 | ||
256 | if (initcall_debug) { | |
257 | pr_info("calling %s_i+ @ %i\n", | |
258 | dev_name(dev), task_pid_nr(current)); | |
259 | calltime = ktime_get(); | |
260 | } | |
1eede070 RW |
261 | |
262 | switch (state.event) { | |
263 | #ifdef CONFIG_SUSPEND | |
264 | case PM_EVENT_SUSPEND: | |
265 | if (ops->suspend_noirq) { | |
266 | error = ops->suspend_noirq(dev); | |
267 | suspend_report_result(ops->suspend_noirq, error); | |
268 | } | |
269 | break; | |
270 | case PM_EVENT_RESUME: | |
271 | if (ops->resume_noirq) { | |
272 | error = ops->resume_noirq(dev); | |
273 | suspend_report_result(ops->resume_noirq, error); | |
274 | } | |
275 | break; | |
276 | #endif /* CONFIG_SUSPEND */ | |
277 | #ifdef CONFIG_HIBERNATION | |
278 | case PM_EVENT_FREEZE: | |
279 | case PM_EVENT_QUIESCE: | |
280 | if (ops->freeze_noirq) { | |
281 | error = ops->freeze_noirq(dev); | |
282 | suspend_report_result(ops->freeze_noirq, error); | |
283 | } | |
284 | break; | |
285 | case PM_EVENT_HIBERNATE: | |
286 | if (ops->poweroff_noirq) { | |
287 | error = ops->poweroff_noirq(dev); | |
288 | suspend_report_result(ops->poweroff_noirq, error); | |
289 | } | |
290 | break; | |
291 | case PM_EVENT_THAW: | |
292 | case PM_EVENT_RECOVER: | |
293 | if (ops->thaw_noirq) { | |
294 | error = ops->thaw_noirq(dev); | |
295 | suspend_report_result(ops->thaw_noirq, error); | |
296 | } | |
297 | break; | |
298 | case PM_EVENT_RESTORE: | |
299 | if (ops->restore_noirq) { | |
300 | error = ops->restore_noirq(dev); | |
301 | suspend_report_result(ops->restore_noirq, error); | |
302 | } | |
303 | break; | |
304 | #endif /* CONFIG_HIBERNATION */ | |
305 | default: | |
306 | error = -EINVAL; | |
307 | } | |
f2511774 AV |
308 | |
309 | if (initcall_debug) { | |
310 | rettime = ktime_get(); | |
311 | delta = ktime_sub(rettime, calltime); | |
312 | printk("initcall %s_i+ returned %d after %Ld usecs\n", dev_name(dev), | |
313 | error, (unsigned long long)ktime_to_ns(delta) >> 10); | |
314 | } | |
315 | ||
1eede070 RW |
316 | return error; |
317 | } | |
318 | ||
319 | static char *pm_verb(int event) | |
320 | { | |
321 | switch (event) { | |
322 | case PM_EVENT_SUSPEND: | |
323 | return "suspend"; | |
324 | case PM_EVENT_RESUME: | |
325 | return "resume"; | |
326 | case PM_EVENT_FREEZE: | |
327 | return "freeze"; | |
328 | case PM_EVENT_QUIESCE: | |
329 | return "quiesce"; | |
330 | case PM_EVENT_HIBERNATE: | |
331 | return "hibernate"; | |
332 | case PM_EVENT_THAW: | |
333 | return "thaw"; | |
334 | case PM_EVENT_RESTORE: | |
335 | return "restore"; | |
336 | case PM_EVENT_RECOVER: | |
337 | return "recover"; | |
338 | default: | |
339 | return "(unknown PM event)"; | |
340 | } | |
341 | } | |
342 | ||
343 | static void pm_dev_dbg(struct device *dev, pm_message_t state, char *info) | |
344 | { | |
345 | dev_dbg(dev, "%s%s%s\n", info, pm_verb(state.event), | |
346 | ((state.event & PM_EVENT_SLEEP) && device_may_wakeup(dev)) ? | |
347 | ", may wakeup" : ""); | |
348 | } | |
349 | ||
350 | static void pm_dev_err(struct device *dev, pm_message_t state, char *info, | |
351 | int error) | |
352 | { | |
353 | printk(KERN_ERR "PM: Device %s failed to %s%s: error %d\n", | |
354 | kobject_name(&dev->kobj), pm_verb(state.event), info, error); | |
355 | } | |
356 | ||
cd59abfc AS |
357 | /*------------------------- Resume routines -------------------------*/ |
358 | ||
359 | /** | |
20d652d7 RW |
360 | * device_resume_noirq - Execute an "early resume" callback for given device. |
361 | * @dev: Device to handle. | |
362 | * @state: PM transition of the system being carried out. | |
cd59abfc | 363 | * |
20d652d7 RW |
364 | * The driver of @dev will not receive interrupts while this function is being |
365 | * executed. | |
cd59abfc | 366 | */ |
d1616302 | 367 | static int device_resume_noirq(struct device *dev, pm_message_t state) |
cd59abfc AS |
368 | { |
369 | int error = 0; | |
370 | ||
371 | TRACE_DEVICE(dev); | |
372 | TRACE_RESUME(0); | |
373 | ||
33c33740 | 374 | if (dev->bus && dev->bus->pm) { |
1eede070 RW |
375 | pm_dev_dbg(dev, state, "EARLY "); |
376 | error = pm_noirq_op(dev, dev->bus->pm, state); | |
775b64d2 | 377 | } |
33c33740 | 378 | |
775b64d2 RW |
379 | TRACE_RESUME(error); |
380 | return error; | |
381 | } | |
382 | ||
383 | /** | |
20d652d7 RW |
384 | * dpm_resume_noirq - Execute "early resume" callbacks for non-sysdev devices. |
385 | * @state: PM transition of the system being carried out. | |
775b64d2 | 386 | * |
20d652d7 RW |
387 | * Call the "noirq" resume handlers for all devices marked as DPM_OFF_IRQ and |
388 | * enable device drivers to receive interrupts. | |
775b64d2 | 389 | */ |
d1616302 | 390 | void dpm_resume_noirq(pm_message_t state) |
775b64d2 | 391 | { |
1eede070 | 392 | struct device *dev; |
775b64d2 | 393 | |
32bdfac5 | 394 | mutex_lock(&dpm_list_mtx); |
3eb132c9 | 395 | transition_started = false; |
1eede070 RW |
396 | list_for_each_entry(dev, &dpm_list, power.entry) |
397 | if (dev->power.status > DPM_OFF) { | |
398 | int error; | |
775b64d2 | 399 | |
1eede070 | 400 | dev->power.status = DPM_OFF; |
d1616302 | 401 | error = device_resume_noirq(dev, state); |
1eede070 RW |
402 | if (error) |
403 | pm_dev_err(dev, state, " early", error); | |
404 | } | |
32bdfac5 | 405 | mutex_unlock(&dpm_list_mtx); |
2ed8d2b3 | 406 | resume_device_irqs(); |
775b64d2 | 407 | } |
d1616302 | 408 | EXPORT_SYMBOL_GPL(dpm_resume_noirq); |
775b64d2 RW |
409 | |
410 | /** | |
20d652d7 RW |
411 | * device_resume - Execute "resume" callbacks for given device. |
412 | * @dev: Device to handle. | |
413 | * @state: PM transition of the system being carried out. | |
775b64d2 | 414 | */ |
d1616302 | 415 | static int device_resume(struct device *dev, pm_message_t state) |
775b64d2 RW |
416 | { |
417 | int error = 0; | |
418 | ||
419 | TRACE_DEVICE(dev); | |
420 | TRACE_RESUME(0); | |
cd59abfc | 421 | |
7a8d37a3 RW |
422 | down(&dev->sem); |
423 | ||
1eede070 RW |
424 | if (dev->bus) { |
425 | if (dev->bus->pm) { | |
426 | pm_dev_dbg(dev, state, ""); | |
adf09493 | 427 | error = pm_op(dev, dev->bus->pm, state); |
1eede070 RW |
428 | } else if (dev->bus->resume) { |
429 | pm_dev_dbg(dev, state, "legacy "); | |
430 | error = dev->bus->resume(dev); | |
431 | } | |
432 | if (error) | |
433 | goto End; | |
cd59abfc AS |
434 | } |
435 | ||
1eede070 RW |
436 | if (dev->type) { |
437 | if (dev->type->pm) { | |
438 | pm_dev_dbg(dev, state, "type "); | |
439 | error = pm_op(dev, dev->type->pm, state); | |
1eede070 RW |
440 | } |
441 | if (error) | |
442 | goto End; | |
cd59abfc AS |
443 | } |
444 | ||
1eede070 RW |
445 | if (dev->class) { |
446 | if (dev->class->pm) { | |
447 | pm_dev_dbg(dev, state, "class "); | |
448 | error = pm_op(dev, dev->class->pm, state); | |
449 | } else if (dev->class->resume) { | |
450 | pm_dev_dbg(dev, state, "legacy class "); | |
451 | error = dev->class->resume(dev); | |
452 | } | |
cd59abfc | 453 | } |
1eede070 | 454 | End: |
7a8d37a3 RW |
455 | up(&dev->sem); |
456 | ||
cd59abfc AS |
457 | TRACE_RESUME(error); |
458 | return error; | |
459 | } | |
460 | ||
775b64d2 | 461 | /** |
20d652d7 RW |
462 | * dpm_resume - Execute "resume" callbacks for non-sysdev devices. |
463 | * @state: PM transition of the system being carried out. | |
775b64d2 | 464 | * |
20d652d7 RW |
465 | * Execute the appropriate "resume" callback for all devices whose status |
466 | * indicates that they are suspended. | |
1eede070 RW |
467 | */ |
468 | static void dpm_resume(pm_message_t state) | |
469 | { | |
470 | struct list_head list; | |
471 | ||
472 | INIT_LIST_HEAD(&list); | |
473 | mutex_lock(&dpm_list_mtx); | |
1eede070 RW |
474 | while (!list_empty(&dpm_list)) { |
475 | struct device *dev = to_device(dpm_list.next); | |
476 | ||
477 | get_device(dev); | |
478 | if (dev->power.status >= DPM_OFF) { | |
479 | int error; | |
480 | ||
481 | dev->power.status = DPM_RESUMING; | |
482 | mutex_unlock(&dpm_list_mtx); | |
483 | ||
d1616302 | 484 | error = device_resume(dev, state); |
1eede070 RW |
485 | |
486 | mutex_lock(&dpm_list_mtx); | |
487 | if (error) | |
488 | pm_dev_err(dev, state, "", error); | |
489 | } else if (dev->power.status == DPM_SUSPENDING) { | |
490 | /* Allow new children of the device to be registered */ | |
491 | dev->power.status = DPM_RESUMING; | |
492 | } | |
493 | if (!list_empty(&dev->power.entry)) | |
494 | list_move_tail(&dev->power.entry, &list); | |
495 | put_device(dev); | |
496 | } | |
497 | list_splice(&list, &dpm_list); | |
498 | mutex_unlock(&dpm_list_mtx); | |
499 | } | |
500 | ||
501 | /** | |
20d652d7 RW |
502 | * device_complete - Complete a PM transition for given device. |
503 | * @dev: Device to handle. | |
504 | * @state: PM transition of the system being carried out. | |
1eede070 | 505 | */ |
d1616302 | 506 | static void device_complete(struct device *dev, pm_message_t state) |
1eede070 RW |
507 | { |
508 | down(&dev->sem); | |
509 | ||
510 | if (dev->class && dev->class->pm && dev->class->pm->complete) { | |
511 | pm_dev_dbg(dev, state, "completing class "); | |
512 | dev->class->pm->complete(dev); | |
513 | } | |
514 | ||
515 | if (dev->type && dev->type->pm && dev->type->pm->complete) { | |
516 | pm_dev_dbg(dev, state, "completing type "); | |
517 | dev->type->pm->complete(dev); | |
518 | } | |
519 | ||
adf09493 | 520 | if (dev->bus && dev->bus->pm && dev->bus->pm->complete) { |
1eede070 | 521 | pm_dev_dbg(dev, state, "completing "); |
adf09493 | 522 | dev->bus->pm->complete(dev); |
1eede070 RW |
523 | } |
524 | ||
525 | up(&dev->sem); | |
526 | } | |
527 | ||
528 | /** | |
20d652d7 RW |
529 | * dpm_complete - Complete a PM transition for all non-sysdev devices. |
530 | * @state: PM transition of the system being carried out. | |
775b64d2 | 531 | * |
20d652d7 RW |
532 | * Execute the ->complete() callbacks for all devices whose PM status is not |
533 | * DPM_ON (this allows new devices to be registered). | |
cd59abfc | 534 | */ |
1eede070 | 535 | static void dpm_complete(pm_message_t state) |
cd59abfc | 536 | { |
1eede070 RW |
537 | struct list_head list; |
538 | ||
539 | INIT_LIST_HEAD(&list); | |
cd59abfc | 540 | mutex_lock(&dpm_list_mtx); |
e528e876 | 541 | transition_started = false; |
1eede070 RW |
542 | while (!list_empty(&dpm_list)) { |
543 | struct device *dev = to_device(dpm_list.prev); | |
cd59abfc | 544 | |
1eede070 RW |
545 | get_device(dev); |
546 | if (dev->power.status > DPM_ON) { | |
547 | dev->power.status = DPM_ON; | |
548 | mutex_unlock(&dpm_list_mtx); | |
549 | ||
d1616302 | 550 | device_complete(dev, state); |
5e928f77 | 551 | pm_runtime_put_noidle(dev); |
1eede070 RW |
552 | |
553 | mutex_lock(&dpm_list_mtx); | |
554 | } | |
555 | if (!list_empty(&dev->power.entry)) | |
556 | list_move(&dev->power.entry, &list); | |
557 | put_device(dev); | |
cd59abfc | 558 | } |
1eede070 | 559 | list_splice(&list, &dpm_list); |
cd59abfc AS |
560 | mutex_unlock(&dpm_list_mtx); |
561 | } | |
562 | ||
cd59abfc | 563 | /** |
20d652d7 RW |
564 | * dpm_resume_end - Execute "resume" callbacks and complete system transition. |
565 | * @state: PM transition of the system being carried out. | |
cd59abfc | 566 | * |
20d652d7 RW |
567 | * Execute "resume" callbacks for all devices and complete the PM transition of |
568 | * the system. | |
cd59abfc | 569 | */ |
d1616302 | 570 | void dpm_resume_end(pm_message_t state) |
cd59abfc | 571 | { |
775b64d2 | 572 | might_sleep(); |
1eede070 RW |
573 | dpm_resume(state); |
574 | dpm_complete(state); | |
cd59abfc | 575 | } |
d1616302 | 576 | EXPORT_SYMBOL_GPL(dpm_resume_end); |
cd59abfc AS |
577 | |
578 | ||
579 | /*------------------------- Suspend routines -------------------------*/ | |
580 | ||
1eede070 | 581 | /** |
20d652d7 RW |
582 | * resume_event - Return a "resume" message for given "suspend" sleep state. |
583 | * @sleep_state: PM message representing a sleep state. | |
584 | * | |
585 | * Return a PM message representing the resume event corresponding to given | |
586 | * sleep state. | |
1eede070 RW |
587 | */ |
588 | static pm_message_t resume_event(pm_message_t sleep_state) | |
cd59abfc | 589 | { |
1eede070 RW |
590 | switch (sleep_state.event) { |
591 | case PM_EVENT_SUSPEND: | |
592 | return PMSG_RESUME; | |
593 | case PM_EVENT_FREEZE: | |
594 | case PM_EVENT_QUIESCE: | |
595 | return PMSG_RECOVER; | |
596 | case PM_EVENT_HIBERNATE: | |
597 | return PMSG_RESTORE; | |
cd59abfc | 598 | } |
1eede070 | 599 | return PMSG_ON; |
cd59abfc AS |
600 | } |
601 | ||
602 | /** | |
20d652d7 RW |
603 | * device_suspend_noirq - Execute a "late suspend" callback for given device. |
604 | * @dev: Device to handle. | |
605 | * @state: PM transition of the system being carried out. | |
775b64d2 | 606 | * |
20d652d7 RW |
607 | * The driver of @dev will not receive interrupts while this function is being |
608 | * executed. | |
cd59abfc | 609 | */ |
d1616302 | 610 | static int device_suspend_noirq(struct device *dev, pm_message_t state) |
775b64d2 RW |
611 | { |
612 | int error = 0; | |
cd59abfc | 613 | |
33c33740 | 614 | if (dev->bus && dev->bus->pm) { |
1eede070 RW |
615 | pm_dev_dbg(dev, state, "LATE "); |
616 | error = pm_noirq_op(dev, dev->bus->pm, state); | |
775b64d2 RW |
617 | } |
618 | return error; | |
619 | } | |
620 | ||
621 | /** | |
20d652d7 RW |
622 | * dpm_suspend_noirq - Execute "late suspend" callbacks for non-sysdev devices. |
623 | * @state: PM transition of the system being carried out. | |
775b64d2 | 624 | * |
20d652d7 RW |
625 | * Prevent device drivers from receiving interrupts and call the "noirq" suspend |
626 | * handlers for all non-sysdev devices. | |
775b64d2 | 627 | */ |
d1616302 | 628 | int dpm_suspend_noirq(pm_message_t state) |
775b64d2 | 629 | { |
1eede070 | 630 | struct device *dev; |
775b64d2 RW |
631 | int error = 0; |
632 | ||
2ed8d2b3 | 633 | suspend_device_irqs(); |
32bdfac5 | 634 | mutex_lock(&dpm_list_mtx); |
1eede070 | 635 | list_for_each_entry_reverse(dev, &dpm_list, power.entry) { |
d1616302 | 636 | error = device_suspend_noirq(dev, state); |
775b64d2 | 637 | if (error) { |
1eede070 | 638 | pm_dev_err(dev, state, " late", error); |
775b64d2 RW |
639 | break; |
640 | } | |
1eede070 | 641 | dev->power.status = DPM_OFF_IRQ; |
775b64d2 | 642 | } |
32bdfac5 | 643 | mutex_unlock(&dpm_list_mtx); |
775b64d2 | 644 | if (error) |
d1616302 | 645 | dpm_resume_noirq(resume_event(state)); |
775b64d2 RW |
646 | return error; |
647 | } | |
d1616302 | 648 | EXPORT_SYMBOL_GPL(dpm_suspend_noirq); |
775b64d2 RW |
649 | |
650 | /** | |
20d652d7 RW |
651 | * device_suspend - Execute "suspend" callbacks for given device. |
652 | * @dev: Device to handle. | |
653 | * @state: PM transition of the system being carried out. | |
775b64d2 | 654 | */ |
d1616302 | 655 | static int device_suspend(struct device *dev, pm_message_t state) |
cd59abfc AS |
656 | { |
657 | int error = 0; | |
658 | ||
7a8d37a3 RW |
659 | down(&dev->sem); |
660 | ||
1eede070 RW |
661 | if (dev->class) { |
662 | if (dev->class->pm) { | |
663 | pm_dev_dbg(dev, state, "class "); | |
664 | error = pm_op(dev, dev->class->pm, state); | |
665 | } else if (dev->class->suspend) { | |
666 | pm_dev_dbg(dev, state, "legacy class "); | |
667 | error = dev->class->suspend(dev, state); | |
668 | suspend_report_result(dev->class->suspend, error); | |
669 | } | |
670 | if (error) | |
671 | goto End; | |
cd59abfc AS |
672 | } |
673 | ||
1eede070 RW |
674 | if (dev->type) { |
675 | if (dev->type->pm) { | |
676 | pm_dev_dbg(dev, state, "type "); | |
677 | error = pm_op(dev, dev->type->pm, state); | |
1eede070 RW |
678 | } |
679 | if (error) | |
680 | goto End; | |
cd59abfc AS |
681 | } |
682 | ||
1eede070 RW |
683 | if (dev->bus) { |
684 | if (dev->bus->pm) { | |
685 | pm_dev_dbg(dev, state, ""); | |
adf09493 | 686 | error = pm_op(dev, dev->bus->pm, state); |
1eede070 RW |
687 | } else if (dev->bus->suspend) { |
688 | pm_dev_dbg(dev, state, "legacy "); | |
689 | error = dev->bus->suspend(dev, state); | |
690 | suspend_report_result(dev->bus->suspend, error); | |
691 | } | |
cd59abfc | 692 | } |
1eede070 | 693 | End: |
7a8d37a3 RW |
694 | up(&dev->sem); |
695 | ||
cd59abfc AS |
696 | return error; |
697 | } | |
698 | ||
699 | /** | |
20d652d7 RW |
700 | * dpm_suspend - Execute "suspend" callbacks for all non-sysdev devices. |
701 | * @state: PM transition of the system being carried out. | |
cd59abfc | 702 | */ |
775b64d2 | 703 | static int dpm_suspend(pm_message_t state) |
cd59abfc | 704 | { |
1eede070 | 705 | struct list_head list; |
cd59abfc AS |
706 | int error = 0; |
707 | ||
1eede070 | 708 | INIT_LIST_HEAD(&list); |
cd59abfc | 709 | mutex_lock(&dpm_list_mtx); |
1eede070 RW |
710 | while (!list_empty(&dpm_list)) { |
711 | struct device *dev = to_device(dpm_list.prev); | |
58aca232 | 712 | |
1eede070 | 713 | get_device(dev); |
cd59abfc | 714 | mutex_unlock(&dpm_list_mtx); |
1eede070 | 715 | |
d1616302 | 716 | error = device_suspend(dev, state); |
1eede070 | 717 | |
1b3cbec1 | 718 | mutex_lock(&dpm_list_mtx); |
775b64d2 | 719 | if (error) { |
1eede070 RW |
720 | pm_dev_err(dev, state, "", error); |
721 | put_device(dev); | |
775b64d2 RW |
722 | break; |
723 | } | |
1eede070 | 724 | dev->power.status = DPM_OFF; |
7a8d37a3 | 725 | if (!list_empty(&dev->power.entry)) |
1eede070 RW |
726 | list_move(&dev->power.entry, &list); |
727 | put_device(dev); | |
cd59abfc | 728 | } |
1eede070 | 729 | list_splice(&list, dpm_list.prev); |
cd59abfc | 730 | mutex_unlock(&dpm_list_mtx); |
1eede070 RW |
731 | return error; |
732 | } | |
733 | ||
734 | /** | |
20d652d7 RW |
735 | * device_prepare - Prepare a device for system power transition. |
736 | * @dev: Device to handle. | |
737 | * @state: PM transition of the system being carried out. | |
738 | * | |
739 | * Execute the ->prepare() callback(s) for given device. No new children of the | |
740 | * device may be registered after this function has returned. | |
1eede070 | 741 | */ |
d1616302 | 742 | static int device_prepare(struct device *dev, pm_message_t state) |
1eede070 RW |
743 | { |
744 | int error = 0; | |
745 | ||
746 | down(&dev->sem); | |
747 | ||
adf09493 | 748 | if (dev->bus && dev->bus->pm && dev->bus->pm->prepare) { |
1eede070 | 749 | pm_dev_dbg(dev, state, "preparing "); |
adf09493 RW |
750 | error = dev->bus->pm->prepare(dev); |
751 | suspend_report_result(dev->bus->pm->prepare, error); | |
1eede070 RW |
752 | if (error) |
753 | goto End; | |
754 | } | |
755 | ||
756 | if (dev->type && dev->type->pm && dev->type->pm->prepare) { | |
757 | pm_dev_dbg(dev, state, "preparing type "); | |
758 | error = dev->type->pm->prepare(dev); | |
759 | suspend_report_result(dev->type->pm->prepare, error); | |
760 | if (error) | |
761 | goto End; | |
762 | } | |
763 | ||
764 | if (dev->class && dev->class->pm && dev->class->pm->prepare) { | |
765 | pm_dev_dbg(dev, state, "preparing class "); | |
766 | error = dev->class->pm->prepare(dev); | |
767 | suspend_report_result(dev->class->pm->prepare, error); | |
768 | } | |
769 | End: | |
770 | up(&dev->sem); | |
771 | ||
772 | return error; | |
773 | } | |
cd59abfc | 774 | |
1eede070 | 775 | /** |
20d652d7 RW |
776 | * dpm_prepare - Prepare all non-sysdev devices for a system PM transition. |
777 | * @state: PM transition of the system being carried out. | |
1eede070 | 778 | * |
20d652d7 | 779 | * Execute the ->prepare() callback(s) for all devices. |
1eede070 RW |
780 | */ |
781 | static int dpm_prepare(pm_message_t state) | |
782 | { | |
783 | struct list_head list; | |
784 | int error = 0; | |
785 | ||
786 | INIT_LIST_HEAD(&list); | |
787 | mutex_lock(&dpm_list_mtx); | |
788 | transition_started = true; | |
789 | while (!list_empty(&dpm_list)) { | |
790 | struct device *dev = to_device(dpm_list.next); | |
791 | ||
792 | get_device(dev); | |
793 | dev->power.status = DPM_PREPARING; | |
794 | mutex_unlock(&dpm_list_mtx); | |
795 | ||
5e928f77 RW |
796 | pm_runtime_get_noresume(dev); |
797 | if (pm_runtime_barrier(dev) && device_may_wakeup(dev)) { | |
798 | /* Wake-up requested during system sleep transition. */ | |
799 | pm_runtime_put_noidle(dev); | |
800 | error = -EBUSY; | |
801 | } else { | |
802 | error = device_prepare(dev, state); | |
803 | } | |
1eede070 RW |
804 | |
805 | mutex_lock(&dpm_list_mtx); | |
806 | if (error) { | |
807 | dev->power.status = DPM_ON; | |
808 | if (error == -EAGAIN) { | |
809 | put_device(dev); | |
886a7a33 | 810 | error = 0; |
1eede070 RW |
811 | continue; |
812 | } | |
813 | printk(KERN_ERR "PM: Failed to prepare device %s " | |
814 | "for power transition: error %d\n", | |
815 | kobject_name(&dev->kobj), error); | |
816 | put_device(dev); | |
817 | break; | |
818 | } | |
819 | dev->power.status = DPM_SUSPENDING; | |
820 | if (!list_empty(&dev->power.entry)) | |
821 | list_move_tail(&dev->power.entry, &list); | |
822 | put_device(dev); | |
823 | } | |
824 | list_splice(&list, &dpm_list); | |
825 | mutex_unlock(&dpm_list_mtx); | |
cd59abfc AS |
826 | return error; |
827 | } | |
828 | ||
775b64d2 | 829 | /** |
20d652d7 RW |
830 | * dpm_suspend_start - Prepare devices for PM transition and suspend them. |
831 | * @state: PM transition of the system being carried out. | |
775b64d2 | 832 | * |
20d652d7 RW |
833 | * Prepare all non-sysdev devices for system PM transition and execute "suspend" |
834 | * callbacks for them. | |
775b64d2 | 835 | */ |
d1616302 | 836 | int dpm_suspend_start(pm_message_t state) |
775b64d2 RW |
837 | { |
838 | int error; | |
cd59abfc | 839 | |
775b64d2 | 840 | might_sleep(); |
1eede070 RW |
841 | error = dpm_prepare(state); |
842 | if (!error) | |
843 | error = dpm_suspend(state); | |
cd59abfc | 844 | return error; |
cd59abfc | 845 | } |
d1616302 | 846 | EXPORT_SYMBOL_GPL(dpm_suspend_start); |
cd59abfc AS |
847 | |
848 | void __suspend_report_result(const char *function, void *fn, int ret) | |
849 | { | |
c80cfb04 BH |
850 | if (ret) |
851 | printk(KERN_ERR "%s(): %pF returns %d\n", function, fn, ret); | |
cd59abfc AS |
852 | } |
853 | EXPORT_SYMBOL_GPL(__suspend_report_result); |