openHABian ou comment installer openHAB en quelques minutes

Introduction

Dans un tutoriel précédent je vous expliquais comment installer manuellement openHAB sous Raspberry.
Article : https://macleod.hfstudio.com/index.php/tutoriels/installer-openhab-2-x-sous-raspberry-3

Ceci est pratique lorsque vous ne souhaitez pas faire de votre Raspberry un élèment entièrement dédié à openHAB (si vous souhaitez avoir la couche Raspbian complète avec les logiciels etc...)
Mais certains d'en vous sont interessés pour une instalaltion rapide d'openHAB.
Après tout, vu le prix des cartes miniSD, pourquoi ne pas se priver d'avoir une microSD avec LibreELEC (Kodi), une autre avec openHAB, etc...
Ou alors vous voulez juste tester très rapidement openHAB sans une installation compliquée.

Pour cela il y a deux solutions :
- via l'utilisation de Docker via un container (https://www.openhab.org/docs/installation/docker.html)
- via l'installation d'openHABian qui fait clé en main une installation d'openHAB à partir d'une carte microSD vierge en quelques minutes car basée sur une image déjà préconfigurée de openHAB avec tous les outils qui vont bien
L'uatre avantage est qu'il tire automatiquement la dernière version stable d'openHAB.

 

Vous avez donc compris l'intérêt de cette méthode.
Notez le lien de la doc officielle d'openHABian ici :https://www.openhab.org/docs/installation/openhabian.html

 

openHABian

 

Introduction
openHAB est un des système de domotique ouvert et gratuit qui existe sur le marché.
Afin de ne pas coomplixifier k'instalaltion d'openHAB et de le rendre le plus possible accessible sil ont créé une image toute prête pour Raspberry
contenant Raspbian et l'outil openHAB déjà installé dessus avec son environnement.
Cela a pour nom openHABian

Documentation
Si vous voulez le détail officiel de l'installation c'est ici :
https://www.openhab.org/docs/installation/openhabian.html

Prérequis
1. Un raspberry de modèle 3 ou 4 avec un minimum de 8 Go en carte SD minimum
2. Un réseau chez vous + une connexion Internet pour télécharger l'image et quelques outils
et c'est tout !!

 

 1. Télécharger le fichier image d'openHABian situé ici :

https://github.com/openhab/openhabian/releases

Actuellement c'est la version openHABian v1.5 qui supporte le Raspberry 4

La taille du fichier image est de environ 280 Mo

C'est un fichier image compressé (donc img.xz) mais l'outil qui suit saura le lire

 

2. Télécharger l'outil Etcher

Cela va vous permettre de mettre en place le fichier image téléchargée précédemment sur votre micro SD 

Aller sur ce site web : https://www.balena.io/etcher/ (l'outil est bien entendu gratuit)

L'installer puis exécuter le programme.

Sélectionner votre image téléchargée en 1)

Sélectionner votre carte micro SD que vous avez relié à votre ordinateur (il se peut que vous aillez besoin d'un adaptateur usb-microsd)

Pour cliquer sur Flash !

tutoriel openhabian1

 

Une fois fini, vous êtes prêt à démarrer openHABian en introduisant votre carte micro-sd dans votre raspberry.

Pensez à avoir un réseau à proximité (wifi) ou reliez votre raspberry à un cable de votre reseau en RJ45.

 

3. Récupération de l'adresse IP

A présent nous allons récupérer l'ip de votre raspberry (sauf si vous la connaissez déjà)

Dans mon cas j'utilise l'outil "Network Scanner" et je trouve l'IP par ce biais

https://play.google.com/store/apps/details?id=com.easymobile.lan.scanner&hl=fr

Par exemple mon raspberry est sur l'adresse ip : 192.168.0.29

 

 

4. Le boot automatique avec son installation

Vous pouvez suivre l'avancement via votre web en allant sur l'IP de votre raspberry.sur un navigateur web

tutoriel openhabian2

 

Dès que openHABian est installé, l'url dira que le site est inaccessible et vous aurez accès à l'URL d'openHAB qui est :

http://votreadresseip:8080

Dans mon cas http://192.168.0.29:8080

L'installation dure environ 15 min (soyez un peu patient ;o)

tutoriel openhabian3

 

Sans hésiter, prendre la version Expert qui est plus complète ! Vous comprendrez pourquoi plus tard (logs dispo, plus d'options, de verbosité....etc)

Attendre un peu…

 

tutoriel openhabian4

Puis vous aurez l'accueil comme ceci :

 

tutoriel openhabian5

 

5. La connexion de votre Raspberry via SSH

Cette partie est importante car elle vous permet - en synthèse - de vous connecter à votre Raspberry via votre PC sans avoir un clavier/ecran etc... relié à votre Raspberry.
L'outil indispensable est Putty en entrant l'IP vue précédemment. (téléchargement possible ici : https://www.putty.org/)

Valider la clé lors de la première connexion.

tutoriel openhabian6

 

Valider par oui puis connectez-vous via le user / password par défaut :

User : openhabian

Password : openhabian

Vous obtiendrez quelque chose comme ceci :

 

tutoriel openhabian7

 

Là beaucoup d'informations sont données dont la version d'openHAB déployée et diverses infos techniques.

Nous allons nous attarder sur la configuration technique d'openHAB.

Pour cela il faut passer la commande sous ssh (putty) :

sudo openhabian-config

 

 

 

tutoriel openhabian8

 

On vous demande de saisir votre password du user openhabian puis on arrive sur le menu de configuration (bas niveau) :

 

tutoriel openhabian9

Voici un détail de quelques menus :

00 : Donne la version précise de l'outil openhabian

01 : vérifie et met à jour à la dernière version de l'outil openHABian tool

02 : Mise à jour du système d'exploitation Raspbian => Il est important d'être à la dernière verision de Raspbian car cela comble souvent des failles de sécurité ou met à jour les packages déjà présents. (l'outil gérera pour vous les A/R d'openHAB lors de cette manipulation)

03 : Met à jour la version openHAB en version la plus stable actuelle. (logiquement vous devriez y être déjà)

10 : Gestion des améliorations (donc non obligatoires mais pratiques !)

 11 installe les outils comme vim etc au cas où besoin…

 12 Les mets à jour si ce n'est pas déjà fait

13 Paramètre les montages des FS pour openHAB

 14 Vérifie et fixe les droits corrects pour les fichiers fréquemment utilisé et touchés ainsi que répertoires

15 Instal let configure FireMotD pratique pour une synthèse et un suivi du programme de gestion lors de connexion SSH

etc...

 

Autres informations qui peuvent être utiles, les commandes principales d'openHAB :

openhab-cli --help

Usage:  openhab-cli command [options]

Possible commands:

  backup [--full] [filename]   -- Stores the current configuration of openHAB.

  clean-cache                  -- Cleans the openHAB temporary folders.

  console                      -- Opens the openHAB console.

  info                         -- Displays distribution information.

  reset-ownership              -- Gives openHAB control of its own directories.

  restore filename             -- Restores the openHAB configuration from a backup.

  showlogs                     -- Displays the log messages of openHAB.

  start [--debug]              -- Starts openHAB in the terminal.

  status                       -- Checks to see if openHAB is running.

  stop                         -- Stops any running instance of openHAB.

 

6. La configuration d'openHABian

 

Sur votre URL d'openHAB allez dans PaperUI.

Puis dans préférences

tutoriel openhabian10

Sélectionnez votre langue.

Attention pour l'initialisation vous n'aurez le choix que entre l'anglais et l'allemand. Plus tard vous pourrez choisir le français ne vous inquiétez pas !

Pour valider, cliquer sur le rond bleu

Allons maintenant plus finement dans la configuration

Aller dans Configuration puis System

Important !! Chaque fois que vous modifierez une partie, des blocs ci-dessous, un petit bouton nommé SAVE va apparaitre, bien cliquer dessus pour prendre en compte vos modifs !!

 

tutoriel openhabian11

  • Accès aux connecteurs du repository d'openHAB, le laisser à ACTIVE
  • Inclure les anciens connecteurs 1.x: évitez sauf si pb de compatibilité pour certains matériels et donc bindings. Laissez à DESACTIVE

tutoriel openhabian12

  • Votre système audio en input = entrée audio (sélectionnez votre cas personnel)
  • Votre système audio en output = sortie audio (sélectionnez votre cas personnel)

tutoriel openhabian13

Les charts sont la représentation graphique qui est donné. Si vous cliquez sur SHOW MORE vous aurez aussi l'échelle

tutoriel openhabian14

L'éphéméride est une nouveauté openHAB 2.5. Il introduit une notion de calendrier propre à chaque pays avec les jours représentant les Week-end, la région (cad l'état quand c'est nécessaire), le pays et… la ville quand une ville à son propre éphéméride…

tutoriel openhabian15

Le INBOX est très important car c'est l'endroit où seront détectés par défaut les objets connectés proches de vous, suivant votre choix d'add-ons ou de connecteurs (bindings)

  • L'auto Ignore est à laisser à ACTIVE car cela permet de de pas redétecter des objets déjà trouvés.
  • L'Auto Approve est à laisser à DESACTIVE car cela permet de de pas valider automatiquement les objets trouvés (on garde le contrôle)

tutoriel openhabian16

L'item Linking est très important car c'est ce qui fait que les canaux des objets sont liés automatiquement à un item en automatique (quand c'est grisé c'est le cas)

En cas de sélection, cela signifie que c'est à vous de gérer les liens (Links) entre les canaux des objets et les items liés à ces canaux.

Quand on débute c'est pratique de l'avoir en grisé. Sinon en mode plus poussé on préférera garder la main :o)

tutoriel openhabian17

 

La Json Storage est le stockage des données de la base qui est très importantes dans openHAB

Donc on laisse par défaut mais sachez que vous pouvez modifier les nom de fichiers sauvegardés, avec les délais d'attente de bascule et les délais d'écriture.

 

tutoriel openhabian18

Le network settings correspond ) la configuration de votre réseau et donc en premier l'adresse IP de votre raspberry afin de définir l'URL d'openhab

(adresse fixe recommandée qu'il est nécessaire de configurer dans votre routeur afin de toujours tomber sur la même IP de votre réseau !

L'utilisation de l'IP v6…Etc…

tutoriel openhabian19

La persistance des informations, afin d'archiver, trier etc… les données récoltées.

Cela fera l'objet d'un tutoriel plus tard car ce sujet est vaste.

Précisez le service utilisé si vous en avez…

tutoriel openhabian20

 

Voici la langue utilisée et le pays d'origine…
Vous pouvez même avec la map définir avec précision votre localisation précise.

Pour terminer :

tutoriel openhabian21

Le Voice est le définition de l'utilisation du texte en parole etc…

Ces règles peuvent être très importantes selon votre installation…

Par défaut ne rien mettre.