---
title: Airzone Cloud
description: Instructions on how to integrate Airzone Cloud within Home Assistant.
ha_release: 2023.6
ha_category:
  - Binary sensor
  - Climate
  - Select
  - Sensor
  - Switch
  - Water heater
ha_iot_class: Cloud Push
ha_config_flow: true
ha_domain: airzone_cloud
ha_platforms:
  - binary_sensor
  - climate
  - diagnostics
  - select
  - sensor
  - switch
  - water_heater
ha_codeowners:
  - '@Noltari'
ha_integration_type: integration
---

This integration interacts with the Cloud API of [Airzone devices](https://www.airzone.es/en/).

There are two main types of Airzone devices:
- [Aidoo](https://www.airzonecontrol.com/aa/en/control-solutions/aidoo/wi-fi/) / [Aidoo Pro](https://www.airzonecontrol.com/aa/en/control-solutions/aidoo/pro/)
- [Easyzone (US)](https://www.airzonecontrol.com/aa/en/control-solutions/easyzone/) / [Flexa (EU)](https://www.airzonecontrol.com/ib/es/soluciones-de-control/flexa/)

## Aidoo / Aidoo Pro

These devices are Wi-Fi controllers that are normally connected to a single air conditioner split system.

## Easyzone (US) / Flexa (EU)

These devices are connected to ducted air conditioners, motorized grilles, and individual thermostats for every room (zone). Therefore, with a single ducted air conditioning system, the user can turn on and off the air conditioner and set different desired temperatures in each room.

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/#action-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 %}

## Binary sensors

For each Airzone system (HVAC machine), the following *binary sensors* are created:

| Condition           | Description                                               |
| :------------------ | :-------------------------------------------------------- |
| problems            | Indicates that the current system has errors or warnings. |

For each Airzone zone (thermostat), the following *binary sensors* are created:

| Condition           | Description                                             |
| :------------------ | :------------------------------------------------------ |
| air_quality_active  | Indicates that the air quality control is running.      |
| problems            | Indicates that the current zone has errors or warnings. |

## Climate

For each Airzone Aidoo (HVAC Wi-Fi controller), a climate entity is created.

For each Airzone zone (thermostat), a climate entity is created.

**HVAC mode can only be changed on a *parent zone*.**

*Child zones* can only enable/disable the current HVAC mode selected on the corresponding *parent zone*. Attempting to change the HVAC mode on a *child zone* will result in a Home Assistant error.

## Select

For each Airzone zone (thermostat), the following *selects* are created:

| Condition           | Description                                         |
| :------------------ | :-------------------------------------------------- |
| air_quality         | Selects the desired Air Quality working mode.       |

## Sensors

For each Airzone Aidoo (HVAC Wi-Fi controller), the following *sensors* are created:

| Condition           | Description                                        |
| :------------------ | :------------------------------------------------- |
| temperature         | Measures the temperature from the HVAC thermostat. |

For each Airzone zone (thermostat), the following *sensors* are created:

| Condition           | Description                                               |
| :------------------ | :-------------------------------------------------------- |
| air_quality_index   | Indicates the Air Quality Index in the current zone.      |
| humidity            | Measures the relative humidity in the current zone.       |
| pm1                 | Concentration of particles with a diameter of less than 1 µm.   |
| pm2_5               | Concentration of particles with a diameter of less than 2.5 µm. |
| pm10                | Concentration of particles with a diameter of less than 10 µm.  |
| temperature         | Measures the temperature in the current zone.             |

For each Airzone WebServer (HVAC Wi-Fi controller), the following *sensors* are created:

| Condition           | Description                                        |
| :------------------ | :------------------------------------------------- |
| rssi                | Wi-Fi RSSI.                                        |

## Switch

For each Airzone zone (thermostat), a switch entity is created to turn the thermostat on or off (without changing the HVAC mode).

## Water heater

For each Airzone device, a *water heater entity* is created if supported.

## Removing the integration

This integration follows standard integration removal. No extra steps are required.

{% include integrations/remove_device_service.md %}