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
Utilisation de Zigbee2MQTT dans Homebridge/HomeKit
Je vous ai déjà fait un article il y a quelque temps sur l’installation de Homebridge sur un NAS Synology. Nous allons donc passer directement à l’installation du plugin et à son utilisation.
On commence donc par se rendre dans l’onglet « Plugins » et effectuer une recherche sur zigbee2mqtt. On sélectionne le plugin certifié « Homebridge Z2m » de @itavero, et on clique sur l’icône d’installation.

Après installation du plugin, l’écran de réglage nous est proposé. On peut alors renseigner l’adresse du serveur en remplaçant localhost par l’adresse IP du serveur MQTT, ainsi que l’utilisateur et le mot de passe pour accéder au service.

Il y a de nombreux réglages pour ce plugin, mais je ne vais pas rentrer dans le détail. On va donc aller tout en bas de l’écran et valider les réglages. Il faut alors redémarrer Homebridge.
Le plugin étant installé en tant que pont, nous allons ajouter le pont à Maison en cliquant sur l’icône QR code du plugin. On peut alors scanner le code depuis l’application Maison et ajouter le pont.

Puisque nous avons déjà ajouté des accessoires à Zigbee2MQTT, ils vont être proposés dans Maison.
Le comportement de certains accessoires peut-être différent d’une installation « native ». Par exemple, dans le cas de l’interrupteur Aqara H1, on a plus d’actions, car nous avons le triple-clic et l’appui simultané sur les 2 boutons. De ce fait, on se retrouve dans Maison avec plus de boutons qu’auparavant. Il faut donc expérimenter un peu pour déterminer quels actions avive quel bouton.

Le clic simple sur le bouton gauche correspond au « bouton 3 » et le clic simple sur le bouton droit correspond au bouton 5. Nous allons donc affecter comme action sur le bouton 3 l’allumage de la prise Nous A1Z, et sur le bouton droit l’extinction. Une fois que les deux actions ont été enregistrées, on peut vérifier que les deux accessoires discutent bien ensemble, y compris au travers de Zigbee2MQTT.
Nous allons maintenant pouvoir réaliser la même chose avec la box Homey Pro.
Utilisation de Zigbee2MQTT dans Homey Pro
L’utilisation de Zigbee2MQTT passe par l’installation de l’application du même nom. Il s’agit d’une application proposée par la communauté. On va donc la rechercher dans l’App Store Homey pour l’installer sur notre box.

Une fois que c’est installé, on se rend dans l’onglet « Appareils » et on clique sur le « + » pour ajouter un nouvel appareil. On sélectionne Zigbee2MQTT et la première chose à installer c’est le pont.

On le sélectionne, et on rentre les informations, notamment l’adresse du serveur Zigbee2MQTT, ainsi que le nom et le mot de passe.

L’étape suivante consiste à installer les accessoires. On clique donc de nouveau sur le « + », et cette fois-ci, on sélectionne « Appareil ». L’application propose alors tous les accessoires configurés dans Zigbee2MQTT.

Il ne reste plus qu’à sélectionner les accessoires et à valider pour les retrouver dans notre tableau de bord.
Maintenant nous pouvons paramétrer l’interrupteur Aqara H1 pour allumer la prise Nous A1Z comme nous l’avons fait avec Homebridge. On va donc créer deux flow, un par bouton. Sur le bouton de gauche, on sélectionne l’action « Évènement évènement reçu ».

Comme évènement, nous allons préciser qu’il s’agit d’un clic droit. Cet évènement s’appelle « single_left » pour le bouton gauche et « single_right » pour le bouton droit. Et, comme action, on va simplement sélectionner la prise A1Z pour l’activer ou la désactiver.
Utilisation de Zigbee2MQTT dans Home Assistant
Afin de pouvoir utiliser Zigbee2MQTT dans Home Assistant, nous allons rapidement installer une version docker pour la démonstration.
Installation du conteneur
Nous allons tout d’abord créer un dossier home assistant dans le dossier docker, puis, dans ce dossier, nous allons créer un dossier config.

On peut maintenant installe l’image docker dans Container Manager. Depuis l’onglet « Registre », on recherche « homeassistant » et on télécharge l’image correspondant homeassistant/home-assistant et on choisit la dernière version (latest).

Lorsque le téléchargement est terminé, on peut aller dans l’onglet « Image », sélectionner l’image home-assistant et cliquer sur « Exécuter » ce qui va lancer l’assistant de création du conteneur.

Sur le premier écran, on nomme le conteneur « homeassistant », on coche éventuellement la case « Activer le redémarrage automatique » et on clique sur « Suivant ».



Nous avons alors plusieurs choses à renseigner :
- Paramètres des ports :
- On va ajouter le port 8123 avec les mêmes valeurs dans le conteneur et en TCP
- Paramètres de volumes :
- On sélectionne le dossier /docker/homeassistant/config et l’affecte à /config
- Environnement :
- On ajoute la timezone avec la clé TZ et la valeur Europe/Paris (ou celle de votre région)
- Réseau :
- On laisse le réseau en mode host
On peut alors cliquer sur « Suivant ». Le résumé est affiché, on peut cliquer sur « Effectué » pour créer le conteneur et le démarrer, si la case « Exécuter ce conteneur lorsque l’assistant a terminé » est cochée.
Configuration du courrier MQTT dans Home Assistant

On peut alors se rendre sur la page de Home Assistant à l’aide de l’adresse du serveur et du port 8123. Dans le cadre de ce tutoriel, on va juste valider les différentes étapes, puis se rendre dans l’onglet « Paramètres »

On sélectionne « Appareils et services », puis on clique sur le bouton en bas à droite « Ajouter un intégration » et on recherche MQTT. On sélectionne l’intégration MQTT, puis de nouveau MQTT sur la liste suivante.

On saisit l’adresse du courtier (l’adresse du serveur MQTT) ainsi que le nom de l’utilisateur et son mot de passe.

Si tout se passe bien, on a alors la liste des accessoires Zigbee que nous avons déjà ajouté à Zigbee2MQTT qui s’affichent.
Ajout d’une automatisation dans Home Assistant
Nous allons maintenant ajouter notre automatisation avec l’interrupteur sans fil Aqara H1 et la prise connectée Nous A1Z.

Depuis l’onglet « Paramètres », cette fois-ci, on sélectionne « Automatisations et scènes », puis on clique sur le bouton « Créer une automatisation » en bas à droite, et « de nouveau « Créer une nouvelle automatisation » dans le menu affiché.
Ici l’automatisation est simple, on ajoute juste un déclencheur, l’appui sur un des boutons de l’interrupteur, et une action simple, l’allocation ou l’extinction de la prise.

On commence donc par cliquer que « Ajouter un déclencheur », puis « Appareil » et on sélectionne l’interrupteur « Aqara H1 ». Le déclencheur utilisé sera « single_left » action.

Ensuite, on clique sur « Ajouter une action », « Appareil » et, cette fois-ci on sélectionne la prise Nous A1Z et l’action « Activer Nous A1Z ».
On nomme l’automatisation et on l’enregistre, et on repère la même chose pour éteindre la prise en cliquant sur le bouton droit.
Il ne reste plus qu’à tester tout ça.
Les mises à jour Zigbee avec Home Assistant et Z2M
Comme je l’expliquais un peu plus tôt, Zigbee2MQTT permet de gérer les mises à jour OTA des accessoires qui sont compatibles.

Dans le cas de Home Assistant, ces mises à jour sont également disponibles dans l’interface, et vous pourrez ainsi mettre à jour vos accessoires aussi bien depuis Zigbee2MQTT que depuis la page de mise à jour de Home Assistant.
Ceci termine la dernière partie de ce long tutoriel.