Suspend.txt 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  1. S3C24XX Suspend Support
  2. =======================
  3. Introduction
  4. ------------
  5. The S3C2410 supports a low-power suspend mode, where the SDRAM is kept
  6. in Self-Refresh mode, and all but the essential peripheral blocks are
  7. powered down. For more information on how this works, please look
  8. at the S3C2410 datasheets from Samsung.
  9. Requirements
  10. ------------
  11. 1) A bootloader that can support the necessary resume operation
  12. 2) Support for at least 1 source for resume
  13. 3) CONFIG_PM enabled in the kernel
  14. 4) Any peripherals that are going to be powered down at the same
  15. time require suspend/resume support.
  16. Resuming
  17. --------
  18. The S3C2410 user manual defines the process of sending the CPU to
  19. sleep and how it resumes. The default behaviour of the Linux code
  20. is to set the GSTATUS3 register to the physical address of the
  21. code to resume Linux operation.
  22. GSTATUS4 is currently left alone by the sleep code, and is free to
  23. use for any other purposes (for example, the EB2410ITX uses this to
  24. save memory configuration in).
  25. Machine Support
  26. ---------------
  27. The machine specific functions must call the s3c2410_pm_init() function
  28. to say that its bootloader is capable of resuming. This can be as
  29. simple as adding the following to the machine's definition:
  30. INITMACHINE(s3c2410_pm_init)
  31. A board can do its own setup before calling s3c2410_pm_init, if it
  32. needs to setup anything else for power management support.
  33. There is currently no support for over-riding the default method of
  34. saving the resume address, if your board requires it, then contact
  35. the maintainer and discuss what is required.
  36. Note, the original method of adding an late_initcall() is wrong,
  37. and will end up initialising all compiled machines' pm init!
  38. Debugging
  39. ---------
  40. There are several important things to remember when using PM suspend:
  41. 1) The uart drivers will disable the clocks to the UART blocks when
  42. suspending, which means that use of printascii() or similar direct
  43. access to the UARTs will cause the debug to stop.
  44. 2) Whilst the pm code itself will attempt to re-enable the UART clocks,
  45. care should be taken that any external clock sources that the UARTs
  46. rely on are still enabled at that point.
  47. Configuration
  48. -------------
  49. The S3C2410 specific configuration in `System Type` defines various
  50. aspects of how the S3C2410 suspend and resume support is configured
  51. `S3C2410 PM Suspend debug`
  52. This option prints messages to the serial console before and after
  53. the actual suspend, giving detailed information on what is
  54. happening
  55. `S3C2410 PM Suspend Memory CRC`
  56. Allows the entire memory to be checksummed before and after the
  57. suspend to see if there has been any corruption of the contents.
  58. This support requires the CRC32 function to be enabled.
  59. `S3C2410 PM Suspend CRC Chunksize (KiB)`
  60. Defines the size of memory each CRC chunk covers. A smaller value
  61. will mean that the CRC data block will take more memory, but will
  62. identify any faults with better precision
  63. Document Author
  64. ---------------
  65. Ben Dooks, (c) 2004 Simtec Electronics