Zero-Logs mit einer seriellen Konsole auslesen (PuTTY)
Wenn der Download über die App scheitert oder abgeschnitten wird, liefern dir ein billiges serielles Kabel und ein Terminalprogramm die komplette Loghistorie des Motorrads als Klartext, und du kannst diesen Mitschnitt hier genauso hochladen wie eine .bin-Datei.
Kurz gesagt
Schließe einen 3,3-V-USB-TTL-Seriell-Adapter an den OBD-II-Anschluss des Motorrads an (GND→5, RX→8, TX→9, +5 V unbeschaltet), schalte die Zündung ein, öffne PuTTY mit 38400 Baud (Gen2) und stelle das Session Logging auf All session output und tippe eventlogdump am Prompt ZERO MBB>. Speichere den Mitschnitt und lade die .txt/.log-Datei beim Zero Logs Analyzer hoch.
Wozu überhaupt ein Konsolen-Dump?
Der normale Weg an die Logs führt über die offizielle Zero-App: per Bluetooth koppeln, dann Support → Email bike logs, was proprietäre binäre .bin-Dateien verschickt. Dieser Weg hat zwei bekannte Fehlerarten:
- Die App kann vor dem Versand abstürzen. Auf neueren Android-Versionen stürzt die App bekanntermaßen nach dem Herunterladen der Logs ab, aber vor dem Senden. Die Dateien liegen meist trotzdem noch auf dem Handy unter
Android/data/com.ZeroMotorcycles/files/, egal ob die E-Mail rausging oder nicht. - Downloads können unbemerkt abgeschnitten werden. Wir haben eine echte MBB-.bin mit 32 KB gesehen, obwohl der volle MBB-EEPROM 256 KB hat, und rund 87 % der Historie fehlten. Die Datei wird ohne Fehler geparst, die Kürzung ist für den Besitzer also unsichtbar.
Ein Konsolen-Dump vermeidet beides. Logs über die serielle Konsole kommen vollständig dekodiert als Klartext an, ohne dass auf Seiten des Motorrads binär geparst werden muss, und der Dump beginnt mit einer Kopfzeile wie Printing 5806 of 5806 log entries.., die offen sagt, wie viele Einträge du erfasst hast. Damit ist er eine verlässliche Gegenprobe zu einem fragwürdigen .bin-Download, und bei Gen2-Motorrädern läuft er durch den ganzen Logspeicher.
Aufbau eines Zero-Logs zeigt diesen Unterschied an echten Auszügen, jede Zeile gekennzeichnet nach der Herkunft ihrer Wörter: Text, den das Motorrad selbst gespeichert hat (das bekommst du aus einem Konsolen-Dump), oder unsere Dekodierung der Rohbytes. Ein Gen3-Binärlog mischt beides: Seine Textdatensätze sind die eigenen Worte des Motorrads, und jede Zahl darin ist unsere Dekodierung.
BMS-Logs über die App gibt es nur bei Modellen ab 2014 (in App v1.0.8/1.0.9 ergänzt), und das BMS-Auslesen über Bluetooth kann sehr langsam sein, ein weiterer Grund, warum für detaillierte Akkuarbeit gern das Kabel genutzt wird.
Gen2: Anschluss per Kabel
Die Motorräder aus der Sevcon-Zeit haben eine serielle Konsole auf TTL-Pegel an herstellerreservierten Pins eines OBD-II-Steckers (J1962). Das sind die S, DS, SR und DSR bis 2023, die FX (2014–2025), FXS (2016–2021) und FXE (2022–2025) sowie die älteren XU und MX. (S, SR, DS und DSR behielten ihre Namen, als sie 2024 auf die Plattform Cypher III wechselten, schau also aufs Baujahr, nicht auf das Typenschild: Ab 2024 gehören diese vier in den Gen3-Abschnitt unten.) Die Belegung ist kein Standard-OBD-II, ein ELM327-Diagnosegerät funktioniert also nicht. Du sprichst direkt mit dem MBB, mit einem USB-TTL-Seriell-Adapter und einem Terminalprogramm, nach der ZeroManual-Anleitung zur Gen2-MBB-Konsole.
Pinbelegung des Selbstbaukabels (Seite des OBD-II-Steckers)
| Adapterader | OBD-II-Pin | Signal |
|---|---|---|
| Schwarz | 5 | Masse |
| Weiß (RX des Adapters) | 8 | MBB sendet |
| Grün (TX des Adapters) | 9 | MBB empfängt |
| Rot (+5 V) | — | Unbeschaltet lassen; speise das Motorrad nie rückwärts |
Die Aderfarben folgen den gängigen USB-TTL-Kabeln, die im ZeroManual-Kabelleitfaden beschrieben sind; prüfe das Datenblatt deines Adapters, falls es abweicht. Die Signale haben 3,3-V-Logik: Tests der Community ergaben, dass manche TTL-Adapter nur für 5 V nicht funktionieren, nimm also einen Adapter, der 3,3 V kann.
Wo sitzt der OBD-II-Anschluss?
| Plattform / Baujahre | Ort |
|---|---|
| S-Plattform 2011–2012 | Tankbereich, beim Sicherungskasten |
| S/DS 2013 | Über/hinter dem Motor neben dem Zubehör-Ladeanschluss, linke Seite |
| S/DS 2014–2015 | Gleiche Stelle, rechte Seite |
| S/DS 2016+ | Unter der Sitzbank, linke Seite, hinter dem Rahmenschott |
| FX / FXS (XMX) | Unter der linken Tankverkleidung |
| SR/F, SR/S etc. (FST) 2020+ | Im Staufach im Tank |
Serielle Parameter und PuTTY-Einrichtung
Baudrate nach Generation
Vor 2013: 9600
Sevcon-Zeit (S, SR, DS, DSR bis 2023, FX, FXS, FXE): 38400
Cypher III (SR/F, SR/S, DSR/X, S/F und S/SR/DS/DSR ab 2024): 115200
Motorräder von 2012 sind eine Grauzone: In einem Besitzer-Thread hieß es 38400, während das Wiki vor 2013 unter 9600 führt, probiere also erst 38400, dann 9600. Für alle Generationen: 8 Datenbits, keine Parität, 1 Stoppbit (8-N-1), Flusssteuerung aus, CR-LF als Zeilenende.
Die FXE ist ein Cypher-II-Motorrad im FX-Körper. Ihr MBB schreibt dieselbe 262.144 Byte große MBB\0-Datei wie die anderen Motorräder der Sevcon-Zeit, das Gen2-Verfahren und 38400 sind also das, was du probieren solltest. Wir haben keinen Konsolen-Mitschnitt einer FXE, der es bestätigt; wenn 38400 nur Zeichensalat liefert, probiere 115200, bevor du das Kabel für falsch hältst.
PuTTY (Windows)
1. Verbindungstyp: Serial; Serial line: dein COM-Port (z. B. COM4); Speed: 38400.
2. Unter Connection → Serial: 8 Datenbits, keine Parität, 1 Stoppbit, Flusssteuerung None.
3. Unter Session → Logging: Session Logging einstellen auf All session output und einen Dateinamen wählen (z. B. putty.log). Mach das vor dem Dump, damit der Mitschnitt in einer Datei landet.
Unter Linux nimm Minicom, unter macOS CoolTerm oder Serial, unter Android BlueTerm (das ausgehende Zeilenende auf CRLF stellen). Klassisches Bluetooth SPP kann iOS gar nicht.
Ablauf: Kabel in den Laptop stecken, den COM-Port notieren, mit dem OBD-Anschluss des Motorrads verbinden, Zündung einschalten, das Terminal öffnen und ein- bis zweimal die Eingabetaste drücken. Du solltest den Prompt ZERO MBB> sehen. Lesende Befehle funktionieren ohne Anmeldung; für Konfigurationsänderungen gibt es einen Befehl login, dessen Passwörter aber nicht veröffentlicht sind; Forenbeiträge, die danach fragen, werden privat beantwortet, wenn überhaupt.
Die Dump-Befehle (Gen2)
Tippe help, um das Menü zu sehen. Die Befehle, die du brauchst:
| Befehl | Was er tut |
|---|---|
| eventlogdump | Gibt das vollständige Ereignislog als dekodierten Text aus (der Haupt-Dump für die Analyse) |
| errorlogdump | Gibt das Fehlerlog aus (Fehler und Warnungen) |
| dumpall | Gibt alles aus: Statistik, Eingänge, Einstellungen und Logs. Liefert rund 1 MB Text und kann ein paar Minuten dauern; stelle vorher sicher, dass das Session Logging an ist |
| help / status / stats / bms | Lesende Extras. bms zeigt Live-Akkudaten (SoC, Spannungen je Bank, Balancing, Isolation, Temperaturen, Zyklen) |
So sieht der Dump aus
Printing 5806 of 5806 log entries..
Entry Time of Log Event Conditions
05688 09/08/2012 17:42:28 Discharge level 065 AH, SOC: 46%, I:-13A,
L:3426, l:3383, H:3485, B:059, PT:032C,
BT:032C, PV:62418, M:Bike OnEchter Mitschnitt von der BMS-Konsole eines Motorrads von 2012 (von der Community dokumentiert). Die Kopfzeile sagt dir genau, wie viele Einträge ausgegeben wurden: Steht dort 5806 of 5806, hast du alles bekommen.
Zerstörerische Befehle stehen im selben Menü
eventlogclear, errorlogclear, format eeprom, erase eeprom, settingsrst und eine Einstellung abs_disable sind nur einen Tippfehler entfernt. Bleib bei den lesenden Dump-Befehlen oben.
Frühe Motorräder (aus der Zeit von 2012) haben außerdem eine eigene Konsole ZERO BMS> direkt am Akku, mit eigenem eventlogdump plus den Befehlen balance / dobalance. Bei späteren Gen2-Motorrädern führt das BMS jedes Akkus weiter sein eigenes Ereignislog, es wird aber über das MBB erreicht (und dauert länger). Direkter BMS-Konsolenzugriff auf Akkus ab 2013 ist von der Community nicht dokumentiert.
Und Bluetooth?
Konsole über Bluetooth läuft mit einem Relais-Dongle im OBD-II-Anschluss, nicht mit dem Funkmodul des Motorrads selbst:
- Der Dongle DigiNow Data Reaper legte die OBD-Pins 8/9 als Bluetooth-Terminal im Serial Port Profile (SPP) offen. Er funktioniert nur bei MY2012–2016-Motorrädern: Er versorgt sich aus einer 3,3-V-Versorgung an OBD-Pin 12, die ab 2017 offenbar nicht beschaltet ist. Ab 2017 funktioniert weiterhin ein USB-Kabel.
- ECMCables verkaufte einen ähnlichen OBDDROID-SPP-Dongle (Modelle 2013–2016), den das Community-Wiki als eingestellt führt.
- Nimm mit diesen Dongles kein OBD-Verlängerungskabel: Sie ziehen ihren Strom aus einem sehr empfindlichen kleinen 3,3-V-Kreis im MBB, den jedes zusätzliche Kabel zu stark dämpft.
- SPP heißt: iOS kann sich nicht verbinden (iOS unterstützt dafür nur BLE); Android, PC und Mac können es. Die Kopplungs-PINs sind nicht dokumentiert, schau also in die Unterlagen deines Dongle-Herstellers.
ZERO MBB> kommt, betrachte das also als undokumentiert und nicht unterstützt. Was das eingebaute Funkmodul tatsächlich spricht (sein eigenes Befehlsprotokoll mit Livewerten und Log-Download), steht in Wie eine Zero über Bluetooth spricht.Gen3 / Cypher III (SR/F, SR/S, DSR/X, S/F und S, SR, DS, DSR ab 2024)
Motorräder mit Cypher III haben eine serielle Konsole, mit demselben Ansatz über den OBD-II-Anschluss bei 115200 Baud, mit dem Anschluss im Staufach im Tank (bestätigt sowohl durch die ZeroManual-Referenz zur Gen3-Konsole als auch durch Zeros eigenes Service-Bulletin zur SR/F). Besitzer haben dasselbe Selbstbaukabel für die SR/F des Modelljahrs 2020 gebaut. Die Befehle für das Ereignislog unterscheiden sich von Gen2:
Alles hier Dokumentierte stammt von Besitzern der SR/F und SR/S. S, SR, DS und DSR sind 2024 ohne Namensänderung auf dieselbe Plattform Cypher III gewechselt, dieser Abschnitt ist also der Ausgangspunkt für ein Motorrad dieser vier ab 2024. Niemand hat einen Konsolen-Mitschnitt von einem solchen veröffentlicht, und wir auch nicht, behandle Baudrate und Befehlssatz also als fundierte erste Vermutung statt als dokumentierte Tatsache, und sag uns, was du findest.
| Befehl | Langform | Was er tut |
|---|---|---|
| eld # | eventlogdump | Ereignislog-Dump (# = letzte n Einträge, optional) |
| elde # | eventlogdumpexhaustive | Vollständiger Dump, der umfassendste Textexport |
| eldd # | eventlogdumpdate | Dump ab einem Datum (MM DD YYYY HH MM SS) |
| eldh | eventlogdumphex | Hex-Dump; er braucht einen Log-Decoder, überspring ihn also |
- Einen eigenen Befehl
errorlogdumpgibt es bei Gen3 nicht; Fehler stehen stattdessen unter dem Befehlfaults. (Die vollständige Varianteeldegibt es nur bei Gen3; Gen2 hat nichts Vergleichbares.) - Ob die Gen3-Dump-Befehle zuerst ein
loginbrauchen, ist nicht dokumentiert. Die echten Mitschnitte im Wiki zeigen außerdem asynchrone DEBUG-Fehlerzeilen, die in die Sitzung hineingedruckt werden und sich mit deinem Dump mischen; unser Parser toleriert dieses Rauschen. - Der Alltagsweg bei Gen3 bleibt die Handy-App (Support → Email bike logs), und diese .bin-Dateien lädst du hier wie gewohnt hoch. Händler nutzen stattdessen das Zero Diagnostic Utility über ein CAN-Interface, in dem „Pull All Logs“ eingebaut ist.
Mit der ZeroLogs-App (Android)
Ab Version 0.37 kann die ZeroLogs-App für Android den Platz von PuTTY einnehmen. Sie spricht mit der Konsole über dasselbe Kabel oder über einen Dongle und legt den Mitschnitt für dich in ihre Upload-Warteschlange.
- USB-Kabel. Derselbe 3,3-V-USB-TTL-Adapter und dieselbe Verdrahtung wie oben, über einen USB-OTG-Adapter am Handy. Die App kennt Adapter mit CP210x, FTDI, CH34x und Prolific, bietet an, die Konsole zu öffnen, wenn du einen ansteckst, und findet die Baudrate selbst.
- Bluetooth-Dongle. Ein Data Reaper oder OBDDROID an einem Motorrad von 2012 bis 2016. Koppele ihn zuerst in den Bluetooth-Einstellungen von Android. Die App bietet nie die Bluetooth-Verbindung des Motorrads selbst an, die nicht bis zur Konsole reicht.
- Wo du es findest. Der Tab Motorrad zeigt eine Zeile Serielle Konsole, sobald ein Adapter steckt oder ein Dongle genutzt wurde. Auch eine Diagnose kann dich dorthin schicken.
- Welches Motorrad. Ein Mitschnitt enthält keine VIN, die App legt ihn deshalb unter dem im Tab Motorrad gekoppelten Motorrad ab und zeigt dir vor dem Start, welches das ist.
- iPhone. Es gibt keine iPhone-Version der App, auf einem iPhone bleibt das also Computerarbeit.
eventlogdump, errorlogdump, dumpall und status bei Gen2 sowie eld, elde und faults bei Gen3, wo es die Befehle sind, die Besitzer dokumentiert haben und die noch niemand mit einem Mitschnitt abgeglichen hat. Auf der Konsole sendet sie nie login und ändert keine Einstellung. Verlangt das Motorrad eine Anmeldung, hält die App an und sendet nichts mehr.Deinen Mitschnitt beim Zero Logs Analyzer hochladen
Nimm die Datei, die PuTTY geschrieben hat (z. B. putty.log), und zieh sie auf die Upload-Seite, die neben .bin-Dateien auch .txt- und .log-Mitschnitte annimmt. Ein paar Dinge zu wissen:
Konsolen-Mitschnitte enthalten deine VIN nicht verlässlich, der Uploader bittet dich deshalb, eines deiner Motorräder zu wählen oder die 17-stellige VIN einzutippen.
Lass den Logtyp auf automatischer Erkennung oder stelle ihn von Hand ein, wenn du weißt, von welcher Konsole der Dump stammt.
Der Parser extrahiert die Einträge mit Zeitstempel (Fahrten, Ladungen, SOC, Zellspannungen, Temperaturen, Fehler) und speist dieselben Ansichten für Zeitleiste, Akkugesundheit und Diagnose. Du kannst den ganzen Sitzungsmitschnitt hochladen; Prompts und die Ausgabe von help rund um den Dump werden ignoriert.
Die eigene Kopfzeile Printing N of M log entries des Dumps sagt, wie viele Einträge das Log enthält; nach dem Parsen vergleichen wir das mit der Zahl, die wir gelesen haben, und markieren den Bericht als vermutlich unvollständig, wenn der Mitschnitt abgeschnitten wirkt, damit ein abgeschnittener Terminal-Scrollback nie unbemerkt als volle Historie durchgeht.
Sicherheit und Vorbehalte
- Die Community ist sich einig, dass das Sprechen mit deinem MBB oder BMS auf eigenes Risiko geschieht und deine Garantie berühren kann.
- Nimm einen Seriell-Adapter mit 3,3-V-Logik; TTL-Adapter nur für 5 V funktionieren Berichten zufolge nicht. Lass die +5-V-Ader des Adapters unverbunden, damit nichts das Motorrad rückwärts speist.
- Die Zündung des Motorrads muss für die Sitzung an sein. Lange Dumps können das Leerlauf-Timeout überdauern (Gen2-Standard
secidleist 7200 s); der Rat der Community bei langen Auslesevorgängen ist, gelegentlich kurz Gas zu geben, um das Motorrad wach zu halten. - Halte dich von den oben aufgeführten zerstörerischen Befehlen fern; führe nur die lesenden Dumps aus.
- Gesunder Menschenverstand (kein belegtes Verfahren): Zieh das Kabel ab, bevor du fährst.
- Wer bei Gen1 direkt an den Stiftleisten der MBB-Platine herumprobiert: Vorsicht vor der Hochvolt-Stiftleiste J5, die deine Werkzeuge grillen kann.
FAQ
Brauche ich ein Passwort, um die Logs eines Zero-Motorrads über die Konsole auszulesen?
Bei Gen2-Motorrädern funktionieren Befehle, die nur lesen, wie help, status und eventlogdump, ohne Anmeldung. Es gibt einen Befehl login zum Ändern der Konfiguration, seine Passwörter sind aber nicht veröffentlicht. Ob die Dump-Befehle bei Gen3 zuerst eine Anmeldung verlangen, ist nicht dokumentiert.
Funktioniert ein normales OBD-II-Diagnosegerät (ELM327) an einem Zero-Motorrad?
Nein. Zero nutzt die Steckerform von OBD-II, belegt aber herstellerreservierte Pins mit einer seriellen Konsole auf TTL-Pegel und nicht mit den Standardprotokollen von OBD-II. Du brauchst einen 3,3-V-USB-zu-TTL-Seriell-Adapter und ein Terminalprogramm, kein Diagnosegerät.
Komme ich über das eingebaute Bluetooth des Motorrads an die Konsole?
Einen dokumentierten Weg gibt es nicht. Das eingebaute Funkmodul des Motorrads ist nur als Verbindung zur offiziellen mobilen Zero-App dokumentiert, per klassischem Bluetooth-Seriell (SPP) bei Gen2 und per Bluetooth LE bei Gen3. Konsole über Bluetooth ist nur mit Relais-Dongles aus dem Zubehörhandel dokumentiert, die im OBD-II-Anschluss stecken, und diese schalten sich nur bei Motorrädern der Modelljahre MY2012-2016 ein.
Welche Datei lade ich nach einem Konsolen-Dump in Zero Logs Analyzer hoch?
Lade die gesamte Mitschrift der PuTTY-Sitzung hoch (putty.log oder eine beliebige .txt-/.log-Datei). Eingabeaufforderungen und Hilfeausgaben rund um den Dump sind in Ordnung: Der Parser findet die Tabelle der Logeinträge von selbst. Wähle beim Hochladen dein Motorrad oder gib deine VIN ein, denn Textmitschnitte enthalten sie nicht verlässlich.
Ist ein Konsolen-Dump besser als die .bin-Dateien aus der Zero-App?
Beides wird unterstützt. Ein Konsolen-Dump kommt vollständig dekodiert als reiner Text an, und sein Kopf „Printing N of M log entries“ nennt genau, wie viele Einträge du erfasst hast. Das macht ihn zu einer verlässlichen Gegenprobe, wenn Downloads aus der App fehlschlagen oder stillschweigend abgeschnitten werden.
Hinweis: zeromanual.com ist gelegentlich nicht erreichbar; ist ein Wiki-Link tot, hat die Wayback Machine Schnappschüsse jeder unten zitierten Seite.
Quellen:
- ZeroManual: Gen2 MBB Console (öffnet in neuem Tab)
- ZeroManual: Gen3 MBB Console (öffnet in neuem Tab)
- ZeroManual: How to build a cable to access the MBB (öffnet in neuem Tab)
- ZeroManual: OBD-II Port (öffnet in neuem Tab)
- ZeroManual: OBD-II Port Location (öffnet in neuem Tab)
- ZeroManual: Logs (öffnet in neuem Tab)
- ZeroManual: Official Mobile Application (öffnet in neuem Tab)
- ZeroManual: DigiNow Data Reaper Dongle (öffnet in neuem Tab)
- EMF: List of existing commands for the Zero MBB and BMS (öffnet in neuem Tab)
- EMF: Zero SR/F MY2020 OBD cable to serial console (öffnet in neuem Tab)
- Zero/NHTSA service bulletin SV-ZMC-020-405 (SR/F log pulls, ZDU) (öffnet in neuem Tab)
- PuTTY manual, ch. 4.2: session logging (öffnet in neuem Tab)
Die Angaben zum Konsolenzugriff beruhen auf Dokumentation und Reverse Engineering der Community, vor allem dem Unofficial Zero Manual. Zero Motorcycles unterstützt den Konsolenzugriff durch Besitzer nicht offiziell, du handelst also auf eigenes Risiko.