PLCLink 1.6.1 pour iOS

Introduction

PLCLink permet de faire de la supervision avec un iPhone sur divers dispositifs d'automatisme connectés sur Internet. Les PLC Ethernet WAGO sont totalement compatibles et souvent utilisés par la suite. C'est une application pour utilisateur final, particulièrement adapté comme télécommande domotique. La version iOS5.x est très fortement conseillée.
Les transferts : ModBus TCP et HTTP
- Les transferts sont réalisés via le protocole "http://" sur le port 80 ou en ModBus (port 502), la plupart les automates acceptent les commandes ModBus TCP.
- Le ModBus est disponible en lecture/écriture vers des variables 'bit (X)' ou 'word (W)' avec certaines restrictions. Un mode synchrone est disponible, il permet d'attendre la réponse avant la prochaine demande (Schneider), voir la note.

L'automate est supposé accessible via le réseau Internet et dispose donc d'un IP public, dans le cas contraire on utilisera un serveur qui fera l'intercalaire avec l'automate ou un routage de port sur le modem ADSL. PLCLink dispose de 3 méthodes pour lire ou écrire une variable.
Ecriture et lecture par ModBus, l'usage des plug-in SSI (Wago principalement) et le transfert par adresse URL.

PLCLink présente à l'utilisateur les informations disponibles via un fichier wagoML de configuration, analogie avec le fichier html pour le navigateur. Pour cela un fichier XML (en WagoML) descriptif sera réalisé et chargé par ftp dans l'automate, dans un serveur ou conservé dans l'application.
On trouvera donc ci-après deux méthodes d'installation chacune avec avec un icon spécifique.

PLCLink permet l'enregistrement vers un fichier .csv des valeurs, avec un export vers Excel ou Numbers, voir la note.

PLCLink utilise une installation existante en état de marche et n'est d'aucun secours pour la programmation de l'automate, en service l'application est autonome et n'utilise aucun autre transfert que vers les adresses IP désignées.

Installation : deux solutions

I - Installation distante

PLCLink install Vous pouvez vous reporter pour les détails de l'installation de "WagoLink" qui présente des fonctions similaires.

Le fichier wagoML est toutefois plus complet que pour WagoLink, il utilise la notion de "room" pour un cloisonnement des informations par pièces. On trouvera ici le maker du fichier wagoML spécifique.
Sur cette installation le fichier descriptif en wagoML est à charger dans l'automate ce qui permet un accès SSI aux variables, (dans ce mode le serveur remplace l'information dans le fichier XML à l'emplacement d'une balise spécifique) voir la descriptif.

Réaliser et tester un fichier WagoML spécifique pour PLCLink : wagoML Maker
PLCLink est capable de sauver et d'ouvrir une liste de réglages (user, pass et url).
Pour réaliser un fichier de liste c'est ici : ListeMaker, la sortie en mail ou en QR Code
Les transferts ModBus sont exploitables en écriture et en lecture.
Autres détails sur le WagoML sur cette page.
Le protocole plc:// permet d'introduire des listes, voir le QR code ci contre qui représente un réglage.

II - Installation locale

PLCLink install
Dans cette installation le fichier wagoML descriptif sera chargé dans l'iPhone, les transferts seront en ModBus (port 502) pour écriture et lecture de variable.
Le formulaire SSI (balise <wagolink>) en HTTP port 80 est utilisable pour l'écriture d'une variable ou une commande par url.
Vous devez consulter la documentation de votre automate pour les limitations des droits sur les accès ModBus TCP, certaines variables ne sont pas accessibles en écriture si un autre processus intervient.
Cette installation est la plus rapide de mise en oeuvre, sur l'iPad un éditeur est disponible.

Comment introduire le fichier dans PLCLink ?

Réaliser un fichier de configuration ModBus PLCLink : wagoML ModBus
Installation via un email, simple et pratique pour mettre à jour vos clients.
Certaines restrictions s'appliquent sur les variables en écriture, consulter la documentation du constructeur de l'automate.
Conservez les fichiers wagoML, lors de la mise à jour du système iOS il faudra les recharger.
Utilisez DropBox pour conserver les fichiers, il sera facile de les remonter dans PLCLink, DropBox est disponible dans iOS et permet l'ouverture dans PLCLink.
Autres détails sur le WagoML sur cette page.
Le protocole plclink:// permet de réaliser des liens vers un fichier wagoML qui sera importé, en particulier avec les QR code

Le fichier comporte sa référence il s'enregistre en mémoire avec une entrée nouvelle sur la fenêtre principale. Le nom peut être identique avec une entrée déjà existante.
La version de PLCLink utilise l'extension du fichier : .xml
Le type "xml" est bien intégré dans iOS5 et affiché par le navigateur le mail ou DropBox, une option est toujours présente pour le transfert vers une application comme PLClink qui apparait dans la liste des destinataires s'il est installé.

Présentation

Les fichiers WagoML

Descriptif

Un fichier WagoML est un fichier descriptif de la représentation d'un groupe de variables.
Ce fichier est l'analogue de la page html pour un navigateur.
Ce fichier est soit situé dans l'automate (qui sera donc le serveur) soit dans l'iPhone, il est réalisé par le Maker disponible ici ou avec un éditeur de texte (format UTF-8).

Des détails sur le WagoML ici : Le format WagoML
Les spécifications du WagoML : Spécifications

Cloisonnement en "rooms"

L'aspect primaire est le cloisonnement logique en groupe de variables, une room représente l'ensemble des variables qui représente un groupement logique pour vous.
Le passage d'une room vers une autre est classiquement réalisé par un balayage sur l'écran de l'iPhone. Des indicateurs (flèches) montrent si une autre room est présente.

Les appels réseau ne sont réalisés que pour la room active, les appel ModBus sont donc groupés par room, ils sont soit asynchrone (mode normal) tout les appels puis attente des réponses, soit synchrones, attente de la réponse avant l'appel suivant. (version 1.5.5)

Code PIN d'une "room"

Un code PIN est disponible pour la protection d'une room, vous devez ajouter la ligne suivante dans la définition de la room ou dans la définition d'un item
<pin>CODE</pin>
Le CODE est numérique sans limite de taille. La room ou l'item seront activés dès que le code est saisi.
Sans le code les autres rooms sont disponibles normalement.
Le code est valide pour la session, il vous faut revenir sur l'écran de la liste de base pour invalider le code pin.
Sur le fichier exemple de base, la dernière room est protégée par le code : 123

Code PIN d'un item

Certains items acceptent un code PIN voir le tableau des éléments.
Le code PIN sur un item laisse apparaître un cadenas rouge. La demande de code apparaît lors de l'activation du bouton. Ensuite le cadenas vert indique que la fonction est disponible durant 30 secondes.

Validation du fichier XML

Note : La cause la plus fréquente d'erreur est l'usage d'un éditeur de texte qui ne sauve pas comme fichier UTF-8, ou une erreur dans la syntaxe, voir la validation avec le site de validation XML ci-contre.

Objets de représentation

Cette page liste les divers représentations d'une variable de l'automate avec un exemple de code source pour le fichier WagoML. Ces petits symboles peuvent être des boutons, leur état représente la variable associée.

La balise <affichage> décide du mode de representation dans la cellule.

Liste des symboles disponibles dans PLCLink : Interface utilisateur
PLCLink affiche aussi les images des webcams et certaines vidéo
Les objets classiques de l'interface iOS : bouton, switch, slider sont supportés.

Icons boutons

Un icon représente l'état d'une variable lue avec une commande dans <IW> ou dans <IB>, un lien de retour vers cette variable peut être associé pour modifier la valeur comme l'action d'un switch. Le lien est détecté par le présence d'une balise <link> ou <wagolink> ou <OB>.

La présence du lien de retour en fait le bouton actif, la variable change de valeur et la commande est envoyée lors de l'activation, l'icon aussi change de représentation, un léger délai est nécessaire.

Vidéo et image de webcam

L'option d'affichage : 'video' et 'image' associés avec <link> ouvre l'espace pour affichage de la vidéo d'une webcam et d'une image.
Pour afficher une vidéo vous devez disposer d'un flux vidéo H264 ou au moins compatible avec la vidéo actuelle sur iPhone. A partir d'une webcam de l'ordinateur ou d'une webcam USB il vous faudra un logiciel compresseur qui donnera un flux vidéo. Pour l'image fixe, il est fréquent de rencontrer le mode "STILL image" de la webcam, une nouvelle image est relus à chaque appel, c'est le mode le plus pratique à l'usage. La page donne quelques détails : détails sur la vidéo et l'image de webcam
Vous devez trouver l'url du flux vidéo réel de votre webcam H264 ou de l'image fixe dans la documentation de la webcam.

Bugs et ajout de fonctions

Les versions PLCLink

VERSION 1.5.8
- Corrige un bug de lenteur sur le switch si le minimum n'est pas à zéro.
- Corrige les bugs d'affichage avec la localisation "de" et "en"
- Ajoute le mode semaine (week) pour la programmation hebdomadaire.
- Ajoute le mode mois (month) pour la validation des mois de l'année.
- Ajoute le mode bit (bit) affichage et modification des bits d'un mot de 16 bits.
VERSION 1.6
- Ajoute le bouton POUSSOIR action à maintenir
- Ajoute le bouton PULSE qui réalise un pulse de durée fixe pour tire-suisse par exemple
- Corrige des bugs de déselection
- Ajoute une alerte sur un fichier WagoML non conforme.
VERSION 1.6.1 -ACTUELLE-
- Ajoute le code PIN de sécurité d'écriture sur certains items
- Ajoute la lecture par <url> pour la valeur de la plupart des objets.
- Ajoute la prise en charge des réponses en codage XML, extraction par XPATH.
- Ajoute la prise des lectures d'url sécurisés par user/password
- Amélioration, prise en compte des valeurs pour les boutons sur les 3 méthodes d'entrée.
VERSION 1.6.2 - en cours -
- Ajoute la lecture d'une variable par fichier en JSON
- Ajoute l'entrée par clavier numérique pour placer une variable sur une valeur précise, application de coffre, de tire-suisse ou d'ouverture sécurisée par combinaison secrète.

Problèmes fréquents

Plantage de l'application à l'ouverture d'un fichier
- Le plus souvent une erreur de fichier WagoML sur l'encodage des caractères.
- L'erreur est probablement introduite par votre éditeur de texte, la sortie doit être en UTF-8, une alerte est introduite avec la version 1.6
Vérification du fichier WagoML distant (dans l'automate) sur un site de test extérieur
- Composez l'url de votre automate : http://NOM:PASSWORD@IP_Automate:PORT/FichierWagoML.xml
- Si besoin désactiver le nom et le password temporairement.
- Passez l'url composé sur le site : http://www.validome.org/
- Vous trouvez rapidement la source d'une erreur grave, ou de non accès à votre fichier depuis l'extérieur.
Vérification du fichier WagoML local (dans l'iPhone) sur un site de test extérieur
- Déposer le fichier sur un serveur accessible. (votre machine en est sûrement capable)
- Composez l'url de votre fichier : http://IP_serveur/FichierWagoML.xml
- Passez l'url composé sur le site : http://www.validome.org/
- Vous trouvez rapidement la source d'une erreur grave, ou de non accès à votre fichier depuis l'extérieur.

Applications domotique

Réalisez des petits capteurs divers pour le Wago

PLCLink sur Internet

Démonstrations

Test de trois cartes relais 750-512 en commande directe via ModBus TCP.

Contacts

QR code de PLCLink sur ce site, permet d'accéder facilement au lien de chargement sur iTunes.

contact : Twitter email : Pautex JF

Geek Navigator pour iPhone et iPod et iPad

Geek Navigateur est un navigateur de code source pour iPod, iPhone, et iPad vous ne visualisez que le code source des pages visitées.

Voir le site suivant : "Geek navigateur" : http://pautex.fr/sourcenav/

PLC - automatisme et iPhone