Guide pratique · 9 min
Appareil Zigbee indisponible dans Home Assistant : diagnostic ZHA
Diagnostiquer un appareil Zigbee indisponible dans Home Assistant avec ZHA : alimentation, portée, routeurs, interférences, commandes et remontées d'état.
Distinguer une panne isolée d'une panne du réseau
Commencez par ouvrir l'intégration ZHA dans Paramètres, Appareils et services. Si le coordinateur et la majorité des appareils répondent, le problème concerne probablement l'équipement indisponible, son alimentation ou son chemin radio. Si plusieurs appareils deviennent indisponibles en même temps, contrôlez d'abord le coordinateur et le service ZHA.
Ne supprimez pas immédiatement l'appareil. Une suppression suivie d'un nouvel appairage peut effacer son nom, ses automatisations et son historique sans corriger la cause réelle.
Vérifier alimentation, distance et dernier état
Pour un appareil sur pile, remplacez la pile si sa tension est douteuse, puis réveillez-le selon la procédure du fabricant. Pour un appareil alimenté sur secteur, vérifiez qu'il est réellement sous tension et qu'aucun interrupteur mural ne coupe son alimentation.
Rapprochez temporairement l'appareil du coordinateur ou d'un routeur Zigbee alimenté en permanence. Un retour immédiat à proximité indique généralement un défaut de couverture plutôt qu'une incompatibilité ZHA.
Tester la communication dans les deux sens
Depuis la fiche de l'appareil, envoyez une commande simple comme allumer une lampe ou changer un niveau. Vérifiez ensuite qu'un état, une température ou un compteur remonte vers Home Assistant. Une commande réussie sans retour d'état peut révéler un entretien incomplet de l'appareil ou une liaison instable.
Consultez l'activité de l'appareil et les journaux ZHA. Notez l'heure exacte du dernier échange avant de relancer quoi que ce soit : elle aide à distinguer une panne permanente d'une perte intermittente.
Renforcer le maillage sans multiplier les changements
Ajoutez si nécessaire un routeur Zigbee alimenté sur secteur entre le coordinateur et la zone faible. Les ampoules, prises et modules encastrés ne jouent pas tous le même rôle selon leur firmware : vérifiez qu'ils apparaissent réellement comme routeurs dans votre réseau.
Éloignez le coordinateur des ports USB 3, points d'accès Wi-Fi et boîtiers métalliques. Avant de changer de canal Zigbee, mesurez l'environnement et préparez une procédure de migration, car certains appareils devront être réveillés ou réappairés.
Réappairer seulement après les contrôles réversibles
Si l'appareil reste indisponible, lancez l'ajout d'un appareil dans ZHA et remettez l'équipement en mode appairage sans le supprimer au préalable. De nombreux appareils rejoignent de nouveau le réseau en conservant leur fiche et leurs automatisations.
Après le retour, testez une commande et une remontée d'état, puis observez le comportement pendant plusieurs heures. Une réparation n'est confirmée que si la communication reste stable dans l'emplacement final.
Questions fréquentes
Faut-il supprimer un appareil Zigbee indisponible ?
Non, pas en premier recours. Vérifiez alimentation, portée, coordinateur et journaux, puis tentez un nouvel appairage sans suppression lorsque l'appareil le permet.
Pourquoi un appareil sur pile ne répond-il pas immédiatement ?
Les appareils sur pile dorment pour économiser l'énergie. Réveillez-les selon la procédure du fabricant avant de conclure à une perte de connexion.
Une prise Zigbee améliore-t-elle toujours le réseau ?
Pas systématiquement. Un équipement alimenté sur secteur peut agir comme routeur, mais son rôle et sa qualité de routage dépendent de son matériel et de son firmware.
Quand faut-il changer le canal Zigbee ?
Seulement après avoir identifié une interférence durable et préparé la migration. Commencez par le placement du coordinateur et l'ajout raisonné de routeurs.
