From 5e6108bb35e498154de894e11b3b19cfc01cb35c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Fern=C3=A1ndez=20Rojas?= Date: Wed, 13 Apr 2022 01:06:54 +0200 Subject: [PATCH] Improve Airzone integration documentation (#22280) --- source/_integrations/airzone.markdown | 35 ++++++++++++++++++++++----- 1 file changed, 29 insertions(+), 6 deletions(-) diff --git a/source/_integrations/airzone.markdown b/source/_integrations/airzone.markdown index 18d1d1ba7e3..c1d4fead5b5 100644 --- a/source/_integrations/airzone.markdown +++ b/source/_integrations/airzone.markdown @@ -18,13 +18,11 @@ ha_codeowners: ha_integration_type: integration --- -This integration allows getting values from the local API of Airzone HVAC zoning systems. +This integration interacts with the Local API of [Airzone HVAC zoning systems](https://www.airzone.es/en/). -There is currently support for the following device types within Home Assistant: +A typical Airzone device has a *master zone* (Master Thermostat) per HVAC system, which is the only zone where the HVAC mode can be changed. The rest are *slave zones* (Slave Thermostats) which can only enable or disable the HVAC and adjust the desired temperature on that specific zone. -- Binary Sensor -- Climate -- Sensor +Note that multiple HVAC systems can be connected to the same Airzone WebServer. In this case, there will be a *master zone* per HVAC system and there may also be *slave zones* for each HVAC system. {% include integrations/config_flow.md %} @@ -35,4 +33,29 @@ Port: description: "Network port" {% endconfiguration_basic %} -Temperature and humidity sensors and air demand, floor demand, and problems binary sensors for each HVAC zone are created, as well as their corresponding climate entities. +## Binary Sensors + +For each Airzone zone (Thermostat), the following *binary sensors* are created: + +| Condition | Description | +| :------------------ | :--------------------------------- | +| air_demand | HVAC is running. | +| floor_demand | Radiating floor is running. | +| problems | Zone has errors or warnings. | + +## Climate + +For each Airzone zone (Thermostat) a *climate entity* is created. + +**HVAC mode can only be changed on a *master zone*.** + +*Slave zones* can only enable/disable the current HVAC mode selected on the corresponding *master zone*. Attempting to change the HVAC mode on a *slave zone* will result on a Home Assistant error. + +## Sensors + +For each Airzone zone (Thermostat), the following *sensors* are created: + +| Condition | Description | +| :------------------ | :--------------------------------- | +| humidity | Current zone relative humidity. | +| temperature | Current zone temperature. |