Das Marstek Firmware Archiv sammelt unveränderte OTA-Firmware von den Update-Servern von Marstek: für Venus E, Venus D, Venus A, Saturn/B2500 sowie die Smart Meter CT002 und P1. Zu jeder Version gehören Release Notes auf Englisch und Deutsch, SHA-256-Prüfsumme, Dateigröße und ein Changelog je Gerät.
Wozu ein Archiv
- Downgrades überhaupt möglich machen: Marstek liefert nur die jeweils aktuelle Version aus. Macht ein Update Probleme, gibt es ohne Archiv keinen Weg zurück.
- Vor dem Update sichern: Der Download-Link verschwindet, sobald das Update auf dem Gerät ausgelöst wird.
- Sehen, was sich geändert hat: Marstek schreibt Release Notes auf Chinesisch; hier stehen sie übersetzt und versioniert nebeneinander.
Inhalt
Im Archiv liegen derzeit 50 Firmware-Dateien (Stand: 29.09.2026) für sieben Gerätecodes: HME-3 und HME-4 (Smart Meter), HMG-50 (Venus E Gen 1/2), HMJ-2 (Saturn/B2500 v2), VNSA-0 (Venus A), VNSD-0 (Venus D) und VNSE3-0 (Venus E 3.0). Die Dateien sind je Gerät und Modul – Control, BMS, Micro, MPPT oder das WLAN-Modul FC41D – unter firmwares/<Gerät>/<Typ>/<Version>/ abgelegt, zusammen mit einer metadata.json (Download-URL, SHA-256, Größe, Release Notes samt Übersetzungen, Issue-Verweis).
Aufbau und Changelogs
Standardgeräte (VNSD-0, VNSE3-0, VNSA-0, HMG-50) liegen unter firmwares/<Gerät>/<Typ>/<Version>/, Geräte mit nur einer Firmware-Art (HME-3, HME-4, HMJ-2) unter firmwares/<Gerät>/<Version>/. Das WLAN-Modul FC41D steckt als Firmware-Typ im jeweiligen Gerät, die Datei ist eine .rbl. Changelogs gibt es global, je Gerät und je Modul, jeweils auf Englisch und Deutsch. Die README (ebenfalls zweisprachig) listet alle Versionen mit Größe, Datum, Download und Änderungen.
Wie neue Firmware hineinkommt
Über den Firmware-Checker holt man die angebotene Firmware und reicht sie ein. Daraus entsteht ein Issue mit dem Label firmware-submission, und eine GitHub Action prüft die Datei, sortiert sie ein und erzeugt Changelogs und README neu. Ein täglicher Lauf gleicht das Archiv mit rweijnen/marstek-firmware-archive ab und schlägt fehlende Versionen als Pull Request vor; diese Einträge sind in der README mit „↗ ref“ markiert. Firmware lässt sich nur sichern, solange das Update auf dem Gerät noch nicht ausgelöst wurde.
Flashen geschieht auf eigenes Risiko: Eine fehlgeschlagene Aktualisierung kann ein Gerät unbrauchbar machen. Vorher müssen Gerätecode und Modul zur Hardware passen. Marstek BLE Control und die BLE Bridge können Images aus dem Archiv direkt auswählen.