# TCPClient

La fonction TCPClient définit une cellule de feuille de calcul comme client TCP/IP, ce qui initie la communication avec un autre périphérique TCP/IP pour le partage de données sur le réseau.

Remarque :

- La connexion entre la fonction de feuille de calcul TCP et un autre périphérique TCP/IP démarre immédiatement lorsque vous ajoutez la fonction TCPClient ou chargez le projet dans la feuille de calcul.

- TCPClient génère un événement après avoir reçu un paquet. Cet événement met à jour la feuille de calcul.

## TCPClient – entrées

Paramètre | Description
--- | ---
Nom d’hôte | Indique le nom ou l’adresse IP du périphérique TCP avec lequel vous établissez une connexion. Si vous n’indiquez pas le nom d’hôte, la fonction TCPClient renvoie #ERR.
Numéro de port | Indique le numéro de port utilisé pour les connexions entre les périphériques TCP/IP. Le numéro de port est un numéro de port de 16 bits non signé. 0 n’est pas un port valide. Le numéro de port par défaut est 3000. Remarque : Vous devez attribuer le numéro de port entré ici sur le serveur.
Type de paquet | Définit le format de la chaîne de données transmise entre les périphériques TCP/IP.
Type | Description
--- | ---
0 = Chaîne RC+SL (par défaut) | Format ASCII. Lorsqu’une fonction de feuille de calcul TCP envoie des données, le logiciel ajoute les caractères ASCII 13 (retour chariot ou CR) et 10 (saut de ligne ou LF) à la chaîne de données ; à la réception, CR+LF met fin à la chaîne de données.
1 = Chaîne RC/RC (13) | Format ASCII. Lorsqu’une fonction de feuille de calcul TCP envoie des données, le logiciel ajoute le caractère ASCII 13 (retour chariot) à la chaîne de données. À la réception, CR met fin à la chaîne de données.
2 = Chaîne SL/LF (10) | Format ASCII. Lorsqu’une fonction de feuille de calcul TCP envoie des données, le logiciel ajoute le caractère ASCII 10 (retour chariot) à la chaîne de données. À la réception, LF met fin à la chaîne de données.
3 = Chaîne Zéro (0) | Format ASCII. Lorsqu’une fonction de feuille de calcul TCP envoie des données, le logiciel ajoute le caractère ASCII 0 (caractère nul) à la chaîne de données. À la réception, « nul » met fin à la chaîne de données. Remarque : Quel que soit le type de paquet, lorsqu’un système de vision In-Sight reçoit des données, le caractère ASCII 0 (nul) termine la chaîne de données.
5 = Chaîne avec terminaison personnalisée | Format ASCII. Lorsqu’une fonction de feuille de calcul TCP envoie des données, le logiciel ajoute le caractère de terminaison spécifié à la chaîne de données. À la réception, ce caractère de terminaison met fin à la chaîne de données.
Délai d’attente | Le nombre de millisecondes (1000 à 15000 ; 1000 par défaut) d’attente de TCPClient pour établir une connexion TCP/IP avant l’abandon de la tentative de connexion. S’il n’y a pas de connexion WriteDevice essaie de se reconnecter. Si la tentative échoue pendant la durée définie par le délai d’attente, un #ERR est affiché. S’il existe une connexion, mais que TCPClient ne peut pas mettre le paquet en file d’attente sur le socket réseau pendant le délai d’attente, WriteDevice affiche également #ERR. TCPClient ne renvoie pas de #ERR.
Terminaison | Définit la valeur d’octet à utiliser lorsque vous indiquez Chaîne avec terminaison personnalisée ou Binaire avec terminaison personnalisée pour le type de paquet.
Taille de paquet maximale | Indique la taille maximale des paquets que TCPClient peut recevoir. Si l’expéditeur dépasse la taille maximale de paquets définie, ReadDevice indique une #ERR.

## TCPClient – Sorties

Renvoie | Une structure de données Device. Renvoie #ERR si l’un des paramètres d’entrée est incorrect.
Résultats | Lorsque vous insérez la fonction TCPClient dans une cellule, une fonction WriteDevice est automatiquement insérée dans la cellule adjacente de droite.

## Exemple

Configurez un système de vision hôte In-Sight nommé SYSTEM0 avec les cellules associées contenant les valeurs de paramètres suivantes :

A3=TCPClient("SYSTEM1",3000,0,1000,0,1024)

B3=WriteDevice($A$0,A3,C3)

Supposons que vous configuriez un second système hôte, appelé SYSTEM1 , qui comprend un serveur TCP/IP, avec les cellules associées contenant les valeurs de paramètres suivantes :

A4=TCPServer(3000,0,0,1024)

B4=ReadDevice(A4)

Les deux systèmes, SYSTEM0 et SYSYEM1 sont en ligne.

Chaque fois que l’image par défaut de la cellule $A$0 sur SYSTEM0 est acquise, le client TCP/IP de la cellule A3 établit une connexion (si ce n’est pas déjà le cas) avec le serveur TCP/IP de la cellule A4 sur le SYSTEM1 avec le port 3000.

La fonction WriteDevice de la cellule B3 sur SYSTEM0 exporte les données de la cellule C3 vers la fonction ReadDevice de la cellule B4 sur le SYSTEM1.