Schneider Electric SoMachine - Fonctions de gestion CANopen Mode d'emploi

SoMachine
EIO0000000496 06/2011
SoMachine
Fonctions de gestion CANopen
Guide de la bibliothèque CAA CiA 405
EIO0000000496.02
06/2011
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 d’amélioration ou de
correction ou avez relevé des erreurs dans cette publication, veuillez nous en
informer.
Aucune partie de ce document ne peut être reproduite sous quelque forme ou par
quelque moyen que ce soit, électronique, mécanique ou photocopie, sans
l’autorisation écrite expresse de Schneider Electric.
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.
© 2011 Schneider Electric. Tous droits réservés.
2
EIO0000000496 06/2011
Table des matières
Consignes de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . . .
A propos de ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . .
Partie I Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 1 Introduction au protocole CANopen. . . . . . . . . . . . . . . .
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole NMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole PDO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole SDO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole EMCY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole SYNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Protocole de contrôle d’erreur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 2 Introduction à CiA405. . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
7
9
11
12
13
14
15
16
17
19
21
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
Partie II Description des blocs fonction. . . . . . . . . . . . . . . . .
23
Chapitre 3 Comportement et E/S communes des blocs fonction .
3.1 Comportement et E/S communes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Descriptions des E/S communes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Codes d’erreur de noyau CANopen détectés . . . . . . . . . . . . . . . . . . . . . .
Schémas d’exécution de blocs fonction . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 4 Blocs fonction de gestion de réseau . . . . . . . . . . . . . . .
4.1 CIA405.NMT : gestion de l’état NMT des appareils . . . . . . . . . . . . . . . . .
Gestion de l’état NMT des appareils . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 CIA405.RECV_EMCY : scrutation des messages EMCY. . . . . . . . . . . . . .
Scrutation des messages EMCY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 CIA405.RECV_EMCY_DEV : réception du message EMCY de l’appareil .
Extraction du message EMCY d’appareil . . . . . . . . . . . . . . . . . . . . . . . . .
Chapitre 5 Blocs fonction d’ID de nœud personnel. . . . . . . . . . . . .
5.1 CIA405.GET_LOCAL_NODE_ID : obtention de l’ID de nœud CANopen du
contrôleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extraction de l’ID de nœud CANopen de l’automate. . . . . . . . . . . . . . . . .
EIO0000000496 06/2011
25
25
26
28
29
31
32
32
35
35
37
37
39
39
39
3
Chapitre 6 Blocs fonction d’état de requête . . . . . . . . . . . . . . . . . . .
41
6.1 CIA405.GET_CANOPEN_KERNEL_STATE : obtention de l’état du noyau
CANopen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extraction de l’état du noyau CANopen . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2 CIA405.GET_STATE : obtention de l’état de l’appareil CANopen . . . . .
Extraction de l’état d’appareil CANopen . . . . . . . . . . . . . . . . . . . . . . . . .
42
42
43
43
Chapitre 7 Blocs fonction d’accès SDO . . . . . . . . . . . . . . . . . . . . . . .
45
7.1 CIA405.SDO_READ : lecture d’objets CANopen de toute taille . . . . . . .
Lecture d’objets CANopen de toute taille. . . . . . . . . . . . . . . . . . . . . . . . .
7.2 CIA405.SDO_READ4 : lecture d’objets CANopen d’au maximum 4 octets
Lecture d’objets CANopen d’au maximum 4 octets . . . . . . . . . . . . . . . . .
7.3 CIA405.SDO_WRITE : écriture d’objets CANopen de toute taille . . . . . .
Ecriture d’objets CANopen de toute taille . . . . . . . . . . . . . . . . . . . . . . . .
7.4 CIA405.SDO_WRITE4 : écriture d’objets CANopen d’au maximum
4 octets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ecriture d’objets CANopen d’au maximum 4 octets. . . . . . . . . . . . . . . . .
Glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
46
46
49
49
52
52
57
57
59
63
EIO0000000496 06/2011
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 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.
EIO0000000496 06/2011
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 cet
appareil.
Une personne qualifiée est une personne disposant de compétences et de
connaissances dans le domaine de la construction et du fonctionnement des
équipements électriques et installations et ayant bénéficié d’une formation de
sécurité afin de reconnaître et d’éviter les risques encourus.
6
EIO0000000496 06/2011
A propos de ce manuel
Présentation
Objectif du document
Ce document décrit les blocs fonction de la bibliothèque CAA CiA 405 de
SoMachine, utilisés pour gérer et contrôler le réseau et les équipements CANopen
à partir de l’application du contrôleur.
Champ d’application
Ce document a été mis à jour avec la version de SoMachine V3.0.
Information spécifique au produit
AVERTISSEMENT
COMPORTEMENT ACCIDENTEL DE L’EQUIPEMENT


N’utilisez que le logiciel approuvé par Schneider Electric pour faire fonctionner
cet équipement.
Mettez à jour votre programme d’application chaque fois que vous modifiez la
configuration matérielle physique.
Le non-respect de ces instructions peut provoquer la mort, des blessures
graves ou des dommages matériels.
EIO0000000496 06/2011
7
AVERTISSEMENT
PERTE DE CONTROLE





Le concepteur d’un circuit de commande doit tenir compte des modes de
défaillance potentiels des canaux de commande et, pour certaines fonctions de
commande critiques, prévoir un moyen d’assurer la sécurité en maintenant un
état sûr pendant et après la défaillance. Par exemple, l’arrêt d’urgence, l’arrêt
en cas de surcourse, la coupure de courant et le redémarrage sont des
fonctions de contrôle cruciales.
Des canaux de commande séparés ou redondants doivent être prévus pour les
fonctions de commande critique.
Les liaisons de communication peuvent faire partie des canaux de commande
du système. Une attention particulière doit être prêtée aux implications des
délais de transmission non prévus ou des pannes de la liaison.
Respectez toutes les réglementations de prévention des accidents ainsi que les
consignes de sécurité locales.1
Chaque implémentation de cet équipement doit être testée individuellement et
entièrement pour s’assurer du fonctionnement correct avant la mise en service.
Le non-respect de ces instructions peut provoquer la mort, des blessures
graves ou des dommages matériels.
1 Pour plus d’informations, consultez le document NEMA ICS 1.1 (dernière édition),
« Safety Guidelines for the Application, Installation, and Maintenance of Solid State
Control » (Directives de sécurité pour l’application, l’installation et la maintenance
de commande statique) et le document NEMA ICS 7.1 (dernière édition), « Safety
Standards for Construction and Guide for Selection, Installation, and Operation of
Adjustable-Speed Drive Systems » (Normes de sécurité relatives à la construction
et manuel de sélection, installation et opération de variateurs de vitesse) ou son
équivalent en vigueur dans votre pays.
Commentaires utilisateur
Envoyez vos commentaires à l’adresse e-mail techpub@schneider-electric.com
8
EIO0000000496 06/2011
SoMachine
Introduction
EIO0000000496 06/2011
Introduction
I
Présentation
Cette partie présente les différents protocoles utilisés dans CANopen, ainsi que
l’interface et le profil d’équipement CANopen des contrôleurs programmables
CEI 61131-3 (CiA405).
NOTE : cette introduction a été en partie reprise et adaptée du site Web de CAN in
Automation (www.can-cia.org). CiA® et CANopen® sont des marques communautaires déposées de CAN in Automation e.V
A propos de CiA : CAN in Automation (CiA) désigne le regroupement international
des utilisateurs et fabricants de produits CAN (Controller Area Network). Cette
association à but non lucratif publie des informations techniques, marketing et
produit sur le protocole CAN normalisé à l’échelle internationale dans les
documents ISO 11898. Le but est de promouvoir l’image de CAN et de donner un
axe directeur pour le développement de la technologie CAN. L’organisation
consacre une partie importante de son action à développer et maintenir les
spécifications CANopen et à soutenir tous les autres protocoles CAN de haut niveau
standardisés à l’échelle internationale.
Contenu de cette partie
Cette partie contient les chapitres suivants :
Chapitre
EIO0000000496 06/2011
Titre du chapitre
Page
1
Introduction au protocole CANopen
11
2
Introduction à CiA405
21
9
Introduction
10
EIO0000000496 06/2011
SoMachine
Protocoles CANopen
EIO0000000496 06/2011
Introduction au protocole
CANopen
1
Contenu de ce chapitre
Ce chapitre contient les sujets suivants :
Sujet
EIO0000000496 06/2011
Page
Introduction
12
Protocole NMT
13
Protocole PDO
14
Protocole SDO
15
Protocole EMCY
16
Protocole SYNC
17
Protocole de contrôle d’erreur
19
11
Protocoles CANopen
Introduction
Protocole CANopen
Le protocole CANopen fournit des objets de communication standardisés (COB)
pour les données en temps réel (objets de données de process ou PDO), les
données de configuration (objets de données de service ou SDO), les données de
gestion de réseau (message de démarrage, message NMT et message de
contrôleur d’erreur) ainsi que pour d’autres fonctions (horodatage, message SYNC,
message EMCY). Tous les objets de communication sont accessibles via le réseau
CAN dans le dictionnaire d’objets de l’appareil. Ces objets sont adressables par un
index de 16 bits. Les objets tableau ou enregistrement sont adressés par un sousindex supplémentaire de 8 bits. Un objet de communication est désigné par un
identifiant unique et dédié (COB-ID) sur le réseau CANopen.
Dictionnaire d’objets d’appareil
Les entrées du dictionnaire d’objets d’un appareil CANopen sont décrits dans un
fichier EDS (Electronic Data Sheet). Les paramètres du maître et des esclaves
CANopen peuvent être réglés dans l’outil de configuration CANopen de SoMachine.
Pour plus d’informations sur la configuration CANopen, consultez le chapitre
Éditeurs/Éditeurs d’appareil/Éditeur de configuration CANbus dans l’aide en ligne
de CoDeSys.
12
EIO0000000496 06/2011
Protocoles CANopen
Protocole NMT
Protocole NMT (Network Management)
Le protocole NMT sert à contrôler le comportement des appareils esclaves NMT
CANopen sur le réseau. Il permet de faire basculer un membre dédié ou l’ensemble
des membres du réseau sur l’état d’esclave NMT.
La figure suivante représente l’appareil dans l’état d’esclave NMT CANopen.
Services NMT dans la relation maître/esclave
Tous les appareils CANopen évaluent les commandes NMT entrantes (code CS
(Command Specifier) dans le message NMT). Seul l’appareil CANopen qui joue le
rôle de maître NMT peut transmettre des messages NMT. Dans un réseau
CANopen, un seul maître NMT est actif.
EIO0000000496 06/2011
13
Protocoles CANopen
Protocole PDO
Protocole PDO (Process Data Object)
Les objets de données de process ou PDO sont des messages CAN prioritaires
courts (8 octets de données au maximum) qui sont transmis dans une diffusion. Par
conséquent, les PDO permettent de transmettre des données en temps réel, telles
que des informations de contrôle et d’état d’un variateur ou d’un module d’E/S, des
valeurs mesurées par des capteurs, etc.
Les PDO sont transmis sans confirmation. Cela signifie que, même lorsqu’un
membre du réseau reçoit les informations, la réception ne fait l’objet d’aucun
acquittement.
La figure suivante représente la transmission de PDO entre le générateur (PDO de
transmission) et les consommateurs (PDO de réception).
Evénements déclencheurs d’une transmission de PDO
Les événements déclencheurs d’une transmission de PDO sont définis ci-après.
14
Événement
déclencheur
Définition
Evénement ou
temporisateur
Evénement interne à l’appareil, qui déclenche la transmission de
PDO (par exemple, une modification de valeur, une température
supérieure à un seuil donné, un délai écoulé, etc.)
Demande distante
Transmission de PDO demandée par une requête de transmission
distante (RTR).
Synchrone cyclique
Transmission de PDO couplée à la réception du message SYNC.
Synchrone acyclique
Evénement propre à l’appareil, qui déclenche la transmission de
PDO à la réception du message SYNC suivant.
EIO0000000496 06/2011
Protocoles CANopen
Protocole SDO
Protocole SDO (Service Data Object)
Les objets de données de service ou SDO permettent d’accéder à une entrée du
dictionnaire d’objets CANopen. Un SDO établit une communication point à point
entre deux appareils. De plus, le protocole SDO permet de transférer n’importe quel
volume de données de manière segmentée. Il est donc principalement utilisé pour
communiquer avec des données de configuration.
Une connexion SDO entre deux appareils est établie en configurant le canal client
sur le serveur SDO. La transmission SDO est un service confirmé.
La figure suivante représente l’échange SDO avec requête et réponse.
EIO0000000496 06/2011
15
Protocoles CANopen
Protocole EMCY
Protocole EMCY (Emergency)
L’objet EMCY (Emergency) permet aux équipements de signaler des erreurs
détectées au sein des équipements. Lorsqu’ils reçoivent ce signal, les autres
membres du réseau évaluent l’information reçue et exécutent les actions de
comptage appropriées, définies par le fabricant.
La figure suivante représente le message d’erreur détectée, à l’aide d’objets EMCY.
Messages EMCY
Les messages EMCY reçus d’autres équipements CANopen sont enregistrés dans
une table de stockage EMCY. Pour chaque producteur EMCY, si aucun message
EMCY n’est reçu ou tant que le message EMCY le plus récent était un message
aucune erreur, les consommateurs EMCY considèrent que le producteur EMCY n’a
aucune erreur interne détectée.
16
EIO0000000496 06/2011
Protocoles CANopen
Protocole SYNC
Protocole SYNC (Synchrone)
Le protocole SYNC permet au réseau de synchroniser son comportement. Le
message SYNC transmis de manière cyclique indique aux consommateurs
d’exécuter les opérations propres à l’application, dès réception du message SYNC.
Une fois que les données ont été reçues, un PDO synchrone considère que les
données sont valides au moment de la réception du message SYNC.
La figure suivante représente la transmission de messages SYNC par le protocole
SYNC.
Variables de contrôle pour le comportement SYNC
Le délai entre deux messages SYNC consécutifs est appelé période du cycle de
communication et peut être ajusté dans le dictionnaire d’objets du générateur SYNC
(index d’objet 1006 hex.).
Les PDO de transmission synchrones sont envoyés dans un intervalle de temps
donné, après la réception du message SYNC. Cet intervalle est appelé durée de la
fenêtre synchrone et est configurable dans le dictionnaire d’objets de tous les
équipements qui doivent transmettre des PDO synchrones (index d’objet 1007
hex.).
EIO0000000496 06/2011
17
Protocoles CANopen
La figure suivante représente la durée de la fenêtre synchrone et la période du cycle
de communication.
18
EIO0000000496 06/2011
Protocoles CANopen
Protocole de contrôle d’erreur
Protocole de contrôle d’erreur
Les services Heartbeat et Nodeguarding sont des services de gestion de réseau
(NMT) qui vérifient la présence des membres du réseau et indiquent leur état.
Il existe deux types de protocoles de contrôle d’erreur dans CANopen :
 Heartbeat
 Node/Life Guarding
Comme le protocole Heartbeat est le plus souple et qu’il fonctionne sans requête de
transmission distante (RTR), il est recommandé de l’utiliser si les équipements
CANopen le prennent en charge.
Heartbeat
Un équipement CANopen transmet son heartbeat de manière cyclique. La durée du
cycle est appelée temps du producteur Heartbeat. Dès réception du message de
heartbeat, les consommateurs Heartbeat (par exemple, le gestionnaire CANopen)
évaluent si l’équipement correspondant fonctionne toujours correctement et
conserve l’état NMT correct. Le délai pendant lequel au moins un message
Heartbeat doit être reçu du générateur Heartbeat est configuré sur les
consommateurs (temps consommateur Heartbeat).
La figure suivante représente le heartbeat avec les intervalles de temps du protocole
de contrôle d’erreur.
Node/Life Guarding
Le gestionnaire CANopen demande le message de contrôle d’erreur via une
requête de transmission distante (RTR). L’équipement à garder renvoie une trame
de données CAN qui indique l’état NMT courant.
EIO0000000496 06/2011
19
Protocoles CANopen
Maître : Le maître surveille l’état NMT de l’esclave (Node Guarding).
Esclave : L’esclave surveille les signes de vie du maître (Life Guarding).
20
EIO0000000496 06/2011
SoMachine
CiA405
EIO0000000496 06/2011
Introduction à CiA405
2
Introduction
Méthodes d’accès au réseau CANopen
L’interface et le profil d’appareil CANopen des contrôleurs programmables
CEI 61131-3 (CiA405) décrivent deux méthodes permettant d’accéder au réseau
CANopen à partir du contrôleur :
 variables réseaux ;
 blocs fonction
Variables réseaux
En règle générale, les variables réseau sont mappées dans l’objet PDO à recevoir
ou à transmettre. Dans le dictionnaire d’objets, les variables CEI 61131-3 sont
accessibles dans une plage d’index définie.
Blocs fonction
Le profil définit également certains blocs fonction CANopen, notamment les
services de communication SDO, NMT et EMCY.
Bibliothèque CAA CiA 405
La bibliothèque CAA CiA 405 contient un ensemble de blocs fonction conformes à
l’interface CiA405 et permettant d’accéder au réseau CANopen à partir de
l’application (programme CEI 61131-3) du contrôleur (maître CANopen). Cette
bibliothèque est automatiquement déclarée dans le gestionnaire de bibliothèques
du contrôleur, lorsqu’un gestionnaire CANopen est ajouté à une interface de bus
CAN de contrôleur.
EIO0000000496 06/2011
21
CiA405
Dans la bibliothèque, les blocs fonction sont organisés comme suit :
 Blocs fonction de gestion de réseau :
 CIA405.NMT : pour contrôler les états NMT des appareilsCANopen.
 CIA405.RECV_EMCY : pour scruter les messages EMCY stockés sur
l’ensemble des appareils.
 CIA405.RECV_EMCY_DEV : pour obtenir le dernier message EMCY stocké
d’un appareil donné.

Blocs fonction d’ID de nœud personnel :
 CIA405.GET_LOCAL_NODE_ID : pour obtenir l’ID de nœud du gestionnaire
CANopen du contrôleur.

Blocs fonction d’état de requête :
 CIA405.GET_CANOPEN_KERNEL_STATE : pour obtenir l’état courant du
noyau CANopen.
 CIA405.GET_STATE : pour obtenir l’état courant d’un appareil donné.

Blocs fonction d’accès SDO :
 CIA405.SDO_READ : pour lire des objets de toute taille d’un appareil donné.
 CIA405.SDO_READ4 : pour lire des objets d’une taille maximale de 4 octets,
d’un appareil donné.
 CIA405.SDO_WRITE : pour écrire des objets de toute taille d’un appareil
donné.
 CIA405.SDO_WRITE4 : pour écrire des objets d’une taille maximale de
4 octets, d’un appareil donné.
NOTE : pour contrôler des variateurs Altivar et des variateurs de mouvement
Lexium sur CANopen, préférez les blocs fonction PLCopen dédiés (consultez les
Guides des bibliothèques Altivar, Lexium intégrée et Lexium).
Namespace
Le namespace de la bibliothèque CAA CiA 405 est CIA405. Les blocs fonction,
variables et constantes de la bibliothèque doivent être utilisés avec le namespace
de la bibliothèque.
Exemple d’instance de bloc fonction et de déclaration d’une variable :
VAR
ReadObject: CIA405.SDO_READ;
SDOabort_info: CIA405.SDO_ERROR;
END_VAR
22
EIO0000000496 06/2011
SoMachine
Description des blocs fonction
EIO0000000496 06/2011
Description des blocs fonction
II
Présentation
Cette partie présente les différents blocs fonction de la bibliothèque CAA CiA 405,
utilisés pour gérer et contrôler le réseau et les appareils CANopen à partir des
applications du contrôleur.
Contenu de cette partie
Cette partie contient les chapitres suivants :
Chapitre
EIO0000000496 06/2011
Titre du chapitre
Page
3
Comportement et E/S communes des blocs fonction
25
4
Blocs fonction de gestion de réseau
31
5
Blocs fonction d’ID de nœud personnel
39
6
Blocs fonction d’état de requête
41
7
Blocs fonction d’accès SDO
45
23
Description des blocs fonction
24
EIO0000000496 06/2011
SoMachine
Comportement et E/S communes des blocs fonction
EIO0000000496 06/2011
Comportement et E/S communes
des blocs fonction
3.1
3
Comportement et E/S communes
Contenu de ce sous-chapitre
Ce sous-chapitre contient les sujets suivants :
Sujet
EIO0000000496 06/2011
Page
Descriptions des E/S communes
26
Codes d’erreur de noyau CANopen détectés
28
Schémas d’exécution de blocs fonction
29
25
Comportement et E/S communes des blocs fonction
Descriptions des E/S communes
Introduction
Cette rubrique décrit la gestion et l’exécution des blocs fonction de la bibliothèque
CAA CiA 405 à l’aide du bloc fonction CIA405.RECV_EMCY par exemple. Les E/S
communes à tous les blocs fonction sont décrites ci-après. Elles proviennent du bloc
fonction caché interne CiA405Base.
Représentation graphique
Les paramètres communs à tous les blocs fonction de la bibliothèque CAA CiA 405
apparaissent en surbrillance dans le graphique ci-dessous.
Description des variables d’entrée communes
Le tableau suivant décrit les paramètres d’entrée communs à tous les blocs fonction
de la bibliothèque CAA CiA 405.
26
Entrée
Type de
données
Description
NETWORK
USINT
Canal CAN sur lequel le service demandé doit être
exécuté.
1 (valeur par défaut) = première interface de bus CAN
2 = seconde interface de bus CAN (si elle existe)
ENABLE
BOOL
Permet d’exécuter le bloc fonction.
Front montant : l’exécution démarre.
Front descendant : l’exécution est annulée si elle n’est pas
complète. Sinon, les données de sortie sont remises à
zéro.
TIMEOUT
UDINT
Durée d’exécution maximale en ms. Si le timeout est
atteint avant qu’une réponse ne soit disponible, l’exécution
est abandonnée et génère une erreur de timeout.
0 (paramètre d’usine) = timeout désactivé.
1 à 65535 = valeur du timeout en ms.
EIO0000000496 06/2011
Comportement et E/S communes des blocs fonction
Description des variables de sortie communes
Le tableau suivant décrit les variables de sortie communes à tous les blocs fonction
de la bibliothèque CAA CiA 405.
EIO0000000496 06/2011
Sortie
Type de données
Description
CONFIRM
BOOL
TRUE lorsque l’exécution se déroule sans
problème.
ERROR
CANOPEN_KERNEL_ERROR
(USINT)
Contient le code d’erreur d’exécution
détectée, renvoyé par le noyau CANopen.
00 hex = aucune erreur d’exécution détectée.
01 hex = erreur détectée, mais code
disponible dans une autre sortie du bloc
fonction (pas du noyau CANopen).
02 à FF hex = Code d’erreur détectée du
noyau CANopen.
27
Comportement et E/S communes des blocs fonction
Codes d’erreur de noyau CANopen détectés
Description
La bibliothèque contient une liste de variables globales
CIA405.CANOPEN_KERNEL_ERROR_CODES avec des variables de code d’erreur
prédéfinies.
Code d’erreur détectée
Les codes d’erreur avec la variable globale associée et une description sont
indiqués ci-après.
Code d’erreur détectée
Description
CANOPEN_KERNEL_NO_ERROR = 00 hex
Le noyau CANopen n’a pas détecté d’erreur.
CANOPEN_KERNEL_OTHER_ERROR = 01 hex
Si la sortie ERROR est 01 hex, une erreur a été détectée
et, si un autre code d’erreur est détecté au niveau du
bloc fonction, cette sortie contient une information plus
précise.
Exemples :
 Blocs fonction CIA405.SDO_READ et
CIA405.SDO_WRITE : la sortie ERRORINFO contient
le contenu du message d’abandon de SDO.
 Blocs fonction CIA405.RECV_EMCY et
CIA405.RECV_EMCY_DEV : la sortie ERRORINFO
contient le contenu du message EMCY reçu.
Lorsqu’un message d’urgence est disponible sur la
sortie ERRORINFO, la sortie ERROR est égale à 1 et
la sortie CONFIRM est égale à 0.
 Bloc fonction
CIA405.GET_CANOPEN_KERNEL_STATE : la valeur
01 hex n’est jamais transmise car il n’y a pas d’autre
sortie de code d’erreur.
CANOPEN_KERNEL_DATA_OVERFLOW = 02 hex
Dépassement de la capacité des tampons d’envoi ou de
réception d’objets CANopen.
CANOPEN_KERNEL_TIMEOUT = 03 hex
Un timeout d’exécution de bloc fonction s’est produit.
CANOPEN_KERNEL_CANBUS_OFF = 10 hex
Le nœud CANopen est déconnecté du bus CAN.
CANOPEN_KERNEL_CAN_ERROR_PASSIVE = 11 hex
Le nœud CANopen est en mode erreur passive : le
nœud peut communiquer, mais n’est pas autorisé à
envoyer un indicateur d’erreur actif en cas de détection
d’une erreur.
CANOPEN_INTERNAL_FB_ERROR = 21 hex
Code d’erreur spécifique du fabricant.
NOTE : les codes 21hex à FFhex sont des valeurs
propres au fabricant de l’équipement.
28
EIO0000000496 06/2011
Comportement et E/S communes des blocs fonction
Schémas d’exécution de blocs fonction
Comportement des signaux de contrôle
Les trois comportements types des signaux de contrôle ENABLE, CONFIRM et
ERROR sont décrits ci-après :
 Exécution arrêtée sans erreur détectée
 Exécution annulée par l’application
 Exécution abandonnée ou arrêtée en cas d’erreur détectée
Exécution arrêtée sans erreur détectée
Lorsque la réponse à la requête courante est disponible et qu’aucune erreur n’a été
détectée, la sortie CONFIRM prend et garde la valeur TRUE tant que le bloc fonction
est appelé avec l’entrée ENABLE réglée sur TRUE. Lorsque le bloc fonction est
appelé avec l’entrée ENABLE réinitialisée à FALSE, la sortie CONFIRM reprend la
valeur FALSE et le bloc fonction est prêt pour une nouvelle exécution.
Exécution annulée par l’application
Si le bloc fonction est appelé avec l’entrée ENABLE réinitialisée à FALSE avant la fin
de l’exécution en cours, l’exécution du bloc fonction est annulée. Toute réponse
disponible ou postérieure à la requête annulée est ignorée.
EIO0000000496 06/2011
29
Comportement et E/S communes des blocs fonction
Exécution abandonnée ou arrêtée en cas d’erreur détectée
Lorsque l’exécution en cours est abandonnée suite à un message d’annulation de
SDO ou est arrêtée en cas de détection d’une erreur, la sortie ERROR prend une
valeur différente de 0 (pour plus d’informations sur les codes d’erreur détectée,
reportez-vous à la section Codes d’erreur détectée de noyau CANopen
(voir page 28)). La sortie ERROR est réinitialisée à 0 et le bloc fonction est prêt pour
une nouvelle exécution lorsqu’il est appelé avec l’entrée ENABLE réinitialisée à
FALSE.
30
EIO0000000496 06/2011
SoMachine
Blocs fonction de gestion de réseau
EIO0000000496 06/2011
Blocs fonction de gestion de
réseau
4
Contenu de ce chapitre
Ce chapitre contient les sous-chapitres suivants :
Souschapitre
4.1
EIO0000000496 06/2011
Sujet
Page
CIA405.NMT : gestion de l’état NMT des appareils
32
4.2
CIA405.RECV_EMCY : scrutation des messages EMCY
35
4.3
CIA405.RECV_EMCY_DEV : réception du message EMCY de
l’appareil
37
31
Blocs fonction de gestion de réseau
4.1
CIA405.NMT : gestion de l’état NMT des appareils
Gestion de l’état NMT des appareils
Description du bloc fonction
Le bloc fonction CIA405.NMT permet de contrôler l’état NMT des appareils
CANopen à partir de l’application du contrôleur. Il envoie une requête de service
NMT à un appareil CANopen cible pour effectuer la transition d’état NMT
demandée.
Représentation graphique
Description des variables d’entrée
Entrée
Type de données
Description
DEVICE
DEVICE(USINT)
ID de nœud de l’appareil CANopen cible.
0 (valeur par défaut) = tous les appareils
esclaves NMT
1 à 127 = ID de nœud de l’appareil cible
STATE
TRANSITION_STATE. Voir cidessous pour les détails.
Transition d’état NMT demandée.
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
CIA405.TRANSITION_STATE ENUM
La machine d’état NMT décrit l’initialisation et l’état d’un esclave NMT dans son
fonctionnement.
32
EIO0000000496 06/2011
Blocs fonction de gestion de réseau
La figure suivante montre les états NMT, les objets de communication disponibles
associés (PDO, SDO, SYNC, EMCY et NMT) et les 5 transitions d’état (A à E).
Le type énuméré CIA405.TRANSITION_STATE contient les commandes de
transition d’état NMT décrites dans le tableau ci-dessous.
EIO0000000496 06/2011
Enumérateur
Valeur (hex.) Description
STOP_REMOTE_NODE
0004
Basculement vers l’état Arrêté.
(transition B)
START_REMOTE_NODE
0005
Basculement vers l’état Opérationnel.
(transition A)
RESET_NODE
0006
Basculement vers l’état Réinitialiser
l’application. Chargement des
données enregistrées des profils
d’appareil et basculement
automatique vers l’état Préopérationnel via la commande de
réinitialisation de la communication.
(transition D)
RESET_COMMUNICATION
0007
Basculement vers l’état Réinitialiser la
communication. Chargement des
données enregistrées du profil de
communication et basculement
automatique vers l’état Préopérationnel.
(transition E)
33
Blocs fonction de gestion de réseau
Enumérateur
Valeur (hex.) Description
ENTER_PRE_OPERATIONAL
007F
Basculement vers l’état Préopérationnel.
(transition C)
ALL_EXCEPT_NMT_AND_SENDER
0800
Non mise en œuvre (paramètre non
valide)
Exemple
L’exemple suivant montre comment envoyer une commande de réinitialisation de
nœud au nœud CANopen 5 connecté à la première interface de bus CAN avec un
timeout de 1 s (1000 ms). La commande est envoyée lorsque la variable booléenne
EN_ResetNode est réglée sur la valeur TRUE (par l’utilisateur connecté ou par
l’application). La commande EN_ResetNode reprend la valeur FALSE lorsque
l’exécution se termine avec succès (sortie CONFIRM = TRUE) ou lorsqu’une erreur
est détectée (sortie ERROR <> 0).
34
EIO0000000496 06/2011
Blocs fonction de gestion de réseau
4.2
CIA405.RECV_EMCY : scrutation des messages
EMCY
Scrutation des messages EMCY
Description du bloc fonction
Le bloc fonction CIA405.RECV_EMCY scrute les stockages de messages d’urgence
(EMCY) dans une boucle sur tous les appareils CANopen existants et renvoie les
messages EMCY trouvés.
Lorsque ce bloc fonction est activé, la scrutation des stockages EMCY démarre à
partir du point d’arrêt de la précédente scrutation :
 Si un message EMCY différent de Aucune erreur est trouvé, la scrutation s’arrête
à ce point et le bloc fonction renvoie le message EMCY ainsi que l’ID de nœud
de l’appareil associé.
 En cas de détection d’un message EMCY Aucune erreur qui était auparavant
différent de Aucune erreur, la scrutation s’arrête à ce point et le bloc fonction
renvoie le message EMCY 0 ainsi que le ID de nœud de l’appareil associé.
 Si aucun message EMCY n’est différent de Aucune erreur et qu’aucun nouveau
message EMCY Aucune erreur n’est trouvé pendant une scrutation complète, le
bloc fonction renvoie le message EMCY 0 ainsi que l’ID de nœud d’appareil 0.
Représentation graphique
EIO0000000496 06/2011
35
Blocs fonction de gestion de réseau
Description des variables de sortie
Sortie
Type de données
Description
DEVICE
DEVICE (USINT)
ID de nœud de l’appareil CANopen associé au
message EMCY renvoyé.
0 = Aucun message EMCY trouvé
1 à 127 = ID de nœud de l’appareil
ERRORINFO
Dernier message EMCY reçu de l’appareil
CS.EMCY_ERROR. Pour
associé à l’ID de nœud DEVICE.
plus d’informations,
reportez-vous à la section
sur la structure
CS.EMCY_ERROR
(voir page 38).
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
36
EIO0000000496 06/2011
Blocs fonction de gestion de réseau
4.3
CIA405.RECV_EMCY_DEV : réception du message
EMCY de l’appareil
Extraction du message EMCY d’appareil
Description du bloc fonction
Le bloc fonction CIA405.RECV_EMCY_DEV renvoie le dernier message d’urgence
(EMCY) stocké, envoyé par un appareil CANopen donné.
Représentation graphique
Description des variables d’entrée
Entrée
Type
Description
DEVICE
DEVICE(USINT)
ID de nœud de l’appareil CANopen à
contrôler.
0 (valeur par défaut) = appareil local
(contrôleur)
1 à 127 = ID de nœud de l’appareil
Sortie
Type
Description
ERRORINFO
CS.EMCY_ERROR. (Voir Dernier message EMCY reçu de l’appareil
associé à l’ID de nœud DEVICE.
ci-dessous pour les
détails.)
Description des variables de sortie
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
EIO0000000496 06/2011
37
Blocs fonction de gestion de réseau
Structure CS.EMCY_ERROR
La structure CS.EMCY_ERROR est associée au contenu du message EMCY
(consultez le guide CANopen de votre appareil pour plus d’informations sur le
contenu du message EMCY). La structure CS.EMCY_ERROR contient les éléments
suivants :
Elément
Type
Description
EMCY_ERROR_CODE
WORD
Code d’erreur du message EMCY
ERROR_REGISTER
BYTE
Registre d’erreur (champ de bit) du
message EMCY
ERROR_FIELD
ARRAY [1...5]OF
BYTE
Champ d’erreur (propre au fabricant de
l’appareil) du message EMCY
NOTE : cette structure est déclarée dans la bibliothèque de la pile CANopen CAA
(namespace = CS). C’est la raison pour laquelle son nom complet est utilisé
(<namespace>.<type de données>). Le namespace de la bibliothèque CAA CiA 405
est CIA405.
38
EIO0000000496 06/2011
SoMachine
Blocs fonction d’ID de nœud personnel
EIO0000000496 06/2011
Blocs fonction d’ID de nœud
personnel
5.1
5
CIA405.GET_LOCAL_NODE_ID : obtention de l’ID
de nœud CANopen du contrôleur
Extraction de l’ID de nœud CANopen de l’automate
Description du bloc fonction
Le bloc fonction CIA405.GET_LOCAL_NODE_ID renvoie l’ID de nœud CANopen du
contrôleur sur l’interface de bus CAN spécifiée.
Représentation graphique
Description des variables de sortie
Sortie
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud CANopen du contrôleur.
0 = non valide
1 à 127 = ID de nœud du contrôleur
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
EIO0000000496 06/2011
39
Blocs fonction d’ID de nœud personnel
40
EIO0000000496 06/2011
SoMachine
Blocs fonction d’état de requête
EIO0000000496 06/2011
Blocs fonction d’état de requête
6
Contenu de ce chapitre
Ce chapitre contient les sous-chapitres suivants :
Souschapitre
EIO0000000496 06/2011
Sujet
Page
6.1
CIA405.GET_CANOPEN_KERNEL_STATE : obtention de l’état
du noyau CANopen
42
6.2
CIA405.GET_STATE : obtention de l’état de l’appareil
CANopen
43
41
Blocs fonction d’état de requête
6.1
CIA405.GET_CANOPEN_KERNEL_STATE :
obtention de l’état du noyau CANopen
Extraction de l’état du noyau CANopen
Description du bloc fonction
Le bloc fonction CIA405.GET_CANOPEN_KERNEL_STATE renvoie l’état courant du
noyau CANopen du contrôleur.
Représentation graphique
Description des variables de sortie
Sortie
Type
Description
STATE
CANOPEN_KERNEL_ERROR
(Pour plus de détails, reportezvous à la section Codes d’erreur
détectée du noyau CANopen
(voir page 28).)
Etat courant du noyau CANopen du
contrôleur
DEVICE
DEVICE
(USINT)
ID de nœud CANopen du contrôleur.
0 = non valide
1 à 127 = ID de nœud du contrôleur
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
42
EIO0000000496 06/2011
Blocs fonction d’état de requête
6.2
CIA405.GET_STATE : obtention de l’état de
l’appareil CANopen
Extraction de l’état d’appareil CANopen
Description du bloc fonction
Le bloc fonction CIA405.GET_STATE renvoie l’état NMT courant de l’appareil
CANopen spécifié si le service Heartbeat ou NodeGuarding est actif.
Représentation graphique
Description des variables d’entrée
Entrée
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud de l’appareil CANopen à contrôler.
0 (valeur par défaut) = appareil local (contrôleur)
1 à 127 = ID de nœud de l’appareil
Description des variables de sortie
Sortie
Type
Description
STATE
DEVICE_STATE
(Voir ci-dessous pour
les détails.)
Etat NMT de l’appareil CANopen.
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
CIA405.DEVICE_STATE ENUM
Le type énuméré CIA405.DEVICE_STATE contient la liste des états NMT d’appareil
CANopen.
EIO0000000496 06/2011
43
Blocs fonction d’état de requête
Enumérateur
Valeur
Description
INIT
0
Etat d’initialisation
RESET_COMM
1
Etat de réinitialisation de la communication
RESET_APP
2
Etat de réinitialisation de l’application
PRE_OPERATIONAL
3
Etat pré-opérationnel
STOPPED
4
Etat arrêté
OPERATIONAL
5
État opérationnel
UNKNOWN
6
Etat NMT inconnu
Le service NodeGuarding ou Heartbeat n’est pas
actif sur l’appareil sélectionné ou le contrôleur n’est
pas le consommateur Hearbeat.
NOT_AVAIL
7
Etat NMT indisponible
Le service NodeGuarding ou Heartbeat est actif sur
l’appareil sélectionné, mais ce dernier ne signale pas
son état NMT correctement avant le timeout.
Exemple
L’exemple suivant montre comment obtenir l’état du nœud CANopen 5 connecté à
la première interface de bus CAN avec un timeout de 1 s (1000 ms). La fonction
CIA405.GET_STATE est exécutée automatiquement pour une lecture continue de
l’état. L’état NMT de l’appareil est copié dans la variable DeviceState de type
CIA405.DEVICE_STATE.
44
EIO0000000496 06/2011
SoMachine
Blocs fonction d’accès SDO
EIO0000000496 06/2011
Blocs fonction d’accès SDO
7
Contenu de ce chapitre
Ce chapitre contient les sous-chapitres suivants :
Souschapitre
EIO0000000496 06/2011
Sujet
Page
7.1
CIA405.SDO_READ : lecture d’objets CANopen de toute taille
46
7.2
CIA405.SDO_READ4 : lecture d’objets CANopen d’au
maximum 4 octets
49
7.3
CIA405.SDO_WRITE : écriture d’objets CANopen de toute
taille
52
7.4
CIA405.SDO_WRITE4 : écriture d’objets CANopen d’au
maximum 4 octets
57
45
Blocs fonction d’accès SDO
7.1
CIA405.SDO_READ : lecture d’objets CANopen de
toute taille
Lecture d’objets CANopen de toute taille
Description du bloc fonction
Le bloc fonction CIA405.SDO_READ permet de lire un objet CANopen de taille
quelconque d’un appareil donné via des messages SDO.
Ces paramètres doivent être transmis au bloc fonction :
 ID de nœud de l’appareil
 Canal client/serveur SDO (par défaut, un seul canal est défini.)
 Index/sous-index de l’objet CANopen
 Pointeur désignant le tampon de données dans lequel les valeurs d’objet seront
stockées.
 Taille maximale du tampon
Le bloc fonction renvoie la taille de l’objet lu si la lecture est déroulée sans problème.
Les données sont disponibles dans le tampon de données.
NOTE : si la taille de l’objet à lire est inférieure ou égale à 4 octets, utilisez le bloc
fonction CIA405.SDO_READ4.
Représentation graphique
46
EIO0000000496 06/2011
Blocs fonction d’accès SDO
Description des variables d’entrée
Entrée
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud de l’appareil CANopen.
0 (valeur par défaut) = appareil local
(contrôleur)
1 à 127 = ID de nœud de l’appareil
CHANNEL
USINT
Numéro du canal SDO.
Valeur par défaut = 1
INDEX
WORD
Index de l’objet.
Plage : 0000 hex à FFFF hex
SUBINDEX
BYTE
Sous-index de l’objet.
Plage : 00 hex à FF hex
DATA
POINTER TO BYTE
Adresse du tampon de données qui reçoit les
données lues dans l’objet de l’appareil.
Utilisez la fonction standard ADR pour définir
le pointeur associé.
Description des variables de sortie
Sortie
Type
Description
ERRORINFO
SDO_ERROR
(UDINT)
Lorsque la sortie ERROR est égale à 1, le bloc
fonction renvoie le contenu du message
d’annulation SDO (4 octets).
Description des variables d’entrée/sortie
Entrée/sortie
Type
Description
DATALENGTH
UINT
En entrée : taille du tampon de données (en
octets).
NOTE : pour s’assurer que l’entrée DATALENGTH
est correctement initialisée (l’exécution du bloc
fonction débutant sur le front montant de l’entrée
ENABLE) avec la taille du tampon de données,
utilisez la fonction standard SIZEOF.
En sortie : taille de l’objet lu (en octets).
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
EIO0000000496 06/2011
47
Blocs fonction d’accès SDO
Exemple
L’exemple suivant montre comment lire l’index d’objet 203C hex/sous-index 02 hex
du nœud CANopen 5 connecté à la première interface de bus CAN avec un timeout
de 1 s (1000 ms). L’instance de bloc fonction CIA405.SDO_READ (ReadObject) est
automatiquement exécutée pour une lecture en continu.
La variable DataSize (type UINT) :
est initialisée avec la taille du tampon de données (DataBuffer : tableau de
N octets) lorsque l’entrée ENABLE du bloc fonction a pour valeur FALSE, avant
de lancer l’exécution suivante.
 contient la taille des données lues (en octets) sur le front montant de la sortie
CONFIRM du bloc fonction (l’exemple ne montre pas comment extraire la valeur
du tampon de données ni comment gérer les détections d’erreur).

48
EIO0000000496 06/2011
Blocs fonction d’accès SDO
7.2
CIA405.SDO_READ4 : lecture d’objets CANopen
d’au maximum 4 octets
Lecture d’objets CANopen d’au maximum 4 octets
Description du bloc fonction
Le bloc fonction CIA405.SDO_READ4 permet de lire un objet CANopen d’une taille
maximale de 4 octets, d’un équipement donné via un message SDO.
Ces paramètres doivent être transmis au bloc fonction :
 ID de nœud de l’équipement
 Canal client/serveur SDO (par défaut, un seul canal est défini.)
 Index/sous-index de l’objet CANopen
Le bloc fonction renvoie la taille de l’objet lu si la lecture s’est déroulée sans
problème. Les données sont disponibles dans un tableau de 4 octets.
Représentation graphique
Description des variables d’entrée
EIO0000000496 06/2011
Entrée
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud de l’équipement CANopen.
0 (valeur par défaut) = équipement local
(contrôleur)
1 à 127 = ID de nœud de l’équipement
CHANNEL
USINT
Numéro du canal SDO.
Valeur par défaut = 1
INDEX
WORD
Index de l’objet.
Plage : 0000 hex à FFFF hex
SUBINDEX
BYTE
Sous-index de l’objet.
Plage : 00 hex à FF hex
49
Blocs fonction d’accès SDO
Description des variables de sortie
Sortie
Type
Description
DATA
ARRAY [1..0,4]OF
BYTE
Tableau de données qui reçoit les données
lues dans l’objet de l’équipement.
DATALENGTH
USINT
Taille de l’objet lu (en octets).
ERRORINFO
SDO_ERROR
(UDINT)
Lorsque la sortie ERROR est égale à 1, le
bloc fonction renvoie le contenu du
message d’annulation SDO (4 octets).
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
Le tableau suivant montre la taille de l’objet en fonction du contenu du tableau
DATA.
Taille de l’objet
Exemple
DATALENGTH
DATA(1)
DATA(2)
DATA(3)
DATA(4)
1 octet
01 hex
1
01 hex
non
significatif
non
significatif
non
significatif
2 octets
01 23 hex
2
LSB
23 hex
MSB
01 hex
non
significatif
non
significatif
3 octets
01 23 45 hex
3
LSB
45 hex
23 hex
MSB
01 hex
non
significatif
4 octets
01 23 45 67 hex
4
LSB
67 hex
45 hex
23 hex
MSB
01 hex
LSB = octet de poids faible
MSB = Octet de poids fort
Exemple
L’exemple suivant montre comment lire l’index d’objet 203C hex/sous-index 02 hex
du nœud CANopen 5 connecté à la première interface de bus CAN avec un timeout
de 1 s (1000 ms). L’instance de bloc fonction CIA405.SDO_READ4 (Read4Object)
est automatiquement exécutée pour une lecture en continu. La variable
DataBuffer (tableau de 4 octets) contient la valeur des dernières données lues.
La variable DataSize (type USINT) contient la taille (4 octets au maximum) des
dernières données lues. Cet exemple ne montre pas comment gérer les détections
d’erreur.
50
EIO0000000496 06/2011
Blocs fonction d’accès SDO
EIO0000000496 06/2011
51
Blocs fonction d’accès SDO
7.3
CIA405.SDO_WRITE : écriture d’objets CANopen
de toute taille
Ecriture d’objets CANopen de toute taille
Description du bloc fonction
Le bloc fonction CIA405.SDO_WRITE permet d’écrire un objet CANopen de taille
quelconque d’un équipement donné via des messages SDO.
Ces paramètres doivent être transmis au bloc fonction :
 ID de nœud de l’équipement
 Canal client/serveur SDO (par défaut, un seul canal est défini.)
 Index/sous-index de l’objet CANopen
 Mode SDO (définit le mode de transmission des données ; reportez-vous à la
section Type énuméré SDO_MODE pour plus de détails (voir page 54).)
 Pointeur désignant le tampon de données dans lequel les valeurs d’objet à écrire
sont stockées.
 Nombre d’octets à écrire.
NOTE : si la taille de l’objet à écrire est égale ou inférieure à 4 octets, utilisez le bloc
fonction CIA405.SDO_WRITE4.
Représentation graphique
52
EIO0000000496 06/2011
Blocs fonction d’accès SDO
Description des variables d’entrée
Entrée
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud de l’équipement CANopen.
0 (valeur par défaut) = équipement local
(contrôleur)
1 à 127 = ID de nœud de l’équipement
CHANNEL
USINT
Numéro du canal SDO.
Valeur par défaut = 1
INDEX
WORD
Index de l’objet.
Plage : 0000 hex à FFFF hex
SUBINDEX
BYTE
Sous-index de l’objet.
Plage : 00 hex à FF hex
MODE
SDO_MODE
(Voir ci-dessous pour
les détails.)
Mode de transmission des données.
0 (valeur par défaut) = AUTO pour une
sélection automatique du mode
DATA
POINTER TO BYTE
Adresse du tampon de données dans lequel
les valeurs d’objet à écrire sont stockées.
Utilisez la fonction standard ADR pour définir
le pointeur associé.
DATALENGTH
UINT
Taille de l’objet à écrire (en octets).
NOTE : utilisez la fonction SIZEOF pour définir
la taille du tampon de données.
Description des variables de sortie
Sortie
Type
Description
ERRORINFO
SDO_ERROR
(UDINT)
Lorsque la sortie ERROR est égale à 1, le bloc
fonction renvoie le contenu du message
d’annulation SDO (4 octets).
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
EIO0000000496 06/2011
53
Blocs fonction d’accès SDO
Type énuméré CIA405.SDO_MODE
Le type énuméré CIA405.SDO_MODE contient la liste des modes de transmission
SDO.
Enumérateur
Valeur
Description
AUTO
0
Sélection automatique du mode.
EXPEDITED
1
Mode SDO accéléré pour les données d’une taille maximale
de 4 octets.
Les données sont envoyées dans une seule requête SDO.
SEGMENTED
2
Mode SDO segmenté pour les données d’une taille supérieure
à 4 octets.
Les données sont découpées en segments de 7 octets,
envoyés par des requêtes de SDO acquittées consécutives.
BLOCK
3
Mode Bloc de SDO pour les données d’une taille supérieure à
4 octets.
Les données envoyés par des trames consécutives sont
découpées en blocs de 7 octets non acquittés. Un
acquittement est envoyé par le récepteur une fois tous les
blocs reçus.
NOTE : votre équipement peut ne pas prendre en charge ce
mode de transmission plus rapide, car il n’a été introduit que
très récemment dans le profil CANopen.
Exemple
Exemple de programme en langage ST pour lire et écrire des données sur des
équipements CANopen :
Un ATV71 est déclaré à l’adresse de nœud 1.
Un ATV31 est déclaré à l’adresse de nœud 2.
Les données à écrire ou à lire sont les suivantes :
INDEX:=16#203C ,
SUBINDEX:=2 ,
La valeur écrite (SDOWrite_data) est une rampe de 0 à 500 incrémentée à chaque
cycle.
PROGRAM Read_Write_SDO
VAR
WriteSDO_ATV71 : CIA405.SDO_WRITE;
WriteSDO_ATV31 : CIA405.SDO_WRITE;
ReadSDO_ATV31 : CIA405.SDO_READ;
SDOWrite_data : UINT;
54
EIO0000000496 06/2011
Blocs fonction d’accès SDO
SDORead_data : UINT;
ReadSDO_datalength : UINT:=2;
start_test : BOOL;
END_VAR
IF start_test THEN
WriteSDO_ATV31(
NETWORK:= ,
ENABLE:= NOT (WriteSDO_ATV31.CONFIRM OR
(WriteSDO_ATV31.ERROR<>0)) ,
TIMEOUT:= ,
DEVICE:=2 ,
CHANNEL:= ,
INDEX:=16#203C ,
SUBINDEX:=2 ,
MODE:= ,
DATA:=ADR(SDOWrite_data) ,
DATALENGTH:=2 ,
CONFIRM=> ,
ERROR=> ,
ERRORINFO=> );
ReadSDO_ATV31(
NETWORK:= ,
ENABLE:=NOT (ReadSDO_ATV31.CONFIRM OR
(ReadSDO_ATV31.ERROR<>0)) ,
TIMEOUT:= ,
DEVICE:=1 ,
CHANNEL:= ,
INDEX:=16#203C ,
SUBINDEX:=2 ,
DATA:=ADR(SDORead_data) ,
DATALENGTH:=ReadSDO_datalength ,
CONFIRM=> ,
ERROR=> ,
EIO0000000496 06/2011
55
Blocs fonction d’accès SDO
ERRORINFO=> );
WriteSDO_ATV71(
NETWORK:= ,
ENABLE:= NOT (WriteSDO_ATV71.CONFIRM OR
(WriteSDO_ATV71.ERROR<>0)) ,
TIMEOUT:= ,
DEVICE:=1 ,
CHANNEL:= ,
INDEX:=16#203C ,
SUBINDEX:=2 ,
MODE:= ,
DATA:=ADR(SDOWrite_data) ,
DATALENGTH:=2 ,
CONFIRM=> ,
ERROR=> ,
ERRORINFO=> );
IF SDOWrite_data<500
THEN SDOWrite_data:=SDOWrite_data+1;
ELSE SDOWrite_data:=0;
END_IF
END_IF
56
EIO0000000496 06/2011
Blocs fonction d’accès SDO
7.4
CIA405.SDO_WRITE4 : écriture d’objets CANopen
d’au maximum 4 octets
Ecriture d’objets CANopen d’au maximum 4 octets
Description du bloc fonction
Le bloc fonction CIA405.SDO_WRITE4 permet d’écrire un objet CANopen d’une
taille maximale de 4 octets, d’un appareil donné via des messages SDO.
Ces paramètres doivent être transmis au bloc fonction :
 ID de nœud de l’appareil
 Canal client/serveur SDO (par défaut, un seul canal est défini.)
 Index/sous-index de l’objet CANopen
 Valeurs à écrire
 Nombre d’octets à écrire (taille de l’objet)
Représentation graphique
Description des variables d’entrée
EIO0000000496 06/2011
Entrée
Type
Description
DEVICE
DEVICE
(USINT)
ID de nœud de l’appareil CANopen.
0 (valeur par défaut) = appareil local
(contrôleur)
1 à 127 = ID de nœud de l’appareil
CHANNEL
USINT
Numéro du canal SDO.
Valeur par défaut = 1
INDEX
WORD
Index de l’objet.
Plage : 0000 hex à FFFF hex
57
Blocs fonction d’accès SDO
Entrée
Type
Description
SUBINDEX
BYTE
Sous-index de l’objet.
Plage : 00 hex à FF hex
DATA
ARRAY [1..0,4]OF
BYTE
Tableau de données dans lequel les valeurs
d’objet à écrire sont stockées.
DATALENGTH
USINT
Taille de l’objet à écrire (en octets).
Sortie
Type
Description
ERRORINFO
SDO_ERROR
(UDINT)
Lorsque la sortie ERROR est égale à 1, le
bloc fonction renvoie le contenu du
message d’annulation SDO (4 octets).
Description des variables de sortie
NOTE : pour une description des E/S communes et du comportement d’exécution
des blocs fonction, reportez-vous au chapitre Comportement et E/S communes des
blocs fonction (voir page 25).
Le tableau suivant montre la taille de l’objet en fonction du contenu du tableau
DATA.
Taille de l’objet
Exemple
DATALENGTH
DATA(1)
DATA(2)
DATA(3)
DATA(4)
1 octet
01 hex
1
01 hex
non
significatif
non
significatif
non
significatif
2 octets
01 23 hex
2
LSB
23 hex
MSB
01 hex
non
significatif
non
significatif
3 octets
01 23 45 hex
3
LSB
45 hex
23 hex
MSB
01 hex
non
significatif
4 octets
01 23 45 67 hex
4
LSB
67 hex
45 hex
23 hex
MSB
01 hex
LSB = octet de poids faible
MSB = Octet de poids fort
58
EIO0000000496 06/2011
SoMachine
Glossaire
EIO0000000496 06/2011
Glossaire
C
CAN
Abréviation de Controller Area Network. Bus série pour système de contrôle
embarqué.
CANopen
Protocole CAN de haut niveau, normalisé à l’échelle internationale (EN 50325-4)
pour système de contrôle embarqué.
CiA
Acronyme de CAN in Automation. Regroupement de fabricants et d’utilisateurs qui
œuvre au développemnt et à l’adoption du protocole CANopen et d’autres
protocoles de haut niveau basé sur ce protocole.
CiA405
Interface et profil d’appareil CANopen pour contrôleurs programmables CEI 611313.
COB
Acronyme désignant un objet de communication du protocole CANopen.
E
E/S
Entrée/sortie
EIO0000000496 06/2011
59
Glossaire
EDS
Abréviation d’Electronic Data Sheet. Format de fichier décrivant un appareil de bus
de terrain.
EMCY
Abréviation d’Emergency, signifiant urgence.
H
hex
Abréviation de hexadécimal.
I
ID
Identificateur
M
ms
Abréviation de milliseconde.
N
NMT
Abréviation de Network Management, signifiant gestion de réseau CANopen.
O
OD
Abréviation d’Object Dictionnary. Dictionnaire d’objets du protocole CANopen.
60
EIO0000000496 06/2011
Glossaire
P
PDO
Abréviation de Process Data Object, désignant un objet de données de process
utilisé par le protocole CANopen.
Protocol
Ensemble de règles utilisées par des appareils pour communiquer les uns avec les
autres sur un réseau.
S
SDO
Abréviation de Service Data Object, désignant un objet de données de service
utilisé par protocole CANopen.
EIO0000000496 06/2011
61
Glossaire
62
EIO0000000496 06/2011
SoMachine
Index
EIO0000000496 06/2011
B
AC
Index
B
Bloc fonction
GET_CANOPEN_KERNEL_STATE, 42
GET_LOCAL_NODE_ID, 39
GET_STATE, 43
NMT, 32
RECV_EMCY, 35
RECV_EMCY_DEV, 37
Blocs fonction d’accès SDO
CIA405.SDO_READ : lecture d’objets
CANopen de toute taille, 46
CIA405.SDO_READ4 : lecture d’objets
CANopen d’au maximum 4 octets, 49
CIA405.SDO_WRITE : écriture d’objets
CANopen de toute taille, 52
CIA405.SDO_WRITE4 : écriture d’objets
CANopen d’au maximum 4 octets, 57
Blocs fonction d’état de requête
CIA405.GET_CANOPEN_KERNEL_ST
ATE : obtention de l’état du noyau CANopen, 42
CIA405.GET_STATE : obtention de l’état
de l’appareil CANopen, 43
Blocs fonction d’ID de nœud personnel
CIA405.GET_LOCAL_NODE_ID : obtention de l’ID de nœud CANopen du
contrôleur, 39
Blocs fonction de gestion de réseau
CIA405.NMT : gestion de l’état NMT des
appareils, 32
CIA405.RECV_EMCY : scrutation des
EIO0000000496 06/2011
messages EMCY, 35
CIA405.RECV_EMCY_DEV : réception
du message EMCY de l’appareil, 37
C
CANOPEN_KERNEL_ERROR_CODES
Liste de variables globales, 28
Comportement et E/S communes des blocs
fonction
comportement et E/S communes, 25
D
Description des blocs fonction, 23
blocs fonction d’accès SDO, 45
blocs fonction d’état de requête, 41
blocs fonction d’ID de nœud personnel,
39
blocs fonction de gestion de réseau, 31
Comportement et E/S communes des
blocs fonction, 25
DEVICE_STATE
Variables de sortie, 43
E
EMCY_ERROR
Variables de sortie, 38
63
Index
G
GET_CANOPEN_KERNEL_STATE
Bloc fonction, 42
GET_LOCAL_NODE_ID
Bloc fonction, 39
GET_STATE
Bloc fonction, 43
I
Introduction, 9
Introduction à CiA405, 21
Introduction au protocole CANopen, 11
L
Liste de variables globales
CANOPEN_KERNEL_ERROR_CODES
, 28
N
NMT
Bloc fonction, 32
R
RECV_EMCY
Bloc fonction, 35
RECV_EMCY_DEV
Bloc fonction, 37
T
TRANSITION_STATE
Variables d’entrée, 32
V
Variables d’entrée
TRANSITION_STATE, 32
Variables de sortie
DEVICE_STATE, 43
EMCY_ERROR, 38
64
EIO0000000496 06/2011