Sommaire
Introduction
Dans l’univers de la domotique, le protocole Zigbee est aujourd’hui l’un des plus utilisés pour connecter des capteurs, interrupteurs, prises ou ampoules connectées.
Nous avons déjà vu comment installer Home Assistant sur proxmox avec ZHA dans cet article : https://colinfo.fr/installation-de-home-assistant-avec-zigbee-sur-proxmox/
Il faut savoir que pour intégrer des appareils Zigbee dans Home Assistant, deux solutions principales existent :
- ZHA (Zigbee Home Automation) : l’intégration native de Home Assistant
- Zigbee2MQTT (Z2M) : une solution externe basée sur MQTT
Ces deux approches permettent de piloter des capteurs, interrupteurs, ampoules ou prises Zigbee.
Nous verrons dans cet article l’installation de Zigbee2MQTT et ses composants.
ZHA vs Zigbee2MQTT : quelles solutions choisir ?
ZHA est intégré directement dans Home Assistant. Cela signifie qu’aucun service externe n’est nécessaire pour démarrer.
Une liste de ses avantages :
- Une mise en place très rapide
- Une configuration minimale
- Un appairage des appareils simple et intuitif
- Une bonne intégration avec l’interface Home Assistant
ZHA est donc parfaitement adapté aux débutants ou aux installations modestes.
Zigbee2MQTT, souvent abrégé Z2M, est une solution plus complète, mais aussi plus exigeante.
Ses principaux avantages sont :
- Une compatibilité très large avec les appareils Zigbee
- L’exposition de davantage d’entités et de paramètres
- La possibilité de faire des mises à jour OTA (Over-The-Air) des appareils
- Le renommage simple des appareils et de leurs entités
- Des réglages avancés (sensibilité, seuils, modes de fonctionnement, etc.)
- Une indépendance vis-à-vis de Home Assistant grâce à MQTT
Cette approche est idéale pour les utilisateurs qui souhaitent un contrôle fin et une évolutivité maximale.
En contrepartie de sa puissance, Zigbee2MQTT demande :
- L’installation d’un broker MQTT (comme Mosquitto)
- Une configuration un peu plus longue
- Une compréhension minimale du fonctionnement MQTT
Matériel nécessaire
Pour fonctionner, Zigbee2MQTT nécessite une clé Zigbee compatible jouant le rôle de coordinateur.
Le type d’adaptateur logiciel (ember, ezsp, zstack, …) dépend directement du modèle de clé utilisé. Cette information sera importante lors de la configuration
Pour ma part, je possède cette clé : https://www.amazon.fr/EFR32MG21-Coordinator-Universelle-Passerelle-Assistant/dp/B0B6P22YJC/ref=asc_df_B0B6P22YJC?mcid=ee04323f66d033ce829f88fa9d388fd3&tag=googshopfr-21&linkCode=df0&hvadid=701511851417&hvpos=&hvnetw=g&hvrand=7387443611979681864&hvpone=&hvptwo=&hvqmt=&hvdev=c&hvdvcmdl=&hvlocint=&hvlocphy=9056079&hvtargid=pla-1728736472843&psc=1&gad_source=1
Comment fonctionne Zigbee2MQTT ?
Le fonctionnement peut être résumé simplement :
- La clé USB Zigbee agit comme coordinateur du réseau
- Zigbee2MQTT communique directement avec cette clé
- Les données sont publiées dans un broker MQTT
- Home Assistant s’abonne à ces données
- Les appareils apparaissent automatiquement dans Home Assistant
Installation de Zigbee2MQTT
Installation du Broker
Zigbee2MQTT repose sur MQTT, il est donc indispensable d’installer un broker.
Un broker MQTT va recevoir tous les messages publiés et les distribués.
Sur votre interface Home Assistant, aller dans Paramètres puis Modules complémentaires
Ensuite, Boutique des modules complémentaires
Nous allons rechercher « Mosquitto broker »
Qu’il faudra installer !
Vous pouvez activer la fonction « Chien de garde »
Création de l’utilisateur
Nous allons ensuite créer un utilisateur dédié qui va faire la jonction entre le broker et le serveur home assistant. Rendez-vous dans Paramètres > Personnes
Ajouter une personne
Choisir un nom (mosquitto dans mon cas) et cocher « Autoriser la connexion »
Renseigner le mot de passe de votre choix, cocher « Accès local uniquement » si votre serveur est sur votre réseau local, puis « Créer »
Installation du module Zigbee2MQTT
La prochaine étape consiste à installer le module Zigbee2MQTT.
Il va servir de pont entre notre réseau Zigbee (les appareils domotique) et le broker MQTT en convertissant les messages au format MQTT.
De retour dans Paramètres > Modules complémentaires > Boutique des modules complémentaires
Ajouter un dépôt personnalisé
Saisissez ce lien, il s’agit du repo github de Z2M : https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Un nouvel add-on Zigbee2MQTT apparaît
Nous allons l’installer également, mais il ne faut pas le démarrer tous de suite !
Cocher les caches ci-dessous :
Configuration de la clé zigbee
Avant de configurer Zigbee2MQTT, il faut connaître le chemin exact de la clé Zigbee.
Rendez-vous dans Paramètres > Systeme
Puis Matériel
Cliquer sur « Tout le matériel » dans le but de faire un filtre sur le mot clé « USB »
Le chemin d’accès de la clé apparait, copiez-le !
Ensuite, rendez-vous dans le module Zigbee2MQTT
Puis l’onglet « Configuration »
Remplir les informations de configuration :
Copier le chemin récupéré précédemment, « ember » va dépendre du modèle de votre clé
Démarrage des services
Nous allons ensuite démarrer le broker et Zigbee2MQTT.
Rendez-vous dans chaque page des modules et cliquez sur « Démarrer », le service devrait démarrer correctement.
Vous pouvez le confirmer dans l’onglet Journal et analyser les éventuelles erreurs.
Installation du protocole MQTT
Dernière étape, l’installation directe du protocole MQTT sur Home Assistant.
Paramètres > Appareils et services
Ajouter une intégration
Filtrer sur « MQTT »
Utilisation
Dans votre onglet de gauche, vous trouverez une nouvelle page Zigbee2MQTT
Vous trouverez ici toutes les informations sur votre réseau zigbee, vos appareils, les mises à jour OTA (On The Air), et également pour ajouter vos appareils (il faut penser à Autoriser l’appairage en amont).
Problèmes courants et solutions
Il arrive parfois que Zigbee2MQTT reste bloqué sur l’écran d’onboarding et ne termine pas la configuration.
Dans ce cas, vous pouvez consulter ce fil de discussion sur Reddit, qui explique plusieurs méthodes pour sortir de cette boucle :
https://www.reddit.com/r/homeassistant/comments/1lc594o/stuck_zigbee2mqtt_onboarding_loop/
Une autre solution fréquente consiste à mettre à jour le firmware de la clé Zigbee, ce qui permet de corriger des bugs et d’améliorer la compatibilité avec Zigbee2MQTT. Pour cela, vous pouvez utiliser l’outil officiel Sonoff Dongle Flasher disponible ici : https://dongle.sonoff.tech/sonoff-dongle-flasher/
Conclusion
Zigbee2MQTT est une solution extrêmement complète, parfaitement adaptée aux utilisateurs souhaitant maîtriser finement leur réseau Zigbee.
Bien que plus complexe que ZHA, elle offre une compatibilité, une flexibilité et une évolutivité largement supérieures.
ZHA reste un excellent choix pour débuter, mais Zigbee2MQTT devient rapidement incontournable pour les installations plus ambitieuses.
