blob: 83eb0243dd50a5750cbc798a51b4dbcb1c959e75 [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
11 power
Patrick Williams86f8c532021-10-01 06:34:04 -050012 pressure
Patrick Williamsd5f36352021-12-22 09:13:27 -060013 temperature
14 utilization
15 voltage
Matt Spinler1b4a98a2021-01-22 16:28:55 -060016
Patrick Williams86f8c532021-10-01 06:34:04 -050017 Additionally, any object implementing Sensor.Threshold.PerformanceLoss must
18 also implement Sensor.Value.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060019
20properties:
21 - name: PerformanceLossHigh
22 type: double
23 default: NaN
24 description: >
25 The upper bound of the warning threshold. A value of 'NaN' is used
26 to indicate there is no threshold of this type.
27 - name: PerformanceLossLow
28 type: double
29 default: NaN
30 description: >
31 The lower bound of the warning threshold. A value of 'NaN' is used
32 to indicate there is no threshold of this type.
33 - name: PerformanceLossAlarmHigh
34 type: boolean
35 description: >
36 True if the sensor value has exceeded the defined bound.
37 False if the sensor value has not exceeded the defined bound.
38
Patrick Williams86f8c532021-10-01 06:34:04 -050039 PerformanceLossAlarmHigh may be set to False to clear an alarm
40 condition. The behavior of setting PerformanceLossAlarmHigh to True
41 is undefined.
Matt Spinler1b4a98a2021-01-22 16:28:55 -060042 - name: PerformanceLossAlarmLow
43 type: boolean
44 description: >
45 True if the sensor value has exceeded the defined bound.
46 False if the sensor value has not exceeded the defined bound.
47
Patrick Williams86f8c532021-10-01 06:34:04 -050048 PerformanceLossAlarmLow may be set to False to clear an alarm
49 condition. The behavior of setting PerformanceLossAlarmLow to True is
50 undefined.
Matt Spinler70ee1cf2021-01-21 15:25:59 -060051signals:
52 - name: PerformanceLossHighAlarmAsserted
53 description: >
54 The high threshold alarm asserted.
55 properties:
56 - name: SensorValue
57 type: double
58 description: >
59 The sensor value that triggered the alarm change.
60 - name: PerformanceLossHighAlarmDeasserted
61 description: >
62 The high threshold alarm deasserted.
63 properties:
64 - name: SensorValue
65 type: double
66 description: >
67 The sensor value that triggered the alarm change.
68 - name: PerformanceLossLowAlarmAsserted
69 description: >
70 The low threshold alarm asserted.
71 properties:
72 - name: SensorValue
73 type: double
74 description: >
75 The sensor value that triggered the alarm change.
76 - name: PerformanceLossLowAlarmDeasserted
77 description: >
78 The low threshold alarm deasserted.
79 properties:
80 - name: SensorValue
81 type: double
82 description: >
83 The sensor value that triggered the alarm change.