Polarys

Home Assistant : un appareil est indisponible

Une lampe ou un capteur affiche « indisponible » dans Home Assistant : savoir si c'est l'appareil, le réseau, l'intégration ou le serveur, et le faire revenir.

Informations vérifiées en . Ce contenu cite des éléments qui évoluent : vérifiez auprès de la source avant toute décision engageante.

Problème

Dans Home Assistant, un appareil ou l'une de ses entités affiche « indisponible » (unavailable en anglais) au lieu de son état habituel. La tuile est grisée, la commande ne répond plus, et les automatisations qui en dépendent ne se déclenchent plus. Cet état veut dire une chose précise : Home Assistant n'arrive pas à joindre l'appareil ou le service, ou l'intégration qui le gère n'est pas chargée. Il ne faut pas le confondre avec « inconnu » (unknown), qui signifie seulement que l'appareil n'a pas encore donné de valeur, souvent juste après un redémarrage.

Solution recommandée

Chercher de quel côté se trouve la panne avant de toucher à quoi que ce soit, en partant de l'appareil pour remonter vers le serveur. Si un seul appareil est indisponible, la cause est presque toujours de son côté : courant, pile, distance, adresse réseau. Si tous les appareils d'une même marque ou d'une même intégration le sont en même temps, la cause est l'intégration : elle a perdu sa connexion, ou elle demande de se reconnecter. Si tout est indisponible, c'est le serveur ou le réseau de la maison. Dans la plupart des cas, l'appareil revient sans le supprimer, et c'est ce qu'il faut viser : le supprimer puis le réajouter casse les automatisations et les tableaux de bord qui s'en servent.

Matériel & outils

L'interface de Home Assistant (Paramètres, Appareils et services), l'application d'origine de l'appareil si elle existe, l'interface d'administration de la box pour retrouver les adresses des appareils, une pile de rechange pour les capteurs sans fil

Étapes

1. Regarder combien d'appareils sont touchés. Un seul : suivre les étapes 2 à 5. Tous ceux d'une même intégration : passer à l'étape 6. Absolument tout : passer à l'étape 9 2. Vérifier l'appareil lui-même : est-il branché, allumé, la prise murale n'a-t-elle pas été coupée par un interrupteur ? Pour un capteur sur pile, regarder le niveau de batterie dans sa fiche, puis changer la pile en cas de doute : c'est la cause la plus fréquente 3. Tester l'appareil dans sa propre application, si la marque en propose une. S'il ne répond pas non plus là, le problème vient de l'appareil ou du réseau, pas de Home Assistant 4. Pour un appareil en Wi-Fi, vérifier dans la box qu'il est connecté, et que son adresse n'a pas changé. Une box qui redistribue les adresses peut en donner une nouvelle à l'appareil, et certaines intégrations continuent de l'appeler à l'ancienne. Réserver une adresse fixe à l'appareil dans la box règle le problème durablement 5. Pour un appareil sans fil à antenne (Zigbee, Z-Wave), le rapprocher du serveur ou d'un autre appareil branché sur secteur, qui sert de relais. Un capteur placé derrière un mur épais ou dans un boîtier métallique perd souvent le contact 6. Ouvrir Paramètres, puis Appareils et services, et chercher l'intégration concernée. Une intégration en erreur ou qui demande une nouvelle connexion y est signalée, souvent avec un bouton pour se reconnecter : un mot de passe changé ou une session expirée du côté de la marque en est la cause habituelle 7. Depuis le menu de l'intégration, la recharger. Cela relance sa connexion sans redémarrer tout Home Assistant, et suffit souvent après une coupure du service de la marque 8. Si l'intégration reste en erreur, lire Paramètres, puis Système, puis Journaux, en cherchant le nom de l'intégration. Le message dit en général ce qui manque : un mot de passe refusé, un appareil introuvable, un service de la marque en panne 9. Si tout est indisponible, vérifier que le serveur tourne et que le réseau de la maison fonctionne. Redémarrer Home Assistant seulement à ce stade, et attendre la fin complète du démarrage avant de conclure : les entités passent par « indisponible » ou « inconnu » pendant quelques minutes, c'est normal 10. En dernier recours seulement, retirer l'appareil puis le rajouter. Noter avant les automatisations, scripts et tableaux de bord qui l'utilisent : il faudra les corriger si le nom de ses entités change

Coût estimé

0 € dans la grande majorité des cas. Une pile de capteur coûte quelques euros. Un appareil sans fil trop éloigné peut demander l'achat d'un appareil sur secteur qui servira de relais, de l'ordre de 10 à 20 €.

Limites

Ne couvre pas un appareil réellement en panne, ni une marque qui a fermé son service en ligne : dans ce cas, l'appareil ne reviendra pas, et seul un appareil compatible en local évite que cela se reproduise. Ne traite pas le détail des réseaux Zigbee ou Z-Wave instables, ni les intégrations installées depuis la communauté, dont le fonctionnement varie de l'une à l'autre. Ne remplace pas la documentation de l'intégration concernée, qui décrit ses pannes propres.

Erreurs fréquentes

Supprimer l'appareil et le réajouter dès la première panne : il revient souvent avec des noms d'entités différents, et toutes les automatisations qui l'utilisaient cessent de fonctionner en silence. Redémarrer Home Assistant à répétition, sans laisser au démarrage le temps de finir, et prendre l'état « indisponible » transitoire pour une panne. Confondre « inconnu » et « indisponible » : le premier se résout souvent tout seul, le second demande d'agir. Chercher la panne dans Home Assistant alors que l'appareil ne répond pas non plus dans sa propre application.

Alternatives

Pour éviter que la panne se reproduise : préférer des appareils qui fonctionnent en local plutôt que par le service en ligne de la marque, réserver une adresse fixe à chaque appareil Wi-Fi dans la box, et ajouter quelques appareils sur secteur pour consolider un réseau Zigbee. Une automatisation peut aussi vous prévenir quand un appareil important devient indisponible, au lieu de le découvrir le soir où il manque.

Besoin d'un accompagnement personnalisé ?

Cours 1:1, conseil de solution, ou simplement une question précise - contacte-moi directement.

À lire ensuite

Sur le même thème, pour aller plus loin.