
¡Hola a todos! ![]()
Acabo de publicar una nueva integración externa para controlar sus persianas/ventanas
io-homecontrol® (Velux, compatible con Somfy io-homecontrol…) a través de una pasarela KLF200,
directamente desde Gladys.
100 % local: la integración habla directamente con el KLF200 en su red local (API TLS propietaria de la pasarela). Sin nube, sin cuenta que crear, sin datos que salgan de su casa.
Qué hace
- Descubrimiento automático de todas las persianas ya emparejadas con su KLF200 (a través de la aplicación Velux o
la interfaz de la pasarela) — no es necesario volver a introducirlas manualmente. - Dos funcionalidades por persiana, ambas controlables desde Gladys:
- Posición: control deslizante del 0–100 %.
- Estado: botón abierto / stop / cerrado.
- Sondeo cada 60 segundos: un movimiento realizado fuera de Gladys (mandos a distancia
físicos, aplicación Velux) se actualiza automáticamente en Gladys en menos de un minuto. - Reconexión automática (reintento cada 30 s): el KLF200 solo acepta una sesión a la vez y
puede tardar en liberarla — la integración lo gestiona sola, sin intervención.
A tener en cuenta: el KLF200 solo acepta una conexión a la vez
Es una limitación material de la pasarela Velux, no un error de la integración: el KLF200 solo acepta una sola sesión API activa en un momento dado, y puede tardar en liberarla cuando termina mal (unas pocas decenas de segundos, a veces más).
En concreto, si otro cliente está utilizando esa sesión al mismo tiempo (la aplicación Velux abierta, otro script, otra integración domótica…), un intento de conexión desde Gladys puede ser temporalmente rechazado. No hay de qué preocuparse: la integración detecta el fallo y reintenta automáticamente cada 30 segundos, sin ninguna acción de su parte — siempre acaba reconectándose en cuanto la pasarela está disponible.
Si está ejecutando otra herramienta que habla con el KLF200 de forma continua (ej. un puente MQTT casero), evite dejarla conectada permanentemente en paralelo con Gladys: las dos se disputarían la misma sesión.
Instalación
En Gladys: Integraciones → Instalar desde GitHub, con la URL del repositorio:
https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol
O esperar a que la integración llegue a la tienda ![]()
Solo queda introducir la IP y la contraseña de su pasarela KLF200 en la pestaña
Configuración, y luego iniciar un descubrimiento. ![]()
Repositorio & código fuente
Integración 100 % de código abierto, basada en el SDK oficial @gladysassistant/integration-sdk y en
la librería klf-200-api. CI (lint + pruebas) y compilación
multi-arch (amd64/arm64) automatizados a través de GitHub Actions.
No duden en darme su opinión, reportar errores o sugerir mejoras — ¡los issues y PR son bienvenidos! ![]()