NodeMCU ESP8266: Pinbelegung, Arduino IDE und WLAN-Webserver

Der NodeMCU ist ein günstiges Entwicklungsboard, das den WLAN-fähigen ESP8266-Chip mit USB-Anschluss, 3,3-V-Spannungsregler und steckbrettfreundlichen Pins kombiniert. Du programmierst ihn mit denselben Befehlen, die du aus der Arduino IDE kennst, und er kann sich ganz allein in dein Heimnetz einwählen und eine Webseite bereitstellen, die du auf dem Handy öffnest. Wenn du einen Temperatursensor ins Internet bringen, ein Relais per Handy schalten oder einen LED-Streifen zu Hause steuern möchtest, ist der NodeMCU ESP8266 einer der günstigsten Einstiege.

In dieser Anleitung gehst du Schritt für Schritt durch die technischen Daten des NodeMCU, die verwirrende Zuordnung D1–D8 zu GPIO, die Pins, die den Bootvorgang beeinflussen, die Einrichtung in der Arduino IDE, die WLAN-Verbindung und einen Webserver, der eine LED per Handy schaltet. In den letzten Abschnitten findest du die Unterschiede zwischen ESP8266 und ESP32 sowie Lösungen für die häufigsten Fehler.

Was sind ESP8266 und NodeMCU?

Der ESP8266 ist ein 32-Bit-Mikrocontroller mit integriertem WLAN, den Espressif 2014 auf den Markt brachte. Dank seines sehr niedrigen Preises hat er WLAN-Projekte in der Maker-Szene populär gemacht. Der Name NodeMCU bezeichnete ursprünglich eine Lua-basierte Firmware für diesen Chip und das dazugehörige Open-Source-Entwicklungsboard; heute steht er allgemein für Boards mit dem ESP-12E-Modul. In Lua programmierst du ihn aber kaum noch; die meisten nutzen die Arduino IDE oder MicroPython.

Auf dem Markt gibt es zwei verbreitete NodeMCU-Versionen. Die V2 (Amica) ist schmal, nutzt einen CP2102-USB-Seriell-Wandler und lässt auf dem Steckbrett auf jeder Seite eine Reihe Löcher frei. Die V3 (LoLin) ist breiter, nutzt einen CH340G und bedeckt ein normales Steckbrett fast vollständig; mit zwei nebeneinander gestellten Steckbrettern arbeitest du mit der V3 deshalb viel bequemer. Beide Versionen haben dieselbe Pinbelegung und laufen mit demselben Code. Wenn du ein kleineres Board willst: Der Wemos D1 Mini trägt denselben Chip und läuft mit denselben Sketches.

NodeMCU-Pinbelegung: D1–D8 und GPIO-Zuordnung

Das Verwirrendste am NodeMCU ist, dass die auf dem Board aufgedruckten D-Bezeichnungen nicht den echten GPIO-Nummern des Chips entsprechen. Der Pin mit der Aufschrift D1 ist zum Beispiel in Wirklichkeit GPIO 5. Wählst du in der Arduino IDE das NodeMCU-Board aus, kannst du im Code D1 schreiben, und der Compiler macht automatisch 5 daraus; schreibst du aber digitalWrite(1, HIGH), steuerst du GPIO 1, also den TX-Pin der seriellen Schnittstelle. In MicroPython verwendest du immer die GPIO-Nummer.

Laut dieser Tabelle kannst du in deinen ersten Projekten bedenkenlos die Pins D1, D2, D5, D6 und D7 nutzen. D3, D4 und D8 bestimmen dagegen den Bootmodus: Beim Einschalten prüft der ESP8266 die Pegel von GPIO 0, GPIO 2 und GPIO 15 und erwartet für einen normalen Start GPIO 0 und GPIO 2 auf HIGH sowie GPIO 15 auf LOW. Verändert ein Taster, Relais oder Sensor an diesen Pins den Pegel beim Start, bootet das Board statt deines Programms in den Upload-Modus oder gar nicht. Für Taster kannst du D3 und D4 trotzdem nutzen, weil ein Taster beim Booten nicht gedrückt ist; Module, deren Ausgang auf LOW liegt, gehören aber nicht an diese Pins.

Auch der Pin A0 ist ein Sonderfall: Der Analogeingang des ESP8266-Chips misst nur 0–1 V, dank des Spannungsteilers aus 220 kΩ und 100 kΩ auf dem NodeMCU-Board kannst du an A0 aber etwa 0–3,2 V anlegen, und analogRead(A0) gibt diesen Bereich als 0–1023 zurück. Da es nur einen Analogeingang gibt, brauchst du für mehrere analoge Sensoren einen I2C-ADC wie den ADS1115. Die Pins D1 und D2 sind der Standard-I2C-Bus; die Grundlagen von I2C findest du in Was ist I2C?.

ESP8266 in der Arduino IDE einrichten

1. Öffne in der Arduino IDE Datei > Einstellungen und trage https://arduino.esp8266.com/stable/package_esp8266com_index.json im Feld „Zusätzliche Boardverwalter-URLs“ ein.
2. Öffne Werkzeuge > Board > Boardverwalter, suche nach esp8266 und installiere das Paket von ESP8266 Community.
3. Wähle im Menü Werkzeuge > Board den Eintrag NodeMCU 1.0 (ESP-12E Module). Für einen Wemos D1 Mini nimmst du stattdessen LOLIN(WEMOS) D1 R2 & mini.
4. Schließe das Board mit einem Datenkabel an und wähle den Port unter Werkzeuge > Port. Erscheint kein Port, installiere den CH340-Treiber für V3-Boards oder den CP2102-Treiber für V2-Boards.
5. Lass Upload Speed auf 115200; wenn das Hochladen zuverlässig klappt, kannst du auf 921600 erhöhen und schneller hochladen.

Erster Sketch: die Onboard-LED blinken lassen

Auf dem NodeMCU sitzt auf dem ESP-12E-Modul eine blaue LED an GPIO 2 (D4); V2-Boards (Amica) haben eine zweite LED an D0. Diese LEDs arbeiten mit invertierter Logik: Sie leuchten, wenn der Pin LOW ist, und gehen bei HIGH aus. Im Arduino-Core ist die Konstante LED_BUILTIN bereits als 2 definiert:

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}

Mit dem WLAN verbinden

Die eigentliche Stärke des ESP8266 ist das WLAN. Der folgende Sketch verbindet das Board im Station-Modus mit deinem Heimnetz und gibt die vom Router vergebene IP-Adresse sowie die Signalstärke im seriellen Monitor aus. Klappt die Verbindung nicht innerhalb von 20 Sekunden, hört er auf zu warten und gibt eine Warnung aus. Ersetze Netzwerkname und Passwort durch deine eigenen Daten und öffne den seriellen Monitor mit 115200 Baud:

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}

LED per Handy schalten: ein einfacher Webserver

Jetzt machen wir aus dem NodeMCU einen kleinen Webserver. Schließe an Pin D1 (GPIO 5) eine LED mit 220-Ω-Widerstand an: Das lange Bein der LED geht über den Widerstand an D1, das kurze an GND. Bei einer roten LED ergibt dieser Widerstand (3,3 V − 2 V) / 220 Ω ≈ 6 mA, also deutlich unter der Grenze des Pins; den Wert für deine eigene LED berechnest du mit dem LED-Vorwiderstand-Rechner. Öffne nach dem Hochladen die im seriellen Monitor angezeigte Adresse im Browser eines Handys, das im selben WLAN ist.

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}

Wenn sich die Seite nicht öffnet, prüfe, ob dein Handy im selben WLAN wie der NodeMCU ist und nicht im Gastnetz oder in den mobilen Daten. Der Name nodemcu.local funktioniert auf Computern und iPhones meist; manchen Android-Handys fehlt die mDNS-Unterstützung, dort brauchst du die IP-Adresse. Schließt du statt der LED ein Relaismodul an, steuerst du mit demselben Code eine echte Lampe; Details findest du in Was ist ein Relaismodul?.

Access-Point-Modus (AP): Verbindung ohne Router

Gibt es kein WLAN in der Nähe, kann der NodeMCU ein eigenes Netz aufbauen. Im Access-Point-Modus verbindest du dein Handy direkt mit dem Netz NodeMCU-AP, und das Board antwortet meist unter 192.168.4.1. Dieser Modus ist ideal für eine Bewässerung im Garten oder ein Messgerät im Außeneinsatz. Um den Webserver von oben mit diesem Modus zu kombinieren, ersetzt du einfach die WiFi.begin-Zeilen durch die softAP-Zeilen; der Modus WIFI_AP_STA übernimmt beide Rollen gleichzeitig. Das Passwort muss mindestens 8 Zeichen lang sein, sonst wird das Netz nicht erstellt.

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}

ESP8266 mit MicroPython

Neben der Arduino-Sprache lässt sich der NodeMCU auch mit MicroPython programmieren. Nachdem du die MicroPython-Firmware mit esptool aufgespielt hast, führst du Python-Code direkt aus einem Editor wie Thonny aus. Da der Speicher des ESP8266 begrenzt ist, können große MicroPython-Programme Speicherfehler auslösen; für einfache WLAN- und Sensorprojekte ist es aber sehr praktisch. Beachte, dass du in MicroPython als Pinnummer die GPIO-Nummer schreibst, nicht die D-Bezeichnung:

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 oder ESP32?

Kurz gesagt: Für Aufgaben wie die Daten eines Sensors ins Internet schicken, ein Relais per Handy schalten oder eine einfache Webseite ausliefern reicht der ESP8266 nach wie vor völlig aus, und er ist günstiger. Für neue Projekte mit Bluetooth, vielen Analogeingängen, Kamera, viel Rechenleistung oder vielen gleichzeitigen Aufgaben ist der ESP32 die bessere Wahl. Code lässt sich leicht übertragen: Oft reicht es, WiFi.h statt ESP8266WiFi.h, WebServer.h statt ESP8266WebServer.h und ESPmDNS.h statt ESP8266mDNS.h zu schreiben, die Zeile MDNS.update() zu löschen (die gibt es beim ESP32 nicht) und statt Board-Bezeichnungen wie D1 die GPIO-Nummern zu verwenden. Mehr dazu in Was ist der ESP32? und Arduino oder ESP32?.

Stromversorgung und Deep Sleep

Der NodeMCU wird mit 5 V über USB oder den VIN-Pin versorgt, und der Regler auf dem Board macht daraus 3,3 V. Die Stromspitze von 170 mA beim Senden über WLAN kann an einem schwachen USB-Port oder über ein dünnes Kabel die Spannung einbrechen lassen und das Board neu starten; nimm deshalb ein gutes Kabel und ein Netzteil mit mindestens 1 A. Bei Batterieprojekten schickt ESP.deepSleep() den Chip mit etwa 20 µA schlafen; damit er nach Ablauf des Timers aufwachen kann, musst du D0 (GPIO 16) mit dem RST-Pin verbinden. Der USB-Seriell-Wandler und der Regler auf dem Board ziehen aber auch im Schlaf weiter Strom, daher liefern für lange Akkulaufzeiten ein nacktes ESP-12-Modul oder stromsparende Boards bessere Ergebnisse. Die Akkulaufzeit schätzt du mit dem Akkulaufzeit-Rechner ab.

Projektideen mit dem NodeMCU

• WLAN-Thermometer: Zeige Temperatur und Luftfeuchtigkeit eines DHT11 auf einer Seite an, die du auf dem Handy öffnest.
• Smarte Steckdose: Schalte eine Lampe mit einem Relaismodul über eine Taste auf einer Webseite ein und aus.
• Gießwarnung für Pflanzen: Schließe einen Bodenfeuchtesensor an A0 an und zeige eine Warnung auf der Seite, wenn die Erde austrocknet.
• WLAN-LED-Streifen: Wähle Farbe und Effekt eines WS2812B-Streifens per Handy.
• Internetuhr: Hol dir die Uhrzeit von einem NTP-Server und zeige sie auf einem I2C-LCD an.
• Bewegungsalarm: Schicke eine Telegram-Nachricht, wenn ein PIR-Sensor eine Bewegung erkennt.

Häufige Fehler und Lösungen

Der NodeMCU ESP8266 ist der günstigste Weg, dein Arduino-Wissen in die drahtlose Welt mitzunehmen: Mit wenigen Zeilen Code verbindet er sich mit deinem Heimnetz und ermöglicht Geräte, die du per Handy steuerst. In der BlueGrays-App findest du drahtlose Projekte wie WLAN-Verbindung, Webserver, WebSocket, NTP-Uhr und mDNS auf dem ESP32 mit Schritt-für-Schritt-Schaltplänen und Code, und dieselbe Logik kannst du ganz einfach auf deinen NodeMCU übertragen.