Skip to content

BUILDING.md

Latest commit

 

History

History
104 lines (71 loc) · 2.61 KB

BUILDING.md

File metadata and controls

104 lines (71 loc) · 2.61 KB
Raw

Build OpenXtraflame

Prérequis

  • Docker + Docker Compose OU installation manuelle ESP-IDF v5.2+
  • USB-UART adaptateur (=CH340G, CP2102, FT232) 3.3V logic
  • ESP32 dev board OU module Extraflame Black Label

Build via Docker (=recommandé)

Le container Dockerfile.esp-idf contient déjà tout l'environnement Espressif.

1. Setup

cd ~/projects/OpenXtraflame
docker compose build

2. Configurer la cible ESP32

docker compose run --rm esp-idf idf.py set-target esp32

3. Compiler pour Target External (=ESP32 spare)

docker compose run --rm esp-idf idf.py -DOPENXFLAME_TARGET=external build

Le firmware est produit dans firmware/build/OpenXtraflame.bin.

4. Compiler pour Target Black Label (=reflash original)

docker compose run --rm esp-idf idf.py -DOPENXFLAME_TARGET=blacklabel build

⚠️ Ne flashe PAS avant d'avoir un backup du firmware original !

5. Flasher

Configuration du device USB dans docker-compose.yml (défaut : /dev/ttyUSB0).

docker compose run --rm esp-idf idf.py -p /dev/ttyUSB0 flash monitor

6. Monitor série uniquement

docker compose run --rm esp-idf idf.py -p /dev/ttyUSB0 monitor

Ctrl+] pour sortir.

Build sans Docker (=install ESP-IDF native)

Voir doc officielle Espressif : https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/

cd ~/esp/esp-idf
. ./export.sh
cd ~/projects/OpenXtraflame/firmware
idf.py -DOPENXFLAME_TARGET=external build

Structure des artefacts build

firmware/build/
├── bootloader/bootloader.bin       # 0x1000
├── partition_table/partition-table.bin  # 0x8000
└── OpenXtraflame.bin              # 0x10000 (=ota_0)

Flash offsets (=référence)

Fichier Offset Notes
bootloader.bin 0x1000 ESP-IDF 2nd stage
partition-table.bin 0x8000 Table 4KB
OpenXtraflame.bin 0x10000 ota_0

Flash rapide via esptool (=manuel)

esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash \
    0x1000 bootloader.bin \
    0x8000 partition-table.bin \
    0x10000 OpenXtraflame.bin

Restauration firmware Extraflame original (=si nécessaire)

Si tu as un dump du firmware original :

esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash \
    0x0 /path/to/extraflame_dump.bin

Le dump est un flash complet 4MB, il restaure TOUT dans son état d'origine.