Lettore di log Zero
Lascia il .bin che ti ha dato la moto o il concessionario e leggilo come testo semplice in questa scheda, poi scarica il .txt.
Il tuo file non viene caricato. Lo decodifica JavaScript nel tuo browser.
Vedrai un po' di traffico del sito stesso: la pagina carica i propri script e i propri font, prepara alcune delle proprie pagine (gli avvisi su cookie e privacy) e carica Google Analytics se hai accettato i cookie di analisi. Niente di tutto questo porta il tuo log. Il decodificatore stesso non contiene fetch, né XMLHttpRequest, né WebSocket né beacon: il file si legge con File.arrayBuffer(), si decodifica in memoria e si scrive su un URL blob: (un riferimento in memoria, non una richiesta) quando lo scarichi. Chiudi la scheda e non c'è più. Non salviamo niente della tua moto, e non c'è un account da creare.
L'altra metà della privacy è quel che pubblichi tu, quindi questa pagina parte con Nascondi gli identificativi già spuntato: il VIN e il seriale della scheda sono sostituiti con X nel risultato, nel testo decodificato, nel .txt e nel nome con cui il file viene salvato, perché un export Zero è nominato dal suo VIN e il solo nome del file identifica la moto. Togli la spunta per leggere il tuo log per intero: la decodifica non nasconde niente.
Cosa esce, e cosa no
Tre delle quattro famiglie di log che Zero ha messo in vendita si decodificano qui, con le stesse mappe di campi della pipeline sul server. La quarta si identifica e si passa allo strumento giusto. Il lettore ti dice quale hai lasciato, e perché ha deciso così, prima che tu legga una sola voce.
| Famiglia | Moto | Qui | Cosa ottieni |
|---|---|---|---|
| Gen3 MBB | Cypher III: SR/F, SR/S, DSR/X | Letto | L'intestazione del file (il VIN, affidabile solo se la cifra di controllo è valida, il modello e la build del firmware), gli eventi di testo, la macchina a stati, lo stato di carica e cinque temperature; giri motore, tensione e corrente del pacco solo mentre il bus ad alta tensione è vivo; velocità su strada e, sul firmware più recente, il contachilometri dai record più rari 0x52/0x53. Il log BMS resta la fonte elettrica più densa. |
| Gen3 BMS | Cypher III battery boards | Letto | Minimo e massimo di cella, stato di carica, corrente e tensione del pacco, la macchina a stati del BMS e il registro di capacità a piena carica. Niente temperatura del pacco: il byte letto una volta come tale è stato ritirato. |
| 538XX-firmware MBB | Gen2-era bikes carrying the Gen3-style body | Letto | Tensione del pacco, corrente di batteria e motore, giri motore, cinque temperature, stato di carica e il contachilometri in ogni record di telemetria. Non c'è la velocità su strada, perché questo record non la porta. |
| Gen1 / Gen2 | Cypher II / SDS: S, SR, DS, DSR through 2023, and the FX/FXS/FXE light bikes | Riconosc. | Riconosciuto e identificato (tornano intestazione, VIN e scheda), ma le voci qui non si decodificano. Sotto trovi cosa farne. |
Perché Gen1/Gen2 non si legge qui
Gen2 sparge la telemetria che questa porta legge su quattro tipi di record (0x2c, 0x3c, 0x2d e 0x33), e la porta nel browser ne legge uno. I suoi eventi tipizzati (Riding, Charging, Discharge level, SOC Data) hanno bisogno di una tabella di messaggi che questa porta non ha.
Pubblicarlo comunque recupererebbe lo 0,73% delle righe di tensione del pacco, lo 0,96% della corrente, lo 1,12% dello stato di carica e niente da un file BMS (misurato, non stimato). Una decodifica così sottile, venduta come supporto, sarebbe peggio che rifiutare il file.
Due cose leggono questi file: zero-log-parser, che gira sulla tua macchina come strumento da riga di comando, e l'analizzatore completo qui, che fa girare lo stesso motore lato server. Carica il file e lo legge per bene.
Dice cosa non ha letto
Ogni decodifica stampa la propria diagnostica, mai dietro un interruttore: la strategia di framing, quanti delimitatori 0xB2 ha trovato, quanti sono diventati record e, a parte, perché gli altri no. Uno slot di flash cancellato non è un record strappato, e un decodificatore che li riportasse come un solo numero nasconderebbe la differenza.
Misurato su un log 538XX reale da 256 KB: 7.776 delimitatori, 6.458 record incorniciati, 1.211 slot di flash cancellati, 106 timestamp fuori finestra, un record troppo corto e uno con una lunghezza implausibile. Stampati anche: un istogramma dei tipi di record, e ogni valore di campo che un controllo di intervallo fisico ha rifiutato invece di indovinare.
La stessa decodifica è stata controllata campo per campo contro il parser Python che fa girare la nostra pipeline, su 352 file di log reali e 1.190.446 voci, con zero divergenze. È una garanzia di portabilità, non di correttezza: dove il decodificatore del server sbaglia, questo sbaglia allo stesso modo, ed è questo che lo rende un controllo incrociato utile.
Un log Gen3 valido può non avere giri
Un risultato vuoto non vuol dire che il lettore è rotto. Ogni scheda Gen3 tiene un proprio buffer ad anello di ~128 KB con circa 2.300 voci. Una moto parcheggiata non sta ferma: il MBB si sveglia circa una volta all'ora e scrive una mediana misurata di 31 voci a ogni risveglio, quindi una moto lasciata sola riempie il buffer di ibernazione in circa tre giorni (3,25 al tasso mediano misurato), e tutto quel che è più vecchio viene sovrascritto, dal più vecchio.
Quindi un file esportato una settimana dopo l'ultimo giro può decodificarsi bene e contenere solo ibernazione. I giri erano già spariti prima che lasciassi il file. Esporta entro un giorno o due dal giro per tenerli, e leggi perché il log Gen3 non mostra giri per riconoscere un buffer che si è già richiuso.
Cosa dà un account
Niente di quanto sopra è tenuto da parte per quello. Il lettore ti dà ogni voce che sa decodificare, la diagnostica intera e il .txt completo, senza registrazione e senza tetto. Un account serve per l'unica cosa che un solo file non può darti: un solo file è una finestra di tre giorni su una Gen3 parcheggiata, perché è la moto a sovrascriverlo.
Storico dei file
Ogni export che tieni si cuce in una cronologia continua per VIN, e i file che si sovrappongono si deduplicano invece di contare due volte.
Giri e ricariche
Le sessioni si rilevano dalla telemetria, con distanza, energia e durata per ciascuna, comprese le ricariche che il sensore di corrente era troppo rado per registrare direttamente.
Salute batteria e guasti
Capacità utile del pacco misurata da ricariche vere contro il dato di targa, sbilanciamento delle celle nel tempo, e codici di errore raggruppati in riscontri.
I log caricati li legge anche un passaggio di AI che spiega i guasti e lo stato del pacco in parole semplici. A differenza del lettore di questa pagina, la pipeline completa legge anche i file Gen1/Gen2.
Come sono fatti questi file
Tutto quel che fa questo lettore è documentato, fino agli offset di byte che legge.
Gen3 log format: the 0xB2 record spec
La specifica a livello di byte che questo decodificatore implementa: framing dei record, mappe dei record MBB e BMS, e la misura dietro ogni offset.
Log Gen2 e Gen3: differenze
Su quale piattaforma è la tua moto, cosa salva ogni generazione, e perché una delle due ha bisogno di un motore diverso per essere letta.
Perché il log Gen3 non ha giri
Come il buffer ad anello si sovrascrive, come riconoscere un log che si è già richiuso, e quando esportare perché non lo abbia fatto.
Non hai un file di log? Come esportarne uno dall'app Zero, oppure tira un dump di testo direttamente dalla moto con una console seriale.
Domande frequenti
Il file di log viene caricato?
No. Il decodificatore è JavaScript che gira nella tua scheda. Il file si legge con l'API file del browser, si decodifica in memoria e si mostra da un URL blob quando lo scarichi. Nel decodificatore e nella libreria di decodifica non ci sono fetch, XHR, WebSocket né beacon, quindi non c'è una richiesta da intercettare. Apri gli strumenti del browser, seleziona Rete, poi lascia il file: il log non compare mai nell'elenco. Il traffico che vedi è il sito che carica i propri script e prepara le proprie pagine, mai il tuo file.
Quali log Zero decodifica questo lettore?
MBB Gen3, BMS Gen3 e la variante MBB con firmware 538XX si decodificano per intero, con le stesse mappe di campi della pipeline sul server. I log Gen1/Gen2 (Cypher II / SDS) si riconoscono e si identificano, ma non si decodificano nel browser. Dei 352 file di log reali contro cui è stato controllato questo decodificatore, 67 si decodificano qui, per 317.124 voci.
Il log Gen3 è letto ma senza giri. È rotto?
No. I giri erano già spariti dal file. Le schede Gen3 scrivono in un buffer ad anello fisso che si sovrascrive dal più vecchio. Una moto parcheggiata si sveglia circa una volta l'ora e scrive una mediana di 31 voci, quindi circa tre giorni da ferma riempiono il buffer di ibernazione e spingono fuori tutto quel che è più vecchio. Esporta entro un giorno o due da un giro per tenere il giro nel file.
Leggo qui un log Gen1/Gen2 (S, SR, DS, DSR, FX)?
Il lettore lo identifica e ti dice cos'è, ma non decodifica le voci. Gen2 salva messaggi a lunghezza variabile con un tipo, non il buffer ad anello 0xB2 che legge questa porta. Fai girare in locale il progetto zero-log-parser a monte, oppure carica il file nell'analizzatore completo qui, che fa girare quel motore lato server.
La data di build del firmware dice se il log si decodifica?
No, anche se sembra di sì. Nel corpus di 352 file, 135 portano una data di build nell'intestazione. Nessun anno di soglia separa i file che si decodificano da quelli che no: la soglia migliore ne classifica male ancora undici, perché una moto Gen2 può avere firmware costruito nel 2024 e una moto Gen3 firmware costruito nel 2019. Il lettore decide guardando il file, e ti dice quale regola è scattata, in circa venti millisecondi.
Mi serve un account per usarlo?
No. Non c'è registrazione, non c'è un tetto sulla dimensione oltre un rifiuto a 32 MB che protegge il tuo browser, non c'è filigrana e non c'è un output tagliato. Un account serve per quel che un file non può darti: uno storico cucito fra più export per VIN, le sessioni, la salute della batteria, i guasti e l'analisi AI. Questa conversione non ne ha bisogno.
Cosa c'è nel .txt che scarico?
Un blocco di intestazione (file sorgente, dimensione, tipo di log, VIN, modello, scheda, firmware, seriale), poi ogni voce decodificata come tabella con data e ora, poi un riepilogo di decodifica con la strategia di framing, quanti record 0xB2 sono stati incorniciati, perché gli altri no, un istogramma dei tipi di record e i valori che ogni controllo di plausibilità ha rifiutato. I timestamp sono UTC, esattamente come salvati nel record, senza fuso applicato. «Nascondi gli identificativi» parte già spuntato su questa pagina, quindi il VIN e il seriale della scheda sono sostituiti con X nel blocco di intestazione, nel testo delle voci e nel nome con cui si salva il download. Togli la spunta per avere il log per intero.
Quanto è lungo il testo?
Misurato su log reali: un export MBB Gen3 da 128 KB con 2.535 voci produce circa 226 KB di testo, un export BMS Gen3 da 128 KB con 899 voci circa 81 KB, e un export MBB 538XX da 256 KB con 4.269 voci circa 732 KB. Un file Gen1/Gen2 produce un rapporto di identificazione da 1,3 KB invece di una tabella di voci.