Wemos D1 Mini Einsteiger-Tutorial: Vom ersten Sketch zum ESP8266 WLAN-Webserver

Warum der D1 Mini der perfekte Einstieg ins IoT ist

Ein klassischer Arduino UNO ist toll zum Lernen – aber sobald dein Projekt ins Netzwerk soll, brauchst du Zusatzhardware. Der ESP8266 auf dem D1 Mini bringt WLAN direkt mit: Er verbindet sich mit deinem Heimnetz, kann Webseiten ausliefern, Daten an Server schicken oder per MQTT mit deinem Smart Home sprechen. Dazu kommt: Der Chip läuft mit 80 MHz (statt 16 MHz beim UNO), hat 4 MB Flash und wird bequem per USB-C programmiert – in derselben Arduino IDE, die du schon kennst.

Der D1 Mini ist dabei bewusst minimalistisch: 11 nutzbare GPIO-Pins, ein Analogeingang, kompaktes Format für den Dauereinsatz in kleinen Gehäusen. Für Sensorknoten, WLAN-Schalter, Wetterstationen und ESPHome-Projekte ist genau das ideal.

Was du brauchst

Arduino IDE für den ESP8266 einrichten

1. 1Öffne in der Arduino IDE Datei → Einstellungen und trage bei „Zusätzliche Boardverwalter-URLs“ ein: http://arduino.esp8266.com/stable/package_esp8266com_index.json
2. 2Öffne den Boardverwalter, suche nach „esp8266“ und installiere das Paket esp8266 by ESP8266 Community.
3. 3Wähle unter Werkzeuge → Board den Eintrag LOLIN(WEMOS) D1 R2 & mini.
4. 4Schließe das Board per USB-C an und wähle den neuen COM-Port aus. Wird kein Port angezeigt, installiere den CH340-USB-Treiber (siehe Troubleshooting).

Die Pin-Belegung verstehen: D-Nummern vs. GPIO

Die größte Stolperfalle beim D1 Mini: Die aufgedruckten Pin-Namen (D0 bis D8) entsprechen nicht den GPIO-Nummern des ESP8266. Im Code kannst du zum Glück einfach die D-Konstanten verwenden – digitalWrite(D4, HIGH) funktioniert direkt. Ein paar Pins haben außerdem Sonderfunktionen beim Booten:

Merkregel: Sensoren und Aktoren zuerst an D1, D2, D5, D6, D7 anschließen – diese Pins haben keine Boot-Fallen.

Code 1: Blink mit der internen LED

Der Klassiker zum Testen der Toolchain. Beachte: Die interne LED des D1 Mini ist invertiert – LOW schaltet sie ein.

void setup() {
  pinMode(LED_BUILTIN, OUTPUT); // interne LED an D4 (GPIO2)
}

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

Code 2: Mit dem WLAN verbinden und DHT22 auslesen

Verkabelung: DHT22 VCC an 3V3, GND an G, Datenpin an D2. Installiere im Bibliotheksverwalter die DHT sensor library von Adafruit (inkl. Adafruit Unified Sensor).

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

#define DHT_PIN D2
#define DHT_TYP DHT22

const char* WLAN_NAME     = "DEIN_WLAN_NAME";
const char* WLAN_PASSWORT = "DEIN_WLAN_PASSWORT";

DHT dht(DHT_PIN, DHT_TYP);

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

  WiFi.mode(WIFI_STA);
  WiFi.begin(WLAN_NAME, WLAN_PASSWORT);
  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() {
  float temperatur = dht.readTemperature();
  float feuchte    = dht.readHumidity();

  if (isnan(temperatur) || isnan(feuchte)) {
    Serial.println("Fehler beim Lesen des DHT22!");
  } else {
    Serial.print("Temperatur: ");
    Serial.print(temperatur);
    Serial.print(" °C  |  Luftfeuchte: ");
    Serial.print(feuchte);
    Serial.println(" %");
  }
  delay(3000);
}

Im seriellen Monitor (115200 Baud) siehst du nach dem Verbindungsaufbau die IP-Adresse deines Boards – die brauchst du gleich für den Webserver.

Code 3: WLAN-Webserver mit Sensoranzeige und Relais-Steuerung

Jetzt kombinieren wir alles: Der D1 Mini liefert eine kleine Webseite aus, die Temperatur und Luftfeuchte anzeigt und zwei Buttons zum Schalten des Relais bietet. Relais-Verkabelung: VCC an 5V, GND an G, IN an D1.

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

#define DHT_PIN    D2
#define DHT_TYP    DHT22
#define RELAIS_PIN D1

const char* WLAN_NAME     = "DEIN_WLAN_NAME";
const char* WLAN_PASSWORT = "DEIN_WLAN_PASSWORT";

DHT dht(DHT_PIN, DHT_TYP);
ESP8266WebServer server(80);
bool relaisAn = false;

String baueSeite() {
  float t = dht.readTemperature();
  float h = dht.readHumidity();

  String html = "<!DOCTYPE html><html><head>";
  html += "<meta charset='utf-8'>";
  html += "<meta name='viewport' content='width=device-width, initial-scale=1'>";
  html += "<meta http-equiv='refresh' content='10'>";
  html += "<title>D1 Mini Dashboard</title></head><body>";
  html += "<h1>D1 Mini Dashboard</h1>";
  html += "<p>Temperatur: " + String(t, 1) + " &deg;C</p>";
  html += "<p>Luftfeuchte: " + String(h, 1) + " %</p>";
  html += "<p>Relais ist: " + String(relaisAn ? "AN" : "AUS") + "</p>";
  html += "<p><a href='/an'>Relais AN</a> | <a href='/aus'>Relais AUS</a></p>";
  html += "</body></html>";
  return html;
}

void setup() {
  Serial.begin(115200);
  dht.begin();
  pinMode(RELAIS_PIN, OUTPUT);
  digitalWrite(RELAIS_PIN, LOW);

  WiFi.mode(WIFI_STA);
  WiFi.begin(WLAN_NAME, WLAN_PASSWORT);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println();
  Serial.print("Webserver erreichbar unter: http://");
  Serial.println(WiFi.localIP());

  server.on("/", []() { server.send(200, "text/html", baueSeite()); });
  server.on("/an", []() {
    relaisAn = true;
    digitalWrite(RELAIS_PIN, HIGH);
    server.sendHeader("Location", "/");
    server.send(303);
  });
  server.on("/aus", []() {
    relaisAn = false;
    digitalWrite(RELAIS_PIN, LOW);
    server.sendHeader("Location", "/");
    server.send(303);
  });
  server.begin();
}

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

Rufe die IP-Adresse aus dem seriellen Monitor im Browser auf deinem Handy oder PC auf (gleiches WLAN vorausgesetzt) – und du steuerst dein erstes IoT-Gerät. Die Seite aktualisiert die Messwerte alle 10 Sekunden automatisch.

Code 4: Strom sparen mit Deep Sleep

Für Batterie-Sensorknoten ist der Deep-Sleep-Modus Gold wert: Der ESP8266 wacht in festen Intervallen auf, misst, sendet und schläft weiter. Wichtig: Verbinde dafür D0 mit RST – ohne diese Brücke kann sich der Chip nicht selbst aufwecken. Zum Flashen die Brücke wieder trennen.

#include <ESP8266WiFi.h>

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

  Serial.println();
  Serial.println("Aufgewacht! Hier wuerde jetzt gemessen und gesendet.");

  // Hier: Sensor lesen, WLAN verbinden, Daten uebertragen ...

  Serial.println("Schlafe fuer 60 Sekunden...");
  ESP.deepSleep(60e6); // Mikrosekunden: 60e6 = 60 s
}

void loop() {
  // wird nie erreicht
}

Praxistipps

Troubleshooting