Interface de commande

Description générale

L'interface de commande sert à :

envoyer des commandes distantes ;
envoyer des commandes de contrôle à distance.

Les commandes distantes sont des commandes non intrusives. Elles ne sont pas protégées par un mot de passe et sont toujours activées.

Les commandes de contrôle à distance sont des commandes intrusives. Elles peuvent présenter un danger pour le personnel situé près du disjoncteur ou peuvent provoquer des dommages de l'équipement si les paramètres de protection sont modifiés. Par conséquent, les commandes de contrôle à distance sont :

protégées par un mot de passe lorsqu'un mot de passe est requis dans la commande ;
protégées par la configuration :
- avec l'interface IFM, les commandes de contrôle à distance sont activées lorsque le commutateur de verrouillage sur l'interface IFM est en position ouverte.
- avec l'interface IFE, les commandes de contrôle à distance sont activées lorsque le commutateur de verrouillage sur l'interface IFE est en position ouverte.
- avec l'interface EIFE, les commandes de contrôle à distance sont activées lorsque le mode de commande intrusif est déverrouillé par la configuration EIFE à l'aide du EcoStruxure Power Commission software.

Chaque commande possède un code spécifique. Par exemple, le code de commande 904 correspond à la commande d'ouverture du disjoncteur.

Exécution d'une commande

Suivez ces étapes pour exécuter une commande :

Étape	Action
1	Charger une mémoire tampon.
2	Écrire ce tampon avec une requête d'écriture (fonction Modbus 16) en commençant au registre 8000.
3	Lire le registre 8021 d'état de la commande et attendre tant que son contenu indique que la commande est encore en cours d'exécution (0x0003).
4	Lire le registre de code de commande 8020 : si le contenu du registre 8020 est le code de commande saisi dans le registre 8000 à l'étape 2, passer à l'étape suivante. si le contenu du registre 8020 est différent du code de commande saisi dans le registre 8000 à l'étape 2, recommencer à l'étape 1.
5	Lire l'identifiant du code d'erreur dans les bits de poids faible (LSB) du registre 8021 : Si le LSB ≠ 0, la commande a échoué. Vérifier le code d'erreur pour en comprendre la cause (voir le paragraphe suivant). Par exemple, si le registre 8021 renvoie la valeur 4609 (0x1201), le code d'erreur est 1, ce qui signifie que le mot de passe n'est pas correct (droits d'utilisateur insuffisants). Si le LSB = 0, la commande s'est exécutée sans erreur.

NOTE: L’application Modbus doit attendre la fin de l’exécution d’une commande avant d’envoyer la commande suivante. En l'absence de réponse, l'application Modbus peut renvoyer la commande. Dans ce cas, la première commande est automatiquement annulée.

Diagramme de commande

Le diagramme ci-dessous indique les étapes à suivre pour exécuter une commande :

Structure des données de commande

L’interface de commande utilise les registres 8000 à 8149 :

Les paramètres d’entrée d’une commande sont écrits dans les registres 8000 à 8015. Les registres 8016 à 8019 sont réservés.
Les données renvoyées après l’exécution de la commande sont écrits dans les registres 8020 à 8149.

Les paramètres d’entrée d’une commande sont détaillés dans le tableau suivant :

Adresse	Registre	Description	Commentaires
0x1F3F	8000	Code de commande	Ecrire dans ce registre déclenche l'exécution de la commande en utilisant les paramètres des registres suivants.
0x1F40	8001	Longueur des paramètres	Nombre d'octets utilisés pour les paramètres incluant celui-ci (de 10 à 30). Cette valeur est fournie pour chaque commande.
0x1F41	8002	Destination	Une valeur constante fournie pour chaque commande. Réglage d'usine = 0x0000
0x1F42	8003	Type de sécurité	Une valeur constante fournie pour chaque commande: 0 pour les commandes non intrusives non protégées par mot de passe ; 1 pour les commandes intrusives protégées par mot de passe.
0x1F43 0x1F44	8004 8005	Mot de passe	Le mot de passe se compose de 4 octets ASCII. Le mot de passe à utiliser dépend de la commande. Cette information est fournie pour chaque commande.
0x1F45–0x1F4E	8006–8015	Paramètres supplémentaires	Les paramètres supplémentaires définissent le mode d'exécution de la commande. Certaines commandes ne possèdent aucun paramètre supplémentaire.
0x1F4F	8016	Réservé	Doit être défini sur 0 (réglage d'usine).
0x1F50	8017	Réservé	Doit être défini sur 8019 (réglage d'usine).
0x1F51	8018	Réservé	Doit être défini sur 8020 (réglage d'usine).
0x1F52	8019	Réservé	Doit être défini sur 8021 (réglage d'usine).

Les données renvoyées après l’exécution de la commande sont détaillés dans le tableau suivant :

Adresse	Registre	Description	Commentaires
0x1F53	8020	Dernier code de commande	Lorsque la commande a été exécutée, ce registre conserve le dernier code de commande.
0x1F54	8021	Etat de la commande	Lorsque la commande quitte l'état occupé, ce registre contient le code de fin.
0x1F55	8022	Taille de la mémoire tampon de données	Nombre d’octets renvoyés.
0x1F56–0x1FD4	8023–8149	Mémoire tampon de données	Valeurs retournées. Ce registre est vide si le registre précédent est 0.

État de la commande

Lorsque la commande réussit, son état est 0.

Lorsque la commande est en cours, son état est 3.

Lorsque la commande génère une erreur, son registre d'état contient :

LSB : code de l'erreur
MSB : adresse du module qui génère l'erreur

Module renvoyant le résultat de la commande

Le tableau ci-dessous répertorie les adresses des modules :

Adresse du module	Module
1 (0x01)	Module de maintenance UTA
2 (0x02)	Afficheur ULP FDM121 pour un disjoncteur
3 (0x03)	Interface IFM Modbus-SL pour un disjoncteur
17 (0x11)	Module de contrôle et d'état du disjoncteur (BSCM) pour ComPact NSX
18 (0x12)	Module de communication du disjoncteur BCM ULP pour MasterPact NT/NW et ComPact NS
20 (0x14)	Déclencheur MicroLogic du disjoncteur ComPact NSX
21 (0x15)	Unité de contrôle MicroLogic de MasterPact MTZ
32 (0x20)	Module 1 d'application d'entrée/sortie IO pour un disjoncteur
33 (0x21)	Module 2 d'application d'entrée/sortie IO pour un disjoncteur
34 (0x22)	Interface Ethernet IFE pour un disjoncteur Serveur de tableau Ethernet IFE

NOTE: Les déclencheurs MicroLogic des disjoncteurs MasterPact NT/NW et ComPact NS ne disposent pas d'une adresse de module IMU.

Résultat de la commande

Le tableau suivant répertorie les codes correspondant au résultat de la commande.

Code	Description
0 (0x00)	Commande réussie
1 (0x01)	Droits utilisateur insuffisants (mot de passe incorrect)
2 (0x02)	Violation d'accès (le commutateur de verrouillage IFM est verrouillé ou le commutateur de verrouillage IFE est verrouillé ou le mode de commande intrusif est verrouillé).
3 (0x03)	Accès en lecture impossible
4 (0x04)	Accès en écriture impossible
5 (0x05)	Impossible d'exécuter le service (commutateur de verrouillage IFM verrouillé)
6 (0x06)	Mémoire insuffisante
7 (0x07)	Mémoire attribuée insuffisante
8 (0x08)	Ressource indisponible
9 (0x09)	Ressource inexistante
10 (0x0A)	Ressource existante
11 (0x0B)	Ressource hors service
12 (0x0C)	Accès hors de la mémoire disponible
13 (0x0D)	Chaîne trop longue
14 (0x0E)	Mémoire tampon insuffisante
15 (0x0F)	La mémoire tampon est trop volumineuse
16 (0x10)	Argument d'entrée hors limites
17 (0x11)	Niveau de sécurité demandé non pris en charge
18 (0x12)	Composant demandé non pris en charge
19 (0x13)	Commande non prise en charge
20 (0x14)	Argument d'entrée incluant une valeur non prise en charge
21 (0x15)	Erreur interne pendant la commande
22 (0x16)	Délai d'expiration pendant la commande
23 (0x17)	Erreur de somme de contrôle pendant la commande
24 (0x18)	Destination non prise en charge
151 (0x97)	Disjoncteur déclenché, réinitialiser avant les commandes
152 (0x98)	Le disjoncteur est déjà fermé
153 (0x99)	Le disjoncteur est déjà ouvert
154 (0x9A)	Disjoncteur déjà réinitialisé
155 (0x9B)	Actionneur en mode manuel
156 (0x9C)	Actionneur absent
157 (0x9D)	Configuration ASIC incorrecte
158 (0x9E)	Commande précédente en cours d'exécution
159 (0x9F)	Interdit de réinitialiser la commande
160 (0xA0)	Mode d'inhibition sur
169 (0xA9)	Déjà à l'état demandé
170 (0xAA)	Impossible d'attribuer des valeurs de présélection aux compteurs
171 (0xAB)	Commande de sortie rejetée, déjà attribuée
172 (0xAC)	Emetteur non autorisé à effectuer la commande
173 (0xAD)	Mode non pertinent avec la commande demandée
174 (0xAA)	La clé de session n’est pas valide
175 (0xAF)	En dehors de la session
176 (0xB0)	Session déjà ouverte
177 (0xB1)	Aucune session ouverte
178 (0xB2)	Aucun paramètre valide n'a été envoyé
180 (0xB4)	Composant sans fil non démarré
190 (0xBE)	Lire et obtenir une valeur incorrecte
191 (0xBF)	Licence non installée

Commande non prise en charge

Ce guide décrit les commandes disponibles pour chaque module IMU doté de la dernière version de micrologiciel. Lorsqu'une commande décrite dans ce guide n'est pas implémentée dans un module IMU équipé d'une version de micrologiciel antérieure, l'état de commande est renvoyé avec le code d'exception 19 (0x13) : commande non prise en charge.

Vous pouvez mettre à jour le micrologiciel des modules IMU à l'aide de EcoStruxure Power Commission.