Files

T

cedricAbonnel fc9dded748 Annexe : procédure d'installation des bibliothèques par ZIP

Les bibliothèques mathieucarbou ne sont pas dans le gestionnaire Arduino,
documenter l'installation manuelle via GitHub ZIP.

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

2026-04-26 18:53:23 +02:00

4.2 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 via ZIP (ces bibliothèques ne sont pas toujours disponibles dans le gestionnaire Arduino) :

Étape 1 — Désinstaller l'ancienne version (si présente)

Outils → Gérer les bibliothèques
Rechercher ESPAsyncWebServer → si la version me-no-dev est installée, cliquer Désinstaller
Faire de même pour AsyncTCP de me-no-dev

Étape 2 — Télécharger les ZIPs depuis GitHub

Bibliothèque	URL
AsyncTCP	https://github.com/mathieucarbou/AsyncTCP
ESPAsyncWebServer	https://github.com/mathieucarbou/ESPAsyncWebServer

Sur chaque page : bouton Code → Download ZIP

Étape 3 — Installer dans Arduino IDE

Croquis → Inclure une bibliothèque → Ajouter la bibliothèque .ZIP...
Sélectionner le fichier AsyncTCP-main.zip → OK
Répéter avec ESPAsyncWebServer-main.zip

Étape 4 — Relancer la compilation

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

4.2 KiB Raw Blame History