ESP32 per Handy steuern: BlueGrays IoT in 5 Schritten einrichten

ESP32 per Handy steuern heißt: Du schaltest ein Relais, eine LED oder einen Motor am Board mit dem Smartphone in deiner Tasche ein und aus und siehst Sensorwerte direkt auf dem Display. Ein schönerer Einstieg ins IoT ist kaum denkbar. Der ESP32 bringt 2,4-GHz-WLAN und Bluetooth schon mit, ein Zusatzmodul brauchst du also nicht. Die eigentliche Frage ist, welchen Weg du wählst. Für die ESP32-Steuerung per App kannst du einen eigenen Webserver programmieren, dich per Bluetooth verbinden oder einen Telegram-Bot aufsetzen. Auch Cloud-Dashboards wie Blynk und die Arduino IoT Cloud kommen in Frage. Jede Methode unterscheidet sich bei Einrichtungsaufwand, Reichweite und Einschränkungen.

In dieser Anleitung richtest du Schritt für Schritt den kürzesten Weg ein: die Funktion BlueGrays IoT in der BlueGrays-App. Den Code schreibt Ohmi für dich. Du baust nur die Schaltung auf und lädst den Code mit der Arduino IDE auf den ESP32. Das Board verbindet sich verschlüsselt mit dem BlueGrays-Server, deshalb müssen Handy und Board nicht im selben Netzwerk sein. Die Lampe zu Hause schaltest du so auch vom Büro aus über mobile Daten. Zuerst baust du mit einem Relais einen Lampenschalter. Danach ergänzt du einen DHT22 und holst Temperatur und Luftfeuchtigkeit als Live-Werte und Diagramme aufs Handy. Am Ende findest du einen Vergleich mit den anderen Methoden und eine Tabelle mit Lösungen für die häufigsten Fehler.

5 Wege, einen ESP32 per Handy zu steuern

• Lokaler Webserver: Der ESP32 liefert eine Webseite aus, und du rufst im Handy-Browser die IP-Adresse des Boards auf. Ein Konto brauchst du nicht, normalerweise klappt der Zugriff aber nur aus demselben WLAN. Details findest du im Beitrag ESP32 Async Web Server.
• Bluetooth Classic und BLE: Kein Internet, kein Router nötig, das Handy verbindet sich direkt mit dem Board. In Innenräumen liegt die Reichweite meist bei etwa 10 Metern. Beide Varianten erklären wir in der Anleitung ESP32 Bluetooth.
• Telegram-Bot: Du schickst dem Board Befehle per Nachricht und bekommst Benachrichtigungen zurück. Das funktioniert auch von unterwegs, bietet aber kein Dashboard mit Diagrammen oder Schiebereglern. Zur Einrichtung siehe ESP32 Telegram Bot.
• Cloud-Dashboards (Blynk, Arduino IoT Cloud): In der Webkonsole legst du Vorlagen und Variablen an, schreibst den Code selbst und gestaltest das Dashboard auf dem Handy selbst. Das ist flexibel, du musst dich aber in mehrere Oberflächen und Konzepte einarbeiten. Für Blynk gibt es die Blynk-ESP32-Anleitung.
• BlueGrays IoT: Du wählst in der App eine von 8 fertigen Vorlagen. Ohmi erstellt den Code mit deinen Pin-Einstellungen und deinem Geräteschlüssel. Schalter, Schieberegler, Farbwähler und Diagramme erscheinen auf dem Handy automatisch passend zur Vorlage. Du musst weder ein Dashboard gestalten noch einen Server aufsetzen.

Was du brauchst: Bauteile und Software

Wie funktioniert die ESP32-Steuerung per App?

Bei BlueGrays IoT verbinden sich Handy und ESP32 nicht direkt miteinander. Nach dem Einschalten verbindet sich das Board zuerst mit deinem 2,4-GHz-WLAN zu Hause. Dann baut es über Port 443 eine verschlüsselte WebSocket-Verbindung (TLS) zum BlueGrays-Server auf und hält sie dauerhaft offen. Die App auf dem Handy verbindet sich mit demselben Server. Tippst du auf den Lampenschalter, geht der Befehl vom Handy zum Server und vom Server zum Board. Weil die Verbindung schon steht, kommt er ohne Verzögerung an. Ein Temperaturwert vom Board nimmt denselben Weg in umgekehrter Richtung. Port 443 nutzen auch Websites. Deshalb brauchst du keine Portweiterleitung am Router, keinen eigenen Server und musst die IP-Adresse des Boards nicht kennen.

Was das Board beim Server ausweist, ist der Geräteschlüssel. Das ist ein geheimer Text, der mit bgd_ beginnt und von der App beim Anlegen des Geräts erzeugt wird. Das Board schickt den Schlüssel beim Verbindungsaufbau im Header mit. So leitet der Server Befehle vom Handy an das richtige Board weiter. Der Schlüssel wird nicht im seriellen Monitor ausgegeben. Bricht die Verbindung ab, versucht es die Bibliothek BlueGraysIoT selbst erneut, in wachsenden Abständen. Werte, die offline gemessen wurden, schickt sie nach dem Wiederverbinden, und nach einem Stromausfall stellt sie den letzten Zustand der Schalter wieder her. Es reicht, wenn Board und Handy Internet haben: Das Board hängt im WLAN zu Hause, das Handy kann in einer anderen Stadt im Mobilfunknetz sein.

Schaltung: Relaismodul an den ESP32 anschließen

Bei den Vorlagen Lampenschalter und Raumstation gelten diese Standard-Pins: Der IN-Pin des Relais kommt an GPIO26, der Datenpin des DHT22 an GPIO4. Im 3. Schritt der Einrichtung kannst du die Pins ändern. Die Pinbelegung deines Boards prüfst du mit dem Tool Pinout. Auf manchen Boards steht am 5-V-Pin VIN, auf anderen 5V.

BlueGrays IoT einrichten: die 5 Schritte in der App

Öffne in der App Werkstatt › Meine Geräte › Neues Gerät hinzufügen. Oben auf dem Bildschirm siehst du einen Zähler wie „Schritt 1 / 5“. Die ersten drei Schritte erledigst du am Handy, den vierten am Computer, den fünften wieder am Handy.

1. Board und Vorlage: Wähle bei „Welches Board hast du?“ den ESP32 und markiere bei „Was soll es tun?“ eine der 8 Vorlagen. Für den ersten Versuch eignen sich „Relais-Lampe“ oder die „Raumstation“ mit Sensor. Gib dem Gerät einen Namen, den du leicht wiedererkennst, etwa „Wohnzimmerlampe“.
2. Bauteile und Schaltung: Die Liste „Bauteile vorbereiten“ zeigt, was die Vorlage braucht. Der Plan „Kabel anschließen“ zeigt, welcher Anschluss an welchen Pin kommt. Bei Relais-Vorlagen siehst du die Warnung „Wenn du mit 230 V arbeitest, mach das mit jemandem, der sich auskennt. Teste zuerst mit einer LED.“
3. WLAN und Code: Gib Netzwerkname und Passwort deines WLANs ein. Der Name muss exakt stimmen und zum 2,4-GHz-Band gehören. Wenn du willst, ersetzt du unter „Anschluss-Pins“ GPIO26 und GPIO4 durch andere Pins. Tippe dann auf „Gerät erstellen und Code vorbereiten“. Ohmi erstellt den Code mit deinem Geräteschlüssel; mit „Code kopieren“ oder „Teilen“ bringst du ihn auf deinen Computer.
4. In die Arduino IDE hochladen: Du lädst den Code auf den ESP32. Die Teilschritte aus der App erklären wir im nächsten Abschnitt einzeln.
5. Verbindung: Der Bildschirm „Warte auf dein Board“ springt automatisch weiter, sobald sich das Board mit dem Server verbindet.

Schritt 4 und 5: Code hochladen und Verbindung prüfen

1. Installiere die Arduino IDE, falls sie noch fehlt. Die Schritte findest du im Beitrag Arduino IDE installieren.
2. Suche im Boardverwalter nach „esp32“ und installiere das esp32-Paket von Espressif. Du brauchst Version 3.x; ist noch die alte 2.x installiert, aktualisiere sie. Die Installation des Pakets steht auch im Beitrag Was ist der ESP32?.
3. Schließ das Board mit einem USB-Datenkabel an. Wähle unter Werkzeuge › Board das ESP32 Dev Module (oder dein Board-Modell) und unter Werkzeuge › Port den neu aufgetauchten Port. Erscheint kein Port, tausche das Kabel. Installiere danach je nach USB-Chip deines Boards den Treiber für CP210x oder CH340.
4. Suche im Bibliotheksverwalter nach BlueGraysIoT und klicke auf Installieren. Wenn nach Abhängigkeiten gefragt wird, wähle „Alle installieren“; so kommen auch WebSockets, ArduinoJson und DHT sensor library mit. Hängst du fest, hilft die Anleitung Arduino-Bibliothek hinzufügen.
5. Öffne einen neuen Sketch, lösche den Inhalt, füge den aus der App kopierten Code ein und klicke auf Hochladen. Bleibt das Ausgabefenster unten bei „Connecting…“ stehen, halte die BOOT-Taste am Board gedrückt. Sobald die Prozentangaben beim Schreiben erscheinen, lässt du los.
6. Öffne den seriellen Monitor und stelle die Baudrate auf 115200. Zuerst solltest du „Wi-Fi connected“ sehen, ein paar Sekunden später die Zeile „BlueGrays IoT: connected“.

Sobald im seriellen Monitor „connected“ erscheint, wechselt der Bildschirm „Warte auf dein Board“ auf dem Handy zu „Verbunden: Die Werte kommen jetzt live.“ Tippe nun auf den Lampenschalter: Du solltest das Klicken des Relais hören oder die LED leuchten sehen. Verbindet sich das Board nicht innerhalb von 2 Minuten, bittet dich die App, drei Dinge zu prüfen. Hast du das 2,4-GHz-Netz gewählt? Steht im seriellen Monitor „Wi-Fi connected“? Stimmt die Groß- und Kleinschreibung im Passwort? Kommt nicht einmal die erste Zeile, liegt das Problem beim WLAN. Dann hilft dir die Checkliste im Beitrag ESP32 verbindet sich nicht mit dem WLAN.

Erster Code: Lampe per Handy ein- und ausschalten

Der Code, den die App für die Vorlage „Relais-Lampe“ erstellt, sieht ungefähr so aus. Die drei obersten Zeilen sind bereits mit deinem Geräteschlüssel, deinem Netzwerknamen und deinem Passwort ausgefüllt; hier stehen Platzhalter. Der Rest ist kurz: eine Relaisfunktion, eine Schalterdefinition und ein einzeiliges loop().

1/*
2 * Salon lambası · BlueGrays IoT
3 * BlueGrays · bluegrays.com
4 * Bu kodu paylaşma: içinde cihaz anahtarın ve Wi-Fi şifren var.
5 * Do not share this code: it contains your device key and Wi-Fi password.
6 */
7
8#include <BlueGraysIoT.h>
9
10// Uygulama bu üç satırı senin bilgilerinle doldurur / The app fills these three lines with your details
11const char *DEVICE_KEY = "bgd_UYGULAMADAKI_ANAHTARIN";
12const char *WIFI_NAME = "EV_AGI_2_4_GHZ";
13const char *WIFI_PASSWORD = "WIFI_SIFREN";
14
15BlueGraysIoT bg(DEVICE_KEY);
16
17const int RELAY_PIN = 26;
18const bool RELAY_ACTIVE_LOW = true;  // çoğu röle modülü LOW ile çeker / most relay modules switch on LOW
19void setRelay(bool on) { digitalWrite(RELAY_PIN, (on != RELAY_ACTIVE_LOW) ? HIGH : LOW); }
20
21void setup() {
22  Serial.begin(115200);
23  pinMode(RELAY_PIN, OUTPUT);
24  setRelay(false);                  // açılışta lamba kapalı / lamp off at power-up
25  bg.onSwitch("lamba", setRelay);   // uygulamadaki "Lamba" anahtarı / the "Lamba" switch in the app
26  bg.setDebug(Serial);              // durum mesajları Seri Port Ekranı'na / status messages to the Serial Monitor
27  bg.setLanguage(BG_LANG_TR);
28  bg.begin(WIFI_NAME, WIFI_PASSWORD);
29}
30
31void loop() {
32  bg.loop();  // burada uzun delay() kullanma / avoid long delay() calls here
33}
34

Sensor ergänzen: Raumstation (Relais + DHT22)

Jetzt hängen wir einen DHT22 an dasselbe Board und schicken Daten ans Handy. Wählst du in der App die Vorlage „Raumstation“, bekommst du neben dem Lampenschalter auch Temperatur (°C) und Luftfeuchtigkeit (%) samt Diagrammen. Der DHT22 misst von -40 bis 80 °C mit etwa ±0,5 °C Genauigkeit. Die Luftfeuchtigkeit erfasst er im Bereich 0–100 %, und er lässt sich höchstens alle 2 Sekunden auslesen. Schließ den Datenpin an GPIO4, VCC an 3V3 und GND an GND an. Wie die DHT-Familie funktioniert, vergleichen wir im Beitrag DHT11 Temperatur- und Feuchtigkeitssensor.

1/*
2 * Oda istasyonu · BlueGrays IoT
3 * BlueGrays · bluegrays.com
4 * Bu kodu paylaşma: içinde cihaz anahtarın ve Wi-Fi şifren var.
5 * Do not share this code: it contains your device key and Wi-Fi password.
6 */
7
8#include <BlueGraysIoT.h>
9#include <DHT.h>
10
11const char *DEVICE_KEY = "bgd_UYGULAMADAKI_ANAHTARIN";
12const char *WIFI_NAME = "EV_AGI_2_4_GHZ";
13const char *WIFI_PASSWORD = "WIFI_SIFREN";
14
15BlueGraysIoT bg(DEVICE_KEY);
16
17const int RELAY_PIN = 26;
18const bool RELAY_ACTIVE_LOW = true;  // çoğu röle modülü LOW ile çeker / most relay modules switch on LOW
19void setRelay(bool on) { digitalWrite(RELAY_PIN, (on != RELAY_ACTIVE_LOW) ? HIGH : LOW); }
20DHT dht(4, DHT22);                   // DHT22 veri ucu GPIO4 / DHT22 data on GPIO4
21unsigned long lastReadMs = 0;
22
23void setup() {
24  Serial.begin(115200);
25  pinMode(RELAY_PIN, OUTPUT);
26  setRelay(false);
27  bg.onSwitch("lamba", setRelay);
28  dht.begin();
29  bg.setDeadband("sicaklik", 0.1);   // 0,1 °C değişmeden gönderme / send only after a 0.1 °C change
30  bg.setDeadband("nem", 1.0);        // %1 değişmeden gönderme / send only after a 1 % change
31  bg.setDebug(Serial);
32  bg.setLanguage(BG_LANG_TR);
33  bg.begin(WIFI_NAME, WIFI_PASSWORD);
34}
35
36void loop() {
37  bg.loop();  // burada uzun delay() kullanma / avoid long delay() calls here
38  if (millis() - lastReadMs >= 2000) {  // DHT22 en fazla 2 saniyede bir okunur / DHT22 reads at most every 2 s
39    lastReadMs = millis();
40    bg.send("sicaklik", dht.readTemperature());
41    bg.send("nem", dht.readHumidity());
42  }
43}
44

Der Relais-Teil ist identisch mit dem ersten Code; neu sind drei Dinge. Erstens die Zeile bg.send("sicaklik", dht.readTemperature()): Sie schickt einen Wert vom Board an die App, der erste Parameter ist der Name der Variable in der App. Zweitens die Zeile bg.setDeadband("sicaklik", 0.1). Sie legt die kleinste Änderung fest: Die Temperatur wird erst nach 0,1 °C Änderung erneut gesendet, bei der Luftfeuchtigkeit liegt die Schwelle bei 1 %. Drittens die Prüfung millis() - lastReadMs >= 2000 in loop. Der Sensor wird alle 2 Sekunden gelesen, dazwischen läuft bg.loop() ohne Wartezeit weiter. Die Bibliothek sendet einen Wert nur, wenn er sich ändert, und überschreitet nie das Tempo deines Plans. Zwischen zwei Sendungen derselben Variable liegen im Gratis-Plan mindestens 1 Sekunde, bei Premium mindestens 0,2 Sekunden. Diese Grenzen prüft der Server; Zahlen im Code zu ändern hebelt sie nicht aus. Bleibt die Raumtemperatur minutenlang bei 23,4 °C, sendet das Board nichts Neues, bei 23,5 °C geht eine einzige Nachricht raus. Bei lockerem Kabel oder fehlendem Pull-up ist der Messwert ungültig (NaN). Kommen keine Werte an, prüfe zuerst die Verbindung an GPIO4 und die Stromversorgung.

Was siehst du auf dem Handy?

• Status: Oben auf dem Gerätebildschirm steht Online oder Offline, darunter „Letzte Daten vor …“. Hier erkennst du als Erstes, ob das Board wirklich verbunden ist.
• Steuerelemente: Bei der Lampen-Vorlage erscheint ein Ein/Aus-Schalter. Die Vorlage RGB-LED-Streifen bietet Farbwähler, Helligkeit von 0–100 % und Effektauswahl. Bei der Vorhang-Vorlage gibt es einen Schieberegler für den Winkel von 0–180°.
• Live-Werte und Diagramme: Es gibt die Zeiträume 1 Std., 24 Std., 7 Tage und 30 Tage. In der 7- und 30-Tage-Ansicht siehst du Stundenmittelwerte. Im Diagramm stehen Minimum, Maximum und letzter Wert. Solange das Board verbunden bleibt, kommt jede Minute ein neuer Punkt hinzu.
• Code und Schlüssel: Den kompletten Code, den Geräteschlüssel und die WLAN-Daten findest du auch später hier. Musst du das Board neu programmieren, kopiere den Code von hier.
• Schlüssel erneuern: Nutze das, wenn jemand deinen Schlüssel gesehen hat oder du das Board getauscht hast. Der alte Schlüssel ist sofort ungültig, du musst nur einmal den neuen Code aufs Board laden.
• Gerät entfernen: Gerät und Diagrammverlauf werden gelöscht, dein Geräteplatz wird wieder frei.

Gratis und Premium: Wie viel kannst du nutzen?

Dein erstes Gerät ist kostenlos. Für einen Lampenschalter oder eine Raumstation mit einem ESP32 brauchst du nichts weiter. Bei der Raumstation sind Temperatur und Luftfeuchtigkeit zwei getrennte Variablen. Im Gratis-Plan kommen beide Live-Werte aufs Handy, einen Diagrammverlauf gibt es aber nur für eine Variable. Die Unterschiede der Pläne stehen unten; Details im Beitrag Was schaltet BlueGrays Premium frei?.

Vergleich mit anderen Methoden

Die richtige Wahl hängt von deinem Bedarf ab. Gibt es gar kein Internet, bleiben nur Bluetooth oder ein lokaler Webserver. BlueGrays IoT, Blynk und die Arduino IoT Cloud setzen voraus, dass Board und Handy online sind. Willst du die Oberfläche komplett selbst gestalten oder flexibel z. B. an Home Assistant anbinden, bieten ESP32 MQTT und Cloud-Dashboards mehr Möglichkeiten. BlueGrays IoT hat 8 fertige Vorlagen. Dafür kommen Schaltplan, Bauteilliste, Code und Handy-Oberfläche fertig und aufeinander abgestimmt. Beim Lernen sinkt so die Gefahr, irgendwo einen Fehler einzubauen.

Sicherheit: Schlüssel, WLAN-Passwort und Code

• Der Geräteschlüssel ist die Identität deines Boards. Wer den mit bgd_ beginnenden Schlüssel kennt, kann sich als dein Board ausgeben. Teile ihn deshalb nicht in Screenshots, Foren oder Chatgruppen.
• Das WLAN-Passwort bleibt auf dem Handy. Es wird nicht an den Server geschickt; der Netzwerkname wird dagegen mit dem Gerät gespeichert, damit der Code später wieder angezeigt werden kann. Im Code auf dem Board steht das Passwort aber im Klartext.
• Teile den Code nicht. Wie auch die App warnt, stehen im Code dein Geräteschlüssel und dein WLAN-Passwort. Willst du ihn in einem Forum zeigen, um Hilfe zu bekommen, lösche vorher die Zeilen DEVICE_KEY, WIFI_NAME und WIFI_PASSWORD.
• Die Verbindung ist verschlüsselt. Der Datenverkehr zwischen Board und Server läuft über Port 443 mit TLS, niemand im selben Netz kann die Befehle mitlesen.
• Im Zweifel den Schlüssel erneuern. Die Schaltfläche Schlüssel erneuern macht den alten Schlüssel sofort ungültig. Gibst du das Board weiter, erneuere ebenfalls den Schlüssel oder entferne das Gerät.

Häufige Fehler und Lösungen

IoT-Projektideen mit dem ESP32

• Lampenschalter: Die komplette Version der ersten Schaltung aus diesem Beitrag findest du im Projekt ESP32 IoT Lampenschalter (Relais). Es kommt mit Schaltplan und Bauteilliste.
• Raumstation: Relais und DHT22 kombiniert, mit Temperaturdiagramm: ESP32 IoT Raumstation (Relais + DHT22).
• Pflanzenbewässerung: Der Bodenfeuchtesensor kommt an GPIO34 (ein ADC1-Pin). Fällt die Feuchtigkeit unter den Schieberegler Bewässerungsschwelle auf dem Handy, schaltet die Pumpe ein; liegt sie 10 Punkte über der Schwelle, schaltet sie ab. Projektseite: ESP32 IoT Pflanzenbewässerung (Feuchtesensor + Pumpe). Zur Kalibrierung lies auch den Beitrag Bodenfeuchtesensor.
• RGB-LED-Streifen: Farbe, Helligkeit und Effekt (Statisch, Regenbogen, Atmen, Blinken) eines WS2812B-Streifens mit 30 LEDs an GPIO13 wählst du per Handy: ESP32 IoT RGB-LED-Streifen (WS2812B). 30 LEDs können bei vollem Weiß etwa 1,8 A ziehen; versorge den Streifen aus einer separaten 5-V-Quelle. Details im Beitrag WS2812B NeoPixel.
• Vorhangöffner: Den SG90-Servo an GPIO18 drehst du mit einem Schieberegler von 0–180°: ESP32 IoT Vorhangöffner (SG90 Servo). Versorge auch den Servo aus einer separaten 5-V-Quelle und verbinde die GNDs.
• Weitere Vorlagen: Die Projekte Türsensor, Bewegungszähler und Temperatur und Luftfeuchtigkeit sind mit dem Pico W erklärt. In der App kannst du diese Vorlagen aber auch für den ESP32 wählen.

Hast du den Weg zwischen Board, Server und Handy einmal eingerichtet, ist ein neues Gerät in wenigen Minuten hinzugefügt. Fang mit dem Lampenschalter an, sieh dann mit dem DHT22, wie die Daten aufs Handy fließen, und wag dich danach an größere Projekte wie Bewässerung oder Vorhang. In der BlueGrays-App findest du diese ESP32-IoT-Projekte Schritt für Schritt mit Schaltplan und Code. Nutze im Tab Entdecken den Filter für IoT-Projekte, oder verbinde dieselbe Schaltung über die Karte „Als IoT-Gerät einrichten“ auf der Projektseite direkt mit deinem Handy.