Ce plugin SARAH s’appuie sur l’API officielle de la société MyFox.
Vous pourrez grâce à celui-ci :
- Connaitre le statut par le biais du tableau de bord de SARAH ou à la voix,
- Activer totalement, partiellement ou encore désactiver l’alarme,
- Utiliser dans d’autres plugins des informations de votre centrale remontées dans par le plugin.
Une vidéo vaut mieux qu’un long discours …
Configuration
Les identifiants API
J’en avais vaguement parlé sur la page «La centrale d’alarme MyFox s’ouvre encore plus avec IFTTT» mais vu que c’est intégré dans le service de IFTTT je ne voudrais pas vous perdre 🙂
-
- Se rendre à l’url https://api.myfox.me/
-
- Se connecter à l’API en utilisant ses identifiants du site myfox.me
-
- RDV dans la section « Mes Application »
Ce sont donc les identifiants «Personnal Application»:
- client_id
- et client_secret
qui nous intéresse.
Configurer le plugin myfox pour SARAH
Sur le dashboard, dans la petite clé à molette faites un clic.
Vous devez pouvoir saisir les champs:
- client_id,
- client_secret,
- login,
- password
Penser à enregistrer ! et faite un redémarrage du serveur node.js (SARAH serveur).
Normalement le plugin doit pouvoir se connecter à l’API, mais il faut encore renseigner votre numéro de centrale. Pour le connaitre je vous invites à :
- vous rendre sur votre dasboard SARAH,
- retourner le portlet du plugin,
- cliquer sur le globe.
vous devez arriver sur cette page.
Dans la partie «Centrales» vous devez retrouver vos centrales, puis il suffit de recopier le «id» dans la configuration du plugin.
Voila pour la partie configuration et mise en place.
Utilisation
Vocalement
Tout se trouve dans le XML, mais voici les phrases communes, SARAH:
Qu’elle est le statut de l’alarme
désactive l’alarme
active partiellement l’alarme
active totalement l’alarme
Il y en aura surement d’autres 🙂 mais ça dépend de vos demandes !
Depuis une autre box
Si il vous est possible depuis une autre box de faire des requêtes http, alors vous pouvez utiliser:
|
1 2 |
#connaitre le statut de l'alarme http://localhost:8080/sarah/myfox?myFoxAction=getSecurity |
|
1 2 3 4 5 6 7 8 9 10 |
#Changer le statut de l'alarme #désactivée http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=disarmed #activation partielle http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=partial #activation totale http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=totale |
|
1 2 3 4 5 6 7 8 9 10 |
#Changer le statut de l'alarme en mode silence #désactivée http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=disarmed&silent=1 #activation partielle http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=partial&silent=1 #activation totale http://localhost:8080/sarah/myfox?myFoxAction=setSecurity&level=totale&silent=1 |
En sachant que localhost est l’adresse Ip de votre SARAH Serveur.
Il y aura bien sur d’autres commandes qui seront générées suivant les équipements que vous aurez de relié à votre centrale d’alarme myfox.
Pour les Développeurs
J’ai mis à la disposition dans le context de SARAH la valeur de l’état. En effet un cron passe toute les 20 secondes pour connaitre le statut de la centrale d’alarme myfox. Vous pourrez donc l’utiliser.
|
1 |
SARAH.context.myfox.status |
Un bug ?
Pour toutes demande de modifications, ajouts, correction de bug merci de vous rendre à cette ardresse: https://github.com/Hotfirenet/SARAH-Plugin-myfox/pulls