Skip to main content

Airzone Cloud integration for Gladys Assistant

Airzone Cloud integration for Gladys Assistant

Control your Airzone ducted air conditioning zones through the Airzone Cloud service.

View on GitHubAll external integrations

Overview​

This integration connects Gladys Assistant to Airzone Cloud to control your Airzone ducted air conditioning zones from Gladys.

Once configured, every zone of your Airzone Cloud account appears in the Gladys Discovery screen. Each zone exposes these features:

  • Power — turn the zone on or off;
  • Mode — cooling, heating, fan, drying or auto (on the master zone only);
  • Temperature — the target temperature, within the min/max bounds of the zone;
  • Room temperature — the current temperature measured in the zone (read-only);
  • Humidity — the relative humidity measured in the zone (read-only).

If your installation includes an Airzone air-quality sensor, it is published as its own device exposing temperature, humidity, CO2, PM2.5, PM10, TVOC, pressure and a global air-quality index (all read-only, with history).

Zone states are refreshed every 10 seconds, so changes made from the Airzone thermostat or the Airzone Cloud app show up in Gladys shortly after.

Prerequisites​

  • An Airzone Cloud account (airzonecloud.com) with your installation already registered in it: your Airzone system needs an Airzone webserver (Airzone Cloud) paired with the Airzone Cloud app.
  • The installation must be reachable from Airzone Cloud: this integration talks to the Airzone cloud, so your Gladys instance needs Internet access.

Configuration​

  1. Install the integration from the Gladys store.
  2. Open its Configuration screen and fill in:
    • Airzone Cloud email — the email address of your Airzone Cloud account;
    • Airzone Cloud password — the password of that account (stored as a secret, never displayed back).
  3. Save. The integration logs in to Airzone Cloud and loads your zones.
  4. Open the Discovery screen: your zones are listed there. Add the ones you want, then place them in your rooms and dashboards like any Gladys device.

To use another Airzone Cloud account later, just update the email and password in the Configuration screen: the integration reconnects and refreshes the zone list automatically.

Troubleshooting​

  • "Airzone Cloud is not configured" during discovery — the email or password is missing: fill in both fields in the Configuration screen and save.
  • Login fails — double-check your credentials by signing in at airzonecloud.com.
  • A zone is missing from Discovery — make sure it is visible in the Airzone Cloud app with the same account, then run the discovery again.
  • Commands seem ignored — Airzone can take a few seconds to push a command to the unit; the state in Gladys reflects the cloud state and catches up at the next 10-second poll. Also check that the installation is online in the Airzone Cloud app (webserver connected).
  • States stop updating — the Airzone session may have expired; the integration refreshes its token automatically. If the problem persists, check the integration logs from its configuration page in Gladys.

Configuration settings​

These are the settings Airzone Cloud asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Airzone Cloud emailstringYesThe email address of your Airzone Cloud account.
Airzone Cloud passwordsecretYesThe password of your Airzone Cloud account.

How to install Airzone Cloud in Gladys​

  1. In Gladys, open Integrations: Airzone Cloud appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/callemand/gladys-airzone-cloud:1.1.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/callemand/gladys-airzone-cloud.

Airzone Cloud requires Gladys >=4.62.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Airzone Cloud is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by callemand, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on