2 * pm_runtime.h - Device run-time power management helper functions.
4 * Copyright (C) 2009 Rafael J. Wysocki <rjw@sisk.pl>
6 * This file is released under the GPLv2.
9 #ifndef _LINUX_PM_RUNTIME_H
10 #define _LINUX_PM_RUNTIME_H
12 #include <linux/device.h>
13 #include <linux/notifier.h>
16 #include <linux/jiffies.h>
18 /* Runtime PM flag argument bits */
19 #define RPM_ASYNC 0x01 /* Request is asynchronous */
20 #define RPM_NOWAIT 0x02 /* Don't wait for concurrent
22 #define RPM_GET_PUT 0x04 /* Increment/decrement the
24 #define RPM_AUTO 0x08 /* Use autosuspend_delay */
26 #ifdef CONFIG_PM_RUNTIME
28 extern struct workqueue_struct
*pm_wq
;
30 extern int __pm_runtime_idle(struct device
*dev
, int rpmflags
);
31 extern int __pm_runtime_suspend(struct device
*dev
, int rpmflags
);
32 extern int __pm_runtime_resume(struct device
*dev
, int rpmflags
);
33 extern int pm_schedule_suspend(struct device
*dev
, unsigned int delay
);
34 extern int __pm_runtime_set_status(struct device
*dev
, unsigned int status
);
35 extern int pm_runtime_barrier(struct device
*dev
);
36 extern void pm_runtime_enable(struct device
*dev
);
37 extern void __pm_runtime_disable(struct device
*dev
, bool check_resume
);
38 extern void pm_runtime_allow(struct device
*dev
);
39 extern void pm_runtime_forbid(struct device
*dev
);
40 extern int pm_generic_runtime_idle(struct device
*dev
);
41 extern int pm_generic_runtime_suspend(struct device
*dev
);
42 extern int pm_generic_runtime_resume(struct device
*dev
);
43 extern void pm_runtime_no_callbacks(struct device
*dev
);
44 extern void pm_runtime_irq_safe(struct device
*dev
);
45 extern void __pm_runtime_use_autosuspend(struct device
*dev
, bool use
);
46 extern void pm_runtime_set_autosuspend_delay(struct device
*dev
, int delay
);
47 extern unsigned long pm_runtime_autosuspend_expiration(struct device
*dev
);
48 extern void pm_runtime_update_max_time_suspended(struct device
*dev
,
51 static inline bool pm_children_suspended(struct device
*dev
)
53 return dev
->power
.ignore_children
54 || !atomic_read(&dev
->power
.child_count
);
57 static inline void pm_runtime_get_noresume(struct device
*dev
)
59 atomic_inc(&dev
->power
.usage_count
);
62 static inline void pm_runtime_put_noidle(struct device
*dev
)
64 atomic_add_unless(&dev
->power
.usage_count
, -1, 0);
67 static inline bool device_run_wake(struct device
*dev
)
69 return dev
->power
.run_wake
;
72 static inline void device_set_run_wake(struct device
*dev
, bool enable
)
74 dev
->power
.run_wake
= enable
;
77 static inline bool pm_runtime_suspended(struct device
*dev
)
79 return dev
->power
.runtime_status
== RPM_SUSPENDED
80 && !dev
->power
.disable_depth
;
83 static inline bool pm_runtime_status_suspended(struct device
*dev
)
85 return dev
->power
.runtime_status
== RPM_SUSPENDED
;
88 static inline bool pm_runtime_enabled(struct device
*dev
)
90 return !dev
->power
.disable_depth
;
93 static inline bool pm_runtime_callbacks_present(struct device
*dev
)
95 return !dev
->power
.no_callbacks
;
98 static inline void pm_runtime_mark_last_busy(struct device
*dev
)
100 ACCESS_ONCE(dev
->power
.last_busy
) = jiffies
;
103 #else /* !CONFIG_PM_RUNTIME */
105 static inline int __pm_runtime_idle(struct device
*dev
, int rpmflags
)
109 static inline int __pm_runtime_suspend(struct device
*dev
, int rpmflags
)
113 static inline int __pm_runtime_resume(struct device
*dev
, int rpmflags
)
117 static inline int pm_schedule_suspend(struct device
*dev
, unsigned int delay
)
121 static inline int __pm_runtime_set_status(struct device
*dev
,
122 unsigned int status
) { return 0; }
123 static inline int pm_runtime_barrier(struct device
*dev
) { return 0; }
124 static inline void pm_runtime_enable(struct device
*dev
) {}
125 static inline void __pm_runtime_disable(struct device
*dev
, bool c
) {}
126 static inline void pm_runtime_allow(struct device
*dev
) {}
127 static inline void pm_runtime_forbid(struct device
*dev
) {}
129 static inline bool pm_children_suspended(struct device
*dev
) { return false; }
130 static inline void pm_runtime_get_noresume(struct device
*dev
) {}
131 static inline void pm_runtime_put_noidle(struct device
*dev
) {}
132 static inline bool device_run_wake(struct device
*dev
) { return false; }
133 static inline void device_set_run_wake(struct device
*dev
, bool enable
) {}
134 static inline bool pm_runtime_suspended(struct device
*dev
) { return false; }
135 static inline bool pm_runtime_status_suspended(struct device
*dev
) { return false; }
136 static inline bool pm_runtime_enabled(struct device
*dev
) { return false; }
138 static inline int pm_generic_runtime_idle(struct device
*dev
) { return 0; }
139 static inline int pm_generic_runtime_suspend(struct device
*dev
) { return 0; }
140 static inline int pm_generic_runtime_resume(struct device
*dev
) { return 0; }
141 static inline void pm_runtime_no_callbacks(struct device
*dev
) {}
142 static inline void pm_runtime_irq_safe(struct device
*dev
) {}
144 static inline bool pm_runtime_callbacks_present(struct device
*dev
) { return false; }
145 static inline void pm_runtime_mark_last_busy(struct device
*dev
) {}
146 static inline void __pm_runtime_use_autosuspend(struct device
*dev
,
148 static inline void pm_runtime_set_autosuspend_delay(struct device
*dev
,
150 static inline unsigned long pm_runtime_autosuspend_expiration(
151 struct device
*dev
) { return 0; }
153 #endif /* !CONFIG_PM_RUNTIME */
155 static inline int pm_runtime_idle(struct device
*dev
)
157 return __pm_runtime_idle(dev
, 0);
160 static inline int pm_runtime_suspend(struct device
*dev
)
162 return __pm_runtime_suspend(dev
, 0);
165 static inline int pm_runtime_autosuspend(struct device
*dev
)
167 return __pm_runtime_suspend(dev
, RPM_AUTO
);
170 static inline int pm_runtime_resume(struct device
*dev
)
172 return __pm_runtime_resume(dev
, 0);
175 static inline int pm_request_idle(struct device
*dev
)
177 return __pm_runtime_idle(dev
, RPM_ASYNC
);
180 static inline int pm_request_resume(struct device
*dev
)
182 return __pm_runtime_resume(dev
, RPM_ASYNC
);
185 static inline int pm_request_autosuspend(struct device
*dev
)
187 return __pm_runtime_suspend(dev
, RPM_ASYNC
| RPM_AUTO
);
190 static inline int pm_runtime_get(struct device
*dev
)
192 return __pm_runtime_resume(dev
, RPM_GET_PUT
| RPM_ASYNC
);
195 static inline int pm_runtime_get_sync(struct device
*dev
)
197 return __pm_runtime_resume(dev
, RPM_GET_PUT
);
200 static inline int pm_runtime_put(struct device
*dev
)
202 return __pm_runtime_idle(dev
, RPM_GET_PUT
| RPM_ASYNC
);
205 static inline int pm_runtime_put_autosuspend(struct device
*dev
)
207 return __pm_runtime_suspend(dev
,
208 RPM_GET_PUT
| RPM_ASYNC
| RPM_AUTO
);
211 static inline int pm_runtime_put_sync(struct device
*dev
)
213 return __pm_runtime_idle(dev
, RPM_GET_PUT
);
216 static inline int pm_runtime_put_sync_suspend(struct device
*dev
)
218 return __pm_runtime_suspend(dev
, RPM_GET_PUT
);
221 static inline int pm_runtime_put_sync_autosuspend(struct device
*dev
)
223 return __pm_runtime_suspend(dev
, RPM_GET_PUT
| RPM_AUTO
);
226 static inline int pm_runtime_set_active(struct device
*dev
)
228 return __pm_runtime_set_status(dev
, RPM_ACTIVE
);
231 static inline void pm_runtime_set_suspended(struct device
*dev
)
233 __pm_runtime_set_status(dev
, RPM_SUSPENDED
);
236 static inline void pm_runtime_disable(struct device
*dev
)
238 __pm_runtime_disable(dev
, true);
241 static inline void pm_runtime_use_autosuspend(struct device
*dev
)
243 __pm_runtime_use_autosuspend(dev
, true);
246 static inline void pm_runtime_dont_use_autosuspend(struct device
*dev
)
248 __pm_runtime_use_autosuspend(dev
, false);