Schneider Electric EcoStruxure™ Control Expert - TCP Open, Bibliothèque de blocs Mode d'emploi
PDF
Herunterladen
Dokument
EcoStruxure™ Control Expert 33002552 12/2018 EcoStruxure™ Control Expert TCP Open Bibliothèque de blocs (Traduction du document original anglais) 33002552.14 12/2018 www.schneider-electric.com Le présent document comprend des descriptions générales et/ou des caractéristiques techniques des produits mentionnés. Il ne peut pas être utilisé pour définir ou déterminer l'adéquation ou la fiabilité de ces produits pour des applications utilisateur spécifiques. Il incombe à chaque utilisateur ou intégrateur de réaliser l'analyse de risques complète et appropriée, l'évaluation et le test des produits pour ce qui est de l'application à utiliser et de l'exécution de cette application. Ni la société Schneider Electric ni aucune de ses sociétés affiliées ou filiales ne peuvent être tenues pour responsables de la mauvaise utilisation des informations contenues dans le présent document. Si vous avez des suggestions, des améliorations ou des corrections à apporter à cette publication, veuillez nous en informer. Vous acceptez de ne pas reproduire, excepté pour votre propre usage à titre non commercial, tout ou partie de ce document et sur quelque support que ce soit sans l'accord écrit de Schneider Electric. Vous acceptez également de ne pas créer de liens hypertextes vers ce document ou son contenu. Schneider Electric ne concède aucun droit ni licence pour l'utilisation personnelle et non commerciale du document ou de son contenu, sinon une licence non exclusive pour une consultation « en l'état », à vos propres risques. Tous les autres droits sont réservés. Toutes les réglementations locales, régionales et nationales pertinentes doivent être respectées lors de l'installation et de l'utilisation de ce produit. Pour des raisons de sécurité et afin de garantir la conformité aux données système documentées, seul le fabricant est habilité à effectuer des réparations sur les composants. Lorsque des équipements sont utilisés pour des applications présentant des exigences techniques de sécurité, suivez les instructions appropriées. La non-utilisation du logiciel Schneider Electric ou d'un logiciel approuvé avec nos produits matériels peut entraîner des blessures, des dommages ou un fonctionnement incorrect. Le non-respect de cette consigne peut entraîner des lésions corporelles ou des dommages matériels. © 2018 Schneider Electric. Tous droits réservés. 2 33002552 12/2018 Table des matières Consignes de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . . A propos de ce manuel. . . . . . . . . . . . . . . . . . . . . . . . . . Partie I Généralités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 1 Types de module et leur utilisation . . . . . . . . . . . . . . . . . Types de bloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structure d'un FFB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EN et ENO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 2 Disponibilité des blocs sur les différentes plates-formes matérielles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disponibilité des blocs sur les différentes plates-formes matérielles . Partie II Présentation de TCP Open. . . . . . . . . . . . . . . . . . . . Chapitre 3 Général . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Aspects et principes généraux de TCP Open . . . . . . . . . . . . . . . . . . . Chapitre 4 Avertissements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remarques et avertissements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 5 Description du fonctionnement . . . . . . . . . . . . . . . . . . . . Règles de fonctionnement des EF TCP Open . . . . . . . . . . . . . . . . . . Principe de fonctionnement d'un socket . . . . . . . . . . . . . . . . . . . . . . . Structure générale d'une EF de communication TCP Open . . . . . . . . Structure des paramètres de gestion TCP Open . . . . . . . . . . . . . . . . Paramètres de gestion : rapports de communication et d'opération . . Modèle client/serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Exemples d'applications client/serveur . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 6 Modes de fonctionnement et performances . . . . . . . . . . Modes opératoires du module réseau . . . . . . . . . . . . . . . . . . . . . . . . . Performances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mise au point et diagnostic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Partie III Avancé . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 7 FCT_ACCEPT : accepte une requête de connexion . . . Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 8 FCT_BIND : relie un numéro de socket à une adresse IP et à un port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33002552 12/2018 5 9 11 13 14 16 19 23 23 25 27 27 29 29 31 32 33 35 36 38 40 42 47 48 50 51 53 55 55 59 59 3 Chapitre 9 FCT_CLOSE : supprime le socket spécifié . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 10 FCT_CONNECT : établit une connexion avec une adresse IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 11 FCT_LISTEN : configuration d'une connexion en attente de socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 12 FCT_RECEIVE : récupère les données disponibles sur un socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 13 FCT_SELECT : multiplexe les requêtes sur les sockets . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 14 FCT_SEND : envoi de données à un socket spécifique. . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 15 FCT_SETSOCKOPT : configure les options associées au socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 16 FCT_SHUTDOWN : désactive la transmission sur le socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 17 FCT_SOCKET : création d'un nouveau socket . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Partie IV Bibliothèque de DFB . . . . . . . . . . . . . . . . . . . . . . . . Chapitre 18 Bibliothèque de DFB . . . . . . . . . . . . . . . . . . . . . . . . . . . . Présentation de la bibliothèque de DFB. . . . . . . . . . . . . . . . . . . . . . . . DFB TCP_CNX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DFB TCP_SEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DFB TCP_RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 63 63 67 67 71 71 73 73 77 77 81 81 85 85 89 89 93 93 97 99 100 101 104 107 111 113 33002552 12/2018 Consignes de sécurité Informations importantes AVIS Lisez attentivement ces instructions et examinez le matériel pour vous familiariser avec l'appareil avant de tenter de l'installer, de le faire fonctionner, de le réparer ou d'assurer sa maintenance. Les messages spéciaux suivants que vous trouverez dans cette documentation ou sur l'appareil ont pour but de vous mettre en garde contre des risques potentiels ou d'attirer votre attention sur des informations qui clarifient ou simplifient une procédure. 33002552 12/2018 5 REMARQUE IMPORTANTE L'installation, l'utilisation, la réparation et la maintenance des équipements électriques doivent être assurées par du personnel qualifié uniquement. Schneider Electric décline toute responsabilité quant aux conséquences de l'utilisation de ce matériel. Une personne qualifiée est une personne disposant de compétences et de connaissances dans le domaine de la construction, du fonctionnement et de l'installation des équipements électriques, et ayant suivi une formation en sécurité leur permettant d'identifier et d'éviter les risques encourus. AVANT DE COMMENCER N'utilisez pas ce produit sur les machines non pourvues de protection efficace du point de fonctionnement. L'absence de ce type de protection sur une machine présente un risque de blessures graves pour l'opérateur. AVERTISSEMENT EQUIPEMENT NON PROTEGE N'utilisez pas ce logiciel ni les automatismes associés sur des appareils non équipés de protection du point de fonctionnement. N'accédez pas aux machines pendant leur fonctionnement. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels. Cet automatisme et le logiciel associé permettent de commander des processus industriels divers. Le type ou le modèle d'automatisme approprié pour chaque application dépendra de facteurs tels que la fonction de commande requise, le degré de protection exigé, les méthodes de production, des conditions inhabituelles, la législation, etc. Dans certaines applications, plusieurs processeurs seront nécessaires, notamment lorsque la redondance de sauvegarde est requise. Vous seul, en tant que constructeur de machine ou intégrateur de système, pouvez connaître toutes les conditions et facteurs présents lors de la configuration, de l'exploitation et de la maintenance de la machine, et êtes donc en mesure de déterminer les équipements automatisés, ainsi que les sécurités et verrouillages associés qui peuvent être utilisés correctement. Lors du choix de l'automatisme et du système de commande, ainsi que du logiciel associé pour une application particulière, vous devez respecter les normes et réglementations locales et nationales en vigueur. Le document National Safety Council's Accident Prevention Manual (reconnu aux Etats-Unis) fournit également de nombreuses informations utiles. Dans certaines applications, telles que les machines d'emballage, une protection supplémentaire, comme celle du point de fonctionnement, doit être fournie pour l'opérateur. Elle est nécessaire si les mains ou d'autres parties du corps de l'opérateur peuvent entrer dans la zone de point de pincement ou d'autres zones dangereuses, risquant ainsi de provoquer des blessures graves. Les produits logiciels seuls, ne peuvent en aucun cas protéger les opérateurs contre d'éventuelles blessures. C'est pourquoi le logiciel ne doit pas remplacer la protection de point de fonctionnement ou s'y substituer. 6 33002552 12/2018 Avant de mettre l'équipement en service, assurez-vous que les dispositifs de sécurité et de verrouillage mécaniques et/ou électriques appropriés liés à la protection du point de fonctionnement ont été installés et sont opérationnels. Tous les dispositifs de sécurité et de verrouillage liés à la protection du point de fonctionnement doivent être coordonnés avec la programmation des équipements et logiciels d'automatisation associés. NOTE : La coordination des dispositifs de sécurité et de verrouillage mécaniques/électriques du point de fonctionnement n'entre pas dans le cadre de cette bibliothèque de blocs fonction, du Guide utilisateur système ou de toute autre mise en œuvre référencée dans la documentation. DEMARRAGE ET TEST Avant toute utilisation de l'équipement de commande électrique et des automatismes en vue d'un fonctionnement normal après installation, un technicien qualifié doit procéder à un test de démarrage afin de vérifier que l'équipement fonctionne correctement. Il est essentiel de planifier une telle vérification et d'accorder suffisamment de temps pour la réalisation de ce test dans sa totalité. AVERTISSEMENT RISQUES INHERENTS AU FONCTIONNEMENT DE L'EQUIPEMENT Assurez-vous que toutes les procédures d'installation et de configuration ont été respectées. Avant de réaliser les tests de fonctionnement, retirez tous les blocs ou autres cales temporaires utilisés pour le transport de tous les dispositifs composant le système. Enlevez les outils, les instruments de mesure et les débris éventuels présents sur l'équipement. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels. Effectuez tous les tests de démarrage recommandés dans la documentation de l'équipement. Conservez toute la documentation de l'équipement pour référence ultérieure. Les tests logiciels doivent être réalisés à la fois en environnement simulé et réel. Vérifiez que le système entier est exempt de tout court-circuit et mise à la terre temporaire non installée conformément aux réglementations locales (conformément au National Electrical Code des Etats-Unis, par exemple). Si des tests diélectriques sont nécessaires, suivez les recommandations figurant dans la documentation de l'équipement afin d'éviter de l'endommager accidentellement. Avant de mettre l'équipement sous tension : Enlevez les outils, les instruments de mesure et les débris éventuels présents sur l'équipement. Fermez le capot du boîtier de l'équipement. Retirez toutes les mises à la terre temporaires des câbles d'alimentation entrants. Effectuez tous les tests de démarrage recommandés par le fabricant. 33002552 12/2018 7 FONCTIONNEMENT ET REGLAGES Les précautions suivantes sont extraites du document NEMA Standards Publication ICS 7.1-1995 (la version anglaise prévaut) : Malgré le soin apporté à la conception et à la fabrication de l'équipement ou au choix et à l'évaluation des composants, des risques subsistent en cas d'utilisation inappropriée de l'équipement. Il arrive parfois que l'équipement soit déréglé accidentellement, entraînant ainsi un fonctionnement non satisfaisant ou non sécurisé. Respectez toujours les instructions du fabricant pour effectuer les réglages fonctionnels. Les personnes ayant accès à ces réglages doivent connaître les instructions du fabricant de l'équipement et les machines utilisées avec l'équipement électrique. Seuls ces réglages fonctionnels, requis par l'opérateur, doivent lui être accessibles. L'accès aux autres commandes doit être limité afin d'empêcher les changements non autorisés des caractéristiques de fonctionnement. 8 33002552 12/2018 A propos de ce manuel Présentation Objectif du document Ce document décrit les fonctions et blocs fonction de la bibliothèque TCP Open. Champ d'application Ce document est applicable à EcoStruxure™ Control Expert 14.0 ou version ultérieure. Documents à consulter Titre du document Numéro de référence EcoStruxure™ Control Expert - Langages de programmation et structure - Manuel de référence 35006144 (anglais), 35006145 (français), 35006146 (allemand), 35013361 (italien), 35006147 (espagnol), 35013362 (chinois) EcoStruxure™ Control Expert - Modes de fonctionnement 33003101 (anglais), 33003102 (français), 33003103 (allemand), 33003104 (espagnol), 33003696 (italien), 33003697 (chinois) Vous pouvez télécharger ces publications ainsi que d'autres informations techniques sur notre site Web : www.schneider-electric.com/en/download. 33002552 12/2018 9 10 33002552 12/2018 EcoStruxure™ Control Expert Généralités 33002552 12/2018 Partie I Généralités Généralités Vue d'ensemble Ce sous-chapitre présente des informations générales sur la bibliothèque TCP Open. Contenu de cette partie Cette partie contient les chapitres suivants : Chapitre 33002552 12/2018 Titre du chapitre Page 1 Types de module et leur utilisation 13 2 Disponibilité des blocs sur les différentes plates-formes matérielles 23 11 Généralités 12 33002552 12/2018 EcoStruxure™ Control Expert Types de module et leur utilisation 33002552 12/2018 Chapitre 1 Types de module et leur utilisation Types de module et leur utilisation Vue d'ensemble Ce chapitre décrit les différents types de module et leur utilisation. Contenu de ce chapitre Ce chapitre contient les sujets suivants : Sujet Page Types de bloc 14 Structure d'un FFB 16 EN et ENO 19 33002552 12/2018 13 Types de module et leur utilisation Types de bloc Types de bloc Différents types de bloc sont utilisés dans Control Expert. FFB est le terme générique pour tous les types de bloc. Une différence est faite entre les types de bloc suivants : Fonction élémentaire (EF) Bloc fonction élémentaire (EFB) Bloc fonction dérivé (DFB) Procédure NOTE : Les blocs fonction de mouvement ne sont pas disponibles sur la plate-forme Quantum. Fonction élémentaire Les fonctions élémentaires (EF) n'ont pas d'état interne et elles possèdent une seule sortie. Si les valeurs des entrées sont similaires, la valeur de la sortie est identique pour les exécutions de la fonction. Par exemple, l'ajout de deux valeurs donne le même résultat à chaque exécution. Une fonction élémentaire est représentée dans les langages graphiques (FBD et LD) sous forme de bloc avec des entrées et une sortie. Les entrées sont représentées à gauche du bloc et les sorties à droite. Le nom de la fonction, c'est-à-dire le type de fonction, est affiché au centre du bloc. Pour certaines fonctions élémentaires, il est possible d'augmenter le nombre d'entrées. NOTE : Unity Pro est l’ancien nom de Control Expert pour les versions 13.1 et antérieures. ATTENTION COMPORTEMENT INATTENDU DE L'EQUIPEMENT Pour Unity Pro V4.0 et les versions antérieures, n'utilisez pas de liens pour connecter les sorties des blocs fonction lorsque votre application repose sur des données de sortie persistantes d'un bloc EF. Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels. NOTE : Avec Unity Pro V4.0 et les versions antérieures, la désactivation d'un EF (EN=0) entraîne la réinitialisation des liens associés à ses entrées/sorties. Pour transférer l'état du signal, n'utilisez pas de lien. Une variable doit être connectée à la sortie de l'EF et être utilisée pour connecter l'entrée de l'élément. Avec Unity Pro V4.1 et les versions ultérieures, vous pouvez maintenir les liens de sortie même si un EF est désactivé en activant l'option Maintenir les liens de sortie sur les EF désactivés (EN=0) par l'intermédiaire du menu Outils → Programme → Langues → Commun. 14 33002552 12/2018 Types de module et leur utilisation Bloc fonction élémentaire Les blocs fonction élémentaires (EFB) ont un état interne. Si les valeurs des entrées sont identiques, les valeurs des sorties peuvent différer à chaque exécution du bloc fonction. Pour un compteur, par exemple, la valeur de la sortie est incrémentée. Un bloc fonction élémentaire est représenté dans les langages graphiques (FBD et LD) sous forme de bloc avec des entrées et des sorties. Les entrées sont représentées à gauche du bloc et les sorties à droite. Le nom du bloc fonction, c'est-à-dire le type de bloc fonction, est affiché au centre du bloc. Le nom d'instance est affiché au-dessus du bloc. Bloc fonction dérivé Les blocs fonction dérivés (DFB) ont les mêmes caractéristiques que les blocs fonction élémentaires. Ils sont cependant créés par l'utilisateur dans les langages de programmation FBD, LD, IL et/ou ST. Procédure Les procédures correspondent à des fonctions proposant plusieurs sorties. Elles ne disposent pas d'état interne. L'unique différence par rapport aux fonctions élémentaires est que les procédures peuvent avoir plus d'une sortie et qu'elles supportent des variables du type de donnée VAR_IN_OUT. Les procédures ne renvoient aucune valeur. Les procédures sont un complément de la norme IEC 61131-3 et doivent être activées de manière explicite. Visuellement, il n'existe aucune différence entre les procédures et les fonctions élémentaires. NOTE : Unity Pro est l’ancien nom de Control Expert pour les versions 13.1 et antérieures. ATTENTION COMPORTEMENT INATTENDU DE L'EQUIPEMENT Pour Unity Pro V4.0 et les versions antérieures, n'utilisez pas de liens pour connecter les sorties des blocs fonction lorsque votre application repose sur des données de sortie persistantes d'un bloc EF. Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels. NOTE : Avec Unity Pro V4.0 et les versions antérieures, la désactivation d'un EF (EN=0) entraîne la réinitialisation des liens associés à ses entrées/sorties. Pour transférer l'état du signal, n'utilisez pas de lien. Une variable doit être connectée à la sortie de l'EF et être utilisée pour connecter l'entrée de l'élément. Avec Unity Pro V4.1 et les versions ultérieures, vous pouvez maintenir les liens de sortie même si un EF est désactivé en activant l'option Maintenir les liens de sortie sur les EF désactivés (EN=0) par l'intermédiaire du menu Outils → Programme → Langues → Commun. 33002552 12/2018 15 Types de module et leur utilisation Structure d'un FFB Structure Un FFB se compose d'une opération (nom du FFB), des opérandes nécessaires à l'opération (paramètres réels et formels) et d'un nom d'instance pour les blocs fonction élémentaires ou dérivés. Appel d'un bloc fonction dans le langage de programmation FBD : ATTENTION COMPORTEMENT INATTENDU DE L'APPLICATION N'appelez pas plusieurs fois la même instance de bloc pendant un cycle d'automate. Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels. 16 33002552 12/2018 Types de module et leur utilisation Appel formel d'un bloc fonction dans le langage de programmation ST : Opération L'opération détermine la fonction qui doit être exécutée par le FFB, par exemple : registre à décalage ou opérations de conversion. Opérande L'opérande détermine les éléments sur lesquels porte l'opération qui est exécutée. Dans les FFB, il est constitué de paramètres formels et de paramètres réels. Paramètres formels et réels Des entrées et des sorties permettent de transférer les valeurs vers ou depuis un FFB. Ces entrées et ces sorties sont appelées « paramètres formels ». Les paramètres formels sont liés à des objets qui comprennent les états courants du processus. Ces objets sont appelés « paramètres réels ». Durant l'exécution du programme, les valeurs sont transmises, par le biais des paramètres réels, du processus au FFB, et renvoyées à nouveau en sortie après le traitement. Le type de données des paramètres réels doit correspondre au type de données des entrées/sorties (paramètres formels). La seule exception concerne les entrées/sorties génériques dont le type de données est déterminé par le paramètre réel. On choisira un type de données adapté pour le bloc fonction, si les paramètres réels sont constitués de valeurs littérales. Appel de FFB dans le langage IL/ST Les FFB peuvent être appelés de deux manières dans les langages textuels IL et ST : formelle ou informelle. Pour obtenir des informations détaillées, reportez-vous au chapitre Langage de programmation (voir EcoStruxure™ Control Expert, Langages de programmation et structure, Manuel de référence). Exemple d'un appel de fonction formel : out:=LIMIT (MN:=0, IN:=var1, MX:=5); 33002552 12/2018 17 Types de module et leur utilisation Exemple d'un appel de fonction informel : out:=LIMIT (0, var1, 5); NOTE : Les paramètres EN et la sortie ENO peuvent uniquement être utilisés pour des appels formels. Variable VAR_IN_OUT Les FFB sont souvent utilisés pour lire une variable en entrée (variables d'entrée), la traiter et générer les valeurs modifiées de cette même variable (variables de sortie). Ce cas particulier d'une variable d'entrée/de sortie est également appelé variable VAR_IN_OUT. La relation entre la variable d'entrée et la variable de sortie est représentée dans les langages graphiques (FBD et LD) par une ligne. Bloc fonction avec la variable VAR_IN_OUT dans le langage FBD : Bloc fonction avec la variable VAR_IN_OUT dans le langage ST : MY_EXAMP1 (IN1:=Input1, IN2:=Input2, IO1:=Comb_IN_OUT, OUT1=>Output1, OUT2=>Output2); Tenez compte des points suivants lorsque vous utilisez des FFB avec les variables VAR_IN_OUT : Une variable doit être affectée à toutes les entrées VAR_IN_OUT. Aucune valeur littérale ou constante ne doit être affectée aux entrées/sorties VAR_IN_OUT. Les limitations supplémentaires de ces langages graphiques (FBD et LD) sont les suivantes : Les liaisons graphiques permettent uniquement de relier des sorties VAR_IN_OUT à des entrées VAR_IN_OUT. Seule une liaison graphique peut être associée à une entrée/sortie VAR_IN_OUT. Des variables ou des composantes de variables différentes peuvent être reliées à l'entrée VAR_IN_OUT et à la sortie VAR_IN_OUT. Dans ce cas, la valeur de la variable ou de la composante de variable en entrée est copiée dans la variable ou la composante de variable en sortie. Vous ne pouvez pas utiliser des négations sur les entrées/sorties VAR_IN_OUT. Une combinaison de variable/adresse et de liaisons graphiques n'est pas possible pour les sorties VAR_IN_OUT. 18 33002552 12/2018 Types de module et leur utilisation EN et ENO Description Une entrée EN et une sortie ENO peuvent être configurées pour tous les FFB. Si la valeur de EN est déjà réglée sur « 0 », lors de l'appel de FFB, les algorithmes définis par FFB ne sont pas exécutés et ENO est réglé sur « 0 ». Si la valeur de EN est déjà à « 1 », lors de l'appel de FFB, les algorithmes définis par FFB sont exécutés. Après l'exécution sans erreur de ces algorithmes, la valeur de ENO est réglée sur « 1 ». Si certaines conditions d'erreur sont détectées durant l’exécution de ces algorithmes, ENO est réglé sur « 0 ». Si aucune valeur n'est attribuée à la broche EN à l'appel du FFB, l'algorithme défini par ce dernier est exécuté (comme lorsque EN a la valeur « 1 »). Reportez-vous à la section Maintenir les liens de sortie sur les EF désactivés (voir EcoStruxure™ Control Expert, Modes de fonctionnement). Une fois les algorithmes exécutés, la valeur de ENO est réglée sur « 1 », sinon la valeur de ENO est réglée sur « 0 ». Si la valeur de ENO est réglée sur 0 (car EN = 0 ou en raison d'une condition d'erreur détectée lors de l'exécution ou de l'échec de l'exécution des algorithmes) : Blocs fonction Traitement des paramètres EN/ENO avec des blocs fonction qui possèdent (uniquement) une liaison en tant que paramètre de sortie : Si l'entrée EN de BlocFonction_1 est réglée sur « 0 », la connexion de sortie OUT de BlocFonction_1 conserve l'état qu'elle avait lors du dernier cycle correctement exécuté. Traitement des paramètres EN/ENO avec des blocs fonction qui possèdent une variable et une liaison en tant que paramètres de sortie : Si l'entrée EN de BlocFonction_1 est réglée sur « 0 », la connexion de sortie OUT de BlocFonction_1 conserve l'état qu'elle avait lors du dernier cycle correctement exécuté. La variable OUT1 présente sur la même broche conserve son état précédent ou peut être modifiée de manière externe sans incidence sur la connexion. La variable et la liaison sont enregistrées indépendamment l'une de l'autre. 33002552 12/2018 19 Types de module et leur utilisation Fonctions/procédures NOTE : Unity Pro est l’ancien nom de Control Expert pour les versions 13.1 et antérieures. ATTENTION COMPORTEMENT INATTENDU DE L'EQUIPEMENT Pour Unity Pro V4.0 et les versions antérieures, n'utilisez pas de liens pour connecter les sorties des blocs fonction lorsque votre application repose sur des données de sortie persistantes d'un bloc EF. Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels. NOTE : Avec Unity Pro V4.0 et les versions antérieures, la désactivation d'un EF (EN=0) entraîne la réinitialisation des liens associés à ses entrées/sorties. Pour transférer l'état du signal, n'utilisez pas de lien. Une variable doit être connectée à la sortie de l'EF et être utilisée pour connecter l'entrée de l'élément. Avec Unity Pro V4.1 et les versions ultérieures, vous pouvez maintenir les liens de sortie même si un EF est désactivé en activant l'option Maintenir les liens de sortie sur les EF désactivés (EN=0) par l'intermédiaire du menu Outils → Programme → Langues → Commun. Comme spécifié dans la norme CEI 61131-3, les sorties de fonctions désactivées (entrée EN réglée sur « 0 ») ne sont pas définies. (Cette caractéristique s'applique également aux procédures.) Voici une explication des états des sorties dans un tel cas : Traitement des paramètres EN/ENO avec des fonctions/procédures qui possèdent (uniquement) une liaison en tant que paramètre de sortie : Si l'entrée EN de Function/Procedure_1 est réglée sur 0, la connexion de sortie OUT de Function/Procedure_1 est également réglée sur 0. 20 33002552 12/2018 Types de module et leur utilisation Traitement des paramètres EN/ENO avec des blocs fonction qui possèdent une variable et une liaison en tant que paramètres de sortie : Si l'entrée EN de Function/Procedure_1 est réglée sur 0, la connexion de sortie OUT de Function/Procedure_1 est également réglée sur 0. La variable OUT1 présente sur la même broche conserve son état précédent ou peut être modifiée de manière externe sans incidence sur la connexion. La variable et la liaison sont enregistrées indépendamment l'une de l'autre. Le comportement de la sortie des FFB ne dépend pas de la façon dont les FFB sont appelés (sans EN/ENO ou avec EN=1). Appel de FFB conditionnel/inconditionnel Un FFB peut être appelé de manière « conditionnelle » ou « inconditionnelle ». La condition est établie en pré-connectant l'entrée EN. Entrée EN connectée appels conditionnels (le FFB est exécuté uniquement si EN = 1) Entrée EN affichée, masquée et marquée comme TRUE, ou affichée et non occupée appels inconditionnels (le FFB est traité indépendamment de l'entrée EN) NOTE : pour les blocs fonction désactivés (EN = 0) équipés d'une fonction d'horloge interne (par exemple DELAY), le temps semble s'écouler, étant donné qu'il est calculé à l'aide d'une horloge système et qu'il est, par conséquent, indépendant du cycle du programme et de la libération du bloc. ATTENTION EQUIPEMENT D'APPLICATION IMPREVU Ne désactivez pas les blocs fonction équipés d'une fonction d'horloge interne en cours de fonctionnement. Le non-respect de ces instructions peut provoquer des blessures ou des dommages matériels. 33002552 12/2018 21 Types de module et leur utilisation Remarque concernant les langages IL et ST Les paramètres EN et ENO peuvent uniquement être utilisés dans les langages textuels et dans le cadre d'un appel de FFB formel, par exemple : MY_BLOCK (EN:=enable, IN1:=var1, IN2:=var2, ENO=>error, OUT1=>result1, OUT2=>result2); L'affectation de variables à ENO doit être effectuée à l'aide de l'opérateur =>. EN et ENO ne peuvent pas être utilisés pour un appel informel. 22 33002552 12/2018 EcoStruxure™ Control Expert Disponibilité des blocs 33002552 12/2018 Chapitre 2 Disponibilité des blocs sur les différentes plates-formes matérielles Disponibilité des blocs sur les différentes plates-formes matérielles Disponibilité des blocs sur les différentes plates-formes matérielles Introduction Tous les blocs ne sont pas disponibles sur toutes les plates-formes matérielles. Les tableaux suivants indiquent les blocs disponibles sur votre plate-forme matérielle. Avancé Disponibilité des blocs : Nom de bloc Type de bloc M340 M580 Momentum Premium Quantum FCT_ACCEPT Procédure - - - + - FCT_BIND Procédure - - - + - FCT_BIND_UINT Procédure - - - + - FCT_CLOSE Procédure - - - + - FCT_CONNECT Procédure - - - + - FCT_CONNECT_UINT Procédure - - - + - FCT_LISTEN Procédure - - - + - FCT_RECEIVE Procédure - - - + - FCT_SELECT Procédure - - - + - FCT_SEND Procédure - - - + - FCT_SETSOCKOPT Procédure - - - + - FCT_SHUTDOWN Procédure - - - + - FCT_SOCKET Procédure - - - + - Légende : + Disponible - Non disponible 33002552 12/2018 23 Disponibilité des blocs 24 33002552 12/2018 EcoStruxure™ Control Expert Présentation de TCP Open 33002552 12/2018 Partie II Présentation de TCP Open Présentation de TCP Open Vue d'ensemble Cette partie présente le service TCP Open, qui peut être utilisé avec les fonctions élémentaires (EF) de Control Expert. Contenu de cette partie Cette partie contient les chapitres suivants : Chapitre 33002552 12/2018 Titre du chapitre Page 3 Général 27 4 Avertissements 29 5 Description du fonctionnement 31 6 Modes de fonctionnement et performances 47 25 Présentation de TCP Open 26 33002552 12/2018 EcoStruxure™ Control Expert Général 33002552 12/2018 Chapitre 3 Général Général Aspects et principes généraux de TCP Open Présentation TCP Open pour Premium propose un jeu de fonctions élémentaires (EF) et des blocs fonction dérivés (DFB) qui offrent des services TCP/IP dans une application d'automatisation sur les automates Premium. Les EF et les DFB TCP Open sont installés à partir d'un CD. Une fois installés dans Control Expert, ils apparaissent dans la bibliothèque TCP Open sous la famille Avancé. Ces fonctions prédéfinies peuvent être utilisées dans les applications TCP/IP client/serveur sans que cela suppose une connaissance préalable de langages de programmation tels que C ++ ou Java. La programmation s'effectue directement à travers l'utilisation des EF et des DFB dans le langage d'automatisation souhaité (ST, LD, FBD ou IL). TCP Open est disponible sur les modules suivants : TSX ETY 110WS TSX ETY 5103 Cette documentation contient une description des EF pour TCP Open. La documentation concernant les DFB pour TCP Open est fournie sur le CD d'installation. 33002552 12/2018 27 Général 28 33002552 12/2018 EcoStruxure™ Control Expert Avertissements 33002552 12/2018 Chapitre 4 Avertissements Avertissements Remarques et avertissements Présentation La mise en œuvre de services TCP/IP via les EF TCP Open est relativement simple. Il existe néanmoins quelques conditions préalables à cette mise en œuvre, laquelle repose sur les mêmes principes de développement qu'une application automatisée standard. Remarques Pour utiliser la bibliothèque d'EF TCP Open, vous devez avoir un minimum de connaissances sur l'utilisation des applications TCP/IP et le fonctionnement des systèmes de sockets. La mise en œuvre de services client/serveur obéit à certaines règles de programmation que vous devez comprendre. AVERTISSEMENT FONCTIONNEMENT INATTENDU DE L'EQUIPEMENT La mise en œuvre et la maintenance de TCP Open doivent être effectuées par un personnel qualifié uniquement, disposant des compétences nécessaires pour gérer les sockets. Ce document ne doit pas être considéré comme suffisant pour former une personne sans qualification au développement de services TCP/IP. Bien que toutes les précautions raisonnables aient été prises pour garantir l'exactitude et le caractère incontestable des informations fournies dans le présent document, Schneider Electric ne saurait être tenu responsable des éventuelles conséquences découlant de l'utilisation de ce document. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels. 33002552 12/2018 29 Avertissements Responsabilités Schneider Electric décline toute responsabilité par rapport aux problèmes suivants : AVERTISSEMENT ERREUR SYSTEME INATTENDUE La conception d'un système TCP Open implique : de vérifier et valider la conception de l'architecture du système de communication (modes et protocoles de fonctionnement client/serveur, performances, etc.), de vérifier la mise en œuvre d'EF appropriées (ou de la réutilisation des exemples d'EF inclus dans le kit TCP Open), de tester et valider les EF intégrées dans l'architecture du système de communication, de réaliser une maintenance appropriée et de gérer les erreurs de diagnostic. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels. 30 33002552 12/2018 EcoStruxure™ Control Expert Fonctionnement 33002552 12/2018 Chapitre 5 Description du fonctionnement Description du fonctionnement Objet de ce chapitre Ce chapitre décrit les principes qui régissent le fonctionnement et la mise en œuvre d'un service TCP/IP à l'aide des EF prédéfinies de TCP Open. Contenu de ce chapitre Ce chapitre contient les sujets suivants : Sujet Page Règles de fonctionnement des EF TCP Open 32 Principe de fonctionnement d'un socket 33 Structure générale d'une EF de communication TCP Open 35 Structure des paramètres de gestion TCP Open 36 Paramètres de gestion : rapports de communication et d'opération 38 Modèle client/serveur 40 Exemples d'applications client/serveur 42 33002552 12/2018 31 Fonctionnement Règles de fonctionnement des EF TCP Open Exécution d'une EF TCP Open Les EF TCP Open sont exécutées de façon asynchrone avec le cycle de l'automate. Chaque appel d'EF déclenche une transaction avec le module Ethernet concerné (TSX ETY 5103 ou TSX ETY 110WS). La transaction démarre à la fin du cycle de l'automate et son exécution complète peut prendre plusieurs cycles. Par conséquent, il est nécessaire de gérer la séquence des appels de façon à ne pas saturer le module ou demander une action alors que l'action précédente n'est pas encore terminée. Il est possible d'appeler plusieurs services TCP/IP dans le même cycle d'automate. Cependant, il n'est pas certain qu'ils seront traités dans l'ordre chronologique des appels. NOTE : Nous vous conseillons d'attendre la fin de l'exécution d'une fonction avant de demander un nouveau service sur le même socket. Par exemple, attendez que l'EF FCT_SOCKET soit renvoyée avant d'appeler l'EF FCT_BIND et attendez que l'EF FCT_BIND soit renvoyée avant d'appeler l'EF FCT_LISTEN. EF fournies Le nombre de fonctions TCP Open fournies et leur mode d'utilisation ont été délibérément limités pour simplifier la mise en œuvre de ces services. De plus, certains paramètres sont exigés par le module TSX ETY 5103. Ces limites sont décrites en détail dans la description de la fonction FCT_SOCKET (voir page 93). 32 33002552 12/2018 Fonctionnement Principe de fonctionnement d'un socket Introduction Le socket est l'élément de base de la communication TCP. C'est lui qui transporte les données. Les sockets fournis par la bibliothèque de fonctions TCP/IP ne servent qu'à la gestion des flux et à la connexion entre deux équipements. NOTE : L'architecture TSX ETY 5103 Premium peut prendre en charge jusqu'à 64 sockets. Ils peuvent être utilisés comme sockets d'écoute (serveur) ou comme sockets connectés (client). Dans une application serveur, au moins 1 socket doit être configuré comme socket d'écoute. C'est la seule restriction stricte concernant le nombre de connexions côté client et côté serveur. Pour créer un socket, vous pouvez utiliser la fonction FCT_SOCKET (voir page 93) ou la fonction FCT_ACCEPT (voir page 55). La fonction renvoie un numéro qui sert à accéder au socket. Etablissement d'une connexion serveur Le tableau suivant décrit les différentes étapes à mettre en œuvre côté serveur pour établir une connexion. Etape Action 1 Créer un socket à l'aide de la fonction FCT_SOCKET. 2 Associer le socket créé à une adresse (numéro de port et adresse IP) à l'aide de la fonction FCT_BIND (voir page 59). 3 Configurer le socket de sorte qu'il accepte les connexions à l'aide de la fonction FCT_LISTEN (voir page 71). Remarque : L'automate sert de serveur TCP : le socket initial écoute et reçoit les appels de connexion du socket client. 4 Appliquer la fonction FCT_ACCEPT (voir page 55) à ce socket pour créer un nouveau socket qui établira la connexion. Remarque : Ce nouveau socket est alors connecté au socket client et son numéro est renvoyé par la fonction FCT_ACCEPT. Le socket initial est alors libéré pour les autres clients qui souhaitent se connecter au serveur. Etablissement d'une connexion client Le tableau suivant décrit les différentes étapes à mettre en œuvre côté client pour établir une connexion. Etape Action 1 Créer un socket à l'aide du bloc fonction FCT_SOCKET. Le bloc renvoie un numéro de socket qui servira dans les blocs fonction suivants. 2 La fonction FCT_CONNECT permet d'établir une connexion avec un autre équipement Ethernet en spécifiant son adresse IP et le port que vous utiliserez pour la communication. 33002552 12/2018 33 Fonctionnement Echange de données via une connexion TCP Une fois la connexion établie, les données peuvent être transférées. Les transferts sont exécutés par les fonctions FCT_SEND (voir page 81) et FCT_RECEIVE (voir page 73). Le schéma cidessous montre comment fonctionnent ces échanges. Gestion des sockets D'autres fonctions peuvent être utilisées pour agir sur les sockets. 34 FCT_SETSOCKOPT (voir page 85) : associe des options à un socket. Ces options modifient le comportement du socket. FCT_SELECT (voir page 77) : sert à tester les événements sur les sockets. FCT_SHUTDOWN (voir page 89) : désactive la transmission sur le socket. FCT_CLOSE (voir page 63) : libère le descripteur du socket lorsqu'il n'est plus utilisé. 33002552 12/2018 Fonctionnement Structure générale d'une EF de communication TCP Open Présentation Les fonctions de communication sont traitées de façon asynchrone par rapport au cycle de l'automate. Une fonction lancée au cours d'un cycle s'exécute sur plusieurs cycles successifs. Les paramètres d'une fonction de communication TCP Open sont les suivants : Numéro d'interface Paramètres spécifiques Paramètres de gestion Numéro d'interface Le numéro d'interface correspond au numéro d'emplacement du module ETY dans le rack principal. NOTE : Seul le rack 0 peut accueillir un module Ethernet utilisant les fonctions de communication TCP Open. Dans le cas de TSXETY5103, l'architecture Premium divise cet entier en 2 octets. L'octet de poids faible contient le numéro d'emplacement des sockets. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets de la façon suivante : 00 sert à garantir une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 indique qu'il est possible d'utiliser 64 sockets. La version du micrologiciel doit être supérieure à 3.3 pour prendre en charge cette extension des sockets. NOTE : Lorsque vous définissez la valeur de l'octet de poids sur 01 (pour augmenter le nombre de sockets à 64), vérifiez que la version du micrologiciel TSXETY5103 est suffisante. Si vous tentez de paramétrer ainsi l'octet de poids fort avec une version 3.3 ou inférieure du micrologiciel, le module entrera dans un cycle incessant de redémarrages et ne sera pas opérationnel. Paramètres spécifiques Ces paramètres sont spécifiques à chaque fonction. Il peut y en avoir plusieurs, auquel cas ils sont séparés par des virgules. Ils sont décrits dans les chapitres spécifiques à chaque fonction. Paramètres de gestion Les paramètres de gestion sont représentés par une matrice de 4 entiers également appelée Table de gestion (voir page 36). Elle est identique à celle des EF de communication standard à ceci près que le numéro d'échange n'est pas géré et la temporisation diffère. 33002552 12/2018 35 Fonctionnement Structure des paramètres de gestion TCP Open Présentation Les paramètres de gestion sont regroupés dans un tableau de quatre entiers. Les valeurs contenues dans ce tableau servent à contrôler les fonctions de communication. NOTE : Dans la documentation technique, ces paramètres sont également désignés par les termes de table de gestion ou de compte rendu/rapport de gestion. Structure Le tableau ci-dessous décrit la structure des données de la table de gestion des fonctions de communication : Ordre des mots Octet de poids fort Octet de poids faible 1 Réservé Bit d'activité 2 Compte rendu d'opération Compte rendu de communication 3 Réservé 4 Longueur Bit d'activité Ce bit indique l'état d'exécution de la fonction de communication. Il prend la valeur 1 au lancement et revient à 0 une fois l'exécution terminée. Il s'agit du premier bit du premier élément de la table. Exemple : Si la table de gestion a été déclarée de la façon suivante : Tab_Gest ARRAY [1..4] OF INT, le bit d'activité est le bit avec la notation Tab_Gest[1].0. NOTE : Pour utiliser cette notation, Control Expert doit être utilisé en mode non IEC. Dans le cas contraire, Tab_Gest[1].0 n'est pas accessible de cette manière. Compte rendu d'opération Les comptes rendus d'opération sont décrits dans Rapport d'opération, page 39. Compte rendu de communication Les comptes rendus de communication sont décrits dans Rapport de communication, page 38. 36 33002552 12/2018 Fonctionnement Longueur Le paramètre de longueur est utilisé avec les fonctions FCT_SEND (voir page 81) et FCT_RECEIVE (voir page 73). Il est aussi utilisé avec la fonction FCT_SELECT (voir page 67). Avec FCT_SELECT, le champ de longueur n'est pas utilisé lorsque l'octet de poids fort du paramètre INTE est défini sur 00. Lorsque l'octet de poids fort du paramètre INTE est à 01, vous devez définir la longueur sur 8. La valeur 8 permet de voir les données associées aux 64 connexions. Si vous choisissez une valeur inférieure, 4 par exemple, vous ne verrez que les données associées aux 32 premières connexions. 33002552 12/2018 37 Fonctionnement Paramètres de gestion : rapports de communication et d'opération Présentation Les rapports de communication et d'opération font partie des paramètres de gestion. NOTE : il est recommandé de toujours tester les rapports de la fonction de communication à la fin de leur exécution et avant leur prochaine activation. En cas de redémarrage à froid, vous devez systématiquement vérifier que tous les paramètres de gestion des fonctions de communication sont remis à 0. Rapport de communication Ce rapport est commun à toutes les fonctions. Il est pertinent lorsque le bit d'activité passe de 1 à 0. Les rapports dont la valeur est comprise entre 16#01 et 16#FE concernent les erreurs détectées par le processeur qui a exécuté la fonction. Les différentes valeurs de ce rapport sont répertoriées dans le tableau suivant : Valeur Rapport de communication (octet de poids faible) 16#00 Echange réussi 16#01 Arrêt de l’échange sur time-out NOTE : lorsqu'une UC Modbus M340 envoie une requête DIFFUSION MODBUS, ce code d'erreur s'affiche même si la diffusion a abouti. 16#05 Format du paramètre Management incorrect 16#06 Paramètres spécifiques incorrects 16#07 Module réseau manquant ou adresse incorrecte 16#0B Aucune ressource système : le nombre d'EF de communication simultanées dépasse le nombre maximum autorisé par le processeur 16#0E Longueur d'envoi incorrecte 16#FF Message refusé NOTE : la valeur OK est renvoyée lorsqu'un TSX SCP ••• ou un TSX SCY ••• envoie une requête MODBUS BROADCAST. NOTE : cette fonction peut détecter une erreur dans les paramètres avant d'activer l'échange. Dans ce cas, le bit d'activité reste à 0 et le rapport est initialisé avec les valeurs correspondant à l'erreur. 38 33002552 12/2018 Fonctionnement Rapport d'opération Ce rapport décrit le résultat de l'interaction de la fonction avec la pile TCP/IP du module réseau. Il n'est pertinent que si le rapport de communication a les valeurs suivantes : 16#00 (échange réussi) 16#FF (message refusé) Si ce rapport a une valeur égale à 16#00, le rapport d'opération est propre à chaque fonction. Il est décrit dans les chapitres consacrés à ces fonctions. Si le rapport de communication a pour valeur 16#FF, le rapport d'opération a les valeurs suivantes : Valeur Rapport d'opération (octet de poids fort) 16#0B Aucune ressource système : le nombre d'EF de communication simultanées dépasse le nombre maximum autorisé par le processeur 16#0C Module réseau arrêté 33002552 12/2018 39 Fonctionnement Modèle client/serveur Présentation Le modèle client/serveur est constitué de deux entités. L'une d'elle sert de serveurrépondant aux requêtes, l'autre sert de client et est à l'origine de la requête. Le fonctionnement du modèle client/serveur est basé sur un protocole spécifique qui doit être implémenté à l'une des extrémités de la connexion. Une description de ce protocole est proposée dans les paragraphes qui suivent. NOTE : Si vous développez votre propre application client/serveur, vous êtes responsable du test et de la gestion des connexions. Description Le modèle fonctionne de la manière suivante : 40 L'application serveur écoute. Une application cliente demande des services à l'application serveur. L'application serveur accepte la requête. Des échanges sont effectués entre les deux entités. 33002552 12/2018 Fonctionnement Illustration Illustration du fonctionnement du modèle client/serveur 33002552 12/2018 41 Fonctionnement Exemples d'applications client/serveur Présentation Les connexions sont gérées par le programme d'application. Un client mettant fin à une connexion sans respecter la séquence TCP (suite à une coupure secteur par exemple) sera toujours considéré comme étant connecté tant qu'aucune autre donnée n'aura été envoyée ou qu'aucun autre événement ne se sera produit. Les paragraphes qui suivent proposent trois exemples significatifs qui devraient vous permettre de mieux comprendre le fonctionnement de l'architecture. Le côté client est représenté sous forme de diagramme de flux, tandis que le côté serveur est représenté sous forme d'une séquence d'opérations étroitement liées aux événements du côté client. Le scénario de l'exemple 2 représente une connexion coupée côté client après FCT_RECEIVE (Sj) car il n'y a pas de boucle de traitement SEND_RECEIVE. 42 33002552 12/2018 Fonctionnement Exemple 1 Le diagramme ci-dessous décrit le fonctionnement d'une application serveur lors du traitement de deux connexions demandées par deux clients. 33002552 12/2018 43 Fonctionnement Exemple 2 Le diagramme ci-dessous décrit le fonctionnement d'une application serveur lors du traitement de deux connexions demandées par le même client. La première déconnexion n'a pas été effectuée en respectant la procédure TCP correcte (comme dans le cas d'une coupure secteur par exemple). Le socket sera donc considéré comme étant toujours connecté tant que le client n'aura pas effectué de nouvelle connexion. 44 33002552 12/2018 Fonctionnement Exemple 3 Le diagramme ci-dessous décrit le fonctionnement d'une application serveur lors du traitement de deux connexions demandées par le même client. La première déconnexion n'a pas été effectuée en respectant la procédure TCP correcte (comme dans le cas d'une coupure secteur par exemple). Le socket sera donc considéré comme étant toujours connecté tant qu'aucune donnée n'aura été envoyée par le serveur. 33002552 12/2018 45 Fonctionnement 46 33002552 12/2018 EcoStruxure™ Control Expert Modes de fonctionnement et performances 33002552 12/2018 Chapitre 6 Modes de fonctionnement et performances Modes de fonctionnement et performances Objet de ce chapitre Ce chapitre tente de vous donner un aperçu des modes de fonctionnement, notions de base requises pour la mise au point, et des caractéristiques de performances du module TSX ETY 5103 (module Ethernet qui prend en charge les fonctions TCP Open). Contenu de ce chapitre Ce chapitre contient les sujets suivants : Sujet Page Modes opératoires du module réseau 48 Performances 50 Mise au point et diagnostic 51 33002552 12/2018 47 Modes de fonctionnement et performances Modes opératoires du module réseau Vue d'ensemble Le module TSX ETY 5103 présente 4 états de fonctionnement : hors tension exécution d'auto-tests configuré non configuré Les auto-tests sont effectués sous tension. Le module ne fonctionne pas avec la configuration par défaut. La configuration doit être envoyée à l'automate via le socket du terminal et non via le réseau. Si le module n'est pas correctement configuré, il ne peut pas traiter les sockets et un message de refus est renvoyé aux fonctions TCP Open. Envoi de la configuration au module La configuration est envoyée au module dans les cas suivants : 48 lorsqu'une application est téléchargée, lorsque l'automate est mis sous tension, lorsque le module est connecté au rack et qu'il est sous tension, en cas de redémarrage à chaud ou à froid, en cas de réinitialisation de l'automate Premium. 33002552 12/2018 Modes de fonctionnement et performances Mode de fonctionnement après configuration AVERTISSEMENT COMPORTEMENT INATTENDU DE L'APPLICATION - REDEMARRAGE A CHAUD OU A FROID Le programmeur doit tester les bits système %S0 et %S1 dans son application pour recréer les connexions en cas de démarrage à chaud ou à froid. Le programmeur doit aussi tester le bit système %S13 dans son application pour vérifier le premier balayage après une commande STOP/RUN à l'aide de l'application logicielle de l'automate. Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels. Une fois qu'une configuration a été définie, le module fonctionne de la façon suivante : Etape Action 1 Le module réinitialise la communication en cours. Résultat : les échanges en cours sont interrompus, les connexions TCP Open sont fermées et tous les sockets sont supprimés. 2 Le module se reconfigure lui-même. 3 Le module est prêt à traiter les fonctions de communication TCP Open de l'application. 33002552 12/2018 49 Modes de fonctionnement et performances Performances Nombre de connexions simultanées Le nombre maximum de connexions TCP/IP simultanées à un TSX ETY 5103 est de : 32 si l'octet de poids fort du paramètre INTE a pour valeur 00. Il peut y avoir 16 sockets connectés (client) et 16 sockets d'écoute (serveur). 64 si l'octet de poids fort du paramètre INTE a pour valeur 01. Les 64 sockets peuvent être utilisés au choix comme des sockets d'écoute (serveur) ou des sockets connectés (client). Toutes les combinaisons sont possibles, hormis une exception : dans une application serveur, il doit y avoir au moins un socket d'écoute. Echanges de données Le volume de données maximum qui peut être envoyé dans un cycle d'automate est de 240 octets. Cette limitation est due au mécanisme de bus X utilisé pour le transfert des données entre le module et le processeur. Si vous voulez transférer un message de 8 kilo-octets, vous devez le scinder en blocs de 240 octets. Si vous souhaitez garantir que l'ordre d'envoi des blocs sera respecté pour permettre la reconstitution intégrale du message, vous devez envoyer un bloc par cycle. Dans notre exemple, 35 cycles d'automate (8*10024/240) seront donc nécessaires. Un cycle d'automate de 50 ms prend 1,75 s. NOTE : Ces calculs se basent sur l'utilisation d'un seul socket. Si vous gérez plusieurs clients, vous devez tenir compte du nombre de sockets connectés. Pour un protocole de messagerie, une interface de niveau inférieur doit gérer le processus de fragmentation. Dans ce cas, les performances dépendent du nombre de fonctions FCT_SEND (voir page 81) ou FCT_RECEIVE (voir page 73) exécutées dans un même cycle d'automate. Les performances peuvent être réduites si le module TSX ETY 5103 est déjà utilisé pour d'autres tâches de communication (IO Scanning, Global Data, etc.). 50 33002552 12/2018 Modes de fonctionnement et performances Mise au point et diagnostic Ecran de mise au point En mode connecté (en ligne) le logiciel Control Expert permet de mettre au point l'application grâce à des écrans spécifiques. L'écran de mise au point de module peut servir à cela. Soulignons néanmoins les points suivants : Le nombre de connexions affichées inclut : les connexions à profil ouvert (TCP Open) les connexions à profil privé (adresse déclarée dans la configuration) Les adresses IP des profils ouverts ne peuvent pas être affichées dans cet écran. Tests des communications IP La fenêtre de test des communications permet de tester les communications IP avec les équipements client si l'adresse IP du client est déclarée en tant qu'équipement distant (utilisée par le profil privé). La liste des adresses IP configurées permet de sélectionner la station avec laquelle communiquer grâce à l'activation d'une commande "ping" qui renvoie un état indiquant le retour de boucle ou le dépassement de la temporisation du message. 33002552 12/2018 51 Modes de fonctionnement et performances 52 33002552 12/2018 EcoStruxure™ Control Expert Avancé 33002552 12/2018 Partie III Avancé Avancé Vue d'ensemble Cette section décrit les fonctions et blocs fonction élémentaires de la famille Avancé. Contenu de cette partie Cette partie contient les chapitres suivants : Chapitre Titre du chapitre Page 7 FCT_ACCEPT : accepte une requête de connexion 55 8 FCT_BIND : relie un numéro de socket à une adresse IP et à un port 59 9 FCT_CLOSE : supprime le socket spécifié 63 10 FCT_CONNECT : établit une connexion avec une adresse IP 67 11 FCT_LISTEN : configuration d'une connexion en attente de socket 71 12 FCT_RECEIVE : récupère les données disponibles sur un socket 73 13 FCT_SELECT : multiplexe les requêtes sur les sockets 77 14 FCT_SEND : envoi de données à un socket spécifique 81 15 FCT_SETSOCKOPT : configure les options associées au socket 85 16 FCT_SHUTDOWN : désactive la transmission sur le socket 89 17 FCT_SOCKET : création d'un nouveau socket 93 33002552 12/2018 53 Avancé 54 33002552 12/2018 EcoStruxure™ Control Expert FCT_ACCEPT 33002552 12/2018 Chapitre 7 FCT_ACCEPT : accepte une requête de connexion FCT_ACCEPT : accepte une requête de connexion Description Description de la fonction La fonction FCT_ACCEPT permet d'accepter une requête de connexion reçue par le socket spécifié. Cette requête de connexion provient d'un socket étranger. Pour pouvoir appeler FCT_ACCEPT, il faut configurer un socket de sorte qu'il puisse recevoir une requête de connexion en appelant FCT_LISTEN. La fonction FCT_ACCEPT : extrait la première requête de connexion dans la file d'attente des connexions ; crée un socket connecté ayant les mêmes propriétés que le socket d'origine ; termine la connexion entre le socket étranger et le nouveau socket ; renvoie un numéro pour le nouveau socket. Ce nouveau numéro de socket permet de lire et d'écrire des données sur le socket étranger. Il ne sert pas à accepter de nouvelles connexions. Le socket d'origine reste ouvert, prêt à accepter de nouvelles connexions. S'il n'y a aucune connexion en file d'attente, FCT_ACCEPT renvoie une erreur. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 55 FCT_ACCEPT Représentation en LD Représentation en IL Nombre de modules LD FCT_ACCEPT Socket_Number, Clie_Index, Gest_Index, Management_Param, Client_Address Représentation en ST FCT_ACCEPT(Module_Number, Socket_Number, Clie_Index, Gest_Index, Management_Param, Client_Address); 56 33002552 12/2018 FCT_ACCEPT Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Clie_Index INT Index du premier mot dans la matrice Client_Address Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres de sortie : Paramètre Type Client_Address ARRAY [0... 3] OF Matrice de 4 mots contenant le numéro du INT socket de service, le numéro de port et l'adresse IP du client : Client_Address[0] : numéro du socket connecté Client_Address[1] : numéro de port du client Client_Address[2] : mot de poids faible de l'adresse IP du client Client_Address[3] : mot de poids fort de l'adresse IP du client 33002552 12/2018 Commentaire 57 FCT_ACCEPT Le tableau suivant décrit les paramètres d'E/S : 58 Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#16 : la fonction FCT_LISTEN doit être appelée avant FCT_ACCEPT 16#23 : pas de requête de connexion Commentaire 33002552 12/2018 EcoStruxure™ Control Expert FCT_BIND 33002552 12/2018 Chapitre 8 FCT_BIND : relie un numéro de socket à une adresse IP et à un port FCT_BIND : relie un numéro de socket à une adresse IP et à un port Description Description de la fonction La fonction FCT_BIND permet d'affecter un numéro de port et une adresse Internet à un socket. Un socket étant créé sans adresse, il ne peut pas être utilisé pour recevoir des données (à part les requêtes de connexion) tant qu'aucune adresse ne lui a été affectée. L'adresse Internet est fixée par le module réseau et correspond à son adresse IP locale. L'utilisateur n'est pas autorisé à utiliser les numéros de port déjà utilisés par le module réseau. Il s'agit des numéros de port suivants : 20 et 21 (ports FTP) 23 (port Telnet) 67 et 68 (ports BOOTP DHCP) 80 (port HTTP) 161 et 162 (ports SNMP) 502 (port Schneider Electric) 5 000 et 5 001 (ports spécifiques de module) 1 024 (ports TCP USER) 3 124 (port d'E/S) 7 400 à 8 400 (ports RTPS) Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 59 FCT_BIND Représentation en LD Représentation en IL LD Module_Number FCT_BIND Socket_Number, Port_Number, Gest_Index, Management_Param Représentation en ST FCT_BIND(Module_Number, Socket_Number, Port_Number, Gest_Index, Management_Param); Description des paramètres Le tableau ci-après décrit les paramètres d'entrée. 60 Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket 33002552 12/2018 FCT_BIND Paramètre Type Commentaire Port_Number INT Numéro de port à affecter au socket. Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau ci-après décrit les paramètres d'entrée/sortie. Paramètre Type Commentaire Management_Param ARRAY [0... 3] OF INT Matrice de gestion des fonctions (voir page 36) Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#16 : le socket est déjà lié 16#30 : le port spécifié est déjà utilisé 16#37 : le numéro de port spécifié n'est pas disponible 16#41 : aucun routage vers l'hôte Configuration des numéros de port au-delà de 32 K Le paramètre de port est associé au type de données Entier. Pour utiliser des numéros de port supérieurs à 15 bits (supérieurs à 32 K), vous devez utiliser le bloc fonction UINT_TO_INT pour convertir le format Entier non signé (codé sur 16 bits) au format Entier. Utilisez le bloc fonction UINT_TO_INT avant d'utiliser EF FCT_BIND ou FCT_CONNECT en présence d'un numéro de port supérieur à 32 K. Paramètre d'entrée : Paramètre Type de données Signification UINT_variable UINT valeur en entrée Paramètre de sortie : Paramètre Type de données Signification ConvertedVariable INT valeur en sortie 33002552 12/2018 61 FCT_BIND 62 33002552 12/2018 EcoStruxure™ Control Expert FCT_CLOSE 33002552 12/2018 Chapitre 9 FCT_CLOSE : supprime le socket spécifié FCT_CLOSE : supprime le socket spécifié Description Description de la fonction La fonction FCT_CLOSE permet de supprimer le socket spécifié. NOTE : Si le numéro de socket n'est pas indiqué ou s'il est égal à 0, tous les sockets ouverts sont supprimés. Comme les sockets ont été ouverts lors de l'utilisation de la fonction FCT_SOCKET, via l'option SO_LINGER, la fonction FCT_CLOSE n'est pas bloquée, même si les files d'attente n'ont pas encore été envoyées ou n'ont pas fait l'objet d'un accusé de réception. On parle dans ce cas d'abandon car le circuit virtuel du socket est immédiatement réinitialisé et toutes les données non envoyées sont perdues. Tout appel de la fonction FCT_RECEIVE de l'autre côté du circuit échouera et générera le message d'erreur : connexion réinitialisée (16#36). Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 63 FCT_CLOSE Représentation en LD Représentation en IL LD Module_Number FCT_CLOSE Socket_Number, Gest_Index, Management_Param Représentation en ST FCT_CLOSE(Module_Number, Socket_Number, Gest_Index, Management_Param); 64 33002552 12/2018 FCT_CLOSE Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro de port à supprimer. Si Socket_Number a pour valeur 0, tous les sockets sont supprimés. Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#16 : numéro de socket non valide 33002552 12/2018 Commentaire 65 FCT_CLOSE 66 33002552 12/2018 EcoStruxure™ Control Expert FCT_CONNECT 33002552 12/2018 Chapitre 10 FCT_CONNECT : établit une connexion avec une adresse IP FCT_CONNECT : établit une connexion avec une adresse IP Description Description de la fonction La fonction FCT_CONNECT permet d'établir une connexion vers un port connu et une adresse Internet. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD Représentation en LD 33002552 12/2018 67 FCT_CONNECT Représentation en IL LD Module_Number FCT_CONNECT Socket_Number, Serv_Index, Gest_Index, Server_Address, Management_Param Représentation en ST FCT_CONNECT(Module_Number, Socket_Number, Serv_Index, Gest_Index, Server_Address, Management_Param); Description des paramètres Le tableau ci-après décrit les paramètres d'entrée. 68 Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Serv_Index INT Index du premier mot dans la matrice Server_Address Gest_Index INT Index du premier mot dans la matrice Management_Param Server_Address INT Matrice de 3 mots contenant le numéro de port et l'adresse IP du serveur 33002552 12/2018 FCT_CONNECT Le tableau ci-après décrit les paramètres d'E/S. Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : bon fonctionnement 16#09 : numéro de socket non valide 16#16 : paramètre non valide 16#20 : connexion interrompue 16#24 : connexion en cours 16#38 : socket déjà connecté 16#3D : connexion refusée 16#41 : aucun routage vers l'hôte Commentaire Configuration des numéros de port au-delà de 32 K Le paramètre de port est associé au type de données Entier. Pour utiliser des numéros de port supérieurs à 15 bits (supérieurs à 32 K), vous devez utiliser le bloc fonction UINT_TO_INT pour convertir le format Entier non signé (codé sur 16 bits) au format Entier. Utilisez le bloc fonction UINT_TO_INT avant d'utiliser EF FCT_BIND ou FCT_CONNECT en présence d'un numéro de port supérieur à 32 K. Paramètre d'entrée : Paramètre Type de données Signification UINT_variable UINT valeur en entrée Paramètre de sortie : Paramètre Type de données Signification ConvertedVariable INT valeur en sortie 33002552 12/2018 69 FCT_CONNECT 70 33002552 12/2018 EcoStruxure™ Control Expert FCT_LISTEN 33002552 12/2018 Chapitre 11 FCT_LISTEN : configuration d'une connexion en attente de socket FCT_LISTEN : configuration d'une connexion en attente de socket Description Description de la fonction La fonction FCT_LISTEN permet de configurer le socket spécifié pour qu'il puisse recevoir les connexions. Les demandes de connexion sont mises en file d'attente sur le socket jusqu'à leur acceptation par la fonction FCT_ACCEPT. La longueur définie pour la file d'attente est de 16. Si une requête de connexion arrive et que la file d'attente est complète, le client qui l'a envoyée obtient une erreur ECONNREFUSED(16#3D). Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD Représentation en LD 33002552 12/2018 71 FCT_LISTEN Représentation en IL LD Module_Number FCT_LISTEN Socket_Number, Gest_Index, Management_Param Représentation en ST FCT_LISTEN(Module_Number, Socket_Number, Gest_Index, Management_Param); Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres d'E/S : 72 Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide Commentaire 33002552 12/2018 Chapitre 12 FCT_RECEIVE : récupère les données disponibles sur un socket FCT_RECEIVE : récupère les données disponibles sur un socket Description Description de la fonction La fonction FCT_RECEIVE recherche les données disponibles sur le socket. La longueur maximale des données à lire est de 240 octets. La fonction renvoie le nombre d'octets lus dans le socket. Vous devez toujours contrôler cette valeur car c'est la seule façon de vérifier le nombre réel d'octets de données enregistrés dans la mémoire tampon du client. NOTE : FCT_RECEIVE ne renvoie pas de données hors bande. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD Représentation en LD 73 Représentation en IL LD Module_Number FCT_RECEIVE Socket_Number, Pbuf_Index, Gest_Index, Management_Param, Received_Data Représentation en ST FCT_RECEIVE(Module_Number, Socket_Number, Pbuf_Index, Gest_Index, Management_Param, Received_Data); Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Pbuf_Index INT Index du premier mot dans la matrice Received_Data Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres de sortie : 74 Paramètre Type Received_Data Commentaire ARRAY [0... n] OF Matrice de 240 octets maximum contenant les INT données lues sur le socket. Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#23 : aucune donnée à lire 16#36 : connexion réinitialisée par l'homologue 16#39 : socket non connecté (socket d'écoute) 16#3C : délai du maintien d'activité dépassé pour cause d'interruption de connexion 16#0E : longueur de la chaîne de caractères à recevoir supérieure à 240 octets Commentaire Le quatrième mot de la matrice doit contenir le nombre d'octets reçus si aucune erreur ne s'est produite. 75 76 EcoStruxure™ Control Expert FCT_SELECT 33002552 12/2018 Chapitre 13 FCT_SELECT : multiplexe les requêtes sur les sockets FCT_SELECT : multiplexe les requêtes sur les sockets Description Description de la fonction La fonction FCT_SELECT permet de multiplexer les requêtes d'E/S sur plusieurs sockets. Elle indique les sockets ayant des événements à traiter à l'aide d'une matrice de nombres entiers. Pour la révision du micrologiciel ETY 5103, version 3.3 ou inférieure : Un numéro compris entre 1 et 32 est affecté aux descripteurs de socket : Des numéros compris entre 1 et 16 sont affectés aux sockets créés par la fonction de socket. Il s'agit de sockets clients. Des numéros compris entre 17 et 32 sont affectés aux sockets créés par la fonction d'acceptation. Il s'agit de sockets serveurs. La matrice de la tâche MASK (Socket_Activity) permet de diagnostiquer l'état des sockets d'écoute (serveurs) et connectés (clients). Perspective du serveur : tout mot de la matrice utilise les bits disponibles de la matrice pour correspondre au socket d'écoute de l'étape initiale. La fonction d'acceptation génère un numéro de socket différent pour localiser son bit associé dans le deuxième mot de la matrice, qui indique l'état de la connexion du serveur. Perspective du client : le premier mot de la matrice indique l'état de la connexion du client. Pour le micrologiciel ETY 5103, version supérieure à la révision 3.3 : Vous pouvez utiliser jusqu'à 64 sockets d'écoute (serveur) ou connectés (client). Dans une application serveur, au moins 1 socket doit être configuré comme socket d'écoute. C'est la seule restriction stricte concernant le choix entre les sockets d'écoute et les sockets connectés. Pour déterminer les sockets d'écoute, consultez le numéro de socket fourni comme sortie par la fonction de socket. Pour déterminer les sockets connectés, consultez le numéro de socket fourni comme sortie par la fonction d'acceptation. La matrice de la tâche MASK (Socket_Activity) permet de diagnostiquer l'état des sockets d'écoute et connectés, qui sont maintenant combinés dans une matrice de 2 ou 4 mots (voir la remarque ci-dessous). Vous devez utiliser la sortie de la fonction de socket ou d'acceptation pour localiser le bit correspondant dans la matrice. Reportez-vous à Socket_Activity dans le tableau Description des paramètres (voir page 79). NOTE : pour les versions supérieures à 3.3, la structure Management_Param requiert un paramètre de longueur. 33002552 12/2018 77 FCT_SELECT Le champ de longueur n'est pas utilisé lorsque l'octet de poids fort du paramètre INTE est réglé sur 00. S'il est réglé sur 01, vous devez régler la longueur sur 8. La longueur 8 vous permet de visualiser les données associées aux 64 connexions. Si vous choisissez une valeur inférieure, comme 4 par exemple, vous ne verrez que les données associées aux 32 premières connexions. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD Représentation en LD Représentation en IL LD Module_Number FCT_SELECT Mask_Index, Gest_Index, Management_Param, Socket_Activity Représentation en ST FCT_SELECT(Module_Number, Mask_Index, Gest_Index, Management_Param, Socket_Activity); 78 33002552 12/2018 FCT_SELECT Description des paramètres Le tableau ci-après décrit les paramètres d'entrée. Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00: garantit une compatibilité ascendante totale avec les applications créées avec la version 3.3 ou une version antérieure du micrologiciel. 01: il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Mask_Index INT Index du premier mot dans la matrice Socket_Activity Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau ci-après décrit les paramètres d'E/S. Paramètre Type Commentaire Management_Param ARRAY [0... 3] OF INT Matrice de gestion des fonctions (voir page 36) Pour cette fonction, le rapport d'opération renvoie toujours la valeur 16#00, qui indique l'absence d'erreur. 33002552 12/2018 79 FCT_SELECT Le tableau ci-après décrit les paramètres de sortie. Paramètre Type Commentaire Socket_Activity MATRICE [0... 1] DE INT - ou MATRICE [0... 3] DE INT (reportezvous à la remarque dans la section Description de la fonction (voir page 77).) Etat de chaque socket. Chaque bit ayant la valeur 1 indique un événement sur le socket correspondant à ce bit. Exemple : Pour la version 3.3 ou une version antérieure : Si le bit 5 du premier mot a la valeur 1, le socket 6 sera lu par la fonction FCT_ACCEPT. Si le bit 3 du deuxième mot a la valeur 1, le socket 20 sera lu par la fonction FCT_RECEIVE. Pour les versions postérieures à la version 3.3 : Si un bit a la valeur 1 sur un socket d'écoute, un serveur est prêt à accepter cette connexion. Si un bit a la valeur 1 sur un socket connecté, les données sont prêtes à être envoyées ou la communication a été interrompue. Perspective du client : dès qu'une connexion client est établie, le bit correspondant de la connexion (numéro de socket) est réglé sur 1 dans la matrice. Exemple : le socket 33 se trouvera dans le premier bit (bit 0) du troisième mot. Perspective du serveur : la fonction d'écoute ouvre un socket. Le bit correspondant à ce numéro de socket est réglé sur 1 dans la matrice. Exemple : le socket 3 se trouvera dans le troisième bit (bit 2) du troisième mot. Ensuite, la fonction d'acceptation renverra un numéro de socket différent, dont le bit correspondant sera réglé sur 1 dans la matrice. NOTE : le numéro de socket de la fonction d'écoute restera à 1 jusqu'à la fermeture du socket. 80 33002552 12/2018 EcoStruxure™ Control Expert FCT_SEND 33002552 12/2018 Chapitre 14 FCT_SEND : envoi de données à un socket spécifique FCT_SEND : envoi de données à un socket spécifique Description Description de la fonction La fonction FCT_SEND permet d'envoyer des données à un socket étranger. La longueur maximale des données à envoyer est de 240 octets. NOTE : il est impossible d'envoyer des données hors bande. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 81 FCT_SEND Représentation en LD Représentation en IL LD Module_Number FCT_SEND Socket_Number, Pbuf_Index, Gest_Index,Data_to_Send, Management_Param Représentation en ST FCT_SEND(Module_Number, Socket_Number, Pbuf_Index, Gest_Index,Data_to_Send, Management_Param); 82 33002552 12/2018 FCT_SEND Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Pbuf_Index INT Index du premier mot dans la matrice Pbuf_Address Gest_Index INT Index du premier mot dans la matrice Management_Param Data_to_Send ARRAY [0... n] OF Matrice de 120 mots maximum contenant les INT données à envoyer. Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le compte rendu des opérations peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#20 : communication interrompue 16#23 : socket plein 16#36 : connexion réinitialisée par l'homologue 16#39 : socket non connecté (socket d'écoute) 16#0E : longueur de la chaîne de caractères à envoyer supérieure à 240 octets Commentaire Le quatrième mot de la matrice doit contenir le nombre d'octets envoyés si aucune erreur ne s'est produite. 33002552 12/2018 83 FCT_SEND 84 33002552 12/2018 EcoStruxure™ Control Expert FCT_SETSOCKOPT 33002552 12/2018 Chapitre 15 FCT_SETSOCKOPT : configure les options associées au socket FCT_SETSOCKOPT : configure les options associées au socket Description Description de la fonction La fonction FCT_SETSOCKOPT permet de configurer les options associées au socket spécifié. Certaines options sont configurées automatiquement lorsque le socket est créé à l'aide de la fonction FCT_SOCKET (voir page 93). Voici les options disponibles : DONT_ROUTE : indique que les données sortantes ne doivent pas être acheminées. Les paquets dirigés vers des nœuds non connectés sont abandonnés. RESET_DONT_ROUTE : réinitialise DONT_ROUTE. KEEP_ALIVE : garantit le maintien d'activité de la connexion grâce à l'envoi régulier et automatique de paquets sur le socket. RESET_KEEP_ALIVE : réinitialise KEEP_ALIVE. La sélection de ces options s'opère par l'affectation d'un numéro à la variable Option_Type. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 85 FCT_SETSOCKOPT Représentation en LD Représentation en IL LD Module_Number FCT_SETSOCKOPT Socket_Number, Option_Type, Gest_Index, Management_Param Représentation en ST FCT_SETSOCKOPT(Module_Number, Socket_Number, Option_Type, Gest_Index, Management_Param); 86 33002552 12/2018 FCT_SETSOCKOPT Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Option_Type INT Type d'option à associer au socket. Voici les valeurs qui peuvent être affectées à ce mot : 1 pour DONT_ROUTE 2 pour RESET_DONT_ROUTE 3 pour KEEP_ALIVE 4 pour RESET_KEEP_ALIVE Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#16 : option non valide Commentaire Le quatrième mot de la matrice doit contenir le nombre d'octets stockés en mémoire tampon. 33002552 12/2018 87 FCT_SETSOCKOPT 88 33002552 12/2018 EcoStruxure™ Control Expert FCT_SHUTDOWN 33002552 12/2018 Chapitre 16 FCT_SHUTDOWN : désactive la transmission sur le socket FCT_SHUTDOWN : désactive la transmission sur le socket Description Description de la fonction La fonction FCT_SHUTDOWN permet de désactiver la transmission des envois ou des réceptions sur le socket. La fenêtre TCP n'est pas modifiée et les données entrantes seront acceptées (mais sans accusé de réception) jusqu'à ce que la fenêtre soit pleine. NOTE : La fonction ne ferme pas le socket et les ressources affectées au socket ne sont libérées qu'à l'envoi de FCT_CLOSE. Néanmoins, n'essayez pas de réutiliser le socket après l'exécution de la fonction FCT_SHUTDOWN. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 89 FCT_SHUTDOWN Représentation en LD Représentation en IL LD Module_Number FCT_SHUTDOWN Socket_Number, Shutdown_Option, Gest_Index, Management_Param Représentation en ST FCT_SHUTDOWN(Module_Number, Socket_Number, Shutdown_Option, Gest_Index, Management_Param); 90 33002552 12/2018 FCT_SHUTDOWN Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Socket_Number INT Numéro du socket Shutdown_Option INT Option de désactivation de la transmission : 0 : les réceptions ne sont plus autorisées sur le socket 1 : les envois ne sont plus autorisés sur le socket et un message FIN est envoyé 2 : les envois et les réceptions ne sont plus autorisés sur le socket. Cette option revient à appliquer les deux options précédentes. Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#09 : numéro de socket non valide 16#16 : argument non valide 16#39 : socket non connecté 33002552 12/2018 Commentaire 91 FCT_SHUTDOWN 92 33002552 12/2018 EcoStruxure™ Control Expert FCT_SOCKET 33002552 12/2018 Chapitre 17 FCT_SOCKET : création d'un nouveau socket FCT_SOCKET : création d'un nouveau socket Description Description de la fonction La fonction FCT_SOCKET permet de créer un socket et de renvoyer son numéro. Ce socket est une entité de communication TCP/IP. Il est créé en tant que socket STREAM TCP avec les options suivantes : SO_LINGER sans temporisation. Cette option contrôle l'action à entreprendre lorsque des données non envoyées sont mises en file d'attente sur un socket et qu'une fonction FCT_CLOSE est exécutée. NO_DELAY. L'algorithme de reconnaissance des retards est désactivé. Les données sont immédiatement envoyées sur le réseau au lieu d'être conservées jusqu'à ce que la fenêtre soit entièrement remplie. KEEP_ALIVE. L'activité de la connexion est maintenue grâce à l'envoi régulier et automatique de paquets sur le socket. REUSEADDR. Autorise la réutilisation du port local lors de l'appel d'une fonction FCT_BIND. Les paramètres supplémentaires EN et ENO peuvent être configurés. Représentation en FBD 33002552 12/2018 93 FCT_SOCKET Représentation en LD Représentation en IL Nombre de modules LD FCT_SOCKET Gest_Index, Management_Param, Socket_Number Représentation en ST FCT_SOCKET(Module_Number, Gest_Index, Management_Param, Socket_Number); 94 33002552 12/2018 FCT_SOCKET Description des paramètres Le tableau suivant décrit les paramètres d'entrée : Paramètre Type Commentaire Module_Number INT Numéro d'emplacement du module réseau dans le rack 0. L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0. L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets. 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel. 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3). Gest_Index INT Index du premier mot dans la matrice Management_Param Le tableau suivant décrit les paramètres de sortie : Paramètre Type Commentaire Socket_Number INT Numéro du socket créé si aucune erreur ne s'est produite. Le tableau suivant décrit les paramètres d'E/S : Paramètre Type Management_Param ARRAY [0... 3] OF Matrice de gestion des fonctions (voir page 36) INT Le rapport d'opération peut afficher les valeurs suivantes : 16#00 : pas d'erreur 16#37 : le nombre maximum de sockets est atteint. 33002552 12/2018 Commentaire 95 FCT_SOCKET 96 33002552 12/2018 EcoStruxure™ Control Expert Bibliothèque de DFB 33002552 12/2018 Partie IV Bibliothèque de DFB Bibliothèque de DFB 33002552 12/2018 97 Bibliothèque de DFB 98 33002552 12/2018 EcoStruxure™ Control Expert Bibliothèque de DFB 33002552 12/2018 Chapitre 18 Bibliothèque de DFB Bibliothèque de DFB Présentation La bibliothèque de DFB de communication TCP pour automates Premium permet de transférer des blocs de données entre une application d'automate et une application distante via une connexion TCP/IP établie à l'initiative de l'application distante. L'application distante est exécutée sur un équipement prenant en charge le profil de communication TCP/IP. Contenu de ce chapitre Ce chapitre contient les sujets suivants : Sujet Page Présentation de la bibliothèque de DFB 100 DFB TCP_CNX 101 DFB TCP_SEND 104 DFB TCP_RECEIVE 107 33002552 12/2018 99 Bibliothèque de DFB Présentation de la bibliothèque de DFB Présentation La bibliothèque de DFB de communication comprend les éléments suivants : le DFB TCP_CNX pour la gestion des connexions ; le DFB TCP_SEND pour la transmission de blocs de données (taille maximale de 8 ko) ; le DFB TCP_RECEIVE pour la réception de blocs de données (taille maximale de 8 ko) ; NOTE : les DFB de communication TCP pour les automates Premium utilisent les services TCP Open for Premium pour gérer les connexions TCP et échanger des flux d'octets sur ses connexions. Les blocs fonction utilisent les services de messagerie mis en œuvre dans le processeur Premium. Par conséquent, tous les blocs de communication peuvent être exécutés sur plusieurs cycles d'automate. L'échange UC/module d'un datagramme est effectué dans chaque cycle d'automate. Maintenance des DFB L'exécution des blocs fonction fait l'objet d'une maintenance explicite. Vous devez programmer la maintenance d'un DFB tant que son bit ACTIVITY est actif. NOTE : n'exécutez pas la même instance de DFB à plusieurs reprises durant un cycle d'automate. La maintenance des DFB est obligatoire car tous les blocs fonction de communication sont exécutés sur plusieurs cycles d'automate. Dès que le DFB est appelé, il est redémarré à chaque cycle d'automate dès que son bit ACTIVITY est égal à 1. 100 33002552 12/2018 Bibliothèque de DFB DFB TCP_CNX Présentation Le DFB TCP_CNX gère les connexions aux clients distants, ainsi que les modes de fonctionnement des connexions. Il est informé des interruptions des connexions par un DFB TCP_SEND ou TCP_RECEIVE via l'état des mots de gestion. Il n'existe qu'une instance de DFB TCP_CNX pour un modèle TSX ETY 110 WS/5103. Paramètres d'entrée Paramètre Type Description RST Bit La configuration de cette entrée à 1 : interrompt les échanges en cours. ferme toutes les connexions. Paramètres d'entrée/sortie Paramètre Type Description MANAGNT Table de mots Table de gestion commune à tous les DFB 33002552 12/2018 101 Bibliothèque de DFB Paramètres de sortie Paramètre Type Description ERROR Bit Ce bit de sortie est réglé sur 1 lorsque l’échange ne s'effectue pas correctement. Le mot d'état indique le type de l'erreur survenue. Données publiques internes 102 Paramètre Type Variables en écriture/lecture Description DEVICE Mot E Numéro de module Numéro de l'emplacement physique du module TSX ETY 110 ES/5103 dans le rack PORT Table de mots E Port local numéro i. Table de 16 ports de service locaux à écouter (valeur signée ≥ 5010). La valeur 0 indique une valeur non significative. IPACCEPT Mot double E Adresse IP de la machine distante n°i Table d'adresses IP quadri-octales de mots, issue de la table 8. Machines distantes autorisées à se connecter à l'automate. La valeur 9 indique une valeur non significative. EOM Octet E Caractère de fin de message. Ce paramètre définit la présence et la valeur d'un caractère de fin de message à utiliser dans les échanges de messages : EOM = 0 : aucun caractère de fin de message EOM de 0x01 à 0xFF : valeur du caractère de fin de message : ajoutée par le module pendant la transmission vérifiée et supprimée par le module lors de la réception IPCNXi Chaîne de L caractères Adresse IP de la machine distante n°i Chaîne de caractères en lecture seule à utiliser pour la maintenance exclusivement. Indique l'adresse IP de la machine distante au format aaa.bbb.ccc.ddd, connectée au port associé à l'index i dans la configuration. La valeur 0.0.0.0 indique qu'aucune machine n'est connectée à ce port. 33002552 12/2018 Bibliothèque de DFB Paramètre Type Variables en écriture/lecture Description ACTIVITY Bit L Ce bit de sortie est réglé sur 1 lorsque le DFB est en cours et doit faire l'objet d'une maintenance. Il est réglé sur 0 en cas de redémarrage à chaud, de redémarrage à froid ou de réinitialisation du DFB. STATUS Mot L Ce mot n'est pertinent que si le bit de sortie ERROR est réglé sur 1. Il indique le code de l'erreur survenue pendant l'échange. (Chaque bit de mot réglé sur 1 signale une erreur.) Fonctionnement Le DFB TCP_CNX doit être appelé à chaque redémarrage de l'automate pour garantir une gestion permanente des ports TCP. L'écoute des ports configurés débute si les bits RST et ACTIVITY sont réglés sur 0. Ensuite, le bit ACTIVITY reste à 1 jusqu'à ce que l'application permette au bit RST de revenir à 0. Si la communication avec le module est incorrecte, le bit de sortie ERROR est réglé sur 1. A tout moment, le réglage du bit RST (entrée prioritaire) sur 1 permet d'interrompre toutes les connexions en cours ou en veille. Le bit ACTIVITY (échange terminé) est réglé sur 0 et le bit ERROR, sur 1. Le mot d'état <TCP_CNX nom instance>.STATUS indique le type de l'erreur. Lors d'un redémarrage à chaud ou à froid, le DFB TCP_CNX renvoie automatiquement le mode d'écoute des ports configurés. 33002552 12/2018 103 Bibliothèque de DFB DFB TCP_SEND Présentation Le DFB TCP_SEND permet d'envoyer un message de données à une application cliente distante via une connexion TCP/IP. La taille maximale du message est de 8 ko. Paramètres d'entrée Paramètre Type Description RST Bit La configuration de ce bit à 1 : interrompt l'échange en cours (si le bit ACTIVITY est réglé sur 1). ferme la connexion. règle le bit d'information ACTIVITY sur 0 et le bit de sortie ERROR sur 1. Le code d'erreur est stocké dans le mot STATUS. BUF 104 Table de mots Cette variable définit l'adresse du premier mot %MWi du tampon pour envoyer le message. 33002552 12/2018 Bibliothèque de DFB Paramètres d'entrée/sortie Paramètre Type Description MANAGNT Table de mots Table de gestion commune à tous les DFB Paramètres de sortie Paramètre Type Description ERROR Bit Ce bit de sortie est réglé sur 1 lorsque l’échange ne s'effectue pas correctement. Le mot STATUS indique le type de l'erreur survenue. Données publiques internes Paramètre Type Variables en écriture/lecture Description DEST Mot double E Cette variable définit l'adresse IP de la machine distante sur laquelle le client est connecté au port local. Par défaut, DEST = 0. Le message est envoyé à la seule station cliente distante connectée au port de service local de l'automate. PORT Mot E Cette variable définit le numéro de port local auquel le client distant est connecté. SIZE Mot E Cette variable définit la taille du message à envoyer (de 0 à 8 192 octets). ACTIVITY Bit L Ce bit est réglé sur 1 lorsqu'un échange est en cours. Il revient à 0 lorsque l'échange est terminé. INHIB Bit L Ce bit permet d'inhiber l'avertissement d'erreur. Le bit de sortie ERROR et le mot STATUS restent à 0 (l'exécution du bloc n'est pas interrompue). STATUS Mot L Ce mot n'est significatif que si le bit de sortie ERROR est réglé sur 1. Il indique le code de l'erreur survenue pendant l'échange (chaque bit de mot réglé sur 1 signale une erreur). 33002552 12/2018 105 Bibliothèque de DFB Fonctionnement Le transfert de données est lancé lorsque le DFB TCP_SEND est appelé, si les bits RST et ACTIVITY sont réglés sur 0. Pendant l'échange, le bit ACTIVITY est réglé sur 1. A la fin de la transmission, le bit ACTIVITY est réglé sur 0. De plus, si l'échange n'est pas correct, le bit de sortie ERROR est réglé sur 1. A tout moment, le réglage du bit RST (entrée prioritaire) sur 1 permet d'interrompre l'échange en cours. Le bit ACTIVITY (échange terminé) est réglé sur 0 et le bit ERROR, sur 1. Le mot d'état <TCP_SEND nom instance>.STATUS indique le type de l'erreur. Si la connexion est établie, elle est fermée et le module attend la connexion entrante. Le DFB TCP_CNX (voir page 101) rétablit la connexion au port de service TCP pour relancer l'envoi des messages. Lorsqu'un message est envoyé, les opérations suivantes sont exécutées : Vérification des paramètres d'entrée (adresse IP de la machine distante, numéro du port local) Recherche de la connexion ouverte avec le client distant demandé Envoi du message par bloc de 240 octets (ajout du caractère de fin de message, le cas échéant) 106 33002552 12/2018 Bibliothèque de DFB DFB TCP_RECEIVE Présentation Le DFB TCP_RECEIVE permet de recevoir un message de données envoyé par une application cliente distante via une connexion TCP/IP. La taille maximale du message est de 8 ko. Paramètres d'entrée Paramètre Type RST Bit Description La configuration de ce bit à 1 : interrompt l'échange en cours (si le bit ACTIVITY est réglé sur 1). ferme la connexion. règle le bit ACTIVITY sur 0 et le bit de sortie ERROR sur 1. Le code d'erreur est stocké dans le mot STATUS. 33002552 12/2018 107 Bibliothèque de DFB Paramètres d'entrée/sortie Paramètre Type Description BUF Table de mots Ce paramètre d'entrée et de sortie définit l'adresse du premier mot %MWi du tampon pour recevoir le message. MANAGNT Table de mots Table de gestion commune à tous les DFB Paramètres de sortie Paramètre Type Description ERROR Bit Ce bit de sortie est réglé sur 1 lorsque l’échange ne s'effectue pas correctement. Le mot STATUS indique le type d'erreur survenue. Données publiques internes 108 Paramètre Type Variables en Description écriture/lecture FRM Mot double E Cette variable définit l'adresse IP de la machine distante sur laquelle le client est connecté. Par défaut, FRM = 0. Le DFB attend le message envoyé par le seul client distant connecté au port de service local de l'automate. PORT Mot E Cette variable définit le numéro du port local auquel le client distant est connecté. SIZE Mot E Cette variable définit la taille du message à envoyer (de 0 à 8 192 octets). ACTIVITY Bit L Le DFB règle cette variable sur 0, une fois l'échange terminé. Si le bit de sortie ERROR est réglé sur 0, le bit ACTIVITY indique que le message a été reçu avec succès. Toutefois, si le bit ERROR est réglé sur 1, le bit ACTIVITY indique que l'échange est terminé mais que des erreurs se sont produites. INHIB Bit E Cette variable permet d'inhiber l'avertissement d'erreur. Le bit de sortie ERROR et le mot STATUS restent à 0 (l'exécution du bloc n'est pas interrompue). STATUS Mot L Ce mot n'est significatif que si le bit de sortie ERROR est réglé sur 1. Il indique le code de l'erreur survenue pendant l'échange (chaque bit de mot réglé sur 1 signale une erreur). LENGTH Mot L Cette variable contient le nombre d'octets reçus si le bit de sortie ERROR est réglé sur 0. 33002552 12/2018 Bibliothèque de DFB Fonctionnement Le transfert de données est lancé lorsque le DFB TCP_RECEIVE est appelé, si les bits RST et ACTIVITY sont réglés sur 0. Pendant l'échange, le bit ACTIVITY est réglé sur 1. A la fin de la transmission, le bit ACTIVITY est réglé sur 0. De plus, si l'échange n'est pas correct, le bit de sortie ERROR est réglé sur 1. A tout moment, le réglage du bit RST (entrée prioritaire) sur 1 permet d'interrompre l'échange en cours. Le bit ACTIVITY (échange terminé) est réglé sur 0 et le bit ERROR, sur 1. Le mot d'état <TCP_RECEIVE nom instance>.STATUS indique le type de l'erreur. Si la connexion est établie, elle est fermée et le module attend la connexion entrante. Tous les messages dans les tampons de réception du module sont perdus. Lorsqu'un message est reçu, les opérations suivantes sont exécutées : Vérification des paramètres d'entrée (adresse IP de la machine distante, numéro du port local) Recherche de la connexion ouverte avec le client distant demandé Mise en file d'attente du bloc EF pour recevoir le message Dès qu'un DFB est actif pour une connexion donnée, le module attend la réception du message et les deux premiers octets reçus indiquent la longueur du message. Les données sont ensuite transférées dans les mots de l'automate en trames de 240 octets. Lorsque le message complet est copié sur l'automate : Le DFB vérifie le caractère de fin de message (si cette option a été configurée). Les paramètres STATUS et LENGTH du DFB sont renseignés, et les bits ACTIVITY et ERROR sont configurés pour l'application du module. 33002552 12/2018 109 Bibliothèque de DFB 110 33002552 12/2018 EcoStruxure™ Control Expert Glossaire 33002552 12/2018 Glossaire E EN EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie. Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0. Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0. Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1. ENO ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN. Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) : les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ; la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0. I INT INT est l'abréviation du format single INTeger (entier simple codé sur 16 bits). Les limites supérieure/inférieure sont les suivantes : - (2 puissance 15) à (2 puissance 15) - 1. Exemple : -32768, 32767, 2#1111110001001001, 16#9FA4. 33002552 12/2018 111 Glossaire 112 33002552 12/2018 EcoStruxure™ Control Expert Index 33002552 12/2018 Index D TCP_SEND, 99 DFB, 99 disponibilité des instructions, 23 F FCT_ACCEPT, 55, 55 FCT_BIND, 59, 59 FCT_CLOSE, 63, 63 FCT_CONNECT, 67, 67 FCT_LISTEN, 71, 71 FCT_RECEIVE, 73, 73 FCT_SELECT, 77, 77 FCT_SEND, 81, 81 FCT_SETSOCKOPT, 85, 85 FCT_SHUTDOWN, 89, 89 FCT_SOCKET, 93, 93 I instructions disponibilité, 23 T TCP Open, instruction FCT_ACCEPT, 55 FCT_BIND, 59 FCT_CLOSE, 63 FCT_CONNECT, 67 FCT_LISTEN, 71 FCT_RECEIVE, 73 FCT_SELECT, 77 FCT_SEND, 81 FCT_SETSOCKOPT, 85 FCT_SHUTDOWN, 89 FCT_SOCKET, 93 généralités, 53 TCP_CNX, 99 TCP_RECEIVE, 99 33002552 12/2018 113 Index 114 33002552 12/2018 ">
Öffentlicher Link aktualisiert
Der öffentliche Link zu Ihrem Chat wurde aktualisiert.