Zigbee avec Home Assistant : installation, ZHA ou Zigbee2MQTT

Zigbee reste l’un des meilleurs moyens d’équiper Home Assistant en capteurs, boutons, prises, ampoules et modules alimentés sur batterie. Mais un réseau Zigbee fiable ne dépend pas seulement du choix entre ZHA et Zigbee2MQTT : le coordinateur, le canal radio, les routeurs, l’emplacement de la clé, les sauvegardes et même la façon d’appairer les appareils ont un impact direct sur la stabilité.

Ce guide est conçu comme une référence pratique pour 2026 : architecture Zigbee, choix du coordinateur, ZHA ou Zigbee2MQTT, canaux, interférences Wi-Fi, appairage, routeurs, groupes, binding, sécurité, sauvegardes et diagnostic. Pour comprendre comment Zigbee s’insère dans l’architecture globale de Home Assistant, notre dossier Applications ou intégrations Home Assistant complète directement cette page.

Comprendre le réseau Zigbee avant de l’installer

Un réseau Zigbee 2,4 GHz est un réseau maillé. Contrairement au Wi-Fi classique, tous les appareils ne parlent pas forcément directement au coordinateur. Les équipements alimentés en permanence peuvent relayer les messages pour les appareils plus éloignés.

Cette distinction explique plusieurs comportements qui surprennent les débutants. Un capteur sur pile ne relaie généralement rien. Une prise Zigbee peut au contraire devenir un maillon important du réseau. Et un appareil sur batterie peut rester « absent » d’une carte réseau pendant un moment sans être réellement en panne, simplement parce qu’il dort.

Un réseau Zigbee ne comporte qu’un seul coordinateur. ZHA et Zigbee2MQTT ne peuvent donc pas piloter simultanément le même adaptateur ni le même réseau. Il est possible d’avoir les deux solutions en parallèle, mais avec deux coordinateurs et deux réseaux Zigbee distincts.

Quel coordinateur Zigbee choisir en 2026 ?

Le coordinateur est la radio centrale du réseau. Son chipset, son firmware, son antenne et surtout son emplacement comptent beaucoup.

Pour une nouvelle installation ZHA, la documentation Home Assistant recommande actuellement le Home Assistant Connect ZBT-2. Il utilise une puce Silicon Labs MG24, une antenne externe optimisée et peut être dédié soit à Zigbee, soit à Thread. Le ZBT-1, anciennement SkyConnect, reste pris en charge mais n’est plus produit.

Zigbee2MQTT prend également en charge le ZBT-2 ainsi que de nombreux coordinateurs basés sur Texas Instruments Z-Stack ou Silicon Labs EmberZNet. Les documentations Zigbee2MQTT recommandent aujourd’hui principalement ces familles ainsi que deCONZ pour les adaptateurs compatibles.

Pour Zigbee2MQTT, la documentation déconseille explicitement les coordinateurs série distants transportés via Wi-Fi, WAN ou VPN. Le protocole série utilisé entre le logiciel et le coordinateur tolère mal les pertes et variations de latence. Si vous avez besoin d’éloigner la radio, Ethernet filaire est nettement préférable au Wi-Fi.

Le piège numéro 1 : l’USB 3.0 et le bruit radio en 2,4 GHz

Un coordinateur Zigbee peut être parfaitement compatible et pourtant donner un réseau catastrophique simplement parce qu’il est branché au mauvais endroit. Les ports et périphériques USB 3.0 sont connus pour générer du bruit électromagnétique dans la bande 2,4 GHz, celle utilisée par Zigbee.

Les symptômes typiques sont trompeurs : appairages qui échouent, appareils qui disparaissent, délais de réponse, capteurs impossibles à joindre ou réseau qui semble fonctionner une journée puis devenir instable.

Les bonnes pratiques sont simples :

• utiliser une rallonge USB pour éloigner la clé du serveur ;
• éviter de la coller à un SSD USB 3, un boîtier métallique, un routeur Wi-Fi ou un mini-PC ;
• si possible, utiliser un port ou hub USB 2.0 stable ;
• placer l’antenne en hauteur et dégagée plutôt que derrière un meuble ou dans une baie technique.

Choisir le canal Zigbee : le réglage que l’on devrait faire avant d’appairer 80 appareils

Zigbee utilise 16 canaux dans la bande 2,4 GHz, numérotés de 11 à 26. Le Wi-Fi 2,4 GHz occupe la même zone du spectre, avec des canaux beaucoup plus larges. Le but n’est donc pas de trouver un canal Zigbee « magique », mais de réduire le chevauchement avec les réseaux Wi-Fi les plus puissants autour de vous.

Home Assistant recommande généralement les canaux 15, 20 ou 25 pour ZHA afin de limiter les problèmes d’interopérabilité. Lors de la création d’un nouveau réseau, l’option Smart de ZHA scanne les canaux et privilégie justement 15, 20 et 25. Ce scan est effectué à la création : ZHA ne change pas ensuite automatiquement de canal au fil des interférences.

Avant de modifier un réseau Zigbee déjà en production, essayez d’abord de fixer proprement les canaux Wi-Fi 2,4 GHz de vos points d’accès. Changer le canal Zigbee reste possible, mais les appareils sur batterie qui dorment peuvent mettre du temps à recevoir l’information, et certains équipements anciens peuvent nécessiter un nouvel appairage.

Zigbee2MQTT accepte également le changement de canal avec les piles radio compatibles. Sa documentation recommande notamment les canaux 11, 15, 20 ou 25 pour limiter les problèmes avec certains équipements. Sur un réseau existant, un changement de canal doit être préparé et suivi appareil par appareil.

ZHA ou Zigbee2MQTT : la vraie différence est l’architecture

Comparer seulement le nombre d’appareils compatibles ne suffit pas. ZHA et Zigbee2MQTT ne sont pas organisés de la même façon.

Quand ZHA est particulièrement intéressant

ZHA convient très bien à une installation qui privilégie la simplicité et l’intégration native. Le coordinateur, les appareils, la carte réseau, les groupes, le binding, les sauvegardes et la migration sont accessibles directement depuis Home Assistant.

ZHA s’appuie sur la bibliothèque zigpy. Lorsqu’un fabricant ne respecte pas parfaitement les standards Zigbee, des quirks peuvent corriger la manière dont Home Assistant interprète l’appareil. C’est l’équivalent conceptuel des converters spécifiques côté Zigbee2MQTT.

Quand Zigbee2MQTT prend tout son sens

Zigbee2MQTT est très intéressant lorsqu’on veut un accès détaillé aux capacités exposées par les appareils, aux paramètres fabricant, aux rapports, au binding, aux groupes ou à la configuration fine du réseau. Sa base d’appareils est également très pratique avant un achat : on peut vérifier précisément les fonctions exposées par une référence donnée.

En contrepartie, Zigbee2MQTT ajoute deux composants : le service Zigbee2MQTT lui-même et un broker MQTT. Pour comprendre cette architecture et savoir quoi dépanner lorsqu’une entité disparaît, notre article Applications ou intégrations Home Assistant détaille la chaîne complète.

Installer ZHA proprement dans Home Assistant

La procédure actuelle est simple :

1. connecter le coordinateur à la machine Home Assistant ;
2. redémarrer Home Assistant si le matériel n’est pas détecté immédiatement ;
3. ouvrir Paramètres > Connectivité > Zigbee ou Paramètres > Appareils et services selon le contexte ;
4. ajouter Zigbee Home Automation ;
5. sélectionner le coordinateur détecté et créer le réseau ;
6. choisir le canal manuellement ou laisser l’option Smart sélectionner une fréquence appropriée ;
7. n’ouvrir l’appairage qu’au moment où vous êtes prêt à ajouter un appareil.

Une fois ZHA configuré, Home Assistant peut afficher la topologie du réseau. La carte est utile pour repérer les routeurs et les liens, mais il faut éviter d’interpréter un LQI comme une note absolue. Les valeurs RSSI et LQI dépendent du chipset et de la façon dont chaque pile Zigbee les rapporte. Elles sont surtout utiles pour comparer un appareil avec lui-même dans le temps.

Installer Zigbee2MQTT : les briques à ne pas mélanger

Zigbee2MQTT nécessite trois éléments :

• un coordinateur Zigbee compatible ;
• le service Zigbee2MQTT ;
• un broker MQTT, souvent Mosquitto.

Pour que les appareils apparaissent automatiquement dans Home Assistant, l’intégration MQTT doit être active et la découverte Home Assistant doit être activée côté Zigbee2MQTT :

homeassistant:
  enabled: true

mqtt:
  server: mqtt://core-mosquitto:1883
  base_topic: zigbee2mqtt

Le nom du serveur dépend évidemment de votre installation. Sur Home Assistant OS avec l’App Mosquitto, core-mosquitto est un cas courant ; sur Docker, ce sera souvent le nom du conteneur ou son adresse réseau.

Avec un Connect ZBT-2, Zigbee2MQTT documente actuellement l’utilisation du pilote Ember avec un débit de 460800 bauds et le contrôle de flux matériel :

serial:
  adapter: ember
  baudrate: 460800
  rtscts: true

Ce genre de détail est précisément la raison pour laquelle il faut toujours consulter la page de l’adaptateur choisi : deux coordinateurs utilisant tous deux Silicon Labs peuvent ne pas exiger exactement les mêmes paramètres.

Construire un réseau stable : routeurs d’abord, capteurs ensuite

Un réseau Zigbee solide se construit progressivement. La méthode la plus fiable consiste à commencer par le coordinateur, puis installer quelques routeurs alimentés sur secteur dans les zones importantes avant d’ajouter une grande quantité de capteurs sur pile.

Appairer tous les capteurs à 30 cm du coordinateur puis les déplacer à l’autre bout de la maison peut fonctionner, mais certains appareils — notamment certains modèles qui choisissent leur parent de manière conservatrice — peuvent conserver une route médiocre longtemps. Lorsque c’est possible, il est préférable de laisser le maillage principal se former puis d’appairer les appareils à l’endroit où ils seront utilisés.

Zigbee2MQTT permet même de lancer l’appairage via un routeur déterminé. Ce n’est pas une garantie que l’appareil conservera ce parent pour toujours, mais cela peut aider pour certains périphériques difficiles.

Tous les appareils secteur ne sont pas forcément de bons routeurs

La règle « secteur = routeur » est utile pour comprendre Zigbee, mais ce n’est pas une vérité absolue pour chaque produit. Le comportement dépend du firmware et du type d’appareil. Certaines ampoules deviennent par exemple de mauvais maillons si elles sont coupées au mur, car tout le sous-réseau qui passait par elles doit alors se reconstruire.

Pour renforcer un réseau, les prises Zigbee et modules secteur toujours alimentés sont généralement plus intéressants que des ampoules susceptibles d’être mises hors tension physiquement.

Autre erreur fréquente : ajouter dix répéteurs au même endroit près du coordinateur. Un maillage utile se construit dans l’espace. Placez les routeurs là où le réseau doit franchir un étage, un mur porteur ou une grande distance.

Groupes Zigbee et binding : deux fonctions souvent sous-utilisées

Une automatisation Home Assistant qui envoie successivement dix commandes « ON » à dix ampoules n’est pas équivalente à un groupe Zigbee natif. Avec un groupe, une commande peut être diffusée directement au groupe au niveau du réseau Zigbee, ce qui réduit le trafic et améliore la synchronisation visuelle.

Le binding va encore plus loin. Lorsqu’il est pris en charge par les appareils, un bouton ou une télécommande Zigbee peut être lié directement à une lampe ou à un groupe. La commande ne repasse alors pas forcément par Home Assistant.

ZHA et Zigbee2MQTT prennent tous deux en charge les groupes et le binding, sous réserve que les appareils concernés l’acceptent. C’est particulièrement intéressant pour les éclairages principaux : un interrupteur physique peut continuer à fonctionner même pendant une maintenance du serveur domotique.

Appairage : pourquoi un appareil refuse parfois de rejoindre le réseau

Lorsqu’un appareil ne s’appaire pas, le problème vient rarement d’un seul facteur. Procédez dans cet ordre :

1. Réinitialisation usine complète de l’appareil.
2. Vérification qu’il n’est plus associé à une ancienne passerelle.
3. Ouverture temporaire du réseau Zigbee.
4. Appairage à proximité raisonnable d’un bon routeur ou du coordinateur.
5. Maintien de l’appareil éveillé pendant l’interview s’il fonctionne sur pile.
6. Consultation des logs pour vérifier si l’échec se produit au join, à l’interview ou lors de la configuration des clusters.

Sur Zigbee2MQTT, le bouton « Permit join » ouvre par défaut une fenêtre temporaire de 254 secondes. Fermez-la dès que l’appairage est terminé. Il est également possible de n’autoriser l’appairage que via un routeur ou le coordinateur.

Sur ZHA, certains appareils non parfaitement conformes au standard peuvent nécessiter un quirk. Sur Zigbee2MQTT, l’équivalent est généralement un converter. Avant de conclure qu’un périphérique est « incompatible Zigbee », vérifiez toujours la référence exacte — pas seulement la marque commerciale.

Canal, LQI, RSSI : comment lire les indicateurs sans se tromper

RSSI mesure grossièrement la puissance reçue en dBm, alors que LQI est un indicateur de qualité de lien fourni par la pile Zigbee. Les deux peuvent aider au diagnostic, mais ne doivent pas être lus comme un pourcentage universel.

Quelques règles pratiques :

• comparez les valeurs dans votre propre réseau plutôt qu’avec celles d’un autre utilisateur ;
• regardez surtout les appareils qui ont des pertes réelles, pas ceux dont la carte affiche simplement un chiffre faible ;
• un capteur sur pile peut apparaître avec peu de liens sur une carte car il dort ;
• une carte réseau est une photographie imparfaite du routage, pas une représentation permanente de chaque paquet.

La meilleure métrique reste l’usage réel : temps de réponse, appareils indisponibles, nombre de tentatives, pertes après redémarrage ou comportement lors des périodes de forte activité.

Sécurité Zigbee : la clé réseau est sensible

Les communications Zigbee utilisent une clé réseau de 128 bits. Dans Zigbee2MQTT, cette clé se trouve dans la configuration et doit être considérée comme un secret. La documentation recommande de générer une clé aléatoire plutôt que de conserver une ancienne clé par défaut connue.

advanced:
  network_key: GENERATE

Attention : changer la clé réseau d’un réseau existant implique normalement de réappairer tous les appareils. Ce réglage doit donc être décidé à la création du réseau, pas modifié pour « tester » un problème.

Autres bonnes pratiques :

• ne laissez pas le réseau en permit join en permanence ;
• utilisez les install codes lorsqu’un appareil Zigbee 3.0 les prend en charge ;
• ne rendez pas l’interface Zigbee2MQTT ou votre broker MQTT accessible publiquement sans authentification et protection adaptées ;
• sauvegardez votre clé réseau en même temps que le reste de la configuration.

Sauvegarder le réseau avant qu’il ne devienne critique

Une sauvegarde Home Assistant ne remplace pas toujours la sauvegarde du réseau radio lui-même. Avec ZHA, Home Assistant effectue des sauvegardes automatiques du réseau Zigbee et permet aussi d’en créer manuellement. Ces sauvegardes servent notamment à migrer vers un nouveau coordinateur sans devoir réappairer l’ensemble des appareils lorsque la combinaison matérielle est prise en charge.

ZHA peut migrer entre plusieurs familles de radios, notamment Silicon Labs, Texas Instruments et ConBee/RaspBee dans les conditions documentées. L’assistant de migration gère également l’adresse IEEE du coordinateur lorsque c’est nécessaire.

Avec Zigbee2MQTT, la configuration du réseau est répartie entre les fichiers du dossier de données et la mémoire du coordinateur. Le fichier coordinator_backup.json est pris en charge sur les adaptateurs Z-Stack et EmberZNet. La migration entre familles d’adaptateurs peut fonctionner, mais n’est pas garantie dans tous les cas : il faut vérifier la documentation du couple source/destination avant de débrancher l’ancien coordinateur.

Changer de coordinateur sans tout réappairer

La migration est devenue nettement plus simple qu’il y a quelques années, mais il faut distinguer ZHA et Zigbee2MQTT.

Avec ZHA

Home Assistant propose directement Paramètres > Connectivité > Zigbee > Migrer. L’ancien réseau est sauvegardé, le nouvel adaptateur est sélectionné et Home Assistant tente de transférer les paramètres nécessaires. Après la migration, les appareils peuvent mettre plusieurs minutes — parfois jusqu’à environ une heure pour les appareils endormis — à se reconnecter.

Avec Zigbee2MQTT

La migration dépend du type d’adaptateur. Z-Stack et Ember disposent du support de sauvegarde/restore du coordinateur. Passer d’une famille à l’autre peut fonctionner sans réappairage mais Zigbee2MQTT précise que le résultat n’est pas officiellement garanti dans tous les scénarios. Conservez l’ancien matériel intact tant que tous les appareils n’ont pas été vérifiés.

Zigbee2MQTT ou ZHA : quel choix selon votre profil ?

Il n’y a pas de vainqueur universel. Pour un réseau bien conçu, les deux solutions peuvent être rapides et fiables. Le mauvais choix est surtout celui qui ajoute une complexité inutile par rapport à vos besoins.

Zigbee, Matter et Thread : ils peuvent parfaitement cohabiter

Zigbee n’est pas remplacé automatiquement par Matter. Matter est une couche applicative d’interopérabilité ; Thread est l’un des réseaux IP que Matter peut utiliser. Zigbee reste un protocole distinct avec un parc d’appareils énorme, notamment pour les capteurs et commandes à faible consommation.

Le Connect ZBT-2 peut fonctionner en Zigbee ou en Thread, mais Home Assistant recommande de dédier une radio à un seul protocole. Le multiprotocole simultané n’est pas recommandé, car les expériences précédentes avec le ZBT-1 ont montré des problèmes de stabilité. Si vous voulez Zigbee et Thread, la solution la plus propre reste donc de prévoir une radio dédiée à chaque réseau.

Pour aller plus loin, consultez notre dossier sur les protocoles domotiques.

Dépannage : identifier le premier maillon qui casse

Pour un appareil spécifique qui fonctionne mal avec ZHA ou Zigbee2MQTT, notre test du clavier Zigbee frient avec Home Assistant montre bien pourquoi le comportement peut différer selon la pile utilisée. Nous avons aussi testé le capteur Zigbee Tuya ZG-109TDS, utile pour voir ce qu’un périphérique atypique expose réellement dans Home Assistant.

Les erreurs à éviter sur un réseau Zigbee Home Assistant

• Brancher le coordinateur directement sur un port USB 3.0 derrière un mini-PC ou un NAS.
• Appairer 40 capteurs avant d’installer des routeurs dans les zones éloignées.
• Changer de canal au hasard sans regarder les réseaux Wi-Fi 2,4 GHz voisins.
• Couper au mur des ampoules utilisées comme routeurs et s’étonner que des capteurs derrière elles deviennent instables.
• Confondre LQI faible et panne certaine sans observer le comportement réel.
• Laisser Permit Join ouvert en permanence.
• Changer la network_key d’un réseau Zigbee2MQTT existant sans prévoir un réappairage.
• Mettre un coordinateur réseau sur Wi-Fi simplement parce qu’il est plus facile à placer.
• Migrer de coordinateur sans sauvegarde.
• Ajouter Zigbee2MQTT juste « parce que c’est plus avancé » si ZHA répond déjà parfaitement au besoin.

FAQ technique Zigbee + Home Assistant

Peut-on utiliser deux réseaux Zigbee dans la même maison ?

Oui. Chaque réseau doit avoir son propre coordinateur et idéalement un plan de canaux cohérent. Deux réseaux peuvent cohabiter, mais ils partagent la même bande 2,4 GHz avec le Wi-Fi, donc multiplier les réseaux sans raison augmente la complexité radio.

Peut-on utiliser ZHA et Zigbee2MQTT en même temps ?

Oui, à condition d’avoir deux coordinateurs distincts. Un même coordinateur ne peut pas être piloté simultanément par ZHA et Zigbee2MQTT.

Un appareil Zigbee peut-il appartenir à deux coordinateurs ?

Non. Un appareil Zigbee est associé à un seul réseau et un seul coordinateur à la fois. Pour le déplacer vers un autre réseau, il faut généralement le réinitialiser puis le réappairer.

Faut-il Internet pour que Zigbee fonctionne ?

Non. Le réseau Zigbee lui-même est local. Une dépendance Internet peut cependant venir de Home Assistant Cloud, d’une intégration tierce ou d’un appareil utilisant un service cloud en parallèle.

Combien d’appareils peut gérer un coordinateur ?

Il n’existe pas un chiffre universel utile à retenir. La limite pratique dépend du chipset, du firmware, de la pile Zigbee, du nombre de routeurs, de la topologie et du comportement des appareils. Un réseau correctement maillé peut accueillir bien plus de périphériques qu’un réseau où tout tente de joindre directement le coordinateur.

Faut-il mettre tous les appareils Zigbee sur le même canal ?

Oui : tous les appareils d’un même réseau utilisent le canal défini par le coordinateur. Si vous avez plusieurs réseaux Zigbee distincts, ils peuvent utiliser des canaux différents.

Le canal 25 est-il toujours le meilleur ?

Non. Il est souvent intéressant parce qu’il s’éloigne de certaines portions très occupées du Wi-Fi 2,4 GHz, mais l’environnement radio réel et la compatibilité des appareils comptent. Home Assistant recommande généralement 15, 20 ou 25, pas un canal unique dans tous les logements.

Peut-on migrer de ZHA vers Zigbee2MQTT sans réappairer ?

Ce n’est pas une migration officiellement transparente comparable à un simple changement de coordinateur dans ZHA. Les deux piles stockent et interprètent différemment leur configuration. Pour une installation critique, partez du principe qu’un passage de ZHA à Zigbee2MQTT peut nécessiter du travail appareil par appareil.

Notre méthode pour un nouveau réseau Zigbee en 2026

1. Choisir le logiciel : ZHA pour la simplicité, Zigbee2MQTT si ses fonctions avancées sont réellement utiles.
2. Choisir un coordinateur moderne et officiellement pris en charge.
3. Le placer correctement, loin des interférences USB 3.0 et Wi-Fi.
4. Planifier le canal Zigbee avant le gros de l’appairage.
5. Créer d’abord le squelette du mesh avec plusieurs routeurs secteur.
6. Appairer ensuite les capteurs à leur emplacement réel.
7. Créer des groupes Zigbee pour les ensembles d’éclairage.
8. Utiliser le binding lorsque la résilience locale apporte un vrai bénéfice.
9. Fermer l’appairage et sécuriser MQTT / Zigbee2MQTT si utilisés.
10. Faire immédiatement une sauvegarde du réseau et documenter le coordinateur, le canal et les paramètres importants.

Avec cette méthode, le choix ZHA ou Zigbee2MQTT devient presque secondaire. Un réseau Zigbee bien planifié, correctement maillé et sauvegardé est beaucoup plus important qu’une guerre de chapelles entre deux logiciels.