Extraer los logs de Zero con una consola serie (PuTTY)
Cuando la descarga de la app falla o se queda a medias, un cable serie barato y un programa de terminal te dan el historial completo de logs de la moto como texto plano, y esa captura la puedes subir aquí igual que un archivo .bin.
Lo esencial
Conecta un adaptador serie USB-TTL de 3,3 V al puerto OBD-II de la moto (GND→5, RX→8, TX→9, +5 V sin conectar), pon la moto en ON, abre PuTTY a 38400 baudios (Gen2) con el registro de sesión en Todo lo que salga de la sesión, y escribe eventlogdump en el prompt ZERO MBB>. Guarda la captura y sube el archivo .txt/.log a Zero Logs Analyzer.
¿Para qué molestarse con un volcado de consola?
La forma normal de sacar los logs es la app oficial de Zero: emparejas por Bluetooth y luego Support → Email bike logs, que envía archivos binarios .bin propietarios. Esa vía tiene dos fallos conocidos:
- La app puede cerrarse antes de enviar el correo. En las versiones nuevas de Android se sabe que la app se cierra tras descargar los logs pero antes de enviarlos. Los archivos suelen seguir en el teléfono, en
Android/data/com.ZeroMotorcycles/files/, se haya enviado el correo o no. - Las descargas pueden truncarse sin avisar. Hemos visto un .bin real del MBB de 32 KB cuando la EEPROM completa del MBB es de 256 KB, con cerca del 87 % del historial sin descargar. El archivo se lee sin errores, así que quien lo tiene no ve que está truncado.
Un volcado de consola evita las dos cosas. Los logs que se obtienen por la consola serie llegan ya decodificados como texto plano, sin que la moto tenga que analizar nada binario, y el volcado empieza con una cabecera como Printing 5806 of 5806 log entries.. que dice sin rodeos cuántas entradas has capturado. Eso lo convierte en una comprobación fiable de una descarga .bin dudosa y, en las motos Gen2, recorre todo el almacén de logs.
Anatomía de un log de Zero muestra esa diferencia con extractos reales, con cada línea marcada según de dónde vienen sus palabras: texto que la propia moto guardó (lo que te da un volcado de consola) o nuestra decodificación de los bytes en bruto. Un binario Gen3 mezcla las dos cosas: sus registros de texto son palabras de la propia moto, y cada número que contiene es decodificación nuestra.
Los logs del BMS por la app solo están disponibles en los modelos de 2014 en adelante (se añadieron en la versión 1.0.8/1.0.9 de la app), y la extracción del BMS por Bluetooth puede ser muy lenta, que es otra razón por la que la vía del cable es popular para el trabajo detallado con la batería.
Gen2: conexión por cable
Las motos de la época Sevcon exponen una consola serie a nivel TTL en pines reservados al fabricante de un conector OBD-II (J1962). Son las S, DS, SR y DSR hasta 2023, las FX (2014–2025), FXS (2016–2021) y FXE (2022–2025), además de las antiguas XU y MX. (La S, la SR, la DS y la DSR conservaron su nombre al pasar a la plataforma Cypher III en 2024, así que mira el año y no la insignia: desde 2024 esas cuatro pertenecen a la sección Gen3 de más abajo.) El cableado no es OBD-II estándar, así que una herramienta de diagnosis ELM327 no sirve. Hablas con el MBB directamente con un adaptador serie USB-TTL y un programa de terminal, según la guía de la consola del MBB Gen2 de ZeroManual.
Cable casero (lado del conector OBD-II)
| Cable del adaptador | Pin OBD-II | Señal |
|---|---|---|
| Negro | 5 | Masa |
| Blanco (RX del adaptador) | 8 | TX del MBB |
| Verde (TX del adaptador) | 9 | RX del MBB |
| Rojo (+5 V) | — | Déjalo sin conectar; nunca alimentes la moto desde él |
Los colores de los cables siguen los de los cables USB-TTL habituales que describe la guía de cables de ZeroManual; mira la hoja de datos de tu adaptador si es distinto. Las señales son de lógica de 3,3 V: en pruebas de la comunidad algunos adaptadores TTL solo de 5 V no funcionan, así que usa uno compatible con 3,3 V.
¿Dónde está el puerto OBD-II?
| Plataforma / años | Ubicación |
|---|---|
| Plataforma S 2011–2012 | Zona del depósito, junto a la caja de fusibles |
| S/DS 2013 | Encima o detrás del motor, junto al puerto de carga de accesorios, lado izquierdo |
| S/DS 2014–2015 | En el mismo sitio, lado derecho |
| S/DS 2016+ | Bajo el asiento, lado izquierdo, detrás del mamparo del bastidor |
| FX / FXS (XMX) | Bajo los plásticos del depósito, lado izquierdo |
| SR/F, SR/S etc. (FST) 2020+ | Dentro del compartimento de almacenamiento del depósito |
Parámetros serie y configuración de PuTTY
Velocidad en baudios por generación
Antes de 2013: 9600
Época Sevcon (S, SR, DS, DSR hasta 2023, FX, FXS, FXE): 38400
Cypher III (SR/F, SR/S, DSR/X, S/F, y S/SR/DS/DSR desde 2024): 115200
Las motos de 2012 son una zona gris: a un propietario de un hilo le dijeron 38400 mientras que la wiki clasifica lo anterior a 2013 en 9600, así que prueba primero 38400 y luego 9600. En todas las generaciones: 8 bits de datos, sin paridad, 1 bit de parada (8-N-1), control de flujo desactivado, saltos de línea CR-LF.
La FXE es una moto Cypher II con carrocería de FX. Su MBB escribe el mismo archivo de 262.144 bytes MBB\0 que las demás motos de la época Sevcon, así que el procedimiento Gen2 y 38400 es lo que hay que probar. No tenemos ninguna captura de consola de una FXE que lo confirme, así que si 38400 solo te da basura, prueba 115200 antes de dar por hecho que el cable está mal.
PuTTY (Windows)
1. Tipo de conexión: Serial; Serial line: tu puerto COM (p. ej. COM4); Speed: 38400.
2. En Connection → Serial: 8 bits de datos, sin paridad, 1 bit de parada, control de flujo None.
3. En Session → Logging: pon el registro de sesión en Todo lo que salga de la sesión y elige un nombre de archivo (p. ej. putty.log). Hazlo antes de volcar, para que la captura quede en un archivo.
En Linux usa Minicom; en macOS CoolTerm o Serial; en Android BlueTerm (con el fin de línea de salida en CRLF). iOS no puede hacer Bluetooth SPP clásico en absoluto.
Procedimiento: conecta el cable al portátil, anota el puerto COM, conéctalo al puerto OBD de la moto, pon la moto en ON, abre el terminal y pulsa Intro una o dos veces. Deberías ver el prompt ZERO MBB>. Los comandos de solo lectura funcionan sin iniciar sesión; existe un comando login para cambios de configuración, pero sus contraseñas no están publicadas; los hilos de foros que las piden se responden en privado, si es que se responden.
Los comandos de volcado (Gen2)
Escribe help para ver el menú. Los que te interesan:
| Comando | Qué hace |
|---|---|
| eventlogdump | Imprime el log de eventos completo como texto decodificado (el volcado principal para analizar) |
| errorlogdump | Imprime el log de errores (fallos y avisos) |
| dumpall | Lo vuelca todo: estadísticas, entradas, ajustes y logs. Da alrededor de 1 MB de texto y puede tardar unos minutos; asegúrate antes de que el registro de sesión esté activado |
| help / status / stats / bms | Extras de solo lectura. bms muestra datos de la batería en vivo (SoC, tensiones por banco, equilibrado, aislamiento, temperaturas, ciclos) |
Qué aspecto tiene el volcado
Printing 5806 of 5806 log entries..
Entry Time of Log Event Conditions
05688 09/08/2012 17:42:28 Discharge level 065 AH, SOC: 46%, I:-13A,
L:3426, l:3383, H:3485, B:059, PT:032C,
BT:032C, PV:62418, M:Bike OnCaptura real de la consola del BMS de una moto de 2012 (documentada por la comunidad). La cabecera te dice exactamente cuántas entradas se imprimieron: si dice 5806 of 5806, lo tienes todo.
Los comandos destructivos están en el mismo menú
eventlogclear, errorlogclear, format eeprom, erase eeprom, settingsrst y un ajuste abs_disable están a un error de tecleo. Quédate con los comandos de volcado de solo lectura de arriba.
Las primeras motos (la época de 2012) exponen además una consola ZERO BMS> directamente en la batería, con su propio eventlogdump más los comandos balance / dobalance. En las Gen2 posteriores el BMS de cada batería sigue guardando su propio log de eventos, pero se accede a él a través del MBB (y tarda más). El acceso directo a la consola del BMS en los packs de 2013 en adelante no está documentado por la comunidad.
¿Y por Bluetooth?
La consola por Bluetooth se hace con un dongle repetidor enchufado al puerto OBD-II, no con la radio de la propia moto:
- El dongle DigiNow Data Reaper expone los pines OBD 8/9 como un terminal Bluetooth Serial Port Profile (SPP). Solo funciona en motos MY2012–2016: se alimenta de una fuente de 3,3 V del pin 12 del OBD que parece sin cablear desde 2017. En las de 2017 en adelante un cable USB sigue funcionando bien.
- ECMCables vendía un dongle SPP parecido, el OBDDROID (modelos 2013–2016), que la wiki de la comunidad marca como descatalogado.
- No uses un cable alargador OBD con estos dongles: se alimentan de un circuito pequeño y muy delicado de 3,3 V del MBB que cualquier cable extra atenúa demasiado.
- SPP significa que iOS no puede conectarse (iOS solo admite BLE para esto); Android, PC y Mac sí. Los PIN de emparejamiento no están documentados, así que consulta la documentación del fabricante de tu dongle.
ZERO MBB> por la radio integrada, así que considéralo no documentado y sin soporte. Lo que sí habla la radio integrada (su propio protocolo de comandos, con lecturas en vivo y la descarga del log) se explica en Cómo habla una Zero por Bluetooth.Gen3 / Cypher III (SR/F, SR/S, DSR/X, S/F, y S, SR, DS, DSR desde 2024)
Las motos Cypher III sí tienen una consola serie, con el mismo método del puerto OBD-II a 115200 baudios, con el puerto dentro del compartimento de almacenamiento del depósito (lo confirman la referencia de la consola Gen3 de ZeroManual y el propio boletín de servicio de Zero para la SR/F). Hay propietarios que han montado el mismo cable casero para la SR/F de MY2020. Los comandos del log de eventos son distintos de los de Gen2:
Todo lo que se documenta aquí viene de propietarios de SR/F y SR/S. La S, la SR, la DS y la DSR pasaron a la misma plataforma Cypher III en 2024 sin cambiar de nombre, así que esta sección es la que hay que usar de partida en una moto de 2024 o posterior de esas cuatro. Nadie ha publicado una captura de consola de una de ellas, ni nosotros tampoco, así que toma la velocidad en baudios y el conjunto de comandos como una primera suposición informada y no como un hecho documentado, y cuéntanos qué encuentras.
| Comando | Forma larga | Qué hace |
|---|---|---|
| eld # | eventlogdump | Volcado del log de eventos (# = las últimas n entradas, opcional) |
| elde # | eventlogdumpexhaustive | Volcado exhaustivo, la exportación de texto más completa |
| eldd # | eventlogdumpdate | Volcado desde una fecha (MM DD YYYY HH MM SS) |
| eldh | eventlogdumphex | Volcado en hexadecimal; necesita un decodificador de logs, así que sáltatelo |
- En Gen3 no hay un
errorlogdumpaparte; los fallos están bajo el comandofaults. (La variante exhaustivaeldees solo de Gen3; Gen2 no tiene equivalente.) - No está documentado si los comandos de volcado de Gen3 necesitan un
loginantes. Las capturas reales de la wiki también muestran líneas de fallo DEBUG asíncronas que se imprimen dentro de la sesión y se intercalarán con tu volcado; nuestro parser tolera ese ruido. - La vía de todos los días en Gen3 sigue siendo la app móvil (Support → Email bike logs), y esos archivos .bin se suben aquí como siempre. Los concesionarios usan en cambio el Zero Diagnostic Utility por una interfaz CAN, que lleva integrado «Pull All Logs».
Con la app ZeroLogs (Android)
Desde la versión 0.37, la app ZeroLogs para Android puede ocupar el lugar de PuTTY. Habla con la consola por el mismo cable o por un dongle, y deja la captura en su cola de subida.
- Cable USB. El mismo adaptador USB-TTL de 3,3 V y el mismo cableado de arriba, enchufado al teléfono mediante un adaptador USB-OTG. La app conoce los adaptadores CP210x, FTDI, CH34x y Prolific, se ofrece a abrir la consola cuando enchufas uno y averigua sola la velocidad en baudios.
- Dongle Bluetooth. Un Data Reaper o un OBDDROID en una moto de 2012 a 2016. Empareja antes en los ajustes de Bluetooth de Android. La app nunca ofrece el enlace Bluetooth de la propia moto, que no llega a la consola.
- Dónde encontrarlo. La pestaña Moto muestra una fila Consola serie cuando hay un adaptador enchufado o se ha usado un dongle. Una diagnosis también puede mandarte allí.
- Qué moto. Una captura no lleva ningún VIN, así que la app la archiva en la moto emparejada en la pestaña Moto y te enseña cuál antes de empezar.
- iPhone. No hay versión de la app para iPhone, así que desde un iPhone esto sigue siendo cosa de ordenador.
eventlogdump, errorlogdump, dumpall y status en Gen2, y eld, elde y faults en Gen3, donde son los comandos que han documentado los propietarios y nadie ha comprobado todavía con una captura. En la consola nunca envía login y no cambia ningún ajuste. Si la moto pide iniciar sesión, la app se detiene y no envía nada más.Subir tu captura a Zero Logs Analyzer
Toma el archivo que escribió PuTTY (p. ej. putty.log) y suéltalo en la página de subida, que acepta capturas .txt y .log además de archivos .bin. Algunas cosas que conviene saber:
Las capturas de consola no suelen contener tu VIN, así que el cargador te pide elegir una de tus motos o escribir el VIN de 17 caracteres.
Deja el tipo de log en detección automática, o ponlo a mano si sabes de qué consola salió el volcado.
El parser extrae las entradas con marca de tiempo (recorridos, cargas, SOC, tensiones de celda, temperaturas, errores) y las pasa a las mismas vistas de cronología, salud de la batería y diagnosis. Se puede subir la captura entera de la sesión; los prompts y la salida de help que rodean el volcado se ignoran.
La propia cabecera del volcado, Printing N of M log entries, dice cuántas entradas tiene el log; tras el análisis la comparamos con las que hemos leído y marcamos el informe como posiblemente incompleto si la captura parece truncada, de modo que un historial de terminal cortado nunca pase en silencio por un historial completo.
Seguridad y salvedades
- El consenso de la comunidad es que hablar con tu MBB o tu BMS es bajo tu propia responsabilidad y puede afectar a la garantía.
- Usa un adaptador serie de lógica de 3,3 V; se dice que los adaptadores TTL solo de 5 V no funcionan. Deja desconectado el cable de +5 V del adaptador para que no alimente la moto.
- La moto tiene que estar en ON durante la sesión. Los volcados largos pueden durar más que el tiempo de inactividad (el valor por defecto de Gen2 para
secidlees de 7200 s); el consejo de la comunidad durante las extracciones largas es dar de vez en cuando un golpe de acelerador para que la moto no se duerma. - Mantente lejos de los comandos destructivos de arriba; ejecuta solo los volcados de solo lectura.
- Sentido común (no es un procedimiento con fuente): desconecta el cable antes de rodar.
- Quienes trasteen con Gen1 sondeando directamente las cabeceras de la placa del MBB: ojo con la cabecera de alta tensión J5, que puede achicharrar tus herramientas.
Preguntas frecuentes
¿Necesito una contraseña para volcar los logs de una Zero Motorcycle por la consola?
En las motos Gen2, los comandos de solo lectura como help, status y eventlogdump funcionan sin iniciar sesión. Existe un comando login para cambiar la configuración, pero sus contraseñas no están publicadas. No está documentado si los comandos de volcado de Gen3 exigen antes un login.
¿Funciona un escáner OBD-II normal (ELM327) en una Zero Motorcycle?
No. Zero usa la forma del conector OBD-II, pero conecta pines reservados al fabricante a una consola serie de nivel TTL, no a los protocolos OBD-II estándar. Necesitas un adaptador serie USB-TTL de 3,3 V y un programa de terminal, no una herramienta de escaneo.
¿Puedo llegar a la consola por el Bluetooth integrado de la moto?
No hay ninguna forma documentada. La radio integrada de la moto solo está documentada como servicio de la app móvil oficial de Zero, por Bluetooth serie clásico (SPP) en las Gen2 y por Bluetooth LE en las Gen3. La consola por Bluetooth solo está documentada con dongles de retransmisión de posventa enchufados al puerto OBD-II, y esos solo se encienden en las motos MY2012-2016.
¿Qué archivo subo a Zero Logs Analyzer después de un volcado por consola?
Sube la captura completa de la sesión de PuTTY (putty.log o cualquier archivo .txt/.log). Los prompts y la salida de ayuda alrededor del volcado no importan: el parser localiza solo la tabla de entradas del log. Elige tu moto o escribe tu VIN al subirlo, porque las capturas de texto no lo contienen de forma fiable.
¿Es mejor un volcado por consola que los archivos .bin de la app de Zero?
Se admiten los dos. Un volcado por consola llega completamente decodificado como texto plano y su cabecera «Printing N of M log entries» dice exactamente cuántas entradas capturaste, lo que lo convierte en una comprobación cruzada fiable cuando las descargas de la app fallan o se truncan en silencio.
Nota: a veces zeromanual.com no está disponible; si un enlace a la wiki no funciona, la Wayback Machine tiene copias de todas las páginas citadas abajo.
Fuentes:
- ZeroManual: Gen2 MBB Console (se abre en una pestaña nueva)
- ZeroManual: Gen3 MBB Console (se abre en una pestaña nueva)
- ZeroManual: How to build a cable to access the MBB (se abre en una pestaña nueva)
- ZeroManual: OBD-II Port (se abre en una pestaña nueva)
- ZeroManual: OBD-II Port Location (se abre en una pestaña nueva)
- ZeroManual: Logs (se abre en una pestaña nueva)
- ZeroManual: Official Mobile Application (se abre en una pestaña nueva)
- ZeroManual: DigiNow Data Reaper Dongle (se abre en una pestaña nueva)
- EMF: List of existing commands for the Zero MBB and BMS (se abre en una pestaña nueva)
- EMF: Zero SR/F MY2020 OBD cable to serial console (se abre en una pestaña nueva)
- Zero/NHTSA service bulletin SV-ZMC-020-405 (SR/F log pulls, ZDU) (se abre en una pestaña nueva)
- PuTTY manual, ch. 4.2: session logging (se abre en una pestaña nueva)
Los detalles de acceso a la consola se basan en documentación de la comunidad e ingeniería inversa, principalmente el Manual no oficial de Zero. Zero Motorcycles no ofrece soporte oficial al acceso del propietario a la consola, así que procede bajo tu propia responsabilidad.