Vallox Smart-Home-Integration, kostenlos und Open Source

Steuere dein Vallox-Lüftungsgerät lokal: Profile, Lüfter und Temperaturen.
Steuere dein Vallox-Lüftungsgerät mit Wärmerückgewinnung aus Gladys Assistant: Profile (Zuhause, Abwesend, Boost, Kamin), Lüfterstufen, Zulufttemperaturen und alle Sensoren des Geräts (Temperaturen, Feuchte, CO2, Filter). Szenenauslöser, Szenenaktionen und ein Dashboard-Widget sind dabei.
Alles bleibt in deinem lokalen Netzwerk: Die Integration spricht mit dem Gerät wie seine eigene Weboberfläche. Kein Cloud-Konto, kein Internetzugang nötig.
Unterstützte Geräte
Vallox-Geräte mit MV-Steuerung und Netzwerkanschluss, deren Weboberfläche unter
http://<Adresse des Geräts> erreichbar ist: Vallox 51/90/96/99/101/110/125/139/145/245 MV,
ValloPlus 180/240/270/350/370/510/850 MV, ValloMulti 200/300 MV, TSK Multi MV sowie die Helios-KWL-
Geräte mit derselben Steuerung.
Ältere Geräte ohne Netzwerkanschluss (Digit SE, Digit 2…) werden nicht unterstützt.
Bevor du beginnst
- Verbinde das Gerät mit deinem Netzwerk (Kabel am Ethernet-Anschluss des Geräts).
- Gib ihm in deinem Router eine feste IP-Adresse (DHCP-Reservierung): Die Integration findet das Gerät über seine Adresse.
- Prüfe, dass
http://<diese Adresse>die Vallox-Weboberfläche in einem Browser öffnet, von einem Rechner im selben Netzwerk wie Gladys.
Installation
Gehe in Gladys zu Integrationen, suche Vallox und installiere sie.
Konfiguration
| Feld | Was eintragen |
|---|---|
| IP-Adresse des Geräts | Die Adresse des Geräts, z. B. 192.168.1.50. Mehrere Geräte: durch Kommas trennen. |
| Aktualisierungsintervall (s) | Wie oft das Gerät gelesen wird. Standard 60 s, mindestens 15 s. |
| Filterwarnung (Tage) | Der Auslöser „Filterwechsel fällig“ löst aus, wenn die Restlaufzeit diesen Wert erreicht. |
Speichere und klicke dann auf Verbindung testen: Die Antwort nennt Modell, Firmware, Profil und Temperaturen jedes Geräts oder den Grund, warum es nicht geantwortet hat.
Gehe danach in der Integration zu Entdecken und lege das Gerät an.
Das Gerät
Das Lüftungsgerät wird ein Gladys-Gerät, benannt nach seinem Modell. Es wird an seiner eindeutigen Kennung erkannt: Eine spätere Änderung der IP-Adresse erzeugt kein neues Gerät.
| Funktion | Typ | Wozu |
|---|---|---|
| Ventilation on/off | Schalter | Stoppt oder startet das Gerät |
| Away mode (Abwesend) | Schalter | Profil Abwesend / zurück zu Zuhause |
| Boost | Schalter | Boost für die am Gerät eingestellte Dauer / Boost beenden |
| Fireplace mode (Kamin) | Schalter | Kaminmodus für die am Gerät eingestellte Dauer / beenden |
| Fan speed | Sensor (%) | Aktuelle Lüfterstufe |
| Indoor air (extract) | Temperatur | Aus den Räumen abgesaugte Luft (Abluft) |
| Outdoor air | Temperatur | Einströmende Außenluft |
| Supply air | Temperatur | In die Räume geblasene Luft (Zuluft) |
| Exhaust air | Temperatur | Fortluft |
| Humidity | Feuchte (%) | Falls das Gerät den Fühler hat |
| CO2 | CO2 (ppm) | Falls das Gerät den Fühler hat |
| Fan speed (home/away/boost) | Einstellung (%) | Lüfterstufe jedes Profils |
| Supply air target (home/away/boost) | Sollwert (°C) | Zulufttemperatur jedes Profils (5 bis 25 °C) |
| Boost / fireplace time left | Dauer (min) | Restzeit des laufenden Boosts oder Kaminmodus |
| Filter change in | Dauer (Tage) | Tage bis zum nächsten Filterwechsel |
Die Funktionsnamen sind englisch (Gladys zeigt sie so an): Du kannst sie im Gerät umbenennen.
Die Gerätekarte zeigt das Abzeichen lokal, solange das Gerät antwortet, sonst nicht erreichbar.
Szenen
Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Lüftungsprofil geändert | Das Profil wurde am Bedienteil, in der App oder per Timer geändert | Gerätename, neues Profil, vorheriges Profil |
| Lüftungsalarm | Ein neuer Alarm ist aktiv (Lüfterstörung, vereister Tauscher, Filter…) | Gerätename, Schweregrad, Alarm, Code, Meldung |
| Filterwechsel fällig | Die Filter-Restlaufzeit hat die eingestellte Anzahl Tage erreicht | Gerätename, Resttage, Wechseldatum |
| Lüftungsgerät nicht erreichbar | Das Gerät antwortet nicht mehr (zwei Lesevorgänge nacheinander fehlgeschlagen) | Gerätename, Adresse |
Jeder Auslöser lässt sich auf ein Gerät beschränken, „Profil geändert“ auf bestimmte Profile, „Alarm“ auf einen Schweregrad.
Befehle von Gladys (Dashboard, Szenen, Widget) lösen „Profil geändert“ nie aus: Eine Szene, die auf einen Profilwechsel reagiert und das Profil erneut ändert, kann keine Schleife bilden.
Profilwerte in den Variablen: home (Zuhause), away (Abwesend), boost, fireplace (Kamin),
extra. Die Alarmmeldung ist englisch.
Aktionen
| Aktion | Wozu | Ergebnis für die nächsten Aktionen |
|---|---|---|
| Lüftungsprofil setzen | Zuhause, Abwesend, Boost oder Kamin; Dauer in Minuten optional | Profil |
| Lüfterstufe eines Profils setzen | Lüfterstufe (%) des Profils Zuhause, Abwesend oder Boost | Lüfterstufe |
| Filterwechsel erfassen | Die Filter wurden heute gewechselt: Das Gerät startet die Erinnerung neu | nächstes Wechseldatum |
| Lüftungswerte lesen | Liest das Gerät jetzt | Profil, Temperaturen, Feuchte, CO2, Lüfterstufe, Filter-Resttage |
Beispiel: Wenn die Feuchte im Bad über 75 % steigt, 30 Minuten Boost einschalten.
Dashboard-Widget
Füge das Widget Vallox-Lüftung zu einem Dashboard hinzu. Es zeigt:
- Live-Kacheln: Innen- und Außentemperatur, Lüfterstufe und CO2 (oder Feuchte, oder Zuluft);
- eine Statusliste: Profil und Restzeit, Zustand des Wärmetauschers (Wärmerückgewinnung, Bypass, Abtauen), Filterwechsel, Alarme, Verbindung;
- drei Tasten: Zuhause, Abwesend, Boost.
Bei mehreren Geräten wählst du das Gerät in den Widget-Einstellungen.
Tasten im Konfigurationsbildschirm
- Verbindung testen: liest jedes Gerät sofort und sagt, was gefunden wurde.
- Filter heute gewechselt: Nach einem Filterwechsel das Gerät wählen; die Erinnerung startet ab heute neu.
Fehlerbehebung
| Problem | Was prüfen |
|---|---|
| „Keine Antwort von 192.168.1.50“ | Die Adresse, das Kabel, und dass http://<Adresse> im Browser im Netzwerk von Gladys aufgeht. |
| Das Gerät erscheint nicht in Entdecken | Das Gerät muss einmal geantwortet haben: Verbindung testen, dann erneut Entdecken. |
| Feuchte oder CO2 bleibt leer | Das Gerät hat diesen Fühler nicht: Der Wert wird nicht veröffentlicht. |
| Die Werte kommen spät | Das Aktualisierungsintervall verringern (mindestens 15 s). |
| Die Vallox-App funktioniert nicht mehr | Das Gerät nimmt nur wenige Verbindungen gleichzeitig an: Intervall nicht unter 30 s setzen. |
Die Logs der Integration (Integrationen → Vallox → Logs) nennen das betroffene Gerät und den Grund.
Datenschutz
Die Integration spricht nur mit der eingegebenen Adresse in deinem lokalen Netzwerk (Port 80).
Nichts wird an Vallox oder einen anderen Dienst gesendet. Die einzige geschriebene Datei ist
/data/units.json mit Kennung, Modell und Firmware der bereits bekannten Geräte.
Konfigurationseinstellungen
Diese Einstellungen fragt Vallox in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Integration spricht direkt im lokalen Netzwerk mit dem Gerät, so wie die Vallox-Weboberfläche: kein Cloud-Konto. Gib dem Gerät in deinem Router eine feste IP-Adresse, prüfe, dass sich http://<diese Adresse> im Browser öffnet, und trage die Adresse unten ein. |
| IP-Adresse des Geräts | string | Ja | Mehrere Geräte: Trenne ihre Adressen durch Kommas. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft das Gerät gelesen wird, in Sekunden (15 bis 3600). |
| Filterwarnung (Tage) | number | Nein | Der Szenenauslöser „Filterwechsel fällig“ löst aus, wenn die Restlaufzeit des Filters diese Anzahl Tage erreicht. |
So installierst du Vallox in Gladys
- Öffne in Gladys Integrationen: Vallox erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-vallox:1.0.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/prohand/gladys-vallox.
Vallox benötigt Gladys >=5.3.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
Vallox 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 prohand 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