33 extern int pm_generic_runtime_suspend(struct device *dev);
34 extern int pm_generic_runtime_resume(struct device *dev);
35 extern int pm_runtime_force_suspend(struct device *dev);
36 extern int pm_runtime_force_resume(struct device *dev);
38 extern int __pm_runtime_idle(struct device *dev, int rpmflags);
39 extern int __pm_runtime_suspend(struct device *dev, int rpmflags);
40 extern int __pm_runtime_resume(struct device *dev, int rpmflags);
41 extern int pm_runtime_get_if_active(struct device *dev, bool ign_usage_count);
42 extern int pm_schedule_suspend(struct device *dev, unsigned int delay);
43 extern int __pm_runtime_set_status(struct device *dev, unsigned int status);
44 extern int pm_runtime_barrier(struct device *dev);
45 extern void pm_runtime_enable(struct device *dev);
46 extern void __pm_runtime_disable(struct device *dev, bool check_resume);
47 extern void pm_runtime_allow(struct device *dev);
48 extern void pm_runtime_forbid(struct device *dev);
49 extern void pm_runtime_no_callbacks(struct device *dev);
50 extern void pm_runtime_irq_safe(struct device *dev);
51 extern void __pm_runtime_use_autosuspend(struct device *dev, bool use);
52 extern void pm_runtime_set_autosuspend_delay(struct device *dev, int delay);
53 extern u64 pm_runtime_autosuspend_expiration(struct device *dev);
54 extern void pm_runtime_update_max_time_suspended(struct device *dev,
56 extern void pm_runtime_set_memalloc_noio(struct device *dev, bool enable);
57 extern void pm_runtime_get_suppliers(struct device *dev);
58 extern void pm_runtime_put_suppliers(struct device *dev);
59 extern void pm_runtime_new_link(struct device *dev);
62 extern int devm_pm_runtime_enable(struct device *dev);
66  * @dev: Target device.
68  * Increment the runtime PM usage counter of @dev if its runtime PM status is
71 static inline int pm_runtime_get_if_in_use(struct device *dev)  in pm_runtime_get_if_in_use()  argument
73 	return pm_runtime_get_if_active(dev, false);  in pm_runtime_get_if_in_use()
78  * @dev: Target device.
81  * The dependencies of @dev on its children will not be taken into account by
85 static inline void pm_suspend_ignore_children(struct device *dev, bool enable)  in pm_suspend_ignore_children()  argument
87 	dev->power.ignore_children = enable;  in pm_suspend_ignore_children()
92  * @dev: Target device.
94 static inline void pm_runtime_get_noresume(struct device *dev)  in pm_runtime_get_noresume()  argument
96 	atomic_inc(&dev->power.usage_count);  in pm_runtime_get_noresume()
101  * @dev: Target device.
103  * Decrement the runtime PM usage counter of @dev unless it is 0 already.
105 static inline void pm_runtime_put_noidle(struct device *dev)  in pm_runtime_put_noidle()  argument
107 	atomic_add_unless(&dev->power.usage_count, -1, 0);  in pm_runtime_put_noidle()
112  * @dev: Target device.
114  * Return %true if runtime PM is enabled for @dev and its runtime PM status is
118  * called under the runtime PM lock of @dev or under conditions in which
119  * runtime PM cannot be either disabled or enabled for @dev and its runtime PM
122 static inline bool pm_runtime_suspended(struct device *dev)  in pm_runtime_suspended()  argument
124 	return dev->power.runtime_status == RPM_SUSPENDED  in pm_runtime_suspended()
125 		&& !dev->power.disable_depth;  in pm_runtime_suspended()
130  * @dev: Target device.
132  * Return %true if runtime PM is enabled for @dev and its runtime PM status is
136  * called under the runtime PM lock of @dev or under conditions in which
137  * runtime PM cannot be either disabled or enabled for @dev and its runtime PM
140 static inline bool pm_runtime_active(struct device *dev)  in pm_runtime_active()  argument
142 	return dev->power.runtime_status == RPM_ACTIVE  in pm_runtime_active()
143 		|| dev->power.disable_depth;  in pm_runtime_active()
148  * @dev: Target device.
150  * Return %true if the runtime PM status of @dev is %RPM_SUSPENDED, or %false
151  * otherwise, regardless of whether or not runtime PM has been enabled for @dev.
154  * called under the runtime PM lock of @dev or under conditions in which the
155  * runtime PM status of @dev cannot change.
157 static inline bool pm_runtime_status_suspended(struct device *dev)  in pm_runtime_status_suspended()  argument
159 	return dev->power.runtime_status == RPM_SUSPENDED;  in pm_runtime_status_suspended()
164  * @dev: Target device.
166  * Return %true if runtime PM is enabled for @dev or %false otherwise.
169  * called under the runtime PM lock of @dev or under conditions in which
170  * runtime PM cannot be either disabled or enabled for @dev.
172 static inline bool pm_runtime_enabled(struct device *dev)  in pm_runtime_enabled()  argument
174 	return !dev->power.disable_depth;  in pm_runtime_enabled()
179  * @dev: Target device.
181  * Return %true if @dev is a special device without runtime PM callbacks or
184 static inline bool pm_runtime_has_no_callbacks(struct device *dev)  in pm_runtime_has_no_callbacks()  argument
186 	return dev->power.no_callbacks;  in pm_runtime_has_no_callbacks()
191  * @dev: Target device.
193  * Update the last access time of @dev used by the runtime PM autosuspend
196 static inline void pm_runtime_mark_last_busy(struct device *dev)  in pm_runtime_mark_last_busy()  argument
198 	WRITE_ONCE(dev->power.last_busy, ktime_get_mono_fast_ns());  in pm_runtime_mark_last_busy()
203  * @dev: Target device.
205  * Return %true if @dev has been marked as an "IRQ-safe" device (with respect
209 static inline bool pm_runtime_is_irq_safe(struct device *dev)  in pm_runtime_is_irq_safe()  argument
211 	return dev->power.irq_safe;  in pm_runtime_is_irq_safe()
214 extern u64 pm_runtime_suspended_time(struct device *dev);
220 static inline int pm_generic_runtime_suspend(struct device *dev) { return 0; }  in pm_generic_runtime_suspend()  argument
221 static inline int pm_generic_runtime_resume(struct device *dev) { return 0; }  in pm_generic_runtime_resume()  argument
222 static inline int pm_runtime_force_suspend(struct device *dev) { return 0; }  in pm_runtime_force_suspend()  argument
223 static inline int pm_runtime_force_resume(struct device *dev) { return 0; }  in pm_runtime_force_resume()  argument
225 static inline int __pm_runtime_idle(struct device *dev, int rpmflags)  in __pm_runtime_idle()  argument
229 static inline int __pm_runtime_suspend(struct device *dev, int rpmflags)  in __pm_runtime_suspend()  argument
233 static inline int __pm_runtime_resume(struct device *dev, int rpmflags)  in __pm_runtime_resume()  argument
237 static inline int pm_schedule_suspend(struct device *dev, unsigned int delay)  in pm_schedule_suspend()  argument
241 static inline int pm_runtime_get_if_in_use(struct device *dev)  in pm_runtime_get_if_in_use()  argument
245 static inline int pm_runtime_get_if_active(struct device *dev,  in pm_runtime_get_if_active()  argument
250 static inline int __pm_runtime_set_status(struct device *dev,  in __pm_runtime_set_status()  argument
252 static inline int pm_runtime_barrier(struct device *dev) { return 0; }  in pm_runtime_barrier()  argument
253 static inline void pm_runtime_enable(struct device *dev) {}  in pm_runtime_enable()  argument
254 static inline void __pm_runtime_disable(struct device *dev, bool c) {}  in __pm_runtime_disable()  argument
255 static inline void pm_runtime_allow(struct device *dev) {}  in pm_runtime_allow()  argument
256 static inline void pm_runtime_forbid(struct device *dev) {}  in pm_runtime_forbid()  argument
258 static inline int devm_pm_runtime_enable(struct device *dev) { return 0; }  in devm_pm_runtime_enable()  argument
260 static inline void pm_suspend_ignore_children(struct device *dev, bool enable) {}  in pm_suspend_ignore_children()  argument
261 static inline void pm_runtime_get_noresume(struct device *dev) {}  in pm_runtime_get_noresume()  argument
262 static inline void pm_runtime_put_noidle(struct device *dev) {}  in pm_runtime_put_noidle()  argument
263 static inline bool pm_runtime_suspended(struct device *dev) { return false; }  in pm_runtime_suspended()  argument
264 static inline bool pm_runtime_active(struct device *dev) { return true; }  in pm_runtime_active()  argument
265 static inline bool pm_runtime_status_suspended(struct device *dev) { return false; }  in pm_runtime_status_suspended()  argument
266 static inline bool pm_runtime_enabled(struct device *dev) { return false; }  in pm_runtime_enabled()  argument
268 static inline void pm_runtime_no_callbacks(struct device *dev) {}  in pm_runtime_no_callbacks()  argument
269 static inline void pm_runtime_irq_safe(struct device *dev) {}  in pm_runtime_irq_safe()  argument
270 static inline bool pm_runtime_is_irq_safe(struct device *dev) { return false; }  in pm_runtime_is_irq_safe()  argument
272 static inline bool pm_runtime_has_no_callbacks(struct device *dev) { return false; }  in pm_runtime_has_no_callbacks()  argument
273 static inline void pm_runtime_mark_last_busy(struct device *dev) {}  in pm_runtime_mark_last_busy()  argument
274 static inline void __pm_runtime_use_autosuspend(struct device *dev,  in __pm_runtime_use_autosuspend()  argument
276 static inline void pm_runtime_set_autosuspend_delay(struct device *dev,  in pm_runtime_set_autosuspend_delay()  argument
279 				struct device *dev) { return 0; }  in pm_runtime_autosuspend_expiration()  argument
280 static inline void pm_runtime_set_memalloc_noio(struct device *dev,  in pm_runtime_set_memalloc_noio()  argument
282 static inline void pm_runtime_get_suppliers(struct device *dev) {}  in pm_runtime_get_suppliers()  argument
283 static inline void pm_runtime_put_suppliers(struct device *dev) {}  in pm_runtime_put_suppliers()  argument
284 static inline void pm_runtime_new_link(struct device *dev) {}  in pm_runtime_new_link()  argument
291  * @dev: Target device.
293  * Invoke the "idle check" callback of @dev and, depending on its return value,
294  * set up autosuspend of @dev or suspend it (depending on whether or not
297 static inline int pm_runtime_idle(struct device *dev)  in pm_runtime_idle()  argument
299 	return __pm_runtime_idle(dev, 0);  in pm_runtime_idle()
304  * @dev: Target device.
306 static inline int pm_runtime_suspend(struct device *dev)  in pm_runtime_suspend()  argument
308 	return __pm_runtime_suspend(dev, 0);  in pm_runtime_suspend()
313  * @dev: Target device.
315  * Set up autosuspend of @dev or suspend it (depending on whether or not
318 static inline int pm_runtime_autosuspend(struct device *dev)  in pm_runtime_autosuspend()  argument
320 	return __pm_runtime_suspend(dev, RPM_AUTO);  in pm_runtime_autosuspend()
325  * @dev: Target device.
327 static inline int pm_runtime_resume(struct device *dev)  in pm_runtime_resume()  argument
329 	return __pm_runtime_resume(dev, 0);  in pm_runtime_resume()
334  * @dev: Target device.
336  * Queue up a work item to run an equivalent of pm_runtime_idle() for @dev
339 static inline int pm_request_idle(struct device *dev)  in pm_request_idle()  argument
341 	return __pm_runtime_idle(dev, RPM_ASYNC);  in pm_request_idle()
346  * @dev: Target device.
348 static inline int pm_request_resume(struct device *dev)  in pm_request_resume()  argument
350 	return __pm_runtime_resume(dev, RPM_ASYNC);  in pm_request_resume()
355  * @dev: Target device.
357  * Queue up a work item to run an equivalent pm_runtime_autosuspend() for @dev
360 static inline int pm_request_autosuspend(struct device *dev)  in pm_request_autosuspend()  argument
362 	return __pm_runtime_suspend(dev, RPM_ASYNC | RPM_AUTO);  in pm_request_autosuspend()
367  * @dev: Target device.
369  * Bump up the runtime PM usage counter of @dev and queue up a work item to
372 static inline int pm_runtime_get(struct device *dev)  in pm_runtime_get()  argument
374 	return __pm_runtime_resume(dev, RPM_GET_PUT | RPM_ASYNC);  in pm_runtime_get()
379  * @dev: Target device.
381  * Bump up the runtime PM usage counter of @dev and carry out runtime-resume of
385  * pm_runtime_resume() and the runtime PM usage counter of @dev remains
391 static inline int pm_runtime_get_sync(struct device *dev)  in pm_runtime_get_sync()  argument
393 	return __pm_runtime_resume(dev, RPM_GET_PUT);  in pm_runtime_get_sync()
398  * @dev: Target device.
400  * Resume @dev synchronously and if that is successful, increment its runtime
401  * PM usage counter. Return 0 if the runtime PM usage counter of @dev has been
404 static inline int pm_runtime_resume_and_get(struct device *dev)  in pm_runtime_resume_and_get()  argument
408 	ret = __pm_runtime_resume(dev, RPM_GET_PUT);  in pm_runtime_resume_and_get()
410 		pm_runtime_put_noidle(dev);  in pm_runtime_resume_and_get()
419  * @dev: Target device.
421  * Decrement the runtime PM usage counter of @dev and if it turns out to be
422  * equal to 0, queue up a work item for @dev like in pm_request_idle().
424 static inline int pm_runtime_put(struct device *dev)  in pm_runtime_put()  argument
426 	return __pm_runtime_idle(dev, RPM_GET_PUT | RPM_ASYNC);  in pm_runtime_put()
431  * @dev: Target device.
433  * Decrement the runtime PM usage counter of @dev and if it turns out to be
434  * equal to 0, queue up a work item for @dev like in pm_request_autosuspend().
436 static inline int pm_runtime_put_autosuspend(struct device *dev)  in pm_runtime_put_autosuspend()  argument
438 	return __pm_runtime_suspend(dev,  in pm_runtime_put_autosuspend()
444  * @dev: Target device.
446  * Decrement the runtime PM usage counter of @dev and if it turns out to be
447  * equal to 0, invoke the "idle check" callback of @dev and, depending on its
448  * return value, set up autosuspend of @dev or suspend it (depending on whether
452  * pm_runtime_idle() and the runtime PM usage counter of @dev remains
455 static inline int pm_runtime_put_sync(struct device *dev)  in pm_runtime_put_sync()  argument
457 	return __pm_runtime_idle(dev, RPM_GET_PUT);  in pm_runtime_put_sync()
462  * @dev: Target device.
464  * Decrement the runtime PM usage counter of @dev and if it turns out to be
465  * equal to 0, carry out runtime-suspend of @dev synchronously.
468  * pm_runtime_suspend() and the runtime PM usage counter of @dev remains
471 static inline int pm_runtime_put_sync_suspend(struct device *dev)  in pm_runtime_put_sync_suspend()  argument
473 	return __pm_runtime_suspend(dev, RPM_GET_PUT);  in pm_runtime_put_sync_suspend()
478  * @dev: Target device.
480  * Decrement the runtime PM usage counter of @dev and if it turns out to be
481  * equal to 0, set up autosuspend of @dev or suspend it synchronously (depending
485  * pm_runtime_autosuspend() and the runtime PM usage counter of @dev remains
488 static inline int pm_runtime_put_sync_autosuspend(struct device *dev)  in pm_runtime_put_sync_autosuspend()  argument
490 	return __pm_runtime_suspend(dev, RPM_GET_PUT | RPM_AUTO);  in pm_runtime_put_sync_autosuspend()
495  * @dev: Target device.
497  * Set the runtime PM status of @dev to %RPM_ACTIVE and ensure that dependencies
502 static inline int pm_runtime_set_active(struct device *dev)  in pm_runtime_set_active()  argument
504 	return __pm_runtime_set_status(dev, RPM_ACTIVE);  in pm_runtime_set_active()
509  * @dev: Target device.
511  * Set the runtime PM status of @dev to %RPM_SUSPENDED and ensure that
516 static inline int pm_runtime_set_suspended(struct device *dev)  in pm_runtime_set_suspended()  argument
518 	return __pm_runtime_set_status(dev, RPM_SUSPENDED);  in pm_runtime_set_suspended()
523  * @dev: Target device.
525  * Prevent the runtime PM framework from working with @dev (by incrementing its
528  * For each invocation of this function for @dev there must be a matching
531 static inline void pm_runtime_disable(struct device *dev)  in pm_runtime_disable()  argument
533 	__pm_runtime_disable(dev, true);  in pm_runtime_disable()
538  * @dev: Target device.
540  * Allow the runtime PM autosuspend mechanism to be used for @dev whenever
544 static inline void pm_runtime_use_autosuspend(struct device *dev)  in pm_runtime_use_autosuspend()  argument
546 	__pm_runtime_use_autosuspend(dev, true);  in pm_runtime_use_autosuspend()
551  * @dev: Target device.
553  * Prevent the runtime PM autosuspend mechanism from being used for @dev which
557 static inline void pm_runtime_dont_use_autosuspend(struct device *dev)  in pm_runtime_dont_use_autosuspend()  argument
559 	__pm_runtime_use_autosuspend(dev, false);  in pm_runtime_dont_use_autosuspend()