ES-109Anfänger

ESP32 Bluetooth Thermo-Hygrometer (DHT11)

Mit ESP32 und DHT11 siehst du Temperatur und Luftfeuchte live auf dem Handy: zwei Messfelder und ein Diagramm, alle 2 Sekunden neu, ganz ohne Internet. Dieses Projekt ist die Schritt-für-Schritt-Anleitung zur Bluetooth-Vorlage Temperatur und Luftfeuchte in der App. Geh zu Werkstatt › Geräte › Gerät hinzufügen › Bluetooth, wähl die Vorlage und lade den Code mit Code holen hoch. Die Taste Als Bluetooth-Panel einrichten auf dieser Seite öffnet den Assistenten direkt.

0.0(0)
ESP32 Bluetooth Thermo-Hygrometer (DHT11)
Wolltest du schon mal wissen, wie warm es in deinem Zimmer wirklich ist oder warum die Luft so schwer wirkt? In diesem Projekt schließt du einen kleinen DHT11-Sensor mit drei Kabeln an den ESP32 an, und das Board schickt Temperatur und Luftfeuchte alle 2 Sekunden per Bluetooth an dein Handy. In der App siehst du zwei Messfelder und ein Live-Diagramm, ohne Internet, Router oder Server. Die Einrichtung ist kurz: Gerät hinzufügen, Bluetooth, Vorlage Temperatur und Luftfeuchte wählen, mit Code holen hochladen, dann Board finden. Die Taste auf der Projektseite bringt dich direkt dorthin. Du lernst: Messen mit dem DHT11, Daten über Bluetooth Low Energy senden, Sensorfehler abfangen und einen Timer, der nie wartet.

Video

Schaltplan

ESP32 Bluetooth Thermo-Hygrometer (DHT11) - Schaltplan

Quellcode

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Hava                   │
5// └───────────────────────────┘
6// Temperatur und Luftfeuchte
7// Board in der Arduino IDE: ESP32 Dev Module
8// die BLE-Bibliothek kommt mit dem ESP32-Boardpaket, nichts extra zu installieren
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <DHT.h>  // Bibliotheksverwalter: 'DHT sensor library' (Adafruit)
14
15const char BLE_NAME[] = "BG-Hava";  // das Board sendet unter diesem Namen, die App findet es damit in der Liste
16
17// Pins: hier ändern, wenn du anders verkabelt hast
18const int DHT_PIN = 4;
19const unsigned long READ_EVERY_MS = 2000;  // alle 2 Sekunden wird ein neuer Messwert gesendet
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Die App sendet Zeilen im Format "Schlüssel=Wert"; bei "?" schickt das Board alle Werte ──
27char line[65];
28uint8_t lineLen = 0;
29unsigned long lastRxMs = 0;
30
31bool is(const char *a, const char *b) { return strcmp(a, b) == 0; }
32bool isOn(const char *v) { return v[0] == '1'; }
33
34void sendText(const char *key, const char *value) {
35  char out[72];
36  snprintf(out, sizeof(out), "%s=%s\n", key, value);
37  btWrite(out);
38}
39
40void sendInt(const char *key, long value) {
41  char text[12];
42  snprintf(text, sizeof(text), "%ld", value);
43  sendText(key, text);
44}
45
46void sendFloat(const char *key, float value) {
47  char text[16];
48  dtostrf(value, 1, 1, text);
49  sendText(key, text);
50}
51
52void handleLine(char *text) {
53  char *eq = strchr(text, '=');
54  if (eq == nullptr) {
55    if (text[strlen(text) - 1] == '?') {
56      btWrite("@v=1.0\n");  // die Zeile "@v" meldet der App die Codeversion
57      sendAll();
58    }
59    return;
60  }
61  *eq = '\0';
62  onValue(text, eq + 1);
63}
64
65void feed(char c) {
66  lastRxMs = millis();
67  if (c == '\n' || c == '\r') {
68    if (lineLen == 0) return;
69    line[lineLen] = '\0';
70    lineLen = 0;
71    handleLine(line);
72  } else if (lineLen < sizeof(line) - 1) {
73    line[lineLen++] = c;
74  }
75}
76
77// ── Bluetooth (Nordic UART) ──
78#define UART_SERVICE "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
79#define UART_RX "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
80#define UART_TX "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
81
82BLECharacteristic *txChar = nullptr;
83volatile bool linked = false;
84volatile bool linkLost = false;
85// eingehende Bytes gelangen über einen kleinen Ringpuffer vom Bluetooth-Task in loop()
86const int RX_SIZE = 256;
87volatile uint8_t rxBuf[RX_SIZE];
88volatile int rxHead = 0, rxTail = 0;
89
90class ServerEvents : public BLEServerCallbacks {
91  void onConnect(BLEServer *server) override { linked = true; }
92  void onDisconnect(BLEServer *server) override { linked = false; linkLost = true; }
93};
94
95class RxEvents : public BLECharacteristicCallbacks {
96  void onWrite(BLECharacteristic *c) override {
97    auto v = c->getValue();
98    for (size_t i = 0; i < v.length(); i++) {
99      int next = (rxHead + 1) % RX_SIZE;
100      if (next == rxTail) break;
101      rxBuf[rxHead] = (uint8_t)v[i];
102      rxHead = next;
103    }
104  }
105};
106
107// Zeilen gehen in 20-Byte-Paketen raus (klappt mit jedem Handy)
108void btWrite(const char *text) {
109  if (!linked || txChar == nullptr) return;
110  size_t n = strlen(text);
111  for (size_t i = 0; i < n; i += 20) {
112    size_t len = n - i < 20 ? n - i : 20;
113    txChar->setValue((uint8_t *)text + i, len);
114    txChar->notify();
115    delay(4);
116  }
117}
118
119void btBegin() {
120  BLEDevice::init(BLE_NAME);
121  BLEServer *server = BLEDevice::createServer();
122  server->setCallbacks(new ServerEvents());
123  BLEService *uart = server->createService(UART_SERVICE);
124  txChar = uart->createCharacteristic(UART_TX, BLECharacteristic::PROPERTY_NOTIFY);
125  txChar->addDescriptor(new BLE2902());
126  BLECharacteristic *rx = uart->createCharacteristic(UART_RX, BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_WRITE_NR);
127  rx->setCallbacks(new RxEvents());
128  uart->start();
129  BLEAdvertisementData adv;
130  adv.setFlags(0x06);
131  adv.setCompleteServices(BLEUUID(UART_SERVICE));
132  BLEAdvertisementData scan;
133  scan.setName(BLE_NAME);
134  BLEAdvertising *advertising = BLEDevice::getAdvertising();
135  advertising->setAdvertisementData(adv);
136  advertising->setScanResponseData(scan);
137  BLEDevice::startAdvertising();
138}
139
140void btPoll() {
141  while (rxTail != rxHead) {
142    char c = (char)rxBuf[rxTail];
143    rxTail = (rxTail + 1) % RX_SIZE;
144    feed(c);
145  }
146  if (linkLost) {
147    linkLost = false;
148    onLinkLost();
149    delay(100);
150    BLEDevice::startAdvertising();
151  }
152}
153
154// ── ESP32 ──
155DHT dht(DHT_PIN, DHT11);
156float temperature = NAN, humidity = NAN;
157unsigned long lastReadMs = 0;
158
159// kann der Sensor nicht gelesen werden, bekommt die App "@err=dht": prüfe die Kabel
160void readSensor() {
161  float t = dht.readTemperature();
162  float h = dht.readHumidity();
163  if (isnan(t) || isnan(h)) {
164    btWrite("@err=dht\n");
165    return;
166  }
167  temperature = t;
168  humidity = h;
169}
170
171void sendReadings() {
172  if (isnan(temperature)) return;
173  sendFloat("sicaklik", temperature);
174  sendInt("nem", lround(humidity));
175}
176
177void onValue(const char *key, const char *value) {
178}
179
180void sendAll() {
181  if (isnan(temperature)) readSensor();
182  sendReadings();
183}
184
185void onLinkLost() {
186}
187
188void setup() {
189  Serial.begin(115200);
190  dht.begin();
191  btBegin();
192  Serial.print(F("BlueGrays Bluetooth: "));
193  Serial.println(BLE_NAME);
194}
195
196void loop() {
197  btPoll();
198  if (millis() - lastReadMs >= READ_EVERY_MS) {
199    lastReadMs = millis();
200    readSensor();
201    sendReadings();
202  }
203}
204

FAQ

Funktioniert das auch mit dem iPhone?

Ja. Das Board nutzt das eingebaute Bluetooth Low Energy (BLE) des ESP32, und die BlueGrays-App verbindet sich damit auf iPhone und Android. Klassische Bluetooth-Module wie HC-05 oder HC-06 lassen sich nicht mit dem iPhone verbinden, deshalb verwendet dieses Projekt sie nicht. Versuch nicht, das Board in den Bluetooth-Einstellungen des Handys zu koppeln; die Verbindung baut nur die App auf.

Kann ich statt des DHT11 einen DHT22 nehmen?

Ja. Der DHT22 (AM2302) misst genauer und in einem größeren Bereich: etwa -40 bis 80 °C, ±0,5 °C. Die Verkabelung bleibt gleich. Die Vorlage in der App ist für den DHT11 gemacht, also ändere in der Zeile DHT dht(DHT_PIN, DHT11) das DHT11 in DHT22 und lade neu hoch. Die Diagrammskala im Panel ist auf den DHT11-Bereich (0 bis 50 °C) eingestellt.

Warum ändern sich die Werte nur alle 2 Sekunden, und wie genau sind sie?

Der DHT11 lässt sich höchstens einmal pro Sekunde auslesen, deshalb misst und sendet der Code mit READ_EVERY_MS = 2000 alle 2 Sekunden. Der Sensor misst 0 bis 50 °C und 20 bis 90 % Luftfeuchte, mit einer Abweichung von etwa ±2 °C und ±5 %. Für ein Zimmer reicht das; willst du es genauer, nimm einen DHT22.

Werden Messwerte gespeichert, wenn das Handy weg ist?

Nein. Das Board sendet nur den aktuellen Wert und speichert keinen Verlauf. Das Diagramm entsteht aus den Werten, die ankommen, solange das Panel offen und das Board verbunden ist; ist das Handy außer Reichweite oder die App geschlossen, kommen keine neuen Punkte dazu. Nach dem erneuten Verbinden sendet die App ? und das Board schickt sofort die letzten Werte.