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).ERRORaffiche 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.