NodeMCU ESP8266 V3 Einsteiger-Tutorial: Vom ersten Sketch zum WLAN-Sensor mit DHT22

Warum das NodeMCU ESP8266 V3?

Der ESP8266 ist der Chip, der das Bastel-Hobby vor Jahren im Sturm erobert hat: ein vollwertiger WLAN-Mikrocontroller für einen Bruchteil dessen, was WLAN-Shields damals kosteten. Das NodeMCU ESP8266 V3 ist die komfortabelste Bauform davon: Der nackte Chip sitzt auf einer Platine mit USB-Buchse, Spannungsregler, USB-Seriell-Wandler (CH340) und praktischen Stiftleisten fürs Breadboard.

Das bedeutet: Du steckst das Board per USB-Kabel an den Rechner, lädst deinen Sketch hoch – fertig. Kein FTDI-Adapter, keine fummelige Verkabelung zum Flashen, kein externes Netzteil. Genau das macht das V3 zum idealen Einstiegsboard, wenn du bisher mit dem Arduino UNO R3 gearbeitet hast und jetzt WLAN dazuhaben willst.

Das brauchst du

1Arduino IDE für den ESP8266 einrichten

Damit die Arduino IDE das NodeMCU kennt, musst du einmalig die ESP8266-Boardunterstützung nachinstallieren. Öffne Datei → Voreinstellungen und trage bei "Zusätzliche Boardverwalter-URLs" diese Adresse ein:

http://arduino.esp8266.com/stable/package_esp8266com_index.json

Danach gehst du auf Werkzeuge → Board → Boardverwalter, suchst nach esp8266 und installierst das Paket "ESP8266 by ESP8266 Community". Anschließend wählst du unter Werkzeuge → Board den Eintrag NodeMCU 1.0 (ESP-12E Module). Diese Einstellungen passen fürs V3:

2Pinout verstehen: Dx-Nummern und ihre Fallstricke

Der wichtigste Aha-Moment beim ESP8266: Die aufgedruckten Pin-Namen (D0 bis D8) sind nicht die GPIO-Nummern, die du im Code benutzt. Zum Glück kennt der Arduino-Core die Dx-Namen als Konstanten – du kannst also einfach D5 schreiben. Wichtig ist trotzdem zu wissen, welche Pins Besonderheiten haben:

3Der erste Sketch: Blink

Bevor wir ins WLAN gehen, prüfen wir mit dem Klassiker, ob Upload und Board funktionieren. Das NodeMCU hat eine eingebaute LED an LED_BUILTIN (GPIO2). Achtung: Sie ist invertiert verdrahtet – LOW schaltet sie an, HIGH aus.

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, LOW);   // LED an (invertiert!)
  delay(500);
  digitalWrite(LED_BUILTIN, HIGH);  // LED aus
  delay(500);
}

Willst du stattdessen eine eigene LED blinken lassen, steckst du sie über einen 330-Ω-Vorwiderstand an Pin D5 und GND, setzt pinMode(D5, OUTPUT) und schaltest mit digitalWrite(D5, HIGH/LOW). Warum der Vorwiderstand nötig ist und wie du seinen Wert berechnest, erklärt der Artikel LED-Vorwiderstand berechnen.

4Ins WLAN einwählen

Jetzt das, wofür der ESP8266 gemacht ist: die WLAN-Verbindung. Der folgende Sketch verbindet sich mit deinem Netz und gibt die zugewiesene IP-Adresse im seriellen Monitor aus. Trag deine SSID und dein Passwort ein.

#include <ESP8266WiFi.h>

const char* ssid     = "DEIN_WLAN_NAME";
const char* password = "DEIN_PASSWORT";

void setup() {
  Serial.begin(115200);
  delay(100);

  WiFi.mode(WIFI_STA);           // als Client (nicht als Access Point)
  WiFi.begin(ssid, password);

  Serial.print("Verbinde mit WLAN");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println();
  Serial.print("Verbunden! IP-Adresse: ");
  Serial.println(WiFi.localIP());
}

void loop() {
}

5Den DHT22 auslesen

Der DHT22 misst Temperatur (-40 bis +80 °C) und Luftfeuchte (0–100 %) und liefert beides digital über eine einzige Datenleitung. So verkabelst du ihn mit dem NodeMCU:

Installiere über den Bibliotheksverwalter die "DHT sensor library" von Adafruit (samt der abhängigen "Adafruit Unified Sensor"). Dann liest dieser Sketch alle zwei Sekunden die Werte aus:

#include "DHT.h"

#define DHTPIN  D5      // Datenpin
#define DHTTYPE DHT22   // Sensortyp

DHT dht(DHTPIN, DHTTYPE);

void setup() {
  Serial.begin(115200);
  dht.begin();
}

void loop() {
  delay(2000);   // DHT22 max. alle 2 Sekunden abfragen

  float t = dht.readTemperature();
  float h = dht.readHumidity();

  if (isnan(t) || isnan(h)) {
    Serial.println("Fehler beim Lesen des DHT22!");
    return;
  }

  Serial.printf("Temperatur: %.1f C  |  Luftfeuchte: %.1f %%\n", t, h);
}

6Alles zusammen: Messwerte im Browser anzeigen

Jetzt das Highlight: Wir kombinieren WLAN und Sensor zu einem kleinen Webserver. Rufst du die IP-Adresse des NodeMCU im Browser auf, zeigt es dir Temperatur und Luftfeuchte auf einer selbst gebauten Seite an, die sich alle fünf Sekunden aktualisiert.

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
#include "DHT.h"

const char* ssid     = "DEIN_WLAN_NAME";
const char* password = "DEIN_PASSWORT";

#define DHTPIN  D5
#define DHTTYPE DHT22
DHT dht(DHTPIN, DHTTYPE);

ESP8266WebServer server(80);

void handleRoot() {
  float t = dht.readTemperature();
  float h = dht.readHumidity();

  String html = "<!DOCTYPE html><html><head>";
  html += "<meta charset='utf-8'>";
  html += "<meta http-equiv='refresh' content='5'>";   // alle 5 s neu laden
  html += "<title>NodeMCU Klima</title></head><body>";
  html += "<h1>Raumklima</h1>";
  html += "<p>Temperatur: " + String(t, 1) + " °C</p>";
  html += "<p>Luftfeuchte: " + String(h, 1) + " %</p>";
  html += "</body></html>";

  server.send(200, "text/html", html);
}

void setup() {
  Serial.begin(115200);
  dht.begin();

  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); }
  Serial.println();
  Serial.print("Webserver laeuft auf: http://");
  Serial.println(WiFi.localIP());

  server.on("/", handleRoot);
  server.begin();
}

void loop() {
  server.handleClient();
}

Lade den Sketch hoch, öffne den seriellen Monitor, kopiere die angezeigte IP-Adresse (z. B. 192.168.178.42) in deinen Browser – und schon siehst du deine Messwerte live. Jedes Gerät in deinem Heimnetz kann diese Seite aufrufen. Wie du daraus ein vollwertiges, per Browser schaltbares Steuerpanel machst, zeigt der Artikel ESP32 Webserver einrichten (das Prinzip ist beim ESP8266 identisch).

7Bonus: Deep Sleep für Batteriebetrieb

Soll das NodeMCU als batteriebetriebener Funksensor laufen, ist Dauerbetrieb Verschwendung – WLAN frisst Strom. Die Lösung ist der Deep Sleep: Das Board misst, sendet und legt sich dann für eine feste Zeit fast komplett schlafen. Dafür musst du einmalig D0 (GPIO16) mit RST verbinden, damit der interne Timer das Board wieder aufwecken kann.

// Board misst, und schlaeft dann 15 Minuten
// WICHTIG: D0 (GPIO16) mit RST verbinden!

void setup() {
  Serial.begin(115200);
  // ... hier WLAN verbinden, DHT22 lesen, Wert senden ...

  Serial.println("Gehe schlafen fuer 15 Minuten");
  ESP.deepSleep(15 * 60 * 1000000ULL);   // Mikrosekunden
}

void loop() {
  // wird nie erreicht - nach dem Aufwachen startet setup() neu
}

Troubleshooting