1 #pragma once
2 
3 #include "device.hpp"
4 #include "device_monitor.hpp"
5 
6 #include <sdbusplus/bus.hpp>
7 #include <sdbusplus/server.hpp>
8 #include <sdeventplus/event.hpp>
9 
10 namespace phosphor
11 {
12 namespace power
13 {
14 
15 /**
16  * @class PGOODMonitor
17  *
18  * Monitors PGOOD and checks for errors on the power sequencer
19  * if it doesn't come on in time.
20  *
21  * The run() function is designed to be called right after the
22  * power sequencer device is told to kick off a power on.
23  *
24  * Future commits will analyze the power sequencer chip for errors
25  * on a PGOOD fail.
26  */
27 class PGOODMonitor : public DeviceMonitor
28 {
29   public:
30     PGOODMonitor() = delete;
31     ~PGOODMonitor() = default;
32     PGOODMonitor(const PGOODMonitor&) = delete;
33     PGOODMonitor& operator=(const PGOODMonitor&) = delete;
34     PGOODMonitor(PGOODMonitor&&) = delete;
35     PGOODMonitor& operator=(PGOODMonitor&&) = delete;
36 
37     /**
38      * Constructor
39      *
40      * @param[in] d - the device to monitor
41      * @param[in] b - D-Bus bus object
42      * @param[in] e - event object
43      * @param[in] t - time to allow PGOOD to come up
44      */
45     PGOODMonitor(std::unique_ptr<phosphor::power::Device>&& d,
46                  sdbusplus::bus::bus& b, const sdeventplus::Event& e,
47                  std::chrono::milliseconds& t) :
48         DeviceMonitor(std::move(d), e, t),
49         bus(b)
50     {
51     }
52 
53     /**
54      * Analyzes the power sequencer for fails and then
55      * notifies the event loop that it can exit.
56      *
57      * The timer callback.
58      */
59     void analyze() override;
60 
61     /**
62      * Waits a specified amount of time for PGOOD to
63      * come on, and if it fails to come on in that time
64      * it will analyze the power sequencer for faults.
65      *
66      * It will exit after either PGOOD is asserted or
67      * the device is analyzed for faults.
68      *
69      * @return - the return value from sd_event_loop()
70      */
71     int run() override;
72 
73   private:
74     /**
75      * Enables the properties changed signal callback
76      * on the power object so we can tell when PGOOD
77      * comes on.
78      */
79     void startListening();
80 
81     /**
82      * The callback function for the properties changed
83      * signal.
84      */
85     void propertyChanged();
86 
87     /**
88      * Returns true if the system has been turned on
89      * but PGOOD isn't up yet.
90      */
91     bool pgoodPending();
92 
93     /**
94      * Used to break out of the event loop in run()
95      */
96     void exitEventLoop();
97 
98     /**
99      * The D-Bus object
100      */
101     sdbusplus::bus::bus& bus;
102 
103     /**
104      * The match object for the properties changed signal
105      */
106     std::unique_ptr<sdbusplus::bus::match_t> match;
107 };
108 
109 } // namespace power
110 } // namespace phosphor
111