{"id":1263,"date":"2018-07-05T17:14:22","date_gmt":"2018-07-05T15:14:22","guid":{"rendered":"https:\/\/hoper.dnsalias.net\/atdc\/?p=1263"},"modified":"2018-12-07T15:51:03","modified_gmt":"2018-12-07T14:51:03","slug":"ha-bridge-howto-alexa-la-suite","status":"publish","type":"post","link":"https:\/\/hoper.dnsalias.net\/atdc\/index.php\/2018\/07\/05\/ha-bridge-howto-alexa-la-suite\/","title":{"rendered":"ha-bridge howto (Alexa, la suite !)"},"content":{"rendered":"

De quoi on parle ?<\/h3>\n

L’id\u00e9e ici et de pouvoir faire faire n’importe quoi (ou presque) \u00e0 n’importe quoi. Autrement dit, interconnecter des syst\u00e8mes domotiques qui ne savent nativement pas dialoguer ensemble.<\/p>\n

Le principe est de simuler un \u00e9quipement simple, commun, et reconnu par la majorit\u00e9 des \u00e9quipements domotique, \u00e0 savoir une lampe Phillips Hue. Alexa, Google home, Siri, un hub Harmony etc… Tous ces \u00e9quipements savent piloter une lampe Hue. Mais ils ne sauront pas forc\u00e9ment piloter votre aspirateur, votre vid\u00e9o projecteur, vos volets roulants ou certains \u00e9quipements hi-fi.<\/p>\n

Comment ?<\/h3>\n

Bien \u00e9videment, et avant m\u00eame de penser \u00e0 interconnecter quoi que ce soit, vous devez d\u00e9j\u00e0 disposer d’un moyen de contr\u00f4ler votre \u00e9quipement \u00ab\u00a0cible\u00a0\u00bb. Soit parce que vous avez une box domotique* avec les bons plugin soit parce que vous avez lu la doc, et que vous connaissez la bonne commande (http ou autre) \u00e0 envoyer \u00e0 l’\u00e9quipement pour lui faire faire ce que vous d\u00e9sirez.<\/p>\n

*Jeedom dans mon cas, ce logiciel est g\u00e9nial. Si vous ne savez pas quoi choisir en mati\u00e8re de domotique opensource, ne cherchez plus, c’est ce logiciel qu’il vous faut. Je n’ai jamais rien vu de plus complet, ce truc peut vraiment s’interfacer avec n’importe quoi.<\/p>\n

Dans la suite de ce howto je partirai du principe que vous souhaitez lancer un sc\u00e9nario Jeedom. Mais encore une fois, n’importe quelle autre action pourrait \u00eatre effectu\u00e9e (lancement d’un script shell etc). La documentation d’installation est tr\u00e8s bien faite, je ne vais donc pas trop passer de temps dessus. Juste vous montrer une astuce pour le lancer sans soucis sur un serveur sur lequel vous avez d\u00e9j\u00e0 des trucs qui tournent. (M\u00eame un un raspberry suffira tr\u00e8s largement). La ou j’ai trouv\u00e9 la doc un peu l\u00e9g\u00e8re, c’est sur la partie \u00ab\u00a0administration graphique via l’IHM web\u00a0\u00bb. C’est donc sur ce point que je d\u00e9taillerai un peu plus.<\/p>\n

Installer ha-bridge<\/h3>\n

ha-bridge est un logiciel java monolithique, utilisant peu de m\u00e9moire (le processus utilise 72 Mo de m\u00e9moire chez moi) et vraiment rien en cpu. Le binaire est t\u00e9l\u00e9chargeable ici<\/a>. Je vous invite aussi bien sur \u00e0 jeter un coup d\u2019\u0153il \u00e0 la doc la<\/a>.<\/p>\n

Si vous n’avez pas java sur la machine qui fera tourner ha-bridge, vous savez ce qu’il vous reste \u00e0 faire… (java version 8 minimum).\u00a0 Si rien d’autre ne tourne sur cette machine (pas de serveur web ou autre, alors pas de soucis, il suffira de lancer le logiciel pour qu’il se mette en \u00e9coute sur le port 80. Toute la configuration se fait ensuite au travers d’une interface web.<\/p>\n

En revanche, si comme moi vous avez d\u00e9j\u00e0 des processus en \u00e9coute (jeedom…) alors il va falloir commencer par faire quelques modifications r\u00e9seaux. M\u00eame s’il est possible de faire \u00e9couter ha-bridge sur un autre port, j’ai trouv\u00e9 beaucoup plus propre de lui cr\u00e9er une interface r\u00e9seau sp\u00e9cifique, avec une nouvelle adresse IP. Ainsi, le logiciel peut se mettre en \u00e9coute sur n’importe quoi, sans d\u00e9ranger les autres processus qui tourne sur l’IP principale du serveur. (Je ne connais pas forc\u00e9ment tous les ports utilis\u00e9s par Philips Hue, et ha-bridge est aussi amen\u00e9 \u00e0 \u00e9voluer donc… C’est plus de travail maintenant, mais beaucoup moins d’ennuis potentiels par la suite).<\/p>\n

La premi\u00e8re chose \u00e0 faire et d’assigner une nouvelle adresse IP \u00e0 votre interface r\u00e9seau. Chez moi j’ai fait au plus simple, en ajoutant simplement \u00e0 la fin du fichier \/etc\/rc.local la ligne suivante :<\/p>\n

\u00a0ip addr add 192.168.30.248\/24 dev eth0<\/p><\/blockquote>\n

Une ligne qu’il faudra \u00e9videment adapter en fonction de votre configuration r\u00e9seau. Ici j’ajoute l’IP en .248, sachant que bien sur cette IP n’existe nul part ailleurs dans mon lan.<\/p>\n

Une fois cette IP existante vous devrez modifier la configuration des logiciels qui tournent d\u00e9j\u00e0 pour les restreindre \u00e0 utiliser l’ip principale de la machine (la premi\u00e8re), et a ne surtout rien \u00ab\u00a0binder\u00a0\u00bb sur celle ci. Pour apache par exemple, c’est dans le fichier \/etc\/apache2\/ports.conf qu’il faudra remplacer les * par l’IP sur laquelle vous voulez que le serveur \u00e9coute. Ainsi la directive Listen *:80 deviendra par exemple:<\/p>\n

Listen 192.168.30.247:80<\/p><\/blockquote>\n

Une fois cette modification effectu\u00e9e pour tous vos logiciels (et que tout \u00e0 bien red\u00e9marr\u00e9) vous pouvez maintenant lancer ha-bridge… Sans oublier de lui indiquer \u00e0 lui aussi quelle IP il doit utiliser (la seconde donc, celle en 248… Tout le monde suit ?)<\/p>\n

Pour \u00e7a rien de plus simple, il suffit de lire la doc:<\/p>\n

java -jar -Dserver.ip=192.168.30.248 ha-bridge-W.X.Y.jar<\/p><\/blockquote>\n

Si tout s’est bien pass\u00e9 vous aurez alors acc\u00e8s \u00e0 son interface web sur http:\/\/192.168.0.248. Mais stopper le pour le moment et finissez le travail, en allant par exemple \u00e9diter le fichier de configuration qu’il \u00e0 du cr\u00e9er dans data\/habridge.config. Vous pouvez par exemple lui indiquer la bonne IP dans ce fichier, ainsi que plein d’autres chose (cf la doc, toujours…).<\/p>\n

Vous devriez aussi cr\u00e9er un v\u00e9ritable service systemd, afin de pouvoir contr\u00f4ler l’ensemble (start\/stop\/status) de fa\u00e7on beaucoup plus propre qu’avec des kills ou des control-c… Cela vous permettra aussi de faire en sorte qu’ha-bridge soit automatiquement lanc\u00e9 au boot de la machine. Pour \u00e7a… Oui bien sur ! La doc, comme d’habitude \ud83d\ude42<\/p>\n

Param\u00e9trer ha-bridge<\/h3>\n

C’est cette partie la qui m’a demand\u00e9 le plus de temps… Pas parce qu’elle serait compliqu\u00e9e, mais parce qu’il y a plein de boutons partout, et assez peu de documentation disponible je trouve…<\/p>\n

Voyons donc l’interface:<\/p>\n

\"\"<\/a><\/p>\n

Le premier onglet, Bridge Devices, liste les \u00ab\u00a0lampes\u00a0\u00bb actuellement configur\u00e9es. (Cette liste sera bien sur vide au d\u00e9part). Le second onglet permet de configurer le \u00ab\u00a0bridge\u00a0\u00bb (autrement dit le logiciel qui se fait passer pour un \u00ab\u00a0pont\u00a0\u00bb Philips). L’onglet \u00ab\u00a0logs\u00a0\u00bb se passe de commentaire. Quand \u00e0 \u00ab\u00a0Add\/Edit\u00a0\u00bb il permet de cr\u00e9er une nouvelle lampe.<\/p>\n

Avant toute chose il est tr\u00e8s important<\/strong> de s\u00e9curiser cette interface. En effet, elle permet de lancer des scripts avec les droits du processus, donc root. (les droits root \u00e9tant n\u00e9cessaires pour se mettre en \u00e9coute sur les ports <1024). Bref, quiconque ose d\u00e9fier la puissance de dieu<\/del> acc\u00e8de \u00e0 cette interface est imm\u00e9diatement root sur votre serveur ! Pour s\u00e9curiser un minimum, aller dans l’onglet Bridge Control, et appuyer sur \u00ab\u00a0update Security Setting\u00a0\u00bb. Choisissez un login et un mot de passe.<\/p>\n

\"\"<\/a><\/p>\n

Ici vous trouverez tous les param\u00e8tres globaux du pont, ainsi que la possibilit\u00e9 d’indiquer l’IP de chacun de vos \u00e9quipements (Harmny, Hue, Fibaro, Somfy, Nest, LifX, Domoticz, Alexa, Vera etc, etc). Personnellement je n’ai absolument rien rempli de tout \u00e7a. Et surtout pas la ligne \u00ab\u00a0Hue\u00a0\u00bb dont l\u2019existence est pour moi un vrai myst\u00e8re. Apparemment l’id\u00e9e est de pouvoir utiliser ha-bridge comme une sorte de proxy relai… Un \u00e9quipement quelconque enverrai une commande \u00e0 ha-bridge pensant avoir \u00e0 faire au v\u00e9ritable pont Philips, et ha-bridge pourrait alors effectuer des actions (scripts shell etc) puis transf\u00e9rer la commande au v\u00e9ritable pont Hue pour finaliser l\u2019ex\u00e9cution (et allumer la bonne lampe par exemple).\u00a0 Je doute que beaucoup de gens aient besoin de cette fonction mais bon.. C’est possible \ud83d\ude42<\/p>\n

Globalement les seules choses que j’ai modifi\u00e9 dans cet \u00e9cran sont :<\/p>\n