Zum Hauptinhalt springen

Vallox Smart-Home-Integration, kostenlos und Open Source

Vallox-Integration für Gladys Assistant

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​

  1. Verbinde das Gerät mit deinem Netzwerk (Kabel am Ethernet-Anschluss des Geräts).
  2. Gib ihm in deinem Router eine feste IP-Adresse (DHCP-Reservierung): Die Integration findet das Gerät über seine Adresse.
  3. 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​

FeldWas eintragen
IP-Adresse des GerätsDie 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.

FunktionTypWozu
Ventilation on/offSchalterStoppt oder startet das Gerät
Away mode (Abwesend)SchalterProfil Abwesend / zurück zu Zuhause
BoostSchalterBoost für die am Gerät eingestellte Dauer / Boost beenden
Fireplace mode (Kamin)SchalterKaminmodus für die am Gerät eingestellte Dauer / beenden
Fan speedSensor (%)Aktuelle Lüfterstufe
Indoor air (extract)TemperaturAus den Räumen abgesaugte Luft (Abluft)
Outdoor airTemperaturEinströmende Außenluft
Supply airTemperaturIn die Räume geblasene Luft (Zuluft)
Exhaust airTemperaturFortluft
HumidityFeuchte (%)Falls das Gerät den Fühler hat
CO2CO2 (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 leftDauer (min)Restzeit des laufenden Boosts oder Kaminmodus
Filter change inDauer (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öserWannVariablen
Lüftungsprofil geändertDas Profil wurde am Bedienteil, in der App oder per Timer geändertGerätename, neues Profil, vorheriges Profil
LüftungsalarmEin neuer Alarm ist aktiv (Lüfterstörung, vereister Tauscher, Filter…)Gerätename, Schweregrad, Alarm, Code, Meldung
Filterwechsel fälligDie Filter-Restlaufzeit hat die eingestellte Anzahl Tage erreichtGerätename, Resttage, Wechseldatum
Lüftungsgerät nicht erreichbarDas 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​

AktionWozuErgebnis für die nächsten Aktionen
Lüftungsprofil setzenZuhause, Abwesend, Boost oder Kamin; Dauer in Minuten optionalProfil
Lüfterstufe eines Profils setzenLüfterstufe (%) des Profils Zuhause, Abwesend oder BoostLüfterstufe
Filterwechsel erfassenDie Filter wurden heute gewechselt: Das Gerät startet die Erinnerung neunächstes Wechseldatum
Lüftungswerte lesenLiest das Gerät jetztProfil, 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​

ProblemWas 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 EntdeckenDas Gerät muss einmal geantwortet haben: Verbindung testen, dann erneut Entdecken.
Feuchte oder CO2 bleibt leerDas Gerät hat diesen Fühler nicht: Der Wert wird nicht veröffentlicht.
Die Werte kommen spätDas Aktualisierungsintervall verringern (mindestens 15 s).
Die Vallox-App funktioniert nicht mehrDas 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.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinDie 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ätsstringJaMehrere Geräte: Trenne ihre Adressen durch Kommas.
Aktualisierungsintervall (s)numberNeinWie oft das Gerät gelesen wird, in Sekunden (15 bis 3600).
Filterwarnung (Tage)numberNeinDer Szenenauslöser „Filterwechsel fällig“ löst aus, wenn die Restlaufzeit des Filters diese Anzahl Tage erreicht.

So installierst du Vallox in Gladys​

  1. Öffne in Gladys Integrationen: Vallox erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. 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).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂