El formato de log Gen3 de Zero, registro a registro
Especificación byte a byte del log de diagnosis Gen3 (Cypher III / FST): cómo se enmarcan y se desescapan los registros 0xB2, qué significa cada campo decodificado en las placas MBB y BMS, dónde la variante de firmware 538XX rompe las reglas y qué bytes siguen sin conocerse. Cada desplazamiento de esta página se volvió a medir contra 352 archivos de log reales, y cinco afirmaciones que la página había publicado se retiran aquí mismo, sin borrarlas. Cada recuento de registros nombra el convenio de entramado y el número de archivos del que salió, porque sin eso un recuento no se reproduce. La decodificación Gen3 también se contrasta registro a registro con el parser de la comunidad, y donde los dos difieren la página dice por qué.
TL;DR
- Quien escribe escapa el delimitador. FE 4D en disco se decodifica como 0xB2 y FE 01 como 0xFE, así que un registro bien formado no lleva un 0xB2 en crudo después del byte 0. No hay ninguna aparición en los 1.010.093 bytes de payload en disco (record[2:]) de los 19.342 registros encadenados por la longitud declarada, de los nueve archivos MBB Gen3 nativos de este corpus. Entra primero por la longitud declarada y después desescapa el cuerpo ya enmarcado. Al revés se destroza el entramado, y así el escape se tomó por «el 0xB2 se repite dentro del payload».
- Un log MBB Gen3 nativo sí lleva tensión del pack y corriente de la batería, en record[34:38] y record[38:42], más la tensión y la corriente del bus de continua del propio controlador y las rpm del motor. Todo está relleno en 144 de 144 registros RUN y en ninguno de 417 registros HIB, porque caen a cero con el bus de alta tensión. El decodificador publicado los lee desde el 2026-09-07, y solo con el bus en vivo. Están vacíos en los estados que cubren unos tres cuartos de un log real, así que el BMS sigue siendo la mejor fuente eléctrica.
- No hay cuentakilómetros en un registro 0x51. Publicamos record[71:75] como si lo fuera; es una lectura de ADC de 12 bits en microvoltios y, por el peso de la prueba, una lectura del raíl de 12 V de accesorios: cada valor del corpus cumple v = 5128k + 4864, entre 0,143 V y 13,440 V, y solo el 51,5 % de las muestras consecutivas no decrece. El cuentakilómetros existe, pero vive en otro sitio: en la cola de los registros más largos 0x52 y 0x53, solo en el diseño de firmware más nuevo, donde se queda quieto durante una recarga y solo sube en RUN. Di de qué registro habla un resultado negativo.
- Todos los registros Gen3 comparten una cabecera de 13 bytes: 0xB2 | longitud | tipo | marca de tiempo uint32 LE | microsegundos uint32 LE | secuencia uint8 | desplazamiento UTC int8. Los bytes 11 y 12 se publicaron aquí como un solo uint16 «contador de entradas». Son dos campos: el byte 11 avanza de uno en uno en cada registro y vuelve a cero cuando la placa despierta, y el byte 12 es el ajuste de huso de la moto en horas (−7 en una moto de EE. UU., +1 y +2 en Europa). No se movió en ninguno de los 11 saltos del byte 11 de este corpus. La marca de tiempo ya está en UTC; el byte 12 solo dice lo que mostraba el cuadro.
- Los tipos MBB son 0xFB (cabecera: VIN, modelo, año de modelo, revisiones de placa y de firmware, compilación de firmware), 0xFD (texto, el grueso), 0x51 / 0x52 / 0x53 (telemetría de estado en tres tamaños), 0x54 (motor: par en el eje, corriente de motor, tensión del bus de continua), 0x48 (un registro de 49 bytes por cada cargador que respondió: nombre, voltios, amperios y hercios de red, salida de continua, id CAN y serie), 0x49 (techo y objetivo de recarga) y 0x4F (una cola de firmware que se desbordó, casi siempre una cola CAN). Todos están decodificados. Las longitudes van con el firmware: la misma SR/F escribió registros 0x51 de 71 bytes en 2023 y de 75 bytes en 2026.
- Los tipos BMS son 0xFB (cabecera), 0xFD (texto), 0x4B (52 B, la fuente principal de telemetría), 0x4D (78 B, ampliado) y 0x4C (70 B, detalle de celdas). 0x4D y 0x4C no son un 0x4B con sufijo: insertan 8 y 4 bytes tras la cabecera común de 13 bytes, así que cada campo medido se desplaza. Leerlos con los desplazamientos del 0x4B da tensiones de celda verosímiles en exactamente cero registros.
- Cada página de 128 bytes de un archivo BMS Gen3, a partir de la segunda, abre con 00 F0 FF 00, escrito ENCIMA de cuatro bytes de datos del registro. Lo que había ahí ya no está: antes de que el decodificador lo aprendiera, 699 de las 2.894 filas de telemetría que emitía desde ocho archivos BMS leían al menos un campo a través de un marcador, y en 268 de ellas ese campo era una marca de tiempo que aún parecía verosímil, a una mediana de 22 días de sus vecinas. Los valores bajo un marcador ahora se retienen, y los 612 registros cuyo 0xB2 siguiente destruyó el marcador se reencuadran a su longitud declarada en vez de perderse. Un marcador sobre el byte de tipo deja una marca de tiempo 0xHH00FFF0, el mismo segundo para todas las motos en un tramo de 194 días. Por eso el 2025-10-28 17:40:00 UTC apareció en motos que no tienen nada que ver. En el corpus de producción de 1.220 archivos, la corrección quitó 290 días de archivo falsos y 228 recorridos solo de batería.
- El texto del BMS empieza en el byte 13 del registro, justo después de la cabecera. El decodificador tomaba en su lugar «el primer byte imprimible después del byte 7», que en una moto en UTC+0 empezaba en el byte de secuencia y paraba en el cero del byte de desplazamiento: se perdía el 53,5 % de los eventos de texto del BMS y el 14 % salía como basura. Corregido en 2026-10, más que duplica los eventos de la máquina de estados del BMS que da un archivo Gen3 nativo.
- BMS payload[38:41] es una tensión de pack medida, uint24 LE en milivoltios, no el «contador interno» con el que se archivó durante años. Cumple el sobre de aceptación de la serie 28 en 2.189 de las 2.319 filas de telemetría que emite el decodificador publicado desde siete archivos BMS (94,4 %, y del 92,1 % al 96,5 % por archivo).
- BMS payload[24] NO es un código de estado. El enum 0x0B reposo / 0x0C activo / 0x09 desbloqueo / 0x0A precarga se retira: el byte toma 37 valores distintos, esos cuatro cubren el 58,6 % de las filas, y no pasa una prueba de contador, una de temperatura ni una de estado en el texto. Se guarda tal cual y no se decodifica en ningún sitio.
- El byte 67 del registro NO es un recuento de ciclos de carga. Es el byte bajo del registro de capacidad a plena carga, uint24 LE, en record[67:70]. Un decodificador que lo leyó como recuento de ciclos llegó a publicarse y se revirtió el mismo día.
- Contrastado registro a registro con la rama principal del parser de la comunidad (90c8cb2), alineado por desplazamiento en el archivo y no por tiempo, sobre los 18 archivos Gen3 nativos de aquí: coinciden las 2.866 lecturas de celda, los 1.727 estados del vehículo, los 119 registros de cargador y los 18 informes de cola. Cada diferencia de corriente y de tensión del pack es una palabra que un lado rechaza por flash borrada o fuera de sobre, y upstream no decodifica ninguno de los 33.460 registros de texto.
- La variante MBB de firmware 538XX es una trampa de enrutado. Sus registros 0x2c son el Riding Status normal de upstream zero-log-parser, decodificado desde 2015. Llevan la tensión del pack como entero exacto uint32 en milivoltios, la corriente de la batería, las RPM y cinco temperaturas. No llevan velocidad en carretera, y la calibración ajustada que publicamos para ellos se retira.
En esta página
La MBB Gen3 trae poca telemetría eléctrica
La frase con la que abría esta sección era demasiado fuerte. Una versión anterior de esta página decía que una MBB Gen3 nativa «no contiene tensión del pack, ni corriente de batería, ni velocidad en carretera que consuma ningún decodificador». Era cierto al pie de la letra y llevaba a engaño, porque el matiz sostenía toda la afirmación: los bytes estaban y nadie los leía.
En una moto Gen3 nativa (la plataforma Cypher III / FST, es decir los archivos SR/F, SR/S y DSR/X de los que sale este corpus), la placa principal escribe la tensión del pack como uint32 little-endian en milivoltios en record[34:38] y la corriente de la batería como int32 con signo en miliamperios en record[38:42], y las dos están rellenas exactamente cuando el sistema de alta tensión está vivo: distintas de cero en 144 de 144 registros RUN, 5 de 5 REV, 4 de 4 PARK, y en ninguno de 417 HIB, ninguno de 408 PWSU y ninguno de 51 WAIT. Como la hibernación y el arranque juntos son el 75 % de los registros 0x51 de un log real, en la práctica el campo suele estar vacío. El decodificador publicado lo extrae desde el 2026-09-07, y solo de un registro cuyo bus está vivo: un cero aquí significa «el sistema de alta tensión estaba caído», no «se midieron cero voltios», y publicarlo como lectura pondría una medida en un gráfico de una moto dormida en un garaje. Así que el BMS sigue siendo la fuente en la que te conviene apoyarte, porque los campos de la MBB, aunque existen, son escasos.
La mezcla de registros es lo que hace concreta la forma del archivo. En ocho archivos MBB Gen3 nativos de cinco motos distintas (131.200 bytes cada uno, 19.089 registros con entramado por cadena de longitud), 16.553 registros (86,7 %) son eventos de texto ASCII, 1.311 (6,9 %) son instantáneas de telemetría 0x51, 1.061 (5,6 %) son secundarios 0x54, 67 (0,35 %) son registros ampliados 0x52 y 8 son cabeceras de archivo. Un log MBB Gen3 es, de lejos, un log de texto con una espina binaria fina. El lado BMS se parece en la forma, pero su espina binaria está muy poblada: los siete volcados BMS suman 15.890 registros, de los cuales 13.178 (82,9 %) son texto, 1.803 (11,4 %) llevan el byte de tipo de telemetría 0x4B, 691 (4,4 %) el tipo ampliado 0x4D y 84 el 0x4C. Cada recuento de esta página sale ahora del entramado por cadena de longitud, con el escape respetado, y por eso quedan un poco por encima de las cifras por corte de hueco que citaba una versión anterior: el entramado por cadena recupera unos 250 registros más en los mismos ocho archivos MBB.
La prueba de record[34:38] es un filtro de población y una curva física. El filtro está arriba y no tiene excepciones. La curva es mejor: en un archivo de 2021 (el recorte truncado de 16 kB, el noveno archivo MBB nativo de este corpus y el que queda fuera de la población de ocho volcados que usan las cifras de mezcla), 32 registros CHRG consecutivos muestran el campo subiendo de forma monótona de 102,081 V a 114,075 V a lo largo de 5,51 horas, mientras record[38:42] se mantiene entre −11,6 A y −15,3 A y el SOC sube de 41 a 100. En los últimos seis registros el SOC está clavado en 100 y la tensión sigue subiendo de 111,8 V a 114,1 V. Eso es una fase de absorción a tensión constante. Ningún campo de relleno ni ninguna tabla de consulta del SOC la produce. Integrar V·I sobre ΔSOC da unos 13,6 kWh en ese archivo y unos 12,4 kWh en uno de 2023, frente a un pack ZF14.4 que son 14,4 kWh nominales y 12,6 kWh útiles. La integración por rectángulo a la izquierda da 13,55 y 12,41, y la trapezoidal 13,58 y 12,40, así que el resultado se cita con tres cifras significativas y no se mueve con la regla de integración. Una cautela sobre las poblaciones: esos registros CHRG viven en la variante 0x51 de 71 bytes, y por eso la tabla de estados más abajo, contada sobre los registros de 75 bytes, muestra solo siete filas CHRG.
La salvedad de alcance es grave, y es la razón de no dar esto por cerrado. Todos los puntos dinámicos de arriba salen de un VIN con prefijo 538ZF, la plataforma SR/F de 2020 a 2023. La única moto PAG-WMI de verdad en este corpus, una DSR/X, aporta 278 registros 0x51 en dos archivos, con 16 y 2 de ellos rellenos, un registro RUN y ningún registro CHRG. Aquí no se puede correr ni una prueba de conservación sobre hardware PAG. La alternativa que queda, que el diseño es común pero el firmware de la época DSR/X solo lo rellena en estados que este corpus apenas contiene, no queda excluida.
Otra palabra en record[21:25] mide el mismo bus con peor resolución. Es un segundo instrumento, la tensión del bus de continua del propio controlador del motor, en pasos de 100 mV, junto a la tensión de pack que viene del BMS en record[34:38], en pasos de 1 mV. El argumento de «el mismo bus» es una cuenta, no una estadística. Es múltiplo de 100 mV en 281 de 281 lecturas distintas de cero, donde record[34:38] es múltiplo de 100 en 2 de 302; en los 247 registros en los que las dos están rellenas, quedan a una mediana de 0,163 V; y vale cero en los 54 registros CHRG, mientras record[34:38] está relleno en 47 de ellos. Quédate con record[34:38]. Una versión anterior de esta página defendía record[21:25] por una correlación de Pearson contra la tensión de pack del BMS; ese argumento se retira. Repetido sobre un par MBB y BMS de una SR/F de 2025-12, uniendo 129 registros RUN con una fila BMS en menos de 60 segundos, siete ventanas uint32 del registro dan |r| ≥ 0,90, y la más fuerte es la ventana del desplazamiento 30, con 0,925, por delante de record[21:25] con 0,907. La correlación no identifica un desplazamiento, y tratarla como si lo hiciera es el error que puso un raíl de 12 V en esta página como cuentakilómetros.
record[25:29] y record[29:33] son la corriente del bus de continua del controlador, un int32 con signo en miliamperios, y las rpm del motor, un int32 con signo. Las dos se resolvieron el 2026-09-07 y se decodifican desde entonces, con el bus en vivo, igual que las tensiones. Esta página decía antes que ninguna de las dos se resolvía, y no podía porque un registro 0x51 nativo no trae una referencia de velocidad independiente. Los registros más largos 0x52 y 0x53 sí: traen una velocidad en carretera en la cola, y dividirla por las rpm del mismo registro da una constante en todo el recorrido: 0,0252 km/h por rpm en cada fila del diseño antiguo y 0,0266 en la moto del diseño nuevo. Esa constante es la desmultiplicación, y un campo que no son rpm no la deja fija. La corriente del bus de continua sigue sin una correlación útil con la corriente de pack del BMS en ninguna tolerancia de unión que se haya probado (|r| ≤ 0,16), porque las dos placas no muestrean a la vez; se publica como la lectura del controlador y nada más.
backend/app/parser.py escribe en el objeto de la entrada, no lo que codifica el firmware. La distinción es decisiva en varias filas. La tensión y la corriente del pack del MBB Gen3 nativo estuvieron marcadas como bytes presentes, nada los lee hasta octubre de 2026: están en record[34:38] y record[38:42], distintos de cero en 144/144 registros RUN y 0/417 registros HIB, y se decodifican desde el 2026-09-07. Son parciales porque un cero ahí significa que el bus está caído, no cero voltios. El cuentakilómetros es parcial por otra razón: no hay ninguno en el 0x51 de 75 bytes, y el de la cola de los 0x52/0x53 más largos existe solo en el formato de firmware más nuevo. El campo que aquí se publicó como tal hasta el 2026-07-29, record[71:75], es una tensión analógica cuantizada por ADC: cada uno de los 1.121 registros 0x51 completos de 75 bytes cumple v = 5.128k + 4.864 µV, y baja en tantas muestras consecutivas como sube (51,5 % no decreciente), lo que ningún cuentakilómetros hace. Eso está demostrado. Leerlo en concreto como la línea de accesorios de 12 V no: es una identificación a posteriori, de alta confianza porque los propios eventos de texto del firmware citan las líneas del DC-DC y de la batería en justo esas unidades y esa banda, pero no verificada con una medición. La fila se etiqueta con ese criterio y el valor se guarda sin procesar, en microvoltios, con un nombre que no puede confundirse con una distancia. Parcial también abarca valores que no son un canal por muestra: la temperatura del motor del MBB Gen3 nativo es post_1 y vale cero siempre que el motor no gira, mientras que la ambiente es post_0 (las cinco palabras de estado posterior estuvieron etiquetadas un hueco desplazadas hasta el 2026-09-07, cuando post_2 se guardaba como temperatura del motor; es el inversor), y los mV de celda del MBB Gen2 aparecen solo como min_cell_mv en los eventos de límite de descarga. Esas temperaturas no son cero fuera de WAKE, STOP y CHRG, como también decía este pie hasta el 2026-07-29. En los nueve archivos MBB Gen3 nativos, encuadrados por cadena de longitudes: RUN rellena los cuatro campos de temperatura de estado posterior en 144/144 de los registros 0x51 completos de 75 bytes, más 57/57 registros 0x52 y 31/31 0x53 que también están en RUN. El aparcamiento los pone casi siempre a cero, pero no del todo: HIB lleva post_1/post_2 en el 4,8 % de los registros (20/417) y PWSU lleva post_3/post_4 en el 8,3 % (34/408), y ninguno lleva nunca el conjunto completo. Los denominadores 141/408/403 que se publicaron aquí hasta el 2026-07-30 no corresponden a ningún encuadre que este decodificador haya usado. La columna 538XX pierde su marca de velocidad: ese canal se derivaba de las rpm mediante una constante ajustada y se ha retirado. Los informes decodificados por esa ruta se guardan como log_generation = 3, así que «Gen3» en la base de datos es un conjunto mayor que «Gen3 nativo» aquí.Una excepción documentada
La variante MBB de firmware 538XX sí lleva tensión del pack, corriente de batería, corriente de motor y cinco temperaturas en un registro que lee el decodificador publicado. Es una moto de la época Gen2 cuya MBB se actualizó a un búfer circular al estilo Gen3, y los informes decodificados por esa ruta se guardan con log_generation = 3. «Gen3» en una base de datos no es el mismo conjunto que «Gen3 nativo» en este documento. No lleva velocidad en carretera (mira la retirada en esa sección).
Entramado: una forma de registro, un delimitador y un escape de relleno
Cada registro Gen3 (MBB, BMS y la variante 538XX por igual) empieza con la misma cabecera. El byte 0 es el delimitador 0xB2. El byte 1 es la longitud total del registro en disco, en bytes, con el delimitador y con cualquier byte de escape. El byte 2 es el tipo de registro. Los bytes 3 a 6 son una marca de tiempo Unix como uint32 little-endian, los bytes 7 a 10 son la parte subsegundo en microsegundos, el byte 11 es un contador de secuencia que avanza de uno en uno en cada registro de cualquier tipo, módulo 256, y el byte 12 es el ajuste de desplazamiento UTC de la moto en horas enteras, como byte con signo. El payload sigue desde el byte 13 y su lectura depende por completo del byte de tipo.
Los bytes 11 y 12 son dos campos, un número de secuencia y el ajuste de desplazamiento UTC de la moto, y esta página los publicaba como un solo contador de 16 bits. La sección siguiente mapea los 13 bytes de cabecera, con lo que significa cada valor y lo que el byte de secuencia revela de un archivo.
0xB2 es un byte de datos normal, así que quien escribe lo escapa. Una versión anterior de esta especificación no mencionaba el escape en ningún sitio. La secuencia de dos bytes FE 4D en disco se decodifica como 0xB2, y FE 01 como 0xFE. Por tanto un registro bien formado no contiene un 0xB2 en crudo en ningún punto después del byte 0. Medido, no hay ninguna aparición en los 1.010.093 bytes EN DISCO de record[2:] (el registro entero menos el delimitador y el byte de longitud) a lo largo de los 19.342 registros encadenados por longitud de los nueve archivos MBB Gen3 nativos de este corpus, y ninguna en los registros BMS Gen3 nativos. «En disco» carga con el sentido: desescapa esos mismos registros y contienen 264 bytes 0xB2 en crudo, que es todo el sentido del escape. El censo sobre la misma población de nueve archivos: 504 registros llevan al menos un escape, hay 518 bytes de escape en total, que se decodifican como 264 × FE 4D → 0xB2 y 254 × FE 01 → 0xFE, sin ningún par FE xx anómalo. Solo en los ocho volcados de app a tamaño completo (la población que usa cada figura de mezcla de registros de esta página), el mismo censo lee 19.089 registros, 994.299 bytes de payload en disco, 468 registros escapados y 477 bytes de escape. Cita uno u otro censo con su población nombrada. La ausencia de un 0xB2 en crudo es la garantía para la que existe el relleno de bytes.
El orden importa, y hacerlo al revés es lo que produjo el diagnóstico equivocado que esta página publicaba. Entra primero por la longitud declarada y después desescapa el cuerpo ya enmarcado. El byte 1 es el único campo que queda fuera de la región escapada, así que es el único campo en el que puedes confiar antes de desescapar: el byte de tipo, la marca de tiempo y cada desplazamiento del payload se mueven cuando un escape cae delante. Desescapar el búfer entero y luego cortar por 0xB2 sí destroza el archivo, porque desescapar vuelve a meter bytes 0xB2 en mitad del payload. Eso es un argumento sobre el orden, no una prueba de que el delimitador se repita.
Tres decodificadores de este proyecto enmarcan de forma distinta, por historia del código y no porque convenga. Solo la ruta MBB Gen3 nativa encadena por la longitud declarada: lee el byte 1, avanza esa cantidad y se resincroniza al siguiente 0xB2 si la cadena se rompe. En el corpus MBB nativo de nueve archivos eso da 19.342 registros a partir de 19.351 delimitadores, con 17 resincronizaciones. Son unas dos roturas estructurales por archivo, las dos esperables: la cabecera de archivo de 128 bytes, cuyos 117 bytes declarados no llegan al cuerpo, y el registro rasgado en el pliegue del búfer circular. La ruta BMS Gen3 sigue cortando por el hueco del delimitador y luego desescapando cada trozo, salvo donde un marcador de página flash ha sobrescrito el 0xB2 del registro siguiente; ahí recorta el hueco a la longitud declarada (mira la sección del marcador de página). La ruta 538XX no hace ninguna de las dos: recorre byte a byte, desescapa cada candidato, lo acepta por la puerta de la marca de tiempo y luego avanza un byte en vez de la longitud del registro, así que evalúa candidatos solapados y deja que las guardas por tipo los absorban. Lo que se cuenta en esa ruta es un recuento por candidato, no un recuento de registros enmarcados, y esta página lo dice cada vez que cita uno. Los tres bastan en este corpus; la cadena es la que hay que implementar, porque aguanta un corte y las otras dos no.
La aritmética de la longitud es la prueba más limpia de que el escape es universal. Resta el número de bytes de escape a la longitud declarada y cada tipo de registro cae en un solo valor canónico, sin excepción: el 0x51 MBB nativo cae en 71 o 75, el 0x54 en 29, el 0x48 en 62, el 0x49 en 38; el BMS 0x4B en 52, el 0x4C en 70, el 0x4D en 78; y en la variante 538XX, el 0x2c cae en exactamente 40 en 19.516 de 19.516 registros cuyas longitudes en disco se reparten en 40 (17.720 de ellos), 41 (1.688) y 42 (108). Esa es una población de barrido byte a byte sobre los 14 archivos adoptados, así que son candidatos y no registros encadenados. Otros dos oráculos que no tocan el byte de longitud coinciden: el byte de secuencia en record[11] se recupera al desescapar en 360 de 360 registros donde un escape va delante y sus dos vecinos lo clavan a un solo valor (bytes en crudo: 9 de 360, sobre los diez archivos MBB Gen3 nativos de este corpus a fecha de 2026-10), y la marca de tiempo cae dentro del intervalo de sus vecinos en 19 de 19 (en crudo: 0 de 19).
Solo aparecen esas dos secuencias, así que la transformada general queda indeterminada. Upstream zero-log-parser implementa FE xx como 0xFE XOR (xx − 1); el xx XOR 0xFF, más simple, es idéntico para cada xx impar, y los dos sucesores observados son impares. Implementa los dos mapeos probados y trata cualquier otro par FE xx como una anomalía que hay que contar y mostrar, no transformar. Cuántos hay depende de qué decodificador recorrió los bytes, así que nómbralo: por los tres entramadores publicados, este corpus de 352 archivos da 17 en total: 12 en los 135 archivos de firma 538XX bajo el barrido byte a byte, 5 (todos FE 00) en los siete archivos BMS Gen3 nativos, y ninguno en los nueve archivos MBB Gen3 nativos. Los 12 tienen sucesores 0x27 tres veces, 0x64, 0xC1 y 0x00 dos veces cada uno, y 0x0F, 0xC2 y 0x84 una vez. Una cifra rival de 13 también es cierta y es otra población: es lo que cuenta el decodificador del navegador en su ruta de producción, y se descompone en 5 en archivos BMS, 8 en archivos MBB Gen2 que el clasificador manda al entramador por cadena de longitud, y cero en los 14 archivos 538XX de verdad. BinaryTools.unescape_block de upstream lo tiene implementado para Gen2 desde el principio, así que un decodificador montado sobre esa biblioteca no necesita un caso especial Gen3.
Ignorar el escape cuesta registros enteros. En el firmware 538XX la puerta vieja comparaba la longitud en disco con 40, lo que descarta por construcción cada registro de telemetría escapado: 1.796 registros en el corpus. La pérdida va correlacionada con el valor, porque un registro se vuelve irrepresentable justo cuando uno de sus bytes decodificados da la casualidad de valer 0xB2 o 0xFE. Tramos enteros de moto parada desaparecen de golpe en vez de adelgazarse. En el lado MBB Gen3 nativo, 504 de los 19.342 registros del censo de nueve archivos llevan un escape, y 291 de ellos se decodifican a otra fecha cuando se respeta, porque el escape cae dentro o delante del campo de marca de tiempo.
B2 · tamaño · tipo · marca de tiempo uint32 LE · microsegundos uint32 LE · secuencia uint8 · desfase UTC int8. Los dos últimos se dibujaron aquí como un único «contador» uint16 hasta octubre de 2026, y el byte 12 es el ajuste de zona horaria de la moto, no el byte alto de un contador. Las tiras de abajo son un registro 0x51 real, literal, de un volcado de una SR/S de 2021 (el resto truncado de 16 kB, que es el noveno archivo nativo del MBB Gen3 y queda fuera del censo de ocho volcados de app que usan los recuentos agrupados de esta página), con un par de escape FE 4D dentro de su campo de marca de tiempo. El orden importa: encuadra por la longitud declarada en disco y después desescapa lo que encuadraste. Si lo haces al revés, el 0xB2 recuperado se convierte en un delimitador en medio de tu propio registro. En los 14 volcados 538XX adoptados de logs/ hay 96.727 bytes 0xB2; recorriendo la cadena de longitudes y resincronizando en cada corte del búfer circular, 96.632 de ellos (99,90 %) son inicios de registro genuinos, 61 caen dentro de un registro encuadrado y 34 no se encuadran nunca. Si «interior» pasa a significar dentro de un registro cuya longitud declarada cae exactamente en el siguiente inicio de registro, la cifra baja a 2, porque el escritor escapa el resto. zero-log-parser LOG_STRUCTURE.md documenta el mismo escape para Gen2, y su BinaryTools.unescape_block lo implementa.0xB2 poblado en el binario» significa, en el código, solo esto: los bytes ASCII MBB en algún punto de los primeros 32 bytes, más al menos diez bytes 0xB2 en cualquier parte del archivo. Un archivo 538XX cumple las dos cosas de sobra (su cabecera es MBB\0), así que el flujo registra «Gen3 detected from binary structure» y nunca toma la ruta JSON Gen2 de upstream. Esa anulación, y no ninguna laguna del formato, es lo que mandó nueve de los catorce archivos 538XX de logs/ a cero recorridos. El zero-log-parser de upstream decodifica sus registros de estado de marcha 0x2c desde 2015, y tal como lo ejecutó este sitio en julio de 2026 leyó uno de esos archivos como 7.629 entradas, incluidas 2.048 filas Riding estructuradas. Una versión anterior de este pie decía que los dos desvíos erróneos «producen una salida vacía» y que en la ruta Gen2 upstream decodifica cada registro como una fila «Board Status» en blanco; la segunda mitad es falsa. Por eso la sonda 538XX se ejecuta antes de la decisión de encaminamiento, para adelantarse a la anulación. Los archivos MBB Gen2 genuinos comparten la firma MBB\0 + A1 A1 A1 A1 y escriben el mismo registro 0x2c de 40 bytes, así que ni la firma ni el tipo de registro discriminan. Solo lo hace la puerta de resultado, y lo hace contando una población anterior al desescape que es en sí misma un artefacto de un error ya corregido. En los 135 archivos con firma de logs/, esa puerta adopta 14, mantiene 30 en la ruta Gen2 y rechaza 91. Los 30 mantenidos son la razón de que el contador no se haya cambiado por el posterior al desescape: ahora decodifican de 425 a 2.408 entradas de telemetría cada uno mientras puntúan de 0 a 8 en wire-exact, y es solo ese número lo que los mantiene en una ruta Gen2 donde su decodificación upstream (con la versión que fija este sitio) es completa y correcta. Fíjate también en que el propio docstring de _is_538xx_mbb_variant dice que «must only be consulted INSIDE the firmware-format fallback»; el código de encaminamiento la llama sin condiciones para los archivos MBB, y lo que se ejecuta es el código. Desde el 2026-10-03 la última caja tiene una puerta delante: ninguna de sus señales encamina un MBB al decodificador nativo salvo que los registros lleven la cabecera de registro FST (gen3_mbb_fst_layout). Treinta y siete archivos distintos con contenedor Gen2 de logs/ habían sido enviados allí por la anulación o por la rama de VIN XXFZ, con cada mensaje leído seis caracteres tarde y sin cuentakilómetros ni recorrido decodificado; 36 de ellos toman ahora la decodificación Gen2 de upstream.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.Dos marcos están en juego y confundirlos cuesta una tarde. Estos desplazamientos son absolutos al registro, medidos desde el 0xB2. Upstream zero-log-parser corta log_data[address+2 : address+length], desescapa eso y luego toma message = block[5:], así que un desplazamiento de payload de upstream queda 7 por debajo del absoluto al registro que se usa aquí, y un campo de estado en record[42] está en el payload[35] de upstream. El decodificador de este proyecto pasa raw_entry[6:] por dentro, un tercer marco, y por eso record[17] aparece en el fuente como binary_data[11]. Una versión anterior de esta página decía que el payload de upstream empezaba en el byte 6 del registro; era el convenio de este proyecto, no el de upstream.
Entra por la longitud declarada y luego desescapa
El delimitador no aparece en crudo dentro de un registro bien formado, porque quien escribe lo escapa: FE 4D se decodifica como 0xB2 y FE 01 como 0xFE. Cortar por cada 0xB2 funciona mejor de lo que tendría derecho, pero el escape hay que respetarlo igual, porque la longitud declarada cuenta bytes en disco. Entra por el byte 1 y luego desescapa el registro enmarcado. Desescapar primero el búfer entero vuelve a meter 0xB2 en mitad del payload y es peor, y se mide. Esta página te decía antes lo contrario, que el 0xB2 se repite dentro de los payload y que por eso falla un corte ingenuo; en el firmware 538XX que nombra, 96.632 de los 96.727 bytes 0xB2 de los 14 archivos adoptados (99,90 %) son inicios de registro de verdad bajo entramado por cadena de longitud, 34 no se enmarcan nunca y 61 caen dentro de un registro. De esos 61, solo 2 están dentro de un registro cuya longitud declarada cae exactamente en el inicio del siguiente. Los otros 59 están en rasgaduras del pliegue del anillo, donde «dentro de un registro» quiere decir dentro de un marco que la cadena ya había perdido.
La cabecera de registro de 13 bytes, byte a byte
Cada registro Gen3 nativo abre con los mismos 13 bytes, en la placa principal y en la de gestión de la batería por igual, y cinco de sus campos merecen leerse solos: la longitud que enmarca el registro, el tipo que decide cómo leerlo, una marca de tiempo UTC al microsegundo, un número de secuencia por registro y el ajuste de huso de la moto. La tabla es el mapa. Las medidas de al lado cubren los 18 archivos Gen3 nativos de este corpus (diez volcados de placa principal y ocho de gestión de batería) y cuentan solo registros cuyos 13 bytes de cabecera no tocó ningún marcador de página flash.
Los bytes 7 a 10 son la parte subsegundo de la marca de tiempo, en microsegundos. Nunca pasan de un segundo: el valor más alto en cada cabecera intacta de esos 18 archivos es exactamente 1.000.000, y ni un registro lo supera. Ese límite sirve más de lo que parece, porque un registro del diseño antiguo lleva payload en los mismos cuatro bytes y lo rompe en casi todos, y así el decodificador distingue los dos diseños (mira «Dos diseños de registro, decididos por archivo», más abajo).
Este sitio publicó los bytes 11 y 12 como un solo uint16 little-endian «contador de entradas» en [11:13] hasta octubre de 2026, en esta página y en la documentación de su decodificador. Estaba mal, y la medida que lo muestra es corta. Un contador de 16 bits arrastra a su byte alto cuando el bajo salta de 255 a 0; el byte 11 salta 11 veces en estos archivos (nueve en placas principales, dos en baterías), y en cada uno de esos saltos el byte 12 se quedó exactamente donde estaba. Son dos campos: un número de secuencia de un byte y el ajuste de desplazamiento UTC de la moto.
| Bytes | Campo | Cómo leerlo | Medido en los 18 archivos nativos |
|---|---|---|---|
| 0 | Delimitador | 0xB2. Nunca en crudo dentro de un registro: quien escribe lo escapa como FE 4D, y un 0xFE literal como FE 01 | Entra primero por el byte 1 y luego desescapa lo que enmarcaste |
| 1 | Longitud | Tamaño total EN DISCO, contando el byte 0 y cada byte de escape. El único campo fuera de la región escapada, así que el único en el que confiar antes de desescapar | Menos el recuento de escapes, cada tipo de registro cae en una longitud canónica |
| 2 | Tipo | Cabecera 0xFB, texto 0xFD, 0x51 a 0x54, 0x48, 0x49 y 0x4F en la placa principal; 0x4B, 0x4C y 0x4D en el pack | Se lee después de desescapar, como todo lo que sigue |
| 3–6 | Marca de tiempo | uint32 little-endian, segundos Unix, UTC de verdad | El byte 6 cambia una vez cada 2^24 segundos, unos 194 días |
| 7–10 | Microsegundos | uint32 little-endian, la parte subsegundo de la marca de tiempo | Máximo exactamente 1.000.000; nunca por encima |
| 11 | Secuencia | uint8, +1 por registro de cualquier tipo, salta 255 → 0 y vuelve a 0 cuando la placa despierta | +1 entre el 96,4 % de los registros adyacentes de la placa principal y el 96,1 % de los del pack |
| 12 | Desplazamiento UTC | int8, el ajuste de corrección horaria de la moto en horas enteras. Informativo: no lo sumes a la marca de tiempo | −7, 0, +1, +2 y +8 vistos; constante en tramos largos |
| 13… | Carga útil | Según el tipo. El ASCII terminado en NUL de un registro de texto 0xFD empieza aquí | El byte 13 es imprimible en 8.786 de 8.788 registros de texto del pack que no tocó un marcador, y en 18.570 de 18.570 registros de texto de la placa principal |
Upstream zero-log-parser lee los bytes 7 a 12 como un prefijo de seis bytes delante de su payload: una palabra de subsegundo en microsegundos, un contador de secuencia por entrada (midió que avanzaba de uno en uno entre el 97,3 % de 826.535 entradas adyacentes) y un byte que deja sin etiqueta como «marker», y anota que leerlo como desplazamiento UTC sigue abierto. Los microsegundos y la secuencia fueron primero de upstream.
Qué deja ver el byte de secuencia
El byte 11 es la comprobación de integridad más barata del formato. Avanza de uno en uno en cada registro que escribe la placa, sea cual sea el tipo, así que dos registros vecinos en el archivo deberían diferir en exactamente uno. En las parejas de registros intactos que son adyacentes en disco en los 18 archivos nativos, lo hacen en 20.913 de 21.693 parejas de placa principal (96,4 %) y en 13.628 de 14.177 parejas de pack (96,1 %). Las excepciones no son ruido. Cada clase dice algo del archivo:
- Un reinicio en cero: 506 en las placas principales y 536 en las baterías. El contador vuelve a empezar cuando la placa despierta: 499 y 530 de esos reinicios siguen al menos un minuto de silencio, y el registro que toma el número 0 es la línea de despertar de la propia placa: «Board was reset» en 453 de los reinicios de la placa principal y «Exiting Hibernate» en 51, y en las baterías las mismas dos líneas casi siempre. Un reinicio marca un límite de arranque que se puede encontrar sin leer ningún texto.
- Un paso adelante de más de uno: 268 en las placas principales, 3 en las baterías. Los dos registros son vecinos en disco, pero los números de en medio los tomaron registros que no están en este punto del archivo.
- Un paso atrás: 6 en las placas principales. Dentro de un mismo segundo la placa a veces guarda los registros fuera de su orden numerado (una serie lee 12, 14, 13, 15), así que ni dentro de un segundo la posición en el archivo es siempre el orden en que se numeraron.
- Un salto en el pliegue del búfer circular (10 en las baterías), donde al registro más nuevo del búfer le sigue el más antiguo.
- Los 11 saltos de 255 a 0 son pasos +1 normales, y el byte 12 no se movió en ninguno.
Byte 12: el ajuste de desplazamiento UTC de la moto
El byte 12 es un byte con signo que guarda el ajuste de corrección horaria de la moto en horas enteras: el desplazamiento que el cuadro aplica para mostrar la hora local. La marca de tiempo de los bytes 3 a 6 ya está en UTC; la consola de la batería lo demuestra al imprimir la misma época junto a su propio dibujo. Así que el desplazamiento es informativo: dice lo que se veía en el cuadro, nunca cómo mover una hora guardada, y un decodificador que lo suma a la marca de tiempo desplaza cada evento del archivo en horas. El decodificador de este sitio lo guarda una vez por archivo, como el valor más frecuente, y conserva al lado cada otro valor que vio.
Cinco de los 18 archivos llevan un segundo valor. Un cambio dentro de un archivo es un cambio del ajuste, no del reloj: alguien mueve el cuadro una hora por el horario de verano, o una placa escribió unos registros antes de cargar su ajuste guardado. Los recuentos parecen las dos cosas: 2.205 registros en +1 después de 33 en +2, 2.300 en 0 junto a 33 en +1, 2.362 en +2 junto a 18 en +1, 2.112 en +1 junto a 2 en 0 en un pack, y una placa principal con 69 registros en −7 antes de 2.347 en 0. En todo ello las marcas de tiempo siguen en UTC, así que nada se mueve en una línea de tiempo; solo cambia la etiqueta que se habría leído en el cuadro. El conjunto de archivos de upstream, más grande, muestra sobre todo 0xF9, 0x02, 0xFC, 0xFB y 0x01 en este byte (−7, +2, −4, −5 y +1 como desplazamientos), todos ellos un huso civil.
| Valor | Byte | Archivos donde es el ajuste | Registros | Qué significa |
|---|---|---|---|---|
| −7 | 0xF9 | 1 placa principal | 322 | Siete horas al oeste de UTC, un ajuste de Norteamérica |
| 0 | 0x00 | 3 placas principales, 3 baterías | 13.315 | UTC, por ejemplo el Reino Unido fuera del horario de verano |
| +1 | 0x01 | 2 placas principales, 2 baterías | 8.877 | Europa central en invierno, o el Reino Unido en verano |
| +2 | 0x02 | 2 placas principales, 1 batería | 6.883 | Europa central en verano |
| +8 | 0x08 | 2 placas principales, 2 baterías | 8.908 | Ocho horas al este de UTC |
Un valor fuera de −12 a +14 no es un huso civil, y el decodificador no lee uno ahí. En un archivo de batería suele ser un marcador de página sentado en el byte, y por eso el resumen por archivo cuenta solo registros cuya cabecera no tocó ningún marcador.
Retirado aquí: «un contador de entradas uint16 en [11:13]»
Hasta octubre de 2026 esta página, y la documentación del decodificador de este sitio, describían los bytes 11 y 12 como un solo contador de entradas de 16 bits little-endian. Un contador de 16 bits arrastra a su byte alto cuando el bajo da la vuelta; en los 11 saltos del byte 11 de este corpus el byte 12 no se movió, y el byte 12 solo toma el puñado de valores de la tabla de arriba. Leído como contador, ponía cada registro de una moto en UTC+2 unos 512 números por encima de los de una moto en UTC0, sin motivo alguno.
Qué archivos cuentan como Gen3
El clasificador no tiene un umbral de año de modelo. Un log se trata como Gen3 cuando no salta un veto duro y lo hace al menos una de tres señales positivas o, si eso falla, cuando lo coge un override de enrutado aparte, fuera del clasificador. Acertar este orden importa, porque el delimitador 0xB2 lo comparte con los archivos MbbD de formato de concesionario Gen2, y un archivo Gen2 clasificado como Gen3 pierde en silencio sus eventos Sevcon y de acelerador.
El veto duro salta cuando el modelo es uno de S, SR, DS, DSR, FX, FXS o XU, o cuando el código de año del VIN (el décimo carácter) es uno de la A a la J, que corresponde a los años de modelo 2010 a 2018. El código de año K (2019) es el primero que el veto deja de rechazar, que es también cuando salió la SR/F. El veto es un veto, no un umbral: un VIN de 2019 o posterior sigue necesitando una señal positiva.
El clasificador tiene tres señales positivas, comprobadas por orden. Primera, el modelo es uno de SR/F, SR/S, DSR/X o FXE, comparado sin la barra. Segunda, el VIN encaja con la expresión regular de la familia Gen3, que acepta las subcadenas ZF más una letra más Z, XXFZ, o DZ más una letra más Z. Tercera, una conjunción y no un patrón suelto: el texto decodificado contiene un marcador solo de Gen3, una línea «State change … from … to …» o una línea «Disch limits curr N cap N act N pow N», Y no contiene la línea de condiciones MBB Gen2, la que lee «PackTemp: h NC, l NC, PackSOC: N%». Hacen falta las dos mitades: un log de concesionario Gen2 puede traer texto de cambio de estado propio, y la mitad de telemetría Gen2 ausente es lo que impide que cuente.
Existe una cuarta ruta hacia el decodificador Gen3, y conviene separarla de las tres de arriba porque es fácil leer el código y concluir que el clasificador tiene cuatro señales, y no las tiene. Cuando el clasificador ha devuelto false, quien llama aplica un override de enrutado: un archivo MBB cuyo búfer circular 0xB2 se enmarcó bien, en una moto que el veto duro no rechazó, se manda al decodificador Gen3 de todos modos. Eso rescata un archivo cuyo texto de cabecera no da ni un modelo usable ni un VIN. Ocurre fuera del clasificador, así que una implementación que reproduzca solo la tabla de abajo no lo reproduce. Un archivo BMS tiene el atajo equivalente: se trata como Gen3 cuando su cargador binario Gen3 tiene éxito, con independencia del modelo y del VIN.
En un archivo MBB los bytes deciden ahora antes que nada de eso (2026-10-03). El decodificador nativo lee la cabecera de registro FST (texto desde el byte 13, el estado en un desplazamiento fijo), y un archivo contenedor Gen2, la cabecera «MBB» más nulo con A1 A1 A1 A1 en el desplazamiento 38, enmarca sus registros 0xB2 con el payload desde el byte 7. Mandado al decodificador nativo por el override o por el brazo XXFZ de la familia VIN, un archivo así tenía cada mensaje leído seis caracteres tarde y no daba cuentakilómetros ni recorrido. Así que ninguna de las señales de arriba manda una MBB al decodificador nativo si su cabecera no es el registro de placa 0xFB nativo o sus registros no traen la cabecera FST: una palabra de subsegundo de como máximo 1.000.000 en al menos el 80 % de ellos, y un desplazamiento UTC civil en el byte 12 en al menos el 80 %, con un valor que cubra la mitad. En los 151 archivos MBB de este corpus con «MBB» en sus primeros 32 bytes, las dos señales de bytes coinciden en cada archivo y las poblaciones no se acercan: los 10 archivos nativos puntúan 1,0, 1,0 y al menos 0,971, y los 141 archivos contenedor Gen2 como máximo 0,149, 0,442 y 0,316. De los 37 archivos contenedor Gen2 distintos que llegaban al decodificador nativo, 36 toman ahora la decodificación Gen2 de upstream; el último tiene un reloj de 1970 en cada registro, que ningún decodificador puede colocar.
La FXE merece una nota propia, porque es el modelo en el que esta especificación y el resto del sitio pueden parecer que discrepan. FXE está en el conjunto de modelos Gen3 del clasificador junto a SR/F, SR/S y DSR/X, así que un log FXE encaja con la señal 1 y se guarda con log_generation = 3. Eso dice a qué decodificador se enruta el archivo, no la generación de producto de la moto. Un catálogo que describe la FXE como máquina Cypher II responde otra pregunta, y las dos pueden ser ciertas a la vez.
Los únicos archivos FXE de este corpus son tres volcados de concesionario de 262.144 bytes de una moto, y su cuerpo MBB no es en absoluto un búfer circular Gen3 nativo. Abre con el ASCII «MBB» más un nulo, no con un 0xB2, lleva A1 A1 A1 A1 en el desplazamiento 38, no contiene ninguno de los tokens RUN, PWSU, HIB o CHRG rellenos de nulos que busca el decodificador Gen3 nativo, y guarda 1.809 y 2.228 registros de tipo 0x2c en los dos archivos MBB. Ese recuento es un barrido byte a byte de cada 0xB2 cuyo byte de tipo es 0x2c, el mismo convenio que reproduce exactamente la tabla de tipos de registro BMS de esta página; exige que la longitud en disco sea exactamente 40 y los mismos dos archivos dan 1.682 y 2.093. (Una revisión anterior publicó 1.771 y 2.200 sin nombrar un convenio, y esos dos números no se reproducen bajo ninguno de estos. Remedido el 2026-07-30.) Esa es la variante de firmware 538XX que se describe más adelante en esta página, y es la ruta por la que se decodifican esos archivos. Así que nada de los mapas de registro Gen3 nativos de aquí se ha comprobado contra una FXE.
| Regla | Valor | Efecto |
|---|---|---|
| Veto duro: modelo | S, SR, DS, DSR, FX, FXS, XU | La detección Gen3 se salta por completo |
| Veto duro: código de año del VIN | A-J (2010–2018), carácter 10 del VIN | La detección Gen3 se salta por completo |
| Señal 1: modelo | SR/F, SR/S, DSR/X, FXE | Clasificado Gen3 |
| Señal 2: familia VIN | ZF más una letra más Z, XXFZ o DZ más una letra más Z, como subcadena | Clasificado Gen3 |
| Señal 3: patrones de texto | Patrón: ("State change … from … to" OR "Disch limits curr …") AND NOT "PackTemp: h …, PackSOC: …" | Clasificado Gen3 |
| Override del enrutador: estructura binaria | Archivo MBB cuyo búfer circular 0xB2 se enmarca, veto duro no disparado | Enrutado al decodificador Gen3 fuera del clasificador |
| Puerta de diseño de registro: MBB | Cabecera 0xFB nativa, o cabecera de registro FST en los registros enmarcados | Hace falta antes de que CUALQUIER señal de arriba mande una MBB al decodificador nativo |
| Override del enrutador: BMS | El cargador binario BMS Gen3 tiene éxito | Enrutado al decodificador BMS Gen3 |
| Puerta independiente | Marca de tiempo del registro desescapado en 2019-01-01 .. ahora + 365 días | Registro rechazado por los dos entramadores Gen3 |
Las cinco primeras filas son el clasificador: dos vetos más una disyunción de tres vías, no una comparación de año. Una SR/F de 2021 con una cadena de modelo ilegible sigue clasificada Gen3 por su familia VIN; una FX de 2019 queda vetada por modelo, pase lo que pase en el archivo. Las dos filas de override NO forman parte de esa disyunción: las aplica quien llama después de que el clasificador ya ha devuelto false, y por eso una implementación solo del clasificador enruta menos archivos al decodificador Gen3 que la nuestra. Los overrides siguen respetando los vetos. La puerta de diseño de registro se sienta delante de todo ello para una MBB: ni el modelo, ni la familia VIN ni un override mandan al decodificador nativo un archivo cuyos registros no tienen la cabecera FST.
Dos diseños de registro, decididos por archivo
No todos los archivos que llegan a un decodificador Gen3 usan la cabecera de 13 bytes de arriba. Los volcados de placa principal de plataforma Gen2, la variante 538XX y algunas exportaciones de gestión de batería también son flujos de registros 0xB2, pero en su diseño antiguo el payload (texto incluido) empieza en el byte 7 del registro, justo después de la marca de tiempo: no hay microsegundos, ni secuencia, ni byte de desplazamiento. Un volcado de batería con forma Gen2 puede llegar al decodificador de batería Gen3, porque trae la telemetría 0xB2 que busca el enrutador.
Aplicar las reglas FST a un archivo así sale caro: leer su texto desde el byte 13 cortaba los seis primeros caracteres de cada mensaje («DEBUG: CAN Link Is Down» pasaba a «CAN Link Is Down») y soltaba cada registro que el corte dejaba demasiado corto. En un archivo de producción que toma esta ruta, el byte 7 empieza el texto en todos menos uno de 3.556 registros de texto. Así que el diseño se decide por archivo, desde los bytes del propio archivo, con una sola prueba (has_fst_record_layout en el decodificador). Un archivo usa el diseño FST cuando se cumple cualquiera de estas:
- 1el marcador de página flash 00 F0 FF 00 abre su segunda y su tercera página de 128 bytes (solo lo escribe una imagen de batería FST, así que esto solo zanja la pregunta); o
- 2en sus registros con cabecera completa de 13 bytes, los bytes 7 a 10 leen como máximo 1.000.000 en al menos el 80 % de ellos, el byte 12 se lee como desplazamiento UTC civil (−12 a +14) en al menos el 80 %, y un valor de desplazamiento cubre al menos la mitad.
| Población | Archivos | Bytes 7–10 dentro de un segundo | Byte 12 con desplazamiento civil | Desplazamiento dominante |
|---|---|---|---|---|
| Diseño FST (8 archivos de batería paginados, 10 de placa principal) | 18 | ≥ 0,970 | ≥ 0,990 | ≥ 0,959 |
| Cualquier otro archivo | 345 | ≤ 0,160 | ≤ 0,442 | ≤ 0,316 |
| Umbral para FST | — | 0,80 | 0,80 | 0,50 |
Los umbrales se fijaron en una muestra más amplia de 374 archivos: este corpus más once archivos de producción que una comparación de producción había marcado. Ahí la cuota más baja de desplazamiento dominante FST fue 0,685, en un volcado de batería en crudo de 13,6 MB que cruzó un cambio de horario de verano y escribió −5 y −6; cada archivo no FST se quedó en o por debajo de 0,16, 0,44 y 0,32. Los archivos paginados también se puntúan, pero el marcador solo los decide.
No decidas el diseño por un nombre de archivo ni por un prefijo de VIN
Un nombre de archivo es lo que tecleó quien copió el archivo. La única imagen FST de este corpus que no lleva el nombre de exportación de la app es un recorte truncado de 16 kB de placa principal, y los once archivos de producción que marcó la comparación incluían imágenes FST nativas cuyos nombres decían otra cosa. Un prefijo de VIN no es mejor: la variante 538XX escribe un cuerpo al estilo Gen3 detrás de un VIN Gen2. Lo que la prueba no puede decidir (un archivo sin un registro de longitud completa) se queda con el comportamiento antiguo, que es el que necesita cada archivo no FST. En un registro legado los bytes 7 a 10 son payload y el byte 12 es el sexto carácter de un mensaje (los «:» de «DEBUG:»), así que las dos poblaciones no se acercan.
Tipos de registro MBB Gen3 nativos
Un archivo MBB Gen3 nativo tiene 131.200 bytes tal como lo exporta la app de Zero, con el marcador «MBB» en el desplazamiento 0x0D y el primer 0xB2 en el desplazamiento 0. Las exportaciones de concesionario tienen 262.144 bytes. Los recuentos de abajo son por archivo y se midieron en ocho logs reales; los intervalos son amplios porque dependen de cómo se usó la moto antes de la exportación.
0x2c de longitud canónica 40 directamente del cable en este archivo más 257 recuperados al desescapar, para los mismos 2.540. Estas cifras por archivo se desvían un poco de las cifras del corpus agrupado que cita el artículo (cadena de longitudes: 19.089 registros MBB en los ocho volcados de app, 15.890 BMS en siete); misma medición, distinto denominador. Así que un MBB Gen3 nativo gasta el 87,1 % de sus 2.368 registros en texto ASCII y te da 151 registros de telemetría, que sí llevan la tensión y la corriente del pack en record[34:38] y record[38:42]. El decodificador los lee desde el 2026-09-07, pero solo mientras el bus de alta tensión está activo, y valen cero en hibernación (0 de los 417 registros HIB de los nueve archivos MBB Gen3 nativos, frente a 144 de 144 en RUN). La variante 538XX escribe 2.540 registros de telemetría que un decodificador consume.| Tipo | Nombre | Tamaño típico | Recuento por archivo | Cuota | Contenido |
|---|---|---|---|---|---|
| 0xFB | Cabecera | 117 B | 1 | — | VIN, tipo de placa, serie, número de pieza, compilación de firmware |
| 0xFD | Evento de texto | variable, 28–105 B | 1.811–2.331 | 86,7% | Mensajes de log ASCII terminados en nulo |
| 0x51 | Telemetría | 75 B (71 B en firmware de 2023) | 131–239 | 6,9% | Estado, SOC, tensión y corriente del bus de continua y del pack, rpm del motor, temperaturas ambiente, de motor, de inversor y de celda, raíl de 12 V |
| 0x54 | Motor | 29 B | 0–239 | 5,6% | Par en el eje, corriente de motor, tensión del bus de continua; escrito junto a cada 0x51 |
| 0x52 | Ampliado | 92 B (88 B en firmware de 2023) | 0–31 | 0,35% | Todo lo que lleva el 0x51, más velocidad en carretera, autonomía estimada y (en el diseño nuevo) el cuentakilómetros |
| 0x48 / 0x49 / 0x4F / 0x53 | Carga, cola, telemetría mayor | variable | 0–69 | 0,5% | Tabla de cargadores, objetivos de recarga, desborde de cola FreeRTOS y el registro de estado más grande (todos decodificados, mira abajo) |
Las cuotas son de 19.089 registros en los ocho archivos, enmarcados por la longitud declarada y desescapados. Los totales por archivo iban de 2.238 a 2.535 registros. Los tamaños de la tercera columna son las longitudes canónicas, tras desescapar; en disco un registro con un escape mide un byte más.
Registro de cabecera (0xFB, 117 bytes): el archivo nombra su moto
Exactamente un registro de cabecera abre cada archivo de placa principal Gen3 nativo, y su marca de tiempo es la de la descarga, no la de un log. Nombra la moto, y desde la versión 3.37.0 el decodificador de este sitio lo lee de los bytes (el VIN, el modelo, el año de modelo, las revisiones de placa y de firmware y la compilación de firmware) en vez de tomarlos del nombre del archivo. En los diez archivos de placa principal nativos de este corpus, cada uno de esos campos está presente y se lee en los diez.
El VIN se acepta solo cuando pasa el dígito de control del 49 CFR 565, el prefijo 538 o PAG y el juego de caracteres del VIN. El hueco es texto escribible, y el dígito de control es lo que hace seguro preferir la cabecera al nombre del archivo, que es lo que cambia un renombrado. Empieza en el desplazamiento 0x29 en los diez archivos de aquí. Upstream zero-log-parser encontró estos desplazamientos primero (su decodificación de cabecera del 15 de septiembre de 2026, acreditada allí a la pull request de AtomicDog de 2022), y sitúa el VIN un byte más tarde, en 0x2A, en cerca del 2,6 % de los archivos de producción, con cada otro campo moviéndose con él; un byte escapado en la propia marca de tiempo de la cabecera es la causa más probable. El decodificador prueba primero la cabecera desescapada, luego los desplazamientos en crudo 0x29 y 0x2A, y no lee nada cuando ningún VIN valida, porque el desplazamiento queda entonces desconocido.
El año de modelo es un añadido de este decodificador. Los dos bytes anteriores al nombre del modelo son un uint16 con el año por diez (20210 para un 2021), y en diez de diez archivos iguala el año codificado en el décimo carácter del VIN. Su byte alto, 0x4E o 0x4F, es lo que un barrido de texto imprimible leía como parte del modelo, y de ahí salieron «NSRF» y «ODSRX». Aquí: modelo SRF en cuatro archivos, SRS en tres y DSRX en tres; revisión de placa 2 en tres, 4 en cinco y 5 en dos; revisiones de firmware 19, 29, 42, 43 y 44.
Lo que sacas de ahí: un archivo que sigue diciendo de qué moto salió después de renombrarlo o reenviarlo, un año de modelo que contrasta el VIN, y la revisión de hardware y de firmware de la placa principal el día de la descarga, que es lo primero que comparar cuando dos archivos de la misma moto se decodifican distinto. Los valores identifican una moto o la estrechan, y ninguno se imprime en esta página.
[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 digitsLos números de pieza observados mapean a plataformas: 40-08155 en SR/F de 2020–2021, 40-08198 en SR/S y una SR/F de 2023, 40-08285 en DSR/X. El número de pieza solo no decide el diseño del registro (mira la nota de deriva de firmware, más abajo).
Registro de evento de texto (0xFD, variable)
Los eventos de texto son el grueso del archivo y el único sitio donde una MBB Gen3 nativa declara una lectura de alta tensión del pack. El payload es ASCII terminado en nulo desde el byte 13 del registro, después del campo de microsegundos de cuatro bytes, el byte de secuencia y el byte de desplazamiento UTC. Ese último byte se describió aquí como un marcador de placa, 0x02 en la MBB y 0x01 en el BMS; leía 0x02 y 0x01 solo porque los archivos de los que se leyó venían de motos puestas en UTC+2 y UTC+1.
Un solo ciclo de despertar de hibernación produce una ráfaga muy repetible. Medido en 416 ciclos de despertar completos de los ocho volcados de app a tamaño completo, la ráfaga mediana es de 31 registros, lo más frecuente 27 eventos de texto, 2 de telemetría y 2 secundarios, escritos en una ventana de 91 segundos. Un ciclo aquí es una pareja de marcadores consecutivos «Hibernating for N sec» separados por 3.000 a 4.200 segundos, sobre registros enmarcados por cadena de longitud; cuenta solo los marcadores que declaran 3.600 segundos y los mismos ocho archivos dan 411. Los marcadores se repiten en un intervalo mediano de 3.691 segundos, que es el sueño declarado de 3.600 segundos más la ráfaga que le sigue. Ese periodo no se infiere: el último registro de cada ráfaga es literalmente el texto «Saving Stats, Hibernating for 3600 sec», y 444 de las 462 directivas de hibernación de esos ocho archivos especifican 3600 segundos (446 de 464 si se cuenta el noveno archivo, el truncado). Los 18 restantes especifican 31.536.000 segundos, que son 365 días: un modo de almacenamiento o de transporte.
La documentación interna decía la tasa de hibernación de dos maneras, «unas 15 a 20 entradas por hora» y «unas 15 a 20 entradas por ciclo de despertar, cada 1 hora». Por ciclo de despertar es el encuadre correcto, y como el ciclo es horario las dos tasas coinciden. El número es la parte que estaba mal: la mediana medida es de 31 registros en crudo por ciclo, no de 15 a 20.
- «State change from STRT to PWSU» y «State change from PWSU to HIB»: las transiciones de despertar y de volver a hibernar.
- «Saving Stats, Hibernating for N sec»: el intervalo de sueño que la placa acaba de pedir.
- «Registering Mod N (NNNNNNmV, N brick )»: la única lectura de alta tensión del pack en el lado MBB.
- «Disch limits: curr N cap N act N pow N» y «Ch limits: ...»: sobres de potencia de descarga y de recarga, en vatios.
- «Fault pending: CODE» y «Fault cleared: CODE»: transiciones de fallo, por ejemplo HVIL_OPEN.
- «Requesting 12v charge. DC-DC NuV, Battery NuV, Combined NuV, Ambient NC»: la batería de accesorios de 12 V, en microvoltios.
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 secAbreviado: se omiten las líneas repetidas de «Control flags changed» y de límites, y la ráfaga completa son 31 registros. La tensión de pack de 104.832 mV en la línea «Registering Mod» es la única lectura de alta tensión que produce una MBB Gen3 nativa, y es texto, no un campo binario.
Registro de telemetría (0x51, 75 bytes)
Es la columna vertebral binaria del log del MBB. El decodificador lee el campo de estado en un desplazamiento fijo por tipo de registro (el byte 42 del registro en un 0x51, el 46 en un 0x52, el 50 en un 0x53) y acepta ahí uno de diez tokens ASCII rellenados con nulos: RUN, STOP, HIB, STRT, PWSU, CHRG, WAIT, WAKE, REV, PARK. Todos los demás desplazamientos son relativos a él. Antes buscaba el token en todo el registro, y un registro de texto que contuviera por casualidad una de esas palabras hacía que un carácter de su mensaje se leyera como estado de carga: casi siempre un espacio, 0x20, que es 32. La producción acumuló 512 recorridos que terminaban justo en un SoC de 32 antes de que se pusiera el ancla en el servidor, y el decodificador del navegador que hay detrás de /decode siguió buscando hasta 2026-10. Aquí intervienen dos poblaciones, y mezclarlas es como esta página se equivocó dos veces con la cifra siguiente. Una vez respetado el escape, hay 1.121 registros 0x51 completos de 75 bytes en los nueve archivos MBB nativos, y 1.078 de ellos ya medían 75 bytes en el disco. El token cae en el byte 42 del registro en todos. En 1.069 de los 1.078 es uno de los ocho tokens que el decodificador conocía al principio; los 9 restantes llevan REV o PARK (cinco y cuatro, todos en la única DSR/X de aquí) y se descartaban hasta que se añadieron esos dos, en el servidor en 2026-08 y poco después en este decodificador del navegador. Nunca estuvieron sin token ni vacíos: los 9 llevan una tensión de pack rellena en record[34:38], entre 102,561 V y 102,630 V, así que los dos tokens recuperaron telemetría real y no ruido. La tabla de anclas es lo que permite al mismo decodificador leer el registro 0x52 de 92 bytes, donde el estado está cuatro bytes más allá, y el 0x53 de 106 bytes, ocho bytes más allá.
Dos campos se direccionan en relación con el token. El SOC es el byte único nueve antes de él, en record[33] en un registro de 75 bytes. Los seis uint32 posteriores al estado empiezan nueve bytes después del inicio del token, porque el campo de estado se rellena hasta nueve bytes.
El indicador de modo en record[17] merece una nota, porque dos revisiones distintas de la documentación interna lo describieron de dos maneras opuestas. Es un indicador de modo y está en el byte 17, no en el 11. Medido por estado sobre los 1.121 registros 0x51 completos de 75 bytes: vale 0x00 en 144 de 144 registros RUN, 0x6A en 408 de 408 PWSU, 0x6A en 397 de 417 HIB con 0x60 en los otros 20, y 0x6A en 7 de 7 CHRG. Varía dentro de una misma moto según el estado, así que no puede ser el identificador de hardware por moto que se llegó a decir. El byte 11, que una revisión anterior nombraba como el indicador de modo, es el byte de secuencia del registro: toma 105 valores distintos en esos mismos 144 registros RUN y no cae en {0x00, 0x6A, 0x60} en ninguno.
| Estado | Registros | SOC = 0 | post_1 / post_2 puestos | post_3 / post_4 puestos |
|---|---|---|---|---|
| HIB | 417 | 9 (2,2%) | 20 (4,8%) | 0 |
| PWSU | 408 | 373 (91,4%) | 0 | 34 (8,3%) |
| RUN | 144 | 0 | 144 (100%) | 144 (100%) |
| WAIT | 51 | 47 (92,2%) | 3 (5,9%) | 3 (5,9%) |
| WAKE | 44 | 0 | 3 (6,8%) | 44 (100%) |
| STOP | 41 | 0 | 18 (43,9%) | 41 (100%) |
| CHRG | 7 | 0 | 0 | 7 (100%) |
| REV | 5 | 0 | 5 (100%) | 5 (100%) |
| PARK | 4 | 0 | 4 (100%) | 4 (100%) |
La población son los 1.121 registros cuya longitud es la canónica de 75 DESPUÉS de quitar el escape, que es la misma población que usa cualquier otra cifra del 0x51 de esta página. Una versión anterior de esta tabla se contó sobre los 1.078 registros que ya medían 75 bytes EN DISCO (se dejaban fuera los 43 con escape, que es justo lo que esta página dedica una sección a retractar) y daba HIB 405, PWSU 397, RUN 130, WAIT 50, STOP 36. Esos números son correctos para esa población más estrecha y erróneos como descripción del formato. Los cuatro enteros posteriores al estado se comportan como dos pares, no como cuatro canales independientes: post_1 y post_2 se rellenan siempre juntos, y también post_3 y post_4. La afirmación anterior de que las temperaturas aparecen solo en WAKE, STOP y CHRG no se sostiene: RUN rellena los cuatro, y PWSU y HIB rellenan un par cada uno. REV y PARK se comportan exactamente igual que RUN, que fue el segundo argumento para añadirlos a la lista de tokens. Eso ya se ha hecho en los dos decodificadores.
[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 belowTres notas. Primera: [34:38] y [38:42] se publicaron en esta página como "[34:42] zeros (padding)"; no son relleno, y la prueba está en la sección de arriba. Se miden en cinco motos 538ZF (plataforma SR/F). En la única moto con WMI PAG de este corpus solo 18 de 278 registros 0x51 los rellenan, así que no está confirmado para el firmware de la época de la DSR/X. El decodificador los lee ambos desde 2026-09-07, a partir de registros cuyo bus está activo. Segunda: las cinco temperaturas posteriores al estado se publicaron aquí, y se guardaron, con nombres equivocados hasta 2026-09-07: post_0 como "internal metric", post_1 como máxima del pack, post_2 como mínima del pack (y persistida como temperatura del motor), post_3 como ambiente y post_4 como controlador. El orden era correcto y las etiquetas no, y la tabla de estados de más abajo ya lo demostraba: post_1 y post_2 están puestos en todos los registros RUN y en ninguno de CHRG (un motor y un inversor están inertes cuando la moto está aparcada), mientras que post_3 y post_4 están puestos en RUN, STOP, WAKE y CHRG por igual, que es lo que hacen las celdas. Tercera: el byte 11: una revisión anterior de la documentación interna lo llamaba indicador de modo del controlador y llamaba al byte 17 un ID de hardware por moto. Las dos cosas estaban al revés. El byte 11 es el byte de secuencia y tiene mucha entropía (105 valores distintos en los 144 registros RUN), mientras que el byte 17 es una función limpia del estado.
Retractado: record[71:75] no es un cuentakilómetros
Esta página publicó record[71:75] como un cuentakilómetros de por vida en metros, y explicó su comportamiento como fluctuación: "13.183,8 km to 13.276,1 km within one 20-minute ride, a spread of 92,3 km". No es un cuentakilómetros y no fluctúa. Los 1.121 registros completos de 75 bytes de este corpus cumplen v = 5128k + 4864 con k entre 27 y 2.620, que es un ADC de 12 bits con un bit menos significativo de 5,128 mV y unos 21 V de fondo de escala. Leído como microvoltios, el campo abarca de 0,143 V a 13,440 V, y los propios eventos de texto del firmware citan la batería de accesorios exactamente en esas unidades y esa banda ("Stopping 12v charge. DC-DC 302288uV, Battery 13142800uV"). La diferencia de 92,3 "km" dentro de un recorrido es un raíl de 12 V que se mueve de 13,184 V a 13,276 V. Solo el 51,5 % de las muestras consecutivas no decrecen (una moneda al aire), y un barrido exhaustivo de cada ventana uint32 del desplazamiento 3 al 71 no encuentra ninguna ventana monótona salvo la propia marca de tiempo. No hay ningún cuentakilómetros en un registro 0x51. Esa frase se citó más tarde como "no hay cuentakilómetros en un registro MBB Gen3 nativo", lo cual es falso: el barrido en que se apoyaba cubría solo el 0x51 de 75 bytes, y el cuentakilómetros está en la cola de los registros más largos 0x52 y 0x53 (véase la sección de registros ampliados más abajo).
Cómo se detectó esto y lo que costó
La pista fue aritmética. Las diferencias consecutivas del campo comparten un máximo común divisor de 5.128 con un residuo constante de 4.864 en 1.121 de 1.121 muestras: una retícula que no produce ninguna medida de distancia y produce cualquier ADC. La corroboración fue que cinco motos sin relación entre sí, de tres familias de modelo y cinco años modelo (SR/F 2020, SR/F 2021, SR/S 2021, SR/F 2023, DSR/X 2024), informaban "cuentakilómetros" dentro de una ventana de 272 km. En este proyecto el campo estaba pasando una puerta de rango de 100.000 a 200.000.000, que superaban 1.121 de 1.121 muestras, y llegaba al panel como el cuentakilómetros principal y como distancia por recorrido. Se ha quitado del decodificador; el campo se emite ahora en bruto y sin escalar con un nombre neutro, porque «qué raíl» es de alta confianza y no está demostrado.
Registro del motor (0x54, 29 bytes)
El registro 0x54 se escribe junto a cada 0x51 y es el canal del motor: cuatro palabras int32 little-endian con signo tras la cabecera (par del eje en micronewton-metros, corriente del motor en amperios enteros, un contador libre y la tensión del bus de continua en milivoltios), y FF FF FF FF significa «no medido». Esta página lo listaba como de propósito desconocido hasta 2026-09-07, porque en una moto aparcada está casi vacío: de los 968 registros cuya longitud en disco es la nominal de 29 bytes, en los ocho volcados de la app, 848 (87,6 %) tienen los bytes 13 a 24 a cero (sin par, sin corriente, un contador parado), y 782 (80,8 %) acaban con el centinela FF FF FF FF donde va la tensión del bus; otros 78 (8,1 %) acaban con cuatro bytes a cero.
Hay que cumplir dos comprobaciones internas, y se cumplen en todos los registros medidos. El par es exactamente 0,2 N·m por amperio de corriente del motor (27,6 N·m a 138 A, 49,2 a 246, 59,2 a 296), así que las dos primeras palabras son una sola medición a través de la constante del motor, y esa constante es la prueba de que el encuadre es el correcto. Y la tensión del bus cae al subir el par, de 111,9 V a 0,6 N·m a 106,9 V a 59,2 N·m, y se mantiene entre 3,82 y 4,00 V por celda en un pack de 28 en serie. Un mapa de campos publicado llama a esa palabra «potencia de descarga W»; un canal de potencia no se hunde bajo carga.
[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 measuredRegistros ampliados (0x52, 92 bytes, y 0x53, 106 bytes): velocidad, autonomía y cuentakilómetros
El registro 0x52 tiene la misma forma que el 0x51 con cuatro bytes extra insertados en la zona previa al estado, lo que mueve el token de estado del byte 42 del registro al 46; el 0x53 inserta ocho y lo pone en el 50. Los dos son raros (67 registros 0x52 en los ocho volcados de la app con encuadre por cadena de longitudes, 87 contando el noveno archivo, y de 0 a 31 por archivo, sobre todo en torno a eventos WAKE), y los dos llevan una COLA que un 0x51 no tiene. Una versión anterior de esta página decía 66 registros 0x52; es la misma cantidad contada como delimitadores 0xB2 en bruto cuya marca de tiempo sin quitar el escape cae en la ventana, otra convención.
La cola contiene la velocidad en carretera en milímetros por hora (km/h × 1.000.000), la autonomía restante estimada del cuadro en centésimas de kilómetro y, solo en la disposición de firmware más nueva (aquella cuyo 0x51 mide 75 bytes), el cuentakilómetros en décimas de kilómetro. Relativo al token de estado: en la disposición más nueva el cuentakilómetros está en +35, la velocidad en +39 y la autonomía en +43 como uint16; en la disposición más antigua la velocidad está en +35, la autonomía en +39 como uint32 y no hay cuentakilómetros en absoluto. La palabra en +39 de la disposición antigua es la trampa: sube suavemente de 5.000 a 11.773 en un archivo y de 11.005 a 18.642 en otro, justo en la banda de kilometraje de una Zero, y cada muestra de esa subida es un registro CHRG. Un cuentakilómetros no se mueve mientras la moto está enchufada; es la estimación de autonomía subiendo a medida que se llena el pack. El cuentakilómetros de la disposición más nueva supera la prueba que fallan los impostores: está congelado durante toda una carga, solo sube en RUN y no decrece en 48 de 48 y 36 de 36 pasos en los dos archivos con muestras suficientes. El decodificador sigue comprobando la serie por archivo y la retira si más de una décima de sus pasos retroceden.
Objetivos de carga e instantáneas de estado de la placa principal (0x49, 0x4B–0x4D)
Se decodifican otros cuatro tipos de registro de la placa principal. La tabla del cargador (0x48), el informe de cola llena (0x4F) y el rótulo de compilación del firmware (0x32) tienen cada uno su propia subsección más abajo; aquí están los dos cortos.
El tipo 0x49 lleva el techo de carga en milivoltios, el objetivo de carga como porcentaje y una tensión de almacenamiento: 117,60 V, 90 % y 106,00 V en una moto, siendo el 90 el límite del propio usuario.
Los tipos 0x4B, 0x4C y 0x4D también aparecen en el lado de la placa principal de algunos archivos de producción, como instantáneas de estado de 53, 84 y 96 bytes con un token de estado en el byte 42, 46 o 50 del registro, las mismas tres posiciones que 0x51, 0x52 y 0x53. Ninguno aparece en este corpus, así que el decodificador lee el token y nada más, y no lo usa para detectar recorridos hasta que alguien haya medido qué haría ahí. La placa de la batería escribe los mismos tres códigos de tipo con longitudes distintas y una disposición sin relación; lo que los distingue es la longitud.
Tabla del cargador (0x48): qué cargadores respondieron y desde qué red
Mientras la moto carga, la placa principal escribe un 0x48 cada 640 segundos más o menos: la cabecera de 13 bytes seguida de un bloque de 49 bytes por cada cargador que respondió en el bus CAN (62 bytes con un bloque, 111 con dos). Este corpus tiene 119 de ellos, en tres de los diez archivos nativos de la placa principal, de tres motos, y todos miden 62 bytes. Donde una moto tiene dos cargadores no comparten registro aquí: cada uno responde en un registro de un bloque propio, con id CAN 16 y 17, y en 48 ocasiones los dos caen en el mismo segundo. Así fue como una comparación que emparejaba registros por marca de tiempo emparejó una vez los dos equivocados e informó de un desacuerdo sobre el id CAN donde no lo había.
Los campos de red eléctrica demuestran la disposición, y la demuestran porque este corpus abarca dos redes. Una moto lee de 113 a 115 V a 60 Hz en los mismos bytes donde las otras dos leen de 218 a 236 V a 49 o 50 Hz, y solo una lectura real de red separa esas poblaciones en los mismos desplazamientos. Por eso la frecuencia se lee como una clase por moto y no como un número: una moto de aquí carga con una red de 60 Hz y dos con 50 Hz.
El nombre es el ASCII del propio cargador: "3kW" en 97 registros y "Flt 6" en 22 aquí; el zero-log-parser original informa además "Charger", "6kW" y "3kWFCC" en sus propios archivos. "Flt 6" es lo que escribe el único cargador de una moto en su campo de nombre en todos sus registros mientras entrega de 15 a 26 A, así que no es un cargador que se haya detenido, y no se sabe qué abrevia. Aparecen las versiones de firmware del cargador 201 (66 registros), 206 (31) y 104 (22), cada una en una moto. El número de serie se decodifica y nunca se publica.
Lo que puede leer el usuario: qué cargadores respondieron y cuándo uno deja de responder; la tensión y la frecuencia en la toma; cuánta corriente sacó cada unidad de la pared (de 5 a 12 A aquí) y qué entregó al pack. Es el lado de corriente alterna de una carga, y ningún otro registro lo lleva.
| Bytes del registro | Campo | Tipo | Visto en este corpus |
|---|---|---|---|
| 13–22 | Nombre | 10 bytes, ASCII rellenado con nulos | "3kW" (97), "Flt 6" (22) |
| 23–24 | Indicadores | uint16 LE | Bits aún sin identificar |
| 25–28 | Tensión de salida en continua | uint32 LE, mV | Tensión del lado del pack |
| 29 | Corriente de salida en continua | uint8, A | De 5 a 26 A |
| 37 | Comando de entrada | uint8 | Almacenado; significado sin confirmar |
| 39 | Tensión de entrada en alterna | uint8, V | 113–115 V o 218–236 V |
| 40 | Corriente de entrada en alterna | uint8, A | 5, 7, 9 o 12 A |
| 42 | Frecuencia de alterna | uint8, Hz | 49, 50 o 60 |
| 44 | Id CAN | uint8 | 16, 17 |
| 45–46 | Versión del firmware | uint16 LE | 104, 201, 206 |
| 47–50 | Número de serie | uint32 LE | Decodificado; nunca publicado |
| 53–56 | Techo de carga | uint32 LE, mV | La tensión que el cargador puede alcanzar |
| 57 | Comando de salida | uint8 | Almacenado; significado sin confirmar |
El zero-log-parser original decodificó este registro primero, el 20 de septiembre de 2026, y lee el nombre, los indicadores, la frecuencia, el id CAN, la versión y el número de serie en estos mismos bytes; la salida en continua, la tensión y la corriente de alterna y el techo de carga son de este decodificador. Donde los dos leen un byte coinciden en los 119 registros.
Cola llena (0x4F): al firmware se le acabó el sitio para un mensaje
Un 0x4F mide 31 bytes: la cabecera, un nombre de cola de 10 bytes rellenado con nulos y dos valores uint32. Se escribe cuando una tarea del firmware intenta publicar un mensaje en una cola FreeRTOS que ya está llena. El mensaje se descarta, y este registro es el firmware diciéndolo. Aquí hay dieciocho, en cuatro de los diez archivos nativos de la placa principal, y todos nombran una cola CAN: CAN2txQ once veces, CAN1txQ seis y CAN0RxQ una. En estas motos una cola llena es congestión del bus CAN.
El primer valor es constante en cada cola (64 para CAN1txQ, 16 para CAN2txQ y 48 para CAN0RxQ) y parece la capacidad de la cola. El segundo varía, de 46 a 76 en CAN2txQ y de 735 a 79.252 en CAN1txQ. Ninguno de los dos significados está confirmado, así que se publican con nombres neutros, como hace el zero-log-parser original.
Lo que puede leer el usuario: un registro es un mensaje descartado, no un fallo, y nada en el cuadro le corresponde. Lo que cuenta es la repetición: la misma cola desbordándose en cada recorrido, o desbordamientos agrupados en torno a una carga o a un fallo, dice qué bus estaba sobrecargado, y cuándo.
| Nombre de la cola | Visto aquí | Función probable (deducida, no declarada por el firmware) |
|---|---|---|
| CAN0RxQ, CAN1RxQ, CAN2RxQ | CAN0RxQ una vez | Mensajes recibidos en el bus CAN 0, 1 o 2 |
| CAN1txQ, CAN2txQ | CAN1txQ 6, CAN2txQ 11 | Mensajes en espera de enviarse por el bus CAN 1 o 2 |
| logQ | — | Entradas en espera de escribirse en este log |
| dashQ | — | Mensajes para el cuadro de mandos |
| uarttxQ, uartrxQ | — | Un puerto serie, de salida y de entrada, probablemente la consola de diagnóstico |
| pduQ | — | Una unidad de distribución de potencia, si PDU significa lo que suele significar |
| lssQ | — | CANopen Layer Setting Services, que asigna id de nodo en el bus (el mismo LSS que da nombre a la línea de log que libera el id de nodo de un cargador) |
Los once nombres son los del zero-log-parser original, que decodificó este registro primero, el 20 de septiembre de 2026. Solo los nombres de la columna central se midieron aquí; cada función de la última columna es una deducción a partir de un nombre.
[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 unconfirmedRótulo de compilación del firmware (0x32): qué software corría y si cambió
El tipo 0x32 es un rótulo de compilación del firmware. Usa la disposición de registro antigua (sin microsegundos, secuencia ni byte de desfase, con la carga útil desde el byte 7 del registro), y sus cuatro bytes de tiempo contienen un número pequeño relativo al arranque, no una fecha. En este corpus los 59 están en 32 archivos de placas principales de plataforma Gen2: 31 de ellos son volcados de la variante 538XX, los que se enrutan a la ruta Gen3 de la placa principal, y ninguno es un búfer circular Gen3 nativo.
Tras un byte de significado desconocido, la carga útil es un sello de compilación de un compilador de C (mes, día, año y hora, como los imprimen __DATE__ y __TIME__), seguido, opcionalmente, de un número de compilación y de un banco de flash, "banka" o "bankb", cada uno terminado en nulo. Aquí 54 registros llevan los tres (una carga útil de 32 bytes) y 5 solo la fecha (22 bytes); el zero-log-parser original lista además formas de 31 y 38 bytes. Los bancos se reparten en 45 "banka", 9 "bankb" y 5 sin nombre, y las compilaciones se hicieron entre 2019 y 2024.
Lo que puede leer el usuario: qué compilación de firmware ejecutó la placa principal mientras se escribía el búfer, y si cambió. Un archivo que nombra más de una compilación abarca una actualización (11 de los 32 archivos de aquí lo hacen), y el decodificador lista cada compilación en el orden del archivo, con cuántos registros la anunciaron. Dos nombres de banco sugieren un esquema de flash A/B, en el que una actualización se escribe en el banco que no se está usando; es una deducción a partir de los nombres. Los números de compilación y las fechas acotan una moto a una población pequeña, así que esta página no los imprime.
[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 bankEl zero-log-parser original decodificó este registro primero, el 15 de septiembre de 2026. El decodificador de aquí aplica la misma regla estructural: la fecha debe interpretarse y cada campo final debe ser ASCII imprimible, o el registro se rechaza en lugar de nombrarse a medias.
La disposición del registro depende de la fecha del firmware, no del número de pieza
Esta es la trampa que más tiempo le costará a quien implemente esto por su cuenta. La misma moto puede escribir disposiciones de registro distintas en momentos distintos, y el número de pieza del MBB no cambia con ello.
Una SR/F de 2021 con el número de pieza del MBB 40-08155 produjo una exportación de 2023 con 190 registros de tipo 0x51 con longitudes declaradas de 71, 72 y 74 bytes, más 31 registros de tipo 0x48, 30 de tipo 0x53 y 8 de tipo 0x49, y ningún registro 0x54. El mismo VIN y el mismo número de pieza produjeron una exportación de 2026 con 151 registros de tipo 0x51 de 75 y 76 bytes, 151 de tipo 0x54, y ninguno de 0x48, 0x49 ni 0x53. Una actualización de firmware cambió el conjunto de registros y su tamaño mientras la cabecera seguía informando 40-08155.
La consecuencia práctica: un decodificador debe basar su mapa de campos en la longitud declarada del registro, no en el número de pieza, el modelo ni el año. Pero esta página sacó antes una segunda conclusión, equivocada, de la misma tabla: que una longitud uno o dos bytes por encima de la nominal (76 en lugar de 75, o 30 en lugar de 29) es una deriva de firmware y es inocua. No es ninguna de las dos cosas. Son registros con escape, y L menos el número de escapes cae en la longitud canónica sin una sola excepción en el corpus. La distinción se puede comprobar. En los nueve archivos MBB nativos hay 69 registros 0x51 de más longitud, y 56 de ellos llevan su token de estado un byte tarde, en el byte bruto 43, que es exactamente lo que hace un escape sin respetar; los otros 13 llevan más de uno y están desplazados más. (Una versión anterior de esta página decía 81 y 71. El 81 mezcla los 12 registros 0x52 de más longitud en el recuento de 0x51, y el 71 no se reproduce con ninguna convención de encuadre probada.) Quita el escape primero y el token cae en el byte 42 en 1.347 de 1.356 registros con los ocho tokens del decodificador, y en los 1.356 una vez contados REV y PARK.
| Archivo exportado | Modelo | Pieza MBB | Longitudes en disco del 0x51 (de ellas con escape) | 0x54 presente |
|---|---|---|---|---|
| 2021-09 (resto de 16 kB) | SR/S | 40-08198 | 71 (32, 0 con escape), 72 (11, 11), 73 (2, 2) | no |
| 2023-04 | SR/F | 40-08155 | 71 (177, 0), 72 (12, 12), 74 (1, 1) | no |
| 2025-10 | DSR/X | 40-08285 | 75 (142, 0), 76 (5, 5) | yes |
| 2025-12-29 | SR/F | 40-08155 | 75 (220, 0), 76 (19, 19) | yes |
| 2025-12-31 | SR/S | 40-08198 | 75 (152, 0), 76 (2, 2) | yes |
| 2026-01-01 | SR/S | 40-08198 | 75 (147, 0), 76 (3, 3) | yes |
| 2026-01-21 | DSR/X | 40-08285 | 75 (130, 0), 76 (1, 1) | yes |
| 2026-02-07 08:53 | SR/F | 40-08198 | 75 (143, 0), 76 (6, 6) | yes |
| 2026-02-07 14:37 | SR/F | 40-08155 | 75 (144, 0), 76 (7, 7) | yes |
Los nueve archivos MBB Gen3 nativos, con encuadre por cadena de longitudes. Lee el par entre paréntesis como (registros con esa longitud en disco, de ellos con al menos un escape 0xFE). Toda longitud por encima de la nominal lleva escape en el 100 % de sus registros y toda longitud nominal está libre de escapes en el 100 %, y ese es el punto: 76 no es una variante de firmware de 75, es 75 más un byte de escape. Una versión anterior de esta tabla listaba seis archivos y subestimaba cinco de los recuentos con escape.
La variante de firmware 538XX: un formato de registro conocido y una trampa de enrutado
Algunas motos con VIN de prefijo 538XX (históricamente Gen2, y rechazadas sin más por el veto previo a Gen3 por el modelo, por el código de año del VIN o por ambos) pasaron con una actualización de firmware a un cuerpo MBB que es un búfer circular de flash de registros 0xB2 con prefijo de longitud. El archivo parece Gen2 por fuera y Gen3 por dentro. Eso es cierto y es la razón de que exista esta sección.
Lo que esta página decía a continuación es falso. Decía: "Before a purpose-built decoder existed, neither path could read it. The Gen2 text parser decoded every record to an empty Board Status row and produced zero usable entries." Estos archivos nunca fueron ilegibles. El registro 0x2c es el registro Riding Status corriente del zero-log-parser original, que se despacha desde 2015 y cuya tensión de pack uint32 en milivoltios se lee desde 2020. Ejecuta el parser original sobre uno de estos archivos, como hizo este sitio en julio de 2026, y termina sin errores con 7.629 entradas, entre ellas 2.048 filas Riding totalmente estructuradas con cuentakilómetros, tensión de pack, RPM, corriente de la batería y temperatura ambiente.
Lo que falló fue el enrutado, dentro de este proyecto. El cargador Gen3 nativo solo exige el ASCII "MBB" en algún punto de los primeros 32 bytes y al menos diez bytes 0xB2, y ambas cosas se cumplen trivialmente en un archivo 538XX, cuya cabecera es literalmente "MBB\0". Devuelve miles de entradas, así que el proceso marca "Gen3 detected from binary structure" y nunca toma la ruta JSON Gen2 del parser original. Nueve de los catorce archivos de este corpus acabaron con cero recorridos por eso; los otros cinco ya funcionaban. La corrección que salió fue un decodificador, aunque el fallo estaba en el enrutador. Antes de concluir que la biblioteca original no sabe tratar un formato, comprueba si ya lo hace.
La variante sigue siendo una excepción documentada a la regla con la que abre esta especificación, y sus registros siguen mereciendo un mapa de campos, porque un decodificador en producción lee sus canales eléctricos. Llevan tensión de pack, corriente de la batería, corriente del motor, cinco temperaturas, SOC, RPM del motor y un cuentakilómetros. No llevan velocidad en carretera. Cuando se adopta la decodificación, el informe se reclasifica como generación 3 y sus entradas se pasan sin cambios al detector de recorridos Gen3 existente.
Detección: una firma de cabecera y una puerta por resultado
La firma se lee de los bytes del archivo, no del VIN: los bytes 0 a 3 son el ASCII "MBB" más un nulo, y los bytes 38 a 41 son A1 A1 A1 A1, seguidos en los archivos reales de una fecha de compilación en ASCII.
Los archivos MBB Gen2 genuinos comparten exactamente esa firma, así que por sí sola no discrimina. Por eso la sonda ejecuta primero la decodificación completa y adopta el resultado solo si supera un umbral: al menos 10 entradas de cambio de estado y al menos 50 entradas de telemetría.
Esta página explicaba antes ese umbral diciendo que "real Gen2 passes the signature but writes no 0x2c telemetry records at all". Eso es rotundamente falso. Los archivos Gen2 genuinos escriben muchos: los 121 archivos con la misma firma que esta puerta rechaza contienen entre todos 137.944 registros 0x2c encadenados por longitud, 46.721 de ellos con la misma forma canónica de 40 bytes, y una muestra de 40 archivos decodifica 22.831 de 22.867 de ellos a una tensión de pack plausible con una mediana de 104.392 mV y una relación pack-celda de 28,043. El 0x2c de 40 bytes es el registro Riding Status del firmware más nuevo, presente en todo el corpus Gen2 corriente que el parser original ya interpreta.
Lo que separaba las dos poblaciones era un segundo fallo. La puerta antigua comparaba la longitud en disco con 40 y por eso no veía un registro con escape; en la mayoría de las Gen2 un campo fijado en un valor cuyo byte bajo es 0xB2 significa que todos los registros de telemetría llevan escape, así que puntuaban de 0 a 8 mientras que los archivos 538XX genuinos puntuaban de 146 a 2.353. Arreglar el escape elimina esa separación accidental: 30 de los 135 archivos con la misma firma saltan a entre 425 y 2.408 registros de telemetría. Adoptar este decodificador para ellos sería un cambio de enrutado y no una corrección de decodificación, así que la puerta de rendimiento sigue contando a propósito la población anterior a quitar el escape hasta que esa cuestión se resuelva por sí misma, y los mismos 14 archivos se adoptan antes y después. El Gen3 nativo empieza por 0xB2 y falla la firma de entrada.
La sonda se ejecuta antes de la clasificación Gen3 y no después, porque los VIN 538XX caen a los dos lados del veto: algunos se vetan hacia la ruta Gen2 y otros no se vetan y se enrutarían al decodificador Gen3 nativo.
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 == 40Lee la marca de tiempo después de quitar el escape, no antes. La secuencia de cinco bytes 06 FE 01 5D 65 aparece exactamente una vez en este corpus de 352 archivos, en un volcado de concesionario 538XX: leído en bruto, el uint32 de +3 es 0x5D01FE06, que es el 13 de junio de 2019; sin escape es 0x655DFE06, que es el 22 de noviembre de 2023. Un registro fechado cuatro años y medio antes se coloca al principio del archivo y envenena cualquier guarda de máximo móvil que venga detrás. El mismo fallo a gran escala está en el lado MBB Gen3 nativo, donde 291 de los 19.342 registros encadenados en los nueve archivos se decodifican a otra fecha una vez respetado el escape. Basar la puerta en la longitud en disco en lugar de en la longitud sin escape es la misma clase de error, y en la ruta 538XX cuesta 1.796 registros de telemetría.
Registro de telemetría (0x2c, exactamente 40 bytes)
Los desplazamientos son absolutos del registro, sobre el registro sin escape. Este mapa es la propia tabla run_status del zero-log-parser original, no algo derivado aquí; los desplazamientos de carga útil del parser original son estos menos 7. Cada canal está protegido por un rango para que los fotogramas corruptos del búfer circular se descarten en lugar de dibujarse. El decodificador calcula dos magnitudes derivadas: la potencia como V × A / 1000 y el par del eje como kW × 9549 / rpm para rpm por encima de 100, que es independiente de la reducción de una manera en que la velocidad no lo es.
| Desplazamiento | Ancho | Campo | Decodificación | Rango aceptado |
|---|---|---|---|---|
| +7 | uint8 | Temperatura alta del pack | °C | 0 < t < 80 |
| +8 | uint8 | Temperatura baja del pack | °C | 0 < t < 80 |
| +9 | uint16 LE | Estado de carga | % | 0–100 |
| +11 | uint32 LE | Tensión del pack | milivoltios, exacta | 50–130 V |
| +15 | int16 LE | Temperatura del motor | °C | 0 < t < 150 |
| +17 | int16 LE | Temperatura del controlador | °C | 0 < t < 150 |
| +19 | uint16 LE | RPM del motor | RPM; no se deriva ninguna velocidad | ≤ 8000 |
| +23 | int16 LE | Corriente de la batería | amperios enteros, descarga positiva | ±400 A |
| +25 | uint8 | Máscara de bits de presencia de módulos | 0/1/2/3 → 00/10/01/11 | ≤ 3 |
| +26 | int16 LE | Corriente del motor | amps | ±1000 A |
| +28 | int16 LE | Temperatura ambiente | °C | −50 … 70 inclusive |
| +30 | uint16 LE | Cuentakilómetros | km, de por vida, no decreciente | véase la guarda de abajo |
El cuentakilómetros es el único punto en el que este decodificador se aparta a propósito del parser original, que lee un uint32 en +30. Los dos coinciden en 19.480 de 19.516 registros. Los 36 desacuerdos se reparten en cuatro archivos, 31 de ellos en uno, y cada uno es un registro en que el byte 32 vale 2 y convierte un cuentakilómetros de 6972 km en 138.044 km, algo inverosímil para la moto y no monótono respecto a sus vecinos. El propio contador odometer_high_word_rejected del decodificador sobre los mismos archivos da 36, lo que corrobora el recuento por separado. Se mantiene la lectura uint16, al precio de dar la vuelta pasados 65.535 km; ninguna moto de este corpus se acerca.
Retractado: la calibración ajustada
Esta subsección se titulaba antes «Calibration provenance» y abría con: "None of the scale factors above was assumed. Each channel was fitted against either BMS ground truth or a physical conservation law, and the fit statistics are the reason the map is trusted." Después citaba la tensión ajustada frente a la tensión de pack del BMS con r = 0,96, la corriente validada por coincidencia de distribuciones y una escala de velocidad de 0,023323 km/h por RPM que salía de la conservación de la distancia del cuentakilómetros con r = 0,999. Las tres afirmaciones se retiran. Fue el peor error de la página, y muestra cómo un ajuste con un buen coeficiente de correlación puede estar equivocado.
Tensión. La lectura retirada era un uint16 en +12 escalado por 0,24608 con un desfase de 4,25 V. Ese uint16 son los dos bytes centrales de un entero exacto de 32 bits en milivoltios, con el byte bajo descartado: la identidad u32 en +11 igual a 256 × u16 en +12 más el byte 11 del registro se cumple en 19.513 de 19.516 registros. Ajustar una recta a un fragmento con pérdida de un número que ya tienes exacto no puede ser correcto, y no lo es: frente al valor verdadero la recta ajustada se desvía una mediana de 0,1391 V, un percentil 99 de 0,5710 V y un máximo de 0,9728 V, y supera 0,1 V en el 62,8 % de los registros. Una comprobación autónoma que no necesita referencia externa: u32 en +11 dividido por la tensión de celda en +36 tiene una mediana de 28,070, que es un pack de 28 en serie leído en milivoltios. La correlación de 0,96 era real y no informaba de nada, porque una transformación monótona con pérdida de una magnitud se correlaciona con esa magnitud por construcción.
Corriente. Esta fue peor que una aproximación. La lectura retirada era un int16 en +22 dividido entre 256, presentado como amperios Q8.8. El byte 22 del registro es un byte de relleno (cero en 19.511 de 19.516 registros), así que esa expresión se reduce algebraicamente a int8 del byte 23 del registro, una identidad verificada en los 19.516. El campo real es un int16 en +23 en amperios enteros. 487 registros (2,50 %) superan el rango int8 y 418 de ellos salían con el signo invertido, así que un arranque de +206 A se dibujaba como −50 A. El pico de descarga de cada moto quedaba recortado en unos 127 A frente a picos reales por archivo de 199 a 385 A, y subestimaba el pico entre un 37,7 % y un 70,5 %. Ese intervalo compara el pico de cada decodificador bajo su propia guarda, que es lo que habría visto un usuario; si se restringe la lectura retirada a solo los registros que acepta la guarda actual de ±400 A, pasa a ser del 37,7 % al 73,8 %.
Velocidad en carretera. En este registro no hay campo de velocidad, ni lo hubo nunca. La constante 0,023323 se ajustó a partir de la conservación de la distancia del cuentakilómetros, que es un método sólido para una constante que existe; reajustarla por archivo da de 0,02273 a 0,02504 en los 13 archivos con más de 50 km de movimiento, una dispersión de ±5,2 %, porque la relación de transmisión final y la circunferencia del neumático difieren por modelo. La constante publicada estaba entre un 6,9 % por debajo y un 2,6 % por encima según la moto. Se podría haber ajustado una tabla por modelo, pero los 14 archivos adoptados llevan siete VIN distintos y cuatro de ellos aportan un solo archivo cada uno, así que esa tabla habría ajustado ruido, el mismo error que cometió la calibración de la tensión un nivel más arriba. El decodificador publica ahora las RPM del motor, que están medidas, y ninguna velocidad derivada.
El ajuste se sustituyó por el propio mapa de campos run_status del zero-log-parser original, que despacha 0x2c desde 2015. La comprobación independiente de que es correcto es física y no estadística: sobre 483 sesiones de recorrido con al menos un 5 % de SOC gastado y al menos 2 km recorridos, la energía eléctrica integrada por cada punto de SOC pasó de 43,1 Wh/% a 50,0 Wh/%, lo que implica un pack útil de 5,00 kWh en lugar de 4,31 kWh (correcto para los packs ZF3.6 y ZF7.2 que llevan estas motos), y la energía por kilómetro pasó de 46,3 a 54,1 Wh/km frente a los 55 a 70 que publica la propia Zero. El coeficiente de variación entre sesiones bajó del 44,8 % al 39,4 %. Una corrección que lleva una estimación al valor físicamente correcto y además reduce su dispersión hace algo que una recta que ajuste mejor no puede.
El cuentakilómetros lleva su propia guarda, porque es de por vida no decreciente y el búfer circular no lo es. Cualquier lectura por debajo del máximo corrido, o cero, se rechaza y el último valor bueno se arrastra plano. Un salto hacia delante solo se acepta cuando el aumento no supera el mayor de 5 km y 200 km/h multiplicado por las horas transcurridas desde la lectura aceptada anterior. El término de cadencia evita que una telemetría escasa subcuente un hueco largo y sigue descartando fotogramas con bits cambiados.
0x2c de longitud canónica 40 que acepta el barrido de bytes en producción en los 14 archivos que superan la puerta de adopción 538XX (17.720 de ellos ya de 40 bytes en disco, 1.796 recuperados al desescapar). El panel de tensión es el decisivo, y sus estadísticas de error son sobre los 19.512 de esos registros que caen dentro de la guarda de 50–130 V del decodificador. Los cuatro de fuera son tramas corruptas que se ajustan a megavoltios, así que el máximo de 0,9728 V es una cifra con guarda y se cita frente a la población con guarda. La u16 @+12 × 0.24608 + 4.25 retirada ajustaba un trozo de 16 bits de un campo que ya es un entero exacto de milivoltios de 32 bits (u32 @+11 == 256 × u16 @+12 + rec[11] se cumple en 19.513 de 19.516 registros), de modo que una correlación de 0,96 estaba garantizada por construcción y no nos dijo nada. El panel de corriente es el que importó a los pilotos: i16 @+22 / 256 cabalga sobre un byte de relleno y se reduce algebraicamente a int8(rec[23]), recortando la descarga máxima de todas las motos en torno a 127 A. Comparando el máximo de cada lectura bajo su propia guarda (la retirada no tenía guarda de ±400 A, porque un int8 nunca puede dispararla), la subestimación va del 37,7 % al 70,5 %, la peor en 538xx8z19gcj0XX68_MBB_2025-10-26.bin, de 102,43 a 347 A. (Si se restringe la lectura antigua a los registros que acepta la nueva guarda, el rango es de 37,7–73,8 %; el primer par es lo que habría visto un piloto, así que es el par publicado.) El mapa de campos se toma ahora literalmente de la herramienta upstream zero-log-parser, cuya tabla run_status despacha 0x2c desde 2015.Retirado: raw × 0.24608 + 4.25, corriente Q8.8 y rpm × 0.023323
Si montaste un decodificador 538XX con la versión anterior de esta tabla, tres de sus canales están mal. Sustituye la tensión uint16 en +12 por el entero uint32 en milivoltios en +11. Sustituye la corriente Q8.8 en +22 por el campo int16 en amperios enteros en +23, que es el que deja de invertir el signo de tus aceleraciones fuertes. Y borra la velocidad derivada: el registro no tiene campo de velocidad, y la constante que publicamos se desvía hasta un 7 % en un sentido que depende del modelo. Las RPM del motor en +19 son la magnitud medida.
Eventos de estado (0xFD) y por qué la carga sigue en manos del BMS
Este firmware no escribe ninguno de los tokens de estado binarios del Gen3 nativo. El estado se deriva de eventos de texto ASCII cuya carga útil empieza en el byte 7 del registro y no en el 13, y se arrastra por marca de tiempo a los registros de telemetría siguientes.
La carga no se detecta a propósito en esta ruta. El MBB 538XX no lleva telemetría de carga, y sus eventos del contactor del cargador se disparan varias veces dentro de una misma carga, lo que fragmenta una carga real en decenas de marcadores sin datos. Por eso el decodificador no emite ninguna sesión de carga del MBB y deja la detección de la carga entera al BMS.
| Texto del evento, sin distinguir mayúsculas | Estado derivado |
|---|---|
| Module scheme changed from … to Running mode | RUN |
| Module scheme changed from … to Stopped mode | STOP |
| Module scheme changed from … to Charging mode | CHRG |
| Entering charge standby | CHRG |
| Leaving charge standby | STOP |
Qué recuperó arreglar el enrutado
Las cifras de antes y después son resultados reales del proceso y merece la pena conservarlas, siempre que se etiqueten por lo que miden. Dos motos 538XX pasaron de nada a un historial completo: una de 0 recorridos y 0 km a 112 recorridos y 678 km, la otra de 0 a 88 recorridos y 423 km. En la misma ejecución, los archivos Gen3 nativos y los Gen2 genuinos produjeron una salida idéntica byte a byte, así que la nueva ruta no introdujo ninguna regresión en los formatos que ya funcionaban.
Esas cifras miden que un archivo llega por fin a un decodificador. El parser original ya podía leer estos registros; las entradas se perdían por la anulación por estructura binaria que se describe al principio de esta sección. Lee las cifras como el coste de un fallo de enrutado, no como prueba de que se descifró una nueva disposición de registro.
Sí se sostiene una segunda defensa de la ruta hecha a medida, y es más estrecha que la afirmación original. En los cinco archivos que llegaron a la ruta Gen2 del parser original, su detector de sesiones fragmenta en exceso (546 recorridos en 602 km, unos 1,1 km por «recorrido», frente a 131 recorridos y 491 km aquí), y las guardas físicas de este proyecto rechazan alrededor del 0,24 % de las filas del parser original por imposibles. Así que la lógica de sesiones y las guardas se ganan su sitio. El decodificador de registros no hacía falta escribirlo; solo había que arreglar el enrutador.
Se confirmó que la unidad del cuentakilómetros son kilómetros, no metros, por continuidad con las lecturas históricas del cuentakilómetros Gen2 de las mismas motos. El contrato del formato y el discriminador están fijados por pruebas automáticas, así que un cambio futuro que rompa cualquiera de los dos hace fallar la compilación en lugar de devolver en silencio estas motos a cero recorridos.
Por qué el umbral es un resultado y no una firma
La detección por firma fallaría con todos los archivos Gen2 genuinos, porque los bytes de cabecera son idénticos. Ejecutar la decodificación y juzgar el resultado es más caro, pero se creía a prueba de falsos positivos. No lo es: el poder de discriminación de la puerta de rendimiento venía de un fallo del decodificador al que daba paso, así que arreglar el escape eliminó la separación. La puerta cuenta ahora a propósito una población anterior a quitar el escape que sabe que es un artefacto, porque cambiarla movería en silencio 30 archivos a otro decodificador. Cuando un umbral funciona, comprueba si está midiendo lo que crees que mide.
Tipos de registro del BMS Gen3
Un archivo BMS Gen3 exportado desde la app de Zero mide 131.328 bytes, exactamente 128 bytes más que el archivo MBB, por una razón que se explica más abajo en las marcas de página de flash. Las exportaciones de concesionario miden 262.144 bytes. Los nombres de archivo aparecen como VIN_BMS.bin, VIN_BMS0.bin, VIN_BMS1.bin, VIN_BmsD0_*.bin o VIN_10.bin según la vía de exportación.
Esta es la placa que importa para los datos eléctricos. Todo lo que la aplicación muestra de una moto Gen3 nativa (tensión de pack, corriente, potencia, dispersión de celdas, estado de carga, energía de carga) se origina en los registros de abajo.
| Tipo | Nombre | Tamaño | Recuento por archivo | Total en el corpus | Contenido |
|---|---|---|---|---|---|
| 0xFB | Cabecera | 125 B | 1 | 7 | Tipo de placa, número de pieza, número de serie, cellbox, firmware |
| 0xFD | Evento de texto | variable | 1.596–1.997 | 13.178 | Transiciones de estado, fallos, diagnósticos |
| 0x4B | Telemetría | 52 B | 186–527 | 1.803 | Tensiones de celda, corriente, SOC, tensión de pack, estado |
| 0x4D | Telemetría ampliada | 78 B | 79–126 | 691 | Los campos del 0x4B desplazados +8, más el registro de capacidad de carga completa |
| 0x4C | Detalle de celdas | 70 B | 0–65 | 84 | Los campos del 0x4B desplazados +4; se escribe durante los periodos de funcionamiento |
| 0x00 / 0xF0 | Parcial o de depuración | variable | 12–28 | 127 | Artefactos de sobrescritura del búfer circular y depuración del firmware |
Los siete archivos contienen 15.890 registros encadenados por longitud entre todos, de cinco VIN distintos, y las seis filas de arriba los explican todos; la fila de cabecera son los siete registros 0xFB, uno por archivo. Contados de otra manera, los mismos siete archivos dan 16.005 delimitadores 0xB2 en bruto y 15.998 registros con encuadre por huecos, que es lo que publica la página del búfer circular; son tres convenciones sobre un mismo conjunto de bytes, no tres mediciones en desacuerdo. Cinco bytes de tipo sueltos (0x78 dos veces, y 0x6B, 0x6C y 0x76 una vez cada uno) se suman a la fila parcial o de depuración y son demasiado raros para caracterizarlos. Ten en cuenta que un 0x4C es un registro de 70 bytes y 70 no está en la lista de despacho por huecos que usa cualquier decodificador que mire primero la longitud, que es exactamente la razón de que todos fueran al parser de texto hasta que llegó el despacho por tipo.
Registro de cabecera (0xFB, 125 bytes)
Uno por archivo. La cabecera del BMS identifica la placa de control de la batería y no la moto, por eso es el sitio donde mirar cuando se ha cambiado un pack.
[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 hashRegistro de evento de texto (0xFD, variable)
La misma estructura que el registro de texto del MBB: la cabecera común de 13 bytes y después ASCII terminado en nulo desde el byte 13 del registro. Esta página decía que el BMS se diferencia por un "board marker" de 0x01 en el byte 12 donde el MBB tiene 0x02; el byte 12 es el ajuste de desfase UTC, y los dos valores eran las zonas horarias de dos motos. Estos eventos son la señal de más confianza de cuándo se encendió la moto, y por eso son imprescindibles para detectar sesiones.
El decodificador no sabía dónde empieza el texto hasta 2026-10. Tomaba "el primer byte imprimible en el byte 7 o después", así que cuando un byte de subsegundo, de secuencia o de desfase resultaba imprimible el texto empezaba ahí, y se detenía en el siguiente cero, que en una moto con UTC+0 es el propio byte 12. De los 13.522 registros de texto del BMS en ocho archivos con la cabecera intacta y una marca de tiempo plausible, 4.268 (31,6 %) salían bien, 7.234 (53,5 %) se descartaban por "demasiado cortos" (7.025 de ellos con texto real como "Entering ZERO_BMS_STATE_IDLE") y 1.890 se publicaban como basura del tipo "Po\x0e", con 130 más que llevaban un prefijo basura. El byte 13 es imprimible en 8.786 de los 8.788 registros de texto del BMS que ninguna marca de página tocó, y en 18.570 de 18.570 registros de texto del MBB. Solo el tipo 0xFD es texto: cualquier otro registro que llegaba al parser de texto (un registro de telemetría de longitud equivocada, un registro cuyo byte de tipo había sobrescrito una marca de página) se escarbaba en busca de bytes imprimibles y se publicaba como "evento", y ya no. La corrección más que duplica los eventos de la máquina de estados que da un archivo, y mejora la detección de recorridos del BMS: los recorridos partidos vuelven a unirse en el único recorrido que registró el MBB.
Todo eso es la disposición de registro FST, y el decodificador comprueba ahora por archivo, a partir de los bytes, si la tiene antes de aplicar nada de ello. Al mismo decodificador le llegan también archivos que no son FST en absoluto (volcados del BMS con forma Gen2 y exportaciones raras que la sonda de telemetría 0xB2 encamina aquí), y en sus registros el texto sí empieza en el byte 7. En esos, la regla del byte 13 cortaba seis caracteres de cada mensaje ("DEBUG: CAN Link Is Down" pasaba a "CAN Link Is Down") y descartaba los registros que quedaban demasiado cortos. Un archivo cuenta como FST cuando la marca de página abre su segunda y su tercera página o, si no, cuando la palabra de subsegundo es como mucho 1.000.000 en al menos el 80 % de sus registros y el byte 12 se lee como un único desfase UTC civil dominante; medidas sobre 374 archivos, las dos poblaciones quedan muy separadas (al menos 0,97 frente a como mucho 0,16 en la primera prueba). Todo lo demás conserva exactamente la regla original.
Un registro de texto que atravesó una marca de página es un prefijo de lo que escribió el firmware, porque la marca empieza con un byte cero y ahí termina la cadena. Se conserva y se marca como truncado, y no se fía de un patrón que capture hasta el final de él: "Entering ZERO_BMS_STATE_HIB" cortado no es el estado HIB.
- "Entering ZERO_BMS_STATE_OPERATIONAL": se encendió la moto.
- "Entering ZERO_BMS_STATE_IDLE": se apagó la moto.
- "Entering ZERO_BMS_STATE_HIBERNATE", "…_STANDBY", "…_PRECHARGE", "…_UNLOCK": los demás estados.
- "Precharge complete" y "Precharge: 95%": avance de la precarga del contactor.
- "Contactor open command received", precedido de un recuento de milivoltios de celda.
- "Fault set: INVALID/NO CELL TYPE": un error de CRC al leer la caja de celdas (cellbox).
- "Saving stats, hibernating for 86400 sec": el intervalo de sueño del BMS, normalmente un día y no la hora del MBB.
payload[24] (record[32]) se guarda como LogEntry.bms_state_code y ningún código se bifurca según él; tasks.py solo lo agrupa en una distribución por informe. docs/GEN3_BINARY_FORMAT.md asignó una vez cuatro de sus valores a una máquina de estados (0x0B reposo, 0x09 desbloqueo, 0x0A precarga, 0x0C activo), y esa lectura se ha retractado; el documento lleva ahora la retractación y el docstring de parser.py dice con todas las letras que no se vuelva a publicar. Esta figura lo dibujaba, con flechas y todo. Lo que sobrevive a la remedición es más débil y unidimensional: la fracción bajo carga sube de forma aproximadamente monótona a lo largo de al menos ocho códigos, y dos valores que la enumeración nunca nombró, 0x10 (n = 111, 62,2 % bajo carga) y 0x0F (n = 54, 40,7 %), están dentro de esa cadena, con 0x10 por encima de 0x0C. Por tanto el orden va en contra de tratar cualquiera de los cuatro como un estado con nombre. Remedido sobre las 2.319 filas de telemetría que emite el decodificador en producción a partir de los 7 volcados BMS Gen3 de logs/: se parte en cada 0xB2, se desescapa cada trozo, se despacha según el byte de tipo con la longitud desescapada como comprobación cruzada (0x4C → +4, 0x4D → +8, en otro caso la regla de longitud 50/52/78 en +0), y luego se aplica la puerta de celdas de 2.500–4.500 mV. La figura llevó una tabla de 1.557 filas hasta el 2026-07-30; 1.557 es lo que emitía este decodificador antes de la corrección del escape y del despacho por tipo, así que cada recuento se ha vuelto a derivar y no se ha reescalado. Trata el byte como una pista de actividad opaca según el firmware, no como una decodificación.Registro de telemetría (0x4B, 52 bytes): la fuente de datos principal
Los desplazamientos de carga útil de abajo son relativos al inicio de la carga útil, en el byte 8 del registro, según la convención que usa el decodificador. Para pasar a absolutos del registro, suma 8: payload[38] es record[46].
El decodificador valida antes de fiarse. Las tensiones de celda fuera de 2.500 a 4.500 mV hacen que se descarte todo el registro por corrupto, que es también lo que rechaza los eventos de texto que caen a veces en un hueco del tamaño de un registro de telemetría. El SOC solo se acepta de 1 a 100; un cero significa dormido o no calculado, no vacío.
0x4B de 52 bytes es el único canal eléctrico por muestra que produce una moto Gen3 nativa. Los desplazamientos son absolutos del registro; el decodificador lee una carga útil de 44 bytes que empieza en el byte 8 del registro, de modo que payload[k] == record[8+k]. El record[46:49] resaltado (payload[38:41]) llevaba el comentario «contador interno ~43000-49000» que «misteriosamente caía bajo carga». Cae porque es la tensión del pack. Remedido aquí en los 7 volcados BMS Gen3, sobre las 2.319 filas de telemetría que emite el decodificador en producción: 2.189 de 2.319 (94,4 %; por archivo 92,1–96,5 %) cumplen 28 × cell_min ≤ valor ≤ 28 × cell_max, que es exactamente la envolvente de aceptación que _parse_gen3_bms_entries usa ahora antes de recurrir a 28 × media(cell_low, cell_high). Esta cuadrícula es el formato 0x4B y nada más. Un 0x4D comparte solo la cabecera de 13 bytes y luego inserta 8 bytes; un 0x4C inserta 4. Probando desplazamientos candidatos y comprobando si las palabras de celda caen en una banda verosímil de 2.500–4.500 mV, un 0x4D puntúa 0 con estos desplazamientos y 619 de 666 con +8, y un 0x4C puntúa 0 aquí y 75 de 78 con +4. Aplicado a un registro extendido, este mapa da valores que una comprobación de sensatez descarta en silencio, no valores ligeramente erróneos. Eso costó aquí 694 filas de telemetría, el 42,7 % de la población, antes de que se encontrara el desplazamiento. (La cifra antigua de 1.557 filas, todavía en circulación, es lo que emitía este decodificador antes de esa corrección y antes de la corrección del escape; 1.557 → 1.625 → 2.319.)| payload[9] | Filas | Modo de informe 3 (sueño) | SOC = 0 | Indicador de carga 0x78 | |Corriente| media |
|---|---|---|---|---|---|
| 0x00 | 1.057 | 57 (5,4%) | 19 (1,8%) | 590 (55,8%) | 3.869 mA |
| 0x20 | 517 | 427 (82,6%) | 517 (100%) | 504 (97,5%) | 40 mA |
| 0xF0 / 0xFF | 24 | 6 (25,0%) | 6 (25,0%) | 14 (58,3%) | 3.356 mA |
La población son los 1.598 registros 0x4B dentro de las 2.319 filas de telemetría que emite el decodificador en producción, porque payload[9] solo está en este desplazamiento en un 0x4B; en un 0x4D está ocho bytes más allá y en un 0x4C cuatro. Cada una de las 517 filas con payload[9] = 0x20 tiene SOC = 0, el 97,5 % no tiene carga, y su corriente media es de 40 mA frente a los 3.869 mA de las filas con 0x00. 0x20 es el valor de dormido y 0x00 es despierto. La documentación interna decía la polaridad contraria; el código y la medición coinciden entre sí y la documentación está equivocada. 0xF0 y 0xFF son centinelas de flash, no estados. Una versión anterior de esta tabla decía 1.022 / 511 / 24 y se contó antes de la corrección del escape de 2026-07-29.
| Valor | Significado | Filas | Proporción |
|---|---|---|---|
| 1 | Informe estándar de SOC | 522 | 32,7% |
| 3 | Sueño / mínimo | 490 | 30,7% |
| 7 | Activo de alta frecuencia, carga o descarga | 437 | 27,3% |
| 4 | Inactivo | 31 | 1,9% |
| 5 | Precarga | 29 | 1,8% |
| 6 | Desconocido | 28 | 1,8% |
| 0 / 240 / 255 | Sin inicializar o centinela de flash | 61 | 3,8% |
Este byte es payload[37], que es el byte 45 del registro en un 0x4B. A veces se cita como "byte 37 de cada entrada del BMS", lo que apunta al byte equivocado. La población son las 1.598 filas 0x4B, porque es el único tipo de registro en el que payload[37] y el byte 45 del registro son el mismo byte; un 0x4D escribe su modo en el byte 53 del registro. Seis valores reales más los centinelas explican todas las filas 0x4B y, a diferencia de payload[24] más abajo, este sí se comporta como un enum. En las 2.319 filas emitidas, leído en el desplazamiento desplazado propio de cada tipo, la mezcla es 7 en 592, 1 en 530, 2 en 520, 3 en 500, 4 en 31, 5 en 30, 6 en 28 y un centinela en 88. El valor 2 viene entero del 0x4D.
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 belowpayload[24] no es un código de estado: una retractación
La corriente del pack es el mayor error de medición que ha tenido que corregir esta página. Se leía como un valor de 16 bits con signo en miliamperios, que tiene un tope de ±32,767 A. Un pack de Zero entrega varios cientos de amperios al acelerar, y como nada lo limita, el valor guardado daba la vuelta en lugar de recortarse: contenía la corriente real módulo 65.536 mA, lo que invierte el signo en lugar de aplanar el pico. Por eso el sentido registrado era casi una moneda al aire al rodar: 55,5 % de descarga, frente al 78,4 % del propio log MBB de la misma moto en los mismos recorridos.
Es un valor de 32 bits, y los dos bytes que esta página describía como un indicador de carga del firmware son su mitad alta. En los 72 archivos BMS Gen3 nativos de producción, 45.060 registros de telemetría: esos bytes valen FF FF en el 80,5 % de los registros cuya mitad baja es negativa y 00 00 en el 84,9 % de los que tienen la mitad baja positiva. Eso es una extensión de signo. El indicador era real en el sentido de que se activaba durante la carga, pero no por la razón que se daba: FF FF es el aspecto de un número negativo, y las corrientes de carga son negativas.
Tres comprobaciones, cada una contra su propia hipótesis nula. Conteo de culombios contra el propio estado de carga del pack: en 84 segmentos contiguos el signo de la corriente integrada coincide con el sentido del cambio de SOC en 83 de 84 con la lectura de 32 bits, frente a 49 de 84 con la de 16 bits, donde el 50 % es la hipótesis nula de la moneda al aire. La capacidad implícita es de 138,7 Ah por cada 100 puntos de SOC (un pack ZF14.4, ZF15.6 o ZF17.3 es de 129, 139 o 154), frente a 16,8 Ah antes, que no es una moto. Y la ley de Ohm contra la tensión de pack verificada por separado da una pendiente mediana de −29,9 mΩ, negativa en 35 de 38 motos, una resistencia interna plausible para un pack de 28 en serie; la lectura antigua daba −5,6 mΩ y negativa en 20 de 38.
Una ventana de corriente ilegible produce ahora nada en lugar de cero, porque el cero se lee como un pack inactivo. Un cero genuino se conserva: es una lectura real en aproximadamente una quinta parte de todos los registros.
Este sitio publicó, y nuestras propias notas internas llevaron, un enum de cuatro valores para payload[24]: 0x0B inactivo, 0x0C activo, 0x09 desbloqueo, 0x0A precarga. Queda retirado. El byte se lee de cada registro de telemetría y se guarda tal cual, ningún decodificador actúa según su valor, y nada del corpus respalda asignarlo a los nombres de estado del BMS. Si has tomado ese enum de aquí, de una copia suya o de un decodificador construido sobre él, deséchalo.
En las mismas 2.319 filas de telemetría que emite el decodificador en producción, usadas en todo el resto de esta página, payload[24] toma 37 valores distintos: todos los valores de 0x00 a 0x23 salvo 0x02, más los dos centinelas de flash 0xF0 y 0xFF. Los cuatro códigos que nombraba el enum cubren 1.358 filas, que son el 58,6 %, así que dos filas de cada cinco tienen un valor para el que el enum no tiene nombre; y el 0x09, el estado de "desbloqueo", son 47 filas, el 2,0 % del corpus.
Se hicieron tres pruebas distintas con el byte y falló las tres. No es un contador: el 82,0 % de las diferencias consecutivas dentro de una ventana de 120 segundos son exactamente cero, 973 de 1.186, y la secuencia ni crece de forma monótona ni da la vuelta. No es una temperatura: correlacionado con payload[43] en el mismo registro da r = −0,05, y los dos bytes son iguales en el 1,3 % de las filas, aunque esa comparación concreta ahora no vale nada, porque payload[43] resultó tampoco ser una temperatura. Y no sigue la máquina de estados de texto del BMS como una partición. Arrastra cada evento "Entering ZERO_BMS_STATE_x" hacia delante en el tiempo y uno de los cuatro sí coincide con el nombre que se le dio (0x09 está bajo UNLOCK en el 62 % de las filas, n = 45), pero 0x0B no: el valor que se llamaba "inactivo" está bajo HIBERNATE en el 41 %, IDLE en el 26 % y UNLOCK en el 14 %. Una coincidencia de cuatro es el aspecto de un enum de cuatro estados cuando está equivocado.
La única propiedad que sobrevive es débil y no es un enum. Ordenado por la fracción de filas que están bajo carga, el byte se ordena como un indicador aproximado de actividad sobre al menos ocho valores, pero dos valores que el enum nunca nombró, 0x10 con un 62,2 % bajo carga y 0x0F con un 40,7 %, están dentro de la misma cadena que el enum usaba como prueba, uno de ellos por encima del supuesto código "activo". Una máquina de cuatro estados no puede tener estados sin nombre entre sus estados.
payload[24] es un byte interno del firmware que varía con la actividad, tiene al menos 37 valores y no tiene significado decodificado. Trátalo como opaco, y no escribas "0x0B = inactivo, 0x0C = activo" en ningún sitio sin volver a derivarlo antes de tus propios archivos.
| Valor | Filas | Proporción | Bajo carga | Lo que afirmaba el enum |
|---|---|---|---|---|
| 0x0B | 603 | 26,0% | 14,4% | idle |
| 0x0C | 566 | 24,4% | 45,2% | active |
| 0x0A | 142 | 6,1% | 34,5% | precharge |
| 0x0D | 131 | 5,6% | 16,0% | unnamed |
| 0x10 | 111 | 4,8% | 62,2% | unnamed |
| 0x0F | 54 | 2,3% | 40,7% | unnamed |
| 0x12 | 52 | 2,2% | 15,4% | unnamed |
| 0x14 | 51 | 2,2% | 3,9% | unnamed |
| 0x09 | 47 | 2,0% | 74,5% | unlock |
| 0x11 | 41 | 1,8% | 12,2% | unnamed |
| 0x00 | 40 | 1,7% | 12,5% | unnamed |
| 0x08 | 39 | 1,7% | 35,9% | unnamed |
| 0x13 / 0x16 / 0x17 | 106 | 4,6% | 2.7% / 5.9% / 2.9% | unnamed |
| 0x06 | 36 | 1,6% | 13,9% | unnamed |
| 0x15 / 0x18 | 60 | 2,6% | 3.3% / 0.0% | unnamed |
| 0x07 | 29 | 1,3% | 20,7% | unnamed |
| 0x0E | 26 | 1,1% | 7,7% | unnamed |
| 0x05 | 25 | 1,1% | 12,0% | unnamed |
| 0xF0 / 0xFF | 43 | 1,9% | 10.5% / 29.2% | centinelas de flash |
| 14 valores más, cada uno con menos de 20 filas | 117 | 5,0% | 0–33% | unnamed |
Todos los valores observados en el corpus están listados o incluidos en la última fila; no se omite nada por ordenar, y las filas suman 2.319. "Bajo carga" es la fracción de filas de ese grupo con payload[27] = 0xFF, leída en el desplazamiento desplazado propio de cada tipo de registro, la misma definición que usa la figura de arriba, de modo que las dos coinciden fila a fila. El orden por esa columna es la única estructura del byte, y es un continuo sobre al menos ocho valores, no cuatro estados. Una versión anterior de esta tabla se contó sobre 1.557 filas, la población que emitía este decodificador antes de la corrección del escape y el despacho por tipo de 2026-07-29; cada recuento cambió, así que se volvieron a derivar todos en lugar de reescalarlos.
Retirado: el enum de estados 0x09–0x0C
La correspondencia 0x0B inactivo / 0x0C activo / 0x09 desbloqueo / 0x0A precarga se publicó en este sitio y es incorrecta. Cubre el 58,6 % de las 2.319 filas de telemetría que emite el decodificador en producción, no supera una prueba de contador ni una de temperatura, coincide con la máquina de estados de texto en uno de sus cuatro valores y no en los cuatro, y está intercalada con valores sin nombre que se comportan igual. La máquina de estados del BMS es real, pero vive en los eventos de texto ASCII, no en este byte.
Telemetría ampliada (0x4D, 78 bytes) y el desplazamiento de +8
Esta página decía "los primeros 52 bytes de un registro 0x4D tienen una disposición idéntica a la de un registro 0x4B". No es así, y es el único error de mapa de campos con más probabilidad de costarle un día a quien implemente esto por su cuenta. Un 0x4D comparte solo la cabecera de 13 bytes. Después inserta ocho bytes, así que cada campo de medición está ocho bytes más allá que su posición en el 0x4B, y los "26 bytes extra" que describía esta sección son los últimos 26 bytes de una carga útil desplazada y no un sufijo añadido a una sin desplazar.
La medición es inequívoca. Barriendo desplazamientos candidatos de 0 a 12 y comprobando si las dos palabras de tensión de celda caen entre 2.500 y 4.500 mV, sobre los registros de longitud exacta de siete archivos BMS Gen3: un 0x4B puntúa 1.598 de 1.732 con desplazamiento 0 y como mucho 14 en cualquier otro; un 0x4D puntúa cero con desplazamiento 0 y 619 de 666 con +8, y el siguiente mejor desplazamiento puntúa 2; un 0x4C puntúa cero con desplazamiento 0 y 75 de 78 con +4, y el siguiente mejor puntúa 3. Los denominadores cambian unos pocos registros según cómo se recorra el archivo (un recorrido por cadena de longitudes de los mismos volcados da 624 de 671), pero la fracción es del 92,9 % de cualquier forma que la hayamos contado, y la puntuación en los desplazamientos del 0x4B es cero de cualquier forma. El cero en los desplazamientos nominales es el número importante: un decodificador que use el mapa del 0x4B en un 0x4D falla por completo en lugar de degradarse, y si tiene una comprobación de cordura de tensión de celda descartará todos los registros en silencio.
Cuatro corroboraciones del +8 que no tocan para nada la puerta de celdas que seleccionó esos registros. El uint24 en record[54:57] es la tensión de pack que el 0x4B escribe en record[46:49], con una mediana de 104.793 mV, dentro de la envolvente de 28 celdas en 578 registros, una relación pack-celda baja con mediana de 28,020, y celda baja no mayor que celda alta en 619 de 619. El byte 59 del registro se comporta exactamente como el byte del registro 51 de un 0x4B (el byte que esta página publicó una vez como temperatura, y que no lo es; véase el recuadro de abajo): mediana de 10 frente a 13 en el 0x4B, y un rango de 0 a 27 una vez apartadas las 14 filas con un centinela de flash 0xF0 o 0xFF; en bruto el rango es el completo de 0 a 255, que es lo que hace un centinela con un campo de enteros pequeños. Los bytes 51 y 52 del registro son cero cada uno en 603 de 619 y los dos cero en 594, lo que refleja los dos rellenos de cero que flanquean el byte de modo de informe del 0x4B. Y el indicador de carga, el byte de bus acoplado y el modo de informe coinciden entre sí y no con nada externo, aunque no a la perfección: de los 72 registros con carga 0xFF, 68 también tienen el bus acoplado y 67 leen modo de informe 7; de los 527 con carga 0x78, 502 leen modo de informe 2. El modo de informe 2 aparece en 520 filas en total, así que los dos conjuntos casi coinciden pero no exactamente.
Ese último número es un pequeño hallazgo por sí mismo. El modo de informe 2 es un valor que el registro 0x4B nunca escribe, así que el enum tiene siete valores, no seis: 1, 3, 4, 5, 6 y 7 del 0x4B más el 2 del 0x4D.
El coste del desplazamiento, antes de descubrirlo, fue que se descartó toda fila de telemetría 0x4D y toda 0x4C: 744 registros con las longitudes canónicas llegaron a la rama de telemetría y todos quedaron excluidos por la comprobación de tensión de celda. Arreglar los desplazamientos recuperó 694 de ellos en este corpus, 619 del 0x4D y 75 del 0x4C, que es un 42,7 % más de telemetría BMS Gen3 sin perder ninguna. El ochenta y cuatro por ciento de las filas 0x4D recuperadas (521 de 619, y del 47 % al 96 % según el archivo) caen dentro de un hueco de más de una hora en la serie 0x4B del mismo archivo, así que es densidad de muestreo real y no duplicados, y alimenta la página de la batería y la estimación del estado de salud. El único campo que siempre sobrevivió es el registro de capacidad, porque se recoge por longitud de registro antes de que se ejecute la puerta.
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 byteRetirado: el contador de culombios y el enum de subestado
Dos líneas de la versión anterior de este mapa quedan retractadas. extra[2:4] se publicó como "coulomb counter, uint16 LE: decreases ~3 units/hour in hibernation". Son los 16 bits bajos de la tensión de pack uint24 en record[54:57], una identidad que se cumple en 619 de 619 registros aceptados, y el decaimiento de "3 units per hour" son unos 3 milivoltios por hora de caída del pack mientras está aparcada. Es la misma mala lectura que esta página ya había retractado para la copia del campo en el 0x4B, dieciocho líneas antes. La copia del 0x4D se pasó por alto, lo que es un buen argumento para buscar una retractación con grep en lugar de corregirla en un solo sitio. Y extra[6:8] se publicó como "sub-state flags, uint16 LE: observed 256, 1024, 5632". Es un par de bytes [indicador, valor]: el byte alto es el mismo byte de 0 a 27 que lleva el 0x4B en record[51] (256 → 1, 1024 → 4, 5632 → 22). Este recuadro llamaba a ese byte "degrees Celsius", y no es una temperatura. Se retractó el 2026-07-31 frente a la temperatura de pack del gemelo MBB (r = −0,074 en 1.275 pares), y esa comparación resultó haber usado la palabra del MBB equivocada, porque las etiquetas de temperatura del MBB estuvieron ellas mismas un hueco desplazadas hasta 2026-09-07. Medido de nuevo con las temperaturas de celda corregidas del MBB, emparejadas en 90 segundos en los ocho pares de la misma moto de aquí (n = 339), se correlaciona con r = −0,41 con la temperatura de celda baja y −0,43 con la ambiente, queda a una mediana de 7 °C de distancia y está a menos de 1 °C en el 1,5 % de los pares. Una temperatura no corre al revés frente a dos termómetros. El byte bajo no siempre es cero: entre los pares observados hay (0,2), (6,18), (0,4), (6,24), (1,13) y (3,10). El enum de tres valores era un artefacto de mirar solo las filas cuyo byte de indicador resultaba ser cero. El zero-log-parser original llegó por su cuenta a la misma conclusión y descartó su propia lectura del byte en 2026-09.
Detalle de celdas (0x4C, 70 bytes), desplazado +4, y la cuestión de los 50 bytes
El registro 0x4C aparece solo durante los periodos de funcionamiento y es raro: 84 registros en todo el corpus, con un recuento por archivo de entre 0 y 65: tres de los siete archivos no llevan ninguno, y uno lleva 65 de los 84. (Esta frase decía antes "0 y 58", en contradicción con la tabla de arriba. Medido de nuevo el 2026-07-30 con el barrido de bytes en producción: los recuentos por archivo son 0, 0, 0, 4, 7, 8, 65, y el mismo barrido reproduce exactamente los 0x4B 186–527 / 1.803 y 0x4D 79–126 / 691 de la tabla. La tabla era correcta.) Lleva la misma carga útil que un 0x4B desplazada cuatro bytes, por el mismo mecanismo que los ocho del 0x4D: cuatro bytes insertados tras la cabecera común de 13 bytes. En los 78 registros 0x4C de longitud exacta de aquí, las tensiones de celda son plausibles con +4 en 75 (96,2 %) y en los desplazamientos del 0x4B en cero.
Con +4 el resto del registro es igual de coherente, que es lo que distingue un desplazamiento real de uno afortunado. El byte 48 del registro es un relleno de cero en 75 de 75 y el byte 47 en 74 de 75, el byte 49 es el modo de informe y lee 7 (activo de alta frecuencia) en 75 de 75, el byte no-temperatura del byte 55 del registro tiene una mediana de 14 una vez excluidas las tres filas con centinela de flash (16 si no se excluyen), y la tensión de pack uint24 en record[50:53] tiene una mediana de 108.144 mV. La corriente mediana es de −9,5 A, así que estos registros se escriben mientras se carga.
Hasta que este decodificador aprendió el desplazamiento nunca leyó ninguno: 70 no estaba en la lista de despacho por huecos, así que todo 0x4C iba al parser de texto y de eventos. Dieciocho de ellos en el corpus produjeron un "evento" cuyo texto eran tres bytes imprimibles consecutivos de carga útil binaria, cadenas como "@~\x05" y "7\x0b3". Esas dieciocho filas son las únicas entradas que quita el despacho por tipo.
Una variante de telemetría de 50 bytes, a veces llamada FST Mono, está documentada en la placa de la SR/S con el número de pieza 40-08201. Usa el mismo mapa de campos que el registro de 52 bytes, truncado por los dos bytes finales, así que no tiene payload[43] en absoluto. El decodificador acepta un hueco de 50 bytes en la ruta de telemetría sobre esa base.
Resuelto desde entonces, y conservado como constancia. Medidos en los 72 archivos BMS Gen3 nativos de producción, ocho archivos de cuatro motos están escritos enteramente en la familia corta (40-08201 "FST Mono" en siete, 40-08213 "FST Mod" en uno), sin ningún registro de telemetría de la familia estándar entre ellos, y los desplazamientos de +4 / +8 se mantienen sin cambios. Lo que sigue era cierto del corpus de siete archivos. Ninguno de los siete archivos BMS medidos aquí viene de una placa 40-08201 (son 40-08247-01 en tres archivos, 40-08295-01 en dos y 40-08367-01 en dos, y esa lista es exhaustiva para este corpus), así que nada de aquí puede confirmar la variante. Lo que sí muestra es un coste. De los 514 huecos de cincuenta bytes del corpus, 509 siguen siendo de cincuenta bytes tras quitar el escape, y el 98,0 % de ellos lleva el byte de tipo 0xFD, es decir, son eventos de texto; ninguno lleva 0x4B. Todos ellos se pasan al decodificador de telemetría y luego los rechaza la comprobación de cordura de tensión de celda, y por eso el enrutado equivocado es inocuo en la práctica y además de no estar detectado.
Comprueba el byte de tipo además del hueco
Un decodificador escrito a partir de esta especificación debería decidir según record[2] y usar la longitud sin escape como comprobación cruzada, que es lo inverso de lo que hace un decodificador que mira primero el hueco. Hacen falta tres mapas de desplazamiento, no uno: 0x4B en +0, 0x4C en +4, 0x4D en +8. El despacho solo por longitud no puede expresarlo, porque no distingue un 0x4D de 78 bytes de cualquier otro registro de 78 bytes. Así fue exactamente como 744 filas de telemetría se leyeron en desplazamientos equivocados y luego las descartó en silencio una comprobación de cordura que hacía bien su trabajo. (744 es la cifra que mide esta página en otro punto: 666 registros ampliados 0x4D más 78 de detalle de celdas 0x4C que llegan a la rama, de los que se recuperaron 694. Un borrador anterior decía 675 aquí, cifra que pertenece a la convención ciega al escape y solo de 0x4D que esta página dedica una sección a retractar.)
La marca de página de flash del BMS: cuatro bytes sobrescritos en cada página
Un archivo nativo Gen3 de la gestión de la batería se escribe en la flash en páginas de 128 bytes, y el inicio de cada página tras la primera lleva los mismos cuatro bytes: 00 F0 FF 00. No son un separador entre registros y no se insertan en ningún sitio. Se escriben ENCIMA de lo que el firmware hubiera puesto en ese desplazamiento (el delimitador de un registro, su longitud, su tipo, parte de su marca de tiempo o una medición), y los cuatro bytes que había se pierden. Nada del archivo puede devolverlos.
Reconocer la marca es fácil, porque su posición nunca varía: desplazamiento de archivo 128·k para k = 1 a 1.025 (1.025 de 1.025 páginas tras la primera) en los ocho archivos nativos de batería Gen3 de este corpus, 8.200 marcas en total, y en ninguno de los diez archivos de placa principal, que no están paginados. Un decodificador puede por tanto encontrar todas las marcas antes de encuadrar un solo registro. Lo que no puede hacer es mirar después un valor decodificado y saber si lo produjo una marca, porque los bytes de la marca se decodifican como números de aspecto normal. La figura muestra dos registros reales a los que afectó.
logs/, anonimizados: no se muestra ningún archivo, VIN ni fecha de piloto, y en el registro A los tres bytes bajos de la marca de tiempo real están enmascarados. Los bytes rojos son el marcador. El flash del pack escribe 00 F0 FF 00 en el desplazamiento de archivo 128·k de cada página después de la primera (1.025 veces en cada uno de los ocho archivos, 8.200 en total), y sustituye los cuatro bytes que había. Antes de la versión 3.37.0 el decodificador lo leía directamente: el registro A publicaba una carga de más de mil amperios y el registro B publicaba una marca de tiempo construida con los propios bytes del marcador. Desde la 3.37.0 los dos decodificadores localizan el marcador por desplazamiento de archivo, trasladan su posición a través del desescape y retienen exactamente los campos que cubre; todo lo demás del registro se lee tal como está escrito. Se omiten los bytes 36 a 51 porque el marcador no llega a ellos.En qué cae la marca
Dónde cae la marca dentro de un registro decide lo que cuesta leer a través de ella. Contadas las 8.200 marcas de los ocho archivos de batería, frente al hueco entre delimitadores en que cae cada una:
| La marca empieza en | Marcas | Lo que obtiene un decodificador que lee a través de ella |
|---|---|---|
| Un byte dentro de la carga útil o del texto de un registro | 5.807 | Una medición equivocada (una corriente, una tensión, un estado de carga) o un mensaje cortado |
| Los microsegundos (bytes 7–10 del registro) | 635 | Una temporización de subsegundo equivocada, y a veces también el byte de secuencia o de desfase |
| El 0xB2 del registro siguiente, o 1–3 bytes antes | 612 | Dos registros fundidos en un hueco: al dividir por 0xB2, el primer registro, intacto, va al parser equivocado |
| La propia marca de tiempo (bytes 3–6) | 574 | Un año 1970, 2097 o 2105, rechazado por la ventana de marcas de tiempo, así que el registro se pierde |
| El byte de secuencia o de desfase (bytes 11–12) | 302 | Una secuencia o un desfase equivocados, y los primeros bytes de la carga útil |
| El byte de tipo (byte 2) | 139 | Tipo 0x00 y una marca de tiempo 0xHH00FFF0, un segundo falso; 138 de los 139 siguen pareciendo plausibles |
| El byte de longitud (byte 1) | 131 | Longitud 0x00, tipo 0xF0 y una marca de tiempo 0xHHHH00FF, hasta 18 horas desviada; 130 de los 131 siguen pareciendo plausibles |
Cada marca localizada por desplazamiento de archivo y contada frente al hueco entre delimitadores en que cae. Las dos últimas filas son las únicas que dejan atrás una marca de tiempo creíble: 268 filas en total, en 38 segundos falsos distintos.
Sobrescritura, no inserción: cómo lo demuestra el archivo
Esta página describió una vez un "pie de página" de tres bytes, F0 FF 00, que un decodificador podía quitar. Las dos mitades eran erróneas: la marca son cuatro bytes, y no hay nada que quitar, porque no está entre registros.
Las longitudes de registro demuestran que es una sobrescritura. En los 8.005 huecos entre delimitadores que cruzan un límite de página en los ocho archivos de batería, la longitud declarada es igual al hueco en 7.246 y más corta en 759, y nunca es el hueco menos cuatro: los bytes de la marca se cuentan dentro del registro en que caen. En los 10.365 huecos sin marca la longitud declarada es igual al hueco todas las veces. El tamaño del archivo coincide: una exportación de batería mide 131.328 bytes y una de placa principal 131.200, justo una página de 128 bytes de diferencia.
Una comprobación barata de integridad del archivo
Una exportación BMS Gen3 nativa lleva exactamente 1.025 marcas, una en cada uno de los desplazamientos 128, 256, … 131.200. Un recuento distinto significa que el archivo está truncado, rellenado o no es una exportación BMS Gen3 en absoluto. Un decodificador que encuentra marcas en 128 y 256 sabe que debe esperar el resto.
Por qué la misma fecha falsa aparece en motos sin relación
Una marca de tiempo son cuatro bytes little-endian, así que su byte bajo va primero. Cuando la marca empieza en el byte de tipo de un registro escribe F0 FF 00 sobre los tres bytes bajos de la marca de tiempo y deja solo el de arriba, que cambia una vez cada 2^24 segundos, unos 194 días. Todo registro afectado así dentro de los mismos 194 días se decodifica por tanto al mismo segundo, sea cual sea la moto que lo escribió: 0x6800FFF0 es 2025-04-17 13:19:44 UTC, 0x6900FFF0 es 2025-10-28 17:40:00 UTC y 0x6A00FFF0 es 2026-05-10 22:00:16 UTC. Cuando la marca empieza un byte antes, en la longitud, los dos bytes bajos de la marca de tiempo pasan a ser FF 00, y la hora falsa cae hasta 18 horas de la real, en un valor que comparte todo acierto del mismo bloque de 18 horas.
En este corpus eso produjo 268 filas con una marca de tiempo falsa pero plausible, en 38 segundos distintos, y solo 2025-10-28 17:40:00 aparece en 95 registros de cinco de las seis motos cuyos archivos de batería están aquí. Cuando motos sin relación comparten una fecha al segundo, la causa es esta marca, no una coincidencia ni un evento de firmware.
Sobre esas filas se construyeron días y recorridos. Un puñado de marcas de tiempo falsas en un día en que la moto estuvo aparcada se convierte en un día de actividad; valores de corriente reales arrastrados a una fecha falsa se convierten en un recorrido que nunca ocurrió. Decodificados de nuevo con la versión 3.37.0, los ocho archivos de batería locales pierden 13 días de archivo y 18 de sus 65 recorridos detectados por la batería, y cada día quitado es uno que solo sostenían marcas de tiempo falsas.
Qué hace ahora el decodificador
Desde la versión 3.37.0 los dos decodificadores (el del servidor y el port del navegador que hay detrás de /decode) hacen cuatro cosas con la marca, y nunca una quinta:
- 1Localizar cada marca por desplazamiento de archivo antes de encuadrar, con la misma prueba de dos páginas que usa el parser original: un archivo está paginado cuando la marca abre sus páginas segunda y tercera, de modo que una sola coincidencia casual no pueda activar el tratamiento.
- 2Llevar la posición de cada marca a través del quitado de escapes, de modo que un registro sepa exactamente cuáles de sus bytes se sobrescribieron aunque haya un escape delante.
- 3Retener exactamente los campos a los que pertenecen esos bytes: una corriente pasa a "no medida", una marca de tiempo pasa a ilegible y la fila queda sin fecha, un registro de texto que choca con una marca se conserva hasta la marca y se marca como truncado, y un registro de telemetría cuyos bytes de la puerta de tensión de celda fueron afectados se descarta, porque una puerta que leyó basura no prueba nada. Todo lo demás del registro se lee tal como está escrito.
- 4Donde la marca cae sobre el 0xB2 del registro siguiente (612 veces aquí), recortar el hueco hasta la longitud declarada del primer registro, de modo que ese registro intacto se decodifique en lugar de entregarse al parser de texto como un bloque de tamaño excesivo. El segundo registro, cuya cabecera se ha perdido, no se decodifica.
| Campo | Filas de telemetría retenidas | De un total de |
|---|---|---|
| Tensión de pack medida (la fila lleva en su lugar la estimación basada en celdas) | 156 | 2.985 |
| Corriente del pack | 130 | 2.985 |
| Marca de tiempo (la fila queda sin fecha) | 130 | 2.985 |
| Byte de secuencia | 124 | 2.985 |
| Indicador de carga | 122 | 2.985 |
| Modo de informe | 104 | 2.985 |
| Byte de actividad | 103 | 2.985 |
| Estado de carga | 24 | 2.985 |
| Cualquiera de los anteriores | 692 | 2.985 |
De los 13.127 eventos de texto de la misma decodificación, 4.316 se marcan como cortados en una marca. Antes de la corrección, los mismos ocho archivos daban 2.894 filas de telemetría, 699 de las cuales llevaban al menos un valor leído a través de una marca; las poblaciones difieren porque la corrección también recuperó registros que el encuadre antiguo perdía.
Nunca empalmar, y nunca preferir un número a un hueco
Empalmar (quitar los cuatro bytes de la marca y unir lo que queda a cada lado) es la quinta cosa, y no se hace nunca. No se insertó nada: los cuatro bytes originales se sobrescribieron, así que unir el resto produce un registro con un campo menos y con todos los campos siguientes en el sitio equivocado. Y un valor fabricado es peor que un hueco. Un hueco se ve: un lector, un gráfico o un detector de sesiones pueden ver que no se midió nada y rodearlo. Un valor leído a través de la marca se ve exactamente como una medición (una carga de 1.048 A, una fecha que comparten cinco motos), y fluye a cada total, cada sesión y cada comparación posterior sin nada que lo marque como distinto. Retener cuesta unas pocas lecturas por página y mantiene creíble cada número restante.
Medido en el corpus de producción
El cambio se evaluó con el corpus de producción completo antes de publicarse: 1.220 archivos de log, decodificados con master y con la versión 3.37.0. Los archivos Gen1, Gen2 y de placa principal Gen3 se decodifican de forma idéntica en todas las métricas; solo cambian los 224 archivos de batería Gen3 nativos, y cambian como dice que deben hacerlo la aritmética de arriba.
- +243.755 entradas utilizables en los 224 archivos de batería.
- 290 días de archivo eliminados, todos ellos una fecha falsificada por la marca. Se repiten en motos sin relación: 2026-05-10, el día del segundo 0x6A00FFF0, aparecía en 57 motos distintas, y 2025-10-28, el día de 0x6900FFF0, en 38.
- 228 «recorridos» solo de batería que ya no se producen. En 196 de ellos el log de la placa principal de la misma moto cubre ese tiempo y no registra ningún recorrido.
payload[38:41]: la tensión de pack que se archivó como un contador
Durante años este campo se documentó como espacio de contador reservado. Un mapa de campos más antiguo lo llamaba "internal counter, uint16 LE, roughly 43,000 to 49,000 when idle, drops under load", y anotaba que caía al rodar sin explicar por qué.
Cae bajo carga porque es la tensión de pack. El campo son tres bytes, no dos: un uint24 little-endian en payload[38:41], igual a record[46:49], que guarda la tensión de pack medida en milivoltios. La lectura truncada de uint16 de 43.000 a 49.000 eran los dos bytes bajos de un número como 109.500.
El decodificador acepta el valor medido solo cuando cumple la envolvente de aceptación de 28 en serie, es decir, cuando 28 × cell_min ≤ valor ≤ 28 × cell_max, usando las tensiones de celda mínima y máxima del mismo registro. Medido en todo el corpus, 2.189 de las 2.319 filas de telemetría que emite el decodificador en producción (94,4 %) la cumplen, con un intervalo por archivo del 92,1 % al 96,5 %. Esas cifras eran 1.473 de 1.557, 94,6 % y 92,2 % a 96,6 % antes de que la corrección del escape y el despacho por tipo de 2026-07-29 ampliaran la población; las dos son correctas para su propia población, y 2.319 es la que se publica. Cuando el valor cae fuera de la envolvente (fotogramas de sueño y filas corrompidas por el búfer circular), el decodificador recurre a la antigua estimación de 28 veces la media de las tensiones de celda baja y alta.
La potencia del pack se calcula como el valor absoluto de V × I, así que toda cifra de potencia Gen3, toda integral de energía de carga y todo lo derivado de ellas cambió cuando se identificó el campo. También es una buena ilustración de por qué una envolvente de aceptación vale más que un factor de escala: la envolvente se deriva de otros dos campos del mismo registro, así que valida la lectura frente a la moto y no frente a una suposición.
La pista estaba en los datos desde el principio
Un contador no decrece cuando aceleras. Cualquier campo cuyo comportamiento contradiga su etiqueta merece releerse con otra anchura y otro signo antes de archivarlo como reservado.
El registro de capacidad, el byte 67, y qué estado de salud se puede calcular
El registro ampliado 0x4D guarda la capacidad de carga completa del pack en miliamperios-hora como un uint24 little-endian en record[67:70], con copia en record[74:77]. Es un registro real guardado y no ruido: la copia gemela sigue a la primaria con una diferencia de alrededor del 1 %.
La extracción es deliberadamente conservadora. Se recoge una muestra de un registro de 78 bytes solo cuando se cumplen tres condiciones: no aparece ningún byte centinela de flash (0xF0 o 0xFF) en record[67:70] ni en record[74:77]; las copias gemelas coinciden con una diferencia inferior al 2 %; y el valor cae entre 50.000 y 250.000 mAh, que abarca todos los packs de Zero del ZF7.2 al ZF17.3. La mediana de las muestras que quedan se estampa en una sola entrada de telemetría por log, porque el registro es un valor estable por pack y con una fila portadora basta.
Medido en el corpus, esto da de 50 a 100 muestras limpias por archivo y medianas por pack de 124.521, 127.419, 134.793, 143.313 y 144.656 mAh en cinco motos. Es una lectura de la capacidad del pack, a una división de un porcentaje de estado de salud, obtenida sin necesidad de pillar una sesión de carga grande. El registro es el único campo de un 0x4D que sobrevivió al fallo de desplazamiento descrito antes, porque la recogida selecciona los registros por longitud antes de que se ejecute la comprobación de tensión de celda del decodificador de telemetría.
Una lectura equivocada que puedes encontrar en otros sitios: el byte 67 no es un recuento de ciclos
El byte 67 del registro se ha descrito (también en nuestras propias notas internas y en un decodificador que se publicó brevemente) como un recuento de ciclos de carga uint8, presentado como una métrica de salud clave con una tabla de valores por moto: 16, 105, 137, 187 y 209 en cinco motos. Esa lectura es incorrecta, y la tabla se ha borrado en lugar de corregirse, porque los números que contenía no significaban nada.
El byte 67 es el byte bajo del registro de capacidad de carga completa uint24 little-endian en record[67:70]. Vaga entre 0 y 255 sin monotonía y sin relación con el número de cargas, que es exactamente lo que hace el byte bajo de una lectura de capacidad en miliamperios-hora.
La tabla antigua se refuta con sus propios números. Anotaba los dos bytes por encima del supuesto recuento de ciclos como una "per-bike constant, e.g. 486". Lee 486 como los dos bytes altos del mismo uint24 y el registro queda en el byte 67 más 124.416 mAh. Los cinco "recuentos de ciclos" eran el 0,2 % inferior de una sola lectura de capacidad del pack de unos 124 Ah, un número que, como era de esperar, está en el mismo intervalo que las medianas medidas arriba.
El decodificador que escribía este valor en una columna de ciclos de carga se publicó y se revirtió el mismo día en que se identificó el registro. El campo del dataclass sigue existiendo por compatibilidad y nunca se rellena, y la no asignación está documentada en el punto donde de otro modo ocurriría. Cualquier cosa que lea un recuento de ciclos de carga Gen3 de este proceso está leyendo un nulo.
Esta página cuenta la historia en lugar de corregir el desplazamiento sin comentarios, porque la lectura equivocada anda suelta por el mundo. Si tienes un decodificador Gen3, una hoja de cálculo o un artículo que informe de ciclos de carga a partir del byte 67, el número que contiene es el byte bajo de un registro de capacidad y hay que descartarlo en lugar de recalibrarlo.
record[67] se publicó como «CHARGE CYCLE COUNT ← KEY HEALTH METRIC» con una tabla de valores de cinco motos. Es el byte bajo del registro de capacidad de carga completa uint24 LE en record[67:70], reflejado en record[74:77]. El decodificador que lo escribió en LogEntry.charge_cycles se publicó en 5fd0793 a las 18:57 del 2026-07-01 y se revirtió en 56f78c5 a las 20:18 de esa misma tarde, 81 minutos después. Los registros aquí son la mediana de las muestras limpias de centinelas y con gemelos coincidentes de cada archivo (n = 50 a 100 por archivo, mediana superior como la toma el decodificador, sorted(samples)[n // 2]); los números de serie del VIN están enmascarados, igual que en docs/. Un uint8 nunca puede superar 255, así que la mayor parte que este byte puede llegar a contener de un registro de ~124 Ah es el 0,20 %.No existe ningún recuento de ciclos en el binario Gen3
Ni en el byte 67 ni en ningún otro sitio que se haya identificado. Si necesitas un recuento de ciclos de una moto Gen3, hay que reconstruirlo a partir de las sesiones de carga detectadas, con todas las salvedades que implica un búfer circular.
Qué estado de salud se puede calcular y lo que cuesta
No existe ningún campo explícito de porcentaje de estado de salud en ninguna generación del formato binario de Zero. Sí existen tres señales relacionadas con la salud en Gen3, y solo la primera se acerca a ser accionable.
El registro de capacidad de carga completa es la lectura directa, y dividirlo por la capacidad de diseño nominal según el VIN da una relación de estado de salud que no depende de pillar una carga grande. Hoy se extrae y se guarda, pero todavía no lo consume ningún endpoint, así que ningún porcentaje que se muestre ahora se deriva de él. La tensión en circuito abierto en payload[15:17] es una tensión de celda en reposo compensada por la resistencia interna que en principio podría asignarse a un SOC con una curva de referencia de celda, y está disponible incluso en un volcado solo de hibernación; no hay ninguna curva así implementada. Una tercera señal que se listaba aquí antes, un contador de culombios en extra[2:4] que supuestamente seguía la autodescarga a unas 3 unidades por hora, no existe: esos bytes son la mitad baja de la tensión de pack del 0x4D, y el decaimiento es la caída del pack en milivoltios.
Lo que se publica es un método por sesiones independiente de la generación: la capacidad se estima por sesión como la energía dividida por la fracción de SOC movida, dividida por el número de módulos de batería activos, y el estado de salud es la media de las últimas cinco estimaciones frente a la capacidad nominal por módulo.
- En ninguna generación existe un byte directo de estado de salud. Gen3 tiene un registro de capacidad, que está a una división, y todavía nada lo lee.
- El método por sesiones necesita una oscilación grande de SOC. Con la puerta del 15 %, una moto que solo se rellena produce cero estimaciones y por tanto ninguna cifra.
- Un búfer circular Gen3 puede dejar sin datos al método por sesiones en una moto que casi siempre está parada, porque las sesiones se sobrescriben antes de exportarse.
- La vía de la tensión en circuito abierto necesita una curva de referencia precisa de la química de celda de que se trate, que no está publicada.
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 countEl filtro "medida, no inferida" es imprescindible. Una carga recuperada a partir de un hueco de SOC lleva un valor de energía que ya se calculó como delta de SOC por capacidad, así que dividirlo otra vez por delta de SOC es circular y arrastraría el resultado hacia el 100 %.
Ventanas de validez de las marcas de tiempo
Un detalle a nivel de archivo confundirá a un decodificador que no lo espere: qué marcas de tiempo creer. La marca de página de flash, que falsifica algunas en los archivos de batería, tiene arriba su propia sección.
Dos ventanas de validez de marcas de tiempo distintas
La marca de tiempo es un uint32 little-endian en los bytes 3 a 6 del registro, y se le aplican dos ventanas distintas en dos etapas distintas. Confundirlas produce registros descartados en silencio o sesiones basura.
Los encuadradores binarios Gen3 usan la ventana estricta de 2019-01-01 (Unix 1.546.300.800) hasta el presente más 365 días. Esta página describía antes esa ventana como una señal de encuadre: lo que distingue un límite de registro genuino de un byte 0xB2 dentro de una carga útil. Medido, hace casi nada de eso. En los 14 archivos 538XX adoptados, los propios contadores del decodificador en producción rechazan 21.106 candidatos: 18.002 cuyo campo de marca de tiempo vale exactamente cero (una ranura de flash borrada que el firmware nunca escribió) y 3.104 que contienen algo fuera de la ventana. Ninguna de las dos clases es desambiguación de delimitadores; eso lo hace el escape. (En los 135 archivos con firma, los mismos contadores dan 154.668 y 164.256 frente a 614.539 candidatos aceptados. Es otro denominador y una población de barrido de bytes, así que cítalo solo con las dos cosas indicadas.) Una versión anterior de esta página daba 23.026 rechazos, 22.972 inicios genuinos, 17.992 ceros y "only 54 true non-boundaries"; nada de ese cuarteto se reproduce, y la descomposición de los 3.104 en inicios genuinos no es algo que este corpus zanje, así que no se afirma aquí.
El filtro genérico posterior al análisis, aplicado a todas las generaciones tras decodificar, acepta los años naturales de 2015 a 2030. Es lo que separa las entradas con marcas de tiempo utilizables de la basura de reinicio del reloj de tiempo real antes de que se ejecute la detección de sesiones. Los registros que no lo superan se conservan pero se ordenan al final, porque un registro con el reloj roto aún puede llevar una medición válida.
Dos notas prácticas sobre los propios valores. El byte más significativo de la marca de tiempo, el byte 6 del registro, ronda 0x69 para las fechas de 2025 y 2026; ese byte se ha confundido a veces con una marca de tipo de registro, y no lo es: el byte de tipo es record[2]. Y lee la marca de tiempo del registro sin escape, nunca de la línea. Un escape que caiga dentro de los bytes 3 a 6 desplaza todo lo que va detrás, y un registro cuyos bytes en disco se leen como junio de 2019 puede decodificarse como noviembre de 2023 una vez respetado el par FE 01.
is_valid_timestamp() (MIN_VALID_YEAR = 2015, MAX_VALID_YEAR = 2030) es el filtro genérico posterior al análisis que ejecuta toda generación, y separa las entradas útiles de la basura de reinicios del RTC antes de la detección de sesiones. Los encuadradores binarios Gen3 usan una ventana más estricta, de 1546300800 (2019-01-01) a now + 365 days. Este pie lo justificaba diciendo que una marca de tiempo verosímil es lo único que distingue un límite de registro real de un byte 0xB2 dentro de una carga útil. No lo es: el escape 0xFE mantiene el delimitador fuera de las cargas útiles y la longitud declarada en el byte 1 es lo que encuadra un registro; la ventana es un filtro de ranuras sin escribir, y bueno. Lo que rechaza, según los propios diagnósticos del decodificador en producción sobre los 14 volcados 538XX adoptados de logs/: 21.106 candidatos, de los cuales 18.002 leen una marca de tiempo de exactamente cero (una ranura de flash borrada) y 3.104 leen otra cosa fuera de la ventana. (La terna 23.026 / 22.972 / 54 que se publicó aquí hasta el 2026-07-30 no se reproduce en ninguna población; no la arrastres.) Una cosa no ha cambiado: lee el uint32 del registro desescapado, porque un escape que caiga dentro de los bytes 3–6 lo desplaza. En los nueve archivos MBB Gen3 nativos, encuadrados por cadena de longitudes, 291 registros se decodifican con otra fecha una vez desescapados, 37 de ellos en el volcado de la SR/F de 2023, cuyos bytes en el cable dicen 1992 y cuyos bytes decodificados dicen 2023.| Ventana | Intervalo | Aplicada por | Finalidad |
|---|---|---|---|
| Encuadre Gen3 | 2019-01-01 .. ahora + 365 días | Los dos encuadradores binarios Gen3, por registro, DESPUÉS de quitar el escape | Rechazar ranuras del búfer circular sin escribir o borradas |
| Validez genérica | años naturales 2015 .. 2030 | Posterior al análisis, en toda generación | Excluir la basura de reinicio del RTC de la detección de sesiones |
Estado de decodificación: conocido, parcial y desconocido
La tabla de abajo sustituye a las filas Gen3 de la tabla de estado más antigua publicada en la página de comparación de generaciones. También sustituye a una versión anterior de sí misma: cuatro filas de aquí contradicen lo que esta página decía antes, y están marcadas para que sepas qué afirmación tienes en la mano. Se usan a propósito tres estados: "Decodificado" significa que el decodificador en producción lo escribe en una entrada, "Presente pero NO leído" significa que los bytes están identificados y ninguna ruta de código los consume, y "No existe" significa que el canal no está en el formato, no que esté sin decodificar sin más.
| Placa | Campo | Ubicación | Estado |
|---|---|---|---|
| BMS | Tensión de celda mínima / máxima | payload[13:15], payload[17:19] | Decodificado: uint16 LE mV, validado 2.500–4.500; suma 8 en 0x4D, 4 en 0x4C |
| BMS | Tensión de celda en circuito abierto | payload[15:17] | Decodificado: guardado, aún sin usar para el SOC |
| BMS | Estado de carga | payload[19] | Decodificado: 0 significa dormido, no vacío |
| BMS | Corriente del pack | payload[20:24] | Decodificado: int32 LE mA. Se leía como int16 hasta 2026-07-31 |
| BMS | Tensión del pack | payload[38:41] | Decodificado: uint24 LE mV, medida, 94,4 % dentro de la envolvente |
| BMS | Temperatura | — | No existe en el registro de telemetría. payload[43] abarca 0–27 y va en contra de las temperaturas de celda del MBB (r = −0,41); retractado |
| BMS | Indicador de carga | payload[22:24] | Derivado: la mitad alta de la corriente int32; su signo, no un indicador |
| Ambas | Contador de secuencia | record[11] | Decodificado: uint8, +1 por registro de cualquier tipo; guardado como bms_sequence en las filas del BMS |
| Ambas | Ajuste de desfase UTC | record[12] | Decodificado: int8 horas; resumido por archivo, nunca aplicado a una marca de tiempo |
| BMS | Valores bajo una marca de página | every 128·k | Retenido: el campo es nulo y se nombra en withheld_fields |
| BMS | Indicador de carga / bus acoplado | payload[27], payload[28] | Decodificado: señales complementarias |
| BMS | Modo de informe | payload[37] | Decodificado: 7 valores conocidos entre los tipos de registro; el valor 6 sin explicar |
| BMS | Byte de actividad (antes "código de estado") | payload[24] | NO decodificado: guardado tal cual; 37 valores, ningún enum sobrevive a las pruebas |
| BMS | Indicador de sueño | payload[9] | Decodificado: 0x20 dormido, 0x00 despierto (medido) |
| BMS | Capacidad de carga completa | record[67:70] + twin at [74:77] | Decodificado: uint24 LE mAh, guardado, aún sin consumir |
| BMS | Tensión del pack (copia del 0x4D) | record[54:57] | Decodificado: uint24 LE mV; retractado como "contador de culombios" |
| BMS | Contador acumulado por moto | extra[10:12] | Desconocido: varía 38.967–56.414, sin correlación hallada |
| BMS | Detalle de celdas por bloque | Registro 0x4C, campos desplazados +4 | Decodificado: el mismo mapa que el 0x4B en +4; la correspondencia por bloque no está establecida |
| BMS | Recuento de ciclos de carga | — | No existe. El byte 67 es un byte de capacidad |
| MBB | Estado | record[42:51], [46:55], [50:59] según el tipo | Decodificado: anclado por tipo de registro, diez tokens incluidos REV y PARK |
| MBB | Estado de carga | record[33] | Decodificado: uint8, 0 en PWSU significa sin inicializar |
| MBB | Indicador de modo del controlador | record[17] | Decodificado: 0x00 activo, 0x6A en espera, 0x60 transición |
| MBB | Temperaturas | record[51:71], cinco uint32 | Decodificado: ambiente, motor, inversor, celda alta, celda baja (renombrado el 2026-09-07) |
| MBB | Corriente de la batería | record[38:42] | Decodificado: int32 LE mA, solo mientras el bus está activo |
| MBB | Tensión / corriente del bus de continua, RPM del motor | record[21:33] | Decodificado: las lecturas del controlador, solo mientras el bus está activo |
| MBB | Raíl de accesorios de 12 V (identificación no demostrada) | record[71:75] | Se emite en bruto: uint32 LE microvoltios sobre una retícula de 5.128 µV; la retícula del ADC está demostrada, «qué raíl» no |
| MBB | Velocidad en carretera, autonomía estimada | Cola del 0x52 / 0x53 | Decodificado: mm/h y centésimas de km; no está en un 0x51 |
| MBB | Cuentakilómetros | Cola del 0x52 / 0x53, disposición más nueva | Decodificado: décimas de km, comprobado como serie por archivo; la disposición más antigua y el 0x51 no llevan ninguno. record[71:75] es un raíl de 12 V (retractado) |
| MBB | Registro del motor | 0x54, 29 bytes | Decodificado: par del eje, corriente del motor, tensión del bus de continua |
| MBB | Tensión del pack | record[34:38] | Decodificado: solo mientras el bus está activo |
| MBB | Tabla del cargador / objetivos de carga | 0x48 / 0x49 | Decodificado: todo registro de cargador, V/A/Hz de red, salida en continua, id CAN, serie; techo, % objetivo, V de almacenamiento |
| MBB | Cola llena | 0x4F, 31 bytes | Decodificado: nombre de la cola y dos contadores, significado sin confirmar |
| MBB | Cabecera | 0xFB | Decodificado: VIN (validado con el dígito de control), modelo, año modelo, revisión de placa y de firmware, compilación del firmware |
| MBB | Rótulo de compilación del firmware | 0x32, disposición antigua, volcados de plataforma Gen2 | Decodificado: fecha de compilación, número de compilación, banco de flash; cada compilación que anuncia un archivo, en el orden del archivo |
| Ambas | Eventos de texto | 0xFD, desde el byte 13 del registro | Decodificado: ASCII terminado en nulo; el texto que corta una marca de página se conserva hasta la marca y se marca |
| MBB | Instantánea de estado | 0x4B / 0x4C / 0x4D, lado MBB | Solo etiqueta: ninguna en este corpus; no se usa para los recorridos |
| 538XX | Tensión, corriente, RPM, 5 temperaturas, cuentakilómetros | Registro 0x2c, 40 bytes | Decodificado: mapa run_status del parser original; la calibración ajustada está retractada |
Los desplazamientos de carga útil son relativos al byte 8 del registro en el BMS y al byte 0 del registro en el MBB, según la convención de cada decodificador. Suma 8 a un desplazamiento de carga útil del BMS para obtener la posición absoluta del registro.
Cómo se contrastó esta decodificación con el parser de la comunidad
La decodificación Gen3 de esta página se comparó, campo a campo, con el parser de la comunidad zero-log-parser en el commit 90c8cb2 de su rama principal, del 29 de septiembre de 2026. El parser original es una segunda opinión, no la verdad de referencia, y el objetivo del ejercicio era saber dónde coinciden los dos, dónde no y por qué. La versión corta es la primera subsección; el método, los números y el crédito vienen después.
La versión corta
Este sitio decodifica los logs Gen1 y Gen2 con el parser de la comunidad, zero-log-parser, fijado en el commit 90c8cb2 (29 de septiembre de 2026; antes en 87c6e757, febrero de 2026); los registros Gen3 nativos de esta página los decodifica el propio código de este sitio. El 3 de octubre de 2026 se compararon los dos decodificadores Gen3 registro a registro, alineados por desplazamiento de archivo, con la rama principal del parser en 90c8cb2 (29 de septiembre de 2026, la versión que ejecuta el parser alojado en home.hasslers.net/zerologparser). Siempre que los dos decodifican un registro coinciden: las 2.866 lecturas de tensión de celda, el estado de carga, los campos de estado, las temperaturas, la tabla del cargador y los informes de cola llena. Varios de esos registros los decodificó antes el parser original (la cabecera de la placa principal Gen3 y la compilación del firmware 0x32 el 15 de septiembre, la tabla del cargador 0x48 y la cola llena 0x4F el 20 de septiembre, un recorrido consciente de las páginas para las páginas de flash del pack el 22 de septiembre), y las versiones de este sitio, publicadas el 3 de octubre, se contrastaron con ellos. Quedan cuatro diferencias, una de ellas a favor del parser: lee los dos números de serie de la cabecera de un pack Gen3, y esta decodificación no. Desde que se movió la fijación, el sitio registra los dos números de serie que lee el parser, solo como información; nada identifica todavía un pack por ellos. En sentido contrario, el parser todavía no decodifica los registros de texto Gen3 (tipo 0xFD), la clase de registro más grande en Gen3: su decodificador de mensajes lee el prefijo de seis bytes del registro como la cadena. Lee los cuatro primeros bytes de carga útil del registro 0x54 como un cuentakilómetros; son la parte de subsegundo de la marca de tiempo del registro. Y su LOG_STRUCTURE.md sigue poniendo un cuentakilómetros en los bytes 0–3 del registro 0x51, donde este corpus no encuentra ninguno; según la lectura de este sitio el cuentakilómetros está en la cola de los registros 0x52 y 0x53 de disposición más nueva.
Método: alinear por desplazamiento de archivo, nunca por marca de tiempo
Cada registro se encuadra una sola vez, con los encuadradores de este sitio (la cadena de longitud declarada en la placa principal, el hueco entre delimitadores con el corte por marca de página en la placa de la batería), y los mismos bytes sin escape se entregan a los dos decodificadores: este su trama, el parser original su carga útil, que empieza en el byte 7 del registro. Un registro se identifica por el sitio que ocupa en el archivo, y por nada más.
Las marcas de tiempo no pueden hacer ese trabajo. Dos registros escritos en el mismo segundo son lo normal, no la excepción: en los diez archivos nativos de placa principal, 19.705 de 21.724 registros encuadrados (90,7 %) comparten segundo con al menos otro registro, y 16.919 (77,9 %) con otro registro del mismo tipo; en los ocho archivos de batería son 15.735 de 18.370 (85,7 %) y 13.184 (71,8 %). Un cruce por tiempo empareja registros equivocados e informa de desacuerdos que no existen. Una comparación anterior informó de que los dos decodificadores discrepaban sobre el id CAN de un cargador, 16 frente a 17, cuando había emparejado dos cargadores distintos que respondieron en el mismo segundo.
El corpus son todos los archivos Gen3 nativos de este repositorio: 18 archivos, diez volcados de placa principal y ocho de gestión de la batería. El código actual del parser original solo se carga para la comparación y nunca en el mismo proceso que una decodificación completa, porque cargarlo junto a la versión que fija este sitio cambia lo que devuelve la biblioteca fijada. El script que lo ejecuta, gen3_upstream_crosscheck.py entre los scripts del backend de este repositorio, no escribe nada y termina con 0: es un informe, no una puerta, porque un desacuerdo puede ser un error del parser original tanto como nuestro.
Resultados, campo a campo
Medido el 3 de octubre de 2026 contra la rama principal del parser original en 90c8cb2.
| Campo | Registros | Coinciden | Difieren | Retenidos aquí |
|---|---|---|---|---|
| Tensión de celda mínima y máxima del BMS | 2.866 | 2.866 | 0 | 0 |
| Estado de carga del BMS | 2.866 | 2.842 | 0 | 24, bajo una marca de página |
| Corriente del pack del BMS | 2.866 | 2.707 | 29 | 130, bajo una marca de página |
| Tensión de pack medida del BMS | 2.866 | 2.695 | 15 | 156, bajo una marca de página |
| Estado del vehículo del MBB (0x51, 0x52, 0x53) | 1.727 | 1.727 | 0 | — |
| Temperaturas del MBB 0x51: motor, inversor, celda alta, celda baja | 1.536 cada una | 1.536 cada una | 0 | — |
| Cargador MBB 0x48: nombre, id CAN, versión, serie, frecuencia | 119 cada uno | 119 cada uno | 0 | — |
| Cola llena MBB 0x4F: nombre y los dos valores | 18 cada uno | 18 cada uno | 0 | — |
| Registros de texto (0xFD), las dos placas | 33.460 | El parser original no devuelve ninguno de los mensajes | — | — |
Las 2.866 filas de batería son los registros de telemetría que emiten los dos decodificadores. Además de ellos, 119 registros de telemetría se decodifican aquí y no en el parser original, 625 por ninguno de los dos, 235 los decodifica el parser original y este decodificador los descarta porque una marca de página sobrescribió parte del registro, y 1 lo descarta este decodificador por otro motivo.
Dónde discrepan los dos, y por qué
Toda diferencia de la tabla tiene una causa que se puede nombrar:
- Las 29 diferencias de corriente actuales son palabras que este decodificador rechaza por ser flash borrada. Veintisiete veces los cuatro bytes valen FF FF FF FF, que el parser original publica como −1 mA; dos veces son otras combinaciones de bytes centinela de flash, que el parser original lee como 240 mA y −16 mA.
- Las 15 diferencias de tensión de pack son filas cuya palabra medida cae fuera de la envolvente de 28 celdas o bajo una marca. Este decodificador publica entonces 28 veces la tensión de celda media del propio registro, y el parser original la palabra tal como se lee: 13 difieren de 39 a 647 mV, y en las otras dos la palabra lee 0 y 164 mV.
- El texto es donde los dos se separan del todo. Los 18 archivos contienen 33.460 registros de texto, 18.570 en las placas principales y 14.890 en los packs, y este decodificador lee 31.686 de ellos como texto: 18.023 mensajes de la placa principal y 13.663 eventos de batería. La rama principal del parser original no devuelve ninguno de esos mensajes. Su decodificador de mensajes lee el prefijo FST de seis bytes del registro como la cadena, así que un registro que dice "State change from CHRG to …" sale como dos caracteres de control. El texto es la clase de registro más grande de un archivo Gen3, y es donde la máquina de estados, los fallos y los eventos del contactor se escriben con palabras.
La guarda de regresión: 43 registros reales, dos decodificadores, un archivo
Una comparación con un parser original que se mueve es una medición, no una prueba. Lo que impide que esta decodificación se desvíe es un archivo de referencia versionado con 43 registros reales anonimizados (22 de placa principal, 18 de gestión de la batería y 3 de batería con la disposición antigua), junto con los valores que produce este decodificador a partir de cada uno. No contiene ningún registro de cabecera ni texto identificativo, y los números de serie del cargador que lleva están a cero. El decodificador en Python se prueba contra él en la suite del backend y el decodificador del navegador que hay detrás de /decode contra el mismo archivo en la suite del frontend, de modo que las dos implementaciones no pueden separarse en un registro sin que falle una prueba. Cuando el port del navegador se puso al día para la versión 3.37.0, difería del decodificador del servidor en 0 valores en los 18 archivos nativos.
Lo que encontró antes el parser original
Gran parte de lo que esta página añadió en octubre de 2026 lo encontró antes el parser de la comunidad, y el decodificador de aquí se contrastó con él en lugar de escribirse aislado. En la rama principal del parser original:
- los desplazamientos de la cabecera de la placa principal Gen3 para el VIN, el modelo, la revisión de placa y de firmware y la compilación del firmware, el 15 de septiembre de 2026 (commit 8591af3), a partir de la pull request de AtomicDog de 2022;
- el rótulo de compilación del firmware 0x32, también el 15 de septiembre (825c9d2);
- la tabla del cargador 0x48 y el informe de cola llena 0x4F con sus once nombres de cola, el 20 de septiembre (f1e34cb, 1da1827);
- las instantáneas de estado 0x4B, 0x4C y 0x4D de la placa principal, el 20 de septiembre (82475b7);
- los microsegundos de subsegundo y el contador de secuencia por entrada en el prefijo del registro;
- y la marca de página de flash como una sobrescritura y no una inserción, con los dos casos en que destruye la cabecera o el tipo de un registro y un recorrido consciente de las páginas del archivo de batería, el 22 de septiembre (2c98751), medido por el parser original en 291 archivos.
Decodificador en el navegador
Este decodificador aplica la especificación de arriba a un archivo que eliges tú. Encuadra los registros 0xB2, clasifica cada byte de tipo, decodifica los mapas de campos documentados en esta página e informa de lo que no pudo leer, para que puedas comprobar cualquier desplazamiento de aquí con tu propio log.
Es la misma decodificación que la del flujo del servidor: validada campo por campo contra el parser de Python en una ruta forzada, que ejecuta todos los decodificadores aplicables sobre cada uno de los 352 archivos de log reales: 1.190.446 entradas, cero divergencias, hashes canónicos idénticos byte a byte en los 352. En la ruta de producción, donde el clasificador elige un decodificador por archivo, el mismo corpus da 67 archivos decodificados y 317.124 entradas, también con cero divergencias. Se admiten el MBB Gen3, el BMS Gen3 y la variante de firmware 538XX; los archivos Gen1/Gen2 se reconocen y se identifican, pero aquí no se decodifican, y por eso el total de producción es el menor de los dos.
Esa coincidencia es una garantía de portabilidad: demuestra que las dos implementaciones coinciden entre sí, y no puede demostrar que ninguna coincida con el firmware. Donde el decodificador de Python se equivoca, este se equivoca exactamente igual, por diseño, y eso es lo que da sentido a la comprobación cruzada. Las desviaciones conocidas respecto del formato son las expuestas arriba: varios campos identificados que ningún decodificador lee, y las retractaciones marcadas en su sitio.
Se decodifica por completo en tu navegador. Este archivo nunca se sube.
El decodificador es JavaScript que se ejecuta en esta pestaña. Tu .bin se lee con la API de archivos estándar, se decodifica en memoria y se muestra abajo. La decodificación no hace ninguna petición de red de ningún tipo: no se sube nada, no se transmite ningún VIN y ningún evento de analítica lleva nada de tu log. Cierra la pestaña y desaparece.
Preguntas frecuentes
¿Contiene el log del MBB Gen3 tensión de pack, corriente o velocidad?
Tensión y corriente: sí, y esta página decía antes lo contrario. La tensión de pack es un uint32 little-endian en milivoltios en record[34:38] y la corriente de la batería un int32 con signo en miliamperios en record[38:42], y las dos están rellenas exactamente cuando el sistema de alta tensión está activo: distintas de cero en 144 de 144 registros RUN y cero en 417 de 417 registros de hibernación. Una sesión de carga leída de estos bytes muestra una fase de absorción de tensión constante de manual, e integrándolos sobre el SOC se llega a la capacidad útil del pack. El decodificador en producción lee ambas desde 2026-09-07, de registros cuyo bus está activo; están vacías en los estados que forman el 75 % de un log real, así que el BMS sigue siendo la mejor fuente. Velocidad: sí, pero no en el registro común. Los registros más largos 0x52 y 0x53 llevan la velocidad en carretera, la autonomía estimada y (en el firmware más nuevo) el cuentakilómetros en su cola; el 0x51 de 75 bytes no lleva ninguno, y record[71:75], publicado aquí como cuentakilómetros, es un raíl de accesorios de 12 V en microvoltios. Las mediciones de tensión y corriente salen de cinco motos de plataforma SR/F; la única DSR/X de este corpus apenas las rellena, así que tómalas como no confirmadas en ese hardware.
¿Cuál es la estructura de un registro Gen3 0xB2?
El byte 0 es el delimitador 0xB2, el byte 1 es la longitud total del registro en disco, incluido el delimitador y cualquier byte de escape, el byte 2 es el tipo de registro, los bytes 3 a 6 son una marca de tiempo Unix como uint32 little-endian en UTC, los bytes 7 a 10 son la parte de subsegundo en microsegundos, el byte 11 es un contador de secuencia que avanza uno en cada registro, y el byte 12 es el ajuste de desfase UTC de la moto en horas como byte con signo (dos campos que esta página describía antes como un único "entry counter" uint16). La carga útil empieza en el byte 13. Los tipos del MBB son 0xFB cabecera, 0xFD texto, 0x51, 0x52 y 0x53 telemetría de estado, 0x54 motor, 0x48 tabla del cargador, 0x49 objetivos de carga y 0x4F desbordamiento de cola. Los tipos del BMS son 0xFB cabecera, 0xFD texto, 0x4B telemetría, 0x4D telemetría ampliada y 0x4C detalle de celdas. Encuadra por el byte 1 y luego quita el escape del cuerpo encuadrado. En un archivo BMS, recuerda que cuatro bytes en cada límite de página de 128 bytes son una marca, no datos.
¿Tengo que tratar el escape 0xFE?
Sí, y una versión anterior de esta página no lo mencionaba en absoluto. El escritor escapa el delimitador: FE 4D en disco se decodifica como 0xB2 y FE 01 como 0xFE, así que un registro bien formado no contiene ningún 0xB2 en bruto después del byte 0. Hay cero apariciones en los 1.010.093 bytes en disco de record[2:] de los 19.342 registros encadenados por longitud de los nueve archivos MBB Gen3 nativos, de los que 504 llevan un escape y aparecen 518 bytes de escape en total (264 FE 4D, 254 FE 01, ningún otro par). Solo en los ocho volcados de la app de tamaño completo, el mismo censo da 19.089 registros, 994.299 bytes, 468 con escape y 477 bytes de escape. Encuadra primero por la longitud declarada en el byte 1 y luego quita el escape del cuerpo encuadrado; el byte 1 es el único campo fuera de la región escapada, así que es el único del que puedes fiarte antes de quitar el escape. Hacerlo al revés reintroduce 0xB2 en mitad de la carga útil y destroza el archivo, que es como el escape se confundió con el delimitador que reaparecía en las cargas útiles. Ignorarlo sale caro: en el firmware 538XX, condicionar la telemetría a la longitud en disco en lugar de a la longitud sin escape descarta 1.796 registros, y la pérdida está correlacionada con el valor y no es aleatoria.
¿Hay un cuentakilómetros en un log del MBB Gen3 nativo?
No en el registro común, y no en todos los firmwares. En la disposición de firmware más nueva (aquella cuyo 0x51 mide 75 bytes), los registros más largos 0x52 y 0x53 llevan el cuentakilómetros en su cola, en décimas de kilómetro; se decodifica desde 2026-09-07, congelado durante una carga y subiendo solo en RUN, y se comprueba como serie por archivo antes de conservarlo. La disposición más antigua, cuyo 0x51 mide 71 bytes, no lleva ninguno: la palabra de ahí que sube suavemente hasta un kilometraje plausible lo hace solo mientras la moto está cargando, y es la autonomía estimada. Lo que esta página publicaba antes como cuentakilómetros era otra cosa distinta. record[71:75] se publicó aquí como un cuentakilómetros de por vida en metros cuyas lecturas "fluctúan decenas de kilómetros". Es una lectura de ADC de 12 bits en microvoltios, y según el peso de la evidencia una lectura del raíl de accesorios de 12 V; la retícula está demostrada y la etiqueta del raíl no. Cada uno de los 1.121 registros de telemetría completos de este corpus cumple v = 5128k + 4864 (un bit menos significativo de 5,128 mV sobre unos 21 V de fondo de escala), y leído en voltios el campo abarca de 0,143 V a 13,440 V, que es lo que informan los propios eventos de texto del firmware para la batería de accesorios en exactamente esas unidades. Solo el 51,5 % de las muestras consecutivas no decrecen, y ninguna ventana uint32 del registro es monótona salvo la marca de tiempo. Cinco motos sin relación entre sí, de tres familias de modelo y cinco años modelo, informaron todas «cuentakilómetros» dentro de una ventana de 272 km. El campo se ha retirado del decodificador: una moto cuyo log no tiene ningún registro 0x52 o 0x53 de disposición más nueva informa ahora ningún cuentakilómetros ni distancia por recorrido en lugar de uno fabricado. También existe un cuentakilómetros real en Gen2 y en la variante de firmware 538XX, en otro desplazamiento de otro registro.
¿Puedo leer un registro 0x4D del BMS con el mapa de campos del 0x4B?
No, y no fallará con estrépito. Un 0x4D comparte solo la cabecera de 13 bytes y luego inserta ocho bytes, así que cada campo de medición está ocho bytes más allá; un 0x4C inserta cuatro. Barriendo desplazamientos de 0 a 12 y comprobando si las palabras de tensión de celda caen en una banda plausible de 2.500 a 4.500 mV, un 0x4D puntúa cero en los desplazamientos del 0x4B y 619 de 666 en +8, y un 0x4C puntúa cero y 75 de 78 en +4. Cero es el número que importa: un decodificador con comprobación de cordura de tensión de celda lee el bloque de relleno de ceros, falla la comprobación y descarta en silencio todos los registros ampliados. En este proyecto fueron 744 registros con las longitudes canónicas. Arreglar los desplazamientos recuperó 694 de ellos, un 42,7 % más de telemetría BMS Gen3, con el 84 % de las filas 0x4D cayendo en huecos de más de una hora en la serie estándar. Despacha según el byte de tipo en record[2] y usa la longitud sin escape solo como comprobación cruzada; la longitud sola no distingue un 0x4D de 78 bytes de cualquier otro registro de 78 bytes.
¿Qué hay en el payload[38:41] del BMS?
La tensión de pack medida, como uint24 little-endian en milivoltios. Se documentó durante años como un contador interno de unos 43.000 a 49.000 que misteriosamente caía bajo carga. Era una lectura uint16 de los dos bytes bajos del valor real de tres bytes. El decodificador lo acepta cuando cae entre 28 veces la tensión de celda mínima y 28 veces la tensión de celda máxima del mismo registro, lo que se cumple en 2.189 de las 2.319 filas de telemetría que emite el decodificador en producción (94,4 %, y del 92,1 % al 96,5 % por archivo), y si no recurre a una estimación de 28 en serie con la media de las celdas. El muy copiado 1.473 de 1.557 es la misma prueba sobre la población que emitía este decodificador antes de la corrección del escape de 2026-07-29.
¿Qué significa el payload[24] del BMS? ¿Es el código de estado del BMS?
No. Se publicó, también en este sitio, un enum que lee 0x0B inactivo, 0x0C activo, 0x09 desbloqueo y 0x0A precarga, y queda retirado. En las 2.319 filas de telemetría que emite el decodificador en producción, el byte toma 37 valores distintos (todos los valores de 0x00 a 0x23 salvo 0x02, más los centinelas de flash 0xF0 y 0xFF), y esos cuatro códigos cubren solo el 58,6 % de las filas. No es un contador (el 82,0 % de las diferencias consecutivas dentro de una ventana de 120 segundos son exactamente cero), no es una temperatura (r = -0,05 frente al byte de temperatura del mismo registro) y no reparte las transiciones ZERO_BMS_STATE_ de los eventos de texto: arrástralas hacia delante y el 0x09 sí está bajo UNLOCK en el 62 % de las filas, pero el 0x0B, el valor llamado "inactivo", está bajo HIBERNATE, IDLE y UNLOCK por igual. Sí se correlaciona vagamente con que el pack esté bajo carga, pero dos valores que el enum nunca nombró, 0x10 con un 62,2 % bajo carga y 0x0F con un 40,7 %, están dentro de ese orden. El decodificador guarda el byte tal cual y no actúa según él en ningún sitio. Trátalo como opaco.
¿Es el byte 67 de un registro BMS Gen3 un recuento de ciclos de carga?
No. Es el byte bajo del registro de capacidad de carga completa uint24 little-endian en record[67:70], con copia en record[74:77], que guarda la capacidad del pack en miliamperios-hora, normalmente de unos 124.000 a 145.000 mAh. Leído como un uint8 suelto vaga entre 0 y 255 sin monotonía. Un decodificador que lo escribió en un campo de ciclos de carga se publicó y se revirtió el mismo día. No se conoce ningún campo de ciclos de carga en el formato binario Gen3.
¿Qué es la variante de firmware 538XX?
Una moto de la era Gen2 cuyo MBB se actualizó por firmware a un búfer circular de flash estilo Gen3 de registros 0xB2 con prefijo de longitud. El archivo tiene una cabecera Gen2 ("MBB" seguido de un nulo en el desplazamiento 0, y A1 A1 A1 A1 en el 38) pero un cuerpo estilo Gen3. Esta página solía añadir que "neither path could read it"; eso es falso. Su registro 0x2c es el registro Riding Status corriente del zero-log-parser original, que se despacha desde 2015, y la versión del parser original que fija este sitio lee estos archivos. Lo que falló fue el enrutado dentro de este proyecto: el cargador Gen3 nativo solo necesita el ASCII "MBB" y diez bytes 0xB2, y las dos cosas se cumplen aquí, así que se descartó una decodificación Gen2 que funcionaba. Los registros miden exactamente 40 bytes y llevan la tensión de pack como entero uint32 exacto en milivoltios, corriente de batería y de motor, cinco temperaturas, SOC, RPM del motor y un cuentakilómetros, pero no velocidad en carretera. La detección ejecuta la decodificación y la adopta solo si salen al menos 10 entradas de cambio de estado y 50 de telemetría, porque los archivos Gen2 genuinos comparten la firma de cabecera y escriben el mismo registro.
¿Cuántos registros tiene un log Gen3 y qué los llena?
Entre 2.238 y 2.535 registros encuadrados por archivo MBB de 131.200 bytes, y de 2.038 a 2.327 por archivo BMS de 131.328 bytes, medidos en ocho y siete archivos respectivamente y encuadrados encadenando la longitud declarada. Los eventos de texto dominan en los dos: el 86,7 % de los registros del MBB (16.553 de 19.089) y el 82,9 % de los del BMS (13.178 de 15.890). Cuenta los mismos archivos BMS dividiendo por el hueco entre delimitadores y obtienes 15.998 registros con un 82,4 % de texto, que es el par que publica la página del búfer circular; nombrar la convención es lo que evita que los dos se lean como una contradicción. En el MBB el relleno es el ciclo de despertar de la hibernación, que escribe una mediana de 31 registros (27 de texto, 2 de telemetría, 2 secundarios) en una ráfaga de 91 segundos, repetida con un periodo de 60 minutos que el log anuncia como "Saving Stats, Hibernating for 3600 sec".
¿Puede un log Gen3 decirme el estado de salud de la batería?
De forma indirecta. No existe ningún campo explícito de estado de salud en ninguna generación del formato. Gen3 sí guarda un registro de capacidad de carga completa en sus registros 0x4D, que está a una división por la capacidad de diseño nominal de un porcentaje, pero hoy se extrae y se guarda en lugar de consumirse. Lo que se publica hoy es una estimación por sesiones: energía dividida por la fracción de SOC movida, por módulo, promediada sobre las últimas cinco sesiones que cumplen los requisitos, lo que exige una oscilación de SOC de al menos el 15 % para producir cualquier estimación.
¿Qué significa la secuencia de bytes 00 F0 FF 00 en un archivo BMS Gen3?
Es la marca de página de flash, que no es corrupción aleatoria ni un separador. En todos los archivos de batería Gen3 nativos medidos está en el desplazamiento de archivo 128·k para k = 1 a 1.025, 1.025 veces por archivo, y en ningún archivo de placa principal. Se escribe sobre cuatro bytes de lo que ocupara esa posición, así que esos cuatro bytes se pierden: un decodificador debe localizar la marca por desplazamiento de archivo y retener los campos que cubre, y no debe quitarla nunca empalmando, porque no se insertó nada. Una versión anterior de esta respuesta decía que la marca eran tres bytes, F0 FF 00, que empezaba en el desplazamiento 129 y que se podía quitar antes de encuadrar; las tres afirmaciones eran erróneas. Contar las marcas sigue siendo una comprobación de integridad barata: una exportación BMS Gen3 nativa lleva exactamente 1.025.
¿Por qué algunos logs de batería Gen3 muestran actividad en una fecha que otras motos comparten al segundo?
Porque la marca de página de flash la falsificó. Cuando la marca cae sobre el byte de tipo de un registro, sobrescribe los tres bytes bajos de la marca de tiempo con F0 FF 00 y deja solo el byte de arriba, así que todo registro afectado así dentro de los mismos 194 días se decodifica a un segundo, sea cual sea la moto que lo escribió: 0x6900FFF0 es 2025-10-28 17:40:00 UTC y 0x6A00FFF0 es 2026-05-10 22:00:16 UTC. En este corpus 2025-10-28 17:40:00 aparece en 95 registros de cinco motos distintas; en el corpus de producción un día falso había aparecido en 57 motos y otro en 38. Desde la versión 3.37.0 esas marcas de tiempo se retienen, las filas quedan sin fecha, y los días y los recorridos solo de batería construidos sobre ellas desaparecen.
¿Decodifica zero-log-parser los logs Gen3?
Depende de la versión, y este sitio no lo usa para nada de su decodificación Gen3 en ningún caso. La versión que este sitio fijó antes para Gen1 y Gen2, el commit 87c6e757 de febrero de 2026, imprime la cabecera de un archivo Gen3 como vacía o "Unknown". La versión que fija ahora, 90c8cb2 del 29 de septiembre de 2026, ha avanzado mucho: lee la cabecera de la placa principal Gen3, la telemetría de la batería, los registros del cargador, de cola llena y de compilación del firmware, y recorre las páginas de flash del archivo de batería, y donde ella y el decodificador de este sitio decodifican un registro coinciden: 2.866 de 2.866 lecturas de celda en los 18 archivos Gen3 nativos de aquí. Lo que todavía no decodifica son los registros de texto, la clase más grande de un archivo Gen3: su decodificador de mensajes lee el prefijo de seis bytes del registro como la cadena.
Créditos: el proyecto upstream zero-log-parser
Todo lo de esta página se apoya en zero-motorcycle-community/zero-log-parser, el proyecto de código abierto que documentó por primera vez el formato de log de Zero. Lo usamos directamente para el análisis de Gen1 y Gen2, y su LOG_STRUCTURE.md sigue siendo la referencia de la comunidad para esas generaciones. Los mapas de registros Gen3 de arriba son nuestros solo porque ese proyecto hizo legible el problema desde el principio.
El soporte de Gen3 se siguió en la incidencia n.º 16, abierta del 21 de febrero de 2020 al 8 de febrero de 2026. Vale la pena citar entera la valoración del mantenedor, porque es exactamente acertada y es la razón de que exista esta página:
«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.»Sigue sin haber una especificación oficial ni una salida de referencia decodificada. Cada desplazamiento de aquí se recuperó midiendo, y se agradecen las correcciones contra archivos reales.
Cada desplazamiento de byte publicado aquí se midió con archivos reales y no se leyó en un decodificador. Las cifras de mezcla de registros y de rellenado de campos salen de ocho volcados de la app de tamaño completo de MBB Gen3 nativo y siete volcados de BMS Gen3 que cubren cinco motos distintas (SR/F, SR/S, DSR/X). Existe un noveno archivo MBB nativo (un resto truncado de 16.384 bytes de una sexta moto, que el proceso sí decodifica como Gen3), y se incluye en el censo de escapes, en las poblaciones de estado del 0x51 y en las cifras de encuadre pero se excluye de las proporciones de mezcla de registros; cada recuento de esta página dice a cuál de los dos pertenece. Las cifras de encuadre, de escape y de 538XX salen del corpus completo de 352 archivos, de los que 135 comparten la firma de cabecera 538XX y 14 pasan su puerta de rendimiento. Las mediciones se hicieron el 2026-07-30. Donde el decodificador y los bytes discreparon, ganaron los bytes: cinco afirmaciones publicadas antes en esta página se retractaron por ello, y cada retractación se deja donde está con la medición que la mató en lugar de borrarse en silencio.
Fuentes:
- zero-motorcycle-community/zero-log-parser, el parser de código abierto original sobre el que se construye este proyecto (se abre en una pestaña nueva)
- zero-log-parser: LOG_STRUCTURE.md, la referencia de la comunidad para la estructura de registros de Gen1/Gen2 (se abre en una pestaña nueva)
- zero-log-parser issue #16, «Support SR/F (Gen3) logs», abierta del 2020-02-21 al 2026-02-08 (se abre en una pestaña nueva)
- zero-log-parser commit 2c98751 (2026-09-22): el recorrido por páginas para el formato de páginas del BMS FST/Gen3 (se abre en una pestaña nueva)
- zero-log-parser commit 8591af3 (2026-09-15): campos de cabecera del MBB Gen3 (se abre en una pestaña nueva)
- zero-log-parser commits f1e34cb y 1da1827 (2026-09-20): la tabla del cargador 0x48 y los registros de cola llena 0x4F (se abre en una pestaña nueva)
- NHTSA vPIC: decodificación del VIN, incluido el carácter del año de modelo que usa el veto Gen3 (se abre en una pestaña nueva)
- 49 CFR 565: requisitos del número de identificación del vehículo, la tabla de códigos de año de modelo (se abre en una pestaña nueva)
- ZeroManual: documentación de la comunidad sobre el diagnóstico de Zero Motorcycles (Internet Archive) (se abre en una pestaña nueva)
Esta es una especificación independiente, mantenida por la comunidad y elaborada por ingeniería inversa. Zero Motorcycles no la publica, avala ni revisa, y ninguna parte de ella debe tomarse como una descripción oficial del formato. Las disposiciones de registro cambian con el firmware (una moto de este corpus cambió el tamaño de su registro de telemetría entre dos exportaciones), así que comprueba con tus propios archivos antes de fiarte de cualquier desplazamiento de aquí.