La communauté domotique est en effervescence suite à la publication, le 13 août 2025, de la version 2.0.0 de Zigbee2MQTT. Ce passage de la branche 1.xx à une version majeure 2.0.0 n’est pas anodin et signale des changements profonds sous le capot. Pour les milliers d’utilisateurs qui s’appuient sur cette solution open-source pour piloter leur réseau d’objets connectés Zigbee, cette mise à jour est à la fois une promesse d’amélioration et un défi technique. Une préparation minutieuse s’impose pour garantir une transition en douceur et éviter de transformer sa maison intelligente en un assemblage d’appareils inertes.
Comprendre les nouveautés de Zigbee2MQTT 2.0.0
Une mise à jour majeure comme celle-ci ne se contente pas d’ajouter quelques fonctionnalités. Elle restructure, optimise et parfois abandonne des éléments du passé pour construire un avenir plus stable et performant. La version 2.0.0 de Zigbee2MQTT s’inscrit pleinement dans cette logique, avec des modifications qui touchent au cœur même du logiciel.
Nettoyage de code et rationalisation
L’un des chantiers principaux de cette nouvelle version a été un vaste nettoyage du code source. Les développeurs ont supprimé des pans entiers de code obsolète et des méthodes de gestion d’appareils qui n’étaient plus pertinentes. Ce travail de fond, bien qu’invisible pour l’utilisateur final, est crucial. Il permet non seulement d’améliorer les performances générales et la réactivité du système, mais aussi de renforcer la sécurité en réduisant la surface d’attaque potentielle. Moins de code ancien signifie moins de failles héritées.
Amélioration de la découverte des adaptateurs
La gestion des coordinateurs Zigbee, ces clés USB qui font le pont entre votre serveur et vos appareils, a été revue. La version 2.0.0 introduit une méthode de découverte automatique plus sophistiquée. Cependant, ce changement peut avoir un effet de bord : si votre configuration ne spécifiait pas explicitement le port de votre adaptateur, il est possible que Zigbee2MQTT ne le trouve plus. Il est donc fortement conseillé d’ajouter le paramètre serial: adapter: dans votre fichier de configuration pour forcer la détection et éviter toute erreur au redémarrage.
-
SONOFF ZigBee 3.0 USB Dongle Plus, EFR32MG21 Coordinator, Universelle USB ZigBee Hub, Passerelle ZigBee pour Home Assistant -
SONOFF Zigbee 3.0 & Thread Dongle Lite (EFR32MG21) | Coordinateur de clé USB pour Home Assistant & Zigbee2MQTT | Passerelle compacte avec Fonction Flash Simple firmware et rallonge -
Phoscon ConBee II - passerelle USB Universelle Zigbee 3.0, y Compris Application deCONZ & Phoscon, domotique, Assistant Domestique, ioBroker, Zigbee2MQTT
Gestion des groupes et de l’appairage
La manière dont les appareils sont groupés et liés entre eux (binding) a également bénéficié d’améliorations. L’objectif est d’offrir une plus grande fiabilité, notamment pour des commandes groupées de luminaires ou de volets roulants. Ces modifications visent à rendre les interactions plus directes et plus rapides, en réduisant la latence perçue par l’utilisateur lors du contrôle de plusieurs appareils simultanément.
Nouvelles entités pour les modules Zigbee
Afin de mieux s’adapter à un écosystème d’appareils en constante évolution, la version 2.0.0 introduit de nouvelles entités dédiées à la mise à jour du firmware des modules Zigbee (OTA – Over-The-Air). Cette nouveauté facilite grandement la maintenance de son parc d’équipements en permettant de déployer les dernières versions logicielles directement depuis l’interface de Zigbee2MQTT, renforçant ainsi la compatibilité avec les produits les plus récents.
Maintenant que les principales évolutions techniques sont claires, il convient de se pencher sur les actions concrètes à mener avant de lancer la procédure de mise à jour sur son système de production.
Précautions avant la mise à jour
Se lancer tête baissée dans une mise à jour majeure est le meilleur moyen de rencontrer des problèmes. Une approche méthodique et préventive est indispensable pour sécuriser son installation domotique. Quelques étapes clés doivent être scrupuleusement respectées.
L’importance cruciale de la sauvegarde
C’est la règle d’or de toute opération informatique : ne jamais procéder à une mise à jour sans une sauvegarde complète et vérifiée. Pour Zigbee2MQTT, cela implique de sauvegarder l’intégralité de votre répertoire de configuration. Ce dossier contient des fichiers essentiels :
- configuration.yaml : Le cœur de votre installation.
- database.db : La base de données qui recense tous vos appareils appairés.
- state.json : L’état actuel de vos appareils.
Une simple copie de ce dossier dans un emplacement sûr vous permettra de revenir en arrière en cas de problème majeur.
Consulter les notes de version
Les développeurs publient systématiquement des « release notes » détaillant tous les changements. Il est impératif de les lire attentivement. C’est dans ce document que vous trouverez la liste des « breaking changes », c’est-à-dire les modifications qui cassent la compatibilité avec les versions précédentes et qui nécessitent une action manuelle de votre part.
Vérifier la compatibilité du matériel et des logiciels
Assurez-vous que votre matériel est toujours compatible. Cela concerne principalement votre coordinateur Zigbee. Il est aussi important de vérifier la version de vos dépendances logicielles, comme Node.js ou la version de l’add-on si vous utilisez Home Assistant.
| Élément à vérifier | Action recommandée | Niveau de criticité |
|---|---|---|
| Sauvegarde du répertoire de configuration | Copie complète dans un lieu sûr | Élevé |
| Lecture des notes de version | Identifier les « breaking changes » | Élevé |
| Compatibilité du coordinateur | Consulter la documentation officielle | Moyen |
| Version des dépendances (Node.js, etc.) | Mettre à jour si nécessaire | Moyen |
Une fois ces précautions prises, il faut anticiper la manière dont cette mise à jour pourrait impacter les autres briques logicielles qui communiquent avec Zigbee2MQTT.
Comment gérer les dépendances problématiques
Zigbee2MQTT n’est souvent qu’un maillon d’une chaîne domotique plus complexe. Sa mise à jour peut donc avoir des répercussions sur les systèmes qui en dépendent, comme les serveurs domotiques ou les outils de création de scénarios.
Identifier les intégrations dépendantes
La première étape consiste à lister toutes les applications qui communiquent avec Zigbee2MQTT. La plus courante est Home Assistant, via l’intégration MQTT. Mais d’autres systèmes comme Jeedom, Domoticz ou des outils comme Node-RED peuvent également être connectés. Il est essentiel de vérifier que vos automatisations, scénarios et tableaux de bord continuent de fonctionner correctement après la mise à jour.
Le cas spécifique des convertisseurs externes
Les utilisateurs avancés qui ont ajouté des appareils non supportés nativement utilisent souvent des convertisseurs externes (external converters). L’API utilisée par ces convertisseurs peut avoir changé dans la version 2.0.0. Il est donc fondamental de vérifier la compatibilité de vos fichiers de convertisseurs personnalisés et de les mettre à jour en suivant la nouvelle documentation pour éviter que certains de vos appareils ne deviennent muets.
Au-delà des aspects purement logiciels, l’impact de la mise à jour se ressentira directement sur le comportement de vos objets connectés.
Adapter ses appareils Zigbee à la nouvelle version
Le but final de cette mise à jour est d’améliorer la gestion de votre réseau d’appareils. Il est donc logique de s’attarder sur leur comportement après la transition et sur les actions à mener pour garantir leur bon fonctionnement.
Le ré-appairage est-il nécessaire ?
En théorie, non. La mise à jour est conçue pour conserver tous les appareils déjà appairés. Cependant, dans la pratique, certains appareils plus capricieux ou utilisant des implémentations non standard du protocole Zigbee pourraient nécessiter un ré-appairage. Si un appareil ne répond plus après la mise à jour, le retirer puis le ré-appairer est souvent la solution la plus simple et la plus efficace.
Gérer les appareils non reconnus
Si un appareil fonctionnait parfaitement avant et n’est plus reconnu après la mise à jour, la première chose à faire est de consulter les journaux (logs) de Zigbee2MQTT. Ils contiennent des informations précieuses sur la cause du problème. Il peut s’agir d’un convertisseur qui n’est plus compatible ou d’un changement dans la manière dont l’appareil est identifié.
-
SONOFF SNZB-02P Capteur de Température et d'Humidité Intelligent, ZigBee 3.0 Thermomètre Hygrometre Intérieur, ZigBee Hub Requis, Compatible avec Alexa, Google Home, Smartthings (2 Pack) -
SONOFF SNZB-02D Mini Capteur ZigBee de Température et d'humidité, Thermomètre Hygrometre Intérieur, Affichage sur écran LCD, Compatible avec Alexa/Google Home, 2 Pack -
SONOFF SNZB-02D Mini Capteur ZigBee de Température et d'humidité Intelligent, Thermomètre Hygrometre Intérieur, écran LCD, Actualisation 5S, Compatible avec Alexa/Google Home/Home Assistant
Profiter des nouvelles fonctionnalités
Qui dit mise à jour dit aussi nouvelles possibilités. La version 2.0.0 peut exposer de nouvelles entités pour vos appareils existants : un capteur de batterie plus précis, de nouveaux paramètres de configuration pour une ampoule, etc. Prenez le temps d’explorer vos appareils dans l’interface de Zigbee2MQTT ou de votre système domotique pour découvrir et exploiter ces nouveautés.
-
NOUS P3Z Ampoule intelligente ZigBee RGB E27, Compatible avec Alexa,Hue Bridge, Google Home, Home Assistant, 16 Millions de Couleurs, Contrôle Vocal et Par Application, 2700-6500K -
Osram Lampe LED SMART A60 forme d'ampoule E27, 9 W ZigBee 3.0, intensité variable 2700 K blanc chaud, contrôle par application, Alexa, Google Assistant -
NOUS P3Z Ampoule intelligente ZigBee RGB E27, Compatible avec Alexa,Hue Bridge, Google Home, Home Assistant, 16 Millions de Couleurs, Contrôle Vocal et Par Application, 2700-6500K
Une fois la mise à jour effectuée et les appareils vérifiés, une phase de contrôle et de validation s’impose pour s’assurer que l’ensemble du système est stable.
Test et validation de la mise à jour
La mise à jour est terminée, mais le travail n’est pas fini. Il faut maintenant valider que tout fonctionne comme attendu et être prêt à réagir en cas de dysfonctionnement persistant.
Procédure de validation post-mise à jour
Il est conseillé de suivre une liste de contrôle systématique pour ne rien oublier. Voici une suggestion :
- Vérifier les journaux de Zigbee2MQTT à la recherche de messages d’erreur ou d’avertissement (warnings).
- Tester manuellement les appareils critiques : allumer une lumière, vérifier la remontée d’un capteur d’ouverture, actionner une prise commandée.
- Déclencher quelques automatisations clés pour s’assurer qu’elles fonctionnent toujours.
- Naviguer dans l’interface web de Zigbee2MQTT pour vérifier que tous les appareils sont bien présents et communiquent.
Stratégie de retour en arrière (rollback)
Si, malgré toutes vos précautions, des problèmes bloquants apparaissent, il ne faut pas hésiter à utiliser votre plan B : la restauration. Grâce à la sauvegarde effectuée au préalable, vous pouvez revenir à la version précédente de Zigbee2MQTT. La procédure consiste généralement à stopper le service, restaurer le dossier de configuration, puis relancer l’ancienne version. C’est une assurance tranquillité qui justifie amplement le temps passé à préparer la sauvegarde.
Le monde de la domotique open-source est en perpétuel mouvement. Cette mise à jour n’est qu’une étape dans un long processus d’amélioration continue.
Rester informé des évolutions futures de Zigbee2MQTT
La version 2.0.0 est une étape majeure, mais le développement ne s’arrête pas là. Pour maintenir une installation saine et performante sur le long terme, une veille active est nécessaire.
Suivre les canaux officiels
La source d’information la plus fiable reste les canaux officiels du projet. Le dépôt GitHub de Zigbee2MQTT est l’endroit où sont publiées les nouvelles versions et où les problèmes sont discutés. La documentation officielle est également une ressource inestimable, constamment mise à jour pour refléter les derniers changements.
Participer à la communauté
Zigbee2MQTT est un projet communautaire. Participer aux forums, aux groupes de discussion ou aux serveurs Discord permet non seulement de trouver de l’aide mais aussi d’en apporter. Signaler un bug de manière détaillée ou partager une solution à un problème commun contribue directement à l’amélioration du projet pour tous.
Comprendre le cycle de développement
Après une version majeure comme la 2.0.0, attendez-vous à voir apparaître rapidement des versions mineures (2.0.1, 2.0.2, etc.). Celles-ci ont pour but de corriger les bugs découverts après le déploiement à grande échelle. Il est souvent judicieux d’attendre une ou deux de ces versions correctives avant de migrer un système de production très sensible.
Le passage à Zigbee2MQTT 2.0.0 est une évolution significative qui promet un système plus robuste et pérenne. Si elle demande une préparation rigoureuse, les bénéfices en termes de performance, de sécurité et de fonctionnalités sont réels. La clé du succès réside dans une approche méthodique : sauvegarder, s’informer en lisant les notes de version, vérifier les dépendances et valider le fonctionnement post-migration. En respectant ces étapes, les utilisateurs s’assurent une transition sereine vers cette nouvelle ère de la gestion de leur réseau Zigbee.
