SOCKET_INFO

L'instruction SOCKET_INFO renvoie des informations pour une instance de socket, comme les codes d'erreur et les états d'exécution. Les sorties sont mises à jour de manière synchrone par la scrutation du programme.

Langages pris en charge : Diagramme de bloc de fonctions, diagramme de schéma à relais et texte structuré.

Cette instruction s'applique aux contrôleurs

Micro820

L20E,

Micro850

L50E et

Micro870

L70E.

Paramètres SOCKET_INFO
Paramètre	Type de paramètre	Type de données
Execute	Entrée	BOOL	Activation du bloc d'instruction. TRUE : Front montant détecté, démarre le bloc d'instruction à condition que la dernière opération soit terminée. FALSE : Aucun front montant détecté.
Instance	Entrée	UDINT	Copiez le gestionnaire de socket renvoyé depuis une instruction SOCKET_CREATE ou SOCKET_ACCEPT pour supprimer le socket respectif. Pour les types de socket de client UDP et TCP, copiez le gestionnaire de socket renvoyé depuis une instruction SOCKET_CREATE. Pour le type de socket de serveur TCP, copiez le gestionnaire de socket renvoyé depuis une instruction SOCKET_ACCEPT. Lorsque l'instance est définie sur 0, un récapitulatif de toutes les instances de socket est renvoyé.
ClrDiagCnt	Entrée	BOOL	TRUE : Effacer les informations de compteur de diagnostic TCP (Transmission Control Protocol) ou UDP (User Datagram Protocol). FALSE : Les informations de compteur TCP ou UDP ne sont pas effacées. Comme pour TCP et UDP, index du tableau OtherInfo 1 à 6. Lorsque l'instance est définie sur 0, effacez les index du tableau OtherInfo 7 à 14.
Done	Sortie	BOOL	Indique la fin de l'opération. TRUE : L'opération s'est terminée avec succès. FALSE : L'opération est en cours ou a rencontré une condition d’erreur. La sortie est mise à jour de manière synchrone par l'analyse du programme.
Busy	Sortie	BOOL	TRUE : L'opération n'est pas terminée. FALSE : L'opération est terminée. La sortie est mise à jour de manière synchrone par l'analyse du programme.
Error	Sortie	BOOL	Indique une erreur. TRUE : Une erreur a été détectée. FALSE : Aucune erreur. La sortie est mise à jour de manière synchrone par l'analyse du programme.
Status	Sortie	SOCK_STATUS	L'état est défini à l'aide du Type de données SOCK_STATUS qui contient les informations sur ErrorID, SubErrorID et StatusBits. La sortie est mise à jour de manière synchrone par l'analyse du programme.
SocketType	Sortie	USINT	Type d'instance de socket : 0 - Non utilisée 1 - TCP 2 - UDP Lorsque l'instance Socket_Info est définie sur 0, SocketType s'affiche comme 0.
StreamType	Sortie	USINT	Type de flux de socket : 0 - Aucun 1 - Serveur TCP 2 - Client TCP Lorsque l'instance Socket_Info est définie sur 0, StreamType s'affiche comme 0.
TxQueCnt	Sortie	USINT	Nombre de messages Tx actuellement dans la file d'attente. Lorsque l'instance Socket_Info est définie sur 0, TxQueCnt s'affiche comme 0.
RxQueCnt	Sortie	USINT	Nombre de messages Rx actuellement dans la file d'attente. Lorsque l'instance Socket_Info est définie sur 0, RxQueCnt s'affiche comme 0.
SocketState	Sortie	USINT	Information d'état d'instruction du socket Pour en savoir plus, reportez-vous aux états de machine du socket. Lorsque l'instance Socket_Info est définie sur 0, SocketState s'affiche comme 0.
LocalAddr	Sortie	SOCKETADDR_CFG	Adresse locale pour le socket. Pour plus d’informations, reportez-vous à Type de données SOCKADDR_CFG. Lorsque l'instance Socket_Info est définie sur 0, LocalAddr s'affiche comme 0.
RemoteAddr	Sortie	SOCKETADDR_CFG	Adresse distante pour le socket. Pour plus d’informations, reportez-vous à Type de données SOCKADDR_CFG. RemoteAddr s'affiche comme 0 dans les cas suivants : L'instance Socket_Info est définie sur 0. Connexions UDP (User Datagram Protocol) sans SOCKET_OPEN. UDP avec SOCKET_OPEN et RxFilter désactivé.
OtherInfo		UDINT[1..15]	L'Instance de socket est configurée comme TCP et la description de l'index du tableau est : 1 - Paquets envoyés : nombre total de paquets TCP envoyés sur un socket. 2 - Octets envoyés : nombre total d'octets TCP envoyés sur un socket. 3 - Paquets reçus : nombre total de paquets TCP reçus sur un socket. 4 - Octets reçus : nombre total d'octets TCP reçus sur un socket. 5 - Paquets retransmis : nombre total de retransmissions de paquets TCP. 6 - Erreurs de somme de contrôle : nombre total de paquets TCP contenant des erreurs de somme de contrôle sur un socket. 7 - État TCP : état actuel d'un socket. (8 à 11) - OtherInfo n'est pas pris en charge par TCP, il s'affiche comme 0. 12 ,13,14,15 - S'affiche comme 0. Instance de socket configurée comme UDP, la description de l'index du tableau est : 1 - Paquets envoyés : nombre total de paquets UDP envoyés sur un socket. 2 - Octets envoyés : nombre total d'octets UDP envoyés sur un socket. 3 - Paquets reçus : nombre total de paquets UDP reçus sur un socket. 4 - Octets reçus : nombre total d'octets UDP reçus sur un socket. 5 - Paquet abandonnés : nombre total de paquets UDP reçus abandonnés pour un socket en raison d'un dépassement de la taille maximale de la file d'attente (8). 6 - Erreurs de somme de contrôle : nombre total de paquets UDP contenant des erreurs de somme de contrôle sur un socket. 7 à 15 - S'affiche comme 0. Instance de socket configurée comme 0, la description de l'index du tableau est : 1 - Nombre pour l'instance de socket disponible. Nombre maximal de sockets pris en charge. 2 - Nombre d'instances de socket utilisées. Nombre de sockets créés. 3 - Nombre d'instances de socket créées comme TCP. 4 - Nombre d'instances de socket créées comme client TCP. 5 - Nombre d'instances de socket créées comme serveur TCP. 6 - Nombre d'instances de socket créées comme UDP. 7 - SOCKET_READ Nombre de réussites lorsque l'instance de socket est configurée comme TCP. 8 - SOCKET_WRITE Nombre de réussites lorsque l'instance de socket est configurée comme TCP. 9 - SOCKET_READ Nombre d'échecs lorsque l'instance de socket est configurée comme TCP. 10 - SOCKET_WRITE Nombre d'échecs lorsque l'instance de socket est configurée comme TCP. 11 - SOCKET_READ Nombre de réussites lorsque l'instance de socket est configurée comme UDP. 12 - SOCKET_WRITE Nombre de réussites lorsque l'instance de socket est configurée comme UDP. 13 - SOCKET_READ Nombre d'échecs lorsque l'instance de socket est configurée comme UDP. 14 - SOCKET_WRITE Nombre d'échecs lorsque l'instance de socket est configurée comme UDP. 15 - S'affiche comme 0.

Exemples SOCKET_INFO

Exemple de diagramme de bloc de fonctions SOCKET_INFO

Exemple de schéma à relais SOCKET_INFO — Exemple de langage à relais SOCKET_INFO

Instructions de socket

Fournir une réponse

Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.