blob: 4182ecaff42e99d440a2b6c5985329766ef19890 [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.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060046
47signals:
48 - name: WarningHighAlarmAsserted
49 description: >
50 The high threshold alarm asserted.
51 properties:
52 - name: SensorValue
53 type: double
54 description: >
55 The sensor value that triggered the alarm change.
56 - name: WarningHighAlarmDeasserted
57 description: >
58 The high threshold alarm deasserted.
59 properties:
60 - name: SensorValue
61 type: double
62 description: >
63 The sensor value that triggered the alarm change.
64 - name: WarningLowAlarmAsserted
65 description: >
66 The low threshold alarm asserted.
67 properties:
68 - name: SensorValue
69 type: double
70 description: >
71 The sensor value that triggered the alarm change.
72 - name: WarningLowAlarmDeasserted
73 description: >
74 The low threshold alarm deasserted.
75 properties:
76 - name: SensorValue
77 type: double
78 description: >
79 The sensor value that triggered the alarm change.