Deif AGI 300 Advanced graphical interface Manuel utilisateur

MANUEL DE L'UTILISATION
Advanced Graphical Interface
AGI 300/400 series
DEIF A/S · Frisenborgvej 33 · DK-7800 Skive
Tel.: +45 9614 9614 · Fax: +45 9614 9615
[email protected] · www.deif.com
Document no.: 4189341104A
SW version
Ce document n'est pas à jour. Une version plus récente est disponible en anglais sur www.deif.com.
© 2012-2017 DEIF A/S
Nous nous réservons le droit d'apporter des modifications à ce document à tout moment
et sans préavis
Les informations contenues dans ce document sont exclusivement à titre d'information.
Bien que nous ayons entrepris tous les efforts raisonnables pour vérifier que les
informations contenues dans le présent document soient exactes, elles sont fournies
telles quelles (« as is ») et sans garantie quelle qu'elle soit.
Les marques et noms déposés de tiers sont la propriété de leurs détenteurs respectifs.
Microsoft®, Win32, Windows®, Windows XP, Windows Vista, Windows 7, Windows 8,
Visual Studio sont des marques déposées ou des marques de la Microsoft Corporation
aux États-Unis et dans d'autres pays. Les autres produits ou noms d'entreprises
figurant dans ce document peuvent être des marques qui sont la propriété de leurs
détenteurs respectifs.
Tous les noms d'entreprises, d'institutions, de produits et de domaines, adresses email, logos, personnes, lieux et événements cités à titre d'exemple dans ce document
sont fictifs. Ils ne contiennent aucune allusion, ni intentionnée ni sous-entendue, à une
entreprise, institution, produit, nom de domaine, adresse e-mail, logo, personne, lieu ou
événement réel.
Contenu
1
2
2
3
4
Premiers pas
1
Suppositions
6
Propriétés de projet
59
2
Volet des propriétés de projet
60
Installer l’application
2
Outils de développement
62
Runtime
7
Rendu des polices FreeType
65
Paramètres de base du périphérique IHM
8
Modules de plug-in de logiciels
66
Options de menu contextuel
8
Comportement
66
Événements
71
Le simulateur IHM
73
Service SNTP intégré
11
Runtime sur PC
12
Problèmes habituels d’installation
15
Méthodes de simulation des données
74
Mon premier projet
19
Paramètres du simulateur
74
L’espace de travail
20
Lancer et arrêter le simulateur
75
Créer un projet
20
Transférer le projet au périphérique IHM
77
Protocoles de communication
22
Télécharger vers le périphérique IHM
78
Concevoir une page
24
Paquet de mise à jour
81
La galerie des widgets
25
Le chargeur de runtime
83
Ajouter des variables
27
Charger projets
84
Exporter les variables
29
Variables système
85
Importer les variables
30
Variables d'alarmes
87
Associer un widget à des variables
33
Variables du signal sonore
87
Pages de dialogues
35
Variables de communication
88
Concepts de programmation
37
Variables de passage à l'heure d'été
88
Types de données
38
Variables périphériques
89
Paramètres « Associer à »
38
Variables informations de vidage
91
Événements
43
Variables client FTP
92
Positionnement des widgets
46
Variables clavier
92
Gestion widgets chevauchants
47
Variables réseau
92
Grouper des widgets
48
Variables d’impression
93
Changer les propriétés de plusieurs widgets
54
Variables client à distance
94
Variables de version
94
Variable écran
95
Changer la propriété couleur de remplissage
en fonction des valeurs de variable
57
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
7
8
9
I
10
11
Variables carte SD
95
Variables serveur
95
Variables d’heure
96
Variables écran tactile
96
Variables lecteur USB
98
Variables de gestion des utilisateurs
98
Variables système non volatiles
99
Précisions sur la mémoire rémanente
100
Configurer la mémoire rémanente
100
Actions
14
15
105
Actions d'alarmes
106
Actions d'événements
106
Actions multilangues
107
Actions clavier
107
Actions lecteurs médias
109
Action FTP
109
Actions de page
148
Démarrage du serveur VNC sur les
périphériques Linux
149
Démarrer l’afficheur VNC
150
Alarmes
151
Éditeur d'alarmes
152
Confirmer les alarmes à distance
154
Machine à états pour alarme
155
Configurer les événements
156
Widget alarmes actives
159
Widget historique des alarmes
163
Gestion des alarmes à l'exécution
163
164
112
Exporter la mémoire tampon des alarmes
vers fichiers .csv
165
Actions d'impression
116
Exporter la configuration des alarmes
165
Actions de recette
117
Actions client à distance
122
Gestion des recettes
169
Actions système
123
Configuration d’un widget de recette
172
Actions de variable
130
État de la recette
173
Actions de tendance
132
Charger/télécharger une recette
173
Actions de gestion des utilisateurs
135
Sauvegarder et restaurer des données de
recettes
174
Actions widget
138
Utiliser l’application client
16
Tendances
169
175
Enregistrement des données
176
142
Exporter les données de mémoire de
tendance
177
142
Widgets de tendance
178
Tendances historiques
180
Propriétés du widget de tendance
182
Gestes de widget de tendance
183
Valeurs hors de portée ou non valides
184
142
Espace de travail
Paramètres et options de fuseau horaire
Utiliser le serveur FTP intégré
Recettes
141
La barre d'outils de l’application client
Paramètres FTP
II
Démarrage du serveur VNC sur les
périphériques WinCE
Afficher les données d’alarme actives
Transférer des fichiers à un périphérique IHM
distant
143
13
147
Activer/désactiver les alarmes à l’exécution 163
17
12
Utiliser VNC pour accès à distance
145
145
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
18
Afficher les valeurs de tendance
185
Configurer utilisateurs
226
Widget de diagramme de dispersion
186
Utilisateur par défaut
227
189
Gestion des utilisateurs à l'exécution
227
Éditeur de transfert de données
190
Imposer la connexion à distance
228
Exporter données vers fichiers .csv
192
Transfert de données
23
Limites et recommandations du transfert de
données
192
19
Gestion de nœud hors ligne
Processus de gestion du nœud hors ligne
195
196
Processus de gestion manuelle du nœud
hors ligne
196
Configuration manuelle hors ligne
196
21
Activer/désactiver le journal d’audit
230
Configurer les événements d'audit
230
Configurer les variables pour le journal
d’audit
231
Configurer les recettes pour le journal d’audit 232
Configurer les détails de
connexion/déconnexion
233
199
Exporter le journal d’audit au format .csv
233
L'éditeur multilangue
201
Afficher les journaux d’audit
234
Changer de langue
202
Widgets multilangues
202
Multilangue
24
Rapports
235
Ajouter un rapport
236
Exporter/importer des chaînes multilangues 204
Configurer les rapports de texte
236
Modifier la langue à l'exécution
206
Configurer les rapports graphiques
237
Limites de la prise en charge UNICODE
206
Événements déclencheurs d'impression
238
209
Imprimante par défaut
239
Planificateur
Créer un ordonnancement
210
25
Ordonnancement Haute Fréquence
210
Ordonnancement des tâches répétitives
211
26 Sauvegarder/restaurer le runtime et le
projet
245
Écran de veille
27
247
Claviers
243
Configurer un emplacement pour les
ordonnancements
213
Créer et utiliser des claviers personnalisés
249
Configurer le widget planificateur
213
Supprimer ou renommer des claviers
personnalisés
251
214
Type de clavier
251
Gestion et mots de passe utilisateur
217
Emplacement du clavier
252
Activer/désactiver la gestion de sécurité
219
Configurer groupes et autorisations
Modifier permissions d’accès
Ordonnancement des événements à
l’exécution
22
229
Configurer les alarmes pour le journal d’audit 232
Détection automatique de nœuds hors ligne 197
20
Journaux d’audit
Claviers externes
253
219
Rechercher et filtrer
255
220
Touches affichées
255
Retirer des associations d'actions
255
Assigner des permissions par widget à partir
du mode Page
225
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
28
III
29
Mise en page du clavier
256
Utilisation de variables structurées
Activer/désactiver clavier
256
JavaScript dans les widgets personnalisés 316
Associer des actions à des touches
256
Galerie de l’utilisateur
Référence croisée de variables
259
Mettre à jour les données dans le volet
Référence croisée des variables
30
261
263
Générer un ensemble d’adressage indexé
264
Utilisation d’un ensemble de variables
indexées sur les pages
267
31
Serveur à architecture unifiée OPC
269
32
Widgets spéciaux
33
IV
Adressage indexé
34
35
Envoyer un message par e-mail
314
318
321
Configurer le serveur e-mail
322
Configurer les e-mails
322
JavaScript
325
Éditeur JavaScript
327
Exécution des fonctions JavaScript
327
Événements
329
271
Événements de widget
330
Widget de navigateur
272
Événements de page
334
Widget Canevas
273
Événements système
335
Widget liste déroulante
276
Objets
336
Widget compteur de consommation
280
Objets de classe widget
337
Widgets de liste de contrôle
282
Propriétés du widget
338
Widgets Date & Heure
283
Méthodes du widget
340
Widget de zone de mouvement
284
Objet de page
342
Widgets caméra IP
285
Propriétés de l'objet de page
342
Widget de blocage de fonction Javascript
289
Méthodes associées à l'objet de page
343
Widgets de lecture de médias
290
Objet de groupe
345
Widget d'image multi-états
293
Méthodes d'objet de groupe
345
Widget multi-couche d’image multi-états
294
Objet du projet
346
Widget adaptateurs réseau
296
Propriétés d'objet du projet
346
Widget de flux RSS
296
Méthodes d'objet du projet
347
Faire défiler le widget de flux RSS
297
Widgets d'objet du projet
357
Widget tableau
298
Objet d'état
358
Widget de variables
306
Méthodes d'objet d’état
358
309
Mots-clés
359
310
Fonctions générales
360
Créer un widget personnalisé
310
Prendre en main la lecture/l’écriture de
fichiers
360
Ajouter des propriétés à un widget
personnalisé
312
Limites lors du travail avec des widgets en
JavaScript
363
Widgets personnalisés
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Déboguer JavaScript
364
Tableau de fonctions et limites
430
36
Gestes de prise en main
367
Capacités des périphériques IHM.
431
37
Paramètres du système
369
Compatibilité
432
Paramètres du Système sur les
Périphériques WinCE
370
Projets de conversion entre les différents
périphériques IHM
432
Paramètres du Système sur les
Périphériques Linux
381
44
Accès web
401
Plateformes et navigateurs pris en charge
402
Créer une page pour accès web
402
Pages d'accueil de plateforme spécifiques
404
Tester projet web
404
Télécharger projet web
405
Problèmes de connectivité web
406
Fonctionnalités web prises en charge
408
Résolution des problèmes et FAQ
411
45 Mettre à jour les composants système
des périphériques IHM
46
49
413
Protocoles de communication
435
A-B ENET
437
A-B DF1
449
A-B DH-485
462
Beckhoff ADS
476
CANopen HMI
491
CODESYS V2 ETH
498
CODESYS V3 ETH
511
Ethernet/IP CIP
521
J1939
547
Modbus RTU
557
Modbus RTU Server
573
TCP Modbus
589
Mise à jour des composants système de
l’application
414
Modbus TCP Server
606
Paramétrages
415
Mitsubishi FX ETH
618
Protéger l’accès aux périphériques IHM 417
Mitsubishi FX SER
633
Mitsubishi iQ/Q/L ETH
642
NMEA 0183
652
Omron FINS ETH
676
421
Omron FINS SER
687
Optimisation statique
422
OPC UA Client
697
FAQ sur l’optimisation statique
425
Simatic S7 PPI
705
Mise en cache de page
426
Simatic S7 ETH
712
Image DB
426
Simatic S7 MPI
744
Pré-cachage
426
Variables
770
FAQ sur le pré-cachage
427
Changer de mot de passe sur le périphérique
IHM
418
Ports et pare-feux
47 Trucs et astuces pour améliorer la
performance
48 Précisions fonctionnelles et
compatibilité
418
429
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
V
VI
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
1
Premiers pas
AGI Creator est un logiciel de création de pages graphiques IHM. AGI Creator a une interface glisser-déposer qui le rend
facile pour créer des pages complexes. La plupart des fonctionnalités présentes dans les applications courantes de
Windows sont également disponibles en AGI Creator.
Ce document est divisé en chapitres qui décrivent les principales fonctions de AGI Creator et expliquer comment les
utiliser. Chaque chapitre est présenté d'une manière autonome, vous permettant de sauter de chapitre à chapitre, en
fonction de la tâche à accomplir.
Suppositions
2
Installer l’application
2
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
1
Suppositions
Suppositions
Nous supposons que les lecteurs possèdent une compréhension de base des ordinateurs, Microsoft Windows, et
l'environnement de réseau spécifique où l'application sera exécutée.
Installer l’application
L'installation de AGI SW Packcontient :
l
l
l
l
AGI Creator : une application pour concevoir des projets IHM personnalisés de façon conviviale, assortie d'une
palette d'objets dans sa bibliothèque intégrée, la Galerie des widgets.
AGI Client : une application légère qui peut être utilisée sur les ordinateurs Windows pour visualiser et gérer à
distance un projet exécuté sur un périphérique IHM.
HMI Runtime : une application autonome qui fonctionne sur les périphériques IHM. Le runtime IHM est installée via
le AGI Creator.
AGI PC Runtime : une application autonome qui fonctionne sur les plateformes Win32 (sur les ordinateurs plutôt que
sur les périphériques IHM).
Exigences de système AGI Creator
AGI Creator a les exigences de système suivantes :
Système d'exploitation
Windows XP (SP2 ou SP3)
Windows Vista Business/Ultimate
Windows 7
Windows 8
Windows 10
Stockage
500 MB Minimum
RAM
512 MB
Autres
Une connexion Ethernet
Procédure d'installation
Pour installer AGI SW Pack:
1. Exécutez l'installation de AGI SW Packet cliquez sur Suivant.
2. Lisez la licence du logiciel AGI Creatoret acceptez les conditions.
2
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
1 Premiers pas
3. Suivez les instructions données à l'écran. L'emplacement par défaut pour le logiciel est C:\Program Files\DEIF\AGI
Software Pack, changez le chemin si besoin.
4. Si l'étape Sélectionner les composants est disponible, sélectionnez les composants que vous souhaitez installer.
5. Sélectionnez l'option Créer une icône de bureau pour ajouter une icône AGI Creatorsur votre bureau. Un groupe
AGI SW Packest automatiquement ajouté au menu Démarrage par la procédure d'installation.
6. Pour exécuter l'application, cliquez sur l'icône du bureau ou sélectionnez Démarrage > Tous les programmes >
AGI Creator.
Version d'essai
AGI Creator est disponible en version d'essai gratuite valable 30 jours. 30 jours après l'installation, un formulaire
d'enregistrement apparaîtra à l'écran et il vous sera demandé d'entrer la clé d'activation de la licence.
Note : La version d'essai n'est pas supportée par les machines virtuelles, seules les licences valides peuvent
être utilisées.
Licence
Pour enregistrer le logiciel avant la fin de la période d'essai, allez sur Aide > Enregistrer.
Note : La procédure d'enregistrement demande une connexion Internet. Les ports TCP 80 et 443 sont utilisés
pour l'activation.
Pendant l'enregistrement, un fichier de licence est téléchargé sur l'ordinateur à partir du serveur de licences. Les fichiers de
licence sont sauvegardés dans les dossiers suivants, en fonction du système d'exploitation :
%appdata%\DEIF A/S
Les licences sont verrouillées avec l'ID BIOS ou l'ID du produit Windows de l'ordinateur où le logiciel a été installé.
Si AGI Creatorne parvient pas à joindre le serveur de licences (par exemple, aucune connexion Internet n'est disponible),
un bouton s'affiche et permet d'activer la licence par email.
En appuyant sur le bouton « Envoyer E-mail », le AGI Creator affichera ce formulaire :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3
Installer l’application
Cet email vous sera envoyé ultérieurement, dès qu'une connexion Internet sera disponible. Vous pouvez aussi activer les
licences et télécharger les fichiers de licence à partir du site web https://licenses.x-formation.com/licenses, en indiquant
les mêmes données que celles figurant dans le "Corps" du formulaire ci-dessus.
Vérifier l'état de la licence
Pour vérifier l'état de votre licence :
1. Allez sur : https://license.x-formation.com/licenses
2. Entrez votre clé d'activation et cliquez sur le bouton Connexion.
Installer des versions multiples de AGI SW Pack
Vous pouvez installer différentes instances de AGI SW Packsur un même ordinateur. Chaque installation a ses propres
paramètres et peut être désinstallée individuellement.
Trois scénarios d'installation sont possibles :
Scénario d'installation
Résultats
Première installation de AGI SW Packdans le système
Le logiciel est installé dans le dossier de destination
spécifié
Système avec seulement une instance de AGI SW
Packdéjà installée
La version actuelle peut être remplacée ou maintenue.
Système avec de multiples instances de AGI SW Packdéjà
installées
La dernière version installée peut être remplacée ou
maintenue.
Si vous essayez d'installer une deuxième instance d'une version déjà installée de AGI SW Pack, un message
d'avertissement apparaîtra.
Plusieurs installations AGI SW Pack partagent un dossier d'espace de travail commun, chaque sous-dossier comprend le
numéro de version, par exemple C:\Program Files\DEIF\AGI Software Pack 2.5. Chaque version installée a son propre ID
et peut donc être éliminée individuellement.
Chaque installation est mentionnée séparément dans le menu de démarrage de Windows.
4
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
1 Premiers pas
Ouvrir d'anciens projets
Lorsque vous ouvrez un projet (fichier .jpr) AGI Creatorcréé avec une version moins récente du logiciel, AGI Creatorvous
demande de convertir le projet dans la version actuelle :
Option
Description
Convertir et écraser le projet actuel
Le projet est converti sans version de sauvegarde de la
version originale
Sélectionnez un nouvel emplacement avant de
convertir le projet
Le projet est copié dans le dossier spécifié, puis converti.
AVERTISSEMENT : N'éditez pas de projets avec une version de AGI Creator moins récente que celle
utilisée pour les créer. Cela risquerait d'endommager le projet et d'entraîner une instabilité de
fonctionnement.
Multilanguage pour AGI Creator
AGI Creator est disponible en plusieurs langues. Toutes les langues sont installées par défaut dans le cadre de AGI SW
Pack.
La langue par défaut est l'anglais. Pour la modifier, allez sur Aide > Changer de langue.
Rapports de crash
Une boîte de dialogue de rapport de crash apparaît toutes les fois qu'un gel ou un plantage de AGI Creator se produit.
Important : Sauvegardez toujours les fichiers de rapport de crash, car ils peuvent contenir des
informations utiles pour l'assistance technique.
Note : Les rapports de crash ne sont pas disponibles sur Windows XP.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
5
Installer l’application
6
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2
Runtime
HMI Runtime est conçu pour supporter les différentes plates-formes et les différents systèmes d'exploitation.
Paramètres de base du périphérique IHM
8
Options de menu contextuel
8
Service SNTP intégré
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11
7
Paramètres de base du périphérique IHM
Paramètres de base du périphérique IHM
Les périphériques IHM sont livrés depuis l'usine sans le runtime. Si aucun runtime n’est installé sur le périphériques, voir
"Le chargeur de runtime" on page 83 pour obtenir plus de détails.
Modes de runtime
Le HMI Runtime est composé de deux unités logiques :
l
l
Serveur : exécute les protocoles de communication, collecte les données, gère les alarmes, génère des
échantillonnages de mémoire des tendances.
Client : affiche les données collectées par le serveur.
L'unité serveur est responsable de la gestion des services IHM tels que les protocoles de communication, de l'acquisition
de données, de la génération d'échantillonnages de mémoire des tendances, etc.
L'unité client est la partie responsable du processus de visualisation : utilisez les données collectées par le serveur pour les
afficher à l'écran sous forme d'informations graphiques.
L'unité serveur fonctionne selon deux modes opératoires :
l
l
Mode de configuration : le serveur est inactif (par exemple quand aucun projet n'est chargé sur le périphérique ou
quand il manque des fichiers système).
Mode opérationnel : le serveur fonctionne selon les paramètres définis par les fichiers système et par le projet
d'application chargé.
Note : Les données sur l'unité client peuvent s'afficher même en l'absence d'activité sur le serveur.
Options de menu contextuel
Sur le périphérique IHM, appuyez sur un espace vide de l'écran et maintenez enfoncé pendant quelques secondes pour
afficher le menu contextuel.
Zoom avant / arrière
Sélectionner la taille de la vue à l’exécution
Mode panoramique
Active/désactive le mode panoramique après un zoom avant
8
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2 Runtime
Paramétrages
Paramètres
principaux
Description
Retard(s) menu
contextuel
Retard de l'activation du menu contextuel. Plage : 1–60 secondes.
Afficher curseur
occupé
Affiche un sablier lorsque le système est occupé
Utiliser claviers
Affiche les claviers lorsque l'utilisateur touche un champ d'entrée des données.
Défini sur désactiver lorsqu'un clavier USB externe est connecté au périphérique.
Conserver les
données rémanentes
en téléchargeant le
projet
Conserve le contenu des données non volatiles en chargeant ou téléchargeant le
projet.
Mot de passe
Définit les opérations protégées par mot de passe parmi les suivantes :
l
Télécharger projet/Runtime
l
Charger projet
l
Gestion de carte (mise à jour BSP)
Voir "Protéger l’accès aux périphériques IHM" on page 417 pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9
Options de menu contextuel
Gestionnaire de projet
Cet outil vous permet de :
l
décharger le projet en cours
l
charger un autre projet
l
supprimer un projet.
Lorsque vous chargez un nouveau projet, le projet en cours est automatiquement déchargé. Vous devez décharger un
projet avant de pouvoir le supprimer.
Mise à jour
Cette fonction charge des paquets de mise à jour à partir d'un lecteur USB externe. Voir "Paquet de mise à jour" on
page 81pour plus de détails.
Sauvegarde
Vous pouvez créer une copie de sauvegarde du runtime et du projet.
Enregistrement
Cette fonction affiche un enregistrement des opérations système.
Cliquez sur Enregistrer dans un fichier pour sauvegarder les données : un fichier logger.txt file est sauvegardé dans le
dossier ...\var\log.
Ce fichier peut être récupéré avec un client FTP et transféré au support technique.
10
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2 Runtime
Note : Une fois activé, l'enregistrement est maintenu après les cycles d'alimentation et doit être désactivé
manuellement.
Afficher le journal au démarrage
Cette fonction active l'enregistrement au démarrage. Si l'option Enregistrer dans un fichier a été activée, les fichiers
d'enregistrement sont sauvegardés à partir du démarrage.
Déconnexion
Déconnecte l'utilisateur actuel.
Show System Settings
Autoriser les paramètres IHM et la gestion des composants du système. Voir "Paramètres du système" on page 369 pour
plus de détails.
Outils de développement
Fonctions utilitaires pour déboguer à l'exécution. Elle est visible uniquement si elle est activée dans les Propriétés du projet
(voir "Outils de développement" on page 62 pour plus de détails)
À propos
Cette fonction affiche les informations à propos de la version du runtime.
AVERTISSEMENT : L'action Menu contextuel ne fonctionne pas lorsqu'elle est exécutée depuis une
page de dialogue.
Service SNTP intégré
Le périphérique IHM inclut un SNTP intégré qui synchronise le volet de l'horloge en temps réel interne lorsque le serveur
prédéfini est disponible. Le système recherche le serveur SNTP lorsqu'il est allumé, ou une fois par semaine si le
périphérique IHM n’est pas désactivé.
Utilisez un périphérique IHM "Paramètres du système" on page 369pour configurer le service.
Disponibilité : BSP v1.76 ARM/2.79 MIPS ou version ultérieure
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11
Service SNTP intégré
2
Runtime sur PC
AGI PC Runtime pour Windows est une plateforme IHM qui combine des fonctionnalités IHM avancées et des graphiques
vectoriels avec des technologies web puissantes. Vous pouvez choisir cette plateforme pour superviser et contrôler votre
équipement à l'aide de variables, d'alarmes, de planificateurs, de recettes, de tendances, de logique Javascript et
d'événements.
AGI PC Runtime assure une connectivité avec les protocoles d'automatisation industriels et des bâtiments via Ethernet et
des interfaces série.
Exigences de système AGI PC Runtime
AGI PC Runtime a les exigences minimales de système suivantes :
Système d'exploitation
Windows XP Professional
Windows XP Embedded
Windows Embedded Standard (WES 2009)
Windows Vista Business/Ultimate
Windows 7 Professional
Windows Embedded Standard 7
Windows 8
Windows Server 2003
Stockage
256 MB Min
RAM
512 MB
CPU
min. 300 MHz Pentium III ou processeurs similaires avec 500 MHz.
Graphique
min. SVGA
Autres
Une connexion Ethernet
Installer le runtime
AGI PC Runtime peut être distribué en tant que composant du AGI SW Pack ou en tant qu'application autonome. Au
moment d'installer le logiciel, assurez-vous de sélectionner l'option Runtime PC dans la boîte de dialogue Sélectionner
les composants.
Multiples instances de AGI PC Runtime
AGI PC Runtime peut être exécuté en plusieurs instances simultanées. Copiez le dossier d'installation sur un
emplacement modifiable et double-cliquez sur l'application IHM dans chaque dossier pour la démarrer.
12
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2 Runtime sur PC
Le port utilisé par AGI PC Runtime peut être modifié à partir de la boîte de dialogue des Paramètres. Redémarrez
l'application pour appliquer la modification du port.
Licence
AGI PC Runtime est disponible en version d'essai gratuite valable 30 jours. 30 jours après l'installation, un formulaire
d'enregistrement apparaîtra à l'écran et il vous sera demandé d'entrer les clés d'activation de la licence.
Pour enregistrer AGI PC Runtime avant la fin de la période d'essai, sélectionnez Enregistrer à partir du menu contextuel.
Note : la procédure d'enregistrement demande une connexion Internet. Les ports TCP 80 et 443 sont utilisés
pour l'activation.
Au moment de l'enregistrement, un fichier de licence est téléchargé sur l'ordinateur à partir du serveur de licences. Les
fichiers de licence sont sauvegardés dans les dossiers suivants, en fonction du système d'exploitation :
%appdata%\DEIF A/S
Les licences sont verrouillées avec l'ID BIOS ou l'ID du produit Windows de l'ordinateur où le logiciel est installé.
Si AGI PC Runtimene parvient pas à joindre le serveur (par exemple, aucune connexion Internet n'est disponible), un
bouton s'affiche et permet d'activer la licence par email.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
13
Service SNTP intégré
Voir "Installer l’application" on page 2 pour consulter les instructions sur la vérification de l'état d'activation.
Limites
Les fonctionnalités suivantes ne sont pas supportées dans AGI PC Runtime :
Fonction
Fonctionnalité NON supportée
Gérer cible
Section carte
Mode système/ Mode
utilisateur
Tap sequence et menu tournant
Lecteurs VNC/PDF
Logiciels informatiques non standards
Sauvegarde/Restauration Fonctions de sauvegarde et de restauration. Des logiciels informatiques standards peuvent
être utilisés à cette fin.
Protocoles
Protocoles série demandant un matériel spécial.
Voir "Précisions fonctionnelles et compatibilité" on page 429 pour plus de détails.
Mode plein écran
AGI PC Runtime peut démarrer en mode plein écran ou dans une fenêtre.
Pour passer au mode plein écran :
1. Cliquez à l'aide du bouton droit sur la fenêtre principale de AGI PC Runtime pour afficher le menu contextuel.
2. Sélectionnez Plein écran.
Le dossier d'espace de travail
Lorsque vous utilisez AGI PC Runtime, les fichiers de projet sont stockés dans un dossier d'espace de travail dans :
%appdata%\DEIF A/S\[build number]\server\workspace
où [build number] est un dossier nommé en tant que numéro de fabrication (par exemple 01.90.00.608).
14
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2 Runtime sur PC
Problèmes habituels d’installation
Important : S’assurer que les ports 80/HTTP et 21/FTP ne sont pas bloqués par le pare-feu.
Si un port est en cours d'utilisation et qu'un conflit est détecté, une boîte de dialogue est affichée pour permettre à
l'utilisateur de modifier les ports par défaut.
Voir "Protéger l’accès aux périphériques IHM" on page 417 pour plus de détails.
Dans certaines conditions, AGI PC Runtime il est impossible de détecter tous les services en cours d'exécution dans les
ports comme 80/HTTP et 21/FTP, cela doit être AGI PC Runtime fermé automatiquement. Cela se produit, par exemple,
lorsque IIS ou MS SQL Server ou d'autres services Windows sont en cours d'exécution sur ces ports. Dans ces cas,
désactiver les services windows
Si le téléchargement du projet devait AGI PC Runtime échouer, essayer une des procédures suivantes.
Problèmes avec les numéros de port
AGI PC Runtime utilise les ports 80 et 21 par défaut. Si au moins un est occupé, un message d'avertissement s'affiche :
S'assurer que lorsque vous modifiez ce port, vous modifiez également le port utilisé pour le téléchargement sur le
périphérique IHM dans AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15
Problèmes habituels d’installation
1. Depuis le Téléchargement jusqu’à la boîte de dialogue, sélectionner Avancé.
2. Modifier le numéro de port pour correspondre à celui situé sur AGI PC Runtime.
3. Cliquer sur OK pour confirmer : vous pouvez maintenant télécharger votre projet sur AGI PC Runtime.
Restauration des informations de port
Si des informations sur les modifications apportées à AGI PC Runtime ports d'écoute a été perdu, le message d'erreur
suivant est renvoyé :
Impossible d'établir la communication avec le runtime. Veuillez vérifier les paramètres de connexion et que le runtime est
en cours sur le périphérique IHM.
Le port utilisé par AGI PC Runtime peut être modifié à partir de la boîte de dialogue des Paramètres. Redémarrez
l'application pour appliquer la modification du port.
16
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
2 Runtime sur PC
Contourner le pare-Feu ou les blocs anti-virus
Si AGI Creator est en cours d’exécution sur la même machine que le AGI PC Runtime, votre pare-feu ou antivirus peut
bloquer la connexion depuis AGI Creator jusqu’à AGI PC Runtime.
1. Depuis la boîte de dialogue Téléchargement sur la cible, y taper manuellement l'adresse IP de l’ordinateur hôte
local 127.0.0.1.
2. Cliquez sur Télécharger.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17
Problèmes habituels d’installation
18
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3
Mon premier projet
Cette section décrit comment créer un projet AGI Creatorsimple.
L’espace de travail
20
Créer un projet
20
Protocoles de communication
22
Concevoir une page
24
La galerie des widgets
25
Ajouter des variables
27
Exporter les variables
29
Importer les variables
30
Associer un widget à des variables
33
Pages de dialogues
35
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
19
L’espace de travail
L’espace de travail
Zones d’espace de travail
AGI Creator espace de travail est divisé dans les principaux domaines suivants :
Domaine
Description
Vue du projet
Les éléments du projet dans un arbre hiérarchique du projet.
Vue de l’objet
Arborescence des widgets organisés par page.
Zone de travail
Espace où les pages sont éditées. Les onglets en haut de la zone montrent toutes les
pages ouvertes.
Propriétés
Propriétés de l'objet sélectionné.
Galerie des widgets
Bibliothèque des objets graphiques et des symboles.
Référence croisée de
variables
Liste des emplacements où une variable donnée est référencée.
Note : La mise en page de l'espace de travail peut être modifiée à tout moment, les modifications sont
enregistrées et maintenues grâce à des séances de travail.
Réinitialisation de la mise en page de l’espace de travail
Pour restaurer la mise en page par défaut, utilisez la fonction Fichier > Réinitialisation et redémarrage.
Créer un projet
Chemin : Fichier> Nouveau projet
20
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
1. Dans la boîte de dialogue Assistant de projet, entrez un nom de projet et d'emplacement de stockage.
2. Cliquez sur Suivant : la boîte de dialogue de sélection du périphérique IHM s'affiche.
3. Choisissez un périphérique dans la liste des modèles disponibles.
4. Choisissez l'orientation du périphérique.
5. Cliquez sur Terminer pour terminer l'Assistant.
Exceptions de rotation en portrait
Les éléments suivants ne pivotent pas en mode portrait.
Élément
Description
Boîtes de dialogue du système
d'exploitation
Paramètres du système et boîte de dialogue du système
Menu contextuel et boîtes de dialogue
associées
Gestionnaire de projet, À propos, Paramètres,
Enregistrement, Sauvegarde
Vidéo
IPCamera, MediaPlayer
JavaScript
Fonction Alerte et Impression
Pages de dialogues
« Titre » des pages de dialogue
Planificateur
Boîtes de dialogue pour la saisie des données
Macro
ShowMessage, LunchApplication, LunchBrowser
Applications externes
, VNC
Les périphériques IHM basés sur la plateforme Linux peut être tournés à partir de la BSP (voir l’onglet « Écrans »
depuis la page "Paramètres du système" on page 369"Paramètres du Système sur les Périphériques Linux" on
page 381) sans ces limites.
Changer le modèle de périphérique
Lorsque vous avez développé votre projet, vous pouvez toujours modifier le modèle de périphérique, à partir du volet
Propriétés du projet. Cela ne redimensionnera pas les widgets, mais ils seront déplacés sur l'écran. Un avertissement
s'affiche lorsque certains objets ne peuvent pas être déplacés.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
21
Protocoles de communication
Copier, déplacer et renommer un projet
Le dossier de projets de AGI Creator contient tous les fichiers du projet : pour déplacer, copier ou sauvegarder un projet,
déplacez ou copiez le dossier du projet à l'emplacement choisi.
Pour renommer un projet, utilisez la fonction Fichier > Sauvegarder le projet sous : cette opération peut prendre
quelques minutes.
AVERTISSEMENT : Ne renommez pas les dossiers de projet manuellement.
Protocoles de communication
Chemin : VueProjet> Configuration > Protocoles
Des pilotes de communication du périphérique sont configurés dans l'Éditeur de protocole.Vous pouvez ajouter autant de
protocoles que le nombre spécifié dans le Tableau de fonctions. Les Variables et les Variables système ne comptent pas
comme des protocoles.
Voir "Protocoles de communication" on page 435 pour plus de détails.
Note : vous pouvez exécuter différents protocoles Ethernet sur le même port physique Ethernet, mais vous ne
pouvez pas exécuter différents protocoles série en utilisant le même port série. Certains protocoles série
prennent en charge l'accès à plusieurs contrôleurs, mais cette option est définie au sein du protocole, qui compte
comme un seul protocole.
22
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
Ajouter un protocole
1. Cliquez sur +.
2. Sélectionnez le protocole depuis la liste API et entrez les valeurs requises.
Modifier les paramètres du protocole
Pour modifier les paramètres de configuration, cliquez sur le bouton Parcourir dans la colonne Configuration.
Paramètres du protocole
Cliquez sur l'icône Afficher propriétés avancées pour afficher tous les paramètres.
Paramètre
Description
Dictionnaires
Variables importées pour le protocole.
Voir "Importer les variables" on page 30 pour plus de
détails.
Activer Algorithme hors ligne Délai d'attente tentative
Voir "Détection automatique de nœuds hors ligne" on
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
23
Concevoir une page
Paramètre
Description
supplémentaire hors ligne
page 197 pour plus de détails.
Version
Version du protocole disponible dans AGI Creator pour le
périphérique IHM sélectionné.
Concevoir une page
Chemin : VueProjet > Pages
Lorsqu'un projet est créé, la première page est automatiquement ajoutée et affichée dans l'Éditeur de page.
Ajouter des objets sur une page
Glissez et déposez des objets depuis la Galerie des widgets vers la page.
Ajouter une page
1. Faites un clic droit sur le nœud Pages dans l'arborescence du projet et sélectionnez Insérer nouvelle page.
2. Tapez un nom pour la nouvelle page.
Importer une page
Lorsque vous importez une page, AGI Creator importe la mise en page et les widgets de la page sans importer les actions
et les liaisons de données associées aux widgets. Vous pouvez choisir entre deux comportements différents :
l
l
importer uniquement les pages et les widgets : toutes les actions et les liaisons de données doivent être définies
importer les pages avec les références aux actions et aux liaisons de données : les variables utilisées doivent être
présentes dans le projet pour que ces éléments fonctionnent correctement
Note : L'importation de pages peut uniquement être réalisée entre des projets créés avec la même version du
logiciel. Sauvegardez l'ancien projet en tant que dernière version, puis réessayez.
24
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
1. Faites un clic droit sur le nœud Pages dans l'arborescence du projet et sélectionnez Importer page.
2. Choisissez la page à importer depuis le projet voulu puis cliquez sur OK : un message d'avertissement s'affiche.
3. Cliquez sur Oui pour supprimer toutes les liaisons à des données et toutes les actions. Cliquez sur Non pour
maintenir la référence aux liaisons de données et aux actions. Les variables doivent être disponibles dans le
nouveau projet.
Groupe de pages
Vous pouvez grouper des pages similaires pour faciliter la maintenance. Grouper des pages n'affecte pas le mode
d'apparition des pages en cours d'exécution. Pour créer un groupe de pages :
1. Dans VueProjet, faites un clic droit sur le nœud Pages et sélectionnez Créer groupe : un nouveau dossier s'ajoute
2. Pour déplacer une page dans un groupe, faites un clic droit sur une page et sélectionnez Groupes > groupName.
La galerie des widgets
Chemin : Vue> Barres d’outils et Ancrage de fenêtres> Galerie Widget
Les objets IHM nécessaires à la construction d' une application sont disponibles dans la Galerie Widget. La galerie est
divisée en plusieurs catégories, chacune contenant une collection de widgets.
Ajouter des widgets à une page
1. Sélectionner le widget depuis la Galerie Widget.
2. Faites-le glisser et déposez-le sur la page.
Changer l'apparence d’un widget :
Tous les widgets ont des propriétés (volet Propriétés) qui peuvent être modifiées, certains widgets sont présentés dans
des styles différents. Vous pouvez cliquer sur les boutons dans chaque catégorie pour voir les styles disponibles.
Exemple
Pour définir le style du widget pour jauges rondes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
25
La galerie des widgets
1. Cliquez sur le bouton de style pour afficher les styles disponibles pour le widget.
2. Sélectionnez l'un des styles disponibles à partir de la barre d'outils : selon le widget sélectionné, différentes options
sont disponibles.
Widgets complexes
Certains widgets sont composés de plusieurs sous-widgets. Par exemple, un bouton est un widget complexe composé
d’un widget bouton et une étiquette. La structure des widgets peut être vue dans VueObjet lorsque le widget est
sélectionné.
Vous pouvez sélectionner un sous-widget, tels que l'étiquette dans un bouton, depuis VueObjet et le modifier sans
dégrouper tout le widget.
26
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
Ajouter des variables
AGI Creator utilise les noms de variables pour accéder à toutes les données du périphérique. Tous les champs et les
emplacements de référence dans le périphérique doivent se voir attribué un nom de variable pour être utilisé dans le projet
IHM.
L'éditeur de variable peut être utilisé pour créer et gérer des tags Après que les variables ont été définies, elles peuvent être
utilisées dans le projet en les attachant aux propriétés des widgets.
Voir "Paramètres « Associer à »" on page 38 pour plus de détails.
Éditeur de variable
Chemin : VueProjet> Variables
Ajouter une variable
1. Cliquez sur + et entrez les données requises.
2. Sélectionnez l'adresse depuis la boîte de dialogue d'adresse de protocole de communication : de nouvelles
variables sont nommés Variable1, Variable2, etc.
3. Cliquez sur le nom de la variable pour la renommer.
Propriétés de variable
Voir la documentation de protocole spécifique pour les détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
27
Ajouter des variables
Propriété
Description
Nom
Nom de variable unique au niveau du projet. Clé primaire pour identifier les informations dans la base de
données de variable de runtime.
AVERTISSEMENT : Il n’est pas autorisé de dupliquer les noms des variables.
Groupes
Noms de groupe associés à une variable
Pilote
Protocole de communication
Adresse
Adresse de mémoire du contrôleur.
Pour modifier, cliquez sur le côté droit de la colonne pour obtenir la boîte de dialogue dans laquelle vous
pouvez entrer les informations d'adresse.
Codage
Type de codage pour le type de données de chaîne (UTF-8, Latin1, UTF-2 et UTF-16)
Commentaire Description de la variable
Simulateur
Comportement de variable pendant la simulation. Plusieurs profils sont disponibles.
Mise à
l'échelle
Conversion appliquée à la variable avant le stockage de base de données.
Par formule = définie comme une transformation linéaire.
Par plage = définie comme une conversion de plage.
Les propriétés ci-dessous seront visibles uniquement après avoir sélectionné le mode « Afficher colonnes avancées »
depuis la barre d’outil de l’éditeur de variable.
Propriété Description
Nom de
variable
API
Nom de la variable de l’API original, utilisé pour faire correspondre les variables utilisées par le périphérique
(Nom de variable) et les étiquettes exportées depuis l’API
Taux
(ms)
Temps de rafraîchissement de la variable Par défaut : 500ms.
28
L/é uniquement dans une vue avancée pour permettre des réglages en cas d’erreurs d’importation de
variable.
AVERTISSEMENT : Le taux de rafraîchissement des variables est le taux de
rafraîchissement maximum Le taux de rafraîchissement réel dépend : du type de
communication (série, bus de terrain, Ethernet), du protocole, de la quantité de données
échangées.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
Propriété Description
L/é
Attribut de variable L/É (L/É, L ou É).
Note : Le contenu de variables d’écriture seule est toujours écrit et jamais lu. Lorsque la
communication n’est pas active, le contenu de ces variables peuvent ne pas être disponibles dans
les widgets.
Actif
Mode mise à jour.
faux = les variables sont lues à partir du contrôleur uniquement lorsque requis par le périphérique IHM.
vrai = les variables sont continuellement lues même si non requis par la page affichée.
Important : Laissez cette valeur sur faux pour une performance de communication plus
élevée.
Gestion des noms des variables
Les noms des variables doivent être uniques au niveau du projet. Si les mêmes variables, du même fichier de symboles
doivent être utilisés pour les deux contrôleurs différents, utilisez la fonction « Alias » pour ajouter un préfixe aux variables
importées et les rendre uniques au niveau du projet.
Note : Seuls certains protocoles prennent en charge cette fonction « Alias ».
Voir "Protocoles de communication" on page 435 pour plus de détails.
Gestion des groupes de variables
Les variables utilisées dans chaque page sont identifiées comme faisant partie d'un groupe, de sorte que les demandes
faites par le protocole de communication au/aux contrôleur(s) connecté(s) peuvent être traitées plus rapidement : seules
les variables incluses dans la page affichée sont interrogées à partir du contrôleur.
Exporter les variables
Chemin : VueProjet> variables
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
29
Importer les variables
1. Sélectionnez le protocole pour les variables que vous voulez exporter.
2. Cliquez sur le bouton Exporter variables : toutes les configurations des variables pour les protocoles sélectionnés
sont exportées dans un fichier .xml.
Vous pouvez éditer le fichier .xml qui en résulte avec des outils tiers (par exemple, Microsoft Excel) puis réimporter le
fichier modifié (voir "Importer les variables" below pour plus de détails).
Importer les variables
Introduction
Certains protocoles permettent d'importer des variables stockées dans un fichier séparé par une virgule (.csv ou autres
formats). Référez-vous à la section Importation des variables de chaque protocole pour obtenir plus de détails (voir
"Protocoles de communication" on page 435).
L'importation est un processus en deux étapes :
1. Importation de la définition de variable dans un dictionnaire
2. Importation des variables du dictionnaire vers le projet
AVERTISSEMENT : Les caractères spéciaux dans les noms de variables tels que "&" entraînent des
erreurs de communication. Voir "Limites de la prise en charge UNICODE" on page 206
Note : Au moment de l'importation, le caractère « . » dans les noms de variable est remplacé par « / ». Le
protocole utilisera la bonne syntaxe lorsqu'il communiquera avec l'API.
Dictionnaires
Chemin : Affichage du projet> Dictionnaires
Un dictionnaire est une liste de variables importées dans l'Éditeur de variable pour un protocole spécifique. En fonction du
type de protocole, les variables s'affichent en vue linéaire ou en vue hiérarchique.
30
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
Vue linéaire
Vue hiérarchique
Importer les variables
Pour importer des variables à partir d'un fichier externe :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
31
Importer les variables
1. Dans Affichage du projet, variables, sélectionnez le protocole à partir de la liste du filtre.
2. Cliquer sur le bouton Importation variables
: la boîte de dialogue du fichier sélectionné s’affiche. Une boîte de
dialogue pour choisir le type de pilote d'importation apparaît.
3. Sélectionner le fichier : une liste de variables est représenté dans une vue linéaire ou hiérarchique.
4. Pour importer des variables, sélectionnez une ou plusieurs variables ou bien un Nœud (en vue hiérarchique
seulement) et cliquez sur le
bouton Importer variables : les variables sont copiées vers le projet et
apparaissent sous forme de liste dans la partie supérieure de la fenêtre.
Paramètre
Description
Récursif
Tous les éléments de la structure sont importés dans des variables séparées.
Note : Lorsque le projet a été configuré pour utiliser un réseau de protocole, vous devez également sélectionner
le nœud de protocole vers lequel les variables doivent être importées. Vous pouvez importer les mêmes
variables sur de multiples protocoles. Lorsque le fichier de variable contient les informations de nœud, vous
pouvez choisir d'utiliser ces informations pour filtrer les variables et n'importer que celles qui correspondent aux
nœuds sélectionnés.
Mettre à jour les variables importées
En utilisant la commande Mettre à jour variable(s), vous pouvez réimporter des variables. Une boîte de dialogue vous
permet de sélectionner les variables à réimporter :
32
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
Ces variables doivent être mises à jour. Un liste de différences entre le projet et le dictionnaire s'affiche.
Ces variables ne sont plus disponibles dans le dictionnaire. Si elles sont mises à jour, ces variables seront
éliminés du projet.
Associer un widget à des variables
Pour contrôler un widget et l'animer avec des données actives, vous pouvez associer une propriété spécifique à des
sources de données différentes. Par exemple, vous pouvez associer la jauge de la propriété Valeur à une variable de
température testée, ou la propriété Affichage à des données de recette
Sources des données
Éléments auxquels vous pouvez associer une propriété d’objet :
Source des données
Description
Variable
Variable définie dans l'éditeur de variables
Alias
Adresse de variables indexées
Système
Variables à système prédéfini (consultez "Variables système" on page 85)
Widget
Connecte à la propriété d’un widget (la valeur d’un widget de barre de défilement, par exemple)
Recette
Données du gestionnaire de recette (consultez "Recettes" on page 169)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33
Associer un widget à des variables
Associer une propriété à une variable
1. Dans le volet Propriétés, cliquez sur +.
2. Dans Source, choisissez la source de données : dans la liste, choisissez un protocole et la variable. Utilisez la
barre Rechercher pour filtrer les variables.
3. Configurez le type d’accès (Lecture seule, par exemple). Le champ Index de tableau s’affiche lorsque la variable
sélectionnée est un tableau, afin d’identifier l’élément du tableau à utiliser. Le mode index indirect est pris en charge
grâce à une variable supplémentaire.
4. Cliquez sur OK pour confirmer.
Les icônes adjacentes au nom de variable sont en surbrillance lorsqu’une définition ne correspond pas à la définition de
variable dans le dictionnaire, ou lorsqu’une telle définition est manquante. Lorsque vous sélectionnez Afficher toutes les
variables, toutes les variables du dictionnaire s’affichent, même celles que vous n’avez pas importées dans l’application.
Vous pouvez double-cliquer pour importer les variables du dictionnaire.
Voir "Paramètres « Associer à »" on page 38 pour plus de détails.
Erreur de communication
Deux icônes peuvent apparaître près des widgets qui ont une variable associée.
34
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
3 Mon premier projet
: erreur de communication
l
l
: données actuellement non disponibles (protocole de communication lent)
Pages de dialogues
Chemin : VueProjet> Web > Dialogues
Les pages de dialogues s'ouvrent à l'exécution au-dessus de la page actuelle sur requête du projet. Elles sont utilisées pour
notifier les alarmes, les erreurs ou pour requérir une action de l'utilisateur.
Propriétés des dialogues principaux
Propriété
Description
Type de
dialogue
modal = l'utilisateur ne peut pas retourner sur la fenêtre principale du projet/sur la page tant que le
dialogue n'est pas fermé.
non-modal = l'utilisateur peut continuer d'utiliser la fenêtre principale du projet (ou d'autres dialogues
non-modaux) lorsqu'un dialogue est affiché au-dessus.
Barre de
titre
vrai = titre du dialogue affiché
Nom de titre
Titre du dialogue. Uniquement si Barre de titre= vrai.
Position du
runtime
Position fixe du dialogue
faux = titre du dialogue non affiché
faux = le dialogue s'affiche au centre de l'écran
vrai = le dialogue s'affiche dans l'angle en haut à gauche à la position X et Y
Nombre maximal de dialogues
Le nombre maximum de boîte de dialogue ouvert est défini dans "Précisions fonctionnelles et compatibilité" on page 429.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35
Pages de dialogues
Lorsque le nombre maximal de dialogues ouverts est atteint, le dialogue le moins récent est fermé pour en ouvrir un
nouveau.
36
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4
Concepts de programmation
La programmation de AGI Creatorse base sur plusieurs concepts et comportements de base.
Types de données
38
Paramètres « Associer à »
38
Événements
43
Positionnement des widgets
46
Gestion widgets chevauchants
47
Grouper des widgets
48
Changer les propriétés de plusieurs widgets
54
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
37
Types de données
Types de données
Lorsque vous créez une variable, vous devez spécifier ses propriétés. Les types de données sont spécifiques à AGI
Creator, les types de mémoires sont spécifiques au protocole sélectionné. Choisissez la valeur en fonction de la
représentation interne dont vous avez besoin pour l'adresse de contrôleur sélectionnée.
Note : les types tableaux utilisent les mêmes types de données suivis par « [ ] » (c-à-d : boolean [ ])
Type de
données
Description
boolean
Données d'un bit (0 à 1)
octet
Données signées de 8 bits (-128 à 127)
double
Type virgule flottante de 64 bits double précision conforme IEEE (±2.2e-308 à ±1.79e308)
float
Type virgule flottante de 32 bits simple précision conforme IEEE (±1.17e-38 à ±3.40e38)
int
Données signées de 32 bits (-2.1e9 à 2.1e9)
short
Données signées de 16 bits (-32768 à 32767)
string
Caractères codés selon le format sélectionné
temps
Données de l'heure
unsignedByte
Données non signées de 8 bits (0 à 255)
unsignedInt
Données non signées de 32 bits (0 à 4.2e9)
unsignedShort Données non signées de 16 bits (0 à 65535)
uint64
Données non signées de 64 bits (0 à 264 − 1)
Paramètres « Associer à »
Propriétés d'objet
Dans AGI Creator, les propriétés d'un objet placé sur une page peuvent être définies au moment de la programmation ou
configurées pour être dynamiques. Pour changer une propriété au moment de la programmation, utilisez la barre d'outils de
la page ou le volet Propriété. Sélectionnez d'abord l'objet pour afficher ses propriétés.
38
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
La barre d'outils de la page affiche uniquement les propriétés les plus communes de l'objet, alors que le volet Propriétés
affiche toutes les propriétés dans un mode d'affichage simple ou avancé.
Pour changer une valeur de propriété dynamiquement, vous pouvez l'associer à des variables ou à des variables.
Associer une propriété à une variable
1. Dans le volet Propriétés, cliquez sur +.
2. Dans Source, choisissez la source de données : dans la liste, choisissez un protocole et la variable. Utilisez la
barre Rechercher pour filtrer les variables.
3. Configurez le type d’accès (Lecture seule, par exemple). Le champ Index de tableau s’affiche lorsque la variable
sélectionnée est un tableau, afin d’identifier l’élément du tableau à utiliser. Le mode index indirect est pris en charge
grâce à une variable supplémentaire.
4. Cliquez sur OK pour confirmer.
Les icônes adjacentes au nom de variable sont en surbrillance lorsqu’une définition ne correspond pas à la définition de
variable dans le dictionnaire, ou lorsqu’une telle définition est manquante. Lorsque vous sélectionnez Afficher toutes les
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
39
Paramètres « Associer à »
variables, toutes les variables du dictionnaire s’affichent, même celles que vous n’avez pas importées dans l’application.
Vous pouvez double-cliquer pour importer les variables du dictionnaire.
Sources des données
Éléments auxquels vous pouvez associer une propriété d’objet :
Source des données
Description
Variable
Variable définie dans l'éditeur de variables
Alias
Adresse de variables indexées
Système
Variables à système prédéfini (consultez "Variables système" on page 85)
Widget
Connecte à la propriété d’un widget (la valeur d’un widget de barre de défilement, par exemple)
Recette
Données du gestionnaire de recette (consultez "Recettes" on page 169)
Recherche avancée
Diverses options de syntaxe peuvent s'appliquer à une zone de recherche :
Options
principales
Fonction
Métacaractères Recherche en associant des métacaractères simples. Caractère '?' : s'associe à n'importe quel
caractère. Caractère ' *': s'associe à aucun ou plus de tous les caractères." « [...] » : les ensembles de
caractères peuvent être représentés entre crochets.
Expression
régulière
Décrit le modèle de caractère. Voir http://www.regular-expressions.info/
Filtrage des variables
Choisissez différents critères de filtrage des variables :
40
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Affichage des variables de dictionnaire
Lorsque Afficher toutes les variables est coché, les variables qui appartiennent à un dictionnaire mais qui n'ont pas
encore été importées apparaissent en bleu. Vous pouvez sélectionner une variable et cliquer deux fois dessus pour
l'importer dans le projet.
Conversion de la valeur de variable
L'onglet Mise à l'échelle convertit la valeur de variable. Dans la section Par plage, définissez la plage d'entrée et la plage
de sortie : le système calcule automatiquement les facteurs de mise à l'échelle.
Extraction des variables bit/byte basées sur l'index
Permet d'extraire le contenu d'un mot d'un seul bit ou d'un seul byte selon le numéro de bit ou de byte spécifié
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
41
Paramètres « Associer à »
Mappage des valeurs de variable aux couleurs
Permet de mapper des valeurs de variable numérique aux couleurs. Vous pouvez utiliser cette option pour changer la
couleur d'un bouton.
Section
Fonction
Sur la barre d'outil, ajoutez/supprimez ou déplacez vers le
haut/vers le bas les lignes de couleurs. Vous pouvez modifier la
valeur de variable et les valeurs de séquence.
La dernière combinaison de couleurs définie est enregistrée
automatiquement et vous pouvez la récupérer dans la barre d'outils
des couleurs.
Notez que la valeur de variable de mappage de la couleur renverra un type de données de chaîne (par
ex. « "#FF0000 »)
Sérialisation de liaison de données
Au lieu de l'utilisation ci-dessus de la boîte de dialogue « attacher à ... », les liaisons de données peuvent être entrées, ou
modifiées, manuellement.
Cliquez sur un bouton dans le panneau Propriétés et entrez le texte qui décrit la liaison de données
42
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Le format de liaison de données est :
Tagname [index] | [Atribute] | [XForm] | [XForm] | ...
Exemple :
l
arrayTag[2]
l
Tag[0|index]
l
Alarm triggered:_SysPropMgr
l
Tag|R/W|ScaleXForm(1,10,0)
l
Tag|R/W|ScaleXForm(1,10,0)|ByteIndexXForm(1)|ColorPaletteCustomXForm(0#00aa7f,1#ff0000)
Événements
Les événements sont utilisés pour déclencher des actions au niveau du projet et ils peuvent être associés à :
l
l
des boutons/touches (cliquer, appuyer, relâcher)
des périphériques d'entrée externes tels que des claviers et une souris (cliquer, appuyer, maintenir, relâcher,
molette)
l
des modifications de données (OnDataUpdate)
l
des changements de pages (OnActivate, OnDeactivate)
l
des alarmes
l
planificateur
Vous pouvez associer une ou plusieurs actions à un événement, pour qu'elles soient exécutées lorsque l'événement se
produit.
Dans cet exemple, une action JavaScript est activée en appuyant sur un bouton.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
43
Événements
OnClick/OnMouseClick
Déclenche l'événement lorsque vous appuyez sur le bouton/la touche et relâchez rapidement.
OnHold/OnMouseHold
Déclenche l'événement lorsque vous appuyez et maintenez enfoncé le bouton/la touche pendant un certain moment, qui
est défini comme Temps de maintien dans les propriétés du widget. Les actions programmées pour cet événement sont
exécutées uniquement après expiration du temps de maintien.
Le Temps de maintien par défaut est configuré dans les propriétés du projet mais il peut être redéfini pour chaque
bouton/touche. Voir "Propriétés de projet" on page 59.
44
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Note : Si le Temps de maintien est défini sur -1 pour le widget, la valeur Temps de maintien du projet sera
utilisée.
Répétition auto
Active la répétition auto pour un événement d'appui ou de maintien d'un bouton ou d'une touche. Le Temps de répétition
auto est spécifié dans les propriétés du projet mais il peut également être redéfini pour chaque bouton/touche.
OnWheel
Déclenche l'événement lorsque la valeur d'une molette (par exemple une molette de souris USB) est modifiée. Une molette
est en général utilisée pour augmenter/diminuer les valeurs dans une zone de texte ou elle est associée à une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
45
Positionnement des widgets
OnActivate
Déclenche l'événement lorsqu'une page est chargée. L'événement démarre avant que les widgets de la page ne soient
initialisés.
OnDataUpdate
Déclenche l'événement lorsque la valeur de variable est modifiée. Le moment de mise à jour dépend du temps nécessaire
au protocole pour terminer le processus de mise à jour. Par exemple, l'événement OnDataUpdate peut être déclenché ou
non, selon si le protocole met à disposition les données respectivement après ou avant l'initialisation des widgets pour la
première fois. En particulier, il est plus probable que les notifications de modification d'une page s'affichent avec des
protocoles lents et des clients à distance.
Note : La valeur lue pendant OnActivate peut être similaire à celle obtenue par un événement OnDataUpdate
postérieur, puisque les notifications OnDataUpdate sont envoyées de manière asynchrone.
Positionnement des widgets
Vous pouvez placer des widgets sur la page en utilisant deux méthodes :
l
Aligner à la grille
l
Aligner à l'objet
Pour afficher la grille, sur le menu Vue, cliquez Afficher grille.
Aligner à la grille
Chemin : Vue> Aligner à la grille
Lorsque vous déplacez ou redimensionnez un objet, son coin supérieur gauche s'alignera à l'intersection la plus proche des
lignes dans la grille, même si la grille n’est pas visible.
Paramètres des propriétés de la grille
Chemin : Vue> Propriétés
Paramètre
Description
Espacement X
Espace dans des pixels entre deux lignes/points sur l'axe X
Espacement Y
Espace dans des pixels entre deux lignes/points sur l'axe Y
Type
Type de grille (point ou ligne)
Couleur
Couleur de la grille
Aligner à l'objet
Chemin : Vue> Aligner à l’objet
Lorsque vous déplacez un objet, il s’alignera avec d'autres objets sur la page.
46
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Lorsque vous sélectionnez un objet, un des points sensibles suivants est sélectionné comme source du point
d'alignement, en fonction de la zone où vous avez appuyé: en haut, en haut à gauche, en haut à droite, en bas, en bas à
gauche, en bas à droite, à gauche, à droite, au centre :
Un algorithme trouve un point sensible correspondant parmi les widgets à proximité de points chauds correspondant aussi
bien aux coordonnées x que y du point d'alignement source. Pour les widgets en ligne, les points d'alignement source sont
les points terminaux de la ligne.
Gestion widgets chevauchants
Lorsqu’un ou plusieurs widgets se chevauchent sur la page, vous pouvez décider de les organiser de sorte qu’un soit
affiché au-dessus des autres.
L’ordre du widget sur la page est affiché dans la liste déroulante. Un widget avec un nombre d’ordre-z supérieur est face à
un élément avec un nombre d’ordre-z inférieur. Une icône par image identifie les objets statiques, une icône par film
identifie des objets dynamiques.
Important : Un ordre correct de widgets est essentiel pour la performance de l’exécution puisque le
chevauchement des widgets dynamiques peut rendre invalide l’optimisation statique et réduire les
performances des applications IHM.
Cacher/afficher un widget sur ordre z
Pour cacher des widgets au-dessus d’un widget sélectionné :
l
Sur la barre d’outils, cliquez sur
cachés
et sélectionnez un widget : tous les widgets au-dessus de celui-ci seront
Pour cacher des widgets en dessous d’un widget sélectionné :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
47
Grouper des widgets
l
Sur la barre d’outils, cliquez sur
cachés
et sélectionnez un widget : tous les widgets en dessous de celui-ci seront
La barre d’outils permet de :
l
cacher les widgets empilés au-dessus et/ou en dessous des widgets sélectionnés
l
travailler sur différents widgets en utilisant la liste déroulantes qui liste tous les widgets dans leur ordre-z.
Grouper des widgets
Pour grouper des widgets :
1. Sélectionnez tous les widgets à grouper.
2. Cliquez avec le bouton droit, puis cliquez sur Groupe.
Astuce : Double-cliquez pour accéder au mode édition du groupe. Les widgets de groupe ne peuvent être édités
et sélectionnés qu'en mode groupe. Tous les autres widgets sont partiellement masqués
Redimensionner des widgets groupés
Vous pouvez définir les réactions au redimensionnement d'un objet Utilisez la propriété Mise à l'échelle dans la section
Générale :
l
Échelle : l'objet et le texte ne sont pas redimensionnés proportionnellement
l
Étirement : l'objet et le texte sont redimensionnés proportionnellement
48
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Groupe disposition grille
La disposition de la grille ajoute la possibilité de configurer les relations spatiales entre les widgets du groupe.
Pour créer une disposition de la grille :
l
Activer le paramètre « Disposition de grille » du groupe de widgets.
ou
l
Sélectionner les widgets qui seront à l'intérieur du tableau et cliquer sur le bouton « Disposition de la grille » sur la
barre d'outils de la page. Les widgets sélectionnés seront alignés et recueillis dans un groupe avec la propriété de
disposition de grille activée.
Il existe plusieurs éléments associés à la disposition de la grille qui peuvent être configurés :
l
Propriétés de grille
l
Propriétés de ligne, colonne
l
Propriétés de cellules
Propriétés de grille
Les principales propriétés de disposition de grille sont disponibles à l'intérieur du mode avancé de fonctionnement du
panneau de propriétés lorsque le groupe de widget est sélectionné.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49
Grouper des widgets
Paramètre
Description
Activer
Activer la disposition de grille.
Une grille sera générée autour des widgets du groupe
Lignes num
Colonnes num
Nombre de lignes et de colonnes des grilles
Débordement horizontal
Débordement vertical
Ce paramètre permet de définir le comportement de la grille quand
il est trop petit pour contenir toutes les lignes et les colonnes.
Les lignes et les colonnes peuvent être enlevées
uniquement si leurs cellules sont vides.
l
l
l
50
Caché
Les lignes et les colonnes qui ne rentrent pas dans la grille
ne sont pas affichées
Visible
La grille ne peut pas être rendue plus petite que la taille
minimale requise pour contenir toutes les lignes et les
colonnes définies
Défilement
Lorsque la grille est trop petite pour contenir toutes les
lignes et les colonnes définies, les barres de défilement
peuvent être utilisées pour déplacer le contenu de la grille.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Paramètre
Description
Sous-débordement horizontal
Sous-débordement vertical
Ce paramètre définit le comportement de la grille quand il est trop
grand que la taille définie pour les lignes et les colonnes.
l
l
Bloqué
La grille ne peut pas être rendue plus grande que la taille
maximale des lignes et des colonnes
Gauche, Centre, Droite - Haut, Milieu, Bas
Permet de définir la position des widgets lorsque les
cellules sont plus grandes que les tailles maximum définies
Couleur de barre de défilement
Image de barre de défilement
Décalage de barre de défilement
Taille de barre de défilement
Cache auto de barre de défilement
Paramètre pour définir l'apparence et la position des barres de
défilement
Marge réduite
Réduire toute la marge de gauche à droite et de haut en bas en
utilisant les paramètres de la course avec une plus grande largeur.
Largeur de la marge externe
Couleur de la marge externe
Paramètres de la marge externe
Pour fusionner ou séparer des lignes ou des colonnes, double-cliquez sur la grille, pour entrer en mode d'édition, et déplacer
le curseur sur les rubans :
l
Double-cliquer sur le triangle noir pour fusionner les deux lignes ou colonnes adjacentes (1)
l
Double-cliquer sur le ruban pour diviser la ligne ou colonne sélectionnée (2)
Propriétés de ligne, colonne
Les propriétés de ligne et de colonnes sont disponibles dans une boîte de dialogue pop-up après avoir cliquer sur les
sélecteurs de lignes et de colonnes qui sont visibles en double-cliquant sur le groupe de widgets.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
51
Grouper des widgets
Paramètres géométriques
Paramètre
Description
Marge de gauche
Marge de droite
Distance du widget de le bord de la cellule
Largeur min
Largeur max
Largeur min/max que le widget peut prendre lorsque la cellule est
étirée
Étirement
Définit la relation entre les largeurs des colonnes qui seront
maintenues si la grille est étirée
Marge supérieure
Distance du widget de le bord de la cellule
52
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Paramètre
Description
Marge inférieure
Hauteur min
Hauteur max
Hauteur min/max que le widget peut prendre lorsque la cellule est
étirée
Étirement
Définit la relation entre les hauteurs des lignes qui seront
maintenues si la grille est étirée
Paramètres de style
Paramètre
Description
Largeur de course gauche
Largeur de course droite
Largeur de course haute
Largeur de course basse
Largeur des courses
Couleur de course gauche
Couleur de course gauche
Couleur de course haute
Couleur de course Basse
Couleurs des courses
Couleur de fond
Couleur d'arrière-plan de page.
La liste des valeurs qui sont séparées par une virgule, sont liées avec les lignes et les colonnes. Exemple, la
première valeur de la ligne 0, deuxième valeur de la ligne 1, et ainsi de suite.
Le format de couleur pourrait être #rrggbb ou #rrggbbaa, où « aa » est la valeur alpha qui définit l'opacité de la
couleur.
Paramètres de sélection
Les paramètres de sélection sont disponibles uniquement lorsque la grille est utilisée à l'intérieur d'un widget de tableau
(voir "Widget tableau" on page 298 pour plus de détails)
Paramètre
Description
Couleur de premier plan
Couleur de fond
Couleurs de course
Couleurs que la ligne prend lorsqu’elle est sélectionnée
La liste des couleurs est associée à des modèles de ligne. La
première couleur est pour le modèle de la ligne 0, la deuxième
couleur est pour le modèle de la ligne 1, et ainsi de suite.
Propriétés de cellules
Les propriétés d'une cellule unique sont disponibles à l'intérieur du panneau de propriétés lorsqu'une cellule est
sélectionnée. Pour sélectionner une cellule : tout d'abord, double-cliquer sur le groupe de widget, puis cliquer sur la cellule
pour la sélectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
53
Changer les propriétés de plusieurs widgets
Paramètre
Description
Sous-débordement horizontal
Sous-débordement vertical
Ce paramètre définit le comportement du widget quand il est trop
grand que la taille définie pour le widget.
l
l
Héritage
Il hérite de la valeur utilisée pour la ligne ou la colonne
Gauche, Centre, Droite - Haut, Milieu, Bas
Permet de définir la position des widgets lorsque les
cellules sont plus grandes que les tailles maximum définies
Largeur max
Hauteur max
Écraser les paramètres globaux de la grille
Marge de gauche
Marge de droite
Marge supérieure
Marge inférieure
Écraser les paramètres globaux de la grille
Conserver le rapport d'aspect
Conserver le rapport d'aspect du widget
Rapport d'aspect
Disponible uniquement lorsque « Conserver le rapport d’aspect »
est vrai
Pixels supplémentaires qui sont ajoutés à la marge totale.
Changer les propriétés de plusieurs widgets
Vous pouvez définir les propriétés de plusieurs widgets du même type, tous en une seule fois.
54
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4 Concepts de programmation
Pour modifier les propriétés :
1. Sélectionnez les widgets.
2. Définissez les propriétés communes dans le volet Propriétés.
3. Lorsque plusieurs widgets sont sélectionnés, le titre du volet Propriétés devient <MultipleObjects> : tous les
changements seront appliqués à tous les widgets sélectionnés.
Note : Toutes les propriétés ne peuvent pas être modifiées pour plusieurs widgets simultanément, elles doivent
donc être modifiées individuellement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
55
Changer les propriétés de plusieurs widgets
56
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Changer la propriété couleur de remplissage en
fonction des valeurs de variable
AGI Creator permet de modifier la propriété de couleur d'un widget de façon dynamique en fonction des valeurs de variable,
ce de deux façons :
l
En utilisant ColorPalette
l
En associant la propriété de couleur à une variable de type Chaîne
Changer la propriété de couleur en utilisant ColorPalette
1. Créez la variable (interne ou API) de référence pour la gestion des couleurs. La variable peut être de tout type de
données. La couleur changera en fonction de la valeur de cette variable.
2. Associez cette variable à la propriété Couleur de remplissage d'un objet (par exemple, un bouton).
3. Dans la même boîte de dialogue, sélectionnez l'onglet Colorpalette et ajoutez les couleurs à utiliser pour l'objet
selon la valeur de la variable.
Note : Les derniers tableaux de couleurs utilisés sont sauvegardés et peuvent être réutilisés en les sélectionnant
à partir de la liste des couleurs dans la barre d'outils.
Changer la propriété de couleur en l'associant à une variable de type Chaîne
1. Créez la variable (interne ou API) de référence pour la gestion des couleurs. La couleur changera en fonction de la
valeur de cette variable. La variable doit être de type Chaîne et la propriété Taille de tableau de la variable doit être
suffisamment grande pour contenir la chaîne formatée comme illustré ici.
2. Associez cette variable à la propriété Couleur de remplissage d'un objet (par exemple, un bouton).
3. Écrivez dans la variable de Chaîne le code couleur RVB de la couleur souhaitée. Utilisez un des ces formats :
l
l
#XXYYZZ, où XX, YY et ZZ sont des composants RVB de la couleur souhaitée exprimée sous forme Hexadécimale
(plage 00–FF).
rgb(XXX,YYY,ZZZ), où XXX, YYY et ZZZ sont les composants RVB des couleurs souhaitées exprimées sous
forme Décimale (plage 0–255).
Note : Cette fonctionnalité peut s'appliquer à tous les objets disponibles dans la Galerie des widgets ayant une
propriété de couleur. Le changement de couleur en cours d'exécution n'est possible que grâce aux propriétés des
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
57
Changer la propriété couleur de remplissage en fonction des valeurs de variable
SVG dont se compose l'objet. Cette fonctionnalité ne s'applique pas à d'autres formats d'image tels que les
fichiers JPEG ou BMP.
58
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6
Propriétés de projet
Les propriétés de projet contiennent les paramètres pour le projet.
Volet des propriétés de projet
60
Outils de développement
62
Rendu des polices FreeType
65
Modules de plug-in de logiciels
66
Comportement
66
Événements
71
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
59
Volet des propriétés de projet
Volet des propriétés de projet
Chemin : Affichage du projet> double-cliquez sur Propriétés de projet> volet Propriétés
Le volet Propriétés de projet contient une liste de données configurables par l'utilisateur au niveau du projet.
Propriétés de base et avancées
Pour consulter toutes les propriétés de projet :
l
Cliquez sur le bouton Afficher les propriétés avancées pour agrandir la zone de visualisation du volet Propriétés.
Description des propriétés principales
Note : Certaines propriétés ne s'affichent qu'en mode avancé.
60
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
Propriété
Description
Version
Le champ Version permet aux utilisateurs d'indiquer la version du projet.
Menu contextuel
Définissez les modalités d'affichage du menu contextuel dans le projet IHM.
Temporisation = le menu contextuel apparaît en touchant/appuyant et maintenant pendant
quelques secondes un espace vide de l'écran de runtime, ou via une action du Menu
contextuel
Sur macro-commande = le menu contextuel n'apparaît que via une action du Menu
contextuel.
Voir "Actions widget" on page 138 pour plus de détails.
Outil de développement
Active/désactive une série d'outils de débogage de runtime.
Signal sonore au
contact
Activer le bipeur lorsqu’un widget est touché sur l'écran du périphérique IHM.
Widgets pris en charge :
l
boutons
l
zones réactives
l
aiguilles
l
champs
l
touches externes
l
listes déroulantes
l
éléments de tableaux
l
éléments de la liste de contrôle
Sur les panneaux de Windows CE, disponibles pour à partir de v1.76 ARM / 2.79
MIPS.
Durée du signal sonore
200 ms par défaut
Clavier
Permet d'utiliser les macros de clavier pendant l'exécution à condition d'utiliser des claviers
externes.
Débogage JavaScript
Active le débogueur JavaScript pendant l'exécution pour le projet actuel.
Autoriser débogueur à
distance JS
Active le débogueur distant JavaScript pour le projet actuel.
Masquer le chargement
du projet au démarrage
Lorsque le projet est masqué, l'image de démarrage reste à l'écran jusqu'à ce que
l'application soit prête pour le fonctionnement.
Débogage distant non supporté sur AGI Client.
Disponible pour Windows CE à partir de v1.99 ARM
Activation image base
Active un moteur utilisé par le runtime pour optimiser la performance du projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
61
Outils de développement
Propriété
Description
de données
AVERTISSEMENT : Cette propriété ne doit être désactivée par
l'assistance technique que dans un but de débogage, car cette opération
pourrait diminuer la performance pendant l'exécution.
Rendu des polices
FreeType
Passe à FreeType, le rendu de police utilisé par AGI Creatoret le runtime.
Modules de plug-in de
logiciels
Définit quels composants logiciels sont téléchargés vers le runtime avec le projet. Voir
"Modules de plug-in de logiciels" on page 66
Comportement
Ces propriétés définissent les différents aspects du comportement de la page. Voir
"Comportement" on page 66
Style
Mode de vue de la liste déroulante (voir "Widget liste déroulante" on page 276 pour plus de
détails)
l
Contexte
l
Plein écran
Outils de développement
Collection de fonctions de débogage au runtime qui peuvent être activées ou désactivées.
Activer les outils de développement
1. Dans le volet Propriétés, définissez Outils de développement sur Vrai.
2. Téléchargez le projet.
3. Ouvrez le menu contextuel.
4. Sélectionnez Outils de développement.
Liste des outils de développement
Outil
Description
Afficher/Masquer Affiche une boîte de dialogue contenant des informations sur l'état du périphérique, telles que la
tout
charge de l'UC, l'utilisation de la mémoire et les queues d'événements.
Statistiques CPU
Affiche des informations sur la charge de l'UC. Voir "Statistiques CPU" on page 64.
Statistiques
mémoire
Affiche les informations sur la RAM système. Une valeur négative indique que la mémoire libre
diminue.
Queues
d'événements
Affiche les informations sur les queues d'événements (taille, taille maximale atteinte, nombre
d'événements traités, dernier temps de traitement et temps de traitement maximal). Les statistiques
sur le minutage sont disponibles uniquement pour les queues non IU.
Résumé journal
en temps réel
Affiche le temps de chargement de la page.
Intégrer la
Permet d'intégrer la scène en cours de runtime ou de laisser la fenêtre d'outil de développement
62
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
Outil
Description
fenêtre
comme une fenêtre autonome (dialogue).
Réinitialiser les
statistiques de
queue
Réinitialise les informations statistiques sur les queues d'événements.
Désactiver le
chien de garde
Désactive la fonction de chien de garde et évite que le système ne redémarre en cas de gel ou
d'incident des services.
Ignorer les
exceptions
Désactive la fonction de rapport d'incident, les exceptions ne sont pas sauvegardées dans la
fenêtre de rapport d'incident.
Lancer VNC
Lance le serveur VNC s'il est disponible en cours de runtime. Le serveur VNC est disponible
uniquement comme plug-in pour le runtime de Windows CE.
Profilage
Mesure le temps passé pour charger/afficher la page active. Voir "Profilage" on the next page
Chien de garde
Cette fonction vous permet de désactiver le chien de garde. Ainsi, vous pouvez éviter que le système ne redémarre en cas
d'incident en cours de runtime. Vous aurez donc le temps de sauvegarder le rapport d'incident ou de vérifier les
informations sur l'état du système (par exemple, la mémoire disponible, la charge de l'UC, la taille des queues
d'événements, etc.).
La boîte de dialogue de rapport d'incident s'affiche automatiquement lorsque le système gèle ou bloque, permettant aux
utilisateurs de sauvegarder un fichier journal d'incident.
Important : Sauvegardez ce fichier pour le support technique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
63
Outils de développement
Statistiques CPU
L'heure actuelle de la machine s'affiche sur la ligne supérieure, ainsi que le temps de service total du périphérique.
Les statistiques CPU sont collectées toutes les 2000 millisecondes. La période réelle et le traitement requis pour collecter
et visualiser les statistiques sont également affichés. Au plus la période réelle s'éloigne de 2000 millisecondes, au plus la
charge du système est importante. La consommation de l'UC de threads est listée en rapportant le nom du thread (s'il est
disponible, le thread principal est marqué avec un *), l'ID du thread, la priorité du thread et le temps de l'UC passé durant la
période de 2000 millisecondes, divisé en temps d'utilisateur et temps du noyau.
Profilage
Le profilage permet de vérifier le temps passé pour charger/afficher la page active. Le profilage démarre à partir du
chargement de la page suivante et est actif pour le premier traçage de la page sur l'écran (la configuration est conservée).
Option de profilage
Description
Activer journal en temps réel
Activer la capture du journal en temps réel. Le minutage est affiché dans la
fenêtre « Résumé du journal en temps réel ».
Sauvegarder journal en temps réel
sous forme de fichier
Sauvegarde un rapport de détails du profil et le temps passé à charger un projet
et ses pages dans un fichier timelog.txt. Ce fichier peut être exporté et partagé
64
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
Option de profilage
Description
pour une analyse approfondie.
Important : L'exécution de cette fonction peut réduire la
performance de modification de la page.
Temps de chargement
superposition
Temps de rendu superposition
Cet affichage permet d'afficher le temps passé sur les widgets individuellement
et il est disponible uniquement pour les étapes de rendu et de chargement. Cet
affichage donne un aperçu immédiat des actions qui prennent du temps. Les
zones en rouge représentent les zones critiques qui prennent le plus de temps.
Les temps de widget détaillés sont visualisés par une fenêtre en infobulle (sur la
plateforme Win32 jointe à la souris sur l’événement, sur Windows CE, appuyer,
glisser puis relâcher sur la région d’intérêt). Lorsque des widgets sont en dehors
de la scène, certaines flèches permettent de naviguer vers ces zones et, en les
survolant, l'infobulle affiche le résumé de la zone
Choisir la couleur de
superposition
Choisissez la couleur de superposition à utiliser
Données du journal en temps réel
Données
Description
Temps d'analyse
Temps passé à analyser la page actuelle. Dépend de la complexité de la page et
du nombre de widgets.
Temps de création gfx
Temps passé pour afficher une image. Principalement associé à la méthode En
chargement.
Temps d'affichage
Temps passé pour afficher la page.
Temps de déchargement
Temps passé à décharger la page, lorsque la page actuelle dépend d'une autre
page.
Les temps sont fournis par deux : durée totale d'exécution/temps de l'UC. La durée totale d'exécution est le temps absolu
requis par cette partie, qui peut être plus importante que le temps réel de l'UC requis car les threads de priorité plus haute
sont aussi en cours d'exécution (pour les protocoles d'instance). La colonne d'heure de début se réfère à l'heure de début
de chargement de la page. Elle peut être utilisée pour suivre le temps réel requis pour charger une page, car les temps
partiels se réfèrent uniquement aux fonctions au temps le plus critique et n'incluent pas d'autres temps qui contribuent
souvent au temps total de manière significative.
Par exemple, la durée totale d'exécution réelle requise pour charger une page est l'heure de début de l'affichage (qui est la
dernière étape) + la durée totale d'exécution de l'affichage.
Rendu des polices FreeType
De nouveaux projets utilisent le moteur de polices FreeType par défaut. Les projets créés avec les anciennes versions de
AGI Creator pourrait utiliser un moteur de police plus ancien également après la conversion du projet pour éviter tout
problème de compatibilité ascendante.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
65
Modules de plug-in de logiciels
Basculez vers FreeType chaque fois que vous en avez la possibilité afin d'avoir un meilleur rendu de page.
Une fois que vous avez basculé vers le nouveau rendu de police, sauvegardez le projet et vérifiez que tous les textes
s'affichent correctement dans toutes les pages de projet.
Problèmes de rendu de police
Si vous basculez un projet créé avec l'ancien moteur de police vers le moteur de police FreeType, il est possible que vous
rencontriez les problèmes suivants :
l
le texte demande plus/moins de pixels pour le rendu, entraînant une modification de la mise en page du texte
l
les widgets sont redimensionnés pour contenir du texte
l
un meilleur rendu peut être obtenu en utilisant l'Anticrénelage (l’Anticrénelage est une propriété de widget texte)
Modules de plug-in de logiciels
Vous pouvez choisir quels composants logiciels sont téléchargés vers le runtime avec le projet. Le plug-in logiciel a été
conçu pour réduire les besoins en mémoire pour le périphérique IHM dans les périphériques IHM où le stockage est limité.
Cette fonctionnalité n'est pas supportée par la plateforme Win32
Plug-in de logiciels :
l
WebKit (module requis par le widgets du navigateur - si disponible)
l
Lecteur PDF
l
Serveur VNC
Note : Tous les modules de plug-in des logiciels ne sont pas compatibles avec les plate-forme de périphérique
IHM.
Une fois activé, le plug-in de logiciel devient une partie du runtime. Utilisez AGI Creator pour installer en utilisant l'une des
procédures suivantes :
l
installer le runtime/mettre à jour le runtime
l
paquet de mise à jour
Pour supprimer les plug-ins du runtime, utilisez l'une des fonctions suivantes en Mode système :
l
format Flash
l
restaure les paramètres d'usine.
Important : Le système ne peut pas détecter automatiquement quels plug-ins de logiciel sont requis
par le périphérique IHM, assurez-vous de tous les sélectionner dans les propriétés du projet.
Note : Le support plug-in du logiciel a été conçu pour les périphériques IHM intégrés où le stockage est limité.
Cette fonctionnalité n'est pas supportée par la plateforme Win32.
Comportement
Ces propriétés définissent différents éléments du comportement d'une page.
66
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
Page d'accueil
La première page chargée à l'exécution (après la page de connexion si la sécurité est activée dans le projet).
Lorsque la sécurité est activée, vous pouvez spécifier une page d'accueil différente pour chaque groupe d'utilisateurs. Le
cas échéant, ce paramètre est ignoré. Voir "Gestion et mots de passe utilisateur" on page 217 pour plus de détails.
Largeur de la page/Hauteur de la page
Définit la taille par défaut en pixels d'une page IHM. Lors de la création du projet, la résolution d'affichage du modèle de
périphérique IHM sélectionné est par défaut.
Mode d'affichage
Définit l'orientation du périphérique IHM.
Type de projet
Définit le type de périphérique IHM pour le projet. Selon le modèle, certaines fonctionnalités et propriétés du projet sont
ajustées automatiquement.
AVERTISSEMENT : À partir de la version v2, le HMI Runtime vérifie que le projet sélectionné
correspond au modèle de périphérique IHM ; lorsque le type sélectionné ne correspond pas, le
message suivant apparaît : « Discordance du type d'IHM. Convertissez le projet et téléchargez-le de
nouveau »
Mémoire panneau
Taille de la mémoire interne du panneau disponible.
RequêtePage, PageActuelle et OptionsSync
Avec HMI Runtime, vous pouvez échanger les informations des périphériques sur la page affichée par l'IHM. Vous pouvez
synchroniser les pages affichées sur le périphérique IHM et sur AGI Client, ou bien vous pouvez contrôler un projet IHM
depuis un contrôleur tel qu'un API.
Les propriétés suivantes peuvent être personnalisées :
Propriété
Description
RequêtePage Page qui doit s'afficher sur le périphérique IHM et sur AGI Client.
Une variable associée doit contenir une valeur entière dans la plage des pages disponibles du projet et
elle doit être disponible au moins en tant que Ressource lisible.
PageActuelle Numéro de page affiché sur le périphérique IHM, sur AGI Client ou sur les deux.
Une variable associée doit être disponible au moins en tant que Ressource écrivable et doit avoir un
type entier de données.
OptionsSync
Synchronisation des pages du projet avec la valeur contenue dans la propriété PageActuelle.
Les options sont :
l
désactiver : la valeur du numéro de la page est ignorée,
l
local : le numéro de page est affiché sur l'IHM,
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
67
Comportement
Propriété
Description
l
l
à distance : le numéro de page est affiché sur AGI Client.
local + à distance : le numéro de page est affiché sur l'IHM et sur AGI Client ; si différentes
pages sont affichées, le numéro de page affiché est celui de la dernière page chargée.
Exemple : modification forcée de la page depuis le contrôleur/API au périphérique IHM et au AGI
Client
Définissez les propriétés de la façon suivante :
RequêtePage
associée à la variable « A »
PageActuelle
vide
OptionsSync
désactiver
Définissez la valeur de la variable « A » pour afficher la page demandée sur le périphérique IHM et sur le AGI Client.
Exemple : modification forcée de la page depuis le contrôleur/API à l'IHM et au AGI Client. Lisez la
page actuellement chargée sur l'IHM
Définissez les propriétés de la façon suivante :
RequêtePage
associée à la variable « A »
PageActuelle
associée à la variable « B » en tant que lire/écrire
OptionsSync
locale
Définissez la valeur de la variable « A » pour afficher la page demandée sur le périphérique IHM et sur le AGI Client. La
variable « B » contient le numéro de la page actuellement affichée par le périphérique.
Exemple : modification forcée de la page depuis le contrôleur/API au périphérique IHM et au AGI
Client. Lisez la page actuellement chargée sur AGI Client.
Définissez les propriétés de la façon suivante :
RequêtePage
associée à la variable « A »
PageActuelle
associée à la variable « B » en tant que lire/écrire
OptionsSync
à distance
Définissez la valeur de la variable « A » pour afficher la page demandée sur l'IHM et sur le AGI Client. La variable « B »
contient le numéro de la page actuellement affichée par AGI Client.
Exemple : modification forcée de la page depuis le contrôleur/API au périphérique IHM et au AGI
Client. Synchronisation forcée de la page AGI Client avec le périphérique IHM (et non l'inverse).
Définissez les propriétés de la façon suivante :
68
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
RequêtePage
associée à la variable « A » en tant que lire/écrire
PageActuelle
associée à la même variable « A » que pour RequêtePage
OptionsSync
locale
Définissez la valeur de la variable « A » pour afficher la page demandée sur l'IHM et sur le AGI Client. Changez de page sur
l'IHM pour afficher la même page sur AGI Client.
Exemple : modification forcée de la page depuis le contrôleur/API au périphérique IHM et au AGI
Client. Synchronisation forcée de l'IHM avec AGI Client (et non l'inverse).
Définissez les propriétés de la façon suivante :
RequêtePage
associée à la variable « A » en tant que lire/écrire
PageActuelle
associée à la même variable « A » que pour RequêtePage
OptionsSync
à distance
Changez la valeur de la variable « A » pour afficher la page demandée sur l'IHM et sur le AGI Client. Changez de page sur
AGI Client pour afficher la même page sur l'IHM.
Exemple : synchronisez la page affichée entre le périphérique IHM et le AGI Client
Définissez les propriétés de la façon suivante :
RequêtePage
associée à la variable « A » en tant que lire/écrire
PageActuelle
associée à la même variable « A » que pour RequêtePage
OptionsSync
local + à distance
En changeant de page sur le périphérique IHM, la même page sera affichée sur AGI Client et vice-versa.
RequêtePageWeb
Vous pouvez synchroniser les pages affichées sur le AGI Web Clients depuis un contrôleur tel qu'un API.
Les propriétés suivantes peuvent être personnalisées :
Propriété
Description
RequêtePageWeb Page à afficher sur le AGI Web Client.
Une variable associée doit contenir une valeur entière dans la plage des pages disponibles du projet
et elle doit être disponible au moins en tant que Ressource lisible.
Temps de maintien/Temps de répétition auto
Définit les valeurs de temps de maintien et de temps de répétition auto pour les boutons et les claviers externes.
Note : Ces propriétés peuvent être redéfinies pour chaque bouton ou touche dans le tableau des propriétés de
leur widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
69
Comportement
Délai d'attente inactivité web
Définit un délai d'attente pour AGI Web client. Lorsque le délai d'attente expire sans activité, l'utilisateur actuel est
déconnecté.
Range
1–86 400 s (forme 1 s à 24 h)
Valeur par défaut
600 s
Valeurs
0 = désactivé
Icône web
L’icône préférée associée aux pages web
Temps de rafraîchissement
Définit le temps de rafraîchissement pour la communication entre le runtime et AGI Web clients.
Range
500–10 000 ms
Valeur par défaut
3000 ms
Optimisation du navigateur
vrai
Activation de l’optimisation du moteur Web (par défaut)
faux Désactivation de l’optimisation du moteur Web (utile pour les anciens navigateurs qui ne soutiennent
l'optimisation du moteur web)
Bande passante Max (Kbs)
Limite pour un maximum de données envoyées par le serveur (utile pour les vieux navigateurs lents). Configurer sur 0 pour
utiliser toute la bande passante disponible (par défaut)
Mode de connexion des clients Web
Auto
Le mode de connexion est sélectionné par le client (par défaut)
SSE
Forcer le mode d'événements envoyés par serveur
Longue scrutation
Forcer le mode de scrutation longue
Facteur de zoom cible
Le facteur de zoom du périphérique IHM est appliqué lorsque le projet est chargé à l'exécution.
Range
0.3–2.9
Valeur par défaut
1 = pas de zoom
70
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
6 Propriétés de projet
Options couleur de fond
Lorsque la page définie est plus petite que l'ensemble de la zone d'affichage, colorez la zone de la page qui n'est pas
couverte (par exemple lorsque la page est dézoomée)
Propriété
Description
Aucun
Ancien mode, la couleur est blanche (par défaut)
Couleur sélectionnée
Couleur à utiliser
Couleur de fond de page
Ajuste automatiquement la couleur selon la couleur d'arrière-plan du
modèle ou de la page
Événements
OnWheel
Utilisé uniquement avec des périphériques d'entrée de la molette. Généralement, la molette est utilisée pour
augmenter/diminuer la valeur d'une variable sans clavier externe.
Combinez cette propriété à un événement de modification de la molette et utilisez une action telle que variablePas pour
augmenter/diminuer la valeur de la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
71
Événements
72
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
7
Le simulateur IHM
Le simulateur IHM vous permet de tester des projets avant de le télécharger sur le périphérique IHM. Il peut être utilisé pour
tester le projet lorsque aucun périphérique IHM est disponible et pour accélérer les activités de développement et de
débogage.
Le simulateur IHM supporte :
l
l
simulation en ligne - en communication avec des appareils réels (uniquement pour les protocoles avec Ethernet ou
de communication RS-232),
simulation hors ligne - simulant le comportement de variable
La méthode de simulation de données est définie dans la colonne Simulateur de l'éditeur de variable.
Méthodes de simulation des données
74
Paramètres du simulateur
74
Lancer et arrêter le simulateur
75
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
73
Méthodes de simulation des données
Méthodes de simulation des données
Définissez le comportement de simulation de variable dans le champ Simulateur de l'Éditeur de variables.
Méthode
Description
Variables
Les données sont stockées dans une variable de simulation. Cette variable maintient la valeur de la
variable pour que vous puissiez lire et écrire la valeur.
Signal en
dents de
scie
Une valeur du nombre est incrémentée de Offset à Amplitude + valeur Offset avec une Période de 60 à
3600 secondes. Lorsque le décompte atteint Amplitude + Offset, la valeur est réinitialisée à Offset et le
décompte recommence.
Signal
sinusoïdal
Une valeur de signal sinusoïdal est générée et écrite sur la valeur de la variable. Des valeurs Min., Max.
et Période peuvent être définies pour chaque variable.
Signal
Une valeur de signal triangulaire est générée et écrite sur la valeur de la variable. Des valeurs Min., Max.
triangulaire et Période peuvent être définies pour chaque variable.
Signal
carré
Une valeur de signal carré est générée et écrite sur la valeur de la variable. Des valeurs Min., Max. et
Période peuvent être définies pour chaque variable.
Voir "Ajouter des variables" on page 27 pour plus de détails.
Paramètres du simulateur
Le Simulateur travail par défaut avec les protocoles simulés. Il peut également travailler avec de vrais protocols (Ethernet
ou des protocoles en série)
Note : Pour les protocoles ne supportant pas la communication avec des périphériques externes, tels que le
protocole Variables, cette option est toujours désactivée.
Modification des protocoles simulés
1. Cliquez sur l'icône Paramètres du simulateur.
74
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
7 Le simulateur IHM
2. Sélectionnez Utiliser Simulation pour utiliser des protocoles simulés, sinon de véritables protocoles seront utilisés
pour la communication avec des périphériques externes.
Lancer et arrêter le simulateur
Pour lancer le simulateur :
1. Dans le menu Exécuter, cliquez sur Démarrer le simulateur : le simulateur fonctionne sur l'ordinateur de la même
façon que le serveur sur le périphérique IHM.
Pour arrêter le simulateur :
1. Dans le menu Exécuter, cliquez sur Arrêter le simulateur ou bien double-cliquez sur le bouton Quitter sur la page
simulée.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
75
Lancer et arrêter le simulateur
76
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
8 Transférer le projet au périphérique
IHM
Pour transférer le AGI Creator projet sur le périphérique IHM, vous pouvez utiliser :
l
fonction Exécuter > Télécharger sur la cible
l
fonction Exécuter > Paquet de Mise à jour en utilisant un Périphérique USB
Télécharger vers le périphérique IHM
78
Paquet de mise à jour
81
Le chargeur de runtime
83
Charger projets
84
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
77
Télécharger vers le périphérique IHM
Télécharger vers le périphérique IHM
Chemin : Exécuter> Télécharger sur la cible
Cette fonction transfert un projet et HMI Runtime via Ethernet.
Note : Le périphérique IHM doit avoir une adresse IP valide. Voir "Paramètres de base du périphérique IHM" on
page 8 pour des détails sur la manière d'assigner une adresse IP.
1. Cliquez sur le bouton découverte : une liste des adresses IP détectées s'affiche.
2. Sélectionnez l'adresse IP du périphérique IHM.
Vous pouvez même entrer l'adresse IP manuellement ou, le cas échéant, le nom d'hôte fourni par un serveur DNS.
Utiliser un outil de service tel que Bonjour, les périphériques IHM basés sur Linux peuvent être découverts en
utilisant leur nom d’hôte (par ex. HMI-0d37.local). Bonjour est une marque d’Apple inc.
3. Cliquez sur Télécharger : AGI Creator passe le périphérique IHM en Mode configuration et transfère les fichiers.
Lorsque l'opération de téléchargement est terminée, le périphérique IHM revient automatiquement au mode de
fonctionnement et le projet est lancé.
Options avancées
Option
Description
Télécharger
uniquement les
modifications
Transfère uniquement les fichiers de projet modifiés au périphérique IHM.
Format binaire
Télécharge des fichiers en utilisant le format binaire.
78
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
8 Transférer le projet au périphérique IHM
Option
Description
Supprimer les fichiers Les configurations modifiées de recettes, d'utilisateurs, de planificateurs, etc. qui ont été
dynamiques de
réalisées en cours d'exécution sont supprimées et écrasées par la configuration définie dans
runtime
le projet.
AVERTISSEMENT : Cette opération ne peut pas être annulée, les fichiers
dynamiques supprimés ne peuvent pas être restaurés.
AVERTISSEMENT : Les fichiers dynamiques ne sont pas supprimés
lorsqu'ils sont stockés dans des périphériques externes (USB ou cartes SD).
Télécharger projet
web
Télécharge les pages du AGI Web au périphérique IHM.
Lorsque vous transférez un projet, AGI Creator utilise une combinaison de connexions HTTP et FTP :
l
l
connexion HTTP - envoie les commandes pour passer en mode transfert ou pour charger le projet en cours
d'exécution,
session FTP - transfère les fichiers sur la mémoire flash dans le périphérique IHM.
Paramètres avancés
En utilisant l'option « Paramètres avancés », vous pouvez définir les ports à utiliser, mais en général, vous n'avez pas
besoin de saisir ces informations parce que les périphériques IHM fourniront les ports à utiliser à l'intérieur de la liste du
volet.
Changer de paramètres de connexion du périphérique IHM
Chemin : Exécuter> Gérer cible
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
79
Télécharger vers le périphérique IHM
1. Cliquez sur Configuration cible : la boîte de dialogue Paramètres avancés s'affiche. Le port par défaut pour les
connexions HTTPS sur le périphérique IHM est le port 80.
2. Définissez les bons ports HTTP, FTP ou HTTPS, FTPS pour le périphérique IHM. (Ce sont les ports utilisés par le
système pour se connecter au périphérique IHM et ils peuvent avoir besoin d'être modifiés lorsque les ports par
défaut sont utilisés par d'autres services ou d’autres applications ou si le réseau local nécessite des réglages
spécifiques.)
3. Spécifiez un Nom d'hôte pour identifier facilement chaque périphérique dans un réseau où plusieurs périphériques
sont disponibles. Le nom d'hôte par défaut est « IHM » pour tous les périphériques.
4. Cliquez sur Télécharger fichiers système. Au téléchargement suivant, les nouveaux ports sont utilisés dans le
périphérique IHM et le nouveau nom d'hôte apparaît dans la liste déroulante
Gérer des projets volumineux
Pour que le téléchargement fonctionne, la taille maximale du projet devrait être au moins inférieure de 2 MB à la mémoire
disponible. Dans le cas contraire, vous manquez de mémoire flash dans le périphérique IHM et un message
d'avertissement s'affiche.
Pour libérer plus de mémoire :
1. Cliquez sur Gérer cible.
2. Supprimez les projets dont vous n'avez plus besoin pour que plus de mémoire soit disponible.
80
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
8 Transférer le projet au périphérique IHM
Paquet de mise à jour
Pour installer ou mettre à jour HMI Runtime et le projet, vous pouvez créer un paquet à charger via USB.
Important : Toujours inclure à la fois projet et le runtime dans les paquets de mise à jour.
Si vous avez besoin d'utiliser un vieux projet avec la dernière version du runtime, convertir d’abord le projet. Voir "Installer
l’application" on page 2 pour plus de détails.
Création d’un paquet de mise à jour
Chemin : Exécuter> Paquet de mise à jour
Option
Description
Échec du
redémarrage de la
cible
Type de périphérique IHM. Sélectionné automatiquement si le projet est ouvert.
Projet
Ajouter un projet ouvert à un paquet de mise à jour.
Runtime & Plug-In
IHM
Le runtime IHM est ajoutée au paquet de mise à jour. Si le projet est ouvert, les plugins
nécessaires sont également ajoutés pour mettre à jour le paquet.
Format binaire
Télécharge des fichiers en utilisant le format binaire.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
81
Paquet de mise à jour
Option
Description
Projet web
Télécharge les pages du AGI Web au périphérique IHM.
Configurer mot de
passe cible
Définir le mot de passe pour effectuer des tâches critiques (par exemple,
téléchargement/chargement de projet, gestion de la carte)
Voir "Protéger l’accès aux périphériques IHM" on page 417.
Fichiers utilisateurs
Sélectionner les fichiers à copier dans le dossier QTHM du périphérique IHM. Taille max. 5 Mo
Crypté
Permet le chiffrement du paquet de mise à jour de sorte qu'il ne peut être décompressé par le
runtime IHM.
Emplacement
Emplacement du paquet de mise à jour.
Exemple d’emplacement du fichier utilisateur
Ordinateur :
C:\Users\Username\Desktop\myFolder
- subFolder1/file1
- subFolder1/file2
- file3
- file4
Périphériques WinCE :
/Flash/QtHmi
- subFolder1/file1
- subFolder1/file2
- file3
- file4
Périphériques Linux :
/mnt/data/hmi/qthmi
- subFolder1/file1
- subFolder1/file2
- file3
- file4
Note : Une copie des fichiers utilisateur est disponible uniquement depuis la clé USB.
Création d’un paquet de mise à jour
Chemin : depuis le menu contextuel > Mise à jour
82
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
8 Transférer le projet au périphérique IHM
1. En supposant que vous avez enregistré le paquet dans le dossier racine d'une clé USB, retirer le disque de
l'ordinateur, le brancher dans le périphérique IHM, afficher le menu contextuel en maintenant votre doigt pendant
quelques secondes sur l'écran et sélectionnez Mettre à jour.
2. Le système vérifie la présence du paquet de mise à jour à la racine du lecteur USB et demande la confirmation de
procéder à la mise à jour.
3. Sélectionner meilleur match de sélectionne automatique et cliquer sur Next : la procédure se termine
automatiquement. Vous pouvez également utiliser le bouton de navigation pour sélectionner le fichier à utiliser.
Le chargeur de runtime
Les périphériques IHM sont livrés depuis l'usine sans le Runtime.
Lorsque vous mettez le périphérique pour la première fois, la fenêtre Runtime Loader s'affiche (voir "Paramètres du
système" on page 369 pour plus de détails)
La présence du chargeur de runtime dépend du système d'exploitation du périphérique et peut ne pas être
disponible sur toutes les unités. Les anciennes versions des périphériques IHM ne peuvent pas inclure le
Chargeur de runtime. Contactez le support technique pour obtenir de plus amples informations.
Installation du runtime depuis AGI Creator
Lorsque vous téléchargez un projet, le Runtime est installée automatiquement si nécessaire.
Voir "Transférer le projet au périphérique IHM" on page 77 pour plus de détails.
1. Cliquez sur Installer Runtime : la procédure est exécutée automatiquement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
83
Charger projets
Installation du runtime depuis une clé USB
1. Préparer le paquet de mise à jour comme décrit dans "Paquet de mise à jour" on page 81
2. Brancher la clé USB dans le périphérique et suivre les instructions pour le type de périphérique (voir "Paramètres du
système" on page 369 pour plus de détails)
Note : Les anciennes versions des périphériques IHM ne peuvent pas supporter l’installation automatique du
Runtime. Contactez le support technique pour obtenir plus d’informations.
Charger projets
Chemin : Exécuter> Gérer cible
Vous pouvez copier un projet depuis le runtime sur un ordinateur où AGI Creator est en cours d’exécution.
1. Dans l’onglet Runtime, sélectionner l'adresse IP du périphérique depuis la Cible de la liste déroulante.
2. Cliquez sur Récupération des projets : une liste de tous les projets disponible est affichée.
3. Sélectionner le projet à télécharger
4. Cliquer sur Télécharger le projet
Le téléchargement pourrait être protégé par un mot de passe Voir "Protéger l’accès aux périphériques
IHM" on page 417 pour plus de détails.
5. Si besoin, entrer le mot de passe. Le processus de téléchargement démarre.
Une copie du projet est enregistré dans :
C:\Users\username\Documents\AGI Creator\workspace\Uploaded\RuntimeIPAddress\workspace\ProjectName
Note : Si l’opération de chargement échoue, vérifier les paramètres du pare-feu de l’Ordinateur où AGI Creator
est en cours d’exécution.
84
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9
Variables système
Chemin : Source> Associer à
Les variables système sont des variables spéciales qui contiennent des informations concernant le runtime de l'IHM.
Note : Les Variables systèmes sont disponibles également en tant que protocole standard dans l'éditeur de
protocoles. Utilisez les Variables système en tant que protocole quand vous transférez des données entre les
variables système et des variables de périphériques ou sélectionnez une fréquence de rafraîchissement
personnalisée pour une variable système.
Variables d'alarmes
87
Variables du signal sonore
87
Variables de communication
88
Variables de passage à l'heure d'été
88
Variables périphériques
89
Variables informations de vidage
91
Variables client FTP
92
Variables clavier
92
Variables réseau
92
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
85
Variables d’impression
93
Variables client à distance
94
Variables de version
94
Variable écran
95
Variables carte SD
95
Variables serveur
95
Variables d’heure
96
Variables écran tactile
96
Variables lecteur USB
98
Variables de gestion des utilisateurs
98
86
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Variables d'alarmes
Nombre d'alarmes du type demandé.
Variable
Description
Type de
données
Alarm not acknowledged
Vrai quand Alarmes non confirmées est en attente d'exécution
boolean
(Non déclenchée Ne pas confirmer<>0) OU (Déclenchée Ne pas
confirmer<>0)
read only
Vrai quand au moins une alarme a été déclenchée
boolean
(Déclenchée Confirmée<>0) OU (Déclenchée<>0) OU (Déclenchée Ne
pas confirmer<>0)
read only
Number of missed alarm
events
Alarmes qui dépassent la queue des événements. La longueur de la queue
est définie dans le fichier engineconfig.xml.
int
Number of not triggered
acknowledged
Condition d'alarme plus active ; alarmes déjà confirmées
int
Number of not triggered
not acknowledged
Condition d'alarme plus active ; en attente de confirmation
Number of triggered
acknowledged
Condition d'alarme active ; alarmes déjà confirmées
Number of triggered
alarms
Alarme active : confirmation non requise
Number of triggered not
acknowledged
Condition d'alarme active ; en attente de confirmation
Alarm triggered
read only
read only
int
read only
int
read only
int
read only
int
read only
Note : Pour des raisons de compatibilité, les anciens noms restent toujours valides même s'ils sont obsolètes.
Variables du signal sonore
Ajuster le comportement du signal sonore.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
87
Variables de communication
Type de
données
Variable
Description
Buzzer
Setup
0 = désactivé
1 = activé (le signal sonore est audible pour tous les événements de l'écran tactile)
2 = état de bipeur contrôlé par la variable système de contrôle Bipeur ou par la propriété
Bipeur tactile dans les "Propriétés de projet" on page 59
int
Le bipeur sur l'écran tactile (Setup = 1) n’est pas disponible sur les
plateformes Linux. Voir la propriété « Bipeur tactile » comme alternative.
Buzzer
Control
0 = signal sonore éteint
1 = signal sonore allumé
2 = clignotement
int
Buzzer
Off Time
Durée en millisecondes du temps d'arrêt du signal lorsque le clignotement a été sélectionné.
Par défaut = 1 000. Plage : 100-5 000.
int
Buzzer
On Time
Durée en millisecondes du temps du signal sonore lorsque le clignotement a été sélectionné.
Par défaut = 1 000. Plage : 100-5 000.
int
Variables de communication
État de communication entre le périphérique IHM et les contrôleurs.
Variable
Type de
données
Description
Protocol
Résume l'état des protocoles de communication.
Communication
0 = Aucun protocole en cours d'exécution, il est possible que les pilotes des protocoles
Status
n'aient pas été téléchargés correctement sur le périphérique IHM.
int
Read
only
1 = Protocoles chargés et démarrés, aucune erreur de communication.
2 = Au moins un protocole de communication signal une erreur.
Protocol Error
Message
Erreur de communication avec source de l'erreur.
Par exemple : « [xxxx] » ou « xxxx » est l'abréviation du protocole, source de l'erreur.
En cas de plusieurs sources de l'erreur, plusieurs sigles s'affichent. Vide lorsqu'aucune
erreur n'a été signalée.
Protocol Error
Count
Nombre d'erreurs de communication survenues depuis la dernière réinitialisation.
Réinitialisez la valeur à l'aide de l'action de Réinitialisation du décompte d'erreurs de
protocoles, cf. "Actions système" on page 123.
Chaîne
ASCII
Read
only
int
Read
only
Variables de passage à l'heure d'été
Informations concernant l'horloge système. Ces variables contiennent des informations concernant l'heure locale. Les
options disponibles sont le temps standard (heure solaire) et l'heure d'été (DST).
88
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Note : Toutes les variables sont en lecture seule ; il n'est pas possible de les utiliser pour mettre à jour l'horloge
système.
Variable
Description
Standard
Offset
Décalage en minutes par rapport au GMT lorsque l'heure est réglée sur l'heure standard (par exemple : 8 x 60 = -480 minutes).
Standard
Week
Semaine à partir de laquelle l'heure standard est appliquée (par exemple : Première = 1).
Standard
Month
Mois à partir duquel l'heure standard est appliquée. Plage : 0-11. (par exemple : Novembre = 10).
Standard
Day
Jour de la semaine à partir duquel l'heure standard est appliquée (par exemple : Dimanche = 0).
Standard
Hour
Heure à partir de laquelle l'heure standard est appliquée (par exemple : 02 = 2).
Standard
Minute
Minute à partir de laquelle l'heure standard est appliquée (par exemple : 00 = 0).
DST Offset
Décalage en minutes par rapport au GMT lorsque l'heure est réglée sur l'heure d'été
DST Week
Semaine à partir de laquelle l'heure d'été est appliquée
DST Month
Mois à partir duquel l'heure d'été est appliquée. Plage : 0-11.
DST Day
Jour de la semaine à partir duquel l'heure d'été est appliquée
DST Hour
Heure à partir de laquelle l'heure d'été est appliquée
DST Minute
Minute à partir de laquelle l'heure d'été est appliquée
Variables périphériques
Paramètres des périphériques et informations d'état de fonctionnement.
Variable
Description
Type de
données
Available
System
Memory
Mémoire RAM libre en octets.
uint64
Backlight
Time
Temps d'activation en heures du rétroéclairage de l'affichage depuis la fabrication du
périphérique.
unsignedInt
Battery LED
Active/désactive l'indicateur de batterie faible pour la LED (si disponible).
int
read only
read only
0 = désactivé
1 = activé
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
89
Variables périphériques
Variable
Type de
données
Description
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des
périphériques IHM." on page 431 pour plus de détails sur les panneaux)
Battery
Timeout
Réservé
int
Display
Brightness
Réinitialise et adapte le niveau de luminosité.
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des
périphériques IHM." on page 431 pour plus de détails sur les panneaux)
int
Même lorsqu'il est réglé sur 0, le rétroéclairage reste allumé et le décompte du Backlight
Time continue.
Plage : 0-255
Sur le périphérique WinCE uniquement :
Lorsque le rétroéclairage est réglé sur un niveau de luminosité faible (0...3), il reste allumé
à un niveau plus élevé pendant 8 secondes afin de permettre à l'utilisateur d'effectuer les
réglages, puis il s'éteint.
External
Timeout
Délai d'inactivité après lequel le rétroéclairage s'éteint automatiquement. Le rétroéclairage
s'allume automatiquement dès que l'utilisateur touche l'écran.
int
-1 = éteindre le rétroéclairage et désactiver les commandes tactiles (éteindre l'affichage).
Le compteur de temps de rétroéclairage est arrêté.
0 = allumer le rétroéclairage (allumer l'affichage)
1..n = délai d'attente, en secondes, pour éteindre le rétroéclairage (minuteur de l'écran de
veille)
Sur le périphérique Linux (voir "Capacités des périphériques IHM." on page 431
pour les détails du panneau), délai d'attente géré en quelques minutes. La
valeur saisie est convertie en minutes arrondies à la valeur suivante, par
exemple, 60, 120, 180.
Flash Free
Space
Espace flash libre restant dans la mémoire flash interne.
uint64
read only
Manufacturer Code interne qui identifie le type d'IHM
Code
unsignedInt
System Font
List
Liste des polices du système
string
Mode
système
État de service de runtime.
read only
read only
int
1 = démarrage en cours
2 = mode de configuration
90
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Variable
Description
Type de
données
3 = mode de service
4 = redémarrage
5 = arrêt
System
UpTime
Temps pendant lequel le système a été alimenté depuis la fabrication du groupe (en
heures).
unsignedInt
read only
Variables informations de vidage
État du processus de copie vers les lecteurs (USB ou carte SD) pour les mémoires de tendances d'événements.
Note : Si la copie prend moins d'une seconde, la valeur de la variable système reste inchangée.
Variable
Description
Type de
données
Dump
Archive
Status
1 = copie mémoire d'événements en cours
int
Message
d’erreur
Vidage
Retour du message d'erreur si une erreur se produit pendant l'opération de vidage
Dump Recipe
Status
1 = copie mémoire de recettes en cours
int
Si la copie prend moins d'une seconde, la valeur de la variable système reste inchangée
read only
Dump Trend
Status
1 = copie mémoire de tendance en cours
int
Reset Recipe
Status
1 = réinitialisation de mémoire de recettes en cours
int
Si la réinitialisation prend moins d'une seconde, la valeur de la variable système reste
inchangée
read only
Restore
Recipe Status
Retour d'information pendant le processus de copie de recettes. Si la copie prend moins
d'une seconde, la valeur de la variable système reste inchangée.
int
read only
string
read only
read only
read only
0 = état initial par défaut
1 = opération déclenchée
2 = opération terminée avec succès
3 = opération terminée avec erreurs
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
91
Variables client FTP
Variables client FTP
Les variables client FTP sont mises à jour lorsque les actions FTP sont utilisées.
Variable
Description
Type de données
Commande en cours FTP
Dernière commande FTP
string
read only
Message d’erreur FTP
Dernier message d’erreur FTP
string
read only
Progression FTP
Progression téléchargement / chargement (0/100%)
short
read only
État FTP
État de la dernière commande FTP :
l
0 = inactif
l
1 = actif
l
2 = effectué
l
3 = erreur
short
read only
Variables clavier
État du clavier.
Variable
Description
Type de données
Is keypad open
0 = aucun clavier ouvert
int
1 = clavier ouvert
read only
Variables réseau
Paramètres réseau du périphérique.
Variable
Description
Type de
données
Adapters
Parameters
Chaîne JSON qui permet de lire ou de mettre à jour les paramètres d'adaptateurs réseau
string
Gateway
Adresse de passerelle de l'interface Ethernet principale du périphérique
string
read only
Adresse IP
Adresse IP de l'interface Ethernet principale du périphérique
string
read only
92
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Variable
Description
Type de
données
Mac ID
Mac ID de l'interface Ethernet principale du périphérique
string
read only
Status
Subnet Mask
Contient les résultats de la dernière opération requise par l'écriture dans les Paramètres
des adaptateurs. Cette valeur est actualisée après chaque opération d'écriture.
l
Si la chaîne est vide, cela signifie qu'il n'y a aucune erreur
l
Descriptions des erreurs les plus récentes
Masque de sous réseau de l'interface Ethernet principale du périphérique
string
read only
string
read only
Variables d’impression
Informations concernant les fonctions d'impression.
Variable
Description
Type de
données
Completion
percentage
Progression de la tâche d'impression actuelle en pour cent.
read only
Current disk
usage
Taille en octets du dossier de stockage des rapports PDF.
Current job
Nom du rapport que la tâche traite actuellement. La tâche actuelle est la
suivante :
Plage : 0-100
read only
Si Flash a été sélectionné en tant que Type de média spool, cette valeur
correspond à rapportspool.
l
[nom de rapport] pour un Rapport graphique
l
[première ligne de texte] pour un Rapport texte
read only
Current RAM
usage
Taille en octets de la mémoire RAM utilisée pour le traitement de la tâche
actuelle
read only
Disk quota
Taille maximale en octets du dossier de stockage des rapports PDF
read only
Graphic job queue
size
Nombre de tâches de graphique dans la queue d'impression
read only
Last error
message
Description de la dernière erreur affichée
string
RAM quota
Taille maximale en octets de la mémoire RAM utilisée pour la génération des
rapports
read only
Status
État système de l'impression.
string
read only
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
93
Variables client à distance
Variable
Text job queue
size
Description
Type de
données
Valeurs :
read only
l
idle
l
error
l
paused
l
printing
Nombre de tâches de texte dans la queue d'impression
read only
Variables client à distance
Les variables système suivantes sont associées aux fichiers lors du transfert sur un périphérique IHM distant.
Variable
Description
Type de données
Download from HMI error message
Description de l'erreur
Chaîne ASCII
read only
Download from HMI percentage
Progression du téléchargement (0 100)
read only
Download from HMI status
0 = inactif, action non utilisée ou terminée
int (32 bits)
1= téléchargement du fichier en cours
read only
2 = erreur
Upload to HMI error message
Description de l'erreur
Chaîne ASCII
read only
Upload to HMI percentage
Progression du chargement (0 100)
read only
Upload to HMI status
0 = inactif, action non utilisée ou terminée
int (32 bits)
1= chargement du fichier en cours
read only
2 = erreur
Variables de version
Versions du système d'exploitation et du runtime.
Variable
Description
Type de données
Main OS Version
Version d’OS principal.
string
Runtime Version
Version de runtime.
string
94
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Variable écran
État de l'écran.
Variable
Description
Time remaining to
unlock
Temps restant avant le déverrouillage de l'écran (voir action LockScreen, "Actions de page"
on page 112)
X Screen resolution
Affiche la taille de l'écran horizontal en pixels
Y Screen resolution
Affiche la taille de l'écran vertical en pixels
Variables carte SD
Informations concernant la carte SD externe.
Variable
Description
Type de données
SD Card FreeSpace
Espace de mémoire libre sur la carte en octets
uint64
read only
SD Card Name
Nom de la carte SD
string
read only
SD Card Size
Tailles en octets de la carte enfichée dans le logement
uint64
read only
SD Card Status
0 = carte SD débranchée
1 = carte SD branchée
int
read only
Variables serveur
État du serveur.
Important : Toutes les variables se référent au serveur, pas à AGI Client.
Variable
Description
Type de
données
Current page
Nom de la page actuellement affichée
string
Current project
Nom du projet actuel
string
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
95
Variables d’heure
Variable
Description
Type de
données
Operating
mode time
Temps en secondes depuis le démarrage du mode de service du périphérique
uint64
Project load
time
Date de chargement du projet sur HMI Runtime comme indiqué au format de la Date
système (millisecondes).
uint64
Variables d’heure
Heure système au format UTC.
Variable
Description
Type de
données
Day Of
Month
Plage : 1-31
int
Day of
Week
Plage : 0 = Dimanche, ... , 6 = Samedi
int
Hour
Plage : 0-23
int
Minute
Plage : 0-59
int
Month
Plage : 1-12
int
Second
Plage : 0-59
int
System
Time
Correspond à l'heure UTC. Il est également possible de configurer cette variable au
format date/heure.
unsignedInt
Year
Année en cours
int
Variables écran tactile
État et position du curseur sur l'écran tactile. Ce sont des propriétés de la page active et elles peuvent être sélectionnées
dans la section Widget.
96
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
9 Variables système
Note : Les dimensions de la page peuvent différer de celles de l'affichage du périphérique IHM.
Variable Description
Java Script
Page
Touch
X
page.primaryTouch.x
Position du curseur par rapport à la page
page.principaleToucher.y
Page
Touch
Y
Screen
Touch
X
Position du curseur par rapport à l'écran tactile
page.primaryTouch.screenX
page.primaryTouch.screenY
Screen
Touch
Y
Touch
Press
0 = pas d'appui sur l'écran
Touch
Status
Modifications génériques de l'écran tactile. Cette variable contient la
concaténation des variables Screen Touch X, Screen Touch Y et Touch
Press (par exemple, « 924,129,0 »).
page.primaryTouch.pressed
1 = appui sur l'écran
page.primaryTouchStatus
La fonction principale de cette variable est de déclencher un événement à
l'aide de la fonctionnalité OnDataUpdate dès qu'un changement survient (x, y
ou clic).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
97
Variables lecteur USB
Variables lecteur USB
Informations concernant le lecteur USB externe connecté au périphérique.
Variable
Description
Type de données
USB Drive free space
Espace de mémoire libre en octets
uint64
read only
USB Drive Name
Nom du périphérique USB
string
read only
USB Drive Size
Taille en octets du lecteur connecté au port USB
uint64
read only
USB Drive Status
0 = Clé USB débranchée
1 = Clé USB branchée
int
read only
Variables de gestion des utilisateurs
Informations concernant les utilisateurs et les groupes.
Variable
Description
Type de
données
No of RemoteClients Alive
Numéro de AGI Client connectés au serveur
short
This Client
Group-Name
Groupe de l'utilisateur actuellement connecté
This Client ID
Uniquement pour AGI Client. Les clients locaux et distants connectés au même
serveur (par exemple, le runtime) reçoivent un ID unique.
short
Nom de l'utilisateur connecté au client où la variable système est affichée.
string
This Client
User-Name
98
read only
string
read only
read only
read only
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
10
Variables système non volatiles
La mémoire rémanente est une option du protocole des variables système. Elle fournit une zone de mémoire dont le
contenu est conservé lorsque le périphérique IHM est éteint.
Précisions sur la mémoire rémanente
100
Configurer la mémoire rémanente
100
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
99
Précisions sur la mémoire rémanente
Précisions sur la mémoire rémanente
Le support physique pour la mémoire rémanente se base sur la technologie FRAM.
Important : Tous les périphériques IHM n'ont pas de mémoire FRAM. Si aucune mémoire FRAM n'est
disponible, la persistance peut être assurée par les supports de stockage de l'utilisateur (mémoire
flash ou disque dur externe). La technologie flash est limitée car il y a un nombre maximum
d'opérations d'écriture à ne pas dépasser. En cas d'opérations d'écriture fréquentes, l'utilisation de la
mémoire flash comme moyen de stockage pour la mémoire rémanente risque d'endommager les
composants de mémoire. Regardez si votre périphérique IHM dispose d'une mémoire FRAM.
Important : Taille de la mémoire rémanente : jusqu'à 16 KB.
Simulateur de AGI Creatorsupporte la mémoire rémanente. Afin d'activer la mémoire rémanente lors
de la simulation du projet, choisissez l'option « Conserver les données rémanentes en simulant le
projet » dans le menu contextuel.
Mémoire rémanente ou stockage de recettes
Les données de recette sont enregistrées dans la mémoire flash (sauf pour AGI PC Runtime) tandis que les données non
volatiles sont enregistrées dans une mémoire FRAM. La mémoire flash ne se prête pas à un nombre important d'opérations
d'écriture, alors que la FRAM supporte un nombre d'opérations d'écriture virtuellement illimité et est donc préférable en cas
d'opérations d'écriture fréquentes.
Configurer la mémoire rémanente
Chemin : VueProjet> Protocoles
100
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
10 Variables système non volatiles
1. Cliquez sur + et sélectionnez Variables système : la boîte de dialogue Variables système s'affiche.
2. Sélectionner Mémoire rémanente depuis la liste PLCModels.
Chemin : VueProjet> variables
La mémoire rémanente est une zone de mémoire plate d'octets accessibles par un index de décalage.
Utilisation des types de variables plus grandes d'un octet, par exemple court, garder à l'esprit que le décalage de la
mémoire rémanente est en octets pour éviter les chevauchements.
Exemple :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
101
Configurer la mémoire rémanente
Effacer la mémoire rémanente
Utilisez l'action ClearRetentiveMemory pour effacer le contenu de la mémoire rémanente.
Astuce : Utilisez cette action pour définir le contenu de la mémoire à un état connu à tout moment.
102
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
10 Variables système non volatiles
Voir "Actions de variable" on page 130 pour plus de détails.
Interface JavaScript
project.clearRetentiveMemory();
Conservation de la mémoire rémanente lors du téléchargement d'un projet
Quand vous téléchargez un fichier de projet sur un périphérique IHM, ou quand vous modifiez le projet actif, le contenu de la
mémoire rémanente est normalement supprimé.
Si vous souhaitez conserver le contenu des données non volatiles lorsque vous téléchargez ou mettez à jour un projet,
sélectionnez l'option Conserver les données rémanentes en téléchargeant le projet de projet dans les onglets
paramètres du périphérique IHM.
Ce paramètre sera ignoré si vous sélectionnez l'option Supprimer les fichiers dynamiques au moment de télécharger le
projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
103
Configurer la mémoire rémanente
104
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11
Actions
Les actions sont des fonctions permettant d'interagir avec le système. Elles sont exécutées en général lors du
déclenchement d'événements.
Divers widgets peuvent déclencher des événements, par exemple, en appuyant et en relâchant un bouton. Toutes les
actions ne sont pas disponibles pour tous les événements d'un objet.
Les actions sont associées à des widgets dans la section Événements du volet Propriétés (Éditeur de pages).
Actions d'alarmes
106
Actions d'événements
106
Actions multilangues
107
Actions clavier
107
Actions lecteurs médias
109
Action FTP
109
Actions de page
112
Actions d'impression
116
Actions de recette
117
Actions client à distance
122
Actions système
123
Actions de variable
130
Actions de tendance
132
Actions de gestion des utilisateurs
135
Actions widget
138
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
105
Actions d'alarmes
Actions d'alarmes
Permet de confirmer ou de réinitialiser les alarmes.
SelectAllAlarms
Sélectionne toutes les alarmes dans le widget d'alarmes.
AckAlarm
Confirme les alarmes sélectionnées.
ResetAlarm
Réinitialise les alarmes confirmées sélectionnées.
EnableAlarms
Sauvegarde les modifications dans la colonne Activer du widget d'alarmes. Cette action s'utilise en cliquant sur le bouton
Sauvegarder dans le widget d'alarmes.
Actions d'événements
Utilisées par le widget de l'Historique des alarmes pour le défilement des événements/alarmes dans la vue de tableau
(widget de mémoire d'événements).
ScrollEventsBackward
Faire défiler les événements/actions en arrière dans la vue de tableau (widget de mémoire d'événements).
ScrollEventsForward
Faire défiler les événements/actions en avant dans la vue de tableau (widget de mémoire d'événements).
106
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Actions multilangues
Sélectionne la langue de l'application.
ConfigurerLangue
Configure la langue à utiliser. La langue sélectionnée sera appliquée dans l'exécution à tous les widgets concernés.
Actions clavier
Modifie les claviers utilisés.
EnvoiTouche
Envoie un caractère à un widget numérique. La propriété TypeClavier du widget numérique doit être configurée sur Macro.
WidgetEnvoiTouche
Envoie un caractère à un widget particulier.
Exemple
Les boutons Haut et Bas utilisent l'action WidgetEnvoiTouche en combinaison avec le Widget de listes de contrôle.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
107
Actions clavier
AfficherClavier
Affiche le clavier tactile que le système d'exploitation utilise par défaut.
Note : cette fonction ne pourrait pas être prise en charge par tous les systèmes d'exploitation.
108
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Clavier
Active/Désactive l'utilisation des actions lors de l'utilisation d'un clavier externe. L'exécution des actions peut être
activée/désactivée aussi bien au niveau de projet qu'au niveau de page.
Cette fonction a le même effet que l'utilisation du clavier des propriétés pour le projet et la page.
Actions lecteurs médias
Interagit avec le widget du lecteur médias de l'exécution.
Action
Description
PlayMedia
Lance la lecture de la vidéo.
StopMedia
Arrête la lecture de la vidéo.
ReloadMedia
Reprend la lecture de la vidéo depuis le début.
PauseMedia
Met la vidéo en pause.
BrowseMedia
Sélectionne la vidéo pour lecture.
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des périphériques IHM." on page 431
pour plus de détails sur les panneaux)
Action FTP
Utilisé pour le chargement et le téléchargement de fichiers du et vers un serveur FTP distant.
ftpGET
Télécharger les fichiers depuis un serveur FTP distant
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
109
Action FTP
Paramètre
Description
FtpConfig
Configuration des paramètres FTP
FtpRemoteFileName
Nom du fichier sur un serveur FTP pour télécharger (source)
FtpLocalFileName
Nom du fichier sur un périphérique IHM local (destination)
ftpPUT
Charger les fichiers sur un serveur FTP distant
Paramètre
Description
FtpConfig
Configuration des paramètres FTP
FtpLocalFileName
Nom du fichier sur un périphérique IHM local (source)
FtpRemoteFileName
Nom du fichier sur un serveur FTP pour télécharger (destination)
Les noms de fichier peuvent contenir des métacaractères.
Une fois transférées, les variables système sont adaptées à l'état des opérations en cours (voir "Variables client FTP" on
page 92pour plus de détails).
Configuration serveur FTP
Pour configurer le paramètre FTP, entrez les informations suivantes pour le paramètre FtpConfig :
Paramètre
Description
Adresse FTP
Adresse IP de serveur FTP
Port de serveur
Port pour connexion FTP (par défaut = 21).
Authentification
Choisissez l’authentification FTIP à utiliser :
l
Normal (nom d’utilisateur et mot de passe requis)
l
Anonyme
Identifiant
Nom d’utilisateur du compte FTP distant
Mot de passe
Mot de passe du compte FTP distant
Cliquez sur + pour ajouter plus de configuration des serveurs FTP.
Astuce : Utilisez les variables si vous voulez changer les paramètres du serveur de manière dynamique depuis
la HMI Runtime.
110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Interface JavaScript FTP
ftpConfig
ftpCONFIG (IPAddress, Port, Authentication, UserName, Password)
Régler les paramètres FTP pour utiliser les prochains appels FTP
Paramètre
Description
IPAddress
Adresse IP de serveur FTP.
Port
Port pour connexion FTP (par défaut = 21).
Authentification
Choisissez l’authentification FTIP à utiliser :
l
Normal (nom d’utilisateur et mot de passe requis)
l
Anonyme
Identifiant
Nom d’utilisateur du compte FTP distant
Mot de passe
Mot de passe du compte FTP distant
ftpGET
ftpGET (remoteFileName, localFileName, [callback])
Télécharger les fichiers depuis un serveur FTP distant
Paramètre
Description
remoteFileName
Nom du fichier sur un serveur FTP pour télécharger (source)
localFileName
Nom du fichier sur un périphérique IHM local (destination)
fonction de rappel
Fonction qui sera appelée à la fin du transfert FTP
ftpPUT
ftpPUT (remoteFileName, localFileName, [callback])
Charger les fichiers sur un serveur FTP distant
Paramètre
Description
remoteFileName
Nom du fichier sur un serveur FTP pour télécharger (source)
localFileName
Nom du fichier sur un périphérique IHM local (destination)
fonction de rappel
Fonction qui sera appelée à la fin du transfert FTP
Exemple :
project.ftpCONFIG("192.168.0.200", "21", "true", "admin", "admin");
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
111
Actions de page
project.ftpGET( "data.txt",
"\\USBMemory\\data.txt",
function(ftpStatus) {fnFtpGetFinished(ftpStatus);} );
function fnFtpGetFinished(ftpStatus) {
alert(ftpStatus);
}
Actions de page
Navigation sur la page. Les actions de page peuvent être utilisées avec les événements suivants :
l
OnMouseClick,
l
OnMouseRelease,
l
OnMouseHold
l
OnActivate
l
OnDeactivate
l
Alarmes
l
Planificateurs.
LoadPage
Permet de se rendre à la page sélectionnée du projet.
HomePage
Permet de se rendre à la page d'accueil.
Vous pouvez configurer la page d'accueil dans la section Comportement du Widget de projet, voir "Comportement" on
page 66
PrevPage
Permet de retourner à la page précédente.
NextPage
Permet de passer à la page suivante.
LastVisitedPage
Permet de retourner à la page affichée précédemment
ShowDialog
Affiche la page de dialogue définie dans le projet.
112
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
CloseDialog
Ferme les pages de dialogue.
Note : Cette action peut être utilisée uniquement pour les pages de dialogue.
Options CloseDialog
Option
Description
All
Ferme tous les dialogues ouverts
Selected
Ferme uniquement le dialogue actif
DialogName
Ferme le dialogue indiqué par la propriété nomFichier
Interface JavaScript
project.closeDialog(DialogID);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
113
Actions de page
Où DialogID :
All
Ferme tous les dialogues ouverts
Selected
Ferme uniquement le dialogue actif
DialogName.jmx
Ferme le dialogue indiqué par le paramètre nomFichier
Exemples
Exemple
Comportement
project.closeDialog("All");
Tous les dialogues ouverts sont fermés
project.closeDialog("Selected");
Le dialogue sélectionné est fermé
project.closeDialog("Dialog1.jmx");
Toutes les instances du Dialogue1 sont fermées
Sans paramètres, le paramètre project.closeDialog(); exécute l'action project.closeDialog("Selected");.
ShowMessage
Affiche un message pop-up. Veuillez saisir le texte du message qui sera affiché.
LaunchApplication
Lance une application externe.
Paramètre
Description
App Name
Nom exécutable avec extension (par exemple, « notepad.exe » pour exécuter
Notepad)
Path
Chemin de l'application.
Arguments
Arguments particuliers de l'application (par exemple, \flash\qthmi\Manuel.pdf pour
ouvrir le document « Manuel.pdf »)
SingleInstance
Argument qui permet de faire lance l'application dans une seule instance ou dans
plusieurs instances.
Lorsqu'une seule instance est sélectionnée, le système vérifie d'abord si
l'application est déjà en cours d'exécution ; si oui, l'application s'affiche en avantplan, sinon l'application est lancée.
FlushRuntimeCache Efface tous les cache de runtime pour libérer le plus de ram possible avant de lancer
l'application.
Note : Il est nécessaire de citer également les espaces des arguments (par exemple, "\Carte de
stockage\Manuel.pdf")
Exemple :
114
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
LaunchBrowser
Ouvre le navigateur web par défaut. Vous pouvez définir une adresse URL comme argument.
Note : Fonctionne uniquement sur les plateformes dotées d'un navigateur web natif (par exemple, Internet
Explorer habilité dans Windows CE PRO).
LaunchVNC
Démarrer le serveur VNC et affiche le menu de configuration.
Macro disponible uniquement pour les périphériques IHM basés sur une plateforme Windows CE.
Sur les périphériques IHM basés sur la plateforme Linux, le service VNC peut être activé depuis l'onglet
« Service » de l’"Paramètres du Système sur les Périphériques Linux" on page 381
Voir "Modules de plug-in de logiciels" on page 66 pour l'inclure sur les périphériques Windows CE.
LaunchPDFViewer
Lance l’afficheur PDF.
Note : Fonctionne uniquement sur les périphériques dotés d'un afficheur PDF.
Voir "Modules de plug-in de logiciels" on page 66 pour l'inclure sur les périphériques Windows CE.
LaunchUpdater
Met à jour le projet et le runtime depuis un périphérique externe.
Utiliser le paramètre Path pour spécifier le dossier qui contiendra le fichier de paquet de mise à jour. Laisser le paramètre de
chemin vide si vous préférez sélectionner manuellement le fichier sur le périphérique IHM lorsque la macro est invoquée.
Lorsque la macro LaunchUpdater est exécutée, la boîte de dialogue ci-dessous s'affiche sur le périphérique IHM
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
115
Actions d'impression
Note : Cette fonction n'est pas supportée sur les périphériques basés sur Win32.
Interface JavaScript
project.launchUpdater(strPath)
Exemples
project.launchUpdater("\\USBMemory")
Macro disponible uniquement pour les périphériques IHM basés sur une plateforme Windows CE.
Sur les périphériques IHM basés sur la plateforme Linux, le Service Cloud peut être activé depuis l'onglet
« Service » de l’"Paramètres du Système sur les Périphériques Linux" on page 381
LockScreen
Active le verrouillage temporaire de l'écran tactile. Permet le nettoyage de l'écran tactile.
La variable système Time remaining to unlock affiche le temps restant avant le déverrouillage. Voir "Variable écran" on
page 95.
Actions d'impression
Gère les tâches d'impression.
PrintGraphicReport
Imprime un rapport graphique.
Paramètre
Description
reportName
Attribue un nom au rapport
silent
faux = permet de configurer les propriétés de l'imprimante dans l'exécution
PrintText
Imprime une chaîne.
Paramètre
Description
text
Chaîne à imprimer
silent
faux = permet de configurer les propriétés de l'imprimante dans l'exécution
Cette action fonctionne en mode d'impression ligne par ligne et utilise un protocole standard partagé de toutes les
imprimantes qui prennent en charge cette fonction. Le texte est imprimé immédiatement ligne par ligne ou imprimé après un
délai d'attente défini individuellement pour chaque modèle d'imprimante.
Note : l'impression pourrait prendre quelques minutes sur les modèles qui ne sont pas conçus pour l'impression
ligne par ligne.
116
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des périphériques IHM." on page 431
pour plus de détails sur les panneaux)
PrintBytes
Imprime une chaîne hexagonale qui représente les données à imprimer (par ex. « 1b30 » pour imprimer < ESC 0 >.
Paramètre
Description
octets
Chaîne hexadécimale à imprimer
silent
faux = permet de configurer les propriétés de l'imprimante dans l'exécution
Cette action fonctionne en mode d'impression ligne par ligne et utilise un protocole standard partagé de toutes les
imprimantes qui prennent en charge cette fonction. Le texte est imprimé immédiatement ligne par ligne ou imprimé après un
délai d'attente défini individuellement pour chaque modèle d'imprimante.
Note : l'impression pourrait prendre quelques minutes sur les modèles qui ne sont pas conçus pour l'impression
ligne par ligne.
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des périphériques IHM." on page 431
pour plus de détails sur les panneaux)
EmptyPrintQueue
Efface la queue d'impression actuelle. Lorsque l'action est exécutée au cours d'une tâche d'impression, la queue est vidée
une fois la tâche terminée.
PausePrinting
Met la queue d'impression actuelle en attente. Lorsque l'action est exécutée au cours d'une tâche d'impression, la queue
est mise en pause une fois la tâche terminée.
ResumePrinting
Relance la queue précédemment mise en attente.
AbortPrinting
Arrête l'exécution de la tâche actuelle et la supprime de la queue. Si la queue contient une autre tâche, cette tâche est
lancée dès que la tâche actuelle a été annulée.
Actions de recette
Utilisées pour programmer la gestion des recettes.
DownloadRecipe
Copie les données de recette d'une mémoire flash du périphérique IHM (par ex. API, variable locale, en fonction du
protocole) sur le contrôleur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
117
Actions de recette
Paramètre
Description
RecipeName
Nom de la recette à télécharger
RecipeSet
Numéro de l'ensemble de recettes à copier.
ensAct = télécharger ensemble de recettes sélectionné
UploadRecipe
Enregistre les données de recettes du contrôleur (par ex. API, variable locale, en fonction du protocole) dans la mémoire
flash du périphérique.
Paramètre
Description
RecipeName
Nom de la recette à charger
RecipeSet
Numéro de l'ensemble de recettes à copier.
ensAct = charger ensemble de recettes sélectionné
ÉcrireEnsembleRecettesActuel
Configure la recette sélectionnée en tant qu'ensemble de recettes actuel.
Paramètre
Description
RecipeName
Nom de la recette à configurer comme recette actuelle
RecipeSet
Ensemble de recettes à définir comme ensemble de recettes actuel
TéléchargerRecetteAct
Télécharge les données de l'ensemble de recettes actuel sur le contrôleur.
Aucun paramètre requis.
ChargerRecetteAct
Charge un ensemble de données du contrôleur pour l'ajouter à l'ensemble de recettes actuel.
Aucun paramètre requis
RéinitialiserRecette
Restaure les paramètres usine pour les données de recettes. Les données de recettes d'origine écraseront les recettes
chargées
Sélectionnez la recette que vous souhaitez réinitialiser pour restaurer les données d'usine.
ViderDonnéesRecette
Déplace les données de recette à un périphérique de stockage interne ou externe. Les données sont enregistrées au format
.csv.
118
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Paramètre
Description
RecipeName
Nom de la recette à clicher
FilePath
Dossier de destination
l
Interne = \Flash\QTHMI\workspace\Dump
l
Clé USB = \USBMemory
l
Carte SD = \Storage Card
l
Réseau public = \\<nom d'hôte ou IP>\sharePath
l
Réseau privé = \\<nom d’utilisateur>:<mot de passe>@<nom d'hôte ou
IP>\<partage>/<chemin>
Note : les formats supportés pour la mémoire externe sont FAT ou FAT32 (le
format NTFS n'est pas pris en charge).
Note : Les réseaux privés sont supportés uniquement par les périphériques Linux
avec BSP à partir de la version 1.0.25.
FileName
Variable qui définit un nom de fichier.
DateTimePrefixFileName vrai = un préfixe composé de la date et de l'heure sera ajouté au fichier vidé (par exemple
D2012_01_01_H10_10_recette1.csv)
TimeSpec
Format de l'heure :
l
l
Locale = les valeurs de temps exportées correspondent à l'heure du périphérique
IHM.
Globale = les valeurs de temps sont exportées au format UTC.
RestaurerDonnéesRecette
Restaure les données de recette enregistrées auparavant.
Paramètre
Description
RecipeName
Recettes à restaurer :
l
l
AllRecipes
Les données de toutes les recettes seront remplacées par les données lues à partir du fichier
externe
CurrentRecipe
Seule la donnée de la recette sélectionnée en cours seront remplacées par les données lues à
partir du fichier externe
RecipeDataSet Disponible uniquement quand RecipeName=CurrentRecipe.
Sélectionner les ensembles de données à restaurer :
l
AllRecipeDataSet
L’ensemble des données sera restauré
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
119
Actions de recette
Paramètre
Description
l
Type de
restauration
Disponible uniquement quand RecipeDataSet=AllRecipeDataSet.
Ce paramètre définit le comportement lorsque les nombres d'ensembles de données à l'intérieur du
fichier à restaurer ne correspondent pas avec le numéro de série de données à l'intérieur du
périphérique IHM
l
l
l
FilePath
curSet
Seul le jeu de données des données sélectionné en cours sera restaurer
Remplacer
Tous les ensembles de données qui sont à l'intérieur du dispositif sont retirés et remplacées par
les ensembles de données depuis le fichier CSV
Match
Remplacer uniquement l’ensemble de données à l'intérieur du périphérique qui ont le même
identifiant d’ensemble des données
MatchAndAdd
Remplacer l'ensemble des données à l'intérieur du dispositif qui ont le même identifiant
d’ensemble de données et ajouter l'ensemble supplémentaire de données trouvé dans le fichier
csv (Remarque : les ensembles de données qui sont à l'intérieur du périphérique, mais pas à
l'intérieur du fichier csv ne sont pas retirés du périphérique)
Dossier source
l
Interne = \Flash\QTHMI\workspace\Dump
l
Clé USB = \USBMemory
l
Carte SD = \Storage Card
l
Réseau public = \\<nom d'hôte ou IP>\sharePath
l
Réseau privé = \\<nom d’utilisateur>:<mot de passe>@<nom d'hôte ou
IP>\<partage>/<chemin>
Note : les formats supportés pour la mémoire externe sont FAT ou FAT32 (le format NTFS
n'est pas pris en charge).
Note : Les réseaux privés sont supportés uniquement par les périphériques Linux avec BSP
à partir de la version 1.0.25.
FileName
Variable associée dans laquelle sera lu le nom de fichier dans l'exécution.
BrowseForFile vrai = affiche le dialogue Ouvrir permettant de rechercher le fichier que vous souhaitez lire.
faux = aucun dialogue ne s'affiche,
AjouterEnsembleDonnéesRecette
Ajoute un nouvel ensemble de données recette à la recette sélectionnée. Le nouvel ensemble de données est ajouté à la fin
des ensembles de données définis précédemment.
120
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Paramètre
Description
RecipeName
Recette à laquelle l'ensemble de données sera ajouté.
CopierDe
Ensemble de données duquel seront reprises les valeurs de paramètres pour initialiser le
nouvel ensemble de données
NouveauNomEnsemble Nom d'un nouvel ensemble de données.
Il est possible d'indiquer une référence de variable pour cette valeur.
SupprEnsembleDonnéesRecette
Supprime un ensemble de données de la recette sélectionnée. En supprimant un ensemble de données, vous modifiez
également les numéros de positions des ensembles de données qui le suivent.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
121
Actions client à distance
Paramètre
Description
RecipeName
Recette dans laquelle l'ensemble de données sera supprimé.
EnsembleDonnées
Ensemble de données à supprimer.
Actions client à distance
Utilisé pour le chargement et le téléchargement de fichiers du et vers un périphérique IHM distant. Ces actions peuvent être
exécutées uniquement à partir d'un AGI Client distant pour accéder à des fichiers distants via FTP.
Important : Activez la prise en charge du FTP et attribuez tous les droits d'utilisateurs aux dossiers
utilisés pour le transfert des fichiers.
ChargerSurIHM
Appelle un dialogue Ouvrir qui permet de sélectionner un fichier à charger sur le périphérique IHM distant.
Paramètre
Description
Destination
Chemin de destination pour le fichier à charger sur le périphérique IHM
Filtrer
Extensions de fichier des fichiers à afficher, séparées par des virgules (par ex., *.txt)
TéléchargerdIHM
Appelle un dialogue Ouvrir qui permet de sélectionner un fichier à télécharger du périphérique IHM distant.
Note : Seuls les fichiers qui correspondent au filtre configuré sont affichés pour téléchargement.
Paramètre
Description
Source
Chemin source du fichier à télécharger du périphérique IHM
Filtrer
Extensions de fichier des fichiers à afficher, séparées par des virgules (par ex., *.txt)
Interface JavaScript
boolean project.uploadToHMI(dirPath, strFilter);
boolean project.downloadFromHMI(dirPath, strFilter);
Paramètre
Description
dirPath
Chemin source du fichier à charger/télécharger du périphérique IHM
strFilter
Extensions de fichier des fichiers à afficher, séparées par des virgules (par ex., *.txt)
Valeurs de retour :
122
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Vrai
Transfert terminé avec succès
Faux
Transfert échoué
Note : Une fois transférées, les variables système sont adaptées à l'état des opérations en cours.
Actions système
Permet de gérer les propriétés système.
Redémarrer
Redémarre le runtime.
ClichageTendance
Stocke les données historiques de tendances sur des lecteurs externes (clé USB ou carte SD).
Paramètre
Description
TrendName
Nom de la tendance historique à stocker
CheminDossier
Dossier de destination :
l
Interne = \Flash\QTHMI\workspace\Dump
l
Clé USB = \USBMemory
l
Carte SD = \Storage Card
l
Réseau public = \\<nom d'hôte ou IP>\sharePath
l
Réseau privé = \\<nom d’utilisateur>:<mot de passe>@<nom d'hôte ou
IP>\<partage>/<chemin>
Note : les formats supportés pour la mémoire externe sont FAT ou FAT32 (le
format NTFS n'est pas pris en charge).
Note : Les réseaux privés sont supportés uniquement par les périphériques Linux
avec BSP à partir de la version 1.0.25.
FormatFichier
Binaire = la mémoire tampon est enregistrée sous forme de cliché binaire (fichiers .dat et
.inf). Les deux fichiers sont requis ultérieurement pour convertir les données au format .csv
à l'aide d'un utilitaire externe.
Compatibilité CSV = la mémoire tampon est enregistrée dans un emplacement donné au
format de fichier cliché .csv compatible avec les versions 1.xx
CSV compact = la mémoire tampon est enregistrée dans un emplacement donné dans un
fichier .csv à format plus récent
Voir "Exporter les données de mémoire de tendance" on page 177
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
123
Actions système
Paramètre
Description
DateTimePrefixFileName vrai = un préfixe composé de la date et de l'heure sera ajouté au fichier cliché (par exemple
D2012_01_01_H10_10_Tendance1.csv)
timeSpec
Format de l'heure :
l
l
FileName
Locale = les valeurs de temps exportées correspondent à l'heure du périphérique
IHM.
Globale = les valeurs de temps sont exportées au format UTC.
Activé lorsque le NomFichierPréfixeDateHeure = vrai
Les métacaractères ci-dessous sont pris en charge
l
%n = nom de tendance
l
%y = année
l
%M = mois
l
%d = jour
l
%h = heure
l
%m = minutes
l
%s = secondes
Exemple : \%n\%y%M%d\%h%m%s
Note : l'exécution de l'action ClichageTendance forcera automatiquement le vidage vers le disque des données
temporaires conservées dans la mémoire RAM. Voir "Tendances historiques" on page 180 pour plus de détails
sur l'enregistrement de données échantillonnées sur le disque.
Note : les lecteurs externes connectés au port USB doivent être au format FAT ou FAT32. Le format NTFS n'est
pas pris en charge.
AVERTISSEMENT : Tenez compte du fait qu'il existe des limites pour le nombre maximal de fichiers
qui peuvent être créés dans un dossier. Ces limites dépendent de différents facteurs et leur calcul est
complexe mais vous pouvez partir d'un maximum de 999 fichiers qui peuvent être utilisés dans un
dossier.
Conversion des fichiers clichés binaires au format .csv
L'outil TrendBufferReader.exe se trouve dans le dossier Outils du dossier d'installation AGI Creator.
Utilisez la syntaxe suivante :
TrendBufferReader -r Trend1 Trend1.csv 1
où :
Trend1 = nom de la mémoire des tendances sans extension générée à partir du cliché (le nom du fichier d'origine étant
trend1.dat)
Trend1.csv = nom du fichier de sortie.
Structure du fichier .csv
Le fichier .csv généré se présente à cinq colonnes
124
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Colonne
Description
Type de données
Type de données de la variable échantillonnée :
0 = empty
1 = boolean
2 = byte
3 = short
4 = int
5 = unsignedByte
6 = unsignedShort
7 = unsignedInt
8 = float
9 = double
Valeur
Valeur de l'échantillon
Timestamp(UTC)
Horodatage au format UTC
Temps
Intervalle entre les prises d'échantillons en millisecondes
d'échantillonnage
(ms)
Qualité
Qualité valeur de variable. Les informations codées selon le standard de l'accès aux données OPC
et stockées sous forme de données d'octets (8 bits) sont définies sous forme de trois champs de
bits : qualité, sous-état et état des limites.
Les huit bits de qualité sont alignés dans l'ordre suivant : QQSSSSLL. Pour des descriptions
complètes et détaillées de tous les champs individuels, veuillez consulter la documentation
officielle d'accès standard OPC.
Valeurs de qualité régulièrement utilisées
Les valeurs le plus fréquemment utilisées retournées par l'appareil d'acquisition de l'IHM sont les suivantes :
Code de
qualité
Qualité
Description
0
MAUVAISE
La valeur est mauvaise mais aucune raison particulière n'est indiquée
4
MAUVAISE
Problème de serveur particulier avec la configuration. Par exemple, la variable
a été supprimée du fichier de configuration (tags.xml).
8
MAUVAISE
Éventuellement, cette fois-ci, aucune valeur n'est disponible, par exemple, la
valeur n'a pas été fournie par la source de données.
12
MAUVAISE
Défaillance de périphérique détectée
16
MAUVAISE
Délai d'attente dépassé avant la réponse du périphérique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
125
Actions système
Code de
qualité
Qualité
Description
24
MAUVAISE
Échec de communication
28
MAUVAISE
Aucune donnée trouvée pour le drapeau spécifique des valeurs de limite
inférieures et supérieures de l'interface des tendances.
32
MAUVAISE
Aucune donnée collectée (par exemple, l'archivage n'est pas actif.
Drapeau spécifique de l'interface tendances.
Cette valeur est également utilisée pour indiquer un état hors ligne temporaire
(pour toute condition où l'échantillonnage a été arrêté).
64
INCERTAINE Aucune raison spécifique.
65
INCERTAINE Aucune raison spécifique.
La valeur s'est accrochée à une limite inférieure.
66
INCERTAINE Aucune raison spécifique.
La valeur s'est accrochée à une limite supérieure.
67
INCERTAINE Aucune raison spécifique.
La valeur est constante et ne peut pas varier.
84
INCERTAINE La valeur retournée se situe en-dehors des limites définies.
Dans ce cas, le champ Limites indique la limite qui a été dépassée mais la
valeur peut dépasser cette plage.
85
INCERTAINE La valeur retournée se situe en-dehors des limites définies.
Dans ce cas, le champ Limites indique la limite qui a été dépassée mais la
valeur peut dépasser cette plage.
La valeur s'est accrochée à une limite inférieure.
86
INCERTAINE La valeur retournée se situe en-dehors des limites définies.
Dans ce cas, le champ Limites indique la limite qui a été dépassée mais la
valeur peut dépasser cette plage.
La valeur s'est accrochée à une limite supérieure
87
INCERTAINE La valeur retournée se situe en-dehors des limites définies.
Dans ce cas, le champ Limites indique la limite qui a été dépassée mais la
valeur peut dépasser cette plage.
La valeur est constante et ne peut pas varier.
192
BONNE
-
SupprimerTendance
Supprime les données de tendance enregistrées.
126
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Définissez le nom de la tendance de laquelle vous souhaitez supprimer les journaux.
ViderArchiveÉvénements
Stocke un journal d’alarmes historique et des données de journal d’audit sur des lecteurs externes, tels qu'une mémoire
USB ou une carte SD.
Paramètre
Description
ArchiveÉvénements
Nom de la mémoire tampon dans laquelle enregistrer les données de clichage
CheminDossier
Dossier de destination
l
Interne = \Flash\QTHMI\workspace\Dump
l
Clé USB = \USBMemory
l
Carte SD = \Storage Card
l
Réseau public = \\<nom d'hôte ou IP>\sharePath
l
Réseau privé = \\<nom d’utilisateur>:<mot de passe>@<nom d'hôte ou
IP>\<partage>/<chemin>
Note : les formats supportés pour la mémoire externe sont FAT ou
FAT32 (le format NTFS n'est pas pris en charge).
Note : Les réseaux privés sont supportés uniquement par les
périphériques Linux avec BSP à partir de la version 1.0.25.
ClichageFichierConfig Vider les fichiers description des archives
DumpAsCSV
vrai = la mémoire tampon est enregistrée dans un emplacement donné dans un
fichier cliché .csv à format plus récent
faux = la mémoire tampon est enregistrée sous forme de cliché binaire (fichiers
.dat et .inf). Les deux fichiers sont requis ultérieurement pour convertir les
données au format .csv à l'aide d'un utilitaire externe.
DateTimePrefix
vrai = un préfixe composé de la date et de l'heure sera ajouté au fichier cliché (par
exemple D2012_01_01_H10_10_MémoireAlarme1.csv)
timeSpec
Format de l'heure :
l
l
Colonnes csv
Locale = les valeurs de temps exportées correspondent à l'heure du
périphérique IHM.
Globale = les valeurs de temps sont exportées au format UTC.
Sélectionner les colonnes à vider dans le fichier .csv.
Disponible uniquement lorsque le EventArchive est une mémoire
tampon d'alarmes
FileName
Les métacaractères ci-dessous sont pris en charge
l
%n = nom d'archive d'événements
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
127
Actions système
Paramètre
Description
l
%y = année
l
%M = mois
l
%d = jour
l
%h = heure
l
%m = minutes
l
%s = secondes
Exemple : \%n\%y%M%d\%h%m%s
Disponible uniquement lorsque DateTimePrefixFileName=true
Langue
Sélectionner la langue à utiliser. Lorsque vide, le déchargement exécutera sur
toutes les langues.
Disponible uniquement lorsque le EventArchive est une mémoire
tampon d'alarmes
Exemple
En exportant les mémoire d'événements au format binaire et lorsque le paramètre ClichageFichierConfig est configuré
sur vrai (paramètres recommandés), il y a deux dossiers :
l
data, contenant les fichiers de données,
l
config, contenant les fichiers de configuration pour la conversion au format .csv.
Une fois les deux dossiers copiés du lecteur USB sur le disque de l'ordinateur, la structure des dossiers sera la suivante :
\config\
alarms.xml
eventconfig.xml
\data\
AlarmBuffer1.dat
AlarmBuffer1.inf
\
AlarmBufferReader.exe
Conversion des fichiers clichés au format .csv
L'outil AlarmBufferReader.exe se trouve dans le dossier Utilitaires du dossier d'installation AGI Creator.
Utilisez la syntaxe suivante :
AlarmBufferReader AlarmBuffer1 FICHIER ./AlarmBuffer1.csv
où :
AlarmBuffer1 = nom du fichier cliché .dat sans extension
128
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
AlarmBuffer1.csv = nom du fichier de sortie.
L'utilitaire AuditTrailBufferReader.exe est disponibles pour les mémoires tampon des journaux d'audit.
Note : configurez le paramètre ClichageFichierConfig sur vrai.
Le résultat du clichage est une structure de dossier similaire a celle créée pour les événements.
Utilisez la syntaxe suivante :
AuditTrailBufferReader AuditTrail FICHIER./AuditTrail.csv
où :
AuditTrail1= nom de la mémoire vidée sans extension et
AuditTrail1.csv = nom du fichier de sortie.
Colonnes csv
Note : disponible uniquement pour les mémoires d'alarmes.
Pour les mémoires d'alarmes, il est possible d'inclure des colonnes supplémentaires dans le fichier cliché .csv.
SupprimerArchiveÉvénements
Supprime les données de journal des mémoire d'événements enregistrées.
Indiquez le nom de la mémoire d'événements pour la supprimer des journaux d'événements.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
129
Actions de variable
RéinitialiserCompteurErrProto
Réinitialise la variable de système Protocol Error Count.
Voir "Variables système" on page 85 pour plus de détails.
RetirerMédiaEnTouteSécurité
Permet de retirer la carte SD ou le lecteur USB en toute sécurité de l'IHM.
ControlUserLED
Configure le comportement de la LED pour l'utilisateur.
Ce n’est pas disponible sur les plateformes Linux (consultez "Capacités des périphériques IHM." on page 431
pour plus de détails sur les panneaux)
Actions de variable
Permet d'interagir avec les variables.
TransfertDonnées
Transmet des données entre :
l
deux contrôleurs,
l
registres d'un contrôleur,
l
des variables systèmes aux contrôleurs,
l
des contrôleurs aux variables système
Les divers types de variables incluent une variable de contrôleur, une variable système, une variable de recette et une
propriété de widget.
BasculerBit
Fait basculer une valeur de bit d'une variable.
130
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
L'IndexBits vous permet de sélectionner le bit à faire basculer : le basculement requiert une opération de lecturemodification-écriture ; la valeur de lecture est inversée et puis réécrite dans la variable.
ConfigurerBit
Configure le bit sélectionné sur « 1 ».
L'IndexBits vous permet de sélectionner la position du bit à l'intérieur de la variable.
ResetBit
Réinitialise le bit sélectionné sur « 0 »
L'IndexBits vous permet de sélectionner la position du bit à l'intérieur de la variable.
WriteTag
Écrit des valeurs constantes dans la mémoire du contrôleur. Indiquez le nom et la valeur de la variable.
Pasvariable
Augmente ou diminue la valeur de variable d'un pas.
Paramètre
Description
Nomvariable
Nom de la variable à augmenter/diminuer
Pas
Valeur de pas
Ne pas faire de pas au-dessus de la limite
Active la limite de pas
Limite de pas
Valeur de la limite de pas, si activée.
ActiverGroupe
Force la mise à jour d'un groupe de variables.
Les variables sont mises à jour lorsqu'elles sont utilisées dans la page actuelle ou en continu si elles ont été définies
comme actives dans l'éditeur de variables. Cette action force la mise à jour en continu des variables d'un groupe.
DésactiverGroupe
Désactive un groupe de variables, c'est-à-dire la mise à jour d'un groupe de variables n'est plus forcée.
ActiverNœud
Active/désactive une action pour une gestion de nœud hors ligne. Aucune communication n'est effectuée lorsque le nœud
est désactivé.
Paramètre
Description
ID de protocole
Identificateur unique du protocole sélectionné
IDNœud
Identificateur de nœud dans un protocole sélectionné. Peut être associé à une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
131
Actions de tendance
Paramètre
Description
Activer
État de communication de nœud :
Faux = désactivé
Vrai = activé
Lorsque le nœud est associé à une variable, variable = 0 signifie Faux
ViderMémoireNonVolatile
Configuration sur 0 déclenche l'effacement du contenu de la mémoire rémanente.
ForcerLecturevariable
Force le rafraîchissement de la variable indiquée à partir d'un contrôleur distant.
Actions de tendance
Utilisées pour les Tendances de données actives et le Widget de tendances historiques.
RafraîchirTendance
Rafraîchit la fenêtre Tendance.
Cette action peut être utilisée dans tous les widgets de Tendances/Graphiques. Indiquez le widget en tant que paramètre
de l'action.
DéfilementGaucheTendance
Fait défiler la fenêtre Tendance vers la gauche à un pas d'un dixième (1/10) de la durée de page.
Note : pour les tendances en temps réel, mettez en pause la tendance à l'aide de l'action
MettreTendanceEnPause, sinon la fenêtre sera ramenée en continu à la valeur actuelle.
DéfilementDroitTendance
Fait défiler la fenêtre Tendance vers la droite à un pas d'un dixième (1/10) de la durée de page.
Note : pour les tendances en temps réel, mettez en pause la tendance à l'aide de l'action
MettreTendanceEnPause, sinon la fenêtre sera ramenée en continu à la valeur actuelle.
PageGaucheTendance
Permet de faire sauter la fenêtre Tendance d'une page. Par exemple, si la taille de la page correspond à 10 minutes, vous
pouvez utiliser l'action PageGaucheTendance pour faire avancer la tendance vers la gauche de 10 minutes.
PageDroiteTendance
Permet de faire sauter la fenêtre Tendance d'une page. Par exemple, si la taille de la page correspond à 10 minutes, vous
pouvez utiliser l'action PageGaucheTendance pour faire avancer la tendance vers la droite de 10 minutes.
132
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
DuréePageTendance
Configure la durée de la page de la fenêtre Tendance.
Définir le nom et la durée de page de la tendance.
Note : vous pouvez configurer la durée de la page dans l'exécution en utilisant le widget de liste déroulante.
ZommerTendance
Réduit la durée de page.
DézoomerTendance
Agrandit la durée de page.
RéinitialiserZoomTendance
Réinitialise le niveau de zoom au niveau de zoom d'origine.
ZoomInYAxisTrend
Réduit l'axe Y.
ZoomOutYAxisTrend
Étend l'axe Y.
ZoomResetYAxisTrend
Réinitialise le niveau de zoom de l’axe Y au niveau de zoom d'origine.
MettreTendanceEnPause
Arrête le traçage des courbes de tendance dans la fenêtre Tendance.
Lorsque cette action est utilisée pour une tendance en temps réel, le traçage s'arrête une fois que la courbe a atteint le bord
droit du graphique. Cette action ne met pas fin à l'enregistrement de journaux de tendances.
Reprise tendance
Reprend le traçage de la tendance après une pause.
AfficherCurseurTendance
Affiche la valeur de la courbe pour un point donné sur l'axe X.
Active le curseur des tendances. Un curseur (ligne verticale) s'affichera dans le widget de tendance.
Lors de l'activation du curseur graphique, le défilement de la tendance s'arrête.
L'action FaireDéfilerCurseur permet de déplacer le curseur graphique au-dessus des courbes ou au-dessus de toute la
fenêtre de Tendance.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
133
Actions de tendance
ScrollTrendCursor
Fait défiler le curseur de tendance vers l'avant ou vers l'arrière.
La valeur du curseur Y affichera la valeur de la tendance située sous la pointe du curseur. Le pourcentage de défilement
peut être configuré à 1% ou 10%. Le pourcentage est calculé en fonction de la durée de la fenêtre de tendance.
ScrollTrendToTime
Fait défiler la fenêtre Tendance à un moment donné dans le temps.
Utilisez cette action lorsque vous souhaitez faire défiler la fenêtre de tendance jusqu'à une position spécifique dès qu'un
événement spécifique survient.
Exemple
1. Configurez une action pour un événement (par exemple, une alarme) qui exécute un transfert de données de l'heure
système vers une variable.
2. Sélectionner cette variable en tant que paramètre ScrollTrendtoTime : les fenêtres de tendance seront centrées
dès le déclenchement de l'événement.
ConsumptionMeterPageScroll
Permet de faire défiler le widget du compteur de consommation d'une page vers la gauche ou vers la droite.
Paramètre
Description
Nom de tendance
ID de widget de tendance (par exemple, FenêtreTendances3)
Direction de défilement page
Direction du défilement de la page (Avant/Arrière)
134
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
Actions de gestion des utilisateurs
Paramètres de gestion des utilisateurs et de sécurité.
Déconnexion
Déconnecte l'utilisateur actuel. L'utilisateur par défaut est connecté automatiquement. Si aucun utilisateur par défaut n'a
été configuré, la fenêtre de connexion s'affiche.
ChangerUtilisateur
Alterne entre deux utilisateurs sans déconnecter l'utilisateur connecté : le dialogue de connexion utilisateur s'affiche.
L'utilisateur peut cliquer sur Retour pour retourner à l'utilisateur connecté précédemment.
Le serveur continue de fonctionner avec l'utilisateur connecté précédemment jusqu'à ce que l'utilisateur suivant se
connecte. Un utilisateur reste toujours connecté au système.
ModifierMotdePasse
Modifie le mot de passe de l'utilisateur actuel : un dialogue s'affiche
Aucun paramètre requis.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
135
Actions de gestion des utilisateurs
RéinitialiserMotdePasse
Restaure le mot de passe d'origine avec les paramètres spécifiés dans le projet pour l'utilisateur actuel.
Aucun paramètre requis.
AjouterUtilisateur
Réservée aux utilisateurs pour lesquels la propriété Gestion des autres utilisateurs possible a été sélectionnée.
Ajoute un utilisateur dans l'exécution : un dialogue s'affiche.
SupprimerUtilisateur
Réservée aux utilisateurs pour lesquels la propriété Gestion des autres utilisateurs possible a été sélectionnée.
Supprime un utilisateur dans l'exécution : un dialogue s'affiche.
Aucun paramètre requis.
ÉditerUtilisateurs
Réservée aux utilisateurs pour lesquels la propriété Gestion des autres utilisateurs possible a été sélectionnée.
Permet d'éditer les paramètres des utilisateurs.
136
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
SupprimerFichierDynamiqueGU
Supprime le fichier dynamique de gestion des utilisateurs. Les modifications apportées aux paramètres des utilisateurs
dans l'exécution sont supprimées. Les paramètres d'origine sont restaurés à partir des informations de projet.
Aucun paramètre requis.
ExporterUtilisateurs
Exporte les paramètres des utilisateurs dans un fichier .xml (usermgnt_user.xml) crypté qui permet la restauration le cas
échéant.
Configurez le fichier de destination pour le fichier à exporter.
Important : Le fichier d'utilisateur est crypté et ne peut pas être édité.
Note : les formats pris en charge sont FAT ou FAT32. Le format NTFS n'est pas pris en charge.
ImporterUtilisateurs
Importe les paramètres des utilisateurs à partir d'un fichier d'exportation .xml précédemment enregistré (usermgnt_
user.xml).
Configurez le fichier source pour le fichier à importer.
Note : les formats pris en charge sont FAT ou FAT32. Le format NTFS n'est pas pris en charge.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
137
Actions widget
Actions widget
AfficherWidget
Affiche ou masque les widgets de la page.
Propriété
Description
Widget
Widget à afficher/masquer
GlisserWidget
Affiche l'effet de glissement d'un widget ou d'un groupe de widgets.
Note : Le widget ou les widgets groupés peuvent se situer en-dehors de la partie visible de la page du projet et
glisser pour s'afficher et être masqués.
Propriété
Description
Widget
Widget à faire glisser
Direction
Direction de glissement
Vitesse
Vitesse de transition du widget glissant
Distance X
Distance parcourue par la coordonnée X en pixels
Distance Y
Distance parcourue par la coordonnée Y en pixels
Limite de défilement
Activer/désactiver les limites de mouvement du widget par rapport aux coordonnées x et y
Limite X
Position de limite de l'action de glissement par rapport à la coordonnée x
Limite Y
Position de limite de l'action de glissement par rapport à la coordonnée y
Activer visibilité
Affiche/masque le widget après chaque action de glissement
Widget d'images
Image affichée pendant l'action de glissement
CommencerEntréeDonnées
Affiche un clavier et démarre l'entrée de données dans un champ de données sans toucher le widget même. Cette action
permet d'activer l'entrée de données à l'aide d'un scanner code-barres.
Interface Java Script
project.beginDataEntry(wgtName [, pageName])
Paramètre
Description
wgtNameWidget Nom de widget
pageName
138
Active la page pour l'entrée de données. Paramètre optionnel. Utile pour sélectionner un champ de
données dans une boîte de dialogue non-modale active.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
11 Actions
TriggerIPCamera
Capture une image à l'aide d'une caméra IP. Fonctionne uniquement avec les pages qui contiennent un widget de caméra
IP.
DéplacerCaméraIP
Envoie des commandes à distance à une caméra qui les prend en charge. Voir "Widgets caméra IP" on page 285 pour plus
de détails. Assurez-vous que la caméra IP prend en charge les commandes de mouvement.
RafraîchirÉvénement
Rafraîchit la mémoire d'événements pour le widget de l'Historique d'alarmes. Voir "Widget historique des alarmes" on
page 163 pour plus de détails.
MenuContextuel
Affiche le menu contextuel.
Si la propriété Menu contextuel du Widget de projet a été configurée sur Temporisation, le menu contextuel peut sembler
toucher l'arrière-plan de l'écran pendant quelques secondes. Voir "Volet des propriétés de projet" on page 60
ReplaceMedia
Remplace les fichiers média existants avec de nouveaux fichiers stockés sur une clé USB / une carte SD. Peut être utilisé
pour remplacer les fichiers vidéo des widgets LecteurMédias ou des images du projet.
Note : Les nouveaux fichiers médias doivent être au même nom et au même format que les fichiers à remplacer.
Paramètre
Description
Media Type
Type du fichier à mettre à jour
Périphérique Périphérique sur lequel les nouveaux fichiers médias sont fournis
sourcePath
Fichier où sont stockés les nouveaux fichiers médias (par exemple "\\USBMemory")
Image
Resize
Ajuste les nouvelles images pour qu'elles aient les mêmes dimensions que les images qu'elles
remplacent. Non applicable aux fichiers vidéo.
Silent
Remplace les médias automatiquement. Par défaut, un dialogue s'affiche qui demande à l'utilisateur
d'indiquer l'emplacement du fichier.
Interface Java Script
void replaceMedia(var sourcePath, var bSilent, var Device, var nMediaType, var
bResize)
project.replaceMedia("Images", true, "\USBMemory", 1, true);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
139
Actions widget
140
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
12
Utiliser l’application client
AGI Client est une application autonome qui fournit un accès à distance à HMI Runtime, et est inclus dans AGI SW Pack.
AGI Client utilise le même système de rendu graphique que le runtime dans les périphériques IHM, il repose sur HMI
Runtime spécifique en tant que serveur pour les données en direct.
Pour exécuter l’application AGI Client :
1. Depuis le menu Start > AGI SW Pack >AGI Client : le client ouvre dans une fenêtre style navigateur.
2. Taper l'adresse IP du serveur/périphérique dans la barre d’adresse (par exemple : http://192.168.1.12) : AGI Client
se connectera au serveur et la même exécution d’application graphique que sur le périphérique sera chargée dans la
fenêtre du client.
AGI Client agit comme un client à distance et communique avec le serveur, en partageant la visualisation locale avec les
valeurs de variable qui sont maintenues ou mises à jour par le protocole de communication.
Les projets IHM contiennent des propriétés indiquant quelle page est actuellement affichée sur l’IHM et peut forcer l’IHM
pour passer à une page spécifique. Vous pouvez utiliser ces propriétés pour synchroniser les pages indiquées sur le
périphérique IHM et AGI Client ou pour commander un périphérique IHM avec un API.
Voir "Comportement" on page 66 pour plus de détails.
La barre d'outils de l’application client
142
Espace de travail
142
Paramètres et options de fuseau horaire
142
Transférer des fichiers à un périphérique IHM distant
143
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
141
La barre d'outils de l’application client
La barre d'outils de l’application client
Élément
Description
Adresse de serveur IHM.
Adresse de périphérique IHM.
État de la connexion
État de la demande de réseau. Rouge lors de l’échange de données.
Recharger à partir du cache
Recharger projet
Marque-page
Marquer les pages préférées et les recharger.
Paramétrages
Ouvrir la boîte de dialogue des réglages
Options de rechargement
Option
Description
F5
Recharge le projet depuis le cache
Shift + F5
Télécharge le projet sur le client
Espace de travail
Les fichiers du projet sont chargés depuis le dispositif et stockées dans AGI Client dans le dossier cache suivant.
%appdata%\DEIF A/S\[build number]\client\cache
où :
[build number] = dossier nommé en tant que numéro de fabrication, par exemple 01.90.00.608.
Paramètres et options de fuseau horaire
Dans la boîte de dialogue Réglages, vous pouvez configurer les paramètres du client et décider comment afficher les
informations d'horodatage du projet.
Paramètres HTTP
Paramètre
Description
Protocoles
Le protocole de communication utilisé par AGI Client pour communiquer avec un périphérique IHM.
Fréquence
de mise à
jour
La fréquence de scrutation pour synchroniser les données depuis le serveur. Par défaut = 1 s.
142
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
12 Utiliser l’application client
Paramètre
Description
Délai
d'attente
Temps d'attente maximum avant qu'une demande est répétée par le AGI Client. Par défaut = 5 s.
Réutiliser
connexion
Permet la réutilisation de la même connexion TCP pour plusieurs requêtes HTTP pour réduire le trafic
réseau.
Note : Lorsqu'elle est activée, cette option peut entraîner une latence élevée si le serveur
proxy ne met pas fin immédiatement aux anciennes demandes saturant ainsi les prises de
connexion. C’est souvent le cas avec les connexions 3G.
Activer la
Compresse les données afin de réduire le temps de téléchargement. Par défaut = désactivé.
compression
ATTENTION : activer cette option pourrait provoquer une surcharge excessive du
processeur.
Paramètres
de temps
Utilisé par le client pour adapter les informations d'horodatage des widgets.
Paramètres FTP
Paramètre
Description
Port
Port communication FTP
Paramètres de temps
Paramètre
Description
Utiliser widgets
par défaut
Affiche des informations de temps en fonction des paramètres du widget.
Heure locale
Traduit tous les horodatages du projet dans l'heure locale de l’ordinateur, où le client est
installé.
Heure globale
Traduit tous les horodatages du projet au format UTC
Heure du
serveur
Traduit tous les horodatages du projet dans le même projet utilisé par le
périphérique/serveur IHM afin d'afficher dans le même temps.
Important : Assurez-vous de définir la zone de l’heure correcte IHM RTC et les options DST.
Transférer des fichiers à un périphérique IHM distant
Vous pouvez charger et télécharger des fichiers du et vers un périphérique IHM distant en utilisant deux actions dédiées.
Ces actions peuvent être exécutées uniquement à partir d'un AGI Client distant et accéder à des fichiers distants via FTP.
Important : Activez la prise en charge du FTP et attribuez tous les droits d'utilisateurs aux dossiers
utilisés pour le transfert des fichiers.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
143
Transférer des fichiers à un périphérique IHM distant
Voir "Actions client à distance" on page 122
Voir "Variables client à distance" on page 94
144
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
13
Utiliser le serveur FTP intégré
HMI Runtime le système utilise un serveur FTP intégré.
Se connecter au serveur FTP du périphérique IHM en utilisant n’importe quelle application client FTP standard. Le serveur
FTP répond sur le port 21 standard par défaut.
Important : Le serveur ne prend en charge qu'une seule connexion à la fois ; si vous utilisez un client
FTP à connexion multiple, désactivez cette fonction sur le programme client ou définissez le nombre
maximal de connexions par session sur 1.
Paramètres FTP
Identifiants par défaut FTP
Lorsque la gestion/sécurité de l’utilisateur est désactivée, utiliser les identifiants suivants pour les connexions entrantes :
Identifiant
admin
Mot de passe
admin
Modifier les paramètres FTP
Chemin : VueProjet> Sécurité> GroupesUtilisateurs > Paramètres autorisation
Vous pouvez modifier les autorisations FTP et les informations de compte dans l'onglet Ftp de la boîte de dialogue des
autorisations Administrateur.
Voir "Configurer groupes et autorisations" on page 219 pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
145
Paramètres FTP
146
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
14
Utiliser VNC pour accès à distance
VNC est un logiciel de contrôle à distance qui vous permet de voir et de contrôler l'application IHM à distance en utilisant
votre souris et votre clavier.
L'accès à distance est particulièrement utile pour l'administration et le support technique. Pour l'utiliser, vous devez :
l
démarrer un serveur dans le périphérique IHM
l
installer un afficheur sur le périphérique à distance
Démarrage du serveur VNC sur les périphériques WinCE
148
Démarrage du serveur VNC sur les périphériques Linux
149
Démarrer l’afficheur VNC
150
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
147
Démarrage du serveur VNC sur les périphériques WinCE
Démarrage du serveur VNC sur les périphériques
WinCE
Le serveur VNC est un plug-in. Il peut être activé et téléchargé en tant que runtime. "Modules de plug-in de logiciels" on
page 66.
Installer le serveur VNC
Chemin : ProjectView > Propriétés du projet
1. Sur le panneau Propriété, définir le Serveur VNC en vrai pour activer le plug-in.
2. Installer ou mettre à jour le runtime pour ajouter le serveur VNC.
Démarrage/arrêt du serveur VNC
Le serveur VNC se trouve dans le dossier \Flash\qthmi\VNC et est activé en utilisant l’action launchVNC. Si activé à partir
des propriétés du projet, il peut également être activé à partir du menu contextuel de runtime Outils de développement>
Lancement VNC.
Pour activer le menu contextuel d'activation, voir "Propriétés de projet" on page 59
La boîte de dialogue Options VNC
Depuis la boîte de dialogue Options VNC, il est possible d’exécuter plusieurs tâches.
Onglet
Fonctions
Commande
Démarrer/arrêter le serveur VNC et connecter l'afficheur
Options
Définir les informations de sécurité pour l'accès au serveur en utilisant un afficheur VNC
148
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
14 Utiliser VNC pour accès à distance
Onglet
Fonctions
Paramètres
avancés
Activer l'activation automatique du serveur VNC au démarrage du périphérique IHM.
Sélectionner Démarrage silencieux pour garder la boîte de dialogue des Options VNC en
arrière-plan lorsque l’Autodémarrage est activé.
Activer Affichage de l’icône de la barre des tâches en déboguant le mode KIOSK.
Out
Contient les paramètres de configuration pour une connexion sortante à un logiciel d'affichage VNC
d’écoute.
Important : Les paramètres dans l'onglet Avancé sont réservées aux utilisateurs experts et devraient
être modifiées lorsque le serveur VNC est utilisé en conjonction avec un répéteur VNC pour surmonter
les problèmes de pare-feu ou optimiser les performances VNC en fonction de la configuration du
réseau.
Connexion à l'afficheur
De nombreux afficheurs VNC modernes offrent la possibilité de lancer le logiciel en mode écoute. La raison est que, la
plupart du temps les périphériques mobiles n’ont pas une adresse IP publique de référence. Il est donc possible d'avoir une
adresse IP publique sur un ordinateur de bureau qui exécute un afficheur VNC d’écoute. Un utilisateur peut alors facilement
appeler pour un support en appuyant sur le bouton Connexion à Afficheur sur l'onglet Commande.
Paramètres VNC par défaut
Port TCP
5900
Mot de passe
null
Important : Le serveur VNC n’autorise qu’un seul client.
Démarrage du serveur VNC sur les périphériques Linux
Le serveur VNC est un service intégré à l'intérieur du BSP qui peut être activer à partir de l'onglet Services des paramètres
du système du périphérique. Voir "Paramètres du système" on page 384pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
149
Démarrer l’afficheur VNC
Démarrer l’afficheur VNC
Aucun afficheur VNC n’est fourni dans le cadre de AGI SW Pack.
De nombreux afficheurs VCN comptable sont disponibles en téléchargement gratuit (par exemple, TightVNC).
150
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15
Alarmes
Le système de gestion des alarmes a été conçu pour fournir des alertes par messages affichés dans une fenêtre
contextuelle, qui sont généralement des messages d'avertissement indiquant toute condition ou tout dysfonctionnement
anormal dans le système sous contrôle.
Un message s'affiche lorsqu'un bit change ou lorsque la valeur d'une variable dépasse un seuil fixé dans la configuration de
l'alarme. Vous pouvez également programmer des actions spécifiques qui doivent s'exécuter lorsqu'une alarme est
déclenchée.
Important : Aucune action par défaut n'est associée aux alarmes.
Vous pouvez définir le mode d'affichage d'une alarme sur le périphérique IHM, lorsque l'utilisateur doit la confirmer, ainsi
que le moment de l'enregistrement et le mode d'enregistrement dans la liste d'événements.
Les alarmes sont configurées dans l'Éditeur de configuration des alarmes et sont ainsi disponibles pour toutes les pages du
projet. Un widget d'alarme peut afficher plus d'une alarme à la fois, si elles sont redimensionnées de manière appropriée.
Vous pouvez déclencher l'ouverture ou la fermeture de la fenêtre de l'alarme avec un événement.
Vous travaillez avec les alarmes de la même manière qu'avec tout autre événement. Vous ne pouvez pas afficher de boîte
de dialogue lorsqu'une alarme est déclenchée et vous pouvez l'associer à toute autre action disponible.
Éditeur d'alarmes
152
Confirmer les alarmes à distance
154
Machine à états pour alarme
155
Configurer les événements
156
Widget alarmes actives
159
Widget historique des alarmes
163
Gestion des alarmes à l'exécution
163
Activer/désactiver les alarmes à l’exécution
163
Afficher les données d’alarme actives
164
Exporter la mémoire tampon des alarmes vers fichiers .csv
165
Exporter la configuration des alarmes
165
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
151
Éditeur d'alarmes
Éditeur d'alarmes
Chemin : VueProjet> Configuration > double-cliquez sur Alarmes
Ajouter une alarme
Cliquez sur + pour ajouter une alarme.
Paramètre
Description
Nom
Nom de l'alarme
Groupes
Groupes associés avec l'alarme. Ils peuvent être utilisés dans des filtres d'affichage des widgets.
Activer
Activer/désactiver le déclenchement de l'alarme.
Les alarmes peuvent également être activées ou désactivées en cours d'exécution (voir
"Activer/désactiver les alarmes à l’exécution" on page 163 pour plus de détails).
Conf
Active/désactive la confirmation de l'alarme. Si elle est sélectionnée, l'opérateur doit confirmer
l'alarme une fois déclenchée pour la supprimer du widget Alarme active.
Réinitialiser
Utilisé avec l'option Conf lorsqu'elle est sélectionnée, les alarmes confirmées restent dans la liste des
alarmes, étiquetées comme Conf non déclenchées, jusqu'à ce que l'opérateur appuie sur le bouton
Réinitialiser dans le widget de l'alarme.
Mémoire
tampon
Fichier tampon où l'historique des alarmes est enregistré.
Déclencheur
La condition de déclenchement dépend du type d'alarme :
l
l
152
limitAlarm : alarme déclenchée lorsque la valeur de variable dépasse ses limites. L'alarme
n'est pas déclenchée si la valeur atteint les limites.
valueAlarm alarme déclenchée lorsque la valeur de variable est égale à la valeur configurée
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Paramètre
Description
l
l
Variable
bitMaskAlarm : l'opérateur AND au niveau du bit compare chaque bit du masque de bits avec
la valeur de variable correspondant à cette Alarme. Si les deux bits sont activés, l'alarme est
configurée sur Vrai. Vous pouvez spécifier une ou plusieurs positions de bit (en commençant
par 0) dans la variable. La position du bit doit être donnée au format décimal. Si plusieurs bits
sont spécifiés, chaque position doit être séparée par une « , ».
deviationAlarm : alarme déclenchée si le pourcentage de déviation de la valeur de variable
depuis le point défini dépasse une déviation définie.
Variable dont la valeur déclenche l'alarme lorsqu'elle dépasse les limites définies.
L'alarme peut faire référence à la valeur de cette variable ou à l'état d'un bit lorsque bitMaskAlarm a
été sélectionné comme déclencheur.
Activer à
distance
Variable utilisée par l'API pour activer/désactiver l'alarme.
l
Changer l'état Activer du widget Alarmes change la valeur de variable
l
Lorsqu'une variable ne peut pas être lue (ex. erreur de communication), l'alarme est désactivée
l
Aucune variable correspondant à l'alarme n'est rafraîchie lorsque l'alarme est désactivée.
Astuce : Vous pouvez activer l'enregistrement du drapeau d'activation de l'alarme
Acquittement
à distance
Variable utilisée par l'API pour confirmer l'alarme. Une transition de cette variable de 0 à une valeur
différente de zéro est considérée comme une requête de confirmation.
Laisser vide lorsque l'acquittement à distance n'est pas requise.
Voir "Confirmer les alarmes à distance" on the next page pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
153
Confirmer les alarmes à distance
Paramètre
Description
Notification
Variable utilisée par le périphérique IHM pour notifier lorsque l'alarme est acquittée depuis le
d'acquittement périphérique ou depuis l'API.
0 = définir cette valeur lorsque l'alarme est déclenchée
1 = définir cette valeur lorsque l'alarme est acquittée.
Action
Actions exécutées lorsque l'alarme est déclenchée. Des conditions supplémentaires peuvent être
spécifiées dans la colonne Événements.
Voir "Configurer les événements" on page 156 pour plus de détails.
Action
utilisateur
Actions exécutées lorsque l'utilisateur appuie sur le bouton d'action dans le widget de l'alarme active.
Description
Description de l'alarme. Ce texte prend en charge les fonctionnalités multilangue et peut être une
combinaison de parties statiques et dynamiques, ces dernières incluant une ou plusieurs valeurs de
variable.
Voir "Widget alarmes actives" on page 159 pour plus de détails.
Voir "Afficher les données d’alarme actives" on page 164 pour plus de détails.
Couleur
Couleurs de premier plan et d'arrière-plan des lignes des alarmes, basées sur l'état de l'alarme.
AckBlink
Clignotement pour les alarmes déclenchées. Lorsque cette option est sélectionnée, les lignes de
l'alarme clignotent jusqu'à leur confirmation. Fonctionne uniquement lorsque Conf est sélectionné.
Sévérité
Sévérité de l'alarme. Si plusieurs alarmes sont déclenchées simultanément, les actions seront
exécutées selon les paramètres de sévérité.
0 = pas importante
1 = basse
2 = en dessous de la normale
3 = normale
4 = au-dessus de la normale
5 = élevée
6 = critique
Événements
Conditions de notification, d'enregistrement ou d'impression des alarmes.
Voir "Configurer les événements" on page 156 pour plus de détails.
Confirmer les alarmes à distance
Lorsque le paramètre Acquittement à distance est activé, une alarme peut être confirmée à partir d'un périphérique PLC
en introduisant une valeur de variable différente de zéro. L'état "confirmé" est notifié sur le périphérique PLC par le drapeau
Notification d'acquittement.
154
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Processus de confirmation des alarmes
La variable Acquittement à distance est réglée/réinitialisée par le PLC pour demander la confirmation, tandis que la
Notification d'acquittement est réglée/réinitialisée par le périphérique IHM pour notifier l'exécution de la confirmation.
1. Lorsqu'une condition d'alarme est détectée, le périphérique IHM règle Notification d'acquittement sur 0 et
l'ensemble des actions correspondantes sont exécutées.
2. Lorsque l'alarme est acquittée (par le périphérique IHM ou à distance), la Notification d'acquittement est réglée
sur 1
3. Il appartient au contrôleur de régler Acquittement à distance sur 1 pour confirmer l'alarme ou de la remettre sur 0
lorsque le périphérique IHM envoie une notification pour signaler que l'alarme a été confirmée (Confirmation de
notification = 1)
AVERTISSEMENT : Lorsqu'une alarme est déclenchée, certains signaux doivent être mis à
jour/communiqués via les périphériques connectés. La Confirmation est censée être un signal activé
par un opérateur, pas un signal déclenché automatiquement par un périphérique de contrôleur. Il faut
tenir compte du temps nécessaire à la communication des signaux d'origine.
Astuce : L'utilisation d'une même variable pour Acquittement à distance et Notification d'acquittement
permet de connecter plusieurs périphériques au même contrôleur et de confirmer les alarmes à partir de
n'importe quel périphérique IHM.
Machine à états pour alarme
Le runtime implémente la machine à états pour alarme décrite dans ce schéma.
Les états et les transitions entre états sont décrits selon les options sélectionnées et le comportement voulu.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
155
Configurer les événements
Configurer les événements
Chemin : VueProjet> Config > Alarmes > colonne Événements
Les événements sont définis à l'aide de l'éditeur Alarmes.
Voir "Éditeur d'alarmes" on page 152 pour plus de détails.
Notification des événements
Chemin : VueProjet> Config > Alarmes > colonne Événements > onglet Notification
Conditions de réglage dans lesquelles les alarmes seront affichées dans le widget d'alarme.
156
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Vous définissez ici le comportement du widget d'alarme par défaut disponible dans la galerie de widgets et décidez dans
quels cas le widget est mis à jour par un changement d'état d'alarme.
AVERTISSEMENT : Faire uniquement les ajustements requis par l'application spécifique tout en
laissant tous les autres paramètres par défaut.
Enregistrement des événements
Chemin : VueProjet> Config > Alarmes > colonne Événements > onglet Log
Conditions de réglage pour lequel vous voulez stocker l'événement spécifique dans un tampon d'historique des alarmes.
L'historique des alarmes est enregistré dans la mémoire d’événements.
Actions d’exécution
Chemin : VueProjet> Config > Alarmes > colonne Événements > onglet Actions
Conditions de réglage sous laquelle les/l'action(s), configuré pour l'alarme spécifique, doivent être exécutées.
Par défaut, les actions sont exécutées uniquement lorsque l'alarme est déclenchée ; d'autres états d'alarme peuvent
également être configurés pour exécuter des actions.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
157
Configurer les événements
Événements d'impression
Chemin : VueProjet> Config > Alarmes > colonne Événements > onglet Impression
Conditions de réglage pour lequel vous voulez imprimer l'événement spécifique
Réglage du périphérique de stockage
Chemin : VueProjet> Config > Mémoire Tamon événements> onglet Dispositif de stockage
1. Ouvrez la boîte de dialogue du périphérique de stockage.
2. Sélectionnez un périphérique de stockage de données d'événements.
Les données sont automatiquement enregistrées toutes les cinq minutes, sauf pour les données d'alarme qui sont
enregistrée immédiatement.
158
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Widget alarmes actives
Vous pouvez insérer le widget Alarmes actives dans une page pour afficher les alarmes et pour en prendre connaissance,
les réinitialiser ou les activer/désactiver.
Filtres d'alarme
Chemin : Widget Alarme active > volet Propriétés > Filtre
Définissez les filtres utilisés pour afficher uniquement certaines alarmes configurées. Les filtres sont basés sur des
champs d'alarme, vous pouvez donc filtrer les alarmes en fonction du nom, de la sévérité, de la description, etc.
Filtre 1 est le filtre par défaut. Il est géré avec la liste déroulante Filtre 1 et a deux options : Afficher toutes les alarmes et
Masquer les alarmes non déclenchées, cette option permettant d'afficher uniquement les alarmes actives.
Le filtre 2 n'est par défaut pas configuré et peut être personnalisé.
Les expressions du filtre utilisent le langage AWK, les expressions sont appliquées aux données contenues dans la
colonne Filtre sélectionnée du widget Alarme.
Paramétrer les filtres
Chemin : Widget Alarme active > volet Propriétés > Filtre
Pour définir un des deux filtres disponibles :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
159
Widget alarmes actives
1. Sélectionnez Filtre Colonne 1 et choisissez la valeur à filtrer (ex. : Nom, État, Temps, Groupes)
2. Dans Liaison de données, associez un widget à liste déroulante. Appuyez sur Maj + faites un clic gauche pour
sélectionner la liste déroulante.
3. Dans le volet Propriétés, sélectionnez la propriété dans la liste et ouvrez la boîte de dialogue pour personnaliser les
valeurs de la liste déroulante
4. Dans la boîte de dialogue de configuration de la liste déroulante, spécifiez Liste de chaînes et l'expression régulière
pour filtrer les valeurs.
Voir http://www.gnu.org/software/gawk/manual/gawk.html pour plus de détails sur l'utilisation des expressions régulières.
Filtres premier exemple
Vous voulez afficher toutes les alarmes correspondant au Filtre 1 d'une valeur égale à 10. Paramètres de propriétés : Filtre
colonne 2 = Valeur, Filtre 2 = 10
Filtres deuxième exemple
Vous voulez afficher toutes les alarmes correspondant à une valeur de sévérité comprise entre 3 et 6 (Normal à Critique).
Paramètres de propriétés : Filtre colonne 2 = Sévérité, Filtre 2 = [3-6]
Filtres troisième exemple
Vous voulez afficher toutes les alarmes correspondant à une valeur comprise entre 11 et 19. Paramètres de propriétés :
Filtre colonne 2 = Sévérité, Filtre 2 = ^(1[1-9]$)
Signification :
160
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
^ = la correspondance doit commencer au début de la chaîne
1[1-9] = le premier char doit être 1 et le deuxième char doit être compris entre 1 et 9
$ = fin de la comparaison.
Exemples d'expression de filtres
Filtrer
par
Liste des chaînes
Liste de données
État
Masquer les alarmes non
déclenchées
^((Not Triggered Acked|Not Triggered Not
Acked|Triggered).*$)
Valeur
10 < Valeur < 20
^(1[0-9]$)
Valeur
20 <= Valeur <100
^([2-9].$)
Valeur
100 < Valeur < 200
^(1[0-9][0-9]$)
Valeur
Valeur 2?/3?/4?/5?
^([2-9].*$)
Valeur
Valeur >= 100
^([1-9][0-9][0-9].*$)
Valeur
Valeur >= 20
^([2-9].*$|[1-9][0-9][0-9].*$)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
161
Widget alarmes actives
Trier les alarmes
Chemin : Widget Alarme active > volet Propriétés> Tri
La fonction de tri vous permet de trier les alarmes à l'exécution dans le widget des alarmes en cliquant sur l'en-tête de la
colonne.
Note : La valeur de sévérité affichée ici est définie dans l'Éditeur d'alarme.
Action
Lorsque l'« Action utilisateur » associée avec l'alarme (voir "Éditeur d'alarmes" on page 152 pour plus de détails) contient
des actions valides, l'icône Action s'affiche. En appuyant sur l'icône, les actions configurées seront exécutées.
AVERTISSEMENT : Lorsque vous utilisez un ancien projet converti, vous devez remplacer l'ancien
widget Alarmes actives par le nouveau widget, situé dans la galerie des widgets
Note : L'image peut être modifiée dans les propriétés des colonnes du widget Alarmes actives
162
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Widget historique des alarmes
Créé et affiche une liste d'alarme lorsque la propriété Mémoire tampon est définie dans l'éditeur de configuration des
alarmes.
Associer un widget à la mémoire tampon
Chemin : Widget HistoriqueAlarme > volet Propriétés > Mémoire tampon > MémoireÉvénement
Dans le volet Propriétés > Événement, sélectionnez la Mémoire d'événements qui contient la liste d'alarmes
Gestion des alarmes à l'exécution
Lorsqu'une alarme est déclenchée, elle s'affiche dans le widget Alarmes Actives, où vous pouvez la confirmer et la
réinitialiser. Vous pouvez filtrer les alarmes affichées en utilisant une série de filtres, par exemple vous pouvez masquer les
alarmes non déclenchées ou bien afficher toutes les alarmes.
Voir "Widget alarmes actives" on page 159 pour plus de détails.
IMPORTANT : Le widget alarmes actives ne s'affiche pas automatiquement. Vous devez ajouter une
action dédiée qui ouvrira la page contenant le widget d'alarme dès que l'alarme se déclenche.
Activer/désactiver les alarmes à l’exécution
Vous pouvez activer ou désactiver les alarmes à l'exécution.
Pour activer une alarme, sélectionnez l'option Activer dans le widget de l'alarme.
Les alarmes désactivées ne sont pas déclenchées, elles ne sont donc pas affichées à l'exécution.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
163
Afficher les données d’alarme actives
Note : Vous pouvez configurer les alarmes pour qu'elles soient activées/désactivées même depuis l'API.
Voir « Éditeur de configuration d'alarme » pour plus de détails.
Afficher les données d’alarme actives
Chemin : VueProjet> Configuration > double-cliquez sur Alarmes
Vous pouvez paramétrer la description d'alarme de manière à afficher les données de variable active, aussi bien dans les
Alarmes Actives que dans le widget Alarmes Historiques.
Pour afficher la valeur de variable, définir un caractère fictif dans Description et entrez le nom de variable entre crochet,
par exemple « [variable1] ». À l'exécution, la valeur actuelle de la variable apparaîtra dans la colonne Description du
widget Alarmes Actives. Dans le widget Alarmes Historiques ou dans le fichier .csv, s'affiche la valeur au moment où
l'alarme s'est déclenchée
Utilisez '\' avant '[ ]' si vous souhaitez afficher le '[ ]' dans la chaîne de description, par exemple : \[variable\[1\]\]
affichera la chaîne « [variable[1]] ».
Utiliser '\', même lorsque l'étiquette de variable contient des crochets. Par exemple, pour afficher la valeur de la
variable en direct de la variable « TAG]3 » ou « TAG[3] », utiliser :
164
l
TAG\]3 = [TAG\]3]
l
TAG\[3\] = [TAG\[3\]]
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
Exemple d'un widget d'alarme
Note : Le fichier csv résultant du vidage de la liste des événements d'alarme indiquera également la valeur de
variable dans la colonne de description.
Exporter la mémoire tampon des alarmes vers fichiers
.csv
Pour exporter une mémoire d'événements contenant une liste de l'historique des alarmes, utilisez l'action
ViderArchiveÉvénement.
Voir "Actions système" on page 123 pour plus de détails.
Note : Les valeurs de variable affichées dans la description des alarmes sont aussi incluses dans la
mémoire tampon. Les variables sont échantillonnées lorsque l'alarme est déclenchée et lorsque la
valeur est enregistrée et incluse dans la description.
Exporter la configuration des alarmes
Chemin : VueProjet> Configuration > double-cliquez sur Alarmes
Cliquez sur le bouton Exporter alarmes : le tableau de configuration des alarmes est exporté dans un fichier .xml.
Vous pouvez éditer le fichier .xml qui en résulte avec des outils tiers (par exemple, Microsoft Excel).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
165
Exporter la configuration des alarmes
Importer la configuration des alarmes
Chemin : VueProjet> Configuration > double-cliquez sur Alarmes
166
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
15 Alarmes
1. Cliquez sur le bouton Importer Alarmes et sélectionnez le fichier .xml à partir duquel vous souhaitez importer la
configuration des alarmes : la boîte de dialogue Importer Alarmes s'affiche.
2. Sélectionnez le groupe d'alarmes à importer et cliquez sur OK pour confirmer.
Les différences sont mises en évidence dans la boîte de dialogue Importer Alarmes à l'aide de couleurs différentes
Couleur Description
Noir
C'est une nouvelle alarme et elle sera importée
Rouge
Cette alarme n'a pas été trouvée et sera supprimée (seulement si la case « Remplacer les alarmes de projet
par les alarmes importées » est sélectionnée)
Bleu
Cette alarme a été modifiée et sera mise à jour.
Gris
Cette alarme fait déjà partie du projet et sera sautée.
Synchronisation automatique
Sélectionnez l'option Synchroniser en temps réel dans la boîte de dialogue Importer Alarmes pour activer la
synchronisation automatique du fichier de configuration d'alarme.
À chaque modification de la configuration des alarmes, le fichier sera automatiquement mis à jour en mode silencieux.
Astuce : Activez cette fonction lorsque le fichier d'alarme est géré par un autre outil (par exemple, logiciel de
programmation API), en plus du AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
167
Exporter la configuration des alarmes
168
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
16
Recettes
Les recettes sont des collections de valeurs de variable organisées selon des ensembles répondant à des exigences
spécifiques de l'application.
Par exemple, vous devez contrôler les variables d'une pièce (température et humidité) le matin, l'après-midi et le soir. Vous
pourrez créer trois ensembles (matin, après-midi, soir) dans lesquels vous définirez les valeurs de variable appropriées.
Pour une utilisation plus efficace, chaque élément de la recette est associé à une variable et peut être indexé dans des
ensembles. Cette fonctionnalité vous permet d'étendre les capacités des contrôleurs ayant une mémoire limitée.
Vous pouvez ajouter des données du contrôleur à une page en utilisant un widget de recette. Les données de recette
contiennent tous les éléments de données du contrôleur ; cependant, ces données ne peuvent plus être consultées
directement à partir du contrôleur, mais à partir de l'élément de recette associée sur le périphérique IHM.
Les données de recette sont configurées dans l'espace de travail AGI Creator; l'utilisateur peut préciser les valeurs par
défaut pour chaque élément des données enregistrées. Dans HMI Runtime, les données peuvent être modifiées et
sauvegardées dans un nouveau fichier de données, toutes les modifications des données de recette sont donc stockées
sur le disque. En utilisant un fichier de données distinct HMI Runtimeassure le maintien des valeurs de recette modifiées à
travers les différentes mises à jour de projet. Autrement dit, une mise à jour de projet postérieure n'affecte pas les données
de recette modifiées par l'utilisateur dans le HMI Runtime.
Voir "Actions de recette" on page 117pour plus de détails sur la réinitialisation des données de recette.
Note : Les données de recette peuvent être stockées sur une mémoire flash, sur une clé USB ou sur une carte
SD.
Gestion des recettes
169
Configuration d’un widget de recette
172
État de la recette
173
Charger/télécharger une recette
173
Sauvegarder et restaurer des données de recettes
174
Gestion des recettes
Créer une recette
Pour créer une recette pour votre projet :
1. Dans Affichage du projet, cliquez à l'aide du bouton droit sur Recettes et sélectionnez Insérer une recette : une
recette vide s'ajoute. Vous créez et configurez vos recettes à l'aide de l'Éditeur de recettes.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
169
Gestion des recettes
Éditeur de recettes
Chemin : Affichage du projet> Recettes > double-cliquez sur Nom de la recette
Configurer les propriétés de recette
Dans le volet Propriétés de chaque recette, vous pouvez définir les paramètres suivants :
Paramètre
Description
Nom de recette
Nom de la recette
Nombre
d'ensembles
Nombre d'ensembles de valeurs pour chaque élément de recette. Chaque ensemble a un nom
différent qui peut être configuré.
Paramétrer une recette
1. Cliquez sur + pour ajouter un élément à la recette.
2. Associez les variables à chaque élément de recette.
Définir des champs de recette
Créez un champ de recette dans la page en utilisant un widget numérique et en l'associant à un élément de recette après
voir sélectionné la recette en tant que source.
170
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
16 Recettes
Dans la boîte de dialogue Associer à, vous avez le choix parmi toutes les différentes variables de recette, telles que :
l
Recette actuelle >Ensemble de recette actuellement sélectionné> Élément > Valeur
l
Recette sélectionnée > Ensemble0 sélectionné > Élément > Valeur
l
liste de recettes
Quand les widgets numériques sont définies en accès lecture/écriture, les données de recette par défaut peuvent être
modifiées en cours d'exécution. Ces nouvelles valeurs sont stockées sur un fichier distinct en tant que données de recette
modifiées.
Note : Étant donné que l'on utilise les fonctions de l'API JavaScript, les éléments de recette et les ensembles
peuvent être référencés par nom ou par position. Afin d'éviter toute ambiguïté entre les noms et les index, les
noms des éléments de recette et des ensembles doivent inclure au moins un caractère alphanumérique.
Stocker les données de recette
Dans l'Éditeur de recette, cliquez sur l'icône du type de stockage pour sélectionner l'endroit où vous souhaitez stocker
les données de recette : la boîte de dialogue du Périphérique de stockage s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
171
Configuration d’un widget de recette
Pour les clés USB et les cartes de stockage SD, vous pouvez préciser l'emplacement du dossier.
AVERTISSEMENT : Les fichiers de configuration des recettes sont créés automatiquement au moment
de la sauvegarde du projet et sont stockés dans le sous-dossier du projet. Pour utiliser les
périphériques de stockage externes, vous devez copier ce dossier dans le périphérique externe. Notez
que vous avez la responsabilité de gérer le dossier de données à l'intérieur des périphériques
externes. Même les fichiers dynamiques ne sont pas supprimés lorsque le projet est mis à jour en
utilisant l'option « Supprimer le fichier dynamique ».
Important : Vous pouvez ajouter un sous-dossier mais vous ne devez pas renommer le sous-dossier
"données".
Configuration d’un widget de recette
Vous pouvez choisir un des deux widgets de recettes disponibles dans la Galerie des widgets :
l
l
Ensemble de recettes : vous permet de sélectionner un ensemble de recettes pour le charger ou le télécharger.
Voir "Charger/télécharger une recette" on the facing page
Menu de recettes : lorsque plusieurs recettes ont été créées pour un projet, utilisez ce widget pour gérer toutes les
recettes et sélectionnez les ensembles voulus pour chacune d'entre elles.
Configurer le widget d'ensemble de recettes
Dans le volet Propriétés de chaque widget Ensemble de recettes, définissez les paramètres suivants :
172
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
16 Recettes
Paramètre
Description
Nom de recette
Nom de la recette
État de la recette
Après chaque chargement ou téléchargement de recette, ou modification d'un ensemble de recette, les paramètres État de
la recette afficheront une valeur correspondant au résultat de l'opération.
Code Fonction
Description
0
Ensemble
modifié
Ensemble sélectionné modifié
1
Téléchargement Demande de téléchargement déclenchée
déclenché
2
Téléchargement Opération de téléchargement terminée
effectué
3
Erreur de
téléchargement
Erreur pendant le téléchargement (par exemple, ensemble inconnu, recette
inconnue, contrôleur pas prêt, échec d'écriture des variables etc.)
4
Chargement
déclenché
Demande de chargement déclenchée
5
Chargement
effectué
Opération de chargement terminée
6
Erreur de
chargement
Erreur pendant le chargement - pareil que pour le téléchargement
7
Erreur générale
Erreur générale (par exemple, données indisponibles)
Note : Au démarrage du périphérique, la valeur État de la recette est 0.
Charger/télécharger une recette
Charger une recette
Vous chargez une recette sur un périphérique IHM en utilisant un widget de recette et le UpLoadRecipe, l'action
UpLoadCurRecipe est une des façons suivantes :
l
l
l
joindre l'action à un événement d’un bouton ou d’un interrupteur (voir "Paramètres « Associer à »" on page 38 pour
plus de détails)
configurer l'action dans une liste d’action d'alarme (voir "Actions d'alarmes" on page 106 pour plus de détails)
configurer l'action dans une liste d’action de planificateur (voir "Ordonnancement des événements à l’exécution" on
page 214 pour plus de détails)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
173
Sauvegarder et restaurer des données de recettes
Télécharger une Recette
Vous téléchargez une recette depuis un périphérique IHM en utilisant un widget de recette et le DownloadRecipe, l'action
DownLoadCurRecipe. Voir "Actions de recette" on page 117.
Sauvegarder et restaurer des données de recettes
Les données de recette stockées dans un périphérique IHM peuvent être exportées pour être sauvegardées et restaurées
par la suite. Pour ce faire, il faut utiliser les actions ViderDonnéesRecette ou RestaurerDonnéesRecette.
Voir "Actions de recette" on page 117 pour plus de détails.
174
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17
Tendances
Les tendances vous permettent de goûter et d'enregistrer les valeurs des variables spécifiées en fonction des conditions
spécifiques d'échantillonnage. La fonction de tendance comprend l'acquisition de tendance et l'affichage de tendance.
Les paramètres d'acquisition de tendance sont définies dans l'éditeur de tendance afin que les données puissent être
stockées. Les données stockées peuvent ensuite être affichées dans un format graphique en utilisant un widget tendance.
Enregistrement des données
176
Exporter les données de mémoire de tendance
177
Widgets de tendance
178
Tendances historiques
180
Propriétés du widget de tendance
182
Gestes de widget de tendance
183
Valeurs hors de portée ou non valides
184
Afficher les valeurs de tendance
185
Widget de diagramme de dispersion
186
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
175
Enregistrement des données
Enregistrement des données
Les données peuvent être enregistrées et stockées dans la mémoire IHM. L'enregistrement des données vous permet de
stocker les valeurs d'un groupe de variables au même moment dans une mémoire tampon. L'enregistrement des données
peut être déclenché par un minuteur ou par une variable dédiée. Les données enregistrées peuvent être exportées dans un
fichier .csv ou affichées en utilisant le widget de tendance historique. Les données enregistrées peuvent être sauvegardées
localement sur un périphérique USB ou sur une carte SD, ou bien sur tout dossier de réseau personnalisé et disponible.
AVERTISSEMENT : L'opération avec des périphériques mémoire amovibles (lecteurs flash USB,
cartes mémoires SD) contenant un très grand nombre de fichiers peut entraîner une perte de
performance du système.
AVERTISSEMENT : Le nombre maximal de fichiers dans une carte mémoire SD dépend du type de
formatage (par ex. FAT32 max. 65536 fichiers, FAT max. 513 fichiers).
AVERTISSEMENT : Les cartes flash prennent en charge un nombre limité d'opérations d'écriture.
Nous vous suggérons de n'utiliser que des cartes mémoires de bonne qualité. Lorsque votre
application utilise la carte mémoire de manière intensive, pensez à changer régulièrement de carte
mémoire.
AVERTISSEMENT : Si la date/heure est reculée, les échantillons avec des dates/heures non valides
sont supprimés de la mémoire des tendances. Lorsque le système détecte que la date/l'heure n'est pas
valide (ex. batterie faible), un avertissement s'affiche pour informer l'utilisateur que la date/l'heure du
dernier échantillon est utilisée pour éviter de perdre des données.
Le stockage est basé sur les mémoires des tendances. Les mémoires des tendances sont organisées comme une queue
FIFO : lorsque la mémoire tampon est pleine, les valeurs les plus anciennes sont rejetées sauf si vous configurez votre
tendance pour créer une copie de sauvegarde de la mémoire tampon.
Ajouter une mémoire des tendances
Chemin : VueProjet> Configuration > double-cliquez sur Tendances
1. Cliquez sur Ajouter pour ajouter une nouvelle mémoire tampon.
2. Cliquez sur + à côté de chaque mémoire des tendances pour afficher tous les paramètres de configuration.
176
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
Élément
Description
Espace mémoire total
Mémoire en cours d'utilisation par la mémoire des tendances. Voir "Tableau de fonctions et
limites" on page 430 pour le nombre maximal d'échantillons autorisé pour un projet.
Ce pourcentage est calculé de la manière suivante :
Nom de tendance
Nom de tendance qui sera affiché dans le volet des propriétés de la fenêtre.
Actif
Lorsque cet élément est activé, la tendance s'exécute par défaut au démarrage du système.
Note : Les tendances ne peuvent pas être activées en cours d'exécution.
Source
Variables échantillonnées par la tendance.
Temps
d'échantillonnage
Intervalle d'échantillonnage en secondes.
Déclencheur
Variable déclenchant l'échantillon. Lorsque la valeur de cette variable change, un échantillon
est collecté.
Note : Déclencheur et Source peuvent faire référence à la même variable.
Nombre d'échantillons
Taille de la mémoire tampon.
Périphérique de
stockage
Périphérique où les données de mémoire des tendances sont stockées.
Mémoire tampon
Lorsque l'option Sauvegarder une copie lorsque la mémoire est saturée est activée, une
copie de sauvegarde des données de mémoire tampon est créée avant qu'elle ne soit
écrasée par de nouvelles données.
Filtre
Lorsque la condition de déclenchement est le temps, un nouvel échantillon est stocké
d'échantillonnage/Filtre lorsque sa valeur, comparée à la dernière valeur sauvegardée, dépasse les limites
déclencheur
spécifiées.
Lorsque la condition de déclenchement est une variable, un nouvel échantillon est stocké à
chaque modification de la valeur de déclenchement de la variable.
Tableau de variables
échantillonné
Nom : nom de la tendance
Variable : variable à échantillonner.
Commentaire : description de la tendance
Exporter les données de mémoire de tendance
Utilisez l'action ClichageTendance pour exporter des données de mémoire de tendance vers un fichier .csv.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
177
Widgets de tendance
Le format des données de tendance exportées vers un fichier .csv peut être sélectionné depuis un paramètre macro,
comme sur l'illustration. Toutes les variables spécifiées dans la mémoire des tendances sont exportées
Mode clichage normal (mode de compatibilité)
Mode clichage étendu (mode compact)
Note : La première ligne de l'en-tête contient les noms de variables et les types de données de variables
Voir "Actions système" on page 123 pour plus de détails.
Widgets de tendance
Il est possible d'afficher les données enregistrées par le périphérique IHM sous forme de graphiques en utilisant les widgets
de tendance.
Widget de tendance en temps réel
Le widget de tendance en temps réel peut être utilisé pour afficher les modifications de valeur d'une variable. Les données
ne sont pas stockées dans une mémoire des tendances et ne peuvent pas être récupérées pour une analyse ultérieure.
Pour afficher une tendance en temps réel :
178
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
1. Glissez-déposez le Widget de tendance en temps réel de la galerie des widgets jusqu'à la page.
2. Associez la variable que vous voulez échantillonnez à la valeur de la Courbe n. Les données doivent toujours être
représentées en fonction du temps.
Propriétés du widget de tendance en temps réel
Propriété Description
Nombre
de
courbes
Nombre de courbes de tendance à afficher (Max. 5)
Durée de
page
Intervalle de temps de l'axe x.
Position
initiale
Spécifie le point de départ de la courbe lorsque la page est ouverte.
Labels X
Nombre de graduations sur l'échelle de l'axe x
Labels Y
Nombre de graduations sur l'échelle de l'axe y.
Texte
Titre de tendance et propriétés de police (taille de police, label, etc.)
Grille
Propriétés de présentation des grilles (couleurs)
Curseur
Propriétés de présentation du curseur (activation et couleur)
Échelle
X
Propriétés de présentation de l'échelle X
Astuce : Vous pouvez associer un widget Date Heure combiné à la propriété de
Durée de Page et modifier de façon dynamique la durée de la page pendant
l'exécution.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
179
Tendances historiques
Propriété Description
Échelle
Y
Propriétés de présentation de l'échelle Y
Courbe
«n»
variable qui sera représentée dans le widget de tendance. Voir "Propriétés du widget de
tendance" on page 182 pour plus de détails.
Vous pouvez définir le minimum et le maximum des courbes (Min Y, Max Y). Vous pouvez
associer une variable aux propriétés minimum et maximum. Cela permet de modifier plus
aisément les valeurs minimum et maximum de façon dynamique pendant l'exécution.
Mise à l'échelle des données
Les valeurs de variable peuvent être mises à l'échelle en utilisant les Formes X dans la boîte de dialogue Associer à. Voir
"Paramètres « Associer à »" on page 38 pour plus de détails.
Tendances historiques
Les données de tendance stockées dans les mémoire des tendances peuvent être analysées à l'aide du widget de
Tendance historique.
Il s'agit d'un processus en deux étapes :
l
l
tout d'abord, vous créez une mémoire des tendances qui collectera les données de variables spécifiques à des
moments spécifiques,
puis vous configurez un widget de Tendance historique de manière à ce qu'il affiche les données collectées sous
forme de graphique.
Voir "Enregistrement des données" on page 176 pour plus détails sur la façon de créer une mémoire des tendances.
Widget de Tendance historique
Le widget de Tendance historique affiche le contenu de la mémoire des tendances sous forme de graphique.
L'heure de début correspond à l'heure actuelle et l'heure de fin correspond à l'heure actuelle plus la durée de la fenêtre. La
courbe part de la gauche et progresse vers la droite, les données sont automatiquement rafraîchies pendant un certain
intervalle de temps, jusqu'à l'heure de fin.
Lorsqu'elle atteindra l'heure de fin, la courbe défilera vers la gauche et sa mise à jour continuera jusqu'à ce qu'elle atteigne à
nouveau l'heure de fin. À ce moment, un nouveau défilement est automatiquement exécuté et le processus se répète.
180
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
Les tendances historiques demandent une configuration appropriée de la mémoire des tendances.
Voir "Enregistrement des données" on page 176 pour plus détails sur l'utilisation de l'Éditeur de tendances.
Configurer le widget de Tendance historique
1. À partir de la section Tendances/Graphiques de la Galerie des widgets, glissez-déposez le widget de Tendance
historique dans la page.
2. Dans le volet Propriétés, associez la mémoire des tendances à tracer dans le widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
181
Propriétés du widget de tendance
Propriétés du widget de tendance
Certaines propriétés de tendance du widget ne sont disponibles que lorsque le volet Propriétés est en mode Avancé.
Demande d'échantillons
La propriété de demande d'échantillons peut être réglée pour chaque courbe et indique le nombre maximum
d'échantillons lus par le widget à un moment donné de la mémoire des tendances.
Astuce : Vous n’avez normalement pas besoin de modifier la valeur par défaut. Ajuster pour affiner les
performances accordées dans le rafraîchissement du widget tendance, en particulier quand on travaille avec des
clients distants.
Bandes de couleur
Utiliser la configuration des bandes de couleur pour personnaliser votre arrière-plan de graphique, par exemple pour mettre
en évidence certains jours ou certaines heures (week-ends, heures de nuit, etc.).
182
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
1. Dans le volet Propriétés, dans la propriété Bandes de couleur, cliquez sur + : la fenêtre Configurer bandes
apparaît.
2. Cliquez sur + pour ajouter le nombre de couches souhaitées.
3. Sélectionnez plusieurs cellules et cliquez sur une bande de couleur pour affecter la couleur à la plage sélectionnée
des cellules.
Note : Cette fonction utilise uniquement l'heure locale dans le widget de tendance, pas l'option de temps global.
Exemple de bandes de couleurs dans le calendrier
Gestes de widget de tendance
Les widgets de tendance supportent les commandes gestuelles :
Geste
Description
faire défiler
Touchez le widget pour faire défiler la courbe dans la zone de widget
pincer
Utilisez deux doigts pour pincer la courbe et effectuer des opérations de zoom
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent générer des événements de
pincement
Note : Afin de soutenir les gestes sur l'axe Y, les propriétés min/max du widget de tendance doivent être liées
aux valeurs Min/Max des paramètres de comportement (par défaut pour les nouvelles tendances).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
183
Valeurs hors de portée ou non valides
Valeurs hors de portée ou non valides
Lorsque la valeur de tendance dépasse les limites définies pour le widget de tendance, une ligne pointillée apparaît.
Lorsque la valeur de la variable n'est pas disponible, par exemple lorsque le périphérique du contrôleur est hors ligne,
aucune courbe n'est tracée.
184
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
Afficher les valeurs de tendance
Le curseur de tendance affiche la valeur de la tendance à un moment précis.
Utilisez les actions AfficherCurseurTendance et FaireDéfilerCurseurTendance pour activer le curseur de la tendance et
le déplacer vers le point nécessaire pour obtenir la valeur de la courbe à ce moment précis dans le temps.
Pour afficher la valeur du curseur de tendance sur la page, définir un champ numérique et l'attacher à la variable du widget
Valeur du Curseur.
Dans cet exemple, la valeur de l'axe Y du curseur est affichée.
Pour afficher l’horodatage de tendance sur la position du curseur, définir un champ numérique et l'attacher à la variable du
widget Valeur de l’horodatage.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
185
Widget de diagramme de dispersion
Widget de diagramme de dispersion
Un diagramme de dispersion est un type de diagramme pour afficher les valeurs de deux variables à partir d'un ensemble
de données à l'aide de coordonnées cartésiennes. Les données sont affichées comme un ensemble de points, chacune
ayant la valeur d'une variable de détermination de la position sur l'axe horizontal et la valeur de l'autre variable déterminant
la position sur l'axe vertical. C’est la raison pour laquelle il est souvent appelé graphique XY.
Les courbes de diagramme de dispersion sont obtenues par une interpolation linéaire des points. Pour créer un nouveau
diagramme de dispersion :
1. Ajoutez un widget Diagramme de dispersion à la page.
2. Sélectionnez le nombre de courbes à afficher : chaque courbe est nommée comme Graph1, Graph2, etc.
3. Personnalisez les propriétés des graphes généraux tels que les détails X Min, X Max, de la grille.
4. Définir le nombre maximum d'échantillons/valeurs pour chaque courbe en définissant le paramètre Échantillon
max.
Vous définissez ici le nombre maximum de valeurs à afficher dans le graphique à partir du premier élément du
tableau.
186
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
17 Tendances
Par exemple : Tag1[20] et échantillons Max = 10 montreront seulement les 10 premiers éléments du tableau Tag1.
5. Définir pour chaque courbe les deux variables de tableau type à afficher (variable X et variable Y).
Lorsque les variables de tableau changent, vous pouvez forcer un rafraîchissement à l'action de RafraîchirTendance.
Note : Les diagrammes de dispersion ne supporte que l’action RafraîchirTendance.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
187
Widget de diagramme de dispersion
188
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
18
Transfert de données
Le transfert de données vous permet de transférer des données de variables d'un périphérique à l'autre. En utilisant cette
fonctionnalité, un périphérique IHM peut opérer comme une passerelle entre deux périphériques, même lorsqu'ils n'utilisent
pas le même protocole de communication.
Éditeur de transfert de données
190
Exporter données vers fichiers .csv
192
Limites et recommandations du transfert de données
192
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
189
Éditeur de transfert de données
Éditeur de transfert de données
Chemin : VueProjet> Configuration > double-cliquez sur Transfer de données
Utilisez l'éditeur de transfert de données pour cartographier les règles de transfert.
Chaque ligne de l'éditeur de transfert de données définit une règle de correspondance entre les deux variables. Définir
plusieurs règles de correspondance si vous avez besoin direction différente, la méthode de mise à jour ou de déclencheur.
Pour ajouter une nouvelle règle, cliquez sur + : une nouvelle ligne de variable apparaît.
Barre d’outil de transfert de données
Paramètre
Description
Import / Export
Importer ou exporter les paramètres de transfert de données depuis ou vers un fichier
.csv.
Rechercher
Affiche uniquement les lignes contenant le mot-clé de recherche.
Filtrer par
Afficher uniquement les lignes filtre et champ de recherche correspondant.
Paramètres de transfert de données
Paramètre
Description
TAG A / TAG B
Paire de variables à mapper pour l'échange via le dispositif IHM.
Direction
Direction de transfert.
A->B et B->A : Transferts unidirectionnels, les valeurs sont toujours copiées d'un tag
et envoyées à l'autre variable dans la direction indiquée.
A<->B : Transfert bidirectionnel, les valeurs sont transférées vers et depuis les deux
variables.
Méthode de mise
190
Dès le déclenchement : Le transfert de données se produit lorsque la valeur de la
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
18 Transfert de données
Paramètre
Description
à jour
variable définie comme les changements de déclenchement au-dessus ou en dessous
des valeurs définies comme limites. Les limites sont recalculées sur la valeur de la
variable précédente, le même qui a déclenché la mise à jour.
Note : Cette méthode s’applique uniquement aux transferts unidirectionnels
(A->B ou B->A).
Dès la mise à jour : Le transfert de données se produit à chaque fois que la valeur des
variables source change.
Note : Cette méthode vaut aussi bien pour les transferts unidirectionnels que
ceux bidirectionnels (A->B, B->A et A<->B).
Note : Le runtime surveille cycliquement les changements des variables
source (variable déclencheur lors de l'utilisation sur Déclencheur ou des
variables à transférer lors de l'utilisation sur Mise à jour) basé sur le
paramètre de Fréquence de l'éditeur de variable. Si le paramètre Fréquence
pour la variable source est de 500 ms (par défaut), le système vérifie les
mises à jour toutes les 500 ms.
Note : Les modifications sur les variables des sources plus rapides que la
fréquence ne peuvent être pas détectées.
Déclencheur,
Limite
supérieure,
Limite inférieure
Variable qui déclenche le processus de transfert de données. Lorsque cette variable
modifie sa valeur en dehors des limites fixées comme limite supérieure et limite
inférieure, le transfert de données démarre. La plage de tolérance est recalculée en
fonction des limites spécifiées sur la valeur de la variable qui a déclenché la mise à jour
précédente. Aucune action n’est prise si le changement se situe dans les limites.
Ce mécanisme permet de déclencher des transferts de données uniquement lorsque
les variations significatives des valeurs de référence se produisent.
La limite inférieure est inférieure ou égale à zéro.
Note : Si les deux limite inférieure et limite supérieure sont réglée sur
« 0 », le transfert de données se produit à chaque fois que la valeur de la
variable de déclenchement change
au moment du
démarrage
Lorsqu'il est sélectionné, le transfert de données est forcé :
l
l
sur un démarrage IHM si la qualité de la variable source est bonne
après des erreurs de communication, lorsque les Nœuds de périphérique
associé revient actif
Voir "Objets" on page 336 pour plus de détails relatifs à la qualité.
Important : Les transferts de données exécutés au démarrage peuvent
avoir un impact majeur sur le temps de démarrage du périphérique
IHM. Activez cette option seulement si nécessaire.
Exemple de réglage de la limite
Limite supérieure = 1,9
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
191
Exporter données vers fichiers .csv
Limite inférieure = - 0,9
• = points où le transfert de données est déclenché
Exporter données vers fichiers .csv
Les informations de configuration pour les transferts de données peuvent être exportées vers un fichier .csv.
Exemple de paramètres de transfert de données vers un fichier .csv
Colonne Description
AàG
Même données que dans l'éditeur de transfert de données
H
Identifiant uniquement associé automatiquement à chaque ligne.
Important : Lorsque vous éditez le fichier .csv et que vous ajoutez toute ligne
supplémentaire, vérifiez que vous entrez bien un identifiant unique dans cette
colonne.
I et J
Réservés à une utilisation ultérieure.
L’import / export utilise le caractère de séparation définie à l'intérieur des paramètres régionaux de Windows.
Limites et recommandations du transfert de données
Une définition correcte des règles de transfert des données est critique pour la performance des périphériques IHM. Pour
garantir une opération et une performance fiables, gardez à l'esprit les règles suivantes.
192
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
18 Transfert de données
Méthode dès le déclenchement
La méthode Dès le déclenchement ne permet que des transferts unidirectionnels (A->B ou B->A).
Le transfert de données basé sur le mode Dès le déclenchement doit être privilégié car il vous permet de forcer le transfert
et il surveille uniquement les variables de déclenchement et non toutes les variables impliquées dans le transfert.
Méthode dès la mise à jour
La méthode Dès la mise à jour permet de changer les valeurs selon les paramètres de direction uniquement lorsque la
valeur de la source est modifiée.
En utilisant la méthode Dès la mise à jour, vous forcez le système à lire continuellement toutes les variables de source
définies pour vérifier si des modifications doivent être transférées. La valeur par défaut de la fréquence des mises à jour de
chaque variable est de 500 ms et peut être modifiée avec l'Éditeur de variables.
Observations sur la performance
La performance du transfert de données dépend :
l
du nombre de transferts de données définis,
l
du nombre de transferts de donnés qui pourrait se produire en même temps,
l
de la fréquence des modifications des variables API qui sont surveillées,
Important : Testez toujours la performance de l'opération durant le développement du projet.
Important : Si les tâches de transfert de données sont définies de manière inappropriée, elles peuvent
entraîner des conditions où les variables impliquées créent des boucles. Identifiez et évitez de telles
conditions.
Astuce : Utilisez le planificateur pour calibrer la fréquence de mise à jour sur la performance de l'ensemble de
votre projet.
Astuce : Utilisez des variables de type tableau pour optimiser le transfert de données et réduire la charge de
travail.
Astuce : Réduisez le nombre de transferts de données pour réduire le temps de modification de la page et le
temps de chargement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
193
Limites et recommandations du transfert de données
194
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
19
Gestion de nœud hors ligne
Lorsqu'un contrôleur en communication avec les périphériques IHM est mis hors connexion, la performance de
communication du système pourrait diminuer.
La fonctionnalité de gestion de nœud hors ligne reconnaît les contrôleurs hors connexion et les écarte de la communication
jusqu'à leur remise en ligne.
De plus, si vous savez qu'un contrôleur inclus dans l'installation sera mis hors connexion pendant un certain temps, vous
pouvez le désactiver manuellement afin d'optimiser la performance du système.
Note : Cette fonctionnalité n'est pas supportée par tous les protocoles de communication. Vérifiez la
documentation de protocole pour savoir si elle est supportée ou pas.
Processus de gestion du nœud hors ligne
196
Processus de gestion manuelle du nœud hors ligne
196
Configuration manuelle hors ligne
196
Détection automatique de nœuds hors ligne
197
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
195
Processus de gestion du nœud hors ligne
Processus de gestion du nœud hors ligne
Les étapes de ce processus sont :
l
l
Le système communique normalement avec un périphérique donné. En cas d'absence de réponse du périphérique à
une demande de communication, le système répète la demande deux fois, puis déclare le périphérique hors ligne.
Quand un périphérique est hors ligne, le système envoie des demandes de communication au périphérique selon un
intervalle plus long, que l'on appelle Délai d'attente avant nouvelle tentative. Si le périphérique répond à l'une de ces
demandes, le système le déclare en ligne et reprend une communication normale.
Le diagramme montre les trois tentatives de communication et la procédure de restauration qui démarre dès l'expiration du
Délai d'attente avant nouvelle tentative.
Processus de gestion manuelle du nœud hors ligne
La gestion du nœud hors ligne peut être faite manuellement. Lorsqu'un périphérique spécifique est connecté et
communique normalement, vous pouvez :
l
l
utiliser une action pour déclarer le périphérique hors ligne : le système interrompra la communication avec le
périphérique.
utiliser une action pour déclarer le périphérique en ligne : le système reprendra la communication normale avec le
périphérique.
Configuration manuelle hors ligne
Lorsque vous savez que certains périphériques en communication avec le périphérique IHM resteront déconnectés
pendant un certain temps, vous pouvez les exclure de la communication en recourant à l'action Activer le nœud.
AVERTISSEMENT : Tous les nœuds de périphérique désactivés resteront désactivés si le même projet
est téléchargé sur le périphérique, a contrario, si un projet différent est téléchargé, tous les
périphériques désactivés seront réactivés. Il en va de même en cas de mise à jour de paquet.
Astuce : Pour rendre cette fonctionnalité plus dynamique, vous pouvez décider de ne pas indiquer d'ID de
nœud spécifique, mais de l'associer à la valeur d'une variable ou à une variable interne créée pour identifier les
différents périphériques éventuellement installés sur votre réseau.
Note : Lorsque vous utilisez l'action Activer le nœud pour forcer la remise en ligne d'un nœud de périphérique,
la communication reprend immédiatement.
196
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
19 Gestion de nœud hors ligne
Détection automatique de nœuds hors ligne
Lorsqu'un périphérique ne répond pas aux demandes de communication, il est désactivé. Le périphérique IHM arrête
d'envoyer des demandes à ce périphérique. Après trois secondes, le périphérique IHM envoie une commande pour vérifier
si le périphérique est disponible, auquel cas la communication est redémarrée. Dans le cas contraire, le périphérique est
désactivé pour un autre intervalle de délai d'attente.
Les paramètres par défaut peuvent être modifiés dans l'éditeur Protocole.
Note : Seuls certains protocoles prennent en charge cette fonction.
Paramètre
Description
Activer algorithme hors
ligne
Active la gestion hors ligne du protocole
Délai d'attente nouvelle
tentative hors ligne
Intervalle en secondes du cycle de nouvelle tentative après la désactivation
d'un périphérique. Plage : 1–86.400 secondes (24 h).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
197
Détection automatique de nœuds hors ligne
198
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
20
Multilangue
La fonctionnalité multilangue a été conçue pour créer des applications IHM contenant des textes en plusieurs langues
simultanées
La fonctionnalité multilangue utilise un support de pages de code pour gérer les différentes langues. Une page de code (ou
un fichier de script) est une série de formes de lettres utilisées au sein de chaque langue.
La fonctionnalité multilangue peut être utilisée pour définir les langues et les jeux de caractères d'un projet. AGI Creator
développe les polices TrueType proposées par les systèmes Windows afin de fournir différentes familles de police
associées à différents jeux de caractères.
AGI Creator vous permet également de fournir des chaînes pour chaque langue supportée.
AGI Creator vous permet enfin de modifier la langue d'affichage afin de vous donner une idée de l'aspect et de la
convivialité de la page pendant la phase de conception.
Important : Dans les systèmes d'exploitation Windows XP, vous devez installer le support pour les
scripts complexes et les langues de l'Asie de l'est.
Polices supportées pour le Chinois Simplifié
Pour le Chinois Simplifié, les polices suivantes sont supportées :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
199
Nom de police
Nom de fichier
Fangsong
simfang.ttf
Arial Unicode MS
ARIALUNI.TTF
Kaiti
simkai.ttf
Microsoft Yahei
msyh.ttf
NSImsun
simsun.ttc
SimHei
simhei.ttf
Simsun
simsun.ttc
Polices supportées pour le Chinois Traditionnel
Pour le Chinois Traditionnel, les polices suivantes sont supportées :
Nom de police
Nom de fichier
DFKai-SB
kaiu.ttf
Microsoft Sheng Hai
msjh.ttf
Arial Unicode MS
ARIALUNI.TTF
MingLiU
mingliu.ttc
PMingLiU
mingliu.ttc
MingLiU_HKSCS
mingliu.ttc
L'éditeur multilangue
201
Changer de langue
202
Widgets multilangues
202
Exporter/importer des chaînes multilangues
204
Modifier la langue à l'exécution
206
Limites de la prise en charge UNICODE
206
200
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
20 Multilangue
L'éditeur multilangue
Chemin : VueProjet> Configuration > double-cliquez sur Multilangue
Paramètres de langue
Paramètre
Description
Nom de la
langue
Nom identifiant la langue dans le projet.
Code de la
langue
Identificateur du code de la langue ISO 639, utilisé pour associer des éléments de langue lors de
l'importation de ressources depuis des fichiers xml externes.
Système
d'écriture
Sélectionnez le jeu de polices à utiliser avec la langue
Police par
défaut
Police par défaut pour les widgets du projet.
Polices
Nombre de polices associées avec la langue sélectionnée.
Taille
Mémoire utilisée pour stocker les fichiers de polices.
Stockage
Le fichier de polices est stocké dans une mémoire externe amovible.
Note : Lorsque vous choisissez une nouvelle police, vous êtes invité à remplacer la police
utilisée dans les widgets que vous avez déjà créés.
Astuce : Stockez les fichiers de polices volumineux sur une mémoire amovible pour libérer de
la mémoire requise dans le périphérique IHM.
Ajouter une langue
1. Dans l'onglet Langues, cliquez sur + : une ligne s'ajoute au tableau.
2. Entrez tous les paramètres de langue.
3. Cliquez sur Par défaut pour définir la langue sélectionnée comme langue par défaut lorsque le runtime démarre.
4. Cliquez sur Sauvegarder police pour copier les polices que vous avez marquées comme Amovibles sur une
mémoire externe.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
201
Changer de langue
Important : Les fichiers de polices configurés pour être stockés sur une mémoire amovible doivent
être fournis à l'utilisateur final pour terminer l'installation de la police sur le périphérique IHM.
Supprimer des polices
Pour supprimer des polices qui ne sont plus nécessaires :
1. Cliquez sur le numéro de police dans l'éditeur multilangue : une boîte de dialogue contenant la liste des polices
utilisée s'affiche.
2. Sélectionnez les polices à supprimer et cliquez sur Supprimer : les polices supprimées sont remplacées par la
police par défaut.
Changer de langue
Changer la langue pendant la conception de page
Une liste déroulant est disponible pour modifier la langue pendant la conception de page. Si aucun texte n'apparaît, veuillez
sélectionner l'onglet Texte dans l'éditeur multilangue et entrez la chaîne manquante.
Widgets multilangues
Le support multilangue est disponible pour les objets tels que les boutons, les textes statiques, les messages, les
descriptions d'alarme et les messages contextuels.
Multilangue pour les widgets d'étiquette
Double-cliquez sur un widget de texte dans une page pour ouvrir la boîte de dialogue Texte.
202
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
20 Multilangue
Activez/Désactivez la fonction multilangue, éditez le texte pour la langue sélectionnée et choisissez la police.
Note : Les propriétés caractère gras, italique et de couleurs définies ici pour le widget sont applicables à toutes
les langues.
Paramètre
Description
Multilangue
Activez/désactivez la fonction multilangue pour le widget.
Choisir texte depuis un
autre widget
Cliquez sur le bouton pour parcourir les chaînes de message présentes dans le projet afin
de sélectionner un texte pour le widget.
Multilangue pour les widgets de message
Double-cliquez sur un widget de message dans une page pour ouvrir la boîte de dialogue Texte de message.
Paramètre
Description
Multilangue
Activez/désactivez la fonction multilangue pour le widget.
Index continu
L'index pour le widget est une série de chiffres consécutifs (exemple 3, 4,5,6)
Min
Chiffre de départ pour l'index
Range
Nombre de messages
Choisir texte depuis un
autre widget
Cliquez sur le bouton pour parcourir les chaînes de message présentes dans le projet afin
de sélectionner un texte pour le widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
203
Exporter/importer des chaînes multilangues
Multi-langue pour les messages d'alarme
Pour ajouter des chaînes multilangues pour les messages d'alarme :
1. Ouvrez l'Éditeur d'alarme.
2. Sélectionnez une langue en utilisant la liste déroulante des langues.
3. Entrez le texte pour l'alarme dans la colonne Description.
Astuce : Les étiquettes de texte avec les états d'alarme affichés par les widgets d'alarme peuvent être traduites
ou personnalisées à l'aide de l'éditeur de texte multilangue.
Multilangue pour les messages contextuels
Pour ajouter un message contextuel multilangue :
1. Sélectionnez une langue dans la liste déroulante des langues.
2. Ajoutez l'action de page ShowMessage et entrez le texte dans la langue sélectionnée.
Exporter/importer des chaînes multilangues
La manière la plus simple de traduire un projet dans plusieurs langues est d'exporter tout le texte dans un fichier .csv, de
traduire le document qui en résulte puis de réimporter le texte traduit dans le projet.
Important : Le fichier .csv exporté par AGI Creator est codé en Unicode, vous avez donc besoin d'un
outil spécifique qui prend en charge les fichiers .csv encodés en Unicode pour l'éditer.
204
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
20 Multilangue
Exporter et réimporter des chaînes
Chemin : VueProjet> Configuration > double-cliquez sur Multilangue
Pour exporter et réimporter des chaînes multilangues :
1. Dans l'onglet Texte, cliquez sur Exporter : toutes les chaînes multilangues sont exportées dans un fichier .csv.
Important : Définissez toutes les langues qui sont utilisées dans le projet avant d'exporter le
fichier. Cela garantit que le fichier exporté contienne toutes les définitions de colonnes et de
langue.
2. Lorsque les chaînes ont été traduites, cliquez sur Importer pour les réimporter dans le projet : les chaînes sont
importées selon l'ID du widget et le numéro de page de chaque widget.
3. Cliquez sur Sauvegarder pour sauvegarder les données du nouveau widget.
Note : Pour changer le séparateur utilisé dans le fichier exporté, changez les paramètres régionaux de votre
ordinateur. Lors de l'importation, l'information du séparateur est récupérée dans le fichier. Si elle est introuvable,
le caractère par défaut « , » est utilisé.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
205
Modifier la langue à l'exécution
Contraintes d'importation
Les formats suivants sont pris en charge pour l'importation :
l
Valeurs séparées par des virgules (.csv)
l
Texte Unicode (.txt)
Note : Utilisez le format de fichier en Texte Unicode lorsque vous importez un fichier modifié avec Microsoft®
Excel®.
Modifier la langue à l'exécution
Modifier la langue avec une action
Après le téléchargement du projet, le runtime IHM utilise la langue définie par défaut. Vous pouvez modifier la langue en
utilisant l'action ConfigurerLangue. Voir "Actions multilangues" on page 107.
Note : Lorsque la langue est modifiée, elle sera également utilisée lors des sessions ultérieures.
Polices manquantes
Lorsque vous changez de langue, si les polices nécessaires ne sont pas disponibles dans la mémoire du périphérique, un
message contextuel vous invite à insérer la carte mémoire contenant les polices manquantes. À la fin de l'opération, vous
pouvez retirer la carte mémoire.
Limites de la prise en charge UNICODE
AGI Creator a été conçu pour accepter le texte Unicode. Cependant, en cas de problèmes d'incompatibilité avec certaines
plateformes, Unicode n'est pris en charge que dans un sous-ensemble de propriétés.
206
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
20 Multilangue
Domaine
Propriété
Jeu de caractères accepté
Caractères/Chaînes
réservés
Éditeur de
protocole
Alias
ASCII [32..126]
(espace) , ; : . < * >'
Éditeur de
variable
Nom
ASCII [32..126]
. \ / * ? : > < | " & # %;=
Groupe
ASCII [32..126]
<Nouveau> \ / * ? : > < | " &
#%;
Commentaire
Unicode
Tendances
Nom
ASCII [32..126]
\/*?:><|"&#%;
Rapports
d'impression
Nom
ASCII [32..126]
\/*?:><|"&#%;
Alarmes
Nom
ASCII [36..126]
\/*?:><|"&#%;
Description
Unicode
[] - pour les variables
actives, \ échap pour [ et \
Événements
Nom de mémoire
tampon
ASCII [32..126]
\/*?:><|"&#%;
Planificateur
Nom
ASCII [32..126]
\/*?:><|"&#%;
Langages
Nom de la langue
ASCII [32..126]
\/*?:><|"&#%;
Textes dans les
widgets
Unicode
-
Textes issus de
fichiers importés
Unicode
-
Groupe
utilisateur
Nom de groupe
a-z A-Z _
admin,guest,unauthorized
Commentaires
Unicode
-
Utilisateur
Nom
ASCII [32..126]
\/*?:><|"&#%;
Mot de passe
Unicode
-
Commentaire
Unicode
-
Nom
ASCII [32..126]
\ / * ? : > < " & # % ; ! $'
()+,=@[]{}~`
Nom d'ensemble
ASCII [32..126]
\ / * ? : > < " & # % ; ! $'
()+,=@[]{}~`
Nom d'élément
ASCII [32..126]
\ / * ? : > < " & # % ; ! $'
()+,=@[]{}~`
Nom du projet
A-Z,a-z,0-9,-,_
“PUBLIC”, “readme”,
“index.html”
Recettes
Général(e)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
207
Limites de la prise en charge UNICODE
Domaine
Runtime
208
Propriété
Jeu de caractères accepté
Caractères/Chaînes
réservés
Nom de la page
A-Z,a-z,0-9,-,_
-
Nom de page de
dialogue
A-Z,a-z,0-9,-,_
-
Nom de page de
modèle
A-Z,a-z,0-9,-,_
-
Nom du clavier
A-Z,a-z,0-9,-,_
-
Fichiers
A-Z,a-z,0-9,-,_
(Images/Vidéos/etc.)
-
ID de widget
A-Z,a-z,0-9,-,_
-
Communication API
UTF-8, Latin1, UCS-2BE, UCS2LE, UTF-16BE, UTF-16LE
-
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
21
Planificateur
AGI Creator fournit un moteur de planificateur qui peut exécuter des actions spécifiques à des intervalles définis, ou sur
une base de temps.
La création d'un emploi du temps est généralement un processus en deux étapes :
1. Vous créez un calendrier avec une liste d'actions à exécuter lorsque l'événement programmé se produit. Vous faites
cela dans l'éditeur du planificateur.
2. Vous créez une interface utilisateur d'exécution qui permet à l'utilisateur final de modifier les paramètres pour
chaque calendrier. Vous faites cela en ajoutant un widget Planificateur à une page de votre projet et la configuration
pour l'adapter aux besoins de planification de l'utilisateur.
Créer un ordonnancement
210
Ordonnancement Haute Fréquence
210
Ordonnancement des tâches répétitives
211
Configurer un emplacement pour les ordonnancements
213
Configurer le widget planificateur
213
Ordonnancement des événements à l’exécution
214
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
209
Créer un ordonnancement
Créer un ordonnancement
Chemin : VueProjet> Configuration > double-cliquez sur Planificateur
l
Cliquez sur + pour ajouter un ordonnancement.
Paramètres d'ordonnancement
Paramètre
Description
ID
Code unique assigné automatiquement à l'ordonnancement
Nom
Nom de l'ordonnancement
Type
Type d'ordonnancement :
l
Répétitif, voir "Ordonnancement des tâches répétitives" on the facing page pour plus de détails.
l
Haute Fréquence, voir "Ordonnancement Haute Fréquence" below pour plus de détails
Ordonnancer Paramètres et options du planificateur. Voir "Ordonnancement des tâches répétitives" on the facing
page pour plus de détails.
Action
Actions devant être exécutées à un moment programmé
Priorité
Niveau de priorité pour l'événement. Si deux ordonnancements se produisent au même moment,
l'événement avec la priorité la plus haute sera exécuté en premier.
Ordonnancement Haute Fréquence
L'ordonnancement Haute Fréquence sert à exécuter des actions qui demandent à être répétées à des intervalles donnés.
L'intervalle entre les exécutions est défini en millièmes de seconde dans la colonne Ordonnancement.
Note : Vous ne pouvez pas modifier les paramètres de ce type d'ordonnancement en cours d'exécution. Si vous
devez modifier les paramètres de temps d'action en cours d'exécution, sélectionnez Ordonnancement répétitif
et configurez le Type sur Toutes les. Voir "Ordonnancement des tâches répétitives" on the facing page pour
plus de détails.
210
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
21 Planificateur
Ordonnancement des tâches répétitives
L'ordonnancement des tâches répétitives est utilisé pour exécuter des actions à des moments précis. Les paramètres
peuvent être modifiés en cours d'exécution.
Paramètres du planificateur des tâches répétitives
Paramètre
Description
Type
Fréquence des actions planifiées
Mode
Paramètres spécifiques demandés par chaque type de planificateur
Condition
Une variable booléenne (vrai/faux) pour activer les actions spécifiées au moment où la minuterie se
déclenche. Les actions seront exécutées si la variable = vrai. Par défaut, les actions sont exécutées
lorsque la minuterie se déclenche.
Note : Seules les variables associées au type de données booléennes apparaissent.
Actions
Actions devant être exécutées par l'ordonnancement.
Important : Les actions et les paramètres d'ordonnancement ne peuvent pas être
modifiés pendant l'exécution
Date
Date à laquelle les actions planifiées seront exécutées
Heure/Décalage
Ce champ montre l'une des données suivantes :
Heure = moment où les actions planifiées seront exécutées
Décalage = retard ou avance par rapport au mode sélectionné.
Emplacement
Lieu de référence pour calculer l'heure de lever/coucher du soleil.
jours de la
semaine
Jours de la semaine où les actions planifiées seront exécutées.
Au moment du
démarrage
Exécute l'ordonnancement au démarrage
Activer
Active/désactive l'ordonnancement
ordonnancement
Exécuter
seulement au
démarrage
Exécute l'ordonnancement une fois seulement au démarrage
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
211
Ordonnancement des tâches répétitives
Options du type d'ordonnancement
Option
Description
Par date
Les actions sont exécutées à la date et à l'heure spécifiés.
Journalier
Les actions sont exécutées quotidiennement à l'heure spécifiée.
Chaque
Les actions sont exécutées selon l'intervalle spécifié (Plage : 1 s-1 jour)
Horaire
Les actions sont exécutées chaque heure, à la minute spécifiée.
Mensuel
Les actions sont exécutées chaque mois, à la date et à l'heure spécifiés.
Hebdomadaire
Les actions sont exécutées chaque semaine, au(x) jour(s) et heures spécifiés.
Annuel
Les actions sont exécutées chaque année à la date et à l'heure spécifiés.
Options du mode d'ordonnancement
Option
Description
Heure
Dépend du type d'ordonnancement. Permet de préciser les informations sur la
date/heure/semaine.
Aléatoire10
Les actions sont exécutées selon un intervalle de 10 minutes avant ou après l'heure définie.
Si, par exemple, l'heure définie est 10:30, les actions pourront être exécutées à tout moment
entre 10:20 et 10:40.
Aléatoire20
Les actions sont exécutées selon un intervalle de 20 minutes avant ou après l'heure définie.
Si, par exemple, l'heure définie est 10:30, les actions pourront être exécutées à tout moment
entre 10:10 et 10:50.
Aurore+
Les actions sont exécutées selon le délai spécifié après le lever du soleil. Ce délai s'exprime
en minutes/heures et l'heure de lever du soleil dépend du lieu.
Aurore-
Les actions sont exécutées selon le délai spécifié avant le lever du soleil. Ce délai s'exprime
en minutes/heures et l'heure de lever du soleil dépend du lieu.
Crépuscule+ Les actions sont exécutées selon le délai spécifié après le coucher du soleil. Ce délai
s'exprime en minutes/heures et l'heure de coucher du soleil dépend du lieu.
Crépuscule-
Les actions sont exécutées selon le délai spécifié avant le coucher du soleil. Ce délai
s'exprime en minutes/heures et l'heure de coucher du soleil dépend du lieu.
Voir "Configurer un emplacement pour les ordonnancements" on the facing page pour plus de détails sur les paramètres
lever du soleil et coucher du soleil.
Note : Les options de mode ne sont pas disponible pour tous les types d'ordonnancement.
212
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
21 Planificateur
Configurer un emplacement pour les ordonnancements
Les actions programmées peuvent être configurées pour être exécutées à un moment donné par rapport au lever et/ou au
coucher du soleil. Pour ce faire, vous devez définir la localisation correcte, selon les informations UTC. Le système calcule
automatiquement l'heure du lever du soleil et du coucher du soleil.
Seules quelques localisations sont disponibles par défaut. Si votre localisation n'est pas listée, vous pouvez l'ajouter en
entrant la latitude, la longitude et les informations UTC dans le fichier Target_Location.xml.
Important : Chaque plateforme a son propre fichier Target_Location.xml.
Position des fichiers de localisation
Application
Chemin des fichiers de localisation
AGI Creator
DEIF\AGI Software Pack\languages\shared\studio\config\Target_Location.xml
Périphériques IHM
DEIF\AGI Software Pack\runtime\<HW Platform>\config\Target_Location.xml
Simulateur
DEIF\AGI Software Pack\simulator\config\Target_Location.xml
AGI PC Runtime
DEIF\AGI Software Pack\server\config\Target_Location.xml
Par exemple, les informations pour la ville de Vérone (Italie) sont affichées ci-dessous :
Les informations de localisation sont aussi affichées dans la boîte de dialogue, avec les heures de coucher et de lever du
soleil.
Configurer le widget planificateur
Pour afficher les données du planificateur sur une page :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
213
Ordonnancement des événements à l’exécution
1. Glissez-déposez un widget Planificateur depuis la galerie des widgets dans la page.
2. Dans le volet Propriétés, cliquez sur + pour le paramètre Nom : la boîte de dialogue Liste d'ordonnancement
s'affiche.
3. Ajoutez tous les ordonnancements que vous voulez afficher sur la page.
4. Dans le volet Propriétés, personnalisez tous les paramètres.
Paramètres des planificateurs
Paramètre
Description
Nom
Ordonnancement à afficher
Colonnes
Colonnes à afficher et leurs caractéristiques
Afficher en-tête
Affiche/masque les en-têtes des colonnes
Spéc heure
Heure à afficher en cours d'exécution
Texte
Police utilisée pour le texte
Affichage
Styles de tableaux
Ordonnancement des événements à l’exécution
Au moment de l'exécution, vous pouvez modifier les paramètres d’ordonnancement suivants.
214
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
21 Planificateur
Paramètre
Description
Occurrence
Informations sur le type de programme et l'heure d'exécution
Condition
Condition appliquée à l'exécution de l'action
Activer
Active/désactive l'exécution des actions programmées sans supprimer le calendrier.
Voir "Ordonnancement des tâches répétitives" on page 211 pour plus de détails sur les paramètres de l’ordonnanceur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
215
Ordonnancement des événements à l’exécution
216
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe
utilisateur
Vous pouvez restreindre l'accès à divers widgets et opérations en configurant les utilisateurs, les groupes d'utilisateurs et
en attribuant des autorisations spécifiques à chaque groupe.
Chaque utilisateur doit être membre d'un seul groupe. Chaque groupe dispose d'autorisations et de permissions
spécifiques.
Les autorisations et les permissions sont divisées en deux catégories :
l
Permissions de widget : cache, lecture seule, accès total
l
Permissions d’action : autorisé ou non autorisé.
En organisant les permissions et les groupes, vous pouvez définir les options de sécurité d’un projet.
Activer/désactiver la gestion de sécurité
219
Configurer groupes et autorisations
219
Modifier permissions d’accès
220
Assigner des permissions par widget à partir du mode Page
225
Configurer utilisateurs
226
Utilisateur par défaut
227
Gestion des utilisateurs à l'exécution
227
Imposer la connexion à distance
228
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
217
218
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Activer/désactiver la gestion de sécurité
Chemin : VueProjet> faites un clic droit sur Sécurité> Activer
Le symbole du cadenas indique si la fonction est activée ou désactivée.
Important : Les paramètres de sécurité fonctionnent uniquement si la fonction Sécurité est activée.
Configurer groupes et autorisations
Chemin : VueProjet> Sécurité > double-cliquez sur GroupesUtilisateurs
Trois groupes prédéfinis sont disponibles par défaut (administrateur, invité et non autorisé) : ils ne peuvent pas être
effacés ou renommés. Cependant, vous pouvez modifier les autorisations et les autres paramètres.
Ajouter un groupe d'utilisateurs
Cliquez sur + pour ajouter un groupe d'utilisateurs.
Paramètre
Description
Nom
Nom du groupe d'utilisateurs
Autorisé
Autorisation accordée
Page d'accueil
Page affichée lorsque les utilisateurs appartenant à ce groupe se connectent
Utiliser la
dernière page
visitée
Lorsque ce paramètre est sélectionné, la dernière page affichée par l'utilisateur précédent s'affiche
lorsque les utilisateurs appartenant à ce groupe se connectent
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
219
Modifier permissions d’accès
Paramètre
Description
Commentaires
Tout commentaire ou toute description pour le groupe
Paramètres des
autorisations
Ouvre la boîte de dialogue Autorisation Administrateur pour définir les permissions d'accès.
Voir "Modifier permissions d’accès" below pour plus de détails.
Modifier permissions d’accès
Chemin : Affichage du projet> Sécurité> double-cliquez sur Groupes d'utilisateurs > colonne Paramétrage
Autorisation
Cliquez sur le bouton : une boîte de dialogue apparaît avec une liste de widgets et d'actions. Vous pouvez modifier les
permissions d'accès pour chaque élément de la liste.
Permissions d'accès aux widgets
Dans l'onglet Widget, vous pouvez définir les options d'accès au widget au niveau du projet, de la page ou du widget, ce
pour l'ensemble des widgets utilisés dans le projet. Les permissions des niveaux inférieurs (par exemple, au niveau du
widget) écrasent celles des niveaux supérieurs (c'est à dire, les niveaux de page et de projet).
Utilisez les Paramètres de base pour définir les permissions par défaut au niveau du projet.
Les paramètres possible sont :
l
Accès complet pour autoriser l'accès au widget en mode lecture/écriture
l
Lecture seule pour n'autoriser l'accès au widget qu'en mode lecture
l
Masquer pour cacher le widget pour le groupe sélectionné
220
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Modifier une permission d'accès à un widget
Pour modifier une permission d'accès à un widget spécifique dans une page du projet, naviguez jusqu'à ce widget à
l'intérieur de sa page sur le volet droit et personnalisez ses options d'accès. À défaut, tous les widgets comportent les
permissions définies au niveau du projet ou de la page.
Par exemple, si la permission de page pour un widget a été accordée en mode Lecture Seule au niveau du projet,
l'ensemble des widgets de même type comporteront une permission Lecture Seule. Lorsque vous sélectionnez un widget
à l'intérieur d'une page à partir de l'arborescence, la permission est configurée sur Utiliser les paramètres de base. Vous
ne pouvez modifier ce paramètre et les permissions d'accès que pour ce widget et dans cette page.
Priorité d'accès
Les permissions d'accès aux widgets suivent les priorités suivantes :
Niveau de permission
Priorité
Niveau du projet - Paramètres de base
Faible
Niveau page
Moyenne
Niveau widget
Élevée
Cela vous permet de définir des exceptions pour une action ou un widget directement à partir de la page affichée.
Par exemple, si vous accordez des permissions Lecture Seule pour un widget au niveau du projet et un Accès Complet au
niveau de la page, les paramètres du niveau page prévaudront.
Les permissions d'accès peuvent être modifiées directement à partir de la page de projet. Voir "Assigner des permissions
par widget à partir du mode Page" on page 225 pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
221
Modifier permissions d’accès
Permissions pour les actions
Dans Onglet Action, vous pouvez définir les autorisations concernant les actions au niveau du projet, de la page ou du
widget. Les actions peuvent être Autorisées ou Non Autorisées.
Les permissions concernant les actions peuvent être modifiées directement à partir de la page de projet. Voir "Assigner des
permissions par widget à partir du mode Page" on page 225 pour plus de détails.
Autorisations FTP
Dans l'onglet Ftp vous pouvez définir des autorisations spécifiques pour le serveur FTP.
222
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Élément
Description
Autoriser Accès
FTP
Active la fonction FTP pour le groupe spécifique
Permission
Type de permission :
l
Read only
l
Lecture-Écriture
Dossier racine
Dossier à utiliser comme racine pour l'accès FTP. C'est un chemin relatif.
Dossier
supplémentaire
Dossiers supplémentaires à utiliser comme racine pour l'accès FTP (par exemple, sur une clé
USB ou une carte SD)
Adresses IP
autorisées
Liste des adresses IP à partir desquelles la connexion FTP peut être acceptée.
Important : Ce paramètre est commun à tous les groupes d'utilisateurs.
Autorisations HTTP
Dans l'onglet HTTP, vous définissez des restrictions à l'accès HTTP au serveur web intégré dans HMI Runtime.
Les métacaractères peuvent être utilisés pour identifier une plage d'adresses IP.
Par exemple, les deux règles suivantes définissent que l'unité de périphérique IHM ne peut être accessible par toutes les
adresses IP 192.168.*.* sur votre réseau local dans lequel seule l'adresse IP 192.168.1.20 peut accéder au périphérique
sans entrer un nom de connexion.
Élément
Description
Liste IP
Adresses IP autorisées à accéder au serveur HTTP. Par défaut, toutes.
Connexion
Lorsque désactivé, le nom d'utilisateur et mot de passe ne sont pas nécessaires.
Limites d'accès
Liste des ressources pour lesquelles l'accès est limité
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
223
Modifier permissions d’accès
L'effet de ces paramètres dépend de si l'option Imposer l'identification à distance a été sélectionnée. Voir "Imposer la
connexion à distance" on page 228 pour plus de détails.
Forcer connexion à
distance
Accès par défaut à
l'espace de travail
Limites d'accès
-
Complet
-
Désactiver
Complet
Peut être utilisé pour bloquer l'accès à certains fichiers/dossiers ou
pour demander l'autorisation
Activer
Pas d'accès
Peut être utilisé pour ouvrir l'accès à des fichiers/dossiers
Important : Ce paramètre est commun à tous les groupes d'utilisateurs.
Ajout d'une configuration HTTP
Pour ajouter et configurer un nouvel accès, cliquez sur + : la boîte de dialogue Limites d'accès s'affiche.
Pour restaurer la configuration par défaut, cliquez sur l'icône Configurer les limites d'accès par défaut. La configuration
par défaut permet d'accéder aux éléments suivants :
l
Dossier PUBLIC et Index.html
Paramètres divers
Dans l'onglet Divers, vous pouvez définir différents paramètres d'autorisation.
Note : Certains de ces paramètres sont spécifiques à un groupe, d'autres sont communs pour tous les groupes.
224
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Option
Description
Passage au mode de
configuration
possible
Permet de passer du runtime au mode configuration. Normalement utilisé pour la
maintenance.
Gestion des autres
utilisateurs possible
Attribue des privilèges de super-utilisateur dans le cadre de l'exécution pour gérer les groupes
sélectionnés. Permet d'ajouter, supprimer et modifier les permissions des utilisateurs.
Chargement des
paramètres usine
possible
Restaure les paramètres d'usine.
Zoom autorisé
Permet de zoomer ou de dézoomer dans le menu contextuel pendant l'exécution
Affichage des
journaux possible
Permet à l'utilisateur de consulter les journaux pendant l'exécution
Création de
Permet à l'utilisateur de sauvegarder un projet.
sauvegardes autorisée
Nombre autorisé
d'utilisateurs
connectés
Nombre maximum d'utilisateurs pouvant être connectés au runtime IHM au même moment.
Par défaut = 3.
Assigner des permissions par widget à partir du mode
Page
Vous pouvez assigner différents niveaux de sécurité pour un seul widget à différents groupes d'utilisateurs, directement à
partir des pages du projet.
1. Faites un clic droit sur le widget et sélectionnez Paramètres de sécurité.
2. Choisissez le groupe : la boîte de dialogue d'autorisation pour le groupe s'affiche.
3. Définissez les propriétés de sécurité pour accéder au widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
225
Configurer utilisateurs
Voir "Modifier permissions d’accès" on page 220 pour plus de détails.
Configurer utilisateurs
Chemin : VueProjet> Sécurité > double-cliquez sur Utilisateurs
Dans l'éditeur Utilisateurs, cliquez sur + pour ajouter un utilisateur : une ligne est ajoutée au tableau.
226
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Paramètre
Description
Nom
Identifiant
Utilisateur par défaut
Cet utilisateur est automatiquement connecté au démarrage du système ou après qu'un
autre utilisateur s'est déconnecté. Un seul Utilisateur par défaut peut être défini.
Groupe
Groupe utilisateur
Mot de passe
Mot de passe de l'utilisateur
Changer mot de passe
initial
Cet utilisateur doit modifier son mot de passe lors de sa première connexion.
Commentaires
Description détaillée de l'utilisateur
Temps de déconnexion
Minutes d'inactivité après lesquelles l'utilisateur est déconnecté. Définir à 0 pour
désactiver.
Nombre de caractères
minimum du mot de
passe
Nombre de caractères minimum du mot de passe
Doit contenir des
caractères spéciaux
Le mot de passe doit contenir au moins un caractère spécial.
Doit contenir des chiffres
Le mot de passe doit contenir au moins un chiffre.
Utilisateur par défaut
Vous ne pouvez définir qu'un utilisateur par défaut dans un projet. Il s'agit de l'utilisateur connecté automatiquement au
démarrage du système et lorsque l'utilisateur actuellement connecté se déconnecte ou est déconnecté après un délai
d'attente.
Pour se connecter à HMI Runtime avec un utilisateur différent, utilisez une de ces actions :
l
ChangerUtilisateur
l
Déconnexion
Voir "Actions de gestion des utilisateurs" on page 135pour plus de détails.
Gestion des utilisateurs à l'exécution
L'utilisateur par défaut est, le cas échéant, automatiquement connecté au démarrage du runtime IHM. Si aucun utilisateur
par défaut n'a été configuré, le système demande un identifiant et un mot de passe. Voir "Actions de gestion des
utilisateurs" on page 135pour plus de détails sur les actions pouvant êtres exécutées sur les utilisateurs.
Supprimer les données d'utilisateur
Toutes les informations d'utilisateur modifiées à l'exécution sont stockées dans des fichiers dédiés. Pour supprimer ces
fichiers dynamiques ainsi que l'ensemble des modifications apportées à la configuration de l'utilisateur pendant l'exécution,
vous pouvez :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
227
Imposer la connexion à distance
l
l
sur le runtime IHM : exécuter l'action SuppressionFichiersDynamiquesUM
avec AGI Creator: sélectionner Suppression des fichiers dynamiques dans la boîte de dialogue de
téléchargement.
Imposer la connexion à distance
Chemin : Affichage du projet> cliquez avec le bouton droit sur Sécurité> Imposer l'identification à distance
Sélectionnez cette option pour forcer l'utilisateur à se connecter lorsqu'il utilise l'accès à distance via AGI Client. Si vous
ne la sélectionnez pas, l'accès à distance utilisera le même niveau de protection que l'accès local.
Important : Cette fonction ne fonctionne que quand la gestion utilisateur est désactivée.
Astuce : Utilisez cette option lorsque vous avez un utilisateur par défaut mais que vous souhaitez sécuriser
l'accès à distance.
Voir "Activer/désactiver la gestion de sécurité" on page 219pour plus de détails.
Les seuls fichiers/dossiers encore accessibles lorsque ce drapeau est activé sont :
l
Dossier PUBLIC et Index.html.
Voir "Modifier permissions d’accès" on page 220 pour plus de détails sur les limites d'accès HTTP.
228
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
23
Journaux d’audit
Le journal d’audit est une séquence chronologique d'entrées d'audit. Chaque entrée contient des informations sur les
actions exécutées et sur l'utilisateur qui les a réalisées.
Cette fonction fournit le suivi du processus, l'identification de l'utilisateur et l'horodatage des événements.
Si la Gestion des utilisateurs est activée, les actions sont tracées ensemble avec le même nom d'utilisateur. Seul
l'administrateur peut modifier ce paramètre.
Activer/désactiver le journal d’audit
230
Configurer les événements d'audit
230
Configurer les variables pour le journal d’audit
231
Configurer les alarmes pour le journal d’audit
232
Configurer les recettes pour le journal d’audit
232
Configurer les détails de connexion/déconnexion
233
Exporter le journal d’audit au format .csv
233
Afficher les journaux d’audit
234
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
229
Activer/désactiver le journal d’audit
Activer/désactiver le journal d’audit
Chemin : VueProjet> faites un clic droit sur Journal d’audit> Activer
Le symbole du cadenas indique l'état de la fonction.
Configurer les événements d'audit
Vous avez plus d'un ensemble d'entrées d'audit. Vous devez configurer une mémoire d'événements dédiée.
Créer une mémoire d'événements
Chemin : VueProjet> Configuration > double-cliquez sur Mémoire d'événements
230
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
23 Journaux d’audit
1. Dans l'éditeur Mémoire d'événements, cliquez sur + : une ligne s'ajoute au tableau.
2. Sélectionnez Audit pour Type.
3. Configurez les paramètres de mémoire tampon.
Paramètre
Description
ID
Numéro d'identification mémoire tampon
Nom
Nom de mémoire tampon
Activer
Activer/désactiver l'enregistrement
Taille
Taille du fichier journal. Les données sont automatiquement sauvegardées sur un disque
toutes les 5 minutes.
Type
Type d'événements enregistrés :
Périphérique de
stockage
l
Alarmes
l
Audit
l
Générique
Périphérique où les données d'audit sont stockées
Configurer les variables pour le journal d’audit
Chemin : VueProjet> Journal d’audit> cliquez sur Journal d'audit
Suivez uniquement les variables liées aux actions que vous voulez garder sous contrôle. Pour les variables suivies, toutes
les opérations d'écriture seront enregistrées avec l'horodatage et l'utilisateur qui a réalisé l'opération.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
231
Configurer les alarmes pour le journal d’audit
Configurer les alarmes pour le journal d’audit
Chemin : VueProjet> Journal d’audit> cliquez sur Journal d'audit
Vous pouvez spécifier quelles alarmes doivent être suivies par le journal d’audit.
1. Dans l'éditeur Journal d’audit, sélectionnez l'onglet Alarmes.
2. Sélectionnez toutes les alarmes à connecter au journal d’audit : toutes les opérations réalisées sur les alarmes
spécifiées seront connectées.
Configurer les recettes pour le journal d’audit
Chemin : VueProjet> Journal d’audit> cliquez sur Journal d'audit
Suivez uniquement les recettes liées aux actions que vous voulez garder sous contrôle. Pour les recettes suivies, toutes
les opérations de transfert seront enregistrées avec l'horodatage et l'utilisateur qui a réalisé l'opération.
232
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
23 Journaux d’audit
Configurer les détails de connexion/déconnexion
Chemin : VueProjet> Journal d’audit> cliquez sur Journal d'audit
Le journal d’audit peut tracer des informations sur les événements de connexion et de déconnexion de l'utilisateur.
1. Dans l'éditeur Journal d’audit, sélectionnez l'onglet Divers.
2. Sélectionnez les informations que vous voulez enregistrer.
3. Si vous créez d'autres mémoires d'événements de type Audit, vous pouvez les choisir depuis la liste déroulante
Mémoire d'événements ou vous pouvez laisser la valeur Journal d’audit qui utilise la mémoire tampon par défaut.
Exporter le journal d’audit au format .csv
Pour afficher les données du journal d’audit, vous devez les exporter au format .csv avec l'action
ViderArchiveÉvénement. Voir "Actions système" on page 123 pour plus de détails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
233
Afficher les journaux d’audit
Structure du fichier
Le fichier des données exportées contient les éléments suivants :
Type
d'événement
Pour utilisation interne
Sous-type
Horodatage
Horodatage d’événement. L'heure peut être configurée comme heure locale ou globale pour l'action
de vidage.
Interface
LOCALE, lorsque l'action est réalisée en HMI Runtime.
CGI, lorsque l'action est réalisée par un client à distance.
Action
Action exécutée.
Informations
État de l'action et opération exécutée. Par exemple, écrivez variable - variable1:50
Afficher les journaux d’audit
Les données de journal d'audit doivent être exportées comme un fichier de données pour affichage.
Voir "Exporter le journal d’audit au format .csv" on the previous page pour plus de détails.
234
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
24
Rapports
Un rapport est une collection d'informations dont l'impression est déclenchée par un événement. Lorsqu'un événement
programmé se produit, l'impression se déclenche en arrière-plan.
Vous pouvez configurez les rapports, leurs contenus, les conditions de déclenchement et l'imprimante de sortie dans
l'éditeur de rapport.
Tous les widgets ne peuvent pas être utilisés dans les rapports. Lorsque vous configurez vos rapports, AGI Creatorfournit
l'accès à une galerie de widgets spécifique où n'apparaissent que les widgets disponibles pour les rapports.
Le format des rapports peut être personnalisé à l'aide de modèles de mise en page prédéfinis.
Note : L'impression des rapports n'est pas supportée par AGI Client.
Ajouter un rapport
236
Configurer les rapports de texte
236
Configurer les rapports graphiques
237
Événements déclencheurs d'impression
238
Imprimante par défaut
239
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
235
Ajouter un rapport
Ajouter un rapport
Chemin : VueProjet> Configuration > double-cliquez sur Rapports
Dans l’éditeur des Rapports, cliquez sur RApport graphique ou Rapport texte : une nouvelle ligne est ajoutée au
tableau.
Types de rapport
Type de
rapport
Description
Rapports
texte
Utilisés pour l'impression ligne par ligne d'alarmes.
Utilisés uniquement pour des imprimantes par ligne.
Le texte est envoyé à l'imprimante sans pilote spécifique.
Important : Ce mode d'impression requiert l'utilisation d'un port physique et fonctionne
uniquement sur les plateformes Windows CE.
Rapports
Ils contiennent des éléments graphiques et peuvent inclure des widgets complexes tels que des captures
graphiques d'écran ou des alarmes.
Important : Chaque imprimante requiert un pilote d'imprimante spécifique. Voir
"Configurer les rapports graphiques" on the facing page pour consulter la liste des
pilotes d'imprimante pris en charge.
Configurer les rapports de texte
Utilisez l'éditeur de Rapports. Taille du papier en nombre de caractères.
Réglage des options d’impression
Utiliser les options de l'imprimante pour contrôler affleurement de pages sur l'imprimante.
L'impression commence immédiatement ou après un délai d'attente. Dans les options d'impression, vous pouvez forcer
l'affleurement dès qu'une condition spécifique se produit, après un certain nombre d'événements, de lignes ou de
secondes.
Note : Les rapports de texte ne prennent pas en charge le format PDF.
Réglage de la mise en page des alarmes
La Taille du papier est la largeur du papier en nombre de caractères.
Ajout de champs au rapport
Pour ajouter un élément au rapport, faites-le glisser et déposez-le sur la page de modèle dans la liste des Champs
disponibles.
236
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
24 Rapports
Recadrage du champ à l'aide de la souris, un outil de pointe montre la dimension en nombre de caractères.
Note : Si le texte ne tient pas dans l'espace dédié, l'enveloppe automatique est appliquée.
Configurer les rapports graphiques
Utilisez l'éditeur de Rapport pour configurer les rapports graphiques.
Ajouter une page de rapport
Cliquez sur + pour ajouter une nouvelle page au modèle de rapport.
Quand la souris va sur une page, deux icônes s'affichent et permettent de réordonner ou de supprimer les pages.
Modifier le contenu de la page de rapport
1. Double-cliquez sur une page pour modifier son contenu : l'éditeur de Rapport graphique apparaît.
Chaque page se subdivise en : en-tête, pied de page et corps de la page.
2. Double-cliquez sur la zone que vous souhaitez modifier : la zone à modifier apparaît en blanc, tandis que les autres
sont grisées.
La Galerie des widgets est sensible au contexte et n'affiche que les widgets disponibles pour la zone que vous êtes en train
de modifier.
Widgets disponibles pour les rapports
Widgets pouvant être utilisés pour un rapport graphique :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
237
Événements déclencheurs d'impression
Widget
Fonction
Numéro
de page
Numérotation de page automatique
Capture
d'écran
Capture d'écran de la page actuellement affichée sur le périphérique IHM. La page de rapport est
automatiquement redimensionnée pour s'adapter à la page du périphérique IHM.
Note : L'intégralité de l'écran est imprimée, y compris les boîtes de dialogue ouvertes.
Alarme
La totalité du contenu de la mémoire d'événements (la mémoire tampon par défaut est Alarm Buffer1).
Texte
Les widgets tels que les labels et les champs numériques
Événements déclencheurs d'impression
L'impression des rapports peut être déclenchée par des événements.
Configurer l'impression d'alarme
Chemin : VueProjet> Configuration > double-cliquez sur Alarmes
1. Dans l'Éditeur d'alarme, ouvrez la boîte de dialogue Types d'événements à partir de la colonne Événements.
2. Dans l'onglet Impression, sélectionnez toutes les conditions dont vous souhaiteriez qu'elles déclenchent une
impression.
Important : Il n'est possible de définir qu'un seul rapport en tant que Rapport d'alarme active au sein
d'un projet et ce rapport peut se présenter sous forme de texte ou de graphique.
238
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
24 Rapports
Ajustement des paramètres de l'imprimante pendant l'exécution
L'impression d'un rapport graphique peut également être lancée en utilisant l'action PrintGraphicReport.
Configurez la propriété silencieux de l'action sur faux pour faire apparaître la boîte de dialogue.
Imprimante par défaut
Paramètres de l'imprimante
Vous pouvez définir une imprimante par défaut pour tous les rapports graphiques. Chaque rapport peut ensuite être
configuré pour utiliser l'imprimante par défaut ou toute autre imprimante disponible. Cliquez sur le bouton Paramètres de
l'imprimante pour définir les paramètres de l'imprimante.
Pour les imprimantes PDF, vous définissez aussi le dossier de sauvegarde des fichiers avec Emplacement des fichiers
imprimés.
Imprimantes prises en charge
Liste d'imprimantes et de langages d'imprimantes pris en charge par le pilote de Windows CE printCE.dll. Les imprimantes
qui ne figurent pas sur la liste mais qui sont compatibles avec ces langages sont prises en charge.
Imprimante
Langages
HP PCL 3, HP PCL 5e, HP
PCL3GUI
HP PCL3/PCL5e/PCL3GUI, notamment DeskJet, LaserJet et
DesignJet
Epson ESC/P2
ESC/P2 et LQ
Epson Stylus Color
Epson Stylus Color
Epson LX (9 broches)
Imprimantes 9 broches, Epson LX, FX et PocketJet
Cannon iP100, iP90, BubbleJet
BubbleJet, iP90 et iP100
PocketJet II, 200, 3
Pocket Jet
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
239
Imprimante par défaut
Imprimante
Langages
MTE Mobile Pro Spectrum
MTE Mobile Pro Spectrum
Fichier Adobe PDF
Fichier Adobe PDF
SPT-8
SPT-8
M1POS
M1POS
MP300
MP300
Zebra
Langage Zebra CPCL
Intermec PB42, PB50, PB51, PB2,
PB3
Intermect PB42/50/51/2/3 avec langage ESC/P
Datamax Apex
Datamax Apex
Ports pris en charge
Les ports suivants sont pris en charge :
l
LPT1 (imprimantes USB)
l
Fichier (PDF)
Note : Sur la plateforme Win32, seules les imprimantes PDF et celles par défaut sont prises en charge.
L'imprimante par défaut est l'imprimante par défaut du système d'exploitation. Elle peut être connectée avec tout
type de port (pas uniquement USB).
Imprimantes testées
Les imprimantes suivantes ont été testées avec les pilotes printCE sur les périphériques IHM sous Windows CE.
Pilote
Modèle de l'imprimante
Graphique Ligne
Personnalisé Plus 4 Kube II
Oui
Oui
Epson
ESC/P 2
Epson AcuLaser M2310
Oui
Simuler
Epson LX
(9 broches)
Epson LX-300+II
Non
Oui
HP PCL 3
HP LaserJet P2015dm
Oui
Simuler
HP LaserJet 4700dtn
Oui
Oui
HP Deskjet 1010
Oui
Non
HP Deskjet D5560
Oui
Non
HP LaserJet 4700dtn
Non
Oui
HP LaserJet P2015dm
Oui
Simuler
HP PCL 3
GUI
HP PCL 5e
HP LaserJet 4700dtn
240
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
24 Rapports
Pilote
Modèle de l'imprimante
Graphique Ligne
INTERMEC
Intermec PB50 avec langage ESC/P avec du papier en rouleau de
4 pouces (environ 10 cm).
Oui
Oui
Oui
Non
Note : Le périphérique IHM se bloque lorsque vous
essayez d'imprimer avec les imprimantes Intermec PB50
en mode veille après une première impression réussie.
PDF
-
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
241
Imprimante par défaut
242
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
25
Écran de veille
L'écran de veille peut être utilisé pour afficher un diaporama lorsque le périphérique IHM n’est pas utilisé. Le diaporama
commence après un délai d'attente si aucun des événements suivants se produit :
l
écran touché
l
déplacement de la souris
l
touche du clavier externe appuyée
Activation de la fonction d’écran de veille
Chemin : VueProjet> Config > clic droit sur Écran de veille> Activé
Important : Vous devez activer l'économiseur d'écran avant de pouvoir le configurer.
Configuration d’un écran de veille
Chemin : VueProjet> Configuration > double-clic sur Écran de veille
Paramètres du diaporama.
Paramètre
Description
Délai
d'attente
Temps après lequel le diaporama démarre.
Intervalle
Intervalle entre les diapos
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
243
Paramètre
Description
entre les
diapos
Périphérique
de stockage
Emplacement des images utilisées dans le diaporama.
Les images stockées localement sont enregistrées dans workspace\projectname\screensaver et
peuvent être téléchargées sur le périphérique IHM lorsque les projet est téléchargé.
Les images stockées sur les périphériques USB ou SD sont enregistrées dans un dossier d'écran de
veille sur le périphérique même.
Important : Seules les images JPEG et PNG sont prises en charge.
Association d’actions à l'écran de veille
Les actions peuvent être déclenchées par le début et/ou l’arrêt de l'écran de veille.
l
l
Cliquez sur + à côté d'Actions dans l'onglet onStart pour configurer les actions à exécuter lorsque l'écran de veille
démarre.
Cliquez sur + à côté d'Actions dans l'onglet onStop pour configurer les actions à exécuter lorsque l'écran de veille
s’arrête.
244
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
26 Sauvegarder/restaurer le runtime
et le projet
Vous pouvez sauvegarder tout le contenu du périphérique IHM, dont HMI Runtime et le projet, sur une mémoire externe.
Cette copie de sauvegarde peut être utilisée pour restaurer le contenu du périphérique IHM par la suite ou pour le copier
dans un nouveau périphérique IHM.
Cette fonction de sauvegarde est uniquement disponible lorsqu'elle est activée pour l'utilisateur connecté. Voir "Modifier
permissions d’accès" on page 220 pour plus de détails.
Note : La sauvegarde n’est pas supportée dans Win32 / AGI Client.
Fonction de sauvegarde
La fonction de sauvegarde réalise automatiquement la procédure suivante :
1. Décharge le projet en cours pour déverrouiller les fichiers utilisés.
2. Archive le contenu du dossier \QTHMI (qui contient HMI Runtime, les projets, les fichiers dynamiques tels que les
recettes, les alarmes, les tendances, etc.) dans un fichier .zip (standard ou crypté).
3. Recharge le projet.
Pour démarrer la procédure de sauvegarde :
1. Dans HMI Runtime, faites un clic droit pour ouvrir le menu contextuel.
2. Sélectionnez Sauvegarde : la boîte de dialogue Sauvegarde s'affiche.
3. Sélectionnez le chemin de stockage du fichier de sauvegarde.
Note : Le processus de sauvegarde n'inclut pas les fichiers stockés dans des clés USB et dans des cartes SD.
Les données dynamiques telles que les recettes, les tendances ou les événements stockés dans ces
périphériques ne seront pas incluses dans la sauvegarde.
Fonction restauration
La restauration du paquet de sauvegarde peut être effectué sur périphérique IHM
l
depuis le Menu Contextuel (voir "Paquet de mise à jour" on page 81 pour obtenir plus de détails)
l
ou depuis les Paramètres du Système (voir "Paramètres du système" on page 369 pour obtenir plus de détails)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
245
246
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
27
Claviers
De nombreux claviers sont fournis par défaut dans le AGI Creator et peuvent être utilisés pour la saisie de données.
Le clavier alphabétique peut être associé à une utilisation avec un type de données chaîne
Le clavier numérique peut être associé à une utilisation avec un type de données numérique
Le clavier calendrier peut être associé à une utilisation avec un type de données de date
Créer et utiliser des claviers personnalisés
249
Supprimer ou renommer des claviers personnalisés
251
Type de clavier
251
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
247
Emplacement du clavier
248
252
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
27 Claviers
Créer et utiliser des claviers personnalisés
Vous pouvez soit créer un nouveau clavier soit personnaliser un clavier existant.
Créer un clavier
1. Dans VueProjet, faites un clic droit sur Claviers et sélectionnez Insérer clavier : la boîte de dialogue Nouveau
clavier s'affiche.
2. Sélectionnez un des claviers disponible ou Vierge pour créer un clavier de A à Z. Le cas échéant, un clavier vierge
est affiché.
3. Utilisez Widgets clavier et Boutons clavier de la galerie des widgets pour créer votre clavier personnalisé.
Comme dans cet exemple, le clavier que vous créez est sauvegardé dans le dossier du projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
249
Créer et utiliser des claviers personnalisés
Associer des claviers personnalisés à des champs
Les claviers personnalisés peuvent être réutilisés pour tout champ où la propriété Clavier pointe dessus, comme dans
l'exemple.
Astuces avec les claviers personnalisés
Par défaut, le clavier numérique est assigné à tous les widgets numériques (écrire/lire un champ numérique).
Si vous voulez appliquer une version personnalisée du clavier numérique à tous les widgets numériques que vous ajoutez à
votre projet, procédez de la façon suivante :
1. Créez un nouveau clavier et sélectionnez Numérique comme type de Clavier. C'est une sauvegarde des
paramètres d'origine pour le clavier numérique.
2. Personnalisez le clavier numérique par défaut et enregistrez-le. Cette version personnalisée du clavier numérique
est assignée par défaut dans le projet.
Voir "Supprimer ou renommer des claviers personnalisés" on the facing page pour des détails sur la façon de renommer un
clavier personnalisé.
Flèches haut-bas du clavier
Ce type de clavier est particulièrement utile pour déplacer le curseur de haut en bas dans un widget qui requiert cette
fonctionnalité. Voici un exemple avec le widget Liste de contrôle. Voir "Widgets de liste de contrôle" on page 282 pour
plus de détails.
250
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
27 Claviers
Supprimer ou renommer des claviers personnalisés
Dans VueProjet, faites un clic droit sur un clavier personnalisé et sélectionnez une des options suivantes :
l
Supprimer page de clavier pour supprimer le clavier du projet
l
Renommer page de clavier pour renommer le clavier.
Type de clavier
Chemin : Affichage du projet> Claviers > double-cliquez sur un clavier > Propriétés
Configurez le paramètre Type de clavier pour un clavier afin de définir le type de saisie de données.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
251
Emplacement du clavier
Type de
clavier
Description
Auto
Paramètres par défaut
Décimal
Seuls les touches numériques sont acceptées. En entrant 10, le clavier retourne 10, qui
s'affichera comme « 10 » si le champ associé est numérique ou ASCII, comme 'A' si le
fichier associé est hexadécimal.
Hexadécimal Seules les touches hexadécimales sont acceptées. En entrant 10, le clavier retourne 16, qui
s'affichera comme « 16 » si le champ associé est numérique ou ASCII, comme « 10 » si le
champ associé est hexadécimal.
Ascii
Toutes les touches sont acceptées. En entrant 1A, le clavier retourne 1A, qui s'affichera
comme « 1 » si le champ associé est numérique,comme « 1A » si le champ associé est
ASCII ou hexadécimal.
Emplacement du clavier
La propriété Emplacement de runtime des claviers peut être utilisée pour définir l'emplacement des claviers sur l'écran.
Option
Description
Automatique
Sélection du meilleur emplacement en fonction de l'endroit où la saisie de données est
requise.
Absolu
Des coordonnées X,Y sont renseignées pour définir l'emplacement exact
Gauche-haut
Emplacements écran prédéfinis
Gauchecentre
Gauche-bas
Centre-haut
Centre-centre
Centre-bas
Droite-haut
Droite-centre
Droite-bas
Sélectionnez l'option Verrouiller l'emplacement du clavier pour empêcher le déplacement du clavier par glissement.
252
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
28
Claviers externes
HMI Runtime a été conçu pour fonctionner avec des claviers externes connectés via USB.
Les claviers peuvent être utilisés pour :
l
l'entrée de données (par défaut)
l
l'exécution d'actions associées à des touches spécifiques
Par exemple, l'événement OnClick sur la flèche droite peut être associé à l'action LoadPage.
Le clavier peut être programmé au niveau du projet pour que les paramètres soient hérités par toutes les pages. Dans
chaque page, vous pouvez ensuite choisir quel paramètre de touche est hérité depuis le projet et quel paramètre est
personnalisé pour la page spécifique.
Ouvrir des claviers externes
1. Sur l'éditeur de page, cliquez sur l'icône à droite de Clavier/Script, en bas de l'espace de travail : l'éditeur
Clavier/Script s'affiche.
2. Sélectionnez l'onglet Clavier.
Chaque ligne dans l'éditeur de clavier correspond à une touche.
Pour chaque touche, les informations suivantes sont affichées :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
253
Élément
Description
Label
Nom de la touche
Code
Code de la touche
Activer
État d'activation de la touche
Hérite des actions du projet
Définit si la touche hérite de l'action programmée au niveau du projet
Voici les configurations possibles :
Hérite
des
Activer
actions
du projet
Comportement HMI
Runtime
Apparence d'éditeur
Vérifié
Non
vérifié
Les listes d'action affichent les actions de page (ou rien si la
liste est vide)
Seules les actions de
page (le cas échéant)
sont exécutées.
Vérifié
Vérifié
Les listes d'action affichent uniquement les actions du projet Seules les actions de
et ne peuvent pas être éditées
page (le cas échéant)
sont exécutées.
Non
vérifié
Vérifié
Hérite de la case à cocher des actions de projet et toutes les Aucune action de page
listes d'action sont désactivées. Les listes d'action affichent ou de projet n'est
uniquement les actions du projet.
exécutée.
Non
vérifié
Non
vérifié
Hérite de la case à cocher des actions de projet et toutes les Aucune action de page
listes d'action sont désactivées. Les listes d'action affichent ou de projet n'est
uniquement les actions du projet.
exécutée.
Rechercher et filtrer
255
Touches affichées
255
Retirer des associations d'actions
255
Mise en page du clavier
256
Activer/désactiver clavier
256
Associer des actions à des touches
256
254
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
28 Claviers externes
Rechercher et filtrer
Pour afficher un ensemble filtré de touches, dans Filtrer par sélectionner le nom clé et tapez une lettre dans le champ de
recherche : seules les touches contenant cette lettre dans leur nom seront affichés dans l'éditeur du clavier.
Comme alternative, dans Filtrer par sélectionner le code clé et tapez une lettre dans le champ de recherche : seules les
clés contenant cette lettre dans leur code seront affichés dans l'éditeur du clavier.
Touches affichées
Vous pouvez facilement sélectionner quelles clés seront répertoriées dans la fenêtre de l'éditeur de Clavier. Pour afficher
un ensemble limité de touches, sélectionnez une option dans Affichage.
Option
Description
toutes les touches
Toutes les touches disponibles dans la configuration du clavier sont
répertoriées
touches modifiées
Seules les touches associées aux actions au niveau de la page sont
répertoriés
touches modifiées dans le
projet
Seules les touches associées aux actions au niveau du projet sont
répertoriées
Retirer des associations d'actions
Pour retirer toutes les associations que vous avez créées entre des touches et des actions :
1. Sélectionnez les touches desquelles vous voulez retirer l'association.
2. Cliquez sur le bouton Effacer toutes les actions des touches sélectionnées.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
255
Mise en page du clavier
Si vous travaillez au niveau d'une page, les actions de la page seront retirées. Si vous travaillez au niveau d'un projet, les
actions du projet seront retirées.
Mise en page du clavier
Sélectionnez la disposition de clavier à partir de la liste déroulante Disposition du clavier. Clavier générique se réfère à
une disposition de clavier générique internationale.
Activer/désactiver clavier
Vous pouvez activer/désactiver les actions du clavier dans le projet et au niveau de la page. Pour activer les actions du
clavier, définissez dans le volet Propriétés le Macro clavier sur Vrai.
Vous pouvez également activer/désactiver les actions du clavier à l'exécution avec l'action KeyboardMacros. Voir
"Actions clavier" on page 107 pour plus de détails.
Associer des actions à des touches
Vous associez des actions à des touches depuis l'éditeur Clavier.
1. Cliquez sur + à côté de la touche que vous voulez programmer : les champs pour la configuration de la touche
s'affichent.
256
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
28 Claviers externes
1. Cliquez sur + pour ajouter des actions.
Vous pouvez associer des actions à l'événement OnClick et à l'événement OnHold.
Voir "Événements" on page 43 pour plus de détails.
Note : Du code JavaScript peut également être associé à un événement-clé.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
257
Associer des actions à des touches
258
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
29
Référence croisée de variables
Le volet Référence croisée des variables affiche une liste de noms de variables utilisées dans le projet en cours organisé
en fonction de leur emplacement et de leur utilisation.
Depuis ce volet, vous pouvez :
l
vérifier où chaque variable est utilisée (alarmes, pages, recettes, planificateurs, tendances, etc.)
l
identifier les références invalides de variable (références aux variables non définies dans l'éditeur de variable)
l
identifier les variables ne sont pas utilisées dans le projet
Note : Le volet Référence croisée de variables ne liste pas les variables utilisées dans le code JavaScript.
Mettre à jour les données dans le volet Référence croisée des variables
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
261
259
Ouvrir le volet Référence croisée des variables
Chemin : Affichage> Barre d'outils et ancrage de fenêtres > Référence croisée de variable
Cliquez sur l'onglet Référence croisée de variable pour ouvrir le volet Référence croisée de variable.
Travailler dans le volet Référence croisée des variables
Le volet Référence croisée des variables fournit un ensemble de fonctions standards.
Élément
Fonction
Grouper par
Variables de groupes par Emplacement (alarmes, pages, tendances, etc.) ou Nom de variables
Afficher
Variables de filtres et affichages :
l
Toutes les références : toutes les variables
l
Référence variables invalide : variables non listées dans l’Éditeur de variables.
l
Variables non utilisées : variables listées dans l’éditeur de variables mais non utilisées
dans le projet.
Recherche de
champ
Appliquer un filtre pour afficher un nombre limité de variables
Filtrer par
Variables de filtres par Emplacement, variable ou Propriété.
Naviguer dans les variables listées pour trouver où elles sont utilisés dans le projet.
Double-cliquez sur une variable pour ouvrir l’éditeur ou la page où elle est Utilisée.
260
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
29 Référence croisée de variables
Mettre à jour les données dans le volet Référence
croisée des variables
Mise à jour manuelle
Par défaut, les informations affichées dans le volet Référence croisée des variables doivent être mises à jour
manuellement. Pour cela, cliquez sur le bouton de rafraîchissement
lorsqu'un rafraîchissement est nécessaire.
. Un signe d'avertissement est affiché
Mise à jour automatique
Chemin : Vue> Propriétés
Vous activez la mise à jour automatique du volet Référence croisée des variables depuis la AGI Creator page Propriétés.
Sélectionnez l’option mise à jour automatique.
Exporter les données
Les données affichées dans le volet Référence croisée des variables peuvent être exportées dans un fichier .csv.
Les données sont organisées dans le fichier exporté selon la manière dont elles sont groupées dans le volet.
Groupées par
Format de fichier
Emplacement
RESSOURCES, BUREAU RESSOURCES, ID WIDGET, ATTRIBUT, variable
Variable
VARIABLE, RESSOURCES, BUREAU RESSOURCES, ID WIDGET, ATTRIBUT
Note : Les séparateurs utilisés lors de l'exportation dépendent des paramètres régionaux de votre ordinateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
261
Mettre à jour les données dans le volet Référence croisée des variables
262
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
30
Adressage indexé
L'adressage indexé vous permet de sélectionner un ensemble de variables dépendant de la valeur d'une autre variable. Il
est par exemple très utile de pouvoir utiliser les mêmes graphiques pour visualiser un ensemble de données provenant de
différentes sources. L'utilisateur n'a plus qu'à sélectionner la source à surveiller parmi une liste.
Générer un ensemble d’adressage indexé
264
Utilisation d’un ensemble de variables indexées sur les pages
267
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
263
Générer un ensemble d’adressage indexé
Générer un ensemble d’adressage indexé
Scénario
Dans ce scénario, les données environnementales sont collectées depuis quatre pièces, chacune équipée de capteurs de
température, de pression et d'humidité. Les données sont disponibles de la façon suivante :
Numéro de chambre
Température
Pression
Humidité
1
Pièce1-Température
Pièce1-Pression
Pièce1-Humidité
2
Pièce2-Température
Pièce2-Pression
Pièce2-Humidité
3
Pièce3-Température
Pièce3-Pression
Pièce3-Humidité
4
Pièce4-Température
Pièce4-Pression
Pièce4-Humidité
En utilisant la fonctionnalité d'adressage indexé, vous pouvez utiliser un seul format de tableau pour organiser toutes les
données dans le périphérique IHM.
Les données provenant des trois capteurs peuvent être affichées sur une seule page, où le numéro de pièce est utilisé
comme sélecteur (liste déroulante) pour choisir le bon ensemble de variables.
Créer un ensemble de variables indexées
Chemin : VueProjet> variables
Pour ce faire, vous devez créer un ensemble de variables indexées.
1. Dans l'Éditeur de variables, définissez les protocoles et les variables. Définissez une variable pour chaque donnée
à indexer, dans cet exemple vous devez créer une variable pour chaque capteur dans chaque pièce.
264
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
30 Adressage indexé
2. Créez une variable à utiliser comme variable indexée. Dans cet exemple, vous créez une variable « NuméroPièce »
qui pourrait être de type UnsignedInt utilisant le protocole Variable.
3. Dans VueProjet, sélectionnez Configuration> variables, puis double-cliquez sur Ensemble de variables
indexées : l'éditeur d'Ensemble de variables indexées s'affiche.
4. Cliquez sur + pour afficher un Ensemble de variables indexées. Dans cet exemple, vous le nommez « Pièce ».
5. Sélectionnez la variable « NuméroPièce » à utiliser comme sélecteur pour le numéro de pièce.
6. Créez une Instance d'index pour chaque ensemble de données. Dans cet exemple, créez-en une pour chaque
pièce.
7. Créez un Alias pour chaque type de données et renommez les colonnes du tableau de manière appropriée. Dans
cet exemple, renommez-les « Température », « Pression » et « Humidité ».
8. Double-cliquez sur chaque cellule pour associer la variable correcte.
Note : Le type de données de variable indexée peut être un nombre, une chaîne, ou tout type de données
simples.
Note : Pour référencer un type de données de tableau, utilisez le tableau index = -1
Fonction de remplissage automatique
Un tableau d'ensemble de variables indexées peut devenir très complexe et le remplir peut conduire à des erreurs. Activez
la fonctionnalité Remplissage automatique pour vous assurer que les alias sont correctement entrés.
Cliquez sur
s'affiche.
pour activer la fonctionnalité Remplissage automatique : le Tableau de remplissage automatique
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
265
Générer un ensemble d’adressage indexé
Cette fonction utilise une expression régulière pour remplir le tableau avec des variables tentant de correspondre au filtre,
où le mot-clé $(Instance) est remplacé par les valeurs Index définies et le mot-clé $(Alias) par les étiquettes d'alias
définies.
Exemple de remplissage automatique
« Room$(Instance)-$(Alias) » correspond à tous les noms de variables :
Pièce1-Température,
Pièce1-Pression,
Pièce1-Humidité,
Pièce2-Température,
…
« Room0*$(Instance)-$(Alias) » correspond à tous les noms de variables :
Pièce1-Température,
Pièce01-Pression,
Pièce001-Humidité,
Pièce2-Température,
Pièce02-Pression,
Pièce002-Humidité,
…
266
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
30 Adressage indexé
Éléments de tableau à remplissage automatique
Élément
Description
Remplir
Remplit les entrées manquantes dans le tableau de variables en utilisant le filtre défini (le cas échéant).
Par exemple, lorsque de nouvelles instances ou de nouveaux alias sont ajoutés, vous pouvez utiliser
cette option pour remplir les nouvelles entrées.
Remplacer
Remplace toutes les entrées du tableau par celles fournies par le tableau à remplissage automatique.
Réinitialiser Réinitialise le filtre de variables pour vider ; aucun remplissage automatique n'est effectué.
Suggère une expression de filtre valide pour votre projet.
Note : Les filtres sont sauvegardés comme préférences de projet et peuvent être définis pour l'ensemble du
tableau ou pour une colonne. Lorsque le filtre est défini pour une colonne, le filtre de tableau est ignoré. Ainsi,
vous pouvez modifier de manière sélective le filtre pour gérer un seul alias en particulier.
Note : Pour référencer les éléments d'un tableau, utilisez le caractère \ pour désactiver l'interprétation de
l'expression régulière des crochets (les variables de tableau sont différenciées en étant en italique).
Utilisation d’un ensemble de variables indexées sur les
pages
Une fois qu'un jeu de variables indexées a été créé, vous pouvez l'utiliser pour créer une page pour le périphérique IHM
comme dans cet exemple.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
267
Utilisation d’un ensemble de variables indexées sur les pages
Pour créer cette page :
1. Créer une page et ajouter une liste déroulante, trois étiquettes et trois champs numériques.
2. Utiliser la variable d'index créé pour le numéro de la pièce pour la liste déroulante, « RoomNumber » dans cet
exemple. Ce sera le sélecteur pour le numéro de la pièce.
3. Créer une liste pour la liste déroulante. Dans cet exemple, utiliser la liste suivante.
Index
Liste des chaînes
0
Numéro de chambre
1
Chambre 1
2
Chambre 2
3
Chambre 3
4
Chambre 4
4. Joindre à chaque valeur de champ numérique, la variable Alias correspondant (Pièce > Température, Pièce >
Humidité, Pièce > Pression).
268
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
31 Serveur à architecture unifiée
OPC
Chemin : ProjectView> Config > Interfaces > double-cliquer sur OPC UA
Utilisez le serveur à architecture unifiée OPC pour publier les données selon le standard de l'architecture unifiée OPC.
Fonctionnalités
Paramètre
Description
Activer serveur à
architecture unifiée OPC
Active le fonctionnement du serveur à architecture unifiée OPC.
Activer alarmes
Active la publication des données d'alarme en temps réel (Alarmes
actives).
Les valeurs de données définies dans l'IHM sont publiées par le serveur à
architecture unifiée OPC.
Les propriétés d'alarme suivantes sont publiées :
• Activé(e)
• Sévérité
• État
Les états d'alarme sont associés aux états de l'architecture unifiée OPC
selon les règles suivantes :
État alarme architecture
unifiée OPC
AGI Creator État alarme
Opcua.Alarm.Active
TRIGGERED | TRIGGERED_NOT_
ACKED |
TRIGGERED_ACKED
Opcua.Alarm.Acked
TRIGGERED_ACKED |
NOT_TRIGGERED_ACKED
Opcua.Alarm.Retained
TRIGGERED |
TRIGGERED_NOT_ACKED |
TRIGGERED_ACKED |
( alarm requires reset flag & state !=
NOT_TRIGGERED )
Opcua.Alarm.Confirmed
lorsque l'alarme requiert la réinitialisation
du drapeau et l'état est NOT_
TRIGGERED
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
269
Paramètre
Description
L'opération de confirmation de l'architecture unifiée OPC est associée à
l'opération de réinitialisation. La confirmation ne fonctionne que si l'alarme
est active, autrement elle retourne OpcUa_BadInvalidState (puisque
l'opération de réinitialisation ne fonctionne qu'à cette condition).
Les opérations de confirmation/activation/désactivation effectuées via
l'architecture unifiée OPC sont auditées en tant que domaine « Serveur à
architecture unifiée OPC ». Si l'authentification est user/pass, l'utilisateur
est lui aussi connecté.
BranchId n'est pas supporté (le résultat est toujours “Nul”).
Activer alarmes historiques
Active la publication des données des alarmes historiques
Activer tendances
Active la publication des données de tendance.
Réseau
Paramètre
Description
Nom de nœud
Saisir le nom du nœud ou le laisser en blanc pour utiliser le nom de l'hôte.
Port
Le nombre de port d'entrée du Serveur à architecture unifiée OPC.
Produit URI
Un identifiant globalement unique pour le serveur.
Authentification
Paramètre
Description
Anonyme
Clients anonymes acceptés
Utilisateur/Mot de passe
L'authentification par identifiant est acceptée
Certificats
L'authentification par certificat est acceptée.
Le serveur peut supporter toutes les options simultanément.
Par exemple, supposons qu'il y a 3 clients. Admettons que le Client 1 n'a qu'un accès anonyme. Le Client 2 n'a qu'un
accès identifiant/mot de passe. Et le Client 3 n'a qu'un accès par certificat. Ils pourront se connecter tous les trois si toutes
les cases sont cochées dans l'éditeur de configuration du serveur.
Identité de serveur
Paramètre
Description
Nom du fabricant
Un nom lisible par l'homme désignant le fabricant du produit.
Nom du produit
Un nom lisible par l'homme désignant le produit qui exécute le serveur.
Certificat du serveur
Le certificat du serveur peut soit être généré automatiquement, soit par
l'ajout de fichiers de certificat existants.
270
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32
Widgets spéciaux
Les widgets conçus à des fins spéciales sont appelées widgets spéciaux et comprennent des listes de contrôle, widgets
de date et heure des, widgets variables, etc.
Widget de navigateur
272
Widget Canevas
273
Widget liste déroulante
276
Widget compteur de consommation
280
Widgets de liste de contrôle
282
Widgets Date & Heure
283
Widget de zone de mouvement
284
Widgets caméra IP
285
Widget de blocage de fonction Javascript
289
Widgets de lecture de médias
290
Widget d'image multi-états
293
Widget multi-couche d’image multi-états
294
Widget adaptateurs réseau
296
Widget de flux RSS
296
Faire défiler le widget de flux RSS
297
Widget tableau
298
Widget de variables
306
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
271
Widget de navigateur
Widget de navigateur
Chemin : Galerie des widgets> Média> Contrôles web
Utilisez ce widget pour intégrer des pages web aux pages de votre périphérique IHM. Ce widget de navigateur est
compatible avec l'HTML5 et il est basé sur le moteur WebKit.
Note : Pour les périphériques IHM intégrés fonctionnant sous Windows CE, la bibliothèque WebKit est
disponible en tant que plug-in (voir"Modules de plug-in de logiciels" on page 66 pour plus de détails) pour le
télécharger pour le HMI Runtime uniquement si nécessaire.
Important : Les périphériques avec MIPS ne prennent pas en charge ce widget.
Paramètre
Description
Page d'accueil
URL à ouvrir par défaut lorsque le widget est affiché sur la page.
Zoom pour ajuster
Met automatiquement le contenu à l'échelle de la taille de la zone d'affichage.
Délai d'attente
Délai d'attente pour le chargement de la page en secondes.
Effacer l'historique
Efface automatiquement l'historique lors du chargement
Défilement
Affiche/masque les barres de défilement
Afficher curseur de progrès
Affiche/masque le curseur de chargement
Cela vous permet de gagner environ 3 MB de mémoire lorsque le widget n'est pas requis dans votre projet.
Un widget Hyperlien est disponible pour créer des pages hyperliens. Lorsque vous cliquez sur ces liens, ils notifient au
widget de navigateur qu'une page web donnée va être chargée.
Important : Le protocole HTTPs n'est pas pris en charge.
272
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Widget Canevas
Chemin : Galerie des widgets> Basique> Canevas générique
Le Widget Canevas peut être utilisé pour dessiner le graphique via le script JavaScript.
Remarque : les méthodes JavaScript sont les mêmes qui sont disponibles pour la variable HTML5 <canevas>
Paramètre
Description
Largeur de canevas
Hauteur de canevas
Taille du canevas.
Dessiner indice
Définir comment adapter le canevas à l'intérieur de la taille du widget
Notez que ce n’est pas la taille du widget. Par exemple, la taille du canevas
pourrait être de 500x500 pixels pour une taille du widget de 100x100 pixels.
Le paramètre Dessiner indice définira comment étirer la taille du canevas
pour correspondre à la taille du widget.
l
l
l
Clip
Aucune transformation n’est appliquée, le système de coordonnées
n’est pas mis à l'échelle et le dessin est clipsé dans le rectangle
englobant du widget.
Ajuster à la taille
Ajuster à la taille du widget en préservant le rapport d’aspect du
modèle canevas.
Étirement
Ajuster à la taille du widget en ignorant le rapport d’aspect du modèle
canevas.
Exemple en utilisant une taille de canevas plus grande que la taille du
widget :
Aperçu du temps de design Aperçu du canevas dans AGI Creator
Notez que le code JavaScript peut utiliser les données non
disponibles dans AGI Creator mais seulement dans le
périphérique IHM
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
273
Widget Canevas
Paramètre
Description
Action OnDraw
L'événement OnDraw est exécuté lorsque la page est peinte. Cet
événement doit être lié au code JavaScript qui dessine le graphique de
canevas.
Action OnMousePress
Actions onMouseRelease
Événements de la souris
Méthodes de canevas disponibles
// Enregistrer / restaurer peintre
l
annuler enregistrement(); // appelle enregistrement peintre
l
annuler restauration(); // appelle restauration peintre
// Échelle / Transformation
l
annuler échelle(qreal x, qreal y);
l
annuler rotation(qreal angle);
l
annuler translation(qreal x, qreal y);
l
annuler transformation(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy);
l
annuler setTransform(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy);
// Gradient
l
CanvasGradient createLinearGradient(qreal x0, qreal y0, qreal x1, qreal y1);
l
CanvasGradient createRadialGradient(qreal x0, qreal y0, qreal r0, qreal x1, qreal y1, qreal r1);
// Fonctions Rectangle
l
annuler clearRect(qreal x, qreal y, qreal w, qreal h);
l
annuler fillRect(qreal x, qreal y, qreal w, qreal h);
l
annuler strokeRect(qreal x, qreal y, qreal w, qreal h);
l
annuler rect(qreal x, qreal y, qreal w, qreal h);
// Chemin
l
annuler beginPath();
l
annuler closePath();
l
annuler moveTo(qreal x, qreal y);
l
annuler lineTo(qreal x, qreal y);
l
annuler quadraticCurveTo(qreal cpx, qreal cpy, qreal x, qreal y);
l
annuler bezierCurveTo(qreal cp1x, qreal cp1y, qreal cp2x, qreal cp2y, qreal x, qreal y);
// Texte dessin
l
annuler fillText(const QString &text,qreal x, qreal y);
// Arc
l
annuler arcTo(qreal x1, qreal y1, qreal x2, qreal y2, qreal radius);
l
annuler arc(qreal x, qreal y, qreal radius, qreal startAngle, qreal endAngle, bool anticlockwise);
274
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
// Remplissage/course
l
annuler remplissage();
l
annuler stroke();
l
annuler clip();
l
bool isPointInPath(qreal x, qreal y) const;
// Manipulation de l’image (Dessiner CImageWgt en utilisant la rectification cible et source)
l
Annuler drawImage(QObject *pObjImage, qreal sx, qreal sy,qreal sw, qreal sh, qreal dx, qreal dy,qreal dw, qreal dh);
l
Annuler drawImage(QObject *pObjImage, qreal dx, qreal dy);
l
Annuler drawImage(QObject *pObjImage, qreal dx, qreal dy, qreal dw, qreal dh);
l
annuler drawImage(const QVariant& image, int width, int height, const QString& format, qreal sx, qreal sy,qreal sw,
qreal sh, qreal dx, qreal dy,qreal dw, qreal dh);
// manipulation des pixels
l
ImageData createImageData(double sw, double sh);//Empty Image
l
ImageData createImageData(ImageData fromImage);//from another Image
l
ImageData createImageData(ArrayBuffer value); //From arraybuffer
l
annuler putImageData(ImageData imgData,double dx, double dy);
l
l
annuler putImageData(ImageData imagedata, double dx, double dy, double dirtyX, double dirtyY, double dirtyWidth,
double dirtyHeight);
ImageData getImageData(qreal sx, qreal sy, qreal sw, qreal sh);
Exemple JavaScript Canevas
La canevas est initialement vide. Pour afficher quelque chose, un script doit d'abord accéder au contexte de rendu et y
dessiner :
var ctx = me.context2d;
alors vous pouvez utiliser les méthodes de toile, comme pour l'exemple ci-dessous
function GenericCanvasWgt1_onDraw(me, eventInfo)
{
var ctx = me.context2d;
ctx.fillStyle = 'red';
ctx.fillRect(0,0,250,250);
ctx.fillStyle = 'green';
ctx.fillRect(250,0,250,250);
ctx.fillStyle = 'blue';
ctx.fillRect(0,250,250,250);
ctx.fillStyle = 'black';
ctx.fillRect(250,250,250,250);
}
function GenericCanvasWgt1_onMouseDown(me, eventInfo)
{
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
275
Widget liste déroulante
alert("X = " + eventInfo.posX + "\nY = " + eventInfo.posY );
}
La méthode de mise à jour peut être utilisée pour redessiner dynamiquement un widget canevas
function BtnStd1_btn_onMouseClick(me, eventInfo)
{
var myCanvasWidget = page.getWidget("GenericCanvasWgt1");
myCanvasWidget.update()
}
Widget liste déroulante
Chemin : Galerie des widgets> Basique> Contrôles
Utilisez ce widget comme widget de sélection ou pour filtrer les lignes dans un tableau, afin d'afficher uniquement les
valeurs sélectionnées dans la liste déroulante.
Paramètre
Description
Index
Index de l'élément sélectionné.
Liste/Liste de
chaîne
Chaînes d'élément dans la liste déroulante.
Note : Ce champ est multilangues.
Données/Liste de Retourne la valeur de la colonne Liste de données (comme chaîne) dans le champ
données
Données du widget.
Astuce : Utilisez ce paramètre pour retourner une valeur personnalisée
basée sur un élément sélectionné dans la liste déroulante.
Texte
276
Format du texte affiché.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Associer des données VS associer des index
Dans de nombreux projets, vous pouvez être amené à associer des champs tels que Index ou Données à des variables
pour connaître les valeurs de l'élément sélectionné dans la liste déroulante. Utilisez :
l
Index : pour afficher l'index (entier) de l'élément sélectionné (0...n).
l
Données : pour afficher la valeur des données (chaîne) spécifiée dans la colonne Liste des données.
Mode « plein écran » avec images du widget à liste déroulante
Depuis les "Volet des propriétés de projet" on page 60 l’apparence et le comportement des listes déroulantes du mode
Contextuel au mode Plein Écran
Chemin : VueProjet> double-cliquez sur Propriétés du projet> Panneau de propriétés> Style> Mode de vue de la
liste déroulante
Paramètre
Description
Mode de vue
boîtier combiné
Sélectionnez le mode de visualisation de tous les widgets de liste déroulante du projet
Contexte
Vue classique avec les menus déroulants
Plein écran
Vue améliorée avec textes et images configurables qui apparaîtront au milieu de
l'écran pour faire défiler facilement et sélectionner.
Exemple de vue Contextuel
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
277
Widget liste déroulante
Exemple de vue Plein écran
Paramètres supplémentaires disponibles en mode plein écran
La colonne supplémentaire « Liste des images » sera disponible dans le paramètre Liste déroulante> Liste :
278
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Note : Certaines propriétés ne s'affichent qu'en mode avancé.
Paramètre
Description
Image
Retour, à l'intérieur de la variable attachée, le nom du fichier de l'image sélectionnée
Bouton
Définir l'apparence de la liste déroulante
l
l
VueListes
Afficher l'arrière-plan = vrai
Bouton liste déroulante affiché
Afficher l'arrière-plan = faux
Seul l’image ou le texte est affiché
Paramètres de mise en page de la liste déroulante en mode édition
ÉlémentsVueListe Définir le type d'éléments à l'intérieur de la liste déroulante
Mode Image :
l
Seul texte
l
Seules images
l
Texte et images
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
279
Widget compteur de consommation
Widget compteur de consommation
Chemin : Galerie des widgets> Basique> Tendances/Graphiques
Utilisez ce widget pour gérer une ressource qui est en constante hausse. Le système lit la valeur de la ressource et calcule
l'incrément dans un ensemble de plages de temps. L'incrément est ensuite affiché dans un histogramme dans une fenêtre
de type de tendance.
Différentes couleurs peuvent être utilisées dans le graphique, selon le délai d'exécution.
Astuce : Utilisez ce widget pour calculer la consommation d'énergie d'un système.
Paramètre
Description
Valeur
Ressource surveillée
Durée du
graphique
Unités de durée
du graphique
Période de temps affichée dans la fenêtre
Durée de la
barre
Unités de durée
des barres
Période de temps représentée par chaque barre du graphique
Périodes de
temps
Assigne une couleur spécifique pour surligner l'incrément de la ressource surveillée
dans une période de temps donnée (résolution minimale = 1 heure).
Couleur
Largeur de barre
Couleur et largeur de la barre
Valeur de la
barre
Afficher / Masquer la valeur de chaque barre
Compteur de
consommation
Nombre d'étiquettes à afficher dans le graphique.
Exemple : surveiller la consommation d'énergie
Dans l'exemple suivant, un widget est conçu pour surveiller la consommation d'énergie avec une échelle hebdomadaire et
une unité quotidienne.
280
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
1. Associez une variable à la variable physique à surveiller. Dans cet exemple, la totalité de l'énergie consommée
(variable KWh). Cette variable contient un nombre incrémentiel qui indique la consommation en KW/h depuis le
début de la consommation d'énergie.
2. Ajoutez une tendance et liez-la à la variable à surveiller, la variable KWh.
3. Ajoutez un widget Compteur de consommation à une page.
4. Associez la propriété Valeur du compteur de consommation à la tendance créée à l'étape 2.
5. Définissez Durée du graphique/Unités à 1 semaine : vous obtiendrez un graphique hebdomadaire de l'énergie
consommée.
6. Définissez Durée de la barre/Unités à 1 jour. C'est l'intervalle de temps pendant lequel l'énergie consommée est
calculée.
7. Dans Compteur de consommation, définissez le nombre d'étiquettes à afficher dans l'histogramme, dans le cas
présent 7, pour afficher un graphique hebdomadaire.
8. Depuis la propriété Périodes de temps, ouvrez la boîte de dialogue Configurer les périodes de temps :
définissez les différentes couleurs pour différentes valeurs de la variable KWh dans chaque barre.
Astuce : Pour assigner la couleur aux cellules du tableau, sélectionnez les cellules et cliquez sur la
couleur voulue, ou entrez la valeur d'index de la bande (1, 2, 3) dans la cellule.
9. Ajoutez autant de couleurs de bandes que nécessaire, dans cet exemple 3 couleurs de bandes.
10. Assignez une bande à chaque heure dans le tableau hebdomadaire, dans cet exemple une bande rouge (E1), qui
indique la plage de temps dans la journée/semaine pendant laquelle le coût de l'énergie est le plus élevé.
Note : Vous pouvez appliquer un facteur d'échelle à chaque bande de couleur, si nécessaire.
Il en résulte un histogramme représentant le compteur de consommation et affichant la consommation d'énergie en KW/h,
avec des couleurs qui indiquent les différents coûts de l'énergie. La hauteur de chaque barre représente la quantité
d'énergie dans l'intervalle de temps concerné, 1 jour dans cet exemple.
Utilisez l'action ConsumptionMeterPageScroll pour faire défiler l'histogramme en avant et en arrière, ainsi que l'action
RefreshTrend pour rafraîchir l'histogramme car les données ne sont pas rafraîchies automatiquement.
Important : Aucune autre action de tendance n'est actuellement prise en charge par le widget du
compteur de consommation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
281
Widgets de liste de contrôle
Widgets de liste de contrôle
Chemin : Galerie des widgets> Avancé> Liste de contrôle
Utilisez ces widgets pour représenter l'état associé à un processus particulier et pour contrôler ce processus depuis le
même widget.
Deux types de listes de contrôle sont disponibles :
l
l
une liste de contrôle de groupe, avec un ensemble limité de boutons de navigation qui sont déjà inclus, et
une liste de contrôle basique avec aucun bouton configuré au préalable, sur laquelle vous pouvez naviguer en
utilisant la fonction écran tactile.
Paramètre
Description
Valeur
Si le Mode d'écriture est Écrire après sélection : valeur de l'élément sélectionné.
Si le Mode d'écriture est Écrire après entrée : valeur de l'élément sélectionné et confirmé en appuyant
sur le bouton entrée.
Ce champ peut être associé à une variable pour contrôler l'élément sélectionné et confirmé.
État
État par défaut lorsque le widget est chargé.
Sélection
Élément actuellement sélectionné, affiché comme un curseur surligné se déplaçant de haut en bas. Cette
propriété peut être associée à une variable.
Mode
écriture
Écrire après sélection : la valeur est automatiquement écrite sur la variable lorsque vous sélectionnez un
des éléments.
Écrire après entrée : la valeur est écrite sur la variable uniquement lorsque vous sélectionnez un des
éléments et que vous appuyez sur la touche entrée.
Read only
Définit si la liste est uniquement un indicateur.
Liste de
données
Ajoute/supprime des éléments de la liste.
Définir les états
Ajoute/supprime des états, c'est-à-dire des éléments de la liste, depuis la propriété Liste de données.
282
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Toute valeur peut être assignée à un état. Lorsque vous activez l'état, en sélectionnant l'élément associé si vous êtes en
mode Écrire après sélection ou bien en le sélectionnant et en confirmant en appuyant sur entrée si vous êtes en mode
Écrire après entrée, la valeur associée à un état sera écrite sur la variable liée au widget de contrôle de la liste Valeur .
Widgets Date & Heure
Chemin : Galerie des widgets> Basique> Contrôles
Utilisez ce widget pour afficher et éditer la date et l'heure actuelles.
Dans le volet Propriétés, différents formats sont disponibles pour représenter la date et l'heure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
283
Widget de zone de mouvement
Pour la propriété Spéc heure, sélectionnez quelle heure le widget doit afficher en cours d'exécution.
Options pour l'heure
Option
Description
locale
affiche l'heure locale, l'heure du périphérique IHM où le projet est exécuté
GMT
affiche l'heure de Greenwich (GMT)
serveur
affiche les informations relatives à l'heure telles que gérées au niveau du serveur du périphérique IHM
Widget de zone de mouvement
Chemin : Galerie des widgets> Boutons> Autres
Le widget de zone de mouvement est un bouton à zone réactive qui génère des événements de pincement et de
déplacement.
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent générer des événements de
pincement
284
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Utilisez le code JavaScript en association avec les événements de mouvement pour obtenir des informations détaillées sur
les gestes et programmer les actions appropriées.
Voir "Événements de widget" on page 330pour plus de détails sur ces types d'événements
Geste de balayage
Comment reconnaître un geste de « balayage » de changement de page dans l'application.
1. Mettez un widget de zone de Gestion dans la page
2. Configurer l'action OnPan pour déclencher une fonction JavaScript
3. Écrire le code JavaScript qui reconnait le geste de balayage
Widgets caméra IP
Chemin : Galerie des widgets> Média> Caméra IP
Utilisez ces widgets pour afficher des images capturées avec une caméra IP ou un flux vidéo.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
285
Widgets caméra IP
Paramètre
Description
URL de Caméra
URL de la caméra IP lorsqu'elle est utilisée dans le format JPEG.
Fréquence de
rafraîchissement
Nombre d'images JPEG par seconde autorisé. Fréquence max = 1 fps.
Identifiant
Nom d'utilisateur autorisé à accéder à la caméra.
Configurez ce paramètre lorsque l'accès à la caméra est protégé par un mot
de passe.
Mot de passe
Mot de passe d'accès à la caméra.
URL de caméra MJPEG
URL de flux MJPEG (par exemple, http://192.168.0.1/video.cgi)
Lorsque ce widget est utilisé pour diffuser HTTP MJPEG, l'URL de caméra et la Fréquence de rafraîchissement sont
ignorés.
La performance du flux n'est pas fixe et dépend de nombreux facteurs, tels que : la taille de l'image, le niveau de
compression de l'image, la CPU du périphérique IHM, la qualité de la Caméra IP. En fonction de ces facteurs, le widget
peut atteindre jusqu'à 25 fps.
Vous pouvez ajouter de multiples widgets de caméra IP, mais cela réduira la fréquence image pour chaque widget.
Caméras IP supportées
Les Caméras IP suivantes ont été testées :
Caméra IP
Protocole
URL
Apexis APM-J901-Z-WS PTZ IP Camera
MJPEG
http://{ip_address}/videostream.cgi
HTTP
http://{ip_address}/snapshot.cgi
MJPEG
http://{ip_address}/axis-cgi/mjpg/video.cgi
HTTP
http://{ip_address}/axis-cgi/jpg/image.cgi
DAHUA DH-IPC-HD2100P-080B 1.3mp
Outdoor Vandalproof
HTTP
http://{ip_address}:9988/onvif/media_
service/snapshot
D-Link DCS-5605 PTZ
MJPEG
http://{ip_address}/video/mjpg.cgi
D-Link DCS-900W IP Camera
MJPEG
http://{ip_address}/video.cgi
AXIS M3027-PVE Network Camera
286
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Caméra IP
Protocole
URL
D-Link DCS-932L
MJPEG
http://{ip_address}/video.cgi
Edimax IC-7100P PTZ
MJPEG
http://{ip_address}/mjpg/video.mjpg
HTTP
http://{ip_address}/picture.jpg
MJPEG
http://{ip_address}/videostream.cgi
HTTP
http://{ip_address}/snapshot.cgi
MJPEG
http://{ip_address}:88/cgibin/CGIStream.cgi?cmd=GetMJStream&usr=
{user}&pwd={pass}
Foscam FI8916W
Foscam FI9803 EP
NOTE :
l
l
l
Hamlet HNIPCAM IP Camera
le port 88 peut être différent en fonction des
paramètres de la Caméra IP
{user} = identifiant défini dans les paramètres
de la Caméra IP
{pass} = mot de passe défini dans les
paramètres de la Caméra IP
MJPEG
http://{ip_address}/video.cgi
HTTP
http://{ip_address}/image.jpg
MOXA VPort 254 (Encodeur vidéo industriel
robuste à 4 canaux MJPEG/MPEG4)
MJPEG
http://{ip_address}/moxa-cgi/mjpeg.cgi
HTTP
http://{ip_address}/moxacgi/getSnapShot.cgi?chindex=1
NVS30 network video server
MJPEG
http://{ip_address}:8070/video.mjpeg
HTTP
http://{ip_address}/jpg/image.jpg
MJPEG
http://{ip_address}/cgi-bin/mjpeg
Panasonic WV-Series Network Camera
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
287
Widgets caméra IP
Caméra IP
Protocole
URL
Ubiquiti UniFi Video Camera
HTTP
http://{ip_address}:7080/images/snapshot/camera/
{camera_guid}?force=true
NOTE :
l
l
Zavio F3210 2MP Day & Night Compact IP
Came
{camera_guiID} peut être trouvé sur la page
web de la Caméra IP
le port 7080 peut être différent en fonction des
paramètres de la Caméra IP
MJPEG
http://{ip_address}/stream?uri=video.pro3
HTTP
http://{ip_address}/cgi-bin/view/image?pro_0
NOTE :
l
Le flux vidéo MJPEG peut être configuré en
sélectionnant « profil vidéo 3 » avec une
résolution 640x480 dans les paramètres de la
Caméra IP.
Widget de contrôles PTZ
Les caméras PTZ (pan–tilt–zoom) sont des caméras capables de contrôler le zoom et la direction à distance.
Le widget de contrôles PTZ utilise l'action MoveIPCamera pour envoyer des commandes HTTP/cgi à la Caméra IP PTZ.
Paramètre
Description
URL de
Caméra
URL de la Caméra IP
Identifiant
Nom d'utilisateur autorisé à accéder à la caméra.
Configurez ce paramètre lorsque l'accès à la caméra est protégé par un mot de passe.
Mot de passe
Mot de passe d'accès à la caméra.
Commande
Commande à envoyer au contrôleur PTZ (par exemple, decoder_
control.cgi?command=0)
288
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Méthodes d'authentification
La méthode d'authentification est automatiquement définie par le serveur web de la caméra auquel le widget est connecté.
Les méthodes d'authentification supportées sont :
l
Basique
l
NTLM version 1
l
Digest-MD5
Widget de blocage de fonction Javascript
Chemin : Galerie des widgets> Basique> JSFunctionBlock
Le blocage de fonction Javascript est un widget contenant une logique Javascript qui est exécutée lorsque les valeurs de
variable changent.
Paramètre
Description
valeur1
...
valeur16
Objets qui déclencheront l'action OnDataUpdate.
OnDataUpdate
Action qui sera exécutée si une modification de valeur associée est détectée
Note : Ce widget n'est rendu que dans AGI Creator, et n'est pas rendu dans le périphérique IHM.
Exemple :
Un code Javascript qui contrôle la serrure à combinaison de trois sélecteurs
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
289
Widgets de lecture de médias
Voir "Événements de widget" on page 330pour la description des paramètres onDataUpdate
Widgets de lecture de médias
Chemin : Galerie des widgets> Média> Lecture de médias
290
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Utilisez ces widgets pour lire des vidéos à partir d'une liste de lecture. Les fichiers vidéo peuvent être stockés sur une clé
USB, une carte mémoire flash ou une carte SD.
Deux widgets sont disponibles : l'un inclut un cadre multimédia avec des boutons pour lire et interrompre la vidéo, l'autre
est un simple cadre où la vidéo est lu sans que l'utilisateur ne dispose de commandes.
Paramètre
Description
Liste de lecture médias
Crée une liste de lecture
Style en boucle
Définissez la modalité de lecture de la vidéo.
l
NoLoop : lit toutes les vidéos de la liste de lecture, puis s'arrête.
l
LoopOne : répète la première vidéo dans la liste de lecture.
l
LoopAll : répète toute la liste de lecture.
l
Random : lit les vidéos selon un ordre aléatoire.
Note : Le widget de lecture de médias ne fonctionne qu'avec certains périphériques IHM (les périphériques IHM
se basant sur ARM Cortex-A8-1Ghz et la plateforme Win32). Il ne fonctionne pas sur le AGI Client.
Note : Vous ne pouvez avoir qu'un seul widget de lecture de médias dans une page.
Important : Utilisez les mêmes codecs et paramètres pour tous les vidéos de la liste de lecture.
Codage vidéo supporté
Deux groupes de codecs sont supportés :
l
Codecs vidéo basés sur DSP
l
Codecs logiciels vidéo
Codecs vidéo DSP
Ils incluent :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
291
Widgets de lecture de médias
l
H264 en utilisant un conteneur AVI/MP4, CABAC désactivé et Niveau 3 (suggéré)
l
MPEG2 en utilisant un conteneur AVI
l
MPEG4 en utilisant un conteneur AVI
Ils utilisent le processeur DPS (accélération matérielle vidéo) et BSP 1.55 ou une version supérieure est requise pour les
lire. La résolution maximale est de 720x576 pixels avec un débit de 4200 kb/s. 720p, 1080p et l'audio ne sont pas
supportés.
Codecs logiciels vidéo
Concerne uniquement :
l
Microsoft MPEG4 v3 en utilisant un conteneur AVI.
Les vidéos codés avec Microsoft MPEG4 v3 n'utilisent pas l'accélération matérielle et sont plus limitées. Pour éviter une
lecture saccadée des vidéos, nous suggérons une résolution maximum de 640x512 pixels et un débit de 1300 kb/s. De
plus, la taille du widget de lecture de médias utilisé sur la page doit être de la même taille que les vidéos sur la liste de
lecture, si vous voulez éviter de devoir redimensionner l'image. L'audio n'est pas supporté.
Convertir une vidéo
Cette procédure décrit comment convertir une vidéo en utilisant le convertisseur vidéo eRightSoft SUPER ©.
1. Glissez-déposez la vidéo à convertir dans SUPER.
2. Sélectionnez AVI à partir de la liste Conteneurs de Sortie et H.264/AVC à partir du Codec Vidéo de Sortie.
292
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
3. Cliquer sur H264 Profile : choisir Baseline comme profil et le niveau 3 dans la boîte de dialogue.
4. Cochez la case Désactiver l'audio.
5. Cliquez sur Coder (Fichiers Actifs) pour lancer le codage des vidéos.
Vous pouvez maintenant ouvrir les vidéos avec un lecteur vidéo classique, tel que Windows Media Player et contrôler la
qualité. Vous pouvez ajouter la vidéo ainsi convertie à la liste de lecture du widget de lecture de médias.
Note : Cet outil de conversion vidéo n'est pas fourni avec le AGI SW Pack.
Utilisation du lecteur de médias dans Javascript
Le widget de lecture de médias peut aussi être référencé dans les programmes Javascript avec la syntaxe suivante :
//get the mediaplayer widget.
var mediaWgt = page.getWidget('MediaPlayerWgt2');
//load the play list
mediaWgt.setProperty('medialist', '/Storage Card/demo_3.avi,/Storage Card/video1_
3.avi');
// set the loopstyle 0 - noloop, 1 - loop one, 2- loop all, 3 - random
mediaWgt.setProperty('loopstyle', 2);
//start playing the first file.
mediaWgt.mediapath = '/Storage Card/demo_3.avi';
Voir "JavaScript " on page 325 pour plus de détails sur les modalités de fonctionnement avec JavaScript.
Widget d'image multi-états
Chemin : Galerie des widgets> Basique> Images
Utilisez ce widget pour afficher une image parmi la série proposée, en fonction de la valeur d'une variable utilisée comme
Index. Vous pouvez aussi utiliser ce widget pour de simples animations.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
293
Widget multi-couche d’image multi-états
Paramètre
Description
Valeur
Index de l'image à afficher.
Par exemple, définissez Valeur=0 pour afficher l'image avec l'index 0 dans la série
d'images.
Images
Série d'images associées à un index.
Animer
Configurez sur vrai pour activer un diaporama.
Intervalle de
temps
Intervalle entre les images dans le diaporama.
Widget multi-couche d’image multi-états
Chemin : Galerie des widgets> Basique> Images
Utilisez ce widget pour créer différentes animations et sélectionnez la plus appropriée à l'exécution.
294
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Paramétrer les couches de widget
1. Ouvrez la boîte de dialogue Couches à partir du volet Propriétés.
2. Cliquez sur + pour ajouter le nombre de couches souhaitées.
3. Double-cliquez sur chaque couche pour ajouter le nombre d'images souhaitées à inclure dans la couche.
4. Glissez-déposez les images dans le cadre pour les ajouter à la couche actuelle.
5. Définissez les propriétés de widget.
Paramètre
Description
Couche par
défaut
Couche affichée à l'exécution.
Nom
Nom de la couche sélectionnée.
Cadre par
défaut
Cadre apparaissant lorsque la couche actuelle est affichée.
Couleur /
Remplissage
Couleur de remplissage pour les images de la couche actuelle.
Animer
Active le diaporama pour la couche active. Les animations peuvent être
lancées/interrompues en cours d'exécution en les associant à une variable.
Intervalle de
temps
Intervalle de temps du diaporama, si activé.
Aperçu
Simulation du diaporama.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
295
Widget adaptateurs réseau
Note : La Couche par défaut, le Cadre par défaut, la Couleur et le Remplissage peuvent être modifiés
pendant l'exécution, en les associant à une variable.
Widget adaptateurs réseau
Chemin : Galerie des widgets> Basique> Contrôle
Utilisez le widget IP pour configurer les paramètres d'adaptateurs réseau.
La variable système Réseau->État contient le résultat de la dernière opération exécutée par le widget IP (voir "Variables
réseau" on page 92pour plus d'informations)
Widget de flux RSS
Chemin : Galerie des widgets> Média> Source de flux RSS
Utilisez ce widget pour afficher sur le périphérique IHM votre flux RSS préféré directement à partir d'Internet.
296
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Paramètre
Description
Source RSS
URL de flux
Note : Les sources de flux ne peuvent pas être modifiées en cours
d'exécution.
Fréquence de mise à jour
Temps de rafraîchissement
Le widget de flux RSS a été spécifiquement conçu pour fonctionner avec le Pocket Internet Explorer.
Faire défiler le widget de flux RSS
Chemin : Galerie des widgets> Média> défilement flux RSS
Utilisez cette version du widget principal de flux RSS pour afficher les faits saillants à l'intérieur d'une ligne de texte à l'aide
d'un texte défilant.
Ce widget a des propriétés supplémentaires.
Paramètre
Description
Défilement
Vitesse de défilement
Séparateur de titres
Caractère de séparation entre les éléments surlignés
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
297
Widget tableau
Widget tableau
Chemin : Galerie Widget> Basic> Tableau
Utiliser ce widget pour créer une tableau avec des données fournies à partir d'une source de données.
Pour configurer un tableau :
1. Mettre un widget de tableau sur l'écran et configurer le modèle de tableau.
2. Ajouter des widgets dans les cellules pour configurer une ou plusieurs lignes qui seront utilisées en tant que modèle
de lignes lorsque le tableau sera rempli de données fournies par la source de données.
3. Sélectionner une source de données qui seront utilisées pour remplir les lignes du tableau
4. Définir les liens de widgets et source de données.
Configurer le widget tableau
Le Widget tableau a deux états :
l
Mode vue
l
Mode édition.
Cliquer sur le tableau pour gérer le widget en mode vue, cliquer deux fois pour entrer dans le mode édition. Pour quitter et
revenir au mode vue, cliquer en dehors du tableau.
Mode vue
En mode vue, vous pouvez configurer la disposition de tableau. Glisser et déposer le tableau sur la page, redimensionner le
tableau, définir le nombre de lignes modèle, nombre de colonnes et les principales propriétés du tableau.
298
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Les propriétés « Groupe disposition grille » ne sont visibles que dans la vue avancée. Voir "Grouper des widgets"
on page 48 pour plus de détails.
Mode édition
En mode édition, il est possible configurer le format et le contenu de chaque cellule du tableau.
Pour configurer l'apparence du tableau, cliquer sur les sélecteurs de tableau pour sélectionner l'élément à configurer.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
299
Widget tableau
Pour configurer le contenu des cellules, faire glisser les widgets à l'intérieur des cellules.
Si vous avez besoin plus de widgets dans une seule cellule, créer un groupe de widgets et copier le groupe
depuis la page sur la cellule.
Configuration de la source de données
La source de données, qui fournit les données pour remplir le tableau, pourrait être un Widget source de données de tableau
ou un tableau JavaScript JSON.
Widget source de données tableau
Chemin : Galerie Widget> Basic> Tableau
1. Glisser et déposer un Widget de source de donnée de tableau sur la page
2. Voir le paramètre Modèle de tableau pour relier à la source de données.
300
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Sélectionner la source de données et à l'intérieur de l'éditeur TableDataSrcWgt ajouter les lignes et les colonnes
nécessaires. Dans l'exemple suivant, nous avons défini deux modèles de lignes :
l
l
Ligne 0
En-tête du tableau. Contient uniquement du texte statique
Ligne 1
Modèle de lignes avec données. Sur la première colonne, nous avons ajouté une étiquette qui contiendra la
description et sur la seconde colonne, un champ qui contiendra la valeur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
301
Widget tableau
Définir des liens avec la source de données
1. Double-cliquer sur le widget de tableau pour entrer en mode d'édition et sélectionnez un widget
2. Sélectionner la propriété qui doit être lu à partir de la source de données
3. Sélectionner la colonne de la source de données qui fournira les données
L'image ci-dessous montre comment notre exemple sera rendu en runtime
302
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Multilangue
Pour activer le support Multilingue, faire un clic droit sur l'icône Multilingue de la colonne. L’icône changera de couleur pour
mettre en évidence que le support est activé.
Éviter en permettant le support multilingue lorsqu'ils ne sont pas nécessaires pour de meilleures performances.
Importer/Exporter la source des données
La configuration de la source de données pourrait être importée / exportée à l'aide des fichiers xml
Tableau JavaScript JSON
En alternative du Widget de source de données, données pour remplir le tableau pourraient être fourni à partir du code
JavaScript en utilisant un tableau JSON. Dans ce cas, nous devons remplir un tableau d'éléments JSON avec les données
à utiliser et attribuer le tableau au widget tableau.
var myTable = page.getWidget("TableWgt1");
myTable.model = model;
le modèle est un tableau d’éléments JSON avec la définition et les données de tableau. Le premier élément du tableau
contiendra le modèle des lignes tandis que d’autres éléments contiennent les données à remplir dans les lignes du tableau
model[0]
model[1]
model[2]
model[3]
=
=
=
=
row_templates;
row_data1;
row_data2;
row_data3;
//
//
//
//
row templates
data of the row1
data of the row2
data of the row3
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
303
Widget tableau
model[4] = row_data4;
model[5] = row_data4;
// data of the row4
// data of the row5
Le modèle de ligne est un tableau de tableau où chaque tableau définit la liaison de données d'un modèle de ligne.
Sur l'exemple ci-dessous, nous avons un modèle pour deux rangées.
var row_templates = {
_h : [
[ []
, []
],
[ ["text"] , ["value"] ]
]
}
//rowType = 0
//rowType = 1
La première ligne est liée à une rangée avec deux colonnes qui ne contiennent pas de lien. Nous utilisons ce modèle pour
l'en-tête sur la première ligne de notre tableau.
La deuxième ligne définit le modèle d'une ligne où la propriété du « texte » du widget dans la première colonne et la propriété
« valeur » du widget dans la deuxième colonne sera remplie dynamiquement en utilisant les données fournies dans la
variable de modèle.
Dans l’exemple ci-dessous, nous définissons une ligne de données
var row_data = {
_t : 1,
_v : ["Temperature:", { _c : "dl" , s : "_TagMgr", a : "Tag1", i: 0, m : 2 }]
}
Le premier élément est le modèle de ligne à utiliser tandis que le deuxième élément est le tableau avec les données à
utiliser. Dans notre exemple « Température » est le texte à utiliser à l'intérieur du widget sur la première colonne, tandis que
l'autre élément est une liaison de données qui fournira la valeur pour remplir la propriété de valeur du widget dans la
deuxième colonne.
L’élément de la liaison de données JSON :
Paramètre
Description
_c : "dl"
Identifier l’élément JSON comme une liaison de données
s : "_TagMgr"
Indiquer la source des données est le Gestionnaire de variables
a : "Tag1", i: 0, m:2
Spécifier le nom de la variable et l’index (nécessaire quand une variable est un
tableau) et le mode lire/écrire
l
m=0 est Read Only
l
m=1 est Write Only
l
m=2 est Read/Write
Le code JavaScript ci-dessous générera le même tableau d'exemple précédent lié avec le widget de source des données
de tableau
var model = [];
304
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
var row_templates = {
_h : [
[ []
, []
],
[ ["text"] , ["value"] ]
]
}
//rowType = 0
//rowType = 1
var row_data1 = {
_t : 0,
_v : []
}
var row_data2 = {
_t : 1,
_v : ["Temperature:", { _c : "dl" , s : "_TagMgr", a : "Tag1", i: 0, m : 2 }]
}
var row_data3 = {
_t : 1,
_v : ["Humidity:",
}
var row_data4 = {
_t : 1,
_v : ["Noise:",
}
var row_data5 = {
_t : 1,
_v : ["Brightness:",
}
model[0]
model[1]
model[2]
model[3]
model[4]
model[5]
=
=
=
=
=
=
{ _c : "dl" , s : "_TagMgr", a : "Tag2", i: 0, m : 2 }]
{ _c : "dl" , s : "_TagMgr", a : "Tag3", i: 0, m : 2 }]
{ _c : "dl" , s : "_TagMgr", a : "Tag4", i: 0, m : 2 }]
row_templates;
row_data1;
row_data2;
row_data3;
row_data4;
row_data5;
var myTable = page.getWidget("TableWgt1");
myTable.model = model;
Multilangue
Un texte de langues multiples peut être entré en utilisant l'élément JSON ci-dessous :
{ _c : "ml" , mltext : {"en-US" : "Temperature:" , "it-IT" : "Temperatura:"} }
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
305
Widget de variables
Paramètre
Description
_c : "ml"
Identifier l’élément JSON comme un texte multilangue
mltext : { ... }
Liste de couples : "ID Language":"Text"
Exemple :
l
"en-US" : "Temperature:"
l
"it-IT" : "Temperatura:"
Exemple :
var row_data2 = {
_t : 1,
_v : [ { _c : "ml" , mltext : { "en-US" : "Temperature:",
"it-IT" : "Temperatura:"}
},
{ _c : "dl" , s : "_TagMgr", a : "Tag1", i: 0, m : 2 }
]
}
Widget de variables
Chemin : Galerie de widgets> Avancé> Source de données
Utilisez ce widget pour ajouter des variables internes pour les opérations telles que le transfert de données ou pour être
utilisés dans les programmes JavaScript.
Note : Les variables sont locales à la page où le widget a été inséré.
Lorsque vous glissez-déposez ce widget dans votre page, un placeholder sera affiché pour indiquer l'emplacement du
widget, mais il ne sera pas visible au moment de l'exécution.
306
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
32 Widgets spéciaux
Paramétrage du widget
Pour créer des variables et attribuer des valeurs à celles-ci, ouvrir les boîtes de dialogue Variables depuis la propriété
Variables dans le volet Propriétés.
Ces variables peuvent ensuite être référencés à partir de la boîte de dialogue de variable Attacher, à partir de l'éditeur de
page.
Si vous avez besoin des variables globales, les configurer au niveau du projet, en ajoutant les variables souhaitées au
widget variable globale.
Utiliser les variables dans JavaScript
Les variables peuvent également être référencées dans les programmes JavaScript avec la syntaxe suivante :
Pour les variables locales :
var varWgt = page.getWidget("_VariablesWgt");
var compVar = varWgt.getProperty("VariableName");
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
307
Widget de variables
Pour les variables globales :
var varWgt = project.getWidget("_VariablesWgt");
var compVar = varWgt.getProperty("VariableName");
308
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33
Widgets personnalisés
AGI Creator a une grande bibliothèque de widgets qui inclut des widgets dynamiques prédéfinis (boutons, voyants, jauges,
sélecteurs, tendances, recettes et éléments de boîte de dialogue), ainsi que des images statiques (formes, tuyaux,
réservoirs ou moteurs).
Vous pouvez glisser et déposer un objet de la galerie vers la page, puis le dimensionner, le déplacer, le pivoter ou le
transformer. Tous les widgets de la galerie sont vectoriels, ils ne perdent donc pas de définition lorsqu'ils sont
redimensionnés.
Cependant, vous pouvez modifier tous les widgets prédéfinis pour créer votre widget personnalisé. Les widgets
personnalisés peuvent être créés à partir de plusieurs éléments incluant seulement les propriétés nécessaires pour leur
fonctionnement.
310
Créer un widget personnalisé
310
Ajouter des propriétés à un widget personnalisé
312
Utilisation de variables structurées
314
JavaScript dans les widgets personnalisés
316
Galerie de l’utilisateur
318
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
309
Créer un widget personnalisé
1. Glissez et déposez sur une page tous les widgets que vous voulez utiliser pour composer votre widget
personnalisé.
2. Sélectionnez-les et groupez-les.
3. Faites un clic droit sur l’objet groupé et sélectionnez le Convertir en Widget : la boîte de dialogue Catalogue de
Widgets personnalisés s'affiche.
Paramètre
Description
Inclut des widgets
personnalisés utilisés
Une fois coché, lister tous les widgets utilisés à l'intérieur du projet. Même les
widgets du système
Nom
Vous pouvez définir tout ce que vous préférez, mais il est commun de garder
une structure de nom. Le dossier com.hmi est réservé aux widgets du système
Description
Description du widget.
Version
Version du widget.
Tous les widgets qui partagent la même version partagent les propriétés définies
à partir du paramètre d'héritage.
Héritage
310
Propriétés partagées entre widgets avec la même version
l
Toutes (aussi bien graphique que logique)
l
Uniquement graphique
l
Uniquement logique
l
Désactiver
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33 Widgets personnalisés
Modifier un widget personnalisé
Double-cliquer pour sélectionner le widget personnalisé en mode édition. L'icône du cadenas vert indique que vous allez
modifier un widget personnalisé, plutôt que juste un groupe de widgets. La différence est que la modification sera propagée
à tous les autres widgets personnalisés avec la même version qui sont configurés pour hériter des propriétés du widget.
Cliquer sur l'icône du cadenas pour activer le mode d'édition, le cadenas sera ouvert. Cliquer à nouveau lorsque la
modification sera effectuée.
Partager les propriétés
Lorsqu’un widget personnalisé est modifié, toutes les modifications seront propagées à tous les autres widgets
personnalisés qui partage la même version et qui sont configurés pour hériter des propriétés du widget.
Utiliser des composants de widgets
En général, les widgets sont composés de nombreuses parties, par exemple un bouton est un widget complexe qui inclut
deux widgets d'image, un widget de bouton et une étiquette.
Pour afficher une liste de tous les éléments qui font partie d'un widget, sélectionnez le widget, ouvrir le cadenas et ouvrir le
volet VueObjet : tous les éléments composant un widget complexe sont listés en ordre hiérarchique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
311
Ajouter des propriétés à un widget personnalisé
Pour sélectionner un seul widget, le sélectionner directement depuis le volet VueObjet.
Ajouter des propriétés à un widget personnalisé
Lorsque vous créez un widget personnalisé, vous devez définir les propriétés qui seront affichées pour ce widget dans le
volet Propriétés.
1. Faites un clic droit sur l’objet groupé et sélectionnez le Catalogue Widget : la boîte de dialogue des propriétés
s'affichent.
312
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33 Widgets personnalisés
2. Cliquez sur + pour ouvrir la boîte de dialogue Sélection des propriétés : elle liste toutes les propriétés de tous les
widgets groupés.
3. Sélectionnez les propriétés que vous voulez définir pour votre widget personnalisé.
4. Définissez les détails de chaque propriété.
Notez que vous pouvez créer des dossiers et utiliser la fonction glisser-déposer pour déplacer ou de réorganiser
la liste des Propriétés
Paramètre
Description
Propriétés
Nom affiché dans le volet Propriétés.
Description
Tout commentaire sur la propriété à afficher dans le volet Propriétés.
ID
Le nom affiché par AGI Creator à des fonctions JavaScript et à la boîte de dialogue variable
associée.
Prise en charge des
variables
Spécifie si la propriété prend en charge l'attribut « Associer à ».
Read only
Propriété exposée uniquement en mode de lecture
Paramètres avancés
Spécifie si chaque propriété doit apparaître dans le mode d'affichage avancé ou simple du
volet Propriétés.
Propriétés alias
Propriétés internes liées à la propriété exposée
Associer des propriétés
Pour associer deux propriétés ou plus :
1. Sélectionnez la propriété primaire dans la boîte de dialogue de la liste des Propriétés.
2. Cliquez sur + dans la barre d'outils propriétés alias : la boîte de dialogue Sélectionner propriété s’affiche.
3. Sélectionnez les propriétés que vous voulez associer.
4. Cliquez sur OK : les attributs combinés s'afficheront dans la zone de liste Propriétés alias.
Exemple
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
313
Utilisation de variables structurées
Si vous insérez dans une propriété « Couleur », la couleur de remplissage de tous les widgets (par ex., filed1.fill et
BtnStd4.btn.fill) lorsque vous définissez la propriété Couleur exposée du widgets personnalisé, toutes les couleurs des
widgets inclus changeront.
Utilisation de variables structurées
Un problème commun en utilisant un widget qui utilisent de nombreuses variables est la nécessité de créer des instances
du widget en donnant uniquement le nom de la variable de la structure qui contient toutes les variables au lieu de configurer
chaque variable individuelle.
Par exemple, pensez au widget ci-dessous. Il utilise quatre variables, le nom de la pièce, la température, l'humidité et la
pression. Si nous voulons utiliser deux instances de ce widget pour deux pièces différentes, nous devons configurer huit
variables, quatre variables pour chaque pièce.
En utilisant une propriété de paramètre, il est possible de définir toutes les liaisons de données du widget en donnant
uniquement le nom de la structure.
Un champ « Paramètre » peut être ajouté à l'intérieur du widget personnalisé en utilisant l'icône « Ajouter Paramètre » :
314
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33 Widgets personnalisés
Pour configurer les liaisons de données du widget personnalisé, le mot-clé ${RoomID} peut être utilisé pour faire référence
à l'instance de structure
Filtre type
Utilisation du paramètre « Filtre type », quand attacher à la variable est ouvert, les variables répertoriées seront filtrées en
utilisant la valeur de filtre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
315
JavaScript dans les widgets personnalisés
JavaScript dans les widgets personnalisés
Les fonctions JavaScript peuvent être intégrées dans les widgets personnalisés.
Après avoir double-cliquer sur le widget personnalisé et cliqué sur le cadenas, le mode d'édition est actif et il est possible
d'associer le code JavaScript pour les événements disponibles.
316
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33 Widgets personnalisés
Noter l'utilisation de l'opérateur this. qui est nécessaire pour permettre l'instance multiple du widget personnalisé.
Si vous avez besoin de faire référence à un élément du widget, vous pouvez utiliser le mot-clé wgt.it pour référencer à
l'identifiant de l'instance de widget active, comme pour l'exemple ci-dessous :
Si vous coupez et collez des instances du widget personnalisé de l'exemple ci-dessus, vous obtiendrez le résultat cidessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
317
Galerie de l’utilisateur
Noter que le widget personnalisé peut aussi passer à l'intérieur de la galerie de l'utilisateur pour une réutilisation
ultérieure.
Galerie de l’utilisateur
Vous pouvez sauvegarder les widgets créés par les développeurs dans la galerie des widgets, afin de pouvoir les utiliser
durant le développement de nouveaux projets.
Barre d'outils widgets utilisateur
Commande
Description
Ouvrez le dossier des widgets sélectionnés dans l'éditeur AGI Creator
Ajoutez un nouveau dossier de widgets
Effacez le dossier actuellement sélectionné
Sélectionnez le dossier des widgets utilisateur
Pour ajouter un nouveau widget dans la galerie utilisateur, ouvrez le dossier de widgets, puis éditez la page de galeries en
créant ou en ajoutant le nouveau widget.
Astuce : Pour importer un sous-dossier galerie utilisateur, copiez simplement le dossier à importer et collez-le
dans le principal fichier galerie utilisateur.
318
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
33 Widgets personnalisés
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
319
Galerie de l’utilisateur
320
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
34
Envoyer un message par e-mail
Envoyer des e-mails à l'aide de l'action E-mailEnvoyé, y compris les variables dans le corps et les pièces jointes du
message.
L'action E-mailEnvoyé a été créée pour travailler avec les alarmes et les planificateurs, mais peut être déclenchée et
exécutée par de nombreux autres événements.
Configurer le serveur e-mail
322
Configurer les e-mails
322
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
321
Configurer le serveur e-mail
Configurer le serveur e-mail
Pour configurer le serveur e-mail, entrez les informations suivantes pour le paramètre ConfigEmail :
Paramètre
Description
Adresse SMTP
Adresse de serveur SMTP.
Port de serveur
Port pour la connexion au serveur SMTP (par défaut = 25).
Requiert
authentification
Sélectionnez ce paramètre si le serveur SMTP requiert une authentification.
Identifiant
Identifiant pour envoyer des e-mails avec le serveur SMTP.
Mot de passe
Mot de passe pour envoyer des e-mails avec le serveur SMTP.
Cryptage
Type de cryptage (aucun ou SSL).
Cliquez sur + pour ajouter plus de serveurs e-mails.
Astuce : Utilisez les variables si vous voulez changer les paramètres du serveur de manière dynamique depuis
la HMI Runtime.
Configurer les e-mails
Entrez les informations suivantes pour le paramètre InfoEmail :
Paramètre
Description
Nom
Optionnel, cette information sert uniquement pour l'enregistrement.
Description Optionnel, cette information sert uniquement pour l'enregistrement.
De
Optionnel, adresse e-mail de l'expéditeur (par exemple, [email protected]).
À
Adresses e-mail des destinataires. Pour entrer plusieurs adresses, séparez-les avec un pointvirgule.
Objet
Objet de l'e-mail.
Pièce
jointe
Le chemin du fichier est envoyé en pièce jointe. Seule une pièce jointe à la fois peut être
envoyée.
Note : La taille maximale des pièces jointes est généralement définie par le serveur
SMTP.
Texte
Contenu principal de l'e-mail. Vous pouvez y insérer des variables live lorsque vous les
incluez entre crochets.
Par exemple, un corps de message « Valeur Tag1 est [Tag1] » est envoyé comme « Valeur
Tag1 est 45 », si la valeur actuelle de Tag1 est 45.
322
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
34 Envoyer un message par e-mail
Astuce : Associez une variable de chaîne aux champs De, À et Objet pour que leurs valeurs soient changées
dans le HMI Runtime.
AVERTISSEMENT : La taille maximale du corps du message est de 4096 octets, le texte qui dépasse
sera tronqué.
Ajouter des modèles d'e-mails
Cliquez sur + pour ajouter plus de modèles.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
323
Configurer les e-mails
324
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35
JavaScript
L'objectif de cette section est de décrire comment est utilisé JavaScript dans les applications AGI Creator. Il n'a en
revanche pas pour but d'expliquer le langage JavaScript lui-même.
JavaScript AGI Creatorse base sur le langage de programmation ECMAScript http://www.ecmascript.org , tel que défini
par la norme ECMA-262.
Si vous maîtrisez JavaScript, vous pouvez utiliser le même type de commandes dans AGI Creatorque celles que vous
utiliseriez dans un navigateur web. Si vous ne maîtrisez pas le langage ECMAScript, veuillez consulter la page :
https://developer.mozilla.org/en/JavaScript
Éditeur JavaScript
327
Exécution des fonctions JavaScript
327
Événements
329
Événements de widget
330
Événements de page
334
Événements système
335
Objets
336
Objets de classe widget
337
Propriétés du widget
338
Méthodes du widget
340
Objet de page
342
Propriétés de l'objet de page
342
Méthodes associées à l'objet de page
343
Objet de groupe
345
Méthodes d'objet de groupe
345
Objet du projet
346
Propriétés d'objet du projet
346
Méthodes d'objet du projet
347
Widgets d'objet du projet
357
Objet d'état
358
Méthodes d'objet d’état
358
Mots-clés
359
Fonctions générales
360
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
325
Prendre en main la lecture/l’écriture de fichiers
360
Limites lors du travail avec des widgets en JavaScript
363
Déboguer JavaScript
364
326
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Éditeur JavaScript
AGI Creator inclut un éditeur JavaScript puissant.
Double-cliquez sur l'éditeur pour afficher l'ensemble des commandes disponibles.
Exécution des fonctions JavaScript
Les fonctions JavaScript sont exécutées lorsque des événements se produisent. Par exemple, un utilisateur peut définir un
script pour l'événement OnMouseClick et le script JavaScript est exécuté lorsque vous appuyez sur le bouton sur le
périphérique IHM.
Les fonctions JavaScript sont exécutées uniquement lorsque l'événement programmé se produit et n'est pas cyclique.
Cette approche minimise le traitement requis pour exécuter une logique dans le périphérique IHM.
AGI Creator fournit un moteur JavaScript fonctionnant au niveau du client. Chaque page de projet peut contenir des scripts
ayant une étendue locale sur la page où ils sont ajoutés. Vous pouvez créer des scripts globaux pour qu'ils soient exécutés
par des événements de planificateur ou par des événements d'alarme.
Dans les deux cas, les scripts sont exécutés sur le client. Cela signifie que lorsque plus d'un client est connecté au
périphérique IHM (pour un ordinateur externe exécutant le AGI Client), chaque client exécute le même script, fournissant
des résultats de sortie différents selon l'entrée, puisque les entrées fournies à différents clients peuvent être différentes.
Par exemple, si un script agit selon la position d'une barre de défilement et que cette position est différente sur les
différents clients, le résultat du script sera différent sur chaque client.
Fonctions JavaScript pour événements de page
L'éditeur JavaScript s'ouvre lorsque vous ajoutez une action JavaScript dans une liste d'actions.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
327
Exécution des fonctions JavaScript
1. Sélectionnez l'événement qui exécute l'action.
2. Ajoutez une action JavaScript de la catégorie Widget.
3. Laissez le nom de fonction par défaut ou tapez-en un nouveau.
4. Cliquez sur OK pour confirmer : l'éditeur JavaScript affiche la structure de votre fonction.
Vous pouvez aussi ouvrir l'éditeur JavaScript depuis l'onglet Script situé en bas de l'espace de travail.
Fonctions JavaScript pour les alarmes et les événements programmés
Le code JavaScript, associé aux alarmes et aux événements, qui n'est pas associé à une page spécifique peut être édité
depuis la page principale Propriétés projet.
Chemin : VueProjet> double-cliquez sur Propriétés projet
328
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Note : Les actions JavaScript sont des actions client, elles sont donc exécutées uniquement lorsqu'un client est
connecté.
Code JavaScript partagé
La variable globale du projet peut être utilisée pour partager du code JavaScript entre les pages. Les variables sont
créées/initialisées depuis le code JavaScript principal depuis la page Propriétés projet principale et peuvent ensuite être
utilisées depuis les pages du projet.
Événements
Vous pouvez ajouter JavaScript aux catégories d'événements suivantes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
329
Événements de widget
l
Événements de widget
l
Événements de page
l
Événements système
Pour les événements de type :
l
OnMousePress
l
OnMouseRelease
l
OnMouseClick
l
OnWheel
Le paramètre Infos événement de JavaScript contient les propriétés supplémentaires suivantes :
Paramètre
Description
eventInfo.posX
Coordonnée de la souris locale/touche X par rapport aux coordonnées du widget
eventInfo.posY
Coordonnée de la souris locale/touche Y par rapport aux coordonnées du widget
eventInfo.pagePosX
Coordonnée de la souris/touche de la page X
eventInfo.pagePosY
Coordonnée de la souris/touche de la page Y
eventInfo.wheelDelta Delta de la molette de la souris. Valeur entière avec un signe représentant la
direction de rotation.
La valeur réelle est le nombre de rotations en huitièmes de degré. La valeur
minimale dépend de la résolution de la souris. Elle est en général de 120, ce qui
correspond à 15 degrés.
Événements de widget
onMouseClick
void onMouseClick (me, eventInfo)
Cet événement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfoncé et relâché
rapidement.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function buttonStd1_onMouseClick(me, eventInfo) {
//do something…
}
330
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
onMouseHold
void onMouseHold (me, eventInfo)
Cet événement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfoncé et relâché après le
nombre de secondes défini comme temps de maintien dans les propriétés du widget.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function buttonStd1_onMouseHold(me, eventInfo) {
//do something…
}
onMousePress
void onMousePress (me, eventInfo)
Cet événement est disponible uniquement pour les boutons et il se produit lorsque l’on appuie sur le bouton.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function buttonStd1_onMousePress(me, eventInfo) {
//do something…
}
onMouseRelease
void onMouseRelease (me, eventInfo)
Cet événement est disponible uniquement pour les boutons et il se produit lorsque l’on relâche le bouton.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function buttonStd1_onMouseRelease(me, eventInfo) {
//do something…
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
331
Événements de widget
onDataUpdate
boolean onDataUpdate (me, eventInfo)
Cet événement se produit lorsque les données associées au widget changent.
Paramètre Description
me
Objet déclencheur de l'événement
eventInfo
Un objet avec les champs indiqués ci-dessous (vous pouvez vous référer aux champs en utilisant “.” notation du point)
oldValue = Valeur du widget avant le changement
newValue = Valeur qui sera actualisée au widget
attrName = Attribut sur lequel l'événement est généré
index = Index d'attribut entier, le cas échéant, par défaut = 0
mode = W lorsque l'utilisateur est en train d'écrire au widget. R dans tous les autres statuts.
L'événement est déclenché avant que la valeur soit passée au widget, cela signifie que le code JavaScript peut modifier la
valeur avant qu'il ne soit effectivement transmis au widget.
Le code peut terminer par un retour vrai ou retour faux. Après avoir terminé le code avec retour faux, le contrôle est renvoyé
au widget d'appel qui peut lancer d'autres actions.
Après avoir terminé le code avec vrai, le contrôle n’est pas retourné au widget et cela fait en sorte qu'aucune autre action
n’est exécutée après l'événement d'appel.
function buttonStd1_onDataUpdate(me, eventInfo) {
if ( eventInfo.oldValue < 0) {
//do something…
}
retour faux ;
}
OnPan
boolean onGesturePan (me, eventInfo)
Cet événement est uniquement disponible pour les boutons de la zone geste ; il se produit lorsqu’un point à l'intérieur de la
zone a été appuyé et qu’un mouvement a été détecté.
Paramètre
Description
me
Objet déclencheur de l'événement.
eventInfo
id = Gesture id ; utilisé pour identifier les différents gestes.
running = Vrai, sauf pour le dernier événement livré pour informer l’achèvement du geste.
dx = Total de mouvements de l'axe X en unités de pixels de l'écran depuis la position initiale de contact.
332
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Paramètre
Description
dy = Total de mouvements de l'axe Y en unités de pixels de l'écran depuis la position initiale de contact.
function gstArea_onGesturePan(me, eventInfo)
{
wTYPE.setProperty("value","PAN");
wID.setProperty("value",eventInfo.id);
wDX.setProperty("value",eventInfo.dx);
wDY.setProperty("value",eventInfo.dy);
wRUN.setProperty("value",eventInfo.running);
}
OnPinch
boolean onGesturePinch(me, eventInfo)
Cet événement est uniquement disponible pour les boutons de la zone geste ; il se produit lorsque deux points à l'intérieur
de la zone ont été appuyés et qu’un mouvement a été détecté.
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent générer des événements de
pincement
Paramètre Description
me
Objet déclencheur de l'événement
eventInfo
id = Gesture id ; utilisé pour identifier les différents gestes.
running = Vrai, sauf pour le dernier événement livré pour informer l’achèvement du geste.
dx = Total de mouvements de l'axe X en unités de pixels de l'écran depuis la position initiale de contact. Il
représente le changement de distance entre les doigts. La valeur positive signifie que la distance
augmente ; La valeur négative signifie que la distance diminue. Cette quantité peut être utilisée pour
contrôler une valeur de zoom.
dy = Total de mouvements de l'axe Y en unités de pixels (voir dx).
function gstArea_onGesturePinch(me, eventInfo)
{
wTYPE.setProperty("value","PINCH");
wID.setProperty("value",eventInfo.id);
wDX.setProperty("value",eventInfo.dx);
wDY.setProperty("value",eventInfo.dy);
wRUN.setProperty("value",eventInfo.running);
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
333
Événements de page
Événements de page
onActivate
void onActivate( me, eventInfo )
Cet événement survient toutes les fois que la page s'affiche.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Réservés à une utilisation ultérieure
JavaScript sera exécuté lorsque la page sera active, autrement dit lorsque la page sera chargée.
function Page1_onActivate(me, eventInfo) {
//do something…
}
onDeactivate
void onDeactivate( me, eventInfo )
Cet événement survient lorsque vous quittez la page.
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Réservés à une utilisation ultérieure
function Page1_onDeactivate(me, eventInfo) {
//do something…
}
onWheel
void onDeactivate( me, eventInfo )
Cet événement survient lorsqu'un dispositif à molette bouge (par exemple, une molette de souris).
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function Page1_onMouseWheelClock(me, eventInfo) {
334
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
//do something…
}
Événements système
Les événements de système peuvent être liés à :
l
planificateur
l
des alarmes
l
un périphérique à molette
Important : Assurez-vous de ne pas dupliquer les noms de fonctions JavaScript au niveau de la page
et du projet. Quand un conflit se produit, c’est-à-dire deux fonctions avec le même nom dans la page
en cours et au niveau du projet, le système exécute la fonction de rappel JavaScript au niveau de la
page.
Quand un rappel JavaScript ne se trouve pas dans la page courante, le système recherche automatiquement au niveau du
projet.
Événements planificateur
Ces événements se produisent lorsqu'ils sont déclenchés par l'action associée dans le planificateur.
Vous pouvez modifier le JavaScript depuis l'onglet Propriétés du projet.
Événements d’alarmes
Ces événements se produisent lorsqu'ils sont déclenchés par la condition d'alarme associée.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
335
Objets
Vous pouvez modifier le JavaScript depuis l'onglet Propriétés du projet.
onWheel
void onDeactivate( me, eventInfo )
Cet événement survient lorsqu'un dispositif à molette bouge (par exemple, une molette de souris).
Paramètre
Description
me
Objet déclencheur de l'événement
eventInfo
Détails sur l'événement déclenché
function Project1_onMouseWheelClock(me, eventInfo) {
//do something…
}
Objets
AGI Creator utilise des objets JavaScript pour accéder aux éléments de la page. Chaque objet se compose de propriétés et
de méthodes utilisées pour définir l'opération et l'aspect de l'élément de page. Les objets suivants sont utilisés pour
interagir avec les éléments de la page du périphérique IHM :
Objet
Description
Widget
C'est la classe de base pour l'ensemble des
éléments sur la page, élément de page inclus
Page
Cet objet référence la page actuelle du périphérique
336
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Objet
Description
IHM. La page est l'objet supérieur de l'écran.
Groupe
Cet objet associe un ensemble de variables pour
permettre un fonctionnement uniforme sur un
ensemble de variables logiquement connectées
Projet
Cet objet définit le widget de projet. Le widget de
projet est utilisé pour récupérer les données du
projet, telles que les variables, les alarmes, les
recettes, les ordonnancements, etc. Il n'y a qu'un
seul widget pour le projet, qui peut être référencé par
les variables du projet.
État
Cet objet est la classe maintenant l'état d'une
variable obtenue à partir de l'environnement
contrôlé. En plus de la valeur elle-même, il contient
l'horodatage indiquant à quel moment la valeur a été
collectée ainsi que les drapeaux signalant la qualité
de la valeur.
Objets de classe widget
La classe de Widget est la base pour l'ensemble des éléments sur une page, élément de page inclus.
Le widget, dans ce cas, ne sert pas à indiquer un objet d'écran spécifique, mais une classe JavaScript.
Changer les propriétés du widget avec JavaScript
Si vous souhaitez modifier les propriétés des widgets avec JavaScript, définir la propriété du widget de l'optimisation
statique à dynamique.
Important : Si la propriété widget de l'optimisation statique n’est pas réglée sur dynamique, les
modifications apportées aux propriétés seront ignorées.
Si un appel à getWidget échoue, le débogueur distant signale l'erreur suivante :
« Essai pour accéder au widget statique optimisé « étiquette1 ». Désactiver l'optimisation statique du widget pour accéder
à un widget depuis le script ».
Cette erreur est également visible en utilisant le fragment de code suivant :
var wgt;
try {
wgt = page.getWidget('label1');
} catch(err) {
alert("" + err);
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
337
Propriétés du widget
Propriétés du widget
Certaines propriétés sont communes à tous les widgets.
objectName
string objectName
Obtenez le nom du widget, un identifiant unique.
function btnStd04_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
var name = wgt.objectName;
}
(Disponible sur pages Web)
x
number x
Obtenez ou définissez la position « x » du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.x = 10;
}
(Disponible sur pages Web)
y
number y
Obtenez ou définissez la position « y » du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.y = 10;
}
(Disponible sur pages Web)
width
number width
Obtenez ou définissez la position « y » du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
338
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
var wgt = page.getWidget("rect1");
wgt.width = 10;
}
(Disponible sur pages Web)
height
number height
Obtenez ou définissez la hauteur du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.height = 10;
}
(Disponible sur pages Web)
visible
boolean visible
Obtenez ou définissez l’état visible du widget.
function btnStd4_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.visible = false;
}
function btnStd5_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.visible = true;
}
value
number value
Obtenez ou définissez la valeur du widget.
function btnStd6_onMouseRelease(me) {
var wgt = page.getWidget("field1");
wgt.value = 100;
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
339
Méthodes du widget
opacity
number opacity (range from 0 to 1)
Obtenez ou définissez l’opacité du widget. Les valeurs sont des décimales de 0 à 1, où 1 est 100 % opaque.
function btnStd8_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.opacity = 0.5;
}
(Disponible sur pages Web)
rotation
number rotation (in degrees)
Obtenez et configurez l'angle de rotation pour le widget. La rotation se fait dans le sens horaire et par degrés, en
commençant à la position Est.
function btnStd9_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.rotation = 45;
}
(Disponible sur pages Web)
userValue
string userValue
Obtient ou établit une valeur définie par l'utilisateur pour le widget. Ce champ peut être utilisé par les fonctions JavaScript
pour stocker des données supplémentaires avec la widget.
function btnStd9_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
wgt.userValue = "Here I can store custom data";
}
Chaque widget a des propriétés spécifiques auxquelles vous pouvez accéder en utilisant la notation du point. Pour obtenir
une liste actualisée et détaillée des propriétés, vous pouvez utiliser le Débogueur JavaScript qui inspecte les méthodes et
les propriétés de widget.
Méthodes du widget
Certaines méthodes sont communes à tous les widgets.
getProperty
object getProperty( propertyName, [index] )
340
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Revient à une propriété.
Paramètre
Description
propertyName
Chaîne contenant le nom de la propriété à obtenir
index
Index de l'élément à obtenir à partir du tableau (par défaut = 0)
Presque toutes les propriétés qui sont affichées dans le AGI Creator voletPropriétés peuvent être récupérées en utilisant
la méthode getProperty. La valeur de l'indice est facultative et est uniquement utilisée pour les widgets qui prennent en
charge des tableaux.
function buttonStd1_onMouseRelease(me, eventInfo) {
var shape = page.getWidget("rect2");
var y_position = shape.getProperty("y");
}
function buttonStd2_onMouseRelease(me, eventInfo) {
var image = page.getWidget("multistate1");
var image3 = image.getProperty("imageList", 2);
//…
}
(Disponible sur pages Web)
setProperty
boolean setProperty( propertyName, value, [index] )
Définissez une propriété pour le widget.
Paramètres
Paramètre
Description
propertyName
Chaîne contenant le nom de la propriété à définir
value
Chaîne contenant la valeur à définir la propriété.
index
Index de l'élément à définir à partir du tableau (par défaut = 0)
Presque toutes les propriétés qui sont affichées dans le AGI Creator voletPropriétés peuvent être définie par cette
méthode. La valeur de l'indice est facultative et est uniquement utilisée pour les Widgets qui prennent en charge des
tableaux (par exemple, un widget Image Multi-état). La méthode setProperty retourne une valeur booléenne (vrai ou
faux) pour indiquer si la propriété a été définie ou non.
function buttonStd1_onMouseRelease(me, eventInfo) {
var setting_result = shape.setProperty("y", 128);
if (setting_result)
alert("Shape returned to start position");
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
341
Objet de page
}
function buttonStd2_onMouseRelease(me, eventInfo) {
var image = page.getWidget("multistate1");
var result = image.setProperty("imageList", "Fract004.png", 2);
//…
}
(Disponible sur pages Web)
Objet de page
Cet objet référence la page actuelle du périphérique IHM. La page est l'objet supérieur de l'écran.
Propriétés de l'objet de page
Propriétés disponibles au niveau de la page.
backgroundColor
string backgroundColor (in format rgb(xxx, xxx, xxx) where xxx range from 0 to 255)
Couleur de fond de page.
function btnStd11_onMouseRelease(me) {
page.backgroundColor = "rgb(128,0,0)";
}
(Disponible sur pages Web)
width
number width
Largeur de la page en pixels.
function btnStd05_onMouseRelease(me) {
var middle_x = page.width / 2;
}
(Disponible sur pages Web, avec récupération uniquement)
height
number height
Hauteur de la page en pixels.
342
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
function btnStd05_onMouseRelease(me) {
var middle_y = page.height / 2;
}
(Disponible sur pages Web, avec récupération uniquement)
userValue
string userValue
Obtient ou établit une valeur définie par l'utilisateur pour le widget. Ce champ peut être utilisé par les fonctions JavaScript
pour stocker des données supplémentaires avec la page.
function btnStd9_onMouseRelease(me) {
page.userValue = "Here I can store custom data";
}
(Disponible sur pages Web)
Méthodes associées à l'objet de page
Méthodes pouvant être utilisées au niveau de la page.
getWidget
object getWidget( wgtName )
Retourne le widget portant le nom indiqué.
Paramètre
Description
wgtName
Chaîne contenant le nom du widget
Valeur de retour
Un objet représentant le widget. Si le widget n'existe pas, le retour sera nul.
function btnStd1_onMouseRelease(me) {
var my_button = page.getWidget("btnStd1");
}
(Disponible sur pages Web)
setTimeout
number setTimeout( functionName, delay )
Démarre un minuteur qui appelle une fonction donnée après un délai donné.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
343
Méthodes associées à l'objet de page
Paramètre
Description
functionName
Chaîne contenant le nom de la fonction à appeler
retard
Délai en millièmes de secondes
Valeur de retour
Nombre correspondant au timerID.
var duration = 3000;
var myTimer = page.setTimeout("innerChangeWidth()", duration);
(Disponible sur pages Web)
clearTimeout
void clearTimeout( timerID )
Interrompt et efface le minuteur de délai d'attente avec le minuteur indiqué.
Paramètre
Description
timerID
Minuteur à effacer et interrompre
var duration = 3000;
var myTimer = page.setTimeout("innerChangeWidth()", duration);
// do something
page.clearTimeout(myTimer);
(Disponible sur pages Web)
setInterval
number setInterval( functionName, interval )
Démarre un minuteur qui exécute la fonction indiquée selon l'intervalle indiqué.
Paramètre
Description
functionName
Chaîne contenant le nom de la fonction à appeler
interval
Intervalle en millièmes de secondes
Valeur de retour
Nombre correspondant au timerID.
var interval = 3000;
var myTimer = page.setInterval("innerChangeWidth()", interval);
(Disponible sur pages Web)
344
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
clearInterval
void clearInterval( timerID )
Interrompt et efface le minuteur à intervalle avec le minuteur indiqué.
Paramètre
Description
timerID
Minuteur à effacer et interrompre
var interval = 3000;
var myTimer = page.setInterval("innerChangeWidth()", interval);
// do something
page.clearInterval(myTimer);
(Disponible sur pages Web)
clearAllTimeouts
void clearAllTimeouts()
Efface tous les minuteurs démarrés.
page.clearAllTimeouts();
(Disponible sur pages Web)
Objet de groupe
Un groupe est un élément logique de base qui associe un ensemble de variables logiques.
Méthodes d'objet de groupe
Méthodes pouvant être utilisées avec les objets de groupe.
getTag
object getTag( TagName )
Obtient la variable spécifiée par Tagname à partir de l'objet de groupe.
Paramètre
Description
Nomvariable
Chaîne représentant le nom de variable
Valeur de retour
Un objet représentant la valeur de la variable ou, si la valeur de variable est un tableau, l'intégralité du tableau. Si vous avez
besoin de récupérer un élément du tableau, sélectionnez la méthode getTag disponible dans l'objet du projet. Indéfini est
retourné si la variable n'est pas valide.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
345
Objet du projet
var group = new Group();
project.getGroup("GroupName", group);
var value = group.getTag("Tag1");
(Disponible sur pages Web)
getCount
number getCount()
Retourne le nombre total de variables dans ce groupe.
var group = new Group();
project.getGroup("GroupName", group);
var value = group.getCount();
(Disponible sur pages Web)
getTags
object getTags()
Retourne la liste de toutes les variables du groupe.
function {
var group = new Group();
project.getGroup("enginesettings", group);
var tagList = group.getTags();
for(var i = 0; i < tagList.length; i++){
var tagName = tagList[i];
//do something…
};
(Disponible sur pages Web)
Objet du projet
Cet objet définit le widget de projet. Le widget de projet est utilisé pour récupérer les données du projet, telles que les
variables, les alarmes, les recettes, les ordonnancements, etc. Il n'y a qu'un seul widget pour le projet, qui peut être
référencé par les variables du projet.
Propriétés d'objet du projet
Propriétés à définir au niveau du projet.
startPage
string startPage
346
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Page affichée au démarrage du projet.
var startPage = project.startPage;
project.startPage = "Page2.jmx";
Méthodes d'objet du projet
Méthodes à utiliser au niveau du projet.
nextPage
void nextPage()
Le script exécute l'action de la Page suivante.
project.nextPage();
(Disponible sur pages Web)
prevPage
void prevPage()
Le script exécute l'action de la page précédente.
project.prevPage();
(Disponible sur pages Web)
lastVisitedPage
void lastVisitedPage()
Le script exécute l'action de la dernière page visitée.
project.lastVisitedPage();
(Disponible sur pages Web)
homepage
void homePage()
Le script exécute l'action de la Page d'accueil.
project.homePage();
(Disponible sur pages Web)
loadPage
void loadPage(pageName)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
347
Méthodes d'objet du projet
Le script exécute le chargement de la page demandée définie dans le script.
project.loadPage("Page5.jmx");
(Disponible sur pages Web)
AVERTISSEMENT : À chaque changement de page, la suppression de l'ensemble des événements de
temps actifs est forcée et la procédure JavaScript continue à fonctionner jusqu'à la fin de la
suppression avant de passer à la nouvelle page.
showDialog
void showDialog(pageName)
Le script exécute l'affichage de la page de dialogue.
project.showDialog("Dialog.jmx");
(Disponible sur pages Web)
closeDialog
void closeDialog()
Le script exécute la fermeture de la page de dialogue ouverte.
project.closeDialog();
(Disponible sur pages Web)
showMessage
void showMessage( message )
Le script exécute l'affichage de la fenêtre contextuelle du message.
project.showMessage("Hi This is test message");
(Disponible sur pages Web)
getGroup
number getGroup( groupName, groupInstance, [callback] )
Méthode de lecture rapide ; permet d'obtenir les valeurs de l'ensemble des variables d'un groupe.
Paramètre
Description
groupName
Chaîne contenant le nom du groupe
groupInstance
Élément de groupe à remplir
fonction de rappel
Chaîne contenant le nom de la fonction à appeler quand le groupe est prêt
348
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Valeur de retour
Un chiffre représentant l'état : 1 pour succès, 0 pour échec.
var group = new Group();
var status = project.getGroup ("enginesettings", group);
if (status == 1) {
var value = group.getTag("Tag1");
if (value!=undefined) {
// do something with the value
}
}
var g = new Group();
var status = project.getGroup ("enginesettings", g,
function (groupName, group) { fnGroupReady(groupName, group);} );
function fnGroupReady(groupName, group) {
var val = group.getTag("Tag1");
if (val!=undefined) {
// do something with the value
}
}
(Disponible sur pages Web)
getTag
object getTag( tagName, state, index, forceRefresh)
void getTag( tagName, state, index, callback, forceRefresh)
Il retourne la valeur de variable ou le tableau complet si la valeur d'index est -1 du tagName indiqué.
Paramètre
Description
tagName
Chaîne du nom de variable
état
Élément d'état à remplir
index
Index en cas de variable sous forme de tableau. -1 retourne le tableau complet. Par défaut = 0.
fonction de
rappel
Nom de fonction si une lecture asynchrone est requise. Default = “".
forceRefresh
(Paramètre optionnel) Vrai = le runtime lira une valeur mise à jour de la variable directement à partir du
périphérique. Faux par défaut
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
349
Méthodes d'objet du projet
Valeur de retour
La valeur des variables est retournée. Si la variable est un tableau et l'index = -1, le tableau complet est retourné. Pour les
variables autres que les tableaux, fournissez un index à 0.
var state = new State();
var value = project.getTag("Tag1", state, 0);
//
//for non array type
//tags index is not considered, so can be left as 0
//
if (value!=undefined) {
//...do something with s
}
var state = new State();
project.getTag("Tag1", state, -1,
function(tagName, tagState) { fnTagReady(tagName, tagState); });
function fnTagReady(tagName, tagState) {
if (tagName=="Tag1") {
var myValue = tagState.getValue();
}
}
(Disponible sur pages Web)
setTag
number setTag( tagName, tagValue, [index], [forceWrite] )
Définit la variable indiquée dans le projet. Le nom et la valeur sont dans les chaînes.
Paramètre
Description
tagName
Chaîne du nom de variable
tagValue
Objet contenant la valeur à écrire
index
Index en cas de variable sous forme de tableau. -1 transmet le tableau complet. Par défaut = 0.
forceWrite Valeur booléenne pour activer l'écriture forcée des variables, la fonction attendra que la valeur soit écrite
avant de revenir. Par défaut = faux.
Valeur de retour
Valeur entière indiquant le succès ou l'échec d'une action lorsque forceWrite est vrai. 0 signifie succès et -1 signifie échec.
Si forceWrite est faux, la valeur de retour sera indéfinie.
var val = [1,2,3,4,5];
350
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
var status = project.setTag("Tag1", val, -1, true);
if (status == 0) {
// Success
} else {
// Failure
}
var val = "value";
project.setTag("Tag1", val);
(Disponible sur pages Web)
updateSystemVariables
void project.updateSystemVariables()
Force le rafraîchissement des variables du système.
project.updateSystemVariables()
selectAllAlarms
void project.selectAllAlarms(bool selected)
Sélectionne/désélectionne toutes les alarmes
project.selectAllAlarms(true)
(Disponible sur pages Web)
ackAlarms
void project.ackAlarms()
Confirme toutes les alarmes sélectionnées
project.selectAllAlarms(true);
project.ackAlarms();
project.selectAllAlarms(true);
(Disponible sur pages Web)
resetAlarms
void project.resetAlarms()
Réinitialise toutes les alarmes sélectionnées
project.selectAllAlarms(true);
project.resetAlarms();
project.selectAllAlarms(true);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
351
Méthodes d'objet du projet
(Disponible sur pages Web)
enableAlarms
void project.enableAlarms()
Active toutes les alarmes sélectionnées
project.selectAllAlarms(true);
project.enableAlarms();
project.selectAllAlarms(true);
(Disponible sur pages Web)
getRecipeItem
object getRecipeItem (recipeName, recipeSet, recipeElement)
Obtient la valeur de l'élément d'ensemble de recette indiqué.
Paramètre
Description
recipeName
Chaîne représentant le nom de recette
recipeSet
Chaîne représentant l'ensemble de recette, peut être soit le nom de l'ensemble de recette, soit l'index
d'ensemble basé sur 0.
recipeElement Chaîne représentant l'Élément de recette, peut être soit le nom d'élément, soit l'index d'élément basé
sur 0.
Valeur de retour
Un objet ayant la valeur de la recette. Non défini est retourné si non valide. Si de type tableau, un type d'objet sous forme
de tableau est retourné.
var value = project.getRecipeItem("recipeName", "Set", "Element");
setRecipeItem
number setRecipeItem (recipeName, recipeSet, recipeElement, value )
Obtient la valeur de l'élément d'ensemble de recette indiqué.
Paramètre
Description
recipeName
Chaîne représentant le nom de recette
recipeSet
Chaîne représentant l'ensemble de recette, peut être soit le nom de l'ensemble de recette, soit l'index
d'ensemble basé sur 0.
recipeElement Chaîne représentant l'Élément de recette, peut être soit le nom d'élément, soit l'index d'élément basé
sur 0.
value
352
Un objet contenant la valeur à stocker dans la recette. Il peut être sous forme de tableau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Valeur de retour
Valeur entière indiquant le succès ou l'échec d'une action. 0 signifie succès et -1 signifie échec.
var val = [2,3,4];
project.setRecipeItem("recipeName", "Set", "Element", val);
if (status == 0) {
// Success
} else {
// Failure
}
downloadRecipe
void downloadRecipe (recipeName, recipeSet )
Télécharge l'ensemble de recette vers la variable correspondante.
Paramètre
Description
recipeName Chaîne représentant le nom de recette
recipeSet
Chaîne représentant l'ensemble de recette, peut être soit le nom de l'ensemble de recette, soit l'index
d'ensemble basé sur 0.
project.downloadRecipe("recipeName", "Set");
uploadRecipe
void uploadRecipe (recipeName, recipeSet )
Charge la valeur des variables dans l'ensemble de recette fourni.
Paramètre
Description
recipeName Chaîne représentant le nom de recette
recipeSet
Chaîne représentant l'ensemble de recette, peut être soit le nom de l'ensemble de recette, soit l'index
d'ensemble basé sur 0.
project.uploadRecipe("recipeName", "Set");
launchApp
void launchApp( appName, appPath, arguments, singleInstance)
Exécute une application externe.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
353
Méthodes d'objet du projet
Paramètre
Description
appName
Chaîne contenant le nom de l'application
appPath
Chaîne contenant le chemin absolu de l'application
Arguments
Chaîne contenant les arguments à envoyer à l'application
singleInstance
vrai = une seule instance autorisée, faux = multiples instances autorisées
project.launchApp("PDF.exe","\\Flash\\QTHMI\\PDF","\\USBMemory\\file.pdf","true");
printGfxReport
void printGfxReport( reportName, silentMode)
Imprime le rapport graphique spécifié par reportName.
Paramètre
Description
reportName
Chaîne contenant le nom de rapport
silentMode
Vrai = mode silencieux activé. Aucune boîte de dialogue des paramètres d'impression ne s'affiche.
project.printGfxReport("Report Graphics 1", true);
printText
void printText( text, silentMode)
Imprime un texte fixe.
Paramètre
Description
text
Chaîne à imprimer
silentMode
Vrai = mode silencieux activé. Aucune boîte de dialogue des paramètres d'impression ne s'affiche.
project.printText("Hello I Am Text Printing",true);
printBytes
void printBytes( text, silentMode)
Imprime une chaîne hexadécimale chiffrant les données d'impression. Par exemple, « 1b30 » pour imprimer < ESC 0 >
Paramètre
Description
text
Chaîne hexadécimale à imprimer
silentMode
Vrai = mode silencieux activé. Aucune boîte de dialogue des paramètres d'impression ne s'affiche.
354
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
project.printText("Hello I Am Text Printing",true);
emptyPrintQueue
void emptyPrintQueue()
Vide la queue d'impression. La tâche actuelle ne sera pas annulée.
project.emptyPrintQueue();
pausePrinting
void pausePrinting();
Suspend les opérations d'impression. Ne suspendra pas l'impression d'une page déjà envoyée à l'imprimante.
project.pausePrinting();
resumePrinting
void resumePrinting();
Reprend l'impression suspendue.
project.resumePrinting();
abortPrinting
void abortPrinting();
Annule l'opération d'impression en cours et continue avec l'élément suivant dans la queue. Cette commande ne suspendra
pas l'impression d'une page déjà envoyée à l'imprimante.
project.abortPrinting();
printStatus
project.printStatus;
Retourne une chaîne représentant l'état d'impression actuel.
Chaîne d'état
Description
error
Une erreur est survenue pendant l'impression
printing
Impression en cours
idle
Le système est prêt à accepter de nouvelles tâches
paused
L'impression a été suspendue
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
355
Méthodes d'objet du projet
var status = project.printStatus;
project.setTag("PrintStatus",status);
printGfxJobQueueSize
project.printGfxJobQueueSize;
Retourne le nombre de rapports graphiques dans la queue d'impression.
var gfxqueuesize = project.printGfxJobQueueSize;
project.setTag("printGfxJobQueueSize",gfxqueuesize);
printTextJobQueueSize
project.printTextJobQueueSize;
Retourne le nombre de rapports textes dans la queue d'impression.
var textjobqueuesize = project.printTextJobQueueSize;
project.setTag("printTextJobQueueSize",textjobqueuesize);
printCurrentJob
project.printCurrentJob;
Retourne une chaîne représentant la tâche actuelle en cours d'impression
var currentjob = project.printCurrentJob;
project.setTag("printCurrentJob",currentjob);
printActualRAMUsage
project.printActualRAMUsage;
Retourne une estimation sur l'utilisation de RAM pour les queues d'impression
var myVar = project.printActualRAMUsage;
alert(" actual ram usage is "+ myVar);
printRAMQuota
project.printRAMQuota;
Retourne l'utilisation maximum de RAM autorisée pour les queues d'impression
var ramquota = project.printRAMQuota;
project.setTag("printRAMQuota",ramquota);
356
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
printActualDiskUsage
project.printActualDiskUsage;
Retourne l'utilisation du disque de dossier spool (pour les impressions PDF)
var myVar1 = project.printActualDiskUsage;
alert(" actual disk usage is "+ myVar1);
printDiskQuota
project.printDiskQuota;
Retourne la taille maximale autorisée du dossier spool (pour les impressions PDF).
var ramquota = project.printRAMQuota;
var diskquota = project.printDiskQuota;
printSpoolFolder
project.printSpoolFolder;
Retourne le chemin du dossier spool actuel (pour les impressions PDF).
var spoolfolder = project.printSpoolFolder;
project.setTag("printSpoolFolder",spoolfolder);
printPercentage
project.printPercentage;
Retourne le pourcentage d'avancement de la tâche actuelle (significatif seulement pour les rapports graphiques
multipages)
var percentage = project.printPercentage;
project.setTag("printPercentage",percentage);
Widgets d'objet du projet
getCurrentPageName
string getCurrentPageName()
Revenir au nom de la page active en cours
// Get PageMgr widget
var pageMgr = project.getWidget( "_PageMgr" );
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
357
Objet d'état
// Show Current Page
var currentPageName = pageMgr.getCurrentPageName();
project.showMessage( "Current active page is: " + currentPageName );
(Disponible sur pages Web)
hasPage
boolean hasPage(string pageName)
Revenir sur vrai si la page existe, sinon sur faux
// Get PageMgr widget
var pageMgr = project.getWidget( "_PageMgr" );
//Page exists
var pageExists = pageMgr.hasPage( "Page10" );
if (pageExists) {
project.showMessage( "Page10 exists" );
} else {
project.showMessage( "Hei Page10 not exists!" );
}
(Disponible sur pages Web)
Objet d'état
Il s'agit de la classe maintenant l'état d'une variable obtenue à partir de l'environnement contrôlé.
Méthodes d'objet d’état
Méthodes à utiliser avec les objets d'état.
getQualityBits
number getQualityBits()
Renvoie un entier - une combinaison de bits indiquant la qualité de valeur de la variable.
var state = new State();
var value = project.getTag("Tag1", state, 0);
var qbits = state.getQualityBits();
(Disponible sur pages Web)
getTimestamp
number getTimestamp()
Renvoie la valeur du temps échantillonnée.
358
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Valeur de retour
Un nombre contenant l'horodatage (par exemple 1315570524492).
Note : La date est un type natif de données de JavaScript.
var state = new State();
var value = project.getTag("Tag1", state, 0);
var ts = state.getTimestamp();
isQualityGood
boolean isQualityGood()
Renvoir si la valeur contenue dans cet objet d'état est fiable.
Valeur de retour
Une valeur booléenne de vrai si la qualité est bonne, sinon faux.
var state = new State();
var value = project.getTag("Tag1", state, 0);
if (state.isQualityGood()) {
// do something…
}
(Disponible sur pages Web)
Mots-clés
Des objets globaux sont prédéfinis et peuvent être référencés par les noms suivants.
page
object page
Référence l'objet de page pour la page courante.
function btnStd04_onMouseRelease(me) {
var wgt = page.getWidget("rect1");
var name = wgt.objectName;
}
projet
object project
Référence le widget de projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
359
Fonctions générales
var group = new Group();
project.getGroup("GroupName", group);
var value = group.getCount("Tag1");
Fonctions générales
print
void print( message )
Imprime un message à la fenêtre d'enregistrement IHM.
Paramètre
Description
message
Chaîne de message
print("Test message");
alert
void alert( message )
Affiche une boîte de dialogue contextuelle avec un message prédéfini. L'utilisateur doit appuyer sur le bouton OK dans la
boîte de dialogue pour poursuivre l'exécution du script.
Paramètre
Description
message
Chaîne de message
Note : La fonction alerte peut être utilisée pour le débogage des fonctions JavaScript.
alert("Test message");
(Disponible sur pages Web)
Prendre en main la lecture/l’écriture de fichiers
Create folder
boolean fs.mkdir(strPath);
Crée un dossier, s'il n'existe pas déjà, dans le chemin spécifié. Retourne vrai en cas de succès et faux en cas d'échec.
Paramètre
Description
strPath
Chaîne de chemin
360
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Remove folder
boolean fs.rmdir(dirPath);
Supprime le répertoire à strPath s'il existe et s'il est vide. Retourne vrai en cas de succès et faux en cas d'échec.
Paramètre
Description
dirPath
Chaîne de dossier
Read folder content
object fs.readdir(dirPath);
Lit les contenus d'un dossier. Retourne un tableau des noms des fichiers dans le dossier en excluant '.' and '..'. Retourne
une liste vide en cas d'échec.
Paramètre
Description
dirPath
Chaîne de dossier
Read file
object fs.readFile(strfile [,strFlag]);
Ouvre le fichier strFile en mode lecture, lit son contenu et le retourne.
Paramètre
Description
strFile
Chaîne de nom de fichier
strFlag
Mode lecture de fichier :
"b" lit et retourne en tant que fichier binaire (autrement retourne un fichier de texte)
Write file
fs.writeFile(strFile, fileData, [strFlag]);
Crée le fichier strFile s'il n'est pas présent. Ouvre le fichier strFile en mode écriture et écrit les données fileData au fichier.
Paramètre
Description
strFile
Chaîne de nom de fichier
fileData
Données destinées à être écrites sur le fichier dans un tableau d'octets
strFlag
Mode écriture de fichier :
l
“a” : ajoute le fileData à la fin du fichier de texte
l
“r” : remplace les contenus du fichier par le fileData
l
“ab” : ajoute le fileData à la fin du fichier binaire
l
“rb” : remplace les contenus du fichier binaire par le fileData
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
361
Prendre en main la lecture/l’écriture de fichiers
Le drapeau par défaut sert à écrire des fichiers de texte en mode ajout et écriture. Le chemin de fichier sera créé s'il n'est
pas présent.
Retourne -1 en cas d'erreurs d'écriture.
Ajouter un fichier
int fs.appendFile(strFile, fileData);
Si les fichiers n'existe pas, les créer, sinon ajouter au fichier existant. Renvoie le nombre de caractères écrits ou -1 en cas
d'erreur.
Paramètre
Description
strFile
Chaîne de nom de fichier
fileData
Données destinées à être écrites sur le fichier dans un tableau d'octets
File exists
boolean fs.exists(strPath)
Retourne vrai si le fichier ou le dossier existent au strPath.
Paramètre
Description
strPath
Chaîne de chemin
Remove file
boolean fs.unlink(strPath)
Supprime le fichier sélectionné au strPath du filesystem s'il existe. Retourne vrai en cas de succès et faux en cas d'échec.
Paramètre
Description
strPath
Chaîne de chemin
File status
object fs.stat(strPath)
Récupère les informations sur le fichier/dossier présent au chemin spécifié.
Paramètre
Description
strPath
Chaîne de chemin de fichier/dossier
var fileStats = var fs.stat(strPath)
fileStats.isFile
Vrai si le chemin est un fichier
fileStats.isDir
Vrai si le chemin est un dossier
362
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
fileStats.size
Taille en octets de ce fichier
fileStats.atime
Objet de date représentant le moment du dernier accès en mode lecture
fileStats.mtime
Objet de date représentant le moment du dernier accès en mode écriture
fileStats.ctime
L'objet de date représentant le moment de création
fileStats.perm
Permissions de fichier
Si le chemin n'est pas valide, les champs isFile et isDir retournent tous les deux faux.
File permission table
0x4000
Le fichier est lisible par le propriétaire du fichier
0x2000
Le fichier est modifiable par le propriétaire du fichier
0x1000
Le fichier est exécutable par le propriétaire du fichier
0x0400
Le fichier est lisible par l'utilisateur
0x0200
Le fichier est modifiable par l'utilisateur
0x0100
Le fichier est exécutable par l'utilisateur
0x0040
Le fichier est lisible par le groupe
0x0020
Le fichier est modifiable par le groupe
0x0010
Le fichier est exécutable par le groupe
0x0004
Le fichier est lisible par tous
0x0002
Le fichier est modifiable par tous
Notes importantes sur la gestion des fichiers
Le chemin des fichiers et des dossiers doit être de style UNIX. Ce qui implique que le caractère barre oblique inversée (\)
n'est pas reconnu. Veuillez utiliser la barre oblique classique (/) à la place.
L'objet de système de fichier est un objet au niveau du client. Les opérations sont donc effectuées sur le système de fichier
local plutôt que sur le système de fichier du serveur.
L'actuelle API JavaScript d'accès au système de fichier du périphérique a été conçue pour manipuler des fichiers de petite
taille. Lorsqu'un fichier est lu, l'ensemble des contenus du fichier est temporairement stocké dans la RAM disponible pour
l'environnement JavaScript (16MB), avec des exceptions possibles au cas où la mémoire disponible ne serait pas
suffisante. Une bonne pratique en matière de programmation serait d'inclure l'appel fs.readFile() dans un bloc
d'essai/détection.
Limites lors du travail avec des widgets en JavaScript
Les widgets ne peuvent pas être instanciés par JavaScript, ils ne peuvent qu'être accédés et modifiés. Si vous avez
besoin de widgets supplémentaires sur la page, vous pouvez ajouter des widgets masqués sur la page, puis les afficher ou
les positionner en utilisant JavaScript.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
363
Déboguer JavaScript
Déboguer JavaScript
AGI Creator et HMI Runtime incluent un débogueur JavaScript.
Deux types de débogueurs sont disponibles :
l
l
Débogueur de runtime : un débogueur qui s'exécute directement sur le périphérique IHM
Débogueur à distance : un débogueur qui s'exécute sur un ordinateur à distance connecté au périphérique IHM via
Ethernet (en général, un ordinateur qui exécute AGI Creator)
Activer le débogage
Dans le volet Propriétés d’une page, régler le Débogage JavaScript sur vrai.
Pour le débogage des planificateurs et d'alarmes, activez le Débogage JavaScript dans Propriétés du projet.
Dans HMI Runtime, le débogueur affiche les informations de débogage lorsque les événements sont appelés. Dans le
volet Locaux, vous pouvez inspecter toutes les variables et tous les éléments.
Pour obtenir un guide de référence complet sur le débogueur de JavaScript, consultez :
http://qt-project.org/doc/qt-4.8/qtscriptdebugger-manual.html
364
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
35 JavaScript
Débogueur à distance JavaScript
Chemin : Exécuter> Démarrer débogueur à distance JS
1. Dans le projet Propriétés, définissez les paramètres Permettre JavaScript à distance et Débogage JavaScript
sur Vrai dans toutes les pages qui requièrent un débogage.
2. Téléchargez le projet : le message suivant s'affiche en cours de runtime.
3. Dans la fenêtre Débogueur JS, sélectionnez l'IP du périphérique IHM et cliquez sur Associer pour connecter le
débogueur au périphérique IHM.
Le débogueur à distance JavaScript se connecte à HMI Runtime via un port 5100/TCP.
Note : L'outil de débogage à distance de JavaScript n'est pas pris en charge dans AGI Client.
Utilisation de la mémoire JavaScript
Lorsque la mémoire dépasse le maximum, une exception mémoire pleine est levée avec un message personnalisé. Notez
que nous n'avons pas un contrôle précis de l'utilisation réelle de la mémoire, il s'agit donc d'une limite floue. De plus, nous
ne pouvons pas interdire l'allocation (cela arrêterait l'implémentation du moteur), une exception est donc levée uniquement
lorsque la mémoire a déjà dépassé la limite. Avant de lever l'exception, un nettoyage de la mémoire est forcé pour voir si de
la mémoire peut être libérée.
Vous pouvez accéder à la limite de la mémoire JavaScript depuis l'objet global $EngineMemory. Elle est par défaut de
16 MB, ce qui devrait suffire pour une utilisation habituelle de JavaScript (principalement du contrôle, sans beaucoup
d'allocations).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
365
Déboguer JavaScript
l
l
l
$EngineMemory.setLimit()
définissez la mémoire maximale autorisée pour JavaScript (la limite par défaut est 0x00FFFFFF)
$EngineMemory.getLimit()
obtenez la mémoire maximale autorisée pour JavaScript
$EngineMemory.getSize()
obtenez la mémoire en cours d'utilisation par JS (fastMallocStat)
Tester l'exception de mémoire
Pour générer et tester l'exception de mémoire, vous pouvez utiliser les extraits suivants. Notez que nous devons
réinitialiser la limite de la mémoire à 0xffffffff pour exécuter l'alerte, sinon les allocations de mémoire requises pour afficher
l'alerte échoueraient.
366
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
36
Gestes de prise en main
Certains widgets ont la capacité de détecter et de gérer les gestes de déplacement et de pincement.
l
l
Tendances (voir "Gestes de widget de tendance" on page 183 pour plus de détails)
Widget de zone de mouvement Widget spécial conçu pour personnaliser la gestion des événements de geste (voir
"Widget de zone de mouvement" on page 284 pour plus de détails)
Pour les widgets avec une présentation en tableau, quand le paramètre Type de défilement a été réglé sur Dynamique, le
mouvement de déplacement est utilisé pour défiler le tableau en douceur.
l
Alarmes
l
Liste de contrôle
AVERTISSEMENT : le geste de pincement demande deux doigts. Il est disponible uniquement avec
les périphériques IHM supportant un fonctionnement multi-touch (voir "Capacités des périphériques
IHM." on page 431
Astuce : Si vous utilisez un périphérique IHM multi-touch, vous pouvez mettre en place des commandes
sécurisées en programmant des commandes qui ne seront exécutables que par pression simultanée de deux
boutons.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
367
368
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
37
Paramètres du système
Les paramètres du système sont un outil interne du périphérique IHM qui peut être utilisé pour les réglages de base du
périphérique ou pour la mise à jour des composants du système.
Remarque : les composants du système peuvent être mis à jour à partir de AGI Creator (voir "Mettre à jour les
composants système des périphériques IHM" on page 413 pour plus de détails)
AVERTISSEMENT : Travailler avec l'outil Paramètres système est une opération critique et, lorsqu'elle
n’est pas effectuée correctement, peut causer des dommages au produit nécessitant un service du
produit. Contactez le support technique pour l'assistance.
Paramètres du Système sur les Périphériques WinCE
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
370
369
Paramètres du Système sur les Périphériques WinCE
Paramètres du Système sur les Périphériques WinCE
L'outil Paramètres système comprend un menu de rotation, et les boutons de navigation pour faire défiler les options
disponibles.
Pour chaque fonction et composant sur la gauche, le volet Info sur la droite affiche toutes les informations disponibles.
Dans l'exemple, la version du principal composant du Système d’exploitation est représenté.
L’outil des paramètres du système peut être utilisé selon deux modes de fonctionnement :
l
Mode utilisateur
l
Mode système.
Pour chaque mode, différentes options sont disponibles.
Installation du runtime
Les périphériques HMI sont livrés hors d'usine sans Runtime, à la première mise sous tension, IHM affiche l'écran
« Chargeur de runtime ».
Le runtime peut être installé :
l
Automatiquement, via Ethernet sur le premier téléchargement avec AGI Creator
l
Manuellement via clé USB, création d'un « paquet de mise à jour »
370
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
37 Paramètres du système
Installation du Runtime via Ethernet
Pour l’installation du Runtime via Ethernet, suivre la procédure "Télécharger vers le périphérique IHM" on page 78.
AVERTISSEMENT : Le téléchargement via Ethernet de l’installation du runtime requière le
périphérique IHM avec une adresse IP valide.
L'adresse IP peut être affectée de trois manières :
l
l
l
Automatiquement via serveur DHCP. Cette option est activée par défaut. Si un serveur DHCP est disponible sur le
réseau, l’adresse IP sera attribuée automatiquement par le serveur.
Automatiquement via la fonction Auto-IP. Si l'assignation DHCP est activée mais qu’aucun serveur DHCP n’est
disponible sur le réseau, le périphérique IHM s'attribue une adresse IP dans l’échelle 169.254.xx avec un masque de
sous-réseau 255.255.0.0
Manuellement via les Paramètres du Système. Dans le menu Paramètres du Système, dans la section réseau,
l'adresse IP peut être attribuée manuellement, désactivant la fonction d'affectation du serveur DHCP.
Installation du runtime via la mémoire USB
Pour l’installation du runtime, UpdatePackage ou paquet de sauvegarde via un périphérique USB, suivre cette procédure :
1. Créer un paquet de mise à jour depuis AGI Creator et copier dans une clé mémoire USB vide
2. Sur le périphérique HMI, sélectionner [Transfer from disk] et sélectionner UpdatePackage.zip à charger.
Paramètres du système
Les paramètres du système dispose de deux modes de fonctionnement :
l
l
Mode utilisateur
une interface simplifiée qui permet aux utilisateurs d'accéder aux réglages de base du périphérique IHM.
Mode système
une interface complète qui donne aux utilisateurs l'accès à toutes les options de l'outil.
Lorsque vous accédez à l'outil au runtime, sélectionner « Show System Settings » dans le menu contextuel, l'outil est
démarré par défaut en mode utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
371
Paramètres du Système sur les Périphériques WinCE
Note : Appuyer et maintenir appuyé sur une zone de l'écran sans boutons ou autres éléments tactiles pour
afficher le menu contextuel.
Pour accéder au Mode système :
l
l
Exécuter une séquence de pression sur l'écran tactile lors de la phase de mise sous tension. Une séquence de
pression et une séquence élevée de fréquence des activations tactiles exécutées immédiatement après que le
dispositif a été mis sous tension.
Depuis la page Paramètres du système en mode utilisateur, redémarrer le panneau en mode configuration OS
Éléments disponibles en Mode utilisateur
Élément
Description
Calibrate
Touch
Calibre l'écran tactile
Display
settings
Contrôle la clarté et le délai d'attente d'inactivité du rétroéclairage
Time
Définit manuellement la date et l'heure sur le périphérique IHM ou configure les serveurs NTP.
Regional
Settings
Sélectionne ou personnalise les paramètres régionaux
BSP
Settings
Affiche la version du système d'exploitation et unit les minuteries en fonctionnement pour contrôler le
signal sonore et la LED de la batterie.
Network
Définit l'adresse IP et d'autres paramètres réseau
Plug-in List
Liste des composants enfichables installés et reconnus par le système.
Note : cette option n'est pas prise en charge par toutes les plateformes ni par toutes les
versions.
Close
Ferme la page de paramétrage du système
Restart
Redémarre le périphérique IHM
l
l
Système d'exploitation principal
Redémarrer le périphérique IHM dans le mode de fonctionnement
Système d'exploitation de configuration
Redémarrer le périphérique HIM avec l'outil de Paramètre du système actif en Mode système
Éléments disponibles en Mode système
En plus de ceux disponibles en mode utilisateur, les fonctionnalités suivantes sont également disponibles :
372
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
37 Paramètres du système
Élément
Description
Format Flash
Formate la mémoire flash du périphérique interne Tous les projets et le HMI
Runtime seront effacés, renvoyant le périphériques aux réglages d'usine.
Restaure les paramètres d'usine.
Restaure les paramètres d'usine comme une alternative au format Flash, d'une
manière plus flexible. Les options suivantes sont disponibles :
Désinstaller IHM : retirer le HMI Runtime (tout le dossier qthmi) au prochain
démarrage, le dispositif se comportera comme une nouvelle unité. Cette
commande ne réinitialise pas les paramètres tels que l'adresse IP, la luminosité
ou le CTR.
Effacer les paramètres de système : réinitialise les paramètres du système
(paramètres de registre) et supprime les fichiers suivants :
\\Flash\\Documents and Settings\\system.hv
\\Flash\\Documents and Settings\\default\\user.hv
\\Flash\\Documents and Settings\\default.mky
\\Flash\\Documents and Settings\\default.vol
Le mot de passe du Mode système est également réinitialisé.
Effacer application Controller : efface les dossiers actuels utilisés par les
contrôleurs internes CoDeSys V3 pour les applications :
l
\Flash\QtHmi\RTS\APP\*.*
l
\Flash\QtHmi\RTS\VISU\*.*
l
\Flash\QtHmi\codesys\*
l
\Flash\$SysData$\codesys\*
Efface les paramètres de sysdata : efface le dossier \Flash\$SysData$
Assistance téléphonique : Pour être utilisé uniquement par le support
technique pour résoudre les problèmes d'affichage.
Note : Toutes ces options ne sont pas disponibles pour tous les
appareils IHM et les BSPs.
Redimensionner la zone de
l’image
Redimensionner la mémoire flash réservée pour stocker l'image de démarrage
affiché à la mise sous tension. Les paramètres par défaut sont normalement
appropriés pour toutes les unités.
Téléchargement Système
d'exploitation de configuration
Contrôles et mises à niveau de la version actuelle du système de fonctionnement
utilisé en mode système
Téléchargement Système
d'exploitation principal
Contrôles et mises à niveau de la version actuelle du système de fonctionnement
principal
Téléchargement Image de
démarrage
Charge un nouveau fichier pour l'image de démarrage affichée dans l’unité au
moment du démarrage.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
373
Paramètres du Système sur les Périphériques WinCE
Élément
Description
Astuce : Mettre à jour l’image de démarrage directement à partir du AGI
Creator logiciel de programmation.
Voir "Mise à jour des composants système de l’application" on page 414 pour plus
de détails.
Télécharger Bootloader
Contrôles et mises à niveau de la version actuelle du programme d’amorçage du
système.
Téléchargement de l’FPGA
principal
Contrôles et mises à niveau de la version actuelle du principal fichier FPGA.
Cette option peut ne pas être disponibles pour toutes les plateformes ni par toutes
les versions.
Téléchargement de l’FPGA de
sécurité
Contrôles et mises à niveau de la version actuelle de la copie de sauvegarde du
fichier FPGA. Cette option peut ne pas être disponibles pour toutes les
plateformes ni par toutes les versions.
Télécharger du superviseur du
système
Contrôles et mises à niveau de la version actuelle du firmware du superviseur du
système (utilisé pour le traitement RTC et pour l'alimentation).
Chargement Système
d'exploitation de configuration
Copiez les fichiers système à partir du panneau de commande sur le périphérique
externe (généralement une clé USB).
Chargement Système
d'exploitation principal
Chargement Image de démarrage
Chargement Bootloader
Chargement FPGA principal
Chargement FPGA de sécurité
Chargement du superviseur du
système
Mise à jour des composants du système
Les composants du système peuvent être mis à jour à l'aide d'une mémoire flash USB. Pour chaque composant, un couple
de fichiers de mise à jour spécifiques est fourni.
Note : Les procédures de mise à niveau dépendent des versions de matériel et de système d'exploitation.
Contactez le support technique pour l'assistance.
374
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
37 Paramètres du système
1. Copier tous les fichiers de mise à niveau dont vous avez besoin sur une mémoire USB et la brancher sur le port
USB du périphérique IHM.
2. Démarrer l'outil des Paramètres du système en mode système (voir "Paramètres du système" on page 371pour plus
de détails).
3. Cliquez sur la fonction de téléchargement souhaité.
4. Parcourir le contenu de la clé USB pour les fichiers à télécharger. L'exemple montre les composants principaux du
système d’exploitation.
5. Cliquer sur Télécharger pour transférer les fichiers sur les périphériques IHM.
Note : Depuis cette boîte de dialogue, cliquer sur Charger pour transférer les fichiers vers le périphérique
USB.
6. Suivre les instructions affichées pour terminer la mise à jour : l'état d'avancement de l'opération affiché dans une
barre de progression.
Cette opération peut nécessiter quelques minutes.
Important : Ne pas éteindre le périphérique pendant qu’un composant du système est en cours de
mise à niveau.
Liste des composants pouvant être mis à jour
Les périphériques IHM supportent la mise à jour des composants suivants :
Composant
Description
Application
L'Application IHM et le runtime IHM généré à partir de la commande
Exécuter>Paquet de mise à jour
Système
d'exploitation
principal
Système d'exploitation principale
Système
d'exploitation de
Système d'exploitation de sauvegarde qui assure la restauration des unités en cas de
corruption du système d'exploitation principal
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
375
Paramètres du Système sur les Périphériques WinCE
Composant
Description
configuration
Image de démarrage
L'écran initial affiché au démarrage du périphérique IHM
Bootloader
Chargeur pour gérer le démarrage du périphérique
FPGA principal
Firmware FPGA
FPGA de sécurité
Copie de sauvegarde du FPGA principal qui assure le démarrage de l’unité en cas de
corruption principale FPGA
Important : Utilisez le même fichier pour mettre à jour les
composants du FPGA Principal et de Sécurité.
Superviseur de
système
Logiciel du contrôleur du superviseur de système (par exemple : packaged_
GekkoZigBee_v4.13.bin).
Le composant Superviseur de système peut être mis à jour à partir de v4.13 ou
version supérieure.
Important : Ne tentez pas de mettre à jour les versions V4.08, V4.09,
V4.10 et V4.11 car elles ne supportent pas la mise à jour
automatique à partir des Paramètres Système.
376
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Calibrage de l'écran tactile
Le calibrage du paramètre du système permet de calibrer le périphérique à écran tactile, peut être consulté depuis les
paramètres du système
Pour accéder aux paramètres du système :
l
Exécuter une séquence de pression sur l'écran tactile lors de la phase de mise sous tension. Une séquence de
pression et une séquence élevée de fréquence des activations tactiles exécutées immédiatement après que le
dispositif a été mis sous tension.
ou
l
Appuyer sur un espace vide de l'écran et maintenez enfoncé pendant quelques secondes pour afficher le menu
contextuel.
Depuis le menu rotatif, sélectionner « Calibrate Touch » et suivre les instructions affichées sur l'écran pour terminer la
procédure de calibrage, le système vous demandera de toucher des points spécifiques pour calibrer le périphérique à écran
tactile.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
377
378
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Protection du mot de passe
Le mot de passe interne du périphérique IHM peut être défini à partir des paramètres système en mode système (voir
"Paramètres du système" on page 371 pour plus de détails)
Dans le menu de rotation, sélectionner « Paramètres BSP », puis l'onglet Mot de passe pour ouvrir la boîte de dialogue mot
de passe défini.
Le mot de passe doit avoir au moins 5 caractères.
Laisser « Ancien mot de passe » vide par défaut si le mot de passe cible n’est pas réglé.
Cette fonction est disponible à partir des versions BSP V1.64 ARM UN30/31 et V2.73 MIPS UN20 fonctionnant
sous le système d'exploitation WCE.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
379
380
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Rétablir la configuration d’usine
Si vous rencontrez des problèmes avec votre périphérique IHM, vous pouvez tenter de rétablir la configuration d'usine par
défaut à partir du Mode système.
1. Passez en Mode système.
2. Utilisez l'une des opérations suivantes disponibles dans le menu tournant :
l
Formater Flash, pour nettoyer le périphérique flash et la configuration de registre.
l
Rétablir la configuration d'usine, pour nettoyer uniquement les composants sélectionnés.
Note : Aucune de ces opérations n'implique le rétablissement de la configuration d'usine pour les logiciels
(MainOS, ConfigOS, Bootloader, FPGA, images, etc.).
Voir "Paramètres du système" on page 371pour plus de détails.
Paramètres du Système sur les Périphériques Linux
les produits AGI 400 offrent un outil intégré puissant appelé Paramètres du Système qui permet la gestion et la mise à
niveau des composants du système. Les opérations peuvent être effectuées directement sur IHM ou à distance en utilisant
un navigateur Web.
Installation du runtime
Les périphériques HMI sont livrés hors d'usine sans Runtime, à la première mise sous tension, IHM affiche l'écran
« Chargeur de runtime ».
Le runtime peut être installé :
l
Automatiquement, via Ethernet sur le premier téléchargement avec AGI Creator
l
Manuellement via clé USB, création d'un « paquet de mise à jour »
Installation du Runtime via Ethernet
Pour l’installation du Runtime via Ethernet, suivre la procédure "Télécharger vers le périphérique IHM" on page 78.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
381
Paramètres du Système sur les Périphériques Linux
AVERTISSEMENT : Le téléchargement via Ethernet de l’installation du runtime requière le
périphérique IHM avec une adresse IP valide.
L'adresse IP peut être affectée de trois manières :
l
l
l
Automatiquement via serveur DHCP. Cette option est activée par défaut. Si un serveur DHCP est disponible sur le
réseau, l’adresse IP sera attribuée automatiquement par le serveur.
Automatiquement via la fonction Auto-IP. Si l'assignation DHCP est activée mais qu’aucun serveur DHCP n’est
disponible sur le réseau, le périphérique IHM s'attribue une adresse IP dans l’échelle 169.254.xx avec un masque de
sous-réseau 255.255.0.0
Manuellement via les Paramètres du Système. Dans le menu Paramètres du Système, dans la section réseau,
l'adresse IP peut être attribuée manuellement, désactivant la fonction d'affectation du serveur DHCP.
Installation du runtime via la mémoire USB
Pour l’installation du runtime, UpdatePackage ou paquet de sauvegarde via un périphérique USB, suivre cette procédure :
1. Créer un paquet de mise à jour depuis AGI Creator et copier dans une clé mémoire USB vide
2. Sur le périphérique HMI, sélectionner [Startup sequence], puis [Install]
3. Double-cliquer sur « mnt » pour accéder au dossier
382
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
4. Puis sur « usbmemory »
5. Sélectionner « UpdatePackage.zip » et confirmer en appuyant sur [Ok]
6. L’installation du runtime commence
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
383
Paramètres du Système sur les Périphériques Linux
Note : Les systèmes de fichiers supportés sont FAT16/32 et Linux Ext2, Ext3 et Ext4.
Paramètres du système
L'interface utilisateur des Paramètres systèmes se base sur des pages HTML et il est possible d'y accéder soit localement
sur l'écran du périphérique IHM, soit à distance en utilisant un navigateur web.
L'identifiant de l'administrateur en possession de tous les droits d'accès est « admin » et le mot de passe par défaut est
« admin ». L'identifiant générique est "user" et le mot de passe par défaut est "user"
AVERTISSEMENT : Pour des raisons de sécurité, veuillez changer les mots de passe par défaut pour
les deux identifiants (les mots de passe peuvent être modifiées à partir de la commande “Paramètres
système -> Authentification”)
L’accès aux paramètres du système du périphérique IHM ne nécessite pas d'entrer un mot de passe tant que le
mot de passe « admin » par défaut ne change pas.
Accès aux paramètres du système depuis un navigateur Web
Pour accéder aux Paramètres système via un navigateur web, saisir l'adresse IP du périphérique, selon le format suivant :
https://IP/machine_config
Note : L'accès à distance requiert un port 443.
Parcourir les options disponibles dans le menu à gauche : l'élément actif est surligné et les informations correspondantes
s'affichent sur la droite.
Les protocoles de sécurité par défaut proposés par le serveur HTTPS dans le AGI 400 périphérique IHM sont :
384
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
l
SSLv3 256 bits ECDHE-RSA-AES256-SHA
l
TLSv1 256 bits ECDHE-RSA-AES256-SHA
AVERTISSEMENT : Nous déconseillons l'utilisation de suites de chiffrement CBC en cas de
connexions SSL3 ou TLSv1.0, car elles pourraient être affectées par des vulnérabilités.
Accès aux paramètres du système depuis un périphérique IHM
Lorsque le Runtime n’est pas installé, les Paramètres du Système sont accessibles à partir de l'écran du chargeur de
runtime,
Lorsque le Runtime est installé, les Paramètres du système sont accessibles en sélectionnant l'option « Show System
Settings » du menu contextuel,
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
385
Paramètres du Système sur les Périphériques Linux
Entrer les Paramètres du système via la procédure tap-tap
Tap-tap consiste en une séquence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'écran
tactile effectué pendant la phase de mise sous tension et commencé immédiatement après la mise sous tension de l’IHM.
Lorsque le message « tap-tap détecté » apparaît sur le haut de l'écran. Attendre 5 secondes (sans toucher l'écran) pour
entrer dans le sous-menu Paramètres du Système
Attendre encore 5 secondes (sans toucher l'écran) pour entrer en mode par Défaut
386
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Sélectionner « Paramètres du Système » depuis l'écran du mode par défaut IHM
Sections de Paramètres du système
Pour modifier les valeurs des paramètres du système, entrer en mode édition en cliquant sur le bouton Éditer en haut à
droite.
Le bouton Éditer est disponible uniquement à l'intérieur des boîtes de dialogue qui contient les paramètres
modifiables.
Langues
Sélectionner la langue de l'interface des paramètres du système
Système
Paramètre
Description
Infos
Informations relatives au périphérique
Status
État du périphérique (Free RAM, Up time, CPU Load)
Minuterie
Minuteurs périphérique (System on, Back light on)
PlugIn
Informations sur les plugins matériau
Entrées de journal
Fichiers log du périphérique
Date & heure
Date et heure du périphérique. Paramètres disponibles en mode édition :
Paramètre
Description
Fuseau horaire actuel
Fuseau horaire
Date actuelle
La date et l’heure peuvent être défini manuellement uniquement lorsque la
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
387
Paramètres du Système sur les Périphériques Linux
Paramètre
Description
Heure locale
mise à jour automatique est désactivée.
Mise à jour automatique
(NTP)
Activer pour garder date et l'heure synchronisées à partir d'un serveur distant
l
Serveur NTP
Spécifier l'adresse Internet du serveur NTP
Réseaux
Paramètres réseau. Paramètre disponible en mode édition :
Paramètre
Description
Paramètres généraux
Adresse Interner du périphérique
Interface réseau
Paramètres réseau des interfaces disponibles
DNS
l
DHCP
l
Adresse IP
l
Masque réseau
l
Gateway
Serveurs DNS
En règle générale, fourni à partir des serveurs DHCP, mais peuvent être
modifiés en mode édition
Rechercher domaines
Domaines facultatifs qui seront utilisés dans la concaténation avec les urls
fournies
Services
Les services sont disponibles uniquement lorsque vous êtes connecté en tant qu'administrateur.
Cliquer sur la souris sur le bouton d'activation pour activer / désactiver le service. Cliquer sur le nom du service sur la liste
des paramètres associés.
Paramètre
Description
Avahi Daemon
Avahi est un système qui permet aux programmes de publier et découvrir des
services et l’exécution d’hôtes sur un réseau local.
Service Cloud
Permet de gérer les périphériques IHM distants connectés à un serveur
centralisé via des passerelles.
388
l
Type de serveur
l
Serveur
l
Identifiant
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Paramètre
Description
Service Router
Activer le routage entre les adaptateurs Ethernet
Serveur SNMP
Activer le serveur SNMP
Serveur SSH
Activer le serveur SSH
Connexion système
Activer le service de connexion système
Service VNC
Activation service VNC
l
Port
l
Clients multiples
l
Vue uniquement
l
Cryptage
l
Authentification
Gestion
La gestion est disponible uniquement lorsque vous êtes connecté en tant qu'administrateur.
Depuis la zone de gestion, il est possible d’effectuer "Mise à jour des composants du système" on the next page du
périphérique IHM.
AVERTISSEMENT : Travailler dans la zone de gestion est une opération critique et, lorsqu'elle n’est
pas effectuée correctement, peut causer des dommages au produit nécessitant un service du produit.
Contactez le support technique pour l'assistance.
Utiliser la commande « Effacer » dans la section « Données » pour supprimer le runtime IHM à partir du périphérique
(restauration paramètres d'usine)
Affichage
Paramètre
Description
Luminosité
Niveau de luminosité de l'écran
Délai de retour de lumière Délai d'attente inactivité arrière plan
Orientation
Orientation de l'écran
Redémarrer
Commande de redémarrage du périphérique IHM
Authentification
Entrer en mode édition pour modifier les mots de passe d'authentification.
EXIT
Sortir de l'outil des paramètres du système.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
389
Paramètres du Système sur les Périphériques Linux
Mise à jour des composants du système
AVERTISSEMENT : Travailler dans la zone de gestion est une opération critique et, lorsqu'elle n’est
pas effectuée correctement, peut causer des dommages au produit nécessitant un service du produit.
Contactez le support technique pour l'assistance.
Les composants du système de l'appareil AGI 400 peuvent mettre à jour localement à l'aide d'une clé USB ou à distance
via un navigateur Web.
Pour mettre à jour les composants du système, entrer dans Paramètres du système en mode Config OS via la procédure
tap-tap sur IHM ou ouvrir le navigateur Web sur https: // <HMI-IP-address> et sélectionner la section « Gestion ».
Développer le composant à mettre à jour et sélectionner [Mise à jour]
Sur la boîte de dialogue ouverte, cliquer sur [Parcourir image], puis sélectionner le fichier « xxx-Mainos-xxx.tar.gz ».
Cliquer ensuite sur [Parcourir MD5] et sélectionner le fichier « xxx-Mainos-xxx.tar.gz.md5 ».
Important : Ne pas éteindre le périphérique pendant qu’un composant du système est en cours de
mise à niveau.
390
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
À la fin de la mise à jour des composants, redémarrer le périphérique IHM et le laisser démarrer normalement.
Entrer les Paramètres en mode Config OS du système via la procédure tap-tap
Le Paramètre en mode Config OS est disponible via la séquence tap-tap et peut être consultée également lorsque IHM est
confronté à une panne de logiciel.
Tap-tap consiste en une séquence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'écran
tactile effectué pendant la phase de mise sous tension et commencé immédiatement après la mise sous tension de l’IHM.
Lorsque le message « tap-tap détecté" apparaît sur le haut de l'écran, appuyer et maintenir le doigt sur l'écran tactile, pour
sélectionner « Restauration: Config OS »
IHM redémarrera dans Paramètres système en mode OS Config:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
391
Paramètres du Système sur les Périphériques Linux
392
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Calibrage de l'écran tactile
Le calibrage du paramètre du système permet de calibrer le périphérique à écran tactile, peut être consulté par procédure
tap-tap.
Tap-tap consiste en une séquence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'écran
tactile effectué pendant la phase de mise sous tension et commencé immédiatement après la mise sous tension de l’IHM.
Lorsque le message « tap-tap détecté » apparaît sur le haut de l'écran, attendre 5 secondes (sans toucher l'écran) pour
entrer dans le sous-menu Paramètres de système
Appuyer sur l'écran tactile, la voix « calibrage de l'écran tactile » sera surlignée en jaune, maintenir enfoncé pendant
quelques secondes jusqu'à ce que la procédure de calibrage de l'écran tactile commence
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
393
Suivre les instructions affichées sur l'écran pour terminer la procédure de calibrage, le système vous demandera de toucher
des points spécifiques pour calibrer le périphérique à écran tactile.
394
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Protection du mot de passe
Mot de passe interne du périphérique IHM.
Dans l'onglet Authentification, dans les "Paramètres du système" on page 384, activer le mode édition et sélectionner le
nom d'utilisateur pour modifier le mot de passe associé.
Le mot de passe pour l'utilisateur admin peut modifier, même dans le menu contextuel de HMI Runtime (voir
"Options de menu contextuel" on page 8 pour plus de détails).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
395
396
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
Rétablir la configuration d’usine
Le mode par défaut des Paramètres du système permet de désinstaller le runtime IHM ou de modifier la séquence de
démarrage, ce mode est disponible via la séquence tap-tap et peut être consultée également lorsque IHM est confronté à
une panne de logiciel.
Tap-tap consiste en une séquence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'écran
tactile effectué pendant la phase de mise sous tension et commencé immédiatement après la mise sous tension de l’IHM.
Lorsque le message « tap-tap détecté » apparaît sur le haut de l'écran. Attendre 5 secondes (sans toucher l'écran) pour
entrer dans le sous-menu Paramètres du Système
Attendre encore 5 secondes (sans toucher l'écran) pour entrer en mode par Défaut
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
397
Pour désinstaller le runtime depuis HMI dans la sélection de l’écran du Mode par Défaut [Startup Sequence] :
Sélectionner le runtime à retirer (1) et cliquer sur le bouton [Uninstall] (2) :
Le processus de désinstallation de runtime sera effectué :
398
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
399
400
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44
Accès web
AGI Web permet aux utilisateurs d'accéder aux projets IHM à partir d'un navigateur web distant exécuté sur un ordinateur
ou sur un périphérique portable, tel qu'une tablette ou un téléphone. Avec AGI Web, les utilisateurs peuvent créer un projet
web qui leur permet d'afficher sur un emplacement distant le même affichage graphique que celui apparaissant sur le
périphérique IHM. Les projets AGI Webse basent sur une technologie HTML5, qui ne nécessite pas de plug-ins ni de
logiciels externes pour afficher les informations.
Ce document suppose que vous avez une connaissance de base du mode de fonctionnement du navigateur web sur vos
périphériques portables ainsi que de la manière d'établir une connexion au périphérique IHM qui exécute le serveur. Par
exemple, si vous travaillez avec une tablette ou un téléphone, vous devez savoir comment configurer un accès Wi-Fi afin
de pouvoir accéder aux pages AGI Web sur le périphérique IHM.
Plateformes et navigateurs pris en charge
402
Créer une page pour accès web
402
Pages d'accueil de plateforme spécifiques
404
Tester projet web
404
Télécharger projet web
405
Problèmes de connectivité web
406
Fonctionnalités web prises en charge
408
Résolution des problèmes et FAQ
411
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
401
Plateformes et navigateurs pris en charge
Plateformes et navigateurs pris en charge
AGI Web supporte 3 plateformes :
l
internet, pour les navigateurs de bureau,
l
téléphone, pour les périphériques smartphone
l
tablette, pour les périphériques tablettes
Vous pouvez donc créer des pages de contenu et de taille différentes pour les différentes plateformes. Par exemple, vous
pouvez créer un ensemble de petites pages dans votre projet pour les téléphones même si vous allez utiliser des pages de
taille réelle pour les navigateurs Internet de bureau et les tablettes.
Travailler avec un ordinateur
AGI Web fonctionne avec tous les navigateurs Internet modernes. Les navigateurs suivants ont été testés pour la
compatibilité avec AGI Web :
l
Mozilla Firefox 40+
l
Microsoft Internet Explorer 11+
l
Apple Safari 7.1+
l
Google Chrome 36+
Travailler avec des tablettes ou des téléphones
AGI Web travailler avec la plupart des périphériques tablettes ou téléphones. Les tablettes suivantes ont été testées pour
la compatibilité avec AGI Web :
l
iOS 4+ - Mobile Safari
l
Android 7+ - Android Webkit
Créer une page pour accès web
Chemin : Affichage du projet> Web > Pages
Cliquez avec le bouton droit sur le nœud des Pages et sélectionnez Insérer une page pour ajouter une page web.
402
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44 Accès web
Tous les widgets et les fonctionnalités peuvent être utilisés dans AGI Creator; cependant, toutes les fonctionnalités ne
sont pas actuellement disponibles dans AGI Web. Si le projet inclut une fonctionnalité qui n'est pas disponible, AGI Web
fonctionnera quand même correctement, mais cette fonctionnalité ne sera pas disponible sur le périphérique client distant.
Voir "Fonctionnalités web prises en charge" on page 408 pour avoir la liste des fonctionnalités supportées dans AGI Web et
des limites existantes.
Exporter des pages
Pour sélectionner des pages à exporter à partir du projet actuel.
1. Dans le menu Exécuter, cliquez sur Paramètres de projet web : la boîte de dialogue des Paramètres de projet
web apparaîtra.
2. Sélectionnez les pages web que vous souhaitez exporter. Par défaut, toutes les pages de projet et de dialogue sont
sélectionnées.
3. Pour chaque plateforme, sélectionnez l'icône d'accueil près de la page que vous souhaitez définir comme page
d'accueil. Il n'est possible de sélectionner qu'une page d'accueil pour chaque plateforme. Toutes les autres icônes
d'accueil sont grisées.
AVERTISSEMENT : Lorsque vous téléchargez un projet sur le périphérique IHM, assurez-vous
que l'option Télécharger le projet web est sélectionnée.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
403
Pages d'accueil de plateforme spécifiques
Pages d'accueil de plateforme spécifiques
La Page d'accueil du projet AGI Web correspond à la première page qui s'affiche dans le navigateur pour chaque type de
plateforme et représente le point de départ pour votre projet web. Les pages pouvant être accédées à partir d'une page
d'accueil dépendent des liens existant entre ces pages et le projet.
Par exemple, si vous avez conçu un ensemble de pages destiné à une plateforme téléphonique, définissez comme page
d'accueil une page de taille appropriée à un écran de téléphone portable. Puis, n'incluez dans cette page que des liens vers
d'autres pages téléphoniques : l'utilisateur n'accèdera qu'aux pages téléphoniques lorsqu'il naviguera dans le projet AGI
Web à partir d'un téléphone.
Tester projet web
Vous pouvez tester votre AGI Web projet en utilisant le simulateur en ligne ouvrant une page Internet autonome
directement à partir d'un navigateur.
Test avec le simulateur en ligne
AGI Creator comprend un serveur Internet dans le simulateur en ligne. Vous pouvez démarrer le simulateur et accéder à
votre AGI Web projet à partir d’un navigateur Internet. Les pages seront servies à partir du simulateur.
1. Créer votre projet (voir "Créer une page pour accès web" on page 402).
2. Sur le fichier Exécution, choisissez Démarrage Simulateur : le projet démarrera dans une fenêtre séparée.
3. Ouvrir un navigateur Internet (voir "Plateformes et navigateurs pris en charge " on page 402 pour une liste de
navigateur compatible avec AGI Web).
4. Entrez l'adresse suivante : http://localhost:81 : cela indique au navigateur Internet de lire les pages Internet à partir
de l'ordinateur local et d’utiliser le port 81, utilisé par défaut par le simulateur en ligne AGI Web.
5. Testez votre projet dans le navigateur.
Important : Si vous apportez des modifications aux pages de projets dans AGI Creator vous devez
arrêter et redémarrer le simulateur.
404
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44 Accès web
Note : Si vous utilisez un périphérique (par exemple, un smartphone) qui n’est pas l’ordinateur hôte local où le
simulateur est en cours d'exécution, il vous sera demandé d'entrer le nom d'utilisateur et le mot de passe.
Télécharger projet web
Après avoir testé les pages du AGI Web, vous pouvez télécharger le projet sur le périphérique IHM choisi.
Le projet AGI Web est téléchargé avec le projet AGI Creator, voir "Télécharger vers le périphérique IHM" on page 78 pour
plus de détails.
Lorsque le processus de téléchargement est terminé, le projet IHM démarre automatiquement sur le périphérique IHM et le
projet AGI Web est prêt à être utilisé.
Exécuter AGI Web depuis un navigateur
1. Ouvrez un navigateur web et entrez l'adresse IP de votre périphérique IHM : la page de connexion s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
405
Problèmes de connectivité web
2. Entez le Nom d'utilisateur et le Mot de passe, puis cliquez sur Se connecter : la page d'accueil s'affiche.
Voir "Gestion et mots de passe utilisateur" on page 217 pour des détails sur la création d'informations d'identification.
Vous pouvez interagir avec le projet en utilisant le navigateur de la même manière que vous interagissez avec un
périphérique lorsque vous touchez l'écran : cliquez sur les boutons pour changer de page, affichez les indicateurs et les
jauges, déplacez les poignées de barre de défilement pour changer de valeurs, etc. Le projet AGI Web gère toutes les
communications avec le serveur web lorsque vous interagissez avec le périphérique IHM à distance.
Problèmes de connectivité web
Vous trouverez ci-dessous une description des problèmes les plus fréquemment rencontrés lors des connexions à distance
avec le périphérique IHM.
Déconnexion du serveur
Étant donné que AGI Web est exécuté à distance depuis le périphérique IHM, le serveur pourrait se déconnecter du
navigateur (par exemple si le serveur est interrompu ou si le câble de réseau est débranché). Si cela se produit, une icône
'déconnexion' apparaîtra dans la barre d'outils en haut du AGI Web, comme dans cet exemple.
406
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44 Accès web
Dès que le serveur retourne en ligne, l'icône représentant un cercle rouge barré disparaît, signe que la communication avec
le périphérique est redevenue normale.
Note : Si vous faites des modifications dans les pages AGI Webpendant que le serveur est déconnecté, ces
modifications seront visibles sur le client mais ne seront pas transmises au serveur tant que la connexion n'aura
pas été rétablie.
Délai d'attente d'inactivité
AGI Web vous demandera de vous réidentifier si le navigateur est resté inactif pendant plusieurs minutes. Si aucune
activité n'est détectée dans un délai de 10 minutes, l'écran de connexion apparaîtra et vous devrez indiquer vos
informations d'identification avant de pouvoir poursuivre vos activités. Cette fonctionnalité de délai d'attente vous garantit
contre tout accès non autorisé. Le délai d'attente d'inactivité web peut être modifié à partir du tableau Propriété du projet.
Fermeture de session utilisateur
Une session utilisateur peut être fermée soit par le serveur, soit pas l'utilisateur.
Dans des situations particulières, le serveur peut envoyer une demande au client (navigateur) d'effectuer la procédure de
connexion. Dans ce cas, l'utilisateur est redirigé vers la page de connexion, puis directement vers la page sur laquelle il
travaillait. C'est le cas par exemple lorsque l'utilisateur efface la mémoire cache ou les cookies du navigateur.
Note : Si l'utilisateur travaillait dans une boîte de dialogue au moment d'être redirigé vers la page de connexion, il
sera ensuite redirigé vers la page à partir de laquelle la boîte de dialogue avait été ouverte.
Projet AGI Webinactif
La page AGI Webqui s'affiche dans votre navigateur pourrait provenir d'un projet qui n'est plus actif dans le périphérique.
Dans ce cas, une boîte de dialogue de confirmation s'affiche et vous pouvez retourner au projet actif.
Note : Cette redirection suppose que le projet actif actuel comporte des pages AGI Web.
Si vous choisissez de rester dans le projet inactif, les actions que vous réalisez dans le navigateur pourraient ne pas être
exécutées correctement, étant donné que le AGI Webne peut pas effectuer de communications liées au serveur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
407
Fonctionnalités web prises en charge
Fonctionnalités web prises en charge
Actuellement, toutes les fonctionnalités AGI Creatorne sont pas prises en charge dans AGI Web. Voici une liste des
fonctionnalités supportées et les limites correspondantes, classées par catégorie.
Lorsque vous copiez et collez des objets depuis les pages standard vers une des pages Web, assurezvous que tous les objets sont pris en charge dans les pages Web. Éventuellement supprimer les
objets non pris en charge à partir de la page Web après avoir collé.
408
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44 Accès web
Catégorie
Widgets
Fonctionnalités supportées
l
Basique (Texte/Numérique, Images, Formes,
Tendances/Graphiques, Recettes, Contrôles, Alarmes, Texture)
l
Boutons
l
Mètres
l
Sélecteurs
l
Voyants
l
Médias (Caméra IP)
l
Icônes
l
Automatisation industrielle
Limites
l
l
l
l
l
l
Alarmes
l
Les limites d'alarme dans AGI Websont les mêmes que pour le
périphérique IHM (500..2000 selon la cible)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
l
La fonction
AttachToTag des
variables du système
n'est pas supportée
Les fichiers de police
pour lesquels le
drapeau de permission
de téléchargement via
Internet n'a pas été
activé, ne sont pas
chargés à partir de AGI
Web
Les propriétés de
widget avec le
comportement
dynamique Associer à
... pourraient ne pas
fonctionner pour toutes
les propriétés
supportées par AGI
Creator.
Le multi-couche
d'image multi-état n'est
pas supporté.
La couleur d'alarme en
fonction de la condition
de déclenchement
n'est pas supportée sur
le web
Ne peut pas modifier
les widgets d'alarme en
cours de runtime
Sur les
smartphones/tablettes
(périphériques
généralement intégrés)
en fonction du matériel,
un utilisateur peut
s'attendre à des
problèmes de
performance avec >
500 alarmes.
409
Fonctionnalités web prises en charge
Catégorie
Actions
Fonctionnalités supportées
l
l
Page de
dialogue
410
l
Page (HomePage, LoadPage, NextPage, PrevPage,
LastVisitedPage, ShowDialog, CloseDialog, ShowMessage,
LaunchBrowser)
Multilangue (SetLanguage)
l
Variable (WriteTag, StepTag, SetBit, ResetBit, ToggleBit)
Tendance/Graphique (RefreshTrend, ScrollLeftTrend,
ScrollRightTRend, PageLeftTrend, PageRightTrend,
ScrollUpTrend, ScrollDownTrend, PageUpTrend,
PageDownTrend, PageDurationTrend, ZoomInTrend,
ZoomOutTrend, ZoomResetTrend, ZoomInAxisTrend,
ZoomOutAxisTrend, ZoomResetXAxisTrend, PauseTrend,
ResumeTrend, ShowTrendCursor, ScrollTrendCursor,
ScrollTrendToTime)
l
Alarme (ResetAlarm, AckAlarm, SelectAllAlarms, EnableAlarms)
l
Système (DumpTrend, DeleteTrend, DeleteEventArchive)
l
Claviers
Widgets (Javascript)
l
l
XForms
Limites
Les actions de page ne
sont pas supportées
dans des conditions de
déclenchement
d'alarme
Recettes (DownLoadRecipe, UpLoadRecipe,
WriteCurrentRecipeSet, DownLoadCurRecipe,
UpLoadCurRecipe, ResetRecipe, DumpRecipeData,
RestoreRecipeData, AddRecipeDataSet, DelRecipeDataSet)
l
Mise à l'échelle
l
Offset
l
ColorPalette
l
BitIndex
l
Seuls les widgets de claviers numériques sont supportés.
l
l
JavaScript est
supporté (voir
"JavaScript " on
page 325chapitre
JavaScript pour
consulter la liste des
fonctionnalités
supportées)
l
Supportée, vous pouvez l'afficher et la fermer à l'aide des actions
ShowDialog et CloseDialog.
l
l
Certains paramètres ne
supportent pas la
fonctionnalité
ColorPalette.
Les claviers
personnalisés ne sont
pas supportés. Le
clavier numérique
s'affichera en tant que
widget numérique en
mode lecture/écriture
ou écriture seule.
Les pages de dialogue
ne supportent que les
boîtes de dialogue
modales.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
44 Accès web
Catégorie
Gestion des
utilisateurs
Connexions
d'utilisateurs
simultanés
Fonctionnalités supportées
l
l
Le mécanisme de connexion vérifie les informations
d'identification de l'utilisateur sur le serveur. L'identifiant et le mot
de passe dépendent des informations d'identification définies
dans Gestion des utilisateurs.
Le serveur web du périphérique IHM supporte jusqu'à trois
connexions simultanées.
Limites
l
l
Les paramètres de
sécurité individuels
appliqués aux widgets
ou aux pages ne sont
pas supportés.
Si plus de 3 utilisateurs
tentent de se connecter
à partir de navigateurs
distants, seuls les 3
premiers seront
autorisés.
Travailler avec des claviers dans AGI Web
L'utilisateur peut cliquer sur le widget numérique et une zone de texte apparaîtra dans laquelle la nouvelle valeur pourra être
renseignée.
Une fois la valeur renseignée, l'utilisateur peut soit appuyer sur la touche Entrée, ou équivalent sur les périphériques
tactiles, soit cliquer sur Sauvegarder pour rendre cette valeur permanente. Seuls les nombres pertinents seront acceptés
lors du processus de sauvegarde. Les éléments non pertinents seront ignorés et n'entraîneront aucune modification de
valeur.
Résolution des problèmes et FAQ
Activer JavaScript
AGI Web requiert JavaScript pour fournir l’interactivité avec le serveur et l’utilisateur. AGI Web ne fonctionnera pas si
JavaScript est désactivé dans votre navigateur.
Par défaut, la plupart des navigateurs ont JavaScript activé. Si vous avez désactivé JavaScript dans le passé, veuillez
réactiver JavaScript avant d'accéder aux AGI Web pages.
Cache du navigateur
AGI Web comprend des ressources qui changent rarement tels que les fichiers CSS, les fichiers image et les fichiers
JavaScript. Ces ressources prennent du temps à télécharger sur le réseau qui augmente le temps nécessaire pour charger
la AGI Web page dans votre navigateur. La mise en cache du navigateur permet à ces ressources d’être sauvées par un
navigateur et utilisés sans effectuer la demande à chaque fois à partir du serveur. Cela se traduit par un chargement plus
rapide des AGI Web pages.
La mise en antémémoire est normalement activée par défaut, pour des performances AGI Web optimales, s’assurer qu’elle
n’a pas été désactivée.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
411
Résolution des problèmes et FAQ
Note : AGI Web pages fonctionneront toujours correctement avec la mise en antémémoire désactivée du
navigateur, mais le temps de chargement des ressources sera plus lent par rapport aux opérations mises en
cache normales.
Utilisation d’un proxy
Certains utilisateurs pourraient accéder au AGI Web projet via le proxy. Les proxy peuvent contrôler le nombre de
connexion en parallèle pour le navigateur.
S'assurer que les connexions parallèles maximales autorisées (connexions max) ne sont pas plus de 10 et pas moins de 5.
Pourquoi je ne suis pas en mesure de voir les modifications dans les pages
Internet ?
À chaque fois qu'une nouvelle page Internet est ajoutée éditée dans le projet, vous devez télécharger le projet sur le
périphérique. Cependant, lorsque vous connectez l'adresse IP du périphérique, le navigateur Internet peut afficher des
pages en cache au lieu des dernières pages téléchargées. Pour éviter ce problème, vous pouvez :
l
désactiver le cache de votre navigateur Internet
l
forcer le rafraîchissement de la page Internet
l
contourner le cache du navigateur
412
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
45 Mettre à jour les composants
système des périphériques IHM
La plupart des composants logiciels du système peut être facilement mis à jour en assurant un degré élevé de flexibilité
dans la fourniture de mises à jour et des correctifs aux systèmes existants et en cours d'exécution.
Des nouveaux modules logiciels peuvent être mis à jour
l
l
Directement sur le périphérique IHM en utilisant un des lecteurs flash USB (voir "Paramètres du système" on
page 369 pour plus de détails)
Depuis l’application AGI Creator (voir "Mise à jour des composants système de l’application" on the next page pour
plus de détails)
Chaque périphérique IHM est étiqueté avec un code de produit, y compris tous les paramètres d'usine (matériel, logiciels et
composants de firmware). Se référer à cette étiquette pour obtenir des informations sur votre périphérique IHM. L'outil de
mise à jour du périphérique IHM fournit également des détails sur les composants effectivement en cours d'exécution sur le
périphérique.
AVERTISSEMENT : S’assurer d'utiliser les fichiers de mise à niveau corrects, puisque le chargement
de fichiers de mise à niveau inappropriés pour votre périphérique provoquera un dysfonctionnement
grave du système. Toujours vérifier le code produit de votre périphérique.
Note : Les fichiers de mise à niveau sont distribués sur demande comme une partie de l'activité de support
technique.
Assistance téléphonique : Les opérations de déclassement sont des tâches complexes qui pourraient causer de
graves dommages à votre équipement ne fonctionne pas correctement. Ces opérations sont réservés à
l'assistance technique.
Mise à jour des composants système de l’application
414
Paramétrages
415
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
413
Mise à jour des composants système de l’application
Mise à jour des composants système de l’application
Vous pouvez télécharger les composants du système sur un périphérique IHM unique ou sur un grand nombre de
périphériques IHM du même type en utilisant l'interface de communication Ethernet.
Chemin : Exécuter> Gérer cible> Carte
1. Sélectionner le dossier qui contient les fichiers à télécharger sur les périphériques IHM ou où les fichiers de
téléchargement des périphériques IHM
2. Sélectionner un ou plusieurs périphériques IHM.
3. Sélectionnez les composants que vous téléchargerez (ou chargerez) vers/depuis les dispositifs
4. Démarrer le téléchargement pour les périphériques IHM ou le chargement depuis le fonctionnement des
périphériques IHM
Note :
l
l
l
l
l
L’outil est conçu pour mettre à jour un grand nombre de périphériques HMI du même type, éviter de mettre des
fichiers pour le type de périphérique différent dans le même dossier
Si l’IP désirée n’est pas listée, la taper directement dans la boîte de dialogue. Le service Découverte est un service
de diffusion. Quand une connexion à distance se fait via VPN ou depuis des réseaux externes, elle ne fonctionnera
pas et vous devrez saisir l'adresse manuellement.
Le téléchargement des composants sélectionnés sera effectué uniquement sur des périphériques compatibles
Sur la base de vos capacités de réseau et de matériel, vous pouvez augmenter les appareils numériques à mettre à
jour en parallèle
Vous devez redémarrer le périphérique IHM pour finaliser la mise à jour.
414
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
45 Mettre à jour les composants système des périphériques IHM
Paramétrages
Depuis l'onglet Paramètres, vous pouvez spécifier le Port et les paramètres de Mot de passe à utiliser pour communiquer
avec les périphériques IHM. Laissez mot de passe vide si aucun mot de passe n'est défini du côté du périphérique IHM.
AVERTISSEMENT : Le mode en grand nombre fonctionne uniquement avec les périphériques IHM qui
ont les mêmes paramètres de connexion
Chargement de l’image de démarrage
Vous pouvez remplacer l'image de démarrage par défaut affichée par les périphériques pendant la phase de mise sous
tension.
L'image utilisée comme image de démarrage doit être conforme aux exigences suivantes :
FileName
splash.bmp
Format
Bitmap, RGB 565 format
Taille
< 500 KB
Largeur bitmap
Même des nombres (par exemple 430x239)
Pour charger l’image de démarrage :
1. Renommez la nouvelle image splash.bmp et copiez-la dans le dossier source.
2. Sélectionnez les périphériques IHM
3. Cliquez sur Télécharger.
Pour assurer les meilleurs résultats visuels, les images de démarrage doivent avoir un fond noir.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
415
Paramétrages
416
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
46 Protéger l’accès aux
périphériques IHM
Les opérations suivantes sont protégées par mot de passe sur le périphérique IHM :
l
l
Gestion de HMI Runtime : installer HMI Runtime et mettre à jour HMI Runtime
Gestion de carte : remplacer les principaux composants BSP tels que le système d'exploitation principal, la
configuration du système d'exploitation, le bootloader, etc.
l
Télécharger et charger des fichiers de projet
l
Services en option sur les périphériques Linux (par ex. protocole SSH, Serveur VNC)
AVERTISSEMENT : L’accès non autorisé au périphérique peut causer des dommages ou défaillances.
Lorsque vous connectez le périphérique à un réseau, protégez-le contre les accès non autorisés.
Voici une liste non exhaustive des mesures vous permettant de protéger le réseau :
l
Pare-feu
l
Système de prévention d'intrusion (IPS)
l
Segmentation du réseau
l
Réseau local virtuel (VLAN)
l
Réseau privé virtuel (VPN)
l
Sécurité au niveau de l’accès physique (sécurité de port).
Pour plus d’informations, des directives et des normes concernant la sécurité dans le domaine de l’informatique : IEC
62443, ISO/IEC 27001.
Changer de mot de passe sur le périphérique IHM
418
Ports et pare-feux
418
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
417
Changer de mot de passe sur le périphérique IHM
Changer de mot de passe sur le périphérique IHM
Pour changer de mot de passe sur le périphérique IHM, utilisez l'une des méthodes suivantes :
l
l
l
Depuis le menu contextuel du HMI Runtime : Paramètres> onglet Mot de passe.
Utilisez la fonction Configurer mot de passe cible dans le paquet de mise à jour : le mot de passe est mis à jour
par HMI Runtime après la fin du processus de mise à jour.
Utilisation de l’outil "Paramètres du système" on page 369 du périphérique IHM
Laisser « Ancien mot de passe » vide par défaut si le mot de passe cible n’est pas réglé.
Pour Win32 HMI Runtime, le mot de passe est sauvegardé dans Users\[username]\AppData\Roaming\DEIF
A/S\buildNumber\server\config\RemoteUpdateConfig.xml.
Ports et pare-feux
Voici une liste de tous les ports utilisés par les composants AGI SW Pack.
Port
Utilisation
Accès à
distance
Gestion de
carte
Runtime/Gestion de
projet
80/tcp
Port HTTP
Oui
-
Oui
21/tcp
Port FTP cmd
-
-
Oui
2100/tcp
Port carte
-
Oui
-
16384-17407/tcp
Port données FTP (mode passif)
-
Oui
Oui
990/udp
Diffusion UDP (Détection
périphérique)
-
Optionnel
Optionnel
418
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
46 Protéger l’accès aux périphériques IHM
Accès à
distance
Gestion de
carte
Runtime/Gestion de
projet
Diffusion UDP (Détection
périphérique)
-
Optionnel
Optionnel
998/udp
Diffusion UDP (Détection
périphérique)
-
Optionnel
Optionnel
999/udp
Diffusion UDP
-
Optionnel
Optionnel
Port
Utilisation
991/udp
(Détection périphérique)
5900/tcp
Serveur VNC
VNC seulement
-
-
5100/tcp
Débogueur à distance JS
-
-
Optionnel
11740-11743/tcp
CODESYS 3
-
-
-
1217, 17401743/udp
Accès à distance
L'accès à distance est demandé pour se connecter à HMI Runtimeen utilisant :
l
AGI Client
l
Accès web AGI Web
Runtime et ports de gestion de projet
Vous utilisez ces ports pour vous connecter à HMI Runtimepour des opérations comme les mises à jour, les installations et
les téléchargements de projets.
Ports de gestion de carte
Vous utilisez ces ports pour vous connecter au périphérique IHM pour les opérations de carte, tels que les mises à jour
BSP, les téléchargements d'image de démarrage, etc.
Note : Lorsque le service de diffusion n'est pas disponible, par exemple dans les réseaux VPN, saisissez
l'adresse IP exacte pour vous connecter au périphérique IHM à partir de AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
419
Ports et pare-feux
420
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
47 Trucs et astuces pour améliorer la
performance
AGI Creator permet une grande flexibilité pour un concepteurs de projets.
Suivez ces instructions pour créer des projets qui fonctionnent mieux en termes de temps de démarrage, de changement
de page et d'animations.
Optimisation statique
422
FAQ sur l’optimisation statique
425
Mise en cache de page
426
Image DB
426
Pré-cachage
426
FAQ sur le pré-cachage
427
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
421
Optimisation statique
Optimisation statique
L’optimisation statique est une technique utilisée dans AGI Creator pour améliorer les performances d'exécution.
L'utilisation d'un grand nombre d'images et de photos dans un projet pourrait dégrader les performances, l'optimisation
statique fusionne plusieurs images dans une image de fond unique, réduisant ainsi le rendu et le temps de chargement. En
utilisant cette méthode, une seule image à trame doit être chargée et rendue au lieu de plusieurs images à trame et/ou
d’images de vecteur.
Lorsque vous créez un projet dans AGI Creator, les pages peuvent contenir des widgets tels que textes, images, images
de fond, couleurs de fond, etc. qui peuvent être classés comme suit :
l
Statique : valeurs ou propriétés ne changent pas au moment de l'exécution.
l
Dynamique : valeurs ou propriétés changent au moment de l'exécution.
Note : Sur la base des paramètres de sécurité, les parties statiques des widgets pourraient être pas fusionnés
avec le fond d’écran. Cela se produit lorsque un widget est configuré comme « caché » dans les paramètres de
sécurité.
Important : Lorsque vous modifiez les propriétés des widgets avec JavaScript, régler le widget
d'optimisation statique sur dynamique, sinon les modifications de propriétés seront ignorées.
Lors du téléchargement ou de la validation un projet, AGI Creator identifie les composants statiques et les rend sous forme
d'images d'arrière-plan en des fichiers .png. Ces images de fond sont enregistrées en tant que partie du projet dans le
dossier /opt.
Les images de fond peuvent être créés comme suit :
l
l
images de fond de pleine page, contenant tous les widgets fusionnés à la page de fond
images de fond de groupe, contenant un groupe de widgets statiques fusionnés ensemble pour former un fond de
groupe. Par exemple, le groupe de jauge est normalement composé d'un fond, d’une échelle, d’une étiquette et d’une
aiguille, où l'échelle et l'étiquette de fond peuvent tous être fusionnés à une image d'arrière-plan unique.
L'attribut de la page d’Optimisation statique active et désactive l'optimisation statique de la page entière. Si elle est
définie sur faux l'optimisation est totalement désactivée.
Le contrôle Finer peut être obtenu définissant l'attribut d'Optimisation statique de chaque widget individuel comme suit :
l
l
Normal : AGI Creator détecte automatiquement si le widget peut être fusionné avec l'arrière-plan. Ceci peut être
utilisé si le widget n’est pas un widget dynamique et qu’il ne se chevauche pas, c'est-à-dire qu’il n’est pas empilé cidessus, un widget dynamique.
Statique : L'image est forcée d'être fusionnée avec l'arrière-plan. Ceci peut être utilisé lorsque le widget statique
chevauche un widget transparent dynamique.
Note : Dans ce cas, l'optimisation automatique échouera car elle ne fait aucune hypothèse sur les zones
invisibles qui pourraient être rendus au moment de l'exécution.
l
Dynamique : Le widget n’est pas du tout optimisé. Utilisez cette option quand un widget statique doit être changé
par Javascript.
422
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
47 Trucs et astuces pour améliorer la performance
Conseils pour une meilleure performance
1. Tout d'abord : éviter de placer des widgets statiques sur un widget dynamique. La zone de chevauchement est
calculée en tenant compte des rectangles englobant des widgets, c’est-à-dire des rectangles délimités par la
modification des gestions.
2. Ne pas utiliser l'optimisation statique si vos pages contiennent presque uniquement des objets dynamiques.
L’optimisation statique permettrait d'économiser beaucoup d'images en taille totale presque identiques pour chaque
page en utilisant beaucoup d'espace mémoire qui pourrait être plus efficacement utilisé pour améliorer la
performance du projet avec d'autres techniques (telles que, par exemple, le cache de la page).
3. Les rectangles englobant peuvent inclure des zones transparentes, pour minimiser les zones transparentes (par
exemple diviser l'image en plusieurs images) car ils peuvent représenter un gaspillage de ressources, même lorsque
optimisé.
4. Optimiser la taille de l’image. L'image sera rendue à la taille du widget d'image contenant l'image. Pour les
meilleures performances, le widget doit avoir la même taille d'image.
5. Évitez d' utiliser l'échelle pour adapter pour les widgets d'image, car cela force un redimensionnement au moment
de l'exécution pour les images dynamiques et « cache » la taille réelle de l'image lors de l'édition.
6. Utilisez une taille pour adapter pour rendre le widget à la taille réelle de son contenu.
7. Si le chevauchement ne peut être évité, assurez-vous de placer les widgets statiques à l’arrière, qui est derrière le
widget dynamique.
8. Choisissez le format de fichier d'image basé sur le périphérique IHM auquel vous êtes connecté.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
423
Optimisation statique
9. Évitez d'utiliser trop de widgets sur une seule page. Souvent, les widgets sont placés en dehors de la zone visible
ou leur transparence est contrôlée par une variable. Puisque les widgets sont chargés, même s’ils ne sont pas
visibles, avoir trop de widgets sur une page peut ralentir considérablement le temps de modification de la page.
10. Divisez une page avec de nombreux widgets en plusieurs pages avec moins de widgets.
11. Pour afficher de nouveaux éléments graphiques dans une page, préférez les pages de dialogue avec positionnement
contrôlé aux widgets transparents.
12. Vérifiez le dossier opt pour voir si l'optimisation statique fonctionne comme prévu, les widgets par ordre z peuvent
avoir besoin d’être ajustés.
13. Les champs numériques sont souvent utilisés pour exécuter du code JavaScript sur l’événement OnDataUpdate
même si le widget n'a pas besoin d'être visible sur la page. Dans ce cas, placez le widget en dehors de la zone de
page visible au lieu de le rendre invisible, en modifiant la couleur de police ou la propriété de visibilité. Dans ce
dernier cas, vous pourriez vous retrouver avec de nombreux coins laissés vides.
14. Utilisez un bouton Zone réactive si vous avez besoin d'une zone tactile pour réagir aux entrées de l'utilisateur.
15. Si vous réutilisez un widget depuis la galerie ou que vous créez votre propre widget, rappelez-vous de définir les
propriétés correctes d'optimisation. Par exemple, les widgets bouton sont des widgets dynamiques, si vous utilisez
un widget bouton juste pour son cadre, il ne sera pas optimisé puisque le widget bouton est dynamique. Si vous
avez juste besoin du cadre, vous devez utiliser l'image Vers le haut.
16. Avec de nombreuses pages ayant de nombreux widgets dynamiques et en utilisant un modèle commun :
1. définir l’optimisation statique de modèle sur vrai,
2. définir l'optimisation statique de la page sur faux, puisque l'arrière-plan est déjà prévu par le modèle.
Dans ce scénario, l'arrière-plan peut être réutilisé par de nombreuses pages différentes économisant ainsi de
l'espace mémoire.
17. Ne pas utiliser des widgets dynamiques, tels que les boutons, uniquement à des fins graphiques, lorsque la fonction
du bouton n’est pas nécessaire, utiliser plutôt les widgets image pour obtenir le même effet graphique.
Voici un exemple d'une bonne et d'une mauvaise utilisation d'optimisation statique.
Formats d’image supporté
AGI Creator supporte de nombreux formats à trame tels que BMP, PNG, JPEG, TIFF et le format de vecteur SVG. Voici
une liste des avantages et des inconvénients :
424
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
47 Trucs et astuces pour améliorer la performance
Format
d’image
Avantages
À TRAME
VECTEUR
(SVG)
Inconvénients
l
Rendu rapide
l
Grande taille de fichier
l
Bien normalisé
l
Résolution fixe
l
l
l
Petite taille de
fichier
Redimensionner
sans perte de
qualité
l
l
l
Les images SVG complexes avec des nombreux éléments
graphiques et des couches peuvent être plus lents à rendre.
Créer un SVG optimisé n’est pas simple.
Seul Tiny 1.2 (http://www.w3.org/TR/SVGTiny12/) est
supporté.
Peut gérer les
propriétés
dynamiques
Note : Le logiciel Scour est un outil gratuit qui peut être utilisé pour retirer le code étranger du fichier
(http://www.codedread.com/scour/).
Optimisation statique des modèles
Les pages de modèles peuvent avoir de grandes quantités de contenu statique. Cependant, l'optimisation statique ne peut
pas être appliquée à un modèle de page, puisque là où le modèle est utilisé est basé sur la conception de la page.
Si une image d'arrière-plan énorme doit être répétée à chaque page qui utilise le même modèle, cela augmenterait
l'empreinte du périphérique de sorte que la même image statique serait créé pour chacune des pages en utilisant la page de
modèle.
FAQ sur l’optimisation statique
Q : Dans une page où il y a quelques widgets identiques, dans le dossier opt , je vois un PNG pour
chacun d’entre eux. S’ils sont vraiment identiques, pourquoi le logiciel les double au lieu d'avoir un
seul PNG ?
R : Le logiciel ne sait pas si les images statiques sont en fait les mêmes puisque chaque widget pourrait avoir différents
paramètres/propriétés modifiant le rendu réel au moment de l'exécution.
Q : Pourquoi les images statiques stockées dans un dossier séparé appelé opt au lieu de les stocker
directement dans le dossier du projet ?
R : Cela permet d'éviter les collisions de noms et permet de sauter le chargement des images d'optimisation
Q : Pourquoi les images statiques sont stockées en tant que fichiers PNG au lieu de fichiers JPEG
classiques ?
R : Le format PNG utilise une compression sans perte pour les images et supporte les transparents. Les fichiers JPEG
seraient plus flous par rapport aux fichiers PNG avec un résultat différent dans AGI Creator(Ne pas utiliser l'optimisation) et
HMI Runtime.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
425
Mise en cache de page
Q : Que se passe-t-il lorsqu’aucune optimisation ne se fait dans le logiciel ?
R : Chaque widget individuel est rendu au moment de l'exécution. En particulier, les images SVG peut nécessiter
beaucoup de temps à rendre dans une plate-forme embarquée.
Mise en cache de page
Une fois accédées, les pages sont conservées dans un cache RAM jusqu'à atteindre la taille maximale du cache, qui
dépend de la RAM effectivement disponible de la plateforme. Cela permet un accès beaucoup plus rapide, car lorsque l'on
charge à nouveau les pages mises en cache, seul leur contenu doit être retracé, sans qu'il soit nécessaire de charger à
nouveau l'ensemble des ressources de la page.
Image DB
L'image DB est une technique utilisée pour tracer l'utilisation de fichiers d'image et pour réduire le coût de chargement des
images moyennant la mise en cache des images les plus fréquemment utilisées (par exemple, les images BoutonPoussoir, Aiguilles de calibre, Barres de défilement etc.). La même image, utilisée à plusieurs emplacements différents,
n'est donc chargée qu'une seule fois.
L'image DB préchargera les images les plus utilisées au démarrage jusqu'à ce que la limite de mémoire soit atteinte. Cela
permet d'écourter les délais de chargement de la page individuelle.
Le fichier imagecachelist.xml est créé dans le dossier projet/opt, et contient des informations utiles :
l
Couleur de remplissage (en cas d'images SVG)
l
Taille de l'image SVG
l
Nombre de fois qu'une image est utilisée dans le projet
l
Nombre de tailles différentes pour la même image
Astuces d'utilisation de la fonction Image DB
1. Dans la mesure du possible, utilisez une taille uniforme pour les boutons, les calibres et les autres widgets.
2. Utilisez des thèmes de même couleur parmi les widgets d'un même type.
Pré-cachage
L'attribut pré-cache des pages peut être utilisé pour notifier à HMI Runtimede précharger certaines pages dans la RAM au
moment de l'initialisation pour un accès plus rapide. Le pré-cachage est utile pour les pages complexes ayant de nombreux
widgets dynamiques.
Lorsque cette fonction est activée dans une page, l'accès à cette page est plus rapide, mais elle ralentit également
l'initialisation, le système n'étant prêt qu'une fois que toutes les pages à pré-cacher ont été sauvegardées dans la RAM.
426
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
47 Trucs et astuces pour améliorer la performance
Astuces pour le pré-cachage
1. Activez la fonction pré-cache uniquement pour quelques pages ayant plusieurs widgets dynamiques ou pour des
pages utilisées fréquemment par les utilisateurs.
2. N'activez pas la fonction précache pour toutes les pages du projet, vous risquez d'épuiser la mémoire et de n'obtenir
aucun avantage.
3. Désactivez l'optimisation statique pour les pages où la fonction précache est activée afin de limiter l'utilisation de la
mémoire.
FAQ sur le pré-cachage
Limite de page au pré-cachage
En fonction de la taille et de la complexité d'une page, l'espace requis pour le pré-cachage peut aller de 1,5Mb à 3Mb.
Lorsqu'un projet est chargé, HMI Runtime procède de la façon suivante :
1. Les images de page sont préchargées jusqu'à ce que l'espace mémoire encore disponible atteigne 76 MB
(imageDBLowMem)
2. Les pages où la mémoire pré-cache est configurée sur vrai sont préchargées jusqu'à ce que l'espace mémoire
encore disponible atteigne 64 MB (pageCacheLowMemMax). Les images de ces pages sont chargées dans la RAM
(dans l'Image DB).
Lorsque le projet est prêt :
1. Toute page nouvelle visitée est sauvegardée dans le cache (RAM) avec toutes les images associées jusqu'à ce que
l'espace mémoire encore disponible atteigne 40 MB (pageCacheLowMemMin)
2. Lorsqu'un changement de page survient et que l'espace dans la RAM est critique (<40MB), le HMI Runtime
commence à vider le cache (RAM) en supprimant des pages et les images associées jusqu'à ce que 64 MB
d'espace mémoire soient rendus disponibles. HMI Runtime supprime les données stockées dans le cache dans
l'ordre suivant :
1. les dernières pages visitées, les images les plus grandes et celles inutilisées (>320x240),
2. s'il faut libérer plus de mémoire, les pages en pré-cache ainsi que toutes les images chargées dans Image
DB peuvent également être supprimées.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
427
FAQ sur le pré-cachage
428
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
48 Précisions fonctionnelles et
compatibilité
Voici un aperçu des fonctions prises en charge et des limites connexes. Les limites indiquées ici sont des limites
prudentes, au-delà desquelles le fonctionnement correct et la performance du système ne sont plus garantis.
Tableau de fonctions et limites
430
Capacités des périphériques IHM.
431
Compatibilité
432
Projets de conversion entre les différents périphériques IHM
432
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
429
Tableau de fonctions et limites
Tableau de fonctions et limites
Fonction
Limite maximum
Nombre de pages
1,000
Nombre de widgets de base
2,000 x page
Nombre de variables
10,000
Nombre de pages de dialogue
50
Nombre de pages de dialogue qui peuvent être ouvertes en
même temps
5
Nombre de recettes
32
Nombre d'ensembles de paramètres pour une recette
1,000
Nombre d'éléments par recette
1,000
Nombre de groupes d'utilisateurs
50
Nombre d'utilisateurs
50
Nombre de clients distants simultanés
4
Nombre de planificateurs
30
Nombre d'alarmes
2.000 (voir "Capacités des périphériques IHM." on the
facing page)
Nombre de transferts de données
1000
Nombre de pages de modèles
50
Nombre d'actions programmables par état de bouton
32
Nombre de mémoires des tendances
30
Nombre de courbes par widget de tendance
5
Nombre de courbes par widget de diagramme de dispersion
10
Nombre d'échantillons par mémoire des tendances
200,000
Nombre de variables par mémoire des tendances
200
Nombre d'échantillons de mémoire des tendances pour un
projet
1.200.000 (voir "Capacités des périphériques IHM." on the
facing page)
Nombre de messages dans un champ de message
1024
Nombre de langues
12
Nombre d'événements par mémoire tampon
2,048
430
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
48 Précisions fonctionnelles et compatibilité
Fonction
Limite maximum
Nombre d'événements par mémoire des tendances
4
Taille de fichier JavaScript par page
16 KB
Taille de projet sur disque
60 Mo (voir "Capacités des périphériques IHM." below)
Nombre d'instances indexées
100
Nombre d'alias indexés
100
Nombre d'ensembles de variables indexés
30
Nombre de protocoles physiques
4
Nombre de rapports
32
Nombre de pages de rapports
32
Nombre max. de variables dans le widget de variables
255
Taille du dossier utilisateur (UpdatePackage.zip)
5 MB
Dossiers FTP supplémentaires
5
Capacités des périphériques IHM.
Voir "Tableau de fonctions et limites" on the previous page pour les fonctions standards.
Périphérique IHM (Windows CE)
Limites
AGI315, AGI315G
Capacités standards
AGI304, AGI307, AGI307G
Max_Alarm = 500
Max_ProjectSize = 30 Mo
Périphériques IHM (Linux)
Limites
AGI407, AGI410, AGI415, AGI421
Max_ProjectSize = 240 Mo
Max_Alarm = 4,000
Nombre d'échantillons de mémoire des
tendances pour un projet = 2.400.00
PC (Windows)
Limites
AGI PC Runtime
Max_Alarm = 10,000
Max_PageWidth = 10.000 px
Max_PageHeight = 10.000 px
Fonctions non disponibles dans les périphériques Linux :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
431
Compatibilité
l
LaunchBrowser macro
l
Widget de lecteurs médias
l
Les périphériques d'impression ne sont pas pris en charge. Les rapports peuvent être imprimés uniquement sur les
fichiers PDF. L’impression des rapports de texte et des événements d'alarme n’est pas prise en charge.
Fonction non disponible sur AGI PC Runtime :
l
Plug-in VNC et PDF Readers
l
Gérer cible
l
Outil de réglage du système
l
Sauvegarde/Restauration
l
Protocoles de série qui requièrent un matériel spécial.
Compatibilité
La politique de compatibilité suivante a été adoptée :
l
l
l
l
l
l
La version AGI Creator doit toujours être alignée avec HMI Runtime sur le périphérique,
l'utilisateur est responsable de la mise à jour des composants de HMI Runtime sur le périphérique IHM à chaque
mise à jour de AGI Creator,
la mise à jour de HMI Runtime peut être réalisée directement à partir de AGI Creator avec la commande Mise à jour
de la cible, qui est disponible dans la boîte de dialogue Exécuter\Gérer cible,
les projets créés dans une version de AGI Creator postérieure à la version V1.00 (00) peuvent être ouverts et gérés
par les nouvelles versions,
les projets qui sont créés avec des versions antérieures de AGI Creator, ouverts avec des versions postérieures et
déployés sur HMI Runtime compatible, maintiennent leurs performances et leurs fonctionnalités,
la compatibilité n'est pas assurée entre les versions les plus récentes de HMI Runtime et les projets créés et
déployés avec des versions moins récentes de AGI Creator.
Important : N'éditez pas de projets avec une version de AGI Creator moins récente que celle utilisée
pour les créer. Cela pourrait endommager le projet et rendre HMI Runtime instable.
Projets de conversion entre les différents
périphériques IHM
La conversion de projet à partir de différents modèles de périphériques IHM est prise en charge, cependant, certaines
opérations manuelles peuvent être nécessaires si le projet utilise des fonctions non supportées dans le périphérique de
destination.
Lignes directrices
Avant de convertir un projet, contrôler s’il existe des fonctions non supportées (voir "Capacités des périphériques IHM." on
the previous page), et ajuster votre projet en supprimant les fonctionnalités non prises en charge avant de convertir le
projet.
En particulier :
432
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
48 Précisions fonctionnelles et compatibilité
l
l
Vérifiez les limitations et les fonctionnalités non prises en charge par le nouveau périphérique IHM (voir "Tableau de
fonctions et limites" on page 430 pour plus de détails).
Supprimez les widgets, les actions, les variables système, les protocoles et les propriétés de projet qui ne sont pas
pris en charge.
l
Si le projet utilise un stockage externe, vérifier si le même chemin de stockage est toujours disponible.
l
Ajustez les applications ou les chemins externes spécifiques à un système d'exploration.
l
l
l
Si besoin, réduire la taille du projet selon les nouvelles limitations de type de périphérique IHM (voir « Limitations »
pour plus de détails).
Puisque les périphériques IHM sont basés sur différentes plateformes matérielles avec différente vitesse de
processeur, taille de la mémoire RAM, taille du cache, assurez-vous de vérifier le temps de démarrage du projet et le
temps de chargement de la page pour chaque page dans le projet.
Vérifiez le code JavaScript pour les opérations spécifiques au système d'exploitation.
Fonctionnalités spécifiques au système d'exploitation
Linux est sensible à la casse alors que Windows CE ne l’est pas. Par conséquent, les projets sur les périphériques IHM
Linux peuvent avoir différents fichiers nommés en fonction des majuscules et minuscules, par exemple « dump1.csv » et
« Dump1.csv », ce qui n’est pas possible sur les périphériques IHM Windows CE.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
433
Projets de conversion entre les différents périphériques IHM
434
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49
Protocoles de communication
Cette section décrit les protocoles disponibles.
Note : Il est possible que le matériel ou les protocoles du contrôleur aient été modifiés depuis la création de cette
documentation. Veuillez toujours tester et vérifier le bon fonctionnement de l'application. Pour intégrer les
évolutions du matériel et des protocoles du contrôleur, les pilotes font l'objet d'une mise à jour continue. Pour
cette raison, veuillez vous assurer que l'application utilise le pilote le plus récent.
Il est possible d'utiliser des médias physiques, passerelles, routeurs et concentrateurs dans le réseau de communication.
De plus, les autres périphériques peuvent utiliser le réseau de manière autonome et simultanée. Toutefois, il est important
de garantir que le trafic généré par ces périphériques n'amène pas de dégradation inacceptable de la vitesse de connexion
(temps aller-retour).
A-B ENET
437
A-B DF1
449
A-B DH-485
462
Beckhoff ADS
476
CANopen HMI
491
CODESYS V2 ETH
498
CODESYS V3 ETH
511
Ethernet/IP CIP
521
J1939
547
Modbus RTU
557
Modbus RTU Server
573
TCP Modbus
589
Modbus TCP Server
606
Mitsubishi FX ETH
618
Mitsubishi FX SER
633
Mitsubishi iQ/Q/L ETH
642
NMEA 0183
652
Omron FINS ETH
676
Omron FINS SER
687
OPC UA Client
697
Simatic S7 PPI
705
Simatic S7 ETH
712
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
435
Simatic S7 MPI
744
Variables
770
436
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
A-B ENET
Le protocole de communication A-B ENET est normalement utilisé sur les contrôleurs Allen-Bradley via communication
Ethernet.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à chaque
nom de variable importé pour chaque nœud réseau.
Adresse
IP
Adresse IP Ethernet du contrôleur.
Port
Numéro du port utilisé par l’interface Ethernet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
437
A-B ENET
Élément
Description
Délai
d'attente
Délai d’attente (en millisecondes) entre deux tentatives en cas d’absence de réponse du
contrôleur.
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur (esclave).
Configuration du contrôleur
Vous devez configurer correctement l’API afin de correspondre à l’adresse IP configurée dans l'éditeur du protocole. En
temps normal, vous pouvez laisser la configuration de l’API par défaut.
438
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Configurer le module 1761-NET-ENI
Voici la procédure pour configurer le module 1761-NET-ENI avec l'utilitaire ENI/ENIW d’Allen Bradley. Cette procédure
nécessite un câble de communication 1761-CBL-PM02.
1. Branchez le connecteur DIN 8 broches au port 2 du périphérique NET-ENI et le connecteur femelle D-shell 9
broches au port COM de l’ordinateur.
2. Branchez le contrôleur SLC 5/0x et connectez-vous en ligne.
3. Dans l'onglet Paramètres de l’utilitaire, configurez Port COM et Débit en bauds.
4. Dans l’onglet Addr IP ENI, sélectionnez la Série ENI correspondante dans la liste, et si nécessaire, configurez
Adresse IP ENI, Masque de sous-réseau et Débit en bauds.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
439
A-B ENET
5. Enregistrez la configuration du périphérique NET-ENI.
Vous disposez de deux espaces de mémoire séparés pour enregistrer cette configuration : ENI/RAM (pour les
configurations temporaires) et ENI/ROM (pour les configurations permanentes).
Adressage logique E/S
Pour les données E/S d’Allen Bradley, le panneau utilise l’adressage logique plutôt que l’adressage physique. Tandis que
l’adressage physique correspond au numéro d’élément faisant office de numéro de créneau, l’adressage logique
correspond au premier élément pour la première carte E/S d’un type de fichier donné.
L’adressage AGI Creator dépend du mappage de la mémoire processeur de l’API et non du numéro de créneau. Soyez
donc vigilant lorsque vous modifiez la configuration afin d'éviter un remappage.
Utilisez la structure de l’outil de configuration E/S RSLogix 500 de l’E/S de l’API pour configurer l’E/S, comme dans
l’exemple.
440
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Lorsque vous utilisez un module disposant d'une taille d’E/S configurable (Devicenet Scanner, par
exemple), veillez à configurer la plus grande taille possible, sinon vous devrez le remapper lorsque vous aurez
besoin de plus d’espace.
Utilisez le navigateur de fichier de données pour visualiser l’attribution de la mémoire par l’API.
L’exemple suivant explique comment configurer la variable AGI Creator pour pointer vers la ressource S:1/19 de l’API
(S1:1.1/3 en termes de mot).
La figure suivante présente la configuration de la variable AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
441
A-B ENET
La variable AGI Creator configurée dans l’exemple ci-dessus pointe vers l’élément présenté dans la figure suivante.
Exemples
E:0/19 (E1:0.1/3 en termes de mot) – 20è entrée sur le processeur
442
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Paramètre
Configuration
Type de fichier
Entrée Disc
Num de fichier
1
Type de données
Boolean
Dans le navigateur de fichier de données, mot 0.1 correspond à Mot 1 :
Élément
1
Sous-index
3
E:1/15 (E1:1.0/15 en termes de mot) - Dernière entrée sur le créneau 1 de la carte d’entrée
Paramètre
Configuration
Type de fichier
Entrée Disc
Num de fichier
1
Type de données
Boolean
Dans le navigateur de fichier de données, mot 1.0 correspond à Mot 8 :
Élément
8
Sous-index
15
E:4.0 (E1:4.0 en termes de mot) - Première entrée analogique
Paramètre
Configuration
Type de fichier
Entrée Disc
Num de fichier
1
Type de données
Short
Dans le navigateur de fichier de données, mot 4.0 correspond à Mot 10 :
Élément
10
Sous-index
-
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
443
A-B ENET
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
Importation des variables
Exporter des variables depuis l’API
Le filtre d’importation de variables A-B Ethernet accepte les fichiers de symboles avec l’extension « .csv » générés par le
RSLogix 500 de Rockwell.
Pour générer le fichier, sélectionnez Outil > Base de données > Exporter ASCII
444
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Dans l’onglet CSV, sélectionnez les données à exporter et donnez un nom au fichier csv de sortie.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
445
A-B ENET
Importer des variables dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
Pilote d'importation
Description
RSLogix500 v1.0
Linéaire
Nécessite un fichier .csv.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
Toutes les variables s’affichent au même niveau.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
446
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
447
A-B ENET
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contrôleur répond « Ne pas confirmer ».
-
Délai
d'attente
La requête n’a obtenu aucune réponse dans
le délai d’attente spécifié.
Vérifiez que le contrôleur est connecté et correctement
configuré pour accéder au réseau.
Réponse
non valide
Le contrôleur a envoyé une réponse ou un
contenu non valide au périphérique.
Vérifiez la cohérence entre les données programmées
dans le projet et les ressources du contrôleur.
Erreur
générale
Erreur non identifiable. Ne doit jamais être
signalée.
Contactez l’assistance technique.
448
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
A-B DF1
The A-B DF1 communication driver has been designed to connect HMI devices to a Allen-Bradley controllers through serial
communication.
Protocol Editor Settings
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Element
Description
Node ID
Serial node associated to the PLC.
Checksum It can be BCC or CRC, depending on PLC settings.
type
PLC
Models
PLC models available:
l
PLC3
l
PLC5/10/12/15/25
l
PLC5/40/40L
l
PLC5/60/60L
l
SLC500 Fixed I/O
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
449
A-B DF1
Element
Comm...
Description
l
SLC500 Modular I/O
l
Micrologix 1000
l
Micrologix 1500
l
Ultra5000
If clicked displays the communication parameters setup dialog.
Element
Parameter
Port
Serial port selection.
l
l
l
450
COM1: device PLC port.
COM2: computer/printer port on panels with 2 serial ports or
optional Plug-In module plugged on Slot 1/2 for panels with 1
serial port on-board.
COM3: optional Plug-In module plugged on Slot 3/4 for panels
with 1 serial port on-board.
Baudrate, Parity,
Data Bits, Stop
bits
Serial line parameters.
Mode
Serial port mode. Available modes:
l
RS-232.
l
RS-485 (2 wires).
l
RS-422 (4 wires).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Tag Editor Settings
In Tag Editor select the protocol A-B DF1.
Add a tag using [+] button. Tag setting can be defined using the following dialog:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
451
A-B DF1
Element Description
Memory
Type
Memory Type
Description
Disc Out
Discrete output value. O resource on PLC.
Disc In
Discrete input value. I resource on PLC.
Status
Status value. S resource on PLC.
Bit
Bit value. B resource on PLC.
Timer
Timer value. T resource on PLC.
Counter
Counter value. C resource on PLC.
Control
Control value. R resource on PLC.
Integer
Integer value. N resource on PLC.
Float
Float value. F resource on PLC.
Element Represents the line of the resource while monitoring PLC values.
Subind
ex
Represents the column of the resource while monitoring PLC values.
File
Num
Instance of resource of the PLC.
Data
Type
Available data types:
l
boolean
l
byte
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
double
l
string
l
binary
See "Programming concepts" section in the main manual.
Note: To define arrays, select one of Data Type format followed by square brackets
(byte[], short[]…).
Arraysi
ze
452
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
l
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Sub
Allows to point to specific part of a resource:
Element
l
0 (entire resource)
Conver
sion
l
PRE
l
ACC
l
LEN
l
POS
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
453
A-B DF1
Element Description
Valeur
Description
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Tag Import
Exporting Tags from PLC
The A-B DF1 tag import filter accepts symbol files with extension “.csv” created by the Rockwell RSLogix 500.
To create the file select Tool > Database > ASCII Export
454
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
From CSV tab select the data to be exported and give a name to the output csv file.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
455
A-B DF1
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
The following dialog shows which importer type can be selected.
Importer
Description
RSLogix500 v1.0
Linear
Requires an .csv file.
Tag Editor exported
xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
456
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
457
A-B DF1
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Logical I/O addressing
When addressing Allen Bradley I/O data, the panel uses logical addressing rather than physical addressing. While physical
addressing refers to the element number as the slot number, logical addressing refers to the first element for the first I/O
card of a specific file type.
AGI Creator addressing depends on the mapping of the PLC CPU memory and not on the slot number, therefore you should
be careful when changing the configuration in order to avoid remapping.
Use the RSLogix 500 I/O Configuration tool layout of the PLC I/O to configure I/O as in the example.
458
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: When using a module with a configurable I/O size (for example, Devicenet Scanner) make sure you
configure it to the largest possible size or you will have to remap it if you need to allocate more space.
Use the Data File Browser to see how the PLC allocates memory.
This example shows how to configure the AGI Creator Tag for pointing to PLC resource O:1/19 (O1:1.1/3 in word terms).
The following figure shows the AGI Creator Tag configuration.
The AGI Creator Tag configured in the example above points on the element shown in the following figure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
459
A-B DF1
Examples
I:0/19 (I1:0.1/3 in word terms) – 20th Input on CPU
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Boolean
In the Data File Browser, word 0.1 is Word 1:
Element
1
Sub Index
3
I:1/15 (I1:1.0/15 in word terms) - Last Input on Slot 1 Input Card
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Boolean
In the Data File Browser, word 1.0 is Word 8:
Element
8
Sub Index
15
460
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
I:4.0 (I1:4.0 in word terms) - First Analog Input
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Short
In the Data File Browser, word 4.0 is Word 10:
Element
10
Sub Index
-
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
461
A-B DH-485
A-B DH-485
The A-B DH-485 communication driver has been designed to connect HMI devices to a Allen-Bradley controllers through
serial communication.
Protocol Editor Settings
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Element
Description
Panel ID
Serial node associated to the HMI.
Slave ID
Serial node associated to the PLC.
MaxID
Represent the maximum ID available in the serial network.
PLC
Models
PLC models available:
462
l
SLC500 Fixed I/O
l
SLC500 Modular I/O
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Comm...
Description
l
Micrologix 1000
l
Micrologix 1500
If clicked displays the communication parameters setup dialog.
Element
Parameter
Port
Serial port selection.
l
l
l
PLC Netwo
rk
COM1: device PLC port.
COM2: computer/printer port on panels with 2 serial ports or
optional Plug-In module plugged on Slot 1/2 for panels with 1
serial port on-board.
COM3: optional Plug-In module plugged on Slot 3/4 for panels
with 1 serial port on-board.
Baudrate, Parity,
Data Bits, Stop
bits
Serial line parameters.
Mode
Serial port mode. Available modes:
l
RS-232.
l
RS-485 (2 wires).
l
RS-422 (4 wires).
IP address for all controllers in multiple connections. PLC Network must be selected to
enable multiple connections.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
463
A-B DH-485
Element
Description
Tag Editor Settings
In Tag Editor select the protocol A-B DH-485.
Add a tag using [+] button. Tag setting can be defined using the following dialog:
464
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Memory
Type
Memory Type
Description
Disc Out
Discrete output value. O resource on PLC.
Disc In
Discrete input value. I resource on PLC.
Status
Status value. S resource on PLC.
Bit
Bit value. B resource on PLC.
Timer
Timer value. T resource on PLC.
Counter
Counter value. C resource on PLC.
Control
Control value. R resource on PLC.
Integer
Integer value. N resource on PLC.
Float
Float value. F resource on PLC.
String
String value. STR resource on PLC.
Element Represents the line of the resource while monitoring PLC values.
Subind
ex
Represents the column of the resource while monitoring PLC values.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
465
A-B DH-485
Element Description
File
Num
Instance of resource of the PLC.
Data
Type
Available data types:
l
boolean
l
byte
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
double
l
string
l
binary
See "Programming concepts" section in the main manual.
Note: To define arrays, select one of Data Type format followed by square brackets
(byte[], short[]…).
Arraysi
ze
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
466
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Sub
Allows to point to specific part of a resource:
Element
l
0 (entire resource)
Conver
sion
l
PRE
l
ACC
l
LEN
l
POS
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
467
A-B DH-485
Element Description
Valeur
Description
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Tag Import
Exporting Tags from PLC
The A-B DF1 tag import filter accepts symbol files with extension “.csv” created by the Rockwell RSLogix 500.
To create the file select Tool > Database > ASCII Export
468
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
From CSV tab select the data to be exported and give a name to the output csv file.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
469
A-B DH-485
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
The following dialog shows which importer type can be selected.
Importer
Description
RSLogix500 v1.0
Linear
Requires an .csv file.
Tag Editor exported
xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
470
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
471
A-B DH-485
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Logical I/O addressing
When addressing Allen Bradley I/O data, the panel uses logical addressing rather than physical addressing. While physical
addressing refers to the element number as the slot number, logical addressing refers to the first element for the first I/O
card of a specific file type.
AGI Creator addressing depends on the mapping of the PLC CPU memory and not on the slot number, therefore you should
be careful when changing the configuration in order to avoid remapping.
Use the RSLogix 500 I/O Configuration tool layout of the PLC I/O to configure I/O as in the example.
472
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: When using a module with a configurable I/O size (for example, Devicenet Scanner) make sure you
configure it to the largest possible size or you will have to remap it if you need to allocate more space.
Use the Data File Browser to see how the PLC allocates memory.
This example shows how to configure the AGI Creator Tag for pointing to PLC resource O:1/19 (O1:1.1/3 in word terms).
The following figure shows the AGI Creator Tag configuration.
The AGI Creator Tag configured in the example above points on the element shown in the following figure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
473
A-B DH-485
Examples
I:0/19 (I1:0.1/3 in word terms) – 20th Input on CPU
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Boolean
In the Data File Browser, word 0.1 is Word 1:
Element
1
Sub Index
3
I:1/15 (I1:1.0/15 in word terms) - Last Input on Slot 1 Input Card
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Boolean
In the Data File Browser, word 1.0 is Word 8:
Element
8
Sub Index
15
474
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
I:4.0 (I1:4.0 in word terms) - First Analog Input
Parameter
Setting
File Type
Disc In
File Num
1
Data Type
Short
In the Data File Browser, word 4.0 is Word 10:
Element
10
Sub Index
-
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
475
Beckhoff ADS
Beckhoff ADS
Beckhoff ADS protocol driver is used for communication with Beckhoff controllers through Ethernet connection. This
implementation of Beckhoff ADS protocol driver is based on the information published by Beckhoff.
Protocol Editor Settings
Add (+) a driver in the Protocol editor and select the protocol “Beckhoff ADS” from the list of available protocols.
Element
Description
Alias
Name to be used to identify nodes in the plc network configuration. The name will be added as a
prefix to each tag name imported for each network node.
Panel
AMS
Net ID
Specifies the AMS net ID of the panel; the first 4 bytes must match the panel IP address
assigned to the HMI device. If panel has IP address 192.168.10.100 then AMS Net ID could be
192.168.10.100.1.1
Panel
Specifies the panel AMS port number to be used on panel.
476
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Description
AMS
Port
Using TwinCAT2, default Panel AMS Port is 32976.
Using TwinCAT3, default Panel AMS Port is 32844.
Target
Specifies the IP address of the target controller.
IP
Address
Target
AMS
Net ID
Specifies the Target AMS net ID of the target controller.
Target
AMS
Port
Specifies the port number dedicated to the communication on target device.
Using TwinCAT2, default Target AMS Port is 801.
Using TwinCAT3, default Target AMS Port is 851.
Timeout
The number of milliseconds between retries when communication fails.
PLC
models
Select the model which corresponds to the device to be connected. Model selection is very
important to be set properly.
PLC
Network
The protocol allows the connection of multiple controllers to one operator panel. To set-up
multiple connections, check “PLC network” checkbox and enter the Target Controller settings for
every node.
TwinCAT2 Route Settings
Beckhoff controllers require some specific settings to allow connection from HMI devices.
In TwinCAT2 System Manager you need to configure Static Route.
First of all the system must be reset in Configuration Mode using the toolbar button as showed in the following figure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
477
Beckhoff ADS
Then confirm to Restart TwinCAT2 System in Config Mode as in the figure below.
Once restarted, as in the next figure, follow these steps to add a new Route:
1. Open Route Settings.
2. Select Static Routes tab.
3. Click on [Add] button.
478
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Into Add Route Dialog user must set:
1. Route Name: a name useful to indentify the Route i.e. “HMI”, AmsNetId: The Panel AMS Net ID as configured into
Beckhoff ADS protocol, Transport Type: TCP/IP.
Address Info: Type in the Panel IP Address with “IP Address” option selected.
2. Target Route: Static.
3. Click on [Add Route] button. Note: no warning or message will be shown.
4. Click on [Close] button.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
479
Beckhoff ADS
Then the route will appear under Static Routes list.
TwinCAT3 Route Settings
Beckhoff controllers require some specific settings to allow connection from HMI devices. In TwinCAT3 XAE you need to
configure a Static Route.
First of all TwinCAT3 system must be reset in Configuration Mode using the toolbar button as showed in the following
figure.
480
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Then confirm to Restart TwinCAT3 System in Config Mode.
Once restarted, as in the next figure, follow these steps to add a new Route:
1. Open Routes.
2. Select Static Routes tab.
3. Click on [Add] button.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
481
Beckhoff ADS
Into Add Route Dialog user must set:
1. Route Name: a name useful to indentify the Route i.e. “HMI”, AmsNetId: The Panel AMS Net ID as configured into
Beckhoff ADS protocol, Transport Type: TCP/IP.
Address Info: Type in the Panel IP Address with “IP Address” option selected.
2. Target Route: Static.
3. Click on [Add Route] button. Note: no warning or message will be shown.
4. Click on [Close] button.
482
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Then the route will appear under Static Routes list.
Tag Import
Exporting Tags from PLC
The data in the Beckhoff system is based on tags.
The organization of the internal memory of the controller is not fixed but it is configured by the user at development time.
Each data item can be identified by a string called “tag”.
The TwinCAT development environment generates the list of tags created for each controller in the configuration of the
application.
The project in the panel must refer to the tag names assigned in the TwinCAT PLC Control programming software at
development time. The Designer Tag Editor supports direct import of the tag file generated by the Beckhoff software.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
483
Beckhoff ADS
To export tags defined for the selected controller, click on Project > Build as shown.
The TwinCAT PLC Control software will create a file with extension TPY.
484
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
The following dialog shows which importer type can be selected.
Importer
Description
TwinCAT v1.0
Linear
Requires a .tpy file.
Tag Editor exported
xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Note: the Beckhoff driver supports direct access to the PLC tags using the handles; this means that if no tags
are added to the PLC and the PLC program is just re-compiled, you do not need to re-import tags as the access
to them does not depend from the offset, but only from name.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
485
Beckhoff ADS
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
486
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Using TwinCAT v1.0 Import Filter
When importing tags, the user can decide to import all the tags from the .tpy file or apply a filter importing only a subset of
them.
The figure below shows how to specify the filter. The filter consist in a string (no wildcards are supported). The import filter
will import only the tags having the specified string in the description.
If the description is applied to an “instance declaration” of a Function Block, all the tags within the block will be imported.
If the string is contained only as comment of some variables inside the Function Block, only that variables will be imported.
As an example for the use of the import filter, please see the following case.
FUNCTION_BLOCK FB_Motor
VAR_INPUT
bStartMotor: BOOL;
bReset: BOOL;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
487
Beckhoff ADS
END_VAR
VAR_OUTPUT
bMotorOn: BOOL;
bAlarm: BOOL;(* HMI Thermal alarm *)
END_VAR
VAR
sData: STRING;
bResetStatistics: BOOL; (* HMI Reset statistics *)
END_VAR
VAR PERSISTENT
stStat: ST_MotorStats; (* HMI Motor statistics *)
END_VAR
Function block instances declaration:
VAR
fbMotor1: FB_Motor;
fbMotor2: FB_Motor; (* HMI only show Motor 2!! *)
END_VAR
The following tags will be imported:
l
MAIN/fbMotor2/bAlarm
l
MAIN/fbMotor2/bResetStatistics
l
MAIN/fbMotor2/ST_MotorStats
Aliasing Tag Names in Network Configurations
Tag names must be unique at project level; it often happens that the same tag names are to be used for different controller
nodes (for example when the HMI is connected to two devices that are running the same application). Since tags include
also the identification of the node and Tag Editor does not support duplicate tag names, the import facility in Tag Editor has
an aliasing feature that can automatically add a prefix to imported tags. With this feature tag names can be done unique at
project level.
The feature works when importing tags for a specific protocol. Each tag name will be prefixed with the string specified by
the “Alias”. As shown in the figure below, the connection to a certain controller is assigned the name “Node1”. When tags
are imported for this node, all tag names will have the prefix “Node1” making each of them unique at the network/project
level.
488
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: Aliasing tag names is only available when tags can be imported. Tags which are added manually in the
Tag Editor do not need to have the Alias prefix in the tag name.
The Alias string is attached to the tag name only at the moment the tags are imported using Tag Editor. If you
modify the Alias string after the tag import has been completed, there will be no effect on the names already
present in the dictionary. When the Alias string is changed and tags are imported again, all tags will be imported
again with the new prefix string.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Returned in case the controller replies with a not acknowledge
Timeout
Returned when a request is not replied within the specified timeout period; ensure the controller
is connected and properly configured to get network access
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
489
Beckhoff ADS
Error
Notes
Invalid
The panel did receive from the controller a response, but its format or its contents is not as
response expected; ensure the data programmed in the project are consistent with the controller resources
General
Error
490
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
CANopen HMI
The CANopen HMI communication driver has been designed to connect HMI products to a CANopen network. A new
device communication profile has been developed for the HMI. This profile takes advantage from the advanced user
interface features of the products, while retaining the simple networking concept supported by the CANopen network.
The basic idea is create a client/server communication structure where the HMI is the client and the CANopen controller is
the server.
Connection to CANopen network requires the optional CANopen communication module. Verify the suitable version for
your HMI model.
Please note that changes in the controller protocol or hardware, which may interfere with the functionality of this driver, may
have occurred since this documentation was created. Therefore, always test and verify the functionality of the application.
To accommodate developments in the controller protocol and hardware, drivers are continuously updated. Please ensure
that the latest driver is used in the application.
CANopen HMI Profile
In this communication model the HMI initiates the communication sessions, acting as a source of messages.
The basic messages are PDO messages with the standard size of 8 bytes.
The COB-ID of the messages is defined in a way that makes clear, from the well-known CANopen rules, what is the target
of the PDO message.
The format of the PDO message has been defined according to a custom application layer protocol. This application layer
protocol defines a device-independent communication profile optimized for HMI applications.
When the CANopen master controller receives the PDO message, it will interpret its contents and produce a PDO
message with the response addressed to the HMI device.
The definition of this client/server relationship is independent of the CANopen Master in the sense that it can easily be
supported in any particular CANopen master system. The resulting solution is easily portable to any CANopen master.
The software IDE offers a user interface that adapts itself to show the typical addressing model of CANopen master
controller where the panel is going to be connected.
Adapting to different masters is possible using a profile customization file that may contain data definitions for different
controller types.
Profile Details
This chapter provides the specification of the HMI profile and describes the subset of the request/response formats used
by this implementation of the protocol.
The communication driver in the HMI generates PDO messages initiating communication request sessions as soon as the
HMI runtime requires data from the protocol.
The panel is using the first transmit PDO identified by the COB-ID 0x180 combined with the Node Number assigned to the
panel.
The communication profile uses only one transmit PDO and one receive PDO; the limited number of bytes available in
standard PDO message maybe limiting, in some cases, the driver capabilities especially in terms of performance.
Request Format: HMI to Controller (Transmit PDO)
The PDO message transmitted by the HMI is formatted according to the following table.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
491
CANopen HMI
Byte 0
Byte 1
Byte
2
Byte
3
Byte
4
Byte
5
Byte 6
Byte 7
Offset
Low
Offset
High
Data
0
Data
1
Data
2
Data
3
Data Length and Job
Number
Operation Type and
Controller ID
The request frame includes the following elements:
Offset Low
Low byte of the offset (16 bits address) for the requested block of data
Offset High
High byte of the offset (16 bits address) for the requested block of
data
Data 0 … Data 3
Data for Write Operations; not used in Read Operations
Data Length and Job Number
Contains:
Operation Type and Controller
ID
l
number of requested bytes
l
job Number indicator;
Contains:
l
type of operation requested
l
the Controller ID that identifies the target of the message;
Bit 7
Bit 6
Bit 5
Bit 4
Bit 3
Bit 2
Bit 1
Bit 0
Data
Length [1]
Data
Length [0]
Job
Number [5]
Job
Number [4]
Job
Number [3]
Job
Number [2]
Job
Number [1]
Job
Number [0]
The “Data Length” parameter is coded in 2 bits and takes values between 1 and 4 according to the following rules:
00
1 bytes
01
2 bytes
10
3 bytes
11
4 bytes
Note that the elementary size of each data item depends on the Controller memory organization.
The “Job Number” occupies 6 bits and can have values between 0 and 63; the “Job number” parameter is placed as last
element in the PDO to ensure data consistency; the PLC program running the controller should constantly monitor the
value of the “Job Number” parameter and consider the received message as valid only when detecting a change in the
value of the “Job Number” field. “Job Number” is automatically increased at each new communication session (new request
frame).
Bit 7
Bit 6
Bit 5
Bit 4
Bit 3
Bit 2
Bit 1
Bit 0
Operation
Type
Controller
ID [6]
Controller
ID [5]
Controller
ID [4]
Controller
ID [3]
Controller
ID [2]
Controller
ID [1]
Controller
ID [0]
The “Operation Type” uses one bit with the following definition:
492
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
0
Read
data is transferred from controller
1
Write
data is transferred to controller
The “Controller ID” uses 6 bits; it represents the Node Number in the CANopen network of the master controller addressed
by the current request.
This parameter is required in case the CAN network has more than one master controller; the CANopen standard defines in
fact the COB-ID of the messages in a way that all the partners of the bus known the originator. In case more than one
master device is present in the same network, the “Controller ID” field will specify the target of each individual request
message. Only the master controller that recognizes in this field its own Node ID will consider the message and process
the PDO contents.
Response Format: Controller to Panel (Receive PDO)
The PDO message returned by the controller must be formatted as defined in the following table.
Byte 0
Byte 1
Byte Byte Byte Byte
Byte 6
2
3
4
5
Byte 7
Status Flag /
Error Code
Dummy –
Always 0
Data Data Data Data Data Length and
0
1
2
3
Job Number
Operation Type and
Controller ID
The request frame consists of the following elements:
Status Flag / Error
Code
Contains the information related to the execution of the operation type of the request;
the next table shows the coding information
Data 0 … Data 3
Contain the data information returned to the panel in response to a Read request
Data Length and Job
Number
It is the copy of the corresponding field of the request frame
Operation Type and
Controller ID
It is the copy of the corresponding field of the request frame
Status Flag / Error Code
Operation Type in the Request Frame
No Errors
Error
Read
0x01
0x81
Write
0x02
0x82
Protocol Editor Settings
Add (+) a driver in the Protocol editor and select the protocol called “CANopen HMI” from the list of available protocols.
The driver configuration dialog is shown in figure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
493
CANopen HMI
Element
Description
Panel ID
CANopen node ID assigned to the HMI
Controller CANopen Node ID assigned to the CAN controller device
ID
Baud
Rate (
kbps)
Speed of the CANopen network
Timeout
(s)
Maximum allowed time the driver will wait for a response from the PLC before reporting a
communication error
Enable
Update
Rate
Use this option to enable a wait time between two communication requests
Update
Rate (ms)
Minimum interval time between two requests; it can be useful when the bus load needs to be
properly controller and limited
494
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Description
PLC
Models
The list allows selecting the controller model you are going to connect to. The selection will
influence the data range offset per each data type according to the specific controller memory
resources
PLC
Network
The protocol allows the connection of multiple controllers to one operator panel. To set-up
multiple connections, check “PLC network” checkbox and enter the node ID per each slave you
need to access.
Connecting the HMI to CODESYS V2 Controllers
This chapter describes all the steps you have to follow in order to establish a successful connection between the HMI and
CODESYS CANopen master controller.
The PLC support program has been developed with CODESYS programming software version 2.
PLC Library Call
The server function running in the PLC program has been designed in the form of Library called “HMI_Canh”, written using
the “ST” programming language. Proper working example is available on demand.
The Function Block parameters are the following:
MasterID
CANopen Master Node number;
MinBound
Lower limit of the PLC memory addressable (visible) by the HMI
MaxBound
Upper limit of the PLC memory addressable (visible) by the HMI
HHIr
Offset in the PLC memory where the PDO message received from the panel is mapped
HMIt
Offset in the PLC memory where the PDO message to be sent to the panel is mapped
MemPt
Offset in the PLC memory where the data is received
Status
Status
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
495
CANopen HMI
The PLC Function block support the use of more than one panel simply repeating the call of the same function for all the
additional units specifying before each call the proper calling parameters.
CODESYS V2 4PDO
In some cases it is useful to choose the model “CODESYS 4 PDO” where 4 PDO objects are used for transmission and 4
for reception. This solution may provide higher communication speed between the two devices.
To operate with 4 PDO the correct model should be set in HMI project and the PDOs for receive and transmit slots.
496
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: CANopen Master PLC Configuration must be configured properly. In case of “CODESYS 4 PDO”.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Controller replies with a not acknowledge.
Timeout
Request is not replied within the specified timeout period; ensure the controller is connected and
properly configured for network access
Line
Error
Returned when an error on the communication parameter setup is detected (baud rate); ensure
the communication parameter settings of the controller is compatible with panel communication
setup
Invalid
The panel did receive from the controller a response, but its format or its contents or its length is
response not as expected; ensure the data programmed in the project are consistent with the controller
resources.
CAN
port not
found
Make sure option module is correctly plugged
CAN
port in
use
Make sure option module is not already in use
General
error
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
497
CODESYS V2 ETH
CODESYS V2 ETH
Le pilote de communication CODESYS V2 ETH pour communication de supports via une connexion Ethernet avec les
contrôleurs basés sur la version CODESYS V2.3.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse IP
Adresse IP Ethernet du contrôleur.
Port
Numéro du port utilisé par le pilote CODESYS V2 Ethernet. Par défaut, la valeur est
configurée à 1200, ce qui correspond au paramètre par défaut des contrôleurs basés sur
CODESYS.
498
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Taille de
bloc
Taille de bloc maximale prise en charge par votre contrôleur (limitée à 1 024 KB).
Délai
d'attente
(ms)
Délai d’attente entre deux tentatives d’envoi du même message en cas d'échec de
communication.
Type de
protocole
Variante du protocole à utiliser. Veuillez vérifier quelle variante du protocole est prise en
charge par l'exécution CODESYS que vous souhaitez connecter.
Adresse
source,
adresse de
destination
Disponible uniquement si l'option Route TCP/IP de niveau 2 a été sélectionné pour le
paramètre Type de protocole. La destination est le nœud de l'API qui permet au protocole de
lire les variables d'un sous-réseau. L'adresse est utilisée pour la lecture de variables lorsque
plusieurs API sont connectés à un sous-réseau (réseau en série) mais qu'un seul est doté
d'interface Ethernet.
Modèles
d'API
Deux modèles d'API sont disponibles.
Réseau
d’API
l
Intel
l
Motorola
Adresse IP de tous les contrôleurs en connexions multiples. Vous devez sélectionner la case
à cocherRéseau d’API pour permettre les connexions multiples.
À partir de la version V1.60, le pilote CODESYS V2 Ethernet prend en charge la connexion avec plusieurs contrôleurs.
Note : Le pilote CODESYS V2 Ethernet est recommandé en créant des projets pour le contrôleur interne iPLC
CODESYS. Pour utiliser le pilote CODESYS V2 Ethernet avec iPLC, configurez l'adresse IP de l'API comme
hôte local (127.0.0.1).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
499
CODESYS V2 ETH
iPLC CODESYS prend en charge la communication avec le pilote CODESYS V2 Ethernet en utilisant un support à
base de symboles à partir de la version V1.55.
Ajouter un nom d’alias à un protocole
Les noms de variables doivent être uniques au niveau d’un projet. Vous pouvez cependant être amené à utiliser les mêmes
noms de variables pour différents nœuds de contrôleur (par exemple lorsque le périphérique IHM est connecté à deux
périphériques exécutant la même application).
Lorsque vous générez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables importés pour
ce protocole.
Dans l’exemple, la connexion à un certain contrôleur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le préfixe Nœud1, les rendant ainsi uniques au niveau projet/réseau.
Note : Vous pouvez donner un nom d’alias uniquement aux variables importées. Il n’est pas nécessaire pour les
variables ajoutées manuellement dans l'éditeur de variables de porter un préfixe d’alias dans leur nom.
Vous associez la chaîne d’alias à l’importation. Une fois l’importation des variables effectuée, une modification
de la chaîne d’alias n’aura aucun effet sur les noms figurant déjà dans le dictionnaire. Lorsque vous modifiez la
chaîne d’alias et réimportez les variables, toutes les variables réimportées porteront la nouvelle chaîne de
préfixe.
Paramètres logiciels CODESYS
Lors de la création du projet sous CODESYS, sélectionnez Télécharger le fichier de symboles.
500
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Le périphérique CODESYS V2 Ethernet prend en charge le chargement automatique du fichier de
symboles (SDB) depuis l'API. Aucune modification dans le décalage de variable due à une nouvelle compilation
du côté du logiciel de l’API ne nécessite la réimportation du fichier de symboles. Le fichier de variables doit être
réimporté uniquement si vous renommez ou définissez de nouvelles variables.
Lorsque l’option Télécharger fichier symbole n’est pas disponible ou effacé, le protocole ne peut fonctionner que si la
variable ProjectID est importée. Lorsque l'offset de variable change en raison d'une nouvelle compilation de logiciel de
l'API, il est nécessaire de réimporter le fichier de symboles.
Types de données
Le module d’importation prend en charge des variables des types de données standard et définies par l’utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
501
CODESYS V2 ETH
Types de
données pris
en charge
l
BOOL
l
WORD
l
DWORD
l
INT
l
UINT
l
UDINT
l
DINT
l
STRING *
l
REAL
l
HEURE
l
DATE & HEURE
et TABLEAU à 1 dimension des types de données ci-dessus. Consultez la section « Concepts de
programmation » du manuel principal.
Note * : La longueur maximale de la chaîne d'une variable STRING dans l’API est de 80
caractères. Déclarez une variable STRING soit avec une taille spécifique (ch: STRING(35)
soit avec la taille par défaut (ch: STRING), qui est de 80 caractères.
Types de
données non
pris en charge
l
LWORD
l
LINT
l
LREAL
Conversion de variables
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions, listées ci-dessous.
502
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH -> GHEFCDAB
Échange les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
ABC...NOP -> OPM...DAB
Échange les octets d’un mot long.
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110 0001110010111011011001000101101000011100101011000001
→
1 10000011100 1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
503
CODESYS V2 ETH
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
Importation des variables
Exporter des variables depuis l’API
Lors de la configuration de l’API grâce au logiciel de configuration du fabricant, autorisez la création d’un Fichier de
symboles (extension .sym) sous le logiciel de programmation CODESYS :
504
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
1. Dans le menu Projet, cliquez sur Options.
2. Cliquez sur Configuration de symbole.
3. Sélectionnez Vider les entrées de symboles.
4. Cliquez sur OK.
Note : Cliquez ensuite sur Configurer fichier symboles… et sélectionnez Exporter variables de l'objet.
Nous recommandons de décocher la case et de la recocher ensuite pour s'assurer que les paramètres sont
corrects.
Dans certains cas, il est possible que les symboles de variables associés ou intégrés dans les modules I/O du fichier .sym
soient dupliqués. Pour supprimer les doublons, sélectionnez l'entrée « Configuration de l'API » dans la liste des objets et
décochez l'option « Exporter variables de l'objet ».
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
505
CODESYS V2 ETH
Importer des variables dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
Pilote d'importation
Description
CODESYS2 sym v1.1
Linéaire
Nécessite un fichier .sym.
CODESYS2 sym v1.1
Hiérarchique
Nécessite un fichier .sym.
CODESYS2 sym_xml
v1.0
Hiérarchique
Nécessite un fichier .sym_xml.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
506
Toutes les variables s’affichent au même niveau.
Toutes les variables s’affichent en fonction de l’affichage hiérarchique
CODESYS V2.
Toutes les variables s’affichent en fonction de l’affichage hiérarchique
CODESYS V2.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
507
CODESYS V2 ETH
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Exportation des tableaux de variables
Dans le logiciel CODESYS V2, les tableaux de variables sont divisés en éléments individuels et une variable est créée
pour chaque élément. L'exemple suivant présente un tableau avec 10 éléments.
508
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Si Exporter entrées tableau est sélectionné, une variable sera créée pour chaque élément et exportée
vers le fichier .sym. La liste de variables sera importée dans son intégralité et automatiquement dans l'éditeur de
variables.
En désactivant les entrées du tableau d'exportation, seule une variable pour chaque tableau peut être créée.
Note : Lorsque les Entrées de tableau d'exportation ont été effacées, une seul variable est créée et exportée
dans le fichier .sym. Le tableau n'est alors pas importé automatiquement vers l'éditeur de variables et il est
nécessaire de configurer les variables manuellement dans l'éditeur de variables.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
509
CODESYS V2 ETH
Tous les éléments de variables peuvent être référencés dans l'éditeur en utilisant Indexvariables dans le dialogue
Associer à variable.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge par ce pilote de communication :
Erreur
Cause et action
Fichier de symboles absent
Vérifiez Fichier de symboles et téléchargez à nouveau le
programme de l’API.
« variable » absente du fichier de symboles
Vérifiez la présence de cette variable dans le projet de
l’API.
Délai d’attente dépassé pour Confirmer
Le contrôleur n’a pas envoyé de confirmation.
Délai d’attente dépassé pour la dernière
action à Confirmer
Le contrôleur n’a pas envoyé de confirmation pour la
dernière action.
Délai d’attente dépassé pour la réception
des données
Le contrôleur ne retourne pas de données.
Délai d’attente de connexion dépassé
Le périphérique n’est pas connecté.
510
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
CODESYS V3 ETH
Le pilote de communication CODESYS V3 ETH pour communication de supports via une connexion Ethernet avec les
contrôleurs basés sur le logiciel CODESYS V3 PLC par l’entreprise 3S.
Note : Pour intégrer les évolutions du matériel et des protocoles du contrôleur, les pilotes font l'objet d'une mise à
jour continue. Veuillez vous assurer que l'application utilise le pilote le plus récent.
Note : Il est possible que le protocole ou le matériel du contrôleur ait été modifié depuis la création de cette
documentation. Cela peut perturber le fonctionnement de ce pilote. Pour cette raison, veuillez toujours tester et
vérifier le bon fonctionnement de l'application.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse
IP
Adresse IP Ethernet du contrôleur
Adresse
Dans la mesure où certaines mises en œuvre de CODESYS V3 dans le runtime nécessitent
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
511
CODESYS V3 ETH
Élément
Description
de nœud
complète
l'indication des quatre valeurs de l'adresse IP dans les trames de protocoles, ce drapeau force
le protocole à créer des adresses IP qui utilisent les quatre champs d'adresses de l'IP.
Décompte La liste de variables représente la meilleure méthode pour augmenter la performance du
liste de
protocole de communication CODESYS V3 comme elle permet de demander plusieurs
variables éléments de données lors d'une seule session de protocole.
Dans la mesure où certaines mises en œuvre de CODESYS V3 dans le runtime ne contiennent
qu'un nombre limité de listes de variables à attribuer, ce paramètre vous permet de configurer le
nombre maximal de listes de variables que le pilote de communication essayera de créer dans
l'API.
Modèle
d'API
Format d'octets qui sera utilisé par le pilote de communication en envoyant des trames de
communication à l'API.
Délai
d'attente
Temps en millisecondes entre les nouvelles tentatives en cas d'échec de communication.
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur (esclave).
Note : Veuillez consulter la documentation du contrôleur pour connaître les valeurs requises pour les paramètres
Adresse de nœud complète ou Décompte liste de variables.
Importation des variables
Exporter des variables depuis l’API
Lors de la création du projet en utilisant CODESYS V3, veillez à configurer correctement le fichier des symboles qui
contiendra les variables requises.
512
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
1. Pour ajouter une configuration de Symbole dans un projet CODESYS V3, effectuez un clic droit sur l'élément
Application dans l'arborescence du projet, puis sélectionnez Ajouter objet > Configuration de symbole dans le menu
contextuel. L'élément de configuration de symbole sera ajouté à l'arborescence du projet.
2. L'élément de configuration de symbole contient une liste de toutes les variables disponibles dans le projet
CODESYS V3, des variables individuelles ou des groupes de variables peuvent être sélectionnés dans l'élément
correspondant de la liste.
3. Une fois la configuration des symboles terminée, téléchargez le projet ou utilisez la fonction Générer code
(Construire > Générer code) pour créer un fichier .xml qui contient toutes les variables de lecture à importer dans
l'éditeur de variables.
Importer des variables dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
513
CODESYS V3 ETH
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
Pilote d'importation
Description
CODESYS3 xml v1.0
Linéaire
Nécessite un fichier .xml.
CODESYS3 xml v1.0
Hiérarchique
Nécessite un fichier .xml.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
Toutes les variables s’affichent au même niveau.
Toutes les variables s’affichent en fonction de l’affichage hiérarchique
CODESYS V3.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
514
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
515
CODESYS V3 ETH
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Ajouter un nom d’alias à un protocole
Les noms de variables doivent être uniques au niveau d’un projet. Vous pouvez cependant être amené à utiliser les mêmes
noms de variables pour différents nœuds de contrôleur (par exemple lorsque le périphérique IHM est connecté à deux
périphériques exécutant la même application).
Lorsque vous générez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables importés pour
ce protocole.
Dans l’exemple, la connexion à un certain contrôleur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le préfixe Nœud1, les rendant ainsi uniques au niveau projet/réseau.
516
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Vous pouvez donner un nom d’alias uniquement aux variables importées. Il n’est pas nécessaire pour les
variables ajoutées manuellement dans l'éditeur de variables de porter un préfixe d’alias dans leur nom.
Vous associez la chaîne d’alias à l’importation. Une fois l’importation des variables effectuée, une modification
de la chaîne d’alias n’aura aucun effet sur les noms figurant déjà dans le dictionnaire. Lorsque vous modifiez la
chaîne d’alias et réimportez les variables, toutes les variables réimportées porteront la nouvelle chaîne de
préfixe.
Types de données
Le module d’importation prend en charge des variables des types de données standard et définies par l’utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
517
CODESYS V3 ETH
Types de
données pris
en charge
l
BOOL
l
INT
l
SINT
l
UINT
l
UDINT
l
DINT
l
String
l
REAL
l
LREAL
l
BYTE
l
ULINT
l
LINT
et TABLEAU à 1 dimension des types de données ci-dessus. Consultez la section « Concepts de
programmation » du manuel principal.
Note * : La longueur maximale de la chaîne d'une variable STRING dans l’API est de 80
caractères. Déclarez une variable STRING soit avec une taille spécifique (ch: STRING(35)
soit avec la taille par défaut (ch: STRING), qui est de 80 caractères.
Types de
données non
pris en charge
l
LWORD
l
LINT
Conversion de variables
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions, listées ci-dessous.
518
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH -> GHEFCDAB
Échange les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
ABC...NOP -> OPM...DAB
Échange les octets d’un mot long.
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110 0001110010111011011001000101101000011100101011000001
→
1 10000011100 1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
519
CODESYS V3 ETH
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
520
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Ethernet/IP CIP
Ce protocole a été mis en œuvre selon les spécifications Ethernet/IP publiées (disponibles sur www.odva.org).
Le pilote Ethernet/IP CIP a été conçu pour fournir la meilleure performance tout en ralentissant le moins possible la
performance globale du système. Malgré le fait que le pilote Ethernet/IP CIP est rapide, nous recommandons d'utiliser des
noms de variables brefs. Les variables sont lues et écrites par le périphérique en indiquant leur nom symbolique dans les
requêtes de communication. Pour cette raison, un nom de variable plus long signifie un plus grand volume pour la requête.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Champ
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse
IP
Adresse IP Ethernet du contrôleur.
Logement Numéro de logement CPU pour modèles Logix 5000 (typiquement 0). Pour plus de détails,
veuillez consulter la documentation du contrôleur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
521
Ethernet/IP CIP
Champ
Description
Modèles
d'API
Modèle d'API utilisé pour importer le fichier de variables.
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur (esclave).
Modèle contrôleur Logix 5000
Le pilote Ethernet/IP CIP permet de connecter des contrôleurs Allen-Bradley ControlLogix et CompactLogix Ethernet.
Pour assurer la communication avec les contrôleurs ControlLogix® 5500, veuillez utiliser un module de communication
Ethernet/IP pour Ethernet tel que les modèles 1756-EN2T ou 1756-ENET.
La communication Ethernet avec les contrôleurs CompactLogix™ 5300 requiert un processeur à port Ethernet/IP intégré tel
que le modèle 1769-L32E.
Toutes les marques déposées sont de la propriété de leurs propriétaires respectifs
Les CPU Logix ne sont pas dotés d'une organisation de mémoire interne fixe mais la mémoire est configurée au moment du
développement par l'utilisateur. Chaque élément de données peut être identifié par une chaîne appelée « variable ». Le
logiciel RSLogix 5000 peut alors exporter sur l'application de la liste des variables créés pour chaque contrôleur.
Le projet chargé sur le périphérique IHM doit se référer aux noms de variables attribués dans le logiciel RSLogix 5000 au
moment du développement. L'éditeur de variable supporte l'importation directe du fichier de variable généré par le logiciel
RSLogix 5000 au format .csv.
La mise en œuvre du pilote Ethernet/IP prend en charge également les types de données structurées qui peuvent être
importés à partir de fichiers .L5X.
Le pilote prend en charge l'accès à la fois aux variables du contrôleur et de programme.
Exportation CSV et fichiers L5X en utilisant RSLogix5000
Pour exporter le fichier de variable .CSV :
1. Dans le volet Organisateur de contrôleur, effectuez un clic droit sur variables du contrôleur.
2. Sélectionnez Exporter variables : le dialogue Exportation s'affiche.
522
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
3. Choisir Tous depuis la liste des variables pour exporter tous les variables.
4. Sélectionner l’option Enregistrer en tant que type en .CSV.
5. Cliquer sur Export : toutes les variables sont exportées vers un fichier .CSV.
Pour exporter le fichier type de données .L5X :
1. Sélectionnez Fichier > Enregistrer sous.
2. Sélectionner l’option Enregistrer en tant que type en .L5X.
3. Cliquer sur Enregistrer : toutes les variables sont exportées vers un fichier .L5X.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
523
Ethernet/IP CIP
Importer des fichiers dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
524
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Sélectionner l’option Allen-Bradley RSLogix5000 v15.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
525
Ethernet/IP CIP
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Note : Lors de l'importation des types de données de tableau, l'importateur les étend en créant des variables
individuelles par chaque élément du tableau ; ceci est valable pour tous les types de données, sauf pour les
tableaux booléen. Dans ce cas, ils sont importés en tant que « booléen-32 » et l'élément de tableau unique
peuvent être traité en utilisant le paramètre « Tag Index » depuis la boîte de dialogue « Joindre à ... ».
Types de données définies par module et définies par l’utilisateur
RSLogix 5000 vous permet de définir des variables avec plusieurs types de données.
526
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Groupe de types de
données
Description
Prédéfinis
Types de données standard tels que BOOL, DINT, SINT, INT
et types de données moins courants tels que PID, COUNTER, TIMER.
Définis par le module
Type de données associé à des modules I/O optionnelles généralement référencés par
des alias.
Définis par l'utilisateur
Type de données personnalisé défini par l'utilisateur
Pour importer un type de données Prédéfini (sauf types de données standard qui sont toujours importés) et Défini par le
module, vous devez éditer le fichier ETIPSpecialDataTypes.xml à l'emplacement
langues\partagées\studio\importationvariables ou (en fonction de la version du logiciel) studio\importationvariables.
Dans le logiciel RSLogix5000 :
1. Dans le volet Organisateur de contrôleur, sélectionnez variables du contrôleur.
2. Variables de filtre pour afficher uniquement les variables Module-Defined.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
527
Ethernet/IP CIP
Seules les variables (alias) avec des types de données qui appartiennent à des modules I/O en option s'afficheront.
528
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Dans cet exemple, l'alias HYS_Point_IO_Rack_20:I désigne le type de données AB:1734_3SLOT:I:0. Développez cette
variable pour afficher la structure de ce type de données :
Pour garantir que HYS_Point_IO_Rack_20:I, et toutes ses sous-variables soient importées dans le projet, ouvrez le fichier
ETIPSpecialDataTypes.xml dans un éditeur de texte et vérifiez s'il contient le type de données AB:1734_3SLOT:I:0. Si
c'est le cas, vous pouvez continuer par le type de données suivant. Sinon, vous devez l'ajouter manuellement.
La structure peut se présenter, par exemple, comme suit :
où :
l
aaa = Alias/Type de données de variable
l
bbb = Nom de sous-variable (le nom de la sous-variable suit le point)
l
ccc = Type de données de la sous-variable
l
ddd = Dimension de tableau (0 s'il ne s'agit pas d'un tableau)
l
eee = Style
Dans l'exemple ci-dessus :
3. Répétez l'étape 2 pour tous les types de données Définis par module.
4. Répéter la procédure depuis l’étape 2, en filtrant les variables pour afficher uniquement les variables Prédéfinies.
Modèle contrôleur Omron Sysmac
Il est possible d'accéder aux données dans les contrôleurs NJ et CJ via le protocole CIP.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
529
Ethernet/IP CIP
Chaque élément de données peut être identifié par une chaîne appelée « variable ». Utiliser des outils de programmation
appropriés pour le contrôleur d'exportation de la liste des variables.
Les contrôleurs de la série NJ sont programmés dans Sysmac Studio :
l
NJ301-xxxx
l
NJ501-xxxx
Les contrôleurs de la série CJ sont programmés dans CX-One :
l
CJ2M CPU-3x
l
CJ2H CPU 6x-EIP
l
Tout processeur avec une unité CJ1W-EIP21 associée.
Le projet chargé sur le périphérique IHM doit se référer aux noms de variables attribués dans le logiciel de programmation
au moment du développement. L'éditeur de variable supporte l'importation directe du fichier de variable généré par le
logiciel Sysmac Studio au format .NJF ou généré par CX-One au format .CJF.
Toutes les variables qui peuvent être consultées par le périphérique IHM doivent être déclarées comme des Variables
globales.
Exportation des fichiers NJF en utilisant Sysmac Studio
Pour exporter le fichier variable .NJF :
1. Dans Sysmac Studio, déclarer les variables comme Global Variables.
2. Configurer l'attribut de Publication réseau sur Publier uniquement.
2. Dans le menu Outils, sélectionnez Exporter variables globales > CX-Designer.
530
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
3. Cliquez sur OK pour confirmer.
4. Coupez et collez les contenus du presse-papier dans un éditeur de texte.
4. Enregistrer le fichier sous .NJF.
Note : En utilisant le Bloc-notes comme éditeur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .NJF en sélectionnant « Enregistrer sous » comme « tous les fichiers » bien que le fichier sera nommé
*.njf.txt et il ne sera pas visible depuis l'importateur.
Exportation du fichier CJF en utilisant CX-One
Pour exporter le fichier variable .CJF :
1. Dans CX-One, ouvrez le fichier de symboles du projet.
2. Dans la boîte de dialogue Symbole édition, régler le Net. Variables attribuer à Publication.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
531
Ethernet/IP CIP
3. Copier et coller tous les variables dans un éditeur de texte.
4. Enregistrer le fichier sous .CJF.
Note : En utilisant le Bloc-notes comme éditeur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .CJF en sélectionnant « Enregistrer sous » comme « tous les fichiers » bien que le fichier sera nommé
*.cjf.txt et il ne sera pas visible depuis l'importateur.
Exportation des structures définies de l’utilisateur
Pour exporter le fichier variable .CJS :
532
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
1. Dans CX-One, ouvrez le fichier de types de données du projet.
2. Copier et coller tous les variables dans un éditeur de texte.
3. Enregistrer le fichier sous .CJS.
Note : En utilisant le Bloc-notes comme éditeur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .CJS en sélectionnant « Enregistrer sous » comme « tous les fichiers » bien que le fichier sera nommé
*.cjs.txt et il ne sera pas visible depuis l'importateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
533
Ethernet/IP CIP
Importer des fichiers dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
Sélectionner Omron Sysmac pour importer un fichier de variables .NJF ou Omron CX-One pour importer un fichier de
variables .CJF.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de variables et cliquez sur Ouvrir. Le système
vous demandera le fichier .CJS des structures définies par l'utilisateur. Si non requis, passez le dialogue en cliquant sur le
bouton Annuler.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
534
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
535
Ethernet/IP CIP
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Note : Lors de l'importation des types de données de tableau, l'importateur les étend en créant des variables
individuelles par chaque élément du tableau ; ceci est valable pour tous les types de données, sauf pour les
tableaux booléen. Dans ce cas, ils sont importés en tant que « booléen-32 » et l'élément de tableau unique
peuvent être traité en utilisant le paramètre « Tag Index » depuis la boîte de dialogue « Joindre à ... ».
Modèle contrôleur Micro800
Le pilote Ethernet/IP CIP constitue un moyen facile et fiable de connexion aux contrôleurs Allen-Bradley Micro800.
La portée des variables dans un contrôleur Micro800 peut être limitée à un programme local ou elle peut être globale :
But
Description
Variables locales
Variables en fonction du programme Les variables sont affectés au programme spécifique dans
le projet et disponible uniquement pour ce programme.
Ces variables ne sont pas supportées dans ce pilote.
Variables globales
Variables en fonction du contrôleur. Les variables appartiennent au contrôleur dans le projet et
sont disponibles à tout programme dans le projet.
Ces variables sont supportées dans ce pilote.
Exportation du fichier ISAXML en utilisant le Workbench de composant connecté
Pour exporter les variables globales .ISAXML y compris I/O tags :
536
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
1. Sélectionné la balise Périphérique.
2. Étend l'élément Export.
3. Sélectionner l’export du périphérique.
4. Cliquer sur l’onglet Exportation du fichier d’échange.
5. Cliquer sur le bouton Export.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
537
Ethernet/IP CIP
6. Sélectionnez un emplacement pour l'enregistrement du fichier d'exportation et cliquez sur Enregistrer.
7. Lorsque l'exportation s'est terminée avec succès, les informations de sortie s'affichent :
538
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Le fichier d'exportation est un fichier d'archives comprimé avec 7-zip. Utiliser un utilitaire zip approprié
pour extraire le contenu archive dans un dossier local.
Importer des fichiers dans l'éditeur
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
Sélectionner l’option Allen-Bradely CCW v15.
Structure du répertoire extraite de fichier 7z est quelque chose comme : “..\<folder_name>\Micro8xx\Micro8xx\”
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
539
Ethernet/IP CIP
Dans ce dernier dossier, sélectionner le fichier Micro8xx.isaxml comme montré ci-dessous :
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
540
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Ajouter un nom d’alias à un protocole
Les noms de variables doivent être uniques au niveau d’un projet. Vous pouvez cependant être amené à utiliser les mêmes
noms de variables pour différents nœuds de contrôleur (par exemple lorsque le périphérique IHM est connecté à deux
périphériques exécutant la même application).
Lorsque vous générez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables importés pour
ce protocole.
Dans l’exemple, la connexion à un certain contrôleur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le préfixe Nœud1, les rendant ainsi uniques au niveau projet/réseau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
541
Ethernet/IP CIP
Note : Vous pouvez donner un nom d’alias uniquement aux variables importées. Il n’est pas nécessaire pour les
variables ajoutées manuellement dans l'éditeur de variables de porter un préfixe d’alias dans leur nom.
Vous associez la chaîne d’alias à l’importation. Une fois l’importation des variables effectuée, une modification
de la chaîne d’alias n’aura aucun effet sur les noms figurant déjà dans le dictionnaire. Lorsque vous modifiez la
chaîne d’alias et réimportez les variables, toutes les variables réimportées porteront la nouvelle chaîne de
préfixe.
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
542
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
543
Ethernet/IP CIP
Pilote d'importation
Description
Allen-Bradley L5X v1.1
Hiérarchique
Requiert un fichier .L5X.
Vérifier le Modèle du contrôleur Logix 5000 pour plus de détails.
Toutes les variables s’affichent en fonction de l’affichage hiérarchique
RSLogix5000.
Allen-Bradley
RSLogix5000 v15
Linéaire
Requiert un fichier .CSV et des fichiers .L5X (en option).
Vérifier le Modèle du contrôleur Logix 5000 pour plus de détails.
Toutes les variables s’affichent au même niveau.
Allen-Bradley CCW v15
Linéaire
Requiert un fichier .ISAXML.
Vérifier le Modèle du contrôleur Micro800 pour plus de détails.
Toutes les variables s’affichent au même niveau.
Omron Sysmac v15
Linéaire
Requiert un fichier .NJF.
Vérifier le Modèle du contrôleur Omron Sysmac pour plus de détails.
Toutes les variables s’affichent au même niveau.
544
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Omron CX-One v15
Linéaire
Requiert un fichier .CJF et des fichiers .CJS (en option).
Vérifier le Modèle du contrôleur Omron Sysmac pour plus de détails.
Toutes les variables s’affichent au même niveau.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique
exporté de l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
545
Ethernet/IP CIP
Élément de la barre d’outils
Description
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contrôleur répond « Ne pas confirmer ».
-
Délai
d'attente
La requête n’a obtenu aucune réponse dans
le délai d’attente spécifié.
Vérifiez que le contrôleur est connecté et correctement
configuré pour accéder au réseau.
Réponse
non valide
Le contrôleur a envoyé une réponse ou un
contenu non valide au périphérique.
Vérifiez la cohérence entre les données programmées
dans le projet et les ressources du contrôleur.
Erreur
générale
Erreur non identifiable. Ne doit jamais être
signalée.
Contactez l’assistance technique.
546
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
J1939
Use this communication driver to connect HMI devices to CAN networks including devices communicating with SAE
J1939.
Please note that changes in the communication protocol specifications or J1939 hardware may have occurred since this
documentation was created. Some changes may eventually affect the functionality of this communication driver. Always
test and verify the functionality of your application. To fully support changes in J1939 hardware and communication
protocols, communication drivers are continuously updated. Always ensure that the latest version of communication driver
is used in your application.
Protocol Editor Settings
Select Add [+] in Protocol Editor and select J1939.
The driver configuration dialog is shown in figure.
Element
Description
CAN
Channel
Configure the CAN Channel.
CAN interface is available only with a proper option module.
UN31 platforms allow only one module, select Can0.
UN30 platforms allow up to two modules, select Can0 or Can1.
ISO ECU
Identifier of the equipment in the J1939 network (in case several HMI are coexisting in the
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
547
J1939
Element
Description
Instance
network)
ISO
Function
Instance
Identifier of the function in the network (in case more than one device is providing the same
functionality)
Claiming
Address
Default value of the address of the equipment used as starting value for the Address Claim
algorithm
Baud Rate Baud rate of the CAN bus (typical is 250)
(kbps)
Timeout
(ms)
Timeout for the validity of received values. After the time indicated since last reception any
value is declared “old” and its quality changed to “bad”. The value 0 disables the timeout check
Tag Editor Settings
In Tag Editor select the protocol “J1939” from the list of defined protocols and add a tag using [+] button. Tag settings can
be defined using the following dialog:
548
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Data Type
Description
Data Type
Memory Space
Limits
boolean
1 bit data
0 ... 1
byte
8-bit data
-128 ... 127
short
16-bit data
-32768 ... 32767
int
32-bit data
-2.1e9 ... 2.1e9
unsignedByte
8-bit data
0 ... 255
unsignedShort 16-bit data
0 ... 65535
unsignedInt
32-bit data
0 ... 4.2e9
float
IEEE single-precision
1.17e-38 ... 3.40e38
32-bit floating point type
string
Array of elements containing character code defined by selected
encoding
Note: to define arrays, select one of Data Type format followed by square brackets
like “byte[]”, “short[]”…
Arraysize
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments
vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conversio
n
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs
conversions, listées ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
549
J1939
Element
Description
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
550
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Description
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas
de la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Parameter
Group
Number
Parameter Group Number value
Index
Index value
Selector
Type
When adding tags it can be necessary to duplicate them to read data coming from several
devices generating same physical quantity. In this case the Address of the tag must be
edited. The Tag Editor dialog is shown in figure:
In case of duplication of the tag, the selection of incoming data can be done using one of
following methods:
NONE
Selector Type not selected
INSTANCE uses a defined bitfield value in data of PGN to distinguish between
the possible sources. The value of received bitfield is compared
with parameter “Vehicle System / Instance” for matching
DEVICE
uses the source address to find out the device sending the PGN
based on Address Claim algorithm. The devices are selected based
on parameter “ISO function”
ADDRESS
uses directly the source address as it is to select the source. The
received source address is compared with parameter “ISO Ecu –
Function Instance”
ISO EcuFunction
Instance
Instance of ISO Ecu-Function checked with Selector Type “DEVICE”
ISO
Function
ISO Function parameter
Vehicle
System/Ins
tance
Vehicle System / Instance parameter used with Selector Type “INSTANCE”
J1939 PGN Definition File
J1939 can connect hundreds of different devices offering access to thousands of different physical values. The standard
defines several hundred PGNs for various applications. However, many devices use manufacturer-specific PGN
definitions.
In order to manage this complex application scenario, the J1939 driver loads the PGN definition table at startup from a
configuration file. The file with the PGN definition table is “J1939_pgnTable.csv” located in the folder “target\protocols\”; it is
loaded automatically from disk when downloading the project.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
551
J1939
The file containing the PGN defined by the standard protocol specification is placed in the proper folder when the driver is
installed. It can be edited adding or removing PGN definitions. The user must respect the following rules:
l
l
the file contains most of the PGN defined by the standard. Custom PGN and SPN can be added assigning free
indexes.
description of a PGN is composed by a PGN declaration line followed by a list of Field description lines
PGN declaration line
PGN: Name, PGN number, DefaultPriority, DefaultRate, InstanceIndex, Direction [, PGN
request rate]
Name
Name of the PGN
PGN number
Number code of PGN
DefaultPriority
Transmission priority (output PGN)
DefaultRate
Transmission rate (output PGN)
Instance Index
Index of instance (output PGN)
Direction
INPUT/OUTPUT
PGN request
rate
Optional parameter. Time in milliseconds. If PGN not received in the meanwhile, it is
requested
Example of PGN declaration:
PGN: Torque/Speed Control 1, 0, 3, 100, 0, INPUT
// Torque/Speed Control 1 id PGN nr.0, its default priority is 3 and default transmission rate is 100 ms. Instance Index is 0
and direction is INPUT
Field declaration line
FieldIndex, FieldName, FieldPosition, FieldBitSize, SPN Conversion, AccessType,
FieldDataType
FieldIndex
Index of field in the PGN
FieldName
Name of the field
FieldPosition
N (1 to 8) byte position
N.M (1.1 to 8.8) bit position
N-M (N from 1 to 7, M from 2 to 8) byte range
FieldBitSize
1-64
number of bits of the field
SPN
Conversion
SPN conversion is indicated by "SPN"index es. SPN79
AccessType
Defines usage of field in combination with PGN direction.
552
SPN0 indicates a raw copy of data
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
If PGN direction is declared as OUTPUT, the fields can be only used for write operations.
If PGN direction is declared as INPUT the fields can always be read. In case they are
written the behavior is described below.
PGN
Access
Direction Type
OUTPUT
Behavior
WRITE
the PGN is sent immediately with current value of the
fields
READ_
ONLY
the PGN is sent as soon as all the fields are written with
a fresh value
REPLY
INPUT
READ_
ONLY
Error
REPLY
the PGN is sent only if it was received almost once, with
update value of the written field
WRITE
the PGN is sent immediately with current value of the
fields
FieldDataType Boolean
boolean-nn
byte
unsignedByte
short
unsignedShort
int
unsignedInt
float
double
string-nn
Example of Field declaration:
1, Engine Override Control Mode, 1.1, 2, SPN0, READ_ONLY, unsignedByte
SPN declaration line
SPN: index, constK, constL, type [,bigEndian]
index
index of SPN
constK
SPN conversion parameters
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
553
J1939
constL
the conversion applied when reading is:
var(type) = raw value * constK + constL
the conversion applied when writing is:
raw value = (var(type) - constL) / constK
type
bits
char
uchar
short
ushort
int
uint
float
double
longlong
ulonglong
float80
bigEndian Optional parameter. Defines if endianity conversion is needed on raw data before applying the
SPN conversion.
0 default endianity, do not change
1 apply endianity transformation
Example of SPN declaration:
SPN:, 79, 0.03125, -273, short, 1
Tag Import
The J1939 driver can import tag information from any CSV file, following same rules of PGN definition file and maintain
several dictionaries for different scenarios.
The user can also import the whole “J1939_pgnTable.csv” and use only one large dictionary.
In the Tag Editor select the driver and click on the “Import tag” button to start the importer
then locate the “.csv” file and confirm.
554
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
The tags resulting from the import process may be used as they are if there is only one source for such value in the
network. When several sources are supplying the same value the associated tags must be duplicated and named using
one of the addressing methods shown in the Tag Editor chapter.
Communication Diagnostic
The error types supported for this communication driver are:
Error Class
Error
Configuration Errors
invalid CAN channel
Notes
cannot read MACID
Unable to access the PGN Table
Unable to get the PGN file path
SPN conversion not supported
Sending PGN with dynamic field length not supported
Preparing PGN field for sending failed
Writing a read-only tag
The output PGN can't be read
invalid offset in PGN
Not byte boundary on dynamic field
Something wrong with the PGN data block size
Too many bits to use
Not byte boundary on dynamic field
SPN conversion not supported
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
555
J1939
Error Class
Error
Notes
Runtime Errors
Communication Failure > Can't send the APL PGN message
Not Connected > The PGN for the command reply has not been received yet
Not Connected > PGN block not registered
Not Connected > the value never received
Timeout Error > timeout on the value refresh
Tag Definition Errors
there must be 7 tag specification fields
PGN field missing
SPN definition not found in the table
index field missing
ecuFunctionInstance field missing
function field missing
classOrInstance field missing
icomType field missing
Can't access protocol common parameters
Can't access protocol node parameters
Can't access model
Can't access memory type
strError.c_str()
not allowed icom type
invalid natural data type for this memory type
invalid field 'selector type'
PGN definition not found in the table
The field not found in this PGN
556
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Modbus RTU
Vous pouvez connecter les panneaux opérateurs à un réseau Modbus qui fera office de réseau maître du pilote de
communication.
Détails de mise en œuvre
La mise en œuvre du Modbus RTU prend seulement en charge un sous-ensemble des codes fonction du Modbus RTU
standard.
Code Fonction
Description
01
Lecture de l’état de la bobine
Lecture de bits multiples dans la bobine du périphérique
02
Lecture de l’état d’entrée
Lecture de l’état « MARCHE/ARRÊT » des entrées TOR (référence 1x) de
l'esclave
03
Lecture des registres
d’exploitation
Lecture de registres multiples
04
Lecture des registres d’entrée
Lecture du contenu binaire des registres d’entrée (référence 3x) de l’esclave
05
Forcer bobine seule
Force une bobine unique à passer en état « MARCHE » ou « ARRÊT »
06
Prédéfinir registre seul
Prédéfinit une valeur dans un registre
16
Prédéfinir registres multiples
Prédéfinit une valeur dans des registres multiples
Note : La vitesse de communication maximale avec les contrôleurs s’élève à 115 200 bauds.
Note : Le format de données en virgule flottante est conforme à la norme IEEE.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
557
Modbus RTU
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
ID de nœud
Nœud Modbus du périphérique esclave.
Délai
d'attente (ms)
Délai d’attente (en millisecondes) entre deux tentatives en cas d’absence de réponse du
périphérique esclave.
Retard (ms)
Retard en millisecondes entre la fin de la dernière trame reçue et le début d’une nouvelle
requête. S'il est à 0, le système interne envoie une nouvelle requête dès qu’il est capable de
la programmer.
Nombre de
répétitions
Nombre d’envois d'un certain message au contrôleur avant l’envoi d’un rapport d’erreur de
communication.
Lorsque ce nombre est configuré sur 1, le panneau envoie un rapport d’erreur de
communication si la réponse au paquet de la première requête est incorrecte.
558
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Bloc lecture
max
Longueur maximale en octets d'une requête de bloc de données. Cette valeur s'applique
uniquement à l'accès en lecture aux Registres d'exploitation.
Bloc de bits
lecture max
Longueur maximale en bits d'une requête de bloc de données. Cette valeur s'applique
uniquement à l'accès en lecture aux bits d'entrée et aux bobines de sortie.
Écriture du
Fonction Modbus pour les opérations d'écriture dans les registres d'exploitation. Veuillez
registre
choisir entre la fonction 06 (Prédéfinir registre seul) et la fonction 16 (Prédéfinir registres
d’exploitation multiples).
Si la fonction 06 est sélectionnée, le protocole utilisera toujours la fonction 06 pour l'écriture
dans le contrôleur, même en écrivant dans plusieurs registres consécutifs.
Si la fonction 16 est sélectionnée, le protocole utilisera toujours la fonction 16 pour l'écriture
dans le contrôleur, même pour une requête d'écriture dans un registre seul, et le paramètre
Taille max bloc lecture de la requête est configurée sur 2. L'utilisation de la fonction 16
peut augmenter la performance de la communication.
Écrire
bobines
Fonction Modbus pour les opérations d'écriture dans les bobines de sortie. Veuillez choisir
entre la fonction 05 (Écrire bobine seule) et la fonction 15 (Écrire bobines multiples).
Si la fonction Modbus 05 est sélectionnée, le protocole utilisera toujours la fonction 05 pour
l'écriture dans le contrôleur, même en écrivant dans plusieurs bobines consécutives.
Si la fonction Modbus 15 est sélectionnée, le protocole utilisera toujours la fonction 15 pour
l'écriture dans le contrôleur, même pour une requête d'écriture dans une bobine seule.
L'utilisation de la fonction 15 peut augmenter la performance de la communication.
Mode de
transmission
l
RTU : utilise le mode RTU
l
ASCII : utilise le mode ASCII
Note : Lorsque le réseau API est actif, tous les nœuds sont configurés sur le
même mode de transmission.
Modèles
d'API
Permet de choisir entre les différentes modèles d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en Œuvre modbus où toutes les ressources
commencent avec décalage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus où toutes les ressources
commencent avec décalage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone
de mémoire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone
de mémoire des registres 32 bites.
Note : La plage d’adresses utilisée dans les trames Modbus s'étend toujours de
0 à 65535 pour les registres d’exploitation et de 0 à 65535 pour les bobines.
Comm...
En cliquant dessus, vous affichez la boîte de dialogue de configuration des paramètres de
communication.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
559
Modbus RTU
Élément
Description
Élément
Paramètre
Port
Sélection du port série.
l
l
l
COM1 : Port On-board
COM2 : Module Plug-in
en option branché sur la
slot#1 ou slot#2
COM3 : Module Plug-in
en option branché sur la
slot#3 ou slot#4
Débit en bauds, parité, bits de données, bits
d’arrêt
Paramètres de ligne série.
Mode
Mode de port série. Modes
disponibles :
l
RS-232.
l
RS-485 (2 fils).
l
RS-422 (4 fils).
Réseau d’API Il est possible de connecter plusieurs contrôleurs à un périphérique IHM. Pour configurer
plusieurs connexions, sélectionnez Réseau d'API et cliquez sur Ajouter pour configurer
chaque esclave
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne apparaît.
2. Sélectionnez Modbus RTU dans la liste des protocoles : le dialogue de définition de variables s'affiche.
560
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
561
Modbus RTU
Élément Description
Type de
mémoir
e
Ressource de Modbus où se situe la variable.
Type de mémoire
Description
État de la bobine
Bobines
État d’entrée
Entrée discrète
Registres d'entrée
Registres d'entrée
Registres d’exploitation
Registres d’exploitation
Registres à 32 bits
Zone de mémoire des registres à 32 bits.
Disponible uniquement pour les modèles d’API Enron
Modbus.
ID d'écrasement de nœud
Mode Modicon
paramètre de protocole (voir Types de données spéciaux
pour plus d'informations concernant ce mode)
Débit en bauds série
Parité série
Bits d’arrêt série
Mode série
Série terminée
Offset
Adresse d’offset où se situe la variable.
Les adresses de décalage sont six chiffres composés par un préfixe de type de données à un
chiffre+ une adresse de ressource à cinq chiffres.
562
Generic
Modbus
Gamme
Offset
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
État de la bobine
0 – 65535
0 – 65535
1–
65535
État d’entrée
100000 – 165535
0 – 65535
1–
65535
Registres d'entrée
300000 – 365535
0 – 65535
1–
65535
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Sousin
dex
Type de
donnée
s
Generic
Modbus
Gamme
Offset
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres à 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la sélection de l'offset de ressource pour le registre.
Type de données
Espace mémoire
Limites
boolean
Donnée à 1 bite
0 ... 1
octet
Donnée à 8 bite
-128 ... 127
short
Donnée à 16 bite
-32768 ... 32767
int
Donnée à 32 bite
-2.1e9 ... 2.1e9
int64
Donnée à 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donnée à 8 bite
0 ... 255
unsignedShort
Donnée à 16 bite
0 ... 65535
unsignedInt
Donnée à 32 bite
0 ... 4.2e9
uint64
Donnée à 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
précision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
précision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des éléments contenant du code de caractères défini
par l'encodage sélectionné
binary
Données binaires arbitraires
Remarque : pour définir des tableaux, sélectionnez l’un des formats de type de
données suivi de crochets tels que « byte[] », « short[] », etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
563
Modbus RTU
Élément Description
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
GHEFCDAB
564
Échange les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
855441236 → 1426062386 (format décimal)
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
ID d'écrasement de nœud
Le protocole propose un type de données spécial ID d’écrasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de mémoire correspond à un octet non signé.
L’ID d'écrasement de nœud est initialisé avec la valeur de l’ID de nœud spécifiée dans le projet au moment de la
programmation.
ID d'écrasement
de nœud
Opération Modbus
0
La communication avec le contrôleur est coupée. En cas d’opération d'écriture, la requête sera
transmise sans attente de réponse.
1 à 254
Interprété comme étant la valeur du nouvel ID de nœud et remplacé pour l’opération de runtime.
255
La communication avec le contrôleur est coupée, aucun message de requête ne sera généré.
Note : Le maintien de la valeur de l’ID d'écrasement de nœud assignée au moment du runtime est assuré par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
565
Modbus RTU
Mode Modicon
Ce protocole fournit un type de données spécial qui permet d'écraser les paramètres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus générique (base 0). Les index de registre partent de 0.
1
Modbus Modicon (base 1). Les index de registre partent de 1.
Note : La valeur des paramètres de mode Modicon assignée dans le runtime est conservée à travers les cycles
d’alimentation.
566
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Écrasement des paramètres série
Ce protocole fournit des types de données spéciaux qui permettent d'écraser les paramètres série dans le runtime.
Paramètre
Description
Débit en bauds
série
valeur 32 bits sans signature pour l'écrasement des débits en bauds. Les valeurs possibles sont
150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
Parité série
valeur 8 bits sans signature pour l'écrasement des parités. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
Valeur
Description
0
aucune parité
1
parité paire
2
parité impaire
Bits d’arrêt série
valeur 8 bits sans signature pour l'arrêt de l'écrasement de bits. Les valeurs possibles sont 1 ou 2.
Mode série
valeur 8 bits sans signature pour l'écrasement du mode série. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
567
Modbus RTU
Paramètre
Série terminée
Description
Valeur
Description
0
Mode RS-232
1
Mode RS-485
2
Mode RS-422
Configurez sur 1 pour écraser les paramètres de ligne de communication. Les paramètres sont
traités ensemble uniquement lorsque vous configurez cette variable sur la valeur 1.
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
568
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Modbus générique csv
v1.0
Linéaire
Nécessite un fichier .csv.
DELTA PLC csv v1.0
Nécessite un fichier .csv.
Toutes les variables s’affichent au même niveau.
Toutes les variables s’affichent au même niveau.
Schneider Unity v1.0
Linear
Requiert un fichier .uny.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
Le fichier contenant des symboles doit être exporté au format .txt et plus tard
rebaptisé .uny. Le pilote d'importation considère uniquement les variables
situées à l'adresse fixe et ne tient pas compte des tableaux de chaînes. Tous
les autres tableaux, sauf pour le type booléen, sont développés.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
569
Modbus RTU
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
570
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Structure de fichier csv Modbus Generic
Ce protocole prend en charge l’importation des informations de variable lorsque vous les lui fournissez au format .csv,
conformément au format suivant :
NodeID, TagName, MemoryType, Address, DataFormat,...,[Comment]
Note : Les champs entre crochets ainsi que les champs entre DataFormat et Comment sont facultatifs.
Champ
Description
IDNœud
Nœud auquel appartient la variable
Nomvariable
Description de la variable
TypeMémoire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonnées Type de données dans la notation interne. Consultez la section « Concepts de
programmation » du manuel principal.
Commentaire
Description supplémentaire facultative.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
571
Modbus RTU
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne possède pas de champ « Commentaire ». Lorsque ce champ est manquant, le caractère de
fin de ligne doit être une virgule.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
Pas de réponse
Pas de retour dans le délai d'attente
configuré.
Vérifiez que le contrôleur est connecté et
correctement configuré pour accéder au
réseau.
La réponse contient une
adresse de nœud
incorrecte
Le contrôleur a envoyé une réponse contenant une adresse de nœud non valide au
périphérique.
Le message reçu est
trop court
Le contrôleur a envoyé une réponse dans un
format non valide au périphérique.
-
Écriture incorrecte
confirmation des
données
Le contrôleur a refusé une demande
d'écriture.
Vérifiez la cohérence entre les données de
projet et les ressources du contrôleur.
572
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Modbus RTU Server
Le pilote de communication Modbus RTU Server permet de connecter le périphérique IHM en tant qu'esclave à un réseau
Modbus RTU. L'échange d'informations utilise les messages de Modbus standard.
Cette approche permet de connecter des périphériques IHM à des systèmes SCADA à travers le protocole de
communication Modbus RTU pris en charge de manière universelle.
Principe de l'opération
Le pilote de communication met en œuvre un groupe serveur Modbus RTU esclave sur le périphérique IHM. Il prend en
charge un sous-ensemble de la gamme complète des codes de fonctions Modbus. Les codes de fonction disponibles
permettent le transfert de données entre le maître et l'esclave.
Le diagramme suivant représente l'architecture de système.
Le périphérique IHM simule en fait l'interface de communication d'un API : Les types de données des bobines et des
registres sont booléennes voire à 16 bits entiers.
Le périphérique peut à tout moment accéder aux données enregistrées dans sa mémoire interne. Le transfert de données
de et vers le Modbus maître est possible uniquement sur l'initiative du maître même.
Détails de mise en œuvre
La mise en œuvre du Modbus RTU esclave prend seulement en charge un sous-ensemble des codes fonction Modbus
standard.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
573
Modbus RTU Server
Code Fonction
Description
01
Lecture de l’état de la bobine
Lecture de bits multiples dans la bobine du périphérique.
03
Lecture des registres
d’exploitation
Lecture de registres multiples du périphérique.
05
Forcer bobine seule
Force une bobine unique du périphérique à passer en état
« MARCHE » ou « ARRÊT ».
06
Prédéfinir registre seul
Prédéfinit une valeur dans un registre du périphérique.
08
Test de diagnostic de
rebouclage
Seule la sous-fonction 00 (Retour des données de requête) est
prise en charge.
15
Forcer plusieurs bobines
Force plusieurs bobines du périphérique à passer en état
« MARCHE » ou « ARRÊT ».
16
Prédéfinir registres multiples
Prédéfinit une valeur dans plusieurs registres du périphérique.
17
Rapport d'ID esclave
Retourne des informations de diagnostic du contrôleur sur l'adresse
esclave.
23
Lecture/écriture de plusieurs
registres
Lit et prédéfinit une valeur dans plusieurs registres du périphérique
Codes d'exception
Code
Description
01
Fonction interdite. le code de fonction de la requête n'est pas pris en charge
02
Adresse de données interdite. L'adresse de données reçue au cours de la requête dépasse la
plage de données prédéfinie (ouvrez Définition de variable pour afficher les détails des plages
pour tous les types).
03
Valeur de données interdite. Une sous-fonction autre que 00 est spécifiée dans le Test de
diagnostic de rebouclage (code 08).
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
574
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
ID
Modbus
ID de nœud Modbus. Chaque périphérique de serveur Modbus du réseau doit avoir sa propre ID
Modbus.
Registre
s Enron
32 bit
Si sélectionné, il permet de définir la première adresse de registre et le nombre de registres pour
la zone de mémoire des registres à 32 bit.
Note : Les registres à 32 bit sont disponibles uniquement pour les modèles d’API
Enron Modbus.
Définition de la zone de mémoire des registres à 32 bits.
Comme
ncer reg
32bits
La valeur Commencer correspond à la première adresse de registre.
La valeur Taille correspond au nombre de registres.
Note : La réponse à une requête à l'un des registres de cette zone sera à 4 octets.
Taille
reg
32bits
Modèles
d'API
Permet de choisir entre les différentes modèles d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en œuvre modbus où toutes les ressources
commencent avec décalage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus où toutes les ressources
commencent avec décalage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone de
mémoire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de
mémoire des registres 32 bites.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
575
Modbus RTU Server
Élément
Description
Note : La plage d’adresses utilisée dans les trames Modbus s'étend toujours de 0 à
65535 pour les registres d’exploitation et de 0 à 65535 pour les bobines.
Com
m...
En cliquant dessus, vous affichez la boîte de dialogue de configuration des paramètres de
communication.
Veuillez configurer les paramètres selon les valeurs programmées dans le maître Modbus.
Élément
Description
UART
Sélection du port série.
l
l
l
COM1 : Port On-board
COM2 : Module Plug-in en option branché sur
la slot#1 ou slot#2
COM3 : Module Plug-in en option branché sur
la slot#3 ou slot#4
Débit en bauds, parité, bits
de données, bits d’arrêt
Paramètres de ligne série.
Mode
Mode de port série. Options disponibles :
l
RS-232
l
RS-485 (2 fils)
l
RS-422 (4 fils)
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
576
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne apparaît.
2. Sélectionnez Modbus RTU Server dans la liste des protocoles : le dialogue de définition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
577
Modbus RTU Server
Élément Description
Type de
mémoir
e
Ressource de Modbus où se situe la variable.
Type de mémoire
Ressource Modbus
État de la bobine
Bobines
État d’entrée
Entrée discrète
Registres d'entrée
Registres d'entrée
Registres d’exploitation
Registres d’exploitation
Registres à 32 bits
Zone de mémoire des registres à 32 bits.
Disponible uniquement pour les modèles d’API Enron
Modbus.
ID d'écrasement de nœud
Mode Modicon
paramètre de protocole (voir Types de données spéciaux
pour plus d'informations concernant ce mode)
Débit en bauds série
Parité série
Bits d’arrêt série
Mode série
Série terminée
Offset
Adresse d’offset où se situe la variable.
Les adresses de décalage sont six chiffres composés par un préfixe de type de données à un
chiffre+ une adresse de ressource à cinq chiffres.
578
Generic
Modbus
Gamme
Offset
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
État de la bobine
0 – 65535
0 – 65535
1–
65535
État d’entrée
100000 – 165535
0 – 65535
1–
65535
Registres d'entrée
300000 – 365535
0 – 65535
1–
65535
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Sousin
dex
Type de
donnée
s
Generic
Modbus
Gamme
Offset
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres à 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la sélection de l'offset de ressource pour le registre.
Type de données
Espace mémoire
Limites
boolean
Donnée à 1 bite
0 ... 1
octet
Donnée à 8 bite
-128 ... 127
short
Donnée à 16 bite
-32768 ... 32767
int
Donnée à 32 bite
-2.1e9 ... 2.1e9
int64
Donnée à 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donnée à 8 bite
0 ... 255
unsignedShort
Donnée à 16 bite
0 ... 65535
unsignedInt
Donnée à 32 bite
0 ... 4.2e9
uint64
Donnée à 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
précision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
précision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des éléments contenant du code de caractères défini
par l'encodage sélectionné
binary
Données binaires arbitraires
Remarque : pour définir des tableaux, sélectionnez l’un des formats de type de
données suivi de crochets tels que « byte[] », « short[] », etc.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
579
Modbus RTU Server
Élément Description
Taille
de
tableau
Lors de la configuration du tableau ou des variables de chaîne, cette option définit la quantité
d'éléments de réseau ou des caractères de la chaîne.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
GHEFCDAB
580
Échange les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
ID d'écrasement de nœud
Le protocole propose un type de données spécial ID d’écrasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de mémoire correspond à un octet non signé.
L’ID d'écrasement de nœud est initialisé avec la valeur de l’ID de nœud spécifiée dans le projet au moment de la
programmation.
ID d'écrasement
de nœud
Opération Modbus
0
La communication avec l’esclave est coupée. En cas d’opération d'écriture, le périphérique ne
répondra pas aux trames de requête.
1 à 255
Interprété comme étant la valeur du nouvel ID de nœud et remplacé pour l’opération de runtime.
Note : Le maintien de la valeur de l’ID d'écrasement de nœud assignée au moment du runtime est assuré par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
581
Modbus RTU Server
Mode Modicon
Ce protocole fournit un type de données spécial qui permet d'écraser les paramètres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus générique (base 0). Les index de registre partent de 0.
1
Modbus Modicon (base 1). Les index de registre partent de 1.
Note : La valeur des paramètres de mode Modicon assignée dans le runtime est conservée à travers les cycles
d’alimentation.
582
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Écrasement des paramètres série
Ce protocole fournit des types de données spéciaux qui permettent d'écraser les paramètres série dans le runtime.
Paramètre
Description
Débit en bauds
série
valeur 32 bits sans signature pour l'écrasement des débits en bauds. Les valeurs possibles sont
150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
Parité série
valeur 8 bits sans signature pour l'écrasement des parités. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
Valeur
Description
0
aucune parité
1
parité paire
2
parité impaire
Bits d’arrêt série
valeur 8 bits sans signature pour l'arrêt de l'écrasement de bits. Les valeurs possibles sont 1 ou 2.
Mode série
valeur 8 bits sans signature pour l'écrasement du mode série. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
583
Modbus RTU Server
Paramètre
Série terminée
Description
Valeur
Description
0
Mode RS-232
1
Mode RS-485
2
Mode RS-422
Configurez sur 1 pour écraser les paramètres de ligne de communication. Les paramètres sont
traités ensemble uniquement lorsque vous configurez cette variable sur la valeur 1.
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
584
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Modbus générique csv
v1.0
Linéaire
Nécessite un fichier .csv.
Fichier .xml exporté
de l'éditeur de
variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
Toutes les variables s’affichent au même niveau.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
585
Modbus RTU Server
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
586
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Structure de fichier csv Modbus Generic
Ce protocole prend en charge l’importation des informations de variable lorsque vous les lui fournissez au format .csv,
conformément au format suivant :
NodeID, TagName, MemoryType, Address, DataFormat,...,[Comment]
Note : Les champs entre crochets ainsi que les champs entre DataFormat et Comment sont facultatifs.
Champ
Description
IDNœud
Nœud auquel appartient la variable
Nomvariable
Description de la variable
TypeMémoire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonnées Type de données dans la notation interne. Consultez la section « Concepts de
programmation » du manuel principal.
Commentaire
Description supplémentaire facultative.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
587
Modbus RTU Server
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne possède pas de champ « Commentaire ». Lorsque ce champ est manquant, le caractère de
fin de ligne doit être une virgule.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Ce protocole de communication remplit
une fonction de serveur et ne renvoie pas de message d'erreur de protocole spécifique.
Voir la section « Variables système » du manuel principal.
588
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
TCP Modbus
Il est possible de connecter divers périphériques compatibles TCP Modbus à des périphériques IHM. Pour configurer votre
périphérique TCP Modbus, consultez la documentation reçue avec ce périphérique.
La mise en œuvre du protocole s’effectue uniquement sous forme de client TCP Modbus.
Détails de mise en œuvre
Cette mise en œuvre du TCP Modbus prend seulement en charge un sous-ensemble des codes fonction Modbus TCP
standard.
Code Fonction
Description
01
Lecture de l’état de la
bobine
Lecture de bits multiples dans la bobine de l'IHM.
02
Lecture de l’état d’entrée
Lecture de l’état « MARCHE/ARRÊT » des entrées TOR (référence 1x)
de l'esclave.
03
Lecture des registres
d’exploitation
Lecture de plusieurs registres.
04
Lecture des registres
d’entrée
Lecture du contenu binaire des registres d’entrée (référence 3x) de
l’esclave.
05
Forcer bobine seule
Force une bobine unique à passer en état « MARCHE » ou « ARRÊT ».
06
Prédéfinir registre seul
Écriture d'une valeur dans un registre.
15
Écrire plusieurs bobines
Écriture de l'état « MARCHE » ou « ARRÊT » pour chaque bobine
d'une séquence de bobines.
16
Prédéfinir registres
multiples
Écriture de valeurs dans un bloc de registres dans une séquence.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
589
TCP Modbus
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse IP
Adresse du contrôleur.
Port
Numéro du port utilisé par le pilote Modbus TCP. La valeur par défaut est 502. Vous pouvez
la changer lorsque la communication se fait par des routeurs ou des passerelles Internet où
que le numéro de port par défaut est déjà utilisé.
utiliser
UDP/IP
Si cette option a été sélectionnée, le protocole utilisera des datagrammes UDP sans
connexion.
RTU
encapsulé
Si cette option a été sélectionnée, le protocole utilisera de préférence le protocole RTU en
série via Ethernet au lieu du protocole Modbus TCP, indépendamment du fait si TCP ou
UDP est utilisé.
590
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Délai
d'attente
(ms)
Délai d’attente (en millisecondes) entre deux tentatives en cas d’absence de réponse du
périphérique esclave.
ID Modbus
Généralement utilisé en cas de communication par passerelles Ethernet vers série, puis
interprété comme l’ID esclave. Sa valeur est simplement copiée dans le champ
Identificateur d’unité de la trame de communication du Modbus TCP. Il est rarement utilisé,
vous pouvez le laisser à zéro dans la plupart des cas.
Bloc lecture
max
Longueur maximale en octets d'une requête de bloc de données. Cette valeur s'applique
uniquement à l'accès en lecture aux Registres d'exploitation.
Bloc de bits
lecture max
Longueur maximale en bits d'une requête de bloc de données. Cette valeur s'applique
uniquement à l'accès en lecture aux bits d'entrée et aux bobines de sortie.
Écriture du
registre
d’exploitati
on
Fonction Modbus pour les opérations d'écriture dans les registres d'exploitation. Veuillez
choisir entre la fonction 06 (Prédéfinir registre seul) et la fonction 16 (Prédéfinir registres
multiples).
Si 06 est sélectionnée, le protocole utilisera toujours la fonction 06 pour l'écriture dans le
contrôleur, même en écrivant dans plusieurs registres consécutifs.
Si 16 est sélectionnée, le protocole utilisera toujours la fonction 16 pour l'écriture dans le
contrôleur, même pour une requête d'écriture dans un registre seul, et le paramètre Taille
max bloc lecture de la requête est configuré sur 2. L'utilisation de la fonction 16 peut
augmenter la performance de la communication.
Si Auto est sélectionné, le protocole utilisera la fonction 06 ou la fonction 16 en fonction du
nombre de registres à écrire.
Écrire
bobines
Fonction Modbus pour les opérations d'écriture dans les bobines de sortie. Veuillez choisir
entre la fonction 05 (Écrire bobine seule) et la fonction 15 (Écrire bobines multiples).
Si la fonction Modbus 05 est sélectionnée, le protocole utilisera toujours la fonction 05 pour
l'écriture dans le contrôleur, même en écrivant dans plusieurs bobines consécutives.
Si la fonction Modbus 15 est sélectionnée, le protocole utilisera toujours la fonction 15 pour
l'écriture dans le contrôleur, même pour une requête d'écriture dans une bobine seule.
L'utilisation de la fonction 15 peut augmenter la performance de la communication.
Modèles
d'API
Permet de choisir entre les différentes modèles d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en Œuvre modbus où toutes les ressources
commencent avec décalage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus où toutes les ressources
commencent avec décalage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone
de mémoire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de
mémoire des registres 32 bites.
Note : La plage d’adresses utilisée dans les trames Modbus s'étend toujours de 0
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
591
TCP Modbus
Élément
Description
à 65535 pour les registres d’exploitation et de 0 à 65535 pour les bobines.
Réseau
d’API
592
Adresse IP de tous les contrôleurs en connexions multiples. Vous devez sélectionner
Réseau d’API pour permettre les connexions multiples.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne apparaît.
2. Sélectionnez Modbus TCP dans la liste Pilote : le dialogue de définition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
593
TCP Modbus
Élément
Description
Type de
mémoire
Ressource de Modbus où se situe la variable.
Type de mémoire
Ressource Modbus
État de la bobine
Bobines
État d’entrée
Entrée discrète
Registres d'entrée
Registres d'entrée
Registres
d’exploitation
Registres d’exploitation
Registres à 32 bits
Zone de mémoire des registres à 32 bits.
Disponible uniquement pour les modèles d’API Enron Modbus.
IP d'écrasement de
nœud
paramètre de protocole (voir Types de données spéciaux pour plus
d'informations concernant ce mode)
Port d'écrasement de
nœud
ID d'écrasement de
nœud
Mode Modicon
Offset
Adresse d’offset où se situe la variable.
Les adresses de décalage sont six chiffres composés par un préfixe de type de données à un chiffre+ une
adresse de ressource à cinq chiffres.
Sousind
ex
594
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
Generic Modbus
Gamme Offset
État de la bobine
0 – 65535
0 – 65535
1 – 65535
État d’entrée
100000 – 165535
0 – 65535
1 – 65535
Registres d'entrée
300000 – 365535
0 – 65535
1 – 65535
Registres d’exploitation
400000 – 465535
0 – 65535
1 – 65535
Registres à 32 bits
0 – 65535
0 – 65535
1 – 65535
Permet la sélection de l'offset de ressource pour le registre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Type de
données
Description
Type de données
Espace mémoire
Limites
boolean
Donnée à 1 bite
0 ... 1
octet
Donnée à 8 bite
-128 ... 127
short
Donnée à 16 bite
-32768 ... 32767
int
Donnée à 32 bite
-2.1e9 ... 2.1e9
int64
Donnée à 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donnée à 8 bite
0 ... 255
unsignedShort
Donnée à 16 bite
0 ... 65535
unsignedInt
Donnée à 32 bite
0 ... 4.2e9
uint64
Donnée à 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
précision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
précision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des éléments contenant du code de caractères défini par
l'encodage sélectionné
binary
Données binaires arbitraires
Remarque : pour définir des tableaux, sélectionnez l’un des formats de type de données suivi de
crochets tels que « byte[] », « short[] », etc.
Taille de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets disponible pour
la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété Encoding est
réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un caractère
nécessite 2 octets.
Conversi
on
Conversion à appliquer à la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
595
TCP Modbus
Élément
Description
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions, listées cidessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
596
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche dans la liste
Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste
Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
597
TCP Modbus
Port d'écrasement de nœud
Le protocole propose le type de données spécial port d’écrasement de nœud, qui vous permet de modifier le port réseau du
contrôleur cible au moment du runtime.
Ce type de mémoire correspond à un short non signé.
Le port d'écrasement de nœud est initialisé avec la valeur du port du contrôleur spécifiée dans le projet au moment de la
programmation.
Port d'écrasement de
nœud
Opération Modbus
0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne sera
générée.
Autre que 0
Interprété comme étant la valeur du nouveau port et remplacé pour l’opération de runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable de port d'écrasement de nœud.
Note : Le maintien des valeurs de port d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
598
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
ID d'écrasement de nœud
Le protocole propose un type de données spécial ID d’écrasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de mémoire correspond à un octet non signé.
L’ID d'écrasement de nœud est initialisé avec la valeur de l’ID de nœud spécifiée dans le projet au moment de la
programmation.
ID d'écrasement
de nœud
Opération Modbus
0
La communication avec le contrôleur est coupée. En cas d’opération d'écriture, la requête sera
transmise sans attente de réponse.
1 à 254
Interprété comme étant la valeur du nouvel ID de nœud et remplacé pour l’opération de runtime.
255
La communication avec le contrôleur est coupée, aucun message de requête ne sera généré.
Note : Le maintien de la valeur de l’ID d'écrasement de nœud assignée au moment du runtime est assuré par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
599
TCP Modbus
Mode Modicon
Ce protocole fournit un type de données spécial qui permet d'écraser les paramètres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus générique (base 0). Les index de registre partent de 0.
1
Modbus Modicon (base 1). Les index de registre partent de 1.
Note : La valeur des paramètres de mode Modicon assignée dans le runtime est conservée à travers les cycles
d’alimentation.
600
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
601
TCP Modbus
Type
Description
Modbus générique csv
v1.0
Linéaire
Nécessite un fichier .csv.
DELTA PLC csv v1.0
Nécessite un fichier .csv.
Toutes les variables s’affichent au même niveau.
Toutes les variables s’affichent au même niveau.
CODESYS2 sym v1.0
Linéaire
Nécessite un fichier .sym.
Toutes les variables s’affichent au même niveau.
Une fois le fichier .sym sélectionné, le dialogue suivant s'affichera pour la
sélection de modèle d'API.
Kollmorgen txt v1.0
Linéaire
Nécessite un fichier .txt.
Schneider Unity v1.0
Linear
Requiert un fichier .uny.
602
Toutes les variables s’affichent au même niveau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Le fichier contenant des symboles doit être exporté au format .txt et plus tard
rebaptisé .uny. Le pilote d'importation considère uniquement les variables
situées à l'adresse fixe et ne tient pas compte des tableaux de chaînes. Tous les
autres tableaux, sauf pour le type booléen, sont développés.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
603
TCP Modbus
Élément de la barre d’outils
Description
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Structure de fichier csv Modbus Generic
Ce protocole prend en charge l’importation des informations de variable lorsque vous les lui fournissez au format .csv,
conformément au format suivant :
NodeID, TagName, MemoryType, Address, DataFormat,...,[Comment]
Note : Les champs entre crochets ainsi que les champs entre DataFormat et Comment sont facultatifs.
Champ
Description
IDNœud
Nœud auquel appartient la variable
Nomvariable
Description de la variable
TypeMémoire
Adresse
604
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Champ
Description
FormatDeDonnées Type de données dans la notation interne. Consultez la section « Concepts de
programmation » du manuel principal.
Commentaire
Description supplémentaire facultative.
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne possède pas de champ « Commentaire ». Lorsque ce champ est manquant, le caractère de
fin de ligne doit être une virgule.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
Pas de réponse
Pas de retour dans le délai d'attente
configuré.
Vérifiez que le contrôleur est connecté
et correctement configuré pour
accéder au réseau.
La réponse contient
une adresse de nœud
incorrecte
Le contrôleur a envoyé une réponse
contenant une adresse de nœud non
valide au périphérique.
-
Le message reçu est
trop court
Le contrôleur a envoyé une réponse dans
un format non valide au périphérique.
-
Écriture incorrecte
confirmation des
données
Le contrôleur a refusé une demande
d'écriture.
Vérifiez la cohérence entre les
données de projet et les ressources
du contrôleur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
605
Modbus TCP Server
Modbus TCP Server
Le pilote de communication Modbus TCP Server permet de connecter le périphérique IHM en tant qu'esclave à un réseau
TCP Modbus. Ensuite, il est possible de connecter des clients TCP Modbus à plusieurs panneaux IHM utilisés comme
serveurs. L'échange d'informations utilise les messages TCP Modbus standard.
Cette approche permet de connecter des périphériques IHM à des systèmes SCADA à travers le protocole de
communication TCP Modbus pris en charge de manière universelle.
Principe de l'opération
Le pilote de communication met en œuvre un groupe Modbus TCP Server sur le périphérique IHM. Il prend en charge un
sous-ensemble de la gamme complète des codes de fonctions Modbus. Les codes de fonction disponibles permettent le
transfert de données entre les clients du réseau TCP et le serveur. Le périphérique IHM remplit une fonction de serveur
dans le réseau. Il peut échanger des données avec jusqu'à 32 clients. Cela signifie que jusqu'à 32 clients peuvent être
connectés simultanément au périphérique IHM. Si les 32 connexions disponibles sont toutes utilisées, toute tentative
ultérieure de connexion d'un client sera rejetée par le serveur.
Le diagramme suivant représente l'architecture de système.
Le périphérique simule l'interface de communication d'un API : Les types de données des bobines et des registres sont
booléennes voire à 16 bits entiers.
Le périphérique peut à tout moment accéder aux données enregistrées dans sa mémoire interne. Le transfert de données
de et vers un client Modbus est possible uniquement sur l'initiative du client même.
Détails de mise en œuvre
Cette mise en œuvre du serveur TCP Modbus prend seulement en charge un sous-ensemble des codes fonction Modbus
standard.
Code Fonction
Description
01
Lecture de l’état de la bobine
Lecture de bits multiples dans la bobine du périphérique.
02
Lecture de l’état d’entrée
Lecture de bits multiples dans la bobine du périphérique.
606
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Code Fonction
Description
03
Lecture des registres
d’exploitation
Lecture de registres multiples du périphérique.
04
Lecture des registres
d’entrée
Lecture de registres multiples du périphérique.
05
Forcer bobine seule
Force une bobine unique du périphérique à passer en état
« MARCHE » ou « ARRÊT ».
06
Prédéfinir registre seul
Prédéfinit une valeur dans un registre du périphérique.
15
Forcer plusieurs bobines
Force plusieurs bobines du périphérique à passer en état
« MARCHE » ou « ARRÊT ».
16
Prédéfinir registres multiples
Prédéfinit une valeur dans plusieurs registres du périphérique.
23
Lecture/écriture de plusieurs
registres
Lit et prédéfinit une valeur dans plusieurs registres du périphérique
Note : Sur les deux types d'API, les fonctions Lecture de l’état de la bobine et Lecture de l’état d’entrée accèdent
toutes les deux à la même mémoire de bobine dans la mémoire du périphérique IHM. Les fonctions Lecture des
registres de maintien et Lecture des registres d’entrée accèdent toutes les deux à la même zone de registre dans
la mémoire du périphérique IHM.
Codes d'exception
Code
Description
01
Fonction interdite. le code de fonction de la requête n'est pas pris en charge
02
Adresse de données interdite. L'adresse de données reçue au cours de la requête
dépasse la plage de données prédéfinie (voir Paramètre d’édition variable pour afficher
les détails des plages pour tous les types).
03
Valeur de données interdite. Une sous-fonction autre que 00 est spécifiée dans le Test
de diagnostic de rebouclage (code 08).
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
607
Modbus TCP Server
Élément
Description
ID Modbus
ID de nœud Modbus du périphérique IHM. Chaque périphérique de serveur Modbus du réseau doit avoir
sa propre ID Modbus.
Port
Numéro du port utilisé par le protocole TCP Modbus. Par défaut, cette valeur est configurée à 502.
Configurez la valeur selon le numéro de port utilisé par votre réseau TCP Modbus.
utiliser
UDP/IP
Si cette option a été sélectionnée, le protocole utilisera des datagrammes UDP sans connexion.
RTU
encapsulé
Si cette option a été sélectionnée, le protocole utilisera de préférence le protocole RTU en série via
Ethernet au lieu du protocole Modbus TCP, indépendamment du fait si TCP ou UDP est utilisé.
Registres
Si sélectionné, il permet de définir la première adresse de registre et le nombre de registres pour la zone
Enron 32 bit de mémoire des registres à 32 bit.
Note : Les registres à 32 bit sont disponibles uniquement pour les modèles d’API Enron
Modbus.
608
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Définition de la zone de mémoire des registres à 32 bits.
Commencer La valeur Commencer correspond à la première adresse de registre.
reg 32bits
La valeur Taille correspond au nombre de registres.
Taille reg
Note : La réponse à une requête à l'un des registres de cette zone sera à 4 octets.
32bits
Modèles
d'API
Permet de choisir entre les différentes modèles d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en œuvre modbus où toutes les ressources commencent
avec décalage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus où toutes les ressources commencent
avec décalage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone de mémoire
des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de mémoire des
registres 32 bites.
Note : La plage d’adresses utilisée dans les trames Modbus s'étend toujours de 0 à 65535 pour
les registres d’exploitation et de 0 à 65535 pour les bobines.
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne apparaît.
2. Sélectionnez Modbus TCP Server dans la liste des protocoles : le dialogue de définition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
609
Modbus TCP Server
Élément Description
Type de
mémoir
e
Ressource de Modbus où se situe la variable.
Type de mémoire
Ressource Modbus
État de la bobine
Bobines
État d’entrée
Entrée discrète
Registres d'entrée
Registres d'entrée
Registres d’exploitation
Registres d’exploitation
Registres à 32 bits
Zone de mémoire des registres à 32 bits.
Disponible uniquement pour les modèles d’API Enron Modbus.
Mode Modicon
Offset
paramètre de protocole (voir Types de données spéciaux pour
plus d'informations concernant ce mode)
Adresse d’offset où se situe la variable.
Les adresses de décalage sont six chiffres composés par un préfixe de type de données à un
chiffre+ une adresse de ressource à cinq chiffres.
Sousin
dex
610
Generic
Modbus
Gamme
Offset
Type de mémoire
Gamme Offset
Modicon
Gamme Offset
État de la bobine
0 – 65535
0 – 65535
1–
65535
État d’entrée
100000 – 165535
0 – 65535
1–
65535
Registres d'entrée
300000 – 365535
0 – 65535
1–
65535
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres à 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la sélection de l'offset de ressource pour le registre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Type de
donnée
s
Type de données
Espace mémoire
Limites
boolean
Donnée à 1 bite
0 ... 1
octet
Donnée à 8 bite
-128 ... 127
short
Donnée à 16 bite
-32768 ... 32767
int
Donnée à 32 bite
-2.1e9 ... 2.1e9
int64
Donnée à 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donnée à 8 bite
0 ... 255
unsignedShort
Donnée à 16 bite
0 ... 65535
unsignedInt
Donnée à 32 bite
0 ... 4.2e9
uint64
Donnée à 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
précision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
précision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des éléments contenant du code de caractères défini
par l'encodage sélectionné
binary
Données binaires arbitraires
Remarque : pour définir des tableaux, sélectionnez l’un des formats de type de
données suivi de crochets tels que « byte[] », « short[] », etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
611
Modbus TCP Server
Élément Description
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
612
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Mode Modicon
Ce protocole fournit un type de données spécial qui permet d'écraser les paramètres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus générique (base 0). Les index de registre partent de 0.
1
Modbus Modicon (base 1). Les index de registre partent de 1.
Note : La valeur des paramètres de mode Modicon assignée dans le runtime est conservée à travers les cycles
d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
613
Modbus TCP Server
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
614
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Modbus générique
csv v1.0
Linéaire
Nécessite un fichier .csv.
CODESYS2 sym v1.0
Linéaire
Nécessite un fichier .sym.
Toutes les variables s’affichent au même niveau.
Toutes les variables s’affichent au même niveau.
Une fois le fichier .sym sélectionné, le dialogue suivant s'affichera pour la
sélection de modèle d'API.
Fichier .xml exporté
de l'éditeur de
variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
615
Modbus TCP Server
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Structure de fichier csv Modbus Generic
Ce protocole prend en charge l’importation des informations de variable lorsque vous les lui fournissez au format .csv,
conformément au format suivant :
NodeID, TagName, MemoryType, Address, DataFormat,...,[Comment]
Note : Les champs entre crochets ainsi que les champs entre DataFormat et Comment sont facultatifs.
616
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Champ
Description
IDNœud
Nœud auquel appartient la variable
Nomvariable
Description de la variable
TypeMémoire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonnées Type de données dans la notation interne. Consultez la section « Concepts de
programmation » du manuel principal.
Commentaire
Description supplémentaire facultative.
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne possède pas de champ « Commentaire ». Lorsque ce champ est manquant, le caractère de
fin de ligne doit être une virgule.
État de communication
Le périphérique IHM est un poste serveur dans le réseau TCP Modbus. La mise en œuvre actuelle du protocole ne rapporte
pas de code d'erreur de communication autre que les codes standards d'erreur de communication pour le chargement
correct du pilote.
Voir la section « Variables système » du manuel principal.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
617
Mitsubishi FX ETH
Mitsubishi FX ETH
Mitsubishi FX ETH implements the MELSEC-F (or MC) communication protocol that can be used with FX CPUs as
described in the Mitsubishi document “FX3U-ENET USER’S MANUAL”, chapter 8 “Communication using MC protocol”.
Note: Mitsubishi FX3U controller must be equipped with the appropriate Ethernet module: FX3U-ENET
Protocol Editor Settings
Add [+] a driver in the Protocol editor and select the protocol called “Mitsubishi FX ETH” from the list of available protocols.
Element Description
IP
address
Ethernet IP address of the controller
Port
Specifies the port number (decimal) used in the communication with the PLC.
618
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
PLC
Model
Defines the PLC model connected
PLC
The protocol allows the connection of multiple controllers to one operator panel. To set-up
Network multiple connections, check “PLC network” checkbox and enter IP Address for all controllers.
Controller Settings with GX Developer
The Mitsubishi FX system must be properly configured for Ethernet communication using the Mitsubishi FX Configurator.
Click on “Operational settings” as shown at point (1) in the following figure:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
619
Mitsubishi FX ETH
Into Operational Settings dialog, verify the “Communication data code” is set to “Binary code”,
Then type-in the Controller IP Address and confirm with [End] button.
620
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Click now on “Initial settings” as shown at point (2) of Figure below:
For proper communication between HMI and controller it is required to change “Destination existence confirmation starting
interval” from the default value of 1200 to 10ms.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
621
Mitsubishi FX ETH
In case of communication error, this avoid controller keeps alive the connection for a too long time before to allow a new
connection from the HMI.
Click now on “Open settings” as shown at point (3) of Figure below
The next figure shows the “Ethernet open settings” configuration.
The detailed explanation of the meaning of each setting is available in Chapter 5.5 of the Mitsubishi “FX3U-ENET USER’S
MANUAL”.
“Host station Port No.” defined here is the same must be used into Protocol Editor Settings chapter.
622
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: the usage of more than one panel communicating with the same controller requires to define proper
settings in the “Open settings” configuration dialog: one connection per each panel must be configured with
proper properties
Controller Settings with GX Works2
The Mitsubishi FX system must be properly configured for Ethernet communication inside GX Works2 programming suite.
FX Parameter dialog can be recalled with double-click on PLC Parameter:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
623
Mitsubishi FX ETH
Then select “Ethernet Port” tab where is possible to configure IP Address.
Verify the “Communication data code” is set to “Binary code” as shown below:
Then click on “Open Settings” button to recall the “Ethernet Port Open Setting” dialog.
624
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
“Host station Port No.” defined here is the same must be used into Protocol Editor Settings chapter.
Note: For FX3GE Controller, the Open System must be set as “Data Monitor” and Port set to 1025.
Note: the usage of more than one panel communicating with the same controller requires to define proper
settings in the “Open settings” configuration dialog: one connection per each panel must be configured with
proper properties.
Tag Editor Settings
Into Tag editor select the protocol “Mitsubishi FX ETH” from the list of defined protocols and add a tag using [+] button.
Tag settings can be defined using the following dialog:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
625
Mitsubishi FX ETH
Element Description
Resour
ces
Area of PLC where tag is located
Offset
Offset address where tag is located.
SubInd
ex
This allows resource offset selection within the register.
Type
Data Type
Memory Space
Limits
boolean
1 bit data
0 ... 1
byte
8-bit data
-128 ... 127
short
16-bit data
-32768 ... 32767
int
32-bit data
-2.1e9 ... 2.1e9
unsignedByte
8-bit data
0 ... 255
unsignedShort
16-bit data
0 ... 65535
unsignedInt
32-bit data
0 ... 4.2e9
float
IEEE single-precision
1.17e-38 ... 3.40e38
32-bit floating point type
string
Refer to “String data type chapter”
Note: to define arrays, select one of Data Type format followed by square brackets like
“byte[]”, “short[]”…
Arraysi
ze
626
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
l
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
Échange les octets d'un mot double.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
627
Mitsubishi FX ETH
Element Description
Valeur
Description
GHEFCDAB
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Tag Import
Exporting Tags from PLC
The Mitsubishi FX Ethernet tag import accepts symbol files with extension “csv” created by the Mitsubishi GX Works2 (Not
from GX Developer).
The “.csv” file can be exported from the Project tree, as shown in the following figure.
1. Right-click on the Global variable list that need to be exported,
2. Select “Write to CSV File…”
628
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Into following dialog select the file name and location:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
629
Mitsubishi FX ETH
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
The following dialog shows which importer type can be selected.
630
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importer
Description
GX Works2 v1.0
Linear
Requires a .csvfile.
Tag Editor exported xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
631
Mitsubishi FX ETH
Élément de la barre d’outils
Description
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Returned in case the controller replies with a not acknowledge
Timeout
Returned when a request is not replied within the specified timeout period; ensure the controller
is connected and properly configured to get network access
Invalid
The panel did receive from the controller a response, but its format or its contents is not as
response expected; ensure the data programmed in the project are consistent with the controller resources
General
Error
632
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Mitsubishi FX SER
The HMI operator panels can be connected to Mitsubishi FX PLC as the network master using this communication driver.
The protocol has been designed to connect to the programming port of the PLC.
Please note that changes in the communication protocol specifications or PLC hardware may have occurred since this
documentation was created. Some changes may eventually affect the functionality of this communication driver. Always
test and verify the functionality of your application. To fully support changes in PLC hardware and communication
protocols, communication drivers are continuously updated. Always ensure that the latest version of communication driver
is used in your application.
Protocol Editor Settings
Add [+] a driver in the Protocol editor and select the protocol called “Mitsubishi FX SER” from the list of available protocols.
Element
Description
PLC Models
The list allows selecting the PLC model you are going to connect to. The selection will
influence the data range offset per each data type according to the specific PLC
memory resources.
Comm…
Gives access to the serial port configuration parameters as shown in the figure below.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
633
Mitsubishi FX SER
Element
Description
Port
Serial port selection:
Port
Series 400
Series 500/600
com1
PLC Port
Onboard Serial Port
com2
PC/Printer Port
Optional Module on slot #1 or #2
com3
Not available
Optional Module on slot #3 or #4
Baud rate,
Parity, Data bits,
Stop bits
Communication parameters for serial communication
Mode
Serial port mode; available options:
RS-232,
RS-485 (2 wires)
RS-422 (4 wires)
Tag Editor Settings
Into Tag editor select the protocol “Mitsubishi FX ETH” from the list of defined protocols and add a tag using [+] button.
Tag settings can be defined using the following dialog:
634
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Resour
ces
Area of PLC where tag is located
Offset
Offset address where tag is located.
SubInd
ex
This allows resource offset selection within the register.
Type
Data Type
Memory Space
Limits
boolean
1 bit data
0 ... 1
byte
8-bit data
-128 ... 127
short
16-bit data
-32768 ... 32767
int
32-bit data
-2.1e9 ... 2.1e9
unsignedByte
8-bit data
0 ... 255
unsignedShort
16-bit data
0 ... 65535
unsignedInt
32-bit data
0 ... 4.2e9
float
IEEE single-precision
1.17e-38 ... 3.40e38
32-bit floating point type
string
Refer to “String data type chapter”
Note: to define arrays, select one of Data Type format followed by square brackets like
“byte[]”, “short[]”…
Arraysi
ze
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
635
Mitsubishi FX SER
Element Description
l
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
636
Échange les octets d'un mot double.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Valeur
Description
GHEFCDAB
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Tag Import
Exporting Tags from PLC
The Mitsubishi FX Serial tag import accepts symbol files with extension “csv” created by the Mitsubishi GX Works2 (Not
from GX Developer).
The “.csv” file can be exported from the Project tree, as shown in the following figure.
1. Right-click on the Global variable list that need to be exported,
2. Select “Write to CSV File…”
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
637
Mitsubishi FX SER
Into following dialog select the file name and location:
638
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
The following dialog shows which importer type can be selected.
Importer
Description
GX Works2 v1.0
Linear
Requires a .csv file.
Tag Editor exported
xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté de
l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
639
Mitsubishi FX SER
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
640
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Returned in case the controller replies with a not acknowledge
Timeout
Returned when a request is not replied within the specified timeout period; ensure the controller
is connected and properly configured to get network access
Line
Error
Returned when an error on the communication parameter setup is detected (parity, baud rate,
data bits, stop bits); ensure the communication parameter settings of the controller is compatible
with panel communication setup
Invalid
The panel did receive from the controller a response, but its format or its contents is not as
response expected; ensure the data programmed in the project are consistent with the controller resources
General
Error
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
641
Mitsubishi iQ/Q/L ETH
Mitsubishi iQ/Q/L ETH
The Mitsubishi iQ/Q/L ETH driver supports communication with Mitsubishi controllers with integrated Ethernet port and
with external Ethernet card (QJ71E71-100).
Protocol Editor Settings
Add (+) a driver in the Protocol editor and select the protocol called “Mitsubishi iQ/Q/L ETH” from the list of available
protocols.
The driver configuration dialog is shown as in the following figure:
Element Description
IP
address
Ethernet IP address of the controller
Port
Specifies the port number (decimal) used in the communication with the PLC.
642
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
PLC
Model
The driver supports communication with different Mitsubishi iQ, Q and L controllers.
Note: PLC Model selection has only effect on range values of variables. If a particular
model is not present in the list, try selecting a similar one. If range values of variables
are the same, the communication will be correctly established.
PLC
The protocol allows the connection of multiple controllers to one HMI device. To set-up multiple
Network connections, check “PLC network” checkbox and create your network using the command “Add”
per each slave device you need to include in the network.
Controller Settings
GX Works2
The Mitsubishi Q system must be properly configured for Ethernet communication using the Mitsubishi GX Developer
software version 7 or higher, from GX Works2 software.
The Figure below shows an example of network configuration for Ethernet communication.
Please note that the communication protocol supports only Binary code communication.
The PLC system must be configured to accept incoming data from the external device.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
643
Mitsubishi iQ/Q/L ETH
In the GX Developer Software open “Parameters”, “Network Param” and select Ethernet/ CC IE/ MELSECNET”. Add the
number of connections of the operator panels you want to configure in the network.
When using the Mitsubishi CPU with external Ethernet card (QJ71E71-100) the connections have to be configured
according to the following figure as "Unpassive":
When the “Existence confirmation” setting has been set to Confirm, the TCP connection will be closed when it is not used
(connection lost); by default the TCP port remains open and it is not possible to reconnect.
Note: The GX Developer software allows entering the conventional representation settings (decimal or
hexadecimal) for the port number; in the above figure it is in hexadecimal.
In the next figures there are 2 examples about how to set “Initial settings” for 5 and 15 seconds timeout.
644
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
When using Mitsubishi CPU with integrated Ethernet port the "Open System" settings should be changed to "MC
connection"
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
645
Mitsubishi iQ/Q/L ETH
Note: The number format for Host Station Port No. is hexadecimal, not decimal.
GX Works3
The Mitsubishi Q system must be properly configured for Ethernet communication using GX Works3 software.
The communication driver is based on SLMP function.
SLMP (Seamless Message Protocol) is a protocol for accessing SLMP-compatible devices from an external device (such
as HMI) using TCP or UDP through Ethernet.
From GX Works3 software, Ethernet port parameters must be set from Module parameter > Ethernet Port > Basic
Settings > Own Node Settings.
646
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
SLMP Connection Module must be added in Module parameter > Ethernet Port > Basic Settings > External Device
Configuration > Detailed Settings > Ethernet Configuration (Built-in Ethernet Port). Port No. parameter must be
the same as per Port parameter from Protocol Editor Settings (see images below).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
647
Mitsubishi iQ/Q/L ETH
Note: To actually get communication with HMI it is necessary to initialize the PLC after the above settings have
been applied.
To initialize the PLC it possibile to use the Run/Stop/Reset switch or by simply rebooting the PLC.
Tag Import
Select the driver in Tag Editor and click on the Import Tags button to start the importer.
648
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
The following dialog shows which importer type can be selected.
Importer
Description
GX Works2/GX Works3
v1.0
Linear
Requires a .csvfile.
Tag Editor exported xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
649
Mitsubishi iQ/Q/L ETH
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
650
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Returned in case the controller replies with a not acknowledge
Timeout
Returned when a request is not replied within the specified timeout period; ensure the controller
is connected and properly configured to get network access
Invalid
The panel did receive from the controller a response, but its format or its contents is not as
response expected; ensure the data programmed in the project are consistent with the controller resources
General
Error
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
651
NMEA 0183
NMEA 0183
The NMEA 0183 driver has been developed to communicate with NMEA 0183 compatible devices trough the operator
panel serial ports.
Protocol Editor Settings
Add (+) a new driver in the Protocol editor and select the protocol called “NMEA 0183” from the list of available protocols.
The driver configuration dialog is shown in the following figure.
Element Description
Timeout Defines the time inserted by the protocol between two retries of the same message in case of
(sec)
missing response from the server device. It is expressed in seconds.
Echo
If selected the NMEA messages received on the RX channel of serial port are sent out from the
TX channel. This allows to continue the NMEA network downstream of the operator panel
whether required.
PLC
Models
Two PLC models are available:
NMEA 0183 Sentences: when selected the Tags will point univocally to the specified NMEA
sentence.
Virtual variables: when selected the Tag will show the value coming from any NMEA sentence of
the specified type, for example any NMEA sentence of Latitude type.
Tag Editor Settings
Into Tag editor select the protocol “NMEA 0183” from the list of defined protocols and add a tag using [+] button.
Tag settings can be defined using the following dialog:
652
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Description
Variable
The NMEA Sentence or Virtual variable
Data Type
Data Type
Memory Space
Limits
boolean
1 bit data
0 ... 1
byte
8-bit data
-128 ... 127
short
16-bit data
-32768 ... 32767
int
32-bit data
-2.1e9 ... 2.1e9
unsignedByte
8-bit data
0 ... 255
unsignedShort
16-bit data
0 ... 65535
unsignedInt
32-bit data
0 ... 4.2e9
float
IEEE single-precision
1.17e-38 ... 3.40e38
32-bit floating point type
string
String data
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
653
NMEA 0183
Element
Description
Arraysize
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments
vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conversion Conversion to be applied to the tag.
Value
Description
Degrees
Shows Degrees data only from coordinates sentence
Minutes
Shows Minutes data only from coordinates sentence
Seconds
Shows Seconds data only from coordinates sentence
List of supported NMEA 0183 commands
The NMEA 0183 commands supported from the communication protocol are the following:
AAM_01_StatusArrivalCircle
AAM_02_StatusPerpendicular
AAM_03_ArrivalCircleRadius
AAM_04_UnitsOfRadius
AAM_05_WaypointID
ACK_01_LocalAlarmNumber
ALM_01_TotalNumberOfMessages
ALM_02_MessageNumber
ALM_03_SatelliteNumber
ALM_04_WeekNumber
ALM_05_SVhealth
ALM_06_Eccentricity
ALM_07_AlmanacReferenceTime
ALM_08_InclinacionAngle
ALM_09_RateOfRightAscension
ALM_10_RootOfSemimajorAxis
ALM_11_ArgumentOfPerigee
ALM_12_LongitudeOfAscesionNode
654
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
ALM_13_MeanAnomaly
ALM_14_ClockParameter0
ALM_15_ClockParameter1
ALR_01_TimeOfAlarmConditionChange
ALR_02_LocalAlarmNumber
ALR_03_AlarmCondition
ALR_04_AlarmAcknowledgeState
ALR_05_AlarmDescriptionState
APB_01_StatusSNR
APB_02_StatusLock
APB_03_MagnitudeOfXTE
APB_04_DirectionToStear
APB_05_UnitsXTE
APB_06_StatusArrivalCircle
APB_07_StatusPerpendicular
APB_08_BearingOriginToDestination
APB_09_MagneticOrTrue
APB_10_DestinatonWaypointID
APB_11_Bearing
APB_12_BearingMagneticOrTrue
APB_13_HeadingToSteer
APB_14_HeadingMagneticOrTrue
APB_15_ModeIndicator
BEC_01_ObservationUTC
BEC_02_WaypointLatitude
BEC_03_WaypointLatitudeInd
BEC_04_WaypointLongitude
BEC_05_WaypointLongitudeInd
BEC_06_BearingTrue
BEC_07_BearingTrueInd
BEC_08_BearingMagnetic
BEC_09_BearingMagneticInd)
BEC_10_Distance
BEC_11_DistanceUnits
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
655
NMEA 0183
BEC_12_WaypointID
BOD_01_BearingTrue
BOD_02_BearingTrueInd
BOD_03_BearingMagnetic
BOD_04_BearingMagneticInd
BOD_05_DestinationWaypointID
BOD_06_OriginWaypointID
BWC_01_ObservationUTC
BWC_02_WaypointLatitude
BWC_03_WaypointLatitudeInd
BWC_04_WaypointLongitude
BWC_05_WaypointLongitudeInd)
BWC_06_BearingTrue
BWC_07_BearingTrueInd
BWC_08_BearingMagnetic
BWC_09_BearingMagneticInd
BWC_10_Distance
BWC_11_DistanceUnits
BWC_12_WaypointID
BWC_13_ModeIndicator
BWR_01_ObservationUTC
BWR_02_WaypointLatitude
BWR_03_WaypointLatitudeInd
BWR_04_WaypointLongitude
BWR_05_WaypointLongitudeInd
BWR_06_BearingTrue
BWR_07_BearingTrueInd
BWR_08_BearingMagnetic
BWR_09_BearingMagneticInd
BWR_10_Distance
BWR_11_DistanceInd
BWR_12_WaypointID
BWR_13_ModeIndicator
BWW_01_BearingTrue
656
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
BWW_02_BearingTrueInd
BWW_03_BearingMagnetic
BWW_04_BearingMagneticInd
BWW_05_ToWaypointID
BWW_06_FromWaypointID
DBT_01_WaterDepthFeet
DBT_02_WaterDepthFeetInd
DBT_03_WaterDepthMeters
DBT_04_WaterDepthMetersInd
DBT_05_WaterDepthFathoms
DBT_06_WaterDepthFathomsInd
DCN_01_DeccaChainIdentifier
DCN_02_RedZoneIdentifier
DCN_03_RedLineOfPosition
DCN_04_StatusRedMasterLine
DCN_05_GreenZoneIdentifier
DCN_06_GreenLineOfPosition
DCN_07_StatusGreenMasterLine
DCN_08_PurpleZoneIdentifier
DCN_09_PurpleLineOfPosition
DCN_10_StatusPurpleMasterLine
DCN_11_RedLineNavigationUse, A=Valid
DCN_12_GreenLineNavigationUse, A=Valid
DCN_13_PurpleLineNavigationUse, A=Valid
DCN_14_PositionUncertainty
DCN_15_PositionUncertaintyInd
DCN_16_FixDataBasis
DPT_01_WaterDepth
DPT_02_OffsetFromTransducer
DPT_03_MaximumRangeScale
DSC_01_FormatSpecifier
DSC_02_Address
DSC_03_Cattegory
DSC_04_NatureOfDistress
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
657
NMEA 0183
DSC_05_TypeOfCommunication
DSC_06_PositionOrChannel
DSC_07_TimeOrTelNo
DSC_08_ShipMMSI
DSC_09_NatureOfDistress
DSC_10_Acknowledgment
DSC_11_ExpansionIndicator
DSE_01_TotalNumberOfMessages
DSE_02_MessageNumber
DSE_03_Query_ReplyFlag
DSE_04_Vessel_MMSI
DSE_05_DataSet1Code
DSE_06_Dataset1Data
DSE_07_Dataset2Code
DSE_08_Dataset2Data
DSE_09_Dataset3Code
DSE_10_Dataset3Data
DSE_11_Dataset4Code
DSE_12_Dataset4Data
DSE_13_Dataset5Code
DSE_14_Dataset5Data
DSE_15_Dataset6Code
DSE_16_Dataset6Data
DSE_17_Dataset7Code
DSE_18_Dataset7Data
DSE_19_Dataset8Code
DSE_20_Dataset8Data
DSE_21_Dataset9Code
DSE_22_Dataset9Data
DSE_23_Dataset10Code
DSE_24_Dataset10Data
DSI_01_TotalNumberOfMessages
DSI_02_MessageNumber
DSI_03_Vessel_MMSI
658
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
DSI_04_VesselCourse
DSI_05_VesselType
DSI_06_GeographicArea
DSI_07_Commandset1Code
DSI_08_Commandset1Data
DSI_09_Commandset2Code
DSI_10_Commandset2Data
DSI_11_Commandset3Code
DSI_12_Commandset3Data
DSI_13_ExpansionIndicator
DSR_01_TotalNumberOfMessages
DSR_02_MessageNumber
DSR_03_Vessel_MMSI
DSR_04_Dataset1Code
DSR_05_Dataset1Data
DSR_06_Dataset2Code
DSR_07_Dataset2Data
DSR_08_Dataset3Code
DSR_09_Dataset3Data
DSR_10_ExpansionIndicator
DTM_01_LocalDatumCode
DTM_02_LocalDatumSubdivisioncode
DTM_03_LatOffset
DTM_04_LatOffsetInd
DTM_05_LonOffset
DTM_06_LonOffsetInd
DTM_07_AltitudeOffset
DTM_08_ReferenceDatumCode
FSI_01_TransmitingFrequency
FSI_02_ReceivingFrequency
FSI_03_ModeOfOperation
FSI_04_PowerLevel
GBS_01_UTC
GBS_02_ExpectedLatitudeError
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
659
NMEA 0183
GBS_03_ExpectedLongitudeError
GBS_04_ExpectedAltitudeError
GBS_05_FailedSatelliteID
GBS_06_ProbabilityOfMissedDetection
GBS_07_EstimateOfBiasMeters
GBS_08_StandardDeviationOfBiasEstimate
GGA_01_UTC
GGA_02_Latitude
GGA_03_LatitudeInd
GGA_04_Longitude
GGA_05_LongitudeInd
GGA_06_QualityIndicator
GGA_07_NumberOfSatellitesInUse
GGA_08_HorizontalDilutionOfPrecision
GGA_09_Altitude
GGA_10_AltitudeInd
GGA_11_GeoidalSeparation
GGA_12_GeoidalSeparationInd
GGA_13_AgeOfDifferentialData
GGA_14_DifferentialReferenceID
GLC_01_GRI
GLC_02_MasterTOA
GLC_03_SignalStatus1
GLC_04_TD1
GLC_05_SignalStatus2
GLC_06_TD2
GLC_07_SignalStatus3
GLC_08_TD3
GLC_09_SignalStatus4
GLC_10_TD4
GLC_11_SignalStatus5
GLC_12_TD5
GLC_13_SignalStatus6
GLL_01_Latitude
660
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
GLL_02_LatitudeInd
GLL_03_Longitude
GLL_04_LongitudeInd
GLL_05_UTC
GLL_06_Status
GLL_07_ModeIndicator
GNS_01_UTC
GNS_02_Latitude
GNS_03_LatitudeInd
GNS_04_Longitude
GNS_05_LongitudeInd
GNS_06_ModeIndicator
GNS_07_NumberOfSatellitesInUse
GNS_08_HDOP
GNS_09_AntennaAltitude
GNS_10_GeoidalSeparation
GNS_11_AgeOfDifferentialData
GNS_12_DifferentialStationID
GRS_01_UTC
GRS_02_Mode
GRS_03_RangeResidual
GRS_04_RangeResidual
GRS_05_RangeResidual
GRS_06_RangeResidual
GRS_07_RangeResidual
GRS_08_RangeResidual
GRS_09_RangeResidual
GRS_10_RangeResidual
GRS_11_RangeResidual
GRS_12_RangeResidual
GRS_13_RangeResidual
GRS_14_RangeResidual
GSA_01_Mode
GSA_02_Mode
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
661
NMEA 0183
GSA_03_ID
GSA_04_ID
GSA_05_ID
GSA_06_ID
GSA_07_ID
GSA_08_ID
GSA_09_ID
GSA_10_ID
GSA_11_ID
GSA_12_ID
GSA_13_ID
GSA_14_ID
GSA_15_PDOP
GSA_16_HDOP
GSA_17_VDOP
GST_01_UTC
GST_02_RMSvalueOfStandardDeviation
GST_03_StandardDeviationOfSemiMajorAxis
GST_04_StandardDeviationOfSemiMinorAxis
GST_05_OrientationOfSemiMajorAxis
GST_06_StandardDeviationOfLatitude
GST_07_StandardDeviationOfLongitude
GST_08_StandardDeviationOfAltitude
GSV_01_NumberOfMessages
GSV_02_MessageNumber
GSV_03_NumberOfSatellitesInView
GSV_04_SET1_SatelliteID
GSV_05_SET1_Elevation
GSV_06_SET1_Azimuth
GSV_07_SET1_SNR
GSV_08_SET2_SatelliteID
GSV_09_SET2_Elevation
GSV_10_SET2_Azimuth
GSV_11_SET2_SNR
662
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
GSV_12_SET3_SatelliteID
GSV_13_SET3_Elevation
GSV_14_SET3_Azimuth
GSV_15_SET3_SNR
GSV_16_SET4_SatelliteID
GSV_17_SET4_Elevation
GSV_18_SET4_Azimuth
GSV_19_SET4_SNR
HDG_01_MagneticHeading
HDG_02_MagneticDeviation
HDG_03_MagneticDeviationInd
HDG_04_MagneticVariation
HDG_05_MagneticVariation
HDM_01_MagneticHeading
HDM_02_MagneticHeadingInd
HDT_01_Heading
HDT_02_HeadingInd
HMR_01_HeadingSensor1ID
HMR_02_HeadingSensor2ID
HMR_03_DifferenceLimit
HMR_04_HeadingSensorDifference
HMR_05_WarningFlag
HMR_06_HeadingReadingSensor1
HMR_07_StatusSensor1
HMR_08_TypeSensor1
HMR_09_DeviationSensor1
HMR_10_DeviationSensor1Ind)
HMR_11_HeadingReadingSensor
HMR_12_StatusSensor2
HMR_13_TypeSensor2
HMR_14_DeviationSensor2
HMR_15_DeviationSensor2Ind)
HMR_16_Variation
HMR_17_VariationInd)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
663
NMEA 0183
HMS_01_HeadingSensor1ID
HMS_02_HeadingSensor2ID
HMS_03_MaximumDifference
HSC_01_CommandedHeading
HSC_02_CommandedHeadingInd
HSC_03_CommandedHeadingMagnetic
HSC_04_CommandedHeadingMagneticInd
HTC_01_Override
HTC_02_CommandedRudderAngle
HTC_03_CommandedRudderDirection
HTC_04_SelectedSteeringMmode
HTC_05_TurnMode
HTC_06_CommandedRudderLimit
HTC_07_CommandedOffHeadingLimit
HTC_08_CommandedRadiusOfTurn
HTC_09_CommandedRateOfTurn
HTC_10_CommandedHeadingToSteer
HTC_11_CommandedOffTrackLimit
HTC_12_CommandedTrack
HTC_13_HeadingReferenceInUse
HTD_01_Override
HTD_02_CommandedRudderAngle
HTD_03_CommandedRudderDirection
HTD_04_SelectedSteeringMode
HTD_05_TurnMode
HTD_06_CommandedRudderLimit
HTD_07_CommandedOffHeadingLimit
HTD_08_CommandedRadiusOfTurn
HTD_09_CommandedRateOfTurn
HTD_10_CommandedHeadingToSteer
HTD_11_CommandedOffTrackLimit
HTD_12_CommandedTrack
HTD_13_HeadingReferenceInUse
HTD_14_RudderStatus
664
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
HTD_15_OffHeadingStatus
HTD_16_OffTrackstatus
HTD_17_VesselHeading
LCD_01_GRI
LCD_02_MasterSNR
LCD_03_MasterECD
LCD_04_Secondary1_SNR
LCD_05_Secondary1_ECD
LCD_06_Secondary2_SNR
LCD_07_Secondary2_ECD
LCD_08_Secondary3_SNR
LCD_09_Secondary3_ECD
LCD_10_Secondary4_SNR
LCD_11_Secondary4_ECD
LCD_12_Secondary5_SNR
LCD_13_Secondary5_ECD
MDA_01_BarometricPressureInchesOfMercury
MDA_02_BarometricPressureInchesOfMercuryInd
MDA_03_Barometric pressureBars
MDA_04_Barometric pressureBarsInd
MDA_05_AirTemperature
MDA_06_AirTemperatureInd
MDA_07_WaterTemperature
MDA_08_WaterTemperatureInd
MDA_09_RelativeHumidity
MDA_10_AbsoluteHumidity
MDA_11_DewPoint
MDA_12_DewPointInd
MDA_13_WindDirectionTrue
MDA_14_WindDirectionTrueInd
MDA_15_WindDirectionMagnetic
MDA_16_WindDirectionMagneticInd
MDA_17_WindSpeedKnots
MDA_18_WindSpeedKnotsInd
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
665
NMEA 0183
MDA_19_WindSpeedMs
MDA_20_WindSpeedMsInd
MLA_01_TotalNumberOfMessages
MLA_02_MessageNumber
MLA_03_SatelliteID
MLA_04_CalendarDay
MLA_05_GeneralizedHealth
MLA_06_Eccentricity
MLA_07_DOT
MLA_08_ArgumentOfPerigee
MLA_09_SystemTimeScaleCorrectionMSB
MLA_10_CorrectionOfAverageValueDraconitic
MLA_11_TimeOfAscensionNode
MLA_12_GreenwichLongitude
MLA_13_CorrectionToAverageValueInclination
MLA_14_SystemTimeScaleCorrectionLSB
MLA_15_CourseValueOfTimeScaleShift
MSK_01_BeaconFrequency
MSK_02_Auto_Manual_Frequency
MSK_03_BeaconBitRate
MSK_04_Auto_Manual_BitRate
MSK_05_IntervalForSending
MSK_06_ChannelNumber
MSS_01_SignalStrength
MSS_02_SNR
MSS_03_BeaconFrequency
MSS_04_BeaconBitRate
MSS_05_ChannelNumber
MTW_01_Temperature
MTW_02_TemperatureInd
MWD_01_WindDirection
MWD_02_WindDirectionInd
MWD_03_WindDirectionMagnetic
MWD_04_WindDirectionMagneticInd
666
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
MWD_05_WindSpeedKnots
MWD_06_WindSpeedKnotsInd
MWD_07_WindSpeedMs
MWD_08_WindSpeedMsInd
MWV_01_WindAngle
MWV_02_Reference
MWV_03_WindSpeed
MWV_04_WindSpeedInd
MWV_05_Status
NMEA_Altitude
NMEA_Course
NMEA_Latitude
NMEA_LatitudeInd
NMEA_Longitude
NMEA_LongitudeInd
NMEA_SpeedKnots
NMEA_UTC
OSD_01_Heading
OSD_02_HeadingStatus
OSD_03_VesselCourse
OSD_04_CourseReference
OSD_05_VesselSpeed
OSD_06_SpeedReference
OSD_07_VesselSet
OSD_08_VesselDrift
OSD_09_SpeedUnits
RMA_01_Status
RMA_02_Latitude
RMA_03_LatitudeInd
RMA_04_Longitude
RMA_05_LongitudeInd
RMA_06_TimeDifferenceA
RMA_07_TimeDifferenceB
RMA_08_SpeedOverGroundKnots
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
667
NMEA 0183
RMA_09_CourseOverGround
RMA_10_MagneticVariation
RMA_11_MagneticVariationInd
RMA_12_ModeIndicator
RMB_01_DataStatus
RMB_02_CrossTrackError
RMB_03_DirectionToSteer
RMB_04_OriginWaypointID
RMB_05_DestinationwaypointID
RMB_06_DestinationwaypointLat
RMB_07_DestinationwaypointLatInd
RMB_08_DestinationWaypointLongitude
RMB_09_DestinationWaypointLongitudeInd
RMB_10_RangeToDestination
RMB_11_BearingToDestination
RMB_12_DestinationClosingVelocity
RMB_13_ArrivalStatus
RMB_14_ModeIndicator
RMC_01_UTC
RMC_02_Status
RMC_03_Latitude
RMC_04_LatitudeInd
RMC_05_Longitude
RMC_06_LongitudeInd
RMC_07_SpeedOverGround
RMC_08_CourseOverGround
RMC_09_Date
RMC_10_MagneticVariation
RMC_11_MagneticVariationInd
RMC_12_ModeIndicator
ROT_01_RateOfTurn
ROT_02_Status
RPM_01_SourceShaftEngine
RPM_02_EngineOfShaftNumber
668
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
RPM_03_Speed
RPM_04_PropellerPitch
RPM_05_Status
RSA_01_StarboardRudderSensor
RSA_02_StatusRudderSensor)
RSA_03_PortRudderSensor
RSA_04_StatusPortRudderSensor)
RSD_01_Origin1Range
RSD_02_Origin1Bearing
RSD_03_VariableRangeMarker1
RSD_04_BearingLine1
RSD_05_Origin2Range
RSD_06_Origin2Bearing
RSD_07_VRM2
RSD_08_EBL2
RSD_09_CursorRange
RSD_10_CursorBearing
RSD_11_RangeScale
RSD_12_RangeScaleUnits
RSD_13_DisplayRotation
RTE_01_TotalNumberOfMessages
RTE_02_MessageNumber
RTE_03_MessageMode
RTE_04_RouteIdentifier
RTE_05_WaypointIdentifier1
RTE_06_WaypointIdentifier2
RTE_07_WaypointIdentifier3
RTE_08_WaypointIdentifier4
RTE_09_WaypointIdentifier5
RTE_10_WaypointIdentifier6
RTE_11_WaypointIdentifier7
RTE_12_WaypointIdentifier8
RTE_13_WaypointIdentifier9
RTE_14_WaypointIdentifier10
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
669
NMEA 0183
SFI_01_TotalNumberOfMessages
SFI_02_MessageNumber
SFI_03_1stFrequency
SFI_04_1stMode
SFI_05_2ndFrequency
SFI_06_2ndMode
SFI_07_3rdFrequency
SFI_08_3rdMode
SFI_09_4thFrequency
SFI_10_4thMode
SFI_11_5thFrequency
SFI_12_5thMode
SFI_13_6thFrequency
SFI_14_6thMode
STN_01_TalkerID
TLB_01_TargetNumber
TLB_02_LabelAssigned
TLB_03_TargetNumber1
TLB_04_LabelAssigned1
TLB_05_TargetNumber2
TLB_06_LabelAssigned2
TLB_07_TargetNumber3
TLB_08_LabelAssigned3
TLB_09_TargetNumber4
TLB_10_LabelAssigned4
TLB_11_TargetNumber5
TLB_12_Labelassigned5
TLB_13_TargetNumber6
TLB_14_LabelAssigned6
TLB_15_TargetNumber7
TLB_16_LabelAassigned7
TLB_17_TargetNumber8
TLB_18_LabelAssigned8
TLB_19_TargetNumberReported
670
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
TLB_20_TargetLabelAssigned
TLL_01_TargetNumber
TLL_02_TargetLatitude
TLL_03_TargetLatitudeInd
TLL_04_TargetLongitude
TLL_05_TargetLongitudeInd
TLL_06_TargetName
TLL_07_UTC
TLL_08_TargetStatus
TLL_09_ReferenceTarget
TTM_01_TargetNumber
TTM_02_TargetDistance
TTM_03_Bearing
TTM_04_BearingInd
TTM_05_TargetSpeed
TTM_06_TargetCourse
TTM_07_TargetCourseInd
TTM_08_DistanceOfClosestPoint
TTM_09_TimeToCPA
TTM_10_SpeedAndDistanceUnits
TTM_11_TargetName
TTM_12_TargetStatus
TTM_13_ReferenceTarget
TTM_14_UTC
TTM_15_TypeOfAcquisition
TXT_01_TotalNumberOfMessages
TXT_02_MessageNumber
TXT_03_TextIdentifier
TXT_04_TextMessage
VBW_01_LongitudinalWaterSpeed
VBW_02_TransverseWaterSpeed
VBW_03_StatusWaterSpeed
VBW_04_LongitudinalGroundSpeed
VBW_05_TransverseGroundSpeed
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
671
NMEA 0183
VBW_06_StatusGroundSpeed
VBW_07_SternTransverseWaterSpeed
VBW_08_StatusSternWaterSpeed
VBW_09_SternTransverseGroundSpeed
VBW_10_StatusSternGroundSpeed
VDR_01_Direction
VDR_02_DirectionInd
VDR_03_DirectionMagnetic
VDR_04_DirectionMagneticInd
VDR_05_CurrentSpeed
VDR_06_CurrentspeedInd
VHW_01_Heading
VHW_02_HeadingInd
VHW_03_HeadingMagnetic
VHW_04_HeadingMagneticInd
VHW_05_SpeedKnots
VHW_06_SpeedKnotsInd
VHW_07_SpeedKmh
VHW_08_SpeedKmhInd
VLW_01_TotalCumulativeDistance
VLW_02_TotalCumulativeDistanceInd
VLW_03_DistanceSinceReset
VLW_04_DistanceSinceResetInd
VPW_01_SpeedKnots
VPW_02_SpeedKnotsInd)
VPW_03_SpeedMs
VPW_04_SpeedMsInd
VTG_01_CourseOverGround
VTG_02_CourseOverGroundInd
VTG_03_CourseOverGroundMagnetic
VTG_04_CourseOverGroundMagneticInd
VTG_05_SpeedOverGroundKnots
VTG_06_SpeedOverGroundKnotsInd
VTG_07_SpeedOverGroundKmh
672
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
VTG_08_SpeedOverGroundKmhInd
VTG_09_ModeIndicator
VWR_01_MeasuredWindAngle
VWR_02_VesselHeading
VWR_03_MeasuredWindSpeed
VWR_04_MeasuredWindSpeedInd
VWR_05_WindSpeedMeters
VWR_06_WindSpeedMetersInd
VWR_07_WindSpeedKmh
VWR_08_WindSpeedKmhInd
VWT_01_CalculatedWindAngle
VWT_02_VesselHeading
VWT_03_CalculatedWindSpeed
VWT_04_CalculatedWindSpeedInd
VWT_05_WindSpeedMeters
VWT_06_WindSpeedMetersInd
VWT_07_WindSpeedKmh
VWT_08_WindSpeedKmhInd
WCV_01_VelocityComponent
WCV_02_VelocityComponentInd
WCV_03_WaypointIdentifier
WCV_04_ModeIndicator
WNC_01_DistanceMiles
WNC_02_DistanceMilesInd
WNC_03_DistanceKm
WNC_04_DisttanceKmInd
WNC_05_WaypointIdentifierFrom
WNC_06_WaypointIdentifierTo
WPL_01_WaypointLatitude
WPL_02_WaypointLatitudeInd
WPL_03_WaypointLongitude
WPL_04_WaypointLongitudeInd
WPL_05_WaypointIdentifier
XDR_01_Transducer1Type
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
673
NMEA 0183
XDR_02_Measurmnt1Data
XDR_03_UnitsOfMeasure1
XDR_04_Transducer1
XDR_05_Transducer2Type
XDR_06_Measurment2Data
XDR_07_UnitsOfMeasure2
XDR_08_Transducer2
XDR_09_Transducer3Type
XDR_10_Measurment3Data
XDR_11_UnitsOfMeasure3
XDR_12_Transducer3
XDR_13_Transducer4Type
XDR_14_Measurment4Data
XDR_15_UnitsOfMeasure4
XDR_16_Transducer4
XDR_17_Transducer5Type
XDR_18_Measurment5Data
XDR_19_UnitsOfMeasure5
XDR_20_Transducer5
XDR_21_Transducer6Type
XDR_22_Measurment6Data
XDR_23_UnitsOfMeasure6
XDR_24_Transducer6
XDR_25_Transducer7Type
XDR_26_Measurment7Data
XDR_27_UnitsOfMeasure7
XDR_28_Transducer7
XDR_29_Transducer8Type
XDR_30_Measurment8Data
XDR_31_UnitsOfMeasure8
XDR_32_Transducer8
XTE_01_Status1
XTE_02_Status2
XTE_03_MagnitudeOfCrossTrackError
674
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
XTE_04_DirectionToSteer
XTE_05_Units
XTE_06_ModeIndicator
XTR_01_MagnitudeOfCrossTrackError
XTR_02_DirectionToSteer
XTR_03_Units
ZDA_01_UTC
ZDA_02_Day
ZDA_03_Month
ZDA_04_Year
ZDA_05_LocalZoneHours
ZDA_06_LocalZoneMinutes
ZDL_01_TimeToPoint
ZDL_02_DistanceToPoint
ZDL_03_TypeOfPoint
ZFO_01_UTC
ZFO_02_ElapsedTime
ZFO_03_OriginWaypointID
ZTG_01_UTC
ZTG_02_TimeToGo
ZTG_03_DestinationWaypointID
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
675
Omron FINS ETH
Omron FINS ETH
This driver supports the FINS protocol via Ethernet connection. For a list of models that support the FINS Communications
Service, refer to the manufacturer's website.
Protocol Editor Settings
Element Description
Alias
Name to be used to identify nodes in network configurations. The name will be added as a prefix
to each tag name imported for each network node
IP
address
The Ethernet IP address of the controller connected to the operator panel
Port
Defines the port number used in the communication with the PLC. The UDP Port number must
676
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
match the value specified in the PLC configuration; the default value is 9600. Most applications
will use the default value.
Network Parameters that define the FINS address of the device.
Node
There is a conversion rule to determine the IP address of a device starting from the FINS address
Unit
in the Omron network.
When using the FINS communication service, it is necessary to specify the node addressing
according to the FINS addressing scheme. Even in this case, data must be sent and received on
the Ethernet network using IP addresses. Therefore, IP addresses are converted from FINS
addresses.
There are three ways to convert the FINS addresses into the corresponding IP address; they are:
l
Automatic generation (default)
l
IP address table
l
Combined method (uses Automatic and IP address table)
The Omron documentation contains all the details related to determine the IP address of the
controller depending on the FINS address assigned to it. The next chapter shows an example of
controller configuration based on IP address table.
Panel
The Panel Network/Node/Unit parameters assigned to HMI should be compatible with the ones
Network assigned in the Omron network to the PLC:
Panel
Node
Panel
Unit
l
l
l
Network Number must match the one specified for the PLC
Node Number should match the last number of the IP address of the HMI; in the figure
above the panel has been configured with IP address 192.168.2.15.
Unit represent the possible different network cards over the same node; for the HMI
should be always set to zero since there is always only one communication unit.
The protocol supports the connections to multiple controllers.
To enable this, check the "PLC Network" check box and provide the configuration per each node.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
677
Omron FINS ETH
Controller Settings
The controller must be properly configured to handle the communication with the panel.
The next figure shows the screen of the Omron CX programming software from where you can define the network
parameters.
678
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
The figure below shows an example of configuration based on the IP address table conversion. The IP addresses used are
matching the HMI project settings screens as shown above.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
679
Omron FINS ETH
Tag Import
Exporting Tags from PLC
The Omron FINS Ethernet driver can import tag information from CX-Programmer PLC programming software. The tag
import filter accepts symbol files with extension “.cxr” created by the Omron programming tool.
The “.cxr” files can be exported from the symbol table utility.
See in figure how to access the Symbol Table (if configured) from the Omron programming software.
680
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
681
Omron FINS ETH
The following dialog shows which importer type can be selected.
Importer
Description
CX-Programmer v1.1
Linear
Requires a .cxrfile.
Tag Editor exported xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
682
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
683
Omron FINS ETH
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Aliasing Tag Names in Network Configurations
Tag names must be unique at project level; it often happens that the same tag names are to be used for different controller
nodes (for example when the HMI is connected to two devices that are running the same application). Since tags include
also the identification of the node and Tag Editor does not support duplicate tag names, the import facility in Tag Editor has
an aliasing feature that can automatically add a prefix to imported tags. With this feature tag names can be done unique at
project level.
The feature works when importing tags for a specific protocol. Each tag name will be prefixed with the string specified by
the “Alias”. As shown in the figure below, the connection to a certain controller is assigned the name “Node1”. When tags
are imported for this node, all tag names will have the prefix “Node1” making each of them unique at the network/project
level.
684
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note: aliasing tag names is only available when tags can be imported. Tags which are added manually in the Tag
Editor do not need to have the Alias prefix in the tag name.
The Alias string is attached to the tag name only at the moment the tags are imported using Tag Editor. If you
modify the Alias string after the tag import has been completed, there will be no effect on the names already
present in the dictionary. When the Alias string is changed and tags are imported again, all tags will be imported
again with the new prefix string.
Communication Status
The current communication status can be displayed using the dedicated system variables. Please refer to the User Manual
for further information about available system variables and their use.
The codes supported for this communication driver are:
Error
Notes
NAK
Returned in case the controller replies with a not acknowledge; can be returned also in case the
network/node/unit parameters contained in the PLC response are not matching with panel
configuration
Timeout
Returned when a request is not replied within the specified timeout period; ensure the controller
is connected and properly configured to get network access
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
685
Omron FINS ETH
Error
Notes
Invalid
The panel did receive from the controller a response, but its format or its contents is not as
response expected; ensure the data programmed in the project are consistent with the controller
resources. The same error can be returned also in case the PLC could not complete the
processing of the panel request and sent back to the panel and invalid/not completed response.
Cnt error
Returned when a specific control character in the protocol frame received does not match with
the corresponding one in the request; verify the proper settings of the controller network
configuration
General
Error
Error cannot be identified; should never be reported; contact technical support
686
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Omron FINS SER
This driver supports the FINS protocol via serial connetcion. For a list of models that support the FINS Communications
Service, refer to the manufacturer's website.
Protocol Editor Settings
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Element
Description
PLC
Models
PLC models available:
l
CJx/CSx/CP1x
Comm... If clicked displays the communication parameters setup dialog.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
687
Omron FINS SER
Element
Description
Element
Parameter
Port
Serial port selection.
l
l
l
COM1: device PLC port.
COM2: computer/printer port on panels with 2 serial ports or
optional Plug-In module plugged on Slot 1/2 for panels with 1
serial port on-board.
COM3: optional Plug-In module plugged on Slot 3/4 for panels
with 1 serial port on-board.
Baudrate, Parity,
Data Bits, Stop
bits
Serial line parameters.
Mode
Serial port mode. Available modes:
l
RS-232.
l
RS-485 (2 wires).
l
RS-422 (4 wires).
Tag Editor Settings
In Tag Editor select the protocol Omron FINS SER.
Add a tag using [+] button. Tag setting can be defined using the following dialog:
688
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Memory
Type
Offset
Memory Type
Description
I/O area
Corresponds to CIO resource on PLC
Auxiliary area
Corresponds to A resource on PLC
Holding area
Corresponds to H resource on PLC
Timer completion flags
Corresponds to T resource on PLC
Timer PVs
Corresponds to TPV resource on PLC
DM area
Corresponds to D resource on PLC
Counter completion area
Corresponds to C resource on PLC
Counter CVs
Corresponds to CVS resource on PLC
EM area
Corresponds to E resource on PLC
Work area
Corresponds to W resource on PLC
Index registers
Corresponds to IR resource on PLC
Data registers
Corresponds to DR resource on PLC
Starting address for the Tag. The possible range depend on memory type selected.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
689
Omron FINS SER
Element Description
Subind
ex
This parameter allow to select a single part of the resource if the selected data type is shorter
than the resource data type
Data
block
Instance of resource of the PLC.
Data
Type
Available data types:
l
boolean
l
byte
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
double
l
string
l
binary
See "Programming concepts" section in the main manual.
Note: To define arrays, select one of Data Type format followed by square brackets
(byte[], short[]…).
690
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Arraysi
ze
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
691
Omron FINS SER
Element Description
Valeur
Description
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Tag Import
Exporting Tags from PLC
The Omron FINS SER driver can import tag information from CX-Programmer PLC programming software. The tag import
filter accepts symbol files with extension “.cxr” created by the Omron programming tool.
The “.cxr” files can be exported from the symbol table utility.
See in figure how to access the Symbol Table (if configured) from the Omron programming software.
692
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
693
Omron FINS SER
The following dialog shows which importer type can be selected.
Importer
Description
CX-Programmer v1.1
Linear
Requires a .cxr file.
Tag Editor exported xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
All variables will be displayed at the same level.
Once the importer has been selected, locate the symbol file and click Open.
Tags included in the symbol file are listed in the tag dictionary. The tag dictionary is displayed at the bottom of the screen.
694
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Toolbar item
Description
Import Tag(s).
Select tags to be imported and click on this icon to add tags
from tag dictionary to the project
Update Tag(s).
Click on this icon to update the tags in the project, due a new
dictionary import.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
695
Omron FINS SER
Toolbar item
Description
Check this box to import all sub-elements of a tag.
Example of both checked and unchecked result:
Searches tags in the dictionary basing on filter combo-box
item selected.
696
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
OPC UA Client
Le pilote de communication OPC UA Client a été conçu pour connecter les périphériques IHM aux serveurs OPC UA.
Cette mise en œuvre du protocole s’effectue uniquement en tant que client.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
697
OPC UA Client
Élément
Description
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur.
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse
IP
Adresse IP du serveur.
Port
Numéro de port d'écoute du serveur.
Délai
d'attente
(ms)
Délai d’attente (en millisecondes) entre deux tentatives en cas d’absence de réponse du
périphérique serveur.
Certificat
de
serveur
Certificat de serveur à architecture unifiée OPC (format PEM). Lorsque l'élément est vide,
aucune sécurité n’est activée pour la communication.
URI
stratégie
de
serveur
URI (Uniform Resource Identifier) du point de terminaison demandé dans le serveur OPC.
Mode
sécurité
Type d’authentification :
Lorsque l'élément est vide, le point de terminaison par défaut sera utilisé. En temps normal,
aucune sécurité n’est activée pour le point de terminaison par défaut.
l
None : Aucune authentification avec le serveur et aucun cryptage de données.
l
Sign : Certificats utilisés uniquement pour l’authentification avec le serveur.
l
SignAndEncrypt : Certificats utilisés pour l’authentification avec le serveur et le
cryptage des données.
Note : configurez toujours le Mode sécurité en adéquation l’URI stratégie de
serveur. Par exemple, ne sélectionnez pas SignAndEncrypt pour un point de
terminaison qui ne prend pas en charge le cryptage.
Certificat
client
Certificat utilisé par le client OPC UA. Lorsque l'élément est vide, un certificat est généré
automatiquement.
Clé
privée du
client
Clé utilisée par le client OPC UA. Lorsque l'élément est vide, une clé est générée
automatiquement.
Modèles
d'API
Aucune option disponible.
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Dans la liste des protocoles, sélectionnez OPC UA Client.
2. Pour ajouter une variable, cliquez sur + : la boîte de dialogue de définition de variable s’affiche.
698
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Type de
donnée
s
Types de données disponibles :
l
boolean
l
octet
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
double
l
heure
l
uint64
l
int64
l
string
l
binary
Consultez la section « Concepts de programmation » du manuel principal.
Note : Pour définir des tableaux, sélectionnez l’un des formats de type de données
suivi de crochets.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
Conversion à appliquer à la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
699
OPC UA Client
Élément Description
sion
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
700
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Nom de
variable
Nom de la variable à utiliser dans la communication.
Note : Les propriétés des variables résultent du processus d’importation. Dans la plupart des cas, la création
manuelle d’une variable n’est pas nécessaire.
Ajouter un nom d’alias à un protocole
Les noms de variables doivent être uniques au niveau d’un projet. Vous pouvez cependant être amené à utiliser les mêmes
noms de variables pour différents nœuds de contrôleur (par exemple lorsque le périphérique IHM est connecté à deux
périphériques exécutant la même application).
Lorsque vous générez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables importés pour
ce protocole.
Dans l’exemple, la connexion à un certain contrôleur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le préfixe Nœud1, les rendant ainsi uniques au niveau projet/réseau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
701
OPC UA Client
Note : Vous pouvez donner un nom d’alias uniquement aux variables importées. Il n’est pas nécessaire pour les
variables ajoutées manuellement dans l'éditeur de variables de porter un préfixe d’alias dans leur nom.
Vous associez la chaîne d’alias à l’importation. Une fois l’importation des variables effectuée, une modification
de la chaîne d’alias n’aura aucun effet sur les noms figurant déjà dans le dictionnaire. Lorsque vous modifiez la
chaîne d’alias et réimportez les variables, toutes les variables réimportées porteront la nouvelle chaîne de
préfixe.
Importer les variables
Vous devez importer les variables depuis les serveurs à architecture unifiée OPC.
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Dans la liste des protocoles, sélectionnez OPC UA Client.
2. Cliquez sur Importer variable.
3. Sélectionnez Pilote d’importation hiérarchique.
4. Entrez l’adresse du serveur et cliquez sur Parcourir.
702
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
5. Une fois le processus de détection terminé, cliquez sur OK pour créer le dictionnaire de variables.
Voir la section « Mon premier projet » du manuel principal.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Description
Connexion <Error description>
Erreur durant la connexion
Connexion pendant lecture : <Error
description>
Erreur rencontrée lors d’une connexion pour une
opération de lecture
Mauvais état de lecture : <Error description>
Erreur dans l’opération de lecture
Connexion pendant écriture : <Error
description>
Erreur rencontrée lors d’une connexion pour une
opération d'écriture
Mauvais état d’écriture : <Error description>
Erreur dans l’opération d'écriture
Client OPC UA introuvable pour un ID de
nœud donné
Mauvaise information d’ID de nœud
<Error description> peut être l'une des erreurs suivantes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
703
OPC UA Client
Erreur
Notes
BadTimeout
Erreur dans le délai d’attente. Aucune réponse du serveur.
BadSecurityChecksFailed Erreur durant l’échange de certificats. Se produit généralement lorsque le
serveur ne considère pas le certificat client comme étant fiable.
BadCertificatexxxInvalid
Erreur dans le certificat client ou serveur.
BadNodeUnknown
La variable (nœud) n’existe pas.
BadAttributeNotFound
Tentative d’accès à un attribut non valide.
BadNotWritable
Tentative d'écriture dans un attribut en lecture seule.
704
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Simatic S7 PPI
Vous pouvez connecter vos périphériques IHM à la gamme d’API Simatic S7-200 de Siemens. Les ports de programmation
API établissent la communication grâce aux protocoles PPI et PPI+.
Ce document présente le protocole PPI+ et contient toutes les informations nécessaires pour une connexion réussie.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Élément
Description
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur (esclave).
ID de
panneau
Numéro de nœud du panneau opérateur.
ID
esclave
Numéro de nœud de l’API connectée.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
705
Simatic S7 PPI
Élément
Description
ID max
Disponible uniquement en cas d’utilisation du protocole PPI+. Contient le numéro de nœud le
plus élevé dans le réseau PPI+.
PPI+
Activé pour utiliser le protocole PPI+ au lieu du protocole PPI.
Délai
d'attente
(ms)
Délai d’attente entre deux tentatives d’envoi du même message lorsque le contrôleur n’envoie
aucune réponse.
706
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Modèles
d'API
De nombreux contrôleurs Siemens sont pris en charge. Consultez directement le logiciel de
programmation IDE pour une liste complète des contrôleurs pris en charge.
Comm…
En cliquant dessus, vous affichez la boîte de dialogue de configuration des paramètres de
communication.
Élément
Paramètre
Port
Sélection du port série.
Sur UN20 :
l
l
COM1 : port d’API du périphérique.
COM2 : Port de
l’ordinateur/imprimante
Sur UN31 ou UN30 :
l
l
l
COM1 : port série intégré
COM2 : module facultatif branché
au créneau 1/2
COM3 : module facultatif branché
au créneau 3/4
Débit en bauds, parité, bits de données, bits Paramètres de ligne série.
d’arrêt
Mode
Mode de port série. Modes disponibles :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
707
Simatic S7 PPI
Élément
Description
Élément
Paramètre
l
RS-232.
l
RS-485 (2 fils).
l
RS-422 (4 fils).
Paramètres de l’éditeur de variables
Dans l'éditeur de variables, sélectionnez Simatic S7 PPI dans la liste des protocoles définis, puis cliquez sur + pour ajouter
une variable.
Élément
Description
Type de
mémoire
Zone de l’API où se situe la variable.
Offset
Adresse d’offset où se situe la variable.
Sousind
ex
En cas de type de données booléen, il s’agit de l’offset d'un seul bit.
Type de
données
Types de données disponibles :
708
l
boolean
l
octet
l
short
l
int
l
unsignedByte
l
unsignedShort
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
l
unsignedInt
l
float
l
string
Consultez la section « Concepts de programmation » du manuel principal.
Taille de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets disponible pour
la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété Encoding est
réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un caractère
nécessite 2 octets.
Conversi
on
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions, listées cidessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
709
Simatic S7 PPI
Élément
Description
Valeur
Description
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche dans la liste
Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste
Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Connectivité PPI+
Vous pouvez connecter vos périphériques IHM à plus d’un CPU S7-200, et vous pouvez également connecter plus d’un
panneau opérateur à la même API.
Les panneaux opérateur n’interférerons pas avec la communication PPI+ entre les API.
710
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Le protocole PPI+ vous permet d’utiliser des configurations plus complexes qu’avec un protocole PPI standard.
Chaque API peut exécuter, lire et écrire des opérations vers et depuis d’autres API. Dans le même temps, vous pouvez
connecter plus d’un panneau au réseau PPI et accéder à toutes les variables des API.
Vous pouvez utiliser le logiciel de programmation API et effectuer une programmation en ligne sans interférer avec la
communication panneau-API.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contrôleur répond « Ne pas confirmer ».
-
Délai
d'attente
La requête n’a obtenu aucune réponse dans
le délai d’attente spécifié.
Vérifiez que le contrôleur est connecté et correctement
configuré pour accéder au réseau.
Réponse
non valide
Le contrôleur a envoyé une réponse ou un
contenu non valide au périphérique.
Vérifiez la cohérence entre les données programmées
dans le projet et les ressources du contrôleur.
Erreur
générale
Erreur non identifiable. Ne doit jamais être
signalée.
Contactez l’assistance technique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
711
Simatic S7 ETH
Simatic S7 ETH
Le pilote de communication Simatic S7 ETH a été conçu pour communiquer avec les contrôleurs Simatic via une
connexion Ethernet.
Le contrôleur Simatic doit être équipé soit d’un port Ethernet intégré, soit d’une interface Ethernet appropriée (intégrée ou
avec un module).
La communication se base sur les fonctions PG/OP (protocole ISO-on-TCP).
Le présent document décrit les paramètres de pilote à appliquer dans le logiciel de programmation IDE et API S7.
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole dans la liste API.
La boîte de dialogue de configuration du pilote s’affiche.
Élément
Description
Alias
Nom d’identification des nœuds dans les configurations réseau. Il est ajouté en préfixe à
chaque nom de variable importé pour chaque nœud réseau.
Adresse
IP
Adresse IP Ethernet du contrôleur.
Logement Numéro du créneau sur lequel est monté le processeur. 2 pour S7-300. Cette valeur peut être
plus grande pour des systèmes S7-400.
712
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément
Description
Modèles
d'API
Liste des modèles de contrôleurs compatibles. Assurez-vous de sélectionner le modèle d’API
correct dans cette liste lors de la configuration du protocole.
Réseau
d’API
Active l’accès aux contrôleurs multiples en réseau. Configurez la bonne option pour chaque
contrôleur (esclave).
Configuration avec les API S7-1200 et S7-1500
Les séries d’API S7-1200 (à partir de la version du logiciel 4.0) et S7-1500 de Siemens disposent d’un pare-feu intégré. Par
défaut, le niveau de protection maximal est activé. Pour établir la communication entre ces modèles d’API, vous devez
activer la communication S7 avec des périphériques tiers. Ce paramètre est disponible dans le logiciel de programmation
du portail TIA.
1. Ouvrez le projet de l’API dans le portail TIA.
2. Sélectionnez l’API dans l’arborescence du projet et ouvrez les Propriétés de l’API.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
713
Simatic S7 ETH
3. En général > La protection choisit une permission entre les trois premiers (assurez-vous que l’encoche soit présente
sur la colonne IHM).
Note : Si « Pas d'accès » est sélectionné, la communication avec le panneau ne sera pas établie.
714
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
4. Faites défiler la page vers le bas et cochez la case « Autoriser l’accès via la communication PUT/GET par des
partenaires distants ».
Note : Si vous avez défini des variables dans « Blocs de programme », vous devez configurer le DB comme
étant « Non optimisé ».
Pour vérifier ou modifier l’optimisation du DB, ouvrez les Propriétés du DB :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
715
Simatic S7 ETH
Dans l’onglet Général > Attributs, décochez la case « Accès au bloc optimisé » :
716
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Si la case « Accès au bloc optimisé » n’est pas activée (grisée), cela peut signifier que le DB est un « DB d’instance » relié
à un « FB à accès optimisé ».
Une fois le projet compilé, l’offset de variable s’affiche à côté du nom de la variable.
Ces paramètres s’appliquent au logiciel de programmation du portail TIA et aux gammes d’API S7-1200 (à partir de la
version du logiciel 4.0) et S7-1500.
Configuration avec l’API Logo!
Pour configurer la communication avec l’API Logo! :
1. Ouvrez le projet Logo!Soft Comfort.
2. Sélectionnez Outils > Connexions Ethernet : la boîte de dialogue Configurer les connexions Ethernet s‘affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
717
Simatic S7 ETH
3. Faites un clic droit sur Connexions Ethernet et ajoutez une connexion serveur.
4. Double-cliquez sur la nouvelle connexion : la boîte de dialogue des propriétés de cette connexion s’affiche.
5. Sélectionnez les options Connexion au pupitre opérateur (OP) et Accepter toutes les demandes de
connexion.
6. Dans la section Propriétés distantes (Client), configurez le TSAP sur 02.00.
718
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Exporter un fichier ASC avec Simatic STEP7
Le filtre d’importation de variables Simatic S7 Ethernet accepte les fichiers de symboles (au format ASCII .asc) et les
fichiers sources (dont l’extension est .awl) générés par Simatic Step7. Vous pouvez préalablement exporter le fichier de
symboles grâce à l’utilitaire de la table des mnémoniques de Step7.
Vous pouvez exporter les fichiers de symboles (.asc) depuis l’utilitaire de la table des mnémoniques.
1. Dans l'éditeur de mnémoniques, sélectionnez le menu Table des mnémoniques et cliquez sur Exporter.
2. Donnez un nom à la table des mnémoniques et enregistrez-la au format de fichier ASCII.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
719
Simatic S7 ETH
Exporter des fichiers sources
Vous pouvez générer ces fichiers en exportant du code source.
1. Ouvrez n’importe quel bloc de programme dans l’éditeur (« OB1 » dans l’exemple ci-dessous).
2. Dans le menu Fichier, cliquez sur Générer un fichier source. La boîte de dialogue suivante s’affiche :
1. Donnez-lui un nom (« Sources » dans l’exemple) et cliquez sur OK : la boîte de dialogueGénérer le fichier source
Sources s’affiche.
720
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
2. Cliquez sur Tous > afin de générer un fichier source pour tous les blocs.
3. Sélectionnez les options suivantes :
l
Inclure les blocs de référence
l
Trier en fonction de la structure du programme
l
Adresse Symbolique
4. Cliquez sur OK pour confirmer : l'objet « Sources » est généré dans le projet Step7, comme dans l’exemple.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
721
Simatic S7 ETH
5. Faites un clic droit sur l’objet et sélectionnez Exporter Sources.
Vous pouvez importer le fichier .awl généré dans l’éditeur de variable.
Note : Le fichier .awl contient des informations supplémentaires dont ne dispose pas le fichier .asc exporté à
partir de la table des mnémoniques.
Assurez-vous que la table des mnémoniques contient une référence à tous les blocs de données. Vous pouvez importer les
variables d’un bloc de données uniquement lorsque la table des mnémoniques contient une ligne mentionnant le nom du
bloc de données et les commentaires le concernant.
722
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Chaque entrée permet au filtre d’importation d'importer les variables se rapportant au bloc de données concerné.
Exporter des fichiers TIA, XLSX, SCL et UDT avec le portail TIA
Exporter des fichiers .tia
Ces fichiers se rapportent aux variables DB définies dans Blocs de programme.
1. Définissez le bloc de données comme étant Non optimisé.
2. Faites un clic droit sur le bloc de données et sélectionnez Propriétés :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
723
Simatic S7 ETH
3. Dans l’onglet Général, sélectionnez Attributs et désélectionnez Accès au bloc optimisé.
724
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Si l’option Accès au bloc optimisé n’est pas activée (case à cocher grisée), cela peut signifier que le
bloc de données est un « DB d’instance » relié à un « FB à accès optimisé ».
4. Construisez le projet afin de vous assurer que le portail TIA calcule l’offset des variables.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
725
Simatic S7 ETH
5. Double-cliquez sur le nom d’un DB.
6. Agrandissez la zone de visualisation du bloc de programme sélectionné.
7. Sélectionnez toutes les lignes.
8. Faites un copier-coller dans n’importe quel éditeur de texte.
9. Enregistrer le fichier sous DBxxx.tia, où xxx correspond au numéro du DB.
Note : Assurez-vous d’utiliser la fonction Enregistrer sous, sinon le fichier sera nommé DB2.tia.txt et ne sera
pas visible depuis le pilote d’importation.
10. Répétez à partir de l'étape 5 pour tous les blocs de programme.
Note : Assurez-vous que seules les colonnes suivantes sont affichées dans l'éditeur DB avant de copier toutes
les données dans le fichier txt
Exporter des fichiers .xlsx
Un fichier Excel fait référence à des variables API.
1. Double-cliquez sur Afficher toutes les variables : la table des variables s’affiche.
726
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
2. Cliquez sur le bouton Exporter et indiquez un chemin d’accès.
3. Donner un nom au fichier.
4. Cliquez sur Enregistrer pour confirmer.
5. Cliquez sur OK pour exporter.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
727
Simatic S7 ETH
Exporter des fichiers .scl ou udt
Pour générer le fichier, agrandissez l'élément Type de données API de l’arborescence du projet du portail TIA et faites un
clic droit sur la structure définie par l’utilisateur. Cliquez ensuite sur Générer un fichier source à partir des blocs.
728
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
En cas de multiples UDT définis dans le projet de l’API, vous devez tous les sélectionner dans la liste Type de données
API, faire un clic droit et sélectionner Générer un fichier source à partir des blocs pour créer le fichier .scl contenant
touts les UDT définis.
À l'étape suivante, donnez un nom au fichier .scl et indiquez un chemin d’accès où l’enregistrer.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
729
Simatic S7 ETH
Le fichier contiendra tous les UDT définis, et vous pourrez l’utiliser pour importer des variables dans l’éditeur.
Consultez le chapitre Importation de variables pour plus d'informations.
Paramètres de l’éditeur de variables
Dans l'éditeur de variables, sélectionnez « Simatic S7 ETH » dans la liste des protocoles définis, puis cliquez sur + pour
ajouter une variable.
730
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Type de
mémoir
e
Zone de l’API où se situe la variable.
Type de données
Type Simatic
Mémoire interne
M
Bloc de données
DB
Entrée
I (E)
Sortie
O (A)
Valeur de minuterie
T
Contre-valeur
C
Offset
Adresse d’offset où se situe la variable.
Sousin
dex
Offset de ressource au sein du registre.
Bloc de
donnée
s
Numéro de bloc de données pour le type de mémoire de bloc de données.
Type de
donnée
s
Types de données disponibles :
l
boolean
l
octet
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
string
Consultez la section « Concepts de programmation » du manuel principal.
Note : Pour définir des tableaux, sélectionnez l’un des formats de type de données
suivi de crochets.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
731
Simatic S7 ETH
Élément Description
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD ->
CDAB
732
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S5Timer(BCD)
Utilisé pour prendre en charge S5Timer. Pour plus d'informations, consultez
la section Type de données Simatic S5Timer.
S5Timer(BIN)
Transformation héritée de S5Timer au format binaire.
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Ajouter un nom d’alias à un protocole
Les noms de variables doivent être uniques au niveau d’un projet. Vous pouvez cependant être amené à utiliser les mêmes
noms de variables pour différents nœuds de contrôleur (par exemple lorsque le périphérique IHM est connecté à deux
périphériques exécutant la même application).
Lorsque vous générez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables importés pour
ce protocole.
Dans l’exemple, la connexion à un certain contrôleur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le préfixe Nœud1, les rendant ainsi uniques au niveau projet/réseau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
733
Simatic S7 ETH
Note : Vous pouvez donner un nom d’alias uniquement aux variables importées. Il n’est pas nécessaire pour les
variables ajoutées manuellement dans l'éditeur de variables de porter un préfixe d’alias dans leur nom.
Vous associez la chaîne d’alias à l’importation. Une fois l’importation des variables effectuée, une modification
de la chaîne d’alias n’aura aucun effet sur les noms figurant déjà dans le dictionnaire. Lorsque vous modifiez la
chaîne d’alias et réimportez les variables, toutes les variables réimportées porteront la nouvelle chaîne de
préfixe.
Type de données chaîne
Dans l’API Simatic S7, deux différents types de variables gèrent les variables chaîne :
l
sous forme de tableau [1..xx] de caractères,
l
sous forme de chaîne[xx].
L’exemple suivant présente la déclaration de chaîne sous Step7 :
L’exemple suivant présente la déclaration de chaîne sous le portail TIA :
734
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Lorsque vous utilisez le type de données chaîne[xx], vous devez appliquer une conversion spécifique à la
variable. Par contre, lorsque vous utilisez l’outil d’importation pour importer le dictionnaire de variables depuis le
portail TIA ou Step7, la conversion des variables chaîne est automatique et aucune autre action ne vous sera
demandée.
Pour ajouter une chaîne sous forme de tableau de caractères :
1. Appuyez sur + dans l'éditeur de variables.
2. Dans Type de données, sélectionnez chaîne.
3. Dans Taille de tableau, entrez la longueur de chaîne.
4. Cliquez sur OK pour confirmer.
Pour ajouter un type de données chaîne :
1. Appuyez sur + dans l'éditeur de variables.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
735
Simatic S7 ETH
2. Dans Type de données, sélectionnez chaîne.
3. Dans Taille de tableau, entrez la longueur de chaîne.
4. Cliquez sur +/- pour ouvrir la boîte de dialogue Conversion.
5. Dans cette boîte de dialogue, sélectionnez le type de conversion Chaîne S7.
736
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
6. Cliquez sur + pour ajouter la conversion, qui s’affiche alors dans la liste Configurée sur la droite.
7. Cliquez sur OK pour confirmer.
Type de données Simatic S5Timer
Les pilotes Simatic prennent en charge un type de données spécial : S5Timer.
Vous devez configurer la variable avec un type de données spécifique et appliquer une conversion à cette variable afin de
pouvoir lire/écrire correctement une variable Simatic S5Timer.
1. Dans l’éditeur de variables, cliquez sur + pour ajouter une variable.
2. Dans Type de données, sélectionnez unsignedInt.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
737
Simatic S7 ETH
3. Cliquez sur +/- pour ouvrir la boîte de dialogue Conversion.
4. Dans cette boîte de dialogue, sélectionnez le type de conversion S5timer(BCD).
5. Cliquez sur + pour ajouter la conversion, qui s’affiche alors dans la liste Configurée sur la droite.
738
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
6. Cliquez sur OK pour confirmer.
IP d'écrasement de nœud
Le protocole propose le type de données spécial IP d’écrasement de nœud, qui vous permet de modifier l’adresse IP du
contrôleur cible au moment du runtime.
Ce type de mémoire est un tableau de 4 octets non signés, un pour chaque octet de l’adresse IP.
L’IP d'écrasement de nœud est initialisée avec la valeur de l’IP du contrôleur spécifiée dans le projet au moment de la
programmation.
IP d'écrasement de
nœud
Opération Modbus
0.0.0.0
La communication avec le contrôleur est coupée, plus aucune trame de requête ne
sera générée.
Autre que 0.0.0.0
Interprétée comme étant l’écrasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le périphérique IHM est connecté à un réseau avec plus d’un nœud de contrôleur, chaque nœud dispose de sa
propre variable d’IP d'écrasement de nœud.
Note : Le maintien des valeurs de l’IP d'écrasement de nœud assignées au moment du runtime est assuré par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
739
Simatic S7 ETH
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La boîte de dialogue suivante affiche le type de pilote d’importation que vous pouvez sélectionner.
740
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Step7 v1.0
Linéaire
Nécessite un fichier .asc.
Pour plus d’informations, consultez la section Exporter un fichier ASC
avec Simatic STEP7.
Toutes les variables s’affichent au même niveau.
Portail TIA v1.0
Linéaire
Nécessite des fichiers .tia, .xlsx, .scl (facultatif) et .udt (facultatif).
Pour plus d'informations, consultez la section Exporter des fichiers TIA,
XLSX, SCL et UDT avec le portail TIA.
Toutes les variables s’affichent au même niveau.
Fichier .xml exporté de
l'éditeur de variables
Sélectionnez ce pilote d’importation pour lire un fichier XML générique
exporté de l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
741
Simatic S7 ETH
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
État de communication
Vous pouvez afficher l'état de communication actuel grâce aux variables système. Voir la section « Variables système »
du manuel principal.
Codes pris en charge par ce pilote de communication :
Erreur
Cause
Action
NAK
Le contrôleur répond « Ne pas confirmer ».
-
Délai
d'attente
La requête n’a obtenu aucune réponse dans
le délai d’attente spécifié.
Vérifiez que le contrôleur est connecté et correctement
configuré pour accéder au réseau.
742
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Erreur
Cause
Action
Réponse
non valide
Le contrôleur a envoyé une réponse ou un
contenu non valide au périphérique.
Vérifiez la cohérence entre les données programmées
dans le projet et les ressources du contrôleur.
Erreur
générale
Erreur non identifiable. Ne doit jamais être
signalée.
Contactez l’assistance technique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
743
Simatic S7 MPI
Simatic S7 MPI
HMI products support direct Siemens MPI communication without any additional module.
The driver supports the standard communication speed 187Kbit/s.
here is a minimum requirement also for the version of operating system running in the HMI (this is normally referenced as
BSP version). See in user manual how to read the BSP version with the System Settings menu. The minimum
requirements are shown in the following table.
Platform
BSP version
UN20 devices
V2.59 or newer
UN30/UN31 devices
V1.38 or newer
Protocol Editor Settings
Add [+] a driver in the Protocol editor and select the “Simatic S7 MPI” protocol from the list of available protocols.
The protocol type can be selected from the dedicated combo box in the dialog.
Element
Description
Alias
Name to be used to identify nodes in the plc network configuration. The name will be added
as a prefix to each tag name imported for each network node.
Timeout
(ms)
Defines the time inserted by the protocol between two retries of the
744
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element
Description
same message in case of missing response from controller.
Value is expressed in milliseconds.
Panel MPI
Address
MPI node number assigned to the device.
Highest MPI The highest node number in the MPI network where the device is operating and
Address
communicating.
PLC MPI
Address
The MPI address of the controller to which the device needs to communicate.
PLC Models List of compatible controller models. Make sure to select the correct PLC model in this list
when configuring the protocol.
Comm…
Click on this button to configure the serial port on the device to be used as MPI port (see
example in the following figure)
Communication parameters for Simatic S7 MPI are fixed at:
l
Baud rate=187500
l
Parity=Even
l
Data=bits8
l
Stop=bit1
On UN20:
l
com1 is the HMI port labeled “PLC”,
l
com2 is the HMI port labeled “PC/Printer”
On UN31 or UN30:
l
com1 is the integrated serial port,
l
com2 is an add-on module plugged in Slot#1 or #2
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
745
Simatic S7 MPI
Element
Description
l
com3 is an add-on module plugged in Slot#3 or #4
Note: The connection between device and PLC can be made with the following
two options:
1. Creating a custom cable following the scheme provided with document CA255
“eTOP400/500 serie PLC Port to MPI Port”
2. Using a standard MPI cable with ADP-0001 “MPI wiring adapter”
PLC
Network
The protocol supports connection to multiple controllers. To enable this option, check the
"PLC Network" check box and enter the configuration per each controller node.
Export ASC File Using Simatic STEP7
The Simatic S7 Ethernet tag import filter accepts symbol files (ASCII format .asc) and source files (.awl extension) created
by the Simatic Step7. The symbol file can be previously exported using the Step7 symbol table utility.
Symbol files (.asc) can be exported from the symbol table utility.
1. From the Symbol Table menu in the Symbol Editor choose Export.
2. Assign a name and save the symbol table as ASCII file.
746
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Exporting sources
These files are created exporting source code.
1. Open any program block in the editor, "OB1" in this example.
2. From the File menu choose Generate Source: the following dialog is displayed:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
747
Simatic S7 MPI
1. Assign a name, "Sources" in the example, and click OK: the Generate source Sources dialog is displayed.
2. Click All > to generate source for all blocks.
3. Select the following options:
l
Include reference blocks
l
Sort according to program structure
l
Symbolic address
4. Click OK to confirm: the "Sources" object is generated in the Step7 project as in the example.
748
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
5. Right click on the object and select Export Sources.
The generated .awl file can be imported in the Tag Editor.
Note: The .awl file contains additional information not included in the .asc file exported from the symbol table.
Make sure that reference to all data blocks is inserted in the symbol table. The tags from a data block are imported only if
the symbol table contains a line with the data block name and related comment.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
749
Simatic S7 MPI
Each entry enables the import filter to import the tags related to the specified data block.
Export TIA, XLSX, SCL, UDT Files Using TIA Portal
Exporting .tia files
These files refer to DB tags defined in Program blocks.
1. Configure the Data Block as Not optimized.
2. Right-click on the Data Block and choose Properties:
750
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
3. In the General tab select Attributes and unselect Optimized block access.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
751
Simatic S7 MPI
Note: If the options Optimized block access is not enabled (checkbox grayed out) this might mean that the
Data Block is an "instance DB" linked to an "optimized access FB".
4. Build the project to make sure TIA Portal calculates the tags offset.
752
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
5. Double-click on a DB name.
6. Expand the view of program block selected.
7. Select all rows.
8. Copy and paste into any text editor.
9. Save the file as DBxxx.tia, where xxx=number of DB.
Note: Make sure you use the Save As function or the file will be named DB2.tia.txt and will not be visible from
the importer.
10. Repeat from step 5 for all program blocks.
Note: Make sure that only the following columns are shown in DB editor before copying all data in the txt file
Exporting .xlsx files
An Excel file refers to PLC tags.
1. Double-click Show all tags: the tag table is displayed.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
753
Simatic S7 MPI
2. Click the Export button and browse for path file.
3. Define file name.
4. Click Save to confirm.
5. Click OK to export.
754
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Exporting .scl or udt files
To create the file, expand PLC Data Type item from TIA Portal project tree and right click on the user defined structure.
Then click on Generate source from blocks.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
755
Simatic S7 MPI
In case of multiple UDT defined in PLC project, it is necessary to select them all from PLC Data Type list, right click and
select Generate source from blocks to create the .SCL file that contains all the UDT defined.
In the next step, give a name to the .SCL file and choose the path to where to save the file.
756
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
This file will content all the UDT definition and it can be used for importing tags in Tag Editor.
Check Tag Import chapter for more details.
Tag Editor Settings
Into Tag editor select the protocol “Simatic S7 MPI” from the list of defined protocols and add a tag using [+] button.
Tag settings can be defined using the following dialog:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
757
Simatic S7 MPI
Element Description
Memory Area of PLC where tag is located.
Type
Data Type
Simatic Type
Internal Memory
M
Data Block
DB
Input
I (E)
Output
O (A)
Timer value
T
Counter value
C
Offset
Offset address where tag is located.
SubInd
ex
In case of Boolean data type, this is the offset of single bit.
Data
Block
If Memory Type is “Data Block”, this will identify the DB number.
Data
Type
758
Data Type
Memory Space
Limits
boolean
1 bit data
0 ... 1
byte
8-bit data
-128 ... 127
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Data Type
Memory Space
Limits
short
16-bit data
-32768 ... 32767
int
32-bit data
-2.1e9 ... 2.1e9
unsignedByte
8-bit data
0 ... 255
unsignedShort
16-bit data
0 ... 65535
unsignedInt
32-bit data
0 ... 4.2e9
float
IEEE single-precision
1.17e-38 ... 3.40e38
32-bit floating point type
string
Refer to “String data type channel”
Note: to define arrays, select one of Data Type format followed by square brackets like
“byte[]”, “short[]”…
Arraysi
ze
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion to be applied to the tag.
Depending on data type selected, the Allowed list shows one or more conversions, listed below.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
759
Simatic S7 MPI
Element Description
Value
Description
Inv bits
Invert all the bits of the tag.
Example:
1001 → 0110 (in binary format)
9 → 6 (in decimal format)
Negate
Set the opposite of the tag value.
Example:
25.36 → -25.36
AB -> BA
Swap nibbles of a byte.
Example:
15D4 → 514D (in hexadecimal format)
5588 → 20813 (in decimal format)
ABCD -> CDAB
Swap bytes of a word.
Example:
9ACC → CC9A (in hexadecimal format)
39628 → 52378 (in decimal format)
ABCDEFGH ->
GHEFCDAB
Swap bytes of a double word.
ABC...NOP ->
OPM...DAB
Swap bytes of a long word.
BCD
Separate the byte in two nibbles, and reads them as decimal (from 0 to 9)
Example:
32FCFF54 → 54FFFC32 (in hexadecimal format)
855441236 → 1426062386 (in decimal format)
Example:
142.366 → -893553517.588905 (in decimal format)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(in binary format)
Example:
23 → 17 (in decimal format)
0001 0111 = 23
0001 = 1 (first nibble)
0111 = 7 (second nibble)
760
S5timer(BCD)
Used to support S5timer. Check Simatic S5timer special data type for
more details.
S5timer(BIN)
Legacy transformation for S5timer in binary format.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Select the conversion and click on plus button. The selected item will be added on Configured
list.
If more conversions are configured, they will be applied in order (from top to bottom of
Configured list).
Use the arrow buttons to order the configured conversions.
Aliasing Tag Names in Network Configurations
Tag names must be unique at project level; it often happens that the same tag names have to be used for different controller
nodes (for example when the HMI is connected to two devices that are running the same application). Since tags include
also the identification of the node and Tag Editor does not support duplicate tag names, the import facility in Tag Editor has
an aliasing feature that can automatically add a prefix to imported tags. With this feature tag names can be done unique at
project level.
The feature works when importing tags for a specific protocol. Each tag name will be prefixed with the string specified by
the “Alias”. As shown in the figure below, the connection to a certain controller is assigned the name “Node1”. When tags
are imported for this node, all tag names will have the prefix “Node1” making each of them unique at the network/project
level.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
761
Simatic S7 MPI
Note: Aliasing tag names are only available when tags can be imported. Tags which are added manually in the
Tag Editor do not need to have the Alias prefix in the tag name.
The Alias string is attached to the tag name only at the moment the tags are imported using Tag Editor. If Alias
string is modified after the tag import has been completed, there will be no effect on the names already present in
the dictionary. When the Alias string is changed and tags are imported again, all tags will be imported again with
the new prefix string.
String data type
In Simatic S7 PLC it's possible to define two different types of tags to manage string variables.
l
as Array [1..xx] of Chars.
l
as String[xx].
Step7 string declaration is showed in the following figure:
TIA Portal string declaration is showed in the following figure:
Note: Usage of String[xx] data type is allowed but a specific Conversion must be applied to the tag. Anyway
using tag importer to import tag dictionary from TIA Portal or Step7 string tags are automatically configured and
no changes/conversion are needed.
To manually add an "Array [1..xx] of Chars" data type tag, press the [+] button in the Tag Editor, then select "string" as
Data Type of the Tag and type the string length in the "Arraysize" field:
762
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
and confirm with OK button.
To manually add a "String[xx]" data type tag, press the [+] button in the Tag Editor, then select "string" as Data Type of the
Tag and type the string length in the "Arraysize" field,
then click on [+/-] button to open the Conversion dialog.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
763
Simatic S7 MPI
Into conversion dialog:
l
select the "S7 String" conversion type
l
click on [+] button to add the conversion.
The conversion will be listed into the Configured window on the right.
Confirm with OK button.
764
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Simatic S5timer data type
Simatic drivers support a special data type, called S5Timer.
The tag must be configured with a specific data type and a conversion must be applied to the Tag to correctly read/write a
Simatic S5Timer Variable.
Open the Tag Editor and add a Tag pressing the Plus button.
Select “unsignedInt” as Data Type of the Tag.
Click on +/- button to open the Conversion dialog.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
765
Simatic S7 MPI
In the Conversion dialog select the S5timer(BCD) conversion type [A] then click on Plus button [B] to add the conversion,
the configured conversion will be listed into the Configured window on the right. Then confirm with OK.
Tag Import
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
766
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
The following dialog shows which importer type can be selected.
Importer
Description
Step7 v1.0
Linear
Requires an .ascfile.
Check Export ASC File Using Simatic STEP7 for more details.
All variables will be displayed at the same level.
TIA Portal v1.0
Linear
Requires .tia, .xlsx, .scl (optional), .udt (optional) files.
Check Export TIA, XLSX, SCL, UDT Files Using TIA Portal for more
details.
All variables will be displayed at the same level.
Tag Editor exported xml
Sélectionnez ce pilote d’importation pour lire un fichier XML générique exporté
de l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
767
Simatic S7 MPI
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
768
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
Communication status
The communication status can be displayed using the dedicated system variables. Please refer to the User Manual for
further information about available system variables and their use.
The status codes supported for this communication driver are:
Error
Notes
NAK
Controller replies with a not acknowledge.
Timeout
Request is not replied within the specified timeout period; ensure the controller is connected and
properly configured for network access
Invalid
The device did receive from the controller a response, but its format or its contents or its length
response is not as expected; ensure the data programmed in the project are consistent with the controller
resources.
General
Error
Error cannot be identified; should never be reported; contact technical support
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
769
Variables
Variables
Le pilote de communication de variables permet de définir des variables qui pointe vers la mémoire interne IHM.
Les Variables ne sont pas rétentrices : lorsque le projet démarre, la valeur de départ de toutes les variables Tag est 0 (ou ""
en cas de variable de chaîne).
Le pilote de communication de variables n’est pas compté comme protocole physique.
Se référer au Tableau des fonctions et limites de manuel principal dans la ligne « Nombre de protocoles
physiques ».
Paramètres de l’éditeur du protocole
Ajouter un protocole
Pour configurer le protocole :
1. Dans le nœud Config, double-cliquez sur Protocoles.
2. Pour ajouter un pilote, cliquez sur + : une nouvelle ligne apparaît.
3. Sélectionnez le protocole Variables dans la liste API.
Paramètres de l’éditeur de variables
Chemin : VueProjet> Configuration > double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne apparaît.
2. Sélectionnez Variables dans la liste des protocoles : le dialogue de définition de variables s'affiche.
770
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Type de
donnée
s
Type de données
Espace mémoire
Limites
boolean
Donnée à 1 bite
0 ... 1
octet
Donnée à 8 bite
-128 ... 127
short
Donnée à 16 bite
-32768 ... 32767
int
Donnée à 32 bite
-2.1e9 ... 2.1e9
int64
Donnée à 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donnée à 8 bite
0 ... 255
unsignedShort
Donnée à 16 bite
0 ... 65535
unsignedInt
Donnée à 32 bite
0 ... 4.2e9
uint64
Donnée à 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
précision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
précision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des éléments contenant du code de caractères défini
par l'encodage sélectionné
binary
Données binaires arbitraires
Remarque : pour définir des tableaux, sélectionnez l’un des formats de type de
données suivi de crochets tels que « byte[] », « short[] », etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propriété représente le nombre d’éléments vectoriels.
En cas de variable de chaîne, cette propriété représente le nombre maximum d’octets
disponible pour la variable de chaîne.
Remarque : le nombre d'octets correspond au nombre de caractères de chaîne si la propriété
Encoding est réglée sur UTF-8 ou Latin1 dans Tag Editor.
Si la propriété Encoding est réglée sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caractère nécessite 2 octets.
Conver
sion
Conversion à appliquer à la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
771
Variables
Élément Description
En fonction du type de données choisi, la liste Autorisée affiche une ou plusieurs conversions,
listées ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format décimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -> BA
Échange les quartets d’un octet.
Exemple :
15D4 → 514D (format hexadécimal)
5588 → 20813 (format décimal)
ABCD -> CDAB
Échange les octets d’un mot.
Exemple :
9ACC → CC9A (format hexadécimal)
39628 → 52378 (format décimal)
772
ABCDEFGH ->
GHEFCDAB
Échange les octets d'un mot double.
ABC...NOP ->
OPM...DAB
Échange les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexadécimal)
855441236 → 1426062386 (format décimal)
Exemple :
142,366 → -893553517,588905 (format décimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
Sépare l’octet en deux quartets et les lit au format décimal (de 0 à 9)
Exemple :
23 → 17 (format décimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
Sélectionnez la conversion et cliquez sur le bouton plus. La conversion sélectionnée s’affiche
dans la liste Configurée.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configurée).
Utilisez les boutons de direction pour changer l’ordre des conversions configurées.
Importation des variables
Sélectionnez le pilote dans l'éditeur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
Le système aura besoin d’un fichier XML générique exporté de l'éditeur de variables avec le bouton approprié.
Lorsque vous avez sélectionné le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont listées dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’écran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
773
Variables
Élément de la barre d’outils
Description
Importer variables.
Sélectionnez les variables à importer et cliquez sur cette
icône pour ajouter les variables du dictionnaire au projet.
Mettre à jour variables.
Cliquez sur cette icône pour mettre à jour les variables du
projet grâce à un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-éléments
d’une variable.
Exemples de résultats avec la case cochée et non cochée :
774
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
49 Protocoles de communication
Élément de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'élément sélectionné dans la liste déroulante.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | © 2012-2017 DEIF A/S
775
">