Description fonctionnelle

La fonction INPUT_BYTE permet d'envoyer une requête de lecture de tableau d'octets à un module de communication en mode caractère. Le message reçu est enregistré dans un tableau d'octets.

NOTE : En général, INPUT_BYTE se comporte comme INPUT_CHAR, mais elle permet de transmettre un tableau d'octets à la place d'une chaîne en tant que paramètre de sortie. Pour cette raison, il est possible de lire une valeur d'octet 0 (NULL) dans un flux d'octets émis par un port série.

Pour les automates Premium, cette fonction permet de recevoir jusqu'à 4 Ko (120 octets au niveau du port terminal).

Sur les ModiconM340 M580CPU et , cette fonction permet de recevoir jusqu'à 1024 octets.

Deux possibilités s'offrent à vous :

  • Lire un nombre d'octets : Aucune condition ne doit être configurée.

  • Lire un message : Une condition d'arrêt doit être configurée dans l'écran de configuration.

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

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

LD Address
INPUT_BYTE Raz, Buffer_Length, Management_Param, Received_Data

Représentation en ST

Représentation :

INPUT_BYTE(Address, Raz, Buffer_Length, Management_Param, Received_Data);

Description des paramètres

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

Paramètre

Type

Commentaire

ADR

ARRAY [0..5] OF INT pour Premium

ARRAY [0..7] OF INT pour Modicon M340 et M580

Pour l'automate Premium :

  • L'adresse de la voie (en mode caractères) de réception du message est indiquée par la fonction ADDR.

  • Seules les adresses se terminant par SYS sont valides (par exemple, port terminal du processeur 0.0.0.SYS).

Pour l'automate Modicon M340 :

  • L'adresse de la voie (en mode caractères) de réception du message est indiquée par la fonction ADDM.

  • La syntaxe de l'adresse est de type ADDM. Le champ Node est facultatif. Il peut être de type SYS ou vide (par exemple ADDM('0.0.0.SYS') est égal à ADDM('0.0.0').

Pour la M580CPU Modicon  :

  • Adresse de l'entité cible de l'opération d'entrée, résultat de la fonction ADDMX.

RAZ

INT

Réinitialisation. Ce paramètre permet de réinitialiser la mémoire de réception du coupleur.

  • valeur 0 : pas de réinitialisation de la mémoire

  • valeur 1 : réinitialisation de la mémoire

REMARQUE : Pour les communications au niveau du port terminal des automates Premium, la valeur doit être 1.

REMARQUE : Sur les module CPU Modicon M340 et M580, l'EF INPUT_BYTE peut être programmée avec ou sans ce paramètre.

NB

INT

Longueur du tampon ou nombre d'octets à recevoir.

  • Valeur = 0 : Message lu dès qu'il est disponible sur la voie. Ici, une condition d'arrêt doit être spécifiée dans l'écran de configuration.

  • Valeur supérieure à 0 : Indique le nombre d'octets à lire.

REMARQUE : Pour les communications au niveau du port terminal des automates Premium, 0 est la seule valeur autorisée. Le caractère de fin de message par défaut est un retour chariot (CR).

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

Paramètre

Type

Commentaire

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 et qui définit la longueur de l'échange.

Pour plus d'informations, consultez la section Structure des paramètres de gestion.

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

Paramètre

Type

Commentaire

RECP

ARRAY OF BYTE

Octets reçus. Le résultat est ensuite stocké dans un tableau BYTE.

NOTE : la taille des données reçues (en octets) est automatiquement écrite par le système dans le quatrième mot du tableau de gestion.

Règles de programmation

Si plusieurs fonctions INPUT_BYTE sont lancées simultanément, le paramètre RAZ doit être réglé sur 0 (mémoire de réception du module non réinitialisée).

Une requête peut être envoyée afin de réinitialiser la mémoire du module pour le message suivant, afin de ne pas recevoir d'anciennes données.

Si le paramètre RAZ est réglé sur 1, la fonction INPUT_BYTE doit être lancée avant d'envoyer des données.

Sur les automates Premium, plusieurs cycles d'automate sont nécessaires pour recevoir une chaîne de plus de 240 octets (la chaîne est fragmentée). Il est donc important de s'assurer que les données de gestion n'ont pas été modifiées au cours du traitement de la fonction. Le système reçoit la chaîne de manière cohérente sur plusieurs fragments.

Sur les M340 Modicon M580CPU et , un seul cycle d'UC est nécessaire pour recevoir une chaîne de caractères de 1024 octets maximum. Il est important de s'assurer que les données de gestion n'ont pas été modifiées au cours du traitement de la fonction.

Le port série de l'automate Modicon M340 est en duplex intégral. Par conséquent, une fonction PRINT_CHAR peut être envoyée même si une fonction INPUT_BYTE a été envoyée et mise en attente.