Aller au contenu principal

Intégration domotique SMLIGHT SLZB, gratuite et open source

Intégration SMLIGHT SLZB pour Gladys Assistant

Coordinateurs Zigbee SMLIGHT SLZB en local : état, mises à jour du firmware, redémarrages.

Voir sur GitHubToutes les intégrations externes

Surveillez vos coordinateurs Zigbee SMLIGHT SLZB (SLZB-06, SLZB-06M, SLZB-06p7, SLZB-07, SLZB-MR1, Ultima…) depuis Gladys, en réseau local : leurs températures et leur mémoire, la connexion de Zigbee2MQTT, leur liaison réseau, leur firmware et ses mises à jour, et redémarrez-les, eux ou leur puce Zigbee, quand le réseau Zigbee fait des siennes.

Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été construite et testée sur de vraies réponses de coordinateurs SLZB publiées par la bibliothèque pysmlight et l'intégration Home Assistant, pas sur un coordinateur posé sur un bureau. Si quelque chose ne fonctionne pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Cette intégration n'est pas affiliée à SMLIGHT.

Ce qu'il vous faut​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un coordinateur SLZB avec un firmware v2.3.6 ou plus récent (SLZB-OS), sur le même réseau que Gladys. Les firmwares plus anciens n'ont pas d'API locale à lire : mettez-le d'abord à jour depuis l'interface web du SLZB.
  • Si vous avez protégé l'interface web du SLZB par un identifiant (Settings → Security), cet identifiant et son mot de passe.

L'intégration lit le coordinateur ; elle ne remplace pas Zigbee2MQTT ni ZHA, qui continuent de piloter vos appareils Zigbee à travers lui.

Installation​

  1. Installez SMLIGHT SLZB depuis le catalogue de Gladys (ou Intégrations → Installer depuis GitHub avec https://github.com/guim31/gladys-smlight).
  2. Ouvrez l'onglet Découverte : les coordinateurs du réseau de Gladys sont trouvés automatiquement (mDNS). Il en manque un ? Saisissez son adresse IP dans Configuration (Adresses IP des coordinateurs) (l'interface web du SLZB l'affiche sur sa page Network), par exemple 192.168.1.50 ; plusieurs adresses se séparent par des virgules.
  3. Connexion : remplissez Identifiant et Mot de passe seulement si l'interface web du SLZB en demande un. Le même identifiant sert pour tous les coordinateurs.
  4. Cliquez sur Tester la connexion : le message sous le bouton liste les coordinateurs trouvés et ce qui a échoué.
  5. Dans Découverte, cliquez sur Ajouter à Gladys pour chaque coordinateur, choisissez une pièce, enregistrez.

Options :

  • Intervalle de rafraîchissement : 30 secondes ou 1 minute (par défaut).
  • Vérifier les mises à jour du firmware : activé par défaut. Une fois par jour, l'intégration demande au serveur de mises à jour de SMLIGHT, sur Internet, le dernier firmware de chaque coordinateur, comme le fait l'interface web du SLZB. Désactivez-le pour rester entièrement en local : les fonctionnalités des dernières versions et de la mise à jour ne sont alors pas créées.
  • Langue des noms de fonctionnalités : anglais, français (par défaut), allemand ou espagnol. Les noms sont donnés à l'ajout de l'appareil.

L'appareil de chaque coordinateur​

Chaque coordinateur est un appareil, au nom de son nom d'hôte. Seules les fonctionnalités que le coordinateur propose sont créées.

FonctionnalitéCe que c'est
Température du cœur ESP32Température de la puce ESP32 qui fait tourner le coordinateur, en °C
Température de la puce ZigbeeTempérature de la puce radio Zigbee, en °C (Température de la radio 1, Température de la radio 2 sur les modèles à deux radios)
Mémoire vive utilisée, Système de fichiers utiliséMémoire utilisée par le coordinateur, en kilo-octets (la jauge va jusqu'au total)
Temps de fonctionnementTemps depuis le démarrage du coordinateur, en heures
Client Zigbee connecté depuisTemps depuis que Zigbee2MQTT ou ZHA s'est connecté au coordinateur par le réseau, en heures ; 0 : aucun client connecté
Connexion réseauEthernet, Wi-Fi ou LTE
Mode du coordinateurComment la radio Zigbee est proposée : Ethernet, Wi-Fi ou USB
Firmware du cœur, Firmware ZigbeeVersions installées (Firmware de la radio 1, Firmware de la radio 2 sur les modèles à plusieurs radios)
Dernier firmware du cœur, Dernier firmware ZigbeeDernières versions sur le serveur de mises à jour de SMLIGHT, sur le canal de firmware choisi dans l'interface web du SLZB (Dernier firmware de la radio 1, Dernier firmware de la radio 2 sur les modèles à plusieurs radios)
Mise à jour du firmware disponibleActif quand un firmware du cœur ou Zigbee plus récent existe
Internet joignableSi le coordinateur atteint Internet (demandé toutes les 15 minutes)
LED éteintes, Mode nuit des LEDInterrupteurs : éteindre les LED du coordinateur, ou les atténuer la nuit, quand le firmware le propose
Redémarrer le coordinateurBouton « Appuyer » : redémarre tout le coordinateur (environ 20 secondes sans Zigbee)
Redémarrer la puce ZigbeeBouton « Appuyer » : redémarre seulement la radio Zigbee (Redémarrer la radio 1, Redémarrer la radio 2 sur l'Ultima et les modèles U)

Les valeurs sont lues toutes les 30 ou 60 secondes, et seules celles qui ont changé sont envoyées à Gladys. L'intégration ne flashe jamais de firmware et ne change jamais le mode du coordinateur : une erreur laisserait votre réseau Zigbee sans son coordinateur. Utilisez l'interface web du SLZB pour cela.

Widget du tableau de bord​

Ajoutez le widget Coordinateur SLZB à un tableau de bord (Éditer, puis Ajouter dans une colonne). Choisissez le coordinateur dans ses réglages ; vide, il affiche le premier. Il montre :

  • les températures de l'ESP32 et de la puce Zigbee (en direct) et le temps de fonctionnement ;
  • l'état du coordinateur (en ligne, injoignable, connexion refusée), si un client Zigbee est connecté, la liaison réseau et le mode ;
  • le firmware installé, avec la nouvelle version à côté quand il y en a une ;
  • si le coordinateur atteint Internet ;
  • les boutons Redém. Zigbee (Redém. radio 1, Redém. radio 2 sur les modèles qui redémarrent chaque radio) et Redémarrer, qui demandent chacun une confirmation.

Scènes​

Déclencheurs​

  • Mise à jour du firmware SLZB disponible : un nouveau firmware du cœur ou Zigbee est sorti pour un coordinateur. Une fois par version, même après un redémarrage. Filtres : le coordinateur, le firmware (Cœur (ESP32) ou Puce Zigbee). Variables : le nom du coordinateur, le firmware (core, zigbee), la version installée et la nouvelle version.
  • Coordinateur SLZB injoignable : un coordinateur ne répond plus, deux lectures de suite (la seconde 15 secondes après la première). Variable : ce qui s'est passé.
  • Coordinateur SLZB de retour : il répond de nouveau. Variable : les minutes sans réponse.
  • Coordinateur SLZB redémarré : son temps de fonctionnement est revenu à zéro (coupure, plantage, mise à jour, commande de redémarrage), même quand le redémarrage a été trop rapide pour passer pour une panne. Filtre et variable : l'origine, gladys quand Gladys a demandé le redémarrage dans les 3 minutes précédentes, other sinon. Variable : le temps de fonctionnement avant le redémarrage, en heures.

Idées de scènes​

  • Coordinateur SLZB injoignable → envoyer un message « Le coordinateur Zigbee ne répond plus : les appareils Zigbee sont hors ligne », et allumer une lumière du couloir qui n'est pas en Zigbee.
  • Coordinateur SLZB redémarré avec l'origine Hors de Gladys → envoyer un message avec le temps de fonctionnement précédent : un coordinateur qui redémarre tout seul a souvent un problème d'alimentation.
  • Mise à jour du firmware SLZB disponible → envoyer un message « Le firmware {{triggerEvent.data.latest_version}} est sorti pour {{triggerEvent.data.coordinator}} », et le mettre à jour depuis l'interface web du SLZB quand cela vous arrange.

Dépannage​

  • Aucun coordinateur dans Découverte : le mDNS ne traverse peut-être pas votre réseau (VLAN, Docker sans réseau hôte pour Gladys…). Saisissez l'adresse IP du coordinateur dans la configuration, puis cliquez sur Tester la connexion.
  • Connexion refusée : l'interface web du SLZB est protégée ; saisissez son identifiant et son mot de passe dans la configuration.
  • « pas un SLZB, ou firmware antérieur à la v2.3.6 » : mettez le firmware à jour depuis l'interface web du SLZB (ou le flasheur web de SMLIGHT), ou vérifiez l'adresse.
  • Internet joignable reste vide : l'état vient du flux d'événements du coordinateur (port 81 depuis le firmware v2.6.8) ; sans lui, l'intégration n'envoie aucun état Internet plutôt qu'un état faux.
  • Le dernier firmware reste vide : le modèle du coordinateur n'est pas dans le catalogue de SMLIGHT, ou Gladys n'atteint pas updates.smlight.tech ; l'intégration réessaie toutes les heures.
  • Journaux détaillés : mettez LOG_LEVEL=debug dans l'environnement du conteneur.

Limites​

  • Pas de mise à jour du firmware, pas de changement de mode, pas de réglage Wi-Fi ou réseau depuis Gladys, volontairement.
  • Le proxy Bluetooth, l'infrarouge, le buzzer et l'éclairage d'ambiance de l'Ultima ne sont pas pris en charge.
  • Les firmwares antérieurs à la v2.3.6 ne sont pas pris en charge.
  • Requêtes : deux petites requêtes HTTP par coordinateur toutes les 30 ou 60 secondes, une demande d'état Internet toutes les 15 minutes, et, avec l'option, une requête par firmware (cœur et chaque radio) et par jour vers le serveur de mises à jour de SMLIGHT. Rien d'autre ne sort de votre réseau.
  • L'identifiant est le même pour tous les coordinateurs.
  • Les noms des fonctionnalités sont choisis à l'ajout de l'appareil ; un coordinateur dont les radios changent (Thread au lieu de Zigbee, une nouvelle puce) propose une Mise à jour dans l'onglet Découverte.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Trouver vos coordinateurssectionNonLes coordinateurs SLZB du même réseau que Gladys sont trouvés automatiquement (mDNS) : ouvrez l'onglet Découverte. S'il en manque un, saisissez son adresse IP ci-dessous (affichée dans l'interface web du SLZB, page Network).
Adresses IP des coordinateursstringNonFacultatif, séparées par des virgules. Seulement pour les coordinateurs que la découverte automatique ne trouve pas.
Connexion à l'interface websectionNonSeulement si vous avez protégé l'interface web du SLZB par un identifiant (page Settings, Security). Le même identifiant sert pour tous les coordinateurs.
IdentifiantstringNon
Mot de passesecretNon
OptionssectionNon
Intervalle de rafraîchissementselectNonFréquence de lecture des coordinateurs. Chaque lecture fait deux petites requêtes.
Vérifier les mises à jour du firmwarebooleanNonUne fois par jour, sur le serveur de mises à jour de SMLIGHT (Internet), comme l'interface web du SLZB. Rien n'est jamais installé depuis Gladys.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités des nouveaux appareils (Temps de fonctionnement, Firmware du cœur…), et textes des variables de scène.

Comment installer SMLIGHT SLZB dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : SMLIGHT SLZB 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/guim31/gladys-smlight: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/guim31/gladys-smlight.

SMLIGHT SLZB 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​

SMLIGHT SLZB 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 guim31, 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