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.
<item id="0">
<title>Test</title>
<name>Lampe</name>
<description>Etat actuel de la.</description>
<IW>0</IW>
<affichage>text</affichage>
</item>
<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>
<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.
<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>
<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>
<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>
<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.
<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>
<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é.
Divers objets graphiques de représentation
<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 :
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.
<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>
<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&VALUE1=%d&FORMAT1=%d</wagolink>
</item>
<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>
<item id="0">
<title>Test</title>
<name>Barre 2</name>
<description>Val = 0.1</description>
<IW0>0.1</IW>
<affichage>bar</affichage>
</item>
<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.
<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&VALUE1=%d&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.
<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
<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é.
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é.
<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>
<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.
<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.
<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.
<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.
<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.
<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.
<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.