Linux Audio

Check our new training course

Loading...
v3.15
  1/*
  2 * drivers/base/power/sysfs.c - sysfs entries for device PM
  3 */
  4
  5#include <linux/device.h>
 
  6#include <linux/string.h>
  7#include <linux/export.h>
  8#include <linux/pm_qos.h>
  9#include <linux/pm_runtime.h>
 
 10#include <linux/atomic.h>
 11#include <linux/jiffies.h>
 12#include "power.h"
 13
 14/*
 15 *	control - Report/change current runtime PM setting of the device
 16 *
 17 *	Runtime power management of a device can be blocked with the help of
 18 *	this attribute.  All devices have one of the following two values for
 19 *	the power/control file:
 20 *
 21 *	 + "auto\n" to allow the device to be power managed at run time;
 22 *	 + "on\n" to prevent the device from being power managed at run time;
 23 *
 24 *	The default for all devices is "auto", which means that devices may be
 25 *	subject to automatic power management, depending on their drivers.
 26 *	Changing this attribute to "on" prevents the driver from power managing
 27 *	the device at run time.  Doing that while the device is suspended causes
 28 *	it to be woken up.
 29 *
 30 *	wakeup - Report/change current wakeup option for device
 31 *
 32 *	Some devices support "wakeup" events, which are hardware signals
 33 *	used to activate devices from suspended or low power states.  Such
 34 *	devices have one of three values for the sysfs power/wakeup file:
 35 *
 36 *	 + "enabled\n" to issue the events;
 37 *	 + "disabled\n" not to do so; or
 38 *	 + "\n" for temporary or permanent inability to issue wakeup.
 39 *
 40 *	(For example, unconfigured USB devices can't issue wakeups.)
 41 *
 42 *	Familiar examples of devices that can issue wakeup events include
 43 *	keyboards and mice (both PS2 and USB styles), power buttons, modems,
 44 *	"Wake-On-LAN" Ethernet links, GPIO lines, and more.  Some events
 45 *	will wake the entire system from a suspend state; others may just
 46 *	wake up the device (if the system as a whole is already active).
 47 *	Some wakeup events use normal IRQ lines; other use special out
 48 *	of band signaling.
 49 *
 50 *	It is the responsibility of device drivers to enable (or disable)
 51 *	wakeup signaling as part of changing device power states, respecting
 52 *	the policy choices provided through the driver model.
 53 *
 54 *	Devices may not be able to generate wakeup events from all power
 55 *	states.  Also, the events may be ignored in some configurations;
 56 *	for example, they might need help from other devices that aren't
 57 *	active, or which may have wakeup disabled.  Some drivers rely on
 58 *	wakeup events internally (unless they are disabled), keeping
 59 *	their hardware in low power modes whenever they're unused.  This
 60 *	saves runtime power, without requiring system-wide sleep states.
 61 *
 62 *	async - Report/change current async suspend setting for the device
 63 *
 64 *	Asynchronous suspend and resume of the device during system-wide power
 65 *	state transitions can be enabled by writing "enabled" to this file.
 66 *	Analogously, if "disabled" is written to this file, the device will be
 67 *	suspended and resumed synchronously.
 68 *
 69 *	All devices have one of the following two values for power/async:
 70 *
 71 *	 + "enabled\n" to permit the asynchronous suspend/resume of the device;
 72 *	 + "disabled\n" to forbid it;
 73 *
 74 *	NOTE: It generally is unsafe to permit the asynchronous suspend/resume
 75 *	of a device unless it is certain that all of the PM dependencies of the
 76 *	device are known to the PM core.  However, for some devices this
 77 *	attribute is set to "enabled" by bus type code or device drivers and in
 78 *	that cases it should be safe to leave the default value.
 79 *
 80 *	autosuspend_delay_ms - Report/change a device's autosuspend_delay value
 81 *
 82 *	Some drivers don't want to carry out a runtime suspend as soon as a
 83 *	device becomes idle; they want it always to remain idle for some period
 84 *	of time before suspending it.  This period is the autosuspend_delay
 85 *	value (expressed in milliseconds) and it can be controlled by the user.
 86 *	If the value is negative then the device will never be runtime
 87 *	suspended.
 88 *
 89 *	NOTE: The autosuspend_delay_ms attribute and the autosuspend_delay
 90 *	value are used only if the driver calls pm_runtime_use_autosuspend().
 91 *
 92 *	wakeup_count - Report the number of wakeup events related to the device
 93 */
 94
 95static const char enabled[] = "enabled";
 96static const char disabled[] = "disabled";
 97
 98const char power_group_name[] = "power";
 99EXPORT_SYMBOL_GPL(power_group_name);
100
101#ifdef CONFIG_PM_RUNTIME
102static const char ctrl_auto[] = "auto";
103static const char ctrl_on[] = "on";
104
105static ssize_t control_show(struct device *dev, struct device_attribute *attr,
106			    char *buf)
107{
108	return sprintf(buf, "%s\n",
109				dev->power.runtime_auto ? ctrl_auto : ctrl_on);
110}
111
112static ssize_t control_store(struct device * dev, struct device_attribute *attr,
113			     const char * buf, size_t n)
114{
115	char *cp;
116	int len = n;
117
118	cp = memchr(buf, '\n', n);
119	if (cp)
120		len = cp - buf;
121	device_lock(dev);
122	if (len == sizeof ctrl_auto - 1 && strncmp(buf, ctrl_auto, len) == 0)
123		pm_runtime_allow(dev);
124	else if (len == sizeof ctrl_on - 1 && strncmp(buf, ctrl_on, len) == 0)
125		pm_runtime_forbid(dev);
126	else
127		n = -EINVAL;
128	device_unlock(dev);
129	return n;
130}
131
132static DEVICE_ATTR(control, 0644, control_show, control_store);
133
134static ssize_t rtpm_active_time_show(struct device *dev,
135				struct device_attribute *attr, char *buf)
 
136{
137	int ret;
138	spin_lock_irq(&dev->power.lock);
139	update_pm_runtime_accounting(dev);
140	ret = sprintf(buf, "%i\n", jiffies_to_msecs(dev->power.active_jiffies));
141	spin_unlock_irq(&dev->power.lock);
142	return ret;
143}
144
145static DEVICE_ATTR(runtime_active_time, 0444, rtpm_active_time_show, NULL);
146
147static ssize_t rtpm_suspended_time_show(struct device *dev,
148				struct device_attribute *attr, char *buf)
 
149{
150	int ret;
151	spin_lock_irq(&dev->power.lock);
152	update_pm_runtime_accounting(dev);
153	ret = sprintf(buf, "%i\n",
154		jiffies_to_msecs(dev->power.suspended_jiffies));
155	spin_unlock_irq(&dev->power.lock);
156	return ret;
157}
158
159static DEVICE_ATTR(runtime_suspended_time, 0444, rtpm_suspended_time_show, NULL);
160
161static ssize_t rtpm_status_show(struct device *dev,
162				struct device_attribute *attr, char *buf)
163{
164	const char *p;
165
166	if (dev->power.runtime_error) {
167		p = "error\n";
168	} else if (dev->power.disable_depth) {
169		p = "unsupported\n";
170	} else {
171		switch (dev->power.runtime_status) {
172		case RPM_SUSPENDED:
173			p = "suspended\n";
174			break;
175		case RPM_SUSPENDING:
176			p = "suspending\n";
177			break;
178		case RPM_RESUMING:
179			p = "resuming\n";
180			break;
181		case RPM_ACTIVE:
182			p = "active\n";
183			break;
184		default:
185			return -EIO;
186		}
187	}
188	return sprintf(buf, p);
189}
190
191static DEVICE_ATTR(runtime_status, 0444, rtpm_status_show, NULL);
192
193static ssize_t autosuspend_delay_ms_show(struct device *dev,
194		struct device_attribute *attr, char *buf)
 
195{
196	if (!dev->power.use_autosuspend)
197		return -EIO;
198	return sprintf(buf, "%d\n", dev->power.autosuspend_delay);
 
199}
200
201static ssize_t autosuspend_delay_ms_store(struct device *dev,
202		struct device_attribute *attr, const char *buf, size_t n)
203{
204	long delay;
205
206	if (!dev->power.use_autosuspend)
207		return -EIO;
208
209	if (kstrtol(buf, 10, &delay) != 0 || delay != (int) delay)
210		return -EINVAL;
211
212	device_lock(dev);
213	pm_runtime_set_autosuspend_delay(dev, delay);
214	device_unlock(dev);
215	return n;
216}
217
218static DEVICE_ATTR(autosuspend_delay_ms, 0644, autosuspend_delay_ms_show,
219		autosuspend_delay_ms_store);
220
221static ssize_t pm_qos_resume_latency_show(struct device *dev,
222					  struct device_attribute *attr,
223					  char *buf)
224{
225	return sprintf(buf, "%d\n", dev_pm_qos_requested_resume_latency(dev));
 
 
 
 
 
 
 
226}
227
228static ssize_t pm_qos_resume_latency_store(struct device *dev,
229					   struct device_attribute *attr,
230					   const char *buf, size_t n)
231{
232	s32 value;
233	int ret;
234
235	if (kstrtos32(buf, 0, &value))
236		return -EINVAL;
237
238	if (value < 0)
 
 
 
 
 
 
 
 
 
239		return -EINVAL;
 
240
241	ret = dev_pm_qos_update_request(dev->power.qos->resume_latency_req,
242					value);
243	return ret < 0 ? ret : n;
244}
245
246static DEVICE_ATTR(pm_qos_resume_latency_us, 0644,
247		   pm_qos_resume_latency_show, pm_qos_resume_latency_store);
248
249static ssize_t pm_qos_latency_tolerance_show(struct device *dev,
250					     struct device_attribute *attr,
251					     char *buf)
252{
253	s32 value = dev_pm_qos_get_user_latency_tolerance(dev);
254
255	if (value < 0)
256		return sprintf(buf, "auto\n");
257	else if (value == PM_QOS_LATENCY_ANY)
258		return sprintf(buf, "any\n");
259
260	return sprintf(buf, "%d\n", value);
261}
262
263static ssize_t pm_qos_latency_tolerance_store(struct device *dev,
264					      struct device_attribute *attr,
265					      const char *buf, size_t n)
266{
267	s32 value;
268	int ret;
269
270	if (kstrtos32(buf, 0, &value)) {
271		if (!strcmp(buf, "auto") || !strcmp(buf, "auto\n"))
 
 
 
 
272			value = PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT;
273		else if (!strcmp(buf, "any") || !strcmp(buf, "any\n"))
274			value = PM_QOS_LATENCY_ANY;
 
 
275	}
276	ret = dev_pm_qos_update_user_latency_tolerance(dev, value);
277	return ret < 0 ? ret : n;
278}
279
280static DEVICE_ATTR(pm_qos_latency_tolerance_us, 0644,
281		   pm_qos_latency_tolerance_show, pm_qos_latency_tolerance_store);
282
283static ssize_t pm_qos_no_power_off_show(struct device *dev,
284					struct device_attribute *attr,
285					char *buf)
286{
287	return sprintf(buf, "%d\n", !!(dev_pm_qos_requested_flags(dev)
288					& PM_QOS_FLAG_NO_POWER_OFF));
289}
290
291static ssize_t pm_qos_no_power_off_store(struct device *dev,
292					 struct device_attribute *attr,
293					 const char *buf, size_t n)
294{
295	int ret;
296
297	if (kstrtoint(buf, 0, &ret))
298		return -EINVAL;
299
300	if (ret != 0 && ret != 1)
301		return -EINVAL;
302
303	ret = dev_pm_qos_update_flags(dev, PM_QOS_FLAG_NO_POWER_OFF, ret);
304	return ret < 0 ? ret : n;
305}
306
307static DEVICE_ATTR(pm_qos_no_power_off, 0644,
308		   pm_qos_no_power_off_show, pm_qos_no_power_off_store);
309
310static ssize_t pm_qos_remote_wakeup_show(struct device *dev,
311					 struct device_attribute *attr,
312					 char *buf)
313{
314	return sprintf(buf, "%d\n", !!(dev_pm_qos_requested_flags(dev)
315					& PM_QOS_FLAG_REMOTE_WAKEUP));
316}
317
318static ssize_t pm_qos_remote_wakeup_store(struct device *dev,
319					  struct device_attribute *attr,
320					  const char *buf, size_t n)
321{
322	int ret;
323
324	if (kstrtoint(buf, 0, &ret))
325		return -EINVAL;
326
327	if (ret != 0 && ret != 1)
328		return -EINVAL;
329
330	ret = dev_pm_qos_update_flags(dev, PM_QOS_FLAG_REMOTE_WAKEUP, ret);
331	return ret < 0 ? ret : n;
332}
333
334static DEVICE_ATTR(pm_qos_remote_wakeup, 0644,
335		   pm_qos_remote_wakeup_show, pm_qos_remote_wakeup_store);
336#endif /* CONFIG_PM_RUNTIME */
337
338#ifdef CONFIG_PM_SLEEP
339static ssize_t
340wake_show(struct device * dev, struct device_attribute *attr, char * buf)
 
 
 
341{
342	return sprintf(buf, "%s\n", device_can_wakeup(dev)
343		? (device_may_wakeup(dev) ? enabled : disabled)
344		: "");
345}
346
347static ssize_t
348wake_store(struct device * dev, struct device_attribute *attr,
349	const char * buf, size_t n)
350{
351	char *cp;
352	int len = n;
353
354	if (!device_can_wakeup(dev))
355		return -EINVAL;
356
357	cp = memchr(buf, '\n', n);
358	if (cp)
359		len = cp - buf;
360	if (len == sizeof enabled - 1
361			&& strncmp(buf, enabled, sizeof enabled - 1) == 0)
362		device_set_wakeup_enable(dev, 1);
363	else if (len == sizeof disabled - 1
364			&& strncmp(buf, disabled, sizeof disabled - 1) == 0)
365		device_set_wakeup_enable(dev, 0);
366	else
367		return -EINVAL;
368	return n;
369}
370
371static DEVICE_ATTR(wakeup, 0644, wake_show, wake_store);
372
373static ssize_t wakeup_count_show(struct device *dev,
374				struct device_attribute *attr, char *buf)
375{
376	unsigned long count = 0;
377	bool enabled = false;
378
379	spin_lock_irq(&dev->power.lock);
380	if (dev->power.wakeup) {
381		count = dev->power.wakeup->event_count;
382		enabled = true;
383	}
384	spin_unlock_irq(&dev->power.lock);
385	return enabled ? sprintf(buf, "%lu\n", count) : sprintf(buf, "\n");
 
 
 
386}
387
388static DEVICE_ATTR(wakeup_count, 0444, wakeup_count_show, NULL);
389
390static ssize_t wakeup_active_count_show(struct device *dev,
391				struct device_attribute *attr, char *buf)
 
392{
393	unsigned long count = 0;
394	bool enabled = false;
395
396	spin_lock_irq(&dev->power.lock);
397	if (dev->power.wakeup) {
398		count = dev->power.wakeup->active_count;
399		enabled = true;
400	}
401	spin_unlock_irq(&dev->power.lock);
402	return enabled ? sprintf(buf, "%lu\n", count) : sprintf(buf, "\n");
 
 
 
403}
404
405static DEVICE_ATTR(wakeup_active_count, 0444, wakeup_active_count_show, NULL);
406
407static ssize_t wakeup_abort_count_show(struct device *dev,
408					struct device_attribute *attr,
409					char *buf)
410{
411	unsigned long count = 0;
412	bool enabled = false;
413
414	spin_lock_irq(&dev->power.lock);
415	if (dev->power.wakeup) {
416		count = dev->power.wakeup->wakeup_count;
417		enabled = true;
418	}
419	spin_unlock_irq(&dev->power.lock);
420	return enabled ? sprintf(buf, "%lu\n", count) : sprintf(buf, "\n");
 
 
 
421}
422
423static DEVICE_ATTR(wakeup_abort_count, 0444, wakeup_abort_count_show, NULL);
424
425static ssize_t wakeup_expire_count_show(struct device *dev,
426					struct device_attribute *attr,
427					char *buf)
428{
429	unsigned long count = 0;
430	bool enabled = false;
431
432	spin_lock_irq(&dev->power.lock);
433	if (dev->power.wakeup) {
434		count = dev->power.wakeup->expire_count;
435		enabled = true;
436	}
437	spin_unlock_irq(&dev->power.lock);
438	return enabled ? sprintf(buf, "%lu\n", count) : sprintf(buf, "\n");
 
 
 
439}
440
441static DEVICE_ATTR(wakeup_expire_count, 0444, wakeup_expire_count_show, NULL);
442
443static ssize_t wakeup_active_show(struct device *dev,
444				struct device_attribute *attr, char *buf)
445{
446	unsigned int active = 0;
447	bool enabled = false;
448
449	spin_lock_irq(&dev->power.lock);
450	if (dev->power.wakeup) {
451		active = dev->power.wakeup->active;
452		enabled = true;
453	}
454	spin_unlock_irq(&dev->power.lock);
455	return enabled ? sprintf(buf, "%u\n", active) : sprintf(buf, "\n");
 
 
 
456}
457
458static DEVICE_ATTR(wakeup_active, 0444, wakeup_active_show, NULL);
459
460static ssize_t wakeup_total_time_show(struct device *dev,
461				struct device_attribute *attr, char *buf)
 
462{
463	s64 msec = 0;
464	bool enabled = false;
465
466	spin_lock_irq(&dev->power.lock);
467	if (dev->power.wakeup) {
468		msec = ktime_to_ms(dev->power.wakeup->total_time);
469		enabled = true;
470	}
471	spin_unlock_irq(&dev->power.lock);
472	return enabled ? sprintf(buf, "%lld\n", msec) : sprintf(buf, "\n");
 
 
 
473}
474
475static DEVICE_ATTR(wakeup_total_time_ms, 0444, wakeup_total_time_show, NULL);
476
477static ssize_t wakeup_max_time_show(struct device *dev,
478				struct device_attribute *attr, char *buf)
479{
480	s64 msec = 0;
481	bool enabled = false;
482
483	spin_lock_irq(&dev->power.lock);
484	if (dev->power.wakeup) {
485		msec = ktime_to_ms(dev->power.wakeup->max_time);
486		enabled = true;
487	}
488	spin_unlock_irq(&dev->power.lock);
489	return enabled ? sprintf(buf, "%lld\n", msec) : sprintf(buf, "\n");
 
 
 
490}
491
492static DEVICE_ATTR(wakeup_max_time_ms, 0444, wakeup_max_time_show, NULL);
493
494static ssize_t wakeup_last_time_show(struct device *dev,
495				struct device_attribute *attr, char *buf)
 
496{
497	s64 msec = 0;
498	bool enabled = false;
499
500	spin_lock_irq(&dev->power.lock);
501	if (dev->power.wakeup) {
502		msec = ktime_to_ms(dev->power.wakeup->last_time);
503		enabled = true;
504	}
505	spin_unlock_irq(&dev->power.lock);
506	return enabled ? sprintf(buf, "%lld\n", msec) : sprintf(buf, "\n");
 
 
 
 
 
 
 
 
 
 
 
507}
508
509static DEVICE_ATTR(wakeup_last_time_ms, 0444, wakeup_last_time_show, NULL);
510
511#ifdef CONFIG_PM_AUTOSLEEP
512static ssize_t wakeup_prevent_sleep_time_show(struct device *dev,
513					      struct device_attribute *attr,
514					      char *buf)
515{
516	s64 msec = 0;
517	bool enabled = false;
518
519	spin_lock_irq(&dev->power.lock);
520	if (dev->power.wakeup) {
521		msec = ktime_to_ms(dev->power.wakeup->prevent_sleep_time);
522		enabled = true;
523	}
524	spin_unlock_irq(&dev->power.lock);
525	return enabled ? sprintf(buf, "%lld\n", msec) : sprintf(buf, "\n");
 
 
 
526}
527
528static DEVICE_ATTR(wakeup_prevent_sleep_time_ms, 0444,
529		   wakeup_prevent_sleep_time_show, NULL);
530#endif /* CONFIG_PM_AUTOSLEEP */
531#endif /* CONFIG_PM_SLEEP */
532
533#ifdef CONFIG_PM_ADVANCED_DEBUG
534#ifdef CONFIG_PM_RUNTIME
535
536static ssize_t rtpm_usagecount_show(struct device *dev,
537				    struct device_attribute *attr, char *buf)
538{
539	return sprintf(buf, "%d\n", atomic_read(&dev->power.usage_count));
540}
 
541
542static ssize_t rtpm_children_show(struct device *dev,
 
543				  struct device_attribute *attr, char *buf)
544{
545	return sprintf(buf, "%d\n", dev->power.ignore_children ?
546		0 : atomic_read(&dev->power.child_count));
547}
 
548
549static ssize_t rtpm_enabled_show(struct device *dev,
550				 struct device_attribute *attr, char *buf)
 
551{
552	if ((dev->power.disable_depth) && (dev->power.runtime_auto == false))
553		return sprintf(buf, "disabled & forbidden\n");
554	else if (dev->power.disable_depth)
555		return sprintf(buf, "disabled\n");
556	else if (dev->power.runtime_auto == false)
557		return sprintf(buf, "forbidden\n");
558	return sprintf(buf, "enabled\n");
559}
 
 
 
 
 
 
560
561static DEVICE_ATTR(runtime_usage, 0444, rtpm_usagecount_show, NULL);
562static DEVICE_ATTR(runtime_active_kids, 0444, rtpm_children_show, NULL);
563static DEVICE_ATTR(runtime_enabled, 0444, rtpm_enabled_show, NULL);
 
 
 
 
 
564
565#endif
 
 
566
567#ifdef CONFIG_PM_SLEEP
568
569static ssize_t async_show(struct device *dev, struct device_attribute *attr,
570			  char *buf)
571{
572	return sprintf(buf, "%s\n",
573			device_async_suspend_enabled(dev) ? enabled : disabled);
 
574}
575
576static ssize_t async_store(struct device *dev, struct device_attribute *attr,
577			   const char *buf, size_t n)
578{
579	char *cp;
580	int len = n;
581
582	cp = memchr(buf, '\n', n);
583	if (cp)
584		len = cp - buf;
585	if (len == sizeof enabled - 1 && strncmp(buf, enabled, len) == 0)
586		device_enable_async_suspend(dev);
587	else if (len == sizeof disabled - 1 && strncmp(buf, disabled, len) == 0)
588		device_disable_async_suspend(dev);
589	else
590		return -EINVAL;
591	return n;
592}
593
594static DEVICE_ATTR(async, 0644, async_show, async_store);
595
596#endif
597#endif /* CONFIG_PM_ADVANCED_DEBUG */
598
599static struct attribute *power_attrs[] = {
600#ifdef CONFIG_PM_ADVANCED_DEBUG
601#ifdef CONFIG_PM_SLEEP
602	&dev_attr_async.attr,
603#endif
604#ifdef CONFIG_PM_RUNTIME
605	&dev_attr_runtime_status.attr,
606	&dev_attr_runtime_usage.attr,
607	&dev_attr_runtime_active_kids.attr,
608	&dev_attr_runtime_enabled.attr,
609#endif
610#endif /* CONFIG_PM_ADVANCED_DEBUG */
611	NULL,
612};
613static struct attribute_group pm_attr_group = {
614	.name	= power_group_name,
615	.attrs	= power_attrs,
616};
617
618static struct attribute *wakeup_attrs[] = {
619#ifdef CONFIG_PM_SLEEP
620	&dev_attr_wakeup.attr,
621	&dev_attr_wakeup_count.attr,
622	&dev_attr_wakeup_active_count.attr,
623	&dev_attr_wakeup_abort_count.attr,
624	&dev_attr_wakeup_expire_count.attr,
625	&dev_attr_wakeup_active.attr,
626	&dev_attr_wakeup_total_time_ms.attr,
627	&dev_attr_wakeup_max_time_ms.attr,
628	&dev_attr_wakeup_last_time_ms.attr,
629#ifdef CONFIG_PM_AUTOSLEEP
630	&dev_attr_wakeup_prevent_sleep_time_ms.attr,
631#endif
632#endif
633	NULL,
634};
635static struct attribute_group pm_wakeup_attr_group = {
636	.name	= power_group_name,
637	.attrs	= wakeup_attrs,
638};
639
640static struct attribute *runtime_attrs[] = {
641#ifdef CONFIG_PM_RUNTIME
642#ifndef CONFIG_PM_ADVANCED_DEBUG
643	&dev_attr_runtime_status.attr,
644#endif
645	&dev_attr_control.attr,
646	&dev_attr_runtime_suspended_time.attr,
647	&dev_attr_runtime_active_time.attr,
648	&dev_attr_autosuspend_delay_ms.attr,
649#endif /* CONFIG_PM_RUNTIME */
650	NULL,
651};
652static struct attribute_group pm_runtime_attr_group = {
653	.name	= power_group_name,
654	.attrs	= runtime_attrs,
655};
656
657static struct attribute *pm_qos_resume_latency_attrs[] = {
658#ifdef CONFIG_PM_RUNTIME
659	&dev_attr_pm_qos_resume_latency_us.attr,
660#endif /* CONFIG_PM_RUNTIME */
661	NULL,
662};
663static struct attribute_group pm_qos_resume_latency_attr_group = {
664	.name	= power_group_name,
665	.attrs	= pm_qos_resume_latency_attrs,
666};
667
668static struct attribute *pm_qos_latency_tolerance_attrs[] = {
669#ifdef CONFIG_PM_RUNTIME
670	&dev_attr_pm_qos_latency_tolerance_us.attr,
671#endif /* CONFIG_PM_RUNTIME */
672	NULL,
673};
674static struct attribute_group pm_qos_latency_tolerance_attr_group = {
675	.name	= power_group_name,
676	.attrs	= pm_qos_latency_tolerance_attrs,
677};
678
679static struct attribute *pm_qos_flags_attrs[] = {
680#ifdef CONFIG_PM_RUNTIME
681	&dev_attr_pm_qos_no_power_off.attr,
682	&dev_attr_pm_qos_remote_wakeup.attr,
683#endif /* CONFIG_PM_RUNTIME */
684	NULL,
685};
686static struct attribute_group pm_qos_flags_attr_group = {
687	.name	= power_group_name,
688	.attrs	= pm_qos_flags_attrs,
689};
690
691int dpm_sysfs_add(struct device *dev)
692{
693	int rc;
694
 
 
 
 
695	rc = sysfs_create_group(&dev->kobj, &pm_attr_group);
696	if (rc)
697		return rc;
698
699	if (pm_runtime_callbacks_present(dev)) {
700		rc = sysfs_merge_group(&dev->kobj, &pm_runtime_attr_group);
701		if (rc)
702			goto err_out;
703	}
704	if (device_can_wakeup(dev)) {
705		rc = sysfs_merge_group(&dev->kobj, &pm_wakeup_attr_group);
706		if (rc)
707			goto err_runtime;
708	}
709	if (dev->power.set_latency_tolerance) {
710		rc = sysfs_merge_group(&dev->kobj,
711				       &pm_qos_latency_tolerance_attr_group);
712		if (rc)
713			goto err_wakeup;
714	}
 
 
 
715	return 0;
716
 
 
717 err_wakeup:
718	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
719 err_runtime:
720	sysfs_unmerge_group(&dev->kobj, &pm_runtime_attr_group);
721 err_out:
722	sysfs_remove_group(&dev->kobj, &pm_attr_group);
723	return rc;
724}
725
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
726int wakeup_sysfs_add(struct device *dev)
727{
728	return sysfs_merge_group(&dev->kobj, &pm_wakeup_attr_group);
 
 
 
 
 
729}
730
731void wakeup_sysfs_remove(struct device *dev)
732{
733	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
 
734}
735
736int pm_qos_sysfs_add_resume_latency(struct device *dev)
737{
738	return sysfs_merge_group(&dev->kobj, &pm_qos_resume_latency_attr_group);
739}
740
741void pm_qos_sysfs_remove_resume_latency(struct device *dev)
742{
743	sysfs_unmerge_group(&dev->kobj, &pm_qos_resume_latency_attr_group);
744}
745
746int pm_qos_sysfs_add_flags(struct device *dev)
747{
748	return sysfs_merge_group(&dev->kobj, &pm_qos_flags_attr_group);
749}
750
751void pm_qos_sysfs_remove_flags(struct device *dev)
752{
753	sysfs_unmerge_group(&dev->kobj, &pm_qos_flags_attr_group);
754}
755
 
 
 
 
 
 
 
 
 
 
 
756void rpm_sysfs_remove(struct device *dev)
757{
758	sysfs_unmerge_group(&dev->kobj, &pm_runtime_attr_group);
759}
760
761void dpm_sysfs_remove(struct device *dev)
762{
 
 
763	sysfs_unmerge_group(&dev->kobj, &pm_qos_latency_tolerance_attr_group);
764	dev_pm_qos_constraints_destroy(dev);
765	rpm_sysfs_remove(dev);
766	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
767	sysfs_remove_group(&dev->kobj, &pm_attr_group);
768}
v6.2
  1// SPDX-License-Identifier: GPL-2.0
  2/* sysfs entries for device PM */
 
 
  3#include <linux/device.h>
  4#include <linux/kobject.h>
  5#include <linux/string.h>
  6#include <linux/export.h>
  7#include <linux/pm_qos.h>
  8#include <linux/pm_runtime.h>
  9#include <linux/pm_wakeup.h>
 10#include <linux/atomic.h>
 11#include <linux/jiffies.h>
 12#include "power.h"
 13
 14/*
 15 *	control - Report/change current runtime PM setting of the device
 16 *
 17 *	Runtime power management of a device can be blocked with the help of
 18 *	this attribute.  All devices have one of the following two values for
 19 *	the power/control file:
 20 *
 21 *	 + "auto\n" to allow the device to be power managed at run time;
 22 *	 + "on\n" to prevent the device from being power managed at run time;
 23 *
 24 *	The default for all devices is "auto", which means that devices may be
 25 *	subject to automatic power management, depending on their drivers.
 26 *	Changing this attribute to "on" prevents the driver from power managing
 27 *	the device at run time.  Doing that while the device is suspended causes
 28 *	it to be woken up.
 29 *
 30 *	wakeup - Report/change current wakeup option for device
 31 *
 32 *	Some devices support "wakeup" events, which are hardware signals
 33 *	used to activate devices from suspended or low power states.  Such
 34 *	devices have one of three values for the sysfs power/wakeup file:
 35 *
 36 *	 + "enabled\n" to issue the events;
 37 *	 + "disabled\n" not to do so; or
 38 *	 + "\n" for temporary or permanent inability to issue wakeup.
 39 *
 40 *	(For example, unconfigured USB devices can't issue wakeups.)
 41 *
 42 *	Familiar examples of devices that can issue wakeup events include
 43 *	keyboards and mice (both PS2 and USB styles), power buttons, modems,
 44 *	"Wake-On-LAN" Ethernet links, GPIO lines, and more.  Some events
 45 *	will wake the entire system from a suspend state; others may just
 46 *	wake up the device (if the system as a whole is already active).
 47 *	Some wakeup events use normal IRQ lines; other use special out
 48 *	of band signaling.
 49 *
 50 *	It is the responsibility of device drivers to enable (or disable)
 51 *	wakeup signaling as part of changing device power states, respecting
 52 *	the policy choices provided through the driver model.
 53 *
 54 *	Devices may not be able to generate wakeup events from all power
 55 *	states.  Also, the events may be ignored in some configurations;
 56 *	for example, they might need help from other devices that aren't
 57 *	active, or which may have wakeup disabled.  Some drivers rely on
 58 *	wakeup events internally (unless they are disabled), keeping
 59 *	their hardware in low power modes whenever they're unused.  This
 60 *	saves runtime power, without requiring system-wide sleep states.
 61 *
 62 *	async - Report/change current async suspend setting for the device
 63 *
 64 *	Asynchronous suspend and resume of the device during system-wide power
 65 *	state transitions can be enabled by writing "enabled" to this file.
 66 *	Analogously, if "disabled" is written to this file, the device will be
 67 *	suspended and resumed synchronously.
 68 *
 69 *	All devices have one of the following two values for power/async:
 70 *
 71 *	 + "enabled\n" to permit the asynchronous suspend/resume of the device;
 72 *	 + "disabled\n" to forbid it;
 73 *
 74 *	NOTE: It generally is unsafe to permit the asynchronous suspend/resume
 75 *	of a device unless it is certain that all of the PM dependencies of the
 76 *	device are known to the PM core.  However, for some devices this
 77 *	attribute is set to "enabled" by bus type code or device drivers and in
 78 *	that cases it should be safe to leave the default value.
 79 *
 80 *	autosuspend_delay_ms - Report/change a device's autosuspend_delay value
 81 *
 82 *	Some drivers don't want to carry out a runtime suspend as soon as a
 83 *	device becomes idle; they want it always to remain idle for some period
 84 *	of time before suspending it.  This period is the autosuspend_delay
 85 *	value (expressed in milliseconds) and it can be controlled by the user.
 86 *	If the value is negative then the device will never be runtime
 87 *	suspended.
 88 *
 89 *	NOTE: The autosuspend_delay_ms attribute and the autosuspend_delay
 90 *	value are used only if the driver calls pm_runtime_use_autosuspend().
 91 *
 92 *	wakeup_count - Report the number of wakeup events related to the device
 93 */
 94
 
 
 
 95const char power_group_name[] = "power";
 96EXPORT_SYMBOL_GPL(power_group_name);
 97
 
 98static const char ctrl_auto[] = "auto";
 99static const char ctrl_on[] = "on";
100
101static ssize_t control_show(struct device *dev, struct device_attribute *attr,
102			    char *buf)
103{
104	return sysfs_emit(buf, "%s\n",
105			  dev->power.runtime_auto ? ctrl_auto : ctrl_on);
106}
107
108static ssize_t control_store(struct device * dev, struct device_attribute *attr,
109			     const char * buf, size_t n)
110{
 
 
 
 
 
 
111	device_lock(dev);
112	if (sysfs_streq(buf, ctrl_auto))
113		pm_runtime_allow(dev);
114	else if (sysfs_streq(buf, ctrl_on))
115		pm_runtime_forbid(dev);
116	else
117		n = -EINVAL;
118	device_unlock(dev);
119	return n;
120}
121
122static DEVICE_ATTR_RW(control);
123
124static ssize_t runtime_active_time_show(struct device *dev,
125					struct device_attribute *attr,
126					char *buf)
127{
128	u64 tmp = pm_runtime_active_time(dev);
129
130	do_div(tmp, NSEC_PER_MSEC);
131
132	return sysfs_emit(buf, "%llu\n", tmp);
 
133}
134
135static DEVICE_ATTR_RO(runtime_active_time);
136
137static ssize_t runtime_suspended_time_show(struct device *dev,
138					   struct device_attribute *attr,
139					   char *buf)
140{
141	u64 tmp = pm_runtime_suspended_time(dev);
142
143	do_div(tmp, NSEC_PER_MSEC);
144
145	return sysfs_emit(buf, "%llu\n", tmp);
 
 
146}
147
148static DEVICE_ATTR_RO(runtime_suspended_time);
149
150static ssize_t runtime_status_show(struct device *dev,
151				   struct device_attribute *attr, char *buf)
152{
153	const char *output;
154
155	if (dev->power.runtime_error) {
156		output = "error";
157	} else if (dev->power.disable_depth) {
158		output = "unsupported";
159	} else {
160		switch (dev->power.runtime_status) {
161		case RPM_SUSPENDED:
162			output = "suspended";
163			break;
164		case RPM_SUSPENDING:
165			output = "suspending";
166			break;
167		case RPM_RESUMING:
168			output = "resuming";
169			break;
170		case RPM_ACTIVE:
171			output = "active";
172			break;
173		default:
174			return -EIO;
175		}
176	}
177	return sysfs_emit(buf, "%s\n", output);
178}
179
180static DEVICE_ATTR_RO(runtime_status);
181
182static ssize_t autosuspend_delay_ms_show(struct device *dev,
183					 struct device_attribute *attr,
184					 char *buf)
185{
186	if (!dev->power.use_autosuspend)
187		return -EIO;
188
189	return sysfs_emit(buf, "%d\n", dev->power.autosuspend_delay);
190}
191
192static ssize_t autosuspend_delay_ms_store(struct device *dev,
193		struct device_attribute *attr, const char *buf, size_t n)
194{
195	long delay;
196
197	if (!dev->power.use_autosuspend)
198		return -EIO;
199
200	if (kstrtol(buf, 10, &delay) != 0 || delay != (int) delay)
201		return -EINVAL;
202
203	device_lock(dev);
204	pm_runtime_set_autosuspend_delay(dev, delay);
205	device_unlock(dev);
206	return n;
207}
208
209static DEVICE_ATTR_RW(autosuspend_delay_ms);
 
210
211static ssize_t pm_qos_resume_latency_us_show(struct device *dev,
212					     struct device_attribute *attr,
213					     char *buf)
214{
215	s32 value = dev_pm_qos_requested_resume_latency(dev);
216
217	if (value == 0)
218		return sysfs_emit(buf, "n/a\n");
219	if (value == PM_QOS_RESUME_LATENCY_NO_CONSTRAINT)
220		value = 0;
221
222	return sysfs_emit(buf, "%d\n", value);
223}
224
225static ssize_t pm_qos_resume_latency_us_store(struct device *dev,
226					      struct device_attribute *attr,
227					      const char *buf, size_t n)
228{
229	s32 value;
230	int ret;
231
232	if (!kstrtos32(buf, 0, &value)) {
233		/*
234		 * Prevent users from writing negative or "no constraint" values
235		 * directly.
236		 */
237		if (value < 0 || value == PM_QOS_RESUME_LATENCY_NO_CONSTRAINT)
238			return -EINVAL;
239
240		if (value == 0)
241			value = PM_QOS_RESUME_LATENCY_NO_CONSTRAINT;
242	} else if (sysfs_streq(buf, "n/a")) {
243		value = 0;
244	} else {
245		return -EINVAL;
246	}
247
248	ret = dev_pm_qos_update_request(dev->power.qos->resume_latency_req,
249					value);
250	return ret < 0 ? ret : n;
251}
252
253static DEVICE_ATTR_RW(pm_qos_resume_latency_us);
 
254
255static ssize_t pm_qos_latency_tolerance_us_show(struct device *dev,
256						struct device_attribute *attr,
257						char *buf)
258{
259	s32 value = dev_pm_qos_get_user_latency_tolerance(dev);
260
261	if (value < 0)
262		return sysfs_emit(buf, "%s\n", "auto");
263	if (value == PM_QOS_LATENCY_ANY)
264		return sysfs_emit(buf, "%s\n", "any");
265
266	return sysfs_emit(buf, "%d\n", value);
267}
268
269static ssize_t pm_qos_latency_tolerance_us_store(struct device *dev,
270						 struct device_attribute *attr,
271						 const char *buf, size_t n)
272{
273	s32 value;
274	int ret;
275
276	if (kstrtos32(buf, 0, &value) == 0) {
277		/* Users can't write negative values directly */
278		if (value < 0)
279			return -EINVAL;
280	} else {
281		if (sysfs_streq(buf, "auto"))
282			value = PM_QOS_LATENCY_TOLERANCE_NO_CONSTRAINT;
283		else if (sysfs_streq(buf, "any"))
284			value = PM_QOS_LATENCY_ANY;
285		else
286			return -EINVAL;
287	}
288	ret = dev_pm_qos_update_user_latency_tolerance(dev, value);
289	return ret < 0 ? ret : n;
290}
291
292static DEVICE_ATTR_RW(pm_qos_latency_tolerance_us);
 
293
294static ssize_t pm_qos_no_power_off_show(struct device *dev,
295					struct device_attribute *attr,
296					char *buf)
297{
298	return sysfs_emit(buf, "%d\n", !!(dev_pm_qos_requested_flags(dev)
299					  & PM_QOS_FLAG_NO_POWER_OFF));
300}
301
302static ssize_t pm_qos_no_power_off_store(struct device *dev,
303					 struct device_attribute *attr,
304					 const char *buf, size_t n)
305{
306	int ret;
307
308	if (kstrtoint(buf, 0, &ret))
309		return -EINVAL;
310
311	if (ret != 0 && ret != 1)
312		return -EINVAL;
313
314	ret = dev_pm_qos_update_flags(dev, PM_QOS_FLAG_NO_POWER_OFF, ret);
315	return ret < 0 ? ret : n;
316}
317
318static DEVICE_ATTR_RW(pm_qos_no_power_off);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
319
320#ifdef CONFIG_PM_SLEEP
321static const char _enabled[] = "enabled";
322static const char _disabled[] = "disabled";
323
324static ssize_t wakeup_show(struct device *dev, struct device_attribute *attr,
325			   char *buf)
326{
327	return sysfs_emit(buf, "%s\n", device_can_wakeup(dev)
328			  ? (device_may_wakeup(dev) ? _enabled : _disabled)
329			  : "");
330}
331
332static ssize_t wakeup_store(struct device *dev, struct device_attribute *attr,
333			    const char *buf, size_t n)
 
334{
 
 
 
335	if (!device_can_wakeup(dev))
336		return -EINVAL;
337
338	if (sysfs_streq(buf, _enabled))
 
 
 
 
339		device_set_wakeup_enable(dev, 1);
340	else if (sysfs_streq(buf, _disabled))
 
341		device_set_wakeup_enable(dev, 0);
342	else
343		return -EINVAL;
344	return n;
345}
346
347static DEVICE_ATTR_RW(wakeup);
348
349static ssize_t wakeup_count_show(struct device *dev,
350				 struct device_attribute *attr, char *buf)
351{
352	unsigned long count;
353	bool enabled = false;
354
355	spin_lock_irq(&dev->power.lock);
356	if (dev->power.wakeup) {
357		count = dev->power.wakeup->wakeup_count;
358		enabled = true;
359	}
360	spin_unlock_irq(&dev->power.lock);
361
362	if (!enabled)
363		return sysfs_emit(buf, "\n");
364	return sysfs_emit(buf, "%lu\n", count);
365}
366
367static DEVICE_ATTR_RO(wakeup_count);
368
369static ssize_t wakeup_active_count_show(struct device *dev,
370					struct device_attribute *attr,
371					char *buf)
372{
373	unsigned long count;
374	bool enabled = false;
375
376	spin_lock_irq(&dev->power.lock);
377	if (dev->power.wakeup) {
378		count = dev->power.wakeup->active_count;
379		enabled = true;
380	}
381	spin_unlock_irq(&dev->power.lock);
382
383	if (!enabled)
384		return sysfs_emit(buf, "\n");
385	return sysfs_emit(buf, "%lu\n", count);
386}
387
388static DEVICE_ATTR_RO(wakeup_active_count);
389
390static ssize_t wakeup_abort_count_show(struct device *dev,
391				       struct device_attribute *attr,
392				       char *buf)
393{
394	unsigned long count;
395	bool enabled = false;
396
397	spin_lock_irq(&dev->power.lock);
398	if (dev->power.wakeup) {
399		count = dev->power.wakeup->wakeup_count;
400		enabled = true;
401	}
402	spin_unlock_irq(&dev->power.lock);
403
404	if (!enabled)
405		return sysfs_emit(buf, "\n");
406	return sysfs_emit(buf, "%lu\n", count);
407}
408
409static DEVICE_ATTR_RO(wakeup_abort_count);
410
411static ssize_t wakeup_expire_count_show(struct device *dev,
412					struct device_attribute *attr,
413					char *buf)
414{
415	unsigned long count;
416	bool enabled = false;
417
418	spin_lock_irq(&dev->power.lock);
419	if (dev->power.wakeup) {
420		count = dev->power.wakeup->expire_count;
421		enabled = true;
422	}
423	spin_unlock_irq(&dev->power.lock);
424
425	if (!enabled)
426		return sysfs_emit(buf, "\n");
427	return sysfs_emit(buf, "%lu\n", count);
428}
429
430static DEVICE_ATTR_RO(wakeup_expire_count);
431
432static ssize_t wakeup_active_show(struct device *dev,
433				  struct device_attribute *attr, char *buf)
434{
435	unsigned int active;
436	bool enabled = false;
437
438	spin_lock_irq(&dev->power.lock);
439	if (dev->power.wakeup) {
440		active = dev->power.wakeup->active;
441		enabled = true;
442	}
443	spin_unlock_irq(&dev->power.lock);
444
445	if (!enabled)
446		return sysfs_emit(buf, "\n");
447	return sysfs_emit(buf, "%u\n", active);
448}
449
450static DEVICE_ATTR_RO(wakeup_active);
451
452static ssize_t wakeup_total_time_ms_show(struct device *dev,
453					 struct device_attribute *attr,
454					 char *buf)
455{
456	s64 msec;
457	bool enabled = false;
458
459	spin_lock_irq(&dev->power.lock);
460	if (dev->power.wakeup) {
461		msec = ktime_to_ms(dev->power.wakeup->total_time);
462		enabled = true;
463	}
464	spin_unlock_irq(&dev->power.lock);
465
466	if (!enabled)
467		return sysfs_emit(buf, "\n");
468	return sysfs_emit(buf, "%lld\n", msec);
469}
470
471static DEVICE_ATTR_RO(wakeup_total_time_ms);
472
473static ssize_t wakeup_max_time_ms_show(struct device *dev,
474				       struct device_attribute *attr, char *buf)
475{
476	s64 msec;
477	bool enabled = false;
478
479	spin_lock_irq(&dev->power.lock);
480	if (dev->power.wakeup) {
481		msec = ktime_to_ms(dev->power.wakeup->max_time);
482		enabled = true;
483	}
484	spin_unlock_irq(&dev->power.lock);
485
486	if (!enabled)
487		return sysfs_emit(buf, "\n");
488	return sysfs_emit(buf, "%lld\n", msec);
489}
490
491static DEVICE_ATTR_RO(wakeup_max_time_ms);
492
493static ssize_t wakeup_last_time_ms_show(struct device *dev,
494					struct device_attribute *attr,
495					char *buf)
496{
497	s64 msec;
498	bool enabled = false;
499
500	spin_lock_irq(&dev->power.lock);
501	if (dev->power.wakeup) {
502		msec = ktime_to_ms(dev->power.wakeup->last_time);
503		enabled = true;
504	}
505	spin_unlock_irq(&dev->power.lock);
506
507	if (!enabled)
508		return sysfs_emit(buf, "\n");
509	return sysfs_emit(buf, "%lld\n", msec);
510}
511
512static inline int dpm_sysfs_wakeup_change_owner(struct device *dev, kuid_t kuid,
513						kgid_t kgid)
514{
515	if (dev->power.wakeup && dev->power.wakeup->dev)
516		return device_change_owner(dev->power.wakeup->dev, kuid, kgid);
517	return 0;
518}
519
520static DEVICE_ATTR_RO(wakeup_last_time_ms);
521
522#ifdef CONFIG_PM_AUTOSLEEP
523static ssize_t wakeup_prevent_sleep_time_ms_show(struct device *dev,
524						 struct device_attribute *attr,
525						 char *buf)
526{
527	s64 msec;
528	bool enabled = false;
529
530	spin_lock_irq(&dev->power.lock);
531	if (dev->power.wakeup) {
532		msec = ktime_to_ms(dev->power.wakeup->prevent_sleep_time);
533		enabled = true;
534	}
535	spin_unlock_irq(&dev->power.lock);
536
537	if (!enabled)
538		return sysfs_emit(buf, "\n");
539	return sysfs_emit(buf, "%lld\n", msec);
540}
541
542static DEVICE_ATTR_RO(wakeup_prevent_sleep_time_ms);
 
543#endif /* CONFIG_PM_AUTOSLEEP */
544#else /* CONFIG_PM_SLEEP */
545static inline int dpm_sysfs_wakeup_change_owner(struct device *dev, kuid_t kuid,
546						kgid_t kgid)
 
 
 
 
547{
548	return 0;
549}
550#endif
551
552#ifdef CONFIG_PM_ADVANCED_DEBUG
553static ssize_t runtime_usage_show(struct device *dev,
554				  struct device_attribute *attr, char *buf)
555{
556	return sysfs_emit(buf, "%d\n", atomic_read(&dev->power.usage_count));
 
557}
558static DEVICE_ATTR_RO(runtime_usage);
559
560static ssize_t runtime_active_kids_show(struct device *dev,
561					struct device_attribute *attr,
562					char *buf)
563{
564	return sysfs_emit(buf, "%d\n", dev->power.ignore_children ?
565			  0 : atomic_read(&dev->power.child_count));
 
 
 
 
 
566}
567static DEVICE_ATTR_RO(runtime_active_kids);
568
569static ssize_t runtime_enabled_show(struct device *dev,
570				    struct device_attribute *attr, char *buf)
571{
572	const char *output;
573
574	if (dev->power.disable_depth && !dev->power.runtime_auto)
575		output = "disabled & forbidden";
576	else if (dev->power.disable_depth)
577		output = "disabled";
578	else if (!dev->power.runtime_auto)
579		output = "forbidden";
580	else
581		output = "enabled";
582
583	return sysfs_emit(buf, "%s\n", output);
584}
585static DEVICE_ATTR_RO(runtime_enabled);
586
587#ifdef CONFIG_PM_SLEEP
 
588static ssize_t async_show(struct device *dev, struct device_attribute *attr,
589			  char *buf)
590{
591	return sysfs_emit(buf, "%s\n",
592			  device_async_suspend_enabled(dev) ?
593			  _enabled : _disabled);
594}
595
596static ssize_t async_store(struct device *dev, struct device_attribute *attr,
597			   const char *buf, size_t n)
598{
599	if (sysfs_streq(buf, _enabled))
 
 
 
 
 
 
600		device_enable_async_suspend(dev);
601	else if (sysfs_streq(buf, _disabled))
602		device_disable_async_suspend(dev);
603	else
604		return -EINVAL;
605	return n;
606}
607
608static DEVICE_ATTR_RW(async);
609
610#endif /* CONFIG_PM_SLEEP */
611#endif /* CONFIG_PM_ADVANCED_DEBUG */
612
613static struct attribute *power_attrs[] = {
614#ifdef CONFIG_PM_ADVANCED_DEBUG
615#ifdef CONFIG_PM_SLEEP
616	&dev_attr_async.attr,
617#endif
 
618	&dev_attr_runtime_status.attr,
619	&dev_attr_runtime_usage.attr,
620	&dev_attr_runtime_active_kids.attr,
621	&dev_attr_runtime_enabled.attr,
 
622#endif /* CONFIG_PM_ADVANCED_DEBUG */
623	NULL,
624};
625static const struct attribute_group pm_attr_group = {
626	.name	= power_group_name,
627	.attrs	= power_attrs,
628};
629
630static struct attribute *wakeup_attrs[] = {
631#ifdef CONFIG_PM_SLEEP
632	&dev_attr_wakeup.attr,
633	&dev_attr_wakeup_count.attr,
634	&dev_attr_wakeup_active_count.attr,
635	&dev_attr_wakeup_abort_count.attr,
636	&dev_attr_wakeup_expire_count.attr,
637	&dev_attr_wakeup_active.attr,
638	&dev_attr_wakeup_total_time_ms.attr,
639	&dev_attr_wakeup_max_time_ms.attr,
640	&dev_attr_wakeup_last_time_ms.attr,
641#ifdef CONFIG_PM_AUTOSLEEP
642	&dev_attr_wakeup_prevent_sleep_time_ms.attr,
643#endif
644#endif
645	NULL,
646};
647static const struct attribute_group pm_wakeup_attr_group = {
648	.name	= power_group_name,
649	.attrs	= wakeup_attrs,
650};
651
652static struct attribute *runtime_attrs[] = {
 
653#ifndef CONFIG_PM_ADVANCED_DEBUG
654	&dev_attr_runtime_status.attr,
655#endif
656	&dev_attr_control.attr,
657	&dev_attr_runtime_suspended_time.attr,
658	&dev_attr_runtime_active_time.attr,
659	&dev_attr_autosuspend_delay_ms.attr,
 
660	NULL,
661};
662static const struct attribute_group pm_runtime_attr_group = {
663	.name	= power_group_name,
664	.attrs	= runtime_attrs,
665};
666
667static struct attribute *pm_qos_resume_latency_attrs[] = {
 
668	&dev_attr_pm_qos_resume_latency_us.attr,
 
669	NULL,
670};
671static const struct attribute_group pm_qos_resume_latency_attr_group = {
672	.name	= power_group_name,
673	.attrs	= pm_qos_resume_latency_attrs,
674};
675
676static struct attribute *pm_qos_latency_tolerance_attrs[] = {
 
677	&dev_attr_pm_qos_latency_tolerance_us.attr,
 
678	NULL,
679};
680static const struct attribute_group pm_qos_latency_tolerance_attr_group = {
681	.name	= power_group_name,
682	.attrs	= pm_qos_latency_tolerance_attrs,
683};
684
685static struct attribute *pm_qos_flags_attrs[] = {
 
686	&dev_attr_pm_qos_no_power_off.attr,
 
 
687	NULL,
688};
689static const struct attribute_group pm_qos_flags_attr_group = {
690	.name	= power_group_name,
691	.attrs	= pm_qos_flags_attrs,
692};
693
694int dpm_sysfs_add(struct device *dev)
695{
696	int rc;
697
698	/* No need to create PM sysfs if explicitly disabled. */
699	if (device_pm_not_required(dev))
700		return 0;
701
702	rc = sysfs_create_group(&dev->kobj, &pm_attr_group);
703	if (rc)
704		return rc;
705
706	if (!pm_runtime_has_no_callbacks(dev)) {
707		rc = sysfs_merge_group(&dev->kobj, &pm_runtime_attr_group);
708		if (rc)
709			goto err_out;
710	}
711	if (device_can_wakeup(dev)) {
712		rc = sysfs_merge_group(&dev->kobj, &pm_wakeup_attr_group);
713		if (rc)
714			goto err_runtime;
715	}
716	if (dev->power.set_latency_tolerance) {
717		rc = sysfs_merge_group(&dev->kobj,
718				       &pm_qos_latency_tolerance_attr_group);
719		if (rc)
720			goto err_wakeup;
721	}
722	rc = pm_wakeup_source_sysfs_add(dev);
723	if (rc)
724		goto err_latency;
725	return 0;
726
727 err_latency:
728	sysfs_unmerge_group(&dev->kobj, &pm_qos_latency_tolerance_attr_group);
729 err_wakeup:
730	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
731 err_runtime:
732	sysfs_unmerge_group(&dev->kobj, &pm_runtime_attr_group);
733 err_out:
734	sysfs_remove_group(&dev->kobj, &pm_attr_group);
735	return rc;
736}
737
738int dpm_sysfs_change_owner(struct device *dev, kuid_t kuid, kgid_t kgid)
739{
740	int rc;
741
742	if (device_pm_not_required(dev))
743		return 0;
744
745	rc = sysfs_group_change_owner(&dev->kobj, &pm_attr_group, kuid, kgid);
746	if (rc)
747		return rc;
748
749	if (!pm_runtime_has_no_callbacks(dev)) {
750		rc = sysfs_group_change_owner(
751			&dev->kobj, &pm_runtime_attr_group, kuid, kgid);
752		if (rc)
753			return rc;
754	}
755
756	if (device_can_wakeup(dev)) {
757		rc = sysfs_group_change_owner(&dev->kobj, &pm_wakeup_attr_group,
758					      kuid, kgid);
759		if (rc)
760			return rc;
761
762		rc = dpm_sysfs_wakeup_change_owner(dev, kuid, kgid);
763		if (rc)
764			return rc;
765	}
766
767	if (dev->power.set_latency_tolerance) {
768		rc = sysfs_group_change_owner(
769			&dev->kobj, &pm_qos_latency_tolerance_attr_group, kuid,
770			kgid);
771		if (rc)
772			return rc;
773	}
774	return 0;
775}
776
777int wakeup_sysfs_add(struct device *dev)
778{
779	int ret = sysfs_merge_group(&dev->kobj, &pm_wakeup_attr_group);
780
781	if (!ret)
782		kobject_uevent(&dev->kobj, KOBJ_CHANGE);
783
784	return ret;
785}
786
787void wakeup_sysfs_remove(struct device *dev)
788{
789	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
790	kobject_uevent(&dev->kobj, KOBJ_CHANGE);
791}
792
793int pm_qos_sysfs_add_resume_latency(struct device *dev)
794{
795	return sysfs_merge_group(&dev->kobj, &pm_qos_resume_latency_attr_group);
796}
797
798void pm_qos_sysfs_remove_resume_latency(struct device *dev)
799{
800	sysfs_unmerge_group(&dev->kobj, &pm_qos_resume_latency_attr_group);
801}
802
803int pm_qos_sysfs_add_flags(struct device *dev)
804{
805	return sysfs_merge_group(&dev->kobj, &pm_qos_flags_attr_group);
806}
807
808void pm_qos_sysfs_remove_flags(struct device *dev)
809{
810	sysfs_unmerge_group(&dev->kobj, &pm_qos_flags_attr_group);
811}
812
813int pm_qos_sysfs_add_latency_tolerance(struct device *dev)
814{
815	return sysfs_merge_group(&dev->kobj,
816				 &pm_qos_latency_tolerance_attr_group);
817}
818
819void pm_qos_sysfs_remove_latency_tolerance(struct device *dev)
820{
821	sysfs_unmerge_group(&dev->kobj, &pm_qos_latency_tolerance_attr_group);
822}
823
824void rpm_sysfs_remove(struct device *dev)
825{
826	sysfs_unmerge_group(&dev->kobj, &pm_runtime_attr_group);
827}
828
829void dpm_sysfs_remove(struct device *dev)
830{
831	if (device_pm_not_required(dev))
832		return;
833	sysfs_unmerge_group(&dev->kobj, &pm_qos_latency_tolerance_attr_group);
834	dev_pm_qos_constraints_destroy(dev);
835	rpm_sysfs_remove(dev);
836	sysfs_unmerge_group(&dev->kobj, &pm_wakeup_attr_group);
837	sysfs_remove_group(&dev->kobj, &pm_attr_group);
838}