Integración domótica KLF200 - io-homecontrol, gratuita y de código abierto
Discover and control io-homecontrol shutters already paired to a Velux KLF200 gateway.
Publicado por vincentBesseau
- Dispositivos
- Versión 1.0.3
- Requiere Gladys >=4.86.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
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).
Parámetros de configuración
Estos son los parámetros que KLF200 - io-homecontrol te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| KLF200 gateway | section | No | Shutters must already be paired via the Velux app or the gateway's own UI. |
| KLF200 IP address | string | Sí | |
| KLF200 password | secret | Sí | |
| TLS fingerprint (optional) | string | No | Leave empty to skip certificate pinning. |
Cómo instalar KLF200 - io-homecontrol en Gladys
- En Gladys, abre Integraciones: KLF200 - io-homecontrol aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/vincentbesseau/gladys-klf-200-io-homecontrol:1.0.3), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol.
KLF200 - io-homecontrol requiere Gladys >=4.86.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
KLF200 - io-homecontrol es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene vincentBesseau, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación