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