docs/designs/power-recovery.md

1 # OpenBMC Server Power Recovery
11 Modern computer systems have a feature, automated power-on recovery, which in
18 There are also instances where the user may not want automatic power recovery to
31 recovery features. A brownout is a scenario where BMC firmware detects (or is
59 ### Automated Power-On Recovery
81 feature is a way for software to utilize automated power-on recovery function
85 ### BMC and System Recovery Paths
96 - Not implement any power recovery policy on the system
97 - Turn power recovery back on once BMC has a normal reboot
140     power-on recovery
141 - Not run any power-on recovery logic when a brownout is occurring
142 - Tell the host firmware that it is a automated power-on recovery initiated boot
158 - Not execute any automated power-on recovery logic to prevent power on/off
163 ### Automated Power-On Recovery
177 ### BMC and System Recovery Paths
195 If the power recovery software sees the `PinholeReset` reason within the
198 default and therefore power recovery policy will be re-enabled on that BMC boot.
248 phosphor-state-manager will ensure automated power-on recovery logic is only run
274 automated power-on recovery logic is not run if `PowerStatus` is not set to
315 - Power recovery function is not run while a brownout is present
317   one-time or system auto power-on recovery policy of `AlwaysOn` or `Restore`)