]>
git.proxmox.com Git - mirror_ubuntu-hirsute-kernel.git/blob - include/linux/pm_runtime.h
1 /* SPDX-License-Identifier: GPL-2.0-only */
3 * pm_runtime.h - Device run-time power management helper functions.
5 * Copyright (C) 2009 Rafael J. Wysocki <rjw@sisk.pl>
8 #ifndef _LINUX_PM_RUNTIME_H
9 #define _LINUX_PM_RUNTIME_H
11 #include <linux/device.h>
12 #include <linux/notifier.h>
15 #include <linux/jiffies.h>
17 /* Runtime PM flag argument bits */
18 #define RPM_ASYNC 0x01 /* Request is asynchronous */
19 #define RPM_NOWAIT 0x02 /* Don't wait for concurrent
21 #define RPM_GET_PUT 0x04 /* Increment/decrement the
23 #define RPM_AUTO 0x08 /* Use autosuspend_delay */
26 extern struct workqueue_struct
*pm_wq
;
28 static inline bool queue_pm_work(struct work_struct
*work
)
30 return queue_work(pm_wq
, work
);
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_clean_up_links(struct device
*dev
);
58 extern void pm_runtime_get_suppliers(struct device
*dev
);
59 extern void pm_runtime_put_suppliers(struct device
*dev
);
60 extern void pm_runtime_new_link(struct device
*dev
);
61 extern void pm_runtime_drop_link(struct device
*dev
);
63 static inline int pm_runtime_get_if_in_use(struct device
*dev
)
65 return pm_runtime_get_if_active(dev
, false);
68 static inline void pm_suspend_ignore_children(struct device
*dev
, bool enable
)
70 dev
->power
.ignore_children
= enable
;
73 static inline void pm_runtime_get_noresume(struct device
*dev
)
75 atomic_inc(&dev
->power
.usage_count
);
78 static inline void pm_runtime_put_noidle(struct device
*dev
)
80 atomic_add_unless(&dev
->power
.usage_count
, -1, 0);
83 static inline bool pm_runtime_suspended(struct device
*dev
)
85 return dev
->power
.runtime_status
== RPM_SUSPENDED
86 && !dev
->power
.disable_depth
;
89 static inline bool pm_runtime_active(struct device
*dev
)
91 return dev
->power
.runtime_status
== RPM_ACTIVE
92 || dev
->power
.disable_depth
;
95 static inline bool pm_runtime_status_suspended(struct device
*dev
)
97 return dev
->power
.runtime_status
== RPM_SUSPENDED
;
100 static inline bool pm_runtime_enabled(struct device
*dev
)
102 return !dev
->power
.disable_depth
;
105 static inline bool pm_runtime_has_no_callbacks(struct device
*dev
)
107 return dev
->power
.no_callbacks
;
110 static inline void pm_runtime_mark_last_busy(struct device
*dev
)
112 WRITE_ONCE(dev
->power
.last_busy
, ktime_get_mono_fast_ns());
115 static inline bool pm_runtime_is_irq_safe(struct device
*dev
)
117 return dev
->power
.irq_safe
;
120 extern u64
pm_runtime_suspended_time(struct device
*dev
);
122 #else /* !CONFIG_PM */
124 static inline bool queue_pm_work(struct work_struct
*work
) { return false; }
126 static inline int pm_generic_runtime_suspend(struct device
*dev
) { return 0; }
127 static inline int pm_generic_runtime_resume(struct device
*dev
) { return 0; }
128 static inline int pm_runtime_force_suspend(struct device
*dev
) { return 0; }
129 static inline int pm_runtime_force_resume(struct device
*dev
) { return 0; }
131 static inline int __pm_runtime_idle(struct device
*dev
, int rpmflags
)
135 static inline int __pm_runtime_suspend(struct device
*dev
, int rpmflags
)
139 static inline int __pm_runtime_resume(struct device
*dev
, int rpmflags
)
143 static inline int pm_schedule_suspend(struct device
*dev
, unsigned int delay
)
147 static inline int pm_runtime_get_if_in_use(struct device
*dev
)
151 static inline int pm_runtime_get_if_active(struct device
*dev
,
152 bool ign_usage_count
)
156 static inline int __pm_runtime_set_status(struct device
*dev
,
157 unsigned int status
) { return 0; }
158 static inline int pm_runtime_barrier(struct device
*dev
) { return 0; }
159 static inline void pm_runtime_enable(struct device
*dev
) {}
160 static inline void __pm_runtime_disable(struct device
*dev
, bool c
) {}
161 static inline void pm_runtime_allow(struct device
*dev
) {}
162 static inline void pm_runtime_forbid(struct device
*dev
) {}
164 static inline void pm_suspend_ignore_children(struct device
*dev
, bool enable
) {}
165 static inline void pm_runtime_get_noresume(struct device
*dev
) {}
166 static inline void pm_runtime_put_noidle(struct device
*dev
) {}
167 static inline bool pm_runtime_suspended(struct device
*dev
) { return false; }
168 static inline bool pm_runtime_active(struct device
*dev
) { return true; }
169 static inline bool pm_runtime_status_suspended(struct device
*dev
) { return false; }
170 static inline bool pm_runtime_enabled(struct device
*dev
) { return false; }
172 static inline void pm_runtime_no_callbacks(struct device
*dev
) {}
173 static inline void pm_runtime_irq_safe(struct device
*dev
) {}
174 static inline bool pm_runtime_is_irq_safe(struct device
*dev
) { return false; }
176 static inline bool pm_runtime_callbacks_present(struct device
*dev
) { return false; }
177 static inline void pm_runtime_mark_last_busy(struct device
*dev
) {}
178 static inline void __pm_runtime_use_autosuspend(struct device
*dev
,
180 static inline void pm_runtime_set_autosuspend_delay(struct device
*dev
,
182 static inline u64
pm_runtime_autosuspend_expiration(
183 struct device
*dev
) { return 0; }
184 static inline void pm_runtime_set_memalloc_noio(struct device
*dev
,
186 static inline void pm_runtime_clean_up_links(struct device
*dev
) {}
187 static inline void pm_runtime_get_suppliers(struct device
*dev
) {}
188 static inline void pm_runtime_put_suppliers(struct device
*dev
) {}
189 static inline void pm_runtime_new_link(struct device
*dev
) {}
190 static inline void pm_runtime_drop_link(struct device
*dev
) {}
192 #endif /* !CONFIG_PM */
194 static inline int pm_runtime_idle(struct device
*dev
)
196 return __pm_runtime_idle(dev
, 0);
199 static inline int pm_runtime_suspend(struct device
*dev
)
201 return __pm_runtime_suspend(dev
, 0);
204 static inline int pm_runtime_autosuspend(struct device
*dev
)
206 return __pm_runtime_suspend(dev
, RPM_AUTO
);
209 static inline int pm_runtime_resume(struct device
*dev
)
211 return __pm_runtime_resume(dev
, 0);
214 static inline int pm_request_idle(struct device
*dev
)
216 return __pm_runtime_idle(dev
, RPM_ASYNC
);
219 static inline int pm_request_resume(struct device
*dev
)
221 return __pm_runtime_resume(dev
, RPM_ASYNC
);
224 static inline int pm_request_autosuspend(struct device
*dev
)
226 return __pm_runtime_suspend(dev
, RPM_ASYNC
| RPM_AUTO
);
229 static inline int pm_runtime_get(struct device
*dev
)
231 return __pm_runtime_resume(dev
, RPM_GET_PUT
| RPM_ASYNC
);
234 static inline int pm_runtime_get_sync(struct device
*dev
)
236 return __pm_runtime_resume(dev
, RPM_GET_PUT
);
239 static inline int pm_runtime_put(struct device
*dev
)
241 return __pm_runtime_idle(dev
, RPM_GET_PUT
| RPM_ASYNC
);
244 static inline int pm_runtime_put_autosuspend(struct device
*dev
)
246 return __pm_runtime_suspend(dev
,
247 RPM_GET_PUT
| RPM_ASYNC
| RPM_AUTO
);
250 static inline int pm_runtime_put_sync(struct device
*dev
)
252 return __pm_runtime_idle(dev
, RPM_GET_PUT
);
255 static inline int pm_runtime_put_sync_suspend(struct device
*dev
)
257 return __pm_runtime_suspend(dev
, RPM_GET_PUT
);
260 static inline int pm_runtime_put_sync_autosuspend(struct device
*dev
)
262 return __pm_runtime_suspend(dev
, RPM_GET_PUT
| RPM_AUTO
);
265 static inline int pm_runtime_set_active(struct device
*dev
)
267 return __pm_runtime_set_status(dev
, RPM_ACTIVE
);
270 static inline int pm_runtime_set_suspended(struct device
*dev
)
272 return __pm_runtime_set_status(dev
, RPM_SUSPENDED
);
275 static inline void pm_runtime_disable(struct device
*dev
)
277 __pm_runtime_disable(dev
, true);
280 static inline void pm_runtime_use_autosuspend(struct device
*dev
)
282 __pm_runtime_use_autosuspend(dev
, true);
285 static inline void pm_runtime_dont_use_autosuspend(struct device
*dev
)
287 __pm_runtime_use_autosuspend(dev
, false);