docs/designs/psu-monitoring.md

1 # Power Supply Monitoring Application
12 supply application for enterprise class systems. Some enterprise class systems
14 supply types and numbers. An application capable of communicating with the
23 that contains a power supply monitor application and a power sequencer monitor
24 application. The current power supply application is lacking things desired for
28 a single power supply application that can communicate with one or more
31 power supply.
38 1. The power supply application must detect, isolate, and report individual
40 2. The power supply application must determine power supply presence,
42 3. The power supply application must report power supply failures to IPMI and
44 4. The power supply application must report power supply present/missing changes
50 5. The power supply application must ensure proper power supply configuration
52 6. The power supply application must collect and report power supply VPD (unless
55 7. The power supply application must allow power supply hot-plug and concurrent
57 8. The power supply application should create and update average and maximum
59 9. The power supply application must be able to detect how many power supplies
60    are present in the system, what type of power supply is present (maximum
74     supplies or power supply features. Any power supply that communicates using
83 The proposal is to create a single new power supply application in the OpenBMC
86 Upon startup, the power supply application would be passed a parameter
89 possible power supply types, possible system types that the various power
93 The power supply application would then detect which system type it is running
94 on, which supplies are present, if the power supply is ready for reading VPD
95 information, what type each supply is, etc. The application would then try to
103 voltage, removal of a power supply, insertion of a power supply, and take any
106 The proposed power supply application would not control any fans internal to the
107 power supply, that function would be left to other userspace application(s).
111 The current implementation of multiple instances of a power supply monitor was
117 - Timing/serialization concerns with power supply communication.
130 the one application per power supply.
137 - Application detects and logs faults for power supply faults including input
140 - Power supply VPD data reported for present power supplies.
141 - Power supply removal and insertion, on a system supporting concurrent
143 - System operates through power supply faults and power line disturbances as
156   https://github.com/openbmc/witherspoon-pfault-analysis/tree/master/power-supply