ESP32 WiFiManager: настройка Wi-Fi с телефона (captive portal)
ESP32 WiFiManager позволяет ввести пароль Wi-Fi с телефона: captive portal, дополнительные параметры вроде MQTT, кнопка сброса, softAP и управление через веб в режиме AP+STA.
ESP32 WiFiManager — библиотека, которая позволяет подключить ESP32 к сети с телефона, не записывая имя сети Wi-Fi и пароль в код. Если плата не может подключиться к сохранённой сети, она создаёт собственную сеть Wi-Fi; когда ты подключаешься к ней с телефона, появляется страница настроек. Ты выбираешь свою сеть из списка, вводишь пароль, а ESP32 сохраняет эти данные в энергонезависимой памяти и подключается. Это позволяет использовать одну прошивку дома, в школе или у друзей без повторной загрузки. Умные розетки и готовые IoT-устройства, которые при первом запуске настраиваются с телефона, работают точно так же.
В этом руководстве ты сначала познакомишься с режимами Wi-Fi ESP32: станция (STA), точка доступа (AP) и AP+STA, в котором оба режима работают вместе. Затем мы установим библиотеку WiFiManager, напишем первый скетч без пароля, добавим кнопку для удаления настроек или повторного открытия портала, а также соберём на той же странице дополнительные параметры, например MQTT-сервер, порт и имя устройства, и сохраним их в энергонезависимой памяти. В последних разделах ESP32 создаст собственную сеть через softAP без роутера, для управления светодиодом с телефона; мы попробуем режим AP+STA и настроим точку доступа на Raspberry Pi Pico W с MicroPython.

Что такое ESP32 WiFiManager и как он работает?
В обычном скетче ESP32 имя сети и пароль прописаны в строке WiFi.begin("HomeNet", "password"). При замене роутера, смене пароля или переносе устройства в другой дом приходится открывать код и загружать его заново. WiFiManager переносит эту работу на веб-страницу. При запуске он проверяет, сохранена ли сеть в энергонезависимой памяти ESP32 (NVS), и, если да, пытается подключиться к ней. Если подключение удалось, твой код продолжает работу, ничего не показывая. Если сохранённой сети нет или подключение не удалось, ESP32 открывает собственную точку доступа, запускает DNS-сервер и предоставляет страницу настроек по адресу 192.168.4.1. Поскольку DNS-сервер отвечает этим адресом на любой домен, запрашиваемый телефоном, сразу после подключения телефон автоматически открывает окно «Войти в сеть». Это тот же принцип, что у страниц входа в отелях и кафе, и называется он captive portal. Когда ты выбираешь сеть на странице и сохраняешь пароль, ESP32 подключается к новой сети, закрывает точку доступа и сохраняет данные для следующего запуска. Всё это основано на режимах Wi-Fi, которые поддерживает ESP32:
| Режим | Что делает | Когда использовать |
|---|---|---|
| WIFI_STA (станция) | Подключается к роутеру как клиент и получает от него IP-адрес | Проекты с выходом в интернет, доступные с любого устройства домашней сети |
| WIFI_AP (точка доступа) | Создаёт собственную сеть и выдаёт клиентам адреса 192.168.4.x | Места без роутера, страницы настройки, управление с телефона вне дома |
| WIFI_AP_STA | Выполняет обе функции одновременно с двумя отдельными IP-адресами | Портал WiFiManager, подключение к домашней сети при открытой служебной сети |
| WIFI_OFF | Полностью отключает радиомодуль | Экономия заряда батареи, периоды, когда Wi-Fi не нужен |
Установка библиотеки WiFiManager
- Убедись, что в Arduino IDE установлен пакет плат ESP32. Если нет, выполни шаги из статьи Что такое ESP32?.
- Открой «Инструменты › Управлять библиотеками» (Tools › Manage Libraries) и введи WiFiManager в поле поиска.
- Найди библиотеку WiFiManager, автор которой — tzapu, и установи последнюю версию (2.0.17 или новее).
- Выбери свою плату в меню «Инструменты › Плата» (Tools › Board; для большинства DevKit — ESP32 Dev Module) и укажи порт.
- Библиотеке не нужны дополнительные пакеты: WebServer, DNSServer и Preferences уже входят в ядро ESP32.
Первый пример: подключение к Wi-Fi без пароля в коде
Скетч ниже — самый простой способ использовать WiFiManager. В коде нет имени сети и пароля. Если плата не может подключиться к сохранённой сети за 20 секунд, она создаёт сеть BlueGrays-Kurulum. Пароль портала задан как kurulum123; портал можно открыть и без пароля, но тогда любой человек поблизости сможет ввести данные сети в твоё устройство. Если порталом не пользоваться 180 секунд, плата перезапускается и снова пробует подключиться к сохранённой сети. Это важная деталь: если после отключения питания роутер загружается медленнее ESP32, плата не застрянет в портале и самостоятельно вернётся в твою сеть через несколько минут.
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}После загрузки открой монитор порта на скорости 115 200 бод. Поскольку плата запускается впервые, сохранённой сети у неё нет, и в строках WiFiManager, начинающихся с *wm:, ты увидишь, что точка доступа открыта. Теперь возьми телефон и выполни следующие шаги:
- Найди сеть BlueGrays-Kurulum в списке Wi-Fi на телефоне и подключись с паролем kurulum123.
- Через несколько секунд страница входа откроется автоматически. Если этого не произойдёт, введи 192.168.4.1 в браузере.
- Нажми Configure WiFi (настроить Wi-Fi). Появится список сетей, которые видит ESP32, с уровнем сигнала каждой.
- Выбери свою сеть, введи её пароль и нажми Save (сохранить).
- ESP32 подключается к новой сети, закрывает точку доступа и выводит полученный IP-адрес в монитор порта. Телефон тоже возвращается в свою сеть.
- Перезапусти плату: на этот раз портал не открывается, а ESP32 автоматически подключается к сохранённой сети за несколько секунд.
Раздел Info (информация) портала показывает MAC-адрес платы, сведения о чипе и состояние памяти; Exit (выход) закрывает портал без сохранения. Вот основные функции WiFiManager, которые мы используем в этой статье:
| Функция | Что делает |
|---|---|
| autoConnect(name, password) | Пробует подключиться к сохранённой сети; при неудаче открывает портал. После подключения возвращает true |
| startConfigPortal(name, password) | Сразу открывает портал, не проверяя сохранённую сеть |
| setConfigPortalTimeout(s) | Закрывает портал и возвращает false, если им не пользуются указанное число секунд |
| setConnectTimeout(s) | Задаёт время попытки подключения к сохранённой сети |
| resetSettings() | Удаляет сохранённые имя сети Wi-Fi и пароль |
| addParameter(¶meter) | Добавляет дополнительное поле ввода на страницу портала |
| setSaveParamsCallback(function) | Вызывает твою функцию при сохранении дополнительных параметров |
| setConfigPortalBlocking(false) и process() | Позволяет loop() продолжать работу, пока портал открыт |
| setHostname("name") | Задаёт сетевое имя платы, отображаемое в списке устройств роутера |
Кнопка сброса и портал по запросу
Когда устройство уже закрыто в корпусе, может понадобиться изменить данные Wi-Fi. Проще всего сделать это без загрузки нового кода с помощью кнопки. В примере ниже используем кнопку BOOT на платах ESP32 DevKit; она подключена к GPIO 0 и благодаря подтягивающему резистору на плате при нажатии даёт LOW. Короткое нажатие открывает портал без удаления сохранённой сети, чтобы можно было ввести новую сеть или просто изменить дополнительные настройки. Удержание в течение 3 секунд полностью удаляет сохранённую сеть и перезапускает плату. Если предпочитаешь отдельную кнопку, подключи её к свободному пину, например GPIO 4; подробности — в статье Как подключить кнопку. Встроенный светодиод на GPIO 2 показывает состояние подключения.
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}Дополнительные параметры: MQTT-сервер, порт и имя устройства
Одна из самых полезных возможностей WiFiManager — добавление собственных полей ввода на страницу портала. Если ты подключаешь плату с датчиком к Home Assistant через MQTT, адрес сервера, номер порта и имя устройства тоже не хочется прописывать в коде. Для этого создаются объекты WiFiManagerParameter и добавляются в портал через addParameter(). Важно учесть одно: WiFiManager самостоятельно сохраняет имя сети Wi-Fi и пароль, но не сохраняет дополнительные параметры. Сохранение введённых пользователем значений — твоя задача. Мы используем библиотеку Preferences, которая входит в ядро ESP32; Preferences записывает пары «ключ — значение» в раздел NVS флеш-памяти, и они сохраняются после отключения питания. Если интересно, как это устроено на Arduino, загляни в статью 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}Когда откроешь страницу Configure WiFi в портале, под списком сетей увидишь три новых поля. Они уже заполнены значениями из NVS или значениями по умолчанию из кода, если ничего ещё не сохранено. При нажатии Save WiFiManager сначала вызывает твою функцию parametreleriKaydet(), а затем подключается к Wi-Fi. Краткий обзор параметров и функций:
| Элемент | Назначение | Примечание |
|---|---|---|
| WiFiManagerParameter(id, label, default, length) (конструктор, добавляющий поле ввода на портал) | Добавляет поле ввода в портал | id должен быть уникальным, без пробелов и специальных символов |
| getValue() | Возвращает введённый пользователем текст | Это всегда текст; для чисел используй atoi() или atof() |
| setValue(value, length) | Заполняет поле | Используется для отображения сохранённого значения в форме |
| setSaveParamsCallback() | Вызывает твою функцию в момент сохранения | Записывай данные в NVS здесь |
| setParamsPage(true) | Переносит параметры на отдельную страницу Setup | Для обновления только настроек, без изменения Wi-Fi |
Следи за значением длины: размер массива и длина параметра должны совпадать, иначе длинная запись может вызвать переполнение памяти или обрезаться. Поэтому скетч копирует значения через strlcpy(): эта функция никогда не выходит за размер целевого массива. Также полезно проверять перед использованием, что числовые значения, например номер порта, находятся в допустимом диапазоне.
Собственная сеть ESP32: управление через веб с телефона с помощью softAP
Портал WiFiManager — это готовый пример использования точки доступа ESP32, и ты тоже можешь напрямую использовать эту возможность. При вызове WiFi.softAP() ESP32 ведёт себя как роутер: создаёт собственную сеть, выдаёт подключившемуся телефону адрес вроде 192.168.4.2, а сама находится по адресу 192.168.4.1. Это удобно для управления с телефона в саду без роутера, на школьной научной выставке или соревнованиях роботов. Функция принимает имя сети, пароль, канал, признак скрытой сети и максимальное число подключений. Пароль должен содержать не менее 8 символов; если передать более короткий, softAP() вернёт false и сеть не появится. Максимальное число подключений по умолчанию — 4, а на ESP32 его можно увеличить до 10. Скетч ниже предоставляет веб-страницу, с которой можно включать и выключать светодиод на GPIO 2 с телефона:
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}Загрузи код, подключись с телефона к сети BlueGrays-LED и открой 192.168.4.1 в браузере. Светодиод включается и выключается при нажатии кнопок, а страница показывает число подключённых устройств. Captive portal здесь нет, поэтому адрес нужно вводить вручную. Если страница не загружается, помни: телефон мог переключиться на мобильные данные из-за отсутствия интернета. Если нужна панель управления с мгновенным обновлением без перезагрузки страницы, можно использовать способ из статьи Веб-сервер ESP32 и WebSocket в той же сети softAP.
AP+STA вместе: собственная сеть при подключении к домашней сети
В режиме WIFI_AP_STA ESP32 одновременно подключается к роутеру и создаёт собственную сеть. При этом у платы два отдельных IP-адреса: WiFi.localIP() возвращает адрес в домашней сети, а WiFi.softAPIP() — 192.168.4.1 в собственной сети. Портал WiFiManager тоже работает в этом режиме, поэтому может искать сети и одновременно предоставлять страницу телефону. В своих проектах можно выбрать AP+STA, чтобы оставить служебную сеть, к которой всегда можно подключиться с телефона, даже если роутер выключен, или чтобы использовать ESP-NOW и Wi-Fi вместе. Скетч ниже предоставляет одну и ту же страницу через оба интерфейса:
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}У режима AP+STA есть важное ограничение: в ESP32 один радиомодуль, поэтому обе сети должны работать на одном канале. Сеть, открытая через softAP() на канале 1, перейдёт на канал 11, как только ESP32 подключится к роутеру на канале 11. Во время переключения телефон, подключённый к служебной сети, может потерять соединение на несколько секунд. Поскольку радиомодуль делится между двумя сетями, пропускная способность снижается, а плата потребляет немного больше тока. Если после настройки служебная сеть больше не нужна, можно отключить точку доступа через WiFi.softAPdisconnect(true) и вернуть плату в режим только станции.
Точка доступа на Raspberry Pi Pico W с MicroPython
Для Raspberry Pi Pico W нет точного аналога Arduino WiFiManager, но настройка точки доступа в MicroPython занимает всего несколько строк. network.WLAN(network.AP_IF) предоставляет интерфейс точки доступа; имя сети и пароль задаются через config(), а включается она через active(True). Pico W тоже выдаёт клиентам адреса 192.168.4.x, а сама находится по адресу 192.168.4.1. Код ниже — небольшой веб-сервер, позволяющий включать и выключать встроенный светодиод Pico W с телефона:
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Если сохранить код на Pico W через Thonny под именем main.py, плата будет автоматически создавать свою сеть при каждом запуске. Достаточно подключиться с телефона к сети BlueGrays-Pico и открыть 192.168.4.1. Если нужен captive portal на Pico W, библиотека phew от Pimoroni предоставляет точку доступа и DNS-сервер, перехватывающий все домены; принцип тот же, что у WiFiManager. Как подключить Pico W к домашней сети и запустить веб-сервер в режиме станции, читай в статье Веб-сервер Wi-Fi на Pico W, а если знакомство с MicroPython только начинается, загляни в руководство Основы MicroPython.
Идеи проектов с WiFiManager
- Индикатор температуры в подарок: Пусть получатель платы с датчиком, которая показывает измерения на веб-странице, подключит её к своему Wi-Fi с телефона.
- Датчик умного дома: Подключи плату, которая получает адрес MQTT-сервера через портал, к Home Assistant; при смене адреса сервера повторная загрузка кода не понадобится.
- Сигнализация с уведомлениями на телефон: Создай Telegram-бота на ESP32, который получает токен бота как дополнительный параметр.
- Беспроводные обновления устройства в корпусе: Отправляй новый код через обновление прошивки по воздуху (OTA) на плату, подключённую к сети через WiFiManager.
- Интернет-часы: Собери NTP-часы с выбором часового пояса в портале.
- Управление вне дома без роутера: Включай и выключай насос для полива сада с телефона через softAP; для связи между несколькими платами используй ESP-NOW.
Частые ошибки и решения
| Симптом | Вероятная причина | Решение |
|---|---|---|
| Сеть портала не видна на телефоне | Плата подключилась к сохранённой сети, поэтому портал не открылся | Проверь монитор порта; для проверки один раз вызови resetSettings() или открой портал кнопкой |
| Подключение к сети есть, но страница не открывается | Телефон переключился на мобильные данные из-за отсутствия интернета | Отключи мобильные данные и введи 192.168.4.1 в браузере |
| Портал не открывается, а в мониторе порта предупреждение о пароле | Пароль портала короче 8 символов | Используй пароль не короче 8 символов или не передавай параметр пароля |
| wm.process() или setParamsPage не распознаётся | Неподходящая или очень старая библиотека WiFiManager | Установи актуальную версию WiFiManager от tzapu и удали библиотеки с похожими названиями |
| После нажатия Save плата снова открывает портал | Введён неверный пароль или сеть работает на 5 GHz | Проверь пароль и выбери сеть 2,4 GHz; подробности — в руководстве о проблемах подключения к Wi-Fi |
| Дополнительные параметры пропадают после перезапуска | Значения не записаны в NVS | Сохраняй их через Preferences в setSaveParamsCallback, считывай при запуске и заполняй форму через setValue() |
| Плата постоянно переходит в режим загрузки | Кнопка подключена к GPIO 0 и нажата при включении питания | Нажимай кнопку после запуска платы или используй пин, не участвующий в конфигурации при старте |
| Телефон отключается в режиме AP+STA | Точка доступа перешла на канал роутера | Это нормально; подключись снова через несколько секунд или используй softAPdisconnect(true) после завершения работы |
WiFiManager — самый простой шаг, чтобы превратить проект на ESP32 из настольного эксперимента в устройство, которым могут пользоваться другие: пароль больше не хранится в коде, настройки вводятся с телефона, а одна кнопка сбрасывает всё. Теперь, когда тебе знакомы softAP и AP+STA, можно создавать проекты с управлением с телефона в любых условиях, с роутером и без него. В приложении BlueGrays можно изучить проекты на ESP32: подключение к Wi-Fi, асинхронный веб-сервер, mDNS, WebSocket, обновление прошивки по воздуху (OTA) и сигнализацию с Telegram. Каждый проект содержит пошаговые схемы подключения и готовый код.
Частые вопросы
Для чего нужен ESP32 WiFiManager?
Он позволяет подключить ESP32 к сети с телефона, не записывая имя сети Wi-Fi и пароль в код. Если плата не может подключиться к сохранённой сети, она открывает собственную точку доступа и предоставляет страницу настроек по адресу 192.168.4.1. Выбранная сеть и введённый пароль сохраняются в энергонезависимой памяти и автоматически используются при следующем запуске.
Где WiFiManager хранит сохранённый пароль Wi-Fi?
На ESP32 имя сети Wi-Fi и пароль хранятся в разделе NVS флеш-памяти как собственные настройки драйвера Wi-Fi. При загрузке нового кода они не удаляются. Чтобы удалить их, вызови resetSettings() или полностью сотри флеш-память.
Как сбросить настройки WiFiManager?
Вызови wm.resetSettings() в коде и перезапусти плату. На практике лучше привязать это к кнопке: например, добавить проверку, которая удаляет настройки при удержании кнопки BOOT в течение 3 секунд. Если нужно только открыть портал без удаления сохранённой сети, используй startConfigPortal().
Почему не открывается страница captive portal ESP32?
Чаще всего телефон обнаруживает, что в сети портала нет интернета, и переключается на мобильные данные; отключи их и введи 192.168.4.1 в браузере. Если плата уже подключена к сохранённой сети, портал вообще не открывается. Также убедись, что пароль портала содержит не менее 8 символов.
Может ли ESP32 одновременно быть точкой доступа и станцией?
Да. В режиме WIFI_AP_STA ESP32 создаёт собственную сеть, оставаясь подключённой к роутеру, и использует два отдельных IP-адреса. Поскольку радиомодуль всего один, обе сети должны использовать один канал; при подключении платы к роутеру точка доступа переходит на его канал.
Сколько устройств можно подключить к softAP ESP32?
В ядре Arduino softAP() по умолчанию допускает до 4 устройств. На ESP32 это число можно увеличить до 10 пятым параметром softAP(). Узнать число подключённых устройств можно через WiFi.softAPgetStationNum().
Что собрать после прочтения
Все проекты
Подключение ESP32 к Wi-Fi в режиме STA (с экраном LCD)
В этом проекте ESP32 надёжно и устойчиво к сбоям подключается к домашней сети Wi-Fi в режиме станции (STA). SSID и пароль хранятся в отдельном файле secrets.h, чтобы не утекли в Git; настроено автоматическое переподключение, а уровень сигнала RSSI и IP-адрес выводятся на I2C LCD-экран. Встроенный светодиод служит индикатором состояния. Это менеджер подключения уровня реальных устройств.

Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)
В этом проекте ESP32 превращается в асинхронный веб-сервер, которым можно управлять с телефона или компьютера в той же сети Wi-Fi. Благодаря библиотеке ESPAsyncWebServer сервер может обрабатывать несколько запросов одновременно (в отличие от классического WebServer.h, который блокируется на одном запросе). Открыв IP-адрес ESP32 в браузере, ты нажимаешь кнопки ON/OFF (маршруты /on и /off) и включаешь и выключаешь светодиод на GPIO 5.

mDNS на ESP32: доступ к устройству через bluegrays-esp.local (с экраном LCD)
В этом проекте к ESP32 добавляется служба mDNS (Multicast DNS), и к устройству можно обращаться по понятному имени вроде bluegrays-esp.local вместо IP-адреса. Даже если IP, выданный DHCP, меняется, устройство всегда доступно по одному имени. На устройстве также работает маленький веб-сервер, через который по адресу http://bluegrays-esp.local/ из браузера отправляются команды светодиоду. I2C LCD показывает имя хоста, IP-адрес и состояние светодиода.

Счётчик на WebSocket с ESP32 (2 кнопки + LCD + веб в реальном времени)
В этом проекте две кнопки, подключённые к ESP32 (GPIO 5 увеличивает, GPIO 4 уменьшает), меняют счётчик. Значение сразу обновляется и на I2C LCD 16x2, и — через поддержку WebSocket в ESPAsyncWebServer — во всех подключённых браузерах без перезагрузки страницы. Вместо опроса по HTTP используется одно постоянное соединение, и ESP32 отправляет новое значение всем через ws.textAll().

Обновление ESP32 по воздуху (OTA): беспроводная установка прошивки (с экраном LCD)
В этом проекте ты узнаешь, как загружать новую прошивку в ESP32 по Wi-Fi без USB-кабеля. С библиотекой ArduinoOTA ESP32 становится видна в сети и автоматически появляется как bluegrays-ota на вкладке «Сетевой порт» в Arduino IDE. Первая загрузка выполняется по USB, а все следующие обновления — без проводов: это важно для устройств в эксплуатации. I2C LCD показывает состояние Wi-Fi, IP-адрес, имя хоста, процент загрузки OTA и сообщения об ошибках.

Точное время из интернета через NTP на ESP32
ESP32 подключается к Wi-Fi и получает точное время с точностью до миллисекунд от серверов NTP (Network Time Protocol). Благодаря функции configTzTime() автоматически применяется часовой пояс Турции (TRT, UTC+3), а в странах с летним временем переходы обрабатываются автоматически по строке POSIX TZ. Время выводится в монитор порта и на необязательный I2C LCD. configTzTime() запускает службу SNTP, которая периодически пересинхронизирует часы.

ESP32 HTTPClient + API погоды (с экраном LCD)
В этом проекте ESP32 через HTTPClient.h делает вызов REST API к сервису погоды (wttr.in) через интернет. Полученный ответ в JSON разбирается с помощью ArduinoJson v7, а город, температура, влажность, погода и ветер выводятся на I2C LCD на турецком и английском. wttr.in бесплатен и не требует ключа API — достаточно указать любое название города, чтобы получить текущую погоду. Данные автоматически обновляются каждые 30 минут.

Сигнализация движения на ESP32 (PIR + зуммер + светодиод + Telegram)
Умная охранная сигнализация, которая при обнаружении движения PIR-датчиком включает зуммер и светодиод и одновременно сразу отправляет владельцу уведомление в Telegram. В ней есть 30-секундная пауза, ограничивающая частоту повторных тревог; этот механизм не проверяет срабатывания PIR и не устраняет ложные тревоги. Подходит для дома, гаража, склада или мастерской. С ESP32-CAM можно добавить уведомления с фото, а с обычной ESP32 DevKit V1 приходят текстовые.
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

