Comment fonctionnent les logs Zero
Comprenez la structure des fichiers de log MBB et BMS, comment ils sont générés et les données qu’ils contiennent.
En bref
Zero enregistre ses données de diagnostic dans des fichiers binaires .bin : les logs MBB contiennent les données de roulage (moteur, contrôleur, vitesses), tandis que les logs BMS suivent l’état de la batterie (tensions de cellule, SOC, recharge). Les deux contiennent des entrées horodatées que cet outil analyse pour les rendre lisibles.
Format de log par génération
« Gen2 » et « Gen3 » désignent ici des formats de log (la structure binaire que le fichier utilise), pas la génération de produit de la moto. Les deux ne coïncident pas modèle par modèle, et la comparaison des générations démêle les trois sens du mot.
Prise en charge complète : format Gen2
Les dumps MBB\0 / BMS\0 de 262 144 octets : FX (2014-2025), FXS (2016-2021), FXE (2022-2025) et les S, SR, DS et DSR de plateforme SDS (2014-2023), plus les variantes FXP, XU et MX. Contrôleur Sevcon Gen4, analyse complète MBB/BMS. La FXE passe par la voie Gen3 dans notre parseur, mais reste une moto Cypher II. Nous n’avons aucun log d’une S, SR, DS ou DSR 2024 ou plus récente (ce sont des machines Cypher III) : le format qu’elles écrivent n’est donc pas vérifié ici.
Prise en charge complète : format Gen3
Le tampon circulaire 0xB2 natif : SR/F et SR/S à partir de 2020, DSR/X à partir de 2023, avec MBB et BMS entièrement décodés. Sessions de trajet et sessions de recharge, tensions de cellule, températures, machine à états : tout est analysé. Remarque : Gen3 utilise un tampon circulaire qu’une moto à l’arrêt remplit en environ 3 jours : le MBB se réveille une fois par heure et écrit environ 31 entrées à chaque fois. Téléchargez vos logs souvent pour conserver l’historique des trajets.
Deux types de logs
Les Zero Motorcycles ont deux systèmes de journalisation indépendants, chacun suivant un aspect différent du fonctionnement de la moto :
Logs MBB
Main Bike Board : le contrôleur central qui gère le fonctionnement du moteur, l’affichage et la coordination du système.
- • Température et régime du moteur
- • Température du contrôleur
- • Compteur kilométrique
- • Ampères de la batterie et du moteur
- • Tension de la batterie, SOC et masque binaire des modules
- • Température ambiante
- • Événements et erreurs système
Aucun log Gen1 ou Gen2 ne contient de champ de vitesse sur route. Là où vous voyez des km/h sur ces motos, ils ont été calculés à partir du régime moteur avec une constante propre à chaque modèle. La position de la poignée des gaz n’est jamais enregistrée non plus.
Sur les Gen3 FST (SR/F, SR/S, DSR/X), le MBB journalise l’état de la moto et les limites de puissance, et son enregistrement de télémétrie courant porte cinq températures et, seulement tant que le bus haute tension est sous tension, la tension de la batterie, le courant et le régime moteur. La vitesse sur route n’est écrite que dans les enregistrements 0x52/0x53, plus rares, et le compteur kilométrique seulement là et seulement sur un firmware plus récent : le BMS reste donc la source principale des voies électriques.
Il n’y a pas de chiffre après MBB. Une moto a une seule carte principale : le fichier MBB ne porte donc aucun index. Sur un corpus de 352 fichiers, ce sont les formes qui existent, à un téléchargement près qui arrive avec des tirets au lieu de tirets bas ou avec un suffixe _1 de copie. MbbD est l’export de l’outil du concessionnaire pour la même carte ; les deux formes qui commencent par la date sont celles qu’émettent les Gen3 FST, où _6 est le MBB et _10 le BMS.
Logs BMS
Battery Management System : un contrôleur dédié à la surveillance, à la protection et à la gestion de la recharge de la batterie.
- • Tensions de cellule (L, l, H)
- • État de charge (SOC)
- • Tension de la batterie
- • Écart d’équilibrage des cellules
- • Température de la batterie et de la carte
- • Événements de recharge
Le chiffre est l’index du module de batterie, ce qui explique qu’il puisse y avoir plus d’un fichier BMS. Détails plus bas.
Voici une seconde d’un vrai arrêt, avec les deux cartes qui écrivent en même temps. Elles journalisent la même ouverture du contacteur sous deux noms différents, et chaque carte mesure la même tension de batterie avec son propre instrument.
Tiré de Anatomie d’un log Zero, qui publie de vrais extraits pour chaque voie de décodage : mise sous tension, roulage, recharge, arrêt, défaut et extinction.
Si votre moto a deux modules de batterie, elle écrit deux fichiers BMS, et n’en importer qu’un laisse de côté la moitié de votre batterie
Chaque module de batterie fait tourner son propre BMS et garde son propre log : l’index dans le nom de fichier compte donc des modules, pas des fichiers. Dans notre corpus de 352 fichiers, la répartition est BMS0 ×109, BMS1 ×78 et BmsD0 ×17. Une FXS 2016 avec la batterie ZF6.5 à deux modules émet BMS0 ×61 et BMS1 ×61, couvrant les mêmes jours dans des fichiers séparés. Une FXE avec la ZF7.2 intégrée émet BMS0 seulement.
Le log MBB concorde, ce qui permet de le vérifier sans compter les fichiers. Sur la FXS à deux modules, le MBB journalise Module 00 Registered et Module 01 Registered, et chaque entrée de roulage porte un masque binaire de modules qui indique mods 11. Sur la FXE, seul Module 00 s’enregistre jamais et le masque indique mods 10, ce qui veut dire un seul module présent. Ce seul caractère fait la différence entre une batterie faite de deux briques amovibles et une batterie intégrée qui porte le même badge en kWh.
L’index n’est un nombre de modules que sur la famille FX / XMX, où les modules sont amovibles et où la numérotation commence à zéro. Les Gen3 FST (SR/F, SR/S, DSR/X) de ce corpus n’émettent qu’un seul BMS1 sans BMS0 : leur numérotation commence simplement à un, et elles ont une seule batterie monobloc. Si vous avez une FST, un seul fichier BMS dit tout.
Quand vous exportez vos logs, prenez chaque fichier que l’appli ou l’outil du concessionnaire vous propose et importez-les tous. Voir le catalogue des batteries pour savoir quelles batteries sont modulaires.
Structure d’une entrée de log
Chaque entrée de log contient un horodatage, un type d’événement et un message avec des données structurées. Voici à quoi elles ressemblent une fois analysées :
level 001 AH, SOC: 97%, I: 0A, L:4089, l:4076, H:4092, B:003, PT:017C, BT:031C, PV:114540, M:Bike OnTypes d’événements courants
Ce sont les chaînes exactes que le décodeur émet : ce sont donc celles que vous pouvez chercher et filtrer. Les décomptes proviennent de 92 407 entrées décodées à partir de quatorze vrais fichiers de log.
| Type d’événement | Source | Ce que c’est |
|---|---|---|
| Riding | MBB | L’instantané de roulage une fois par minute : SOC, tension de la batterie, courant de la batterie et du moteur, régime moteur, les quatre températures, compteur kilométrique et masque de bits des modules. |
| Charging | MBB | Le même instantané, enregistré pendant que la moto se recharge. |
| Disarmed | MBB | Moto réveillée mais pas active : la même télémétrie avec le moteur à l’arrêt. |
| Board Status | MBB | Rapport de santé périodique de la carte principale. |
| Power On / Power Off | MBB | Transitions de la clé. Associées à Sevcon Turned On / Sevcon Turned Off, elles encadrent un trajet sur une moto Gen1/Gen2. |
| Module 00 … / Module 01 … | MBB | Événements de batterie par module : Registered, CAN Link Up/Down, Closing/Opening Contractor. L’indice est le numéro du module. |
| Discharge level | BMS | La ligne de télémétrie centrale du BMS : ampères-heures, SoC, courant, les tensions de cellule L / l / H, l’écart d’équilibrage B, température de la batterie et de la carte. |
| SOC Data | BMS | Comptabilité de l’état de charge à côté des lignes de décharge. |
| Charged To Full | BMS | Recharge terminée. Il n’existe pas d’événement appelé « Charged ». |
| Entered Idle / Running / Standby / Charging State | BMS | Transitions de la machine à états du BMS, plus Entering Hibernate / Exiting Hibernate. |
| Discharge Cutback | BMS | Le BMS limite le courant de décharge (SOC bas, batterie froide ou cellule faible). |
| Chassis Isolation Fault | BMS | L’isolement entre la batterie HT et le châssis a baissé. Aussi vu sous le nom Low Chassis Isolation. |
Des noms qui paraissent plausibles mais n’existent pas, si bien que les chercher ne renvoie rien : Charged, System, Error, Charge level, Chg complete, Balancing. Les défauts ne forment pas un type d’événement : ils apparaissent sous leurs propres noms descriptifs, et c’est pourquoi le catalogue des erreurs de log les regroupe en familles plutôt que de filtrer sur un seul mot-clé.
Comment extraire les logs
Les fichiers de log peuvent être extraits de votre Zero avec l’appli mobile officielle ou en se connectant directement au port de diagnostic de la moto. Le guide d’interface de ZeroManual donne des instructions détaillées.
Connectez-vous à votre moto en Bluetooth, allez dans les diagnostics et exportez les logs.
Un câble série branché sur le port OBD-II de la moto vous donne tout l’historique des logs en texte brut, ce qui aide quand le téléchargement par l’appli échoue ou tronque. Voyez notre guide pas à pas de la console PuTTY ; la capture .txt/.log obtenue s’importe ici comme un fichier .bin.
Notre outil analyse les données binaires pour en faire des entrées structurées et consultables.
Sources :
Les détails du format de log reposent sur de la rétro-ingénierie communautaire. Pour la documentation officielle, contactez Zero Motorcycles.