psci.txt 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  1. * Power State Coordination Interface (PSCI)
  2. Firmware implementing the PSCI functions described in ARM document number
  3. ARM DEN 0022A ("Power State Coordination Interface System Software on ARM
  4. processors") can be used by Linux to initiate various CPU-centric power
  5. operations.
  6. Issue A of the specification describes functions for CPU suspend, hotplug
  7. and migration of secure software.
  8. Functions are invoked by trapping to the privilege level of the PSCI
  9. firmware (specified as part of the binding below) and passing arguments
  10. in a manner similar to that specified by AAPCS:
  11. r0 => 32-bit Function ID / return value
  12. {r1 - r3} => Parameters
  13. Note that the immediate field of the trapping instruction must be set
  14. to #0.
  15. Main node required properties:
  16. - compatible : Must be "arm,psci"
  17. - method : The method of calling the PSCI firmware. Permitted
  18. values are:
  19. "smc" : SMC #0, with the register assignments specified
  20. in this binding.
  21. "hvc" : HVC #0, with the register assignments specified
  22. in this binding.
  23. Main node optional properties:
  24. - cpu_suspend : Function ID for CPU_SUSPEND operation
  25. - cpu_off : Function ID for CPU_OFF operation
  26. - cpu_on : Function ID for CPU_ON operation
  27. - migrate : Function ID for MIGRATE operation
  28. Example:
  29. psci {
  30. compatible = "arm,psci";
  31. method = "smc";
  32. cpu_suspend = <0x95c10000>;
  33. cpu_off = <0x95c10001>;
  34. cpu_on = <0x95c10002>;
  35. migrate = <0x95c10003>;
  36. };