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

ESP32 Async Web Server: WebSocket ilə canlı idarəetmə paneli

ESP32 async web server və WebSocket ilə səhifəni yeniləmədən rele idarəsi və canlı sensor paneli: quraşdırma, PROGMEM və LittleFS, esp32.local, parol, tez-tez rast gəlinən xətalar.

ESP32 async web server, yəni ESPAsyncWebServer kitabxanası, ESP32-ni eyni anda bir neçə telefona və kompüterə cavab verə bilən sürətli web serverə çevirir. Kitabxanaya daxil olan WebSocket dəstəyi ilə brauzerlə plata arasında daimi açıq xətt qurulur: səhifədəki düyməyə basanda rele dərhal işə düşür, temperatur dəyişəndə səhifədəki rəqəm özü yenilənir və bunun üçün səhifəni yeniləməyin lazım olmur. Bir telefonda etdiyin dəyişikliyi eyni paneli açmış digər cihazlar da elə həmin saniyədə görür. Qısası, bu ikili öz ağıllı ev panelini bulud xidmətindən istifadə etmədən, ev şəbəkəsinin daxilində qurmağın ən praktik yoludur.

Bu bələdçidə əvvəlcə asinxron serverin klassik WebServer kitabxanasından fərqini və WebSocket-in HTTP sorğularından niyə daha sürətli olduğunu görəcəksən. Sonra düzgün kitabxanaları quraşdırıb ən sadə serveri işə salacaq, daha sonra rele və DHT22 sensoru ilə real vaxt rejimində idarəetmə paneli hazırlayacaqsan. Davamında HTML-i PROGMEM və ya LittleFS daxilində saxlamağı, IP ünvanı əvəzinə esp32.local ünvanından istifadə etməyi, bir neçə klienti idarə etməyi, panelə sadə parol qoymağı və ən çox rast gəlinən kompilyasiya və qoşulma xətalarının həllini tapacaqsan. Kodlar Arduino IDE-dəki ESP32 nüvəsinin 2.x və 3.x versiyaları ilə işləyəcək şəkildə yazılıb.

Web server layihəsi üçün ESP32 inkişaf platası
ESP32 DevKit: Wi-Fi çipi sayəsində tək başına web server işlədir; telefonunda açdığın panel birbaşa bu platanın flaş yaddaşından gəlir.

ESP32 Async Web Server nədir, necə işləyir?

ESP32 nüvəsi ilə birlikdə gələn WebServer.h kitabxanası sinxron işləyir: gələn sorğular yalnız loop() daxilində server.handleClient() çağırılanda, növbə ilə və tək-tək emal olunur. loop() daxilində 2 saniyəlik delay() varsa, səhifə də 2 saniyə gözləyir; iki nəfər eyni anda qoşularsa, biri o birinin bitməsini gözləyir. ESPAsyncWebServer isə AsyncTCP kitabxanasının yaratdığı ayrıca FreeRTOS tapşırığında (async_tcp) işləyir. Sorğu gələndə başlıqlar arxa planda oxunur, sorğu hazır olanda sənin yazdığın funksiya (callback) çağırılır və cavab yenə arxa planda göndərilir. Bu zaman loop() öz işini davam etdirir. Beləliklə, eyni anda bir neçə əlaqə açıq qala bilir; WebSocket və Server-Sent Events (SSE) kimi daimi açıq əlaqələr də mümkün olur. ESP32-nin iki nüvəsini və tapşırıqları maraqlandırırsa, ESP32 FreeRTOS yazısına baxa bilərsən.

XüsusiyyətWebServer.h (sinxron)ESPAsyncWebServer (asinxron)
QuraşdırmaESP32 nüvəsi ilə hazır gəlirLibrary Manager-dən 2 kitabxana
Sorğuların emalıloop() daxilində handleClient() ilə, növbə iləArxa plandakı async_tcp tapşırığında, eyni anda bir neçəsi
loop() daxilində delay()Səhifə cavabını gecikdirirServerə təsir etmir
WebSocketYoxdur; ayrıca kitabxana lazımdır (məs., Markus Sattler-in WebSockets kitabxanası)Daxilidir (AsyncWebSocket)
Server-Sent EventsYoxdurDaxilidir (AsyncEventSource)
Statik faylların verilməsiserveStatic iləserveStatic, avtomatik .gz dəstəyi və keş tənzimləməsi
Diqqət ediləcək məqamÖyrənməsi ən asan olanıCallback daxilində delay() və uzun əməliyyat olmaz

WebSocket nədir? HTTP sorğusundan fərqi nədir?

Adi HTTP sorğusunda brauzer əlaqə açır, "mənə bu səhifəni ver" deyir, cavabı alır və danışıq bitir. Server öz-özünə brauzerə nəsə deyə bilməz; yeni dəyəri görmək üçün brauzer yenidən soruşmalıdır. WebSocket (RFC 6455) isə HTTP ilə başlayan əl sıxmadır: brauzer sorğusuna Upgrade: websocket başlığını əlavə edir, ESP32 101 Switching Protocols cavabı ilə qəbul edir və eyni TCP əlaqəsi açıq qalır. Artıq hər iki tərəf istədiyi an mesaj göndərə bilər (full-duplex). Hər mesajın əlavə yükü yalnız 2 ilə 14 bayt arasındadır; halbuki hər HTTP sorğusu yüzlərlə baytlıq başlıq daşıyır. Buna görə WebSocket mesajları millisaniyələr içində çatır və saniyədə bir neçə yenilənmə göndərən panellər üçün ən səmərəli üsuldur. Səhifəni sensor dəyərləri ilə aktual saxlamağın dörd yolu belə müqayisə olunur:

ÜsulNecə işləyir?Gecikmə və yükNə vaxt istifadə olunur?
Səhifənin yenilənməsi (meta refresh)Brauzer bütün səhifəni bir neçə saniyədən bir yenidən endirirYüksək; səhifə hər dəfə titrəyirSeçmə
fetch ilə sorğulama (polling)JavaScript hər 1–2 saniyədən bir kiçik JSON istəyirOrta; hər sorğu yeni başlıqlar daşıyırNadir dəyişən tək dəyər
Server-Sent Events (SSE)Server açıq əlaqə üzərindən birtərəfli hadisələr göndərirAşağı; yalnız serverdən brauzerəYalnız izləmə aparan panellər
WebSocketAçıq əlaqə üzərindən ikitərəfli mesajlaşmaƏn aşağı; bir neçə baytlıq çərçivələrDüymə, sürüşdürücü və canlı data birlikdə

Lazım olan kitabxanalar: ESPAsyncWebServer və AsyncTCP quraşdırılması

  1. Arduino IDE-də ESP32 plata paketinin (Espressif Systems) quraşdırıldığından əmin ol; quraşdırma addımları ESP32 nədir? yazısındadır.
  2. Library Manager-i aç (Ctrl+Shift+I) və ESPAsyncWebServer axtar. Müəllifi ESP32Async olan ESP Async WebServer kitabxanasını quraşdır.
  3. Bu kitabxana asılılığını Library Manager-ə bildirmir, ona görə IDE əlavə kitabxana təklif etmir: yenə ESP32Async-in yayımladığı Async TCP kitabxanasını ayrıca quraşdır. ESP8266 istifadə edirsənsə, bunun əvəzinə ESP32Async-in ESP Async TCP kitabxanası (ESPAsyncTCP.h) lazımdır.
  4. Panel nümunəsi üçün Adafruit-in DHT sensor library kitabxanasını və onun tələb etdiyi Adafruit Unified Sensor asılılığını quraşdır. Kitabxana quraşdırmağı ilk dəfə edirsənsə, Arduino-ya kitabxana əlavə etmə bələdçisinə bax.
  5. Documents/Arduino/libraries qovluğunda əvvəllər ZIP ilə əlavə edilmiş ESPAsyncWebServer-master, AsyncTCP-master və ya ESPAsyncWebSrv qovluqları varsa, sil. Eyni kitabxananın iki kopyası kompilyatorun yanlış olanı seçməsinə səbəb olur.
İnternetdəki köhnə bələdçilərin çoxu me-no-dev hesabındakı orijinal ESPAsyncWebServer kitabxanasını göstərir. Bu kitabxana artıq yenilənmir və ESP32 nüvəsinin 3.x versiyası ilə kompilyasiya olunmur; proses 'mbedtls_md5_starts_ret' was not declared in this scope xətası ilə dayanır. Həll köhnə kopyanı silib ESP32Async versiyalarını quraşdırmaqdır. Yeni versiyada send_P() də istifadədən çıxarılıb (deprecated): ESP32-də PROGMEM massivini birbaşa request->send(200, "text/html", index_html) ilə göndərə bilərsən.

İlk addım: AsyncWebServer ilə ən sadə server

Panelə keçməzdən əvvəl kitabxananın məntiqini kiçik bir nümunə ilə görək. Aşağıdakı kod ESP32-ni ev şəbəkəsinə qoşur, ana səhifədə salamlama mətni göstərir və /led?durum=1 ilə /led?durum=0 ünvanları vasitəsilə daxili LED-i yandırıb söndürür. Kodu yüklə, Serial Monitor-u 115200 baud sürətində aç və görünən ünvanı eyni Wi-Fi-a qoşulu telefonunun brauzerinə yaz. Plata şəbəkəyə qoşulmursa, ESP32 Wi-Fi qoşulmur bələdçisindəki diaqnostika kodundan istifadə et.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <AsyncTCP.h>
3#include <ESPAsyncWebServer.h>
4
5const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
6const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
7const int LED_PIN = 2;               // çoğu DevKit'te dahili LED / onboard LED on most DevKits
8
9AsyncWebServer server(80);           // 80 = standart HTTP portu / standard HTTP port
10bool ledAcik = false;
11
12void setup() {
13  Serial.begin(115200);
14  pinMode(LED_PIN, OUTPUT);
15
16  WiFi.mode(WIFI_STA);
17  WiFi.begin(ssid, password);
18  while (WiFi.status() != WL_CONNECTED) {
19    delay(500);
20    Serial.print(".");
21  }
22  Serial.println();
23  Serial.print("Adres / address: http://");
24  Serial.println(WiFi.localIP());
25
26  // Ana sayfa / home page
27  server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) {
28    request->send(200, "text/plain", "Merhaba, ben ESP32 / Hello from ESP32");
29  });
30
31  // /led?durum=1 yakar, /led?durum=0 söndürür / turns the LED on or off
32  server.on("/led", HTTP_GET, [](AsyncWebServerRequest *request) {
33    if (request->hasParam("durum")) {
34      ledAcik = request->getParam("durum")->value() == "1";
35      digitalWrite(LED_PIN, ledAcik ? HIGH : LOW);
36    }
37    request->send(200, "text/plain", ledAcik ? "LED: ON" : "LED: OFF");
38  });
39
40  // Tanımsız adresler / unknown addresses
41  server.onNotFound([](AsyncWebServerRequest *request) {
42    request->send(404, "text/plain", "Sayfa yok / Not found");
43  });
44
45  server.begin();
46}
47
48void loop() {
49  // Sunucu arka planda çalışır, loop() boş kalabilir / the server runs in the background
50}
KomandaNəyə yarayır?
AsyncWebServer server(80)80 nömrəli HTTP portunu dinləyən serveri yaradır
server.on("/led", HTTP_GET, ...)Bir ünvan və sorğu növü üçün işləyəcək funksiyanı (callback) qeyd edir
request->hasParam("durum")Ünvanda ?durum=... parametrinin olub-olmadığına baxır
request->getParam("durum")->value()Parametrin dəyərini String kimi verir
request->send(kod, növ, məzmun)Cavabı göndərir: 200 uğurlu, 404 tapılmadı; növ text/plain, text/html və ya application/json
server.onNotFound(...)Təyin olunmamış hər ünvan üçün işləyir
server.begin()Serveri başladır; bütün server.on() sətirlərindən sonra çağırılır
loop() funksiyasının boş qalması xəta deyil; server öz tapşırığında işləyir. Əksinə, callback funksiyalarının içində delay(), uzun while dövrləri və ya internetdən data çəkən sorğular istifadə etmə. async_tcp tapşırığı bu zaman donur və bir neçə saniyə sonra ESP32 Task watchdog got triggered mesajı ilə yenidən başlayır. Uzun işləri bayraq (flag) dəyişəni ilə loop()-a burax, zamanlamanı da millis() ilə et.

İdarəetmə paneli üçün hissələr və qoşulma

Panel nümunəsində rele modulu ilə lampanı və ya ventilyatoru yandırıb söndürəcək, DHT22 ilə temperatur və rütubəti ölçəcəksən. Lazım olanlar: bir ESP32 DevKit, tək kanallı 5 V rele modulu, DHT22 (və ya DHT11) sensor modulu, breadboard və jumper naqillər. Rele seçəndə optocüt (optokuplyor) olan modulları üstün tut. DHT22 −40 ilə 80 °C arasında ±0,5 °C dəqiqliklə ölçür və ən çox 2 saniyədən bir oxuna bilər; DHT11 daha ucuzdur, amma 0–50 °C aralığında ±2 °C dəqiqlik verir. Sensorun təfərrüatları üçün DHT11 temperatur və rütubət sensoru yazısına, platanın pin xəritəsi üçün Pinout alətinə baxa bilərsən.

Modul piniESP32 DevKitESP8266 NodeMCUQeyd
Rele VCCVIN (5 V)VIN və ya VU (5 V)Rele sarğısı 5 V istəyir; USB-dən qidalanır
Rele GNDGNDGNDOrtaq torpaq
Rele INGPIO 26D1 (GPIO 5)Əksər modullar LOW siqnalla işə düşür
DHT22 VCC (+)3V33V33,3 V ilə qidalananda data xətti də 3,3 V olur
DHT22 DATA (OUT)GPIO 4D2 (GPIO 4)Çılpaq sensorda DATA ilə VCC arasına 10 kΩ rezistor
DHT22 GND (−)GNDGNDOrtaq torpaq
ESP32-nin pinləri 3,3 V çıxış verir. Bəzi 5 V rele modulları bu səviyyəni HIGH kimi tanımır və rele heç buraxmır; belə modulda 3,3 V ilə uyğun rele, JD-VCC körpüsü olan modul və ya arada tranzistor istifadə et. Rele ilə 220 V şəbəkə gərginliyini açıb-bağlayacaqsansa, naqilləri enerji kəsik olanda qoş, açıq klemens qoyma və əmin deyilsənsə, əvvəl aşağı gərginlikli yüklə (LED lent, 12 V ventilyator) sına. Təfərrüatlar Rele modulu nədir? yazısındadır.

Real vaxt idarəetmə paneli: rele, DHT22 və WebSocket

İndi əsas layihəyə keçək. Aşağıdakı kod tək fayldır: HTML, CSS və JavaScript PROGMEM massivi kimi kodun içindədir. Səhifə açılanda brauzer /ws ünvanına WebSocket əlaqəsi qurur. ESP32 hər 2 saniyədən bir DHT22-ni oxuyur və temperaturu, rütubəti, rele vəziyyətini və qoşulu cihaz sayını tək JSON mesajı ilə bütün brauzerlərə göndərir. Düyməyə basanda brauzer toggle mesajını göndərir, ESP32 releni çevirir və yeni vəziyyəti yenə hamıya bildirir. Şəbəkə adını və şifrəni dəyişib yüklə, sonra brauzerdə http://esp32.local və ya Serial Monitor-dakı IP ünvanını aç.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <AsyncTCP.h>
3#include <ESPAsyncWebServer.h>
4#include <ESPmDNS.h>
5#include <DHT.h>
6
7const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
8const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
9
10const int ROLE_PIN = 26;             // röle modülü IN / relay module IN
11const bool ROLE_AKTIF_LOW = true;    // çoğu modül LOW ile çeker / most modules switch on LOW
12const int DHT_PIN = 4;               // DHT22 veri pini / DHT22 data pin
13
14DHT dht(DHT_PIN, DHT22);             // DHT11 için DHT11 yaz / write DHT11 for a DHT11
15AsyncWebServer server(80);
16AsyncWebSocket ws("/ws");            // WebSocket adresi / WebSocket path
17
18bool roleAcik = false;
19float sicaklik = NAN;
20float nem = NAN;
21volatile bool gonder = false;        // loop() yayın yapsın mı? / should loop() broadcast?
22unsigned long sonOlcum = 0;
23unsigned long sonTemizlik = 0;
24
25// Tarayıcıya giden sayfa / the page sent to the browser
26const char index_html[] PROGMEM = R"rawliteral(
27<!DOCTYPE html>
28<html lang="tr">
29<head>
30<meta charset="utf-8">
31<meta name="viewport" content="width=device-width, initial-scale=1">
32<title>ESP32 Panel</title>
33<style>
34body{font-family:sans-serif;background:#0f172a;color:#e2e8f0;text-align:center;margin:0;padding:16px}
35.kart{background:#1e293b;border-radius:12px;padding:16px;margin:12px auto;max-width:320px}
36.deger{font-size:2.4em;font-weight:bold}
37button{font-size:1.2em;padding:14px 32px;border:0;border-radius:8px;color:#fff;width:100%}
38.acik{background:#16a34a}.kapali{background:#475569}
39</style>
40</head>
41<body>
42<h2>ESP32 Panel</h2>
43<p id="baglanti">Bağlanıyor / Connecting...</p>
44<div class="kart">Sıcaklık / Temperature<div class="deger"><span id="sicaklik">--</span> &deg;C</div></div>
45<div class="kart">Nem / Humidity<div class="deger"><span id="nem">--</span> %</div></div>
46<div class="kart">Röle / Relay<p><button id="dugme" class="kapali" onclick="degistir()">KAPALI / OFF</button></p></div>
47<p>Bağlı cihaz / Clients: <span id="istemci">0</span></p>
48<script>
49let ws;
50const $ = (id) => document.getElementById(id);
51function baglan() {
52  ws = new WebSocket('ws://' + location.host + '/ws');
53  ws.onopen = () => { $('baglanti').textContent = 'Bağlı / Connected'; };
54  ws.onclose = () => {
55    $('baglanti').textContent = 'Koptu, yeniden deneniyor / Reconnecting...';
56    setTimeout(baglan, 2000);
57  };
58  ws.onmessage = (e) => {
59    const d = JSON.parse(e.data);
60    $('sicaklik').textContent = d.sicaklik === null ? '--' : d.sicaklik.toFixed(1);
61    $('nem').textContent = d.nem === null ? '--' : d.nem.toFixed(0);
62    $('istemci').textContent = d.istemci;
63    $('dugme').textContent = d.role ? 'AÇIK / ON' : 'KAPALI / OFF';
64    $('dugme').className = d.role ? 'acik' : 'kapali';
65  };
66}
67function degistir() {
68  if (ws.readyState === WebSocket.OPEN) ws.send('toggle');
69}
70baglan();
71</script>
72</body>
73</html>
74)rawliteral";
75
76void roleAyarla(bool acik) {
77  roleAcik = acik;
78  digitalWrite(ROLE_PIN, ROLE_AKTIF_LOW ? !acik : acik);
79}
80
81// Durumu JSON metnine çevir / build the state as JSON text
82String durumJson() {
83  String s = "{\"role\":";
84  s += roleAcik ? "true" : "false";
85  s += ",\"sicaklik\":";
86  s += isnan(sicaklik) ? String("null") : String(sicaklik, 1);
87  s += ",\"nem\":";
88  s += isnan(nem) ? String("null") : String(nem, 0);
89  s += ",\"istemci\":";
90  s += (unsigned long)ws.count();
91  s += "}";
92  return s;
93}
94
95// WebSocket olayları (async_tcp görevinde çalışır) / WebSocket events (run in the async_tcp task)
96void wsOlay(AsyncWebSocket *sunucu, AsyncWebSocketClient *client, AwsEventType type,
97            void *arg, uint8_t *data, size_t len) {
98  switch (type) {
99    case WS_EVT_CONNECT:
100      Serial.printf("Istemci #%u baglandi / connected: %s\n",
101                    (unsigned)client->id(), client->remoteIP().toString().c_str());
102      gonder = true;                 // yeni gelen güncel durumu alsın / newcomer gets the state
103      break;
104    case WS_EVT_DISCONNECT:
105      Serial.printf("Istemci #%u ayrildi / disconnected\n", (unsigned)client->id());
106      gonder = true;
107      break;
108    case WS_EVT_DATA: {
109      AwsFrameInfo *info = (AwsFrameInfo *)arg;
110      // Tek parça, tam bir metin mesajı mı? / a complete single-frame text message?
111      if (info->final && info->index == 0 && info->len == len && info->opcode == WS_TEXT) {
112        if (len == 6 && memcmp(data, "toggle", 6) == 0) {
113          roleAyarla(!roleAcik);
114          gonder = true;             // tüm ekranlar eşitlensin / sync every screen
115        }
116      }
117      break;
118    }
119    default:                         // PONG, ERROR vb. / PONG, ERROR etc.
120      break;
121  }
122}
123
124void setup() {
125  Serial.begin(115200);
126  pinMode(ROLE_PIN, OUTPUT);
127  roleAyarla(false);                 // açılışta röle kapalı / relay off at start
128  dht.begin();
129
130  WiFi.mode(WIFI_STA);
131  WiFi.begin(ssid, password);
132  Serial.print("Baglaniyor / connecting");
133  while (WiFi.status() != WL_CONNECTED) {
134    delay(500);
135    Serial.print(".");
136  }
137  WiFi.setSleep(false);              // daha hızlı tepki / lower latency
138  Serial.println();
139  Serial.print("http://");
140  Serial.println(WiFi.localIP());
141
142  if (MDNS.begin("esp32")) {         // http://esp32.local
143    MDNS.addService("http", "tcp", 80);
144    Serial.println("http://esp32.local");
145  }
146
147  ws.onEvent(wsOlay);
148  server.addHandler(&ws);
149
150  server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) {
151    request->send(200, "text/html", index_html);
152  });
153  server.onNotFound([](AsyncWebServerRequest *request) {
154    request->send(404, "text/plain", "Sayfa yok / Not found");
155  });
156  server.begin();
157}
158
159void loop() {
160  if (millis() - sonOlcum >= 2000) {       // DHT22 en fazla 2 sn'de bir / DHT22: once per 2 s
161    sonOlcum = millis();
162    float t = dht.readTemperature();
163    float h = dht.readHumidity();
164    if (!isnan(t) && !isnan(h)) {          // hatalı okumayı atla / skip failed reads
165      sicaklik = t;
166      nem = h;
167    }
168    gonder = true;
169  }
170
171  if (gonder) {
172    gonder = false;
173    ws.textAll(durumJson());               // tüm tarayıcılara yolla / send to every browser
174  }
175
176  if (millis() - sonTemizlik >= 1000) {
177    sonTemizlik = millis();
178    ws.cleanupClients();                   // kopuk istemcileri temizle / drop stale clients
179  }
180}

Kod necə işləyir?

  • AsyncWebSocket ws("/ws") WebSocket son nöqtəsini yaradır, server.addHandler(&ws) isə onu serverə qoşur. JavaScript-dəki ünvan buradakı yolla eyni olmalıdır.
  • wsOlay() funksiyası hər qoşulmada, qopmada və gələn mesajda çağırılır. WS_EVT_CONNECT yeni klient, WS_EVT_DISCONNECT ayrılan klient, WS_EVT_DATA isə gələn mesaj deməkdir.
  • AwsFrameInfo gələn çərçivənin məlumatını daşıyır. final, index == 0 və len yoxlaması mesajın tək parça və tam gəldiyini, WS_TEXT isə mətn olduğunu təsdiqləyir. Qısa komandalar həmişə bir çərçivəyə sığır.
  • Gələn data memcmp() ilə uzunluğu ilə birlikdə müqayisə olunur; beləliklə, datanın sonunda sıfır simvolunun olub-olmamasından asılı qalmırsan.
  • Callback funksiyaları async_tcp tapşırığında işlədiyi üçün yalnız releni çevirir və gonder bayrağını qaldırır. Əsl göndərmə loop() daxilində ws.textAll() ilə aparılır; beləliklə, bütün mesajlar tək yerdən, ardıcıllıqla çıxır.
  • ws.cleanupClients() saniyədə bir çağırılır: qopmuş əlaqələrin yaddaşını qaytarır və klient sayı həddi aşanda ən köhnə əlaqəni bağlayır.
  • JavaScript tərəfində onclose hadisəsi 2 saniyə sonra yenidən qoşulur. ESP32 yenidən başlasa və ya Wi-Fi bir anlığa qopsa belə, səhifə özünü bərpa edir. Ünvan location.host ilə qurulduğu üçün səhifə həm IP ilə, həm də esp32.local ilə işləyir.
  • WiFi.setSleep(false) Wi-Fi enerji qənaətini söndürür. Defolt modem yuxusu cavablara yüzlərlə millisaniyəyə qədər gecikmə əlavə edə bilər; prizdən qidalanan paneldə bunu söndürmək düymələri ani edir.

Mesaj formatı kimi JSON seçmək işini asanlaşdırır: brauzer JSON.parse() ilə gələn mətni tək sətirdə obyektə çevirir. Nümunə mesaj belə görünür: {"role":true,"sicaklik":23.4,"nem":48,"istemci":2}. Sensor oxunmayanda dəyər null göndərilir və səhifə "--" göstərir; oxuma xətası NaN kimi getsəydi, yararsız JSON səbəbindən səhifə ümumiyyətlə yenilənməzdi. Hər mesajla təxminən 60 bayt data getdiyi üçün saniyədə bir neçə yenilənmə belə şəbəkəni yormur. Daha mürəkkəb mesajlar üçün ArduinoJson kitabxanasına keçə bilərsən, amma bu ölçüdə paneldə String birləşdirmək kifayətdən də artıqdır. Rele əvəzinə LED və ya buzzer qoşub eyni kodu heç dəyişmədən sınaya bilərsən.

HTML harada saxlanmalıdır: PROGMEM, yoxsa LittleFS?

Panel kodunda səhifə R"rawliteral( ... )rawliteral" formasında xam mətn massivi kimi dayanır. Bu yazılış dırnaqları və sətir sonlarını qaçış simvolu yazmadan istifadə etməyə imkan verir. AVR əsaslı Arduino-larda PROGMEM mətni RAM əvəzinə flaşda saxlamaq üçün lazımdır; ESP32-də isə sabit massivlər onsuz da flaşdan oxunduğu üçün PROGMEM yalnız uyğunluq üçün yazılır və zərəri yoxdur. Səhifə böyüdükcə kodun içində HTML redaktə etmək çətinləşir; həmin məqamda faylları flaşdakı LittleFS fayl sisteminə köçürmək daha səliqəlidir.

MeyarPROGMEM (kodun içində)LittleFS (fayl sistemi)
QuraşdırmaƏlavə addım yoxdur, tək fayldata qovluğu və yükləmə plaqini lazımdır
RedaktəHTML C++ massivinin içindəAyrı index.html, style.css və app.js faylları
YeniləməHər dəyişiklikdən sonra kodu yenidən yükləyirsənYalnız fayl sistemini yenidən yükləyirsən
ÖlçüBir neçə KB-lıq səhifələr üçün idealdırDefolt bölmələmədə təxminən 1,5 MB yer
Şəkil və şriftPraktik deyilİkon, şəkil və .gz faylları təqdim oluna bilər
Nə vaxt?İlk sınaq və kiçik panellərÇoxsəhifəli və ya böyüyən interfeyslər

LittleFS ilə HTML, CSS və JavaScript fayllarını təqdim etmək

  1. Layihə qovluğunun (.ino faylının olduğu qovluq) içində data adlı qovluq yarat və panel kodunda R"rawliteral( ilə )rawliteral" arasında qalan HTML-i data/index.html faylına yadda saxla. İstəsən, CSS və JavaScript-i ayrı fayllara bölə bilərsən.
  2. Arduino IDE 2 köhnə versiyadakı ESP32 Sketch Data Upload menyusunu dəstəkləmir. Bunun əvəzinə arduino-littlefs-upload plaqininin .vsix faylını endir; Windows-da C:\\Users\\(istifadəçi adın)\\.arduinoIDE\\plugins, macOS və Linux-da ~/.arduinoIDE/plugins qovluğuna qoy (qovluq yoxdursa, yarat) və IDE-ni yenidən başlat. Plaqin üçün IDE 2.2.1 və ya daha yeni versiya lazımdır.
  3. Serial Monitor açıqdırsa, bağla, sonra Ctrl+Shift+P (macOS-da Cmd+Shift+P) ilə komanda panelini aç və Upload LittleFS to Pico/ESP8266/ESP32 komandasını seç. Fayllar flaşdakı fayl sistemi bölməsinə yazılır.
  4. Tools > Partition Scheme menyusunda fayl sistemi bölməsi olan sxem seçili olsun (məsələn, Default 4MB with spiffs). LittleFS adı spiffs olan bu bölmədən istifadə edir.
  5. Aşağıdakı kodu həmişəki kimi yüklə. Tools menyusundakı Erase All Flash seçimi söndürülübsə, kod yükləmək fayl sistemini silmir; faylları dəyişəndə yalnız 3-cü addımı təkrarlaman kifayətdir.
C++ (Arduino IDE)
1#include <WiFi.h>
2#include <AsyncTCP.h>
3#include <ESPAsyncWebServer.h>
4#include <LittleFS.h>
5
6const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
7const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
8
9AsyncWebServer server(80);
10
11void setup() {
12  Serial.begin(115200);
13
14  if (!LittleFS.begin(true)) {       // true: bağlanamazsa biçimlendir / format if mount fails
15    Serial.println("LittleFS hatasi / LittleFS error");
16    return;
17  }
18
19  WiFi.mode(WIFI_STA);
20  WiFi.begin(ssid, password);
21  while (WiFi.status() != WL_CONNECTED) {
22    delay(500);
23  }
24  Serial.println(WiFi.localIP());
25
26  // data/ klasörünün içeriğini sun / serve the contents of the data/ folder
27  server.serveStatic("/", LittleFS, "/")
28        .setDefaultFile("index.html")    // varsayılan index.htm'dir / default is index.htm
29        .setCacheControl("max-age=600"); // tarayıcı 10 dk önbelleğe alsın / cache for 10 min
30
31  server.onNotFound([](AsyncWebServerRequest *request) {
32    request->send(404, "text/plain", "Sayfa yok / Not found");
33  });
34  server.begin();
35}
36
37void loop() {
38}
serveStatic() fayl istənəndə əvvəlcə eyni adlı .gz uzantılı sıxılmış versiyasını axtarır. index.html faylını gzip ilə sıxıb index.html.gz kimi yükləsən, səhifə adətən üçdə bir ilə dörddə bir ölçüsünə düşür və daha sürətli açılır. Qovluq ünvanı istənəndə defolt fayl adı index.htm olduğu üçün setDefaultFile("index.html") sətrini unutma. Kitabxananın şablon (template) xüsusiyyətindən istifadə etsən, səhifədəki %DEGER% kimi yer tutucular dəyişdirilir; bu halda CSS-dəki width:100% kimi faiz işarələrini %% kimi yazmalısan.

mDNS: IP ünvanı əvəzinə esp32.local

Modem ESP32-yə hər açılışda fərqli IP ünvanı verə bilər və 192.168.1.47 kimi rəqəmləri yadda saxlamaq çətindir. mDNS (multicast DNS) cihazın yerli şəbəkədə öz adını elan etməsinə imkan verir. Panel kodundakı MDNS.begin("esp32") sətri sayəsində eyni şəbəkədəki cihazlar səhifəni http://esp32.local ünvanından aça bilir; MDNS.addService("http", "tcp", 80) isə şəbəkə skaner tətbiqlərinə burada web server olduğunu bildirir. Ada ".local" əlavə etmə; yalnız kiçik hərf, rəqəm və tire istifadə et. Bir neçə ESP32 istifadə edirsənsə, hərəsinə fərqli ad ver (mətbəx, qonaq otağı kimi), çünki eyni adı daşıyan iki cihaz bir-birinə mane olur. mDNS bütün sistemlərdə eyni dərəcədə dəstəklənmir:

Sistem.local dəstəyiİşləməsə
iPhone, iPad, macOSDaxilidir (Bonjour)Eyni Wi-Fi şəbəkəsində olduğundan əmin ol
Windows 10 və 11Yeni versiyalarda adətən işləyirBonjour xidmətini quraşdır və ya IP istifadə et
Linuxavahi-daemon quraşdırılıbsa işləyiravahi-daemon və nss-mdns paketlərini quraşdır
AndroidVersiyadan və brauzerdən asılıdırIP ünvanından istifadə et və ya modemdə DHCP rezervasiyası et

Bir neçə klient: telefon, planşet və kompüter eyni anda

WebSocket-in ən sevilən tərəfi paneli açan hər kəsin eyni vəziyyəti görməsidir. Telefonundan releni yandıranda ESP32 yeni vəziyyəti textAll() ilə bütün əlaqələrə göndərir; kompüterdəki sekma da eyni anda yaşıla dönür. Hər sekma ayrı klientdir: eyni brauzerdə üç sekma açsan, sayğac 3 göstərir. Kitabxana ESP32-də defolt olaraq 8, ESP8266-da 4 eyni vaxtlı WebSocket klientinə icazə verir (DEFAULT_MAX_WS_CLIENTS). Bu hədd öz-özünə tətbiq olunmur; cleanupClients() çağırılanda həddi aşan ən köhnə əlaqə bağlanır. Bundan başqa, diqqət etməli olduğun məqamlar bunlardır:

  • Telefon yuxuya gedəndə: Ekranı sönən telefon əlaqəni düzgün bağlamaya bilər. Belə yarımçıq qalmış əlaqələr cleanupClients() və müntəzəm data göndərilməsi sayəsində zamanla təmizlənir.
  • Göndərmə sürəti: Hər klient üçün ən çox 32 mesaj növbədə gözləyə bilər (ESP8266-da 8). Hər loop() dövründə textAll() çağırsan, növbə dolur və yeni mesajlar səssizcə atılır; Tools > Core Debug Level ayarını Warn və ya daha ətraflı səviyyəyə qoysan, Serial Monitor-da Too many messages queued xəbərdarlığını görərsən. Dəyəri yalnız dəyişəndə və ya saniyədə bir neçə dəfə göndər.
  • Təzə qoşulan klient: Qoşulan hər səhifəyə aktual vəziyyəti dərhal göndər; əks halda istifadəçi ilk ölçməyə qədər boş panelə baxır. Panel kodunda bu işi WS_EVT_CONNECT daxilində qaldırılan bayraq görür.
  • Tək klientə cavab: Hamıya yox, yalnız soruşan brauzerə cavab vermək üçün client->text("...") istifadə et; klientin nömrəsini client->id() verir.
  • Yaddaş: Hər açıq əlaqə TCP soketi və bufer yaddaşı saxlayır. ESP32-nin 520 KB RAM-ı bir neçə klient üçün kifayətdən artıqdır, amma ESP.getFreeHeap() ilə boş yaddaşı ara-sıra çap etmək sızmaları erkən tutmağa kömək edir.

Sadə parol qorunması

Ev şəbəkəsindəki hər kəs panelin ünvanını bilsə, releni yandırıb söndürə bilər. Kitabxanadakı request->authenticate() və request->requestAuthentication() funksiyaları ilə səhifəyə istifadəçi adı və parol qoya bilərsən; brauzer öz giriş pəncərəsini açır və məlumatı sessiya boyu yadda saxlayır. Defolt üsul Digest autentifikasiyadır, yəni parol şəbəkədə açıq mətn kimi getmir. Lakin yalnız səhifəni qorumaq kifayət deyil: WebSocket ünvanı ayrıca qapıdır və kimsə birbaşa ws://ip/ws ünvanına qoşula bilər. Aşağıdakı nümunə bu qapını da bağlayır: ESP32 hər açılışda təsadüfi açar yaradır, bu açarı yalnız daxil olmuş brauzerə /anahtar ünvanından verir və setFilter() ilə düzgün açarı gətirməyən WebSocket əlaqələrini rədd edir.

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <AsyncTCP.h>
3#include <ESPAsyncWebServer.h>
4
5const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
6const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
7const char* KULLANICI = "admin";     // panel kullanıcı adı / panel username
8const char* PAROLA = "Gizli-2026";   // panel parolası / panel password
9const int LED_PIN = 2;
10
11AsyncWebServer server(80);
12AsyncWebSocket ws("/ws");
13String wsAnahtar;                    // her açılışta yeni anahtar / a new key on every boot
14bool ledAcik = false;
15
16const char index_html[] PROGMEM = R"rawliteral(
17<!DOCTYPE html>
18<html><head><meta charset="utf-8">
19<meta name="viewport" content="width=device-width, initial-scale=1"></head>
20<body style="font-family:sans-serif;text-align:center">
21<h2>Korumali panel / Protected panel</h2>
22<button style="font-size:1.4em;padding:12px 32px" onclick="ws && ws.send('toggle')">LED</button>
23<p id="durum">...</p>
24<script>
25let ws;
26fetch('/anahtar').then(r => r.text()).then(k => {
27  ws = new WebSocket('ws://' + location.host + '/ws?k=' + k);
28  ws.onmessage = (e) => { document.getElementById('durum').textContent = e.data; };
29});
30</script>
31</body></html>
32)rawliteral";
33
34bool girisVar(AsyncWebServerRequest *request) {
35  return request->authenticate(KULLANICI, PAROLA);
36}
37
38void setup() {
39  Serial.begin(115200);
40  pinMode(LED_PIN, OUTPUT);
41
42  WiFi.mode(WIFI_STA);
43  WiFi.begin(ssid, password);
44  while (WiFi.status() != WL_CONNECTED) {
45    delay(500);
46  }
47  Serial.println(WiFi.localIP());
48
49  // Wi-Fi açıkken random() donanım üretecini kullanır / random() uses the hardware RNG
50  wsAnahtar = String(random(0x7FFFFFFF), HEX) + String(random(0x7FFFFFFF), HEX);
51
52  // Sayfa: tarayıcı kullanıcı adı ve parola sorar / page: the browser asks for login
53  server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) {
54    if (!girisVar(request)) return request->requestAuthentication();
55    request->send(200, "text/html", index_html);
56  });
57
58  // Anahtar yalnız giriş yapana verilir / the key is given only after login
59  server.on("/anahtar", HTTP_GET, [](AsyncWebServerRequest *request) {
60    if (!girisVar(request)) return request->requestAuthentication();
61    request->send(200, "text/plain", wsAnahtar);
62  });
63
64  // Doğru anahtarı getirmeyen bağlantıyı reddet / reject sockets without the right key
65  ws.setFilter([](AsyncWebServerRequest *request) {
66    return request->hasParam("k") && request->getParam("k")->value() == wsAnahtar;
67  });
68
69  ws.onEvent([](AsyncWebSocket *sunucu, AsyncWebSocketClient *client, AwsEventType type,
70                void *arg, uint8_t *data, size_t len) {
71    if (type == WS_EVT_DATA && len == 6 && memcmp(data, "toggle", 6) == 0) {
72      ledAcik = !ledAcik;
73      digitalWrite(LED_PIN, ledAcik ? HIGH : LOW);
74      sunucu->textAll(ledAcik ? "LED: ON" : "LED: OFF");
75    }
76  });
77
78  server.addHandler(&ws);
79  server.begin();
80}
81
82void loop() {
83  ws.cleanupClients();               // saniyede bir yeterli / once per second is enough
84  delay(1000);
85}
Bu qoruma ev şəbəkəsi üçün kifayət qədər yaxşı kilidir, amma şifrələmə deyil: ESPAsyncWebServer ESP32-də HTTPS təqdim etmir və WebSocket mesajları açıq mətn kimi gedir. Parol kodun içində dayandığı üçün kodu paylaşanda silməyi unutma. Modemdə port yönləndirməsi edib paneli internetə açma; kənardan idarə üçün ESP32 Telegram bot, MQTT və Home Assistant və ya modemdəki VPN xüsusiyyəti çox daha təhlükəsizdir. Yeni kitabxana versiyalarında eyni işi AsyncAuthenticationMiddleware sinfi ilə də görə bilərsən.

ESP8266 və Raspberry Pi Pico W üçün qeydlər

Eyni kitabxana ESP8266 (NodeMCU, Wemos D1 mini) üzərində də işləyir. Dəyişdirməli olduğun şeylər bunlardır: Async TCP əvəzinə ESP32Async-in ESP Async TCP kitabxanasını quraşdır; WiFi.h əvəzinə ESP8266WiFi.h, AsyncTCP.h əvəzinə ESPAsyncTCP.h, ESPmDNS.h əvəzinə ESP8266mDNS.h əlavə et və loop() daxilinə MDNS.update() sətrini qoy. WiFi.setSleep(false) sətrini WiFi.setSleepMode(WIFI_NONE_SLEEP) ilə əvəz et, pinləri də qoşulma cədvəlindəki NodeMCU sütununa görə tənzimlə. ESP8266-nın istifadə oluna bilən RAM-ı təxminən 80 KB olduğu üçün səhifəni kiçik saxla və klient həddinin 4 olduğunu unutma. Raspberry Pi Pico W istifadə edirsənsə, MicroPython ilə web server qurmağı Raspberry Pi Pico W Wi-Fi bələdçisində tapa bilərsən; ESPAsyncWebServer-in yeni versiyaları Arduino tərəfində RP2040 və RP2350 çiplərini də dəstəkləyir.

ESP32 web serveri ilə layihə ideyaları

  • Çoxkanallı ağıllı priz: 4 kanallı rele platası ilə lampa, ventilyator və priz üçün ayrı düymələr düzəlt; komandaları "r1", "r2" kimi qısa mətnlərlə ayır. Rele seçimi üçün rele modulu yazısına bax.
  • Bitki suvarma paneli: Torpaq rütubət sensorunun dəyərini canlı göstər, suvarma həddini səhifədəki sürüşdürücü ilə tənzimlə və istəsən, nasosu əllə də işlət.
  • Hava stansiyası: DHT22 əvəzinə BME280 istifadə edib təzyiqi də əlavə et; son 60 ölçməni səhifədə kiçik xətt qrafiki ilə göstər.
  • Rəng seçici lampa: Səhifədəki rəng seçicinin dəyərini WebSocket ilə göndər və WS2812B NeoPixel lentini dərhal boya.
  • Sürüşdürücü ilə servo: Sürüşdürücünün dəyərini hər hərəkətdə göndərib servo mühərrikini fırlat; kamera yönləndirmə və ya qapı mandalı üçün idealdır.
  • Vaxt damğalı qeyd: Ölçmələrin yanına NTP ilə alınan saatı əlavə et və kodu hər dəfə USB ilə yox, OTA ilə simsiz yenilə.

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

ƏlamətSəbəbHəll
'mbedtls_md5_starts_ret' was not declared in this scopeKöhnə me-no-dev kitabxanası və ESP32 nüvəsi 3.xESP32Async-in ESP Async WebServer və Async TCP versiyalarını quraşdır, köhnə qovluqları sil
Multiple libraries were found for "AsyncTCP.h"Eyni kitabxananın iki kopyası varlibraries qovluğundakı köhnə -master kopyalarını sil
send_P üçün deprecated xəbərdarlığıYeni versiyada send_P götürülürrequest->send(200, "text/html", index_html) istifadə et
Səhifə ümumiyyətlə açılmırTelefon qonaq şəbəkəsində və ya mobil datadadır, IP ünvanı dəyişibEyni Wi-Fi-a qoşul, Serial Monitor-dakı aktual IP-dən istifadə et
Səhifə açılır, amma dəyərlər -- olaraq qalırWebSocket qoşula bilmədi: yol fərqlidir və ya addHandler unudulubF12 konsolunu aç, ws("/ws") ilə JavaScript-dəki ünvanı eyniləşdir
Task watchdog got triggered və async_tcpCallback daxilində delay(), uzun dövr və ya HTTP sorğusuCallback-i qısa saxla, işi bayraqla loop()-a köçür
Too many messages queuedtextAll() çox tez-tez çağırılırYalnız dəyişəndə və ya saniyədə bir neçə dəfə göndər
LittleFS-dəki səhifə 404 verirdata qovluğu yüklənməyib və ya setDefaultFile çatışmırFaylları plaqinlə yüklə, setDefaultFile("index.html") əlavə et
Serial Monitor-da does not exist, no permits for creationİstənən fayl LittleFS-də yoxdurFayl adını və böyük-kiçik hərfləri yoxla; .gz keçən sətirlər zərərsizdir
Rele heç bağlanmır5 V modul 3,3 V HIGH siqnalını tanımır3,3 V ilə uyğun modul, JD-VCC və ya tranzistor istifadə et
Rele işə düşəndə ESP32 yenidən başlayırSarğı cərəyanı qidanı çökdürür (brownout)Etibarlı 5 V adapter və 470 µF kondensator istifadə et
esp32.local açılmırCihazın mDNS dəstəyi yoxdur və ya ad .local ilə yazılıbMDNS.begin("esp32") yaz, lazım gələrsə IP ünvanından istifadə et
Düymə gec reaksiya verirWi-Fi modem yuxusu açıqdırQoşulmadan sonra WiFi.setSleep(false) çağır
Nəsə işləməyəndə brauzerdə F12 ilə developer alətlərini aç. Console sekması WebSocket connection to 'ws://192.168.1.50/ws' failed kimi xətaları göstərir; Network sekmasında WebSocket əlaqəsinə klikləsən, Messages bölməsində gələn-gedən hər mesajı görürsən. ESP32 tərəfində qoşulan və ayrılan klientləri Serial Monitor-a yazdırmaq problemin brauzerdə, yoxsa platada olduğunu bir neçə saniyəyə ayırır. Rele işə düşən anda plata yenidən başlayırsa, ESP32 brownout bələdçisinə bax.

ESP32 async web server və WebSocket ikilisi bulud xidmətinə və ya telefon tətbiqi yazmağa ehtiyac qalmadan işləyən, sürətli və bir neçə cihazla paylaşıla bilən idarəetmə paneli qurmağın ən qısa yoludur. Əvvəlcə tək fayllıq PROGMEM paneli ilə başla, interfeys böyüdükcə LittleFS-ə keç, şəbəkənə yeni cihaz əlavə etdikcə hərəsinə öz mDNS adını ver. ESP32 ilə təzə tanışsansa, əsasları ESP32 nədir? yazısında tapa bilərsən. BlueGrays tətbiqində də async web server, WebSocket sayğacı, mDNS ilə giriş, NTP saatı və OTA yeniləməsi kimi ESP32 layihələrini dövrə sxemləri və hazır kodları ilə addım-addım öyrənə bilərsən.

Tez-tez verilən suallar

ESP32-də AsyncWebServer ilə WebServer arasında fərq nədir?

WebServer kitabxanası sorğuları loop() daxilindəki handleClient() çağırışı ilə növbə ilə emal edir; loop() yavaşlayarsa, səhifə də yavaşlayır. ESPAsyncWebServer isə sorğuları arxa plandakı ayrıca tapşırıqda emal edir, eyni anda bir neçə əlaqəni daşıyır və WebSocket ilə SSE dəstəyini hazır gətirir. Real vaxt panelləri üçün asinxron versiya daha uyğundur.

ESP32 web serverinə eyni anda neçə cihaz qoşula bilər?

ESPAsyncWebServer ESP32-də defolt olaraq 8 WebSocket klientinə icazə verir və cleanupClients() çağırılanda artığını bağlayır; ESP8266-da bu hədd 4-dür. Adi səhifə sorğuları qısa çəkdiyi üçün daha çox cihaz növbə ilə səhifə aça bilər. Praktikada ev panelində 3–5 eyni vaxtlı cihaz problemsiz işləyir.

ESP32 web serverinə internetdən daxil ola bilərəmmi?

Modemdə port yönləndirməsi etməklə texniki olaraq mümkündür, amma tövsiyə olunmur: kitabxana ESP32-də HTTPS təqdim etmir və cihaz internetdən gələn hücumlara açıq qalır. Kənardan idarə üçün Telegram bot, MQTT əsaslı sistem və ya modemdəki VPN xüsusiyyəti çox daha təhlükəsizdir.

esp32.local ünvanı niyə açılmır?

Ən çox rast gəlinən səbəb telefonun və ya kompüterin mDNS adlarını həll edə bilməməsidir; bu hal xüsusilə bəzi Android telefonlarda və köhnə Windows versiyalarında görünür. Kodda MDNS.begin("esp32.local") yazmaq da xətadır, adı .local olmadan verməlisən. Ad yenə həll olunmursa, Serial Monitor-dakı IP ünvanından istifadə et və ya modemdən ESP32-yə sabit IP ayır.

ESP32 web serveri modemsiz işləyirmi?

Bəli. WiFi.softAP("ESP32-Panel", "12345678") ilə ESP32 öz Wi-Fi şəbəkəsini qurur; telefonunu bu şəbəkəyə qoşub brauzerdə 192.168.4.1 ünvanını açırsan. Bu giriş nöqtəsi rejimində internet olmur, amma panel və WebSocket eynilə işləyir. Şəbəkə şifrəsi ən azı 8 simvol olmalıdır.

ESPAsyncWebServer üçün hansı kitabxananı quraşdırmalıyam?

Arduino Library Manager-də müəllifi ESP32Async olan ESP Async WebServer və Async TCP kitabxanalarını quraşdır. me-no-dev hesabındakı orijinal versiya artıq yenilənmir və ESP32 nüvəsi 3.x ilə kompilyasiya olunmur. ZIP ilə əlavə edilmiş köhnə kopyaları da libraries qovluğundan sil.

Bütün layihələrə bax
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 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 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 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 DHT22 temperatur və rütubət (LCD ekranlı)
ES-15Orta

ESP32 DHT22 temperatur və rütubət (LCD ekranlı)

DHT22 sensoru ilə mühitin temperaturunu və rütubət nisbətini ölçüb 16x2 I2C LCD ekranda real vaxtda göstərən layihədir. Adafruit DHT kitabxanasından istifadə edilərək tək naqilli (one-wire) protokolla sensordan məlumat oxunur. Bu layihə IoT hava stansiyası, ağıllı ev avtomatlaşdırması və ya istixanalarda mühit izləmə sistemlərinin əsasını təşkil edir. DHT22 ilə əlaqə ESP32-nin GPIO 4 pini üzərindən təmin olunur.

4.8(38)
57
ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)
ES-37Qabaqcıl
Premium

ESP32 ağıllı işıqlandırma (PIR + LDR + Rele + OLED)

ESP32, PIR hərəkət sensoru, LDR işıq sensoru və rele modulu ilə evinin dəhlizini, tualetini və ya kilerini ağıllı işıqlandırmaya çeviririk. Mühit işıqlıdırsa, hərəkət olsa belə işıq yanmır; beləliklə gündüz boş yerə enerji sərf olunmur. İşıq 30 saniyə açıq qalır; hərəkət davam edərsə, müddət avtomatik uzanır.

4.3(6)
11
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