AGI 400 | Deif AGI 300 Advanced graphical interface Manuel utilisateur

Ajouter à Mes manuels
784 Des pages
MANUEL DE L'UTILISATION
Advanced Graphical Interface
AGI 300/400 series
DEIF A/S &middot; Frisenborgvej 33 &middot; DK-7800 Skive
Tel.: +45 9614 9614 &middot; Fax: +45 9614 9615
info@deif.com &middot; www.deif.com
Document no.: 4189341104A
SW version
Ce document n'est pas &agrave; jour. Une version plus r&eacute;cente est disponible en anglais sur www.deif.com.
&copy; 2012-2017 DEIF A/S
Nous nous r&eacute;servons le droit d'apporter des modifications &agrave; ce document &agrave; tout moment
et sans pr&eacute;avis
Les informations contenues dans ce document sont exclusivement &agrave; titre d'information.
Bien que nous ayons entrepris tous les efforts raisonnables pour v&eacute;rifier que les
informations contenues dans le pr&eacute;sent document soient exactes, elles sont fournies
telles quelles (&laquo; as is &raquo;) et sans garantie quelle qu'elle soit.
Les marques et noms d&eacute;pos&eacute;s de tiers sont la propri&eacute;t&eacute; de leurs d&eacute;tenteurs respectifs.
Microsoft&reg;, Win32, Windows&reg;, Windows XP, Windows Vista, Windows 7, Windows 8,
Visual Studio sont des marques d&eacute;pos&eacute;es ou des marques de la Microsoft Corporation
aux &Eacute;tats-Unis et dans d'autres pays. Les autres produits ou noms d'entreprises
figurant dans ce document peuvent &ecirc;tre des marques qui sont la propri&eacute;t&eacute; de leurs
d&eacute;tenteurs respectifs.
Tous les noms d'entreprises, d'institutions, de produits et de domaines, adresses email, logos, personnes, lieux et &eacute;v&eacute;nements cit&eacute;s &agrave; titre d'exemple dans ce document
sont fictifs. Ils ne contiennent aucune allusion, ni intentionn&eacute;e ni sous-entendue, &agrave; une
entreprise, institution, produit, nom de domaine, adresse e-mail, logo, personne, lieu ou
&eacute;v&eacute;nement r&eacute;el.
Contenu
1
2
2
3
4
Premiers pas
1
Suppositions
6
Propri&eacute;t&eacute;s de projet
59
2
Volet des propri&eacute;t&eacute;s de projet
60
Installer l’application
2
Outils de d&eacute;veloppement
62
Runtime
7
Rendu des polices FreeType
65
Param&egrave;tres de base du p&eacute;riph&eacute;rique IHM
8
Modules de plug-in de logiciels
66
Options de menu contextuel
8
Comportement
66
&Eacute;v&eacute;nements
71
Le simulateur IHM
73
Service SNTP int&eacute;gr&eacute;
11
Runtime sur PC
12
Probl&egrave;mes habituels d’installation
15
M&eacute;thodes de simulation des donn&eacute;es
74
Mon premier projet
19
Param&egrave;tres du simulateur
74
L’espace de travail
20
Lancer et arr&ecirc;ter le simulateur
75
Cr&eacute;er un projet
20
Transf&eacute;rer le projet au p&eacute;riph&eacute;rique IHM
77
Protocoles de communication
22
T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM
78
Concevoir une page
24
Paquet de mise &agrave; 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&egrave;me
85
Importer les variables
30
Variables d'alarmes
87
Associer un widget &agrave; des variables
33
Variables du signal sonore
87
Pages de dialogues
35
Variables de communication
88
Concepts de programmation
37
Variables de passage &agrave; l'heure d'&eacute;t&eacute;
88
Types de donn&eacute;es
38
Variables p&eacute;riph&eacute;riques
89
Param&egrave;tres &laquo; Associer &agrave; &raquo;
38
Variables informations de vidage
91
&Eacute;v&eacute;nements
43
Variables client FTP
92
Positionnement des widgets
46
Variables clavier
92
Gestion widgets chevauchants
47
Variables r&eacute;seau
92
Grouper des widgets
48
Variables d’impression
93
Changer les propri&eacute;t&eacute;s de plusieurs widgets
54
Variables client &agrave; distance
94
Variables de version
94
Variable &eacute;cran
95
Changer la propri&eacute;t&eacute; couleur de remplissage
en fonction des valeurs de variable
57
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
7
8
9
I
10
11
Variables carte SD
95
Variables serveur
95
Variables d’heure
96
Variables &eacute;cran tactile
96
Variables lecteur USB
98
Variables de gestion des utilisateurs
98
Variables syst&egrave;me non volatiles
99
Pr&eacute;cisions sur la m&eacute;moire r&eacute;manente
100
Configurer la m&eacute;moire r&eacute;manente
100
Actions
14
15
105
Actions d'alarmes
106
Actions d'&eacute;v&eacute;nements
106
Actions multilangues
107
Actions clavier
107
Actions lecteurs m&eacute;dias
109
Action FTP
109
Actions de page
148
D&eacute;marrage du serveur VNC sur les
p&eacute;riph&eacute;riques Linux
149
D&eacute;marrer l’afficheur VNC
150
Alarmes
151
&Eacute;diteur d'alarmes
152
Confirmer les alarmes &agrave; distance
154
Machine &agrave; &eacute;tats pour alarme
155
Configurer les &eacute;v&eacute;nements
156
Widget alarmes actives
159
Widget historique des alarmes
163
Gestion des alarmes &agrave; l'ex&eacute;cution
163
164
112
Exporter la m&eacute;moire tampon des alarmes
vers fichiers .csv
165
Actions d'impression
116
Exporter la configuration des alarmes
165
Actions de recette
117
Actions client &agrave; distance
122
Gestion des recettes
169
Actions syst&egrave;me
123
Configuration d’un widget de recette
172
Actions de variable
130
&Eacute;tat de la recette
173
Actions de tendance
132
Charger/t&eacute;l&eacute;charger une recette
173
Actions de gestion des utilisateurs
135
Sauvegarder et restaurer des donn&eacute;es de
recettes
174
Actions widget
138
Utiliser l’application client
16
Tendances
169
175
Enregistrement des donn&eacute;es
176
142
Exporter les donn&eacute;es de m&eacute;moire de
tendance
177
142
Widgets de tendance
178
Tendances historiques
180
Propri&eacute;t&eacute;s du widget de tendance
182
Gestes de widget de tendance
183
Valeurs hors de port&eacute;e ou non valides
184
142
Espace de travail
Param&egrave;tres et options de fuseau horaire
Utiliser le serveur FTP int&eacute;gr&eacute;
Recettes
141
La barre d'outils de l’application client
Param&egrave;tres FTP
II
D&eacute;marrage du serveur VNC sur les
p&eacute;riph&eacute;riques WinCE
Afficher les donn&eacute;es d’alarme actives
Transf&eacute;rer des fichiers &agrave; un p&eacute;riph&eacute;rique IHM
distant
143
13
147
Activer/d&eacute;sactiver les alarmes &agrave; l’ex&eacute;cution 163
17
12
Utiliser VNC pour acc&egrave;s &agrave; distance
145
145
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
18
Afficher les valeurs de tendance
185
Configurer utilisateurs
226
Widget de diagramme de dispersion
186
Utilisateur par d&eacute;faut
227
189
Gestion des utilisateurs &agrave; l'ex&eacute;cution
227
&Eacute;diteur de transfert de donn&eacute;es
190
Imposer la connexion &agrave; distance
228
Exporter donn&eacute;es vers fichiers .csv
192
Transfert de donn&eacute;es
23
Limites et recommandations du transfert de
donn&eacute;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&eacute;sactiver le journal d’audit
230
Configurer les &eacute;v&eacute;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&eacute;tails de
connexion/d&eacute;connexion
233
199
Exporter le journal d’audit au format .csv
233
L'&eacute;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&icirc;nes multilangues 204
Configurer les rapports de texte
236
Modifier la langue &agrave; l'ex&eacute;cution
206
Configurer les rapports graphiques
237
Limites de la prise en charge UNICODE
206
&Eacute;v&eacute;nements d&eacute;clencheurs d'impression
238
209
Imprimante par d&eacute;faut
239
Planificateur
Cr&eacute;er un ordonnancement
210
25
Ordonnancement Haute Fr&eacute;quence
210
Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives
211
26 Sauvegarder/restaurer le runtime et le
projet
245
&Eacute;cran de veille
27
247
Claviers
243
Configurer un emplacement pour les
ordonnancements
213
Cr&eacute;er et utiliser des claviers personnalis&eacute;s
249
Configurer le widget planificateur
213
Supprimer ou renommer des claviers
personnalis&eacute;s
251
214
Type de clavier
251
Gestion et mots de passe utilisateur
217
Emplacement du clavier
252
Activer/d&eacute;sactiver la gestion de s&eacute;curit&eacute;
219
Configurer groupes et autorisations
Modifier permissions d’acc&egrave;s
Ordonnancement des &eacute;v&eacute;nements &agrave;
l’ex&eacute;cution
22
229
Configurer les alarmes pour le journal d’audit 232
D&eacute;tection automatique de nœuds hors ligne 197
20
Journaux d’audit
Claviers externes
253
219
Rechercher et filtrer
255
220
Touches affich&eacute;es
255
Retirer des associations d'actions
255
Assigner des permissions par widget &agrave; partir
du mode Page
225
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
28
III
29
Mise en page du clavier
256
Utilisation de variables structur&eacute;es
Activer/d&eacute;sactiver clavier
256
JavaScript dans les widgets personnalis&eacute;s 316
Associer des actions &agrave; des touches
256
Galerie de l’utilisateur
R&eacute;f&eacute;rence crois&eacute;e de variables
259
Mettre &agrave; jour les donn&eacute;es dans le volet
R&eacute;f&eacute;rence crois&eacute;e des variables
30
261
263
G&eacute;n&eacute;rer un ensemble d’adressage index&eacute;
264
Utilisation d’un ensemble de variables
index&eacute;es sur les pages
267
31
Serveur &agrave; architecture unifi&eacute;e OPC
269
32
Widgets sp&eacute;ciaux
33
IV
Adressage index&eacute;
34
35
Envoyer un message par e-mail
314
318
321
Configurer le serveur e-mail
322
Configurer les e-mails
322
JavaScript
325
&Eacute;diteur JavaScript
327
Ex&eacute;cution des fonctions JavaScript
327
&Eacute;v&eacute;nements
329
271
&Eacute;v&eacute;nements de widget
330
Widget de navigateur
272
&Eacute;v&eacute;nements de page
334
Widget Canevas
273
&Eacute;v&eacute;nements syst&egrave;me
335
Widget liste d&eacute;roulante
276
Objets
336
Widget compteur de consommation
280
Objets de classe widget
337
Widgets de liste de contr&ocirc;le
282
Propri&eacute;t&eacute;s du widget
338
Widgets Date &amp; Heure
283
M&eacute;thodes du widget
340
Widget de zone de mouvement
284
Objet de page
342
Widgets cam&eacute;ra IP
285
Propri&eacute;t&eacute;s de l'objet de page
342
Widget de blocage de fonction Javascript
289
M&eacute;thodes associ&eacute;es &agrave; l'objet de page
343
Widgets de lecture de m&eacute;dias
290
Objet de groupe
345
Widget d'image multi-&eacute;tats
293
M&eacute;thodes d'objet de groupe
345
Widget multi-couche d’image multi-&eacute;tats
294
Objet du projet
346
Widget adaptateurs r&eacute;seau
296
Propri&eacute;t&eacute;s d'objet du projet
346
Widget de flux RSS
296
M&eacute;thodes d'objet du projet
347
Faire d&eacute;filer le widget de flux RSS
297
Widgets d'objet du projet
357
Widget tableau
298
Objet d'&eacute;tat
358
Widget de variables
306
M&eacute;thodes d'objet d’&eacute;tat
358
309
Mots-cl&eacute;s
359
310
Fonctions g&eacute;n&eacute;rales
360
Cr&eacute;er un widget personnalis&eacute;
310
Prendre en main la lecture/l’&eacute;criture de
fichiers
360
Ajouter des propri&eacute;t&eacute;s &agrave; un widget
personnalis&eacute;
312
Limites lors du travail avec des widgets en
JavaScript
363
Widgets personnalis&eacute;s
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
D&eacute;boguer JavaScript
364
Tableau de fonctions et limites
430
36
Gestes de prise en main
367
Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.
431
37
Param&egrave;tres du syst&egrave;me
369
Compatibilit&eacute;
432
Param&egrave;tres du Syst&egrave;me sur les
P&eacute;riph&eacute;riques WinCE
370
Projets de conversion entre les diff&eacute;rents
p&eacute;riph&eacute;riques IHM
432
Param&egrave;tres du Syst&egrave;me sur les
P&eacute;riph&eacute;riques Linux
381
44
Acc&egrave;s web
401
Plateformes et navigateurs pris en charge
402
Cr&eacute;er une page pour acc&egrave;s web
402
Pages d'accueil de plateforme sp&eacute;cifiques
404
Tester projet web
404
T&eacute;l&eacute;charger projet web
405
Probl&egrave;mes de connectivit&eacute; web
406
Fonctionnalit&eacute;s web prises en charge
408
R&eacute;solution des probl&egrave;mes et FAQ
411
45 Mettre &agrave; jour les composants syst&egrave;me
des p&eacute;riph&eacute;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 &agrave; jour des composants syst&egrave;me de
l’application
414
Modbus TCP Server
606
Param&eacute;trages
415
Mitsubishi FX ETH
618
Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;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&eacute;-cachage
426
Variables
770
FAQ sur le pr&eacute;-cachage
427
Changer de mot de passe sur le p&eacute;riph&eacute;rique
IHM
418
Ports et pare-feux
47 Trucs et astuces pour am&eacute;liorer la
performance
48 Pr&eacute;cisions fonctionnelles et
compatibilit&eacute;
418
429
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
V
VI
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
1
Premiers pas
AGI Creator est un logiciel de cr&eacute;ation de pages graphiques IHM. AGI Creator a une interface glisser-d&eacute;poser qui le rend
facile pour cr&eacute;er des pages complexes. La plupart des fonctionnalit&eacute;s pr&eacute;sentes dans les applications courantes de
Windows sont &eacute;galement disponibles en AGI Creator.
Ce document est divis&eacute; en chapitres qui d&eacute;crivent les principales fonctions de AGI Creator et expliquer comment les
utiliser. Chaque chapitre est pr&eacute;sent&eacute; d'une mani&egrave;re autonome, vous permettant de sauter de chapitre &agrave; chapitre, en
fonction de la t&acirc;che &agrave; accomplir.
Suppositions
2
Installer l’application
2
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
1
Suppositions
Suppositions
Nous supposons que les lecteurs poss&egrave;dent une compr&eacute;hension de base des ordinateurs, Microsoft Windows, et
l'environnement de r&eacute;seau sp&eacute;cifique o&ugrave; l'application sera ex&eacute;cut&eacute;e.
Installer l’application
L'installation de AGI SW Packcontient :
l
l
l
l
AGI Creator : une application pour concevoir des projets IHM personnalis&eacute;s de fa&ccedil;on conviviale, assortie d'une
palette d'objets dans sa biblioth&egrave;que int&eacute;gr&eacute;e, la Galerie des widgets.
AGI Client : une application l&eacute;g&egrave;re qui peut &ecirc;tre utilis&eacute;e sur les ordinateurs Windows pour visualiser et g&eacute;rer &agrave;
distance un projet ex&eacute;cut&eacute; sur un p&eacute;riph&eacute;rique IHM.
HMI Runtime : une application autonome qui fonctionne sur les p&eacute;riph&eacute;riques IHM. Le runtime IHM est install&eacute;e via
le AGI Creator.
AGI PC Runtime : une application autonome qui fonctionne sur les plateformes Win32 (sur les ordinateurs plut&ocirc;t que
sur les p&eacute;riph&eacute;riques IHM).
Exigences de syst&egrave;me AGI Creator
AGI Creator a les exigences de syst&egrave;me suivantes :
Syst&egrave;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&eacute;dure d'installation
Pour installer AGI SW Pack:
1. Ex&eacute;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 | &copy; 2012-2017 DEIF A/S
1 Premiers pas
3. Suivez les instructions donn&eacute;es &agrave; l'&eacute;cran. L'emplacement par d&eacute;faut pour le logiciel est C:\Program Files\DEIF\AGI
Software Pack, changez le chemin si besoin.
4. Si l'&eacute;tape S&eacute;lectionner les composants est disponible, s&eacute;lectionnez les composants que vous souhaitez installer.
5. S&eacute;lectionnez l'option Cr&eacute;er une ic&ocirc;ne de bureau pour ajouter une ic&ocirc;ne AGI Creatorsur votre bureau. Un groupe
AGI SW Packest automatiquement ajout&eacute; au menu D&eacute;marrage par la proc&eacute;dure d'installation.
6. Pour ex&eacute;cuter l'application, cliquez sur l'ic&ocirc;ne du bureau ou s&eacute;lectionnez D&eacute;marrage &gt; Tous les programmes &gt;
AGI Creator.
Version d'essai
AGI Creator est disponible en version d'essai gratuite valable 30 jours. 30 jours apr&egrave;s l'installation, un formulaire
d'enregistrement appara&icirc;tra &agrave; l'&eacute;cran et il vous sera demand&eacute; d'entrer la cl&eacute; d'activation de la licence.
Note : La version d'essai n'est pas support&eacute;e par les machines virtuelles, seules les licences valides peuvent
&ecirc;tre utilis&eacute;es.
Licence
Pour enregistrer le logiciel avant la fin de la p&eacute;riode d'essai, allez sur Aide &gt; Enregistrer.
Note : La proc&eacute;dure d'enregistrement demande une connexion Internet. Les ports TCP 80 et 443 sont utilis&eacute;s
pour l'activation.
Pendant l'enregistrement, un fichier de licence est t&eacute;l&eacute;charg&eacute; sur l'ordinateur &agrave; partir du serveur de licences. Les fichiers de
licence sont sauvegard&eacute;s dans les dossiers suivants, en fonction du syst&egrave;me d'exploitation :
%appdata%\DEIF A/S
Les licences sont verrouill&eacute;es avec l'ID BIOS ou l'ID du produit Windows de l'ordinateur o&ugrave; le logiciel a &eacute;t&eacute; install&eacute;.
Si AGI Creatorne parvient pas &agrave; 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 &laquo; Envoyer E-mail &raquo;, le AGI Creator affichera ce formulaire :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3
Installer l’application
Cet email vous sera envoy&eacute; ult&eacute;rieurement, d&egrave;s qu'une connexion Internet sera disponible. Vous pouvez aussi activer les
licences et t&eacute;l&eacute;charger les fichiers de licence &agrave; partir du site web https://licenses.x-formation.com/licenses, en indiquant
les m&ecirc;mes donn&eacute;es que celles figurant dans le &quot;Corps&quot; du formulaire ci-dessus.
V&eacute;rifier l'&eacute;tat de la licence
Pour v&eacute;rifier l'&eacute;tat de votre licence :
1. Allez sur : https://license.x-formation.com/licenses
2. Entrez votre cl&eacute; d'activation et cliquez sur le bouton Connexion.
Installer des versions multiples de AGI SW Pack
Vous pouvez installer diff&eacute;rentes instances de AGI SW Packsur un m&ecirc;me ordinateur. Chaque installation a ses propres
param&egrave;tres et peut &ecirc;tre d&eacute;sinstall&eacute;e individuellement.
Trois sc&eacute;narios d'installation sont possibles :
Sc&eacute;nario d'installation
R&eacute;sultats
Premi&egrave;re installation de AGI SW Packdans le syst&egrave;me
Le logiciel est install&eacute; dans le dossier de destination
sp&eacute;cifi&eacute;
Syst&egrave;me avec seulement une instance de AGI SW
Packd&eacute;j&agrave; install&eacute;e
La version actuelle peut &ecirc;tre remplac&eacute;e ou maintenue.
Syst&egrave;me avec de multiples instances de AGI SW Packd&eacute;j&agrave;
install&eacute;es
La derni&egrave;re version install&eacute;e peut &ecirc;tre remplac&eacute;e ou
maintenue.
Si vous essayez d'installer une deuxi&egrave;me instance d'une version d&eacute;j&agrave; install&eacute;e de AGI SW Pack, un message
d'avertissement appara&icirc;tra.
Plusieurs installations AGI SW Pack partagent un dossier d'espace de travail commun, chaque sous-dossier comprend le
num&eacute;ro de version, par exemple C:\Program Files\DEIF\AGI Software Pack 2.5. Chaque version install&eacute;e a son propre ID
et peut donc &ecirc;tre &eacute;limin&eacute;e individuellement.
Chaque installation est mentionn&eacute;e s&eacute;par&eacute;ment dans le menu de d&eacute;marrage de Windows.
4
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
1 Premiers pas
Ouvrir d'anciens projets
Lorsque vous ouvrez un projet (fichier .jpr) AGI Creatorcr&eacute;&eacute; avec une version moins r&eacute;cente du logiciel, AGI Creatorvous
demande de convertir le projet dans la version actuelle :
Option
Description
Convertir et &eacute;craser le projet actuel
Le projet est converti sans version de sauvegarde de la
version originale
S&eacute;lectionnez un nouvel emplacement avant de
convertir le projet
Le projet est copi&eacute; dans le dossier sp&eacute;cifi&eacute;, puis converti.
AVERTISSEMENT : N'&eacute;ditez pas de projets avec une version de AGI Creator moins r&eacute;cente que celle
utilis&eacute;e pour les cr&eacute;er. Cela risquerait d'endommager le projet et d'entra&icirc;ner une instabilit&eacute; de
fonctionnement.
Multilanguage pour AGI Creator
AGI Creator est disponible en plusieurs langues. Toutes les langues sont install&eacute;es par d&eacute;faut dans le cadre de AGI SW
Pack.
La langue par d&eacute;faut est l'anglais. Pour la modifier, allez sur Aide &gt; Changer de langue.
Rapports de crash
Une bo&icirc;te de dialogue de rapport de crash appara&icirc;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 | &copy; 2012-2017 DEIF A/S
5
Installer l’application
6
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
2
Runtime
HMI Runtime est con&ccedil;u pour supporter les diff&eacute;rentes plates-formes et les diff&eacute;rents syst&egrave;mes d'exploitation.
Param&egrave;tres de base du p&eacute;riph&eacute;rique IHM
8
Options de menu contextuel
8
Service SNTP int&eacute;gr&eacute;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11
7
Param&egrave;tres de base du p&eacute;riph&eacute;rique IHM
Param&egrave;tres de base du p&eacute;riph&eacute;rique IHM
Les p&eacute;riph&eacute;riques IHM sont livr&eacute;s depuis l'usine sans le runtime. Si aucun runtime n’est install&eacute; sur le p&eacute;riph&eacute;riques, voir
&quot;Le chargeur de runtime&quot; on page 83 pour obtenir plus de d&eacute;tails.
Modes de runtime
Le HMI Runtime est compos&eacute; de deux unit&eacute;s logiques :
l
l
Serveur : ex&eacute;cute les protocoles de communication, collecte les donn&eacute;es, g&egrave;re les alarmes, g&eacute;n&egrave;re des
&eacute;chantillonnages de m&eacute;moire des tendances.
Client : affiche les donn&eacute;es collect&eacute;es par le serveur.
L'unit&eacute; serveur est responsable de la gestion des services IHM tels que les protocoles de communication, de l'acquisition
de donn&eacute;es, de la g&eacute;n&eacute;ration d'&eacute;chantillonnages de m&eacute;moire des tendances, etc.
L'unit&eacute; client est la partie responsable du processus de visualisation : utilisez les donn&eacute;es collect&eacute;es par le serveur pour les
afficher &agrave; l'&eacute;cran sous forme d'informations graphiques.
L'unit&eacute; serveur fonctionne selon deux modes op&eacute;ratoires :
l
l
Mode de configuration : le serveur est inactif (par exemple quand aucun projet n'est charg&eacute; sur le p&eacute;riph&eacute;rique ou
quand il manque des fichiers syst&egrave;me).
Mode op&eacute;rationnel : le serveur fonctionne selon les param&egrave;tres d&eacute;finis par les fichiers syst&egrave;me et par le projet
d'application charg&eacute;.
Note : Les donn&eacute;es sur l'unit&eacute; client peuvent s'afficher m&ecirc;me en l'absence d'activit&eacute; sur le serveur.
Options de menu contextuel
Sur le p&eacute;riph&eacute;rique IHM, appuyez sur un espace vide de l'&eacute;cran et maintenez enfonc&eacute; pendant quelques secondes pour
afficher le menu contextuel.
Zoom avant / arri&egrave;re
S&eacute;lectionner la taille de la vue &agrave; l’ex&eacute;cution
Mode panoramique
Active/d&eacute;sactive le mode panoramique apr&egrave;s un zoom avant
8
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
2 Runtime
Param&eacute;trages
Param&egrave;tres
principaux
Description
Retard(s) menu
contextuel
Retard de l'activation du menu contextuel. Plage : 1–60 secondes.
Afficher curseur
occup&eacute;
Affiche un sablier lorsque le syst&egrave;me est occup&eacute;
Utiliser claviers
Affiche les claviers lorsque l'utilisateur touche un champ d'entr&eacute;e des donn&eacute;es.
D&eacute;fini sur d&eacute;sactiver lorsqu'un clavier USB externe est connect&eacute; au p&eacute;riph&eacute;rique.
Conserver les
donn&eacute;es r&eacute;manentes
en t&eacute;l&eacute;chargeant le
projet
Conserve le contenu des donn&eacute;es non volatiles en chargeant ou t&eacute;l&eacute;chargeant le
projet.
Mot de passe
D&eacute;finit les op&eacute;rations prot&eacute;g&eacute;es par mot de passe parmi les suivantes :
l
T&eacute;l&eacute;charger projet/Runtime
l
Charger projet
l
Gestion de carte (mise &agrave; jour BSP)
Voir &quot;Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;riques IHM&quot; on page 417 pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9
Options de menu contextuel
Gestionnaire de projet
Cet outil vous permet de :
l
d&eacute;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&eacute;charg&eacute;. Vous devez d&eacute;charger un
projet avant de pouvoir le supprimer.
Mise &agrave; jour
Cette fonction charge des paquets de mise &agrave; jour &agrave; partir d'un lecteur USB externe. Voir &quot;Paquet de mise &agrave; jour&quot; on
page 81pour plus de d&eacute;tails.
Sauvegarde
Vous pouvez cr&eacute;er une copie de sauvegarde du runtime et du projet.
Enregistrement
Cette fonction affiche un enregistrement des op&eacute;rations syst&egrave;me.
Cliquez sur Enregistrer dans un fichier pour sauvegarder les donn&eacute;es : un fichier logger.txt file est sauvegard&eacute; dans le
dossier ...\var\log.
Ce fichier peut &ecirc;tre r&eacute;cup&eacute;r&eacute; avec un client FTP et transf&eacute;r&eacute; au support technique.
10
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
2 Runtime
Note : Une fois activ&eacute;, l'enregistrement est maintenu apr&egrave;s les cycles d'alimentation et doit &ecirc;tre d&eacute;sactiv&eacute;
manuellement.
Afficher le journal au d&eacute;marrage
Cette fonction active l'enregistrement au d&eacute;marrage. Si l'option Enregistrer dans un fichier a &eacute;t&eacute; activ&eacute;e, les fichiers
d'enregistrement sont sauvegard&eacute;s &agrave; partir du d&eacute;marrage.
D&eacute;connexion
D&eacute;connecte l'utilisateur actuel.
Show System Settings
Autoriser les param&egrave;tres IHM et la gestion des composants du syst&egrave;me. Voir &quot;Param&egrave;tres du syst&egrave;me&quot; on page 369 pour
plus de d&eacute;tails.
Outils de d&eacute;veloppement
Fonctions utilitaires pour d&eacute;boguer &agrave; l'ex&eacute;cution. Elle est visible uniquement si elle est activ&eacute;e dans les Propri&eacute;t&eacute;s du projet
(voir &quot;Outils de d&eacute;veloppement&quot; on page 62 pour plus de d&eacute;tails)
&Agrave; propos
Cette fonction affiche les informations &agrave; propos de la version du runtime.
AVERTISSEMENT : L'action Menu contextuel ne fonctionne pas lorsqu'elle est ex&eacute;cut&eacute;e depuis une
page de dialogue.
Service SNTP int&eacute;gr&eacute;
Le p&eacute;riph&eacute;rique IHM inclut un SNTP int&eacute;gr&eacute; qui synchronise le volet de l'horloge en temps r&eacute;el interne lorsque le serveur
pr&eacute;d&eacute;fini est disponible. Le syst&egrave;me recherche le serveur SNTP lorsqu'il est allum&eacute;, ou une fois par semaine si le
p&eacute;riph&eacute;rique IHM n’est pas d&eacute;sactiv&eacute;.
Utilisez un p&eacute;riph&eacute;rique IHM &quot;Param&egrave;tres du syst&egrave;me&quot; on page 369pour configurer le service.
Disponibilit&eacute; : BSP v1.76 ARM/2.79 MIPS ou version ult&eacute;rieure
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11
Service SNTP int&eacute;gr&eacute;
2
Runtime sur PC
AGI PC Runtime pour Windows est une plateforme IHM qui combine des fonctionnalit&eacute;s IHM avanc&eacute;es et des graphiques
vectoriels avec des technologies web puissantes. Vous pouvez choisir cette plateforme pour superviser et contr&ocirc;ler votre
&eacute;quipement &agrave; l'aide de variables, d'alarmes, de planificateurs, de recettes, de tendances, de logique Javascript et
d'&eacute;v&eacute;nements.
AGI PC Runtime assure une connectivit&eacute; avec les protocoles d'automatisation industriels et des b&acirc;timents via Ethernet et
des interfaces s&eacute;rie.
Exigences de syst&egrave;me AGI PC Runtime
AGI PC Runtime a les exigences minimales de syst&egrave;me suivantes :
Syst&egrave;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 &ecirc;tre distribu&eacute; en tant que composant du AGI SW Pack ou en tant qu'application autonome. Au
moment d'installer le logiciel, assurez-vous de s&eacute;lectionner l'option Runtime PC dans la bo&icirc;te de dialogue S&eacute;lectionner
les composants.
Multiples instances de AGI PC Runtime
AGI PC Runtime peut &ecirc;tre ex&eacute;cut&eacute; en plusieurs instances simultan&eacute;es. Copiez le dossier d'installation sur un
emplacement modifiable et double-cliquez sur l'application IHM dans chaque dossier pour la d&eacute;marrer.
12
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
2 Runtime sur PC
Le port utilis&eacute; par AGI PC Runtime peut &ecirc;tre modifi&eacute; &agrave; partir de la bo&icirc;te de dialogue des Param&egrave;tres. Red&eacute;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&egrave;s l'installation, un formulaire
d'enregistrement appara&icirc;tra &agrave; l'&eacute;cran et il vous sera demand&eacute; d'entrer les cl&eacute;s d'activation de la licence.
Pour enregistrer AGI PC Runtime avant la fin de la p&eacute;riode d'essai, s&eacute;lectionnez Enregistrer &agrave; partir du menu contextuel.
Note : la proc&eacute;dure d'enregistrement demande une connexion Internet. Les ports TCP 80 et 443 sont utilis&eacute;s
pour l'activation.
Au moment de l'enregistrement, un fichier de licence est t&eacute;l&eacute;charg&eacute; sur l'ordinateur &agrave; partir du serveur de licences. Les
fichiers de licence sont sauvegard&eacute;s dans les dossiers suivants, en fonction du syst&egrave;me d'exploitation :
%appdata%\DEIF A/S
Les licences sont verrouill&eacute;es avec l'ID BIOS ou l'ID du produit Windows de l'ordinateur o&ugrave; le logiciel est install&eacute;.
Si AGI PC Runtimene parvient pas &agrave; 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 | &copy; 2012-2017 DEIF A/S
13
Service SNTP int&eacute;gr&eacute;
Voir &quot;Installer l’application&quot; on page 2 pour consulter les instructions sur la v&eacute;rification de l'&eacute;tat d'activation.
Limites
Les fonctionnalit&eacute;s suivantes ne sont pas support&eacute;es dans AGI PC Runtime :
Fonction
Fonctionnalit&eacute; NON support&eacute;e
G&eacute;rer cible
Section carte
Mode syst&egrave;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
&ecirc;tre utilis&eacute;s &agrave; cette fin.
Protocoles
Protocoles s&eacute;rie demandant un mat&eacute;riel sp&eacute;cial.
Voir &quot;Pr&eacute;cisions fonctionnelles et compatibilit&eacute;&quot; on page 429 pour plus de d&eacute;tails.
Mode plein &eacute;cran
AGI PC Runtime peut d&eacute;marrer en mode plein &eacute;cran ou dans une fen&ecirc;tre.
Pour passer au mode plein &eacute;cran :
1. Cliquez &agrave; l'aide du bouton droit sur la fen&ecirc;tre principale de AGI PC Runtime pour afficher le menu contextuel.
2. S&eacute;lectionnez Plein &eacute;cran.
Le dossier d'espace de travail
Lorsque vous utilisez AGI PC Runtime, les fichiers de projet sont stock&eacute;s dans un dossier d'espace de travail dans :
%appdata%\DEIF A/S\[build number]\server\workspace
o&ugrave; [build number] est un dossier nomm&eacute; en tant que num&eacute;ro de fabrication (par exemple 01.90.00.608).
14
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
2 Runtime sur PC
Probl&egrave;mes habituels d’installation
Important : S’assurer que les ports 80/HTTP et 21/FTP ne sont pas bloqu&eacute;s par le pare-feu.
Si un port est en cours d'utilisation et qu'un conflit est d&eacute;tect&eacute;, une bo&icirc;te de dialogue est affich&eacute;e pour permettre &agrave;
l'utilisateur de modifier les ports par d&eacute;faut.
Voir &quot;Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;riques IHM&quot; on page 417 pour plus de d&eacute;tails.
Dans certaines conditions, AGI PC Runtime il est impossible de d&eacute;tecter tous les services en cours d'ex&eacute;cution dans les
ports comme 80/HTTP et 21/FTP, cela doit &ecirc;tre AGI PC Runtime ferm&eacute; automatiquement. Cela se produit, par exemple,
lorsque IIS ou MS SQL Server ou d'autres services Windows sont en cours d'ex&eacute;cution sur ces ports. Dans ces cas,
d&eacute;sactiver les services windows
Si le t&eacute;l&eacute;chargement du projet devait AGI PC Runtime &eacute;chouer, essayer une des proc&eacute;dures suivantes.
Probl&egrave;mes avec les num&eacute;ros de port
AGI PC Runtime utilise les ports 80 et 21 par d&eacute;faut. Si au moins un est occup&eacute;, un message d'avertissement s'affiche :
S'assurer que lorsque vous modifiez ce port, vous modifiez &eacute;galement le port utilis&eacute; pour le t&eacute;l&eacute;chargement sur le
p&eacute;riph&eacute;rique IHM dans AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15
Probl&egrave;mes habituels d’installation
1. Depuis le T&eacute;l&eacute;chargement jusqu’&agrave; la bo&icirc;te de dialogue, s&eacute;lectionner Avanc&eacute;.
2. Modifier le num&eacute;ro de port pour correspondre &agrave; celui situ&eacute; sur AGI PC Runtime.
3. Cliquer sur OK pour confirmer : vous pouvez maintenant t&eacute;l&eacute;charger votre projet sur AGI PC Runtime.
Restauration des informations de port
Si des informations sur les modifications apport&eacute;es &agrave; AGI PC Runtime ports d'&eacute;coute a &eacute;t&eacute; perdu, le message d'erreur
suivant est renvoy&eacute; :
Impossible d'&eacute;tablir la communication avec le runtime. Veuillez v&eacute;rifier les param&egrave;tres de connexion et que le runtime est
en cours sur le p&eacute;riph&eacute;rique IHM.
Le port utilis&eacute; par AGI PC Runtime peut &ecirc;tre modifi&eacute; &agrave; partir de la bo&icirc;te de dialogue des Param&egrave;tres. Red&eacute;marrez
l'application pour appliquer la modification du port.
16
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cution sur la m&ecirc;me machine que le AGI PC Runtime, votre pare-feu ou antivirus peut
bloquer la connexion depuis AGI Creator jusqu’&agrave; AGI PC Runtime.
1. Depuis la bo&icirc;te de dialogue T&eacute;l&eacute;chargement sur la cible, y taper manuellement l'adresse IP de l’ordinateur h&ocirc;te
local 127.0.0.1.
2. Cliquez sur T&eacute;l&eacute;charger.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17
Probl&egrave;mes habituels d’installation
18
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3
Mon premier projet
Cette section d&eacute;crit comment cr&eacute;er un projet AGI Creatorsimple.
L’espace de travail
20
Cr&eacute;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 &agrave; des variables
33
Pages de dialogues
35
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute; dans les principaux domaines suivants :
Domaine
Description
Vue du projet
Les &eacute;l&eacute;ments du projet dans un arbre hi&eacute;rarchique du projet.
Vue de l’objet
Arborescence des widgets organis&eacute;s par page.
Zone de travail
Espace o&ugrave; les pages sont &eacute;dit&eacute;es. Les onglets en haut de la zone montrent toutes les
pages ouvertes.
Propri&eacute;t&eacute;s
Propri&eacute;t&eacute;s de l'objet s&eacute;lectionn&eacute;.
Galerie des widgets
Biblioth&egrave;que des objets graphiques et des symboles.
R&eacute;f&eacute;rence crois&eacute;e de
variables
Liste des emplacements o&ugrave; une variable donn&eacute;e est r&eacute;f&eacute;renc&eacute;e.
Note : La mise en page de l'espace de travail peut &ecirc;tre modifi&eacute;e &agrave; tout moment, les modifications sont
enregistr&eacute;es et maintenues gr&acirc;ce &agrave; des s&eacute;ances de travail.
R&eacute;initialisation de la mise en page de l’espace de travail
Pour restaurer la mise en page par d&eacute;faut, utilisez la fonction Fichier &gt; R&eacute;initialisation et red&eacute;marrage.
Cr&eacute;er un projet
Chemin : Fichier&gt; Nouveau projet
20
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
1. Dans la bo&icirc;te de dialogue Assistant de projet, entrez un nom de projet et d'emplacement de stockage.
2. Cliquez sur Suivant : la bo&icirc;te de dialogue de s&eacute;lection du p&eacute;riph&eacute;rique IHM s'affiche.
3. Choisissez un p&eacute;riph&eacute;rique dans la liste des mod&egrave;les disponibles.
4. Choisissez l'orientation du p&eacute;riph&eacute;rique.
5. Cliquez sur Terminer pour terminer l'Assistant.
Exceptions de rotation en portrait
Les &eacute;l&eacute;ments suivants ne pivotent pas en mode portrait.
&Eacute;l&eacute;ment
Description
Bo&icirc;tes de dialogue du syst&egrave;me
d'exploitation
Param&egrave;tres du syst&egrave;me et bo&icirc;te de dialogue du syst&egrave;me
Menu contextuel et bo&icirc;tes de dialogue
associ&eacute;es
Gestionnaire de projet, &Agrave; propos, Param&egrave;tres,
Enregistrement, Sauvegarde
Vid&eacute;o
IPCamera, MediaPlayer
JavaScript
Fonction Alerte et Impression
Pages de dialogues
&laquo; Titre &raquo; des pages de dialogue
Planificateur
Bo&icirc;tes de dialogue pour la saisie des donn&eacute;es
Macro
ShowMessage, LunchApplication, LunchBrowser
Applications externes
, VNC
Les p&eacute;riph&eacute;riques IHM bas&eacute;s sur la plateforme Linux peut &ecirc;tre tourn&eacute;s &agrave; partir de la BSP (voir l’onglet &laquo; &Eacute;crans &raquo;
depuis la page &quot;Param&egrave;tres du syst&egrave;me&quot; on page 369&quot;Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux&quot; on
page 381) sans ces limites.
Changer le mod&egrave;le de p&eacute;riph&eacute;rique
Lorsque vous avez d&eacute;velopp&eacute; votre projet, vous pouvez toujours modifier le mod&egrave;le de p&eacute;riph&eacute;rique, &agrave; partir du volet
Propri&eacute;t&eacute;s du projet. Cela ne redimensionnera pas les widgets, mais ils seront d&eacute;plac&eacute;s sur l'&eacute;cran. Un avertissement
s'affiche lorsque certains objets ne peuvent pas &ecirc;tre d&eacute;plac&eacute;s.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
21
Protocoles de communication
Copier, d&eacute;placer et renommer un projet
Le dossier de projets de AGI Creator contient tous les fichiers du projet : pour d&eacute;placer, copier ou sauvegarder un projet,
d&eacute;placez ou copiez le dossier du projet &agrave; l'emplacement choisi.
Pour renommer un projet, utilisez la fonction Fichier &gt; Sauvegarder le projet sous : cette op&eacute;ration peut prendre
quelques minutes.
AVERTISSEMENT : Ne renommez pas les dossiers de projet manuellement.
Protocoles de communication
Chemin : VueProjet&gt; Configuration &gt; Protocoles
Des pilotes de communication du p&eacute;riph&eacute;rique sont configur&eacute;s dans l'&Eacute;diteur de protocole.Vous pouvez ajouter autant de
protocoles que le nombre sp&eacute;cifi&eacute; dans le Tableau de fonctions. Les Variables et les Variables syst&egrave;me ne comptent pas
comme des protocoles.
Voir &quot;Protocoles de communication&quot; on page 435 pour plus de d&eacute;tails.
Note : vous pouvez ex&eacute;cuter diff&eacute;rents protocoles Ethernet sur le m&ecirc;me port physique Ethernet, mais vous ne
pouvez pas ex&eacute;cuter diff&eacute;rents protocoles s&eacute;rie en utilisant le m&ecirc;me port s&eacute;rie. Certains protocoles s&eacute;rie
prennent en charge l'acc&egrave;s &agrave; plusieurs contr&ocirc;leurs, mais cette option est d&eacute;finie au sein du protocole, qui compte
comme un seul protocole.
22
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
Ajouter un protocole
1. Cliquez sur +.
2. S&eacute;lectionnez le protocole depuis la liste API et entrez les valeurs requises.
Modifier les param&egrave;tres du protocole
Pour modifier les param&egrave;tres de configuration, cliquez sur le bouton Parcourir dans la colonne Configuration.
Param&egrave;tres du protocole
Cliquez sur l'ic&ocirc;ne Afficher propri&eacute;t&eacute;s avanc&eacute;es pour afficher tous les param&egrave;tres.
Param&egrave;tre
Description
Dictionnaires
Variables import&eacute;es pour le protocole.
Voir &quot;Importer les variables&quot; on page 30 pour plus de
d&eacute;tails.
Activer Algorithme hors ligne D&eacute;lai d'attente tentative
Voir &quot;D&eacute;tection automatique de nœuds hors ligne&quot; on
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
23
Concevoir une page
Param&egrave;tre
Description
suppl&eacute;mentaire hors ligne
page 197 pour plus de d&eacute;tails.
Version
Version du protocole disponible dans AGI Creator pour le
p&eacute;riph&eacute;rique IHM s&eacute;lectionn&eacute;.
Concevoir une page
Chemin : VueProjet &gt; Pages
Lorsqu'un projet est cr&eacute;&eacute;, la premi&egrave;re page est automatiquement ajout&eacute;e et affich&eacute;e dans l'&Eacute;diteur de page.
Ajouter des objets sur une page
Glissez et d&eacute;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&eacute;lectionnez Ins&eacute;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&eacute;es associ&eacute;es aux widgets. Vous pouvez choisir entre deux comportements diff&eacute;rents :
l
l
importer uniquement les pages et les widgets : toutes les actions et les liaisons de donn&eacute;es doivent &ecirc;tre d&eacute;finies
importer les pages avec les r&eacute;f&eacute;rences aux actions et aux liaisons de donn&eacute;es : les variables utilis&eacute;es doivent &ecirc;tre
pr&eacute;sentes dans le projet pour que ces &eacute;l&eacute;ments fonctionnent correctement
Note : L'importation de pages peut uniquement &ecirc;tre r&eacute;alis&eacute;e entre des projets cr&eacute;&eacute;s avec la m&ecirc;me version du
logiciel. Sauvegardez l'ancien projet en tant que derni&egrave;re version, puis r&eacute;essayez.
24
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;lectionnez Importer page.
2. Choisissez la page &agrave; importer depuis le projet voulu puis cliquez sur OK : un message d'avertissement s'affiche.
3. Cliquez sur Oui pour supprimer toutes les liaisons &agrave; des donn&eacute;es et toutes les actions. Cliquez sur Non pour
maintenir la r&eacute;f&eacute;rence aux liaisons de donn&eacute;es et aux actions. Les variables doivent &ecirc;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&eacute;cution. Pour cr&eacute;er un groupe de pages :
1. Dans VueProjet, faites un clic droit sur le nœud Pages et s&eacute;lectionnez Cr&eacute;er groupe : un nouveau dossier s'ajoute
2. Pour d&eacute;placer une page dans un groupe, faites un clic droit sur une page et s&eacute;lectionnez Groupes &gt; groupName.
La galerie des widgets
Chemin : Vue&gt; Barres d’outils et Ancrage de fen&ecirc;tres&gt; Galerie Widget
Les objets IHM n&eacute;cessaires &agrave; la construction d' une application sont disponibles dans la Galerie Widget. La galerie est
divis&eacute;e en plusieurs cat&eacute;gories, chacune contenant une collection de widgets.
Ajouter des widgets &agrave; une page
1. S&eacute;lectionner le widget depuis la Galerie Widget.
2. Faites-le glisser et d&eacute;posez-le sur la page.
Changer l'apparence d’un widget :
Tous les widgets ont des propri&eacute;t&eacute;s (volet Propri&eacute;t&eacute;s) qui peuvent &ecirc;tre modifi&eacute;es, certains widgets sont pr&eacute;sent&eacute;s dans
des styles diff&eacute;rents. Vous pouvez cliquer sur les boutons dans chaque cat&eacute;gorie pour voir les styles disponibles.
Exemple
Pour d&eacute;finir le style du widget pour jauges rondes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;lectionnez l'un des styles disponibles &agrave; partir de la barre d'outils : selon le widget s&eacute;lectionn&eacute;, diff&eacute;rentes options
sont disponibles.
Widgets complexes
Certains widgets sont compos&eacute;s de plusieurs sous-widgets. Par exemple, un bouton est un widget complexe compos&eacute;
d’un widget bouton et une &eacute;tiquette. La structure des widgets peut &ecirc;tre vue dans VueObjet lorsque le widget est
s&eacute;lectionn&eacute;.
Vous pouvez s&eacute;lectionner un sous-widget, tels que l'&eacute;tiquette dans un bouton, depuis VueObjet et le modifier sans
d&eacute;grouper tout le widget.
26
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
Ajouter des variables
AGI Creator utilise les noms de variables pour acc&eacute;der &agrave; toutes les donn&eacute;es du p&eacute;riph&eacute;rique. Tous les champs et les
emplacements de r&eacute;f&eacute;rence dans le p&eacute;riph&eacute;rique doivent se voir attribu&eacute; un nom de variable pour &ecirc;tre utilis&eacute; dans le projet
IHM.
L'&eacute;diteur de variable peut &ecirc;tre utilis&eacute; pour cr&eacute;er et g&eacute;rer des tags Apr&egrave;s que les variables ont &eacute;t&eacute; d&eacute;finies, elles peuvent &ecirc;tre
utilis&eacute;es dans le projet en les attachant aux propri&eacute;t&eacute;s des widgets.
Voir &quot;Param&egrave;tres &laquo; Associer &agrave; &raquo;&quot; on page 38 pour plus de d&eacute;tails.
&Eacute;diteur de variable
Chemin : VueProjet&gt; Variables
Ajouter une variable
1. Cliquez sur + et entrez les donn&eacute;es requises.
2. S&eacute;lectionnez l'adresse depuis la bo&icirc;te de dialogue d'adresse de protocole de communication : de nouvelles
variables sont nomm&eacute;s Variable1, Variable2, etc.
3. Cliquez sur le nom de la variable pour la renommer.
Propri&eacute;t&eacute;s de variable
Voir la documentation de protocole sp&eacute;cifique pour les d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
27
Ajouter des variables
Propri&eacute;t&eacute;
Description
Nom
Nom de variable unique au niveau du projet. Cl&eacute; primaire pour identifier les informations dans la base de
donn&eacute;es de variable de runtime.
AVERTISSEMENT : Il n’est pas autoris&eacute; de dupliquer les noms des variables.
Groupes
Noms de groupe associ&eacute;s &agrave; une variable
Pilote
Protocole de communication
Adresse
Adresse de m&eacute;moire du contr&ocirc;leur.
Pour modifier, cliquez sur le c&ocirc;t&eacute; droit de la colonne pour obtenir la bo&icirc;te de dialogue dans laquelle vous
pouvez entrer les informations d'adresse.
Codage
Type de codage pour le type de donn&eacute;es de cha&icirc;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 &agrave;
l'&eacute;chelle
Conversion appliqu&eacute;e &agrave; la variable avant le stockage de base de donn&eacute;es.
Par formule = d&eacute;finie comme une transformation lin&eacute;aire.
Par plage = d&eacute;finie comme une conversion de plage.
Les propri&eacute;t&eacute;s ci-dessous seront visibles uniquement apr&egrave;s avoir s&eacute;lectionn&eacute; le mode &laquo; Afficher colonnes avanc&eacute;es &raquo;
depuis la barre d’outil de l’&eacute;diteur de variable.
Propri&eacute;t&eacute; Description
Nom de
variable
API
Nom de la variable de l’API original, utilis&eacute; pour faire correspondre les variables utilis&eacute;es par le p&eacute;riph&eacute;rique
(Nom de variable) et les &eacute;tiquettes export&eacute;es depuis l’API
Taux
(ms)
Temps de rafra&icirc;chissement de la variable Par d&eacute;faut : 500ms.
28
L/&eacute; uniquement dans une vue avanc&eacute;e pour permettre des r&eacute;glages en cas d’erreurs d’importation de
variable.
AVERTISSEMENT : Le taux de rafra&icirc;chissement des variables est le taux de
rafra&icirc;chissement maximum Le taux de rafra&icirc;chissement r&eacute;el d&eacute;pend : du type de
communication (s&eacute;rie, bus de terrain, Ethernet), du protocole, de la quantit&eacute; de donn&eacute;es
&eacute;chang&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
Propri&eacute;t&eacute; Description
L/&eacute;
Attribut de variable L/&Eacute; (L/&Eacute;, L ou &Eacute;).
Note : Le contenu de variables d’&eacute;criture seule est toujours &eacute;crit et jamais lu. Lorsque la
communication n’est pas active, le contenu de ces variables peuvent ne pas &ecirc;tre disponibles dans
les widgets.
Actif
Mode mise &agrave; jour.
faux = les variables sont lues &agrave; partir du contr&ocirc;leur uniquement lorsque requis par le p&eacute;riph&eacute;rique IHM.
vrai = les variables sont continuellement lues m&ecirc;me si non requis par la page affich&eacute;e.
Important : Laissez cette valeur sur faux pour une performance de communication plus
&eacute;lev&eacute;e.
Gestion des noms des variables
Les noms des variables doivent &ecirc;tre uniques au niveau du projet. Si les m&ecirc;mes variables, du m&ecirc;me fichier de symboles
doivent &ecirc;tre utilis&eacute;s pour les deux contr&ocirc;leurs diff&eacute;rents, utilisez la fonction &laquo; Alias &raquo; pour ajouter un pr&eacute;fixe aux variables
import&eacute;es et les rendre uniques au niveau du projet.
Note : Seuls certains protocoles prennent en charge cette fonction &laquo; Alias &raquo;.
Voir &quot;Protocoles de communication&quot; on page 435 pour plus de d&eacute;tails.
Gestion des groupes de variables
Les variables utilis&eacute;es dans chaque page sont identifi&eacute;es comme faisant partie d'un groupe, de sorte que les demandes
faites par le protocole de communication au/aux contr&ocirc;leur(s) connect&eacute;(s) peuvent &ecirc;tre trait&eacute;es plus rapidement : seules
les variables incluses dans la page affich&eacute;e sont interrog&eacute;es &agrave; partir du contr&ocirc;leur.
Exporter les variables
Chemin : VueProjet&gt; variables
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
29
Importer les variables
1. S&eacute;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&eacute;lectionn&eacute;s
sont export&eacute;es dans un fichier .xml.
Vous pouvez &eacute;diter le fichier .xml qui en r&eacute;sulte avec des outils tiers (par exemple, Microsoft Excel) puis r&eacute;importer le
fichier modifi&eacute; (voir &quot;Importer les variables&quot; below pour plus de d&eacute;tails).
Importer les variables
Introduction
Certains protocoles permettent d'importer des variables stock&eacute;es dans un fichier s&eacute;par&eacute; par une virgule (.csv ou autres
formats). R&eacute;f&eacute;rez-vous &agrave; la section Importation des variables de chaque protocole pour obtenir plus de d&eacute;tails (voir
&quot;Protocoles de communication&quot; on page 435).
L'importation est un processus en deux &eacute;tapes :
1. Importation de la d&eacute;finition de variable dans un dictionnaire
2. Importation des variables du dictionnaire vers le projet
AVERTISSEMENT : Les caract&egrave;res sp&eacute;ciaux dans les noms de variables tels que &quot;&amp;&quot; entra&icirc;nent des
erreurs de communication. Voir &quot;Limites de la prise en charge UNICODE&quot; on page 206
Note : Au moment de l'importation, le caract&egrave;re &laquo; . &raquo; dans les noms de variable est remplac&eacute; par &laquo; / &raquo;. Le
protocole utilisera la bonne syntaxe lorsqu'il communiquera avec l'API.
Dictionnaires
Chemin : Affichage du projet&gt; Dictionnaires
Un dictionnaire est une liste de variables import&eacute;es dans l'&Eacute;diteur de variable pour un protocole sp&eacute;cifique. En fonction du
type de protocole, les variables s'affichent en vue lin&eacute;aire ou en vue hi&eacute;rarchique.
30
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
Vue lin&eacute;aire
Vue hi&eacute;rarchique
Importer les variables
Pour importer des variables &agrave; partir d'un fichier externe :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
31
Importer les variables
1. Dans Affichage du projet, variables, s&eacute;lectionnez le protocole &agrave; partir de la liste du filtre.
2. Cliquer sur le bouton Importation variables
: la bo&icirc;te de dialogue du fichier s&eacute;lectionn&eacute; s’affiche. Une bo&icirc;te de
dialogue pour choisir le type de pilote d'importation appara&icirc;t.
3. S&eacute;lectionner le fichier : une liste de variables est repr&eacute;sent&eacute; dans une vue lin&eacute;aire ou hi&eacute;rarchique.
4. Pour importer des variables, s&eacute;lectionnez une ou plusieurs variables ou bien un Nœud (en vue hi&eacute;rarchique
seulement) et cliquez sur le
bouton Importer variables : les variables sont copi&eacute;es vers le projet et
apparaissent sous forme de liste dans la partie sup&eacute;rieure de la fen&ecirc;tre.
Param&egrave;tre
Description
R&eacute;cursif
Tous les &eacute;l&eacute;ments de la structure sont import&eacute;s dans des variables s&eacute;par&eacute;es.
Note : Lorsque le projet a &eacute;t&eacute; configur&eacute; pour utiliser un r&eacute;seau de protocole, vous devez &eacute;galement s&eacute;lectionner
le nœud de protocole vers lequel les variables doivent &ecirc;tre import&eacute;es. Vous pouvez importer les m&ecirc;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&eacute;lectionn&eacute;s.
Mettre &agrave; jour les variables import&eacute;es
En utilisant la commande Mettre &agrave; jour variable(s), vous pouvez r&eacute;importer des variables. Une bo&icirc;te de dialogue vous
permet de s&eacute;lectionner les variables &agrave; r&eacute;importer :
32
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
Ces variables doivent &ecirc;tre mises &agrave; jour. Un liste de diff&eacute;rences entre le projet et le dictionnaire s'affiche.
Ces variables ne sont plus disponibles dans le dictionnaire. Si elles sont mises &agrave; jour, ces variables seront
&eacute;limin&eacute;s du projet.
Associer un widget &agrave; des variables
Pour contr&ocirc;ler un widget et l'animer avec des donn&eacute;es actives, vous pouvez associer une propri&eacute;t&eacute; sp&eacute;cifique &agrave; des
sources de donn&eacute;es diff&eacute;rentes. Par exemple, vous pouvez associer la jauge de la propri&eacute;t&eacute; Valeur &agrave; une variable de
temp&eacute;rature test&eacute;e, ou la propri&eacute;t&eacute; Affichage &agrave; des donn&eacute;es de recette
Sources des donn&eacute;es
&Eacute;l&eacute;ments auxquels vous pouvez associer une propri&eacute;t&eacute; d’objet :
Source des donn&eacute;es
Description
Variable
Variable d&eacute;finie dans l'&eacute;diteur de variables
Alias
Adresse de variables index&eacute;es
Syst&egrave;me
Variables &agrave; syst&egrave;me pr&eacute;d&eacute;fini (consultez &quot;Variables syst&egrave;me&quot; on page 85)
Widget
Connecte &agrave; la propri&eacute;t&eacute; d’un widget (la valeur d’un widget de barre de d&eacute;filement, par exemple)
Recette
Donn&eacute;es du gestionnaire de recette (consultez &quot;Recettes&quot; on page 169)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33
Associer un widget &agrave; des variables
Associer une propri&eacute;t&eacute; &agrave; une variable
1. Dans le volet Propri&eacute;t&eacute;s, cliquez sur +.
2. Dans Source, choisissez la source de donn&eacute;es : dans la liste, choisissez un protocole et la variable. Utilisez la
barre Rechercher pour filtrer les variables.
3. Configurez le type d’acc&egrave;s (Lecture seule, par exemple). Le champ Index de tableau s’affiche lorsque la variable
s&eacute;lectionn&eacute;e est un tableau, afin d’identifier l’&eacute;l&eacute;ment du tableau &agrave; utiliser. Le mode index indirect est pris en charge
gr&acirc;ce &agrave; une variable suppl&eacute;mentaire.
4. Cliquez sur OK pour confirmer.
Les ic&ocirc;nes adjacentes au nom de variable sont en surbrillance lorsqu’une d&eacute;finition ne correspond pas &agrave; la d&eacute;finition de
variable dans le dictionnaire, ou lorsqu’une telle d&eacute;finition est manquante. Lorsque vous s&eacute;lectionnez Afficher toutes les
variables, toutes les variables du dictionnaire s’affichent, m&ecirc;me celles que vous n’avez pas import&eacute;es dans l’application.
Vous pouvez double-cliquer pour importer les variables du dictionnaire.
Voir &quot;Param&egrave;tres &laquo; Associer &agrave; &raquo;&quot; on page 38 pour plus de d&eacute;tails.
Erreur de communication
Deux ic&ocirc;nes peuvent appara&icirc;tre pr&egrave;s des widgets qui ont une variable associ&eacute;e.
34
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
3 Mon premier projet
: erreur de communication
l
l
: donn&eacute;es actuellement non disponibles (protocole de communication lent)
Pages de dialogues
Chemin : VueProjet&gt; Web &gt; Dialogues
Les pages de dialogues s'ouvrent &agrave; l'ex&eacute;cution au-dessus de la page actuelle sur requ&ecirc;te du projet. Elles sont utilis&eacute;es pour
notifier les alarmes, les erreurs ou pour requ&eacute;rir une action de l'utilisateur.
Propri&eacute;t&eacute;s des dialogues principaux
Propri&eacute;t&eacute;
Description
Type de
dialogue
modal = l'utilisateur ne peut pas retourner sur la fen&ecirc;tre principale du projet/sur la page tant que le
dialogue n'est pas ferm&eacute;.
non-modal = l'utilisateur peut continuer d'utiliser la fen&ecirc;tre principale du projet (ou d'autres dialogues
non-modaux) lorsqu'un dialogue est affich&eacute; au-dessus.
Barre de
titre
vrai = titre du dialogue affich&eacute;
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&eacute;
faux = le dialogue s'affiche au centre de l'&eacute;cran
vrai = le dialogue s'affiche dans l'angle en haut &agrave; gauche &agrave; la position X et Y
Nombre maximal de dialogues
Le nombre maximum de bo&icirc;te de dialogue ouvert est d&eacute;fini dans &quot;Pr&eacute;cisions fonctionnelles et compatibilit&eacute;&quot; on page 429.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35
Pages de dialogues
Lorsque le nombre maximal de dialogues ouverts est atteint, le dialogue le moins r&eacute;cent est ferm&eacute; pour en ouvrir un
nouveau.
36
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;es
38
Param&egrave;tres &laquo; Associer &agrave; &raquo;
38
&Eacute;v&eacute;nements
43
Positionnement des widgets
46
Gestion widgets chevauchants
47
Grouper des widgets
48
Changer les propri&eacute;t&eacute;s de plusieurs widgets
54
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
37
Types de donn&eacute;es
Types de donn&eacute;es
Lorsque vous cr&eacute;ez une variable, vous devez sp&eacute;cifier ses propri&eacute;t&eacute;s. Les types de donn&eacute;es sont sp&eacute;cifiques &agrave; AGI
Creator, les types de m&eacute;moires sont sp&eacute;cifiques au protocole s&eacute;lectionn&eacute;. Choisissez la valeur en fonction de la
repr&eacute;sentation interne dont vous avez besoin pour l'adresse de contr&ocirc;leur s&eacute;lectionn&eacute;e.
Note : les types tableaux utilisent les m&ecirc;mes types de donn&eacute;es suivis par &laquo; [ ] &raquo; (c-&agrave;-d : boolean [ ])
Type de
donn&eacute;es
Description
boolean
Donn&eacute;es d'un bit (0 &agrave; 1)
octet
Donn&eacute;es sign&eacute;es de 8 bits (-128 &agrave; 127)
double
Type virgule flottante de 64 bits double pr&eacute;cision conforme IEEE (&plusmn;2.2e-308 &agrave; &plusmn;1.79e308)
float
Type virgule flottante de 32 bits simple pr&eacute;cision conforme IEEE (&plusmn;1.17e-38 &agrave; &plusmn;3.40e38)
int
Donn&eacute;es sign&eacute;es de 32 bits (-2.1e9 &agrave; 2.1e9)
short
Donn&eacute;es sign&eacute;es de 16 bits (-32768 &agrave; 32767)
string
Caract&egrave;res cod&eacute;s selon le format s&eacute;lectionn&eacute;
temps
Donn&eacute;es de l'heure
unsignedByte
Donn&eacute;es non sign&eacute;es de 8 bits (0 &agrave; 255)
unsignedInt
Donn&eacute;es non sign&eacute;es de 32 bits (0 &agrave; 4.2e9)
unsignedShort Donn&eacute;es non sign&eacute;es de 16 bits (0 &agrave; 65535)
uint64
Donn&eacute;es non sign&eacute;es de 64 bits (0 &agrave; 264 − 1)
Param&egrave;tres &laquo; Associer &agrave; &raquo;
Propri&eacute;t&eacute;s d'objet
Dans AGI Creator, les propri&eacute;t&eacute;s d'un objet plac&eacute; sur une page peuvent &ecirc;tre d&eacute;finies au moment de la programmation ou
configur&eacute;es pour &ecirc;tre dynamiques. Pour changer une propri&eacute;t&eacute; au moment de la programmation, utilisez la barre d'outils de
la page ou le volet Propri&eacute;t&eacute;. S&eacute;lectionnez d'abord l'objet pour afficher ses propri&eacute;t&eacute;s.
38
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
La barre d'outils de la page affiche uniquement les propri&eacute;t&eacute;s les plus communes de l'objet, alors que le volet Propri&eacute;t&eacute;s
affiche toutes les propri&eacute;t&eacute;s dans un mode d'affichage simple ou avanc&eacute;.
Pour changer une valeur de propri&eacute;t&eacute; dynamiquement, vous pouvez l'associer &agrave; des variables ou &agrave; des variables.
Associer une propri&eacute;t&eacute; &agrave; une variable
1. Dans le volet Propri&eacute;t&eacute;s, cliquez sur +.
2. Dans Source, choisissez la source de donn&eacute;es : dans la liste, choisissez un protocole et la variable. Utilisez la
barre Rechercher pour filtrer les variables.
3. Configurez le type d’acc&egrave;s (Lecture seule, par exemple). Le champ Index de tableau s’affiche lorsque la variable
s&eacute;lectionn&eacute;e est un tableau, afin d’identifier l’&eacute;l&eacute;ment du tableau &agrave; utiliser. Le mode index indirect est pris en charge
gr&acirc;ce &agrave; une variable suppl&eacute;mentaire.
4. Cliquez sur OK pour confirmer.
Les ic&ocirc;nes adjacentes au nom de variable sont en surbrillance lorsqu’une d&eacute;finition ne correspond pas &agrave; la d&eacute;finition de
variable dans le dictionnaire, ou lorsqu’une telle d&eacute;finition est manquante. Lorsque vous s&eacute;lectionnez Afficher toutes les
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
39
Param&egrave;tres &laquo; Associer &agrave; &raquo;
variables, toutes les variables du dictionnaire s’affichent, m&ecirc;me celles que vous n’avez pas import&eacute;es dans l’application.
Vous pouvez double-cliquer pour importer les variables du dictionnaire.
Sources des donn&eacute;es
&Eacute;l&eacute;ments auxquels vous pouvez associer une propri&eacute;t&eacute; d’objet :
Source des donn&eacute;es
Description
Variable
Variable d&eacute;finie dans l'&eacute;diteur de variables
Alias
Adresse de variables index&eacute;es
Syst&egrave;me
Variables &agrave; syst&egrave;me pr&eacute;d&eacute;fini (consultez &quot;Variables syst&egrave;me&quot; on page 85)
Widget
Connecte &agrave; la propri&eacute;t&eacute; d’un widget (la valeur d’un widget de barre de d&eacute;filement, par exemple)
Recette
Donn&eacute;es du gestionnaire de recette (consultez &quot;Recettes&quot; on page 169)
Recherche avanc&eacute;e
Diverses options de syntaxe peuvent s'appliquer &agrave; une zone de recherche :
Options
principales
Fonction
M&eacute;tacaract&egrave;res Recherche en associant des m&eacute;tacaract&egrave;res simples. Caract&egrave;re '?' : s'associe &agrave; n'importe quel
caract&egrave;re. Caract&egrave;re ' *': s'associe &agrave; aucun ou plus de tous les caract&egrave;res.&quot; &laquo; [...] &raquo; : les ensembles de
caract&egrave;res peuvent &ecirc;tre repr&eacute;sent&eacute;s entre crochets.
Expression
r&eacute;guli&egrave;re
D&eacute;crit le mod&egrave;le de caract&egrave;re. Voir http://www.regular-expressions.info/
Filtrage des variables
Choisissez diff&eacute;rents crit&egrave;res de filtrage des variables :
40
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Affichage des variables de dictionnaire
Lorsque Afficher toutes les variables est coch&eacute;, les variables qui appartiennent &agrave; un dictionnaire mais qui n'ont pas
encore &eacute;t&eacute; import&eacute;es apparaissent en bleu. Vous pouvez s&eacute;lectionner une variable et cliquer deux fois dessus pour
l'importer dans le projet.
Conversion de la valeur de variable
L'onglet Mise &agrave; l'&eacute;chelle convertit la valeur de variable. Dans la section Par plage, d&eacute;finissez la plage d'entr&eacute;e et la plage
de sortie : le syst&egrave;me calcule automatiquement les facteurs de mise &agrave; l'&eacute;chelle.
Extraction des variables bit/byte bas&eacute;es sur l'index
Permet d'extraire le contenu d'un mot d'un seul bit ou d'un seul byte selon le num&eacute;ro de bit ou de byte sp&eacute;cifi&eacute;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
41
Param&egrave;tres &laquo; Associer &agrave; &raquo;
Mappage des valeurs de variable aux couleurs
Permet de mapper des valeurs de variable num&eacute;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&eacute;placez vers le
haut/vers le bas les lignes de couleurs. Vous pouvez modifier la
valeur de variable et les valeurs de s&eacute;quence.
La derni&egrave;re combinaison de couleurs d&eacute;finie est enregistr&eacute;e
automatiquement et vous pouvez la r&eacute;cup&eacute;rer dans la barre d'outils
des couleurs.
Notez que la valeur de variable de mappage de la couleur renverra un type de donn&eacute;es de cha&icirc;ne (par
ex. &laquo; &quot;#FF0000 &raquo;)
S&eacute;rialisation de liaison de donn&eacute;es
Au lieu de l'utilisation ci-dessus de la bo&icirc;te de dialogue &laquo; attacher &agrave; ... &raquo;, les liaisons de donn&eacute;es peuvent &ecirc;tre entr&eacute;es, ou
modifi&eacute;es, manuellement.
Cliquez sur un bouton dans le panneau Propri&eacute;t&eacute;s et entrez le texte qui d&eacute;crit la liaison de donn&eacute;es
42
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Le format de liaison de donn&eacute;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)
&Eacute;v&eacute;nements
Les &eacute;v&eacute;nements sont utilis&eacute;s pour d&eacute;clencher des actions au niveau du projet et ils peuvent &ecirc;tre associ&eacute;s &agrave; :
l
l
des boutons/touches (cliquer, appuyer, rel&acirc;cher)
des p&eacute;riph&eacute;riques d'entr&eacute;e externes tels que des claviers et une souris (cliquer, appuyer, maintenir, rel&acirc;cher,
molette)
l
des modifications de donn&eacute;es (OnDataUpdate)
l
des changements de pages (OnActivate, OnDeactivate)
l
des alarmes
l
planificateur
Vous pouvez associer une ou plusieurs actions &agrave; un &eacute;v&eacute;nement, pour qu'elles soient ex&eacute;cut&eacute;es lorsque l'&eacute;v&eacute;nement se
produit.
Dans cet exemple, une action JavaScript est activ&eacute;e en appuyant sur un bouton.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
43
&Eacute;v&eacute;nements
OnClick/OnMouseClick
D&eacute;clenche l'&eacute;v&eacute;nement lorsque vous appuyez sur le bouton/la touche et rel&acirc;chez rapidement.
OnHold/OnMouseHold
D&eacute;clenche l'&eacute;v&eacute;nement lorsque vous appuyez et maintenez enfonc&eacute; le bouton/la touche pendant un certain moment, qui
est d&eacute;fini comme Temps de maintien dans les propri&eacute;t&eacute;s du widget. Les actions programm&eacute;es pour cet &eacute;v&eacute;nement sont
ex&eacute;cut&eacute;es uniquement apr&egrave;s expiration du temps de maintien.
Le Temps de maintien par d&eacute;faut est configur&eacute; dans les propri&eacute;t&eacute;s du projet mais il peut &ecirc;tre red&eacute;fini pour chaque
bouton/touche. Voir &quot;Propri&eacute;t&eacute;s de projet&quot; on page 59.
44
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Note : Si le Temps de maintien est d&eacute;fini sur -1 pour le widget, la valeur Temps de maintien du projet sera
utilis&eacute;e.
R&eacute;p&eacute;tition auto
Active la r&eacute;p&eacute;tition auto pour un &eacute;v&eacute;nement d'appui ou de maintien d'un bouton ou d'une touche. Le Temps de r&eacute;p&eacute;tition
auto est sp&eacute;cifi&eacute; dans les propri&eacute;t&eacute;s du projet mais il peut &eacute;galement &ecirc;tre red&eacute;fini pour chaque bouton/touche.
OnWheel
D&eacute;clenche l'&eacute;v&eacute;nement lorsque la valeur d'une molette (par exemple une molette de souris USB) est modifi&eacute;e. Une molette
est en g&eacute;n&eacute;ral utilis&eacute;e pour augmenter/diminuer les valeurs dans une zone de texte ou elle est associ&eacute;e &agrave; une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
45
Positionnement des widgets
OnActivate
D&eacute;clenche l'&eacute;v&eacute;nement lorsqu'une page est charg&eacute;e. L'&eacute;v&eacute;nement d&eacute;marre avant que les widgets de la page ne soient
initialis&eacute;s.
OnDataUpdate
D&eacute;clenche l'&eacute;v&eacute;nement lorsque la valeur de variable est modifi&eacute;e. Le moment de mise &agrave; jour d&eacute;pend du temps n&eacute;cessaire
au protocole pour terminer le processus de mise &agrave; jour. Par exemple, l'&eacute;v&eacute;nement OnDataUpdate peut &ecirc;tre d&eacute;clench&eacute; ou
non, selon si le protocole met &agrave; disposition les donn&eacute;es respectivement apr&egrave;s ou avant l'initialisation des widgets pour la
premi&egrave;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 &agrave; distance.
Note : La valeur lue pendant OnActivate peut &ecirc;tre similaire &agrave; celle obtenue par un &eacute;v&eacute;nement OnDataUpdate
post&eacute;rieur, puisque les notifications OnDataUpdate sont envoy&eacute;es de mani&egrave;re asynchrone.
Positionnement des widgets
Vous pouvez placer des widgets sur la page en utilisant deux m&eacute;thodes :
l
Aligner &agrave; la grille
l
Aligner &agrave; l'objet
Pour afficher la grille, sur le menu Vue, cliquez Afficher grille.
Aligner &agrave; la grille
Chemin : Vue&gt; Aligner &agrave; la grille
Lorsque vous d&eacute;placez ou redimensionnez un objet, son coin sup&eacute;rieur gauche s'alignera &agrave; l'intersection la plus proche des
lignes dans la grille, m&ecirc;me si la grille n’est pas visible.
Param&egrave;tres des propri&eacute;t&eacute;s de la grille
Chemin : Vue&gt; Propri&eacute;t&eacute;s
Param&egrave;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 &agrave; l'objet
Chemin : Vue&gt; Aligner &agrave; l’objet
Lorsque vous d&eacute;placez un objet, il s’alignera avec d'autres objets sur la page.
46
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Lorsque vous s&eacute;lectionnez un objet, un des points sensibles suivants est s&eacute;lectionn&eacute; comme source du point
d'alignement, en fonction de la zone o&ugrave; vous avez appuy&eacute;: en haut, en haut &agrave; gauche, en haut &agrave; droite, en bas, en bas &agrave;
gauche, en bas &agrave; droite, &agrave; gauche, &agrave; droite, au centre :
Un algorithme trouve un point sensible correspondant parmi les widgets &agrave; proximit&eacute; de points chauds correspondant aussi
bien aux coordonn&eacute;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&eacute;cider de les organiser de sorte qu’un soit
affich&eacute; au-dessus des autres.
L’ordre du widget sur la page est affich&eacute; dans la liste d&eacute;roulante. Un widget avec un nombre d’ordre-z sup&eacute;rieur est face &agrave;
un &eacute;l&eacute;ment avec un nombre d’ordre-z inf&eacute;rieur. Une ic&ocirc;ne par image identifie les objets statiques, une ic&ocirc;ne par film
identifie des objets dynamiques.
Important : Un ordre correct de widgets est essentiel pour la performance de l’ex&eacute;cution puisque le
chevauchement des widgets dynamiques peut rendre invalide l’optimisation statique et r&eacute;duire les
performances des applications IHM.
Cacher/afficher un widget sur ordre z
Pour cacher des widgets au-dessus d’un widget s&eacute;lectionn&eacute; :
l
Sur la barre d’outils, cliquez sur
cach&eacute;s
et s&eacute;lectionnez un widget : tous les widgets au-dessus de celui-ci seront
Pour cacher des widgets en dessous d’un widget s&eacute;lectionn&eacute; :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
47
Grouper des widgets
l
Sur la barre d’outils, cliquez sur
cach&eacute;s
et s&eacute;lectionnez un widget : tous les widgets en dessous de celui-ci seront
La barre d’outils permet de :
l
cacher les widgets empil&eacute;s au-dessus et/ou en dessous des widgets s&eacute;lectionn&eacute;s
l
travailler sur diff&eacute;rents widgets en utilisant la liste d&eacute;roulantes qui liste tous les widgets dans leur ordre-z.
Grouper des widgets
Pour grouper des widgets :
1. S&eacute;lectionnez tous les widgets &agrave; grouper.
2. Cliquez avec le bouton droit, puis cliquez sur Groupe.
Astuce : Double-cliquez pour acc&eacute;der au mode &eacute;dition du groupe. Les widgets de groupe ne peuvent &ecirc;tre &eacute;dit&eacute;s
et s&eacute;lectionn&eacute;s qu'en mode groupe. Tous les autres widgets sont partiellement masqu&eacute;s
Redimensionner des widgets group&eacute;s
Vous pouvez d&eacute;finir les r&eacute;actions au redimensionnement d'un objet Utilisez la propri&eacute;t&eacute; Mise &agrave; l'&eacute;chelle dans la section
G&eacute;n&eacute;rale :
l
&Eacute;chelle : l'objet et le texte ne sont pas redimensionn&eacute;s proportionnellement
l
&Eacute;tirement : l'objet et le texte sont redimensionn&eacute;s proportionnellement
48
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Groupe disposition grille
La disposition de la grille ajoute la possibilit&eacute; de configurer les relations spatiales entre les widgets du groupe.
Pour cr&eacute;er une disposition de la grille :
l
Activer le param&egrave;tre &laquo; Disposition de grille &raquo; du groupe de widgets.
ou
l
S&eacute;lectionner les widgets qui seront &agrave; l'int&eacute;rieur du tableau et cliquer sur le bouton &laquo; Disposition de la grille &raquo; sur la
barre d'outils de la page. Les widgets s&eacute;lectionn&eacute;s seront align&eacute;s et recueillis dans un groupe avec la propri&eacute;t&eacute; de
disposition de grille activ&eacute;e.
Il existe plusieurs &eacute;l&eacute;ments associ&eacute;s &agrave; la disposition de la grille qui peuvent &ecirc;tre configur&eacute;s :
l
Propri&eacute;t&eacute;s de grille
l
Propri&eacute;t&eacute;s de ligne, colonne
l
Propri&eacute;t&eacute;s de cellules
Propri&eacute;t&eacute;s de grille
Les principales propri&eacute;t&eacute;s de disposition de grille sont disponibles &agrave; l'int&eacute;rieur du mode avanc&eacute; de fonctionnement du
panneau de propri&eacute;t&eacute;s lorsque le groupe de widget est s&eacute;lectionn&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49
Grouper des widgets
Param&egrave;tre
Description
Activer
Activer la disposition de grille.
Une grille sera g&eacute;n&eacute;r&eacute;e autour des widgets du groupe
Lignes num
Colonnes num
Nombre de lignes et de colonnes des grilles
D&eacute;bordement horizontal
D&eacute;bordement vertical
Ce param&egrave;tre permet de d&eacute;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 &ecirc;tre enlev&eacute;es
uniquement si leurs cellules sont vides.
l
l
l
50
Cach&eacute;
Les lignes et les colonnes qui ne rentrent pas dans la grille
ne sont pas affich&eacute;es
Visible
La grille ne peut pas &ecirc;tre rendue plus petite que la taille
minimale requise pour contenir toutes les lignes et les
colonnes d&eacute;finies
D&eacute;filement
Lorsque la grille est trop petite pour contenir toutes les
lignes et les colonnes d&eacute;finies, les barres de d&eacute;filement
peuvent &ecirc;tre utilis&eacute;es pour d&eacute;placer le contenu de la grille.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Param&egrave;tre
Description
Sous-d&eacute;bordement horizontal
Sous-d&eacute;bordement vertical
Ce param&egrave;tre d&eacute;finit le comportement de la grille quand il est trop
grand que la taille d&eacute;finie pour les lignes et les colonnes.
l
l
Bloqu&eacute;
La grille ne peut pas &ecirc;tre rendue plus grande que la taille
maximale des lignes et des colonnes
Gauche, Centre, Droite - Haut, Milieu, Bas
Permet de d&eacute;finir la position des widgets lorsque les
cellules sont plus grandes que les tailles maximum d&eacute;finies
Couleur de barre de d&eacute;filement
Image de barre de d&eacute;filement
D&eacute;calage de barre de d&eacute;filement
Taille de barre de d&eacute;filement
Cache auto de barre de d&eacute;filement
Param&egrave;tre pour d&eacute;finir l'apparence et la position des barres de
d&eacute;filement
Marge r&eacute;duite
R&eacute;duire toute la marge de gauche &agrave; droite et de haut en bas en
utilisant les param&egrave;tres de la course avec une plus grande largeur.
Largeur de la marge externe
Couleur de la marge externe
Param&egrave;tres de la marge externe
Pour fusionner ou s&eacute;parer des lignes ou des colonnes, double-cliquez sur la grille, pour entrer en mode d'&eacute;dition, et d&eacute;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&eacute;lectionn&eacute;e (2)
Propri&eacute;t&eacute;s de ligne, colonne
Les propri&eacute;t&eacute;s de ligne et de colonnes sont disponibles dans une bo&icirc;te de dialogue pop-up apr&egrave;s avoir cliquer sur les
s&eacute;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 | &copy; 2012-2017 DEIF A/S
51
Grouper des widgets
Param&egrave;tres g&eacute;om&eacute;triques
Param&egrave;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
&eacute;tir&eacute;e
&Eacute;tirement
D&eacute;finit la relation entre les largeurs des colonnes qui seront
maintenues si la grille est &eacute;tir&eacute;e
Marge sup&eacute;rieure
Distance du widget de le bord de la cellule
52
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Param&egrave;tre
Description
Marge inf&eacute;rieure
Hauteur min
Hauteur max
Hauteur min/max que le widget peut prendre lorsque la cellule est
&eacute;tir&eacute;e
&Eacute;tirement
D&eacute;finit la relation entre les hauteurs des lignes qui seront
maintenues si la grille est &eacute;tir&eacute;e
Param&egrave;tres de style
Param&egrave;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&egrave;re-plan de page.
La liste des valeurs qui sont s&eacute;par&eacute;es par une virgule, sont li&eacute;es avec les lignes et les colonnes. Exemple, la
premi&egrave;re valeur de la ligne 0, deuxi&egrave;me valeur de la ligne 1, et ainsi de suite.
Le format de couleur pourrait &ecirc;tre #rrggbb ou #rrggbbaa, o&ugrave; &laquo; aa &raquo; est la valeur alpha qui d&eacute;finit l'opacit&eacute; de la
couleur.
Param&egrave;tres de s&eacute;lection
Les param&egrave;tres de s&eacute;lection sont disponibles uniquement lorsque la grille est utilis&eacute;e &agrave; l'int&eacute;rieur d'un widget de tableau
(voir &quot;Widget tableau&quot; on page 298 pour plus de d&eacute;tails)
Param&egrave;tre
Description
Couleur de premier plan
Couleur de fond
Couleurs de course
Couleurs que la ligne prend lorsqu’elle est s&eacute;lectionn&eacute;e
La liste des couleurs est associ&eacute;e &agrave; des mod&egrave;les de ligne. La
premi&egrave;re couleur est pour le mod&egrave;le de la ligne 0, la deuxi&egrave;me
couleur est pour le mod&egrave;le de la ligne 1, et ainsi de suite.
Propri&eacute;t&eacute;s de cellules
Les propri&eacute;t&eacute;s d'une cellule unique sont disponibles &agrave; l'int&eacute;rieur du panneau de propri&eacute;t&eacute;s lorsqu'une cellule est
s&eacute;lectionn&eacute;e. Pour s&eacute;lectionner une cellule : tout d'abord, double-cliquer sur le groupe de widget, puis cliquer sur la cellule
pour la s&eacute;lectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
53
Changer les propri&eacute;t&eacute;s de plusieurs widgets
Param&egrave;tre
Description
Sous-d&eacute;bordement horizontal
Sous-d&eacute;bordement vertical
Ce param&egrave;tre d&eacute;finit le comportement du widget quand il est trop
grand que la taille d&eacute;finie pour le widget.
l
l
H&eacute;ritage
Il h&eacute;rite de la valeur utilis&eacute;e pour la ligne ou la colonne
Gauche, Centre, Droite - Haut, Milieu, Bas
Permet de d&eacute;finir la position des widgets lorsque les
cellules sont plus grandes que les tailles maximum d&eacute;finies
Largeur max
Hauteur max
&Eacute;craser les param&egrave;tres globaux de la grille
Marge de gauche
Marge de droite
Marge sup&eacute;rieure
Marge inf&eacute;rieure
&Eacute;craser les param&egrave;tres globaux de la grille
Conserver le rapport d'aspect
Conserver le rapport d'aspect du widget
Rapport d'aspect
Disponible uniquement lorsque &laquo; Conserver le rapport d’aspect &raquo;
est vrai
Pixels suppl&eacute;mentaires qui sont ajout&eacute;s &agrave; la marge totale.
Changer les propri&eacute;t&eacute;s de plusieurs widgets
Vous pouvez d&eacute;finir les propri&eacute;t&eacute;s de plusieurs widgets du m&ecirc;me type, tous en une seule fois.
54
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4 Concepts de programmation
Pour modifier les propri&eacute;t&eacute;s :
1. S&eacute;lectionnez les widgets.
2. D&eacute;finissez les propri&eacute;t&eacute;s communes dans le volet Propri&eacute;t&eacute;s.
3. Lorsque plusieurs widgets sont s&eacute;lectionn&eacute;s, le titre du volet Propri&eacute;t&eacute;s devient &lt;MultipleObjects&gt; : tous les
changements seront appliqu&eacute;s &agrave; tous les widgets s&eacute;lectionn&eacute;s.
Note : Toutes les propri&eacute;t&eacute;s ne peuvent pas &ecirc;tre modifi&eacute;es pour plusieurs widgets simultan&eacute;ment, elles doivent
donc &ecirc;tre modifi&eacute;es individuellement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
55
Changer les propri&eacute;t&eacute;s de plusieurs widgets
56
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Changer la propri&eacute;t&eacute; couleur de remplissage en
fonction des valeurs de variable
AGI Creator permet de modifier la propri&eacute;t&eacute; de couleur d'un widget de fa&ccedil;on dynamique en fonction des valeurs de variable,
ce de deux fa&ccedil;ons :
l
En utilisant ColorPalette
l
En associant la propri&eacute;t&eacute; de couleur &agrave; une variable de type Cha&icirc;ne
Changer la propri&eacute;t&eacute; de couleur en utilisant ColorPalette
1. Cr&eacute;ez la variable (interne ou API) de r&eacute;f&eacute;rence pour la gestion des couleurs. La variable peut &ecirc;tre de tout type de
donn&eacute;es. La couleur changera en fonction de la valeur de cette variable.
2. Associez cette variable &agrave; la propri&eacute;t&eacute; Couleur de remplissage d'un objet (par exemple, un bouton).
3. Dans la m&ecirc;me bo&icirc;te de dialogue, s&eacute;lectionnez l'onglet Colorpalette et ajoutez les couleurs &agrave; utiliser pour l'objet
selon la valeur de la variable.
Note : Les derniers tableaux de couleurs utilis&eacute;s sont sauvegard&eacute;s et peuvent &ecirc;tre r&eacute;utilis&eacute;s en les s&eacute;lectionnant
&agrave; partir de la liste des couleurs dans la barre d'outils.
Changer la propri&eacute;t&eacute; de couleur en l'associant &agrave; une variable de type Cha&icirc;ne
1. Cr&eacute;ez la variable (interne ou API) de r&eacute;f&eacute;rence pour la gestion des couleurs. La couleur changera en fonction de la
valeur de cette variable. La variable doit &ecirc;tre de type Cha&icirc;ne et la propri&eacute;t&eacute; Taille de tableau de la variable doit &ecirc;tre
suffisamment grande pour contenir la cha&icirc;ne format&eacute;e comme illustr&eacute; ici.
2. Associez cette variable &agrave; la propri&eacute;t&eacute; Couleur de remplissage d'un objet (par exemple, un bouton).
3. &Eacute;crivez dans la variable de Cha&icirc;ne le code couleur RVB de la couleur souhait&eacute;e. Utilisez un des ces formats :
l
l
#XXYYZZ, o&ugrave; XX, YY et ZZ sont des composants RVB de la couleur souhait&eacute;e exprim&eacute;e sous forme Hexad&eacute;cimale
(plage 00–FF).
rgb(XXX,YYY,ZZZ), o&ugrave; XXX, YYY et ZZZ sont les composants RVB des couleurs souhait&eacute;es exprim&eacute;es sous
forme D&eacute;cimale (plage 0–255).
Note : Cette fonctionnalit&eacute; peut s'appliquer &agrave; tous les objets disponibles dans la Galerie des widgets ayant une
propri&eacute;t&eacute; de couleur. Le changement de couleur en cours d'ex&eacute;cution n'est possible que gr&acirc;ce aux propri&eacute;t&eacute;s des
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
57
Changer la propri&eacute;t&eacute; couleur de remplissage en fonction des valeurs de variable
SVG dont se compose l'objet. Cette fonctionnalit&eacute; ne s'applique pas &agrave; d'autres formats d'image tels que les
fichiers JPEG ou BMP.
58
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6
Propri&eacute;t&eacute;s de projet
Les propri&eacute;t&eacute;s de projet contiennent les param&egrave;tres pour le projet.
Volet des propri&eacute;t&eacute;s de projet
60
Outils de d&eacute;veloppement
62
Rendu des polices FreeType
65
Modules de plug-in de logiciels
66
Comportement
66
&Eacute;v&eacute;nements
71
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
59
Volet des propri&eacute;t&eacute;s de projet
Volet des propri&eacute;t&eacute;s de projet
Chemin : Affichage du projet&gt; double-cliquez sur Propri&eacute;t&eacute;s de projet&gt; volet Propri&eacute;t&eacute;s
Le volet Propri&eacute;t&eacute;s de projet contient une liste de donn&eacute;es configurables par l'utilisateur au niveau du projet.
Propri&eacute;t&eacute;s de base et avanc&eacute;es
Pour consulter toutes les propri&eacute;t&eacute;s de projet :
l
Cliquez sur le bouton Afficher les propri&eacute;t&eacute;s avanc&eacute;es pour agrandir la zone de visualisation du volet Propri&eacute;t&eacute;s.
Description des propri&eacute;t&eacute;s principales
Note : Certaines propri&eacute;t&eacute;s ne s'affichent qu'en mode avanc&eacute;.
60
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Propri&eacute;t&eacute;
Description
Version
Le champ Version permet aux utilisateurs d'indiquer la version du projet.
Menu contextuel
D&eacute;finissez les modalit&eacute;s d'affichage du menu contextuel dans le projet IHM.
Temporisation = le menu contextuel appara&icirc;t en touchant/appuyant et maintenant pendant
quelques secondes un espace vide de l'&eacute;cran de runtime, ou via une action du Menu
contextuel
Sur macro-commande = le menu contextuel n'appara&icirc;t que via une action du Menu
contextuel.
Voir &quot;Actions widget&quot; on page 138 pour plus de d&eacute;tails.
Outil de d&eacute;veloppement
Active/d&eacute;sactive une s&eacute;rie d'outils de d&eacute;bogage de runtime.
Signal sonore au
contact
Activer le bipeur lorsqu’un widget est touch&eacute; sur l'&eacute;cran du p&eacute;riph&eacute;rique IHM.
Widgets pris en charge :
l
boutons
l
zones r&eacute;actives
l
aiguilles
l
champs
l
touches externes
l
listes d&eacute;roulantes
l
&eacute;l&eacute;ments de tableaux
l
&eacute;l&eacute;ments de la liste de contr&ocirc;le
Sur les panneaux de Windows CE, disponibles pour &agrave; partir de v1.76 ARM / 2.79
MIPS.
Dur&eacute;e du signal sonore
200 ms par d&eacute;faut
Clavier
Permet d'utiliser les macros de clavier pendant l'ex&eacute;cution &agrave; condition d'utiliser des claviers
externes.
D&eacute;bogage JavaScript
Active le d&eacute;bogueur JavaScript pendant l'ex&eacute;cution pour le projet actuel.
Autoriser d&eacute;bogueur &agrave;
distance JS
Active le d&eacute;bogueur distant JavaScript pour le projet actuel.
Masquer le chargement
du projet au d&eacute;marrage
Lorsque le projet est masqu&eacute;, l'image de d&eacute;marrage reste &agrave; l'&eacute;cran jusqu'&agrave; ce que
l'application soit pr&ecirc;te pour le fonctionnement.
D&eacute;bogage distant non support&eacute; sur AGI Client.
Disponible pour Windows CE &agrave; partir de v1.99 ARM
Activation image base
Active un moteur utilis&eacute; par le runtime pour optimiser la performance du projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
61
Outils de d&eacute;veloppement
Propri&eacute;t&eacute;
Description
de donn&eacute;es
AVERTISSEMENT : Cette propri&eacute;t&eacute; ne doit &ecirc;tre d&eacute;sactiv&eacute;e par
l'assistance technique que dans un but de d&eacute;bogage, car cette op&eacute;ration
pourrait diminuer la performance pendant l'ex&eacute;cution.
Rendu des polices
FreeType
Passe &agrave; FreeType, le rendu de police utilis&eacute; par AGI Creatoret le runtime.
Modules de plug-in de
logiciels
D&eacute;finit quels composants logiciels sont t&eacute;l&eacute;charg&eacute;s vers le runtime avec le projet. Voir
&quot;Modules de plug-in de logiciels&quot; on page 66
Comportement
Ces propri&eacute;t&eacute;s d&eacute;finissent les diff&eacute;rents aspects du comportement de la page. Voir
&quot;Comportement&quot; on page 66
Style
Mode de vue de la liste d&eacute;roulante (voir &quot;Widget liste d&eacute;roulante&quot; on page 276 pour plus de
d&eacute;tails)
l
Contexte
l
Plein &eacute;cran
Outils de d&eacute;veloppement
Collection de fonctions de d&eacute;bogage au runtime qui peuvent &ecirc;tre activ&eacute;es ou d&eacute;sactiv&eacute;es.
Activer les outils de d&eacute;veloppement
1. Dans le volet Propri&eacute;t&eacute;s, d&eacute;finissez Outils de d&eacute;veloppement sur Vrai.
2. T&eacute;l&eacute;chargez le projet.
3. Ouvrez le menu contextuel.
4. S&eacute;lectionnez Outils de d&eacute;veloppement.
Liste des outils de d&eacute;veloppement
Outil
Description
Afficher/Masquer Affiche une bo&icirc;te de dialogue contenant des informations sur l'&eacute;tat du p&eacute;riph&eacute;rique, telles que la
tout
charge de l'UC, l'utilisation de la m&eacute;moire et les queues d'&eacute;v&eacute;nements.
Statistiques CPU
Affiche des informations sur la charge de l'UC. Voir &quot;Statistiques CPU&quot; on page 64.
Statistiques
m&eacute;moire
Affiche les informations sur la RAM syst&egrave;me. Une valeur n&eacute;gative indique que la m&eacute;moire libre
diminue.
Queues
d'&eacute;v&eacute;nements
Affiche les informations sur les queues d'&eacute;v&eacute;nements (taille, taille maximale atteinte, nombre
d'&eacute;v&eacute;nements trait&eacute;s, dernier temps de traitement et temps de traitement maximal). Les statistiques
sur le minutage sont disponibles uniquement pour les queues non IU.
R&eacute;sum&eacute; journal
en temps r&eacute;el
Affiche le temps de chargement de la page.
Int&eacute;grer la
Permet d'int&eacute;grer la sc&egrave;ne en cours de runtime ou de laisser la fen&ecirc;tre d'outil de d&eacute;veloppement
62
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Outil
Description
fen&ecirc;tre
comme une fen&ecirc;tre autonome (dialogue).
R&eacute;initialiser les
statistiques de
queue
R&eacute;initialise les informations statistiques sur les queues d'&eacute;v&eacute;nements.
D&eacute;sactiver le
chien de garde
D&eacute;sactive la fonction de chien de garde et &eacute;vite que le syst&egrave;me ne red&eacute;marre en cas de gel ou
d'incident des services.
Ignorer les
exceptions
D&eacute;sactive la fonction de rapport d'incident, les exceptions ne sont pas sauvegard&eacute;es dans la
fen&ecirc;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&eacute; pour charger/afficher la page active. Voir &quot;Profilage&quot; on the next page
Chien de garde
Cette fonction vous permet de d&eacute;sactiver le chien de garde. Ainsi, vous pouvez &eacute;viter que le syst&egrave;me ne red&eacute;marre en cas
d'incident en cours de runtime. Vous aurez donc le temps de sauvegarder le rapport d'incident ou de v&eacute;rifier les
informations sur l'&eacute;tat du syst&egrave;me (par exemple, la m&eacute;moire disponible, la charge de l'UC, la taille des queues
d'&eacute;v&eacute;nements, etc.).
La bo&icirc;te de dialogue de rapport d'incident s'affiche automatiquement lorsque le syst&egrave;me g&egrave;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 | &copy; 2012-2017 DEIF A/S
63
Outils de d&eacute;veloppement
Statistiques CPU
L'heure actuelle de la machine s'affiche sur la ligne sup&eacute;rieure, ainsi que le temps de service total du p&eacute;riph&eacute;rique.
Les statistiques CPU sont collect&eacute;es toutes les 2000 millisecondes. La p&eacute;riode r&eacute;elle et le traitement requis pour collecter
et visualiser les statistiques sont &eacute;galement affich&eacute;s. Au plus la p&eacute;riode r&eacute;elle s'&eacute;loigne de 2000 millisecondes, au plus la
charge du syst&egrave;me est importante. La consommation de l'UC de threads est list&eacute;e en rapportant le nom du thread (s'il est
disponible, le thread principal est marqu&eacute; avec un *), l'ID du thread, la priorit&eacute; du thread et le temps de l'UC pass&eacute; durant la
p&eacute;riode de 2000 millisecondes, divis&eacute; en temps d'utilisateur et temps du noyau.
Profilage
Le profilage permet de v&eacute;rifier le temps pass&eacute; pour charger/afficher la page active. Le profilage d&eacute;marre &agrave; partir du
chargement de la page suivante et est actif pour le premier tra&ccedil;age de la page sur l'&eacute;cran (la configuration est conserv&eacute;e).
Option de profilage
Description
Activer journal en temps r&eacute;el
Activer la capture du journal en temps r&eacute;el. Le minutage est affich&eacute; dans la
fen&ecirc;tre &laquo; R&eacute;sum&eacute; du journal en temps r&eacute;el &raquo;.
Sauvegarder journal en temps r&eacute;el
sous forme de fichier
Sauvegarde un rapport de d&eacute;tails du profil et le temps pass&eacute; &agrave; charger un projet
et ses pages dans un fichier timelog.txt. Ce fichier peut &ecirc;tre export&eacute; et partag&eacute;
64
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Option de profilage
Description
pour une analyse approfondie.
Important : L'ex&eacute;cution de cette fonction peut r&eacute;duire la
performance de modification de la page.
Temps de chargement
superposition
Temps de rendu superposition
Cet affichage permet d'afficher le temps pass&eacute; sur les widgets individuellement
et il est disponible uniquement pour les &eacute;tapes de rendu et de chargement. Cet
affichage donne un aper&ccedil;u imm&eacute;diat des actions qui prennent du temps. Les
zones en rouge repr&eacute;sentent les zones critiques qui prennent le plus de temps.
Les temps de widget d&eacute;taill&eacute;s sont visualis&eacute;s par une fen&ecirc;tre en infobulle (sur la
plateforme Win32 jointe &agrave; la souris sur l’&eacute;v&eacute;nement, sur Windows CE, appuyer,
glisser puis rel&acirc;cher sur la r&eacute;gion d’int&eacute;r&ecirc;t). Lorsque des widgets sont en dehors
de la sc&egrave;ne, certaines fl&egrave;ches permettent de naviguer vers ces zones et, en les
survolant, l'infobulle affiche le r&eacute;sum&eacute; de la zone
Choisir la couleur de
superposition
Choisissez la couleur de superposition &agrave; utiliser
Donn&eacute;es du journal en temps r&eacute;el
Donn&eacute;es
Description
Temps d'analyse
Temps pass&eacute; &agrave; analyser la page actuelle. D&eacute;pend de la complexit&eacute; de la page et
du nombre de widgets.
Temps de cr&eacute;ation gfx
Temps pass&eacute; pour afficher une image. Principalement associ&eacute; &agrave; la m&eacute;thode En
chargement.
Temps d'affichage
Temps pass&eacute; pour afficher la page.
Temps de d&eacute;chargement
Temps pass&eacute; &agrave; d&eacute;charger la page, lorsque la page actuelle d&eacute;pend d'une autre
page.
Les temps sont fournis par deux : dur&eacute;e totale d'ex&eacute;cution/temps de l'UC. La dur&eacute;e totale d'ex&eacute;cution est le temps absolu
requis par cette partie, qui peut &ecirc;tre plus importante que le temps r&eacute;el de l'UC requis car les threads de priorit&eacute; plus haute
sont aussi en cours d'ex&eacute;cution (pour les protocoles d'instance). La colonne d'heure de d&eacute;but se r&eacute;f&egrave;re &agrave; l'heure de d&eacute;but
de chargement de la page. Elle peut &ecirc;tre utilis&eacute;e pour suivre le temps r&eacute;el requis pour charger une page, car les temps
partiels se r&eacute;f&egrave;rent uniquement aux fonctions au temps le plus critique et n'incluent pas d'autres temps qui contribuent
souvent au temps total de mani&egrave;re significative.
Par exemple, la dur&eacute;e totale d'ex&eacute;cution r&eacute;elle requise pour charger une page est l'heure de d&eacute;but de l'affichage (qui est la
derni&egrave;re &eacute;tape) + la dur&eacute;e totale d'ex&eacute;cution de l'affichage.
Rendu des polices FreeType
De nouveaux projets utilisent le moteur de polices FreeType par d&eacute;faut. Les projets cr&eacute;&eacute;s avec les anciennes versions de
AGI Creator pourrait utiliser un moteur de police plus ancien &eacute;galement apr&egrave;s la conversion du projet pour &eacute;viter tout
probl&egrave;me de compatibilit&eacute; ascendante.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
65
Modules de plug-in de logiciels
Basculez vers FreeType chaque fois que vous en avez la possibilit&eacute; afin d'avoir un meilleur rendu de page.
Une fois que vous avez bascul&eacute; vers le nouveau rendu de police, sauvegardez le projet et v&eacute;rifiez que tous les textes
s'affichent correctement dans toutes les pages de projet.
Probl&egrave;mes de rendu de police
Si vous basculez un projet cr&eacute;&eacute; avec l'ancien moteur de police vers le moteur de police FreeType, il est possible que vous
rencontriez les probl&egrave;mes suivants :
l
le texte demande plus/moins de pixels pour le rendu, entra&icirc;nant une modification de la mise en page du texte
l
les widgets sont redimensionn&eacute;s pour contenir du texte
l
un meilleur rendu peut &ecirc;tre obtenu en utilisant l'Anticr&eacute;nelage (l’Anticr&eacute;nelage est une propri&eacute;t&eacute; de widget texte)
Modules de plug-in de logiciels
Vous pouvez choisir quels composants logiciels sont t&eacute;l&eacute;charg&eacute;s vers le runtime avec le projet. Le plug-in logiciel a &eacute;t&eacute;
con&ccedil;u pour r&eacute;duire les besoins en m&eacute;moire pour le p&eacute;riph&eacute;rique IHM dans les p&eacute;riph&eacute;riques IHM o&ugrave; le stockage est limit&eacute;.
Cette fonctionnalit&eacute; n'est pas support&eacute;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&eacute;riph&eacute;rique
IHM.
Une fois activ&eacute;, le plug-in de logiciel devient une partie du runtime. Utilisez AGI Creator pour installer en utilisant l'une des
proc&eacute;dures suivantes :
l
installer le runtime/mettre &agrave; jour le runtime
l
paquet de mise &agrave; jour
Pour supprimer les plug-ins du runtime, utilisez l'une des fonctions suivantes en Mode syst&egrave;me :
l
format Flash
l
restaure les param&egrave;tres d'usine.
Important : Le syst&egrave;me ne peut pas d&eacute;tecter automatiquement quels plug-ins de logiciel sont requis
par le p&eacute;riph&eacute;rique IHM, assurez-vous de tous les s&eacute;lectionner dans les propri&eacute;t&eacute;s du projet.
Note : Le support plug-in du logiciel a &eacute;t&eacute; con&ccedil;u pour les p&eacute;riph&eacute;riques IHM int&eacute;gr&eacute;s o&ugrave; le stockage est limit&eacute;.
Cette fonctionnalit&eacute; n'est pas support&eacute;e par la plateforme Win32.
Comportement
Ces propri&eacute;t&eacute;s d&eacute;finissent diff&eacute;rents &eacute;l&eacute;ments du comportement d'une page.
66
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Page d'accueil
La premi&egrave;re page charg&eacute;e &agrave; l'ex&eacute;cution (apr&egrave;s la page de connexion si la s&eacute;curit&eacute; est activ&eacute;e dans le projet).
Lorsque la s&eacute;curit&eacute; est activ&eacute;e, vous pouvez sp&eacute;cifier une page d'accueil diff&eacute;rente pour chaque groupe d'utilisateurs. Le
cas &eacute;ch&eacute;ant, ce param&egrave;tre est ignor&eacute;. Voir &quot;Gestion et mots de passe utilisateur&quot; on page 217 pour plus de d&eacute;tails.
Largeur de la page/Hauteur de la page
D&eacute;finit la taille par d&eacute;faut en pixels d'une page IHM. Lors de la cr&eacute;ation du projet, la r&eacute;solution d'affichage du mod&egrave;le de
p&eacute;riph&eacute;rique IHM s&eacute;lectionn&eacute; est par d&eacute;faut.
Mode d'affichage
D&eacute;finit l'orientation du p&eacute;riph&eacute;rique IHM.
Type de projet
D&eacute;finit le type de p&eacute;riph&eacute;rique IHM pour le projet. Selon le mod&egrave;le, certaines fonctionnalit&eacute;s et propri&eacute;t&eacute;s du projet sont
ajust&eacute;es automatiquement.
AVERTISSEMENT : &Agrave; partir de la version v2, le HMI Runtime v&eacute;rifie que le projet s&eacute;lectionn&eacute;
correspond au mod&egrave;le de p&eacute;riph&eacute;rique IHM ; lorsque le type s&eacute;lectionn&eacute; ne correspond pas, le
message suivant appara&icirc;t : &laquo; Discordance du type d'IHM. Convertissez le projet et t&eacute;l&eacute;chargez-le de
nouveau &raquo;
M&eacute;moire panneau
Taille de la m&eacute;moire interne du panneau disponible.
Requ&ecirc;tePage, PageActuelle et OptionsSync
Avec HMI Runtime, vous pouvez &eacute;changer les informations des p&eacute;riph&eacute;riques sur la page affich&eacute;e par l'IHM. Vous pouvez
synchroniser les pages affich&eacute;es sur le p&eacute;riph&eacute;rique IHM et sur AGI Client, ou bien vous pouvez contr&ocirc;ler un projet IHM
depuis un contr&ocirc;leur tel qu'un API.
Les propri&eacute;t&eacute;s suivantes peuvent &ecirc;tre personnalis&eacute;es :
Propri&eacute;t&eacute;
Description
Requ&ecirc;tePage Page qui doit s'afficher sur le p&eacute;riph&eacute;rique IHM et sur AGI Client.
Une variable associ&eacute;e doit contenir une valeur enti&egrave;re dans la plage des pages disponibles du projet et
elle doit &ecirc;tre disponible au moins en tant que Ressource lisible.
PageActuelle Num&eacute;ro de page affich&eacute; sur le p&eacute;riph&eacute;rique IHM, sur AGI Client ou sur les deux.
Une variable associ&eacute;e doit &ecirc;tre disponible au moins en tant que Ressource &eacute;crivable et doit avoir un
type entier de donn&eacute;es.
OptionsSync
Synchronisation des pages du projet avec la valeur contenue dans la propri&eacute;t&eacute; PageActuelle.
Les options sont :
l
d&eacute;sactiver : la valeur du num&eacute;ro de la page est ignor&eacute;e,
l
local : le num&eacute;ro de page est affich&eacute; sur l'IHM,
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
67
Comportement
Propri&eacute;t&eacute;
Description
l
l
&agrave; distance : le num&eacute;ro de page est affich&eacute; sur AGI Client.
local + &agrave; distance : le num&eacute;ro de page est affich&eacute; sur l'IHM et sur AGI Client ; si diff&eacute;rentes
pages sont affich&eacute;es, le num&eacute;ro de page affich&eacute; est celui de la derni&egrave;re page charg&eacute;e.
Exemple : modification forc&eacute;e de la page depuis le contr&ocirc;leur/API au p&eacute;riph&eacute;rique IHM et au AGI
Client
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo;
PageActuelle
vide
OptionsSync
d&eacute;sactiver
D&eacute;finissez la valeur de la variable &laquo; A &raquo; pour afficher la page demand&eacute;e sur le p&eacute;riph&eacute;rique IHM et sur le AGI Client.
Exemple : modification forc&eacute;e de la page depuis le contr&ocirc;leur/API &agrave; l'IHM et au AGI Client. Lisez la
page actuellement charg&eacute;e sur l'IHM
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo;
PageActuelle
associ&eacute;e &agrave; la variable &laquo; B &raquo; en tant que lire/&eacute;crire
OptionsSync
locale
D&eacute;finissez la valeur de la variable &laquo; A &raquo; pour afficher la page demand&eacute;e sur le p&eacute;riph&eacute;rique IHM et sur le AGI Client. La
variable &laquo; B &raquo; contient le num&eacute;ro de la page actuellement affich&eacute;e par le p&eacute;riph&eacute;rique.
Exemple : modification forc&eacute;e de la page depuis le contr&ocirc;leur/API au p&eacute;riph&eacute;rique IHM et au AGI
Client. Lisez la page actuellement charg&eacute;e sur AGI Client.
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo;
PageActuelle
associ&eacute;e &agrave; la variable &laquo; B &raquo; en tant que lire/&eacute;crire
OptionsSync
&agrave; distance
D&eacute;finissez la valeur de la variable &laquo; A &raquo; pour afficher la page demand&eacute;e sur l'IHM et sur le AGI Client. La variable &laquo; B &raquo;
contient le num&eacute;ro de la page actuellement affich&eacute;e par AGI Client.
Exemple : modification forc&eacute;e de la page depuis le contr&ocirc;leur/API au p&eacute;riph&eacute;rique IHM et au AGI
Client. Synchronisation forc&eacute;e de la page AGI Client avec le p&eacute;riph&eacute;rique IHM (et non l'inverse).
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
68
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo; en tant que lire/&eacute;crire
PageActuelle
associ&eacute;e &agrave; la m&ecirc;me variable &laquo; A &raquo; que pour Requ&ecirc;tePage
OptionsSync
locale
D&eacute;finissez la valeur de la variable &laquo; A &raquo; pour afficher la page demand&eacute;e sur l'IHM et sur le AGI Client. Changez de page sur
l'IHM pour afficher la m&ecirc;me page sur AGI Client.
Exemple : modification forc&eacute;e de la page depuis le contr&ocirc;leur/API au p&eacute;riph&eacute;rique IHM et au AGI
Client. Synchronisation forc&eacute;e de l'IHM avec AGI Client (et non l'inverse).
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo; en tant que lire/&eacute;crire
PageActuelle
associ&eacute;e &agrave; la m&ecirc;me variable &laquo; A &raquo; que pour Requ&ecirc;tePage
OptionsSync
&agrave; distance
Changez la valeur de la variable &laquo; A &raquo; pour afficher la page demand&eacute;e sur l'IHM et sur le AGI Client. Changez de page sur
AGI Client pour afficher la m&ecirc;me page sur l'IHM.
Exemple : synchronisez la page affich&eacute;e entre le p&eacute;riph&eacute;rique IHM et le AGI Client
D&eacute;finissez les propri&eacute;t&eacute;s de la fa&ccedil;on suivante :
Requ&ecirc;tePage
associ&eacute;e &agrave; la variable &laquo; A &raquo; en tant que lire/&eacute;crire
PageActuelle
associ&eacute;e &agrave; la m&ecirc;me variable &laquo; A &raquo; que pour Requ&ecirc;tePage
OptionsSync
local + &agrave; distance
En changeant de page sur le p&eacute;riph&eacute;rique IHM, la m&ecirc;me page sera affich&eacute;e sur AGI Client et vice-versa.
Requ&ecirc;tePageWeb
Vous pouvez synchroniser les pages affich&eacute;es sur le AGI Web Clients depuis un contr&ocirc;leur tel qu'un API.
Les propri&eacute;t&eacute;s suivantes peuvent &ecirc;tre personnalis&eacute;es :
Propri&eacute;t&eacute;
Description
Requ&ecirc;tePageWeb Page &agrave; afficher sur le AGI Web Client.
Une variable associ&eacute;e doit contenir une valeur enti&egrave;re dans la plage des pages disponibles du projet
et elle doit &ecirc;tre disponible au moins en tant que Ressource lisible.
Temps de maintien/Temps de r&eacute;p&eacute;tition auto
D&eacute;finit les valeurs de temps de maintien et de temps de r&eacute;p&eacute;tition auto pour les boutons et les claviers externes.
Note : Ces propri&eacute;t&eacute;s peuvent &ecirc;tre red&eacute;finies pour chaque bouton ou touche dans le tableau des propri&eacute;t&eacute;s de
leur widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
69
Comportement
D&eacute;lai d'attente inactivit&eacute; web
D&eacute;finit un d&eacute;lai d'attente pour AGI Web client. Lorsque le d&eacute;lai d'attente expire sans activit&eacute;, l'utilisateur actuel est
d&eacute;connect&eacute;.
Range
1–86 400 s (forme 1 s &agrave; 24 h)
Valeur par d&eacute;faut
600 s
Valeurs
0 = d&eacute;sactiv&eacute;
Ic&ocirc;ne web
L’ic&ocirc;ne pr&eacute;f&eacute;r&eacute;e associ&eacute;e aux pages web
Temps de rafra&icirc;chissement
D&eacute;finit le temps de rafra&icirc;chissement pour la communication entre le runtime et AGI Web clients.
Range
500–10 000 ms
Valeur par d&eacute;faut
3000 ms
Optimisation du navigateur
vrai
Activation de l’optimisation du moteur Web (par d&eacute;faut)
faux D&eacute;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&eacute;es envoy&eacute;es par le serveur (utile pour les vieux navigateurs lents). Configurer sur 0 pour
utiliser toute la bande passante disponible (par d&eacute;faut)
Mode de connexion des clients Web
Auto
Le mode de connexion est s&eacute;lectionn&eacute; par le client (par d&eacute;faut)
SSE
Forcer le mode d'&eacute;v&eacute;nements envoy&eacute;s par serveur
Longue scrutation
Forcer le mode de scrutation longue
Facteur de zoom cible
Le facteur de zoom du p&eacute;riph&eacute;rique IHM est appliqu&eacute; lorsque le projet est charg&eacute; &agrave; l'ex&eacute;cution.
Range
0.3–2.9
Valeur par d&eacute;faut
1 = pas de zoom
70
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
6 Propri&eacute;t&eacute;s de projet
Options couleur de fond
Lorsque la page d&eacute;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&eacute;zoom&eacute;e)
Propri&eacute;t&eacute;
Description
Aucun
Ancien mode, la couleur est blanche (par d&eacute;faut)
Couleur s&eacute;lectionn&eacute;e
Couleur &agrave; utiliser
Couleur de fond de page
Ajuste automatiquement la couleur selon la couleur d'arri&egrave;re-plan du
mod&egrave;le ou de la page
&Eacute;v&eacute;nements
OnWheel
Utilis&eacute; uniquement avec des p&eacute;riph&eacute;riques d'entr&eacute;e de la molette. G&eacute;n&eacute;ralement, la molette est utilis&eacute;e pour
augmenter/diminuer la valeur d'une variable sans clavier externe.
Combinez cette propri&eacute;t&eacute; &agrave; un &eacute;v&eacute;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 | &copy; 2012-2017 DEIF A/S
71
&Eacute;v&eacute;nements
72
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
7
Le simulateur IHM
Le simulateur IHM vous permet de tester des projets avant de le t&eacute;l&eacute;charger sur le p&eacute;riph&eacute;rique IHM. Il peut &ecirc;tre utilis&eacute; pour
tester le projet lorsque aucun p&eacute;riph&eacute;rique IHM est disponible et pour acc&eacute;l&eacute;rer les activit&eacute;s de d&eacute;veloppement et de
d&eacute;bogage.
Le simulateur IHM supporte :
l
l
simulation en ligne - en communication avec des appareils r&eacute;els (uniquement pour les protocoles avec Ethernet ou
de communication RS-232),
simulation hors ligne - simulant le comportement de variable
La m&eacute;thode de simulation de donn&eacute;es est d&eacute;finie dans la colonne Simulateur de l'&eacute;diteur de variable.
M&eacute;thodes de simulation des donn&eacute;es
74
Param&egrave;tres du simulateur
74
Lancer et arr&ecirc;ter le simulateur
75
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
73
M&eacute;thodes de simulation des donn&eacute;es
M&eacute;thodes de simulation des donn&eacute;es
D&eacute;finissez le comportement de simulation de variable dans le champ Simulateur de l'&Eacute;diteur de variables.
M&eacute;thode
Description
Variables
Les donn&eacute;es sont stock&eacute;es dans une variable de simulation. Cette variable maintient la valeur de la
variable pour que vous puissiez lire et &eacute;crire la valeur.
Signal en
dents de
scie
Une valeur du nombre est incr&eacute;ment&eacute;e de Offset &agrave; Amplitude + valeur Offset avec une P&eacute;riode de 60 &agrave;
3600 secondes. Lorsque le d&eacute;compte atteint Amplitude + Offset, la valeur est r&eacute;initialis&eacute;e &agrave; Offset et le
d&eacute;compte recommence.
Signal
sinuso&iuml;dal
Une valeur de signal sinuso&iuml;dal est g&eacute;n&eacute;r&eacute;e et &eacute;crite sur la valeur de la variable. Des valeurs Min., Max.
et P&eacute;riode peuvent &ecirc;tre d&eacute;finies pour chaque variable.
Signal
Une valeur de signal triangulaire est g&eacute;n&eacute;r&eacute;e et &eacute;crite sur la valeur de la variable. Des valeurs Min., Max.
triangulaire et P&eacute;riode peuvent &ecirc;tre d&eacute;finies pour chaque variable.
Signal
carr&eacute;
Une valeur de signal carr&eacute; est g&eacute;n&eacute;r&eacute;e et &eacute;crite sur la valeur de la variable. Des valeurs Min., Max. et
P&eacute;riode peuvent &ecirc;tre d&eacute;finies pour chaque variable.
Voir &quot;Ajouter des variables&quot; on page 27 pour plus de d&eacute;tails.
Param&egrave;tres du simulateur
Le Simulateur travail par d&eacute;faut avec les protocoles simul&eacute;s. Il peut &eacute;galement travailler avec de vrais protocols (Ethernet
ou des protocoles en s&eacute;rie)
Note : Pour les protocoles ne supportant pas la communication avec des p&eacute;riph&eacute;riques externes, tels que le
protocole Variables, cette option est toujours d&eacute;sactiv&eacute;e.
Modification des protocoles simul&eacute;s
1. Cliquez sur l'ic&ocirc;ne Param&egrave;tres du simulateur.
74
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
7 Le simulateur IHM
2. S&eacute;lectionnez Utiliser Simulation pour utiliser des protocoles simul&eacute;s, sinon de v&eacute;ritables protocoles seront utilis&eacute;s
pour la communication avec des p&eacute;riph&eacute;riques externes.
Lancer et arr&ecirc;ter le simulateur
Pour lancer le simulateur :
1. Dans le menu Ex&eacute;cuter, cliquez sur D&eacute;marrer le simulateur : le simulateur fonctionne sur l'ordinateur de la m&ecirc;me
fa&ccedil;on que le serveur sur le p&eacute;riph&eacute;rique IHM.
Pour arr&ecirc;ter le simulateur :
1. Dans le menu Ex&eacute;cuter, cliquez sur Arr&ecirc;ter le simulateur ou bien double-cliquez sur le bouton Quitter sur la page
simul&eacute;e.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
75
Lancer et arr&ecirc;ter le simulateur
76
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
8 Transf&eacute;rer le projet au p&eacute;riph&eacute;rique
IHM
Pour transf&eacute;rer le AGI Creator projet sur le p&eacute;riph&eacute;rique IHM, vous pouvez utiliser :
l
fonction Ex&eacute;cuter &gt; T&eacute;l&eacute;charger sur la cible
l
fonction Ex&eacute;cuter &gt; Paquet de Mise &agrave; jour en utilisant un P&eacute;riph&eacute;rique USB
T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM
78
Paquet de mise &agrave; jour
81
Le chargeur de runtime
83
Charger projets
84
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
77
T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM
T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM
Chemin : Ex&eacute;cuter&gt; T&eacute;l&eacute;charger sur la cible
Cette fonction transfert un projet et HMI Runtime via Ethernet.
Note : Le p&eacute;riph&eacute;rique IHM doit avoir une adresse IP valide. Voir &quot;Param&egrave;tres de base du p&eacute;riph&eacute;rique IHM&quot; on
page 8 pour des d&eacute;tails sur la mani&egrave;re d'assigner une adresse IP.
1. Cliquez sur le bouton d&eacute;couverte : une liste des adresses IP d&eacute;tect&eacute;es s'affiche.
2. S&eacute;lectionnez l'adresse IP du p&eacute;riph&eacute;rique IHM.
Vous pouvez m&ecirc;me entrer l'adresse IP manuellement ou, le cas &eacute;ch&eacute;ant, le nom d'h&ocirc;te fourni par un serveur DNS.
Utiliser un outil de service tel que Bonjour, les p&eacute;riph&eacute;riques IHM bas&eacute;s sur Linux peuvent &ecirc;tre d&eacute;couverts en
utilisant leur nom d’h&ocirc;te (par ex. HMI-0d37.local). Bonjour est une marque d’Apple inc.
3. Cliquez sur T&eacute;l&eacute;charger : AGI Creator passe le p&eacute;riph&eacute;rique IHM en Mode configuration et transf&egrave;re les fichiers.
Lorsque l'op&eacute;ration de t&eacute;l&eacute;chargement est termin&eacute;e, le p&eacute;riph&eacute;rique IHM revient automatiquement au mode de
fonctionnement et le projet est lanc&eacute;.
Options avanc&eacute;es
Option
Description
T&eacute;l&eacute;charger
uniquement les
modifications
Transf&egrave;re uniquement les fichiers de projet modifi&eacute;s au p&eacute;riph&eacute;rique IHM.
Format binaire
T&eacute;l&eacute;charge des fichiers en utilisant le format binaire.
78
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
8 Transf&eacute;rer le projet au p&eacute;riph&eacute;rique IHM
Option
Description
Supprimer les fichiers Les configurations modifi&eacute;es de recettes, d'utilisateurs, de planificateurs, etc. qui ont &eacute;t&eacute;
dynamiques de
r&eacute;alis&eacute;es en cours d'ex&eacute;cution sont supprim&eacute;es et &eacute;cras&eacute;es par la configuration d&eacute;finie dans
runtime
le projet.
AVERTISSEMENT : Cette op&eacute;ration ne peut pas &ecirc;tre annul&eacute;e, les fichiers
dynamiques supprim&eacute;s ne peuvent pas &ecirc;tre restaur&eacute;s.
AVERTISSEMENT : Les fichiers dynamiques ne sont pas supprim&eacute;s
lorsqu'ils sont stock&eacute;s dans des p&eacute;riph&eacute;riques externes (USB ou cartes SD).
T&eacute;l&eacute;charger projet
web
T&eacute;l&eacute;charge les pages du AGI Web au p&eacute;riph&eacute;rique IHM.
Lorsque vous transf&eacute;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&eacute;cution,
session FTP - transf&egrave;re les fichiers sur la m&eacute;moire flash dans le p&eacute;riph&eacute;rique IHM.
Param&egrave;tres avanc&eacute;s
En utilisant l'option &laquo; Param&egrave;tres avanc&eacute;s &raquo;, vous pouvez d&eacute;finir les ports &agrave; utiliser, mais en g&eacute;n&eacute;ral, vous n'avez pas
besoin de saisir ces informations parce que les p&eacute;riph&eacute;riques IHM fourniront les ports &agrave; utiliser &agrave; l'int&eacute;rieur de la liste du
volet.
Changer de param&egrave;tres de connexion du p&eacute;riph&eacute;rique IHM
Chemin : Ex&eacute;cuter&gt; G&eacute;rer cible
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
79
T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM
1. Cliquez sur Configuration cible : la bo&icirc;te de dialogue Param&egrave;tres avanc&eacute;s s'affiche. Le port par d&eacute;faut pour les
connexions HTTPS sur le p&eacute;riph&eacute;rique IHM est le port 80.
2. D&eacute;finissez les bons ports HTTP, FTP ou HTTPS, FTPS pour le p&eacute;riph&eacute;rique IHM. (Ce sont les ports utilis&eacute;s par le
syst&egrave;me pour se connecter au p&eacute;riph&eacute;rique IHM et ils peuvent avoir besoin d'&ecirc;tre modifi&eacute;s lorsque les ports par
d&eacute;faut sont utilis&eacute;s par d'autres services ou d’autres applications ou si le r&eacute;seau local n&eacute;cessite des r&eacute;glages
sp&eacute;cifiques.)
3. Sp&eacute;cifiez un Nom d'h&ocirc;te pour identifier facilement chaque p&eacute;riph&eacute;rique dans un r&eacute;seau o&ugrave; plusieurs p&eacute;riph&eacute;riques
sont disponibles. Le nom d'h&ocirc;te par d&eacute;faut est &laquo; IHM &raquo; pour tous les p&eacute;riph&eacute;riques.
4. Cliquez sur T&eacute;l&eacute;charger fichiers syst&egrave;me. Au t&eacute;l&eacute;chargement suivant, les nouveaux ports sont utilis&eacute;s dans le
p&eacute;riph&eacute;rique IHM et le nouveau nom d'h&ocirc;te appara&icirc;t dans la liste d&eacute;roulante
G&eacute;rer des projets volumineux
Pour que le t&eacute;l&eacute;chargement fonctionne, la taille maximale du projet devrait &ecirc;tre au moins inf&eacute;rieure de 2 MB &agrave; la m&eacute;moire
disponible. Dans le cas contraire, vous manquez de m&eacute;moire flash dans le p&eacute;riph&eacute;rique IHM et un message
d'avertissement s'affiche.
Pour lib&eacute;rer plus de m&eacute;moire :
1. Cliquez sur G&eacute;rer cible.
2. Supprimez les projets dont vous n'avez plus besoin pour que plus de m&eacute;moire soit disponible.
80
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
8 Transf&eacute;rer le projet au p&eacute;riph&eacute;rique IHM
Paquet de mise &agrave; jour
Pour installer ou mettre &agrave; jour HMI Runtime et le projet, vous pouvez cr&eacute;er un paquet &agrave; charger via USB.
Important : Toujours inclure &agrave; la fois projet et le runtime dans les paquets de mise &agrave; jour.
Si vous avez besoin d'utiliser un vieux projet avec la derni&egrave;re version du runtime, convertir d’abord le projet. Voir &quot;Installer
l’application&quot; on page 2 pour plus de d&eacute;tails.
Cr&eacute;ation d’un paquet de mise &agrave; jour
Chemin : Ex&eacute;cuter&gt; Paquet de mise &agrave; jour
Option
Description
&Eacute;chec du
red&eacute;marrage de la
cible
Type de p&eacute;riph&eacute;rique IHM. S&eacute;lectionn&eacute; automatiquement si le projet est ouvert.
Projet
Ajouter un projet ouvert &agrave; un paquet de mise &agrave; jour.
Runtime &amp; Plug-In
IHM
Le runtime IHM est ajout&eacute;e au paquet de mise &agrave; jour. Si le projet est ouvert, les plugins
n&eacute;cessaires sont &eacute;galement ajout&eacute;s pour mettre &agrave; jour le paquet.
Format binaire
T&eacute;l&eacute;charge des fichiers en utilisant le format binaire.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
81
Paquet de mise &agrave; jour
Option
Description
Projet web
T&eacute;l&eacute;charge les pages du AGI Web au p&eacute;riph&eacute;rique IHM.
Configurer mot de
passe cible
D&eacute;finir le mot de passe pour effectuer des t&acirc;ches critiques (par exemple,
t&eacute;l&eacute;chargement/chargement de projet, gestion de la carte)
Voir &quot;Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;riques IHM&quot; on page 417.
Fichiers utilisateurs
S&eacute;lectionner les fichiers &agrave; copier dans le dossier QTHM du p&eacute;riph&eacute;rique IHM. Taille max. 5 Mo
Crypt&eacute;
Permet le chiffrement du paquet de mise &agrave; jour de sorte qu'il ne peut &ecirc;tre d&eacute;compress&eacute; par le
runtime IHM.
Emplacement
Emplacement du paquet de mise &agrave; jour.
Exemple d’emplacement du fichier utilisateur
Ordinateur :
C:\Users\Username\Desktop\myFolder
- subFolder1/file1
- subFolder1/file2
- file3
- file4
P&eacute;riph&eacute;riques WinCE :
/Flash/QtHmi
- subFolder1/file1
- subFolder1/file2
- file3
- file4
P&eacute;riph&eacute;riques Linux :
/mnt/data/hmi/qthmi
- subFolder1/file1
- subFolder1/file2
- file3
- file4
Note : Une copie des fichiers utilisateur est disponible uniquement depuis la cl&eacute; USB.
Cr&eacute;ation d’un paquet de mise &agrave; jour
Chemin : depuis le menu contextuel &gt; Mise &agrave; jour
82
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
8 Transf&eacute;rer le projet au p&eacute;riph&eacute;rique IHM
1. En supposant que vous avez enregistr&eacute; le paquet dans le dossier racine d'une cl&eacute; USB, retirer le disque de
l'ordinateur, le brancher dans le p&eacute;riph&eacute;rique IHM, afficher le menu contextuel en maintenant votre doigt pendant
quelques secondes sur l'&eacute;cran et s&eacute;lectionnez Mettre &agrave; jour.
2. Le syst&egrave;me v&eacute;rifie la pr&eacute;sence du paquet de mise &agrave; jour &agrave; la racine du lecteur USB et demande la confirmation de
proc&eacute;der &agrave; la mise &agrave; jour.
3. S&eacute;lectionner meilleur match de s&eacute;lectionne automatique et cliquer sur Next : la proc&eacute;dure se termine
automatiquement. Vous pouvez &eacute;galement utiliser le bouton de navigation pour s&eacute;lectionner le fichier &agrave; utiliser.
Le chargeur de runtime
Les p&eacute;riph&eacute;riques IHM sont livr&eacute;s depuis l'usine sans le Runtime.
Lorsque vous mettez le p&eacute;riph&eacute;rique pour la premi&egrave;re fois, la fen&ecirc;tre Runtime Loader s'affiche (voir &quot;Param&egrave;tres du
syst&egrave;me&quot; on page 369 pour plus de d&eacute;tails)
La pr&eacute;sence du chargeur de runtime d&eacute;pend du syst&egrave;me d'exploitation du p&eacute;riph&eacute;rique et peut ne pas &ecirc;tre
disponible sur toutes les unit&eacute;s. Les anciennes versions des p&eacute;riph&eacute;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&eacute;l&eacute;chargez un projet, le Runtime est install&eacute;e automatiquement si n&eacute;cessaire.
Voir &quot;Transf&eacute;rer le projet au p&eacute;riph&eacute;rique IHM&quot; on page 77 pour plus de d&eacute;tails.
1. Cliquez sur Installer Runtime : la proc&eacute;dure est ex&eacute;cut&eacute;e automatiquement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
83
Charger projets
Installation du runtime depuis une cl&eacute; USB
1. Pr&eacute;parer le paquet de mise &agrave; jour comme d&eacute;crit dans &quot;Paquet de mise &agrave; jour&quot; on page 81
2. Brancher la cl&eacute; USB dans le p&eacute;riph&eacute;rique et suivre les instructions pour le type de p&eacute;riph&eacute;rique (voir &quot;Param&egrave;tres du
syst&egrave;me&quot; on page 369 pour plus de d&eacute;tails)
Note : Les anciennes versions des p&eacute;riph&eacute;riques IHM ne peuvent pas supporter l’installation automatique du
Runtime. Contactez le support technique pour obtenir plus d’informations.
Charger projets
Chemin : Ex&eacute;cuter&gt; G&eacute;rer cible
Vous pouvez copier un projet depuis le runtime sur un ordinateur o&ugrave; AGI Creator est en cours d’ex&eacute;cution.
1. Dans l’onglet Runtime, s&eacute;lectionner l'adresse IP du p&eacute;riph&eacute;rique depuis la Cible de la liste d&eacute;roulante.
2. Cliquez sur R&eacute;cup&eacute;ration des projets : une liste de tous les projets disponible est affich&eacute;e.
3. S&eacute;lectionner le projet &agrave; t&eacute;l&eacute;charger
4. Cliquer sur T&eacute;l&eacute;charger le projet
Le t&eacute;l&eacute;chargement pourrait &ecirc;tre prot&eacute;g&eacute; par un mot de passe Voir &quot;Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;riques
IHM&quot; on page 417 pour plus de d&eacute;tails.
5. Si besoin, entrer le mot de passe. Le processus de t&eacute;l&eacute;chargement d&eacute;marre.
Une copie du projet est enregistr&eacute; dans :
C:\Users\username\Documents\AGI Creator\workspace\Uploaded\RuntimeIPAddress\workspace\ProjectName
Note : Si l’op&eacute;ration de chargement &eacute;choue, v&eacute;rifier les param&egrave;tres du pare-feu de l’Ordinateur o&ugrave; AGI Creator
est en cours d’ex&eacute;cution.
84
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9
Variables syst&egrave;me
Chemin : Source&gt; Associer &agrave;
Les variables syst&egrave;me sont des variables sp&eacute;ciales qui contiennent des informations concernant le runtime de l'IHM.
Note : Les Variables syst&egrave;mes sont disponibles &eacute;galement en tant que protocole standard dans l'&eacute;diteur de
protocoles. Utilisez les Variables syst&egrave;me en tant que protocole quand vous transf&eacute;rez des donn&eacute;es entre les
variables syst&egrave;me et des variables de p&eacute;riph&eacute;riques ou s&eacute;lectionnez une fr&eacute;quence de rafra&icirc;chissement
personnalis&eacute;e pour une variable syst&egrave;me.
Variables d'alarmes
87
Variables du signal sonore
87
Variables de communication
88
Variables de passage &agrave; l'heure d'&eacute;t&eacute;
88
Variables p&eacute;riph&eacute;riques
89
Variables informations de vidage
91
Variables client FTP
92
Variables clavier
92
Variables r&eacute;seau
92
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
85
Variables d’impression
93
Variables client &agrave; distance
94
Variables de version
94
Variable &eacute;cran
95
Variables carte SD
95
Variables serveur
95
Variables d’heure
96
Variables &eacute;cran tactile
96
Variables lecteur USB
98
Variables de gestion des utilisateurs
98
86
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Variables d'alarmes
Nombre d'alarmes du type demand&eacute;.
Variable
Description
Type de
donn&eacute;es
Alarm not acknowledged
Vrai quand Alarmes non confirm&eacute;es est en attente d'ex&eacute;cution
boolean
(Non d&eacute;clench&eacute;e Ne pas confirmer&lt;&gt;0) OU (D&eacute;clench&eacute;e Ne pas
confirmer&lt;&gt;0)
read only
Vrai quand au moins une alarme a &eacute;t&eacute; d&eacute;clench&eacute;e
boolean
(D&eacute;clench&eacute;e Confirm&eacute;e&lt;&gt;0) OU (D&eacute;clench&eacute;e&lt;&gt;0) OU (D&eacute;clench&eacute;e Ne
pas confirmer&lt;&gt;0)
read only
Number of missed alarm
events
Alarmes qui d&eacute;passent la queue des &eacute;v&eacute;nements. La longueur de la queue
est d&eacute;finie dans le fichier engineconfig.xml.
int
Number of not triggered
acknowledged
Condition d'alarme plus active ; alarmes d&eacute;j&agrave; confirm&eacute;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&eacute;j&agrave; confirm&eacute;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&eacute;, les anciens noms restent toujours valides m&ecirc;me s'ils sont obsol&egrave;tes.
Variables du signal sonore
Ajuster le comportement du signal sonore.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
87
Variables de communication
Type de
donn&eacute;es
Variable
Description
Buzzer
Setup
0 = d&eacute;sactiv&eacute;
1 = activ&eacute; (le signal sonore est audible pour tous les &eacute;v&eacute;nements de l'&eacute;cran tactile)
2 = &eacute;tat de bipeur contr&ocirc;l&eacute; par la variable syst&egrave;me de contr&ocirc;le Bipeur ou par la propri&eacute;t&eacute;
Bipeur tactile dans les &quot;Propri&eacute;t&eacute;s de projet&quot; on page 59
int
Le bipeur sur l'&eacute;cran tactile (Setup = 1) n’est pas disponible sur les
plateformes Linux. Voir la propri&eacute;t&eacute; &laquo; Bipeur tactile &raquo; comme alternative.
Buzzer
Control
0 = signal sonore &eacute;teint
1 = signal sonore allum&eacute;
2 = clignotement
int
Buzzer
Off Time
Dur&eacute;e en millisecondes du temps d'arr&ecirc;t du signal lorsque le clignotement a &eacute;t&eacute; s&eacute;lectionn&eacute;.
Par d&eacute;faut = 1 000. Plage : 100-5 000.
int
Buzzer
On Time
Dur&eacute;e en millisecondes du temps du signal sonore lorsque le clignotement a &eacute;t&eacute; s&eacute;lectionn&eacute;.
Par d&eacute;faut = 1 000. Plage : 100-5 000.
int
Variables de communication
&Eacute;tat de communication entre le p&eacute;riph&eacute;rique IHM et les contr&ocirc;leurs.
Variable
Type de
donn&eacute;es
Description
Protocol
R&eacute;sume l'&eacute;tat des protocoles de communication.
Communication
0 = Aucun protocole en cours d'ex&eacute;cution, il est possible que les pilotes des protocoles
Status
n'aient pas &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;s correctement sur le p&eacute;riph&eacute;rique IHM.
int
Read
only
1 = Protocoles charg&eacute;s et d&eacute;marr&eacute;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 : &laquo; [xxxx] &raquo; ou &laquo; xxxx &raquo; est l'abr&eacute;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 &eacute;t&eacute; signal&eacute;e.
Protocol Error
Count
Nombre d'erreurs de communication survenues depuis la derni&egrave;re r&eacute;initialisation.
R&eacute;initialisez la valeur &agrave; l'aide de l'action de R&eacute;initialisation du d&eacute;compte d'erreurs de
protocoles, cf. &quot;Actions syst&egrave;me&quot; on page 123.
Cha&icirc;ne
ASCII
Read
only
int
Read
only
Variables de passage &agrave; l'heure d'&eacute;t&eacute;
Informations concernant l'horloge syst&egrave;me. Ces variables contiennent des informations concernant l'heure locale. Les
options disponibles sont le temps standard (heure solaire) et l'heure d'&eacute;t&eacute; (DST).
88
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Note : Toutes les variables sont en lecture seule ; il n'est pas possible de les utiliser pour mettre &agrave; jour l'horloge
syst&egrave;me.
Variable
Description
Standard
Offset
D&eacute;calage en minutes par rapport au GMT lorsque l'heure est r&eacute;gl&eacute;e sur l'heure standard (par exemple : 8 x 60 = -480 minutes).
Standard
Week
Semaine &agrave; partir de laquelle l'heure standard est appliqu&eacute;e (par exemple : Premi&egrave;re = 1).
Standard
Month
Mois &agrave; partir duquel l'heure standard est appliqu&eacute;e. Plage : 0-11. (par exemple : Novembre = 10).
Standard
Day
Jour de la semaine &agrave; partir duquel l'heure standard est appliqu&eacute;e (par exemple : Dimanche = 0).
Standard
Hour
Heure &agrave; partir de laquelle l'heure standard est appliqu&eacute;e (par exemple : 02 = 2).
Standard
Minute
Minute &agrave; partir de laquelle l'heure standard est appliqu&eacute;e (par exemple : 00 = 0).
DST Offset
D&eacute;calage en minutes par rapport au GMT lorsque l'heure est r&eacute;gl&eacute;e sur l'heure d'&eacute;t&eacute;
DST Week
Semaine &agrave; partir de laquelle l'heure d'&eacute;t&eacute; est appliqu&eacute;e
DST Month
Mois &agrave; partir duquel l'heure d'&eacute;t&eacute; est appliqu&eacute;e. Plage : 0-11.
DST Day
Jour de la semaine &agrave; partir duquel l'heure d'&eacute;t&eacute; est appliqu&eacute;e
DST Hour
Heure &agrave; partir de laquelle l'heure d'&eacute;t&eacute; est appliqu&eacute;e
DST Minute
Minute &agrave; partir de laquelle l'heure d'&eacute;t&eacute; est appliqu&eacute;e
Variables p&eacute;riph&eacute;riques
Param&egrave;tres des p&eacute;riph&eacute;riques et informations d'&eacute;tat de fonctionnement.
Variable
Description
Type de
donn&eacute;es
Available
System
Memory
M&eacute;moire RAM libre en octets.
uint64
Backlight
Time
Temps d'activation en heures du r&eacute;tro&eacute;clairage de l'affichage depuis la fabrication du
p&eacute;riph&eacute;rique.
unsignedInt
Battery LED
Active/d&eacute;sactive l'indicateur de batterie faible pour la LED (si disponible).
int
read only
read only
0 = d&eacute;sactiv&eacute;
1 = activ&eacute;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
89
Variables p&eacute;riph&eacute;riques
Variable
Type de
donn&eacute;es
Description
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des
p&eacute;riph&eacute;riques IHM.&quot; on page 431 pour plus de d&eacute;tails sur les panneaux)
Battery
Timeout
R&eacute;serv&eacute;
int
Display
Brightness
R&eacute;initialise et adapte le niveau de luminosit&eacute;.
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des
p&eacute;riph&eacute;riques IHM.&quot; on page 431 pour plus de d&eacute;tails sur les panneaux)
int
M&ecirc;me lorsqu'il est r&eacute;gl&eacute; sur 0, le r&eacute;tro&eacute;clairage reste allum&eacute; et le d&eacute;compte du Backlight
Time continue.
Plage : 0-255
Sur le p&eacute;riph&eacute;rique WinCE uniquement :
Lorsque le r&eacute;tro&eacute;clairage est r&eacute;gl&eacute; sur un niveau de luminosit&eacute; faible (0...3), il reste allum&eacute;
&agrave; un niveau plus &eacute;lev&eacute; pendant 8 secondes afin de permettre &agrave; l'utilisateur d'effectuer les
r&eacute;glages, puis il s'&eacute;teint.
External
Timeout
D&eacute;lai d'inactivit&eacute; apr&egrave;s lequel le r&eacute;tro&eacute;clairage s'&eacute;teint automatiquement. Le r&eacute;tro&eacute;clairage
s'allume automatiquement d&egrave;s que l'utilisateur touche l'&eacute;cran.
int
-1 = &eacute;teindre le r&eacute;tro&eacute;clairage et d&eacute;sactiver les commandes tactiles (&eacute;teindre l'affichage).
Le compteur de temps de r&eacute;tro&eacute;clairage est arr&ecirc;t&eacute;.
0 = allumer le r&eacute;tro&eacute;clairage (allumer l'affichage)
1..n = d&eacute;lai d'attente, en secondes, pour &eacute;teindre le r&eacute;tro&eacute;clairage (minuteur de l'&eacute;cran de
veille)
Sur le p&eacute;riph&eacute;rique Linux (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on page 431
pour les d&eacute;tails du panneau), d&eacute;lai d'attente g&eacute;r&eacute; en quelques minutes. La
valeur saisie est convertie en minutes arrondies &agrave; la valeur suivante, par
exemple, 60, 120, 180.
Flash Free
Space
Espace flash libre restant dans la m&eacute;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&egrave;me
string
Mode
syst&egrave;me
&Eacute;tat de service de runtime.
read only
read only
int
1 = d&eacute;marrage en cours
2 = mode de configuration
90
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Variable
Description
Type de
donn&eacute;es
3 = mode de service
4 = red&eacute;marrage
5 = arr&ecirc;t
System
UpTime
Temps pendant lequel le syst&egrave;me a &eacute;t&eacute; aliment&eacute; depuis la fabrication du groupe (en
heures).
unsignedInt
read only
Variables informations de vidage
&Eacute;tat du processus de copie vers les lecteurs (USB ou carte SD) pour les m&eacute;moires de tendances d'&eacute;v&eacute;nements.
Note : Si la copie prend moins d'une seconde, la valeur de la variable syst&egrave;me reste inchang&eacute;e.
Variable
Description
Type de
donn&eacute;es
Dump
Archive
Status
1 = copie m&eacute;moire d'&eacute;v&eacute;nements en cours
int
Message
d’erreur
Vidage
Retour du message d'erreur si une erreur se produit pendant l'op&eacute;ration de vidage
Dump Recipe
Status
1 = copie m&eacute;moire de recettes en cours
int
Si la copie prend moins d'une seconde, la valeur de la variable syst&egrave;me reste inchang&eacute;e
read only
Dump Trend
Status
1 = copie m&eacute;moire de tendance en cours
int
Reset Recipe
Status
1 = r&eacute;initialisation de m&eacute;moire de recettes en cours
int
Si la r&eacute;initialisation prend moins d'une seconde, la valeur de la variable syst&egrave;me reste
inchang&eacute;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&egrave;me reste inchang&eacute;e.
int
read only
string
read only
read only
read only
0 = &eacute;tat initial par d&eacute;faut
1 = op&eacute;ration d&eacute;clench&eacute;e
2 = op&eacute;ration termin&eacute;e avec succ&egrave;s
3 = op&eacute;ration termin&eacute;e avec erreurs
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
91
Variables client FTP
Variables client FTP
Les variables client FTP sont mises &agrave; jour lorsque les actions FTP sont utilis&eacute;es.
Variable
Description
Type de donn&eacute;es
Commande en cours FTP
Derni&egrave;re commande FTP
string
read only
Message d’erreur FTP
Dernier message d’erreur FTP
string
read only
Progression FTP
Progression t&eacute;l&eacute;chargement / chargement (0/100%)
short
read only
&Eacute;tat FTP
&Eacute;tat de la derni&egrave;re commande FTP :
l
0 = inactif
l
1 = actif
l
2 = effectu&eacute;
l
3 = erreur
short
read only
Variables clavier
&Eacute;tat du clavier.
Variable
Description
Type de donn&eacute;es
Is keypad open
0 = aucun clavier ouvert
int
1 = clavier ouvert
read only
Variables r&eacute;seau
Param&egrave;tres r&eacute;seau du p&eacute;riph&eacute;rique.
Variable
Description
Type de
donn&eacute;es
Adapters
Parameters
Cha&icirc;ne JSON qui permet de lire ou de mettre &agrave; jour les param&egrave;tres d'adaptateurs r&eacute;seau
string
Gateway
Adresse de passerelle de l'interface Ethernet principale du p&eacute;riph&eacute;rique
string
read only
Adresse IP
Adresse IP de l'interface Ethernet principale du p&eacute;riph&eacute;rique
string
read only
92
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Variable
Description
Type de
donn&eacute;es
Mac ID
Mac ID de l'interface Ethernet principale du p&eacute;riph&eacute;rique
string
read only
Status
Subnet Mask
Contient les r&eacute;sultats de la derni&egrave;re op&eacute;ration requise par l'&eacute;criture dans les Param&egrave;tres
des adaptateurs. Cette valeur est actualis&eacute;e apr&egrave;s chaque op&eacute;ration d'&eacute;criture.
l
Si la cha&icirc;ne est vide, cela signifie qu'il n'y a aucune erreur
l
Descriptions des erreurs les plus r&eacute;centes
Masque de sous r&eacute;seau de l'interface Ethernet principale du p&eacute;riph&eacute;rique
string
read only
string
read only
Variables d’impression
Informations concernant les fonctions d'impression.
Variable
Description
Type de
donn&eacute;es
Completion
percentage
Progression de la t&acirc;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&acirc;che traite actuellement. La t&acirc;che actuelle est la
suivante :
Plage : 0-100
read only
Si Flash a &eacute;t&eacute; s&eacute;lectionn&eacute; en tant que Type de m&eacute;dia spool, cette valeur
correspond &agrave; rapportspool.
l
[nom de rapport] pour un Rapport graphique
l
[premi&egrave;re ligne de texte] pour un Rapport texte
read only
Current RAM
usage
Taille en octets de la m&eacute;moire RAM utilis&eacute;e pour le traitement de la t&acirc;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&acirc;ches de graphique dans la queue d'impression
read only
Last error
message
Description de la derni&egrave;re erreur affich&eacute;e
string
RAM quota
Taille maximale en octets de la m&eacute;moire RAM utilis&eacute;e pour la g&eacute;n&eacute;ration des
rapports
read only
Status
&Eacute;tat syst&egrave;me de l'impression.
string
read only
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
93
Variables client &agrave; distance
Variable
Text job queue
size
Description
Type de
donn&eacute;es
Valeurs :
read only
l
idle
l
error
l
paused
l
printing
Nombre de t&acirc;ches de texte dans la queue d'impression
read only
Variables client &agrave; distance
Les variables syst&egrave;me suivantes sont associ&eacute;es aux fichiers lors du transfert sur un p&eacute;riph&eacute;rique IHM distant.
Variable
Description
Type de donn&eacute;es
Download from HMI error message
Description de l'erreur
Cha&icirc;ne ASCII
read only
Download from HMI percentage
Progression du t&eacute;l&eacute;chargement (0 100)
read only
Download from HMI status
0 = inactif, action non utilis&eacute;e ou termin&eacute;e
int (32 bits)
1= t&eacute;l&eacute;chargement du fichier en cours
read only
2 = erreur
Upload to HMI error message
Description de l'erreur
Cha&icirc;ne ASCII
read only
Upload to HMI percentage
Progression du chargement (0 100)
read only
Upload to HMI status
0 = inactif, action non utilis&eacute;e ou termin&eacute;e
int (32 bits)
1= chargement du fichier en cours
read only
2 = erreur
Variables de version
Versions du syst&egrave;me d'exploitation et du runtime.
Variable
Description
Type de donn&eacute;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 | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Variable &eacute;cran
&Eacute;tat de l'&eacute;cran.
Variable
Description
Time remaining to
unlock
Temps restant avant le d&eacute;verrouillage de l'&eacute;cran (voir action LockScreen, &quot;Actions de page&quot;
on page 112)
X Screen resolution
Affiche la taille de l'&eacute;cran horizontal en pixels
Y Screen resolution
Affiche la taille de l'&eacute;cran vertical en pixels
Variables carte SD
Informations concernant la carte SD externe.
Variable
Description
Type de donn&eacute;es
SD Card FreeSpace
Espace de m&eacute;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&eacute;e dans le logement
uint64
read only
SD Card Status
0 = carte SD d&eacute;branch&eacute;e
1 = carte SD branch&eacute;e
int
read only
Variables serveur
&Eacute;tat du serveur.
Important : Toutes les variables se r&eacute;f&eacute;rent au serveur, pas &agrave; AGI Client.
Variable
Description
Type de
donn&eacute;es
Current page
Nom de la page actuellement affich&eacute;e
string
Current project
Nom du projet actuel
string
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
95
Variables d’heure
Variable
Description
Type de
donn&eacute;es
Operating
mode time
Temps en secondes depuis le d&eacute;marrage du mode de service du p&eacute;riph&eacute;rique
uint64
Project load
time
Date de chargement du projet sur HMI Runtime comme indiqu&eacute; au format de la Date
syst&egrave;me (millisecondes).
uint64
Variables d’heure
Heure syst&egrave;me au format UTC.
Variable
Description
Type de
donn&eacute;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 &agrave; l'heure UTC. Il est &eacute;galement possible de configurer cette variable au
format date/heure.
unsignedInt
Year
Ann&eacute;e en cours
int
Variables &eacute;cran tactile
&Eacute;tat et position du curseur sur l'&eacute;cran tactile. Ce sont des propri&eacute;t&eacute;s de la page active et elles peuvent &ecirc;tre s&eacute;lectionn&eacute;es
dans la section Widget.
96
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
9 Variables syst&egrave;me
Note : Les dimensions de la page peuvent diff&eacute;rer de celles de l'affichage du p&eacute;riph&eacute;rique IHM.
Variable Description
Java Script
Page
Touch
X
page.primaryTouch.x
Position du curseur par rapport &agrave; la page
page.principaleToucher.y
Page
Touch
Y
Screen
Touch
X
Position du curseur par rapport &agrave; l'&eacute;cran tactile
page.primaryTouch.screenX
page.primaryTouch.screenY
Screen
Touch
Y
Touch
Press
0 = pas d'appui sur l'&eacute;cran
Touch
Status
Modifications g&eacute;n&eacute;riques de l'&eacute;cran tactile. Cette variable contient la
concat&eacute;nation des variables Screen Touch X, Screen Touch Y et Touch
Press (par exemple, &laquo; 924,129,0 &raquo;).
page.primaryTouch.pressed
1 = appui sur l'&eacute;cran
page.primaryTouchStatus
La fonction principale de cette variable est de d&eacute;clencher un &eacute;v&eacute;nement &agrave;
l'aide de la fonctionnalit&eacute; OnDataUpdate d&egrave;s qu'un changement survient (x, y
ou clic).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
97
Variables lecteur USB
Variables lecteur USB
Informations concernant le lecteur USB externe connect&eacute; au p&eacute;riph&eacute;rique.
Variable
Description
Type de donn&eacute;es
USB Drive free space
Espace de m&eacute;moire libre en octets
uint64
read only
USB Drive Name
Nom du p&eacute;riph&eacute;rique USB
string
read only
USB Drive Size
Taille en octets du lecteur connect&eacute; au port USB
uint64
read only
USB Drive Status
0 = Cl&eacute; USB d&eacute;branch&eacute;e
1 = Cl&eacute; USB branch&eacute;e
int
read only
Variables de gestion des utilisateurs
Informations concernant les utilisateurs et les groupes.
Variable
Description
Type de
donn&eacute;es
No of RemoteClients Alive
Num&eacute;ro de AGI Client connect&eacute;s au serveur
short
This Client
Group-Name
Groupe de l'utilisateur actuellement connect&eacute;
This Client ID
Uniquement pour AGI Client. Les clients locaux et distants connect&eacute;s au m&ecirc;me
serveur (par exemple, le runtime) re&ccedil;oivent un ID unique.
short
Nom de l'utilisateur connect&eacute; au client o&ugrave; la variable syst&egrave;me est affich&eacute;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 | &copy; 2012-2017 DEIF A/S
10
Variables syst&egrave;me non volatiles
La m&eacute;moire r&eacute;manente est une option du protocole des variables syst&egrave;me. Elle fournit une zone de m&eacute;moire dont le
contenu est conserv&eacute; lorsque le p&eacute;riph&eacute;rique IHM est &eacute;teint.
Pr&eacute;cisions sur la m&eacute;moire r&eacute;manente
100
Configurer la m&eacute;moire r&eacute;manente
100
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
99
Pr&eacute;cisions sur la m&eacute;moire r&eacute;manente
Pr&eacute;cisions sur la m&eacute;moire r&eacute;manente
Le support physique pour la m&eacute;moire r&eacute;manente se base sur la technologie FRAM.
Important : Tous les p&eacute;riph&eacute;riques IHM n'ont pas de m&eacute;moire FRAM. Si aucune m&eacute;moire FRAM n'est
disponible, la persistance peut &ecirc;tre assur&eacute;e par les supports de stockage de l'utilisateur (m&eacute;moire
flash ou disque dur externe). La technologie flash est limit&eacute;e car il y a un nombre maximum
d'op&eacute;rations d'&eacute;criture &agrave; ne pas d&eacute;passer. En cas d'op&eacute;rations d'&eacute;criture fr&eacute;quentes, l'utilisation de la
m&eacute;moire flash comme moyen de stockage pour la m&eacute;moire r&eacute;manente risque d'endommager les
composants de m&eacute;moire. Regardez si votre p&eacute;riph&eacute;rique IHM dispose d'une m&eacute;moire FRAM.
Important : Taille de la m&eacute;moire r&eacute;manente : jusqu'&agrave; 16 KB.
Simulateur de AGI Creatorsupporte la m&eacute;moire r&eacute;manente. Afin d'activer la m&eacute;moire r&eacute;manente lors
de la simulation du projet, choisissez l'option &laquo; Conserver les donn&eacute;es r&eacute;manentes en simulant le
projet &raquo; dans le menu contextuel.
M&eacute;moire r&eacute;manente ou stockage de recettes
Les donn&eacute;es de recette sont enregistr&eacute;es dans la m&eacute;moire flash (sauf pour AGI PC Runtime) tandis que les donn&eacute;es non
volatiles sont enregistr&eacute;es dans une m&eacute;moire FRAM. La m&eacute;moire flash ne se pr&ecirc;te pas &agrave; un nombre important d'op&eacute;rations
d'&eacute;criture, alors que la FRAM supporte un nombre d'op&eacute;rations d'&eacute;criture virtuellement illimit&eacute; et est donc pr&eacute;f&eacute;rable en cas
d'op&eacute;rations d'&eacute;criture fr&eacute;quentes.
Configurer la m&eacute;moire r&eacute;manente
Chemin : VueProjet&gt; Protocoles
100
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
10 Variables syst&egrave;me non volatiles
1. Cliquez sur + et s&eacute;lectionnez Variables syst&egrave;me : la bo&icirc;te de dialogue Variables syst&egrave;me s'affiche.
2. S&eacute;lectionner M&eacute;moire r&eacute;manente depuis la liste PLCModels.
Chemin : VueProjet&gt; variables
La m&eacute;moire r&eacute;manente est une zone de m&eacute;moire plate d'octets accessibles par un index de d&eacute;calage.
Utilisation des types de variables plus grandes d'un octet, par exemple court, garder &agrave; l'esprit que le d&eacute;calage de la
m&eacute;moire r&eacute;manente est en octets pour &eacute;viter les chevauchements.
Exemple :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
101
Configurer la m&eacute;moire r&eacute;manente
Effacer la m&eacute;moire r&eacute;manente
Utilisez l'action ClearRetentiveMemory pour effacer le contenu de la m&eacute;moire r&eacute;manente.
Astuce : Utilisez cette action pour d&eacute;finir le contenu de la m&eacute;moire &agrave; un &eacute;tat connu &agrave; tout moment.
102
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
10 Variables syst&egrave;me non volatiles
Voir &quot;Actions de variable&quot; on page 130 pour plus de d&eacute;tails.
Interface JavaScript
project.clearRetentiveMemory();
Conservation de la m&eacute;moire r&eacute;manente lors du t&eacute;l&eacute;chargement d'un projet
Quand vous t&eacute;l&eacute;chargez un fichier de projet sur un p&eacute;riph&eacute;rique IHM, ou quand vous modifiez le projet actif, le contenu de la
m&eacute;moire r&eacute;manente est normalement supprim&eacute;.
Si vous souhaitez conserver le contenu des donn&eacute;es non volatiles lorsque vous t&eacute;l&eacute;chargez ou mettez &agrave; jour un projet,
s&eacute;lectionnez l'option Conserver les donn&eacute;es r&eacute;manentes en t&eacute;l&eacute;chargeant le projet de projet dans les onglets
param&egrave;tres du p&eacute;riph&eacute;rique IHM.
Ce param&egrave;tre sera ignor&eacute; si vous s&eacute;lectionnez l'option Supprimer les fichiers dynamiques au moment de t&eacute;l&eacute;charger le
projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
103
Configurer la m&eacute;moire r&eacute;manente
104
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11
Actions
Les actions sont des fonctions permettant d'interagir avec le syst&egrave;me. Elles sont ex&eacute;cut&eacute;es en g&eacute;n&eacute;ral lors du
d&eacute;clenchement d'&eacute;v&eacute;nements.
Divers widgets peuvent d&eacute;clencher des &eacute;v&eacute;nements, par exemple, en appuyant et en rel&acirc;chant un bouton. Toutes les
actions ne sont pas disponibles pour tous les &eacute;v&eacute;nements d'un objet.
Les actions sont associ&eacute;es &agrave; des widgets dans la section &Eacute;v&eacute;nements du volet Propri&eacute;t&eacute;s (&Eacute;diteur de pages).
Actions d'alarmes
106
Actions d'&eacute;v&eacute;nements
106
Actions multilangues
107
Actions clavier
107
Actions lecteurs m&eacute;dias
109
Action FTP
109
Actions de page
112
Actions d'impression
116
Actions de recette
117
Actions client &agrave; distance
122
Actions syst&egrave;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 | &copy; 2012-2017 DEIF A/S
105
Actions d'alarmes
Actions d'alarmes
Permet de confirmer ou de r&eacute;initialiser les alarmes.
SelectAllAlarms
S&eacute;lectionne toutes les alarmes dans le widget d'alarmes.
AckAlarm
Confirme les alarmes s&eacute;lectionn&eacute;es.
ResetAlarm
R&eacute;initialise les alarmes confirm&eacute;es s&eacute;lectionn&eacute;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'&eacute;v&eacute;nements
Utilis&eacute;es par le widget de l'Historique des alarmes pour le d&eacute;filement des &eacute;v&eacute;nements/alarmes dans la vue de tableau
(widget de m&eacute;moire d'&eacute;v&eacute;nements).
ScrollEventsBackward
Faire d&eacute;filer les &eacute;v&eacute;nements/actions en arri&egrave;re dans la vue de tableau (widget de m&eacute;moire d'&eacute;v&eacute;nements).
ScrollEventsForward
Faire d&eacute;filer les &eacute;v&eacute;nements/actions en avant dans la vue de tableau (widget de m&eacute;moire d'&eacute;v&eacute;nements).
106
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Actions multilangues
S&eacute;lectionne la langue de l'application.
ConfigurerLangue
Configure la langue &agrave; utiliser. La langue s&eacute;lectionn&eacute;e sera appliqu&eacute;e dans l'ex&eacute;cution &agrave; tous les widgets concern&eacute;s.
Actions clavier
Modifie les claviers utilis&eacute;s.
EnvoiTouche
Envoie un caract&egrave;re &agrave; un widget num&eacute;rique. La propri&eacute;t&eacute; TypeClavier du widget num&eacute;rique doit &ecirc;tre configur&eacute;e sur Macro.
WidgetEnvoiTouche
Envoie un caract&egrave;re &agrave; un widget particulier.
Exemple
Les boutons Haut et Bas utilisent l'action WidgetEnvoiTouche en combinaison avec le Widget de listes de contr&ocirc;le.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
107
Actions clavier
AfficherClavier
Affiche le clavier tactile que le syst&egrave;me d'exploitation utilise par d&eacute;faut.
Note : cette fonction ne pourrait pas &ecirc;tre prise en charge par tous les syst&egrave;mes d'exploitation.
108
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Clavier
Active/D&eacute;sactive l'utilisation des actions lors de l'utilisation d'un clavier externe. L'ex&eacute;cution des actions peut &ecirc;tre
activ&eacute;e/d&eacute;sactiv&eacute;e aussi bien au niveau de projet qu'au niveau de page.
Cette fonction a le m&ecirc;me effet que l'utilisation du clavier des propri&eacute;t&eacute;s pour le projet et la page.
Actions lecteurs m&eacute;dias
Interagit avec le widget du lecteur m&eacute;dias de l'ex&eacute;cution.
Action
Description
PlayMedia
Lance la lecture de la vid&eacute;o.
StopMedia
Arr&ecirc;te la lecture de la vid&eacute;o.
ReloadMedia
Reprend la lecture de la vid&eacute;o depuis le d&eacute;but.
PauseMedia
Met la vid&eacute;o en pause.
BrowseMedia
S&eacute;lectionne la vid&eacute;o pour lecture.
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on page 431
pour plus de d&eacute;tails sur les panneaux)
Action FTP
Utilis&eacute; pour le chargement et le t&eacute;l&eacute;chargement de fichiers du et vers un serveur FTP distant.
ftpGET
T&eacute;l&eacute;charger les fichiers depuis un serveur FTP distant
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
109
Action FTP
Param&egrave;tre
Description
FtpConfig
Configuration des param&egrave;tres FTP
FtpRemoteFileName
Nom du fichier sur un serveur FTP pour t&eacute;l&eacute;charger (source)
FtpLocalFileName
Nom du fichier sur un p&eacute;riph&eacute;rique IHM local (destination)
ftpPUT
Charger les fichiers sur un serveur FTP distant
Param&egrave;tre
Description
FtpConfig
Configuration des param&egrave;tres FTP
FtpLocalFileName
Nom du fichier sur un p&eacute;riph&eacute;rique IHM local (source)
FtpRemoteFileName
Nom du fichier sur un serveur FTP pour t&eacute;l&eacute;charger (destination)
Les noms de fichier peuvent contenir des m&eacute;tacaract&egrave;res.
Une fois transf&eacute;r&eacute;es, les variables syst&egrave;me sont adapt&eacute;es &agrave; l'&eacute;tat des op&eacute;rations en cours (voir &quot;Variables client FTP&quot; on
page 92pour plus de d&eacute;tails).
Configuration serveur FTP
Pour configurer le param&egrave;tre FTP, entrez les informations suivantes pour le param&egrave;tre FtpConfig :
Param&egrave;tre
Description
Adresse FTP
Adresse IP de serveur FTP
Port de serveur
Port pour connexion FTP (par d&eacute;faut = 21).
Authentification
Choisissez l’authentification FTIP &agrave; 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&egrave;tres du serveur de mani&egrave;re dynamique depuis
la HMI Runtime.
110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Interface JavaScript FTP
ftpConfig
ftpCONFIG (IPAddress, Port, Authentication, UserName, Password)
R&eacute;gler les param&egrave;tres FTP pour utiliser les prochains appels FTP
Param&egrave;tre
Description
IPAddress
Adresse IP de serveur FTP.
Port
Port pour connexion FTP (par d&eacute;faut = 21).
Authentification
Choisissez l’authentification FTIP &agrave; 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&eacute;l&eacute;charger les fichiers depuis un serveur FTP distant
Param&egrave;tre
Description
remoteFileName
Nom du fichier sur un serveur FTP pour t&eacute;l&eacute;charger (source)
localFileName
Nom du fichier sur un p&eacute;riph&eacute;rique IHM local (destination)
fonction de rappel
Fonction qui sera appel&eacute;e &agrave; la fin du transfert FTP
ftpPUT
ftpPUT (remoteFileName, localFileName, [callback])
Charger les fichiers sur un serveur FTP distant
Param&egrave;tre
Description
remoteFileName
Nom du fichier sur un serveur FTP pour t&eacute;l&eacute;charger (source)
localFileName
Nom du fichier sur un p&eacute;riph&eacute;rique IHM local (destination)
fonction de rappel
Fonction qui sera appel&eacute;e &agrave; la fin du transfert FTP
Exemple :
project.ftpCONFIG(&quot;192.168.0.200&quot;, &quot;21&quot;, &quot;true&quot;, &quot;admin&quot;, &quot;admin&quot;);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
111
Actions de page
project.ftpGET( &quot;data.txt&quot;,
&quot;\\USBMemory\\data.txt&quot;,
function(ftpStatus) {fnFtpGetFinished(ftpStatus);} );
function fnFtpGetFinished(ftpStatus) {
alert(ftpStatus);
}
Actions de page
Navigation sur la page. Les actions de page peuvent &ecirc;tre utilis&eacute;es avec les &eacute;v&eacute;nements suivants :
l
OnMouseClick,
l
OnMouseRelease,
l
OnMouseHold
l
OnActivate
l
OnDeactivate
l
Alarmes
l
Planificateurs.
LoadPage
Permet de se rendre &agrave; la page s&eacute;lectionn&eacute;e du projet.
HomePage
Permet de se rendre &agrave; la page d'accueil.
Vous pouvez configurer la page d'accueil dans la section Comportement du Widget de projet, voir &quot;Comportement&quot; on
page 66
PrevPage
Permet de retourner &agrave; la page pr&eacute;c&eacute;dente.
NextPage
Permet de passer &agrave; la page suivante.
LastVisitedPage
Permet de retourner &agrave; la page affich&eacute;e pr&eacute;c&eacute;demment
ShowDialog
Affiche la page de dialogue d&eacute;finie dans le projet.
112
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
CloseDialog
Ferme les pages de dialogue.
Note : Cette action peut &ecirc;tre utilis&eacute;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&eacute; par la propri&eacute;t&eacute; nomFichier
Interface JavaScript
project.closeDialog(DialogID);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
113
Actions de page
O&ugrave; DialogID :
All
Ferme tous les dialogues ouverts
Selected
Ferme uniquement le dialogue actif
DialogName.jmx
Ferme le dialogue indiqu&eacute; par le param&egrave;tre nomFichier
Exemples
Exemple
Comportement
project.closeDialog(&quot;All&quot;);
Tous les dialogues ouverts sont ferm&eacute;s
project.closeDialog(&quot;Selected&quot;);
Le dialogue s&eacute;lectionn&eacute; est ferm&eacute;
project.closeDialog(&quot;Dialog1.jmx&quot;);
Toutes les instances du Dialogue1 sont ferm&eacute;es
Sans param&egrave;tres, le param&egrave;tre project.closeDialog(); ex&eacute;cute l'action project.closeDialog(&quot;Selected&quot;);.
ShowMessage
Affiche un message pop-up. Veuillez saisir le texte du message qui sera affich&eacute;.
LaunchApplication
Lance une application externe.
Param&egrave;tre
Description
App Name
Nom ex&eacute;cutable avec extension (par exemple, &laquo; notepad.exe &raquo; pour ex&eacute;cuter
Notepad)
Path
Chemin de l'application.
Arguments
Arguments particuliers de l'application (par exemple, \flash\qthmi\Manuel.pdf pour
ouvrir le document &laquo; Manuel.pdf &raquo;)
SingleInstance
Argument qui permet de faire lance l'application dans une seule instance ou dans
plusieurs instances.
Lorsqu'une seule instance est s&eacute;lectionn&eacute;e, le syst&egrave;me v&eacute;rifie d'abord si
l'application est d&eacute;j&agrave; en cours d'ex&eacute;cution ; si oui, l'application s'affiche en avantplan, sinon l'application est lanc&eacute;e.
FlushRuntimeCache Efface tous les cache de runtime pour lib&eacute;rer le plus de ram possible avant de lancer
l'application.
Note : Il est n&eacute;cessaire de citer &eacute;galement les espaces des arguments (par exemple, &quot;\Carte de
stockage\Manuel.pdf&quot;)
Exemple :
114
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
LaunchBrowser
Ouvre le navigateur web par d&eacute;faut. Vous pouvez d&eacute;finir une adresse URL comme argument.
Note : Fonctionne uniquement sur les plateformes dot&eacute;es d'un navigateur web natif (par exemple, Internet
Explorer habilit&eacute; dans Windows CE PRO).
LaunchVNC
D&eacute;marrer le serveur VNC et affiche le menu de configuration.
Macro disponible uniquement pour les p&eacute;riph&eacute;riques IHM bas&eacute;s sur une plateforme Windows CE.
Sur les p&eacute;riph&eacute;riques IHM bas&eacute;s sur la plateforme Linux, le service VNC peut &ecirc;tre activ&eacute; depuis l'onglet
&laquo; Service &raquo; de l’&quot;Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux&quot; on page 381
Voir &quot;Modules de plug-in de logiciels&quot; on page 66 pour l'inclure sur les p&eacute;riph&eacute;riques Windows CE.
LaunchPDFViewer
Lance l’afficheur PDF.
Note : Fonctionne uniquement sur les p&eacute;riph&eacute;riques dot&eacute;s d'un afficheur PDF.
Voir &quot;Modules de plug-in de logiciels&quot; on page 66 pour l'inclure sur les p&eacute;riph&eacute;riques Windows CE.
LaunchUpdater
Met &agrave; jour le projet et le runtime depuis un p&eacute;riph&eacute;rique externe.
Utiliser le param&egrave;tre Path pour sp&eacute;cifier le dossier qui contiendra le fichier de paquet de mise &agrave; jour. Laisser le param&egrave;tre de
chemin vide si vous pr&eacute;f&eacute;rez s&eacute;lectionner manuellement le fichier sur le p&eacute;riph&eacute;rique IHM lorsque la macro est invoqu&eacute;e.
Lorsque la macro LaunchUpdater est ex&eacute;cut&eacute;e, la bo&icirc;te de dialogue ci-dessous s'affiche sur le p&eacute;riph&eacute;rique IHM
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
115
Actions d'impression
Note : Cette fonction n'est pas support&eacute;e sur les p&eacute;riph&eacute;riques bas&eacute;s sur Win32.
Interface JavaScript
project.launchUpdater(strPath)
Exemples
project.launchUpdater(&quot;\\USBMemory&quot;)
Macro disponible uniquement pour les p&eacute;riph&eacute;riques IHM bas&eacute;s sur une plateforme Windows CE.
Sur les p&eacute;riph&eacute;riques IHM bas&eacute;s sur la plateforme Linux, le Service Cloud peut &ecirc;tre activ&eacute; depuis l'onglet
&laquo; Service &raquo; de l’&quot;Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux&quot; on page 381
LockScreen
Active le verrouillage temporaire de l'&eacute;cran tactile. Permet le nettoyage de l'&eacute;cran tactile.
La variable syst&egrave;me Time remaining to unlock affiche le temps restant avant le d&eacute;verrouillage. Voir &quot;Variable &eacute;cran&quot; on
page 95.
Actions d'impression
G&egrave;re les t&acirc;ches d'impression.
PrintGraphicReport
Imprime un rapport graphique.
Param&egrave;tre
Description
reportName
Attribue un nom au rapport
silent
faux = permet de configurer les propri&eacute;t&eacute;s de l'imprimante dans l'ex&eacute;cution
PrintText
Imprime une cha&icirc;ne.
Param&egrave;tre
Description
text
Cha&icirc;ne &agrave; imprimer
silent
faux = permet de configurer les propri&eacute;t&eacute;s de l'imprimante dans l'ex&eacute;cution
Cette action fonctionne en mode d'impression ligne par ligne et utilise un protocole standard partag&eacute; de toutes les
imprimantes qui prennent en charge cette fonction. Le texte est imprim&eacute; imm&eacute;diatement ligne par ligne ou imprim&eacute; apr&egrave;s un
d&eacute;lai d'attente d&eacute;fini individuellement pour chaque mod&egrave;le d'imprimante.
Note : l'impression pourrait prendre quelques minutes sur les mod&egrave;les qui ne sont pas con&ccedil;us pour l'impression
ligne par ligne.
116
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on page 431
pour plus de d&eacute;tails sur les panneaux)
PrintBytes
Imprime une cha&icirc;ne hexagonale qui repr&eacute;sente les donn&eacute;es &agrave; imprimer (par ex. &laquo; 1b30 &raquo; pour imprimer &lt; ESC 0 &gt;.
Param&egrave;tre
Description
octets
Cha&icirc;ne hexad&eacute;cimale &agrave; imprimer
silent
faux = permet de configurer les propri&eacute;t&eacute;s de l'imprimante dans l'ex&eacute;cution
Cette action fonctionne en mode d'impression ligne par ligne et utilise un protocole standard partag&eacute; de toutes les
imprimantes qui prennent en charge cette fonction. Le texte est imprim&eacute; imm&eacute;diatement ligne par ligne ou imprim&eacute; apr&egrave;s un
d&eacute;lai d'attente d&eacute;fini individuellement pour chaque mod&egrave;le d'imprimante.
Note : l'impression pourrait prendre quelques minutes sur les mod&egrave;les qui ne sont pas con&ccedil;us pour l'impression
ligne par ligne.
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on page 431
pour plus de d&eacute;tails sur les panneaux)
EmptyPrintQueue
Efface la queue d'impression actuelle. Lorsque l'action est ex&eacute;cut&eacute;e au cours d'une t&acirc;che d'impression, la queue est vid&eacute;e
une fois la t&acirc;che termin&eacute;e.
PausePrinting
Met la queue d'impression actuelle en attente. Lorsque l'action est ex&eacute;cut&eacute;e au cours d'une t&acirc;che d'impression, la queue
est mise en pause une fois la t&acirc;che termin&eacute;e.
ResumePrinting
Relance la queue pr&eacute;c&eacute;demment mise en attente.
AbortPrinting
Arr&ecirc;te l'ex&eacute;cution de la t&acirc;che actuelle et la supprime de la queue. Si la queue contient une autre t&acirc;che, cette t&acirc;che est
lanc&eacute;e d&egrave;s que la t&acirc;che actuelle a &eacute;t&eacute; annul&eacute;e.
Actions de recette
Utilis&eacute;es pour programmer la gestion des recettes.
DownloadRecipe
Copie les donn&eacute;es de recette d'une m&eacute;moire flash du p&eacute;riph&eacute;rique IHM (par ex. API, variable locale, en fonction du
protocole) sur le contr&ocirc;leur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
117
Actions de recette
Param&egrave;tre
Description
RecipeName
Nom de la recette &agrave; t&eacute;l&eacute;charger
RecipeSet
Num&eacute;ro de l'ensemble de recettes &agrave; copier.
ensAct = t&eacute;l&eacute;charger ensemble de recettes s&eacute;lectionn&eacute;
UploadRecipe
Enregistre les donn&eacute;es de recettes du contr&ocirc;leur (par ex. API, variable locale, en fonction du protocole) dans la m&eacute;moire
flash du p&eacute;riph&eacute;rique.
Param&egrave;tre
Description
RecipeName
Nom de la recette &agrave; charger
RecipeSet
Num&eacute;ro de l'ensemble de recettes &agrave; copier.
ensAct = charger ensemble de recettes s&eacute;lectionn&eacute;
&Eacute;crireEnsembleRecettesActuel
Configure la recette s&eacute;lectionn&eacute;e en tant qu'ensemble de recettes actuel.
Param&egrave;tre
Description
RecipeName
Nom de la recette &agrave; configurer comme recette actuelle
RecipeSet
Ensemble de recettes &agrave; d&eacute;finir comme ensemble de recettes actuel
T&eacute;l&eacute;chargerRecetteAct
T&eacute;l&eacute;charge les donn&eacute;es de l'ensemble de recettes actuel sur le contr&ocirc;leur.
Aucun param&egrave;tre requis.
ChargerRecetteAct
Charge un ensemble de donn&eacute;es du contr&ocirc;leur pour l'ajouter &agrave; l'ensemble de recettes actuel.
Aucun param&egrave;tre requis
R&eacute;initialiserRecette
Restaure les param&egrave;tres usine pour les donn&eacute;es de recettes. Les donn&eacute;es de recettes d'origine &eacute;craseront les recettes
charg&eacute;es
S&eacute;lectionnez la recette que vous souhaitez r&eacute;initialiser pour restaurer les donn&eacute;es d'usine.
ViderDonn&eacute;esRecette
D&eacute;place les donn&eacute;es de recette &agrave; un p&eacute;riph&eacute;rique de stockage interne ou externe. Les donn&eacute;es sont enregistr&eacute;es au format
.csv.
118
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Param&egrave;tre
Description
RecipeName
Nom de la recette &agrave; clicher
FilePath
Dossier de destination
l
Interne = \Flash\QTHMI\workspace\Dump
l
Cl&eacute; USB = \USBMemory
l
Carte SD = \Storage Card
l
R&eacute;seau public = \\&lt;nom d'h&ocirc;te ou IP&gt;\sharePath
l
R&eacute;seau priv&eacute; = \\&lt;nom d’utilisateur&gt;:&lt;mot de passe&gt;@&lt;nom d'h&ocirc;te ou
IP&gt;\&lt;partage&gt;/&lt;chemin&gt;
Note : les formats support&eacute;s pour la m&eacute;moire externe sont FAT ou FAT32 (le
format NTFS n'est pas pris en charge).
Note : Les r&eacute;seaux priv&eacute;s sont support&eacute;s uniquement par les p&eacute;riph&eacute;riques Linux
avec BSP &agrave; partir de la version 1.0.25.
FileName
Variable qui d&eacute;finit un nom de fichier.
DateTimePrefixFileName vrai = un pr&eacute;fixe compos&eacute; de la date et de l'heure sera ajout&eacute; au fichier vid&eacute; (par exemple
D2012_01_01_H10_10_recette1.csv)
TimeSpec
Format de l'heure :
l
l
Locale = les valeurs de temps export&eacute;es correspondent &agrave; l'heure du p&eacute;riph&eacute;rique
IHM.
Globale = les valeurs de temps sont export&eacute;es au format UTC.
RestaurerDonn&eacute;esRecette
Restaure les donn&eacute;es de recette enregistr&eacute;es auparavant.
Param&egrave;tre
Description
RecipeName
Recettes &agrave; restaurer :
l
l
AllRecipes
Les donn&eacute;es de toutes les recettes seront remplac&eacute;es par les donn&eacute;es lues &agrave; partir du fichier
externe
CurrentRecipe
Seule la donn&eacute;e de la recette s&eacute;lectionn&eacute;e en cours seront remplac&eacute;es par les donn&eacute;es lues &agrave;
partir du fichier externe
RecipeDataSet Disponible uniquement quand RecipeName=CurrentRecipe.
S&eacute;lectionner les ensembles de donn&eacute;es &agrave; restaurer :
l
AllRecipeDataSet
L’ensemble des donn&eacute;es sera restaur&eacute;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
119
Actions de recette
Param&egrave;tre
Description
l
Type de
restauration
Disponible uniquement quand RecipeDataSet=AllRecipeDataSet.
Ce param&egrave;tre d&eacute;finit le comportement lorsque les nombres d'ensembles de donn&eacute;es &agrave; l'int&eacute;rieur du
fichier &agrave; restaurer ne correspondent pas avec le num&eacute;ro de s&eacute;rie de donn&eacute;es &agrave; l'int&eacute;rieur du
p&eacute;riph&eacute;rique IHM
l
l
l
FilePath
curSet
Seul le jeu de donn&eacute;es des donn&eacute;es s&eacute;lectionn&eacute; en cours sera restaurer
Remplacer
Tous les ensembles de donn&eacute;es qui sont &agrave; l'int&eacute;rieur du dispositif sont retir&eacute;s et remplac&eacute;es par
les ensembles de donn&eacute;es depuis le fichier CSV
Match
Remplacer uniquement l’ensemble de donn&eacute;es &agrave; l'int&eacute;rieur du p&eacute;riph&eacute;rique qui ont le m&ecirc;me
identifiant d’ensemble des donn&eacute;es
MatchAndAdd
Remplacer l'ensemble des donn&eacute;es &agrave; l'int&eacute;rieur du dispositif qui ont le m&ecirc;me identifiant
d’ensemble de donn&eacute;es et ajouter l'ensemble suppl&eacute;mentaire de donn&eacute;es trouv&eacute; dans le fichier
csv (Remarque : les ensembles de donn&eacute;es qui sont &agrave; l'int&eacute;rieur du p&eacute;riph&eacute;rique, mais pas &agrave;
l'int&eacute;rieur du fichier csv ne sont pas retir&eacute;s du p&eacute;riph&eacute;rique)
Dossier source
l
Interne = \Flash\QTHMI\workspace\Dump
l
Cl&eacute; USB = \USBMemory
l
Carte SD = \Storage Card
l
R&eacute;seau public = \\&lt;nom d'h&ocirc;te ou IP&gt;\sharePath
l
R&eacute;seau priv&eacute; = \\&lt;nom d’utilisateur&gt;:&lt;mot de passe&gt;@&lt;nom d'h&ocirc;te ou
IP&gt;\&lt;partage&gt;/&lt;chemin&gt;
Note : les formats support&eacute;s pour la m&eacute;moire externe sont FAT ou FAT32 (le format NTFS
n'est pas pris en charge).
Note : Les r&eacute;seaux priv&eacute;s sont support&eacute;s uniquement par les p&eacute;riph&eacute;riques Linux avec BSP
&agrave; partir de la version 1.0.25.
FileName
Variable associ&eacute;e dans laquelle sera lu le nom de fichier dans l'ex&eacute;cution.
BrowseForFile vrai = affiche le dialogue Ouvrir permettant de rechercher le fichier que vous souhaitez lire.
faux = aucun dialogue ne s'affiche,
AjouterEnsembleDonn&eacute;esRecette
Ajoute un nouvel ensemble de donn&eacute;es recette &agrave; la recette s&eacute;lectionn&eacute;e. Le nouvel ensemble de donn&eacute;es est ajout&eacute; &agrave; la fin
des ensembles de donn&eacute;es d&eacute;finis pr&eacute;c&eacute;demment.
120
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Param&egrave;tre
Description
RecipeName
Recette &agrave; laquelle l'ensemble de donn&eacute;es sera ajout&eacute;.
CopierDe
Ensemble de donn&eacute;es duquel seront reprises les valeurs de param&egrave;tres pour initialiser le
nouvel ensemble de donn&eacute;es
NouveauNomEnsemble Nom d'un nouvel ensemble de donn&eacute;es.
Il est possible d'indiquer une r&eacute;f&eacute;rence de variable pour cette valeur.
SupprEnsembleDonn&eacute;esRecette
Supprime un ensemble de donn&eacute;es de la recette s&eacute;lectionn&eacute;e. En supprimant un ensemble de donn&eacute;es, vous modifiez
&eacute;galement les num&eacute;ros de positions des ensembles de donn&eacute;es qui le suivent.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
121
Actions client &agrave; distance
Param&egrave;tre
Description
RecipeName
Recette dans laquelle l'ensemble de donn&eacute;es sera supprim&eacute;.
EnsembleDonn&eacute;es
Ensemble de donn&eacute;es &agrave; supprimer.
Actions client &agrave; distance
Utilis&eacute; pour le chargement et le t&eacute;l&eacute;chargement de fichiers du et vers un p&eacute;riph&eacute;rique IHM distant. Ces actions peuvent &ecirc;tre
ex&eacute;cut&eacute;es uniquement &agrave; partir d'un AGI Client distant pour acc&eacute;der &agrave; des fichiers distants via FTP.
Important : Activez la prise en charge du FTP et attribuez tous les droits d'utilisateurs aux dossiers
utilis&eacute;s pour le transfert des fichiers.
ChargerSurIHM
Appelle un dialogue Ouvrir qui permet de s&eacute;lectionner un fichier &agrave; charger sur le p&eacute;riph&eacute;rique IHM distant.
Param&egrave;tre
Description
Destination
Chemin de destination pour le fichier &agrave; charger sur le p&eacute;riph&eacute;rique IHM
Filtrer
Extensions de fichier des fichiers &agrave; afficher, s&eacute;par&eacute;es par des virgules (par ex., *.txt)
T&eacute;l&eacute;chargerdIHM
Appelle un dialogue Ouvrir qui permet de s&eacute;lectionner un fichier &agrave; t&eacute;l&eacute;charger du p&eacute;riph&eacute;rique IHM distant.
Note : Seuls les fichiers qui correspondent au filtre configur&eacute; sont affich&eacute;s pour t&eacute;l&eacute;chargement.
Param&egrave;tre
Description
Source
Chemin source du fichier &agrave; t&eacute;l&eacute;charger du p&eacute;riph&eacute;rique IHM
Filtrer
Extensions de fichier des fichiers &agrave; afficher, s&eacute;par&eacute;es par des virgules (par ex., *.txt)
Interface JavaScript
boolean project.uploadToHMI(dirPath, strFilter);
boolean project.downloadFromHMI(dirPath, strFilter);
Param&egrave;tre
Description
dirPath
Chemin source du fichier &agrave; charger/t&eacute;l&eacute;charger du p&eacute;riph&eacute;rique IHM
strFilter
Extensions de fichier des fichiers &agrave; afficher, s&eacute;par&eacute;es par des virgules (par ex., *.txt)
Valeurs de retour :
122
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Vrai
Transfert termin&eacute; avec succ&egrave;s
Faux
Transfert &eacute;chou&eacute;
Note : Une fois transf&eacute;r&eacute;es, les variables syst&egrave;me sont adapt&eacute;es &agrave; l'&eacute;tat des op&eacute;rations en cours.
Actions syst&egrave;me
Permet de g&eacute;rer les propri&eacute;t&eacute;s syst&egrave;me.
Red&eacute;marrer
Red&eacute;marre le runtime.
ClichageTendance
Stocke les donn&eacute;es historiques de tendances sur des lecteurs externes (cl&eacute; USB ou carte SD).
Param&egrave;tre
Description
TrendName
Nom de la tendance historique &agrave; stocker
CheminDossier
Dossier de destination :
l
Interne = \Flash\QTHMI\workspace\Dump
l
Cl&eacute; USB = \USBMemory
l
Carte SD = \Storage Card
l
R&eacute;seau public = \\&lt;nom d'h&ocirc;te ou IP&gt;\sharePath
l
R&eacute;seau priv&eacute; = \\&lt;nom d’utilisateur&gt;:&lt;mot de passe&gt;@&lt;nom d'h&ocirc;te ou
IP&gt;\&lt;partage&gt;/&lt;chemin&gt;
Note : les formats support&eacute;s pour la m&eacute;moire externe sont FAT ou FAT32 (le
format NTFS n'est pas pris en charge).
Note : Les r&eacute;seaux priv&eacute;s sont support&eacute;s uniquement par les p&eacute;riph&eacute;riques Linux
avec BSP &agrave; partir de la version 1.0.25.
FormatFichier
Binaire = la m&eacute;moire tampon est enregistr&eacute;e sous forme de clich&eacute; binaire (fichiers .dat et
.inf). Les deux fichiers sont requis ult&eacute;rieurement pour convertir les donn&eacute;es au format .csv
&agrave; l'aide d'un utilitaire externe.
Compatibilit&eacute; CSV = la m&eacute;moire tampon est enregistr&eacute;e dans un emplacement donn&eacute; au
format de fichier clich&eacute; .csv compatible avec les versions 1.xx
CSV compact = la m&eacute;moire tampon est enregistr&eacute;e dans un emplacement donn&eacute; dans un
fichier .csv &agrave; format plus r&eacute;cent
Voir &quot;Exporter les donn&eacute;es de m&eacute;moire de tendance&quot; on page 177
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
123
Actions syst&egrave;me
Param&egrave;tre
Description
DateTimePrefixFileName vrai = un pr&eacute;fixe compos&eacute; de la date et de l'heure sera ajout&eacute; au fichier clich&eacute; (par exemple
D2012_01_01_H10_10_Tendance1.csv)
timeSpec
Format de l'heure :
l
l
FileName
Locale = les valeurs de temps export&eacute;es correspondent &agrave; l'heure du p&eacute;riph&eacute;rique
IHM.
Globale = les valeurs de temps sont export&eacute;es au format UTC.
Activ&eacute; lorsque le NomFichierPr&eacute;fixeDateHeure = vrai
Les m&eacute;tacaract&egrave;res ci-dessous sont pris en charge
l
%n = nom de tendance
l
%y = ann&eacute;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&eacute;cution de l'action ClichageTendance forcera automatiquement le vidage vers le disque des donn&eacute;es
temporaires conserv&eacute;es dans la m&eacute;moire RAM. Voir &quot;Tendances historiques&quot; on page 180 pour plus de d&eacute;tails
sur l'enregistrement de donn&eacute;es &eacute;chantillonn&eacute;es sur le disque.
Note : les lecteurs externes connect&eacute;s au port USB doivent &ecirc;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 &ecirc;tre cr&eacute;&eacute;s dans un dossier. Ces limites d&eacute;pendent de diff&eacute;rents facteurs et leur calcul est
complexe mais vous pouvez partir d'un maximum de 999 fichiers qui peuvent &ecirc;tre utilis&eacute;s dans un
dossier.
Conversion des fichiers clich&eacute;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&ugrave; :
Trend1 = nom de la m&eacute;moire des tendances sans extension g&eacute;n&eacute;r&eacute;e &agrave; partir du clich&eacute; (le nom du fichier d'origine &eacute;tant
trend1.dat)
Trend1.csv = nom du fichier de sortie.
Structure du fichier .csv
Le fichier .csv g&eacute;n&eacute;r&eacute; se pr&eacute;sente &agrave; cinq colonnes
124
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Colonne
Description
Type de donn&eacute;es
Type de donn&eacute;es de la variable &eacute;chantillonn&eacute;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'&eacute;chantillon
Timestamp(UTC)
Horodatage au format UTC
Temps
Intervalle entre les prises d'&eacute;chantillons en millisecondes
d'&eacute;chantillonnage
(ms)
Qualit&eacute;
Qualit&eacute; valeur de variable. Les informations cod&eacute;es selon le standard de l'acc&egrave;s aux donn&eacute;es OPC
et stock&eacute;es sous forme de donn&eacute;es d'octets (8 bits) sont d&eacute;finies sous forme de trois champs de
bits : qualit&eacute;, sous-&eacute;tat et &eacute;tat des limites.
Les huit bits de qualit&eacute; sont align&eacute;s dans l'ordre suivant : QQSSSSLL. Pour des descriptions
compl&egrave;tes et d&eacute;taill&eacute;es de tous les champs individuels, veuillez consulter la documentation
officielle d'acc&egrave;s standard OPC.
Valeurs de qualit&eacute; r&eacute;guli&egrave;rement utilis&eacute;es
Les valeurs le plus fr&eacute;quemment utilis&eacute;es retourn&eacute;es par l'appareil d'acquisition de l'IHM sont les suivantes :
Code de
qualit&eacute;
Qualit&eacute;
Description
0
MAUVAISE
La valeur est mauvaise mais aucune raison particuli&egrave;re n'est indiqu&eacute;e
4
MAUVAISE
Probl&egrave;me de serveur particulier avec la configuration. Par exemple, la variable
a &eacute;t&eacute; supprim&eacute;e du fichier de configuration (tags.xml).
8
MAUVAISE
&Eacute;ventuellement, cette fois-ci, aucune valeur n'est disponible, par exemple, la
valeur n'a pas &eacute;t&eacute; fournie par la source de donn&eacute;es.
12
MAUVAISE
D&eacute;faillance de p&eacute;riph&eacute;rique d&eacute;tect&eacute;e
16
MAUVAISE
D&eacute;lai d'attente d&eacute;pass&eacute; avant la r&eacute;ponse du p&eacute;riph&eacute;rique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
125
Actions syst&egrave;me
Code de
qualit&eacute;
Qualit&eacute;
Description
24
MAUVAISE
&Eacute;chec de communication
28
MAUVAISE
Aucune donn&eacute;e trouv&eacute;e pour le drapeau sp&eacute;cifique des valeurs de limite
inf&eacute;rieures et sup&eacute;rieures de l'interface des tendances.
32
MAUVAISE
Aucune donn&eacute;e collect&eacute;e (par exemple, l'archivage n'est pas actif.
Drapeau sp&eacute;cifique de l'interface tendances.
Cette valeur est &eacute;galement utilis&eacute;e pour indiquer un &eacute;tat hors ligne temporaire
(pour toute condition o&ugrave; l'&eacute;chantillonnage a &eacute;t&eacute; arr&ecirc;t&eacute;).
64
INCERTAINE Aucune raison sp&eacute;cifique.
65
INCERTAINE Aucune raison sp&eacute;cifique.
La valeur s'est accroch&eacute;e &agrave; une limite inf&eacute;rieure.
66
INCERTAINE Aucune raison sp&eacute;cifique.
La valeur s'est accroch&eacute;e &agrave; une limite sup&eacute;rieure.
67
INCERTAINE Aucune raison sp&eacute;cifique.
La valeur est constante et ne peut pas varier.
84
INCERTAINE La valeur retourn&eacute;e se situe en-dehors des limites d&eacute;finies.
Dans ce cas, le champ Limites indique la limite qui a &eacute;t&eacute; d&eacute;pass&eacute;e mais la
valeur peut d&eacute;passer cette plage.
85
INCERTAINE La valeur retourn&eacute;e se situe en-dehors des limites d&eacute;finies.
Dans ce cas, le champ Limites indique la limite qui a &eacute;t&eacute; d&eacute;pass&eacute;e mais la
valeur peut d&eacute;passer cette plage.
La valeur s'est accroch&eacute;e &agrave; une limite inf&eacute;rieure.
86
INCERTAINE La valeur retourn&eacute;e se situe en-dehors des limites d&eacute;finies.
Dans ce cas, le champ Limites indique la limite qui a &eacute;t&eacute; d&eacute;pass&eacute;e mais la
valeur peut d&eacute;passer cette plage.
La valeur s'est accroch&eacute;e &agrave; une limite sup&eacute;rieure
87
INCERTAINE La valeur retourn&eacute;e se situe en-dehors des limites d&eacute;finies.
Dans ce cas, le champ Limites indique la limite qui a &eacute;t&eacute; d&eacute;pass&eacute;e mais la
valeur peut d&eacute;passer cette plage.
La valeur est constante et ne peut pas varier.
192
BONNE
-
SupprimerTendance
Supprime les donn&eacute;es de tendance enregistr&eacute;es.
126
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
D&eacute;finissez le nom de la tendance de laquelle vous souhaitez supprimer les journaux.
ViderArchive&Eacute;v&eacute;nements
Stocke un journal d’alarmes historique et des donn&eacute;es de journal d’audit sur des lecteurs externes, tels qu'une m&eacute;moire
USB ou une carte SD.
Param&egrave;tre
Description
Archive&Eacute;v&eacute;nements
Nom de la m&eacute;moire tampon dans laquelle enregistrer les donn&eacute;es de clichage
CheminDossier
Dossier de destination
l
Interne = \Flash\QTHMI\workspace\Dump
l
Cl&eacute; USB = \USBMemory
l
Carte SD = \Storage Card
l
R&eacute;seau public = \\&lt;nom d'h&ocirc;te ou IP&gt;\sharePath
l
R&eacute;seau priv&eacute; = \\&lt;nom d’utilisateur&gt;:&lt;mot de passe&gt;@&lt;nom d'h&ocirc;te ou
IP&gt;\&lt;partage&gt;/&lt;chemin&gt;
Note : les formats support&eacute;s pour la m&eacute;moire externe sont FAT ou
FAT32 (le format NTFS n'est pas pris en charge).
Note : Les r&eacute;seaux priv&eacute;s sont support&eacute;s uniquement par les
p&eacute;riph&eacute;riques Linux avec BSP &agrave; partir de la version 1.0.25.
ClichageFichierConfig Vider les fichiers description des archives
DumpAsCSV
vrai = la m&eacute;moire tampon est enregistr&eacute;e dans un emplacement donn&eacute; dans un
fichier clich&eacute; .csv &agrave; format plus r&eacute;cent
faux = la m&eacute;moire tampon est enregistr&eacute;e sous forme de clich&eacute; binaire (fichiers
.dat et .inf). Les deux fichiers sont requis ult&eacute;rieurement pour convertir les
donn&eacute;es au format .csv &agrave; l'aide d'un utilitaire externe.
DateTimePrefix
vrai = un pr&eacute;fixe compos&eacute; de la date et de l'heure sera ajout&eacute; au fichier clich&eacute; (par
exemple D2012_01_01_H10_10_M&eacute;moireAlarme1.csv)
timeSpec
Format de l'heure :
l
l
Colonnes csv
Locale = les valeurs de temps export&eacute;es correspondent &agrave; l'heure du
p&eacute;riph&eacute;rique IHM.
Globale = les valeurs de temps sont export&eacute;es au format UTC.
S&eacute;lectionner les colonnes &agrave; vider dans le fichier .csv.
Disponible uniquement lorsque le EventArchive est une m&eacute;moire
tampon d'alarmes
FileName
Les m&eacute;tacaract&egrave;res ci-dessous sont pris en charge
l
%n = nom d'archive d'&eacute;v&eacute;nements
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
127
Actions syst&egrave;me
Param&egrave;tre
Description
l
%y = ann&eacute;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&eacute;lectionner la langue &agrave; utiliser. Lorsque vide, le d&eacute;chargement ex&eacute;cutera sur
toutes les langues.
Disponible uniquement lorsque le EventArchive est une m&eacute;moire
tampon d'alarmes
Exemple
En exportant les m&eacute;moire d'&eacute;v&eacute;nements au format binaire et lorsque le param&egrave;tre ClichageFichierConfig est configur&eacute;
sur vrai (param&egrave;tres recommand&eacute;s), il y a deux dossiers :
l
data, contenant les fichiers de donn&eacute;es,
l
config, contenant les fichiers de configuration pour la conversion au format .csv.
Une fois les deux dossiers copi&eacute;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&eacute;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&ugrave; :
AlarmBuffer1 = nom du fichier clich&eacute; .dat sans extension
128
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
AlarmBuffer1.csv = nom du fichier de sortie.
L'utilitaire AuditTrailBufferReader.exe est disponibles pour les m&eacute;moires tampon des journaux d'audit.
Note : configurez le param&egrave;tre ClichageFichierConfig sur vrai.
Le r&eacute;sultat du clichage est une structure de dossier similaire a celle cr&eacute;&eacute;e pour les &eacute;v&eacute;nements.
Utilisez la syntaxe suivante :
AuditTrailBufferReader AuditTrail FICHIER./AuditTrail.csv
o&ugrave; :
AuditTrail1= nom de la m&eacute;moire vid&eacute;e sans extension et
AuditTrail1.csv = nom du fichier de sortie.
Colonnes csv
Note : disponible uniquement pour les m&eacute;moires d'alarmes.
Pour les m&eacute;moires d'alarmes, il est possible d'inclure des colonnes suppl&eacute;mentaires dans le fichier clich&eacute; .csv.
SupprimerArchive&Eacute;v&eacute;nements
Supprime les donn&eacute;es de journal des m&eacute;moire d'&eacute;v&eacute;nements enregistr&eacute;es.
Indiquez le nom de la m&eacute;moire d'&eacute;v&eacute;nements pour la supprimer des journaux d'&eacute;v&eacute;nements.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
129
Actions de variable
R&eacute;initialiserCompteurErrProto
R&eacute;initialise la variable de syst&egrave;me Protocol Error Count.
Voir &quot;Variables syst&egrave;me&quot; on page 85 pour plus de d&eacute;tails.
RetirerM&eacute;diaEnTouteS&eacute;curit&eacute;
Permet de retirer la carte SD ou le lecteur USB en toute s&eacute;curit&eacute; de l'IHM.
ControlUserLED
Configure le comportement de la LED pour l'utilisateur.
Ce n’est pas disponible sur les plateformes Linux (consultez &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on page 431
pour plus de d&eacute;tails sur les panneaux)
Actions de variable
Permet d'interagir avec les variables.
TransfertDonn&eacute;es
Transmet des donn&eacute;es entre :
l
deux contr&ocirc;leurs,
l
registres d'un contr&ocirc;leur,
l
des variables syst&egrave;mes aux contr&ocirc;leurs,
l
des contr&ocirc;leurs aux variables syst&egrave;me
Les divers types de variables incluent une variable de contr&ocirc;leur, une variable syst&egrave;me, une variable de recette et une
propri&eacute;t&eacute; de widget.
BasculerBit
Fait basculer une valeur de bit d'une variable.
130
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
L'IndexBits vous permet de s&eacute;lectionner le bit &agrave; faire basculer : le basculement requiert une op&eacute;ration de lecturemodification-&eacute;criture ; la valeur de lecture est invers&eacute;e et puis r&eacute;&eacute;crite dans la variable.
ConfigurerBit
Configure le bit s&eacute;lectionn&eacute; sur &laquo; 1 &raquo;.
L'IndexBits vous permet de s&eacute;lectionner la position du bit &agrave; l'int&eacute;rieur de la variable.
ResetBit
R&eacute;initialise le bit s&eacute;lectionn&eacute; sur &laquo; 0 &raquo;
L'IndexBits vous permet de s&eacute;lectionner la position du bit &agrave; l'int&eacute;rieur de la variable.
WriteTag
&Eacute;crit des valeurs constantes dans la m&eacute;moire du contr&ocirc;leur. Indiquez le nom et la valeur de la variable.
Pasvariable
Augmente ou diminue la valeur de variable d'un pas.
Param&egrave;tre
Description
Nomvariable
Nom de la variable &agrave; 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&eacute;e.
ActiverGroupe
Force la mise &agrave; jour d'un groupe de variables.
Les variables sont mises &agrave; jour lorsqu'elles sont utilis&eacute;es dans la page actuelle ou en continu si elles ont &eacute;t&eacute; d&eacute;finies
comme actives dans l'&eacute;diteur de variables. Cette action force la mise &agrave; jour en continu des variables d'un groupe.
D&eacute;sactiverGroupe
D&eacute;sactive un groupe de variables, c'est-&agrave;-dire la mise &agrave; jour d'un groupe de variables n'est plus forc&eacute;e.
ActiverNœud
Active/d&eacute;sactive une action pour une gestion de nœud hors ligne. Aucune communication n'est effectu&eacute;e lorsque le nœud
est d&eacute;sactiv&eacute;.
Param&egrave;tre
Description
ID de protocole
Identificateur unique du protocole s&eacute;lectionn&eacute;
IDNœud
Identificateur de nœud dans un protocole s&eacute;lectionn&eacute;. Peut &ecirc;tre associ&eacute; &agrave; une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
131
Actions de tendance
Param&egrave;tre
Description
Activer
&Eacute;tat de communication de nœud :
Faux = d&eacute;sactiv&eacute;
Vrai = activ&eacute;
Lorsque le nœud est associ&eacute; &agrave; une variable, variable = 0 signifie Faux
ViderM&eacute;moireNonVolatile
Configuration sur 0 d&eacute;clenche l'effacement du contenu de la m&eacute;moire r&eacute;manente.
ForcerLecturevariable
Force le rafra&icirc;chissement de la variable indiqu&eacute;e &agrave; partir d'un contr&ocirc;leur distant.
Actions de tendance
Utilis&eacute;es pour les Tendances de donn&eacute;es actives et le Widget de tendances historiques.
Rafra&icirc;chirTendance
Rafra&icirc;chit la fen&ecirc;tre Tendance.
Cette action peut &ecirc;tre utilis&eacute;e dans tous les widgets de Tendances/Graphiques. Indiquez le widget en tant que param&egrave;tre
de l'action.
D&eacute;filementGaucheTendance
Fait d&eacute;filer la fen&ecirc;tre Tendance vers la gauche &agrave; un pas d'un dixi&egrave;me (1/10) de la dur&eacute;e de page.
Note : pour les tendances en temps r&eacute;el, mettez en pause la tendance &agrave; l'aide de l'action
MettreTendanceEnPause, sinon la fen&ecirc;tre sera ramen&eacute;e en continu &agrave; la valeur actuelle.
D&eacute;filementDroitTendance
Fait d&eacute;filer la fen&ecirc;tre Tendance vers la droite &agrave; un pas d'un dixi&egrave;me (1/10) de la dur&eacute;e de page.
Note : pour les tendances en temps r&eacute;el, mettez en pause la tendance &agrave; l'aide de l'action
MettreTendanceEnPause, sinon la fen&ecirc;tre sera ramen&eacute;e en continu &agrave; la valeur actuelle.
PageGaucheTendance
Permet de faire sauter la fen&ecirc;tre Tendance d'une page. Par exemple, si la taille de la page correspond &agrave; 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&ecirc;tre Tendance d'une page. Par exemple, si la taille de la page correspond &agrave; 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 | &copy; 2012-2017 DEIF A/S
11 Actions
Dur&eacute;ePageTendance
Configure la dur&eacute;e de la page de la fen&ecirc;tre Tendance.
D&eacute;finir le nom et la dur&eacute;e de page de la tendance.
Note : vous pouvez configurer la dur&eacute;e de la page dans l'ex&eacute;cution en utilisant le widget de liste d&eacute;roulante.
ZommerTendance
R&eacute;duit la dur&eacute;e de page.
D&eacute;zoomerTendance
Agrandit la dur&eacute;e de page.
R&eacute;initialiserZoomTendance
R&eacute;initialise le niveau de zoom au niveau de zoom d'origine.
ZoomInYAxisTrend
R&eacute;duit l'axe Y.
ZoomOutYAxisTrend
&Eacute;tend l'axe Y.
ZoomResetYAxisTrend
R&eacute;initialise le niveau de zoom de l’axe Y au niveau de zoom d'origine.
MettreTendanceEnPause
Arr&ecirc;te le tra&ccedil;age des courbes de tendance dans la fen&ecirc;tre Tendance.
Lorsque cette action est utilis&eacute;e pour une tendance en temps r&eacute;el, le tra&ccedil;age s'arr&ecirc;te une fois que la courbe a atteint le bord
droit du graphique. Cette action ne met pas fin &agrave; l'enregistrement de journaux de tendances.
Reprise tendance
Reprend le tra&ccedil;age de la tendance apr&egrave;s une pause.
AfficherCurseurTendance
Affiche la valeur de la courbe pour un point donn&eacute; 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&eacute;filement de la tendance s'arr&ecirc;te.
L'action FaireD&eacute;filerCurseur permet de d&eacute;placer le curseur graphique au-dessus des courbes ou au-dessus de toute la
fen&ecirc;tre de Tendance.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
133
Actions de tendance
ScrollTrendCursor
Fait d&eacute;filer le curseur de tendance vers l'avant ou vers l'arri&egrave;re.
La valeur du curseur Y affichera la valeur de la tendance situ&eacute;e sous la pointe du curseur. Le pourcentage de d&eacute;filement
peut &ecirc;tre configur&eacute; &agrave; 1% ou 10%. Le pourcentage est calcul&eacute; en fonction de la dur&eacute;e de la fen&ecirc;tre de tendance.
ScrollTrendToTime
Fait d&eacute;filer la fen&ecirc;tre Tendance &agrave; un moment donn&eacute; dans le temps.
Utilisez cette action lorsque vous souhaitez faire d&eacute;filer la fen&ecirc;tre de tendance jusqu'&agrave; une position sp&eacute;cifique d&egrave;s qu'un
&eacute;v&eacute;nement sp&eacute;cifique survient.
Exemple
1. Configurez une action pour un &eacute;v&eacute;nement (par exemple, une alarme) qui ex&eacute;cute un transfert de donn&eacute;es de l'heure
syst&egrave;me vers une variable.
2. S&eacute;lectionner cette variable en tant que param&egrave;tre ScrollTrendtoTime : les fen&ecirc;tres de tendance seront centr&eacute;es
d&egrave;s le d&eacute;clenchement de l'&eacute;v&eacute;nement.
ConsumptionMeterPageScroll
Permet de faire d&eacute;filer le widget du compteur de consommation d'une page vers la gauche ou vers la droite.
Param&egrave;tre
Description
Nom de tendance
ID de widget de tendance (par exemple, Fen&ecirc;treTendances3)
Direction de d&eacute;filement page
Direction du d&eacute;filement de la page (Avant/Arri&egrave;re)
134
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
Actions de gestion des utilisateurs
Param&egrave;tres de gestion des utilisateurs et de s&eacute;curit&eacute;.
D&eacute;connexion
D&eacute;connecte l'utilisateur actuel. L'utilisateur par d&eacute;faut est connect&eacute; automatiquement. Si aucun utilisateur par d&eacute;faut n'a
&eacute;t&eacute; configur&eacute;, la fen&ecirc;tre de connexion s'affiche.
ChangerUtilisateur
Alterne entre deux utilisateurs sans d&eacute;connecter l'utilisateur connect&eacute; : le dialogue de connexion utilisateur s'affiche.
L'utilisateur peut cliquer sur Retour pour retourner &agrave; l'utilisateur connect&eacute; pr&eacute;c&eacute;demment.
Le serveur continue de fonctionner avec l'utilisateur connect&eacute; pr&eacute;c&eacute;demment jusqu'&agrave; ce que l'utilisateur suivant se
connecte. Un utilisateur reste toujours connect&eacute; au syst&egrave;me.
ModifierMotdePasse
Modifie le mot de passe de l'utilisateur actuel : un dialogue s'affiche
Aucun param&egrave;tre requis.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
135
Actions de gestion des utilisateurs
R&eacute;initialiserMotdePasse
Restaure le mot de passe d'origine avec les param&egrave;tres sp&eacute;cifi&eacute;s dans le projet pour l'utilisateur actuel.
Aucun param&egrave;tre requis.
AjouterUtilisateur
R&eacute;serv&eacute;e aux utilisateurs pour lesquels la propri&eacute;t&eacute; Gestion des autres utilisateurs possible a &eacute;t&eacute; s&eacute;lectionn&eacute;e.
Ajoute un utilisateur dans l'ex&eacute;cution : un dialogue s'affiche.
SupprimerUtilisateur
R&eacute;serv&eacute;e aux utilisateurs pour lesquels la propri&eacute;t&eacute; Gestion des autres utilisateurs possible a &eacute;t&eacute; s&eacute;lectionn&eacute;e.
Supprime un utilisateur dans l'ex&eacute;cution : un dialogue s'affiche.
Aucun param&egrave;tre requis.
&Eacute;diterUtilisateurs
R&eacute;serv&eacute;e aux utilisateurs pour lesquels la propri&eacute;t&eacute; Gestion des autres utilisateurs possible a &eacute;t&eacute; s&eacute;lectionn&eacute;e.
Permet d'&eacute;diter les param&egrave;tres des utilisateurs.
136
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
SupprimerFichierDynamiqueGU
Supprime le fichier dynamique de gestion des utilisateurs. Les modifications apport&eacute;es aux param&egrave;tres des utilisateurs
dans l'ex&eacute;cution sont supprim&eacute;es. Les param&egrave;tres d'origine sont restaur&eacute;s &agrave; partir des informations de projet.
Aucun param&egrave;tre requis.
ExporterUtilisateurs
Exporte les param&egrave;tres des utilisateurs dans un fichier .xml (usermgnt_user.xml) crypt&eacute; qui permet la restauration le cas
&eacute;ch&eacute;ant.
Configurez le fichier de destination pour le fichier &agrave; exporter.
Important : Le fichier d'utilisateur est crypt&eacute; et ne peut pas &ecirc;tre &eacute;dit&eacute;.
Note : les formats pris en charge sont FAT ou FAT32. Le format NTFS n'est pas pris en charge.
ImporterUtilisateurs
Importe les param&egrave;tres des utilisateurs &agrave; partir d'un fichier d'exportation .xml pr&eacute;c&eacute;demment enregistr&eacute; (usermgnt_
user.xml).
Configurez le fichier source pour le fichier &agrave; 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 | &copy; 2012-2017 DEIF A/S
137
Actions widget
Actions widget
AfficherWidget
Affiche ou masque les widgets de la page.
Propri&eacute;t&eacute;
Description
Widget
Widget &agrave; afficher/masquer
GlisserWidget
Affiche l'effet de glissement d'un widget ou d'un groupe de widgets.
Note : Le widget ou les widgets group&eacute;s peuvent se situer en-dehors de la partie visible de la page du projet et
glisser pour s'afficher et &ecirc;tre masqu&eacute;s.
Propri&eacute;t&eacute;
Description
Widget
Widget &agrave; faire glisser
Direction
Direction de glissement
Vitesse
Vitesse de transition du widget glissant
Distance X
Distance parcourue par la coordonn&eacute;e X en pixels
Distance Y
Distance parcourue par la coordonn&eacute;e Y en pixels
Limite de d&eacute;filement
Activer/d&eacute;sactiver les limites de mouvement du widget par rapport aux coordonn&eacute;es x et y
Limite X
Position de limite de l'action de glissement par rapport &agrave; la coordonn&eacute;e x
Limite Y
Position de limite de l'action de glissement par rapport &agrave; la coordonn&eacute;e y
Activer visibilit&eacute;
Affiche/masque le widget apr&egrave;s chaque action de glissement
Widget d'images
Image affich&eacute;e pendant l'action de glissement
CommencerEntr&eacute;eDonn&eacute;es
Affiche un clavier et d&eacute;marre l'entr&eacute;e de donn&eacute;es dans un champ de donn&eacute;es sans toucher le widget m&ecirc;me. Cette action
permet d'activer l'entr&eacute;e de donn&eacute;es &agrave; l'aide d'un scanner code-barres.
Interface Java Script
project.beginDataEntry(wgtName [, pageName])
Param&egrave;tre
Description
wgtNameWidget Nom de widget
pageName
138
Active la page pour l'entr&eacute;e de donn&eacute;es. Param&egrave;tre optionnel. Utile pour s&eacute;lectionner un champ de
donn&eacute;es dans une bo&icirc;te de dialogue non-modale active.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
11 Actions
TriggerIPCamera
Capture une image &agrave; l'aide d'une cam&eacute;ra IP. Fonctionne uniquement avec les pages qui contiennent un widget de cam&eacute;ra
IP.
D&eacute;placerCam&eacute;raIP
Envoie des commandes &agrave; distance &agrave; une cam&eacute;ra qui les prend en charge. Voir &quot;Widgets cam&eacute;ra IP&quot; on page 285 pour plus
de d&eacute;tails. Assurez-vous que la cam&eacute;ra IP prend en charge les commandes de mouvement.
Rafra&icirc;chir&Eacute;v&eacute;nement
Rafra&icirc;chit la m&eacute;moire d'&eacute;v&eacute;nements pour le widget de l'Historique d'alarmes. Voir &quot;Widget historique des alarmes&quot; on
page 163 pour plus de d&eacute;tails.
MenuContextuel
Affiche le menu contextuel.
Si la propri&eacute;t&eacute; Menu contextuel du Widget de projet a &eacute;t&eacute; configur&eacute;e sur Temporisation, le menu contextuel peut sembler
toucher l'arri&egrave;re-plan de l'&eacute;cran pendant quelques secondes. Voir &quot;Volet des propri&eacute;t&eacute;s de projet&quot; on page 60
ReplaceMedia
Remplace les fichiers m&eacute;dia existants avec de nouveaux fichiers stock&eacute;s sur une cl&eacute; USB / une carte SD. Peut &ecirc;tre utilis&eacute;
pour remplacer les fichiers vid&eacute;o des widgets LecteurM&eacute;dias ou des images du projet.
Note : Les nouveaux fichiers m&eacute;dias doivent &ecirc;tre au m&ecirc;me nom et au m&ecirc;me format que les fichiers &agrave; remplacer.
Param&egrave;tre
Description
Media Type
Type du fichier &agrave; mettre &agrave; jour
P&eacute;riph&eacute;rique P&eacute;riph&eacute;rique sur lequel les nouveaux fichiers m&eacute;dias sont fournis
sourcePath
Fichier o&ugrave; sont stock&eacute;s les nouveaux fichiers m&eacute;dias (par exemple &quot;\\USBMemory&quot;)
Image
Resize
Ajuste les nouvelles images pour qu'elles aient les m&ecirc;mes dimensions que les images qu'elles
remplacent. Non applicable aux fichiers vid&eacute;o.
Silent
Remplace les m&eacute;dias automatiquement. Par d&eacute;faut, un dialogue s'affiche qui demande &agrave; 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(&quot;Images&quot;, true, &quot;\USBMemory&quot;, 1, true);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
139
Actions widget
140
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
12
Utiliser l’application client
AGI Client est une application autonome qui fournit un acc&egrave;s &agrave; distance &agrave; HMI Runtime, et est inclus dans AGI SW Pack.
AGI Client utilise le m&ecirc;me syst&egrave;me de rendu graphique que le runtime dans les p&eacute;riph&eacute;riques IHM, il repose sur HMI
Runtime sp&eacute;cifique en tant que serveur pour les donn&eacute;es en direct.
Pour ex&eacute;cuter l’application AGI Client :
1. Depuis le menu Start &gt; AGI SW Pack &gt;AGI Client : le client ouvre dans une fen&ecirc;tre style navigateur.
2. Taper l'adresse IP du serveur/p&eacute;riph&eacute;rique dans la barre d’adresse (par exemple : http://192.168.1.12) : AGI Client
se connectera au serveur et la m&ecirc;me ex&eacute;cution d’application graphique que sur le p&eacute;riph&eacute;rique sera charg&eacute;e dans la
fen&ecirc;tre du client.
AGI Client agit comme un client &agrave; distance et communique avec le serveur, en partageant la visualisation locale avec les
valeurs de variable qui sont maintenues ou mises &agrave; jour par le protocole de communication.
Les projets IHM contiennent des propri&eacute;t&eacute;s indiquant quelle page est actuellement affich&eacute;e sur l’IHM et peut forcer l’IHM
pour passer &agrave; une page sp&eacute;cifique. Vous pouvez utiliser ces propri&eacute;t&eacute;s pour synchroniser les pages indiqu&eacute;es sur le
p&eacute;riph&eacute;rique IHM et AGI Client ou pour commander un p&eacute;riph&eacute;rique IHM avec un API.
Voir &quot;Comportement&quot; on page 66 pour plus de d&eacute;tails.
La barre d'outils de l’application client
142
Espace de travail
142
Param&egrave;tres et options de fuseau horaire
142
Transf&eacute;rer des fichiers &agrave; un p&eacute;riph&eacute;rique IHM distant
143
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
141
La barre d'outils de l’application client
La barre d'outils de l’application client
&Eacute;l&eacute;ment
Description
Adresse de serveur IHM.
Adresse de p&eacute;riph&eacute;rique IHM.
&Eacute;tat de la connexion
&Eacute;tat de la demande de r&eacute;seau. Rouge lors de l’&eacute;change de donn&eacute;es.
Recharger &agrave; partir du cache
Recharger projet
Marque-page
Marquer les pages pr&eacute;f&eacute;r&eacute;es et les recharger.
Param&eacute;trages
Ouvrir la bo&icirc;te de dialogue des r&eacute;glages
Options de rechargement
Option
Description
F5
Recharge le projet depuis le cache
Shift + F5
T&eacute;l&eacute;charge le projet sur le client
Espace de travail
Les fichiers du projet sont charg&eacute;s depuis le dispositif et stock&eacute;es dans AGI Client dans le dossier cache suivant.
%appdata%\DEIF A/S\[build number]\client\cache
o&ugrave; :
[build number] = dossier nomm&eacute; en tant que num&eacute;ro de fabrication, par exemple 01.90.00.608.
Param&egrave;tres et options de fuseau horaire
Dans la bo&icirc;te de dialogue R&eacute;glages, vous pouvez configurer les param&egrave;tres du client et d&eacute;cider comment afficher les
informations d'horodatage du projet.
Param&egrave;tres HTTP
Param&egrave;tre
Description
Protocoles
Le protocole de communication utilis&eacute; par AGI Client pour communiquer avec un p&eacute;riph&eacute;rique IHM.
Fr&eacute;quence
de mise &agrave;
jour
La fr&eacute;quence de scrutation pour synchroniser les donn&eacute;es depuis le serveur. Par d&eacute;faut = 1 s.
142
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
12 Utiliser l’application client
Param&egrave;tre
Description
D&eacute;lai
d'attente
Temps d'attente maximum avant qu'une demande est r&eacute;p&eacute;t&eacute;e par le AGI Client. Par d&eacute;faut = 5 s.
R&eacute;utiliser
connexion
Permet la r&eacute;utilisation de la m&ecirc;me connexion TCP pour plusieurs requ&ecirc;tes HTTP pour r&eacute;duire le trafic
r&eacute;seau.
Note : Lorsqu'elle est activ&eacute;e, cette option peut entra&icirc;ner une latence &eacute;lev&eacute;e si le serveur
proxy ne met pas fin imm&eacute;diatement aux anciennes demandes saturant ainsi les prises de
connexion. C’est souvent le cas avec les connexions 3G.
Activer la
Compresse les donn&eacute;es afin de r&eacute;duire le temps de t&eacute;l&eacute;chargement. Par d&eacute;faut = d&eacute;sactiv&eacute;.
compression
ATTENTION : activer cette option pourrait provoquer une surcharge excessive du
processeur.
Param&egrave;tres
de temps
Utilis&eacute; par le client pour adapter les informations d'horodatage des widgets.
Param&egrave;tres FTP
Param&egrave;tre
Description
Port
Port communication FTP
Param&egrave;tres de temps
Param&egrave;tre
Description
Utiliser widgets
par d&eacute;faut
Affiche des informations de temps en fonction des param&egrave;tres du widget.
Heure locale
Traduit tous les horodatages du projet dans l'heure locale de l’ordinateur, o&ugrave; le client est
install&eacute;.
Heure globale
Traduit tous les horodatages du projet au format UTC
Heure du
serveur
Traduit tous les horodatages du projet dans le m&ecirc;me projet utilis&eacute; par le
p&eacute;riph&eacute;rique/serveur IHM afin d'afficher dans le m&ecirc;me temps.
Important : Assurez-vous de d&eacute;finir la zone de l’heure correcte IHM RTC et les options DST.
Transf&eacute;rer des fichiers &agrave; un p&eacute;riph&eacute;rique IHM distant
Vous pouvez charger et t&eacute;l&eacute;charger des fichiers du et vers un p&eacute;riph&eacute;rique IHM distant en utilisant deux actions d&eacute;di&eacute;es.
Ces actions peuvent &ecirc;tre ex&eacute;cut&eacute;es uniquement &agrave; partir d'un AGI Client distant et acc&eacute;der &agrave; des fichiers distants via FTP.
Important : Activez la prise en charge du FTP et attribuez tous les droits d'utilisateurs aux dossiers
utilis&eacute;s pour le transfert des fichiers.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
143
Transf&eacute;rer des fichiers &agrave; un p&eacute;riph&eacute;rique IHM distant
Voir &quot;Actions client &agrave; distance&quot; on page 122
Voir &quot;Variables client &agrave; distance&quot; on page 94
144
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
13
Utiliser le serveur FTP int&eacute;gr&eacute;
HMI Runtime le syst&egrave;me utilise un serveur FTP int&eacute;gr&eacute;.
Se connecter au serveur FTP du p&eacute;riph&eacute;rique IHM en utilisant n’importe quelle application client FTP standard. Le serveur
FTP r&eacute;pond sur le port 21 standard par d&eacute;faut.
Important : Le serveur ne prend en charge qu'une seule connexion &agrave; la fois ; si vous utilisez un client
FTP &agrave; connexion multiple, d&eacute;sactivez cette fonction sur le programme client ou d&eacute;finissez le nombre
maximal de connexions par session sur 1.
Param&egrave;tres FTP
Identifiants par d&eacute;faut FTP
Lorsque la gestion/s&eacute;curit&eacute; de l’utilisateur est d&eacute;sactiv&eacute;e, utiliser les identifiants suivants pour les connexions entrantes :
Identifiant
admin
Mot de passe
admin
Modifier les param&egrave;tres FTP
Chemin : VueProjet&gt; S&eacute;curit&eacute;&gt; GroupesUtilisateurs &gt; Param&egrave;tres autorisation
Vous pouvez modifier les autorisations FTP et les informations de compte dans l'onglet Ftp de la bo&icirc;te de dialogue des
autorisations Administrateur.
Voir &quot;Configurer groupes et autorisations&quot; on page 219 pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
145
Param&egrave;tres FTP
146
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
14
Utiliser VNC pour acc&egrave;s &agrave; distance
VNC est un logiciel de contr&ocirc;le &agrave; distance qui vous permet de voir et de contr&ocirc;ler l'application IHM &agrave; distance en utilisant
votre souris et votre clavier.
L'acc&egrave;s &agrave; distance est particuli&egrave;rement utile pour l'administration et le support technique. Pour l'utiliser, vous devez :
l
d&eacute;marrer un serveur dans le p&eacute;riph&eacute;rique IHM
l
installer un afficheur sur le p&eacute;riph&eacute;rique &agrave; distance
D&eacute;marrage du serveur VNC sur les p&eacute;riph&eacute;riques WinCE
148
D&eacute;marrage du serveur VNC sur les p&eacute;riph&eacute;riques Linux
149
D&eacute;marrer l’afficheur VNC
150
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
147
D&eacute;marrage du serveur VNC sur les p&eacute;riph&eacute;riques WinCE
D&eacute;marrage du serveur VNC sur les p&eacute;riph&eacute;riques
WinCE
Le serveur VNC est un plug-in. Il peut &ecirc;tre activ&eacute; et t&eacute;l&eacute;charg&eacute; en tant que runtime. &quot;Modules de plug-in de logiciels&quot; on
page 66.
Installer le serveur VNC
Chemin : ProjectView &gt; Propri&eacute;t&eacute;s du projet
1. Sur le panneau Propri&eacute;t&eacute;, d&eacute;finir le Serveur VNC en vrai pour activer le plug-in.
2. Installer ou mettre &agrave; jour le runtime pour ajouter le serveur VNC.
D&eacute;marrage/arr&ecirc;t du serveur VNC
Le serveur VNC se trouve dans le dossier \Flash\qthmi\VNC et est activ&eacute; en utilisant l’action launchVNC. Si activ&eacute; &agrave; partir
des propri&eacute;t&eacute;s du projet, il peut &eacute;galement &ecirc;tre activ&eacute; &agrave; partir du menu contextuel de runtime Outils de d&eacute;veloppement&gt;
Lancement VNC.
Pour activer le menu contextuel d'activation, voir &quot;Propri&eacute;t&eacute;s de projet&quot; on page 59
La bo&icirc;te de dialogue Options VNC
Depuis la bo&icirc;te de dialogue Options VNC, il est possible d’ex&eacute;cuter plusieurs t&acirc;ches.
Onglet
Fonctions
Commande
D&eacute;marrer/arr&ecirc;ter le serveur VNC et connecter l'afficheur
Options
D&eacute;finir les informations de s&eacute;curit&eacute; pour l'acc&egrave;s au serveur en utilisant un afficheur VNC
148
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
14 Utiliser VNC pour acc&egrave;s &agrave; distance
Onglet
Fonctions
Param&egrave;tres
avanc&eacute;s
Activer l'activation automatique du serveur VNC au d&eacute;marrage du p&eacute;riph&eacute;rique IHM.
S&eacute;lectionner D&eacute;marrage silencieux pour garder la bo&icirc;te de dialogue des Options VNC en
arri&egrave;re-plan lorsque l’Autod&eacute;marrage est activ&eacute;.
Activer Affichage de l’ic&ocirc;ne de la barre des t&acirc;ches en d&eacute;boguant le mode KIOSK.
Out
Contient les param&egrave;tres de configuration pour une connexion sortante &agrave; un logiciel d'affichage VNC
d’&eacute;coute.
Important : Les param&egrave;tres dans l'onglet Avanc&eacute; sont r&eacute;serv&eacute;es aux utilisateurs experts et devraient
&ecirc;tre modifi&eacute;es lorsque le serveur VNC est utilis&eacute; en conjonction avec un r&eacute;p&eacute;teur VNC pour surmonter
les probl&egrave;mes de pare-feu ou optimiser les performances VNC en fonction de la configuration du
r&eacute;seau.
Connexion &agrave; l'afficheur
De nombreux afficheurs VNC modernes offrent la possibilit&eacute; de lancer le logiciel en mode &eacute;coute. La raison est que, la
plupart du temps les p&eacute;riph&eacute;riques mobiles n’ont pas une adresse IP publique de r&eacute;f&eacute;rence. Il est donc possible d'avoir une
adresse IP publique sur un ordinateur de bureau qui ex&eacute;cute un afficheur VNC d’&eacute;coute. Un utilisateur peut alors facilement
appeler pour un support en appuyant sur le bouton Connexion &agrave; Afficheur sur l'onglet Commande.
Param&egrave;tres VNC par d&eacute;faut
Port TCP
5900
Mot de passe
null
Important : Le serveur VNC n’autorise qu’un seul client.
D&eacute;marrage du serveur VNC sur les p&eacute;riph&eacute;riques Linux
Le serveur VNC est un service int&eacute;gr&eacute; &agrave; l'int&eacute;rieur du BSP qui peut &ecirc;tre activer &agrave; partir de l'onglet Services des param&egrave;tres
du syst&egrave;me du p&eacute;riph&eacute;rique. Voir &quot;Param&egrave;tres du syst&egrave;me&quot; on page 384pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
149
D&eacute;marrer l’afficheur VNC
D&eacute;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&eacute;l&eacute;chargement gratuit (par exemple, TightVNC).
150
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15
Alarmes
Le syst&egrave;me de gestion des alarmes a &eacute;t&eacute; con&ccedil;u pour fournir des alertes par messages affich&eacute;s dans une fen&ecirc;tre
contextuelle, qui sont g&eacute;n&eacute;ralement des messages d'avertissement indiquant toute condition ou tout dysfonctionnement
anormal dans le syst&egrave;me sous contr&ocirc;le.
Un message s'affiche lorsqu'un bit change ou lorsque la valeur d'une variable d&eacute;passe un seuil fix&eacute; dans la configuration de
l'alarme. Vous pouvez &eacute;galement programmer des actions sp&eacute;cifiques qui doivent s'ex&eacute;cuter lorsqu'une alarme est
d&eacute;clench&eacute;e.
Important : Aucune action par d&eacute;faut n'est associ&eacute;e aux alarmes.
Vous pouvez d&eacute;finir le mode d'affichage d'une alarme sur le p&eacute;riph&eacute;rique IHM, lorsque l'utilisateur doit la confirmer, ainsi
que le moment de l'enregistrement et le mode d'enregistrement dans la liste d'&eacute;v&eacute;nements.
Les alarmes sont configur&eacute;es dans l'&Eacute;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 &agrave; la fois, si elles sont redimensionn&eacute;es de mani&egrave;re appropri&eacute;e.
Vous pouvez d&eacute;clencher l'ouverture ou la fermeture de la fen&ecirc;tre de l'alarme avec un &eacute;v&eacute;nement.
Vous travaillez avec les alarmes de la m&ecirc;me mani&egrave;re qu'avec tout autre &eacute;v&eacute;nement. Vous ne pouvez pas afficher de bo&icirc;te
de dialogue lorsqu'une alarme est d&eacute;clench&eacute;e et vous pouvez l'associer &agrave; toute autre action disponible.
&Eacute;diteur d'alarmes
152
Confirmer les alarmes &agrave; distance
154
Machine &agrave; &eacute;tats pour alarme
155
Configurer les &eacute;v&eacute;nements
156
Widget alarmes actives
159
Widget historique des alarmes
163
Gestion des alarmes &agrave; l'ex&eacute;cution
163
Activer/d&eacute;sactiver les alarmes &agrave; l’ex&eacute;cution
163
Afficher les donn&eacute;es d’alarme actives
164
Exporter la m&eacute;moire tampon des alarmes vers fichiers .csv
165
Exporter la configuration des alarmes
165
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
151
&Eacute;diteur d'alarmes
&Eacute;diteur d'alarmes
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Alarmes
Ajouter une alarme
Cliquez sur + pour ajouter une alarme.
Param&egrave;tre
Description
Nom
Nom de l'alarme
Groupes
Groupes associ&eacute;s avec l'alarme. Ils peuvent &ecirc;tre utilis&eacute;s dans des filtres d'affichage des widgets.
Activer
Activer/d&eacute;sactiver le d&eacute;clenchement de l'alarme.
Les alarmes peuvent &eacute;galement &ecirc;tre activ&eacute;es ou d&eacute;sactiv&eacute;es en cours d'ex&eacute;cution (voir
&quot;Activer/d&eacute;sactiver les alarmes &agrave; l’ex&eacute;cution&quot; on page 163 pour plus de d&eacute;tails).
Conf
Active/d&eacute;sactive la confirmation de l'alarme. Si elle est s&eacute;lectionn&eacute;e, l'op&eacute;rateur doit confirmer
l'alarme une fois d&eacute;clench&eacute;e pour la supprimer du widget Alarme active.
R&eacute;initialiser
Utilis&eacute; avec l'option Conf lorsqu'elle est s&eacute;lectionn&eacute;e, les alarmes confirm&eacute;es restent dans la liste des
alarmes, &eacute;tiquet&eacute;es comme Conf non d&eacute;clench&eacute;es, jusqu'&agrave; ce que l'op&eacute;rateur appuie sur le bouton
R&eacute;initialiser dans le widget de l'alarme.
M&eacute;moire
tampon
Fichier tampon o&ugrave; l'historique des alarmes est enregistr&eacute;.
D&eacute;clencheur
La condition de d&eacute;clenchement d&eacute;pend du type d'alarme :
l
l
152
limitAlarm : alarme d&eacute;clench&eacute;e lorsque la valeur de variable d&eacute;passe ses limites. L'alarme
n'est pas d&eacute;clench&eacute;e si la valeur atteint les limites.
valueAlarm alarme d&eacute;clench&eacute;e lorsque la valeur de variable est &eacute;gale &agrave; la valeur configur&eacute;e
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Param&egrave;tre
Description
l
l
Variable
bitMaskAlarm : l'op&eacute;rateur AND au niveau du bit compare chaque bit du masque de bits avec
la valeur de variable correspondant &agrave; cette Alarme. Si les deux bits sont activ&eacute;s, l'alarme est
configur&eacute;e sur Vrai. Vous pouvez sp&eacute;cifier une ou plusieurs positions de bit (en commen&ccedil;ant
par 0) dans la variable. La position du bit doit &ecirc;tre donn&eacute;e au format d&eacute;cimal. Si plusieurs bits
sont sp&eacute;cifi&eacute;s, chaque position doit &ecirc;tre s&eacute;par&eacute;e par une &laquo; , &raquo;.
deviationAlarm : alarme d&eacute;clench&eacute;e si le pourcentage de d&eacute;viation de la valeur de variable
depuis le point d&eacute;fini d&eacute;passe une d&eacute;viation d&eacute;finie.
Variable dont la valeur d&eacute;clenche l'alarme lorsqu'elle d&eacute;passe les limites d&eacute;finies.
L'alarme peut faire r&eacute;f&eacute;rence &agrave; la valeur de cette variable ou &agrave; l'&eacute;tat d'un bit lorsque bitMaskAlarm a
&eacute;t&eacute; s&eacute;lectionn&eacute; comme d&eacute;clencheur.
Activer &agrave;
distance
Variable utilis&eacute;e par l'API pour activer/d&eacute;sactiver l'alarme.
l
Changer l'&eacute;tat Activer du widget Alarmes change la valeur de variable
l
Lorsqu'une variable ne peut pas &ecirc;tre lue (ex. erreur de communication), l'alarme est d&eacute;sactiv&eacute;e
l
Aucune variable correspondant &agrave; l'alarme n'est rafra&icirc;chie lorsque l'alarme est d&eacute;sactiv&eacute;e.
Astuce : Vous pouvez activer l'enregistrement du drapeau d'activation de l'alarme
Acquittement
&agrave; distance
Variable utilis&eacute;e par l'API pour confirmer l'alarme. Une transition de cette variable de 0 &agrave; une valeur
diff&eacute;rente de z&eacute;ro est consid&eacute;r&eacute;e comme une requ&ecirc;te de confirmation.
Laisser vide lorsque l'acquittement &agrave; distance n'est pas requise.
Voir &quot;Confirmer les alarmes &agrave; distance&quot; on the next page pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
153
Confirmer les alarmes &agrave; distance
Param&egrave;tre
Description
Notification
Variable utilis&eacute;e par le p&eacute;riph&eacute;rique IHM pour notifier lorsque l'alarme est acquitt&eacute;e depuis le
d'acquittement p&eacute;riph&eacute;rique ou depuis l'API.
0 = d&eacute;finir cette valeur lorsque l'alarme est d&eacute;clench&eacute;e
1 = d&eacute;finir cette valeur lorsque l'alarme est acquitt&eacute;e.
Action
Actions ex&eacute;cut&eacute;es lorsque l'alarme est d&eacute;clench&eacute;e. Des conditions suppl&eacute;mentaires peuvent &ecirc;tre
sp&eacute;cifi&eacute;es dans la colonne &Eacute;v&eacute;nements.
Voir &quot;Configurer les &eacute;v&eacute;nements&quot; on page 156 pour plus de d&eacute;tails.
Action
utilisateur
Actions ex&eacute;cut&eacute;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&eacute;s multilangue et peut &ecirc;tre une
combinaison de parties statiques et dynamiques, ces derni&egrave;res incluant une ou plusieurs valeurs de
variable.
Voir &quot;Widget alarmes actives&quot; on page 159 pour plus de d&eacute;tails.
Voir &quot;Afficher les donn&eacute;es d’alarme actives&quot; on page 164 pour plus de d&eacute;tails.
Couleur
Couleurs de premier plan et d'arri&egrave;re-plan des lignes des alarmes, bas&eacute;es sur l'&eacute;tat de l'alarme.
AckBlink
Clignotement pour les alarmes d&eacute;clench&eacute;es. Lorsque cette option est s&eacute;lectionn&eacute;e, les lignes de
l'alarme clignotent jusqu'&agrave; leur confirmation. Fonctionne uniquement lorsque Conf est s&eacute;lectionn&eacute;.
S&eacute;v&eacute;rit&eacute;
S&eacute;v&eacute;rit&eacute; de l'alarme. Si plusieurs alarmes sont d&eacute;clench&eacute;es simultan&eacute;ment, les actions seront
ex&eacute;cut&eacute;es selon les param&egrave;tres de s&eacute;v&eacute;rit&eacute;.
0 = pas importante
1 = basse
2 = en dessous de la normale
3 = normale
4 = au-dessus de la normale
5 = &eacute;lev&eacute;e
6 = critique
&Eacute;v&eacute;nements
Conditions de notification, d'enregistrement ou d'impression des alarmes.
Voir &quot;Configurer les &eacute;v&eacute;nements&quot; on page 156 pour plus de d&eacute;tails.
Confirmer les alarmes &agrave; distance
Lorsque le param&egrave;tre Acquittement &agrave; distance est activ&eacute;, une alarme peut &ecirc;tre confirm&eacute;e &agrave; partir d'un p&eacute;riph&eacute;rique PLC
en introduisant une valeur de variable diff&eacute;rente de z&eacute;ro. L'&eacute;tat &quot;confirm&eacute;&quot; est notifi&eacute; sur le p&eacute;riph&eacute;rique PLC par le drapeau
Notification d'acquittement.
154
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Processus de confirmation des alarmes
La variable Acquittement &agrave; distance est r&eacute;gl&eacute;e/r&eacute;initialis&eacute;e par le PLC pour demander la confirmation, tandis que la
Notification d'acquittement est r&eacute;gl&eacute;e/r&eacute;initialis&eacute;e par le p&eacute;riph&eacute;rique IHM pour notifier l'ex&eacute;cution de la confirmation.
1. Lorsqu'une condition d'alarme est d&eacute;tect&eacute;e, le p&eacute;riph&eacute;rique IHM r&egrave;gle Notification d'acquittement sur 0 et
l'ensemble des actions correspondantes sont ex&eacute;cut&eacute;es.
2. Lorsque l'alarme est acquitt&eacute;e (par le p&eacute;riph&eacute;rique IHM ou &agrave; distance), la Notification d'acquittement est r&eacute;gl&eacute;e
sur 1
3. Il appartient au contr&ocirc;leur de r&eacute;gler Acquittement &agrave; distance sur 1 pour confirmer l'alarme ou de la remettre sur 0
lorsque le p&eacute;riph&eacute;rique IHM envoie une notification pour signaler que l'alarme a &eacute;t&eacute; confirm&eacute;e (Confirmation de
notification = 1)
AVERTISSEMENT : Lorsqu'une alarme est d&eacute;clench&eacute;e, certains signaux doivent &ecirc;tre mis &agrave;
jour/communiqu&eacute;s via les p&eacute;riph&eacute;riques connect&eacute;s. La Confirmation est cens&eacute;e &ecirc;tre un signal activ&eacute;
par un op&eacute;rateur, pas un signal d&eacute;clench&eacute; automatiquement par un p&eacute;riph&eacute;rique de contr&ocirc;leur. Il faut
tenir compte du temps n&eacute;cessaire &agrave; la communication des signaux d'origine.
Astuce : L'utilisation d'une m&ecirc;me variable pour Acquittement &agrave; distance et Notification d'acquittement
permet de connecter plusieurs p&eacute;riph&eacute;riques au m&ecirc;me contr&ocirc;leur et de confirmer les alarmes &agrave; partir de
n'importe quel p&eacute;riph&eacute;rique IHM.
Machine &agrave; &eacute;tats pour alarme
Le runtime impl&eacute;mente la machine &agrave; &eacute;tats pour alarme d&eacute;crite dans ce sch&eacute;ma.
Les &eacute;tats et les transitions entre &eacute;tats sont d&eacute;crits selon les options s&eacute;lectionn&eacute;es et le comportement voulu.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
155
Configurer les &eacute;v&eacute;nements
Configurer les &eacute;v&eacute;nements
Chemin : VueProjet&gt; Config &gt; Alarmes &gt; colonne &Eacute;v&eacute;nements
Les &eacute;v&eacute;nements sont d&eacute;finis &agrave; l'aide de l'&eacute;diteur Alarmes.
Voir &quot;&Eacute;diteur d'alarmes&quot; on page 152 pour plus de d&eacute;tails.
Notification des &eacute;v&eacute;nements
Chemin : VueProjet&gt; Config &gt; Alarmes &gt; colonne &Eacute;v&eacute;nements &gt; onglet Notification
Conditions de r&eacute;glage dans lesquelles les alarmes seront affich&eacute;es dans le widget d'alarme.
156
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Vous d&eacute;finissez ici le comportement du widget d'alarme par d&eacute;faut disponible dans la galerie de widgets et d&eacute;cidez dans
quels cas le widget est mis &agrave; jour par un changement d'&eacute;tat d'alarme.
AVERTISSEMENT : Faire uniquement les ajustements requis par l'application sp&eacute;cifique tout en
laissant tous les autres param&egrave;tres par d&eacute;faut.
Enregistrement des &eacute;v&eacute;nements
Chemin : VueProjet&gt; Config &gt; Alarmes &gt; colonne &Eacute;v&eacute;nements &gt; onglet Log
Conditions de r&eacute;glage pour lequel vous voulez stocker l'&eacute;v&eacute;nement sp&eacute;cifique dans un tampon d'historique des alarmes.
L'historique des alarmes est enregistr&eacute; dans la m&eacute;moire d’&eacute;v&eacute;nements.
Actions d’ex&eacute;cution
Chemin : VueProjet&gt; Config &gt; Alarmes &gt; colonne &Eacute;v&eacute;nements &gt; onglet Actions
Conditions de r&eacute;glage sous laquelle les/l'action(s), configur&eacute; pour l'alarme sp&eacute;cifique, doivent &ecirc;tre ex&eacute;cut&eacute;es.
Par d&eacute;faut, les actions sont ex&eacute;cut&eacute;es uniquement lorsque l'alarme est d&eacute;clench&eacute;e ; d'autres &eacute;tats d'alarme peuvent
&eacute;galement &ecirc;tre configur&eacute;s pour ex&eacute;cuter des actions.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
157
Configurer les &eacute;v&eacute;nements
&Eacute;v&eacute;nements d'impression
Chemin : VueProjet&gt; Config &gt; Alarmes &gt; colonne &Eacute;v&eacute;nements &gt; onglet Impression
Conditions de r&eacute;glage pour lequel vous voulez imprimer l'&eacute;v&eacute;nement sp&eacute;cifique
R&eacute;glage du p&eacute;riph&eacute;rique de stockage
Chemin : VueProjet&gt; Config &gt; M&eacute;moire Tamon &eacute;v&eacute;nements&gt; onglet Dispositif de stockage
1. Ouvrez la bo&icirc;te de dialogue du p&eacute;riph&eacute;rique de stockage.
2. S&eacute;lectionnez un p&eacute;riph&eacute;rique de stockage de donn&eacute;es d'&eacute;v&eacute;nements.
Les donn&eacute;es sont automatiquement enregistr&eacute;es toutes les cinq minutes, sauf pour les donn&eacute;es d'alarme qui sont
enregistr&eacute;e imm&eacute;diatement.
158
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Widget alarmes actives
Vous pouvez ins&eacute;rer le widget Alarmes actives dans une page pour afficher les alarmes et pour en prendre connaissance,
les r&eacute;initialiser ou les activer/d&eacute;sactiver.
Filtres d'alarme
Chemin : Widget Alarme active &gt; volet Propri&eacute;t&eacute;s &gt; Filtre
D&eacute;finissez les filtres utilis&eacute;s pour afficher uniquement certaines alarmes configur&eacute;es. Les filtres sont bas&eacute;s sur des
champs d'alarme, vous pouvez donc filtrer les alarmes en fonction du nom, de la s&eacute;v&eacute;rit&eacute;, de la description, etc.
Filtre 1 est le filtre par d&eacute;faut. Il est g&eacute;r&eacute; avec la liste d&eacute;roulante Filtre 1 et a deux options : Afficher toutes les alarmes et
Masquer les alarmes non d&eacute;clench&eacute;es, cette option permettant d'afficher uniquement les alarmes actives.
Le filtre 2 n'est par d&eacute;faut pas configur&eacute; et peut &ecirc;tre personnalis&eacute;.
Les expressions du filtre utilisent le langage AWK, les expressions sont appliqu&eacute;es aux donn&eacute;es contenues dans la
colonne Filtre s&eacute;lectionn&eacute;e du widget Alarme.
Param&eacute;trer les filtres
Chemin : Widget Alarme active &gt; volet Propri&eacute;t&eacute;s &gt; Filtre
Pour d&eacute;finir un des deux filtres disponibles :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
159
Widget alarmes actives
1. S&eacute;lectionnez Filtre Colonne 1 et choisissez la valeur &agrave; filtrer (ex. : Nom, &Eacute;tat, Temps, Groupes)
2. Dans Liaison de donn&eacute;es, associez un widget &agrave; liste d&eacute;roulante. Appuyez sur Maj + faites un clic gauche pour
s&eacute;lectionner la liste d&eacute;roulante.
3. Dans le volet Propri&eacute;t&eacute;s, s&eacute;lectionnez la propri&eacute;t&eacute; dans la liste et ouvrez la bo&icirc;te de dialogue pour personnaliser les
valeurs de la liste d&eacute;roulante
4. Dans la bo&icirc;te de dialogue de configuration de la liste d&eacute;roulante, sp&eacute;cifiez Liste de cha&icirc;nes et l'expression r&eacute;guli&egrave;re
pour filtrer les valeurs.
Voir http://www.gnu.org/software/gawk/manual/gawk.html pour plus de d&eacute;tails sur l'utilisation des expressions r&eacute;guli&egrave;res.
Filtres premier exemple
Vous voulez afficher toutes les alarmes correspondant au Filtre 1 d'une valeur &eacute;gale &agrave; 10. Param&egrave;tres de propri&eacute;t&eacute;s : Filtre
colonne 2 = Valeur, Filtre 2 = 10
Filtres deuxi&egrave;me exemple
Vous voulez afficher toutes les alarmes correspondant &agrave; une valeur de s&eacute;v&eacute;rit&eacute; comprise entre 3 et 6 (Normal &agrave; Critique).
Param&egrave;tres de propri&eacute;t&eacute;s : Filtre colonne 2 = S&eacute;v&eacute;rit&eacute;, Filtre 2 = [3-6]
Filtres troisi&egrave;me exemple
Vous voulez afficher toutes les alarmes correspondant &agrave; une valeur comprise entre 11 et 19. Param&egrave;tres de propri&eacute;t&eacute;s :
Filtre colonne 2 = S&eacute;v&eacute;rit&eacute;, Filtre 2 = ^(1[1-9]$)
Signification :
160
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
^ = la correspondance doit commencer au d&eacute;but de la cha&icirc;ne
1[1-9] = le premier char doit &ecirc;tre 1 et le deuxi&egrave;me char doit &ecirc;tre compris entre 1 et 9
$ = fin de la comparaison.
Exemples d'expression de filtres
Filtrer
par
Liste des cha&icirc;nes
Liste de donn&eacute;es
&Eacute;tat
Masquer les alarmes non
d&eacute;clench&eacute;es
^((Not Triggered Acked|Not Triggered Not
Acked|Triggered).*$)
Valeur
10 &lt; Valeur &lt; 20
^(1[0-9]$)
Valeur
20 &lt;= Valeur &lt;100
^([2-9].$)
Valeur
100 &lt; Valeur &lt; 200
^(1[0-9][0-9]$)
Valeur
Valeur 2?/3?/4?/5?
^([2-9].*$)
Valeur
Valeur &gt;= 100
^([1-9][0-9][0-9].*$)
Valeur
Valeur &gt;= 20
^([2-9].*$|[1-9][0-9][0-9].*$)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
161
Widget alarmes actives
Trier les alarmes
Chemin : Widget Alarme active &gt; volet Propri&eacute;t&eacute;s&gt; Tri
La fonction de tri vous permet de trier les alarmes &agrave; l'ex&eacute;cution dans le widget des alarmes en cliquant sur l'en-t&ecirc;te de la
colonne.
Note : La valeur de s&eacute;v&eacute;rit&eacute; affich&eacute;e ici est d&eacute;finie dans l'&Eacute;diteur d'alarme.
Action
Lorsque l'&laquo; Action utilisateur &raquo; associ&eacute;e avec l'alarme (voir &quot;&Eacute;diteur d'alarmes&quot; on page 152 pour plus de d&eacute;tails) contient
des actions valides, l'ic&ocirc;ne Action s'affiche. En appuyant sur l'ic&ocirc;ne, les actions configur&eacute;es seront ex&eacute;cut&eacute;es.
AVERTISSEMENT : Lorsque vous utilisez un ancien projet converti, vous devez remplacer l'ancien
widget Alarmes actives par le nouveau widget, situ&eacute; dans la galerie des widgets
Note : L'image peut &ecirc;tre modifi&eacute;e dans les propri&eacute;t&eacute;s des colonnes du widget Alarmes actives
162
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Widget historique des alarmes
Cr&eacute;&eacute; et affiche une liste d'alarme lorsque la propri&eacute;t&eacute; M&eacute;moire tampon est d&eacute;finie dans l'&eacute;diteur de configuration des
alarmes.
Associer un widget &agrave; la m&eacute;moire tampon
Chemin : Widget HistoriqueAlarme &gt; volet Propri&eacute;t&eacute;s &gt; M&eacute;moire tampon &gt; M&eacute;moire&Eacute;v&eacute;nement
Dans le volet Propri&eacute;t&eacute;s &gt; &Eacute;v&eacute;nement, s&eacute;lectionnez la M&eacute;moire d'&eacute;v&eacute;nements qui contient la liste d'alarmes
Gestion des alarmes &agrave; l'ex&eacute;cution
Lorsqu'une alarme est d&eacute;clench&eacute;e, elle s'affiche dans le widget Alarmes Actives, o&ugrave; vous pouvez la confirmer et la
r&eacute;initialiser. Vous pouvez filtrer les alarmes affich&eacute;es en utilisant une s&eacute;rie de filtres, par exemple vous pouvez masquer les
alarmes non d&eacute;clench&eacute;es ou bien afficher toutes les alarmes.
Voir &quot;Widget alarmes actives&quot; on page 159 pour plus de d&eacute;tails.
IMPORTANT : Le widget alarmes actives ne s'affiche pas automatiquement. Vous devez ajouter une
action d&eacute;di&eacute;e qui ouvrira la page contenant le widget d'alarme d&egrave;s que l'alarme se d&eacute;clenche.
Activer/d&eacute;sactiver les alarmes &agrave; l’ex&eacute;cution
Vous pouvez activer ou d&eacute;sactiver les alarmes &agrave; l'ex&eacute;cution.
Pour activer une alarme, s&eacute;lectionnez l'option Activer dans le widget de l'alarme.
Les alarmes d&eacute;sactiv&eacute;es ne sont pas d&eacute;clench&eacute;es, elles ne sont donc pas affich&eacute;es &agrave; l'ex&eacute;cution.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
163
Afficher les donn&eacute;es d’alarme actives
Note : Vous pouvez configurer les alarmes pour qu'elles soient activ&eacute;es/d&eacute;sactiv&eacute;es m&ecirc;me depuis l'API.
Voir &laquo; &Eacute;diteur de configuration d'alarme &raquo; pour plus de d&eacute;tails.
Afficher les donn&eacute;es d’alarme actives
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Alarmes
Vous pouvez param&eacute;trer la description d'alarme de mani&egrave;re &agrave; afficher les donn&eacute;es de variable active, aussi bien dans les
Alarmes Actives que dans le widget Alarmes Historiques.
Pour afficher la valeur de variable, d&eacute;finir un caract&egrave;re fictif dans Description et entrez le nom de variable entre crochet,
par exemple &laquo; [variable1] &raquo;. &Agrave; l'ex&eacute;cution, la valeur actuelle de la variable appara&icirc;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&ugrave;
l'alarme s'est d&eacute;clench&eacute;e
Utilisez '\' avant '[ ]' si vous souhaitez afficher le '[ ]' dans la cha&icirc;ne de description, par exemple : \[variable\[1\]\]
affichera la cha&icirc;ne &laquo; [variable[1]] &raquo;.
Utiliser '\', m&ecirc;me lorsque l'&eacute;tiquette de variable contient des crochets. Par exemple, pour afficher la valeur de la
variable en direct de la variable &laquo; TAG]3 &raquo; ou &laquo; TAG[3] &raquo;, utiliser :
164
l
TAG\]3 = [TAG\]3]
l
TAG\[3\] = [TAG\[3\]]
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
Exemple d'un widget d'alarme
Note : Le fichier csv r&eacute;sultant du vidage de la liste des &eacute;v&eacute;nements d'alarme indiquera &eacute;galement la valeur de
variable dans la colonne de description.
Exporter la m&eacute;moire tampon des alarmes vers fichiers
.csv
Pour exporter une m&eacute;moire d'&eacute;v&eacute;nements contenant une liste de l'historique des alarmes, utilisez l'action
ViderArchive&Eacute;v&eacute;nement.
Voir &quot;Actions syst&egrave;me&quot; on page 123 pour plus de d&eacute;tails.
Note : Les valeurs de variable affich&eacute;es dans la description des alarmes sont aussi incluses dans la
m&eacute;moire tampon. Les variables sont &eacute;chantillonn&eacute;es lorsque l'alarme est d&eacute;clench&eacute;e et lorsque la
valeur est enregistr&eacute;e et incluse dans la description.
Exporter la configuration des alarmes
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Alarmes
Cliquez sur le bouton Exporter alarmes : le tableau de configuration des alarmes est export&eacute; dans un fichier .xml.
Vous pouvez &eacute;diter le fichier .xml qui en r&eacute;sulte avec des outils tiers (par exemple, Microsoft Excel).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
165
Exporter la configuration des alarmes
Importer la configuration des alarmes
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Alarmes
166
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
15 Alarmes
1. Cliquez sur le bouton Importer Alarmes et s&eacute;lectionnez le fichier .xml &agrave; partir duquel vous souhaitez importer la
configuration des alarmes : la bo&icirc;te de dialogue Importer Alarmes s'affiche.
2. S&eacute;lectionnez le groupe d'alarmes &agrave; importer et cliquez sur OK pour confirmer.
Les diff&eacute;rences sont mises en &eacute;vidence dans la bo&icirc;te de dialogue Importer Alarmes &agrave; l'aide de couleurs diff&eacute;rentes
Couleur Description
Noir
C'est une nouvelle alarme et elle sera import&eacute;e
Rouge
Cette alarme n'a pas &eacute;t&eacute; trouv&eacute;e et sera supprim&eacute;e (seulement si la case &laquo; Remplacer les alarmes de projet
par les alarmes import&eacute;es &raquo; est s&eacute;lectionn&eacute;e)
Bleu
Cette alarme a &eacute;t&eacute; modifi&eacute;e et sera mise &agrave; jour.
Gris
Cette alarme fait d&eacute;j&agrave; partie du projet et sera saut&eacute;e.
Synchronisation automatique
S&eacute;lectionnez l'option Synchroniser en temps r&eacute;el dans la bo&icirc;te de dialogue Importer Alarmes pour activer la
synchronisation automatique du fichier de configuration d'alarme.
&Agrave; chaque modification de la configuration des alarmes, le fichier sera automatiquement mis &agrave; jour en mode silencieux.
Astuce : Activez cette fonction lorsque le fichier d'alarme est g&eacute;r&eacute; par un autre outil (par exemple, logiciel de
programmation API), en plus du AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
167
Exporter la configuration des alarmes
168
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
16
Recettes
Les recettes sont des collections de valeurs de variable organis&eacute;es selon des ensembles r&eacute;pondant &agrave; des exigences
sp&eacute;cifiques de l'application.
Par exemple, vous devez contr&ocirc;ler les variables d'une pi&egrave;ce (temp&eacute;rature et humidit&eacute;) le matin, l'apr&egrave;s-midi et le soir. Vous
pourrez cr&eacute;er trois ensembles (matin, apr&egrave;s-midi, soir) dans lesquels vous d&eacute;finirez les valeurs de variable appropri&eacute;es.
Pour une utilisation plus efficace, chaque &eacute;l&eacute;ment de la recette est associ&eacute; &agrave; une variable et peut &ecirc;tre index&eacute; dans des
ensembles. Cette fonctionnalit&eacute; vous permet d'&eacute;tendre les capacit&eacute;s des contr&ocirc;leurs ayant une m&eacute;moire limit&eacute;e.
Vous pouvez ajouter des donn&eacute;es du contr&ocirc;leur &agrave; une page en utilisant un widget de recette. Les donn&eacute;es de recette
contiennent tous les &eacute;l&eacute;ments de donn&eacute;es du contr&ocirc;leur ; cependant, ces donn&eacute;es ne peuvent plus &ecirc;tre consult&eacute;es
directement &agrave; partir du contr&ocirc;leur, mais &agrave; partir de l'&eacute;l&eacute;ment de recette associ&eacute;e sur le p&eacute;riph&eacute;rique IHM.
Les donn&eacute;es de recette sont configur&eacute;es dans l'espace de travail AGI Creator; l'utilisateur peut pr&eacute;ciser les valeurs par
d&eacute;faut pour chaque &eacute;l&eacute;ment des donn&eacute;es enregistr&eacute;es. Dans HMI Runtime, les donn&eacute;es peuvent &ecirc;tre modifi&eacute;es et
sauvegard&eacute;es dans un nouveau fichier de donn&eacute;es, toutes les modifications des donn&eacute;es de recette sont donc stock&eacute;es
sur le disque. En utilisant un fichier de donn&eacute;es distinct HMI Runtimeassure le maintien des valeurs de recette modifi&eacute;es &agrave;
travers les diff&eacute;rentes mises &agrave; jour de projet. Autrement dit, une mise &agrave; jour de projet post&eacute;rieure n'affecte pas les donn&eacute;es
de recette modifi&eacute;es par l'utilisateur dans le HMI Runtime.
Voir &quot;Actions de recette&quot; on page 117pour plus de d&eacute;tails sur la r&eacute;initialisation des donn&eacute;es de recette.
Note : Les donn&eacute;es de recette peuvent &ecirc;tre stock&eacute;es sur une m&eacute;moire flash, sur une cl&eacute; USB ou sur une carte
SD.
Gestion des recettes
169
Configuration d’un widget de recette
172
&Eacute;tat de la recette
173
Charger/t&eacute;l&eacute;charger une recette
173
Sauvegarder et restaurer des donn&eacute;es de recettes
174
Gestion des recettes
Cr&eacute;er une recette
Pour cr&eacute;er une recette pour votre projet :
1. Dans Affichage du projet, cliquez &agrave; l'aide du bouton droit sur Recettes et s&eacute;lectionnez Ins&eacute;rer une recette : une
recette vide s'ajoute. Vous cr&eacute;ez et configurez vos recettes &agrave; l'aide de l'&Eacute;diteur de recettes.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
169
Gestion des recettes
&Eacute;diteur de recettes
Chemin : Affichage du projet&gt; Recettes &gt; double-cliquez sur Nom de la recette
Configurer les propri&eacute;t&eacute;s de recette
Dans le volet Propri&eacute;t&eacute;s de chaque recette, vous pouvez d&eacute;finir les param&egrave;tres suivants :
Param&egrave;tre
Description
Nom de recette
Nom de la recette
Nombre
d'ensembles
Nombre d'ensembles de valeurs pour chaque &eacute;l&eacute;ment de recette. Chaque ensemble a un nom
diff&eacute;rent qui peut &ecirc;tre configur&eacute;.
Param&eacute;trer une recette
1. Cliquez sur + pour ajouter un &eacute;l&eacute;ment &agrave; la recette.
2. Associez les variables &agrave; chaque &eacute;l&eacute;ment de recette.
D&eacute;finir des champs de recette
Cr&eacute;ez un champ de recette dans la page en utilisant un widget num&eacute;rique et en l'associant &agrave; un &eacute;l&eacute;ment de recette apr&egrave;s
voir s&eacute;lectionn&eacute; la recette en tant que source.
170
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
16 Recettes
Dans la bo&icirc;te de dialogue Associer &agrave;, vous avez le choix parmi toutes les diff&eacute;rentes variables de recette, telles que :
l
Recette actuelle &gt;Ensemble de recette actuellement s&eacute;lectionn&eacute;&gt; &Eacute;l&eacute;ment &gt; Valeur
l
Recette s&eacute;lectionn&eacute;e &gt; Ensemble0 s&eacute;lectionn&eacute; &gt; &Eacute;l&eacute;ment &gt; Valeur
l
liste de recettes
Quand les widgets num&eacute;riques sont d&eacute;finies en acc&egrave;s lecture/&eacute;criture, les donn&eacute;es de recette par d&eacute;faut peuvent &ecirc;tre
modifi&eacute;es en cours d'ex&eacute;cution. Ces nouvelles valeurs sont stock&eacute;es sur un fichier distinct en tant que donn&eacute;es de recette
modifi&eacute;es.
Note : &Eacute;tant donn&eacute; que l'on utilise les fonctions de l'API JavaScript, les &eacute;l&eacute;ments de recette et les ensembles
peuvent &ecirc;tre r&eacute;f&eacute;renc&eacute;s par nom ou par position. Afin d'&eacute;viter toute ambigu&iuml;t&eacute; entre les noms et les index, les
noms des &eacute;l&eacute;ments de recette et des ensembles doivent inclure au moins un caract&egrave;re alphanum&eacute;rique.
Stocker les donn&eacute;es de recette
Dans l'&Eacute;diteur de recette, cliquez sur l'ic&ocirc;ne du type de stockage pour s&eacute;lectionner l'endroit o&ugrave; vous souhaitez stocker
les donn&eacute;es de recette : la bo&icirc;te de dialogue du P&eacute;riph&eacute;rique de stockage s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
171
Configuration d’un widget de recette
Pour les cl&eacute;s USB et les cartes de stockage SD, vous pouvez pr&eacute;ciser l'emplacement du dossier.
AVERTISSEMENT : Les fichiers de configuration des recettes sont cr&eacute;&eacute;s automatiquement au moment
de la sauvegarde du projet et sont stock&eacute;s dans le sous-dossier du projet. Pour utiliser les
p&eacute;riph&eacute;riques de stockage externes, vous devez copier ce dossier dans le p&eacute;riph&eacute;rique externe. Notez
que vous avez la responsabilit&eacute; de g&eacute;rer le dossier de donn&eacute;es &agrave; l'int&eacute;rieur des p&eacute;riph&eacute;riques
externes. M&ecirc;me les fichiers dynamiques ne sont pas supprim&eacute;s lorsque le projet est mis &agrave; jour en
utilisant l'option &laquo; Supprimer le fichier dynamique &raquo;.
Important : Vous pouvez ajouter un sous-dossier mais vous ne devez pas renommer le sous-dossier
&quot;donn&eacute;es&quot;.
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&eacute;lectionner un ensemble de recettes pour le charger ou le t&eacute;l&eacute;charger.
Voir &quot;Charger/t&eacute;l&eacute;charger une recette&quot; on the facing page
Menu de recettes : lorsque plusieurs recettes ont &eacute;t&eacute; cr&eacute;&eacute;es pour un projet, utilisez ce widget pour g&eacute;rer toutes les
recettes et s&eacute;lectionnez les ensembles voulus pour chacune d'entre elles.
Configurer le widget d'ensemble de recettes
Dans le volet Propri&eacute;t&eacute;s de chaque widget Ensemble de recettes, d&eacute;finissez les param&egrave;tres suivants :
172
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
16 Recettes
Param&egrave;tre
Description
Nom de recette
Nom de la recette
&Eacute;tat de la recette
Apr&egrave;s chaque chargement ou t&eacute;l&eacute;chargement de recette, ou modification d'un ensemble de recette, les param&egrave;tres &Eacute;tat de
la recette afficheront une valeur correspondant au r&eacute;sultat de l'op&eacute;ration.
Code Fonction
Description
0
Ensemble
modifi&eacute;
Ensemble s&eacute;lectionn&eacute; modifi&eacute;
1
T&eacute;l&eacute;chargement Demande de t&eacute;l&eacute;chargement d&eacute;clench&eacute;e
d&eacute;clench&eacute;
2
T&eacute;l&eacute;chargement Op&eacute;ration de t&eacute;l&eacute;chargement termin&eacute;e
effectu&eacute;
3
Erreur de
t&eacute;l&eacute;chargement
Erreur pendant le t&eacute;l&eacute;chargement (par exemple, ensemble inconnu, recette
inconnue, contr&ocirc;leur pas pr&ecirc;t, &eacute;chec d'&eacute;criture des variables etc.)
4
Chargement
d&eacute;clench&eacute;
Demande de chargement d&eacute;clench&eacute;e
5
Chargement
effectu&eacute;
Op&eacute;ration de chargement termin&eacute;e
6
Erreur de
chargement
Erreur pendant le chargement - pareil que pour le t&eacute;l&eacute;chargement
7
Erreur g&eacute;n&eacute;rale
Erreur g&eacute;n&eacute;rale (par exemple, donn&eacute;es indisponibles)
Note : Au d&eacute;marrage du p&eacute;riph&eacute;rique, la valeur &Eacute;tat de la recette est 0.
Charger/t&eacute;l&eacute;charger une recette
Charger une recette
Vous chargez une recette sur un p&eacute;riph&eacute;rique IHM en utilisant un widget de recette et le UpLoadRecipe, l'action
UpLoadCurRecipe est une des fa&ccedil;ons suivantes :
l
l
l
joindre l'action &agrave; un &eacute;v&eacute;nement d’un bouton ou d’un interrupteur (voir &quot;Param&egrave;tres &laquo; Associer &agrave; &raquo;&quot; on page 38 pour
plus de d&eacute;tails)
configurer l'action dans une liste d’action d'alarme (voir &quot;Actions d'alarmes&quot; on page 106 pour plus de d&eacute;tails)
configurer l'action dans une liste d’action de planificateur (voir &quot;Ordonnancement des &eacute;v&eacute;nements &agrave; l’ex&eacute;cution&quot; on
page 214 pour plus de d&eacute;tails)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
173
Sauvegarder et restaurer des donn&eacute;es de recettes
T&eacute;l&eacute;charger une Recette
Vous t&eacute;l&eacute;chargez une recette depuis un p&eacute;riph&eacute;rique IHM en utilisant un widget de recette et le DownloadRecipe, l'action
DownLoadCurRecipe. Voir &quot;Actions de recette&quot; on page 117.
Sauvegarder et restaurer des donn&eacute;es de recettes
Les donn&eacute;es de recette stock&eacute;es dans un p&eacute;riph&eacute;rique IHM peuvent &ecirc;tre export&eacute;es pour &ecirc;tre sauvegard&eacute;es et restaur&eacute;es
par la suite. Pour ce faire, il faut utiliser les actions ViderDonn&eacute;esRecette ou RestaurerDonn&eacute;esRecette.
Voir &quot;Actions de recette&quot; on page 117 pour plus de d&eacute;tails.
174
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17
Tendances
Les tendances vous permettent de go&ucirc;ter et d'enregistrer les valeurs des variables sp&eacute;cifi&eacute;es en fonction des conditions
sp&eacute;cifiques d'&eacute;chantillonnage. La fonction de tendance comprend l'acquisition de tendance et l'affichage de tendance.
Les param&egrave;tres d'acquisition de tendance sont d&eacute;finies dans l'&eacute;diteur de tendance afin que les donn&eacute;es puissent &ecirc;tre
stock&eacute;es. Les donn&eacute;es stock&eacute;es peuvent ensuite &ecirc;tre affich&eacute;es dans un format graphique en utilisant un widget tendance.
Enregistrement des donn&eacute;es
176
Exporter les donn&eacute;es de m&eacute;moire de tendance
177
Widgets de tendance
178
Tendances historiques
180
Propri&eacute;t&eacute;s du widget de tendance
182
Gestes de widget de tendance
183
Valeurs hors de port&eacute;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 | &copy; 2012-2017 DEIF A/S
175
Enregistrement des donn&eacute;es
Enregistrement des donn&eacute;es
Les donn&eacute;es peuvent &ecirc;tre enregistr&eacute;es et stock&eacute;es dans la m&eacute;moire IHM. L'enregistrement des donn&eacute;es vous permet de
stocker les valeurs d'un groupe de variables au m&ecirc;me moment dans une m&eacute;moire tampon. L'enregistrement des donn&eacute;es
peut &ecirc;tre d&eacute;clench&eacute; par un minuteur ou par une variable d&eacute;di&eacute;e. Les donn&eacute;es enregistr&eacute;es peuvent &ecirc;tre export&eacute;es dans un
fichier .csv ou affich&eacute;es en utilisant le widget de tendance historique. Les donn&eacute;es enregistr&eacute;es peuvent &ecirc;tre sauvegard&eacute;es
localement sur un p&eacute;riph&eacute;rique USB ou sur une carte SD, ou bien sur tout dossier de r&eacute;seau personnalis&eacute; et disponible.
AVERTISSEMENT : L'op&eacute;ration avec des p&eacute;riph&eacute;riques m&eacute;moire amovibles (lecteurs flash USB,
cartes m&eacute;moires SD) contenant un tr&egrave;s grand nombre de fichiers peut entra&icirc;ner une perte de
performance du syst&egrave;me.
AVERTISSEMENT : Le nombre maximal de fichiers dans une carte m&eacute;moire SD d&eacute;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&eacute; d'op&eacute;rations d'&eacute;criture.
Nous vous sugg&eacute;rons de n'utiliser que des cartes m&eacute;moires de bonne qualit&eacute;. Lorsque votre
application utilise la carte m&eacute;moire de mani&egrave;re intensive, pensez &agrave; changer r&eacute;guli&egrave;rement de carte
m&eacute;moire.
AVERTISSEMENT : Si la date/heure est recul&eacute;e, les &eacute;chantillons avec des dates/heures non valides
sont supprim&eacute;s de la m&eacute;moire des tendances. Lorsque le syst&egrave;me d&eacute;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 &eacute;chantillon est utilis&eacute;e pour &eacute;viter de perdre des donn&eacute;es.
Le stockage est bas&eacute; sur les m&eacute;moires des tendances. Les m&eacute;moires des tendances sont organis&eacute;es comme une queue
FIFO : lorsque la m&eacute;moire tampon est pleine, les valeurs les plus anciennes sont rejet&eacute;es sauf si vous configurez votre
tendance pour cr&eacute;er une copie de sauvegarde de la m&eacute;moire tampon.
Ajouter une m&eacute;moire des tendances
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Tendances
1. Cliquez sur Ajouter pour ajouter une nouvelle m&eacute;moire tampon.
2. Cliquez sur + &agrave; c&ocirc;t&eacute; de chaque m&eacute;moire des tendances pour afficher tous les param&egrave;tres de configuration.
176
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
&Eacute;l&eacute;ment
Description
Espace m&eacute;moire total
M&eacute;moire en cours d'utilisation par la m&eacute;moire des tendances. Voir &quot;Tableau de fonctions et
limites&quot; on page 430 pour le nombre maximal d'&eacute;chantillons autoris&eacute; pour un projet.
Ce pourcentage est calcul&eacute; de la mani&egrave;re suivante :
Nom de tendance
Nom de tendance qui sera affich&eacute; dans le volet des propri&eacute;t&eacute;s de la fen&ecirc;tre.
Actif
Lorsque cet &eacute;l&eacute;ment est activ&eacute;, la tendance s'ex&eacute;cute par d&eacute;faut au d&eacute;marrage du syst&egrave;me.
Note : Les tendances ne peuvent pas &ecirc;tre activ&eacute;es en cours d'ex&eacute;cution.
Source
Variables &eacute;chantillonn&eacute;es par la tendance.
Temps
d'&eacute;chantillonnage
Intervalle d'&eacute;chantillonnage en secondes.
D&eacute;clencheur
Variable d&eacute;clenchant l'&eacute;chantillon. Lorsque la valeur de cette variable change, un &eacute;chantillon
est collect&eacute;.
Note : D&eacute;clencheur et Source peuvent faire r&eacute;f&eacute;rence &agrave; la m&ecirc;me variable.
Nombre d'&eacute;chantillons
Taille de la m&eacute;moire tampon.
P&eacute;riph&eacute;rique de
stockage
P&eacute;riph&eacute;rique o&ugrave; les donn&eacute;es de m&eacute;moire des tendances sont stock&eacute;es.
M&eacute;moire tampon
Lorsque l'option Sauvegarder une copie lorsque la m&eacute;moire est satur&eacute;e est activ&eacute;e, une
copie de sauvegarde des donn&eacute;es de m&eacute;moire tampon est cr&eacute;&eacute;e avant qu'elle ne soit
&eacute;cras&eacute;e par de nouvelles donn&eacute;es.
Filtre
Lorsque la condition de d&eacute;clenchement est le temps, un nouvel &eacute;chantillon est stock&eacute;
d'&eacute;chantillonnage/Filtre lorsque sa valeur, compar&eacute;e &agrave; la derni&egrave;re valeur sauvegard&eacute;e, d&eacute;passe les limites
d&eacute;clencheur
sp&eacute;cifi&eacute;es.
Lorsque la condition de d&eacute;clenchement est une variable, un nouvel &eacute;chantillon est stock&eacute; &agrave;
chaque modification de la valeur de d&eacute;clenchement de la variable.
Tableau de variables
&eacute;chantillonn&eacute;
Nom : nom de la tendance
Variable : variable &agrave; &eacute;chantillonner.
Commentaire : description de la tendance
Exporter les donn&eacute;es de m&eacute;moire de tendance
Utilisez l'action ClichageTendance pour exporter des donn&eacute;es de m&eacute;moire de tendance vers un fichier .csv.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
177
Widgets de tendance
Le format des donn&eacute;es de tendance export&eacute;es vers un fichier .csv peut &ecirc;tre s&eacute;lectionn&eacute; depuis un param&egrave;tre macro,
comme sur l'illustration. Toutes les variables sp&eacute;cifi&eacute;es dans la m&eacute;moire des tendances sont export&eacute;es
Mode clichage normal (mode de compatibilit&eacute;)
Mode clichage &eacute;tendu (mode compact)
Note : La premi&egrave;re ligne de l'en-t&ecirc;te contient les noms de variables et les types de donn&eacute;es de variables
Voir &quot;Actions syst&egrave;me&quot; on page 123 pour plus de d&eacute;tails.
Widgets de tendance
Il est possible d'afficher les donn&eacute;es enregistr&eacute;es par le p&eacute;riph&eacute;rique IHM sous forme de graphiques en utilisant les widgets
de tendance.
Widget de tendance en temps r&eacute;el
Le widget de tendance en temps r&eacute;el peut &ecirc;tre utilis&eacute; pour afficher les modifications de valeur d'une variable. Les donn&eacute;es
ne sont pas stock&eacute;es dans une m&eacute;moire des tendances et ne peuvent pas &ecirc;tre r&eacute;cup&eacute;r&eacute;es pour une analyse ult&eacute;rieure.
Pour afficher une tendance en temps r&eacute;el :
178
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
1. Glissez-d&eacute;posez le Widget de tendance en temps r&eacute;el de la galerie des widgets jusqu'&agrave; la page.
2. Associez la variable que vous voulez &eacute;chantillonnez &agrave; la valeur de la Courbe n. Les donn&eacute;es doivent toujours &ecirc;tre
repr&eacute;sent&eacute;es en fonction du temps.
Propri&eacute;t&eacute;s du widget de tendance en temps r&eacute;el
Propri&eacute;t&eacute; Description
Nombre
de
courbes
Nombre de courbes de tendance &agrave; afficher (Max. 5)
Dur&eacute;e de
page
Intervalle de temps de l'axe x.
Position
initiale
Sp&eacute;cifie le point de d&eacute;part de la courbe lorsque la page est ouverte.
Labels X
Nombre de graduations sur l'&eacute;chelle de l'axe x
Labels Y
Nombre de graduations sur l'&eacute;chelle de l'axe y.
Texte
Titre de tendance et propri&eacute;t&eacute;s de police (taille de police, label, etc.)
Grille
Propri&eacute;t&eacute;s de pr&eacute;sentation des grilles (couleurs)
Curseur
Propri&eacute;t&eacute;s de pr&eacute;sentation du curseur (activation et couleur)
&Eacute;chelle
X
Propri&eacute;t&eacute;s de pr&eacute;sentation de l'&eacute;chelle X
Astuce : Vous pouvez associer un widget Date Heure combin&eacute; &agrave; la propri&eacute;t&eacute; de
Dur&eacute;e de Page et modifier de fa&ccedil;on dynamique la dur&eacute;e de la page pendant
l'ex&eacute;cution.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
179
Tendances historiques
Propri&eacute;t&eacute; Description
&Eacute;chelle
Y
Propri&eacute;t&eacute;s de pr&eacute;sentation de l'&eacute;chelle Y
Courbe
&laquo;n&raquo;
variable qui sera repr&eacute;sent&eacute;e dans le widget de tendance. Voir &quot;Propri&eacute;t&eacute;s du widget de
tendance&quot; on page 182 pour plus de d&eacute;tails.
Vous pouvez d&eacute;finir le minimum et le maximum des courbes (Min Y, Max Y). Vous pouvez
associer une variable aux propri&eacute;t&eacute;s minimum et maximum. Cela permet de modifier plus
ais&eacute;ment les valeurs minimum et maximum de fa&ccedil;on dynamique pendant l'ex&eacute;cution.
Mise &agrave; l'&eacute;chelle des donn&eacute;es
Les valeurs de variable peuvent &ecirc;tre mises &agrave; l'&eacute;chelle en utilisant les Formes X dans la bo&icirc;te de dialogue Associer &agrave;. Voir
&quot;Param&egrave;tres &laquo; Associer &agrave; &raquo;&quot; on page 38 pour plus de d&eacute;tails.
Tendances historiques
Les donn&eacute;es de tendance stock&eacute;es dans les m&eacute;moire des tendances peuvent &ecirc;tre analys&eacute;es &agrave; l'aide du widget de
Tendance historique.
Il s'agit d'un processus en deux &eacute;tapes :
l
l
tout d'abord, vous cr&eacute;ez une m&eacute;moire des tendances qui collectera les donn&eacute;es de variables sp&eacute;cifiques &agrave; des
moments sp&eacute;cifiques,
puis vous configurez un widget de Tendance historique de mani&egrave;re &agrave; ce qu'il affiche les donn&eacute;es collect&eacute;es sous
forme de graphique.
Voir &quot;Enregistrement des donn&eacute;es&quot; on page 176 pour plus d&eacute;tails sur la fa&ccedil;on de cr&eacute;er une m&eacute;moire des tendances.
Widget de Tendance historique
Le widget de Tendance historique affiche le contenu de la m&eacute;moire des tendances sous forme de graphique.
L'heure de d&eacute;but correspond &agrave; l'heure actuelle et l'heure de fin correspond &agrave; l'heure actuelle plus la dur&eacute;e de la fen&ecirc;tre. La
courbe part de la gauche et progresse vers la droite, les donn&eacute;es sont automatiquement rafra&icirc;chies pendant un certain
intervalle de temps, jusqu'&agrave; l'heure de fin.
Lorsqu'elle atteindra l'heure de fin, la courbe d&eacute;filera vers la gauche et sa mise &agrave; jour continuera jusqu'&agrave; ce qu'elle atteigne &agrave;
nouveau l'heure de fin. &Agrave; ce moment, un nouveau d&eacute;filement est automatiquement ex&eacute;cut&eacute; et le processus se r&eacute;p&egrave;te.
180
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
Les tendances historiques demandent une configuration appropri&eacute;e de la m&eacute;moire des tendances.
Voir &quot;Enregistrement des donn&eacute;es&quot; on page 176 pour plus d&eacute;tails sur l'utilisation de l'&Eacute;diteur de tendances.
Configurer le widget de Tendance historique
1. &Agrave; partir de la section Tendances/Graphiques de la Galerie des widgets, glissez-d&eacute;posez le widget de Tendance
historique dans la page.
2. Dans le volet Propri&eacute;t&eacute;s, associez la m&eacute;moire des tendances &agrave; tracer dans le widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
181
Propri&eacute;t&eacute;s du widget de tendance
Propri&eacute;t&eacute;s du widget de tendance
Certaines propri&eacute;t&eacute;s de tendance du widget ne sont disponibles que lorsque le volet Propri&eacute;t&eacute;s est en mode Avanc&eacute;.
Demande d'&eacute;chantillons
La propri&eacute;t&eacute; de demande d'&eacute;chantillons peut &ecirc;tre r&eacute;gl&eacute;e pour chaque courbe et indique le nombre maximum
d'&eacute;chantillons lus par le widget &agrave; un moment donn&eacute; de la m&eacute;moire des tendances.
Astuce : Vous n’avez normalement pas besoin de modifier la valeur par d&eacute;faut. Ajuster pour affiner les
performances accord&eacute;es dans le rafra&icirc;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&egrave;re-plan de graphique, par exemple pour mettre
en &eacute;vidence certains jours ou certaines heures (week-ends, heures de nuit, etc.).
182
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
1. Dans le volet Propri&eacute;t&eacute;s, dans la propri&eacute;t&eacute; Bandes de couleur, cliquez sur + : la fen&ecirc;tre Configurer bandes
appara&icirc;t.
2. Cliquez sur + pour ajouter le nombre de couches souhait&eacute;es.
3. S&eacute;lectionnez plusieurs cellules et cliquez sur une bande de couleur pour affecter la couleur &agrave; la plage s&eacute;lectionn&eacute;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&eacute;filer
Touchez le widget pour faire d&eacute;filer la courbe dans la zone de widget
pincer
Utilisez deux doigts pour pincer la courbe et effectuer des op&eacute;rations de zoom
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent g&eacute;n&eacute;rer des &eacute;v&eacute;nements de
pincement
Note : Afin de soutenir les gestes sur l'axe Y, les propri&eacute;t&eacute;s min/max du widget de tendance doivent &ecirc;tre li&eacute;es
aux valeurs Min/Max des param&egrave;tres de comportement (par d&eacute;faut pour les nouvelles tendances).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
183
Valeurs hors de port&eacute;e ou non valides
Valeurs hors de port&eacute;e ou non valides
Lorsque la valeur de tendance d&eacute;passe les limites d&eacute;finies pour le widget de tendance, une ligne pointill&eacute;e appara&icirc;t.
Lorsque la valeur de la variable n'est pas disponible, par exemple lorsque le p&eacute;riph&eacute;rique du contr&ocirc;leur est hors ligne,
aucune courbe n'est trac&eacute;e.
184
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
Afficher les valeurs de tendance
Le curseur de tendance affiche la valeur de la tendance &agrave; un moment pr&eacute;cis.
Utilisez les actions AfficherCurseurTendance et FaireD&eacute;filerCurseurTendance pour activer le curseur de la tendance et
le d&eacute;placer vers le point n&eacute;cessaire pour obtenir la valeur de la courbe &agrave; ce moment pr&eacute;cis dans le temps.
Pour afficher la valeur du curseur de tendance sur la page, d&eacute;finir un champ num&eacute;rique et l'attacher &agrave; la variable du widget
Valeur du Curseur.
Dans cet exemple, la valeur de l'axe Y du curseur est affich&eacute;e.
Pour afficher l’horodatage de tendance sur la position du curseur, d&eacute;finir un champ num&eacute;rique et l'attacher &agrave; la variable du
widget Valeur de l’horodatage.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &agrave; partir d'un ensemble
de donn&eacute;es &agrave; l'aide de coordonn&eacute;es cart&eacute;siennes. Les donn&eacute;es sont affich&eacute;es comme un ensemble de points, chacune
ayant la valeur d'une variable de d&eacute;termination de la position sur l'axe horizontal et la valeur de l'autre variable d&eacute;terminant
la position sur l'axe vertical. C’est la raison pour laquelle il est souvent appel&eacute; graphique XY.
Les courbes de diagramme de dispersion sont obtenues par une interpolation lin&eacute;aire des points. Pour cr&eacute;er un nouveau
diagramme de dispersion :
1. Ajoutez un widget Diagramme de dispersion &agrave; la page.
2. S&eacute;lectionnez le nombre de courbes &agrave; afficher : chaque courbe est nomm&eacute;e comme Graph1, Graph2, etc.
3. Personnalisez les propri&eacute;t&eacute;s des graphes g&eacute;n&eacute;raux tels que les d&eacute;tails X Min, X Max, de la grille.
4. D&eacute;finir le nombre maximum d'&eacute;chantillons/valeurs pour chaque courbe en d&eacute;finissant le param&egrave;tre &Eacute;chantillon
max.
Vous d&eacute;finissez ici le nombre maximum de valeurs &agrave; afficher dans le graphique &agrave; partir du premier &eacute;l&eacute;ment du
tableau.
186
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
17 Tendances
Par exemple : Tag1[20] et &eacute;chantillons Max = 10 montreront seulement les 10 premiers &eacute;l&eacute;ments du tableau Tag1.
5. D&eacute;finir pour chaque courbe les deux variables de tableau type &agrave; afficher (variable X et variable Y).
Lorsque les variables de tableau changent, vous pouvez forcer un rafra&icirc;chissement &agrave; l'action de Rafra&icirc;chirTendance.
Note : Les diagrammes de dispersion ne supporte que l’action Rafra&icirc;chirTendance.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
187
Widget de diagramme de dispersion
188
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
18
Transfert de donn&eacute;es
Le transfert de donn&eacute;es vous permet de transf&eacute;rer des donn&eacute;es de variables d'un p&eacute;riph&eacute;rique &agrave; l'autre. En utilisant cette
fonctionnalit&eacute;, un p&eacute;riph&eacute;rique IHM peut op&eacute;rer comme une passerelle entre deux p&eacute;riph&eacute;riques, m&ecirc;me lorsqu'ils n'utilisent
pas le m&ecirc;me protocole de communication.
&Eacute;diteur de transfert de donn&eacute;es
190
Exporter donn&eacute;es vers fichiers .csv
192
Limites et recommandations du transfert de donn&eacute;es
192
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
189
&Eacute;diteur de transfert de donn&eacute;es
&Eacute;diteur de transfert de donn&eacute;es
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Transfer de donn&eacute;es
Utilisez l'&eacute;diteur de transfert de donn&eacute;es pour cartographier les r&egrave;gles de transfert.
Chaque ligne de l'&eacute;diteur de transfert de donn&eacute;es d&eacute;finit une r&egrave;gle de correspondance entre les deux variables. D&eacute;finir
plusieurs r&egrave;gles de correspondance si vous avez besoin direction diff&eacute;rente, la m&eacute;thode de mise &agrave; jour ou de d&eacute;clencheur.
Pour ajouter une nouvelle r&egrave;gle, cliquez sur + : une nouvelle ligne de variable appara&icirc;t.
Barre d’outil de transfert de donn&eacute;es
Param&egrave;tre
Description
Import / Export
Importer ou exporter les param&egrave;tres de transfert de donn&eacute;es depuis ou vers un fichier
.csv.
Rechercher
Affiche uniquement les lignes contenant le mot-cl&eacute; de recherche.
Filtrer par
Afficher uniquement les lignes filtre et champ de recherche correspondant.
Param&egrave;tres de transfert de donn&eacute;es
Param&egrave;tre
Description
TAG A / TAG B
Paire de variables &agrave; mapper pour l'&eacute;change via le dispositif IHM.
Direction
Direction de transfert.
A-&gt;B et B-&gt;A : Transferts unidirectionnels, les valeurs sont toujours copi&eacute;es d'un tag
et envoy&eacute;es &agrave; l'autre variable dans la direction indiqu&eacute;e.
A&lt;-&gt;B : Transfert bidirectionnel, les valeurs sont transf&eacute;r&eacute;es vers et depuis les deux
variables.
M&eacute;thode de mise
190
D&egrave;s le d&eacute;clenchement : Le transfert de donn&eacute;es se produit lorsque la valeur de la
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
18 Transfert de donn&eacute;es
Param&egrave;tre
Description
&agrave; jour
variable d&eacute;finie comme les changements de d&eacute;clenchement au-dessus ou en dessous
des valeurs d&eacute;finies comme limites. Les limites sont recalcul&eacute;es sur la valeur de la
variable pr&eacute;c&eacute;dente, le m&ecirc;me qui a d&eacute;clench&eacute; la mise &agrave; jour.
Note : Cette m&eacute;thode s’applique uniquement aux transferts unidirectionnels
(A-&gt;B ou B-&gt;A).
D&egrave;s la mise &agrave; jour : Le transfert de donn&eacute;es se produit &agrave; chaque fois que la valeur des
variables source change.
Note : Cette m&eacute;thode vaut aussi bien pour les transferts unidirectionnels que
ceux bidirectionnels (A-&gt;B, B-&gt;A et A&lt;-&gt;B).
Note : Le runtime surveille cycliquement les changements des variables
source (variable d&eacute;clencheur lors de l'utilisation sur D&eacute;clencheur ou des
variables &agrave; transf&eacute;rer lors de l'utilisation sur Mise &agrave; jour) bas&eacute; sur le
param&egrave;tre de Fr&eacute;quence de l'&eacute;diteur de variable. Si le param&egrave;tre Fr&eacute;quence
pour la variable source est de 500 ms (par d&eacute;faut), le syst&egrave;me v&eacute;rifie les
mises &agrave; jour toutes les 500 ms.
Note : Les modifications sur les variables des sources plus rapides que la
fr&eacute;quence ne peuvent &ecirc;tre pas d&eacute;tect&eacute;es.
D&eacute;clencheur,
Limite
sup&eacute;rieure,
Limite inf&eacute;rieure
Variable qui d&eacute;clenche le processus de transfert de donn&eacute;es. Lorsque cette variable
modifie sa valeur en dehors des limites fix&eacute;es comme limite sup&eacute;rieure et limite
inf&eacute;rieure, le transfert de donn&eacute;es d&eacute;marre. La plage de tol&eacute;rance est recalcul&eacute;e en
fonction des limites sp&eacute;cifi&eacute;es sur la valeur de la variable qui a d&eacute;clench&eacute; la mise &agrave; jour
pr&eacute;c&eacute;dente. Aucune action n’est prise si le changement se situe dans les limites.
Ce m&eacute;canisme permet de d&eacute;clencher des transferts de donn&eacute;es uniquement lorsque
les variations significatives des valeurs de r&eacute;f&eacute;rence se produisent.
La limite inf&eacute;rieure est inf&eacute;rieure ou &eacute;gale &agrave; z&eacute;ro.
Note : Si les deux limite inf&eacute;rieure et limite sup&eacute;rieure sont r&eacute;gl&eacute;e sur
&laquo; 0 &raquo;, le transfert de donn&eacute;es se produit &agrave; chaque fois que la valeur de la
variable de d&eacute;clenchement change
au moment du
d&eacute;marrage
Lorsqu'il est s&eacute;lectionn&eacute;, le transfert de donn&eacute;es est forc&eacute; :
l
l
sur un d&eacute;marrage IHM si la qualit&eacute; de la variable source est bonne
apr&egrave;s des erreurs de communication, lorsque les Nœuds de p&eacute;riph&eacute;rique
associ&eacute; revient actif
Voir &quot;Objets&quot; on page 336 pour plus de d&eacute;tails relatifs &agrave; la qualit&eacute;.
Important : Les transferts de donn&eacute;es ex&eacute;cut&eacute;s au d&eacute;marrage peuvent
avoir un impact majeur sur le temps de d&eacute;marrage du p&eacute;riph&eacute;rique
IHM. Activez cette option seulement si n&eacute;cessaire.
Exemple de r&eacute;glage de la limite
Limite sup&eacute;rieure = 1,9
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
191
Exporter donn&eacute;es vers fichiers .csv
Limite inf&eacute;rieure = - 0,9
• = points o&ugrave; le transfert de donn&eacute;es est d&eacute;clench&eacute;
Exporter donn&eacute;es vers fichiers .csv
Les informations de configuration pour les transferts de donn&eacute;es peuvent &ecirc;tre export&eacute;es vers un fichier .csv.
Exemple de param&egrave;tres de transfert de donn&eacute;es vers un fichier .csv
Colonne Description
A&agrave;G
M&ecirc;me donn&eacute;es que dans l'&eacute;diteur de transfert de donn&eacute;es
H
Identifiant uniquement associ&eacute; automatiquement &agrave; chaque ligne.
Important : Lorsque vous &eacute;ditez le fichier .csv et que vous ajoutez toute ligne
suppl&eacute;mentaire, v&eacute;rifiez que vous entrez bien un identifiant unique dans cette
colonne.
I et J
R&eacute;serv&eacute;s &agrave; une utilisation ult&eacute;rieure.
L’import / export utilise le caract&egrave;re de s&eacute;paration d&eacute;finie &agrave; l'int&eacute;rieur des param&egrave;tres r&eacute;gionaux de Windows.
Limites et recommandations du transfert de donn&eacute;es
Une d&eacute;finition correcte des r&egrave;gles de transfert des donn&eacute;es est critique pour la performance des p&eacute;riph&eacute;riques IHM. Pour
garantir une op&eacute;ration et une performance fiables, gardez &agrave; l'esprit les r&egrave;gles suivantes.
192
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
18 Transfert de donn&eacute;es
M&eacute;thode d&egrave;s le d&eacute;clenchement
La m&eacute;thode D&egrave;s le d&eacute;clenchement ne permet que des transferts unidirectionnels (A-&gt;B ou B-&gt;A).
Le transfert de donn&eacute;es bas&eacute; sur le mode D&egrave;s le d&eacute;clenchement doit &ecirc;tre privil&eacute;gi&eacute; car il vous permet de forcer le transfert
et il surveille uniquement les variables de d&eacute;clenchement et non toutes les variables impliqu&eacute;es dans le transfert.
M&eacute;thode d&egrave;s la mise &agrave; jour
La m&eacute;thode D&egrave;s la mise &agrave; jour permet de changer les valeurs selon les param&egrave;tres de direction uniquement lorsque la
valeur de la source est modifi&eacute;e.
En utilisant la m&eacute;thode D&egrave;s la mise &agrave; jour, vous forcez le syst&egrave;me &agrave; lire continuellement toutes les variables de source
d&eacute;finies pour v&eacute;rifier si des modifications doivent &ecirc;tre transf&eacute;r&eacute;es. La valeur par d&eacute;faut de la fr&eacute;quence des mises &agrave; jour de
chaque variable est de 500 ms et peut &ecirc;tre modifi&eacute;e avec l'&Eacute;diteur de variables.
Observations sur la performance
La performance du transfert de donn&eacute;es d&eacute;pend :
l
du nombre de transferts de donn&eacute;es d&eacute;finis,
l
du nombre de transferts de donn&eacute;s qui pourrait se produire en m&ecirc;me temps,
l
de la fr&eacute;quence des modifications des variables API qui sont surveill&eacute;es,
Important : Testez toujours la performance de l'op&eacute;ration durant le d&eacute;veloppement du projet.
Important : Si les t&acirc;ches de transfert de donn&eacute;es sont d&eacute;finies de mani&egrave;re inappropri&eacute;e, elles peuvent
entra&icirc;ner des conditions o&ugrave; les variables impliqu&eacute;es cr&eacute;ent des boucles. Identifiez et &eacute;vitez de telles
conditions.
Astuce : Utilisez le planificateur pour calibrer la fr&eacute;quence de mise &agrave; jour sur la performance de l'ensemble de
votre projet.
Astuce : Utilisez des variables de type tableau pour optimiser le transfert de donn&eacute;es et r&eacute;duire la charge de
travail.
Astuce : R&eacute;duisez le nombre de transferts de donn&eacute;es pour r&eacute;duire le temps de modification de la page et le
temps de chargement.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
193
Limites et recommandations du transfert de donn&eacute;es
194
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
19
Gestion de nœud hors ligne
Lorsqu'un contr&ocirc;leur en communication avec les p&eacute;riph&eacute;riques IHM est mis hors connexion, la performance de
communication du syst&egrave;me pourrait diminuer.
La fonctionnalit&eacute; de gestion de nœud hors ligne reconna&icirc;t les contr&ocirc;leurs hors connexion et les &eacute;carte de la communication
jusqu'&agrave; leur remise en ligne.
De plus, si vous savez qu'un contr&ocirc;leur inclus dans l'installation sera mis hors connexion pendant un certain temps, vous
pouvez le d&eacute;sactiver manuellement afin d'optimiser la performance du syst&egrave;me.
Note : Cette fonctionnalit&eacute; n'est pas support&eacute;e par tous les protocoles de communication. V&eacute;rifiez la
documentation de protocole pour savoir si elle est support&eacute;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&eacute;tection automatique de nœuds hors ligne
197
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
195
Processus de gestion du nœud hors ligne
Processus de gestion du nœud hors ligne
Les &eacute;tapes de ce processus sont :
l
l
Le syst&egrave;me communique normalement avec un p&eacute;riph&eacute;rique donn&eacute;. En cas d'absence de r&eacute;ponse du p&eacute;riph&eacute;rique &agrave;
une demande de communication, le syst&egrave;me r&eacute;p&egrave;te la demande deux fois, puis d&eacute;clare le p&eacute;riph&eacute;rique hors ligne.
Quand un p&eacute;riph&eacute;rique est hors ligne, le syst&egrave;me envoie des demandes de communication au p&eacute;riph&eacute;rique selon un
intervalle plus long, que l'on appelle D&eacute;lai d'attente avant nouvelle tentative. Si le p&eacute;riph&eacute;rique r&eacute;pond &agrave; l'une de ces
demandes, le syst&egrave;me le d&eacute;clare en ligne et reprend une communication normale.
Le diagramme montre les trois tentatives de communication et la proc&eacute;dure de restauration qui d&eacute;marre d&egrave;s l'expiration du
D&eacute;lai d'attente avant nouvelle tentative.
Processus de gestion manuelle du nœud hors ligne
La gestion du nœud hors ligne peut &ecirc;tre faite manuellement. Lorsqu'un p&eacute;riph&eacute;rique sp&eacute;cifique est connect&eacute; et
communique normalement, vous pouvez :
l
l
utiliser une action pour d&eacute;clarer le p&eacute;riph&eacute;rique hors ligne : le syst&egrave;me interrompra la communication avec le
p&eacute;riph&eacute;rique.
utiliser une action pour d&eacute;clarer le p&eacute;riph&eacute;rique en ligne : le syst&egrave;me reprendra la communication normale avec le
p&eacute;riph&eacute;rique.
Configuration manuelle hors ligne
Lorsque vous savez que certains p&eacute;riph&eacute;riques en communication avec le p&eacute;riph&eacute;rique IHM resteront d&eacute;connect&eacute;s
pendant un certain temps, vous pouvez les exclure de la communication en recourant &agrave; l'action Activer le nœud.
AVERTISSEMENT : Tous les nœuds de p&eacute;riph&eacute;rique d&eacute;sactiv&eacute;s resteront d&eacute;sactiv&eacute;s si le m&ecirc;me projet
est t&eacute;l&eacute;charg&eacute; sur le p&eacute;riph&eacute;rique, a contrario, si un projet diff&eacute;rent est t&eacute;l&eacute;charg&eacute;, tous les
p&eacute;riph&eacute;riques d&eacute;sactiv&eacute;s seront r&eacute;activ&eacute;s. Il en va de m&ecirc;me en cas de mise &agrave; jour de paquet.
Astuce : Pour rendre cette fonctionnalit&eacute; plus dynamique, vous pouvez d&eacute;cider de ne pas indiquer d'ID de
nœud sp&eacute;cifique, mais de l'associer &agrave; la valeur d'une variable ou &agrave; une variable interne cr&eacute;&eacute;e pour identifier les
diff&eacute;rents p&eacute;riph&eacute;riques &eacute;ventuellement install&eacute;s sur votre r&eacute;seau.
Note : Lorsque vous utilisez l'action Activer le nœud pour forcer la remise en ligne d'un nœud de p&eacute;riph&eacute;rique,
la communication reprend imm&eacute;diatement.
196
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
19 Gestion de nœud hors ligne
D&eacute;tection automatique de nœuds hors ligne
Lorsqu'un p&eacute;riph&eacute;rique ne r&eacute;pond pas aux demandes de communication, il est d&eacute;sactiv&eacute;. Le p&eacute;riph&eacute;rique IHM arr&ecirc;te
d'envoyer des demandes &agrave; ce p&eacute;riph&eacute;rique. Apr&egrave;s trois secondes, le p&eacute;riph&eacute;rique IHM envoie une commande pour v&eacute;rifier
si le p&eacute;riph&eacute;rique est disponible, auquel cas la communication est red&eacute;marr&eacute;e. Dans le cas contraire, le p&eacute;riph&eacute;rique est
d&eacute;sactiv&eacute; pour un autre intervalle de d&eacute;lai d'attente.
Les param&egrave;tres par d&eacute;faut peuvent &ecirc;tre modifi&eacute;s dans l'&eacute;diteur Protocole.
Note : Seuls certains protocoles prennent en charge cette fonction.
Param&egrave;tre
Description
Activer algorithme hors
ligne
Active la gestion hors ligne du protocole
D&eacute;lai d'attente nouvelle
tentative hors ligne
Intervalle en secondes du cycle de nouvelle tentative apr&egrave;s la d&eacute;sactivation
d'un p&eacute;riph&eacute;rique. Plage : 1–86.400 secondes (24 h).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
197
D&eacute;tection automatique de nœuds hors ligne
198
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
20
Multilangue
La fonctionnalit&eacute; multilangue a &eacute;t&eacute; con&ccedil;ue pour cr&eacute;er des applications IHM contenant des textes en plusieurs langues
simultan&eacute;es
La fonctionnalit&eacute; multilangue utilise un support de pages de code pour g&eacute;rer les diff&eacute;rentes langues. Une page de code (ou
un fichier de script) est une s&eacute;rie de formes de lettres utilis&eacute;es au sein de chaque langue.
La fonctionnalit&eacute; multilangue peut &ecirc;tre utilis&eacute;e pour d&eacute;finir les langues et les jeux de caract&egrave;res d'un projet. AGI Creator
d&eacute;veloppe les polices TrueType propos&eacute;es par les syst&egrave;mes Windows afin de fournir diff&eacute;rentes familles de police
associ&eacute;es &agrave; diff&eacute;rents jeux de caract&egrave;res.
AGI Creator vous permet &eacute;galement de fournir des cha&icirc;nes pour chaque langue support&eacute;e.
AGI Creator vous permet enfin de modifier la langue d'affichage afin de vous donner une id&eacute;e de l'aspect et de la
convivialit&eacute; de la page pendant la phase de conception.
Important : Dans les syst&egrave;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&eacute;es pour le Chinois Simplifi&eacute;
Pour le Chinois Simplifi&eacute;, les polices suivantes sont support&eacute;es :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;es pour le Chinois Traditionnel
Pour le Chinois Traditionnel, les polices suivantes sont support&eacute;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'&eacute;diteur multilangue
201
Changer de langue
202
Widgets multilangues
202
Exporter/importer des cha&icirc;nes multilangues
204
Modifier la langue &agrave; l'ex&eacute;cution
206
Limites de la prise en charge UNICODE
206
200
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
20 Multilangue
L'&eacute;diteur multilangue
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Multilangue
Param&egrave;tres de langue
Param&egrave;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&eacute; pour associer des &eacute;l&eacute;ments de langue lors de
l'importation de ressources depuis des fichiers xml externes.
Syst&egrave;me
d'&eacute;criture
S&eacute;lectionnez le jeu de polices &agrave; utiliser avec la langue
Police par
d&eacute;faut
Police par d&eacute;faut pour les widgets du projet.
Polices
Nombre de polices associ&eacute;es avec la langue s&eacute;lectionn&eacute;e.
Taille
M&eacute;moire utilis&eacute;e pour stocker les fichiers de polices.
Stockage
Le fichier de polices est stock&eacute; dans une m&eacute;moire externe amovible.
Note : Lorsque vous choisissez une nouvelle police, vous &ecirc;tes invit&eacute; &agrave; remplacer la police
utilis&eacute;e dans les widgets que vous avez d&eacute;j&agrave; cr&eacute;&eacute;s.
Astuce : Stockez les fichiers de polices volumineux sur une m&eacute;moire amovible pour lib&eacute;rer de
la m&eacute;moire requise dans le p&eacute;riph&eacute;rique IHM.
Ajouter une langue
1. Dans l'onglet Langues, cliquez sur + : une ligne s'ajoute au tableau.
2. Entrez tous les param&egrave;tres de langue.
3. Cliquez sur Par d&eacute;faut pour d&eacute;finir la langue s&eacute;lectionn&eacute;e comme langue par d&eacute;faut lorsque le runtime d&eacute;marre.
4. Cliquez sur Sauvegarder police pour copier les polices que vous avez marqu&eacute;es comme Amovibles sur une
m&eacute;moire externe.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
201
Changer de langue
Important : Les fichiers de polices configur&eacute;s pour &ecirc;tre stock&eacute;s sur une m&eacute;moire amovible doivent
&ecirc;tre fournis &agrave; l'utilisateur final pour terminer l'installation de la police sur le p&eacute;riph&eacute;rique IHM.
Supprimer des polices
Pour supprimer des polices qui ne sont plus n&eacute;cessaires :
1. Cliquez sur le num&eacute;ro de police dans l'&eacute;diteur multilangue : une bo&icirc;te de dialogue contenant la liste des polices
utilis&eacute;e s'affiche.
2. S&eacute;lectionnez les polices &agrave; supprimer et cliquez sur Supprimer : les polices supprim&eacute;es sont remplac&eacute;es par la
police par d&eacute;faut.
Changer de langue
Changer la langue pendant la conception de page
Une liste d&eacute;roulant est disponible pour modifier la langue pendant la conception de page. Si aucun texte n'appara&icirc;t, veuillez
s&eacute;lectionner l'onglet Texte dans l'&eacute;diteur multilangue et entrez la cha&icirc;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'&eacute;tiquette
Double-cliquez sur un widget de texte dans une page pour ouvrir la bo&icirc;te de dialogue Texte.
202
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
20 Multilangue
Activez/D&eacute;sactivez la fonction multilangue, &eacute;ditez le texte pour la langue s&eacute;lectionn&eacute;e et choisissez la police.
Note : Les propri&eacute;t&eacute;s caract&egrave;re gras, italique et de couleurs d&eacute;finies ici pour le widget sont applicables &agrave; toutes
les langues.
Param&egrave;tre
Description
Multilangue
Activez/d&eacute;sactivez la fonction multilangue pour le widget.
Choisir texte depuis un
autre widget
Cliquez sur le bouton pour parcourir les cha&icirc;nes de message pr&eacute;sentes dans le projet afin
de s&eacute;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&icirc;te de dialogue Texte de message.
Param&egrave;tre
Description
Multilangue
Activez/d&eacute;sactivez la fonction multilangue pour le widget.
Index continu
L'index pour le widget est une s&eacute;rie de chiffres cons&eacute;cutifs (exemple 3, 4,5,6)
Min
Chiffre de d&eacute;part pour l'index
Range
Nombre de messages
Choisir texte depuis un
autre widget
Cliquez sur le bouton pour parcourir les cha&icirc;nes de message pr&eacute;sentes dans le projet afin
de s&eacute;lectionner un texte pour le widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
203
Exporter/importer des cha&icirc;nes multilangues
Multi-langue pour les messages d'alarme
Pour ajouter des cha&icirc;nes multilangues pour les messages d'alarme :
1. Ouvrez l'&Eacute;diteur d'alarme.
2. S&eacute;lectionnez une langue en utilisant la liste d&eacute;roulante des langues.
3. Entrez le texte pour l'alarme dans la colonne Description.
Astuce : Les &eacute;tiquettes de texte avec les &eacute;tats d'alarme affich&eacute;s par les widgets d'alarme peuvent &ecirc;tre traduites
ou personnalis&eacute;es &agrave; l'aide de l'&eacute;diteur de texte multilangue.
Multilangue pour les messages contextuels
Pour ajouter un message contextuel multilangue :
1. S&eacute;lectionnez une langue dans la liste d&eacute;roulante des langues.
2. Ajoutez l'action de page ShowMessage et entrez le texte dans la langue s&eacute;lectionn&eacute;e.
Exporter/importer des cha&icirc;nes multilangues
La mani&egrave;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&eacute;sulte puis de r&eacute;importer le texte traduit dans le projet.
Important : Le fichier .csv export&eacute; par AGI Creator est cod&eacute; en Unicode, vous avez donc besoin d'un
outil sp&eacute;cifique qui prend en charge les fichiers .csv encod&eacute;s en Unicode pour l'&eacute;diter.
204
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
20 Multilangue
Exporter et r&eacute;importer des cha&icirc;nes
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Multilangue
Pour exporter et r&eacute;importer des cha&icirc;nes multilangues :
1. Dans l'onglet Texte, cliquez sur Exporter : toutes les cha&icirc;nes multilangues sont export&eacute;es dans un fichier .csv.
Important : D&eacute;finissez toutes les langues qui sont utilis&eacute;es dans le projet avant d'exporter le
fichier. Cela garantit que le fichier export&eacute; contienne toutes les d&eacute;finitions de colonnes et de
langue.
2. Lorsque les cha&icirc;nes ont &eacute;t&eacute; traduites, cliquez sur Importer pour les r&eacute;importer dans le projet : les cha&icirc;nes sont
import&eacute;es selon l'ID du widget et le num&eacute;ro de page de chaque widget.
3. Cliquez sur Sauvegarder pour sauvegarder les donn&eacute;es du nouveau widget.
Note : Pour changer le s&eacute;parateur utilis&eacute; dans le fichier export&eacute;, changez les param&egrave;tres r&eacute;gionaux de votre
ordinateur. Lors de l'importation, l'information du s&eacute;parateur est r&eacute;cup&eacute;r&eacute;e dans le fichier. Si elle est introuvable,
le caract&egrave;re par d&eacute;faut &laquo; , &raquo; est utilis&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
205
Modifier la langue &agrave; l'ex&eacute;cution
Contraintes d'importation
Les formats suivants sont pris en charge pour l'importation :
l
Valeurs s&eacute;par&eacute;es par des virgules (.csv)
l
Texte Unicode (.txt)
Note : Utilisez le format de fichier en Texte Unicode lorsque vous importez un fichier modifi&eacute; avec Microsoft&reg;
Excel&reg;.
Modifier la langue &agrave; l'ex&eacute;cution
Modifier la langue avec une action
Apr&egrave;s le t&eacute;l&eacute;chargement du projet, le runtime IHM utilise la langue d&eacute;finie par d&eacute;faut. Vous pouvez modifier la langue en
utilisant l'action ConfigurerLangue. Voir &quot;Actions multilangues&quot; on page 107.
Note : Lorsque la langue est modifi&eacute;e, elle sera &eacute;galement utilis&eacute;e lors des sessions ult&eacute;rieures.
Polices manquantes
Lorsque vous changez de langue, si les polices n&eacute;cessaires ne sont pas disponibles dans la m&eacute;moire du p&eacute;riph&eacute;rique, un
message contextuel vous invite &agrave; ins&eacute;rer la carte m&eacute;moire contenant les polices manquantes. &Agrave; la fin de l'op&eacute;ration, vous
pouvez retirer la carte m&eacute;moire.
Limites de la prise en charge UNICODE
AGI Creator a &eacute;t&eacute; con&ccedil;u pour accepter le texte Unicode. Cependant, en cas de probl&egrave;mes d'incompatibilit&eacute; avec certaines
plateformes, Unicode n'est pris en charge que dans un sous-ensemble de propri&eacute;t&eacute;s.
206
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
20 Multilangue
Domaine
Propri&eacute;t&eacute;
Jeu de caract&egrave;res accept&eacute;
Caract&egrave;res/Cha&icirc;nes
r&eacute;serv&eacute;s
&Eacute;diteur de
protocole
Alias
ASCII [32..126]
(espace) , ; : . &lt; * &gt;'
&Eacute;diteur de
variable
Nom
ASCII [32..126]
. \ / * ? : &gt; &lt; | &quot; &amp; # %;=
Groupe
ASCII [32..126]
&lt;Nouveau&gt; \ / * ? : &gt; &lt; | &quot; &amp;
#%;
Commentaire
Unicode
Tendances
Nom
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Rapports
d'impression
Nom
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Alarmes
Nom
ASCII [36..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Description
Unicode
[] - pour les variables
actives, \ &eacute;chap pour [ et \
&Eacute;v&eacute;nements
Nom de m&eacute;moire
tampon
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Planificateur
Nom
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Langages
Nom de la langue
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Textes dans les
widgets
Unicode
-
Textes issus de
fichiers import&eacute;s
Unicode
-
Groupe
utilisateur
Nom de groupe
a-z A-Z _
admin,guest,unauthorized
Commentaires
Unicode
-
Utilisateur
Nom
ASCII [32..126]
\/*?:&gt;&lt;|&quot;&amp;#%;
Mot de passe
Unicode
-
Commentaire
Unicode
-
Nom
ASCII [32..126]
\ / * ? : &gt; &lt; &quot; &amp; # % ; ! $'
()+,=@[]{}~`
Nom d'ensemble
ASCII [32..126]
\ / * ? : &gt; &lt; &quot; &amp; # % ; ! $'
()+,=@[]{}~`
Nom d'&eacute;l&eacute;ment
ASCII [32..126]
\ / * ? : &gt; &lt; &quot; &amp; # % ; ! $'
()+,=@[]{}~`
Nom du projet
A-Z,a-z,0-9,-,_
“PUBLIC”, “readme”,
“index.html”
Recettes
G&eacute;n&eacute;ral(e)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
207
Limites de la prise en charge UNICODE
Domaine
Runtime
208
Propri&eacute;t&eacute;
Jeu de caract&egrave;res accept&eacute;
Caract&egrave;res/Cha&icirc;nes
r&eacute;serv&eacute;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&egrave;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&eacute;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 | &copy; 2012-2017 DEIF A/S
21
Planificateur
AGI Creator fournit un moteur de planificateur qui peut ex&eacute;cuter des actions sp&eacute;cifiques &agrave; des intervalles d&eacute;finis, ou sur
une base de temps.
La cr&eacute;ation d'un emploi du temps est g&eacute;n&eacute;ralement un processus en deux &eacute;tapes :
1. Vous cr&eacute;ez un calendrier avec une liste d'actions &agrave; ex&eacute;cuter lorsque l'&eacute;v&eacute;nement programm&eacute; se produit. Vous faites
cela dans l'&eacute;diteur du planificateur.
2. Vous cr&eacute;ez une interface utilisateur d'ex&eacute;cution qui permet &agrave; l'utilisateur final de modifier les param&egrave;tres pour
chaque calendrier. Vous faites cela en ajoutant un widget Planificateur &agrave; une page de votre projet et la configuration
pour l'adapter aux besoins de planification de l'utilisateur.
Cr&eacute;er un ordonnancement
210
Ordonnancement Haute Fr&eacute;quence
210
Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives
211
Configurer un emplacement pour les ordonnancements
213
Configurer le widget planificateur
213
Ordonnancement des &eacute;v&eacute;nements &agrave; l’ex&eacute;cution
214
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
209
Cr&eacute;er un ordonnancement
Cr&eacute;er un ordonnancement
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Planificateur
l
Cliquez sur + pour ajouter un ordonnancement.
Param&egrave;tres d'ordonnancement
Param&egrave;tre
Description
ID
Code unique assign&eacute; automatiquement &agrave; l'ordonnancement
Nom
Nom de l'ordonnancement
Type
Type d'ordonnancement :
l
R&eacute;p&eacute;titif, voir &quot;Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives&quot; on the facing page pour plus de d&eacute;tails.
l
Haute Fr&eacute;quence, voir &quot;Ordonnancement Haute Fr&eacute;quence&quot; below pour plus de d&eacute;tails
Ordonnancer Param&egrave;tres et options du planificateur. Voir &quot;Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives&quot; on the facing
page pour plus de d&eacute;tails.
Action
Actions devant &ecirc;tre ex&eacute;cut&eacute;es &agrave; un moment programm&eacute;
Priorit&eacute;
Niveau de priorit&eacute; pour l'&eacute;v&eacute;nement. Si deux ordonnancements se produisent au m&ecirc;me moment,
l'&eacute;v&eacute;nement avec la priorit&eacute; la plus haute sera ex&eacute;cut&eacute; en premier.
Ordonnancement Haute Fr&eacute;quence
L'ordonnancement Haute Fr&eacute;quence sert &agrave; ex&eacute;cuter des actions qui demandent &agrave; &ecirc;tre r&eacute;p&eacute;t&eacute;es &agrave; des intervalles donn&eacute;s.
L'intervalle entre les ex&eacute;cutions est d&eacute;fini en milli&egrave;mes de seconde dans la colonne Ordonnancement.
Note : Vous ne pouvez pas modifier les param&egrave;tres de ce type d'ordonnancement en cours d'ex&eacute;cution. Si vous
devez modifier les param&egrave;tres de temps d'action en cours d'ex&eacute;cution, s&eacute;lectionnez Ordonnancement r&eacute;p&eacute;titif
et configurez le Type sur Toutes les. Voir &quot;Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives&quot; on the facing page pour
plus de d&eacute;tails.
210
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
21 Planificateur
Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives
L'ordonnancement des t&acirc;ches r&eacute;p&eacute;titives est utilis&eacute; pour ex&eacute;cuter des actions &agrave; des moments pr&eacute;cis. Les param&egrave;tres
peuvent &ecirc;tre modifi&eacute;s en cours d'ex&eacute;cution.
Param&egrave;tres du planificateur des t&acirc;ches r&eacute;p&eacute;titives
Param&egrave;tre
Description
Type
Fr&eacute;quence des actions planifi&eacute;es
Mode
Param&egrave;tres sp&eacute;cifiques demand&eacute;s par chaque type de planificateur
Condition
Une variable bool&eacute;enne (vrai/faux) pour activer les actions sp&eacute;cifi&eacute;es au moment o&ugrave; la minuterie se
d&eacute;clenche. Les actions seront ex&eacute;cut&eacute;es si la variable = vrai. Par d&eacute;faut, les actions sont ex&eacute;cut&eacute;es
lorsque la minuterie se d&eacute;clenche.
Note : Seules les variables associ&eacute;es au type de donn&eacute;es bool&eacute;ennes apparaissent.
Actions
Actions devant &ecirc;tre ex&eacute;cut&eacute;es par l'ordonnancement.
Important : Les actions et les param&egrave;tres d'ordonnancement ne peuvent pas &ecirc;tre
modifi&eacute;s pendant l'ex&eacute;cution
Date
Date &agrave; laquelle les actions planifi&eacute;es seront ex&eacute;cut&eacute;es
Heure/D&eacute;calage
Ce champ montre l'une des donn&eacute;es suivantes :
Heure = moment o&ugrave; les actions planifi&eacute;es seront ex&eacute;cut&eacute;es
D&eacute;calage = retard ou avance par rapport au mode s&eacute;lectionn&eacute;.
Emplacement
Lieu de r&eacute;f&eacute;rence pour calculer l'heure de lever/coucher du soleil.
jours de la
semaine
Jours de la semaine o&ugrave; les actions planifi&eacute;es seront ex&eacute;cut&eacute;es.
Au moment du
d&eacute;marrage
Ex&eacute;cute l'ordonnancement au d&eacute;marrage
Activer
Active/d&eacute;sactive l'ordonnancement
ordonnancement
Ex&eacute;cuter
seulement au
d&eacute;marrage
Ex&eacute;cute l'ordonnancement une fois seulement au d&eacute;marrage
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
211
Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives
Options du type d'ordonnancement
Option
Description
Par date
Les actions sont ex&eacute;cut&eacute;es &agrave; la date et &agrave; l'heure sp&eacute;cifi&eacute;s.
Journalier
Les actions sont ex&eacute;cut&eacute;es quotidiennement &agrave; l'heure sp&eacute;cifi&eacute;e.
Chaque
Les actions sont ex&eacute;cut&eacute;es selon l'intervalle sp&eacute;cifi&eacute; (Plage : 1 s-1 jour)
Horaire
Les actions sont ex&eacute;cut&eacute;es chaque heure, &agrave; la minute sp&eacute;cifi&eacute;e.
Mensuel
Les actions sont ex&eacute;cut&eacute;es chaque mois, &agrave; la date et &agrave; l'heure sp&eacute;cifi&eacute;s.
Hebdomadaire
Les actions sont ex&eacute;cut&eacute;es chaque semaine, au(x) jour(s) et heures sp&eacute;cifi&eacute;s.
Annuel
Les actions sont ex&eacute;cut&eacute;es chaque ann&eacute;e &agrave; la date et &agrave; l'heure sp&eacute;cifi&eacute;s.
Options du mode d'ordonnancement
Option
Description
Heure
D&eacute;pend du type d'ordonnancement. Permet de pr&eacute;ciser les informations sur la
date/heure/semaine.
Al&eacute;atoire10
Les actions sont ex&eacute;cut&eacute;es selon un intervalle de 10 minutes avant ou apr&egrave;s l'heure d&eacute;finie.
Si, par exemple, l'heure d&eacute;finie est 10:30, les actions pourront &ecirc;tre ex&eacute;cut&eacute;es &agrave; tout moment
entre 10:20 et 10:40.
Al&eacute;atoire20
Les actions sont ex&eacute;cut&eacute;es selon un intervalle de 20 minutes avant ou apr&egrave;s l'heure d&eacute;finie.
Si, par exemple, l'heure d&eacute;finie est 10:30, les actions pourront &ecirc;tre ex&eacute;cut&eacute;es &agrave; tout moment
entre 10:10 et 10:50.
Aurore+
Les actions sont ex&eacute;cut&eacute;es selon le d&eacute;lai sp&eacute;cifi&eacute; apr&egrave;s le lever du soleil. Ce d&eacute;lai s'exprime
en minutes/heures et l'heure de lever du soleil d&eacute;pend du lieu.
Aurore-
Les actions sont ex&eacute;cut&eacute;es selon le d&eacute;lai sp&eacute;cifi&eacute; avant le lever du soleil. Ce d&eacute;lai s'exprime
en minutes/heures et l'heure de lever du soleil d&eacute;pend du lieu.
Cr&eacute;puscule+ Les actions sont ex&eacute;cut&eacute;es selon le d&eacute;lai sp&eacute;cifi&eacute; apr&egrave;s le coucher du soleil. Ce d&eacute;lai
s'exprime en minutes/heures et l'heure de coucher du soleil d&eacute;pend du lieu.
Cr&eacute;puscule-
Les actions sont ex&eacute;cut&eacute;es selon le d&eacute;lai sp&eacute;cifi&eacute; avant le coucher du soleil. Ce d&eacute;lai
s'exprime en minutes/heures et l'heure de coucher du soleil d&eacute;pend du lieu.
Voir &quot;Configurer un emplacement pour les ordonnancements&quot; on the facing page pour plus de d&eacute;tails sur les param&egrave;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 | &copy; 2012-2017 DEIF A/S
21 Planificateur
Configurer un emplacement pour les ordonnancements
Les actions programm&eacute;es peuvent &ecirc;tre configur&eacute;es pour &ecirc;tre ex&eacute;cut&eacute;es &agrave; un moment donn&eacute; par rapport au lever et/ou au
coucher du soleil. Pour ce faire, vous devez d&eacute;finir la localisation correcte, selon les informations UTC. Le syst&egrave;me calcule
automatiquement l'heure du lever du soleil et du coucher du soleil.
Seules quelques localisations sont disponibles par d&eacute;faut. Si votre localisation n'est pas list&eacute;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&eacute;riph&eacute;riques IHM
DEIF\AGI Software Pack\runtime\&lt;HW Platform&gt;\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&eacute;rone (Italie) sont affich&eacute;es ci-dessous :
Les informations de localisation sont aussi affich&eacute;es dans la bo&icirc;te de dialogue, avec les heures de coucher et de lever du
soleil.
Configurer le widget planificateur
Pour afficher les donn&eacute;es du planificateur sur une page :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
213
Ordonnancement des &eacute;v&eacute;nements &agrave; l’ex&eacute;cution
1. Glissez-d&eacute;posez un widget Planificateur depuis la galerie des widgets dans la page.
2. Dans le volet Propri&eacute;t&eacute;s, cliquez sur + pour le param&egrave;tre Nom : la bo&icirc;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&eacute;t&eacute;s, personnalisez tous les param&egrave;tres.
Param&egrave;tres des planificateurs
Param&egrave;tre
Description
Nom
Ordonnancement &agrave; afficher
Colonnes
Colonnes &agrave; afficher et leurs caract&eacute;ristiques
Afficher en-t&ecirc;te
Affiche/masque les en-t&ecirc;tes des colonnes
Sp&eacute;c heure
Heure &agrave; afficher en cours d'ex&eacute;cution
Texte
Police utilis&eacute;e pour le texte
Affichage
Styles de tableaux
Ordonnancement des &eacute;v&eacute;nements &agrave; l’ex&eacute;cution
Au moment de l'ex&eacute;cution, vous pouvez modifier les param&egrave;tres d’ordonnancement suivants.
214
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
21 Planificateur
Param&egrave;tre
Description
Occurrence
Informations sur le type de programme et l'heure d'ex&eacute;cution
Condition
Condition appliqu&eacute;e &agrave; l'ex&eacute;cution de l'action
Activer
Active/d&eacute;sactive l'ex&eacute;cution des actions programm&eacute;es sans supprimer le calendrier.
Voir &quot;Ordonnancement des t&acirc;ches r&eacute;p&eacute;titives&quot; on page 211 pour plus de d&eacute;tails sur les param&egrave;tres de l’ordonnanceur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
215
Ordonnancement des &eacute;v&eacute;nements &agrave; l’ex&eacute;cution
216
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
22 Gestion et mots de passe
utilisateur
Vous pouvez restreindre l'acc&egrave;s &agrave; divers widgets et op&eacute;rations en configurant les utilisateurs, les groupes d'utilisateurs et
en attribuant des autorisations sp&eacute;cifiques &agrave; chaque groupe.
Chaque utilisateur doit &ecirc;tre membre d'un seul groupe. Chaque groupe dispose d'autorisations et de permissions
sp&eacute;cifiques.
Les autorisations et les permissions sont divis&eacute;es en deux cat&eacute;gories :
l
Permissions de widget : cache, lecture seule, acc&egrave;s total
l
Permissions d’action : autoris&eacute; ou non autoris&eacute;.
En organisant les permissions et les groupes, vous pouvez d&eacute;finir les options de s&eacute;curit&eacute; d’un projet.
Activer/d&eacute;sactiver la gestion de s&eacute;curit&eacute;
219
Configurer groupes et autorisations
219
Modifier permissions d’acc&egrave;s
220
Assigner des permissions par widget &agrave; partir du mode Page
225
Configurer utilisateurs
226
Utilisateur par d&eacute;faut
227
Gestion des utilisateurs &agrave; l'ex&eacute;cution
227
Imposer la connexion &agrave; distance
228
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
217
218
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Activer/d&eacute;sactiver la gestion de s&eacute;curit&eacute;
Chemin : VueProjet&gt; faites un clic droit sur S&eacute;curit&eacute;&gt; Activer
Le symbole du cadenas indique si la fonction est activ&eacute;e ou d&eacute;sactiv&eacute;e.
Important : Les param&egrave;tres de s&eacute;curit&eacute; fonctionnent uniquement si la fonction S&eacute;curit&eacute; est activ&eacute;e.
Configurer groupes et autorisations
Chemin : VueProjet&gt; S&eacute;curit&eacute; &gt; double-cliquez sur GroupesUtilisateurs
Trois groupes pr&eacute;d&eacute;finis sont disponibles par d&eacute;faut (administrateur, invit&eacute; et non autoris&eacute;) : ils ne peuvent pas &ecirc;tre
effac&eacute;s ou renomm&eacute;s. Cependant, vous pouvez modifier les autorisations et les autres param&egrave;tres.
Ajouter un groupe d'utilisateurs
Cliquez sur + pour ajouter un groupe d'utilisateurs.
Param&egrave;tre
Description
Nom
Nom du groupe d'utilisateurs
Autoris&eacute;
Autorisation accord&eacute;e
Page d'accueil
Page affich&eacute;e lorsque les utilisateurs appartenant &agrave; ce groupe se connectent
Utiliser la
derni&egrave;re page
visit&eacute;e
Lorsque ce param&egrave;tre est s&eacute;lectionn&eacute;, la derni&egrave;re page affich&eacute;e par l'utilisateur pr&eacute;c&eacute;dent s'affiche
lorsque les utilisateurs appartenant &agrave; ce groupe se connectent
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
219
Modifier permissions d’acc&egrave;s
Param&egrave;tre
Description
Commentaires
Tout commentaire ou toute description pour le groupe
Param&egrave;tres des
autorisations
Ouvre la bo&icirc;te de dialogue Autorisation Administrateur pour d&eacute;finir les permissions d'acc&egrave;s.
Voir &quot;Modifier permissions d’acc&egrave;s&quot; below pour plus de d&eacute;tails.
Modifier permissions d’acc&egrave;s
Chemin : Affichage du projet&gt; S&eacute;curit&eacute;&gt; double-cliquez sur Groupes d'utilisateurs &gt; colonne Param&eacute;trage
Autorisation
Cliquez sur le bouton : une bo&icirc;te de dialogue appara&icirc;t avec une liste de widgets et d'actions. Vous pouvez modifier les
permissions d'acc&egrave;s pour chaque &eacute;l&eacute;ment de la liste.
Permissions d'acc&egrave;s aux widgets
Dans l'onglet Widget, vous pouvez d&eacute;finir les options d'acc&egrave;s au widget au niveau du projet, de la page ou du widget, ce
pour l'ensemble des widgets utilis&eacute;s dans le projet. Les permissions des niveaux inf&eacute;rieurs (par exemple, au niveau du
widget) &eacute;crasent celles des niveaux sup&eacute;rieurs (c'est &agrave; dire, les niveaux de page et de projet).
Utilisez les Param&egrave;tres de base pour d&eacute;finir les permissions par d&eacute;faut au niveau du projet.
Les param&egrave;tres possible sont :
l
Acc&egrave;s complet pour autoriser l'acc&egrave;s au widget en mode lecture/&eacute;criture
l
Lecture seule pour n'autoriser l'acc&egrave;s au widget qu'en mode lecture
l
Masquer pour cacher le widget pour le groupe s&eacute;lectionn&eacute;
220
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Modifier une permission d'acc&egrave;s &agrave; un widget
Pour modifier une permission d'acc&egrave;s &agrave; un widget sp&eacute;cifique dans une page du projet, naviguez jusqu'&agrave; ce widget &agrave;
l'int&eacute;rieur de sa page sur le volet droit et personnalisez ses options d'acc&egrave;s. &Agrave; d&eacute;faut, tous les widgets comportent les
permissions d&eacute;finies au niveau du projet ou de la page.
Par exemple, si la permission de page pour un widget a &eacute;t&eacute; accord&eacute;e en mode Lecture Seule au niveau du projet,
l'ensemble des widgets de m&ecirc;me type comporteront une permission Lecture Seule. Lorsque vous s&eacute;lectionnez un widget
&agrave; l'int&eacute;rieur d'une page &agrave; partir de l'arborescence, la permission est configur&eacute;e sur Utiliser les param&egrave;tres de base. Vous
ne pouvez modifier ce param&egrave;tre et les permissions d'acc&egrave;s que pour ce widget et dans cette page.
Priorit&eacute; d'acc&egrave;s
Les permissions d'acc&egrave;s aux widgets suivent les priorit&eacute;s suivantes :
Niveau de permission
Priorit&eacute;
Niveau du projet - Param&egrave;tres de base
Faible
Niveau page
Moyenne
Niveau widget
&Eacute;lev&eacute;e
Cela vous permet de d&eacute;finir des exceptions pour une action ou un widget directement &agrave; partir de la page affich&eacute;e.
Par exemple, si vous accordez des permissions Lecture Seule pour un widget au niveau du projet et un Acc&egrave;s Complet au
niveau de la page, les param&egrave;tres du niveau page pr&eacute;vaudront.
Les permissions d'acc&egrave;s peuvent &ecirc;tre modifi&eacute;es directement &agrave; partir de la page de projet. Voir &quot;Assigner des permissions
par widget &agrave; partir du mode Page&quot; on page 225 pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
221
Modifier permissions d’acc&egrave;s
Permissions pour les actions
Dans Onglet Action, vous pouvez d&eacute;finir les autorisations concernant les actions au niveau du projet, de la page ou du
widget. Les actions peuvent &ecirc;tre Autoris&eacute;es ou Non Autoris&eacute;es.
Les permissions concernant les actions peuvent &ecirc;tre modifi&eacute;es directement &agrave; partir de la page de projet. Voir &quot;Assigner des
permissions par widget &agrave; partir du mode Page&quot; on page 225 pour plus de d&eacute;tails.
Autorisations FTP
Dans l'onglet Ftp vous pouvez d&eacute;finir des autorisations sp&eacute;cifiques pour le serveur FTP.
222
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
&Eacute;l&eacute;ment
Description
Autoriser Acc&egrave;s
FTP
Active la fonction FTP pour le groupe sp&eacute;cifique
Permission
Type de permission :
l
Read only
l
Lecture-&Eacute;criture
Dossier racine
Dossier &agrave; utiliser comme racine pour l'acc&egrave;s FTP. C'est un chemin relatif.
Dossier
suppl&eacute;mentaire
Dossiers suppl&eacute;mentaires &agrave; utiliser comme racine pour l'acc&egrave;s FTP (par exemple, sur une cl&eacute;
USB ou une carte SD)
Adresses IP
autoris&eacute;es
Liste des adresses IP &agrave; partir desquelles la connexion FTP peut &ecirc;tre accept&eacute;e.
Important : Ce param&egrave;tre est commun &agrave; tous les groupes d'utilisateurs.
Autorisations HTTP
Dans l'onglet HTTP, vous d&eacute;finissez des restrictions &agrave; l'acc&egrave;s HTTP au serveur web int&eacute;gr&eacute; dans HMI Runtime.
Les m&eacute;tacaract&egrave;res peuvent &ecirc;tre utilis&eacute;s pour identifier une plage d'adresses IP.
Par exemple, les deux r&egrave;gles suivantes d&eacute;finissent que l'unit&eacute; de p&eacute;riph&eacute;rique IHM ne peut &ecirc;tre accessible par toutes les
adresses IP 192.168.*.* sur votre r&eacute;seau local dans lequel seule l'adresse IP 192.168.1.20 peut acc&eacute;der au p&eacute;riph&eacute;rique
sans entrer un nom de connexion.
&Eacute;l&eacute;ment
Description
Liste IP
Adresses IP autoris&eacute;es &agrave; acc&eacute;der au serveur HTTP. Par d&eacute;faut, toutes.
Connexion
Lorsque d&eacute;sactiv&eacute;, le nom d'utilisateur et mot de passe ne sont pas n&eacute;cessaires.
Limites d'acc&egrave;s
Liste des ressources pour lesquelles l'acc&egrave;s est limit&eacute;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
223
Modifier permissions d’acc&egrave;s
L'effet de ces param&egrave;tres d&eacute;pend de si l'option Imposer l'identification &agrave; distance a &eacute;t&eacute; s&eacute;lectionn&eacute;e. Voir &quot;Imposer la
connexion &agrave; distance&quot; on page 228 pour plus de d&eacute;tails.
Forcer connexion &agrave;
distance
Acc&egrave;s par d&eacute;faut &agrave;
l'espace de travail
Limites d'acc&egrave;s
-
Complet
-
D&eacute;sactiver
Complet
Peut &ecirc;tre utilis&eacute; pour bloquer l'acc&egrave;s &agrave; certains fichiers/dossiers ou
pour demander l'autorisation
Activer
Pas d'acc&egrave;s
Peut &ecirc;tre utilis&eacute; pour ouvrir l'acc&egrave;s &agrave; des fichiers/dossiers
Important : Ce param&egrave;tre est commun &agrave; tous les groupes d'utilisateurs.
Ajout d'une configuration HTTP
Pour ajouter et configurer un nouvel acc&egrave;s, cliquez sur + : la bo&icirc;te de dialogue Limites d'acc&egrave;s s'affiche.
Pour restaurer la configuration par d&eacute;faut, cliquez sur l'ic&ocirc;ne Configurer les limites d'acc&egrave;s par d&eacute;faut. La configuration
par d&eacute;faut permet d'acc&eacute;der aux &eacute;l&eacute;ments suivants :
l
Dossier PUBLIC et Index.html
Param&egrave;tres divers
Dans l'onglet Divers, vous pouvez d&eacute;finir diff&eacute;rents param&egrave;tres d'autorisation.
Note : Certains de ces param&egrave;tres sont sp&eacute;cifiques &agrave; un groupe, d'autres sont communs pour tous les groupes.
224
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute; pour la
maintenance.
Gestion des autres
utilisateurs possible
Attribue des privil&egrave;ges de super-utilisateur dans le cadre de l'ex&eacute;cution pour g&eacute;rer les groupes
s&eacute;lectionn&eacute;s. Permet d'ajouter, supprimer et modifier les permissions des utilisateurs.
Chargement des
param&egrave;tres usine
possible
Restaure les param&egrave;tres d'usine.
Zoom autoris&eacute;
Permet de zoomer ou de d&eacute;zoomer dans le menu contextuel pendant l'ex&eacute;cution
Affichage des
journaux possible
Permet &agrave; l'utilisateur de consulter les journaux pendant l'ex&eacute;cution
Cr&eacute;ation de
Permet &agrave; l'utilisateur de sauvegarder un projet.
sauvegardes autoris&eacute;e
Nombre autoris&eacute;
d'utilisateurs
connect&eacute;s
Nombre maximum d'utilisateurs pouvant &ecirc;tre connect&eacute;s au runtime IHM au m&ecirc;me moment.
Par d&eacute;faut = 3.
Assigner des permissions par widget &agrave; partir du mode
Page
Vous pouvez assigner diff&eacute;rents niveaux de s&eacute;curit&eacute; pour un seul widget &agrave; diff&eacute;rents groupes d'utilisateurs, directement &agrave;
partir des pages du projet.
1. Faites un clic droit sur le widget et s&eacute;lectionnez Param&egrave;tres de s&eacute;curit&eacute;.
2. Choisissez le groupe : la bo&icirc;te de dialogue d'autorisation pour le groupe s'affiche.
3. D&eacute;finissez les propri&eacute;t&eacute;s de s&eacute;curit&eacute; pour acc&eacute;der au widget.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
225
Configurer utilisateurs
Voir &quot;Modifier permissions d’acc&egrave;s&quot; on page 220 pour plus de d&eacute;tails.
Configurer utilisateurs
Chemin : VueProjet&gt; S&eacute;curit&eacute; &gt; double-cliquez sur Utilisateurs
Dans l'&eacute;diteur Utilisateurs, cliquez sur + pour ajouter un utilisateur : une ligne est ajout&eacute;e au tableau.
226
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
22 Gestion et mots de passe utilisateur
Param&egrave;tre
Description
Nom
Identifiant
Utilisateur par d&eacute;faut
Cet utilisateur est automatiquement connect&eacute; au d&eacute;marrage du syst&egrave;me ou apr&egrave;s qu'un
autre utilisateur s'est d&eacute;connect&eacute;. Un seul Utilisateur par d&eacute;faut peut &ecirc;tre d&eacute;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&egrave;re connexion.
Commentaires
Description d&eacute;taill&eacute;e de l'utilisateur
Temps de d&eacute;connexion
Minutes d'inactivit&eacute; apr&egrave;s lesquelles l'utilisateur est d&eacute;connect&eacute;. D&eacute;finir &agrave; 0 pour
d&eacute;sactiver.
Nombre de caract&egrave;res
minimum du mot de
passe
Nombre de caract&egrave;res minimum du mot de passe
Doit contenir des
caract&egrave;res sp&eacute;ciaux
Le mot de passe doit contenir au moins un caract&egrave;re sp&eacute;cial.
Doit contenir des chiffres
Le mot de passe doit contenir au moins un chiffre.
Utilisateur par d&eacute;faut
Vous ne pouvez d&eacute;finir qu'un utilisateur par d&eacute;faut dans un projet. Il s'agit de l'utilisateur connect&eacute; automatiquement au
d&eacute;marrage du syst&egrave;me et lorsque l'utilisateur actuellement connect&eacute; se d&eacute;connecte ou est d&eacute;connect&eacute; apr&egrave;s un d&eacute;lai
d'attente.
Pour se connecter &agrave; HMI Runtime avec un utilisateur diff&eacute;rent, utilisez une de ces actions :
l
ChangerUtilisateur
l
D&eacute;connexion
Voir &quot;Actions de gestion des utilisateurs&quot; on page 135pour plus de d&eacute;tails.
Gestion des utilisateurs &agrave; l'ex&eacute;cution
L'utilisateur par d&eacute;faut est, le cas &eacute;ch&eacute;ant, automatiquement connect&eacute; au d&eacute;marrage du runtime IHM. Si aucun utilisateur
par d&eacute;faut n'a &eacute;t&eacute; configur&eacute;, le syst&egrave;me demande un identifiant et un mot de passe. Voir &quot;Actions de gestion des
utilisateurs&quot; on page 135pour plus de d&eacute;tails sur les actions pouvant &ecirc;tres ex&eacute;cut&eacute;es sur les utilisateurs.
Supprimer les donn&eacute;es d'utilisateur
Toutes les informations d'utilisateur modifi&eacute;es &agrave; l'ex&eacute;cution sont stock&eacute;es dans des fichiers d&eacute;di&eacute;s. Pour supprimer ces
fichiers dynamiques ainsi que l'ensemble des modifications apport&eacute;es &agrave; la configuration de l'utilisateur pendant l'ex&eacute;cution,
vous pouvez :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
227
Imposer la connexion &agrave; distance
l
l
sur le runtime IHM : ex&eacute;cuter l'action SuppressionFichiersDynamiquesUM
avec AGI Creator: s&eacute;lectionner Suppression des fichiers dynamiques dans la bo&icirc;te de dialogue de
t&eacute;l&eacute;chargement.
Imposer la connexion &agrave; distance
Chemin : Affichage du projet&gt; cliquez avec le bouton droit sur S&eacute;curit&eacute;&gt; Imposer l'identification &agrave; distance
S&eacute;lectionnez cette option pour forcer l'utilisateur &agrave; se connecter lorsqu'il utilise l'acc&egrave;s &agrave; distance via AGI Client. Si vous
ne la s&eacute;lectionnez pas, l'acc&egrave;s &agrave; distance utilisera le m&ecirc;me niveau de protection que l'acc&egrave;s local.
Important : Cette fonction ne fonctionne que quand la gestion utilisateur est d&eacute;sactiv&eacute;e.
Astuce : Utilisez cette option lorsque vous avez un utilisateur par d&eacute;faut mais que vous souhaitez s&eacute;curiser
l'acc&egrave;s &agrave; distance.
Voir &quot;Activer/d&eacute;sactiver la gestion de s&eacute;curit&eacute;&quot; on page 219pour plus de d&eacute;tails.
Les seuls fichiers/dossiers encore accessibles lorsque ce drapeau est activ&eacute; sont :
l
Dossier PUBLIC et Index.html.
Voir &quot;Modifier permissions d’acc&egrave;s&quot; on page 220 pour plus de d&eacute;tails sur les limites d'acc&egrave;s HTTP.
228
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
23
Journaux d’audit
Le journal d’audit est une s&eacute;quence chronologique d'entr&eacute;es d'audit. Chaque entr&eacute;e contient des informations sur les
actions ex&eacute;cut&eacute;es et sur l'utilisateur qui les a r&eacute;alis&eacute;es.
Cette fonction fournit le suivi du processus, l'identification de l'utilisateur et l'horodatage des &eacute;v&eacute;nements.
Si la Gestion des utilisateurs est activ&eacute;e, les actions sont trac&eacute;es ensemble avec le m&ecirc;me nom d'utilisateur. Seul
l'administrateur peut modifier ce param&egrave;tre.
Activer/d&eacute;sactiver le journal d’audit
230
Configurer les &eacute;v&eacute;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&eacute;tails de connexion/d&eacute;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 | &copy; 2012-2017 DEIF A/S
229
Activer/d&eacute;sactiver le journal d’audit
Activer/d&eacute;sactiver le journal d’audit
Chemin : VueProjet&gt; faites un clic droit sur Journal d’audit&gt; Activer
Le symbole du cadenas indique l'&eacute;tat de la fonction.
Configurer les &eacute;v&eacute;nements d'audit
Vous avez plus d'un ensemble d'entr&eacute;es d'audit. Vous devez configurer une m&eacute;moire d'&eacute;v&eacute;nements d&eacute;di&eacute;e.
Cr&eacute;er une m&eacute;moire d'&eacute;v&eacute;nements
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur M&eacute;moire d'&eacute;v&eacute;nements
230
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
23 Journaux d’audit
1. Dans l'&eacute;diteur M&eacute;moire d'&eacute;v&eacute;nements, cliquez sur + : une ligne s'ajoute au tableau.
2. S&eacute;lectionnez Audit pour Type.
3. Configurez les param&egrave;tres de m&eacute;moire tampon.
Param&egrave;tre
Description
ID
Num&eacute;ro d'identification m&eacute;moire tampon
Nom
Nom de m&eacute;moire tampon
Activer
Activer/d&eacute;sactiver l'enregistrement
Taille
Taille du fichier journal. Les donn&eacute;es sont automatiquement sauvegard&eacute;es sur un disque
toutes les 5 minutes.
Type
Type d'&eacute;v&eacute;nements enregistr&eacute;s :
P&eacute;riph&eacute;rique de
stockage
l
Alarmes
l
Audit
l
G&eacute;n&eacute;rique
P&eacute;riph&eacute;rique o&ugrave; les donn&eacute;es d'audit sont stock&eacute;es
Configurer les variables pour le journal d’audit
Chemin : VueProjet&gt; Journal d’audit&gt; cliquez sur Journal d'audit
Suivez uniquement les variables li&eacute;es aux actions que vous voulez garder sous contr&ocirc;le. Pour les variables suivies, toutes
les op&eacute;rations d'&eacute;criture seront enregistr&eacute;es avec l'horodatage et l'utilisateur qui a r&eacute;alis&eacute; l'op&eacute;ration.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
231
Configurer les alarmes pour le journal d’audit
Configurer les alarmes pour le journal d’audit
Chemin : VueProjet&gt; Journal d’audit&gt; cliquez sur Journal d'audit
Vous pouvez sp&eacute;cifier quelles alarmes doivent &ecirc;tre suivies par le journal d’audit.
1. Dans l'&eacute;diteur Journal d’audit, s&eacute;lectionnez l'onglet Alarmes.
2. S&eacute;lectionnez toutes les alarmes &agrave; connecter au journal d’audit : toutes les op&eacute;rations r&eacute;alis&eacute;es sur les alarmes
sp&eacute;cifi&eacute;es seront connect&eacute;es.
Configurer les recettes pour le journal d’audit
Chemin : VueProjet&gt; Journal d’audit&gt; cliquez sur Journal d'audit
Suivez uniquement les recettes li&eacute;es aux actions que vous voulez garder sous contr&ocirc;le. Pour les recettes suivies, toutes
les op&eacute;rations de transfert seront enregistr&eacute;es avec l'horodatage et l'utilisateur qui a r&eacute;alis&eacute; l'op&eacute;ration.
232
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
23 Journaux d’audit
Configurer les d&eacute;tails de connexion/d&eacute;connexion
Chemin : VueProjet&gt; Journal d’audit&gt; cliquez sur Journal d'audit
Le journal d’audit peut tracer des informations sur les &eacute;v&eacute;nements de connexion et de d&eacute;connexion de l'utilisateur.
1. Dans l'&eacute;diteur Journal d’audit, s&eacute;lectionnez l'onglet Divers.
2. S&eacute;lectionnez les informations que vous voulez enregistrer.
3. Si vous cr&eacute;ez d'autres m&eacute;moires d'&eacute;v&eacute;nements de type Audit, vous pouvez les choisir depuis la liste d&eacute;roulante
M&eacute;moire d'&eacute;v&eacute;nements ou vous pouvez laisser la valeur Journal d’audit qui utilise la m&eacute;moire tampon par d&eacute;faut.
Exporter le journal d’audit au format .csv
Pour afficher les donn&eacute;es du journal d’audit, vous devez les exporter au format .csv avec l'action
ViderArchive&Eacute;v&eacute;nement. Voir &quot;Actions syst&egrave;me&quot; on page 123 pour plus de d&eacute;tails.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
233
Afficher les journaux d’audit
Structure du fichier
Le fichier des donn&eacute;es export&eacute;es contient les &eacute;l&eacute;ments suivants :
Type
d'&eacute;v&eacute;nement
Pour utilisation interne
Sous-type
Horodatage
Horodatage d’&eacute;v&eacute;nement. L'heure peut &ecirc;tre configur&eacute;e comme heure locale ou globale pour l'action
de vidage.
Interface
LOCALE, lorsque l'action est r&eacute;alis&eacute;e en HMI Runtime.
CGI, lorsque l'action est r&eacute;alis&eacute;e par un client &agrave; distance.
Action
Action ex&eacute;cut&eacute;e.
Informations
&Eacute;tat de l'action et op&eacute;ration ex&eacute;cut&eacute;e. Par exemple, &eacute;crivez variable - variable1:50
Afficher les journaux d’audit
Les donn&eacute;es de journal d'audit doivent &ecirc;tre export&eacute;es comme un fichier de donn&eacute;es pour affichage.
Voir &quot;Exporter le journal d’audit au format .csv&quot; on the previous page pour plus de d&eacute;tails.
234
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
24
Rapports
Un rapport est une collection d'informations dont l'impression est d&eacute;clench&eacute;e par un &eacute;v&eacute;nement. Lorsqu'un &eacute;v&eacute;nement
programm&eacute; se produit, l'impression se d&eacute;clenche en arri&egrave;re-plan.
Vous pouvez configurez les rapports, leurs contenus, les conditions de d&eacute;clenchement et l'imprimante de sortie dans
l'&eacute;diteur de rapport.
Tous les widgets ne peuvent pas &ecirc;tre utilis&eacute;s dans les rapports. Lorsque vous configurez vos rapports, AGI Creatorfournit
l'acc&egrave;s &agrave; une galerie de widgets sp&eacute;cifique o&ugrave; n'apparaissent que les widgets disponibles pour les rapports.
Le format des rapports peut &ecirc;tre personnalis&eacute; &agrave; l'aide de mod&egrave;les de mise en page pr&eacute;d&eacute;finis.
Note : L'impression des rapports n'est pas support&eacute;e par AGI Client.
Ajouter un rapport
236
Configurer les rapports de texte
236
Configurer les rapports graphiques
237
&Eacute;v&eacute;nements d&eacute;clencheurs d'impression
238
Imprimante par d&eacute;faut
239
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
235
Ajouter un rapport
Ajouter un rapport
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Rapports
Dans l’&eacute;diteur des Rapports, cliquez sur RApport graphique ou Rapport texte : une nouvelle ligne est ajout&eacute;e au
tableau.
Types de rapport
Type de
rapport
Description
Rapports
texte
Utilis&eacute;s pour l'impression ligne par ligne d'alarmes.
Utilis&eacute;s uniquement pour des imprimantes par ligne.
Le texte est envoy&eacute; &agrave; l'imprimante sans pilote sp&eacute;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 &eacute;l&eacute;ments graphiques et peuvent inclure des widgets complexes tels que des captures
graphiques d'&eacute;cran ou des alarmes.
Important : Chaque imprimante requiert un pilote d'imprimante sp&eacute;cifique. Voir
&quot;Configurer les rapports graphiques&quot; on the facing page pour consulter la liste des
pilotes d'imprimante pris en charge.
Configurer les rapports de texte
Utilisez l'&eacute;diteur de Rapports. Taille du papier en nombre de caract&egrave;res.
R&eacute;glage des options d’impression
Utiliser les options de l'imprimante pour contr&ocirc;ler affleurement de pages sur l'imprimante.
L'impression commence imm&eacute;diatement ou apr&egrave;s un d&eacute;lai d'attente. Dans les options d'impression, vous pouvez forcer
l'affleurement d&egrave;s qu'une condition sp&eacute;cifique se produit, apr&egrave;s un certain nombre d'&eacute;v&eacute;nements, de lignes ou de
secondes.
Note : Les rapports de texte ne prennent pas en charge le format PDF.
R&eacute;glage de la mise en page des alarmes
La Taille du papier est la largeur du papier en nombre de caract&egrave;res.
Ajout de champs au rapport
Pour ajouter un &eacute;l&eacute;ment au rapport, faites-le glisser et d&eacute;posez-le sur la page de mod&egrave;le dans la liste des Champs
disponibles.
236
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
24 Rapports
Recadrage du champ &agrave; l'aide de la souris, un outil de pointe montre la dimension en nombre de caract&egrave;res.
Note : Si le texte ne tient pas dans l'espace d&eacute;di&eacute;, l'enveloppe automatique est appliqu&eacute;e.
Configurer les rapports graphiques
Utilisez l'&eacute;diteur de Rapport pour configurer les rapports graphiques.
Ajouter une page de rapport
Cliquez sur + pour ajouter une nouvelle page au mod&egrave;le de rapport.
Quand la souris va sur une page, deux ic&ocirc;nes s'affichent et permettent de r&eacute;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'&eacute;diteur de Rapport graphique appara&icirc;t.
Chaque page se subdivise en : en-t&ecirc;te, pied de page et corps de la page.
2. Double-cliquez sur la zone que vous souhaitez modifier : la zone &agrave; modifier appara&icirc;t en blanc, tandis que les autres
sont gris&eacute;es.
La Galerie des widgets est sensible au contexte et n'affiche que les widgets disponibles pour la zone que vous &ecirc;tes en train
de modifier.
Widgets disponibles pour les rapports
Widgets pouvant &ecirc;tre utilis&eacute;s pour un rapport graphique :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
237
&Eacute;v&eacute;nements d&eacute;clencheurs d'impression
Widget
Fonction
Num&eacute;ro
de page
Num&eacute;rotation de page automatique
Capture
d'&eacute;cran
Capture d'&eacute;cran de la page actuellement affich&eacute;e sur le p&eacute;riph&eacute;rique IHM. La page de rapport est
automatiquement redimensionn&eacute;e pour s'adapter &agrave; la page du p&eacute;riph&eacute;rique IHM.
Note : L'int&eacute;gralit&eacute; de l'&eacute;cran est imprim&eacute;e, y compris les bo&icirc;tes de dialogue ouvertes.
Alarme
La totalit&eacute; du contenu de la m&eacute;moire d'&eacute;v&eacute;nements (la m&eacute;moire tampon par d&eacute;faut est Alarm Buffer1).
Texte
Les widgets tels que les labels et les champs num&eacute;riques
&Eacute;v&eacute;nements d&eacute;clencheurs d'impression
L'impression des rapports peut &ecirc;tre d&eacute;clench&eacute;e par des &eacute;v&eacute;nements.
Configurer l'impression d'alarme
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur Alarmes
1. Dans l'&Eacute;diteur d'alarme, ouvrez la bo&icirc;te de dialogue Types d'&eacute;v&eacute;nements &agrave; partir de la colonne &Eacute;v&eacute;nements.
2. Dans l'onglet Impression, s&eacute;lectionnez toutes les conditions dont vous souhaiteriez qu'elles d&eacute;clenchent une
impression.
Important : Il n'est possible de d&eacute;finir qu'un seul rapport en tant que Rapport d'alarme active au sein
d'un projet et ce rapport peut se pr&eacute;senter sous forme de texte ou de graphique.
238
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
24 Rapports
Ajustement des param&egrave;tres de l'imprimante pendant l'ex&eacute;cution
L'impression d'un rapport graphique peut &eacute;galement &ecirc;tre lanc&eacute;e en utilisant l'action PrintGraphicReport.
Configurez la propri&eacute;t&eacute; silencieux de l'action sur faux pour faire appara&icirc;tre la bo&icirc;te de dialogue.
Imprimante par d&eacute;faut
Param&egrave;tres de l'imprimante
Vous pouvez d&eacute;finir une imprimante par d&eacute;faut pour tous les rapports graphiques. Chaque rapport peut ensuite &ecirc;tre
configur&eacute; pour utiliser l'imprimante par d&eacute;faut ou toute autre imprimante disponible. Cliquez sur le bouton Param&egrave;tres de
l'imprimante pour d&eacute;finir les param&egrave;tres de l'imprimante.
Pour les imprimantes PDF, vous d&eacute;finissez aussi le dossier de sauvegarde des fichiers avec Emplacement des fichiers
imprim&eacute;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 | &copy; 2012-2017 DEIF A/S
239
Imprimante par d&eacute;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&eacute;faut sont prises en charge.
L'imprimante par d&eacute;faut est l'imprimante par d&eacute;faut du syst&egrave;me d'exploitation. Elle peut &ecirc;tre connect&eacute;e avec tout
type de port (pas uniquement USB).
Imprimantes test&eacute;es
Les imprimantes suivantes ont &eacute;t&eacute; test&eacute;es avec les pilotes printCE sur les p&eacute;riph&eacute;riques IHM sous Windows CE.
Pilote
Mod&egrave;le de l'imprimante
Graphique Ligne
Personnalis&eacute; 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 | &copy; 2012-2017 DEIF A/S
24 Rapports
Pilote
Mod&egrave;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&eacute;riph&eacute;rique IHM se bloque lorsque vous
essayez d'imprimer avec les imprimantes Intermec PB50
en mode veille apr&egrave;s une premi&egrave;re impression r&eacute;ussie.
PDF
-
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
241
Imprimante par d&eacute;faut
242
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
25
&Eacute;cran de veille
L'&eacute;cran de veille peut &ecirc;tre utilis&eacute; pour afficher un diaporama lorsque le p&eacute;riph&eacute;rique IHM n’est pas utilis&eacute;. Le diaporama
commence apr&egrave;s un d&eacute;lai d'attente si aucun des &eacute;v&eacute;nements suivants se produit :
l
&eacute;cran touch&eacute;
l
d&eacute;placement de la souris
l
touche du clavier externe appuy&eacute;e
Activation de la fonction d’&eacute;cran de veille
Chemin : VueProjet&gt; Config &gt; clic droit sur &Eacute;cran de veille&gt; Activ&eacute;
Important : Vous devez activer l'&eacute;conomiseur d'&eacute;cran avant de pouvoir le configurer.
Configuration d’un &eacute;cran de veille
Chemin : VueProjet&gt; Configuration &gt; double-clic sur &Eacute;cran de veille
Param&egrave;tres du diaporama.
Param&egrave;tre
Description
D&eacute;lai
d'attente
Temps apr&egrave;s lequel le diaporama d&eacute;marre.
Intervalle
Intervalle entre les diapos
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
243
Param&egrave;tre
Description
entre les
diapos
P&eacute;riph&eacute;rique
de stockage
Emplacement des images utilis&eacute;es dans le diaporama.
Les images stock&eacute;es localement sont enregistr&eacute;es dans workspace\projectname\screensaver et
peuvent &ecirc;tre t&eacute;l&eacute;charg&eacute;es sur le p&eacute;riph&eacute;rique IHM lorsque les projet est t&eacute;l&eacute;charg&eacute;.
Les images stock&eacute;es sur les p&eacute;riph&eacute;riques USB ou SD sont enregistr&eacute;es dans un dossier d'&eacute;cran de
veille sur le p&eacute;riph&eacute;rique m&ecirc;me.
Important : Seules les images JPEG et PNG sont prises en charge.
Association d’actions &agrave; l'&eacute;cran de veille
Les actions peuvent &ecirc;tre d&eacute;clench&eacute;es par le d&eacute;but et/ou l’arr&ecirc;t de l'&eacute;cran de veille.
l
l
Cliquez sur + &agrave; c&ocirc;t&eacute; d'Actions dans l'onglet onStart pour configurer les actions &agrave; ex&eacute;cuter lorsque l'&eacute;cran de veille
d&eacute;marre.
Cliquez sur + &agrave; c&ocirc;t&eacute; d'Actions dans l'onglet onStop pour configurer les actions &agrave; ex&eacute;cuter lorsque l'&eacute;cran de veille
s’arr&ecirc;te.
244
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
26 Sauvegarder/restaurer le runtime
et le projet
Vous pouvez sauvegarder tout le contenu du p&eacute;riph&eacute;rique IHM, dont HMI Runtime et le projet, sur une m&eacute;moire externe.
Cette copie de sauvegarde peut &ecirc;tre utilis&eacute;e pour restaurer le contenu du p&eacute;riph&eacute;rique IHM par la suite ou pour le copier
dans un nouveau p&eacute;riph&eacute;rique IHM.
Cette fonction de sauvegarde est uniquement disponible lorsqu'elle est activ&eacute;e pour l'utilisateur connect&eacute;. Voir &quot;Modifier
permissions d’acc&egrave;s&quot; on page 220 pour plus de d&eacute;tails.
Note : La sauvegarde n’est pas support&eacute;e dans Win32 / AGI Client.
Fonction de sauvegarde
La fonction de sauvegarde r&eacute;alise automatiquement la proc&eacute;dure suivante :
1. D&eacute;charge le projet en cours pour d&eacute;verrouiller les fichiers utilis&eacute;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&eacute;).
3. Recharge le projet.
Pour d&eacute;marrer la proc&eacute;dure de sauvegarde :
1. Dans HMI Runtime, faites un clic droit pour ouvrir le menu contextuel.
2. S&eacute;lectionnez Sauvegarde : la bo&icirc;te de dialogue Sauvegarde s'affiche.
3. S&eacute;lectionnez le chemin de stockage du fichier de sauvegarde.
Note : Le processus de sauvegarde n'inclut pas les fichiers stock&eacute;s dans des cl&eacute;s USB et dans des cartes SD.
Les donn&eacute;es dynamiques telles que les recettes, les tendances ou les &eacute;v&eacute;nements stock&eacute;s dans ces
p&eacute;riph&eacute;riques ne seront pas incluses dans la sauvegarde.
Fonction restauration
La restauration du paquet de sauvegarde peut &ecirc;tre effectu&eacute; sur p&eacute;riph&eacute;rique IHM
l
depuis le Menu Contextuel (voir &quot;Paquet de mise &agrave; jour&quot; on page 81 pour obtenir plus de d&eacute;tails)
l
ou depuis les Param&egrave;tres du Syst&egrave;me (voir &quot;Param&egrave;tres du syst&egrave;me&quot; on page 369 pour obtenir plus de d&eacute;tails)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
245
246
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
27
Claviers
De nombreux claviers sont fournis par d&eacute;faut dans le AGI Creator et peuvent &ecirc;tre utilis&eacute;s pour la saisie de donn&eacute;es.
Le clavier alphab&eacute;tique peut &ecirc;tre associ&eacute; &agrave; une utilisation avec un type de donn&eacute;es cha&icirc;ne
Le clavier num&eacute;rique peut &ecirc;tre associ&eacute; &agrave; une utilisation avec un type de donn&eacute;es num&eacute;rique
Le clavier calendrier peut &ecirc;tre associ&eacute; &agrave; une utilisation avec un type de donn&eacute;es de date
Cr&eacute;er et utiliser des claviers personnalis&eacute;s
249
Supprimer ou renommer des claviers personnalis&eacute;s
251
Type de clavier
251
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
247
Emplacement du clavier
248
252
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
27 Claviers
Cr&eacute;er et utiliser des claviers personnalis&eacute;s
Vous pouvez soit cr&eacute;er un nouveau clavier soit personnaliser un clavier existant.
Cr&eacute;er un clavier
1. Dans VueProjet, faites un clic droit sur Claviers et s&eacute;lectionnez Ins&eacute;rer clavier : la bo&icirc;te de dialogue Nouveau
clavier s'affiche.
2. S&eacute;lectionnez un des claviers disponible ou Vierge pour cr&eacute;er un clavier de A &agrave; Z. Le cas &eacute;ch&eacute;ant, un clavier vierge
est affich&eacute;.
3. Utilisez Widgets clavier et Boutons clavier de la galerie des widgets pour cr&eacute;er votre clavier personnalis&eacute;.
Comme dans cet exemple, le clavier que vous cr&eacute;ez est sauvegard&eacute; dans le dossier du projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
249
Cr&eacute;er et utiliser des claviers personnalis&eacute;s
Associer des claviers personnalis&eacute;s &agrave; des champs
Les claviers personnalis&eacute;s peuvent &ecirc;tre r&eacute;utilis&eacute;s pour tout champ o&ugrave; la propri&eacute;t&eacute; Clavier pointe dessus, comme dans
l'exemple.
Astuces avec les claviers personnalis&eacute;s
Par d&eacute;faut, le clavier num&eacute;rique est assign&eacute; &agrave; tous les widgets num&eacute;riques (&eacute;crire/lire un champ num&eacute;rique).
Si vous voulez appliquer une version personnalis&eacute;e du clavier num&eacute;rique &agrave; tous les widgets num&eacute;riques que vous ajoutez &agrave;
votre projet, proc&eacute;dez de la fa&ccedil;on suivante :
1. Cr&eacute;ez un nouveau clavier et s&eacute;lectionnez Num&eacute;rique comme type de Clavier. C'est une sauvegarde des
param&egrave;tres d'origine pour le clavier num&eacute;rique.
2. Personnalisez le clavier num&eacute;rique par d&eacute;faut et enregistrez-le. Cette version personnalis&eacute;e du clavier num&eacute;rique
est assign&eacute;e par d&eacute;faut dans le projet.
Voir &quot;Supprimer ou renommer des claviers personnalis&eacute;s&quot; on the facing page pour des d&eacute;tails sur la fa&ccedil;on de renommer un
clavier personnalis&eacute;.
Fl&egrave;ches haut-bas du clavier
Ce type de clavier est particuli&egrave;rement utile pour d&eacute;placer le curseur de haut en bas dans un widget qui requiert cette
fonctionnalit&eacute;. Voici un exemple avec le widget Liste de contr&ocirc;le. Voir &quot;Widgets de liste de contr&ocirc;le&quot; on page 282 pour
plus de d&eacute;tails.
250
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
27 Claviers
Supprimer ou renommer des claviers personnalis&eacute;s
Dans VueProjet, faites un clic droit sur un clavier personnalis&eacute; et s&eacute;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&gt; Claviers &gt; double-cliquez sur un clavier &gt; Propri&eacute;t&eacute;s
Configurez le param&egrave;tre Type de clavier pour un clavier afin de d&eacute;finir le type de saisie de donn&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
251
Emplacement du clavier
Type de
clavier
Description
Auto
Param&egrave;tres par d&eacute;faut
D&eacute;cimal
Seuls les touches num&eacute;riques sont accept&eacute;es. En entrant 10, le clavier retourne 10, qui
s'affichera comme &laquo; 10 &raquo; si le champ associ&eacute; est num&eacute;rique ou ASCII, comme 'A' si le
fichier associ&eacute; est hexad&eacute;cimal.
Hexad&eacute;cimal Seules les touches hexad&eacute;cimales sont accept&eacute;es. En entrant 10, le clavier retourne 16, qui
s'affichera comme &laquo; 16 &raquo; si le champ associ&eacute; est num&eacute;rique ou ASCII, comme &laquo; 10 &raquo; si le
champ associ&eacute; est hexad&eacute;cimal.
Ascii
Toutes les touches sont accept&eacute;es. En entrant 1A, le clavier retourne 1A, qui s'affichera
comme &laquo; 1 &raquo; si le champ associ&eacute; est num&eacute;rique,comme &laquo; 1A &raquo; si le champ associ&eacute; est
ASCII ou hexad&eacute;cimal.
Emplacement du clavier
La propri&eacute;t&eacute; Emplacement de runtime des claviers peut &ecirc;tre utilis&eacute;e pour d&eacute;finir l'emplacement des claviers sur l'&eacute;cran.
Option
Description
Automatique
S&eacute;lection du meilleur emplacement en fonction de l'endroit o&ugrave; la saisie de donn&eacute;es est
requise.
Absolu
Des coordonn&eacute;es X,Y sont renseign&eacute;es pour d&eacute;finir l'emplacement exact
Gauche-haut
Emplacements &eacute;cran pr&eacute;d&eacute;finis
Gauchecentre
Gauche-bas
Centre-haut
Centre-centre
Centre-bas
Droite-haut
Droite-centre
Droite-bas
S&eacute;lectionnez l'option Verrouiller l'emplacement du clavier pour emp&ecirc;cher le d&eacute;placement du clavier par glissement.
252
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
28
Claviers externes
HMI Runtime a &eacute;t&eacute; con&ccedil;u pour fonctionner avec des claviers externes connect&eacute;s via USB.
Les claviers peuvent &ecirc;tre utilis&eacute;s pour :
l
l'entr&eacute;e de donn&eacute;es (par d&eacute;faut)
l
l'ex&eacute;cution d'actions associ&eacute;es &agrave; des touches sp&eacute;cifiques
Par exemple, l'&eacute;v&eacute;nement OnClick sur la fl&egrave;che droite peut &ecirc;tre associ&eacute; &agrave; l'action LoadPage.
Le clavier peut &ecirc;tre programm&eacute; au niveau du projet pour que les param&egrave;tres soient h&eacute;rit&eacute;s par toutes les pages. Dans
chaque page, vous pouvez ensuite choisir quel param&egrave;tre de touche est h&eacute;rit&eacute; depuis le projet et quel param&egrave;tre est
personnalis&eacute; pour la page sp&eacute;cifique.
Ouvrir des claviers externes
1. Sur l'&eacute;diteur de page, cliquez sur l'ic&ocirc;ne &agrave; droite de Clavier/Script, en bas de l'espace de travail : l'&eacute;diteur
Clavier/Script s'affiche.
2. S&eacute;lectionnez l'onglet Clavier.
Chaque ligne dans l'&eacute;diteur de clavier correspond &agrave; une touche.
Pour chaque touche, les informations suivantes sont affich&eacute;es :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
253
&Eacute;l&eacute;ment
Description
Label
Nom de la touche
Code
Code de la touche
Activer
&Eacute;tat d'activation de la touche
H&eacute;rite des actions du projet
D&eacute;finit si la touche h&eacute;rite de l'action programm&eacute;e au niveau du projet
Voici les configurations possibles :
H&eacute;rite
des
Activer
actions
du projet
Comportement HMI
Runtime
Apparence d'&eacute;diteur
V&eacute;rifi&eacute;
Non
v&eacute;rifi&eacute;
Les listes d'action affichent les actions de page (ou rien si la
liste est vide)
Seules les actions de
page (le cas &eacute;ch&eacute;ant)
sont ex&eacute;cut&eacute;es.
V&eacute;rifi&eacute;
V&eacute;rifi&eacute;
Les listes d'action affichent uniquement les actions du projet Seules les actions de
et ne peuvent pas &ecirc;tre &eacute;dit&eacute;es
page (le cas &eacute;ch&eacute;ant)
sont ex&eacute;cut&eacute;es.
Non
v&eacute;rifi&eacute;
V&eacute;rifi&eacute;
H&eacute;rite de la case &agrave; cocher des actions de projet et toutes les Aucune action de page
listes d'action sont d&eacute;sactiv&eacute;es. Les listes d'action affichent ou de projet n'est
uniquement les actions du projet.
ex&eacute;cut&eacute;e.
Non
v&eacute;rifi&eacute;
Non
v&eacute;rifi&eacute;
H&eacute;rite de la case &agrave; cocher des actions de projet et toutes les Aucune action de page
listes d'action sont d&eacute;sactiv&eacute;es. Les listes d'action affichent ou de projet n'est
uniquement les actions du projet.
ex&eacute;cut&eacute;e.
Rechercher et filtrer
255
Touches affich&eacute;es
255
Retirer des associations d'actions
255
Mise en page du clavier
256
Activer/d&eacute;sactiver clavier
256
Associer des actions &agrave; des touches
256
254
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
28 Claviers externes
Rechercher et filtrer
Pour afficher un ensemble filtr&eacute; de touches, dans Filtrer par s&eacute;lectionner le nom cl&eacute; et tapez une lettre dans le champ de
recherche : seules les touches contenant cette lettre dans leur nom seront affich&eacute;s dans l'&eacute;diteur du clavier.
Comme alternative, dans Filtrer par s&eacute;lectionner le code cl&eacute; et tapez une lettre dans le champ de recherche : seules les
cl&eacute;s contenant cette lettre dans leur code seront affich&eacute;s dans l'&eacute;diteur du clavier.
Touches affich&eacute;es
Vous pouvez facilement s&eacute;lectionner quelles cl&eacute;s seront r&eacute;pertori&eacute;es dans la fen&ecirc;tre de l'&eacute;diteur de Clavier. Pour afficher
un ensemble limit&eacute; de touches, s&eacute;lectionnez une option dans Affichage.
Option
Description
toutes les touches
Toutes les touches disponibles dans la configuration du clavier sont
r&eacute;pertori&eacute;es
touches modifi&eacute;es
Seules les touches associ&eacute;es aux actions au niveau de la page sont
r&eacute;pertori&eacute;s
touches modifi&eacute;es dans le
projet
Seules les touches associ&eacute;es aux actions au niveau du projet sont
r&eacute;pertori&eacute;es
Retirer des associations d'actions
Pour retirer toutes les associations que vous avez cr&eacute;&eacute;es entre des touches et des actions :
1. S&eacute;lectionnez les touches desquelles vous voulez retirer l'association.
2. Cliquez sur le bouton Effacer toutes les actions des touches s&eacute;lectionn&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;es. Si vous travaillez au niveau d'un projet, les
actions du projet seront retir&eacute;es.
Mise en page du clavier
S&eacute;lectionnez la disposition de clavier &agrave; partir de la liste d&eacute;roulante Disposition du clavier. Clavier g&eacute;n&eacute;rique se r&eacute;f&egrave;re &agrave;
une disposition de clavier g&eacute;n&eacute;rique internationale.
Activer/d&eacute;sactiver clavier
Vous pouvez activer/d&eacute;sactiver les actions du clavier dans le projet et au niveau de la page. Pour activer les actions du
clavier, d&eacute;finissez dans le volet Propri&eacute;t&eacute;s le Macro clavier sur Vrai.
Vous pouvez &eacute;galement activer/d&eacute;sactiver les actions du clavier &agrave; l'ex&eacute;cution avec l'action KeyboardMacros. Voir
&quot;Actions clavier&quot; on page 107 pour plus de d&eacute;tails.
Associer des actions &agrave; des touches
Vous associez des actions &agrave; des touches depuis l'&eacute;diteur Clavier.
1. Cliquez sur + &agrave; c&ocirc;t&eacute; 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 | &copy; 2012-2017 DEIF A/S
28 Claviers externes
1. Cliquez sur + pour ajouter des actions.
Vous pouvez associer des actions &agrave; l'&eacute;v&eacute;nement OnClick et &agrave; l'&eacute;v&eacute;nement OnHold.
Voir &quot;&Eacute;v&eacute;nements&quot; on page 43 pour plus de d&eacute;tails.
Note : Du code JavaScript peut &eacute;galement &ecirc;tre associ&eacute; &agrave; un &eacute;v&eacute;nement-cl&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
257
Associer des actions &agrave; des touches
258
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
29
R&eacute;f&eacute;rence crois&eacute;e de variables
Le volet R&eacute;f&eacute;rence crois&eacute;e des variables affiche une liste de noms de variables utilis&eacute;es dans le projet en cours organis&eacute;
en fonction de leur emplacement et de leur utilisation.
Depuis ce volet, vous pouvez :
l
v&eacute;rifier o&ugrave; chaque variable est utilis&eacute;e (alarmes, pages, recettes, planificateurs, tendances, etc.)
l
identifier les r&eacute;f&eacute;rences invalides de variable (r&eacute;f&eacute;rences aux variables non d&eacute;finies dans l'&eacute;diteur de variable)
l
identifier les variables ne sont pas utilis&eacute;es dans le projet
Note : Le volet R&eacute;f&eacute;rence crois&eacute;e de variables ne liste pas les variables utilis&eacute;es dans le code JavaScript.
Mettre &agrave; jour les donn&eacute;es dans le volet R&eacute;f&eacute;rence crois&eacute;e des variables
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
261
259
Ouvrir le volet R&eacute;f&eacute;rence crois&eacute;e des variables
Chemin : Affichage&gt; Barre d'outils et ancrage de fen&ecirc;tres &gt; R&eacute;f&eacute;rence crois&eacute;e de variable
Cliquez sur l'onglet R&eacute;f&eacute;rence crois&eacute;e de variable pour ouvrir le volet R&eacute;f&eacute;rence crois&eacute;e de variable.
Travailler dans le volet R&eacute;f&eacute;rence crois&eacute;e des variables
Le volet R&eacute;f&eacute;rence crois&eacute;e des variables fournit un ensemble de fonctions standards.
&Eacute;l&eacute;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&eacute;f&eacute;rences : toutes les variables
l
R&eacute;f&eacute;rence variables invalide : variables non list&eacute;es dans l’&Eacute;diteur de variables.
l
Variables non utilis&eacute;es : variables list&eacute;es dans l’&eacute;diteur de variables mais non utilis&eacute;es
dans le projet.
Recherche de
champ
Appliquer un filtre pour afficher un nombre limit&eacute; de variables
Filtrer par
Variables de filtres par Emplacement, variable ou Propri&eacute;t&eacute;.
Naviguer dans les variables list&eacute;es pour trouver o&ugrave; elles sont utilis&eacute;s dans le projet.
Double-cliquez sur une variable pour ouvrir l’&eacute;diteur ou la page o&ugrave; elle est Utilis&eacute;e.
260
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
29 R&eacute;f&eacute;rence crois&eacute;e de variables
Mettre &agrave; jour les donn&eacute;es dans le volet R&eacute;f&eacute;rence
crois&eacute;e des variables
Mise &agrave; jour manuelle
Par d&eacute;faut, les informations affich&eacute;es dans le volet R&eacute;f&eacute;rence crois&eacute;e des variables doivent &ecirc;tre mises &agrave; jour
manuellement. Pour cela, cliquez sur le bouton de rafra&icirc;chissement
lorsqu'un rafra&icirc;chissement est n&eacute;cessaire.
. Un signe d'avertissement est affich&eacute;
Mise &agrave; jour automatique
Chemin : Vue&gt; Propri&eacute;t&eacute;s
Vous activez la mise &agrave; jour automatique du volet R&eacute;f&eacute;rence crois&eacute;e des variables depuis la AGI Creator page Propri&eacute;t&eacute;s.
S&eacute;lectionnez l’option mise &agrave; jour automatique.
Exporter les donn&eacute;es
Les donn&eacute;es affich&eacute;es dans le volet R&eacute;f&eacute;rence crois&eacute;e des variables peuvent &ecirc;tre export&eacute;es dans un fichier .csv.
Les donn&eacute;es sont organis&eacute;es dans le fichier export&eacute; selon la mani&egrave;re dont elles sont group&eacute;es dans le volet.
Group&eacute;es par
Format de fichier
Emplacement
RESSOURCES, BUREAU RESSOURCES, ID WIDGET, ATTRIBUT, variable
Variable
VARIABLE, RESSOURCES, BUREAU RESSOURCES, ID WIDGET, ATTRIBUT
Note : Les s&eacute;parateurs utilis&eacute;s lors de l'exportation d&eacute;pendent des param&egrave;tres r&eacute;gionaux de votre ordinateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
261
Mettre &agrave; jour les donn&eacute;es dans le volet R&eacute;f&eacute;rence crois&eacute;e des variables
262
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
30
Adressage index&eacute;
L'adressage index&eacute; vous permet de s&eacute;lectionner un ensemble de variables d&eacute;pendant de la valeur d'une autre variable. Il
est par exemple tr&egrave;s utile de pouvoir utiliser les m&ecirc;mes graphiques pour visualiser un ensemble de donn&eacute;es provenant de
diff&eacute;rentes sources. L'utilisateur n'a plus qu'&agrave; s&eacute;lectionner la source &agrave; surveiller parmi une liste.
G&eacute;n&eacute;rer un ensemble d’adressage index&eacute;
264
Utilisation d’un ensemble de variables index&eacute;es sur les pages
267
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
263
G&eacute;n&eacute;rer un ensemble d’adressage index&eacute;
G&eacute;n&eacute;rer un ensemble d’adressage index&eacute;
Sc&eacute;nario
Dans ce sc&eacute;nario, les donn&eacute;es environnementales sont collect&eacute;es depuis quatre pi&egrave;ces, chacune &eacute;quip&eacute;e de capteurs de
temp&eacute;rature, de pression et d'humidit&eacute;. Les donn&eacute;es sont disponibles de la fa&ccedil;on suivante :
Num&eacute;ro de chambre
Temp&eacute;rature
Pression
Humidit&eacute;
1
Pi&egrave;ce1-Temp&eacute;rature
Pi&egrave;ce1-Pression
Pi&egrave;ce1-Humidit&eacute;
2
Pi&egrave;ce2-Temp&eacute;rature
Pi&egrave;ce2-Pression
Pi&egrave;ce2-Humidit&eacute;
3
Pi&egrave;ce3-Temp&eacute;rature
Pi&egrave;ce3-Pression
Pi&egrave;ce3-Humidit&eacute;
4
Pi&egrave;ce4-Temp&eacute;rature
Pi&egrave;ce4-Pression
Pi&egrave;ce4-Humidit&eacute;
En utilisant la fonctionnalit&eacute; d'adressage index&eacute;, vous pouvez utiliser un seul format de tableau pour organiser toutes les
donn&eacute;es dans le p&eacute;riph&eacute;rique IHM.
Les donn&eacute;es provenant des trois capteurs peuvent &ecirc;tre affich&eacute;es sur une seule page, o&ugrave; le num&eacute;ro de pi&egrave;ce est utilis&eacute;
comme s&eacute;lecteur (liste d&eacute;roulante) pour choisir le bon ensemble de variables.
Cr&eacute;er un ensemble de variables index&eacute;es
Chemin : VueProjet&gt; variables
Pour ce faire, vous devez cr&eacute;er un ensemble de variables index&eacute;es.
1. Dans l'&Eacute;diteur de variables, d&eacute;finissez les protocoles et les variables. D&eacute;finissez une variable pour chaque donn&eacute;e
&agrave; indexer, dans cet exemple vous devez cr&eacute;er une variable pour chaque capteur dans chaque pi&egrave;ce.
264
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
30 Adressage index&eacute;
2. Cr&eacute;ez une variable &agrave; utiliser comme variable index&eacute;e. Dans cet exemple, vous cr&eacute;ez une variable &laquo; Num&eacute;roPi&egrave;ce &raquo;
qui pourrait &ecirc;tre de type UnsignedInt utilisant le protocole Variable.
3. Dans VueProjet, s&eacute;lectionnez Configuration&gt; variables, puis double-cliquez sur Ensemble de variables
index&eacute;es : l'&eacute;diteur d'Ensemble de variables index&eacute;es s'affiche.
4. Cliquez sur + pour afficher un Ensemble de variables index&eacute;es. Dans cet exemple, vous le nommez &laquo; Pi&egrave;ce &raquo;.
5. S&eacute;lectionnez la variable &laquo; Num&eacute;roPi&egrave;ce &raquo; &agrave; utiliser comme s&eacute;lecteur pour le num&eacute;ro de pi&egrave;ce.
6. Cr&eacute;ez une Instance d'index pour chaque ensemble de donn&eacute;es. Dans cet exemple, cr&eacute;ez-en une pour chaque
pi&egrave;ce.
7. Cr&eacute;ez un Alias pour chaque type de donn&eacute;es et renommez les colonnes du tableau de mani&egrave;re appropri&eacute;e. Dans
cet exemple, renommez-les &laquo; Temp&eacute;rature &raquo;, &laquo; Pression &raquo; et &laquo; Humidit&eacute; &raquo;.
8. Double-cliquez sur chaque cellule pour associer la variable correcte.
Note : Le type de donn&eacute;es de variable index&eacute;e peut &ecirc;tre un nombre, une cha&icirc;ne, ou tout type de donn&eacute;es
simples.
Note : Pour r&eacute;f&eacute;rencer un type de donn&eacute;es de tableau, utilisez le tableau index = -1
Fonction de remplissage automatique
Un tableau d'ensemble de variables index&eacute;es peut devenir tr&egrave;s complexe et le remplir peut conduire &agrave; des erreurs. Activez
la fonctionnalit&eacute; Remplissage automatique pour vous assurer que les alias sont correctement entr&eacute;s.
Cliquez sur
s'affiche.
pour activer la fonctionnalit&eacute; Remplissage automatique : le Tableau de remplissage automatique
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
265
G&eacute;n&eacute;rer un ensemble d’adressage index&eacute;
Cette fonction utilise une expression r&eacute;guli&egrave;re pour remplir le tableau avec des variables tentant de correspondre au filtre,
o&ugrave; le mot-cl&eacute; $(Instance) est remplac&eacute; par les valeurs Index d&eacute;finies et le mot-cl&eacute; $(Alias) par les &eacute;tiquettes d'alias
d&eacute;finies.
Exemple de remplissage automatique
&laquo; Room$(Instance)-$(Alias) &raquo; correspond &agrave; tous les noms de variables :
Pi&egrave;ce1-Temp&eacute;rature,
Pi&egrave;ce1-Pression,
Pi&egrave;ce1-Humidit&eacute;,
Pi&egrave;ce2-Temp&eacute;rature,
…
&laquo; Room0*$(Instance)-$(Alias) &raquo; correspond &agrave; tous les noms de variables :
Pi&egrave;ce1-Temp&eacute;rature,
Pi&egrave;ce01-Pression,
Pi&egrave;ce001-Humidit&eacute;,
Pi&egrave;ce2-Temp&eacute;rature,
Pi&egrave;ce02-Pression,
Pi&egrave;ce002-Humidit&eacute;,
…
266
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
30 Adressage index&eacute;
&Eacute;l&eacute;ments de tableau &agrave; remplissage automatique
&Eacute;l&eacute;ment
Description
Remplir
Remplit les entr&eacute;es manquantes dans le tableau de variables en utilisant le filtre d&eacute;fini (le cas &eacute;ch&eacute;ant).
Par exemple, lorsque de nouvelles instances ou de nouveaux alias sont ajout&eacute;s, vous pouvez utiliser
cette option pour remplir les nouvelles entr&eacute;es.
Remplacer
Remplace toutes les entr&eacute;es du tableau par celles fournies par le tableau &agrave; remplissage automatique.
R&eacute;initialiser R&eacute;initialise le filtre de variables pour vider ; aucun remplissage automatique n'est effectu&eacute;.
Sugg&egrave;re une expression de filtre valide pour votre projet.
Note : Les filtres sont sauvegard&eacute;s comme pr&eacute;f&eacute;rences de projet et peuvent &ecirc;tre d&eacute;finis pour l'ensemble du
tableau ou pour une colonne. Lorsque le filtre est d&eacute;fini pour une colonne, le filtre de tableau est ignor&eacute;. Ainsi,
vous pouvez modifier de mani&egrave;re s&eacute;lective le filtre pour g&eacute;rer un seul alias en particulier.
Note : Pour r&eacute;f&eacute;rencer les &eacute;l&eacute;ments d'un tableau, utilisez le caract&egrave;re \ pour d&eacute;sactiver l'interpr&eacute;tation de
l'expression r&eacute;guli&egrave;re des crochets (les variables de tableau sont diff&eacute;renci&eacute;es en &eacute;tant en italique).
Utilisation d’un ensemble de variables index&eacute;es sur les
pages
Une fois qu'un jeu de variables index&eacute;es a &eacute;t&eacute; cr&eacute;&eacute;, vous pouvez l'utiliser pour cr&eacute;er une page pour le p&eacute;riph&eacute;rique IHM
comme dans cet exemple.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
267
Utilisation d’un ensemble de variables index&eacute;es sur les pages
Pour cr&eacute;er cette page :
1. Cr&eacute;er une page et ajouter une liste d&eacute;roulante, trois &eacute;tiquettes et trois champs num&eacute;riques.
2. Utiliser la variable d'index cr&eacute;&eacute; pour le num&eacute;ro de la pi&egrave;ce pour la liste d&eacute;roulante, &laquo; RoomNumber &raquo; dans cet
exemple. Ce sera le s&eacute;lecteur pour le num&eacute;ro de la pi&egrave;ce.
3. Cr&eacute;er une liste pour la liste d&eacute;roulante. Dans cet exemple, utiliser la liste suivante.
Index
Liste des cha&icirc;nes
0
Num&eacute;ro de chambre
1
Chambre 1
2
Chambre 2
3
Chambre 3
4
Chambre 4
4. Joindre &agrave; chaque valeur de champ num&eacute;rique, la variable Alias correspondant (Pi&egrave;ce &gt; Temp&eacute;rature, Pi&egrave;ce &gt;
Humidit&eacute;, Pi&egrave;ce &gt; Pression).
268
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
31 Serveur &agrave; architecture unifi&eacute;e
OPC
Chemin : ProjectView&gt; Config &gt; Interfaces &gt; double-cliquer sur OPC UA
Utilisez le serveur &agrave; architecture unifi&eacute;e OPC pour publier les donn&eacute;es selon le standard de l'architecture unifi&eacute;e OPC.
Fonctionnalit&eacute;s
Param&egrave;tre
Description
Activer serveur &agrave;
architecture unifi&eacute;e OPC
Active le fonctionnement du serveur &agrave; architecture unifi&eacute;e OPC.
Activer alarmes
Active la publication des donn&eacute;es d'alarme en temps r&eacute;el (Alarmes
actives).
Les valeurs de donn&eacute;es d&eacute;finies dans l'IHM sont publi&eacute;es par le serveur &agrave;
architecture unifi&eacute;e OPC.
Les propri&eacute;t&eacute;s d'alarme suivantes sont publi&eacute;es :
• Activ&eacute;(e)
• S&eacute;v&eacute;rit&eacute;
• &Eacute;tat
Les &eacute;tats d'alarme sont associ&eacute;s aux &eacute;tats de l'architecture unifi&eacute;e OPC
selon les r&egrave;gles suivantes :
&Eacute;tat alarme architecture
unifi&eacute;e OPC
AGI Creator &Eacute;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 &amp; state !=
NOT_TRIGGERED )
Opcua.Alarm.Confirmed
lorsque l'alarme requiert la r&eacute;initialisation
du drapeau et l'&eacute;tat est NOT_
TRIGGERED
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
269
Param&egrave;tre
Description
L'op&eacute;ration de confirmation de l'architecture unifi&eacute;e OPC est associ&eacute;e &agrave;
l'op&eacute;ration de r&eacute;initialisation. La confirmation ne fonctionne que si l'alarme
est active, autrement elle retourne OpcUa_BadInvalidState (puisque
l'op&eacute;ration de r&eacute;initialisation ne fonctionne qu'&agrave; cette condition).
Les op&eacute;rations de confirmation/activation/d&eacute;sactivation effectu&eacute;es via
l'architecture unifi&eacute;e OPC sont audit&eacute;es en tant que domaine &laquo; Serveur &agrave;
architecture unifi&eacute;e OPC &raquo;. Si l'authentification est user/pass, l'utilisateur
est lui aussi connect&eacute;.
BranchId n'est pas support&eacute; (le r&eacute;sultat est toujours “Nul”).
Activer alarmes historiques
Active la publication des donn&eacute;es des alarmes historiques
Activer tendances
Active la publication des donn&eacute;es de tendance.
R&eacute;seau
Param&egrave;tre
Description
Nom de nœud
Saisir le nom du nœud ou le laisser en blanc pour utiliser le nom de l'h&ocirc;te.
Port
Le nombre de port d'entr&eacute;e du Serveur &agrave; architecture unifi&eacute;e OPC.
Produit URI
Un identifiant globalement unique pour le serveur.
Authentification
Param&egrave;tre
Description
Anonyme
Clients anonymes accept&eacute;s
Utilisateur/Mot de passe
L'authentification par identifiant est accept&eacute;e
Certificats
L'authentification par certificat est accept&eacute;e.
Le serveur peut supporter toutes les options simultan&eacute;ment.
Par exemple, supposons qu'il y a 3 clients. Admettons que le Client 1 n'a qu'un acc&egrave;s anonyme. Le Client 2 n'a qu'un
acc&egrave;s identifiant/mot de passe. Et le Client 3 n'a qu'un acc&egrave;s par certificat. Ils pourront se connecter tous les trois si toutes
les cases sont coch&eacute;es dans l'&eacute;diteur de configuration du serveur.
Identit&eacute; de serveur
Param&egrave;tre
Description
Nom du fabricant
Un nom lisible par l'homme d&eacute;signant le fabricant du produit.
Nom du produit
Un nom lisible par l'homme d&eacute;signant le produit qui ex&eacute;cute le serveur.
Certificat du serveur
Le certificat du serveur peut soit &ecirc;tre g&eacute;n&eacute;r&eacute; automatiquement, soit par
l'ajout de fichiers de certificat existants.
270
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32
Widgets sp&eacute;ciaux
Les widgets con&ccedil;us &agrave; des fins sp&eacute;ciales sont appel&eacute;es widgets sp&eacute;ciaux et comprennent des listes de contr&ocirc;le, widgets
de date et heure des, widgets variables, etc.
Widget de navigateur
272
Widget Canevas
273
Widget liste d&eacute;roulante
276
Widget compteur de consommation
280
Widgets de liste de contr&ocirc;le
282
Widgets Date &amp; Heure
283
Widget de zone de mouvement
284
Widgets cam&eacute;ra IP
285
Widget de blocage de fonction Javascript
289
Widgets de lecture de m&eacute;dias
290
Widget d'image multi-&eacute;tats
293
Widget multi-couche d’image multi-&eacute;tats
294
Widget adaptateurs r&eacute;seau
296
Widget de flux RSS
296
Faire d&eacute;filer le widget de flux RSS
297
Widget tableau
298
Widget de variables
306
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
271
Widget de navigateur
Widget de navigateur
Chemin : Galerie des widgets&gt; M&eacute;dia&gt; Contr&ocirc;les web
Utilisez ce widget pour int&eacute;grer des pages web aux pages de votre p&eacute;riph&eacute;rique IHM. Ce widget de navigateur est
compatible avec l'HTML5 et il est bas&eacute; sur le moteur WebKit.
Note : Pour les p&eacute;riph&eacute;riques IHM int&eacute;gr&eacute;s fonctionnant sous Windows CE, la biblioth&egrave;que WebKit est
disponible en tant que plug-in (voir&quot;Modules de plug-in de logiciels&quot; on page 66 pour plus de d&eacute;tails) pour le
t&eacute;l&eacute;charger pour le HMI Runtime uniquement si n&eacute;cessaire.
Important : Les p&eacute;riph&eacute;riques avec MIPS ne prennent pas en charge ce widget.
Param&egrave;tre
Description
Page d'accueil
URL &agrave; ouvrir par d&eacute;faut lorsque le widget est affich&eacute; sur la page.
Zoom pour ajuster
Met automatiquement le contenu &agrave; l'&eacute;chelle de la taille de la zone d'affichage.
D&eacute;lai d'attente
D&eacute;lai d'attente pour le chargement de la page en secondes.
Effacer l'historique
Efface automatiquement l'historique lors du chargement
D&eacute;filement
Affiche/masque les barres de d&eacute;filement
Afficher curseur de progr&egrave;s
Affiche/masque le curseur de chargement
Cela vous permet de gagner environ 3 MB de m&eacute;moire lorsque le widget n'est pas requis dans votre projet.
Un widget Hyperlien est disponible pour cr&eacute;er des pages hyperliens. Lorsque vous cliquez sur ces liens, ils notifient au
widget de navigateur qu'une page web donn&eacute;e va &ecirc;tre charg&eacute;e.
Important : Le protocole HTTPs n'est pas pris en charge.
272
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Widget Canevas
Chemin : Galerie des widgets&gt; Basique&gt; Canevas g&eacute;n&eacute;rique
Le Widget Canevas peut &ecirc;tre utilis&eacute; pour dessiner le graphique via le script JavaScript.
Remarque : les m&eacute;thodes JavaScript sont les m&ecirc;mes qui sont disponibles pour la variable HTML5 &lt;canevas&gt;
Param&egrave;tre
Description
Largeur de canevas
Hauteur de canevas
Taille du canevas.
Dessiner indice
D&eacute;finir comment adapter le canevas &agrave; l'int&eacute;rieur de la taille du widget
Notez que ce n’est pas la taille du widget. Par exemple, la taille du canevas
pourrait &ecirc;tre de 500x500 pixels pour une taille du widget de 100x100 pixels.
Le param&egrave;tre Dessiner indice d&eacute;finira comment &eacute;tirer la taille du canevas
pour correspondre &agrave; la taille du widget.
l
l
l
Clip
Aucune transformation n’est appliqu&eacute;e, le syst&egrave;me de coordonn&eacute;es
n’est pas mis &agrave; l'&eacute;chelle et le dessin est clips&eacute; dans le rectangle
englobant du widget.
Ajuster &agrave; la taille
Ajuster &agrave; la taille du widget en pr&eacute;servant le rapport d’aspect du
mod&egrave;le canevas.
&Eacute;tirement
Ajuster &agrave; la taille du widget en ignorant le rapport d’aspect du mod&egrave;le
canevas.
Exemple en utilisant une taille de canevas plus grande que la taille du
widget :
Aper&ccedil;u du temps de design Aper&ccedil;u du canevas dans AGI Creator
Notez que le code JavaScript peut utiliser les donn&eacute;es non
disponibles dans AGI Creator mais seulement dans le
p&eacute;riph&eacute;rique IHM
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
273
Widget Canevas
Param&egrave;tre
Description
Action OnDraw
L'&eacute;v&eacute;nement OnDraw est ex&eacute;cut&eacute; lorsque la page est peinte. Cet
&eacute;v&eacute;nement doit &ecirc;tre li&eacute; au code JavaScript qui dessine le graphique de
canevas.
Action OnMousePress
Actions onMouseRelease
&Eacute;v&eacute;nements de la souris
M&eacute;thodes de canevas disponibles
// Enregistrer / restaurer peintre
l
annuler enregistrement(); // appelle enregistrement peintre
l
annuler restauration(); // appelle restauration peintre
// &Eacute;chelle / Transformation
l
annuler &eacute;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 &amp;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 | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;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&amp; image, int width, int height, const QString&amp; 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&eacute;der au contexte de rendu et y
dessiner :
var ctx = me.context2d;
alors vous pouvez utiliser les m&eacute;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 | &copy; 2012-2017 DEIF A/S
275
Widget liste d&eacute;roulante
alert(&quot;X = &quot; + eventInfo.posX + &quot;\nY = &quot; + eventInfo.posY );
}
La m&eacute;thode de mise &agrave; jour peut &ecirc;tre utilis&eacute;e pour redessiner dynamiquement un widget canevas
function BtnStd1_btn_onMouseClick(me, eventInfo)
{
var myCanvasWidget = page.getWidget(&quot;GenericCanvasWgt1&quot;);
myCanvasWidget.update()
}
Widget liste d&eacute;roulante
Chemin : Galerie des widgets&gt; Basique&gt; Contr&ocirc;les
Utilisez ce widget comme widget de s&eacute;lection ou pour filtrer les lignes dans un tableau, afin d'afficher uniquement les
valeurs s&eacute;lectionn&eacute;es dans la liste d&eacute;roulante.
Param&egrave;tre
Description
Index
Index de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
Liste/Liste de
cha&icirc;ne
Cha&icirc;nes d'&eacute;l&eacute;ment dans la liste d&eacute;roulante.
Note : Ce champ est multilangues.
Donn&eacute;es/Liste de Retourne la valeur de la colonne Liste de donn&eacute;es (comme cha&icirc;ne) dans le champ
donn&eacute;es
Donn&eacute;es du widget.
Astuce : Utilisez ce param&egrave;tre pour retourner une valeur personnalis&eacute;e
bas&eacute;e sur un &eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Texte
276
Format du texte affich&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Associer des donn&eacute;es VS associer des index
Dans de nombreux projets, vous pouvez &ecirc;tre amen&eacute; &agrave; associer des champs tels que Index ou Donn&eacute;es &agrave; des variables
pour conna&icirc;tre les valeurs de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante. Utilisez :
l
Index : pour afficher l'index (entier) de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; (0...n).
l
Donn&eacute;es : pour afficher la valeur des donn&eacute;es (cha&icirc;ne) sp&eacute;cifi&eacute;e dans la colonne Liste des donn&eacute;es.
Mode &laquo; plein &eacute;cran &raquo; avec images du widget &agrave; liste d&eacute;roulante
Depuis les &quot;Volet des propri&eacute;t&eacute;s de projet&quot; on page 60 l’apparence et le comportement des listes d&eacute;roulantes du mode
Contextuel au mode Plein &Eacute;cran
Chemin : VueProjet&gt; double-cliquez sur Propri&eacute;t&eacute;s du projet&gt; Panneau de propri&eacute;t&eacute;s&gt; Style&gt; Mode de vue de la
liste d&eacute;roulante
Param&egrave;tre
Description
Mode de vue
bo&icirc;tier combin&eacute;
S&eacute;lectionnez le mode de visualisation de tous les widgets de liste d&eacute;roulante du projet
Contexte
Vue classique avec les menus d&eacute;roulants
Plein &eacute;cran
Vue am&eacute;lior&eacute;e avec textes et images configurables qui appara&icirc;tront au milieu de
l'&eacute;cran pour faire d&eacute;filer facilement et s&eacute;lectionner.
Exemple de vue Contextuel
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
277
Widget liste d&eacute;roulante
Exemple de vue Plein &eacute;cran
Param&egrave;tres suppl&eacute;mentaires disponibles en mode plein &eacute;cran
La colonne suppl&eacute;mentaire &laquo; Liste des images &raquo; sera disponible dans le param&egrave;tre Liste d&eacute;roulante&gt; Liste :
278
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Note : Certaines propri&eacute;t&eacute;s ne s'affichent qu'en mode avanc&eacute;.
Param&egrave;tre
Description
Image
Retour, &agrave; l'int&eacute;rieur de la variable attach&eacute;e, le nom du fichier de l'image s&eacute;lectionn&eacute;e
Bouton
D&eacute;finir l'apparence de la liste d&eacute;roulante
l
l
VueListes
Afficher l'arri&egrave;re-plan = vrai
Bouton liste d&eacute;roulante affich&eacute;
Afficher l'arri&egrave;re-plan = faux
Seul l’image ou le texte est affich&eacute;
Param&egrave;tres de mise en page de la liste d&eacute;roulante en mode &eacute;dition
&Eacute;l&eacute;mentsVueListe D&eacute;finir le type d'&eacute;l&eacute;ments &agrave; l'int&eacute;rieur de la liste d&eacute;roulante
Mode Image :
l
Seul texte
l
Seules images
l
Texte et images
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
279
Widget compteur de consommation
Widget compteur de consommation
Chemin : Galerie des widgets&gt; Basique&gt; Tendances/Graphiques
Utilisez ce widget pour g&eacute;rer une ressource qui est en constante hausse. Le syst&egrave;me lit la valeur de la ressource et calcule
l'incr&eacute;ment dans un ensemble de plages de temps. L'incr&eacute;ment est ensuite affich&eacute; dans un histogramme dans une fen&ecirc;tre
de type de tendance.
Diff&eacute;rentes couleurs peuvent &ecirc;tre utilis&eacute;es dans le graphique, selon le d&eacute;lai d'ex&eacute;cution.
Astuce : Utilisez ce widget pour calculer la consommation d'&eacute;nergie d'un syst&egrave;me.
Param&egrave;tre
Description
Valeur
Ressource surveill&eacute;e
Dur&eacute;e du
graphique
Unit&eacute;s de dur&eacute;e
du graphique
P&eacute;riode de temps affich&eacute;e dans la fen&ecirc;tre
Dur&eacute;e de la
barre
Unit&eacute;s de dur&eacute;e
des barres
P&eacute;riode de temps repr&eacute;sent&eacute;e par chaque barre du graphique
P&eacute;riodes de
temps
Assigne une couleur sp&eacute;cifique pour surligner l'incr&eacute;ment de la ressource surveill&eacute;e
dans une p&eacute;riode de temps donn&eacute;e (r&eacute;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'&eacute;tiquettes &agrave; afficher dans le graphique.
Exemple : surveiller la consommation d'&eacute;nergie
Dans l'exemple suivant, un widget est con&ccedil;u pour surveiller la consommation d'&eacute;nergie avec une &eacute;chelle hebdomadaire et
une unit&eacute; quotidienne.
280
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
1. Associez une variable &agrave; la variable physique &agrave; surveiller. Dans cet exemple, la totalit&eacute; de l'&eacute;nergie consomm&eacute;e
(variable KWh). Cette variable contient un nombre incr&eacute;mentiel qui indique la consommation en KW/h depuis le
d&eacute;but de la consommation d'&eacute;nergie.
2. Ajoutez une tendance et liez-la &agrave; la variable &agrave; surveiller, la variable KWh.
3. Ajoutez un widget Compteur de consommation &agrave; une page.
4. Associez la propri&eacute;t&eacute; Valeur du compteur de consommation &agrave; la tendance cr&eacute;&eacute;e &agrave; l'&eacute;tape 2.
5. D&eacute;finissez Dur&eacute;e du graphique/Unit&eacute;s &agrave; 1 semaine : vous obtiendrez un graphique hebdomadaire de l'&eacute;nergie
consomm&eacute;e.
6. D&eacute;finissez Dur&eacute;e de la barre/Unit&eacute;s &agrave; 1 jour. C'est l'intervalle de temps pendant lequel l'&eacute;nergie consomm&eacute;e est
calcul&eacute;e.
7. Dans Compteur de consommation, d&eacute;finissez le nombre d'&eacute;tiquettes &agrave; afficher dans l'histogramme, dans le cas
pr&eacute;sent 7, pour afficher un graphique hebdomadaire.
8. Depuis la propri&eacute;t&eacute; P&eacute;riodes de temps, ouvrez la bo&icirc;te de dialogue Configurer les p&eacute;riodes de temps :
d&eacute;finissez les diff&eacute;rentes couleurs pour diff&eacute;rentes valeurs de la variable KWh dans chaque barre.
Astuce : Pour assigner la couleur aux cellules du tableau, s&eacute;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&eacute;cessaire, dans cet exemple 3 couleurs de bandes.
10. Assignez une bande &agrave; chaque heure dans le tableau hebdomadaire, dans cet exemple une bande rouge (E1), qui
indique la plage de temps dans la journ&eacute;e/semaine pendant laquelle le co&ucirc;t de l'&eacute;nergie est le plus &eacute;lev&eacute;.
Note : Vous pouvez appliquer un facteur d'&eacute;chelle &agrave; chaque bande de couleur, si n&eacute;cessaire.
Il en r&eacute;sulte un histogramme repr&eacute;sentant le compteur de consommation et affichant la consommation d'&eacute;nergie en KW/h,
avec des couleurs qui indiquent les diff&eacute;rents co&ucirc;ts de l'&eacute;nergie. La hauteur de chaque barre repr&eacute;sente la quantit&eacute;
d'&eacute;nergie dans l'intervalle de temps concern&eacute;, 1 jour dans cet exemple.
Utilisez l'action ConsumptionMeterPageScroll pour faire d&eacute;filer l'histogramme en avant et en arri&egrave;re, ainsi que l'action
RefreshTrend pour rafra&icirc;chir l'histogramme car les donn&eacute;es ne sont pas rafra&icirc;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 | &copy; 2012-2017 DEIF A/S
281
Widgets de liste de contr&ocirc;le
Widgets de liste de contr&ocirc;le
Chemin : Galerie des widgets&gt; Avanc&eacute;&gt; Liste de contr&ocirc;le
Utilisez ces widgets pour repr&eacute;senter l'&eacute;tat associ&eacute; &agrave; un processus particulier et pour contr&ocirc;ler ce processus depuis le
m&ecirc;me widget.
Deux types de listes de contr&ocirc;le sont disponibles :
l
l
une liste de contr&ocirc;le de groupe, avec un ensemble limit&eacute; de boutons de navigation qui sont d&eacute;j&agrave; inclus, et
une liste de contr&ocirc;le basique avec aucun bouton configur&eacute; au pr&eacute;alable, sur laquelle vous pouvez naviguer en
utilisant la fonction &eacute;cran tactile.
Param&egrave;tre
Description
Valeur
Si le Mode d'&eacute;criture est &Eacute;crire apr&egrave;s s&eacute;lection : valeur de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute;.
Si le Mode d'&eacute;criture est &Eacute;crire apr&egrave;s entr&eacute;e : valeur de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; et confirm&eacute; en appuyant
sur le bouton entr&eacute;e.
Ce champ peut &ecirc;tre associ&eacute; &agrave; une variable pour contr&ocirc;ler l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; et confirm&eacute;.
&Eacute;tat
&Eacute;tat par d&eacute;faut lorsque le widget est charg&eacute;.
S&eacute;lection
&Eacute;l&eacute;ment actuellement s&eacute;lectionn&eacute;, affich&eacute; comme un curseur surlign&eacute; se d&eacute;pla&ccedil;ant de haut en bas. Cette
propri&eacute;t&eacute; peut &ecirc;tre associ&eacute;e &agrave; une variable.
Mode
&eacute;criture
&Eacute;crire apr&egrave;s s&eacute;lection : la valeur est automatiquement &eacute;crite sur la variable lorsque vous s&eacute;lectionnez un
des &eacute;l&eacute;ments.
&Eacute;crire apr&egrave;s entr&eacute;e : la valeur est &eacute;crite sur la variable uniquement lorsque vous s&eacute;lectionnez un des
&eacute;l&eacute;ments et que vous appuyez sur la touche entr&eacute;e.
Read only
D&eacute;finit si la liste est uniquement un indicateur.
Liste de
donn&eacute;es
Ajoute/supprime des &eacute;l&eacute;ments de la liste.
D&eacute;finir les &eacute;tats
Ajoute/supprime des &eacute;tats, c'est-&agrave;-dire des &eacute;l&eacute;ments de la liste, depuis la propri&eacute;t&eacute; Liste de donn&eacute;es.
282
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Toute valeur peut &ecirc;tre assign&eacute;e &agrave; un &eacute;tat. Lorsque vous activez l'&eacute;tat, en s&eacute;lectionnant l'&eacute;l&eacute;ment associ&eacute; si vous &ecirc;tes en
mode &Eacute;crire apr&egrave;s s&eacute;lection ou bien en le s&eacute;lectionnant et en confirmant en appuyant sur entr&eacute;e si vous &ecirc;tes en mode
&Eacute;crire apr&egrave;s entr&eacute;e, la valeur associ&eacute;e &agrave; un &eacute;tat sera &eacute;crite sur la variable li&eacute;e au widget de contr&ocirc;le de la liste Valeur .
Widgets Date &amp; Heure
Chemin : Galerie des widgets&gt; Basique&gt; Contr&ocirc;les
Utilisez ce widget pour afficher et &eacute;diter la date et l'heure actuelles.
Dans le volet Propri&eacute;t&eacute;s, diff&eacute;rents formats sont disponibles pour repr&eacute;senter la date et l'heure.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
283
Widget de zone de mouvement
Pour la propri&eacute;t&eacute; Sp&eacute;c heure, s&eacute;lectionnez quelle heure le widget doit afficher en cours d'ex&eacute;cution.
Options pour l'heure
Option
Description
locale
affiche l'heure locale, l'heure du p&eacute;riph&eacute;rique IHM o&ugrave; le projet est ex&eacute;cut&eacute;
GMT
affiche l'heure de Greenwich (GMT)
serveur
affiche les informations relatives &agrave; l'heure telles que g&eacute;r&eacute;es au niveau du serveur du p&eacute;riph&eacute;rique IHM
Widget de zone de mouvement
Chemin : Galerie des widgets&gt; Boutons&gt; Autres
Le widget de zone de mouvement est un bouton &agrave; zone r&eacute;active qui g&eacute;n&egrave;re des &eacute;v&eacute;nements de pincement et de
d&eacute;placement.
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent g&eacute;n&eacute;rer des &eacute;v&eacute;nements de
pincement
284
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Utilisez le code JavaScript en association avec les &eacute;v&eacute;nements de mouvement pour obtenir des informations d&eacute;taill&eacute;es sur
les gestes et programmer les actions appropri&eacute;es.
Voir &quot;&Eacute;v&eacute;nements de widget&quot; on page 330pour plus de d&eacute;tails sur ces types d'&eacute;v&eacute;nements
Geste de balayage
Comment reconna&icirc;tre un geste de &laquo; balayage &raquo; 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&eacute;clencher une fonction JavaScript
3. &Eacute;crire le code JavaScript qui reconnait le geste de balayage
Widgets cam&eacute;ra IP
Chemin : Galerie des widgets&gt; M&eacute;dia&gt; Cam&eacute;ra IP
Utilisez ces widgets pour afficher des images captur&eacute;es avec une cam&eacute;ra IP ou un flux vid&eacute;o.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
285
Widgets cam&eacute;ra IP
Param&egrave;tre
Description
URL de Cam&eacute;ra
URL de la cam&eacute;ra IP lorsqu'elle est utilis&eacute;e dans le format JPEG.
Fr&eacute;quence de
rafra&icirc;chissement
Nombre d'images JPEG par seconde autoris&eacute;. Fr&eacute;quence max = 1 fps.
Identifiant
Nom d'utilisateur autoris&eacute; &agrave; acc&eacute;der &agrave; la cam&eacute;ra.
Configurez ce param&egrave;tre lorsque l'acc&egrave;s &agrave; la cam&eacute;ra est prot&eacute;g&eacute; par un mot
de passe.
Mot de passe
Mot de passe d'acc&egrave;s &agrave; la cam&eacute;ra.
URL de cam&eacute;ra MJPEG
URL de flux MJPEG (par exemple, http://192.168.0.1/video.cgi)
Lorsque ce widget est utilis&eacute; pour diffuser HTTP MJPEG, l'URL de cam&eacute;ra et la Fr&eacute;quence de rafra&icirc;chissement sont
ignor&eacute;s.
La performance du flux n'est pas fixe et d&eacute;pend de nombreux facteurs, tels que : la taille de l'image, le niveau de
compression de l'image, la CPU du p&eacute;riph&eacute;rique IHM, la qualit&eacute; de la Cam&eacute;ra IP. En fonction de ces facteurs, le widget
peut atteindre jusqu'&agrave; 25 fps.
Vous pouvez ajouter de multiples widgets de cam&eacute;ra IP, mais cela r&eacute;duira la fr&eacute;quence image pour chaque widget.
Cam&eacute;ras IP support&eacute;es
Les Cam&eacute;ras IP suivantes ont &eacute;t&eacute; test&eacute;es :
Cam&eacute;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 | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Cam&eacute;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&amp;usr=
{user}&amp;pwd={pass}
Foscam FI8916W
Foscam FI9803 EP
NOTE :
l
l
l
Hamlet HNIPCAM IP Camera
le port 88 peut &ecirc;tre diff&eacute;rent en fonction des
param&egrave;tres de la Cam&eacute;ra IP
{user} = identifiant d&eacute;fini dans les param&egrave;tres
de la Cam&eacute;ra IP
{pass} = mot de passe d&eacute;fini dans les
param&egrave;tres de la Cam&eacute;ra IP
MJPEG
http://{ip_address}/video.cgi
HTTP
http://{ip_address}/image.jpg
MOXA VPort 254 (Encodeur vid&eacute;o industriel
robuste &agrave; 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 | &copy; 2012-2017 DEIF A/S
287
Widgets cam&eacute;ra IP
Cam&eacute;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 &amp; Night Compact IP
Came
{camera_guiID} peut &ecirc;tre trouv&eacute; sur la page
web de la Cam&eacute;ra IP
le port 7080 peut &ecirc;tre diff&eacute;rent en fonction des
param&egrave;tres de la Cam&eacute;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&eacute;o MJPEG peut &ecirc;tre configur&eacute; en
s&eacute;lectionnant &laquo; profil vid&eacute;o 3 &raquo; avec une
r&eacute;solution 640x480 dans les param&egrave;tres de la
Cam&eacute;ra IP.
Widget de contr&ocirc;les PTZ
Les cam&eacute;ras PTZ (pan–tilt–zoom) sont des cam&eacute;ras capables de contr&ocirc;ler le zoom et la direction &agrave; distance.
Le widget de contr&ocirc;les PTZ utilise l'action MoveIPCamera pour envoyer des commandes HTTP/cgi &agrave; la Cam&eacute;ra IP PTZ.
Param&egrave;tre
Description
URL de
Cam&eacute;ra
URL de la Cam&eacute;ra IP
Identifiant
Nom d'utilisateur autoris&eacute; &agrave; acc&eacute;der &agrave; la cam&eacute;ra.
Configurez ce param&egrave;tre lorsque l'acc&egrave;s &agrave; la cam&eacute;ra est prot&eacute;g&eacute; par un mot de passe.
Mot de passe
Mot de passe d'acc&egrave;s &agrave; la cam&eacute;ra.
Commande
Commande &agrave; envoyer au contr&ocirc;leur PTZ (par exemple, decoder_
control.cgi?command=0)
288
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
M&eacute;thodes d'authentification
La m&eacute;thode d'authentification est automatiquement d&eacute;finie par le serveur web de la cam&eacute;ra auquel le widget est connect&eacute;.
Les m&eacute;thodes d'authentification support&eacute;es sont :
l
Basique
l
NTLM version 1
l
Digest-MD5
Widget de blocage de fonction Javascript
Chemin : Galerie des widgets&gt; Basique&gt; JSFunctionBlock
Le blocage de fonction Javascript est un widget contenant une logique Javascript qui est ex&eacute;cut&eacute;e lorsque les valeurs de
variable changent.
Param&egrave;tre
Description
valeur1
...
valeur16
Objets qui d&eacute;clencheront l'action OnDataUpdate.
OnDataUpdate
Action qui sera ex&eacute;cut&eacute;e si une modification de valeur associ&eacute;e est d&eacute;tect&eacute;e
Note : Ce widget n'est rendu que dans AGI Creator, et n'est pas rendu dans le p&eacute;riph&eacute;rique IHM.
Exemple :
Un code Javascript qui contr&ocirc;le la serrure &agrave; combinaison de trois s&eacute;lecteurs
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
289
Widgets de lecture de m&eacute;dias
Voir &quot;&Eacute;v&eacute;nements de widget&quot; on page 330pour la description des param&egrave;tres onDataUpdate
Widgets de lecture de m&eacute;dias
Chemin : Galerie des widgets&gt; M&eacute;dia&gt; Lecture de m&eacute;dias
290
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Utilisez ces widgets pour lire des vid&eacute;os &agrave; partir d'une liste de lecture. Les fichiers vid&eacute;o peuvent &ecirc;tre stock&eacute;s sur une cl&eacute;
USB, une carte m&eacute;moire flash ou une carte SD.
Deux widgets sont disponibles : l'un inclut un cadre multim&eacute;dia avec des boutons pour lire et interrompre la vid&eacute;o, l'autre
est un simple cadre o&ugrave; la vid&eacute;o est lu sans que l'utilisateur ne dispose de commandes.
Param&egrave;tre
Description
Liste de lecture m&eacute;dias
Cr&eacute;e une liste de lecture
Style en boucle
D&eacute;finissez la modalit&eacute; de lecture de la vid&eacute;o.
l
NoLoop : lit toutes les vid&eacute;os de la liste de lecture, puis s'arr&ecirc;te.
l
LoopOne : r&eacute;p&egrave;te la premi&egrave;re vid&eacute;o dans la liste de lecture.
l
LoopAll : r&eacute;p&egrave;te toute la liste de lecture.
l
Random : lit les vid&eacute;os selon un ordre al&eacute;atoire.
Note : Le widget de lecture de m&eacute;dias ne fonctionne qu'avec certains p&eacute;riph&eacute;riques IHM (les p&eacute;riph&eacute;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&eacute;dias dans une page.
Important : Utilisez les m&ecirc;mes codecs et param&egrave;tres pour tous les vid&eacute;os de la liste de lecture.
Codage vid&eacute;o support&eacute;
Deux groupes de codecs sont support&eacute;s :
l
Codecs vid&eacute;o bas&eacute;s sur DSP
l
Codecs logiciels vid&eacute;o
Codecs vid&eacute;o DSP
Ils incluent :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
291
Widgets de lecture de m&eacute;dias
l
H264 en utilisant un conteneur AVI/MP4, CABAC d&eacute;sactiv&eacute; et Niveau 3 (sugg&eacute;r&eacute;)
l
MPEG2 en utilisant un conteneur AVI
l
MPEG4 en utilisant un conteneur AVI
Ils utilisent le processeur DPS (acc&eacute;l&eacute;ration mat&eacute;rielle vid&eacute;o) et BSP 1.55 ou une version sup&eacute;rieure est requise pour les
lire. La r&eacute;solution maximale est de 720x576 pixels avec un d&eacute;bit de 4200 kb/s. 720p, 1080p et l'audio ne sont pas
support&eacute;s.
Codecs logiciels vid&eacute;o
Concerne uniquement :
l
Microsoft MPEG4 v3 en utilisant un conteneur AVI.
Les vid&eacute;os cod&eacute;s avec Microsoft MPEG4 v3 n'utilisent pas l'acc&eacute;l&eacute;ration mat&eacute;rielle et sont plus limit&eacute;es. Pour &eacute;viter une
lecture saccad&eacute;e des vid&eacute;os, nous sugg&eacute;rons une r&eacute;solution maximum de 640x512 pixels et un d&eacute;bit de 1300 kb/s. De
plus, la taille du widget de lecture de m&eacute;dias utilis&eacute; sur la page doit &ecirc;tre de la m&ecirc;me taille que les vid&eacute;os sur la liste de
lecture, si vous voulez &eacute;viter de devoir redimensionner l'image. L'audio n'est pas support&eacute;.
Convertir une vid&eacute;o
Cette proc&eacute;dure d&eacute;crit comment convertir une vid&eacute;o en utilisant le convertisseur vid&eacute;o eRightSoft SUPER &copy;.
1. Glissez-d&eacute;posez la vid&eacute;o &agrave; convertir dans SUPER.
2. S&eacute;lectionnez AVI &agrave; partir de la liste Conteneurs de Sortie et H.264/AVC &agrave; partir du Codec Vid&eacute;o de Sortie.
292
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
3. Cliquer sur H264 Profile : choisir Baseline comme profil et le niveau 3 dans la bo&icirc;te de dialogue.
4. Cochez la case D&eacute;sactiver l'audio.
5. Cliquez sur Coder (Fichiers Actifs) pour lancer le codage des vid&eacute;os.
Vous pouvez maintenant ouvrir les vid&eacute;os avec un lecteur vid&eacute;o classique, tel que Windows Media Player et contr&ocirc;ler la
qualit&eacute;. Vous pouvez ajouter la vid&eacute;o ainsi convertie &agrave; la liste de lecture du widget de lecture de m&eacute;dias.
Note : Cet outil de conversion vid&eacute;o n'est pas fourni avec le AGI SW Pack.
Utilisation du lecteur de m&eacute;dias dans Javascript
Le widget de lecture de m&eacute;dias peut aussi &ecirc;tre r&eacute;f&eacute;renc&eacute; 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 &quot;JavaScript &quot; on page 325 pour plus de d&eacute;tails sur les modalit&eacute;s de fonctionnement avec JavaScript.
Widget d'image multi-&eacute;tats
Chemin : Galerie des widgets&gt; Basique&gt; Images
Utilisez ce widget pour afficher une image parmi la s&eacute;rie propos&eacute;e, en fonction de la valeur d'une variable utilis&eacute;e comme
Index. Vous pouvez aussi utiliser ce widget pour de simples animations.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
293
Widget multi-couche d’image multi-&eacute;tats
Param&egrave;tre
Description
Valeur
Index de l'image &agrave; afficher.
Par exemple, d&eacute;finissez Valeur=0 pour afficher l'image avec l'index 0 dans la s&eacute;rie
d'images.
Images
S&eacute;rie d'images associ&eacute;es &agrave; 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-&eacute;tats
Chemin : Galerie des widgets&gt; Basique&gt; Images
Utilisez ce widget pour cr&eacute;er diff&eacute;rentes animations et s&eacute;lectionnez la plus appropri&eacute;e &agrave; l'ex&eacute;cution.
294
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Param&eacute;trer les couches de widget
1. Ouvrez la bo&icirc;te de dialogue Couches &agrave; partir du volet Propri&eacute;t&eacute;s.
2. Cliquez sur + pour ajouter le nombre de couches souhait&eacute;es.
3. Double-cliquez sur chaque couche pour ajouter le nombre d'images souhait&eacute;es &agrave; inclure dans la couche.
4. Glissez-d&eacute;posez les images dans le cadre pour les ajouter &agrave; la couche actuelle.
5. D&eacute;finissez les propri&eacute;t&eacute;s de widget.
Param&egrave;tre
Description
Couche par
d&eacute;faut
Couche affich&eacute;e &agrave; l'ex&eacute;cution.
Nom
Nom de la couche s&eacute;lectionn&eacute;e.
Cadre par
d&eacute;faut
Cadre apparaissant lorsque la couche actuelle est affich&eacute;e.
Couleur /
Remplissage
Couleur de remplissage pour les images de la couche actuelle.
Animer
Active le diaporama pour la couche active. Les animations peuvent &ecirc;tre
lanc&eacute;es/interrompues en cours d'ex&eacute;cution en les associant &agrave; une variable.
Intervalle de
temps
Intervalle de temps du diaporama, si activ&eacute;.
Aper&ccedil;u
Simulation du diaporama.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
295
Widget adaptateurs r&eacute;seau
Note : La Couche par d&eacute;faut, le Cadre par d&eacute;faut, la Couleur et le Remplissage peuvent &ecirc;tre modifi&eacute;s
pendant l'ex&eacute;cution, en les associant &agrave; une variable.
Widget adaptateurs r&eacute;seau
Chemin : Galerie des widgets&gt; Basique&gt; Contr&ocirc;le
Utilisez le widget IP pour configurer les param&egrave;tres d'adaptateurs r&eacute;seau.
La variable syst&egrave;me R&eacute;seau-&gt;&Eacute;tat contient le r&eacute;sultat de la derni&egrave;re op&eacute;ration ex&eacute;cut&eacute;e par le widget IP (voir &quot;Variables
r&eacute;seau&quot; on page 92pour plus d'informations)
Widget de flux RSS
Chemin : Galerie des widgets&gt; M&eacute;dia&gt; Source de flux RSS
Utilisez ce widget pour afficher sur le p&eacute;riph&eacute;rique IHM votre flux RSS pr&eacute;f&eacute;r&eacute; directement &agrave; partir d'Internet.
296
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Param&egrave;tre
Description
Source RSS
URL de flux
Note : Les sources de flux ne peuvent pas &ecirc;tre modifi&eacute;es en cours
d'ex&eacute;cution.
Fr&eacute;quence de mise &agrave; jour
Temps de rafra&icirc;chissement
Le widget de flux RSS a &eacute;t&eacute; sp&eacute;cifiquement con&ccedil;u pour fonctionner avec le Pocket Internet Explorer.
Faire d&eacute;filer le widget de flux RSS
Chemin : Galerie des widgets&gt; M&eacute;dia&gt; d&eacute;filement flux RSS
Utilisez cette version du widget principal de flux RSS pour afficher les faits saillants &agrave; l'int&eacute;rieur d'une ligne de texte &agrave; l'aide
d'un texte d&eacute;filant.
Ce widget a des propri&eacute;t&eacute;s suppl&eacute;mentaires.
Param&egrave;tre
Description
D&eacute;filement
Vitesse de d&eacute;filement
S&eacute;parateur de titres
Caract&egrave;re de s&eacute;paration entre les &eacute;l&eacute;ments surlign&eacute;s
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
297
Widget tableau
Widget tableau
Chemin : Galerie Widget&gt; Basic&gt; Tableau
Utiliser ce widget pour cr&eacute;er une tableau avec des donn&eacute;es fournies &agrave; partir d'une source de donn&eacute;es.
Pour configurer un tableau :
1. Mettre un widget de tableau sur l'&eacute;cran et configurer le mod&egrave;le de tableau.
2. Ajouter des widgets dans les cellules pour configurer une ou plusieurs lignes qui seront utilis&eacute;es en tant que mod&egrave;le
de lignes lorsque le tableau sera rempli de donn&eacute;es fournies par la source de donn&eacute;es.
3. S&eacute;lectionner une source de donn&eacute;es qui seront utilis&eacute;es pour remplir les lignes du tableau
4. D&eacute;finir les liens de widgets et source de donn&eacute;es.
Configurer le widget tableau
Le Widget tableau a deux &eacute;tats :
l
Mode vue
l
Mode &eacute;dition.
Cliquer sur le tableau pour g&eacute;rer le widget en mode vue, cliquer deux fois pour entrer dans le mode &eacute;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&eacute;poser le tableau sur la page, redimensionner le
tableau, d&eacute;finir le nombre de lignes mod&egrave;le, nombre de colonnes et les principales propri&eacute;t&eacute;s du tableau.
298
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Les propri&eacute;t&eacute;s &laquo; Groupe disposition grille &raquo; ne sont visibles que dans la vue avanc&eacute;e. Voir &quot;Grouper des widgets&quot;
on page 48 pour plus de d&eacute;tails.
Mode &eacute;dition
En mode &eacute;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&eacute;lecteurs de tableau pour s&eacute;lectionner l'&eacute;l&eacute;ment &agrave; configurer.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
299
Widget tableau
Pour configurer le contenu des cellules, faire glisser les widgets &agrave; l'int&eacute;rieur des cellules.
Si vous avez besoin plus de widgets dans une seule cellule, cr&eacute;er un groupe de widgets et copier le groupe
depuis la page sur la cellule.
Configuration de la source de donn&eacute;es
La source de donn&eacute;es, qui fournit les donn&eacute;es pour remplir le tableau, pourrait &ecirc;tre un Widget source de donn&eacute;es de tableau
ou un tableau JavaScript JSON.
Widget source de donn&eacute;es tableau
Chemin : Galerie Widget&gt; Basic&gt; Tableau
1. Glisser et d&eacute;poser un Widget de source de donn&eacute;e de tableau sur la page
2. Voir le param&egrave;tre Mod&egrave;le de tableau pour relier &agrave; la source de donn&eacute;es.
300
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
S&eacute;lectionner la source de donn&eacute;es et &agrave; l'int&eacute;rieur de l'&eacute;diteur TableDataSrcWgt ajouter les lignes et les colonnes
n&eacute;cessaires. Dans l'exemple suivant, nous avons d&eacute;fini deux mod&egrave;les de lignes :
l
l
Ligne 0
En-t&ecirc;te du tableau. Contient uniquement du texte statique
Ligne 1
Mod&egrave;le de lignes avec donn&eacute;es. Sur la premi&egrave;re colonne, nous avons ajout&eacute; une &eacute;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 | &copy; 2012-2017 DEIF A/S
301
Widget tableau
D&eacute;finir des liens avec la source de donn&eacute;es
1. Double-cliquer sur le widget de tableau pour entrer en mode d'&eacute;dition et s&eacute;lectionnez un widget
2. S&eacute;lectionner la propri&eacute;t&eacute; qui doit &ecirc;tre lu &agrave; partir de la source de donn&eacute;es
3. S&eacute;lectionner la colonne de la source de donn&eacute;es qui fournira les donn&eacute;es
L'image ci-dessous montre comment notre exemple sera rendu en runtime
302
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Multilangue
Pour activer le support Multilingue, faire un clic droit sur l'ic&ocirc;ne Multilingue de la colonne. L’ic&ocirc;ne changera de couleur pour
mettre en &eacute;vidence que le support est activ&eacute;.
&Eacute;viter en permettant le support multilingue lorsqu'ils ne sont pas n&eacute;cessaires pour de meilleures performances.
Importer/Exporter la source des donn&eacute;es
La configuration de la source de donn&eacute;es pourrait &ecirc;tre import&eacute;e / export&eacute;e &agrave; l'aide des fichiers xml
Tableau JavaScript JSON
En alternative du Widget de source de donn&eacute;es, donn&eacute;es pour remplir le tableau pourraient &ecirc;tre fourni &agrave; partir du code
JavaScript en utilisant un tableau JSON. Dans ce cas, nous devons remplir un tableau d'&eacute;l&eacute;ments JSON avec les donn&eacute;es
&agrave; utiliser et attribuer le tableau au widget tableau.
var myTable = page.getWidget(&quot;TableWgt1&quot;);
myTable.model = model;
le mod&egrave;le est un tableau d’&eacute;l&eacute;ments JSON avec la d&eacute;finition et les donn&eacute;es de tableau. Le premier &eacute;l&eacute;ment du tableau
contiendra le mod&egrave;le des lignes tandis que d’autres &eacute;l&eacute;ments contiennent les donn&eacute;es &agrave; 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 | &copy; 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&egrave;le de ligne est un tableau de tableau o&ugrave; chaque tableau d&eacute;finit la liaison de donn&eacute;es d'un mod&egrave;le de ligne.
Sur l'exemple ci-dessous, nous avons un mod&egrave;le pour deux rang&eacute;es.
var row_templates = {
_h : [
[ []
, []
],
[ [&quot;text&quot;] , [&quot;value&quot;] ]
]
}
//rowType = 0
//rowType = 1
La premi&egrave;re ligne est li&eacute;e &agrave; une rang&eacute;e avec deux colonnes qui ne contiennent pas de lien. Nous utilisons ce mod&egrave;le pour
l'en-t&ecirc;te sur la premi&egrave;re ligne de notre tableau.
La deuxi&egrave;me ligne d&eacute;finit le mod&egrave;le d'une ligne o&ugrave; la propri&eacute;t&eacute; du &laquo; texte &raquo; du widget dans la premi&egrave;re colonne et la propri&eacute;t&eacute;
&laquo; valeur &raquo; du widget dans la deuxi&egrave;me colonne sera remplie dynamiquement en utilisant les donn&eacute;es fournies dans la
variable de mod&egrave;le.
Dans l’exemple ci-dessous, nous d&eacute;finissons une ligne de donn&eacute;es
var row_data = {
_t : 1,
_v : [&quot;Temperature:&quot;, { _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag1&quot;, i: 0, m : 2 }]
}
Le premier &eacute;l&eacute;ment est le mod&egrave;le de ligne &agrave; utiliser tandis que le deuxi&egrave;me &eacute;l&eacute;ment est le tableau avec les donn&eacute;es &agrave;
utiliser. Dans notre exemple &laquo; Temp&eacute;rature &raquo; est le texte &agrave; utiliser &agrave; l'int&eacute;rieur du widget sur la premi&egrave;re colonne, tandis que
l'autre &eacute;l&eacute;ment est une liaison de donn&eacute;es qui fournira la valeur pour remplir la propri&eacute;t&eacute; de valeur du widget dans la
deuxi&egrave;me colonne.
L’&eacute;l&eacute;ment de la liaison de donn&eacute;es JSON :
Param&egrave;tre
Description
_c : &quot;dl&quot;
Identifier l’&eacute;l&eacute;ment JSON comme une liaison de donn&eacute;es
s : &quot;_TagMgr&quot;
Indiquer la source des donn&eacute;es est le Gestionnaire de variables
a : &quot;Tag1&quot;, i: 0, m:2
Sp&eacute;cifier le nom de la variable et l’index (n&eacute;cessaire quand une variable est un
tableau) et le mode lire/&eacute;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&eacute;n&eacute;rera le m&ecirc;me tableau d'exemple pr&eacute;c&eacute;dent li&eacute; avec le widget de source des donn&eacute;es
de tableau
var model = [];
304
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
var row_templates = {
_h : [
[ []
, []
],
[ [&quot;text&quot;] , [&quot;value&quot;] ]
]
}
//rowType = 0
//rowType = 1
var row_data1 = {
_t : 0,
_v : []
}
var row_data2 = {
_t : 1,
_v : [&quot;Temperature:&quot;, { _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag1&quot;, i: 0, m : 2 }]
}
var row_data3 = {
_t : 1,
_v : [&quot;Humidity:&quot;,
}
var row_data4 = {
_t : 1,
_v : [&quot;Noise:&quot;,
}
var row_data5 = {
_t : 1,
_v : [&quot;Brightness:&quot;,
}
model[0]
model[1]
model[2]
model[3]
model[4]
model[5]
=
=
=
=
=
=
{ _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag2&quot;, i: 0, m : 2 }]
{ _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag3&quot;, i: 0, m : 2 }]
{ _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag4&quot;, i: 0, m : 2 }]
row_templates;
row_data1;
row_data2;
row_data3;
row_data4;
row_data5;
var myTable = page.getWidget(&quot;TableWgt1&quot;);
myTable.model = model;
Multilangue
Un texte de langues multiples peut &ecirc;tre entr&eacute; en utilisant l'&eacute;l&eacute;ment JSON ci-dessous :
{ _c : &quot;ml&quot; , mltext : {&quot;en-US&quot; : &quot;Temperature:&quot; , &quot;it-IT&quot; : &quot;Temperatura:&quot;} }
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
305
Widget de variables
Param&egrave;tre
Description
_c : &quot;ml&quot;
Identifier l’&eacute;l&eacute;ment JSON comme un texte multilangue
mltext : { ... }
Liste de couples : &quot;ID Language&quot;:&quot;Text&quot;
Exemple :
l
&quot;en-US&quot; : &quot;Temperature:&quot;
l
&quot;it-IT&quot; : &quot;Temperatura:&quot;
Exemple :
var row_data2 = {
_t : 1,
_v : [ { _c : &quot;ml&quot; , mltext : { &quot;en-US&quot; : &quot;Temperature:&quot;,
&quot;it-IT&quot; : &quot;Temperatura:&quot;}
},
{ _c : &quot;dl&quot; , s : &quot;_TagMgr&quot;, a : &quot;Tag1&quot;, i: 0, m : 2 }
]
}
Widget de variables
Chemin : Galerie de widgets&gt; Avanc&eacute;&gt; Source de donn&eacute;es
Utilisez ce widget pour ajouter des variables internes pour les op&eacute;rations telles que le transfert de donn&eacute;es ou pour &ecirc;tre
utilis&eacute;s dans les programmes JavaScript.
Note : Les variables sont locales &agrave; la page o&ugrave; le widget a &eacute;t&eacute; ins&eacute;r&eacute;.
Lorsque vous glissez-d&eacute;posez ce widget dans votre page, un placeholder sera affich&eacute; pour indiquer l'emplacement du
widget, mais il ne sera pas visible au moment de l'ex&eacute;cution.
306
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
32 Widgets sp&eacute;ciaux
Param&eacute;trage du widget
Pour cr&eacute;er des variables et attribuer des valeurs &agrave; celles-ci, ouvrir les bo&icirc;tes de dialogue Variables depuis la propri&eacute;t&eacute;
Variables dans le volet Propri&eacute;t&eacute;s.
Ces variables peuvent ensuite &ecirc;tre r&eacute;f&eacute;renc&eacute;s &agrave; partir de la bo&icirc;te de dialogue de variable Attacher, &agrave; partir de l'&eacute;diteur de
page.
Si vous avez besoin des variables globales, les configurer au niveau du projet, en ajoutant les variables souhait&eacute;es au
widget variable globale.
Utiliser les variables dans JavaScript
Les variables peuvent &eacute;galement &ecirc;tre r&eacute;f&eacute;renc&eacute;es dans les programmes JavaScript avec la syntaxe suivante :
Pour les variables locales :
var varWgt = page.getWidget(&quot;_VariablesWgt&quot;);
var compVar = varWgt.getProperty(&quot;VariableName&quot;);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
307
Widget de variables
Pour les variables globales :
var varWgt = project.getWidget(&quot;_VariablesWgt&quot;);
var compVar = varWgt.getProperty(&quot;VariableName&quot;);
308
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33
Widgets personnalis&eacute;s
AGI Creator a une grande biblioth&egrave;que de widgets qui inclut des widgets dynamiques pr&eacute;d&eacute;finis (boutons, voyants, jauges,
s&eacute;lecteurs, tendances, recettes et &eacute;l&eacute;ments de bo&icirc;te de dialogue), ainsi que des images statiques (formes, tuyaux,
r&eacute;servoirs ou moteurs).
Vous pouvez glisser et d&eacute;poser un objet de la galerie vers la page, puis le dimensionner, le d&eacute;placer, le pivoter ou le
transformer. Tous les widgets de la galerie sont vectoriels, ils ne perdent donc pas de d&eacute;finition lorsqu'ils sont
redimensionn&eacute;s.
Cependant, vous pouvez modifier tous les widgets pr&eacute;d&eacute;finis pour cr&eacute;er votre widget personnalis&eacute;. Les widgets
personnalis&eacute;s peuvent &ecirc;tre cr&eacute;&eacute;s &agrave; partir de plusieurs &eacute;l&eacute;ments incluant seulement les propri&eacute;t&eacute;s n&eacute;cessaires pour leur
fonctionnement.
310
Cr&eacute;er un widget personnalis&eacute;
310
Ajouter des propri&eacute;t&eacute;s &agrave; un widget personnalis&eacute;
312
Utilisation de variables structur&eacute;es
314
JavaScript dans les widgets personnalis&eacute;s
316
Galerie de l’utilisateur
318
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
309
Cr&eacute;er un widget personnalis&eacute;
1. Glissez et d&eacute;posez sur une page tous les widgets que vous voulez utiliser pour composer votre widget
personnalis&eacute;.
2. S&eacute;lectionnez-les et groupez-les.
3. Faites un clic droit sur l’objet group&eacute; et s&eacute;lectionnez le Convertir en Widget : la bo&icirc;te de dialogue Catalogue de
Widgets personnalis&eacute;s s'affiche.
Param&egrave;tre
Description
Inclut des widgets
personnalis&eacute;s utilis&eacute;s
Une fois coch&eacute;, lister tous les widgets utilis&eacute;s &agrave; l'int&eacute;rieur du projet. M&ecirc;me les
widgets du syst&egrave;me
Nom
Vous pouvez d&eacute;finir tout ce que vous pr&eacute;f&eacute;rez, mais il est commun de garder
une structure de nom. Le dossier com.hmi est r&eacute;serv&eacute; aux widgets du syst&egrave;me
Description
Description du widget.
Version
Version du widget.
Tous les widgets qui partagent la m&ecirc;me version partagent les propri&eacute;t&eacute;s d&eacute;finies
&agrave; partir du param&egrave;tre d'h&eacute;ritage.
H&eacute;ritage
310
Propri&eacute;t&eacute;s partag&eacute;es entre widgets avec la m&ecirc;me version
l
Toutes (aussi bien graphique que logique)
l
Uniquement graphique
l
Uniquement logique
l
D&eacute;sactiver
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33 Widgets personnalis&eacute;s
Modifier un widget personnalis&eacute;
Double-cliquer pour s&eacute;lectionner le widget personnalis&eacute; en mode &eacute;dition. L'ic&ocirc;ne du cadenas vert indique que vous allez
modifier un widget personnalis&eacute;, plut&ocirc;t que juste un groupe de widgets. La diff&eacute;rence est que la modification sera propag&eacute;e
&agrave; tous les autres widgets personnalis&eacute;s avec la m&ecirc;me version qui sont configur&eacute;s pour h&eacute;riter des propri&eacute;t&eacute;s du widget.
Cliquer sur l'ic&ocirc;ne du cadenas pour activer le mode d'&eacute;dition, le cadenas sera ouvert. Cliquer &agrave; nouveau lorsque la
modification sera effectu&eacute;e.
Partager les propri&eacute;t&eacute;s
Lorsqu’un widget personnalis&eacute; est modifi&eacute;, toutes les modifications seront propag&eacute;es &agrave; tous les autres widgets
personnalis&eacute;s qui partage la m&ecirc;me version et qui sont configur&eacute;s pour h&eacute;riter des propri&eacute;t&eacute;s du widget.
Utiliser des composants de widgets
En g&eacute;n&eacute;ral, les widgets sont compos&eacute;s de nombreuses parties, par exemple un bouton est un widget complexe qui inclut
deux widgets d'image, un widget de bouton et une &eacute;tiquette.
Pour afficher une liste de tous les &eacute;l&eacute;ments qui font partie d'un widget, s&eacute;lectionnez le widget, ouvrir le cadenas et ouvrir le
volet VueObjet : tous les &eacute;l&eacute;ments composant un widget complexe sont list&eacute;s en ordre hi&eacute;rarchique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
311
Ajouter des propri&eacute;t&eacute;s &agrave; un widget personnalis&eacute;
Pour s&eacute;lectionner un seul widget, le s&eacute;lectionner directement depuis le volet VueObjet.
Ajouter des propri&eacute;t&eacute;s &agrave; un widget personnalis&eacute;
Lorsque vous cr&eacute;ez un widget personnalis&eacute;, vous devez d&eacute;finir les propri&eacute;t&eacute;s qui seront affich&eacute;es pour ce widget dans le
volet Propri&eacute;t&eacute;s.
1. Faites un clic droit sur l’objet group&eacute; et s&eacute;lectionnez le Catalogue Widget : la bo&icirc;te de dialogue des propri&eacute;t&eacute;s
s'affichent.
312
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33 Widgets personnalis&eacute;s
2. Cliquez sur + pour ouvrir la bo&icirc;te de dialogue S&eacute;lection des propri&eacute;t&eacute;s : elle liste toutes les propri&eacute;t&eacute;s de tous les
widgets group&eacute;s.
3. S&eacute;lectionnez les propri&eacute;t&eacute;s que vous voulez d&eacute;finir pour votre widget personnalis&eacute;.
4. D&eacute;finissez les d&eacute;tails de chaque propri&eacute;t&eacute;.
Notez que vous pouvez cr&eacute;er des dossiers et utiliser la fonction glisser-d&eacute;poser pour d&eacute;placer ou de r&eacute;organiser
la liste des Propri&eacute;t&eacute;s
Param&egrave;tre
Description
Propri&eacute;t&eacute;s
Nom affich&eacute; dans le volet Propri&eacute;t&eacute;s.
Description
Tout commentaire sur la propri&eacute;t&eacute; &agrave; afficher dans le volet Propri&eacute;t&eacute;s.
ID
Le nom affich&eacute; par AGI Creator &agrave; des fonctions JavaScript et &agrave; la bo&icirc;te de dialogue variable
associ&eacute;e.
Prise en charge des
variables
Sp&eacute;cifie si la propri&eacute;t&eacute; prend en charge l'attribut &laquo; Associer &agrave; &raquo;.
Read only
Propri&eacute;t&eacute; expos&eacute;e uniquement en mode de lecture
Param&egrave;tres avanc&eacute;s
Sp&eacute;cifie si chaque propri&eacute;t&eacute; doit appara&icirc;tre dans le mode d'affichage avanc&eacute; ou simple du
volet Propri&eacute;t&eacute;s.
Propri&eacute;t&eacute;s alias
Propri&eacute;t&eacute;s internes li&eacute;es &agrave; la propri&eacute;t&eacute; expos&eacute;e
Associer des propri&eacute;t&eacute;s
Pour associer deux propri&eacute;t&eacute;s ou plus :
1. S&eacute;lectionnez la propri&eacute;t&eacute; primaire dans la bo&icirc;te de dialogue de la liste des Propri&eacute;t&eacute;s.
2. Cliquez sur + dans la barre d'outils propri&eacute;t&eacute;s alias : la bo&icirc;te de dialogue S&eacute;lectionner propri&eacute;t&eacute; s’affiche.
3. S&eacute;lectionnez les propri&eacute;t&eacute;s que vous voulez associer.
4. Cliquez sur OK : les attributs combin&eacute;s s'afficheront dans la zone de liste Propri&eacute;t&eacute;s alias.
Exemple
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
313
Utilisation de variables structur&eacute;es
Si vous ins&eacute;rez dans une propri&eacute;t&eacute; &laquo; Couleur &raquo;, la couleur de remplissage de tous les widgets (par ex., filed1.fill et
BtnStd4.btn.fill) lorsque vous d&eacute;finissez la propri&eacute;t&eacute; Couleur expos&eacute;e du widgets personnalis&eacute;, toutes les couleurs des
widgets inclus changeront.
Utilisation de variables structur&eacute;es
Un probl&egrave;me commun en utilisant un widget qui utilisent de nombreuses variables est la n&eacute;cessit&eacute; de cr&eacute;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&egrave;ce, la temp&eacute;rature, l'humidit&eacute; et la
pression. Si nous voulons utiliser deux instances de ce widget pour deux pi&egrave;ces diff&eacute;rentes, nous devons configurer huit
variables, quatre variables pour chaque pi&egrave;ce.
En utilisant une propri&eacute;t&eacute; de param&egrave;tre, il est possible de d&eacute;finir toutes les liaisons de donn&eacute;es du widget en donnant
uniquement le nom de la structure.
Un champ &laquo; Param&egrave;tre &raquo; peut &ecirc;tre ajout&eacute; &agrave; l'int&eacute;rieur du widget personnalis&eacute; en utilisant l'ic&ocirc;ne &laquo; Ajouter Param&egrave;tre &raquo; :
314
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33 Widgets personnalis&eacute;s
Pour configurer les liaisons de donn&eacute;es du widget personnalis&eacute;, le mot-cl&eacute; ${RoomID} peut &ecirc;tre utilis&eacute; pour faire r&eacute;f&eacute;rence
&agrave; l'instance de structure
Filtre type
Utilisation du param&egrave;tre &laquo; Filtre type &raquo;, quand attacher &agrave; la variable est ouvert, les variables r&eacute;pertori&eacute;es seront filtr&eacute;es en
utilisant la valeur de filtre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
315
JavaScript dans les widgets personnalis&eacute;s
JavaScript dans les widgets personnalis&eacute;s
Les fonctions JavaScript peuvent &ecirc;tre int&eacute;gr&eacute;es dans les widgets personnalis&eacute;s.
Apr&egrave;s avoir double-cliquer sur le widget personnalis&eacute; et cliqu&eacute; sur le cadenas, le mode d'&eacute;dition est actif et il est possible
d'associer le code JavaScript pour les &eacute;v&eacute;nements disponibles.
316
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33 Widgets personnalis&eacute;s
Noter l'utilisation de l'op&eacute;rateur this. qui est n&eacute;cessaire pour permettre l'instance multiple du widget personnalis&eacute;.
Si vous avez besoin de faire r&eacute;f&eacute;rence &agrave; un &eacute;l&eacute;ment du widget, vous pouvez utiliser le mot-cl&eacute; wgt.it pour r&eacute;f&eacute;rencer &agrave;
l'identifiant de l'instance de widget active, comme pour l'exemple ci-dessous :
Si vous coupez et collez des instances du widget personnalis&eacute; de l'exemple ci-dessus, vous obtiendrez le r&eacute;sultat cidessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
317
Galerie de l’utilisateur
Noter que le widget personnalis&eacute; peut aussi passer &agrave; l'int&eacute;rieur de la galerie de l'utilisateur pour une r&eacute;utilisation
ult&eacute;rieure.
Galerie de l’utilisateur
Vous pouvez sauvegarder les widgets cr&eacute;&eacute;s par les d&eacute;veloppeurs dans la galerie des widgets, afin de pouvoir les utiliser
durant le d&eacute;veloppement de nouveaux projets.
Barre d'outils widgets utilisateur
Commande
Description
Ouvrez le dossier des widgets s&eacute;lectionn&eacute;s dans l'&eacute;diteur AGI Creator
Ajoutez un nouveau dossier de widgets
Effacez le dossier actuellement s&eacute;lectionn&eacute;
S&eacute;lectionnez le dossier des widgets utilisateur
Pour ajouter un nouveau widget dans la galerie utilisateur, ouvrez le dossier de widgets, puis &eacute;ditez la page de galeries en
cr&eacute;ant ou en ajoutant le nouveau widget.
Astuce : Pour importer un sous-dossier galerie utilisateur, copiez simplement le dossier &agrave; importer et collez-le
dans le principal fichier galerie utilisateur.
318
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
33 Widgets personnalis&eacute;s
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
319
Galerie de l’utilisateur
320
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
34
Envoyer un message par e-mail
Envoyer des e-mails &agrave; l'aide de l'action E-mailEnvoy&eacute;, y compris les variables dans le corps et les pi&egrave;ces jointes du
message.
L'action E-mailEnvoy&eacute; a &eacute;t&eacute; cr&eacute;&eacute;e pour travailler avec les alarmes et les planificateurs, mais peut &ecirc;tre d&eacute;clench&eacute;e et
ex&eacute;cut&eacute;e par de nombreux autres &eacute;v&eacute;nements.
Configurer le serveur e-mail
322
Configurer les e-mails
322
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&egrave;tre ConfigEmail :
Param&egrave;tre
Description
Adresse SMTP
Adresse de serveur SMTP.
Port de serveur
Port pour la connexion au serveur SMTP (par d&eacute;faut = 25).
Requiert
authentification
S&eacute;lectionnez ce param&egrave;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&egrave;tres du serveur de mani&egrave;re dynamique depuis
la HMI Runtime.
Configurer les e-mails
Entrez les informations suivantes pour le param&egrave;tre InfoEmail :
Param&egrave;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&eacute;diteur (par exemple, John@domain.com).
&Agrave;
Adresses e-mail des destinataires. Pour entrer plusieurs adresses, s&eacute;parez-les avec un pointvirgule.
Objet
Objet de l'e-mail.
Pi&egrave;ce
jointe
Le chemin du fichier est envoy&eacute; en pi&egrave;ce jointe. Seule une pi&egrave;ce jointe &agrave; la fois peut &ecirc;tre
envoy&eacute;e.
Note : La taille maximale des pi&egrave;ces jointes est g&eacute;n&eacute;ralement d&eacute;finie par le serveur
SMTP.
Texte
Contenu principal de l'e-mail. Vous pouvez y ins&eacute;rer des variables live lorsque vous les
incluez entre crochets.
Par exemple, un corps de message &laquo; Valeur Tag1 est [Tag1] &raquo; est envoy&eacute; comme &laquo; Valeur
Tag1 est 45 &raquo;, si la valeur actuelle de Tag1 est 45.
322
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
34 Envoyer un message par e-mail
Astuce : Associez une variable de cha&icirc;ne aux champs De, &Agrave; et Objet pour que leurs valeurs soient chang&eacute;es
dans le HMI Runtime.
AVERTISSEMENT : La taille maximale du corps du message est de 4096 octets, le texte qui d&eacute;passe
sera tronqu&eacute;.
Ajouter des mod&egrave;les d'e-mails
Cliquez sur + pour ajouter plus de mod&egrave;les.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
323
Configurer les e-mails
324
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35
JavaScript
L'objectif de cette section est de d&eacute;crire comment est utilis&eacute; JavaScript dans les applications AGI Creator. Il n'a en
revanche pas pour but d'expliquer le langage JavaScript lui-m&ecirc;me.
JavaScript AGI Creatorse base sur le langage de programmation ECMAScript http://www.ecmascript.org , tel que d&eacute;fini
par la norme ECMA-262.
Si vous ma&icirc;trisez JavaScript, vous pouvez utiliser le m&ecirc;me type de commandes dans AGI Creatorque celles que vous
utiliseriez dans un navigateur web. Si vous ne ma&icirc;trisez pas le langage ECMAScript, veuillez consulter la page :
https://developer.mozilla.org/en/JavaScript
&Eacute;diteur JavaScript
327
Ex&eacute;cution des fonctions JavaScript
327
&Eacute;v&eacute;nements
329
&Eacute;v&eacute;nements de widget
330
&Eacute;v&eacute;nements de page
334
&Eacute;v&eacute;nements syst&egrave;me
335
Objets
336
Objets de classe widget
337
Propri&eacute;t&eacute;s du widget
338
M&eacute;thodes du widget
340
Objet de page
342
Propri&eacute;t&eacute;s de l'objet de page
342
M&eacute;thodes associ&eacute;es &agrave; l'objet de page
343
Objet de groupe
345
M&eacute;thodes d'objet de groupe
345
Objet du projet
346
Propri&eacute;t&eacute;s d'objet du projet
346
M&eacute;thodes d'objet du projet
347
Widgets d'objet du projet
357
Objet d'&eacute;tat
358
M&eacute;thodes d'objet d’&eacute;tat
358
Mots-cl&eacute;s
359
Fonctions g&eacute;n&eacute;rales
360
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
325
Prendre en main la lecture/l’&eacute;criture de fichiers
360
Limites lors du travail avec des widgets en JavaScript
363
D&eacute;boguer JavaScript
364
326
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
&Eacute;diteur JavaScript
AGI Creator inclut un &eacute;diteur JavaScript puissant.
Double-cliquez sur l'&eacute;diteur pour afficher l'ensemble des commandes disponibles.
Ex&eacute;cution des fonctions JavaScript
Les fonctions JavaScript sont ex&eacute;cut&eacute;es lorsque des &eacute;v&eacute;nements se produisent. Par exemple, un utilisateur peut d&eacute;finir un
script pour l'&eacute;v&eacute;nement OnMouseClick et le script JavaScript est ex&eacute;cut&eacute; lorsque vous appuyez sur le bouton sur le
p&eacute;riph&eacute;rique IHM.
Les fonctions JavaScript sont ex&eacute;cut&eacute;es uniquement lorsque l'&eacute;v&eacute;nement programm&eacute; se produit et n'est pas cyclique.
Cette approche minimise le traitement requis pour ex&eacute;cuter une logique dans le p&eacute;riph&eacute;rique IHM.
AGI Creator fournit un moteur JavaScript fonctionnant au niveau du client. Chaque page de projet peut contenir des scripts
ayant une &eacute;tendue locale sur la page o&ugrave; ils sont ajout&eacute;s. Vous pouvez cr&eacute;er des scripts globaux pour qu'ils soient ex&eacute;cut&eacute;s
par des &eacute;v&eacute;nements de planificateur ou par des &eacute;v&eacute;nements d'alarme.
Dans les deux cas, les scripts sont ex&eacute;cut&eacute;s sur le client. Cela signifie que lorsque plus d'un client est connect&eacute; au
p&eacute;riph&eacute;rique IHM (pour un ordinateur externe ex&eacute;cutant le AGI Client), chaque client ex&eacute;cute le m&ecirc;me script, fournissant
des r&eacute;sultats de sortie diff&eacute;rents selon l'entr&eacute;e, puisque les entr&eacute;es fournies &agrave; diff&eacute;rents clients peuvent &ecirc;tre diff&eacute;rentes.
Par exemple, si un script agit selon la position d'une barre de d&eacute;filement et que cette position est diff&eacute;rente sur les
diff&eacute;rents clients, le r&eacute;sultat du script sera diff&eacute;rent sur chaque client.
Fonctions JavaScript pour &eacute;v&eacute;nements de page
L'&eacute;diteur JavaScript s'ouvre lorsque vous ajoutez une action JavaScript dans une liste d'actions.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
327
Ex&eacute;cution des fonctions JavaScript
1. S&eacute;lectionnez l'&eacute;v&eacute;nement qui ex&eacute;cute l'action.
2. Ajoutez une action JavaScript de la cat&eacute;gorie Widget.
3. Laissez le nom de fonction par d&eacute;faut ou tapez-en un nouveau.
4. Cliquez sur OK pour confirmer : l'&eacute;diteur JavaScript affiche la structure de votre fonction.
Vous pouvez aussi ouvrir l'&eacute;diteur JavaScript depuis l'onglet Script situ&eacute; en bas de l'espace de travail.
Fonctions JavaScript pour les alarmes et les &eacute;v&eacute;nements programm&eacute;s
Le code JavaScript, associ&eacute; aux alarmes et aux &eacute;v&eacute;nements, qui n'est pas associ&eacute; &agrave; une page sp&eacute;cifique peut &ecirc;tre &eacute;dit&eacute;
depuis la page principale Propri&eacute;t&eacute;s projet.
Chemin : VueProjet&gt; double-cliquez sur Propri&eacute;t&eacute;s projet
328
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Note : Les actions JavaScript sont des actions client, elles sont donc ex&eacute;cut&eacute;es uniquement lorsqu'un client est
connect&eacute;.
Code JavaScript partag&eacute;
La variable globale du projet peut &ecirc;tre utilis&eacute;e pour partager du code JavaScript entre les pages. Les variables sont
cr&eacute;&eacute;es/initialis&eacute;es depuis le code JavaScript principal depuis la page Propri&eacute;t&eacute;s projet principale et peuvent ensuite &ecirc;tre
utilis&eacute;es depuis les pages du projet.
&Eacute;v&eacute;nements
Vous pouvez ajouter JavaScript aux cat&eacute;gories d'&eacute;v&eacute;nements suivantes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
329
&Eacute;v&eacute;nements de widget
l
&Eacute;v&eacute;nements de widget
l
&Eacute;v&eacute;nements de page
l
&Eacute;v&eacute;nements syst&egrave;me
Pour les &eacute;v&eacute;nements de type :
l
OnMousePress
l
OnMouseRelease
l
OnMouseClick
l
OnWheel
Le param&egrave;tre Infos &eacute;v&eacute;nement de JavaScript contient les propri&eacute;t&eacute;s suppl&eacute;mentaires suivantes :
Param&egrave;tre
Description
eventInfo.posX
Coordonn&eacute;e de la souris locale/touche X par rapport aux coordonn&eacute;es du widget
eventInfo.posY
Coordonn&eacute;e de la souris locale/touche Y par rapport aux coordonn&eacute;es du widget
eventInfo.pagePosX
Coordonn&eacute;e de la souris/touche de la page X
eventInfo.pagePosY
Coordonn&eacute;e de la souris/touche de la page Y
eventInfo.wheelDelta Delta de la molette de la souris. Valeur enti&egrave;re avec un signe repr&eacute;sentant la
direction de rotation.
La valeur r&eacute;elle est le nombre de rotations en huiti&egrave;mes de degr&eacute;. La valeur
minimale d&eacute;pend de la r&eacute;solution de la souris. Elle est en g&eacute;n&eacute;ral de 120, ce qui
correspond &agrave; 15 degr&eacute;s.
&Eacute;v&eacute;nements de widget
onMouseClick
void onMouseClick (me, eventInfo)
Cet &eacute;v&eacute;nement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfonc&eacute; et rel&acirc;ch&eacute;
rapidement.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function buttonStd1_onMouseClick(me, eventInfo) {
//do something…
}
330
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
onMouseHold
void onMouseHold (me, eventInfo)
Cet &eacute;v&eacute;nement est disponible uniquement pour les boutons et il se produit lorsque le bouton est enfonc&eacute; et rel&acirc;ch&eacute; apr&egrave;s le
nombre de secondes d&eacute;fini comme temps de maintien dans les propri&eacute;t&eacute;s du widget.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function buttonStd1_onMouseHold(me, eventInfo) {
//do something…
}
onMousePress
void onMousePress (me, eventInfo)
Cet &eacute;v&eacute;nement est disponible uniquement pour les boutons et il se produit lorsque l’on appuie sur le bouton.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function buttonStd1_onMousePress(me, eventInfo) {
//do something…
}
onMouseRelease
void onMouseRelease (me, eventInfo)
Cet &eacute;v&eacute;nement est disponible uniquement pour les boutons et il se produit lorsque l’on rel&acirc;che le bouton.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function buttonStd1_onMouseRelease(me, eventInfo) {
//do something…
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
331
&Eacute;v&eacute;nements de widget
onDataUpdate
boolean onDataUpdate (me, eventInfo)
Cet &eacute;v&eacute;nement se produit lorsque les donn&eacute;es associ&eacute;es au widget changent.
Param&egrave;tre Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
Un objet avec les champs indiqu&eacute;s ci-dessous (vous pouvez vous r&eacute;f&eacute;rer aux champs en utilisant “.” notation du point)
oldValue = Valeur du widget avant le changement
newValue = Valeur qui sera actualis&eacute;e au widget
attrName = Attribut sur lequel l'&eacute;v&eacute;nement est g&eacute;n&eacute;r&eacute;
index = Index d'attribut entier, le cas &eacute;ch&eacute;ant, par d&eacute;faut = 0
mode = W lorsque l'utilisateur est en train d'&eacute;crire au widget. R dans tous les autres statuts.
L'&eacute;v&eacute;nement est d&eacute;clench&eacute; avant que la valeur soit pass&eacute;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&egrave;s avoir termin&eacute; le code avec retour faux, le contr&ocirc;le est renvoy&eacute;
au widget d'appel qui peut lancer d'autres actions.
Apr&egrave;s avoir termin&eacute; le code avec vrai, le contr&ocirc;le n’est pas retourn&eacute; au widget et cela fait en sorte qu'aucune autre action
n’est ex&eacute;cut&eacute;e apr&egrave;s l'&eacute;v&eacute;nement d'appel.
function buttonStd1_onDataUpdate(me, eventInfo) {
if ( eventInfo.oldValue &lt; 0) {
//do something…
}
retour faux ;
}
OnPan
boolean onGesturePan (me, eventInfo)
Cet &eacute;v&eacute;nement est uniquement disponible pour les boutons de la zone geste ; il se produit lorsqu’un point &agrave; l'int&eacute;rieur de la
zone a &eacute;t&eacute; appuy&eacute; et qu’un mouvement a &eacute;t&eacute; d&eacute;tect&eacute;.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement.
eventInfo
id = Gesture id ; utilis&eacute; pour identifier les diff&eacute;rents gestes.
running = Vrai, sauf pour le dernier &eacute;v&eacute;nement livr&eacute; pour informer l’ach&egrave;vement du geste.
dx = Total de mouvements de l'axe X en unit&eacute;s de pixels de l'&eacute;cran depuis la position initiale de contact.
332
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Param&egrave;tre
Description
dy = Total de mouvements de l'axe Y en unit&eacute;s de pixels de l'&eacute;cran depuis la position initiale de contact.
function gstArea_onGesturePan(me, eventInfo)
{
wTYPE.setProperty(&quot;value&quot;,&quot;PAN&quot;);
wID.setProperty(&quot;value&quot;,eventInfo.id);
wDX.setProperty(&quot;value&quot;,eventInfo.dx);
wDY.setProperty(&quot;value&quot;,eventInfo.dy);
wRUN.setProperty(&quot;value&quot;,eventInfo.running);
}
OnPinch
boolean onGesturePinch(me, eventInfo)
Cet &eacute;v&eacute;nement est uniquement disponible pour les boutons de la zone geste ; il se produit lorsque deux points &agrave; l'int&eacute;rieur
de la zone ont &eacute;t&eacute; appuy&eacute;s et qu’un mouvement a &eacute;t&eacute; d&eacute;tect&eacute;.
AVERTISSEMENT : Seuls les dispositifs IHM multi-touch peuvent g&eacute;n&eacute;rer des &eacute;v&eacute;nements de
pincement
Param&egrave;tre Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
id = Gesture id ; utilis&eacute; pour identifier les diff&eacute;rents gestes.
running = Vrai, sauf pour le dernier &eacute;v&eacute;nement livr&eacute; pour informer l’ach&egrave;vement du geste.
dx = Total de mouvements de l'axe X en unit&eacute;s de pixels de l'&eacute;cran depuis la position initiale de contact. Il
repr&eacute;sente le changement de distance entre les doigts. La valeur positive signifie que la distance
augmente ; La valeur n&eacute;gative signifie que la distance diminue. Cette quantit&eacute; peut &ecirc;tre utilis&eacute;e pour
contr&ocirc;ler une valeur de zoom.
dy = Total de mouvements de l'axe Y en unit&eacute;s de pixels (voir dx).
function gstArea_onGesturePinch(me, eventInfo)
{
wTYPE.setProperty(&quot;value&quot;,&quot;PINCH&quot;);
wID.setProperty(&quot;value&quot;,eventInfo.id);
wDX.setProperty(&quot;value&quot;,eventInfo.dx);
wDY.setProperty(&quot;value&quot;,eventInfo.dy);
wRUN.setProperty(&quot;value&quot;,eventInfo.running);
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
333
&Eacute;v&eacute;nements de page
&Eacute;v&eacute;nements de page
onActivate
void onActivate( me, eventInfo )
Cet &eacute;v&eacute;nement survient toutes les fois que la page s'affiche.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
R&eacute;serv&eacute;s &agrave; une utilisation ult&eacute;rieure
JavaScript sera ex&eacute;cut&eacute; lorsque la page sera active, autrement dit lorsque la page sera charg&eacute;e.
function Page1_onActivate(me, eventInfo) {
//do something…
}
onDeactivate
void onDeactivate( me, eventInfo )
Cet &eacute;v&eacute;nement survient lorsque vous quittez la page.
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
R&eacute;serv&eacute;s &agrave; une utilisation ult&eacute;rieure
function Page1_onDeactivate(me, eventInfo) {
//do something…
}
onWheel
void onDeactivate( me, eventInfo )
Cet &eacute;v&eacute;nement survient lorsqu'un dispositif &agrave; molette bouge (par exemple, une molette de souris).
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function Page1_onMouseWheelClock(me, eventInfo) {
334
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
//do something…
}
&Eacute;v&eacute;nements syst&egrave;me
Les &eacute;v&eacute;nements de syst&egrave;me peuvent &ecirc;tre li&eacute;s &agrave; :
l
planificateur
l
des alarmes
l
un p&eacute;riph&eacute;rique &agrave; 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-&agrave;-dire deux fonctions avec le m&ecirc;me nom dans la page
en cours et au niveau du projet, le syst&egrave;me ex&eacute;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&egrave;me recherche automatiquement au niveau du
projet.
&Eacute;v&eacute;nements planificateur
Ces &eacute;v&eacute;nements se produisent lorsqu'ils sont d&eacute;clench&eacute;s par l'action associ&eacute;e dans le planificateur.
Vous pouvez modifier le JavaScript depuis l'onglet Propri&eacute;t&eacute;s du projet.
&Eacute;v&eacute;nements d’alarmes
Ces &eacute;v&eacute;nements se produisent lorsqu'ils sont d&eacute;clench&eacute;s par la condition d'alarme associ&eacute;e.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
335
Objets
Vous pouvez modifier le JavaScript depuis l'onglet Propri&eacute;t&eacute;s du projet.
onWheel
void onDeactivate( me, eventInfo )
Cet &eacute;v&eacute;nement survient lorsqu'un dispositif &agrave; molette bouge (par exemple, une molette de souris).
Param&egrave;tre
Description
me
Objet d&eacute;clencheur de l'&eacute;v&eacute;nement
eventInfo
D&eacute;tails sur l'&eacute;v&eacute;nement d&eacute;clench&eacute;
function Project1_onMouseWheelClock(me, eventInfo) {
//do something…
}
Objets
AGI Creator utilise des objets JavaScript pour acc&eacute;der aux &eacute;l&eacute;ments de la page. Chaque objet se compose de propri&eacute;t&eacute;s et
de m&eacute;thodes utilis&eacute;es pour d&eacute;finir l'op&eacute;ration et l'aspect de l'&eacute;l&eacute;ment de page. Les objets suivants sont utilis&eacute;s pour
interagir avec les &eacute;l&eacute;ments de la page du p&eacute;riph&eacute;rique IHM :
Objet
Description
Widget
C'est la classe de base pour l'ensemble des
&eacute;l&eacute;ments sur la page, &eacute;l&eacute;ment de page inclus
Page
Cet objet r&eacute;f&eacute;rence la page actuelle du p&eacute;riph&eacute;rique
336
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Objet
Description
IHM. La page est l'objet sup&eacute;rieur de l'&eacute;cran.
Groupe
Cet objet associe un ensemble de variables pour
permettre un fonctionnement uniforme sur un
ensemble de variables logiquement connect&eacute;es
Projet
Cet objet d&eacute;finit le widget de projet. Le widget de
projet est utilis&eacute; pour r&eacute;cup&eacute;rer les donn&eacute;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 &ecirc;tre r&eacute;f&eacute;renc&eacute; par
les variables du projet.
&Eacute;tat
Cet objet est la classe maintenant l'&eacute;tat d'une
variable obtenue &agrave; partir de l'environnement
contr&ocirc;l&eacute;. En plus de la valeur elle-m&ecirc;me, il contient
l'horodatage indiquant &agrave; quel moment la valeur a &eacute;t&eacute;
collect&eacute;e ainsi que les drapeaux signalant la qualit&eacute;
de la valeur.
Objets de classe widget
La classe de Widget est la base pour l'ensemble des &eacute;l&eacute;ments sur une page, &eacute;l&eacute;ment de page inclus.
Le widget, dans ce cas, ne sert pas &agrave; indiquer un objet d'&eacute;cran sp&eacute;cifique, mais une classe JavaScript.
Changer les propri&eacute;t&eacute;s du widget avec JavaScript
Si vous souhaitez modifier les propri&eacute;t&eacute;s des widgets avec JavaScript, d&eacute;finir la propri&eacute;t&eacute; du widget de l'optimisation
statique &agrave; dynamique.
Important : Si la propri&eacute;t&eacute; widget de l'optimisation statique n’est pas r&eacute;gl&eacute;e sur dynamique, les
modifications apport&eacute;es aux propri&eacute;t&eacute;s seront ignor&eacute;es.
Si un appel &agrave; getWidget &eacute;choue, le d&eacute;bogueur distant signale l'erreur suivante :
&laquo; Essai pour acc&eacute;der au widget statique optimis&eacute; &laquo; &eacute;tiquette1 &raquo;. D&eacute;sactiver l'optimisation statique du widget pour acc&eacute;der
&agrave; un widget depuis le script &raquo;.
Cette erreur est &eacute;galement visible en utilisant le fragment de code suivant :
var wgt;
try {
wgt = page.getWidget('label1');
} catch(err) {
alert(&quot;&quot; + err);
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
337
Propri&eacute;t&eacute;s du widget
Propri&eacute;t&eacute;s du widget
Certaines propri&eacute;t&eacute;s sont communes &agrave; tous les widgets.
objectName
string objectName
Obtenez le nom du widget, un identifiant unique.
function btnStd04_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
var name = wgt.objectName;
}
(Disponible sur pages Web)
x
number x
Obtenez ou d&eacute;finissez la position &laquo; x &raquo; du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.x = 10;
}
(Disponible sur pages Web)
y
number y
Obtenez ou d&eacute;finissez la position &laquo; y &raquo; du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.y = 10;
}
(Disponible sur pages Web)
width
number width
Obtenez ou d&eacute;finissez la position &laquo; y &raquo; du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
338
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.width = 10;
}
(Disponible sur pages Web)
height
number height
Obtenez ou d&eacute;finissez la hauteur du widget dans les pixels.
function btnStd1_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.height = 10;
}
(Disponible sur pages Web)
visible
boolean visible
Obtenez ou d&eacute;finissez l’&eacute;tat visible du widget.
function btnStd4_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.visible = false;
}
function btnStd5_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.visible = true;
}
value
number value
Obtenez ou d&eacute;finissez la valeur du widget.
function btnStd6_onMouseRelease(me) {
var wgt = page.getWidget(&quot;field1&quot;);
wgt.value = 100;
}
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
339
M&eacute;thodes du widget
opacity
number opacity (range from 0 to 1)
Obtenez ou d&eacute;finissez l’opacit&eacute; du widget. Les valeurs sont des d&eacute;cimales de 0 &agrave; 1, o&ugrave; 1 est 100 % opaque.
function btnStd8_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
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&eacute;s, en
commen&ccedil;ant &agrave; la position Est.
function btnStd9_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.rotation = 45;
}
(Disponible sur pages Web)
userValue
string userValue
Obtient ou &eacute;tablit une valeur d&eacute;finie par l'utilisateur pour le widget. Ce champ peut &ecirc;tre utilis&eacute; par les fonctions JavaScript
pour stocker des donn&eacute;es suppl&eacute;mentaires avec la widget.
function btnStd9_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
wgt.userValue = &quot;Here I can store custom data&quot;;
}
Chaque widget a des propri&eacute;t&eacute;s sp&eacute;cifiques auxquelles vous pouvez acc&eacute;der en utilisant la notation du point. Pour obtenir
une liste actualis&eacute;e et d&eacute;taill&eacute;e des propri&eacute;t&eacute;s, vous pouvez utiliser le D&eacute;bogueur JavaScript qui inspecte les m&eacute;thodes et
les propri&eacute;t&eacute;s de widget.
M&eacute;thodes du widget
Certaines m&eacute;thodes sont communes &agrave; tous les widgets.
getProperty
object getProperty( propertyName, [index] )
340
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Revient &agrave; une propri&eacute;t&eacute;.
Param&egrave;tre
Description
propertyName
Cha&icirc;ne contenant le nom de la propri&eacute;t&eacute; &agrave; obtenir
index
Index de l'&eacute;l&eacute;ment &agrave; obtenir &agrave; partir du tableau (par d&eacute;faut = 0)
Presque toutes les propri&eacute;t&eacute;s qui sont affich&eacute;es dans le AGI Creator voletPropri&eacute;t&eacute;s peuvent &ecirc;tre r&eacute;cup&eacute;r&eacute;es en utilisant
la m&eacute;thode getProperty. La valeur de l'indice est facultative et est uniquement utilis&eacute;e pour les widgets qui prennent en
charge des tableaux.
function buttonStd1_onMouseRelease(me, eventInfo) {
var shape = page.getWidget(&quot;rect2&quot;);
var y_position = shape.getProperty(&quot;y&quot;);
}
function buttonStd2_onMouseRelease(me, eventInfo) {
var image = page.getWidget(&quot;multistate1&quot;);
var image3 = image.getProperty(&quot;imageList&quot;, 2);
//…
}
(Disponible sur pages Web)
setProperty
boolean setProperty( propertyName, value, [index] )
D&eacute;finissez une propri&eacute;t&eacute; pour le widget.
Param&egrave;tres
Param&egrave;tre
Description
propertyName
Cha&icirc;ne contenant le nom de la propri&eacute;t&eacute; &agrave; d&eacute;finir
value
Cha&icirc;ne contenant la valeur &agrave; d&eacute;finir la propri&eacute;t&eacute;.
index
Index de l'&eacute;l&eacute;ment &agrave; d&eacute;finir &agrave; partir du tableau (par d&eacute;faut = 0)
Presque toutes les propri&eacute;t&eacute;s qui sont affich&eacute;es dans le AGI Creator voletPropri&eacute;t&eacute;s peuvent &ecirc;tre d&eacute;finie par cette
m&eacute;thode. La valeur de l'indice est facultative et est uniquement utilis&eacute;e pour les Widgets qui prennent en charge des
tableaux (par exemple, un widget Image Multi-&eacute;tat). La m&eacute;thode setProperty retourne une valeur bool&eacute;enne (vrai ou
faux) pour indiquer si la propri&eacute;t&eacute; a &eacute;t&eacute; d&eacute;finie ou non.
function buttonStd1_onMouseRelease(me, eventInfo) {
var setting_result = shape.setProperty(&quot;y&quot;, 128);
if (setting_result)
alert(&quot;Shape returned to start position&quot;);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
341
Objet de page
}
function buttonStd2_onMouseRelease(me, eventInfo) {
var image = page.getWidget(&quot;multistate1&quot;);
var result = image.setProperty(&quot;imageList&quot;, &quot;Fract004.png&quot;, 2);
//…
}
(Disponible sur pages Web)
Objet de page
Cet objet r&eacute;f&eacute;rence la page actuelle du p&eacute;riph&eacute;rique IHM. La page est l'objet sup&eacute;rieur de l'&eacute;cran.
Propri&eacute;t&eacute;s de l'objet de page
Propri&eacute;t&eacute;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 = &quot;rgb(128,0,0)&quot;;
}
(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&eacute;cup&eacute;ration uniquement)
height
number height
Hauteur de la page en pixels.
342
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
function btnStd05_onMouseRelease(me) {
var middle_y = page.height / 2;
}
(Disponible sur pages Web, avec r&eacute;cup&eacute;ration uniquement)
userValue
string userValue
Obtient ou &eacute;tablit une valeur d&eacute;finie par l'utilisateur pour le widget. Ce champ peut &ecirc;tre utilis&eacute; par les fonctions JavaScript
pour stocker des donn&eacute;es suppl&eacute;mentaires avec la page.
function btnStd9_onMouseRelease(me) {
page.userValue = &quot;Here I can store custom data&quot;;
}
(Disponible sur pages Web)
M&eacute;thodes associ&eacute;es &agrave; l'objet de page
M&eacute;thodes pouvant &ecirc;tre utilis&eacute;es au niveau de la page.
getWidget
object getWidget( wgtName )
Retourne le widget portant le nom indiqu&eacute;.
Param&egrave;tre
Description
wgtName
Cha&icirc;ne contenant le nom du widget
Valeur de retour
Un objet repr&eacute;sentant le widget. Si le widget n'existe pas, le retour sera nul.
function btnStd1_onMouseRelease(me) {
var my_button = page.getWidget(&quot;btnStd1&quot;);
}
(Disponible sur pages Web)
setTimeout
number setTimeout( functionName, delay )
D&eacute;marre un minuteur qui appelle une fonction donn&eacute;e apr&egrave;s un d&eacute;lai donn&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
343
M&eacute;thodes associ&eacute;es &agrave; l'objet de page
Param&egrave;tre
Description
functionName
Cha&icirc;ne contenant le nom de la fonction &agrave; appeler
retard
D&eacute;lai en milli&egrave;mes de secondes
Valeur de retour
Nombre correspondant au timerID.
var duration = 3000;
var myTimer = page.setTimeout(&quot;innerChangeWidth()&quot;, duration);
(Disponible sur pages Web)
clearTimeout
void clearTimeout( timerID )
Interrompt et efface le minuteur de d&eacute;lai d'attente avec le minuteur indiqu&eacute;.
Param&egrave;tre
Description
timerID
Minuteur &agrave; effacer et interrompre
var duration = 3000;
var myTimer = page.setTimeout(&quot;innerChangeWidth()&quot;, duration);
// do something
page.clearTimeout(myTimer);
(Disponible sur pages Web)
setInterval
number setInterval( functionName, interval )
D&eacute;marre un minuteur qui ex&eacute;cute la fonction indiqu&eacute;e selon l'intervalle indiqu&eacute;.
Param&egrave;tre
Description
functionName
Cha&icirc;ne contenant le nom de la fonction &agrave; appeler
interval
Intervalle en milli&egrave;mes de secondes
Valeur de retour
Nombre correspondant au timerID.
var interval = 3000;
var myTimer = page.setInterval(&quot;innerChangeWidth()&quot;, interval);
(Disponible sur pages Web)
344
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
clearInterval
void clearInterval( timerID )
Interrompt et efface le minuteur &agrave; intervalle avec le minuteur indiqu&eacute;.
Param&egrave;tre
Description
timerID
Minuteur &agrave; effacer et interrompre
var interval = 3000;
var myTimer = page.setInterval(&quot;innerChangeWidth()&quot;, interval);
// do something
page.clearInterval(myTimer);
(Disponible sur pages Web)
clearAllTimeouts
void clearAllTimeouts()
Efface tous les minuteurs d&eacute;marr&eacute;s.
page.clearAllTimeouts();
(Disponible sur pages Web)
Objet de groupe
Un groupe est un &eacute;l&eacute;ment logique de base qui associe un ensemble de variables logiques.
M&eacute;thodes d'objet de groupe
M&eacute;thodes pouvant &ecirc;tre utilis&eacute;es avec les objets de groupe.
getTag
object getTag( TagName )
Obtient la variable sp&eacute;cifi&eacute;e par Tagname &agrave; partir de l'objet de groupe.
Param&egrave;tre
Description
Nomvariable
Cha&icirc;ne repr&eacute;sentant le nom de variable
Valeur de retour
Un objet repr&eacute;sentant la valeur de la variable ou, si la valeur de variable est un tableau, l'int&eacute;gralit&eacute; du tableau. Si vous avez
besoin de r&eacute;cup&eacute;rer un &eacute;l&eacute;ment du tableau, s&eacute;lectionnez la m&eacute;thode getTag disponible dans l'objet du projet. Ind&eacute;fini est
retourn&eacute; si la variable n'est pas valide.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
345
Objet du projet
var group = new Group();
project.getGroup(&quot;GroupName&quot;, group);
var value = group.getTag(&quot;Tag1&quot;);
(Disponible sur pages Web)
getCount
number getCount()
Retourne le nombre total de variables dans ce groupe.
var group = new Group();
project.getGroup(&quot;GroupName&quot;, 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(&quot;enginesettings&quot;, group);
var tagList = group.getTags();
for(var i = 0; i &lt; tagList.length; i++){
var tagName = tagList[i];
//do something…
};
(Disponible sur pages Web)
Objet du projet
Cet objet d&eacute;finit le widget de projet. Le widget de projet est utilis&eacute; pour r&eacute;cup&eacute;rer les donn&eacute;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 &ecirc;tre
r&eacute;f&eacute;renc&eacute; par les variables du projet.
Propri&eacute;t&eacute;s d'objet du projet
Propri&eacute;t&eacute;s &agrave; d&eacute;finir au niveau du projet.
startPage
string startPage
346
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Page affich&eacute;e au d&eacute;marrage du projet.
var startPage = project.startPage;
project.startPage = &quot;Page2.jmx&quot;;
M&eacute;thodes d'objet du projet
M&eacute;thodes &agrave; utiliser au niveau du projet.
nextPage
void nextPage()
Le script ex&eacute;cute l'action de la Page suivante.
project.nextPage();
(Disponible sur pages Web)
prevPage
void prevPage()
Le script ex&eacute;cute l'action de la page pr&eacute;c&eacute;dente.
project.prevPage();
(Disponible sur pages Web)
lastVisitedPage
void lastVisitedPage()
Le script ex&eacute;cute l'action de la derni&egrave;re page visit&eacute;e.
project.lastVisitedPage();
(Disponible sur pages Web)
homepage
void homePage()
Le script ex&eacute;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 | &copy; 2012-2017 DEIF A/S
347
M&eacute;thodes d'objet du projet
Le script ex&eacute;cute le chargement de la page demand&eacute;e d&eacute;finie dans le script.
project.loadPage(&quot;Page5.jmx&quot;);
(Disponible sur pages Web)
AVERTISSEMENT : &Agrave; chaque changement de page, la suppression de l'ensemble des &eacute;v&eacute;nements de
temps actifs est forc&eacute;e et la proc&eacute;dure JavaScript continue &agrave; fonctionner jusqu'&agrave; la fin de la
suppression avant de passer &agrave; la nouvelle page.
showDialog
void showDialog(pageName)
Le script ex&eacute;cute l'affichage de la page de dialogue.
project.showDialog(&quot;Dialog.jmx&quot;);
(Disponible sur pages Web)
closeDialog
void closeDialog()
Le script ex&eacute;cute la fermeture de la page de dialogue ouverte.
project.closeDialog();
(Disponible sur pages Web)
showMessage
void showMessage( message )
Le script ex&eacute;cute l'affichage de la fen&ecirc;tre contextuelle du message.
project.showMessage(&quot;Hi This is test message&quot;);
(Disponible sur pages Web)
getGroup
number getGroup( groupName, groupInstance, [callback] )
M&eacute;thode de lecture rapide ; permet d'obtenir les valeurs de l'ensemble des variables d'un groupe.
Param&egrave;tre
Description
groupName
Cha&icirc;ne contenant le nom du groupe
groupInstance
&Eacute;l&eacute;ment de groupe &agrave; remplir
fonction de rappel
Cha&icirc;ne contenant le nom de la fonction &agrave; appeler quand le groupe est pr&ecirc;t
348
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Valeur de retour
Un chiffre repr&eacute;sentant l'&eacute;tat : 1 pour succ&egrave;s, 0 pour &eacute;chec.
var group = new Group();
var status = project.getGroup (&quot;enginesettings&quot;, group);
if (status == 1) {
var value = group.getTag(&quot;Tag1&quot;);
if (value!=undefined) {
// do something with the value
}
}
var g = new Group();
var status = project.getGroup (&quot;enginesettings&quot;, g,
function (groupName, group) { fnGroupReady(groupName, group);} );
function fnGroupReady(groupName, group) {
var val = group.getTag(&quot;Tag1&quot;);
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&eacute;.
Param&egrave;tre
Description
tagName
Cha&icirc;ne du nom de variable
&eacute;tat
&Eacute;l&eacute;ment d'&eacute;tat &agrave; remplir
index
Index en cas de variable sous forme de tableau. -1 retourne le tableau complet. Par d&eacute;faut = 0.
fonction de
rappel
Nom de fonction si une lecture asynchrone est requise. Default = “&quot;.
forceRefresh
(Param&egrave;tre optionnel) Vrai = le runtime lira une valeur mise &agrave; jour de la variable directement &agrave; partir du
p&eacute;riph&eacute;rique. Faux par d&eacute;faut
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
349
M&eacute;thodes d'objet du projet
Valeur de retour
La valeur des variables est retourn&eacute;e. Si la variable est un tableau et l'index = -1, le tableau complet est retourn&eacute;. Pour les
variables autres que les tableaux, fournissez un index &agrave; 0.
var state = new State();
var value = project.getTag(&quot;Tag1&quot;, 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(&quot;Tag1&quot;, state, -1,
function(tagName, tagState) { fnTagReady(tagName, tagState); });
function fnTagReady(tagName, tagState) {
if (tagName==&quot;Tag1&quot;) {
var myValue = tagState.getValue();
}
}
(Disponible sur pages Web)
setTag
number setTag( tagName, tagValue, [index], [forceWrite] )
D&eacute;finit la variable indiqu&eacute;e dans le projet. Le nom et la valeur sont dans les cha&icirc;nes.
Param&egrave;tre
Description
tagName
Cha&icirc;ne du nom de variable
tagValue
Objet contenant la valeur &agrave; &eacute;crire
index
Index en cas de variable sous forme de tableau. -1 transmet le tableau complet. Par d&eacute;faut = 0.
forceWrite Valeur bool&eacute;enne pour activer l'&eacute;criture forc&eacute;e des variables, la fonction attendra que la valeur soit &eacute;crite
avant de revenir. Par d&eacute;faut = faux.
Valeur de retour
Valeur enti&egrave;re indiquant le succ&egrave;s ou l'&eacute;chec d'une action lorsque forceWrite est vrai. 0 signifie succ&egrave;s et -1 signifie &eacute;chec.
Si forceWrite est faux, la valeur de retour sera ind&eacute;finie.
var val = [1,2,3,4,5];
350
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
var status = project.setTag(&quot;Tag1&quot;, val, -1, true);
if (status == 0) {
// Success
} else {
// Failure
}
var val = &quot;value&quot;;
project.setTag(&quot;Tag1&quot;, val);
(Disponible sur pages Web)
updateSystemVariables
void project.updateSystemVariables()
Force le rafra&icirc;chissement des variables du syst&egrave;me.
project.updateSystemVariables()
selectAllAlarms
void project.selectAllAlarms(bool selected)
S&eacute;lectionne/d&eacute;s&eacute;lectionne toutes les alarmes
project.selectAllAlarms(true)
(Disponible sur pages Web)
ackAlarms
void project.ackAlarms()
Confirme toutes les alarmes s&eacute;lectionn&eacute;es
project.selectAllAlarms(true);
project.ackAlarms();
project.selectAllAlarms(true);
(Disponible sur pages Web)
resetAlarms
void project.resetAlarms()
R&eacute;initialise toutes les alarmes s&eacute;lectionn&eacute;es
project.selectAllAlarms(true);
project.resetAlarms();
project.selectAllAlarms(true);
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
351
M&eacute;thodes d'objet du projet
(Disponible sur pages Web)
enableAlarms
void project.enableAlarms()
Active toutes les alarmes s&eacute;lectionn&eacute;es
project.selectAllAlarms(true);
project.enableAlarms();
project.selectAllAlarms(true);
(Disponible sur pages Web)
getRecipeItem
object getRecipeItem (recipeName, recipeSet, recipeElement)
Obtient la valeur de l'&eacute;l&eacute;ment d'ensemble de recette indiqu&eacute;.
Param&egrave;tre
Description
recipeName
Cha&icirc;ne repr&eacute;sentant le nom de recette
recipeSet
Cha&icirc;ne repr&eacute;sentant l'ensemble de recette, peut &ecirc;tre soit le nom de l'ensemble de recette, soit l'index
d'ensemble bas&eacute; sur 0.
recipeElement Cha&icirc;ne repr&eacute;sentant l'&Eacute;l&eacute;ment de recette, peut &ecirc;tre soit le nom d'&eacute;l&eacute;ment, soit l'index d'&eacute;l&eacute;ment bas&eacute;
sur 0.
Valeur de retour
Un objet ayant la valeur de la recette. Non d&eacute;fini est retourn&eacute; si non valide. Si de type tableau, un type d'objet sous forme
de tableau est retourn&eacute;.
var value = project.getRecipeItem(&quot;recipeName&quot;, &quot;Set&quot;, &quot;Element&quot;);
setRecipeItem
number setRecipeItem (recipeName, recipeSet, recipeElement, value )
Obtient la valeur de l'&eacute;l&eacute;ment d'ensemble de recette indiqu&eacute;.
Param&egrave;tre
Description
recipeName
Cha&icirc;ne repr&eacute;sentant le nom de recette
recipeSet
Cha&icirc;ne repr&eacute;sentant l'ensemble de recette, peut &ecirc;tre soit le nom de l'ensemble de recette, soit l'index
d'ensemble bas&eacute; sur 0.
recipeElement Cha&icirc;ne repr&eacute;sentant l'&Eacute;l&eacute;ment de recette, peut &ecirc;tre soit le nom d'&eacute;l&eacute;ment, soit l'index d'&eacute;l&eacute;ment bas&eacute;
sur 0.
value
352
Un objet contenant la valeur &agrave; stocker dans la recette. Il peut &ecirc;tre sous forme de tableau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Valeur de retour
Valeur enti&egrave;re indiquant le succ&egrave;s ou l'&eacute;chec d'une action. 0 signifie succ&egrave;s et -1 signifie &eacute;chec.
var val = [2,3,4];
project.setRecipeItem(&quot;recipeName&quot;, &quot;Set&quot;, &quot;Element&quot;, val);
if (status == 0) {
// Success
} else {
// Failure
}
downloadRecipe
void downloadRecipe (recipeName, recipeSet )
T&eacute;l&eacute;charge l'ensemble de recette vers la variable correspondante.
Param&egrave;tre
Description
recipeName Cha&icirc;ne repr&eacute;sentant le nom de recette
recipeSet
Cha&icirc;ne repr&eacute;sentant l'ensemble de recette, peut &ecirc;tre soit le nom de l'ensemble de recette, soit l'index
d'ensemble bas&eacute; sur 0.
project.downloadRecipe(&quot;recipeName&quot;, &quot;Set&quot;);
uploadRecipe
void uploadRecipe (recipeName, recipeSet )
Charge la valeur des variables dans l'ensemble de recette fourni.
Param&egrave;tre
Description
recipeName Cha&icirc;ne repr&eacute;sentant le nom de recette
recipeSet
Cha&icirc;ne repr&eacute;sentant l'ensemble de recette, peut &ecirc;tre soit le nom de l'ensemble de recette, soit l'index
d'ensemble bas&eacute; sur 0.
project.uploadRecipe(&quot;recipeName&quot;, &quot;Set&quot;);
launchApp
void launchApp( appName, appPath, arguments, singleInstance)
Ex&eacute;cute une application externe.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
353
M&eacute;thodes d'objet du projet
Param&egrave;tre
Description
appName
Cha&icirc;ne contenant le nom de l'application
appPath
Cha&icirc;ne contenant le chemin absolu de l'application
Arguments
Cha&icirc;ne contenant les arguments &agrave; envoyer &agrave; l'application
singleInstance
vrai = une seule instance autoris&eacute;e, faux = multiples instances autoris&eacute;es
project.launchApp(&quot;PDF.exe&quot;,&quot;\\Flash\\QTHMI\\PDF&quot;,&quot;\\USBMemory\\file.pdf&quot;,&quot;true&quot;);
printGfxReport
void printGfxReport( reportName, silentMode)
Imprime le rapport graphique sp&eacute;cifi&eacute; par reportName.
Param&egrave;tre
Description
reportName
Cha&icirc;ne contenant le nom de rapport
silentMode
Vrai = mode silencieux activ&eacute;. Aucune bo&icirc;te de dialogue des param&egrave;tres d'impression ne s'affiche.
project.printGfxReport(&quot;Report Graphics 1&quot;, true);
printText
void printText( text, silentMode)
Imprime un texte fixe.
Param&egrave;tre
Description
text
Cha&icirc;ne &agrave; imprimer
silentMode
Vrai = mode silencieux activ&eacute;. Aucune bo&icirc;te de dialogue des param&egrave;tres d'impression ne s'affiche.
project.printText(&quot;Hello I Am Text Printing&quot;,true);
printBytes
void printBytes( text, silentMode)
Imprime une cha&icirc;ne hexad&eacute;cimale chiffrant les donn&eacute;es d'impression. Par exemple, &laquo; 1b30 &raquo; pour imprimer &lt; ESC 0 &gt;
Param&egrave;tre
Description
text
Cha&icirc;ne hexad&eacute;cimale &agrave; imprimer
silentMode
Vrai = mode silencieux activ&eacute;. Aucune bo&icirc;te de dialogue des param&egrave;tres d'impression ne s'affiche.
354
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
project.printText(&quot;Hello I Am Text Printing&quot;,true);
emptyPrintQueue
void emptyPrintQueue()
Vide la queue d'impression. La t&acirc;che actuelle ne sera pas annul&eacute;e.
project.emptyPrintQueue();
pausePrinting
void pausePrinting();
Suspend les op&eacute;rations d'impression. Ne suspendra pas l'impression d'une page d&eacute;j&agrave; envoy&eacute;e &agrave; l'imprimante.
project.pausePrinting();
resumePrinting
void resumePrinting();
Reprend l'impression suspendue.
project.resumePrinting();
abortPrinting
void abortPrinting();
Annule l'op&eacute;ration d'impression en cours et continue avec l'&eacute;l&eacute;ment suivant dans la queue. Cette commande ne suspendra
pas l'impression d'une page d&eacute;j&agrave; envoy&eacute;e &agrave; l'imprimante.
project.abortPrinting();
printStatus
project.printStatus;
Retourne une cha&icirc;ne repr&eacute;sentant l'&eacute;tat d'impression actuel.
Cha&icirc;ne d'&eacute;tat
Description
error
Une erreur est survenue pendant l'impression
printing
Impression en cours
idle
Le syst&egrave;me est pr&ecirc;t &agrave; accepter de nouvelles t&acirc;ches
paused
L'impression a &eacute;t&eacute; suspendue
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
355
M&eacute;thodes d'objet du projet
var status = project.printStatus;
project.setTag(&quot;PrintStatus&quot;,status);
printGfxJobQueueSize
project.printGfxJobQueueSize;
Retourne le nombre de rapports graphiques dans la queue d'impression.
var gfxqueuesize = project.printGfxJobQueueSize;
project.setTag(&quot;printGfxJobQueueSize&quot;,gfxqueuesize);
printTextJobQueueSize
project.printTextJobQueueSize;
Retourne le nombre de rapports textes dans la queue d'impression.
var textjobqueuesize = project.printTextJobQueueSize;
project.setTag(&quot;printTextJobQueueSize&quot;,textjobqueuesize);
printCurrentJob
project.printCurrentJob;
Retourne une cha&icirc;ne repr&eacute;sentant la t&acirc;che actuelle en cours d'impression
var currentjob = project.printCurrentJob;
project.setTag(&quot;printCurrentJob&quot;,currentjob);
printActualRAMUsage
project.printActualRAMUsage;
Retourne une estimation sur l'utilisation de RAM pour les queues d'impression
var myVar = project.printActualRAMUsage;
alert(&quot; actual ram usage is &quot;+ myVar);
printRAMQuota
project.printRAMQuota;
Retourne l'utilisation maximum de RAM autoris&eacute;e pour les queues d'impression
var ramquota = project.printRAMQuota;
project.setTag(&quot;printRAMQuota&quot;,ramquota);
356
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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(&quot; actual disk usage is &quot;+ myVar1);
printDiskQuota
project.printDiskQuota;
Retourne la taille maximale autoris&eacute;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(&quot;printSpoolFolder&quot;,spoolfolder);
printPercentage
project.printPercentage;
Retourne le pourcentage d'avancement de la t&acirc;che actuelle (significatif seulement pour les rapports graphiques
multipages)
var percentage = project.printPercentage;
project.setTag(&quot;printPercentage&quot;,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( &quot;_PageMgr&quot; );
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
357
Objet d'&eacute;tat
// Show Current Page
var currentPageName = pageMgr.getCurrentPageName();
project.showMessage( &quot;Current active page is: &quot; + 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( &quot;_PageMgr&quot; );
//Page exists
var pageExists = pageMgr.hasPage( &quot;Page10&quot; );
if (pageExists) {
project.showMessage( &quot;Page10 exists&quot; );
} else {
project.showMessage( &quot;Hei Page10 not exists!&quot; );
}
(Disponible sur pages Web)
Objet d'&eacute;tat
Il s'agit de la classe maintenant l'&eacute;tat d'une variable obtenue &agrave; partir de l'environnement contr&ocirc;l&eacute;.
M&eacute;thodes d'objet d’&eacute;tat
M&eacute;thodes &agrave; utiliser avec les objets d'&eacute;tat.
getQualityBits
number getQualityBits()
Renvoie un entier - une combinaison de bits indiquant la qualit&eacute; de valeur de la variable.
var state = new State();
var value = project.getTag(&quot;Tag1&quot;, state, 0);
var qbits = state.getQualityBits();
(Disponible sur pages Web)
getTimestamp
number getTimestamp()
Renvoie la valeur du temps &eacute;chantillonn&eacute;e.
358
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;es de JavaScript.
var state = new State();
var value = project.getTag(&quot;Tag1&quot;, state, 0);
var ts = state.getTimestamp();
isQualityGood
boolean isQualityGood()
Renvoir si la valeur contenue dans cet objet d'&eacute;tat est fiable.
Valeur de retour
Une valeur bool&eacute;enne de vrai si la qualit&eacute; est bonne, sinon faux.
var state = new State();
var value = project.getTag(&quot;Tag1&quot;, state, 0);
if (state.isQualityGood()) {
// do something…
}
(Disponible sur pages Web)
Mots-cl&eacute;s
Des objets globaux sont pr&eacute;d&eacute;finis et peuvent &ecirc;tre r&eacute;f&eacute;renc&eacute;s par les noms suivants.
page
object page
R&eacute;f&eacute;rence l'objet de page pour la page courante.
function btnStd04_onMouseRelease(me) {
var wgt = page.getWidget(&quot;rect1&quot;);
var name = wgt.objectName;
}
projet
object project
R&eacute;f&eacute;rence le widget de projet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
359
Fonctions g&eacute;n&eacute;rales
var group = new Group();
project.getGroup(&quot;GroupName&quot;, group);
var value = group.getCount(&quot;Tag1&quot;);
Fonctions g&eacute;n&eacute;rales
print
void print( message )
Imprime un message &agrave; la fen&ecirc;tre d'enregistrement IHM.
Param&egrave;tre
Description
message
Cha&icirc;ne de message
print(&quot;Test message&quot;);
alert
void alert( message )
Affiche une bo&icirc;te de dialogue contextuelle avec un message pr&eacute;d&eacute;fini. L'utilisateur doit appuyer sur le bouton OK dans la
bo&icirc;te de dialogue pour poursuivre l'ex&eacute;cution du script.
Param&egrave;tre
Description
message
Cha&icirc;ne de message
Note : La fonction alerte peut &ecirc;tre utilis&eacute;e pour le d&eacute;bogage des fonctions JavaScript.
alert(&quot;Test message&quot;);
(Disponible sur pages Web)
Prendre en main la lecture/l’&eacute;criture de fichiers
Create folder
boolean fs.mkdir(strPath);
Cr&eacute;e un dossier, s'il n'existe pas d&eacute;j&agrave;, dans le chemin sp&eacute;cifi&eacute;. Retourne vrai en cas de succ&egrave;s et faux en cas d'&eacute;chec.
Param&egrave;tre
Description
strPath
Cha&icirc;ne de chemin
360
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
35 JavaScript
Remove folder
boolean fs.rmdir(dirPath);
Supprime le r&eacute;pertoire &agrave; strPath s'il existe et s'il est vide. Retourne vrai en cas de succ&egrave;s et faux en cas d'&eacute;chec.
Param&egrave;tre
Description
dirPath
Cha&icirc;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'&eacute;chec.
Param&egrave;tre
Description
dirPath
Cha&icirc;ne de dossier
Read file
object fs.readFile(strfile [,strFlag]);
Ouvre le fichier strFile en mode lecture, lit son contenu et le retourne.
Param&egrave;tre
Description
strFile
Cha&icirc;ne de nom de fichier
strFlag
Mode lecture de fichier :
&quot;b&quot; lit et retourne en tant que fichier binaire (autrement retourne un fichier de texte)
Write file
fs.writeFile(strFile, fileData, [strFlag]);
Cr&eacute;e le fichier strFile s'il n'est pas pr&eacute;sent. Ouvre le fichier strFile en mode &eacute;criture et &eacute;crit les donn&eacute;es fileData au fichier.
Param&egrave;tre
Description
strFile
Cha&icirc;ne de nom de fichier
fileData
Donn&eacute;es destin&eacute;es &agrave; &ecirc;tre &eacute;crites sur le fichier dans un tableau d'octets
strFlag
Mode &eacute;criture de fichier :
l
“a” : ajoute le fileData &agrave; la fin du fichier de texte
l
“r” : remplace les contenus du fichier par le fileData
l
“ab” : ajoute le fileData &agrave; 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 | &copy; 2012-2017 DEIF A/S
361
Prendre en main la lecture/l’&eacute;criture de fichiers
Le drapeau par d&eacute;faut sert &agrave; &eacute;crire des fichiers de texte en mode ajout et &eacute;criture. Le chemin de fichier sera cr&eacute;&eacute; s'il n'est
pas pr&eacute;sent.
Retourne -1 en cas d'erreurs d'&eacute;criture.
Ajouter un fichier
int fs.appendFile(strFile, fileData);
Si les fichiers n'existe pas, les cr&eacute;er, sinon ajouter au fichier existant. Renvoie le nombre de caract&egrave;res &eacute;crits ou -1 en cas
d'erreur.
Param&egrave;tre
Description
strFile
Cha&icirc;ne de nom de fichier
fileData
Donn&eacute;es destin&eacute;es &agrave; &ecirc;tre &eacute;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&egrave;tre
Description
strPath
Cha&icirc;ne de chemin
Remove file
boolean fs.unlink(strPath)
Supprime le fichier s&eacute;lectionn&eacute; au strPath du filesystem s'il existe. Retourne vrai en cas de succ&egrave;s et faux en cas d'&eacute;chec.
Param&egrave;tre
Description
strPath
Cha&icirc;ne de chemin
File status
object fs.stat(strPath)
R&eacute;cup&egrave;re les informations sur le fichier/dossier pr&eacute;sent au chemin sp&eacute;cifi&eacute;.
Param&egrave;tre
Description
strPath
Cha&icirc;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 | &copy; 2012-2017 DEIF A/S
35 JavaScript
fileStats.size
Taille en octets de ce fichier
fileStats.atime
Objet de date repr&eacute;sentant le moment du dernier acc&egrave;s en mode lecture
fileStats.mtime
Objet de date repr&eacute;sentant le moment du dernier acc&egrave;s en mode &eacute;criture
fileStats.ctime
L'objet de date repr&eacute;sentant le moment de cr&eacute;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&eacute;taire du fichier
0x2000
Le fichier est modifiable par le propri&eacute;taire du fichier
0x1000
Le fichier est ex&eacute;cutable par le propri&eacute;taire du fichier
0x0400
Le fichier est lisible par l'utilisateur
0x0200
Le fichier est modifiable par l'utilisateur
0x0100
Le fichier est ex&eacute;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&eacute;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 &ecirc;tre de style UNIX. Ce qui implique que le caract&egrave;re barre oblique invers&eacute;e (\)
n'est pas reconnu. Veuillez utiliser la barre oblique classique (/) &agrave; la place.
L'objet de syst&egrave;me de fichier est un objet au niveau du client. Les op&eacute;rations sont donc effectu&eacute;es sur le syst&egrave;me de fichier
local plut&ocirc;t que sur le syst&egrave;me de fichier du serveur.
L'actuelle API JavaScript d'acc&egrave;s au syst&egrave;me de fichier du p&eacute;riph&eacute;rique a &eacute;t&eacute; con&ccedil;ue pour manipuler des fichiers de petite
taille. Lorsqu'un fichier est lu, l'ensemble des contenus du fichier est temporairement stock&eacute; dans la RAM disponible pour
l'environnement JavaScript (16MB), avec des exceptions possibles au cas o&ugrave; la m&eacute;moire disponible ne serait pas
suffisante. Une bonne pratique en mati&egrave;re de programmation serait d'inclure l'appel fs.readFile() dans un bloc
d'essai/d&eacute;tection.
Limites lors du travail avec des widgets en JavaScript
Les widgets ne peuvent pas &ecirc;tre instanci&eacute;s par JavaScript, ils ne peuvent qu'&ecirc;tre acc&eacute;d&eacute;s et modifi&eacute;s. Si vous avez
besoin de widgets suppl&eacute;mentaires sur la page, vous pouvez ajouter des widgets masqu&eacute;s sur la page, puis les afficher ou
les positionner en utilisant JavaScript.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
363
D&eacute;boguer JavaScript
D&eacute;boguer JavaScript
AGI Creator et HMI Runtime incluent un d&eacute;bogueur JavaScript.
Deux types de d&eacute;bogueurs sont disponibles :
l
l
D&eacute;bogueur de runtime : un d&eacute;bogueur qui s'ex&eacute;cute directement sur le p&eacute;riph&eacute;rique IHM
D&eacute;bogueur &agrave; distance : un d&eacute;bogueur qui s'ex&eacute;cute sur un ordinateur &agrave; distance connect&eacute; au p&eacute;riph&eacute;rique IHM via
Ethernet (en g&eacute;n&eacute;ral, un ordinateur qui ex&eacute;cute AGI Creator)
Activer le d&eacute;bogage
Dans le volet Propri&eacute;t&eacute;s d’une page, r&eacute;gler le D&eacute;bogage JavaScript sur vrai.
Pour le d&eacute;bogage des planificateurs et d'alarmes, activez le D&eacute;bogage JavaScript dans Propri&eacute;t&eacute;s du projet.
Dans HMI Runtime, le d&eacute;bogueur affiche les informations de d&eacute;bogage lorsque les &eacute;v&eacute;nements sont appel&eacute;s. Dans le
volet Locaux, vous pouvez inspecter toutes les variables et tous les &eacute;l&eacute;ments.
Pour obtenir un guide de r&eacute;f&eacute;rence complet sur le d&eacute;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 | &copy; 2012-2017 DEIF A/S
35 JavaScript
D&eacute;bogueur &agrave; distance JavaScript
Chemin : Ex&eacute;cuter&gt; D&eacute;marrer d&eacute;bogueur &agrave; distance JS
1. Dans le projet Propri&eacute;t&eacute;s, d&eacute;finissez les param&egrave;tres Permettre JavaScript &agrave; distance et D&eacute;bogage JavaScript
sur Vrai dans toutes les pages qui requi&egrave;rent un d&eacute;bogage.
2. T&eacute;l&eacute;chargez le projet : le message suivant s'affiche en cours de runtime.
3. Dans la fen&ecirc;tre D&eacute;bogueur JS, s&eacute;lectionnez l'IP du p&eacute;riph&eacute;rique IHM et cliquez sur Associer pour connecter le
d&eacute;bogueur au p&eacute;riph&eacute;rique IHM.
Le d&eacute;bogueur &agrave; distance JavaScript se connecte &agrave; HMI Runtime via un port 5100/TCP.
Note : L'outil de d&eacute;bogage &agrave; distance de JavaScript n'est pas pris en charge dans AGI Client.
Utilisation de la m&eacute;moire JavaScript
Lorsque la m&eacute;moire d&eacute;passe le maximum, une exception m&eacute;moire pleine est lev&eacute;e avec un message personnalis&eacute;. Notez
que nous n'avons pas un contr&ocirc;le pr&eacute;cis de l'utilisation r&eacute;elle de la m&eacute;moire, il s'agit donc d'une limite floue. De plus, nous
ne pouvons pas interdire l'allocation (cela arr&ecirc;terait l'impl&eacute;mentation du moteur), une exception est donc lev&eacute;e uniquement
lorsque la m&eacute;moire a d&eacute;j&agrave; d&eacute;pass&eacute; la limite. Avant de lever l'exception, un nettoyage de la m&eacute;moire est forc&eacute; pour voir si de
la m&eacute;moire peut &ecirc;tre lib&eacute;r&eacute;e.
Vous pouvez acc&eacute;der &agrave; la limite de la m&eacute;moire JavaScript depuis l'objet global $EngineMemory. Elle est par d&eacute;faut de
16 MB, ce qui devrait suffire pour une utilisation habituelle de JavaScript (principalement du contr&ocirc;le, sans beaucoup
d'allocations).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
365
D&eacute;boguer JavaScript
l
l
l
$EngineMemory.setLimit()
d&eacute;finissez la m&eacute;moire maximale autoris&eacute;e pour JavaScript (la limite par d&eacute;faut est 0x00FFFFFF)
$EngineMemory.getLimit()
obtenez la m&eacute;moire maximale autoris&eacute;e pour JavaScript
$EngineMemory.getSize()
obtenez la m&eacute;moire en cours d'utilisation par JS (fastMallocStat)
Tester l'exception de m&eacute;moire
Pour g&eacute;n&eacute;rer et tester l'exception de m&eacute;moire, vous pouvez utiliser les extraits suivants. Notez que nous devons
r&eacute;initialiser la limite de la m&eacute;moire &agrave; 0xffffffff pour ex&eacute;cuter l'alerte, sinon les allocations de m&eacute;moire requises pour afficher
l'alerte &eacute;choueraient.
366
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
36
Gestes de prise en main
Certains widgets ont la capacit&eacute; de d&eacute;tecter et de g&eacute;rer les gestes de d&eacute;placement et de pincement.
l
l
Tendances (voir &quot;Gestes de widget de tendance&quot; on page 183 pour plus de d&eacute;tails)
Widget de zone de mouvement Widget sp&eacute;cial con&ccedil;u pour personnaliser la gestion des &eacute;v&eacute;nements de geste (voir
&quot;Widget de zone de mouvement&quot; on page 284 pour plus de d&eacute;tails)
Pour les widgets avec une pr&eacute;sentation en tableau, quand le param&egrave;tre Type de d&eacute;filement a &eacute;t&eacute; r&eacute;gl&eacute; sur Dynamique, le
mouvement de d&eacute;placement est utilis&eacute; pour d&eacute;filer le tableau en douceur.
l
Alarmes
l
Liste de contr&ocirc;le
AVERTISSEMENT : le geste de pincement demande deux doigts. Il est disponible uniquement avec
les p&eacute;riph&eacute;riques IHM supportant un fonctionnement multi-touch (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques
IHM.&quot; on page 431
Astuce : Si vous utilisez un p&eacute;riph&eacute;rique IHM multi-touch, vous pouvez mettre en place des commandes
s&eacute;curis&eacute;es en programmant des commandes qui ne seront ex&eacute;cutables que par pression simultan&eacute;e de deux
boutons.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
367
368
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
37
Param&egrave;tres du syst&egrave;me
Les param&egrave;tres du syst&egrave;me sont un outil interne du p&eacute;riph&eacute;rique IHM qui peut &ecirc;tre utilis&eacute; pour les r&eacute;glages de base du
p&eacute;riph&eacute;rique ou pour la mise &agrave; jour des composants du syst&egrave;me.
Remarque : les composants du syst&egrave;me peuvent &ecirc;tre mis &agrave; jour &agrave; partir de AGI Creator (voir &quot;Mettre &agrave; jour les
composants syst&egrave;me des p&eacute;riph&eacute;riques IHM&quot; on page 413 pour plus de d&eacute;tails)
AVERTISSEMENT : Travailler avec l'outil Param&egrave;tres syst&egrave;me est une op&eacute;ration critique et, lorsqu'elle
n’est pas effectu&eacute;e correctement, peut causer des dommages au produit n&eacute;cessitant un service du
produit. Contactez le support technique pour l'assistance.
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
370
369
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
L'outil Param&egrave;tres syst&egrave;me comprend un menu de rotation, et les boutons de navigation pour faire d&eacute;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&egrave;me d’exploitation est repr&eacute;sent&eacute;.
L’outil des param&egrave;tres du syst&egrave;me peut &ecirc;tre utilis&eacute; selon deux modes de fonctionnement :
l
Mode utilisateur
l
Mode syst&egrave;me.
Pour chaque mode, diff&eacute;rentes options sont disponibles.
Installation du runtime
Les p&eacute;riph&eacute;riques HMI sont livr&eacute;s hors d'usine sans Runtime, &agrave; la premi&egrave;re mise sous tension, IHM affiche l'&eacute;cran
&laquo; Chargeur de runtime &raquo;.
Le runtime peut &ecirc;tre install&eacute; :
l
Automatiquement, via Ethernet sur le premier t&eacute;l&eacute;chargement avec AGI Creator
l
Manuellement via cl&eacute; USB, cr&eacute;ation d'un &laquo; paquet de mise &agrave; jour &raquo;
370
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
37 Param&egrave;tres du syst&egrave;me
Installation du Runtime via Ethernet
Pour l’installation du Runtime via Ethernet, suivre la proc&eacute;dure &quot;T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM&quot; on page 78.
AVERTISSEMENT : Le t&eacute;l&eacute;chargement via Ethernet de l’installation du runtime requi&egrave;re le
p&eacute;riph&eacute;rique IHM avec une adresse IP valide.
L'adresse IP peut &ecirc;tre affect&eacute;e de trois mani&egrave;res :
l
l
l
Automatiquement via serveur DHCP. Cette option est activ&eacute;e par d&eacute;faut. Si un serveur DHCP est disponible sur le
r&eacute;seau, l’adresse IP sera attribu&eacute;e automatiquement par le serveur.
Automatiquement via la fonction Auto-IP. Si l'assignation DHCP est activ&eacute;e mais qu’aucun serveur DHCP n’est
disponible sur le r&eacute;seau, le p&eacute;riph&eacute;rique IHM s'attribue une adresse IP dans l’&eacute;chelle 169.254.xx avec un masque de
sous-r&eacute;seau 255.255.0.0
Manuellement via les Param&egrave;tres du Syst&egrave;me. Dans le menu Param&egrave;tres du Syst&egrave;me, dans la section r&eacute;seau,
l'adresse IP peut &ecirc;tre attribu&eacute;e manuellement, d&eacute;sactivant la fonction d'affectation du serveur DHCP.
Installation du runtime via la m&eacute;moire USB
Pour l’installation du runtime, UpdatePackage ou paquet de sauvegarde via un p&eacute;riph&eacute;rique USB, suivre cette proc&eacute;dure :
1. Cr&eacute;er un paquet de mise &agrave; jour depuis AGI Creator et copier dans une cl&eacute; m&eacute;moire USB vide
2. Sur le p&eacute;riph&eacute;rique HMI, s&eacute;lectionner [Transfer from disk] et s&eacute;lectionner UpdatePackage.zip &agrave; charger.
Param&egrave;tres du syst&egrave;me
Les param&egrave;tres du syst&egrave;me dispose de deux modes de fonctionnement :
l
l
Mode utilisateur
une interface simplifi&eacute;e qui permet aux utilisateurs d'acc&eacute;der aux r&eacute;glages de base du p&eacute;riph&eacute;rique IHM.
Mode syst&egrave;me
une interface compl&egrave;te qui donne aux utilisateurs l'acc&egrave;s &agrave; toutes les options de l'outil.
Lorsque vous acc&eacute;dez &agrave; l'outil au runtime, s&eacute;lectionner &laquo; Show System Settings &raquo; dans le menu contextuel, l'outil est
d&eacute;marr&eacute; par d&eacute;faut en mode utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
371
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
Note : Appuyer et maintenir appuy&eacute; sur une zone de l'&eacute;cran sans boutons ou autres &eacute;l&eacute;ments tactiles pour
afficher le menu contextuel.
Pour acc&eacute;der au Mode syst&egrave;me :
l
l
Ex&eacute;cuter une s&eacute;quence de pression sur l'&eacute;cran tactile lors de la phase de mise sous tension. Une s&eacute;quence de
pression et une s&eacute;quence &eacute;lev&eacute;e de fr&eacute;quence des activations tactiles ex&eacute;cut&eacute;es imm&eacute;diatement apr&egrave;s que le
dispositif a &eacute;t&eacute; mis sous tension.
Depuis la page Param&egrave;tres du syst&egrave;me en mode utilisateur, red&eacute;marrer le panneau en mode configuration OS
&Eacute;l&eacute;ments disponibles en Mode utilisateur
&Eacute;l&eacute;ment
Description
Calibrate
Touch
Calibre l'&eacute;cran tactile
Display
settings
Contr&ocirc;le la clart&eacute; et le d&eacute;lai d'attente d'inactivit&eacute; du r&eacute;tro&eacute;clairage
Time
D&eacute;finit manuellement la date et l'heure sur le p&eacute;riph&eacute;rique IHM ou configure les serveurs NTP.
Regional
Settings
S&eacute;lectionne ou personnalise les param&egrave;tres r&eacute;gionaux
BSP
Settings
Affiche la version du syst&egrave;me d'exploitation et unit les minuteries en fonctionnement pour contr&ocirc;ler le
signal sonore et la LED de la batterie.
Network
D&eacute;finit l'adresse IP et d'autres param&egrave;tres r&eacute;seau
Plug-in List
Liste des composants enfichables install&eacute;s et reconnus par le syst&egrave;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&eacute;trage du syst&egrave;me
Restart
Red&eacute;marre le p&eacute;riph&eacute;rique IHM
l
l
Syst&egrave;me d'exploitation principal
Red&eacute;marrer le p&eacute;riph&eacute;rique IHM dans le mode de fonctionnement
Syst&egrave;me d'exploitation de configuration
Red&eacute;marrer le p&eacute;riph&eacute;rique HIM avec l'outil de Param&egrave;tre du syst&egrave;me actif en Mode syst&egrave;me
&Eacute;l&eacute;ments disponibles en Mode syst&egrave;me
En plus de ceux disponibles en mode utilisateur, les fonctionnalit&eacute;s suivantes sont &eacute;galement disponibles :
372
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
37 Param&egrave;tres du syst&egrave;me
&Eacute;l&eacute;ment
Description
Format Flash
Formate la m&eacute;moire flash du p&eacute;riph&eacute;rique interne Tous les projets et le HMI
Runtime seront effac&eacute;s, renvoyant le p&eacute;riph&eacute;riques aux r&eacute;glages d'usine.
Restaure les param&egrave;tres d'usine.
Restaure les param&egrave;tres d'usine comme une alternative au format Flash, d'une
mani&egrave;re plus flexible. Les options suivantes sont disponibles :
D&eacute;sinstaller IHM : retirer le HMI Runtime (tout le dossier qthmi) au prochain
d&eacute;marrage, le dispositif se comportera comme une nouvelle unit&eacute;. Cette
commande ne r&eacute;initialise pas les param&egrave;tres tels que l'adresse IP, la luminosit&eacute;
ou le CTR.
Effacer les param&egrave;tres de syst&egrave;me : r&eacute;initialise les param&egrave;tres du syst&egrave;me
(param&egrave;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&egrave;me est &eacute;galement r&eacute;initialis&eacute;.
Effacer application Controller : efface les dossiers actuels utilis&eacute;s par les
contr&ocirc;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&egrave;tres de sysdata : efface le dossier \Flash\$SysData$
Assistance t&eacute;l&eacute;phonique : Pour &ecirc;tre utilis&eacute; uniquement par le support
technique pour r&eacute;soudre les probl&egrave;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&eacute;moire flash r&eacute;serv&eacute;e pour stocker l'image de d&eacute;marrage
affich&eacute; &agrave; la mise sous tension. Les param&egrave;tres par d&eacute;faut sont normalement
appropri&eacute;s pour toutes les unit&eacute;s.
T&eacute;l&eacute;chargement Syst&egrave;me
d'exploitation de configuration
Contr&ocirc;les et mises &agrave; niveau de la version actuelle du syst&egrave;me de fonctionnement
utilis&eacute; en mode syst&egrave;me
T&eacute;l&eacute;chargement Syst&egrave;me
d'exploitation principal
Contr&ocirc;les et mises &agrave; niveau de la version actuelle du syst&egrave;me de fonctionnement
principal
T&eacute;l&eacute;chargement Image de
d&eacute;marrage
Charge un nouveau fichier pour l'image de d&eacute;marrage affich&eacute;e dans l’unit&eacute; au
moment du d&eacute;marrage.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
373
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
&Eacute;l&eacute;ment
Description
Astuce : Mettre &agrave; jour l’image de d&eacute;marrage directement &agrave; partir du AGI
Creator logiciel de programmation.
Voir &quot;Mise &agrave; jour des composants syst&egrave;me de l’application&quot; on page 414 pour plus
de d&eacute;tails.
T&eacute;l&eacute;charger Bootloader
Contr&ocirc;les et mises &agrave; niveau de la version actuelle du programme d’amor&ccedil;age du
syst&egrave;me.
T&eacute;l&eacute;chargement de l’FPGA
principal
Contr&ocirc;les et mises &agrave; niveau de la version actuelle du principal fichier FPGA.
Cette option peut ne pas &ecirc;tre disponibles pour toutes les plateformes ni par toutes
les versions.
T&eacute;l&eacute;chargement de l’FPGA de
s&eacute;curit&eacute;
Contr&ocirc;les et mises &agrave; niveau de la version actuelle de la copie de sauvegarde du
fichier FPGA. Cette option peut ne pas &ecirc;tre disponibles pour toutes les
plateformes ni par toutes les versions.
T&eacute;l&eacute;charger du superviseur du
syst&egrave;me
Contr&ocirc;les et mises &agrave; niveau de la version actuelle du firmware du superviseur du
syst&egrave;me (utilis&eacute; pour le traitement RTC et pour l'alimentation).
Chargement Syst&egrave;me
d'exploitation de configuration
Copiez les fichiers syst&egrave;me &agrave; partir du panneau de commande sur le p&eacute;riph&eacute;rique
externe (g&eacute;n&eacute;ralement une cl&eacute; USB).
Chargement Syst&egrave;me
d'exploitation principal
Chargement Image de d&eacute;marrage
Chargement Bootloader
Chargement FPGA principal
Chargement FPGA de s&eacute;curit&eacute;
Chargement du superviseur du
syst&egrave;me
Mise &agrave; jour des composants du syst&egrave;me
Les composants du syst&egrave;me peuvent &ecirc;tre mis &agrave; jour &agrave; l'aide d'une m&eacute;moire flash USB. Pour chaque composant, un couple
de fichiers de mise &agrave; jour sp&eacute;cifiques est fourni.
Note : Les proc&eacute;dures de mise &agrave; niveau d&eacute;pendent des versions de mat&eacute;riel et de syst&egrave;me d'exploitation.
Contactez le support technique pour l'assistance.
374
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
37 Param&egrave;tres du syst&egrave;me
1. Copier tous les fichiers de mise &agrave; niveau dont vous avez besoin sur une m&eacute;moire USB et la brancher sur le port
USB du p&eacute;riph&eacute;rique IHM.
2. D&eacute;marrer l'outil des Param&egrave;tres du syst&egrave;me en mode syst&egrave;me (voir &quot;Param&egrave;tres du syst&egrave;me&quot; on page 371pour plus
de d&eacute;tails).
3. Cliquez sur la fonction de t&eacute;l&eacute;chargement souhait&eacute;.
4. Parcourir le contenu de la cl&eacute; USB pour les fichiers &agrave; t&eacute;l&eacute;charger. L'exemple montre les composants principaux du
syst&egrave;me d’exploitation.
5. Cliquer sur T&eacute;l&eacute;charger pour transf&eacute;rer les fichiers sur les p&eacute;riph&eacute;riques IHM.
Note : Depuis cette bo&icirc;te de dialogue, cliquer sur Charger pour transf&eacute;rer les fichiers vers le p&eacute;riph&eacute;rique
USB.
6. Suivre les instructions affich&eacute;es pour terminer la mise &agrave; jour : l'&eacute;tat d'avancement de l'op&eacute;ration affich&eacute; dans une
barre de progression.
Cette op&eacute;ration peut n&eacute;cessiter quelques minutes.
Important : Ne pas &eacute;teindre le p&eacute;riph&eacute;rique pendant qu’un composant du syst&egrave;me est en cours de
mise &agrave; niveau.
Liste des composants pouvant &ecirc;tre mis &agrave; jour
Les p&eacute;riph&eacute;riques IHM supportent la mise &agrave; jour des composants suivants :
Composant
Description
Application
L'Application IHM et le runtime IHM g&eacute;n&eacute;r&eacute; &agrave; partir de la commande
Ex&eacute;cuter&gt;Paquet de mise &agrave; jour
Syst&egrave;me
d'exploitation
principal
Syst&egrave;me d'exploitation principale
Syst&egrave;me
d'exploitation de
Syst&egrave;me d'exploitation de sauvegarde qui assure la restauration des unit&eacute;s en cas de
corruption du syst&egrave;me d'exploitation principal
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
375
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques WinCE
Composant
Description
configuration
Image de d&eacute;marrage
L'&eacute;cran initial affich&eacute; au d&eacute;marrage du p&eacute;riph&eacute;rique IHM
Bootloader
Chargeur pour g&eacute;rer le d&eacute;marrage du p&eacute;riph&eacute;rique
FPGA principal
Firmware FPGA
FPGA de s&eacute;curit&eacute;
Copie de sauvegarde du FPGA principal qui assure le d&eacute;marrage de l’unit&eacute; en cas de
corruption principale FPGA
Important : Utilisez le m&ecirc;me fichier pour mettre &agrave; jour les
composants du FPGA Principal et de S&eacute;curit&eacute;.
Superviseur de
syst&egrave;me
Logiciel du contr&ocirc;leur du superviseur de syst&egrave;me (par exemple : packaged_
GekkoZigBee_v4.13.bin).
Le composant Superviseur de syst&egrave;me peut &ecirc;tre mis &agrave; jour &agrave; partir de v4.13 ou
version sup&eacute;rieure.
Important : Ne tentez pas de mettre &agrave; jour les versions V4.08, V4.09,
V4.10 et V4.11 car elles ne supportent pas la mise &agrave; jour
automatique &agrave; partir des Param&egrave;tres Syst&egrave;me.
376
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Calibrage de l'&eacute;cran tactile
Le calibrage du param&egrave;tre du syst&egrave;me permet de calibrer le p&eacute;riph&eacute;rique &agrave; &eacute;cran tactile, peut &ecirc;tre consult&eacute; depuis les
param&egrave;tres du syst&egrave;me
Pour acc&eacute;der aux param&egrave;tres du syst&egrave;me :
l
Ex&eacute;cuter une s&eacute;quence de pression sur l'&eacute;cran tactile lors de la phase de mise sous tension. Une s&eacute;quence de
pression et une s&eacute;quence &eacute;lev&eacute;e de fr&eacute;quence des activations tactiles ex&eacute;cut&eacute;es imm&eacute;diatement apr&egrave;s que le
dispositif a &eacute;t&eacute; mis sous tension.
ou
l
Appuyer sur un espace vide de l'&eacute;cran et maintenez enfonc&eacute; pendant quelques secondes pour afficher le menu
contextuel.
Depuis le menu rotatif, s&eacute;lectionner &laquo; Calibrate Touch &raquo; et suivre les instructions affich&eacute;es sur l'&eacute;cran pour terminer la
proc&eacute;dure de calibrage, le syst&egrave;me vous demandera de toucher des points sp&eacute;cifiques pour calibrer le p&eacute;riph&eacute;rique &agrave; &eacute;cran
tactile.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
377
378
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Protection du mot de passe
Le mot de passe interne du p&eacute;riph&eacute;rique IHM peut &ecirc;tre d&eacute;fini &agrave; partir des param&egrave;tres syst&egrave;me en mode syst&egrave;me (voir
&quot;Param&egrave;tres du syst&egrave;me&quot; on page 371 pour plus de d&eacute;tails)
Dans le menu de rotation, s&eacute;lectionner &laquo; Param&egrave;tres BSP &raquo;, puis l'onglet Mot de passe pour ouvrir la bo&icirc;te de dialogue mot
de passe d&eacute;fini.
Le mot de passe doit avoir au moins 5 caract&egrave;res.
Laisser &laquo; Ancien mot de passe &raquo; vide par d&eacute;faut si le mot de passe cible n’est pas r&eacute;gl&eacute;.
Cette fonction est disponible &agrave; partir des versions BSP V1.64 ARM UN30/31 et V2.73 MIPS UN20 fonctionnant
sous le syst&egrave;me d'exploitation WCE.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
379
380
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
R&eacute;tablir la configuration d’usine
Si vous rencontrez des probl&egrave;mes avec votre p&eacute;riph&eacute;rique IHM, vous pouvez tenter de r&eacute;tablir la configuration d'usine par
d&eacute;faut &agrave; partir du Mode syst&egrave;me.
1. Passez en Mode syst&egrave;me.
2. Utilisez l'une des op&eacute;rations suivantes disponibles dans le menu tournant :
l
Formater Flash, pour nettoyer le p&eacute;riph&eacute;rique flash et la configuration de registre.
l
R&eacute;tablir la configuration d'usine, pour nettoyer uniquement les composants s&eacute;lectionn&eacute;s.
Note : Aucune de ces op&eacute;rations n'implique le r&eacute;tablissement de la configuration d'usine pour les logiciels
(MainOS, ConfigOS, Bootloader, FPGA, images, etc.).
Voir &quot;Param&egrave;tres du syst&egrave;me&quot; on page 371pour plus de d&eacute;tails.
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
les produits AGI 400 offrent un outil int&eacute;gr&eacute; puissant appel&eacute; Param&egrave;tres du Syst&egrave;me qui permet la gestion et la mise &agrave;
niveau des composants du syst&egrave;me. Les op&eacute;rations peuvent &ecirc;tre effectu&eacute;es directement sur IHM ou &agrave; distance en utilisant
un navigateur Web.
Installation du runtime
Les p&eacute;riph&eacute;riques HMI sont livr&eacute;s hors d'usine sans Runtime, &agrave; la premi&egrave;re mise sous tension, IHM affiche l'&eacute;cran
&laquo; Chargeur de runtime &raquo;.
Le runtime peut &ecirc;tre install&eacute; :
l
Automatiquement, via Ethernet sur le premier t&eacute;l&eacute;chargement avec AGI Creator
l
Manuellement via cl&eacute; USB, cr&eacute;ation d'un &laquo; paquet de mise &agrave; jour &raquo;
Installation du Runtime via Ethernet
Pour l’installation du Runtime via Ethernet, suivre la proc&eacute;dure &quot;T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM&quot; on page 78.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
381
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
AVERTISSEMENT : Le t&eacute;l&eacute;chargement via Ethernet de l’installation du runtime requi&egrave;re le
p&eacute;riph&eacute;rique IHM avec une adresse IP valide.
L'adresse IP peut &ecirc;tre affect&eacute;e de trois mani&egrave;res :
l
l
l
Automatiquement via serveur DHCP. Cette option est activ&eacute;e par d&eacute;faut. Si un serveur DHCP est disponible sur le
r&eacute;seau, l’adresse IP sera attribu&eacute;e automatiquement par le serveur.
Automatiquement via la fonction Auto-IP. Si l'assignation DHCP est activ&eacute;e mais qu’aucun serveur DHCP n’est
disponible sur le r&eacute;seau, le p&eacute;riph&eacute;rique IHM s'attribue une adresse IP dans l’&eacute;chelle 169.254.xx avec un masque de
sous-r&eacute;seau 255.255.0.0
Manuellement via les Param&egrave;tres du Syst&egrave;me. Dans le menu Param&egrave;tres du Syst&egrave;me, dans la section r&eacute;seau,
l'adresse IP peut &ecirc;tre attribu&eacute;e manuellement, d&eacute;sactivant la fonction d'affectation du serveur DHCP.
Installation du runtime via la m&eacute;moire USB
Pour l’installation du runtime, UpdatePackage ou paquet de sauvegarde via un p&eacute;riph&eacute;rique USB, suivre cette proc&eacute;dure :
1. Cr&eacute;er un paquet de mise &agrave; jour depuis AGI Creator et copier dans une cl&eacute; m&eacute;moire USB vide
2. Sur le p&eacute;riph&eacute;rique HMI, s&eacute;lectionner [Startup sequence], puis [Install]
3. Double-cliquer sur &laquo; mnt &raquo; pour acc&eacute;der au dossier
382
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
4. Puis sur &laquo; usbmemory &raquo;
5. S&eacute;lectionner &laquo; UpdatePackage.zip &raquo; et confirmer en appuyant sur [Ok]
6. L’installation du runtime commence
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
383
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
Note : Les syst&egrave;mes de fichiers support&eacute;s sont FAT16/32 et Linux Ext2, Ext3 et Ext4.
Param&egrave;tres du syst&egrave;me
L'interface utilisateur des Param&egrave;tres syst&egrave;mes se base sur des pages HTML et il est possible d'y acc&eacute;der soit localement
sur l'&eacute;cran du p&eacute;riph&eacute;rique IHM, soit &agrave; distance en utilisant un navigateur web.
L'identifiant de l'administrateur en possession de tous les droits d'acc&egrave;s est &laquo; admin &raquo; et le mot de passe par d&eacute;faut est
&laquo; admin &raquo;. L'identifiant g&eacute;n&eacute;rique est &quot;user&quot; et le mot de passe par d&eacute;faut est &quot;user&quot;
AVERTISSEMENT : Pour des raisons de s&eacute;curit&eacute;, veuillez changer les mots de passe par d&eacute;faut pour
les deux identifiants (les mots de passe peuvent &ecirc;tre modifi&eacute;es &agrave; partir de la commande “Param&egrave;tres
syst&egrave;me -&gt; Authentification”)
L’acc&egrave;s aux param&egrave;tres du syst&egrave;me du p&eacute;riph&eacute;rique IHM ne n&eacute;cessite pas d'entrer un mot de passe tant que le
mot de passe &laquo; admin &raquo; par d&eacute;faut ne change pas.
Acc&egrave;s aux param&egrave;tres du syst&egrave;me depuis un navigateur Web
Pour acc&eacute;der aux Param&egrave;tres syst&egrave;me via un navigateur web, saisir l'adresse IP du p&eacute;riph&eacute;rique, selon le format suivant :
https://IP/machine_config
Note : L'acc&egrave;s &agrave; distance requiert un port 443.
Parcourir les options disponibles dans le menu &agrave; gauche : l'&eacute;l&eacute;ment actif est surlign&eacute; et les informations correspondantes
s'affichent sur la droite.
Les protocoles de s&eacute;curit&eacute; par d&eacute;faut propos&eacute;s par le serveur HTTPS dans le AGI 400 p&eacute;riph&eacute;rique IHM sont :
384
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
l
SSLv3 256 bits ECDHE-RSA-AES256-SHA
l
TLSv1 256 bits ECDHE-RSA-AES256-SHA
AVERTISSEMENT : Nous d&eacute;conseillons l'utilisation de suites de chiffrement CBC en cas de
connexions SSL3 ou TLSv1.0, car elles pourraient &ecirc;tre affect&eacute;es par des vuln&eacute;rabilit&eacute;s.
Acc&egrave;s aux param&egrave;tres du syst&egrave;me depuis un p&eacute;riph&eacute;rique IHM
Lorsque le Runtime n’est pas install&eacute;, les Param&egrave;tres du Syst&egrave;me sont accessibles &agrave; partir de l'&eacute;cran du chargeur de
runtime,
Lorsque le Runtime est install&eacute;, les Param&egrave;tres du syst&egrave;me sont accessibles en s&eacute;lectionnant l'option &laquo; Show System
Settings &raquo; du menu contextuel,
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
385
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
Entrer les Param&egrave;tres du syst&egrave;me via la proc&eacute;dure tap-tap
Tap-tap consiste en une s&eacute;quence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'&eacute;cran
tactile effectu&eacute; pendant la phase de mise sous tension et commenc&eacute; imm&eacute;diatement apr&egrave;s la mise sous tension de l’IHM.
Lorsque le message &laquo; tap-tap d&eacute;tect&eacute; &raquo; appara&icirc;t sur le haut de l'&eacute;cran. Attendre 5 secondes (sans toucher l'&eacute;cran) pour
entrer dans le sous-menu Param&egrave;tres du Syst&egrave;me
Attendre encore 5 secondes (sans toucher l'&eacute;cran) pour entrer en mode par D&eacute;faut
386
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
S&eacute;lectionner &laquo; Param&egrave;tres du Syst&egrave;me &raquo; depuis l'&eacute;cran du mode par d&eacute;faut IHM
Sections de Param&egrave;tres du syst&egrave;me
Pour modifier les valeurs des param&egrave;tres du syst&egrave;me, entrer en mode &eacute;dition en cliquant sur le bouton &Eacute;diter en haut &agrave;
droite.
Le bouton &Eacute;diter est disponible uniquement &agrave; l'int&eacute;rieur des bo&icirc;tes de dialogue qui contient les param&egrave;tres
modifiables.
Langues
S&eacute;lectionner la langue de l'interface des param&egrave;tres du syst&egrave;me
Syst&egrave;me
Param&egrave;tre
Description
Infos
Informations relatives au p&eacute;riph&eacute;rique
Status
&Eacute;tat du p&eacute;riph&eacute;rique (Free RAM, Up time, CPU Load)
Minuterie
Minuteurs p&eacute;riph&eacute;rique (System on, Back light on)
PlugIn
Informations sur les plugins mat&eacute;riau
Entr&eacute;es de journal
Fichiers log du p&eacute;riph&eacute;rique
Date &amp; heure
Date et heure du p&eacute;riph&eacute;rique. Param&egrave;tres disponibles en mode &eacute;dition :
Param&egrave;tre
Description
Fuseau horaire actuel
Fuseau horaire
Date actuelle
La date et l’heure peuvent &ecirc;tre d&eacute;fini manuellement uniquement lorsque la
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
387
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
Param&egrave;tre
Description
Heure locale
mise &agrave; jour automatique est d&eacute;sactiv&eacute;e.
Mise &agrave; jour automatique
(NTP)
Activer pour garder date et l'heure synchronis&eacute;es &agrave; partir d'un serveur distant
l
Serveur NTP
Sp&eacute;cifier l'adresse Internet du serveur NTP
R&eacute;seaux
Param&egrave;tres r&eacute;seau. Param&egrave;tre disponible en mode &eacute;dition :
Param&egrave;tre
Description
Param&egrave;tres g&eacute;n&eacute;raux
Adresse Interner du p&eacute;riph&eacute;rique
Interface r&eacute;seau
Param&egrave;tres r&eacute;seau des interfaces disponibles
DNS
l
DHCP
l
Adresse IP
l
Masque r&eacute;seau
l
Gateway
Serveurs DNS
En r&egrave;gle g&eacute;n&eacute;rale, fourni &agrave; partir des serveurs DHCP, mais peuvent &ecirc;tre
modifi&eacute;s en mode &eacute;dition
Rechercher domaines
Domaines facultatifs qui seront utilis&eacute;s dans la concat&eacute;nation avec les urls
fournies
Services
Les services sont disponibles uniquement lorsque vous &ecirc;tes connect&eacute; en tant qu'administrateur.
Cliquer sur la souris sur le bouton d'activation pour activer / d&eacute;sactiver le service. Cliquer sur le nom du service sur la liste
des param&egrave;tres associ&eacute;s.
Param&egrave;tre
Description
Avahi Daemon
Avahi est un syst&egrave;me qui permet aux programmes de publier et d&eacute;couvrir des
services et l’ex&eacute;cution d’h&ocirc;tes sur un r&eacute;seau local.
Service Cloud
Permet de g&eacute;rer les p&eacute;riph&eacute;riques IHM distants connect&eacute;s &agrave; un serveur
centralis&eacute; via des passerelles.
388
l
Type de serveur
l
Serveur
l
Identifiant
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Param&egrave;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&egrave;me
Activer le service de connexion syst&egrave;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 &ecirc;tes connect&eacute; en tant qu'administrateur.
Depuis la zone de gestion, il est possible d’effectuer &quot;Mise &agrave; jour des composants du syst&egrave;me&quot; on the next page du
p&eacute;riph&eacute;rique IHM.
AVERTISSEMENT : Travailler dans la zone de gestion est une op&eacute;ration critique et, lorsqu'elle n’est
pas effectu&eacute;e correctement, peut causer des dommages au produit n&eacute;cessitant un service du produit.
Contactez le support technique pour l'assistance.
Utiliser la commande &laquo; Effacer &raquo; dans la section &laquo; Donn&eacute;es &raquo; pour supprimer le runtime IHM &agrave; partir du p&eacute;riph&eacute;rique
(restauration param&egrave;tres d'usine)
Affichage
Param&egrave;tre
Description
Luminosit&eacute;
Niveau de luminosit&eacute; de l'&eacute;cran
D&eacute;lai de retour de lumi&egrave;re D&eacute;lai d'attente inactivit&eacute; arri&egrave;re plan
Orientation
Orientation de l'&eacute;cran
Red&eacute;marrer
Commande de red&eacute;marrage du p&eacute;riph&eacute;rique IHM
Authentification
Entrer en mode &eacute;dition pour modifier les mots de passe d'authentification.
EXIT
Sortir de l'outil des param&egrave;tres du syst&egrave;me.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
389
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
Mise &agrave; jour des composants du syst&egrave;me
AVERTISSEMENT : Travailler dans la zone de gestion est une op&eacute;ration critique et, lorsqu'elle n’est
pas effectu&eacute;e correctement, peut causer des dommages au produit n&eacute;cessitant un service du produit.
Contactez le support technique pour l'assistance.
Les composants du syst&egrave;me de l'appareil AGI 400 peuvent mettre &agrave; jour localement &agrave; l'aide d'une cl&eacute; USB ou &agrave; distance
via un navigateur Web.
Pour mettre &agrave; jour les composants du syst&egrave;me, entrer dans Param&egrave;tres du syst&egrave;me en mode Config OS via la proc&eacute;dure
tap-tap sur IHM ou ouvrir le navigateur Web sur https: // &lt;HMI-IP-address&gt; et s&eacute;lectionner la section &laquo; Gestion &raquo;.
D&eacute;velopper le composant &agrave; mettre &agrave; jour et s&eacute;lectionner [Mise &agrave; jour]
Sur la bo&icirc;te de dialogue ouverte, cliquer sur [Parcourir image], puis s&eacute;lectionner le fichier &laquo; xxx-Mainos-xxx.tar.gz &raquo;.
Cliquer ensuite sur [Parcourir MD5] et s&eacute;lectionner le fichier &laquo; xxx-Mainos-xxx.tar.gz.md5 &raquo;.
Important : Ne pas &eacute;teindre le p&eacute;riph&eacute;rique pendant qu’un composant du syst&egrave;me est en cours de
mise &agrave; niveau.
390
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
&Agrave; la fin de la mise &agrave; jour des composants, red&eacute;marrer le p&eacute;riph&eacute;rique IHM et le laisser d&eacute;marrer normalement.
Entrer les Param&egrave;tres en mode Config OS du syst&egrave;me via la proc&eacute;dure tap-tap
Le Param&egrave;tre en mode Config OS est disponible via la s&eacute;quence tap-tap et peut &ecirc;tre consult&eacute;e &eacute;galement lorsque IHM est
confront&eacute; &agrave; une panne de logiciel.
Tap-tap consiste en une s&eacute;quence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'&eacute;cran
tactile effectu&eacute; pendant la phase de mise sous tension et commenc&eacute; imm&eacute;diatement apr&egrave;s la mise sous tension de l’IHM.
Lorsque le message &laquo; tap-tap d&eacute;tect&eacute;&quot; appara&icirc;t sur le haut de l'&eacute;cran, appuyer et maintenir le doigt sur l'&eacute;cran tactile, pour
s&eacute;lectionner &laquo; Restauration: Config OS &raquo;
IHM red&eacute;marrera dans Param&egrave;tres syst&egrave;me en mode OS Config:
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
391
Param&egrave;tres du Syst&egrave;me sur les P&eacute;riph&eacute;riques Linux
392
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Calibrage de l'&eacute;cran tactile
Le calibrage du param&egrave;tre du syst&egrave;me permet de calibrer le p&eacute;riph&eacute;rique &agrave; &eacute;cran tactile, peut &ecirc;tre consult&eacute; par proc&eacute;dure
tap-tap.
Tap-tap consiste en une s&eacute;quence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'&eacute;cran
tactile effectu&eacute; pendant la phase de mise sous tension et commenc&eacute; imm&eacute;diatement apr&egrave;s la mise sous tension de l’IHM.
Lorsque le message &laquo; tap-tap d&eacute;tect&eacute; &raquo; appara&icirc;t sur le haut de l'&eacute;cran, attendre 5 secondes (sans toucher l'&eacute;cran) pour
entrer dans le sous-menu Param&egrave;tres de syst&egrave;me
Appuyer sur l'&eacute;cran tactile, la voix &laquo; calibrage de l'&eacute;cran tactile &raquo; sera surlign&eacute;e en jaune, maintenir enfonc&eacute; pendant
quelques secondes jusqu'&agrave; ce que la proc&eacute;dure de calibrage de l'&eacute;cran tactile commence
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
393
Suivre les instructions affich&eacute;es sur l'&eacute;cran pour terminer la proc&eacute;dure de calibrage, le syst&egrave;me vous demandera de toucher
des points sp&eacute;cifiques pour calibrer le p&eacute;riph&eacute;rique &agrave; &eacute;cran tactile.
394
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
Protection du mot de passe
Mot de passe interne du p&eacute;riph&eacute;rique IHM.
Dans l'onglet Authentification, dans les &quot;Param&egrave;tres du syst&egrave;me&quot; on page 384, activer le mode &eacute;dition et s&eacute;lectionner le
nom d'utilisateur pour modifier le mot de passe associ&eacute;.
Le mot de passe pour l'utilisateur admin peut modifier, m&ecirc;me dans le menu contextuel de HMI Runtime (voir
&quot;Options de menu contextuel&quot; on page 8 pour plus de d&eacute;tails).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
395
396
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
R&eacute;tablir la configuration d’usine
Le mode par d&eacute;faut des Param&egrave;tres du syst&egrave;me permet de d&eacute;sinstaller le runtime IHM ou de modifier la s&eacute;quence de
d&eacute;marrage, ce mode est disponible via la s&eacute;quence tap-tap et peut &ecirc;tre consult&eacute;e &eacute;galement lorsque IHM est confront&eacute; &agrave;
une panne de logiciel.
Tap-tap consiste en une s&eacute;quence de plusieurs activations tactiles par des moyens simples du doigt en tapant sur l'&eacute;cran
tactile effectu&eacute; pendant la phase de mise sous tension et commenc&eacute; imm&eacute;diatement apr&egrave;s la mise sous tension de l’IHM.
Lorsque le message &laquo; tap-tap d&eacute;tect&eacute; &raquo; appara&icirc;t sur le haut de l'&eacute;cran. Attendre 5 secondes (sans toucher l'&eacute;cran) pour
entrer dans le sous-menu Param&egrave;tres du Syst&egrave;me
Attendre encore 5 secondes (sans toucher l'&eacute;cran) pour entrer en mode par D&eacute;faut
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
397
Pour d&eacute;sinstaller le runtime depuis HMI dans la s&eacute;lection de l’&eacute;cran du Mode par D&eacute;faut [Startup Sequence] :
S&eacute;lectionner le runtime &agrave; retirer (1) et cliquer sur le bouton [Uninstall] (2) :
Le processus de d&eacute;sinstallation de runtime sera effectu&eacute; :
398
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
399
400
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
44
Acc&egrave;s web
AGI Web permet aux utilisateurs d'acc&eacute;der aux projets IHM &agrave; partir d'un navigateur web distant ex&eacute;cut&eacute; sur un ordinateur
ou sur un p&eacute;riph&eacute;rique portable, tel qu'une tablette ou un t&eacute;l&eacute;phone. Avec AGI Web, les utilisateurs peuvent cr&eacute;er un projet
web qui leur permet d'afficher sur un emplacement distant le m&ecirc;me affichage graphique que celui apparaissant sur le
p&eacute;riph&eacute;rique IHM. Les projets AGI Webse basent sur une technologie HTML5, qui ne n&eacute;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&eacute;riph&eacute;riques portables ainsi que de la mani&egrave;re d'&eacute;tablir une connexion au p&eacute;riph&eacute;rique IHM qui ex&eacute;cute le serveur. Par
exemple, si vous travaillez avec une tablette ou un t&eacute;l&eacute;phone, vous devez savoir comment configurer un acc&egrave;s Wi-Fi afin
de pouvoir acc&eacute;der aux pages AGI Web sur le p&eacute;riph&eacute;rique IHM.
Plateformes et navigateurs pris en charge
402
Cr&eacute;er une page pour acc&egrave;s web
402
Pages d'accueil de plateforme sp&eacute;cifiques
404
Tester projet web
404
T&eacute;l&eacute;charger projet web
405
Probl&egrave;mes de connectivit&eacute; web
406
Fonctionnalit&eacute;s web prises en charge
408
R&eacute;solution des probl&egrave;mes et FAQ
411
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;l&eacute;phone, pour les p&eacute;riph&eacute;riques smartphone
l
tablette, pour les p&eacute;riph&eacute;riques tablettes
Vous pouvez donc cr&eacute;er des pages de contenu et de taille diff&eacute;rentes pour les diff&eacute;rentes plateformes. Par exemple, vous
pouvez cr&eacute;er un ensemble de petites pages dans votre projet pour les t&eacute;l&eacute;phones m&ecirc;me si vous allez utiliser des pages de
taille r&eacute;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 &eacute;t&eacute; test&eacute;s pour la
compatibilit&eacute; 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&eacute;l&eacute;phones
AGI Web travailler avec la plupart des p&eacute;riph&eacute;riques tablettes ou t&eacute;l&eacute;phones. Les tablettes suivantes ont &eacute;t&eacute; test&eacute;es pour
la compatibilit&eacute; avec AGI Web :
l
iOS 4+ - Mobile Safari
l
Android 7+ - Android Webkit
Cr&eacute;er une page pour acc&egrave;s web
Chemin : Affichage du projet&gt; Web &gt; Pages
Cliquez avec le bouton droit sur le nœud des Pages et s&eacute;lectionnez Ins&eacute;rer une page pour ajouter une page web.
402
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
44 Acc&egrave;s web
Tous les widgets et les fonctionnalit&eacute;s peuvent &ecirc;tre utilis&eacute;s dans AGI Creator; cependant, toutes les fonctionnalit&eacute;s ne
sont pas actuellement disponibles dans AGI Web. Si le projet inclut une fonctionnalit&eacute; qui n'est pas disponible, AGI Web
fonctionnera quand m&ecirc;me correctement, mais cette fonctionnalit&eacute; ne sera pas disponible sur le p&eacute;riph&eacute;rique client distant.
Voir &quot;Fonctionnalit&eacute;s web prises en charge&quot; on page 408 pour avoir la liste des fonctionnalit&eacute;s support&eacute;es dans AGI Web et
des limites existantes.
Exporter des pages
Pour s&eacute;lectionner des pages &agrave; exporter &agrave; partir du projet actuel.
1. Dans le menu Ex&eacute;cuter, cliquez sur Param&egrave;tres de projet web : la bo&icirc;te de dialogue des Param&egrave;tres de projet
web appara&icirc;tra.
2. S&eacute;lectionnez les pages web que vous souhaitez exporter. Par d&eacute;faut, toutes les pages de projet et de dialogue sont
s&eacute;lectionn&eacute;es.
3. Pour chaque plateforme, s&eacute;lectionnez l'ic&ocirc;ne d'accueil pr&egrave;s de la page que vous souhaitez d&eacute;finir comme page
d'accueil. Il n'est possible de s&eacute;lectionner qu'une page d'accueil pour chaque plateforme. Toutes les autres ic&ocirc;nes
d'accueil sont gris&eacute;es.
AVERTISSEMENT : Lorsque vous t&eacute;l&eacute;chargez un projet sur le p&eacute;riph&eacute;rique IHM, assurez-vous
que l'option T&eacute;l&eacute;charger le projet web est s&eacute;lectionn&eacute;e.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
403
Pages d'accueil de plateforme sp&eacute;cifiques
Pages d'accueil de plateforme sp&eacute;cifiques
La Page d'accueil du projet AGI Web correspond &agrave; la premi&egrave;re page qui s'affiche dans le navigateur pour chaque type de
plateforme et repr&eacute;sente le point de d&eacute;part pour votre projet web. Les pages pouvant &ecirc;tre acc&eacute;d&eacute;es &agrave; partir d'une page
d'accueil d&eacute;pendent des liens existant entre ces pages et le projet.
Par exemple, si vous avez con&ccedil;u un ensemble de pages destin&eacute; &agrave; une plateforme t&eacute;l&eacute;phonique, d&eacute;finissez comme page
d'accueil une page de taille appropri&eacute;e &agrave; un &eacute;cran de t&eacute;l&eacute;phone portable. Puis, n'incluez dans cette page que des liens vers
d'autres pages t&eacute;l&eacute;phoniques : l'utilisateur n'acc&egrave;dera qu'aux pages t&eacute;l&eacute;phoniques lorsqu'il naviguera dans le projet AGI
Web &agrave; partir d'un t&eacute;l&eacute;phone.
Tester projet web
Vous pouvez tester votre AGI Web projet en utilisant le simulateur en ligne ouvrant une page Internet autonome
directement &agrave; partir d'un navigateur.
Test avec le simulateur en ligne
AGI Creator comprend un serveur Internet dans le simulateur en ligne. Vous pouvez d&eacute;marrer le simulateur et acc&eacute;der &agrave;
votre AGI Web projet &agrave; partir d’un navigateur Internet. Les pages seront servies &agrave; partir du simulateur.
1. Cr&eacute;er votre projet (voir &quot;Cr&eacute;er une page pour acc&egrave;s web&quot; on page 402).
2. Sur le fichier Ex&eacute;cution, choisissez D&eacute;marrage Simulateur : le projet d&eacute;marrera dans une fen&ecirc;tre s&eacute;par&eacute;e.
3. Ouvrir un navigateur Internet (voir &quot;Plateformes et navigateurs pris en charge &quot; 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 &agrave; partir
de l'ordinateur local et d’utiliser le port 81, utilis&eacute; par d&eacute;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&ecirc;ter et red&eacute;marrer le simulateur.
404
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
44 Acc&egrave;s web
Note : Si vous utilisez un p&eacute;riph&eacute;rique (par exemple, un smartphone) qui n’est pas l’ordinateur h&ocirc;te local o&ugrave; le
simulateur est en cours d'ex&eacute;cution, il vous sera demand&eacute; d'entrer le nom d'utilisateur et le mot de passe.
T&eacute;l&eacute;charger projet web
Apr&egrave;s avoir test&eacute; les pages du AGI Web, vous pouvez t&eacute;l&eacute;charger le projet sur le p&eacute;riph&eacute;rique IHM choisi.
Le projet AGI Web est t&eacute;l&eacute;charg&eacute; avec le projet AGI Creator, voir &quot;T&eacute;l&eacute;charger vers le p&eacute;riph&eacute;rique IHM&quot; on page 78 pour
plus de d&eacute;tails.
Lorsque le processus de t&eacute;l&eacute;chargement est termin&eacute;, le projet IHM d&eacute;marre automatiquement sur le p&eacute;riph&eacute;rique IHM et le
projet AGI Web est pr&ecirc;t &agrave; &ecirc;tre utilis&eacute;.
Ex&eacute;cuter AGI Web depuis un navigateur
1. Ouvrez un navigateur web et entrez l'adresse IP de votre p&eacute;riph&eacute;rique IHM : la page de connexion s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
405
Probl&egrave;mes de connectivit&eacute; web
2. Entez le Nom d'utilisateur et le Mot de passe, puis cliquez sur Se connecter : la page d'accueil s'affiche.
Voir &quot;Gestion et mots de passe utilisateur&quot; on page 217 pour des d&eacute;tails sur la cr&eacute;ation d'informations d'identification.
Vous pouvez interagir avec le projet en utilisant le navigateur de la m&ecirc;me mani&egrave;re que vous interagissez avec un
p&eacute;riph&eacute;rique lorsque vous touchez l'&eacute;cran : cliquez sur les boutons pour changer de page, affichez les indicateurs et les
jauges, d&eacute;placez les poign&eacute;es de barre de d&eacute;filement pour changer de valeurs, etc. Le projet AGI Web g&egrave;re toutes les
communications avec le serveur web lorsque vous interagissez avec le p&eacute;riph&eacute;rique IHM &agrave; distance.
Probl&egrave;mes de connectivit&eacute; web
Vous trouverez ci-dessous une description des probl&egrave;mes les plus fr&eacute;quemment rencontr&eacute;s lors des connexions &agrave; distance
avec le p&eacute;riph&eacute;rique IHM.
D&eacute;connexion du serveur
&Eacute;tant donn&eacute; que AGI Web est ex&eacute;cut&eacute; &agrave; distance depuis le p&eacute;riph&eacute;rique IHM, le serveur pourrait se d&eacute;connecter du
navigateur (par exemple si le serveur est interrompu ou si le c&acirc;ble de r&eacute;seau est d&eacute;branch&eacute;). Si cela se produit, une ic&ocirc;ne
'd&eacute;connexion' appara&icirc;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 | &copy; 2012-2017 DEIF A/S
44 Acc&egrave;s web
D&egrave;s que le serveur retourne en ligne, l'ic&ocirc;ne repr&eacute;sentant un cercle rouge barr&eacute; dispara&icirc;t, signe que la communication avec
le p&eacute;riph&eacute;rique est redevenue normale.
Note : Si vous faites des modifications dans les pages AGI Webpendant que le serveur est d&eacute;connect&eacute;, ces
modifications seront visibles sur le client mais ne seront pas transmises au serveur tant que la connexion n'aura
pas &eacute;t&eacute; r&eacute;tablie.
D&eacute;lai d'attente d'inactivit&eacute;
AGI Web vous demandera de vous r&eacute;identifier si le navigateur est rest&eacute; inactif pendant plusieurs minutes. Si aucune
activit&eacute; n'est d&eacute;tect&eacute;e dans un d&eacute;lai de 10 minutes, l'&eacute;cran de connexion appara&icirc;tra et vous devrez indiquer vos
informations d'identification avant de pouvoir poursuivre vos activit&eacute;s. Cette fonctionnalit&eacute; de d&eacute;lai d'attente vous garantit
contre tout acc&egrave;s non autoris&eacute;. Le d&eacute;lai d'attente d'inactivit&eacute; web peut &ecirc;tre modifi&eacute; &agrave; partir du tableau Propri&eacute;t&eacute; du projet.
Fermeture de session utilisateur
Une session utilisateur peut &ecirc;tre ferm&eacute;e soit par le serveur, soit pas l'utilisateur.
Dans des situations particuli&egrave;res, le serveur peut envoyer une demande au client (navigateur) d'effectuer la proc&eacute;dure de
connexion. Dans ce cas, l'utilisateur est redirig&eacute; 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&eacute;moire cache ou les cookies du navigateur.
Note : Si l'utilisateur travaillait dans une bo&icirc;te de dialogue au moment d'&ecirc;tre redirig&eacute; vers la page de connexion, il
sera ensuite redirig&eacute; vers la page &agrave; partir de laquelle la bo&icirc;te de dialogue avait &eacute;t&eacute; 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&eacute;riph&eacute;rique.
Dans ce cas, une bo&icirc;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&eacute;alisez dans le navigateur pourraient ne pas &ecirc;tre
ex&eacute;cut&eacute;es correctement, &eacute;tant donn&eacute; que le AGI Webne peut pas effectuer de communications li&eacute;es au serveur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
407
Fonctionnalit&eacute;s web prises en charge
Fonctionnalit&eacute;s web prises en charge
Actuellement, toutes les fonctionnalit&eacute;s AGI Creatorne sont pas prises en charge dans AGI Web. Voici une liste des
fonctionnalit&eacute;s support&eacute;es et les limites correspondantes, class&eacute;es par cat&eacute;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. &Eacute;ventuellement supprimer les
objets non pris en charge &agrave; partir de la page Web apr&egrave;s avoir coll&eacute;.
408
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
44 Acc&egrave;s web
Cat&eacute;gorie
Widgets
Fonctionnalit&eacute;s support&eacute;es
l
Basique (Texte/Num&eacute;rique, Images, Formes,
Tendances/Graphiques, Recettes, Contr&ocirc;les, Alarmes, Texture)
l
Boutons
l
M&egrave;tres
l
S&eacute;lecteurs
l
Voyants
l
M&eacute;dias (Cam&eacute;ra IP)
l
Ic&ocirc;nes
l
Automatisation industrielle
Limites
l
l
l
l
l
l
Alarmes
l
Les limites d'alarme dans AGI Websont les m&ecirc;mes que pour le
p&eacute;riph&eacute;rique IHM (500..2000 selon la cible)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
l
La fonction
AttachToTag des
variables du syst&egrave;me
n'est pas support&eacute;e
Les fichiers de police
pour lesquels le
drapeau de permission
de t&eacute;l&eacute;chargement via
Internet n'a pas &eacute;t&eacute;
activ&eacute;, ne sont pas
charg&eacute;s &agrave; partir de AGI
Web
Les propri&eacute;t&eacute;s de
widget avec le
comportement
dynamique Associer &agrave;
... pourraient ne pas
fonctionner pour toutes
les propri&eacute;t&eacute;s
support&eacute;es par AGI
Creator.
Le multi-couche
d'image multi-&eacute;tat n'est
pas support&eacute;.
La couleur d'alarme en
fonction de la condition
de d&eacute;clenchement
n'est pas support&eacute;e sur
le web
Ne peut pas modifier
les widgets d'alarme en
cours de runtime
Sur les
smartphones/tablettes
(p&eacute;riph&eacute;riques
g&eacute;n&eacute;ralement int&eacute;gr&eacute;s)
en fonction du mat&eacute;riel,
un utilisateur peut
s'attendre &agrave; des
probl&egrave;mes de
performance avec &gt;
500 alarmes.
409
Fonctionnalit&eacute;s web prises en charge
Cat&eacute;gorie
Actions
Fonctionnalit&eacute;s support&eacute;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&egrave;me (DumpTrend, DeleteTrend, DeleteEventArchive)
l
Claviers
Widgets (Javascript)
l
l
XForms
Limites
Les actions de page ne
sont pas support&eacute;es
dans des conditions de
d&eacute;clenchement
d'alarme
Recettes (DownLoadRecipe, UpLoadRecipe,
WriteCurrentRecipeSet, DownLoadCurRecipe,
UpLoadCurRecipe, ResetRecipe, DumpRecipeData,
RestoreRecipeData, AddRecipeDataSet, DelRecipeDataSet)
l
Mise &agrave; l'&eacute;chelle
l
Offset
l
ColorPalette
l
BitIndex
l
Seuls les widgets de claviers num&eacute;riques sont support&eacute;s.
l
l
JavaScript est
support&eacute; (voir
&quot;JavaScript &quot; on
page 325chapitre
JavaScript pour
consulter la liste des
fonctionnalit&eacute;s
support&eacute;es)
l
Support&eacute;e, vous pouvez l'afficher et la fermer &agrave; l'aide des actions
ShowDialog et CloseDialog.
l
l
Certains param&egrave;tres ne
supportent pas la
fonctionnalit&eacute;
ColorPalette.
Les claviers
personnalis&eacute;s ne sont
pas support&eacute;s. Le
clavier num&eacute;rique
s'affichera en tant que
widget num&eacute;rique en
mode lecture/&eacute;criture
ou &eacute;criture seule.
Les pages de dialogue
ne supportent que les
bo&icirc;tes de dialogue
modales.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
44 Acc&egrave;s web
Cat&eacute;gorie
Gestion des
utilisateurs
Connexions
d'utilisateurs
simultan&eacute;s
Fonctionnalit&eacute;s support&eacute;es
l
l
Le m&eacute;canisme de connexion v&eacute;rifie les informations
d'identification de l'utilisateur sur le serveur. L'identifiant et le mot
de passe d&eacute;pendent des informations d'identification d&eacute;finies
dans Gestion des utilisateurs.
Le serveur web du p&eacute;riph&eacute;rique IHM supporte jusqu'&agrave; trois
connexions simultan&eacute;es.
Limites
l
l
Les param&egrave;tres de
s&eacute;curit&eacute; individuels
appliqu&eacute;s aux widgets
ou aux pages ne sont
pas support&eacute;s.
Si plus de 3 utilisateurs
tentent de se connecter
&agrave; partir de navigateurs
distants, seuls les 3
premiers seront
autoris&eacute;s.
Travailler avec des claviers dans AGI Web
L'utilisateur peut cliquer sur le widget num&eacute;rique et une zone de texte appara&icirc;tra dans laquelle la nouvelle valeur pourra &ecirc;tre
renseign&eacute;e.
Une fois la valeur renseign&eacute;e, l'utilisateur peut soit appuyer sur la touche Entr&eacute;e, ou &eacute;quivalent sur les p&eacute;riph&eacute;riques
tactiles, soit cliquer sur Sauvegarder pour rendre cette valeur permanente. Seuls les nombres pertinents seront accept&eacute;s
lors du processus de sauvegarde. Les &eacute;l&eacute;ments non pertinents seront ignor&eacute;s et n'entra&icirc;neront aucune modification de
valeur.
R&eacute;solution des probl&egrave;mes et FAQ
Activer JavaScript
AGI Web requiert JavaScript pour fournir l’interactivit&eacute; avec le serveur et l’utilisateur. AGI Web ne fonctionnera pas si
JavaScript est d&eacute;sactiv&eacute; dans votre navigateur.
Par d&eacute;faut, la plupart des navigateurs ont JavaScript activ&eacute;. Si vous avez d&eacute;sactiv&eacute; JavaScript dans le pass&eacute;, veuillez
r&eacute;activer JavaScript avant d'acc&eacute;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 &agrave; t&eacute;l&eacute;charger sur le r&eacute;seau qui augmente le temps n&eacute;cessaire pour charger
la AGI Web page dans votre navigateur. La mise en cache du navigateur permet &agrave; ces ressources d’&ecirc;tre sauv&eacute;es par un
navigateur et utilis&eacute;s sans effectuer la demande &agrave; chaque fois &agrave; partir du serveur. Cela se traduit par un chargement plus
rapide des AGI Web pages.
La mise en ant&eacute;m&eacute;moire est normalement activ&eacute;e par d&eacute;faut, pour des performances AGI Web optimales, s’assurer qu’elle
n’a pas &eacute;t&eacute; d&eacute;sactiv&eacute;e.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
411
R&eacute;solution des probl&egrave;mes et FAQ
Note : AGI Web pages fonctionneront toujours correctement avec la mise en ant&eacute;m&eacute;moire d&eacute;sactiv&eacute;e du
navigateur, mais le temps de chargement des ressources sera plus lent par rapport aux op&eacute;rations mises en
cache normales.
Utilisation d’un proxy
Certains utilisateurs pourraient acc&eacute;der au AGI Web projet via le proxy. Les proxy peuvent contr&ocirc;ler le nombre de
connexion en parall&egrave;le pour le navigateur.
S'assurer que les connexions parall&egrave;les maximales autoris&eacute;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 ?
&Agrave; chaque fois qu'une nouvelle page Internet est ajout&eacute;e &eacute;dit&eacute;e dans le projet, vous devez t&eacute;l&eacute;charger le projet sur le
p&eacute;riph&eacute;rique. Cependant, lorsque vous connectez l'adresse IP du p&eacute;riph&eacute;rique, le navigateur Internet peut afficher des
pages en cache au lieu des derni&egrave;res pages t&eacute;l&eacute;charg&eacute;es. Pour &eacute;viter ce probl&egrave;me, vous pouvez :
l
d&eacute;sactiver le cache de votre navigateur Internet
l
forcer le rafra&icirc;chissement de la page Internet
l
contourner le cache du navigateur
412
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
45 Mettre &agrave; jour les composants
syst&egrave;me des p&eacute;riph&eacute;riques IHM
La plupart des composants logiciels du syst&egrave;me peut &ecirc;tre facilement mis &agrave; jour en assurant un degr&eacute; &eacute;lev&eacute; de flexibilit&eacute;
dans la fourniture de mises &agrave; jour et des correctifs aux syst&egrave;mes existants et en cours d'ex&eacute;cution.
Des nouveaux modules logiciels peuvent &ecirc;tre mis &agrave; jour
l
l
Directement sur le p&eacute;riph&eacute;rique IHM en utilisant un des lecteurs flash USB (voir &quot;Param&egrave;tres du syst&egrave;me&quot; on
page 369 pour plus de d&eacute;tails)
Depuis l’application AGI Creator (voir &quot;Mise &agrave; jour des composants syst&egrave;me de l’application&quot; on the next page pour
plus de d&eacute;tails)
Chaque p&eacute;riph&eacute;rique IHM est &eacute;tiquet&eacute; avec un code de produit, y compris tous les param&egrave;tres d'usine (mat&eacute;riel, logiciels et
composants de firmware). Se r&eacute;f&eacute;rer &agrave; cette &eacute;tiquette pour obtenir des informations sur votre p&eacute;riph&eacute;rique IHM. L'outil de
mise &agrave; jour du p&eacute;riph&eacute;rique IHM fournit &eacute;galement des d&eacute;tails sur les composants effectivement en cours d'ex&eacute;cution sur le
p&eacute;riph&eacute;rique.
AVERTISSEMENT : S’assurer d'utiliser les fichiers de mise &agrave; niveau corrects, puisque le chargement
de fichiers de mise &agrave; niveau inappropri&eacute;s pour votre p&eacute;riph&eacute;rique provoquera un dysfonctionnement
grave du syst&egrave;me. Toujours v&eacute;rifier le code produit de votre p&eacute;riph&eacute;rique.
Note : Les fichiers de mise &agrave; niveau sont distribu&eacute;s sur demande comme une partie de l'activit&eacute; de support
technique.
Assistance t&eacute;l&eacute;phonique : Les op&eacute;rations de d&eacute;classement sont des t&acirc;ches complexes qui pourraient causer de
graves dommages &agrave; votre &eacute;quipement ne fonctionne pas correctement. Ces op&eacute;rations sont r&eacute;serv&eacute;s &agrave;
l'assistance technique.
Mise &agrave; jour des composants syst&egrave;me de l’application
414
Param&eacute;trages
415
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
413
Mise &agrave; jour des composants syst&egrave;me de l’application
Mise &agrave; jour des composants syst&egrave;me de l’application
Vous pouvez t&eacute;l&eacute;charger les composants du syst&egrave;me sur un p&eacute;riph&eacute;rique IHM unique ou sur un grand nombre de
p&eacute;riph&eacute;riques IHM du m&ecirc;me type en utilisant l'interface de communication Ethernet.
Chemin : Ex&eacute;cuter&gt; G&eacute;rer cible&gt; Carte
1. S&eacute;lectionner le dossier qui contient les fichiers &agrave; t&eacute;l&eacute;charger sur les p&eacute;riph&eacute;riques IHM ou o&ugrave; les fichiers de
t&eacute;l&eacute;chargement des p&eacute;riph&eacute;riques IHM
2. S&eacute;lectionner un ou plusieurs p&eacute;riph&eacute;riques IHM.
3. S&eacute;lectionnez les composants que vous t&eacute;l&eacute;chargerez (ou chargerez) vers/depuis les dispositifs
4. D&eacute;marrer le t&eacute;l&eacute;chargement pour les p&eacute;riph&eacute;riques IHM ou le chargement depuis le fonctionnement des
p&eacute;riph&eacute;riques IHM
Note :
l
l
l
l
l
L’outil est con&ccedil;u pour mettre &agrave; jour un grand nombre de p&eacute;riph&eacute;riques HMI du m&ecirc;me type, &eacute;viter de mettre des
fichiers pour le type de p&eacute;riph&eacute;rique diff&eacute;rent dans le m&ecirc;me dossier
Si l’IP d&eacute;sir&eacute;e n’est pas list&eacute;e, la taper directement dans la bo&icirc;te de dialogue. Le service D&eacute;couverte est un service
de diffusion. Quand une connexion &agrave; distance se fait via VPN ou depuis des r&eacute;seaux externes, elle ne fonctionnera
pas et vous devrez saisir l'adresse manuellement.
Le t&eacute;l&eacute;chargement des composants s&eacute;lectionn&eacute;s sera effectu&eacute; uniquement sur des p&eacute;riph&eacute;riques compatibles
Sur la base de vos capacit&eacute;s de r&eacute;seau et de mat&eacute;riel, vous pouvez augmenter les appareils num&eacute;riques &agrave; mettre &agrave;
jour en parall&egrave;le
Vous devez red&eacute;marrer le p&eacute;riph&eacute;rique IHM pour finaliser la mise &agrave; jour.
414
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
45 Mettre &agrave; jour les composants syst&egrave;me des p&eacute;riph&eacute;riques IHM
Param&eacute;trages
Depuis l'onglet Param&egrave;tres, vous pouvez sp&eacute;cifier le Port et les param&egrave;tres de Mot de passe &agrave; utiliser pour communiquer
avec les p&eacute;riph&eacute;riques IHM. Laissez mot de passe vide si aucun mot de passe n'est d&eacute;fini du c&ocirc;t&eacute; du p&eacute;riph&eacute;rique IHM.
AVERTISSEMENT : Le mode en grand nombre fonctionne uniquement avec les p&eacute;riph&eacute;riques IHM qui
ont les m&ecirc;mes param&egrave;tres de connexion
Chargement de l’image de d&eacute;marrage
Vous pouvez remplacer l'image de d&eacute;marrage par d&eacute;faut affich&eacute;e par les p&eacute;riph&eacute;riques pendant la phase de mise sous
tension.
L'image utilis&eacute;e comme image de d&eacute;marrage doit &ecirc;tre conforme aux exigences suivantes :
FileName
splash.bmp
Format
Bitmap, RGB 565 format
Taille
&lt; 500 KB
Largeur bitmap
M&ecirc;me des nombres (par exemple 430x239)
Pour charger l’image de d&eacute;marrage :
1. Renommez la nouvelle image splash.bmp et copiez-la dans le dossier source.
2. S&eacute;lectionnez les p&eacute;riph&eacute;riques IHM
3. Cliquez sur T&eacute;l&eacute;charger.
Pour assurer les meilleurs r&eacute;sultats visuels, les images de d&eacute;marrage doivent avoir un fond noir.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
415
Param&eacute;trages
416
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
46 Prot&eacute;ger l’acc&egrave;s aux
p&eacute;riph&eacute;riques IHM
Les op&eacute;rations suivantes sont prot&eacute;g&eacute;es par mot de passe sur le p&eacute;riph&eacute;rique IHM :
l
l
Gestion de HMI Runtime : installer HMI Runtime et mettre &agrave; jour HMI Runtime
Gestion de carte : remplacer les principaux composants BSP tels que le syst&egrave;me d'exploitation principal, la
configuration du syst&egrave;me d'exploitation, le bootloader, etc.
l
T&eacute;l&eacute;charger et charger des fichiers de projet
l
Services en option sur les p&eacute;riph&eacute;riques Linux (par ex. protocole SSH, Serveur VNC)
AVERTISSEMENT : L’acc&egrave;s non autoris&eacute; au p&eacute;riph&eacute;rique peut causer des dommages ou d&eacute;faillances.
Lorsque vous connectez le p&eacute;riph&eacute;rique &agrave; un r&eacute;seau, prot&eacute;gez-le contre les acc&egrave;s non autoris&eacute;s.
Voici une liste non exhaustive des mesures vous permettant de prot&eacute;ger le r&eacute;seau :
l
Pare-feu
l
Syst&egrave;me de pr&eacute;vention d'intrusion (IPS)
l
Segmentation du r&eacute;seau
l
R&eacute;seau local virtuel (VLAN)
l
R&eacute;seau priv&eacute; virtuel (VPN)
l
S&eacute;curit&eacute; au niveau de l’acc&egrave;s physique (s&eacute;curit&eacute; de port).
Pour plus d’informations, des directives et des normes concernant la s&eacute;curit&eacute; dans le domaine de l’informatique : IEC
62443, ISO/IEC 27001.
Changer de mot de passe sur le p&eacute;riph&eacute;rique IHM
418
Ports et pare-feux
418
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
417
Changer de mot de passe sur le p&eacute;riph&eacute;rique IHM
Changer de mot de passe sur le p&eacute;riph&eacute;rique IHM
Pour changer de mot de passe sur le p&eacute;riph&eacute;rique IHM, utilisez l'une des m&eacute;thodes suivantes :
l
l
l
Depuis le menu contextuel du HMI Runtime : Param&egrave;tres&gt; onglet Mot de passe.
Utilisez la fonction Configurer mot de passe cible dans le paquet de mise &agrave; jour : le mot de passe est mis &agrave; jour
par HMI Runtime apr&egrave;s la fin du processus de mise &agrave; jour.
Utilisation de l’outil &quot;Param&egrave;tres du syst&egrave;me&quot; on page 369 du p&eacute;riph&eacute;rique IHM
Laisser &laquo; Ancien mot de passe &raquo; vide par d&eacute;faut si le mot de passe cible n’est pas r&eacute;gl&eacute;.
Pour Win32 HMI Runtime, le mot de passe est sauvegard&eacute; 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&eacute;s par les composants AGI SW Pack.
Port
Utilisation
Acc&egrave;s &agrave;
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&eacute;es FTP (mode passif)
-
Oui
Oui
990/udp
Diffusion UDP (D&eacute;tection
p&eacute;riph&eacute;rique)
-
Optionnel
Optionnel
418
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
46 Prot&eacute;ger l’acc&egrave;s aux p&eacute;riph&eacute;riques IHM
Acc&egrave;s &agrave;
distance
Gestion de
carte
Runtime/Gestion de
projet
Diffusion UDP (D&eacute;tection
p&eacute;riph&eacute;rique)
-
Optionnel
Optionnel
998/udp
Diffusion UDP (D&eacute;tection
p&eacute;riph&eacute;rique)
-
Optionnel
Optionnel
999/udp
Diffusion UDP
-
Optionnel
Optionnel
Port
Utilisation
991/udp
(D&eacute;tection p&eacute;riph&eacute;rique)
5900/tcp
Serveur VNC
VNC seulement
-
-
5100/tcp
D&eacute;bogueur &agrave; distance JS
-
-
Optionnel
11740-11743/tcp
CODESYS 3
-
-
-
1217, 17401743/udp
Acc&egrave;s &agrave; distance
L'acc&egrave;s &agrave; distance est demand&eacute; pour se connecter &agrave; HMI Runtimeen utilisant :
l
AGI Client
l
Acc&egrave;s web AGI Web
Runtime et ports de gestion de projet
Vous utilisez ces ports pour vous connecter &agrave; HMI Runtimepour des op&eacute;rations comme les mises &agrave; jour, les installations et
les t&eacute;l&eacute;chargements de projets.
Ports de gestion de carte
Vous utilisez ces ports pour vous connecter au p&eacute;riph&eacute;rique IHM pour les op&eacute;rations de carte, tels que les mises &agrave; jour
BSP, les t&eacute;l&eacute;chargements d'image de d&eacute;marrage, etc.
Note : Lorsque le service de diffusion n'est pas disponible, par exemple dans les r&eacute;seaux VPN, saisissez
l'adresse IP exacte pour vous connecter au p&eacute;riph&eacute;rique IHM &agrave; partir de AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
419
Ports et pare-feux
420
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
47 Trucs et astuces pour am&eacute;liorer la
performance
AGI Creator permet une grande flexibilit&eacute; pour un concepteurs de projets.
Suivez ces instructions pour cr&eacute;er des projets qui fonctionnent mieux en termes de temps de d&eacute;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&eacute;-cachage
426
FAQ sur le pr&eacute;-cachage
427
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
421
Optimisation statique
Optimisation statique
L’optimisation statique est une technique utilis&eacute;e dans AGI Creator pour am&eacute;liorer les performances d'ex&eacute;cution.
L'utilisation d'un grand nombre d'images et de photos dans un projet pourrait d&eacute;grader les performances, l'optimisation
statique fusionne plusieurs images dans une image de fond unique, r&eacute;duisant ainsi le rendu et le temps de chargement. En
utilisant cette m&eacute;thode, une seule image &agrave; trame doit &ecirc;tre charg&eacute;e et rendue au lieu de plusieurs images &agrave; trame et/ou
d’images de vecteur.
Lorsque vous cr&eacute;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 &ecirc;tre class&eacute;s comme suit :
l
Statique : valeurs ou propri&eacute;t&eacute;s ne changent pas au moment de l'ex&eacute;cution.
l
Dynamique : valeurs ou propri&eacute;t&eacute;s changent au moment de l'ex&eacute;cution.
Note : Sur la base des param&egrave;tres de s&eacute;curit&eacute;, les parties statiques des widgets pourraient &ecirc;tre pas fusionn&eacute;s
avec le fond d’&eacute;cran. Cela se produit lorsque un widget est configur&eacute; comme &laquo; cach&eacute; &raquo; dans les param&egrave;tres de
s&eacute;curit&eacute;.
Important : Lorsque vous modifiez les propri&eacute;t&eacute;s des widgets avec JavaScript, r&eacute;gler le widget
d'optimisation statique sur dynamique, sinon les modifications de propri&eacute;t&eacute;s seront ignor&eacute;es.
Lors du t&eacute;l&eacute;chargement ou de la validation un projet, AGI Creator identifie les composants statiques et les rend sous forme
d'images d'arri&egrave;re-plan en des fichiers .png. Ces images de fond sont enregistr&eacute;es en tant que partie du projet dans le
dossier /opt.
Les images de fond peuvent &ecirc;tre cr&eacute;&eacute;s comme suit :
l
l
images de fond de pleine page, contenant tous les widgets fusionn&eacute;s &agrave; la page de fond
images de fond de groupe, contenant un groupe de widgets statiques fusionn&eacute;s ensemble pour former un fond de
groupe. Par exemple, le groupe de jauge est normalement compos&eacute; d'un fond, d’une &eacute;chelle, d’une &eacute;tiquette et d’une
aiguille, o&ugrave; l'&eacute;chelle et l'&eacute;tiquette de fond peuvent tous &ecirc;tre fusionn&eacute;s &agrave; une image d'arri&egrave;re-plan unique.
L'attribut de la page d’Optimisation statique active et d&eacute;sactive l'optimisation statique de la page enti&egrave;re. Si elle est
d&eacute;finie sur faux l'optimisation est totalement d&eacute;sactiv&eacute;e.
Le contr&ocirc;le Finer peut &ecirc;tre obtenu d&eacute;finissant l'attribut d'Optimisation statique de chaque widget individuel comme suit :
l
l
Normal : AGI Creator d&eacute;tecte automatiquement si le widget peut &ecirc;tre fusionn&eacute; avec l'arri&egrave;re-plan. Ceci peut &ecirc;tre
utilis&eacute; si le widget n’est pas un widget dynamique et qu’il ne se chevauche pas, c'est-&agrave;-dire qu’il n’est pas empil&eacute; cidessus, un widget dynamique.
Statique : L'image est forc&eacute;e d'&ecirc;tre fusionn&eacute;e avec l'arri&egrave;re-plan. Ceci peut &ecirc;tre utilis&eacute; lorsque le widget statique
chevauche un widget transparent dynamique.
Note : Dans ce cas, l'optimisation automatique &eacute;chouera car elle ne fait aucune hypoth&egrave;se sur les zones
invisibles qui pourraient &ecirc;tre rendus au moment de l'ex&eacute;cution.
l
Dynamique : Le widget n’est pas du tout optimis&eacute;. Utilisez cette option quand un widget statique doit &ecirc;tre chang&eacute;
par Javascript.
422
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
47 Trucs et astuces pour am&eacute;liorer la performance
Conseils pour une meilleure performance
1. Tout d'abord : &eacute;viter de placer des widgets statiques sur un widget dynamique. La zone de chevauchement est
calcul&eacute;e en tenant compte des rectangles englobant des widgets, c’est-&agrave;-dire des rectangles d&eacute;limit&eacute;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'&eacute;conomiser beaucoup d'images en taille totale presque identiques pour chaque
page en utilisant beaucoup d'espace m&eacute;moire qui pourrait &ecirc;tre plus efficacement utilis&eacute; pour am&eacute;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&eacute;senter un gaspillage de ressources, m&ecirc;me lorsque
optimis&eacute;.
4. Optimiser la taille de l’image. L'image sera rendue &agrave; la taille du widget d'image contenant l'image. Pour les
meilleures performances, le widget doit avoir la m&ecirc;me taille d'image.
5. &Eacute;vitez d' utiliser l'&eacute;chelle pour adapter pour les widgets d'image, car cela force un redimensionnement au moment
de l'ex&eacute;cution pour les images dynamiques et &laquo; cache &raquo; la taille r&eacute;elle de l'image lors de l'&eacute;dition.
6. Utilisez une taille pour adapter pour rendre le widget &agrave; la taille r&eacute;elle de son contenu.
7. Si le chevauchement ne peut &ecirc;tre &eacute;vit&eacute;, assurez-vous de placer les widgets statiques &agrave; l’arri&egrave;re, qui est derri&egrave;re le
widget dynamique.
8. Choisissez le format de fichier d'image bas&eacute; sur le p&eacute;riph&eacute;rique IHM auquel vous &ecirc;tes connect&eacute;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
423
Optimisation statique
9. &Eacute;vitez d'utiliser trop de widgets sur une seule page. Souvent, les widgets sont plac&eacute;s en dehors de la zone visible
ou leur transparence est contr&ocirc;l&eacute;e par une variable. Puisque les widgets sont charg&eacute;s, m&ecirc;me s’ils ne sont pas
visibles, avoir trop de widgets sur une page peut ralentir consid&eacute;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 &eacute;l&eacute;ments graphiques dans une page, pr&eacute;f&eacute;rez les pages de dialogue avec positionnement
contr&ocirc;l&eacute; aux widgets transparents.
12. V&eacute;rifiez le dossier opt pour voir si l'optimisation statique fonctionne comme pr&eacute;vu, les widgets par ordre z peuvent
avoir besoin d’&ecirc;tre ajust&eacute;s.
13. Les champs num&eacute;riques sont souvent utilis&eacute;s pour ex&eacute;cuter du code JavaScript sur l’&eacute;v&eacute;nement OnDataUpdate
m&ecirc;me si le widget n'a pas besoin d'&ecirc;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&eacute;t&eacute; de visibilit&eacute;. Dans ce
dernier cas, vous pourriez vous retrouver avec de nombreux coins laiss&eacute;s vides.
14. Utilisez un bouton Zone r&eacute;active si vous avez besoin d'une zone tactile pour r&eacute;agir aux entr&eacute;es de l'utilisateur.
15. Si vous r&eacute;utilisez un widget depuis la galerie ou que vous cr&eacute;ez votre propre widget, rappelez-vous de d&eacute;finir les
propri&eacute;t&eacute;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&eacute; 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&egrave;le commun :
1. d&eacute;finir l’optimisation statique de mod&egrave;le sur vrai,
2. d&eacute;finir l'optimisation statique de la page sur faux, puisque l'arri&egrave;re-plan est d&eacute;j&agrave; pr&eacute;vu par le mod&egrave;le.
Dans ce sc&eacute;nario, l'arri&egrave;re-plan peut &ecirc;tre r&eacute;utilis&eacute; par de nombreuses pages diff&eacute;rentes &eacute;conomisant ainsi de
l'espace m&eacute;moire.
17. Ne pas utiliser des widgets dynamiques, tels que les boutons, uniquement &agrave; des fins graphiques, lorsque la fonction
du bouton n’est pas n&eacute;cessaire, utiliser plut&ocirc;t les widgets image pour obtenir le m&ecirc;me effet graphique.
Voici un exemple d'une bonne et d'une mauvaise utilisation d'optimisation statique.
Formats d’image support&eacute;
AGI Creator supporte de nombreux formats &agrave; trame tels que BMP, PNG, JPEG, TIFF et le format de vecteur SVG. Voici
une liste des avantages et des inconv&eacute;nients :
424
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
47 Trucs et astuces pour am&eacute;liorer la performance
Format
d’image
Avantages
&Agrave; TRAME
VECTEUR
(SVG)
Inconv&eacute;nients
l
Rendu rapide
l
Grande taille de fichier
l
Bien normalis&eacute;
l
R&eacute;solution fixe
l
l
l
Petite taille de
fichier
Redimensionner
sans perte de
qualit&eacute;
l
l
l
Les images SVG complexes avec des nombreux &eacute;l&eacute;ments
graphiques et des couches peuvent &ecirc;tre plus lents &agrave; rendre.
Cr&eacute;er un SVG optimis&eacute; n’est pas simple.
Seul Tiny 1.2 (http://www.w3.org/TR/SVGTiny12/) est
support&eacute;.
Peut g&eacute;rer les
propri&eacute;t&eacute;s
dynamiques
Note : Le logiciel Scour est un outil gratuit qui peut &ecirc;tre utilis&eacute; pour retirer le code &eacute;tranger du fichier
(http://www.codedread.com/scour/).
Optimisation statique des mod&egrave;les
Les pages de mod&egrave;les peuvent avoir de grandes quantit&eacute;s de contenu statique. Cependant, l'optimisation statique ne peut
pas &ecirc;tre appliqu&eacute;e &agrave; un mod&egrave;le de page, puisque l&agrave; o&ugrave; le mod&egrave;le est utilis&eacute; est bas&eacute; sur la conception de la page.
Si une image d'arri&egrave;re-plan &eacute;norme doit &ecirc;tre r&eacute;p&eacute;t&eacute;e &agrave; chaque page qui utilise le m&ecirc;me mod&egrave;le, cela augmenterait
l'empreinte du p&eacute;riph&eacute;rique de sorte que la m&ecirc;me image statique serait cr&eacute;&eacute; pour chacune des pages en utilisant la page de
mod&egrave;le.
FAQ sur l’optimisation statique
Q : Dans une page o&ugrave; 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&ecirc;mes puisque chaque widget pourrait avoir diff&eacute;rents
param&egrave;tres/propri&eacute;t&eacute;s modifiant le rendu r&eacute;el au moment de l'ex&eacute;cution.
Q : Pourquoi les images statiques stock&eacute;es dans un dossier s&eacute;par&eacute; appel&eacute; opt au lieu de les stocker
directement dans le dossier du projet ?
R : Cela permet d'&eacute;viter les collisions de noms et permet de sauter le chargement des images d'optimisation
Q : Pourquoi les images statiques sont stock&eacute;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&eacute;sultat diff&eacute;rent dans AGI Creator(Ne pas utiliser l'optimisation) et
HMI Runtime.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cution. En particulier, les images SVG peut n&eacute;cessiter
beaucoup de temps &agrave; rendre dans une plate-forme embarqu&eacute;e.
Mise en cache de page
Une fois acc&eacute;d&eacute;es, les pages sont conserv&eacute;es dans un cache RAM jusqu'&agrave; atteindre la taille maximale du cache, qui
d&eacute;pend de la RAM effectivement disponible de la plateforme. Cela permet un acc&egrave;s beaucoup plus rapide, car lorsque l'on
charge &agrave; nouveau les pages mises en cache, seul leur contenu doit &ecirc;tre retrac&eacute;, sans qu'il soit n&eacute;cessaire de charger &agrave;
nouveau l'ensemble des ressources de la page.
Image DB
L'image DB est une technique utilis&eacute;e pour tracer l'utilisation de fichiers d'image et pour r&eacute;duire le co&ucirc;t de chargement des
images moyennant la mise en cache des images les plus fr&eacute;quemment utilis&eacute;es (par exemple, les images BoutonPoussoir, Aiguilles de calibre, Barres de d&eacute;filement etc.). La m&ecirc;me image, utilis&eacute;e &agrave; plusieurs emplacements diff&eacute;rents,
n'est donc charg&eacute;e qu'une seule fois.
L'image DB pr&eacute;chargera les images les plus utilis&eacute;es au d&eacute;marrage jusqu'&agrave; ce que la limite de m&eacute;moire soit atteinte. Cela
permet d'&eacute;courter les d&eacute;lais de chargement de la page individuelle.
Le fichier imagecachelist.xml est cr&eacute;&eacute; 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&eacute;e dans le projet
l
Nombre de tailles diff&eacute;rentes pour la m&ecirc;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&egrave;mes de m&ecirc;me couleur parmi les widgets d'un m&ecirc;me type.
Pr&eacute;-cachage
L'attribut pr&eacute;-cache des pages peut &ecirc;tre utilis&eacute; pour notifier &agrave; HMI Runtimede pr&eacute;charger certaines pages dans la RAM au
moment de l'initialisation pour un acc&egrave;s plus rapide. Le pr&eacute;-cachage est utile pour les pages complexes ayant de nombreux
widgets dynamiques.
Lorsque cette fonction est activ&eacute;e dans une page, l'acc&egrave;s &agrave; cette page est plus rapide, mais elle ralentit &eacute;galement
l'initialisation, le syst&egrave;me n'&eacute;tant pr&ecirc;t qu'une fois que toutes les pages &agrave; pr&eacute;-cacher ont &eacute;t&eacute; sauvegard&eacute;es dans la RAM.
426
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
47 Trucs et astuces pour am&eacute;liorer la performance
Astuces pour le pr&eacute;-cachage
1. Activez la fonction pr&eacute;-cache uniquement pour quelques pages ayant plusieurs widgets dynamiques ou pour des
pages utilis&eacute;es fr&eacute;quemment par les utilisateurs.
2. N'activez pas la fonction pr&eacute;cache pour toutes les pages du projet, vous risquez d'&eacute;puiser la m&eacute;moire et de n'obtenir
aucun avantage.
3. D&eacute;sactivez l'optimisation statique pour les pages o&ugrave; la fonction pr&eacute;cache est activ&eacute;e afin de limiter l'utilisation de la
m&eacute;moire.
FAQ sur le pr&eacute;-cachage
Limite de page au pr&eacute;-cachage
En fonction de la taille et de la complexit&eacute; d'une page, l'espace requis pour le pr&eacute;-cachage peut aller de 1,5Mb &agrave; 3Mb.
Lorsqu'un projet est charg&eacute;, HMI Runtime proc&egrave;de de la fa&ccedil;on suivante :
1. Les images de page sont pr&eacute;charg&eacute;es jusqu'&agrave; ce que l'espace m&eacute;moire encore disponible atteigne 76 MB
(imageDBLowMem)
2. Les pages o&ugrave; la m&eacute;moire pr&eacute;-cache est configur&eacute;e sur vrai sont pr&eacute;charg&eacute;es jusqu'&agrave; ce que l'espace m&eacute;moire
encore disponible atteigne 64 MB (pageCacheLowMemMax). Les images de ces pages sont charg&eacute;es dans la RAM
(dans l'Image DB).
Lorsque le projet est pr&ecirc;t :
1. Toute page nouvelle visit&eacute;e est sauvegard&eacute;e dans le cache (RAM) avec toutes les images associ&eacute;es jusqu'&agrave; ce que
l'espace m&eacute;moire encore disponible atteigne 40 MB (pageCacheLowMemMin)
2. Lorsqu'un changement de page survient et que l'espace dans la RAM est critique (&lt;40MB), le HMI Runtime
commence &agrave; vider le cache (RAM) en supprimant des pages et les images associ&eacute;es jusqu'&agrave; ce que 64 MB
d'espace m&eacute;moire soient rendus disponibles. HMI Runtime supprime les donn&eacute;es stock&eacute;es dans le cache dans
l'ordre suivant :
1. les derni&egrave;res pages visit&eacute;es, les images les plus grandes et celles inutilis&eacute;es (&gt;320x240),
2. s'il faut lib&eacute;rer plus de m&eacute;moire, les pages en pr&eacute;-cache ainsi que toutes les images charg&eacute;es dans Image
DB peuvent &eacute;galement &ecirc;tre supprim&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
427
FAQ sur le pr&eacute;-cachage
428
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
48 Pr&eacute;cisions fonctionnelles et
compatibilit&eacute;
Voici un aper&ccedil;u des fonctions prises en charge et des limites connexes. Les limites indiqu&eacute;es ici sont des limites
prudentes, au-del&agrave; desquelles le fonctionnement correct et la performance du syst&egrave;me ne sont plus garantis.
Tableau de fonctions et limites
430
Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.
431
Compatibilit&eacute;
432
Projets de conversion entre les diff&eacute;rents p&eacute;riph&eacute;riques IHM
432
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &ecirc;tre ouvertes en
m&ecirc;me temps
5
Nombre de recettes
32
Nombre d'ensembles de param&egrave;tres pour une recette
1,000
Nombre d'&eacute;l&eacute;ments par recette
1,000
Nombre de groupes d'utilisateurs
50
Nombre d'utilisateurs
50
Nombre de clients distants simultan&eacute;s
4
Nombre de planificateurs
30
Nombre d'alarmes
2.000 (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on the
facing page)
Nombre de transferts de donn&eacute;es
1000
Nombre de pages de mod&egrave;les
50
Nombre d'actions programmables par &eacute;tat de bouton
32
Nombre de m&eacute;moires des tendances
30
Nombre de courbes par widget de tendance
5
Nombre de courbes par widget de diagramme de dispersion
10
Nombre d'&eacute;chantillons par m&eacute;moire des tendances
200,000
Nombre de variables par m&eacute;moire des tendances
200
Nombre d'&eacute;chantillons de m&eacute;moire des tendances pour un
projet
1.200.000 (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on the
facing page)
Nombre de messages dans un champ de message
1024
Nombre de langues
12
Nombre d'&eacute;v&eacute;nements par m&eacute;moire tampon
2,048
430
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
48 Pr&eacute;cisions fonctionnelles et compatibilit&eacute;
Fonction
Limite maximum
Nombre d'&eacute;v&eacute;nements par m&eacute;moire des tendances
4
Taille de fichier JavaScript par page
16 KB
Taille de projet sur disque
60 Mo (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; below)
Nombre d'instances index&eacute;es
100
Nombre d'alias index&eacute;s
100
Nombre d'ensembles de variables index&eacute;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&eacute;mentaires
5
Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.
Voir &quot;Tableau de fonctions et limites&quot; on the previous page pour les fonctions standards.
P&eacute;riph&eacute;rique IHM (Windows CE)
Limites
AGI315, AGI315G
Capacit&eacute;s standards
AGI304, AGI307, AGI307G
Max_Alarm = 500
Max_ProjectSize = 30 Mo
P&eacute;riph&eacute;riques IHM (Linux)
Limites
AGI407, AGI410, AGI415, AGI421
Max_ProjectSize = 240 Mo
Max_Alarm = 4,000
Nombre d'&eacute;chantillons de m&eacute;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&eacute;riph&eacute;riques Linux :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
431
Compatibilit&eacute;
l
LaunchBrowser macro
l
Widget de lecteurs m&eacute;dias
l
Les p&eacute;riph&eacute;riques d'impression ne sont pas pris en charge. Les rapports peuvent &ecirc;tre imprim&eacute;s uniquement sur les
fichiers PDF. L’impression des rapports de texte et des &eacute;v&eacute;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&eacute;rer cible
l
Outil de r&eacute;glage du syst&egrave;me
l
Sauvegarde/Restauration
l
Protocoles de s&eacute;rie qui requi&egrave;rent un mat&eacute;riel sp&eacute;cial.
Compatibilit&eacute;
La politique de compatibilit&eacute; suivante a &eacute;t&eacute; adopt&eacute;e :
l
l
l
l
l
l
La version AGI Creator doit toujours &ecirc;tre align&eacute;e avec HMI Runtime sur le p&eacute;riph&eacute;rique,
l'utilisateur est responsable de la mise &agrave; jour des composants de HMI Runtime sur le p&eacute;riph&eacute;rique IHM &agrave; chaque
mise &agrave; jour de AGI Creator,
la mise &agrave; jour de HMI Runtime peut &ecirc;tre r&eacute;alis&eacute;e directement &agrave; partir de AGI Creator avec la commande Mise &agrave; jour
de la cible, qui est disponible dans la bo&icirc;te de dialogue Ex&eacute;cuter\G&eacute;rer cible,
les projets cr&eacute;&eacute;s dans une version de AGI Creator post&eacute;rieure &agrave; la version V1.00 (00) peuvent &ecirc;tre ouverts et g&eacute;r&eacute;s
par les nouvelles versions,
les projets qui sont cr&eacute;&eacute;s avec des versions ant&eacute;rieures de AGI Creator, ouverts avec des versions post&eacute;rieures et
d&eacute;ploy&eacute;s sur HMI Runtime compatible, maintiennent leurs performances et leurs fonctionnalit&eacute;s,
la compatibilit&eacute; n'est pas assur&eacute;e entre les versions les plus r&eacute;centes de HMI Runtime et les projets cr&eacute;&eacute;s et
d&eacute;ploy&eacute;s avec des versions moins r&eacute;centes de AGI Creator.
Important : N'&eacute;ditez pas de projets avec une version de AGI Creator moins r&eacute;cente que celle utilis&eacute;e
pour les cr&eacute;er. Cela pourrait endommager le projet et rendre HMI Runtime instable.
Projets de conversion entre les diff&eacute;rents
p&eacute;riph&eacute;riques IHM
La conversion de projet &agrave; partir de diff&eacute;rents mod&egrave;les de p&eacute;riph&eacute;riques IHM est prise en charge, cependant, certaines
op&eacute;rations manuelles peuvent &ecirc;tre n&eacute;cessaires si le projet utilise des fonctions non support&eacute;es dans le p&eacute;riph&eacute;rique de
destination.
Lignes directrices
Avant de convertir un projet, contr&ocirc;ler s’il existe des fonctions non support&eacute;es (voir &quot;Capacit&eacute;s des p&eacute;riph&eacute;riques IHM.&quot; on
the previous page), et ajuster votre projet en supprimant les fonctionnalit&eacute;s non prises en charge avant de convertir le
projet.
En particulier :
432
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
48 Pr&eacute;cisions fonctionnelles et compatibilit&eacute;
l
l
V&eacute;rifiez les limitations et les fonctionnalit&eacute;s non prises en charge par le nouveau p&eacute;riph&eacute;rique IHM (voir &quot;Tableau de
fonctions et limites&quot; on page 430 pour plus de d&eacute;tails).
Supprimez les widgets, les actions, les variables syst&egrave;me, les protocoles et les propri&eacute;t&eacute;s de projet qui ne sont pas
pris en charge.
l
Si le projet utilise un stockage externe, v&eacute;rifier si le m&ecirc;me chemin de stockage est toujours disponible.
l
Ajustez les applications ou les chemins externes sp&eacute;cifiques &agrave; un syst&egrave;me d'exploration.
l
l
l
Si besoin, r&eacute;duire la taille du projet selon les nouvelles limitations de type de p&eacute;riph&eacute;rique IHM (voir &laquo; Limitations &raquo;
pour plus de d&eacute;tails).
Puisque les p&eacute;riph&eacute;riques IHM sont bas&eacute;s sur diff&eacute;rentes plateformes mat&eacute;rielles avec diff&eacute;rente vitesse de
processeur, taille de la m&eacute;moire RAM, taille du cache, assurez-vous de v&eacute;rifier le temps de d&eacute;marrage du projet et le
temps de chargement de la page pour chaque page dans le projet.
V&eacute;rifiez le code JavaScript pour les op&eacute;rations sp&eacute;cifiques au syst&egrave;me d'exploitation.
Fonctionnalit&eacute;s sp&eacute;cifiques au syst&egrave;me d'exploitation
Linux est sensible &agrave; la casse alors que Windows CE ne l’est pas. Par cons&eacute;quent, les projets sur les p&eacute;riph&eacute;riques IHM
Linux peuvent avoir diff&eacute;rents fichiers nomm&eacute;s en fonction des majuscules et minuscules, par exemple &laquo; dump1.csv &raquo; et
&laquo; Dump1.csv &raquo;, ce qui n’est pas possible sur les p&eacute;riph&eacute;riques IHM Windows CE.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
433
Projets de conversion entre les diff&eacute;rents p&eacute;riph&eacute;riques IHM
434
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49
Protocoles de communication
Cette section d&eacute;crit les protocoles disponibles.
Note : Il est possible que le mat&eacute;riel ou les protocoles du contr&ocirc;leur aient &eacute;t&eacute; modifi&eacute;s depuis la cr&eacute;ation de cette
documentation. Veuillez toujours tester et v&eacute;rifier le bon fonctionnement de l'application. Pour int&eacute;grer les
&eacute;volutions du mat&eacute;riel et des protocoles du contr&ocirc;leur, les pilotes font l'objet d'une mise &agrave; jour continue. Pour
cette raison, veuillez vous assurer que l'application utilise le pilote le plus r&eacute;cent.
Il est possible d'utiliser des m&eacute;dias physiques, passerelles, routeurs et concentrateurs dans le r&eacute;seau de communication.
De plus, les autres p&eacute;riph&eacute;riques peuvent utiliser le r&eacute;seau de mani&egrave;re autonome et simultan&eacute;e. Toutefois, il est important
de garantir que le trafic g&eacute;n&eacute;r&eacute; par ces p&eacute;riph&eacute;riques n'am&egrave;ne pas de d&eacute;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 | &copy; 2012-2017 DEIF A/S
435
Simatic S7 MPI
744
Variables
770
436
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
A-B ENET
Le protocole de communication A-B ENET est normalement utilis&eacute; sur les contr&ocirc;leurs Allen-Bradley via communication
Ethernet.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave; chaque
nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse
IP
Adresse IP Ethernet du contr&ocirc;leur.
Port
Num&eacute;ro du port utilis&eacute; par l’interface Ethernet.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
437
A-B ENET
&Eacute;l&eacute;ment
Description
D&eacute;lai
d'attente
D&eacute;lai d’attente (en millisecondes) entre deux tentatives en cas d’absence de r&eacute;ponse du
contr&ocirc;leur.
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur (esclave).
Configuration du contr&ocirc;leur
Vous devez configurer correctement l’API afin de correspondre &agrave; l’adresse IP configur&eacute;e dans l'&eacute;diteur du protocole. En
temps normal, vous pouvez laisser la configuration de l’API par d&eacute;faut.
438
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Configurer le module 1761-NET-ENI
Voici la proc&eacute;dure pour configurer le module 1761-NET-ENI avec l'utilitaire ENI/ENIW d’Allen Bradley. Cette proc&eacute;dure
n&eacute;cessite un c&acirc;ble de communication 1761-CBL-PM02.
1. Branchez le connecteur DIN 8 broches au port 2 du p&eacute;riph&eacute;rique NET-ENI et le connecteur femelle D-shell 9
broches au port COM de l’ordinateur.
2. Branchez le contr&ocirc;leur SLC 5/0x et connectez-vous en ligne.
3. Dans l'onglet Param&egrave;tres de l’utilitaire, configurez Port COM et D&eacute;bit en bauds.
4. Dans l’onglet Addr IP ENI, s&eacute;lectionnez la S&eacute;rie ENI correspondante dans la liste, et si n&eacute;cessaire, configurez
Adresse IP ENI, Masque de sous-r&eacute;seau et D&eacute;bit en bauds.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
439
A-B ENET
5. Enregistrez la configuration du p&eacute;riph&eacute;rique NET-ENI.
Vous disposez de deux espaces de m&eacute;moire s&eacute;par&eacute;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&eacute;es E/S d’Allen Bradley, le panneau utilise l’adressage logique plut&ocirc;t que l’adressage physique. Tandis que
l’adressage physique correspond au num&eacute;ro d’&eacute;l&eacute;ment faisant office de num&eacute;ro de cr&eacute;neau, l’adressage logique
correspond au premier &eacute;l&eacute;ment pour la premi&egrave;re carte E/S d’un type de fichier donn&eacute;.
L’adressage AGI Creator d&eacute;pend du mappage de la m&eacute;moire processeur de l’API et non du num&eacute;ro de cr&eacute;neau. Soyez
donc vigilant lorsque vous modifiez la configuration afin d'&eacute;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 | &copy; 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 &agrave; 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&eacute;es pour visualiser l’attribution de la m&eacute;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&eacute;sente la configuration de la variable AGI Creator.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
441
A-B ENET
La variable AGI Creator configur&eacute;e dans l’exemple ci-dessus pointe vers l’&eacute;l&eacute;ment pr&eacute;sent&eacute; dans la figure suivante.
Exemples
E:0/19 (E1:0.1/3 en termes de mot) – 20&egrave; entr&eacute;e sur le processeur
442
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Param&egrave;tre
Configuration
Type de fichier
Entr&eacute;e Disc
Num de fichier
1
Type de donn&eacute;es
Boolean
Dans le navigateur de fichier de donn&eacute;es, mot 0.1 correspond &agrave; Mot 1 :
&Eacute;l&eacute;ment
1
Sous-index
3
E:1/15 (E1:1.0/15 en termes de mot) - Derni&egrave;re entr&eacute;e sur le cr&eacute;neau 1 de la carte d’entr&eacute;e
Param&egrave;tre
Configuration
Type de fichier
Entr&eacute;e Disc
Num de fichier
1
Type de donn&eacute;es
Boolean
Dans le navigateur de fichier de donn&eacute;es, mot 1.0 correspond &agrave; Mot 8 :
&Eacute;l&eacute;ment
8
Sous-index
15
E:4.0 (E1:4.0 en termes de mot) - Premi&egrave;re entr&eacute;e analogique
Param&egrave;tre
Configuration
Type de fichier
Entr&eacute;e Disc
Num de fichier
1
Type de donn&eacute;es
Short
Dans le navigateur de fichier de donn&eacute;es, mot 4.0 correspond &agrave; Mot 10 :
&Eacute;l&eacute;ment
10
Sous-index
-
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
443
A-B ENET
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;crasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; 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 &laquo; .csv &raquo; g&eacute;n&eacute;r&eacute;s par le
RSLogix 500 de Rockwell.
Pour g&eacute;n&eacute;rer le fichier, s&eacute;lectionnez Outil &gt; Base de donn&eacute;es &gt; Exporter ASCII
444
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Dans l’onglet CSV, s&eacute;lectionnez les donn&eacute;es &agrave; exporter et donnez un nom au fichier csv de sortie.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
445
A-B ENET
Importer des variables dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
Pilote d'importation
Description
RSLogix500 v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .csv.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Toutes les variables s’affichent au m&ecirc;me niveau.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
446
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
447
A-B ENET
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contr&ocirc;leur r&eacute;pond &laquo; Ne pas confirmer &raquo;.
-
D&eacute;lai
d'attente
La requ&ecirc;te n’a obtenu aucune r&eacute;ponse dans
le d&eacute;lai d’attente sp&eacute;cifi&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute; et correctement
configur&eacute; pour acc&eacute;der au r&eacute;seau.
R&eacute;ponse
non valide
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse ou un
contenu non valide au p&eacute;riph&eacute;rique.
V&eacute;rifiez la coh&eacute;rence entre les donn&eacute;es programm&eacute;es
dans le projet et les ressources du contr&ocirc;leur.
Erreur
g&eacute;n&eacute;rale
Erreur non identifiable. Ne doit jamais &ecirc;tre
signal&eacute;e.
Contactez l’assistance technique.
448
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;Programming concepts&quot; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
l
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;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 &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
453
A-B DF1
Element Description
Valeur
Description
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 &gt; Database &gt; ASCII Export
454
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 2012-2017 DEIF A/S
455
A-B DF1
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
456
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
457
A-B DF1
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;Programming concepts&quot; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
466
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
467
A-B DH-485
Element Description
Valeur
Description
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 &gt; Database &gt; ASCII Export
468
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 2012-2017 DEIF A/S
469
A-B DH-485
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
470
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
471
A-B DH-485
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
483
Beckhoff ADS
To export tags defined for the selected controller, click on Project &gt; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
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&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
485
Beckhoff ADS
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
486
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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&ocirc;leurs bas&eacute;s sur la version CODESYS V2.3.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse IP
Adresse IP Ethernet du contr&ocirc;leur.
Port
Num&eacute;ro du port utilis&eacute; par le pilote CODESYS V2 Ethernet. Par d&eacute;faut, la valeur est
configur&eacute;e &agrave; 1200, ce qui correspond au param&egrave;tre par d&eacute;faut des contr&ocirc;leurs bas&eacute;s sur
CODESYS.
498
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
Taille de
bloc
Taille de bloc maximale prise en charge par votre contr&ocirc;leur (limit&eacute;e &agrave; 1 024 KB).
D&eacute;lai
d'attente
(ms)
D&eacute;lai d’attente entre deux tentatives d’envoi du m&ecirc;me message en cas d'&eacute;chec de
communication.
Type de
protocole
Variante du protocole &agrave; utiliser. Veuillez v&eacute;rifier quelle variante du protocole est prise en
charge par l'ex&eacute;cution CODESYS que vous souhaitez connecter.
Adresse
source,
adresse de
destination
Disponible uniquement si l'option Route TCP/IP de niveau 2 a &eacute;t&eacute; s&eacute;lectionn&eacute; pour le
param&egrave;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&eacute;seau. L'adresse est utilis&eacute;e pour la lecture de variables lorsque
plusieurs API sont connect&eacute;s &agrave; un sous-r&eacute;seau (r&eacute;seau en s&eacute;rie) mais qu'un seul est dot&eacute;
d'interface Ethernet.
Mod&egrave;les
d'API
Deux mod&egrave;les d'API sont disponibles.
R&eacute;seau
d’API
l
Intel
l
Motorola
Adresse IP de tous les contr&ocirc;leurs en connexions multiples. Vous devez s&eacute;lectionner la case
&agrave; cocherR&eacute;seau d’API pour permettre les connexions multiples.
&Agrave; partir de la version V1.60, le pilote CODESYS V2 Ethernet prend en charge la connexion avec plusieurs contr&ocirc;leurs.
Note : Le pilote CODESYS V2 Ethernet est recommand&eacute; en cr&eacute;ant des projets pour le contr&ocirc;leur interne iPLC
CODESYS. Pour utiliser le pilote CODESYS V2 Ethernet avec iPLC, configurez l'adresse IP de l'API comme
h&ocirc;te local (127.0.0.1).
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &agrave;
base de symboles &agrave; partir de la version V1.55.
Ajouter un nom d’alias &agrave; un protocole
Les noms de variables doivent &ecirc;tre uniques au niveau d’un projet. Vous pouvez cependant &ecirc;tre amen&eacute; &agrave; utiliser les m&ecirc;mes
noms de variables pour diff&eacute;rents nœuds de contr&ocirc;leur (par exemple lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; deux
p&eacute;riph&eacute;riques ex&eacute;cutant la m&ecirc;me application).
Lorsque vous g&eacute;n&eacute;rez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables import&eacute;s pour
ce protocole.
Dans l’exemple, la connexion &agrave; un certain contr&ocirc;leur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le pr&eacute;fixe Nœud1, les rendant ainsi uniques au niveau projet/r&eacute;seau.
Note : Vous pouvez donner un nom d’alias uniquement aux variables import&eacute;es. Il n’est pas n&eacute;cessaire pour les
variables ajout&eacute;es manuellement dans l'&eacute;diteur de variables de porter un pr&eacute;fixe d’alias dans leur nom.
Vous associez la cha&icirc;ne d’alias &agrave; l’importation. Une fois l’importation des variables effectu&eacute;e, une modification
de la cha&icirc;ne d’alias n’aura aucun effet sur les noms figurant d&eacute;j&agrave; dans le dictionnaire. Lorsque vous modifiez la
cha&icirc;ne d’alias et r&eacute;importez les variables, toutes les variables r&eacute;import&eacute;es porteront la nouvelle cha&icirc;ne de
pr&eacute;fixe.
Param&egrave;tres logiciels CODESYS
Lors de la cr&eacute;ation du projet sous CODESYS, s&eacute;lectionnez T&eacute;l&eacute;charger le fichier de symboles.
500
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Le p&eacute;riph&eacute;rique CODESYS V2 Ethernet prend en charge le chargement automatique du fichier de
symboles (SDB) depuis l'API. Aucune modification dans le d&eacute;calage de variable due &agrave; une nouvelle compilation
du c&ocirc;t&eacute; du logiciel de l’API ne n&eacute;cessite la r&eacute;importation du fichier de symboles. Le fichier de variables doit &ecirc;tre
r&eacute;import&eacute; uniquement si vous renommez ou d&eacute;finissez de nouvelles variables.
Lorsque l’option T&eacute;l&eacute;charger fichier symbole n’est pas disponible ou effac&eacute;, le protocole ne peut fonctionner que si la
variable ProjectID est import&eacute;e. Lorsque l'offset de variable change en raison d'une nouvelle compilation de logiciel de
l'API, il est n&eacute;cessaire de r&eacute;importer le fichier de symboles.
Types de donn&eacute;es
Le module d’importation prend en charge des variables des types de donn&eacute;es standard et d&eacute;finies par l’utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
501
CODESYS V2 ETH
Types de
donn&eacute;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 &amp; HEURE
et TABLEAU &agrave; 1 dimension des types de donn&eacute;es ci-dessus. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Note * : La longueur maximale de la cha&icirc;ne d'une variable STRING dans l’API est de 80
caract&egrave;res. D&eacute;clarez une variable STRING soit avec une taille sp&eacute;cifique (ch: STRING(35)
soit avec la taille par d&eacute;faut (ch: STRING), qui est de 80 caract&egrave;res.
Types de
donn&eacute;es non
pris en charge
l
LWORD
l
LINT
l
LREAL
Conversion de variables
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions, list&eacute;es ci-dessous.
502
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt; GHEFCDAB
&Eacute;change les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
ABC...NOP -&gt; OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110 0001110010111011011001000101101000011100101011000001
→
1 10000011100 1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
503
CODESYS V2 ETH
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;crasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
Importation des variables
Exporter des variables depuis l’API
Lors de la configuration de l’API gr&acirc;ce au logiciel de configuration du fabricant, autorisez la cr&eacute;ation d’un Fichier de
symboles (extension .sym) sous le logiciel de programmation CODESYS :
504
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;lectionnez Vider les entr&eacute;es de symboles.
4. Cliquez sur OK.
Note : Cliquez ensuite sur Configurer fichier symboles… et s&eacute;lectionnez Exporter variables de l'objet.
Nous recommandons de d&eacute;cocher la case et de la recocher ensuite pour s'assurer que les param&egrave;tres sont
corrects.
Dans certains cas, il est possible que les symboles de variables associ&eacute;s ou int&eacute;gr&eacute;s dans les modules I/O du fichier .sym
soient dupliqu&eacute;s. Pour supprimer les doublons, s&eacute;lectionnez l'entr&eacute;e &laquo; Configuration de l'API &raquo; dans la liste des objets et
d&eacute;cochez l'option &laquo; Exporter variables de l'objet &raquo;.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
505
CODESYS V2 ETH
Importer des variables dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
Pilote d'importation
Description
CODESYS2 sym v1.1
Lin&eacute;aire
N&eacute;cessite un fichier .sym.
CODESYS2 sym v1.1
Hi&eacute;rarchique
N&eacute;cessite un fichier .sym.
CODESYS2 sym_xml
v1.0
Hi&eacute;rarchique
N&eacute;cessite un fichier .sym_xml.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
506
Toutes les variables s’affichent au m&ecirc;me niveau.
Toutes les variables s’affichent en fonction de l’affichage hi&eacute;rarchique
CODESYS V2.
Toutes les variables s’affichent en fonction de l’affichage hi&eacute;rarchique
CODESYS V2.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
507
CODESYS V2 ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Exportation des tableaux de variables
Dans le logiciel CODESYS V2, les tableaux de variables sont divis&eacute;s en &eacute;l&eacute;ments individuels et une variable est cr&eacute;&eacute;e
pour chaque &eacute;l&eacute;ment. L'exemple suivant pr&eacute;sente un tableau avec 10 &eacute;l&eacute;ments.
508
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Si Exporter entr&eacute;es tableau est s&eacute;lectionn&eacute;, une variable sera cr&eacute;&eacute;e pour chaque &eacute;l&eacute;ment et export&eacute;e
vers le fichier .sym. La liste de variables sera import&eacute;e dans son int&eacute;gralit&eacute; et automatiquement dans l'&eacute;diteur de
variables.
En d&eacute;sactivant les entr&eacute;es du tableau d'exportation, seule une variable pour chaque tableau peut &ecirc;tre cr&eacute;&eacute;e.
Note : Lorsque les Entr&eacute;es de tableau d'exportation ont &eacute;t&eacute; effac&eacute;es, une seul variable est cr&eacute;&eacute;e et export&eacute;e
dans le fichier .sym. Le tableau n'est alors pas import&eacute; automatiquement vers l'&eacute;diteur de variables et il est
n&eacute;cessaire de configurer les variables manuellement dans l'&eacute;diteur de variables.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
509
CODESYS V2 ETH
Tous les &eacute;l&eacute;ments de variables peuvent &ecirc;tre r&eacute;f&eacute;renc&eacute;s dans l'&eacute;diteur en utilisant Indexvariables dans le dialogue
Associer &agrave; variable.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge par ce pilote de communication :
Erreur
Cause et action
Fichier de symboles absent
V&eacute;rifiez Fichier de symboles et t&eacute;l&eacute;chargez &agrave; nouveau le
programme de l’API.
&laquo; variable &raquo; absente du fichier de symboles
V&eacute;rifiez la pr&eacute;sence de cette variable dans le projet de
l’API.
D&eacute;lai d’attente d&eacute;pass&eacute; pour Confirmer
Le contr&ocirc;leur n’a pas envoy&eacute; de confirmation.
D&eacute;lai d’attente d&eacute;pass&eacute; pour la derni&egrave;re
action &agrave; Confirmer
Le contr&ocirc;leur n’a pas envoy&eacute; de confirmation pour la
derni&egrave;re action.
D&eacute;lai d’attente d&eacute;pass&eacute; pour la r&eacute;ception
des donn&eacute;es
Le contr&ocirc;leur ne retourne pas de donn&eacute;es.
D&eacute;lai d’attente de connexion d&eacute;pass&eacute;
Le p&eacute;riph&eacute;rique n’est pas connect&eacute;.
510
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&ocirc;leurs bas&eacute;s sur le logiciel CODESYS V3 PLC par l’entreprise 3S.
Note : Pour int&eacute;grer les &eacute;volutions du mat&eacute;riel et des protocoles du contr&ocirc;leur, les pilotes font l'objet d'une mise &agrave;
jour continue. Veuillez vous assurer que l'application utilise le pilote le plus r&eacute;cent.
Note : Il est possible que le protocole ou le mat&eacute;riel du contr&ocirc;leur ait &eacute;t&eacute; modifi&eacute; depuis la cr&eacute;ation de cette
documentation. Cela peut perturber le fonctionnement de ce pilote. Pour cette raison, veuillez toujours tester et
v&eacute;rifier le bon fonctionnement de l'application.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse
IP
Adresse IP Ethernet du contr&ocirc;leur
Adresse
Dans la mesure o&ugrave; certaines mises en œuvre de CODESYS V3 dans le runtime n&eacute;cessitent
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
511
CODESYS V3 ETH
&Eacute;l&eacute;ment
Description
de nœud
compl&egrave;te
l'indication des quatre valeurs de l'adresse IP dans les trames de protocoles, ce drapeau force
le protocole &agrave; cr&eacute;er des adresses IP qui utilisent les quatre champs d'adresses de l'IP.
D&eacute;compte La liste de variables repr&eacute;sente la meilleure m&eacute;thode pour augmenter la performance du
liste de
protocole de communication CODESYS V3 comme elle permet de demander plusieurs
variables &eacute;l&eacute;ments de donn&eacute;es lors d'une seule session de protocole.
Dans la mesure o&ugrave; certaines mises en œuvre de CODESYS V3 dans le runtime ne contiennent
qu'un nombre limit&eacute; de listes de variables &agrave; attribuer, ce param&egrave;tre vous permet de configurer le
nombre maximal de listes de variables que le pilote de communication essayera de cr&eacute;er dans
l'API.
Mod&egrave;le
d'API
Format d'octets qui sera utilis&eacute; par le pilote de communication en envoyant des trames de
communication &agrave; l'API.
D&eacute;lai
d'attente
Temps en millisecondes entre les nouvelles tentatives en cas d'&eacute;chec de communication.
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur (esclave).
Note : Veuillez consulter la documentation du contr&ocirc;leur pour conna&icirc;tre les valeurs requises pour les param&egrave;tres
Adresse de nœud compl&egrave;te ou D&eacute;compte liste de variables.
Importation des variables
Exporter des variables depuis l’API
Lors de la cr&eacute;ation du projet en utilisant CODESYS V3, veillez &agrave; configurer correctement le fichier des symboles qui
contiendra les variables requises.
512
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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'&eacute;l&eacute;ment
Application dans l'arborescence du projet, puis s&eacute;lectionnez Ajouter objet &gt; Configuration de symbole dans le menu
contextuel. L'&eacute;l&eacute;ment de configuration de symbole sera ajout&eacute; &agrave; l'arborescence du projet.
2. L'&eacute;l&eacute;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 &ecirc;tre s&eacute;lectionn&eacute;s dans l'&eacute;l&eacute;ment
correspondant de la liste.
3. Une fois la configuration des symboles termin&eacute;e, t&eacute;l&eacute;chargez le projet ou utilisez la fonction G&eacute;n&eacute;rer code
(Construire &gt; G&eacute;n&eacute;rer code) pour cr&eacute;er un fichier .xml qui contient toutes les variables de lecture &agrave; importer dans
l'&eacute;diteur de variables.
Importer des variables dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;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 | &copy; 2012-2017 DEIF A/S
513
CODESYS V3 ETH
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
Pilote d'importation
Description
CODESYS3 xml v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .xml.
CODESYS3 xml v1.0
Hi&eacute;rarchique
N&eacute;cessite un fichier .xml.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Toutes les variables s’affichent au m&ecirc;me niveau.
Toutes les variables s’affichent en fonction de l’affichage hi&eacute;rarchique
CODESYS V3.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
514
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
515
CODESYS V3 ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Ajouter un nom d’alias &agrave; un protocole
Les noms de variables doivent &ecirc;tre uniques au niveau d’un projet. Vous pouvez cependant &ecirc;tre amen&eacute; &agrave; utiliser les m&ecirc;mes
noms de variables pour diff&eacute;rents nœuds de contr&ocirc;leur (par exemple lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; deux
p&eacute;riph&eacute;riques ex&eacute;cutant la m&ecirc;me application).
Lorsque vous g&eacute;n&eacute;rez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables import&eacute;s pour
ce protocole.
Dans l’exemple, la connexion &agrave; un certain contr&ocirc;leur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le pr&eacute;fixe Nœud1, les rendant ainsi uniques au niveau projet/r&eacute;seau.
516
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Vous pouvez donner un nom d’alias uniquement aux variables import&eacute;es. Il n’est pas n&eacute;cessaire pour les
variables ajout&eacute;es manuellement dans l'&eacute;diteur de variables de porter un pr&eacute;fixe d’alias dans leur nom.
Vous associez la cha&icirc;ne d’alias &agrave; l’importation. Une fois l’importation des variables effectu&eacute;e, une modification
de la cha&icirc;ne d’alias n’aura aucun effet sur les noms figurant d&eacute;j&agrave; dans le dictionnaire. Lorsque vous modifiez la
cha&icirc;ne d’alias et r&eacute;importez les variables, toutes les variables r&eacute;import&eacute;es porteront la nouvelle cha&icirc;ne de
pr&eacute;fixe.
Types de donn&eacute;es
Le module d’importation prend en charge des variables des types de donn&eacute;es standard et d&eacute;finies par l’utilisateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
517
CODESYS V3 ETH
Types de
donn&eacute;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 &agrave; 1 dimension des types de donn&eacute;es ci-dessus. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Note * : La longueur maximale de la cha&icirc;ne d'une variable STRING dans l’API est de 80
caract&egrave;res. D&eacute;clarez une variable STRING soit avec une taille sp&eacute;cifique (ch: STRING(35)
soit avec la taille par d&eacute;faut (ch: STRING), qui est de 80 caract&egrave;res.
Types de
donn&eacute;es non
pris en charge
l
LWORD
l
LINT
Conversion de variables
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions, list&eacute;es ci-dessous.
518
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt; GHEFCDAB
&Eacute;change les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
ABC...NOP -&gt; OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110 0001110010111011011001000101101000011100101011000001
→
1 10000011100 1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
519
CODESYS V3 ETH
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;crasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
520
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Ethernet/IP CIP
Ce protocole a &eacute;t&eacute; mis en œuvre selon les sp&eacute;cifications Ethernet/IP publi&eacute;es (disponibles sur www.odva.org).
Le pilote Ethernet/IP CIP a &eacute;t&eacute; con&ccedil;u pour fournir la meilleure performance tout en ralentissant le moins possible la
performance globale du syst&egrave;me. Malgr&eacute; le fait que le pilote Ethernet/IP CIP est rapide, nous recommandons d'utiliser des
noms de variables brefs. Les variables sont lues et &eacute;crites par le p&eacute;riph&eacute;rique en indiquant leur nom symbolique dans les
requ&ecirc;tes de communication. Pour cette raison, un nom de variable plus long signifie un plus grand volume pour la requ&ecirc;te.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
Champ
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse
IP
Adresse IP Ethernet du contr&ocirc;leur.
Logement Num&eacute;ro de logement CPU pour mod&egrave;les Logix 5000 (typiquement 0). Pour plus de d&eacute;tails,
veuillez consulter la documentation du contr&ocirc;leur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
521
Ethernet/IP CIP
Champ
Description
Mod&egrave;les
d'API
Mod&egrave;le d'API utilis&eacute; pour importer le fichier de variables.
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur (esclave).
Mod&egrave;le contr&ocirc;leur Logix 5000
Le pilote Ethernet/IP CIP permet de connecter des contr&ocirc;leurs Allen-Bradley ControlLogix et CompactLogix Ethernet.
Pour assurer la communication avec les contr&ocirc;leurs ControlLogix&reg; 5500, veuillez utiliser un module de communication
Ethernet/IP pour Ethernet tel que les mod&egrave;les 1756-EN2T ou 1756-ENET.
La communication Ethernet avec les contr&ocirc;leurs CompactLogix™ 5300 requiert un processeur &agrave; port Ethernet/IP int&eacute;gr&eacute; tel
que le mod&egrave;le 1769-L32E.
Toutes les marques d&eacute;pos&eacute;es sont de la propri&eacute;t&eacute; de leurs propri&eacute;taires respectifs
Les CPU Logix ne sont pas dot&eacute;s d'une organisation de m&eacute;moire interne fixe mais la m&eacute;moire est configur&eacute;e au moment du
d&eacute;veloppement par l'utilisateur. Chaque &eacute;l&eacute;ment de donn&eacute;es peut &ecirc;tre identifi&eacute; par une cha&icirc;ne appel&eacute;e &laquo; variable &raquo;. Le
logiciel RSLogix 5000 peut alors exporter sur l'application de la liste des variables cr&eacute;&eacute;s pour chaque contr&ocirc;leur.
Le projet charg&eacute; sur le p&eacute;riph&eacute;rique IHM doit se r&eacute;f&eacute;rer aux noms de variables attribu&eacute;s dans le logiciel RSLogix 5000 au
moment du d&eacute;veloppement. L'&eacute;diteur de variable supporte l'importation directe du fichier de variable g&eacute;n&eacute;r&eacute; par le logiciel
RSLogix 5000 au format .csv.
La mise en œuvre du pilote Ethernet/IP prend en charge &eacute;galement les types de donn&eacute;es structur&eacute;es qui peuvent &ecirc;tre
import&eacute;s &agrave; partir de fichiers .L5X.
Le pilote prend en charge l'acc&egrave;s &agrave; la fois aux variables du contr&ocirc;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&ocirc;leur, effectuez un clic droit sur variables du contr&ocirc;leur.
2. S&eacute;lectionnez Exporter variables : le dialogue Exportation s'affiche.
522
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
3. Choisir Tous depuis la liste des variables pour exporter tous les variables.
4. S&eacute;lectionner l’option Enregistrer en tant que type en .CSV.
5. Cliquer sur Export : toutes les variables sont export&eacute;es vers un fichier .CSV.
Pour exporter le fichier type de donn&eacute;es .L5X :
1. S&eacute;lectionnez Fichier &gt; Enregistrer sous.
2. S&eacute;lectionner l’option Enregistrer en tant que type en .L5X.
3. Cliquer sur Enregistrer : toutes les variables sont export&eacute;es vers un fichier .L5X.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
523
Ethernet/IP CIP
Importer des fichiers dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
524
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
S&eacute;lectionner l’option Allen-Bradley RSLogix5000 v15.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
525
Ethernet/IP CIP
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Note : Lors de l'importation des types de donn&eacute;es de tableau, l'importateur les &eacute;tend en cr&eacute;ant des variables
individuelles par chaque &eacute;l&eacute;ment du tableau ; ceci est valable pour tous les types de donn&eacute;es, sauf pour les
tableaux bool&eacute;en. Dans ce cas, ils sont import&eacute;s en tant que &laquo; bool&eacute;en-32 &raquo; et l'&eacute;l&eacute;ment de tableau unique
peuvent &ecirc;tre trait&eacute; en utilisant le param&egrave;tre &laquo; Tag Index &raquo; depuis la bo&icirc;te de dialogue &laquo; Joindre &agrave; ... &raquo;.
Types de donn&eacute;es d&eacute;finies par module et d&eacute;finies par l’utilisateur
RSLogix 5000 vous permet de d&eacute;finir des variables avec plusieurs types de donn&eacute;es.
526
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Groupe de types de
donn&eacute;es
Description
Pr&eacute;d&eacute;finis
Types de donn&eacute;es standard tels que BOOL, DINT, SINT, INT
et types de donn&eacute;es moins courants tels que PID, COUNTER, TIMER.
D&eacute;finis par le module
Type de donn&eacute;es associ&eacute; &agrave; des modules I/O optionnelles g&eacute;n&eacute;ralement r&eacute;f&eacute;renc&eacute;s par
des alias.
D&eacute;finis par l'utilisateur
Type de donn&eacute;es personnalis&eacute; d&eacute;fini par l'utilisateur
Pour importer un type de donn&eacute;es Pr&eacute;d&eacute;fini (sauf types de donn&eacute;es standard qui sont toujours import&eacute;s) et D&eacute;fini par le
module, vous devez &eacute;diter le fichier ETIPSpecialDataTypes.xml &agrave; l'emplacement
langues\partag&eacute;es\studio\importationvariables ou (en fonction de la version du logiciel) studio\importationvariables.
Dans le logiciel RSLogix5000 :
1. Dans le volet Organisateur de contr&ocirc;leur, s&eacute;lectionnez variables du contr&ocirc;leur.
2. Variables de filtre pour afficher uniquement les variables Module-Defined.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
527
Ethernet/IP CIP
Seules les variables (alias) avec des types de donn&eacute;es qui appartiennent &agrave; des modules I/O en option s'afficheront.
528
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Dans cet exemple, l'alias HYS_Point_IO_Rack_20:I d&eacute;signe le type de donn&eacute;es AB:1734_3SLOT:I:0. D&eacute;veloppez cette
variable pour afficher la structure de ce type de donn&eacute;es :
Pour garantir que HYS_Point_IO_Rack_20:I, et toutes ses sous-variables soient import&eacute;es dans le projet, ouvrez le fichier
ETIPSpecialDataTypes.xml dans un &eacute;diteur de texte et v&eacute;rifiez s'il contient le type de donn&eacute;es AB:1734_3SLOT:I:0. Si
c'est le cas, vous pouvez continuer par le type de donn&eacute;es suivant. Sinon, vous devez l'ajouter manuellement.
La structure peut se pr&eacute;senter, par exemple, comme suit :
o&ugrave; :
l
aaa = Alias/Type de donn&eacute;es de variable
l
bbb = Nom de sous-variable (le nom de la sous-variable suit le point)
l
ccc = Type de donn&eacute;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&eacute;p&eacute;tez l'&eacute;tape 2 pour tous les types de donn&eacute;es D&eacute;finis par module.
4. R&eacute;p&eacute;ter la proc&eacute;dure depuis l’&eacute;tape 2, en filtrant les variables pour afficher uniquement les variables Pr&eacute;d&eacute;finies.
Mod&egrave;le contr&ocirc;leur Omron Sysmac
Il est possible d'acc&eacute;der aux donn&eacute;es dans les contr&ocirc;leurs NJ et CJ via le protocole CIP.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
529
Ethernet/IP CIP
Chaque &eacute;l&eacute;ment de donn&eacute;es peut &ecirc;tre identifi&eacute; par une cha&icirc;ne appel&eacute;e &laquo; variable &raquo;. Utiliser des outils de programmation
appropri&eacute;s pour le contr&ocirc;leur d'exportation de la liste des variables.
Les contr&ocirc;leurs de la s&eacute;rie NJ sont programm&eacute;s dans Sysmac Studio :
l
NJ301-xxxx
l
NJ501-xxxx
Les contr&ocirc;leurs de la s&eacute;rie CJ sont programm&eacute;s dans CX-One :
l
CJ2M CPU-3x
l
CJ2H CPU 6x-EIP
l
Tout processeur avec une unit&eacute; CJ1W-EIP21 associ&eacute;e.
Le projet charg&eacute; sur le p&eacute;riph&eacute;rique IHM doit se r&eacute;f&eacute;rer aux noms de variables attribu&eacute;s dans le logiciel de programmation
au moment du d&eacute;veloppement. L'&eacute;diteur de variable supporte l'importation directe du fichier de variable g&eacute;n&eacute;r&eacute; par le
logiciel Sysmac Studio au format .NJF ou g&eacute;n&eacute;r&eacute; par CX-One au format .CJF.
Toutes les variables qui peuvent &ecirc;tre consult&eacute;es par le p&eacute;riph&eacute;rique IHM doivent &ecirc;tre d&eacute;clar&eacute;es comme des Variables
globales.
Exportation des fichiers NJF en utilisant Sysmac Studio
Pour exporter le fichier variable .NJF :
1. Dans Sysmac Studio, d&eacute;clarer les variables comme Global Variables.
2. Configurer l'attribut de Publication r&eacute;seau sur Publier uniquement.
2. Dans le menu Outils, s&eacute;lectionnez Exporter variables globales &gt; CX-Designer.
530
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &eacute;diteur de texte.
4. Enregistrer le fichier sous .NJF.
Note : En utilisant le Bloc-notes comme &eacute;diteur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .NJF en s&eacute;lectionnant &laquo; Enregistrer sous &raquo; comme &laquo; tous les fichiers &raquo; bien que le fichier sera nomm&eacute;
*.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&icirc;te de dialogue Symbole &eacute;dition, r&eacute;gler le Net. Variables attribuer &agrave; Publication.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
531
Ethernet/IP CIP
3. Copier et coller tous les variables dans un &eacute;diteur de texte.
4. Enregistrer le fichier sous .CJF.
Note : En utilisant le Bloc-notes comme &eacute;diteur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .CJF en s&eacute;lectionnant &laquo; Enregistrer sous &raquo; comme &laquo; tous les fichiers &raquo; bien que le fichier sera nomm&eacute;
*.cjf.txt et il ne sera pas visible depuis l'importateur.
Exportation des structures d&eacute;finies de l’utilisateur
Pour exporter le fichier variable .CJS :
532
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
1. Dans CX-One, ouvrez le fichier de types de donn&eacute;es du projet.
2. Copier et coller tous les variables dans un &eacute;diteur de texte.
3. Enregistrer le fichier sous .CJS.
Note : En utilisant le Bloc-notes comme &eacute;diteur de texte, assurez-vous d'enregistrer le fichier texte avec l'
extension .CJS en s&eacute;lectionnant &laquo; Enregistrer sous &raquo; comme &laquo; tous les fichiers &raquo; bien que le fichier sera nomm&eacute;
*.cjs.txt et il ne sera pas visible depuis l'importateur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
533
Ethernet/IP CIP
Importer des fichiers dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
S&eacute;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&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de variables et cliquez sur Ouvrir. Le syst&egrave;me
vous demandera le fichier .CJS des structures d&eacute;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&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
534
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
535
Ethernet/IP CIP
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Note : Lors de l'importation des types de donn&eacute;es de tableau, l'importateur les &eacute;tend en cr&eacute;ant des variables
individuelles par chaque &eacute;l&eacute;ment du tableau ; ceci est valable pour tous les types de donn&eacute;es, sauf pour les
tableaux bool&eacute;en. Dans ce cas, ils sont import&eacute;s en tant que &laquo; bool&eacute;en-32 &raquo; et l'&eacute;l&eacute;ment de tableau unique
peuvent &ecirc;tre trait&eacute; en utilisant le param&egrave;tre &laquo; Tag Index &raquo; depuis la bo&icirc;te de dialogue &laquo; Joindre &agrave; ... &raquo;.
Mod&egrave;le contr&ocirc;leur Micro800
Le pilote Ethernet/IP CIP constitue un moyen facile et fiable de connexion aux contr&ocirc;leurs Allen-Bradley Micro800.
La port&eacute;e des variables dans un contr&ocirc;leur Micro800 peut &ecirc;tre limit&eacute;e &agrave; un programme local ou elle peut &ecirc;tre globale :
But
Description
Variables locales
Variables en fonction du programme Les variables sont affect&eacute;s au programme sp&eacute;cifique dans
le projet et disponible uniquement pour ce programme.
Ces variables ne sont pas support&eacute;es dans ce pilote.
Variables globales
Variables en fonction du contr&ocirc;leur. Les variables appartiennent au contr&ocirc;leur dans le projet et
sont disponibles &agrave; tout programme dans le projet.
Ces variables sont support&eacute;es dans ce pilote.
Exportation du fichier ISAXML en utilisant le Workbench de composant connect&eacute;
Pour exporter les variables globales .ISAXML y compris I/O tags :
536
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
1. S&eacute;lectionn&eacute; la balise P&eacute;riph&eacute;rique.
2. &Eacute;tend l'&eacute;l&eacute;ment Export.
3. S&eacute;lectionner l’export du p&eacute;riph&eacute;rique.
4. Cliquer sur l’onglet Exportation du fichier d’&eacute;change.
5. Cliquer sur le bouton Export.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
537
Ethernet/IP CIP
6. S&eacute;lectionnez un emplacement pour l'enregistrement du fichier d'exportation et cliquez sur Enregistrer.
7. Lorsque l'exportation s'est termin&eacute;e avec succ&egrave;s, les informations de sortie s'affichent :
538
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Le fichier d'exportation est un fichier d'archives comprim&eacute; avec 7-zip. Utiliser un utilitaire zip appropri&eacute;
pour extraire le contenu archive dans un dossier local.
Importer des fichiers dans l'&eacute;diteur
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
S&eacute;lectionner l’option Allen-Bradely CCW v15.
Structure du r&eacute;pertoire extraite de fichier 7z est quelque chose comme : “..\&lt;folder_name&gt;\Micro8xx\Micro8xx\”
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
539
Ethernet/IP CIP
Dans ce dernier dossier, s&eacute;lectionner le fichier Micro8xx.isaxml comme montr&eacute; ci-dessous :
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
540
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
Ajouter un nom d’alias &agrave; un protocole
Les noms de variables doivent &ecirc;tre uniques au niveau d’un projet. Vous pouvez cependant &ecirc;tre amen&eacute; &agrave; utiliser les m&ecirc;mes
noms de variables pour diff&eacute;rents nœuds de contr&ocirc;leur (par exemple lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; deux
p&eacute;riph&eacute;riques ex&eacute;cutant la m&ecirc;me application).
Lorsque vous g&eacute;n&eacute;rez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables import&eacute;s pour
ce protocole.
Dans l’exemple, la connexion &agrave; un certain contr&ocirc;leur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le pr&eacute;fixe Nœud1, les rendant ainsi uniques au niveau projet/r&eacute;seau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
541
Ethernet/IP CIP
Note : Vous pouvez donner un nom d’alias uniquement aux variables import&eacute;es. Il n’est pas n&eacute;cessaire pour les
variables ajout&eacute;es manuellement dans l'&eacute;diteur de variables de porter un pr&eacute;fixe d’alias dans leur nom.
Vous associez la cha&icirc;ne d’alias &agrave; l’importation. Une fois l’importation des variables effectu&eacute;e, une modification
de la cha&icirc;ne d’alias n’aura aucun effet sur les noms figurant d&eacute;j&agrave; dans le dictionnaire. Lorsque vous modifiez la
cha&icirc;ne d’alias et r&eacute;importez les variables, toutes les variables r&eacute;import&eacute;es porteront la nouvelle cha&icirc;ne de
pr&eacute;fixe.
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
543
Ethernet/IP CIP
Pilote d'importation
Description
Allen-Bradley L5X v1.1
Hi&eacute;rarchique
Requiert un fichier .L5X.
V&eacute;rifier le Mod&egrave;le du contr&ocirc;leur Logix 5000 pour plus de d&eacute;tails.
Toutes les variables s’affichent en fonction de l’affichage hi&eacute;rarchique
RSLogix5000.
Allen-Bradley
RSLogix5000 v15
Lin&eacute;aire
Requiert un fichier .CSV et des fichiers .L5X (en option).
V&eacute;rifier le Mod&egrave;le du contr&ocirc;leur Logix 5000 pour plus de d&eacute;tails.
Toutes les variables s’affichent au m&ecirc;me niveau.
Allen-Bradley CCW v15
Lin&eacute;aire
Requiert un fichier .ISAXML.
V&eacute;rifier le Mod&egrave;le du contr&ocirc;leur Micro800 pour plus de d&eacute;tails.
Toutes les variables s’affichent au m&ecirc;me niveau.
Omron Sysmac v15
Lin&eacute;aire
Requiert un fichier .NJF.
V&eacute;rifier le Mod&egrave;le du contr&ocirc;leur Omron Sysmac pour plus de d&eacute;tails.
Toutes les variables s’affichent au m&ecirc;me niveau.
544
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Omron CX-One v15
Lin&eacute;aire
Requiert un fichier .CJF et des fichiers .CJS (en option).
V&eacute;rifier le Mod&egrave;le du contr&ocirc;leur Omron Sysmac pour plus de d&eacute;tails.
Toutes les variables s’affichent au m&ecirc;me niveau.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique
export&eacute; de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
545
Ethernet/IP CIP
&Eacute;l&eacute;ment de la barre d’outils
Description
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contr&ocirc;leur r&eacute;pond &laquo; Ne pas confirmer &raquo;.
-
D&eacute;lai
d'attente
La requ&ecirc;te n’a obtenu aucune r&eacute;ponse dans
le d&eacute;lai d’attente sp&eacute;cifi&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute; et correctement
configur&eacute; pour acc&eacute;der au r&eacute;seau.
R&eacute;ponse
non valide
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse ou un
contenu non valide au p&eacute;riph&eacute;rique.
V&eacute;rifiez la coh&eacute;rence entre les donn&eacute;es programm&eacute;es
dans le projet et les ressources du contr&ocirc;leur.
Erreur
g&eacute;n&eacute;rale
Erreur non identifiable. Ne doit jamais &ecirc;tre
signal&eacute;e.
Contactez l’assistance technique.
546
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments
vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conversio
n
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs
conversions, list&eacute;es ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
550
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 | &copy; 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 &quot;SPN&quot;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
555
J1939
Error Class
Error
Notes
Runtime Errors
Communication Failure &gt; Can't send the APL PGN message
Not Connected &gt; The PGN for the command reply has not been received yet
Not Connected &gt; PGN block not registered
Not Connected &gt; the value never received
Timeout Error &gt; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Modbus RTU
Vous pouvez connecter les panneaux op&eacute;rateurs &agrave; un r&eacute;seau Modbus qui fera office de r&eacute;seau ma&icirc;tre du pilote de
communication.
D&eacute;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’&eacute;tat de la bobine
Lecture de bits multiples dans la bobine du p&eacute;riph&eacute;rique
02
Lecture de l’&eacute;tat d’entr&eacute;e
Lecture de l’&eacute;tat &laquo; MARCHE/ARR&Ecirc;T &raquo; des entr&eacute;es TOR (r&eacute;f&eacute;rence 1x) de
l'esclave
03
Lecture des registres
d’exploitation
Lecture de registres multiples
04
Lecture des registres d’entr&eacute;e
Lecture du contenu binaire des registres d’entr&eacute;e (r&eacute;f&eacute;rence 3x) de l’esclave
05
Forcer bobine seule
Force une bobine unique &agrave; passer en &eacute;tat &laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;
06
Pr&eacute;d&eacute;finir registre seul
Pr&eacute;d&eacute;finit une valeur dans un registre
16
Pr&eacute;d&eacute;finir registres multiples
Pr&eacute;d&eacute;finit une valeur dans des registres multiples
Note : La vitesse de communication maximale avec les contr&ocirc;leurs s’&eacute;l&egrave;ve &agrave; 115 200 bauds.
Note : Le format de donn&eacute;es en virgule flottante est conforme &agrave; la norme IEEE.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
557
Modbus RTU
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
ID de nœud
Nœud Modbus du p&eacute;riph&eacute;rique esclave.
D&eacute;lai
d'attente (ms)
D&eacute;lai d’attente (en millisecondes) entre deux tentatives en cas d’absence de r&eacute;ponse du
p&eacute;riph&eacute;rique esclave.
Retard (ms)
Retard en millisecondes entre la fin de la derni&egrave;re trame re&ccedil;ue et le d&eacute;but d’une nouvelle
requ&ecirc;te. S'il est &agrave; 0, le syst&egrave;me interne envoie une nouvelle requ&ecirc;te d&egrave;s qu’il est capable de
la programmer.
Nombre de
r&eacute;p&eacute;titions
Nombre d’envois d'un certain message au contr&ocirc;leur avant l’envoi d’un rapport d’erreur de
communication.
Lorsque ce nombre est configur&eacute; sur 1, le panneau envoie un rapport d’erreur de
communication si la r&eacute;ponse au paquet de la premi&egrave;re requ&ecirc;te est incorrecte.
558
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
Bloc lecture
max
Longueur maximale en octets d'une requ&ecirc;te de bloc de donn&eacute;es. Cette valeur s'applique
uniquement &agrave; l'acc&egrave;s en lecture aux Registres d'exploitation.
Bloc de bits
lecture max
Longueur maximale en bits d'une requ&ecirc;te de bloc de donn&eacute;es. Cette valeur s'applique
uniquement &agrave; l'acc&egrave;s en lecture aux bits d'entr&eacute;e et aux bobines de sortie.
&Eacute;criture du
Fonction Modbus pour les op&eacute;rations d'&eacute;criture dans les registres d'exploitation. Veuillez
registre
choisir entre la fonction 06 (Pr&eacute;d&eacute;finir registre seul) et la fonction 16 (Pr&eacute;d&eacute;finir registres
d’exploitation multiples).
Si la fonction 06 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 06 pour l'&eacute;criture
dans le contr&ocirc;leur, m&ecirc;me en &eacute;crivant dans plusieurs registres cons&eacute;cutifs.
Si la fonction 16 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 16 pour l'&eacute;criture
dans le contr&ocirc;leur, m&ecirc;me pour une requ&ecirc;te d'&eacute;criture dans un registre seul, et le param&egrave;tre
Taille max bloc lecture de la requ&ecirc;te est configur&eacute;e sur 2. L'utilisation de la fonction 16
peut augmenter la performance de la communication.
&Eacute;crire
bobines
Fonction Modbus pour les op&eacute;rations d'&eacute;criture dans les bobines de sortie. Veuillez choisir
entre la fonction 05 (&Eacute;crire bobine seule) et la fonction 15 (&Eacute;crire bobines multiples).
Si la fonction Modbus 05 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 05 pour
l'&eacute;criture dans le contr&ocirc;leur, m&ecirc;me en &eacute;crivant dans plusieurs bobines cons&eacute;cutives.
Si la fonction Modbus 15 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 15 pour
l'&eacute;criture dans le contr&ocirc;leur, m&ecirc;me pour une requ&ecirc;te d'&eacute;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&eacute;seau API est actif, tous les nœuds sont configur&eacute;s sur le
m&ecirc;me mode de transmission.
Mod&egrave;les
d'API
Permet de choisir entre les diff&eacute;rentes mod&egrave;les d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone
de m&eacute;moire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone
de m&eacute;moire des registres 32 bites.
Note : La plage d’adresses utilis&eacute;e dans les trames Modbus s'&eacute;tend toujours de
0 &agrave; 65535 pour les registres d’exploitation et de 0 &agrave; 65535 pour les bobines.
Comm...
En cliquant dessus, vous affichez la bo&icirc;te de dialogue de configuration des param&egrave;tres de
communication.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
559
Modbus RTU
&Eacute;l&eacute;ment
Description
&Eacute;l&eacute;ment
Param&egrave;tre
Port
S&eacute;lection du port s&eacute;rie.
l
l
l
COM1 : Port On-board
COM2 : Module Plug-in
en option branch&eacute; sur la
slot#1 ou slot#2
COM3 : Module Plug-in
en option branch&eacute; sur la
slot#3 ou slot#4
D&eacute;bit en bauds, parit&eacute;, bits de donn&eacute;es, bits
d’arr&ecirc;t
Param&egrave;tres de ligne s&eacute;rie.
Mode
Mode de port s&eacute;rie. Modes
disponibles :
l
RS-232.
l
RS-485 (2 fils).
l
RS-422 (4 fils).
R&eacute;seau d’API Il est possible de connecter plusieurs contr&ocirc;leurs &agrave; un p&eacute;riph&eacute;rique IHM. Pour configurer
plusieurs connexions, s&eacute;lectionnez R&eacute;seau d'API et cliquez sur Ajouter pour configurer
chaque esclave
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne appara&icirc;t.
2. S&eacute;lectionnez Modbus RTU dans la liste des protocoles : le dialogue de d&eacute;finition de variables s'affiche.
560
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
561
Modbus RTU
&Eacute;l&eacute;ment Description
Type de
m&eacute;moir
e
Ressource de Modbus o&ugrave; se situe la variable.
Type de m&eacute;moire
Description
&Eacute;tat de la bobine
Bobines
&Eacute;tat d’entr&eacute;e
Entr&eacute;e discr&egrave;te
Registres d'entr&eacute;e
Registres d'entr&eacute;e
Registres d’exploitation
Registres d’exploitation
Registres &agrave; 32 bits
Zone de m&eacute;moire des registres &agrave; 32 bits.
Disponible uniquement pour les mod&egrave;les d’API Enron
Modbus.
ID d'&eacute;crasement de nœud
Mode Modicon
param&egrave;tre de protocole (voir Types de donn&eacute;es sp&eacute;ciaux
pour plus d'informations concernant ce mode)
D&eacute;bit en bauds s&eacute;rie
Parit&eacute; s&eacute;rie
Bits d’arr&ecirc;t s&eacute;rie
Mode s&eacute;rie
S&eacute;rie termin&eacute;e
Offset
Adresse d’offset o&ugrave; se situe la variable.
Les adresses de d&eacute;calage sont six chiffres compos&eacute;s par un pr&eacute;fixe de type de donn&eacute;es &agrave; un
chiffre+ une adresse de ressource &agrave; cinq chiffres.
562
Generic
Modbus
Gamme
Offset
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
&Eacute;tat de la bobine
0 – 65535
0 – 65535
1–
65535
&Eacute;tat d’entr&eacute;e
100000 – 165535
0 – 65535
1–
65535
Registres d'entr&eacute;e
300000 – 365535
0 – 65535
1–
65535
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Sousin
dex
Type de
donn&eacute;e
s
Generic
Modbus
Gamme
Offset
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres &agrave; 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la s&eacute;lection de l'offset de ressource pour le registre.
Type de donn&eacute;es
Espace m&eacute;moire
Limites
boolean
Donn&eacute;e &agrave; 1 bite
0 ... 1
octet
Donn&eacute;e &agrave; 8 bite
-128 ... 127
short
Donn&eacute;e &agrave; 16 bite
-32768 ... 32767
int
Donn&eacute;e &agrave; 32 bite
-2.1e9 ... 2.1e9
int64
Donn&eacute;e &agrave; 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donn&eacute;e &agrave; 8 bite
0 ... 255
unsignedShort
Donn&eacute;e &agrave; 16 bite
0 ... 65535
unsignedInt
Donn&eacute;e &agrave; 32 bite
0 ... 4.2e9
uint64
Donn&eacute;e &agrave; 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
pr&eacute;cision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
pr&eacute;cision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des &eacute;l&eacute;ments contenant du code de caract&egrave;res d&eacute;fini
par l'encodage s&eacute;lectionn&eacute;
binary
Donn&eacute;es binaires arbitraires
Remarque : pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de
donn&eacute;es suivi de crochets tels que &laquo; byte[] &raquo;, &laquo; short[] &raquo;, etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
563
Modbus RTU
&Eacute;l&eacute;ment Description
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
GHEFCDAB
564
&Eacute;change les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
855441236 → 1426062386 (format d&eacute;cimal)
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
ID d'&eacute;crasement de nœud
Le protocole propose un type de donn&eacute;es sp&eacute;cial ID d’&eacute;crasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de m&eacute;moire correspond &agrave; un octet non sign&eacute;.
L’ID d'&eacute;crasement de nœud est initialis&eacute; avec la valeur de l’ID de nœud sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
ID d'&eacute;crasement
de nœud
Op&eacute;ration Modbus
0
La communication avec le contr&ocirc;leur est coup&eacute;e. En cas d’op&eacute;ration d'&eacute;criture, la requ&ecirc;te sera
transmise sans attente de r&eacute;ponse.
1 &agrave; 254
Interpr&eacute;t&eacute; comme &eacute;tant la valeur du nouvel ID de nœud et remplac&eacute; pour l’op&eacute;ration de runtime.
255
La communication avec le contr&ocirc;leur est coup&eacute;e, aucun message de requ&ecirc;te ne sera g&eacute;n&eacute;r&eacute;.
Note : Le maintien de la valeur de l’ID d'&eacute;crasement de nœud assign&eacute;e au moment du runtime est assur&eacute; par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
565
Modbus RTU
Mode Modicon
Ce protocole fournit un type de donn&eacute;es sp&eacute;cial qui permet d'&eacute;craser les param&egrave;tres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus g&eacute;n&eacute;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&egrave;tres de mode Modicon assign&eacute;e dans le runtime est conserv&eacute;e &agrave; travers les cycles
d’alimentation.
566
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;crasement des param&egrave;tres s&eacute;rie
Ce protocole fournit des types de donn&eacute;es sp&eacute;ciaux qui permettent d'&eacute;craser les param&egrave;tres s&eacute;rie dans le runtime.
Param&egrave;tre
Description
D&eacute;bit en bauds
s&eacute;rie
valeur 32 bits sans signature pour l'&eacute;crasement des d&eacute;bits en bauds. Les valeurs possibles sont
150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
Parit&eacute; s&eacute;rie
valeur 8 bits sans signature pour l'&eacute;crasement des parit&eacute;s. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
Valeur
Description
0
aucune parit&eacute;
1
parit&eacute; paire
2
parit&eacute; impaire
Bits d’arr&ecirc;t s&eacute;rie
valeur 8 bits sans signature pour l'arr&ecirc;t de l'&eacute;crasement de bits. Les valeurs possibles sont 1 ou 2.
Mode s&eacute;rie
valeur 8 bits sans signature pour l'&eacute;crasement du mode s&eacute;rie. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
567
Modbus RTU
Param&egrave;tre
S&eacute;rie termin&eacute;e
Description
Valeur
Description
0
Mode RS-232
1
Mode RS-485
2
Mode RS-422
Configurez sur 1 pour &eacute;craser les param&egrave;tres de ligne de communication. Les param&egrave;tres sont
trait&eacute;s ensemble uniquement lorsque vous configurez cette variable sur la valeur 1.
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
568
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Modbus g&eacute;n&eacute;rique csv
v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .csv.
DELTA PLC csv v1.0
N&eacute;cessite un fichier .csv.
Toutes les variables s’affichent au m&ecirc;me niveau.
Toutes les variables s’affichent au m&ecirc;me niveau.
Schneider Unity v1.0
Linear
Requiert un fichier .uny.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Le fichier contenant des symboles doit &ecirc;tre export&eacute; au format .txt et plus tard
rebaptis&eacute; .uny. Le pilote d'importation consid&egrave;re uniquement les variables
situ&eacute;es &agrave; l'adresse fixe et ne tient pas compte des tableaux de cha&icirc;nes. Tous
les autres tableaux, sauf pour le type bool&eacute;en, sont d&eacute;velopp&eacute;s.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
569
Modbus RTU
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
570
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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&eacute;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&eacute;moire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonn&eacute;es Type de donn&eacute;es dans la notation interne. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Commentaire
Description suppl&eacute;mentaire facultative.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&egrave;de pas de champ &laquo; Commentaire &raquo;. Lorsque ce champ est manquant, le caract&egrave;re de
fin de ligne doit &ecirc;tre une virgule.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
Pas de r&eacute;ponse
Pas de retour dans le d&eacute;lai d'attente
configur&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute; et
correctement configur&eacute; pour acc&eacute;der au
r&eacute;seau.
La r&eacute;ponse contient une
adresse de nœud
incorrecte
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse contenant une adresse de nœud non valide au
p&eacute;riph&eacute;rique.
Le message re&ccedil;u est
trop court
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse dans un
format non valide au p&eacute;riph&eacute;rique.
-
&Eacute;criture incorrecte
confirmation des
donn&eacute;es
Le contr&ocirc;leur a refus&eacute; une demande
d'&eacute;criture.
V&eacute;rifiez la coh&eacute;rence entre les donn&eacute;es de
projet et les ressources du contr&ocirc;leur.
572
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Modbus RTU Server
Le pilote de communication Modbus RTU Server permet de connecter le p&eacute;riph&eacute;rique IHM en tant qu'esclave &agrave; un r&eacute;seau
Modbus RTU. L'&eacute;change d'informations utilise les messages de Modbus standard.
Cette approche permet de connecter des p&eacute;riph&eacute;riques IHM &agrave; des syst&egrave;mes SCADA &agrave; travers le protocole de
communication Modbus RTU pris en charge de mani&egrave;re universelle.
Principe de l'op&eacute;ration
Le pilote de communication met en œuvre un groupe serveur Modbus RTU esclave sur le p&eacute;riph&eacute;rique IHM. Il prend en
charge un sous-ensemble de la gamme compl&egrave;te des codes de fonctions Modbus. Les codes de fonction disponibles
permettent le transfert de donn&eacute;es entre le ma&icirc;tre et l'esclave.
Le diagramme suivant repr&eacute;sente l'architecture de syst&egrave;me.
Le p&eacute;riph&eacute;rique IHM simule en fait l'interface de communication d'un API : Les types de donn&eacute;es des bobines et des
registres sont bool&eacute;ennes voire &agrave; 16 bits entiers.
Le p&eacute;riph&eacute;rique peut &agrave; tout moment acc&eacute;der aux donn&eacute;es enregistr&eacute;es dans sa m&eacute;moire interne. Le transfert de donn&eacute;es
de et vers le Modbus ma&icirc;tre est possible uniquement sur l'initiative du ma&icirc;tre m&ecirc;me.
D&eacute;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 | &copy; 2012-2017 DEIF A/S
573
Modbus RTU Server
Code Fonction
Description
01
Lecture de l’&eacute;tat de la bobine
Lecture de bits multiples dans la bobine du p&eacute;riph&eacute;rique.
03
Lecture des registres
d’exploitation
Lecture de registres multiples du p&eacute;riph&eacute;rique.
05
Forcer bobine seule
Force une bobine unique du p&eacute;riph&eacute;rique &agrave; passer en &eacute;tat
&laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;.
06
Pr&eacute;d&eacute;finir registre seul
Pr&eacute;d&eacute;finit une valeur dans un registre du p&eacute;riph&eacute;rique.
08
Test de diagnostic de
rebouclage
Seule la sous-fonction 00 (Retour des donn&eacute;es de requ&ecirc;te) est
prise en charge.
15
Forcer plusieurs bobines
Force plusieurs bobines du p&eacute;riph&eacute;rique &agrave; passer en &eacute;tat
&laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;.
16
Pr&eacute;d&eacute;finir registres multiples
Pr&eacute;d&eacute;finit une valeur dans plusieurs registres du p&eacute;riph&eacute;rique.
17
Rapport d'ID esclave
Retourne des informations de diagnostic du contr&ocirc;leur sur l'adresse
esclave.
23
Lecture/&eacute;criture de plusieurs
registres
Lit et pr&eacute;d&eacute;finit une valeur dans plusieurs registres du p&eacute;riph&eacute;rique
Codes d'exception
Code
Description
01
Fonction interdite. le code de fonction de la requ&ecirc;te n'est pas pris en charge
02
Adresse de donn&eacute;es interdite. L'adresse de donn&eacute;es re&ccedil;ue au cours de la requ&ecirc;te d&eacute;passe la
plage de donn&eacute;es pr&eacute;d&eacute;finie (ouvrez D&eacute;finition de variable pour afficher les d&eacute;tails des plages
pour tous les types).
03
Valeur de donn&eacute;es interdite. Une sous-fonction autre que 00 est sp&eacute;cifi&eacute;e dans le Test de
diagnostic de rebouclage (code 08).
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
574
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
ID
Modbus
ID de nœud Modbus. Chaque p&eacute;riph&eacute;rique de serveur Modbus du r&eacute;seau doit avoir sa propre ID
Modbus.
Registre
s Enron
32 bit
Si s&eacute;lectionn&eacute;, il permet de d&eacute;finir la premi&egrave;re adresse de registre et le nombre de registres pour
la zone de m&eacute;moire des registres &agrave; 32 bit.
Note : Les registres &agrave; 32 bit sont disponibles uniquement pour les mod&egrave;les d’API
Enron Modbus.
D&eacute;finition de la zone de m&eacute;moire des registres &agrave; 32 bits.
Comme
ncer reg
32bits
La valeur Commencer correspond &agrave; la premi&egrave;re adresse de registre.
La valeur Taille correspond au nombre de registres.
Note : La r&eacute;ponse &agrave; une requ&ecirc;te &agrave; l'un des registres de cette zone sera &agrave; 4 octets.
Taille
reg
32bits
Mod&egrave;les
d'API
Permet de choisir entre les diff&eacute;rentes mod&egrave;les d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone de
m&eacute;moire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de
m&eacute;moire des registres 32 bites.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
575
Modbus RTU Server
&Eacute;l&eacute;ment
Description
Note : La plage d’adresses utilis&eacute;e dans les trames Modbus s'&eacute;tend toujours de 0 &agrave;
65535 pour les registres d’exploitation et de 0 &agrave; 65535 pour les bobines.
Com
m...
En cliquant dessus, vous affichez la bo&icirc;te de dialogue de configuration des param&egrave;tres de
communication.
Veuillez configurer les param&egrave;tres selon les valeurs programm&eacute;es dans le ma&icirc;tre Modbus.
&Eacute;l&eacute;ment
Description
UART
S&eacute;lection du port s&eacute;rie.
l
l
l
COM1 : Port On-board
COM2 : Module Plug-in en option branch&eacute; sur
la slot#1 ou slot#2
COM3 : Module Plug-in en option branch&eacute; sur
la slot#3 ou slot#4
D&eacute;bit en bauds, parit&eacute;, bits
de donn&eacute;es, bits d’arr&ecirc;t
Param&egrave;tres de ligne s&eacute;rie.
Mode
Mode de port s&eacute;rie. Options disponibles :
l
RS-232
l
RS-485 (2 fils)
l
RS-422 (4 fils)
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
576
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne appara&icirc;t.
2. S&eacute;lectionnez Modbus RTU Server dans la liste des protocoles : le dialogue de d&eacute;finition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
577
Modbus RTU Server
&Eacute;l&eacute;ment Description
Type de
m&eacute;moir
e
Ressource de Modbus o&ugrave; se situe la variable.
Type de m&eacute;moire
Ressource Modbus
&Eacute;tat de la bobine
Bobines
&Eacute;tat d’entr&eacute;e
Entr&eacute;e discr&egrave;te
Registres d'entr&eacute;e
Registres d'entr&eacute;e
Registres d’exploitation
Registres d’exploitation
Registres &agrave; 32 bits
Zone de m&eacute;moire des registres &agrave; 32 bits.
Disponible uniquement pour les mod&egrave;les d’API Enron
Modbus.
ID d'&eacute;crasement de nœud
Mode Modicon
param&egrave;tre de protocole (voir Types de donn&eacute;es sp&eacute;ciaux
pour plus d'informations concernant ce mode)
D&eacute;bit en bauds s&eacute;rie
Parit&eacute; s&eacute;rie
Bits d’arr&ecirc;t s&eacute;rie
Mode s&eacute;rie
S&eacute;rie termin&eacute;e
Offset
Adresse d’offset o&ugrave; se situe la variable.
Les adresses de d&eacute;calage sont six chiffres compos&eacute;s par un pr&eacute;fixe de type de donn&eacute;es &agrave; un
chiffre+ une adresse de ressource &agrave; cinq chiffres.
578
Generic
Modbus
Gamme
Offset
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
&Eacute;tat de la bobine
0 – 65535
0 – 65535
1–
65535
&Eacute;tat d’entr&eacute;e
100000 – 165535
0 – 65535
1–
65535
Registres d'entr&eacute;e
300000 – 365535
0 – 65535
1–
65535
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Sousin
dex
Type de
donn&eacute;e
s
Generic
Modbus
Gamme
Offset
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres &agrave; 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la s&eacute;lection de l'offset de ressource pour le registre.
Type de donn&eacute;es
Espace m&eacute;moire
Limites
boolean
Donn&eacute;e &agrave; 1 bite
0 ... 1
octet
Donn&eacute;e &agrave; 8 bite
-128 ... 127
short
Donn&eacute;e &agrave; 16 bite
-32768 ... 32767
int
Donn&eacute;e &agrave; 32 bite
-2.1e9 ... 2.1e9
int64
Donn&eacute;e &agrave; 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donn&eacute;e &agrave; 8 bite
0 ... 255
unsignedShort
Donn&eacute;e &agrave; 16 bite
0 ... 65535
unsignedInt
Donn&eacute;e &agrave; 32 bite
0 ... 4.2e9
uint64
Donn&eacute;e &agrave; 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
pr&eacute;cision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
pr&eacute;cision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des &eacute;l&eacute;ments contenant du code de caract&egrave;res d&eacute;fini
par l'encodage s&eacute;lectionn&eacute;
binary
Donn&eacute;es binaires arbitraires
Remarque : pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de
donn&eacute;es suivi de crochets tels que &laquo; byte[] &raquo;, &laquo; short[] &raquo;, etc.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
579
Modbus RTU Server
&Eacute;l&eacute;ment Description
Taille
de
tableau
Lors de la configuration du tableau ou des variables de cha&icirc;ne, cette option d&eacute;finit la quantit&eacute;
d'&eacute;l&eacute;ments de r&eacute;seau ou des caract&egrave;res de la cha&icirc;ne.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
GHEFCDAB
580
&Eacute;change les octets d'un mot double.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
ID d'&eacute;crasement de nœud
Le protocole propose un type de donn&eacute;es sp&eacute;cial ID d’&eacute;crasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de m&eacute;moire correspond &agrave; un octet non sign&eacute;.
L’ID d'&eacute;crasement de nœud est initialis&eacute; avec la valeur de l’ID de nœud sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
ID d'&eacute;crasement
de nœud
Op&eacute;ration Modbus
0
La communication avec l’esclave est coup&eacute;e. En cas d’op&eacute;ration d'&eacute;criture, le p&eacute;riph&eacute;rique ne
r&eacute;pondra pas aux trames de requ&ecirc;te.
1 &agrave; 255
Interpr&eacute;t&eacute; comme &eacute;tant la valeur du nouvel ID de nœud et remplac&eacute; pour l’op&eacute;ration de runtime.
Note : Le maintien de la valeur de l’ID d'&eacute;crasement de nœud assign&eacute;e au moment du runtime est assur&eacute; par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
581
Modbus RTU Server
Mode Modicon
Ce protocole fournit un type de donn&eacute;es sp&eacute;cial qui permet d'&eacute;craser les param&egrave;tres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus g&eacute;n&eacute;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&egrave;tres de mode Modicon assign&eacute;e dans le runtime est conserv&eacute;e &agrave; travers les cycles
d’alimentation.
582
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;crasement des param&egrave;tres s&eacute;rie
Ce protocole fournit des types de donn&eacute;es sp&eacute;ciaux qui permettent d'&eacute;craser les param&egrave;tres s&eacute;rie dans le runtime.
Param&egrave;tre
Description
D&eacute;bit en bauds
s&eacute;rie
valeur 32 bits sans signature pour l'&eacute;crasement des d&eacute;bits en bauds. Les valeurs possibles sont
150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
Parit&eacute; s&eacute;rie
valeur 8 bits sans signature pour l'&eacute;crasement des parit&eacute;s. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
Valeur
Description
0
aucune parit&eacute;
1
parit&eacute; paire
2
parit&eacute; impaire
Bits d’arr&ecirc;t s&eacute;rie
valeur 8 bits sans signature pour l'arr&ecirc;t de l'&eacute;crasement de bits. Les valeurs possibles sont 1 ou 2.
Mode s&eacute;rie
valeur 8 bits sans signature pour l'&eacute;crasement du mode s&eacute;rie. Veuillez trouver les valeurs possibles
dans la liste ci-dessous.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
583
Modbus RTU Server
Param&egrave;tre
S&eacute;rie termin&eacute;e
Description
Valeur
Description
0
Mode RS-232
1
Mode RS-485
2
Mode RS-422
Configurez sur 1 pour &eacute;craser les param&egrave;tres de ligne de communication. Les param&egrave;tres sont
trait&eacute;s ensemble uniquement lorsque vous configurez cette variable sur la valeur 1.
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
584
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Modbus g&eacute;n&eacute;rique csv
v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .csv.
Fichier .xml export&eacute;
de l'&eacute;diteur de
variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Toutes les variables s’affichent au m&ecirc;me niveau.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
585
Modbus RTU Server
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
586
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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&eacute;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&eacute;moire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonn&eacute;es Type de donn&eacute;es dans la notation interne. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Commentaire
Description suppl&eacute;mentaire facultative.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&egrave;de pas de champ &laquo; Commentaire &raquo;. Lorsque ce champ est manquant, le caract&egrave;re de
fin de ligne doit &ecirc;tre une virgule.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Ce protocole de communication remplit
une fonction de serveur et ne renvoie pas de message d'erreur de protocole sp&eacute;cifique.
Voir la section &laquo; Variables syst&egrave;me &raquo; du manuel principal.
588
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
TCP Modbus
Il est possible de connecter divers p&eacute;riph&eacute;riques compatibles TCP Modbus &agrave; des p&eacute;riph&eacute;riques IHM. Pour configurer votre
p&eacute;riph&eacute;rique TCP Modbus, consultez la documentation re&ccedil;ue avec ce p&eacute;riph&eacute;rique.
La mise en œuvre du protocole s’effectue uniquement sous forme de client TCP Modbus.
D&eacute;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’&eacute;tat de la
bobine
Lecture de bits multiples dans la bobine de l'IHM.
02
Lecture de l’&eacute;tat d’entr&eacute;e
Lecture de l’&eacute;tat &laquo; MARCHE/ARR&Ecirc;T &raquo; des entr&eacute;es TOR (r&eacute;f&eacute;rence 1x)
de l'esclave.
03
Lecture des registres
d’exploitation
Lecture de plusieurs registres.
04
Lecture des registres
d’entr&eacute;e
Lecture du contenu binaire des registres d’entr&eacute;e (r&eacute;f&eacute;rence 3x) de
l’esclave.
05
Forcer bobine seule
Force une bobine unique &agrave; passer en &eacute;tat &laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;.
06
Pr&eacute;d&eacute;finir registre seul
&Eacute;criture d'une valeur dans un registre.
15
&Eacute;crire plusieurs bobines
&Eacute;criture de l'&eacute;tat &laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo; pour chaque bobine
d'une s&eacute;quence de bobines.
16
Pr&eacute;d&eacute;finir registres
multiples
&Eacute;criture de valeurs dans un bloc de registres dans une s&eacute;quence.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
589
TCP Modbus
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse IP
Adresse du contr&ocirc;leur.
Port
Num&eacute;ro du port utilis&eacute; par le pilote Modbus TCP. La valeur par d&eacute;faut est 502. Vous pouvez
la changer lorsque la communication se fait par des routeurs ou des passerelles Internet o&ugrave;
que le num&eacute;ro de port par d&eacute;faut est d&eacute;j&agrave; utilis&eacute;.
utiliser
UDP/IP
Si cette option a &eacute;t&eacute; s&eacute;lectionn&eacute;e, le protocole utilisera des datagrammes UDP sans
connexion.
RTU
encapsul&eacute;
Si cette option a &eacute;t&eacute; s&eacute;lectionn&eacute;e, le protocole utilisera de pr&eacute;f&eacute;rence le protocole RTU en
s&eacute;rie via Ethernet au lieu du protocole Modbus TCP, ind&eacute;pendamment du fait si TCP ou
UDP est utilis&eacute;.
590
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
D&eacute;lai
d'attente
(ms)
D&eacute;lai d’attente (en millisecondes) entre deux tentatives en cas d’absence de r&eacute;ponse du
p&eacute;riph&eacute;rique esclave.
ID Modbus
G&eacute;n&eacute;ralement utilis&eacute; en cas de communication par passerelles Ethernet vers s&eacute;rie, puis
interpr&eacute;t&eacute; comme l’ID esclave. Sa valeur est simplement copi&eacute;e dans le champ
Identificateur d’unit&eacute; de la trame de communication du Modbus TCP. Il est rarement utilis&eacute;,
vous pouvez le laisser &agrave; z&eacute;ro dans la plupart des cas.
Bloc lecture
max
Longueur maximale en octets d'une requ&ecirc;te de bloc de donn&eacute;es. Cette valeur s'applique
uniquement &agrave; l'acc&egrave;s en lecture aux Registres d'exploitation.
Bloc de bits
lecture max
Longueur maximale en bits d'une requ&ecirc;te de bloc de donn&eacute;es. Cette valeur s'applique
uniquement &agrave; l'acc&egrave;s en lecture aux bits d'entr&eacute;e et aux bobines de sortie.
&Eacute;criture du
registre
d’exploitati
on
Fonction Modbus pour les op&eacute;rations d'&eacute;criture dans les registres d'exploitation. Veuillez
choisir entre la fonction 06 (Pr&eacute;d&eacute;finir registre seul) et la fonction 16 (Pr&eacute;d&eacute;finir registres
multiples).
Si 06 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 06 pour l'&eacute;criture dans le
contr&ocirc;leur, m&ecirc;me en &eacute;crivant dans plusieurs registres cons&eacute;cutifs.
Si 16 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 16 pour l'&eacute;criture dans le
contr&ocirc;leur, m&ecirc;me pour une requ&ecirc;te d'&eacute;criture dans un registre seul, et le param&egrave;tre Taille
max bloc lecture de la requ&ecirc;te est configur&eacute; sur 2. L'utilisation de la fonction 16 peut
augmenter la performance de la communication.
Si Auto est s&eacute;lectionn&eacute;, le protocole utilisera la fonction 06 ou la fonction 16 en fonction du
nombre de registres &agrave; &eacute;crire.
&Eacute;crire
bobines
Fonction Modbus pour les op&eacute;rations d'&eacute;criture dans les bobines de sortie. Veuillez choisir
entre la fonction 05 (&Eacute;crire bobine seule) et la fonction 15 (&Eacute;crire bobines multiples).
Si la fonction Modbus 05 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 05 pour
l'&eacute;criture dans le contr&ocirc;leur, m&ecirc;me en &eacute;crivant dans plusieurs bobines cons&eacute;cutives.
Si la fonction Modbus 15 est s&eacute;lectionn&eacute;e, le protocole utilisera toujours la fonction 15 pour
l'&eacute;criture dans le contr&ocirc;leur, m&ecirc;me pour une requ&ecirc;te d'&eacute;criture dans une bobine seule.
L'utilisation de la fonction 15 peut augmenter la performance de la communication.
Mod&egrave;les
d'API
Permet de choisir entre les diff&eacute;rentes mod&egrave;les d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources
commencent avec d&eacute;calage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone
de m&eacute;moire des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de
m&eacute;moire des registres 32 bites.
Note : La plage d’adresses utilis&eacute;e dans les trames Modbus s'&eacute;tend toujours de 0
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
591
TCP Modbus
&Eacute;l&eacute;ment
Description
&agrave; 65535 pour les registres d’exploitation et de 0 &agrave; 65535 pour les bobines.
R&eacute;seau
d’API
592
Adresse IP de tous les contr&ocirc;leurs en connexions multiples. Vous devez s&eacute;lectionner
R&eacute;seau d’API pour permettre les connexions multiples.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne appara&icirc;t.
2. S&eacute;lectionnez Modbus TCP dans la liste Pilote : le dialogue de d&eacute;finition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
593
TCP Modbus
&Eacute;l&eacute;ment
Description
Type de
m&eacute;moire
Ressource de Modbus o&ugrave; se situe la variable.
Type de m&eacute;moire
Ressource Modbus
&Eacute;tat de la bobine
Bobines
&Eacute;tat d’entr&eacute;e
Entr&eacute;e discr&egrave;te
Registres d'entr&eacute;e
Registres d'entr&eacute;e
Registres
d’exploitation
Registres d’exploitation
Registres &agrave; 32 bits
Zone de m&eacute;moire des registres &agrave; 32 bits.
Disponible uniquement pour les mod&egrave;les d’API Enron Modbus.
IP d'&eacute;crasement de
nœud
param&egrave;tre de protocole (voir Types de donn&eacute;es sp&eacute;ciaux pour plus
d'informations concernant ce mode)
Port d'&eacute;crasement de
nœud
ID d'&eacute;crasement de
nœud
Mode Modicon
Offset
Adresse d’offset o&ugrave; se situe la variable.
Les adresses de d&eacute;calage sont six chiffres compos&eacute;s par un pr&eacute;fixe de type de donn&eacute;es &agrave; un chiffre+ une
adresse de ressource &agrave; cinq chiffres.
Sousind
ex
594
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
Generic Modbus
Gamme Offset
&Eacute;tat de la bobine
0 – 65535
0 – 65535
1 – 65535
&Eacute;tat d’entr&eacute;e
100000 – 165535
0 – 65535
1 – 65535
Registres d'entr&eacute;e
300000 – 365535
0 – 65535
1 – 65535
Registres d’exploitation
400000 – 465535
0 – 65535
1 – 65535
Registres &agrave; 32 bits
0 – 65535
0 – 65535
1 – 65535
Permet la s&eacute;lection de l'offset de ressource pour le registre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Type de
donn&eacute;es
Description
Type de donn&eacute;es
Espace m&eacute;moire
Limites
boolean
Donn&eacute;e &agrave; 1 bite
0 ... 1
octet
Donn&eacute;e &agrave; 8 bite
-128 ... 127
short
Donn&eacute;e &agrave; 16 bite
-32768 ... 32767
int
Donn&eacute;e &agrave; 32 bite
-2.1e9 ... 2.1e9
int64
Donn&eacute;e &agrave; 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donn&eacute;e &agrave; 8 bite
0 ... 255
unsignedShort
Donn&eacute;e &agrave; 16 bite
0 ... 65535
unsignedInt
Donn&eacute;e &agrave; 32 bite
0 ... 4.2e9
uint64
Donn&eacute;e &agrave; 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
pr&eacute;cision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
pr&eacute;cision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des &eacute;l&eacute;ments contenant du code de caract&egrave;res d&eacute;fini par
l'encodage s&eacute;lectionn&eacute;
binary
Donn&eacute;es binaires arbitraires
Remarque : pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de donn&eacute;es suivi de
crochets tels que &laquo; byte[] &raquo;, &laquo; short[] &raquo;, etc.
Taille de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets disponible pour
la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute; Encoding est
r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un caract&egrave;re
n&eacute;cessite 2 octets.
Conversi
on
Conversion &agrave; appliquer &agrave; la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
595
TCP Modbus
&Eacute;l&eacute;ment
Description
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions, list&eacute;es cidessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
596
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche dans la liste
Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste
Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;crasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
597
TCP Modbus
Port d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial port d’&eacute;crasement de nœud, qui vous permet de modifier le port r&eacute;seau du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire correspond &agrave; un short non sign&eacute;.
Le port d'&eacute;crasement de nœud est initialis&eacute; avec la valeur du port du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
Port d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne sera
g&eacute;n&eacute;r&eacute;e.
Autre que 0
Interpr&eacute;t&eacute; comme &eacute;tant la valeur du nouveau port et remplac&eacute; pour l’op&eacute;ration de runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable de port d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de port d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
598
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
ID d'&eacute;crasement de nœud
Le protocole propose un type de donn&eacute;es sp&eacute;cial ID d’&eacute;crasement de nœud qui vous permet de modifier l’ID de nœud de
l’esclave dans le runtime. Ce type de m&eacute;moire correspond &agrave; un octet non sign&eacute;.
L’ID d'&eacute;crasement de nœud est initialis&eacute; avec la valeur de l’ID de nœud sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
ID d'&eacute;crasement
de nœud
Op&eacute;ration Modbus
0
La communication avec le contr&ocirc;leur est coup&eacute;e. En cas d’op&eacute;ration d'&eacute;criture, la requ&ecirc;te sera
transmise sans attente de r&eacute;ponse.
1 &agrave; 254
Interpr&eacute;t&eacute; comme &eacute;tant la valeur du nouvel ID de nœud et remplac&eacute; pour l’op&eacute;ration de runtime.
255
La communication avec le contr&ocirc;leur est coup&eacute;e, aucun message de requ&ecirc;te ne sera g&eacute;n&eacute;r&eacute;.
Note : Le maintien de la valeur de l’ID d'&eacute;crasement de nœud assign&eacute;e au moment du runtime est assur&eacute; par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
599
TCP Modbus
Mode Modicon
Ce protocole fournit un type de donn&eacute;es sp&eacute;cial qui permet d'&eacute;craser les param&egrave;tres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus g&eacute;n&eacute;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&egrave;tres de mode Modicon assign&eacute;e dans le runtime est conserv&eacute;e &agrave; travers les cycles
d’alimentation.
600
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
601
TCP Modbus
Type
Description
Modbus g&eacute;n&eacute;rique csv
v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .csv.
DELTA PLC csv v1.0
N&eacute;cessite un fichier .csv.
Toutes les variables s’affichent au m&ecirc;me niveau.
Toutes les variables s’affichent au m&ecirc;me niveau.
CODESYS2 sym v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .sym.
Toutes les variables s’affichent au m&ecirc;me niveau.
Une fois le fichier .sym s&eacute;lectionn&eacute;, le dialogue suivant s'affichera pour la
s&eacute;lection de mod&egrave;le d'API.
Kollmorgen txt v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .txt.
Schneider Unity v1.0
Linear
Requiert un fichier .uny.
602
Toutes les variables s’affichent au m&ecirc;me niveau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Type
Description
Le fichier contenant des symboles doit &ecirc;tre export&eacute; au format .txt et plus tard
rebaptis&eacute; .uny. Le pilote d'importation consid&egrave;re uniquement les variables
situ&eacute;es &agrave; l'adresse fixe et ne tient pas compte des tableaux de cha&icirc;nes. Tous les
autres tableaux, sauf pour le type bool&eacute;en, sont d&eacute;velopp&eacute;s.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
603
TCP Modbus
&Eacute;l&eacute;ment de la barre d’outils
Description
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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&eacute;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&eacute;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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Champ
Description
FormatDeDonn&eacute;es Type de donn&eacute;es dans la notation interne. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Commentaire
Description suppl&eacute;mentaire facultative.
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne poss&egrave;de pas de champ &laquo; Commentaire &raquo;. Lorsque ce champ est manquant, le caract&egrave;re de
fin de ligne doit &ecirc;tre une virgule.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
Pas de r&eacute;ponse
Pas de retour dans le d&eacute;lai d'attente
configur&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute;
et correctement configur&eacute; pour
acc&eacute;der au r&eacute;seau.
La r&eacute;ponse contient
une adresse de nœud
incorrecte
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse
contenant une adresse de nœud non
valide au p&eacute;riph&eacute;rique.
-
Le message re&ccedil;u est
trop court
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse dans
un format non valide au p&eacute;riph&eacute;rique.
-
&Eacute;criture incorrecte
confirmation des
donn&eacute;es
Le contr&ocirc;leur a refus&eacute; une demande
d'&eacute;criture.
V&eacute;rifiez la coh&eacute;rence entre les
donn&eacute;es de projet et les ressources
du contr&ocirc;leur.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
605
Modbus TCP Server
Modbus TCP Server
Le pilote de communication Modbus TCP Server permet de connecter le p&eacute;riph&eacute;rique IHM en tant qu'esclave &agrave; un r&eacute;seau
TCP Modbus. Ensuite, il est possible de connecter des clients TCP Modbus &agrave; plusieurs panneaux IHM utilis&eacute;s comme
serveurs. L'&eacute;change d'informations utilise les messages TCP Modbus standard.
Cette approche permet de connecter des p&eacute;riph&eacute;riques IHM &agrave; des syst&egrave;mes SCADA &agrave; travers le protocole de
communication TCP Modbus pris en charge de mani&egrave;re universelle.
Principe de l'op&eacute;ration
Le pilote de communication met en œuvre un groupe Modbus TCP Server sur le p&eacute;riph&eacute;rique IHM. Il prend en charge un
sous-ensemble de la gamme compl&egrave;te des codes de fonctions Modbus. Les codes de fonction disponibles permettent le
transfert de donn&eacute;es entre les clients du r&eacute;seau TCP et le serveur. Le p&eacute;riph&eacute;rique IHM remplit une fonction de serveur
dans le r&eacute;seau. Il peut &eacute;changer des donn&eacute;es avec jusqu'&agrave; 32 clients. Cela signifie que jusqu'&agrave; 32 clients peuvent &ecirc;tre
connect&eacute;s simultan&eacute;ment au p&eacute;riph&eacute;rique IHM. Si les 32 connexions disponibles sont toutes utilis&eacute;es, toute tentative
ult&eacute;rieure de connexion d'un client sera rejet&eacute;e par le serveur.
Le diagramme suivant repr&eacute;sente l'architecture de syst&egrave;me.
Le p&eacute;riph&eacute;rique simule l'interface de communication d'un API : Les types de donn&eacute;es des bobines et des registres sont
bool&eacute;ennes voire &agrave; 16 bits entiers.
Le p&eacute;riph&eacute;rique peut &agrave; tout moment acc&eacute;der aux donn&eacute;es enregistr&eacute;es dans sa m&eacute;moire interne. Le transfert de donn&eacute;es
de et vers un client Modbus est possible uniquement sur l'initiative du client m&ecirc;me.
D&eacute;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’&eacute;tat de la bobine
Lecture de bits multiples dans la bobine du p&eacute;riph&eacute;rique.
02
Lecture de l’&eacute;tat d’entr&eacute;e
Lecture de bits multiples dans la bobine du p&eacute;riph&eacute;rique.
606
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Code Fonction
Description
03
Lecture des registres
d’exploitation
Lecture de registres multiples du p&eacute;riph&eacute;rique.
04
Lecture des registres
d’entr&eacute;e
Lecture de registres multiples du p&eacute;riph&eacute;rique.
05
Forcer bobine seule
Force une bobine unique du p&eacute;riph&eacute;rique &agrave; passer en &eacute;tat
&laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;.
06
Pr&eacute;d&eacute;finir registre seul
Pr&eacute;d&eacute;finit une valeur dans un registre du p&eacute;riph&eacute;rique.
15
Forcer plusieurs bobines
Force plusieurs bobines du p&eacute;riph&eacute;rique &agrave; passer en &eacute;tat
&laquo; MARCHE &raquo; ou &laquo; ARR&Ecirc;T &raquo;.
16
Pr&eacute;d&eacute;finir registres multiples
Pr&eacute;d&eacute;finit une valeur dans plusieurs registres du p&eacute;riph&eacute;rique.
23
Lecture/&eacute;criture de plusieurs
registres
Lit et pr&eacute;d&eacute;finit une valeur dans plusieurs registres du p&eacute;riph&eacute;rique
Note : Sur les deux types d'API, les fonctions Lecture de l’&eacute;tat de la bobine et Lecture de l’&eacute;tat d’entr&eacute;e acc&egrave;dent
toutes les deux &agrave; la m&ecirc;me m&eacute;moire de bobine dans la m&eacute;moire du p&eacute;riph&eacute;rique IHM. Les fonctions Lecture des
registres de maintien et Lecture des registres d’entr&eacute;e acc&egrave;dent toutes les deux &agrave; la m&ecirc;me zone de registre dans
la m&eacute;moire du p&eacute;riph&eacute;rique IHM.
Codes d'exception
Code
Description
01
Fonction interdite. le code de fonction de la requ&ecirc;te n'est pas pris en charge
02
Adresse de donn&eacute;es interdite. L'adresse de donn&eacute;es re&ccedil;ue au cours de la requ&ecirc;te
d&eacute;passe la plage de donn&eacute;es pr&eacute;d&eacute;finie (voir Param&egrave;tre d’&eacute;dition variable pour afficher
les d&eacute;tails des plages pour tous les types).
03
Valeur de donn&eacute;es interdite. Une sous-fonction autre que 00 est sp&eacute;cifi&eacute;e dans le Test
de diagnostic de rebouclage (code 08).
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
607
Modbus TCP Server
&Eacute;l&eacute;ment
Description
ID Modbus
ID de nœud Modbus du p&eacute;riph&eacute;rique IHM. Chaque p&eacute;riph&eacute;rique de serveur Modbus du r&eacute;seau doit avoir
sa propre ID Modbus.
Port
Num&eacute;ro du port utilis&eacute; par le protocole TCP Modbus. Par d&eacute;faut, cette valeur est configur&eacute;e &agrave; 502.
Configurez la valeur selon le num&eacute;ro de port utilis&eacute; par votre r&eacute;seau TCP Modbus.
utiliser
UDP/IP
Si cette option a &eacute;t&eacute; s&eacute;lectionn&eacute;e, le protocole utilisera des datagrammes UDP sans connexion.
RTU
encapsul&eacute;
Si cette option a &eacute;t&eacute; s&eacute;lectionn&eacute;e, le protocole utilisera de pr&eacute;f&eacute;rence le protocole RTU en s&eacute;rie via
Ethernet au lieu du protocole Modbus TCP, ind&eacute;pendamment du fait si TCP ou UDP est utilis&eacute;.
Registres
Si s&eacute;lectionn&eacute;, il permet de d&eacute;finir la premi&egrave;re adresse de registre et le nombre de registres pour la zone
Enron 32 bit de m&eacute;moire des registres &agrave; 32 bit.
Note : Les registres &agrave; 32 bit sont disponibles uniquement pour les mod&egrave;les d’API Enron
Modbus.
608
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
D&eacute;finition de la zone de m&eacute;moire des registres &agrave; 32 bits.
Commencer La valeur Commencer correspond &agrave; la premi&egrave;re adresse de registre.
reg 32bits
La valeur Taille correspond au nombre de registres.
Taille reg
Note : La r&eacute;ponse &agrave; une requ&ecirc;te &agrave; l'un des registres de cette zone sera &agrave; 4 octets.
32bits
Mod&egrave;les
d'API
Permet de choisir entre les diff&eacute;rentes mod&egrave;les d’API :
l
l
l
l
Modicon Modbus (1-based) : Mise en œuvre modbus o&ugrave; toutes les ressources commencent
avec d&eacute;calage 1.
Generic Modbus (0-based) : Mise en Œuvre modbus o&ugrave; toutes les ressources commencent
avec d&eacute;calage 0.
Enron Modbus (1-based) : Mise en œuvre Extends Modicon Modbus avec la zone de m&eacute;moire
des registres 32 bites.
Enron Modbus (0-base) : Mise en œuvre Extends Generic Modbus avec la zone de m&eacute;moire des
registres 32 bites.
Note : La plage d’adresses utilis&eacute;e dans les trames Modbus s'&eacute;tend toujours de 0 &agrave; 65535 pour
les registres d’exploitation et de 0 &agrave; 65535 pour les bobines.
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne appara&icirc;t.
2. S&eacute;lectionnez Modbus TCP Server dans la liste des protocoles : le dialogue de d&eacute;finition de variables s'affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
609
Modbus TCP Server
&Eacute;l&eacute;ment Description
Type de
m&eacute;moir
e
Ressource de Modbus o&ugrave; se situe la variable.
Type de m&eacute;moire
Ressource Modbus
&Eacute;tat de la bobine
Bobines
&Eacute;tat d’entr&eacute;e
Entr&eacute;e discr&egrave;te
Registres d'entr&eacute;e
Registres d'entr&eacute;e
Registres d’exploitation
Registres d’exploitation
Registres &agrave; 32 bits
Zone de m&eacute;moire des registres &agrave; 32 bits.
Disponible uniquement pour les mod&egrave;les d’API Enron Modbus.
Mode Modicon
Offset
param&egrave;tre de protocole (voir Types de donn&eacute;es sp&eacute;ciaux pour
plus d'informations concernant ce mode)
Adresse d’offset o&ugrave; se situe la variable.
Les adresses de d&eacute;calage sont six chiffres compos&eacute;s par un pr&eacute;fixe de type de donn&eacute;es &agrave; un
chiffre+ une adresse de ressource &agrave; cinq chiffres.
Sousin
dex
610
Generic
Modbus
Gamme
Offset
Type de m&eacute;moire
Gamme Offset
Modicon
Gamme Offset
&Eacute;tat de la bobine
0 – 65535
0 – 65535
1–
65535
&Eacute;tat d’entr&eacute;e
100000 – 165535
0 – 65535
1–
65535
Registres d'entr&eacute;e
300000 – 365535
0 – 65535
1–
65535
Registres d’exploitation
400000 – 465535
0 – 65535
1–
65535
Registres &agrave; 32 bits
0 – 65535
0 – 65535
1–
65535
Permet la s&eacute;lection de l'offset de ressource pour le registre.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Type de
donn&eacute;e
s
Type de donn&eacute;es
Espace m&eacute;moire
Limites
boolean
Donn&eacute;e &agrave; 1 bite
0 ... 1
octet
Donn&eacute;e &agrave; 8 bite
-128 ... 127
short
Donn&eacute;e &agrave; 16 bite
-32768 ... 32767
int
Donn&eacute;e &agrave; 32 bite
-2.1e9 ... 2.1e9
int64
Donn&eacute;e &agrave; 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donn&eacute;e &agrave; 8 bite
0 ... 255
unsignedShort
Donn&eacute;e &agrave; 16 bite
0 ... 65535
unsignedInt
Donn&eacute;e &agrave; 32 bite
0 ... 4.2e9
uint64
Donn&eacute;e &agrave; 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
pr&eacute;cision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
pr&eacute;cision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des &eacute;l&eacute;ments contenant du code de caract&egrave;res d&eacute;fini
par l'encodage s&eacute;lectionn&eacute;
binary
Donn&eacute;es binaires arbitraires
Remarque : pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de
donn&eacute;es suivi de crochets tels que &laquo; byte[] &raquo;, &laquo; short[] &raquo;, etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
611
Modbus TCP Server
&Eacute;l&eacute;ment Description
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
612
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
Mode Modicon
Ce protocole fournit un type de donn&eacute;es sp&eacute;cial qui permet d'&eacute;craser les param&egrave;tres du mode Modicon dans le runtime.
Mode Modicon
Description
0
Modbus g&eacute;n&eacute;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&egrave;tres de mode Modicon assign&eacute;e dans le runtime est conserv&eacute;e &agrave; travers les cycles
d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
613
Modbus TCP Server
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
614
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Modbus g&eacute;n&eacute;rique
csv v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .csv.
CODESYS2 sym v1.0
Lin&eacute;aire
N&eacute;cessite un fichier .sym.
Toutes les variables s’affichent au m&ecirc;me niveau.
Toutes les variables s’affichent au m&ecirc;me niveau.
Une fois le fichier .sym s&eacute;lectionn&eacute;, le dialogue suivant s'affichera pour la
s&eacute;lection de mod&egrave;le d'API.
Fichier .xml export&eacute;
de l'&eacute;diteur de
variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
615
Modbus TCP Server
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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&eacute;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 | &copy; 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&eacute;moire
Adresse
l
OUTP
l
INP
l
IREG
l
HREG
Offset compatible avec la notation Modbus
FormatDeDonn&eacute;es Type de donn&eacute;es dans la notation interne. Consultez la section &laquo; Concepts de
programmation &raquo; du manuel principal.
Commentaire
Description suppl&eacute;mentaire facultative.
Exemple de fichier de variables
Exemple de ligne .csv :
2, Holding Register 1, HREG, 400001, unsignedShort,
Note : Cette ligne ne poss&egrave;de pas de champ &laquo; Commentaire &raquo;. Lorsque ce champ est manquant, le caract&egrave;re de
fin de ligne doit &ecirc;tre une virgule.
&Eacute;tat de communication
Le p&eacute;riph&eacute;rique IHM est un poste serveur dans le r&eacute;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 &laquo; Variables syst&egrave;me &raquo; du manuel principal.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
l
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
&Eacute;change les octets d'un mot double.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
627
Mitsubishi FX ETH
Element Description
Valeur
Description
GHEFCDAB
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
629
Mitsubishi FX ETH
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importer
Description
GX Works2 v1.0
Linear
Requires a .csvfile.
Tag Editor exported xml
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
631
Mitsubishi FX ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
635
Mitsubishi FX SER
Element Description
l
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
636
&Eacute;change les octets d'un mot double.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Valeur
Description
GHEFCDAB
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute; de
l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
639
Mitsubishi FX SER
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
640
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;Unpassive&quot;:
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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
When using Mitsubishi CPU with integrated Ethernet port the &quot;Open System&quot; settings should be changed to &quot;MC
connection&quot;
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 &gt; Ethernet Port &gt; Basic
Settings &gt; Own Node Settings.
646
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
SLMP Connection Module must be added in Module parameter &gt; Ethernet Port &gt; Basic Settings &gt; External Device
Configuration &gt; Detailed Settings &gt; 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 | &copy; 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 | &copy; 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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
649
Mitsubishi iQ/Q/L ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
650
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
653
NMEA 0183
Element
Description
Arraysize
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments
vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;PLC Network&quot; check box and provide the configuration per each node.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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 | &copy; 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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
All variables will be displayed at the same level.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
682
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
683
Omron FINS ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 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 | &copy; 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 | &copy; 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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;Programming concepts&quot; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Element Description
Arraysi
ze
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
691
Omron FINS SER
Element Description
Valeur
Description
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Importing Tags in Tag Editor
S&eacute;lectionnez le pilote dans l'&eacute;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 | &copy; 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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
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 | &copy; 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 | &copy; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
OPC UA Client
Le pilote de communication OPC UA Client a &eacute;t&eacute; con&ccedil;u pour connecter les p&eacute;riph&eacute;riques IHM aux serveurs OPC UA.
Cette mise en œuvre du protocole s’effectue uniquement en tant que client.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
697
OPC UA Client
&Eacute;l&eacute;ment
Description
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur.
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse
IP
Adresse IP du serveur.
Port
Num&eacute;ro de port d'&eacute;coute du serveur.
D&eacute;lai
d'attente
(ms)
D&eacute;lai d’attente (en millisecondes) entre deux tentatives en cas d’absence de r&eacute;ponse du
p&eacute;riph&eacute;rique serveur.
Certificat
de
serveur
Certificat de serveur &agrave; architecture unifi&eacute;e OPC (format PEM). Lorsque l'&eacute;l&eacute;ment est vide,
aucune s&eacute;curit&eacute; n’est activ&eacute;e pour la communication.
URI
strat&eacute;gie
de
serveur
URI (Uniform Resource Identifier) du point de terminaison demand&eacute; dans le serveur OPC.
Mode
s&eacute;curit&eacute;
Type d’authentification :
Lorsque l'&eacute;l&eacute;ment est vide, le point de terminaison par d&eacute;faut sera utilis&eacute;. En temps normal,
aucune s&eacute;curit&eacute; n’est activ&eacute;e pour le point de terminaison par d&eacute;faut.
l
None : Aucune authentification avec le serveur et aucun cryptage de donn&eacute;es.
l
Sign : Certificats utilis&eacute;s uniquement pour l’authentification avec le serveur.
l
SignAndEncrypt : Certificats utilis&eacute;s pour l’authentification avec le serveur et le
cryptage des donn&eacute;es.
Note : configurez toujours le Mode s&eacute;curit&eacute; en ad&eacute;quation l’URI strat&eacute;gie de
serveur. Par exemple, ne s&eacute;lectionnez pas SignAndEncrypt pour un point de
terminaison qui ne prend pas en charge le cryptage.
Certificat
client
Certificat utilis&eacute; par le client OPC UA. Lorsque l'&eacute;l&eacute;ment est vide, un certificat est g&eacute;n&eacute;r&eacute;
automatiquement.
Cl&eacute;
priv&eacute;e du
client
Cl&eacute; utilis&eacute;e par le client OPC UA. Lorsque l'&eacute;l&eacute;ment est vide, une cl&eacute; est g&eacute;n&eacute;r&eacute;e
automatiquement.
Mod&egrave;les
d'API
Aucune option disponible.
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Dans la liste des protocoles, s&eacute;lectionnez OPC UA Client.
2. Pour ajouter une variable, cliquez sur + : la bo&icirc;te de dialogue de d&eacute;finition de variable s’affiche.
698
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Type de
donn&eacute;e
s
Types de donn&eacute;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 &laquo; Concepts de programmation &raquo; du manuel principal.
Note : Pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de donn&eacute;es
suivi de crochets.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
Conversion &agrave; appliquer &agrave; la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
699
OPC UA Client
&Eacute;l&eacute;ment Description
sion
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
700
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
Nom de
variable
Nom de la variable &agrave; utiliser dans la communication.
Note : Les propri&eacute;t&eacute;s des variables r&eacute;sultent du processus d’importation. Dans la plupart des cas, la cr&eacute;ation
manuelle d’une variable n’est pas n&eacute;cessaire.
Ajouter un nom d’alias &agrave; un protocole
Les noms de variables doivent &ecirc;tre uniques au niveau d’un projet. Vous pouvez cependant &ecirc;tre amen&eacute; &agrave; utiliser les m&ecirc;mes
noms de variables pour diff&eacute;rents nœuds de contr&ocirc;leur (par exemple lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; deux
p&eacute;riph&eacute;riques ex&eacute;cutant la m&ecirc;me application).
Lorsque vous g&eacute;n&eacute;rez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables import&eacute;s pour
ce protocole.
Dans l’exemple, la connexion &agrave; un certain contr&ocirc;leur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le pr&eacute;fixe Nœud1, les rendant ainsi uniques au niveau projet/r&eacute;seau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
701
OPC UA Client
Note : Vous pouvez donner un nom d’alias uniquement aux variables import&eacute;es. Il n’est pas n&eacute;cessaire pour les
variables ajout&eacute;es manuellement dans l'&eacute;diteur de variables de porter un pr&eacute;fixe d’alias dans leur nom.
Vous associez la cha&icirc;ne d’alias &agrave; l’importation. Une fois l’importation des variables effectu&eacute;e, une modification
de la cha&icirc;ne d’alias n’aura aucun effet sur les noms figurant d&eacute;j&agrave; dans le dictionnaire. Lorsque vous modifiez la
cha&icirc;ne d’alias et r&eacute;importez les variables, toutes les variables r&eacute;import&eacute;es porteront la nouvelle cha&icirc;ne de
pr&eacute;fixe.
Importer les variables
Vous devez importer les variables depuis les serveurs &agrave; architecture unifi&eacute;e OPC.
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Dans la liste des protocoles, s&eacute;lectionnez OPC UA Client.
2. Cliquez sur Importer variable.
3. S&eacute;lectionnez Pilote d’importation hi&eacute;rarchique.
4. Entrez l’adresse du serveur et cliquez sur Parcourir.
702
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
5. Une fois le processus de d&eacute;tection termin&eacute;, cliquez sur OK pour cr&eacute;er le dictionnaire de variables.
Voir la section &laquo; Mon premier projet &raquo; du manuel principal.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Description
Connexion &lt;Error description&gt;
Erreur durant la connexion
Connexion pendant lecture : &lt;Error
description&gt;
Erreur rencontr&eacute;e lors d’une connexion pour une
op&eacute;ration de lecture
Mauvais &eacute;tat de lecture : &lt;Error description&gt;
Erreur dans l’op&eacute;ration de lecture
Connexion pendant &eacute;criture : &lt;Error
description&gt;
Erreur rencontr&eacute;e lors d’une connexion pour une
op&eacute;ration d'&eacute;criture
Mauvais &eacute;tat d’&eacute;criture : &lt;Error description&gt;
Erreur dans l’op&eacute;ration d'&eacute;criture
Client OPC UA introuvable pour un ID de
nœud donn&eacute;
Mauvaise information d’ID de nœud
&lt;Error description&gt; peut &ecirc;tre l'une des erreurs suivantes :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
703
OPC UA Client
Erreur
Notes
BadTimeout
Erreur dans le d&eacute;lai d’attente. Aucune r&eacute;ponse du serveur.
BadSecurityChecksFailed Erreur durant l’&eacute;change de certificats. Se produit g&eacute;n&eacute;ralement lorsque le
serveur ne consid&egrave;re pas le certificat client comme &eacute;tant fiable.
BadCertificatexxxInvalid
Erreur dans le certificat client ou serveur.
BadNodeUnknown
La variable (nœud) n’existe pas.
BadAttributeNotFound
Tentative d’acc&egrave;s &agrave; un attribut non valide.
BadNotWritable
Tentative d'&eacute;criture dans un attribut en lecture seule.
704
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Simatic S7 PPI
Vous pouvez connecter vos p&eacute;riph&eacute;riques IHM &agrave; la gamme d’API Simatic S7-200 de Siemens. Les ports de programmation
API &eacute;tablissent la communication gr&acirc;ce aux protocoles PPI et PPI+.
Ce document pr&eacute;sente le protocole PPI+ et contient toutes les informations n&eacute;cessaires pour une connexion r&eacute;ussie.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
&Eacute;l&eacute;ment
Description
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur (esclave).
ID de
panneau
Num&eacute;ro de nœud du panneau op&eacute;rateur.
ID
esclave
Num&eacute;ro de nœud de l’API connect&eacute;e.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
705
Simatic S7 PPI
&Eacute;l&eacute;ment
Description
ID max
Disponible uniquement en cas d’utilisation du protocole PPI+. Contient le num&eacute;ro de nœud le
plus &eacute;lev&eacute; dans le r&eacute;seau PPI+.
PPI+
Activ&eacute; pour utiliser le protocole PPI+ au lieu du protocole PPI.
D&eacute;lai
d'attente
(ms)
D&eacute;lai d’attente entre deux tentatives d’envoi du m&ecirc;me message lorsque le contr&ocirc;leur n’envoie
aucune r&eacute;ponse.
706
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
Mod&egrave;les
d'API
De nombreux contr&ocirc;leurs Siemens sont pris en charge. Consultez directement le logiciel de
programmation IDE pour une liste compl&egrave;te des contr&ocirc;leurs pris en charge.
Comm…
En cliquant dessus, vous affichez la bo&icirc;te de dialogue de configuration des param&egrave;tres de
communication.
&Eacute;l&eacute;ment
Param&egrave;tre
Port
S&eacute;lection du port s&eacute;rie.
Sur UN20 :
l
l
COM1 : port d’API du p&eacute;riph&eacute;rique.
COM2 : Port de
l’ordinateur/imprimante
Sur UN31 ou UN30 :
l
l
l
COM1 : port s&eacute;rie int&eacute;gr&eacute;
COM2 : module facultatif branch&eacute;
au cr&eacute;neau 1/2
COM3 : module facultatif branch&eacute;
au cr&eacute;neau 3/4
D&eacute;bit en bauds, parit&eacute;, bits de donn&eacute;es, bits Param&egrave;tres de ligne s&eacute;rie.
d’arr&ecirc;t
Mode
Mode de port s&eacute;rie. Modes disponibles :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
707
Simatic S7 PPI
&Eacute;l&eacute;ment
Description
&Eacute;l&eacute;ment
Param&egrave;tre
l
RS-232.
l
RS-485 (2 fils).
l
RS-422 (4 fils).
Param&egrave;tres de l’&eacute;diteur de variables
Dans l'&eacute;diteur de variables, s&eacute;lectionnez Simatic S7 PPI dans la liste des protocoles d&eacute;finis, puis cliquez sur + pour ajouter
une variable.
&Eacute;l&eacute;ment
Description
Type de
m&eacute;moire
Zone de l’API o&ugrave; se situe la variable.
Offset
Adresse d’offset o&ugrave; se situe la variable.
Sousind
ex
En cas de type de donn&eacute;es bool&eacute;en, il s’agit de l’offset d'un seul bit.
Type de
donn&eacute;es
Types de donn&eacute;es disponibles :
708
l
boolean
l
octet
l
short
l
int
l
unsignedByte
l
unsignedShort
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
l
unsignedInt
l
float
l
string
Consultez la section &laquo; Concepts de programmation &raquo; du manuel principal.
Taille de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets disponible pour
la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute; Encoding est
r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un caract&egrave;re
n&eacute;cessite 2 octets.
Conversi
on
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions, list&eacute;es cidessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
709
Simatic S7 PPI
&Eacute;l&eacute;ment
Description
Valeur
Description
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche dans la liste
Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de la liste
Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
Connectivit&eacute; PPI+
Vous pouvez connecter vos p&eacute;riph&eacute;riques IHM &agrave; plus d’un CPU S7-200, et vous pouvez &eacute;galement connecter plus d’un
panneau op&eacute;rateur &agrave; la m&ecirc;me API.
Les panneaux op&eacute;rateur n’interf&eacute;rerons pas avec la communication PPI+ entre les API.
710
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;cuter, lire et &eacute;crire des op&eacute;rations vers et depuis d’autres API. Dans le m&ecirc;me temps, vous pouvez
connecter plus d’un panneau au r&eacute;seau PPI et acc&eacute;der &agrave; toutes les variables des API.
Vous pouvez utiliser le logiciel de programmation API et effectuer une programmation en ligne sans interf&eacute;rer avec la
communication panneau-API.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge pour ce pilote de communication :
Erreur
Cause
Action
NAK
Le contr&ocirc;leur r&eacute;pond &laquo; Ne pas confirmer &raquo;.
-
D&eacute;lai
d'attente
La requ&ecirc;te n’a obtenu aucune r&eacute;ponse dans
le d&eacute;lai d’attente sp&eacute;cifi&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute; et correctement
configur&eacute; pour acc&eacute;der au r&eacute;seau.
R&eacute;ponse
non valide
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse ou un
contenu non valide au p&eacute;riph&eacute;rique.
V&eacute;rifiez la coh&eacute;rence entre les donn&eacute;es programm&eacute;es
dans le projet et les ressources du contr&ocirc;leur.
Erreur
g&eacute;n&eacute;rale
Erreur non identifiable. Ne doit jamais &ecirc;tre
signal&eacute;e.
Contactez l’assistance technique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
711
Simatic S7 ETH
Simatic S7 ETH
Le pilote de communication Simatic S7 ETH a &eacute;t&eacute; con&ccedil;u pour communiquer avec les contr&ocirc;leurs Simatic via une
connexion Ethernet.
Le contr&ocirc;leur Simatic doit &ecirc;tre &eacute;quip&eacute; soit d’un port Ethernet int&eacute;gr&eacute;, soit d’une interface Ethernet appropri&eacute;e (int&eacute;gr&eacute;e ou
avec un module).
La communication se base sur les fonctions PG/OP (protocole ISO-on-TCP).
Le pr&eacute;sent document d&eacute;crit les param&egrave;tres de pilote &agrave; appliquer dans le logiciel de programmation IDE et API S7.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole dans la liste API.
La bo&icirc;te de dialogue de configuration du pilote s’affiche.
&Eacute;l&eacute;ment
Description
Alias
Nom d’identification des nœuds dans les configurations r&eacute;seau. Il est ajout&eacute; en pr&eacute;fixe &agrave;
chaque nom de variable import&eacute; pour chaque nœud r&eacute;seau.
Adresse
IP
Adresse IP Ethernet du contr&ocirc;leur.
Logement Num&eacute;ro du cr&eacute;neau sur lequel est mont&eacute; le processeur. 2 pour S7-300. Cette valeur peut &ecirc;tre
plus grande pour des syst&egrave;mes S7-400.
712
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment
Description
Mod&egrave;les
d'API
Liste des mod&egrave;les de contr&ocirc;leurs compatibles. Assurez-vous de s&eacute;lectionner le mod&egrave;le d’API
correct dans cette liste lors de la configuration du protocole.
R&eacute;seau
d’API
Active l’acc&egrave;s aux contr&ocirc;leurs multiples en r&eacute;seau. Configurez la bonne option pour chaque
contr&ocirc;leur (esclave).
Configuration avec les API S7-1200 et S7-1500
Les s&eacute;ries d’API S7-1200 (&agrave; partir de la version du logiciel 4.0) et S7-1500 de Siemens disposent d’un pare-feu int&eacute;gr&eacute;. Par
d&eacute;faut, le niveau de protection maximal est activ&eacute;. Pour &eacute;tablir la communication entre ces mod&egrave;les d’API, vous devez
activer la communication S7 avec des p&eacute;riph&eacute;riques tiers. Ce param&egrave;tre est disponible dans le logiciel de programmation
du portail TIA.
1. Ouvrez le projet de l’API dans le portail TIA.
2. S&eacute;lectionnez l’API dans l’arborescence du projet et ouvrez les Propri&eacute;t&eacute;s de l’API.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
713
Simatic S7 ETH
3. En g&eacute;n&eacute;ral &gt; La protection choisit une permission entre les trois premiers (assurez-vous que l’encoche soit pr&eacute;sente
sur la colonne IHM).
Note : Si &laquo; Pas d'acc&egrave;s &raquo; est s&eacute;lectionn&eacute;, la communication avec le panneau ne sera pas &eacute;tablie.
714
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
4. Faites d&eacute;filer la page vers le bas et cochez la case &laquo; Autoriser l’acc&egrave;s via la communication PUT/GET par des
partenaires distants &raquo;.
Note : Si vous avez d&eacute;fini des variables dans &laquo; Blocs de programme &raquo;, vous devez configurer le DB comme
&eacute;tant &laquo; Non optimis&eacute; &raquo;.
Pour v&eacute;rifier ou modifier l’optimisation du DB, ouvrez les Propri&eacute;t&eacute;s du DB :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
715
Simatic S7 ETH
Dans l’onglet G&eacute;n&eacute;ral &gt; Attributs, d&eacute;cochez la case &laquo; Acc&egrave;s au bloc optimis&eacute; &raquo; :
716
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Si la case &laquo; Acc&egrave;s au bloc optimis&eacute; &raquo; n’est pas activ&eacute;e (gris&eacute;e), cela peut signifier que le DB est un &laquo; DB d’instance &raquo; reli&eacute;
&agrave; un &laquo; FB &agrave; acc&egrave;s optimis&eacute; &raquo;.
Une fois le projet compil&eacute;, l’offset de variable s’affiche &agrave; c&ocirc;t&eacute; du nom de la variable.
Ces param&egrave;tres s’appliquent au logiciel de programmation du portail TIA et aux gammes d’API S7-1200 (&agrave; 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&eacute;lectionnez Outils &gt; Connexions Ethernet : la bo&icirc;te de dialogue Configurer les connexions Ethernet s‘affiche.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&icirc;te de dialogue des propri&eacute;t&eacute;s de cette connexion s’affiche.
5. S&eacute;lectionnez les options Connexion au pupitre op&eacute;rateur (OP) et Accepter toutes les demandes de
connexion.
6. Dans la section Propri&eacute;t&eacute;s distantes (Client), configurez le TSAP sur 02.00.
718
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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&eacute;n&eacute;r&eacute;s par Simatic Step7. Vous pouvez pr&eacute;alablement exporter le fichier de
symboles gr&acirc;ce &agrave; l’utilitaire de la table des mn&eacute;moniques de Step7.
Vous pouvez exporter les fichiers de symboles (.asc) depuis l’utilitaire de la table des mn&eacute;moniques.
1. Dans l'&eacute;diteur de mn&eacute;moniques, s&eacute;lectionnez le menu Table des mn&eacute;moniques et cliquez sur Exporter.
2. Donnez un nom &agrave; la table des mn&eacute;moniques et enregistrez-la au format de fichier ASCII.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
719
Simatic S7 ETH
Exporter des fichiers sources
Vous pouvez g&eacute;n&eacute;rer ces fichiers en exportant du code source.
1. Ouvrez n’importe quel bloc de programme dans l’&eacute;diteur (&laquo; OB1 &raquo; dans l’exemple ci-dessous).
2. Dans le menu Fichier, cliquez sur G&eacute;n&eacute;rer un fichier source. La bo&icirc;te de dialogue suivante s’affiche :
1. Donnez-lui un nom (&laquo; Sources &raquo; dans l’exemple) et cliquez sur OK : la bo&icirc;te de dialogueG&eacute;n&eacute;rer le fichier source
Sources s’affiche.
720
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
2. Cliquez sur Tous &gt; afin de g&eacute;n&eacute;rer un fichier source pour tous les blocs.
3. S&eacute;lectionnez les options suivantes :
l
Inclure les blocs de r&eacute;f&eacute;rence
l
Trier en fonction de la structure du programme
l
Adresse Symbolique
4. Cliquez sur OK pour confirmer : l'objet &laquo; Sources &raquo; est g&eacute;n&eacute;r&eacute; dans le projet Step7, comme dans l’exemple.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
721
Simatic S7 ETH
5. Faites un clic droit sur l’objet et s&eacute;lectionnez Exporter Sources.
Vous pouvez importer le fichier .awl g&eacute;n&eacute;r&eacute; dans l’&eacute;diteur de variable.
Note : Le fichier .awl contient des informations suppl&eacute;mentaires dont ne dispose pas le fichier .asc export&eacute; &agrave;
partir de la table des mn&eacute;moniques.
Assurez-vous que la table des mn&eacute;moniques contient une r&eacute;f&eacute;rence &agrave; tous les blocs de donn&eacute;es. Vous pouvez importer les
variables d’un bloc de donn&eacute;es uniquement lorsque la table des mn&eacute;moniques contient une ligne mentionnant le nom du
bloc de donn&eacute;es et les commentaires le concernant.
722
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Chaque entr&eacute;e permet au filtre d’importation d'importer les variables se rapportant au bloc de donn&eacute;es concern&eacute;.
Exporter des fichiers TIA, XLSX, SCL et UDT avec le portail TIA
Exporter des fichiers .tia
Ces fichiers se rapportent aux variables DB d&eacute;finies dans Blocs de programme.
1. D&eacute;finissez le bloc de donn&eacute;es comme &eacute;tant Non optimis&eacute;.
2. Faites un clic droit sur le bloc de donn&eacute;es et s&eacute;lectionnez Propri&eacute;t&eacute;s :
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
723
Simatic S7 ETH
3. Dans l’onglet G&eacute;n&eacute;ral, s&eacute;lectionnez Attributs et d&eacute;s&eacute;lectionnez Acc&egrave;s au bloc optimis&eacute;.
724
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Si l’option Acc&egrave;s au bloc optimis&eacute; n’est pas activ&eacute;e (case &agrave; cocher gris&eacute;e), cela peut signifier que le
bloc de donn&eacute;es est un &laquo; DB d’instance &raquo; reli&eacute; &agrave; un &laquo; FB &agrave; acc&egrave;s optimis&eacute; &raquo;.
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 | &copy; 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&eacute;lectionn&eacute;.
7. S&eacute;lectionnez toutes les lignes.
8. Faites un copier-coller dans n’importe quel &eacute;diteur de texte.
9. Enregistrer le fichier sous DBxxx.tia, o&ugrave; xxx correspond au num&eacute;ro du DB.
Note : Assurez-vous d’utiliser la fonction Enregistrer sous, sinon le fichier sera nomm&eacute; DB2.tia.txt et ne sera
pas visible depuis le pilote d’importation.
10. R&eacute;p&eacute;tez &agrave; partir de l'&eacute;tape 5 pour tous les blocs de programme.
Note : Assurez-vous que seules les colonnes suivantes sont affich&eacute;es dans l'&eacute;diteur DB avant de copier toutes
les donn&eacute;es dans le fichier txt
Exporter des fichiers .xlsx
Un fichier Excel fait r&eacute;f&eacute;rence &agrave; 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 | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
2. Cliquez sur le bouton Exporter et indiquez un chemin d’acc&egrave;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 | &copy; 2012-2017 DEIF A/S
727
Simatic S7 ETH
Exporter des fichiers .scl ou udt
Pour g&eacute;n&eacute;rer le fichier, agrandissez l'&eacute;l&eacute;ment Type de donn&eacute;es API de l’arborescence du projet du portail TIA et faites un
clic droit sur la structure d&eacute;finie par l’utilisateur. Cliquez ensuite sur G&eacute;n&eacute;rer un fichier source &agrave; partir des blocs.
728
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
En cas de multiples UDT d&eacute;finis dans le projet de l’API, vous devez tous les s&eacute;lectionner dans la liste Type de donn&eacute;es
API, faire un clic droit et s&eacute;lectionner G&eacute;n&eacute;rer un fichier source &agrave; partir des blocs pour cr&eacute;er le fichier .scl contenant
touts les UDT d&eacute;finis.
&Agrave; l'&eacute;tape suivante, donnez un nom au fichier .scl et indiquez un chemin d’acc&egrave;s o&ugrave; l’enregistrer.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
729
Simatic S7 ETH
Le fichier contiendra tous les UDT d&eacute;finis, et vous pourrez l’utiliser pour importer des variables dans l’&eacute;diteur.
Consultez le chapitre Importation de variables pour plus d'informations.
Param&egrave;tres de l’&eacute;diteur de variables
Dans l'&eacute;diteur de variables, s&eacute;lectionnez &laquo; Simatic S7 ETH &raquo; dans la liste des protocoles d&eacute;finis, puis cliquez sur + pour
ajouter une variable.
730
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Type de
m&eacute;moir
e
Zone de l’API o&ugrave; se situe la variable.
Type de donn&eacute;es
Type Simatic
M&eacute;moire interne
M
Bloc de donn&eacute;es
DB
Entr&eacute;e
I (E)
Sortie
O (A)
Valeur de minuterie
T
Contre-valeur
C
Offset
Adresse d’offset o&ugrave; se situe la variable.
Sousin
dex
Offset de ressource au sein du registre.
Bloc de
donn&eacute;e
s
Num&eacute;ro de bloc de donn&eacute;es pour le type de m&eacute;moire de bloc de donn&eacute;es.
Type de
donn&eacute;e
s
Types de donn&eacute;es disponibles :
l
boolean
l
octet
l
short
l
int
l
unsignedByte
l
unsignedShort
l
unsignedInt
l
float
l
string
Consultez la section &laquo; Concepts de programmation &raquo; du manuel principal.
Note : Pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de donn&eacute;es
suivi de crochets.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
731
Simatic S7 ETH
&Eacute;l&eacute;ment Description
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt;
CDAB
732
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S5Timer(BCD)
Utilis&eacute; pour prendre en charge S5Timer. Pour plus d'informations, consultez
la section Type de donn&eacute;es Simatic S5Timer.
S5Timer(BIN)
Transformation h&eacute;rit&eacute;e de S5Timer au format binaire.
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
Ajouter un nom d’alias &agrave; un protocole
Les noms de variables doivent &ecirc;tre uniques au niveau d’un projet. Vous pouvez cependant &ecirc;tre amen&eacute; &agrave; utiliser les m&ecirc;mes
noms de variables pour diff&eacute;rents nœuds de contr&ocirc;leur (par exemple lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; deux
p&eacute;riph&eacute;riques ex&eacute;cutant la m&ecirc;me application).
Lorsque vous g&eacute;n&eacute;rez un protocole, vous pouvez ajouter un nom d’alias qui s’ajoutera aux noms de variables import&eacute;s pour
ce protocole.
Dans l’exemple, la connexion &agrave; un certain contr&ocirc;leur porte le nom Nœud1. Lorsque vous importez les variables pour ce
nœud, tous les noms de variables porteront le pr&eacute;fixe Nœud1, les rendant ainsi uniques au niveau projet/r&eacute;seau.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
733
Simatic S7 ETH
Note : Vous pouvez donner un nom d’alias uniquement aux variables import&eacute;es. Il n’est pas n&eacute;cessaire pour les
variables ajout&eacute;es manuellement dans l'&eacute;diteur de variables de porter un pr&eacute;fixe d’alias dans leur nom.
Vous associez la cha&icirc;ne d’alias &agrave; l’importation. Une fois l’importation des variables effectu&eacute;e, une modification
de la cha&icirc;ne d’alias n’aura aucun effet sur les noms figurant d&eacute;j&agrave; dans le dictionnaire. Lorsque vous modifiez la
cha&icirc;ne d’alias et r&eacute;importez les variables, toutes les variables r&eacute;import&eacute;es porteront la nouvelle cha&icirc;ne de
pr&eacute;fixe.
Type de donn&eacute;es cha&icirc;ne
Dans l’API Simatic S7, deux diff&eacute;rents types de variables g&egrave;rent les variables cha&icirc;ne :
l
sous forme de tableau [1..xx] de caract&egrave;res,
l
sous forme de cha&icirc;ne[xx].
L’exemple suivant pr&eacute;sente la d&eacute;claration de cha&icirc;ne sous Step7 :
L’exemple suivant pr&eacute;sente la d&eacute;claration de cha&icirc;ne sous le portail TIA :
734
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Note : Lorsque vous utilisez le type de donn&eacute;es cha&icirc;ne[xx], vous devez appliquer une conversion sp&eacute;cifique &agrave; 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&icirc;ne est automatique et aucune autre action ne vous sera
demand&eacute;e.
Pour ajouter une cha&icirc;ne sous forme de tableau de caract&egrave;res :
1. Appuyez sur + dans l'&eacute;diteur de variables.
2. Dans Type de donn&eacute;es, s&eacute;lectionnez cha&icirc;ne.
3. Dans Taille de tableau, entrez la longueur de cha&icirc;ne.
4. Cliquez sur OK pour confirmer.
Pour ajouter un type de donn&eacute;es cha&icirc;ne :
1. Appuyez sur + dans l'&eacute;diteur de variables.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
735
Simatic S7 ETH
2. Dans Type de donn&eacute;es, s&eacute;lectionnez cha&icirc;ne.
3. Dans Taille de tableau, entrez la longueur de cha&icirc;ne.
4. Cliquez sur +/- pour ouvrir la bo&icirc;te de dialogue Conversion.
5. Dans cette bo&icirc;te de dialogue, s&eacute;lectionnez le type de conversion Cha&icirc;ne S7.
736
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
6. Cliquez sur + pour ajouter la conversion, qui s’affiche alors dans la liste Configur&eacute;e sur la droite.
7. Cliquez sur OK pour confirmer.
Type de donn&eacute;es Simatic S5Timer
Les pilotes Simatic prennent en charge un type de donn&eacute;es sp&eacute;cial : S5Timer.
Vous devez configurer la variable avec un type de donn&eacute;es sp&eacute;cifique et appliquer une conversion &agrave; cette variable afin de
pouvoir lire/&eacute;crire correctement une variable Simatic S5Timer.
1. Dans l’&eacute;diteur de variables, cliquez sur + pour ajouter une variable.
2. Dans Type de donn&eacute;es, s&eacute;lectionnez unsignedInt.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
737
Simatic S7 ETH
3. Cliquez sur +/- pour ouvrir la bo&icirc;te de dialogue Conversion.
4. Dans cette bo&icirc;te de dialogue, s&eacute;lectionnez le type de conversion S5timer(BCD).
5. Cliquez sur + pour ajouter la conversion, qui s’affiche alors dans la liste Configur&eacute;e sur la droite.
738
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
6. Cliquez sur OK pour confirmer.
IP d'&eacute;crasement de nœud
Le protocole propose le type de donn&eacute;es sp&eacute;cial IP d’&eacute;crasement de nœud, qui vous permet de modifier l’adresse IP du
contr&ocirc;leur cible au moment du runtime.
Ce type de m&eacute;moire est un tableau de 4 octets non sign&eacute;s, un pour chaque octet de l’adresse IP.
L’IP d'&eacute;crasement de nœud est initialis&eacute;e avec la valeur de l’IP du contr&ocirc;leur sp&eacute;cifi&eacute;e dans le projet au moment de la
programmation.
IP d'&eacute;crasement de
nœud
Op&eacute;ration Modbus
0.0.0.0
La communication avec le contr&ocirc;leur est coup&eacute;e, plus aucune trame de requ&ecirc;te ne
sera g&eacute;n&eacute;r&eacute;e.
Autre que 0.0.0.0
Interpr&eacute;t&eacute;e comme &eacute;tant l’&eacute;crasement de l’IP de nœud, et remplace l’adresse IP
cible au moment du runtime.
Lorsque le p&eacute;riph&eacute;rique IHM est connect&eacute; &agrave; un r&eacute;seau avec plus d’un nœud de contr&ocirc;leur, chaque nœud dispose de sa
propre variable d’IP d'&eacute;crasement de nœud.
Note : Le maintien des valeurs de l’IP d'&eacute;crasement de nœud assign&eacute;es au moment du runtime est assur&eacute; par
des cycles d’alimentation.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
739
Simatic S7 ETH
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
La bo&icirc;te de dialogue suivante affiche le type de pilote d’importation que vous pouvez s&eacute;lectionner.
740
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Pilote d'importation
Description
Step7 v1.0
Lin&eacute;aire
N&eacute;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&ecirc;me niveau.
Portail TIA v1.0
Lin&eacute;aire
N&eacute;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&ecirc;me niveau.
Fichier .xml export&eacute; de
l'&eacute;diteur de variables
S&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique
export&eacute; de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
741
Simatic S7 ETH
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
&Eacute;tat de communication
Vous pouvez afficher l'&eacute;tat de communication actuel gr&acirc;ce aux variables syst&egrave;me. Voir la section &laquo; Variables syst&egrave;me &raquo;
du manuel principal.
Codes pris en charge par ce pilote de communication :
Erreur
Cause
Action
NAK
Le contr&ocirc;leur r&eacute;pond &laquo; Ne pas confirmer &raquo;.
-
D&eacute;lai
d'attente
La requ&ecirc;te n’a obtenu aucune r&eacute;ponse dans
le d&eacute;lai d’attente sp&eacute;cifi&eacute;.
V&eacute;rifiez que le contr&ocirc;leur est connect&eacute; et correctement
configur&eacute; pour acc&eacute;der au r&eacute;seau.
742
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
Erreur
Cause
Action
R&eacute;ponse
non valide
Le contr&ocirc;leur a envoy&eacute; une r&eacute;ponse ou un
contenu non valide au p&eacute;riph&eacute;rique.
V&eacute;rifiez la coh&eacute;rence entre les donn&eacute;es programm&eacute;es
dans le projet et les ressources du contr&ocirc;leur.
Erreur
g&eacute;n&eacute;rale
Erreur non identifiable. Ne doit jamais &ecirc;tre
signal&eacute;e.
Contactez l’assistance technique.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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
&quot;PLC Network&quot; 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 | &copy; 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, &quot;OB1&quot; 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 | &copy; 2012-2017 DEIF A/S
747
Simatic S7 MPI
1. Assign a name, &quot;Sources&quot; in the example, and click OK: the Generate source Sources dialog is displayed.
2. Click All &gt; 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 &quot;Sources&quot; object is generated in the Step7 project as in the example.
748
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 &quot;instance DB&quot; linked to an &quot;optimized access FB&quot;.
4. Build the project to make sure TIA Portal calculates the tags offset.
752
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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 | &copy; 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&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;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 | &copy; 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 -&gt; BA
Swap nibbles of a byte.
Example:
15D4 → 514D (in hexadecimal format)
5588 → 20813 (in decimal format)
ABCD -&gt; CDAB
Swap bytes of a word.
Example:
9ACC → CC9A (in hexadecimal format)
39628 → 52378 (in decimal format)
ABCDEFGH -&gt;
GHEFCDAB
Swap bytes of a double word.
ABC...NOP -&gt;
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 | &copy; 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 | &copy; 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 &quot;Array [1..xx] of Chars&quot; data type tag, press the [+] button in the Tag Editor, then select &quot;string&quot; as
Data Type of the Tag and type the string length in the &quot;Arraysize&quot; field:
762
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
and confirm with OK button.
To manually add a &quot;String[xx]&quot; data type tag, press the [+] button in the Tag Editor, then select &quot;string&quot; as Data Type of the
Tag and type the string length in the &quot;Arraysize&quot; field,
then click on [+/-] button to open the Conversion dialog.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
763
Simatic S7 MPI
Into conversion dialog:
l
select the &quot;S7 String&quot; 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 | &copy; 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 | &copy; 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&eacute;lectionnez le pilote dans l'&eacute;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 | &copy; 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&eacute;lectionnez ce pilote d’importation pour lire un fichier XML g&eacute;n&eacute;rique export&eacute;
de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
767
Simatic S7 MPI
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
768
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;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 | &copy; 2012-2017 DEIF A/S
769
Variables
Variables
Le pilote de communication de variables permet de d&eacute;finir des variables qui pointe vers la m&eacute;moire interne IHM.
Les Variables ne sont pas r&eacute;tentrices : lorsque le projet d&eacute;marre, la valeur de d&eacute;part de toutes les variables Tag est 0 (ou &quot;&quot;
en cas de variable de cha&icirc;ne).
Le pilote de communication de variables n’est pas compt&eacute; comme protocole physique.
Se r&eacute;f&eacute;rer au Tableau des fonctions et limites de manuel principal dans la ligne &laquo; Nombre de protocoles
physiques &raquo;.
Param&egrave;tres de l’&eacute;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&icirc;t.
3. S&eacute;lectionnez le protocole Variables dans la liste API.
Param&egrave;tres de l’&eacute;diteur de variables
Chemin : VueProjet&gt; Configuration &gt; double-cliquez sur variables
1. Pour ajouter une variable, cliquez sur + : une nouvelle ligne appara&icirc;t.
2. S&eacute;lectionnez Variables dans la liste des protocoles : le dialogue de d&eacute;finition de variables s'affiche.
770
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Type de
donn&eacute;e
s
Type de donn&eacute;es
Espace m&eacute;moire
Limites
boolean
Donn&eacute;e &agrave; 1 bite
0 ... 1
octet
Donn&eacute;e &agrave; 8 bite
-128 ... 127
short
Donn&eacute;e &agrave; 16 bite
-32768 ... 32767
int
Donn&eacute;e &agrave; 32 bite
-2.1e9 ... 2.1e9
int64
Donn&eacute;e &agrave; 64 bite
-9.2e18 ... 9.2e18
unsignedByte
Donn&eacute;e &agrave; 8 bite
0 ... 255
unsignedShort
Donn&eacute;e &agrave; 16 bite
0 ... 65535
unsignedInt
Donn&eacute;e &agrave; 32 bite
0 ... 4.2e9
uint64
Donn&eacute;e &agrave; 64 bite
0 ... 1.8e19
float
Type virgule flottante de 32 bits simple
pr&eacute;cision conforme IEEE
1.17e-38 ... 3.4e38
double
Type virgule flottante de 64 bits double
pr&eacute;cision conforme IEEE
2.2e-308 ... 1.79e308
string
Tableau des &eacute;l&eacute;ments contenant du code de caract&egrave;res d&eacute;fini
par l'encodage s&eacute;lectionn&eacute;
binary
Donn&eacute;es binaires arbitraires
Remarque : pour d&eacute;finir des tableaux, s&eacute;lectionnez l’un des formats de type de
donn&eacute;es suivi de crochets tels que &laquo; byte[] &raquo;, &laquo; short[] &raquo;, etc.
Taille
de
tableau
l
l
En cas de variable vectorielle, cette propri&eacute;t&eacute; repr&eacute;sente le nombre d’&eacute;l&eacute;ments vectoriels.
En cas de variable de cha&icirc;ne, cette propri&eacute;t&eacute; repr&eacute;sente le nombre maximum d’octets
disponible pour la variable de cha&icirc;ne.
Remarque : le nombre d'octets correspond au nombre de caract&egrave;res de cha&icirc;ne si la propri&eacute;t&eacute;
Encoding est r&eacute;gl&eacute;e sur UTF-8 ou Latin1 dans Tag Editor.
Si la propri&eacute;t&eacute; Encoding est r&eacute;gl&eacute;e sur UCS-2BE, UCS-2LE, UTF-16BE ou UTF-16LE, un
caract&egrave;re n&eacute;cessite 2 octets.
Conver
sion
Conversion &agrave; appliquer &agrave; la variable.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
771
Variables
&Eacute;l&eacute;ment Description
En fonction du type de donn&eacute;es choisi, la liste Autoris&eacute;e affiche une ou plusieurs conversions,
list&eacute;es ci-dessous.
Valeur
Description
Inv bits
Inverse tous les bits de la variable.
Exemple :
1001 → 0110 (format binaire)
9 → 6 (format d&eacute;cimal)
Inverser
Inverse la valeur de la variable.
Exemple :
25.36 → -25.36
AB -&gt; BA
&Eacute;change les quartets d’un octet.
Exemple :
15D4 → 514D (format hexad&eacute;cimal)
5588 → 20813 (format d&eacute;cimal)
ABCD -&gt; CDAB
&Eacute;change les octets d’un mot.
Exemple :
9ACC → CC9A (format hexad&eacute;cimal)
39628 → 52378 (format d&eacute;cimal)
772
ABCDEFGH -&gt;
GHEFCDAB
&Eacute;change les octets d'un mot double.
ABC...NOP -&gt;
OPM...DAB
&Eacute;change les octets d’un mot long.
Exemple :
32FCFF54 → 54FFFC32 (format hexad&eacute;cimal)
855441236 → 1426062386 (format d&eacute;cimal)
Exemple :
142,366 → -893553517,588905 (format d&eacute;cimal)
0 10000000110
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment Description
Valeur
Description
0001110010111011011001000101101000011100101011000001
→
1 10000011100
1010101000010100010110110110110010110110000100111101
(format binaire)
BCD
S&eacute;pare l’octet en deux quartets et les lit au format d&eacute;cimal (de 0 &agrave; 9)
Exemple :
23 → 17 (format d&eacute;cimal)
0001 0111 = 23
0001 = 1 (premier quartet)
0111 = 7 (second quartet)
S&eacute;lectionnez la conversion et cliquez sur le bouton plus. La conversion s&eacute;lectionn&eacute;e s’affiche
dans la liste Configur&eacute;e.
Si vous configurez d’autres conversions, celles-ci s’affichent dans l’ordre (du haut vers le bas de
la liste Configur&eacute;e).
Utilisez les boutons de direction pour changer l’ordre des conversions configur&eacute;es.
Importation des variables
S&eacute;lectionnez le pilote dans l'&eacute;diteur de variables et cliquez sur le bouton Importer variables pour lancer le pilote
d’importation.
Le syst&egrave;me aura besoin d’un fichier XML g&eacute;n&eacute;rique export&eacute; de l'&eacute;diteur de variables avec le bouton appropri&eacute;.
Lorsque vous avez s&eacute;lectionn&eacute; le pilote d’importation, localisez le fichier de symboles et cliquez sur Ouvrir.
Les variables comprises dans le fichier de symboles sont list&eacute;es dans le dictionnaire de variables. Le dictionnaire de
variables s’affiche en bas de l’&eacute;cran.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
773
Variables
&Eacute;l&eacute;ment de la barre d’outils
Description
Importer variables.
S&eacute;lectionnez les variables &agrave; importer et cliquez sur cette
ic&ocirc;ne pour ajouter les variables du dictionnaire au projet.
Mettre &agrave; jour variables.
Cliquez sur cette ic&ocirc;ne pour mettre &agrave; jour les variables du
projet gr&acirc;ce &agrave; un nouvel import du dictionnaire.
Cochez cette case pour importer tous les sous-&eacute;l&eacute;ments
d’une variable.
Exemples de r&eacute;sultats avec la case coch&eacute;e et non coch&eacute;e :
774
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
49 Protocoles de communication
&Eacute;l&eacute;ment de la barre d’outils
Description
Recherche des variables dans le dictionnaire en filtrant en
fonction de l'&eacute;l&eacute;ment s&eacute;lectionn&eacute; dans la liste d&eacute;roulante.
AGI Creator | Manuel Utilisateur | v206 (2017-03-01) | FR | &copy; 2012-2017 DEIF A/S
775
AGI 400 | Deif AGI 300 Advanced graphical interface Manuel utilisateur

Manuels associés

Deif

AGI 400

Schneider Electric

Alimentation et mise à la terre des équipements

Deif

AGI 300

Skov

Replacement of panel complete

Deif

MTR-4P

NiceLabel

6

ABB

WattStationTM sur socle de GE Chargeur d'EVSE

Schneider Electric

ATV58 CANopen VW3A58308

Schneider Electric

Twin Line

Datapath

Aetria Designer

TRIMBLE

Farm Works Information Management

Deif

GC-1
