Actionneurs HTTP

Documentation eedomus

La box eedomus vous permet d'envoyer des commandes HTTP à des périphériques le supportant.

Sommaire

Paramétrage

Cliquez sur Configuration / Ajouter ou supprimer un périphérique / Ajouter un autre type de périphérique / HTTP - Actionneur / Créér

Ajout capteur HTTP

Aller ensuite dans l'écran Configuration du périphérique pour définir votre capteur:


Exemple: réalisation d'une télécommande Freebox

Attention de ne pas ajouter de retour chariot à la fin de 'Paramètres'

Bouton de test

Il est désormais possible de tester ces actions avant même de les sauvegarder: pour cela cliquer sur une ligne à tester pour la sélectionner, puis sur le bouton Tester

Utilisation en tant que capteur

Le périphérique peut désormais être également utilisé en tant que capteur HTTP grâce aux paramètres Requête de mise à jour , Chemin XPATH et Fréquence de la requête.

Il sera donc mis à jour par interrogation régulière ("polling"), pour en savoir plus: Capteurs HTTP


Exemple de paramètre, avec requêtes toutes les 15 minutes

Attention à ce que votre actionneur HTTP renvoie bien un résultat de type XML, comme <result>1</result>

Utilisation des variables utilisateurs

Les mots clés [VAR1], [VAR2], [VAR3] peuvent être utilisés dans les URL d'action, les paramètres de requêtes, mais aussi la requête de mise à jour et l'expression XPath.

Ils seront alors automatiquement remplacés par les valeurs définis en face de chaque variable.

Par exemple, vous pouvez utiliser http://[VAR1]/macommande pour facilement changer l'adresse IP.

Si vous souhaitez utiliser l'adresse MAC (eedomus+), vous pouvez utiliser le tag IP_FROM_MAC qui effectue la conversion : http://[IP_FROM_MAC=[VAR1]]/macommande

L’intérêt des variables se trouve notamment après la création de canaux à votre périphérique HTTP en utilisant l'option Rattacher à. Dès lors, le changement d'une de ces variables sera répliqué sur tous les canaux du périphériques.

Conseils

Pensez à utiliser des adresses IP fixes pour les périphériques (ou de les fixer par le routeur-serveur DHCP sur l'adresse MAC si le routeur le supporte). Voir Gérer son réseau local

Il est conseillé d'ajouter un module pour chaque périphérique IP (mais il est possible de mettre toutes les commandes HTTP dans le même module, ou bien de diviser les commandes d'un seul périphérique en plusieurs modules).

Nous n'offrons pas de support sur les périphériques IP et la configuration de leurs commandes HTTP, mais simplement sur l'envoi technique des commandes. Il appartient à l'utilisateur de se renseigner sur la documentation des périphériques cibles pour connaître la syntaxe des commandes (et de les tester au préalable sur un navigateur au besoin).

Nota: en cas d'erreur "Illegal characters found in URL", veuillez vérifier qu'il n'y a pas de retour chariot à la fin des paramètres.

Exemples de périphériques et leurs commandes

Squeezebox Radio

La Squeezebox Radio se contrôle au travers du logiciel Logitech Media Server qui est installé sur un PC.

Le démarrage de la lecture se fait par une URL du type :

http://adresse_IP_du_PC_media_server:9000/status.txt?p0=play

L'arrêt de la lecture se fait par une URL du type :

http://adresse_IP_du_PC_media_server:9000/status.txt?p0=stop

La documentation se trouve sur le serveur web inclus dans le Logitech Media Server (chapitre : Logitech Media Serveur Web interface) :

http://adresse_IP_du_PC_media_server:9000/html/docs/help.html

Caméra Axis

L'allumage et l'extinction de la lumière LED sur une caméra Axis M1033W s'effectue ainsi.

Pour activer l'éclairage, l'URL est du type :

http://root:password@adresse_ip_camera/axis-cgi/io/lightcontrol.cgi?action=L1:-100

Le moins « - » introduit un effet « fade ».

Pour désactiver l'éclairage, l'URL est du type :

http://root:password@adresse_ip_camera/axis-cgi/io/lightcontrol.cgi?action=L1:-0

La désactivation de la LED de status s'obtient ainsi :

http://root:password@adresse_ip_camera/axis-cgi/param.cgi?action=update&root_StatusLED_Usage=off

Pour jouer un clip audio, l'URL se présente ainsi :

http://root:password@adresse_ip_camera/axis-cgi/playclip.cgi?clip=1 (exemple clip 1) Exemples HTTP Axis

D'autres types de caméras présentent des API HTTP bien documentées, comme par exemple Foscam.

IPX800

L'allumage d'un relais d'un IPX800 s'effectue avec une commande de ce type :

http://adresse_IP_IPX800/preset.htm?led1=1 pour le passage à 1 du relais 1
http://adresse_IP_IPX800/preset.htm?led1=0 pour le passage à 0 du relais 1
http://adresse_IP_IPX800/preset.htm?RLY1=1 pour un passage à 1 fugitif puis retour à 0

Si vous utilisez un identifiant/motdepasse sur l'IPX800, la syntaxe suivante s'applique :

http://identifiant:modepasse@adresse_IP_IPX800/preset.htm?led1=1

Nabaztag/tag

Avec les nouveaux serveurs d'Aldebaran/Violet

http://api.nabaztag.com/vl/FR/api.jsp?sn=XXXXXXXXXXXX&token=XXXXXXXXXXX&tts=Bonjour

Si votre lapin est configuré sur le serveur expérimental Nabizdead, suite à l'interruption initiale des serveurs officiels, vous pouvez utiliser une commande HTTP eedomus vers l'API Nabizdead fournie, en appelant une URL du type suivant qui fera dire "Bonjour" à votre flux :

http://www.nabizdead.net/api.php?action=post&flow=XXXXXXXXXXXX&code=XXXXXXXXXXX&lang=fr&content=Bonjour

A utiliser avec les recommandations Nabizdead.

Karotz Pour l'envoi de commandes de synthèse vocale vers un Karotz (TTS Text To Speach), un module est pré-paramétré par eedomus. Utiliser une temporisation si plusieurs actions se suivent, il ne faut envoyer une action que lorsque la précédente est terminée (notamment en cas d'appli eedomus sur Karotz, puis de retour d'information vocale sur le Karotz).

Emetteur IR Kira

Exemple mis en oeuvre par Maison-et-domotique :

Intégration Kira128

Relais Wifipower

Les URL pour allumer ou éteindre le relais 3 sont respectivement :

http://192.168.0.190:2000/R31
http://192.168.0.190:2000/R30

Pour mémoire, l'API

Pour mémoire, l'API eedomus vous permet réciproquement d'envoyer une commande à eedomus à partir d'un autre système.

Karotz

Vous pouvez utiliser un Karotz de Aldebaran-Violet pour envoyer une commande à l'API eedomus. Pour ce faire, utilisez l'application eedomus pour Karotz.