miakapp

Guide · Velux

Piloter ses Velux sans le boîtier officiel.

Vos fenêtres de toit Velux pilotées directement par radio, depuis votre téléphone et dans vos automatisations, avec une carte à 25 € au lieu d’une box. Position réelle et capteur de pluie compris.

Le problème

Les fenêtres de toit motorisées Velux INTEGRA se commandent avec une télécommande. Pour les piloter depuis un téléphone, Velux vend une box : aujourd’hui la VELUX App Control KIG 300, autour de 100 à 120 € 19, qui passe par le cloud de Velux et Netatmo, sauf en local via Apple HomeKit 1, où des utilisateurs signalent qu’elle n’accepte pas l’ordre « stop » 23.

L’ancienne passerelle KLF 200, la seule avec une API locale, n’est plus fabriquée 5 ; elle se revend autour de 200 à 260 € 22. Sa remplaçante, la KLF 150, n’a que des contacts secs et pas d’API 6.

Le protocole a été ouvert

Les Velux INTEGRA parlent io-homecontrol : une radio 868 MHz, bidirectionnelle, chiffrée avec une clé propre à chaque installation 23. Enregistrer le signal et le rejouer ne marche pas : le moteur lance un défi que seuls les appareils qui ont la clé savent relever 3.

Des passionnés ont documenté ce protocole 3, et un projet libre récent, home_io_control, l’implémente sur une carte ESP32 équipée d’une radio 868 MHz 8. La carte parle directement aux fenêtres : ouvrir, fermer, stop, position de 0 à 100 % avec retour réel, position d’aération et capteur de pluie 8913. Sa liste d’appareils indique la fenêtre de toit INTEGRA comme confirmée 9.

Reste la clé. Le projet ne la casse pas : il se fait passer pour un nouveau produit, et c’est votre propre clavier Velux (KLR 200 ou KLR 300), ou une KLF 200, qui la lui transmet par son menu « ajouter un produit », comme Velux le prévoit pour ses accessoires 10.

Trois façons de faire

Un ESP32 sur un interrupteur mural Velux

Si vous n’avez que des interrupteurs à sens unique : simple, mais sans retour d’état.

Une installation qui n’a que des interrupteurs KLI 31x ne peut pas transmettre sa clé, et la voie radio y est encore expérimentale 15. On achète alors un interrupteur KLI de plus, associé à vos fenêtres, et une carte ESP32 à relais « appuie » sur ses boutons 1718.

Un bouton ne renvoie rien : la position est estimée d’après le temps de course, et un bricoleur qui pilote ainsi cinq stores envoie chaque ordre deux fois, parce qu’un store le rate parfois 18. Il faut souder sur de petites pastilles.

MatérielPrix indicatif
Interrupteur mural VELUX KLI 311 20≈ 38 €
Carte LilyGO T-Relay (ESP32, 4 relais) 21≈ 15 €
Alimentation, fils≈ 10 €
Total≈ 50 à 70 €

Si vous avez déjà une KLF 200

Gardez-la : son API locale est éprouvée, et elle peut aussi donner sa clé à la radio.

Depuis le firmware 2.0.0.71, la KLF 200 a une API locale sur le réseau ; l’agent la pilote avec une bibliothèque existante, klf-200-api en Node.js ou pyvlx en Python 57.

Limites connues : deux connexions simultanées au plus, firmware impossible à rétrograder, état de pluie relu toutes les cinq minutes 14.

MatérielPrix indicatif
VELUX KLF 200, déjà installée—
Total0 €

Prix relevés en novembre 2026 chez des revendeurs européens ; ils varient selon le pays et le moment.

Ce que vous pouvez demander ensuite

Ferme toutes les fenêtres de toit si de la pluie est annoncée dans l’heure ou si le vent dépasse 40 km/h, et dis-moi lesquelles étaient ouvertes.

Aère la chambre dix minutes à 7 h si le CO₂ a dépassé 1 200 ppm pendant la nuit, sauf s’il fait moins de 5 °C dehors.

Quand il fait plus de 26 °C sous les toits et moins dehors le soir, mets les fenêtres en position d’aération jusqu’à minuit.

Ce que fait l’agent

  • Il regarde ce que vous avez déjà (clavier KLR, interrupteurs KLI, KLF 200) et choisit la voie avec vous.
  • Voie radio : il écrit la configuration ESPHome, flashe la carte, vous guide sur le clavier pour la transmission de la clé, la range dans un secret et non dans le code, puis teste chaque fenêtre une à une.
  • Il relie la carte au coordinateur en local, ajoute une commande par fenêtre et un « tout fermer » dans l’app, et branche les automatisations sur la météo, la pluie et vos capteurs.
  • Il suit les versions du projet et met la carte à jour quand un correctif concerne vos modèles.

À savoir avant de commencer

  • C’est un projet communautaire jeune, fourni sans garantie, confirmé par une poignée d’utilisateurs pour les fenêtres INTEGRA 81314.
  • Maintenir trop longtemps le bouton PROG d’un moteur peut le désassocier de votre télécommande, et juste après une coupure de courant, le réinitialiser 11.
  • La clé de votre installation s’affiche en clair dans le journal de la carte : ne la publiez jamais, par exemple dans un ticket GitHub 15.
  • Certaines cartes avec amplificateur dépassent la puissance radio autorisée en 868 MHz si on ne garde pas le réglage basse puissance prévu 12.
  • Les Velux d’avant io-homecontrol, avec télécommande infrarouge WLR 100, se pilotent encore plus simplement : une petite carte ESP et une LED infrarouge suffisent 24.

Sources

  1. Home Assistant — Velux integration
  2. VELUX — KLI 310/311/312 wall switches (io-homecontrol, 868 MHz)
  3. iown-homecontrol — open documentation of the io-homecontrol protocol
  4. openHAB — Velux binding (KLF 200 limits)
  5. pyvlx — Python library for the KLF 200 (“discontinued by Velux”)
  6. VELUX — KLF 150 interface
  7. klf-200-api — Node.js library for the KLF 200
  8. home_io_control — ESPHome component speaking io-homecontrol
  9. home_io_control — supported devices
  10. home_io_control — recovering the installation key from a keypad
  11. home_io_control — pairing and the PROG button
  12. home_io_control — supported boards and radio power
  13. home_io_control — issue #98, INTEGRA windows working, rain sensor
  14. home_io_control — issue #87, per-model fixes
  15. home_io_control — FAQ (one-way installations, key in the log)
  16. Hexaspot — Heltec WiFi LoRa 32 V3 (price)
  17. velux_applehome_esp32 — ESP32 relays on KLI 311/312 switches
  18. Velux on HomeKit through a Zigbee relay soldered to a KLI switch
  19. Hornbach — VELUX App Control KIG 300 (price)
  20. Servistores — VELUX KLI 311 switch (price)
  21. TinyTronics — LilyGO T-Relay ESP32 board (price)
  22. baubay — VELUX KLF 200 (price)
  23. Home Assistant community — KIG 300 over HomeKit, no stop command
  24. Home Assistant community — older Velux with WLR 100 infrared remotes driven by ESPHome

Prix et projets vérifiés en novembre 2026.

Confiez-le à votre agent

Créez la maison, connectez votre agent et donnez-lui ce guide comme point de départ.