Tutoriel Paramètrer le HA-Bridge avec Amazon Alexa sous Raspberry Pi

Informations :

Partons du principe que vous avez un Raspberry Pi (2/3/0) avec l’OS installé dessus et connecté à votre réseau.

Attention, la configuration que nous vous donnons est pour un Raspberry Pi « vierge », c’est-à-dire sans Jeedom installé dessus. À l’heure actuelle  nous n’avons pas trouvé de moyen d’installer Jeedom et Ha-Bridge sur le même matériel sans mettre nos installations Jeedom en vrac…

Installation :

 

1. Créez un dossier HA-Bridge :

mkdir ha-bridge

2. Rentrez dans le dossier :

cd ha-bridge

3. Téléchargez la dernière version depuis le github (à ce jour 5.2.1).

Allez vérifier :

wget https://github.com/bwssytems/ha-bridge/releases/download/v5.2.1/ha-bridge-5.2.1.jar

4. Vous pouvez dès à présent lancer et faire joujou avec le HA bridge en lancant la commande :

sudo java -jar ha-bridge-5.2.1.jar

Accédez ensuite à l’adresse de votre Raspberry Pi par un navigateur Internet :

5. Les dernières versions de Linux utilisent un système pour encapsuler les services qui démarrent en même temps que le Raspberry (ou le PC) ce qui en gros veut dire que si vous n’ajoutez pas dans la « capsule » le HA-Bridge au prochain reboot de votre Raspberry Pi, HA-Bridge ne démarrera pas en même temps…

Voici la marche à suivre traduite rapidement en français (la source vient du GitHub de HA-BRIDGE).

En premier, créez le fichier HA-Bridge dans le système :

cd /etc/systemd/system
sudo nano ha-bridge.service

Copiez puis collez le texte suivant dans la page qui s’ouvre :

[Unit]
Description=HA Bridge
Wants=network.target
After=network.target

[Service]
Type=simple

WorkingDirectory=/home/pi/ha-bridge
ExecStart=/usr/bin/java -jar -Dconfig.file=/home/pi/ha-bridge/data/habridge.config /home/pi/ha-bridge/ha-bridge-5.2.1.jar

[Install]
WantedBy=multi-user.target

Sauvegardez le fichier avec CTL-X puis O pour confirmer et enfin la touche Entrée.

Rechargez le fichier « system » pour qu’il prenne en compte notre modification

sudo systemctl daemon-reload

Pour démarrer HA-Bridge :

sudo systemctl start ha-bridge.service

Pour l’ajouter au démarrage du Raspberry (ce qui est notre but) :

sudo systemctl enable ha-bridge.service

 

Si vous souhaitez consulter la version originale, rendez-vous sur Github.

Pour vérifier que tout s’est bien passé, faîtes un reboot de votre Raspberry Pi.

sudo reboot

Au bout de quelques minutes, vous devez pouvoir de nouveau accéder à la page web avec l’adresse ip de votre Raspberry.

La configuration

Bon, c’est bien sympa d’avoir passé 3 heures à configurer le Raspberry Pi, mais ça ne fait pas fonctionner nos loupiotes cette histoire…

Nous allons donc reprendre la configuration d’un de nos interrupteurs que nous avons installé précédemment (voir le tuto sur l’installation de matériel).

Le HA-Bridge finalisation des réglages :

Rendez-vous dans l’onglet « Bridge Control ».

Vérifiez que « UPNP IP Address » et « WEB Server IP Address » sont bien remplis avec l’ip du Raspberry Pi (ne modifiez que cela) :

Ajout d’un nouveau périphérique :

Jeedom nous propose une fonction fantastique : la génération automatique d’URL pour nos périphériques, cela vous évitera de « sniffer » (pas la colle, hein?) les trames pour récupérer les commandes et ajouter l’interrupteur Xiaomi de tout a l’heure.

Ensuite, sélectionnez votre interrupteur et allez dans l’onglet « Commandes ». Ici, vous allez cliquer sur la petite roue crantée, puis sur la ligne On pour accéder à plus d’informations.

 

 

Vous y trouvez trois informations très utiles : ID, Nom, URL.

 

ID : C’est l’identifiant unique de votre commande, nous reviendrons dessus un peu plus tard.

Nom : Permet d’être sûr que vous êtes bien sur la bonne commande (Ici le On).

URL : C’est l’adresse web qui va permettre au HA-Bridge de lancer la commande.

Faîtes un clic droit sur le lien URL –> et sélectionnez Copier le lien (collez-le dans un document .txt avec un descriptif à côté du genre interrupteur cuisine On) et faire la même chose avec le lien sur le Off.

Et là, regardez, miracle! À la fin de votre URL, vous retrouvez notre ID. Cela va bien vous servir pour les prochains périphériques à ajouter.

Retournez maintenant sur l’interface du HA-Bridge pour ajouter le matériel. Pour cela, sur la page web nous allons cliquer sur Add/Edit.

Nous ne listons ici que ce qui va nous servir, si ce n’est pas listé, ne le modifiez pas. 

NAME : Le nom sous lequel votre appareil apparaîtra dans l’application Alexa, et donc le nom par lequel vous allez l’appeler avec Alexa, sera le nom que vous allez mettre ici. Donc évitez les trucs tordus, sinon vous allez ensuite galérer! Alexa aime la simplicité. Les Alexiens aussi.

DESCRIPTION : Pour vous rappeler à quoi cela correspond (quand on commence a avoir bcp de périphérique c’est important).

COMMENTS : Un peu comme description, mais vous pouvez mettre plus de caractères.

DEVICE TYPE : Ici, choisissez « Custom », c’est bien.

ON ITEMS : / ! \ Faites bien attention c’est ce qui va déterminer si cela fonctionne ou pas / ! \
Cela va correspondre à l’allumage (ON)  nous allons remplir la ligne de la manière suivante

  1. Type : http DEVICE
  2. Target Item : On colle l’URL copiée précédement pour le ON
  3. http Verb : Choisir GET
  4. Content Type : application/json

N’oubliez pas d’enregister vos modification en cliquant d’abord sur Add.

Faites la même chose pour Off Items.

Sauvegardez l’ensemble en cliquant sur « Add Bridge Device » en haut de la page sur :

Maintenant, vous allez avoir votre matériel qui apparait sur la page Bridge Devices :

 

Bon, ça n’est pas tout, mais il va falloir lier l’ensemble (HA-Bridge et Alexa) parce que là, bon, pas trop d’intérêt… Non?

Donc, cliquez sur le bouton Echo, c’est une page https:// sur le site Amazon qui s’ouvre, cela sert à lier le HA-Bridge à votre compte Amazon (sinon Alexa ne sait pas où chercher). Remplissez les informations.

Allez ensuite sur Smart Home (alors ici, l’interface est en anglais, ce qui n’est pas le cas pour tout le monde, donc si votre interface est en français, ce sera Maison connectée) et cliquez ensuite sur Devices.

 

Maintenant deux possibilités : soit le matériel est déjà détecté (c’est le cas ici) soit vous aurez à « lancer la détection » pour trouver votre matériel (on est parfois obligé de scanner 2 / 3 fois).

Nous allons maintenant vérifier sur l’application Alexa pour être sûr que le périphérique ajouté apparaît bien.

Et voila, maintenant il suffit de dire « Alexa allume xxxxx » ou « Alexa éteins xxxxx ».

Ce qui est génial, c’est que vous pouvez incorporer tous vos périphériques fonctionnant avec un ON/OFF donc par exemple : Lumières, Prises connectées…

Amusez-vous bien !!! 

 

Fasciné par Alexa depuis le jour où je l'ai reçue en bêta test, je me suis peu à peu passionné pour le sujet, avant de me décider à aller plus loin en créant un site avec Jean-Christophe. Une activité qui me permet d'étancher ma soif de nouvelles technologies et de partager mes découvertes sur la plus sympathique des communautés : Les Alexiens.