Aurora HomeAurora HomeDocs
DocsInstallation ESP32

Flash du firmware ESP32

Guide complet pour compiler et flasher le firmware Aurora Home sur un ESP32 DevKit avec les capteurs environnementaux.

Prérequis matériels

ESP32 DevKit v1

ou tout board ESP32 compatible

Capteur SCD30 (Sensirion)

CO₂, température, humidité

Capteur BME280 (Bosch)

Température, humidité, pression

Capteur BH1750

Luminosité ambiante

Câble USB-C / micro-USB

Pour le flash et l'alimentation

Fils de connexion I2C

Jumper wires 4 fils (VCC, GND, SDA, SCL)

Prérequis logiciels

PlatformIO IDE

Extension VS Code (recommandé) ou CLI

Python 3.8+

Requis par PlatformIO

Drivers USB-UART

CP2102 ou CH340 selon votre board

Câblage I2C

Les 3 capteurs utilisent le bus I2C sur les broches GPIO21 (SDA) et GPIO22 (SCL). . Tous les capteurs partagent les mêmes fils SDA/SCL.

CapteurAdresse I2CVCCNotes
SCD30 (Sensirion)0x613.3VAdresse fixe
BME280 (Bosch)0x76 / 0x773.3VAuto-détecté
BH17500x233.3VADDR pin → GND
Connexions
ESP32 3V3  ──→  VCC  (tous les capteurs)
ESP32 GND  ──→  GND  (tous les capteurs)
ESP32 GPIO21 (SDA) ──→  SDA (tous les capteurs)
ESP32 GPIO22 (SCL) ──→  SCL (tous les capteurs)

Étapes d'installation

1

Cloner le dépôt

Clonez le projet firmware depuis GitHub :

Terminal
git clone https://github.com/antoinegourgue/aurora-home-esp32.git
cd aurora-home-esp32
2

Configurer le réseau WiFi

Copiez le fichier exemple puis éditez include/Config.h.example avec vos paramètres :

Terminal
cp include/Config.h.example include/Config.h
include/Config.h
#define AURORA_WIFI_AP_SSID     "ESP32-AP-Broker"
#define AURORA_WIFI_AP_PASSWORD "password123"

#define AURORA_MQTT_PORT           1883
#define AURORA_MQTT_TOPIC_DATA     "sensor/data"

#define AURORA_PUBLISH_INTERVAL_MS 30000  // 30s entre chaque publication
#define AURORA_WATCHDOG_TIMEOUT_S  30

Mode Access Point

L'ESP32 crée son propre réseau WiFi (il n'est pas client d'un routeur). L'Orange Pi doit se connecter à ce réseau "ESP32-AP-Broker" pour accéder au broker MQTT embarqué.

3

Compiler le firmware

Compilez le projet avec PlatformIO :

Terminal
# Via CLI PlatformIO
platformio run -e esp32dev

# Ou via VS Code : cliquer sur ✓ Build dans la barre PlatformIO
4

Flasher l'ESP32

Connectez l'ESP32 via USB et flashez le firmware :

Terminal
# Flash automatique (détecte le port USB)
platformio run -e esp32dev -t upload

# Si le port n'est pas détecté, spécifiez-le manuellement :
platformio run -e esp32dev -t upload --upload-port /dev/ttyUSB0
5

Surveiller la sortie série

Ouvrez le moniteur série pour vérifier le démarrage :

Terminal
platformio device monitor --baud 115200

Sortie attendue :

Sortie série
[INFO] --- 1. Sensor initialization ---
[INFO] BH1750: OK
[INFO] SCD30:  OK
[INFO] BME280: OK
[INFO] --- 2. Starting access point ---
[INFO] AP SSID: ESP32-AP-Broker
[INFO] ESP32 IP: 192.168.4.1
[INFO] mDNS responder up as esp32-aurora.local
[INFO] --- 3. Watchdog + waiting for client ---
[INFO] Client connected. IP: 192.168.4.2
[INFO] MQTT connected.
[INFO] MQTT publish [sensor/data]: {"temperature":"22.50","humidity":"55.10","pressure":"1013.25","co2":"650.00","light":"320.00"}

Dépendances PlatformIO

Les librairies sont installées automatiquement par PlatformIO depuis platformio.ini :

platformio.ini
lib_deps =
    Wire
    sensirion/Sensirion I2C SCD30@^1.0.0
    claws/BH1750@^1.3.0
    adafruit/Adafruit BME280 Library@^2.3.0
    knolleary/PubSubClient@^2.8
    bblanchon/ArduinoJson@^7.2.0

Vérification

Si vous voyez "MQTT publish" dans le moniteur série, le firmware fonctionne correctement. Connectez maintenant l'Orange Pi au réseau "ESP32-AP-Broker" et démarrez l'application web Aurora Home.

PrécédentInstallation AppSuivantTableau de bord