Mise à jour du firmware (protocole côté hôte)
Les mises à jour du firmware se font sur le bus en service — I²C ou Modbus RTU — sans programmeur ni dépose (OTA). La version du firmware s'affiche sous la forme major.minor de FW_VER (0x0114), par exemple firmware STD 1.126. L'appareil conserve deux banques de firmware ; l'hôte écrit la nouvelle image dans la banque inactive, l'appareil la vérifie et l'arme, et une activation séparée redémarre dessus. Une nouvelle image défaillante ou bloquée revient automatiquement à la version précédente fonctionnelle.
La mesure continue pendant la mise à jour. La mise à jour cède la place à la mesure (au plus une écriture de page toutes les ~250 ms) ; les quelques trames de mesure perdues à chaque écriture en mémoire flash sont compensées dans les compteurs d'énergie.
Fichiers de version
Une version fournit des images de banque préparées — signées et chiffrées sur la machine de génération. L'hôte de transport transmet le fichier tel quel ; il ne construit, ne modifie ni n'enveloppe jamais une image :
-
Deux fichiers par version, un par banque (A / B). Lisez
FW_ACTIVE_BANK(0x0156) : 0 = A en cours → envoyez le fichier B, et inversement. -
Comparez d'abord l'identifiant de carte de la version avec
BOARD_ID(0x017C) — une image construite pour une autre carte est refusée à la vérification (raison 15). -
Une version strictement inférieure à celle en cours est refusée (anti-retour en arrière, état 4) ; la même version est acceptée. Revenir à une version plus ancienne n'est possible que par le chemin de restauration propre à l'appareil, et non en envoyant une ancienne image.
Registres
I²C (maintien Modbus entre crochets ; u32 = 2 registres, mot de poids fort en premier) :
| Reg. | Adr | Signification |
|---|---|---|
| OTA_STATUS | 0x0140 (0x8300) | 0 inactif · 1 prêt / session ouverte · 2 armé · 3 erreur · 4 retour à une version antérieure refusé |
| OTA_IDX | 0x0144 (0x8302–03, rw) | index de page de 256 o pour l'écriture de la page suivante |
| OTA_ACTIVE | 0x0148 (0x8306–07) | base de la banque en cours (opaque) |
| OTA_BANK_SIZE | 0x014C (0x8304–05) | taille de la banque — indiquée par le périphérique ; index de la page d'en-tête = taille/256 − 1 |
| FW_STAGED_VERSION | 0x0150 (0x8308–09) | version de l'image armée (0 = aucune) |
| FW_ACTIVE_BANK | 0x0156 (0x8301) | 0 = A · 1 = B |
| OTA_PCRC_EXP | 0x0170 (0x8310–11, w) | CRC-32 attendu facultatif de la page suivante |
| OTA_PCRC_RX | 0x0174 (0x8312–13) | CRC-32 de la page telle que reçue |
| OTA_KEYID | 0x0178 (0x8319–1A) | identifiant de clé d'image accepté par ce firmware |
| OTA_DIAG | 0x0180 (0x8314 : raison | état<<8) | diagnostics de défaillance |
| OTA_PAYLOAD | 0x0500, 256 o (0x8380–0x83FF paires d'octets) | tampon de page |
| FW_VER / SWAP_PENDING | 0x0114 / 0x011C (0x8315–16 / 0x8317–18) | version en cours / état de bascule : 0 confirmé · 1 armé · 2 essai |
Commandes (COMMAND 0x0060 / maintien 0x8113) : 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. Sur Modbus, BEGIN/COMMIT/ACTIVATE/FW_ABORT sont soumis à UNLOCK ; BLOCK_WR ne l'est pas. Après chaque commande, interrogez CMD_STATE (0x006A / 0x8116) jusqu'à BUSY = 0, puis lisez OTA_STATUS / ERROR.
Séquence
-
Sélectionnez. Lisez
FW_ACTIVE_BANK→ choisissez le fichier de version pour l'autre banque. VérifiezBOARD_IDpar rapport au fichier ; vérifiez éventuellementOTA_KEYID. -
BEGIN (0x10). Ouvre la session ;
OTA_STATUS= 1 immédiatement. Rien n'est effacé à l'avance — les secteurs flash sont effacés à l'arrivée de leur première page, si bien que le bus et la mesure continuent de fonctionner. Un BEGIN alors qu'une image est armée la désarme d'abord. -
BLOCK_WR (0x11) par page, dans l'ordre croissant. Pour chaque page de 256 B non vide k du fichier :
OTA_IDX= k → 256 B dansOTA_PAYLOAD→ (facultatif)OTA_PCRC_EXP= CRC-32 de la page → commande 0x11 → interroger BUSY jusqu'à 0 (prévoir jusqu'à ~0.5 s). -
Envoyez les pages dans l'ordre croissant ; la page 0 doit être la première page de la session (sinon COMMIT refuse avec la raison 13) ; sautez les pages entièrement à 0xFF. La page d'en-tête (
OTA_BANK_SIZE/256 − 1) n'a pas à être la dernière — l'ordre croissant l'envoie naturellement en dernier. -
Après chaque vérification de page,
OTA_STATUSvaut toujours 1.ERROR0xFC = la charge utile est arrivée altérée → réécrivez la charge utile et répétez la page (un renvoi identique d'une page déjà écrite est accepté).OTA_STATUS3 = la session a échoué (lisezOTA_DIAG; des données différentes pour une page déjà écrite en sont une cause) — les écritures de pages ultérieures sont ignorées ; recommencez par BEGIN. -
Limitation : le module programme au plus une page par ~250 ms (la commande reste simplement BUSY jusqu'à son créneau) — la mesure est prioritaire. Une image complète prend ~1–3 minutes.
-
Sur I²C, attendez un étirement d'horloge pouvant aller jusqu'à ~9 ms et tolérez les NACK pendant la fenêtre d'écriture (Transport I²C). Modbus n'est pas affecté.
-
COMMIT (0x12). Interrogez BUSY avec un délai d'au moins ≥ 3 s : le module efface les secteurs qu'aucune page n'a touchés, puis vérifie l'image — intégrité, authenticité, version, identifiant de carte. Résultat :
-
OTA_STATUS2 — vérifié et armé ;FW_STAGED_VERSION= nouvelle version. Le module exécute encore l'ancienne image. Une coupure d'alimentation après COMMIT démarre l'image armée (sans danger — c'est l'image prévue). -
3 — refusé ;
OTA_DIAGindique pourquoi (ci-dessous). - 4 — version plus ancienne que celle en cours ; rien n'a changé.
- ACTIVATE (0x13) lorsque l'installation est prête pour un redémarrage — vérifiez d'abord
OTA_STATUS= 2 (non armé → la commande ne fait rien,ERRORreste à 0). L'énergie est vidée, le module se réinitialise et réapparaît en ~4 s (sur Modbus, la réponse à ACTIVATE peut être absente ou tronquée). La nouvelle image démarre en essai sous un chien de garde matériel et se confirme seule après ~8 s de mesure saine. Toute réinitialisation avant cette confirmation provoque un retour arrière — ne réinitialisez pas le module pendant ~10 s après l'activation. Vérifiez ensuite :FW_ACTIVE_BANKa basculé,FW_VER= nouvelle version,SWAP_PENDING2 → 0 ; si l'ancienneFW_VERtourne encore, il y a eu retour arrière. FW_ABORT (0x14) au lieu d'ACTIVATE abandonne l'image armée et ferme la session.
Diagnostics de défaillance (OTA_DIAG 0x0180)
Octet 0 = raison · octet 1 = état interne · puis décalage, page/longueur et valeurs de contrôle.
| Raison | Signification | Raison | Signification |
|---|---|---|---|
| 1 | index de page hors plage | 9 | échec du contrôle d'intégrité de l'image |
| 2/3 | échec d'effacement / échec de vérification de l'effacement | 10 | échec de l'authentification |
| 4 | données différentes pour une page déjà écrite (session échouée — recommencer depuis BEGIN) | 11 | retour à une version antérieure |
| 5/6 | échec du programme / échec de la vérification | 12 | erreur d'enregistrement d'échange |
| 7 | en-tête d'image incorrect | 13 | image non scellée / incomplète (par ex. page 0 ou page d'en-tête jamais reçue) |
| 8 | la page d'en-tête n'est jamais arrivée | 14 | signature invalide |
| 15 | image construite pour une autre carte (valeur de contrôle = le mot de carte de l'image) |
Tous les échecs d'authentification sont signalés par OTA_STATUS 3 avec la raison indiquée ici — il n'existe pas de valeurs d'état distinctes à gérer. Sur Modbus, seuls la raison et l'état interne sont reproduits (maintien 0x8314) ; le détail décalage/page/contrôle de OTA_DIAG est lisible par I²C.
Propriétés de sécurité (sur lesquelles l'hôte peut compter)
- En deux temps : COMMIT ne redémarre jamais ; le moment du redémarrage appartient à l'hôte (fenêtre de maintenance).
-
Une coupure à n'importe quel instant est sans danger : avant COMMIT, l'ancienne image tourne ; après COMMIT, l'image armée est celle voulue ; un essai échoué revient à la version précédente.
-
L'étalonnage, la configuration, les compteurs d'énergie, l'historique, le journal d'événements et l'identité du périphérique sont stockés hors des banques du micrologiciel — une mise à jour ne les touche jamais.
-
Une validation de micrologiciel est journalisée avec la transition de version.