Zum Hauptinhalt springen
zerologs
Zurück zum Lernbereich
Aufbau der Logdatei

So funktionieren Zero-Logs

Verstehe den Aufbau der MBB- und BMS-Logdateien, wie sie entstehen und welche Daten sie enthalten.

Zuletzt aktualisiert: 3. Oktober 2026

Kurz gesagt

Zero speichert Diagnosedaten in binären .bin-Dateien: MBB-Logs enthalten Fahrdaten (Motor, Controller, Geschwindigkeiten), BMS-Logs den Akkuzustand (Zellspannungen, SOC, Laden). Beide enthalten Einträge mit Zeitstempel, die dieses Tool in ein lesbares Format übersetzt.

Logformat nach Generation

„Gen2“ und „Gen3“ meinen hier die Logformate (welches Binärlayout die Datei nutzt), nicht die Produktgeneration des Motorrads. Beides deckt sich nicht Modell für Modell, und der Generationsvergleich entwirrt die drei Bedeutungen des Wortes.

Volle Unterstützung: Gen2-Format

Die 262.144 Byte großen MBB\0 / BMS\0-Dumps: FX (2014-2025), FXS (2016-2021), FXE (2022-2025) und die S, SR, DS und DSR der SDS-Plattform (2014-2023), dazu die Varianten FXP, XU und MX. Sevcon-Gen4-Controller, vollständiges MBB/BMS-Parsing. Die FXE läuft in unserem Parser über den Gen3-Pfad, ist aber trotzdem ein Motorrad mit Cypher II. Von einer S, SR, DS oder DSR ab 2024 (das sind Maschinen mit Cypher III) haben wir kein Log, welches Format sie schreiben, ist hier also unbestätigt.

Volle Unterstützung: Gen3-Format

Der native 0xB2-Ringpuffer: SR/F und SR/S ab 2020, DSR/X ab 2023, mit vollständig dekodiertem MBB und BMS. Fahrten, Ladevorgänge, Zellspannungen, Temperaturen und Zustandsautomat werden alle gelesen. Hinweis: Gen3 nutzt einen Ringpuffer, den ein geparktes Motorrad in etwa 3 Tagen füllt: Das MBB wacht einmal pro Stunde auf und schreibt jedes Mal ~31 Einträge. Lade die Logs oft herunter, um den Fahrtverlauf zu sichern.

Zwei Arten von Logs

Motorräder von Zero Motorcycles haben zwei unabhängige Loggingsysteme, die jeweils andere Seiten des Betriebs festhalten:

MBB-Logs

Main Bike Board: der zentrale Controller, der Motorbetrieb, Anzeige und Systemabstimmung steuert.

Enthält (Gen1 / Gen2):
  • • Motortemperatur und Drehzahl
  • • Controllertemperatur
  • • Kilometerzähler
  • • Akku- und Motorstrom
  • • Akkuspannung, SOC und die Modul-Bitmaske
  • • Umgebungstemperatur
  • • Systemereignisse und Fehler

Kein Gen1- oder Gen2-Log enthält ein Feld für die Straßengeschwindigkeit. Wo du bei diesen Motorrädern km/h siehst, wurde sie mit einer Konstante je Modell aus der Motordrehzahl berechnet. Auch die Gasgriffstellung wird nie geloggt.

Bei den Gen3-FST-Motorrädern (SR/F, SR/S, DSR/X) loggt das MBB den Zustand des Motorrads und die Leistungsgrenzen, und sein gängiger Telemetrie-Datensatz trägt fünf Temperaturen und, nur solange der Hochvoltkreis aktiv ist, Akkuspannung, Strom und Motordrehzahl. Die Straßengeschwindigkeit steht nur in den selteneren 0x52/0x53-Datensätzen und der Kilometerzähler nur dort und nur bei neuerer Firmware, daher bleibt das BMS die Hauptquelle für die elektrischen Kanäle.

Dateinamensmuster (alle echt):
VIN_MBB_YYYY-MM-DD.bin
VIN_MbbD_YYYY-MM-DD.bin
YYYYMMDD_HH.MM_VIN_MBB.bin
YYYYMMDD_HH.MM_VIN_6.bin

Hinter MBB steht keine Ziffer. Ein Motorrad hat ein Hauptboard, also trägt die MBB-Datei keinen Index. In einem Korpus von 352 Dateien kommen diese Formen vor, abgesehen von einem Download, der mit Bindestrichen statt Unterstrichen oder mit dem Kopiesuffix _1 ankommt. MbbD ist der Export desselben Boards mit dem Händlerwerkzeug; die beiden Formen mit dem Datum zuerst sendet die Gen3-FST, bei der _6 das MBB ist und _10 das BMS.

BMS-Logs

Battery Management System: ein eigener Controller für Akkuüberwachung, Schutz und Ladesteuerung.

Enthält:
  • • Zellspannungen (L, l, H)
  • • Ladezustand (SOC)
  • • Akkuspannung
  • • Delta der Zellbalance
  • • Akku- und Boardtemperatur
  • • Ladeereignisse
Dateinamensmuster (alle echt):
VIN_BMS0_YYYY-MM-DD.bin
VIN_BMS1_YYYY-MM-DD.bin
VIN_BmsD0_YYYY-MM-DD.bin
YYYYMMDD_HH.MM_VIN_10.bin

Die Ziffer ist der Index des Akkumoduls, deshalb kann es mehr als eine BMS-Datei geben. Details folgen unten.

Hier ist eine Sekunde eines echten Abschaltens, in der beide Boards gleichzeitig schreiben. Sie loggen unter zwei verschiedenen Namen, dass das Schütz öffnet, und jedes Board misst dieselbe Akkuspannung mit seinem eigenen Messgerät.

Derselbe Zeitpunkt, zweimalFXS 2016 switching off08:17:218 lines · 6 bike, 2 packMBBPower OffMBBSevcon Turned OffMBBModule 00 Opening Contractor107.998 VMBBModule 01 Opening Contractor107.971 VMBBDisabling External Chg 0 Charger 2MBBDisabling External Chg 1 Charger 3BMSContactor was Opened107.997 VBMSSystem Turned OffEin Schütz, zwei VokabulareDie beiden hervorgehobenen Zeilen sind dasselbe StückHardware beim Öffnen, anders benannt.1 mV apart: two voltmetersbattery management107.997 Vmain board · module 00107.998 Vmain board · module 01107.971 VZwei Module parallel: eine Akkuspannung,read three times. And 740 seconds in this pair ofDateien tragen Zeilen von beiden Platinen.
Dasselbe Schütz, dieselbe Sekunde, zwei Namen und zwei unabhängige Voltmeter, 1 mV auseinander. Das zeigt, warum dir eine Zero zwei Dateien gibt: Keine Datei sagt, dass die beiden Ereignisse dasselbe sind, du musst sie also auf eine Achse legen. Diese Sekunde ist gewöhnlich und nicht selten: 740 Sekunden in diesem Paar tragen Zeilen von beiden Platinen.

Aus Anatomie eines Zero-Logs, das echte Auszüge für jeden Dekodierpfad zeigt: Einschalten, Fahren, Laden, Parken, ein Fehler und Ausschalten.

Hat dein Motorrad zwei Akkumodule, schreibt es zwei BMS-Dateien, und lädst du nur eine hoch, fehlt die Hälfte deines Akkus

Jedes Akkumodul betreibt sein eigenes BMS und führt sein eigenes Log, der Index im Dateinamen zählt also Module, nicht Dateien. In unserem Korpus von 352 Dateien verteilt es sich so: BMS0 ×109, BMS1 ×78 und BmsD0 ×17. Eine FXS von 2016 mit dem Zwei-Modul-Akku ZF6.5 liefert BMS0 ×61 und BMS1 ×61, die dieselben Tage in getrennten Dateien abdecken. Eine FXE mit dem integrierten ZF7.2 liefert BMS0 allein.

Das MBB-Log stimmt damit überein, und so kannst du es prüfen, ohne Dateien zu zählen. An der FXS mit zwei Modulen loggt das MBB Module 00 Registered und Module 01 Registered, und jeder Fahreintrag trägt eine Modul-Bitmaske mit dem Wert mods 11. An der FXE meldet sich nur Module 00 an, und die Bitmaske lautet mods 10, also ein Modul vorhanden. Dieses eine Zeichen ist der Unterschied zwischen einem Akku aus zwei herausnehmbaren Blöcken und einem fest verbauten Akku mit demselben kWh-Schild.

Der Index ist nur bei der FX- / XMX-Familie eine Modulzählung, wo die Module herausnehmbar sind und die Nummerierung bei null beginnt. Die Gen3-FST-Motorräder (SR/F, SR/S, DSR/X) in diesem Korpus liefern ein einzelnes BMS1 ohne BMS0: Ihre Nummerierung beginnt einfach bei eins, und sie haben einen einzigen fest verbauten Akku. Fährst du eine FST, ist eine BMS-Datei die ganze Geschichte.

Wenn du Logs exportierst, nimm jede Datei, die dir die App oder das Händlerwerkzeug anbietet, und lade alle hoch. Im Akkukatalog steht, welche Akkus modular sind.

Aufbau eines Logeintrags

Jeder Logeintrag enthält einen Zeitstempel, einen Ereignistyp und eine Meldung mit strukturierten Daten. So sehen sie aus, wenn sie gelesen sind:

Rohe Logzeile:
level 001 AH, SOC: 97%, I: 0A, L:4089, l:4076, H:4092, B:003, PT:017C, BT:031C, PV:114540, M:Bike On
Klick auf ein Feld, um zu sehen, was es bedeutet:
Kategorien:
battery
temperature
motor
system
cells

Häufige Ereignistypen

Das sind genau die Zeichenketten, die der Decoder ausgibt, du kannst also danach suchen und filtern. Die Zahlen stammen aus 92.407 Einträgen, dekodiert aus vierzehn echten Logdateien.

EreignistypQuelleWas es ist
RidingMBBDie Fahr-Momentaufnahme einmal pro Minute: SOC, Akkuspannung, Akku- und Motorstrom, Motordrehzahl, alle vier Temperaturen, Kilometerzähler und die Modulbitmaske.
ChargingMBBDieselbe Momentaufnahme, aufgezeichnet, während das Motorrad lädt.
DisarmedMBBMotorrad wach, aber nicht aktiv: identische Telemetrie bei ruhendem Motor.
Board StatusMBBRegelmäßiger Zustandsbericht der Hauptplatine.
Power On / Power OffMBBZündungswechsel. Zusammen mit Sevcon Turned On / Sevcon Turned Off klammern sie bei einem Gen1/Gen2-Motorrad eine Fahrt ein.
Module 00 … / Module 01 …MBBAkkuereignisse je Modul: Registered, CAN Link Up/Down, Closing/Opening Contractor. Der Index ist die Modulnummer.
Discharge levelBMSDie zentrale BMS-Telemetriezeile: Amperestunden, SOC, Strom, die Zellspannungen L / l / H, das Balance-Delta B, Akku- und Platinentemperatur.
SOC DataBMSBuchführung zum Ladezustand neben den Entladezeilen.
Charged To FullBMSLaden abgeschlossen. Ein Ereignis namens „Charged“ gibt es nicht.
Entered Idle / Running / Standby / Charging StateBMSÜbergänge des BMS-Zustandsautomaten, dazu Entering Hibernate / Exiting Hibernate.
Discharge CutbackBMSDas BMS begrenzt den Entladestrom (niedriger SOC, kalter Akku oder eine schwache Zelle).
Chassis Isolation FaultBMSDie Isolation zwischen dem HV-Akku und dem Chassis ist gesunken. Auch als Low Chassis Isolation zu sehen.

Namen, die plausibel klingen, aber nicht existieren, eine Suche danach liefert also nichts: Charged, System, Error, Charge level, Chg complete, Balancing. Fehler sind kein einzelner Ereignistyp: Sie erscheinen unter ihren eigenen beschreibenden Namen, deshalb fasst der Log-Fehlerkatalog sie zu Familien zusammen, statt nach einem einzigen Stichwort zu filtern.

So liest du Logs aus

Die Logdateien deiner Zero lassen sich mit der offiziellen Mobil-App oder über eine direkte Verbindung zum Diagnoseanschluss des Motorrads auslesen. Die Anleitung „Interfacing“ von ZeroManual beschreibt es ausführlich.

1
Über die Zero-Mobil-App

Verbinde dich per Bluetooth mit deinem Motorrad, geh in die Diagnose und exportiere die Logs.

2
Über den Diagnoseanschluss (serielle Konsole)

Ein serielles Kabel am OBD-II-Anschluss des Motorrads liefert dir den vollständigen Logverlauf als Klartext, was hilft, wenn der App-Download scheitert oder abbricht. Siehe unsere Schritt-für-Schritt-Anleitung zur PuTTY-Konsole; der entstehende .txt-/.log-Mitschnitt lässt sich hier genauso hochladen wie eine .bin-Datei.

3
In Zero Logs Analyzer hochladen

Unser Tool übersetzt die Binärdaten in strukturierte, durchsuchbare Einträge.

Die Details zum Logformat beruhen auf Reverse Engineering der Community. Für offizielle Dokumentation wende dich an Zero Motorcycles.