From acd384ff4f892616bfc70c9a7f7bbf4d1671c9ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Fern=C3=A1ndez=20Rojas?= Date: Wed, 24 May 2023 19:18:47 +0200 Subject: [PATCH] Document new Airzone cloud integration (#27456) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * airzone_cloud: add documentation Signed-off-by: Álvaro Fernández Rojas * airzone_cloud: fix copy&paste typo Signed-off-by: Álvaro Fernández Rojas * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/airzone_cloud.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * airzone_cloud: adjust Sensors table Signed-off-by: Álvaro Fernández Rojas * airzone_cloud: tweak description a little bit Signed-off-by: Álvaro Fernández Rojas * Fix typo --------- Signed-off-by: Álvaro Fernández Rojas Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/airzone_cloud.markdown | 39 +++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 source/_integrations/airzone_cloud.markdown diff --git a/source/_integrations/airzone_cloud.markdown b/source/_integrations/airzone_cloud.markdown new file mode 100644 index 00000000000..ec86d5016d5 --- /dev/null +++ b/source/_integrations/airzone_cloud.markdown @@ -0,0 +1,39 @@ +--- +title: Airzone Cloud +description: Instructions on how to integrate Airzone Cloud within Home Assistant. +ha_release: 2023.6 +ha_category: + - Sensor +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_domain: airzone_cloud +ha_platforms: + - sensor +ha_codeowners: + - '@Noltari' +ha_integration_type: integration +--- + +This integration interacts with the Cloud API of [Airzone HVAC zoning systems](https://www.airzone.es/en/). + +A typical Airzone HVAC system consists of a parent device (called *master zone* in Airzone terminology) and child devices (called *slave zones* in Airzone terminology). The [HVAC mode](https://www.home-assistant.io/integrations/climate/#service-climateset_hvac_mode) can only be changed on the parent device. On child devices, you can only enable or disable the HVAC and adjust the desired temperature for that specific device. + +Note that multiple HVAC systems can be connected to the same Airzone web server. In this case, there will be one *parent zone* per HVAC system and there may also be *child zones* for each HVAC system. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Username: + description: "Cloud API username" +Password: + description: "Cloud API password" +{% endconfiguration_basic %} + +## Sensors + +For each Airzone zone (thermostat), the following *sensors* are created: + +| Condition | Description | +| :------------------ | :-------------------------------------------------- | +| humidity | Measures the relative humidity in the current zone. | +| temperature | Measures the temperature in the current zone. |