Guide · 12 min di lettura

ESP32 WiFiManager: configurare il Wi-Fi dallo smartphone

ESP32 WiFiManager: inserisci la password Wi-Fi dallo smartphone. Captive portal, parametri propri come MQTT, pulsante reset, softAP e AP+STA con pagina web.

ESP32 WiFiManager è una libreria che ti permette di collegare il tuo ESP32 alla rete dallo smartphone, senza scrivere nel codice il nome del Wi-Fi e la password. Se la scheda non riesce a collegarsi a una rete salvata, apre una propria rete Wi-Fi; quando ti colleghi con lo smartphone compare una pagina di configurazione, scegli la tua rete dall'elenco, scrivi la password e l'ESP32 salva questi dati nella memoria permanente e si connette. Così puoi usare lo stesso sketch a casa, a scuola o da un amico senza ricaricarlo. Le prese smart e i dispositivi IoT commerciali che configuri dallo smartphone al primo avvio funzionano proprio in questo modo.

In questa guida scoprirai prima le modalità Wi-Fi dell'ESP32: station (STA), access point (AP) e AP+STA, in cui le due funzionano insieme. Poi installeremo la libreria WiFiManager, scriveremo un primo sketch senza password, aggiungeremo un pulsante che cancella le impostazioni o riapre il portale e chiederemo parametri personalizzati come server MQTT, porta e nome del dispositivo nella stessa pagina, salvandoli in modo permanente. Nelle ultime sezioni l'ESP32 creerà la propria rete con softAP, senza alcun router, per comandare un LED dallo smartphone; proveremo la modalità AP+STA e configureremo un access point sul Raspberry Pi Pico W con MicroPython.

Scheda di sviluppo ESP32
Scheda ESP32 DevKit: il suo Wi-Fi può funzionare contemporaneamente come station e come access point.

Che cos'è ESP32 WiFiManager e come funziona?

In uno sketch ESP32 normale, nome della rete e password sono scritti fissi nella riga WiFi.begin("ReteCasa", "password"). Quando cambi router, aggiorni la password o porti il dispositivo in un'altra casa, devi riaprire il codice e caricarlo di nuovo. WiFiManager sposta questo lavoro su una pagina web. All'avvio controlla se nella memoria permanente dell'ESP32 (NVS) c'è una rete salvata e, se c'è, prova a collegarsi. Se la connessione riesce, il tuo codice prosegue senza mostrare nulla. Se non c'è una rete salvata o la connessione fallisce, l'ESP32 apre un proprio access point, avvia un server DNS e pubblica una pagina di configurazione all'indirizzo 192.168.4.1. Poiché il server DNS risponde con questo indirizzo a ogni dominio richiesto dallo smartphone, il telefono apre da solo la finestra "accedi alla rete" appena si collega. È lo stesso principio delle pagine di accesso di hotel e bar e si chiama captive portal. Quando scegli la tua rete nella pagina e salvi la password, l'ESP32 si collega alla nuova rete, chiude l'access point e conserva i dati per l'avvio successivo. Tutto questo si basa sulle modalità Wi-Fi supportate dall'ESP32:

ModalitàCosa faQuando usarla
WIFI_STA (station)Si collega a un router come client e riceve un IPProgetti che vanno su internet e sono raggiungibili da ogni dispositivo della rete di casa
WIFI_AP (access point)Trasmette una propria rete e assegna indirizzi 192.168.4.x ai clientLuoghi senza router, pagine di configurazione, controllo dallo smartphone sul campo
WIFI_AP_STAFa entrambe le cose insieme, con due indirizzi IP distintiPortale WiFiManager, restare sulla rete di casa con una rete di servizio aperta
WIFI_OFFSpegne completamente la radioRisparmio della batteria, momenti in cui il Wi-Fi non serve

Installare la libreria WiFiManager

  1. Assicurati che il pacchetto delle schede ESP32 sia installato nell'Arduino IDE. Se non lo è, segui i passi dell'articolo Che cos'è l'ESP32?.
  2. Apri Strumenti > Gestisci librerie e scrivi WiFiManager nella casella di ricerca.
  3. Trova la libreria WiFiManager il cui autore è tzapu e installa la versione più recente (2.0.17 o successiva).
  4. Scegli la tua scheda in Strumenti > Scheda (ESP32 Dev Module per la maggior parte dei DevKit) e imposta la porta.
  5. La libreria non richiede pacchetti aggiuntivi: WebServer, DNSServer e Preferences sono già inclusi nel core ESP32.
Nel gestore librerie ci sono diverse librerie con nomi simili a WiFiManager. Gli sketch di questo articolo sono scritti per la libreria di tzapu; se installi ESPAsyncWiFiManager o un altro WiFiManager, i nomi delle funzioni non corrisponderanno e il codice non compilerà. Se usi la versione 3.x del core ESP32, installa anche la versione più recente della libreria; le versioni vecchie possono dare errori di compilazione con il nuovo core.

Primo esempio: collegarsi al Wi-Fi senza password nel codice

Lo sketch qui sotto è l'uso più semplice di WiFiManager. Nel codice non c'è né il nome della rete né la password. Se la scheda non riesce a collegarsi alla rete salvata entro 20 secondi, apre una rete chiamata BlueGrays-Kurulum. La password del portale è kurulum123; potresti aprire il portale anche senza password, ma allora chiunque nelle vicinanze potrebbe inserire dati di rete nel tuo dispositivo. Se il portale resta inutilizzato per 180 secondi, la scheda si riavvia e riprova la rete salvata. Questo dettaglio è importante: se dopo un blackout il router si riavvia più lentamente dell'ESP32, la scheda non resta bloccata nel portale e torna da sola sulla tua rete in pochi minuti.

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}

Dopo il caricamento apri il Monitor seriale a 115200 baud. Poiché la scheda parte per la prima volta, non ha reti salvate, e nelle righe di WiFiManager che iniziano con *wm: vedrai che l'access point è stato aperto. Ora prendi lo smartphone e segui questi passi:

  1. Trova la rete BlueGrays-Kurulum nell'elenco Wi-Fi dello smartphone e collegati con la password kurulum123.
  2. In pochi secondi la pagina di accesso si apre da sola. Se non succede, scrivi 192.168.4.1 nel browser.
  3. Tocca Configure WiFi. Compaiono le reti che l'ESP32 vede, con la potenza del segnale.
  4. Scegli la tua rete, scrivi la password e tocca Save.
  5. L'ESP32 si collega alla nuova rete, chiude l'access point e scrive nel Monitor seriale l'indirizzo IP ricevuto. Anche lo smartphone torna sulla sua rete.
  6. Resetta la scheda: questa volta il portale non si apre e l'ESP32 si collega da solo alla rete salvata in pochi secondi.

La sezione Info del portale mostra l'indirizzo MAC della scheda, i dati del chip e lo stato della memoria; Exit chiude il portale senza salvare. Queste sono le funzioni principali di WiFiManager che userai in questo articolo:

FunzioneCosa fa
autoConnect(nome, password)Prova la rete salvata; se fallisce apre il portale. Restituisce true quando è connesso
startConfigPortal(nome, password)Apre subito il portale senza controllare la rete salvata
setConfigPortalTimeout(s)Chiude il portale e restituisce false se resta inutilizzato per questi secondi
setConnectTimeout(s)Durata del tentativo di connessione alla rete salvata
resetSettings()Cancella nome e password Wi-Fi salvati
addParameter(¶metro)Aggiunge un campo personalizzato alla pagina del portale
setSaveParamsCallback(funzione)Chiama la tua funzione quando i parametri personalizzati vengono salvati
setConfigPortalBlocking(false) e process()Mantiene loop() in esecuzione mentre il portale è aperto
setHostname("nome")Imposta il nome della scheda in rete, visibile nell'elenco dispositivi del router
Quando lo smartphone si collega alla rete del portale può avvisarti che "questa rete non ha accesso a internet" e dopo un po' provare a passare ai dati mobili o a un altro Wi-Fi. Se compare l'avviso, scegli resta connesso; se la pagina non si apre, disattiva temporaneamente i dati mobili. Su iPhone, se la finestra di accesso si chiude, puoi riaprire la pagina toccando l'icona informazioni accanto alla rete BlueGrays-Kurulum nelle impostazioni Wi-Fi.

Pulsante di reset e portale su richiesta

Una volta chiuso il dispositivo nella sua scatola, potresti dover cambiare i dati del Wi-Fi. Il modo più semplice per farlo senza caricare nuovo codice è un pulsante. Nell'esempio usiamo il pulsante BOOT delle schede ESP32 DevKit; è collegato al GPIO 0 e, grazie alla resistenza di pull-up sulla scheda, legge LOW quando lo premi. Una pressione breve apre il portale senza cancellare la rete salvata: puoi inserire una nuova rete o modificare solo le impostazioni personalizzate. Se lo tieni premuto per 3 secondi, la rete salvata viene cancellata del tutto e la scheda si riavvia. Se preferisci un pulsante separato, collegalo a un pin libero come il GPIO 4; trovi i dettagli in Come collegare un pulsante. Il LED integrato sul GPIO 2 mostra lo stato della connessione.

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}
Il GPIO 0 è un pin di strapping: se è LOW all'accensione o al reset, l'ESP32 non esegue il tuo codice ed entra in modalità di caricamento. Premi quindi il pulsante BOOT solo dopo che la scheda si è avviata. Se colleghi il pulsante a un altro pin invece del GPIO 0, evita i pin di strapping come GPIO 0, 2, 5, 12 e 15; puoi vedere i pin sicuri nello strumento Pinout.

Parametri personalizzati: server MQTT, porta e nome del dispositivo

Una delle funzioni più utili di WiFiManager è la possibilità di aggiungere campi tuoi alla pagina del portale. Se colleghi una scheda sensore a Home Assistant tramite MQTT, non vuoi scrivere fissi nel codice nemmeno l'indirizzo del server, il numero di porta e il nome del dispositivo. Per questo crei oggetti WiFiManagerParameter e li aggiungi al portale con addParameter(). C'è solo un punto a cui fare attenzione: WiFiManager salva da solo nome e password del Wi-Fi, ma non salva i parametri personalizzati. Salvare i valori inseriti dall'utente è compito tuo. Useremo la libreria Preferences inclusa nel core ESP32; Preferences scrive coppie chiave-valore nella partizione NVS della memoria flash, che restano anche se manca la corrente. Se ti interessa l'equivalente su Arduino, guarda l'articolo EEPROM di 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}

Quando apri la pagina Configure WiFi del portale vedrai tre nuovi campi sotto l'elenco delle reti. Sono già compilati con i valori salvati nella NVS, oppure con i valori predefiniti del codice se non c'è ancora nulla di salvato. Quando tocchi Save, WiFiManager chiama prima la tua funzione parametreleriKaydet() e poi si collega al Wi-Fi. Ecco il riepilogo di parametri e funzioni:

ElementoCompitoNota
WiFiManagerParameter(id, etichetta, predefinito, lunghezza)Aggiunge un campo al portaleL'id deve essere unico, senza spazi né caratteri speciali
getValue()Restituisce il testo inseritoÈ sempre testo; per i numeri usa atoi() o atof()
setValue(valore, lunghezza)Compila il campoPer mostrare nel modulo il valore salvato
setSaveParamsCallback()Chiama la tua funzione al momento del salvataggioQui scrivi nella NVS
setParamsPage(true)Sposta i parametri in una pagina Setup separataPer cambiare solo le impostazioni senza toccare il Wi-Fi

Attenzione alla lunghezza: dimensione dell'array e lunghezza del parametro devono coincidere, altrimenti un testo lungo potrebbe sforare la memoria o venire troncato. Per questo lo sketch copia i valori con strlcpy(), che non supera mai la dimensione dell'array di destinazione. È anche una buona abitudine controllare che i valori numerici come la porta siano in un intervallo sensato prima di usarli.

La rete propria dell'ESP32: controllo web dallo smartphone con softAP

Il portale di WiFiManager è in realtà un uso già pronto della funzione access point dell'ESP32, e puoi usarla anche tu. Quando chiami WiFi.softAP(), l'ESP32 si comporta come un router: trasmette la propria rete, assegna allo smartphone che si collega un indirizzo come 192.168.4.2 e resta lui stesso su 192.168.4.1. È ideale per comandare qualcosa dallo smartphone in un giardino senza router, a una fiera scientifica della scuola o a una gara di robot. La funzione riceve nome della rete, password, canale, un'opzione per la rete nascosta e il numero massimo di connessioni. La password deve avere almeno 8 caratteri; se ne passi una più corta, softAP() restituisce false e la rete non si apre. Di default sono ammesse al massimo 4 connessioni, e sull'ESP32 si può arrivare a 10. Lo sketch qui sotto pubblica una pagina web che accende e spegne il LED sul GPIO 2 dallo smartphone:

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}

Carica il codice, collega lo smartphone alla rete BlueGrays-LED e apri 192.168.4.1 nel browser. Il LED si accende e si spegne quando tocchi i pulsanti e la pagina mostra quanti dispositivi sono collegati. Qui non c'è un captive portal, quindi l'indirizzo devi scriverlo tu. Se la pagina non si carica, ricorda che lo smartphone potrebbe essere passato ai dati mobili per la mancanza di internet. Se vuoi un pannello di controllo che si aggiorna all'istante senza ricaricare la pagina, puoi usare il metodo dell'articolo web server ESP32 e WebSocket sulla stessa rete softAP.

AP+STA insieme: trasmettere la propria rete restando sulla rete di casa

In modalità WIFI_AP_STA l'ESP32 si collega al router e contemporaneamente trasmette la propria rete. La scheda ha così due indirizzi IP distinti: WiFi.localIP() restituisce l'indirizzo nella rete di casa e WiFi.softAPIP() il 192.168.4.1 della propria rete. Anche il portale di WiFiManager funziona in questa modalità, così può cercare le reti mentre serve una pagina allo smartphone. Nei tuoi progetti puoi scegliere AP+STA per lasciare una rete di servizio a cui collegarti sempre dallo smartphone, anche con il router spento, oppure per usare insieme ESP-NOW e Wi-Fi. Lo sketch qui sotto serve la stessa pagina su entrambe le interfacce:

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}

La modalità AP+STA ha un limite importante da conoscere: l'ESP32 ha una sola radio, quindi le due reti devono funzionare sullo stesso canale. Una rete che apri sul canale 1 con softAP() passa al canale 11 nel momento in cui l'ESP32 si collega a un router sul canale 11. Durante il cambio, lo smartphone collegato alla rete di servizio può perdere la connessione per qualche secondo. Poiché la radio è condivisa tra due reti, la velocità cala e la scheda consuma un po' di più. Se finita la configurazione la rete di servizio non ti serve più, puoi spegnere l'access point con WiFi.softAPdisconnect(true) e riportare la scheda in sola modalità station.

Access point con il Raspberry Pi Pico W e MicroPython

Sul Raspberry Pi Pico W non esiste un equivalente esatto del WiFiManager di Arduino, ma creare un access point in MicroPython richiede poche righe. network.WLAN(network.AP_IF) ti dà l'interfaccia access point; imposti nome della rete e password con config() e la attivi con active(True). Anche il Pico W assegna indirizzi 192.168.4.x ai client e resta su 192.168.4.1. Il codice qui sotto è un piccolo web server che accende e spegne il LED integrato del Pico W dallo smartphone:

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

Se salvi il codice sul Pico W come main.py con Thonny, la scheda crea la sua rete automaticamente a ogni avvio. Basta collegare lo smartphone alla rete BlueGrays-Pico e aprire 192.168.4.1. Se vuoi un captive portal sul Pico W, la libreria phew di Pimoroni offre un access point e un server DNS che intercetta tutti i domini; il principio è lo stesso di WiFiManager. Per collegare il Pico W alla rete di casa e far girare un web server in modalità station leggi l'articolo web server Wi-Fi con Pico W, e se sei alle prime armi con MicroPython dai un'occhiata alle basi di MicroPython.

Idee di progetto con WiFiManager

  • Indicatore di temperatura da regalare: Chi riceve una scheda sensore che mostra le misure su una pagina web la collega da solo al proprio Wi-Fi dallo smartphone.
  • Sensore domotico: Collega a Home Assistant una scheda che prende il server MQTT dal portale; se l'indirizzo del server cambia, niente nuovo caricamento.
  • Allarme con notifica sullo smartphone: Crea un bot Telegram con ESP32 che chiede il token del bot come parametro personalizzato.
  • Aggiornamenti wireless nella scatola: Invia nuovo codice con un aggiornamento OTA a una scheda entrata in rete tramite WiFiManager.
  • Orologio via internet: Costruisci un orologio NTP con il fuso orario scelto nel portale.
  • Controllo senza router: Accendi e spegni dallo smartphone la pompa d'irrigazione del giardino con softAP; per far comunicare più schede usa ESP-NOW.

Errori comuni e soluzioni

SintomoCausa probabileSoluzione
La rete del portale non compare sullo smartphoneLa scheda si è collegata alla rete salvata e non ha aperto il portaleGuarda il Monitor seriale; per provare esegui resetSettings() una volta o apri il portale con il pulsante
Sono collegato ma la pagina non si apreLo smartphone è passato ai dati mobili per mancanza di internetDisattiva i dati mobili e scrivi 192.168.4.1 nel browser
Il portale non si apre e il Monitor seriale segnala la passwordLa password del portale ha meno di 8 caratteriUsa almeno 8 caratteri o non passare la password
wm.process() o setParamsPage non vengono riconosciutiLibreria WiFiManager sbagliata o molto vecchiaInstalla la versione attuale del WiFiManager di tzapu e rimuovi le librerie con nomi simili
Dopo Save la scheda riapre il portalePassword errata o rete a 5 GHzControlla la password e scegli la rete a 2,4 GHz; dettagli nella guida sul Wi-Fi che non si connette
I parametri personalizzati spariscono al riavvioI valori non sono stati scritti nella NVSSalvali con Preferences in setSaveParamsCallback, rileggili all'avvio e mettili nel modulo con setValue()
La scheda entra continuamente in modalità di caricamentoIl pulsante è sul GPIO 0 ed è premuto all'accensionePremi il pulsante dopo l'avvio o usa un pin che non sia di strapping
In modalità AP+STA lo smartphone perde la connessioneL'access point si è spostato sul canale del routerÈ normale; ricollegati dopo qualche secondo o usa softAPdisconnect(true) alla fine
In caso di problemi di connessione leggi prima le righe *wm: del Monitor seriale; WiFiManager scrive chiaramente quale rete ha provato, l'esito della connessione e perché il portale si è chiuso. Se la scheda non riesce ancora a collegarsi dopo la chiusura del portale, il problema è molto probabilmente nel router o nell'alimentazione; spieghiamo passo passo come leggere i codici di stato e di motivo in ESP32 non si connette al Wi-Fi.

WiFiManager è il passo più semplice per trasformare un progetto ESP32 da esperimento sulla scrivania a dispositivo che anche altri possono usare: la password esce dal codice, le impostazioni si inseriscono dallo smartphone e un solo pulsante azzera tutto. Ora che conosci anche softAP e AP+STA, puoi realizzare progetti comandati dallo smartphone ovunque, con o senza router. Nell'app BlueGrays puoi esplorare progetti ESP32 come la connessione Wi-Fi, il web server asincrono, mDNS, WebSocket, l'aggiornamento OTA e l'allarme Telegram, con schemi passo passo e codice pronto all'uso.

Domande frequenti

A cosa serve ESP32 WiFiManager?

Serve a collegare un ESP32 alla rete dallo smartphone senza scrivere nel codice il nome del Wi-Fi e la password. Se la scheda non riesce a collegarsi a una rete salvata, apre un proprio access point e mostra una pagina di configurazione su 192.168.4.1. La rete e la password scelte lì vengono salvate nella memoria permanente e usate automaticamente all'avvio successivo.

Dove salva WiFiManager la password del Wi-Fi?

Sull'ESP32, nome e password del Wi-Fi sono conservati nella partizione NVS della memoria flash, come impostazioni del driver Wi-Fi. Non vengono cancellati quando carichi un nuovo codice. Per cancellarli chiama resetSettings() oppure cancella completamente la flash.

Come si resettano le impostazioni di WiFiManager?

Basta chiamare wm.resetSettings() nel codice e riavviare la scheda. In pratica conviene collegarlo a un pulsante: per esempio un controllo che cancella le impostazioni quando il pulsante BOOT resta premuto per 3 secondi. Se vuoi solo aprire il portale senza cancellare la rete salvata, usa startConfigPortal().

Perché il captive portal dell'ESP32 non si apre?

Il motivo più comune è che lo smartphone vede che sulla rete del portale non c'è internet e passa ai dati mobili; disattivali e scrivi 192.168.4.1 nel browser. Se la scheda si è già collegata a una rete salvata, il portale non si apre affatto. Controlla anche che la password del portale abbia almeno 8 caratteri.

L'ESP32 può essere access point e station contemporaneamente?

Sì. In modalità WIFI_AP_STA l'ESP32 trasmette la propria rete mentre è collegato al router e usa due indirizzi IP distinti. Avendo una sola radio, le due reti devono usare lo stesso canale; quando la scheda si collega al router, l'access point passa al canale del router.

Quanti dispositivi si possono collegare al softAP di un ESP32?

Nel core Arduino, softAP() ammette di default fino a 4 dispositivi. Sull'ESP32 puoi arrivare a 10 con il quinto parametro di softAP(). Il numero di dispositivi collegati si legge con WiFi.softAPgetStationNum().

Vedi tutti i progetti
Connessione Wi-Fi STA con ESP32 (con display LCD)
ES-25Avanzato

Connessione Wi-Fi STA con ESP32 (con display LCD)

In questo progetto colleghiamo l'ESP32 alla rete Wi-Fi domestica in modalità Station (STA) in modo sicuro e tollerante agli errori. Separiamo SSID e password in un file secrets.h per impedire fughe su Git, impostiamo un meccanismo di riconnessione automatica e visualizziamo il livello del segnale RSSI e l'indirizzo IP su un display LCD I2C. Il LED interno funge da indicatore di stato.

4.4(21)
38
Server web asincrono ESP32 (con indicazione dell'IP sul display LCD)
ES-27Avanzato

Server web asincrono ESP32 (con indicazione dell'IP sul display LCD)

In questo progetto trasformiamo l'ESP32 in un server web asincrono che potrete controllare dal vostro telefono o computer collegato alla stessa rete Wi-Fi. Grazie alla libreria ESPAsyncWebServer, il server è in grado di elaborare più richieste contemporaneamente (a differenza del classico WebServer.h, che si blocca su una singola richiesta).

4.8(16)
26
ESP32 mDNS: accesso al dispositivo tramite bluegrays-esp.local (con schermo LCD)
ES-29Avanzato
Premium

ESP32 mDNS: accesso al dispositivo tramite bluegrays-esp.local (con schermo LCD)

Aggiungiamo all'ESP32 un servizio mDNS (Multicast DNS), così lo raggiungi con un nome host leggibile come bluegrays-esp.local invece che con un indirizzo IP. Anche se l'IP assegnato dal DHCP cambia, il dispositivo risponde sempre allo stesso nome. Un piccolo server web sulla scheda ti permette di controllare il LED dal browser all'indirizzo http://bluegrays-esp.local/.

4.8(14)
23
Contatore WebSocket ESP32 (2 pulsanti + LCD + Web in tempo reale)
ES-28Avanzato
Premium

Contatore WebSocket ESP32 (2 pulsanti + LCD + Web in tempo reale)

In questo progetto due pulsanti collegati all'ESP32 (GPIO 5 incrementa, GPIO 4 decrementa) modificano un contatore. Il valore si aggiorna all'istante su un display LCD I2C 16x2 e, grazie al supporto WebSocket di ESPAsyncWebServer, in tutti i browser collegati senza ricaricare la pagina. Al posto del polling HTTP si usa un'unica connessione persistente e l'ESP32 invia il nuovo valore a tutti con ws.textAll().

4.5(14)
23
Aggiornamento OTA dell'ESP32 — Installazione wireless del firmware (con display LCD)
ES-30Avanzato
Premium

Aggiornamento OTA dell'ESP32 — Installazione wireless del firmware (con display LCD)

Imparerai a caricare un nuovo firmware sull'ESP32 via Wi-Fi, senza cavo USB. Con la libreria ArduinoOTA l'ESP32 diventa visibile in rete e compare automaticamente come bluegrays-ota nella scheda "Network port" dell'Arduino IDE. Il primo caricamento avviene via USB, poi tutti gli aggiornamenti sono wireless: una funzione fondamentale per i dispositivi installati sul campo.

4.6(14)
22
ESP32: ora reale da Internet tramite NTP
ES-26Avanzato
Premium

ESP32: ora reale da Internet tramite NTP

L'ESP32 si collega al Wi-Fi e ottiene l'ora esatta dai server NTP (Network Time Protocol) con precisione al millisecondo. Con configTzTime() si applica in automatico il fuso orario turco (TRT, UTC+3) e, nei paesi con l'ora legale, il cambio (DST) è gestito da una stringa POSIX TZ. L'ora viene stampata sul Serial Monitor e su un display LCD I2C opzionale.

4.5(13)
22
ESP32 HTTPClient + API meteo (con schermo LCD)
ES-31Avanzato
Premium

ESP32 HTTPClient + API meteo (con schermo LCD)

L'ESP32 effettua via internet una chiamata REST a un'API meteo (wttr.in) con HTTPClient.h. La risposta JSON viene analizzata con ArduinoJson v7 e città, temperatura, umidità, condizioni meteo e vento compaiono su un display LCD I2C. wttr.in non richiede una chiave API: basta scrivere il nome di una città qualsiasi.

4.7(13)
20
Sistema di Allarme Movimento ESP32 (PIR + Buzzer + LED + Telegram)
ES-41Avanzato
Premium

Sistema di Allarme Movimento ESP32 (PIR + Buzzer + LED + Telegram)

Un allarme di sicurezza smart: quando il sensore PIR rileva un movimento, suona il buzzer, si accende il LED e il proprietario riceve subito una notifica su Telegram. Un'attesa di 30 secondi (cooldown) limita la frequenza degli allarmi ripetuti; non elimina i falsi rilevamenti del sensore PIR. Adatto a casa, garage, magazzino o studio.

9