Zero Logs
Back to Learn Hub
Log File Structure

How Zero Logs Work

Understand the structure of MBB and BMS log files, how they're generated, and what data they contain.

TL;DR

Zero stores diagnostic data in binary .bin files: MBB logs contain riding data (motor, controller, speeds), while BMS logs track battery state (cell voltages, SOC, charging). Both include timestamped entries that this tool parses into human-readable format.

Two Types of Logs

Zero Motorcycles have two independent logging systems, each tracking different aspects of the bike's operation:

MBB Logs

Main Bike Board — The central controller that manages motor operation, display, and system coordination.

Contains:
  • • Motor temperature & RPM
  • • Controller temperature
  • • Speed and odometer
  • • Battery amps (current draw)
  • • Ambient temperature
  • • System events & errors
Filename pattern:
VIN_MBB0_YYYY-MM-DD.bin

BMS Logs

Battery Management System — Dedicated controller for battery monitoring, protection, and charging management.

Contains:
  • • Cell voltages (L, l, H)
  • • State of Charge (SOC)
  • • Pack voltage
  • • Cell balance delta
  • • Pack & board temperature
  • • Charging events
Filename pattern:
VIN_BMS0_YYYY-MM-DD.bin

Log Entry Structure

Each log entry contains a timestamp, event type, and message with structured data. Here's how they look when parsed:

Raw log line:
level 001 AH, SOC: 97%, I: 0A, L:4089, l:4076, H:4092, B:003, PT:017C, BT:031C, PV:114540, M:Bike On
Click any field to see explanation:
Categories:
battery
temperature
motor
system
cells

Common Event Types

Event TypeSourceDescription
DischargeBMSRiding data with battery state
ChargedBMSCharging completed event
RidingMBBActive riding metrics
SystemMBBPower on/off, mode changes
ChargingMBBCharge session data
ErrorBothFault codes and warnings

How to Extract Logs

Log files can be extracted from your Zero using the official mobile app or by connecting directly to the bike's diagnostic port. The ZeroManual Interfacing Guide provides detailed instructions.

1
Via Zero Mobile App

Connect to your bike via Bluetooth, navigate to diagnostics, and export logs.

2
Via Diagnostic Port

Direct USB connection using tools documented in the community wiki.

3
Upload to Zero Logs Analyzer

Our tool parses the binary data into structured, searchable entries.

Sources:

Back to HubNext: Battery Basics

Log format details are based on community reverse-engineering. For official documentation, contact Zero Motorcycles.