Danfoss Air Smart-Home-Integration, kostenlos und Open Source
Danfoss Air ventilation over the local CCM: temperatures, humidity, fan, filter; optional commands.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Shows a Danfoss Air heat recovery ventilation unit (Air a2, a3, w2… fitted with the CCM, Connection and Control Module) in Gladys, over your local network, without any cloud or account. Unofficial integration, not affiliated with Danfoss. Never tested with a real device: it follows the protocol as the open-source library pydanfossair (used by Home Assistant) speaks it; please report what you see.
Before you start
- The CCM must be on your network (Ethernet) and reachable from Gladys on TCP port 30046. Give it a fixed IP address in your router.
- The CCM has no password and accepts one connection at a time: keep it on a trusted network, and close the Danfoss Air app (or another home automation that reads it) if Gladys cannot connect.
Setup
- Install the integration from the Gladys store.
- Enter the IP address of the CCM (port 30046 unless you add one), save.
- Open the Discovery tab and add the unit.
What you get
One device, Danfoss Air ventilation, with:
| Feature | Notes |
|---|---|
| Outdoor, supply, extract and exhaust air temperatures | °C |
| Room temperature (Air Dial) and calculated room temperature | °C |
| Humidity | % |
| Airflow | %, read only (it may show as a fan in HomeKit, but refuses every command) |
| Supply and extract fan speeds | rpm |
| Filter life remaining | % |
| Air Dial battery | % |
| Boost active, bypass open, automatic bypass, away mode | read only, 1 = on |
| Operation mode | list: demand, program, manual |
| Fan step (manual mode) | list: 1 to 10 |
| Start / stop the boost, open / close the bypass, automatic bypass on / off | buttons |
The unit is read every 60 s (configurable from 30 s to 1 h). The test button, a Discovery scan, a reconnection of Gladys or a restart of the integration never read it sooner than the interval. The one exception: after a command that was not confirmed, the unit is read again 5 s and 20 s later to check its effect.
Commands
All commands except Stop the boost are refused unless Allow the commands is on (off by default). There is no switch: a "turn everything off" of a voice assistant never reaches the ventilation.
- Each command reads the register again just before writing it, writes nothing when it is already so, and is confirmed only when the value read back is the one asked. A command that may have reached the unit without being confirmed answers "sent, without confirmation": check the unit a few seconds later. A command that cannot be written within 3.5 s is refused and nothing is sent.
- The fan step can only be set in manual mode (choose the mode first).
- Stop the boost is always allowed: it is never held back by the option, by another command or by a read in progress, and cancels a command not sent yet. If the CCM refuses the connection for a moment, it tries again every 250 ms until 3.5 s after the press. If it is not confirmed, the reads of the following two minutes send it again (twice at most) while the boost shows on; a "Start the boost" pressed afterwards wins and is never undone.
- Unit stopped from the Air Dial (mode 3, or step read 0): the status says so, the lists do not change, and the mode, fan step and "Start the boost" commands are refused. The bypass commands are sent as they are (they move a damper, they do not start the fans); "Stop the boost" is always allowed. Gladys neither stops nor restarts the ventilation in this version (stopping a heat recovery unit stops the air renewal).
- Opening the bypass stops the heat recovery (fresh air not warmed): use it in summer.
Limits
- The protocol is not documented by Danfoss; only the registers read and written by pydanfossair are used.
- The protocol gives no serial number: the integration shows one unit, the one at the configured address. Changing the address keeps the device and its history; another unit put at the same address would show on the same device and receive its commands too. Reserve the address of the CCM in your router (fixed DHCP lease).
- An answer of the unit must be exactly 63 bytes; an incomplete answer ends the read (nothing is published shifted).
- Gladys holds the connection while it reads (about a second every interval): the Danfoss Air app may have to wait, and conversely.
- The room temperature and battery come from the Air Dial remote; without one they may stay empty.
Privacy
Nothing leaves your network. The integration keeps only the time of its last
read in its /data volume.
Konfigurationseinstellungen
Diese Einstellungen fragt Danfoss Air in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your Danfoss Air unit | section | Nein | Shows your Danfoss Air heat recovery ventilation in Gladys through its CCM module (Connection and Control Module, TCP port 30046) on your local network, without any cloud: temperatures (outdoor, supply, extract, exhaust, room), humidity, airflow, fan speeds, filter, Air Dial battery, boost, bypass and away mode. Enter the IP address of the CCM (give it a fixed address in your router), save, then add the unit from the Discovery tab. The mode, fan step, boost and bypass can be changed from Gladys only if you allow the commands below; stopping the boost always works. The CCM has no password and accepts one connection at a time: keep it on a trusted network. Never tested with a real device. Not affiliated with Danfoss. |
| IP address of the CCM | string | Ja | An IPv4 address or a host name (port 30046 unless you add one, for example 192.168.1.70:30046). |
| Allow the commands | boolean | Nein | Off by default. On: Gladys may change the operation mode, the manual fan step, start the boost, open or close the bypass and turn the automatic bypass on or off. Off: these commands are refused. Stopping the boost is always allowed. |
| Refresh interval (s) | number | Nein | How often the unit is read, in seconds. |
| Language of the feature names | select | Nein | Used for the names of the device and features added from now on, the status and the command errors. |
So installierst du Danfoss Air in Gladys
- Öffne in Gladys Integrationen: Danfoss Air erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-danfoss-air:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-danfoss-air.
Danfoss Air benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Danfoss Air ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation