Pour comprendre ce qu’est Zigbee2MQTT, je vous présente dans ce tutoriel ce que sont Zigbee, MQTT et Zigbee2MQTT. Je vais vous montrer comment installer cela sur un Synology avec Container Manager (Docker).
Nous allons utiliser Mosquitto en tant que courtier (broker) MQTT. Après avoir installé quelques accessoires Zigbee, nous utiliserons ce système pour piloter indépendamment les mêmes accessoires depuis Homebridge (et Apple Maison), la box Homey Pro et Home Assistant !
Ce tutoriel étant assez long, il est découpé en trois parties :
- Partie 1 : Présentation rapide de Zigbee et MQTT, installation de Mosquitto et de Zigbee2MQTT
- Partie 2 : Ajout d’accessoires Zigbee à Zigbee2MQTT et présentation de l’application
- Partie 3 : Utilisation de Zigbee2MQTT dans Homebridge (Maison), Homey Pro et Home Assistant
La vidéo YouTube reprend les 3 parties.
Newsletter Pomme-Kit
Abonnez-vous à la newsletter pour rester informé des dernières actualités HomeKit et Matter ainsi que des nouvelles vidéos de la chaine
Ajouter des accessoires à Zigbee2MQTT
Maintenant que tout est en place, nous allons pouvoir ajouter nos accessoires.
Pour ce tutoriel, je vais choisir des accessoires de différentes marques :
- Un interrupteur sans fil Aqara H1
- Une prise connectée Nous A1Z
- Un Smart Button Philips
- Un capteur de température et d’humidité Sonoff SNZB-02D
On se connecte à l’application Zigbee2MQTT en utilisant l’adresse du serveur et le port 8080 que nous avons déterminé lors de l’installation. On peut alors activer l’appairage des accessoires en cliquant sur « Activer l’appairage (Tout) » ce qui va nous laisser quelques minutes pour ajouter nos accessoires avant que la fonction ne se désactive.

Pour chaque accessoire nous allons donc le mettre en mode appairage. En général, il suffit de quelques secondes sur le bouton correspondant pour l’activer, mais vous trouverez dans la notice de vos appareils comment l’activer.
L’accessoire devrait apparaitre dans la liste. Il faut attendre un peu pour que toutes les informations remontent.

Dans l’onglet « Appareils » on va avoir la liste des accessoires, avec le nom simplifié, l’adresse IEEE, le nom du constructeur, le modèle, la qualité de la liaison (LQI) et le mode d’alimentation (secteur ou batterie, avec le niveau si disponible).
On installe nos 4 accessoires avant de regarder un peu plus en détail l’interface de Zigbee2MQTT.
Le menu des accessoires

Il y a quelques liens directs sur cette page. Un clic sur le modèle nous envoie sur la page de l’accessoire sur le site Zigbbe2MQTT, avec toutes les informations que nous allons pouvoir utiliser.
On peut également modifier le nom simplifié (friendly name), qui est celui qui apparaîtra lorsque nous récupèrerons l’accessoire dans les clients se connectant à MQTT (dans ce tutoriel, Homebridge/Maison, Homey Pro et Home Assistant).

Le second onglet, « Expose », est très intéressant, car il affiche toutes les informations disponibles et avec lesquelles on va pouvoir interagir. Par exemple, pour la prise connectée, on va avoir son statut, allumée ou éteinte, mais également toute une série d’informations sur l’énergie (voltage, puissance…) et des options telles que le verrouillage enfant ou le comportement en cas de coupure de courant.

Toutes ces informations seront disponibles, et, selon le client qui s’abonnera à ces sujets, vous pourrez les consulter et les modifier si c’est autorisé.
L’Onglet « Paramètres spécifiques » va permettre d’ajuster certains paramètres de l’accessoire. Par exemple la précision des mesures d’énergie dans le cas de la prise connectée, ou de calibrer la température pour le capteur de température et d’humidité.

Je ne vais pas rentrer dans le détail des autres onglets qui sont plus techniques. Je vous invite à consulter le site Zigbee2MQTT si vous souhaitez davantage d’informations.
L’interface de Zigbee2MQTT
Dans cette partie nous allons nous intéresser à quelques onglets en particulier.
Dans le chapitre précédent, on a parlé de l’onglet « Appareils » et on va donc poursuivre avec l’onglet « Tableau de bord ». Celui-ci va nous afficher des cartes avec les accessoires, tout du moins ceux ayant des interactions possibles. Par exemple, pour les 4 accessoires que nous venons d’ajouter, on aura la prise connectée Nous A1Z et le capteur de température Sonoff SNZB-02D.

Il va être possible d’interagir avec certaines caractéristiques, par exemple, allumer ou éteindre la prise, ou encore, activer la sécurité enfant.
L’onglet « Schéma » va nous afficher tout le réseau Zigbee qui a été créé. À l’aide d’un code couleur, on va pouvoir identifier facilement le contrôleur, les routeurs et les appareils terminaux. On a également la qualité du signal qui est indiquée.

On va passer rapidement sur l’onglet « Groupes » qui permet de grouper des accessoires pour les piloter ensemble, comme les ampoules d’une même pièce par exemple, et nous allons sur l’onglet « OTA ».

Cet onglet va vérifier les mises à jour des accessoires, tout du moins pour ceux prenant en compte cette fonction. Dans notre cas, la prise et le bouton Hue sont gérés, et nous avons même droit à une mise à jour pour la prise.

Dans le cas de Home Assistant, cette information est également remontée, et il sera possible de faire les mises à jour soit dans Zigbee2MQTT, soit directement dans Home Assistant.
Le reste des onglets porte sur des fonctions avancées de Zigbee2MQTT, vous pourrez retrouver la documentation complète sur ces fonctions sur le site officiel.
Les accessoires sont ajoutés, tout est en place pour utiliser Zigbee2MQTT dans Homebridge / Maison, Homey Pro et Home Assistant, ce que nous allons voir dans la dernière partie de ce tutoriel.