1 #pragma once
2 
3 #include "interfaces.hpp"
4 
5 #include <string>
6 
7 namespace pid_control
8 {
9 
10 /**
11  * Abstract base class for all sensors.
12  */
13 class Sensor
14 {
15   public:
16     /**
17      * Given a sensor's type, return the default timeout value.
18      * A timeout of 0 means there isn't a timeout for this sensor.
19      * By default a fan sensor isn't checked for a timeout, whereas
20      * any of sensor is meant to be sampled once per second.  By default.
21      *
22      * @param[in] type - the sensor type (e.g. fan)
23      * @return the default timeout for that type (in seconds).
24      */
25     static int64_t getDefaultTimeout(const std::string& type)
26     {
27         return (type == "fan") ? 0 : 2;
28     }
29 
30     Sensor(const std::string& name, int64_t timeout) :
31         _name(name), _timeout(timeout)
32     {}
33 
34     virtual ~Sensor() {}
35 
36     virtual ReadReturn read(void) = 0;
37     virtual void write(double value) = 0;
38 
39     virtual void write(double value, bool force, int64_t* written)
40     {
41         (void)force;
42         (void)written;
43         return write(value);
44     }
45 
46     virtual bool getFailed(void)
47     {
48         return false;
49     };
50 
51     std::string getName(void) const
52     {
53         return _name;
54     }
55 
56     /* Returns the configurable timeout period
57      * for this sensor in seconds (undecorated).
58      */
59     int64_t getTimeout(void) const
60     {
61         return _timeout;
62     }
63 
64   private:
65     std::string _name;
66     int64_t _timeout;
67 };
68 
69 } // namespace pid_control
70