In dieser Anleitung lernst du, wie du das Velux KIG 300 Gateway über die HomeKit-Controller-Integration in Home Assistant sichtbar machst, wenn sich Gateway und Home Assistant in getrennten Netzwerksegmenten befinden. Die Einrichtung richtet sich an fortgeschrittene Anwender mit getrenntem IoT-Netzwerk.
Voraussetzungen
- Ein Linux-basiertes Gateway (beispielsweise ein Raspberry Pi), das als Brücke zwischen dem normalen LAN und dem IoT-VLAN fungiert.
- Passende Berechtigungen zum Bearbeiten der Konfiguration auf diesem Gateway-System.
- Avahi ist auf dem Gateway-System installiert.
- Eine funktionierende Home Assistant-Instanz im LAN sowie das eingerichtete Velux KIG 300 im IoT-VLAN (2,4-GHz-WLAN).
Schritt 1: Konfigurationsdatei sichern
Bevor Änderungen an Netzwerkdiensten vorgenommen werden, sollte eine Sicherungskopie der bestehenden Konfiguration von Avahi angelegt werden, um Fehleinstellungen jederzeit rückgängig machen zu können.
Schritt 2: mDNS-Reflector in Avahi aktivieren
Befindet sich das KIG 300 in einem separaten IoT-VLAN mit eigenem IP-Bereich, wird es von der HomeKit-Controller-Integration in Home Assistant im normalen LAN nicht automatisch gefunden. Um das Gateway netzwerkübergreifend auffindbar zu machen, wird Avahi als mDNS-Reflector konfiguriert. Öffne die Konfigurationsdatei von Avahi und passe den Abschnitt [reflector] wie folgt an:
[reflector]
enable-reflector=yes
reflect-ipv=noSchritt 3: Avahi-Dienst neu starten
Damit Avahi die veränderten Einstellungen übernimmt und als Reflector arbeitet, muss der Dienst neu geladen werden.
sudo systemctl restart avahi-daemonSchritt 4: Home Assistant neu starten und Kopplung durchführen
Starte den Home Assistant Host oder den Dienst über die Weboberfläche neu, damit das Gerät erkannt werden kann. Anschließend erscheint das Velux KIG 300 in Home Assistant unter den Benachrichtigungen beziehungsweise als neues HomeKit-Gerät. Zur Kopplung gibst du den HomeKit-Code ein, der sich auf der Rückseite des KIG 300 Gateways befindet.
Funktionsprüfung
Prüfe zunächst auf dem Gateway, ob der Avahi-Dienst fehlerfrei aktiv ist:
sudo systemctl status avahi-daemonIn der Ausgabe sollte der Status active (running) angezeigt werden. Im Webinterface von Home Assistant wird das KIG 300 nun aufgeführt, und gekoppelte Dachfenster oder Rollläden tauchen als Entitäten auf.
Wenn etwas schiefgeht
- Gerät wird trotz Reflector nicht gefunden: Wenn die Velux-App auf dem Smartphone zur HomeKit-Einbindung auffordert, diesen Vorgang nicht auf dem Smartphone abschließen, sondern stattdessen Home Assistant neu starten. Falls das Gateway zuvor schon in HomeKit eingerichtet wurde, kann es nötig sein, es dort zu entfernen oder am KIG 300 über die Konfigurationstaste zurückzusetzen (Taste drücken, bis die LED rot leuchtet).
- KIG 300 verliert die WLAN-Verbindung: Das Gateway unterstützt ausschließlich 2,4-GHz-WLAN. Stelle sicher, dass das 2,4-GHz-Band während des Einrichtens aktiv und erreichbar ist.
Rückgängig machen
Um die Reflector-Funktion zu deaktivieren, stelle die gesicherte Konfigurationsdatei wieder her und starte den Avahi-Dienst neu.
Fazit
Mit der Reflector-Funktion von Avahi überwindest du VLAN-Grenzen für die HomeKit-Integration des Velux KIG 300, ohne die Netzwerkisolation aufzugeben. Nach der Kopplung stehen dir die Velux-Geräte in Home Assistant für Dashboards und Automatisierungen zur Verfügung.
Quellen: Forum: Simon42 – Forum, community.home-assistant.io, community.simon42.com