docs/designs/state-management-and-external-interfaces.md

23 [phoshor-state-manager][2] implements the xyz.openbmc_project.State.\*
28 the appropriate xyz.openbmc_project.State.\* D-Bus interface.
35 Currently phosphor-state-manager supports the following:
37 - Chassis: On/Off
38 - Host: On/Off/Reboot
60         "ForceOff": "Turn off the unit immediately (non-graceful shutdown).",
62         "ForceRestart": "Shut down immediately and non-gracefully and restart
84 …------------------------------ | -----------------------------------------------------------------…
85 …y’ management power down actions. The command does not initiate a clean shut-down of the operating…
89 …ypically used to cause the operating system to do a diagnostic dump (OS dependent).               …
90 | Initiate a soft-shutdown of OS |                                                                 …
94 - Keep legacy support where `xyz.openbmc_project.State.Host.Transition.Reboot`
97 - Support a reboot of the host with chassis power on
98   - Support `GracefulRestart` (where the host is notified of the reboot)
99   - Support `ForceRestart` (where the host is not notified of the reboot)
100 - Map `PowerCycle` to a host or chassis operation depending on the current state
102   - If host is running, then a `PowerCycle` should cycle power to the chassis
104   - If host is not running, then a `PowerCycle` should only cycle power to the
111 - `ForceWarmReboot`, `GracefulWarmReboot`
115 - `PowerCycle`
118 interfaces that are not defined within phosphor-dbus-interfaces. These are
119 implemented within the x86-power-control repository which is an alternate
120 implementation to phosphor-state-manager. It has the following mapping for these
121 non-phosphor-dbus-interfaces
123 - `ForceRestart` -> `xyz.openbmc_project.State.Chassis.Transition.Reset`
124 - `PowerCycle` -> `xyz.openbmc_project.State.Chassis.Transition.PowerCycle`
133 The `PowerCycle` operation is dependent on the current state of the host. If
140 - `ForceRestart` -> `xyz.openbmc_project.State.Host.Transition.ForceWarmReboot`
141 - `GracefulRestart`->
143 - `PowerCycle`:
144   - If host on: `xyz.openbmc_project.State.Host.Transition.Reboot`
145   - If host off: `xyz.openbmc_project.State.Chassis.Transition.PowerCycle`
151 | --------------------- | ----------- | ------------------------------------ |
167 Existing interfaces will be kept the same. Some changes in x86-power-control
171 Some changes in phosphor-host-ipmid would be needed to support the new state
181 [2]: https://github.com/openbmc/phosphor-state-manager