# TCPClient

La función TCPClient define una celda de hoja de cálculo como cliente TCP/IP, iniciándose con ello la comunicación con otro dispositivo TCP/IP para el intercambio de datos a través de la red.

Nota:

- La conexión entre la función de hoja de cálculo TCP y otro dispositivo TCP/IP se inicia inmediatamente al insertar la función TCPClient o cargar la tarea en la hoja de cálculo.

- TCPClient genera un evento tras recibir un paquete. Es un evento que actualiza la hoja de cálculo.

## TCPClient Entradas

Parámetro | Descripción
--- | ---
Nombre de host | Especifica el nombre o la dirección IP del dispositivo TCP con el que se quiere establecer una conexión. Si no se especifica el nombre de host, la función TCPClient da #ERR.
Número de puerto | Especifica el número del puerto en el que hay una conexión entre dispositivos TCP/IP. El número de puerto es un número sin signo de 16 bits. 0 no es un número de puerto válido. El número de puerto predeterminado es 3000. Nota: Debe asignar en el servidor el número de puerto que haya introducido aquí.
Tipo de paquete | Define el formateo de las cadenas de datos transferidas entre dispositivos TCP/IP.
Tipo | Descripción
--- | ---
0 = Cadena CR+LF (por defecto) | Formato ASCII. Cuando una función de hoja de cálculo TCP hace el envío, el software anexa los caracteres ASCII 13 (retorno de carro = CR) y 10 (salto de línea = LF) a la cadena de datos; cuando recibe, termina la cadena con CR+LF.
1 = Cadena CR (13) | Formato ASCII. Cuando una función de hoja de cálculo TCP hace el envío, el software anexa el carácter ASCII 13 (retorno de carro = CR) a la cadena de datos; cuando recibe, termina la cadena con CR.
2 = Cadena LF (10) | Formato ASCII. Cuando una función de hoja de cálculo TCP hace el envío, el software anexa el carácter ASCII 10 (salto de línea = LF) a la cadena de datos; cuando recibe, termina la cadena con LF.
3 = Cadena Nullchar (0) | Formato ASCII. Cuando una función de hoja de cálculo TCP hace el envío, el software anexa el carácter ASCII 0 (carácter nulo = Nullchar) a la cadena de datos; cuando recibe, termina la cadena con Nullchar. Nota: Sea cual sea el «Tipo de paquete», cuando una In-Sight sistema de visión recibe datos, la cadena de datos se termina siempre con el carácter ASCII 0 (Nullchar).
5 = Cadena con terminador personalizado | Formato ASCII. Cuando una función de hoja de cálculo TCP hace el envío, el software anexa el terminador especificado a la cadena de datos; cuando recibe, termina la cadena con el terminador especificado.
Tiempo de espera | El tiempo, en milisegundos (1000 a 15000; el valor predeterminado es 1000), que el sistema debe esperar como máximo para que TCPClient establezca la conexión TCP/IP y tras el cual cancelará el intento de conexión. Si no hay conexión, la función WriteDevice intentará establecer de nuevo una conexión. Si no se logra establecer la conexión durante el tiempo de espera, se visualizará un #ERR. Si hay conexión, pero la función TCPClient no ha podido poner el paquete en la cola del conector de red durante el tiempo de espera especificado, la función WriteDevice visualizará también un #ERR. La función TCPClient no da #ERR.
Terminador | Especifica el valor de byte que hay que utilizar para especificar el terminador para «Tipo de paquete»: «Cadena con terminador personalizado» o «Binario con terminador personalizado».
Tamaño máx. de paquete | Especifica el tamaño máximo del paquete que la función TCPClient puede recibir. Si el remitente remoto supera el tamaño máximo de paquete, la función ReadDevice visualizará un #ERR.

## TCPClient Salidas

Devuelve | Una estructura de datos Device. Da #ERR si alguno de los parámetros entrados no es válido.
Resultados | Cuando se inserta la función TCPClient en una celda, se incorpora automáticamente una función WriteDevice en la celda adyacente de la derecha.

## Ejemplo

Configurar un sistema de visión host In-Sight denominado SISTEMA0 con las celdas correspondientes que contienen los siguientes valores de parámetros:

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

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

Supongamos que configura un segundo sistema host denominado SISTEMA1, que incluye un servidor TCP/IP, con las celdas correspondientes que contienen los siguientes valores de parámetros:

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

B4=ReadDevice(A4)

Los dos sistemas, SISTEMA0 y SISTEMA1, están en línea.

Cada vez que se captura la imagen predeterminada en la celda $A$0 del SISTEMA0, el cliente TCP/IP de la celda A3 establece una conexión (si no está ya establecida) en el puerto 3000 con el servidor TCP/IP en la celda A4 del SISTEMA1.

La función WriteDevice en la celda B3 del SISTEMA0 exporta a continuación los datos de la celda C3 a la función ReadDevice en la celda B4 del SISTEMA1.