Intégration KLF200 - io-homecontrol pour Gladys Assistant
Découvre et pilote les volets io-homecontrol déjà appairés à une passerelle Velux KLF200.
Publiée par vincentBesseau
- Appareils
- Version 1.0.3
- Nécessite Gladys >=4.86.0
- ★ 0
Ceci est la documentation utilisateur de l'intégration. Gladys ré-héberge ce fichier et affiche un lien Documentation permanent vers lui dans l'écran de configuration — c'est au moment de configurer que l'utilisateur en a le plus besoin.
Ce que vous obtenez
Chaque volet/fenêtre io-homecontrol® déjà appairé à votre passerelle Velux KLF200 (via l'appli Velux ou l'interface d'appairage de la passerelle) apparaît automatiquement, avec deux fonctionnalités pilotables :
- Position — un curseur 0–100 %.
- État — un bouton ouvert / stop / fermé.
Les deux sont interrogées toutes les 60 secondes : un mouvement fait en dehors de Gladys (télécommande physique, appli Velux) est donc répercuté automatiquement en moins d'une minute.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Renseignez l'adresse IP et le mot de passe de la passerelle KLF200 (définis sur la passerelle elle-même). Optionnellement, collez son empreinte TLS pour épingler le certificat.
- Enregistrez : l'intégration se connecte à la passerelle et les volets déjà connus apparaissent dans l'onglet Découverte, prêts à être ajoutés.
Limitation connue
Le KLF200 n'accepte qu'une seule connexion à la fois. Si la passerelle vient d'être utilisée par un autre client (l'appli Velux, une autre intégration…), une tentative de connexion peut être brièvement refusée — l'intégration réessaie automatiquement toutes les 30 secondes, sans action requise.
Dépannage
L'intégration journalise chaque tentative de connexion, découverte et commande : consultez les
logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte).
Paramètres de configuration
Voici les paramètres demandés par KLF200 - io-homecontrol dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Passerelle KLF200 | section | Non | Les volets doivent déjà être appairés via l'appli Velux ou l'interface du KLF200. |
| Adresse IP du KLF200 | string | Oui | |
| Mot de passe du KLF200 | secret | Oui | |
| Empreinte TLS (optionnelle) | string | Non | Laisser vide pour ne pas épingler le certificat. |
Comment installer KLF200 - io-homecontrol dans Gladys
- Dans Gladys, ouvrez Intégrations : KLF200 - io-homecontrol apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/vincentbesseau/gladys-klf-200-io-homecontrol:1.0.3), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol.
KLF200 - io-homecontrol nécessite Gladys >=4.86.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
KLF200 - io-homecontrol est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par vincentBesseau, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation