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

On installe MOSQUITTO Broker

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

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 :

Clics sur dépôts et ajoute cette URL:

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Clics sur Ajouter puis fermer.

Si Zigbee2MQTT n’apparait pas il faut aller sur ton profil et activer le mode avancé

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

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