sphings-dev.de

Marstek Firmware Archiv: Damit ein Downgrade möglich bleibt

Ein Firmware-Update beim Marstek-Speicher macht Probleme, und der Weg zurück ist weg: Marstek bietet nur die aktuelle Version an, und ihr Download-Link verschwindet, sobald das Update auf dem Gerät ausgelöst wird. Das Marstek Firmware Archiv hebt die Originaldateien auf.

Gedanke dahinter

  • Downgrades: Ohne gesicherte Dateien gibt es nach einem verunglückten Update nichts, auf das man zurückgehen könnte.
  • Sichern vor dem Update: Der Download funktioniert nur, solange das Update noch nicht angestoßen wurde.
  • Nachvollziehbarkeit: Die Release Notes erscheinen bei Marstek auf Chinesisch. Im Archiv stehen Übersetzungen auf Englisch und Deutsch neben der jeweiligen Version.

Die Dateien sind die unveränderten Originale von den Update-Servern von Marstek. Trotzdem gilt: Flashen auf eigenes Risiko. Vorher sollten Gerätecode und Modul (Control, BMS, Micro, MPPT, FC41D) zur eigenen Hardware passen.

Aufbau

Jede Version bekommt einen eigenen Ordner mit der Firmware-Datei (.bin, beim WLAN-Modul .rbl) und einer metadata.json. Bei den üblichen Geräten ist es firmwares/<Gerät>/<Typ>/<Version>/. Die Geräte mit nur einer Firmware-Art (Smart Meter und Saturn/B2500) liegen flach unter firmwares/<Gerät>/<Version>/. Die Metadaten enthalten die Download-URL, SHA-256, die Dateigröße, die Release Notes samt Übersetzung und den Verweis auf das Issue, über das die Version eingereicht wurde.

Die Gerätecodes entsprechen denen in der Marstek-App: VNSD-0 für die Venus D, VNSA-0 für die Venus A, VNSE3-0 für die Venus E 3.0, HMG-50 für die Venus E Gen 1/2, HMJ-2 für Saturn/B2500 v2 sowie HME-3 und HME-4 für die Smart Meter CT002 und P1.

Beispiel und Changelogs

Ein konkreter Pfad sieht so aus; der Dateiname trägt Version, Typ und Gerätecode, danach den Originalnamen von Marstek:

firmwares/VNSD-0/Control/150/150_control_VNSD-0_app_0150_0805_115146.bin
firmwares/VNSD-0/Control/150/metadata.json

Zu jedem Gerät und jedem Modul gibt es einen eigenen CHANGELOG.md unter firmwares/<Gerät>/…, dazu einen globalen im Wurzelverzeichnis. Die deutschen Fassungen liegen daneben als CHANGELOG.de.md. Wer vor einem Downgrade wissen will, was sich zwischen zwei Versionen geändert hat, liest dort nach statt in chinesischen Release Notes.

Mitmachen

Tags

Zum Projekt

Unterstützen

Diese Tools entstehen in meiner Freizeit und bleiben kostenlos, offen und cloud-frei. Wenn dir eins davon einen Nachmittag gespart hat, freue ich mich über einen Kaffee oder ein Stück Pizza.

Kaffee oder Pizza

Weitere Beiträge