6.21 Liste de vérification pour Home Assistant

Vous n'arrivez pas à accéder à l'interface Web de Home Assistant? Ou le système a des comportement erratiques? Je vous propose une liste de vérifications pour cerner le problème.

Le Raspberry Pi a-t-il accès à internet?

Pour vérifier si le Raspberry Pi a accès à internet, ouvrez le terminal Linux HassOS puis entrez cette commande :

Si le Pi a du réseau :

Si le Pi n'a pas accès au réseau :

Pistes de solution :

• Le câble réseau est-il fonctionnel? Suggestion : branchez votre ordinateur par câble puis désactivez le Wi-Fi sur votre ordinateur. Si l'ordinateur a toujours accès au réseau, utilisez le même câble pour brancher le Pi.
• Le port sur le commutateur réseau est-il fonctionnel?
• Le réseau en tant que tel est-il fonctionnel? 
• Les configurations d'accès au réseau (câblées ou sans fil) sont-elles bien réalisées? Voir plus bas comment le vérifier.

Le raspberry Pi a-t-il accès à un serveur DNS

Un serveur DNS est requis pour transformer les adresses du genre google.com ou time.cloudflare.com en leur adresse IP.

Pour vérifier si le Pi a accès à un serveur DNS, ouvrez le terminal Linux HassOS puis entrez cette commande :

Si le Pi a accès à un serveur DNS :

Si le Pi n'a pas accès au réseau :

Pistes de solution :

• Les configurations d'accès au réseau sont-elles bien réalisées? Voir plus bas comment le vérifier. 

L'ordinateur est-il capable de rejoindre le Raspberry Pi?

Pour accéder à l'interface Web de Home Assistant, l'ordinateur et le Pi doivent se « voir » dans le réseau.

Pour le vérifier, ouvrez une fenêtre Terminal sur votre ordinateur et entrez cette commande en remplaçant 192.168.1.145 par l'adresse IP du Pi :

Si l'ordinateur réussit à rejoindre l'adresse du Pi :

Si l'ordinateur ne réussit pas à rejoindre l'adresse du Pi :

Pistes de solution :

• Assurez-vous que le Pi a accès à internet (voir plus haut).
• Assurez-vous que le Pi et l'ordinateur sont sur le même réseau.

Est-ce que vous tentez d'accéder au bon Home Assistant?

Pour accéder à l'interface Web de Home Assistant, il est possible d'utiliser l'URL http://homeassistant.local:8123 ou encore http://homeassistant:8123. Ceci est pratique puisque vous n'avez pas besoin de connaître l'adresse IP du Raspberry Pi.

Cependant, dans un environnement qui comprend plusieurs installations de Home Assistant, par exemple une salle de classe, une telle adresse ne vous garantit pas que vous vous connecterez au bon Raspberry Pi.

Vous devez alors utiliser un URL qui contient l'adresse IP du Pi que vous souhaitez rejoindre. L'adresse sera au format http://192.168.1.145:8123 , où 192.168.1.145 sera remplacé par l'adresse IP du Pi.

Les configurations d'accès au réseau sont-elles bien réalisées?

Si le Raspberry Pi est branché au réseau à l'aide d'un câble RJ-45, qu'il n'a pas besoin d'adresse IP statique ni de serveur DNS spécifique, vous n'avez pas besoin de configurer l'accès au réseau.

Dans le cas contraire, les configurations d'accès au réseau peuvent être réalisées à l'aide d'une clé USB branchée au Raspberry Pi lors du démarrage.

Elles peuvent également être réalisées au terminal HassOS ou encore via l'interface Web.

Une fois les configurations réalisées, que ce soit à l'aide d'une clé USB, au terminal ou via l'interface Web, elles sont stockées dans des fichiers que vous retrouverez dans le dossier /etc/NetworkManager/system-connections.

Si vous avez configuré un accès au réseau et que vous ne retrouvez pas de fichiers à cet endroit :

• Si vous avez créé les configurations à l'aide d'une clé USB, est-ce que la clé porte le nom CONFIG en majuscules?
• Si vous avez créé les configurations à l'aide d'une clé USB, est-ce que la clé a été formatée en FAT32?
• Si vous avez créé les configurations à l'aide d'une clé USB, est-ce que le fichier de configuration était dans un sous-dossier nommé network?

Éditer les configurations

Vous pouvez afficher leur contenu à l'aide de la commande cat et les éditer à l'aide de l'éditeur vi, un proche parent de l'éditeur vim.

Pour éditer un fichier avec vi :

À son ouverture, vi vous place en mode commande. Pour passer d'un mode à l'autre :

• en mode commande : la lettre i vous place en mode insertion, ce qui permet d'éditer le texte
• en mode insertion : Échap vous place en mode commande

Pour enregistrer le document puis fermer l'éditeur : Échap suivi de : w q (ce qui signifie Write and Quit).

Pour fermer l'éditeur sans enregistrer : Échap suivi de : q !.

Travailler avec plusieurs configurations

Plusieurs configurations peuvent co-exister, par exemple une pour le réseau câblé et une pour le réseau sans fil ou encore, si vous déplacez le Raspberry Pi pour effectuer des tests, une pour le travail et une pour la maison.

S'il y a plusieurs configurations, vérifiez ceci :

• Est-ce que chaque configuration est placée dans un fichier qui lui est propre (ex : my-network-sansfil et my-network-rj45)?
• Est-ce que chaque configuration a son propre UUID?

Autres vérifications

• Pour la ou les configurations, est-ce que la ligne id contient EXACTEMENT le nom du fichier? Par exemple, pour le fichier my-network-sansfil, on aura :
  Fichier my-network-sansfil

  [connection]
  id=my-network-sansfil
  ...

• Si la version du Raspberry Pi est inférieure à 4 et que vous souhaitez utiliser une connexion Wi-Fi, est-ce que les configurations réseau sont faites pour un Wi-Fi 2.4 GHz.
• Si une adresse IP statique a été donnée au Raspberry Pi, est-ce que cette adresse est compatible avec le réseau? Par exemple, une adresse statique du genre 192.168.1.145 ne fonctionnera pas si le réseau fonctionne avec des adresses du genre 10.0.0.xxx.

  Si l'adresse est incompatible, vous avez deux options :

  • la modifier pour une adresse compatible

    ou

  • configurer l'accès au réseau pour qu'il laisse le serveur DHCP fournir l'adresse IP.
    Fichier my-network

    ...
    [ipv4]
    method=auto

• Si le réseau nécessite un serveur DNS spécifique, est-ce qu'il a été bien configuré?
  Fichier my-network

  ...
  [ipv4]
  ...
  dns=xxx.xxx.xxx.xxx;8.8.8.8;8.8.4.4;

Date du système

La date du système se synchronise automatiquement avec un service NTP (protocole de diffusion du temps en réseau ou, en anglais, Network Time Protocol).

Si ce service ne réussit pas à faire son travail, ceci pourrait compromettre le bon fonctionnement de Home Assistant.

Pour vérifier la date du système, ouvrez le terminal HassOS puis entrez la commande date. La date sera affichée au format UTC.

La date et l'heure peuvent également être affichés dans l'interface Web de Home Assistant à l'aide d'une configuration time_date.

Si la date n'est pas correctement synchronisée, effectuez les vérifications suivantes :

• Le Pi a-t-il accès à un serveur DNS? Voir plus haut pour le vérifier.
• Tentez une réinitialisation à l'aide de la commande ha core restart.