KLF200 - io-homecontrol Smart-Home-Integration, kostenlos und Open Source
Discover and control io-homecontrol shutters already paired to a Velux KLF200 gateway.
Veröffentlicht von vincentBesseau
- Geräte
- Version 1.0.3
- Erfordert Gladys >=4.86.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This is the user documentation of the integration. Gladys re-hosts this file and shows a permanent Documentation link to it in the Configuration screen — it is when configuring that the user needs it most.
What you get
Every io-homecontrol® shutter/window already paired to your Velux KLF200 gateway (via the Velux app or the gateway's own pairing UI) shows up automatically, each with two controllable features:
- Position — a 0–100% slider.
- State — an open / stop / closed button.
Both are polled every 60 seconds, so a move made outside Gladys (physical remote, Velux app) is reflected automatically within a minute.
Configuration
- Open the Configuration tab of the integration.
- Fill in the KLF200 gateway's IP address and password (set on the gateway itself). Optionally paste its TLS fingerprint to pin the certificate.
- Save: the integration connects to the gateway and the shutters it already knows about appear in the Discovery tab, ready to be added.
Known limitation
The KLF200 only accepts a single connection at a time. If the gateway was recently used by another client (the Velux app, another integration…) a connection attempt can be briefly refused — the integration retries automatically every 30 seconds and needs no manual action.
Troubleshooting
The integration logs every connection attempt, discovery and command: check the integration logs
from the Gladys UI (or docker logs on the host).
Konfigurationseinstellungen
Diese Einstellungen fragt KLF200 - io-homecontrol in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| KLF200 gateway | section | Nein | Shutters must already be paired via the Velux app or the gateway's own UI. |
| KLF200 IP address | string | Ja | |
| KLF200 password | secret | Ja | |
| TLS fingerprint (optional) | string | Nein | Leave empty to skip certificate pinning. |
So installierst du KLF200 - io-homecontrol in Gladys
- Öffne in Gladys Integrationen: KLF200 - io-homecontrol erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/vincentbesseau/gladys-klf-200-io-homecontrol:1.0.3) 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/vincentBesseau/gladys-klf-200-io-homecontrol.
KLF200 - io-homecontrol benötigt Gladys >=4.86.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
KLF200 - io-homecontrol 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 vincentBesseau veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation