ESP32 WiFiManager : configurer le Wi-Fi depuis ton téléphone
ESP32 WiFiManager : saisis le mot de passe Wi-Fi depuis ton mobile. Portail captif, paramètres perso comme MQTT, bouton reset, softAP et AP+STA avec page web.
ESP32 WiFiManager est une bibliothèque qui te permet de connecter ton ESP32 au réseau depuis ton téléphone, sans écrire le nom du Wi-Fi ni le mot de passe dans le code. Si la carte ne parvient pas à se connecter à un réseau enregistré, elle ouvre son propre réseau Wi-Fi ; quand tu t'y connectes avec ton téléphone, une page de configuration s'affiche, tu choisis ton réseau dans la liste, tu tapes le mot de passe, et l'ESP32 enregistre ces informations dans sa mémoire permanente puis se connecte. Tu peux ainsi utiliser le même programme à la maison, au lycée ou chez un ami sans le téléverser à nouveau. Les prises connectées et les objets IoT du commerce que tu configures depuis ton téléphone au premier démarrage fonctionnent exactement ainsi.
Dans ce guide, tu vas d'abord découvrir les modes Wi-Fi de l'ESP32 : station (STA), point d'accès (AP) et AP+STA, où les deux fonctionnent ensemble. Ensuite, on installera la bibliothèque WiFiManager, on écrira un premier programme sans mot de passe, on ajoutera un bouton qui efface les réglages ou rouvre le portail, et on demandera des paramètres personnalisés comme le serveur MQTT, le port et le nom de l'appareil sur la même page, en les enregistrant durablement. Dans les dernières parties, l'ESP32 créera son propre réseau avec softAP, sans aucune box, pour piloter une LED depuis ton téléphone ; on testera le mode AP+STA et on montera un point d'accès sur le Raspberry Pi Pico W avec MicroPython.

Qu'est-ce que l'ESP32 WiFiManager et comment fonctionne-t-il ?
Dans un programme ESP32 classique, le nom du réseau et le mot de passe sont écrits en dur dans la ligne WiFi.begin("MaBox", "motdepasse"). Quand tu changes de box, que tu modifies le mot de passe ou que tu emportes l'appareil ailleurs, tu dois rouvrir le code et le téléverser de nouveau. WiFiManager confie ce travail à une page web. Au démarrage, il vérifie si un réseau est enregistré dans la mémoire permanente de l'ESP32 (NVS) et, si oui, essaie de s'y connecter. Si la connexion réussit, ton code continue sans rien afficher. S'il n'y a pas de réseau enregistré ou si la connexion échoue, l'ESP32 ouvre son propre point d'accès, lance un serveur DNS et publie une page de configuration à l'adresse 192.168.4.1. Comme le serveur DNS répond par cette adresse à chaque domaine demandé par le téléphone, celui-ci ouvre tout seul la fenêtre « se connecter au réseau » dès qu'il est connecté. C'est le même principe que les pages de connexion des hôtels et des cafés, et on l'appelle un portail captif. Quand tu choisis ton réseau et enregistres le mot de passe, l'ESP32 se connecte au nouveau réseau, ferme le point d'accès et garde les informations pour le prochain démarrage. Tout cela repose sur les modes Wi-Fi gérés par l'ESP32 :
| Mode | Ce qu'il fait | Quand l'utiliser |
|---|---|---|
| WIFI_STA (station) | Se connecte à une box comme client et reçoit une IP | Projets qui vont sur internet et sont accessibles depuis tout le réseau de la maison |
| WIFI_AP (point d'accès) | Diffuse son propre réseau et distribue des adresses 192.168.4.x | Lieux sans box, pages de configuration, contrôle au téléphone sur le terrain |
| WIFI_AP_STA | Fait les deux en même temps, avec deux adresses IP distinctes | Portail WiFiManager, rester sur le réseau de la maison avec un réseau de service ouvert |
| WIFI_OFF | Coupe complètement la radio | Économiser la batterie, moments où le Wi-Fi est inutile |
Installer la bibliothèque WiFiManager
- Vérifie que le paquet de cartes ESP32 est installé dans l'Arduino IDE. Sinon, suis les étapes de l'article Qu'est-ce que l'ESP32 ?.
- Ouvre Outils > Gérer les bibliothèques et tape WiFiManager dans le champ de recherche.
- Trouve la bibliothèque WiFiManager dont l'auteur est tzapu et installe la dernière version (2.0.17 ou plus récente).
- Choisis ta carte dans Outils > Type de carte (ESP32 Dev Module pour la plupart des DevKit) et règle le port.
- La bibliothèque n'a besoin d'aucun paquet supplémentaire : WebServer, DNSServer et Preferences sont déjà fournis avec le core ESP32.
Premier exemple : se connecter au Wi-Fi sans mot de passe dans le code
Le programme ci-dessous est l'utilisation la plus simple de WiFiManager. Le code ne contient ni nom de réseau ni mot de passe. Si la carte ne réussit pas à se connecter au réseau enregistré en 20 secondes, elle ouvre un réseau nommé BlueGrays-Kurulum. Le mot de passe du portail est kurulum123 ; tu pourrais aussi ouvrir le portail sans mot de passe, mais n'importe qui à proximité pourrait alors saisir des informations réseau dans ton appareil. Si le portail reste inutilisé pendant 180 secondes, la carte redémarre et réessaie le réseau enregistré. Ce détail compte : si, après une coupure de courant, la box redémarre plus lentement que l'ESP32, la carte ne reste pas bloquée dans le portail et retrouve ton réseau toute seule en quelques minutes.
1#include <WiFi.h>
2#include <WiFiManager.h> // tzapu WiFiManager
3
4void setup() {
5 Serial.begin(115200);
6 WiFi.mode(WIFI_STA); // önce istasyon modu / start in station mode
7
8 WiFiManager wm;
9 // wm.resetSettings(); // test için kayıtlı ağı sil / erase saved network for testing
10 wm.setConnectTimeout(20); // kayıtlı ağa 20 sn dene / try the saved network for 20 s
11 wm.setConfigPortalTimeout(180); // portal 180 sn sonra kapanır / portal closes after 180 s
12
13 // Bağlanamazsa "BlueGrays-Kurulum" ağını açar / opens "BlueGrays-Kurulum" if it cannot connect
14 bool baglandi = wm.autoConnect("BlueGrays-Kurulum", "kurulum123");
15
16 if (!baglandi) {
17 Serial.println("Baglanamadi, yeniden baslatiliyor / Not connected, restarting");
18 delay(1000);
19 ESP.restart(); // kayıtlı ağı yeniden dene / try the saved network again
20 }
21
22 Serial.print("Baglandi / Connected, IP: ");
23 Serial.println(WiFi.localIP());
24}
25
26void loop() {
27 // projenin asıl kodu buraya / your project code goes here
28}Après le téléversement, ouvre le moniteur série à 115200 bauds. Comme la carte démarre pour la première fois, aucun réseau n'est enregistré, et les lignes de WiFiManager qui commencent par *wm: montrent que le point d'accès est ouvert. Prends maintenant ton téléphone et suis ces étapes :
- Trouve le réseau BlueGrays-Kurulum dans la liste Wi-Fi du téléphone et connecte-toi avec le mot de passe kurulum123.
- En quelques secondes, la page de connexion s'ouvre toute seule. Sinon, tape 192.168.4.1 dans le navigateur.
- Appuie sur Configure WiFi. Les réseaux que voit l'ESP32 s'affichent avec leur force de signal.
- Choisis ton réseau, tape son mot de passe et appuie sur Save.
- L'ESP32 rejoint le nouveau réseau, ferme le point d'accès et affiche dans le moniteur série l'adresse IP obtenue. Ton téléphone revient aussi sur son réseau.
- Réinitialise la carte : cette fois le portail ne s'ouvre pas, l'ESP32 se connecte seul au réseau enregistré en quelques secondes.
La rubrique Info du portail affiche l'adresse MAC de la carte, les infos de la puce et l'état de la mémoire ; Exit ferme le portail sans enregistrer. Voici les principales fonctions de WiFiManager que tu utiliseras dans cet article :
| Fonction | Ce qu'elle fait |
|---|---|
| autoConnect(nom, motdepasse) | Essaie le réseau enregistré ; en cas d'échec, ouvre le portail. Renvoie true une fois connecté |
| startConfigPortal(nom, motdepasse) | Ouvre tout de suite le portail, sans regarder le réseau enregistré |
| setConfigPortalTimeout(s) | Ferme le portail et renvoie false s'il reste inutilisé ce nombre de secondes |
| setConnectTimeout(s) | Durée de la tentative de connexion au réseau enregistré |
| resetSettings() | Efface le nom et le mot de passe Wi-Fi enregistrés |
| addParameter(¶metre) | Ajoute un champ de saisie perso à la page du portail |
| setSaveParamsCallback(fonction) | Appelle ta fonction quand les paramètres perso sont enregistrés |
| setConfigPortalBlocking(false) et process() | Laisse loop() tourner pendant que le portail est ouvert |
| setHostname("nom") | Définit le nom de la carte sur le réseau, visible dans la liste des appareils de la box |
Bouton de réinitialisation et portail à la demande
Une fois l'appareil enfermé dans son boîtier, tu devras peut-être changer les informations Wi-Fi. Le plus simple pour le faire sans nouveau téléversement, c'est un bouton. Dans l'exemple ci-dessous, on utilise le bouton BOOT des cartes ESP32 DevKit ; il est relié au GPIO 0 et, grâce à la résistance de pull-up présente sur la carte, il lit LOW quand on appuie. Un appui court ouvre le portail sans effacer le réseau enregistré ; tu peux saisir un nouveau réseau ou modifier seulement tes réglages perso. Un appui de 3 secondes efface complètement le réseau enregistré et redémarre la carte. Si tu préfères un bouton séparé, branche-le sur une broche libre comme le GPIO 4 ; les détails sont dans Comment brancher un bouton. La LED intégrée sur le GPIO 2 indique l'état de la connexion.
1#include <WiFi.h>
2#include <WiFiManager.h>
3
4const int BUTON_PIN = 0; // DevKit üzerindeki BOOT butonu / BOOT button on the DevKit
5const int LED_PIN = 2; // dahili LED / onboard LED
6const char* PORTAL_ADI = "BlueGrays-Kurulum";
7const char* PORTAL_SIFRE = "kurulum123";
8
9WiFiManager wm;
10
11void setup() {
12 Serial.begin(115200);
13 pinMode(BUTON_PIN, INPUT_PULLUP);
14 pinMode(LED_PIN, OUTPUT);
15 WiFi.mode(WIFI_STA);
16 wm.setConfigPortalTimeout(180);
17 if (!wm.autoConnect(PORTAL_ADI, PORTAL_SIFRE)) {
18 Serial.println("Agsiz devam / Continuing offline"); // butonla tekrar denenebilir / retry with the button
19 }
20}
21
22void butonuKontrolEt() {
23 if (digitalRead(BUTON_PIN) != LOW) return;
24 delay(50); // ark önleme / debounce
25 if (digitalRead(BUTON_PIN) != LOW) return;
26
27 unsigned long basilma = millis();
28 while (digitalRead(BUTON_PIN) == LOW && millis() - basilma < 3000) {
29 delay(10); // bırakılmasını ya da 3 sn'yi bekle / wait for release or 3 s
30 }
31
32 if (millis() - basilma >= 3000) {
33 Serial.println("Wi-Fi ayarlari siliniyor / Erasing Wi-Fi settings");
34 digitalWrite(LED_PIN, HIGH);
35 wm.resetSettings(); // kayıtlı ağı sil / erase the saved network
36 delay(500);
37 ESP.restart();
38 } else {
39 Serial.println("Portal aciliyor / Opening portal");
40 if (wm.startConfigPortal(PORTAL_ADI, PORTAL_SIFRE)) {
41 Serial.print("Yeni IP / New IP: ");
42 Serial.println(WiFi.localIP());
43 } else {
44 Serial.println("Portal zaman asimi / Portal timeout");
45 }
46 }
47}
48
49void loop() {
50 butonuKontrolEt();
51 // bağlıyken LED yanar / LED is on while connected
52 digitalWrite(LED_PIN, WiFi.status() == WL_CONNECTED ? HIGH : LOW);
53}Paramètres personnalisés : serveur MQTT, port et nom de l'appareil
L'une des fonctions les plus pratiques de WiFiManager est de pouvoir ajouter tes propres champs à la page du portail. Si tu relies une carte capteur à Home Assistant via MQTT, tu ne veux pas non plus figer dans le code l'adresse du serveur, le port et le nom de l'appareil. Pour cela, tu crées des objets WiFiManagerParameter et tu les ajoutes au portail avec addParameter(). Un seul point demande de l'attention : WiFiManager enregistre lui-même le nom et le mot de passe Wi-Fi, mais il n'enregistre pas les paramètres personnalisés. Sauvegarder les valeurs saisies, c'est ton travail. On utilisera la bibliothèque Preferences fournie avec le core ESP32 ; elle écrit des paires clé-valeur dans la partition NVS de la mémoire flash, qui survivent aux coupures de courant. Pour l'équivalent sur Arduino, consulte l'article EEPROM Arduino.
1#include <WiFi.h>
2#include <WiFiManager.h>
3#include <Preferences.h>
4
5Preferences ayarlar; // NVS'te kalıcı ayarlar / persistent settings in NVS
6char mqttSunucu[40] = "192.168.1.10"; // varsayılan değerler / default values
7char mqttPort[6] = "1883";
8char cihazAdi[24] = "bluegrays-sensor";
9
10WiFiManager wm;
11// id, etiket, varsayılan değer, en fazla uzunluk / id, label, default value, max length
12WiFiManagerParameter pSunucu("sunucu", "MQTT sunucusu / server", mqttSunucu, 40);
13WiFiManagerParameter pPort("port", "MQTT port", mqttPort, 6);
14WiFiManagerParameter pAd("ad", "Cihaz adi / Device name", cihazAdi, 24);
15
16void ayarlariOku() {
17 ayarlar.begin("bluegrays", true); // salt okunur aç / open read-only
18 if (ayarlar.isKey("sunucu")) {
19 ayarlar.getString("sunucu", mqttSunucu, sizeof(mqttSunucu));
20 ayarlar.getString("port", mqttPort, sizeof(mqttPort));
21 ayarlar.getString("ad", cihazAdi, sizeof(cihazAdi));
22 }
23 ayarlar.end();
24}
25
26// Portalda Kaydet'e basılınca çağrılır / called when Save is pressed in the portal
27void parametreleriKaydet() {
28 strlcpy(mqttSunucu, pSunucu.getValue(), sizeof(mqttSunucu));
29 strlcpy(mqttPort, pPort.getValue(), sizeof(mqttPort));
30 strlcpy(cihazAdi, pAd.getValue(), sizeof(cihazAdi));
31
32 ayarlar.begin("bluegrays", false); // yazma için aç / open for writing
33 ayarlar.putString("sunucu", mqttSunucu);
34 ayarlar.putString("port", mqttPort);
35 ayarlar.putString("ad", cihazAdi);
36 ayarlar.end();
37 Serial.println("Parametreler kaydedildi / Parameters saved");
38}
39
40void setup() {
41 Serial.begin(115200);
42 WiFi.mode(WIFI_STA);
43 ayarlariOku();
44
45 // Kayıtlı değerleri form kutularına yaz / put saved values into the form fields
46 pSunucu.setValue(mqttSunucu, 40);
47 pPort.setValue(mqttPort, 6);
48 pAd.setValue(cihazAdi, 24);
49
50 wm.addParameter(&pSunucu);
51 wm.addParameter(&pPort);
52 wm.addParameter(&pAd);
53 wm.setSaveParamsCallback(parametreleriKaydet);
54 wm.setHostname(cihazAdi); // modemde görünen ad / name shown in the router
55 wm.setConfigPortalTimeout(180);
56
57 if (!wm.autoConnect("BlueGrays-Kurulum", "kurulum123")) {
58 ESP.restart();
59 }
60
61 uint16_t port = atoi(mqttPort); // metni sayıya çevir / convert text to a number
62 Serial.printf("IP: %s\n", WiFi.localIP().toString().c_str());
63 Serial.printf("MQTT: %s:%u, cihaz / device: %s\n", mqttSunucu, port, cihazAdi);
64}
65
66void loop() {
67 // MQTT bağlantısı burada mqttSunucu ve port ile kurulur / connect to MQTT here with mqttSunucu and port
68}En ouvrant la page Configure WiFi du portail, tu verras trois nouveaux champs sous la liste des réseaux. Ils sont préremplis avec les valeurs enregistrées dans la NVS, ou avec les valeurs par défaut du code si rien n'est encore enregistré. Quand tu appuies sur Save, WiFiManager appelle d'abord ta fonction parametreleriKaydet(), puis se connecte au Wi-Fi. Voici le résumé des paramètres et des fonctions :
| Élément | Rôle | Remarque |
|---|---|---|
| WiFiManagerParameter(id, libellé, défaut, longueur) | Ajoute un champ de saisie au portail | L'id doit être unique, sans espace ni caractère spécial |
| getValue() | Renvoie le texte saisi | C'est toujours du texte ; pour un nombre, utilise atoi() ou atof() |
| setValue(valeur, longueur) | Remplit le champ | Pour afficher la valeur enregistrée dans le formulaire |
| setSaveParamsCallback() | Appelle ta fonction au moment de l'enregistrement | Écris dans la NVS ici |
| setParamsPage(true) | Déplace les paramètres vers une page Setup séparée | Pour modifier seulement les réglages sans toucher au Wi-Fi |
Fais attention à la longueur : la taille du tableau et la longueur du paramètre doivent correspondre, sinon une saisie trop longue pourrait déborder de la mémoire ou être tronquée. C'est pourquoi le programme copie les valeurs avec strlcpy(), qui ne dépasse jamais la taille du tableau de destination. C'est aussi une bonne habitude de vérifier qu'une valeur numérique comme le port reste dans une plage raisonnable avant de l'utiliser.
Le réseau propre de l'ESP32 : contrôle web au téléphone avec softAP
Le portail de WiFiManager n'est en fait qu'une utilisation toute prête de la fonction point d'accès de l'ESP32, et tu peux t'en servir toi-même. Quand tu appelles WiFi.softAP(), l'ESP32 se comporte comme une box : il diffuse son propre réseau, donne au téléphone qui se connecte une adresse comme 192.168.4.2 et reste lui-même à 192.168.4.1. C'est idéal pour piloter quelque chose au téléphone dans un jardin sans box, lors d'une expo scientifique ou d'un concours de robots. La fonction prend le nom du réseau, le mot de passe, le canal, une option de réseau masqué et le nombre maximal de connexions. Le mot de passe doit faire au moins 8 caractères ; si tu en donnes un plus court, softAP() renvoie false et le réseau ne s'ouvre pas. Par défaut, 4 connexions au maximum sont autorisées, et sur l'ESP32 on peut monter jusqu'à 10. Le programme ci-dessous sert une page web qui allume et éteint la LED du GPIO 2 depuis ton téléphone :
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* AP_ADI = "BlueGrays-LED";
5const char* AP_SIFRE = "bluegrays1"; // en az 8 karakter / at least 8 characters
6const int LED_PIN = 2;
7
8WebServer sunucu(80);
9bool ledAcik = false;
10
11void anaSayfa() {
12 String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>"
13 "<meta name='viewport' content='width=device-width,initial-scale=1'>"
14 "<title>ESP32 LED</title></head><body style='font-family:sans-serif;text-align:center'>"
15 "<h2>ESP32 softAP</h2><p>LED: <b>";
16 html += ledAcik ? "ACIK / ON" : "KAPALI / OFF";
17 html += "</b></p><p><a href='/ac'><button style='font-size:24px'>AC / ON</button></a> "
18 "<a href='/kapat'><button style='font-size:24px'>KAPAT / OFF</button></a></p>";
19 html += "<p>Bagli cihaz / Clients: " + String(WiFi.softAPgetStationNum()) + "</p></body></html>";
20 sunucu.send(200, "text/html", html);
21}
22
23void yonlendir() { // ana sayfaya geri dön / go back to the home page
24 sunucu.sendHeader("Location", "/");
25 sunucu.send(303);
26}
27
28void setup() {
29 Serial.begin(115200);
30 pinMode(LED_PIN, OUTPUT);
31
32 WiFi.mode(WIFI_AP);
33 // ad, şifre, kanal, gizli değil, en fazla 4 cihaz / ssid, password, channel, not hidden, max 4 clients
34 if (!WiFi.softAP(AP_ADI, AP_SIFRE, 6, 0, 4)) {
35 Serial.println("softAP acilamadi / softAP failed");
36 return;
37 }
38 Serial.print("Ag / Network: ");
39 Serial.println(AP_ADI);
40 Serial.print("Adres / Address: http://");
41 Serial.println(WiFi.softAPIP()); // genellikle 192.168.4.1 / usually 192.168.4.1
42
43 sunucu.on("/", anaSayfa);
44 sunucu.on("/ac", []() { ledAcik = true; digitalWrite(LED_PIN, HIGH); yonlendir(); });
45 sunucu.on("/kapat", []() { ledAcik = false; digitalWrite(LED_PIN, LOW); yonlendir(); });
46 sunucu.begin();
47}
48
49void loop() {
50 sunucu.handleClient(); // gelen istekleri işle / handle incoming requests
51}Téléverse le code, connecte ton téléphone au réseau BlueGrays-LED et ouvre 192.168.4.1 dans le navigateur. La LED s'allume et s'éteint quand tu appuies sur les boutons, et la page indique le nombre d'appareils connectés. Ici, pas de portail captif : tu dois taper l'adresse toi-même. Si la page ne se charge pas, n'oublie pas que le téléphone est peut-être passé sur les données mobiles faute d'internet. Pour un tableau de bord qui se met à jour instantanément sans recharger la page, tu peux appliquer la méthode de l'article serveur web ESP32 et WebSocket sur ce même réseau softAP.
AP+STA ensemble : diffuser ton propre réseau en restant sur celui de la maison
En mode WIFI_AP_STA, l'ESP32 se connecte à la box et diffuse en même temps son propre réseau. La carte possède alors deux adresses IP distinctes : WiFi.localIP() donne l'adresse sur le réseau de la maison et WiFi.softAPIP() donne 192.168.4.1 sur son propre réseau. Le portail WiFiManager fonctionne aussi dans ce mode, ce qui lui permet de scanner les réseaux tout en servant une page au téléphone. Dans tes projets, tu peux choisir AP+STA pour garder un réseau de service auquel te connecter au téléphone même box éteinte, ou pour utiliser ESP-NOW et le Wi-Fi ensemble. Le programme ci-dessous sert la même page sur les deux interfaces :
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* WIFI_ADI = "EvAgi_2G"; // ev ağı / home network
5const char* WIFI_SIFRE = "sifre1234";
6const char* AP_ADI = "BlueGrays-Servis";
7const char* AP_SIFRE = "servis1234";
8
9WebServer sunucu(80);
10
11void anaSayfa() {
12 String html = "<h2>ESP32 AP+STA</h2>";
13 html += "<p>Ev agi / Home IP: " + WiFi.localIP().toString() + "</p>";
14 html += "<p>Kendi agi / Own AP IP: " + WiFi.softAPIP().toString() + "</p>";
15 html += "<p>Kanal / Channel: " + String(WiFi.channel()) + ", RSSI: " + String(WiFi.RSSI()) + " dBm</p>";
16 sunucu.send(200, "text/html", html);
17}
18
19void setup() {
20 Serial.begin(115200);
21 WiFi.mode(WIFI_AP_STA); // iki mod birlikte / both modes together
22 WiFi.softAP(AP_ADI, AP_SIFRE); // servis ağı her zaman açık / service network always on
23 WiFi.begin(WIFI_ADI, WIFI_SIFRE);
24
25 unsigned long baslangic = millis();
26 while (WiFi.status() != WL_CONNECTED && millis() - baslangic < 15000) {
27 delay(500);
28 Serial.print('.');
29 }
30 Serial.println();
31 Serial.print("STA IP: ");
32 Serial.println(WiFi.localIP()); // bağlanamadıysa 0.0.0.0 / 0.0.0.0 if not connected
33 Serial.print("AP IP: ");
34 Serial.println(WiFi.softAPIP());
35
36 sunucu.on("/", anaSayfa);
37 sunucu.begin(); // iki arayüzü de dinler / listens on both interfaces
38}
39
40void loop() {
41 sunucu.handleClient();
42}Le mode AP+STA a une limite importante à connaître : l'ESP32 n'a qu'une seule radio, donc les deux réseaux doivent fonctionner sur le même canal. Un réseau que tu ouvres sur le canal 1 avec softAP() passe sur le canal 11 dès que l'ESP32 se connecte à une box sur le canal 11. Pendant ce changement, le téléphone connecté au réseau de service peut perdre la connexion quelques secondes. Comme la radio est partagée entre deux réseaux, le débit baisse et la carte consomme un peu plus. Si tu n'as plus besoin du réseau de service une fois la configuration terminée, tu peux couper le point d'accès avec WiFi.softAPdisconnect(true) et repasser la carte en mode station seul.
Point d'accès avec le Raspberry Pi Pico W et MicroPython
Le Raspberry Pi Pico W n'a pas d'équivalent exact du WiFiManager d'Arduino, mais créer un point d'accès en MicroPython ne prend que quelques lignes. network.WLAN(network.AP_IF) te donne l'interface point d'accès ; tu règles le nom du réseau et le mot de passe avec config() et tu l'actives avec active(True). Le Pico W distribue lui aussi des adresses 192.168.4.x aux clients et reste à 192.168.4.1. Le code ci-dessous est un petit serveur web qui allume et éteint la LED intégrée du Pico W depuis ton téléphone :
1import network, socket, time
2from machine import Pin
3
4led = Pin("LED", Pin.OUT) # Pico W kart üstü LED / Pico W onboard LED
5
6ap = network.WLAN(network.AP_IF)
7ap.config(essid="BlueGrays-Pico", password="bluegrays1") # en az 8 karakter / at least 8 chars
8ap.active(True)
9while not ap.active():
10 time.sleep(0.1)
11print("AP IP:", ap.ifconfig()[0]) # genellikle 192.168.4.1 / usually 192.168.4.1
12
13SAYFA = """<!DOCTYPE html><html><head><meta name="viewport" content="width=device-width">
14<title>Pico W</title></head><body><h2>Pico W LED: DURUM</h2>
15<p><a href="/on">AC / ON</a> | <a href="/off">KAPAT / OFF</a></p></body></html>"""
16
17s = socket.socket()
18s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
19s.bind(("0.0.0.0", 80))
20s.listen(2)
21
22while True:
23 istemci, adres = s.accept()
24 try:
25 istek = istemci.recv(1024).decode()
26 if "GET /on " in istek:
27 led.on()
28 elif "GET /off " in istek:
29 led.off()
30 durum = "ACIK / ON" if led.value() else "KAPALI / OFF"
31 istemci.send("HTTP/1.0 200 OK\r\nContent-Type: text/html\r\n\r\n")
32 istemci.send(SAYFA.replace("DURUM", durum))
33 except OSError as hata:
34 print("Hata / Error:", hata)
35 finally:
36 istemci.close() # bağlantıyı her istekten sonra kapat / close after each requestSi tu enregistres le code sur le Pico W sous le nom main.py avec Thonny, la carte crée son réseau automatiquement à chaque démarrage. Il suffit de connecter ton téléphone au réseau BlueGrays-Pico et d'ouvrir 192.168.4.1. Pour un portail captif sur le Pico W, la bibliothèque phew de Pimoroni fournit un point d'accès et un serveur DNS qui capte tous les domaines ; le principe est le même que WiFiManager. Pour connecter le Pico W au réseau de la maison et faire tourner un serveur web en mode station, lis l'article serveur web Wi-Fi avec le Pico W, et si tu débutes en MicroPython, jette un œil aux bases de MicroPython.
Idées de projets avec WiFiManager
- Afficheur de température à offrir : La personne qui reçoit une carte capteur affichant ses mesures sur une page web la connecte elle-même à son Wi-Fi depuis son téléphone.
- Capteur domotique : Relie à Home Assistant une carte qui récupère son serveur MQTT dans le portail ; pas de nouveau téléversement quand l'adresse du serveur change.
- Alarme avec notification sur le téléphone : Crée un bot Telegram ESP32 qui demande le jeton du bot comme paramètre perso.
- Mises à jour sans fil dans le boîtier : Envoie du nouveau code par mise à jour OTA à une carte connectée au réseau grâce à WiFiManager.
- Horloge internet : Monte une horloge NTP dont le fuseau horaire se choisit dans le portail.
- Contrôle sans box : Allume et éteins la pompe d'arrosage du jardin depuis ton téléphone avec softAP ; pour faire communiquer plusieurs cartes, utilise ESP-NOW.
Erreurs fréquentes et solutions
| Symptôme | Cause probable | Solution |
|---|---|---|
| Le réseau du portail n'apparaît pas sur le téléphone | La carte s'est connectée au réseau enregistré, donc pas de portail | Regarde le moniteur série ; pour tester, exécute resetSettings() une fois ou ouvre le portail avec le bouton |
| Je suis connecté mais la page ne s'ouvre pas | Le téléphone est passé sur les données mobiles faute d'internet | Coupe les données mobiles et tape 192.168.4.1 dans le navigateur |
| Pas de portail et un avertissement de mot de passe dans le moniteur série | Le mot de passe du portail fait moins de 8 caractères | Utilise au moins 8 caractères ou ne passe pas de mot de passe |
| wm.process() ou setParamsPage n'est pas reconnu | Mauvaise bibliothèque WiFiManager ou version trop ancienne | Installe la version actuelle du WiFiManager de tzapu et supprime les bibliothèques au nom proche |
| Après Save, la carte rouvre le portail | Mauvais mot de passe ou réseau 5 GHz | Vérifie le mot de passe et choisis le réseau 2,4 GHz ; détails dans le guide Wi-Fi qui ne se connecte pas |
| Les paramètres perso disparaissent au redémarrage | Les valeurs n'ont pas été écrites dans la NVS | Enregistre-les avec Preferences dans setSaveParamsCallback, relis-les au démarrage et mets-les dans le formulaire avec setValue() |
| La carte passe sans cesse en mode téléversement | Le bouton est sur le GPIO 0 et appuyé à la mise sous tension | Appuie après le démarrage ou utilise une broche qui n'est pas de strapping |
| En mode AP+STA, le téléphone perd la connexion | Le point d'accès est passé sur le canal de la box | C'est normal ; reconnecte-toi après quelques secondes ou utilise softAPdisconnect(true) à la fin |
WiFiManager est l'étape la plus simple pour transformer un projet ESP32, simple expérience sur ton bureau, en un appareil que d'autres peuvent utiliser : le mot de passe sort du code, les réglages se font au téléphone et un seul bouton remet tout à zéro. Maintenant que tu connais aussi softAP et AP+STA, tu peux créer des projets pilotés au téléphone partout, avec ou sans box. Dans l'application BlueGrays, tu peux explorer des projets ESP32 comme la connexion Wi-Fi, le serveur web asynchrone, mDNS, WebSocket, la mise à jour OTA et l'alarme Telegram, avec des schémas pas à pas et du code prêt à l'emploi.
Questions fréquentes
À quoi sert l'ESP32 WiFiManager ?
Il permet de connecter un ESP32 au réseau depuis ton téléphone sans écrire le nom du Wi-Fi ni le mot de passe dans le code. Si la carte ne peut pas se connecter à un réseau enregistré, elle ouvre son propre point d'accès et affiche une page de configuration à 192.168.4.1. Le réseau et le mot de passe choisis y sont enregistrés en mémoire permanente et réutilisés automatiquement au démarrage suivant.
Où WiFiManager enregistre-t-il le mot de passe Wi-Fi ?
Sur l'ESP32, le nom et le mot de passe Wi-Fi sont stockés dans la partition NVS de la mémoire flash, comme réglages du pilote Wi-Fi. Ils ne sont pas effacés quand tu téléverses un nouveau code. Pour les effacer, appelle resetSettings() ou efface entièrement la flash.
Comment réinitialiser les réglages de WiFiManager ?
Il suffit d'appeler wm.resetSettings() dans le code puis de redémarrer la carte. En pratique, le mieux est de l'associer à un bouton : par exemple, une vérification qui efface les réglages quand le bouton BOOT est maintenu 3 secondes. Pour ouvrir seulement le portail sans effacer le réseau enregistré, utilise startConfigPortal().
Pourquoi le portail captif de l'ESP32 ne s'ouvre-t-il pas ?
Le plus souvent, le téléphone constate qu'il n'y a pas d'internet sur le réseau du portail et bascule sur les données mobiles ; coupe-les et tape 192.168.4.1 dans le navigateur. Si la carte s'est déjà connectée à un réseau enregistré, le portail ne s'ouvre pas du tout. Vérifie aussi que le mot de passe du portail fait au moins 8 caractères.
L'ESP32 peut-il être point d'accès et station en même temps ?
Oui. En mode WIFI_AP_STA, l'ESP32 diffuse son propre réseau tout en étant connecté à la box et utilise deux adresses IP distinctes. Comme il n'a qu'une radio, les deux réseaux doivent utiliser le même canal ; quand la carte rejoint la box, le point d'accès passe sur le canal de celle-ci.
Combien d'appareils peuvent se connecter au softAP d'un ESP32 ?
Dans le core Arduino, softAP() accepte par défaut jusqu'à 4 appareils. Sur l'ESP32, tu peux monter jusqu'à 10 avec le cinquième paramètre de softAP(). Le nombre d'appareils connectés se lit avec WiFi.softAPgetStationNum().
Projets à réaliser après cet article
Voir tous les projets
Connexion Wi-Fi STA ESP32 (avec écran LCD)
Dans ce projet, nous connectons l'ESP32 au réseau Wi-Fi domestique en mode Station (STA) de manière sécurisée et tolérante aux pannes. Nous isolons SSID/mot de passe dans un fichier secrets.h pour empêcher leur fuite sur Git, mettons en place une reconnexion automatique, et affichons le niveau RSSI et l'adresse IP sur un écran LCD I2C. La LED intégrée sert d'indicateur d'état.

Serveur Web asynchrone ESP32 (avec affichage de l'adresse IP sur l'écran LCD)
On transforme l'ESP32 en serveur web asynchrone que tu pilotes depuis ton téléphone ou ton ordinateur sur le même réseau Wi-Fi. Grâce à la bibliothèque ESPAsyncWebServer, le serveur traite plusieurs requêtes à la fois (il ne bloque pas sur une seule requête comme le WebServer.h classique). Ouvre l'adresse IP de l'ESP32 dans le navigateur et allume ou éteins la LED sur GPIO 5 avec les boutons ON/OFF (adresses /on et /off).

ESP32 mDNS : accès à l'appareil via bluegrays-esp.local (avec écran LCD)
Dans ce projet, en ajoutant un service mDNS (Multicast DNS) à l'ESP32, nous permettons d'accéder à l'appareil via un nom d'hôte lisible, tel que bluegrays-esp.local, plutôt qu'à l'aide d'une adresse IP. Même si l'adresse IP attribuée par le DHCP venait à changer, vous pourrez toujours accéder à l'appareil sous le même nom. En exécutant également un petit serveur web sur l'appareil, nous envoyons des commandes de contrôle des LED depuis un navigateur via l'adresse http://bluegrays-esp.local/.

Compteur ESP32 WebSocket (2 boutons + écran LCD + affichage Web en temps réel)
Dans ce projet, deux boutons reliés à l'ESP32 (GPIO 5 incrémente, GPIO 4 décrémente) modifient un compteur. La valeur se met à jour instantanément sur un écran LCD I2C 16x2 et, grâce au support WebSocket d'ESPAsyncWebServer, dans tous les navigateurs connectés sans recharger la page. Au lieu du polling HTTP, une seule connexion persistante est utilisée et l'ESP32 envoie la nouvelle valeur à tous avec ws.textAll().

Mise à jour OTA de l'ESP32 — Installation sans fil du firmware (avec écran LCD)
Tu vas apprendre à charger un nouveau firmware sur l'ESP32 par Wi-Fi, sans câble USB. Avec la bibliothèque ArduinoOTA, l'ESP32 devient visible sur le réseau et apparaît automatiquement sous le nom bluegrays-ota dans l'onglet "Network port" de l'Arduino IDE. Le premier téléversement se fait en USB, ensuite toutes les mises à jour passent sans fil, un atout clé pour les appareils installés sur le terrain.

ESP32 : heure réelle depuis Internet via NTP
L'ESP32 se connecte au Wi-Fi et récupère l'heure exacte auprès de serveurs NTP (Network Time Protocol) à la milliseconde près. Avec configTzTime(), le fuseau horaire de la Turquie (TRT, UTC+3) s'applique automatiquement, et dans les pays à heure d'été, le changement (DST) est géré tout seul par une chaîne POSIX TZ. L'heure s'affiche dans le Serial Monitor et sur un LCD I2C en option.

ESP32 HTTPClient + API météo (avec écran LCD)
L'ESP32 appelle par Internet une API météo (wttr.in) en REST avec HTTPClient.h. La réponse JSON est analysée avec ArduinoJson v7, puis la ville, la température, l'humidité, la météo et le vent s'affichent sur un LCD I2C. wttr.in ne demande aucune clé d'API : il suffit de taper le nom de n'importe quelle ville.

Système d'Alarme de Mouvement ESP32 (PIR + Buzzer + LED + Telegram)
Une alarme de sécurité intelligente : quand le capteur PIR détecte un mouvement, le buzzer sonne, la LED s'allume et le propriétaire reçoit aussitôt une notification Telegram. Un délai de 30 secondes (cooldown) limite la répétition des alarmes ; il n'élimine pas les fausses détections du capteur PIR. À utiliser à la maison, au garage, dans une réserve ou un bureau.
Autres articles
Application BlueGrays
Réalise ce montage pas à pas sur ton téléphone
Schéma, code et liste des composants sur un seul écran. Plus de 500 projets Arduino, ESP32 et Pico à réaliser.
Scanne avec ton téléphone
Pointe l’appareil photo vers le code : la boutique d’applications de ton téléphone s’ouvre.
ou ouvre la boutique

