
Hallo zusammen ![]()
Ich habe gerade eine neue externe Integration veröffentlicht, um eure Rollläden/Fenster
io-homecontrol® (Velux, Somfy kompatibel mit io-homecontrol…) über ein Gateway KLF200
direkt von Gladys aus zu steuern.
100 % lokal: Die Integration kommuniziert direkt mit dem KLF200 in eurem lokalen Netzwerk (proprietäre TLS-API des Gateways). Keine Cloud, kein Konto, keine Daten, die euer Zuhause verlassen.
Was sie kann
- Automatische Erkennung aller bereits mit eurem KLF200 gepaarten Rollläden (über die Velux-App oder
die Gateway-Oberfläche) — keine manuelle Eingabe erforderlich. - Zwei Funktionen pro Rollladen, beide von Gladys aus steuerbar:
- Position: Schieberegler 0–100 %.
- Status: Schaltfläche öffnen / stop / schließen.
- Polling alle 60 Sekunden: Eine Bewegung, die außerhalb von Gladys erfolgt (physischer Fernbedienung,
Velux-App), wird automatisch in Gladys in weniger als einer Minute aktualisiert. - Automatische Wiederverbindung (Wiederholung alle 30 s): Der KLF200 akzeptiert nur eine Sitzung gleichzeitig und
kann langsam sein, eine freizugeben — die Integration handelt das selbstständig, ohne Eingriff.
Wichtig: Der KLF200 akzeptiert nur eine Verbindung gleichzeitig
Das ist eine Hardware-Beschränkung des Velux-Gateways, kein Bug der Integration: Der KLF200 akzeptiert nur eine aktive API-Sitzung zu einem bestimmten Zeitpunkt und kann langsam sein, eine freizugeben, wenn sie schlecht endet (einige Dutzend Sekunden, manchmal mehr).
Konkreter, wenn ein anderer Client diese Sitzung gleichzeitig verwendet (Velux-App geöffnet, ein anderes Skript, eine andere Smart-Home-Integration…), kann ein Verbindungsversuch von Gladys vorübergehend abgelehnt werden. Keine Sorge: Die Integration erkennt den Fehler und versucht es automatisch alle 30 Sekunden erneut, ohne dass ihr etwas tun müsst — es wird sich immer wieder verbinden, sobald das Gateway verfügbar ist.
Wenn ihr ein anderes Tool laufen lasst, das kontinuierlich mit dem KLF200 kommuniziert (z. B. eine selbstgebaute MQTT-Brücke), vermeidet es, es parallel zu Gladys dauerhaft verbunden zu lassen: Beide würden sich um dieselbe Sitzung streiten.
Installation
In Gladys: Integrationen → Von GitHub installieren, mit der Repo-URL:
https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol
Oder ihr wartet, bis die Integration im Store verfügbar ist ![]()
Ihr müsst nur noch die IP und das Passwort eures KLF200-Gateways im Konfigurations-Tab eingeben und dann eine Erkennung starten. ![]()
Repo & Quellcode
Integration 100 % Open-Source, basierend auf dem offiziellen SDK @gladysassistant/integration-sdk und der Lib klf-200-api. CI (Lint + Tests) und Multi-Arch-Build (amd64/arm64) automatisiert über GitHub Actions.
Zögert nicht, Feedback zu geben, Bugs zu melden oder Verbesserungsvorschläge zu machen — Issues und PRs sind willkommen! ![]()