Envoi de messages électroniques

Description de la fonction

La fonction SEND_EMAIL permet d'envoyer un message électronique avec un automate Modicon M340.

Le service SEND_EMAIL est limité au port Ethernet intégré et aux modules BMX NOC 0401. Il n'est pas pris en charge par les modules BMX NOE.

NOTE : Pour que le service SEND_EMAIL fonctionne correctement, l'adresse IP du serveur SMTP et les destinations utilisables des messages doivent d'abord être configurées dans le logiciel Control Expert.

Les paramètres supplémentaires EN et ENO peuvent être configurés.

Représentation en FBD

Représentation en LD

Représentation en IL

CAL SEND_EMAIL (ADR := Channel_Address, HEAD_KEY := Header_Number, SUBJ_STR := Str_Email_Subject, BODY_STR := Str_Email_Body, GEST := Management_Param);

Représentation en ST

SEND_EMAIL (ADR := Channel_Address, HEAD_KEY := Header_Number, SUBJ_STR := Str_Email_Subject, BODY_STR := Str_Email_Body, GEST := Management_Param);

Description des paramètres

Le tableau suivant décrit les paramètres d’entrée :

Paramètre	Type	Description
`Channel_Address`	`ARRAY [0..7] OF INT`	Adresse ou résultat de la fonction ADDM. Utilise la fonction élémentaire ADDM pour composer ce champ. Fonction ADDM Pour envoyer un message électronique via le port Ethernet d'une UC, spécifiez ADDM(‘0.0.3’). Pour envoyer un message électronique via un module BMX NOC configuré dans le rack 0, à l'emplacement 4 et sur la voie 0, spécifiez ADDM(‘0.4.0’).
`Header_Number`	`INT`	Correspond aux adresses de messagerie gérées avec le logiciel Control Expert (seules les valeurs 1, 2 et 3 sont acceptées).
`Str_Email_Subject`	`STRING`	Représente la partie dynamique de l'objet qui est ajoutée à la fin de la chaîne d'objet statique.
`Str_Email_Body`	`STRING`	Représente le corps du message électronique.

Le tableau suivant décrit les paramètres d’entrée/sortie :

Paramètre	Type	Commentaire
`Management_Param`	`ARRAY [0..3] OF INT`	Tableau de gestion des échanges. Tableau de 4 mots utilisé pour contrôler les paramètres d'exécution. Le paramètre de longueur (4e mot du tableau de gestion) est un paramètre de sortie. Ce mot est écrit par le système et indique la longueur totale du message électronique (en-tête + corps). La longueur totale maximale est de 1024 caractères.

Paramètre

Type

Commentaire

Management_Param

ARRAY [0..3] OF INT

Tableau de gestion des échanges.

Tableau de 4 mots utilisé pour contrôler les paramètres d'exécution.

Le paramètre de longueur (4e mot du tableau de gestion) est un paramètre de sortie. Ce mot est écrit par le système et indique la longueur totale du message électronique (en-tête + corps). La longueur totale maximale est de 1024 caractères.

Règles d'envoi de messages électroniques (Send Email)

Après l'exécution de la fonction élémentaire SEND_EMAIL, le bit d'activité est sur 1 jusqu'à ce que le message électronique soit envoyé. Cependant, le message ne fait l'objet d'aucun accusé de réception. Si un timeout est programmé (3e mot de gestion <> 0), le message électronique est annulé s'il n'a pas été envoyé pendant la période programmée. Dans ce cas, le deuxième mot de gestion reçoit une réponse négative : Echange interrompu en cas de timeout (0x01).

Caractéristiques d'exécution : le système Modicon M340 peut gérer quatre requêtes d'envoi simultanées, émanant de quatre fonctions élémentaires. Si une cinquième fonction élémentaire tente d'envoyer un message, elle reçoit un message d'erreur Pas de ressources système processeur (0x0B), jusqu'à ce que l'une des ressources soit libérée.

Exemple de service d'envoi de message électronique

IF (default_id = 0) and FE(default_state) THEN

   (* POMPE OK *)

   SEND_EMAIL(ADDM('0.0.3'), 1, 'Pompe n°3 OK', ' ' , Management_Param);

ELSEIF RE(default_state) THEN

   (* POMPE DEFECTUEUSE *)

   str_default := INT_TO_STRING(default_id);

   str_Email_Body := CONCAT_STR(' Default = ', str_default);

   SEND_EMAIL(ADDM('0.0.3'), 1, 'Pompe n°3 défectueuse', str_Email_Body, Management_Param);

END_IF;