Files
ESP-Mqtt/README.md
T
2026-10-29 15:08:53 +01:00

3.8 KiB

ESPTest

ESPTest est un exemple de firmware Arduino pour une carte ESP32-S3 DevKitC-1. Il configure le Wi-Fi, démarre un serveur web et met à disposition un tableau de bord avec une température simulée, une mise à jour du firmware par OTA et un terminal série accessible depuis le navigateur.

Fonctionnalités

  • Configuration Wi-Fi avec NetWizard : l'appareil se connecte au réseau mémorisé ou démarre le portail de configuration « My Device ».
  • Tableau de bord ESP-DASH affichant une valeur de température simulée, actualisée toutes les trois secondes.
  • Mise à jour OTA avec ElegantOTA.
  • Terminal série web avec WebSerial. Les messages reçus dans le terminal sont également écrits sur le port série USB.
  • Serveur web asynchrone sur le port 80.

Matériel et prérequis

  • Une carte ESP32-S3 DevKitC-1.
  • Visual Studio Code avec l'extension PlatformIO IDE, ou PlatformIO Core en ligne de commande.
  • Un câble USB adapté à la carte.
  • Un navigateur sur un appareil connecté au même réseau local que l'ESP32 pour accéder au tableau de bord.

Les bibliothèques nécessaires sont déclarées dans platformio.ini et PlatformIO les installe lors de la compilation.

Compiler et téléverser

Avec Visual Studio Code

  1. Ouvrir le dossier du projet dans VS Code.
  2. Laisser PlatformIO installer les dépendances.
  3. Connecter la carte en USB.
  4. Utiliser les actions PlatformIO Build, puis Upload.
  5. Ouvrir le moniteur série à 115200 bauds pour suivre le démarrage.

En ligne de commande

Depuis la racine du projet :

pio run -e esp32-s3-devkitc-1
pio run -e esp32-s3-devkitc-1 -t upload
pio device monitor -b 115200

Si plusieurs ports série sont disponibles, sélectionner celui de la carte dans les paramètres de PlatformIO ou préciser le port avec --port.

Première connexion et utilisation

  1. Après démarrage, l'ESP32 se connecte au Wi-Fi mémorisé. Si aucun réseau enregistré n'est disponible, il lance le portail de configuration NetWizard nommé My Device.
  2. Depuis un téléphone ou un ordinateur, rejoindre le point d'accès de configuration et suivre le portail pour fournir les identifiants du réseau Wi-Fi.
  3. Une fois l'ESP32 connecté au réseau local, repérer son adresse IP dans le moniteur série ou dans la liste des appareils du routeur.
  4. Ouvrir http://<adresse-ip-de-l-esp32>/ dans un navigateur. La racine redirige vers le tableau de bord. Son URL directe est http://<adresse-ip-de-l-esp32>/dashboard.

Autres interfaces :

Chemin Fonction
/dashboard Tableau de bord et valeur de température simulée
/update Interface de mise à jour du firmware par OTA
/webserial Terminal série dans le navigateur

L'interface OTA et le terminal WebSerial sont accessibles depuis le réseau local de l'appareil. Pour les mises à jour OTA, utiliser un firmware compilé pour cette carte et suivre les indications de l'interface.

Structure du projet

.
├── platformio.ini   # Carte, framework, dépendances et options de compilation
└── src/
    └── main.cpp     # Initialisation Wi-Fi et serveur, boucle et mise à jour du tableau de bord

Configuration et personnalisation

  • La carte cible, le débit série, les bibliothèques et les options de compilation se configurent dans platformio.ini.
  • Le nom du point d'accès, les routes web et la fréquence d'actualisation du tableau de bord se trouvent dans src/main.cpp.
  • La température affichée est générée aléatoirement entre 0 et 49 ; elle ne provient pas d'un capteur physique.