NodeMCU ESP8266 Einführungstutorial

Vor ein paar Wochen habe ich mir einen NodeMCU ESP8266 bestellt, der nun endlich angekommen ist. Da sich dieses Entwicklungsboard aufgrund seines WLAN-Chips bestens für IoT- und Smarthome-Projekte eignet und es deswegen zukünftig öfter bei Projekten auf smarthome-blogger.de verwende wird, möchte ich dir im heutigen Artikel eine kurze Einführung zur Programmierung des ESP8266 mit der Arduino IDE geben. Du kannst den ESP 8266 auch mit der Programmiersprache LUA programmieren - wir beschränken uns jedoch auf C++. In diesem NodeMCU ESP8266 Tutorial erwartet dich folgendes: Zuerst wird eine LED in einer Endlosschleife eingeschaltet, nach einer Sekunde wieder ausgeschaltet und eine Sekunde gewartet. Im zweiten Skript wird die LED über ein Webinterface geschaltet.

Benötigte Komponenten für das Tutorial

• NodeMCU ESP8266
• LED's (Affiliatelink)
• Female-Female Jumper-Kabel (Affiliatelink)
• microUSB-Kabel (Affiliatelink)
• optional: aktiver USB-Hub (Affiliatelink)

NodeMCU ESP8266 Einführung als Video

Schaltung des NodeMCU ESP8266

Bevor mit der Programmierung des NodeMCU ESP8266 begonnen wird, muss zuerst noch die Testschaltung aufgebaut werden. Dabei wird der Pin "D7" mit der Anode der LED verbunden (das längere Bein) und der Pin "GND" wird mit der Kathode - also dem kürzeren Bein - der LED verbunden. Je nach der verwendeten LED solltest du eventuell noch einen Widerstand zwischen den Pin "D7" und die Anode der LED schalten, um Schäden an der LED zu vermeiden. Um den ESP8266 mit Software zu beschreiben, verbindest du ihn mit einem microUSB-Kabel mit deinem PC. Ein aktiver USB-Hub kann hier eine große Hilfe sein, falls die Stromversorgung allein über den USB-Port deines Computers nicht genug ist.

So sieht die erste Schaltung aus.

Arduino IDE

Um den NodeMCU zu programmieren, wird eine Entwicklungsumgebung benötigt. Dazu kannst du dir die Arduino IDE von arduino.cc herunterladen. Nach dem Download wird die Arduino IDE noch installiert.

Jetzt wird die Arduino IDE installiert.

Hier wird die URL eingefügt.

Zuletzt wird der NodeMCU installiert.

Die Konfiguration der Arduino IDE für den ESP8266.

Das erste Skript: Blinken in Dauerschleife

Jetzt kannst du den NodeMCU ESP8266 programmieren. Ein Arduino Programm besteht grundsätzlich aus den zwei Methoden setup() und loop(). Die setup-Methode wird beim Programmstart einmal aufgerufen und die loop-Methode wie der Name schon sagt, in einer Dauerschleife abgelaufen. In diesem ersten Skript wird in der setup-Methode der Modus des Pins gesetzt und in der loop-Methode damit eine LED eingeschaltet, nach einer Sekunde ausgeschaltet und eine Sekunde gewartet. Die Zeit die gewartet werden soll kannst du ganz einfach variieren, indem du in Zeile 9 und/oder Zeile 11 die Zahl 1000 änderst. Die Zahl gibt an, wie viele Millisekunden gewartet werden soll, bis die nächste Zeile ausgeführt wird. Trage diesen Code in den Editor der Arduino IDE ein.

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

void loop() {
	digitalWrite(13, HIGH);
	delay(1000);
	digitalWrite(13, LOW);
	delay(1000);
}

Um den Code nun auf den NodeMCU ESP8266 zu schreiben, klickst du in der Leiste oben bei "Sketch" auf "Hochladen". Nun wird der Code kompiliert und anschließend auf das Board geschrieben, soweit esbei der Kompilierung keine Fehler gab. Während des Uploads wird der Fortschritt im Arduino IDE-Fenster rot angezeigt und die blaue LED auf deinem ESP8266 sollte schnell blinken.

Der Upload ist nun abgeschlossen.

Fortgeschrittenes Skript: LED per Internet schalten

Das forgeschrittene Skript besitzt die zwei Konstanten "SSID" und "PSK", wobei "SSID" der Name des Netzwerks ist, mit dem sich der ESP8266 verbinden soll und "PSK" das Passwort des jeweiligen Netzwerks. In der setup-Methode wird lediglich der Modus des Pins 13 auf "Output" gesetzt und die Methode "initWiFi()" aufgerufen. Diese Methode verbindet sich mit dem angegebenen Netzwerk und startet den Server zur Schaltung der LED, sobald die Verbindung besteht. In der loop-Methode wird zuerst geprüft, ob sich jemand mit dem Server verbunden hat. Ist das nicht der Fall, so wird dieser Methodendurchlauf abgebrochen. Anschließend wird geprüft, ob die Netzverbindung immernoch besteht und gegebenenfalls erneut die Methode "initWiFi()" aufgerufen. Wenn die Verbindung hergestellt ist und jemand auf den Server zugreift, wird der HTTP-Request gelesen und der Durchlauf abgebrochen, falls er leer ist. Andernfalls wird geprüft, ob er ein Schlüsselwort zum Ein- bzw. Ausschalten der LED enthält und die LED entsprechend ein- bzw. ausgeschaltet. Anschließend wird ein HTML-Dokument erstellt und ausgegeben. Dieses HTML-Dokument besteht aus dem Text "LED schalten" und 2 Buttons, die bei einem Klick den HTTP-Request an den Server senden, der die LED ein- bzw. ausschaltet.

#include <ESP8266WiFi.h>

const char* SSID = "NETZWERKNAME";
const char* PSK = "PASSWORT";

WiFiServer server(80);

void setup() {
	pinMode(13, OUTPUT);
	initWiFi();
}

void loop() {
	WiFiClient client = server.available();
	if(!client){
		return;
	}
	
	if(WiFi.status() != WL_CONNECTED){
		initWiFi(); 
	}
	
	String request = client.readStringUntil('\r');
	client.flush();
	if(request==""){
		client.stop();
		return;
	}

	//GPIOS schalten
	if(request.indexOf("mode=1")>=0){
		digitalWrite(13, 1);
	}
	
	else if(request.indexOf("mode=0")>=0){
		digitalWrite(13, 0);
	}

	//Ausgabe erzeugen
	String output;
	output += "<h1>LED schalten</h1>";
	output += "<form action=\"\" method=\"GET\">";
	output += "<button name=\"\mode" value=\"1\">AN</button>";
	output += "<br><br>";
	output += "<button name=\"\mode" value=\"0\">AUS</button>";
	output += "</form>";
	client.print(output);
	client.stop();
}

void initWiFi(){
	WiFi.begin(SSID, PSK);
	
	while(WiFi.status() != WL_CONNECTED){
		delay(500);
	}
	
	server.begin();
}

Dieses Programm flasht du genau so wie das erste auf den ESP8266. Wenn es vollständig hochgeladen ist, rufst du mit einem Browser die IP-Adresse des NodeMCU auf und solltest anschließend die folgende Ausgabe erhalten:

Der ESP8266 sollte diese Ausgabe anzeigen.

Weitere Projekte mit dem NodeMCU ESP8266

Der ESP 8266 ermöglicht viele weitere spannende Projekte im Smarthome Bereich. Man kann zum Beispiel einen Temperatur Sensor bauen oder Daten per MQTT an einen Raspberry Pi senden.