Skip to content

Commit 896f563

Browse files
authored
Add documentation for sensor entities to Airobot integration (#42140)
1 parent 1a9600c commit 896f563

File tree

1 file changed

+32
-1
lines changed

1 file changed

+32
-1
lines changed

source/_integrations/airobot.markdown

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ This is useful when:
6565

6666
## Supported functionality
6767

68-
The **Airobot** integration provides climate control functionality with comprehensive temperature management and preset modes.
68+
The **Airobot** integration provides climate control functionality with comprehensive temperature management and preset modes, as well as detailed sensor monitoring.
6969

7070
### Climate
7171

@@ -85,10 +85,41 @@ The thermostat is represented as a climate entity with the following capabilitie
8585
- **Away**: Use the AWAY temperature setpoint (typically lower for energy savings)
8686
- **Boost**: Temporarily boost heating for 1 hour, then return to the previous mode
8787

88+
### Sensors
89+
90+
The integration provides the following sensor entities to monitor your thermostat and environment:
91+
92+
#### Environmental sensors
93+
94+
- **Air temperature**: The measured air temperature in the room (in °C).
95+
- **Floor temperature**: The measured floor temperature (in °C). Only available if a floor temperature sensor is connected to the thermostat.
96+
- **Humidity**: The measured relative humidity in the room (in %).
97+
- **Carbon dioxide**: The measured carbon dioxide concentration in the room (in ppm). Only available if the thermostat has the optional carbon dioxide sensor.
98+
- **Air quality index**: The calculated air quality index based on carbon dioxide levels. Only available if the thermostat has the optional carbon dioxide sensor.
99+
100+
#### Diagnostic sensors
101+
102+
The following diagnostic sensors are disabled by default. You can enable them in the entity settings if needed:
103+
104+
- **Device uptime**: The time (in hours) since the thermostat was last restarted.
105+
- **Heating uptime**: The cumulative time (in hours) the heating has been active since the thermostat was last restarted.
106+
107+
#### System sensors
108+
109+
- **Errors**: The current error count on the thermostat. A value of 0 indicates normal operation.
110+
88111
## Data updates
89112

90113
The **Airobot** integration {% term polling polls %} data from the thermostat every 30 seconds. This interval matches the thermostat's internal measurement cycle, ensuring efficient data synchronization without overwhelming the device.
91114

115+
## Known limitations
116+
117+
- **Local API only**: The integration only supports the local REST API. Cloud-based control through the Airobot cloud service is not supported.
118+
- **Manual API enablement**: The local REST API must be manually enabled on the thermostat before the integration can connect. It is disabled by default for security reasons.
119+
- **Firmware requirements**: Only firmware version 1.8 or later is supported. Older firmware versions do not provide the local REST API.
120+
- **Heating only**: The thermostat is designed for floor heating control only and does not support cooling modes.
121+
- **Optional sensors**: carbon dioxide and floor temperature sensors are only available if the corresponding hardware is installed in your thermostat model.
122+
92123
## Troubleshooting
93124

94125
### Cannot connect to thermostat

0 commit comments

Comments
 (0)