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 AssistantFirmware du coordinateur Zigbee basé sur EZNet 6.10.3 prêt à l'emploi Prend en charge les plateformes Smart Home Assistant, openHAB, Zigbee2MQTT et ainsi de suite Basé sur EFR32MG21 + CH9102F/CP2102N, gain de sortie de +20dBm Le boîtier en aluminium réduit efficacement les interférences du signal par les périphériques Câble d'extension USB de 1,5 m en option pour une meilleure portée du signal SONOFF Zigbee 3.0 USB Dongle Plus kann mit den folgenden Geraten funktionieren : Routeur : ZBMINI Smart schalter, S26R2ZBTPF Zigbee Smart steckdose Endgerat : ZBMINI-L Smart Switch, SNZB-01 Switch, SNZB-02 Temperatur und Feuchtigkeitssensor. Bewegungssensor SNZB-03, Tur-Fenstersensor SNZB-04 -
SONOFF Zigbee 3.0 & Thread Dongle Lite (EFR32MG21) | Coordinateur de clé USB pour Home Assistant & Zigbee2MQTT | Passerelle compacte avec Fonction Flash Simple firmware et rallongePuce éprouvée EFR32MG21. Confiée par des millions d'utilisateurs, la puce EFR32MG21 garantit des performances fiables et stables. Taille compacte. Le design compact permet une installation facile dans différentes positions de port USB. Large compatibilité de plate-forme. Le dongle Zigbee fonctionne avec Home Assistant, Zigbee2MQTT, openHAB et prend en charge les appareils Zigbee 3.0 tels que Philips Hue, Aqara, IKEA Tradfri et SONOFF. Mise à jour flexible du micrologiciel. Le firmware peut être facilement flashé via le SONOFF Dongle Flasher ou l'add-on pour basculer entre le coordinateur Zigbee, le routeur ou le mode RCP thread. Câble d'extension USB inclus. Permet un placement flexible et réduit les interférences électromagnétiques causées par les ports USB 3.0. -
SONOFF Zigbee 3.0 Dongle USB Plus MG24, Zigbee Gateway avec EFR32MG24, Thread & Zigbee Clé USB, Contrôleur Zigbee pour Home Assistant ou Zigbee2MQTTPuce EFR32MG24 puissante. Alimenté par la puce avancée EFR32MG24, il offre plus de ressources et des performances supérieures pour des processus d'automatisation plus rapides et un contrôle stable des sous-appareils. Gain d'antenne amélioré. Gain d'antenne standard de 3 dBi optimisé jusqu'à 4,5 dBi pour une puissance de signal plus forte et une plus grande portée, assure une connexion fiable des appareils. Large compatibilité de plate-forme. Le dongle Zigbee fonctionne avec Home Assistant, Zigbee2MQTT, openHAB et prend en charge les appareils Zigbee 3.0 tels que Philips Hue, Aqara, IKEA Tradfri et Sonoff. Options flexibles de micrologiciel flash. Le firmware peut être facilement flashé via le Dongle Flasher SONOFF ou le module complémentaire pour basculer entre le coordinateur Zigbee, le routeur ou le mode RCP de thread. Design compact avec câble d'extension USB. Le boîtier plus petit avec rallonge USB permet un placement flexible et réduit les interférences électromagnétiques pour une communication stable.
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)【Haute précision et actualisation rapide】 Grâce au capteur hygrométrique intelligent fabriqué en Suisse, la température est précise jusqu'à ±0,2°C/±0,4°F tandis que l'humidité est de ±2%HR, les mesures de données sont mises à jour toutes les 5 secondes pour vous donner les derniers changements de température et d'humidité. 【Zigbee 3.0 Compatible】Supporte les hubs Zigbee utilisant le protocole Zigbee 3.0, comme SONOFF iHost, NSPanel Pro, ZB Bridge Pro, et ZBDongle-E. Et théoriquement, il est possible de l'ajouter à n'importe quel concentrateur Zigbee développé conformément aux protocoles Zigbee 3.0 【Comfort Alert】Lorsque la température ou l'humidité de la pièce dépasse la plage de confort définie, vous recevrez des notifications immédiates sur votre téléphone, ce qui vous aidera à maintenir le confort de la pièce et à assurer la qualité de vie. 【Data Storage & Export】Up to half-year free cloud storage, Vous pouvez facilement accéder aux variations de température et d'humidité pour chaque jour, mois ou tous les six mois grâce à des requêtes en temps réel, et les données peuvent être exportées. 【4 Years Battery Life】Powered by a CR2477 battery. Les données relatives à la durée de vie de la batterie sont obtenues par le laboratoire interne de SONOFF, veuillez vous référer à l'utilisation réelle. -
SONOFF SNZB-02LD Capteur de température étanche Zigbee avec sonde en acier inoxydable de 1,5 m, écran LCD, plage -40~115°C, surveillance via APP, support magnétique, fonctionne avec hub ZigbeeDesign Étanche: L'unité principale classée IP65 résiste aux éclaboussures d'eau, la rendant adaptée à des environnements humides tels que les piscines, les baignoires ou les cuisines, sans compromettre les performances. Large Plage de Température: Équipé d'une sonde en acier inoxydable 304 de 1,5 m pour des lectures précises de -40°C à 115°C, idéal pour les mesures dans les réfrigérateurs, les conduits de ventilation, les bouteilles de fermentation, etc. Affichage LCD en Temps Réel: Écran LCD clair et haute définition affiche instantanément la température actuelle, vous n'avez donc pas besoin de vérifier votre téléphone à chaque fois. Surveillance via APP & Export de Données: Visualisez les données de température en direct et les graphiques historiques via l'app, ou exportez les journaux de température pour analyse et archivage. Installation Flexible et Connectivité Zigbee: Fonctionne comme un sous-appareil Zigbee (nécessite un hub Zigbee), avec des options de montage magnétique ou de suspension pour un placement facile dans différents endroits. -
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【Remote Real-time monitoring】SNZB-02D sensor will monitor the temperature and humidity in real time on the APP remotely or display screen, with up to 120m/400ft coverate. 【Haute précision et rafraîchissement rapide】Capteur hygrométrique intelligent fabriqué en Suisse qui vous donne des mesures plus précises, avec une précision de ±0,2°C/±0,4°F pour la température et de ±2%RH pour l'humidité, rafraîchissant les mesures toutes les 5 secondes. 【Large écran LCD】Utilisez le grand écran LCD pour visualiser les valeurs en temps réel de la température et de l'humidité de manière claire et dynamique, les icônes d'affichage intuitives vous permettent de vérifier les conditions de la pièce et l'état de la batterie encore plus facilement que jamais. 【App notifications】Vous recevrez des alertes instantanées sur votre téléphone lorsque la température ou l'humidité dépasse le niveau de confort que vous avez défini. 【Data Storage & Export】Up to half-year free cloud storage, and most accurate enough to view hourly data, you can also check the highest and lowest values at any hour or day and data can be exported as files.
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🌈 CHANGEZ DE COULEUR SELON VOTRE ENVIE avec l’ampoule intelligente ZigBee RGB E27 qui vous offre 16 millions de couleurs à choisir. Créez des ambiances personnalisées pour chaque pièce, chaque occasion et chaque humeur. 💡 CONTRÔLEZ VOTRE ÉCLAIRAGE DEPUIS N’IMPORTE OÙ avec votre smartphone ou votre voix grâce à l’application nous smart ou tuya smart life. Réglez la luminosité et la température de couleur de froid à chaud blanc, programmez des horaires, des minuteries, des scènes et des routines pour automatiser votre éclairage. 🗣️ COMPATIBLE AVEC LES ASSISTANTS VOCAUX comme Alexa, Google Home, HomeKit et Home Assistant. Utilisez votre voix pour allumer/éteindre, atténuer/augmenter, changer de couleur ou définir des scènes pour votre ampoule intelligente. Dites simplement “Alexa, mets la lumière du salon en bleu” ou “Hey Google, bonjour” et votre ampoule intelligente réagira en conséquence. 🔌 FACILE À INSTALLER ET À UTILISER: Il vous suffit de visser l’ampoule intelligente ZigBee RGB E27 dans votre lampe ou votre luminaire, de télécharger l’application nous smart ou tuya smart life sur votre smartphone et de la connecter à votre passerelle ZigBee (Nous E1 ou Nous E7). Vous pouvez également utiliser ZigBee2mqtt ou ZHA pour la connecter à Home Assistant sans cloud. 🎮 SYNCHRONISEZ VOTRE AMPOULE INTELLIGENTE pour créer des effets immersifs. Transformez votre salon en salle de cinéma, votre chambre en discothèque ou votre gaming room en arène de combat. Laissez votre ampoule intelligente ZigBee RGB E27 vous faire vivre des expériences inoubliables. -
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🌈 CHANGEZ DE COULEUR SELON VOTRE ENVIE avec l’ampoule intelligente ZigBee RGB E27 qui vous offre 16 millions de couleurs à choisir. Créez des ambiances personnalisées pour chaque pièce, chaque occasion et chaque humeur. 💡 CONTRÔLEZ VOTRE ÉCLAIRAGE DEPUIS N’IMPORTE OÙ avec votre smartphone ou votre voix grâce à l’application nous smart ou tuya smart life. Réglez la luminosité et la température de couleur de froid à chaud blanc, programmez des horaires, des minuteries, des scènes et des routines pour automatiser votre éclairage. 🗣️ COMPATIBLE AVEC LES ASSISTANTS VOCAUX comme Alexa, Google Home, HomeKit et Home Assistant. Utilisez votre voix pour allumer/éteindre, atténuer/augmenter, changer de couleur ou définir des scènes pour votre ampoule intelligente. Dites simplement “Alexa, mets la lumière du salon en bleu” ou “Hey Google, bonjour” et votre ampoule intelligente réagira en conséquence. 🔌 FACILE À INSTALLER ET À UTILISER: Il vous suffit de visser l’ampoule intelligente ZigBee RGB E27 dans votre lampe ou votre luminaire, de télécharger l’application nous smart ou tuya smart life sur votre smartphone et de la connecter à votre passerelle ZigBee (Nous E1 ou Nous E7). Vous pouvez également utiliser ZigBee2mqtt ou ZHA pour la connecter à Home Assistant sans cloud. 🎮 SYNCHRONISEZ VOTRE AMPOULE INTELLIGENTE pour créer des effets immersifs. Transformez votre salon en salle de cinéma, votre chambre en discothèque ou votre gaming room en arène de combat. Laissez votre ampoule intelligente ZigBee RGB E27 vous faire vivre des expériences inoubliables. -
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🌈 CHANGEZ DE COULEUR SELON VOTRE ENVIE avec l’ampoule intelligente ZigBee RGB E27 qui vous offre 16 millions de couleurs à choisir. Créez des ambiances personnalisées pour chaque pièce, chaque occasion et chaque humeur. 💡 CONTRÔLEZ VOTRE ÉCLAIRAGE DEPUIS N’IMPORTE OÙ avec votre smartphone ou votre voix grâce à l’application nous smart ou tuya smart life. Réglez la luminosité et la température de couleur de froid à chaud blanc, programmez des horaires, des minuteries, des scènes et des routines pour automatiser votre éclairage. 🗣️ COMPATIBLE AVEC LES ASSISTANTS VOCAUX comme Alexa, Google Home, HomeKit et Home Assistant. Utilisez votre voix pour allumer/éteindre, atténuer/augmenter, changer de couleur ou définir des scènes pour votre ampoule intelligente. Dites simplement “Alexa, mets la lumière du salon en bleu” ou “Hey Google, bonjour” et votre ampoule intelligente réagira en conséquence. 🔌 FACILE À INSTALLER ET À UTILISER: Il vous suffit de visser l’ampoule intelligente ZigBee RGB E27 dans votre lampe ou votre luminaire, de télécharger l’application nous smart ou tuya smart life sur votre smartphone et de la connecter à votre passerelle ZigBee (Nous E1 ou Nous E7). Vous pouvez également utiliser ZigBee2mqtt ou ZHA pour la connecter à Home Assistant sans cloud. 🎮 SYNCHRONISEZ VOTRE AMPOULE INTELLIGENTE pour créer des effets immersifs. Transformez votre salon en salle de cinéma, votre chambre en discothèque ou votre gaming room en arène de combat. Laissez votre ampoule intelligente ZigBee RGB E27 vous faire vivre des expériences inoubliables.
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.
