Compilation & Flash

Prérequis

• PlatformIO installé (VS Code extension ou CLI)
• Câble USB-C pour connecter l’ESP32
• Les drivers USB-serial installés (CP2102 ou CH340 selon la carte)

Configuration PlatformIO

Le fichier firmware/platformio.ini définit les environnements de build :

[env]
framework = arduino
monitor_speed = 115200
lib_deps =
    bblanchon/ArduinoJson@^7.0.0

[env:dae]
platform = espressif32
board = esp32-s3-devkitc-1
board_build.partitions = huge_app.csv
build_flags =
    -DDEVICE_TYPE=\"DAE\"
    -DBOARD_HAS_PSRAM
lib_deps =
    ${env.lib_deps}
    bodmer/TFT_eSPI@^2.5.0
    fastled/FastLED@^3.7.0
    schreibfaul1/ESP32-audioI2S@^2.0.0

[env:dinamap]
platform = espressif32
board = esp32-c3-devkitm-1
build_flags =
    -DDEVICE_TYPE=\"DINAMAP\"
lib_deps =
    ${env.lib_deps}
    bodmer/TFT_eSPI@^2.5.0

[env:scope]
platform = espressif32
board = esp32-s3-devkitc-1
board_build.partitions = huge_app.csv
build_flags =
    -DDEVICE_TYPE=\"SCOPE\"
    -DBOARD_HAS_PSRAM
lib_deps =
    ${env.lib_deps}
    bodmer/TFT_eSPI@^2.5.0

Compilation

# Compiler un environnement spécifique
pio run -e dae
pio run -e dinamap
pio run -e scope

# Compiler tous les environnements
pio run

Flash

# Flasher via USB
pio run -e dae -t upload

# Si le port n'est pas détecté automatiquement
pio run -e dae -t upload --upload-port /dev/ttyUSB0

Upload des fichiers data (SD/SPIFFS)

# Upload des fichiers data sur le filesystem
pio run -e dae -t uploadfs

Moniteur série

# Ouvrir le moniteur série
pio device monitor -b 115200

# Avec filtrage
pio device monitor -b 115200 -f direct

Dépannage

Problème	Solution
Port non détecté	Vérifier le câble USB (data, pas charge only)
Upload échoué	Maintenir BOOT pendant le flash, relâcher après
Écran blanc	Vérifier le brochage SPI et la config TFT_eSPI
Pas de son	Vérifier les connexions I2S (DIN, BCLK, LRC)
ESP-NOW échoué	Vérifier que le WiFi est en mode STA