]>
Commit | Line | Data |
---|---|---|
5e928f77 RW |
1 | /* |
2 | * pm_runtime.h - Device run-time power management helper functions. | |
3 | * | |
4 | * Copyright (C) 2009 Rafael J. Wysocki <rjw@sisk.pl> | |
5 | * | |
6 | * This file is released under the GPLv2. | |
7 | */ | |
8 | ||
9 | #ifndef _LINUX_PM_RUNTIME_H | |
10 | #define _LINUX_PM_RUNTIME_H | |
11 | ||
12 | #include <linux/device.h> | |
246359d3 | 13 | #include <linux/notifier.h> |
5e928f77 RW |
14 | #include <linux/pm.h> |
15 | ||
15bcb91d AS |
16 | #include <linux/jiffies.h> |
17 | ||
3f9af051 AS |
18 | /* Runtime PM flag argument bits */ |
19 | #define RPM_ASYNC 0x01 /* Request is asynchronous */ | |
20 | #define RPM_NOWAIT 0x02 /* Don't wait for concurrent | |
21 | state change */ | |
140a6c94 AS |
22 | #define RPM_GET_PUT 0x04 /* Increment/decrement the |
23 | usage_count */ | |
15bcb91d | 24 | #define RPM_AUTO 0x08 /* Use autosuspend_delay */ |
3f9af051 | 25 | |
717e5d45 | 26 | #ifdef CONFIG_PM |
28cb5ef1 RW |
27 | extern struct workqueue_struct *pm_wq; |
28 | ||
29 | static inline bool queue_pm_work(struct work_struct *work) | |
30 | { | |
31 | return queue_work(pm_wq, work); | |
32 | } | |
33 | ||
717e5d45 UH |
34 | extern int pm_generic_runtime_suspend(struct device *dev); |
35 | extern int pm_generic_runtime_resume(struct device *dev); | |
37f20416 UH |
36 | extern int pm_runtime_force_suspend(struct device *dev); |
37 | extern int pm_runtime_force_resume(struct device *dev); | |
5e928f77 | 38 | |
140a6c94 AS |
39 | extern int __pm_runtime_idle(struct device *dev, int rpmflags); |
40 | extern int __pm_runtime_suspend(struct device *dev, int rpmflags); | |
41 | extern int __pm_runtime_resume(struct device *dev, int rpmflags); | |
a436b6a1 | 42 | extern int pm_runtime_get_if_in_use(struct device *dev); |
5e928f77 | 43 | extern int pm_schedule_suspend(struct device *dev, unsigned int delay); |
5e928f77 RW |
44 | extern int __pm_runtime_set_status(struct device *dev, unsigned int status); |
45 | extern int pm_runtime_barrier(struct device *dev); | |
46 | extern void pm_runtime_enable(struct device *dev); | |
47 | extern void __pm_runtime_disable(struct device *dev, bool check_resume); | |
53823639 RW |
48 | extern void pm_runtime_allow(struct device *dev); |
49 | extern void pm_runtime_forbid(struct device *dev); | |
7490e442 | 50 | extern void pm_runtime_no_callbacks(struct device *dev); |
c7b61de5 | 51 | extern void pm_runtime_irq_safe(struct device *dev); |
15bcb91d AS |
52 | extern void __pm_runtime_use_autosuspend(struct device *dev, bool use); |
53 | extern void pm_runtime_set_autosuspend_delay(struct device *dev, int delay); | |
54 | extern unsigned long pm_runtime_autosuspend_expiration(struct device *dev); | |
00dc9ad1 RW |
55 | extern void pm_runtime_update_max_time_suspended(struct device *dev, |
56 | s64 delta_ns); | |
e823407f | 57 | extern void pm_runtime_set_memalloc_noio(struct device *dev, bool enable); |
21d5c57b | 58 | extern void pm_runtime_clean_up_links(struct device *dev); |
b06c0b2f RW |
59 | extern void pm_runtime_get_suppliers(struct device *dev); |
60 | extern void pm_runtime_put_suppliers(struct device *dev); | |
baa8809f RW |
61 | extern void pm_runtime_new_link(struct device *dev); |
62 | extern void pm_runtime_drop_link(struct device *dev); | |
5e928f77 | 63 | |
372a12ed UH |
64 | static inline void pm_suspend_ignore_children(struct device *dev, bool enable) |
65 | { | |
66 | dev->power.ignore_children = enable; | |
67 | } | |
68 | ||
5e928f77 RW |
69 | static inline void pm_runtime_get_noresume(struct device *dev) |
70 | { | |
71 | atomic_inc(&dev->power.usage_count); | |
72 | } | |
73 | ||
74 | static inline void pm_runtime_put_noidle(struct device *dev) | |
75 | { | |
76 | atomic_add_unless(&dev->power.usage_count, -1, 0); | |
77 | } | |
78 | ||
d690b2cd RW |
79 | static inline bool pm_runtime_suspended(struct device *dev) |
80 | { | |
f08f5a0a RW |
81 | return dev->power.runtime_status == RPM_SUSPENDED |
82 | && !dev->power.disable_depth; | |
d690b2cd RW |
83 | } |
84 | ||
fbadc58d SL |
85 | static inline bool pm_runtime_active(struct device *dev) |
86 | { | |
87 | return dev->power.runtime_status == RPM_ACTIVE | |
88 | || dev->power.disable_depth; | |
89 | } | |
90 | ||
f3393b62 KH |
91 | static inline bool pm_runtime_status_suspended(struct device *dev) |
92 | { | |
93 | return dev->power.runtime_status == RPM_SUSPENDED; | |
94 | } | |
95 | ||
4b31db8a RW |
96 | static inline bool pm_runtime_enabled(struct device *dev) |
97 | { | |
98 | return !dev->power.disable_depth; | |
99 | } | |
100 | ||
cb8f51bd RW |
101 | static inline bool pm_runtime_callbacks_present(struct device *dev) |
102 | { | |
103 | return !dev->power.no_callbacks; | |
104 | } | |
105 | ||
15bcb91d AS |
106 | static inline void pm_runtime_mark_last_busy(struct device *dev) |
107 | { | |
6aa7de05 | 108 | WRITE_ONCE(dev->power.last_busy, jiffies); |
15bcb91d AS |
109 | } |
110 | ||
3fb1581e KK |
111 | static inline bool pm_runtime_is_irq_safe(struct device *dev) |
112 | { | |
113 | return dev->power.irq_safe; | |
114 | } | |
115 | ||
d30d819d RW |
116 | #else /* !CONFIG_PM */ |
117 | ||
118 | static inline bool queue_pm_work(struct work_struct *work) { return false; } | |
119 | ||
120 | static inline int pm_generic_runtime_suspend(struct device *dev) { return 0; } | |
121 | static inline int pm_generic_runtime_resume(struct device *dev) { return 0; } | |
122 | static inline int pm_runtime_force_suspend(struct device *dev) { return 0; } | |
123 | static inline int pm_runtime_force_resume(struct device *dev) { return 0; } | |
5e928f77 | 124 | |
140a6c94 AS |
125 | static inline int __pm_runtime_idle(struct device *dev, int rpmflags) |
126 | { | |
127 | return -ENOSYS; | |
128 | } | |
129 | static inline int __pm_runtime_suspend(struct device *dev, int rpmflags) | |
130 | { | |
131 | return -ENOSYS; | |
132 | } | |
133 | static inline int __pm_runtime_resume(struct device *dev, int rpmflags) | |
134 | { | |
135 | return 1; | |
136 | } | |
5e928f77 RW |
137 | static inline int pm_schedule_suspend(struct device *dev, unsigned int delay) |
138 | { | |
139 | return -ENOSYS; | |
140 | } | |
a436b6a1 RW |
141 | static inline int pm_runtime_get_if_in_use(struct device *dev) |
142 | { | |
143 | return -EINVAL; | |
144 | } | |
5e928f77 RW |
145 | static inline int __pm_runtime_set_status(struct device *dev, |
146 | unsigned int status) { return 0; } | |
147 | static inline int pm_runtime_barrier(struct device *dev) { return 0; } | |
148 | static inline void pm_runtime_enable(struct device *dev) {} | |
149 | static inline void __pm_runtime_disable(struct device *dev, bool c) {} | |
53823639 RW |
150 | static inline void pm_runtime_allow(struct device *dev) {} |
151 | static inline void pm_runtime_forbid(struct device *dev) {} | |
5e928f77 | 152 | |
372a12ed | 153 | static inline void pm_suspend_ignore_children(struct device *dev, bool enable) {} |
5e928f77 RW |
154 | static inline void pm_runtime_get_noresume(struct device *dev) {} |
155 | static inline void pm_runtime_put_noidle(struct device *dev) {} | |
d690b2cd | 156 | static inline bool pm_runtime_suspended(struct device *dev) { return false; } |
fbadc58d | 157 | static inline bool pm_runtime_active(struct device *dev) { return true; } |
f3393b62 | 158 | static inline bool pm_runtime_status_suspended(struct device *dev) { return false; } |
4b31db8a | 159 | static inline bool pm_runtime_enabled(struct device *dev) { return false; } |
5e928f77 | 160 | |
7490e442 | 161 | static inline void pm_runtime_no_callbacks(struct device *dev) {} |
c7b61de5 | 162 | static inline void pm_runtime_irq_safe(struct device *dev) {} |
3fb1581e | 163 | static inline bool pm_runtime_is_irq_safe(struct device *dev) { return false; } |
2f60ba70 | 164 | |
cb8f51bd | 165 | static inline bool pm_runtime_callbacks_present(struct device *dev) { return false; } |
15bcb91d AS |
166 | static inline void pm_runtime_mark_last_busy(struct device *dev) {} |
167 | static inline void __pm_runtime_use_autosuspend(struct device *dev, | |
168 | bool use) {} | |
169 | static inline void pm_runtime_set_autosuspend_delay(struct device *dev, | |
170 | int delay) {} | |
171 | static inline unsigned long pm_runtime_autosuspend_expiration( | |
172 | struct device *dev) { return 0; } | |
e823407f ML |
173 | static inline void pm_runtime_set_memalloc_noio(struct device *dev, |
174 | bool enable){} | |
21d5c57b | 175 | static inline void pm_runtime_clean_up_links(struct device *dev) {} |
b06c0b2f RW |
176 | static inline void pm_runtime_get_suppliers(struct device *dev) {} |
177 | static inline void pm_runtime_put_suppliers(struct device *dev) {} | |
baa8809f RW |
178 | static inline void pm_runtime_new_link(struct device *dev) {} |
179 | static inline void pm_runtime_drop_link(struct device *dev) {} | |
15bcb91d | 180 | |
d30d819d | 181 | #endif /* !CONFIG_PM */ |
5e928f77 | 182 | |
140a6c94 AS |
183 | static inline int pm_runtime_idle(struct device *dev) |
184 | { | |
185 | return __pm_runtime_idle(dev, 0); | |
186 | } | |
187 | ||
188 | static inline int pm_runtime_suspend(struct device *dev) | |
189 | { | |
190 | return __pm_runtime_suspend(dev, 0); | |
191 | } | |
192 | ||
15bcb91d AS |
193 | static inline int pm_runtime_autosuspend(struct device *dev) |
194 | { | |
195 | return __pm_runtime_suspend(dev, RPM_AUTO); | |
196 | } | |
197 | ||
140a6c94 AS |
198 | static inline int pm_runtime_resume(struct device *dev) |
199 | { | |
200 | return __pm_runtime_resume(dev, 0); | |
201 | } | |
202 | ||
203 | static inline int pm_request_idle(struct device *dev) | |
204 | { | |
205 | return __pm_runtime_idle(dev, RPM_ASYNC); | |
206 | } | |
207 | ||
208 | static inline int pm_request_resume(struct device *dev) | |
209 | { | |
210 | return __pm_runtime_resume(dev, RPM_ASYNC); | |
211 | } | |
212 | ||
5fc62aad ML |
213 | static inline int pm_request_autosuspend(struct device *dev) |
214 | { | |
215 | return __pm_runtime_suspend(dev, RPM_ASYNC | RPM_AUTO); | |
216 | } | |
217 | ||
5e928f77 RW |
218 | static inline int pm_runtime_get(struct device *dev) |
219 | { | |
140a6c94 | 220 | return __pm_runtime_resume(dev, RPM_GET_PUT | RPM_ASYNC); |
5e928f77 RW |
221 | } |
222 | ||
223 | static inline int pm_runtime_get_sync(struct device *dev) | |
224 | { | |
140a6c94 | 225 | return __pm_runtime_resume(dev, RPM_GET_PUT); |
5e928f77 RW |
226 | } |
227 | ||
228 | static inline int pm_runtime_put(struct device *dev) | |
229 | { | |
140a6c94 | 230 | return __pm_runtime_idle(dev, RPM_GET_PUT | RPM_ASYNC); |
5e928f77 RW |
231 | } |
232 | ||
15bcb91d AS |
233 | static inline int pm_runtime_put_autosuspend(struct device *dev) |
234 | { | |
235 | return __pm_runtime_suspend(dev, | |
236 | RPM_GET_PUT | RPM_ASYNC | RPM_AUTO); | |
237 | } | |
238 | ||
5e928f77 RW |
239 | static inline int pm_runtime_put_sync(struct device *dev) |
240 | { | |
140a6c94 | 241 | return __pm_runtime_idle(dev, RPM_GET_PUT); |
5e928f77 RW |
242 | } |
243 | ||
c7b61de5 AS |
244 | static inline int pm_runtime_put_sync_suspend(struct device *dev) |
245 | { | |
246 | return __pm_runtime_suspend(dev, RPM_GET_PUT); | |
247 | } | |
248 | ||
15bcb91d AS |
249 | static inline int pm_runtime_put_sync_autosuspend(struct device *dev) |
250 | { | |
251 | return __pm_runtime_suspend(dev, RPM_GET_PUT | RPM_AUTO); | |
252 | } | |
253 | ||
5e928f77 RW |
254 | static inline int pm_runtime_set_active(struct device *dev) |
255 | { | |
256 | return __pm_runtime_set_status(dev, RPM_ACTIVE); | |
257 | } | |
258 | ||
b1a60995 | 259 | static inline int pm_runtime_set_suspended(struct device *dev) |
5e928f77 | 260 | { |
b1a60995 | 261 | return __pm_runtime_set_status(dev, RPM_SUSPENDED); |
5e928f77 RW |
262 | } |
263 | ||
264 | static inline void pm_runtime_disable(struct device *dev) | |
265 | { | |
266 | __pm_runtime_disable(dev, true); | |
267 | } | |
268 | ||
15bcb91d AS |
269 | static inline void pm_runtime_use_autosuspend(struct device *dev) |
270 | { | |
271 | __pm_runtime_use_autosuspend(dev, true); | |
272 | } | |
273 | ||
274 | static inline void pm_runtime_dont_use_autosuspend(struct device *dev) | |
275 | { | |
276 | __pm_runtime_use_autosuspend(dev, false); | |
277 | } | |
278 | ||
5e928f77 | 279 | #endif |