Intégration de ZigBee MQTT sur Home Assistant : Guide complet avec SMLIGHT SLZB-06(M)
Bonjour aujourd’hui je viens vous faire une présentation et par la même occasion un tutoriel sur le coordinateur SMLIGHT SLZB-06 que j’ai reçu en test. C’est une première pour moi d’utiliser MQTT sur une solution domotique dont plusieurs de mes confrères vente les avantages qui n’est pas moins négligeables.
L’intégration du ZigBee avec Home Assistant est un sujet d’intérêt croissant pour les passionnés de domotique. Le protocole ZigBee est une norme de communication sans fil utilisée pour connecter des appareils intelligents, tandis que MQTT (Message Queuing Telemetry Transport) est un protocole de messagerie léger idéal pour les environnements IoT (Internet des Objets).
Je tiens à remercier mon partenaires Domadoo pour sa confiance ce qui me permet de découvrir ses produits et surtout de vous les présenter.
1° Qu’est-ce que ZigBee MQTT et pourquoi l’utiliser avec Home Assistant ?
ZigBee MQTT est un pont entre les appareils ZigBee et les réseaux MQTT, permettant une communication transparente avec Home Assistant en autres. En utilisant ZigBee MQTT, vous pouvez gérer un large éventail d’appareils ZigBee directement depuis Home Assistant, améliorer l’interopérabilité et profiter d’une gestion centralisée.
Ce guide vous montrera comment intégrer ZigBee MQTT sur Home Assistant.
2° Caractéristiques techniques :
L’adaptateur ZigBee SMLIGHT SLZB-06 que l’on va utiliser pour cette présentation est un dispositif avancé destiné à améliorer la connectivité et la gestion des réseaux domotiques ZigBee. Il est particulièrement apprécié pour sa polyvalence, sa fiabilité et ses performances robustes, ce qui en fait un choix idéal pour les utilisateurs de systèmes domotiques complexes.
Voici quelques caractéristiques techniques :
- Marque : SMLIGHT.
- Modèle : SLZB06 ou SLZB06M.
- Processeur Arm Cortex-M4F 48 MHz ou EFR32MG21 Silicon Labs :
- 352 Ko de mémoire flash.
- ROM de 258 Ko.
- 8 Ko de cache SPAM
- Puce de contrôle principale : ESP32 Espressif :
- Processeur double cœur.
- 520 Ko de SRAM.
- 448 Ko de ROM.
- Spécification :
- Convertisseur USB/UART : CP2102.
- Réseau Ethernet : LAN8720.
- Gain de sortie : +20dB.
- Gain d’antenne supplémentaire : +5dB.
- Prise en charge Ethernet : Oui.
- Prise en charge Wi-Fi : Oui.
- Prise en charge PoE : Oui.
- Norme PoE : IFFF802.3af (15Watts).
- Contrôle USB Type-C : Oui.
- Démarrage automatique EPS32 : Oui.
- Pré-flashé : Oui.
- Mode coordinateur ZigBee 3.0 : Oui.
- Mode routeur ZigBee 3.0 : Oui.
- ZigBee vers Ethernet : Oui.
- ZigBee vers USB : Oui.
- 3 modes possibles :
- Mode ZigBee vers Ethernet.
- Mode Wi-Fi.
- Mode USB.
- Dimensions :
- Sans antenne : 22.00 mm x 25.00 mm x 161.00 mm.
- Avec antenne : 22.00 mm x 175.00 mm x 192.00 mm.
- Poids : 66 Grammes.
3° Différences principales entre le SMLIGHT SLZB-06 et le SLZB-06M :
L’adaptateur ZigBee SMLIGHT SLZB-06M se distingue de son prédécesseur, le SLZB-06, principalement par la puce ZigBee qu’il utilise. Le SLZB-06M est équipé de la puce Silabs EFR32MG21, tandis que le SLZB-06 utilise la puce Texas Instruments CC2652P.
- Puce ZigBee :
- SLZB-06M :Utilise la puce EFR32MG21 de Silabs, qui fonctionne à 80 MHz avec 96 Ko de RAM. Cette puce est particulièrement adaptée pour le support de ZHA (Zigbee Home Automation) et est connue pour une connexion plus stable et un signal plus fort grâce à un amplificateur de +20 dB.
- SLZB-06 :Utilise la puce CC2652P de Texas Instruments, fonctionnant à 48 MHz avec 88 Ko de RAM. Cette puce est largement utilisée et éprouvée pour sa fiabilité, supportant pleinement Zigbee2MQTT et ZHA.
- Support de Multiprotocole :
- SLZB-06M :Offre la possibilité de support multiprotocole, permettant de fonctionner simultanément avec Zigbee et d’autres protocoles comme Thread. Cependant, ce support est encore en phase expérimentale pour Zigbee2MQTT.
- SLZB-06 :Ne propose pas de support multiprotocole, mais est extrêmement stable et fiable pour une utilisation avec Zigbee2MQTT.
- Performance et Fiabilité :
- SLZB-06M :Bien que la puce EFR32MG21 soit plus récente et offre des avantages en termes de stabilité et de qualité de signal, elle est encore en phase de test pour certaines utilisations spécifiques.
- SLZB-06 :La puce CC2652P est bien établie et largement adoptée, offrant une fiabilité éprouvée avec de nombreuses options de firmware stables disponibles.
- Compatibilité :
- SLZB-06M :Idéale pour les utilisateurs de ZHA, en raison de la puce native supportée par Home Assistant.
- SLZB-06 :Recommandée pour ceux qui utilisent Zigbee2MQTT, grâce à son support complet et testé.
En résumé, le choix entre le SLZB-06 et le SLZB-06M dépend principalement de vos besoins spécifiques en termes de protocole et de stabilité. Si vous cherchez une solution éprouvée et stable pour Zigbee2MQTT, le SLZB-06 est une excellente option. Si vous utilisez principalement ZHA ou souhaitez expérimenter avec des fonctions multi protocole, le SLZB-06M pourrait être plus adapté.
4° Déballage et présentation :
Comme on a pu le voir dans les caractéristiques précédentes, les adaptateurs ZigBee SMLIGHT SLZB-06 ou le SLZB-06M sont des dispositifs avancés destinés à améliorer la connectivité et la gestion des réseaux domotiques ZigBee. L’un ou l’autre est tout particulièrement apprécié pour sa polyvalence, sa fiabilité et ses performances robustes, ce qui en fait un choix idéal pour les utilisateurs de systèmes domotiques complexes.
En ce qui concerne son emballage, il est dans un carton assez sympathique au niveau des couleurs d’un avec un dégradé du bleu vert le parme pour la version et d’un gris vers l’orangé pour celui compatible avec Matter. La seule différence notable entre les deux produits hormis sa couleur c’est le « M » à la fin du modèle.
Sur le devant on peut apercevoir la compatibilité avec :
- Home Assistant.
- ZigBee2MQTT.
- L’alimentation via le POE du câble RJ45.
- Le ZigBee natif via ZHA.
- Une connexion via Ethernet.
- Le mode USB pour l’alimentation ou le pilotage.
Sur la partie arrière de la boite on va retrouver principalement :
- Quelques spécifications techniques.
- Le contenu de la boite.
- Le lieu de fabrication (en Chine).
- Le lieu de conception (en Ukraine).
- Le site de la marque ainsi que le support en cas de soucis.
Sur le dessus ou le dessous de la boite on va retrouver une fois de plus son utilisation ainsi que les différentes connectivités. On peut le voir également que le port RJ45 est compatible avec l’alimentation en POE.
Dans le contenu de la boite on retrouve :
- Le module SMLIGHT SLZB-06 ou le SLZB-06M.
- Une antenne 5 dB.
- Une clé Allen.
- Deux autocollants pour l’installation du module.
- Un adaptateur USB Type-C vers Micro USB.
- Deux vis de montage du module.
- Une règle en papier pour l’installation des vis (non visible sur la photo).
Faisons le tour de cet adaptateur :
Il est fait dans un plastique d’une qualité on va dire tout à fait honorable bien que j’entende certaines personnes dire qu’il fait bas de gamme mais faut l’avouer mais ce qui prime se trouve à l’intérieur de ce boitier. Lorsque l’on appui sur le plastique, il est assez résistant quand même. J’ai déjà eu en test des objets avec des plastiques vraiment très cheap (dont je n’ai jamais publié de tests).
Sur le dessus du boitier, on va retrouver un bouton (indiqué via la flèche rouge) permettant d’effectuer un « Reset » de l’appareil.
En ajoutant des coordinateurs LAN supplémentaires via son port RJ45, la couverture et la capacité de votre réseau ZigBee peuvent être augmentées proportionnellement, réduisant les risques liés à des pannes de routeurs ZigBee.
A son opposé on va retrouver cette fois la partie où l’on venir visser l’antenne pour augmenter la portée du réseau ZigBee. Le gain annoncé est d’environ 5 dB mais je n’ai aucun moyen hormis une fois les appareils connectés de regarder dans la colonne LQI qui n’est autre que la qualité de réception.
Voici ce que cela donne avec son antenne mise en place. On peut voir que les dimensions sont assez imposantes mais il est tout à fait possible d’orienter cette dernière en fonction de votre utilisation et surtout de votre configuration.
Si toutefois vous n’avez pas de câble d’alimentation en USB Type-C, SMILIGHT à tout prévu car un adaptateur USB Type-C vers Micro USB est fourni dans le contenu. Cette prise sert aussi bien pour son alimentation que pour brancher ce module en USB si l’on ne souhaite pas passer par un câble RJ45.
Sur le dessous du boitier, on va retrouver :
- Une étiquette avec quelques indications de connectivité.
- L’emplacement pour les deux autocollants.
- L’emplacement pour une utilisation avec les vis.
Je vous en parlais, les deux SMILIGHT son identique. La seule chose qui va les différencier ce sont les étiquettes en dessous de chaque module.
5° Intégration de ZigBee MQTT sous Home Assistant :
La procédure d’intégration n’est pas difficile en soi mais requiert de bien suivre toutes les procédures que je vais vous décrire dans ce tutoriel. Je vous préviens tout de suite la procédure et assez longue mais j’ai fait un détail pas à pas pour que vous puissiez vous y retrouver.
Cette procédure a été testé chez moi sur HAOS mis sur un Raspberry Pi 5 ainsi que Home Assistant Green.
Dans la première étape de cette intégration on va commencer par installer un module complémentaire qui se nomme « Broker MQTT ».
Allez dans « Paramètres ».
Ensuite dans « Modules complémentaires ».
Puis dans « Boutique des modules complémentaires ».
Et enfin cliquez sur « Mosquito Broker ».
Cliquez cette fois sur « Installer ».
À cette étape il sera possible d’activer ou non :
- Le lancement au démarrage.
- Le chien de garde.
- La mise à jour en automatique.
Pour le moment ne cliquez pas sur démarrer faites juste un retour en arrière via la flèche situé à la droite du nom Home Assistant indiquée par la flèche verte.
Maintenant on va créer un nouvel utilisateur pour que cela fonctionne correctement. Cliquer sur « Personnes ».
Cliquez sur « + Ajouter une personne ».
Donnez-lui un nom assez simple comme « MQTT ». Il va falloir activer l’autorisation à la personne de se connecter. En l’occurrence ici cela sera du virtuel.
Indiquez un mot de passe et veuillez le reconfirmer dans la case ci-dessous. Retenez bien votre mot de passe parce qu’il va nous être utile juste après Actuellement la case « Créer » et grisé mais une fois que vous aurez rentrez vos mots de passe il sera possible alors de cliquer dessus. Votre nouvel utilisateur est maintenant configuré.
Revenez cette fois dans le module complémentaire pour lancer le démarrage de « Mosquito broker ».
Allez dans l’onglet journal situé en haut à droite et vérifiez bien que le service et bien démarré. Deux lignes « Successfully » apparaîtront alors.
Faites un retour en arrière et cliquez maintenant sur « Appareils et services ».
Comme on peut le voir dans les appareils découverts, la tuile MQTT est apparue. Il suffit alors de cliquer sur « Configurer » (je sais la flèche et mal indiqué et peut prêter à confusion).
Une nouvelle fenêtre s’ouvre nous indiquons qu’il va installer le courtier MQTT via le module complémentaire. Cliquez maintenant sur « Valider ».
Indiquez les différentes options de courtier :
- L’adresse du courtier qui sera 127.0.0.1
- Le numéro du port 1883
- Le nom d’utilisateur que l’on a renseigné précédemment en l’occurrence ici « MQTT ».
- Le mot de passe que vous avez précédemment créé.
Une fois les différents paramètres rentrés, une nouvelle fenêtre apparaît nous indiquant un succès pour le paramétrage de MQTT.
Avant toute chose il va falloir maintenant allez chercher un dépôt qui se trouve directement sur le Github de ZigBee2MQTT. Voici le lien :
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Il faudra soit copier la ligne ci-dessous ou bien cliquer sur le bandeau bleu marqué « ADD ADD-ON REPOSITORY TO ». Ce dernier aura pour but un ouvrir la page adéquate pour déposer un dépôt. Je vous montre cela juste après
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Retournez sur la page « Appareils et services » Et en haut à droite se trouve 3 petits points ou il sera possible d’ajouter le dépôt cliquez maintenant dessus.
Faites un coller directement dans la case « Ajouter ».
Trois nouveaux modules font leur apparition Dans la boutique des modules complémentaires. Cliquez maintenant sur « ZigBee2MQTT ».
Cliquez maintenant sur « Installer ».
Avant de démarrer ZigBee2MQTT, il va falloir aller configurer ce dernier pour cela qui est dans l’onglet « Configurer » et indiquez :
- Dans la ligne « mqtt » :
base_topic : zigbee2mqtt
- Dans la ligne « serial » :
port : tcp://slzb-06.local:6638
baudrate : 115200
adapter : zstack
N’oubliez pas d’enregistrer la configuration. Attention toutefois la configuration n’est compatible qu’avec SMILIGHT. Vous pouvez dès à présent lancer le démarrage du module.
Si vous activez l’affichage dans la barre latérale vous pouvez voir « ZigBee2MQTT » apparaître sur votre gauche. Cette fonctionnalité est vraiment très intéressante car elle permet d’accéder à ce module très rapidement et ainsi intégrer plus rapidement vos périphériques.
Dans l’onglet « Journal » On peut voir que tous les logs sont bien en vert ce qui permet de voir que la configuration est correcte. Si toutefois il y avait une erreur dans la configuration vous verrez un message d’erreur à paraître en rouge.
6° Intégration d’un périphérique :
Le fait d’avoir ajouté « ZigBee2MQTT » cela nous donne l’avantage d’avoir un accès direct pour lancer l’appairage de nouveaux périphériques.
Cliquez sur « Activer l’appairage (Tout) qui sera actif pendant 4 min15 ce qui permet d’en ajouter plusieurs d’affilé.
Attention toutefois le nom sera à changer au fur et à mesure sans quoi il sera difficile de s’y retrouver même si l’on a la photo du périphérique.
En l’espace de quelques secondes on va pouvoir le voir arriver sur le côté droit point mais malheureusement je n’ai pas eu le temps de prendre les fenêtres qui s’ouvrent en bleu.
Une fois intégré comme on peut le voir ci-dessous le nom aura la même identification que l’adresse IEEE.
Pour le changer il suffira de cliquer sur le nom comme l’indique la flèche rouge.
Pour changer le nom du périphérique, il suffit de cliquer sur le petit crayon. Il sera tout à fait possible de rajouter une description qui sera uniquement visible dans cette section.
Après plusieurs intégrations à différents endroits de mon logement, il sera beaucoup plus facile de visualiser les différents éléments intégrés via un schéma. Une sorte de toile d’araignée montrant le chemin du protocole ZigBee entre les appareils sur secteur, à piles ou encore le coordinateur.
7° Portail administrateur :
Dans cette partie, comme son nom l’indique, il sera possible d’accéder directement sur le portail administrateur de l’appareil. Pour se faire il suffit de se rendre à cette adresse : http://slzb-06.local ou directement via son adresse IP.
Comme on peut le voir sur les différents Screenshot que j’ai pris, on pourra se rendre compte dans la partie « Device information » de retrouver un ESP32 épaulé de la puce CC2652P comme indiqué dans les caractéristiques techniques. Ce portail est vraiment très complet avec différentes informations de connexion.
En ce qui concerne la partie connexion, comme je vous en parlais, il sera tout à fait possible de le piloter de différentes manières comme :
- Le mode ZigBee via Ethernet en POE ou non.
- Le mode ZigBee via le Wi-Fi.
- Le mode ZigBee via le port USB Type-C.
Dans la partie configuration du réseau, par défaut il est automatiquement activé le statut de DHCP (Gestion automatique de l’adressage de l’IP) mais il sera tout à fait possible de le désactiver et de lui indiquer vos propres paramètres.
Personnellement j’ai toujours pris l’habitude sur chacun de mes appareils connectés au Wi-Fi de leur attribuer une adresse IP fixe ainsi que de modifier le nom dans mon routeur pour une meilleure lisibilité.
Comme on peut s’en apercevoir et comme je vous en ai déjà parlé précédemment, le contrôleur prend en charge ZigBee2MQTT mais également ZHA en natif ce qui est vraiment un plus. Il faut tester mais par moment, un appareil ne fonctionnant pas sous ZigBee2MQTT peut fonctionner et avoir plus de fonctionnalités que sur ZHA (de vous à moi c’est très rare mais ca arrive).
Dans la partie « Settings and Tools », on va pourvoir venir faire une recharge des mises à jour. Bien évidemment sur ce genre de produit la mise à jour est quasiment obligatoire voir indispensable pour les corrections de bugs. Cette mise à jour ne dure que quelques instants. J’en ai profité par la même occasion de passer le tout en Français.
8° Conclusion :
L’adaptateur ZigBee SMLIGHT SLZB-06 est une solution complète et efficace pour la gestion des réseaux domotiques ZigBee. Sa conception, ses performances, et sa compatibilité en font un choix de premier plan pour les utilisateurs cherchant à optimiser leur réseau domestique intelligent.
En résumé, le choix entre le SLZB-06 et le SLZB-06M dépend principalement de vos besoins spécifiques en termes de protocole et de stabilité. Si vous cherchez une solution éprouvée et stable pour Zigbee2MQTT, le SLZB-06 est une excellente option. Si vous utilisez principalement ZHA ou souhaitez expérimenter avec des fonctions multi protocole, le SLZB-06M pourrait être plus adapté.
Dans un prochain article, je vais vous présenter un nouveau produit qui pourra être intégré à ce protocole ZigBee et permettra d’avoir un retour de votre consommation électrique.
Pour avoir actuellement plus de 80 appareil relié à ce concentrateur, je n’ai jamais rencontré de soucis particuliers donc je ne peux que recommander ce produit.
Commentaires récents