ES-109초급

ESP32 Bluetooth 온도와 습도 (DHT11)

ESP32와 DHT11 센서로 방의 온도와 습도를 휴대폰에서 실시간으로 봐요. 측정값 상자 두 개와 차트가 2초마다 바뀌고, 인터넷이 필요 없어요. 이 프로젝트는 앱의 온도와 습도 Bluetooth 템플릿을 단계별로 안내하는 가이드예요. 내 작업실 › 내 기기 › 기기 추가 › Bluetooth로 가서 템플릿을 고르고 코드 받기로 코드를 업로드하세요. 이 페이지의 Bluetooth 패널로 설정 버튼을 누르면 마법사가 준비된 상태로 열려요.

0.0(0)
ESP32 Bluetooth 온도와 습도 (DHT11)
방이 실제로 얼마나 따뜻한지, 공기가 왜 답답하게 느껴지는지 궁금했던 적 있어요? 이 프로젝트에서는 작은 DHT11 센서를 전선 3가닥으로 ESP32에 연결하고, 보드가 2초마다 온도와 습도를 Bluetooth로 휴대폰에 보내요. 앱에는 측정값 상자 두 개와 실시간 차트가 나오고, 인터넷, 공유기, 서버가 필요 없어요. 설정도 짧아요. 기기 추가, Bluetooth, 온도와 습도 템플릿을 고르고, 코드 받기로 업로드한 다음 보드를 찾으세요. 프로젝트 페이지의 버튼을 누르면 이 패널 설정으로 바로 가요. 배우는 것: DHT11로 측정하기, Bluetooth Low Energy로 데이터 보내기, 센서 오류 잡기, 기다리지 않는 타이머.

동영상

회로도

ESP32 Bluetooth 온도와 습도 (DHT11) - 회로도

소스 코드

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Hava                   │
5// └───────────────────────────┘
6// Temperature and humidity
7// Arduino IDE board: ESP32 Dev Module
8// the BLE library comes with the ESP32 board package, nothing extra to install
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <DHT.h>  // Library Manager: 'DHT sensor library' (Adafruit)
14
15const char BLE_NAME[] = "BG-Hava";  // the board advertises with this name, the app finds it in the list by it
16
17// Pins: change them here if you wired differently
18const int DHT_PIN = 4;
19const unsigned long READ_EVERY_MS = 2000;  // a new reading is sent every 2 seconds
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── The app sends "key=value" lines; on "?" the board sends all its values ──
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");  // the "@v" line tells the app the code version
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// incoming bytes move from the Bluetooth task to loop() through a small ring buffer
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// lines go out in 20-byte packets (works with every phone)
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// if the sensor can't be read the app gets "@err=dht": check the wiring
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

iPhone에서도 돼요?

네. 보드는 ESP32의 내장 Bluetooth Low Energy(BLE)를 쓰고, BlueGrays 앱이 iPhone과 Android 모두에서 보드에 연결해요. HC-05나 HC-06 같은 클래식 Bluetooth 모듈은 iPhone에 연결할 수 없어서 이 프로젝트에서는 쓰지 않아요. 휴대폰의 Bluetooth 설정에서 보드를 페어링하려고 하지 마세요. 연결은 앱만 해요.

DHT11 대신 DHT22를 써도 돼요?

네. DHT22(AM2302)는 더 넓은 범위를 더 정확하게 재요. 약 -40~80 °C, ±0.5 °C예요. 배선은 그대로예요. 앱의 템플릿은 DHT11용이니 DHT dht(DHT_PIN, DHT11) 줄에서 DHT11을 DHT22로 바꾸고 다시 업로드하세요. 패널의 차트 눈금은 DHT11 범위(0~50 °C)에 맞춰져 있어요.

값이 왜 2초마다만 바뀌고, 얼마나 정확해요?

DHT11은 1초에 한 번보다 자주 읽을 수 없어서, 코드는 READ_EVERY_MS = 2000으로 2초마다 재고 보내요. 센서 범위는 0~50 °C, 습도 20%~90%이고, 오차는 약 ±2 °C, 습도 ±5%예요. 방을 지켜보기에는 충분해요. 더 정확하게 재려면 DHT22로 바꾸세요.

휴대폰이 멀리 있는 동안의 측정값도 저장돼요?

아니요. 보드는 지금 값만 보내고 기록은 남기지 않아요. 차트는 패널이 열려 있고 보드가 연결된 동안 들어온 값으로 그려요. 휴대폰이 범위를 벗어나거나 앱을 닫으면 새 점이 추가되지 않아요. 다시 연결하면 앱이 ?를 보내고 보드가 최신 값을 바로 보내요.