Schneider Electric SoMachine - EMailHandling Mode d'emploi

SoMachine
EIO0000002424 06/2017
SoMachine
EMailHandling
Guide de la bibliothèque
EIO0000002424.01
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.
Vous acceptez de ne pas reproduire, excepté pour votre propre usage à titre non commercial, tout
ou partie de ce document et sur quelque support que ce soit sans l'accord écrit de Schneider
Electric. Vous acceptez également de ne pas créer de liens hypertextes vers ce document ou son
contenu. Schneider Electric ne concède aucun droit ni licence pour l'utilisation personnelle et non
commerciale du document ou de son contenu, sinon une licence non exclusive pour une
consultation « en l'état », à vos propres risques. Tous les autres droits sont réservés.
Toutes les réglementations locales, régionales et nationales pertinentes doivent être respecté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
EIO0000002424 06/2017
Table des matières
Consignes de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . .
A propos de ce manuel. . . . . . . . . . . . . . . . . . . . . . . . . .
Partie I Informations générales . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 1 Informations spécifiques de sécurité . . . . . . . . . . . . . . .
Qualification du Personnel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instructions d'utilisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Informations relatives au produit . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 2 Présentation de la bibliothèque . . . . . . . . . . . . . . . . . . .
Informations générales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Partie II Énumérations et Structures . . . . . . . . . . . . . . . . . . .
Chapitre 3 Énumérations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_AuthenticationMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_EMailStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ET_Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 4 Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ST_CredentialsSendEMail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ST_CredentialsReceiveEMail. . . . . . . . . . . . . . . . . . . . . . . . . . .
ST_EMail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Partie III Variables globales . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 5 Liste des paramètres globaux. . . . . . . . . . . . . . . . . . . . .
Liste des paramètres globaux (GPL) . . . . . . . . . . . . . . . . . . . . . . . . . .
Partie IV Unités d'organisation de programme (POU) . . . . . . .
Chapitre 6 Blocs fonction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FB_SendEMail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FB_Pop3EMailClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 7 Fonctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FC_EtResultToString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annexes
EIO0000002424 06/2017
.........................................
5
9
11
13
14
14
15
19
19
23
25
26
27
28
30
31
32
37
38
39
41
43
45
45
47
49
50
53
59
59
61
3
Annexe A 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
63
64
65
69
73
77
EIO0000002424 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.
EIO0000002424 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.
AVANT DE COMMENCER
N'utilisez pas ce produit sur les machines non pourvues de protection efficace du point de fonctionnement. L'absence de ce type de protection sur une machine présente un risque de blessures
graves pour l'opérateur.
AVERTISSEMENT
EQUIPEMENT NON PROTEGE


N'utilisez pas ce logiciel ni les automatismes associés sur des appareils non équipés de
protection du point de fonctionnement.
N'accédez pas aux machines pendant leur fonctionnement.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
Cet automatisme et le logiciel associé permettent de commander des processus industriels divers.
Le type ou le modèle d'automatisme approprié pour chaque application dépendra de facteurs tels
que la fonction de commande requise, le degré de protection exigé, les méthodes de production,
des conditions inhabituelles, la législation, etc. Dans certaines applications, plusieurs processeurs
seront nécessaires, notamment lorsque la redondance de sauvegarde est requise.
Vous seul, en tant que constructeur de machine ou intégrateur de système, pouvez connaître
toutes les conditions et facteurs présents lors de la configuration, de l'exploitation et de la
maintenance de la machine, et êtes donc en mesure de déterminer les équipements automatisés,
ainsi que les sécurités et verrouillages associés qui peuvent être utilisés correctement. Lors du
choix de l'automatisme et du système de commande, ainsi que du logiciel associé pour une
application particulière, vous devez respecter les normes et réglementations locales et nationales
en vigueur. Le document National Safety Council's Accident Prevention Manual (reconnu aux
Etats-Unis) fournit également de nombreuses informations utiles.
Dans certaines applications, telles que les machines d'emballage, une protection supplémentaire,
comme celle du point de fonctionnement, doit être fournie pour l'opérateur. Elle est nécessaire si
les mains ou d'autres parties du corps de l'opérateur peuvent entrer dans la zone de point de
pincement ou d'autres zones dangereuses, risquant ainsi de provoquer des blessures graves. Les
produits logiciels seuls, ne peuvent en aucun cas protéger les opérateurs contre d'éventuelles
blessures. C'est pourquoi le logiciel ne doit pas remplacer la protection de point de fonctionnement
ou s'y substituer.
6
EIO0000002424 06/2017
Avant de mettre l'équipement en service, assurez-vous que les dispositifs de sécurité et de
verrouillage mécaniques et/ou électriques appropriés liés à la protection du point de fonctionnement ont été installés et sont opérationnels. Tous les dispositifs de sécurité et de verrouillage
liés à la protection du point de fonctionnement doivent être coordonnés avec la programmation des
équipements et logiciels d'automatisation associés.
NOTE : La coordination des dispositifs de sécurité et de verrouillage mécaniques/électriques du
point de fonctionnement n'entre pas dans le cadre de cette bibliothèque de blocs fonction, du
Guide utilisateur système ou de toute autre mise en œuvre référencée dans la documentation.
DEMARRAGE ET TEST
Avant toute utilisation de l'équipement de commande électrique et des automatismes en vue d'un
fonctionnement normal après installation, un technicien qualifié doit procéder à un test de
démarrage afin de vérifier que l'équipement fonctionne correctement. Il est essentiel de planifier
une telle vérification et d'accorder suffisamment de temps pour la réalisation de ce test dans sa
totalité.
AVERTISSEMENT
RISQUES INHERENTS AU FONCTIONNEMENT DE L'EQUIPEMENT



Assurez-vous que toutes les procédures d'installation et de configuration ont été respectées.
Avant de réaliser les tests de fonctionnement, retirez tous les blocs ou autres cales
temporaires utilisés pour le transport de tous les dispositifs composant le système.
Enlevez les outils, les instruments de mesure et les débris éventuels présents sur
l'équipement.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
Effectuez tous les tests de démarrage recommandés dans la documentation de l'équipement.
Conservez toute la documentation de l'équipement pour référence ultérieure.
Les tests logiciels doivent être réalisés à la fois en environnement simulé et réel.
Vérifiez que le système entier est exempt de tout court-circuit et mise à la terre temporaire non
installée conformément aux réglementations locales (conformément au National Electrical Code
des Etats-Unis, par exemple). Si des tests diélectriques sont nécessaires, suivez les recommandations figurant dans la documentation de l'équipement afin d'éviter de l'endommager
accidentellement.
Avant de mettre l'équipement sous tension :
 Enlevez les outils, les instruments de mesure et les débris éventuels présents sur l'équipement.
 Fermez le capot du boîtier de l'équipement.
 Retirez toutes les mises à la terre temporaires des câbles d'alimentation entrants.
 Effectuez tous les tests de démarrage recommandés par le fabricant.
EIO0000002424 06/2017
7
FONCTIONNEMENT ET REGLAGES
Les précautions suivantes sont extraites du document NEMA Standards Publication ICS 7.1-1995
(la version anglaise prévaut) :
 Malgré le soin apporté à la conception et à la fabrication de l'équipement ou au choix et à
l'évaluation des composants, des risques subsistent en cas d'utilisation inappropriée de
l'équipement.
 Il arrive parfois que l'équipement soit déréglé accidentellement, entraînant ainsi un fonctionnement non satisfaisant ou non sécurisé. Respectez toujours les instructions du fabricant pour
effectuer les réglages fonctionnels. Les personnes ayant accès à ces réglages doivent
connaître les instructions du fabricant de l'équipement et les machines utilisées avec
l'équipement électrique.
 Seuls ces réglages fonctionnels, requis par l'opérateur, doivent lui être accessibles. L'accès aux
autres commandes doit être limité afin d'empêcher les changements non autorisés des
caractéristiques de fonctionnement.
8
EIO0000002424 06/2017
A propos de ce manuel
Présentation
Objectif du document
Ce document décrit la bibliothèque EmailHandling.
Cette bibliothèque permet à votre contrôleur d'envoyer des e-mails avec pièces-jointes à un ou
plusieurs destinataires en personnalisant le contenu, et de recevoir des e-mails d'un ou plusieurs
expéditeurs.
La bibliothèque EmailHandling utilise des fonctions et des ressources système qui sont prises en
charge sur certaines plates-formes de contrôleur :
Modicon M241 Logic Controller
Modicon M251 Logic Controller
Modicon M258 Logic Controller
Modicon LMC078 Motion Controller
Modicon LMC058 Motion Controller





Champ d'application
Ce document a été actualisé pour le lancement de SoMachine V4.3.
Les caractéristiques techniques des équipements décrits dans ce document sont également
fournies en ligne. Pour accéder à ces informations en ligne :
Etape
Action
1
Accédez à la page d'accueil de Schneider Electric www.schneider-electric.com.
2
Dans la zone Search, saisissez la référence d'un produit ou le nom d'une gamme de produits.
 N'insérez pas d'espaces dans la référence ou la gamme de produits.
 Pour obtenir des informations sur un ensemble de modules similaires, utilisez des
astérisques (*).
3
Si vous avez saisi une référence, accédez aux résultats de recherche Product Datasheets et
cliquez sur la référence qui vous intéresse.
Si vous avez saisi une gamme de produits, accédez aux résultats de recherche Product Ranges
et cliquez sur la gamme de produits qui vous intéresse.
4
Si plusieurs références s'affichent dans les résultats de recherche Products, cliquez sur la
référence qui vous intéresse.
5
Selon la taille de l'écran, vous serez peut-être amené à faire défiler la page pour consulter la fiche
technique.
6
Pour enregistrer ou imprimer une fiche technique au format .pdf, cliquez sur Download XXX
product datasheet.
EIO0000002424 06/2017
9
Les caractéristiques présentées dans ce manuel devraient être identiques à celles fournies en
ligne. Toutefois, en application de notre politique d'amélioration continue, nous pouvons être
amenés à réviser le contenu du document afin de le rendre plus clair et plus précis. Si vous
constatez une différence entre le manuel et les informations fournies en ligne, utilisez ces
dernières en priorité.
Documents à consulter
Titre du document
Référence
SoMachine - Fonctions et bibliothèques - Guide de
l'utilisateur
EIO0000000735 (ENG) ;
EIO0000000792 (FRE) ;
EIO0000000793 (GER) ;
EIO0000000795 (SPA) ;
EIO0000000794 (ITA) ;
EIO0000000796 (CHS)
SoMachine - Guide de programmation
EIO0000000067 (ENG) ;
EIO0000000069 (FRE) ;
EIO0000000068 (GER) ;
EIO0000000071 (SPA) ;
EIO0000000070 (ITA) ;
EIO0000000072 (CHS)
Vous pouvez télécharger ces publications ainsi que d'autres informations techniques sur notre site
Web : http://www.schneider-electric.com/en/download.
10
EIO0000002424 06/2017
SoMachine
Informations générales
EIO0000002424 06/2017
Partie I
Informations générales
Informations générales
Contenu de cette partie
Cette partie contient les chapitres suivants :
Chapitre
Titre du chapitre
Page
1
Informations spécifiques de sécurité
13
2
Présentation de la bibliothèque
19
EIO0000002424 06/2017
11
Informations générales
12
EIO0000002424 06/2017
SoMachine
Informations spécifiques de sécurité
EIO0000002424 06/2017
Chapitre 1
Informations spécifiques de sécurité
Informations spécifiques de sécurité
Présentation
Cette rubrique contient les informations permettant de travailler avec la bibliothèque
EmailHandling. Le personnel amené à travailler avec la bibliothèque EmailHandling doit lire et
observer ces informations .
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
Qualification du Personnel
14
Instructions d'utilisation
14
Informations relatives au produit
15
EIO0000002424 06/2017
13
Informations spécifiques de sécurité
Qualification du Personnel
Présentation
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 et du fonctionnement des équipements électriques et installations et
ayant bénéficié d'une formation de sécurité afin de reconnaître et d’éviter les risques encourus.
La personne qualifiée doit être capable de détecter d'éventuels dangers qui pourraient découler
du paramétrage, de modifications des valeurs de paramétrage et plus généralement des
équipements mécaniques, électriques ou électroniques. La personne qualifiée doit connaître les
normes, dispositions et régulations liées à la prévention des accidents de travail, et doit les
observer lors de la conception et de l'implémentation du système.
Instructions d'utilisation
Présentation
Ce produit est une bibliothèque à utiliser avec un système de commande et des servoamplificateurs. La bibliothèque est exclusivement réservée à l'utilisation décrite dans la présente
documentation, appliquée au secteur de l'automatisme industriel.
Observez en permanence les instructions applicables liées à la sécurité, les conditions spécifiques
et les données techniques.
Réalisez une analyse des risques en rapport avec l'utilisation spécifique avant d'utiliser ce produit.
Prenez les mesures de sécurité qui découlent des résultats.
Étant donné que ce produit est utilisé au sein d'un système qui l'englobe, vous devez vous assurer
de la sécurité du personnel par le biais du concept de ce système global (le concept de machine,
par exemple).
Aucune autre utilisation n'est prévue. Toute autre utilisation pourrait être dangereuse.
L’installation, l’utilisation, la réparation et la maintenance des appareils et équipements électriques
doivent être assurées par du personnel qualifié uniquement.
14
EIO0000002424 06/2017
Informations spécifiques de sécurité
Informations relatives au produit
Informations relatives 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.
Avant de tenter de fournir une solution (machine ou processus) pour une application spécifique en
utilisant les POU trouvés dans la bibliothèque, vous devez tenir compte de la réalisation et de
l'exécution des bonnes pratiques. La liste non exhaustive de ces pratiques liées à cette
bibliothèque inclut l'analyse des risques, la sécurité fonctionnelle, la compatibilité des composants,
les tests et la validation du système.
EIO0000002424 06/2017
15
Informations spécifiques de sécurité
AVERTISSEMENT
MAUVAISE UTILISATION DES POU






Effectuez une analyse de la sécurité de l'application et des appareils installés.
Assurez-vous que les POU sont compatibles avec les appareils du système et n'ont pas
d'effets inattendus sur le bon fonctionnement du système.
Utilisez les paramètres appropriés, notamment les valeurs limites, et observez l'usure de la
machine et son comportement à l'arrêt.
Vérifiez que les capteurs et déclencheurs sont compatibles avec les POU sélectionnés.
Testez de manière approfondie toutes les fonctions durant la vérification et la mise en service
dans tous les modes de fonctionnement.
Indiquez des méthodes indépendantes pour les fonctions de commande critiques (arrêt
d'urgence, conditions de dépassement des valeurs limites, etc.) en fonction d'une analyse de
la sécurité, des règles correspondantes et des réglementations.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
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.
Les transferts incomplets, qu'il s'agisse de fichiers de données, d'application et/ou de micrologiciel,
peuvent avoir des conséquences graves sur votre machine ou votre contrôleur. En cas coupure
de courant (volontaire ou non) ou d'interruption de la communication pendant un transfert de
fichier, votre machine peut devenir inopérante ou votre application peut tenter d'utiliser un fichier
de données endommagé. Si une interruption survient, relancez le transfert. Veillez à inclure
l'impact des fichiers de données endommagés dans votre analyse des risques.
16
EIO0000002424 06/2017
Informations spécifiques de sécurité
AVERTISSEMENT
FONCTIONNEMENT IMPREVU DE L'EQUIPEMENT, PERTE DE DONNEES OU FICHIER
ENDOMMAGE



N'interrompez pas un transfert de données en cours.
Si le transfert est interrompu pour une raison quelconque, relancez-le.
Ne mettez pas votre machine en service tant que le transfert de fichier n'est pas terminé, sauf
si vous avez pris en compte les fichiers endommagés dans votre analyse des risques et si
vous avez mis en place des mesures appropriées pour prévenir les conséquences potentiellement graves dues à des échecs de transfert.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
L'utilisation de cette bibliothèque comme outil de contrôle d'une machine nécessite une attention
et des dispositions particulières afin d'éviter des conséquences involontaires dues à l'exploitation
de la machine commandée, à des changements d'état ou à l'altération de la mémoire de données
ou des éléments de fonctionnement de la machine.
AVERTISSEMENT
FONCTIONNEMENT IMPREVU DE L’EQUIPEMENT




Placez les instruments de l'opérateur du système de commande près de la machine ou à un
endroit qui permet d'avoir une vision parfaite de la machine.
Protégez les commandes opérateur contre tout accès non autorisé.
Si le contrôle à distance est une caractéristique nécessaire de l'application, veillez à ce qu'une
personne qualifiée et compétente soit présente sur place pour surveiller le fonctionnement
contrôlé à distance.
Configurez et installez l'entrée Run/Stop (si elle est présente) ou un autre moyen externe dans
l'application, afin que le contrôle local du démarrage ou de l'arrêt de l'équipement puisse être
maintenu indépendamment des commandes envoyées à distance à l'équipement.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
EIO0000002424 06/2017
17
Informations spécifiques de sécurité
AVERTISSEMENT
FONCTIONNEMENT INATTENDU DE L'EQUIPEMENT
Ne mettez pas en service un fichier de programme d'application (fichier de réception, fichier de
commandes numériques, micrologiciel) reçu en pièce-jointe d'un e-mail sans l'avoir testé
minutieusement pour en vérifier la bonne exécution.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
18
EIO0000002424 06/2017
SoMachine
Description
EIO0000002424 06/2017
Chapitre 2
Présentation de la bibliothèque
Présentation de la bibliothèque
Informations générales
Introduction
Cette bibliothèque EmailHandling fournit des fonctions de client de messagerie, permettant à votre
contrôleur d'envoyer des e-mails au contenu 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).
Vous pouvez connecter votre contrôleur à un serveur de messagerie pour envoyer des e-mails
concernant l'état de votre machine ou un rapport sur les principaux indicateurs de performance.
1
2
3
Contrôleur
Serveur de messagerie
Destinataires/Expéditeur
Le tableau suivant indique les caractéristiques de la bibliothèque :
Caractéristique
Valeur
Titre de la bibliothèque
EmailHandling
Société
Schneider Electric
Catégorie
Communication
Composant
Suite de protocoles Internet
Espace de noms par défaut
SE_EMail
Attribut du modèle de langage
qualified-access-only (voir SoMachine, Fonctions et
Bibliothèque post-compatible
Oui (FCL)
EIO0000002424 06/2017
bibliothèques - Guide de l'utilisateur)
19
Description
NOTE : Cette bibliothèque est paramétrée en qualified-access-only. Cela signifie que l'on ne peut
accéder aux POU, aux structures de données, aux énumérations, et aux constantes qu'en utilisant
l'espace de nom de la bibliothèque. L'espace de noms par défaut de la bibliothèque est SE_EMail.
Éléments généraux à prendre en compte
Prenez en compte les limites suivantes pour le transfert d'e-mails :
 Seuls les symboles ASCII sont pris en charge.
 Seules les adresses IPv4 sont prises en charge.
 La bibliothèque EmailHandling intègre des pointeurs sur les adresses.
 La fonction d'accusé de réception n'est pas pris en charge.
 L'envoi ou la réception de fichiers par e-mail engendre la perte des attributs des fichiers.
 Si l'adresse d'un destinataire n'existe pas, la configuration du serveur détermine si un e-mail de
retour est créé ou si FB_SendEMail peut créer un message de diagnostic.
 L'archivage des e-mails (éléments envoyés et reçus) doit être effectué dans le programme
d'application. Le stockage automatique du trafic e-mail sur le système de fichiers du contrôleur
n'est pas implémenté car les e-mails sont principalement gérés dans la mémoire RAM (Random
Access Memory) du contrôleur.
L'exécution de la commande Changement en ligne peut modifier le contenu des adresses.
ATTENTION
POINTEUR INCORRECT
Vérifiez la validité des pointeurs lors de leur utilisation sur les adresses et de l'exécution de la
commande Changement en ligne.
Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels.
La bibliothèque décrite dans ce document utilise la bibliothèque TcpUdpCommunication en
interne.
Les bibliothèques TcpUdpCommunication (Schneider Electric) et CAA Net Base Services (CAA
Technical Workgroup) utilisent les mêmes ressources système sur le contrôleur. Leur utilisation
simultanée dans la même application peut perturber le fonctionnement du contrôleur.
AVERTISSEMENT
FONCTIONNEMENT IMPREVU DE L’EQUIPEMENT
N'utilisez pas la bibliothèque TcpUdpCommunication (Schneider Electric) avec la
bibliothèque CAA Net Base Services (CAA Technical Workgroup) simultanément dans la même
application.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
20
EIO0000002424 06/2017
Description
Éléments à prendre en compte concernant la cybersécurité
Les fonctions de cette bibliothèque ne prennent pas en charge les connexions sécurisées de
type TLS (Transport Layer Security) ou SSL (Secure Socket Layer). Comme les e-mails ne sont
pas chiffrés, cette communication requiert un serveur de messagerie spécifique. La
communication ne peut s'effectuer qu'au sein de votre réseau industriel, isolé des autres réseaux
de votre entreprise et protégé d'Internet.
NOTE : Schneider Electric respecte les bonnes pratiques de l'industrie, en vigueur dans le
développement et la mise en œuvre des systèmes de contrôle. Cette approche, dite de « défense
en profondeur », permet de sécuriser les systèmes de contrôle industriels. Elle place les
contrôleurs derrière des pare-feu pour restreindre leur accès aux seuls personnels et protocoles
autorisés.
AVERTISSEMENT
ACCES NON AUTHENTIFIE ET EXPLOITATION PAR CONSEQUENT NON AUTORISEE DES
MACHINES







Estimez si votre environnement ou vos machines sont connecté(e)s à votre infrastructure
vitale et, le cas échéant, prenez les mesures nécessaires de prévention, basées sur le
principe de défense en profondeur, avant de connecter le système d'automatisme à un réseau
quelconque.
Limitez au strict nécessaire le nombre d'équipements connectés à un réseau.
Isolez votre réseau industriel des autres réseaux au sein de votre société.
Protégez chaque réseau contre les accès non autorisés à l'aide d'un pare-feu, d'un VPN ou
d'autres mesures de sécurité éprouvées.
Surveillez les activités au sein de votre système.
Empêchez tout accès direct ou liaison directe aux équipements sensibles par des utilisateurs
non autorisés ou des actions non authentifiées.
Préparez un plan de récupération intégrant la sauvegarde des informations de votre système
et de votre processus.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des
dommages matériels.
En configurant une liste blanche avec l'entrée i_pbyWhiteListSender, les entrées de cette
liste sont comparées à l'e-mail de l'expéditeur défini dans l'en-tête de l'e-mail reçu. Cette fonction
ne fournit pas la protection contre la manipulation non intentionnelle du champ d'en-tête From:
dans l'e-mail reçu.
Aucun programme antivirus n'est disponible sur le contrôleur. Veillez à en configurer un côté
serveur.
EIO0000002424 06/2017
21
Description
Présentation des POU
Bloc fonction / fonction
Utilisation
FB_SendEMail (voir page 50)
Met en œuvre un client de messagerie, qui se
connecte à un serveur de messagerie pour envoyer
des e-mails.
FB_Pop3EMailClient (voir page 53)
Implémente un client de messagerie e-mail, qui se
connecte à un serveur de messagerie pour la
réception et la suppression d'e-mails en
utilisant POP3.
FC_EtResultToString (voir page 59)
Convertit un élément d'énumération de type
ET_Result en une valeur de chaîne.
Présentation des structures dans l'interface propre au module
Structure
Utilisation
ST_CredentialsSendEMail (voir page 38)
Contient des informations spécifiques à un utilisateur
pour permettre la connexion à un serveur de
messagerie externe pour l'envoi d'e-mails.
ST_CredentialsReceiveEMail (voir page 39)
Contient des informations spécifiques à un utilisateur
pour permettre la connexion à un serveur de
messagerie externe pour la réception et la
suppression d'e-mails.
ST_EMail (voir page 41)
Contient les informations d'un e-mail reçu.
Présentation des énumérations
22
Énumération
Utilisation
ET_AuthenticationMode (voir page 26)
Définit le mode d'authentification requis pour la
connexion à un serveur de messagerie.
ET_Command (voir page 27)
Indique la commande exécutée.
ET_EMailStatus (voir page 28)
Fournit des informations sur l'état de l'e-mail reçu.
ET_Priority (voir page 30)
Définit le niveau de priorité attribué à l'e-mail.
ET_Protocol (voir page 31)
Définit le type de protocole utilisé pour le transfert
d'e-mails.
ET_Result (voir page 32)
Contient les valeurs possibles indiquant les résultats
des opérations exécutées par le bloc fonction.
EIO0000002424 06/2017
SoMachine
Énumérations et Structures
EIO0000002424 06/2017
Partie II
Énumérations et Structures
Énumérations et Structures
Contenu de cette partie
Cette partie contient les chapitres suivants :
Chapitre
Titre du chapitre
Page
3
Énumérations
25
4
Structures
37
EIO0000002424 06/2017
23
Énumérations et Structures
24
EIO0000002424 06/2017
SoMachine
Énumérations
EIO0000002424 06/2017
Chapitre 3
Énumérations
Énumérations
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
ET_AuthenticationMode
26
ET_Command
27
ET_EMailStatus
28
ET_Priority
30
ET_Protocol
31
ET_Result
32
EIO0000002424 06/2017
25
Énumérations
ET_AuthenticationMode
Présentation
Type :
Énumération
Disponible à partir de la version :
V1.0.0.0
Description
L'énumération ET_AuthenticationMode définit le mode d'authentification requis pour la
connexion à un serveur de messagerie.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
NoAuthentication
INT
0
Aucune authentification utilisateur requise.
Login
INT
10
Mécanisme LOGIN utilisé pour l'authentification.
Plain
INT
20
Mécanisme PLAIN utilisé pour l'authentification.
Utilisé par

26
FB_SendEMail
EIO0000002424 06/2017
Énumérations
ET_Command
Présentation
Type :
Énumération
Disponible à partir de la version :
1.1.2.0
Description
L'énumération ET_Command indique la commande qui est exécutée.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
NoCommand
INT
0
Aucune commande n'est exécutée.
CheckInbox
INT
1
Le nombre d'e-mails disponibles sur le serveur est
vérifiée.
Receive
INT
2
Les e-mails sont reçus du serveur.
Delete
INT
3
L'e-mail défini avec l'ID unique à l'entrée i_sUniqueID
est supprimé du serveur.
Utilisé par

FB_Pop3EMailClient
EIO0000002424 06/2017
27
Énumérations
ET_EMailStatus
Présentation
Type :
Énumération
Disponible à partir de la version :
1.1.2.0
Description
L'énumération ET_EMailStatus fournit les informations d'état de l'e-mail.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
Empty
INT
0
La structure est vide ou les données de l'e-mail ne
sont pas valides.
Ok
INT
1
L'e-mail a été bien reçu.
SenderBlocked
INT
2
L'adresse de l'expéditeur est bloquée dans la liste
blanche, ou est introuvable dans l'en-tête de l'e-mail,
ou dépasse la longueur maximale de 200 octets.
NotSupported
INT
3
Le format de l'e-mail n'est pas pris en charge.
Types de contenu (Content-Type) pris en charge
(non valide pour les pièces-jointes) :
 text/plain
 multipart/mixed
Schémas d'encodage de transfert (Content-TransferEncoding) pris en charge :
 7-bit
 quoted-printable
 base 64
InvalidHeader
INT
4
L'en-tête de l'e-mail n'est pas valide.
InvalidAttachmentPath
INT
5
Le chemin d'accès à la pièce-jointe de l'e-mail n'est
pas valide :
 Le chemin d'accès dépasse la longueur maximale
de 255 octets, ou
 Aucun nom de fichier n'est fourni.
28
EIO0000002424 06/2017
Énumérations
Nom
Type de
données
Valeur
Description
InvalidAttachmentExtension
INT
6
L'extension de la pièce-jointe de l'e-mail n'est pas
valide. Il est impossible de recevoir une pièce-jointe
avec l'une des extensions suivantes :
 .ap_
 .app
 .cf_
 .cfg
 .crc
 .err
 .frc
 .log
 .prj
 .rcp
 .rsi
 .urf
Utilisé par

FB_Pop3EMailClient
EIO0000002424 06/2017
29
Énumérations
ET_Priority
Présentation
Type :
Énumération
Disponible à partir de la version :
1.1.2.0
Description
L'énumération ET_Priority définit le niveau de priorité attribué à l'e-mail.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
Normal
INT
0, 3
Le niveau de priorité de l'e-mail est normal.
VeryHigh
INT
1
Le niveau de priorité est très élevé.
High
INT
2
Le niveau de priorité est élevé.
Low
INT
4
Le niveau de priorité est faible.
VeryLow
INT
5
Le niveau de priorité est très faible.
Utilisé par

30
FB_SendEMail
EIO0000002424 06/2017
Énumérations
ET_Protocol
Présentation
Type :
Énumération
Disponible à partir de la version :
V1.0.0.0
Description
L'énumération ET_Protocol définit le type de protocole utilisé pour le transfert d'e-mails.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
SMTP
INT
0
Le protocole utilisé pour le transfert d'e-mails est SMTP
(Simple Mail Transfer Protocol).
eSMTP
INT
1
Le protocole utilisé pour le transfert des e-mails est
eSMTP (extended Simple Mail Transfer Protocol). Select
this protocol to use additional protocol extensions, for
example authentication, attachment, or email priority.
Utilisé par

FB_SendEMail
EIO0000002424 06/2017
31
Énumérations
ET_Result
Présentation
Type :
Énumération
Disponible à partir de la version :
V1.0.0.0
Description
L'énumération ET_Result contient les valeurs possibles qui donnent les résultats des opérations
exécutées par le bloc fonction.
Éléments de l'énumération
Nom
Type de
données
Valeur
Description
Si q_xError d'un bloc fonction (voir page 50) est FALSE, l'un des messages d'état suivants apparaît.
Ok
UDINT
0
L'opération a abouti.
Disabled
UDINT
1
Le bloc fonction est désactivé.
Initializing
UDINT
2
Le bloc fonction est en cours d'initialisation.
Ready
UDINT
4
Le bloc fonction est prêt.
ConnectingToServer
UDINT
5
Le client se connecte au serveur.
DisconnectingFromServer
UDINT
6
Le client se déconnecte du serveur.
NoCommand
UDINT
7
Aucune commande sélectionnée.
SendingEMail
UDINT
8
Un e-mail est envoyé au serveur.
ConnectedToServer
UDINT
50
Une connexion au serveur a été établie.
MessageFromServerReceived
UDINT
52
Échange de données avec le serveur : un
message a été reçu.
MessageToServerSent
UDINT
54
Échange de données avec le serveur : un
message a été envoyé au serveur.
SendingMessageToServer
UDINT
55
Échange de données avec le serveur : un
message est envoyé au serveur.
Busy
UDINT
56
Le bloc fonction est occupé.
WaitingForExpectedMessage
UDINT
58
Échange de données avec le serveur : en
attente du message.
OpeningAttachment
UDINT
60
La pièce-jointe est ouverte dans un système
de fichiers du contrôleur.
SendingAttachment
UDINT
62
L'envoi de la pièce jointe est en cours.
32
EIO0000002424 06/2017
Énumérations
Nom
Type de
données
Valeur
Description
DownloadingEMail
UDINT
64
L'e-mail est téléchargé du serveur.
SavingAttachment
UDINT
66
L'enregistrement de la pièce-jointe dans le
système de fichiers du contrôleur est en
cours.
DeletingEMail
UDINT
68
L'e-mail est supprimé du serveur.
ServerOk
UDINT
70
Le serveur est à l'état opérationnel.
DeletingFile
UDINT
72
Le fichier non valide est supprimé du
système.
Si le paramètre q_xError d'un bloc fonction (voir page 50) est TRUE, l'un des messages d'état suivants apparaît.
InvalidAuthenticationMode
UDINT
101
La valeur détectée de
i_etAuthenticationMode n'est pas
valide.
InvalidServerIP
UDINT
102
Le paramètre i_sServerIP est vide. Il doit
avoir une valeur.
InvalidDomainName
UDINT
104
Le paramètre i_sDomainName est vide. Il
doit avoir une valeur.
InvalidSenderEMail
UDINT
106
Le paramètre i_sSenderEMail est vide. Il
doit avoir une valeur.
InvalidRecipientEMail
UDINT
108
Le paramètre i_sRecipientEMail est
vide. Il doit avoir une valeur.
InvalidProtocol
UDINT
110
La valeur détectée de i_etProtocol n'est
pas valide.
InvalidMessageAddress
UDINT
111
La valeur détectée de i_pbyMessage n'est
pas valide.
AuthenticationFailed
UDINT
112
L'authentification a échoué : le nom
d'utilisateur (i_sUsername) ou le mot de
passe (i_sPassword) est incorrect.
AuthenticationRequired
UDINT
113
Authentification requise : activez un mode
d'authentification.
InvalidUsername
UDINT
114
Le paramètre i_sUsername est vide. Il doit
avoir une valeur.
InvalidPassword
UDINT
116
Le paramètre i_sPassword est vide. Il doit
avoir une valeur.
EIO0000002424 06/2017
33
Énumérations
Nom
Type de
données
Valeur
Description
FunctionNotSupported
UDINT
118
La fonction sélectionnée, comme le mode
d'authentification sélectionné, n'est pas prise
en charge.
Définissez i_etProtocol sur
ET_Protocol.eSMTP ou utilisez un autre
i_etAuthenticationMode.
SyntaxError
UDINT
120
Une erreur de syntaxe, comme une adresse
de destinataire vide, a été détectée.
RecipientAddressTooLong
UDINT
122
L'adresse de destinataire détectée dépasse
la longueur autorisée de 200 octets.
MailboxUnavailable
UDINT
124
L'action demandée est impossible car la
messagerie est indisponible.
OpenAttachmentFailed
UDINT
126
Impossible d'ouvrir la pièce jointe.
ReadAttachmentFailed
UDINT
128
Impossible de lire la pièce jointe.
CloseAttachmentFailed
UDINT
130
Impossible de fermer la pièce jointe.
MessageRejectedFromRecipient
UDINT
132
L'e-mail a été rejeté par le destinataire.
EMailNotFound
UDINT
133
L'e-mail correspondant est introuvable sur le
serveur. Vérifiez la valeur de i_sUniqueId.
InvalidPriority
UDINT
134
La valeur de i_etPriority n'est pas
valide.
InvalidNumberEMailsToReceive
UDINT
135
La valeur détectée de
i_uiEMailsToReceive n'est pas valide.
Elle doit être supérieure à 0 et inférieure ou
égale à GPL.Gc_uiInboxSize.
ServerError
UDINT
136
Le serveur a détecté une erreur.
InvalidWhiteListSize
UDINT
137
La valeur détectée de
i_udiWhiteListSize n'est pas valide.
Elle doit être supérieure à 0.
InvalidFilePath
UDINT
138
La valeur détectée de i_sFilePath n'est
pas valide.
InvalidMaxNumberOfAttachments
UDINT
139
La valeur de
GPL.Gc_udiMaxNumberOfAttachments
n’est pas valide. Elle doit être supérieure à 0.
InvalidMailboxBuffer
UDINT
140
La valeur de i_pbyMailboxBuffer n’est
pas valide.
InvalidCommand
UDINT
141
La valeur de i_etCommand n’est pas valide.
InvalidBufferSize
UDINT
142
La valeur de i_udiBufferSize n’est pas
valide. Elle doit être supérieure à 0.
34
EIO0000002424 06/2017
Énumérations
Nom
Type de
données
Valeur
Description
NotSupported
UDINT
143
Cette fonction n'est plus prise en charge.
InvalidInboxSize
UDINT
144
La valeur de Gc_udiInboxSize n’est pas
valide. Elle doit être supérieure à 0.
InvalidUniqueId
UDINT
145
La valeur de i_sUniqueID n’est pas valide.
SaveAttachmentFailed
UDINT
146
L'enregistrement de pièce jointe dans le
système de fichiers du contrôleur a échoué.
InvalidWhiteList
UDINT
147
La valeur de i_pyWhiteListSender n’est
pas valide.
Comme i_udiWhiteListSize est
supérieur à 0, i_pyWhiteListSender doit
avoir une adresse valide (>0).
MailboxBufferFull
UDINT
148
Le tampon de la boîte aux lettres est plein.
Le nombre d'octets reçus est supérieur à
i_udiBufferSize.
DecodingError
UDINT
149
Une erreur interne a été détectée lors du
décodage d'un e-mail.
FailedToConnectToServer
UDINT
150
La connexion au serveur n'a pas été établie.
Vérifiez que la connexion Ethernet ou les
paramètres i_sServerIP /
i_sServerPort.
InvalidMessageFromServer
UDINT
152
Le message reçu du serveur n'est pas valide.
UnexpectedMessageFromServer
UDINT
153
Le serveur a envoyé un message inattendu.
FailedToReceiveMessageFromServer
UDINT
154
Un timeout a expiré : aucune réponse n'a été
reçue du serveur pendant le délai imparti.
FailedToSendMessageToServer
UDINT
156
Une erreur de communication a été
détectée : impossible d'envoyer le message
au serveur.
UnexpectedProgramBehavior
UDINT
200
Une erreur interne a été détectée.
Utilisé par


FB_SendEMail
FB_PopEMailClient
EIO0000002424 06/2017
35
Énumérations
36
EIO0000002424 06/2017
SoMachine
Structures
EIO0000002424 06/2017
Chapitre 4
Structures
Structures
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
ST_CredentialsSendEMail
38
ST_CredentialsReceiveEMail
39
ST_EMail
41
EIO0000002424 06/2017
37
Structures
ST_CredentialsSendEMail
Présentation
Type :
Structure
Disponible à partir de la version :
V1.0.0.0
Hérite de :
–
Description
La structure ST_CredentialsSendEMail contient des informations spécifiques à un utilisateur
pour lui permettre de se connecter à un serveur de messagerie externe et d'envoyer des e-mails.
Éléments de la structure
Nom
Type de données
Description
i_sServerIP
STRING[GPL.Gc_uiIpStr
ingSize]
Adresse IP du serveur de messagerie externe.
i_uiServerPort
UINT
Port du serveur de messagerie externe.
i_etProtocol
ET_Protocol
Énumération indiquant le protocole.
i_sDomainName
STRING[200]
Domaine du client.
i_sSenderEMail
STRING[200]
Adresse électronique de l'expéditeur.
i_sUsername
STRING[60]
Nom d'utilisateur permettant d'accéder au serveur de
messagerie externe.
i_sPassword
STRING[60]
Mot de passe permettant d'accéder au serveur de
messagerie externe.
i_etAuthenticationMode
ET_AuthenticationMode Énumération indiquant le mode d'authentification.
Utilisé par

38
FB_SendEMail
EIO0000002424 06/2017
Structures
ST_CredentialsReceiveEMail
Présentation
Type :
Structure
Disponible à partir de la version :
V1.1.2.0
Hérite de :
–
Description
La structure ST_CredentialsReceiveEMail contient des informations spécifiques à un
utilisateur pour lui permettre de se connecter à un serveur de messagerie externe pour recevoir et
supprimer des e-mails en utilisant POP3.
Éléments de la structure
Nom
Type de données
Description
i_sServerIP
STRING[GPL.Gc_uiIpStr
ingSize]
Adresse IP du serveur de messagerie externe.
i_uiServerPort
UINT
Port du serveur de messagerie externe.
i_sUsername
STRING[200]
Nom d'utilisateur permettant d'accéder au serveur de
messagerie externe.
i_sPassword
STRING[60]
Mot de passe permettant d'accéder au serveur de
messagerie externe.
i_pbyWhiteListSender
POINTER TO BYTE
Adresse de départ de la chaîne contenant la ou les
adresses de la liste blanche.
Si la liste contient plusieurs entrées, un point-virgule
doit séparer les adresses e-mail. La taille maximale
de chaque adresse est limitée à 200 octets.
Une chaîne vide bloque tous les e-mails.
Entrez un astérisque et un domaine
(*@yourdomain.com) pour permettre la réception
des e-mails envoyés par des expéditeurs de ce
domaine. Les e-mails d'autres domaines sont
bloqués.
i_udiWhiteListSize
UDINT
Taille de la liste blanche.
EIO0000002424 06/2017
39
Structures
Nom
Type de données
Description
i_xOverwriteAttachment
BOOL
Si la valeur est TRUE, les pièces-jointes stockées
dans le dossier EMailAttachments sont écrasées si
une pièce-jointe avec le même nom est téléchargé
depuis le serveur.
Si la valeur est FALSE, la réception est annulée dès
qu'une seconde pièce-jointe avec nom identique est
téléchargée. La sortie q_sResultMsg indique le
nom du fichier qui a généré l'erreur.
Utilisé par

40
FB_Pop3EMailClient
EIO0000002424 06/2017
Structures
ST_EMail
Présentation
Type :
Structure
Disponible à partir de la version :
V1.1.2.0
Hérite de :
–
Description
La structure ST_EMail contient les informations d'un e-mail reçu.
Éléments de la structure
Nom
Type de données
Description
q_etEMailStatus
ET_EMailStatus
Etat de l'e-mail (voir page 28).
q_pbyDate
POINTER TO BYTE
Adresse de départ de la chaîne contenant la
date.
q_udiLengthOfDate
UDINT
Longueur de la chaîne.
q_pbySenderEMail
POINTER TO BYTE
Adresse de départ de la chaîne contenant
l'adresse e-mail de l'expéditeur.
q_udiLengthOfSenderEMail
UDINT
Longueur de la chaîne d'adresse e-mail de
l'expéditeur.
q_pbySubject
POINTER TO BYTE
Adresse de départ de la chaîne contenant
l'objet de l'e-mail.
udiLengthOfSubject
UDINT
Longueur de la chaîne de l'objet.
q_pbyMessage
POINTER TO BYTE
Adresse de départ de la chaîne contenant le
message e-mail.
q_udiLengthOfMessage
UDINT
Longueur de la chaîne du message.
q_asAttachmentPath
Chemin d'accès relatif ou absolu aux piècesARRAY
[1..GPL.Gc_udiMaxNumb jointes stockées dans le système de fichiers.
erOfAttachments] OF
STRING[255]
q_audiSizeOfAttachment
Taille des pièces-jointes stockées dans le
ARRAY
[1..GPL.Gc_udiMaxNumb système de fichiers.
erOfAttachments] OF
UDINT
q_sUniqueID
STRING[70]
ID unique de l'e-mail.
Utilisé par

FB_Pop3EMailClient
EIO0000002424 06/2017
41
Structures
42
EIO0000002424 06/2017
SoMachine
Variables globales
EIO0000002424 06/2017
Partie III
Variables globales
Variables globales
EIO0000002424 06/2017
43
Variables globales
44
EIO0000002424 06/2017
SoMachine
Liste des paramètres globaux
EIO0000002424 06/2017
Chapitre 5
Liste des paramètres globaux
Liste des paramètres globaux
Liste des paramètres globaux (GPL)
Présentation
Type :
Paramètres globaux
Disponible à partir de la version :
V1.0.0.0
Description
Cette liste contient les paramètres globaux de la bibliothèque EmailHandling. Vous pouvez les
modifier en fonction de votre projet dans le Gestionnaire de bibliothèques.
Paramètres globaux
Variable
Type de
données
Valeur par défaut
Description
Gc_udiRecipientEMailSize
UDINT
200
Nombre maximum d'octets de
i_sRecipientEMail.
Gc_tTimeOut
TIME
TIME#10m0s0ms
Délai maximum pour recevoir
une réponse du serveur.
Gc_uiIpStringSize
UINT
15
Taille maximum des
adresses IP, comme
i_sServerIP.
Gc_udiReceiveBufferSize
UDINT
1000
Taille maximale du tampon de
réception requise pour
communiquer avec le serveur.
Gc_xUseControllerTime
BOOL
FALSE
Si la valeur est TRUE, le temps
du contrôleur est utilisé pour
créer l'horodatage indiquant le
moment d'envoi des e-mails.
Gc_udiInboxSize
UDINT
10
Taille maximale de la boîte aux
lettres. Cette valeur détermine
le nombre maximal d'e-mails
téléchargeables avec une
commande de réception.
EIO0000002424 06/2017
45
Liste des paramètres globaux
Variable
Type de
données
Valeur par défaut
Description
Gc_udiMaxNumberOfAttachmentPaths
UDINT
1
Taille maximale du tableau
ST_EMail.asAttachmentP
ath. Il contient le ou les
chemins d'accès absolu ou
relatif dans le système de
fichiers du contrôleur dans
lequel stocker les piècesjointes téléchargées.
Cette variable ne limite pas le
nombre de pièces-jointes.
Gc_xUseTop
BOOL
TRUE
Si la valeur est TRUE, la
commande TOP0 est utilisée
en interne pour télécharger
l'en-tête de l'e-mail. Cela est
utile si la fonction de liste
blanche est utilisée pour
vérifier l'adresse des e-mails
de l'expéditeur avant le
téléchargement du message
complet.
Si la commande TOP n'est pas
prise en charge par votre
serveur de messagerie
(indiqué par q_sResultMsg),
définissez cette variable sur
FALSE.
Gc_xUseUniqueId
BOOL
TRUE
Si la valeur est TRUE, la
commande UIDL est utilisée
en interne pour récupérer l'ID
unique de l'e-mail.
Si la commande UIDL n'est
pas prise en charge par votre
serveur de messagerie
(indiqué par q_sResultMsg),
définissez cette variable sur
FALSE.
46
EIO0000002424 06/2017
SoMachine
Unités d'organisation de programme (POU)
EIO0000002424 06/2017
Partie IV
Unités d'organisation de programme (POU)
Unités d'organisation de programme (POU)
Contenu de cette partie
Cette partie contient les chapitres suivants :
Chapitre
Titre du chapitre
Page
6
Blocs fonction
49
7
Fonctions
59
EIO0000002424 06/2017
47
Unités d'organisation de programme (POU)
48
EIO0000002424 06/2017
SoMachine
Blocs fonction
EIO0000002424 06/2017
Chapitre 6
Blocs fonction
Blocs fonction
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
Page
FB_SendEMail
50
FB_Pop3EMailClient
53
EIO0000002424 06/2017
49
Blocs fonction
FB_SendEMail
Présentation
Type :
Bloc fonction
Disponible à partir de la version :
V1.0.0.0
Tâche
Le bloc fonction FB_SendEMail inclut les fonctions permettant d'envoyer des e-mails. Chaque
instance gère une connexion SMTP.
Description fonctionnelle
Le bloc fonction FB_SendEMail est l'interface utilisateur qui permet d'interagir avec le serveur de
messagerie externe. Il vous permet d'envoyer des e-mails.
Lorsque le bloc fonction est activé et exécuté, une connexion TCP est établie au serveur de
messagerie à l'aide des informations d'identification utilisateur envoyées par iq_stCredentials. Dès que la connexion est établie, les données de l'e-mail sont transférées au serveur.
Une fois le transfert terminé, le bloc fonction ferme automatiquement la connexion TCP au serveur
de messagerie.
Tant que le bloc fonction est exécuté, la sortie q_xBusy est TRUE. La sortie q_xDone est TRUE
lorsque le bloc fonction s'est exécuté correctement.
50
EIO0000002424 06/2017
Blocs fonction
Le schéma représente les signaux des entrées et sorties du bloc fonction :
Les messages d'état et informations de diagnostic sont fournis à l'aide des sorties q_xError
(TRUE si une erreur a été détectée), q_etResult et q_etResultMsg.
Pour acquitter les erreurs détectées et pouvoir renvoyer un e-mail, désactivez et réactivez le bloc
fonction.
EIO0000002424 06/2017
51
Blocs fonction
Interface
Entrée
Type de données
Description
i_xEnable
BOOL
Activation et initialisation du bloc fonction.
i_xExecute
BOOL
Le bloc fonction envoie un e-mail au moment
correspondant au front montant de cette entrée.
i_sRecipientEMail
STRING
[GPL.Gc_udiRecipient
EMailSize]
La chaîne qui contient la ou les adresses électroniques du
ou des destinataires. En cas de destinataires multiples, un
point-virgule doit séparer les adresses électroniques. La
taille maximale de chaque adresse est limitée à 200 octets.
i_sSubject
STRING[200]
Objet de l'e-mail.
i_pbyMessage
POINTER TO BYTE
Adresse de début de la chaîne dans laquelle le message
est stocké.
i_udiSizeOfMessage
UDINT
Taille des données du message.
i_etPriority
ET_Priority
Enumération indiquant le niveau de priorité attribué à l'email (voir page 30).
i_sAttachmentPath
STRING[255]
Chemin d'accès absolu ou relatif à la pièce-jointe stockée
dans le système de fichiers du contrôleur.
Si cette chaîne est vide, aucune pièce-jointe n'est envoyée.
Entrée/sortie
Type de données
Description
iq_stCredentials
ST_CredentialsSendEMail
Permet de transmettre la structure contenant les
paramètres utilisateur, tels que le nom d'utilisateur
ou le mot de passe.
Sortie
Type de données
Description
q_xActive
BOOL
Si le bloc fonction est actif, cette sortie est TRUE.
q_xReady
BOOL
Si l'initialisation aboutit, cette sortie est TRUE tant
que le bloc fonction accepte des entrées.
q_xBusy
BOOL
Si cette sortie est TRUE, le bloc fonction est en
cours d'exécution.
q_xDone
BOOL
Si cette sortie est TRUE, l'exécution s'est effectuée
correctement.
q_xError
BOOL
Si cette sortie est TRUE, une erreur a été détectée.
Pour plus d'informations, reportez-vous à
q_etResult et q_etResultMsg.
q_etResult
ET_Result
Fournit des informations de diagnostic et d'état.
q_sResultMsg
STRING[80]
Fournit des informations supplémentaires de
diagnostic et d'état.
52
EIO0000002424 06/2017
Blocs fonction
FB_Pop3EMailClient
Présentation
Type :
Bloc fonction
Disponible à partir de la version :
V1.1.2.0
Tâche
Le bloc fonction FB_Pop3EMailClient inclut les fonctions de réception et de suppression d'emails en utilisant POP3. Chaque instance gère une connexion POP3.
Description fonctionnelle
Le bloc fonction FB_Pop3EMailClient est l'interface utilisateur qui permet d'interagir avec le
serveur de messagerie externe POP3. Il permet de recevoir et de supprimer des e-mails. Les
pièces-jointes d'e-mails reçus vous permettent d'obtenir des informations sur différentes fonctions
système basées sur des fichiers stockés dans la mémoire système. Le stockage de certaines
extensions de fichier n'est pas autorisé dans le système de fichiers du contrôleur via
FB_Pop3EMailClient (voir le paramètre (voir page 28) ET_EmailStatus.InvalidAttachmentExtension) Cela s'applique aux fichiers qui sont automatiquement gérés par le contrôleur,
et aux fichiers du système tels que le micrologiciel du contrôleur, afin d'éviter tout écrasement
accidentel.
EIO0000002424 06/2017
53
Blocs fonction
Une fois le bloc fonction activé et exécuté, une connexion TCP est établie au serveur POP3 à l'aide
des informations d'identification utilisateur envoyées via iq_stCredentials. Lorsque la
connexion est établie, la commande définie avec i_etCommand est exécutée. Une fois le transfert
terminé, la connexion TCP au serveur POP3 est fermée par le bloc fonction. Les e-mails reçus sont
supprimés du serveur POP3. Vous pouvez manuellement supprimer des e-mails en définissant l'email (identifié par un ID unique) sur l'entrée i_sUniqueId et en exécutant la commande de
suppression avec i_etCommand. En exécutant d'autres commandes, la structure de la boîte aux
lettres disponible sur q_astInbox contenant les références aux données de l'e-mail est
réinitialisée.
Les e-mails reçus sont placés dans la mémoire volatile. La mémoire volatile est effacée lors de la
mise hors tension, et tous les e-mails y sont donc supprimés.
AVIS
PERTE DE DONNEES
Enregistrez les e-mails entrants dans une mémoire non volatile.
Le non-respect de ces instructions peut provoquer des dommages matériels.
Tant que le bloc fonction est exécuté, la sortie q_xBusy est TRUE. La sortie q_xDone est TRUE
lorsque le bloc fonction s'est exécuté correctement.
54
EIO0000002424 06/2017
Blocs fonction
Le schéma représente les signaux des entrées et sorties du bloc fonction :
Les messages d'état et les informations de diagnostic sont fournis à l'aide des sorties q_xError
(TRUE si une erreur a été détectée), q_etResult et q_etResultMsg.
Pour acquitter les erreurs détectées, et pouvoir recevoir et supprimer un e-mail, désactivez et
réactivez le bloc fonction.
EIO0000002424 06/2017
55
Blocs fonction
Interface
Entrée
Type de données
Description
i_xEnable
BOOL
Activation et initialisation du bloc fonction.
i_xExecute
BOOL
Le bloc fonction reçoit ou supprime un email au front montant de cette entrée.
i_etCommand
ET_Command
L'énumération indique la commande à
exécuter (voir page 27).
i_pbyMailboxBuffer
POINTER TO BYTE
Adresse de début du premier octet dans
lequel sont stockés les e-mails entrants.
i_udiBufferSize
UDINT
Taille de la mémoire tampon de la boîte aux
lettres.
i_uiEMailsToReceive
UINT
Nombre d'e-mails à recevoir du serveur.
i_sFilePath
STRING[200]
Chemin d'accès au dossier dans le système
de fichiers du contrôleur où est créé le
dossier EMailAttachments. Dans ce dossier,
les pièces-jointes des e-mails reçus sont
stockés. L'extension de fichier définie avec
le
ET_EMailStatus.InvalidAttachment
Extension paramètre (voir page 28) ne
peut pas être stockée.
NOTE : Si vous recevez une deuxième
pièce-jointe avec un nom identique à celle
d'une pièce-jointe déjà disponible dans ce
dossier, l'ancien fichier peut être écrasé si le
paramètre global
ST_CredentialsReceiveEMail.i_xOv
erwriteAttachment est défini sur TRUE.
Si cette chaîne est vide, le dossier
EMailAttachments est créé dans le chemin
d'accès par défaut du contrôleur.
i_sUniqueID
56
STRING[70]
L'ID unique requis pour supprimer un e-mail.
Après réception de l'e-mail du serveur, l'ID
unique s'affiche sur la sortie q_astInbox.
Entrée/sortie
Type de données
Description
iq_stCredentials
ST_CredentialsReceiveEMa
il
Permet de transmettre la structure
contenant les paramètres utilisateur, tels
que le nom d'utilisateur ou le mot de passe.
iq_astInbox
ARRAY [1…GPL.Gc_udiInbox Structure (voir page 41) qui contient les
informations d'un e-mail reçu.
Size] OF ST_EMail
EIO0000002424 06/2017
Blocs fonction
Sortie
Type de données
Description
q_xActive
BOOL
Si le bloc fonction est actif, cette sortie est
TRUE.
q_xReady
BOOL
Si l'initialisation aboutit, cette sortie est
TRUE tant que le bloc fonction est
opérationnel.
q_xBusy
BOOL
Si cette sortie est TRUE, le bloc fonction est
en cours d'exécution.
q_xDone
BOOL
Si cette sortie est TRUE, l'exécution s'est
effectuée correctement.
q_xError
BOOL
Si cette sortie est TRUE, une erreur a été
détectée. Pour plus d'informations,
reportez-vous à q_etResult et
q_etResultMsg.
q_etResult
ET_Result
Fournit des informations de diagnostic et
d'état.
q_sResultMsg
STRING[80]
Fournit des informations supplémentaires
de diagnostic et d'état.
q_udiNumberOfEmails
UDINT
Dépend de la i_etCommand exécutée :
 ET_Command.CheckInbox : indique le
nombre d'e-mails disponibles sur le
serveur.
 ET_Command.Receive : indique le
nombre d'e-mails reçus du serveur.
Si une erreur est détectée, cette sortie
fournit le nombre d'e-mails correctement
téléchargés.
 ET_Command.Delete : indique le
nombre d'e-mails supprimés.
EIO0000002424 06/2017
57
Blocs fonction
58
EIO0000002424 06/2017
SoMachine
Fonctions
EIO0000002424 06/2017
Chapitre 7
Fonctions
Fonctions
FC_EtResultToString
Présentation
Type :
Fonction
Disponible à partir de la version :
V1.0.0.0
Hérite de :
–
Met en œuvre :
–
Tâche
Convertir un élément d'énumération de type ET_Result en une variable de type STRING.
Description fonctionnelle
La fonction FC_EtResultToString permet de convertir un élément d'énumération de type
ET_Result en une variable de type STRING.
Interface
Entrée
Type de données
Description
i_etResult
ET_Result
Énumération avec le résultat.
Valeur retournée
Type de données
Description
STRING(80)
ET_Result converti en texte.
EIO0000002424 06/2017
59
Fonctions
60
EIO0000002424 06/2017
SoMachine
EIO0000002424 06/2017
Annexes
EIO0000002424 06/2017
61
62
EIO0000002424 06/2017
SoMachine
Représentation des fonctions et blocs fonction
EIO0000002424 06/2017
Annexe A
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
64
Utilisation d'une fonction ou d'un bloc fonction en langage IL
65
Utilisation d'une fonction ou d'un bloc fonction en langage ST
69
EIO0000002424 06/2017
63
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 :
64
EIO0000002424 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.
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
EIO0000002424 06/2017
65
Représentation des fonctions et blocs fonction
Fonction
Représentation graphique
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
66
EIO0000002424 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.
EIO0000002424 06/2017
67
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
68
EIO0000002424 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);
EIO0000002424 06/2017
69
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
70
EIO0000002424 06/2017
Représentation des fonctions et blocs fonction
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
EIO0000002424 06/2017
71
Représentation des fonctions et blocs fonction
72
EIO0000002424 06/2017
SoMachine
Glossaire
EIO0000002424 06/2017
Glossaire
A
application
Programme comprenant des données de configuration, des symboles et de la documentation.
ASCII
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).
B
bus d'extension
Bus de communication électronique entre des modules d'E/S d'extension et un contrôleur.
C
CFC
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.
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.
E
E/S
Entrée/sortie
EIO0000002424 06/2017
73
Glossaire
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.
I
IL
INT
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.
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
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).
O
octet
74
Type codé sur 8 bits, de 00 à FF au format hexadécimal.
EIO0000002424 06/2017
Glossaire
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.
S
ST
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.
T
TCP
TCP (Transmission Control Protocol) est un protocole de transmission employé dans les réseaux
IP.
V
variable
Unité de mémoire qui est adressée et modifiée par un programme.
EIO0000002424 06/2017
75
Glossaire
76
EIO0000002424 06/2017
SoMachine
Index
EIO0000002424 06/2017
Index
B
bibliothèques
EmailHandling, 19
E
EmailHandling, 19
FB_Pop3EMailClient, 53
FB_SendEMail, 50
GPL (liste des paramètres globaux), 45
ET_AuthenticationMode, 26
Login, 26
NoAuthentication, 26
Plain, 26
ET_Command, 27
CheckInbox, 27
Delete, 27
NoCommand, 27
Receive, 27
ET_EMailStatus, 28
Empty, 28
InvalidAttachmentExtension, 29
InvalidAttachmentPath, 28
InvalidHeader, 28
NotSupported, 28
Ok, 28
SenderBlocked, 28
ET_Priority, 30
High, 30
Low, 30
Normal, 30
VeryHigh, 30
VeryLow, 30
ET_Protocol, 31
eSMTP, 31
SMTP, 31
EIO0000002424 06/2017
ET_Result, 32
AuthenticationFailed, 33
AuthenticationRequired, 33
Busy, 32
CloseAttachmentFailed, 34
ConnectedToServer, 32
ConnectingToServer, 32
DecodingError, 35
DeletingEMail, 33
DeletingFile, 33
Disabled, 32
DisconnectingFromServer, 32
DownloadingEMail, 33
EMailNotFound, 34
FailedToConnectToServer, 35
FailedToReceiveMessageFromServer,
77
Index
35
FailedToSendMessageToServer, 35
FunctionNotSupported, 34
Initializing, 32
InvalidAuthenticationMode, 33
InvalidBufferSize, 34
InvalidCommand, 34
InvalidDomainName, 33
InvalidFilePath, 34
InvalidInboxSize, 35
InvalidMailboxBuffer, 34
InvalidMessageAddress, 33
InvalidMessageFromServer, 35
InvalidNumberEMailsToReceive, 34
InvalidNumberOfAttachments, 34
InvalidPassword, 33
InvalidPriority, 34
InvalidProtocol, 33
InvalidRecipientEMail, 33
InvalidSenderEMail, 33
InvalidServerIP, 33
InvalidUniqueId, 35
InvalidUsername, 33
InvalidWhiteList, 35
InvalidWhiteListSize, 34
MailboxBufferFull, 35
MailboxUnavailable, 34
MessageFromServerReceived, 32
MessageRejectedFromRecipient, 34
MessageToServerSent, 32
NoCommand, 32
NotSupported, 35
Ok, 32
OpenAttachmentFailed, 34
OpeningAttachment, 32
ReadAttachmentFailed, 34
Ready, 32
RecipientAddressTooLong, 34
SaveAttachmentFailed, 35
SavingAttachment, 33
SendingAttachment, 32
SendingEMail, 32
SendingMessageToServer, 32
ServerError, 34
ServerOk, 33
78
SyntaxError, 34
UnexpectedMessageFromServer, 35
UnexpectedProgramBehavior, 35
WaitingForExpectedMessage, 32
F
FB_Pop3EMailClient, 53
FB_SendEMail, 50
FC_EtResultToString, 59
fonctions
différences entre une fonction et un bloc
fonction, 64
utilisation d'une fonction ou d'un bloc
fonction en langage IL, 65
utilisation d'une fonction ou d'un bloc
fonction en langage ST, 69
G
GPL (liste des paramètres globaux)
EmailHandling, 45
L
limites du transfert d'e-mails, 20
Q
qualification du personnel, 14
S
ST_CredentialsReceiveEMail, 39
ST_CredentialsSendEMail, 38
ST_EMail, 41
EIO0000002424 06/2017