rbAmp
FR
Boutique
Docs
Mis à jour le

Transport Modbus RTU

Sur le réglage Modbus du commutateur de mode d'interface, le module est un esclave Modbus RTU sur ses lignes UART (un émetteur-récepteur externe les adapte au RS-485). La couche Modbus est une traduction vers le même fichier de registres que I²C : mêmes grandeurs, mêmes commandes, une seule file de commandes ; seul le format sur le fil diffère.

Série

  • Trame : RTU standard [adresse][fonction][données][CRC16], CRC16 polynôme 0xA001 (réfléchi), bit de poids faible en premier. Une trame au CRC incorrect ne reçoit aucune réponse (comportement RTU standard).

  • Identifiant d'unité : 1..247, par défaut 1 (CFG_MODBUS_ADDR). 0 = diffusion (écritures en liste blanche uniquement, voir ci-dessous). Les identifiants 248..255 sont rejetés à la configuration.

  • Bauds : par défaut 9600. Codes dans CFG_MB_BAUD : 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1000000. Le module accepte les codes 0–10 ; la vitesse de ligne sur RS-485 est fixée par l'émetteur-récepteur externe. Si le code sauvegardé est un jour invalide, le module démarre à 9600.

  • Format de trame : CFG_MB_FRAME 0=8N1 · 1=8E1 · 2=8O1 · 3=8N2.

  • Retenue de réponse : CFG_TX_DELAY 0..100 ms — pour les adaptateurs RS-485 à direction automatique qui ont besoin de temps pour libérer la ligne.

  • Les paramètres série sont validés à l'écriture (exception 03). Une écriture ne fait que placer la valeur en RAM — pour la rendre effective : enregistrer (COMMAND 0x04), puis redémarrer (COMMAND 0x02, soumis à UNLOCK) ; le module démarre avec les valeurs enregistrées. Pas à pas : Séquences D4.

  • Latence de réponse : la plage demandée est copiée atomiquement depuis l'image publiée, si bien qu'une lecture même de 125 registres est cohérente en interne ; l'appareil répond en < 20 ms à toute vitesse en bauds (adapté à l'interrogation d'onduleur à 3–5 Hz).

  • Réponses aux commandes qui provoquent un redémarrage (RESET, ACTIVATE d'un micrologiciel, changement d'adresse par UID) peuvent être tronquées ou absentes — le périphérique peut redémarrer avant la fin de la réponse, et un délai d'émission configuré peut la supprimer entièrement. Confirmez en interrogeant à nouveau après le redémarrage, et non d'après la réponse.

Codes de fonction

FC03 lecture maintien · FC04 lecture entrée · FC06 écriture unique · FC16 écriture multiple. Tout autre code de fonction → exception 01.

Limites : FC03/FC04 quantité 1..125, FC16 1..123 — hors limites → exception 03. FC16 est tout ou rien : la trame entière est d'abord validée ; un registre incorrect → rien n'est appliqué. COMMAND (maintien 0x8113) est en écriture seule — le lire → exception 02.

Espaces de registres

Les adresses Modbus forment leur propre espace — indépendant des adresses I²C. Disposition :

Espace Plage Contenu
Entrée 0x0000–0x03FF Profil float32 (13 points en direct, ci-dessous)
Entrée 0x6000–0x6FFF profil natif à échelle entière (découverte, canaux, énergie, totaux)
Maintien 0x8000–0x83FF configuration native · heure/commandes · mise à jour du micrologiciel
Maintien 0x8400–0x847F fenêtre de sécurité (certificat de périphérique / attestation ; flux d'octets)
Maintien 0xA000–0xAFFF miroir en lecture seule de l'entrée native (= adresse d'entrée + 0x4000) pour les maîtres FC03 seuls
— tout le reste non cartographié → exception 02

Les adresses natives et holding de chaque bloc figurent avec la carte I²C dans la carte des registres.

Profil natif (entrée 0x6000+)

Entiers à échelle fixe, mêmes unités qu'en I²C. Ordre des mots ABCD (mot de poids fort en premier) par défaut ; CFG_WORD_ORDER = 1 inverse vers le mot de poids faible en premier pour tous les nombres multi-registres du profil natif d'entrée (i64 = les quatre mots inversés), et les valeurs sentinelles des canaux absents s'inversent de la même façon. Les fenêtres de maintien (0x81xx/0x83xx) sont toujours en mot de poids fort en premier, quelle que soit la valeur de CFG_WORD_ORDER. i32 = 2 registres, i64 = 4 registres. Les totaux P/Q/S sont publiés en i64 sur Modbus (étendus au signe depuis les valeurs du périphérique).

Profil float32 (entrée 0x0000)

Modbus RTU avec un profil de registres float32 de 13 valeurs. Les adresses de registres et l'ordre ABCD des mots suivent la carte de registres SDM publiquement documentée. Nous n'avons pas testé le module avec un appareil SDM, un logiciel SDM tiers, un onduleur, un automate ou un système SCADA.

IEEE-754 float32, toujours ABCD, unités physiques (V/A/W/kWh), export en grandeur positive. Points en direct (13) :

Adr. d'entrée Point
0x0000 / 0x0002 / 0x0004 tension L1 / L2 / L3, V
0x0006 / 0x0008 / 0x000A courant L1 / L2 / L3, A
0x000C / 0x000E / 0x0010 puissance active L1 / L2 / L3, W
0x0034 puissance active totale, W
0x0046 fréquence, Hz
0x0048 / 0x004A énergie importée / exportée, kWh

Toute autre adresse de 0x0000–0x03FF affiche 0 ; un onduleur ou un SCADA qui a besoin de registres hors de la liste ci-dessus ne les obtient pas par ce profil. Les phases que le module n'a pas affichent 0.0 (STD-UI1 publie son canal comme L1 ; ses adresses L1 portent la tension, le courant, la puissance, la fréquence, l'énergie importée et exportée). Les points S, Q, PF et énergie totale affichent 0. Les membres monophasés publient leur canal comme L1. Ce profil n'a pas d'alias de configuration — la configuration se fait par les registres de maintien natifs.

Identifiants d'unité virtuels

Avec CFG_VIRTUAL_IDS = 1 (sauvegardé + redémarrage ; effectif au démarrage), un module avec plus d'un canal de courant répond aussi sur les identifiants d'unité base+1 … base+N_CURRENT (plafonnés à 247) : chaque identifiant est une vue float32 en lecture seule d'un seul canal de courant — sa tension, son courant, sa puissance, sa puissance totale = la puissance de ce canal, sa fréquence ; les points d'énergie valent 0. Toute écriture vers un identifiant virtuel → exception 02. Choisissez l'identifiant de base pour que les identifiants dérivés n'entrent pas en collision avec d'autres compteurs du bus.

(La table de configuration METER_GROUP de la carte est réservée — la composition des groupes n'est pas configurable.)

Diffusion (identifiant d'unité 0)

Seules ces écritures sont acceptées en diffusion ; tout le reste est silencieusement refusé (pas de réponse d'exception en diffusion, selon la norme Modbus) :

  • réglage de l'heure — deux trames : FC16 vers 0x8100–0x8101 (epoch, mot de poids fort en premier), puis FC06 COMMAND 0x8113 = 0x0006 — synchronisation d'horloge à l'échelle du bus ;

  • LATCH_BANK / PERIOD_ARM 0x8110–11 et COMMAND 0x03 — instantané synchronisé entre modules (bit 8 de capacité) ;

  • préparation d'adresse par UID 0x8118–0x811E + COMMAND 0x16 — mise en service sur un bus partagé.

Une FC16 en diffusion doit rester dans les registres de la liste blanche — une trame qui touche à autre chose est refusée en totalité.

UNLOCK (commandes protégées)

Les commandes qui modifient l'état du périphérique doivent être précédées de l'écriture de la clé de déverrouillage 0xA5C3 dans le maintien 0x8112 :

  • La clé est valide pendant 10 s et est consommée par une commande protégée.
  • Écrire une mauvaise valeur annule un déverrouillage actif.
  • Une commande conditionnée sans déverrouillage valide → exception 03.
  • La lecture de 0x8112 renvoie l'indicateur de déverrouillage (0/1) tel que défini en dernier — à considérer comme purement informatif.
  • Déverrouillage et commande peuvent aller dans une seule trame FC16 sur 0x8112–0x8113 (clé d'abord, opcode ensuite).

Ensemble protégé : 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (là où implémenté) · 0x10/0x12/0x13/0x14 (mise à jour du firmware) · 0x15 (maintenance). Non protégées : 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 écriture de page · 0x16 adresse par UID. Sur les modules qui n'implémentent pas un opcode, le refus est l'exception 03 avant même que la condition ne soit vérifiée. Les commandes d'énergie à vie utilisent un mécanisme de clé différent, à usage unique (LT_KEY), et non UNLOCK — voir Commandes.

Règles de comportement (contrat de famille)

  • Valeurs de COMMAND, LATCH_BANK, PERIOD_ARM > 0xFF → exception 03 (pas de troncature silencieuse de l'octet de poids faible).

  • Une écriture de COMMAND pendant qu'une commande s'exécute encore → exception 06 (périphérique occupé).

  • Fenêtres d'octets appariés (sécurité 0x8400+, charge utile du micrologiciel 0x8380+, enregistrement d'historique 0x8180+) : le registre k porte les octets 2k (poids fort) et 2k+1 (poids faible). Les écritures qui touchent des octets en lecture seule → exception

  • La fenêtre de sécurité est un flux d'octets petit-boutiste — les champs numériques qu'elle contient se décodent en petit-boutiste à partir des octets, et non comme des registres gros-boutistes.

  • Un seul tableau de valeurs de configuration légales sert aux deux transports : une valeur illégale sur Modbus → exception 03 ; la même valeur sur I²C est refusée à SAVE_CONFIG avec ERROR 0xFD — dans les deux cas, rien n'est persisté.

  • Les champs que la version ne propose pas (canaux absents ; grandeurs THD et de déplacement avec le bit 2 de CAPABILITIES à 0) renvoient la valeur sentinelle du profil natif (0xFFFF / 0x8000…) ; dans le profil float32, ils valent 0.

Exceptions

Code Signification
01 fonction illégale (autre que FC03/04/06/16)
02 adresse hors de la carte · écriture vers un registre d'entrée, un holding en lecture seule ou un identifiant d'unité virtuel · lecture d'un registre en écriture seule
03 valeur illégale (identifiant d'unité / code de débit / valeur de configuration incorrects · code d'opération de commande invalide · valeur COMMAND/LATCH hors limites · quantité hors plage · commande conditionnée sans déverrouillage)
04 défaillance interne de l'appareil
06 périphérique occupé (commande ou opération micrologicielle en cours)

La dernière exception est conservée pour le diagnostic dans LAST_EXCEPTION (FC<<24 | code<<16 | address), lisible sur les deux transports : I²C 0x0158, Modbus maintien 0x830A–0B.