Files

T

cedricAbonnel 1f1e0716a8 Corriger référence bibliothèque ESPAsyncWebServer

Remplacer me-no-dev par le fork Mathieu Carbou, compatible SDK ESP32 v3.x.
Documenter l'erreur mbedtls_md5_*_ret et la procédure de correction.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-26 18:46:55 +02:00

3.6 KiB

Raw Blame History

Annexe — Installation de l'environnement de développement (Windows 10)

1. Arduino IDE

Télécharger et installer la dernière version depuis le site officiel : 👉 https://www.arduino.cc/en/software

Choisir Windows Win 10 and newer, 64 bits (installeur .exe).

2. Pilote CP2102 (USB → UART)

Le DevKit V1 utilise une puce Silicon Labs CP2102 pour la communication USB/série. Windows 10 ne l'installe pas toujours automatiquement.

Vérification : brancher l'ESP32 en USB → ouvrir le Gestionnaire de périphériques → si le port COM n'apparaît pas (ou apparaît avec un !), le pilote est absent.

Installation :

Télécharger le pilote sur le site Silicon Labs : https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers
Choisir CP210x Windows Drivers
Décompresser et lancer CP210xVCPInstaller_x64.exe
Débrancher / rebrancher l'ESP32 → un port COMx apparaît dans le Gestionnaire de périphériques

3. Support ESP32 dans Arduino IDE

Le support ESP32 ne fait pas partie d'Arduino IDE par défaut — il faut ajouter le gestionnaire de cartes Espressif.

3a. Ajouter l'URL du gestionnaire de cartes

Dans Arduino IDE : Fichier → Préférences

Dans le champ URL de gestionnaire de cartes supplémentaires, ajouter :

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

Valider avec OK

3b. Installer le paquet ESP32

Outils → Type de carte → Gestionnaire de cartes
Rechercher esp32
Sélectionner esp32 by Espressif Systems → Installer
Attendre la fin du téléchargement (~200 Mo)

3c. Sélectionner la carte

Outils → Type de carte → esp32 → ESP32 Dev Module
Outils → Port → sélectionner le port COMx du DevKit

4. Vérification

Ouvrir Fichier → Exemples → WiFi → WiFiScan, téléverser. Si la compilation et le téléversement réussissent sans erreur, l'environnement est opérationnel.

5. Bibliothèques du projet

À installer via Outils → Gérer les bibliothèques :

Bibliothèque	Auteur	Rechercher
HX711	bogde	`HX711 bogde`
ESPAsyncWebServer	Mathieu Carbou	`ESPAsyncWebServer mathieucarbou`
AsyncTCP	Mathieu Carbou	`AsyncTCP mathieucarbou`

⚠️ Ne pas installer la version de me-no-dev — elle n'est plus maintenue et provoque une erreur de compilation avec le SDK ESP32 v3.x (voir ci-dessous).

6. Erreur de compilation — ESPAsyncWebServer incompatible

Symptôme

WebAuthentication.cpp: error: 'mbedtls_md5_starts_ret' was not declared in this scope

Cause

Le SDK ESP32 v3.x a supprimé les fonctions mbedTLS suffixées _ret (mbedtls_md5_starts_ret, mbedtls_md5_update_ret, mbedtls_md5_finish_ret). La bibliothèque ESPAsyncWebServer de me-no-dev utilise ces fonctions obsolètes et n'est plus maintenue.

Solution

Désinstaller la version me-no-dev et installer le fork maintenu :

Outils → Gérer les bibliothèques
Rechercher ESPAsyncWebServer → désinstaller la version me-no-dev si présente
Rechercher ESPAsyncWebServer mathieucarbou → installer ESPAsyncWebServer by Mathieu Carbou
Rechercher AsyncTCP mathieucarbou → installer AsyncTCP by Mathieu Carbou
Relancer la compilation

Le fork de Mathieu Carbou est compatible SDK ESP32 v3.x et maintenu activement.

3.6 KiB Raw Blame History