SOCKET_INFO

A instrução SOCKET_INFO retorna informações de uma instância de soquete, como códigos de erro e status de execução. As saídas são atualizadas de maneira assíncrona a partir da varredura do programa.
Linguagens suportadas: Diagrama de blocos de função, diagrama de ladder, texto estruturado.
Essa instrução aplica-se aos controladores L20E, L50E e L70E.
SOCKET_INFO
SOCKET_INFO
Parâmetros da SOCKET_INFO
Parâmetro
Tipo do parâmetro
Tipo de dados
Execute
Entrada
BOOL
Habilitação do bloco de instruções.
  • TRUE: Borda ascendente detectada; inicia o bloco de instruções com a pré-condição de que a última operação tenha sido concluída.
  • FALSE: Nenhuma Borda ascendente detectada.
Instance
Entrada
UDINT
Copia o Manipulador de soquete retornado de uma instrução SOCKET_CREATE ou SOCKET_ACCEPT para excluir o respectivo soquete.
  • Para os tipos de soquete UDP e TCP Client, copia o Manipulador de soquete retornado de uma instrução SOCKET_CREATE.
  • Para o tipo de soquete TCP Server, copia o Manipulador de soquete retornado de uma instrução SOCKET_ACCEPT.
Quando Instance for 0, retorna um resumo de todas as Instâncias de soquete.
ClrDiagCnt
Entrada
BOOL
  • TRUE: Limpa informações do contador de Diagnóstico de Transmission Control Protocol (TCP) ou de User Datagram Protocol (UDP).
  • FALSE: Sem limpeza das informações do contador de TCP ou UDP.
Como TCP e UDP, o índice de matriz de 1 a 6 do OtherInfo.
Quando Instância é 0, limpa o índice de matriz de 7 a 14 do OtherInfo.
Done
Saída
BOOL
Indica quando a operação é concluída.
  • TRUE: Operação concluída com êxito.
  • FALSE: A operação está em progresso ou foi encontrada uma condição de erro.
A saída é atualizada de maneira síncrona a partir da varredura do programa.
Busy
Saída
BOOL
  • TRUE: A operação não foi concluída.
  • FALSE: A operação foi concluída.
A saída é atualizada de maneira síncrona a partir da varredura do programa.
Error
Saída
BOOL
Indica a ocorrência de um erro.
TRUE: Um erro foi detectado.
FALSE: Sem erro. 
A saída é atualizada de maneira síncrona a partir da varredura do programa.
Status
Saída
SOCK_STATUS
O status é definido usando o Tipo de dados SOCK_STATUS que contém informações de ErrorID, SubErrorID e StatusBits.
A saída é atualizada de maneira síncrona a partir da varredura do programa.
SocketType
Saída
USINT
Tipo de instância do soquete:
  • 0 – Não usado
  • 1 - TCP
  • 2 - UDP
Quando a Instância de Socket_Info for 0, SocketType será exibido como 0.
StreamType
Saída
USINT
Tipo de transmissão de soquete:
  • 0 – Nenhum
  • 1 - Servidor TCP
  • 2 - Cliente TCP
Quando a Instância de Socket_Info for 0, StreamType será exibido como 0.
TxQueCnt
Saída
USINT
Número de mensagens Tx atualmente na fila.
Quando Instância de Socket_Info for 0, TxQueCnt será exibido como 0.
RxQueCnt
Saída
USINT
Número de mensagens Rx atualmente na fila.
Quando a Instância de Socket_Info for 0, RxQueCnt será exibido como 0.
SocketState
Saída
USINT
Informações do estado da instrução de soquete. Para obter mais informações, consulte a Máquina de estado de soquete.
Quando a Instância de Socket_Info for 0, SocketState será exibido como 0.
LocalAddr
Saída
SOCKETADDR_CFG
Endereço local para o soquete. Para obter mais informações, consulte Tipo de dados SOCKADDR_CFG.
Quando a Instância de Socket_Info for 0, LocalAddr será exibido como 0.
RemoteAddr
Saída
SOCKETADDR_CFG
Endereço remoto para o soquete. Para obter mais informações, consulte Tipo de dados SOCKADDR_CFG.
RemoteAddr é exibido como 0, nos seguintes casos:
  • A Instância de Socket_Info é 0.
  • Conexões de User Datagram Protocol (UDP) são realizadas sem SOCKET_OPEN.
  • UDP com SOCKET_OPEN e RxFilter desabilitado.
OtherInfo
UDINT[1..15]
A Instância do soquete configurada como TCP, descrição do índice de matriz é:
  • 1 – Pacote enviado: Número total de pacotes TCP enviados em um soquete.
  • 2 – Bytes enviados: Número total de bytes TCP enviados em um soquete.
  • 3 – Pacote recebido: Número total de pacotes TCP recebidos em um soquete.
  • 4 – Bytes recebidos: Número total de bytes TCP recebidos em um soquete.
  • 5 - Retransmitir pacotes: Número total de retransmissões de pacotes TCP.
  • 6 – Erros de soma de verificação: Número total de pacotes TCP com erros de soma de verificação em um soquete.
  • 7 - Estado de TCP: Estado atual de um soquete.
  • (8 a 11) - OtherInfo não é suportado para TCP, exibido como 0.
  • 12 ,13,14,15 - Exibido como 0.
Instância do soquete configurada como UDP, a Descrição do índice de matriz é:
  • 1 – Pacote enviado: Número total de pacotes UDP enviados em um soquete.
  • 2 – Bytes enviados: Número total de bytes UDP enviados em um soquete.
  • 3 – Pacote recebido: Número total de pacotes UDP recebidos em um soquete.
  • 4 – Bytes recebidos: Número total de bytes UDP recebidos em um soquete.
  • 5 – Pacotes descartados: Número total de pacotes UDP recebidos que foram descartados de um soquete, pois excederam o limite máximo de tamanho da fila de 8.
  • 6 – Erros de soma de verificação: Número total de pacotes UDP com erros de soma de verificação em um soquete.
  • 7 a 15 - exibir como 0.
Instância do soquete configurada como 0, a Descrição de índice de matriz é:
  • 1 - Contagem para instância de soquete disponível. Número máximo de soquetes aceitos.
  • 2 - Contagem para instância de soquete usada. Número de soquetes criados com sucesso.
  • 3 – Número de instâncias de soquete criadas como TCP.
  • 4 - Número de instâncias de soquete criadas como cliente TCP.
  • 5 - Número de instâncias de soquete criadas como servidor TCP.
  • 6 - Número de instâncias de soquete criadas como UDP.
  • 7 - SOCKET_READ Contagem bem-sucedida quando a instância de soquete é configurada como TCP.
  • 8 - SOCKET_WRITE Contagem bem-sucedida quando a instância de soquete é configurada como TCP.
  • 9 - SOCKET_READ Falha na contagem quando a instância de soquete é configurada como TCP.
  • 10 - SOCKET_WRITE Falha na contagem quando a instância de soquete é configurada como TCP.
  • 11 - SOCKET_READ Contagem bem-sucedida quando a instância de soquete é configurada como UDP.
  • 12 - SOCKET_WRITE Contagem bem-sucedida quando a instância de soquete é configurada como UDP.
  • 13 - SOCKET_READ Falha na contagem quando a instância de soquete é configurada como UDP.
  • 14 - SOCKET_WRITE Falha na contagem quando a instância de soquete é configurada como UDP.
  • 15 - Exibido como 0.

Exemplos de SOCKET_INFO

Exemplo de diagrama de blocos de função SOCKET_INFO
Exemplo de diagrama de blocos de função SOCKET_INFO
Exemplo de diagrama de ladder SOCKET_INFO
Exemplo de diagrama de ladder SOCKET_INFO
Exemplo de texto estruturado SOCKET_INFO
Exemplo de texto estruturado SOCKET_INFO
Resultados
Resultados
Dê sua opinião
Tem dúvidas ou comentários sobre esta documentação? Por favor, envie seu comentário aqui.
Normal