Aller au contenu principal

Intégration Enki pour Gladys Assistant

Intégration Enki pour Gladys Assistant

Pilotez vos éclairages et ventilateurs Enki (Leroy Merlin) depuis Gladys, via le cloud Enki.

Voir sur GitHubToutes les intégrations externes

Présentation​

Cette intégration connecte Gladys Assistant au cloud Enki (l'écosystème domotique commercialisé par Leroy Merlin / Adeo) pour piloter vos appareils Enki — éclairages, ventilateurs de plafond, prises, volets roulants et capteurs — depuis Gladys, avec le même compte que l'application mobile Enki.

Une fois configurée, chaque appareil compatible de votre compte Enki apparaît dans l'écran Découverte de Gladys. Selon l'appareil, il expose ces fonctionnalités :

  • Éclairage — allumer / éteindre l'ampoule (ou le kit lumineux du ventilateur) ;
  • Luminosité — faire varier l'intensité de 0 à 100 %, si l'ampoule est variable ;
  • Température de couleur — du blanc chaud au blanc froid, si l'ampoule le permet ;
  • Couleur — couleur RVB, si l'ampoule le permet ;
  • Vitesse du ventilateur — de 0 (éteint) à 100 % (niveaux Enki 1 à 6) ;
  • Sens de rotation — sens avant / arrière des pales, si l'appareil le gère ;
  • Prise — marche/arrêt pour les prises et modules connectés ;
  • Volet roulant — position de 0 (fermé) à 100 % (ouvert), plus l'arrêt ;
  • Capteurs — température, humidité, luminosité, mouvement, ouverture, fuite d'eau et batterie faible, quand l'appareil les remonte ;
  • Chauffage — température de consigne (radiateurs/thermostats) et mode fil pilote (confort / éco / hors-gel / arrêt), plus la température actuelle.

La détection est basée sur les capacités : la plupart des modèles Enki / Leroy Merlin fonctionnent directement (environ 150 des ~210 modèles du catalogue). Un ventilateur doté d'un kit lumineux affiche à la fois la ventilation et l'éclairage sur le même appareil, et un multicapteur affiche chaque mesure qu'il fournit. Les états sont rafraîchis toutes les 15 secondes : les changements faits depuis l'application Enki ou une télécommande apparaissent donc rapidement dans Gladys.

Les sirènes, les caméras et le comptage d'énergie ne sont pas encore gérés.

Prérequis​

  • Un compte Enki avec vos appareils déjà appairés et visibles dans l'application mobile Enki. Cette intégration ne remplace pas l'appairage Enki : configurez d'abord les appareils dans l'application Enki.
  • Un accès Internet depuis votre instance Gladys : l'intégration communique avec le cloud Enki, pas directement avec les appareils.
  • Seuls les éclairages et ventilateurs de plafond Enki / Leroy Merlin sont gérés. Les appareils Zigbee tiers appairés sur le hub Enki sont hors du périmètre (utilisez Zigbee2MQTT / ZHA).

Configuration​

  1. Installez l'intégration depuis le store Gladys.
  2. Ouvrez son écran de Configuration et renseignez :
    • E-mail Enki — l'adresse e-mail de votre compte Enki ;
    • Mot de passe Enki — le mot de passe de ce compte (stocké comme secret, jamais réaffiché).
  3. Enregistrez. L'intégration se connecte à Enki et charge vos appareils.
  4. Ouvrez l'écran Découverte : vos éclairages et ventilateurs y sont listés. Ajoutez ceux que vous voulez, puis placez-les dans vos pièces et tableaux de bord comme n'importe quel appareil Gladys.

Pour utiliser un autre compte Enki par la suite, mettez simplement à jour l'e-mail et le mot de passe dans l'écran de Configuration : l'intégration se reconnecte et rafraîchit la liste des appareils automatiquement.

Dépannage​

  • « Enki is not configured » pendant la découverte — l'e-mail ou le mot de passe est manquant : renseignez les deux champs dans la Configuration et enregistrez.
  • La connexion échoue — vérifiez vos identifiants en vous connectant avec l'application mobile Enki.
  • Un appareil manque dans la Découverte — assurez-vous qu'il s'agit d'un éclairage ou d'un ventilateur de plafond Leroy Merlin / Enki et qu'il est visible dans l'application Enki avec le même compte, puis relancez la découverte.
  • Les commandes semblent ignorées — le cloud Enki peut mettre quelques secondes à transmettre une commande à l'appareil ; l'état dans Gladys reflète l'état du cloud et se met à jour au prochain relevé (toutes les 15 secondes).
  • Les états ne se mettent plus à jour — la session Enki a peut-être expiré ; l'intégration renouvelle son jeton automatiquement. Si le problème persiste, consultez les journaux de l'intégration depuis sa page de configuration dans Gladys.

Crédits​

L'API cloud Enki est non officielle et a été documentée par les intégrations communautaires Home Assistant (cyrilcolinet, clamoriniere). Cette intégration n'est pas affiliée à Leroy Merlin, Adeo ou Enki.

Paramètres de configuration​

Voici les paramètres demandés par Enki dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
E-mail EnkistringOuiL'adresse e-mail de votre compte Enki (celle utilisée dans l'application mobile Enki).
Mot de passe EnkisecretOuiLe mot de passe de votre compte Enki.

Comment installer Enki dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Enki apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/callemand/gladys-enki:1.0.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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/callemand/gladys-enki.

Enki nécessite Gladys >=4.62.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​

Enki 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 callemand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le