Zigbee2Mqtt : Le workflow d’ajout propre

Ajouter des devices avec Zigbee2Mqtt peut vite devenir complexe. On se retrouve avec des devices nommés n’importe comment, et des noms de topic tout nul. Malgré le package ultime proposant la fonction de rename, l’historique et l’autodiscover fait merder pas mal de choses…

La méthode propre

1. Désactiver le discovery MQTT dans votre configuration.yaml du broker MQTT
2. Redémarrer Home Assistant
3. Activer le permit join de zigbee2mqtt
4. Effectuer le processus de pairing de tous les devices souhaités
5. À chaque pairing, renommer le topic Zigbee2Mqtt depuis la boite à outil du package
6. Réactiver le discovery dans votre configuration.yaml
7. Redémarrer Home Assistant

Et si jamais on a merdé ? (ou plan B quoi…)

Quand on déconne et que le discovery mqtt est allumé lors d’un pairing on se retrouve vite avec ce genre de merdier :

Tout se passe dans deux fichiers dans config/.storage/ :

• core.device_registry
• core.entity_registry

Vous devrez :

1. Désactiver l’ajout automatique de l’intégration MQTT
   dans Configuration > Intégration > MQTT >
2. Effacer toutes les références au device rattaché (lui dans device_registry et toutes ses entités dans entity_registry)
3. Supprimer l’intégration MQTT
   dans Configuration > Intégration > MQTT > Corbeille
4. Redémarrer le serveur qui porte Home Assistant (vrai reboot du host, pas juste un restart de HA)

Ok les entités sont propres, vous pouvez passer à vos automations ! 🙂