Integration: KLF200 - io-homecontrol

KLF200 - io-homecontrol

Hallo zusammen :waving_hand:

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.

:locked: 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.

:warning: 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.

:backhand_index_pointing_right: 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 :wink:

Ihr müsst nur noch die IP und das Passwort eures KLF200-Gateways im Konfigurations-Tab eingeben und dann eine Erkennung starten. :clapper_board:

Repo & Quellcode

:link: GitHub - vincentBesseau/gladys-klf-200-io-homecontrol: Intégration Gladys Assistant pour volets io-homecontrol via passerelle Velux KLF200 · GitHub

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! :folded_hands:

1 „Gefällt mir“