Problème
Un appareil Zigbee, le plus souvent un capteur sur pile, fonctionne quelques heures ou quelques jours, puis passe en « indisponible » dans Home Assistant, revient tout seul ou après une manipulation, et recommence. Ce n'est pas une panne ponctuelle mais une instabilité qui se répète : le signe d'un réseau Zigbee fragile plutôt que d'un appareil défectueux. Que le réseau soit géré par ZHA, l'intégration Zigbee de Home Assistant, ou par Zigbee2MQTT, les causes sont les mêmes : une antenne brouillée, un Wi-Fi qui occupe la même bande de fréquence, un capteur trop loin de tout relais, une pile faible, ou un appareil qui s'entend mal avec les relais d'une autre marque. Pour un appareil quelconque devenu indisponible une seule fois, la fiche « Home Assistant : un appareil est indisponible » est le bon point de départ ; celle-ci traite le cas Zigbee qui revient sans cesse.
Solution recommandée
Corriger le réseau avant de toucher à l'appareil, en commençant par le plus simple. La cause la plus fréquente est l'antenne elle-même : branchée directement sur un port USB 3 ou collée au boîtier du serveur, elle est brouillée et perd des messages au hasard. Une rallonge USB blindée, sur un port USB 2, règle à elle seule une bonne partie des cas. Viennent ensuite le Wi-Fi, qui partage la bande des 2,4 GHz avec Zigbee, puis le maillage : un capteur sur pile ne relaie rien et doit avoir un appareil sur secteur (prise, ampoule) à portée pour joindre l'antenne. Réappairer l'appareil n'arrive qu'à la fin, une fois le réseau assaini : réappairé dans un réseau qui reste brouillé, il se déconnectera de nouveau.
Matériel & outils
L'interface de Home Assistant (la page Zigbee des réglages de connectivité pour ZHA, ou l'interface de Zigbee2MQTT), la carte du réseau Zigbee, une rallonge USB blindée d'environ un mètre, une pile neuve du bon modèle, l'interface d'administration de la box ou du point d'accès Wi-Fi, une prise connectée Zigbee pour servir de relais
Étapes
1. Noter quels appareils se déconnectent et où ils se trouvent. Un seul capteur : la cause est probablement locale (pile, distance). Plusieurs appareils dispersés dans la maison : regarder d'abord l'antenne et le Wi-Fi, étapes 3 et 4 2. Changer la pile du capteur, même si le niveau affiché semble correct. Une pile faible fait chuter la tension au moment d'émettre, et la documentation de ZHA signale que certains appareils sur pile posent problème quand leur tension baisse. Prendre une pile neuve du modèle exact 3. Vérifier l'antenne Zigbee. Elle ne doit pas être branchée directement sur un port USB 3 (souvent bleu) ni juste à côté, car ces ports brouillent la bande de Zigbee. La brancher sur un port USB 2, au bout d'une rallonge USB blindée, et l'éloigner du boîtier du serveur, des disques durs et des murs. Attendre un jour ou deux pour juger : le réseau se réorganise de lui-même 4. Éloigner l'antenne de la box et des points d'accès Wi-Fi. Si les déconnexions continuent, changer le canal du Wi-Fi 2,4 GHz dans la box pour l'écarter du canal Zigbee, plutôt que changer le canal Zigbee : la documentation de ZHA recommande de laisser le canal Zigbee par défaut, car tous les appareils doivent suivre un changement et certains ne le font pas 5. Ouvrir la carte du réseau Zigbee (dans ZHA, depuis la page Zigbee des réglages de connectivité ; dans Zigbee2MQTT, depuis son interface) et repérer par quel relais passe le capteur. Ne pas se fier aux seuls chiffres de qualité de liaison (LQI) : la documentation de ZHA les juge difficiles à interpréter et parfois trompeurs. Un capteur sur pile qui dort peut aussi apparaître sans liaison sans être en panne : le vrai test est de savoir s'il continue de remonter ses changements d'état 6. Si aucun appareil sur secteur ne se trouve entre le capteur et l'antenne, en ajouter un : une prise connectée Zigbee à mi-chemin sert de relais. Les appareils sur pile ne relaient jamais rien ; seuls les appareils branchés sur secteur le font, et presque tous le font 7. Vérifier la compatibilité de marque. La documentation de ZHA indique que certains appareils ne fonctionnent pas bien avec les relais de certaines autres marques, en citant notamment des capteurs Xiaomi et Aqara avec des relais d'autres fabricants. Si le capteur instable passe toujours par le même relais d'une autre marque, ajouter un relais réputé compatible près de lui, ou essayer de le faire passer par un autre 8. Pour un capteur qui ne change presque jamais d'état, une porte rarement ouverte par exemple, vérifier qu'il n'est pas simplement jugé inactif : ZHA considère comme indisponible un appareil sur pile resté silencieux trop longtemps, et ce délai se règle dans les options de l'intégration 9. En dernier recours seulement, une fois l'antenne, le Wi-Fi et le maillage corrigés, réappairer le capteur à son emplacement définitif, pas à côté du serveur. Noter avant les automatisations et tableaux de bord qui l'utilisent, au cas où le nom de ses entités changerait
Coût estimé
De 0 à 30 € environ. Une rallonge USB blindée coûte quelques euros, une pile de capteur aussi. Une prise connectée Zigbee pour servir de relais coûte de l'ordre de 10 à 20 €.
Limites
Ne couvre ni Z-Wave ni Matter, dont les réseaux fonctionnent autrement. Ne traite pas la mise à jour ou le changement du micrologiciel de l'antenne, ni le passage de ZHA à Zigbee2MQTT, qui oblige à réappairer tous les appareils. Ne résout pas un appareil réellement défectueux ou un modèle mal pris en charge par l'intégration : la liste des appareils compatibles de ZHA et de Zigbee2MQTT le dit, et seul un remplacement règle alors le problème. Les noms d'écrans évoluent d'une version de Home Assistant à l'autre : la fiche les décrit par leur fonction.
Erreurs fréquentes
Réappairer le capteur sans avoir corrigé le placement de l'antenne : il revient, fonctionne un jour ou deux, puis se déconnecte de nouveau, puisque la cause, une antenne brouillée sur un port USB 3 ou collée au serveur, est toujours là. Changer le canal Zigbee au premier souci au lieu du canal Wi-Fi, et perdre en route des appareils qui ne suivent pas le changement. Réappairer le capteur sur le bureau à côté du serveur puis le remettre à sa place : il garde une route qui ne correspond plus à son emplacement. Ajouter des capteurs sur pile en pensant renforcer le réseau, alors qu'ils ne relaient rien. Juger un correctif au bout d'une heure, alors qu'un réseau Zigbee met du temps à se réorganiser.
Alternatives
Pour monter un réseau stable dès le départ, le guide « Passer ses appareils en Zigbee avec Home Assistant » détaille le choix et le placement de l'antenne et l'ordre d'installation, routeurs d'abord. Pour un appareil indisponible d'une autre technologie, ou une seule fois, voir la fiche « Home Assistant : un appareil est indisponible ». Une automatisation peut aussi prévenir quand un capteur important devient indisponible, pour repérer la fréquence des coupures et juger si un correctif a marché.
Besoin d'un accompagnement personnalisé ?
Cours 1:1, conseil de solution, ou simplement une question précise - contacte-moi directement.