Loading...
1/*
2 * drivers/base/power/generic_ops.c - Generic PM callbacks for subsystems
3 *
4 * Copyright (c) 2010 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
5 *
6 * This file is released under the GPLv2.
7 */
8
9#include <linux/pm.h>
10#include <linux/pm_runtime.h>
11#include <linux/export.h>
12#include <linux/suspend.h>
13
14#ifdef CONFIG_PM
15/**
16 * pm_generic_runtime_suspend - Generic runtime suspend callback for subsystems.
17 * @dev: Device to suspend.
18 *
19 * If PM operations are defined for the @dev's driver and they include
20 * ->runtime_suspend(), execute it and return its error code. Otherwise,
21 * return 0.
22 */
23int pm_generic_runtime_suspend(struct device *dev)
24{
25 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
26 int ret;
27
28 ret = pm && pm->runtime_suspend ? pm->runtime_suspend(dev) : 0;
29
30 return ret;
31}
32EXPORT_SYMBOL_GPL(pm_generic_runtime_suspend);
33
34/**
35 * pm_generic_runtime_resume - Generic runtime resume callback for subsystems.
36 * @dev: Device to resume.
37 *
38 * If PM operations are defined for the @dev's driver and they include
39 * ->runtime_resume(), execute it and return its error code. Otherwise,
40 * return 0.
41 */
42int pm_generic_runtime_resume(struct device *dev)
43{
44 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
45 int ret;
46
47 ret = pm && pm->runtime_resume ? pm->runtime_resume(dev) : 0;
48
49 return ret;
50}
51EXPORT_SYMBOL_GPL(pm_generic_runtime_resume);
52#endif /* CONFIG_PM */
53
54#ifdef CONFIG_PM_SLEEP
55/**
56 * pm_generic_prepare - Generic routine preparing a device for power transition.
57 * @dev: Device to prepare.
58 *
59 * Prepare a device for a system-wide power transition.
60 */
61int pm_generic_prepare(struct device *dev)
62{
63 struct device_driver *drv = dev->driver;
64 int ret = 0;
65
66 if (drv && drv->pm && drv->pm->prepare)
67 ret = drv->pm->prepare(dev);
68
69 return ret;
70}
71
72/**
73 * pm_generic_suspend_noirq - Generic suspend_noirq callback for subsystems.
74 * @dev: Device to suspend.
75 */
76int pm_generic_suspend_noirq(struct device *dev)
77{
78 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
79
80 return pm && pm->suspend_noirq ? pm->suspend_noirq(dev) : 0;
81}
82EXPORT_SYMBOL_GPL(pm_generic_suspend_noirq);
83
84/**
85 * pm_generic_suspend_late - Generic suspend_late callback for subsystems.
86 * @dev: Device to suspend.
87 */
88int pm_generic_suspend_late(struct device *dev)
89{
90 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
91
92 return pm && pm->suspend_late ? pm->suspend_late(dev) : 0;
93}
94EXPORT_SYMBOL_GPL(pm_generic_suspend_late);
95
96/**
97 * pm_generic_suspend - Generic suspend callback for subsystems.
98 * @dev: Device to suspend.
99 */
100int pm_generic_suspend(struct device *dev)
101{
102 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
103
104 return pm && pm->suspend ? pm->suspend(dev) : 0;
105}
106EXPORT_SYMBOL_GPL(pm_generic_suspend);
107
108/**
109 * pm_generic_freeze_noirq - Generic freeze_noirq callback for subsystems.
110 * @dev: Device to freeze.
111 */
112int pm_generic_freeze_noirq(struct device *dev)
113{
114 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
115
116 return pm && pm->freeze_noirq ? pm->freeze_noirq(dev) : 0;
117}
118EXPORT_SYMBOL_GPL(pm_generic_freeze_noirq);
119
120/**
121 * pm_generic_freeze_late - Generic freeze_late callback for subsystems.
122 * @dev: Device to freeze.
123 */
124int pm_generic_freeze_late(struct device *dev)
125{
126 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
127
128 return pm && pm->freeze_late ? pm->freeze_late(dev) : 0;
129}
130EXPORT_SYMBOL_GPL(pm_generic_freeze_late);
131
132/**
133 * pm_generic_freeze - Generic freeze callback for subsystems.
134 * @dev: Device to freeze.
135 */
136int pm_generic_freeze(struct device *dev)
137{
138 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
139
140 return pm && pm->freeze ? pm->freeze(dev) : 0;
141}
142EXPORT_SYMBOL_GPL(pm_generic_freeze);
143
144/**
145 * pm_generic_poweroff_noirq - Generic poweroff_noirq callback for subsystems.
146 * @dev: Device to handle.
147 */
148int pm_generic_poweroff_noirq(struct device *dev)
149{
150 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
151
152 return pm && pm->poweroff_noirq ? pm->poweroff_noirq(dev) : 0;
153}
154EXPORT_SYMBOL_GPL(pm_generic_poweroff_noirq);
155
156/**
157 * pm_generic_poweroff_late - Generic poweroff_late callback for subsystems.
158 * @dev: Device to handle.
159 */
160int pm_generic_poweroff_late(struct device *dev)
161{
162 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
163
164 return pm && pm->poweroff_late ? pm->poweroff_late(dev) : 0;
165}
166EXPORT_SYMBOL_GPL(pm_generic_poweroff_late);
167
168/**
169 * pm_generic_poweroff - Generic poweroff callback for subsystems.
170 * @dev: Device to handle.
171 */
172int pm_generic_poweroff(struct device *dev)
173{
174 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
175
176 return pm && pm->poweroff ? pm->poweroff(dev) : 0;
177}
178EXPORT_SYMBOL_GPL(pm_generic_poweroff);
179
180/**
181 * pm_generic_thaw_noirq - Generic thaw_noirq callback for subsystems.
182 * @dev: Device to thaw.
183 */
184int pm_generic_thaw_noirq(struct device *dev)
185{
186 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
187
188 return pm && pm->thaw_noirq ? pm->thaw_noirq(dev) : 0;
189}
190EXPORT_SYMBOL_GPL(pm_generic_thaw_noirq);
191
192/**
193 * pm_generic_thaw_early - Generic thaw_early callback for subsystems.
194 * @dev: Device to thaw.
195 */
196int pm_generic_thaw_early(struct device *dev)
197{
198 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
199
200 return pm && pm->thaw_early ? pm->thaw_early(dev) : 0;
201}
202EXPORT_SYMBOL_GPL(pm_generic_thaw_early);
203
204/**
205 * pm_generic_thaw - Generic thaw callback for subsystems.
206 * @dev: Device to thaw.
207 */
208int pm_generic_thaw(struct device *dev)
209{
210 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
211
212 return pm && pm->thaw ? pm->thaw(dev) : 0;
213}
214EXPORT_SYMBOL_GPL(pm_generic_thaw);
215
216/**
217 * pm_generic_resume_noirq - Generic resume_noirq callback for subsystems.
218 * @dev: Device to resume.
219 */
220int pm_generic_resume_noirq(struct device *dev)
221{
222 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
223
224 return pm && pm->resume_noirq ? pm->resume_noirq(dev) : 0;
225}
226EXPORT_SYMBOL_GPL(pm_generic_resume_noirq);
227
228/**
229 * pm_generic_resume_early - Generic resume_early callback for subsystems.
230 * @dev: Device to resume.
231 */
232int pm_generic_resume_early(struct device *dev)
233{
234 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
235
236 return pm && pm->resume_early ? pm->resume_early(dev) : 0;
237}
238EXPORT_SYMBOL_GPL(pm_generic_resume_early);
239
240/**
241 * pm_generic_resume - Generic resume callback for subsystems.
242 * @dev: Device to resume.
243 */
244int pm_generic_resume(struct device *dev)
245{
246 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
247
248 return pm && pm->resume ? pm->resume(dev) : 0;
249}
250EXPORT_SYMBOL_GPL(pm_generic_resume);
251
252/**
253 * pm_generic_restore_noirq - Generic restore_noirq callback for subsystems.
254 * @dev: Device to restore.
255 */
256int pm_generic_restore_noirq(struct device *dev)
257{
258 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
259
260 return pm && pm->restore_noirq ? pm->restore_noirq(dev) : 0;
261}
262EXPORT_SYMBOL_GPL(pm_generic_restore_noirq);
263
264/**
265 * pm_generic_restore_early - Generic restore_early callback for subsystems.
266 * @dev: Device to resume.
267 */
268int pm_generic_restore_early(struct device *dev)
269{
270 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
271
272 return pm && pm->restore_early ? pm->restore_early(dev) : 0;
273}
274EXPORT_SYMBOL_GPL(pm_generic_restore_early);
275
276/**
277 * pm_generic_restore - Generic restore callback for subsystems.
278 * @dev: Device to restore.
279 */
280int pm_generic_restore(struct device *dev)
281{
282 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
283
284 return pm && pm->restore ? pm->restore(dev) : 0;
285}
286EXPORT_SYMBOL_GPL(pm_generic_restore);
287
288/**
289 * pm_generic_complete - Generic routine completing a device power transition.
290 * @dev: Device to handle.
291 *
292 * Complete a device power transition during a system-wide power transition.
293 */
294void pm_generic_complete(struct device *dev)
295{
296 struct device_driver *drv = dev->driver;
297
298 if (drv && drv->pm && drv->pm->complete)
299 drv->pm->complete(dev);
300}
301
302/**
303 * pm_complete_with_resume_check - Complete a device power transition.
304 * @dev: Device to handle.
305 *
306 * Complete a device power transition during a system-wide power transition and
307 * optionally schedule a runtime resume of the device if the system resume in
308 * progress has been initated by the platform firmware and the device had its
309 * power.direct_complete flag set.
310 */
311void pm_complete_with_resume_check(struct device *dev)
312{
313 pm_generic_complete(dev);
314 /*
315 * If the device had been runtime-suspended before the system went into
316 * the sleep state it is going out of and it has never been resumed till
317 * now, resume it in case the firmware powered it up.
318 */
319 if (dev->power.direct_complete && pm_resume_via_firmware())
320 pm_request_resume(dev);
321}
322EXPORT_SYMBOL_GPL(pm_complete_with_resume_check);
323#endif /* CONFIG_PM_SLEEP */
1/*
2 * drivers/base/power/generic_ops.c - Generic PM callbacks for subsystems
3 *
4 * Copyright (c) 2010 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
5 *
6 * This file is released under the GPLv2.
7 */
8
9#include <linux/pm.h>
10#include <linux/pm_runtime.h>
11#include <linux/export.h>
12
13#ifdef CONFIG_PM_RUNTIME
14/**
15 * pm_generic_runtime_idle - Generic runtime idle callback for subsystems.
16 * @dev: Device to handle.
17 *
18 * If PM operations are defined for the @dev's driver and they include
19 * ->runtime_idle(), execute it and return its error code, if nonzero.
20 * Otherwise, execute pm_runtime_suspend() for the device and return 0.
21 */
22int pm_generic_runtime_idle(struct device *dev)
23{
24 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
25
26 if (pm && pm->runtime_idle) {
27 int ret = pm->runtime_idle(dev);
28 if (ret)
29 return ret;
30 }
31
32 pm_runtime_suspend(dev);
33 return 0;
34}
35EXPORT_SYMBOL_GPL(pm_generic_runtime_idle);
36
37/**
38 * pm_generic_runtime_suspend - Generic runtime suspend callback for subsystems.
39 * @dev: Device to suspend.
40 *
41 * If PM operations are defined for the @dev's driver and they include
42 * ->runtime_suspend(), execute it and return its error code. Otherwise,
43 * return 0.
44 */
45int pm_generic_runtime_suspend(struct device *dev)
46{
47 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
48 int ret;
49
50 ret = pm && pm->runtime_suspend ? pm->runtime_suspend(dev) : 0;
51
52 return ret;
53}
54EXPORT_SYMBOL_GPL(pm_generic_runtime_suspend);
55
56/**
57 * pm_generic_runtime_resume - Generic runtime resume callback for subsystems.
58 * @dev: Device to resume.
59 *
60 * If PM operations are defined for the @dev's driver and they include
61 * ->runtime_resume(), execute it and return its error code. Otherwise,
62 * return 0.
63 */
64int pm_generic_runtime_resume(struct device *dev)
65{
66 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
67 int ret;
68
69 ret = pm && pm->runtime_resume ? pm->runtime_resume(dev) : 0;
70
71 return ret;
72}
73EXPORT_SYMBOL_GPL(pm_generic_runtime_resume);
74#endif /* CONFIG_PM_RUNTIME */
75
76#ifdef CONFIG_PM_SLEEP
77/**
78 * pm_generic_prepare - Generic routine preparing a device for power transition.
79 * @dev: Device to prepare.
80 *
81 * Prepare a device for a system-wide power transition.
82 */
83int pm_generic_prepare(struct device *dev)
84{
85 struct device_driver *drv = dev->driver;
86 int ret = 0;
87
88 if (drv && drv->pm && drv->pm->prepare)
89 ret = drv->pm->prepare(dev);
90
91 return ret;
92}
93
94/**
95 * pm_generic_suspend_noirq - Generic suspend_noirq callback for subsystems.
96 * @dev: Device to suspend.
97 */
98int pm_generic_suspend_noirq(struct device *dev)
99{
100 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
101
102 return pm && pm->suspend_noirq ? pm->suspend_noirq(dev) : 0;
103}
104EXPORT_SYMBOL_GPL(pm_generic_suspend_noirq);
105
106/**
107 * pm_generic_suspend_late - Generic suspend_late callback for subsystems.
108 * @dev: Device to suspend.
109 */
110int pm_generic_suspend_late(struct device *dev)
111{
112 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
113
114 return pm && pm->suspend_late ? pm->suspend_late(dev) : 0;
115}
116EXPORT_SYMBOL_GPL(pm_generic_suspend_late);
117
118/**
119 * pm_generic_suspend - Generic suspend callback for subsystems.
120 * @dev: Device to suspend.
121 */
122int pm_generic_suspend(struct device *dev)
123{
124 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
125
126 return pm && pm->suspend ? pm->suspend(dev) : 0;
127}
128EXPORT_SYMBOL_GPL(pm_generic_suspend);
129
130/**
131 * pm_generic_freeze_noirq - Generic freeze_noirq callback for subsystems.
132 * @dev: Device to freeze.
133 */
134int pm_generic_freeze_noirq(struct device *dev)
135{
136 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
137
138 return pm && pm->freeze_noirq ? pm->freeze_noirq(dev) : 0;
139}
140EXPORT_SYMBOL_GPL(pm_generic_freeze_noirq);
141
142/**
143 * pm_generic_freeze_late - Generic freeze_late callback for subsystems.
144 * @dev: Device to freeze.
145 */
146int pm_generic_freeze_late(struct device *dev)
147{
148 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
149
150 return pm && pm->freeze_late ? pm->freeze_late(dev) : 0;
151}
152EXPORT_SYMBOL_GPL(pm_generic_freeze_late);
153
154/**
155 * pm_generic_freeze - Generic freeze callback for subsystems.
156 * @dev: Device to freeze.
157 */
158int pm_generic_freeze(struct device *dev)
159{
160 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
161
162 return pm && pm->freeze ? pm->freeze(dev) : 0;
163}
164EXPORT_SYMBOL_GPL(pm_generic_freeze);
165
166/**
167 * pm_generic_poweroff_noirq - Generic poweroff_noirq callback for subsystems.
168 * @dev: Device to handle.
169 */
170int pm_generic_poweroff_noirq(struct device *dev)
171{
172 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
173
174 return pm && pm->poweroff_noirq ? pm->poweroff_noirq(dev) : 0;
175}
176EXPORT_SYMBOL_GPL(pm_generic_poweroff_noirq);
177
178/**
179 * pm_generic_poweroff_late - Generic poweroff_late callback for subsystems.
180 * @dev: Device to handle.
181 */
182int pm_generic_poweroff_late(struct device *dev)
183{
184 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
185
186 return pm && pm->poweroff_late ? pm->poweroff_late(dev) : 0;
187}
188EXPORT_SYMBOL_GPL(pm_generic_poweroff_late);
189
190/**
191 * pm_generic_poweroff - Generic poweroff callback for subsystems.
192 * @dev: Device to handle.
193 */
194int pm_generic_poweroff(struct device *dev)
195{
196 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
197
198 return pm && pm->poweroff ? pm->poweroff(dev) : 0;
199}
200EXPORT_SYMBOL_GPL(pm_generic_poweroff);
201
202/**
203 * pm_generic_thaw_noirq - Generic thaw_noirq callback for subsystems.
204 * @dev: Device to thaw.
205 */
206int pm_generic_thaw_noirq(struct device *dev)
207{
208 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
209
210 return pm && pm->thaw_noirq ? pm->thaw_noirq(dev) : 0;
211}
212EXPORT_SYMBOL_GPL(pm_generic_thaw_noirq);
213
214/**
215 * pm_generic_thaw_early - Generic thaw_early callback for subsystems.
216 * @dev: Device to thaw.
217 */
218int pm_generic_thaw_early(struct device *dev)
219{
220 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
221
222 return pm && pm->thaw_early ? pm->thaw_early(dev) : 0;
223}
224EXPORT_SYMBOL_GPL(pm_generic_thaw_early);
225
226/**
227 * pm_generic_thaw - Generic thaw callback for subsystems.
228 * @dev: Device to thaw.
229 */
230int pm_generic_thaw(struct device *dev)
231{
232 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
233
234 return pm && pm->thaw ? pm->thaw(dev) : 0;
235}
236EXPORT_SYMBOL_GPL(pm_generic_thaw);
237
238/**
239 * pm_generic_resume_noirq - Generic resume_noirq callback for subsystems.
240 * @dev: Device to resume.
241 */
242int pm_generic_resume_noirq(struct device *dev)
243{
244 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
245
246 return pm && pm->resume_noirq ? pm->resume_noirq(dev) : 0;
247}
248EXPORT_SYMBOL_GPL(pm_generic_resume_noirq);
249
250/**
251 * pm_generic_resume_early - Generic resume_early callback for subsystems.
252 * @dev: Device to resume.
253 */
254int pm_generic_resume_early(struct device *dev)
255{
256 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
257
258 return pm && pm->resume_early ? pm->resume_early(dev) : 0;
259}
260EXPORT_SYMBOL_GPL(pm_generic_resume_early);
261
262/**
263 * pm_generic_resume - Generic resume callback for subsystems.
264 * @dev: Device to resume.
265 */
266int pm_generic_resume(struct device *dev)
267{
268 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
269
270 return pm && pm->resume ? pm->resume(dev) : 0;
271}
272EXPORT_SYMBOL_GPL(pm_generic_resume);
273
274/**
275 * pm_generic_restore_noirq - Generic restore_noirq callback for subsystems.
276 * @dev: Device to restore.
277 */
278int pm_generic_restore_noirq(struct device *dev)
279{
280 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
281
282 return pm && pm->restore_noirq ? pm->restore_noirq(dev) : 0;
283}
284EXPORT_SYMBOL_GPL(pm_generic_restore_noirq);
285
286/**
287 * pm_generic_restore_early - Generic restore_early callback for subsystems.
288 * @dev: Device to resume.
289 */
290int pm_generic_restore_early(struct device *dev)
291{
292 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
293
294 return pm && pm->restore_early ? pm->restore_early(dev) : 0;
295}
296EXPORT_SYMBOL_GPL(pm_generic_restore_early);
297
298/**
299 * pm_generic_restore - Generic restore callback for subsystems.
300 * @dev: Device to restore.
301 */
302int pm_generic_restore(struct device *dev)
303{
304 const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
305
306 return pm && pm->restore ? pm->restore(dev) : 0;
307}
308EXPORT_SYMBOL_GPL(pm_generic_restore);
309
310/**
311 * pm_generic_complete - Generic routine competing a device power transition.
312 * @dev: Device to handle.
313 *
314 * Complete a device power transition during a system-wide power transition.
315 */
316void pm_generic_complete(struct device *dev)
317{
318 struct device_driver *drv = dev->driver;
319
320 if (drv && drv->pm && drv->pm->complete)
321 drv->pm->complete(dev);
322
323 /*
324 * Let runtime PM try to suspend devices that haven't been in use before
325 * going into the system-wide sleep state we're resuming from.
326 */
327 pm_runtime_idle(dev);
328}
329#endif /* CONFIG_PM_SLEEP */