SOCKET_INFO

La instrucción SOCKET_INFO devuelve información de una instancia de socket tal como códigos de error y estados de ejecución. Las salidas se actualizan de forma síncrona desde la exploración del programa.
Idiomas compatibles: Diagrama de bloque de funciones, diagrama de lógica de escalera y texto estructurado.
Esta instrucción se aplica a los controladores L20E, L50E y L70E.
SOCKET_INFO
SOCKET_INFO
Parámetros de SOCKET_INFO
Parámetro
Tipo de parámetro
Tipo de datos
Execute
Entrada
BOOL
Habilitar bloque de instrucción.
  • CIERTO: Se ha detectado un flanco ascendente, inicia el bloque de instrucciones con la condición previa de que la última operación esté completa.
  • FALSO: No se ha detectado un flanco ascendente.
Instance
Entrada
UDINT
Copie el Controlador de socket devuelto a partir de una instrucción SOCKET_CREATE o SOCKET_ACCEPT para borrar el socket respectivo.
  • En el caso de los tipos de socket UDP y cliente TCP, copie el Controlador de socket devuelto a partir de una instrucción SOCKET_CREATE .
  • En el caso del tipo de socket Servidor TCP, copie el Controlador de socket devuelto a partir de una instrucción SOCKET_ACCEPT.
Si la instancia es 0, devuelve un resumen de todas las instancias de socket.
ClrDiagCnt
Entrada
BOOL
  • CIERTO: Borra la información de contador de diagnóstico del protocolo de control de transmisión (TCP) o del protocolo de datagramas de usuario (UDP).
  • FALSO: No borra la información del contador TCP o UDP.
Por ejemplo, el valor OtraInfo de TCP y UDP, Índice de matriz 1 a 6.
Si el valor Ocurrencia es 0, borre el valor OtraInfo, Índice de matriz 7 a 14.
Done
Salida
BOOL
Indica si la operación está completa.
  • CIERTO: Operación completada correctamente.
  • FALSO: La operación está en curso o se produjo una condición de error.
La salida se actualiza de forma síncrona desde la exploración del programa.
Busy
Salida
BOOL
  • CIERTO: La operación no está completa.
  • FALSO: La operación ha finalizado.
La salida se actualiza de forma síncrona desde la exploración del programa.
Error
Salida
BOOL
Indica que se ha producido un error.
CIERTO: Se ha detectado un error.
FALSO: No hay error. 
La salida se actualiza de forma síncrona desde la exploración del programa.
Status
Salida
SOCK_STATUS
El estado se define utilizando el Tipo de datos SOCK_STATUS que contiene información de ErrorID, SubErrorID y StatusBits.
La salida se actualiza de forma síncrona desde la exploración del programa.
SocketType
Salida
USINT
Tipo de instancia de socket:
  • 0: no utilizado
  • 1: TCP
  • 2: UDP
Si el valor Ocurrencia de Socket_Info es 0, TipoDeSocket se muestra como 0.
StreamType
Salida
USINT
Tipo de secuencia de socket:
  • 0: ninguno
  • 1: servidor TCP
  • 2: cliente TCP
Si el valor Ocurrencia de Socket_Info es 0, TipoDeSecuencia se muestra como 0.
TxQueCnt
Salida
USINT
Número de mensajes de Trans que hay actualmente en la cola.
Si el valor Ocurrencia de Socket_Info es 0, CantTransEnCola se muestra como 0.
RxQueCnt
Salida
USINT
Número de mensajes de Recep que hay actualmente en la cola.
Si el valor Ocurrencia de Socket_Info es 0, CantRecepEnCola se muestra como 0.
SocketState
Salida
USINT
Información de estado de la instrucción de socket. Para obtener más información, consulte Máquina de estado de socket.
Si el valor Ocurrencia de Socket_Info es 0, EstadoDeSocket se muestra como 0.
LocalAddr
Salida
SOCKETADDR_CFG
Dirección local para el socket. Para obtener más información, consulte Tipo de datos SOCKADDR_CFG.
Si el valor de Ocurrencia de Socket_Info es 0, DirecLocal se muestra como 0.
RemoteAddr
Salida
SOCKETADDR_CFG
Dirección remota para el socket. Para obtener más información, consulte Tipo de datos SOCKADDR_CFG.
El valor DirecRemota se muestra como 0 en los casos siguientes:
  • El valor Socket_Info Instance es 0.
  • Conexiones del protocolo de datagramas de usuario (UDP) sin SOCKET_OPEN.
  • UDP con SOCKET_OPEN y FiltroDeTrans deshabilitado.
OtherInfo
UDINT[1..15]
Ocurrencia de socket configurada como TCP; la descripción del Índice de matriz es la siguiente:
  • 1 - Paquete enviado: número total de paquetes TCP enviados a un socket.
  • 2 - Bytes enviados: número total de bytes TCP enviados a un socket.
  • 3 - Paquete recibido: número total de paquetes TCP recibidos en un socket.
  • 4 - Bytes recibidos: número total de bytes TCP recibidos en un socket.
  • 5 - Paquetes retransmitidos: número total de retransmisiones de paquetes TCP.
  • 6 - Errores de checksum: número total de paquetes TCP con errores de checksum que hay en un socket.
  • 7 - Estado TCP: estado actual de un socket.
  • (de 8 a 11): OtraInfo no es compatible con TCP; se muestra como 0.
  • 12, 13, 14, 15: se muestra como 0.
Instancia de socket configurada como UDP; la descripción de Índice de matriz es la siguiente:
  • 1 - Paquete enviado: número total de paquetes UDP enviados a un socket.
  • 2 - Bytes enviados: número total de bytes UDP enviados a un socket.
  • 3 - Paquete recibido: número total de paquetes UDP recibidos en un socket.
  • 4 - Bytes recibidos: número total de bytes UDP recibidos en un socket.
  • 5 - Paquetes eliminados: número total de paquetes UDP recibidos en un socket y eliminados por superar el límite de tamaño de cola máximo de 8.
  • 6 - Errores de checksum: número total de paquetes UDP con errores de checksum que hay en un socket.
  • De 7 a 15: se muestran como 0.
Instancia de socket configurada como 0; la descripción de Índice de matriz es la siguiente:
  • 1 - Recuento de instancias de socket disponibles. Máximo número de sockets admitido.
  • 2 - Recuento de instancias de socket disponibles. Número de sockets creados satisfactoriamente.
  • 3 - Número de instancias de socket creadas como TCP.
  • 4 - Número de instancias de socket creadas como cliente TCP.
  • 5 - Número de instancias de socket creadas como servidor TCP.
  • 6 - Número de instancias de socket creadas como UDP.
  • 7 - Recuento correcto de SOCKET_READ cuando la instancia de socket se configura como TCP.
  • 8 - Recuento correcto de SOCKET_WRITE cuando la instancia de socket se configura como TCP.
  • 9 - Recuento erróneo de SOCKET_READ cuando la instancia de socket se configura como TCP.
  • 10 - Recuento erróneo de SOCKET_WRITE cuando la instancia de socket se configura como TCP.
  • 11 - Recuento correcto de SOCKET_READ cuando la instancia de socket se configura como UDP.
  • 12 - Recuento correcto de SOCKET_WRITE cuando la instancia de socket se configura como UDP.
  • 13 - Recuento erróneo de SOCKET_READ cuando la instancia de socket se configura como UDP.
  • 14 - Recuento erróneo de SOCKET_WRITE cuando la instancia de socket se configura como UDP.
  • 15 - Se muestra como 0.

Ejemplos de SOCKET_INFO

Ejemplo de diagrama de bloque de funciones SOCKET_INFO
Ejemplo de diagrama de bloque de funciones SOCKET_INFO
Ejemplo de diagrama de lógica de escalera SOCKET_INFO
Ejemplo de diagrama de lógica de escalera SOCKET_INFO
Ejemplo de texto estructurado SOCKET_INFO
Ejemplo de texto estructurado SOCKET_INFO
Resultados
Resultados
Entregue su opinión
¿Tiene dudas o comentarios acerca de esta documentación? Por favor deje su opinión aquí.
Normal