Intégration domotique Deako, gratuite et open source
Interrupteurs et variateurs connectés Deako sur votre réseau : marche, arrêt, intensité.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Intègre à Gladys les interrupteurs et variateurs connectés Deako par l’API locale du Deako Connect, sans compte ni cloud : marche / arrêt et intensité, et les changements faits au mur ou dans l’application Deako affichés aussitôt.
Jamais testé avec un vrai appareil : dites-nous sur le forum comment ça se passe. Sans lien avec Deako.
Avant de commencer
- Vos interrupteurs sont installés avec l’application Deako et un Deako Connect (ou un interrupteur Deako qui sert de passerelle) est sur votre réseau. Les interrupteurs Deako les plus récents n’ont pas d’API locale : ils ne sont pas joignables ainsi.
- Donnez au Connect une adresse IP fixe dans votre box. Il s’annonce sur le
réseau comme le service
local-integration(_telnet._tcp) ; votre box affiche aussi son adresse.
Configuration
- Adresse du Deako Connect : son adresse IP (ou son nom), avec
:portseulement si ce n’est pas le 23. - Lecture complète toutes les : fréquence de relecture de toute la liste des appareils (60 s par défaut, 30 s au moins). Les changements arrivent aussitôt entre deux (le Connect les envoie).
- Enregistrez, puis ouvrez Découverte : chaque interrupteur et variateur y est listé avec son nom dans l’application Deako. Ajoutez ceux que vous voulez.
Tester la connexion ouvre la connexion si elle est fermée (au plus toutes les 10 s) et vérifie que le Connect répond.
Appareils
| Appareil Deako | Fonctionnalités |
|---|---|
| Interrupteur | Allumage (0 / 1) |
| Variateur | Allumage (0 / 1), intensité (0 à 100, 0 = éteint) |
Envoi des commandes
- Un message à la fois, à 800 ms d’écart (comme Deako le demande). Une commande est faite quand le Connect montre le nouvel état ; sinon son message dit pourquoi (« envoyée, sans confirmation », « refusée par le Connect »…), et les appareils sont relus 5 s plus tard.
- Une scène sur plusieurs lumières les règle toutes : les commandes attendent en file (30 s au plus), celles d’un même appareil fusionnées. Gladys reçoit sa réponse sous 3,5 s : une commande encore en file dit alors « en file » et part quand même.
Extinction (arrêt)
Un arrêt (allumage 0, ou intensité 0) ne demande aucune option et passe en premier : avant les commandes en attente (il annule celles du même appareil), sans l’écart de 800 ms, en coupant une requête restée 1 s sans réponse, même avant la lecture de la configuration (vers l’adresse de la dernière session).
Dans une scène de nombreux arrêts, chacun attend son tour sans l’écart de 800 ms (un à la fois) ; celui encore en file après 4,3 s le dit dans sa réponse et part quand même.
S’il ne peut pas partir (le Connect ne répond pas, ou un autre client tient sa seule connexion), il est gardé (même après un redémarrage) et renvoyé toutes les 10 s (un arrêt envoyé sans réponse : 10 s après cet envoi), aussitôt quand une connexion s’ouvre pour une autre commande s’il n’est jamais parti, et tous d’un coup quand le Connect répond de nouveau. Après des connexions fermées aussitôt ou sans un octet, la suivante automatique (renvoi, reconnexion) attend 1 s, puis 2, 4, 8, jusqu’à 10 s ; un clic (arrêt, commande, Tester la connexion) n’attend pas : sa connexion est essayée aussitôt (une par clic, une par seconde au plus), et un arrêt qui ne peut toujours pas partir est réessayé dans la seconde environ, puis gardé. Accepté par le Connect, il est vérifié par une lecture 5 s plus tard et renvoyé 10 s après son dernier envoi si cette lecture montre encore l’appareil allumé. Il prend fin quand l’appareil se montre éteint, quand l’appareil est rallumé au mur ou dans l’application (jamais défait), quand une commande plus récente de cet appareil part, ou quand l’appareil est supprimé.
Un arrêt n’est refusé que si l’adresse du Connect n’est pas connue (aucune saisie, aucune d’une session précédente), ou remplacé par un clic plus récent sur le même appareil avant de partir. Quand le Connect y a répondu 4 fois (accepté ou refusé, « occupé » non compté) sans que l’appareil se montre éteint, il n’est plus renvoyé de lui-même : le statut le dit ; recliquez sur Arrêt.
Statut
La page Configuration montre la connexion, le nombre d’appareils, ceux à ajouter et chaque arrêt gardé.
En cas de problème
- « injoignable » : vérifiez l’adresse et que le Connect est sur le même réseau que Gladys ; nouveaux essais après 5 ou 15 s, puis 30 s, 1, 2, puis toutes les 5 minutes.
- Rien dans Découverte : vérifiez dans l’application Deako que les interrupteurs appartiennent au profil de ce Connect.
Paramètres de configuration
Voici les paramètres demandés par Deako dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos lumières Deako | section | Non | Intègre à Gladys les interrupteurs et variateurs connectés Deako (installés avec l’application Deako) par l’API locale du Deako Connect, sans compte ni cloud : marche / arrêt et intensité, les changements faits au mur ou dans l’application affichés aussitôt. Un arrêt (allumage 0, intensité 0) ne demande aucune option et passe en premier, même quand le Connect ne répond pas : il est gardé et renvoyé (toutes les 10 s, 4 essais répondus au plus) jusqu’à ce que l’appareil le montre, sauf s’il est rallumé au mur ou dans l’application. Les interrupteurs Deako les plus récents n’ont pas d’API locale : ils ne sont pas joignables ainsi. Jamais testé avec un vrai appareil : dites-nous sur le forum comment ça se passe. Sans lien avec Deako. |
| Adresse du Deako Connect | string | Oui | L’adresse IP (ou le nom) du Deako Connect, ou de l’interrupteur Deako qui sert de passerelle, avec :port seulement si ce n’est pas le 23. Donnez-lui une adresse fixe dans votre box ; il s’annonce sur le réseau comme le service local-integration (_telnet._tcp). |
| Lecture complète toutes les (secondes) | number | Non | Fréquence de relecture de toute la liste des appareils : 60 s par défaut, 30 s au moins. Les changements arrivent aussitôt entre deux. |
| Langue des noms | select | Non | Sert aux noms des appareils et fonctionnalités ajoutés désormais. |
Comment installer Deako dans Gladys
- Dans Gladys, ouvrez Intégrations : Deako 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/lm1lc3n7/gladys-deako:0.1.1), 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/LM1LC3N7/gladys-deako.
Deako nécessite Gladys >=5.1.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
Deako 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 LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation