blob: e4d23ea36a7df726fc0781d4fbf0cf44777217d7 [file] [log] [blame]
Brad Bishop45387d62016-11-10 21:58:58 -06001description: >
2 Implement to provide warning class sensor thresholds. Objects implementing
3 Sensor.Threshold.Warning must be instantiated in the correct hierarchy within
4 the sensors namespace. The following sensor hierarchies are recognized:
5 temperature
6 fan_tach
7 voltage
8 altitude
Brad Bishop6c4e2e92016-12-28 13:38:31 -05009 current
10 power
11 energy
12
Brad Bishop45387d62016-11-10 21:58:58 -060013
14 Additionally, any object implementing Sensor.Threshold.Warning must also
15 implement Sensor.Value.
16
17properties:
18 - name: WarningHigh
James Feist4ec65872018-07-31 11:00:25 -070019 type: double
Patrick Williams2c33a892020-11-04 12:14:13 -060020 default: NaN
Brad Bishop45387d62016-11-10 21:58:58 -060021 description: >
Patrick Williams2c33a892020-11-04 12:14:13 -060022 The upper bound of the warning threshold. A value of 'NaN' is used
23 to indicate there is no threshold of this type.
Brad Bishop45387d62016-11-10 21:58:58 -060024 - name: WarningLow
James Feist4ec65872018-07-31 11:00:25 -070025 type: double
Patrick Williams2c33a892020-11-04 12:14:13 -060026 default: NaN
Brad Bishop45387d62016-11-10 21:58:58 -060027 description: >
Patrick Williams2c33a892020-11-04 12:14:13 -060028 The lower bound of the warning threshold. A value of 'NaN' is used
29 to indicate there is no threshold of this type.
Brad Bishop6d514352017-01-05 21:33:17 -050030 - name: WarningAlarmHigh
Brad Bishop45387d62016-11-10 21:58:58 -060031 type: boolean
32 description: >
Brad Bishop6d514352017-01-05 21:33:17 -050033 True if the sensor value has exceeded the defined bound.
34 False if the sensor value has not exceeded the defined bound.
Brad Bishop45387d62016-11-10 21:58:58 -060035
Brad Bishop6d514352017-01-05 21:33:17 -050036 WarningAlarmHigh may be set to False to clear an alarm condition.
37 The behavior of setting WarningAlarmHigh to True is undefined.
38 - name: WarningAlarmLow
39 type: boolean
40 description: >
41 True if the sensor value has exceeded the defined bound.
42 False if the sensor value has not exceeded the defined bound.
43
44 WarningAlarmLow may be set to False to clear an alarm condition.
45 The behavior of setting WarningAlarmLow to True is undefined.