Description fonctionnelle

Utilisez le bloc fonction élémentaire CLOSE_TCP_CNX pour fermer les connexions TPC ouvertes.

NOTE :
  • Avec un module de communication BMX NOE 01•0 dans le rack local :

    • Le bloc fonction CLOSE_TCP_CNX est compatible uniquement avec les versions de micrologiciel supérieures à V3.20.

    • Si le module utilise un micrologiciel de version égale ou inférieure à V3.20, un code d'erreur 16#3104 apparaît pour indiquer que le micrologiciel du module n'est pas à jour et n'est pas compatible avec le bloc fonction CLOSE_TCP_CNX.

  • Le bloc fonction CLOSE_TCP_CNX n'est pas compatible avec les processeurs M340 BMX P34 •0•0•.

Représentation du bloc fonction élémentaire (EFB)

Le bloc fonction élémentaire CLOSE_TCP_CNX se présente comme suit :

Description des paramètres

Les tableaux suivants décrivent les paramètres inclus dans le bloc fonction élémentaire CLOSE_TCP_CNX.

Paramètres d'entrée :

Paramètre

Type de données

Description

ADR

ANY_ARRAY_INT

Ce tableau contient l'adresse de l'entité destinataire de l'échange de données après application de la fonction ADDM. Il indique le module et la voie qui gèrent la connection. Par exemple, ADDM(0.3.0) représente la voie 0 du module situé à l'emplacement 3 du rack 0.

TCPIP

STRING

Cette chaîne identifie la connexion TCP/IP qui est fermée dans le format suivant : ip1.ip2.ip3.ip4:port, où port identifie le port sur la cible distante. (Il ne correspond pas au port local utilisé pour la connexion.) Si plusieurs connexions sont ouvertes avec le même IP:port distant, elles sont toutes fermées. Si port n'est pas précisé, le port Modbus 502 est utilisé. NB : Les connexions ouvertes par le scrutateur d'E/S Modbus ne sont pas concernées et ne peuvent pas être fermées par l'utilisateur.

Paramètres d'entrée et de sortie :

Paramètre

Type de données

Description

GEST

ARRAY [0..3] OF INT

Table de gestion de l'échange composée des mots suivants :

  • Mot de rang 1 : mot géré par le système et composé de 2 octets :

    • octet de poids fort : numéro d'échange,

    • octet de poids faible : bit d'activité (rang 0) et bit d'annulation (rang 1)

      NOTE : Le bit d'annulation n'est disponible que pour les automates Modicon M340 et M580.
  • Mot de rang 2 : mot géré par le système et composé de 2 octets :

    • Octet de poids fort : compte rendu d'opération

    • Octet de poids faible : compte rendu de communication

  • Mot de rang 3 : mot géré par l'utilisateur et qui définit le temps de réponse maximum en utilisant une base de temps de 100 ms

  • Mot de rang 4 : mot (géré par le système pour la suppression) qui définit la longueur de l'échange. (Pour plus d'informations, reportez-vous à la description de la structure des paramètres de gestion.)

    NOTE : Pour CLOSE_TCP_CNX, le paramètre de longueur au rang 4 n'est pas spécifié par l'utilisateur. Juste après l'exécution de la logique, le bit d'activité est réglé sur 0 et le paramètre de longueur reçoit la valeur 2 (correspondant à la longueur de la valeur CNX_STATUS renvoyée) si aucune erreur n'est détectée pour le mot de rang 2. Sinon, la valeur de longueur est définie par un code d'état supplémentaire dans le cas d'un compte rendu d'opération 16#01 (requête non traîtée) ou 16#02 (réponse incorrecte). Les codes d'état indiqués dans ce champ correspondent à un sous-ensemble des codes de paramètre STATUS possibles pour les EFB de communication utilisant le paramètre STATUS. Les valeurs possibles de CLOSE_TCP_CNX comprennent 0x30ss, 0x31ss, 0x4001 et 0x4002. Reportez-vous à la description des codes d'erreur détectée pour le paramètre STATUS.

Paramètres de sortie :

Paramètre

Type de données

Description

CNX_STATUS

word

Ce mot fournit l'état détaillé du service après son exécution :

  • 16#0000: La connexion TCP s'est fermée correctement.

  • 16#0001: La connexion TCP n'est pas valide (paramètres IP ou de port incorrects).

  • 16#0002: La connexion TCP n'existe pas ou elle est déjà fermée.

  • 16#FFFF: Le service ne s'est pas exécuté. Reportez-vous au code d'état indiqué dans le mot de compte rendu de la table de gestion (GEST[1]).

Utilisation de l'EFB

Pour utiliser le bloc fonction élémentaire CLOSE_TCP_CNX :

Etape

Action

1

Définissez l'adresse de la voie de communication qui gère la connexion dans ADR. (Utilisez le bloc ADDM pour indiquer cette adresse dans un format de chaîne explicite.)

2

Indiquez la connexion à fermer dans le paramètre TCPIP.

3

Appelez la fonction qui lance la communication (avec la broche d'entrée EN à 1 si elle est configurée).

4

Surveillez le bit d'activité (dans le paramètre GEST) jusqu'à la fin de la communication (bit d'activité réglé à 0 par le système). Exécutez une seule fois cette fonction pour conserver les valeurs d'état. La fonction n'est pas appelée lorsque le bit d'activité est à 0 (par exemple, par la définition sur 0 de la broche EN).

5

Vérifiez le mot CNX_STATUS. Si CNX_STATUS = 16#FFFF, consultez le paramètre de compte rendu dans GEST[1].