rbAmp
FR
Boutique
Docs
Mis à jour le

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

  1. Sélectionnez. Lisez FW_ACTIVE_BANK → choisissez le fichier de version pour l'autre banque. Vérifiez BOARD_ID par rapport au fichier ; vérifiez éventuellement OTA_KEYID.

  2. 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.

  3. 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 dans OTA_PAYLOAD → (facultatif) OTA_PCRC_EXP = CRC-32 de la page → commande 0x11 → interroger BUSY jusqu'à 0 (prévoir jusqu'à ~0.5 s).

  4. 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.

  5. Après chaque vérification de page, OTA_STATUS vaut toujours 1. ERROR 0xFC = 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_STATUS 3 = la session a échoué (lisez OTA_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.

  6. 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.

  7. 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é.

  8. 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 :

  9. OTA_STATUS 2 — 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).

  10. 3 — refusé ; OTA_DIAG indique pourquoi (ci-dessous).

  11. 4 — version plus ancienne que celle en cours ; rien n'a changé.
  12. 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, ERROR reste à 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_BANK a basculé, FW_VER = nouvelle version, SWAP_PENDING 2 → 0 ; si l'ancienne FW_VER tourne 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.