oem/ibm/system-power-mode.md

1 # System Power Mode and Idle Power Saver Support
11 Power management on POWER platforms needs assistance from the BMC for managing
12 the system power mode and idle power save modes. We need the ability to set and
13 query the system power mode and also the ability to control and set idle power
14 save parameters. This design is only applicable to POWER processors.
18 Each POWER processor contains an embedded PowerPC 405 processor that is referred
19 to as the On Chip Controller or OCC. The OCC provides real time power and
22 send a mode change and idle power saver (IPS) settings to the OCC. It will also
23 need to send the commands if the user changes the mode or idle power save
29 state, the OCC is managing the processor frequency, power consumption, and
34 runtime, the BMC will need to send the mode and the idle power saver settings to
40 Current Customer Settable System Power Modes that will be sent to the OCCs:
43 - Power Saver
46 A proposal for adding Idle Power Saving parameters was submitted to the Redfish
49 Customer Settable Idle Power Save Parameters:
66 - Customer updates system power mode user interface or Redfish interface
67 - Customer updates idle power save setting or Redfish interface
74 the OCC and a SET_CONFIG_DATA (0x21) command with the Idle Power Saver
76 <https://github.com/open-power/docs/blob/master/occ/OCC_P9_FW_Interfaces.pdf>
78 Default values will also be defined for Power Mode and Idle Power Saver
84 The customer requested PowerMode and Idle Power Saver parameters will be stored
86 xyz/openbmc_project/Control/Power/Mode.interface.yaml Once set, these values
87 will be retained across power cycles, AC loss, code updates, etc.
91 - Using hardcoded power mode and Idle Power Save parameters (no flexibility to
92   control system power usage)
99 interface to allow customer to set power mode and idle power saver settings
107 power management team Upgradability impact - None
111 This will be able to be tested by directly updating the power mode and idle
112 power saver setting. This testing will be automated