docs/designs/power-recovery.md

30 A brownout is another scenario that commonly utilizes automated power-on
31 recovery features. A brownout is a scenario where BMC firmware detects (or is
34 feature to turn chassis power back on as soon as the brownout condition ends.
38 brownout scenario. A UPS has a limited amount of power so it's main purpose is
119 ### Brownout  subsection
121 As noted above, a brownout condition is when AC power can not continue to be
128 - Log an error indicating the brownout event has occurred
130   policy if they wish for when the brownout completes
131 - Identify when a brownout condition has completed
132 - Wait for the brownout to complete and implement the one-time power restore
138 - Discover if system is in a brownout situation
141 - Not run any power-on recovery logic when a brownout is occurring
147 When a UPS is present and a blackout or brownout condition occurs, the BMC must:
213 ### Brownout  subsection
222 - `BrownOut`
227 be responsible for monitoring for brownout conditions. It will support a
232 and aggregate the status (i.e. if any reports a brownout, then `BrownOut` will
237 applications will log an error when a brownout occurs and initiate the fast
242 brownout completes.
244 When the phosphor-power application detects that a brownout condition has
270 interface and utilize them in combination with power supply brownout status when
273 Similar to the above brownout scenario, phosphor-state-manager will ensure
309 A brownout condition should be injected into a system and appropriate paths
315 - Power recovery function is not run while a brownout is present
316 - System automatically powers back on when brownout condition ends (assuming a