AR Command — Voltage and Temperature Thresholds
Configuration of trigger “windows” for analog inputs, system voltages, and temperature sensors.
What is it for?
| Use case | Description |
|---|---|
| 🔋 Battery monitoring | Alert when voltage leaves safe range |
| 🌡️ Temperature control | Detect over-temperature or freezing |
| ⚡ Analog inputs | Monitor external voltages on digital inputs |
| 🚨 Automation | Generate AR+ and AR- events for rules |
Description
Rinho manages analog voltages on its digital inputs, allowing reading of external voltages and configuration of trigger thresholds or voltage range “windows”.
Can be used:
- The device’s analog inputs (AD0-AD5)
- The main power supply and backup battery as auxiliary inputs
- Temperature values obtained via OneWire input
Generates AR+ when the value enters the configured range and AR- when it exits the range (both above and below).
Syntax
Query
QARaaResponse
RARaabbcddddeffffgggConfigure
SARaabbcddddeffffgggParameters
| Field | Description | Values |
|---|---|---|
| aa | Threshold index | 00 to 07 |
| bb | Input index to sense | See inputs table |
| c | Lower threshold sign | + or - (temperatures), + (voltages) |
| dddd | Minimum value | +0000 to +3000 cV or -5500 to +8500 °C |
| e | Upper threshold sign | + or - (temperatures), + (voltages) |
| ffff | Maximum value | +0000 to +3000 cV or -5500 to +8500 °C |
| ggg | Debounce (optional) | Tenths of second (IoT v1.04.03+) |
Input Indices
| Index | Input | Description |
|---|---|---|
00-05 | AD0-AD5 | Digital/analog input |
06 | V | Main power supply |
07 | VBU | Backup battery |
08 | OW0/DT0 | OneWire input 0 |
09 | OW1/DT1 | OneWire input 1 |
10 | TEMP | Internal microcontroller temperature |
11-16 | DT2-DT7 | Additional temperature sensors (IoT only) |
The maximum allowable voltage on the measurement scale is 30.00 Vdc.
Examples
Main battery monitoring
>SAR0206+1050+1380<Configures threshold 02 to sense the main battery (06) between 10.50V and 13.80V.
Behavior:
AR02+→ Voltage enters range 10.50V-13.80VAR02-→ Voltage exits range (< 10.50V or > 13.80V)
OneWire temperature control
>SAR0408+3000+3500<Configures threshold 04 to sense the OneWire input (08) between 30°C and 35°C.
Behavior:
AR04+→ Temperature enters zone 30°C-35°CAR04-→ Temperature exits range (< 30°C or > 35°C)
Associated Signals
| Property | Value |
|---|---|
| Signal | AR |
| Index | 00-07 |
| Suitable for conditional use | Yes |
| Edges | + (enters range), - (exits range) |
Related Commands
| Command | Description |
|---|---|
| AD | Analog voltage reading |
| AE | Extended analog input reading |
| DT | OneWire temperature reading |
| SS | Trigger configuration |
Compatibility
💾Firmware v1.03.00
SPLegacy
ULLegacy
8 thresholds
💾Firmware v1.00.00
SP-IOT
SM-IOT
ZE-IOT
8 thresholds, debounce v1.04.03+, DT2-DT7
See Also
- SS Command - Signals and triggers
- AD Command - Voltage reading
- DT Command - Temperature reading
- Event Engine - Automation
Last updated