Skip to content

Document new Airzone MQTT integration #38203

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: next
Choose a base branch
from
Draft

Document new Airzone MQTT integration #38203

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e11704d
Document new Airzone MQTT integration
Noltari Mar 26, 2025
676a4d7
Add missing removal documentation
Noltari Mar 26, 2025
a3c3254
tiny tweaks
c0ffeeca7 Apr 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 47 additions & 0 deletions source/_integrations/airzone_mqtt.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: Airzone MQTT
description: Instructions on how to integrate Airzone MQTT within Home Assistant.
ha_release: 2025.5
ha_category:
- Sensor
ha_iot_class: Local Push
ha_config_flow: true
ha_domain: airzone_mqtt
ha_platforms:
- sensor
ha_codeowners:
- '@Noltari'
ha_integration_type: integration
---

The **Airzone MQTT** {% term integration %} interacts with the MQTT API of [Airzone HVAC zoning systems](https://www.airzone.es/en/).

A typical Airzone device has a *parent zone* (Master Thermostat) per <abbr title="heating, ventilation, and air conditioning">HVAC</abbr> system, which is the only zone where the HVAC mode can be changed. The rest are *child zones* which can only enable or disable the <abbr title="heating, ventilation, and air conditioning">HVAC</abbr> and adjust the desired temperature on that specific zone.

Note that multiple <abbr title="Heating, ventilation, and air conditioning">HVAC</abbr> systems can be connected to the same Airzone WebServer. In this case, there will be a *parent zone* per HVAC system and there may also be *child zones* for each HVAC system.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are there any prerequisites? Anything I need to have ready before installing the integration? set up an app, login credentials?

{% include integrations/config_flow.md %}

{% configuration_basic %}
MQTT Topic:
description: "MQTT Topic ID configured via Airzone Cloud app"
{% endconfiguration_basic %}

## Sensors

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

| Condition | Description |
| :------------------ | :--------------------------------- |
| humidity | Current zone relative humidity. |
| hvac_mode | Current zone HVAC mode. |
| hvac_setpoint | Current zone HVAC setpoint. |
| hvac_setpoint_max | Current zone HVAC maximum setpoint. |
| hvac_setpoint_min | Current zone HVAC minimum setpoint. |
| temperature | Current zone temperature. |

## Removing the integration

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

{% include integrations/remove_device_service.md %}