# Intégration : KLF200 - io-homecontrol

**URL:** <https://community.gladysassistant.com/t/integration-klf200-io-homecontrol/10708>\
**Category:** Développement\
**Created:** [Août 26, 2026, 6:27 UTC](https://community.gladysassistant.com/t/integration-klf200-io-homecontrol/10708 "2026-08-26T06:27:10Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![spenceur](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/spenceur/32/1961_2.png) [@spenceur](https://community.gladysassistant.com/u/spenceur)\
**Post date:** [Août 26, 2026, 6:27 UTC](https://community.gladysassistant.com/t/integration-klf200-io-homecontrol/10708/1 "2026-08-26T06:27:10Z")

</div>

![KLF200 - io-homecontrol](https://raw.githubusercontent.com/vincentBesseau/gladys-klf-200-io-homecontrol/main/assets/cover.png)

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 :

```auto
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

🔗 [GitHub - vincentBesseau/gladys-klf-200-io-homecontrol: Intégration Gladys Assistant pour volets io-homecontrol via passerelle Velux KLF200 · GitHub](https://github.com/vincentBesseau/gladys-klf-200-io-homecontrol)

Intégration 100 % open-source, basée sur le SDK officiel `@gladysassistant/integration-sdk` et sur  
la lib [`klf-200-api`](https://www.npmjs.com/package/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 ! 🙏