2024.12.5
Home ▸ Integrations ▸

Airzone Cloud

This integration interacts with the Cloud API of Airzone devices.

There are two main types of Airzone devices:

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 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.

Configuration

To add the Airzone Cloud integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Airzone Cloud.

  • Follow the instructions on screen to complete the setup.

Username

Cloud API username

Password

Cloud API password

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.