Firmware-Update (Host-seitiges Protokoll)
Firmware-Updates laufen über den laufenden Bus — I²C oder Modbus RTU — ohne Programmiergerät und ohne Ausbau (OTA). Die Firmware-Version wird als major.minor von FW_VER (0x0114) angezeigt, zum Beispiel STD-Firmware 1.126. Das Gerät hat zwei Firmware-Bänke; der Host schreibt das neue Image in die inaktive Bank, das Gerät prüft es und schaltet es scharf, und eine separate Aktivierung startet in es neu. Ein fehlerhaftes oder abstürzendes neues Image rollt sich automatisch auf das vorherige funktionierende zurück.
Die Messung läuft während des Updates weiter. Das Update gibt der Messung Vorrang (höchstens ein Seitenschreibvorgang pro ca. 250 ms); die wenigen Messrahmen, die bei jedem Flash-Schreibvorgang verloren gehen, werden in den Energiezählern lückenkompensiert.
Release-Dateien
Eine Freigabe liefert vorbereitete Bank-Images — auf dem Build-Host signiert und verschlüsselt. Der Transport-Host streamt die Datei unverändert; er erstellt, bearbeitet oder verpackt ein Image nie neu:
-
Zwei Dateien je Freigabe, eine je Bank (A / B).
FW_ACTIVE_BANK(0x0156) lesen: 0 = A läuft → die Datei B senden, und umgekehrt. -
Vergleichen Sie zuerst die Platinen-ID der Freigabe mit
BOARD_ID(0x017C) — ein für eine andere Platine erstelltes Image wird bei der Prüfung abgelehnt (Grund 15). -
Eine strikt niedrigere Version als die laufende wird abgelehnt (Schutz gegen Downgrade, Status 4); dieselbe Version wird angenommen. Eine Rückkehr zu einer älteren Version ist nur über den eigenen Rollback-Pfad des Geräts möglich, nicht durch Einspielen eines alten Images.
Register
I²C (Halteregister in Klammern; u32 = 2 Register, oberes Wort zuerst):
| Reg | Adr | Bedeutung |
|---|---|---|
| OTA_STATUS | 0x0140 (0x8300) | 0 Leerlauf · 1 bereit / Sitzung offen · 2 scharfgeschaltet · 3 Fehler · 4 Downgrade abgelehnt |
| OTA_IDX | 0x0144 (0x8302–03, rw) | 256-B-Seitenindex für den nächsten Seitenschreibvorgang |
| OTA_ACTIVE | 0x0148 (0x8306–07) | Basis der laufenden Bank (undurchsichtig) |
| OTA_BANK_SIZE | 0x014C (0x8304–05) | Banggröße — vom Gerät gemeldet; Kopfseitenindex = Größe/256 − 1 |
| FW_STAGED_VERSION | 0x0150 (0x8308–09) | Version des scharfgeschalteten Images (0 = keines) |
| FW_ACTIVE_BANK | 0x0156 (0x8301) | 0 = A · 1 = B |
| OTA_PCRC_EXP | 0x0170 (0x8310–11, w) | optional erwartete CRC-32 der nächsten Seite |
| OTA_PCRC_RX | 0x0174 (0x8312–13) | CRC-32 der Seite, wie empfangen |
| OTA_KEYID | 0x0178 (0x8319–1A) | Image-Schlüssel-ID, die diese Firmware akzeptiert |
| OTA_DIAG | 0x0180 (0x8314: Grund | Status<<8) | Fehlerdiagnose |
| OTA_PAYLOAD | 0x0500, 256 B (0x8380–0x83FF Bytepaare) | Seitenpuffer |
| FW_VER / SWAP_PENDING | 0x0114 / 0x011C (0x8315–16 / 0x8317–18) | laufende Version / Umschaltzustand 0 bestätigt · 1 scharfgeschaltet · 2 Probelauf |
Befehle (COMMAND 0x0060 / Halteregister 0x8113): 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. Über Modbus sind BEGIN/COMMIT/ACTIVATE/FW_ABORT UNLOCK-gesperrt; BLOCK_WR nicht. Nach jedem Befehl CMD_STATE (0x006A / 0x8116) abfragen, bis BUSY = 0, dann OTA_STATUS / ERROR lesen.
Ablauf
-
Auswählen.
FW_ACTIVE_BANKauslesen → wählen Sie die Release-Datei für die andere Bank. Prüfen SieBOARD_IDgegen die Datei; optionalOTA_KEYIDprüfen. -
BEGIN (0x10). Eröffnet die Sitzung;
OTA_STATUS= 1 sofort. Vorab wird nichts gelöscht — Flash-Sektoren werden beim Eintreffen ihrer ersten Seite gelöscht, damit Bus und Messung weiterlaufen. Ein BEGIN bei einem scharfgeschalteten Image entschärft es zuerst. -
BLOCK_WR (0x11) je Seite, aufsteigend. Für jede nicht leere 256-B-Seite k der Datei:
OTA_IDX= k → 256 B inOTA_PAYLOAD→ (optional)OTA_PCRC_EXP= CRC-32 der Seite → Befehl 0x11 → BUSY auf 0 abfragen (bis ca. 0.5 s warten). -
Seiten in aufsteigender Reihenfolge senden; Seite 0 muss die erste Seite der Sitzung sein (sonst lehnt COMMIT mit Grund 13 ab); Seiten überspringen, die vollständig aus 0xFF bestehen. Die Kopfseite (
OTA_BANK_SIZE/256 − 1) muss nicht die letzte sein — die aufsteigende Reihenfolge sendet sie ohnehin zuletzt. -
Nach jeder Seitenprüfung ist
OTA_STATUSnoch 1.ERROR0xFC = Nutzlast beschädigt angekommen → Nutzlast neu schreiben und die Seite wiederholen (ein identisches erneutes Senden einer bereits geschriebenen Seite wird akzeptiert).OTA_STATUS3 = die Sitzung ist fehlgeschlagen (OTA_DIAGlesen; abweichende Daten für eine bereits geschriebene Seite sind eine Ursache) — spätere Seitenschreibvorgänge werden ignoriert; mit BEGIN neu beginnen. -
Drosselung: Das Gerät programmiert höchstens eine Seite je ca. 250 ms (der Befehl bleibt einfach BUSY, bis sein Platz frei ist) — die Messung hat Vorrang. Ein vollständiges Image dauert ca. 1–3 Minuten.
-
Bei I²C mit Clock-Stretching bis ca. 9 ms rechnen und NACKs während des Schreibfensters tolerieren (I²C-Übertragungsweg). Modbus ist nicht betroffen.
-
COMMIT (0x12). BUSY mit einem Timeout von ≥ 3 s abfragen: das Gerät löscht alle Sektoren, die keine Seite berührt hat, und prüft dann das Image — Integrität, Echtheit, Version, Platinen-ID. Ergebnis:
-
OTA_STATUS2 — geprüft und scharfgeschaltet;FW_STAGED_VERSION= neue Version. Das Modul läuft noch mit dem alten Image. Ein Stromausfall nach COMMIT startet das scharfgeschaltete Image (sicher — es ist das vorgesehene). -
3 — abgelehnt;
OTA_DIAGnennt den Grund (unten). - 4 — Version älter als die laufende; nichts geändert.
- ACTIVATE (0x13), wenn die Installation für einen Neustart bereit ist — zuerst
OTA_STATUS= 2 prüfen (nicht scharfgeschaltet → der Befehl tut nichts,ERRORbleibt 0). Die Energie wird geschrieben, das Modul setzt zurück und erscheint nach ~4 s wieder (über Modbus kann die Antwort auf ACTIVATE fehlen oder abgeschnitten sein). Das neue Image startet als Testlauf unter einem Hardware-Watchdog und bestätigt sich selbst nach ~8 s fehlerfreier Messung. Jeder Reset vor der Bestätigung führt zum Zurückrollen — das Modul nach der Aktivierung etwa 10 s nicht zurücksetzen. Danach prüfen:FW_ACTIVE_BANKhat gewechselt,FW_VER= neue Version,SWAP_PENDING2 → 0; läuft noch die alteFW_VER, wurde zurückgerollt. FW_ABORT (0x14) statt ACTIVATE verwirft das scharfgeschaltete Image und schließt die Sitzung.
Fehlerdiagnose: OTA_DIAG 0x0180
Byte 0 = Grund · Byte 1 = interner Status · danach Offset, Seite/Länge und Prüfwerte.
| Grund | Bedeutung | Grund | Bedeutung |
|---|---|---|---|
| 1 | Seitenindex außerhalb des Bereichs | 9 | Prüfung der Bildintegrität fehlgeschlagen |
| 2/3 | Löschen fehlgeschlagen / Löschprüfung fehlgeschlagen | 10 | Authentifizierung fehlgeschlagen |
| 4 | andere Daten für eine bereits geschriebene Seite (Sitzung fehlgeschlagen — von BEGIN neu starten) | 11 | Versions-Downgrade |
| 5/6 | Programmierung fehlgeschlagen / Prüfung fehlgeschlagen | 12 | Fehler im Tauschdatensatz |
| 7 | ungültiger Image-Header | 13 | Image nicht versiegelt / unvollständig (z. B. Seite 0 oder die Kopfseite kam nie an) |
| 8 | Kopfseite kam nie an | 14 | Signatur ungültig |
| 15 | Image für eine andere Platine erstellt (Prüfwert = das Platinenwort des Images) |
Alle Authentifizierungsfehler werden als OTA_STATUS 3 mit dem Grund hier gemeldet — es gibt keine eigenen Statuswerte, die behandelt werden müssen. Über Modbus werden nur Grund und interner Status gespiegelt (Halteregister 0x8314); die Offset-, Seiten- und Prüfangaben von OTA_DIAG sind über I²C lesbar.
Sicherheitseigenschaften (worauf der Host sich verlassen darf)
- Zweiphasig: COMMIT startet nie neu; den Neustartzeitpunkt bestimmt der Host (Wartungsfenster).
-
Ein Stromausfall an jedem Punkt ist sicher: Vor COMMIT läuft das alte Image; nach COMMIT ist das scharfgeschaltete Image das beabsichtigte; ein fehlgeschlagener Probelauf wird zurückgerollt.
-
Kalibrierung, Konfiguration, Energiezähler, Verlauf, das Ereignisprotokoll und die Geräteidentität werden außerhalb der Firmware-Bänke gespeichert — ein Update berührt sie nie.
-
Ein Firmware-Commit wird mit dem Versionsübergang im Ereignisprotokoll festgehalten.