blob: 8ce09c1236982c94c90b631a2a171126b1601660 [file] [log] [blame]
Matt Spinler1b4a98a2021-01-22 16:28:55 -06001description: >
2 Implement to provide performance loss class sensor thresholds. Objects
Patrick Williams86f8c532021-10-01 06:34:04 -05003 implementing Sensor.Threshold.PerformanceLoss must be instantiated in the
4 correct hierarchy within the sensors namespace. The following sensor
5 hierarchies are recognized:
Patrick Williamsd5f36352021-12-22 09:13:27 -06006 airflow
Matt Spinler1b4a98a2021-01-22 16:28:55 -06007 altitude
8 current
Matt Spinler1b4a98a2021-01-22 16:28:55 -06009 energy
Patrick Williamsd5f36352021-12-22 09:13:27 -060010 fan_tach
Patrick Williams1bcf7fa2021-12-22 09:14:37 -060011 humidity
Patrick Williamsd5f36352021-12-22 09:13:27 -060012 power
Patrick Williams86f8c532021-10-01 06:34:04 -050013 pressure
Patrick Williamsd5f36352021-12-22 09:13:27 -060014 temperature
15 utilization
16 voltage
Matt Spinler1b4a98a2021-01-22 16:28:55 -060017
Patrick Williams86f8c532021-10-01 06:34:04 -050018 Additionally, any object implementing Sensor.Threshold.PerformanceLoss must
19 also implement Sensor.Value.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060020
21properties:
22 - name: PerformanceLossHigh
23 type: double
24 default: NaN
25 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060026 The upper bound of the warning threshold. A value of 'NaN' is used to
27 indicate there is no threshold of this type.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060028 - name: PerformanceLossLow
29 type: double
30 default: NaN
31 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060032 The lower bound of the warning threshold. A value of 'NaN' is used to
33 indicate there is no threshold of this type.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060034 - name: PerformanceLossAlarmHigh
35 type: boolean
36 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060037 True if the sensor value has exceeded the defined bound. False if the
38 sensor value has not exceeded the defined bound.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060039
Patrick Williams86f8c532021-10-01 06:34:04 -050040 PerformanceLossAlarmHigh may be set to False to clear an alarm
Patrick Williamsa1347412022-12-06 10:56:22 -060041 condition. The behavior of setting PerformanceLossAlarmHigh to True is
42 undefined.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060043 - name: PerformanceLossAlarmLow
44 type: boolean
45 description: >
Patrick Williamsa1347412022-12-06 10:56:22 -060046 True if the sensor value has exceeded the defined bound. False if the
47 sensor value has not exceeded the defined bound.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060048
Patrick Williams86f8c532021-10-01 06:34:04 -050049 PerformanceLossAlarmLow may be set to False to clear an alarm
50 condition. The behavior of setting PerformanceLossAlarmLow to True is
51 undefined.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060052signals:
53 - name: PerformanceLossHighAlarmAsserted
54 description: >
55 The high threshold alarm asserted.
56 properties:
Patrick Williams8da396c2022-03-14 14:21:02 -050057 - name: SensorValue
58 type: double
59 description: >
60 The sensor value that triggered the alarm change.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060061 - name: PerformanceLossHighAlarmDeasserted
62 description: >
63 The high threshold alarm deasserted.
64 properties:
Patrick Williams8da396c2022-03-14 14:21:02 -050065 - name: SensorValue
66 type: double
67 description: >
68 The sensor value that triggered the alarm change.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060069 - name: PerformanceLossLowAlarmAsserted
70 description: >
71 The low threshold alarm asserted.
72 properties:
Patrick Williams8da396c2022-03-14 14:21:02 -050073 - name: SensorValue
74 type: double
75 description: >
76 The sensor value that triggered the alarm change.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060077 - name: PerformanceLossLowAlarmDeasserted
78 description: >
79 The low threshold alarm deasserted.
80 properties:
Patrick Williams8da396c2022-03-14 14:21:02 -050081 - name: SensorValue
82 type: double
83 description: >
84 The sensor value that triggered the alarm change.