sysfs-devices-power 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. What: /sys/devices/.../power/
  2. Date: January 2009
  3. Contact: Rafael J. Wysocki <rjw@sisk.pl>
  4. Description:
  5. The /sys/devices/.../power directory contains attributes
  6. allowing the user space to check and modify some power
  7. management related properties of given device.
  8. What: /sys/devices/.../power/wakeup
  9. Date: January 2009
  10. Contact: Rafael J. Wysocki <rjw@sisk.pl>
  11. Description:
  12. The /sys/devices/.../power/wakeup attribute allows the user
  13. space to check if the device is enabled to wake up the system
  14. from sleep states, such as the memory sleep state (suspend to
  15. RAM) and hibernation (suspend to disk), and to enable or disable
  16. it to do that as desired.
  17. Some devices support "wakeup" events, which are hardware signals
  18. used to activate the system from a sleep state. Such devices
  19. have one of the following two values for the sysfs power/wakeup
  20. file:
  21. + "enabled\n" to issue the events;
  22. + "disabled\n" not to do so;
  23. In that cases the user space can change the setting represented
  24. by the contents of this file by writing either "enabled", or
  25. "disabled" to it.
  26. For the devices that are not capable of generating system wakeup
  27. events this file contains "\n". In that cases the user space
  28. cannot modify the contents of this file and the device cannot be
  29. enabled to wake up the system.
  30. What: /sys/devices/.../power/control
  31. Date: January 2009
  32. Contact: Rafael J. Wysocki <rjw@sisk.pl>
  33. Description:
  34. The /sys/devices/.../power/control attribute allows the user
  35. space to control the run-time power management of the device.
  36. All devices have one of the following two values for the
  37. power/control file:
  38. + "auto\n" to allow the device to be power managed at run time;
  39. + "on\n" to prevent the device from being power managed;
  40. The default for all devices is "auto", which means that they may
  41. be subject to automatic power management, depending on their
  42. drivers. Changing this attribute to "on" prevents the driver
  43. from power managing the device at run time. Doing that while
  44. the device is suspended causes it to be woken up.
  45. What: /sys/devices/.../power/async
  46. Date: January 2009
  47. Contact: Rafael J. Wysocki <rjw@sisk.pl>
  48. Description:
  49. The /sys/devices/.../async attribute allows the user space to
  50. enable or diasble the device's suspend and resume callbacks to
  51. be executed asynchronously (ie. in separate threads, in parallel
  52. with the main suspend/resume thread) during system-wide power
  53. transitions (eg. suspend to RAM, hibernation).
  54. All devices have one of the following two values for the
  55. power/async file:
  56. + "enabled\n" to permit the asynchronous suspend/resume;
  57. + "disabled\n" to forbid it;
  58. The value of this attribute may be changed by writing either
  59. "enabled", or "disabled" to it.
  60. It generally is unsafe to permit the asynchronous suspend/resume
  61. of a device unless it is certain that all of the PM dependencies
  62. of the device are known to the PM core. However, for some
  63. devices this attribute is set to "enabled" by bus type code or
  64. device drivers and in that cases it should be safe to leave the
  65. default value.