Vai al contenuto
zerologs
Torna all'indice delle guide
Struttura dei file di log

Come funzionano i log Zero

Capisci com'è fatto un file di log MBB e BMS, come viene generato e quali dati contiene.

Ultimo aggiornamento: 3 ottobre 2026

In breve

Zero salva i dati diagnostici in file binari .bin: i log MBB contengono i dati di guida (motore, controller, velocità), mentre i log BMS seguono lo stato della batteria (tensioni delle celle, SOC, ricarica). Entrambi hanno righe con data e ora che questo strumento converte in un formato leggibile.

Formato dei log per generazione

«Gen2» e «Gen3» qui indicano i formati di log (quale struttura binaria usa il file), non la generazione di prodotto della moto. Le due non coincidono modello per modello, e il confronto tra generazioni districa i tre sensi della parola.

Supporto completo: formato Gen2

Gli export da 262.144 byte MBB\0 / BMS\0: FX (2014-2025), FXS (2016-2021), FXE (2022-2025) e le S, SR, DS e DSR della piattaforma SDS (2014-2023), più le varianti FXP, XU e MX. Controller Sevcon Gen4, analisi completa di MBB e BMS. La FXE passa dal percorso Gen3 nel nostro parser, ma resta una moto Cypher II. Non abbiamo il log di nessuna S, SR, DS o DSR 2024+ (sono macchine Cypher III), quindi quale formato scrivano qui non è verificato.

Supporto completo: formato Gen3

Il buffer circolare nativo 0xB2: SR/F e SR/S dal 2020, DSR/X dal 2023, con MBB e BMS decodificati per intero. Sessioni di giro e sessioni di ricarica, tensioni delle celle, temperature e macchina a stati sono tutte analizzate. Nota: la Gen3 usa un buffer circolare che una moto ferma riempie in circa 3 giorni: la MBB si sveglia una volta all'ora e scrive ~31 voci ogni volta. Scarica i log spesso per catturare la cronologia dei giri.

Due tipi di log

Le Zero Motorcycles hanno due sistemi di registrazione indipendenti, ognuno dei quali segue aspetti diversi del funzionamento della moto:

Log MBB

Main Bike Board: il controller centrale che gestisce il motore, il display e il coordinamento del sistema.

Contiene (Gen1 / Gen2):
  • • Temperatura e giri del motore
  • • Temperatura del controller
  • • Contachilometri
  • • Ampere della batteria e del motore
  • • Tensione del pacco, SOC e la maschera dei moduli
  • • Temperatura ambiente
  • • Eventi di sistema ed errori

Nessun log Gen1 o Gen2 contiene un campo di velocità su strada. Dove su quelle moto vedi i km/h, sono calcolati dai giri del motore con una costante per modello. Neanche la posizione dell'acceleratore viene mai registrata.

Sulle Gen3 FST (SR/F, SR/S, DSR/X) la MBB registra lo stato della moto e i limiti di potenza, e il suo record di telemetria comune porta cinque temperature e, solo mentre il bus ad alta tensione è attivo, tensione del pacco, corrente e giri del motore. La velocità su strada è scritta solo nei record più rari 0x52/0x53, e il contachilometri solo lì e solo sul firmware più recente, quindi il BMS resta la fonte principale per i canali elettrici.

Schemi di nome file (tutti reali):
VIN_MBB_YYYY-MM-DD.bin
VIN_MbbD_YYYY-MM-DD.bin
YYYYMMDD_HH.MM_VIN_MBB.bin
YYYYMMDD_HH.MM_VIN_6.bin

Dopo MBB non c'è nessuna cifra. Una moto ha una sola scheda principale, quindi il file MBB non porta un indice. In un corpus di 352 file queste sono le forme che ricorrono, a parte un download che arriva con i trattini al posto dei trattini bassi o con un suffisso di copia _1. MbbD è l'export dello strumento da concessionario della stessa scheda; le due forme che iniziano con la data sono quelle che emettono le Gen3 FST, dove _6 è la MBB e _10 il BMS.

Log BMS

Battery Management System: un controller dedicato al monitoraggio, alla protezione e alla gestione della ricarica della batteria.

Contiene:
  • • Tensioni delle celle (L, l, H)
  • • Stato di carica (SOC)
  • • Tensione del pacco
  • • Scarto di bilanciamento delle celle
  • • Temperatura del pacco e della scheda
  • • Eventi di ricarica
Schemi di nome file (tutti reali):
VIN_BMS0_YYYY-MM-DD.bin
VIN_BMS1_YYYY-MM-DD.bin
VIN_BmsD0_YYYY-MM-DD.bin
YYYYMMDD_HH.MM_VIN_10.bin

La cifra è l'indice del modulo batteria, ed è per questo che i file BMS possono essere più di uno. Dettagli qui sotto.

Ecco un secondo di uno spegnimento vero, con entrambe le schede che scrivono insieme. Registrano la stessa apertura del contattore con due nomi diversi, e ogni scheda misura la stessa tensione del pacco con il proprio strumento.

Lo stesso istante, due volteFXS 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 OffUn contattore, due vocabolariLe due righe evidenziate sono lo stesso pezzo dihardware che si apre, chiamato in modo diverso.1 mV apart: two voltmetersbattery management107.997 Vmain board · module 00107.998 Vmain board · module 01107.971 VDue moduli in parallelo: una sola tensione del pacco,read three times. And 740 seconds in this pair ofi file portano righe da entrambe le schede.
Lo stesso contattore, lo stesso secondo, due nomi e due voltmetri indipendenti a 1 mV di distanza. Mostra perché una Zero ti dà due file: nessun file dice che i due eventi sono la stessa cosa, quindi sei tu a doverli mettere su un solo asse. Questo secondo è ordinario e non raro: 740 secondi in questa coppia portano righe da entrambe le schede.

Da Anatomia di un log Zero, che pubblica estratti reali per ogni percorso di decodifica: accensione, guida, ricarica, sosta, un guasto e spegnimento.

Se la tua moto ha due moduli batteria scrive due file BMS, e caricarne uno solo lascia fuori metà del pacco

Ogni modulo batteria ha il proprio BMS e tiene il proprio log, quindi l'indice nel nome del file conta i moduli, non i file. Nel nostro corpus di 352 file la ripartizione è BMS0 ×109, BMS1 ×78 e BmsD0 ×17. Una FXS del 2016 con il pacco ZF6.5 a due moduli emette BMS0 ×61 e BMS1 ×61, che coprono gli stessi giorni in file separati. Una FXE con il ZF7.2 integrato emette BMS0 soltanto.

Il log MBB è d'accordo, ed è così che puoi verificarlo senza contare i file. Sulla FXS a due moduli la MBB registra Module 00 Registered e Module 01 Registered, e ogni riga di guida porta una maschera dei moduli con valore mods 11. Sulla FXE si registra solo Module 00 e la maschera vale mods 10, cioè un solo modulo presente. Quel singolo carattere è la differenza tra un pacco fatto di due mattoni rimovibili e un pacco integrato con lo stesso badge in kWh.

L'indice è un conteggio dei moduli solo sulla famiglia FX / XMX, dove i moduli sono rimovibili e la numerazione parte da zero. Le Gen3 FST (SR/F, SR/S, DSR/X) di questo corpus emettono un solo BMS1 senza BMS0: la loro numerazione parte semplicemente da uno, e hanno un solo pacco incollato. Se hai una moto FST, un solo file BMS è tutta la storia.

Quando esporti i log prendi ogni file che l'app o lo strumento da concessionario ti offre e caricali tutti. Vedi il catalogo dei pacchi per sapere quali pacchi sono modulari.

Struttura di una riga di log

Ogni riga di log contiene una data e ora, un tipo di evento e un messaggio con dati strutturati. Ecco come appaiono una volta analizzate:

Riga di log grezza:
level 001 AH, SOC: 97%, I: 0A, L:4089, l:4076, H:4092, B:003, PT:017C, BT:031C, PV:114540, M:Bike On
Clicca su un campo per vedere cosa significa:
Categorie:
battery
temperature
motor
system
cells

Tipi di evento comuni

Queste sono le stringhe esatte che emette il decodificatore, quindi sono quelle su cui puoi cercare e filtrare. I conteggi vengono da 92.407 righe decodificate da quattordici file di log reali.

Tipo di eventoOrigineCos'è
RidingMBBL'istantanea di guida una volta al minuto: SOC, tensione del pacco, corrente di batteria e motore, giri del motore, tutte e quattro le temperature, contachilometri e maschera dei moduli.
ChargingMBBLa stessa istantanea, registrata mentre la moto è in ricarica.
DisarmedMBBMoto sveglia ma non attiva: telemetria identica con il motore fermo.
Board StatusMBBRapporto periodico sullo stato dalla scheda principale.
Power On / Power OffMBBTransizioni della chiave. Abbinate a Sevcon Turned On / Sevcon Turned Off, delimitano un giro su una moto Gen1/Gen2.
Module 00 … / Module 01 …MBBEventi della batteria per modulo: Registered, CAN Link Up/Down, Closing/Opening Contractor. L'indice è il numero del modulo.
Discharge levelBMSLa riga di telemetria BMS di base: amperora, SOC, corrente, le tensioni di cella L / l / H, il delta di bilanciamento B, temperatura del pacco e della scheda.
SOC DataBMSContabilità dello stato di carica accanto alle righe di scarica.
Charged To FullBMSRicarica completata. Non esiste nessun evento chiamato «Charged».
Entered Idle / Running / Standby / Charging StateBMSTransizioni della macchina a stati del BMS, più Entering Hibernate / Exiting Hibernate.
Discharge CutbackBMSIl BMS sta limitando la corrente di scarica (SOC basso, pacco freddo o una cella debole).
Chassis Isolation FaultBMSL'isolamento tra il pacco AT e il telaio è calato. Si vede anche come Low Chassis Isolation.

Nomi che suonano plausibili ma non esistono, quindi cercarli non restituisce niente: Charged, System, Error, Charge level, Chg complete, Balancing. I guasti non sono un unico tipo di evento: compaiono con i loro nomi descrittivi, ed è per questo che il catalogo degli errori nei log li raggruppa in famiglie invece di filtrare su una sola parola chiave.

Come estrarre i log

I file di log si possono estrarre dalla tua Zero con l'app mobile ufficiale o collegandosi direttamente alla porta diagnostica della moto. La guida ZeroManual Interfacing dà istruzioni dettagliate.

1
Con l'app mobile Zero

Collegati alla moto via Bluetooth, vai alla diagnostica ed esporta i log.

2
Dalla porta diagnostica (console seriale)

Un cavo seriale alla porta OBD-II della moto ti dà l'intera cronologia dei log come testo semplice, utile quando il download dall'app fallisce o si tronca. Vedi la nostra guida passo passo alla console con PuTTY; la cattura .txt/.log che ne risulta si carica qui come un file .bin.

3
Carica su Zero Logs Analyzer

Il nostro strumento analizza i dati binari e li trasforma in righe strutturate e ricercabili.

I dettagli del formato dei log si basano sul reverse engineering della community. Per la documentazione ufficiale contatta Zero Motorcycles.