Estrarre i log Zero con una console seriale (PuTTY)
Quando il download dall'app fallisce o si tronca, un cavo seriale economico e un programma di terminale ti danno l'intera cronologia dei log della moto come testo semplice, e puoi caricare quella cattura qui come un file .bin.
In breve
Collega un adattatore seriale USB-TTL da 3,3 V alla porta OBD-II della moto (GND→5, RX→8, TX→9, +5 V non collegato), accendi il quadro, apri PuTTY a 38400 baud (Gen2) con il log della sessione impostato su All session output, e digita eventlogdump al prompt ZERO MBB>. Salva la cattura e carica il file .txt/.log su Zero Logs Analyzer.
Perché fare un dump dalla console?
Il modo normale di ottenere i log è l'app ufficiale Zero: abbina via Bluetooth, poi Support → Email bike logs, che manda file binari proprietari .bin. Questa via ha due modi di fallire noti:
- L'app può chiudersi prima di mandare l'e-mail. Sulle versioni più recenti di Android l'app è nota per chiudersi dopo aver scaricato i log ma prima di inviarli. I file di solito sono ancora nel telefono in
Android/data/com.ZeroMotorcycles/files/, che l'e-mail sia partita o no. - I download possono troncarsi in silenzio. Abbiamo visto un .bin MBB vero da 32 KB dove l'EEPROM MBB completa è da 256 KB, con circa l'87% della cronologia mancante. Il file si analizza senza errori, quindi il troncamento è invisibile a chi possiede la moto.
Un dump dalla console evita entrambi. I log ottenuti dalla console seriale arrivano completamente decodificati come testo semplice, senza bisogno di analisi binaria da parte della moto, e il dump comincia con un'intestazione come Printing 5806 of 5806 log entries.. che dice senza giri di parole quante righe hai catturato. È un controllo incrociato affidabile contro un download .bin sospetto, e sulle Gen2 percorre l'intero archivio dei log.
Anatomia di un log Zero mostra questa differenza con estratti reali, ogni riga marcata da dove vengono le sue parole: testo che la moto stessa ha salvato (quello che ti dà un dump dalla console) o la nostra decodifica dei byte grezzi. Un binario Gen3 mescola i due: i suoi record di testo sono le parole della moto, e ogni numero al suo interno è una nostra decodifica.
I log BMS via app sono disponibili solo sui modelli 2014+ (aggiunti nell'app v1.0.8/1.0.9), e l'estrazione del BMS via Bluetooth può essere molto lenta, che è un altro motivo per cui la via del cavo è diffusa per il lavoro dettagliato sulla batteria.
Gen2: collegarsi con il cavo
Le moto dell'era Sevcon espongono una console seriale a livello TTL su pin riservati al costruttore di un connettore OBD-II (J1962). Sono le S, DS, SR e DSR fino al 2023, la FX (2014–2025), la FXS (2016–2021) e la FXE (2022–2025), più le più vecchie XU e MX. (Le S, SR, DS e DSR hanno mantenuto il nome quando sono passate alla piattaforma Cypher III nel 2024, quindi guarda l'anno, non la targhetta: dal 2024 quelle quattro appartengono alla sezione Gen3 qui sotto.) Il cablaggio è non OBD-II standard, quindi uno strumento di scansione ELM327 non funziona. Parli direttamente con la MBB con un adattatore seriale USB-TTL e un programma di terminale, secondo la guida ZeroManual Gen2 MBB Console.
Piedinatura del cavo fai da te (lato spina OBD-II)
| Filo dell'adattatore | Pin OBD-II | Segnale |
|---|---|---|
| Nero | 5 | Massa |
| Bianco (RX dell'adattatore) | 8 | MBB trasmette |
| Verde (TX dell'adattatore) | 9 | MBB riceve |
| Rosso (+5 V) | — | Lascialo scollegato; non alimentare mai la moto in senso inverso |
I colori dei fili seguono i comuni cavi USB-TTL descritti nella guida ZeroManual al cavo; controlla la scheda tecnica del tuo adattatore se è diverso. I segnali sono a logica 3,3 V: i test della community hanno trovato che alcuni adattatori TTL solo a 5 V non funzionano, quindi usa un adattatore compatibile con 3,3 V.
Dov'è la porta OBD-II?
| Piattaforma / anni | Posizione |
|---|---|
| Piattaforma S 2011–2012 | Zona serbatoio, accanto alla scatola dei fusibili |
| S/DS 2013 | Sopra/dietro il motore accanto alla presa di ricarica accessori, lato sinistro |
| S/DS 2014–2015 | Stesso punto, lato destro |
| S/DS 2016+ | Sotto la sella, lato sinistro, dietro la paratia del telaio |
| FX / FXS (XMX) | Sotto le plastiche del serbatoio sul lato sinistro |
| SR/F, SR/S etc. (FST) 2020+ | Dentro il vano portaoggetti del serbatoio |
Parametri seriali e configurazione di PuTTY
Baud rate per generazione
Prima del 2013: 9600
Era Sevcon (S, SR, DS, DSR fino al 2023, FX, FXS, FXE): 38400
Cypher III (SR/F, SR/S, DSR/X, S/F, e S/SR/DS/DSR dal 2024): 115200
Le moto del 2012 sono una zona grigia: a un proprietario in una discussione è stato detto 38400 mentre la wiki mette il pre-2013 sotto 9600, quindi prova prima 38400, poi 9600. Tutte le generazioni: 8 bit di dati, nessuna parità, 1 bit di stop (8-N-1), controllo di flusso spento, a capo CR-LF.
La FXE è una moto Cypher II in un corpo FX. La sua MBB scrive lo stesso file da 262.144 byte MBB\0 delle altre moto dell'era Sevcon, quindi la procedura Gen2 e 38400 sono ciò da provare. Non abbiamo nessuna cattura dalla console di una FXE per confermarlo, quindi se 38400 non dà altro che spazzatura, prova 115200 prima di pensare che il cavo sia sbagliato.
PuTTY (Windows)
1. Tipo di connessione: Serial; linea seriale: la tua porta COM (per esempio COM4); velocità: 38400.
2. Sotto Connection → Serial: 8 bit di dati, nessuna parità, 1 bit di stop, controllo di flusso None.
3. Sotto Session → Logging: imposta il log della sessione su All session output e scegli un nome di file (per esempio putty.log). Fallo prima del dump, così la cattura finisce in un file.
Su Linux usa Minicom; su macOS CoolTerm o Serial; su Android BlueTerm (imposta il fine riga in uscita su CRLF). iOS non sa fare affatto il Bluetooth classico SPP.
Procedura: collega il cavo al portatile, annota la porta COM, collegati alla porta OBD della moto, accendi il quadro, apri il terminale e premi Invio una o due volte. Dovresti vedere il prompt ZERO MBB>. I comandi in sola lettura funzionano senza accesso; esiste un comando login per le modifiche di configurazione, ma le sue password non sono pubblicate; le discussioni nei forum che le chiedono ricevono risposta in privato, se la ricevono.
I comandi di dump (Gen2)
Digita help per vedere il menu. Quelli che ti servono:
| Comando | Cosa fa |
|---|---|
| eventlogdump | Stampa l'intero log degli eventi come testo decodificato (il dump principale per l'analisi) |
| errorlogdump | Stampa il log degli errori (guasti e avvisi) |
| dumpall | Scarica tutto: statistiche, ingressi, impostazioni e log. Produce circa 1 MB di testo e può richiedere qualche minuto; assicurati prima che il log della sessione sia attivo |
| help / status / stats / bms | Extra in sola lettura. bms mostra i dati dal vivo della batteria (SoC, tensioni per banco, bilanciamento, isolamento, temperature, cicli) |
Che aspetto ha il dump
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 OnCattura vera dalla console BMS di una moto del 2012 (documentata dalla community). L'intestazione dice esattamente quante righe sono state stampate: se dice 5806 of 5806, hai preso tutto.
I comandi distruttivi stanno nello stesso menu
eventlogclear, errorlogclear, format eeprom, erase eeprom, settingsrst e un'impostazione abs_disable sono a un errore di battitura di distanza. Attieniti ai comandi di dump in sola lettura qui sopra.
Le prime moto (dell'era 2012) espongono anche una console separata ZERO BMS> direttamente sulla batteria, con il suo eventlogdump più i comandi balance / dobalance. Sulle Gen2 più recenti il BMS di ogni batteria tiene ancora il proprio log degli eventi, ma ci si arriva attraverso la MBB (e ci vuole di più). L'accesso diretto alla console BMS sui pacchi 2013+ non è documentato dalla community.
E il Bluetooth?
La console via Bluetooth si fa con un dongle di inoltro inserito nella porta OBD-II, non con la radio della moto:
- Il dongle DigiNow Data Reaper esponeva i pin OBD 8/9 come terminale Bluetooth Serial Port Profile (SPP). Funziona solo sulle moto MY2012–2016: si alimenta da sé da un'alimentazione a 3,3 V sul pin OBD 12 che risulta non collegato dal 2017 in poi. Dal 2017 in poi un cavo USB funziona comunque bene.
- ECMCables vendeva un dongle SPP simile, OBDDROID (modelli 2013–2016), che la wiki della community segna come fuori produzione.
- Non usare una prolunga OBD con questi dongle: prendono energia da un delicato circuito MBB a 3,3 V che qualsiasi cavo in più attenua troppo.
- SPP significa che iOS non può collegarsi (iOS supporta per questo solo il BLE); Android, PC e Mac sì. I PIN di abbinamento non sono documentati, quindi controlla la documentazione del produttore del tuo dongle.
ZERO MBB> con la radio integrata, quindi consideralo non documentato e non supportato. Ciò che la radio integrata parla davvero (un proprio protocollo di comandi, con letture dal vivo e download dei log) è spiegato in Come parla una Zero via Bluetooth.Gen3 / Cypher III (SR/F, SR/S, DSR/X, S/F, e S, SR, DS, DSR dal 2024)
Le moto Cypher III hanno una console seriale, con lo stesso approccio della porta OBD-II a 115200 baud, con la porta dentro il vano portaoggetti del serbatoio (confermato sia dalla guida di riferimento ZeroManual Gen3 console sia dal bollettino di servizio di Zero sulla SR/F). I proprietari hanno costruito lo stesso cavo fai da te per la SR/F MY2020. I comandi del log degli eventi differiscono dalla Gen2:
Tutto quello che è documentato qui viene da proprietari di SR/F e SR/S. Le S, SR, DS e DSR sono passate sulla stessa piattaforma Cypher III nel 2024 senza cambiare nome, quindi questa è la sezione da cui partire su una moto del 2024 o successiva di quelle quattro. Nessuno ha pubblicato una cattura dalla console di una, e nemmeno noi, quindi considera il baud rate e l'insieme dei comandi come un'ipotesi informata e non un fatto documentato, e dicci cosa trovi.
| Comando | Forma estesa | Cosa fa |
|---|---|---|
| eld # | eventlogdump | Dump del log degli eventi (# = ultime n righe, facoltativo) |
| elde # | eventlogdumpexhaustive | Dump esaustivo, l'export di testo più completo |
| eldd # | eventlogdumpdate | Dump a partire da una data (MM GG AAAA HH MM SS) |
| eldh | eventlogdumphex | Dump esadecimale; serve un decodificatore di log, quindi saltalo |
- Sulla Gen3 non c'è un
errorlogdumpseparato sulla Gen3; i guasti stanno sotto il comandofaultsinvece. (La variante esaustivaeldeè solo Gen3; la Gen2 non ha un equivalente.) - Se i comandi di dump Gen3 richiedano prima un
loginnon è documentato. Le catture reali della wiki mostrano anche righe di guasto DEBUG asincrone che si stampano nella sessione e si intrecciano con il tuo dump; il nostro parser tollera quel rumore. - La via di ogni giorno sulla Gen3 resta l'app mobile (Support → Email bike logs), e quei file .bin si caricano qui come al solito. I concessionari usano invece lo Zero Diagnostic Utility su un'interfaccia CAN, che ha «Pull All Logs» integrato.
Con l'app ZeroLogs (Android)
Dalla versione 0.37 l'app ZeroLogs per Android può prendere il posto di PuTTY. Parla con la console attraverso lo stesso cavo o un dongle, e mette la cattura nella tua coda di caricamento.
- Cavo USB. Lo stesso adattatore USB-TTL da 3,3 V e lo stesso cablaggio di sopra, collegato al telefono con un adattatore USB-OTG. L'app conosce gli adattatori CP210x, FTDI, CH34x e Prolific, propone di aprire la console quando ne colleghi uno e trova da sola il baud rate.
- Dongle Bluetooth. Un Data Reaper o un OBDDROID su una moto dal 2012 al 2016. Abbinalo prima nelle impostazioni Bluetooth di Android. L'app non propone mai il collegamento Bluetooth della moto, che non arriva alla console.
- Dove trovarlo. La scheda Moto mostra una riga Console seriale quando un adattatore è collegato o è stato usato un dongle. Anche una diagnosi può mandarti lì.
- Quale moto. Una cattura non ha un VIN al suo interno, quindi l'app la archivia sotto la moto abbinata nella scheda Moto e ti mostra quale prima di cominciare.
- iPhone. Non esiste una versione dell'app per iPhone, quindi su un iPhone resta un lavoro da computer.
eventlogdump, errorlogdump, dumpall e status sulla Gen2, e eld, elde e faults sulla Gen3, dove sono i comandi che i proprietari hanno documentato e che nessuno ha ancora verificato su una cattura. Sulla console non manda mai login e non cambia nessuna impostazione. Se la moto chiede un accesso, l'app si ferma e non manda altro.Caricare la tua cattura su Zero Logs Analyzer
Prendi il file che PuTTY ha scritto (per esempio putty.log) e trascinalo sulla pagina di caricamento, che accetta catture .txt e .log insieme ai file .bin. Un paio di cose da sapere:
Le catture dalla console non contengono in modo affidabile il tuo VIN, quindi il caricamento ti chiede di scegliere una delle tue moto o di digitare il VIN di 17 caratteri.
Lascia il tipo di log su rilevamento automatico, o impostalo a mano se sai da quale console viene il dump.
Il parser estrae le righe con data e ora (giri, ricariche, SOC, tensioni delle celle, temperature, errori) e alimenta la stessa cronologia, la stessa salute della batteria e le stesse viste di diagnosi. Va bene caricare l'intera cattura della sessione; i prompt e l'output di help attorno al dump vengono ignorati.
L'intestazione Printing N of M log entries del dump dice quante righe contiene il log; dopo l'analisi confrontiamo quel numero con quante ne abbiamo lette, e segnaliamo il report come sospetto incompleto se la cattura sembra troncata, così uno scorrimento del terminale tagliato non passa mai in silenzio come cronologia completa.
Sicurezza e avvertenze
- Il consenso della community è che parlare con la tua MBB o il tuo BMS è a tuo rischio e può avere effetti sulla garanzia.
- Usa un adattatore seriale a logica 3,3 V; gli adattatori TTL solo a 5 V risultano non funzionare. Lascia scollegato il filo +5 V dell'adattatore così niente alimenta la moto in senso inverso.
- Per la sessione la moto deve avere il quadro acceso. I dump lunghi possono durare più del timeout di inattività (il valore predefinito Gen2
secidleè 7200 s); il consiglio della community durante le estrazioni lunghe è dare ogni tanto un colpo di gas per tenere sveglia la moto. - Stai lontano dai comandi distruttivi elencati sopra; esegui solo i dump in sola lettura.
- Buon senso (non è una procedura con fonte): scollega il cavo prima di partire.
- Per chi smanetta sulle Gen1 toccando direttamente i connettori della scheda MBB: attenzione al connettore J5 ad alta tensione, che può bruciare i tuoi strumenti.
Domande frequenti
Mi serve una password per scaricare i log di una Zero Motorcycle dalla console?
Sulle Gen2 i comandi in sola lettura come help, status ed eventlogdump funzionano senza accesso. Esiste un comando login per cambiare la configurazione, ma le sue password non sono pubblicate. Non è documentato se i comandi di dump Gen3 richiedano prima un login.
Un normale scanner OBD-II (ELM327) funziona su una Zero Motorcycle?
No. Zero usa la forma del connettore OBD-II ma collega pin riservati al costruttore a una console seriale a livello TTL, non ai protocolli OBD-II standard. Ti serve un adattatore seriale USB-TTL da 3,3 V e un programma di terminale, non uno strumento di scansione.
Posso raggiungere la console con il Bluetooth integrato della moto?
Non esiste un modo documentato. La radio integrata della moto è documentata solo come al servizio dell'app mobile ufficiale Zero, su seriale Bluetooth classico (SPP) sulle Gen2 e su Bluetooth LE sulle Gen3. La console via Bluetooth è documentata solo con dongle di inoltro del mercato post-vendita inseriti nella porta OBD-II, e quelli si accendono solo sulle moto MY2012-2016.
Quale file carico su Zero Logs Analyzer dopo un dump dalla console?
Carica l'intera cattura della sessione PuTTY (putty.log o un qualsiasi file .txt/.log). I prompt e l'output di help attorno al dump vanno bene: il parser trova da solo la tabella delle righe di log. Scegli la tua moto o inserisci il VIN durante il caricamento, perché le catture di testo non lo contengono in modo affidabile.
Un dump dalla console è meglio dei file .bin dell'app Zero?
Sono supportati entrambi. Un dump dalla console arriva completamente decodificato come testo semplice e la sua intestazione «Printing N of M log entries» dice esattamente quante righe hai catturato, il che lo rende un controllo incrociato affidabile quando i download dall'app falliscono o si troncano in silenzio.
Nota: zeromanual.com ogni tanto non è raggiungibile; se un link della wiki non funziona, la Wayback Machine ha copie di ogni pagina citata qui sotto.
Fonti:
- ZeroManual: Gen2 MBB Console (si apre in una nuova scheda)
- ZeroManual: Gen3 MBB Console (si apre in una nuova scheda)
- ZeroManual: How to build a cable to access the MBB (si apre in una nuova scheda)
- ZeroManual: OBD-II Port (si apre in una nuova scheda)
- ZeroManual: OBD-II Port Location (si apre in una nuova scheda)
- ZeroManual: Logs (si apre in una nuova scheda)
- ZeroManual: Official Mobile Application (si apre in una nuova scheda)
- ZeroManual: DigiNow Data Reaper Dongle (si apre in una nuova scheda)
- EMF: List of existing commands for the Zero MBB and BMS (si apre in una nuova scheda)
- EMF: Zero SR/F MY2020 OBD cable to serial console (si apre in una nuova scheda)
- Zero/NHTSA service bulletin SV-ZMC-020-405 (SR/F log pulls, ZDU) (si apre in una nuova scheda)
- PuTTY manual, ch. 4.2: session logging (si apre in una nuova scheda)
I dettagli sull'accesso alla console si basano sulla documentazione e sul reverse engineering della community, soprattutto sulla Unofficial Zero Manual. Zero Motorcycles non supporta ufficialmente l'accesso alla console da parte dei proprietari, quindi procedi a tuo rischio.