ESP32ArduinoDébutants

Débuter avec l’ESP32 et l’Arduino IDE : le guide complet

Installez le support ESP32 dans l’Arduino IDE 2, téléversez votre premier programme, connectez-vous au Wi-Fi et corrigez les erreurs de téléversement les plus courantes.

Leer en español →

Certains liens de cet article sont des liens affiliés : si vous achetez via ces liens, BeInTech reçoit une petite commission sans surcoût pour vous. C’est ce qui fait vivre le blog.

L’ESP32 est sans doute le microcontrôleur le plus utile que l’on puisse acheter aujourd’hui pour moins de 10 € : il intègre le Wi-Fi et le Bluetooth, deux cœurs à 240 MHz et une foule de broches. Dans ce guide, vous allez passer de la carte encore dans sa boîte à une LED qui clignote et une connexion à votre Wi-Fi, en 20 minutes environ.

Ce que vous allez apprendre : installer l’Arduino IDE 2, ajouter les cartes ESP32, téléverser votre premier programme, utiliser le moniteur série, vous connecter au Wi-Fi et résoudre les erreurs de téléversement les plus fréquentes.

Ce dont vous avez besoin

  • Une carte ESP32 DevKit (aussi appelée ESP32-WROOM-32 DevKit V1). C’est la plus courante et la moins chère. Si vous hésitez entre plusieurs modèles, consultez le comparatif ESP32 vs ESP8266 vs Pico W.
  • Un câble USB de données. Attention : beaucoup de câbles fournis avec les chargeurs ne transportent que le courant et ne permettent pas de programmer. C’est l’erreur numéro un.
  • Un ordinateur sous Windows, macOS ou Linux.

Carte ESP32 DevKit V1 (ESP32-WROOM-32)

La carte que j’utilise dans ce tutoriel. Elle est souvent vendue par lots de 2 ou 3, moins chers à l’unité.

Voir le prix sur Amazon

Étape 1 : installez l’Arduino IDE 2

Téléchargez la dernière version de l’Arduino IDE 2 depuis le site officiel d’Arduino (arduino.cc, rubrique Software) et installez-la avec les options par défaut. Sous Windows, acceptez l’installation des pilotes lorsqu’elle vous est proposée.

Étape 2 : ajoutez le support de l’ESP32

L’Arduino IDE ne gère pas l’ESP32 d’origine : il faut ajouter le paquet d’Espressif (le fabricant de la puce) :

  1. Ouvrez Fichier → Préférences.
  2. Dans « URL de gestionnaire de cartes supplémentaires », collez cette adresse :
https://espressif.github.io/arduino-esp32/package_esp32_index.json
  1. Cliquez sur OK.
  2. Ouvrez le Gestionnaire de cartes (icône de carte dans la barre latérale gauche), cherchez esp32 et installez le paquet « esp32 by Espressif Systems ». Cela prend quelques minutes, car le compilateur est téléchargé.

Étape 3 : branchez la carte et choisissez le port

Branchez l’ESP32 en USB. Dans la liste déroulante en haut de l’IDE :

  • Carte : cherchez et sélectionnez ESP32 Dev Module.
  • Port : sous Windows, il apparaît comme COM3, COM4… ; sous macOS comme /dev/cu.usbserial-… ; sous Linux comme /dev/ttyUSB0.

Aucun port n’apparaît ?

Votre carte possède une puce de conversion USB-série qui peut nécessiter un pilote. Regardez la petite puce à côté du connecteur USB :

Puce sur la carte Pilote nécessaire
CP2102 / CP2104 CP210x USB to UART Bridge de Silicon Labs
CH340 / CH9102 CH340/CH341 ou CH9102 de WCH

Installez-le, débranchez puis rebranchez la carte. Si rien n’apparaît encore, essayez un autre câble : dans 90 % des cas, c’est lui le coupable.

Sur la plupart des cartes DevKit, une LED bleue est reliée au GPIO 2. Copiez ce code :

// Blink pour ESP32 : fait clignoter la LED de la carte
const int LED_PIN = 2;  // LED intégrée sur la plupart des ESP32 DevKit

void setup() {
  pinMode(LED_PIN, OUTPUT);
  Serial.begin(115200);
  Serial.println("Bonjour depuis l'ESP32 !");
}

void loop() {
  digitalWrite(LED_PIN, HIGH);
  delay(500);
  digitalWrite(LED_PIN, LOW);
  delay(500);
}

Cliquez sur Téléverser (la flèche →). À la fin, vous verrez Hard resetting via RTS pin... et la LED se mettra à clignoter. 🎉

Étape 5 : le moniteur série

Ouvrez Outils → Moniteur série et sélectionnez 115200 bauds en bas à droite. Appuyez sur le bouton EN (reset) de la carte et le message Bonjour depuis l'ESP32 ! s’affichera.

Le moniteur série est votre meilleur outil de débogage : utilisez Serial.println() pour savoir ce que fait votre programme à chaque instant.

Étape 6 : connectez-vous au Wi-Fi

C’est là que l’ESP32 se distingue d’un Arduino classique. Remplacez le code par celui-ci, avec le nom et le mot de passe de votre réseau :

#include <WiFi.h>

const char* WIFI_SSID = "NOM_DE_VOTRE_WIFI";
const char* WIFI_PASS = "VOTRE_MOT_DE_PASSE";

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin(WIFI_SSID, WIFI_PASS);

  Serial.print("Connexion");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println();
  Serial.print("Connecte. IP : ");
  Serial.println(WiFi.localIP());
  Serial.print("Signal (RSSI) : ");
  Serial.print(WiFi.RSSI());
  Serial.println(" dBm");
}

void loop() {
}

Téléversez-le et ouvrez le moniteur série. En quelques secondes, vous verrez l’adresse IP que votre box a attribuée à l’ESP32. À partir de là, vous pouvez créer un serveur web, envoyer des données en MQTT ou l’intégrer à Home Assistant.

Important : l’ESP32 ne fonctionne qu’avec les réseaux 2,4 GHz. Si votre box n’émet qu’en 5 GHz, ou utilise le même nom pour les deux bandes et pose problème, activez un réseau 2,4 GHz séparé.

Erreurs courantes et solutions

Failed to connect to ESP32: Timed out waiting for packet header

La carte n’est pas entrée en mode programmation. Solution : maintenez le bouton BOOT enfoncé lorsque Connecting.... apparaît dans la console, puis relâchez-le quand l’écriture commence. Si cela arrive à chaque fois, soudez un condensateur de 10 µF entre la broche EN et GND.

A fatal error occurred: Could not open port

Un autre programme utilise le port (par exemple un moniteur série ouvert dans une autre fenêtre de l’IDE, PuTTY ou PlatformIO). Fermez-le et réessayez.

Le programme se téléverse mais rien ne se passe

  • Vérifiez que le moniteur série est réglé sur 115200 bauds.
  • Appuyez sur EN pour redémarrer la carte.
  • Si votre carte n’a pas de LED sur le GPIO 2, branchez une LED avec une résistance de 220 Ω entre le GPIO 2 et GND.

Brownout detector was triggered

La carte ne reçoit pas assez de courant, surtout à l’activation du Wi-Fi. Utilisez un autre port USB (de préférence à l’arrière du PC), un autre câble ou un hub alimenté.

Et ensuite ?

Votre ESP32 fonctionne et il est connecté à Internet. L’étape logique suivante consiste à lire un capteur et à envoyer ses données quelque part. Je vous conseille de commencer par un capteur de température et d’humidité :

Capteur BME280 (température, humidité et pression)

Précis, bon marché et relié en I2C avec seulement 4 fils. Il servira de base aux prochains tutoriels.

Voir le prix sur Amazon

Vous pouvez ensuite suivre ces deux tutoriels, dans cet ordre :

  1. Station météo avec ESP32 et BME280 : lisez le capteur et affichez les données sur une page web.
  2. MQTT expliqué simplement, avec Mosquitto et l’ESP32 : envoyez ces données à un serveur et pilotez l’ESP32 à distance.

Vous êtes bloqué à une étape ? Écrivez-moi et on regarde ça ensemble.