Zigbee2MQTT simplifie la domotique, à condition de choisir la bonne clé et de soigner son installation

Zigbee2MQTT transforme une clé Zigbee en passerelle locale entre vos capteurs, ampoules ou prises connectées et votre système domotique. Il fonctionne avec Home Assistant comme avec Jeedom, au prix d’une configuration plus technique qu’une intégration native. En contrepartie, vous bénéficiez d’une meilleure compatibilité, d’une vision plus précise du réseau et d’une moindre dépendance aux ponts propriétaires.

Comprendre le rôle de Zigbee2MQTT sans jargon

Zigbee2MQTT, souvent abrégé en Z2M, est un logiciel qui lit les échanges radio Zigbee grâce à un coordinateur Zigbee, généralement une clé USB. Il publie ensuite ces informations vers un broker MQTT. Home Assistant, Jeedom, Node-RED ou tout autre logiciel compatible MQTT peuvent ainsi exploiter les appareils détectés, leurs états et leurs commandes.

MQTT : le relais entre la radio et la domotique

MQTT repose sur un système de publication et d’abonnement. Zigbee2MQTT publie, par exemple, l’état d’un capteur sur un topic MQTT. Votre logiciel domotique s’abonne à ce topic pour recevoir l’information. Le message transmis, appelé payload, peut contenir une température, un niveau de batterie ou une commande d’allumage.

Un broker MQTT, comme Mosquitto, est donc indispensable. Il reçoit les messages et les distribue aux clients concernés. Zigbee2MQTT ne communique pas directement avec Home Assistant ou Jeedom : le broker assure le relais entre le réseau Zigbee et les applications qui l’utilisent.

Cette séparation apporte une certaine souplesse au quotidien. Zigbee2MQTT peut être installé sur la même machine que Home Assistant ou sur un serveur distinct. Si l’interface domotique redémarre, le coordinateur et le réseau Zigbee ne sont pas nécessairement remis à zéro. L’architecture reste ainsi plus modulaire dans une installation qui rassemble Zigbee, Wi-Fi, Bluetooth et plusieurs outils d’automatisation.

Pourquoi éviter les ponts de marque

Un hub fourni par un fabricant peut limiter les appareils compatibles, les réglages disponibles ou l’accès local. Zigbee2MQTT permet au contraire de réunir des objets de marques différentes autour d’un réseau Zigbee unique. Sa documentation présente les appareils pris en charge, leurs paramètres spécifiques et les éventuelles particularités connues.

Avant d’acheter un appareil, vérifiez toutefois son modèle exact sur le site officiel zigbee2mqtt.io ou dans une base de compatibilité comme zigbee.blakadder.com. Une référence proche peut présenter des fonctions ou une compatibilité différentes.

Zigbee2MQTT, ZHA ou Deconz : choisir selon votre façon de bricoler

Ces trois solutions ne répondent pas au même besoin. ZHA est l’intégration Zigbee directement incluse dans Home Assistant. Deconz est historiquement associé aux clés ConBee et à leur écosystème. Zigbee2MQTT demande davantage de réglages au départ, mais son approche MQTT et son interface dédiée offrent plus de liberté.

Choisissez ZHA si votre priorité est de brancher une clé et de commencer rapidement dans Home Assistant. Préférez Zigbee2MQTT si vous voulez inspecter précisément les appareils, utiliser MQTT dans vos scénarios, garder une porte de sortie vers Jeedom ou héberger la passerelle ailleurs. Deconz reste cohérent si votre matériel et vos habitudes reposent déjà sur ConBee.

Une migration de ZHA ou Deconz vers Zigbee2MQTT n’est pas une simple bascule logicielle. Les appareils doivent généralement être réappairés au nouveau coordinateur. Préparez l’opération pièce par pièce, notez vos automatisations et ne supprimez pas l’ancienne intégration avant d’avoir validé chaque capteur et chaque actionneur.

Choisir la clé Zigbee et l’installer au bon endroit

Le choix du dongle détermine le chipset, le firmware et le paramètre adapter à déclarer dans Zigbee2MQTT. Ne sélectionnez pas une clé uniquement parce qu’elle est populaire. Vérifiez sa prise en charge, la compatibilité de son firmware avec votre version de Z2M et la possibilité de l’identifier de façon stable sur votre machine.

Chipset, adapter et firmware : les trois vérifications utiles

Une Sonoff ZBDongle-P utilise couramment l’adapter zstack. Les ZBDongle-E et SkyConnect, également appelée ZBT-1, s’appuient sur l’adapter ember. Une ZiGate demande l’adapter zigate. Pour les clés ember, un firmware ember en version 8.0.2 ou supérieure est requis. Certaines clés nécessitent donc un flashage avant leur mise en service. Vérifiez ce point avant d’appairer vos appareils.

Les gammes SLZB comprennent notamment les modèles 06, 06M, 06P7 et 06P10. Les ConBee forment une autre famille connue, mais un firmware ConBee II au-delà de la version 0x26580700 peut devenir problématique. Le bon matériel n’est pas forcément le plus coûteux : c’est celui dont le chipset, le firmware et le mode de connexion correspondent à votre installation.

Le détail physique qui stabilise le réseau

Un coordinateur radio reste sensible à son environnement. Branchez la clé sur un port USB2, particulièrement sur Raspberry Pi, et utilisez une rallonge USB de 1 m à 1,5 m. Éloignez-la du boîtier, des disques USB, du routeur Wi-Fi et des surfaces métalliques. Cette précaution réduit les perturbations radio sans nécessiter de modification logicielle.

Dans un réseau maillé, chaque appareil alimenté en permanence peut servir de relais. Il aide à relier les appareils situés dans différentes zones du logement. Une prise Zigbee placée dans un couloir ou près d’une pièce mal couverte ne sert donc pas seulement à piloter un appareil : elle peut améliorer la liaison entre deux parties du réseau. Avant d’accuser la clé, observez ce maillon intermédiaire et ajoutez un routeur Zigbee là où le signal doit franchir une zone difficile.

Installer Zigbee2MQTT sur Home Assistant ou Jeedom

Sur Home Assistant OS, l’approche la plus accessible consiste à installer Mosquitto Broker, puis l’add-on Zigbee2MQTT. Le dépôt de l’add-on est disponible à l’adresse github.com/zigbee2mqtt/hassio-zigbee2mqtt. Sur Jeedom, le principe reste le même : Zigbee2MQTT s’exécute comme un service et communique avec Jeedom par MQTT.

1. Installez et démarrez Mosquitto. Créez un utilisateur dédié plutôt que d’utiliser un accès anonyme.
2. Branchez la clé et identifiez son port série stable. Préférez un chemin de type /dev/serial/by-id à un nom de port susceptible de changer après un redémarrage.
3. Installez Zigbee2MQTT. Renseignez l’adresse du broker, les identifiants MQTT, le port série et l’adapter correspondant au chipset.
4. Désactivez l’intégration qui utilise déjà la clé. ZHA ou Deconz ne doivent pas conserver le contrôle du même coordinateur.
5. Démarrez Z2M et ouvrez son interface web. Autorisez temporairement l’appairage, ajoutez un appareil à la fois, puis désactivez cette autorisation.

Dans Home Assistant, ajoutez ensuite l’intégration MQTT si elle n’est pas déjà détectée. Les entités publiées par Zigbee2MQTT apparaîtront dans l’interface. L’interface graphique de Z2M permettra de consulter les informations techniques, les appareils associés et le graphe du réseau maillé.

Éviter les déconnexions et diagnostiquer les blocages

Les problèmes les plus fréquents viennent du port USB, d’un mauvais adapter, d’un firmware inadapté ou d’une interférence radio. Les versions de Zigbee2MQTT antérieures à 2.5.0 ont connu des cas d’instabilité réseau. À partir de Z2M 2.5.0, le firmware 0x26780700 est recommandé dans les situations concernées. Ne mettez pas à jour à l’aveugle : relevez d’abord le modèle de votre clé et son chipset.

• Si Zigbee2MQTT ne démarre pas, contrôlez le chemin du port série et vérifiez qu’aucun autre service n’occupe la clé.
• Si les appareils disparaissent, inspectez la rallonge USB, la proximité du Wi-Fi et la présence de routeurs Zigbee alimentés sur secteur.
• Si l’appairage échoue, rapprochez temporairement l’appareil du coordinateur et confirmez qu’il a bien été réinitialisé.
• Si un équipement est visible mais incomplet, consultez sa fiche de compatibilité : certains paramètres ou fonctions demandent une configuration particulière.

Évitez enfin de modifier simultanément le firmware, l’adapter et l’emplacement physique de la clé. Changez un seul élément, redémarrez proprement, puis observez le comportement. Cette méthode rend le dépannage plus lisible et permet d’isoler la cause d’une déconnexion ou d’un échec d’appairage.

• À propos
• Articles récents

Élise Perraudin

Curieuse et passionnée de domotique, je partage ici mes conseils pratiques pour simplifier la maison connectée, de façon accessible et éthique.

Les derniers articles par Élise Perraudin (tout voir)

• Netlinking : choisir des sites éditoriaux solides sans acheter du bruit - 21 septembre 2026
• Thermostat Netatmo : économies réelles, design Starck et points de vigilance - 21 septembre 2026
• De l’Apollo de 1967 aux 50 milliards d’objets connectés : le vrai visage de l’informatique embarquée - 20 septembre 2026

Articles qui pourraient vous intéresser :

Quelles automatisations créer sur iPhone ? Wi‑Fi, batterie, AirPods et luminosité Home Assistant et ZLinky : pourquoi la consommation non suivie apparaît, entre arrondis, rattrapages et mauvaise entité Passerelle Zigbee : choisissez USB, Ethernet ou Wi-Fi selon votre écosystème Ampoules connectées Alexa : le bon choix dépend du protocole, du culot et de la lumière