Eedomus et EtherRain-8

Documentation eedomus

La box eedomus et EtherRain-8 fonctionnent facilement ensemble grâce aux actionneurs HTTP.

Leur communication se fait en Ethernet par le réseau local LAN.

EtherRain-8 est capable de piloter 8 relais 24VAC (alternatif) depuis une requête HTTP. Il est par exemple disponible ici : [1].

Exemple de relais compatible : Électrovanne Hunter SRV [2].

Installation

Pour installer EtherRain-8, commencez tout d'abord par le relier au courant à l'aide de l'alimentation 24VAC fournie, puis au réseau local par l'intermédiaire d'un cable Ethernet. Le DHCP de votre réseau devrait alors lui attribuer une adresse IP.

Pour vérifier que le périphérique a bien obtenu une adresse IP, la diode rouge située à côté du port Ethernet doit être allumée.

Afin de connaître l'adresse IP en question, vous pouvez consulter votre routeur, ou utiliser le logiciel Quicksmart disponible ici : [3].

A l'aide de ce logiciel, vous pourrez retrouver l'adresse IP qui lui a été attribuée par le DHCP. Si aucun périphérique n'apparaît dans la liste, cliquer sur Discover.

Il est fortement recommandé d'attribuer une adresse IP fixe à l'aide du serveur DHCP de votre routeur Internet.

Dans l'exemple suivant, nous avons choisi 192.168.0.139.

Principes

Les commandes suivantes ont été testées pour la version EtherRain-8-b-01.

Pour actionner un relais du module EtherRain-8, utiliser un actionneur HTTP sur eedomus.

La requête est faite sous cette forme : http://192.168.0.139/result.cgi?lu=admin&lp=pw&xi=A:B1:B2:B3:B4:B5:B6:B7:B8
en prenant soin de remplacer A, B1, B2, ... comme suit :
A = 0 pour indiquer les temps en minutes, A = 255 pour les indiquer en secondes.
B1 permet d'actionner la vanne 1 pendant X minutes ou secondes.
B2 pour la vanne 2, etc...

Ainsi, pour commander la vanne 1 pendant 10 secondes, la commande sera http://192.168.0.139/result.cgi?lu=admin&lp=pw&xi=255:10:0:0:0:0:0:0:0.
Pour commander la vanne 4 pendant 1 heure (60 minutes), la commande sera http://192.168.0.139/result.cgi?lu=admin&lp=pw&xi=0:0:0:0:60:0:0:0:0.
Les commandes s'enchaînent dans l'ordre, de la vanne 1 à la vanne 8. Ainsi, 2 vannes ne seront pas allumées au même moment. Par exemple, la commande
http://192.168.0.139/result.cgi?lu=admin&lp=pw&xi=0:30:0:0:10:0:0:0:0 actionnera la vanne 1 pendant 30 minutes, puis la vanne 4 pendant 10 minutes.
La vanne 1 est celle située au plus près du port Ethernet, la vanne 8 au plus près de l'alimentation 24VAC.

Pour arrêter toutes les vannes, la commande est la suivante : http://192.168.0.139/result.cgi?lu=admin&lp=pw&xr

Récupération des valeurs

Il est possible d'interroger le EtherRain. Les données ne sont pas formattées en XML ou en JSON (il s'agit de simple HTML), elles ne sont pas récupérables automatiquement à ce jour.

La requête est http://192.168.0.139/result.cgi?lu=admin&lp=pw&xs

Pour lire les données de configuration, la requête suivante peut être utilisée : http://192.168.0.139/ergetcfg.cgi?lu=admin&lp=pw

Les valeurs des données récupérées sont :

OS : Operating Status, indique l'état actuel du contrôleur. Les états possibles sont :
RD - READY : Le contrôleur est prêt à recevoir de nouveaux ordre d'irrigations.
WT - WAITING : Le contrôleur a reçu une commande et va bientôt l’exécuter.
BZ - BUSY : Le contrôleur exécute actuellement une commande d'irrigation.

CS : Command status, indique le résultat de la dernière commande envoyée au contrôleur. Les états possibles sont :
OK - La commande a été acceptée sans erreur.
ER - ERROR : La commande est mal formulée, une erreur est survenue.
NA - NOT AUTHORIZED : La commande provient d'une adresse IP non autorisée.

RZ : Résultat de la précédente commande d'irrigation. Les états possibles sont :
OK - La commande d'irrigation s'est exécutée correctement.
RN - La commande d'irrigation a été interrompue par l'indicateur de pluie.
SH - La commande d'irrigation a été interrompue par un problème de branchement des vannes.
NC - La commande d'irrigation ne s'est pas exécutée correctement, peut provenir d'une coupure de courant.

RI: Numéro de la vanne concernée par ces information. 0 pour la vanne 1, 1 pour la vanne 2, ... 8 pour aucune des vannes.

Complément

Exemple de réponse de la commande http://192.168.0.139/result.cgi?lu=admin&lp=pw&xr

<html> <head> </head> <body> EtherRain Device Status <br> un:MoncaoWest ma: 0.4.163.1.3.180 <br> ac: OWQ79MIS02 <br> os: RD <br> cs: OK <br> rz: OK <br> ri: 8 <br> rn: 0 <br> </body> </html>