| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 1 | description: > |
| 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: |
| Patrick Williams | d5f3635 | 2021-12-22 09:13:27 -0600 | [diff] [blame] | 5 | airflow |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 6 | altitude |
| Brad Bishop | 6c4e2e9 | 2016-12-28 13:38:31 -0500 | [diff] [blame] | 7 | current |
| Brad Bishop | 6c4e2e9 | 2016-12-28 13:38:31 -0500 | [diff] [blame] | 8 | energy |
| Patrick Williams | d5f3635 | 2021-12-22 09:13:27 -0600 | [diff] [blame] | 9 | fan_tach |
| Patrick Williams | 1bcf7fa | 2021-12-22 09:14:37 -0600 | [diff] [blame] | 10 | humidity |
| Patrick Williams | d5f3635 | 2021-12-22 09:13:27 -0600 | [diff] [blame] | 11 | power |
| Patrick Williams | 86f8c53 | 2021-10-01 06:34:04 -0500 | [diff] [blame] | 12 | pressure |
| Patrick Williams | d5f3635 | 2021-12-22 09:13:27 -0600 | [diff] [blame] | 13 | temperature |
| 14 | utilization |
| 15 | voltage |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 16 | |
| 17 | Additionally, any object implementing Sensor.Threshold.Warning must also |
| 18 | implement Sensor.Value. |
| 19 | |
| 20 | properties: |
| 21 | - name: WarningHigh |
| James Feist | 4ec6587 | 2018-07-31 11:00:25 -0700 | [diff] [blame] | 22 | type: double |
| Patrick Williams | 2c33a89 | 2020-11-04 12:14:13 -0600 | [diff] [blame] | 23 | default: NaN |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 24 | description: > |
| Patrick Williams | 2c33a89 | 2020-11-04 12:14:13 -0600 | [diff] [blame] | 25 | The upper bound of the warning threshold. A value of 'NaN' is used |
| 26 | to indicate there is no threshold of this type. |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 27 | - name: WarningLow |
| James Feist | 4ec6587 | 2018-07-31 11:00:25 -0700 | [diff] [blame] | 28 | type: double |
| Patrick Williams | 2c33a89 | 2020-11-04 12:14:13 -0600 | [diff] [blame] | 29 | default: NaN |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 30 | description: > |
| Patrick Williams | 2c33a89 | 2020-11-04 12:14:13 -0600 | [diff] [blame] | 31 | The lower bound of the warning threshold. A value of 'NaN' is used |
| 32 | to indicate there is no threshold of this type. |
| Brad Bishop | 6d51435 | 2017-01-05 21:33:17 -0500 | [diff] [blame] | 33 | - name: WarningAlarmHigh |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 34 | type: boolean |
| 35 | description: > |
| Brad Bishop | 6d51435 | 2017-01-05 21:33:17 -0500 | [diff] [blame] | 36 | True if the sensor value has exceeded the defined bound. |
| 37 | False if the sensor value has not exceeded the defined bound. |
| Brad Bishop | 45387d6 | 2016-11-10 21:58:58 -0600 | [diff] [blame] | 38 | |
| Brad Bishop | 6d51435 | 2017-01-05 21:33:17 -0500 | [diff] [blame] | 39 | WarningAlarmHigh may be set to False to clear an alarm condition. |
| 40 | The behavior of setting WarningAlarmHigh to True is undefined. |
| 41 | - name: WarningAlarmLow |
| 42 | type: boolean |
| 43 | description: > |
| 44 | True if the sensor value has exceeded the defined bound. |
| 45 | False if the sensor value has not exceeded the defined bound. |
| 46 | |
| 47 | WarningAlarmLow may be set to False to clear an alarm condition. |
| 48 | The behavior of setting WarningAlarmLow to True is undefined. |
| Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 49 | signals: |
| 50 | - name: WarningHighAlarmAsserted |
| 51 | description: > |
| 52 | The high threshold alarm asserted. |
| 53 | properties: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 54 | - name: SensorValue |
| 55 | type: double |
| 56 | description: > |
| 57 | The sensor value that triggered the alarm change. |
| Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 58 | - name: WarningHighAlarmDeasserted |
| 59 | description: > |
| 60 | The high threshold alarm deasserted. |
| 61 | properties: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 62 | - name: SensorValue |
| 63 | type: double |
| 64 | description: > |
| 65 | The sensor value that triggered the alarm change. |
| Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 66 | - name: WarningLowAlarmAsserted |
| 67 | description: > |
| 68 | The low threshold alarm asserted. |
| 69 | properties: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 70 | - name: SensorValue |
| 71 | type: double |
| 72 | description: > |
| 73 | The sensor value that triggered the alarm change. |
| Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 74 | - name: WarningLowAlarmDeasserted |
| 75 | description: > |
| 76 | The low threshold alarm deasserted. |
| 77 | properties: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 78 | - name: SensorValue |
| 79 | type: double |
| 80 | description: > |
| 81 | The sensor value that triggered the alarm change. |