ESP32 Bluetooth Temperatura e Umidade (DHT11)
Acompanhe ao vivo no celular a temperatura e a umidade do seu quarto com um ESP32 e um sensor DHT11: duas caixas de medida e um gráfico atualizados a cada 2 segundos, sem internet. Este projeto é o guia passo a passo do modelo Bluetooth Temperatura e umidade do app. Vá em Minha oficina › Dispositivos › Adicionar dispositivo › Bluetooth, escolha o modelo e envie o código com Pegar o código. O botão Configurar como painel Bluetooth desta página abre o assistente já pronto.

Vídeo
Esquema do circuito

Código-fonte
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Hava │
5// └───────────────────────────┘
6// Temperatura e umidade
7// Placa no Arduino IDE: ESP32 Dev Module
8// a biblioteca BLE vem com o pacote de placas ESP32, não precisa instalar nada a mais
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <DHT.h> // Gerenciador de bibliotecas: 'DHT sensor library' (Adafruit)
14
15const char BLE_NAME[] = "BG-Hava"; // a placa se anuncia com este nome e o app a encontra assim na lista
16
17// Pinos: mude aqui se você ligou de outro jeito
18const int DHT_PIN = 4;
19const unsigned long READ_EVERY_MS = 2000; // uma nova leitura é enviada a cada 2 segundos
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── O app envia linhas "chave=valor"; ao receber "?" a placa manda todos os valores ──
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"); // a linha "@v" informa ao app a versão do código
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// os bytes recebidos passam da tarefa Bluetooth para o loop() por um pequeno buffer circular
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// as linhas saem em pacotes de 20 bytes (funciona com qualquer celular)
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 o sensor não for lido, o app recebe "@err=dht": confira os fios
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}
204Perguntas frequentes
Funciona com iPhone?
Sim. A placa usa o Bluetooth Low Energy (BLE) embutido no ESP32, e o app BlueGrays se conecta tanto no iPhone quanto no Android. Módulos de Bluetooth clássico como o HC-05 ou o HC-06 não conseguem se conectar ao iPhone, por isso este projeto não usa esses módulos. Não tente parear a placa nas configurações de Bluetooth do celular; só o app faz a conexão.
Posso usar um DHT22 no lugar do DHT11?
Pode. O DHT22 (AM2302) mede com mais precisão e numa faixa maior: cerca de -40 a 80 °C, ±0,5 °C. A ligação é a mesma. O modelo do app é feito para o DHT11, então troque DHT11 por DHT22 na linha DHT dht(DHT_PIN, DHT11) e envie o código de novo. A escala do gráfico do painel está ajustada para a faixa do DHT11 (0 a 50 °C).
Por que os valores mudam a cada 2 segundos e qual a precisão?
O DHT11 não pode ser lido mais de uma vez por segundo, então o código mede e envia a cada 2 segundos com READ_EVERY_MS = 2000. O sensor mede de 0 a 50 °C e de 20 a 90 % de umidade, com erro de cerca de ±2 °C e ±5 % de umidade. Para acompanhar um cômodo é suficiente; se quiser mais precisão, passe para o DHT22.
As medidas ficam salvas quando o celular está longe?
Não. A placa só envia o valor do momento e não guarda histórico. O gráfico é desenhado com os valores que chegam enquanto o painel está aberto e a placa conectada; se o celular sair do alcance ou você fechar o app, nenhum ponto novo é adicionado. Ao reconectar, o app envia ? e a placa manda na hora os últimos valores.
