Firmware

Structure du Projet PlatformIO

Arborescence du projet firmware avec descriptions des fichiers.

firmware/
├── platformio.ini               # Configuration PlatformIO (board, libs, flags)
├── src/
│   ├── main.cpp                 # Point d'entree — setup() + loop()
│   ├── config.h                 # Constantes, seuils, pins, URLs
│   ├── obd_manager.h/.cpp       # Connexion BLE OBDLink CX + lecture PIDs
│   ├── fiber_manager.h/.cpp     # Connexion BLE SUNKENET + controle couleur
│   ├── modem_manager.h/.cpp     # Modem A7670 — AT commands, HTTP, SMS, GPS
│   ├── power_manager.h/.cpp     # Surveillance Vbatt, deep sleep, survie
│   ├── telemetry.h/.cpp         # Compilation payload JSON + upload cloud
│   ├── ota_manager.h/.cpp       # Mise a jour OTA via 4G
│   └── espnow_sender.h/.cpp     # Envoi telemetrie vers ecran Sunton (optionnel)
├── data/
│   ├── ca_cert.pem              # Certificat CA du serveur CarTrack
│   └── nvs_keys.csv             # Template cles NVS (token, wifi, etc.)
├── test/
│   ├── test_pid_parser.cpp      # Tests unitaires parsing PIDs OBD
│   ├── test_power_logic.cpp     # Tests logique de survie batterie
│   └── test_telemetry_json.cpp  # Tests compilation payload JSON
├── lib/
│   └── README                   # Librairies locales (si necessaire)
└── include/
    └── README                   # Headers partages

Build & Flash

Commandes PlatformIO pour compiler et flasher le firmware sur la LilyGO T-A7670G.

Implementation PIDs BMW M57

Details d'implementation des requetes OBD standard et UDS proprietaires BMW.

Sequence d'initialisation UDS

Avant de pouvoir lire les PIDs BMW proprietaires, le firmware doit executer la sequence suivante sur l'OBDLink CX :

// 1. Reset ELM327
sendATCommand("ATZ\r");                  // Reset complet
waitForResponse("ELM327", 3000);

// 2. Configuration de base
sendATCommand("ATE0\r");                 // Echo OFF
sendATCommand("ATL0\r");                 // Linefeeds OFF
sendATCommand("ATS0\r");                 // Spaces OFF (reponses compactes)
sendATCommand("ATH1\r");                 // Headers ON (pour voir les CAN IDs)
sendATCommand("ATSP6\r");               // Protocole ISO 15765-4 CAN 500kbps

// 3. Configuration header CAN BMW
sendATCommand("AT SH 7E0\r");           // Header CAN ECU BMW (requete)
// Reponses viendront avec header 7E8 (ECU response)

// 4. Ouverture session diagnostic etendue
sendATCommand("10 03\r");               // UDS: Extended Diagnostic Session
// Reponse attendue: 50 03 (positive response)
// Si 7F 10 12: session non supportee — verifier le header CAN

// 5. Maintien session (toutes les 2s)
// La session UDS expire apres 5s sans activite
// Envoyer periodiquement: "3E 00\r" (TesterPresent)

Parsing des reponses UDS BMW

Les reponses UDS BMW suivent le format 62 XX XX DD DD ou 62 est le positive response code de ReadDataByIdentifier, XX XX est le DID demande, et DD DD sont les octets de donnees.

// Exemple: Pression common rail (DID 1233)
// Requete: "22 1233\r"
// Reponse: "62 1233 05 DC"
// Parsing: pressure = (0x05 * 256 + 0xDC) = 1500 bar
//
// Exemple: Charge suie DPF (DID 123B)
// Requete: "22 123B\r"
// Reponse: "62 123B 00 1E"
// Parsing: soot = (0x00 * 256 + 0x1E) / 10 = 3.0 g
//
// Chaque DID a sa propre formule de conversion.
// Les formules sont definies dans config.h sous forme de macros.

Protocole BLE SUNKENET — Detail

Format des commandes BLE envoyees au controleur fibre optique SUNKENET.

Format des commandes

Les commandes sont envoyees via write without response sur la characteristique FFE1 du service FFE0. Le format est un tableau d'octets :

Couleurs predefinies CarTrack

Processus OTA — Detail Technique

Implementation detaillee de la mise a jour Over-The-Air via le modem 4G.

Schema de partitions

# Partition Table (partitions.csv)
# Name,    Type, SubType, Offset,  Size
nvs,       data, nvs,     0x9000,  0x5000    # NVS chiffre (token, config)
otadata,   data, ota,     0xe000,  0x2000    # Metadata OTA (partition active)
app0,      app,  ota_0,   0x10000, 0x1E0000  # Firmware slot A
app1,      app,  ota_1,   0x1F0000,0x1E0000  # Firmware slot B
spiffs,    data, spiffs,  0x3D0000,0x30000   # Certificats, fichiers config

Flux OTA detaille

Debugging

Outils et techniques pour diagnostiquer les problemes firmware.

Serial Monitor

Le firmware emet des logs structures sur le port serie a 115200 baud. Format : [timestamp_ms] [MODULE] message.

[1234] [BOOT] CarTrack Firmware v1.0.0 — LilyGO T-A7670G
[1240] [POWER] Vbatt = 12.65V (OK)
[1890] [MODEM] AT OK — SIM READY — Signal: 18/31
[2100] [GPS] Fix acquired: 48.8566, 2.3522
[3200] [BLE] OBDLink CX connected (FFF0)
[3400] [OBD] ATZ OK — ELM327 v2.3
[3500] [OBD] UDS session opened (10 03 -> 50 03)
[4000] [BLE] SUNKENET connected (FFE0)
[4500] [LOOP] RPM=2800 Speed=95 OilTemp=98 Boost=1.2
[4500] [FIBER] Color -> ORANGE (RPM 2500-4000)
[5000] [UPLOAD] POST /api/telemetry -> 200 OK (312ms)

Applications BLE Scanner

Problemes Courants