Description

Description de la fonction

La fonction OUT_IN_CHAR permet l'émission d’une chaîne de 210 octets maximum (120 pour la prise terminal) suivie d'une demande de réception de message (l'émission seule ou la réception seule est également possible).

La chaîne de caractères peut être contenue dans une variable statique ou définie sous forme de valeur immédiate (série d'octets entre apostrophes, par exemple 'Message à envoyer').

Ces chaînes peuvent contenir des caractères spéciaux et doivent débuter par le caractère $ suivi par la valeur hexadécimale du caractère à transmettre, exemple $0D.

Certains caractères spéciaux peuvent être utilisés, par exemple :

$R = CR (retour chariot) $L = LF (retour à la ligne) $N = CR+LF

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

Représentation en FBD

Représentation en LD

Représentation en IL

Représentation :

LD Address

OUT_IN_CHAR Mode, Data_to_Send, Management_Param, Received_Data

Représentation en ST

Représentation :

OUT_IN_CHAR(Address, Mode, Data_to_Send, Management_Param, Received_Data);

Description des paramètres

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

Paramètre	Type	Commentaire
`Address`	ARRAY [0...5] OF `INT`	Adresse de l’entité destinataire de l’échange. Seules les adresses se terminant par `SYS` sont possibles (par exemple : `{Network.Station}SYS`).
`Mode`	`INT`	Mode d’opération : 1 : émission suivie du mode réception 2 : émission d’un message 3 : mise en réception de message
`Data_to_Send`	`STRING`	Chaîne de caractères à envoyer. Cette chaîne de caractères doit obligatoirement exister lors de l’appel de la fonction, même s’il n’y a aucune donnée à émettre (mode réception simple par exemple).

Paramètre

Type

Commentaire

Address

ARRAY [0...5] OF INT

Adresse de l’entité destinataire de l’échange. Seules les adresses se terminant par SYS sont possibles (par exemple : {Network.Station}SYS).

Mode

INT

Mode d’opération :

1 : émission suivie du mode réception
2 : émission d’un message
3 : mise en réception de message

Data_to_Send

STRING

Chaîne de caractères à envoyer. Cette chaîne de caractères doit obligatoirement exister lors de l’appel de la fonction, même s’il n’y a aucune donnée à émettre (mode réception simple par exemple).

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

Le tableau suivant décrit les paramètres de sortie :

Paramètre	Type	Commentaire
`Received_Data`	`STRING`	Chaîne de caractères reçue. Cette chaîne de caractères doit obligatoirement exister lors de l’appel de la fonction, même s’il n’y a aucune donnée à recevoir (mode émission simple par exemple).

NOTE : Lors d’une émission ou d’une émission suivie d’une réception, il est conseillé d’initialiser le quatrième mot de la table de gestion (longueur) avant d'exécuter la fonction. D’autre part, la longueur de la chaîne de caractères reçue est mémorisée dans ce même mot à la fin de l’échange. Toutefois, il faut au préalable lors de la configuration définir une condition d’arrêt.

Pour envoyer des chaînes de caractères contenant des caractères de fin de chaîne (ZERO), vous devez :

Utiliser des chaînes localisées.
Initialiser le dernier mot de la table de gestion des échanges avec le nombre de caractères à envoyer. Si vous initialisez ce mot avec la valeur 0, la chaîne envoyée s’arrêtera au premier caractère ZERO rencontré. Si vous l’initialisez avec une valeur, la longueur de la chaîne de caractères envoyée sera égale à cette valeur.