Gen2 et Gen3 : différences entre les logs
Comparaison technique des formats de log de Zero Motorcycles selon les générations, fondée sur la rétro-ingénierie et l’analyse de cas réels.
TL;DR
« Gen2 » et « Gen3 » désignent sur cette page un format de log, pas une moto. Les générations de produit de Zero ne correspondent pas à ces formats modèle par modèle, et une troisième numérotation, celle que notre parseur enregistre, diffère encore ; la section ci-dessous distingue les trois.
Les logs au format Gen2 sont des fichiers de 262 144 octets dont les entrées sont des instantanés binaires périodiques qui portent tous les canaux à la fois, et que le parseur restitue sous forme de texte étiqueté. Tous les fichiers que nous détenons pour une S, une SR, une DS ou une DSR (2014-2023) en sont, comme tous ceux d’une FX (2014-2025), d’une FXS (2016-2021) ou d’une FXE (2022-2025). Les logs au format Gen3 sont des tampons circulaires d’enregistrements binaires préfixés par leur longueur (131 200 octets sur le MBB, 131 328 sur le BMS) et viennent des SR/F et SR/S (à partir de 2020) et de la DSR/X (à partir de 2023). Ils diffèrent surtout par ce qu’un décodeur peut en tirer. Une entrée de conduite Gen2 donne, sur une seule ligne, volts, ampères, régime et compteur kilométrique. Un enregistrement MBB Gen3 natif contient bien la tension de la batterie et le courant de batterie, aux positions record[34:38] et record[38:42], lus par notre décodeur depuis le 2026-09-07, mais ils sont vides dans les états d’hibernation et de mise sous tension, qui forment les trois quarts d’un log réel. La vitesse sur route et le compteur kilométrique ne sont pas dans cet enregistrement commun : ils se trouvent en fin des enregistrements plus rares 0x52 et 0x53, et le compteur kilométrique seulement dans la plus récente des deux dispositions de firmware. Un envoi Gen3 a donc encore besoin de son fichier BMS compagnon avant que la plupart des graphiques électriques se remplissent : les valeurs du MBB existent, mais elles sont clairsemées.
Format de fichier
La différence la plus visible, c’est le fichier lui-même : taille, convention de nom et structure interne.
Format Gen2 (instantanés binaires)
Full SupportGen3 (FST / Cypher III)
Full SupportNote : le firmware Gen2 plus récent utilise le nom VIN_MbbD_date.bin (« bb » en minuscules + « D »). Le format est le même ; seule la convention de nom de fichier a changé.
Pourquoi les nombres d’enregistrements de cette page parlent de « découpage par chaîne de longueurs »
Il y a plusieurs façons de compter les enregistrements d’un fichier Gen3, et elles ne concordent pas : chaque population de cette page nomme donc celle qu’elle a utilisée. Le découpage par chaîne de longueurs est celui qu’utilise notre décodeur MBB : à chaque position, l’octet qui suit le délimiteur 0xB2 donne l’étendue de l’enregistrement sur le disque, et l’enregistrement suivant commence exactement autant d’octets plus loin. Compter simplement les octets 0xB2, ou couper sur chacun d’eux, donne des totaux différents. C’est aussi risqué, car 0xB2 est un octet de données légal que l’écrivain échappe en FE 4D (avec FE 01 pour un 0xFE littéral). Délimitez d’abord par la longueur déclarée, puis déséchappez l’enregistrement délimité. Dans les huit exports MBB de pleine taille mesurés ici, 468 des 19 089 enregistrements contiennent un échappement, 477 octets d’échappement au total. C’est peu, mais ils tombent à l’intérieur d’horodatages et de jetons d’état : les ignorer corrompt donc les enregistrements au lieu de les perdre. Les règles au niveau de l’octet figurent dans la spécification du format.
Trois choses s’appellent « génération » ici, et elles ne concordent pas
1 · Génération de produit : ce que Zero a construit, tel que ses propres manuels du propriétaire le disent. Les manuels placent la FX et la FXS en génération 1 (XMX · modulaire) pour toute leur durée de production ; les S, SR, DS et DSR en génération 2 (SDS · Z-Force, Cypher II) de 2014 à 2023 et en génération 3 (FST · Cypher III) à partir de 2024 ; les SR/F et SR/S en génération 3 à partir de 2020 et la DSR/X à partir de 2023 ; la FXE en génération 2 (XMX · modulaire, Cypher II) ; et les LS1, XE et XB 2026 en génération 3 sur les plateformes LS et X. Notre catalogue des motos restitue directement ces fiches.
2 · Génération du format de log : quelle disposition binaire le fichier utilise. C’est ce que décrivent les deux cartes ci-dessus, et c’est le sens que cette page emploie partout sauf indication contraire. Elle traverse les générations de produit : une FX (génération 1 du produit) et une DSR (génération 2 du produit) écrivent le même fichier au format Gen2.
3 · Génération d’aiguillage : le champ log_generation est la valeur que notre parseur enregistre pour votre envoi. Elle dit quel décodeur a tourné, rien de plus.
La FXE est le point où les trois se heurtent
La FXE est une moto Cypher II (sens 1 : génération 2), elle figure dans l’ensemble GEN3_MODELS du parseur, si bien que nous enregistrons log_generation = 3 pour elle (sens 3), et ses fichiers sont des exports ordinaires de 262 144 octets au format MBB\0 / BMS\0 qui se décodent par le chemin du firmware 538XX : un format d’enregistrement de lignée Gen2, pas le format Gen3 natif (sens 2). Les trois affirmations sont vraies à la fois, et une phrase qui en choisit une sans dire de quel sens elle parle est fausse. Aucun fichier FXE de ce corpus n’est un tampon circulaire Gen3 natif.
La mécanique : GEN3_MODELS est {SRF, SRS, SR/F, SR/S, DSRX, DSR/X, FXE} et la liste de veto GEN2_ONLY_MODELS est {S, SR, DS, DSR, FX, FXS, XU}. FXE apparaît dans la première et pas dans la seconde (backend/app/parser.py, lignes 2443 et 2449). Un veto strict se déclenche d’abord si le modèle figure dans la liste Gen2 seule ou si le dixième caractère du VIN est un code d’année de A à J (2010-2018), et seulement ensuite les trois signaux positifs sont consultés : modèle, motif de VIN Gen3, motifs de texte propres au Gen3 sans télémétrie Gen2.
Une conséquence que nous n’avons pas pu tester. La liste de veto contient des noms de modèle nus, sans terme d’année, et les manuels placent les S, SR, DS et DSR à partir de 2024 sur la plateforme FST / Cypher III. Une DSR 2025 serait donc écartée vers le chemin Gen2 sur son seul nom, quel que soit le contenu de son fichier. GEN3_MODELS ne liste non plus aucune LS1, XE ou XB, si bien que la gamme légère 2026 n’a aucune route. Reste à savoir si l’un ou l’autre est un vrai défaut : nous ne pouvons pas le dire, car notre corpus de 352 fichiers ne contient aucune S, SR, DS ou DSR de 2024 ou plus récente ni aucun log de la gamme légère, donc rien à mesurer. Tant qu’un tel fichier n’existe pas, c’est un risque ouvert, et le veto reste tel quel : le commentaire qui le précède dans le parseur consigne une régression qu’il a été écrit pour empêcher. Si vous en avez un, envoyez-le.
Approche de journalisation des données
Gen2 : instantanés périodiques
Gen2 consigne un instantané de télémétrie complet une fois par minute en roulant, et des mises à jour périodiques pendant la recharge et à l’arrêt. Chaque entrée contient toutes les données disponibles, décodées en paires clé/valeur lisibles. L’instantané lui-même est binaire, et l’anglais que vous lisez est la table du parseur, pas des mots que la moto a stockés. À côté de ces enregistrements binaires, le firmware écrit aussi son propre texte, dans des enregistrements de chaînes de debug 0xFD : changements d’état, erreurs CAN, commutation du chargeur.
Mesuré sur les extraits publiés : 56 sur 169 lignes Gen2 sont du texte que la moto a écrit elle-même, toutes issues de ces enregistrements 0xFD, contre 43 sur 293 en Gen3, où elles viennent des enregistrements d’événements de la batterie. La carte principale Gen3 écrit aussi des événements texte, mais son décodeur ne marque pas quels enregistrements en portaient un : ses lignes sont donc comptées comme notre décodage. Les deux générations mêlent enregistrements binaires et texte du firmware.
// Une vraie entrée de roulage MBB Gen2, telle que décodée (FXS 2016, MBBEntry)
MBB #929 15:22:15 Riding
pack_temp_high_celsius: 34, pack_temp_low_celsius: 32, state_of_charge_percent: 75, pack_voltage_volts: 108.28, motor_temp_celsius: 44, controller_temp_celsius: 32, motor_rpm: 1349, battery_current_amps: 4, motor_current_amps: 5, ambient_temp_celsius: 28, odometer_km: 30800, mods: 11, mods_raw: 3
MBB #930 15:23:15 Riding
pack_temp_high_celsius: 34, pack_temp_low_celsius: 32, state_of_charge_percent: 74, pack_voltage_volts: 106.924, motor_temp_celsius: 46, controller_temp_celsius: 32, motor_rpm: 1744, battery_current_amps: 23, motor_current_amps: 48, ambient_temp_celsius: 28, odometer_km: 30800, mods: 11, mods_raw: 3
// 21 lines in this window · timestamps real · chaque ligne est notre décodage des octets
Chaque champ est disponible dans chaque entrée de conduite, et la cadence de 60 secondes est exacte : c’est l’écart dominant entre entrées dans chaque fichier Gen2 mesuré ici.
Voir cette fenêtre ligne par ligne : le même extrait avec chaque champ nommé, à côté de la voie de la batterie qui écrivait au même moment.
Gen3 : tampon circulaire événementiel
Gen3 utilise un tampon circulaire qui stocke les événements au fur et à mesure. La télémétrie est intégrée à des enregistrements binaires de 75 octets, et des enregistrements ASCII consignent les changements d’état, les défauts et les messages système. Les entrées ne sont pas chronologiques dans le fichier, parce que le tampon circulaire reboucle.
// De vrais enregistrements, décodés champ par champ, à partir du moment où une Gen3 à l’arrêt s’endort (DSR/X 2023, Gen3MBBEntry)
MBB #248 08:24:18 State change
from: PWSU, to: HIB
MBB #249 08:24:18 MTC pending change by 3
from: 0, to: 0
MBB #250 08:24:18 Stopping 12v charge
DC-DC: 281776uV, Battery: 13153056uV, Combined: 12340647uV, Ambient: 33C
MBB #251 08:24:18 Unknown
// 26 lines in this window · timestamps real · texte de la moto et notre décodage mêlés
Voir une Gen3 à l’arrêt tenir ce rythme une heure durant, et les deux horloges qui donnent l’impression qu’une paire Gen3 n’écrit jamais en même temps sur ses deux cartes.
Les enregistrements mêlent binaire et ASCII, doivent être triés par horodatage après l’analyse et donnent moins d’entrées par trajet. Les mots de tension et de courant sont réels : ils sont renseignés dans chaque enregistrement RUN et dans aucun enregistrement d’hibernation, et notre décodeur les lit depuis le 2026-09-07. Comme ils tombent à zéro avec le bus, les volts et ampères viennent en pratique encore du fichier BMS. Cet enregistrement commun de 75 octets ne contient ni km/h ni compteur kilométrique (les deux ne vivent que dans les enregistrements plus rares 0x52 / 0x53) ; la troisième valeur ci-dessus est le rail accessoire 12 V, qui reste vivant quand la batterie est déconnectée.
Comparaison de la télémétrie MBB
Quelles données sont disponibles dans le log du MBB (carte principale de la moto) de chaque génération. Les décalages Gen3 ci-dessous sont donnés par rapport à s, la position de la chaîne d’état ASCII ; sur un enregistrement de type 0x51 (télémétrie), s = 42, et elle vaut 42 sur les 1 356 enregistrements de ce genre dans les neuf fichiers MBB Gen3 natifs ici (1 347 d’entre eux si l’on ne compte que les huit jetons d’état que le parseur reconnaissait avant 2026-08, et les 1 356 avec REV et PARK, que les deux décodeurs lisent désormais). Plusieurs lignes Gen3 ci-dessous étaient marquées « présent mais non lu » ou « non enregistré » jusqu’en septembre 2026 : les octets étaient toujours là, et notre décodeur les lit depuis le 2026-09-07. Un rapport analysé avant cette date ne les montre qu’après une nouvelle analyse.
| Champ de données | Gen2 | Gen3 |
|---|---|---|
| Pack Voltage | Every entry (Vpack, V) | MBB [s-8] ([34:38], uint32 LE mV), decoded since 2026-09-07, only while the bus is live: non-zero on 144/144 RUN and 0/417 HIB records. The BMS reading (payload[38:41], uint24 LE mV, measured) is the one with continuous coverage |
| Battery Current | Every entry (BattAmps, A) | MBB [s-4] ([38:42], int32 LE mA), decoded since 2026-09-07, populated with the voltage. The BMS reading (payload[20:24], int32 LE mA) is the one with continuous coverage |
| SOC (State of Charge) | Every entry (PackSOC, %) | Binary [s-9]: uint8 0-100% (dashboard value; BMS carries its own at payload[19]) |
| Motor RPM | Every entry (MotRPM) | [s-13] ([29:33], int32 LE): the controller's motor rpm, decoded since 2026-09-07, only while the bus is live |
| Speed | Derived from RPM | Recorded, but only in the tail of the rarer 0x52 / 0x53 records (millimetres per hour); a 0x51 ends before it. Decoded since 2026-09-07 |
| Odometer | Every entry (Odo, km) | Only in the 0x52 / 0x53 tail, and only on the newer firmware layout (tenths of a km), decoded since 2026-09-07 and checked as a series per file. The older layout has none, and no 0x51 has one. [s+29] was published here as one, but it is the 12 V accessory rail (see the retraction below) |
| 12 V accessory rail | Not recorded. None of the Gen2 binary record types the parser decodes has a 12 V field, and no 0xFD text record in the Gen2-format MBB files here prints the rail's voltage. Some firmware writes `Turning ON DCDC` and `Turning OFF DCDC` lines, with no voltage | Post-state field 5 ([s+29], uint32 LE microvolts), decoded and emitted raw as aux_12v_uv. Alive even in hibernation, unlike everything else here |
| Motor Temperature | Every entry (MotTemp, °C) | post_1 ([s+13], uint32 LE °C), zero when the bike is parked. Until 2026-09-07 this word was labelled pack-high and stored as the battery temperature; a reparse corrects older reports |
| Controller Temp | Every entry (CtrlTemp, °C) | post_2 ([s+17], uint32 LE °C): the inverter, tracking the motor and zero when parked. Until 2026-09-07 it was labelled pack-low and stored as the motor temperature |
| Ambient Temp | Every entry (AmbTemp, °C) | post_0 ([s+9], uint32 LE): hundredths of a degree on most firmware, whole degrees on some; each file is internally consistent |
| Pack Temperature | Every entry (hi/lo, °C) | post_3 / post_4 ([s+21] / [s+25], uint32 LE °C): cell high and cell low, written in every state, charging included. Until 2026-09-07 these two words were labelled ambient and controller |
| Torque | Not recorded. While riding, the parser estimates it from battery power (pack voltage times battery current) times 9549 divided by motor RPM, so it includes the losses between pack and shaft | The 0x54 motor record, written beside every 0x51: shaft torque in micro-newton-metres, exactly 0.2 N·m per amp of motor current. Decoded since 2026-09-07; this page called it not recorded until then. On 538XX firmware it is derived (kW × 9549 / rpm) |
| Motor Amps | Every entry (MotAmps) | The 0x54 motor record, int32 LE whole amps, decoded since 2026-09-07, on firmware that writes 0x54 at all (one 2023 SR/F export here has none). The 538XX firmware variant carries it too, as int16 amps at record[26], right after the module bitmask |
| Power (kW) | Derived (V × BattAmps) | Derived from BMS voltage × BMS current; the MBB pair gives the same product, but only while the bus is live |
| Discharge Limit | Not available | 0xFD ASCII records (watts, stored as kW) |
| Charge Limit | Not available | 0xFD ASCII records (watts, stored as kW) |
| Controller Active | Not available | Record byte 17: 0x00=active (144/144 RUN records), 0x6A=standby (408/408 PWSU, 397/417 HIB), 0x60=transition. The decoder indexes it as binary_data[11] because its loader hands over the record from byte 6 onwards |
| Bike State | Derived from event type | ASCII [s:s+9], null-padded. The parser knows ten tokens: RUN/STOP/HIB/STRT/PWSU/CHRG/WAIT/WAKE/REV/PARK. The last two were added in 2026-08; before that they were decoded as records with no state and their telemetry was dropped |
| Error Codes | The binary 0x2F record, shown as SEVCON CAN EMCY Frame, holds a 16-bit error code, the Sevcon controller's own 16-bit code and an error register. A few other binary records each stand for one fault, such as 0x31 MBB BMS Isolation Fault. Most warning and error lines in the MBB log are text the firmware stores in 0xFD records, such as `CAN1 ACK error. count=1` | Fault pending/cleared ASCII records |
| Writes while switched off | Main board writes nothing at all. The BMS wakes about once a day (86,401 s between blocks in the parked window measured here) | Every hour, for ever. The main board declares 3,600 s of sleep and keeps to it to the second; with the 91 s it spends awake the true period is 3,691 s, so about 23 entries a day in a locked garage. This is what fills the ring buffer in roughly three days |
| Ride Mode | Not recorded. No Gen2-format file in this corpus contains a ride-mode string of any spelling; `Mods` on a riding line is the battery-module presence bitmask, not a mode | Recorded, but only as an ASCII event when it changes: `Changing riding mode to 3, SPORT`. Sparse: 8 events across 2 of the 9 native Gen3 MBB files here (tokens seen: 1 ECO, 3 SPORT, 4 ARM, 4 Full). No decoder extracts it, so the app's riding-mode field stays owner-declared |
Retiré : [s+29] n’est pas un compteur kilométrique, et cette page disait que c’en était un
Le champ 5 après l’état était publié ici comme un compteur kilométrique à vie en mètres, et son comportement était mis sur le compte de la gigue. Ce n’est pas un compteur kilométrique. Chacun des 1 121 enregistrements complets de 75 octets de type 0x51 de ce corpus satisfait v = 5128k + 4864 (un CAN 12 bits avec un bit de poids faible de 5,128 mV sur environ 21 V de pleine échelle), et lu en microvolts, le champ s’étend de 0,143 V à 13,440 V, ce qui est la plage et l’unité que les événements texte du firmware utilisent pour la batterie accessoire (« Stopping 12v charge. DC-DC 302288uV, Battery 13142800uV »). Un balayage exhaustif de chaque fenêtre uint32 de cet enregistrement ne trouve aucun champ monotone nulle part, sauf l’horodatage lui-même. Il n’y a aucun compteur kilométrique dans un enregistrement 0x51. Cette phrase se terminait autrefois par « dans un enregistrement MBB Gen3 natif », ce qui était une affirmation sur un enregistrement formulée comme une affirmation sur la moto. Le vrai compteur kilométrique est en fin des enregistrements plus longs 0x52 / 0x53, sur la disposition de firmware plus récente seulement, et il est décodé depuis le 2026-09-07.
Le décodeur a été modifié en conséquence : il n’écrit plus odometer_km à partir de ce champ, et l’émet comme aux_12v_uv à la place. Un MBB Gen3 natif dont le log ne contient aucun enregistrement 0x52 / 0x53 de disposition récente signale donc aucun compteur kilométrique et aucune distance par trajet plutôt qu’une distance fabriquée. Un vrai compteur kilométrique existe bien sur Gen2 et sur la variante de firmware 538XX, à un autre décalage dans un autre enregistrement.
Autre correction : le MBB contient bien la tension de la batterie et le courant, ce que nous disions qu’il n’avait pas
Une révision antérieure de cette page disait que les trois emplacements uint32 avant la chaîne d’état étaient mal étiquetés comme tension, courant et vitesse, et concluait qu’un enregistrement MBB Gen3 ne contient aucune donnée électrique. La première moitié était juste ; la conclusion était trop forte. La tension de la batterie est un uint32 little-endian en millivolts à record[34:38] et le courant de batterie un int32 signé en milliampères à record[38:42]. C’est treize octets plus loin dans l’enregistrement que l’emplacement mal étiqueté : ce sont donc d’autres octets, pas une seconde lecture des mêmes.
La preuve est un seuil de population et une courbe physique. Sur les 1 121 enregistrements complets de 75 octets, [34:38] est non nul sur 144 sur 144 enregistrements RUN, 5 sur 5 REV et 4 sur 4 PARK, et sur zéro HIB sur 417, zéro PWSU sur 408 et zéro WAIT sur 51. Il est renseigné exactement quand le système haute tension est actif, sans exception dans aucun sens. La courbe est une preuve plus forte. Dans un fichier de 2021 (dont les enregistrements de télémétrie utilisent l’ancienne forme de 71 octets, donc hors des 1 121 qui viennent d’être comptés), 32 enregistrements CHRG consécutifs montrent le champ qui monte de façon monotone de 102,081 V à 114,075 V en 5,5 heures pendant que le mot de courant reste entre −11,6 A et −15,3 A et que le SOC passe de 41 à 100. Sur les six derniers enregistrements, le SOC reste bloqué à 100 alors que la tension monte encore, de 111,756 V à 114,075 V. C’est une phase d’absorption à tension constante ; aucun champ de remplissage et aucune table de correspondance du SOC n’en produit. Un second fichier, une autre SR/F, la répète sur 15 enregistrements (106,605 V à 114,894 V, SOC 60 à 100). Intégrer V·I sur la variation de SOC donne environ 13,6 kWh et 12,4 kWh d’équivalent batterie complète, face à une batterie de 14,4 kWh maximum et 12,6 kWh nominaux.
La réserve de portée est sévère : chaque point de données dynamique ci-dessus vient d’un VIN à préfixe 538ZF, la plateforme SR/F 2020-2023. La seule vraie moto à WMI PAG ici, une DSR/X, apporte 278 enregistrements de type 0x51 dont 18 renseignés, un enregistrement RUN et aucun enregistrement CHRG, si bien qu’aucun test de conservation ne peut être mené sur ce matériel. L’alternative n’est pas exclue : que la disposition soit partagée mais que le firmware de l’époque DSR/X ne la renseigne que dans des états que ce corpus contient à peine.
La corrélation de Pearson que cette page citait est retirée. Elle plaidait pour un autre mot, record[21:25], avec r = 0,913 contre la tension de la batterie du BMS, sur une seule moto et une seule paire de fichiers. Refaite sur cette même paire (129 enregistrements RUN rapprochés d’une ligne BMS à moins de 60 secondes), sept fenêtres uint32 de l’enregistrement obtiennent |r| ≥ 0,90 contre la tension de la batterie du BMS, et le gagnant n’est pas record[21:25] : le mot au décalage 30 obtient 0,925 contre ses 0,907, et ce sont à nouveau quatre octets différents. Une corrélation n’identifie pas un décalage, et la traiter comme si elle le faisait est exactement l’erreur qui a mis un rail 12 V sur cette page comme compteur kilométrique.
Ce qui tranche pour record[21:25], c’est l’arithmétique : c’est un multiple de 100 mV sur 281 sur ses 281 lectures non nulles, alors que record[34:38] l’est sur 2 sur 302 : la même grandeur à un centième de la résolution. Et il est nul sur les 54 enregistrements CHRG ici alors que record[34:38] est renseigné sur 47 d’entre eux. Préférez record[34:38].
Depuis le 2026-09-07, notre décodeur lit les deux, conditionnés à un bus actif, avec la paire bus CC du contrôleur, le régime moteur, et la vitesse sur route et le compteur kilométrique dans la fin des enregistrements 0x52 / 0x53. Comme tous tombent à zéro avec le bus, le fichier BMS reste la meilleure source électrique. La mesure complète figure dans la spécification du format.
Avantage Gen2
Télémétrie complète dans chaque entrée. SOC, régime moteur, courant moteur et toutes les températures sont toujours disponibles, depuis un seul fichier, et un vrai compteur kilométrique aussi. (Pas le mode de conduite : aucun fichier au format Gen2 de ce corpus n’en enregistre ; voir le tableau des champs ci-dessus.) Forte densité de données : 6 713 à 9 229 entrées dans les huit exports MBB mesurés pour cette page. La bibliothèque zero-log-parser en amont décode chaque enregistrement binaire en champs typés.
Avantage Gen3
Piloté par les événements, donc le temps d’arrêt coûte peu d’entrées. Les transitions d’état exactes sont enregistrées plutôt que déduites. Le côté BMS est à plus haute résolution que Gen2 : minimum et maximum des cellules au millivolt, une tension en circuit ouvert compensée de la résistance interne, un courant au milliampère et une tension de batterie mesurée. Propre au Gen3 : limites de puissance en watts, tension en circuit ouvert des cellules, indicateur de contrôleur actif.
Les octets de type d’enregistrement, la carte complète des décalages, la variante de firmware 538XX et les preuves d’étalonnage de chaque champ se trouvent dans la spécification du format de log Gen3.
Machine à états et détection des sessions
Gen2 : par mode
Chaque entrée a une étiquette de mode claire. La détection des sessions est simple :
Gen3 : machine à états
Utilise une machine à états avec des transitions. La détection des sessions demande une recherche de motifs :
Ce sont les huit jetons que le parseur reconnaissait avant 2026-08. Le contenu des fichiers est déséquilibré : sur les 1 121 enregistrements de télémétrie complets de 75 octets ici, 417 sont HIB et 408 PWSU, contre 144 RUN, 51 WAIT, 44 WAKE, 41 STOP et 7 CHRG. STRT n’apparaît jamais sur un enregistrement. Les neuf autres portent REV (cinq) ou PARK (quatre), tous sur l’unique DSR/X de ce corpus. Jusqu’en 2026-08, le parseur écartait leur télémétrie ; il lit les deux jetons depuis, et les neuf portent une tension de batterie renseignée (102,561 V à 102,630 V).
Signaux de détection de session Gen3
Comme Gen3 n’a pas d’étiquettes « Riding » claires, nous reconstruisons les sessions à partir de plusieurs signaux :
Différences de log du BMS
BMS Gen2
Enregistrements binaires au même format que ceux du MBB, que le parseur restitue avec une étiquette sur chaque champ :
// Une vraie entrée BMS Gen2, telle que décodée
Discharge level 2017-06-14 09:06:22
SOC 92%, current 8A, amp_hours 2,
cell low 3.994V unloaded 4.013V high 4.0V,
balance 6mV, pack_temp 26C, bms_temp 35C,
pack_voltage 111.923V, mode Bike On
- Tensions des cellules (haute, basse) dans chaque entrée
- SOC (état de charge) toujours présent
- Températures de la batterie et des cartes
- Écart d’équilibrage des cellules (mV)
- Modes charge/décharge/équilibrage
BMS Gen3 décodé
Enregistrements binaires délimités par 0xB2. L’enregistrement de télémétrie de type 0x4B, de 52 octets, est la principale source de télémétrie pour toute la moto :
Deux enregistrements voisins portent les mêmes champs à un décalage différent : le 0x4C de 70 octets à +4 et le 0x4D de 78 octets à +8. Les lire aux décalages du 0x4B tombe dans un bloc de remplissage et le contrôle de vraisemblance de la tension des cellules écarte la ligne, ce qui est ce qui se passait : aiguiller sur l’octet de type a fait passer le décodeur de 1 625 lignes de télémétrie à 2 319 sur ces sept fichiers, +42,7 %.
0xB2 + 1B de longueur + 1B de type (0x4B) + Horodatage Unix 4B (LE) + 1B + 44B de charge utile
Payload[13-14]: CvLow uint16 LE (mV)
Payload[15-16]: OCV cellule basse uint16 LE (mV)
Payload[17-18]: CvHigh uint16 LE (mV)
Payload[19]: SOC uint8 (0-100 %)
Payload[20-21]: Courant int16 LE (mA, négatif = charge)
Payload[38-40]: Tension de batterie uint24 LE (mV, mesurée)
Payload[43]: Pas de température (lu comme une température jusqu’au 2026-07-31, puis retiré)
- Tensions min/max des cellules (mV), profil CC/CV visible
- SOC 0-100 % (0 = BMS en veille, valeur réelle quand actif)
- Courant en mA : charge ~-15 A en CC, décroissance en phase CV
- La tension de la batterie est mesurée, pas déduite des cellules
- Détection des sessions de recharge avec calcul de puissance
Le problème du tampon circulaire
Gen3 utilise un tampon circulaire pour stocker le log, avec ces conséquences pour l’analyse des données :
Rétention des données : une moto à l’arrêt le remplit en 3 jours environ
Une moto à tampon circulaire (SR/F, SR/S, DSR/X ; pas la FXE, qui écrit le format Gen2) qui reste à l’arrêt écrase tout son tampon circulaire MBB en environ 3 jours.
- 1.Le tampon circulaire contient 2 238-2 535 enregistrements dans 131 200 octets de flash (découpage par chaîne de longueurs, huit exports MBB de pleine taille, 19 089 cumulés)
- 2.Même à l’arrêt, la moto se réveille toutes les ~1 heure pour un cycle STRT→PWSU→HIB : 444 des 462 marqueurs d’hibernation de ces fichiers déclarent un sommeil de 3 600 secondes
- 3.Chaque cycle de réveil écrit une médiane de 31 enregistrements (1 680 octets sur disque, intervalle médian de 3 691 secondes), sur les 416 cycles entre marqueurs ici dont l’écart est réellement d’environ une heure (une paire de marqueurs d’hibernation consécutifs espacés de 3 000 à 4 200 secondes). En ne comptant que les marqueurs qui déclarent 3 600 secondes, on obtient 411 cycles et les mêmes trois médianes. (Une révision antérieure de cette page disait 426, ce que ne reproduit aucune des deux règles.)
- 4.Soit ~744 enregistrements/jour : 131 200 ÷ 1 680 = 78 cycles horaires, donc le tampon reboucle en ~3,25 jours en octets et en 3,0-3,4 jours en enregistrements, écrasant toutes les données plus anciennes
- 5.Ne supposez pas que le fichier BMS remonte aussi loin. Sur les six paires de la même moto, du même export MBB/BMS ici, la fenêtre BMS va de 0,19× à 20,9× la fenêtre MBB (médiane 1,02×) : on ne peut donc pas fixer quel tampon s’épuise en premier. Téléchargez les deux ensemble. (Il y a sept paires du même jour dans le corpus ; les six qui donnent ces rapports sont celles téléchargées dans la même session, ce qui est la seule comparaison qui ait un sens.)
Pour capturer l’historique des trajets, téléchargez vos logs dans les 1 à 2 jours qui suivent la conduite. Si vous attendez plus, les données de trajet seront probablement écrasées par les cycles d’hibernation.
Trois jours, c’est la vitesse à laquelle le tampon se renouvelle pendant que cette cadence horaire tourne, pas la durée que vous verrez dans chaque fichier. La cadence ne dure pas éternellement : dix-huit de ces 462 marqueurs déclarent plutôt un sommeil de 31 536 000 secondes (un an), et les huit exports MBB mesurés ici couvrent de 3,1 à 336 jours de temps réel. Un log Gen3 peut donc remonter presque un an et ne contenir pratiquement que des cycles de réveil.
Comment cela fonctionne
Le log a une capacité fixe (2 238-2 535 enregistrements dans les exports de cette page). Une fois plein, les nouveaux enregistrements écrasent les plus anciens. Le fichier contient donc des enregistrements de périodes différentes, et ils ne sont pas dans l’ordre chronologique.
// Visualisation du tampon circulaire (simplifiée)
Position dans le fichier : [le plus ancien ... point de rebouclage ... le plus récent]
Horodatages : [15 janv. ... 3 déc. ... 14 janv.]
^ le pointeur d’écriture reboucle ici
Conséquences
- Les entrées doivent être triées par horodatage avant l’analyse
- Les anciennes données de conduite sont écrasées par les cycles d’hibernation plus récents
- Une moto « stockée » qui se réveille toutes les heures remplit le tampon en 3 jours environ et perd tout l’historique des trajets
- Il n’y a pas de compteur kilométrique dans l’enregistrement de télémétrie commun 0x51 à interpoler au point de rebouclage. Un MBB Gen3 natif n’en porte un que dans ses enregistrements plus rares 0x52 / 0x53, et seulement sur la disposition de firmware plus récente ; sinon, le vrai compteur kilométrique de la moto nous parvient par le bloc de synthèse, par une entrée de conduite Gen2 ou par la variante de firmware 538XX
- Certains horodatages sont corrompus. Les délimiteurs Gen3 rejettent tout enregistrement dont l’uint32 au décalage 3 tombe hors de la plage 2019-01-01 (Unix 1546300800, le lancement de la SR/F) à aujourd’hui + 365 jours
MBB et BMS : sources de données
Les mots à record[34:38] et record[38:42] contiennent la tension de la batterie et le courant de batterie quand la batterie est active, et notre décodeur les lit depuis le 2026-09-07, mais ils sont à zéro dans les états qui remplissent l’essentiel du tampon d’une moto à l’arrêt, et la vitesse sur route et le compteur kilométrique n’arrivent que par les enregistrements plus rares 0x52 / 0x53. En pratique, le log du BMS (système de gestion de batterie) est la source électrique, et c’est pourquoi l’application demande les deux fichiers : n’envoyez que le MBB d’une moto Gen3 et la plupart des graphiques électriques restent clairsemés ou vides, aussi complète que paraisse la liste des trajets.
Le MBB fournit :
- État (RUN, STOP, HIB, CHRG...)
- SOC % (valeur du tableau de bord)
- Températures : ambiante, moteur, onduleur, cellule haute et basse
- Rail accessoire 12 V (microvolts)
- Événements texte et codes de défaut
- Tension et courant de la batterie, paire du bus, régime moteur (seulement bus actif)
- Vitesse sur route, autonomie, compteur kilométrique (0x52 / 0x53 seulement)
Le BMS fournit :
- Tensions des cellules (min/max)
- Courant de la batterie (mA)
- SOC % de la batterie
- État de charge et mode de rapport
- Pas de température (payload[43] retiré)
Exemple réel : une SR/S « stockée »
Un export de SR/S de ce corpus, téléchargé le 31 décembre 2025, délimite 2 416 enregistrements dont les horodatages remontent à 336 jours. Il ne contient pas un seul enregistrement RUN. Sur ses 154 enregistrements de télémétrie complets, 76 sont HIB et 76 PWSU, avec un WAIT et un STOP : près d’un an de fichier, tout entier fait de la moto qui se réveille toutes les heures pour se rendormir. Tout trajet fait pendant ces 336 jours a été écrasé bien avant que le log ne soit récupéré.
Retiré. Cette boîte disait autrefois que la même moto montrait « 9 relevés de compteur kilométrique différents, 12 635 – 13 153 km », présentés comme des instantanés de positions différentes du tampon circulaire. Ce n’étaient pas des kilomètres. Le champ 5 de ce fichier prend 11 valeurs distinctes de 12,635 V à 13,168 V : le rail accessoire 12 V, en microvolts, lu comme s’il s’agissait de mètres. Que la batterie 12 V d’une moto à l’arrêt dérive d’un demi-volt est exactement ce qu’on attend ; que le compteur kilométrique d’une moto à l’arrêt avance de 518 km ne l’est pas, et cela aurait dû mettre la puce à l’oreille.
Détection de la recharge
Gen2
Simple et fiable :
- L’entrée a le mode = "Charging"
- Le SOC augmente avec le temps
- Courant de charge visible dans le BMS
- La session se termine quand le SOC cesse d’augmenter
Gen3
Demande une détection multi-signaux :
- State = CHRG (explicite)
- Événements CHARGER LSS (enregistrement du nœud chargeur)
- Événements du contacteur (Precharging from module)
- Augmentation de tension pendant les périodes hors RUN (repli)
Le signal 1 est rare en pratique : seulement 7 des 1 121 enregistrements de télémétrie complets ici sont à l’état CHRG. C’est pourquoi les trois autres signaux existent.
État du décodage : les sept lignes qui comptent
Le format Gen3 n’est pas documenté officiellement, et rien sur cette page ne vient de Zero Motorcycles. Sept entrées portent l’essentiel des conséquences pratiques. Les nombres ci-dessous sont mesurés sur huit exports MBB Gen3 natifs de pleine taille issus de cinq motos (trois SR/F, une SR/S, une DSR/X) plus un neuvième export tronqué d’une sixième, et sept fichiers BMS Gen3 de ces mêmes cinq, tous décodés par le parseur en production pour cette page.
| Domaine | État | Notes |
|---|---|---|
| Tension / courant du MBB | partial | Décodé depuis le 2026-09-07, conditionné à un bus actif ; cette ligne indiquait « présent dans l’enregistrement, lu par rien » jusque-là. uint32 LE mV à record[34:38] et int32 LE mA à record[38:42], non nuls sur 144 enregistrements RUN sur 144 et 0 sur 417 HIB, 0 sur 408 PWSU, 0 sur 51 WAIT. Une série de charge lue à partir d’eux montre une phase d’absorption CV de manuel. Tout échantillon dynamique vient de motos de plateforme SR/F ; c’est donc non confirmé sur le firmware de l’ère DSR/X. Le fichier BMS a la couverture continue |
| Vitesse / régime / compteur kilométrique du MBB | partial | Décodé depuis le 2026-09-07 ; cette ligne indiquait « manquant » jusque-là, d’après une mesure de l’enregistrement 0x51 seul. Le régime moteur figure dans chaque 0x51 à record[29:33], seulement tant que le bus est actif. La vitesse sur route et l’autonomie du tableau de bord sont dans la queue des enregistrements plus rares 0x52 / 0x53, et le compteur kilométrique aussi, seulement sur la structure de firmware plus récente, vérifié comme une série par fichier. Aucun 0x51 ne porte de compteur kilométrique, et le champ que cette page publiait comme tel est le réseau 12 V |
| Machine à états du MBB | decoded | ASCII de 9 octets complété par des zéros à record[42:51] : RUN/STOP/HIB/STRT/PWSU/CHRG/WAIT/WAKE, plus REV et PARK, acceptés depuis 2026-08. Ancre tous les autres décalages : octet 42 sur les 1 356 enregistrements de type 0x51 d’ici |
| Températures du MBB | partial | Cinq mots uint32 d’état « post » à [s+9]/[s+13]/[s+17]/[s+21]/[s+25] : ambiante, moteur, onduleur, cellule haute, cellule basse. Jusqu’au 2026-09-07, ils étaient lus avec un cran de décalage d’étiquette (comme une mesure interne, batterie haute, batterie basse, ambiante et contrôleur), et la mesure du moteur était stockée comme la température de la batterie ; un nouveau décodage corrige les anciens rapports. RUN renseigne les quatre mots de température après l’ambiante sur 144 enregistrements sur 144, mais « zéro sauf éveillé » est une tendance, pas une règle : HIB remplit la paire moteur/onduleur sur 20 enregistrements sur 417 (4,8 %) et PWSU la paire des cellules sur 34 sur 408 (8,3 %) |
| Réseau 12 V du MBB | decoded | Champ 5 d’état « post » à [s+29], microvolts uint32 LE, émis comme aux_12v_uv. Les 1 121 enregistrements de télémétrie complets tombent sur un réseau de 5 128 µV (un CAN 12 bits sur ~21 V), de 0,143 V à 13,440 V. C’est le champ que cette page publiait comme compteur kilométrique en mètres |
| Tension de la batterie (BMS) | decoded | Mesuré uint24 LE mV à payload[38:41]. 2 189 des 2 319 lignes émises (94,4 %, 92,1–96,5 % par fichier) tombent dans 28 × CvMin .. 28 × CvMax ; l’estimation moyenne des cellules × 28 n’est que le repli |
| Code d’état du BMS | partial | payload[24], et toujours opaque. 37 valeurs distinctes sur ces 2 319 lignes ; 0x00–0x23 en couvre 2 276, plus 19 lignes de 0xF0 et 24 de 0xFF, les sentinelles flash. 0x0B penche vers l’absence de charge (516 lignes sur 603) et 0x0C vers la charge (256 sur 566), mais aucune énumération ne résiste au test : les quatre codes autrefois publiés comme repos/actif/déverrouillage/précharge ne couvrent que 58,6 % des lignes, et un 0x10 sans étiquette (69 lignes sur 111 sous charge, 62,2 %) se classe au-dessus de 0x0C dans le même ordre de charge |
Les autres lignes figurent dans la spécification du format de log Gen3, qui porte les preuves d’étalonnage de chacune : chaque octet de type d’enregistrement MBB et BMS, la disposition de l’en-tête avant et après l’état, l’enregistrement moteur 0x54 de 29 octets, la taxonomie des événements ASCII, l’enregistrement de santé 0x4D de 78 octets avec son registre de capacité de pleine charge, la variante FST Mono de 50 octets et la variante de firmware 538XX.
Stockage en base de données et chaîne d’analyse
Quand un fichier de log est envoyé, un worker en arrière-plan l’analyse et stocke les entrées dans PostgreSQL (avec TimescaleDB pour l’optimisation des séries temporelles). La stratégie de stockage diffère selon la génération. Les sessions détectées sont écrites dans deux tables indexées par VIN, unified_ride_sessions et unified_charging_sessions, chacune reliée à ses fichiers sources par une table many-to-many plutôt qu’une clé étrangère, parce qu’une même session peut être reconstruite à partir de plusieurs fichiers de log qui se chevauchent, ce que produit justement un tampon circulaire qui reboucle.
Flux d’analyse Gen2
- Décoder les enregistrements binaires avec le zero-log-parser en amont, qui renvoie des champs typés pour chaque entrée
- Faire correspondre le type d’événement (Riding/Charging/etc.) à bike_state
- Lire chaque mesure dans ces champs typés
- Calculer la vitesse à partir du régime, la puissance à partir de V×I
- Stocker avec log_generation = 2
- Détecter les sessions de trajet et les sessions de recharge à partir des motifs d’événements
Colonnes dédiées :
pack_voltage_v, battery_amps, motor_rpm,
speed_kmh, odometer_km, motor_temp_c,
controller_temp_c, ambient_temp_c, soc,
power_kw, bike_state
Flux d’analyse Gen3
- Délimiter les enregistrements 0xB2 et valider l’horodatage au décalage 3 avant de se fier à l’enregistrement
- Ancrer les décalages MBB sur la chaîne d’état ASCII ; lire les charges utiles BMS à des décalages fixes
- Extraire la valeur de la machine à états sous la forme bike_state
- Convertir les unités (mV→V, mA→A, mm/h→km/h, dixièmes de km→km, W→kW)
- Analyser les enregistrements ASCII pour les limites de puissance, les défauts et les transitions d’état
- Stocker avec log_generation = 3
Colonnes propres au Gen3 :
bike_state, controller_active,
discharge_limit_kw, charge_limit_kw,
cell_voltage_ocv_min, is_under_load,
bms_state_code
Colonnes partagées (comme Gen2) :
pack_voltage_v, battery_amps, soc,
power_kw (depuis le fichier BMS)
motor_temp_c, motor_rpm, torque_nm
(depuis le MBB, bus actif)
speed_kmh, odometer_km (depuis les
enregistrements 0x52 / 0x53 du MBB seulement)
Types d’entrées Gen3 en base de données
Les entrées MBB Gen3 sont hétérogènes : toutes ne portent pas tous les champs, et les canaux électriques du MBB ne sont renseignés que tant que le bus haute tension est actif. Les graphiques qui paraissent clairsemés sur un rapport Gen3 montrent généralement cela, pas un échec d’analyse :
Télémétrie MBB 0x51 (75 o)
bike_state, soc, cinq températures, controller_active, aux_12v_uv dans le blob des champs bruts et, bus actif, la tension et le courant de la batterie, la paire du bus du contrôleur et le régime moteur (décodés depuis le 2026-09-07). Ni vitesse ni compteur kilométrique : ils sont dans les enregistrements plus longs 0x52 / 0x53
ASCII MBB 0xFD (variable)
discharge_limit_kw, charge_limit_kw (rapports de capacité du BMS), changements d’état, défauts, clé/coupe-circuit, béquille, événements du contacteur de puissance
Télémétrie BMS 0x4B (52 o)
pack_voltage_v, battery_amps, power_kw, soc, cellules min/max/OCV, is_under_load, bms_state_code. Pas de température : payload[43] était lu comme tel jusqu’au 2026-07-31 et est retiré
Où est passé le détail au niveau de l’octet
Cette page se terminait autrefois par trois sections techniques repliées. Elles ont été supprimées plutôt que corrigées, parce qu’une seconde carte d’octets contradictoire sur le même domaine est pire que pas de carte du tout. Sur les 22 lignes de leur table de décalages MBB, plus de la moitié nommaient le mauvais champ, deux pointaient au-delà de la fin d’un enregistrement de 75 octets, et une prenait un octet de l’horodatage Unix (0x69, l’octet de poids fort de tout horodatage entre fin octobre 2025 et mai 2026, ce qui couvre 14 207 des 19 089 enregistrements délimités ici) pour un marqueur de type d’enregistrement. La spécification complète du Gen3, enregistrement par enregistrement, se trouve désormais à /learn/gen3-log-format.
- Charge utile binaire du MBB Gen3. Règles de délimitation, types d’enregistrement 0x51 / 0x54 / 0xFD, disposition avant et après l’état et contenu de chaque emplacement : lire la spécification des enregistrements MBB.
- BMS Gen3 binaire. L’enregistrement de télémétrie 0x4B de 52 octets, l’enregistrement de santé 0x4D de 78 octets et son registre de capacité de pleine charge, le 0x4C de 70 octets et la variante FST Mono de 50 octets : lire la spécification des enregistrements BMS.
- Détection de session Gen3. Comment les trajets et les recharges sont reconstitués à partir des transitions d’état, des événements frontières ASCII et des écarts de temps une fois les enregistrements triés : lire la section sur la détection des sessions.
Pour savoir combien de temps un tampon circulaire Gen3 conserve vos trajets avant de les écraser, voir Pourquoi votre log Gen3 ne montre aucun trajet.
Sources :
- zero-log-parser (Python library): the Gen2 JSON pipeline this app builds on (s’ouvre dans un nouvel onglet)
- zero-log-parser: LOG_STRUCTURE.md, the community record-layout notes (s’ouvre dans un nouvel onglet)
- zero-log-parser issue #16: Gen3 (SR/F) log support (s’ouvre dans un nouvel onglet)
- ZeroManual: Interfacing (s’ouvre dans un nouvel onglet)
- Zero Motorcycles: owner's manuals, with each model's specifications (Owners page) (s’ouvre dans un nouvel onglet)
- NHTSA vPIC: VIN decoding, including the 10th-character model-year code (s’ouvre dans un nouvel onglet)
Ce que l’on en sait. Rien ici ne vient de Zero Motorcycles. Le format Gen3 est rétro-conçu à partir de fichiers de log de production, et le bilan est inégal. L’enregistrement BMS est largement décodé : minimum et maximum des cellules, tension en circuit ouvert, SOC, courant, tension de batterie mesurée, charge et mode de rapport se lisent tous et se recoupent (un octet de température a aussi été lu, puis retiré le 31 juillet 2026). L’enregistrement MBB a demandé plus de temps. Son 0x51 de 75 octets fournit un état, un octet de SOC, cinq températures, un rail 12 V et, seulement bus actif, la paire tension/courant de la batterie, la paire du bus du contrôleur et le régime moteur ; ses enregistrements plus rares 0x52 / 0x53 ajoutent la vitesse sur route et, sur firmware récent, le compteur kilométrique. Jusqu’au 7 septembre 2026, ce paragraphe disait que le MBB n’avait ni compteur kilométrique, ni vitesse, ni régime, une affirmation sur un enregistrement formulée comme une affirmation sur la moto. Entre février et juillet 2026, quatre champs de cette page se sont révélés mal étiquetés, deux fictifs, et un, le « compteur kilométrique », à la fois faux et écrit dans la base de données ; cette affirmation a été retirée et le décodeur modifié. Les chiffres qui les ont remplacés ont été mesurés sur 1 121 enregistrements MBB et 2 319 enregistrements de télémétrie BMS issus de cinq motos (une sixième apporte un export tronqué), par le parseur en production plutôt que par une réimplémentation. Si vous pouvez en réfuter une partie avec vos propres logs, dites-le : c’est ainsi que chaque erreur ci-dessus a été trouvée. Dernière vérification : 30 juillet 2026 sur backend/app/parser.py ; les lignes de canaux du MBB ont été révisées le 3 octobre 2026 pour correspondre aux corrections du décodeur du 7 septembre 2026.