Cardane Posté(e) le 11 décembre 2017 Signaler Posté(e) le 11 décembre 2017 (modifié) Pilotage des Velux Integra avec le KLF-200 et la HC2 Attention : ce tuto ne fonctionne qu'avec un KLF-200 dont la version de firmware est inférieure à la version 0.2.0.0.71.0. A partir de cette version de firmware, Velux a supprimé l'accès via http au klf-200. La bonne nouvelle, c'est que l'API est en train d'être documenté et surtout largement complété. Il y aura par contre de gros changement au niveau du protocole. J'attends la finalisation de la nouvelle version et de la documentation et je reviendrai mettre à jour ce post. Présentation Le but de ce tuto est d’expliquer comment réaliser l’interface entre le KLF-200 de Velux et notre HC2 Je tiens à remercier @pepite, @Lazer, @Steven, et @OJC pour leur aide dans la réalisation de la scène LUA. Merci aussi au travail d’Erlend sur community.openhab.org qui est à la base de cet article. (https://community.openhab.org/t/io-homecontrol-velux-somethings-in-the-bush/11413/30) Je dispose de plus de 15 Velux, et donc pour moi il fallait absolument trouver une solution avec laquelle je pourrais piloter l’ensemble de ces Velux à moindre coûts, et surtout le plus simplement possible. J’avais envisagé la solution de l’IPX800, mais je n’avais aucune envie de refaire des câblages supplémentaires. En plus, je disposais déjà d’une télécommande de type KLR-200 (IO-Homecontrol) qui me permettait de réaliser quelques scénarios mais non intégrable avec la HC2. Je voulais garder cette télécommande pour des questions de WAF entre autre, mais de facilité aussi. L’intégration avec la HC2 étant la cerise sur le gâteau me permettant d’intégrer les Velux dans des scénarios existants. Lorsque Velux a sorti il y a peu le KLF-200, qui est enfin une interface permettant au monde fermé de Velux de s’ouvrir (un peu) vers les autres solutions, j’ai franchi le cap. Voici le résultat de mon installation. Le KLF-200 Le KLF-200 se présente sous la forme d’un boitier de +/- 12*12*3 cm. Il est donc facilement dissimulable et est d’un poids relativement léger. Il est fourni avec l’alimentation, un câble réseau, et toute une série de câbles dont nous verrons l’utilité par la suite. Les manuels qui l’accompagnent couvrent toutes les langues possibles comme c’est toujours le cas avec Velux. Son prix sur la plupart des sites tourne aux alentours de 300 euros, mais on peut le trouver à 200 euros sur certains sites français. Velux compatibles Les Velux pour lesquels le KLF-200 est conçu sont les Velux Integra. Il s’agit des Velux avec moteur intégré, et prévu pour connecter directement tous les autres accessoires tels que les volets, les stores, les éclairages, etc. Je ne sais pas si ce module fonctionne avec d’autres types de Velux pour lesquels la motorisation et les volets ont été installés par la suite et commandés via d’autres interfaces comme le KUX110. Configuration du KLF-200 Pour une description plus complète et plus précise du boitier et de ses possibilités, il suffit de télécharger la notice du KLF-200 (recherche Google sur « KLF-200 notice ») Voici un bref aperçu La première étape est de configurer le boitier. Lors du démarrage du boitier, il est en point d’accès Wi-Fi pendant 10 minutes (modifiable dans les paramètres) mais il n’offre pas la possibilité de se connecter sur un réseau Wi-Fi existant. Le plus simple reste de le connecter via un câble sur votre réseau, il prendra alors une adresse via le DHCP. Il suffit ensuite de s’y connecter avec n’importe quel browser (Chrome, Safari, Firefox ou autre). On arrive sur la page de login, on entre le mot de passe par défaut et on choisi la langue. On arrive ensuite sur la première page qui va nous permettre d’enregistrer les différents produits. Le plus simple pour cela est de partir d’une commande existante et de lui transmettre les devices qu’elle connait. J’ai donc pris ma KLR-200, et je lui ai demandé de transmettre au KLF-200 les informations connues. De même pour les autres commandes dont je disposais. Le KLF-200 peut enregistrer 5 groupes de produits. Par exemple, il va créer un groupe pour tous les moteurs d’ouvertures, ensuite un autre groupe pour les volets, etc… Je ne sais pas s’il y a un nombre maximum d’objets par groupe, mais avec 15 ça marche. Ci-dessous, une copie d’écran après l’enregistrement des 5 moteurs de ma première pièce. Par défaut, le KLF-200 reprend les noms qui étaient configurés dans la KLR, mais on peut éditer chaque device et modifier ce nom. Si vous cliquer sur le petit icône bleu, le KLF-200 active l’objet en question pendant quelques instants, ce qui vous permet de vérifier qu’il s’agit bien du bon . Ensuite, en choisissant le menu “Programmes”, on peut commencer à créer autant de programmes que l’on veut. Un programme est une suite d’actions sur un ou plusieurs devices. On peut par exemple créer comme ci-dessous un programme qui ouvre tous les Velux à 100%, un autre qui ferme tous les Velux, un autre qui les ouvre tous à 50%, mais aussi par exemple un programme qui va ouvrir deux Velux à 100%, un troisième à 50% qui va baisser le volet d’un quatrième positionner le store d’un cinquième à mi-hauteur. Pour ce faire, le KLF-200 se met en mode enregistrement, et avec une autre télécommande vous actionner vos devices comme vous le voulez. Une fois fini, on arrête l’enregistrement et le tour est joué. Ci-dessous un exemple de 5 programmes pilotant les 5 moteurs des Velux d’une même pièce. La dernière étape est la configuration des entrées/sorties. Comme expliqué ci-dessous, je n’ai pas choisi cette option, préférant utiliser l’appel à l’API, mais le KLF-200 dispose à l’arrière d’une série de connecteurs, qui permettent de réaliser des contacts secs (donc possible via un module Fibaro). L’activation d’un contact sec permet soit de modifier la position d’un produit, soit de basculer entre deux positions, ou enfin d’exécuter un programme. Plus intéressant, la possibilité de récupérer le statut d’une action. Toujours à l’arrière du boitier, on trouve 5 paires, chacune pouvant établir un contact sec suivant la configuration demandée. On peut donc ici aussi connecter un module Fibaro afin de récupérer cette information et l’utiliser dans nos scenarios. (Pour l’instant je ne l’ai pas encore fait, je suis toujours en phase de réflexion sur ce qui me sera le plus utile). Fonctionnement du KLF-200 via l’API Le KLF-200 est conçu à la base pour être piloté via les connections câblées présentes à l’arrière du boitier comme expliqué ci-dessus MAIS, il y a aussi un API REST non documenté et non supporté qui permet d’exécuter directement certaines commandes. C’est cette option que j’utilise actuellement car beaucoup plus simple et surtout moins chère.(moins de modules) Il n’y a aucune description de cet API, je suis donc parti de l’exemple réalisé par « Erlend » Les points faibles 1. Il n’est pas possible de contrôler un seul device directement, il faut passer par un programme (ou alors personne n’a encore trouvé comment le faire) 2. Il n’est pas possible via l’API de connaître la position d’un produit 3. Il n’est pas possible de créer un programme directement via l’interface web, il faut toujours passer par le mode enregistrement, ce qui peut être fastidieux. Il est possible de faire une mise à jour du firmware, mais à ce jour je n’ai toujours pas trouvé de nouvelle version, et comme l’API n’est pas documenté, impossible de savoir si de nouvelles fonctions sont disponibles. Configuration de la HC2 Du côté de la HC2, j’ai donc simplement une scène et VD, qui permettent de piloter l’ensemble. La scène englobe l’appel au KLF-200, via l’API, et le VD permet d’appeler la scène avec passage de paramètres (l’adresse IP du boitier et le programme que je veux exécuter) Chaque fois que l’on désire exécuter un programme sur le KLF-200, cela se passe en trois étapes. Il faut commencer par un LOGIN, qui va retourner un token. Ensuite un deuxième appel (en passant ce token en paramètre) qui demande au KLF-200 d’exécuter une action, et enfin un LOGOUT. On peut bien entendu exécuter plusieurs actions entre le LOGIN et le LOGOUT. L’idéal est de travailler en mode asynchrone, car certaines actions peuvent prendre du temps du côté du KLF-200. La scène Il y a certainement beaucoup d'améliorations à faire dans ce code, mais je n'ai pas eu trop le temps d'y retravailler depuis que cette première version fonctionne. Pendant les fêtes de fin d'année je devrais avoir un peu de temps pour y regarder --[[ %% properties %% events %% globals --]] -- les variables globales ci-dessous sont initialisées avec des valeurs par défaut -- ces valeurs seront normalement écrasées par le passage de paramètres lors de l'appel de la scène. local VeluxDebug = true local programme = "2" local password = "xxxYYYzzz" local KLF_ip = "192.168.yyy.zzz" local params = fibaro:args() if (params) then for k, v in ipairs(params) do if (v.programme) then programme = v.programme end if (v.adresseIP) then KLF_ip = v.adresseIP end if (v.password) then password = v.password end end end local urlLogin = 'http://'.. KLF_ip .. '/api/v1/auth' local urlLogout = 'http://'.. KLF_ip .. '/api/v1/auth' local urlScenes = 'http://'.. KLF_ip .. '/api/v1/scenes' local datasLogin = '{"action":"login","params":{"password":"'.. password .. '"}}' local datasLogout = '{"action":"logout","params":{}}' local datasAction = '{"action":"run","params":{"id":"' ..programme ..'"}}' if (VeluxDebug) then fibaro:debug("Démarrage de la scène avec les paramètres suivants") fibaro:debug("adresse IP = " .. KLF_ip) fibaro:debug("Password = " .. password) fibaro:debug("Programme = " .. programme) fibaro:debug(datasAction) end local klf = net.HTTPClient() klf:request(urlLogin , { success = function(response) if tonumber(response.status) == 200 then if (VeluxDebug) then fibaro:debug("Call for LOGON successfull") fibaro:debug("Valeur de response") fibaro:debug(json.encode(response)) end -- récupération du token local temp = json.encode(response) local token = temp:match('\\\"token\\\":\\\"(.+)\\\",\\\"result') token = string.gsub(token, '\\', '') if (VeluxDebug) then fibaro:debug("Valeur du token : "..token) end klf:request(urlScenes, { success = function(response) if tonumber(response.status) == 200 then if (VeluxDebug) then fibaro:debug("Call for ACTION successful") fibaro:debug("response\n") fibaro:debug(json.encode(response)) end klf:request(urlLogout , { success = function(response) if tonumber (response.status) == 200 then if (VeluxDebug) then fibaro:debug("Call for LOGOUT successful") fibaro:debug("response\n") fibaro:debug(json.encode(response)) -- fibaro:debug("response.data\n") -- fibaro:debug(response.data) end else if (VeluxDebug)then fibaro:debug("LOGOUT Failed : Status =" .. response.status) end end end, error = function(err) print ("Erreur de LOGOUT") print('error = ' .. err) end, options = { method = 'POST', headers = { ["content-type"] = 'application/json, charset=utf-8', ["Authorization"] = "Bearer "..token, ["Connection"] = 'close', }, data = datasLogout } }) else if (VeluxDebug)then fibaro:debug("RUN ACTION Failed : Status =" .. response.status) end end end, error = function(err) print("Erreur lors du RUN ACTION") print('error =' ..err) end, options = { method = 'POST', headers = { ["content-type"] = 'application/json, charset=utf-8', ["content-length"] = "34", ["Authorization"] = "Bearer "..token, ["Connection"] = 'Keep-Alive', }, data = datasAction } }) else if (VeluxDebug)then fibaro:debug("Login Failed : Status =" .. response.status) end end end, error = function(err) print ("Erreur lors du LOGIN") print('error = ' .. err) end, options = { method = 'POST', headers = { ["content-type"] = 'application/json, charset=utf-8', ["connection"] = 'close', }, data = datasLogin } }) Le VD Je ne vais pas décrire le VD ici car il est vraiment simpliste, il contient simplement autant de boutons que d’actions que je désire effectuer et chaque bouton contient uniquement un appel à la scène en passant les bons paramètres. Si quelqu’un le souhaite je peux toujours lui envoyer en MP. Edit : comme demandé, voici le VD que j'utilise pour l'instant... il est franchement basique et sera certainement retravaillé par la suite suivant mes besoins Velux.vfib Modifié le 6 octobre 2018 par Cardane 7 1
pepite Posté(e) le 11 décembre 2017 Signaler Posté(e) le 11 décembre 2017 Bonsoir, Super tuto, merci pour le partage. ;-) Pourrais tu mettre le VD en pièce jointe à ton tuto stp ? MErciii beau boulot
Cardane Posté(e) le 11 décembre 2017 Auteur Signaler Posté(e) le 11 décembre 2017 Salut @pepite, merci, c'est un premier tuto, il y a certainement moyen de faire mieux mais bon, j 'ai fait pour un mieux dans les quelques heures de libre ce weekend euhhh, le VD il est franchement vide, mais si tu veux je le rajoute dans le post précédent
Krikroff Posté(e) le 11 décembre 2017 Signaler Posté(e) le 11 décembre 2017 Merci pour le tuto, bravo Envoyé de mon iPhone en utilisant Tapatalk
Cardane Posté(e) le 14 décembre 2017 Auteur Signaler Posté(e) le 14 décembre 2017 j'avais juste oublié un point... la sécurité par défaut le KLF-200 démarre en créant un point d'accès WIFI, qui reste disponible pendant 10 minutes par défaut. il est donc plus que conseillé de très vite rentrer dans les paramètres de configuration afin 1. de modifier le momt de passe par défaut 2. d'établir une connexion filaire 3. de supprimer cet access point Sinon votre voisin va très vite pouvoir s'amuser avec vos Velux
KoBa Posté(e) le 10 juillet 2018 Signaler Posté(e) le 10 juillet 2018 (modifié) Merci pour ce tuto Cela peu également etre intéressant API KLF 200 et https://github.com/MiSchroe/klf-200-api Modifié le 10 juillet 2018 par KoBa 2
Cardane Posté(e) le 10 juillet 2018 Auteur Signaler Posté(e) le 10 juillet 2018 oui c'est sur base de ces documents que j'ai réalisé le tuto ci-dessus, après une conversion en lua 1
KoBa Posté(e) le 11 juillet 2018 Signaler Posté(e) le 11 juillet 2018 Merci en encore pour le boulo réalisé
Cardane Posté(e) le 6 octobre 2018 Auteur Signaler Posté(e) le 6 octobre 2018 Hello, Je viens juste de faire une modification du tuto sur le KLF-200 car il y a eu une mise à jour du firmware qu'il ne faut surtout pas faire sous peine de ne plus pouvoir accéder via http. Je l'ai indiqué en début de tuto.
Lazer Posté(e) le 6 octobre 2018 Signaler Posté(e) le 6 octobre 2018 euh..... mais pourquoi tu ne veux pas mettre ce message à la suite de ton tuto, dans le fil de discussion ? Car là il est perdu
ikillou Posté(e) le 6 octobre 2018 Signaler Posté(e) le 6 octobre 2018 Merci pour le Tuto que j'ai mis en place chez moi. Certains points n'étaient pas très clairs pour moi, donc je vais apporter mes petites expériences... Dans l'API, on doit travailler avec le numéro du programme (scène) et non son nom... Donc personnellement je les ai nommés de cette façon afin de tomber rapidement sur le numéro : 00_Descendre Veranda 1 01_Monter Veranda 1 02_Descendre Veranda 2 03_Monter Veranda 2 ... Il ne faut pas être connecté sur l'interface web du KLF-200 en même temps qu'on utilise l'API, on reçoit un "login failed". Je suppose que le KLF ne supporte qu'une connexion simultanée. On ne peut pas lancer 2 programmes en même temps. Si tout va bien, le 2ème se lancera une fois que le premier est fini, mais il m'est arrivé que le 2ème se plante... donc pas très stable sur ce coup-là. Voilà pour l'instant mes petites expériences. Je me réjouis de voir ce que ça donnera avec le nouveau firmware...
Cardane Posté(e) le 6 octobre 2018 Auteur Signaler Posté(e) le 6 octobre 2018 oui, désolé, je me suis trompé, et quand je m'en suis rendu compte il était trop tard ... tu as moyen de le changer de place ? sinon on le supprime et je recommence demain
ikillou Posté(e) le 7 octobre 2018 Signaler Posté(e) le 7 octobre 2018 sinon, j'aimerais tester les entrées filaires... mais je ne sais pas trop quels modules prendre... c'est quoi le mieux ?
Cardane Posté(e) le 7 octobre 2018 Auteur Signaler Posté(e) le 7 octobre 2018 @ikillou tu veux tester les entrées ou les sorties ?Dans tous les cas tu as besoin de contacts secs, donc pas trop le choix... FGS222 en entrée ou Binary Sensor en sortie
Dragoniacs Posté(e) le 21 octobre 2018 Signaler Posté(e) le 21 octobre 2018 Quelle est la portée du signal ? J'ai 2 Vélux dans les combles et 2 autres à l'étage inférieur. Ca peut passer ? Autre question : il "suffit" d'avoir des commandes avec le label "IO" pour garantir la compatibilité du KLF avec mes volets VELUX solaires ?
Cardane Posté(e) le 24 octobre 2018 Auteur Signaler Posté(e) le 24 octobre 2018 euh, oui, le plus rapide c'est de mettre mon pseudo, histoire que je me rende compte que tu attends une réponse :-) la portée n'est pas terrible, pas de 100m c'est certain. Je n'ai jamais fait le test réel, mais si je prends mon cas, le klf se trouve dans le bureau, pas spécialement au centre de la maison, et il trouve l'ensemble des velux du RDC et une partie des velux de l'étage. Donc je suppose que si tu le mets à l'étage, et si tu n'as pas des murs de 80 cm, ca devrait pouvoir le faire. Après, la porté de la commande IO n'est pas décrite dans leur doc, donc je ne peux pas te faire une réponse plus précise. Pour l'autre question, le KLF est une interface IO, donc je suppose que n'importe quel matériel compatible IO devrait être supporté. Le plus simple, fais comme moi... j'ai trouvé un distributeur Velux sympa qui a bien voulu me faire le prêt d'un klf avant achat... Par contre, fais attention, le klf et le VD que j'ai partagé ici ne marche qu'avec l'ancienne version du firmware... voir le post dans le sujet du tuto à ce propos.
Dragoniacs Posté(e) le 24 octobre 2018 Signaler Posté(e) le 24 octobre 2018 Merci pour ta réponse @Cardane J'ai testé en utilisant une télécommande du velux le plus éloigné et ça passe... Donc le Klf 200 me tente bien. J'espère juste qu'il sera livré avec l'ancien software....
Cardane Posté(e) le 25 octobre 2018 Auteur Signaler Posté(e) le 25 octobre 2018 oui parce que si tu as le nouveau, il est impossible de remettre l'ancien, et le développement du VD pour la version 2 va me prendre pas mal de temps, suis pas assez doué en Python pour comprendre comment ca marche :-)
Dragoniacs Posté(e) le 26 octobre 2018 Signaler Posté(e) le 26 octobre 2018 @Cardane a priori pas de modèle dispo en version antérieure, à moins d'aller chercher dans les occasions (et je ne trouve rien). Du coup, je vais attendre un peu, voir si les API sont documentées par ailleurs...
Dragoniacs Posté(e) le 26 octobre 2018 Signaler Posté(e) le 26 octobre 2018 @Cardane J'ai trouvé ça : https://www.velux.com/api/klf200
Messages recommandés