Guides · 13 min de lecture

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.

Carte de développement ESP32
Carte ESP32 DevKit : son Wi-Fi peut fonctionner à la fois comme station et comme point d'accès.

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 :

ModeCe qu'il faitQuand l'utiliser
WIFI_STA (station)Se connecte à une box comme client et reçoit une IPProjets 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.xLieux sans box, pages de configuration, contrôle au téléphone sur le terrain
WIFI_AP_STAFait les deux en même temps, avec deux adresses IP distinctesPortail WiFiManager, rester sur le réseau de la maison avec un réseau de service ouvert
WIFI_OFFCoupe complètement la radioÉconomiser la batterie, moments où le Wi-Fi est inutile

Installer la bibliothèque WiFiManager

  1. 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 ?.
  2. Ouvre Outils > Gérer les bibliothèques et tape WiFiManager dans le champ de recherche.
  3. Trouve la bibliothèque WiFiManager dont l'auteur est tzapu et installe la dernière version (2.0.17 ou plus récente).
  4. Choisis ta carte dans Outils > Type de carte (ESP32 Dev Module pour la plupart des DevKit) et règle le port.
  5. La bibliothèque n'a besoin d'aucun paquet supplémentaire : WebServer, DNSServer et Preferences sont déjà fournis avec le core ESP32.
Le gestionnaire de bibliothèques propose plusieurs bibliothèques au nom proche de WiFiManager. Les programmes de cet article sont écrits pour la bibliothèque de tzapu ; si tu installes ESPAsyncWiFiManager ou un autre WiFiManager, les noms de fonctions ne correspondront pas et le code ne compilera pas. Si tu utilises la version 3.x du core ESP32, installe aussi la dernière version de la bibliothèque ; les anciennes versions peuvent provoquer des erreurs de compilation avec le nouveau core.

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.

C++ (Arduino IDE)
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 :

  1. Trouve le réseau BlueGrays-Kurulum dans la liste Wi-Fi du téléphone et connecte-toi avec le mot de passe kurulum123.
  2. En quelques secondes, la page de connexion s'ouvre toute seule. Sinon, tape 192.168.4.1 dans le navigateur.
  3. Appuie sur Configure WiFi. Les réseaux que voit l'ESP32 s'affichent avec leur force de signal.
  4. Choisis ton réseau, tape son mot de passe et appuie sur Save.
  5. 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.
  6. 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 :

FonctionCe 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
Quand ton téléphone se connecte au réseau du portail, il peut afficher « ce réseau n'a pas accès à internet » puis, au bout d'un moment, essayer de basculer sur les données mobiles ou un autre Wi-Fi. Si l'avertissement apparaît, choisis rester connecté ; si la page ne s'ouvre pas, coupe temporairement les données mobiles. Sur iPhone, si la fenêtre de connexion se ferme, tu peux rouvrir la page en touchant l'icône d'information à côté du réseau BlueGrays-Kurulum dans les réglages Wi-Fi.

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.

C++ (Arduino IDE)
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}
Le GPIO 0 est une broche de strapping : s'il est à LOW à la mise sous tension ou au reset, l'ESP32 n'exécute pas ton code et passe en mode téléversement. Appuie donc sur BOOT seulement après le démarrage de la carte. Si tu branches le bouton sur une autre broche que le GPIO 0, évite les broches de strapping comme GPIO 0, 2, 5, 12 et 15 ; l'outil Pinout te montre les broches sûres.

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.

C++ (Arduino IDE)
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émentRôleRemarque
WiFiManagerParameter(id, libellé, défaut, longueur)Ajoute un champ de saisie au portailL'id doit être unique, sans espace ni caractère spécial
getValue()Renvoie le texte saisiC'est toujours du texte ; pour un nombre, utilise atoi() ou atof()
setValue(valeur, longueur)Remplit le champPour 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éePour 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 :

C++ (Arduino IDE)
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 :

C++ (Arduino IDE)
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 :

MicroPython
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 request

Si 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ômeCause probableSolution
Le réseau du portail n'apparaît pas sur le téléphoneLa carte s'est connectée au réseau enregistré, donc pas de portailRegarde 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 pasLe téléphone est passé sur les données mobiles faute d'internetCoupe 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érieLe mot de passe du portail fait moins de 8 caractèresUtilise au moins 8 caractères ou ne passe pas de mot de passe
wm.process() ou setParamsPage n'est pas reconnuMauvaise bibliothèque WiFiManager ou version trop ancienneInstalle la version actuelle du WiFiManager de tzapu et supprime les bibliothèques au nom proche
Après Save, la carte rouvre le portailMauvais mot de passe ou réseau 5 GHzVé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émarrageLes valeurs n'ont pas été écrites dans la NVSEnregistre-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éversementLe bouton est sur le GPIO 0 et appuyé à la mise sous tensionAppuie 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 connexionLe point d'accès est passé sur le canal de la boxC'est normal ; reconnecte-toi après quelques secondes ou utilise softAPdisconnect(true) à la fin
En cas de problème de connexion, lis d'abord les lignes *wm: du moniteur série ; WiFiManager indique clairement quel réseau il a essayé, le résultat de la connexion et pourquoi le portail s'est fermé. Si la carte n'arrive toujours pas à se connecter après la fermeture du portail, le problème vient très probablement de la box ou de l'alimentation ; on explique pas à pas comment lire les codes d'état et de raison dans ESP32 ne se connecte pas au Wi-Fi.

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().

Voir tous les projets
Connexion Wi-Fi STA ESP32 (avec écran LCD)
ES-25Avancé

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.

4.4(21)
38
Serveur Web asynchrone ESP32 (avec affichage de l'adresse IP sur l'écran LCD)
ES-27Avancé

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).

4.8(16)
26
ESP32 mDNS : accès à l'appareil via bluegrays-esp.local (avec écran LCD)
ES-29Avancé
Premium

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/.

4.8(14)
23
Compteur ESP32 WebSocket (2 boutons + écran LCD + affichage Web en temps réel)
ES-28Avancé
Premium

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().

4.5(14)
23
Mise à jour OTA de l'ESP32 — Installation sans fil du firmware (avec écran LCD)
ES-30Avancé
Premium

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.

4.6(14)
22
ESP32 : heure réelle depuis Internet via NTP
ES-26Avancé
Premium

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.

4.5(13)
22
ESP32 HTTPClient + API météo (avec écran LCD)
ES-31Avancé
Premium

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.

4.7(13)
20
Système d'Alarme de Mouvement ESP32 (PIR + Buzzer + LED + Telegram)
ES-41Avancé
Premium

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.

9