]>
Commit | Line | Data |
---|---|---|
1 | #ifndef _LINUX_PM_QOS_H | |
2 | #define _LINUX_PM_QOS_H | |
3 | /* interface for the pm_qos_power infrastructure of the linux kernel. | |
4 | * | |
5 | * Mark Gross <mgross@linux.intel.com> | |
6 | */ | |
7 | #include <linux/plist.h> | |
8 | #include <linux/notifier.h> | |
9 | #include <linux/miscdevice.h> | |
10 | #include <linux/device.h> | |
11 | #include <linux/workqueue.h> | |
12 | ||
13 | enum { | |
14 | PM_QOS_RESERVED = 0, | |
15 | PM_QOS_CPU_DMA_LATENCY, | |
16 | PM_QOS_NETWORK_LATENCY, | |
17 | PM_QOS_NETWORK_THROUGHPUT, | |
18 | PM_QOS_MEMORY_BANDWIDTH, | |
19 | ||
20 | /* insert new class ID */ | |
21 | PM_QOS_NUM_CLASSES, | |
22 | }; | |
23 | ||
24 | enum pm_qos_flags_status { | |
25 | PM_QOS_FLAGS_UNDEFINED = -1, | |
26 | PM_QOS_FLAGS_NONE, | |
27 | PM_QOS_FLAGS_SOME, | |
28 | PM_QOS_FLAGS_ALL, | |
29 | }; | |
30 | ||
31 | #define PM_QOS_DEFAULT_VALUE -1 | |
32 | ||
33 | #define PM_QOS_CPU_DMA_LAT_DEFAULT_VALUE (2000 * USEC_PER_SEC) | |
34 | #define PM_QOS_NETWORK_LAT_DEFAULT_VALUE (2000 * USEC_PER_SEC) | |
35 | #define PM_QOS_NETWORK_THROUGHPUT_DEFAULT_VALUE 0 | |
36 | #define PM_QOS_MEMORY_BANDWIDTH_DEFAULT_VALUE 0 | |
37 | #define PM_QOS_RESUME_LATENCY_DEFAULT_VALUE 0 | |
38 | #define PM_QOS_LATENCY_TOLERANCE_DEFAULT_VALUE 0 | |
39 | #define PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT (-1) | |
40 | #define PM_QOS_LATENCY_ANY ((s32)(~(__u32)0 >> 1)) | |
41 | ||
42 | #define PM_QOS_FLAG_NO_POWER_OFF (1 << 0) | |
43 | #define PM_QOS_FLAG_REMOTE_WAKEUP (1 << 1) | |
44 | ||
45 | struct pm_qos_request { | |
46 | struct plist_node node; | |
47 | int pm_qos_class; | |
48 | struct delayed_work work; /* for pm_qos_update_request_timeout */ | |
49 | }; | |
50 | ||
51 | struct pm_qos_flags_request { | |
52 | struct list_head node; | |
53 | s32 flags; /* Do not change to 64 bit */ | |
54 | }; | |
55 | ||
56 | enum dev_pm_qos_req_type { | |
57 | DEV_PM_QOS_RESUME_LATENCY = 1, | |
58 | DEV_PM_QOS_LATENCY_TOLERANCE, | |
59 | DEV_PM_QOS_FLAGS, | |
60 | }; | |
61 | ||
62 | struct dev_pm_qos_request { | |
63 | enum dev_pm_qos_req_type type; | |
64 | union { | |
65 | struct plist_node pnode; | |
66 | struct pm_qos_flags_request flr; | |
67 | } data; | |
68 | struct device *dev; | |
69 | }; | |
70 | ||
71 | enum pm_qos_type { | |
72 | PM_QOS_UNITIALIZED, | |
73 | PM_QOS_MAX, /* return the largest value */ | |
74 | PM_QOS_MIN, /* return the smallest value */ | |
75 | PM_QOS_SUM /* return the sum */ | |
76 | }; | |
77 | ||
78 | /* | |
79 | * Note: The lockless read path depends on the CPU accessing target_value | |
80 | * or effective_flags atomically. Atomic access is only guaranteed on all CPU | |
81 | * types linux supports for 32 bit quantites | |
82 | */ | |
83 | struct pm_qos_constraints { | |
84 | struct plist_head list; | |
85 | s32 target_value; /* Do not change to 64 bit */ | |
86 | s32 default_value; | |
87 | s32 no_constraint_value; | |
88 | enum pm_qos_type type; | |
89 | struct blocking_notifier_head *notifiers; | |
90 | }; | |
91 | ||
92 | struct pm_qos_flags { | |
93 | struct list_head list; | |
94 | s32 effective_flags; /* Do not change to 64 bit */ | |
95 | }; | |
96 | ||
97 | struct dev_pm_qos { | |
98 | struct pm_qos_constraints resume_latency; | |
99 | struct pm_qos_constraints latency_tolerance; | |
100 | struct pm_qos_flags flags; | |
101 | struct dev_pm_qos_request *resume_latency_req; | |
102 | struct dev_pm_qos_request *latency_tolerance_req; | |
103 | struct dev_pm_qos_request *flags_req; | |
104 | }; | |
105 | ||
106 | /* Action requested to pm_qos_update_target */ | |
107 | enum pm_qos_req_action { | |
108 | PM_QOS_ADD_REQ, /* Add a new request */ | |
109 | PM_QOS_UPDATE_REQ, /* Update an existing request */ | |
110 | PM_QOS_REMOVE_REQ /* Remove an existing request */ | |
111 | }; | |
112 | ||
113 | static inline int dev_pm_qos_request_active(struct dev_pm_qos_request *req) | |
114 | { | |
115 | return req->dev != NULL; | |
116 | } | |
117 | ||
118 | int pm_qos_update_target(struct pm_qos_constraints *c, struct plist_node *node, | |
119 | enum pm_qos_req_action action, int value); | |
120 | bool pm_qos_update_flags(struct pm_qos_flags *pqf, | |
121 | struct pm_qos_flags_request *req, | |
122 | enum pm_qos_req_action action, s32 val); | |
123 | void pm_qos_add_request(struct pm_qos_request *req, int pm_qos_class, | |
124 | s32 value); | |
125 | void pm_qos_update_request(struct pm_qos_request *req, | |
126 | s32 new_value); | |
127 | void pm_qos_update_request_timeout(struct pm_qos_request *req, | |
128 | s32 new_value, unsigned long timeout_us); | |
129 | void pm_qos_remove_request(struct pm_qos_request *req); | |
130 | ||
131 | int pm_qos_request(int pm_qos_class); | |
132 | int pm_qos_add_notifier(int pm_qos_class, struct notifier_block *notifier); | |
133 | int pm_qos_remove_notifier(int pm_qos_class, struct notifier_block *notifier); | |
134 | int pm_qos_request_active(struct pm_qos_request *req); | |
135 | s32 pm_qos_read_value(struct pm_qos_constraints *c); | |
136 | ||
137 | #ifdef CONFIG_PM | |
138 | enum pm_qos_flags_status __dev_pm_qos_flags(struct device *dev, s32 mask); | |
139 | enum pm_qos_flags_status dev_pm_qos_flags(struct device *dev, s32 mask); | |
140 | s32 __dev_pm_qos_read_value(struct device *dev); | |
141 | s32 dev_pm_qos_read_value(struct device *dev); | |
142 | int dev_pm_qos_add_request(struct device *dev, struct dev_pm_qos_request *req, | |
143 | enum dev_pm_qos_req_type type, s32 value); | |
144 | int dev_pm_qos_update_request(struct dev_pm_qos_request *req, s32 new_value); | |
145 | int dev_pm_qos_remove_request(struct dev_pm_qos_request *req); | |
146 | int dev_pm_qos_add_notifier(struct device *dev, | |
147 | struct notifier_block *notifier); | |
148 | int dev_pm_qos_remove_notifier(struct device *dev, | |
149 | struct notifier_block *notifier); | |
150 | int dev_pm_qos_add_global_notifier(struct notifier_block *notifier); | |
151 | int dev_pm_qos_remove_global_notifier(struct notifier_block *notifier); | |
152 | void dev_pm_qos_constraints_init(struct device *dev); | |
153 | void dev_pm_qos_constraints_destroy(struct device *dev); | |
154 | int dev_pm_qos_add_ancestor_request(struct device *dev, | |
155 | struct dev_pm_qos_request *req, | |
156 | enum dev_pm_qos_req_type type, s32 value); | |
157 | int dev_pm_qos_expose_latency_limit(struct device *dev, s32 value); | |
158 | void dev_pm_qos_hide_latency_limit(struct device *dev); | |
159 | int dev_pm_qos_expose_flags(struct device *dev, s32 value); | |
160 | void dev_pm_qos_hide_flags(struct device *dev); | |
161 | int dev_pm_qos_update_flags(struct device *dev, s32 mask, bool set); | |
162 | s32 dev_pm_qos_get_user_latency_tolerance(struct device *dev); | |
163 | int dev_pm_qos_update_user_latency_tolerance(struct device *dev, s32 val); | |
164 | int dev_pm_qos_expose_latency_tolerance(struct device *dev); | |
165 | void dev_pm_qos_hide_latency_tolerance(struct device *dev); | |
166 | ||
167 | static inline s32 dev_pm_qos_requested_resume_latency(struct device *dev) | |
168 | { | |
169 | return dev->power.qos->resume_latency_req->data.pnode.prio; | |
170 | } | |
171 | ||
172 | static inline s32 dev_pm_qos_requested_flags(struct device *dev) | |
173 | { | |
174 | return dev->power.qos->flags_req->data.flr.flags; | |
175 | } | |
176 | #else | |
177 | static inline enum pm_qos_flags_status __dev_pm_qos_flags(struct device *dev, | |
178 | s32 mask) | |
179 | { return PM_QOS_FLAGS_UNDEFINED; } | |
180 | static inline enum pm_qos_flags_status dev_pm_qos_flags(struct device *dev, | |
181 | s32 mask) | |
182 | { return PM_QOS_FLAGS_UNDEFINED; } | |
183 | static inline s32 __dev_pm_qos_read_value(struct device *dev) | |
184 | { return 0; } | |
185 | static inline s32 dev_pm_qos_read_value(struct device *dev) | |
186 | { return 0; } | |
187 | static inline int dev_pm_qos_add_request(struct device *dev, | |
188 | struct dev_pm_qos_request *req, | |
189 | enum dev_pm_qos_req_type type, | |
190 | s32 value) | |
191 | { return 0; } | |
192 | static inline int dev_pm_qos_update_request(struct dev_pm_qos_request *req, | |
193 | s32 new_value) | |
194 | { return 0; } | |
195 | static inline int dev_pm_qos_remove_request(struct dev_pm_qos_request *req) | |
196 | { return 0; } | |
197 | static inline int dev_pm_qos_add_notifier(struct device *dev, | |
198 | struct notifier_block *notifier) | |
199 | { return 0; } | |
200 | static inline int dev_pm_qos_remove_notifier(struct device *dev, | |
201 | struct notifier_block *notifier) | |
202 | { return 0; } | |
203 | static inline int dev_pm_qos_add_global_notifier( | |
204 | struct notifier_block *notifier) | |
205 | { return 0; } | |
206 | static inline int dev_pm_qos_remove_global_notifier( | |
207 | struct notifier_block *notifier) | |
208 | { return 0; } | |
209 | static inline void dev_pm_qos_constraints_init(struct device *dev) | |
210 | { | |
211 | dev->power.power_state = PMSG_ON; | |
212 | } | |
213 | static inline void dev_pm_qos_constraints_destroy(struct device *dev) | |
214 | { | |
215 | dev->power.power_state = PMSG_INVALID; | |
216 | } | |
217 | static inline int dev_pm_qos_add_ancestor_request(struct device *dev, | |
218 | struct dev_pm_qos_request *req, | |
219 | enum dev_pm_qos_req_type type, | |
220 | s32 value) | |
221 | { return 0; } | |
222 | static inline int dev_pm_qos_expose_latency_limit(struct device *dev, s32 value) | |
223 | { return 0; } | |
224 | static inline void dev_pm_qos_hide_latency_limit(struct device *dev) {} | |
225 | static inline int dev_pm_qos_expose_flags(struct device *dev, s32 value) | |
226 | { return 0; } | |
227 | static inline void dev_pm_qos_hide_flags(struct device *dev) {} | |
228 | static inline int dev_pm_qos_update_flags(struct device *dev, s32 m, bool set) | |
229 | { return 0; } | |
230 | static inline s32 dev_pm_qos_get_user_latency_tolerance(struct device *dev) | |
231 | { return PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT; } | |
232 | static inline int dev_pm_qos_update_user_latency_tolerance(struct device *dev, s32 val) | |
233 | { return 0; } | |
234 | static inline int dev_pm_qos_expose_latency_tolerance(struct device *dev) | |
235 | { return 0; } | |
236 | static inline void dev_pm_qos_hide_latency_tolerance(struct device *dev) {} | |
237 | ||
238 | static inline s32 dev_pm_qos_requested_resume_latency(struct device *dev) { return 0; } | |
239 | static inline s32 dev_pm_qos_requested_flags(struct device *dev) { return 0; } | |
240 | #endif | |
241 | ||
242 | #endif |