
Salut à tous ![]()
Je viens de publier une nouvelle intégration externe pour piloter vos volets/fenêtres
io-homecontrol® (Velux, Somfy compatible io-homecontrol…) via une passerelle KLF200,
directement depuis Gladys.
100 % local : l’intégration parle directement au KLF200 sur votre réseau local (API TLS propriétaire du gateway). Aucun cloud, aucun compte à créer, aucune donnée qui sort de chez vous.
Ce qu’elle fait
- Découverte automatique de tous les volets déjà appairés à votre KLF200 (via l’appli Velux ou
l’interface de la passerelle) — pas besoin de tout ressaisir à la main. - Deux fonctionnalités par volet, toutes les deux pilotables depuis Gladys :
- Position : curseur 0–100 %.
- État : bouton ouvert / stop / fermé.
- Polling toutes les 60 secondes : un mouvement fait en dehors de Gladys (télécommande
physique, appli Velux) remonte automatiquement dans Gladys en moins d’une minute. - Reconnexion automatique (retry 30 s) : le KLF200 n’accepte qu’une seule session à la fois et
peut être lent à en libérer une — l’intégration gère ça toute seule, sans intervention.
À savoir : le KLF200 n’accepte qu’une seule connexion à la fois
C’est une limitation matérielle du gateway Velux, pas un bug de l’intégration : le KLF200 n’accepte qu’une seule session API active à un instant donné, et peut être lent à en libérer une quand elle se termine mal (quelques dizaines de secondes, parfois plus).
Concrètement, si un autre client utilise déjà cette session au même moment (l’appli Velux ouverte, un autre script, une autre intégration domotique…), une tentative de connexion depuis Gladys peut être temporairement refusée. Pas d’inquiétude : l’intégration détecte l’échec et réessaie automatiquement toutes les 30 secondes, sans aucune action de votre part — ça finit toujours par se reconnecter dès que le gateway est disponible.
Si vous faites tourner un autre outil qui parle au KLF200 en continu (ex. un pont MQTT maison), évitez de le laisser connecté en permanence en parallèle de Gladys : les deux se disputeraient la même session.
Installation
Dans Gladys : Intégrations → Installer depuis GitHub, avec l’URL du repo :
https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol
Ou a patienter le temps que l’intégration arrive sur le store ![]()
Il ne reste plus qu’à renseigner l’IP et le mot de passe de votre passerelle KLF200 dans l’onglet
Configuration, puis lancer une découverte. ![]()
Repo & code source
Intégration 100 % open-source, basée sur le SDK officiel @gladysassistant/integration-sdk et sur
la lib klf-200-api. CI (lint + tests) et build
multi-arch (amd64/arm64) automatisés via GitHub Actions.
N’hésitez pas si vous avez des retours, des bugs à remonter ou des idées d’amélioration — les
issues et PR sont les bienvenues ! ![]()