# Banc de diagnostic Bosch eBike Gen 2

Outil d'**écoute passive** du bus CAN d'un système Bosch Classic Line / eBike System 2
(moteur *Drive Unit*, batterie *PowerPack*, afficheur *Intuvia*). Objectif :
diagnostiquer une panne (ici une **Error 500**) et comprendre le comportement du
système, **sur ta propre machine, sans rien modifier**.

> Écoute seule (`listen-only`) : l'ESP32 n'émet **rien** sur le bus, pas même
> l'acquittement CAN. On observe, on ne touche pas. Aucun risque de bloquer le moteur.

## 1. Ce que l'outil fait

- Se branche sur le bus CAN Bosch (**125 kbit/s**) et affiche chaque trame :
  horodatage, identifiant, longueur, octets bruts.
- **Reconnaît et nomme** les identifiants connus (vitesse, couple, puissance moteur,
  statut batterie, température, etc.).
- Toutes les 3 s, affiche un **bilan de présence** : quels composants parlent sur le bus.
- **Réponse clé pour ta Error 500** : il te dit si le **Drive Unit (moteur) émet
  encore** ses trames (`0x048`, `0x0d1`, `0x0d3`, `0x0d4`…).
  - Moteur **présent** → le contrôleur vit, la 500 vient plutôt d'un capteur/sous-système.
  - Moteur **muet** alors que la batterie (`0x101`) parle → contrôleur moteur HS ou
    qui ne démarre pas : cohérent avec un vrai défaut interne (500).

## 1 bis. Deux versions du logiciel

Le projet contient deux sketches, à choisir selon ce que tu veux faire.

### `bosch_gen2_sniffer.ino` — LECTURE SEULE (recommandé)
Écoute passive (`listen-only`). L'ESP32 n'émet **rien** sur le bus, pas même
l'acquittement CAN. Aucun risque. C'est la version à utiliser par défaut, et
largement suffisante pour diagnostiquer une Error 500 (voir si le moteur parle
encore sur le bus).

### `bosch_gen2_diag_rw.ino` — LECTURE + ÉCRITURE (diagnostic actif)
Même lecture, mais l'ESP32 peut aussi **émettre** des trames que tu saisis, pour
le diagnostic actif (envoyer une requête, observer la réponse, sonder le
protocole). À réserver à un système **démonté sur l'établi**.

> ⚠️ En émission, l'ESP32 agit réellement sur le bus. Une trame mal placée peut
> mettre le système en défaut (en général récupérable par un cycle
> d'alimentation). Jamais sur un vélo en état de rouler.

Sécurité et commandes (moniteur série, 115200 bauds) :

```
AIDE                    affiche l'aide
ARMER                   autorise l'émission (verrouillée au démarrage)
STOP                    reverrouille l'émission
TX <id> <o0> <o1> ...   émet une trame, id et octets en hexa
                        exemple : TX 0x101 00 11 22 33
```

L'émission est **verrouillée au démarrage** : il faut taper `ARMER` pour
l'autoriser. Cet outil est neutre : il n'envoie que les trames que tu tapes, il
ne contient aucune charge de modification (pas de débridage, pas de changement de
paramètre). Et il ne débloque pas le sous-code de la 500, car cette lecture passe
par un handshake d'authentification Bosch non cassé publiquement.

## 2. Liste d'achat (pas cher)

| Élément | Détail | ~Prix |
|---|---|---|
| **ESP32** (tu l'as / en prends un) | n'importe quelle carte DevKit ESP32 | 8–12 CHF |
| **Transceiver CAN SN65HVD230** | module 3.3 V (VERSION 3.3 V, pas le MCP2551 en 5 V) | 3–6 CHF |
| Fils Dupont + breadboard | pour relier | 5 CHF |
| **Multimètre** | pour repérer les fils CAN-H / CAN-L / GND | tu en as un ? |

> Prends bien le **SN65HVD230** (3.3 V) : il parle directement à l'ESP32. Le MCP2551
> est en 5 V et demanderait un adaptateur de niveau, inutilement compliqué.

## 3. Câblage

```
ESP32 GPIO5 (TX) ──────> transceiver  D / TXD / CTX
ESP32 GPIO4 (RX) <────── transceiver  R / RXD / CRX
ESP32 3V3        ──────> transceiver  VCC (3.3 V !)
ESP32 GND        ──────> transceiver  GND ──┬── GND du bus Bosch
                                            │
transceiver CANH ───────────────────────── CAN-H du bus Bosch
transceiver CANL ───────────────────────── CAN-L du bus Bosch
```

- **Ne pas** ajouter de résistance de terminaison 120 Ω : le bus Bosch est déjà terminé,
  on fait juste une prise en parallèle.
- La masse (GND) de l'ESP32 **doit** être commune avec celle du bus Bosch.

### Trouver les fils CAN-H / CAN-L sur le Bosch

C'est la partie physique à faire soigneusement :
- Le bus passe dans les câbles entre moteur, batterie et afficheur (3 fils utiles +
  une ligne 5 V de réveil).
- Au multimètre, au repos CAN-H et CAN-L sont tous deux ~2,5 V par rapport à GND, et
  ils « bougent » en opposition quand ça communique.
- Références communautaires pour le brochage exact des connecteurs Bosch Gen 2 :
  - Wiki : <https://apollo.open-resource.org/lab:wip:bosch> (carte des IDs CAN)
  - Fil Endless-Sphere (lecture batterie PowerPack en CAN 125k, montage ESP32) :
    recherche « Reading a Bosch Classic Line PowerPack over CAN 125 kbit/s ».

> La batterie émet spontanément son statut (~toutes les 250 ms) dès qu'elle est
> alimentée : c'est le signal le plus facile pour **valider ton montage** avant même
> de brancher le moteur. Si tu vois `0x101` défiler, ton câblage est bon.

## 4. Flasher et utiliser

1. Arduino IDE → installer le support **ESP32** (Boards Manager : "esp32" par Espressif).
2. Ouvrir `bosch_gen2_sniffer.ino`, sélectionner ta carte ESP32, flasher.
3. Ouvrir le **Moniteur série à 115200 bauds**.
4. Alimenter le système Bosch sur l'établi et observer.

Pour **journaliser** une session (utile pour analyser après coup), tu peux capturer la
sortie série dans un fichier, par ex. sous macOS/Linux :

```
# remplace /dev/tty.usbserial-XXXX par ton port
screen -L -Logfile session_bosch.log /dev/tty.usbserial-XXXX 115200
```

## 5. Ce que l'outil ne fait PAS (honnêteté)

- Il **ne lit pas le sous-code détaillé** derrière l'Error 500 comme l'outil Bosch
  d'atelier : cette lecture se fait par une requête authentifiée vers le moteur, et ce
  handshake d'authentification **n'est pas cassé publiquement**. On ne va pas inventer.
- Il **ne modifie rien** et ne déverrouille rien : c'est un observateur.
- Les décodages de valeurs marqués `<... ?>` sont des **hypothèses** (sens connu, mais
  position exacte des octets à confirmer par observation). On affinera les décodeurs
  ensemble une fois qu'on verra les trames réelles bouger.

## 6. Prochaines étapes possibles

1. **Valider le montage** sur la batterie seule (voir `0x101`).
2. **Alimenter le moteur** et regarder le bilan : le Drive Unit parle-t-il ?
3. **Provoquer/observer la 500** : voir la séquence des trames juste avant la coupure.
4. Affiner les **décodeurs** (vitesse, tension, courant, température) par corrélation.
5. (Plus tard) petit **tableau de bord web** servi par l'ESP32 en WiFi, pour visualiser
   en direct sur le téléphone au lieu du moniteur série.
