Alexa-smartHome Documentation

alexasmarthome icon

Présentation du plugin

grandeimage promo smarthome

Plugin qui vient compl√©ter les possibilit√©s d’Alexa en apportant le lien avec les produits de la gamme Amazon smartHome.

Ce plugin tr√®s simple permet d’actionner l’√©tat des √©quipements.

La TODOList et le ChangeLog font l’ojet d’une page sp√©ciale.

Equipements compatibles

Tous les équipements compatibles avec Amazon smartHome sont compatibles avec le plugin.

Ils seront tous détectés, la liste est ici

Si vous voulez uniquement des produits Amazon, vous pouvez consulter cette page.

L’int√©gration des commandes de chaque type de modules se fait petit √† petit, au fur √† mesure des achats/tests de chacuns.

A ce stade, dès le lancement du plugin, les prises qui ont comme état On/Off sont prises en compte, les lampes ou ruban LEDS en RVB fonctionnent ainsi que les thermostats.

Les retours d’√©tat ne fonctionnent pas encore car nous n’avons pas encore trouv√© comment avoir l’information. Ainsi, si vous lancer un changement d’√©tat d’une lampe, vous aurez un changement de la valeur du widget, mais attention, c’est uniquement bas√© sur l’action qui vient d’√™tre effectu√©e et non d’une validation du module. (Ce n’est donc pas un retour d’√©tat)

Consultez le ChangeLog pour voir l’√©volution de la d√©tection des modules. Si vous avez un besoin particulier, n’h√©sitez pas √† rencontrer l’√©quipe de d√©veloppement et les beta-testeurs sur le Slack.

Installation du Plugin Alexa-smartHome

Très important, Alexa-AmazonMusic a besoin du plugin Alexa-API (gratuit) pour dialoguer avec vos Alexa donc :

√Čtape 1 : Installer le plugin Alexa-API

√Čtape 2 : Installer le Plugin Alexa-smartHome

depuis le Market, catégorie Objets connectés ou en tapant son nom dans le champ de recherche

Note sur les versions :

Vous avez le choix entre la version Stable ou la version Beta.

Beaucoup de nouvelles fonctionnalités sont toujours plus présentes sur la Beta que sur la Stable mais elles sont en test.

Si vous êtes joueur et curieux, vous pouvez installer la version Béta.

Nota¬† Vous n’avez pas besoin d’installer Jeedom en Beta (c’est plut√īt d√©conseill√© d’ailleurs) pour installer le plugin en B√©ta.

Vous pouvez assez facilement passer d’une version Beta √† une version Stable et r√©ciproquement, il suffit de r√©installer par dessus l’autre version.

√Čtape 3 : Activer le Plugin

 Screenshot 2020 02 04 Alexa API Jeedom

√Čtape 4 : Retourner dans le plugin Alexa-API

Screenshot 2020 02 04 Alexaamazonmusic Jeedom

√Čtape 5 : Relancer le SCAN

Screenshot 2020 02 04 Alexaapi Jeedom

Les devices smartHome vont être générés automatiquement

Allez dans Alexa-smartHome pour les visualiser

Screenshot 2020 02 04 Alexa API Jeedom2

Mise à jour ou Changement de version (de Beta à Stable ou de Stable à Beta)

Que faire ?

Le plugin et son API √©tant vivants (Amazon n’ayant pas document√© l’API se permet de modifier au fil de l’eau ses protocoles), les mises √† jour permettent d’apporter des corrections dans les liens entre le plugin et le serveur Amazon.

Notez qu’il est toujours conseill√© de mettre √† jour Alexa-API quand on met √† jour les plugins multimedia (Alexa-AmazonMusic, Alexa-Deezer, Alexa-Spotify ou encore Alexa-smartHome)

Deux solutions pour avoir une installation opérationnelle :

  • Supprimer tous les √©quipements Amazon et leurs commandes et les recr√©er
  • Forcer la mise √† jour de toutes les commandes
  • Lancer un SCAN qui d√©tecte les nouveaux √©quipements ou les nouvelles commandes

Le choix entre ces trois solutions d√©pend du nombre de sc√©narios que vous avez d√©velopp√© gr√Ęce aux. En effet, la premi√®re solution supprime tous les devices et toutes les commandes, elle supprimera donc celles ci dans vos sc√©narios. La seconde solution est plus respectueuse de vos sc√©narios car elle mettra √† jour vos commandes sans les supprimer et donc vos sc√©narios seront intacts.

Solution 1 : Supprimer tous les équipements et leurs commandes et les recréer

C’est le mode le plus propre et le plus optimis√© puisque vous repartez avec une installation comme neuve des devices et de leurs commandes.

Pour se faire, il faut utiliser le bouton (dans l’√©cran de configuration du plugin Alexa-API)boutonalexaapi1

Attention, cette fonction supprime tous les équipements et leurs commandes, vous perdez donc tous les liens dans vos scénarios.

Solution 2 : Forcer la mise à jour de toutes les commandes

C’est le mode le plus simple et sans risque puisque vos √©quipements et leurs commandes ne sont pas supprim√©s. Ce for√ßage n’impacte donc pas vos sc√©narios.

Pour se faire, il faut utiliser le bouton boutonalexaapi2

Si vous ne souhaitez pas lancer le for√ßage de mise √† jour sur toutes les commandes de tous les √©quipements, vous pouvez le lancer sur un seul √©quipement (et donc sur toutes ses commandes). Pour cela, rendez vous sur l’√©quipement concern√© et cliquez sur :

boutonalexaapi3

Solution 3 : Le SCAN

Screenshot 2020 02 04 Alexaapi Jeedom

Notez enfin que le scan peut √™tre lanc√© √† tout moment, il n’impacte pas les √©quipements d√©j√† d√©tect√©s ni les commandes existantes, par contre, il recr√©e tous les nouveaux devices ou les devices supprim√©s. Il recr√©e √©galement toutes les nouvelles commandes ou les commandes supprim√©es.

One thought on “Alexa-smartHome Documentation

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *