NodeMCU ESP8266 Kullanımı: Pinler, Kurulum ve Wi-Fi Web Sunucu

NodeMCU, Wi-Fi özellikli ESP8266 yongasını USB bağlantısı, 3,3 V regülatör ve breadboard'a takılabilen pinlerle bir araya getiren, uygun fiyatlı bir geliştirme kartıdır. Arduino IDE'de alıştığın komutlarla programlanır ve tek başına ev ağına bağlanıp telefondan açılan bir web sayfası sunabilir. Bir sıcaklık sensörünü internete bağlamak, bir röleyi telefondan açmak ya da evdeki bir LED şeridi kontrol etmek istiyorsan NodeMCU ESP8266 bu işlerin en ekonomik başlangıç noktalarından biridir.

Bu rehberde NodeMCU'nun teknik özelliklerini, kafa karıştıran D1–D8 ve GPIO pin karşılıklarını, hangi pinlerin kartın açılışını etkilediğini, Arduino IDE kurulumunu, Wi-Fi'ye bağlanmayı ve telefondan LED yakan bir web sunucusunu adım adım göreceksin. Son bölümlerde ESP8266 ile ESP32 arasındaki farkları ve en sık yapılan hataların çözümlerini bulacaksın.

ESP8266 ve NodeMCU nedir?

ESP8266, Espressif firmasının 2014'te piyasaya sürdüğü, Wi-Fi'yi içinde barındıran 32 bitlik bir mikrodenetleyicidir. Çok düşük fiyatı sayesinde hobi dünyasında Wi-Fi'li projelerin yaygınlaşmasını sağladı. NodeMCU adı ise başta bu yonga için yazılmış Lua tabanlı bir yazılımı ve onun açık kaynaklı geliştirme kartını anlatıyordu; bugün ESP-12E modüllü kartların genel adı olarak kullanılıyor. Kartı Lua ile değil, çoğunlukla Arduino IDE ya da MicroPython ile programlarsın.

Piyasada iki yaygın NodeMCU sürümü bulunur. V2 (Amica) dar yapılıdır, CP2102 USB-seri yonga kullanır ve breadboard'a takıldığında iki yanında birer sıra boş delik bırakır. V3 (LoLin) daha geniştir, CH340G yonga kullanır ve standart bir breadboard'u neredeyse tamamen kaplar; bu yüzden V3 ile çalışırken iki breadboard'u yan yana koymak işini kolaylaştırır. İki sürümün pin dizilimi ve kodu aynıdır. Daha küçük bir kart istersen aynı yongayı taşıyan Wemos D1 Mini de aynı kodlarla çalışır.

NodeMCU pinleri: D1–D8 ve GPIO karşılıkları

NodeMCU'nun en çok kafa karıştıran yanı, kartın üzerindeki D etiketlerinin yonganın gerçek GPIO numaralarıyla aynı olmamasıdır. Örneğin kartta D1 yazan pin aslında GPIO 5'tir. Arduino IDE'de NodeMCU kartını seçtiğinde kodda D1 yazabilirsin, derleyici bunu otomatik olarak 5'e çevirir; ama digitalWrite(1, HIGH) yazarsan GPIO 1'i, yani seri haberleşmenin TX pinini sürmüş olursun. MicroPython'da ise her zaman GPIO numarasını kullanırsın.

Bu tabloya göre ilk projelerinde gönül rahatlığıyla kullanabileceğin pinler D1, D2, D5, D6 ve D7'dir. D3, D4 ve D8 ise kartın açılış (boot) modunu belirleyen pinlerdir: ESP8266 enerji geldiğinde GPIO 0, GPIO 2 ve GPIO 15'in seviyelerine bakar ve normal çalışma için GPIO 0 ile GPIO 2'nin HIGH, GPIO 15'in LOW olmasını bekler. Bu pinlere bağladığın bir buton, röle ya da sensör açılış anında seviyeyi değiştirirse kart programın yerine yükleme modunda açılır ya da hiç açılmaz. Butonlar için D3 ve D4 yine de kullanılabilir, çünkü butonlar açılışta basılı değildir; ama çıkışı LOW olan modülleri bu pinlerden uzak tut.

A0 pini de özel bir durumdur: ESP8266 yongasının analog girişi yalnızca 0–1 V ölçer, ama NodeMCU kartının üzerindeki 220 kΩ ve 100 kΩ'luk gerilim bölücü sayesinde A0'a yaklaşık 0–3,2 V verebilirsin; analogRead(A0) bu aralığı 0–1023 arasında döndürür. Tek analog giriş olduğu için birden fazla analog sensör kullanacaksan ADS1115 gibi bir I2C ADC eklemen gerekir. D1 ve D2 pinleri varsayılan I2C hattıdır; I2C'nin temellerini I2C Nedir? yazısında bulabilirsin.

Arduino IDE'ye ESP8266 kurulumu

1. Arduino IDE'de Dosya > Tercihler menüsünü aç ve "Ek kart yöneticisi URL'leri" alanına https://arduino.esp8266.com/stable/package_esp8266com_index.json adresini ekle.
2. Araçlar > Kart > Kart Yöneticisi'ni aç, esp8266 ara ve ESP8266 Community paketini kur.
3. Araçlar > Kart menüsünden NodeMCU 1.0 (ESP-12E Module) seç. Wemos D1 Mini kullanıyorsan LOLIN(WEMOS) D1 R2 & mini seçeneğini seç.
4. Kartı bir veri kablosuyla bağla ve Araçlar > Port menüsünden portu seç. Port görünmüyorsa V3 kartlar için CH340, V2 kartlar için CP2102 sürücüsünü kur.
5. Upload Speed değerini 115200 olarak bırak; yükleme sorunsuz çalışıyorsa 921600'e çıkararak yüklemeyi hızlandırabilirsin.

İlk program: dahili LED'i yakıp söndürmek

NodeMCU'da ESP-12E modülünün üzerinde GPIO 2'ye (D4) bağlı mavi bir LED bulunur; V2 (Amica) kartlarda D0'a bağlı ikinci bir LED daha vardır. Bu LED'ler ters mantıkla çalışır: pin LOW olduğunda yanar, HIGH olduğunda söner. Arduino çekirdeğinde LED_BUILTIN sabiti zaten 2 olarak tanımlıdır:

1// NodeMCU dahili LED'i: GPIO2 (D4), ters mantık / onboard LED: GPIO2 (D4), inverted logic
2
3void setup() {
4  pinMode(LED_BUILTIN, OUTPUT);
5}
6
7void loop() {
8  digitalWrite(LED_BUILTIN, LOW);    // LOW = yanar / LOW = on
9  delay(500);
10  digitalWrite(LED_BUILTIN, HIGH);   // HIGH = söner / HIGH = off
11  delay(500);
12}

Wi-Fi'ye bağlanmak

ESP8266'nın asıl gücü Wi-Fi'dır. Aşağıdaki kod kartı istemci (station) modunda ev ağına bağlar, modemin verdiği IP adresini ve sinyal gücünü Seri Monitör'e yazar. 20 saniye içinde bağlanamazsa beklemeyi bırakır ve uyarı verir. Ağ adını ve şifreni kendi bilgilerinle değiştir, Seri Monitör'ü 115200 baud hızında aç:

1#include <ESP8266WiFi.h>
2
3const char* ssid = "AgAdi";          // Wi-Fi adın / your Wi-Fi name
4const char* password = "Sifre123";   // Wi-Fi şifren / your Wi-Fi password
5
6void setup() {
7  Serial.begin(115200);
8  Serial.println();
9  WiFi.mode(WIFI_STA);               // istemci modu / station mode
10  WiFi.begin(ssid, password);
11  Serial.print("Baglaniyor / connecting");
12  unsigned long start = millis();
13  while (WiFi.status() != WL_CONNECTED) {
14    delay(500);
15    Serial.print('.');
16    if (millis() - start > 20000) {  // 20 sn'de bağlanamazsa / give up after 20 s
17      Serial.println("\nBaglanamadi, ag adini ve sifreyi kontrol et / failed, check SSID and password");
18      return;
19    }
20  }
21  Serial.println();
22  Serial.print("IP: ");
23  Serial.println(WiFi.localIP());    // modemin verdiği adres / address given by the router
24  Serial.print("Sinyal / RSSI: ");
25  Serial.print(WiFi.RSSI());         // -50 iyi, -80 zayıf / -50 good, -80 weak
26  Serial.println(" dBm");
27}
28
29void loop() {
30}

Telefondan LED kontrolü: basit web sunucu

Şimdi NodeMCU'yu küçük bir web sunucusuna çevirelim. D1 pinine (GPIO 5) 220 Ω'luk bir dirençle bir LED bağla: LED'in uzun bacağı direnç üzerinden D1'e, kısa bacağı GND'ye gider. Kırmızı bir LED için bu direnç (3,3 V − 2 V) / 220 Ω ≈ 6 mA akım verir, yani pinin sınırının rahatça altındadır; değeri kendi LED'ine göre hesaplamak için LED Direnci Hesaplama aracını kullanabilirsin. Kod yüklendikten sonra Seri Monitör'de görünen adresi, aynı Wi-Fi'ye bağlı telefonunun tarayıcısında aç.

1#include <ESP8266WiFi.h>
2#include <ESP8266WebServer.h>
3#include <ESP8266mDNS.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
7
8const int LED_PIN = D1;              // GPIO5, 220 ohm direnç ile LED / LED through a 220 ohm resistor
9bool ledOn = false;
10
11ESP8266WebServer server(80);
12
13void handleRoot() {
14  String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>"
15                "<meta name='viewport' content='width=device-width,initial-scale=1'>"
16                "<title>NodeMCU</title></head>"
17                "<body style='font-family:sans-serif;text-align:center'>"
18                "<h1>NodeMCU LED</h1><p>LED: <b>";
19  html += ledOn ? "ACIK / ON" : "KAPALI / OFF";
20  html += "</b></p><p>A0: ";
21  html += analogRead(A0);            // 0-1023 arası analog değer / analog value 0-1023
22  html += "</p><p><a href='/on'><button>AC / ON</button></a> "
23          "<a href='/off'><button>KAPAT / OFF</button></a></p></body></html>";
24  server.send(200, "text/html", html);
25}
26
27void setLed(bool on) {
28  ledOn = on;
29  digitalWrite(LED_PIN, on ? HIGH : LOW);
30  server.sendHeader("Location", "/");   // ana sayfaya yönlendir / redirect to the main page
31  server.send(303, "text/plain", "");
32}
33
34void setup() {
35  pinMode(LED_PIN, OUTPUT);
36  digitalWrite(LED_PIN, LOW);
37  Serial.begin(115200);
38  WiFi.mode(WIFI_STA);
39  WiFi.begin(ssid, password);
40  while (WiFi.status() != WL_CONNECTED) {
41    delay(500);
42    Serial.print('.');
43  }
44  Serial.println();
45  Serial.print("Tarayicida ac / open in browser: http://");
46  Serial.println(WiFi.localIP());
47
48  if (MDNS.begin("nodemcu")) {       // http://nodemcu.local adresi / address http://nodemcu.local
49    MDNS.addService("http", "tcp", 80);
50  }
51
52  server.on("/", handleRoot);
53  server.on("/on", []() { setLed(true); });
54  server.on("/off", []() { setLed(false); });
55  server.onNotFound([]() { server.send(404, "text/plain", "Bulunamadi / not found"); });
56  server.begin();
57}
58
59void loop() {
60  server.handleClient();             // gelen istekleri işle / handle incoming requests
61  MDNS.update();
62}

Sayfa açılmıyorsa telefonunun misafir ağına ya da mobil veriye değil, NodeMCU ile aynı Wi-Fi ağına bağlı olduğundan emin ol. nodemcu.local adı bilgisayarlarda ve iPhone'larda genellikle çalışır; bazı Android telefonlarda mDNS desteği olmadığı için IP adresini kullanman gerekir. LED yerine bir röle modülü bağlarsan aynı kodla gerçek bir lambayı kontrol edebilirsin; ayrıntılar için Röle Modülü Nedir? yazısına bak.

Erişim noktası (AP) modu: modemsiz bağlantı

Ortamda Wi-Fi yoksa NodeMCU kendi ağını kurabilir. Erişim noktası modunda telefonunu doğrudan NodeMCU-AP ağına bağlarsın ve kart genellikle 192.168.4.1 adresinden cevap verir. Bu mod, bahçedeki bir sulama sistemi ya da sahada kullanılan bir ölçüm cihazı için idealdir. Yukarıdaki web sunucusunu bu modla birleştirmek için WiFi.begin satırları yerine softAP satırlarını kullanman yeterlidir; WIFI_AP_STA modu ise iki rolü aynı anda üstlenir. Şifre en az 8 karakter olmalıdır, aksi halde ağ kurulmaz.

1#include <ESP8266WiFi.h>
2
3void setup() {
4  Serial.begin(115200);
5  WiFi.mode(WIFI_AP);                            // kendi ağını kur / create its own network
6  bool ok = WiFi.softAP("NodeMCU-AP", "12345678"); // ad ve en az 8 karakter şifre / name and 8+ char password
7  Serial.println(ok ? "AP hazir / AP ready" : "AP hatasi / AP error");
8  Serial.print("IP: ");
9  Serial.println(WiFi.softAPIP());               // genellikle 192.168.4.1 / usually 192.168.4.1
10}
11
12void loop() {
13  Serial.print("Bagli cihaz / stations: ");
14  Serial.println(WiFi.softAPgetStationNum());
15  delay(3000);
16}

MicroPython ile ESP8266

NodeMCU, Arduino diline ek olarak MicroPython ile de programlanabilir. esptool ile karta MicroPython yazılımı yüklendikten sonra Thonny gibi bir editörle Python kodlarını doğrudan çalıştırırsın. ESP8266'nın belleği sınırlı olduğu için büyük MicroPython programlarında bellek hatası alabilirsin; yine de basit Wi-Fi ve sensör projeleri için oldukça pratiktir. MicroPython'da pin numarası olarak D etiketini değil GPIO numarasını yazdığına dikkat et:

1import network, time
2from machine import Pin
3
4led = Pin(2, Pin.OUT)                     # D4 = GPIO2, dahili LED / onboard LED
5wlan = network.WLAN(network.STA_IF)
6wlan.active(True)
7wlan.connect("AgAdi", "Sifre123")         # Wi-Fi adı ve şifresi / Wi-Fi name and password
8
9while not wlan.isconnected():
10    time.sleep(0.5)
11print("IP:", wlan.ifconfig()[0])
12
13while True:
14    led.value(not led.value())            # ters mantık: 0 = yanar / inverted: 0 = on
15    time.sleep(0.5)

ESP8266 mi ESP32 mi?

Kısacası ESP8266, tek bir sensörün verisini internete göndermek, bir röleyi telefondan açmak ya da basit bir web sayfası sunmak gibi işler için hâlâ çok yeterlidir ve daha ucuzdur. Bluetooth, çok sayıda analog giriş, kamera, hızlı işlem ya da aynı anda birçok iş gereken yeni projelerde ise ESP32 daha doğru seçimdir. Kodlar büyük ölçüde taşınabilir: ESP8266WiFi.h yerine WiFi.h, ESP8266WebServer.h yerine WebServer.h, ESP8266mDNS.h yerine ESPmDNS.h yazman, ESP32'de bulunmayan MDNS.update() satırını silmen ve D1 gibi kart etiketleri yerine GPIO numaralarını kullanman çoğu zaman yeterlidir. Ayrıntılar için ESP32 Nedir? ve Arduino mu ESP32 mi? yazılarına göz atabilirsin.

Güç beslemesi ve derin uyku

NodeMCU, USB'den ya da VIN pininden 5 V ile beslenir; kart üzerindeki regülatör bunu 3,3 V'a düşürür. Wi-Fi gönderimi sırasındaki 170 mA'lik ani akım, zayıf bir USB portunda ya da ince bir kabloda gerilim düşmesine ve kartın kendiliğinden yeniden başlamasına yol açabilir; kaliteli bir kablo ve en az 1 A veren bir adaptör kullan. Pille çalışacak projelerde ESP.deepSleep() yongayı yaklaşık 20 µA tüketimle uyutur; zamanlayıcı dolunca uyanabilmesi için D0 (GPIO 16) pinini RST pinine bağlaman gerekir. Ancak kart üzerindeki USB-seri yonga ve regülatör uyurken de akım çekmeye devam ettiği için uzun pil ömrü isteyen projelerde çıplak ESP-12 modülü ya da düşük tüketimli kartlar daha iyi sonuç verir. Pil ömrünü hesaplamak için Pil Ömrü Hesaplama aracını kullanabilirsin.

NodeMCU ile proje fikirleri

• Wi-Fi termometre: DHT11 ile ölçülen sıcaklık ve nemi telefondan açılan bir sayfada göster.
• Akıllı priz: Bir röle modülü ile lambayı web sayfasındaki düğmeyle aç ve kapat.
• Bitki sulama uyarısı: Toprak nem sensörünü A0'a bağla, toprak kuruyunca sayfada uyarı göster.
• Wi-Fi LED şerit: WS2812B şeridin rengini ve efektini telefondan seç.
• İnternet saati: Saati NTP sunucusundan alıp I2C LCD ekranda göster.
• Hareket alarmı: PIR sensörü hareket algıladığında Telegram'a mesaj gönder.

Sık yapılan hatalar ve çözümleri

NodeMCU ESP8266, Arduino'da öğrendiklerini kablosuz dünyaya taşımanın en ekonomik yoludur: birkaç satır kodla ev ağına bağlanır ve telefondan kontrol edilen cihazlar yapmanı sağlar. BlueGrays uygulamasında Wi-Fi bağlantısı, web sunucu, WebSocket, NTP saat ve mDNS gibi kablosuz projeleri ESP32 üzerinde adım adım devre şemaları ve kodlarıyla bulabilir, aynı mantığı NodeMCU'na kolayca uyarlayabilirsin.