Passer ses appareils en Zigbee avec Home Assistant

Les capteurs Zigbee coûtent peu, tiennent des mois sur une pile, et fonctionnent sans Internet ni service de la marque. C'est souvent le meilleur choix pour équiper une maison en capteurs d'ouverture, de mouvement ou de température. Le prix à payer : une antenne à acheter, et quelques règles de placement que presque tout le monde découvre après coup.

Ce guide suppose une installation de Home Assistant qui fonctionne. Le cours Home Assistant au quotidien explique pourquoi choisir Zigbee plutôt que le Wi-Fi ; ici, on le met en place.

Vérifié sur la documentation officielle de Home Assistant en octobre 2026. Les noms d'écrans évoluent d'une version à l'autre : le guide les décrit par leur fonction.

Comment fonctionne un réseau Zigbee

Trois rôles, et un seul est obligatoire :

• le coordinateur : l'antenne branchée sur le serveur. Il crée le réseau, et il n'y en a qu'un ;
• les routeurs : presque tous les appareils branchés sur secteur (prises, ampoules, interrupteurs). Ils relaient les messages des autres et étendent la portée ;
• les appareils terminaux : les objets sur pile (capteurs, télécommandes). Ils économisent leur énergie et ne relaient rien.

Le réseau est maillé : un capteur au fond du jardin parle à la prise du garage, qui parle à l'ampoule de la cuisine, qui parle au coordinateur. Plus on a de routeurs bien répartis, plus le réseau est solide.

flowchart LR
    C["Coordinateur<br/>(antenne sur le serveur)"] --- R1["Prise du salon<br/>routeur"]
    C --- R2["Ampoule de la cuisine<br/>routeur"]
    R1 --- R3["Prise du garage<br/>routeur"]
    R1 --- T1["Capteur de porte<br/>sur pile"]
    R2 --- T2["Capteur de température<br/>sur pile"]
    R3 --- T3["Capteur du jardin<br/>sur pile"]

Étape 1 : choisir l'antenne

La documentation de Home Assistant recommande, pour un nouveau réseau, l'antenne USB officielle (Home Assistant Connect ZBT-2). D'autres antennes testées fonctionnent aussi, notamment certaines clés de grandes marques de la domotique. Deux conseils :

• prenez une antenne explicitement listée comme compatible dans la documentation de l'intégration, plutôt qu'une clé inconnue moins chère ;
• avec une antenne tierce, la mise à jour de son micrologiciel se fait avec l'outil du fabricant, pas depuis Home Assistant.

Étape 2 : la placer, l'étape que tout le monde rate

C'est la cause numéro un des réseaux Zigbee capricieux. Trois règles :

1. Jamais directement sur un port USB 3 (souvent bleu), ni à côté. Ces ports émettent un bruit qui brouille la bande de fréquence de Zigbee. Utilisez un port USB 2, ou un concentrateur USB 2 alimenté.
2. Toujours au bout d'une rallonge USB blindée, d'un mètre environ, pour éloigner l'antenne du boîtier du serveur.
3. Loin du Wi-Fi : à distance de la box et des points d'accès, et pas collée à un mur ou à un appareil électroménager.

Zigbee et le Wi-Fi partagent la même bande de fréquence. En cas de brouillage persistant, la documentation conseille de changer d'abord le canal du Wi-Fi, plutôt que celui de Zigbee.

Étape 3 : ZHA ou Zigbee2MQTT

Deux logiciels savent piloter l'antenne. Il faut en choisir un, et en changer plus tard oblige à réappairer tous les appareils.

• ZHA (Zigbee Home Automation) est l'intégration intégrée à Home Assistant. Rien à installer à côté, une interface dans les réglages, une sauvegarde automatique du réseau, et une migration facile vers une nouvelle antenne.
• Zigbee2MQTT est un logiciel séparé. Il demande en plus un serveur de messages (un « broker » MQTT, généralement Mosquitto), et communique avec Home Assistant par ce biais. Sur Home Assistant OS, les deux s'installent comme des Apps. Il offre une interface propre et un réglage plus fin de chaque appareil.

Le critère qui tranche : vos appareils. Les deux logiciels publient la liste des appareils qu'ils prennent en charge. Si tous les vôtres sont pris en charge par ZHA, prenez ZHA : c'est le plus simple et le plus intégré. Si un appareil qui compte pour vous n'est bien géré que par Zigbee2MQTT, prenez Zigbee2MQTT. Dans le doute, ZHA.

La suite du guide utilise ZHA.

Étape 4 : installer ZHA

1. Branchez l'antenne (avec sa rallonge), puis redémarrez Home Assistant.
2. Le plus souvent, l'intégration est découverte automatiquement et apparaît dans Paramètres, Appareils et services. Sinon, ajoutez l'intégration « Zigbee Home Automation » à la main.
3. Choisissez le port de l'antenne. Préférez le chemin qui contient son identifiant (by-id) : il reste le même même si on change l'antenne de port.
4. Laissez le canal par défaut. Ne le changez pas sans raison précise.

Étape 5 : appairer un appareil

1. Ouvrez la page Zigbee, dans les réglages de connectivité, et choisissez d'ajouter un appareil.
2. Remettez l'appareil en mode usine, selon la notice du fabricant : bouton maintenu enfoncé, ou interrupteur actionné plusieurs fois.
3. Attendez quelques secondes qu'il apparaisse, puis donnez-lui un nom lisible et une pièce.

Appairez chaque appareil à l'endroit où il servira, pas sur le bureau à côté du serveur. Un appareil appairé près du coordinateur puis déplacé garde une mauvaise route dans le réseau. Certaines marques sont capricieuses à l'appairage et demandent plusieurs essais : la documentation cite jusqu'à 10 à 20 minutes pour certains capteurs.

Étape 6 : construire le maillage dans le bon ordre

L'ordre d'installation compte :

1. Les routeurs d'abord : les prises et ampoules sur secteur, réparties dans la maison, en commençant par les plus proches du serveur.
2. Les capteurs sur pile ensuite, chacun appairé à son emplacement définitif, une fois que des routeurs couvrent la zone.

Un capteur au fond du jardin sans aucun routeur entre lui et le serveur se déconnectera régulièrement. Une prise connectée à mi-chemin règle le problème.

Étape 7 : lire la carte du réseau

La page Zigbee propose d'afficher la carte du réseau : chaque appareil, et les liaisons entre eux, avec des indicateurs de qualité. Deux précautions de lecture :

• un capteur sur pile qui dort n'affiche pas toujours ses liaisons : ce n'est pas forcément une panne ;
• les chiffres de qualité sont indicatifs. La vraie mesure, c'est un appareil qui répond ou qui disparaît.

La sauvegarde du réseau

ZHA sauvegarde automatiquement le réseau Zigbee lui-même. Le jour où l'antenne meurt ou où vous en changez, une fonction de migration permet de passer à la nouvelle sans réappairer les appareils. Ces sauvegardes font aussi partie de la sauvegarde générale de Home Assistant : gardez-la active, avec une copie hors du serveur.

Erreurs fréquentes

• Antenne branchée directement sur un port USB 3. Déconnexions aléatoires, que l'on cherche ensuite partout ailleurs.
• Appairer tout sur le bureau, puis déplacer. Les appareils gardent une mauvaise route.
• Un réseau fait uniquement de capteurs sur pile. Ils ne relaient rien : sans routeurs, la portée s'arrête à la pièce du serveur.
• Changer le canal Zigbee au moindre souci. Tous les appareils doivent suivre, et certains ne le font pas. Changer le canal du Wi-Fi d'abord.
• Passer de ZHA à Zigbee2MQTT « pour essayer ». Il faut réappairer chaque appareil. Choisissez une fois, en connaissance de cause.

À retenir

• Un coordinateur, des routeurs sur secteur, des appareils terminaux sur pile.
• Antenne sur rallonge blindée, port USB 2, loin du Wi-Fi.
• ZHA par défaut ; Zigbee2MQTT si un appareil important n'est bien géré que par lui.
• Routeurs d'abord, capteurs ensuite, chacun appairé à son emplacement.

Mini-exercice

Dessinez le plan de votre logement, placez-y le serveur, puis chaque appareil Zigbee que vous avez ou envisagez. Repérez les zones où un capteur sur pile n'aurait aucun appareil sur secteur à proximité : c'est là qu'il faudra une prise connectée pour servir de relais.