Description

Description de la fonction

La fonction ADDM permet de convertir une chaîne de caractères en une adresse pouvant être utilisée directement par les fonctions de communication READ_VAR, WRITE_VAR, INPUT_CHAR, PRINT_CHAR, DATA_EXCH et SEND_EMAIL.

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

Représentation en FBD

Représentation en LD

Représentation en IL

LD Addr_String

ADDM

ST Addr_Array

Représentation en ST

Addr_Array := ADDM(Addr_String);

Description des paramètres d'entrée

Le tableau suivant décrit le paramètre d'entrée :

Paramètre	Type	Commentaire
`IN`	Chaîne de caractères	Adresse de l'équipement sur un bus ou sur un réseau.

L'entrée est la concaténation d'au maximum trois éléments pouvant prendre différentes valeurs. Chaque élément est facultatif :

Port de sortie utilisé localement pour joindre l'équipement cible :	Equipement cible	Service à joindre au niveau de l'équipement cible :
r.m.c Netlink NOTE : dans le premier cas, le numéro de la voie `c` est facultatif.	{hostAddr} node {hostAddr}node	`SYS` `MBS` `SMTP` `TCP.MBS` `CON.CIP` `UNC.CIP`

Port de sortie utilisé localement pour joindre l'équipement cible :

Equipement cible

Service à joindre au niveau de l'équipement cible :

r.m.c
Netlink

NOTE : dans le premier cas, le numéro de la voie c est facultatif.

{hostAddr}
node
{hostAddr}node

SYS
MBS
SMTP
TCP.MBS
CON.CIP
UNC.CIP

Définitions :

Netlink : nom du réseau indiqué dans le champ Lien réseau de la voie Ethernet.
hostAddr : adresse IP de l'hôte à joindre.
r : numéro de rack de la voie de communication.
m : position de module de la voie de communication.
c : numéro de la voie de communication.
node : nœud Modbus ou CANopen présent derrière une passerelle (identifiée par adresse_hôte [hostAddr]).
SYS : pour effectuer l'adressage du serveur du système.
MBS : pour effectuer l'adressage du serveur du système Modbus (identique à SYS).
SMTP : pour effectuer l'adressage du serveur SMTP.
TCP.MBS : pour effectuer l'adressage d'un serveur Modbus TCP.
CON.CIP : pour effectuer l'adressage d'un équipement connecté via Ethernet/IP.
UNC.CIP : pour effectuer l'adressage d'un équipement non connecté via Ethernet/IP.

NOTE : pour configurer une communication via le port Ethernet d'une UC Modicon M580, utilisez r=0, m=0 et c=3.

Liste des cas d'emploi :

Syntaxes d'adresse	Commentaire
`’{hostAddr}’` `’{hostAddr}SYS’` `’{hostAddr}TCP.MBS’`	Permet d'accéder à l'hôte (`hostAddr`) via le lien réseau configuré le plus proche de l'UC. Exemple : `ADDM(’{192.168.2.3}TCP.MBS’)`.
`’Netlink{hostAddr}’` `’Netlink{hostAddr}SYS’` `’Netlink{hostAddr}TCP.MBS’`	Permet d'accéder à l'hôte (`hostAddr`) via le réseau Ethernet (`Netlink`) défini dans le navigateur de projet de Control Expert, sous Communication > Réseaux . Exemple : `ADDM(’Ethernet_1{192.168.2.3}SYS’)`.
`’Netlink{hostAddr}node’`	Permet d'accéder au nœud présent derrière la passerelle `’Netlink{hostAddr}’`. Il peut s'agir d'un serveur Modbus TCP ou d'un esclave sur liaison Modbus série géré par la passerelle. Exemple : `ADDM(’Ethernet_1{192.168.2.3}255’)`.
`’r.m.c{hostAddr}’` `’r.m.c{hostAddr}SYS’` `’r.m.c{hostAddr}TCP.MBS’`	Permet d'accéder à l'hôte (`hostAddr`) d'après le rack, le module et la voie du module Ethernet. Exemple : `ADDM(’0.0.3{192.168.2.3}’)`.
`’r.m.c{hostAddr}node’`	Permet d'accéder au nœud présent derrière la passerelle `’r.m.c{hostAddr}’`. Il peut s'agir d'un serveur Modbus TCP ou d'un esclave sur liaison Modbus série géré par la passerelle. Exemple : `ADDM(’0.0.3{192.168.2.3}255’)`.
`’r.m.c{hostAddr}CON.CIP’` `’r.m.c{hostAddr}UNC.CIP’`	Permet d'accéder à un équipement via un réseau Ethernet/IP. Le suffixe `CON.CIP` est utilisé lorsque l'équipement est connecté (une liaison est encore établie avec l'équipement). Dans le cas contraire, `UCN.CIP` est utilisé. Exemple 1 : `ADDM(’0.0.3{192.168.20.34}CON.CIP’)` pour une UC Ethernet Modicon M580. Exemple 2 : `ADDM(’0.4.0{192.168.20.34}CON.CIP’)` pour une UC Modicon M340 avec un module BMX NOC à l'emplacement 4 du rack 0.
`’r.m.c’` `’r.m.c.SYS’`	Permet d'accéder au système d'une voie Modbus ou d'envoyer des données via une liaison en mode caractère. NOTE : `c`= 0 ou 1. Exemple : `ADDM(’1.5.0.SYS’)`.
`’r.m.c.e’` `’r.m.c.e.MBS’`	Permet d'accéder au serveur de l'équipement esclave sur liaison Modbus série. NOTE : `c`= 0 ou 1, `e`=1 à 247. Exemple : `ADDM(’1.5.1.54.MBS’)`.
Cas particulier de l'UC M340 avec CANopen intégré : `’0.0.2.e’`	Permet d'accéder au serveur `e` de l'esclave CANopen. NOTE : `e`=1 à 127. Exemple : `ADDM(’10.0.2.67’)`.

Syntaxes d'adresse

Commentaire

’{hostAddr}’

’{hostAddr}SYS’

’{hostAddr}TCP.MBS’

Permet d'accéder à l'hôte (hostAddr) via le lien réseau configuré le plus proche de l'UC.

Exemple : ADDM(’{192.168.2.3}TCP.MBS’).

’Netlink{hostAddr}’

’Netlink{hostAddr}SYS’

’Netlink{hostAddr}TCP.MBS’

Permet d'accéder à l'hôte (hostAddr) via le réseau Ethernet (Netlink) défini dans le navigateur de projet de Control Expert, sous Communication > Réseaux .

Exemple : ADDM(’Ethernet_1{192.168.2.3}SYS’).

’Netlink{hostAddr}node’

Permet d'accéder au nœud présent derrière la passerelle ’Netlink{hostAddr}’. Il peut s'agir d'un serveur Modbus TCP ou d'un esclave sur liaison Modbus série géré par la passerelle.

Exemple : ADDM(’Ethernet_1{192.168.2.3}255’).

’r.m.c{hostAddr}’

’r.m.c{hostAddr}SYS’

’r.m.c{hostAddr}TCP.MBS’

Permet d'accéder à l'hôte (hostAddr) d'après le rack, le module et la voie du module Ethernet.

Exemple : ADDM(’0.0.3{192.168.2.3}’).

’r.m.c{hostAddr}node’

Permet d'accéder au nœud présent derrière la passerelle ’r.m.c{hostAddr}’. Il peut s'agir d'un serveur Modbus TCP ou d'un esclave sur liaison Modbus série géré par la passerelle.

Exemple : ADDM(’0.0.3{192.168.2.3}255’).

’r.m.c{hostAddr}CON.CIP’

’r.m.c{hostAddr}UNC.CIP’

Permet d'accéder à un équipement via un réseau Ethernet/IP. Le suffixe CON.CIP est utilisé lorsque l'équipement est connecté (une liaison est encore établie avec l'équipement). Dans le cas contraire, UCN.CIP est utilisé.

Exemple 1 : ADDM(’0.0.3{192.168.20.34}CON.CIP’) pour une UC Ethernet Modicon M580.

Exemple 2 : ADDM(’0.4.0{192.168.20.34}CON.CIP’) pour une UC Modicon M340 avec un module BMX NOC à l'emplacement 4 du rack 0.

’r.m.c’

’r.m.c.SYS’

Permet d'accéder au système d'une voie Modbus ou d'envoyer des données via une liaison en mode caractère.

NOTE : c= 0 ou 1.

Exemple : ADDM(’1.5.0.SYS’).

’r.m.c.e’

’r.m.c.e.MBS’

Permet d'accéder au serveur de l'équipement esclave sur liaison Modbus série.

NOTE : c= 0 ou 1, e=1 à 247.

Exemple : ADDM(’1.5.1.54.MBS’).

Cas particulier de l'UC M340 avec CANopen intégré : ’0.0.2.e’

Permet d'accéder au serveur e de l'esclave CANopen.

NOTE : e=1 à 127.

Exemple : ADDM(’10.0.2.67’).

Dans les exemples suivants, le troisième élément de la syntaxe n'est pas utilisé :

Equipement à adresser	Syntaxe d'ADDM
Equipement n° 4 sur la liaison CANopen	`ADDM('0.0.2.4')`
Imprimante ASCII sur la liaison série de l'UC	`ADDM('0.0.0')`
Equipement dont l'adresse est 192.168.100.10 sur une liaison Ethernet NOE	`ADDM('0.3.0{192.168.100.10}')` `ADDM('Ethernet_1{192.168.100.10}')`
Equipement Modbus n° 4 derrière une passerelle Ethernet dont l'adresse est 192.168.100.18 sur une liaison Ethernet NOE	`ADDM('0.3.0{192.168.100.18}4')` `ADDM('Ethernet_1{192.168.100.18}4')`

Pour plus d'informations, consultez la section sur l'adressage des automates M340 dans le manuel utilisateur Architectures de communication.

ATTENTION

COMPORTEMENT INATTENDU DE L'APPLICATION

N'utilisez pas des paramètres d'adresse erronés. Par exemple, ne définissez pas un paramètre d'adresse qui ne correspond pas à l'équipement cible.

Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels.

Description des paramètres de sortie

Le tableau suivant décrit le paramètre de sortie :

Paramètre	Type	Commentaire
OUT	`ADDM_TYPE` Tableau de 8 entiers	Tableau représentant l'adresse d'un équipement. Ce paramètre est utilisable par plusieurs fonctions de communication comme paramètre d'entrée.

Paramètre

Type

Commentaire

OUT

ADDM_TYPE

Tableau de 8 entiers

Tableau représentant l'adresse d'un équipement. Ce paramètre est utilisable par plusieurs fonctions de communication comme paramètre d'entrée.

Le bloc ADDM analyse la syntaxe de la chaîne d'adressage (paramètre IN) et place le résultat dans un tableau de 8 entiers simples qui définit l'adresse de destination. L'adresse de destination peut être fournie par le paramètre OUT de la fonction ADDM ou directement par un tableau de 8 objets INT. Cependant, il est vivement recommandé d'utiliser la fonction ADDM pour effectuer l'adressage d'une fonction élémentaire de communication.

La structure de l'adresse de destination est la suivante :

Champ	Taille	Valeur
`Type`	Octet	Réservé.
`ClientID`	Octet	Réservé.
`Rack`	Octet	Numéro d'emplacement du rack.
`Slot`	Octet	Numéro d'emplacement du module.
`Channel`	Octet	Numéro de la voie.
`ProtId`	Octet	Réservé. 0 pour Modbus.
`AddrLen`	Octet	Cet octet peut prendre les valeurs suivantes : 0 si le serveur du module ou de la voie est adressé (UnitId et `AddrExt` non utilisés), 1 si le numéro de l'équipement est défini, >1 si `AddrExt` est également utilisé.
`UnitId`	Octet	Numéro de l'équipement (équipement Modbus, par exemple).
`AddrExt`	4 entiers	Réservé. Permet de coder des informations supplémentaires concernant les adresses TCP/IP.

AVERTISSEMENT

FONCTIONNEMENT IMPREVU DE L'APPLICATION

Ne modifiez pas les paramètres réservés.

Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels.