Matt Spinler | 45ed88d | 2020-11-20 11:33:16 -0600 | [diff] [blame] | 1 | description: > |
| 2 | Implement to provide soft shutdown class sensor thresholds. Objects |
| 3 | implementing Sensor.Threshold.Shutdown must be instantiated in the correct |
| 4 | hierarchy within the sensors namespace. The following sensor hierarchies |
| 5 | are recognized: |
Patrick Williams | d5f3635 | 2021-12-22 09:13:27 -0600 | [diff] [blame] | 6 | airflow |
Matt Spinler | 45ed88d | 2020-11-20 11:33:16 -0600 | [diff] [blame] | 7 | altitude |
| 8 | current |
Matt Spinler | 45ed88d | 2020-11-20 11:33:16 -0600 | [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 |
Matt Spinler | 45ed88d | 2020-11-20 11:33:16 -0600 | [diff] [blame] | 17 | |
| 18 | Additionally, any object implementing Sensor.Threshold.SoftShutdown must |
| 19 | also implement Sensor.Value. |
| 20 | |
| 21 | properties: |
| 22 | - name: SoftShutdownHigh |
| 23 | type: double |
| 24 | default: NaN |
| 25 | description: > |
| 26 | The upper bound of the soft shutdown threshold. A value of 'NaN' is |
| 27 | used to indicate there is no threshold of this type. |
| 28 | - name: SoftShutdownLow |
| 29 | type: double |
| 30 | default: NaN |
| 31 | description: > |
| 32 | The lower bound of the soft shutdown threshold. A value of 'NaN' is |
| 33 | used to indicate there is no threshold of this type. |
| 34 | - name: SoftShutdownAlarmHigh |
| 35 | type: boolean |
| 36 | description: > |
| 37 | True if the sensor value has exceeded the defined bound. |
| 38 | False if the sensor value has not exceeded the defined bound. |
| 39 | |
| 40 | SoftShutdownAlarmHigh may be set to False to clear an alarm condition. |
| 41 | The behavior of setting SoftShutdownAlarmHigh to True is undefined. |
| 42 | - name: SoftShutdownAlarmLow |
| 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 | |
| 48 | SoftShutdownAlarmLow may be set to False to clear an alarm condition. |
| 49 | The behavior of setting SoftShutdownAlarmLow to True is undefined. |
Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 50 | |
| 51 | signals: |
| 52 | - name: SoftShutdownHighAlarmAsserted |
| 53 | description: > |
| 54 | The high threshold alarm asserted. |
| 55 | properties: |
Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 56 | - name: SensorValue |
| 57 | type: double |
| 58 | description: > |
| 59 | The sensor value that triggered the alarm change. |
Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 60 | - name: SoftShutdownHighAlarmDeasserted |
| 61 | description: > |
| 62 | The high threshold alarm deasserted. |
| 63 | properties: |
Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 64 | - name: SensorValue |
| 65 | type: double |
| 66 | description: > |
| 67 | The sensor value that triggered the alarm change. |
Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 68 | - name: SoftShutdownLowAlarmAsserted |
| 69 | description: > |
| 70 | The low threshold alarm asserted. |
| 71 | properties: |
Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 72 | - name: SensorValue |
| 73 | type: double |
| 74 | description: > |
| 75 | The sensor value that triggered the alarm change. |
Matt Spinler | 70ee1cf | 2021-01-21 15:25:59 -0600 | [diff] [blame] | 76 | - name: SoftShutdownLowAlarmDeasserted |
| 77 | description: > |
| 78 | The low threshold alarm deasserted. |
| 79 | properties: |
Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 80 | - name: SensorValue |
| 81 | type: double |
| 82 | description: > |
| 83 | The sensor value that triggered the alarm change. |