6.7 Le terminal HassOS et la console Home Assistant

En général, il n'est pas nécessaire d'accéder au terminal HassOS. Tout se fait via la page Web de votre Home Assistant ou via l'application mobile avec une des adresses données ici.

Cependant, plusieurs opérations intéressantes peuvent être réalisées dans le terminal HassOS, par exemple accéder au système de fichiers complet sur le Raspberry Pi ainsi qu'aux utilitaires fournis par le système d'exploitation.

Dans cette fiche :

• Console Home Assistant vs Terminal HassOS
  • Branchement avec clavier et écran
  • Branchement SSH
• Console Home Assistant
  • Quelques commandes utiles
  • Passer de la console Home Assistant au terminal HassOS
• Terminal HassOS
  • Quelques commandes utiles
  • Effectuer une commande Home Assistant dans terminal HassOS
  • Passer du terminal HassOS vers la console Home Assistant

Console Home Assistant vs Terminal HassOS

La console Home Assistant et le terminal HassOS sont deux environnements en ligne de commande qui vous permettent d'effectuer différentes opérations sur le Raspberry Pi et sur Home Assistant.

Attention : aucun code d'accès n'est demandé pour accéder à la console Home Assistant ou au terminal HassOS à partir d'un clavier et d'un écran branchés directement sur le Raspberry Pi.

Donc, quiconque a accès physique au Pi pourra contrôler le système!

Branchement avec clavier et écran

Si vous branchez un clavier et un écran au Raspberry Pi, vous verrez à l'écran la console Home Assistant.

Les détails de la console Home Assistant sont donnés plus bas.

Branchement SSH

Si vous vous connectez au Pi via SSH, vous accédez directement au Terminal HassOS.

Les détails du Terminal HassOS sont donnés plus bas.

Console Home Assistant

La console Home Assistant permet d'entrer des commandes propres à Home Assistant.

On l'appelle aussi Home Assistant Command Line Interface ou Home Assistant CLI.

Elle se reconnaît à l'invite ha >.

Cette console vous donne accès à certaines commandes spécialisées pour Home Assistant.

Entrez la commande help pour avoir la liste des commandes disponibles.

Quelques commandes utiles

Voici quelques commandes Home Assistant utiles.

• banner (pour faire afficher l'écran d'accueil avec les adresses IP)
• login (pour passer au terminal HassOS)
• network info (informations sur le réseau)
• info (pour connaître la version de différentes couches de Home Assistant)
• core restart (pour redémarrer seulement le coeur de Home Assistant)
• core update (pour mettre à jour le coeur de Home Assistant)
• core check (pour vérifier l'état du coeur de Home Assistant)
• backups new --name nomdubackup (pour effectuer une sauvegarde de Home Assistant)

Pour plus de détails : https://www.home-assistant.io/common-tasks/os/

Passer de la console Home Assistant au terminal HassOS

Pour accéder au terminal HassOS à partir de la console Home Assistant, entrez la commande login.

Aucun code d'usager ni mot de passe ne vous sera demandé.

Terminal HassOS

Le terminal HassOS est un terminal Linux. 

Les commandes qui y sont disponibles sont passablement différentes de celles qui sont disponibles sur d'autres distributions Linux puisque HassOS est un système d'exploitation optimisé pour Home Assistant.

Le terminal HassOS se reconnaît à l'invite #.

HassOS utilise l'interpréteur de commande /bin/ash.

Selon Wikipédia¹ :

Almquist shell (aussi connu sous le nom de A Shell ou ash) est un interpréteur de commandes dérivé du Bourne shell du Système V Release 4 (SVR4), développé à l'origine par Kenneth Almquist. C'est un Shell Unix petit, rapide et compatible avec la norme POSIX, et c'est pourquoi il est très utilisé dans les systèmes d'exploitation embarqués.

Pour connaître la liste des commandes disponibles :

Quelques commandes utiles

Voici quelques commandes utiles à effectuer sur le terminal HassOS :

• ls, cp, mv, rm, mkdir (commandes habituelles pour gérer fichiers et dossiers)
• halt (pour arrêter complètement le système)
• date (pour connaître ou ajuster la date du système d'exploitation)
• journalctl (pour voir les messages enregistrés dans un fichier journal donné)
• vi (pour éditer un fichier)
• nmcli con show (pour voir les informations sur les connexions réseau)
• ssh -V (pour connaître le nom du serveur SSH et sa version)
• docker ps (pour afficher la liste des conteneurs Docker)
• lsusb (pour voir si la clé USB Z-Wave est reconnue)

Effectuer une commande Home Assistant dans terminal HassOS

Si vous êtes dans le terminal HassOS et que vous désirez entrer une commande spécifique à Home Assistant, il est possible de le faire sans sortir du terminal HassOS.

Il suffit de faire précéder la commande par ha.

Le même résultat serait obtenu dans la console Home Assistant comme suit :

Passer du terminal HassOS vers la console Home Assistant

Si vous souhaitez retourner à la console Home Assistant alors que vous travaillez directement sur le Raspberry Pi à l'aide d'un clavier et d'un écran, vous pouvez entrer cette commande :

Dans le cas où vous êtes branchés via SSH, la commande exit mettra fin à la session SSH.

Source

1. « Almquist shell ». Wikipédia. https://fr.wikipedia.org/wiki/Almquist_shell

Pour plus d'information

« Common tasks - Operating System ». Home Assistant. https://www.home-assistant.io/common-tasks/os/