Propiedades de FB_TCPClient/FB_TCPClient2
Los bloques de funciones FB_TCPClient y FB_TCPClient2 proporcionan diversas propiedades para su supervisión y control. En las tablas siguientes se enumeran las propiedades y su pertenencia.
Propiedades comunes de FB_TCPClient y FB_TCPClient2
|
Nombre |
Tipo de datos |
Acceso |
Descripción |
|---|---|---|---|
|
IsReadable |
BOOL |
Lectura |
Indica que los datos se han recibido, pero el método Receive todavía no los ha procesado. |
|
IsWritable |
BOOL |
Lectura |
Indica que la conexión está en un estado en el que los datos se pueden enviar al servidor. |
|
PeerHasDisconnected |
BOOL |
Lectura |
Indica que el sitio remoto ha cerrado la conexión. De ser así, se llama automáticamente al método Shutdown y el estado cambia a Shutdown. |
|
Result |
Lectura |
Indica el resultado de la última llamada de método. Si el resultado es distinto de Ok, se mantendrá el valor de resultado aunque se llame otro método. |
|
|
State |
Lectura |
Indica el estado del socket. |
|
|
TotalBytesReceived |
ULINT |
Lectura |
Cuenta el número total de bytes recibidos. (Rango: de 1 a 264-1) |
|
TotalBytesSent |
ULINT |
Lectura |
Cuenta el número total de bytes enviados. (Rango: de 1 a 264-1) |
|
SockOpt_CustomPort |
UDINT |
Lectura/escritura |
Permite especificar el puerto TCP con el que se enlazará la conexión abierta por FB_TcpClient. Si el valor se establece en 0 (valor predeterminado), se utilizará el siguiente puerto que esté disponible. |
|
SockOpt_KeepAlive |
BOOL |
Lectura/escritura |
Si es TRUE, indica a la pila TCP que envíe paquetes vacíos de forma periódica para comprobar si se puede acceder al lado remoto. Cuando esto ya no sea así, el estado de la conexión cambia a Shutdown. NOTA: En la mayoría de los casos, establezca esta opción de modo que esto se detecte si no se puede conectar con el sitio remoto (se encuentra apagado o el cable desconectado). NOTA: Si la opción de socket KeepAlive está deshabilitada en el servidor, no se puede habilitar para los clientes conectados. |
|
SockOpt_NoDelay |
BOOL |
Lectura/escritura |
Si es TRUE, indica a la pila TCP que envíe los datos sin esperar a que el paquete esté completo. Esta opción reduce el rendimiento, pero mejora la latencia, que es un aspecto importante en aplicaciones industriales. |
|
SockOpt_ReceiveBufferSize |
UDINT |
Lectura/escritura |
Se utiliza para establecer u obtener el tamaño del búfer de recepción de la pila. Siempre debe ser mayor que la cantidad de datos recibidos de una sola vez para evitar la pérdida de datos. (Rango: de 1 a 2147483647) |
|
SockOpt_SendBufferSize |
UDINT |
Lectura/escritura |
Se utiliza para establecer u obtener el tamaño del búfer de envío de la pila. Siempre debe ser mayor que la cantidad de datos enviados de una sola vez. (Rango: de 1 a 2147483647) |
Propiedades adicionales de FB_TCPClient
|
Nombre |
Tipo de datos |
Acceso |
Descripción |
|---|---|---|---|
|
BytesAvailableToRead |
UDINT |
Lectura |
Indica el número de bytes en el búfer de recepción disponibles para su lectura mediante el método Receive. (Rango: de 0 a 2147483647) |
|
SockOpt_OutOfBandInline |
BOOL |
Lectura/escritura |
Si es TRUE, indica a la pila TCP que envíe los datos OutOfBand como parte del flujo de datos normal. |
Propiedades adicionales de FB_TCPClient2
|
Nombre |
Tipo de datos |
Acceso |
Descripción |
|---|---|---|---|
|
TimeoutConnectTls |
UDINT |
Lectura/escritura |
Indica el timeout en segundos para establecer la conexión mediante el método ConnectTls. |
|
TlsUsed |
BOOL |
Lectura |
Indica si la conexión TCP con el servidor se ha establecido o no mediante el método ConnectTls. |
