Rehberler · 9 dk okuma

ESP32 WiFiManager: Şifreyi Koda Yazmadan Telefondan Wi-Fi Ayarı

ESP32 WiFiManager ile Wi-Fi şifresini telefondan gir: captive portal, MQTT gibi özel parametreler, sıfırlama butonu, softAP ve AP+STA ile web kontrol örnekleri.

ESP32 WiFiManager, Wi-Fi adını ve şifresini koda yazmadan ESP32'yi telefondan ağa bağlamanı sağlayan bir kütüphanedir. Kart kayıtlı bir ağa bağlanamazsa kendi Wi-Fi ağını açar; telefonunla bu ağa bağlandığında karşına bir ayar sayfası çıkar, ağını listeden seçer, şifreni yazarsın ve ESP32 bu bilgileri kalıcı belleğine kaydedip ağa bağlanır. Böylece aynı kodu evde, okulda ya da bir arkadaşının evinde yeniden yüklemeden kullanabilirsin. Akıllı prizlerin ve ticari IoT cihazlarının ilk kurulumda telefondan ayarlanması da tam olarak bu yöntemle çalışır.

Bu rehberde önce ESP32'nin Wi-Fi modlarını, yani istasyon (STA), erişim noktası (AP) ve ikisinin birlikte çalıştığı AP+STA modunu öğreneceksin. Ardından WiFiManager kütüphanesini kuracak, şifresiz ilk kodu yazacak, ayarları silen ya da portalı yeniden açan bir buton ekleyecek ve MQTT sunucusu, port ve cihaz adı gibi özel parametreleri aynı sayfadan alıp kalıcı olarak saklayacağız. Son bölümlerde ESP32'nin hiçbir modeme ihtiyaç duymadan kendi ağını kurduğu softAP ile telefondan LED kontrolü yapacak, AP+STA modunu deneyecek ve Raspberry Pi Pico W için MicroPython ile bir erişim noktası kuracağız.

ESP32 geliştirme kartı
ESP32 DevKit kartı: Wi-Fi hem istasyon hem erişim noktası olarak aynı anda çalışabilir.

ESP32 WiFiManager nedir, nasıl çalışır?

Normal bir ESP32 kodunda ağ adı ve şifre WiFi.begin("EvAgi", "sifre") satırına sabit yazılır. Modemi değiştirdiğinde, şifreyi yenilediğinde ya da cihazı başka bir eve götürdüğünde kodu açıp yeniden yüklemen gerekir. WiFiManager bu işi bir web sayfasına taşır. Açılışta önce ESP32'nin kalıcı belleğinde (NVS) kayıtlı bir ağ olup olmadığına bakar ve varsa ona bağlanmayı dener. Bağlantı kurulursa hiçbir şey göstermeden kodun devam eder. Kayıtlı ağ yoksa ya da bağlantı başarısız olursa ESP32 kendi erişim noktasını açar, bir DNS sunucusu başlatır ve 192.168.4.1 adresinde bir ayar sayfası yayınlar. DNS sunucusu, telefonun sorduğu her alan adına bu adresi döndürdüğü için telefon ağa bağlanır bağlanmaz "ağa giriş yap" penceresini kendiliğinden açar. Otellerdeki ve kafelerdeki giriş sayfalarıyla aynı mantıktır; bu yapıya captive portal denir. Sayfada ağını seçip şifreni kaydettiğinde ESP32 yeni ağa bağlanır, erişim noktasını kapatır ve bilgileri bir sonraki açılış için saklar. Bütün bunlar ESP32'nin desteklediği şu Wi-Fi modlarının üzerine kuruludur:

ModNe yapar?Ne zaman kullanılır?
WIFI_STA (istasyon)Bir modeme istemci olarak bağlanır, modemden IP alırİnternete çıkan ve ev ağındaki her cihazdan erişilen projeler
WIFI_AP (erişim noktası)Kendi ağını yayınlar, bağlanan cihazlara 192.168.4.x adresi dağıtırModem olmayan yerler, kurulum sayfası, sahada telefondan kontrol
WIFI_AP_STAİkisini aynı anda yapar, iki ayrı IP adresi olurWiFiManager portalı, servis ağı açıkken ev ağına bağlı kalmak
WIFI_OFFRadyoyu tamamen kapatırPil tasarrufu, Wi-Fi gerekmeyen anlar

WiFiManager kütüphanesini kurmak

  1. Arduino IDE'de ESP32 kart paketinin kurulu olduğundan emin ol. Kurulu değilse ESP32 Nedir? yazısındaki adımları izle.
  2. Araçlar > Kütüphaneleri Yönet menüsünü aç ve arama kutusuna WiFiManager yaz.
  3. Listede yazarı tzapu olan WiFiManager kütüphanesini bul ve en güncel sürümünü (2.0.17 ya da üstü) kur.
  4. Araçlar > Kart menüsünden kartını seç (çoğu DevKit için ESP32 Dev Module) ve portu ayarla.
  5. Kütüphane ek bir paket istemez: WebServer, DNSServer ve Preferences zaten ESP32 çekirdeğiyle birlikte gelir.
Kütüphane yöneticisinde adı WiFiManager'a benzeyen birçok kütüphane vardır. Bu yazıdaki kodlar tzapu'nun kütüphanesine göre yazıldı; ESPAsyncWiFiManager ya da başka bir WiFiManager kurarsan fonksiyon adları tutmaz ve kod derlenmez. ESP32 çekirdeğinin 3.x sürümünü kullanıyorsan kütüphanenin de en güncel sürümünü kur; eski sürümler yeni çekirdekte derleme hatası verebilir.

İlk örnek: koda şifre yazmadan Wi-Fi'ye bağlanmak

Aşağıdaki kod WiFiManager'ın en sade kullanımıdır. Kodda hiçbir ağ adı ya da şifre yok. Kart kayıtlı ağa 20 saniyede bağlanamazsa BlueGrays-Kurulum adında bir ağ açar. Portalın şifresi kurulum123 olarak ayarlandı; şifresiz bir portal da açabilirsin, ama o zaman yakındaki herkes cihazına ağ bilgisi girebilir. Portal 180 saniye boyunca kullanılmazsa kart yeniden başlar ve kayıtlı ağı tekrar dener. Bu ayrıntı önemlidir: elektrik kesintisinden sonra modem ESP32'den daha geç açılırsa kart portalda takılı kalmaz, birkaç dakika içinde ağına kendisi döner.

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ükledikten sonra Seri Monitör'ü 115200 baud hızında aç. Kart ilk kez çalıştığı için kayıtlı bir ağı yoktur ve WiFiManager'ın *wm: ile başlayan satırlarında erişim noktasının açıldığını görürsün. Şimdi telefonu al ve şu adımları izle:

  1. Telefonun Wi-Fi listesinde BlueGrays-Kurulum ağını bul ve kurulum123 şifresiyle bağlan.
  2. Birkaç saniye içinde giriş sayfası kendiliğinden açılır. Açılmazsa tarayıcıya 192.168.4.1 yaz.
  3. Configure WiFi düğmesine dokun. ESP32'nin çevrede gördüğü ağlar sinyal gücüyle birlikte listelenir.
  4. Ağını seç, şifresini yaz ve Save düğmesine bas.
  5. ESP32 yeni ağa bağlanır, erişim noktasını kapatır ve Seri Monitör'e aldığı IP adresini yazar. Telefon da kendi ağına geri döner.
  6. Kartı resetle: bu sefer portal açılmaz, ESP32 kayıtlı ağa birkaç saniyede kendisi bağlanır.

Portal sayfasındaki Info bölümü kartın MAC adresini, çip bilgisini ve bellek durumunu gösterir; Exit portalı kaydetmeden kapatır. WiFiManager'ın bu yazıda kullanacağın temel fonksiyonları şunlardır:

FonksiyonNe yapar?
autoConnect(ad, şifre)Kayıtlı ağa bağlanmayı dener; olmazsa portalı açar. Bağlanınca true döner
startConfigPortal(ad, şifre)Kayıtlı ağa bakmadan portalı hemen açar
setConfigPortalTimeout(sn)Portal bu kadar saniye kullanılmazsa kapanır ve false döner
setConnectTimeout(sn)Kayıtlı ağa bağlanma denemesinin süresi
resetSettings()Kayıtlı Wi-Fi adını ve şifresini siler
addParameter(¶metre)Portal sayfasına özel bir giriş kutusu ekler
setSaveParamsCallback(fonksiyon)Özel parametreler kaydedildiğinde senin fonksiyonunu çağırır
setConfigPortalBlocking(false) ve process()Portal açıkken loop()'un çalışmaya devam etmesini sağlar
setHostname("ad")Kartın ağdaki adını belirler, modemin cihaz listesinde bu adla görünür
Telefon portal ağına bağlandığında "Bu ağın internet erişimi yok" uyarısı verebilir ve bir süre sonra mobil veriye ya da başka bir Wi-Fi ağına geçmeye çalışabilir. Uyarı çıkarsa bağlı kal seçeneğini işaretle; sayfa açılmıyorsa mobil veriyi geçici olarak kapat. iPhone'da giriş penceresi kapanırsa Wi-Fi ayarlarında BlueGrays-Kurulum ağının yanındaki bilgi simgesine dokunup sayfayı yeniden açabilirsin.

Ayarları sıfırlama butonu ve isteğe bağlı portal

Cihazı kutuya kapattıktan sonra Wi-Fi bilgilerini değiştirmen gerekebilir. Kod yeniden yüklemeden bunu yapmanın en kolay yolu bir butondur. Aşağıdaki örnekte ESP32 DevKit kartlarındaki BOOT butonunu kullanıyoruz; bu buton GPIO 0'a bağlıdır ve kart üzerinde pull-up direnci olduğu için basılınca LOW okunur. Butona kısa basarsan kayıtlı ağ silinmeden portal açılır; yeni bir ağ girebilir ya da yalnızca özel ayarları değiştirebilirsin. 3 saniye basılı tutarsan kayıtlı ağ tamamen silinir ve kart yeniden başlar. Ayrı bir buton kullanmak istersen GPIO 4 gibi serbest bir pine bir buton bağla; ayrıntılar Buton nasıl bağlanır? yazısında. GPIO 2'deki dahili LED de bağlantı durumunu gösterir.

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 bir strapping pinidir: kart enerjilenirken ya da resetlenirken bu pin LOW olursa ESP32 kodunu çalıştırmaz, kod yükleme moduna girer. Bu yüzden BOOT butonuna kart açıldıktan sonra bas. Butonu GPIO 0'a değil başka bir pine bağlayacaksan GPIO 0, 2, 5, 12 ve 15 gibi strapping pinlerinden kaçın; güvenli pinleri Pinout aracında görebilirsin.

Özel parametreler: MQTT sunucusu, port ve cihaz adı

WiFiManager'ın en kullanışlı özelliklerinden biri, portal sayfasına kendi giriş kutularını ekleyebilmendir. Bir sensör kartını MQTT ile Home Assistant'a bağlıyorsan sunucu adresini, port numarasını ve cihaz adını da kodun içine gömmek istemezsin. Bunun için WiFiManagerParameter nesneleri oluşturup addParameter() ile portala eklersin. Dikkat etmen gereken tek nokta şudur: WiFiManager Wi-Fi adını ve şifresini kendisi saklar ama özel parametreleri saklamaz. Kullanıcının yazdığı değerleri kaydetmek senin işindir. Bunun için ESP32 çekirdeğiyle gelen Preferences kütüphanesini kullanacağız; Preferences verileri flaş bellekteki NVS bölümüne anahtar-değer çiftleri olarak yazar ve elektrik kesilse de silinmez. Arduino'daki karşılığını merak ediyorsan Arduino EEPROM yazısına bakabilirsin.

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 sayfasını açtığında ağ listesinin altında üç yeni kutu görürsün. Kutular, NVS'te kayıtlı değerlerle dolu gelir; kayıt yoksa koddaki varsayılanlar görünür. Kaydet'e bastığında WiFiManager önce senin parametreleriKaydet() fonksiyonunu çağırır, sonra Wi-Fi'ye bağlanır. Parametreleri ve fonksiyonları şöyle özetleyebiliriz:

ÖğeGöreviNot
WiFiManagerParameter(id, etiket, varsayılan, uzunluk)Portala bir giriş kutusu eklerid benzersiz olmalı, boşluk ve Türkçe karakter içermemeli
getValue()Kullanıcının yazdığı metni döndürürHer zaman metindir; sayı için atoi() ya da atof() kullan
setValue(değer, uzunluk)Kutunun içini doldururKayıtlı değeri formda göstermek için
setSaveParamsCallback()Kaydet anında fonksiyonunu çağırırNVS'e yazma işini burada yap
setParamsPage(true)Parametreleri ayrı bir Setup sayfasına taşırWi-Fi'yi değiştirmeden yalnız ayar güncellemek için

Uzunluk değerine dikkat et: dizinin boyutu ve parametrenin uzunluğu aynı olmalıdır, aksi hâlde uzun bir giriş belleği taşırabilir ya da kesilir. Bu yüzden kodda değerleri strlcpy() ile kopyalıyoruz; bu fonksiyon hedef dizinin boyutunu asla aşmaz. Port numarası gibi sayısal değerleri kullanmadan önce mantıklı bir aralıkta olup olmadığını kontrol etmek de iyi bir alışkanlıktır.

ESP32'nin kendi ağı: softAP ile telefondan web kontrol

WiFiManager'ın portalı aslında ESP32'nin erişim noktası özelliğinin hazır bir kullanımıdır. Bu özelliği kendin de kullanabilirsin. WiFi.softAP() çağrıldığında ESP32 bir modem gibi davranır: kendi ağını yayınlar, bağlanan telefona 192.168.4.2 gibi bir adres verir ve kendisi 192.168.4.1 adresinde durur. Modem olmayan bir bahçede, okul fuarında ya da bir robot yarışmasında telefondan kontrol için idealdir. Fonksiyonun parametreleri ağ adı, şifre, kanal, gizli ağ seçeneği ve en fazla bağlantı sayısıdır. Şifre en az 8 karakter olmalıdır; daha kısa bir şifre verirsen softAP() false döner ve ağ hiç açılmaz. Varsayılan en fazla bağlantı sayısı 4'tür, ESP32'de 10'a kadar çıkarılabilir. Aşağıdaki kod GPIO 2'deki LED'i telefondan açıp kapatan bir web sayfası sunar:

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ükle, telefonunla BlueGrays-LED ağına bağlan ve tarayıcıda 192.168.4.1 adresini aç. Düğmelere bastıkça LED yanıp söner ve sayfa bağlı cihaz sayısını gösterir. Burada captive portal yok; adresi elle yazman gerekir. Sayfa açılmıyorsa telefonun internet olmadığı için mobil veriye geçmiş olabileceğini unutma. Sayfayı yenilemeden anlık güncellenen bir kontrol paneli istersen ESP32 web sunucu ve WebSocket yazısındaki yöntemi aynı softAP ağının üzerinde kullanabilirsin.

AP+STA birlikte: ev ağına bağlıyken kendi ağını da yayınlamak

WIFI_AP_STA modunda ESP32 hem modeme bağlanır hem de kendi ağını yayınlar. Bu durumda kartın iki ayrı IP adresi olur: WiFi.localIP() ev ağındaki adresi, WiFi.softAPIP() ise kendi ağındaki 192.168.4.1 adresini verir. WiFiManager portalı da bu modda çalışır; böylece ağları tararken bir yandan telefona sayfa sunabilir. Kendi projelerinde AP+STA'yı, modem kapalıyken bile telefonla bağlanabileceğin bir servis ağı bırakmak ya da ESP-NOW ile Wi-Fi'yi aynı anda kullanmak için tercih edebilirsin. Aşağıdaki kod iki arayüzden de aynı sayfayı sunar:

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 modunun bilmen gereken önemli bir sınırı var: ESP32'de tek bir radyo bulunur ve iki ağ aynı kanalda çalışmak zorundadır. softAP() ile kanal 1'de açtığın ağ, ESP32 kanal 11'deki modemine bağlandığı anda kanal 11'e taşınır. Bu sırada servis ağına bağlı telefonun bağlantısı birkaç saniye kopabilir. Radyo iki ağ arasında paylaşıldığı için veri hızı da düşer ve kart biraz daha fazla akım çeker. Kurulum bittikten sonra servis ağına artık ihtiyacın yoksa WiFi.softAPdisconnect(true) ile erişim noktasını kapatıp kartı yeniden yalnız istasyon moduna alabilirsin.

Raspberry Pi Pico W ve MicroPython ile erişim noktası

Raspberry Pi Pico W'da Arduino'daki WiFiManager'ın birebir karşılığı yoktur, ama erişim noktası kurmak MicroPython ile birkaç satırdır. network.WLAN(network.AP_IF) erişim noktası arayüzünü verir; ağ adını ve şifreyi config() ile ayarlayıp active(True) ile açarsın. Pico W da bağlanan cihazlara 192.168.4.x adresleri dağıtır ve kendisi 192.168.4.1'de durur. Aşağıdaki kod Pico W'nun kart üzerindeki LED'ini telefondan yakıp söndüren küçük bir web sunucusudur:

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 ile Pico W'ya main.py adıyla kaydedersen kart her açılışta ağını kendiliğinden kurar. Telefonla BlueGrays-Pico ağına bağlanıp 192.168.4.1 adresini açman yeterlidir. Pico W'da captive portal istiyorsan Pimoroni'nin phew kütüphanesi erişim noktası ve tüm alan adlarını yakalayan bir DNS sunucusu sunar; mantık WiFiManager'la aynıdır. Pico W'yu ev ağına bağlayıp istasyon modunda web sunucusu kurmak için Pico W Wi-Fi web sunucu yazısına, MicroPython'a yeniysen MicroPython temelleri rehberine göz at.

WiFiManager ile proje fikirleri

  • Hediye edilebilir sıcaklık göstergesi: Ölçtüğü değeri web sayfasında gösteren bir sensör kartını, alan kişi kendi Wi-Fi'sine telefondan bağlasın.
  • Akıllı ev sensörü: MQTT sunucusunu portaldan alan bir kartı Home Assistant'a bağla; sunucu adresi değiştiğinde kodu yeniden yükleme.
  • Telefona bildirim gönderen alarm: Bot anahtarını özel parametre olarak alan bir ESP32 Telegram botu yap.
  • Kutudaki cihaza kablosuz güncelleme: WiFiManager ile ağa bağlanan karta yeni kodu OTA güncelleme ile gönder.
  • İnternet saati: Saat dilimini portaldan seçtiren bir NTP saati kur.
  • Modemsiz saha kontrolü: softAP ile bahçedeki sulama pompasını telefondan aç ve kapat; birden fazla kart arasında haberleşme için ESP-NOW kullan.

Sık hatalar ve çözümleri

BelirtiOlası sebepÇözüm
Portal ağı telefonda görünmüyorKart kayıtlı ağa bağlandığı için portal açılmadıSeri Monitör'e bak; test için resetSettings() satırını bir kez çalıştır ya da butonla portalı aç
Ağa bağlanıyorum ama sayfa açılmıyorTelefon internet olmadığı için mobil veriye geçtiMobil veriyi kapat, tarayıcıya 192.168.4.1 yaz
Portal açılmıyor, Seri Monitör'de şifre uyarısıPortal şifresi 8 karakterden kısaEn az 8 karakterli bir şifre kullan ya da şifre parametresini hiç verme
Kodda wm.process() ya da setParamsPage tanınmıyorYanlış ya da çok eski bir WiFiManager kütüphanesitzapu WiFiManager'ın güncel sürümünü kur, benzer adlı kütüphaneleri kaldır
Kaydet'ten sonra kart yine portalı açıyorŞifre yanlış girildi ya da ağ 5 GHzŞifreyi kontrol et, 2,4 GHz ağı seç; ayrıntılar için Wi-Fi bağlanmıyor rehberine bak
Özel parametreler yeniden başlayınca kayboluyorDeğerler NVS'e yazılmadısetSaveParamsCallback içinde Preferences ile kaydet, açılışta oku ve setValue() ile forma yaz
Kart sürekli yükleme moduna giriyorButon GPIO 0'a bağlı ve açılışta basılıButona kart açıldıktan sonra bas ya da strapping olmayan bir pin kullan
AP+STA modunda telefonun bağlantısı kopuyorErişim noktası modemin kanalına taşındıNormaldir; birkaç saniye sonra yeniden bağlan ya da işin bitince softAPdisconnect(true) kullan
Bağlanma sorunlarında önce Seri Monitör'deki *wm: satırlarını oku; WiFiManager hangi ağı denediğini, bağlantı sonucunu ve portalın neden kapandığını açıkça yazar. Kart portalı kapattıktan sonra hâlâ ağa bağlanamıyorsa sorun büyük ihtimalle modem ya da güç kaynağıdır; durum ve sebep kodlarını okumayı ESP32 WiFi bağlanmıyor yazısında adım adım anlatıyoruz.

WiFiManager, ESP32 projelerini masadaki bir deneyden başkalarının da kullanabileceği bir cihaza dönüştüren en kolay adımdır: şifre koddan çıkar, ayarlar telefondan girilir ve tek bir butonla her şey sıfırlanır. softAP ve AP+STA modlarını da öğrendiğine göre artık modem olan ve olmayan her ortamda telefondan kontrol edilen projeler yapabilirsin. BlueGrays uygulamasında ESP32 ile Wi-Fi bağlantısı, async web sunucu, mDNS, WebSocket, OTA güncelleme ve Telegram alarmı gibi projeleri adım adım devre şemaları ve hazır kodlarıyla inceleyebilirsin.

Sıkça sorulan sorular

ESP32 WiFiManager ne işe yarar?

WiFiManager, Wi-Fi adını ve şifresini koda yazmadan ESP32'yi telefondan ağa bağlamanı sağlar. Kart kayıtlı ağa bağlanamazsa kendi erişim noktasını açar ve 192.168.4.1 adresinde bir ayar sayfası sunar. Burada seçtiğin ağ ve şifre kalıcı belleğe kaydedilir ve bir sonraki açılışta kendiliğinden kullanılır.

WiFiManager kaydedilen Wi-Fi şifresini nerede saklar?

ESP32'de Wi-Fi adı ve şifresi, flaş bellekteki NVS bölümünde Wi-Fi sürücüsünün kendi ayarları olarak saklanır. Kod yeniden yüklense bile bu bilgiler silinmez. Silmek için resetSettings() fonksiyonunu çağırabilir ya da flaş belleği tamamen silebilirsin.

WiFiManager ayarları nasıl sıfırlanır?

Kodda wm.resetSettings() çağırıp kartı yeniden başlatman yeterlidir. Pratikte bunu bir butona bağlamak en iyisidir: örneğin BOOT butonuna 3 saniye basılı tutulduğunda ayarları silen bir kontrol ekleyebilirsin. Kayıtlı ağı silmeden yalnızca portalı açmak istiyorsan startConfigPortal() kullan.

ESP32 captive portal sayfası neden açılmıyor?

En sık sebep, telefonun portal ağında internet olmadığını görüp mobil veriye geçmesidir; mobil veriyi kapatıp tarayıcıya 192.168.4.1 yaz. Kart kayıtlı ağa zaten bağlanmışsa portal hiç açılmaz. Portal şifresinin en az 8 karakter olduğundan da emin ol.

ESP32 aynı anda hem erişim noktası hem istasyon olabilir mi?

Evet, WIFI_AP_STA modunda ESP32 modeme bağlıyken kendi ağını da yayınlar ve iki ayrı IP adresi kullanır. Ancak tek radyo olduğu için iki ağ aynı kanalda çalışmak zorundadır; kart modeme bağlandığında erişim noktası da modemin kanalına geçer.

ESP32 softAP'ye en fazla kaç cihaz bağlanabilir?

Arduino çekirdeğinde softAP() varsayılan olarak en fazla 4 cihaza izin verir. Bu sayı softAP() fonksiyonunun beşinci parametresiyle ESP32'de 10'a kadar çıkarılabilir. Bağlı cihaz sayısını WiFi.softAPgetStationNum() ile okuyabilirsin.

Tüm projeleri gör
ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)
ES-25İleri

ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)

Bu projede ESP32'yi Station (STA) modunda evdeki Wi-Fi ağına güvenli ve hata toleranslı şekilde bağlıyoruz. SSID/şifreyi secrets.h dosyasına ayırarak Git'e sızmasını önlüyor, otomatik yeniden bağlanma mekanizması kuruyor, RSSI sinyal seviyesini ve IP adresini I2C LCD ekranda gösteriyoruz. Dahili LED durum göstergesi olarak çalışır. Üretim seviyesi bir bağlantı yöneticisidir.

4.4(21)
38
ESP32 Async Web Server (LCD'de IP Göstergeli)
ES-27İleri

ESP32 Async Web Server (LCD'de IP Göstergeli)

Bu projede ESP32'yi aynı Wi-Fi ağındaki telefonunuzdan veya bilgisayarınızdan kontrol edebileceğiniz asenkron bir web sunucusuna dönüştürüyoruz. ESPAsyncWebServer kütüphanesi sayesinde sunucu birden fazla isteği aynı anda işleyebiliyor (klasik WebServer.h gibi tek istekte bloklamıyor). Tarayıcıdan ESP32'nin IP adresine bağlanıp ON/OFF butonlarına basarak (/on ve /off adresleri) GPIO 5'e bağlı LED'i açıp kapatabileceksiniz.

4.8(16)
26
ESP32 mDNS: bluegrays-esp.local ile Cihaza Erişim (LCD Ekranlı)
ES-29İleri
Premium

ESP32 mDNS: bluegrays-esp.local ile Cihaza Erişim (LCD Ekranlı)

Bu projede ESP32'ye mDNS (Multicast DNS) servisi ekleyerek IP adresi yerine bluegrays-esp.local gibi okunabilir bir host adıyla erişim sağlıyoruz. DHCP'nin verdiği IP değişse bile cihaza her zaman aynı isimle ulaşırsın. Kartta çalışan küçük bir web sunucusu sayesinde LED'i tarayıcıdan http://bluegrays-esp.local/ adresiyle kontrol edersin.

4.8(14)
23
ESP32 WebSocket Sayaç (2 Buton + LCD + Web Realtime)
ES-28İleri
Premium

ESP32 WebSocket Sayaç (2 Buton + LCD + Web Realtime)

Bu projede ESP32'ye bağlı iki butonla (GPIO 5 artırır, GPIO 4 azaltır) bir sayaç değiştirilir. Değer hem 16x2 I2C LCD'de hem de ESPAsyncWebServer'ın WebSocket desteğiyle bağlı tüm tarayıcılarda anında güncellenir; sayfayı yenilemek gerekmez. HTTP polling yerine tek bir kalıcı bağlantı kullanılır ve ESP32 yeni değeri ws.textAll() ile herkese gönderir.

4.5(14)
23
ESP32 OTA Update — Kablosuz Firmware Yükleme (LCD Ekranlı)
ES-30İleri
Premium

ESP32 OTA Update — Kablosuz Firmware Yükleme (LCD Ekranlı)

Bu projede ESP32'ye USB kablosu olmadan, Wi-Fi üzerinden yeni firmware yüklemeyi öğreneceksin. ArduinoOTA kütüphanesi ile ESP32 ağda görünür hale gelir ve Arduino IDE'nin "Network port" sekmesinde bluegrays-ota olarak otomatik listelenir. İlk yükleme USB ile yapılır, sonrasında tüm güncellemeler kablosuz olur; sahadaki cihazlar için çok önemli bir özellik.

4.6(14)
22
ESP32 NTP ile İnternetten Gerçek Zaman
ES-26İleri
Premium

ESP32 NTP ile İnternetten Gerçek Zaman

ESP32, Wi-Fi'a bağlanıp NTP (Network Time Protocol) sunucularından milisaniye hassasiyetiyle gerçek zamanı çeker. configTzTime() fonksiyonu sayesinde Türkiye saat dilimi (TRT, UTC+3) otomatik uygulanır; yaz/kış saati uygulayan ülkelerde DST geçişi POSIX TZ dizesiyle otomatik yönetilir. Saat hem Serial Monitor'e hem de isteğe bağlı I2C LCD'ye yazdırılır.

4.5(13)
22
ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)
ES-31İleri
Premium

ESP32 HTTPClient + Hava Durumu API (LCD Ekranlı)

Bu projede ESP32 ile internet üzerinden hava durumu API'sine (wttr.in) HTTPClient.h kullanarak REST API çağrısı yapıyoruz. ArduinoJson v7 ile gelen JSON cevabını çözümleyip şehir, sıcaklık, nem, hava durumu ve rüzgâr bilgilerini I2C LCD ekranda gösteriyoruz. wttr.in API anahtarı istemez; istediğin şehrin adını yazman yeterli.

4.7(13)
20
ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)
ES-41İleri
Premium

ESP32 Hareket Alarm Sistemi (PIR + Buzzer + LED + Telegram)

PIR sensörü hareket algıladığında buzzer'ı ve LED'i çalıştıran, aynı anda Telegram üzerinden sahibine anlık bildirim gönderen akıllı bir güvenlik alarm sistemi. Tekrarlayan alarmların sıklığını sınırlamak için 30 saniyelik bekleme süresi (cooldown) vardır; bu süre PIR sensörünün yanlış algılamalarını ortadan kaldırmaz. Ev, garaj, depo veya çalışma odası gibi alanlarda kullanılabilir.

9