Actualités | Audio/Vidéo | Evènements | DIY | Domotique | Informatique | Maison | Mobile | Sécurité

Premières heures avec l'Eedomus de Connected Object - Utilisez l'API pour l'intégrer à votre domotique

Envoyer Imprimer PDF
Note des utilisateurs: / 18
MauvaisTrès bien 
Index de l'article
Premières heures avec l'Eedomus de Connected Object
Initialisation
Installation de Modules
Personnalisez l'interface
Interface de secours
Interface Mobile
Utilisez l'API pour l'intégrer à votre domotique
Premières conclusions
Toutes les pages

Intégration de Eedomus dans un système de domotique existant.

Si vous êtes comme moi et que vous avez un PC de domotique sous Homeseer, vous serez probablement séduit par Eedomus car il vous propose en standard des fonctions qu'il était parfois difficile de développer/maintenir avec son PC. Aujourd'hui, c'est dans la boite, il faut juste l'utiliser !

Mais alors comment faire si vous avez une 50 périphériques X10 sous Homeseer et que vous souhaitez petit à petit passer sous Eedomus. Vous souhaitez commencer par quelques modules Zwave puis remplacer tous vos modules X10 par du Zwave au fur et à mesure que vous aurez le budget pour les remplacer.

C'est mon cas et j'ai choisi dans un premier temps d'utiliser Eedomus comme passerelle Zwave, le temps que je reprogramme tous mes scénarios dans Eedomus. En attendant, j'utilise l'API de Eedomus et je demande à Homeseer de piloter mes lampes Zwave en faisant des appels Zwave via l'API de EEdomus. Les télécommandes de mon ancien système font des appels à Homeseer qui vient piloter mes lampes en faisant des appels à Eedomus.

Regardons ça en détail

Pour commencer, il faut activer l'API de Eedomus. Allez dans "Configuration >Mon Compte > Paramètres". Puis cliquez sur Envoyer en face de libellé "identifiants pour l'API".

Vous allez recevoir un mail avec l'api_user et api_secret. Ces informations sont nécessaires pour toutes les commandes de l'API. Les commandes sont expliquées dans l'aide (voir en haut à droite de la page).

Prenons un exemple, regardons comment allumer ou éteindre une lampe. L'API dit :

http://api.eedomus.com/set?action=periph.value&periph_id=[XXXX]&value=[XXXX]&valued_date=[YYYY-MM-DD HH:MM:SS]&api_user=[XXXX]&api_secret=[XXXX]

Les champs valued_date est facultatif.

Pour obtenir le champ periph_id, il faut aller sur le bouton configuration. Puis cliquez sur un libellé du tableau et choisir d'afficher la colonne "ID API". Cette information n'est pas disponible par défaut et il faut l'afficher si vous souhaitez l'utiliser. Les ID apparaissent à gauche, vous n'avez plus qu'à noter les numéros.

Mais pour commander ma lampe, j'ai aussi besoin de passer une "value". Pour connaitre les valeurs utilisables, il faut réouvrir le module en modification et aller sur l'onglet "Image". On voit ici à gauche les valeurs que manipule le système.

J'ai maintenant toutes les informations pour piloter ma lampe via l'API. J'envoie la commande :

http://api.eedomus.com/set?action=periph.value&periph_id=2943&value=0&api_user=xxx&api_secret=xxx

Ma lampe s'éteint et le système me ramène le libellé:

{ "success": 1, "body": { "result": "[OK]" } }

Vous pouvez maintenant ajouter cette commande dans Homeseer en utilisant la commande

hs.getURL("http://api.eedomus.com","/set?action=periph.value&periph_id=2943&value=0&api_user=xxx&api_secret=xxx", False, 80)

Toutes les commandes Eedomus fonctionnent de la même facon. On peut aussi accéder à la dernière valeur d'un module en appelant

http://api.eedomus.com/get?action=periph.caract&periph_id=2943&api_user=xxx&api_secret=xxx

L'API va répondre

{ "success": 1, "body": { "name": "Lampe Canapé Salon", "last_value": "On", "last_value_change": "2012-01-08 17:04:47" } } 

On peut aussi interroger l'historique des valeurs en bornant par des dates s'il y a beaucoup de valeurs. Mais on n'est pas obligé de mettre les dates. Dans ce cas on obtient toutes les valeurs.

http://api.eedomus.com/get?action=periph.history&periph_id=2943&api_user=xxx&api_secret=xxx

Le système répond

{ "success": 1, "body": { "history": [ ["On","2012-01-08 14:51:13"],
 ["Off","2012-01-08 14:51:20"], ["On","2012-01-08 14:52:03"],
["On","2012-01-08 15:23:06"], ["On","2012-01-08 15:26:57"],
["On","2012-01-08 15:29:12"], ["Off","2012-01-08 15:30:52"],
["On","2012-01-08 15:31:10"], ["Off","2012-01-08 16:41:35"],
 ["On","2012-01-08 16:41:38"], ["On","2012-01-08 16:47:43"],
["On","2012-01-08 16:57:21"], ["On","2012-01-08 16:58:44"],
["Off","2012-01-08 17:04:40"], ["On","2012-01-08 17:04:47"],
["On","2012-01-08 17:07:28"], ["On","2012-01-08 17:08:04"],
["On","2012-01-08 17:09:56"], ["On","2012-01-08 17:14:37"],
 ["On","2012-01-08 17:15:09"], ["On","2012-01-08 17:17:12"],
["On","2012-01-08 17:24:23"]] } }

Voici donc quelques exemples élémentaires sur l'utilisation de l'API. Celà permet de pouvoir utiliser rapidement l'Eedomus dans un système de domotique existant. On peut même appeler ces urls depuis une Zibase ou une Vera pour ceux qui auraient des scénarios de migration plus compliqués que le mien.



Mise à jour le Mercredi, 15 Août 2012 15:32  

Ajouter un Commentaire


Code de sécurité
Rafraîchir

Recherche

Les Flux RSS de TLD
Instagram

Produits Partenaires

GCE Electronics est partenaire de Touteladomotique.com RFXCOM.com est partenaire de Touteladomotique.com



Liens Utiles

Boutiques Partenaires

Liens Utiles

Un don pour TLD ?

Pourquoi faire un don ?

Publicité

Espaces publicitaires à louer
Contactez-nous

Connexion