Aller au contenu
zerologs
Retour au sommaire
Guide de la console série

Extraire les logs Zero par la console série (PuTTY)

Quand le téléchargement par l’appli échoue ou tronque, un câble série bon marché et un programme de terminal vous donnent tout l’historique de logs de la moto en texte brut, et vous pouvez importer cette capture ici comme un fichier .bin.

Dernière mise à jour : 10 novembre 2026

En bref

Branchez un adaptateur série USB-TTL 3,3 V sur le port OBD-II de la moto (GND→5, RX→8, TX→9, +5 V non connecté), mettez le contact, ouvrez PuTTY à 38400 bauds (Gen2) avec la journalisation de session réglée sur All session output, et tapez eventlogdump à l’invite ZERO MBB>. Enregistrez la capture et importez le fichier .txt/.log dans Zero Logs Analyzer.

Pourquoi passer par un dump de console ?

La voie normale pour obtenir les logs est l’appli Zero officielle : appairage en Bluetooth, puis Support → Email bike logs, qui envoie des fichiers binaires .bin propriétaires. Cette voie a deux modes de défaillance connus :

  • L’appli peut planter avant d’envoyer l’e-mail. Sur les versions récentes d’Android, l’appli est connue pour planter après avoir téléchargé les logs mais avant de les envoyer. Les fichiers sont en général toujours sur le téléphone, dans Android/data/com.ZeroMotorcycles/files/, que l’e-mail soit parti ou non.
  • Les téléchargements peuvent être tronqués sans bruit. Nous avons vu un vrai .bin MBB de 32 Ko alors que l’EEPROM complète du MBB fait 256 Ko, soit environ 87 % de l’historique manquant. Le fichier s’analyse sans erreur : la troncature est donc invisible pour le propriétaire.

Un dump de console évite les deux. Les logs obtenus par la console série arrivent entièrement décodés en texte brut, sans aucune analyse binaire à faire côté moto, et le dump commence par un en-tête comme Printing 5806 of 5806 log entries.. qui dit sans détour combien d’entrées vous avez capturées. C’est un contrôle de recoupement fiable face à un téléchargement .bin suspect, et sur les Gen2 il parcourt tout le stockage des logs.

Anatomie d’un log Zero montre cette différence avec de vrais extraits, chaque ligne étant marquée selon l’origine de ses mots : du texte que la moto a elle-même stocké (ce que vous donne un dump de console) ou notre décodage des octets bruts. Un binaire Gen3 mélange les deux : ses enregistrements de texte sont les mots de la moto, et chaque chiffre qu’il contient est notre décodage.

Les logs BMS par l’appli ne sont disponibles que sur les modèles 2014 et suivants (ajoutés dans l’appli v1.0.8/1.0.9), et l’extraction du BMS par Bluetooth peut être très lente, ce qui est une autre raison pour laquelle la voie par câble est populaire pour le travail détaillé sur la batterie.

Gen2 : se connecter par câble

Les motos de l’ère Sevcon exposent une console série de niveau TTL sur des broches réservées au constructeur d’un connecteur OBD-II (J1962). Ce sont les S, DS, SR et DSR jusqu’à 2023, les FX (2014–2025), FXS (2016–2021) et FXE (2022–2025), plus les anciennes XU et MX. (Les S, SR, DS et DSR ont gardé leur nom en passant à la plateforme Cypher III en 2024 : vérifiez donc l’année, pas le badge : à partir de 2024, ces quatre-là relèvent de la section Gen3 plus bas.) Le câblage n’est pas de l’OBD-II standard : un outil de diagnostic ELM327 ne fonctionnera donc pas. Vous parlez directement au MBB avec un adaptateur série USB-TTL et un programme de terminal, selon le guide de la console MBB Gen2 de ZeroManual.

Brochage du câble à faire soi-même (côté fiche OBD-II)

Fil de l’adaptateurBroche OBD-IISignal
Noir5Masse
Blanc (RX de l’adaptateur)8Émission du MBB
Vert (TX de l’adaptateur)9Réception du MBB
Rouge (+5 V)—À laisser non connecté ; ne jamais réalimenter la moto

Les couleurs de fil suivent les câbles USB-TTL courants décrits dans le guide du câble de ZeroManual ; vérifiez la fiche technique de votre adaptateur s’il diffère. Les signaux sont en logique 3,3 V : des tests communautaires ont montré que certains adaptateurs TTL 5 V seulement ne fonctionnent pas : utilisez donc un adaptateur compatible 3,3 V.

Où est le port OBD-II ?

Plateforme / annéesEmplacement
Plateforme S 2011–2012Zone du réservoir, près du bloc de fusibles
S/DS 2013Au-dessus/derrière le moteur, près du port de charge accessoire, côté gauche
S/DS 2014–2015Même endroit, côté droit
S/DS 2016+Sous la selle, côté gauche, derrière la cloison du cadre
FX / FXS (XMX)Sous les plastiques du réservoir, côté gauche
SR/F, SR/S etc. (FST) 2020 et suivantesDans le compartiment de rangement du réservoir

Paramètres série et réglage de PuTTY

Débit selon la génération

Avant 2013 : 9600

Ère Sevcon (S, SR, DS, DSR jusqu’à 2023, FX, FXS, FXE) : 38400

Cypher III (SR/F, SR/S, DSR/X, S/F, et S/SR/DS/DSR à partir de 2024) : 115200

Les motos de 2012 sont une zone grise : un propriétaire d’un fil de discussion s’est vu répondre 38400 alors que le wiki classe les avant-2013 à 9600 : essayez donc 38400 d’abord, puis 9600. Toutes générations : 8 bits de données, pas de parité, 1 bit d’arrêt (8-N-1), contrôle de flux désactivé, fins de ligne CR-LF.

La FXE est une moto Cypher II dans une caisse de FX. Son MBB écrit le même fichier de 262 144 octets MBB\0 que les autres motos de l’ère Sevcon : la procédure Gen2 et 38400 sont donc ce qu’il faut essayer. Nous n’avons aucune capture de console de FXE pour le confirmer : si 38400 ne donne que du charabia, essayez 115200 avant de conclure que le câble est en cause.

PuTTY (Windows)

1. Type de connexion : Serial ; ligne série : votre port COM (par ex. COM4) ; vitesse : 38400.

2. Sous Connection → Serial : 8 bits de données, pas de parité, 1 bit d’arrêt, contrôle de flux None.

3. Sous Session → Logging : réglez la journalisation de session sur All session output et choisissez un nom de fichier (par ex. putty.log). Faites-le avant de lancer le dump, afin que la capture arrive dans un fichier.

Sous Linux, utilisez Minicom ; sous macOS, CoolTerm ou Serial ; sous Android, BlueTerm (réglez la fin de ligne sortante sur CRLF). iOS ne gère pas du tout le Bluetooth SPP classique.

Procédure : branchez le câble sur l’ordinateur, notez le port COM, connectez-vous au port OBD de la moto, mettez le contact, ouvrez le terminal et appuyez sur Entrée une ou deux fois. Vous devriez voir l’invite ZERO MBB>. Les commandes en lecture seule fonctionnent sans connexion ; une commande login existe pour les changements de configuration, mais ses mots de passe ne sont pas publiés ; les fils de discussion qui les demandent reçoivent une réponse en privé, quand ils en reçoivent une.

Les commandes de dump (Gen2)

Tapez help pour voir le menu. Celles qui vous intéressent :

CommandeCe que ça fait
eventlogdumpImprime tout le journal d’événements sous forme de texte décodé (le dump principal pour l’analyse)
errorlogdumpImprime le journal d’erreurs (défauts et avertissements)
dumpallDump complet : statistiques, entrées, réglages et logs. Produit environ 1 Mo de texte et peut prendre quelques minutes ; vérifiez d’abord que la journalisation de session est activée
help / status / stats / bmsCompléments en lecture seule. bms affiche les données en direct de la batterie (SoC, tensions par groupe, équilibrage, isolation, températures, cycles)

À quoi ressemble le dump

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 On

Capture réelle de la console BMS d’une moto de 2012 (documentée par la communauté). L’en-tête vous dit exactement combien d’entrées ont été imprimées : s’il indique 5806 of 5806, vous avez tout.

Les commandes destructrices sont dans le même menu

eventlogclear, errorlogclear, format eeprom, erase eeprom, settingsrst et le réglage abs_disable sont à une faute de frappe. Tenez-vous-en aux commandes de dump en lecture seule ci-dessus.

Les premières motos (ère 2012) exposent aussi une console distincte ZERO BMS> directement sur la batterie, avec ses propres commandes eventlogdump et balance / dobalance. Sur les Gen2 plus récentes, le BMS de chaque batterie garde toujours son propre journal d’événements, mais on y accède par le MBB (et c’est plus long). L’accès direct à la console du BMS sur les batteries 2013 et suivantes n’est pas documenté par la communauté.

Et le Bluetooth ?

La console par Bluetooth se fait avec un boîtier relais branché sur le port OBD-II, pas avec la radio propre de la moto :

  • Le boîtier DigiNow Data Reaper exposait les broches OBD 8/9 comme un terminal Bluetooth Serial Port Profile (SPP). Il ne marche que sur les motos MY2012–2016 : il s’alimente depuis une source 3,3 V sur la broche OBD 12 qui semble non câblée à partir de 2017. Sur les 2017 et suivantes, un câble USB fonctionne toujours très bien.
  • ECMCables vendait un boîtier OBDDROID SPP similaire (modèles 2013–2016), que le wiki communautaire marque comme abandonné.
  • N’utilisez pas de rallonge OBD avec ces boîtiers : ils tirent leur énergie d’un petit circuit MBB 3,3 V très délicat que toute rallonge supplémentaire atténue trop.
  • Le SPP implique que iOS ne peut pas se connecter (iOS ne gère que le BLE pour cela) ; Android, PC et Mac le peuvent. Les codes d’appairage ne sont pas documentés : consultez la documentation du fournisseur de votre boîtier.
La radio intégrée ne le fera pas. Le Bluetooth propre de la moto (Gen2 2013 et suivantes) n’est documenté que pour servir l’appli Zero officielle, en Bluetooth classique série (SPP) ; le Bluetooth LE est la radio Gen3. Aucune source ne documente l’accès à la console brute ZERO MBB> par la radio intégrée : considérez donc cela comme non documenté et non pris en charge. Ce que la radio intégrée parle réellement (son propre protocole de commandes, avec les mesures en direct et le téléchargement du log) est détaillé dans Comment une Zero parle en Bluetooth.

Gen3 / Cypher III (SR/F, SR/S, DSR/X, S/F, et S, SR, DS, DSR à partir de 2024)

Les motos Cypher III ont bien une console série, avec la même approche par le port OBD-II à 115200 bauds, le port se trouvant dans le compartiment de rangement du réservoir (confirmé à la fois par la référence de la console Gen3 de ZeroManual et par le bulletin de service SR/F de Zero lui-même). Des propriétaires ont construit le même câble maison pour la SR/F MY2020. Les commandes du journal d’événements diffèrent de celles de la Gen2 :

Tout ce qui est documenté ici vient de propriétaires de SR/F et de SR/S. Les S, SR, DS et DSR sont passées sur la même plateforme Cypher III en 2024 sans changer de nom : cette section est donc celle par laquelle commencer sur une moto 2024 ou plus récente de ces quatre-là. Personne n’a publié de capture de console de l’une d’elles, et nous non plus : considérez donc le débit et le jeu de commandes comme une première hypothèse éclairée plutôt que comme un fait documenté, et dites-nous ce que vous trouvez.

CommandeForme longueCe que ça fait
eld #eventlogdumpDump du journal d’événements (# = les n dernières entrées, facultatif)
elde #eventlogdumpexhaustiveDump exhaustif, l’export texte le plus complet
eldd #eventlogdumpdateDump à partir d’une date (MM JJ AAAA HH MM SS)
eldheventlogdumphexDump hexadécimal ; il demande un décodeur de logs : passez votre chemin
  • Il n’y a pas de errorlogdump distinct sur Gen3 ; les défauts se trouvent sous la commande faults à la place. (La variante exhaustive elde est propre à la Gen3 ; la Gen2 n’a pas d’équivalent.)
  • Savoir si les commandes de dump Gen3 demandent d’abord un login n’est pas documenté. Les vraies captures du wiki montrent aussi des lignes de défaut DEBUG asynchrones qui s’impriment dans la session et s’entremêlent avec votre dump ; notre parseur tolère ce bruit.
  • La voie courante sur Gen3 reste l’appli mobile (Support → Email bike logs), et ces fichiers .bin s’importent ici comme d’habitude. Les concessionnaires utilisent plutôt le Zero Diagnostic Utility sur une interface CAN, qui intègre « Pull All Logs ».
Les mises à jour du firmware effacent les logs de la moto. Le bulletin de service de Zero demande aux concessionnaires de récupérer les logs avant la mise à jour « because this process erases the existing logs ». Sur Gen3, les mises à jour OTA peuvent aussi arriver par le réseau cellulaire une fois la moto enregistrée dans l’appli. Exportez vos logs avant toute mise à jour du firmware.

Avec l’appli ZeroLogs (Android)

À partir de la version 0.37, l’appli ZeroLogs pour Android peut remplacer PuTTY. Elle parle à la console par le même câble ou par un boîtier, et place la capture dans sa file d’import pour vous.

  • Câble USB. Le même adaptateur USB-TTL 3,3 V et le même câblage que ci-dessus, branchés sur le téléphone avec un adaptateur USB-OTG. L’appli connaît les adaptateurs CP210x, FTDI, CH34x et Prolific, propose d’ouvrir la console quand vous en branchez un, et trouve le débit toute seule.
  • Boîtier Bluetooth. Un Data Reaper ou un OBDDROID sur une moto de 2012 à 2016. Appairez-le d’abord dans les réglages Bluetooth d’Android. L’appli ne propose jamais la liaison Bluetooth propre de la moto, qui n’atteint pas la console.
  • Où le trouver. L’onglet Moto affiche une ligne Console série dès qu’un adaptateur est branché ou qu’un boîtier a été utilisé. Un diagnostic peut aussi vous y envoyer.
  • Quelle moto. Une capture ne contient aucun VIN : l’appli la range donc sous la moto appairée dans l’onglet Moto et vous montre laquelle avant que vous commenciez.
  • iPhone. Il n’y a pas de version iPhone de l’appli : sur un iPhone, cela reste un travail d’ordinateur.
En lecture seule par conception. L’appli n’envoie que les commandes de dump de cette page : eventlogdump, errorlogdump, dumpall et status sur Gen2, et eld, elde et faults sur Gen3, où ce sont les commandes que des propriétaires ont documentées et que personne n’a encore vérifiées face à une capture. Sur la console, elle n’envoie jamais login et ne change aucun réglage. Si la moto demande une connexion, l’appli s’arrête et n’envoie plus rien.

Importer votre capture dans Zero Logs Analyzer

Prenez le fichier qu’a écrit PuTTY (par ex. putty.log) et déposez-le sur la page d’import, qui accepte les captures .txt et .log en plus des fichiers .bin. Quelques points à savoir :

1
Dites-nous à quelle moto il appartient

Les captures de console ne contiennent pas de façon fiable votre VIN : l’outil d’import vous demande donc de choisir l’une de vos motos ou de saisir le VIN à 17 caractères.

2
MBB ou BMS est détecté automatiquement

Laissez le type de log sur détection automatique, ou réglez-le à la main si vous savez de quelle console vient le dump.

3
Même analyse qu’un fichier .bin

L’analyseur extrait les entrées horodatées (trajets, recharges, SOC, tensions de cellule, températures, erreurs) et alimente la même chronologie, la même santé de batterie et les mêmes vues de diagnostic. Vous pouvez importer toute la capture de la session ; les invites et la sortie help autour du dump sont ignorées.

4
La complétude est vérifiée automatiquement

L’en-tête propre au dump, Printing N of M log entries indique combien d’entrées contient le log ; après l’analyse, nous comparons cela au nombre que nous avons lu, et nous signalons le rapport comme suspect incomplete si la capture semble tronquée, pour qu’un historique de terminal coupé ne passe jamais en silence pour un historique complet.

Sécurité et réserves

  • Le consensus de la communauté est que dialoguer avec votre MBB ou votre BMS se fait à vos risques et peut affecter votre garantie.
  • Utilisez un adaptateur série en logique 3,3 V ; d’après les témoignages, les adaptateurs TTL 5 V seulement ne fonctionnent pas. Laissez le fil +5 V de l’adaptateur débranché pour que rien ne réalimente la moto.
  • La moto doit avoir le contact mis pendant toute la session. Les longs dumps peuvent dépasser le délai d’inactivité (par défaut sur Gen2 secidle : 7200 s) ; le conseil de la communauté pendant les longues extractions est de donner de temps en temps un coup de gaz pour garder la moto éveillée.
  • Évitez les commandes destructrices listées plus haut ; n’exécutez que les dumps en lecture seule.
  • Bon sens (pas une procédure sourcée) : débranchez le câble avant de rouler.
  • Bricoleurs Gen1 qui sondent directement les connecteurs de la carte MBB : attention au connecteur haute tension J5, qui peut griller vos outils.

FAQ

Ai-je besoin d’un mot de passe pour télécharger les logs d’une Zero Motorcycle par la console ?

Sur les motos Gen2, les commandes en lecture seule comme help, status et eventlogdump fonctionnent sans connexion. Une commande login existe pour modifier la configuration, mais ses mots de passe ne sont pas publiés. On ne sait pas, faute de documentation, si les commandes de téléchargement Gen3 exigent d’abord une connexion.

Un lecteur OBD-II classique (ELM327) fonctionne-t-il sur une Zero Motorcycle ?

Non. Zero reprend la forme du connecteur OBD-II mais câble des broches réservées au constructeur sur une console série de niveau TTL, et non sur les protocoles OBD-II standard. Il vous faut un adaptateur série USB-TTL 3,3 V et un programme de terminal, pas un outil de diagnostic.

Puis-je atteindre la console par le Bluetooth intégré de la moto ?

Aucune méthode documentée n’existe. La radio intégrée de la moto n’est documentée que comme servant l’appli mobile officielle de Zero, en série Bluetooth classique (SPP) sur les Gen2 et en Bluetooth LE sur les Gen3. La console par Bluetooth n’est documentée qu’avec des dongles relais du marché de l’accessoire branchés sur le port OBD-II, et ceux-ci ne s’allument que sur les motos MY2012-2016.

Quel fichier envoyer à Zero Logs Analyzer après un téléchargement par la console ?

Envoyez toute la capture de la session PuTTY (putty.log ou n’importe quel fichier .txt/.log). Les invites et la sortie de help autour du téléchargement ne gênent pas : l’analyseur repère tout seul le tableau des entrées de log. Choisissez votre moto ou saisissez votre VIN pendant l’envoi, car les captures de texte ne le contiennent pas de façon fiable.

Un téléchargement par la console vaut-il mieux que les fichiers .bin de l’appli Zero ?

Les deux sont pris en charge. Un téléchargement par la console arrive entièrement décodé en texte brut et son en-tête « Printing N of M log entries » indique exactement combien d’entrées vous avez capturées, ce qui en fait un recoupement fiable quand les téléchargements de l’appli échouent ou se tronquent en silence.

Remarque : zeromanual.com est parfois inaccessible ; si un lien du wiki est en panne, la Wayback Machine conserve des instantanés de chaque page citée ci-dessous.

Les détails de l’accès console reposent sur la documentation communautaire et la rétro-ingénierie, principalement le Manuel Zero non officiel. Zero Motorcycles n’offre aucun support officiel pour l’accès console des propriétaires, donc procédez à vos risques.