ES-109Principiante

ESP32 Bluetooth Temperatura e Umidità (DHT11)

Segui dal vivo sul telefono temperatura e umidità con un ESP32 e un DHT11: due riquadri di misura e un grafico aggiornati ogni 2 secondi, senza internet. Questo progetto è la guida passo passo del modello Bluetooth Temperatura e umidità dell'app. Vai su La Mia Officina › Dispositivi › Aggiungi dispositivo › Bluetooth, scegli il modello e carica il codice con Ottieni il codice. Il pulsante Configura come pannello Bluetooth di questa pagina apre la procedura già pronta.

0.0(0)
ESP32 Bluetooth Temperatura e Umidità (DHT11)
Ti sei mai chiesto quanti gradi ci sono davvero nella tua stanza, o perché l'aria sembra pesante? In questo progetto colleghi un piccolo sensore DHT11 all'ESP32 con tre fili, e la scheda manda temperatura e umidità al telefono via Bluetooth ogni 2 secondi. Nell'app compaiono due riquadri di misura e un grafico dal vivo; non servono internet, router o server. Bastano pochi passi: Aggiungi dispositivo, Bluetooth, scegli il modello Temperatura e umidità, carica con Ottieni il codice e poi trova la tua scheda. Il pulsante nella pagina del progetto apre subito questo pannello. Impari: misurare con il DHT11, inviare dati via Bluetooth Low Energy, intercettare gli errori del sensore e un timer che non aspetta mai.

Video

Schema circuito

ESP32 Bluetooth Temperatura e Umidità (DHT11) - Schema circuito

Codice sorgente

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Hava                   │
5// └───────────────────────────┘
6// Temperatura e umidità
7// Scheda in Arduino IDE: ESP32 Dev Module
8// la libreria BLE arriva con il pacchetto schede ESP32, niente da installare in più
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <DHT.h>  // Gestore librerie: 'DHT sensor library' (Adafruit)
14
15const char BLE_NAME[] = "BG-Hava";  // la scheda si annuncia con questo nome e l’app la trova così nell’elenco
16
17// Pin: cambiali qui se hai collegato in modo diverso
18const int DHT_PIN = 4;
19const unsigned long READ_EVERY_MS = 2000;  // ogni 2 secondi parte una nuova lettura
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── L’app invia righe "chiave=valore"; con "?" la scheda manda tutti i suoi valori ──
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");  // la riga "@v" comunica all’app la versione del codice
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// i byte in arrivo passano dal task Bluetooth a loop() tramite un piccolo buffer circolare
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// le righe partono in pacchetti da 20 byte (funziona con ogni telefono)
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// se il sensore non si legge, l’app riceve "@err=dht": controlla i collegamenti
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

Funziona anche con l'iPhone?

Sì. La scheda usa il Bluetooth Low Energy (BLE) integrato dell'ESP32, e l'app BlueGrays si collega sia su iPhone sia su Android. I moduli Bluetooth classici come HC-05 o HC-06 non possono collegarsi a un iPhone, per questo il progetto non li usa. Non provare ad associare la scheda dalle impostazioni Bluetooth del telefono; la connessione la crea solo l'app.

Posso usare un DHT22 al posto del DHT11?

Sì. Il DHT22 (AM2302) misura in modo più preciso e su un intervallo più ampio: circa da -40 a 80 °C, ±0,5 °C. I collegamenti restano uguali. Il modello dell'app è pensato per il DHT11, quindi nella riga DHT dht(DHT_PIN, DHT11) cambia DHT11 in DHT22 e carica di nuovo. La scala del grafico nel pannello è impostata sull'intervallo del DHT11 (da 0 a 50 °C).

Perché i valori cambiano ogni 2 secondi e quanto sono precisi?

Il DHT11 non si può leggere più di una volta al secondo, quindi il codice misura e invia ogni 2 secondi con READ_EVERY_MS = 2000. Il sensore misura da 0 a 50 °C e dal 20 al 90 % di umidità, con un errore di circa ±2 °C e ±5 % di umidità. Per tenere d'occhio una stanza basta; se vuoi più precisione, passa al DHT22.

Le misure vengono salvate quando il telefono è lontano?

No. La scheda invia solo il valore del momento e non conserva lo storico. Il grafico si disegna con i valori che arrivano finché il pannello è aperto e la scheda è collegata; se il telefono esce dal raggio o chiudi l'app, non si aggiungono nuovi punti. Quando ti ricolleghi, l'app invia ? e la scheda manda subito gli ultimi valori.