Branch data Line data Source code
1 : : // SPDX-License-Identifier: GPL-2.0
2 : : /*
3 : : * Devices PM QoS constraints management
4 : : *
5 : : * Copyright (C) 2011 Texas Instruments, Inc.
6 : : *
7 : : * This module exposes the interface to kernel space for specifying
8 : : * per-device PM QoS dependencies. It provides infrastructure for registration
9 : : * of:
10 : : *
11 : : * Dependents on a QoS value : register requests
12 : : * Watchers of QoS value : get notified when target QoS value changes
13 : : *
14 : : * This QoS design is best effort based. Dependents register their QoS needs.
15 : : * Watchers register to keep track of the current QoS needs of the system.
16 : : * Watchers can register a per-device notification callback using the
17 : : * dev_pm_qos_*_notifier API. The notification chain data is stored in the
18 : : * per-device constraint data struct.
19 : : *
20 : : * Note about the per-device constraint data struct allocation:
21 : : * . The per-device constraints data struct ptr is stored into the device
22 : : * dev_pm_info.
23 : : * . To minimize the data usage by the per-device constraints, the data struct
24 : : * is only allocated at the first call to dev_pm_qos_add_request.
25 : : * . The data is later free'd when the device is removed from the system.
26 : : * . A global mutex protects the constraints users from the data being
27 : : * allocated and free'd.
28 : : */
29 : :
30 : : #include <linux/pm_qos.h>
31 : : #include <linux/spinlock.h>
32 : : #include <linux/slab.h>
33 : : #include <linux/device.h>
34 : : #include <linux/mutex.h>
35 : : #include <linux/export.h>
36 : : #include <linux/pm_runtime.h>
37 : : #include <linux/err.h>
38 : : #include <trace/events/power.h>
39 : :
40 : : #include "power.h"
41 : :
42 : : static DEFINE_MUTEX(dev_pm_qos_mtx);
43 : : static DEFINE_MUTEX(dev_pm_qos_sysfs_mtx);
44 : :
45 : : /**
46 : : * __dev_pm_qos_flags - Check PM QoS flags for a given device.
47 : : * @dev: Device to check the PM QoS flags for.
48 : : * @mask: Flags to check against.
49 : : *
50 : : * This routine must be called with dev->power.lock held.
51 : : */
52 : 4444 : enum pm_qos_flags_status __dev_pm_qos_flags(struct device *dev, s32 mask)
53 : : {
54 : 4444 : struct dev_pm_qos *qos = dev->power.qos;
55 : : struct pm_qos_flags *pqf;
56 : : s32 val;
57 : :
58 : : lockdep_assert_held(&dev->power.lock);
59 : :
60 [ + - ]: 4444 : if (IS_ERR_OR_NULL(qos))
61 : : return PM_QOS_FLAGS_UNDEFINED;
62 : :
63 : : pqf = &qos->flags;
64 [ + + ]: 8888 : if (list_empty(&pqf->list))
65 : : return PM_QOS_FLAGS_UNDEFINED;
66 : :
67 : 3636 : val = pqf->effective_flags & mask;
68 [ + - ]: 3636 : if (val)
69 [ - + ]: 3636 : return (val == mask) ? PM_QOS_FLAGS_ALL : PM_QOS_FLAGS_SOME;
70 : :
71 : : return PM_QOS_FLAGS_NONE;
72 : : }
73 : :
74 : : /**
75 : : * dev_pm_qos_flags - Check PM QoS flags for a given device (locked).
76 : : * @dev: Device to check the PM QoS flags for.
77 : : * @mask: Flags to check against.
78 : : */
79 : 4444 : enum pm_qos_flags_status dev_pm_qos_flags(struct device *dev, s32 mask)
80 : : {
81 : : unsigned long irqflags;
82 : : enum pm_qos_flags_status ret;
83 : :
84 : 4444 : spin_lock_irqsave(&dev->power.lock, irqflags);
85 : 4444 : ret = __dev_pm_qos_flags(dev, mask);
86 : : spin_unlock_irqrestore(&dev->power.lock, irqflags);
87 : :
88 : 4444 : return ret;
89 : : }
90 : : EXPORT_SYMBOL_GPL(dev_pm_qos_flags);
91 : :
92 : : /**
93 : : * __dev_pm_qos_resume_latency - Get resume latency constraint for a given device.
94 : : * @dev: Device to get the PM QoS constraint value for.
95 : : *
96 : : * This routine must be called with dev->power.lock held.
97 : : */
98 : 2052572 : s32 __dev_pm_qos_resume_latency(struct device *dev)
99 : : {
100 : : lockdep_assert_held(&dev->power.lock);
101 : :
102 : 2052572 : return dev_pm_qos_raw_resume_latency(dev);
103 : : }
104 : :
105 : : /**
106 : : * dev_pm_qos_read_value - Get PM QoS constraint for a given device (locked).
107 : : * @dev: Device to get the PM QoS constraint value for.
108 : : * @type: QoS request type.
109 : : */
110 : 0 : s32 dev_pm_qos_read_value(struct device *dev, enum dev_pm_qos_req_type type)
111 : : {
112 : 0 : struct dev_pm_qos *qos = dev->power.qos;
113 : : unsigned long flags;
114 : : s32 ret;
115 : :
116 : 0 : spin_lock_irqsave(&dev->power.lock, flags);
117 : :
118 [ # # ]: 0 : if (type == DEV_PM_QOS_RESUME_LATENCY) {
119 : : ret = IS_ERR_OR_NULL(qos) ? PM_QOS_RESUME_LATENCY_NO_CONSTRAINT
120 [ # # ]: 0 : : pm_qos_read_value(&qos->resume_latency);
121 : : } else {
122 : 0 : WARN_ON(1);
123 : : ret = 0;
124 : : }
125 : :
126 : : spin_unlock_irqrestore(&dev->power.lock, flags);
127 : :
128 : 0 : return ret;
129 : : }
130 : :
131 : : /**
132 : : * apply_constraint - Add/modify/remove device PM QoS request.
133 : : * @req: Constraint request to apply
134 : : * @action: Action to perform (add/update/remove).
135 : : * @value: Value to assign to the QoS request.
136 : : *
137 : : * Internal function to update the constraints list using the PM QoS core
138 : : * code and if needed call the per-device callbacks.
139 : : */
140 : 6060 : static int apply_constraint(struct dev_pm_qos_request *req,
141 : : enum pm_qos_req_action action, s32 value)
142 : : {
143 : 6060 : struct dev_pm_qos *qos = req->dev->power.qos;
144 : : int ret;
145 : :
146 [ + - + - ]: 6060 : switch(req->type) {
147 : : case DEV_PM_QOS_RESUME_LATENCY:
148 [ - + - + ]: 1616 : if (WARN_ON(action != PM_QOS_REMOVE_REQ && value < 0))
149 : : value = 0;
150 : :
151 : 1616 : ret = pm_qos_update_target(&qos->resume_latency,
152 : : &req->data.pnode, action, value);
153 : 1616 : break;
154 : : case DEV_PM_QOS_LATENCY_TOLERANCE:
155 : 0 : ret = pm_qos_update_target(&qos->latency_tolerance,
156 : : &req->data.pnode, action, value);
157 [ # # ]: 0 : if (ret) {
158 : 0 : value = pm_qos_read_value(&qos->latency_tolerance);
159 : 0 : req->dev->power.set_latency_tolerance(req->dev, value);
160 : : }
161 : : break;
162 : : case DEV_PM_QOS_FLAGS:
163 : 4444 : ret = pm_qos_update_flags(&qos->flags, &req->data.flr,
164 : : action, value);
165 : 4444 : break;
166 : : default:
167 : : ret = -EINVAL;
168 : : }
169 : :
170 : 6060 : return ret;
171 : : }
172 : :
173 : : /*
174 : : * dev_pm_qos_constraints_allocate
175 : : * @dev: device to allocate data for
176 : : *
177 : : * Called at the first call to add_request, for constraint data allocation
178 : : * Must be called with the dev_pm_qos_mtx mutex held
179 : : */
180 : 5656 : static int dev_pm_qos_constraints_allocate(struct device *dev)
181 : : {
182 : : struct dev_pm_qos *qos;
183 : : struct pm_qos_constraints *c;
184 : : struct blocking_notifier_head *n;
185 : :
186 : 5656 : qos = kzalloc(sizeof(*qos), GFP_KERNEL);
187 [ + - ]: 5656 : if (!qos)
188 : : return -ENOMEM;
189 : :
190 : 5656 : n = kzalloc(3 * sizeof(*n), GFP_KERNEL);
191 [ - + ]: 5656 : if (!n) {
192 : 0 : kfree(qos);
193 : 0 : return -ENOMEM;
194 : : }
195 : :
196 : : c = &qos->resume_latency;
197 : : plist_head_init(&c->list);
198 : 5656 : c->target_value = PM_QOS_RESUME_LATENCY_DEFAULT_VALUE;
199 : 5656 : c->default_value = PM_QOS_RESUME_LATENCY_DEFAULT_VALUE;
200 : 5656 : c->no_constraint_value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT;
201 : 5656 : c->type = PM_QOS_MIN;
202 : 5656 : c->notifiers = n;
203 : 5656 : BLOCKING_INIT_NOTIFIER_HEAD(n);
204 : :
205 : : c = &qos->latency_tolerance;
206 : : plist_head_init(&c->list);
207 : 5656 : c->target_value = PM_QOS_LATENCY_TOLERANCE_DEFAULT_VALUE;
208 : 5656 : c->default_value = PM_QOS_LATENCY_TOLERANCE_DEFAULT_VALUE;
209 : 5656 : c->no_constraint_value = PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT;
210 : 5656 : c->type = PM_QOS_MIN;
211 : :
212 : 5656 : INIT_LIST_HEAD(&qos->flags.list);
213 : :
214 : : spin_lock_irq(&dev->power.lock);
215 : 5656 : dev->power.qos = qos;
216 : : spin_unlock_irq(&dev->power.lock);
217 : :
218 : 5656 : return 0;
219 : : }
220 : :
221 : : static void __dev_pm_qos_hide_latency_limit(struct device *dev);
222 : : static void __dev_pm_qos_hide_flags(struct device *dev);
223 : :
224 : : /**
225 : : * dev_pm_qos_constraints_destroy
226 : : * @dev: target device
227 : : *
228 : : * Called from the device PM subsystem on device removal under device_pm_lock().
229 : : */
230 : 406 : void dev_pm_qos_constraints_destroy(struct device *dev)
231 : : {
232 : : struct dev_pm_qos *qos;
233 : : struct dev_pm_qos_request *req, *tmp;
234 : : struct pm_qos_constraints *c;
235 : : struct pm_qos_flags *f;
236 : :
237 : 406 : mutex_lock(&dev_pm_qos_sysfs_mtx);
238 : :
239 : : /*
240 : : * If the device's PM QoS resume latency limit or PM QoS flags have been
241 : : * exposed to user space, they have to be hidden at this point.
242 : : */
243 : 406 : pm_qos_sysfs_remove_resume_latency(dev);
244 : 406 : pm_qos_sysfs_remove_flags(dev);
245 : :
246 : 406 : mutex_lock(&dev_pm_qos_mtx);
247 : :
248 : 406 : __dev_pm_qos_hide_latency_limit(dev);
249 : 406 : __dev_pm_qos_hide_flags(dev);
250 : :
251 : 406 : qos = dev->power.qos;
252 [ - + ]: 406 : if (!qos)
253 : : goto out;
254 : :
255 : : /* Flush the constraints lists for the device. */
256 : : c = &qos->resume_latency;
257 [ # # ]: 0 : plist_for_each_entry_safe(req, tmp, &c->list, data.pnode) {
258 : : /*
259 : : * Update constraints list and call the notification
260 : : * callbacks if needed
261 : : */
262 : 0 : apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
263 : 0 : memset(req, 0, sizeof(*req));
264 : : }
265 : :
266 : : c = &qos->latency_tolerance;
267 [ # # ]: 0 : plist_for_each_entry_safe(req, tmp, &c->list, data.pnode) {
268 : 0 : apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
269 : 0 : memset(req, 0, sizeof(*req));
270 : : }
271 : :
272 : : f = &qos->flags;
273 [ # # ]: 0 : list_for_each_entry_safe(req, tmp, &f->list, data.flr.node) {
274 : 0 : apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
275 : 0 : memset(req, 0, sizeof(*req));
276 : : }
277 : :
278 : : spin_lock_irq(&dev->power.lock);
279 : 0 : dev->power.qos = ERR_PTR(-ENODEV);
280 : : spin_unlock_irq(&dev->power.lock);
281 : :
282 : 0 : kfree(qos->resume_latency.notifiers);
283 : 0 : kfree(qos);
284 : :
285 : : out:
286 : 406 : mutex_unlock(&dev_pm_qos_mtx);
287 : :
288 : 406 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
289 : 406 : }
290 : :
291 : : static bool dev_pm_qos_invalid_req_type(struct device *dev,
292 : : enum dev_pm_qos_req_type type)
293 : : {
294 [ - + # # ]: 5656 : return type == DEV_PM_QOS_LATENCY_TOLERANCE &&
295 : 0 : !dev->power.set_latency_tolerance;
296 : : }
297 : :
298 : 5656 : static int __dev_pm_qos_add_request(struct device *dev,
299 : : struct dev_pm_qos_request *req,
300 : : enum dev_pm_qos_req_type type, s32 value)
301 : : {
302 : : int ret = 0;
303 : :
304 [ + - + - ]: 11312 : if (!dev || !req || dev_pm_qos_invalid_req_type(dev, type))
305 : : return -EINVAL;
306 : :
307 [ - + + - ]: 5656 : if (WARN(dev_pm_qos_request_active(req),
308 : : "%s() called for already added request\n", __func__))
309 : : return -EINVAL;
310 : :
311 [ + - ]: 11312 : if (IS_ERR(dev->power.qos))
312 : : ret = -ENODEV;
313 [ + + ]: 5656 : else if (!dev->power.qos)
314 : 5252 : ret = dev_pm_qos_constraints_allocate(dev);
315 : :
316 : 5656 : trace_dev_pm_qos_add_request(dev_name(dev), type, value);
317 [ + - ]: 5656 : if (!ret) {
318 : 5656 : req->dev = dev;
319 : 5656 : req->type = type;
320 : 5656 : ret = apply_constraint(req, PM_QOS_ADD_REQ, value);
321 : : }
322 : 5656 : return ret;
323 : : }
324 : :
325 : : /**
326 : : * dev_pm_qos_add_request - inserts new qos request into the list
327 : : * @dev: target device for the constraint
328 : : * @req: pointer to a preallocated handle
329 : : * @type: type of the request
330 : : * @value: defines the qos request
331 : : *
332 : : * This function inserts a new entry in the device constraints list of
333 : : * requested qos performance characteristics. It recomputes the aggregate
334 : : * QoS expectations of parameters and initializes the dev_pm_qos_request
335 : : * handle. Caller needs to save this handle for later use in updates and
336 : : * removal.
337 : : *
338 : : * Returns 1 if the aggregated constraint value has changed,
339 : : * 0 if the aggregated constraint value has not changed,
340 : : * -EINVAL in case of wrong parameters, -ENOMEM if there's not enough memory
341 : : * to allocate for data structures, -ENODEV if the device has just been removed
342 : : * from the system.
343 : : *
344 : : * Callers should ensure that the target device is not RPM_SUSPENDED before
345 : : * using this function for requests of type DEV_PM_QOS_FLAGS.
346 : : */
347 : 5656 : int dev_pm_qos_add_request(struct device *dev, struct dev_pm_qos_request *req,
348 : : enum dev_pm_qos_req_type type, s32 value)
349 : : {
350 : : int ret;
351 : :
352 : 5656 : mutex_lock(&dev_pm_qos_mtx);
353 : 5656 : ret = __dev_pm_qos_add_request(dev, req, type, value);
354 : 5656 : mutex_unlock(&dev_pm_qos_mtx);
355 : 5656 : return ret;
356 : : }
357 : : EXPORT_SYMBOL_GPL(dev_pm_qos_add_request);
358 : :
359 : : /**
360 : : * __dev_pm_qos_update_request - Modify an existing device PM QoS request.
361 : : * @req : PM QoS request to modify.
362 : : * @new_value: New value to request.
363 : : */
364 : 0 : static int __dev_pm_qos_update_request(struct dev_pm_qos_request *req,
365 : : s32 new_value)
366 : : {
367 : : s32 curr_value;
368 : : int ret = 0;
369 : :
370 [ # # ]: 0 : if (!req) /*guard against callers passing in null */
371 : : return -EINVAL;
372 : :
373 [ # # # # ]: 0 : if (WARN(!dev_pm_qos_request_active(req),
374 : : "%s() called for unknown object\n", __func__))
375 : : return -EINVAL;
376 : :
377 [ # # ]: 0 : if (IS_ERR_OR_NULL(req->dev->power.qos))
378 : : return -ENODEV;
379 : :
380 [ # # # ]: 0 : switch(req->type) {
381 : : case DEV_PM_QOS_RESUME_LATENCY:
382 : : case DEV_PM_QOS_LATENCY_TOLERANCE:
383 : 0 : curr_value = req->data.pnode.prio;
384 : 0 : break;
385 : : case DEV_PM_QOS_FLAGS:
386 : 0 : curr_value = req->data.flr.flags;
387 : 0 : break;
388 : : default:
389 : : return -EINVAL;
390 : : }
391 : :
392 : 0 : trace_dev_pm_qos_update_request(dev_name(req->dev), req->type,
393 : : new_value);
394 [ # # ]: 0 : if (curr_value != new_value)
395 : 0 : ret = apply_constraint(req, PM_QOS_UPDATE_REQ, new_value);
396 : :
397 : 0 : return ret;
398 : : }
399 : :
400 : : /**
401 : : * dev_pm_qos_update_request - modifies an existing qos request
402 : : * @req : handle to list element holding a dev_pm_qos request to use
403 : : * @new_value: defines the qos request
404 : : *
405 : : * Updates an existing dev PM qos request along with updating the
406 : : * target value.
407 : : *
408 : : * Attempts are made to make this code callable on hot code paths.
409 : : *
410 : : * Returns 1 if the aggregated constraint value has changed,
411 : : * 0 if the aggregated constraint value has not changed,
412 : : * -EINVAL in case of wrong parameters, -ENODEV if the device has been
413 : : * removed from the system
414 : : *
415 : : * Callers should ensure that the target device is not RPM_SUSPENDED before
416 : : * using this function for requests of type DEV_PM_QOS_FLAGS.
417 : : */
418 : 0 : int dev_pm_qos_update_request(struct dev_pm_qos_request *req, s32 new_value)
419 : : {
420 : : int ret;
421 : :
422 : 0 : mutex_lock(&dev_pm_qos_mtx);
423 : 0 : ret = __dev_pm_qos_update_request(req, new_value);
424 : 0 : mutex_unlock(&dev_pm_qos_mtx);
425 : 0 : return ret;
426 : : }
427 : : EXPORT_SYMBOL_GPL(dev_pm_qos_update_request);
428 : :
429 : 404 : static int __dev_pm_qos_remove_request(struct dev_pm_qos_request *req)
430 : : {
431 : : int ret;
432 : :
433 [ + - ]: 404 : if (!req) /*guard against callers passing in null */
434 : : return -EINVAL;
435 : :
436 [ - + + - ]: 404 : if (WARN(!dev_pm_qos_request_active(req),
437 : : "%s() called for unknown object\n", __func__))
438 : : return -EINVAL;
439 : :
440 [ + - ]: 808 : if (IS_ERR_OR_NULL(req->dev->power.qos))
441 : : return -ENODEV;
442 : :
443 : 404 : trace_dev_pm_qos_remove_request(dev_name(req->dev), req->type,
444 : : PM_QOS_DEFAULT_VALUE);
445 : 404 : ret = apply_constraint(req, PM_QOS_REMOVE_REQ, PM_QOS_DEFAULT_VALUE);
446 : 404 : memset(req, 0, sizeof(*req));
447 : 404 : return ret;
448 : : }
449 : :
450 : : /**
451 : : * dev_pm_qos_remove_request - modifies an existing qos request
452 : : * @req: handle to request list element
453 : : *
454 : : * Will remove pm qos request from the list of constraints and
455 : : * recompute the current target value. Call this on slow code paths.
456 : : *
457 : : * Returns 1 if the aggregated constraint value has changed,
458 : : * 0 if the aggregated constraint value has not changed,
459 : : * -EINVAL in case of wrong parameters, -ENODEV if the device has been
460 : : * removed from the system
461 : : *
462 : : * Callers should ensure that the target device is not RPM_SUSPENDED before
463 : : * using this function for requests of type DEV_PM_QOS_FLAGS.
464 : : */
465 : 404 : int dev_pm_qos_remove_request(struct dev_pm_qos_request *req)
466 : : {
467 : : int ret;
468 : :
469 : 404 : mutex_lock(&dev_pm_qos_mtx);
470 : 404 : ret = __dev_pm_qos_remove_request(req);
471 : 404 : mutex_unlock(&dev_pm_qos_mtx);
472 : 404 : return ret;
473 : : }
474 : : EXPORT_SYMBOL_GPL(dev_pm_qos_remove_request);
475 : :
476 : : /**
477 : : * dev_pm_qos_add_notifier - sets notification entry for changes to target value
478 : : * of per-device PM QoS constraints
479 : : *
480 : : * @dev: target device for the constraint
481 : : * @notifier: notifier block managed by caller.
482 : : * @type: request type.
483 : : *
484 : : * Will register the notifier into a notification chain that gets called
485 : : * upon changes to the target value for the device.
486 : : *
487 : : * If the device's constraints object doesn't exist when this routine is called,
488 : : * it will be created (or error code will be returned if that fails).
489 : : */
490 : 404 : int dev_pm_qos_add_notifier(struct device *dev, struct notifier_block *notifier,
491 : : enum dev_pm_qos_req_type type)
492 : : {
493 : : int ret = 0;
494 : :
495 : 404 : mutex_lock(&dev_pm_qos_mtx);
496 : :
497 [ + - ]: 808 : if (IS_ERR(dev->power.qos))
498 : : ret = -ENODEV;
499 [ + - ]: 404 : else if (!dev->power.qos)
500 : 404 : ret = dev_pm_qos_constraints_allocate(dev);
501 : :
502 [ + - ]: 404 : if (ret)
503 : : goto unlock;
504 : :
505 [ + - ]: 404 : switch (type) {
506 : : case DEV_PM_QOS_RESUME_LATENCY:
507 : 404 : ret = blocking_notifier_chain_register(dev->power.qos->resume_latency.notifiers,
508 : : notifier);
509 : 404 : break;
510 : : default:
511 : 0 : WARN_ON(1);
512 : : ret = -EINVAL;
513 : : }
514 : :
515 : : unlock:
516 : 404 : mutex_unlock(&dev_pm_qos_mtx);
517 : 404 : return ret;
518 : : }
519 : : EXPORT_SYMBOL_GPL(dev_pm_qos_add_notifier);
520 : :
521 : : /**
522 : : * dev_pm_qos_remove_notifier - deletes notification for changes to target value
523 : : * of per-device PM QoS constraints
524 : : *
525 : : * @dev: target device for the constraint
526 : : * @notifier: notifier block to be removed.
527 : : * @type: request type.
528 : : *
529 : : * Will remove the notifier from the notification chain that gets called
530 : : * upon changes to the target value.
531 : : */
532 : 0 : int dev_pm_qos_remove_notifier(struct device *dev,
533 : : struct notifier_block *notifier,
534 : : enum dev_pm_qos_req_type type)
535 : : {
536 : : int ret = 0;
537 : :
538 : 0 : mutex_lock(&dev_pm_qos_mtx);
539 : :
540 : : /* Silently return if the constraints object is not present. */
541 [ # # ]: 0 : if (IS_ERR_OR_NULL(dev->power.qos))
542 : : goto unlock;
543 : :
544 [ # # ]: 0 : switch (type) {
545 : : case DEV_PM_QOS_RESUME_LATENCY:
546 : 0 : ret = blocking_notifier_chain_unregister(dev->power.qos->resume_latency.notifiers,
547 : : notifier);
548 : 0 : break;
549 : : default:
550 : 0 : WARN_ON(1);
551 : : ret = -EINVAL;
552 : : }
553 : :
554 : : unlock:
555 : 0 : mutex_unlock(&dev_pm_qos_mtx);
556 : 0 : return ret;
557 : : }
558 : : EXPORT_SYMBOL_GPL(dev_pm_qos_remove_notifier);
559 : :
560 : : /**
561 : : * dev_pm_qos_add_ancestor_request - Add PM QoS request for device's ancestor.
562 : : * @dev: Device whose ancestor to add the request for.
563 : : * @req: Pointer to the preallocated handle.
564 : : * @type: Type of the request.
565 : : * @value: Constraint latency value.
566 : : */
567 : 0 : int dev_pm_qos_add_ancestor_request(struct device *dev,
568 : : struct dev_pm_qos_request *req,
569 : : enum dev_pm_qos_req_type type, s32 value)
570 : : {
571 : 0 : struct device *ancestor = dev->parent;
572 : : int ret = -ENODEV;
573 : :
574 [ # # # ]: 0 : switch (type) {
575 : : case DEV_PM_QOS_RESUME_LATENCY:
576 [ # # # # ]: 0 : while (ancestor && !ancestor->power.ignore_children)
577 : 0 : ancestor = ancestor->parent;
578 : :
579 : : break;
580 : : case DEV_PM_QOS_LATENCY_TOLERANCE:
581 [ # # # # ]: 0 : while (ancestor && !ancestor->power.set_latency_tolerance)
582 : 0 : ancestor = ancestor->parent;
583 : :
584 : : break;
585 : : default:
586 : : ancestor = NULL;
587 : : }
588 [ # # ]: 0 : if (ancestor)
589 : 0 : ret = dev_pm_qos_add_request(ancestor, req, type, value);
590 : :
591 [ # # ]: 0 : if (ret < 0)
592 : 0 : req->dev = NULL;
593 : :
594 : 0 : return ret;
595 : : }
596 : : EXPORT_SYMBOL_GPL(dev_pm_qos_add_ancestor_request);
597 : :
598 : 0 : static void __dev_pm_qos_drop_user_request(struct device *dev,
599 : : enum dev_pm_qos_req_type type)
600 : : {
601 : : struct dev_pm_qos_request *req = NULL;
602 : :
603 [ # # # # ]: 0 : switch(type) {
604 : : case DEV_PM_QOS_RESUME_LATENCY:
605 : 0 : req = dev->power.qos->resume_latency_req;
606 : 0 : dev->power.qos->resume_latency_req = NULL;
607 : 0 : break;
608 : : case DEV_PM_QOS_LATENCY_TOLERANCE:
609 : 0 : req = dev->power.qos->latency_tolerance_req;
610 : 0 : dev->power.qos->latency_tolerance_req = NULL;
611 : 0 : break;
612 : : case DEV_PM_QOS_FLAGS:
613 : 0 : req = dev->power.qos->flags_req;
614 : 0 : dev->power.qos->flags_req = NULL;
615 : 0 : break;
616 : : default:
617 : 0 : WARN_ON(1);
618 : 0 : return;
619 : : }
620 : 0 : __dev_pm_qos_remove_request(req);
621 : 0 : kfree(req);
622 : : }
623 : :
624 : 0 : static void dev_pm_qos_drop_user_request(struct device *dev,
625 : : enum dev_pm_qos_req_type type)
626 : : {
627 : 0 : mutex_lock(&dev_pm_qos_mtx);
628 : 0 : __dev_pm_qos_drop_user_request(dev, type);
629 : 0 : mutex_unlock(&dev_pm_qos_mtx);
630 : 0 : }
631 : :
632 : : /**
633 : : * dev_pm_qos_expose_latency_limit - Expose PM QoS latency limit to user space.
634 : : * @dev: Device whose PM QoS latency limit is to be exposed to user space.
635 : : * @value: Initial value of the latency limit.
636 : : */
637 : 1616 : int dev_pm_qos_expose_latency_limit(struct device *dev, s32 value)
638 : : {
639 : : struct dev_pm_qos_request *req;
640 : : int ret;
641 : :
642 [ + - + - ]: 1616 : if (!device_is_registered(dev) || value < 0)
643 : : return -EINVAL;
644 : :
645 : 1616 : req = kzalloc(sizeof(*req), GFP_KERNEL);
646 [ + - ]: 1616 : if (!req)
647 : : return -ENOMEM;
648 : :
649 : 1616 : ret = dev_pm_qos_add_request(dev, req, DEV_PM_QOS_RESUME_LATENCY, value);
650 [ - + ]: 1616 : if (ret < 0) {
651 : 0 : kfree(req);
652 : 0 : return ret;
653 : : }
654 : :
655 : 1616 : mutex_lock(&dev_pm_qos_sysfs_mtx);
656 : :
657 : 1616 : mutex_lock(&dev_pm_qos_mtx);
658 : :
659 [ + - ]: 3232 : if (IS_ERR_OR_NULL(dev->power.qos))
660 : : ret = -ENODEV;
661 [ - + ]: 1616 : else if (dev->power.qos->resume_latency_req)
662 : : ret = -EEXIST;
663 : :
664 [ - + ]: 1616 : if (ret < 0) {
665 : 0 : __dev_pm_qos_remove_request(req);
666 : 0 : kfree(req);
667 : 0 : mutex_unlock(&dev_pm_qos_mtx);
668 : 0 : goto out;
669 : : }
670 : 1616 : dev->power.qos->resume_latency_req = req;
671 : :
672 : 1616 : mutex_unlock(&dev_pm_qos_mtx);
673 : :
674 : 1616 : ret = pm_qos_sysfs_add_resume_latency(dev);
675 [ - + ]: 1616 : if (ret)
676 : 0 : dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_RESUME_LATENCY);
677 : :
678 : : out:
679 : 1616 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
680 : 1616 : return ret;
681 : : }
682 : : EXPORT_SYMBOL_GPL(dev_pm_qos_expose_latency_limit);
683 : :
684 : 406 : static void __dev_pm_qos_hide_latency_limit(struct device *dev)
685 : : {
686 [ - + # # ]: 812 : if (!IS_ERR_OR_NULL(dev->power.qos) && dev->power.qos->resume_latency_req)
687 : 0 : __dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_RESUME_LATENCY);
688 : 406 : }
689 : :
690 : : /**
691 : : * dev_pm_qos_hide_latency_limit - Hide PM QoS latency limit from user space.
692 : : * @dev: Device whose PM QoS latency limit is to be hidden from user space.
693 : : */
694 : 0 : void dev_pm_qos_hide_latency_limit(struct device *dev)
695 : : {
696 : 0 : mutex_lock(&dev_pm_qos_sysfs_mtx);
697 : :
698 : 0 : pm_qos_sysfs_remove_resume_latency(dev);
699 : :
700 : 0 : mutex_lock(&dev_pm_qos_mtx);
701 : 0 : __dev_pm_qos_hide_latency_limit(dev);
702 : 0 : mutex_unlock(&dev_pm_qos_mtx);
703 : :
704 : 0 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
705 : 0 : }
706 : : EXPORT_SYMBOL_GPL(dev_pm_qos_hide_latency_limit);
707 : :
708 : : /**
709 : : * dev_pm_qos_expose_flags - Expose PM QoS flags of a device to user space.
710 : : * @dev: Device whose PM QoS flags are to be exposed to user space.
711 : : * @val: Initial values of the flags.
712 : : */
713 : 404 : int dev_pm_qos_expose_flags(struct device *dev, s32 val)
714 : : {
715 : : struct dev_pm_qos_request *req;
716 : : int ret;
717 : :
718 [ + - ]: 404 : if (!device_is_registered(dev))
719 : : return -EINVAL;
720 : :
721 : 404 : req = kzalloc(sizeof(*req), GFP_KERNEL);
722 [ + - ]: 404 : if (!req)
723 : : return -ENOMEM;
724 : :
725 : 404 : ret = dev_pm_qos_add_request(dev, req, DEV_PM_QOS_FLAGS, val);
726 [ - + ]: 404 : if (ret < 0) {
727 : 0 : kfree(req);
728 : 0 : return ret;
729 : : }
730 : :
731 : : pm_runtime_get_sync(dev);
732 : 404 : mutex_lock(&dev_pm_qos_sysfs_mtx);
733 : :
734 : 404 : mutex_lock(&dev_pm_qos_mtx);
735 : :
736 [ + - ]: 808 : if (IS_ERR_OR_NULL(dev->power.qos))
737 : : ret = -ENODEV;
738 [ - + ]: 404 : else if (dev->power.qos->flags_req)
739 : : ret = -EEXIST;
740 : :
741 [ - + ]: 404 : if (ret < 0) {
742 : 0 : __dev_pm_qos_remove_request(req);
743 : 0 : kfree(req);
744 : 0 : mutex_unlock(&dev_pm_qos_mtx);
745 : 0 : goto out;
746 : : }
747 : 404 : dev->power.qos->flags_req = req;
748 : :
749 : 404 : mutex_unlock(&dev_pm_qos_mtx);
750 : :
751 : 404 : ret = pm_qos_sysfs_add_flags(dev);
752 [ - + ]: 404 : if (ret)
753 : 0 : dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_FLAGS);
754 : :
755 : : out:
756 : 404 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
757 : : pm_runtime_put(dev);
758 : 404 : return ret;
759 : : }
760 : : EXPORT_SYMBOL_GPL(dev_pm_qos_expose_flags);
761 : :
762 : 406 : static void __dev_pm_qos_hide_flags(struct device *dev)
763 : : {
764 [ - + # # ]: 812 : if (!IS_ERR_OR_NULL(dev->power.qos) && dev->power.qos->flags_req)
765 : 0 : __dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_FLAGS);
766 : 406 : }
767 : :
768 : : /**
769 : : * dev_pm_qos_hide_flags - Hide PM QoS flags of a device from user space.
770 : : * @dev: Device whose PM QoS flags are to be hidden from user space.
771 : : */
772 : 0 : void dev_pm_qos_hide_flags(struct device *dev)
773 : : {
774 : : pm_runtime_get_sync(dev);
775 : 0 : mutex_lock(&dev_pm_qos_sysfs_mtx);
776 : :
777 : 0 : pm_qos_sysfs_remove_flags(dev);
778 : :
779 : 0 : mutex_lock(&dev_pm_qos_mtx);
780 : 0 : __dev_pm_qos_hide_flags(dev);
781 : 0 : mutex_unlock(&dev_pm_qos_mtx);
782 : :
783 : 0 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
784 : : pm_runtime_put(dev);
785 : 0 : }
786 : : EXPORT_SYMBOL_GPL(dev_pm_qos_hide_flags);
787 : :
788 : : /**
789 : : * dev_pm_qos_update_flags - Update PM QoS flags request owned by user space.
790 : : * @dev: Device to update the PM QoS flags request for.
791 : : * @mask: Flags to set/clear.
792 : : * @set: Whether to set or clear the flags (true means set).
793 : : */
794 : 0 : int dev_pm_qos_update_flags(struct device *dev, s32 mask, bool set)
795 : : {
796 : : s32 value;
797 : : int ret;
798 : :
799 : : pm_runtime_get_sync(dev);
800 : 0 : mutex_lock(&dev_pm_qos_mtx);
801 : :
802 [ # # # # ]: 0 : if (IS_ERR_OR_NULL(dev->power.qos) || !dev->power.qos->flags_req) {
803 : : ret = -EINVAL;
804 : : goto out;
805 : : }
806 : :
807 : : value = dev_pm_qos_requested_flags(dev);
808 [ # # ]: 0 : if (set)
809 : 0 : value |= mask;
810 : : else
811 : 0 : value &= ~mask;
812 : :
813 : 0 : ret = __dev_pm_qos_update_request(dev->power.qos->flags_req, value);
814 : :
815 : : out:
816 : 0 : mutex_unlock(&dev_pm_qos_mtx);
817 : : pm_runtime_put(dev);
818 : 0 : return ret;
819 : : }
820 : :
821 : : /**
822 : : * dev_pm_qos_get_user_latency_tolerance - Get user space latency tolerance.
823 : : * @dev: Device to obtain the user space latency tolerance for.
824 : : */
825 : 0 : s32 dev_pm_qos_get_user_latency_tolerance(struct device *dev)
826 : : {
827 : : s32 ret;
828 : :
829 : 0 : mutex_lock(&dev_pm_qos_mtx);
830 : 0 : ret = IS_ERR_OR_NULL(dev->power.qos)
831 [ # # ]: 0 : || !dev->power.qos->latency_tolerance_req ?
832 [ # # ]: 0 : PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT :
833 : : dev->power.qos->latency_tolerance_req->data.pnode.prio;
834 : 0 : mutex_unlock(&dev_pm_qos_mtx);
835 : 0 : return ret;
836 : : }
837 : :
838 : : /**
839 : : * dev_pm_qos_update_user_latency_tolerance - Update user space latency tolerance.
840 : : * @dev: Device to update the user space latency tolerance for.
841 : : * @val: New user space latency tolerance for @dev (negative values disable).
842 : : */
843 : 0 : int dev_pm_qos_update_user_latency_tolerance(struct device *dev, s32 val)
844 : : {
845 : : int ret;
846 : :
847 : 0 : mutex_lock(&dev_pm_qos_mtx);
848 : :
849 [ # # ]: 0 : if (IS_ERR_OR_NULL(dev->power.qos)
850 [ # # ]: 0 : || !dev->power.qos->latency_tolerance_req) {
851 : : struct dev_pm_qos_request *req;
852 : :
853 [ # # ]: 0 : if (val < 0) {
854 [ # # ]: 0 : if (val == PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT)
855 : : ret = 0;
856 : : else
857 : : ret = -EINVAL;
858 : : goto out;
859 : : }
860 : 0 : req = kzalloc(sizeof(*req), GFP_KERNEL);
861 [ # # ]: 0 : if (!req) {
862 : : ret = -ENOMEM;
863 : : goto out;
864 : : }
865 : 0 : ret = __dev_pm_qos_add_request(dev, req, DEV_PM_QOS_LATENCY_TOLERANCE, val);
866 [ # # ]: 0 : if (ret < 0) {
867 : 0 : kfree(req);
868 : 0 : goto out;
869 : : }
870 : 0 : dev->power.qos->latency_tolerance_req = req;
871 : : } else {
872 [ # # ]: 0 : if (val < 0) {
873 : 0 : __dev_pm_qos_drop_user_request(dev, DEV_PM_QOS_LATENCY_TOLERANCE);
874 : : ret = 0;
875 : : } else {
876 : 0 : ret = __dev_pm_qos_update_request(dev->power.qos->latency_tolerance_req, val);
877 : : }
878 : : }
879 : :
880 : : out:
881 : 0 : mutex_unlock(&dev_pm_qos_mtx);
882 : 0 : return ret;
883 : : }
884 : : EXPORT_SYMBOL_GPL(dev_pm_qos_update_user_latency_tolerance);
885 : :
886 : : /**
887 : : * dev_pm_qos_expose_latency_tolerance - Expose latency tolerance to userspace
888 : : * @dev: Device whose latency tolerance to expose
889 : : */
890 : 0 : int dev_pm_qos_expose_latency_tolerance(struct device *dev)
891 : : {
892 : : int ret;
893 : :
894 [ # # ]: 0 : if (!dev->power.set_latency_tolerance)
895 : : return -EINVAL;
896 : :
897 : 0 : mutex_lock(&dev_pm_qos_sysfs_mtx);
898 : 0 : ret = pm_qos_sysfs_add_latency_tolerance(dev);
899 : 0 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
900 : :
901 : 0 : return ret;
902 : : }
903 : : EXPORT_SYMBOL_GPL(dev_pm_qos_expose_latency_tolerance);
904 : :
905 : : /**
906 : : * dev_pm_qos_hide_latency_tolerance - Hide latency tolerance from userspace
907 : : * @dev: Device whose latency tolerance to hide
908 : : */
909 : 0 : void dev_pm_qos_hide_latency_tolerance(struct device *dev)
910 : : {
911 : 0 : mutex_lock(&dev_pm_qos_sysfs_mtx);
912 : 0 : pm_qos_sysfs_remove_latency_tolerance(dev);
913 : 0 : mutex_unlock(&dev_pm_qos_sysfs_mtx);
914 : :
915 : : /* Remove the request from user space now */
916 : : pm_runtime_get_sync(dev);
917 : 0 : dev_pm_qos_update_user_latency_tolerance(dev,
918 : : PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT);
919 : : pm_runtime_put(dev);
920 : 0 : }
921 : : EXPORT_SYMBOL_GPL(dev_pm_qos_hide_latency_tolerance);
|
