rbAmp
DE
Shop
Docs
Aktualisiert

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

  1. Auswählen. FW_ACTIVE_BANK auslesen → wählen Sie die Release-Datei für die andere Bank. Prüfen Sie BOARD_ID gegen die Datei; optional OTA_KEYID prüfen.

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

  3. BLOCK_WR (0x11) je Seite, aufsteigend. Für jede nicht leere 256-B-Seite k der Datei: OTA_IDX = k → 256 B in OTA_PAYLOAD → (optional) OTA_PCRC_EXP = CRC-32 der Seite → Befehl 0x11 → BUSY auf 0 abfragen (bis ca. 0.5 s warten).

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

  5. Nach jeder Seitenprüfung ist OTA_STATUS noch 1. ERROR 0xFC = Nutzlast beschädigt angekommen → Nutzlast neu schreiben und die Seite wiederholen (ein identisches erneutes Senden einer bereits geschriebenen Seite wird akzeptiert). OTA_STATUS 3 = die Sitzung ist fehlgeschlagen (OTA_DIAG lesen; abweichende Daten für eine bereits geschriebene Seite sind eine Ursache) — spätere Seitenschreibvorgänge werden ignoriert; mit BEGIN neu beginnen.

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

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

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

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

  10. 3 — abgelehnt; OTA_DIAG nennt den Grund (unten).

  11. 4 — Version älter als die laufende; nichts geändert.
  12. ACTIVATE (0x13), wenn die Installation für einen Neustart bereit ist — zuerst OTA_STATUS = 2 prüfen (nicht scharfgeschaltet → der Befehl tut nichts, ERROR bleibt 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_BANK hat gewechselt, FW_VER = neue Version, SWAP_PENDING 2 → 0; läuft noch die alte FW_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.