sphings-dev.de

Energie & Speicher

Marstek Firmware Downloader

Web-Tool

Fork des Firmware-Checkers von Remko Weijnen: zeigt die für ein Marstek-Gerät angebotenen OTA-Firmware-Updates, lädt die Dateien vor der Installation herunter und spendet sie an ein Community-Archiv.

Website / Tool (öffnet in neuem Tab)Repository (öffnet in neuem Tab)

Steckbrief

Sprache
JavaScript
Lizenz
MIT
Aktuelle Version
2.0.0
Projektstart

Marstek stellt nur die jeweils aktuelle Firmware bereit, und der Download-Link verschwindet, sobald das Update auf dem Gerät ausgelöst wurde. Der Marstek Firmware Downloader (Repository marstek-fw-checker) fragt mit dem Marstek-Konto ab, welche OTA-Updates für die eigenen Geräte angeboten werden, und lädt die Firmware herunter, solange sie noch verfügbar ist. Die Dateien lassen sich außerdem für das Firmware-Archiv spenden.

Das Projekt ist ein Fork des ursprünglichen Werkzeugs von Remko Weijnen (rweijnen/marstek-fw-checker). Version 2.0.0 ist eine vollständige Neuentwicklung mit React, TypeScript, Vite und MUI; die frühere Vanilla-JS-Fassung bleibt als Tag v1-vanilla beziehungsweise Branch legacy-vanilla erhalten.

Funktionen

  • Anmeldung mit den Zugangsdaten der Marstek-App; sie werden nur für die Abfrage verwendet und nicht gespeichert.
  • Geräteübersicht mit Produktbild und Update-Hinweis je Gerät („Aktuell“ oder „Update: Control 150 …“), im Hintergrund geprüft.
  • Firmware je Modul: Control (EMS), BMS, MPPT, Inverter (Micro) und CT, jeweils mit Version, Release Notes und Download.
  • Das WLAN-Kommunikationsmodul FC41D (.rbl): Download und Spende.
  • Download und Spende in einem Klick, dazu ein eigener Knopf „Nur spenden“.
  • Übersetzung chinesischer Release Notes ins Englische auf Abruf, Hell-/Dunkelmodus, durchgehend responsiv.
  • Werkzeuge für Fortgeschrittene: rohe API-Antworten, ein editierbarer API-Tester, schreibgeschützte erweiterte Geräteeinstellungen und ein Knopf „Submit RAW data“, der einen Diagnose-Dump in ein privates Repository schickt.

Unterstützte Geräte

Entwickelt und getestet wird vor allem mit der Venus D (VNSD-0). Weitere Modelle nutzen dieselbe Cloud-API und laufen nach bestem Wissen: Venus A (VNSA-0), Venus E 3.0 (VNSE3-0), Venus E V1/V2 (HMG-50), Venus C (HMG-25), B2500-D (HMJ-2), die Zähler/CT-Typen HME-3 und HME-4 sowie das FC41D-Modul.

Datenschutz und Betrieb

Gerätekennungen (ID, Seriennummer, MAC) und der Gerätename werden anonymisiert, bevor etwas ins Archiv gespendet wird. Der GitHub-Token liegt nur auf dem Server. Dahinter steckt ein kleines Node/Express-Backend, das die Marstek-Cloud-API weiterreicht (der Browser darf sie wegen CORS nicht direkt aufrufen) und mit GitHub für Spenden und Diagnose spricht; die Firmware selbst kommt direkt vom CDN von Marstek.

Das Werkzeug lädt und archiviert Firmware, es flasht sie nicht. Zum Einspielen einer bestimmten Version dient Marstek BLE Control – das Bluetooth-Werkzeug, das Firmware-Updates ausführt. Das Projekt ist inoffiziell und nicht mit Marstek verbunden.