ESP32 Wi-Fi’ye Bağlanmıyor: Katmanlı Teşhis Rehberi

ESP32 Wi-Fi bağlantı sorunu yaşandığında en doğru yaklaşım, modem ayarlarını rastgele değiştirmek değil; problemi kod, ağ, IP/DHCP ve güç katmanlarında sırayla elemekdir. Önce kartın gerçekten çalıştığını ve bağlantı kodunun ilerlediğini gözlemleyin; ardından doğru ağa erişip erişemediğini, IP alıp almadığını ve yeniden başlama davranışının beslemeyle ilişkili olup olmadığını kontrol edin.

Bu sıra, “ESP32 internete bağlanmıyor” belirtisini tek bir nedene indirgemeyi önler. Örneğin yanlış parola kod hatası gibi görünebilir, zayıf besleme ise bağlantı kurulurken kartın yeniden başlamasına yol açabilir. Başlangıç seviyesinde ilerliyorsanız önce algoritma ve kodlama bilgi testi ile temel kontrol akışınızı gözden geçirmeniz, teşhis adımlarını daha düzenli uygulamanıza yardımcı olabilir.

Teşhise nereden başlanmalı?

Teşhiste her adımın amacı, bir sonraki katmana geçmeden önce mevcut katmanda yeterli kanıt toplamaktır. Aşağıdaki karar ağacında “evet” cevabı bir sonraki kontrole, “hayır” cevabı ise aynı katmandaki düzeltmeye götürür.

1. Seri çıktı var mı?

   Seri Monitör’de açılış mesajı, bağlantı denemesi veya nokta gibi ilerleme çıktıları görünüyorsa kod çalışıyor olabilir ve kod katmanında bağlantı akışını incelemeye geçebilirsiniz. Hiç çıktı yoksa önce USB kablosu, doğru seri port, kart seçimi, yüklenen program ve seri haberleşme hızını kontrol edin. Seri çıktı alınmadan ağ ayarlarını değiştirmek anlamlı bir teşhis sağlamaz.

2. Bağlantı durumu değişiyor mu?

   Kod, bağlantıyı beklerken belirli aralıklarla durum kontrolü veya ilerleme işareti yazdırmalıdır. Çıktı sürekli aynı noktada kalıyorsa WiFi.begin() çağrısı, SSID ve parola değişkenleri, bağlantı bekleme döngüsü ve timeout süresi incelenmelidir. Durum ilerliyor fakat süre aşımı oluşuyorsa ağ katmanına geçin.

3. ESP32 bir IP adresi aldı mı?

   Bağlantının başarılı görünmesi, kartın yerel ağda kullanılabilir bir IP aldığı anlamına her zaman gelmez. Başarılı bağlantı sonrasında WiFi.localIP() çıktısını okuyun. IP adresi yazdırılıyorsa kablosuz bağlantı ve DHCP aşaması büyük ölçüde tamamlanmıştır; bundan sonra ağ geçidi, DNS, internet erişimi veya uygulamanın bağlandığı sunucu incelenebilir. IP alınamıyorsa DHCP veya modem yapılandırması ayrı bir katman olarak ele alınmalıdır.

4. Farklı bir ağda sonuç değişiyor mu?

   Aynı kodu güvenilir bir telefon erişim noktasıyla deneyin. ESP32 erişim noktasına bağlanıyorsa sorun büyük olasılıkla ilk modem üzerindeki SSID, parola, bant, gizli ağ, istemci izolasyonu veya erişim kısıtlamalarından biridir. Her iki ağda da aynı noktada başarısız oluyorsa kod, kart modeliyle uyum ve güç katmanı daha güçlü aday hâline gelir.

5. Yeniden başlama veya kopma güçle ilişkili olabilir mi?

   Bağlantı kurulurken kart yeniden başlıyor, seri çıktı baştan başlıyor veya Wi-Fi etkinleştiğinde sistem kararsızlaşıyorsa yalnızca parola ya da sinyal gücüne odaklanmayın. USB kablosu, bilgisayar portu, harici besleme düzeni ve bağlantı sırasında oluşan güç dalgalanmaları incelenmelidir. Kod ve ağ kontrolleri tutarlı olduğu hâlde fiziksel yeniden başlama görülüyorsa güç katmanına geçin.

Bu karar ağacını uygularken her denemede yalnızca bir değişkeni değiştirin. Aynı anda modem bandını, parolayı, kabloyu ve kodu değiştirmek hangi değişikliğin sonucu etkilediğini belirsizleştirir.

Kod katmanı: WiFi.begin, timeout ve seri monitör

Arduino-ESP32 Wi-Fi API’sinde temel bağlantı akışı WiFi.begin(ssid, password) ile başlatılır. Bağlantı durumu WiFi.status() üzerinden WL_CONNECTED ile karşılaştırılabilir; bağlantı başarılı olduğunda yerel IP adresi WiFi.localIP() ile yazdırılabilir. Bu kullanım biçimi Espressif’in güncel Arduino-ESP32 Wi-Fi belgelerinde örneklenmektedir. ([docs.espressif.com](https://docs.espressif.com/projects/arduino-esp32/en/latest/api/wifi.html?utm_source=openai))

Aşağıdaki örnek, sonsuz bekleme yerine 15 saniyelik timeout kullanır. Böylece seri monitörde programın tamamen kilitlenip kilitlenmediğiyle bağlantının başarısız olması birbirinden ayrılır.

#include <WiFi.h>

const char* ssid = "SSID_BURAYA";
const char* password = "PAROLA_BURAYA";

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  Serial.print("Wi-Fi baglantisi bekleniyor");
  unsigned long baslangic = millis();
  while (WiFi.status() != WL_CONNECTED && millis() - baslangic < 15000) {
    delay(500);
    Serial.print(".");
  }
  if (WiFi.status() == WL_CONNECTED) {
    Serial.println(" Baglandi");
    Serial.println(WiFi.localIP());
  } else {
    Serial.println(" Timeout: baglanti kurulamadi");
  }
}

void loop() {}

Başarılı bağlantıda beklenen seri monitör çıktısı

Wi-Fi baglantisi bekleniyor....
Baglandi
192.168.1.42

Timeout oluştuğunda beklenen çıktı

Wi-Fi baglantisi bekleniyor..............................
Timeout: baglanti kurulamadi

IP adresi örnekte sabit değildir; modeminizin DHCP yapılandırmasına göre farklı bir yerel adres yazdırılır. Noktaların sayısı da bağlantının ne kadar sürede sonuçlandığına bağlıdır. Timeout çıktısı, kartın kesin olarak arızalı olduğunu göstermez; yanlış SSID, parola, erişim kısıtlaması, uyumsuz bant veya DHCP problemi gibi farklı nedenler olabilir.

Bağlantı kodunu öğrenirken yalnızca komutları ezberlemek yerine bekleme koşulunu, süre ölçümünü ve başarısızlık yolunu birlikte anlamak önemlidir. Bu yaklaşım, asenkron video yazılım eğitimleri içinde karşılaşılan benzer hata ayıklama örneklerine de uygulanabilir.

Ağ katmanı: SSID, parola, Wi-Fi bandı ve sinyal

Kod katmanı geçildiğinde ilk kontrol, ESP32’nin gerçekten hedeflediğiniz ağa erişmeye çalışıp çalışmadığıdır. SSID büyük-küçük harfe duyarlı bir ağ adıdır; modem listesindeki ad ile kodda yazan değer arasında tek karakterlik fark bile bağlantıyı engelleyebilir. Parolayı elle yeniden yazın ve başında veya sonunda boşluk, satır sonu ya da kopyalama sırasında eklenmiş görünmeyen karakter bulunmadığından emin olun.

• Benzer isimli ağlar arasında yanlış SSID seçilmediğini kontrol edin.
• Gizli ağ kullanılıyorsa ağ adının tam olarak bilinmesi gerekir.
• Modemde MAC filtreleme, istemci izolasyonu veya yeni cihaz kısıtlaması bulunup bulunmadığına bakın.
• Kurumsal ya da kimlik doğrulamalı ağları, basit SSID-parola bağlantısıyla karıştırmayın.
• ESP32’yi modeme yaklaştırarak aynı kodu yeniden çalıştırın.

Telefon erişim noktasıyla yapılan karşılaştırma özellikle yararlıdır. Kart telefon erişim noktasına bağlanıyor fakat ev veya iş modemine bağlanmıyorsa sorun çoğunlukla modem yayın ayarı, parola, erişim politikası veya bant seçimindedir. Her iki ağda da bağlantı kurulamıyorsa kod ve donanım kontrollerine geri dönmek gerekir.

Wi-Fi bandı konusunda kart modelini varsaymayın. Espressif’in klasik ESP32 serisi veri sayfası 2,4 GHz çalışma aralığını belirtirken, ESP32-C5 veri sayfası 2,4 GHz ve 5 GHz çift bant desteğini ayrı şekilde tanımlar. Bu nedenle “ESP32 her zaman yalnızca 2,4 GHz kullanır” veya tüm kartların 5 GHz’e bağlanabileceği gibi genellemeler yerine, kullandığınız çip ya da geliştirme kartının resmî veri sayfasını kontrol edin. ([documentation.espressif.com](https://documentation.espressif.com/esp32_datasheet_en.html?utm_source=openai))

Modem hem 2,4 GHz hem 5 GHz ağlarını tek isim altında birleştiriyorsa, teşhis amacıyla bantları geçici olarak ayrı SSID’lerle yayınlamak hangi bandın kullanıldığını görmeyi kolaylaştırabilir. Sinyali değerlendirirken tek bir RSSI eşik değerine bakarak kesin karar vermeyin; kartın uzaklığı, duvarlar, parazit ve anten yerleşimi birlikte değerlendirilmelidir.

IP ve DHCP katmanı: Bağlandı görünürken neden iletişim kurulamaz?

ESP32’nin kablosuz erişim noktasına bağlanması, ağ üzerinde kullanılabilir bir IP adresi aldığı anlamına gelmez. İlk aşamada kart modemle Wi-Fi bağlantısı kurar; ikinci aşamada ise modem veya ağdaki DHCP hizmeti ESP32’ye IP adresi, ağ geçidi ve DNS bilgileri sağlar. Bu nedenle seri monitörde “erişim noktasına bağlandı” benzeri bir durum görülse bile yerel IP adresi alınmamışsa ESP32 yerel ağdaki başka cihazlarla veya internet üzerindeki bir sunucuyla iletişim kuramayabilir.

Güncel Arduino-ESP32 API’sinde bağlantı durumunu WiFi.status() ile, kartın yerel IP adresini ise WiFi.localIP() ile inceleyebilirsiniz. Daha ayrıntılı olay takibinde ARDUINO_EVENT_WIFI_STA_CONNECTED, ARDUINO_EVENT_WIFI_STA_GOT_IP ve ARDUINO_EVENT_WIFI_STA_LOST_IP olayları kullanılabilir. Buradaki önemli ayrım şudur: STA_CONNECTED erişim noktasına bağlantıyı, STA_GOT_IP ise IP yapılandırmasının tamamlandığını gösterir. Ayrıntılar için Espressif Arduino-ESP32 Wi-Fi API dokümantasyonuna bakılabilir.

#include <WiFi.h>

const char* ssid = "AG_ADI";
const char* password = "AG_PAROLASI";

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);

  unsigned long baslangic = millis();
  while (WiFi.status() != WL_CONNECTED && millis() - baslangic < 15000) {
    delay(500);
    Serial.print(".");
  }

  Serial.println();
  Serial.print("Durum: ");
  Serial.println(WiFi.status() == WL_CONNECTED ? "Wi-Fi bagli" : "Baglanti yok");
  Serial.print("Yerel IP: ");
  Serial.println(WiFi.localIP());
}

void loop() {}

Bağlantı başarılı olduğunda beklenen çıktının son bölümünde benzer bir yapı görülür:

Durum: Wi-Fi bagli
Yerel IP: 192.168.1.42

IP adresi beklenmedik biçimde 0.0.0.0 olarak kalıyorsa teşhisi aşağıdaki sırayla ilerletin:

1. Aynı ağı başka cihazla test edin. Telefon veya bilgisayar aynı SSID’ye bağlanabiliyor ve internete erişebiliyorsa modemle genel iletişim büyük ölçüde çalışıyor demektir. Başka cihazlar da IP alamıyorsa sorun yalnızca ESP32’ye özgü olmayabilir.
2. ESP32’yi farklı bir erişim noktasında deneyin. Telefonun kişisel erişim noktası veya farklı bir modem, sorunun kart kodunda mı yoksa ilk ağın yapılandırmasında mı olduğunu ayırmaya yardımcı olur. Farklı ağda IP alıyorsa ilk modem üzerinde DHCP, istemci kabulü veya erişim politikası incelenmelidir.
3. Modem ayarlarını kontrollü biçimde inceleyin. DHCP hizmetinin etkin olup olmadığı, adres havuzunda boş kayıt bulunup bulunmadığı ve aynı anda izin verilen istemci sayısına ulaşılmadığı kontrol edilmelidir. Misafir ağları, istemci izolasyonu, MAC tabanlı erişim politikaları veya yerel cihazların birbirini görmesini engelleyen ayarlar da ESP32’nin ağa katılsa bile hedef cihaza ulaşmasını önleyebilir.

Geçerli bir IP alınmasına rağmen belirli bir sunucuya ulaşılamıyorsa sorun DHCP’den çok ağ geçidi, DNS, istemci izolasyonu veya hedef servisin çalışmamasıyla ilgili olabilir. Bu yüzden “IP var” sonucunu “internet var” şeklinde yorumlamayın.

Bağlantı koparsa güvenli yeniden bağlanma nasıl yapılır?

Wi-Fi bağlantısı kurulduktan sonra ağın sonsuza kadar erişilebilir olduğunu varsaymak, sensör verisi gönderen bir IoT uygulamasında hataya yol açabilir. Modem yeniden başlayabilir, erişim noktası kısa süreliğine kaybolabilir veya ESP32 IP adresini yitirebilir. Uygulama bu durumu belirli aralıklarla kontrol etmeli; ancak her döngüde arka arkaya bağlantı başlatıp ana programı kilitlememelidir.

Aşağıdaki örnek, bağlantı yoksa beş saniyede bir yeniden deneme yapar ve başarılı bağlantıdan sonra deneme sayacını sıfırlar. WiFi.reconnect() çağrısı başarısız olduğunda uygulama sensör okuma gibi diğer işlerini sürdürebilir:

#include <WiFi.h>

unsigned long sonDeneme = 0;
const unsigned long denemeAraligi = 5000;
int denemeSayisi = 0;

void loop() {
  if (WiFi.status() == WL_CONNECTED) {
    denemeSayisi = 0;
    sensorOkuVeKuyrugaEkle();
  } else if (millis() - sonDeneme >= denemeAraligi) {
    sonDeneme = millis();
    denemeSayisi++;
    Serial.printf("Wi-Fi yeniden deneniyor: %d ", denemeSayisi);
    WiFi.reconnect();
  }

  delay(100);
}

void sensorOkuVeKuyrugaEkle() {
  Serial.println("Sensor okunuyor");
}

Örnekteki sensorOkuVeKuyrugaEkle() temsili bir işlevdir; gerçek projede sensör verisini doğrudan kaybetmek yerine geçici bir belleğe veya dosyaya almak daha güvenli olabilir. Örneğin sıcaklık sensörü okuyan bir cihaz bağlantı kesildiğinde ölçümü tamamen durdurmak yerine son verileri zaman damgasıyla saklayabilir ve bağlantı geri geldiğinde toplu olarak gönderebilir.

Yeniden bağlanma stratejisinde şu sınırlar bulunmalıdır:

• Denemeler arasında kısa fakat sabit bir bekleme süresi bırakın.
• Bağlantı çok uzun süre yoksa bekleme aralığını kademeli artıran bir backoff yaklaşımı kullanın.
• Bir bağlantı denemesi sırasında sensör okuma, ekran güncelleme veya güvenlik görevi sonsuza kadar beklememelidir.
• Belirli sayıda başarısız denemeden sonra hata kaydı üretin ve uygulamanın diğer görevlerini sürdürün.
• IP kaybını, erişim noktası bağlantısının kopmasından ayrı bir durum olarak izleyin.

Arduino-ESP32 tarafında olay tabanlı izleme de kullanılabilir. ARDUINO_EVENT_WIFI_STA_DISCONNECTED bağlantı kopmasını, ARDUINO_EVENT_WIFI_STA_GOT_IP ise IP alınmasını bildirir. Olay geri çağırmaları ayrı bir çalışma bağlamında çağrılabildiği için uzun süren işlemleri doğrudan olay işleyicisine koymak yerine yalnızca bir durum değişkeni güncellemek ve asıl işi loop() içinde yürütmek daha güvenli bir tasarımdır.

Güç katmanı: USB ve besleme sorunlarını ağ hatasından ayırma

ESP32 Wi-Fi’ye bağlanmaya çalışırken yeniden başlıyor, seri monitör aniden kesiliyor veya yalnızca kablosuz iletişim etkinleştiğinde kararsızlaşıyorsa güç katmanı da incelenmelidir. Ancak bu belirtiler tek başına kesin bir güç arızası kanıtı değildir; aynı davranış hatalı kod, bağlantı kopması veya çevre birimlerinin oluşturduğu beklenmedik yük nedeniyle de ortaya çıkabilir.

İlk olarak veri iletimini desteklemeyen ya da hasarlı bir USB kablosunu, ardından bilgisayarın USB portunu değiştirerek gözlem yapın. Farklı kabloyla seri monitör kararlı hâle geliyorsa önceki kablo hem haberleşmeyi hem de beslemeyi etkiliyor olabilir. Harici besleme kullanılıyorsa dalgalanma, gevşek bağlantı, ortak topraklama hatası ve çevre birimlerinin aynı kaynaktan çektiği yük kontrol edilmelidir.

Şu belirtileri birlikte değerlendirin:

• Seri çıktı tamamen kesiliyorsa: kart yeniden başlamış, USB bağlantısı kopmuş veya bilgisayar portu bağlantıyı sürdürememiş olabilir.
• Yalnızca radyo etkinleştiğinde sorun oluşuyorsa: besleme kararlılığı ve bağlı çevre birimlerinin toplam yükü incelenmelidir.
• Farklı kablo veya portla davranış değişiyorsa: sorunun ağ ayarından önce USB veri yolu ya da besleme zincirinde aranması mantıklıdır.

Güç sorununu doğrulamak için Wi-Fi kapalıyken temel programı çalıştırın, ardından sensörleri tek tek devreye alın ve son olarak kablosuz bağlantıyı etkinleştirin. Her adımda seri çıktıyı, yeniden başlama durumunu ve bağlantı zamanını kaydedin. Kart modeline ait üretici verileri incelenmeden belirli akım değerleri, pin kullanımları veya kesin besleme sınırları üzerinden genelleme yapılmamalıdır.

Üç belirti için hızlı teşhis tablosu ve son kontrol listesi

ESP32 Wi-Fi sorunlarında belirtiyi doğrudan tek bir nedene bağlamak yerine katmanları sırayla ele almak daha güvenlidir. Aşağıdaki tablo, kesin teşhis koymaz; hangi katmanın önce inceleneceğini ve sonucu daraltacak ayırıcı testi gösterir.

Arduino-ESP32 dokümantasyonunda bağlantı için WiFi.begin(ssid, password), durum kontrolü için WiFi.status() ve alınan adresi görmek için WiFi.localIP() kullanılır. Ayrıca erişim noktasına bağlanmak ile IP almak ayrı olaylar olarak izlenebilir; bu nedenle yalnızca “bağlandı” mesajına güvenilmemelidir. ([docs.espressif.com](https://docs.espressif.com/projects/arduino-esp32/en/latest/api/wifi.html?utm_source=openai))

Son kontrol listesi

• ☐ Kod: WiFi.begin() çağrısının gerçekten çalıştığını, bekleme döngüsünün sonsuz olmadığını ve seri monitör hızının kodla uyumlu olduğunu kontrol et.
• ☐ Kimlik bilgileri: SSID ve parolayı baştan yaz; başta veya sonda boşluk, büyük-küçük harf ve özel karakter hatalarını incele.
• ☐ Kablosuz bant ve ağ: Modemin ilgili ağı yayınladığını, ağ adının gizli olmadığını ve ESP32’nin bağlanmaya çalıştığı ağın doğru ağ olduğunu doğrula.
• ☐ IP/DHCP: Bağlantıdan sonra WiFi.localIP(), ağ geçidi ve DNS çıktısını al. Adres alınmıyorsa modem arayüzündeki DHCP durumunu ve istemci listesini kontrol et.
• ☐ Sinyal: Kartı modeme yaklaştırarak yeniden dene. Sonuç değişiyorsa yazılımı değiştirmeden önce kablosuz ortamı ve sinyal seviyesini araştır.
• ☐ USB/güç: Farklı ve veri aktarabilen bir USB kablosu, doğrudan bir USB portu ve çevre birimleri ayrılmış sade bir devreyle test yap. Yeniden başlama sırasında seri monitörde reset nedeni veya hata metni görünüyorsa kaydet.

Bu teşhis yaklaşımını tamamladıktan sonra Arduino, maker ve programlama konularındaki yeni uygulama örneklerini Berk Akademi blog arşivinde konu başlıklarına göre takip edebilirsin.

Sık Sorulan Sorular

WiFi.begin() çalıştığı hâlde ESP32 neden bağlantı bekleme döngüsünde kalır?

WiFi.begin() yalnızca bağlantı sürecini başlatır; bağlantının tamamlandığını göstermez. SSID veya parola hatası, erişilemeyen ağ, kimlik doğrulama sorunu ya da zayıf sinyal nedeniyle WiFi.status() beklenen duruma geçmeyebilir. Bekleme döngüsüne timeout ekleyip seri monitörde durum çıktısını izlemek, ardından kimlik bilgileri ve ağ katmanına geçmek gerekir.

ESP32 ağa bağlandı görünüyor ancak IP adresi alamıyorsa ne kontrol edilmelidir?

Erişim noktasına bağlantı kurulması, DHCP üzerinden IP adresinin başarıyla alındığı anlamına gelmez. Önce WiFi.localIP() çıktısını, ardından ağ geçidi ve DNS bilgilerini kontrol et. IP adresi yoksa modem üzerindeki DHCP hizmetini, istemci sınırlarını ve ağın yeni cihazlara izin verip vermediğini incele. Arduino-ESP32 API’sinde bağlantı ve IP alma durumları ayrı Wi-Fi olaylarıyla izlenebilir. ([docs.espressif.com](https://docs.espressif.com/projects/arduino-esp32/en/latest/api/wifi.html?utm_source=openai))

ESP32 telefonun erişim noktasına bağlanıyor fakat modeme bağlanmıyorsa sorun nasıl daraltılır?

Telefon erişim noktasıyla bağlantı kurulması, kartın temel Wi-Fi başlatma akışının çalıştığına dair yararlı bir karşılaştırma sağlar; ancak modem ayarlarını tek başına kanıtlamaz. Modemin SSID’sini, parolasını, kablosuz güvenlik ayarlarını, DHCP durumunu ve sinyal koşullarını ayrı ayrı kontrol et. Aynı kodu değiştirmeden iki ağda denemek, sorunun kodda mı yoksa modem yapılandırmasında mı yoğunlaştığını daraltır.

Wi-Fi açıldığında ESP32’nin yeniden başlaması güç sorunu olduğu anlamına gelir mi?

Hayır. Yeniden başlama güç kaynaklı olabilir; ancak yazılım hatası, çevre birimi etkileşimi, watchdog veya seri bağlantının kopması da benzer belirti oluşturabilir. Önce kartı çevre birimleri ayrılmış, sade bir devreyle ve farklı bir USB kablosuyla dene. Seri monitörde reset nedeni görünüyorsa bunu kaydet; yalnızca Wi-Fi çağrısından hemen sonra gerçekleşmesi tek başına kesin güç teşhisi değildir. USB-CDC bağlantısı da hızlı yeniden başlatma döngülerinde tüm çıktıları yakalayamayabilir. ([docs.espressif.com](https://docs.espressif.com/projects/arduino-esp32/en/latest/troubleshooting.html?utm_source=openai))

Katmanları bu sırayla kontrol etmek, rastgele kod veya donanım değişiklikleri yapmak yerine her denemeden ölçülebilir bir sonuç çıkarmanı sağlar.