Les éléments WagoML utilisateur

Introduction

On trouvera ci dessous un exemple pour chaque mode d'affichage avec les objets associés.
Un exemple de code de référence est associé pour indiquer comment obtenir l'affichage, ce code est donc un extrait du fichier WagoML à installer. Un item est une ligne sur l'écran avec une certaine autonomie.

Liste des objets d'affichage

Textes simples : Affichage non modifiables
Textes actifs : Affichage numérique modifiable par clavier
Boutons simples : boutons on/off
Boutons poussoirs : boutons poussoirs push et pulse
Icônes divers : Icones lampes, porte, etc..
Switch : Switchs comme interrupteur simple
Slider : Sliders réglage de valeur analogique
Wheel : Wheel - roue à code
Barres : Barres bar graphique analogique
Date : Date
Time : Time
Images : Images
Vidéo : Vidéo
iframe : iframe
Room : room : Déplacement vers une room
URL : url : Affiche le contenu texte d'un url
Week : week : Gestion des jours d'une semaine
Month : month : Gestion des mois d'une année
Bit : bit : Gestion affichage des bits d'un mot
RVB : rgb : Gestion d'une couleur par composantes R, V et B
Bar Code, QR Code :barcode : Lecture de code barre EAN et des QR Code
volet : Double bouton pulse et temporisable vers un Word. (v2/0+) en cours.

Texte numérique

Code de référence affichage = text


<item id="0">

 	<title>Test</title>

 	<name>Lampe</name>

 	<description>Etat actuel de la.</description>

 	<IW>0</IW>

 	<affichage>text</affichage>

</item>

Texte statiques

Code de référence affichage = text


<item id="0">

 	<title>Test</title>

 	<name>Lampe</name>

 	<description>(3) Etat actuel de la</description>

 	<type>text</type>

 	<text>Eteint,Allumé</text>

 	<IW>0</IW>

 	<affichage>text</affichage>

</item>

Texte numérique modifiable

Code de référence affichage = key

Code PIN : oui


<item id="0">

 	<title>Test</title>

 	<name>Key</name>

 	<description>Coffre</description>

 	<pin>123</pin>

 	<affichage>key</affichage>

 	<IW>0</IW>

 	<link>http://IP_commande?param=%d</link>

</item>

Le texte numérique affiché provient du dispositif par l'une des trois méthodes de lecture, comme un bouton ce texte sera actif, un clavier numérique permet de le modifier une commande sera envoyée vers un mot de 16 bits (ModBus) ou vers un url, vers un formulaire et donc sans limite de taille.

Applications

Code de sécurité.
Ouverture de coffre sécurisé car le code n'est pas dans le fichier wagoML mais dans le dispositif commandé.
Activation, désactivation d'alarmes
Utilisation quand une valeur numérique précise est utile, mot modBus de 0 à 65535
Ajout possible du code PIN

Bouton ON

Code de référence, affichage = button


<item id="0">

 	<title>Test</title>

 	<name>Allumer</name>

 	<description>Allumer la lampe</description>

 	<IW>ON</IW>

 	<affichage>button</affichage>

 	<link>http://IP/parametres_de_la_commande</link>

</item>

Bouton OFF

Code de référence, affichage = button


<item id="0">

 	<title>Test</title>

 	<name>Eteindre</name>

 	<description>Eteindre la lampe</description>

 	<IW>OFF</IW>

 	<affichage>button</affichage>

 	<link>http://IP/parametres_de_la_commande</link>

</item>

Bouton poussoir simple et temporisé

Bouton poussoir

Code PIN : oui

Code de référence, affichage = push


<item id="0">

 	<title>Test</title>

 	<name>Push Button</name>

 	<description>Test push</description>

 	<IW>0</IW>

 	<affichage>push</affichage>

 	<link>http://IP/parametres_de_la_commande?param=%d</link>

</item>

Bouton poussoir temporisé

Code PIN : oui

Code de référence, affichage = pulse


<item id="0">

 	<title>Test</title>

 	<name>Pulse Button</name>

 	<description>Test pulse</description>

 	<IW>0</IW>

 	<affichage>pulse</affichage>

 	<minimum>1.5</minimum>

 	<link>http://IP/parametres_de_la_commande?param=%d</link>

</item>

"push" est un bouton spécial qui doit rester appuyé pour conserver l'état 1 sinon il retombe à zéro. une variante avec le bouton "pulse" qui retombe à zéro après une temps fixe déterminé.
Ce dernier type est particulièrement adapté au montage de tire-suisse, pour une commande d'ouverture de porte.

Bouton poussoir double et temporisable version 2.0+

Bouton poussoir double

Code PIN : oui

Code de référence, affichage = volet


<item id="0">

 	<title>Test</title>

 	<name>Push double bouton</name>

 	<description>Test push</description>

 	<IW>0</IW>

 	<affichage>volet</affichage>

 	<link>http://IP/parametres_de_la_commande?param=%d</link>

</item>

Bouton poussoir double temporisé

Code PIN : oui

Code de référence, affichage = volet


<item id="0">

 	<title>Test</title>

 	<name>Pulse duuble bouton</name>

 	<description>Test pulse</description>

 	<IW>0</IW>

 	<affichage>volet</affichage>

 	<minimum>1.0</minimum>

 	<link>http://IP/parametres_de_la_commande?param=%d</link>

</item>

"volet" est un bouton double spécial qui doit rester appuyé pour conserver l'état 1 sinon il retombe à zéro. une variante avec la présence du modificateur : minimum le bouton retombe à zéro après une temps fixe déterminé (en secondes).
Ce type est particulièrement adapté à la commande de volet roulant pour monter et descendre.
La valeur retournée sera 0, 1 ou 2 suivant le bouton utilisé.

Lampe, porte, cadenas, et autres...

PLCLink objects

Divers objets graphiques de représentation

Code PIN : oui

Code de référence


<item id="0">

 	<title>Test</title>

 	<name>Active Bulb light</name>

 	<description>Affichage : light</description>

 	<IW>1</IW>

 	<affichage>light</affichage>

 	<link>http://IP/parametres_de_la_commande</link>

</item>

Les divers types d'affichage sont :

light
door
lock
shutter
water
portal
fan
heater

Chaque type est ON ou OFF avec un icon correspondant.

L'icon présente une fléche à gauche si un lien actif permet de modifier l"état de la variable 0 ou 1, sinon c'est un simple affichage représentatif de la valeur, l'icon est explcite.

Switch

Code de référence, affichage = switch


<item id="0">

 	<title>Test</title>

 	<name>Commutateur</name>

 	<description>Allume/Eteindre</description>

 	<IW>1</IW>

 	<affichage>switch</affichage>

 	<link>http://IP/parametres_de_la_commande</link>

</item>

Slider

Code de référence, affichage = slider


<item id="0">

 	<title>Test</title>

 	<name>Slider</name>

 	<description>V : <!--#READPI ADR=QW1&FORMAT=%d--></description>

 	<type>lineaire</type>

 	<coef>0.00030518</coef>

 	<offset>0</offset>

 	<minimum>0</minimum>

 	<maximum>10</maximum>

 	<IW><!--#READPI ADR=QW1&FORMAT=%d--></IW>

 	<affichage>slider</affichage>

 	<wagolink>http://IP_automate/WRITEPI?ADR1=MW1&amp;VALUE1=%d&amp;FORMAT1=%d</wagolink>

</item>

Wheel

Code de référence, affichage = wheel


<item id="0">

 	<title>Test</title>

 	<name>Wheel</name>

 	<description>Val : 5</description>

 	<minimum>0</minimum>

 	<maximum>10</maximum>

 	<IW>5</IW>

 	<affichage>wheel</affichage>

 	<link>http://IP/parametres_de_la_commande</link>

</item>

Bar

Code de référence, affichage = bar


<item id="0">

 	<title>Test</title>

 	<name>Barre 2</name>

 	<description>Val = 0.1</description>

 	<IW0>0.1</IW>

 	<affichage>bar</affichage>

</item>

DATE

Code de référence, affichage = date


<item id="N">

 	<title>Test</title>

 	<name>Date</name>

 	<description>Date actuelle</description>

 	<type>direct</type>

 	<affichage>date</affichage>

 	<IW><!--#GETTIMEDATE FORMAT=%d.%m.%y %H:%M:%S--></IW>

</item>

La date de l'automate est retournée

Typiquement la date est affichée dans un caractère plus petit, la syntaxe des paramètres est celle du C standard.

TIME

Code de référence, affichage = time


<item id="N">

 	<title>Test</title>

 	<name>Réveil</name>

 	<description>Alarme horloge</description>

 	<affichage>time</affichage>

 	<IW><!--#READPI ADR=MW10&FORMAT=%d--></IW>

 	<wagolink>http://IP_automate/WRITEPI?ADR1=MW10&amp;VALUE1=%d&amp;FORMAT1=%d</wagolink>

</item>

Gestion de l'heure en lecture et en écriture, utilisable pour une alarme.

Un exemple de timer est disponible avec le code CoDeSys correspondant expliquant comment convertir la valeur du temps de PLCLink avec le temps dans CoDeSys.

Images

iphone : PLCLink

Code de référence, affichage = image


<item id="N">

 	<title>Image</title>

 	<affichage>image</affichage>

 	<url>http://str.grand-nancy.org/webcam_nan/image640-a.jpg?1331806950587</url>

</item>

Est utilisable aussi link pour placer l'adresse.
Option avec un user et password sur les url protégés.


 	<user>moi</user>

 	<password>pass</password>

Affichage d'une image fixe en provenance d'une webcam ou autre dispositif donnant un fichier accessible par url

Lecture régulière de l'url de l'image, utilisé pour l'affichage d'une webcam par exemple.
L'item est régulièrement rechargé (2s) l'image est donc aussi rechargée.

Exemple pour une webcam AXIS on utilise le mode STILL Image :
Url des webcams AXIS : http://192.168.0.2/axis-cgi/jpg/image.cgi?resolution=320x240

Vidéo

iphone : PLCLink

Code de référence, affichage = video


<item id="N">

 	<title>Video</title>

 	<affichage>video</affichage>

 	<link>url_de_la_video</link>

</item>

Affichage d'une vidéo live. L'url est seule utile c'est l'url du flux vidéo réél.
Format supporté : .mp4, .mov, .m4v et H 264.
- url d'un fichier vidéo .m4v (iTunes) est accepté.

Exemple : caméra de l'ordinateur

Vidéo direct de la caméra du mac, utilisez un logiciel de streaming par exemple 'EvoLV', activez le mode HTML5, regardez la page proposée sur le navigateur de l'ordinateur, en ouvrant le code source de la page vous trouvez facilement l'url du flux vidéo, c'est l'url qu'il vous faut utiliser dans le tag 'link'.

Non accepté
- L'url du fichier mpeg4 d'une webcam AXIS ne marche pas.
- Le mode RTSP ne marche pas car il n'est pas supporté par l'iOS.
- Une webcam en flash
La liste des items comportant une vidéo n'est pas rechargé.

iFrame : Affichage d'une portion de page web

Code de référence, affichage = iframe


<item id="N">

 	<title>Liste</title>

 	<name></name>

 	<description></description>

 	<affichage>iframe</affichage>

 	<url>https://www.youtube.coms/embed/XOLxkS7Gow</url>

</item>

Affiche une petite page web, adapté pour affichage de vidéo Youtube sur lequel la vidéo n'est souvent pas isolable facilement. Utilisable pour les cas d'affichage plus complexes avec une mise en forme de texte etc... La taille reste limitée dans la cellule de présentation.

Vous pouvez changer la hauteur prédefinie de 250 pixels avec le tag :
<height>300</height>

Room : déplacement rapide dans les rooms

Code de référence, affichage = room


<item id="N">

 	<title>Liste</title>

 	<name>Webcam</name>

 	<description>webcam nancy</description>

 	<affichage>room</affichage>

 	<IW>4</IW>

</item>

Déplacement vers une room particulière, sera utile pour une liste de rooms disponibles ou un déplacement rapide dans les divers écrans des rooms.
L'entrée classique <IW> sera un numérique vers la room destination.

Url : Affichage du contenu direct d'un url

Code de référence, affichage = url


<item id="N">

 	<title>URL test</title>

 	<name>URL</name>

 	<description>url demo</description>

 	<affichage>url</affichage>

 	<url>http://pautex.fr/plclink/url_demo.txt</url>

</item>

Note : <link> est aussi utilisable pour définir l'adresse mais <url> est plus cohérent.
Option : <user> et <password> sont utilisables pour des adresses sécurisés

Affichage du contenu d'un url spécifié dans <url> ou <link>
L'usage est de lire une valeur numérique ou textuelle directement retournée par un url. La taille du texte retourné est tronqué à 32 caractères.
- Le lien de l'exemple est actif.
- Sera utilisé pour afficher un court message texte seulement (32 caractères) pas pour une page web traditionnelle. Vous utiliserez de préférence un affichage "iframe" pour une page complète.

Des détails d'installation avec CodeSys sur le site ituilerie.

Utilisation de la fonction affichage de texte.

Week : Gestion des jours d'une semaine

Code de référence, affichage = week


<item id="N">

 	<title>Semaine</title>

 	<name>Semaine</name>

 	<description>week</description>

 	<affichage>week</affichage>

 	<IP>192.168.0.22</IP>

 	<IB>MW1</IB>

 	<OB>MW1</OB>

</item>

Décompose une partie d'un WORD vers une représentation en jours de la semaine.
Les jours notés : L M M J V S D sont les bits d'un word directement, le mot est de la forme :
word = 0000 0000 VLMM JVSD, V est un bit d'activation globale.
Un éditeur permet de choisir le jour et le bit d'activation (7).
Usage :
- Etablir une programmation hebdomadaire.
- Combiné avec Time pour un réveil en semaine.
Le mot (word) concerné sera à décomposer par CoDeSys pour utilisation, le Lundi sera le bit 6, Mardi le bit 5, etc...

La présence d'un lien de retour permet l'édition de la valeur via une série de switchs. L'affichage des jours de la semaine est localisé en Français Allemand et Anglais.

Month : Gestion des mois d'une année

Code de référence, affichage = month


<item id="N">

 	<title>Mois</title>

 	<name>Mois</name>

 	<description>month</description>

 	<affichage>month</affichage>

 	<IP>192.168.0.22</IP>

 	<IB>MW2</IB>

 	<OB>MW2</OB>

</item>

Décompose une partie d'un WORD vers une représentation en mois.
Les mois notés : J F M A M J J A S O D sont les bits d'un word directement, le mot est de la forme :
word = 000V JFMA MJJA SOND, V est un bit d'activation globale (bit 12).
Un éditeur permet de choisir le mois et le bit d'activation (12).
Usage :
- Etablir une programmation annuelle.
- Combiné avec "week" pour un usage annuel.
Le mot (word) concerné sera à décomposer par CoDeSys pour utilisation, Janvier sera le bit 11, Février le bit 10, etc...

La présence d'un lien de retour permet l'édition de la valeur via une série de switchs.

Bit : Gestion individuelle des bits d'un mot de 16 bits

Code de référence, affichage = bit


<item id="N">

 	<title>Mois</title>

 	<name>BIT</name>

 	<description>bit</description>

 	<affichage>bit</affichage>

 	<IP>192.168.0.22</IP>

 	<IB>MW3</IB>

 	<OB>MW3</OB>

</item>

Décompose un WORD vers une représentation en bit individuels.
Un éditeur permet de choisir et positionner le bit désiré
Usage :
- Etablir une programmation d'un mot de 16 bits
Le mot (word) concerné sera à décomposer par CoDeSys pour utilisation.

La présence d'un lien de retour permet l'édition de la valeur via une série de switchs.

RGB : Représentation d'une couleur

Code de référence, affichage = rgb


<item id="N">

 	<title>Couleur</title>

 	<name>Couleur</name>

 	<description>cellule RGB</description>

 	<affichage>rgb</affichage>

 	<IP>192.168.0.100</IP>

 	<IB>MW5</IB>

 	<OB>MW5</OB>

</item>

Utilise un WORD pour la représentation d'une couleur (16 bits) pour les trois composantes rouge, verte et bleu. Chaque composante est codée sur 4 bits sous la forme :
000x RRRR VVVV BBBB
Usage :
Régler une couleur plus facilement qu'avec trois sliders. Voir les détails pour d'autre format de sortie d'une couleur.

Le mot (word) concerné sera à décomposer par CoDeSys pour utilisation finale, pour une lampe la limitation à 4 bits pour une composante n'est pas pénalisante.

barcode : Lecture d'un code barre ou QR code

Code de référence, affichage = barcode


<item id="N">

 	<title>Codebar</title>

 	<name>Scan</name>

 	<email>myEmail</email>

 	<description></description>

 	<affichage>barcode</affichage>

 	<link>http://IP_serveur/read.php?code=%s</link>

</item>

Ouvre un lecteur de code barre ou de QR code, le code scanné est ensuite envoyé vers l'url spécifié.

La sortie après lecture est automatique vers l'adresse du <link> cette adresse devra comporter une variable "%s" qui sera remplacée par la valeur du code, le texte est parfois long et pas nécessairement un nombre. Vous devez implementer une réception du texte sur un serveur, l'automate ne permet pas directement l'introduction du texte complet avec un transfert ModBus limité aux objets de type 'WORD' 16 bits sur cette installation.

Le code n'est pas interprété mais seulement envoyé brut vers votre url. Si <email> est présent, il permet l'envoi du code par messagerie sur l'adresse spécifiée.

index