Schneider Electric SoMachine - Fonctions et bibliothèques Manuel utilisateur

SoMachine
EIO0000000792 06/2017
SoMachine
Fonctions et bibliothèques - Guide de
l'utilisateur
EIO0000000792.13
06/2017
www.schneider-electric.com
Le présent document comprend des descriptions générales et/ou des caractéristiques techniques
des produits mentionnés. Il ne peut pas être utilisé pour définir ou déterminer l'adéquation ou la
fiabilité de ces produits pour des applications utilisateur spécifiques. Il incombe à chaque utilisateur
ou intégrateur de réaliser l'analyse de risques complète et appropriée, l'évaluation et le test des
produits pour ce qui est de l'application à utiliser et de l'exécution de cette application. Ni la société
Schneider Electric ni aucune de ses sociétés affiliées ou filiales ne peuvent être tenues pour
responsables de la mauvaise utilisation des informations contenues dans le présent document. Si
vous avez des suggestions, des améliorations ou des corrections à apporter à cette publication,
veuillez nous en informer.
Aucune partie de ce document ne peut être reproduite sous quelque forme ou par quelque moyen
que ce soit, électronique, mécanique ou photocopie, sans autorisation préalable de Schneider
Electric.
Toutes les réglementations de sécurité pertinentes locales doivent être observées lors de
l'installation et de l'utilisation de ce produit. Pour des raisons de sécurité et afin de garantir la
conformité aux données système documentées, seul le fabricant est habilité à effectuer des
réparations sur les composants.
Lorsque des équipements sont utilisés pour des applications présentant des exigences techniques
de sécurité, suivez les instructions appropriées.
La non-utilisation du logiciel Schneider Electric ou d'un logiciel approuvé avec nos produits
matériels peut entraîner des blessures, des dommages ou un fonctionnement incorrect.
Le non-respect de cette consigne peut entraîner des lésions corporelles ou des dommages
matériels.
© 2017 Schneider Electric. Tous droits réservés.
2
EIO0000000792 06/2017
Table des matières
Consignes de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . .
A propos de ce manuel. . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 1 Description générale des bibliothèques . . . . . . . . . . . . .
Informations générales sur les bibliothèques . . . . . . . . . . . . . . . . . . .
Chapitre 2 Gestion des bibliothèques . . . . . . . . . . . . . . . . . . . . . . .
2.1 Méthodes de référencement des bibliothèques. . . . . . . . . . . . . . . . . .
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Version directe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Version la plus récente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mécanisme d'espace réservé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bibliothèques post-compatibles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Utilisation des bibliothèques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Méthodes de déclaration d'une bibliothèque dans un projet . . . . . . .
Ajout de bibliothèques dans un projet SoMachine . . . . . . . . . . . . . . .
Mise à jour de bibliothèques et de références de bibliothèque . . . . . .
Création d'une bibliothèque post-compatible personnalisée . . . . . . . .
Chapitre 3 Éditeur du Gestionnaire de bibliothèque. . . . . . . . . . . . .
Éditeur du Gestionnaire de bibliothèque . . . . . . . . . . . . . . . . . . . . . . .
Ajouter une bibliothèque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Charger à nouveau une bibliothèque . . . . . . . . . . . . . . . . . . . . . . . . .
Espaces réservés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Référentiel de bibliothèque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Onglet Mappage de version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 4 Créer une bibliothèque . . . . . . . . . . . . . . . . . . . . . . . . . .
Informations générales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Étape 1 : Définir le projet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Étape 2 : Remplir les Informations de projet . . . . . . . . . . . . . . . . . . . .
Étape 3 : Référencer d'autres bibliothèques si besoin . . . . . . . . . . . .
Étape 3.1 : Utiliser des références d'espaces réservés. . . . . . . . . . . .
Étape 4 : Concevoir et programmer les modules de bibliothèque . . . .
Étape 5 : Concevoir l'interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Étape 6 : Mettre en place des routines de gestion d'erreurs . . . . . . . .
Étape 7 : Configurer un déploiement raisonnable (restriction
d'utilisation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EIO0000000792 06/2017
5
7
11
11
15
16
17
18
19
21
23
25
26
26
28
32
35
36
40
44
46
47
48
56
59
60
60
61
64
65
65
66
66
67
3
Chapitre 5 Présentation des bibliothèques . . . . . . . . . . . . . . . . . . . .
Bibliothèques Schneider Electric . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Autres bibliothèques utilisées dans SoMachine. . . . . . . . . . . . . . . . . .
Chapitre 6 Représentation des fonctions et blocs fonction . . . . . . . .
Différences entre une fonction et un bloc fonction . . . . . . . . . . . . . . . .
Utilisation d'une fonction ou d'un bloc fonction en langage IL . . . . . . .
Utilisation d'une fonction ou d'un bloc fonction en langage ST . . . . . .
Glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
69
70
93
97
98
99
103
105
111
EIO0000000792 06/2017
Consignes de sécurité
Informations importantes
AVIS
Lisez attentivement ces instructions et examinez le matériel pour vous familiariser avec l'appareil
avant de tenter de l'installer, de le faire fonctionner, de le réparer ou d'assurer sa maintenance.
Les messages spéciaux suivants que vous trouverez dans cette documentation ou sur l'appareil
ont pour but de vous mettre en garde contre des risques potentiels ou d'attirer votre attention sur
des informations qui clarifient ou simplifient une procédure.
EIO0000000792 06/2017
5
REMARQUE IMPORTANTE
L'installation, l'utilisation, la réparation et la maintenance des équipements électriques doivent être
assurées par du personnel qualifié uniquement. Schneider Electric décline toute responsabilité
quant aux conséquences de l'utilisation de ce matériel.
Une personne qualifiée est une personne disposant de compétences et de connaissances dans le
domaine de la construction, du fonctionnement et de l'installation des équipements électriques, et
ayant suivi une formation en sécurité leur permettant d'identifier et d'éviter les risques encourus.
6
EIO0000000792 06/2017
A propos de ce manuel
Présentation
Objectif du document
Ce document décrit l'implémentation des bibliothèques, de la gestion de bibliothèques et des
fonctions dans SoMachine.
Champ d'application
Ce document a été actualisé pour le lancement de SoMachine V4.3.
Information spécifique au produit
AVERTISSEMENT
PERTE DE CONTROLE





Le concepteur d'un système de commande doit envisager les modes de défaillance possibles
des chemins de commande et, pour certaines fonctions de commande critiques, prévoir un
moyen d'atteindre un état sécurisé en cas de défaillance d'un chemin, et après cette
défaillance. Par exemple, l'arrêt d'urgence, l'arrêt en cas de surcourse, la coupure de courant
et le redémarrage sont des fonctions de commande cruciales.
Des canaux de commande séparés ou redondants doivent être prévus pour les fonctions de
commande critiques.
Les chemins de commande système peuvent inclure les liaisons de communication. Soyez
particulièrement attentif aux implications des retards de transmission imprévus ou des pannes
de liaison.
Respectez toutes les réglementations de prévention des accidents ainsi que les consignes de
sécurité locales.1
Chaque implémentation de cet équipement doit être testée individuellement et entièrement
pour s'assurer du fonctionnement correct avant la mise en service.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
1
Pour plus d'informations, consultez le document NEMA ICS 1.1 (dernière édition), « Safety
Guidelines for the Application, Installation, and Maintenance of Solid State Control » (Directives de
sécurité pour l'application, l'installation et la maintenance de commande statique) et le document
NEMA ICS 7.1 (dernière édition), « Safety Standards for Construction and Guide for Selection,
Installation, and Operation of Adjustable-Speed Drive Systems » (Normes de sécurité relatives à
la construction et manuel de sélection, installation et opération de variateurs de vitesse) ou son
équivalent en vigueur dans votre pays.
EIO0000000792 06/2017
7
AVERTISSEMENT
FONCTIONNEMENT IMPREVU DE L’EQUIPEMENT


N'utilisez que le logiciel approuvé par Schneider Electric pour faire fonctionner cet
équipement.
Mettez à jour votre programme d'application chaque fois que vous modifiez la configuration
matérielle physique.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
Terminologie utilisée dans les normes
Les termes techniques, la terminologie, les symboles et les descriptions correspondantes
employés dans ce manuel ou figurant dans ou sur les produits proviennent généralement des
normes internationales.
Dans les domaines des systèmes de sécurité fonctionnelle, des variateurs et de l'automatisme en
général, les termes employés sont sécurité, fonction de sécurité, état sécurisé, défaut, réinitialisation du défaut, dysfonctionnement, panne, erreur, message d'erreur, dangereux, etc.
Entre autres, les normes concernées sont les suivantes :
8
Norme
Description
EN 61131-2:2007
Automates programmables - Partie 2 : exigences et essais des équipements
ISO 13849-1:2008
Sécurité des machines - Parties des systèmes de commande relatives à la
sécurité Principes généraux de conception
EN 61496-1:2013
Sécurité des machines - Équipements de protection électro-sensibles Partie 1 : prescriptions générales et essais
ISO 12100:2010
Sécurité des machines - Principes généraux de conception - Appréciation du
risque et réduction du risque
EN 60204-1:2006
Sécurité des machines - Équipement électrique des machines - Partie 1 : règles
générales
EN 1088:2008
ISO 14119:2013
Sécurité des machines - Dispositifs de verrouillage associés à des protecteurs
- Principes de conception et de choix
ISO 13850:2006
Sécurité des machines - Fonction d'arrêt d'urgence - Principes de conception
EN/IEC 62061:2005
Sécurité des machines - Sécurité fonctionnelle des systèmes de commande
électrique, électronique et électronique programmable relatifs à la sécurité
IEC 61508-1:2010
Sécurité fonctionnelle des systèmes électriques/électroniques/électroniques
programmables relatifs à la sécurité - Exigences générales
IEC 61508-2:2010
Sécurité fonctionnelle des systèmes électriques/électroniques/électroniques
programmables relatifs à la sécurité - Exigences pour les systèmes
électriques/électroniques/électroniques programmables relatifs à la sécurité
EIO0000000792 06/2017
Norme
Description
IEC 61508-3:2010
Sécurité fonctionnelle des systèmes électriques/électroniques/électroniques
programmables relatifs à la sécurité - Exigences concernant les logiciels
IEC 61784-3:2008
Communications numériques pour les systèmes de mesure et de commande Bus de terrain de sécurité fonctionnelle
2006/42/EC
Directive Machines
2014/30/EU
Directive sur la compatibilité électromagnétique
2014/35/EU
Directive sur les basses tensions
De plus, des termes peuvent être utilisés dans le présent document car ils proviennent d'autres
normes telles que :
Norme
Description
Série IEC 60034
Machines électriques rotatives
Série IEC 61800
Entraînements électriques de puissance à vitesse variable
Série IEC 61158
Communications numériques pour les systèmes de mesure et de commande Bus de terrain utilisés dans les systèmes de commande industriels
Enfin, le terme zone de fonctionnement utilisé dans le contexte de la description de dangers
spécifiques a la même signification que les termes zone dangereuse ou zone de danger employés
dans la directive Machines (2006/42/EC) et la norme ISO 12100:2010.
NOTE : Les normes susmentionnées peuvent s'appliquer ou pas aux produits cités dans la
présente documentation. Pour plus d'informations sur chacune des normes applicables aux
produits décrits dans le présent document, consultez les tableaux de caractéristiques de ces
références de produit.
EIO0000000792 06/2017
9
10
EIO0000000792 06/2017
SoMachine
Description générale des bibliothèques
EIO0000000792 06/2017
Chapitre 1
Description générale des bibliothèques
Description générale des bibliothèques
Informations générales sur les bibliothèques
Contenu des bibliothèques
Les bibliothèques fournissent les éléments suivants, exécutés dans le système d'exécution de
votre contrôleur :
 fonctions et blocs fonction,
 définitions des types de données,
 variables globales,
 variables système,
 objets de visualisation.
La gestion des bibliothèques dans un projet s'effectue à l'aide des Gestionnaires de bibliothèques
pour la totalité du projet ou par contrôleur. Les bibliothèques sont installées en même temps que
les éléments (équipements, solutions et contrôleurs) que vous avez décidé d'installer avec
Gestionnaire de configuration SoMachine. Quant aux bibliothèques définies par l'utilisateur, c'est
vous qui les gérez directement via SoMachine.
Informations sur les bibliothèques
Le Gestionnaire de bibliothèques contient les bibliothèques incluses, tandis que le Référentiel de
bibliothèques contient l'ensemble des bibliothèques disponibles :
Informations
Description
Exemple
Nom
nom de la bibliothèque
Bibliothèque Altivar
(ATV)
Version
version de la bibliothèque
1.0.1.8
Société
Fournisseur principal (ou nom de groupe défini par le fournisseur
principal de la bibliothèque) indiqué dans les boîtes de dialogue
Gestionnaire de bibliothèques et Référentiel de bibliothèques.
Schneider Electric
Espace de noms
Espace de noms par défaut de la bibliothèque, permettatn
d'accéder aux fonctions de la bibliothèque.
SEC
NOTE : La bonne pratique consiste à utiliser systématiquement
l'espace de noms par défaut dans votre application.
Si l'attribut qualified-access-only figure après l'espace de noms par
défaut, cela signifie que l'utilisation de cet espace de noms dans
votre application est obligatoire.
EIO0000000792 06/2017
11
Description générale des bibliothèques
Informations
Description
Exemple
Catégorie
Catégorie(s) à laquelle ou auxquelles ces bibliothèques
appartiennent, comme indiqué dans les boîtes de dialogue
Gestionnaire de bibliothèques et Référentiel de bibliothèques.
Equipements →
ATV31/ATV312
Espace de noms
Un espace de nom de bibliothèque est un symbole qui permet un accès unique aux composants
de bibliothèque associés (fonctions, blocs fonction, variables, etc.). Il est nécessaire lorsque
deux composants de deux bibliothèques différentes portent un nom identique au sein d'un même
projet. Son utilisation dans votre application est obligatoire si l'attribut qualified-access-only est
défini dans la bibliothèque. Pour garantir l'accès unique au composant approprié, utilisez le nom
complet <espace de nom>.<composant>, en prenant soin d'inclure l'espace de nom.
Cas
Description
1
La bibliothèque Util comprend un bloc fonction GEN. L'espace de nom de la bibliothèque Util
est Util. Une instance du bloc fonction GEN peut être déclarée avec ou sans espace de nom de
bibliothèque si le nom GEN est unique au sein du projet :
MyGenerator: Util.GEN;
ou MyGenerator: GEN;
2
Un bloc fonction GEN a été créé au sein du projet. L'utilisation de l'espace de nom Util permettra
au système d'accéder au bloc fonction GEN de l'espace de nom Util. Sans espace de nom, le
bloc fonction du projet GEN sera utilisé
MyGenerator_Util: Util.GEN;
MyGenerator_Project: GEN;
3
Une autre bibliothèque, qui contient aussi un bloc fonction appelé GEN, est déclarée dans le
projet avec l'espace de nom NewLib. L'utilisation de l'espace de nom devient obligatoire pour
identifier le bloc fonction correct GEN à utiliser :
MyGenerator_Util: Util.GEN;
MyGenerato_NewLib: NewLib.GEN;
Un espace de nom par défaut est défini pour chaque bibliothèque.
Référentiel de bibliothèques
Le Référentiel de bibliothèques est l'éditeur qui gère les bibliothèques installées dans SoMachine.
Le Référentiel de bibliothèques permet d'installer ou de supprimer des bibliothèques définies par
l'utilisateur. Une bibliothèque peut être utilisée dans un projet SoMachine uniquement si elle est
installée dans le Référentiel de bibliothèques. Un jeu de bibliothèques est installé par défaut avec
SoMachine. Gestionnaire de configuration SoMachine vous permet cependant d'installer de
nouvelles bibliothèques ou de nouvelles versions de bibliothèques existantes.
12
EIO0000000792 06/2017
Description générale des bibliothèques
Gestion des bibliothèques à l'aide des Gestionnaires de bibliothèques
Les bibliothèques déclarées dans un projet sont gérées dans l'éditeur Gestionnaire de
bibliothèques.
Dans un projet SoMachine, l'arborescence Outils (voir SoMachine, Guide de programmation)
comprend deux Gestionnaires de bibliothèques couvrant différents cas d'utilisation :
Cas d'utilisation
Emplacement du Gestionnaire de bibliothèques
bibliothèques
disponibles pour un
contrôleur spécifique
Dans l'arborescence Outils ci-dessous, le nœud Application de chaque
contrôleur.
bibliothèques
disponibles pour un
projet
Dans l'arborescence Outils, sous Global, ajoutez un Gestionnaire de
bibliothèques.
Pour plus d'informations sur la gestion des bibliothèques, le Référentiel de bibliothèques et
l'éditeur Gestionnaire de bibliothèques, consultez le chapitre Gestion des bibliothèques
(voir page 35).
Pour savoir comment rechercher une fonction ou un bloc fonction de bibliothèques à l'aide de FFB
Finder, consultez la section Comment trouver une fonction ou un bloc fonction avec FFB Finder
(voir SoMachine, Guide de programmation).
EIO0000000792 06/2017
13
Description générale des bibliothèques
14
EIO0000000792 06/2017
SoMachine
Gestion des bibliothèques
EIO0000000792 06/2017
Chapitre 2
Gestion des bibliothèques
Gestion des bibliothèques
Présentation
Ce chapitre vous explique comment gérer les bibliothèques et les versions des bibliothèques
référencées.
Contenu de ce chapitre
Ce chapitre contient les sous-chapitres suivants :
Sous-chapitre
Sujet
Page
2.1
Méthodes de référencement des bibliothèques
16
2.2
Utilisation des bibliothèques
25
EIO0000000792 06/2017
15
Gestion des bibliothèques
Sous-chapitre 2.1
Méthodes de référencement des bibliothèques
Méthodes de référencement des bibliothèques
Présentation
Cette section fournit des informations générales concernant les méthodes de référencement des
bibliothèques. Elle présente également les avantages et les inconvénients de chacune, ainsi que
leur utilisation dans SoMachine.
Contenu de ce sous-chapitre
Ce sous-chapitre contient les sujets suivants :
Sujet
16
Page
Introduction
17
Version directe
18
Version la plus récente
19
Mécanisme d'espace réservé
21
Bibliothèques post-compatibles
23
EIO0000000792 06/2017
Gestion des bibliothèques
Introduction
Présentation
Il est possible d'utiliser, au sein de projets et de bibliothèques, des fonctionnalités externes
stockées dans des bibliothèques distinctes. Pour ce faire, ces dernières doivent figurer dans le
Gestionnaire de bibliothèques du projet en tant que bibliothèques référencées. Les bibliothèques
référencées par des bibliothèques d'un projet ou d'une bibliothèque sont considérées comme des
références indirectes. Automatiquement incluses lors de la compilation, elles ne peuvent être
utilisées dans un projet spécifique.
Le changement éventuel de version de bibliothèque dépend de la méthode de référencement
employée. Par exemple, il est impossible de modifier une version de bibliothèque référencée de
façon indirecte.
À la place, les versions de bibliothèque sont modifiées en fonction des différents mécanismes de
gestion de bibliothèque. Du fait de ces mécanismes, une version de bibliothèque donnée peut
servir pour toutes les références du projet.
Il existe différents moyens de référencer des bibliothèques :
Version directe (voir page 18)
 Version la plus récente (voir page 19)
 Mécanisme d'espace réservé (voir page 21)
 Bibliothèque post-compatible (voir page 23)

EIO0000000792 06/2017
17
Gestion des bibliothèques
Version directe
Présentation
La méthode de référencement la plus simple consiste à définir explicitement la bibliothèque et la
version exacte à utiliser, dans le Gestionnaire de bibliothèques de l'application ou du projet.
Prenons l'exemple d'une bibliothèque X intégrant une autre bibliothèque Z via une référence
directe. Cette dernière sera chargée dans la version intégrée par la bibliothèque X.
Par conséquent, plusieurs versions de la même bibliothèque peuvent être chargées dans le
Gestionnaire de bibliothèques d'un projet.
NOTE : Cette méthode permet de référencer plusieurs versions d'une bibliothèque au sein d'un
même projet. Bien qu'efficace avec certains types de bibliothèques, faites attention si vous
l'appliquez à d'autres types, afin d'éviter tout problème. C'est pourquoi cette méthode est
généralement déconseillée, sauf mention contraire.
AVERTISSEMENT
FONCTIONNEMENT INATTENDU DE L'EQUIPEMENT


Vérifiez que les versions des bibliothèques contenues dans votre programme sont correctes,
après la mise à jour du logiciel.
Vérifiez que les versions des bibliothèques mises à jour correspondent aux caractéristiques
de votre application.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
Exemple
Situation : les bibliothèques suivantes sont ajoutées dans le Gestionnaire de bibliothèques.
Bibliothèque
Version
Bibliothèque X
1.0.0.0
Bibliothèque Y
1.0.0.0
Bibliothèque Z
1.0.0.0
Dépendances :
18
Bibliothèque…
Nécessite la bibliothèque Z dans la
version…
X
1.0.1.0
Y
1.0.2.0
EIO0000000792 06/2017
Gestion des bibliothèques
En supposant que la bibliothèque Z ait été ajoutée dans toutes les bibliothèques en tant que
version directe :
 La bibliothèque Z sera chargée dans trois versions différentes :
 Les POU du projet utilisent directement les fonctionnalités de la version 1.0.0.0.
 Les POU de la bibliothèque X utilisent les fonctionnalités de la version 1.0.1.0.
 Les POU de la bibliothèque Y utilisent les fonctionnalités de la version 1.0.2.0.


Des erreurs de compilateur peuvent alors survenir, par exemple lors de l'échange de données
entre les POU de la bibliothèque Z utilisée par la bibliothèque X et entre les POU de la
bibliothèque Z utilisée par la bibliothèque Z. Ceci est valable même avec une structure de
données identique.
Une fois la bibliothèque référencée via une version directe créée, il est impossible de modifier
les dépendances indirectes.
Version la plus récente
Présentation
Cette méthode de référencement est similaire à celle reposant sur la version directe.
En revanche, la bibliothèque n'est pas référencée par une version exacte, mais par un symbole (*)
de version. À chaque compilation, la dernière version de bibliothèque installée en local est utilisée
dans le projet en cours en tant que version de bibliothèque référencée.
NOTE : Ainsi, en cas d'installation d'une nouvelle version de bibliothèque dans le Référentiel de
bibliothèques, tous les projets et bibliothèques faisant référence à cette bibliothèque à l'aide de la
version la plus récente sont modifiés au moment de la compilation, et ce sans aucun autre
avertissement. En règle générale, mieux vaut éviter cette situation dans votre application, sous
peine de constater des modifications non prévues, que ce soit en cours de génération ou
d'exécution du programme.
AVERTISSEMENT
FONCTIONNEMENT INATTENDU DE L'EQUIPEMENT


Vérifiez que les versions des bibliothèques contenues dans votre programme sont correctes,
après la mise à jour du logiciel.
Vérifiez que les versions des bibliothèques mises à jour correspondent aux caractéristiques
de votre application.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
EIO0000000792 06/2017
19
Gestion des bibliothèques
Exemple
Situation : les bibliothèques suivantes sont ajoutées dans le Gestionnaire de bibliothèques.
Bibliothèque
Version
Bibliothèque X
1.0.0.0
Bibliothèque Y
1.0.0.0
Bibliothèque Z
1.0.0.0
Dépendances :
Bibliothèque…
Nécessite la bibliothèque Z dans la
version…
X
1.0.1.0
Y
1.0.2.0
En outre, la version de bibliothèque suivante est installée dans le Référentiel de bibliothèques :
Sur l'ordinateur A
Sur l'ordinateur B
Bibliothèque Z. 1.0.3.0
Bibliothèque Z. 1.0.2.0
En supposant que la bibliothèque Z ait été ajoutée à l'aide de la méthode de version la plus
récente :
20
Sur l'ordinateur A :
Sur l'ordinateur B :
La bibliothèque X utilise la version 1.0.3.0.
La bibliothèque X utilise la version 1.0.2.0.
La bibliothèque Y utilise la version 1.0.3.0.
La bibliothèque Y utilise la version 1.0.2.0.
EIO0000000792 06/2017
Gestion des bibliothèques
Mécanisme d'espace réservé
Présentation
Le mécanisme d'espace réservé s'appuie sur un emplacement en dehors de la bibliothèque,
appelé « espace réservé », pour référencer une autre bibliothèque.
Lors de la mise à jour ou de l'installation d'équipements, des informations à propos des versions
de bibliothèque compatibles avec les versions d'équipement sont également installées. Elles sont
ensuite insérées par le compilateur en lieu et place des espaces réservés.
Contrairement à une référence de la version la plus récente, la référence d'espace réservé ne subit
aucune modification involontaire. Elle n'est modifiée que lorsque vous installez volontairement une
version plus récente des composants suivants :
 Profil de bibliothèque (en fonction de la version du compilateur)
 Description de l'équipement (pour les bibliothèques propres aux équipements)
 Profil de projet (boîte de dialogue Espace réservé du Référentiel de bibliothèques)
La définition de l'espace réservé est recherchée dans l'ordre suivant (priorité la plus élevée en
premier) :
1. Boîte de dialogue Espace réservé
2. Description de l'équipement
3. Profil de bibliothèque
La résolution de l'espace réservé est déjà définie lors de l'installation de SoMachine.
AVERTISSEMENT
FONCTIONNEMENT INATTENDU DE L'EQUIPEMENT


Vérifiez que les versions des bibliothèques contenues dans votre programme sont correctes,
après la mise à jour du logiciel.
Vérifiez que les versions des bibliothèques mises à jour correspondent aux caractéristiques
de votre application.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
NOTE : Les espaces réservés sont définis par les versions de contrôleur. Lors de la création d'une
bibliothèque, aucun espace réservé n'est défini par les versions de contrôleur pour cette nouvelle
bibliothèque. Le mécanisme d'espace réservé ne peut pas être utilisé lors de l'ajout de cette
bibliothèque personnalisée au Gestionnaire de bibliothèques de l'équipement.
NOTE : Les noms de bibliothèque et les références d'espace réservé font la distinction entre
majuscules et minuscules.
EIO0000000792 06/2017
21
Gestion des bibliothèques
Exemple
Situation : les espaces réservés suivants sont ajoutés à la place de bibliothèques dans le
Gestionnaire de bibliothèques.
Espace réservé
Bibliothèque
Espace réservé X
1.0.0.0
Espace réservé Y
1.0.0.0
Espace réservé Z
1.0.0.0
Dépendances :
Bibliothèque…
Nécessite la bibliothèque Z via l'espace
réservé Z
X
1.0.1.0
Y
1.0.2.0
En outre, les espaces réservés suivants sont remplacés par le contrôleur A :
22
Version de bibliothèque définie dans le
contrôleur A :
Version de bibliothèque par défaut dans
l'onglet Espace réservé du Gestionnaire de
bibliothèques :
Espace réservé Z 1.0.2.0
Bibliothèque Z. 1.0.1.0
EIO0000000792 06/2017
Gestion des bibliothèques
Bibliothèques post-compatibles
Présentation
Une bibliothèque post-compatible est développée de sorte que ses fonctionnalités soient postcompatibles, ce qui signifie que chacune de ses versions reprend l'ensemble des fonctions de la
version précédente. Vous pouvez donc facilement utiliser une nouvelle version de bibliothèque
dans un projet existant, sans apporter aucune modification.
Les dépendances (par exemple, la bibliothèque X utilise la bibliothèque Z) s'effectuent en fonction
d'une version compatible minimale.
Admettons qu'une bibliothèque X nécessite une autre bibliothèque Z de type post-compatible
(dans la version 1.0.0.0, par exemple). La bibliothèque X fonctionnera avec la bibliothèque Z
version 1.0.0.0 ou plus récente.
Une seule version de bibliothèque post-compatible est sélectionnée et utilisée sur demande au
sein du Gestionnaire de bibliothèques d'un projet (après un clic sur le bouton Automatique). Les
références directes et indirectes aux bibliothèques du projet s'appuient sur cette version
compatible sélectionnée dans l'onglet Mappage de version du Gestionnaire de bibliothèques
(voir page 56).
Cette méthode de référencement présente les avantages suivants :
Elle prend en charge le développement indépendant et parallèle de plusieurs bibliothèques.
 Elle facilite la mise à jour des bibliothèques d'après un ensemble de règles de développement
post-compatible.

Dès lors qu'une version de bibliothèque est marquée comme post-compatible, les versions qui en
découlent par la suite le sont également.
Pour obtenir des informations détaillées sur la création de bibliothèques post-compatibles,
reportez-vous à la section Création d'une bibliothèque post-compatible personnalisée
(voir page 32).
Exemple
Situation : les bibliothèques suivantes sont ajoutées dans le Gestionnaire de bibliothèques.
Bibliothèque
Version
Bibliothèque X
1.0.0.0
Bibliothèque Y
1.0.0.0
Bibliothèque Z
1.0.0.0
EIO0000000792 06/2017
23
Gestion des bibliothèques
Dépendances :
Bibliothèque…
Nécessite la version minimale de la bibliothèque Z…
X
1.0.1.0
Y
1.0.2.0
Les versions suivantes de la bibliothèque Z sont installées sur le système local :
 1.0.0.0
 1.0.1.0
 1.0.2.0
 1.0.3.0
En supposant que les versions installées de la bibliothèque Z soient marquées comme postcompatibles :
 Une seule version de la bibliothèque Z est chargée.
 Les versions compatibles de la bibliothèque Z dans ce projet sont 1.0.2.0 et 1.0.3.0,
conformément aux dépendances minimales requises.
 Vous pouvez configurer la version à utiliser dans ce cas de figure (bien qu'il soit pertinent d'opter
pour la version compatible installée la plus récente).
 Lorsque vous cliquez sur le bouton Automatique de l'onglet Mappage de version du projet, le
système choisit la version 1.0.3.0 de la bibliothèque Z, car il s'agit de la version compatible
installée la plus récente.
 Les POU des projets de bibliothèques X et Y utilisent les mêmes versions que les POU de la
bibliothèque Z.
 Il est possible d'échanger les POU de la bibliothèque Z entre le projet et d'autres bibliothèques.
Exemple avancé
Situation :
 Une nouvelle version 1.0.3.1 de la bibliothèque Z utilise certaines fonctionnalités d'une
bibliothèque système référencée via l'espace réservé V.
 Cette bibliothèque n'étant compatible avec le contrôleur A qu'à partir de la version 2.0.0.0, la
bibliothèque Z version 1.0.3.1 est soumise à une exigence de version minimale du micrologiciel
du contrôleur (voir page 32).
Signification :
 Si un projet utilise le contrôleur A version 1.0.0.0, les bibliothèques suivantes sont compatibles :
 1.0.2.0
 1.0.3.0
24

Si un projet utilise le contrôleur A version 2.0.0.0, la bibliothèque suivante est compatible :
 1.0.3.1

Lorsque vous cliquez sur le bouton Automatique de l'onglet Mappage de version, le système
sélectionne la version 1.0.3.1 de la bibliothèque Z, à condition que le contrôleur A du projet ait
été mis à jour vers la version 2.0.0.0.
Dans le cas contraire, c'est la version 1.0.3.0 de la bibliothèque Z qui est sélectionnée.
EIO0000000792 06/2017
Gestion des bibliothèques
Sous-chapitre 2.2
Utilisation des bibliothèques
Utilisation des bibliothèques
Présentation
Cette section expose les situations auxquelles vous pouvez être confronté lorsque vous ajoutez
des bibliothèques dans un projet SoMachine existant, mettez à jour des bibliothèques ou créez une
bibliothèque post-compatible.
Contenu de ce sous-chapitre
Ce sous-chapitre contient les sujets suivants :
Sujet
Page
Méthodes de déclaration d'une bibliothèque dans un projet
26
Ajout de bibliothèques dans un projet SoMachine
26
Mise à jour de bibliothèques et de références de bibliothèque
28
Création d'une bibliothèque post-compatible personnalisée
32
EIO0000000792 06/2017
25
Gestion des bibliothèques
Méthodes de déclaration d'une bibliothèque dans un projet
Présentation
Il existe différents moyens de déclarer une bibliothèque dans un projet. Les bibliothèques sont
automatiquement déclarées lors de l'ajout :
 un contrôleur :
 Bibliothèques de base CEI 61131 : bibliothèques Standard et Util
 Bibliothèque PLCSystem de contrôleurs
 Autres bibliothèques permettant de gérer des fonctionnalités de contrôleur intégré



Fonctionnalités de contrôleur spécifiques
un gestionnaire de bus de terrain ;
un équipement de bus de terrain.
Certaines bibliothèques doivent être ajoutées manuellement.
NOTE : certains blocs fonction et fonctions ne sont pas conçus pour être utilisés dans votre
programme, mais peuvent être requis par le système ou un équipement. N'utilisez que des
fonctions et blocs fonction adaptés au programme (comme indiqué dans la documentation) ou que
vous aurez testés de manière approfondie dans le cadre de votre application.
Ajout de bibliothèques dans un projet SoMachine
Présentation
Le tableau et le schéma suivants représentent le mécanisme de référencement à utiliser lors de
l'ajout d'une bibliothèque dans le Gestionnaire de bibliothèques d'un projet SoMachine :
26
EIO0000000792 06/2017
Gestion des bibliothèques
Si la bibliothèque…
est post-compatible
1)
est post-compatible 1)
et…
utilisez…
appartient à la catégorie
Solution 2) ou est définie par
l'utilisateur
 Définissez une version de bibliothèque explicite dans le
appartient à la catégorie
Solution 2) et n'est pas définie
par l'utilisateur
 Choisissez l'espace réservé souhaité dans l'onglet
la version directe :
Gestionnaire de bibliothèques → onglet Bibliothèque
(par exemple, Packaging, V.1.0.3.0 (Schneider
Electric)).
 Pour mettre à jour ce type de bibliothèque, cliquez sur
le bouton Automatique de l'onglet Mappage de version,
dans le Gestionnaire de bibliothèques.
le mécanisme d'espace réservé :
Espace réservédu Gestionnaire de bibliothèques (par
exemple, SE_ToolboxAdvance pour la bibliothèque
Toolbox_Advance).
 Définissez une version de bibliothèque par défaut dans
l'onglet Espace réservé du Gestionnaire de
bibliothèques. Cette version sera utilisée en l'absence
de description d'équipement.
 Pour mettre à jour ce type de bibliothèque, cliquez sur
le bouton Automatique de l'onglet Mappage de version,
dans le Gestionnaire de bibliothèques.
n'est pas postcompatible 1)
est compatible avec les espaces le mécanisme d'espace réservé :
 Choisissez l'espace réservé souhaité dans l'onglet
réservés 1)
Espace réservédu Gestionnaire de bibliothèques (par
exemple, SE_PTOPWM pour la bibliothèque XBTGC
PTOPWM).
 Définissez une version de bibliothèque par défaut dans
l'onglet Espace réservé du Gestionnaire de
bibliothèques. Cette version sera utilisée en l'absence
de description d'équipement.
n'est pas postcompatible 1)
n'est pas compatible avec les
espaces réservés 1)
la version directe :
 Définissez une version de bibliothèque explicite dans le
Gestionnaire de bibliothèques → onglet Bibliothèque
(par exemple, SE_Packaging, V.1.0.3.0).
1. Pour savoir si la bibliothèque à ajouter est post-compatible ou compatible avec les espaces
réservés, consultez les sections Schneider Electric Libraries (voir page 70) et Autres
bibliothèques utilisées dans SoMachine (voir page 93).
2. Pour savoir si la bibliothèque à ajouter appartient à la catégorie Solution, reportez-vous à la
section Schneider Electric Libraries (voir page 70).
NOTE : SoMachine détecte automatiquement la post-compatibilité des bibliothèques et versions
récentes de bibliothèque. Celle-ci est d'ailleurs respectée lors de la mise à jour automatique
(bouton Automatique de l'onglet Mappage de version).
EIO0000000792 06/2017
27
Gestion des bibliothèques
Mise à jour de bibliothèques et de références de bibliothèque
Présentation
Cette rubrique expose les différentes situations auxquelles vous pouvez être confronté lors de la
mise à jour de bibliothèques.
Boîte de dialogue Mettre à jour le projet
La boîte de dialogue Mettre à jour le projet s'affiche lors de l'ouverture d'un projet existant dans
SoMachine, à condition qu'un des éléments suivants ait été installé sur le système local :
 une version de compilateur plus récente,
 une version de visualisation plus récente,
 une version d'équipement plus récente,
 une version plus récente d'une bibliothèque utilisée.
28
EIO0000000792 06/2017
Gestion des bibliothèques
EIO0000000792 06/2017
29
Gestion des bibliothèques
Voici ce qui se produit en cas de mise à jour de bibliothèques à partir de la boîte de dialogue Mettre
à jour le projet :
Si...
Alors…
l'option Mettre à jour toutes les bibliothèques  toutes les bibliothèques référencées par une version
est activée dans la boîte de dialogue Mettre à
directe sont mises à jour.
jour le projet et si vous cliquez sur OK,
 toutes les bibliothèques ayant au moins une version
post-compatible installée dans le Référentiel de
bibliothèques et étant mappées sur les versions héritées
précédentes sont mises à jour vers la version postcompatible la plus récente.
l'option Mettre à jour toutes les bibliothèques
est désactivée dans la boîte de dialogue
Mettre à jour le projet et si vous cliquez sur
OK,
 aucune référence de bibliothèque existante n'est
vous cliquez sur Annuler,
 aucune référence de bibliothèque existante n'est
modifiée.
 vous pouvez mettre à jour manuellement les
bibliothèques dans l'onglet Mappage de version du
Gestionnaire de bibliothèques.
 les bibliothèques héritées sont marquées comme
héritées dans l'onglet Mappage de version, lorsqu'une
version post-compatible plus récente existe.
 la boîte de dialogue Mettre à jour le projet s'affiche de
nouveau lors de la prochaine ouverture du projet.
Pour l'éviter, activez l'option Ne plus afficher cette boîte
de dialogue dans la boîte de dialogue Mettre à jour le
projet ou dans les paramètres du projet.
modifiée.
 les bibliothèques héritées sont marquées comme
héritées dans l'onglet Mappage de version, lorsqu'une
version post-compatible plus récente existe.
 vous pouvez mettre à jour manuellement les
bibliothèques, l'équipement, la visualisation ou le
compilateur dans le projet.
 la boîte de dialogue Mettre à jour le projet s'affiche de
nouveau lors de la prochaine ouverture du projet.
Pour l'éviter, activez l'option Ne plus afficher cette boîte
de dialogue dans la boîte de dialogue Mettre à jour le
projet ou dans les paramètres du projet.
30
EIO0000000792 06/2017
Gestion des bibliothèques
Mise à jour manuelle de bibliothèques
Si
Alors…
vous souhaitez mettre à jour manuellement des
bibliothèques post-compatibles,
vous pouvez le faire à partir de l'onglet Mappage de
version du Gestionnaire de bibliothèques.
Voici ce qui se produit en cas de mise à jour à l'aide
du bouton Automatique :
 Toutes les bibliothèques post-compatibles sont
mises à jour vers la version post-compatible la
plus récente.
 Toutes les bibliothèques héritées sont converties
en bibliothèques post-compatibles et mises à jour
vers la version post-compatible la plus récente.
Pour mettre à jour une bibliothèque spécifique,
cliquez dessus avec le bouton droit dans l'onglet
Mappage de version, puis sélectionnez Modifier le
mappage de version (bibliothèque sélectionnée).
vous souhaitez mettre à jour manuellement des
bibliothèques n'étant pas post-compatibles,
vous pouvez le faire à partir de l'onglet Bibliothèques
du Gestionnaire de bibliothèques :
1. Dans l'onglet Bibliothèques, sélectionnez une
bibliothèque, puis cliquez sur Menu →
Commandes → Gestionnaire de bibliothèques →
Propriétés.
Résultat : la boîte de dialogue Propriétés
s'affiche.
2. Dans la boîte de dialogue Propriétés,
sélectionnez une version installée sur le système
local, puis cliquez sur OK.
Mise à jour manuelle d'équipements
La mise à jour manuelle d'une description d'équipement à l'aide de l'option Actualiser l'appareil…
entraîne la mise à jour des bibliothèques suivantes :
 Bibliothèques automatiquement incluses par l'équipement
 Bibliothèques incluses en tant qu'espaces réservés
 Bibliothèques post-compatibles
Pour mettre à jour un équipement (voir SoMachine, Guide de programmation), cliquez dessus
avec le bouton droit dans l'arborescence des équipements, puis sélectionnez Actualiser l'appareil.
EIO0000000792 06/2017
31
Gestion des bibliothèques
Projet créé à partir d'une version précédente
Dans un projet créé avec une version précédente du logiciel SoMachine, les règles de conversion
suivantes s'appliquent aux versions des bibliothèques déclarées dans le projet :
 Les versions des bibliothèques déclarées au moyen d'une version directe (voir page 18)
demeurent inchangées.
 Les versions des bibliothèques déclarées via la méthode de version la plus récente (version
identifiée par * dans le Gestionnaire de bibliothèques) sont automatiquement mises à jour avec
la version la plus récente (voir page 19).
 Les versions des bibliothèques déclarées via le mécanisme d'espace réservé (voir page 21)
sont automatiquement mises à jour avec celles définies dans le fichier de description d'appareil
après une commande de mise à jour d'équipement de contrôleur.
Création d'une bibliothèque post-compatible personnalisée
Présentation
Par défaut, les bibliothèques que vous créez ne sont pas post-compatibles.
Pour créer votre propre bibliothèque post-compatible, vous devez définir l'attribut ForwardCompatibleLibrary dans la section Informations de projet de votre projet de bibliothèque. Pour en savoir
plus, reportez-vous à la procédure ci-dessous.
NOTE : Lorsque la clé ForwardCompatibleLibrary est définie, la bibliothèque, et les versions qui
en découlent par la suite, respectent les exigences suivantes.
Chaque version ultérieure reprend les fonctionnalités de la version précédente :
 Toutes les POU de la version précédente sont disponibles.
 Les POU respectent le même comportement dans les versions précédente et ultérieure de la
bibliothèque.
 Les POU de la version précédente ont une visibilité égale ou supérieure à celle de la version
ultérieure.
 Les noms et types de données des entrées demeurent inchangés dans les différentes versions.
En outre, vous pouvez définir un attribut facultatif (MinimumControllerFirmware) en cas de
dépendance d'équipement. Servant à indiquer la version minimale requise du micrologiciel pour
les contrôleurs pris en charge, cet attribut n'est requis que lorsque la bibliothèque utilise des POU
d'une autre bibliothèque non post-compatible référencée comme espace réservé.
L'attribut MinimumControllerFirmware est composé d'un numéro d'identification de fabricant et
d'équipement, ainsi que de la version de micrologiciel minimale requise.
32
EIO0000000792 06/2017
Gestion des bibliothèques
Procédure
NOTE : La procédure suivante n'inclut que les étapes supplémentaires nécessaires à la création
d'une bibliothèque post-compatible.
Etape
Action
1
Suivez la procédure de création de bibliothèque personnalisée (voir page 59)
jusqu'à l'étape 3.
2
Dans le menu Projet → Informations de projet, ouvrez la boîte de dialogue
Informations de projet, sélectionnez l'onglet Propriétés, puis saisissez ou
sélectionnez les éléments suivants :
 Champ Clé : ForwardCompatibleLibrary
 Champ Type : Booléen
 Champ Valeur : Vrai
3
Cliquez sur Ajouter pour ajouter la clé aux informations de projet de votre
bibliothèque.
4
Ajoutez également l'attribut facultatif MinimumControllerFirmware, si besoin.
Dans la section Fichier > Projet → Informations de projet, saisissez ou
sélectionnez les éléments suivants :
 Champ Clé : MinimumControllerFirmware
 Champ Type : Texte
 Champ Valeur : catégorie d'équipements « / » ID de fournisseur et
d'équipement « / » version (par exemple, 4096/1003 0082/1.33.2.0)
Lorsque l'attribut MinimumControllerFirmware s'applique à plusieurs
équipements, séparez les numéros d'identification dans le champ Valeur par le
symbole |.
Exemple :
 4096/1003 0082/1.33.2.0|4096/1003 009D/1.35.1.1
5
EIO0000000792 06/2017
Passez à l'étape 3 de la procédure de création de bibliothèque personnalisée
(voir page 59).
33
Gestion des bibliothèques
34
EIO0000000792 06/2017
SoMachine
Éditeur du Gestionnaire de bibliothèque
EIO0000000792 06/2017
Chapitre 3
Éditeur du Gestionnaire de bibliothèque
Éditeur du Gestionnaire de bibliothèque
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
Éditeur du Gestionnaire de bibliothèque
36
Ajouter une bibliothèque
40
Propriétés
44
Charger à nouveau une bibliothèque
46
Espaces réservés
47
Référentiel de bibliothèque
48
Onglet Mappage de version
56
EIO0000000792 06/2017
35
Éditeur du Gestionnaire de bibliothèque
Éditeur du Gestionnaire de bibliothèque
Présentation
Double-cliquez sur un nœud de bibliothèque dans l'arborescence Outils pour ouvrir le
Gestionnaire de bibliothèque en mode édition.
Mode édition du Gestionnaire de bibliothèque, onglet Bibliothèques
36
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
La fenêtre d'édition est constituée de 4 parties :
 En haut, affichage des bibliothèques actuellement comprises dans le projet
 En bas à gauche, affichage de certains modules de la bibliothèque sélectionnée dans la partie
supérieure
 En bas à droite, affichage sous forme d'onglets d'informations supplémentaires sur la
bibliothèque sélectionnée dans la partie supérieure
 Barre d'outils composée de boutons et de commandes
Description de la partie supérieure
La partie supérieure présente les bibliothèques actuellement comprises dans le projet.
Les informations suivantes sont proposées :
Paramètre
Description
Nom
Indique le titre, la version et éventuellement le nom de la société figurant dans l'onglet
Résumé de la boîte de dialogue Informations du projet de la bibliothèque.
Espace de nom
Par défaut, l'espace de nom d'une bibliothèque correspond à <nom de la bibliothèque>,
exception faite des bibliothèques ayant un autre espace de nom dans leurs Informations du
projet. Utilisez l'espace de nom (voir SoMachine, Guide de programmation) de la bibliothèque
comme préfixe de l'identifiant. Ceci est utile pour accéder à un module disponible à divers
endroits du projet, ou si l'utilisation de ce préfixe est activée par la propriété de bibliothèque
LanguageModelAttributequalified-access-only. Vous pouvez modifier l'espace de nom
standard d'une bibliothèque incluse pour une utilisation locale (au sein du projet) dans la boîte
de dialogue (voir page 44) Propriétés
Version effective
Il s'agit de la version de bibliothèque actuellement utilisée selon la définition de la boîte de
dialogue (voir page 44) Propriétés.
Les bibliothèques incluses automatiquement dans un projet sont affichées en gris, tandis que
celles ajoutées manuellement (Ajouter une bibliothèque...) sont en noir.
L'icône devant le nom de la bibliothèque indique son type :
Icône
Description
Bibliothèque avec informations sur les versions
Bibliothèque référencée (voir page 17)
Le fichier de bibliothèque référencée n'a pas été trouvé ou ne correspond pas à une bibliothèque
valide (voir message correspondant dans la liste Gestionnaire de bibliothèque de l'affichage
Messages). Pour plus d'informations, consultez la description de la commande Charger de nouveau
la bibliothèque (voir page 46).
Bibliothèque sous licence pour laquelle aucune licence valide n'est disponible
EIO0000000792 06/2017
37
Éditeur du Gestionnaire de bibliothèque
Si la bibliothèque comporte des dépendances par rapport à d'autres bibliothèques (bibliothèque
référencée (voir page 17)), elles sont automatiquement incluses (sous réserve de leur
disponibilité) et comportent une icône pour bibliothèques référencées dans une sousarborescence de l'entrée. Pour développer ou réduire une arborescence, cliquez sur le signe + ou
- correspondant.
Description de la partie inférieure
En bas à gauche de l'éditeur sont affichés les modules spécifiques de la bibliothèque actuellement
sélectionnée dans la partie supérieure.
En bas à droite se trouvent les onglets suivants :
38
Onglet
Description
Documentation
Les composants du module actuellement sélectionné dans la partie gauche
sont affichés sous forme de tableau, avec le Nom de la variable, le Type de
données et l'éventuel Commentaire ajouté à la déclaration de composants au
moment de la création de la bibliothèque. Si un dossier est sélectionné, la
documentation associée est affichée. L'insertion de commentaires permet
donc de fournir automatiquement de la documentation sur le module.
Entrées/Sorties
Les composants du module de bibliothèque actuellement sélectionné sont
affichés sous forme de tableau, avec le Nom de la variable, le Type de
données, l'Adresse, la Valeur initiale et le Commentaire, tel que défini dans la
bibliothèque.
Graphique
Représentation graphique du module
Paramètres de bibliothèque
Cet onglet n'est disponible que pour les bibliothèques qui contiennent une
liste de paramètres. Les valeurs des paramètres peuvent être modifiées dans
la colonne Valeur (modifiable). Pour plus de détails, consultez le paragraphe
GVL pour les constantes configurables (Liste de paramètres) dans les
bibliothèques (voir SoMachine, Guide de programmation).
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Boutons et commandes
Les commandes suivantes, fournies en mode édition lorsqu'une ou plusieurs bibliothèques sont
sélectionnées, correspondent aux bibliothèques. Elles sont disponibles par défaut dans la barre de
menus lorsque l'éditeur Gestionnaire de bibliothèque est activé :
Onglet
Description
Ajouter une bibliothèque
Permet d'ajouter une bibliothèque à un projet
La bibliothèque doit être installée sur le système local. Si vous essayez
d'insérer une bibliothèque déjà disponible dans le projet (voir page 40), un
message vous en avertit.
Supprimer la bibliothèque
La bibliothèque actuellement sélectionnée dans la liste est supprimée du
projet.
Propriétés
Pour les paramètres relatifs à l'espace de nom et, en sachant que la
bibliothèque sera disponible comme bibliothèque référencée dans un autre
projet, pour les paramètres relatifs au traitement de version, à la visibilité et à
l'accès. Consultez le chapitre Propriétés (voir page 44).
Détails
Affiche une boîte de dialogue avec des détails sur la bibliothèque
(informations générales, contenu, propriétés, informations sur la licence).
Espace réservé
Permet de rediriger n'importe quel espace réservé et groupe de bibliothèques
vers une version différente. Consultez le chapitre Espace réservé
(voir page 47).
Référentiel de bibliothèque
Permet de définir les emplacements des bibliothèques et d'installer ou de
désinstaller des bibliothèques. Consultez le chapitre Référentiel
(voir page 48).
EIO0000000792 06/2017
39
Éditeur du Gestionnaire de bibliothèque
Ajouter une bibliothèque
Présentation
Dans la vue de l'éditeur Gestionnaire de bibliothèque, cliquez sur le bouton Ajouter une
bibliothèque pour ajouter au projet les bibliothèques déjà installées sur votre système.
La boîte de dialogue Ajouter un appareil s'ouvre. Elle est constituée de deux onglets :
L'onglet Bibliothèque, qui vous permet d'ajouter une bibliothèque définie en spécifiant une
version fixe.
 L'onglet Espace réservé, qui vous permet de faire référence à une bibliothèque à l'aide d'un
espace réservé.

Tenez compte des informations générales concernant la gestion des bibliothèques (voir page 15).
Onglet Bibliothèque
Onglet Bibliothèque de la vue d'éditeur Gestionnaire de bibliothèque
1
2
3
4
40
Catégorie
Société
Titre
Version
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
L'onglet Ajouter une bibliothèque vous permet d'effectuer une recherche dans toutes les
bibliothèques installées, par exemple pour trouver un certain bloc fonctionnel. Entrez le texte
rechercheé dans la zone de texte située dans la partie supérieure de la boîte de dialogue. Seuls
les objets (noms de bibliothèque, POU, types de données et commentaires contenus dans ces
objets) qui contiennent le texte recherché sont affichés dans les listes de l'onglet Bibliothèque et
Espace réservé
L'onglet Bibliothèque répertorie les bibliothèques actuellement installés sur votre système avec le
titre, la version, la société et la catégorie tels que définis dans les informations de projet de la
bibliothèque. Vous pouvez filtrer l'affichage en définissant une Société dans la liste de sélection.
L'option (Toutes les sociétés) indique la liste de toutes les bibliothèques disponibles.
Si l'option Grouper par catégorie est activée, les bibliothèques de la société actuellement définie
sont répertoriées suivant les catégories disponibles. Les catégories apparaissent sous forme de
nœuds avec les bibliothèques (ou les autres catégories) affichées au-dessous en retrait. Si l'option
Grouper par catégorie n'est pas activée, les bibliothèques sont affichées par ordre alphabétique.
NOTE : Pour la conception et le référencement de bibliothèques, reportez-vous aux recommandations pour la création de bibliothèques (voir page 64).
Sélectionnez la bibliothèque souhaitée.
Si l'option Afficher toutes les versions (pour les experts uniquement) est activée, toutes les
versions installées des bibliothèques s'affichent en retrait sous l'entrée de la bibliothèque
actuellement sélectionnée. Outre les identificateurs de version explicite, un astérisque * est
disponible pour indiquer qu'il s'agit de la dernière version. Ceci vous permet de choisir entre les
versions. Par défaut, cette option est désactivée et seule la version la plus récente s'affiche.
Dans ce cas, une sélection multiple des bibliothèques est possible : pour cela, maintenez la touche
CTRL ou MAJ enfoncée tout en sélectionnant les bibliothèques souhaitées.
Après confirmation en cliquant sur OK, les bibliothèques sélectionnées s'ajouteront à la liste dans
la vue du Gestionnaire de bibliothèque.
Si vous souhaitez inclure une bibliothèque qui n'est pas encore installée sur le système local,
cliquez sur le bouton Référentiel de bibliothèque. Cette action ouvre la boîte de dialogue
Référentiel de bibliothèque (voir page 48) qui vous permet d'effectuer l'installation nécessaire.
EIO0000000792 06/2017
41
Éditeur du Gestionnaire de bibliothèque
Onglet Espace réservé
Onglet Espace réservé de la vue d'éditeur Gestionnaire de bibliothèque
Les espaces réservés s(utilisent dans les cas suivants :
Pour assurer la compatibilité des projets entre plusieurs appareils cibles interchangeables.
 Si votre projet est un projet de bibliothèque référençant d'autres bibliothèques spécifique aux
équipements.

Dans ce cas, vous incluez ces bibliothèques spécifiques dans le gestionnaire de bibliothèque par
le biais d'espaces réservés, qui sont définis dans les descriptions des appareils. Veuillez
également consulter les règles de bonne pratique pour la création de votre propre bibliothèque
(voir page 65).
NOTE : Dans le cas du développement d'une bibliothèque, l'espace réservé ne peut pas être
résolu. La bibliothèque sélectionnée par défaut est prise en compte.
NOTE : Prendez également en compte l'affectation des résolutions d'espaces réservés des
bibliothèques, qui dépendent de la version du compilateur actuellement utilisée, telle que définie
dans les profils de bibliothèque (voir page 54).
42
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Ajout d'une bibliothèque au moyen d'un espace réservé
Entrez un nom dans la zone de texte Nom d'espace réservé. Afin d'assurer l'insertion correcte du
nom, cliquez sur la flèche pour ouvrir la liste de sélection offrant tous les noms d'espace réservé
actuellement définis dans la description de l'appareil.
Choisissez une bibliothèque par défaut dans les bibliothèques actuellement installées qui
s'affichent dans la zone Bibliothèque par défaut. Cette bibliothèque par défaut est utilisée si, pour
une raison quelconque, aucun appareil n'est disponible. Cette option permet la compilation du
projet de bibliothèque actuellement édité sans détection d'erreurs. Sélectionnez une bibliothèque
par défaut de la manière décrite pour l'ajout d'une bibliothèque sous l'onglet Bibliothèque. Vous
pouvez également activer l'option Afficher toutes les versions (pour les experts uniquement) afin
d'afficher toutes les versions d'une bibliothèque actuellement installées.
Dès que vous fermez l'onglet Espace réservé en cliquant sur OK, la bibliothèque contenue dans
l'espace réservé est insérée dans l'arborescence du Gestionnaire de bibliothèque. Sélectionnez
cette entrée et ouvrez la boîte de dialogue Properties (voir page 44) pour afficher les informations
relatives à la bibliothèque par défaut actuellement définie.
Dans l'exemple suivant, l'espace réservé n'est pas encore remplacé (ou résolu). Dès que le
Gestionnaire de bibliothèque appartient à une application d'appareil qui fait référence à cette
bibliothèque, le nom et la version de cette bibliothèque spécifique s'affichent dans les colonnes
respectives.
Exemple d'espace réservé pour une bibliothèque inséré dans un Gestionnaire de bibliothèque
EIO0000000792 06/2017
43
Éditeur du Gestionnaire de bibliothèque
Propriétés
Présentation
Dans la vue de l'éditeur Gestionnaire de bibliothèque, cliquez sur le bouton Propriétés pour ouvrir
la boîte de dialogue Propriétés de la bibliothèque sélectionnée. Cette option vous permet de
configurer l'espace de nom, la gestion des versions, la disponibilité, ainsi que la visibilité des
références de la bibliothèque.
Boîte de dialogue Propriétés d'une bibliothèque
NOTE : Avant de travailler sur des projets de bibliothèque et de modifier les espaces de nom, les
paramètres de version et la visibilité, consultez les directives relatives à la création de
bibliothèques (voir page 59).
Section Général de la boîte de dialogue
44
Paramètre
Description
Espace de nom
L'espace de nom actuel de la bibliothèque s'affiche. Par défaut, l'espace de
nom d'une bibliothèque est à peu près identique au nom de la bibliothèque, à
ceci près qu'une autre chaîne a été définie dans les Informations de projet lors
de la création du projet de bibliothèque.
Vous pouvez éditer l'espace de nom.
Pour plus d'informations, reportez-vous à la description de la vue d'éditeur
Gestionnaire de bibliothèque (voir page 37).
Bibliothèque par défaut
Si un espace réservé de bibliothèque est sélectionné dans le Gestionnaire de
bibliothèque, ce champ contient le nom de la bibliothèque qui remplace
l'espace réservé, dans le cas où aucune bibliothèque spécifique à un appareil
n'est disponible. Voir l'onglet Espace réservé (voir page 42).
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Section Version de la boîte de dialogue
Configurez la version de la bibliothèque qui est utilisé dans le projet :
Paramètre
Description
Version spécifique
Entrez la version ou sélectionnez-en une dans la liste utilisée pour le projet. Option à
utiliser pour les bibliothèques de conteneurs (voir page 60).
Toujours la version la plus
récente
La version la plus récente trouvée dans le référentiel de la bibliothèque est utilisée. Les
modules utilisés peuvent changer du fait qu'il existe une version plus récente de la
bibliothèque. Option à utiliser pour les bibliothèques d'interfaces (voir page 60).
Pour les bibliothèques communes, ne spécifiez aucune contrainte de version, mais
utilisez une référence d'espace réservé (voir page 65).
Section Visibilité de la boîte de dialogue
Ces paramètres sont utiles dès lors que la bibliothèque est incluse et référencée par une autre
bibliothèque. Par défaut, ils sont désactivés :
Paramètre
Description
Permettre uniquement
l’accès qualifié à tous les
identificateurs
Si cette option est activée, l'utilisation de l'espace de noms est obligatoire.
Afficher tous les symboles
CEI dans le projet, comme si
cette référence avait été
directement intégrée
Cette option est pertinente si une bibliothèque B a été ajoutée à une bibliothèque A
dans un projet qui utilise la bibliothèque A :
Si l'option est activée, vous pouvez accéder aux composants de la bibliothèque B en
utilisant l'espace de noms de la bibliothèque A.
Exemple : NamespaceLibA.ComponentOfLibB
Si l'option est désactivée, vous devez indiquer le chemin d'accès complet à cet espace
de noms.
Exemple : NamespaceLibA.NamespaceLibB.ComponentOfLibB
Voir également le chapitre sur la Gestion des bibliothèques (voir page 15) pour des
informations génériques sur la manipulation des bibliothèques.
NOTE : N'activez cette option que si vous souhaitez utiliser les bibliothèques de
conteneurs ne contenant pas de modules propres, mais incluant juste les autres
bibliothèques en vue de leur conditionnement. Ce conditionnement permet par
exemple d'inclure simultanément plusieurs bibliothèques dans un projet en ajoutant
simplement la bibliothèque de conteneurs. Dans ce cas, il peut être souhaitable
d'inclure les bibliothèques particulières situées au niveau supérieur du Gestionnaire de
bibliothèque de ce projet. Au niveau supérieur, les modules sont accessibles
directement. L'espace de noms de la bibliothèque de conteneurs peut être ignoré. Pour
cela, activez cette option.
Masquer cette référence
dans l'arbre de dépendance
EIO0000000792 06/2017
Lorsque cette option est activée, la bibliothèque actuelle n'apparaîtra pas
ultérieurement lorsque la bibliothèque parent sera incluse dans un projet. Cette option
vous permet d'inclure les bibliothèques masquées. Elle nécessite une utilisation
prudente, car en cas d'émission de messages d'erreur liés à une bibliothèque, il peut
être difficile d'identifier la bibliothèque qui en est la cause.
45
Éditeur du Gestionnaire de bibliothèque
Charger à nouveau une bibliothèque
Présentation
Si une bibliothèque incluse dans un projet se trouve, pour une raison quelconque, indisponible à
l'emplacement défini lorsque vous ouvrez le projet dans le système de programmation, un
message approprié sera généré.
Après avoir de nouveau rendu la bibliothèque disponible, exécutez la commande Charger à
nouveau une bibliothèque dans la vue d'éditeur Gestionnaire de bibliothèque lorsque l'entrée de
bibliothèque est sélectionnée. Cette commande est également disponible dans le menu contextuel
lorsque vous cliquez avec le bouton droit sur une entrée de la bibliothèque. Dès lors, la
bibliothèque peut être rechargée sans que vous ayez à quitter le projet.
46
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Espaces réservés
Présentation
Dans la vue de l'éditeur Gestionnaire de bibliothèque, cliquez sur le bouton Espaces réservés afin
de rediriger les éventuels espaces réservés (principalement définis via le profil de bibliothèque et
l'appareil cible) vers une autre version. Cette fonctionnalité n'est disponible que si la fonction
Activer le traitement simplifié des bibliothèques est inactivée.
NOTE : Prenez attentivement en compte les effets possibles d'une modification du référencement
de la bibliothèque. Veuillez également consulter les règles de bonne pratique pour la création de
bibliothèques (voir page 59).
Paramètre
Description
Résolution d’espace réservé Redirige la résolution de l'espace réservé. Vous pouvez entrer la nouvelle
résolution manuellement ou en sélectionnant (Parcourir...). Cette action
ouvre une boîte de dialogue permettant de choisir l'une des bibliothèques
disponibles.
Résolution par défaut pour
espace réservé
La résolution indiquée ici est appliquée lorsque le paramètre Résolution
d'espace réservé est défini sur (Par défaut).
Infos sur la résolution :
Informations relatives à l'emplacement où la résolution actuelle de l'espace
réservé est définie (selon la description d'appareil, le profil de bibliothèque, la
bibliothèque par défaut, la résolution d'espace réservé, etc.).
EIO0000000792 06/2017
47
Éditeur du Gestionnaire de bibliothèque
Référentiel de bibliothèque
Présentation
NOTE : Cette fonctionnalité n'est disponible que si elle est sélectionnée dans le kit de propriétés
en cours d'utilisation (Options → Propriétés → Kits de propriétés prédéfinis).
Ouvrez la boîte de dialogue Référentiel de bibliothèques en sélectionnant Outils → Options →
Référentiel de bibliothèques... ou en cliquant sur le bouton Référentiel de bibliothèques dans
l'éditeur Gestionnaire de bibliothèques.
Pour accéder au Référentiel de bibliothèques à partir de SoMachine Central, ouvrez la boîte de
dialogue Options du système en cliquant sur le bouton Options du système dans la barre d'outils
ou sur le bouton Paramètres dans la fenêtre Versions. Dans la boîte de dialogue Options du
système, cliquez sur le bouton (voir SoMachine Central, Guide utilisateur) Référentiel de
bibliothèques.
Un référentiel de bibliothèque est une base de données pour les bibliothèques ayant été installées
sur le système local afin d'être disponibles pour les projets SoMachine.
NOTE : Un projet de bibliothèque *.library stocké dans un référentiel de bibliothèque ne peut pas
y être ouvert pour être affiché ou modifié dans le système de programmation.
48
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Boîte de dialogue Référentiel de bibliothèque
1
2
3
4
Catégorie
Société
Nom
Version
Cette boîte de dialogue affiche les emplacements de bibliothèques actuellement définis
(référentiels), ainsi que les bibliothèques actuellement installées.
Elle vous permet d'effectuer les actions suivantes :
Ajouter, modifier ou supprimer des référentiels
 Installer et désinstaller des bibliothèques

La boîte de dialogue Référentiel de bibliothèque contient les éléments suivants :
EIO0000000792 06/2017
49
Éditeur du Gestionnaire de bibliothèque
Paramètre
Description
Liste d'Emplacements
Sélectionnez un répertoire sur le système local où sont stockés les fichiers de
bibliothèques.
Sélectionnez Système pour afficher les bibliothèques standard fournies par
SoMachine dans la liste Bibliothèques installées.
Sélectionnez Utilisateur pour afficher seulement les bibliothèques que vous
avez vous-même définies dans la liste Bibliothèques installées.
Liste de Sociétés
Sélectionnez un nom pour n'afficher que les bibliothèques d'un fournisseur
principal (ou d'un nom de groupe défini par le fournisseur principal) dans la
liste Bibliothèques installées.
Pour afficher toutes les bibliothèques disponibles à l'Emplacement
sélectionné, choisissez (Toutes les sociétés) dans la liste.
Liste de Bibliothèques
installées
La liste affiche les bibliothèques disponibles à l'Emplacement sélectionné, de
la Société sélectionnée, avec leur nom (titre), numéro de version et nom de
société, tels qu'ils sont fournis dans les informations de projet de la
bibliothèque.
Option Grouper par catégorie Activez l'option Grouper par catégorie pour trier les Bibliothèques installées
en fonction de leur catégorie. Les noms des catégories sont affichés comme
des nœuds que vous pouvez développer/réduire pour afficher/masquer les
bibliothèques.
Désactivez cette option pour afficher les bibliothèques en ordre alphabétique.
Les catégories de bibliothèques sont définies par fichiers de description
externes*.libcat.xml (voir page 61).
Bouton Modifier...
Boutons
Installer.../Désinstaller
Consultez le paragraphe Emplacements de bibliothèques (référentiels)
(voir page 50).
Consultez le paragraphe Installation et désinstallation de bibliothèques
(voir page 52).
Bouton Rechercher...
Consultez le paragraphe Recherche de bibliothèques (voir page 53).
Boutons
Détails.../Dépendances...
Consultez le paragraphe Plus d'informations sur certaines bibliothèques
(voir page 54).
Bouton Profils de
bibliothèque...
Consultez le paragraphe Profils de bibliothèques (voir page 54).
Emplacements de bibliothèques (référentiels)
Vous pouvez utiliser plusieurs référentiels pour gérer les bibliothèques. Ceux qui sont définis
figurent dans la liste Emplacement. Par défaut, elle contient les entrées Système pour les
bibliothèques standard fournies par SoMachine et Utilisateur pour les bibliothèques que vous avez
définies vous-même.
Pour modifier le chemin d'accès ou le nom d'un référentiel, cliquez sur le bouton Modifier.....
50
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
La boîte de dialogue Modifier les emplacements de stockage de référentiels s'affiche :
Cette boîte de dialogue contient les éléments suivants :
Paramètre
Description
Liste de Référentiels
Répertorie les emplacements définis. La recherche de bibliothèque s'effectue
dans l'ordre donné (du haut vers le bas).
Monter/Descendre
Modifie l'ordre des bibliothèques. L'emplacement sélectionné est déplacé
vers le haut ou vers le bas de la liste.
Le paramètre Emplacement : <Tous emplacements de stockage> affiche les bibliothèques de tous
les emplacements définis. Aucune installation n'est possible dans ce mode d'affichage.
Définition d'un nouveau référentiel ou modification du chemin d'accès et du nom d'un référentiel existant
Cliquez sur le bouton Ajouter... de la boîte de dialogue Modifier les emplacements de stockage de
référentiels pour ajouter un nouveau référentiel. La boîte de dialogue Emplacement de stockage
pour référentiel s'affiche.
Pour modifier un référentiel existant, sélectionnez l'entrée correspondante de cette boîte de
dialogue , puis cliquez sur le bouton Modifier. La boîte de dialogue Emplacement de stockage pour
référentiel s'affiche.
EIO0000000792 06/2017
51
Éditeur du Gestionnaire de bibliothèque
Cette boîte de dialogue contient les éléments suivants :
Paramètre
Description
Zone de texte Emplacement
Saisissez le chemin d'accès du nouveau référentiel ou modifiez celui du
référentiel existant.
Pour rechercher un dossier ou en créer un, cliquez sur le bouton ....
Vérifiez que le dossier sélectionné est vide.
Zone de texte Nom
Saisissez un nom symbolique pour l'emplacement, par exemple
Bibliothèques pour le Système1.
NOTE : Le dossier choisi comme dossier de référentiel doit être vide. Le référentiel Système ne
peut pas être modifié. L'entrée est ainsi affichée en italique.
Suppression d'un référentiel existant
Pour supprimer un référentiel, sélectionnez-le dans la boîte de dialogue Modifier les
emplacements de stockage de référentiels, puis cliquez sur le bouton Supprimer. Un message
s'affiche, et vous devez indiquer si seule l'entrée de la liste doit être supprimée, ou si le dossier
contenant les fichiers de bibliothèques doit aussi être supprimé du système de fichiers.
Installation et désinstallation de bibliothèques
Dans un projet, vous ne pouvez inclure que les bibliothèques installées sur le système local
(Référentiel de bibliothèque). Pour que l'installation ait lieu, l'onglet Résumé de la boîte de
dialogue Informations de projet doit comporter au moins un Titre, des informations sur la Version
et un nom de Société.
Pour installer une bibliothèque, sélectionnez le référentiel auquel la bibliothèque doit être ajoutée
dans la boîte de dialogue Référentiel de bibliothèque, puis cliquez sur le bouton Installer....
La boîte de dialogue Sélectionner la bibliothèque s'affiche. Il s'agit d'une boîte de dialogue
standard de recherche de fichier. Par défaut, le filtre Type de fichiers prend la valeur Compiled
library files. Vous pouvez sélectionner à la place Bibliothèques ou Tous les fichiers.
Sélectionnez la bibliothèque souhaitée et cliquez sur Ouvrir. Elle est ajoutée à la liste de
bibliothèques installées, dans la boîte de dialogue Référentiel de bibliothèque.
Si vous sélectionnez une bibliothèque qui ne peut pas être installée car elle n'est pas
accompagnée des Informations de projet (titre, version, société) obligatoires, un message
s'affiche.
Pour désinstaller une bibliothèque, sélectionnez-la dans la liste de bibliothèques installées, dans
la boîte de dialogue Référentiel de bibliothèque, puis cliquez sur le bouton Désinstaller.
52
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Recherche de bibliothèques
Pour rechercher une bibliothèque à l'emplacement de stockage spécifié, cliquez sur le bouton
Rechercher dans la boîte de dialogue Référentiel de bibliothèque. La boîte de dialogue
Rechercher bibliothèque s'affiche. Elle vous permet de rechercher des blocs fonction et les
bibliothèques correspondantes.
Boîte de dialogue Rechercher bibliothèque
La boîte de dialogue Rechercher bibliothèque contient les éléments suivants :
Paramètre
Description
Zone de texte Élément à
rechercher
Saisissez la chaîne de recherche du bloc fonction et les bibliothèques
correspondantes.
Vous pouvez également saisir les caractères génériques * et ?.
Option Respecter la casse
Activez cette option pour effectuer une recherche sensible à la casse.
Option Intégrer des
commentaires dans la
recherche
Activez cette option pour analyser non seulement les noms des blocs
fonction, mais aussi les commentaires associés.
EIO0000000792 06/2017
53
Éditeur du Gestionnaire de bibliothèque
Plus d'informations sur certaines bibliothèques
Pour afficher davantage d'informations sur la bibliothèque actuellement sélectionnée, cliquez sur
la ligne correspondant à la bibliothèque contenant la version, puis cliquez sur le bouton Détails....
Une boîte de dialogue Détails s'affiche, avec des détails supplémentaires issus des Informations
de projet de la bibliothèque. Pour obtenir encore davantage d'informations, cliquez sur le bouton
Plus....
Pour afficher les dépendances à d'autres bibliothèques pour celle qui est actuellement
sélectionnée, cliquez sur la ligne correspondant à la bibliothèque contenant la version, puis cliquez
sur le bouton Dépendances.... Une boîte de dialogue Dépendances s'affiche, avec la liste des
bibliothèques comprises dans celle qui est sélectionnée, ainsi que les informations de Titre,
Version et Société.
Les références qui fonctionnent via des espaces réservés sont répertoriés selon la syntaxe
suivante :
#<nom d'espace réservé>.
Pour des informations sur les espaces réservés des bibliothèques, consultez le chapitre
Mécanisme d'espace réservé (voir page 21).
Profils de bibliothèque
Un profil de bibliothèque définit la version de la bibliothèque utilisée pour résoudre un espace
réservé de bibliothèque lorsqu'une certaine version de compilateur est définie pour le projet. Pour
ouvrir la boîte de dialogue Profils de bibliothèque, cliquez sur le bouton Profils de bibliothèque...
dans la boîte de dialogue Référentiel de bibliothèque.
54
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
Boîte de dialogue Profils de bibliothèque
La boîte de dialogue Profils de bibliothèque contient les éléments suivants :
Paramètre
Description
Bouton Exporter
Sélectionnez 1 ou plusieurs entrées Espace réservé ou juste une seule
entrée Version compilateur sous une entrée Espace réservé Cliquez sur ce
bouton pour exporter les affectations entre espace réservé et version de
bibliothèque dans un fichier XML avec l'extension *.libraryprofile.
Bouton Importer
Cliquez sur ce bouton pour importer un fichier XML avec l'extension
*.libraryprofile.
Si l'importation fournit des entrées d'espace réservé déjà disponibles, vous
devez indiquer si les entrées existantes doivent être remplacées.
Sachez que vous pouvez également définir des résolutions d'espace réservé par l'appareil cible
actuellement défini, et même par des réaffectations spécifiées en local dans l'onglet Espace
réservé de la boîte de dialogue Ajouter une bibliothèque (voir page 40).
EIO0000000792 06/2017
55
Éditeur du Gestionnaire de bibliothèque
Onglet Mappage de version
Présentation
L'onglet Mappage de version du Gestionnaire de bibliothèque permet de modifier le mappage de
version des bibliothèques FCL (Forward Compatible Libraries) (voir page 23).
Onglet Mappage de version du Gestionnaire de bibliothèque :
56
EIO0000000792 06/2017
Éditeur du Gestionnaire de bibliothèque
L'onglet Mappage de version comprend deux tableaux :
 Le tableau supérieur répertorie les bibliothèques FCL avant qu'elles ne soient incluses dans le
projet SoMachine.
Il répertorie également les bibliothèques héritées s'il existe une version plus récente de ces
bibliothèques FCL. Les bibliothèques héritées ont été créées avec la version 3.1 ou une version
antérieure de SoMachine et ne possèdent pas encore la compatibilité ascendante. Vous
pouvez reconnaître ces bibliothèques par la présence de l'entrée Hérité dans la colonne
Version configurée du tableau.
 La partie inférieure du tableau fournit des informations supplémentaires sur la bibliothèque
sélectionnée dans le tableau supérieur. Elle indique les dépendances avec d'autres
bibliothèques FCL et descriptions d'appareils.
Modification de la version d'une bibliothèque
L'onglet Mappage de version du Gestionnaire de bibliothèque vous permet de modifier le mappage
de version des bibliothèques de différentes façons :
 Vous pouvez effectuer automatiquement le mappage de version de toutes les bibliothèques
répertoriées dans le tableau en cliquant sur le bouton Automatique. Cette action produit les
effets suivants :
 Les bibliothèques FCL sont mises à jour sur la dernière version disponible.
 Les bibliothèques héritées sont converties en bibliothèques FCL mises à jour sur la dernière
version disponible.


Vous pouvez effectuer automatiquement le mappage de version d'une bibliothèque spécifique.
Pour ce faire, cliquez sur la bibliothèque avec le bouton droit et exécutez la commande Modifier
le mappage de version (bibliothèque sélectionnée).
Vous pouvez modifier manuellement la version de chaque bibliothèque. Pour ce faire, cliquez
sur la colonne Version configurée pour ouvrir la liste des versions disponibles. Sélectionnez la
version souhaitée dans la liste.
Bibliothèque comportant des dépendances non résolues
Les bibliothèques FCL comportant des dépendances non résolues sont affichées sur fond rouge
dans la partie supérieure du tableau. Sélectionnez cette bibliothèque pour afficher des
informations plus détaillées sur les dépendances requises et les versions compatibles dans le
tableau inférieur. Les dépendances non résolues figurent en rouge dans le tableau inférieur. Par
exemple, si aucune version d'équipement compatible n'est utilisée dans le projet, la ligne
Descriptions d'équipement acceptées apparaît en rouge. Si une dépendance de bibliothèque
requise est manquante, la ligne library dependencies et la dépendance de bibliothèque absente
apparaissent en rouge.
Equipements non pris en charge
Si un équipement est indiqué comme compatible dans le tableau des dépendances d'équipement,
mais qu'il n'est pas installé dans la version de SoMachine que vous utilisez, la mention
Unsupported device apparaît sur la ligne, avec l'ID de l'équipement.
EIO0000000792 06/2017
57
Éditeur du Gestionnaire de bibliothèque
58
EIO0000000792 06/2017
SoMachine
Créer une bibliothèque
EIO0000000792 06/2017
Chapitre 4
Créer une bibliothèque
Créer une bibliothèque
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
Informations générales
60
Étape 1 : Définir le projet
60
Étape 2 : Remplir les Informations de projet
61
Étape 3 : Référencer d'autres bibliothèques si besoin
64
Étape 3.1 : Utiliser des références d'espaces réservés
65
Étape 4 : Concevoir et programmer les modules de bibliothèque
65
Étape 5 : Concevoir l'interface
66
Étape 6 : Mettre en place des routines de gestion d'erreurs
66
Étape 7 : Configurer un déploiement raisonnable (restriction d'utilisation)
67
EIO0000000792 06/2017
59
Créer une bibliothèque
Informations générales
Présentation
Pour des raisons de compatibilité, veuillez suivre les instructions décrites dans les chapitres
suivants lorsque vous créez une bibliothèque.
Veuillez prendre en compte les éléments suivants :
 Définissez un nom de bibliothèque cohérent avec le contenu.
 Utilisez une structure de projet familière et si possible cohérente (facultatif).
 Indiquez les Informations de projet (obligatoire).
 Sélectionnez un espace de nom unique pour votre bibliothèque (obligatoire).
 Utilisez la procédure adéquate pour référencer d'autres bibliothèques (obligatoire).
 Créez des interfaces externes et internes facilement utilisables (obligatoire).
 Mettez en place une routine de gestion d'erreurs (obligatoire).
 Utilisez la méthode adéquate (protection) de déploiement (obligatoire).
 Suivez une convention de nommage facile à lire et à déboguer (facultatif).
Lorsque vous créez un projet de bibliothèque, il est nécessaire de suivre les étapes décrites dans
les chapitres qui suivent.
Étape 1 : Définir le projet
Présentation
Dans SoMachine Central, créez un nouveau projet de bibliothèque dans l'écran Mise en route en
exécutant les commandes Nouveau projet → Nouvelle bibliothèque. Définissez le Nom et les
Détails dans la boîte de dialogue Nouvelle bibliothèque, comme indiqué dans le SoMachine
Central Guide utilisateur (voir SoMachine Central, Guide utilisateur).
60
EIO0000000792 06/2017
Créer une bibliothèque
Étape 2 : Remplir les Informations de projet
Présentation
Indiquez les informations concernant le projet dans Projet → Informations de projet. Cette boîte de
dialogue est composée de plusieurs onglets. Vous trouverez ci-dessous des informations pour la
création de votre bibliothèque.
Onglet Résumé
Précisez les informations suivantes dans l'onglet Résumé de la boîte de dialogue Informations de
projet :
Paramètre
Description
Société
Obligatoire : veuillez indiquer une société pour le projet.
Titre
Obligatoire : veuillez indiquer le nom du projet.
Version
Obligatoire : veuillez indiquer la version du projet.
Espace de noms par défaut
Permet de rendre chaque symbole unique, même si le même nom est utilisé
dans différentes bibliothèques.
Si vous n'indiquez pas d'espace de nom, c'est le nom de la bibliothèque qui
est utilisé. Il est préférable qu'il soit unique. Une fois la bibliothèque intégrée
à un projet, il est toujours possible de modifier l'espace de nom dans la boîte
de dialogue Propriétés du Gestionnaire de bibliothèque.
Pour forcer l'espace de nom, consultez la section suivante de ce chapitre.
Catégories de bibliothèques
Permet de trier les entrées dans Référentiel de bibliothèques et Gestionnaire
de bibliothèque.
Si possible, choisissez une autre catégorie que Divers, parmi les suivantes :
 Application : bibliothèques à insérer explicitement dans un projet.
Conçues pour un accès direct depuis le code de l'utilisateur final.
 Interne : bibliothèques automatiquement insérées dans un projet et qui ne
devraient pas être insérées ou supprimées manuellement.
 Système : bibliothèques qui dépendent directement du système
d'exécution ou de certaines parties de ce dernier. Elles ne doivent pas être
insérées directement dans un projet, mais doivent être référencées par
d'autres bibliothèques. Elles ne sont pas conçues pour être directement
intégrées à l'application utilisateur. (Aucune gestion de ressources n'est
fournie, comme par exemple la suppression de ressources sur le
contrôleur afin que des interfaces série soient fermées avant un prochain
téléchargement.)
Auteur
Indiquez le nom du créateur du projet.
Description
Indiquez une brève description du contenu de la bibliothèque.
Créer POU automatiques
pour l'accès aux propriétés
Non utilisé.
EIO0000000792 06/2017
NOTE : Ne pas utiliser dans les bibliothèques. Risque d'erreurs d'application.
61
Créer une bibliothèque
Forçage de l'espace de noms
Vous pouvez forcer l'affichage de l'espace de noms en premier lors de l'accès à des modules ou
variables de bibliothèque, depuis l'application ou depuis une autre bibliothèque. Pour cela,
configurez la propriété LanguageModelAttribute (Text) :='qualified-accessonly' dans l'onglet Propriétés.
Nom de la Clé : LanguageModelAttribute
Type : Text
Valeur : qualified-access-only (voir figure ci-dessous).
Des erreurs de compilation sont détectées si une variable ou un module de bibliothèque est utilisé
sans espace de nom le précédant.
Onglet Propriétés : paramètres pour forcer l'espace de nom
62
EIO0000000792 06/2017
Créer une bibliothèque
Onglet Propriétés
Liste de propriétés configurables :
Propriété
Type
Valeur
Description
Société
Text
<nom de société>
Permet de filtrer les
bibliothèques dans la boîte
de dialogue Ajouter une
bibliothèque.
Titre
Text
<nom de bibliothèque> #
–
Version
Text
<version de bibliothèque>
–
Publication
Boolean
TRUE/FALSE
La bibliothèque ne doit pas
être modifiée après sa
publication.
Auteur
Text
<nom d'auteur>
Auteur de la version de
bibliothèque actuelle
DefaultNamespace
Text
<espace de nom>
Préfixe d'espace de nom
unique international
Description
Text
<description>
Brève description du
domaine de la bibliothèque
Espace réservé
Text
<espace réservé>
–
IsContainerLibrary
Boolean
TRUE/FALSE
Cette bibliothèque suit les
règles d'une bibliothèque
conteneur.
IsInterfaceLibrary
Boolean
TRUE/FALSE
Cette bibliothèque suit les
règles d'une bibliothèque
conteneur.
LanguageModelAttribute
Text
'qualified-accessonly'
Les symboles de cette
bibliothèque ne sont
accessibles que par le
préfixe d'espace de nom.
IsEndUserLibrary
Boolean
TRUE/FALSE
Cette bibliothèque est
particulièrement adaptée
aux besoins d'un utilisateur
final.
EIO0000000792 06/2017
63
Créer une bibliothèque
Étape 3 : Référencer d'autres bibliothèques si besoin
Présentation
Définissez la visibilité et la version à utiliser pour les autres bibliothèques que vous incluez.
Visibilité
Dans les Propriétés (voir page 44) de chaque bibliothèque référencée, définissez son
comportement lorsqu'elle est incluse dans un projet avec sa bibliothèque parent.
Décidez si une bibliothèque référencée doit être masquée (non visible dans le Gestionnaire de
bibliothèques) ou s'il faut créer une bibliothèque conteneur (ne comportant que des références de
bibliothèque) :
Bibliothèque masquée
Désactivez la visibilité de la bibliothèque dans le Gestionnaire de
bibliothèques sous la bibliothèque parent, en activant l'option
Masquer cette référence dans l'arbre de dépendance de la boîte de
dialogue Propriétés (voir page 44).
Ainsi, les bibliothèques masquées peuvent être disponibles dans un
projet.
Bibliothèque conteneur
Une bibliothèque conteneur (*_Cnt.library) est un projet de
bibliothèque qui ne définit aucun module mais qui fait référence à
d'autres bibliothèques. Elle permet de simplifier l'accès aux modules
de ces bibliothèques.
En créant une bibliothèque conteneur, vous pouvez inclure en une
fois un ensemble complet de bibliothèques dans un projet. Pour
simplifier l'accès aux modules de ces bibliothèques, placez celles-ci
au niveau supérieur. Ce qui vous permet de pas indiquer l'espace de
nom de la bibliothèque conteneur dans le chemin d’accès.
Pour ce faire, activez l'option Afficher tous les symboles CEI dans le
projet, comme si cette référence avait été directement intégrée ici
dans la boîte de dialogue Propriétés (voir page 44).
Ne sélectionnez cette option que pour une bibliothèque conteneur.
Contraintes de version



64
Les bibliothèques d'interface sont référencées directement avec la contrainte la plus récente.
Pour cela, sélectionnez * au lieu d'une version particulière lorsque vous incluez la bibliothèque
via la boîte de dialogue Ajouter une bibliothèque.
Les bibliothèques conteneurs sont référencées avec une contrainte de version. Pour cela,
sélectionnez une version de la bibliothèque dans la boîte de dialogue Ajouter une bibliothèque.
Les bibliothèques communes sont référencées par une référence d'espace réservé. Cela
permet des relations cohérentes entre les différentes bibliothèques. La mise à jour d'une sousbibliothèque indirectement référencée ne nécessite pas de modifier chaque bibliothèque
concernée, mais seulement la définition de l'espace réservé (voir page 47).
EIO0000000792 06/2017
Créer une bibliothèque
Étape 3.1 : Utiliser des références d'espaces réservés
Présentation
Pour référencer des bibliothèques générales, utilisez des références d'espaces réservés.
Utilisez des espaces réservés de bibliothèque pour rendre un projet compatible pour des
équipements cibles interchangeables ou pour différentes versions de compilateur. Lorsque vous
ajoutez une bibliothèque à un projet, pensez à utiliser un espace réservé plutôt qu'une version de
bibliothèque définitive. La version actuellement requise de la bibliothèque est alors référencée,
selon la définition actuellement valide de la résolution d'espace réservé.
Pour la définition de résolution finale, les emplacements suivants sont pris en compte dans l'ordre
décroissant. Le troisième élément a la priorité.
1. Profil de bibliothèque, fourni par défaut avec l'installation du système de programmation, qui
définit la résolution d'un espace réservé en fonction de la version du compilateur. Pour plus de
détails, consultez le paragraphe description des Profils de bibliothèques (voir page 54).
2. Description d'équipement de la cible actuellement définie, qui définit la résolution d’espace
réservé spécifique à l'équipement. (Si aucun équipement n'est disponible, c'est la résolution par
défaut spécifiée pour l'espace réservé qui s'applique.)
3. Boîte de dialogue (voir page 47) Espace réservé, accessible depuis le Gestionnaire de
bibliothèque, où vous pouvez modifier la résolution de l'espace réservé spécifiquement pour le
projet actuel.
NOTE : Il s'agit de la résolution finale et effective. Vous ne pouvez la modifier que si l'option Activer
le traitement simplifié des bibliothèques n'est pas activée. Une telle modification doit être
soigneusement réfléchie.
Étape 4 : Concevoir et programmer les modules de bibliothèque
Considérations
NOTE : Utilisez la structure proposée en POU avec le modèle de bibliothèque, et n'oubliez pas
d'ajouter la documentation nécessaire pour les modules de bibliothèque.
EIO0000000792 06/2017
65
Créer une bibliothèque
Étape 5 : Concevoir l'interface
Présentation
On distingue deux types d'interfaces de bibliothèque :
Interface
Description
Interfaces externes (ou utilisateur)
Accessibles via l'application de l'utilisateur final.
Utilisez un ensemble réduit de types de paramètres,
de façon à ce que les programmateurs n'aient pas
besoin de travailler avec des types de données
problématiques ou compliqués, tels que les pointeurs
ou l'opérateur ADR().
Interfaces internes
Toutes les autres interfaces
Les interfaces doivent être optimisées pour une utilisation avec CFC.
Le cas échéant, réutilisez le modèle de comportement général pour construire des interfaces de
blocs fonction pour les utilisateurs finaux.
Marquez les bibliothèques conçues spécifiquement pour les utilisateurs finaux avec la propriété
IsEndUserLibrary (reportez-vous au type de bibliothèque Bibliothèque pour utilisateur final
décrit dans le chapitre Étape 1 : Définir le projet).
Étape 6 : Mettre en place des routines de gestion d'erreurs
Présentation
Pour créer des routines de gestion d'erreurs efficaces, prenez en compte les éléments suivants :
Seuls les codes d'erreur que vous avez documentés doivent être renvoyés.
 Ne vous contentez pas de renvoyer les codes d'erreur transmis depuis d'autres bibliothèques.
Documentez-les dans vos routines et renvoyez le code approprié, tel que documenté.

66
EIO0000000792 06/2017
Créer une bibliothèque
Étape 7 : Configurer un déploiement raisonnable (restriction d'utilisation)
Présentation
Pour protéger la source de la bibliothèque, configurez des droits d'accès et de protection
appropriés. Ensuite, utilisez un type pertinent de restriction d'utilisation.
 Ne fournissez la bibliothèque que dans un format compilé (*.compiled-library). Ainsi, la source
du projet ne peut pas être restaurée. Pour ce faire, utilisez la commande Enregistrer le projet
sous... dans la barre d'outils (voir SoMachine Central, Guide utilisateur) de SoMachine Central.
 Augmentez les restrictions des droits d'accès pour l'utilisateur Everyone. Pour plus
d'informations, consultez le chapitre Gestion des utilisateurs et droits d'accès (voir SoMachine,
Guide de programmation).
 Réservez le droit d'afficher le contenu des objets Informations du projet et Gestionnaire de
bibliothèque. Pour plus d'informations, reportez-vous à la section Contrôle d'accès
(voir SoMachine, Commandes de menu, Aide en ligne).
 Limitez l'utilisation de la bibliothèque à certaines plateformes ou certains équipements : vous
pouvez mettre en place un code de vérification afin que la bibliothèque ne fonctionne qu'avec
l'équipement approprié.
EIO0000000792 06/2017
67
Créer une bibliothèque
68
EIO0000000792 06/2017
SoMachine
Présentation des bibliothèques
EIO0000000792 06/2017
Chapitre 5
Présentation des bibliothèques
Présentation des bibliothèques
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
Bibliothèques Schneider Electric
70
Autres bibliothèques utilisées dans SoMachine
93
EIO0000000792 06/2017
69
Présentation des bibliothèques
Bibliothèques Schneider Electric
Introduction
Toutes les bibliothèques Schneider Electric sont mentionnées ci-dessous.
Les tableaux de présentation des bibliothèques Schneider Electric sont décrits ci-dessous :
Catégorie
Catégorie à laquelle cette bibliothèque appartient,
comme indiqué dans la boîte de dialogue Gestionnaire
de bibliothèque.
Espace de noms
Espace de noms par défaut de la bibliothèque,
permettant d'accéder aux fonctions de la bibliothèque.
NOTE : La bonne pratique consiste à utiliser
systématiquement l'espace de noms par défaut dans
votre application.
Si l'attribut qualified-access-only figure après l'espace de
noms par défaut, cela signifie que l'utilisation de cet
espace de noms dans votre application est obligatoire.
Pour plus d'informations, reportez-vous à la rubrique
Description générale des bibliothèques (voir page 11).
Référencer la bibliothèque en tant que
Méthode pour ajouter une référence à la bibliothèque :
 PH (Placeholder) signifie que la bibliothèque est
ajoutée à l'aide du mécanisme d'espace réservé
(voir page 21). Le nom d'espace réservé à utiliser
pour cette bibliothèque est indiqué.
 La mention version directe indique que la bibliothèque
est ajoutée à l'aide du mécanisme de version directe
(voir page 18).
 La mention FCL indique qu'il s'agit d'une bibliothèque
à compatibilité ascendante (voir page 23).
UTILISATEUR

OUI : les fonctions et blocs fonction de la bibliothèque
peuvent être utilisés dans l'application utilisateur
(programme).
 NON : bibliothèques destinées uniquement aux
fonctions administratives ou propres au système.
Généralement, ces fonctions et blocs fonction ne sont
accompagnés d'aucune documentation utilisateur.
Pour plus d'informations sur la manière d'ajouter une bibliothèque dans un projet SoMachine,
reportez-vous à la section Ajouter une bibliothèque (voir page 40).
Pour plus d'informations sur l'utilisation des bibliothèques et leur référencement, reportez-vous à
la section Gestion des bibliothèques dans SoMachine (voir page 15).
70
EIO0000000792 06/2017
Présentation des bibliothèques
Catégorie : (Divers)
Le tableau suivant décrit la bibliothèque disponible dans la catégorie (Divers) :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
FeatureNotSupported
FeatureNotSupported
version directe
bibliothèque virtuelle
vide utilisée par le
système
NON
Catégorie : Application
Le tableau suivant décrit la bibliothèque disponible dans la catégorie Application :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
PD_ETest
Reportez-vous au document
Guide de la bibliothèque
PD_ETest (voir SoMachine,
PD_ETest
version directe (FCL)
Contient les fonctions
utilisées dans le
framework ETEST.
NON
SE_LMC_Utility
SE_LMC_Utility
PH (FCL)
SE_LMC_Utility
Fonctions utilitaires
utilisées par la
bibliothèque d'esclaves
PROFIBUS DP.
NON
PD_ETest, Guide de la
bibliothèque).
NOTE : Pour obtenir la description des autres bibliothèques, reportez-vous aux catégories
Communication, Solution et Util.
Catégorie : Communication
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Communication :
EIO0000000792 06/2017
71
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
EMailHandling
Reportez-vous au document
Guide de la bibliothèque
EMailHandling
SE_Email
(qualified-access-only)
version directe (FCL)
Cette bibliothèque
OUI
permet à votre
contrôleur d'envoyer un
e-mail personnalisable à
un ou plusieurs
destinataires. Le
protocole utilisé pour le
trafic des e-mails est
TCP (standard).
Il est possible de
recevoir ou supprimer
des e-mails d'un serveur
en utilisant le protocole
POP3 (Post Office
Protocol 3).
(voir SoMachine,
EMailHandling, Guide de la
bibliothèque).
UTILIS
ATEUR
NOTE : La
communication est mise
en place à l'aide de la
bibliothèque
TcpUdpCommunication.
EtherNetIP Explicit
Messaging
reportez-vous au document
Ethernet industriel
SoMachine - Guide de
l'utilisateur (voir SoMachine
EIPXM
(qualified-access-only)
version directe (FCL)
Messagerie explicite sur OUI
EtherNet/IP pour
communiquer avec des
équipements
génériques (comme des
caméras) pour lesquels
SoMachine ne propose
pas l'intégration
d'équipements.
EtherNetIP Remote Adapter
reportez-vous au document
Ethernet industriel
SoMachine - Guide de
l'utilisateur (voir SoMachine
EIPRA
(qualified-access-only)
version directe (FCL)
Utilisé par des objets
d'équipement
EtherNet/IP pour
prendre en charge la
gestion des connexions
et des paramètres
utilisateur.
NON
EtherNetIP Scanner
reportez-vous au document
Ethernet industriel
SoMachine - Guide de
l'utilisateur (voir SoMachine
EIPSC
version directe (FCL)
Blocs fonction pour
établir et fermer les
connexions CIP et créer
une demande de
message explicite sur
EtherNet/IP.
OUI
Ethernet industriel, Guide de
l'utilisateur)
Ethernet industriel, Guide de
l'utilisateur)
Ethernet industriel, Guide de
l'utilisateur)
72
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
FtpRemoteFileHandling
Reportez-vous au document
Guide de la bibliothèque
FtpRemoteFileHandling
SE_FTP
(qualified-access-only)
version directe (FCL)
La bibliothèque propose OUI
des fonctionnalités de
client FTP (File Transfer
Protocol), permettant à
un contrôleur de
consulter et de gérer des
fichiers distants sur un
serveur FTP.
(voir SoMachine,
FtpRemoteFileHandling,
Guide de la bibliothèque).
UTILIS
ATEUR
NOTE : La
communication est mise
en place à l'aide de la
bibliothèque
TcpUdpCommunication.
IoDrvASI
Reportez-vous à la section
AS-Interface (voir Modicon
SEN_ASI
PH (FCL) SE_ASi
Fonctions de gestion
des bus AS-Interface.
OUI
IoDrvDistributedIo
SEN_DIO
PH SE_Distributed_IO Fonctions de gestion de
bus pour les E/S
distribuées sur
CANopen.
NON
IoDrvTM5PCDPS
SEN_PROFIBUS
PH (FCL)
IoDrvTM5PCDPS
Bibliothèque d'esclaves
PROFIBUS DP.
NON
IoDrvTM4PDPS1
IoDrvTM4DPS1Lib
version directe (FCL)
Bibliothèque d'esclaves
PROFIBUS DP M241
NON
M2xx Communication
Reportez-vous à la section
Fonctions permettant
d'obtenir/de définir une
configuration de ligne série
SEN_COM
PH (FCL)
Obtention et définition
OUI
SE_M2XXCommunica d'une configuration de
tion
port Ligne série sur les
contrôleurs M238, M258
et LMC058.
Modem
Reportez-vous à la section
Bibliothèque Modem
SE_MOD
PH (FCL) SE_Modem
M238 Logic Controller, Guide
de programmation).
(voir Modicon M238 Logic
Controller, Guide de
programmation).
(voir SoMachine, Fonctions
de modem, Guide de la
bibliothèque Modem).
EIO0000000792 06/2017
Configuration modem
OUI
sur les contrôleurs
M238, M258 et LMC058.
73
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
PLCCommunication
Reportez-vous à la section
Bibliothèque
PLCCommunication
SEN
PH (FCL)
SE_PLCCommunicati
on
Gestion des échanges
de données explicites
entre le contrôleur et les
équipements via les
protocoles Modbus ou
ASCII.
OUI
(voir SoMachine, Fonctions
Lecture/Ecriture Modbus et
ASCII, Guide de la
bibliothèque
PLCCommunication).
NOTE : Cette
bibliothèque n'est pas
prise en charge par ATV
IMC Drive Controller.
SE_NetVarUdp
Reportez-vous à la section
Bibliothèque SE_NetVarUdp
NetVarUdp
version directe (FCL)
Echange de données
entre les contrôleurs
d'un réseau via des
variables de réseau.
SnmpManager
Reportez-vous au document
Guide de la bibliothèque
SnmpManager
SE_SNMP
(qualified-access-only)
version directe (FCL)
La bibliothèque met en OUI
œuvre un gestionnaire
du protocole Internet
standard SNMP (Simple
Network Management
Protocol). Le
gestionnaire SNMP
permet à votre
contrôleur de collecter et
d'organiser les
informations concernant
les équipements pris en
charge sur les réseaux
IP (Internet Protocol) et
de modifier ces
informations pour
ajuster la configuration
de l'équipement.
(voir SoMachine,
Configuration de variables de
réseau, Guide de la
bibliothèque SE_NetVarUdp).
(voir SoMachine,
SnmpManager, Guide de la
bibliothèque).
OUI
NOTE : La
communication est mise
en place à l'aide de la
bibliothèque
TcpUdpCommunication.
74
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
SqlRemoteAccess
Reportez-vous au document
Guide de la bibliothèque
SqlRemoteAccess
SE_SQL
(qualified-access-only)
version directe (FCL)
La bibliothèque fournit
OUI
des blocs fonction
clients SQL (Structured
Query Language) qui
permettent à votre
contrôleur de se
connecter à une base de
données SQL pour
exécuter des
requêtes SQL de lecture
et d'écriture de données.
(voir SoMachine,
SqlRemoteAccess, Guide de
la bibliothèque).
UTILIS
ATEUR
NOTE : La
communication est mise
en place à l'aide de la
bibliothèque
TcpUdpCommunication.
ModbusTCPIOScanner
SE_IOS
version directe (FCL)
Blocs fonction de
scrutateur d'E/S
Modbus TCP.
NON
TcpUdpCommunication
reportez-vous à la section
Bibliothèque
TcpUdpCommunication
TCPUDP
version directe (FCL)
Fonctionnalité standard
pour mettre en œuvre
les protocoles de
communication basés
sur TCP (client et
serveur) ou UDP (y
compris, diffusion et
multidiffusion) via IPv4
(Internet Protocol
Version 4).
OUI
(voir SoMachine,
TcpUdpCommunication,
Guide de la bibliothèque).
EIO0000000792 06/2017
75
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
TimeSync
Reportez-vous au document
Guide de la bibliothèque
TimeSync (voir SoMachine,
TIMS
(qualified-access-only)
version directe (FCL)
La bibliothèque fournit
OUI
des services de
synchronisation
temporelle. Grâce au
client SNTP, l'horloge du
contrôleur peut être
synchronisée avec des
serveurs de
synchronisation
appartenant au même
réseau, via le protocole
SNTP (Simple Network
Time Protocol).
TimeSync, Guide de la
bibliothèque).
UTILIS
ATEUR
NOTE : La
communication est mise
en place à l'aide de la
bibliothèque
TcpUdpCommunication.
76
EIO0000000792 06/2017
Présentation des bibliothèques
Catégorie : Contrôleur
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
DataLogging
Reportez-vous à la section
Bibliothèque DataLogging
SEDL
PH (FCL)
SE_DataLogging
Gestion de la
OUI
journalisation des
données des contrôleurs
qui prennent en charge
les opérations de gestion
de fichiers.
(voir SoMachine, Fonctions
de journalisation des
données, Guide de la
bibliothèque DataLogging).
UTILIS
ATEUR
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → ATV IMC :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILISA
TEUR
ATV- IMC HSC
SEC_HSC
Reportez-vous à la section
Comptage rapide (voir Altivar
PH (FCL) SE_HSC
Gestion du comptage
rapide ATV IMC
OUI
ATV-IMC PLCSystem
Reportez-vous à la section
Bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système ATV IMC
OUI
ATV-IMC SysLib V2.3
SEC_SL23
PH (FCL)
SE_SysLibv23
Fonctions et blocs
fonction pour la
compatibilité des
applications Controller
Inside (CoDeSys v2.3).
OUI
ATV IMC Drive Controller,
Comptage rapide, Guide de
la bibliothèque ATV IMC
HSC).
(voir Altivar ATV IMC Drive
Controller, Fonctions et
variables système, Guide de
la bibliothèque ATV-IMC
PLCSystem).
EIO0000000792 06/2017
77
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILISA
TEUR
ATV-IMC UserLib
Consultez le document ATV
IMC - Guide de la
bibliothèque UserLib
SEC_USER
PH (FCL) SE_UserLib Gestion de l'interface
hôte ATV IMC - ATV71.
OUI
(voir Altivar ATV IMC Drive
Controller, Guide de la
bibliothèque ATV IMC
UserLib).
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → LMC058 :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
IoDrvTM5SEAISG
SEC_TM5SEAISG
PH IoDrvTM5SEAISG
Bibliothèque
OUI
d'équipements
TM5SEAISG
Fournit des services
d'étalonnage, de tarage
et de mesure étalonnée.
PH (FCL)
SE_ExpertIO
Gestion des E/S
expertes LMC058.
OUI
PH (FCL) SE_Motion
Fonctions utilisées pour
extraire la valeur
actuelle de l'axe de
déplacement et
réinitialiser l'erreur
détectée.
OUI
SEC_EXP
LMC058 Expert IO
 Reportez-vous à la section
Comptage rapide
UTILIS
ATEUR
(voir Modicon LMC058
Motion Controller,
Comptage rapide, Guide
de la bibliothèque d'E/S
expertes du LMC058).
 Consultez la section
Modulation de la largeur
d'impulsion (voir Modicon
LMC058 Motion
Controller, Pulse Width
Modulation, Guide de la
bibliothèque Expert I/O du
LMC058).
LMC058 Motion
Reportez-vous à la section
Comptage rapide
(voir Modicon LMC058
Motion Controller, Comptage
rapide, Guide de la
bibliothèque d'E/S expertes
du LMC058).
78
SEC_MC
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
LMC058 PLCSystem
Reportez-vous à la section
Bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système LMC058
OUI
Relocation Table
SEC_RELOC
PH (FCL)
SE_RelocationTable
Bibliothèque système
pour la gestion de la
table de réaffectation
NON
Bibliothèque d'utilitaires
Ethernet.
OUI
(voir Modicon LMC058
Motion Controller, Fonctions
et variables système,
LMC058 Motion Controller Guide de la bibliothèque
PLCSystem).
(voir Modicon LMC058
Motion Controller, Guide
de programmation).
Ethernet Util
SEC_ETH_UTIL
PH (FCL)
SE_EthernetUtil
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → M238 :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
M238 ASi Interface
SEC_ASIITF
PH (FCL)
SE_ASiInterface
Bibliothèque système
pour la gestion du bus
AS-Interface.
NON
M238 HSC
Reportez-vous à la section
Comptage rapide
SEC_HSC
PH (FCL) SE_HSC
Gestion du comptage
rapide M238
OUI
M238 PLCSystem
Reportez-vous à la section
Bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système M238
OUI
(voir Modicon M238 Logic C
ontroller, Comptage rapide,
Guide de la bibliothèque
M238 HSC).
(voir Modicon M238 Logic
Controller, Fonctions et
variables système, M238 Guide de la bibliothèque
PLCSystem).
EIO0000000792 06/2017
79
Présentation des bibliothèques
Nom
Espace de nom
M238 PTOPWM
SEC_PTOPWM
Reportez-vous à la section
Sortie à train
d'impulsions/Modulation de la
largeur d'impulsion
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
PH (FCL)
SE_PTOPWM
Gestion PTO et PWM
M238.
OUI
(voir Modicon M238 Logic
Controller, Sortie à train
d'impulsions, Modulation de
la largeur d'impulsion, Guide
de la bibliothèque PTOPWM
du M238).
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → M241 :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
M241 HSC
Consultez le document
M241 - Guide de la
bibliothèque HSC
SEC_HSC
version directe (FCL)
Gestion du comptage
rapide M241
OUI
M241 PLCSystem
Consultez le document
M241 - Guide de la
bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système M241
OUI
M241 PTOPWM
Consultez le document
M241 - Guide de la
bibliothèque PTOPWM
SEC_PTOPWM
version directe (FCL)
Gestion PTO et PWM
M241.
OUI
(voir Modicon M241 Logic
Controller, High Speed
Counting, HSC Library
Guide).
(voir Modicon M241 Logic Co
ntroller, Fonctions et
variables système, Guide de
la bibliothèque PLCSystem ).
(voir Modicon M241 Logic Co
ntroller, Guide de la
bibliothèque, PTOPMW).
80
EIO0000000792 06/2017
Présentation des bibliothèques
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → M251 :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
M251 PLCSystem
Consultez le document
M251 - Guide de la
bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système M251
OUI
(voir Modicon M251 Logic
Controller, Fonctions et
variables système, Guide de
la bibliothèque PLCSystem ).
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → M258 :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
IoDrvTM5SEAISG
SEC_TM5SEAISG
PH IoDrvTM5SEAISG
Bibliothèque
OUI
d'équipements
TM5SEAISG
Fournit des services
d'étalonnage, de tarage
et de mesure étalonnée.
M258 Expert IO
 Reportez-vous à la
section Comptage rapide
SEC_EXP
PH (FCL)
SE_ExpertIO
Gestion des E/S
expertes M258.
OUI
(voir Modicon M258 Logic
Controller, Comptage
rapide, Guide de la
bibliothèque M258 Expert
I/O).
 Consultez la section
Modulation de la largeur
d'impulsion
(voir Modicon M258 Logic
Controller, Pulse Width
Modulation, Guide de la
bibliothèque M258 Expert
I/O).
EIO0000000792 06/2017
81
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
M258 PLCSystem
Reportez-vous à la section
Bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système M258
OUI
Ethernet Util
SEC_ETH_UTIL
PH (FCL)
SE_EthernetUtil
Bibliothèque d'utilitaires
Ethernet.
OUI
(voir Modicon M258 Logic Co
ntroller, Fonctions et
variables système, M258 Guide de la bibliothèque
PLCSystem).
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → XBTGC :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
XBTGC HSC
Reportez-vous à la section
Comptage rapide
SEC_HSC
PH (FCL) SE_HSC
Gestion du comptage
rapide XBTGC
OUI
XBT PLCSystem
Reportez-vous à la section
Bibliothèque PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système XBTGC
OUI
PH (FCL)
SE_PTOPWM
Gestion PTO et PWM
XBTGC.
OUI
(voir Magelis
XBTGC HMI Controller,
Comptage rapide, Guide de la
bibliothèque XBTGC HSC).
(voir Magelis XBTGC,
XBTGT, XBTGK HMI
Controller, Fonctions et
variables système, Guide de
la bibliothèque XBT
PLCSystem).
XBT PTOPWM
SEC_PTOPWM
Reportez-vous à la section
Sortie à train
d'impulsions/Modulation de la
largeur d'impulsion
(voir Magelis
XBTGC HMI Controller ,
Sortie à train d'impulsions,
Modulation de la largeur
d'impulsion, XBTGC Guide
de la bibliothèque PTOPWM).
82
EIO0000000792 06/2017
Présentation des bibliothèques
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Contrôleur → HMISCU :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
HMISCU HSC
Reportez-vous à la section
Bibliothèque HMISCU HSC
HMISCU_HSC
PH (FCL)
HMISCU_HSC
Gestion du comptage
rapide HMISCU
OUI
HMISCU PLCSystem
Reportez-vous à la section
Bibliothèque
HMISCU PLCSystem
SEC
PH (FCL)
SE_PLCSystem
Fonctions et variables
système HMISCU
OUI
HMISCU PTOPWM
Reportez-vous à la section
Bibliothèque
HMISCU PTO/PWM.
HMISCU_PTOPWM
PH (FCL)
HMISCU_PTOPWM
Gestion des fonctions
PTO et PWM de
HMISCU
OUI
version directe (FCL)
Fournit un bloc fonction
pour gérer une requête
ModbusTCP envoyée
par un client au
contrôleur HMISCU.
OUI
(voir Magelis SCU, HMI
Controller, Guide de la
bibliothèque HSC).
(voir Magelis SCU, HMI
Controller, Guide de la
bibliothèque PLCSystem ).
MTS
SE_ModbusTCP_Slave
Reportez-vous au document
Magelis SCU - HMI Controller
- Guide de programmation
(voir Magelis SCU, HMI
Controller, Guide de
programmation)
EIO0000000792 06/2017
83
Présentation des bibliothèques
Catégorie : Appareils
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Appareils :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
Altivar Library
SE_ATV
Consultez le document Guide
de la bibliothèque Altivar.
PH (FCL) SE_Altivar
Contrôle des variateurs
de vitesse ATV.
OUI
CANmotion Lexium Library
SEM_LXM_SM
Consultez le document Guide
version directe (FCL)
Fonctions
SM_Servo_Startup et
SM_Stepper_Startup et
composants
Vizualisation associés
pour faciliter la mise en
service des variateurs
de mouvement et
moteurs pas à pas.
OUI
de la bibliothèque CANmotion
Lexium.
GMC Independent Altivar
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIATV
(qualified-access-only)
version directe (FCL)
Blocs fonction Altivar
pour le contrôle de
mouvement général des
axes indépendants via
Industrial Ethernet.
OUI
GMC Independent Base
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIB
(qualified-access-only)
version directe (FCL)
Implémentations de
base (réservées à un
usage interne) pour le
contrôle de mouvement
général des axes
indépendants via
Industrial Ethernet.
NON
GMC Independent Base
Device
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIBD
(qualified-access-only)
version directe (FCL)
Implémentations
d'équipement standard
(réservées à un usage
interne) pour le contrôle
de mouvement général
des axes indépendants
via Industrial Ethernet.
NON
GMC Independent CANopen
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GICAN
(qualified-access-only)
version directe (FCL)
Blocs fonction PLCopen
pour le contrôle de
mouvement général des
axes indépendants via
CANopen.
NON
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
84
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
GMC Independent
EtherNetIP
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIEIP
(qualified-access-only)
PH GMC Independent
EtherNetIP
Embase EtherNet/IP
(réservée à une
utilisation interne) pour
le contrôle de
mouvement général des
axes indépendants.
NON
GMC Independent
EtherNetIP CIFX
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIEIP
(qualified-access-only)
PH GMC Independent
EtherNetIP
Embase EtherNet/IP
NON
(réservée à une
utilisation interne) pour
le contrôle de
mouvement général des
axes indépendants avec
le LMC078.
GMC Independent Interfaces GIITF
Reportez-vous au document (qualified-access-only)
Guide de la bibliothèque
Motion Control
version directe (FCL)
Interfaces (réservées à NON
un usage interne) pour le
contrôle de mouvement
général des axes
indépendants via
Industrial Ethernet.
GMC Independent
ModbusTCP
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GITCP
(qualified-access-only)
version directe (FCL)
Embase Modbus TCP
(réservée à une
utilisation interne) pour
le contrôle de
mouvement général des
axes indépendants.
NON
GMC Independent Lexium
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GILXM
(qualified-access-only)
version directe (FCL)
Blocs fonction Lexium
pour le contrôle de
mouvement général des
axes indépendants via
Industrial Ethernet.
OUI
GMC Independent PLCopen
MC
Reportez-vous au document
Guide de la bibliothèque
Motion Control
GIPLC
(qualified-access-only)
version directe (FCL)
Blocs fonction PCLopen
pour le contrôle de
mouvement général des
axes indépendants via
Industrial Ethernet.
OUI
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
(voir SoMachine, Guide des
bibliothèques Motion Control)
EIO0000000792 06/2017
85
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
Integrated Lexium Library
SEM_ILX
Consultez le document Guide
PH (FCL)
SE_IntegratedLexium
Contrôle des variateurs
intégrés Lexium.
OUI
SEM_LXM
Lexium Library
Consultez le document Guide
de la bibliothèque Lexium.
PH (FCL) SE_Lexium
Contrôle des variateurs OUI
Lexium 32, Lexium 05 et
Lexium SD3 sur le bus
de terrain CANopen.
SEM_LXM23
Lexium 23 Library
Consultez le document Guide
de la bibliothèque Lexium 23.
version directe (FCL)
Contrôle des variateurs
Lexium 23 sur le bus de
terrain CANopen.
OUI
Lexium 28 Library
SEM_LXM28
Consultez le document Guide
de la bibliothèque Lexium 28.
version directe (FCL)
Contrôle des variateurs
Lexium 28 sur le bus de
terrain CANopen.
OUI
Lexium 32i Library
SEM_LXM32i
version directe (FCL)
Contrôle des variateurs
Lexium32i sur le bus de
terrain CANopen.
OUI
TeSys Library
Reportez-vous à la section
Bibliothèque TeSys
SE_TESYS
version directe (FCL)
Commande du
OUI
démarreur-contrôleur
TeSys U et du système
de gestion du moteur
TeSys T.
La bibliothèque offre des
blocs fonction pour la
commande générique
des moteurs à 1 ou
2 sens de marche et 1
ou 2 vitesses.
Harmony ZBRN
Consultez le document
Harmony ZBRN Library
ZBRN
version directe (FCL)
Fonctionnalités
permettant d'inclure des
boutons-poussoir sans
fil et sans batterie
Harmony commandés à
distance, dans
l'application.
OUI
FieldBusDevicesModbusTcp
SEMFDM
(qualified-access-only)
version directe (FCL)
Bibliothèque d'appareils
de bus de terrain avec
blocs fonction de bus de
terrain et spécifiques au
fournisseur.
OUI
de la bibliothèque Lexium
intégrée.
(voir SoMachine, Fonctions
des démarreurs de moteur
TeSys, Guide de la
bibliothèque TeSys).
(voir SoMachine, Scrutation
des boutons liés aux modules
ZBRN, Guide de la
bibliothèque Harmony
ZBRN).
86
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
FieldBusDevicesPlcOpen
SEMFDP
(qualified-access-only)
version directe (FCL)
Bibliothèque PLCopen
d'équipements de bus
de terrain équipés de
blocs fonction de
commande de
mouvement.
OUI
TM3Safety
TMSF
version directe (FCL)
Le module de sécurité
OUI
TM3 permet d'incorporer
des fonctionnalités de
sécurité dans
l'environnement TM3
des plates-formes M2••.
TM3TesysU
TSU
version directe (FCL)
Bibliothèque de modules OUI
TeSys pour démarreurs
de moteur.
EIO0000000792 06/2017
87
Présentation des bibliothèques
Catégorie : Intern
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Intern → IoDrivers :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
IoDrvEtherNetIPAdapter
IoDrvEtherNetIPAdapte
r
PH (FCL)
IoDrvEtherNetIP
Adapter
Adaptateur EtherNet/IP
NON
IoDrvPROFIBUSDPV1Slave
IoDrvPROFIBUSDPV1
SlaveLib
PH (FCL)
IoDrvPROFIBUSDPV
1Slave
Bibliothèque d'esclaves
PROFIBUS DP utilisée
pour gérer le module
TM5PCDPS.
NON
IoDrvSlave
IoDrvSlaveLib
PH (FCL) IoDrvSlave
Bibliothèque
NON
d'équipements esclaves
étendue par
IoDrvPROFIBUSDPV1S
lave.
IoDrvModbusSerial
IoDrvModbusSerial
PH (FCL)
SE_ModbusIO
Scanner
Gestion de la scrutation NON
des E/S des
équipements Modbus
pour le gestionnaire
Modbus_IOScanner
(pour plus d'informations
sur la configuration du
gestionnaire Modbus,
reportez-vous à l'aide en
ligne Editeurs
d'équipement / Editeur
de configuration Modbus
/ Editeur de
configuration Modbus /
Editeur d'équipement
Modbus)
Catégorie : Solution
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Solution :
88
EIO0000000792 06/2017
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
Hoisting
Consultez le document
Hoisting Library Guide
SE_HOIST
version directe (FCL)
Blocs fonction des
applications de levage.
OUI
Hoisting_Basic
Consultez le document
Hoisting Library Guide
SE_HOIST
version directe (FCL)
Blocs fonction
d'applications de levage
standard
OUI
PackML
reportez-vous à la section
Bibliothèque PackML
PackML
(qualified-access-only)
version directe (FCL)
Blocs fonction,
structures et cadres de
visualisation pour la
gestion des données et
la gestion du mode de
fonctionnement,
conformément à
PackML, comme défini
par ISA-TR88.00.02.
OUI
Packaging
Consultez le document
Packaging Library Guide
SE_PACK
version directe (FCL)
Blocs fonction
d'applications de
conditionnement
OUI
Pumping
Consultez le document
Pumping Library Guide
Pump
version directe
Blocs fonction
d'applications de
pompage.
OUI
version directe (FCL)
Blocs fonction collectant OUI
des données
énergétiques sur chaque
équipement et
récapitulant la
consommation
électrique de la
machine.
(voir SoMachine, Hoisting
Application Functions,
Hoisting Library Guide).
(voir SoMachine, Hoisting
Application Functions,
Hoisting Library Guide).
(voir PackML, Guide de la
bibliothèque).
(voir SoMachine, Packaging
Application Functions,
Packaging Library Guide).
(voir SoMachine, Booster
Pumping Application
Functions, Pumping Library
Guide).
EET
EnergyEfficiencyToolbox
Consultez le document Guide
de la bibliothèque
EnergyEfficiencyToolbox
(voir Energy Efficiency
Toolbox, Guide de la
bibliothèque).
EIO0000000792 06/2017
89
Présentation des bibliothèques
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
MED
MachineEnergyDashboard
Consultez le document Guide
de la bibliothèque Machine
Energy Dashboard
version directe (FCL)
Informations fournies
par la bibliothèque
EnergyEfficiencyToolbo
x et permettant
d'analyser le rendement
énergétique d'une
machine.
OUI
ModbusEnergyEfficiencyTool MEET
box
Consultez le document Guide
de la bibliothèque
ModbusEnergyEfficiencyTool
box (voir Modbus Energy
version directe (FCL)
Blocs fonction collectant OUI
des données
énergétiques sur
certains équipements
Modbus et récapitulant
la consommation
électrique de la
machine.
(voir SoMachine, Guide de la
bibliothèque Machine Energy
Dashboard).
Efficiency Toolbox, Guide de
la bibliothèque).
90
EIO0000000792 06/2017
Présentation des bibliothèques
Catégorie : Système
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Système :
Nom
Espace de nom
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
FtpBase
SE_FtpBase
PH SE_FtpBase
Fonctionnalités
principales du protocole
FTP (File Transfer
Protocol). La
bibliothèque
FtpRemoteFileHandling
constitue l'interface
utilisateur.
NON
LMC078 PLCSystem
Consultez le document
LMC078 Motion Controller Guide de la bibliothèque
PLCSystem (voir Modicon
SEC
version directe
Fonctions et variables
système LMC078
OUI
LMC078 Sercos3
S3
version directe
Bibliothèque Sercos3
pour LMC078
OUI
SystemConfigurationAddExt
ends
SystemConfigurationAd PH
dExtends
SystemConfiguration
AddExtends
Fournit des
implémentations de
base à partir desquelles
dériver les POU dans
SystemConfiguration.
NON
SystemConfigurationItf
SystemConfigurationItf
PH
SystemConfiguration
Itf
Bibliothèque de
l'interface de
configuration de
système, utilisée par la
bibliothèque
IoDrvTM5PCDPS
NON
SystemInterface
SystemInterface
PH SystemInterface
Bibliothèque système
utilisée par la
bibliothèque
IoDrvTM5PCDPS.
NON
LMC078 Motion Controller,
Fonctions et variables
système, Guide de la
bibliothèque PLCSystem )
EIO0000000792 06/2017
91
Présentation des bibliothèques
Catégorie : Util
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Util :
Nom
Espace de nom
FileFormatUtility
Consultez la section
Bibliothèque FileFormatUtility
FFU
version directe (FCL) La bibliothèque fournit
(qualified-access-only)
des fonctionnalités
permettant de générer
ou de lire des fichiers
respectant différents
formats (XML et CSV,
par exemple). Ces
fichiers servent à
échanger des données
entre l'application du
contrôleur et des
systèmes externes
(autres contrôleurs,
services Web, système
MES…).
(voir SoMachine,
FileFormatUtility, Guide de la
bibliothèque).
SE_TBX
Toolbox
Consultez le document Guide de
la bibliothèque Toolbox
(voir SoMachine, Fonctions
diverses, Guide de la
bibliothèque Toolbox).
Référencer la
bibliothèque en tant
que
Description
UTILIS
ATEUR
OUI
version directe (FCL) Jeu de fonctions
utilitaires et de blocs
fonction complétant les
bibliothèques Standard
et Util déclarées
automatiquement.
OUI
PH (FCL)
Fonctions utilisées pour
SE_ToolboxAdvance obtenir et définir
l'intervalle d'une tâche
cyclique.
OUI
Toolbox_Advance
Reportez-vous à la section
Toolbox_Advance
SE_TBXADV
FieldBusDevicesBase
SEMFDB
version directe (FCL) Bibliothèque de base
(qualified-access-only)
d'appareils de bus de
terrain.
NON
FieldBusDevicesItf
SEMFDI
version directe (FCL) Bibliothèque d'interface
(qualified-access-only)
d'appareils de bus de
terrain.
NON
TwidoEmulationSupport
Reportez-vous à la section
Bibliothèque
TwidoEmulationSupport
TES
version directe (FCL) Blocs fonction utilisés
(qualified-access-only)
par les projets
SoMachine Basic et
Twido convertis en
projets SoMachine.
NON
(voir SoMachine, Gestion d'un
intervalle de tâche cyclique,
Guide de bibliothèque
Toolbox_Advance).
(voir Twido Emulation Support,
Guide de la bibliothèque).
92
EIO0000000792 06/2017
Présentation des bibliothèques
Autres bibliothèques utilisées dans SoMachine
Introduction
Les bibliothèques utiles issues de sociétés autres que Schneider Electric sont mentionnées cidessous.
Pour plus d'informations sur l'utilisation des tableaux ci-dessous, reportez-vous à la présentation
des bibliothèques Schneider Electric (voir page 70).
3S - Bibliothèques Smart Software Solutions GmbH
Les bibliothèques contenues dans les catégories Intern et Système sont destinées à un usage
interne et ne sont pas disponibles pour des applications utilisateur. Ces bibliothèques sont
repérées dans la colonne UTILISATEUR des tableaux suivants par le mot NON. Celles qui sont
destinées à des applications utilisateur sont repérées par le mot OUI.
Bibliothèques disponibles dans la catégorie Use Cases : bibliothèques conteneurs regroupant des
bibliothèques CAA sur un sujet commun (pour plus d'informations sur les fonctions CAA, reportezvous à la section CoDeSys Libraries / CAA Libraries).
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Intern → SoftMotion :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILIS
ATEUR
SM3_Basic
SM3_Basic
PH
SM3_Basic
Fonctions destinées à la gestion de OUI
base SoftMotion (pour plus
d'informations sur la gestion de
base, reportez-vous à la section
CoDeSys Libraries / SoftMotion
Libraries).
NOTE : Cette bibliothèque n'est
prise en charge que sur Modicon
LMC058 Motion Controller.
SM3_CNC
SM3_CNC
OUI
PH SM3_CNC Fonctions destinées à la gestion
CNC SoftMotion (pour plus
d'informations sur la gestion CNC,
reportez-vous à la section CoDeSys
Libraries / SoftMotion Libraries).
NOTE : Cette bibliothèque n'est
prise en charge que sur Modicon
LMC058 Motion Controller.
SM3_Drive_•••
EIO0000000792 06/2017
–
–
Bibliothèques de gestion des
systèmes SoftMotion (pour plus
d'informations, reportez-vous à la
section CoDeSys Libraries /
SoftMotion Libraries).
NON
93
Présentation des bibliothèques
Bibliothèques système
Le tableau suivant décrit la bibliothèque disponible dans la catégorie (Divers) :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILIS
ATEUR
CmpEventMgr
CmpEventMgr PH
Bibliothèque de gestion de système
CmpEventMgr d'événements.
NON
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Application → Général :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILIS
ATEUR
Standard64
Standard64
PH
Standard64
Fonctions pour la gestion de longues chaînes de
caractères et de temporisateurs longue durée.
OUI
Standard
Standard
PH Standard
Fonctions et blocs fonction standard de programmation
CEI (pour plus d'informations sur les fonctions standard,
reportez-vous à la section CoDeSys Libraries / Standard
Library).
OUI
Util
Util
PH Util
OUI
Fonctions supplémentaires et blocs fonction de
programmation (pour plus d'informations sur les fonctions
supplémentaires, reportez-vous à la section CoDeSys
Libraries / Util Library).
Bibliothèques disponibles dans la catégorie Intern : certaines sont réservées à un usage interne.
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Système → SysLibs :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILISA
TEUR
Cmp•••
Sys•••
ISys•••
–
–
Bibliothèques de gestion système
NON
SysTime
Reportez-vous à la section Gestion
de l'horodateur (voir SoMachine,
SysTime
PH SysTime
Gestion de l'horodateur du
contrôleur.
OUI
Affichage et réglage de l'horodateur,
Guide des bibliothèques SysTimeRtc
et SysTimeCore).
94
EIO0000000792 06/2017
Présentation des bibliothèques
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Système → SysLibs23 :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILISA
TEUR
Sys•••23
–
–
Bibliothèques de gestion système
pour la migration de projets
CoDeSys v2.3.
NON
Bibliothèques de groupe de travail technique CAA
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Application → CAA :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILISA
TEUR
CAA•••
–
–
Bibliothèques du groupe de travail
CoDeSys Automation Alliance
(pour plus d'informations sur les
fonctions CAA, reportez-vous à la
section CoDeSys Libraries / CAA
Libraries).
NON
CAA CiA 405
CIA405
(qualifiedaccess-only)
PH CAA
CiA405
Blocs fonction pour la gestion de
OUI
bus de terrain CANopen à partir de
l'application.
Le tableau suivant décrit les bibliothèques disponibles dans la catégorie Intern → CAA :
Nom
Espace de
nom
Référencer la
bibliothèque
en tant que
Description
UTILISA
TEUR
CAA•••
–
–
Bibliothèques du groupe de travail
CoDeSys Automation Alliance
(pour plus d'informations sur les
fonctions CAA, reportez-vous à la
section CoDeSys Libraries / CAA
Libraries).
NON
CAA Net Base Services
NBS
(qualifiedaccess-only)
PH
CAA NetBase
Srv
Bibliothèque mettant en place un
ensemble de services Ethernet
fondamentaux, composé d'un
serveur TCP, d'un client TCP et
d'un homologue UDP.
OUI*
* N'utilisez pas cette bibliothèque avec la bibliothèque TcpUdpCommunication (Schneider Electric) ni avec
des bibliothèques mettant en place la bibliothèque TcpUdpCommunication. Utilisez TcpUdpCommunication
au lieu de CAA Net Base Services.
EIO0000000792 06/2017
95
Présentation des bibliothèques
96
EIO0000000792 06/2017
SoMachine
Représentation des fonctions et blocs fonction
EIO0000000792 06/2017
Chapitre 6
Représentation des fonctions et blocs fonction
Représentation des fonctions et blocs fonction
Présentation
Chaque fonction peut être représentée dans les langages suivants :
IL : (Instruction List) liste d'instructions
 ST : (Structured Text) littéral structuré
 LD : (Ladder Diagram) schéma à contacts
 FBD : Function Block Diagram (Langage à blocs fonction)
 CFC : Continuous Function Chart (Diagramme fonctionnel continu)

Ce chapitre fournit des exemples de représentations de fonctions et blocs fonction et explique
comment les utiliser dans les langages IL et ST.
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
Différences entre une fonction et un bloc fonction
98
Utilisation d'une fonction ou d'un bloc fonction en langage IL
99
Utilisation d'une fonction ou d'un bloc fonction en langage ST
103
EIO0000000792 06/2017
97
Représentation des fonctions et blocs fonction
Différences entre une fonction et un bloc fonction
Fonction
Une fonction :
est une POU (Program Organization Unit ou unité organisationnelle de programme) qui renvoie
un résultat immédiat ;
 est directement appelée par son nom (et non par une instance) ;
 ne conserve pas son état entre deux appels ;
 peut être utilisée en tant qu'opérande dans des expressions.

Exemples : opérateurs booléens (AND), calculs, conversions (BYTE_TO_INT)
Bloc fonction
Un bloc fonction :
 est une POU qui renvoie une ou plusieurs sorties ;
 doit être appelé par une instance (copie de bloc fonction avec nom et variables dédiées).
 Chaque instance conserve son état (sorties et variables internes) entre deux appels à partir
d'un bloc fonction ou d'un programme.
Exemples : temporisateurs, compteurs
Dans l'exemple, Timer_ON est une instance du bloc fonction TON :
98
EIO0000000792 06/2017
Représentation des fonctions et blocs fonction
Utilisation d'une fonction ou d'un bloc fonction en langage IL
Informations générales
Cette partie explique comment mettre en œuvre une fonction et un bloc fonction en langage IL.
Les fonctions IsFirstMastCycle et SetRTCDrift, ainsi que le bloc fonction TON, sont utilisés
à titre d'exemple pour illustrer les mises en œuvre.
Utilisation d'une fonction en langage IL
La procédure suivante explique comment insérer une fonction en langage IL :
Etape
1
Action
Ouvrez ou créez une POU en langage IL (Instruction List, ou liste d'instructions).
NOTE : La procédure de création d'un POU n'est pas détaillée ici. Pour plus d'informations,
reportez-vous à la section Ajout et appel de POU (voir SoMachine, Guide de programmation).
2
Créez les variables nécessaires à la fonction.
3
Si la fonction possède une ou plusieurs entrées, chargez la première entrée en utilisant
l'instruction LD.
4
Insérez une nouvelle ligne en dessous et :
 saisissez le nom de la fonction dans la colonne de l'opérateur (champ de gauche), ou
 utilisez l'Aide à la saisie pour sélectionner la fonction (sélectionnez Insérer l'appel de module
dans le menu contextuel).
5
Si la fonction a plus d'une entrée et que l'assistant Aide à la saisie est utilisé, le nombre requis de
lignes est automatiquement créé avec ??? dans les champs situés à droite. Remplacez les ??? par
la valeur ou la variable appropriée compte tenu de l'ordre des entrées.
6
insérez une nouvelle ligne pour stocker le résultat de la fonction dans la variable appropriée :
saisissez l'instruction ST dans la colonne de l'opérateur (champ de gauche) et le nom de la variable
dans le champ de droite.
EIO0000000792 06/2017
99
Représentation des fonctions et blocs fonction
Pour illustrer la procédure, utilisons les fonctions IsFirstMastCycle (sans paramètre d'entrée)
et SetRTCDrift (avec paramètres d'entrée) représentées graphiquement ci-après :
Fonction
Représentation graphique
sans paramètre d'entrée :
IsFirstMastCycle
avec paramètres d'entrée :
SetRTCDrift
En langage IL, le nom de la fonction est utilisé directement dans la colonne de l'opérateur :
Fonction
Représentation dans l'éditeur IL de POU
Exemple en IL d'une
fonction sans paramètre
d'entrée :
IsFirstMastCycle
100
EIO0000000792 06/2017
Représentation des fonctions et blocs fonction
Fonction
Représentation dans l'éditeur IL de POU
Exemple IL d'une
fonction avec des
paramètres d'entrée :
SetRTCDrift
Utilisation d'un bloc fonction en langage IL
La procédure suivante explique comment insérer un bloc fonction en langage IL :
Etape Action
1
Ouvrez ou créez un POU en langage IL (Instruction List, ou liste d'instructions).
NOTE : La procédure de création d'un POU n'est pas détaillée ici. Pour plus d'informations, reportezvous à la section Ajout et appel de POU (voir SoMachine, Guide de programmation).
2
Créez les variables nécessaires au bloc fonction (y compris le nom de l'instance).
3
L'appel de blocs fonction nécessite l'utilisation d'une instruction CAL :
 Utilisez l'Aide à la saisie pour sélectionner le bloc fonction (cliquez avec le bouton droit et
sélectionnez Insérer l'appel de module dans le menu contextuel).
 L'instruction CAL et les E/S nécessaires sont automatiquement créées.
Chaque paramètre (E/S) est une instruction :
 Les valeurs des entrées sont définies à l'aide de « := ».
 Les valeurs des sorties sont définies à l'aide de « => ».
4
Dans le champ CAL de droite, remplacez les ??? par le nom de l'instance.
5
Remplacez les autres ??? par une variable ou une valeur immédiate appropriée.
EIO0000000792 06/2017
101
Représentation des fonctions et blocs fonction
Pour illustrer la procédure, utilisons le bloc fonction TON représenté graphiquement ci-après :
Bloc fonction
Représentation graphique
TON
En langage IL, le nom du bloc fonction est utilisé directement dans la colonne de l'opérateur :
Bloc fonction
Représentation dans l'éditeur IL de POU
TON
102
EIO0000000792 06/2017
Représentation des fonctions et blocs fonction
Utilisation d'une fonction ou d'un bloc fonction en langage ST
Informations générales
Cette partie décrit comment mettre en œuvre une fonction ou un bloc fonction en langage ST.
La fonction SetRTCDrift et le bloc fonction TON sont utilisés à titre d'exemple pour illustrer les
mises en œuvre.
Utilisation d'une fonction en langage ST
La procédure suivante explique comment insérer une fonction en langage ST :
Etape
Action
1
Ouvrez ou créez un POU en langage ST (Structured Text ou Littéral structuré).
NOTE : La procédure de création d'un POU n'est pas détaillée ici. Pour plus d'informations,
reportez-vous à la section Ajout et appel de POU (voir SoMachine, Guide de programmation).
2
Créez les variables nécessaires à la fonction.
3
Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'une
fonction. La syntaxe générale est la suivante :
RésultatFonction:= NomFonction(VarEntrée1, VarEntrée2, … VarEntréex);
Pour illustrer la procédure, utilisons la fonction SetRTCDrift représentée graphiquement ciaprès :
Fonction
Représentation graphique
SetRTCDrift
La représentation en langage ST de cette fonction est la suivante :
Fonction
Représentation dans l'éditeur ST de POU
SetRTCDrift
PROGRAM MyProgram_ST
VAR myDrift: SINT(-29..29) := 5;
myDay: DAY_OF_WEEK := SUNDAY;
myHour: HOUR := 12;
myMinute: MINUTE;
myRTCAdjust: RTCDRIFT_ERROR;
END_VAR
myRTCAdjust:= SetRTCDrift(myDrift, myDay, myHour, myMinute);
EIO0000000792 06/2017
103
Représentation des fonctions et blocs fonction
Utilisation d'un bloc fonction en langage ST
La procédure suivante explique comment insérer un bloc fonction en langage ST :
Etape Action
1
Ouvrez ou créez un POU en langage ST (Structured Text ou Littéral structuré).
NOTE : La procédure de création d'une POU n'est pas détaillée ici. Pour plus d'informations sur l'ajout, la
déclaration et l'appel de POU, reportez-vous à la documentation (voir SoMachine, Guide de programmation)
associée.
2
Créez les variables d'entrée, les variables de sortie et l'instance requises pour le bloc fonction :
 Les variables d'entrée sont les paramètres d'entrée requis par le bloc fonction.
 Les variables de sortie reçoivent la valeur renvoyée par le bloc fonction.
3
Utilisez la syntaxe générale dans l'éditeur ST de POU pour la représentation en langage ST d'un bloc fonction.
La syntaxe générale est la suivante :
BlocFonction_NomInstance(Entrée1:=VarEntrée1, Entrée2:=VarEntrée2,…
Sortie1=>VarSortie1, Sortie2=>VarSortie2,…);
Pour illustrer la procédure, utilisons le bloc fonction TON représenté graphiquement ci-après :
Bloc fonction
Représentation graphique
TON
Le tableau suivant montre plusieurs exemples d'appel de bloc fonction en langage ST :
Bloc fonction
Représentation dans l'éditeur ST de POU
TON
104
EIO0000000792 06/2017
SoMachine
Glossaire
EIO0000000792 06/2017
Glossaire
A
application
Programme comprenant des données de configuration, des symboles et de la documentation.
ASCII
ATV
Acronyme de American Standard Code for Information Interchange. Protocole utilisé pour
représenter les caractères alphanumériques (lettres, chiffres, ainsi que certains caractères
graphiques et de contrôle).
Préfixe utilisé pour les modèles de variateur Altivar (par exemple, ATV312 désigne le variateur de
vitesse Altivar 312).
B
bus d'extension
Bus de communication électronique entre des modules d'E/S d'extension et un contrôleur.
C
CFC
chaîne
CiA405
Acronyme de continuous function chart (diagramme fonctionnel continu). Langage de
programmation graphique (extension de la norme IEC 61131-3) basé sur le langage de diagramme
à blocs fonction et qui fonctionne comme un diagramme de flux. Toutefois, il n'utilise pas de
réseaux et le positionnement libre des éléments graphiques est possible, ce qui permet les boucles
de retour. Pour chaque bloc, les entrées se situent à gauche et les sorties à droite. Vous pouvez
lier les sorties de blocs aux entrées d'autres blocs pour créer des expressions complexes.
Variable composée d'une série de caractères ASCII.
Interface et profil d'appareil CANopen pour contrôleurs programmables IEC 61131-3 .
configuration
Agencement et interconnexions des composants matériels au sein d'un système, ainsi que les
paramètres matériels et logiciels qui déterminent les caractéristiques de fonctionnement du
système.
contrôleur
Automatise des processus industriels. On parle également de contrôleur logique programmable
(PLC) ou de contrôleur programmable.
EIO0000000792 06/2017
105
Glossaire
E
E/S
Entrée/sortie
équipement
Partie d'une machine comprenant des sous-ensembles tels que des transporteurs, des plaques
tournantes, etc.
étalonnage
Processus qui consiste à définir ou régler la précision d'un équipement de mesure en comparant
sa valeur à une référence connue et correcte.
F
FB
FCL
Acronyme de function block, bloc fonction. Mécanisme de programmation commode qui consolide
un groupe d'instructions de programmation visant à effectuer une action spécifique et normalisée
telle que le contrôle de vitesse, le contrôle d'intervalle ou le comptage. Un bloc fonction peut
comprendre des données de configuration, un ensemble de paramètres de fonctionnement interne
ou externe et généralement une ou plusieurs entrées et sorties de données.
Acronyme de forward compatible library, bibliothèque à compatibilité ascendante. Une
bibliothèque post-compatible est développée pour que ses fonctionnalités soient postcompatibles, ce qui signifie que chacune de ses versions reprend l'ensemble des fonctions de la
version précédente. Vous pouvez donc facilement utiliser une nouvelle version de bibliothèque
dans un projet existant, sans apporter aucune modification.
fonction
Unité de programmation possédant 1 entrée et renvoyant 1 résultat immédiat. Contrairement aux
blocs fonction (FBs), une fonction est appelée directement par son nom (et non via une instance),
elle n'a pas d'état persistant d'un appel au suivant et elle peut être utilisée comme opérande dans
d'autres expressions de programmation.
Exemples : opérateurs booléens (AND), calculs, conversion (BYTE_TO_INT).
FTP
106
Acronyme de File Transfer Protocol, protocole de transfert de fichiers. Protocole réseau standard
basé sur une architecture client-serveur qui sert à échanger et à manipuler des fichiers sur des
réseaux TCP/IP quelle que soit leur taille.
EIO0000000792 06/2017
Glossaire
I
IEC
IL
INT
IP
Acronyme de International Electrotechnical Commission, Commission Electrotechnique
Internationale (CEI). Organisation internationale non gouvernementale à but non lucratif, qui
rédige et publie les normes internationales en matière d'électricité, d'électronique et de domaines
connexes.
Acronyme de instruction list, liste d'instructions. Un programme écrit en langage IL est composé
d'instructions textuelles qui sont exécutées séquentiellement par le contrôleur. Chaque instruction
comprend un numéro de ligne, un code d'instruction et un opérande (voir la norme IEC 61131-3).
Abréviation de integer, nombre entier codé sur 16 bits.
Acronyme de Internet Protocol, protocole Internet. Le protocole IP fait partie de la famille de
protocoles TCP/IP, qui assure le suivi des adresses Internet des équipements, achemine les
messages sortants et reconnaît les messages entrants.
L
langage en blocs fonctionnels
Un des 5 langages de programmation de logique ou de commande pris en charge par la norme
IEC 61131-3 pour les systèmes de commande. FBD est un langage de programmation orienté
graphique. Il fonctionne avec une liste de réseaux où chaque réseau contient une structure
graphique de zones et de lignes de connexion représentant une expression logique ou
arithmétique, un appel de bloc fonction ou une instruction de retour.
LD
LMC
Acronyme de ladder diagram, schéma à contacts. Représentation graphique des instructions d'un
programme de contrôleur, avec des symboles pour les contacts, les bobines et les blocs dans une
série de réseaux exécutés séquentiellement par un contrôleur (voir IEC 61131-3).
(Lexium Motion Controller)
LMC058
Lexium Motion Controller, un contrôleur logique Modicon
EIO0000000792 06/2017
107
Glossaire
M
M258
Contrôleur logique Modicon M258
machine
Ensemble constitué de plusieurs fonctions et/ou équipements.
Modbus
Protocole qui permet la communication entre de nombreux équipements connectés au même
réseau.
O
octet
Type codé sur 8 bits, de 00 à FF au format hexadécimal.
P
POU
Acronyme de program organization unit, unité organisationnelle de programme. Déclaration de
variables dans le code source et jeu d'instructions correspondant. Les POUs facilitent la
réutilisation modulaire de programmes logiciels, de fonctions et de blocs fonction. Une fois
déclarées, les POUs sont réutilisables.
programme
Composant d'une application constitué de code source compilé qu'il est possible d'installer dans
la mémoire d'un contrôleur logique.
protocole
Convention ou définition standard qui contrôle ou permet la connexion, la communication et le
transfert de données entre 2 systèmes informatiques et leurs équipements.
PTO
PWM
108
Acronyme de pulse train output, sortie à train d'impulsions. Sortie rapide qui oscille entre OFF et
ON au cours d'un cycle de service 50-50 fixe, ce qui produit une forme d'onde carrée. Les sorties
PTO conviennent particulièrement pour les applications telles que les moteurs pas à pas, les
convertisseurs de fréquence et le contrôle servomoteur.
Acronyme de pulse width modulation, modulation de largeur d'impulsion. Sortie rapide qui oscille
entre OFF et ON au cours d'un cycle de service réglable, ce qui produit une forme d'onde
rectangulaire (ou carrée selon le réglage).
EIO0000000792 06/2017
Glossaire
R
réseau
Système d'équipements interconnectés qui partageant un chemin de données et un protocole de
communications communs.
réseau de commande
Réseau incluant des contrôleurs logiques, des systèmes SCADA, des PC, des IHM, des
commutateurs, etc.
Deux types de topologies sont pris en charge :
à plat : tous les modules et équipements du réseau appartiennent au même sous-réseau.
 à 2 niveaux : le réseau est divisé en un réseau d'exploitation et un réseau intercontrôleurs.

Ces deux réseaux peuvent être indépendants physiquement, mais ils sont généralement liés par
un équipement de routage.
S
SNMP
SNTP
SQL
ST
Acronyme de simple network management protocol, protocole de gestion de réseau simple.
Protocole qui peut contrôler un réseau à distance en interrogeant les équipements pour obtenir
leur état et en affichant les informations liées à la transmission de données. Il peut aussi être utilisé
pour gérer des logiciels et des bases de données à distance, et il permet d'effectuer des tâches de
gestion actives, comme la modification et l'application d'une nouvelle configuration.
(Simple Network Time Protocol) Version simplifiée du protocole NTP (Network Time Protocol). Il
permet de synchroniser l'heure sur des ordinateurs en réseau. Il utilise le temps universel
coordonné (Coordinated Universal Time, UTC) pour synchroniser les horloges des ordinateurs à
une milliseconde, et parfois à une fraction de milliseconde.
Le SQL (Structured Query Language) est un langage de programmation qui permet de gérer les
données stockées dans les systèmes de gestion de bases de données relationnelles (SGBDR).
Acronyme de structured text, texte structuré. Langage composé d'instructions complexes et
d'instructions imbriquées (boucles d'itération, exécutions conditionnelles, fonctions). Le langage
ST est conforme à la norme IEC 61131-3.
symbole
Chaîne de 32 caractères alphanumériques maximum, dont le premier caractère est alphabétique.
Les symboles permettent de personnaliser les objets du contrôleur afin de faciliter la maintenance
de l'application.
EIO0000000792 06/2017
109
Glossaire
T
tâche cyclique
Le temps de scrutation cyclique a une durée fixe (intervalle) spécifiée par l'utilisateur. Si le temps
de scrutation réel est plus court que le temps de scrutation cyclique, le contrôleur attend que le
temps de scrutation cyclique soit écoulé avant de commencer une nouvelle scrutation.
TCP
Acronyme de transmission control protocol, protocole de contrôle de transmission. Protocole de
couche de transport basé sur la connexion qui assure la transmission de données simultanée dans
les deux sens. Le protocole TCP fait partie de la suite de protocoles TCP/IP.
U
UDP
Acronyme de User Datagram Protocol, protocole de datagramme utilisateur. Protocole de mode
sans fil (défini par la norme IETF RFC 768) dans lequel les messages sont livrés dans un
datagramme vers un ordinateur cible sur un réseau IP. Le protocole UDP est généralement fourni
en même temps que le protocole Internet. Les messages UDP/IP n'attendent pas de réponse et,
de ce fait, ils sont particulièrement adaptés aux applications dans lesquelles aucune
retransmission des paquets envoyés n'est nécessaire (comme dans la vidéo en continu ou les
réseaux exigeant des performances en temps réel).
V
variable
Unité de mémoire qui est adressée et modifiée par un programme.
variable système
Variable qui fournit des données de contrôleur et des informations de diagnostic et permet
d'envoyer des commandes au contrôleur.
110
EIO0000000792 06/2017
SoMachine
Index
EIO0000000792 06/2017
Index
B
bibliothèques, 11
F
fonctions
différences entre une fonction et un bloc
fonction, 98
utilisation d'une fonction ou d'un bloc
fonction en langage IL, 99
utilisation d'une fonction ou d'un bloc
fonction en langage ST, 103
G
Gestionnaire de bibliothèques, 11
L
LanguageModelAttribute, 37, 62
R
Référentiel de bibliothèques, 11
EIO0000000792 06/2017
111
">