Piloter une IPX800 V3 à partir de l'IPX800 V4

Présentation

L'IPX800 V4 offre la possibilité de visualiser l'état des entrées digitales, relais ou encore entrées analogiques, en provenance d'une IPX800 V3. Pour cela, vous avez 3 outils à votre disposition

• la source de données
• le widget Indicateurs IPX800V3
• le widget Pilotage V3
• l'API V3

Ajout d'une Source de données IPX800 V3

Pour afficher les données d'une IPX800 V3 sur l'interface d'une IPX800 V4, il faut créer une source de données sur le dashboard.

• Cliquez sur le menu Ajouter Source de données
• Sélectionnez le type X-Devices (XML)

Renseignez le nom, l'adresse IP de l'IPX800 V3, ainsi que le login (utilisateur/mot de passe) nécessaire à la connexion sur l'IPX800 V3. Renseignez le délai de mise à jour (rafraîchissement).

Validez et sauvegardez l'interface de l'IPX800 V4.

Si tout est correct, la source de données se met à jour automatiquement, en fonction du délai de rafraîchissement paramétré (1 seconde dans notre cas).

Ajout Widget Indicateur V3

Le widget indicateur IPX800 V3 permet de visualiser l'état des entrées digitales ou des sorties relais de l'IPX800 V3.

Ce widget ne permet pas de changer leur état.

• Ajoutez un widget Indicateur IPX800 V3 sur votre interface
• cliquez sur le bouton Flux de données
• recherchez les relais de l'IPX800 V3 dans la source de données que vous avez créée précédemment.

Les sorties relais sont nommées led0 à led31. Les entrées digitales sont nommées btn0 à btn31.

Voici le widget affiché dans l'interface de l'IPX800 V4. Dans notre exemple, le relais n°6 est à l'état ON.

Remarque : vous noterez que dans le flux de données, les Relais 1 à 32 sont nommés led0 à led31 et les entrées digitales btn0 à btn31.
Pour plus d'informations, je vous invite à afficher le contenu du fichier Status.xml de votre IPX800 V3.
Dans un navigateur, entrez l'URL http://IPX800_V3/status.xml 
Au besoin, remplacez IPX800_V3 par son adresse IP et le port si vous l'avez modifié. Le Mot de passe de l'IPX800 V3 vous sera demandé.

Ajout widget TEXTE avec donnée de la V3

L'IPX800 V3 contient des données de type Texte.

• version firmware
• date / heure
• information
• le nom d'hôte de l'IPX800 (Hostname)
• l'adresse MAC
• Les réponses au ping,
• etc.

Il est possible d'afficher ces informations sur l'interface de l'IPX800 V4.

Pour cela, ajoutez un widget de type TEXTE,

cliquez sur le bouton [Flux de Données] et sélectionnez la variable à afficher.

Dans notre exemple ci-dessous, nous afficherons la version du Firmware.

Voici le widget affiché :

Remarque : Pour plus d'informations sur les données pouvant être affichées, je vous invite à consulter le fichier GlobalStatus.xml de votre IPX800 V3.
Dans votre navigateur, entrez l'URL http://IPX800_V3/globalstatus.xml

Afficher une donnée Analogique de la V3

Les sources de données connectées à l'IPX800 V3 remontent les valeurs analogiques sous la forme de données brutes. La formule de conversion liée au type de capteur n'est pas appliquée.

Si nous souhaitons afficher ce type de donnée, il faudra nécessairement appliquer la formule dans un javascript.

Remarque : Les formules nécessaires à l'affichage des données analogiques V3 sur une IPX800 V4 sont fournies dans le  HelpDesk.

Ajout widget JAUGE avec donnée analogique de la V3

Ajoutez un widget de type JAUGE cliquez sur le bouton Flux de données et recherchez la donnée analogique

Si vous sauvegardez le widget, vous obtiendrez la valeur brute

Il faut donc appliquer la formule de conversion.

Dans le cas de notre exemple, il s'agit d'une sonde TC100 plongée dans l'eau de la piscine (avec un traitement étanche).

La formule de la sonde est ((X* 0.00323) - 0.25) / 0.028

Dans la configuration de la Jauge,

• cliquez sur le bouton JAVASCRIPT
• transformez la datasource en variable et appliquez la formule,
• ajoutez une commande return

var t=datasources["ipx800 v3"]["response"]["analog3"];
t=(((t* 0.00323) - 0.25) / 0.028).toFixed(1);
return t;

Sauvegardez le Widget et l'interface IPX800 V4

Voici le widget adapté à la sonde

Ajout widget HTML avec donnée analogique de la V3

Pour afficher une donnée analogique en provenance de l'IPX800 V3, vous pouvez utiliser le widget HTML et insérer un petit script Javascript. La démarche est identique à l'exemple avec la Jauge.

• Ajoutez un widget de type HTML
• Cliquez sur le bouton FLUX DE DONNEES et sélectionnez la donnée
• Cliquez sur le bouton JAVASCRIPT
• transformez la datasource et variable
• appliquez la formule
• ajoutez le code HTML

var t=datasources["ipx800 v3"]["response"]["analog3"];
t=(((t* 0.00323) - 0.25) / 0.028).toFixed(1);
return `
<span> Température eau piscine : ${t}°C</span>
`;

Voici le widget pour notre sonde.

L'exemple est minimaliste pour la bonne compréhension. Mais vous pouvez agrémenter le widget avec des icônes et du style CSS.

Ajout Widget Pilotage V3

L'IPX800 V4 permet de piloter les sorties de l'IPX800 V3. A votre disposition, vous trouverez un widget de type "Pilotage V3". C'est un widget avancé, présenté sous la forme d'un bouton, qui envoie un ordre grâce à l'API de la V3, et récupère un retour d'état au travers d'une source de données.

Ajoutez un widget de type Pilotage V3

• renseignez le texte qui doit apparaître lorsque le retour d'état est ON
• renseignez le texte qui doit apparaître lorsque le retour d'état est OFF
• renseignez l'adresse IP de l'IPX800 V3
• renseignez utilisateur et mot de passe de connexion sur la V3
• cliquez sur le bouton FLUX DE DONNEES et sélectionnez la donnée qui sera à l'origine du retour d'état. En principe, vous devriez sélectionner le relais que vous souhaitez piloter.
• sélectionnez le relais à piloter
• laissez le contrôle à oui pour piloter le relais, mettez si vous souhaitez juste avoir un indicateur.

Voici le widget en action

Ajout Widget PUSH

Le widget Pilotage V3 (ci-dessus) ne permet de piloter que les relais de l'IPX800 V3.

Si vous souhaitez exécuter d'autres tâches sur la V3 à partir de l'interface de l'IPX800 V4, il faut utiliser un widget de type PUSH qui enverra une commande API Http.

Supposons que nous voulons forcer une valeur dans un compteur de l'IPX800 V3

• ajoutez un widget de type PUSH URL

Dans le champ "message", renseignez la commande API HTTP de l'IPX800 V3.

Ici, nous sélectionnons le compteur n°4 (&num=3) et nous lui forçons la valeur 0.

Voici le widget affiché :

Cliquez sur le bouton, le compteur 4 sera remis à zéro sur l'IPX800 V3.

Remarque : L'API V3 est riche de plusieurs autres commandes.
Je vous invite à lire la documentation intitulée "IPX API". Elle est fournie avec le firmware.

Pilotage de l'IPX800 V3 par scénarios sur IPX800 V4

pour piloter la V3 à partir des scénarios V4 ==> PUSH avec API V3

Utiliser une donnée de la V3 dans les scénarios

push ana V3--> V4 ana virtuelle (API V4) écriture scénario push en résultat pour commander relais V3 par exemple.