xref: /linux-6.15/include/linux/pm_runtime.h (revision 266fe2f2)
1 /*
2  * pm_runtime.h - Device run-time power management helper functions.
3  *
4  * Copyright (C) 2009 Rafael J. Wysocki <[email protected]>
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>
13 #include <linux/pm.h>
14 
15 #ifdef CONFIG_PM_RUNTIME
16 
17 extern struct workqueue_struct *pm_wq;
18 
19 extern int pm_runtime_idle(struct device *dev);
20 extern int pm_runtime_suspend(struct device *dev);
21 extern int pm_runtime_resume(struct device *dev);
22 extern int pm_request_idle(struct device *dev);
23 extern int pm_schedule_suspend(struct device *dev, unsigned int delay);
24 extern int pm_request_resume(struct device *dev);
25 extern int __pm_runtime_get(struct device *dev, bool sync);
26 extern int __pm_runtime_put(struct device *dev, bool sync);
27 extern int __pm_runtime_set_status(struct device *dev, unsigned int status);
28 extern int pm_runtime_barrier(struct device *dev);
29 extern void pm_runtime_enable(struct device *dev);
30 extern void __pm_runtime_disable(struct device *dev, bool check_resume);
31 
32 static inline bool pm_children_suspended(struct device *dev)
33 {
34 	return dev->power.ignore_children
35 		|| !atomic_read(&dev->power.child_count);
36 }
37 
38 static inline void pm_suspend_ignore_children(struct device *dev, bool enable)
39 {
40 	dev->power.ignore_children = enable;
41 }
42 
43 static inline void pm_runtime_get_noresume(struct device *dev)
44 {
45 	atomic_inc(&dev->power.usage_count);
46 }
47 
48 static inline void pm_runtime_put_noidle(struct device *dev)
49 {
50 	atomic_add_unless(&dev->power.usage_count, -1, 0);
51 }
52 
53 static inline bool device_run_wake(struct device *dev)
54 {
55 	return dev->power.run_wake;
56 }
57 
58 static inline void device_set_run_wake(struct device *dev, bool enable)
59 {
60 	dev->power.run_wake = enable;
61 }
62 
63 #else /* !CONFIG_PM_RUNTIME */
64 
65 static inline int pm_runtime_idle(struct device *dev) { return -ENOSYS; }
66 static inline int pm_runtime_suspend(struct device *dev) { return -ENOSYS; }
67 static inline int pm_runtime_resume(struct device *dev) { return 0; }
68 static inline int pm_request_idle(struct device *dev) { return -ENOSYS; }
69 static inline int pm_schedule_suspend(struct device *dev, unsigned int delay)
70 {
71 	return -ENOSYS;
72 }
73 static inline int pm_request_resume(struct device *dev) { return 0; }
74 static inline int __pm_runtime_get(struct device *dev, bool sync) { return 1; }
75 static inline int __pm_runtime_put(struct device *dev, bool sync) { return 0; }
76 static inline int __pm_runtime_set_status(struct device *dev,
77 					    unsigned int status) { return 0; }
78 static inline int pm_runtime_barrier(struct device *dev) { return 0; }
79 static inline void pm_runtime_enable(struct device *dev) {}
80 static inline void __pm_runtime_disable(struct device *dev, bool c) {}
81 
82 static inline bool pm_children_suspended(struct device *dev) { return false; }
83 static inline void pm_suspend_ignore_children(struct device *dev, bool en) {}
84 static inline void pm_runtime_get_noresume(struct device *dev) {}
85 static inline void pm_runtime_put_noidle(struct device *dev) {}
86 static inline bool device_run_wake(struct device *dev) { return false; }
87 static inline void device_set_run_wake(struct device *dev, bool enable) {}
88 
89 #endif /* !CONFIG_PM_RUNTIME */
90 
91 static inline int pm_runtime_get(struct device *dev)
92 {
93 	return __pm_runtime_get(dev, false);
94 }
95 
96 static inline int pm_runtime_get_sync(struct device *dev)
97 {
98 	return __pm_runtime_get(dev, true);
99 }
100 
101 static inline int pm_runtime_put(struct device *dev)
102 {
103 	return __pm_runtime_put(dev, false);
104 }
105 
106 static inline int pm_runtime_put_sync(struct device *dev)
107 {
108 	return __pm_runtime_put(dev, true);
109 }
110 
111 static inline int pm_runtime_set_active(struct device *dev)
112 {
113 	return __pm_runtime_set_status(dev, RPM_ACTIVE);
114 }
115 
116 static inline void pm_runtime_set_suspended(struct device *dev)
117 {
118 	__pm_runtime_set_status(dev, RPM_SUSPENDED);
119 }
120 
121 static inline void pm_runtime_disable(struct device *dev)
122 {
123 	__pm_runtime_disable(dev, true);
124 }
125 
126 #endif
127