SOCKET_INFO

L'istruzione SOCKET_INFO restituisce informazioni per un'istanza socket come codici di errore e stato di esecuzione. Le uscite vengono aggiornate in modo asincrono dalla scansione del programma.
Lingue supportate: Diagramma a blocchi funzione, Diagramma Ladder, Testo strutturato.
Questa istruzione vale per i controllori L20E, L50E e L70E.
SOCKET_INFO
SOCKET_INFO
Parametri SOCKET_INFO
Parametro
Tipo di parametro
Tipo di dati
Execute
Ingresso
BOOL
Abilitazione del blocco istruzione.
  • TRUE: quando viene rilevato un fronte di salita, avvia il blocco istruzione ammesso che l'ultima operazione sia stata completata.
  • FALSE: nessun fronte di salita rilevato.
Instance
Ingresso
UDINT
Copia il Socket Handler restituito da un'istruzione SOCKET_CREATE o SOCKET_ACCEPT per eliminare il rispettivo socket.
  • Per i tipi di socket client TCP e UDP, copiare il Socket Handler restituito da un'istruzione SOCKET_CREATE.
  • Per il tipo di socket server TCP, copiare il Socket Handler restituito da un'istruzione SOCKET_ACCEPT.
Se Instance è 0, restituisce un riepilogo di tutte le istanze Socket.
ClrDiagCnt
Ingresso
BOOL
  • TRUE: cancella le informazioni sul contatore di diagnostica Transmission Control Protocol (TCP) o User Datagram Protocol (UDP).
  • FALSE: nessuna cancellazione delle informazioni del contatore TCP o UDP.
Come TCP e UDP, l'indice dell'array OtherInfo da 1 a 6.
Se l'Istanza è 0, cancellare l'indice dell'array OtherInfo da 7 a 14.
Done
Uscita
BOOL
Indica se l'operazione è stata completata.
  • TRUE: Operazione completata correttamente.
  • FALSE: l'operazione è in corso oppure è stato generato un errore.
L'output viene aggiornato in modo sincrono alla scansione del programma.
Busy
Uscita
BOOL
  • TRUE: l'operazione non è terminata.
  • FALSE: l'operazione è terminata.
L'output viene aggiornato in modo sincrono alla scansione del programma.
Error
Uscita
BOOL
Indica che si è verificato un errore.
TRUE: È stato rilevato un errore.
FALSE: Nessun errore. 
L'output viene aggiornato in modo sincrono alla scansione del programma.
Status
Uscita
SOCK_STATUS
Stato definito utilizzando il Tipo di dati SOCK_STATUS che contiene le informazioni ErrorID, SubErrorID e StatusBits.
L'output viene aggiornato in modo sincrono alla scansione del programma.
SocketType
Uscita
USINT
Tipo di istanza Socket:
  • 0 - Non utilizzato
  • 1 - TCP
  • 2 - UDP
Se l'Istanza Socket_Info è 0, SocketType viene visualizzato come 0.
StreamType
Uscita
USINT
Tipo di Socket Stream:
  • 0 - Nessuno
  • 1 - Server TCP
  • 2 - Client TCP
Se l'Istanza Socket_Info è 0, StreamType viene visualizzato come 0.
TxQueCnt
Uscita
USINT
Numero di messaggi Tx attualmente in coda.
Se l'Istanza Socket_Info è 0, TxQueCnt viene visualizzato come 0.
RxQueCnt
Uscita
USINT
Numero di messaggi Rx attualmente in coda.
Se l'Istanza Socket_Info è 0, RxQueCnt viene visualizzato come 0.
SocketState
Uscita
USINT
Informazioni sullo stato dell'istruzione Socket. Per maggiori informazioni fare riferimento a Stato macchina Socket.
Se l'Istanza Socket_Info è 0, SocketState viene visualizzato come 0.
LocalAddr
Uscita
SOCKETADDR_CFG
Indirizzo locale per il socket. Per ulteriori informazioni, fare riferimento a Tipo di dati SOCKADDR_CFG.
Se l'Istanza Socket_Info è 0, LocalAddr viene visualizzato come 0.
RemoteAddr
Uscita
SOCKETADDR_CFG
Indirizzo remoto per il socket. Per ulteriori informazioni, fare riferimento a Tipo di dati SOCKADDR_CFG.
RemoteAddr viene visualizzato come 0 nei casi seguenti:
  • L'istanza Socket_Info è 0.
  • Connessioni User Datagram Protocol (UDP) senza SOCKET_OPEN.
  • UDP con SOCKET_OPEN e RxFilter disattivato.
OtherInfo
UDINT[1..15]
L'Istanza socket è configurata come TCP, la descrizione dell'indice del vettore è:
  • 1 - Pacchetto inviato: Numero totale di pacchetti TCP inviati su un Socket.
  • 2 - Byte inviati: Numero totale di byte TCP inviati su un Socket.
  • 3 - Pacchetto ricevuto: Numero totale di pacchetti TCP ricevuti per un Socket.
  • 4 - Byte ricevuti: Numero totale di byte TCP ricevuti su un Socket.
  • 5 - Pacchetti ritrasmessi: Numero totale di ritrasmissioni del pacchetto TCP.
  • 6 - Errori Checksum: Numero totale di pacchetti TCP con errori Checksum su un Socket.
  • 7 - Stato TCP: Stato corrente di un Socket.
  • (Da 8 a 11): OtherInfo non è supportato per TCP, viene visualizzato come 0.
  • 12 ,13,14,15 - Visualizzato come 0.
Istanza Socket configurata come UDP, la descrizione dell'indice Array è:
  • 1 - Pacchetto inviato: Numero totale di pacchetti UDP inviati su un Socket.
  • 2 - Byte inviati: Numero totale di byte UDP inviati su un Socket.
  • 3 - Pacchetto ricevuto: Numero totale di pacchetti UDP ricevuti su un Socket.
  • 4 - Byte ricevuti: Numero totale di byte UDP ricevuti su un Socket.
  • 5 - Pacchetti scartati: Numero totale di pacchetti UDP ricevuti e scartati per un Socket perché è stato superato il limite di dimensione massima della coda pari a 8.
  • 6 - Errori Checksum: Numero totale di pacchetti UDP con errori checksum su Socket.
  • Da 7 a 15 - Visualizzato come 0.
Istanza Socket configurata come 0, la descrizione dell'indice Array è:
  • 1 - Numero istanze Socket disponibili. Numero massimo di socket supportati.
  • 2 - Numero istanze Socket usate. Numero di socket creati correttamente.
  • 3 - Numero di istanze Socket create come TCP.
  • 4 - Numero di istanze Socket create come client TCP.
  • 5 - Numero di istanze Socket create come server TCP.
  • 6 - Numero di istanze Socket create come UDP.
  • 7 - Numero di SOCKET_READ completate correttamente quando l'istanza Socket è configurata come TCP.
  • 8 - numero di SOCKET_WRITE completate correttamente quando l'istanza Socket è configurata come TCP.
  • 9 - numero di SOCKET_READ non riuscite quando l'istanza Socket è configurata come TCP.
  • 10 - numero di SOCKET_WRITE non riuscite quando l'istanza Socket è configurata come TCP.
  • 11 - numero di SOCKET_READ completate correttamente quando l'istanza Socket è configurata come UDP.
  • 12 - numero di SOCKET_WRITE completate correttamente quando l'istanza Socket è configurata come UDP.
  • 13 - numero di SOCKET_READ non riuscite quando l'istanza Socket è configurata come UDP.
  • 14 - Numero di SOCKET_WRITE non riuscite quando l'istanza Socket è configurata come UDP.
  • 15 - Visualizzato come 0.

Esempi di SOCKET_INFO

Esempio di diagramma a blocchi funzionali SOCKET_INFO
Esempio di Diagramma a blocchi funzione SOCKET_INFO
Esempio di diagramma ladder SOCKET_INFO
Esempio di Diagramma Ladder SOCKET_INFO
Esempio di testo strutturato SOCKET_INFO
Esempio di Testo strutturato SOCKET_INFO
Risultati
Risultati
Fornire un feedback
Hai domande o feedback su questa documentazione? invia il tuo feedback qui.
Normal