states.txt 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384
  1. System Power Management States
  2. The kernel supports four power management states generically, though
  3. one is generic and the other three are dependent on platform support
  4. code to implement the low-level details for each state.
  5. This file describes each state, what they are
  6. commonly called, what ACPI state they map to, and what string to write
  7. to /sys/power/state to enter that state
  8. state: Freeze / Low-Power Idle
  9. ACPI state: S0
  10. String: "freeze"
  11. This state is a generic, pure software, light-weight, low-power state.
  12. It allows more energy to be saved relative to idle by freezing user
  13. space and putting all I/O devices into low-power states (possibly
  14. lower-power than available at run time), such that the processors can
  15. spend more time in their idle states.
  16. This state can be used for platforms without Standby/Suspend-to-RAM
  17. support, or it can be used in addition to Suspend-to-RAM (memory sleep)
  18. to provide reduced resume latency.
  19. State: Standby / Power-On Suspend
  20. ACPI State: S1
  21. String: "standby"
  22. This state offers minimal, though real, power savings, while providing
  23. a very low-latency transition back to a working system. No operating
  24. state is lost (the CPU retains power), so the system easily starts up
  25. again where it left off.
  26. We try to put devices in a low-power state equivalent to D1, which
  27. also offers low power savings, but low resume latency. Not all devices
  28. support D1, and those that don't are left on.
  29. State: Suspend-to-RAM
  30. ACPI State: S3
  31. String: "mem"
  32. This state offers significant power savings as everything in the
  33. system is put into a low-power state, except for memory, which is
  34. placed in self-refresh mode to retain its contents.
  35. System and device state is saved and kept in memory. All devices are
  36. suspended and put into D3. In many cases, all peripheral buses lose
  37. power when entering STR, so devices must be able to handle the
  38. transition back to the On state.
  39. For at least ACPI, STR requires some minimal boot-strapping code to
  40. resume the system from STR. This may be true on other platforms.
  41. State: Suspend-to-disk
  42. ACPI State: S4
  43. String: "disk"
  44. This state offers the greatest power savings, and can be used even in
  45. the absence of low-level platform support for power management. This
  46. state operates similarly to Suspend-to-RAM, but includes a final step
  47. of writing memory contents to disk. On resume, this is read and memory
  48. is restored to its pre-suspend state.
  49. STD can be handled by the firmware or the kernel. If it is handled by
  50. the firmware, it usually requires a dedicated partition that must be
  51. setup via another operating system for it to use. Despite the
  52. inconvenience, this method requires minimal work by the kernel, since
  53. the firmware will also handle restoring memory contents on resume.
  54. For suspend-to-disk, a mechanism called 'swsusp' (Swap Suspend) is used
  55. to write memory contents to free swap space. swsusp has some restrictive
  56. requirements, but should work in most cases. Some, albeit outdated,
  57. documentation can be found in Documentation/power/swsusp.txt.
  58. Alternatively, userspace can do most of the actual suspend to disk work,
  59. see userland-swsusp.txt.
  60. Once memory state is written to disk, the system may either enter a
  61. low-power state (like ACPI S4), or it may simply power down. Powering
  62. down offers greater savings, and allows this mechanism to work on any
  63. system. However, entering a real low-power state allows the user to
  64. trigger wake up events (e.g. pressing a key or opening a laptop lid).