rbAmp
FR
Boutique
Docs
Mis à jour le

Commandes

Toutes les actions de l'appareil passent par le registre COMMAND (0x0060, u8) — sur Modbus, holding 0x8113 (écriture seule à cet endroit). Une écriture met en file l'opcode ; l'exécution a lieu dans la boucle principale de l'appareil (quelques millisecondes pour la plupart des commandes ; les commandes qui touchent à la flash prennent plus longtemps).

Fin et sémantique du résultat

  • Occupé : CMD_STATE (0x006A) bit 0 = BUSY pendant l'exécution d'une commande. BUSY est le signal de fin — interrogez-le jusqu'à 0 avant de lire le résultat. Une nouvelle commande écrite pendant BUSY est ignorée (bit 1 OVERRUN levé ; la commande en cours n'est pas écrasée ; OVERRUN s'efface quand la commande suivante est acceptée). Sur Modbus, une écriture de COMMAND pendant l'occupation → exception 06.

  • Résultat : ERROR (0x0002 ; relecture Modbus maintien 0x8114) contient le résultat à l'issue (0x00 = OK). ERROR affiche 0xF0 (Modbus 0xFFFF) pendant toute l'exécution et est écrit avec la fin ; jugez la fin par BUSY, puis lisez le résultat dans ERROR.

  • Fraîcheur : CMD_SEQ (0x0067) s'incrémente une fois par commande terminée — interrogez-le pour distinguer un résultat récent d'un résultat périmé.

  • Schéma : vérifiez BUSY = 0 → écrivez les paramètres, puis COMMAND → interrogez BUSY → 0 (délais : ≥1 s pour les commandes simples et les enregistrements, ≥0.5 s pour une écriture de page de mise à jour, ≥3 s pour COMMIT de mise à jour ; sur I²C, tolérez ≥10 ms d'étirement d'horloge et réessayez les lectures NACK — ne renvoyez jamais aveuglément une écriture COMMAND) → lisez ERROR. Pas à pas complet : Séquences D2.

  • Commandes qui redémarrent le module (0x02 RESET, 0x13 ACTIVATE, 0x16 ADDR_BY_UID sur le module concerné) : sur Modbus, la réponse peut être tronquée ou absente (et un délai d'émission configuré peut la supprimer) ; confirmez en interrogeant à nouveau le périphérique après le redémarrage.

Codes d'erreur (ERROR 0x0002)

Code Nom Signification
0x00 OK accepté / terminé
0xF0 PENDING commande toujours en cours d'exécution (avec BUSY = 1)
0xF6 NVM_IO l'écriture persistante a échoué (SAVE_CAL / SAVE_CONFIG / import d'historique)
0xF7 NO_KEY attestation refusée — aucune clé de périphérique provisionnée
0xF8 — opération refusée par la politique de service
0xF9 NVM_RATE_LIMIT réécriture de persistance limitée en fréquence (min ~5 s entre sauvegardes) — réessayez plus tard
0xFA OP_RETRY opération déjà en cours · refusée dans l'état actuel (par ex. mémoire d'énergie en FAULT, valeur d'adoption négative)
0xFB KEY_GATE commande protégée par clé sans clé à usage unique valide (LT_KEY)
0xFC VALUE_CRC incohérence CRC de page de mise à jour (renvoyez la page) · epoch de l'heure inférieur à 1600000000 · incohérence d'UID (ADDR_BY_UID) · aucun enregistrement d'historique de ce type (HIST_READ)
0xFD PARAM paramètre / valeur de configuration invalide — rien n'est enregistré
0xFE UNKNOWN_CMD opcode non pris en charge

Jeu de commandes

Commandes de famille

Op Nom Effet
0x01 SAVE_CAL persiste les registres d'étalonnage (maintenance/usine ; protégé par UNLOCK sur Modbus ; limité en fréquence → 0xF9)
0x02 RESET réinitialisation à chaud (verrouillée par UNLOCK sur Modbus ; attendez-vous à une réponse Modbus absente ou tronquée)
0x03 LATCH_PERIOD à la prochaine frontière de fenêtre, prend un instantané de la banque sélectionnée par LATCH_BANK (0..7 ; ≥ 8 → 0xFD) et relance son accumulation — bit de capacité 8 ; sinon 0xFE
0x04 SAVE_CONFIG sauvegarde de la configuration (lecture-modification-écriture ; étalonnage intact ; non protégé par UNLOCK). Valeurs validées par rapport à la table légale ; illégal → 0xFD, rien n'est sauvegardé ; limité en fréquence → 0xF9 ; une sauvegarde sans changement est une opération sans effet OK (lève quand même CONFIG_CHANGED)
0x06 SET_TIME appliquer l'epoch écrit dans TIME_SET/RTC_EPOCH ; epoch < 1600000000 → 0xFC ; le bit 4 de STATUS passe immédiatement à l'état levé
0x07 ENERGY_RESET code d'opération de famille, soumis à UNLOCK. Non utilisé (0xFE / exception 03) — la remise à zéro du compteur est le LT_RESET à clé ci-dessous
0x0E IDENTIFY faire clignoter les LED pendant 10 s — repérer le module dans une armoire. Non conditionné
0x0F ATTEST signer le défi de 32 o à 0x0B80 (carte des registres) ; ~55 ms ; 0xF7 = pas de clé
0x10 OTA_BEGIN ouvrir une session de mise à jour (Mise à jour du firmware)
0x11 OTA_BLOCK_WR programmer une page de 256 o (limitée à une page / ~250 ms — BUSY jusqu'à son créneau)
0x12 OTA_COMMIT vérifier + armer l'image préparée (sans réinitialisation) ; interroger BUSY ≥ 3 s
0x13 OTA_ACTIVATE réinitialisation dans l'image armée (uniquement lorsque OTA_STATUS = 2 ; ~4 s avant la réapparition)
0x14 FW_ABORT fermer la session de mise à jour / désarmer une image armée
0x15 — réservé (usine/maintenance)
0x16 ADDR_BY_UID le module dont l'UID correspond à ADDR_UID prend la ou les adresses préparées, les persiste avec toutes les autres modifications CFG_ en attente et redémarre ; les autres modules répondent 0xFC. Si les deux champs de nouvelle adresse sont à zéro → 0xFD ; adresse illégale → 0xFD ; limite de fréquence de sauvegarde → 0xF9. Fonctionne en diffusion Modbus. Non protégé

Commandes à clé (compteurs à vie et historique)

Ces commandes modifient l'état qui concerne la mesure ; chacune exige donc la clé à usage unique correspondante, écrite dans LT_KEY (0x0844 / Modbus maintien 0x8142–43, mot de poids fort en premier) immédiatement avant la commande. La clé est consommée par toute commande suivante ; clé incorrecte ou absente → ERROR 0xFB. C'est une protection contre les actions involontaires, en plus du transport (et non l'UNLOCK Modbus).

Op Nom Clé (u32) Effet
0x08 HIST_READ — (non protégé par clé) charger l'enregistrement sélectionné par HIST_PERIOD/HIST_BACK dans HIST_REC ; aucun enregistrement → 0xFC
0x09 HIST_FLUSH — (non protégé par clé) vider l'énergie maintenant : la copie de rétention toujours ; l'enregistrement NVM seulement si ≥ 10 s se sont écoulées depuis sa dernière écriture (aussi implicite lors d'un RESET ou de l'activation d'une mise à jour)
0x0A LT_RESET 0x4C545253 "LTRS" remise à zéro de l'énergie à vie ; compteur de génération ++ (journalisé). Stockage en DÉFAUT → 0xFA
0x0B LT_ADOPT 0x4C544150 « LTAP » adopter les valeurs de compteurs mises en attente (remplacement de carte / migration) ; génération ++ (journalisé). Ordre de préparation : import Wh · export Wh · import réactif varh · export réactif varh (4×i64) ; une valeur négative → 0xFA
0x0C HIST_WRITE 0x48494D50 "HIMP" importe l'enregistrement de 80 o de HIST_REC dans le tampon horaire (HIST_PERIOD doit valoir 1, sinon 0xFC) ; horodatage non plus récent → 0xFD ; E/S NVM → 0xF6
0x0D HIST_CLEAR 0x48434C52 "HCLR" effacement pas à pas du tampon horaire ; répéter pendant l'exécution → 0xFA (journalisé)

Les remises à zéro et adoptions à vie, ainsi que les écritures d'historique, sont enregistrées dans le journal d'événements avec les valeurs avant/après — elles ne peuvent pas survenir en silence.

Récapitulatif des conditions d'accès

Mécanisme Périmètre Comment
Modbus UNLOCK 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15 clé 0xA5C3 → maintien 0x8112 ; fenêtre de 10 s, une commande ; peut partager un FC16 avec le code d'opération (Modbus)
LT_KEY 0x0A–0x0D, les deux transports magie par commande, usage unique
Liste blanche de diffusion Unité Modbus 0 seuls la mise à l'heure, l'instantané, l'adressage par UID (Modbus)

Non protégées sur aucun transport : 0x04, 0x06, 0x08, 0x09, 0x0E, 0x0F, 0x11, 0x16. I²C n'a pas d'étape UNLOCK : l'accès physique au bus I²C de la carte constitue la limite de confiance de l'installation ; les commandes protégées par clé le sont néanmoins sur les deux transports.