Salutation, je change de gestionnaire de zigbee, actuellement sur Deconz, je passe sur Zigbee2MQTT et j’en profite pour faire un petit tuto.
C’est parti !
Niveau adaptateur j’ai une clé Sonoff ZBDongle-P.
Attention si vous voulez acheter cette clé, il y a en ce moment un nouveau modèle : ZBDongle-E qui est en Expérimental sur le site de Zigbee2MQTT et qui est, pour le moment, compatible avec moins d’équipement
Dans un premier temps, voici le site officiel pour vérifier les clés et équipements compatibles : https://www.zigbee2mqtt.io/guide/supported-hardware.html
On passe enfin sur HA :
Mosquitto Broker
![](https://les-tutos-du-tof.fr/wp-content/uploads/2022/10/image.png)
Dans Paramètres > Modules complémentaires -> Boutiques des modules complémentaires
On installe Mosquitto Broker, c’est lui qui va récupérer les infos de Zigbee2MQTT et les transmettre à HA.
Pense à le démarrer 😉
Maintenant qu’il est installé tu dois pouvoir le retrouver dans les intégrations : Paramètres-> Appareils et Services
Clics sur Ajouter une intégration et recherche MQTT
Une nouvelle fenêtre demande d’enregistrer, il n’ y a pas de conf à faire.
Zigbee2MQTT
Pour avoir Z2M dans la liste des modules tu dois d’abord ajouter le dépôts Github :
![](https://les-tutos-du-tof.fr/wp-content/uploads/2022/10/image-2-1024x148.png)
Clics sur dépôts et ajoute cette URL:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Clics sur Ajouter puis fermer.
Maintenant Z2M devrait apparaitre dans les modules disponibles
Clics sur Installer, on va passer à la configuration mais avant ça, il faut se créer un compte utilisateur.
Créer un utilisateur
Dans paramètres -> Personnes -> Ajouter une personne
En cliquant sur Autoriser la personne à se connecter, une nouvelle fenêtre demande un mot de passe
![](https://les-tutos-du-tof.fr/wp-content/uploads/2022/10/image-8.png)
Histoire de sécuriser un peu la chose, penses à cliquer sur Ne peut se connecter qu’à partir du réseau local.
Clics sur Créer deux fois
Retour dans les modules complémentaires -> Zigbee2MQTT et dans l’onglet Configuration.
Voici ma conf :
Pour connaitre le port (le port USB où se trouve ta clé Zigbee) il faut aller dans Paramètres -> Système -> Matériel puis Tout le matériel
Dans cette liste il faut identifier la clé Zigbee, pour moi une Sonoff et récupérer le port
server: mqtt://core-mosquitto:1883 correspond à notre serveur MQTT installé au début.
Donc Zigbee2MQTT va envoyé les infos à notre serveur Mosquitto qui va lui même les transmettre à HA
Après avoir enregistré on revient sur l’onglet Info, on active le chien de garde et si tu le souhaites, l’affichage dans la barre latérale et on Démarre !
Il faut un peu de temps pour que ça démarre, si tout se passe bien, une icone Zigbee2MQTT est apparue dans la barre latérale et te voici dans l’interface.
Si une erreur 502 apparait, soit il n’a pas finit de démarrer, soit il y a un problème dans la configuration.
A ce moment là il faut retourner dans les modules complémentaires et vérifier les logs de Z2M