Bələdçilər · 9 dəq oxu

ESP32 WiFiManager: şifrəni koda yazmadan telefondan Wi-Fi ayarı

ESP32 WiFiManager ilə Wi-Fi şifrəsini telefondan daxil et: captive portal, MQTT kimi xüsusi parametrlər, sıfırlama düyməsi, softAP və AP+STA ilə veb idarəetmə nümunələri.

ESP32 WiFiManager, Wi-Fi adını və şifrəsini koda yazmadan ESP32-ni telefondan şəbəkəyə qoşmağa imkan verən kitabxanadır. Plata yadda saxlanmış şəbəkəyə qoşula bilməsə, öz Wi-Fi şəbəkəsini açır; telefonunla bu şəbəkəyə qoşulanda qarşına ayar səhifəsi çıxır, şəbəkəni siyahıdan seçirsən, şifrəni yazırsan və ESP32 bu məlumatları daimi yaddaşında saxlayıb şəbəkəyə qoşulur. Beləliklə, eyni kodu evdə, məktəbdə və ya dostunun evində yenidən yükləmədən istifadə edə bilərsən. Ağıllı rozetkaların və ticari IoT cihazlarının ilk quraşdırmada telefondan ayarlanması da məhz bu üsulla işləyir.

Bu bələdçidə əvvəlcə ESP32-nin Wi-Fi rejimlərini, yəni stansiya (STA), giriş nöqtəsi (AP) və ikisinin birlikdə işlədiyi AP+STA rejimini öyrənəcəksən. Sonra WiFiManager kitabxanasını quraşdıracaq, şifrəsiz ilk kodu yazacaq, ayarları silən və ya portalı yenidən açan düymə əlavə edəcək, MQTT serveri, port və cihaz adı kimi xüsusi parametrləri eyni səhifədən alıb daimi saxlayacağıq. Son bölmələrdə ESP32-nin heç bir modemə ehtiyac duymadan öz şəbəkəsini yaratdığı softAP ilə telefondan LED idarəsi edəcək, AP+STA rejimini sınayacaq və Raspberry Pi Pico W üçün MicroPython ilə giriş nöqtəsi quracağıq.

ESP32 inkişaf platası
ESP32 DevKit platası: Wi-Fi həm stansiya, həm giriş nöqtəsi kimi eyni anda işləyə bilər.

ESP32 WiFiManager nədir, necə işləyir?

Adi ESP32 kodunda şəbəkə adı və şifrə WiFi.begin("HomeNet", "password") sətrinə sabit yazılır. Modemi dəyişəndə, şifrəni yeniləyəndə və ya cihazı başqa evə aparanda kodu açıb yenidən yükləməli olursan. WiFiManager bu işi veb səhifəyə köçürür. Açılışda əvvəlcə ESP32-nin daimi yaddaşında (NVS) yadda saxlanmış şəbəkənin olub-olmadığına baxır və varsa ona qoşulmağa çalışır. Əlaqə qurularsa, heç nə göstərmədən kodun davam edir. Yadda saxlanmış şəbəkə yoxdursa və ya qoşulma uğursuz olarsa, ESP32 öz giriş nöqtəsini açır, DNS serveri işə salır və 192.168.4.1 ünvanında ayar səhifəsi yayımlayır. DNS serveri telefonun soruşduğu hər domen adına bu ünvanı qaytardığı üçün telefon şəbəkəyə qoşulan kimi "şəbəkəyə daxil ol" pəncərəsini özü açır. Otellərdəki və kafelərdəki giriş səhifələri ilə eyni məntiqdir; bu quruluşa captive portal deyilir. Səhifədə şəbəkəni seçib şifrəni yadda saxlayanda ESP32 yeni şəbəkəyə qoşulur, giriş nöqtəsini bağlayır və məlumatları növbəti açılış üçün saxlayır. Bütün bunlar ESP32-nin dəstəklədiyi aşağıdakı Wi-Fi rejimlərinin üzərində qurulub:

RejimNə edir?Nə vaxt istifadə olunur?
WIFI_STA (stansiya)Modemə müştəri kimi qoşulur, modemdən IP alırİnternetə çıxan və ev şəbəkəsindəki hər cihazdan əlçatan olan layihələr
WIFI_AP (giriş nöqtəsi)Öz şəbəkəsini yayımlayır, qoşulan cihazlara 192.168.4.x ünvanı paylayırModemin olmadığı yerlər, quraşdırma səhifəsi, səhrada telefondan idarə
WIFI_AP_STAİkisini eyni anda edir, iki ayrı IP ünvanı olurWiFiManager portalı, xidmət şəbəkəsi açıq ikən ev şəbəkəsində qalmaq
WIFI_OFFRadionu tamamilə söndürürBatareyaya qənaət, Wi-Fi lazım olmayan anlar

WiFiManager kitabxanasını quraşdırmaq

  1. Arduino IDE-də ESP32 plata paketinin quraşdırıldığından əmin ol. Quraşdırılmayıbsa, ESP32 nədir? yazısındakı addımları izlə.
  2. Tools > Manage Libraries menyusunu aç və axtarış qutusuna WiFiManager yaz.
  3. Siyahıda müəllifi tzapu olan WiFiManager kitabxanasını tap və ən yeni versiyasını (2.0.17 və ya daha yuxarı) quraşdır.
  4. Tools > Board menyusundan platanı seç (əksər DevKit-lər üçün ESP32 Dev Module) və portu tənzimlə.
  5. Kitabxana əlavə paket istəmir: WebServer, DNSServer və Preferences artıq ESP32 nüvəsi ilə birlikdə gəlir.
Kitabxana menecerində adı WiFiManager-ə bənzəyən çoxlu kitabxana var. Bu yazıdakı kodlar tzapu-nun kitabxanasına görə yazılıb; ESPAsyncWiFiManager və ya başqa WiFiManager quraşdırsan, funksiya adları uyğun gəlməz və kod kompilyasiya olunmaz. ESP32 nüvəsinin 3.x versiyasından istifadə edirsənsə, kitabxananın da ən yeni versiyasını quraşdır; köhnə versiyalar yeni nüvədə kompilyasiya xətası verə bilər.

İlk nümunə: koda şifrə yazmadan Wi-Fi-a qoşulmaq

Aşağıdakı kod WiFiManager-in ən sadə istifadəsidir. Kodda heç bir şəbəkə adı və ya şifrə yoxdur. Plata yadda saxlanmış şəbəkəyə 20 saniyəyə qoşula bilməsə, BlueGrays-Kurulum adlı şəbəkə açır. Portalın şifrəsi kurulum123 olaraq təyin edilib; şifrəsiz portal da aça bilərsən, amma onda yaxınlıqdakı hər kəs cihazına şəbəkə məlumatı daxil edə bilər. Portal 180 saniyə istifadə olunmasa, plata yenidən başlayır və yadda saxlanmış şəbəkəni təkrar yoxlayır. Bu detal vacibdir: elektrik kəsilməsindən sonra modem ESP32-dən gec açılarsa, plata portalda ilişib qalmır, bir neçə dəqiqə ərzində şəbəkənə özü qayıdır.

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}

Kodu yüklədikdən sonra Serial Monitor-u 115200 baud sürətində aç. Plata ilk dəfə işlədiyi üçün yadda saxlanmış şəbəkəsi yoxdur və WiFiManager-in *wm: ilə başlayan sətirlərində giriş nöqtəsinin açıldığını görürsən. İndi telefonu götür və bu addımları izlə:

  1. Telefonun Wi-Fi siyahısında BlueGrays-Kurulum şəbəkəsini tap və kurulum123 şifrəsi ilə qoşul.
  2. Bir neçə saniyədən sonra giriş səhifəsi özü açılır. Açılmasa, brauzerə 192.168.4.1 yaz.
  3. Configure WiFi düyməsinə toxun. ESP32-nin ətrafda gördüyü şəbəkələr siqnal gücü ilə birlikdə siyahılanır.
  4. Şəbəkəni seç, şifrəsini yaz və Save düyməsinə bas.
  5. ESP32 yeni şəbəkəyə qoşulur, giriş nöqtəsini bağlayır və aldığı IP ünvanını Serial Monitor-a yazır. Telefon da öz şəbəkəsinə geri qayıdır.
  6. Platanı resetlə: bu dəfə portal açılmır, ESP32 yadda saxlanmış şəbəkəyə bir neçə saniyəyə özü qoşulur.

Portal səhifəsindəki Info bölməsi platanın MAC ünvanını, çip məlumatını və yaddaş vəziyyətini göstərir; Exit portalı yadda saxlamadan bağlayır. Bu yazıda istifadə edəcəyin WiFiManager-in əsas funksiyaları bunlardır:

FunksiyaNə edir?
autoConnect(name, password)Yadda saxlanmış şəbəkəyə qoşulmağa çalışır; alınmasa portalı açır. Qoşulanda true qaytarır
startConfigPortal(name, password)Yadda saxlanmış şəbəkəyə baxmadan portalı dərhal açır
setConfigPortalTimeout(s)Portal bu qədər saniyə istifadə olunmasa bağlanır və false qaytarır
setConnectTimeout(s)Yadda saxlanmış şəbəkəyə qoşulma cəhdinin müddəti
resetSettings()Yadda saxlanmış Wi-Fi adını və şifrəsini silir
addParameter(¶meter)Portal səhifəsinə xüsusi daxiletmə qutusu əlavə edir
setSaveParamsCallback(function)Xüsusi parametrlər yadda saxlanılanda sənin funksiyanı çağırır
setConfigPortalBlocking(false) və process()Portal açıq ikən loop()-un işləməyə davam etməsini təmin edir
setHostname("name")Platanın şəbəkədəki adını təyin edir, modemin cihaz siyahısında bu adla görünür
Telefon portal şəbəkəsinə qoşulanda "Bu şəbəkənin internet girişi yoxdur" xəbərdarlığı verə bilər və bir müddətdən sonra mobil internetə və ya başqa Wi-Fi şəbəkəsinə keçməyə çalışa bilər. Xəbərdarlıq çıxsa, qoşulu qal seçimini işarələ; səhifə açılmırsa, mobil interneti müvəqqəti söndür. iPhone-da giriş pəncərəsi bağlanarsa, Wi-Fi ayarlarında BlueGrays-Kurulum şəbəkəsinin yanındakı məlumat işarəsinə toxunub səhifəni yenidən aça bilərsən.

Ayarları sıfırlama düyməsi və tələb üzrə portal

Cihazı qutuya qoyduqdan sonra Wi-Fi məlumatlarını dəyişməli ola bilərsən. Kodu yenidən yükləmədən bunu etməyin ən asan yolu düymədir. Aşağıdakı nümunədə ESP32 DevKit platalarındakı BOOT düyməsindən istifadə edirik; bu düymə GPIO 0-a qoşulub və plata üzərində pull-up rezistoru olduğu üçün basılanda LOW oxunur. Düyməyə qısa bassan, yadda saxlanmış şəbəkə silinmədən portal açılır; yeni şəbəkə daxil edə və ya yalnız xüsusi ayarları dəyişə bilərsən. 3 saniyə basılı saxlasan, yadda saxlanmış şəbəkə tamamilə silinir və plata yenidən başlayır. Ayrıca düymə istifadə etmək istəsən, GPIO 4 kimi boş pinə düymə qoş; təfərrüatlar Düymə necə qoşulur? yazısındadır. GPIO 2-dəki daxili LED də qoşulma vəziyyətini göstərir.

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}
GPIO 0 strapping pinidir: plata qidalananda və ya resetlənəndə bu pin LOW olarsa, ESP32 kodunu işlətmir, kod yükləmə rejiminə keçir. Buna görə BOOT düyməsinə plata açıldıqdan sonra bas. Düyməni GPIO 0-a yox, başqa pinə qoşacaqsansa, GPIO 0, 2, 5, 12 və 15 kimi strapping pinlərdən qaç; təhlükəsiz pinləri Pinout alətində görə bilərsən.

Xüsusi parametrlər: MQTT serveri, port və cihaz adı

WiFiManager-in ən faydalı xüsusiyyətlərindən biri portal səhifəsinə öz daxiletmə qutularını əlavə edə bilməyindir. Sensor platasını MQTT ilə Home Assistant-a qoşursansa, server ünvanını, port nömrəsini və cihaz adını da koda yazmaq istəməzsən. Bunun üçün WiFiManagerParameter obyektləri yaradıb addParameter() ilə portala əlavə edirsən. Diqqət etməli olduğun yeganə məqam budur: WiFiManager Wi-Fi adını və şifrəsini özü saxlayır, amma xüsusi parametrləri saxlamır. İstifadəçinin yazdığı dəyərləri yadda saxlamaq sənin işindir. Bunun üçün ESP32 nüvəsi ilə gələn Preferences kitabxanasından istifadə edəcəyik; Preferences məlumatları flaş yaddaşdakı NVS bölməsinə açar-dəyər cütləri kimi yazır və elektrik kəsilsə də silinmir. Arduino-dakı qarşılığını maraqlandırırsansa, Arduino EEPROM yazısına baxa bilərsən.

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}

Portalda Configure WiFi səhifəsini açanda şəbəkə siyahısının altında üç yeni qutu görürsən. Qutular NVS-də yadda saxlanmış dəyərlərlə dolu gəlir; qeyd yoxdursa, koddakı susmaya görə dəyərlər görünür. Save düyməsinə basanda WiFiManager əvvəlcə sənin parametreleriKaydet() funksiyanı çağırır, sonra Wi-Fi-a qoşulur. Parametrləri və funksiyaları belə ümumiləşdirə bilərik:

ElementVəzifəsiQeyd
WiFiManagerParameter(id, label, default, length)Portala daxiletmə qutusu əlavə edirid unikal olmalıdır, boşluq və Azərbaycan hərfləri (ə, ş, ç…) içərməməlidir
getValue()İstifadəçinin yazdığı mətni qaytarırHəmişə mətndir; ədəd üçün atoi() və ya atof() istifadə et
setValue(value, length)Qutunun içini doldururYadda saxlanmış dəyəri formada göstərmək üçün
setSaveParamsCallback()Yadda saxlama anında sənin funksiyanı çağırırNVS-ə yazma işini burada gör
setParamsPage(true)Parametrləri ayrıca Setup səhifəsinə köçürürWi-Fi-ı dəyişmədən yalnız ayarı yeniləmək üçün

Uzunluq dəyərinə diqqət et: massivin ölçüsü və parametrin uzunluğu eyni olmalıdır, əks halda uzun daxiletmə yaddaşı daşıra bilər və ya kəsilər. Buna görə kodda dəyərləri strlcpy() ilə kopyalayırıq; bu funksiya hədəf massivin ölçüsünü heç vaxt aşmır. Port nömrəsi kimi say dəyərlərini istifadə etməzdən əvvəl məntiqli aralıqda olub-olmadığını yoxlamaq da yaxşı vərdişdir.

ESP32-nin öz şəbəkəsi: softAP ilə telefondan veb idarə

WiFiManager-in portalı əslində ESP32-nin giriş nöqtəsi xüsusiyyətinin hazır istifadəsidir. Bu xüsusiyyətdən özün də istifadə edə bilərsən. WiFi.softAP() çağırılanda ESP32 modem kimi davranır: öz şəbəkəsini yayımlayır, qoşulan telefona 192.168.4.2 kimi ünvan verir və özü 192.168.4.1 ünvanında dayanır. Modemin olmadığı bağda, məktəb sərgisində və ya robot yarışında telefondan idarə üçün idealdır. Funksiyanın parametrləri şəbəkə adı, şifrə, kanal, gizli şəbəkə seçimi və maksimum qoşulma sayıdır. Şifrə ən azı 8 simvol olmalıdır; daha qısa şifrə versən, softAP() false qaytarır və şəbəkə heç açılmır. Susmaya görə maksimum qoşulma sayı 4-dür, ESP32-də 10-a qədər artırıla bilər. Aşağıdakı kod GPIO 2-dəki LED-i telefondan yandırıb söndürən veb səhifə təqdim edir:

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}

Kodu yüklə, telefonunla BlueGrays-LED şəbəkəsinə qoşul və brauzerdə 192.168.4.1 ünvanını aç. Düymələrə basdıqca LED yanır və sönür, səhifə qoşulu cihazların sayını göstərir. Burada captive portal yoxdur; ünvanı əllə yazmalısan. Səhifə açılmırsa, internet olmadığı üçün telefonun mobil internetə keçmiş ola biləcəyini unutma. Səhifəni yeniləmədən anında yenilənən idarə paneli istəsən, ESP32 veb server və WebSocket yazısındakı üsuldan eyni softAP şəbəkəsi üzərində istifadə edə bilərsən.

AP+STA birlikdə: ev şəbəkəsinə qoşuluykən öz şəbəkəni də yayımlamaq

WIFI_AP_STA rejimində ESP32 həm modemə qoşulur, həm də öz şəbəkəsini yayımlayır. Bu halda platanın iki ayrı IP ünvanı olur: WiFi.localIP() ev şəbəkəsindəki ünvanı, WiFi.softAPIP() isə öz şəbəkəsindəki 192.168.4.1 ünvanını verir. WiFiManager portalı da bu rejimdə işləyir; beləliklə şəbəkələri skan edərkən eyni zamanda telefona səhifə təqdim edə bilir. Öz layihələrində AP+STA-nı modem söndürülü olanda belə telefonla qoşula biləcəyin xidmət şəbəkəsi saxlamaq və ya ESP-NOW ilə Wi-Fi-ı eyni anda istifadə etmək üçün seçə bilərsən. Aşağıdakı kod hər iki interfeysdən eyni səhifəni təqdim edir:

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}

AP+STA rejiminin bilməli olduğun vacib məhdudiyyəti var: ESP32-də tək radio var və iki şəbəkə eyni kanalda işləməlidir. softAP() ilə 1-ci kanalda açdığın şəbəkə, ESP32 11-ci kanaldakı modemə qoşulan kimi 11-ci kanala keçir. Bu zaman xidmət şəbəkəsinə qoşulu telefonun əlaqəsi bir neçə saniyə kəsilə bilər. Radio iki şəbəkə arasında bölündüyü üçün məlumat sürəti də düşür və plata bir az daha çox cərəyan çəkir. Quraşdırma bitdikdən sonra xidmət şəbəkəsinə artıq ehtiyacın yoxdursa, WiFi.softAPdisconnect(true) ilə giriş nöqtəsini bağlayıb platanı yenidən yalnız stansiya rejiminə keçirə bilərsən.

Raspberry Pi Pico W və MicroPython ilə giriş nöqtəsi

Raspberry Pi Pico W-də Arduino-dakı WiFiManager-in birəbir qarşılığı yoxdur, amma giriş nöqtəsi qurmaq MicroPython ilə bir neçə sətirdir. network.WLAN(network.AP_IF) giriş nöqtəsi interfeysini verir; şəbəkə adını və şifrəni config() ilə tənzimləyib active(True) ilə açırsan. Pico W də qoşulan cihazlara 192.168.4.x ünvanları paylayır və özü 192.168.4.1-də dayanır. Aşağıdakı kod Pico W-nin plata üzərindəki LED-ini telefondan yandırıb söndürən kiçik veb serverdir:

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

Kodu Thonny ilə Pico W-yə main.py adı ilə yadda saxlasan, plata hər açılışda şəbəkəsini özü qurur. Telefonla BlueGrays-Pico şəbəkəsinə qoşulub 192.168.4.1 ünvanını açmaq kifayətdir. Pico W-də captive portal istəsən, Pimoroni-nin phew kitabxanası giriş nöqtəsi və bütün domen adlarını tutan DNS serveri təqdim edir; məntiq WiFiManager ilə eynidir. Pico W-ni ev şəbəkəsinə qoşub stansiya rejimində veb server qurmaq üçün Pico W Wi-Fi veb server yazısına, MicroPython-a yenisənsə MicroPython əsasları bələdçisinə bax.

WiFiManager ilə layihə ideyaları

  • Hədiyyə edilə bilən temperatur göstəricisi: Ölçdüyü dəyəri veb səhifədə göstərən sensor platasını alan şəxs öz Wi-Fi-ına telefondan qoşsun.
  • Ağıllı ev sensoru: MQTT serverini portaldan alan platanı Home Assistant-a qoş; server ünvanı dəyişəndə kodu yenidən yükləmə.
  • Telefona bildiriş göndərən siqnalizasiya: Bot açarını xüsusi parametr kimi alan ESP32 Telegram botu düzəlt.
  • Qutudakı cihaza simsiz yeniləmə: WiFiManager ilə şəbəkəyə qoşulan plataya yeni kodu OTA yeniləmə ilə göndər.
  • İnternet saatı: Saat qurşağını portaldan seçdirən NTP saatı qur.
  • Modemsiz səhra idarəsi: softAP ilə bağdakı suvarma nasosunu telefondan yandır və söndür; bir neçə plata arasında əlaqə üçün ESP-NOW istifadə et.

Tez-tez rast gəlinən xətalar və həlləri

ƏlamətMümkün səbəbHəll
Portal şəbəkəsi telefonda görünmürPlata yadda saxlanmış şəbəkəyə qoşulduğu üçün portal açılmadıSerial Monitor-a bax; test üçün resetSettings() sətrini bir dəfə işlət və ya düymə ilə portalı aç
Şəbəkəyə qoşuluram, amma səhifə açılmırTelefon internet olmadığı üçün mobil internetə keçdiMobil interneti söndür, brauzerə 192.168.4.1 yaz
Portal açılmır, Serial Monitor-da şifrə xəbərdarlığı varPortal şifrəsi 8 simvoldan qısadırƏn azı 8 simvollu şifrə istifadə et və ya şifrə parametrini heç vermə
Kodda wm.process() və ya setParamsPage tanınmırYanlış və ya çox köhnə WiFiManager kitabxanasıtzapu WiFiManager-in cari versiyasını quraşdır, oxşar adlı kitabxanaları sil
Save-dən sonra plata yenə portalı açırŞifrə səhv daxil edilib və ya şəbəkə 5 GHz-dirŞifrəni yoxla, 2,4 GHz şəbəkəni seç; təfərrüat üçün Wi-Fi qoşulmur bələdçisinə bax
Xüsusi parametrlər yenidən başlayanda itirDəyərlər NVS-ə yazılmayıbsetSaveParamsCallback daxilində Preferences ilə yadda saxla, açılışda oxu və setValue() ilə formaya yaz
Plata daim yükləmə rejiminə keçirDüymə GPIO 0-a qoşulub və açılışda basılıdırDüyməyə plata açıldıqdan sonra bas və ya strapping olmayan pin istifadə et
AP+STA rejimində telefonun əlaqəsi kəsilirGiriş nöqtəsi modemin kanalına keçdiNormaldır; bir neçə saniyədən sonra yenidən qoşul və ya işin bitəndə softAPdisconnect(true) istifadə et
Qoşulma problemlərində əvvəlcə Serial Monitor-dakı *wm: sətirlərini oxu; WiFiManager hansı şəbəkəni sınadığını, qoşulma nəticəsini və portalın niyə bağlandığını açıq yazır. Plata portalı bağladıqdan sonra da şəbəkəyə qoşula bilmirsə, problem çox güman ki, modemdə və ya qida mənbəyindədir; vəziyyət və səbəb kodlarını oxumağı ESP32 WiFi qoşulmur yazısında addım-addım izah edirik.

WiFiManager ESP32 layihələrini masadakı təcrübədən başqalarının da istifadə edə biləcəyi cihaza çevirən ən asan addımdır: şifrə koddan çıxır, ayarlar telefondan daxil edilir və tək düymə ilə hər şey sıfırlanır. softAP və AP+STA rejimlərini də öyrəndiyin üçün artıq modemin olduğu və olmadığı hər mühitdə telefondan idarə olunan layihələr edə bilərsən. BlueGrays tətbiqində ESP32 ilə Wi-Fi qoşulması, async veb server, mDNS, WebSocket, OTA yeniləmə və Telegram siqnalı kimi layihələri addım-addım dövrə sxemləri və hazır kodları ilə araşdıra bilərsən.

Tez-tez verilən suallar

ESP32 WiFiManager nəyə lazımdır?

WiFiManager Wi-Fi adını və şifrəsini koda yazmadan ESP32-ni telefondan şəbəkəyə qoşmağa imkan verir. Plata yadda saxlanmış şəbəkəyə qoşula bilməsə, öz giriş nöqtəsini açır və 192.168.4.1 ünvanında ayar səhifəsi təqdim edir. Burada seçdiyin şəbəkə və şifrə daimi yaddaşa yazılır və növbəti açılışda özü istifadə olunur.

WiFiManager yadda saxlanmış Wi-Fi şifrəsini harada saxlayır?

ESP32-də Wi-Fi adı və şifrəsi flaş yaddaşdakı NVS bölməsində Wi-Fi drayverinin öz ayarları kimi saxlanılır. Kod yenidən yüklənsə belə bu məlumatlar silinmir. Silmək üçün resetSettings() funksiyasını çağıra və ya flaş yaddaşı tamamilə silə bilərsən.

WiFiManager ayarları necə sıfırlanır?

Kodda wm.resetSettings() çağırıb platanı yenidən başlatmaq kifayətdir. Praktikada bunu düyməyə bağlamaq ən yaxşısıdır: məsələn, BOOT düyməsi 3 saniyə basılı saxlananda ayarları silən yoxlama əlavə edə bilərsən. Yadda saxlanmış şəbəkəni silmədən yalnız portalı açmaq istəsən, startConfigPortal() istifadə et.

ESP32 captive portal səhifəsi niyə açılmır?

Ən çox rast gəlinən səbəb telefonun portal şəbəkəsində internet olmadığını görüb mobil internetə keçməsidir; mobil interneti söndürüb brauzerə 192.168.4.1 yaz. Plata yadda saxlanmış şəbəkəyə artıq qoşulubsa, portal ümumiyyətlə açılmır. Portal şifrəsinin ən azı 8 simvol olduğundan da əmin ol.

ESP32 eyni anda həm giriş nöqtəsi, həm stansiya ola bilərmi?

Bəli, WIFI_AP_STA rejimində ESP32 modemə qoşuluykən öz şəbəkəsini də yayımlayır və iki ayrı IP ünvanından istifadə edir. Lakin radio tək olduğu üçün iki şəbəkə eyni kanalda işləməlidir; plata modemə qoşulanda giriş nöqtəsi də modemin kanalına keçir.

ESP32 softAP-a ən çox neçə cihaz qoşula bilər?

Arduino nüvəsində softAP() susmaya görə ən çox 4 cihaza icazə verir. Bu say softAP() funksiyasının beşinci parametri ilə ESP32-də 10-a qədər artırıla bilər. Qoşulu cihazların sayını WiFi.softAPgetStationNum() ilə oxuya bilərsən.

Bütün layihələrə bax
ESP32 Wi-Fi STA qoşulması (LCD ekranlı)
ES-25Qabaqcıl

ESP32 Wi-Fi STA qoşulması (LCD ekranlı)

Bu layihədə ESP32-ni Station (STA) rejimində evdəki Wi-Fi şəbəkəsinə təhlükəsiz və xətaya davamlı şəkildə qoşuruq. SSID/şifrəni secrets.h faylına ayıraraq Git-ə sızmasının qarşısını alır, avtomatik yenidən qoşulma mexanizmi qurur, RSSI siqnal səviyyəsini və IP ünvanını I2C LCD ekranda göstəririk. Daxili LED vəziyyət göstəricisi kimi işləyir. İstehsal səviyyəli qoşulma meneceridir.

4.4(21)
38
ESP32 Async veb server (LCD-də IP göstəricili)
ES-27Qabaqcıl

ESP32 Async veb server (LCD-də IP göstəricili)

Bu layihədə ESP32-ni eyni Wi-Fi şəbəkəsindəki telefonundan və ya kompüterindən idarə edə biləcəyin asinxron veb serverə çeviririk. ESPAsyncWebServer kitabxanası sayəsində server bir neçə sorğunu eyni anda emal edə bilir (klassik WebServer.h kimi tək sorğuda bloklamır). Brauzerdən ESP32-nin IP ünvanına qoşulub ON/OFF düymələrinə basaraq (/on və /off ünvanları) GPIO 5-ə qoşulu LED-i yandırıb söndürə biləcəksən.

4.8(16)
26
ESP32 mDNS: bluegrays-esp.local ilə cihaza giriş (LCD ekranlı)
ES-29Qabaqcıl
Premium

ESP32 mDNS: bluegrays-esp.local ilə cihaza giriş (LCD ekranlı)

Bu layihədə ESP32-yə mDNS (Multicast DNS) xidməti əlavə edərək IP ünvanı əvəzinə bluegrays-esp.local kimi oxunaqlı host adı ilə giriş təmin edirik. DHCP-nin verdiyi IP dəyişsə belə cihaza həmişə eyni adla çatırsan. Platada işləyən kiçik veb serverlə LED-i brauzerdən http://bluegrays-esp.local/ ünvanı ilə idarə edirsən.

4.8(14)
23
ESP32 WebSocket sayğac (2 düymə + LCD + veb real vaxt)
ES-28Qabaqcıl
Premium

ESP32 WebSocket sayğac (2 düymə + LCD + veb real vaxt)

Bu layihədə ESP32-yə qoşulu iki düymə ilə (GPIO 5 artırır, GPIO 4 azaldır) sayğac dəyişdirilir. Dəyər həm 16x2 I2C LCD-də, həm də ESPAsyncWebServer-in WebSocket dəstəyi ilə qoşulu bütün brauzerlərdə dərhal yenilənir; səhifəni yeniləmək lazım deyil. HTTP polling əvəzinə tək daimi əlaqə istifadə olunur və ESP32 yeni dəyəri ws.textAll() ilə hamıya göndərir.

4.5(14)
23
ESP32 OTA Update — simsiz firmware yükləmə (LCD ekranlı)
ES-30Qabaqcıl
Premium

ESP32 OTA Update — simsiz firmware yükləmə (LCD ekranlı)

Bu layihədə ESP32-yə USB naqili olmadan, Wi-Fi üzərindən yeni firmware yükləməyi öyrənəcəksən. ArduinoOTA kitabxanası ilə ESP32 şəbəkədə görünür və Arduino IDE-nin "Network port" bölməsində bluegrays-ota kimi avtomatik siyahıya düşür. İlk yükləmə USB ilə edilir, sonrakı bütün yeniləmələr simsiz olur; sahədəki cihazlar üçün çox vacib xüsusiyyətdir.

4.6(14)
22
ESP32 NTP ilə internetdən real vaxt
ES-26Qabaqcıl
Premium

ESP32 NTP ilə internetdən real vaxt

ESP32 Wi-Fi-a qoşulub NTP (Network Time Protocol) serverlərindən millisaniyə dəqiqliyi ilə real vaxtı çəkir. configTzTime() funksiyası sayəsində Türkiyə saat qurşağı (TRT, UTC+3) avtomatik tətbiq olunur; yay/qış saatı tətbiq edən ölkələrdə DST keçidi POSIX TZ sətri ilə avtomatik idarə olunur. Saat həm Serial Monitor-a, həm də istəyə bağlı I2C LCD-yə yazdırılır.

4.5(13)
22
ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)
ES-31Qabaqcıl
Premium

ESP32 HTTPClient + hava proqnozu API (LCD ekranlı)

Bu layihədə ESP32 ilə internet üzərindən hava proqnozu API-sinə (wttr.in) HTTPClient.h istifadə edərək REST API sorğusu göndəririk. ArduinoJson v7 ilə gələn JSON cavabını emal edib şəhər, temperatur, rütubət, hava vəziyyəti və külək məlumatlarını I2C LCD ekranda göstəririk. wttr.in API açarı tələb etmir; istədiyin şəhərin adını yazmaq kifayətdir.

4.7(13)
20
ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)
ES-41Qabaqcıl
Premium

ESP32 hərəkət siqnalizasiya sistemi (PIR + buzzer + LED + Telegram)

PIR sensoru hərəkət aşkarlayanda buzzer-i və LED-i işə salan, eyni zamanda Telegram vasitəsilə sahibinə ani bildiriş göndərən ağıllı təhlükəsizlik siqnalizasiyası. Təkrarlanan həyəcanların tezliyini məhdudlaşdırmaq üçün 30 saniyəlik gözləmə müddəti (cooldown) var; bu müddət PIR sensorunun yanlış aşkarlamalarını aradan qaldırmır. Ev, qaraj, anbar və ya iş otağı kimi yerlərdə istifadə oluna bilər.

9