Aller au contenu
zerologs
Retour au sommaire
Spécification de format binaire

Le format de log Zero Gen3, enregistrement par enregistrement

Une spécification, octet par octet, du log de diagnostic Gen3 (Cypher III / FST) : comment les enregistrements 0xB2 sont délimités et déséchappés, ce que signifie chaque champ décodé sur les cartes MBB et BMS, où la variante de firmware 538XX enfreint les règles et quels octets restent inconnus. Chaque décalage a été re-mesuré sur 352 vrais fichiers de log, et cinq affirmations que cette page avançait auparavant sont retirées sur place au lieu d’être supprimées. Chaque nombre d’enregistrements de cette page nomme la convention de délimitation et le nombre de fichiers sur lesquels il a été pris, car un décompte ne se reproduit pas sans eux. Le décodage Gen3 est aussi vérifié enregistrement par enregistrement face au parseur communautaire, et là où les deux diffèrent, la page dit pourquoi.

Dernière mise à jour : 3 octobre 2026
~111 min de lecture

TL;DR

  • L’écriture échappe le délimiteur. FE 4D sur le disque se décode en 0xB2 et FE 01 en 0xFE : un enregistrement bien formé ne contient donc jamais de 0xB2 brut après l’octet 0. Il n’y en a aucune occurrence dans les 1 010 093 octets de charge utile sur disque (record[2:]) des 19 342 enregistrements enchaînés par longueur déclarée dans les neuf fichiers MBB Gen3 natifs de ce corpus. Délimitez d’abord par la longueur déclarée, puis déséchappez le corps délimité. Dans l’autre ordre, la délimitation est détruite, et c’est ainsi que l’échappement a été pris pour « 0xB2 revient à l’intérieur des charges utiles ».
  • Un log MBB Gen3 natif contient bien la tension de la batterie et le courant de batterie, en record[34:38] et record[38:42], ainsi que la tension et le courant du bus continu du contrôleur et le régime du moteur. Tous sont renseignés sur 144 enregistrements RUN sur 144 et sur zéro des 417 enregistrements HIB, parce qu’ils tombent à zéro avec le bus haute tension. Le décodeur en production les lit depuis le 2026-09-07, à condition que le bus soit actif. Ils sont vides dans les états qui représentent environ les trois quarts d’un vrai log : le BMS reste donc la meilleure source électrique.
  • Il n’y a pas de compteur kilométrique dans un enregistrement 0x51. Nous avons publié record[71:75] comme tel ; c’est une lecture d’un CAN 12 bits en microvolts et, d’après les preuves, une lecture du rail accessoires 12 V : chaque valeur du corpus satisfait v = 5128k + 4864, de 0,143 V à 13,440 V, et seulement 51,5 % des échantillons consécutifs sont non décroissants. Le compteur kilométrique existe bel et bien, mais ailleurs : dans la queue des enregistrements plus longs 0x52 et 0x53, sur la disposition de firmware récente uniquement, où il reste figé pendant une recharge et ne monte que sous RUN. Précisez de quel enregistrement parle un résultat négatif.
  • Tous les enregistrements Gen3 partagent un en-tête de 13 octets : 0xB2 | longueur | type | horodatage uint32 LE | microsecondes uint32 LE | séquence uint8 | décalage UTC int8. Les octets 11 et 12 ont été publiés ici comme un seul « compteur d’entrées » uint16. Ce sont deux champs : l’octet 11 augmente de un à chaque enregistrement et repart de zéro quand la carte se réveille, et l’octet 12 est le réglage de fuseau horaire de la moto en heures (−7 sur une moto américaine, +1 et +2 en Europe), qui n’a pas bougé lors des 11 retours à zéro de l’octet 11 dans ce corpus. L’horodatage est déjà en UTC ; l’octet 12 dit seulement ce que le tableau de bord affichait.
  • Les types MBB sont 0xFB (en-tête : VIN, modèle, année-modèle, révisions de carte et de firmware, build du firmware), 0xFD (texte, la majeure partie), 0x51 / 0x52 / 0x53 (télémétrie d’état en trois tailles), 0x54 (moteur : couple à l’arbre, courant du moteur, tension du bus continu), 0x48 (un enregistrement de 49 octets par chargeur ayant répondu : nom, tension, courant et fréquence du secteur, sortie continue, identifiant CAN, numéro de série), 0x49 (plafond et cible de charge) et 0x4F (une file du firmware qui a débordé, presque toujours une file CAN). Tous sont décodés. Les longueurs d’enregistrement dépendent de la date du firmware : la même SR/F écrivait des enregistrements 0x51 de 71 octets en 2023 et de 75 octets en 2026.
  • Les types BMS sont 0xFB (en-tête), 0xFD (texte), 0x4B (52 o, la source de télémétrie principale), 0x4D (78 o, étendu) et 0x4C (70 o, détail des cellules). 0x4D et 0x4C ne sont pas 0x4B avec un suffixe : ils insèrent 8 et 4 octets après l’en-tête commun de 13 octets, si bien que chaque champ de mesure est décalé. Les lire aux décalages de 0x4B donne des tensions de cellule plausibles sur exactement zéro enregistrement.
  • Chaque page de 128 octets d’un fichier BMS Gen3, après la première, s’ouvre par 00 F0 FF 00, écrit PAR-DESSUS quatre octets de données d’enregistrement. Ce qui s’y trouvait a disparu : avant que le décodeur l’apprenne, 699 des 2 894 lignes de télémétrie qu’il émettait à partir de huit fichiers BMS lisaient au moins un champ à travers un marqueur, et dans 268 d’entre elles ce champ était un horodatage qui paraissait encore plausible, à une médiane de 22 jours de ses voisins. Les valeurs sous un marqueur sont désormais retenues, et les 612 enregistrements dont le 0xB2 du successeur a été détruit par le marqueur sont de nouveau délimités à leur longueur déclarée au lieu d’être perdus. Un marqueur sur l’octet de type d’un enregistrement laisse un horodatage de 0xHH00FFF0, la même seconde pour toutes les motos sur une période de 194 jours. C’est pourquoi 2025-10-28 17:40:00 UTC est apparu sur des motos sans rapport. Sur le corpus de production de 1 220 fichiers, la correction a supprimé 290 jours-fichiers falsifiés et 228 trajets sur la seule batterie.
  • Le texte BMS commence à l’octet 13 de l’enregistrement, juste après l’en-tête. Le décodeur prenait auparavant « le premier octet imprimable après l’octet 7 », ce qui, sur une moto en UTC+0, commençait à l’octet de séquence et s’arrêtait au zéro de l’octet de décalage : 53,5 % des événements texte du BMS étaient perdus et 14 % émis comme du bruit. Corrigé en 2026-10, cela plus que double les événements de la machine d’états du BMS qu’un fichier Gen3 natif fournit.
  • BMS payload[38:41] est une tension de batterie mesurée, un uint24 LE en millivolts, et non le « compteur interne » sous lequel il était rangé depuis des années. Il respecte l’enveloppe d’acceptation à 28 éléments en série sur 2 189 des 2 319 lignes de télémétrie que le décodeur en production émet à partir de sept fichiers BMS (94,4 %, et de 92,1 % à 96,5 % par fichier).
  • BMS payload[24] n’est PAS un code d’état. L’énumération 0x0B repos / 0x0C actif / 0x09 déverrouillage / 0x0A précharge est retirée : l’octet prend 37 valeurs distinctes, ces quatre-là couvrent 58,6 % des lignes, et il échoue à un test de compteur, à un test de température et à un test d’état textuel. Il est stocké tel quel et n’est décodé nulle part.
  • L’octet 67 de l’enregistrement n’est PAS un nombre de cycles de charge. C’est l’octet de poids faible du registre de capacité de pleine charge uint24 LE en record[67:70]. Un décodeur qui le lisait comme un nombre de cycles a été livré, puis annulé le jour même.
  • Vérifié enregistrement par enregistrement face à la branche principale du parseur communautaire (90c8cb2), alignée par décalage dans le fichier plutôt que par temps, sur les 18 fichiers Gen3 natifs disponibles ici : les 2 866 lectures de cellule, 1 727 états du véhicule, 119 enregistrements du chargeur et 18 rapports de file concordent ; chaque différence de courant et de tension de la batterie est un mot que l’un des deux côtés refuse comme flash effacé ou hors enveloppe, et la version amont ne décode aucun des 33 460 enregistrements texte.
  • La variante MBB à firmware 538XX est un piège d’aiguillage. Ses enregistrements 0x2c sont l’enregistrement « Riding Status » ordinaire de zero-log-parser amont, décodé depuis 2015. Ils portent la tension de la batterie sous forme d’entier uint32 exact en millivolts, le courant de batterie, le régime et cinq températures. Ils ne portent aucune vitesse sur route, et l’étalonnage ajusté que nous avions publié pour eux est retiré.
Sur cette page

La MBB Gen3 porte une télémétrie électrique clairsemée

La phrase par laquelle cette section s’ouvrait était trop forte. Une version antérieure de cette page disait qu’une MBB Gen3 native « ne contient ni tension de batterie, ni courant de batterie, ni vitesse sur route qu’un décodeur consomme ». C’était littéralement vrai et cela induisait en erreur, car le qualificatif portait toute l’affirmation : les octets étaient là et rien ne les lisait.

Sur une moto Gen3 native (la plateforme Cypher III / FST, c’est-à-dire les fichiers SR/F, SR/S et DSR/X sur lesquels ce corpus est construit), la carte principale (MBB) écrit la tension de la batterie en uint32 petit-boutiste en millivolts à record[34:38] et le courant de batterie en int32 signé en milliampères à record[38:42], et les deux sont renseignés exactement quand le système haute tension est actif : non nuls sur 144 enregistrements RUN sur 144, 5 REV sur 5, 4 PARK sur 4, et sur zéro des 417 HIB, zéro des 408 PWSU et zéro des 51 WAIT. Comme l’hibernation et la mise sous tension représentent à elles deux 75 % des enregistrements 0x51 d’un vrai log, ce champ est en pratique le plus souvent vide. Le décodeur en production l’extrait depuis le 2026-09-07, et seulement à partir d’un enregistrement dont le bus est actif : un zéro ici signifie « le système haute tension était coupé », pas « zéro volt mesuré », et le publier comme une lecture mettrait une mesure sur un graphique pour une moto endormie dans un garage. Le système de gestion de la batterie (BMS) reste donc la source sur laquelle construire, parce que les champs de la MBB, bien que présents, sont clairsemés.

La répartition des enregistrements rend la forme du fichier concrète. Sur huit fichiers MBB Gen3 natifs issus de cinq motos distinctes (131 200 octets chacun, 19 089 enregistrements sous délimitation par chaîne de longueurs), 16 553 enregistrements (86,7 %) sont des événements texte ASCII, 1 311 (6,9 %) sont des instantanés de télémétrie 0x51, 1 061 (5,6 %) sont des secondaires 0x54, 67 (0,35 %) sont des enregistrements étendus 0x52 et 8 sont des en-têtes de fichier. Un log MBB Gen3 est massivement un log texte doté d’une mince colonne vertébrale binaire. Le côté BMS a une forme semblable, mais sa colonne binaire est densément peuplée : les sept exports BMS contiennent 15 890 enregistrements, dont 13 178 (82,9 %) sont du texte, 1 803 (11,4 %) portent l’octet de type de télémétrie 0x4B, 691 (4,4 %) le type étendu 0x4D et 84 le 0x4C. Chaque nombre de cette page est désormais pris sous délimitation par chaîne de longueurs en respectant l’échappement, ce qui explique qu’ils soient légèrement au-dessus des chiffres par découpage aux intervalles qu’une version antérieure citait : la délimitation par chaîne retrouve environ 250 enregistrements de plus sur les mêmes huit fichiers MBB.

La preuve pour record[34:38] est un seuil de population plus une courbe physique, et non une corrélation. Le seuil de population est donné plus haut et il est sans exception. La courbe est meilleure : sur un fichier de 2021 (le tronçon tronqué de 16 ko, neuvième fichier MBB natif de ce corpus et celui qui est hors de la population des huit exports utilisée pour les chiffres de répartition), 32 enregistrements CHRG consécutifs montrent le champ qui monte de façon monotone de 102,081 V à 114,075 V en 5,51 heures, pendant que record[38:42] reste entre −11,6 A et −15,3 A et que le SOC passe de 41 à 100. Sur les six derniers enregistrements, le SOC est bloqué à 100 alors que la tension continue de monter de 111,8 V à 114,1 V. C’est une phase d’absorption à tension constante. Aucun champ de remplissage et aucune table de correspondance du SOC ne la produit. L’intégration de V·I sur ΔSOC donne environ 13,6 kWh sur ce fichier et environ 12,4 kWh sur un fichier de 2023, pour une batterie ZF14.4 de 14,4 kWh nominaux et 12,6 kWh utilisables. L’intégration par rectangles à gauche donne 13,55 et 12,41, et l’intégration trapézoïdale 13,58 et 12,40 : le résultat est donc cité à trois chiffres significatifs et ne dépend pas de la règle d’intégration. Une mise en garde sur les populations : ces enregistrements CHRG vivent dans la variante 0x51 de 71 octets, ce qui explique que le tableau des états plus bas dans cette page, compté sur les enregistrements de 75 octets, ne montre que sept lignes CHRG.

La réserve sur la portée est sévère, et c’est pourquoi ce n’est pas présenté comme acquis. Chaque point de donnée dynamique ci-dessus provient d’un VIN à préfixe 538ZF, la plateforme SR/F de 2020 à 2023. La seule vraie moto à WMI PAG de ce corpus, une DSR/X, apporte 278 enregistrements 0x51 répartis sur deux fichiers, dont 16 et 2 sont renseignés, un enregistrement RUN et aucun enregistrement CHRG. Aucun test de conservation ne peut être mené ici sur du matériel PAG. L’alternative qui survit, selon laquelle la disposition est commune mais le firmware de l’époque DSR/X ne la renseigne que dans des états que ce corpus contient à peine, n’est pas exclue.

Un mot distinct à record[21:25] mesure le même bus avec une moins bonne résolution. C’est un deuxième instrument, la tension du bus continu propre au contrôleur du moteur par pas de 100 mV, à côté de la tension de la batterie issue du BMS à record[34:38] au pas de 1 mV. L’argument en faveur du « même bus » est arithmétique plutôt que statistique. C’est un multiple de 100 mV sur 281 lectures non nulles sur 281, alors que record[34:38] est un multiple de 100 sur 2 sur 302 ; sur les 247 enregistrements où les deux sont renseignés, ils sont distants d’une médiane de 0,163 V ; et il est à zéro sur les 54 enregistrements CHRG alors que record[34:38] est renseigné sur 47 d’entre eux. Préférez record[34:38]. Une version antérieure de cette page défendait record[21:25] à partir d’une corrélation de Pearson avec la tension de batterie du BMS ; cet argument est retiré. Refaite sur une paire MBB et BMS de SR/F de 2025-12, en associant 129 enregistrements RUN à une ligne BMS à moins de 60 secondes, sept fenêtres uint32 de l’enregistrement obtiennent |r| ≥ 0,90, et la plus forte est la fenêtre au décalage 30, à 0,925, devant record[21:25] à 0,907. Une corrélation n’identifie pas un décalage, et la traiter comme si elle le faisait est l’erreur qui a mis un rail de 12 V sur cette page comme compteur kilométrique.

record[25:29] et record[29:33] sont le courant du bus continu du contrôleur, un int32 signé en milliampères, et le régime du moteur, un int32 signé. Les deux ont été résolus le 2026-09-07 et sont décodés depuis, à condition que le bus soit actif comme pour les tensions. Cette page disait auparavant qu’aucun n’était résolu, et la raison était qu’un enregistrement 0x51 natif ne porte aucune référence de vitesse indépendante. Les enregistrements plus longs 0x52 et 0x53 en ont une : ils portent une vitesse sur route dans leur queue, et la diviser par le régime du même enregistrement donne une constante sur tout un trajet : 0,0252 km/h par tr/min sur chaque ligne de l’ancienne disposition et 0,0266 sur la moto de la nouvelle disposition. Cette constante est le rapport de transmission, et un champ qui n’est pas un régime ne la maintient pas fixe. Le courant du bus continu ne montre toujours aucune corrélation utile avec le courant de batterie du BMS, quelle que soit la tolérance de jointure essayée (|r| ≤ 0,16), parce que les deux cartes n’échantillonnent pas ensemble ; il est publié comme la lecture du contrôleur et rien de plus.

Ce que chaque décodeur écrit, pas ce que le firmware encodeLes canaux du MBB Gen3 natif sont décodés mais conditionnés à un état ou à un type d’enregistrement. L’accélérateur n’existe sur aucun chemin.Gen2 MBBGen2 BMSnativeGen3 MBB538XX MBBGen3 BMSpack voltagepack currentspeedmotor RPMSOCodometer12 V accessorycell mVmotor tempambient tempthrottledécodé par échantillonpartiel : issu du texte ou conditionné à un étatoctets présents, rien ne les litabsent du formatLa ligne de l’accélérateur est volontairement pleine de croix. LogEntry.throttle_pct existe dans le schéma (migration 20241206_001) et est unecolonne des exports CSV et FIT, mais aucun décodeur ne l’affecte jamais : la valeur est NULL pour toutes les générations.
Lu comme : ce que backend/app/parser.py écrit sur l’objet d’entrée, pas ce que le firmware encode. La distinction pèse sur plusieurs lignes. La tension et le courant de la batterie du MBB Gen3 natif étaient marqués octets présents, rien ne les lit jusqu’en 2026-10 : ils se trouvent à record[34:38] et record[38:42], non nuls sur 144/144 enregistrements RUN et 0/417 enregistrements HIB, et sont décodés depuis le 2026-09-07. Ils sont partiels parce qu’un zéro à cet endroit signifie que le bus est coupé, pas zéro volt. Le compteur kilométrique est partiel pour une autre raison : il n’y en a aucun dans le 0x51 de 75 octets, et celui de la queue des 0x52/0x53 plus longs n’existe que sur la structure de firmware plus récente. Le champ publié ici comme tel jusqu’au 2026-07-29, record[71:75], est une tension analogique quantifiée par le CAN : chacun des 1 121 enregistrements 0x51 complets de 75 octets satisfait v = 5 128k + 4 864 µV, et il baisse sur autant d’échantillons consécutifs qu’il monte (51,5 % non décroissants), ce qu’aucun compteur kilométrique ne fait. Cela est prouvé. Le lire précisément comme le réseau accessoire 12 V ne l’est pas : c’est une identification a posteriori, de grande confiance parce que les événements texte du firmware citent les réseaux DC-DC et batterie dans exactement ces unités et cette plage, mais non vérifiée par une mesure. La ligne est étiquetée sur cette base et la valeur est stockée brute, en microvolts, sous un nom qui ne peut pas être pris pour une distance. Partiel couvre aussi des valeurs qui ne sont pas un canal par échantillon : la température du moteur du MBB Gen3 natif est post_1 et vaut zéro dès que le moteur ne tourne pas, alors que l’ambiante est post_0 (les cinq mots d’état « post » étaient étiquetés avec un cran de décalage jusqu’au 2026-09-07, où post_2 était stocké comme la température du moteur ; c’est l’onduleur), et les mV de cellule du MBB Gen2 n’apparaissent que sous min_cell_mv dans les événements de limite de décharge. Ces températures ne sont pas à zéro hors WAKE, STOP et CHRG, comme cette légende le prétendait aussi jusqu’au 2026-07-29. Sur les neuf fichiers MBB Gen3 natifs, découpés par chaîne de longueurs : RUN renseigne les quatre champs de température d’état « post » sur 144/144 des enregistrements 0x51 complets de 75 octets, plus 57/57 enregistrements 0x52 et 31/31 0x53 également en RUN. Le stationnement les met le plus souvent, pas toujours, à zéro : HIB porte post_1/post_2 sur 4,8 % des enregistrements (20/417) et PWSU porte post_3/post_4 sur 8,3 % (34/408), jamais l’ensemble complet. Les dénominateurs 141/408/403 publiés ici jusqu’au 2026-07-30 ne correspondent à aucun découpage que ce décodeur ait jamais utilisé. La colonne 538XX perd sa marque de vitesse : ce canal était dérivé du régime par une constante ajustée et a été retiré. Les rapports décodés par ce chemin sont stockés avec log_generation = 3 ; « Gen3 » dans la base est donc un ensemble plus large que « Gen3 natif » ici.

Une exception documentée

La variante MBB à firmware 538XX porte bien la tension de la batterie, le courant de batterie, le courant du moteur et cinq températures dans un enregistrement que le décodeur en production lit. C’est une moto de l’ère Gen2 dont la MBB a été mise à jour vers un tampon circulaire de style Gen3, et les rapports décodés par ce chemin sont stockés avec log_generation = 3. « Gen3 » dans une base de données n’est donc pas le même ensemble que « Gen3 natif » dans ce document. Elle ne porte pas de vitesse sur route (voir le retrait dans cette section).

Délimitation : une seule forme d’enregistrement, un seul délimiteur et un échappement par bourrage d’octets

Chaque enregistrement Gen3 (MBB, BMS et variante 538XX confondus) commence par le même en-tête. L’octet 0 est le délimiteur 0xB2. L’octet 1 est la longueur totale de l’enregistrement sur disque en octets, délimiteur et octets d’échappement éventuels compris. L’octet 2 est le type d’enregistrement. Les octets 3 à 6 sont un horodatage Unix en uint32 petit-boutiste, les octets 7 à 10 sont la partie inférieure à la seconde en microsecondes, l’octet 11 est un compteur de séquence qui augmente de un à chaque enregistrement de chaque type, modulo 256, et l’octet 12 est le réglage de décalage UTC de la moto en heures entières, sous forme d’octet signé. La charge utile suit à partir de l’octet 13 et son interprétation dépend entièrement de l’octet de type.

Les octets 11 et 12 sont deux champs, un numéro de séquence et le réglage de décalage UTC de la moto, et cette page les publiait auparavant comme un seul compteur de 16 bits. La section suivante cartographie les 13 octets de l’en-tête, avec le sens de chaque valeur et ce que l’octet de séquence révèle d’un fichier.

0xB2 est un octet de données ordinaire, donc l’écriture l’échappe. Une version antérieure de cette spécification ne mentionnait l’échappement nulle part. La séquence de deux octets FE 4D sur disque se décode en 0xB2, et FE 01 se décode en 0xFE. Par conséquent, un enregistrement bien formé ne contient jamais de 0xB2 brut après l’octet 0. Mesuré, il n’y en a aucune occurrence dans les 1 010 093 octets SUR DISQUE de record[2:] (tout l’enregistrement sauf le délimiteur et l’octet de longueur) sur les 19 342 enregistrements enchaînés par longueur dans les neuf fichiers MBB Gen3 natifs de ce corpus, et aucune dans les enregistrements BMS Gen3 natifs. « Sur disque » est essentiel : déséchappez ces mêmes enregistrements et ils contiennent 264 octets 0xB2 bruts, ce qui est tout l’intérêt de l’échappement. Le recensement sur la même population de neuf fichiers : 504 enregistrements portent au moins un échappement, 518 octets d’échappement au total, décodés en 264 × FE 4D → 0xB2 et 254 × FE 01 → 0xFE, avec zéro paire FE xx anormale. Sur les seuls huit exports d’appli de pleine taille (la population que tous les chiffres de répartition de cette page utilisent), le même recensement donne 19 089 enregistrements, 994 299 octets de charge utile sur disque, 468 enregistrements échappés et 477 octets d’échappement. Citez l’un ou l’autre recensement en nommant sa population. L’absence de 0xB2 brut est la garantie que le bourrage d’octets existe pour fournir.

L’ordre compte, et le prendre à l’envers est ce qui a produit le mauvais diagnostic que cette page publiait. Délimitez d’abord par la longueur déclarée, puis déséchappez le corps délimité. L’octet 1 est le seul champ situé en dehors de la zone échappée ; c’est donc le seul champ qu’un lecteur peut croire avant de déséchapper : l’octet de type, l’horodatage et chaque décalage de la charge utile se décalent quand un échappement tombe devant eux. Déséchapper tout le tampon puis le couper sur 0xB2 déchiquette bel et bien le fichier, parce que le déséchappement réintroduit des octets 0xB2 au milieu de la charge utile. C’est un argument sur l’ordre, pas une preuve que le délimiteur revient.

Trois décodeurs de ce projet délimitent différemment, pour des raisons historiques plutôt que bonnes. Seul le chemin MBB Gen3 natif enchaîne par la longueur déclarée : lire l’octet 1, avancer d’autant et se resynchroniser sur le 0xB2 suivant si la chaîne se rompt. Sur le corpus MBB natif de neuf fichiers, cela donne 19 342 enregistrements pour 19 351 délimiteurs avec 17 resynchronisations. Cela fait environ deux ruptures structurelles par fichier, toutes deux attendues : l’en-tête de fichier de 128 octets, dont les 117 octets déclarés n’atteignent pas le corps, et l’enregistrement déchiré au bouclage du tampon circulaire. Le chemin BMS Gen3 coupe encore aux intervalles entre délimiteurs puis déséchappe chaque tranche, sauf là où un marqueur de page flash a écrasé le 0xB2 de l’enregistrement suivant ; dans ce cas, il ramène l’intervalle à la longueur déclarée (voir la section sur le marqueur de page). Le chemin 538XX ne fait ni l’un ni l’autre : il balaie octet par octet, déséchappe chaque candidat, l’accepte sur la barrière de l’horodatage, puis avance d’un octet plutôt que de la longueur de l’enregistrement ; il évalue donc des candidats qui se chevauchent et laisse les garde-fous propres à chaque type les absorber. Tout ce qui est compté sur ce chemin est un décompte par candidat, pas un décompte d’enregistrements délimités, et cette page le dit partout où elle en cite un. Les trois sont assez corrects sur ce corpus ; c’est la chaîne qu’il faut implémenter, parce qu’elle se dégrade avec grâce et que ni l’un ni l’autre des deux autres ne le fait.

L’arithmétique des longueurs est la preuve la plus nette que l’échappement est universel. Soustrayez le nombre d’octets d’échappement de la longueur déclarée et chaque type d’enregistrement se ramène à une seule valeur canonique, sans exception : le 0x51 de la MBB native tombe sur 71 ou 75, le 0x54 sur 29, le 0x48 sur 62, le 0x49 sur 38 ; le 0x4B du BMS sur 52, le 0x4C sur 70, le 0x4D sur 78 ; et sur la variante 538XX, le 0x2c tombe sur exactement 40 dans 19 516 enregistrements sur 19 516 dont les longueurs sur disque se répartissent entre 40 (17 720 d’entre eux), 41 (1 688) et 42 (108). C’est une population obtenue par balayage d’octets sur les 14 fichiers retenus : ce sont donc des candidats et non des enregistrements enchaînés. Deux autres oracles qui ne touchent jamais l’octet de longueur concordent : l’octet de séquence à record[11] est retrouvé par déséchappement sur 360 enregistrements sur 360 où un échappement le précède et où ses deux voisins le fixent à une seule valeur (octets bruts : 9 sur 360, sur les dix fichiers MBB Gen3 natifs de ce corpus au 2026-10), et l’horodatage tombe dans l’encadrement de ses voisins sur 19 sur 19 (brut : 0 sur 19).

Seules ces deux séquences se produisent jamais, donc la transformation générale est sous-déterminée. Le zero-log-parser amont implémente FE xx comme 0xFE XOR (xx − 1) ; la forme plus simple xx XOR 0xFF est identique pour tout xx impair, et les deux successeurs observés sont impairs. Implémentez les deux correspondances démontrées et traitez toute autre paire FE xx comme une anomalie à compter et à signaler plutôt qu’à transformer. Leur nombre dépend du décodeur qui a parcouru les octets, alors nommez-le : avec les trois délimiteurs livrés, ce corpus de 352 fichiers en donne 17 au total : 12 sur les 135 fichiers à signature 538XX sous balayage d’octets, 5 (tous FE 00) dans les sept fichiers BMS Gen3 natifs, et aucun dans les neuf fichiers MBB Gen3 natifs. Les 12 ont pour successeurs 0x27 trois fois, 0x64, 0xC1 et 0x00 deux fois chacun, et 0x0F, 0xC2 et 0x84 une fois chacun. Un chiffre concurrent de 13 est aussi juste et correspond à une autre population : c’est ce que compte le décodeur du navigateur sur sa route de production, et il se décompose en 5 dans les fichiers BMS, 8 dans les fichiers MBB Gen2 que le classificateur envoie au délimiteur par chaîne de longueurs, et zéro dans les 14 vrais fichiers 538XX. BinaryTools.unescape_block de la version amont implémente cela pour la Gen2 depuis toujours ; un décodeur bâti sur cette bibliothèque n’a donc besoin d’aucun cas particulier pour la Gen3.

Ignorer l’échappement coûte des enregistrements entiers. Sur le firmware 538XX, l’ancienne barrière testait la longueur sur disque contre 40, ce qui écarte par construction tout enregistrement de télémétrie échappé : 1 796 enregistrements sur le corpus. La perte est corrélée aux valeurs, car un enregistrement devient irreprésentable exactement quand l’un de ses octets décodés vaut 0xB2 ou 0xFE. Des périodes entières de stationnement disparaissent d’un coup au lieu de s’éclaircir. Du côté MBB Gen3 natif, 504 des 19 342 enregistrements du recensement de neuf fichiers portent un échappement, et 291 d’entre eux se décodent en une autre date une fois l’échappement respecté, parce que l’échappement se trouve dans le champ d’horodatage ou devant lui.

Un enregistrement 0xB2Commun au MBB Gen3 natif, au BMS Gen3 et à la variante MBB 538XX[0]0xB2delimiter[1]sizeON-DISK[2]typeuint8[3:7]timestampuint32 LE, s Unix[7:11]microsecondsuint32 LE[11]sequint8[12]UTCint8 h[13:]payloadtype-specificA · découper selon la longueur déclarée, puis déséchappercorrect : l’octet 1 est le seul champ hors de la zone échappéesur disqueB20481512FE34D45354C6617D082A90F1000116012F91300140015001600170A1800190020002100220023taille déclarée octet[1] = 0x48 = 72 octets sur disque (l’enregistrement continue après cette bande)FE 4D → B2 · une paire d’échappement, dans le champ d’horodatagedécodéB20481512B235344C5616D072A80F900106011F91200130014001500160A1700180019002000210022longueur canonique 71 = 72 − 1 échappementOctets d’horodatage [3:7] décodés = B2 53 4C 61 = 0x614C53B2 → 2021-09-23 12:15:14, dans la fenêtre du découpeur.Lus tels que sur la liaison : FE 4D 53 4C = 0x4C534DFE → 2010-07-31, hors de la fenêtre. L’enregistrement est jeté.B · déséchapper tout le tampon, puis découper sur 0xB2échec : l’échappement existe pour garder cet octet hors du corpsB20481512B235344C5616D072A80F900106011F91200130014001500160A1700180019002000210022fragment 1 : 3 ofragment 2 : 68 o, pas d’en-tête valideUn enregistrement devient deux fragments. Aucun ne porte d’horodatage plausible à +3, donc les deux sont écartés, etc’est l’échec qu’on a longtemps pris pour « 0xB2 revient dans les charges utiles ».
Chaque enregistrement de la famille Gen3 commence par B2 · taille · type · horodatage uint32 LE · microsecondes uint32 LE · séquence uint8 · décalage UTC int8. Les deux derniers étaient dessinés ici comme un seul « compteur » uint16 jusqu’en 2026-10, et l’octet 12 est le réglage de fuseau horaire de la moto, pas l’octet de poids fort d’un compteur. Les bandes ci-dessous montrent un vrai enregistrement 0x51, tel quel, issu d’un dump SR/S de 2021 (le tronçon tronqué de 16 ko, qui est le neuvième fichier MBB Gen3 natif et sort du recensement des huit dumps d’appli sur lequel reposent les décomptes cumulés de cette page), avec une paire d’échappement FE 4D dans son champ d’horodatage. L’ordre compte : découper selon la longueur déclarée sur disque, puis déséchapper ce qu’on a découpé. Faites l’inverse et le 0xB2 récupéré devient un délimiteur au milieu de votre propre enregistrement. Sur les 14 dumps 538XX adoptés dans logs/, il y a 96 727 octets 0xB2 ; en suivant la chaîne des longueurs et en se resynchronisant à chaque déchirure du tampon circulaire, 96 632 d’entre eux (99,90 %) sont de vrais débuts d’enregistrement, 61 tombent à l’intérieur d’un enregistrement découpé et 34 ne sont jamais découpés du tout. Si l’on restreint « intérieur » à à l’intérieur d’un enregistrement dont la longueur déclarée tombe exactement sur le début de l’enregistrement suivant, le chiffre tombe à 2, car l’écrivain échappe le reste. zero-log-parser LOG_STRUCTURE.md documente le même échappement pour la Gen2, et son BinaryTools.unescape_block l’implémente.
Quel décodeur reçoit le fichierMBB file bytes_is_538xx_mbb_variant(raw)raw[0:4] == b'MBB\0' AND raw[38:42] == A1 A1 A1 A1run _parse_538xx_mbb_entries() over the whole bufferoutcome gaten_state ≥ 10 AND telemetry_wire_exact ≥ 50 ← the PRE-unescape countis_definitely_pre_gen3(vin, model) ← hard vetomodel ∈ {S, SR, DS, DSR, FX, FXS, XU}OR VIN[9] ∈ 'ABCDEFGHJ' (2010–2018)any positive signal?model ∈ {SR/F, SR/S, DSR/X, FXE} · VIN ~ (ZF[A-Z]Z|XXFZ|DZ[A-Z]Z)OR: ASCII 'MBB' in raw[:32] AND ≥ 10 0xB2 bytes ← the overridenone counts unless the records carry the FST header (gen3_mbb_fst_layout)ouinonopas de signatureréussiteouiouidécodeur 538XX adoptélog_generation = 3recharge MBB laissée au BMSchemin Gen1 / Gen2JSON de zero-log-parser (amont)→ _json_to_mbb_entriesdécodeur Gen3 natif_parse_gen3_mbb_entries+ _extract_gen3_telemetryIndépendamment de tout cela, les deux découpeurs binaires Gen3 écartent tout enregistrement dont l’horodatage uint32 à +3 tombe hors de2019-01-01 (Unix 1546300800) … aujourd’hui + 365 jours.
Le classificateur n’a nulle part de seuil d’année. La branche à surveiller est la dernière. « Un tampon circulaire 0xB2 renseigné dans le binaire » signifie, dans le code, seulement ceci : les octets ASCII MBB quelque part dans les 32 premiers octets, plus au moins dix octets 0xB2 n’importe où dans le fichier. Un fichier 538XX remplit trivialement les deux (son en-tête est MBB\0), si bien que le pipeline journalise « Gen3 detected from binary structure » et ne prend jamais le chemin JSON Gen2 amont. Ce forçage, et non une lacune du format, a envoyé neuf des quatorze fichiers 538XX de logs/ à zéro trajet. Le zero-log-parser amont décode leurs enregistrements 0x2c Riding Status depuis 2015 et, tel que ce site l’a exécuté en juillet 2026, il a lu l’un de ces fichiers comme 7 629 entrées dont 2 048 lignes Riding structurées. Une version antérieure de cette légende disait que les deux mauvais routages « produisent une sortie vide » et que sur le chemin Gen2 l’amont décode chaque enregistrement en une ligne « Board Status » vide ; la seconde moitié est fausse. La sonde 538XX s’exécute donc avant la décision de routage, pour passer devant le forçage. Les vrais fichiers MBB Gen2 partagent la signature MBB\0 + A1 A1 A1 A1 et écrivent le même enregistrement 0x2c de 40 octets : ni la signature ni le type d’enregistrement ne discriminent. Seule la porte de résultat le fait, en comptant une population avant déséchappement qui est elle-même un artefact d’un bogue corrigé. Sur les 135 fichiers à signature de logs/, cette porte en adopte 14, en maintient 30 sur le chemin Gen2 et en rejette 91. Les 30 fichiers maintenus sont la raison pour laquelle le compteur n’a pas été remplacé par celui d’après déséchappement : ils décodent maintenant de 425 à 2 408 entrées de télémétrie chacun tout en marquant 0 à 8 en « wire-exact », et c’est ce seul chiffre qui les garde sur un chemin Gen2 où leur décodage amont (dans la version que ce site épingle) est complet et correct. Notez aussi que la docstring de _is_538xx_mbb_variant dit qu’elle « must only be consulted INSIDE the firmware-format fallback » ; le code de routage l’appelle sans condition pour les fichiers MBB, et c’est le code qui s’exécute. Depuis le 2026-10-03, la dernière case a une porte devant elle : aucun de ses signaux n’envoie un MBB vers le décodeur natif à moins que les enregistrements portent l’en-tête d’enregistrement FST (gen3_mbb_fst_layout). Trente-sept fichiers distincts à conteneur Gen2 de logs/ y avaient été envoyés par le forçage ou par la branche VIN XXFZ, avec chaque message lu six caractères trop tard et sans compteur kilométrique ni trajet décodé ; 36 d’entre eux prennent maintenant le décodage Gen2 amont.
L’en-tête d’enregistrement commun (les décalages sont absolus par rapport à l’enregistrement, après déséchappement)
byte[0]     0xB2        delimiter / fencepost marker
byte[1]     length      total ON-DISK record size in bytes, including byte 0
                        and including any 0xFE escape bytes
byte[2]     type        record type (0xFB, 0xFD, 0x51, 0x52, 0x53, 0x54, 0x48, 0x49,
                        0x4F on the MBB; 0x4B, 0x4C, 0x4D on the BMS; 0x2c on 538XX)
byte[3:7]   timestamp   Unix seconds, uint32 little-endian, TRUE UTC
byte[7:11]  microsec    sub-second part of the timestamp, uint32 LE, at most 1,000,000
byte[11]    sequence    uint8, +1 per record of ANY type, mod 256
byte[12]    utc offset  int8, the bike's time-zone setting in hours (0xF9 = -7).
                        Informational: never add it to the timestamp
byte[13:]   payload     type-specific; text records start their ASCII here

escape      FE 4D  ->  B2
            FE 01  ->  FE
            any other FE xx: an anomaly. Count it, surface it, do not transform it.

Deux repères sont en jeu et les confondre coûte un après-midi. Ces décalages sont absolus par rapport à l’enregistrement, mesurés depuis le 0xB2. Le zero-log-parser amont découpe log_data[address+2 : address+length], le déséchappe, puis prend message = block[5:] ; un décalage de charge utile amont est donc inférieur de 7 au décalage absolu utilisé ici, et un champ d’état à record[42] se trouve à payload[35] côté amont. Le décodeur propre à ce projet passe raw_entry[6:] en interne, un troisième repère, ce qui explique que record[17] apparaisse dans le code source sous la forme binary_data[11]. Une version antérieure de cette page disait que la charge utile amont commençait à l’octet 6 de l’enregistrement ; c’était la convention de ce projet, pas celle de l’amont.

Délimiter par la longueur déclarée, puis déséchapper

Le délimiteur n’apparaît jamais brut à l’intérieur d’un enregistrement bien formé, parce que l’écriture l’échappe : FE 4D se décode en 0xB2 et FE 01 en 0xFE. Couper sur chaque 0xB2 fonctionne donc mieux qu’il n’en a le droit, mais l’échappement doit quand même être respecté, car la longueur déclarée compte des octets sur disque. Délimitez par l’octet 1, puis déséchappez l’enregistrement délimité. Déséchapper d’abord tout le tampon réintroduit 0xB2 au milieu de la charge utile et fait mesurablement pire. Cette page vous disait auparavant le contraire, que 0xB2 revient à l’intérieur des charges utiles et que c’est la raison pour laquelle un découpage naïf échoue ; sur le firmware 538XX qu’elle nomme, 96 632 des 96 727 octets 0xB2 des 14 fichiers retenus (99,90 %) sont de vrais débuts d’enregistrement sous délimitation par chaîne de longueurs, 34 ne sont jamais délimités du tout et 61 tombent à l’intérieur d’un enregistrement. Sur ces 61, seuls 2 se trouvent dans un enregistrement dont la longueur déclarée tombe exactement sur le début de l’enregistrement suivant. Les 59 autres sont aux déchirures de bouclage du tampon circulaire, où « à l’intérieur d’un enregistrement » veut dire à l’intérieur d’une trame que la chaîne avait déjà perdue.

L’en-tête d’enregistrement de 13 octets, octet par octet

Chaque enregistrement Gen3 natif s’ouvre par les mêmes 13 octets, sur la carte principale comme sur la carte de gestion de la batterie, et cinq de ses champs valent la peine d’être lus pour eux-mêmes : la longueur qui délimite l’enregistrement, le type qui décide comment le lire, un horodatage UTC à la microseconde, un numéro de séquence par enregistrement et le réglage de fuseau horaire de la moto. Le tableau en est la carte. Les mesures à côté portent sur les 18 fichiers Gen3 natifs de ce corpus (dix de carte principale et huit de carte de gestion de la batterie) et ne comptent que les enregistrements dont les 13 octets d’en-tête n’ont été touchés par aucun marqueur de page flash.

Les octets 7 à 10 sont la partie de l’horodatage inférieure à la seconde, en microsecondes. Ils ne dépassent jamais une seconde : la plus grande valeur sur tous les en-têtes intacts de ces 18 fichiers vaut exactement 1 000 000, et pas un enregistrement ne la dépasse. Cette borne est plus utile qu’elle n’en a l’air, car un enregistrement de l’ancienne disposition place de la charge utile dans ces quatre mêmes octets et la franchit presque à chaque enregistrement, ce qui permet au décodeur de distinguer les deux dispositions (voir « Deux dispositions d’enregistrement, décidées par fichier » plus bas).

Ce site a publié les octets 11 et 12 comme un unique « compteur d’entrées » uint16 petit-boutiste à [11:13] jusqu’en octobre 2026, sur cette page et dans la documentation de son propre décodeur. C’était faux, et la mesure qui le montre est courte. Un compteur de 16 bits reporte dans son octet de poids fort quand l’octet de poids faible passe de 255 à 0 ; l’octet 11 boucle 11 fois dans ces fichiers (neuf fois sur les cartes principales, deux fois sur les batteries), et à chacun de ces bouclages l’octet 12 est resté exactement où il était. Ce sont deux champs : un numéro de séquence d’un octet et le réglage de décalage UTC de la moto.

L’en-tête d’enregistrement Gen3 commun (décalages après déséchappement, sauf l’octet 1)
OctetsChampComment le lireMesuré sur les 18 fichiers natifs
0Délimiteur0xB2. Jamais brut à l’intérieur d’un enregistrement : l’écriture l’échappe en FE 4D, et un 0xFE littéral en FE 01Délimitez d’abord par l’octet 1, puis déséchappez ce que vous avez délimité
1LongueurTaille TOTALE sur disque, octet 0 et chaque octet d’échappement compris. Seul champ hors de la zone échappée, donc le seul à croire avant le déséchappementMoins le nombre d’échappements, chaque type d’enregistrement tombe sur une seule longueur canonique
2Type0xFB en-tête, 0xFD texte, 0x51 à 0x54, 0x48, 0x49 et 0x4F sur la carte principale ; 0x4B, 0x4C et 0x4D sur la batterieÀ lire après le déséchappement, comme tout ce qui suit
3–6Horodatageuint32 petit-boutiste, secondes Unix, UTC réelL’octet 6 change une fois toutes les 2^24 secondes, soit environ 194 jours
7–10Microsecondesuint32 petit-boutiste, partie de l’horodatage inférieure à la secondeMaximum exactement 1 000 000 ; jamais au-dessus
11Séquenceuint8, +1 par enregistrement de tout type, repasse de 255 à 0 et repart à 0 quand la carte se réveille+1 entre 96,4 % des enregistrements adjacents de la carte principale et 96,1 % de ceux de la batterie
12Décalage UTCint8, le réglage de correction horaire de la moto en heures entières. À titre indicatif : ne l’ajoutez jamais à l’horodatage−7, 0, +1, +2 et +8 observés ; constant sur de longues périodes
13…Charge utilePropre à chaque type. L’ASCII terminé par NUL d’un enregistrement texte 0xFD commence iciL’octet 13 est imprimable sur 8 786 des 8 788 enregistrements texte de batterie qu’aucun marqueur n’a touchés, et sur 18 570 des 18 570 enregistrements texte de la carte principale

Le zero-log-parser amont lit les octets 7 à 12 comme un préfixe de six octets placé devant sa charge utile : un mot inférieur à la seconde en microsecondes, un compteur de séquence par entrée (qu’il a mesuré augmentant de un entre 97,3 % de 826 535 entrées adjacentes) et un octet qu’il laisse sans nom, un « marqueur », en notant qu’y lire un décalage UTC reste une question ouverte. Les microsecondes et la séquence ont été trouvées en premier par l’amont.

Ce que révèle l’octet de séquence

L’octet 11 est le contrôle d’intégrité le moins cher du format. Il augmente de un à chaque enregistrement que la carte écrit, quel que soit son type : deux enregistrements voisins dans le fichier doivent donc différer d’exactement un. Sur les paires d’enregistrements intacts adjacents sur disque dans les 18 fichiers natifs, c’est le cas pour 20 913 des 21 693 paires de la carte principale (96,4 %) et pour 13 628 des 14 177 paires de batterie (96,1 %). Les exceptions ne sont pas du bruit. Chaque sorte dit quelque chose du fichier :

  • Un retour à zéro : 506 sur les cartes principales et 536 sur les batteries. Le compteur repart quand la carte se réveille : 499 et 530 de ces retours suivent au moins une minute de silence, et l’enregistrement qui prend le numéro 0 est la propre ligne de réveil de la carte : « Board was reset » sur 453 des retours de la carte principale et « Exiting Hibernate » sur 51, et sur les batteries les deux mêmes lignes presque à chaque fois. Un retour à zéro marque une frontière de démarrage que l’on peut trouver sans lire aucun texte.
  • Un saut en avant de plus d’un : 268 sur les cartes principales, 3 sur les batteries. Les deux enregistrements sont voisins sur le disque, mais les numéros qui les séparent ont été pris par des enregistrements qui ne sont pas à cet endroit du fichier.
  • Un pas en arrière : 6 sur les cartes principales. Au sein d’une même seconde, la carte range parfois les enregistrements hors de l’ordre de leur numérotation (une série se lit 12, 14, 13, 15) : même à l’intérieur d’une seconde, la position dans le fichier n’est donc pas toujours l’ordre dans lequel les enregistrements ont été numérotés.
  • Un saut au bouclage du tampon circulaire (10 sur les batteries), là où l’enregistrement le plus récent du tampon est suivi du plus ancien.
  • Les 11 passages de 255 à 0 sont des pas ordinaires de +1, et l’octet 12 n’a bougé à aucun d’eux.
L’octet fait huit bits et repart à chaque réveil : il contrôle donc les voisins et rien de plus, et ne sert jamais de clé de tri. Le décodeur de ce site ordonne les enregistrements par horodatage et par leur place dans le parcours, et publie l’octet 11 à part, sous le nom bms_sequence sur les lignes de batterie.

Octet 12 : le réglage de décalage UTC de la moto

L’octet 12 est un octet signé qui contient le réglage de correction horaire de la moto en heures entières : le décalage que le tableau de bord applique pour afficher l’heure locale. L’horodatage des octets 3 à 6 est déjà en UTC ; la console de la batterie le prouve en affichant la même époque à côté de son propre rendu. Le décalage est donc indicatif : il dit ce que le pilote voyait sur le tableau de bord, jamais comment déplacer une heure stockée, et un décodeur qui l’ajoute à l’horodatage décale de plusieurs heures chaque événement du fichier. Le décodeur de ce site le stocke une fois par fichier, comme la valeur la plus fréquente, en gardant à côté toutes les autres valeurs qu’il a vues.

Cinq des 18 fichiers portent une seconde valeur. Un changement à l’intérieur d’un fichier est un changement du réglage, pas de l’horloge : un pilote qui avance le tableau de bord d’une heure pour l’heure d’été, ou une carte qui a écrit quelques enregistrements avant que son réglage stocké soit chargé. Les nombres ressemblent aux deux : 2 205 enregistrements à +1 après 33 à +2, 2 300 à 0 à côté de 33 à +1, 2 362 à +2 à côté de 18 à +1, 2 112 à +1 à côté de 2 à 0 sur une batterie, et une carte principale avec 69 enregistrements à −7 avant 2 347 à 0. Dans tous les cas, les horodatages restent en UTC : rien ne bouge sur une chronologie ; seule change l’étiquette qu’un pilote aurait lue. L’ensemble de fichiers de l’amont, plus grand, montre surtout 0xF9, 0x02, 0xFC, 0xFB et 0x01 dans cet octet (−7, +2, −4, −5 et +1 en décalages), tous des fuseaux horaires civils.

Valeurs de l’octet 12 dans les 18 fichiers Gen3 natifs, sur les enregistrements dont l’en-tête est intact
ValeurOctetFichiers où c’est le réglageEnregistrementsCe que cela signifie
−70xF91 carte principale322Sept heures à l’ouest de l’UTC, un réglage nord-américain
00x003 cartes principales, 3 batteries13 315UTC, par exemple le Royaume-Uni hors heure d’été
+10x012 cartes principales, 2 batteries8 877Europe centrale en hiver, ou Royaume-Uni en été
+20x022 cartes principales, 1 batterie6 883Europe centrale en été
+80x082 cartes principales, 2 batteries8 908Huit heures à l’est de l’UTC

Une valeur hors de −12 à +14 n’est pas un fuseau horaire civil, et le décodeur n’en lit pas à cet endroit. Sur un fichier de batterie, c’est en général un marqueur de page posé sur l’octet, raison pour laquelle le résumé par fichier ne compte que les enregistrements dont l’en-tête n’a été touché par aucun marqueur.

Retiré ici : « un compteur d’entrées uint16 à [11:13] »

Jusqu’en octobre 2026, cette page et la documentation du décodeur de ce site décrivaient les octets 11 et 12 comme un seul compteur d’entrées de 16 bits petit-boutiste. Un compteur de 16 bits reporte dans son octet de poids fort quand l’octet de poids faible boucle ; aux 11 bouclages de l’octet 11 de ce corpus, l’octet 12 n’a pas bougé, et l’octet 12 ne prend que la poignée de valeurs du tableau ci-dessus. Lu comme un compteur, il plaçait chaque enregistrement d’une moto en UTC+2 se situait 512 numéros au-dessus de ceux d’une moto en UTC0, sans aucune raison.

Quels fichiers comptent comme Gen3

Il n’y a pas de seuil d’année-modèle dans le classificateur. Un log est traité comme Gen3 quand un veto strict ne se déclenche pas et qu’au moins l’un de trois signaux positifs se déclenche ou, à défaut, quand un forçage d’aiguillage distinct, extérieur au classificateur, l’attrape. Il importe de respecter cet ordre, car le délimiteur 0xB2 est partagé avec les fichiers MbbD Gen2 au format concessionnaire, et un fichier Gen2 classé à tort comme Gen3 perd en silence ses événements Sevcon et ceux de la poignée d’accélérateur.

Le veto strict se déclenche quand le modèle est S, SR, DS, DSR, FX, FXS ou XU, ou quand le code d’année du VIN (le dixième caractère) est une lettre de A à J, ce qui correspond aux années-modèles 2010 à 2018. Le code d’année K (2019) est le premier que le veto cesse de rejeter, ce qui correspond aussi au lancement de la SR/F. Le veto est un veto, pas un seuil : un VIN de 2019 ou plus récent a quand même besoin d’un signal positif.

Le classificateur lui-même a trois signaux positifs, vérifiés dans l’ordre. D’abord, le modèle est SR/F, SR/S, DSR/X ou FXE, comparé sans la barre oblique. Ensuite, le VIN correspond à l’expression régulière de la famille Gen3, qui accepte les sous-chaînes ZF?Z, XXFZ ou DZ?Z où le joker est une lettre quelconque. Enfin, une conjonction plutôt qu’un motif isolé : le texte décodé contient un marqueur propre à la Gen3, soit une ligne « State change … from … to … », soit une ligne « Disch limits curr N cap N act N pow N », ET ne contient aucune ligne de conditions MBB Gen2, celle qui se lit « PackTemp: h NC, l NC, PackSOC: N% ». Les deux moitiés sont nécessaires : un log de concessionnaire Gen2 peut porter son propre texte de changement d’état, et c’est l’absence de télémétrie Gen2 qui l’empêche de compter.

Une quatrième voie vers le décodeur Gen3 existe, et il vaut la peine de la séparer des trois précédentes, parce qu’il est facile de lire le code et d’en conclure que le classificateur a quatre signaux, ce qui n’est pas le cas. Une fois que le classificateur a renvoyé faux, l’appelant applique un forçage d’aiguillage : un fichier MBB dont le tampon circulaire 0xB2 a été délimité avec succès, sur une moto que le veto strict n’a pas rejetée, est envoyé quand même au décodeur Gen3. C’est ce qui sauve un fichier dont le texte d’en-tête ne donne ni modèle exploitable ni VIN. Cela se passe en dehors du classificateur : une implémentation qui reproduit seulement le tableau ci-dessous ne le reproduira pas. Un fichier BMS a le raccourci équivalent : il est traité comme Gen3 quand son chargeur binaire Gen3 réussit, indépendamment du modèle et du VIN.

Pour un fichier MBB, ce sont désormais les octets qui décident avant tout cela (2026-10-03). Le décodeur natif lit l’en-tête d’enregistrement FST (le texte à partir de l’octet 13, l’état à un décalage fixe), et un fichier à conteneur Gen2, l’en-tête « MBB » + nul avec A1 A1 A1 A1 au décalage 38, délimite ses enregistrements 0xB2 avec la charge utile à partir de l’octet 7. Envoyé au décodeur natif par le forçage ou par la branche XXFZ de la famille de VIN, un tel fichier avait chaque message lu six caractères trop tard et ne livrait ni compteur kilométrique ni trajet. Aucun des signaux ci-dessus n’aiguille donc une MBB vers le décodeur natif, à moins que son en-tête soit l’enregistrement de carte natif 0xFB ou que ses enregistrements portent l’en-tête FST : un mot inférieur à la seconde d’au plus 1 000 000 sur au moins 80 % d’entre eux, et un décalage UTC civil à l’octet 12 sur au moins 80 %, une valeur en tenant la moitié. Sur les 151 fichiers MBB de ce corpus qui ont « MBB » dans leurs 32 premiers octets, les deux signaux d’octets concordent sur chaque fichier et les populations ne se rapprochent pas : les 10 fichiers natifs obtiennent 1,0, 1,0 et au moins 0,971, et les 141 fichiers à conteneur Gen2 au plus 0,149, 0,442 et 0,316. Sur les 37 fichiers distincts à conteneur Gen2 qui atteignaient auparavant le décodeur natif, 36 passent désormais par le décodage Gen2 amont ; le dernier a une horloge de 1970 dans chaque enregistrement, qu’aucun décodeur ne peut situer.

Le FXE mérite sa propre note, car c’est le seul modèle pour lequel cette spécification et le reste de ce site peuvent sembler en désaccord. Le FXE est dans l’ensemble de modèles Gen3 du classificateur avec SR/F, SR/S et DSR/X : un log de FXE correspond donc au signal 1 et est stocké avec log_generation = 3. C’est une déclaration sur le décodeur vers lequel le fichier est aiguillé, pas sur la génération de produit de la moto. Un catalogue qui décrit le FXE comme une machine Cypher II répond à une autre question, et les deux peuvent être justes à la fois.

Les seuls fichiers FXE de ce corpus sont trois exports de concessionnaire de 262 144 octets provenant d’une seule moto, et leur corps MBB n’est pas du tout un tampon circulaire Gen3 natif. Il s’ouvre par l’ASCII « MBB » plus un nul plutôt que par un 0xB2, porte A1 A1 A1 A1 au décalage 38, ne contient aucun des jetons RUN, PWSU, HIB ou CHRG complétés par des nuls que le décodeur Gen3 natif recherche, et contient 1 809 et 2 228 enregistrements de type 0x2c dans les deux fichiers MBB. Ce nombre est un balayage d’octets sur chaque 0xB2 dont l’octet de type est 0x2c, la même convention qui reproduit exactement le tableau des types d’enregistrement BMS de cette page ; en exigeant que la longueur sur disque soit exactement 40, les deux mêmes fichiers donnent 1 682 et 2 093. (Une révision antérieure publiait 1 771 et 2 200 sans nommer de convention, et ces deux nombres ne se reproduisent sous aucune des deux. Re-mesuré le 2026-07-30.) C’est la variante de firmware 538XX décrite plus loin dans cette page, et c’est le chemin par lequel ces fichiers se décodent. Rien dans les cartes d’enregistrements Gen3 natifs n’a donc été vérifié sur un FXE.

Entrées de la classification Gen3
RègleValeurEffet
Veto strict : modèleS, SR, DS, DSR, FX, FXS, XUDétection Gen3 entièrement ignorée
Veto strict : code d’année du VINA à J (2010–2018), caractère 10 du VINDétection Gen3 entièrement ignorée
Signal 1 : modèleSR/F, SR/S, DSR/X, FXEClassé Gen3
Signal 2 : famille de VINZF?Z, XXFZ ou DZ?Z comme sous-chaîneClassé Gen3
Signal 3 : motifs de texte(« State change … from … to » OU « Disch limits curr … ») ET NON « PackTemp: h …, PackSOC: … »Classé Gen3
Forçage d’aiguillage : structure binaireFichier MBB dont le tampon circulaire 0xB2 se délimite, veto strict non déclenchéAiguillé vers le décodeur Gen3 hors du classificateur
Barrière de disposition d’enregistrement : MBBEn-tête natif 0xFB, ou en-tête d’enregistrement FST sur les enregistrements délimitésExigée avant QU’UN signal ci-dessus aiguille une MBB vers le décodeur natif
Forçage d’aiguillage : BMSLe chargeur binaire Gen3 du BMS réussitAiguillé vers le décodeur BMS Gen3
Barrière indépendanteHorodatage d’enregistrement déséchappé entre 2019-01-01 et maintenant + 365 joursEnregistrement rejeté par les deux délimiteurs Gen3

Les cinq premières lignes forment le classificateur : deux vetos plus une disjonction à trois branches, et non une comparaison d’années. Une SR/F de 2021 dont la chaîne de modèle est illisible est quand même classée Gen3 par sa famille de VIN ; une FX de 2019 est écartée sur son modèle quoi que contienne le fichier. Les deux lignes de forçage ne font PAS partie de cette disjonction : l’appelant les applique après que le classificateur a déjà renvoyé faux, raison pour laquelle une implémentation du seul classificateur aiguille moins de fichiers vers le décodeur Gen3 que la nôtre. Les forçages respectent quand même les vetos. La barrière de disposition d’enregistrement précède tout le reste pour une MBB : aucun modèle, aucune famille de VIN ni aucun forçage n’envoie au décodeur natif un fichier dont les enregistrements n’ont pas l’en-tête FST.

Deux dispositions d’enregistrement, décidées par fichier

Tous les fichiers qui atteignent un décodeur Gen3 n’utilisent pas l’en-tête de 13 octets ci-dessus. Les exports de carte principale de plateforme Gen2, la variante 538XX et certains exports de carte de gestion de la batterie sont eux aussi des flux d’enregistrements 0xB2, mais dans leur ancienne disposition la charge utile (texte compris) commence à l’octet 7 de l’enregistrement, juste après l’horodatage : il n’y a ni microsecondes, ni séquence, ni octet de décalage. Un export de batterie à la forme Gen2 peut atteindre le décodeur de batterie Gen3, car il porte la télémétrie 0xB2 que l’aiguilleur cherche.

Appliquer les règles FST à un tel fichier coûte cher : lire son texte à partir de l’octet 13 coupait les six premiers caractères de chaque message (« DEBUG: CAN Link Is Down » devenait « CAN Link Is Down ») et supprimait chaque enregistrement que la coupe laissait trop court. Sur un fichier de production qui emprunte ce chemin, l’octet 7 commence le texte sur tous les enregistrements texte sauf un, sur 3 556. La disposition est donc décidée par fichier, à partir des octets du fichier lui-même, par un seul test (has_fst_record_layout dans le décodeur). Un fichier utilise la disposition FST quand l’une de ces conditions est remplie :

  1. 1le marqueur de page flash 00 F0 FF 00 ouvre à la fois sa deuxième et sa troisième page de 128 octets (seule une image de batterie FST l’écrit, ce qui règle à lui seul la question) ; ou
  2. 2sur ses enregistrements dotés d’un en-tête complet de 13 octets, les octets 7 à 10 valent au plus 1 000 000 sur au moins 80 % d’entre eux, l’octet 12 se lit comme un décalage UTC civil (−12 à +14) sur au moins 80 %, et une valeur de décalage en explique au moins la moitié.
Les trois scores par fichier, sur chaque .bin de ce corpus qui compte au moins dix octets 0xB2 (363 fichiers)
PopulationFichiersOctets 7–10 dans la secondeOctet 12 : décalage civilDécalage dominant
Disposition FST (8 fichiers de batterie paginés, 10 fichiers de carte principale)18≥ 0,970≥ 0,990≥ 0,959
Tous les autres fichiers345≤ 0,160≤ 0,442≤ 0,316
Seuil pour FST—0,800,800,50

Les seuils ont été fixés sur un échantillon plus large de 374 fichiers : ce corpus plus onze fichiers de production qu’une comparaison en production avait signalés. La plus basse part de décalage dominant des fichiers FST y était de 0,685, sur un export brut de batterie de 13,6 Mo qui avait traversé un changement d’heure d’été et écrit −5 et −6 ; chaque fichier non FST est resté à 0,16, 0,44 et 0,32 ou moins. Les fichiers paginés sont aussi notés, mais le marqueur seul les tranche.

Ne décidez jamais de la disposition d’après un nom de fichier ou un préfixe de VIN

Un nom de fichier est ce que la personne qui a copié le fichier a tapé. La seule image FST de ce corpus qui ne porte pas le nom d’export de l’appli est un tronçon tronqué de 16 ko de carte principale, et les onze fichiers de production signalés par la comparaison comprenaient des images FST natives dont les noms disaient autre chose. Un préfixe de VIN ne vaut pas mieux : la variante 538XX écrit un corps de style Gen3 derrière un VIN Gen2. Tout ce que le test ne peut pas trancher (un fichier sans enregistrement de pleine longueur) garde l’ancien comportement, celui dont chaque fichier non FST a besoin. Dans un ancien enregistrement, les octets 7 à 10 sont de la charge utile et l’octet 12 est le sixième caractère d’un message (le « : » de « DEBUG: »), si bien que les deux populations ne se rapprochent jamais.

Types d’enregistrement de la MBB Gen3 native

Un fichier MBB Gen3 natif fait 131 200 octets tel qu’exporté par l’appli Zero, avec le marqueur « MBB » au décalage 0x0D et le premier 0xB2 au décalage 0. Les exports de concessionnaire font 262 144 octets. Les nombres ci-dessous sont par fichier et ont été mesurés sur huit vrais logs ; les plages sont larges parce qu’elles dépendent de la façon dont la moto a été utilisée avant l’export.

Où va le tampon circulaireRépartition des types d’enregistrement d’un dump par chemin de décodeur, chacune normalisée à 100 %87,1%MBB Gen3 natif131,200 B app dump · 2,368 records0xFD text2 0630x51 telemetry1510x54 secondary1510x52 / 0xFB313.7 text : 1 telemetry26,6%32,7%40,6%MBB 538XX262,144 B dealer dump · 7,758 records0xFD text2 0670x2c telemetry2 54012 other types3 1510.81 text : 1 telemetry84,5%10,1%BMS Gen3131,328 B app dump · 2,312 records0xFD text1 9530x4B telemetry2340x4D ext (+8)950x4C/00/FB308.3 text : 1 telemetryLes segments de moins de 4 px sont dessinés à 4 px ; lisez les décomptes, pas le filet.
Chaque colonne est un fichier réel nommé, normalisé à son propre nombre d’enregistrements, de sorte que la comparaison porte sur les proportions. À gauche et à droite, les moitiés MBB et BMS d’un seul export d’appli d’une SR/F (ses téléchargements de carte principale et de batterie, faits le même jour) ; la colonne du milieu est un dump de concessionnaire de 262 ko d’une FX avec la variante de firmware 538XX. Les trois colonnes sont comptées de la même façon, par découpage par chaîne de longueurs (découper selon la longueur déclarée, puis déséchapper), et c’est ce qui a le plus changé la colonne du milieu : elle était citée ici à 6 135 enregistrements dont 2 487 de télémétrie, d’après une passe incapable de voir un enregistrement échappé. Deux des trois décodeurs livrés font autre chose à l’exécution (le BMS découpe par intervalles ; le chemin 538XX balaie les octets avec des candidats qui se chevauchent) ; c’est donc une mesure du format, tenue constante entre les colonnes pour les rendre comparables. Elle concorde avec le balayage 538XX livré, qui lit 2 283 enregistrements canoniques de 40 octets 0x2c directement sur la liaison dans ce fichier plus 257 récupérés par déséchappement, soit les mêmes 2 540. Ces chiffres par fichier s’écartent un peu des chiffres cumulés du corpus cités dans l’article (chaîne de longueurs : 19 089 enregistrements MBB sur les huit dumps d’appli, 15 890 BMS sur sept) ; même mesure, dénominateur différent. Un MBB Gen3 natif consacre donc 87,1 % de ses 2 368 enregistrements au texte ASCII et ne donne que 151 enregistrements de télémétrie, qui portent bien la tension et le courant de la batterie à record[34:38] et record[38:42]. Le décodeur les lit depuis le 2026-09-07, mais seulement quand le bus haute tension est actif, et ils sont à zéro en hibernation (0 des 417 enregistrements HIB sur les neuf fichiers MBB Gen3 natifs, contre 144 sur 144 en RUN). La variante 538XX écrit 2 540 enregistrements de télémétrie qu’un décodeur consomme.
Types d’enregistrement MBB, mesurés sur huit fichiers Gen3 natifs
TypeNomTaille typiqueNombre par fichierPartContenu
0xFBEn-tête117 B1—VIN, type de carte, numéro de série, référence, build du firmware
0xFDÉvénement textevariable, 28–105 o1 811–2 33186,7 %Messages de log ASCII terminés par un nul
0x51Télémétrie75 o (71 o sur le firmware de 2023)131–2396,9 %État, SOC, tension et courant du bus continu et de la batterie, régime du moteur, températures ambiante, du moteur, de l’onduleur et des cellules, rail 12 V
0x54Moteur29 B0–2395,6 %Couple à l’arbre, courant du moteur, tension du bus continu ; écrit à côté de chaque 0x51
0x52Étendu92 o (88 o sur le firmware de 2023)0–310,35 %Tout ce que porte le 0x51, plus la vitesse sur route, l’autonomie estimée et (sur la disposition récente) le compteur kilométrique
0x48 / 0x49 / 0x4F / 0x53Charge, file, plus grande télémétrievariable0–690,5 %Table du chargeur, cibles de charge, débordement de file FreeRTOS et plus grand enregistrement d’état (tous décodés, voir plus bas)

Les parts portent sur 19 089 enregistrements répartis sur les huit fichiers, délimités par la longueur déclarée et déséchappés. Les totaux par fichier allaient de 2 238 à 2 535 enregistrements. Les tailles de la troisième colonne sont les longueurs canoniques, après déséchappement ; sur disque, un enregistrement qui porte un échappement fait un octet de plus.

Enregistrement d’en-tête (0xFB, 117 octets) : le fichier nomme sa moto

Exactement un enregistrement d’en-tête ouvre chaque fichier de carte principale Gen3 natif, et son horodatage est l’heure du téléchargement plutôt qu’une heure du log. Il nomme la moto et, depuis la version 3.37.0, le décodeur de ce site le lit dans les octets (le VIN, le modèle, l’année-modèle, les révisions de carte et de firmware et le build du firmware) au lieu de les prendre au nom du fichier. Sur les dix fichiers de carte principale natifs de ce corpus, chacun de ces champs est présent et lisible sur les dix.

Le VIN n’est accepté que s’il passe le chiffre de contrôle de la norme 49 CFR 565, le préfixe 538 ou PAG et le jeu de caractères des VIN. L’emplacement est du texte inscriptible, et le chiffre de contrôle est ce qui permet de préférer sans risque l’en-tête au nom du fichier, qui est justement ce qu’un renommage change. Il commence au décalage 0x29 sur les dix fichiers ici. Le zero-log-parser amont a trouvé ces décalages le premier (son décodage d’en-tête du 15 septembre 2026, attribué là-bas à la pull request de 2022 d’AtomicDog), et signale le VIN un octet plus loin, à 0x2A, sur environ 2,6 % des fichiers de production, tous les autres champs se décalant avec lui ; un octet échappé dans l’horodatage propre à l’en-tête en est la cause la plus probable. Le décodeur essaie donc d’abord l’en-tête déséchappé, puis les décalages bruts 0x29 et 0x2A, et ne lit rien du tout quand aucun VIN ne valide, parce que le décalage est alors inconnu.

L’année-modèle est un ajout de ce décodeur. Les deux octets avant le nom du modèle forment un uint16 qui contient l’année fois dix (20210 pour une 2021), et sur dix fichiers sur dix il est égal à l’année codée au dixième caractère du VIN. Son octet de poids fort, 0x4E ou 0x4F, est ce qu’un balayage de texte imprimable lisait auparavant comme une partie du modèle, d’où viennent « NSRF » et « ODSRX ». Ici : modèle SRF sur quatre fichiers, SRS sur trois et DSRX sur trois ; révision de carte 2 sur trois, 4 sur cinq et 5 sur deux ; révisions de firmware 19, 29, 42, 43 et 44.

Ce qu’un pilote en retire : un fichier qui dit encore de quelle moto il provient après avoir été renommé ou transmis, une année-modèle qui recoupe le VIN, et la révision matérielle et de firmware de la carte principale le jour du téléchargement, ce qu’il faut comparer en premier quand deux fichiers de la même moto se décodent différemment. Les valeurs elles-mêmes identifient une moto ou la restreignent, et aucune n’est imprimée sur cette page.

Carte des champs de l’en-tête MBB 0xFB
[0]        0xB2
[1]        0x75 (117)
[2]        0xFB
[3:7]      timestamp — download time, uint32 LE
[7:11]     microseconds
[11]       sequence
[12]       UTC-offset setting, int8 hours (was "log format version")
[13:16]    "MBB"
[23:25]    model year x 10, uint16 LE — 20210 for an MY2021
[25:41]    model, NUL-padded — "SRF", "SRS", "DSRX" (was read as "NSRF",
           "ODSRX": the N / O is the model-year word's high byte)
[41:58]    VIN, 17 ASCII characters, check digit at the ninth;
           one byte later, [42:59], on ~2.6% of production files
[60:74]    board serial number — not decoded, never published
[92:101]   MBB part number — observed 40-08155, 40-08198, 40-08285
[101]      board revision, uint8 — 2, 4, 5 observed
[103]      firmware revision, uint8 — 19, 29, 42, 43, 44 observed
[107:...]  firmware build identifier, NUL-padded hex digits

Les références observées correspondent à des plateformes : 40-08155 sur les SR/F 2020–2021, 40-08198 sur les SR/S et une SR/F de 2023, 40-08285 sur les DSR/X. La référence seule ne détermine pas la disposition des enregistrements (voir la note sur la dérive du firmware plus bas).

Enregistrement texte (0xFD, variable)

Les événements texte forment l’essentiel du fichier et sont le seul endroit où une MBB Gen3 native énonce une lecture de batterie haute tension. La charge utile est de l’ASCII terminé par un nul qui commence à l’octet 13 de l’enregistrement, après le champ de quatre octets des microsecondes, l’octet de séquence et l’octet de décalage UTC. Ce dernier octet était décrit ici comme un marqueur de carte, 0x02 sur la MBB et 0x01 sur le BMS ; il lisait 0x02 et 0x01 uniquement parce que les fichiers dont il était lu provenaient de motos réglées sur UTC+2 et UTC+1.

Un seul cycle de réveil de l’hibernation produit une rafale très reproductible de ces événements. Mesurée sur 416 cycles de réveil complets dans les huit exports d’appli de pleine taille, la rafale médiane compte 31 enregistrements, le plus souvent 27 événements texte, 2 enregistrements de télémétrie et 2 secondaires, écrits sur une fenêtre de 91 secondes. Un cycle est ici une paire de marqueurs « Hibernating for N sec » consécutifs espacés de 3 000 à 4 200 secondes, sur des enregistrements délimités par chaîne de longueurs ; en ne comptant que les marqueurs qui déclarent 3 600 secondes, les mêmes huit fichiers en donnent 411. Les marqueurs reviennent à un intervalle médian de 3 691 secondes, soit le sommeil déclaré de 3 600 secondes plus la rafale qui le suit. Cette période n’est pas déduite : le dernier enregistrement de chaque rafale est littéralement le texte « Saving Stats, Hibernating for 3600 sec », et 444 des 462 directives d’hibernation de ces huit fichiers précisent 3600 secondes (446 sur 464 si l’on compte le neuvième fichier, tronqué). Les 18 restantes précisent 31 536 000 secondes, soit 365 jours : un mode de stockage ou de transport.

La documentation interne énonçait le rythme d’hibernation de deux façons, « environ 15 à 20 entrées par heure » et « environ 15 à 20 entrées par cycle de réveil, survenant toutes les 1 h ». Par cycle de réveil est la bonne formulation, et comme le cycle est horaire, les deux rythmes coïncident. Le nombre était la partie fausse : la médiane mesurée est de 31 enregistrements bruts par cycle, pas de 15 à 20.

  • « State change from STRT to PWSU » et « State change from PWSU to HIB » : les transitions de réveil et de retour en hibernation.
  • « Saving Stats, Hibernating for N sec » : l’intervalle de sommeil que la carte vient de demander.
  • « Registering Mod N (NNNNNNmV, N brick ) » : la seule lecture de batterie haute tension côté MBB.
  • « Disch limits: curr N cap N act N pow N » et « Ch limits: ... » : enveloppes de puissance de décharge et de charge en watts.
  • « Fault pending: CODE » et « Fault cleared: CODE » : transitions de défaut, par exemple HVIL_OPEN.
  • « Requesting 12v charge. DC-DC NuV, Battery NuV, Combined NuV, Ambient NC » : la batterie d’accessoires de 12 V, en microvolts.
Un cycle de réveil d’hibernation complet, 31 enregistrements en 91 secondes
01:43:28  0xFD  Board was reset. Source: Hib Wake RTC, Power-On, Supply WD, ...
01:43:29  0xFD  MBB RTC treated valid.
01:43:29  0xFD  Kill Sw = STOP
01:43:29  0xFD  Immobilizer = LOCKED
01:43:29  0xFD  Control flags changed. Old: 0x0000 New: 0x400020
01:43:29  0xFD  Disable flags changed. Old: 0x0000 New: 0x008d
01:43:29  0xFD  State change from STRT to PWSU
01:43:29  0x51  telemetry  state='PWSU'  soc=0
01:43:29  0xFD  Disch limits: curr 0 cap 0 act 0 pow 0
01:43:29  0xFD  Ch limits: curr 0 cap 0 act 0 pow 0
01:43:29  0x54  secondary
01:43:29  0xFD  Requesting 12v charge. DC-DC 179216uV, Battery 13132544uV, ...
01:43:29  0xFD  Fault pending: HVIL_OPEN sets in 2 seconds
01:43:29  0xFD  Kickstand Sw = DOWN
01:43:32  0xFD  Registering Mod 2 (104832mV, 4 brick )
01:43:32  0xFD  LTSM state: INIT to DIS
01:44:29  0xFD  Timed out in PW Startup
01:44:29  0xFD  State change from PWSU to HIB
01:44:29  0x51  telemetry  state='HIB'  soc=56
01:44:29  0x54  secondary
01:44:29  0xFD  Stopping 12v charge. DC-DC 302288uV, Battery 13142800uV, ...
01:44:59  0xFD  Saving Stats, Hibernating for 3600 sec

Abrégé : les lignes répétées « Control flags changed » et les lignes de limites sont omises, et la rafale complète compte 31 enregistrements. La tension de batterie de 104832 mV dans la ligne « Registering Mod » est la seule lecture haute tension qu’une MBB Gen3 native produit, et c’est du texte, pas un champ binaire.

Enregistrement de télémétrie (0x51, 75 octets)

C’est la colonne vertébrale binaire du log MBB. Le décodeur lit le champ d’état à un décalage fixe par type d’enregistrement (octet 42 de l’enregistrement sur un 0x51, 46 sur un 0x52, 50 sur un 0x53) et y accepte l’un de dix jetons ASCII complétés par des nuls : RUN, STOP, HIB, STRT, PWSU, CHRG, WAIT, WAKE, REV, PARK. Tout autre décalage lui est relatif. Il cherchait auparavant un jeton dans tout l’enregistrement, et un enregistrement texte qui contenait simplement l’un de ces mots voyait un caractère de son message lu comme un état de charge : presque toujours une espace, 0x20, soit 32. La production comptait 512 trajets se terminant à exactement 32 % de SoC avant l’arrivée de l’ancrage côté serveur, et le décodeur du navigateur derrière /decode a continué à chercher jusqu’en 2026-10. Deux populations sont en jeu ici et les mélanger est la raison pour laquelle cette page s’est trompée deux fois sur le nombre suivant. Une fois l’échappement respecté, il y a 1 121 enregistrements 0x51 complets de 75 octets sur les neuf fichiers MBB natifs, et 1 078 d’entre eux faisaient déjà 75 octets sur disque. Le jeton tombe à l’octet 42 de l’enregistrement sur chacun d’eux. Sur les 1 078, 1 069 portent l’un des huit jetons que le décodeur connaissait à l’origine ; les 9 restants portent REV ou PARK (cinq et quatre, tous sur l’unique DSR/X d’ici) et étaient écartés jusqu’à l’ajout de ces deux jetons, côté serveur en 2026-08 et dans ce décodeur de navigateur peu après. Ils n’ont jamais été sans jeton ni vides : les 9 portent une tension de batterie renseignée à record[34:38], entre 102,561 V et 102,630 V, de sorte que les deux jetons ont récupéré une vraie télémétrie et non du bruit. La table des ancrages est ce qui permet au même décodeur de lire l’enregistrement 0x52 de 92 octets, où l’état se trouve quatre octets plus loin, et le 0x53 de 106 octets, huit octets plus loin.

Deux champs sont adressés relativement au jeton. Le SOC est l’octet unique situé neuf octets avant lui, à record[33] sur un enregistrement de 75 octets. Les six uint32 d’après l’état commencent neuf octets après le début du jeton, parce que le champ d’état est complété jusqu’à neuf octets.

L’indicateur de mode à record[17] mérite une note, car deux révisions différentes de la documentation interne le décrivaient chacune à l’envers de l’autre. C’est un indicateur de mode, et il est à l’octet 17, pas à l’octet 11. Mesuré par état sur les 1 121 enregistrements 0x51 complets de 75 octets : il vaut 0x00 sur 144 enregistrements RUN sur 144, 0x6A sur 408 PWSU sur 408, 0x6A sur 397 HIB sur 417 avec 0x60 sur les 20 autres, et 0x6A sur 7 CHRG sur 7. Il varie selon l’état au sein d’une même moto, il ne peut donc pas être l’identifiant matériel propre à chaque moto qu’on l’a un jour appelé. L’octet 11, qu’une révision antérieure nommait à la place indicateur de mode, est l’octet de séquence de l’enregistrement : il prend 105 valeurs distinctes sur ces mêmes 144 enregistrements RUN et ne tombe dans {0x00, 0x6A, 0x60} sur aucun d’eux.

Quels champs 0x51 sont renseignés, par état (1 121 enregistrements complets de 75 octets, neuf fichiers)
ÉtatEnregistrementsSOC = 0post_1 / post_2 renseignéspost_3 / post_4 renseignés
HIB4179 (2,2 %)20 (4,8 %)0
PWSU408373 (91,4 %)034 (8,3 %)
RUN1440144 (100 %)144 (100 %)
WAIT5147 (92,2 %)3 (5,9 %)3 (5,9 %)
WAKE4403 (6,8 %)44 (100 %)
STOP41018 (43,9 %)41 (100 %)
CHRG7007 (100 %)
REV505 (100 %)5 (100 %)
PARK404 (100 %)4 (100 %)

La population est celle des 1 121 enregistrements dont la longueur est la longueur canonique de 75 APRÈS déséchappement, la même population que celle de tous les autres chiffres 0x51 de cette page. Une version antérieure de ce tableau était comptée sur les 1 078 enregistrements qui faisaient déjà 75 octets SUR DISQUE (les 43 échappés écartés, ce que cette page passe justement une section à rétracter) et lisait HIB 405, PWSU 397, RUN 130, WAIT 50, STOP 36. Ces nombres sont justes pour cette population plus étroite et faux comme description du format. Les quatre entiers d’après l’état se comportent comme deux paires, pas comme quatre canaux indépendants : post_1 et post_2 sont toujours renseignés ensemble, et post_3 et post_4 aussi. L’affirmation antérieure selon laquelle les températures n’apparaissent qu’en WAKE, STOP et CHRG n’est pas étayée : RUN renseigne les quatre, et PWSU et HIB renseignent chacun une paire. REV et PARK se comportent exactement comme RUN, ce qui était le second argument pour les ajouter à la liste des jetons. C’est désormais fait sur les deux décodeurs.

Télémétrie MBB 0x51, 75 octets, décalages absolus par rapport à l’enregistrement
[0]       0xB2 delimiter
[1]       0x4B (75) declared length
[2]       0x51 type
[3:7]     timestamp, uint32 LE
[7:11]    microseconds — sub-second part of the timestamp, uint32 LE.
          A multiple of 1000 on 1,121 of 1,121 records, max exactly 1,000,000.
[11]      sequence, uint8 — +1 per record of any type, mod 256. NOT a mode
          flag and NOT half of a uint16 counter; see the note.
[12]      UTC-offset setting, int8 hours
[13:17]   zeros
[17]      controller mode flag — 0x00 active, 0x6A standby, 0x60 transition
[18:21]   zeros
[21:25]   DC-bus voltage, int32 LE, mV, in 100 mV steps — the CONTROLLER's
          reading of the bus [34:38] measures. Zero on every CHRG record.
[25:29]   DC-bus current, int32 LE, mA — only while the bus is live
[29:33]   motor rpm, int32 LE — only while the bus is live
[33]      SOC %, uint8 — 0 means uninitialised, not empty
[34:38]   pack voltage, uint32 LE, mV — non-zero on 144/144 RUN, 5/5 REV,
          4/4 PARK; zero on 417/417 HIB, 408/408 PWSU, 51/51 WAIT
[38:42]   battery current, int32 LE, mA — discharge positive, charge negative
[42:51]   state name, ASCII, null-padded to 9 bytes
[51:55]   post_0 — AMBIENT temperature, hundredths of a degree on most firmware
          and whole degrees on some (each file is internally pure)
[55:59]   post_1 — MOTOR temperature, zero when the bike is parked
[59:63]   post_2 — INVERTER temperature, tracks post_1, zero when parked
[63:67]   post_3 — cell HIGH temperature, written in every state
[67:71]   post_4 — cell LOW temperature, <= post_3 on every record measured
[71:75]   12 V accessory-rail voltage, uint32 LE, microvolts — NOT an odometer,
          see the retraction below

Trois notes. Premièrement, [34:38] et [38:42] étaient publiés sur cette page sous la forme « [34:42] zéros (remplissage) » ; ce n’est pas du remplissage, et la preuve est dans la section ci-dessus. Ils sont mesurés sur cinq motos 538ZF (plateforme SR/F). Sur l’unique moto à WMI PAG de ce corpus, seuls 18 des 278 enregistrements 0x51 les renseignent : ce n’est donc pas confirmé pour le firmware de l’époque DSR/X. Le décodeur lit les deux depuis le 2026-09-07, à partir des enregistrements dont le bus est actif. Deuxièmement, les cinq températures d’après l’état ont été publiées ici, et stockées, sous de mauvais noms jusqu’au 2026-09-07 : post_0 comme « métrique interne », post_1 comme batterie haute, post_2 comme batterie basse (et conservée comme température du moteur), post_3 comme ambiante et post_4 comme contrôleur. L’ordre était juste et les étiquettes ne l’étaient pas, et le tableau des états plus bas le prouvait déjà : post_1 et post_2 sont renseignés sur chaque enregistrement RUN et sur aucun en CHRG (un moteur et un onduleur sont morts quand la moto est garée), tandis que post_3 et post_4 sont renseignés en RUN, STOP, WAKE et CHRG indifféremment, ce que font les cellules. Troisièmement, l’octet 11 : une révision antérieure de la documentation interne l’appelait l’indicateur de mode du contrôleur et appelait l’octet 17 un identifiant matériel propre à chaque moto. Les deux étaient à l’envers. L’octet 11 est l’octet de séquence et il a une forte entropie (105 valeurs distinctes sur les 144 enregistrements RUN), alors que l’octet 17 est une fonction nette de l’état.

Retiré : record[71:75] n’est pas un compteur kilométrique

Cette page publiait record[71:75] comme un compteur kilométrique à vie en mètres, et expliquait son comportement par de la gigue : « 13 183,8 km à 13 276,1 km au cours d’un trajet de 20 minutes, soit un écart de 92,3 km ». Ce n’est pas un compteur kilométrique et il ne présente pas de gigue. Chacun des 1 121 enregistrements complets de 75 octets de ce corpus satisfait v = 5128k + 4864 avec k entre 27 et 2 620, ce qui est un CAN de 12 bits avec un bit de poids faible de 5,128 mV et environ 21 V de pleine échelle. Lu en microvolts, le champ s’étend de 0,143 V à 13,440 V, et les événements texte du firmware citent la batterie d’accessoires exactement dans ces unités et cette plage (« Stopping 12v charge. DC-DC 302288uV, Battery 13142800uV »). L’écart de 92,3 « km » au sein d’un trajet est un rail de 12 V qui passe de 13,184 V à 13,276 V. Seuls 51,5 % des échantillons consécutifs sont non décroissants (un pile ou face), et un balayage exhaustif de chaque fenêtre uint32 du décalage 3 au 71 ne trouve aucune fenêtre monotone en dehors de l’horodatage lui-même. Il n’y a aucun compteur kilométrique nulle part dans un enregistrement 0x51. Cette phrase a ensuite été citée sous la forme « il n’y a pas de compteur kilométrique dans un enregistrement MBB Gen3 natif », ce qui est faux : le balayage qui la fonde ne couvrait que le 0x51 de 75 octets, et le compteur kilométrique vit dans la queue des enregistrements plus longs 0x52 et 0x53 (voir la section sur les enregistrements étendus plus bas).

Comment celui-ci a été repéré, et ce qu’il a coûté

L’indice était arithmétique. Les différences consécutives du champ partagent un plus grand diviseur commun de 5 128 avec un reste constant de 4 864 sur 1 121 échantillons sur 1 121 : un réseau régulier qu’aucune mesure de distance ne produit et que tout CAN produit. La corroboration est que cinq motos sans rapport, de trois familles de modèles et cinq années-modèles (SR/F 2020, SR/F 2021, SR/S 2021, SR/F 2023, DSR/X 2024), annonçaient toutes des « compteurs kilométriques » dans une fenêtre de 272 km. Dans ce projet, le champ passait une barrière de plage de 100 000 à 200 000 000, que 1 121 échantillons sur 1 121 franchissaient, et il arrivait sur le tableau de bord comme compteur kilométrique principal et comme distance par trajet. Il a été retiré du décodeur ; le champ est désormais émis brut et sans mise à l’échelle sous un nom neutre, parce que « quel rail » est de haute confiance et non démontré.

Enregistrement du moteur (0x54, 29 octets)

L’enregistrement 0x54 est écrit à côté de chaque 0x51 et c’est le canal du moteur : quatre mots int32 signés petit-boutistes après l’en-tête (couple à l’arbre en micro-newtons-mètres, courant du moteur en ampères entiers, un compteur libre et la tension du bus continu en millivolts), avec FF FF FF FF pour « non mesuré ». Cette page le donnait comme de fonction inconnue jusqu’au 2026-09-07, parce que sur une moto garée il est presque vide : sur les 968 enregistrements dont la longueur sur disque est la longueur nominale de 29 octets, sur les huit exports d’appli, 848 (87,6 %) ont les octets 13 à 24 à zéro (pas de couple, pas de courant, un compteur à l’arrêt), et 782 (80,8 %) se terminent par la sentinelle FF FF FF FF là où va la tension du bus ; 78 autres (8,1 %) se terminent par quatre octets nuls.

Deux contrôles internes doivent tenir, et tous deux tiennent sur chaque enregistrement mesuré. Le couple vaut exactement 0,2 N·m par ampère de courant moteur (27,6 N·m à 138 A, 49,2 à 246, 59,2 à 296) : les deux premiers mots sont donc une seule mesure passée par la constante du moteur, et cette constante est la preuve que la délimitation est juste. Et la tension du bus baisse quand le couple monte, 111,9 V à 0,6 N·m jusqu’à 106,9 V à 59,2 N·m, en restant dans la plage de 3,82 à 4,00 V par cellule sur une batterie à 28 éléments en série. Une carte de champs publiée appelle ce mot « puissance de décharge W » ; un canal de puissance ne s’affaisse pas sous la charge.

Secondaire MBB 0x54, 29 octets
[0]       0xB2
[1]       0x1D (29)
[2]       0x54
[3:7]     timestamp — identical to the paired 0x51 record
[7:11]    microseconds
[11]      sequence
[12]      UTC-offset setting (was "0x02, MBB marker")
[13:17]   shaft torque, int32 LE, micro-N·m — 0.2 N·m per amp, exactly
[17:21]   motor current, int32 LE, A
[21:25]   counter, int32 LE
[25:29]   DC-bus voltage, int32 LE, mV — FF FF FF FF when not measured

Enregistrements étendus (0x52, 92 octets, et 0x53, 106 octets) : vitesse, autonomie et compteur kilométrique

L’enregistrement 0x52 a la même forme que le 0x51, avec quatre octets de plus insérés dans la zone d’avant l’état, ce qui déplace le jeton d’état de l’octet 42 de l’enregistrement à l’octet 46 ; le 0x53 en insère huit et le place à l’octet 50. Les deux sont rares (67 enregistrements 0x52 sur les huit exports d’appli sous délimitation par chaîne de longueurs, 87 avec le neuvième fichier, et de 0 à 31 par fichier, apparaissant surtout autour des événements WAKE), et les deux portent une QUEUE que le 0x51 n’a pas. Une version antérieure de cette page disait 66 enregistrements 0x52 ; c’est la même quantité comptée comme des délimiteurs 0xB2 bruts dont l’horodatage non déséchappé passe la fenêtre, une autre convention.

La queue contient la vitesse sur route en millimètres par heure (km/h × 1 000 000), l’autonomie restante estimée par le tableau de bord en centièmes de kilomètre et, sur la disposition de firmware récente uniquement (celle dont le 0x51 fait 75 octets), le compteur kilométrique en dixièmes de kilomètre. Relativement au jeton d’état : sur la disposition récente, le compteur kilométrique est à +35, la vitesse à +39 et l’autonomie à +43 en uint16 ; sur l’ancienne disposition, la vitesse est à +35, l’autonomie à +39 en uint32, et il n’y a aucun compteur kilométrique. Le mot de l’ancienne disposition à +39 est le piège : il monte régulièrement de 5 000 à 11 773 sur un fichier et de 11 005 à 18 642 sur un autre, en plein dans la plage de kilométrage d’une Zero, et chaque échantillon de cette montée est un enregistrement CHRG. Un compteur kilométrique ne bouge pas quand la moto est branchée ; c’est l’estimation d’autonomie qui grimpe à mesure que la batterie se remplit. Le compteur kilométrique de la disposition récente passe le test que les imposteurs échouent : il reste figé pendant toute une recharge, ne monte que sous RUN et est non décroissant sur 48 pas sur 48 et 36 pas sur 36 pour les deux fichiers qui ont assez d’échantillons. Le décodeur vérifie quand même la série par fichier et la retire si plus d’un dixième de ses pas reculent.

Cibles de charge et instantanés d’état de la carte principale (0x49, 0x4B à 0x4D)

Quatre autres types d’enregistrement de la carte principale sont décodés. La table du chargeur (0x48), le rapport de file pleine (0x4F) et la bannière de build du firmware (0x32) ont chacun une sous-section propre plus bas ; les deux courts sont ici.

Le type 0x49 porte le plafond de charge en millivolts, la cible de charge en pourcentage et une tension de stockage : 117,60 V, 90 % et 106,00 V sur une moto, les 90 étant la limite choisie par le pilote.

Les types 0x4B, 0x4C et 0x4D se trouvent aussi côté carte principale de certains fichiers de production, sous forme d’instantanés d’état de 53, 84 et 96 octets avec un jeton d’état à l’octet 42, 46 ou 50 de l’enregistrement, les trois mêmes positions que 0x51, 0x52 et 0x53. Aucun n’apparaît dans ce corpus : le décodeur lit donc le jeton et rien d’autre, et ne l’utilise pas pour la détection des trajets tant que personne n’a mesuré ce que cela donnerait. La carte de la batterie écrit les mêmes trois codes de type avec d’autres longueurs et une disposition sans rapport ; c’est la longueur qui les distingue.

Table du chargeur (0x48) : quels chargeurs ont répondu, et depuis quel réseau

Pendant que la moto se recharge, la carte principale écrit un 0x48 environ toutes les 640 secondes : l’en-tête de 13 octets suivi d’un bloc de 49 octets pour chaque chargeur qui a répondu sur le bus CAN (62 octets avec un bloc, 111 avec deux). Ce corpus en contient 119, dans trois des dix fichiers de carte principale natifs, provenant de trois motos, et chacun fait 62 octets. Quand une moto a deux chargeurs, ils ne partagent pas un enregistrement ici : chacun répond dans un enregistrement à un bloc qui lui est propre, avec les identifiants CAN 16 et 17, et à 48 reprises les deux tombent dans la même seconde. C’est ainsi qu’une comparaison qui appariait les enregistrements par horodatage a un jour associé les deux mauvais et signalé un désaccord sur l’identifiant CAN là où il n’y en avait pas.

Les champs du secteur prouvent la disposition, et ils la prouvent parce que ce corpus couvre deux réseaux. Une moto lit 113 à 115 V à 60 Hz sur les mêmes octets où les deux autres lisent 218 à 236 V à 49 ou 50 Hz, et seule une vraie lecture du secteur sépare ces populations aux mêmes décalages. La fréquence est donc lue comme une classe par moto plutôt que comme un nombre : une moto d’ici se recharge sur un réseau à 60 Hz et deux sur 50 Hz.

Le nom est l’ASCII propre du chargeur : « 3kW » sur 97 enregistrements et « Flt 6 » sur 22 ici ; le zero-log-parser amont signale aussi « Charger », « 6kW » et « 3kWFCC » dans ses propres fichiers. « Flt 6 » est ce que l’unique chargeur d’une moto écrit dans son champ de nom à chacun de ses enregistrements pendant qu’il délivre de 15 à 26 A : ce n’est donc pas un chargeur qui s’est arrêté, et ce que cela abrège n’est pas connu. Des versions de firmware de chargeur 201 (66 enregistrements), 206 (31) et 104 (22) apparaissent, chacune sur une moto. Le numéro de série est décodé et jamais publié.

Ce qu’un pilote peut en lire : quels chargeurs ont répondu, et quand l’un d’eux cesse de répondre ; la tension et la fréquence à la prise ; combien de courant chaque unité a tiré du secteur (5 à 12 A ici) et ce qu’elle a délivré à la batterie. C’est le côté courant alternatif d’une recharge, et aucun autre enregistrement ne le porte.

Un bloc de chargeur de 49 octets : décalages de l’enregistrement pour le premier bloc ; ajoutez 49 pour le suivant
Octets de l’enregistrementChampTypeVu dans ce corpus
13–22Nom10 octets, ASCII complété par des NUL« 3kW » (97), « Flt 6 » (22)
23–24Indicateursuint16 LEBits non encore identifiés
25–28Tension de sortie continueuint32 LE, mVTension côté batterie
29Courant de sortie continuuint8, A5 to 26 A
37Commande entranteuint8Stocké ; sens non confirmé
39Tension d’entrée alternativeuint8, V113–115 V or 218–236 V
40Courant d’entrée alternatifuint8, A5, 7, 9 or 12 A
42Fréquence du secteuruint8, Hz49, 50 or 60
44Identifiant CANuint816, 17
45–46Version du firmwareuint16 LE104, 201, 206
47–50Numéro de sérieuint32 LEDécodé ; jamais publié
53–56Plafond de chargeuint32 LE, mVLa tension que le chargeur peut atteindre
57Commande sortanteuint8Stocké ; sens non confirmé

Le zero-log-parser amont a décodé cet enregistrement le premier, le 20 septembre 2026, et lit le nom, les indicateurs, la fréquence, l’identifiant CAN, la version et le numéro de série à ces mêmes octets ; la sortie continue, la tension et le courant alternatifs et le plafond de charge sont ceux de ce décodeur. Là où les deux lisent un octet, ils concordent sur les 119 enregistrements.

File pleine (0x4F) : le firmware a manqué de place pour un message

Un 0x4F fait 31 octets : l’en-tête, un nom de file de 10 octets complété par des NUL et deux valeurs uint32. Il est écrit quand une tâche du firmware essaie de poster un message dans une file FreeRTOS déjà pleine. Le message est abandonné, et cet enregistrement est le firmware qui le dit. Dix-huit se produisent ici, dans quatre des dix fichiers de carte principale natifs, et chacun nomme une file CAN : CAN2txQ onze fois, CAN1txQ six et CAN0RxQ une. Sur ces motos, une file pleine est de la congestion du bus CAN.

La première valeur est constante pour chaque file (64 pour CAN1txQ, 16 pour CAN2txQ et 48 pour CAN0RxQ) et se lit comme la capacité de la file. La seconde varie, de 46 à 76 sur CAN2txQ et de 735 à 79 252 sur CAN1txQ. Aucun des deux sens n’est confirmé : les deux sont donc publiés sous des noms neutres, comme le fait l’amont.

Ce qu’un pilote peut en lire : un enregistrement est un message abandonné, pas un défaut, et rien sur le tableau de bord ne lui correspond. C’est la récurrence qui compte : la même file qui déborde à chaque trajet, ou des débordements regroupés autour d’une recharge ou d’un défaut, dit quel bus était surchargé, et quand.

Les onze noms de files de l’amont, et ce que chacune porte probablement (déduit du seul nom)
Nom de la fileVu iciRôle probable (déduit, non énoncé par le firmware)
CAN0RxQ, CAN1RxQ, CAN2RxQCAN0RxQ une foisMessages reçus sur le bus CAN 0, 1 ou 2
CAN1txQ, CAN2txQCAN1txQ 6, CAN2txQ 11Messages en attente d’envoi sur le bus CAN 1 ou 2
logQ—Entrées en attente d’écriture dans ce log
dashQ—Messages pour le tableau de bord
uarttxQ, uartrxQ—Un port série, en sortie et en entrée, vraisemblablement la console de diagnostic
pduQ—Une unité de distribution de puissance, si PDU veut dire ce que cela veut dire d’habitude
lssQ—CANopen Layer Setting Services, qui attribue les identifiants de nœud sur le bus (le même LSS que celui qui nomme la ligne de log libérant l’identifiant de nœud d’un chargeur)

Les onze noms sont ceux du zero-log-parser amont, qui a décodé cet enregistrement le premier, le 20 septembre 2026. Seuls les noms de la colonne du milieu ont été mesurés ici ; chaque rôle de la dernière colonne est une déduction à partir d’un nom.

Carte des champs 0x4F (31 octets)
[0:13]   the common header
[13:23]  queue name, 10 bytes, NUL-padded ASCII
[23:27]  value a, uint32 LE — constant per queue: 64, 16, 48 here
[27:31]  value b, uint32 LE — varies; meaning unconfirmed

Bannière de build du firmware (0x32) : quel logiciel tournait, et s’il a changé

Le type 0x32 est une bannière de build du firmware. Il utilise l’ancienne disposition d’enregistrement (pas de microsecondes, de séquence ni d’octet de décalage, charge utile à partir de l’octet 7), et ses quatre octets de temps contiennent un petit nombre relatif au démarrage, pas une date. Dans ce corpus, les 59 se trouvent dans 32 fichiers de cartes principales de plateforme Gen2 : 31 d’entre eux sont des exports de la variante 538XX, ceux aiguillés vers le chemin de carte principale Gen3, et aucun n’est un tampon circulaire Gen3 natif.

Après un octet de sens inconnu, la charge utile est un tampon de build de compilateur C (mois, jour, année et heure, tels qu’imprimés par __DATE__ et __TIME__), suivi, en option, d’un numéro de build et d’une banque flash, « banka » ou « bankb », chacun terminé par un nul. Ici, 54 enregistrements portent les trois (une charge utile de 32 octets) et 5 portent la date seule (22 octets) ; l’amont liste aussi des formes de 31 et 38 octets. Les banques se répartissent en 45 « banka », 9 « bankb » et 5 sans nom, et les builds ont été compilés entre 2019 et 2024.

Ce qu’un pilote peut en lire : quel build du firmware la carte principale exécutait pendant l’écriture du tampon, et s’il a changé. Un fichier qui nomme plus d’un build couvre une mise à jour (11 des 32 fichiers d’ici sont dans ce cas), et le décodeur liste chaque build dans l’ordre du fichier, avec le nombre d’enregistrements qui l’ont annoncé. Deux noms de banque suggèrent un schéma flash A/B, dans lequel une mise à jour est écrite dans la banque inutilisée ; c’est une déduction à partir des noms. Les numéros et les dates de build restreignent une moto à une petite population : cette page ne les imprime donc pas.

Carte des champs 0x32 (ancienne disposition, décalages après déséchappement)
[0]      0xB2
[1]      length, on disk
[2]      0x32
[3:7]    uint32 LE — a small boot-relative value, NOT a Unix time
[7]      one byte, meaning unknown
[8:]     "Mmm DD YYYY HH:MM:SS" NUL    build date and time (__DATE__ __TIME__)
         build number NUL               optional
         "banka" or "bankb" NUL         optional: the flash bank

Le zero-log-parser amont a décodé cet enregistrement le premier, le 15 septembre 2026. Le décodeur d’ici applique la même règle structurelle : la date doit s’analyser et chaque champ final doit être de l’ASCII imprimable, sinon l’enregistrement est refusé plutôt que nommé à moitié.

La disposition d’enregistrement dépend de la date du firmware, pas de la référence de pièce

C’est le piège qui coûtera le plus de temps à un implémenteur tiers. La même moto peut écrire des dispositions d’enregistrement différentes à des moments différents, et la référence de la MBB ne change pas avec elles.

Une SR/F de 2021 avec la référence MBB 40-08155 a produit un export de 2023 contenant 190 enregistrements de type 0x51 aux longueurs déclarées de 71, 72 et 74 octets, plus 31 enregistrements de type 0x48, 30 de type 0x53 et 8 de type 0x49, et aucun enregistrement 0x54. Le même VIN, la même référence, ont produit un export de 2026 contenant 151 enregistrements de type 0x51 de 75 et 76 octets, 151 de type 0x54, et aucun de type 0x48, 0x49 ni 0x53. Une mise à jour du firmware a changé le jeu d’enregistrements et leur taille alors que l’en-tête indiquait toujours 40-08155.

La conséquence pratique : un décodeur doit fonder sa carte de champs sur la longueur d’enregistrement déclarée, pas sur la référence, le modèle ou l’année. Mais cette page tirait auparavant du même tableau une seconde conclusion, fausse : qu’une longueur supérieure d’un ou deux octets au nominal (76 au lieu de 75, ou 30 au lieu de 29) est une dérive du firmware et sans conséquence. Elle n’est ni l’un ni l’autre. Ce sont des enregistrements échappés, et L moins le nombre d’échappements tombe sur la longueur canonique sans une seule exception sur le corpus. La distinction est vérifiable. Sur les neuf fichiers MBB natifs, il y a 69 enregistrements 0x51 trop longs, et 56 d’entre eux portent leur jeton d’état un octet trop tard, à l’octet brut 43, ce que fait exactement un échappement non respecté ; les 13 autres en portent plus d’un et sont décalés davantage. (Une version antérieure de cette page disait 81 et 71. Le 81 ajoute les 12 enregistrements 0x52 trop longs au décompte des 0x51, et le 71 ne se reproduit sous aucune convention de délimitation essayée.) Déséchappez d’abord et le jeton se trouve à l’octet 42 sur 1 347 enregistrements sur 1 356 avec les huit jetons du décodeur, et sur la totalité des 1 356 une fois REV et PARK comptés.

Longueurs 0x51 sur disque observées par fichier : toute longueur supérieure au nominal est un échappement
Fichier exportéModèleRéférence MBBLongueurs 0x51 sur disque (dont échappés)0x54 présent
2021-09 (tronçon de 16 ko)SR/S40-0819871 (32, dont 0 échappé), 72 (11, 11), 73 (2, 2)no
2023-04SR/F40-0815571 (177, 0), 72 (12, 12), 74 (1, 1)no
2025-10DSR/X40-0828575 (142, 0), 76 (5, 5)oui
2025-12-29SR/F40-0815575 (220, 0), 76 (19, 19)oui
2025-12-31SR/S40-0819875 (152, 0), 76 (2, 2)oui
2026-01-01SR/S40-0819875 (147, 0), 76 (3, 3)oui
2026-01-21DSR/X40-0828575 (130, 0), 76 (1, 1)oui
2026-02-07 08:53SR/F40-0819875 (143, 0), 76 (6, 6)oui
2026-02-07 14:37SR/F40-0815575 (144, 0), 76 (7, 7)oui

Les neuf fichiers MBB Gen3 natifs, délimités par chaîne de longueurs. Lisez la paire entre parenthèses comme (enregistrements à cette longueur sur disque, dont ceux qui portent au moins un échappement 0xFE). Toute longueur supérieure au nominal porte à 100 % un échappement et toute longueur nominale en est exempte à 100 %, ce qui est le point : 76 n’est pas une variante de firmware de 75, c’est 75 plus un octet d’échappement. Une version antérieure de ce tableau listait six fichiers et sous-estimait cinq des nombres d’échappés.

La variante de firmware 538XX : un format d’enregistrement connu et un piège d’aiguillage

Certaines motos dont le VIN est préfixé 538XX (historiquement Gen2, et rejetées d’emblée par le veto d’avant la Gen3 sur le modèle, sur le code d’année du VIN, ou les deux) ont été basculées par une mise à jour du firmware vers un corps MBB qui est un tampon circulaire flash d’enregistrements 0xB2 préfixés par leur longueur. Le fichier ressemble à du Gen2 vu de l’extérieur et à du Gen3 vu de l’intérieur. C’est exact, et c’est la raison d’être de cette section.

Ce que cette page disait ensuite est faux. Elle disait : « Avant l’existence d’un décodeur dédié, aucun chemin ne pouvait le lire. L’analyseur de texte Gen2 décodait chaque enregistrement en une ligne Board Status vide et ne produisait aucune entrée exploitable. » Ces fichiers n’ont jamais été illisibles. L’enregistrement 0x2c est l’enregistrement Riding Status ordinaire du zero-log-parser amont, traité depuis 2015, avec sa tension de batterie uint32 en millivolts lue depuis 2020. Lancez le parseur amont sur l’un de ces fichiers, comme l’a fait ce site en juillet 2026, et il se termine proprement avec 7 629 entrées dont 2 048 lignes Riding entièrement structurées portant compteur kilométrique, tension de batterie, régime, courant de batterie et température ambiante.

Ce qui a échoué est l’aiguillage, à l’intérieur de ce projet. Le chargeur Gen3 natif exige seulement l’ASCII « MBB » quelque part dans les 32 premiers octets et au moins dix octets 0xB2, et les deux sont trivialement vrais pour un fichier 538XX, dont l’en-tête est littéralement « MBB\0 ». Il renvoie des milliers d’entrées : le pipeline positionne donc « Gen3 detected from binary structure » et n’emprunte jamais le chemin JSON Gen2 de l’amont. Neuf des quatorze fichiers de ce corpus ont ainsi abouti à zéro trajet ; les cinq autres fonctionnaient déjà. La correction livrée était un décodeur, alors que le bogue était dans l’aiguilleur. Avant de conclure que la bibliothèque amont ne sait pas traiter un format, vérifiez si elle le fait déjà.

La variante reste une exception documentée à la règle qui ouvre cette spécification, et ses enregistrements méritent encore une carte de champs, parce qu’un décodeur en production lit leurs canaux électriques. Ils portent la tension de la batterie, le courant de batterie, le courant du moteur, cinq températures, le SOC, le régime du moteur et un compteur kilométrique. Ils ne portent pas la vitesse sur route. Quand le décodage est adopté, le rapport est reclassé comme génération 3 et ses entrées sont fournies telles quelles au détecteur de trajets Gen3 existant.

Détection : une signature d’en-tête plus une barrière sur le résultat

La signature est lue dans les octets du fichier, pas dans le VIN : les octets 0 à 3 sont l’ASCII « MBB » plus un nul, et les octets 38 à 41 sont A1 A1 A1 A1, suivis dans les vrais fichiers d’une date de build en ASCII.

Les vrais fichiers MBB Gen2 partagent exactement cette signature : elle ne discrimine donc rien à elle seule. La sonde lance par conséquent d’abord le décodage complet et n’adopte le résultat que si celui-ci franchit un seuil : au moins 10 entrées de changement d’état et au moins 50 entrées de télémétrie.

Cette page expliquait auparavant ce seuil en disant « un vrai Gen2 passe la signature mais n’écrit aucun enregistrement de télémétrie 0x2c ». C’est complètement faux. Les vrais fichiers Gen2 en écrivent beaucoup : les 121 fichiers partageant la signature que cette barrière rejette contiennent à eux tous 137 944 enregistrements 0x2c enchaînés par longueur, dont 46 721 de la même forme canonique de 40 octets, et un échantillon de 40 fichiers décode 22 831 d’entre eux sur 22 867 en une tension de batterie plausible, avec une médiane de 104 392 mV et un rapport batterie sur cellule de 28,043. Le 0x2c de 40 octets est l’enregistrement Riding Status du firmware récent, présent dans tout le corpus Gen2 courant que l’amont analyse déjà.

Ce qui séparait les deux populations était un second bogue. L’ancienne barrière testait la longueur sur disque contre 40 et ne pouvait donc pas voir un enregistrement échappé ; sur la plupart des motos Gen2, un champ bloqué à une valeur dont l’octet de poids faible est 0xB2 signifie que chaque enregistrement de télémétrie est échappé, si bien qu’elles obtenaient de 0 à 8 alors que les vrais fichiers 538XX obtenaient de 146 à 2 353. Corriger l’échappement efface cette séparation accidentelle : 30 des 135 fichiers partageant la signature passent à entre 425 et 2 408 enregistrements de télémétrie. Adopter ce décodeur pour eux serait un changement d’aiguillage plutôt qu’une correction de décodage ; la barrière de rendement continue donc volontairement de compter la population d’avant le déséchappement jusqu’à ce que cette question soit tranchée pour elle-même, et les mêmes 14 fichiers sont adoptés avant et après. Le Gen3 natif commence par 0xB2 et échoue d’emblée à la signature.

La sonde s’exécute avant la classification Gen3 plutôt qu’après, parce que les VIN 538XX tombent des deux côtés du veto : certains sont écartés vers le chemin Gen2 et d’autres ne sont pas écartés et seraient aiguillés vers le décodeur Gen3 natif.

Détection 538XX
signature   raw[0:4]  == "MBB\0"
            raw[38:42] == A1 A1 A1 A1
outcome     >= 10 state-change entries  AND  >= 50 telemetry entries
            (counted PRE-unescape, deliberately — see above)
framing     scan for 0xB2, take byte[+1] as the ON-DISK length,
            unescape the framed record, then accept it only when the
            uint32 LE at +3 OF THE UNESCAPED RECORD is a plausible
            timestamp (2019-01-01 .. now + 365 days)
gate        telemetry records are gated on the UNESCAPED length == 40

Lisez l’horodatage après le déséchappement, pas avant. La séquence de cinq octets 06 FE 01 5D 65 se produit exactement une fois dans ce corpus de 352 fichiers, dans un export de concessionnaire 538XX : lu brut, l’uint32 à +3 vaut 0x5D01FE06, soit le 13 juin 2019 ; déséchappé, il vaut 0x655DFE06, soit le 22 novembre 2023. Un enregistrement daté quatre ans et demi trop tôt se classe en tête du fichier et empoisonne tout garde-fou de maximum courant placé en aval. La même défaillance à grande échelle se produit côté MBB Gen3 natif, où 291 des 19 342 enregistrements délimités par chaîne de longueurs sur les neuf fichiers se décodent en une autre date une fois l’échappement respecté. Se fonder sur la longueur sur disque plutôt que sur la longueur déséchappée est la même classe d’erreur, et sur le chemin 538XX cela coûte 1 796 enregistrements de télémétrie.

Enregistrement de télémétrie (0x2c, exactement 40 octets)

Les décalages sont absolus par rapport à l’enregistrement, sur l’enregistrement déséchappé. Cette carte est la table run_status propre au zero-log-parser amont, et non quelque chose de déduit ici ; les décalages de charge utile de l’amont sont ceux-ci moins 7. Chaque canal est protégé par une plage, de sorte que les trames corrompues du tampon circulaire sont abandonnées plutôt que tracées. Deux grandeurs dérivées sont calculées dans le décodeur : la puissance en V × A / 1000, et le couple à l’arbre en kW × 9549 / rpm pour un régime supérieur à 100, qui est indépendant du rapport de transmission d’une manière dont la vitesse ne l’est pas.

Carte des champs de télémétrie 0x2c de la 538XX (run_status amont, décalages absolus par rapport à l’enregistrement)
DécalageLargeurChampDécodagePlage acceptée
+7uint8Température haute de la batterie°C0 < t < 80
+8uint8Température basse de la batterie°C0 < t < 80
+9uint16 LEÉtat de charge%0–100
+11uint32 LETension de la batteriemillivolts, exact50–130 V
+15int16 LETempérature du moteur°C0 < t < 150
+17int16 LETempérature du contrôleur°C0 < t < 150
+19uint16 LERégime du moteurtr/min ; aucune vitesse n’est dérivée≤ 8000
+23int16 LECourant de batterieampères entiers, décharge positive±400 A
+25uint8Masque de bits de présence des modules0/1/2/3 → 00/10/01/11≤ 3
+26int16 LECourant du moteurampères±1000 A
+28int16 LETempérature ambiante°C−50 … 70 inclus
+30uint16 LECompteur kilométriquekm, à vie, non décroissantvoir le garde-fou ci-dessous

Le compteur kilométrique est le seul endroit où ce décodeur s’écarte volontairement de l’amont, qui lit un uint32 à +30. Les deux concordent sur 19 480 des 19 516 enregistrements. Les 36 désaccords sont répartis sur quatre fichiers, dont 31 dans un seul, et chacun est un enregistrement où l’octet 32 vaut 2 et transforme un compteur kilométrique de 6 972 km en 138 044 km, ce qui est invraisemblable pour la moto et non monotone avec ses voisins. Le compteur odometer_high_word_rejected du décodeur lui-même sur les mêmes fichiers donne 36, ce qui corrobore le nombre de façon indépendante. La lecture uint16 est conservée, au prix d’un bouclage au-delà de 65 535 km ; aucune moto de ce corpus n’en est proche.

Retiré : l’étalonnage ajusté

Cette sous-section s’intitulait « Provenance de l’étalonnage » et s’ouvrait ainsi : « Aucun des facteurs d’échelle ci-dessus n’a été supposé. Chaque canal a été ajusté sur la vérité terrain du BMS ou sur une loi de conservation physique, et les statistiques d’ajustement sont la raison pour laquelle la carte est jugée fiable. » Elle citait ensuite une tension ajustée sur la tension de batterie du BMS avec r = 0,96, un courant validé par concordance de distribution, et une échelle de vitesse de 0,023323 km/h par tr/min issue de la conservation de la distance du compteur kilométrique avec r = 0,999. Les trois affirmations sont retirées. C’était la pire erreur de la page, et elle montre comment un ajustement à bon coefficient de corrélation peut être faux.

Tension. La lecture retirée était un uint16 à +12 mis à l’échelle par 0,24608 avec un décalage de 4,25 V. Cet uint16 est formé des deux octets du milieu d’un entier exact de 32 bits en millivolts, l’octet de poids faible étant écarté : l’identité « uint32 à +11 = 256 × uint16 à +12 + octet 11 de l’enregistrement » tient sur 19 513 des 19 516 enregistrements. Ajuster une droite sur une tranche tronquée d’un nombre que l’on possède déjà exactement ne peut pas être juste, et ne l’est pas : face à la vraie valeur, la droite ajustée s’écarte d’une médiane de 0,1391 V, d’un 99e centile de 0,5710 V et d’un maximum de 0,9728 V, et dépasse 0,1 V sur 62,8 % des enregistrements. Un contrôle autonome qui ne demande aucune référence externe : l’uint32 à +11 divisé par la tension de cellule à +36 a une médiane de 28,070, soit une batterie à 28 éléments en série lue en millivolts. La corrélation de 0,96 était réelle et n’apprenait rien, parce qu’une transformation monotone avec perte d’une grandeur est corrélée à cette grandeur par construction.

Courant. Celui-ci était pire qu’une approximation. La lecture retirée était un int16 à +22 divisé par 256, présenté comme des ampères Q8.8. L’octet 22 de l’enregistrement est un octet de remplissage (zéro sur 19 511 des 19 516 enregistrements) : cette expression se réduit donc algébriquement à l’int8 de l’octet 23, une identité vérifiée sur les 19 516. Le vrai champ est un int16 à +23 en ampères entiers. 487 enregistrements (2,50 %) dépassent la plage int8 et 418 d’entre eux sont sortis avec le signe inversé : un départ à +206 A était donc tracé à −50 A. Le pic de décharge de chaque moto était écrêté à environ 127 A, contre des pics réels par fichier de 199 à 385 A, soit un pic sous-estimé de 37,7 % à 70,5 %. Cette plage compare le pic de chaque décodeur sous son propre garde-fou, ce qu’un utilisateur aurait vu ; en limitant la lecture retirée aux seuls enregistrements que le garde-fou actuel de ±400 A accepte, elle devient 37,7 % à 73,8 %.

Vitesse sur route. Il n’y a pas de champ de vitesse dans cet enregistrement, et il n’y en a jamais eu. La constante 0,023323 avait été ajustée par conservation de la distance du compteur kilométrique, ce qui est une méthode saine pour une constante qui existe ; la réajuster par fichier donne de 0,02273 à 0,02504 sur les 13 fichiers comportant plus de 50 km de déplacement, un écart de ±5,2 %, parce que le rapport de transmission finale et la circonférence du pneu diffèrent selon le modèle. La constante livrée se situait entre 6,9 % trop bas et 2,6 % trop haut selon la moto. Une table par modèle aurait pu être ajustée, mais les 14 fichiers retenus portent sept VIN distincts et quatre d’entre eux ne fournissent chacun qu’un seul fichier : cette table aurait ajusté du bruit, la même erreur que l’étalonnage de la tension, un niveau plus haut. Le décodeur publie désormais le régime du moteur, qui est mesuré, et aucune vitesse dérivée.

L’ajustement a été remplacé par la carte des champs run_status propre au zero-log-parser amont, qui traite le 0x2c depuis 2015. Le contrôle indépendant qui prouve qu’elle est juste est physique plutôt que statistique : sur 483 sessions de trajet avec au moins 5 % de SOC utilisé et au moins 2 km parcourus, l’énergie électrique intégrée par pourcent de SOC est passée de 43,1 Wh/% à 50,0 Wh/%, ce qui implique une batterie utilisable de 5,00 kWh plutôt que de 4,31 kWh (correct pour les batteries ZF3.6 et ZF7.2 que portent ces motos), et l’énergie par kilomètre est passée de 46,3 à 54,1 Wh/km, face aux 55 à 70 publiés par Zero. Le coefficient de variation entre les sessions est tombé de 44,8 % à 39,4 %. Une correction qui à la fois ramène une estimation à la valeur physiquement juste et réduit sa dispersion fait quelque chose qu’une droite mieux ajustée ne peut pas faire.

Le compteur kilométrique porte son propre garde-fou, parce qu’il est non décroissant sur la vie de la moto et que le tampon circulaire ne l’est pas. Toute lecture inférieure au maximum courant, ou nulle, est rejetée et la dernière bonne valeur est reportée à plat. Un pas en avant n’est accepté que si l’augmentation ne dépasse pas le plus grand de 5 km et de 200 km/h multiplié par les heures écoulées depuis la dernière lecture acceptée. Le terme de cadence empêche une télémétrie clairsemée de sous-compter un long intervalle tout en écartant les trames dont un bit a basculé.

Ce qu’a coûté l’étalonnage 538XX ajustéMesuré sur 19 516 enregistrements canoniques de 40 octets 0x2c · 14 fichiers · 7 préfixes VIN · balayage d’octets livréA · tension : erreur absolue de la droite ajustée retirée, en voltspar rapport à u32 LE @ +11, qui est exactement la même grandeur · 19 512 enregistrements dans la garde de 50–130 V0,00,20,40,60,81,0median 0,139 Vp99 0,571 Vmax 0,973 V37.2%62.8 % des enregistrements sont faux de plus de 0,1 VL’ajustement approchait un nombre déjà présent dans l’enregistrement, après en avoir jeté l’octet de poids faible.B · courant : ce qu’un int8 pouvait et ne pouvait pas exprimer, en ampèresint8 : −128 … +127 Apic de décharge réel par fichier, 199–385 A-400-2000200400487 enregistrements (2.5 %) tombent hors de la fenêtre int8 ; 418 d’entre eux sont ressortis avec le signe inversé, traçant un démarrage à +206 A comme −50 A.Chaque lecture jugée sous sa propre garde, celle retirée sous-estimait le pic de 37,7 % à 70,5 %.
Cette figure remplace un retrait, et elle ne contient aucune donnée inventée. L’emplacement contenait auparavant deux nuages de points schématiques mettant en scène r = 0,96 pour une droite de tension ajustée et r = 0,999 pour une constante de vitesse ajustée. Les deux ajustements sont retirés, et les panneaux avec eux. Ce qui est tracé à la place est le coût mesuré de l’ajustement, sur les 19 516 enregistrements canoniques de 40 octets 0x2c que le balayage d’octets livré accepte dans les 14 fichiers qui passent la porte d’adoption 538XX (17 720 d’entre eux déjà à 40 octets sur disque, 1 796 récupérés par déséchappement). Le panneau de tension est le décisif, et ses statistiques d’erreur portent sur les 19 512 de ces enregistrements dans la garde de 50–130 V du décodeur. Les quatre hors de cette garde sont des trames corrompues qui s’ajustent à des mégavolts ; le maximum de 0,9728 V est donc un chiffre gardé, cité sur la population gardée. Le u16 @+12 × 0.24608 + 4.25 retiré ajustait une tranche de 16 bits d’un champ qui est déjà un entier exact de millivolts sur 32 bits (u32 @+11 == 256 × u16 @+12 + rec[11] se vérifie sur 19 513 des 19 516 enregistrements) ; une corrélation de 0,96 était donc garantie par construction et ne nous apprenait rien. Le panneau de courant est celui qui comptait pour les riders : i16 @+22 / 256 chevauche un octet de remplissage et se réduit algébriquement à int8(rec[23]), écrêtant le pic de décharge de chaque moto à environ 127 A. En comparant le pic de chaque lecture sous sa propre garde (celle retirée n’avait pas de garde à ±400 A, parce qu’un int8 ne peut jamais la déclencher), la sous-estimation va de 37,7 % à 70,5 %, au pire sur 538xx8z19gcj0XX68_MBB_2025-10-26.bin, 102,43 → 347 A. (Si l’on restreint plutôt l’ancienne lecture aux enregistrements que la nouvelle garde accepte, la plage est de 37,7–73,8 % ; la première paire est ce qu’un rider aurait vu, c’est donc elle qui est publiée.) Carte des champs maintenant reprise telle quelle de l’amont : zero-log-parser table run_status, qui distribue 0x2c depuis 2015.

Retirés : raw × 0,24608 + 4,25, courant Q8.8 et rpm × 0,023323

Si vous avez construit un décodeur 538XX à partir de la version précédente de ce tableau, trois de ses canaux sont faux. Remplacez la tension uint16 à +12 par l’entier uint32 en millivolts à +11. Remplacez le courant Q8.8 à +22 par le champ int16 en ampères entiers à +23, celui qui cesse d’inverser le signe de vos fortes accélérations. Et supprimez la vitesse dérivée : l’enregistrement n’a pas de champ de vitesse, et la constante que nous avons publiée est fausse jusqu’à 7 % dans un sens qui dépend du modèle. Le régime du moteur à +19 est la grandeur mesurée.

Événements d’état (0xFD) et pourquoi la recharge reste au BMS

Ce firmware n’écrit aucun des jetons d’état binaires de la Gen3 native. L’état est dérivé d’événements texte ASCII dont la charge utile commence à l’octet 7 de l’enregistrement plutôt qu’à l’octet 13, et il est reporté par horodatage sur les enregistrements de télémétrie suivants.

La recharge n’est volontairement pas détectée sur ce chemin. La MBB 538XX ne porte aucune télémétrie de recharge, et ses événements de contacteur du chargeur se déclenchent à répétition au cours d’une même recharge, ce qui fragmente une vraie recharge en dizaines de marqueurs sans données. Le décodeur n’émet donc aucune session de recharge MBB et laisse entièrement la détection de la recharge au BMS.

Dérivation de l’état 538XX à partir du texte
Texte de l’événement, comparé sans tenir compte de la casseÉtat dérivé
Module scheme changed from … to Running modeRUN
Module scheme changed from … to Stopped modeSTOP
Module scheme changed from … to Charging modeCHRG
Entering charge standbyCHRG
Leaving charge standbySTOP

Ce que la correction de l’aiguillage a permis de récupérer

Les chiffres d’avant et d’après sont de vrais résultats du pipeline, et ils valent la peine d’être conservés, à condition d’être étiquetés pour ce qu’ils mesurent. Deux motos 538XX sont passées de rien à un historique complet : l’une de 0 trajet et 0 km à 112 trajets et 678 km, l’autre de 0 à 88 trajets et 423 km. Sur la même exécution, les fichiers Gen3 natifs et Gen2 authentiques ont produit une sortie identique à l’octet près : le nouveau chemin n’a donc introduit aucune régression sur les formats qui fonctionnaient déjà.

Ces chiffres mesurent un fichier qui atteint enfin un décodeur. L’amont savait déjà lire ces enregistrements ; les entrées étaient perdues à cause du forçage par structure binaire décrit en tête de cette section. Lisez les chiffres comme le coût d’un bogue d’aiguillage, pas comme la preuve qu’une nouvelle disposition d’enregistrement a été percée.

Une seconde défense du chemin dédié survit, et elle est plus étroite que l’affirmation d’origine. Sur les cinq fichiers qui ont bien atteint le chemin Gen2 amont, son détecteur de sessions fragmente excessivement (546 trajets sur 602 km, soit environ 1,1 km par « trajet », contre 131 trajets et 491 km ici), et les garde-fous physiques de ce projet rejettent environ 0,24 % des lignes de l’amont comme impossibles. La logique de sessions et les garde-fous méritent donc leur place. Le décodeur d’enregistrements n’avait pas besoin d’être écrit ; seul l’aiguilleur devait être corrigé.

L’unité du compteur kilométrique a été confirmée comme étant le kilomètre, et non le mètre, par continuité avec les relevés historiques de compteur Gen2 des mêmes motos. Le contrat de format et le discriminateur sont tous deux verrouillés par des tests automatisés : un changement futur qui casserait l’un ou l’autre fait échouer le build au lieu de ramener en silence ces motos à zéro trajet.

Pourquoi le seuil porte sur un résultat et non sur une signature

Une détection fondée sur la signature se tromperait sur chaque vrai fichier Gen2, parce que les octets d’en-tête sont identiques. Lancer le décodage et juger le résultat coûte plus cher, mais on le croyait à l’abri des faux positifs. Il ne l’est pas : le pouvoir discriminant de la barrière de rendement venait d’un bogue du décodeur qu’elle contrôlait, et corriger l’échappement a donc effacé la séparation. La barrière compte maintenant volontairement une population d’avant le déséchappement qu’elle sait être un artefact, parce que la changer déplacerait en silence 30 fichiers vers un autre décodeur. Quand un seuil fonctionne, vérifiez s’il mesure bien ce que vous croyez.

Types d’enregistrement du BMS Gen3

Un fichier BMS Gen3 exporté depuis l’appli Zero fait 131 328 octets, soit exactement 128 octets de plus que le fichier MBB, pour une raison expliquée plus bas à propos des marqueurs de page flash. Les exports de concessionnaire font 262 144 octets. Les noms de fichier apparaissent sous la forme VIN_BMS.bin, VIN_BMS0.bin, VIN_BMS1.bin, VIN_BmsD0_*.bin ou VIN_10.bin selon le chemin d’export.

C’est la carte qui compte pour les données électriques. Tout ce que l’application affiche pour une moto Gen3 native (tension de la batterie, courant, puissance, écart entre cellules, état de charge, énergie de recharge) provient des enregistrements ci-dessous.

Types d’enregistrement du BMS, mesurés sur sept fichiers BMS Gen3
TypeNomTailleNombre par fichierTotal dans le corpusContenu
0xFBEn-tête125 B17Type de carte, référence, numéro de série, boîtier de cellules, firmware
0xFDÉvénement textevariable1 596–1 99713 178Transitions d’état, défauts, diagnostics
0x4BTélémétrie52 B186–5271 803Tensions de cellule, courant, SOC, tension de la batterie, état
0x4DTélémétrie étendue78 B79–126691Les champs de 0x4B décalés de +8, plus le registre de capacité de pleine charge
0x4CDétail des cellules70 B0–6584Les champs de 0x4B décalés de +4 ; écrit pendant les périodes de fonctionnement
0x00 / 0xF0Partiel ou débogagevariable12–28127Artefacts d’écrasement du tampon circulaire et débogage du firmware

Les sept fichiers contiennent à eux tous 15 890 enregistrements enchaînés par longueur, issus de cinq VIN distincts, et les six lignes ci-dessus les expliquent tous ; la ligne d’en-tête correspond aux sept enregistrements 0xFB, un par fichier. Comptés autrement, les mêmes sept fichiers donnent 16 005 délimiteurs 0xB2 bruts et 15 998 enregistrements délimités aux intervalles, ce que publie la page sur le tampon circulaire ; ce sont trois conventions sur un même ensemble d’octets, pas trois mesures en désaccord. Cinq octets de type isolés (0x78 deux fois, 0x6B, 0x6C, 0x76 une fois chacun) sont versés dans la ligne partiel/débogage et sont trop rares pour être caractérisés. Notez qu’un 0x4C est un enregistrement de 70 octets et que 70 ne figure pas dans la liste de répartition par intervalle qu’utilise tout décodeur fondé d’abord sur la longueur, ce qui explique exactement pourquoi chacun d’eux partait vers l’analyseur de texte avant l’arrivée de la répartition par type.

Enregistrement d’en-tête (0xFB, 125 octets)

Un par fichier. L’en-tête du BMS identifie la carte de contrôle de la batterie plutôt que la moto, ce qui en fait l’endroit où regarder quand une batterie a été échangée.

Carte des champs de l’en-tête BMS 0xFB
[0]        0xB2
[1]        0x7D (125)
[2]        0xFB
[3:7]      timestamp
[11]       sequence
[12]       UTC-offset setting, int8 hours
[13:16]    "BMS"
[23:31]    board type — "FST BCB" on every Gen3 file measured
[40:52]    part number — 40-08247-01 (3 files), 40-08295-01 (2),
           40-08367-01 (2). That is every value in this corpus
[56:69]    serial number
[72:80]    cellbox part number
[96]       firmware version major
[97:99]    cell count
[99:108]   firmware hash

Enregistrement texte (0xFD, variable)

Même structure que l’enregistrement texte de la MBB : l’en-tête commun de 13 octets, puis de l’ASCII terminé par un nul à partir de l’octet 13 de l’enregistrement. Cette page disait que le BMS se distingue par un « marqueur de carte » de 0x01 à l’octet 12 là où la MBB a 0x02 ; l’octet 12 est le réglage de décalage UTC, et les deux valeurs étaient les fuseaux horaires de deux motos. Ces événements sont le signal le plus fiable pour savoir quand la moto a été allumée, ce qui les rend déterminants pour la détection des sessions.

Le décodeur ne savait pas où le texte commence jusqu’en 2026-10. Il prenait « le premier octet imprimable à partir de l’octet 7 », de sorte que chaque fois qu’un octet de sous-seconde, de séquence ou de décalage se trouvait être imprimable, le texte y commençait, et s’arrêtait au zéro suivant, qui sur une moto en UTC+0 est l’octet 12 lui-même. Sur les 13 522 enregistrements texte du BMS de huit fichiers dont l’en-tête est intact et l’horodatage plausible, 4 268 (31,6 %) sortaient justes, 7 234 (53,5 %) étaient écartés comme « trop courts » (7 025 d’entre eux portant un vrai texte comme « Entering ZERO_BMS_STATE_IDLE »), et 1 890 étaient publiés comme du bruit du genre « Po\x0e », 130 autres portant un préfixe parasite. L’octet 13 est imprimable sur 8 786 des 8 788 enregistrements texte du BMS qu’aucun marqueur de page n’a touchés, et sur 18 570 des 18 570 enregistrements texte de la MBB. Seul le type 0xFD est du texte : tout autre enregistrement qui atteignait l’analyseur de texte (un enregistrement de télémétrie de mauvaise longueur, un enregistrement dont un marqueur de page avait écrasé l’octet de type) était fouillé pour ses octets imprimables et publié comme un « événement », et ne l’est plus. La correction plus que double les événements de machine d’états qu’un fichier fournit, et elle améliore la détection des trajets du BMS : les trajets scindés se refusionnent en l’unique trajet qu’enregistrait la MBB.

Tout cela est la disposition d’enregistrement FST, et le décodeur la vérifie désormais par fichier, à partir des octets, avant d’en appliquer quoi que ce soit. Le même décodeur reçoit aussi des fichiers qui ne sont pas FST du tout (des exports BMS à la forme Gen2 et des exports étranges que la sonde de télémétrie 0xB2 aiguille ici), et dans leurs enregistrements le texte commence bien à l’octet 7. Sur ceux-là, la règle de l’octet 13 coupait six caractères à chaque message (« DEBUG: CAN Link Is Down » devenait « CAN Link Is Down ») et supprimait les enregistrements laissés trop courts. Un fichier compte comme FST quand le marqueur de page ouvre ses deuxième et troisième pages ou, à défaut, quand le mot inférieur à la seconde vaut au plus 1 000 000 sur au moins 80 % de ses enregistrements et que l’octet 12 se lit comme un décalage UTC civil dominant ; mesurées sur 374 fichiers, les deux populations sont très éloignées (au moins 0,97 contre au plus 0,16 au premier test). Tout le reste garde exactement la règle d’origine.

Un enregistrement texte qu’un marqueur de page a traversé est un préfixe de ce que le firmware a écrit, parce que le marqueur s’ouvre par un octet nul et y termine la chaîne. Il est conservé et marqué comme tronqué, et un motif qui capture jusqu’à sa fin n’est pas cru : « Entering ZERO_BMS_STATE_HIB » coupé court n’est pas l’état HIB.

  • « Entering ZERO_BMS_STATE_OPERATIONAL » : la moto a été allumée.
  • « Entering ZERO_BMS_STATE_IDLE » : la moto a été éteinte.
  • « Entering ZERO_BMS_STATE_HIBERNATE », « …_STANDBY », « …_PRECHARGE », « …_UNLOCK » : les autres états.
  • « Precharge complete » et « Precharge: 95% » : progression de la précharge des contacteurs.
  • « Contactor open command received » (ordre d’ouverture du contacteur), précédé d’un décompte de millivolts de cellule.
  • « Fault set: INVALID/NO CELL TYPE » : une erreur CRC à la lecture du boîtier de cellules.
  • « Saving stats, hibernating for 86400 sec » : l’intervalle de sommeil du BMS, typiquement un jour plutôt que l’heure de la MBB.
Octet 24 du BMS : payload[24] / record[32]Fraction sous charge par valeur observée : un indicateur d’activité monotone, pas une machine à étatsoctet 24sous charge : payload[27] = 0xFFnpartbus actif|I| médian mA25%50%75%100%0x0974,5%472.0%72,3%5,7960x1062,2%1114.8%57,7%2130x0C45,2%56624.4%44,3%00x0F40,7%542.3%40,7%720x0835,9%391.7%35,9%00x0A34,5%1426.1%34,5%00xFF29,2%241.0%29,2%00x0720,7%291.3%20,7%00x0D16,0%1315.6%15,3%00x1215,4%522.2%15,4%00x0B14,4%60326.0%13,6%00x0613,9%361.6%11,1%00x0012,5%401.7%25,0%00x1112,2%411.8%12,2%10x0512,0%251.1%12,0%00x0E7,7%261.1%7,7%00x165,9%341.5%5,9%00x143,9%512.2%2,0%00x153,3%301.3%3,3%00x172,9%351.5%2,9%00x132,7%371.6%0,0%00x180,0%301.3%0,0%0l’une des quatre valeurs que l’énumération retirée nommait (0x09 · 0x0A · 0x0B · 0x0C)une valeur que l’énumération ne nommait pas0xFF : une sentinelle flash, pas une valeur d’état. Listée seulement parce qu’elle franchit le seuil n ≥ 20.Pourquoi la lecture à quatre états ne survit pas à la remesure37 valeurs distinctes apparaissent, de 0x00 à 0x23 plus les sentinelles flash 0xF0 / 0xFF. 0x09, 0x0A, 0x0B et 0x0Ccouvrent ensemble 1 358 des 2 319 lignes (58,6 %). Les 41 % restants sont des valeurs pour lesquelles l’énumération n’a aucun nom.Pas un compteur : 82,0 % des écarts consécutifs dans une fenêtre de 120 s sont exactement nuls (973 sur 1 186).Pas une température non plus : r = −0,05 par rapport à l’octet 43, lui-même retiré comme température (r = −0,41 par rapport aux cellules du MBB).L’une des quatre concorde avec les états texte propres du BMS. En reportantchaque événement « Entering ZERO_BMS_STATE_x » vers l’avant dans le temps, 0x09 se trouve sous UNLOCK sur 62 % des lignes (n = 45), lenom qu’on lui avait donné. 0x0B non : la valeur appelée IDLE se trouve sous HIBERNATE 41 %, IDLE 26 %, UNLOCK 14 %.Porté par les enregistrements 0x4B de 52 o, FST Mono de 50 o, 0x4C de 70 o (+4) et 0x4D de 78 o (+8). Aucun décodeur ne se branche dessus :stocké tel quel dans LogEntry.bms_state_code. Les discriminants de charge fiables sont payload[27] et payload[28].
payload[24] (record[32]) est stocké comme LogEntry.bms_state_code et aucun code ne se branche dessus ; tasks.py le regroupe seulement en une distribution par rapport. docs/GEN3_BINARY_FORMAT.md a autrefois associé quatre de ses valeurs à une machine à états (0x0B repos, 0x09 déverrouillage, 0x0A précharge, 0x0C actif), et cette lecture a été retirée ; le document porte maintenant le retrait et la docstring de parser.py dit en toutes lettres de ne pas la republier. Cette figure la dessinait, flèches comprises. Ce qui survit à la remesure est plus faible et à une seule dimension : la fraction sous charge monte à peu près de façon monotone sur au moins huit codes, et deux valeurs que l’énumération ne nommait jamais, 0x10 (n = 111, 62,2 % sous charge) et 0x0F (n = 54, 40,7 %), s’insèrent dans cette chaîne, 0x10 au-dessus de 0x0C. L’ordre joue donc contre le fait de traiter l’un des quatre comme un état nommé. Remesuré sur les 2 319 lignes de télémétrie que le décodeur livré émet depuis les 7 dumps BMS Gen3 de logs/ : découper à chaque 0xB2, déséchapper chaque tranche, aiguiller sur l’octet de type avec la longueur déséchappée comme recoupement (0x4C → +4, 0x4D → +8, sinon la règle de longueur 50/52/78 à +0), puis la porte de cellule de 2 500–4 500 mV. La figure portait un tableau de 1 557 lignes jusqu’au 2026-07-30 ; 1 557 est ce que ce décodeur émettait avant la correction d’échappement et l’aiguillage par type, donc chaque décompte a été rederivé et non remis à l’échelle. Traitez l’octet comme un indice d’activité opaque propre à chaque firmware, pas comme un décodage.

Enregistrement de télémétrie (0x4B, 52 octets) : la source de données principale

Les décalages de charge utile ci-dessous sont relatifs au début de la charge utile à l’octet 8 de l’enregistrement, selon la convention qu’utilise le décodeur. Pour convertir en décalage absolu de l’enregistrement, ajoutez 8 : payload[38] est record[46].

Le décodeur valide avant de croire. Des tensions de cellule hors de 2 500 à 4 500 mV font écarter tout l’enregistrement comme corrompu, ce qui rejette aussi les événements texte qui tombent de temps en temps sur un intervalle de la taille d’une télémétrie. Le SOC n’est accepté que de 1 à 100 ; un zéro signifie en sommeil ou non calculé, pas vide.

Enregistrement de télémétrie BMS 0x4B (52 octets)Décalages absolus dans l’enregistrement. payload[k] = record[8+k]. Sur un 0x4D, ajoutez 8 à chaque décalage ci-dessous ; sur un 0x4C, 4.+0+1+2+3+4+5+6+7+8+9+10+11+12[0][13][26][39]0123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051★ record[46:49] = payload[38:41] : tension mesurée de la batterie, uint24 LE, millivoltsDocumenté comme compteur interne depuis le premier décodeur Gen3 jusqu’au 2026-07-01. Réidentifié parce que le« compteur » fléchissait sous charge : 2 189/2 319 lignes = 94,4 % (92,1–96,5 % par fichier) tombent dans 28 × cell_min … 28 × cell_max.en-tête : délimiteur · taille · type · µs · séq · décalage UTChorodatage uint32 LE, [3:7]tensions de cellule (basse / OCV / haute)SOC %courant de la batterie, int32 LE mAoctet d’activité, charge, bus, mode de rapport★ tension mesurée de la batterie, uint24 LE mVnon décodé / remplissage
L’enregistrement 0x4B de 52 octets est le seul canal électrique par échantillon que produit une moto Gen3 native. Les décalages sont absolus dans l’enregistrement ; le décodeur lit une charge utile de 44 octets à partir de l’octet 8, donc payload[k] == record[8+k]. Le champ surligné record[46:49] (payload[38:41]) portait le commentaire « internal counter ~43000-49000 » qui « mysteriously sagged under load ». Il fléchit parce que c’est la tension de la batterie. Remesuré ici sur les 7 dumps BMS Gen3, sur les 2 319 lignes de télémétrie que le décodeur livré émet : 2 189 sur 2 319 (94,4 % ; 92,1–96,5 % par fichier) satisfont 28 × cell_min ≤ valeur ≤ 28 × cell_max, qui est exactement l’enveloppe d’acceptation que _parse_gen3_bms_entries utilise maintenant avant de se rabattre sur 28 × moyenne(cell_low, cell_high). Cette grille est la structure 0x4B et rien d’autre. Un 0x4D ne partage que l’en-tête de 13 octets puis insère 8 octets ; un 0x4C en insère 4. En balayant des décalages candidats et en testant si les mots de cellule tombent dans une bande plausible de 2 500–4 500 mV, un 0x4D obtient 0 à ces décalages et 619 sur 666 à +8, et un 0x4C obtient 0 ici et 75 sur 78 à +4. Appliquée à un enregistrement étendu, cette carte donne des valeurs qu’un contrôle de cohérence écarte en silence, pas des valeurs légèrement fausses. Cela a coûté 694 lignes de télémétrie ici, soit 42,7 % de la population, avant que le décalage soit trouvé. (L’ancien chiffre de 1 557 lignes encore en circulation est ce que ce décodeur émettait avant cette correction et avant la correction d’échappement ; 1 557 → 1 625 → 2 319.)
payload[9] réglé empiriquement sur les 1 598 lignes 0x4B que le décodeur émet
payload[9]LignesMode de rapport 3 (sommeil)SOC = 0Indicateur de charge 0x78|Courant| moyen
0x001 05757 (5,4 %)19 (1,8 %)590 (55,8 %)3 869 mA
0x20517427 (82,6 %)517 (100 %)504 (97,5 %)40 mA
0xF0 / 0xFF246 (25,0 %)6 (25,0 %)14 (58,3 %)3 356 mA

La population est celle des 1 598 enregistrements 0x4B parmi les 2 319 lignes de télémétrie que le décodeur en production émet, parce que payload[9] ne se trouve à ce décalage que sur un 0x4B ; sur un 0x4D il est huit octets plus loin et sur un 0x4C quatre. Chacune des 517 lignes avec payload[9] = 0x20 a SOC = 0, 97,5 % n’ont aucune charge, et leur courant moyen est de 40 mA contre 3 869 mA pour les lignes à 0x00. 0x20 est la valeur de sommeil et 0x00 celle d’éveil. La documentation interne énonçait la polarité inverse ; le code et la mesure concordent entre eux et la documentation a tort. 0xF0 et 0xFF sont des sentinelles de flash, pas des états. Une version antérieure de ce tableau lisait 1 022 / 511 / 24 et était comptée avant la correction de l’échappement du 2026-07-29.

Répartition des modes de rapport, payload[37], sur les 1 598 lignes 0x4B
ValeurSignificationLignesPart
1Rapport de SOC standard52232,7 %
3Sommeil / minimal49030,7 %
7Cadence élevée active, recharge ou décharge43727,3 %
4Repos311,9 %
5Précharge291,8 %
6Inconnu281,8 %
0 / 240 / 255Non initialisé ou sentinelle de flash613,8 %

Cet octet est payload[37], soit l’octet 45 de l’enregistrement sur un 0x4B. On le cite parfois comme « l’octet 37 de chaque entrée BMS », ce qui désigne le mauvais octet. La population est celle des 1 598 lignes 0x4B, parce que c’est le seul type d’enregistrement où payload[37] et l’octet 45 de l’enregistrement sont le même octet ; un 0x4D écrit son mode à l’octet 53 de l’enregistrement. Six vraies valeurs plus les sentinelles expliquent chaque ligne 0x4B, et contrairement à payload[24] plus bas, celui-ci se comporte bien comme une énumération. Sur l’ensemble des 2 319 lignes émises, lu au décalage propre à chaque type, la répartition est 7 sur 592, 1 sur 530, 2 sur 520, 3 sur 500, 4 sur 31, 5 sur 30, 6 sur 28 et une sentinelle sur 88. La valeur 2 vient entièrement du 0x4D.

Charge utile BMS 0x4B, 44 octets, décalages relatifs à l’octet 8 de l’enregistrement
payload[0:3]    = record[8:11], the upper three bytes of the microsecond word.
                payload[2] is always 0x00 (the word never exceeds 1,000,000);
                the 0xF0 / 0xFF once read here as a "flag" is the page marker
payload[3]      = record[11], the sequence counter (same byte on 0x4C / 0x4D)
payload[4]      = record[12], the UTC-offset setting, int8 hours
payload[5]      = record[13], 0x00 on 1,347 of 1,347 marker-free 0x4B records
                (was "constant 0x01, BMS marker")
payload[9]      sleep indicator — 0x20 sleeping, 0x00 awake (measured, see below)
payload[13:15]  cell voltage minimum, uint16 LE, mV
payload[15:17]  cell open-circuit voltage low, uint16 LE, mV
payload[17:19]  cell voltage maximum, uint16 LE, mV
payload[19]     SOC %, uint8 — 0xFF or 0xF0 means invalid
payload[20:24]  pack current, int32 LE, mA — positive discharge, negative charge
payload[22:24]  the HIGH HALF of that word, not a flag — see below
payload[24]     opaque byte — stored verbatim, NOT decoded; 37 values, no enum
payload[25]     constant 0x33
payload[26]     flag — 0x00 normal, 0x0C transitional
payload[27]     load flag — 0x78 no load, 0xFF under load
payload[28]     bus engaged — 0x00 off, 0x01 on
payload[37]     report mode — 1 standard, 3 sleep, 4 idle, 5 precharge,
                6 unknown, 7 active. A seventh value, 2, is written only
                by the 0x4D record.
payload[38:41]  measured pack voltage, uint24 LE, mV — see the next section
payload[41:43]  unknown / padding
payload[43]     NOT a temperature - retracted, see below

payload[24] n’est pas un code d’état : un retrait

Le courant de la batterie est la plus grosse erreur de mesure que cette page ait eu à corriger. Il était lu comme une valeur signée de 16 bits en milliampères, plafonnée à ±32,767 A. Une batterie Zero débite plusieurs centaines d’ampères à l’accélération, et comme rien n’écrête, la valeur stockée boucle au lieu d’être écrêtée : elle contenait le vrai courant modulo 65 536 mA, ce qui inverse le signe au lieu d’aplatir le pic. C’est pourquoi la direction enregistrée était proche d’un pile ou face en roulant : 55,5 % de décharge, contre 78,4 % sur le log MBB de la même moto sur les mêmes trajets.

C’est une valeur de 32 bits, et les deux octets que cette page décrivait comme un indicateur de recharge du firmware en sont la moitié haute. Sur les 72 fichiers BMS Gen3 natifs de la production, 45 060 enregistrements de télémétrie : ces octets valent FF FF sur 80,5 % des enregistrements dont la moitié basse est négative et 00 00 sur 84,9 % de ceux dont la moitié basse est positive. C’est une extension de signe. L’indicateur était réel en ce sens qu’il se déclenchait pendant la recharge, mais pas pour la raison donnée : FF FF est l’aspect d’un nombre négatif, et les courants de recharge sont négatifs.

Trois contrôles, chacun contre sa propre hypothèse nulle. Comptage de coulombs face à l’état de charge propre de la batterie : sur 84 segments contigus, le signe du courant intégré concorde avec le sens de la variation du SOC sur 83 sur 84 avec la lecture 32 bits, contre 49 sur 84 avec la lecture 16 bits, où 50 % est l’hypothèse nulle du pile ou face. La capacité impliquée est de 138,7 Ah pour 100 points de SOC (une batterie ZF14.4, ZF15.6 ou ZF17.3 fait 129, 139 ou 154), contre 16,8 Ah avant, ce qui n’est pas une moto. Et la loi d’Ohm face à la tension de batterie vérifiée séparément donne une pente médiane de −29,9 mΩ, négative sur 35 des 38 motos, une résistance interne plausible pour 28 éléments en série ; l’ancienne lecture donnait −5,6 mΩ et négative sur 20 des 38.

Une fenêtre de courant illisible ne donne désormais rien plutôt que zéro, parce que zéro se lit comme une batterie au repos. Un vrai zéro est conservé : c’est une lecture réelle sur environ un cinquième de tous les enregistrements.

Ce site a publié, et nos propres notes internes ont porté, une énumération à quatre valeurs pour payload[24] : 0x0B repos, 0x0C actif, 0x09 déverrouillage, 0x0A précharge. Elle est retirée. L’octet est extrait de chaque enregistrement de télémétrie et stocké tel quel, aucun décodeur n’agit sur sa valeur, et rien dans le corpus ne soutient son rattachement aux noms d’états du BMS. Si vous avez pris cette énumération ici, dans une copie, ou dans un décodeur construit dessus, jetez-la.

Sur les mêmes 2 319 lignes de télémétrie que le décodeur en production émet, utilisées partout ailleurs dans cette page, payload[24] prend 37 valeurs distinctes : toutes les valeurs de 0x00 à 0x23 sauf 0x02, plus les deux sentinelles de flash 0xF0 et 0xFF. Les quatre codes que l’énumération nommait couvrent 1 358 lignes, soit 58,6 % : deux lignes sur cinq ont donc une valeur que l’énumération ne sait pas nommer ; et 0x09, l’état « déverrouillage », concerne 47 lignes, 2,0 % du corpus.

Trois tests distincts ont été menés sur cet octet et il a échoué aux trois. Ce n’est pas un compteur : 82,0 % des écarts consécutifs dans une fenêtre de 120 secondes sont exactement nuls, 973 sur 1 186, et la séquence ne croît pas de façon monotone et ne boucle pas. Ce n’est pas une température : corrélé à payload[43] dans le même enregistrement, il donne r = −0,05, et les deux octets sont égaux sur 1,3 % des lignes, bien que cette comparaison-là soit désormais sans valeur, puisque payload[43] s’est lui aussi révélé ne pas être une température. Et il ne suit pas la machine d’états textuelle du BMS comme une partition. Reportez chaque événement « Entering ZERO_BMS_STATE_x » dans le temps et l’une des quatre valeurs s’aligne bien sur le nom qu’on lui avait donné (0x09 se trouve sous UNLOCK sur 62 % des lignes, n = 45), mais pas 0x0B : la valeur dite « repos » se trouve sous HIBERNATE sur 41 %, IDLE sur 26 % et UNLOCK sur 14 %. Une concordance sur quatre est l’aspect d’une énumération à quatre états quand elle est fausse.

La seule propriété qui survit est faible et ce n’est pas une énumération. Classé par fraction de lignes sous charge, l’octet s’ordonne comme un indicateur d’activité approximatif sur au moins huit valeurs, mais deux valeurs que l’énumération ne nommait pas, 0x10 à 62,2 % sous charge et 0x0F à 40,7 %, s’intercalent dans la chaîne même que l’énumération utilisait comme preuve, l’une d’elles au-dessus du supposé code « actif ». Une machine à quatre états ne peut pas avoir d’états sans nom intercalés entre ses états.

payload[24] est un octet interne du firmware qui varie avec l’activité, prend au moins 37 valeurs et n’a aucun sens décodé. Traitez-le comme opaque, et n’écrivez « 0x0B = repos, 0x0C = actif » nulle part sans l’avoir d’abord redérivé de vos propres fichiers.

Répartition mesurée de payload[24], 2 319 lignes de télémétrie, sept fichiers BMS
ValeurLignesPartSous chargeÉnumération avancée
0x0B60326,0 %14,4 %repos
0x0C56624,4 %45,2 %actif
0x0A1426,1 %34,5 %précharge
0x0D1315,6 %16,0 %sans nom
0x101114,8 %62,2 %sans nom
0x0F542,3 %40,7 %sans nom
0x12522,2 %15,4 %sans nom
0x14512,2 %3,9 %sans nom
0x09472,0 %74,5 %déverrouillage
0x11411,8 %12,2 %sans nom
0x00401,7 %12,5 %sans nom
0x08391,7 %35,9 %sans nom
0x13 / 0x16 / 0x171064,6 %2,7 % / 5,9 % / 2,9 %sans nom
0x06361,6 %13,9 %sans nom
0x15 / 0x18602,6 %3,3 % / 0,0 %sans nom
0x07291,3 %20,7 %sans nom
0x0E261,1 %7,7 %sans nom
0x05251,1 %12,0 %sans nom
0xF0 / 0xFF431,9 %10,5 % / 29,2 %sentinelles de flash
14 autres valeurs, chacune sous 20 lignes1175,0 %0–33 %sans nom

Chaque valeur observée dans le corpus est listée ou regroupée dans la dernière ligne ; rien n’est omis par commodité, et les lignes totalisent 2 319. « Sous charge » est la fraction de lignes de ce groupe avec payload[27] = 0xFF, lue au décalage propre à chaque type d’enregistrement, la même définition que celle de la figure ci-dessus : les deux concordent donc ligne à ligne. L’ordre selon cette colonne est la seule structure de l’octet, et c’est un continuum sur au moins huit valeurs, pas quatre états. Une version antérieure de ce tableau était comptée sur 1 557 lignes, la population que ce décodeur émettait avant la correction de l’échappement et la répartition par type du 2026-07-29 ; chaque nombre a bougé, tous ont donc été redérivés plutôt que remis à l’échelle.

Retirée : l’énumération d’états 0x09–0x0C

La correspondance 0x0B repos / 0x0C actif / 0x09 déverrouillage / 0x0A précharge a été publiée sur ce site et elle est fausse. Elle couvre 58,6 % des 2 319 lignes de télémétrie que le décodeur en production émet, échoue à un test de compteur et à un test de température, correspond à la machine d’états textuelle sur une de ses quatre valeurs et non sur quatre, et est entrelacée de valeurs sans nom qui se comportent de la même façon. La machine d’états du BMS est réelle, mais elle vit dans les événements texte ASCII, pas dans cet octet.

Télémétrie étendue (0x4D, 78 octets) et le décalage de +8

Cette page disait « les 52 premiers octets d’un enregistrement 0x4D ont la même disposition qu’un enregistrement 0x4B ». Ce n’est pas le cas, et c’est l’erreur de carte de champs la plus susceptible de coûter une journée à un implémenteur tiers. Un 0x4D ne partage que l’en-tête de 13 octets. Il insère ensuite huit octets : chaque champ de mesure se trouve donc huit octets plus loin que sa position dans le 0x4B, et les « 26 octets supplémentaires » que cette section décrivait sont les 26 derniers octets d’une charge utile décalée plutôt qu’un suffixe ajouté à une charge utile non décalée.

La mesure est sans ambiguïté. On balaie des décalages candidats de 0 à 12 et on teste si les deux mots de tension de cellule tombent entre 2 500 et 4 500 mV, sur les enregistrements de longueur exacte de sept fichiers BMS Gen3 : un 0x4B obtient 1 598 sur 1 732 au décalage 0 et au plus 14 partout ailleurs ; un 0x4D obtient zéro au décalage 0 et 619 sur 666 à +8, le meilleur décalage suivant obtenant 2 ; un 0x4C obtient zéro au décalage 0 et 75 sur 78 à +4, le meilleur suivant obtenant 3. Les dénominateurs bougent de quelques enregistrements selon la façon de parcourir le fichier (un parcours par chaîne de longueurs sur les mêmes exports donne 624 sur 671), mais la fraction est de 92,9 % de toutes les façons dont nous l’avons comptée, et le score aux décalages du 0x4B est nul de toutes les façons. Zéro aux décalages nominaux est le nombre important : un décodeur qui applique la carte du 0x4B à un 0x4D échoue complètement au lieu de se dégrader, et s’il a un contrôle de plausibilité des tensions de cellule, il écartera chaque enregistrement en silence.

Quatre corroborations du +8 qui ne touchent jamais la barrière des cellules qui a sélectionné ces enregistrements. L’uint24 à record[54:57] est la tension de batterie que le 0x4B écrit à record[46:49], avec une médiane de 104 793 mV, dans l’enveloppe à 28 cellules sur 578 enregistrements, un rapport tension de batterie sur cellule basse de médiane 28,020, et une cellule basse jamais supérieure à la cellule haute sur 619 sur 619. L’octet 59 de l’enregistrement se comporte exactement comme l’octet à l’enregistrement 51 d’un 0x4B (l’octet que cette page a un jour publié comme une température, et qui n’en est pas une ; voir l’encadré ci-dessous) : médiane 10 contre 13 pour le 0x4B, et une plage de 0 à 27 une fois écartées les 14 lignes qui portent une sentinelle de flash 0xF0 ou 0xFF ; prise brute, la plage est de 0 à 255 en entier, ce que fait une sentinelle à un champ de petit entier. Les octets 51 et 52 de l’enregistrement sont chacun nuls sur 603 sur 619 et tous deux nuls sur 594, comme les deux octets de remplissage nuls qui encadrent l’octet de mode de rapport du 0x4B. Et l’indicateur de charge, l’octet de bus engagé et le mode de rapport concordent entre eux plutôt qu’avec quoi que ce soit d’externe, mais pas parfaitement : sur les 72 enregistrements qui lisent la charge 0xFF, 68 lisent aussi bus engagé et 67 lisent le mode de rapport 7 ; sur les 527 qui lisent la charge 0x78, 502 lisent le mode de rapport 2. Le mode de rapport 2 se produit sur 520 lignes au total : les deux ensembles coïncident presque, mais pas exactement.

Ce dernier nombre est une petite découverte à part entière. Le mode de rapport 2 est une valeur que l’enregistrement 0x4B n’écrit jamais ; l’énumération compte donc sept valeurs, pas six : 1, 3, 4, 5, 6 et 7 du 0x4B plus 2 du 0x4D.

Le coût du décalage, avant qu’on le trouve, était que chaque ligne de télémétrie 0x4D et 0x4C était écartée : 744 enregistrements aux longueurs canoniques atteignaient la branche de télémétrie et chacun était refusé par le contrôle des tensions de cellule. Corriger les décalages en a récupéré 694 sur ce corpus, 619 du 0x4D et 75 du 0x4C, soit 42,7 % de télémétrie BMS Gen3 en plus, sans en perdre. Quatre-vingt-quatre pour cent des lignes 0x4D récupérées (521 sur 619, et de 47 % à 96 % selon le fichier) tombent dans un intervalle de plus d’une heure de la série 0x4B du même fichier : c’est donc une vraie densité d’échantillonnage et non des doublons, et elle alimente la page de la batterie et l’estimation de l’état de santé. Le seul champ qui survivait toujours est le registre de capacité, parce qu’il est récolté selon la longueur de l’enregistrement avant que la barrière s’exécute.

Octets supplémentaires du BMS 0x4D, décalages 52 à 77 de l’enregistrement complet
extra[0:2]    = record[52:54]  two zero pad bytes flanking the report-mode byte
                               (the 0x4B writes the same pair at record[43:45])
extra[1]      = record[53]     report mode — 2 on 520/619, 7 on 72
extra[2:5]    = record[54:57]  measured pack voltage, uint24 LE, mV — the 0x4B's
                               record[46:49] shifted +8. NOT a coulomb counter.
extra[5]      = record[57]     zero pad
extra[6]      = record[58]     flag byte — 0, 1, 3, 5, 6, 9, 25 observed
extra[7]      = record[59]     the 0x4B's record[51] shifted +8 - NOT a temperature
extra[8:10]   per-bike calibration, uint16 LE — observed 3,083–5,910; the two
              bytes differ by 0–2. Unverified — treat as undecoded.
extra[10:12]  per-bike cumulative counter, uint16 LE — observed 38,967–56,414
extra[12:14]  calibration — byte 12 constant 0x03, byte 13 varies 150–162
extra[14]     constant 0x00
extra[15:18]  full-charge capacity, uint24 LE, mAh = record[67:70]
extra[18:20]  constant 0x0000
extra[20]     sub-mode — alternates between 4 and 5
extra[21]     constant 0x00
extra[22:25]  full-charge capacity, twin copy = record[74:77]
extra[25]     trailing byte

Retirés : le compteur de coulombs et l’énumération de sous-états

Deux lignes de la version précédente de cette carte sont retirées. extra[2:4] était publié comme « compteur de coulombs, uint16 LE : diminue d’environ 3 unités par heure en hibernation ». C’est le 16 bits de poids faible de la tension de batterie uint24 à record[54:57], une identité qui tient sur 619 enregistrements acceptés sur 619, et la décroissance de « 3 unités par heure » est d’environ 3 millivolts par heure d’affaissement de la batterie pendant le stationnement. C’est la même mauvaise lecture que cette page avait déjà retirée pour la copie 0x4B du champ, dix-huit lignes plus haut. La copie 0x4D avait été manquée, ce qui plaide pour chercher une rétractation partout plutôt que de la corriger à un seul endroit. Et extra[6:8] était publié comme « indicateurs de sous-état, uint16 LE : 256, 1024, 5632 observés ». C’est une paire d’octets [indicateur, valeur] : l’octet de poids fort est le même octet de 0 à 27 que le 0x4B porte à record[51] (256 → 1, 1024 → 4, 5632 → 22). Cet encadré appelait auparavant cet octet « degrés Celsius », et ce n’est pas une température. Il a été retiré le 2026-07-31 face à la température de batterie du jumeau MBB (r = −0,074 sur 1 275 paires), et cette comparaison s’est révélée avoir utilisé le mauvais mot MBB, parce que les étiquettes de température de la MBB étaient elles-mêmes décalées d’un cran jusqu’au 2026-09-07. Re-mesuré face aux températures de cellule MBB corrigées, apparié à 90 secondes près sur les huit paires de la même moto d’ici (n = 339), il est corrélé à r = −0,41 avec la température de cellule basse et −0,43 avec l’ambiante, se situe à une médiane de 7 °C d’écart, et est à moins de 1 °C sur 1,5 % des paires. Une température ne va pas à rebours de deux thermomètres. L’octet de poids faible n’est pas toujours nul : les paires observées comprennent (0,2), (6,18), (0,4), (6,24), (1,13) et (3,10). L’énumération à trois valeurs était un artefact venu de n’avoir regardé que les lignes dont l’octet d’indicateur se trouvait être nul. Le zero-log-parser amont est parvenu au même verdict de façon indépendante et a abandonné sa propre lecture de l’octet en 2026-09.

Détail des cellules (0x4C, 70 octets), décalé de +4, et la question des 50 octets

L’enregistrement 0x4C n’apparaît que pendant les périodes de fonctionnement et il est rare : 84 enregistrements sur tout le corpus, avec un nombre par fichier entre 0 et 65 : trois des sept fichiers n’en portent aucun, et un en porte 65 sur les 84. (Cette phrase disait « 0 et 58 », ce qui contredisait le tableau au-dessus. Re-mesuré le 2026-07-30 sous le balayage d’octets livré : les nombres par fichier sont 0, 0, 0, 4, 7, 8, 65, et le même balayage reproduit exactement les lignes du tableau pour 0x4B 186–527 / 1 803 et 0x4D 79–126 / 691. Le tableau était juste.) Il porte la même charge utile qu’un 0x4B décalée de quatre octets, par le même mécanisme que les huit du 0x4D : quatre octets insérés après l’en-tête commun de 13 octets. Sur les 78 enregistrements 0x4C de longueur exacte d’ici, les tensions de cellule sont plausibles à +4 sur 75 (96,2 %) et aux décalages du 0x4B sur zéro.

À +4, le reste de l’enregistrement est tout aussi cohérent, ce qui distingue un vrai décalage d’un décalage chanceux. L’octet 48 de l’enregistrement est un octet de remplissage nul sur 75 sur 75 et l’octet 47 sur 74 sur 75, l’octet 49 est le mode de rapport et lit 7 (cadence élevée active) sur 75 sur 75, l’octet qui n’est pas une température à l’octet 55 a une médiane de 14 une fois les trois lignes à sentinelle de flash exclues (16 sinon), et la tension de batterie uint24 à record[50:53] a une médiane de 108 144 mV. Le courant médian est de −9,5 A : ces enregistrements sont donc écrits pendant la recharge.

Jusqu’à ce que ce décodeur apprenne le décalage, il n’en lisait jamais un : 70 ne figurait pas dans la liste de répartition par intervalle, donc chaque 0x4C partait vers l’analyseur de texte et d’événements. Dix-huit d’entre eux sur le corpus ont produit un « événement » dont le texte était trois octets imprimables consécutifs de charge utile binaire, des chaînes comme « @~\x05 » et « 7\x0b3 ». Ces dix-huit lignes sont les seules entrées que la répartition par type retire.

Une variante de télémétrie de 50 octets, parfois appelée FST Mono, est documentée sur la carte SR/S de référence 40-08201. Elle utilise la même carte de champs que l’enregistrement de 52 octets, tronquée de ses deux octets finaux : elle n’a donc aucun payload[43]. Le décodeur accepte sur cette base un intervalle de 50 octets dans le chemin de télémétrie.

Résolu depuis, et conservé pour mémoire. Mesurés sur les 72 fichiers BMS Gen3 natifs de la production, huit fichiers de quatre motos sont écrits entièrement dans la famille courte (40-08201 « FST Mono » sur sept, 40-08213 « FST Mod » sur un), sans aucun enregistrement de télémétrie de la famille standard entre eux, et les décalages de +4 / +8 tiennent sans changement. Ce qui suit était vrai du corpus de sept fichiers. Aucun des sept fichiers BMS mesurés ici ne vient d’une carte 40-08201 (ce sont des 40-08247-01 sur trois fichiers, 40-08295-01 sur deux et 40-08367-01 sur deux, et cette liste est exhaustive pour ce corpus) : rien ici ne peut donc confirmer la variante. Ce qu’il montre, c’est un coût. Sur les 514 intervalles de cinquante octets du corpus, 509 font encore cinquante octets après déséchappement, et 98,0 % d’entre eux portent l’octet de type 0xFD, c’est-à-dire que ce sont des événements texte ; aucun ne porte 0x4B. Chacun est transmis au décodeur de télémétrie puis rejeté par le contrôle de plausibilité des tensions de cellule, ce qui explique que l’erreur d’aiguillage soit inoffensive en pratique et pas seulement non détectée.

Vérifiez l’octet de type, pas seulement l’intervalle

Un décodeur écrit d’après cette spécification doit s’aiguiller sur record[2] et utiliser la longueur déséchappée comme contre-vérification, l’inverse de ce que fait un décodeur fondé d’abord sur l’intervalle. Trois cartes de décalages sont nécessaires, pas une : 0x4B à +0, 0x4C à +4, 0x4D à +8. Une répartition sur la seule longueur ne peut pas l’exprimer, parce qu’elle ne distingue pas un 0x4D de 78 octets de n’importe quel autre enregistrement de 78 octets. C’est exactement ainsi que 744 lignes de télémétrie étaient lues aux mauvais décalages puis écartées en silence par un contrôle de plausibilité qui faisait son travail. (744 est le chiffre que cette page mesure ailleurs : 666 enregistrements 0x4D étendus plus 78 enregistrements 0x4C de détail des cellules atteignant la branche, dont 694 ont été récupérés. Un brouillon antérieur disait 675 ici, ce qui relève de la convention aveugle à l’échappement du seul 0x4D que cette page passe une section à rétracter.)

Le marqueur de page flash du BMS : quatre octets écrasés à chaque page

Un fichier de gestion de la batterie Gen3 natif est écrit en flash par pages de 128 octets, et le début de chaque page après la première porte les mêmes quatre octets : 00 F0 FF 00. Ce n’est pas un séparateur entre enregistrements et ils ne sont insérés nulle part. Ils sont écrits PAR-DESSUS ce que le firmware avait mis à ce décalage (le délimiteur d’un enregistrement, sa longueur, son type, une partie de son horodatage ou une mesure), et les quatre octets qui s’y trouvaient ont disparu. Rien dans le fichier ne peut les ramener.

Reconnaître le marqueur est facile, car sa position ne varie jamais : décalage de fichier 128·k pour k = 1 à 1 025 (1 025 pages sur 1 025 après la première) dans les huit fichiers de batterie Gen3 natifs de ce corpus, soit 8 200 marqueurs en tout, et dans aucun des dix fichiers de carte principale, qui ne sont pas paginés. Un décodeur peut donc trouver chaque marqueur avant de délimiter le moindre enregistrement. Ce qu’il ne peut pas faire, c’est regarder une valeur décodée après coup et dire si un marqueur l’a produite, parce que les octets du marqueur se décodent en nombres d’apparence ordinaire. La figure montre deux vrais enregistrements qu’il a touchés.

Le marqueur de page flash du BMS, écrit par-dessus un enregistrementDeux vrais enregistrements 0x4B (52 octets), anonymisés. Rouge = les quatre octets que le marqueur a remplacés. ·· = masqué.A · le marqueur tombe à l’intérieur des champs : octets 29–32 de l’enregistrementB203414B2··3··4··56A6887E980690010381102120013001400150016001700180019002015210E2215230E2418250E26232700280029F030FF3100323333F0347835…en-tête de 13 octetscellulesSoCcourantactivitéLu à travers le marqueur (3.36) : courant = octets 28–31 = 00 00 F0 FF → −1 048 576 mA, une charge de 1 048 A3.37.0 : courant et octet d’activité retenus ; SoC 35 %, cellule la plus basse / la plus haute 3 605 / 3 608 mV lues telles qu’écritesB · le marqueur tombe sur l’en-tête : l’octet de type et les trois octets de poids faible de l’horodatageB20341002F03FF4005696487C480790010141101120013001400150016001700180019002075210F2275230F2478250F264C27CA28FF29FF30FF310C32333300347835…typehorodatageµsséqUTCcellulesSoCcourantLu à travers (3.36) : type 0x00, décodé comme télémétrie parce qu’il fait 52 octets ; horodatage F0 FF 00 69→ 0x6900FFF0 = 2025-10-28 17:40:00 UTC, la même seconde sur 95 enregistrements de 5 des 6 motos de ce corpus3.37.0 : horodatage retenu, la ligne reste sans date ; cellules 3 957 / 3 960 mV, SoC 76 %, courant −54 mA tels qu’écritsOù tombent les 8 200 marqueurs des 8 fichiers BMS Gen3 natifs, selon l’enregistrement dans lequel ils se trouvent :5 807 dans la charge utile ou le texte · 635 sur les microsecondes · 612 sur le 0xB2 de l’enregistrement suivant · 574 sur l’octet de poids fort d’un horodatage302 sur l’octet de séquence ou de décalage · 139 sur l’octet de type et les trois octets de poids faible de l’horodatage · 131 sur la longueur,le type et deux octets de poids faible. Seuls les deux derniers laissent un horodatage encore plausible : 268 lignes, 38 secondes forgées distinctes.
Deux vrais enregistrements issus des huit fichiers BMS Gen3 natifs de logs/, anonymisés : aucun fichier, VIN ou date de rider n’est montré, et dans l’enregistrement A les trois octets de poids faible du vrai horodatage sont masqués. Les octets rouges sont le marqueur. La mémoire flash de la batterie écrit 00 F0 FF 00 au décalage de fichier 128·k sur chaque page après la première (1 025 fois dans chacun des huit fichiers, 8 200 au total), et il remplace les quatre octets qui s’y trouvaient. Avant la version 3.37.0, le décodeur lisait à travers : l’enregistrement A publiait une charge de plus de mille ampères, et l’enregistrement B publiait un horodatage construit à partir des octets du marqueur lui-même. Depuis la 3.37.0, les deux décodeurs repèrent le marqueur par son décalage de fichier, reportent sa position à travers le déséchappement et retiennent exactement les champs qu’il couvre ; tout le reste de l’enregistrement est lu tel qu’écrit. Les octets 36 à 51 sont omis parce que le marqueur ne les atteint pas.

Ce sur quoi tombe le marqueur

L’endroit où le marqueur tombe dans un enregistrement décide ce que coûte sa lecture à travers. Compté sur les 8 200 marqueurs des huit fichiers de batterie, face à l’intervalle entre délimiteurs dans lequel chacun tombe :

Ce sur quoi tombent les 8 200 marqueurs des huit fichiers de batterie Gen3 natifs
Le marqueur commence surMarqueursCe que reçoit un décodeur qui lit à travers
Un octet à l’intérieur de la charge utile ou du texte d’un enregistrement5 807Une mesure fausse (un courant, une tension, un état de charge) ou un message coupé court
Les microsecondes (octets 7–10 de l’enregistrement)635Un minutage inférieur à la seconde faux, et parfois aussi l’octet de séquence ou de décalage
Le 0xB2 de l’enregistrement suivant, ou 1 à 3 octets avant lui612Deux enregistrements fusionnés en un seul intervalle : un découpage sur 0xB2 envoie le premier enregistrement, intact, au mauvais analyseur
L’horodatage lui-même (octets 3–6)574Une année 1970, 2097 ou 2105, refusée par la fenêtre d’horodatage : l’enregistrement est donc perdu
L’octet de séquence ou de décalage (octets 11–12)302Une séquence ou un décalage faux, et les premiers octets de la charge utile
L’octet de type (octet 2)139Type 0x00 et un horodatage de 0xHH00FFF0, une seconde falsifiée ; 138 sur 139 paraissent encore plausibles
L’octet de longueur (octet 1)131Longueur 0x00, type 0xF0 et un horodatage de 0xHHHH00FF, jusqu’à 18 heures d’écart ; 130 sur 131 paraissent encore plausibles

Chaque marqueur localisé par son décalage de fichier et compté face à l’intervalle dans lequel il tombe. Les deux dernières lignes sont les seules qui laissent derrière elles un horodatage crédible : 268 lignes en tout, sur 38 secondes falsifiées distinctes.

Écrasement, pas insertion : comment le fichier le prouve

Cette page décrivait un jour un « pied de page » de trois octets, F0 FF 00, qu’un décodeur pouvait retirer. Les deux moitiés étaient fausses : le marqueur fait quatre octets, et il n’y a rien à retirer, parce qu’il ne se trouve pas entre les enregistrements.

Les longueurs d’enregistrement prouvent que c’est un écrasement. Sur les 8 005 intervalles entre délimiteurs qui chevauchent une frontière de page dans les huit fichiers de batterie, la longueur déclarée est égale à l’intervalle sur 7 246 et plus courte sur 759, et ce n’est jamais l’intervalle moins quatre : les octets du marqueur sont comptés dans l’enregistrement où ils tombent. Sur les 10 365 intervalles sans marqueur, la longueur déclarée est égale à l’intervalle à chaque fois. La taille du fichier concorde : un export de batterie fait 131 328 octets et un export de carte principale 131 200, exactement une page de 128 octets d’écart.

Un contrôle d’intégrité de fichier peu coûteux

Un export BMS Gen3 natif porte exactement 1 025 marqueurs, un à chacun des décalages 128, 256, … 131 200. Un nombre différent signifie que le fichier est tronqué, rembourré ou n’est pas du tout un export BMS Gen3. Un décodeur qui trouve des marqueurs à 128 et 256 sait qu’il doit attendre les autres.

Pourquoi la même date falsifiée apparaît sur des motos sans rapport

Un horodatage est formé de quatre octets petit-boutistes : son octet de poids faible vient donc en premier. Quand le marqueur commence sur l’octet de type d’un enregistrement, il écrit F0 FF 00 sur les trois octets de poids faible de l’horodatage et ne laisse que le plus haut, qui change une fois toutes les 2^24 secondes, soit environ 194 jours. Chaque enregistrement touché ainsi dans les mêmes 194 jours se décode donc à la même seconde, quelle que soit la moto qui l’a écrit : 0x6800FFF0 est 2025-04-17 13:19:44 UTC, 0x6900FFF0 est 2025-10-28 17:40:00 UTC et 0x6A00FFF0 est 2026-05-10 22:00:16 UTC. Quand le marqueur commence un octet plus tôt, sur la longueur, les deux octets de poids faible de l’horodatage deviennent FF 00, et l’heure falsifiée tombe jusqu’à 18 heures de la vraie, sur une valeur que partage chaque enregistrement touché dans le même bloc de 18 heures.

Dans ce corpus, cela a produit 268 lignes avec un horodatage falsifié mais plausible, sur 38 secondes distinctes, et 2025-10-28 17:40:00 apparaît à lui seul sur 95 enregistrements de cinq des six motos dont les fichiers de batterie sont ici. Quand des motos sans rapport partagent une date à la seconde près, la cause est ce marqueur, pas une coïncidence ni un événement du firmware.

Des jours et des trajets ont été construits sur ces lignes. Une poignée d’horodatages falsifiés un jour où la moto était garée devient un jour d’activité ; de vraies valeurs de courant reportées sur une date falsifiée deviennent un trajet qui n’a jamais eu lieu. Redécodés avec la version 3.37.0, les huit fichiers de batterie locaux perdent 13 jours-fichiers et 18 de leurs 65 trajets détectés par la batterie, et chaque jour supprimé est un jour que seuls des horodatages falsifiés soutenaient.

Ce que fait le décodeur maintenant

Depuis la version 3.37.0, les deux décodeurs (celui du serveur et le portage navigateur derrière /decode) font quatre choses avec le marqueur, et jamais une cinquième :

  1. 1Localiser chaque marqueur par son décalage de fichier avant de délimiter, avec le même test en deux pages qu’utilise l’amont : un fichier est paginé quand le marqueur ouvre à la fois sa deuxième et sa troisième page, si bien qu’une seule concordance fortuite ne peut pas déclencher le traitement.
  2. 2Reporter la position de chaque marqueur à travers le déséchappement, pour qu’un enregistrement sache exactement lesquels de ses propres octets ont été écrasés, même quand un échappement se trouve devant eux.
  3. 3Retenir exactement les champs auxquels ces octets appartiennent : un courant devient « non mesuré », un horodatage devient illisible et la ligne reste sans date, un enregistrement texte qui rencontre un marqueur est conservé jusqu’au marqueur et marqué comme tronqué, et un enregistrement de télémétrie dont les octets de la barrière des tensions de cellule ont été touchés est abandonné, parce qu’une barrière qui a lu du bruit ne prouve rien. Tout le reste de l’enregistrement est lu tel qu’écrit.
  4. 4Là où le marqueur se trouve sur le 0xB2 de l’enregistrement suivant (612 fois ici), ramener l’intervalle à la longueur déclarée du premier enregistrement, pour que cet enregistrement intact soit décodé au lieu d’être remis à l’analyseur de texte comme un blob surdimensionné. Le second enregistrement, dont l’en-tête a disparu, n’est pas décodé.
Ce que le décodage 3.37.0 des huit fichiers de batterie locaux retient
ChampLignes de télémétrie retenuesSur
Tension de batterie mesurée (la ligne porte à la place l’estimation fondée sur les cellules)1562 985
Courant de la batterie1302 985
Horodatage (la ligne reste sans date)1302 985
Octet de séquence1242 985
Indicateur de charge1222 985
Mode de rapport1042 985
Octet d’activité1032 985
État de charge242 985
L’un quelconque des précédents6922 985

Sur les 13 127 événements texte du même décodage, 4 316 sont marqués comme coupés à un marqueur. Avant la correction, les mêmes huit fichiers donnaient 2 894 lignes de télémétrie, dont 699 portaient au moins une valeur lue à travers un marqueur ; les populations diffèrent parce que la correction a aussi récupéré des enregistrements que l’ancienne délimitation perdait.

Ne jamais retirer, et ne jamais préférer un nombre à un trou

Retirer (supprimer les quatre octets du marqueur et joindre ce qu’il y a de part et d’autre) est la cinquième chose, et elle n’est jamais faite. Rien n’a été inséré : les quatre octets d’origine ont été écrasés, et joindre le reste produit donc un enregistrement amputé d’un champ, avec chaque champ suivant au mauvais endroit. Et une valeur fabriquée est pire qu’un trou. Un trou se voit : un lecteur, un graphique ou un détecteur de sessions peut constater que rien n’a été mesuré et le contourner. Une valeur lue à travers le marqueur ressemble exactement à une mesure (une charge de 1 048 A, une date que cinq motos partagent), et elle se propage dans chaque total, chaque session et chaque comparaison en aval sans que rien ne la signale comme différente. Retenir coûte quelques lectures par page et garde crédible chaque nombre restant.

Mesuré sur le corpus de production

Le changement a été évalué sur tout le corpus de production avant sa livraison : 1 220 fichiers de log, décodés par master et par la version 3.37.0. Les fichiers Gen1, Gen2 et de carte principale Gen3 se décodent de façon identique sur chaque métrique ; seuls les 224 fichiers de batterie Gen3 natifs changent, et ils changent comme l’arithmétique ci-dessus dit qu’ils doivent le faire.

  • +243 755 entrées utilisables sur les 224 fichiers de batterie.
  • 290 jours-fichiers supprimés, tous des dates falsifiées par un marqueur. Elles reviennent sur des motos sans rapport : 2026-05-10, le jour de la seconde 0x6A00FFF0, était apparu sur 57 motos différentes, et 2025-10-28, le jour de 0x6900FFF0, sur 38.
  • 228 « trajets » sur la seule batterie ne sont plus produits. Pour 196 d’entre eux, le log de la carte principale de la même moto couvre la période et n’enregistre aucun trajet.
Les chiffres de production viennent de la comparaison du mainteneur sur le magasin de production et ne peuvent pas être relancés à partir de ce corpus public. Les chiffres locaux de cette section le peuvent, et ils concordent avec eux en direction et en forme : les mêmes secondes falsifiées, et la même disparition des jours que seules des lignes falsifiées soutenaient.

payload[38:41] : la tension de batterie qui était rangée comme un compteur

Pendant des années, ce champ a été documenté comme de l’espace de compteur réservé. Une ancienne carte de champs l’appelait « compteur interne, uint16 LE, environ 43 000 à 49 000 au repos, baisse sous charge », et notait qu’il s’affaissait pendant le roulage sans expliquer pourquoi.

Il s’affaisse sous charge parce que c’est la tension de la batterie. Le champ fait trois octets, pas deux : un uint24 petit-boutiste à payload[38:41], égal à record[46:49], qui contient la tension de batterie mesurée en millivolts. La lecture uint16 tronquée de 43 000 à 49 000 était les deux octets de poids faible d’un nombre comme 109 500.

Le décodeur n’accepte la valeur mesurée que si elle satisfait l’enveloppe d’acceptation à 28 éléments en série, c’est-à-dire quand 28 × cell_min ≤ valeur ≤ 28 × cell_max, avec les tensions de cellule minimale et maximale du même enregistrement. Mesurées sur le corpus, 2 189 des 2 319 lignes de télémétrie que le décodeur en production émet (94,4 %) la satisfont, avec une plage par fichier de 92,1 % à 96,5 %. Ces chiffres étaient 1 473 sur 1 557, 94,6 % et 92,2 % à 96,6 % avant que la correction de l’échappement et la répartition par type du 2026-07-29 n’agrandissent la population ; les deux sont justes pour leur propre population, et 2 319 est celle qui est livrée. Quand la valeur tombe hors de l’enveloppe (trames de sommeil et lignes corrompues par le tampon circulaire), le décodeur revient à l’ancienne estimation de 28 fois la moyenne des tensions de cellule basse et haute.

La puissance de la batterie est calculée comme la valeur absolue de V × I : chaque chiffre de puissance Gen3, chaque intégrale d’énergie de recharge et tout ce qui en dérive ont donc changé quand le champ a été identifié. C’est aussi une bonne illustration de la raison pour laquelle une enveloppe d’acceptation vaut mieux qu’un facteur d’échelle : l’enveloppe est dérivée de deux autres champs du même enregistrement, de sorte qu’elle valide la lecture face à la moto plutôt que face à une hypothèse.

L’indice était dans les données depuis le début

Un compteur ne diminue pas quand on accélère. Tout champ dont le comportement contredit l’étiquette mérite d’être relu à une autre largeur et avec un autre signe avant d’être rangé comme réservé.

Le registre de capacité, l’octet 67, et l’état de santé que l’on peut calculer

L’enregistrement étendu 0x4D contient la capacité de pleine charge de la batterie en milliampères-heures sous la forme d’un uint24 petit-boutiste à record[67:70], reflété à record[74:77]. C’est un vrai registre stocké et non du bruit : la copie jumelle suit la copie principale à environ 1 % près.

L’extraction est volontairement prudente. Un échantillon n’est collecté sur un enregistrement de 78 octets que si trois conditions sont réunies : aucun octet de sentinelle de flash (0xF0 ou 0xFF) n’apparaît dans record[67:70] ni dans record[74:77] ; les copies jumelles concordent à mieux que 2 % ; et la valeur est comprise entre 50 000 et 250 000 mAh, ce qui couvre toutes les batteries Zero de la ZF7.2 à la ZF17.3. La médiane des échantillons retenus est apposée sur une seule entrée de télémétrie par log, parce que le registre est une valeur stable par batterie et qu’une ligne porteuse suffit.

Mesurée sur le corpus, cette extraction donne de 50 à 100 échantillons propres par fichier et des médianes par batterie de 124 521, 127 419, 134 793, 143 313 et 144 656 mAh sur cinq motos. C’est une lecture de capacité de batterie, à une division d’un pourcentage d’état de santé, obtenue sans avoir besoin de capter une grosse session de recharge. Le registre est le seul champ d’un 0x4D qui a survécu au bogue de décalage décrit plus haut, parce que la récolte sélectionne les enregistrements selon leur longueur avant même que le contrôle des tensions de cellule du décodeur de télémétrie s’exécute.

Une mauvaise lecture que vous pouvez rencontrer ailleurs : l’octet 67 n’est pas un nombre de cycles

L’octet 67 de l’enregistrement a été décrit (y compris dans nos propres notes internes, et dans un décodeur livré brièvement) comme un nombre de cycles de charge uint8, présenté comme une métrique de santé clé avec une table de valeurs par moto : 16, 105, 137, 187 et 209 sur cinq motos. Cette lecture est fausse, et la table a été supprimée plutôt que corrigée, parce que les nombres qu’elle contenait ne signifiaient rien.

L’octet 67 est l’octet de poids faible du registre de capacité de pleine charge uint24 petit-boutiste à record[67:70]. Il erre de 0 à 255 sans monotonie et sans lien avec le nombre de recharges, ce que fait exactement l’octet de poids faible d’une lecture de capacité en milliampères-heures.

L’ancienne table se réfute avec ses propres nombres. Elle consignait les deux octets au-dessus du supposé nombre de cycles comme une « constante par moto, par ex. 486 ». Lisez 486 comme les deux octets de poids fort du même uint24 et le registre vaut l’octet 67 plus 124 416 mAh. Les cinq « nombres de cycles » étaient les 0,2 % inférieurs d’une unique lecture de capacité de batterie d’environ 124 Ah, un nombre qui se trouve, sans surprise, dans la même plage que les médianes mesurées ci-dessus.

Le décodeur qui écrivait cette valeur dans une colonne de nombre de cycles de charge a été livré, puis annulé le jour même, dès que le registre a été identifié. Le champ de la dataclass existe encore par compatibilité et n’est jamais renseigné, et cette absence d’affectation est documentée à l’endroit où elle se produirait sinon. Tout ce qui lit un nombre de cycles de charge Gen3 dans ce pipeline lit une valeur nulle.

Cette page raconte l’histoire au lieu de corriger le décalage sans commentaire, parce que la mauvaise lecture circule dans la nature. Si vous avez un décodeur Gen3, un tableur ou un article qui rapporte des cycles de charge d’après l’octet 67, le nombre qu’il contient est l’octet de poids faible d’un registre de capacité et il faut le jeter plutôt que le recalibrer.

record[67:70] : un registre, pas deux champsCapacité de pleine charge, uint24 LE, mAh · une SR/F 2021, médiane de 88 échantillons concordant avec leur jumeaurecord[67] = 105 est icideux octets de poids fort = 486 → 486 × 256 = 124 416 mAh0 mAh124 521 mAh99,916 % du registrerecord[67] agrandi ×1 190064128192255cinq valeurs publiées sur la plage d’un octetrecord[67] = 105105 ÷ 124 521 = 0,084 % du registre255 ÷ 124 521 = 0,20 %, le plafondDessiné à 1,2 px ; la largeur réelle à cette échelle est de 0,61 px.record[67]record[67:70]jumeau record[74:77]moto (numéro de série masqué)16144 656 mAhconcordance à 2 % prèsDSR/X 2024105124 521 mAhconcordance à 2 % prèsSR/F 2021137134 793 mAhconcordance à 2 % prèsSR/F 2023187127 419 mAhconcordance à 2 % prèsSR/F 2020209143 313 mAhconcordance à 2 % prèsSR/S 2021Le tableau publié indiquait 16 / 105 / 137 / 171 / 209. Sur les fichiers de logs/, le même octet donne16 / 105 / 137 / 187 / 209. Chacun vaut le registre modulo 256, et aucun n’est stable pour une même moto.
record[67] était publié comme « CHARGE CYCLE COUNT ← KEY HEALTH METRIC » avec un tableau de valeurs de cinq motos. C’est l’octet de poids faible du registre de capacité de pleine charge uint24 LE à record[67:70], répété à record[74:77]. Le décodeur qui l’écrivait dans LogEntry.charge_cycles a été livré dans 5fd0793 à 18:57 le 2026-07-01 et annulé dans 56f78c5 à 20:18 le même soir, 81 minutes plus tard. Les registres ci-dessous sont la médiane des échantillons sans valeur sentinelle et concordant avec leur jumeau de chaque fichier (n = 50 à 100 par fichier, médiane haute comme le décodeur la prend, sorted(samples)[n // 2]) ; les numéros de série du VIN sont masqués, comme dans docs/. Un uint8 ne peut jamais dépasser 255, donc la plus grande part que cet octet puisse jamais représenter d’un registre d’environ 124 Ah est 0,20 %.

Il n’existe aucun nombre de cycles dans le binaire Gen3

Ni à l’octet 67, ni nulle part ailleurs de ce qui a été identifié. Si vous avez besoin d’un nombre de cycles pour une moto Gen3, il faut le reconstituer à partir des sessions de recharge détectées, avec toutes les réserves qu’implique un tampon circulaire.

Quel état de santé peut être calculé, et ce qu’il en coûte

Aucun champ explicite de pourcentage d’état de santé n’existe dans aucune génération du format binaire Zero. Trois signaux liés à la santé existent bien sur la Gen3, et seul le premier est proche d’être exploitable.

Le registre de capacité de pleine charge est la lecture directe, et le diviser par la capacité nominale de conception d’après le VIN donne un rapport d’état de santé qui ne dépend pas de la capture d’une grosse recharge. Il est extrait et stocké aujourd’hui mais pas encore consommé par un point d’accès, de sorte qu’aucun pourcentage affiché actuellement n’en est dérivé. La tension en circuit ouvert à payload[15:17] est une tension de cellule au repos compensée de la résistance interne, qui pourrait en principe être associée au SOC par une courbe de référence de cellule, et qui est disponible même dans un export en hibernation seule ; aucune courbe de ce genre n’est implémentée. Un troisième signal listé ici auparavant, un compteur de coulombs à extra[2:4] censé suivre l’autodécharge à environ 3 unités par heure, n’existe pas : ces octets sont la moitié basse de la tension de batterie du 0x4D, et la décroissance est l’affaissement de la batterie en millivolts.

Ce qui est livré est une méthode par session indépendante de la génération : la capacité est estimée par session comme l’énergie divisée par la fraction de SOC déplacée, divisée par le nombre de modules de batterie actifs, et l’état de santé est la moyenne des cinq dernières estimations rapportée à la capacité nominale par module.

  • Aucun octet direct d’état de santé n’existe dans aucune génération. La Gen3 obtient un registre de capacité, qui est à une division près, et rien ne le relit pour l’instant.
  • La méthode par session a besoin d’une grande variation de SOC. Avec la barrière à 15 %, une moto qui n’est jamais que rechargée par petits appoints ne produit aucune estimation et donc aucun chiffre.
  • Un tampon circulaire Gen3 peut priver d’emblée la méthode par session sur une moto qui reste surtout à l’arrêt, parce que les sessions sont écrasées avant d’être exportées.
  • La voie par tension en circuit ouvert a besoin d’une courbe de référence précise pour la chimie de cellule concernée, qui n’est pas publiée.
La méthode d’état de santé par session qui est livrée
SoH % = mean(last 5 capacity estimates) / nominal_per_module x 100
capacity estimate (per session)
        = energy_kwh / (delta_SOC / 100) / active_module_count
sources : charging sessions (energy, SOC gained)
          ride sessions     (energy consumed, SOC used)
filters : delta_SOC >= 15
          charging: energy must be measured, not SOC-inferred
          estimate within 0.4x .. 1.15x of nominal
          interquartile-range outlier removal once >= 10 estimates exist
nominal : nameplate pack capacity, divided by active module count

Le filtre « mesuré, pas déduit » est déterminant. Une recharge récupérée à partir d’un trou de SOC porte une valeur d’énergie qui était elle-même calculée comme delta-SOC fois capacité : la rediviser par delta-SOC est donc circulaire et tirerait le résultat vers 100 %.

Fenêtres de validité des horodatages

Un détail au niveau du fichier déroutera un décodeur qui ne l’attend pas : quels horodatages croire, tout simplement. Le marqueur de page flash, qui en falsifie certains sur les fichiers de batterie, a sa propre section plus haut.

Deux fenêtres de validité d’horodatage différentes

L’horodatage est un uint32 petit-boutiste aux octets 3 à 6 de l’enregistrement, et deux fenêtres différentes lui sont appliquées à deux étapes différentes. Les confondre produit soit des enregistrements écartés en silence, soit des sessions absurdes.

Les délimiteurs binaires Gen3 utilisent la fenêtre stricte allant du 2019-01-01 (Unix 1 546 300 800) à aujourd’hui plus 365 jours. Cette page décrivait auparavant cette fenêtre comme un signal de délimitation : ce qui distingue une vraie frontière d’enregistrement d’un octet 0xB2 posé à l’intérieur d’une charge utile. Mesurée, elle n’en fait presque rien. Sur les 14 fichiers 538XX retenus, les propres compteurs du décodeur livré écartent 21 106 candidats : 18 002 dont le champ d’horodatage vaut exactement zéro (un emplacement flash effacé que le firmware n’a jamais écrit) et 3 104 qui contiennent quelque chose hors de la fenêtre. Aucune de ces deux classes n’est de la désambiguïsation de délimiteur ; c’est l’échappement qui s’en charge. (Sur les 135 fichiers à signature, les mêmes compteurs donnent 154 668 et 164 256 contre 614 539 candidats acceptés. C’est un autre dénominateur et une population par balayage d’octets : ne le citez qu’avec les deux précisés.) Une version antérieure de cette page donnait 23 026 rejets, 22 972 vrais débuts, 17 992 zéros et « seulement 54 vraies non-frontières » ; rien de ce quatuor ne se reproduit, et la décomposition en vrais débuts des 3 104 n’est pas quelque chose que ce corpus tranche, elle n’est donc pas avancée ici.

Le filtre générique d’après analyse, appliqué à chaque génération après décodage, accepte les années civiles 2015 à 2030. C’est ce qui sépare les entrées à horodatage exploitable du bruit de réinitialisation de l’horloge temps réel avant que la détection des sessions s’exécute. Les enregistrements qui l’échouent sont conservés mais triés en fin, parce qu’un enregistrement à l’horloge cassée peut quand même porter une mesure valide.

Deux remarques pratiques sur les valeurs elles-mêmes. L’octet de poids fort de l’horodatage, l’octet 6 de l’enregistrement, vaut environ 0x69 pour les dates de 2025 et 2026 ; cet octet a parfois été pris pour un marqueur de type d’enregistrement, et ce n’en est pas un : l’octet de type est record[2]. Et lisez l’horodatage dans l’enregistrement déséchappé, jamais sur la ligne. Un échappement qui tombe dans les octets 3 à 6 décale tout ce qui suit, et un enregistrement dont les octets sur disque se lisent juin 2019 peut se décoder en novembre 2023 une fois la paire FE 01 respectée.

Deux fenêtres d’horodatage, deux rôlesAucune n’est un choix de style. La plus stricte est un filtre sur les emplacements non écrits, PAS le seul test de frontière du découpeur201020122014201620182020202220242026202820302032«réinitialisation RTC de 1970»21052015-01-01 … 2030-12-31génériqueis_valid_timestamp()2019-01-01 (Unix 1546300800) …aujourd’hui + 365 javance avec le tempsdécoupeur Gen3filtre d’emplacements non écritsCe que filtre la fenêtre stricte : des emplacements non écrits du tampon circulaire, pas du bruit de charge utile. Sur les 14dumps 538XX adoptés, le décodeur livré refuse ici 21 106 candidats, dont 18 002 (85,3 %) lisent un horodatageexactement nul, un emplacement flash effacé ; les 3 104 autres lisent une autre valeur hors fenêtre. L’échappement 0xFE,et non cette fenêtre, garde le délimiteur hors des charges utiles, et l’octet 1 découpe un enregistrement.Lisez l’uint32 dans l’enregistrement DÉSÉCHAPPÉ : 291 enregistrements sur les 9 fichiers MBB Gen3 natifs changent de date une foisdéséchappés, jusqu’à onze ans d’écart : l’enregistrement de la figure 1 lit 2010 sur la liaison et 2021 une fois décodé.Le code d’année K = 2019 est aussi la première année de VIN que le veto pré-Gen3 cesse de rejeter.
Deux fenêtres existent dans le code et elles font des travaux différents. is_valid_timestamp() (MIN_VALID_YEAR = 2015, MAX_VALID_YEAR = 2030) est le filtre générique d’après-analyse que toutes les générations exécutent, séparant les entrées utilisables des déchets de réinitialisation de l’horloge avant la détection des sessions. Les découpeurs binaires Gen3 utilisent une fenêtre plus stricte, 1546300800 (2019-01-01) à now + 365 days. Cette légende le justifiait en disant qu’un horodatage plausible est la seule chose qui distingue une vraie frontière d’enregistrement d’un octet 0xB2 dans une charge utile. Ce n’est pas le cas : l’échappement 0xFE garde le délimiteur hors des charges utiles et la longueur déclarée à l’octet 1 est ce qui découpe un enregistrement ; la fenêtre est un filtre d’emplacements non écrits, et un bon. Ce qu’elle refuse, d’après les diagnostics du décodeur livré sur les 14 dumps 538XX adoptés de logs/ : 21 106 candidats, dont 18 002 lisent un horodatage exactement nul (un emplacement flash effacé) et 3 104 lisent autre chose hors de la fenêtre. (Le triplet 23 026 / 22 972 / 54 publié ici jusqu’au 2026-07-30 ne se reproduit sur aucune population ; ne le reprenez pas.) Une chose n’a pas changé : lisez l’uint32 dans l’enregistrement déséchappé, car un échappement tombant dans les octets 3–6 le décale. Sur les neuf fichiers MBB Gen3 natifs, découpés par chaîne de longueurs, 291 enregistrements décodent une date différente une fois déséchappés, dont 37 dans le dump SR/F de 2023, dont les octets sur la liaison donnent 1992 et les octets décodés 2023.
Fenêtres d’horodatage
FenêtrePlageAppliquée parRôle
Délimitation Gen32019-01-01 .. maintenant + 365 joursLes deux délimiteurs binaires Gen3, par enregistrement, APRÈS déséchappementRejeter les emplacements non écrits ou effacés du tampon circulaire
Validité génériqueannées civiles 2015 .. 2030Après analyse, toutes les générationsExclure le bruit de réinitialisation de l’horloge temps réel de la détection des sessions

État du décodage : connu, partiel et inconnu

Le tableau ci-dessous remplace les lignes Gen3 de l’ancien tableau d’état publié sur la page de comparaison des générations. Il remplace aussi une version antérieure de lui-même : quatre lignes ici contredisent ce que cette page disait avant, et elles sont signalées pour que vous sachiez quelle affirmation vous avez sous les yeux. Trois statuts sont employés volontairement : « Décodé » signifie que le décodeur en production l’écrit sur une entrée, « Présent mais NON lu » signifie que les octets sont identifiés et qu’aucun chemin de code ne les consomme, et « N’existe pas » signifie que le canal est absent du format, pas simplement non décodé.

État du décodage des champs Gen3
CarteChampEmplacementStatut
BMSTension de cellule min / maxpayload[13:15], payload[17:19]Décodé : uint16 LE mV, validé 2 500–4 500 ; ajoutez 8 sur 0x4D, 4 sur 0x4C
BMSTension de cellule en circuit ouvertpayload[15:17]Décodé : stocké, pas encore utilisé pour le SOC
BMSÉtat de chargepayload[19]Décodé : 0 signifie en sommeil, pas vide
BMSCourant de la batteriepayload[20:24]Décodé : int32 LE mA. Lu comme int16 jusqu’au 2026-07-31
BMSTension de la batteriepayload[38:41]Décodé : uint24 LE mV, mesuré, 94,4 % dans l’enveloppe
BMSTempérature—N’existe pas dans l’enregistrement de télémétrie. payload[43] va de 0 à 27 et va à rebours des températures de cellule de la MBB (r = −0,41) ; retiré
BMSIndicateur de rechargepayload[22:24]Dérivé : la moitié haute du courant int32 ; son signe, pas un indicateur
Les deuxCompteur de séquencerecord[11]Décodé : uint8, +1 par enregistrement de tout type ; stocké sous le nom bms_sequence sur les lignes BMS
Les deuxRéglage de décalage UTCrecord[12]Décodé : int8 heures ; résumé par fichier, jamais appliqué à un horodatage
BMSValeurs sous un marqueur de pagetous les 128·kRetenu : le champ est nul et nommé dans withheld_fields
BMSIndicateur de charge / bus engagépayload[27], payload[28]Décodé : signaux complémentaires
BMSMode de rapportpayload[37]Décodé : 7 valeurs connues selon les types d’enregistrement ; valeur 6 inexpliquée
BMSOctet d’activité (anciennement « code d’état »)payload[24]NON décodé : stocké tel quel ; 37 valeurs, aucune énumération ne survit aux tests
BMSIndicateur de sommeilpayload[9]Décodé : 0x20 en sommeil, 0x00 éveillé (mesuré)
BMSCapacité de pleine chargerecord[67:70] + jumeau à [74:77]Décodé : uint24 LE mAh, stocké, pas encore consommé
BMSTension de la batterie (copie 0x4D)record[54:57]Décodé : uint24 LE mV ; retiré en tant que « compteur de coulombs »
BMSCompteur cumulatif par motoextra[10:12]Inconnu : varie de 38 967 à 56 414, aucune corrélation trouvée
BMSDétail des cellules par briqueEnregistrement 0x4C, champs décalés de +4Décodé : même carte que 0x4B à +4 ; la correspondance par brique n’est pas établie
BMSNombre de cycles de charge—N’existe pas. L’octet 67 est un octet de capacité
MBBÉtatrecord[42:51], [46:55], [50:59] selon le typeDécodé : ancré par type d’enregistrement, dix jetons dont REV et PARK
MBBÉtat de chargerecord[33]Décodé : uint8, 0 en PWSU signifie non initialisé
MBBIndicateur de mode du contrôleurrecord[17]Décodé : 0x00 actif, 0x6A veille, 0x60 transition
MBBTempératuresrecord[51:71], cinq uint32Décodé : ambiante, moteur, onduleur, cellule haute, cellule basse (réétiqueté le 2026-09-07)
MBBCourant de batterierecord[38:42]Décodé : int32 LE mA, seulement tant que le bus est actif
MBBTension / courant du bus continu, régime du moteurrecord[21:33]Décodé : les lectures du contrôleur, seulement tant que le bus est actif
MBBRail d’accessoires 12 V (identification non prouvée)record[71:75]Émis brut : uint32 LE microvolts sur un réseau de 5 128 µV ; le réseau du CAN est prouvé, « quel rail » ne l’est pas
MBBVitesse sur route, autonomie estiméeQueue 0x52 / 0x53Décodé : mm/h et centièmes de km ; pas dans un 0x51
MBBCompteur kilométriqueQueue 0x52 / 0x53, disposition récenteDécodé : dixièmes de km, série vérifiée par fichier ; l’ancienne disposition et le 0x51 n’en portent aucun. record[71:75] est un rail de 12 V (retiré)
MBBEnregistrement du moteur0x54, 29 octetsDécodé : couple à l’arbre, courant du moteur, tension du bus continu
MBBTension de la batterierecord[34:38]Décodé : seulement tant que le bus est actif
MBBTable du chargeur / cibles de charge0x48 / 0x49Décodé : chaque enregistrement de chargeur, V/A/Hz du secteur, sortie continue, identifiant CAN, numéro de série ; plafond, % cible, V de stockage
MBBFile pleine0x4F, 31 octetsDécodé : nom de la file et deux compteurs, sens non confirmé
MBBEn-tête0xFBDécodé : VIN (chiffre de contrôle validé), modèle, année-modèle, révision de carte et de firmware, build du firmware
MBBBannière de build du firmware0x32, ancienne disposition, exports de plateforme Gen2Décodé : date de build, numéro de build, banque flash ; chaque build qu’un fichier annonce, dans l’ordre du fichier
Les deuxÉvénements texte0xFD, à partir de l’octet 13 de l’enregistrementDécodé : ASCII terminé par un nul ; le texte qu’un marqueur de page coupe est conservé jusqu’au marqueur et marqué
MBBInstantané d’état0x4B / 0x4C / 0x4D, côté MBBSimple étiquette : aucun dans ce corpus ; non utilisé pour les trajets
538XXTension, courant, régime, 5 températures, compteur kilométriqueEnregistrement 0x2c, 40 octetsDécodé : carte run_status de l’amont ; l’étalonnage ajusté est retiré

Les décalages de charge utile sont relatifs à l’octet 8 de l’enregistrement sur le BMS et à l’octet 0 de l’enregistrement sur la MBB, selon la convention qu’utilise chaque décodeur. Ajoutez 8 à un décalage de charge utile du BMS pour obtenir la position absolue dans l’enregistrement.

Comment ce décodage a été vérifié face au parseur communautaire

Le décodage Gen3 de cette page a été comparé, champ par champ, au parseur communautaire zero-log-parser à son commit de la branche principale 90c8cb2 du 29 septembre 2026. L’amont est un deuxième avis, pas une vérité de référence, et le but de l’exercice était de savoir où les deux concordent, où ils divergent et pourquoi. La version courte est la première sous-section ; la méthode, les chiffres et les remerciements suivent.

La version courte

Ce site décode les logs Gen1 et Gen2 avec le parseur communautaire zero-log-parser, épinglé au commit 90c8cb2 (29 septembre 2026 ; auparavant à 87c6e757, février 2026) ; les enregistrements Gen3 natifs de cette page sont décodés par le code propre à ce site. Le 3 octobre 2026, les deux décodeurs Gen3 ont été comparés enregistrement par enregistrement, alignés par décalage dans le fichier, à la branche principale du parseur au commit 90c8cb2 (29 septembre 2026, la version qu’exécute le parseur hébergé à home.hasslers.net/zerologparser). Partout où les deux décodent un enregistrement, ils concordent : les 2 866 lectures de tension de cellule, l’état de charge, les champs d’état, les températures, la table du chargeur et les rapports de file pleine. Plusieurs de ces enregistrements ont été décodés en premier par l’amont (l’en-tête de la carte principale Gen3 et le build du firmware 0x32 le 15 septembre, la table du chargeur 0x48 et la file pleine 0x4F le 20 septembre, un parcours tenant compte des pages pour les pages flash de la batterie le 22 septembre), et les versions de ce site, publiées le 3 octobre, ont été vérifiées face à eux. Quatre différences subsistent, dont une en faveur du parseur : il lit les deux numéros de série dans l’en-tête d’une batterie Gen3, ce que ce décodage ne fait pas. Depuis que l’épingle a bougé, le site enregistre les deux numéros de série que lit le parseur, à titre d’information seulement ; rien n’identifie encore une batterie par eux. Dans l’autre sens, le parseur ne décode pas encore les enregistrements texte Gen3 (type 0xFD), la plus grande classe d’enregistrements en Gen3 : son décodeur de messages lit le préfixe de six octets de l’enregistrement comme la chaîne. Il lit les quatre premiers octets de charge utile de l’enregistrement 0x54 comme un compteur kilométrique ; c’est la partie sub-seconde de l’horodatage de l’enregistrement. Et son LOG_STRUCTURE.md place encore un compteur kilométrique dans les octets 0–3 de l’enregistrement 0x51, là où ce corpus n’en trouve aucun ; selon la lecture de ce site, le compteur kilométrique est dans la queue des enregistrements 0x52 et 0x53 de disposition récente.

Méthode : aligner par décalage dans le fichier, jamais par horodatage

Chaque enregistrement est délimité une seule fois, par les délimiteurs de ce site (la chaîne de longueurs déclarées sur la carte principale, l’intervalle entre délimiteurs avec la coupe au marqueur de page sur la carte de la batterie), et les mêmes octets déséchappés sont remis aux deux décodeurs : celui-ci reçoit sa trame, l’amont sa charge utile, qui commence à l’octet 7 de l’enregistrement. Un enregistrement est identifié par l’endroit où il se trouve dans le fichier, et rien d’autre.

Les horodatages ne peuvent pas jouer ce rôle. Deux enregistrements écrits dans la même seconde sont le cas normal, pas l’exception : dans les dix fichiers de carte principale natifs, 19 705 des 21 724 enregistrements délimités (90,7 %) partagent leur seconde avec au moins un autre enregistrement, et 16 919 (77,9 %) avec un autre enregistrement du même type ; dans les huit fichiers de batterie, c’est 15 735 sur 18 370 (85,7 %) et 13 184 (71,8 %). Une jointure sur le temps apparie les mauvais enregistrements et rapporte des désaccords qui n’existent pas. Une comparaison antérieure rapportait un désaccord des deux décodeurs sur l’identifiant CAN d’un chargeur, 16 contre 17, alors qu’elle avait apparié deux chargeurs différents qui avaient répondu dans la même seconde.

Le corpus est constitué de tous les fichiers Gen3 natifs de ce dépôt : 18 fichiers, dix exports de carte principale et huit de carte de gestion de la batterie. Le code actuel de l’amont n’est chargé que pour la comparaison et jamais dans le même processus qu’un décodage complet, car le charger à côté de la version que ce site épingle change ce que renvoie la bibliothèque épinglée. Le script qui l’exécute, gen3_upstream_crosscheck.py parmi les scripts backend de ce dépôt, n’écrit rien et se termine avec le code 0 : c’est un rapport, pas une barrière, parce qu’un désaccord peut aussi bien être une erreur de l’amont que la nôtre.

Résultats, champ par champ

Mesuré le 3 octobre 2026 face à la branche principale de l’amont au commit 90c8cb2.

Ce décodeur face à la branche principale de l’amont, enregistrements alignés par décalage dans le fichier, 18 fichiers Gen3 natifs
ChampEnregistrementsConcordentDiffèrentRetenus ici
Tensions de cellule la plus basse et la plus haute du BMS2 8662 86600
État de charge du BMS2 8662 842024, sous un marqueur de page
Courant de la batterie du BMS2 8662 70729130, sous un marqueur de page
Tension de batterie mesurée du BMS2 8662 69515156, sous un marqueur de page
État du véhicule de la MBB (0x51, 0x52, 0x53)1 7271 7270—
Températures 0x51 de la MBB : moteur, onduleur, cellule haute, cellule basse1 536 chacune1 536 chacune0—
Chargeur MBB 0x48 : nom, identifiant CAN, version, numéro de série, fréquence119 chacun119 chacun0—
File pleine MBB 0x4F : nom et les deux valeurs18 chacun18 chacun0—
Enregistrements texte (0xFD), les deux cartes33 460L’amont ne renvoie aucun des messages——

Les 2 866 lignes de batterie sont les enregistrements de télémétrie que les deux décodeurs émettent. En plus d’eux, 119 enregistrements de télémétrie sont décodés ici et pas par l’amont, 625 par aucun des deux, 235 sont décodés par l’amont et abandonnés par ce décodeur parce qu’un marqueur de page a écrasé une partie de l’enregistrement, et 1 est abandonné par ce décodeur pour une autre raison.

Là où les deux divergent, et pourquoi

Chaque différence du tableau a une cause que l’on peut nommer :

  • Les 29 différences de courant sont toutes des mots que ce décodeur refuse comme du flash effacé. Vingt-sept fois, les quatre octets lisent FF FF FF FF, que l’amont publie comme −1 mA ; deux fois, ce sont d’autres combinaisons d’octets de sentinelle de flash, que l’amont lit comme 240 mA et −16 mA.
  • Les 15 différences de tension de batterie sont toutes des lignes dont le mot mesuré tombe hors de l’enveloppe à 28 cellules ou sous un marqueur. Ce décodeur publie alors 28 fois la tension de cellule moyenne propre à l’enregistrement, et l’amont le mot tel que lu : 13 diffèrent de 39 à 647 mV, et dans les deux autres le mot lit 0 et 164 mV.
  • Le texte est là où les deux se séparent complètement. Les 18 fichiers contiennent 33 460 enregistrements texte, 18 570 sur les cartes principales et 14 890 sur les batteries, et ce décodeur en lit 31 686 comme du texte : 18 023 messages de carte principale et 13 663 événements de batterie. La branche principale de l’amont ne renvoie aucun de ces messages. Son décodeur de messages lit le préfixe FST de six octets de l’enregistrement comme la chaîne : un enregistrement qui dit « State change from CHRG to … » ressort donc sous la forme de deux caractères de contrôle. Le texte est la plus grande classe d’enregistrements d’un fichier Gen3, et c’est là que la machine d’états, les défauts et les événements de contacteur sont écrits en toutes lettres.

Le garde-fou de régression : 43 vrais enregistrements, deux décodeurs, un fichier

Une comparaison face à un amont mouvant est une mesure, pas un test. Ce qui empêche ce décodage de dériver est un jeu de test validé de 43 vrais enregistrements anonymisés (22 de carte principale, 18 de carte de gestion de la batterie et 3 enregistrements de batterie de l’ancienne disposition), avec les valeurs que ce décodeur produit pour chacun. Il ne contient aucun enregistrement d’en-tête ni aucun texte identifiant, et les numéros de série de chargeur y sont mis à zéro. Le décodeur Python est testé contre lui dans la suite backend et le décodeur du navigateur derrière /decode contre le même fichier dans la suite frontend : les deux implémentations ne peuvent donc pas diverger sur un enregistrement sans qu’un test échoue. Quand le portage navigateur a été remis au pas pour la version 3.37.0, il différait du décodeur serveur sur 0 valeur sur les 18 fichiers natifs.

Ce que l’amont a trouvé en premier

Une grande partie de ce que cette page a ajouté en octobre 2026 avait été trouvée en premier par le parseur communautaire, et le décodeur d’ici a été vérifié face à lui plutôt qu’écrit en isolation. Dans la branche principale de l’amont :

  • les décalages de l’en-tête de la carte principale Gen3 pour le VIN, le modèle, la révision de carte et de firmware et le build du firmware, le 15 septembre 2026 (commit 8591af3), en s’appuyant sur la pull request de 2022 d’AtomicDog ;
  • la bannière de build du firmware 0x32, également le 15 septembre (825c9d2) ;
  • la table du chargeur 0x48 et le rapport de file pleine 0x4F avec ses onze noms de files, le 20 septembre (f1e34cb, 1da1827) ;
  • les instantanés d’état 0x4B, 0x4C et 0x4D de la carte principale, le 20 septembre (82475b7) ;
  • les microsecondes inférieures à la seconde et le compteur de séquence par entrée dans le préfixe de l’enregistrement ;
  • et le marqueur de page flash comme écrasement plutôt qu’insertion, avec les deux cas où il détruit l’en-tête ou le type d’un enregistrement et un parcours tenant compte des pages du fichier de batterie, le 22 septembre (2c98751), mesuré par l’amont sur 291 fichiers.
Ce que ce décodeur ajoute, c’est le reste du traitement du marqueur de page (retenir les champs qu’un marqueur couvre à l’intérieur d’un enregistrement au lieu de les lire, et ramener un intervalle en arrière quand un délimiteur est détruit), ainsi que le texte lu à partir de l’octet 13, le test de disposition par fichier, l’année-modèle, la lecture de fuseau horaire de l’octet 12 et les champs de mesure continus et alternatifs de la table du chargeur. Chaque projet a désormais un deuxième avis sur l’autre, et le script de comparaison est là pour que chacun puisse être revérifié.

Décodeur dans le navigateur

Ce décodeur applique la spécification ci-dessus à un fichier de votre choix. Il découpe les enregistrements 0xB2, classe chaque octet de type, décode les cartes de champs documentées sur cette page et signale ce qu’il n’a pas pu lire, pour que vous puissiez vérifier n’importe quel décalage d’ici sur votre propre log.

C’est le même décodage que le pipeline serveur : validé champ par champ face à l’analyseur Python sur une route forcée, qui exécute tous les décodeurs applicables sur chacun des 352 vrais fichiers de log : 1 190 446 entrées, zéro divergence, empreintes canoniques identiques à l’octet sur les 352. Sur la route production, où le classificateur choisit un décodeur par fichier, le même corpus donne 67 fichiers décodés et 317 124 entrées, également avec zéro divergence. Le MBB Gen3, le BMS Gen3 et la variante de firmware 538XX sont pris en charge ; les fichiers Gen1/Gen2 sont reconnus et identifiés mais pas décodés ici, ce qui explique que le total de production soit le plus petit des deux.

Cet accord est une garantie de portabilité : il prouve que les deux implémentations concordent, et il ne peut pas prouver que l’une ou l’autre concorde avec le firmware. Là où le décodeur Python se trompe, celui-ci se trompe exactement de la même façon, par conception, et c’est ce qui rend le recoupement significatif. Les écarts connus par rapport au format sont ceux exposés plus haut : plusieurs champs identifiés qu’aucun décodeur ne lit, et les retraits signalés sur place.

Décodé entièrement dans votre navigateur. Ce fichier n’est jamais envoyé.

Le décodeur est du JavaScript qui s’exécute dans cet onglet. Votre fichier .bin est lu avec l’API de fichiers standard, décodé en mémoire et affiché ci-dessous. Le décodage ne fait aucune requête réseau, de quelque sorte que ce soit : rien n’est envoyé, aucun VIN n’est transmis, et aucun événement d’analyse ne contient quoi que ce soit de votre log. Fermez l’onglet et tout a disparu.

Un fichier est une fenêtre de trois jours. La Gen3 écrit dans un tampon circulaire qui s’écrase en commençant par le plus ancien : une moto à l’arrêt se réveille environ une fois par heure et écrit une médiane de 31 entrées, si bien que le tampon se remplit en 3,1 à 3,3 jours d’arrêt environ, et plus vite encore en roulant ou en recharge, quand les cartes écrivent plusieurs fois plus souvent. Tout ce qui est plus ancien a déjà disparu du fichier que vous venez de décoder : c’est la moto qui l’a écrasé, pas cet outil qui l’a perdu. Pourquoi votre log Gen3 ne montre aucun trajet explique comment le reconnaître et comment exporter avant que cela arrive. Garder l’historique, c’est garder les fichiers : un compte conserve chaque export et raccorde ceux qui se recouvrent en une chronologie continue par VIN. Ce décodeur reste gratuit et complet dans les deux cas.
Le pipeline d’analyse complet (détection des sessions, santé de la batterie et constats de défauts) est disponible en envoyant un log, ou vous pouvez l’essayer sur des données d’exemple dans la démo en lecture seule.

Questions fréquentes

Le log MBB Gen3 contient-il la tension de la batterie, le courant ou la vitesse ?

Tension et courant : oui, et cette page disait auparavant le contraire. La tension de la batterie est un uint32 petit-boutiste en millivolts à record[34:38] et le courant de batterie un int32 signé en milliampères à record[38:42], et les deux sont renseignés exactement quand le système haute tension est actif : non nuls sur 144 enregistrements RUN sur 144 et nuls sur 417 enregistrements d’hibernation sur 417. Une session de recharge lue à partir de ces octets montre une phase d’absorption à tension constante de manuel, et leur intégration sur le SOC retombe sur la capacité utilisable de la batterie. Le décodeur en production lit les deux depuis le 2026-09-07, à partir d’enregistrements dont le bus est actif ; ils sont vides dans les états qui forment 75 % d’un vrai log, le BMS reste donc la meilleure source. Vitesse : oui, mais pas dans l’enregistrement courant. Les enregistrements plus longs 0x52 et 0x53 portent la vitesse sur route, l’autonomie estimée et (sur le firmware récent) le compteur kilométrique dans leur queue ; le 0x51 de 75 octets n’en porte aucun, et record[71:75], publié ici comme un compteur kilométrique, est un rail d’accessoires de 12 V en microvolts. Les mesures de tension et de courant viennent de cinq motos de la plateforme SR/F ; l’unique DSR/X de ce corpus les renseigne à peine : considérez-les donc comme non confirmées sur ce matériel.

Quelle est la structure d’un enregistrement Gen3 0xB2 ?

L’octet 0 est le délimiteur 0xB2, l’octet 1 est la longueur totale de l’enregistrement sur disque, délimiteur et octets d’échappement éventuels compris, l’octet 2 est le type d’enregistrement, les octets 3 à 6 sont un horodatage Unix en uint32 petit-boutiste en UTC, les octets 7 à 10 sont la partie inférieure à la seconde en microsecondes, l’octet 11 est un compteur de séquence qui augmente de un à chaque enregistrement, et l’octet 12 est le réglage de décalage UTC de la moto en heures sous forme d’octet signé (deux champs que cette page décrivait comme un seul « compteur d’entrées » uint16). La charge utile commence à l’octet 13. Les types MBB sont 0xFB en-tête, 0xFD texte, 0x51, 0x52 et 0x53 télémétrie d’état, 0x54 moteur, 0x48 table du chargeur, 0x49 cibles de charge et 0x4F débordement de file. Les types BMS sont 0xFB en-tête, 0xFD texte, 0x4B télémétrie, 0x4D télémétrie étendue et 0x4C détail des cellules. Délimitez par l’octet 1, puis déséchappez le corps délimité. Sur un fichier BMS, rappelez-vous que quatre octets à chaque frontière de page de 128 octets sont un marqueur, pas des données.

Dois-je gérer l’échappement 0xFE ?

Oui, et une version antérieure de cette page n’en parlait pas du tout. L’écriture échappe le délimiteur : FE 4D sur disque se décode en 0xB2 et FE 01 se décode en 0xFE, de sorte qu’un enregistrement bien formé ne contient aucun 0xB2 brut après l’octet 0. Il y a zéro occurrence dans les 1 010 093 octets sur disque de record[2:] sur les 19 342 enregistrements enchaînés par longueur dans les neuf fichiers MBB Gen3 natifs, dont 504 portent un échappement et 518 octets d’échappement se produisent au total (264 FE 4D, 254 FE 01, aucune autre paire). Sur les seuls huit exports d’appli de pleine taille, le même recensement donne 19 089 enregistrements, 994 299 octets, 468 échappés et 477 octets d’échappement. Délimitez d’abord par la longueur déclarée à l’octet 1, puis déséchappez le corps délimité ; l’octet 1 est le seul champ hors de la zone échappée, c’est donc le seul en lequel vous pouvez avoir confiance avant le déséchappement. Faire l’inverse réintroduit 0xB2 au milieu de la charge utile et déchiquette bel et bien le fichier, c’est ainsi que l’échappement a été pris pour le délimiteur qui revient dans les charges utiles. L’ignorer coûte cher : sur le firmware 538XX, conditionner la télémétrie à la longueur sur disque plutôt qu’à la longueur déséchappée écarte 1 796 enregistrements, et la perte est corrélée aux valeurs plutôt qu’aléatoire.

Y a-t-il un compteur kilométrique dans un log MBB Gen3 natif ?

Pas dans l’enregistrement courant, et pas sur tous les firmware. Sur la disposition de firmware récente (celle dont le 0x51 fait 75 octets), les enregistrements plus longs 0x52 et 0x53 portent le compteur kilométrique dans leur queue, en dixièmes de kilomètre ; il est décodé depuis le 2026-09-07, figé pendant une recharge et ne montant que sous RUN, et il est vérifié comme série par fichier avant d’être conservé. L’ancienne disposition, dont le 0x51 fait 71 octets, n’en porte aucun : le mot qui s’y trouve et qui monte régulièrement vers un kilométrage plausible ne le fait que pendant que la moto se recharge, et c’est l’autonomie estimée. Ce que cette page publiait auparavant comme le compteur kilométrique était encore autre chose. record[71:75] était publié ici comme un compteur kilométrique à vie en mètres dont les lectures « fluctuent de dizaines de kilomètres ». C’est une lecture de CAN 12 bits en microvolts et, d’après les preuves, une lecture du rail d’accessoires 12 V ; le réseau est démontré, l’étiquette du rail ne l’est pas. Chacun des 1 121 enregistrements de télémétrie complets de ce corpus satisfait v = 5128k + 4864 (un bit de poids faible de 5,128 mV sur environ 21 V de pleine échelle), et lu en volts, le champ s’étend de 0,143 V à 13,440 V, ce que rapportent les événements texte du firmware pour la batterie d’accessoires dans exactement ces unités. Seuls 51,5 % des échantillons consécutifs sont non décroissants, et aucune fenêtre uint32 de l’enregistrement n’est monotone sauf l’horodatage. Cinq motos sans rapport, de trois familles de modèles et cinq années-modèles, annonçaient toutes des « compteurs kilométriques » dans une fenêtre de 272 km. Le champ a été retiré du décodeur : une moto dont le log n’a aucun enregistrement 0x52 ou 0x53 de disposition récente ne rapporte désormais ni compteur kilométrique ni distance par trajet, plutôt qu’un compteur fabriqué. Un vrai compteur kilométrique existe aussi en Gen2 et sur la variante de firmware 538XX, à un autre décalage dans un autre enregistrement.

Puis-je lire un enregistrement BMS 0x4D avec la carte de champs du 0x4B ?

Non, et cela n’échouera pas bruyamment. Un 0x4D ne partage que l’en-tête de 13 octets, puis insère huit octets : chaque champ de mesure se trouve donc huit octets plus loin ; un 0x4C en insère quatre. En balayant les décalages de 0 à 12 et en testant si les mots de tension de cellule tombent dans une plage plausible de 2 500 à 4 500 mV, un 0x4D obtient zéro aux décalages du 0x4B et 619 sur 666 à +8, et un 0x4C obtient zéro et 75 sur 78 à +4. Zéro est le nombre qui compte : un décodeur doté d’un contrôle de plausibilité des tensions de cellule lit le bloc de remplissage nul, échoue au contrôle et écarte en silence chaque enregistrement étendu. Dans ce projet, cela a représenté 744 enregistrements aux longueurs canoniques. Corriger les décalages en a récupéré 694, soit 42,7 % de télémétrie BMS Gen3 en plus, 84 % des lignes 0x4D tombant dans des intervalles de plus d’une heure de la série standard. Aiguillez sur l’octet de type à record[2] et n’utilisez la longueur déséchappée que comme contre-vérification ; la longueur seule ne distingue pas un 0x4D de 78 octets de n’importe quel autre enregistrement de 78 octets.

Que contient payload[38:41] du BMS ?

La tension de batterie mesurée, sous la forme d’un uint24 petit-boutiste en millivolts. Il a été documenté pendant des années comme un compteur interne d’environ 43 000 à 49 000 qui s’affaissait mystérieusement sous charge. C’était une lecture uint16 des deux octets de poids faible de la vraie valeur à trois octets. Le décodeur l’accepte quand elle tombe entre 28 fois la tension de cellule minimale et 28 fois la tension de cellule maximale du même enregistrement, ce qui est satisfait sur 2 189 des 2 319 lignes de télémétrie que le décodeur en production émet (94,4 %, et de 92,1 % à 96,5 % par fichier), et revient sinon à une estimation par moyenne des cellules à 28 éléments en série. Le chiffre très copié de 1 473 sur 1 557 est le même test sur la population que ce décodeur émettait avant la correction de l’échappement du 2026-07-29.

Que signifie payload[24] du BMS ? Est-ce le code d’état du BMS ?

Non. Une énumération lisant 0x0B repos, 0x0C actif, 0x09 déverrouillage et 0x0A précharge a été publiée, y compris sur ce site, et elle est retirée. Sur les 2 319 lignes de télémétrie que le décodeur en production émet, l’octet prend 37 valeurs distinctes (toutes les valeurs de 0x00 à 0x23 sauf 0x02, plus les sentinelles de flash 0xF0 et 0xFF), et ces quatre codes ne couvrent que 58,6 % des lignes. Ce n’est pas un compteur (82,0 % des écarts consécutifs dans une fenêtre de 120 secondes sont exactement nuls), ce n’est pas une température (r = -0,05 face à l’octet de température du même enregistrement), et il ne partitionne pas les transitions ZERO_BMS_STATE_ des événements texte : reportez-les dans le temps et 0x09 se trouve bien sous UNLOCK sur 62 % des lignes, mais 0x0B, la valeur dite « repos », se trouve indifféremment sous HIBERNATE, IDLE et UNLOCK. Il est bien corrélé de façon lâche au fait que la batterie soit sous charge, mais deux valeurs que l’énumération ne nommait pas, 0x10 à 62,2 % sous charge et 0x0F à 40,7 %, s’intercalent dans ce classement. Le décodeur stocke l’octet tel quel et n’agit dessus nulle part. Traitez-le comme opaque.

L’octet 67 d’un enregistrement BMS Gen3 est-il un nombre de cycles de charge ?

Non. C’est l’octet de poids faible du registre de capacité de pleine charge uint24 petit-boutiste à record[67:70], reflété à record[74:77], qui contient la capacité de la batterie en milliampères-heures, typiquement autour de 124 000 à 145 000 mAh. Lu comme un uint8 isolé, il erre de 0 à 255 sans monotonie. Un décodeur qui l’écrivait dans un champ de cycles de charge a été livré, puis annulé le jour même. Il n’existe aucun champ de cycles de charge connu nulle part dans le format binaire Gen3.

Qu’est-ce que la variante de firmware 538XX ?

Une moto de l’ère Gen2 dont la MBB a été mise à jour par le firmware vers un tampon circulaire flash de style Gen3 d’enregistrements 0xB2 préfixés par leur longueur. Le fichier a un en-tête Gen2 (« MBB » suivi d’un nul au décalage 0, et A1 A1 A1 A1 au décalage 38) mais un corps de style Gen3. Cette page ajoutait auparavant que « aucun chemin ne pouvait le lire » ; c’est faux. Son enregistrement 0x2c est l’enregistrement Riding Status ordinaire du zero-log-parser amont, traité depuis 2015, et la version amont que ce site épingle lit ces fichiers. Ce qui a échoué est l’aiguillage à l’intérieur de ce projet : le chargeur Gen3 natif n’a besoin que de l’ASCII « MBB » et de dix octets 0xB2, tous deux vrais ici, si bien qu’un décodage Gen2 qui fonctionnait a été écarté. Les enregistrements font exactement 40 octets et portent la tension de la batterie sous forme d’entier uint32 exact en millivolts, le courant de batterie et du moteur, cinq températures, le SOC, le régime du moteur et un compteur kilométrique, mais aucune vitesse sur route. La détection exécute le décodage et ne l’adopte que si au moins 10 entrées de changement d’état et 50 entrées de télémétrie en sortent, parce que les vrais fichiers Gen2 partagent la signature d’en-tête et écrivent le même enregistrement.

Combien d’enregistrements contient un log Gen3, et qu’est-ce qui les remplit ?

Entre 2 238 et 2 535 enregistrements délimités par fichier MBB de 131 200 octets, et 2 038 à 2 327 par fichier BMS de 131 328 octets, mesurés respectivement sur huit et sept fichiers et délimités en enchaînant la longueur déclarée. Les événements texte dominent dans les deux : 86,7 % des enregistrements MBB (16 553 sur 19 089) et 82,9 % des enregistrements BMS (13 178 sur 15 890). Comptez les mêmes fichiers BMS en découpant plutôt sur l’intervalle entre délimiteurs et vous obtenez 15 998 enregistrements à 82,4 % de texte, la paire que publie la page sur le tampon circulaire ; nommer la convention évite que les deux se lisent comme une contradiction. Sur la MBB, le remplissage est le cycle de réveil de l’hibernation, qui écrit une médiane de 31 enregistrements (27 texte, 2 télémétrie, 2 secondaires) en une rafale de 91 secondes, qui se répète sur une période de 60 minutes annoncée dans le log par « Saving Stats, Hibernating for 3600 sec ».

Un log Gen3 peut-il m’indiquer l’état de santé de la batterie ?

De façon indirecte. Aucun champ explicite d’état de santé n’existe dans aucune génération du format. La Gen3 stocke bien un registre de capacité de pleine charge dans ses enregistrements 0x4D, qui est à une division par la capacité nominale de conception d’un pourcentage, mais il est actuellement extrait et stocké plutôt que consommé. Ce qui est livré aujourd’hui est une estimation par session : l’énergie divisée par la fraction de SOC déplacée, par module, moyennée sur les cinq dernières sessions qualifiantes, ce qui exige une variation de SOC d’au moins 15 % pour produire la moindre estimation.

Que signifie la séquence d’octets 00 F0 FF 00 dans un fichier BMS Gen3 ?

C’est le marqueur de page flash, qui n’est ni une corruption aléatoire ni un séparateur. Dans chaque fichier de batterie Gen3 natif mesuré, il se trouve au décalage de fichier 128·k pour k = 1 à 1 025, 1 025 fois par fichier, et dans aucun fichier de carte principale. Il est écrit sur quatre octets de l’enregistrement qui occupait cette position : ces quatre octets ont donc disparu ; un décodeur doit localiser le marqueur par son décalage de fichier et retenir les champs qu’il couvre, et ne doit jamais le retirer, parce que rien n’a été inséré. Une version antérieure de cette réponse disait que le marqueur faisait trois octets, F0 FF 00, qu’il commençait au décalage 129 et qu’on pouvait le retirer avant la délimitation ; ces trois affirmations étaient fausses. Compter les marqueurs reste un contrôle d’intégrité peu coûteux : un export BMS Gen3 natif en porte exactement 1 025.

Pourquoi certains logs de batterie Gen3 montrent-ils de l’activité à une date que d’autres motos partagent à la seconde près ?

Parce que le marqueur de page flash l’a falsifiée. Quand le marqueur tombe sur l’octet de type d’un enregistrement, il écrase les trois octets de poids faible de l’horodatage par F0 FF 00 et ne laisse que l’octet de poids fort : chaque enregistrement touché ainsi dans les mêmes 194 jours se décode donc à une seule seconde, quelle que soit la moto qui l’a écrit : 0x6900FFF0 est 2025-10-28 17:40:00 UTC et 0x6A00FFF0 est 2026-05-10 22:00:16 UTC. Dans ce corpus, 2025-10-28 17:40:00 apparaît sur 95 enregistrements de cinq motos différentes ; sur le corpus de production, un jour falsifié était apparu sur 57 motos et un autre sur 38. Depuis la version 3.37.0, ces horodatages sont retenus, les lignes restent sans date, et les jours et trajets sur la seule batterie bâtis dessus ont disparu.

Zero-log-parser décode-t-il les logs Gen3 ?

Cela dépend de la version, et ce site ne s’en sert de toute façon pour aucun de ses décodages Gen3. La version que ce site épinglait auparavant pour la Gen1 et la Gen2, le commit 87c6e757 de février 2026, imprime l’en-tête d’un fichier Gen3 comme vide ou « Unknown ». La version qu’il épingle maintenant, 90c8cb2 du 29 septembre 2026, a beaucoup progressé : elle lit l’en-tête de la carte principale Gen3, la télémétrie de la batterie, les enregistrements du chargeur, de file pleine et de build du firmware et parcourt les pages flash du fichier de batterie ; là où elle et le décodeur de ce site décodent un même enregistrement, ils concordent : 2 866 sur 2 866 lectures de cellule sur les 18 fichiers Gen3 natifs d’ici. Ce qu’elle ne décode pas encore, ce sont les enregistrements texte, la plus grande classe d’un fichier Gen3 : son décodeur de messages lit le préfixe de six octets de l’enregistrement comme la chaîne.

Crédit : le projet amont zero-log-parser

Tout ce qui figure sur cette page repose sur zero-motorcycle-community/zero-log-parser, le projet open source qui a le premier documenté le format des logs Zero. Nous l’utilisons directement pour l’analyse Gen1 et Gen2, et son LOG_STRUCTURE.md reste la référence communautaire pour ces générations. Les cartes d’enregistrements Gen3 ci-dessus sont les nôtres seulement parce que ce projet a rendu le problème lisible dès le départ.

La prise en charge Gen3 était suivie dans le ticket n° 16, ouvert du 21 février 2020 au 8 février 2026. L’évaluation du mainteneur mérite d’être citée en entier, parce qu’elle est parfaitement juste et que c’est la raison d’être de cette page :

« Zero has a new format for SR/F logs which only roughly matches the existing formats, so the parser will almost need to be written from scratch… we have no copies of officially decoded logs to emulate. »

Il n’existe toujours ni spécification officielle ni sortie décodée de référence. Chaque décalage d’ici a été retrouvé par la mesure, et les corrections faites sur de vrais fichiers sont bienvenues.

Chaque décalage d’octet publié ici a été mesuré sur de vrais fichiers plutôt que lu dans un décodeur. Les chiffres de répartition des enregistrements et de remplissage des champs viennent de huit exports d’appli MBB Gen3 natifs de pleine taille et de sept exports BMS Gen3 couvrant cinq motos distinctes (SR/F, SR/S, DSR/X). Un neuvième fichier MBB natif existe (un tronçon tronqué de 16 384 octets provenant d’une sixième moto, que le pipeline décode bien comme du Gen3) ; il est inclus dans le recensement des échappements, dans les populations d’états 0x51 et dans les chiffres de délimitation, mais exclu des parts de répartition des enregistrements ; chaque nombre de cette page dit auquel des deux il appartient. Les chiffres de délimitation, d’échappement et 538XX viennent du corpus complet de 352 fichiers, dont 135 partagent la signature d’en-tête 538XX et 14 passent sa barrière de rendement. Les mesures ont été prises le 2026-07-30. Là où le décodeur et les octets divergeaient, les octets ont eu raison : cinq affirmations publiées auparavant sur cette page ont été retirées en conséquence, et chaque retrait est laissé en place avec la mesure qui l’a tué plutôt que d’être supprimé en silence.

Ceci est une spécification indépendante, tenue par la communauté et produite par rétro-ingénierie. Elle n’est ni publiée, ni approuvée, ni relue par Zero Motorcycles, et aucune partie ne doit être prise pour une description officielle du format. Les dispositions d’enregistrement changent avec le firmware (une moto de ce corpus a changé la taille de son enregistrement de télémétrie entre deux exports) : vérifiez donc sur vos propres fichiers avant de vous fier à un décalage d’ici.