ES-108Початківець

Світлодіод і реле через Bluetooth на ESP32

Вмикай і вимикай LED та реле з телефона через Bluetooth, без інтернету й Wi-Fi. Цей проєкт є покроковим посібником до Bluetooth-шаблону Світлодіод і реле в застосунку, зібраного на ESP32 і модулі реле на 5 V. Перейди в Майстерня › Пристрої › Додати пристрій › Bluetooth, вибери «Світлодіод і реле» й завантаж код через Отримати код. Кнопка Налаштувати як панель Bluetooth на цій сторінці теж відкриває майстер із цим шаблоном.

0.0(0)
Світлодіод і реле через Bluetooth на ESP32
Натисни перемикач на телефоні, і реле на столі клацне: між ними немає ні інтернету, ні роутера, ні сервера. В ESP32 вбудовано Bluetooth, тож телефон під’єднується прямо до плати, а два перемикачі на панелі керують світлодіодом і реле. Коли панель відкривається, плата повідомляє свій справжній стан, тож на екрані видно саме те, що робить плата. У застосунку додай новий пристрій, вибери Bluetooth і шаблон «Світлодіод і реле», завантаж код через «Отримати код», потім знайди свою плату в списку. Кнопка на цій сторінці веде до того ж налаштування. Що вивчиш: обмін короткими текстовими рядками через Bluetooth Low Energy, реле, що вмикається сигналом LOW, і плату, яка повідомляє свій стан панелі. Примітка щодо реле: ця плата працює від 3,3 V. Використовуй модуль реле з оптопарою, який спрацьовує від сигналу 3,3 V; модулі на 5 V без оптопари можуть не вимикатися сигналом 3,3 V.

Відео

Схема

Світлодіод і реле через Bluetooth на ESP32 - Схема

Вихідний код

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Lamba                  │
5// └───────────────────────────┘
6// LED and relay
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
14const char BLE_NAME[] = "BG-Lamba";  // the board advertises with this name, the app finds it in the list by it
15
16// Pins: change them here if you wired differently
17const int LED_PIN = 2;
18const int RELAY_PIN = 26;
19const bool RELAY_ACTIVE_LOW = true;  // most relay modules switch on LOW
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 ──
155bool ledOn = false, relayOn = false;
156
157void setRelay(bool on) {
158  if (RELAY_ACTIVE_LOW) {
159    if (on) { pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, LOW); }
160    else { pinMode(RELAY_PIN, INPUT); }  // off releases the pin: a 3.3 V HIGH is not enough to turn a 5 V module off
161  } else {
162    pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, on ? HIGH : LOW);
163  }
164}
165
166void apply() {
167  digitalWrite(LED_PIN, ledOn ? HIGH : LOW);
168  setRelay(relayOn);
169}
170
171void onValue(const char *key, const char *value) {
172  if (is(key, "led")) ledOn = isOn(value);
173  else if (is(key, "role")) relayOn = isOn(value);
174  apply();
175}
176
177void sendAll() {
178  sendInt("led", ledOn);
179  sendInt("role", relayOn);
180}
181
182void onLinkLost() {
183}
184
185void setup() {
186  Serial.begin(115200);
187  pinMode(LED_PIN, OUTPUT);
188  apply();
189  btBegin();
190  Serial.print(F("BlueGrays Bluetooth: "));
191  Serial.println(BLE_NAME);
192}
193
194void loop() {
195  btPoll();
196}
197

Поширені запитання

Чи працює це з iPhone?

Так. Вбудований Bluetooth Low Energy (BLE) плати ESP32 працює і з iPhone, і з Android. iPhone не може під’єднатися до класичних модулів Bluetooth, як-от HC-05 і HC-06, і цьому проєкту вони не потрібні. Не намагайся з’єднати плату в налаштуваннях Bluetooth телефона; BLE-плати можуть там не з’являтися, і це нормально. З’єднання встановлює застосунок BlueGrays.

Чи можна під’єднати до реле справжню лампу?

Модуль реле може перемикати мережеву напругу, але мережева напруга може вбити. У цьому проєкті до контактів COM і NO реле нічого не під’єднано; реле показує, що працює, клацанням і світлодіодом на модулі. Якщо хочеш спробувати навантаження, почни з низьковольтного кола, наприклад з батарейки чи адаптера 12 V. Якщо переходиш на мережу, роби це з досвідченою людиною, не залишай відкритих оголених дротів чи гвинтів і не перевищуй струм, вказаний на модулі.

Чому синій світлодіод на платі світиться разом із моїм світлодіодом?

На багатьох платах ESP32 DevKit синій вбудований світлодіод теж під’єднано до GPIO2. Твій світлодіод на тому ж піні, тож обидва блимають разом; це не несправність. Це навіть зручно: якщо дріт відійшов, синій світлодіод однаково показує, що команда дійшла до плати. Якщо це не потрібно, перенеси свій світлодіод на інший пін (наприклад, GPIO4) і зміни LED_PIN у коді.

Чи потрібен інтернет або Wi-Fi і яка дальність?

Ні. Телефон під’єднується прямо до плати через Bluetooth, без роутера чи сервера. У приміщенні дальність зазвичай близько 10 м, а стіни її зменшують. Плата з’єднується з одним телефоном за раз; коли цей телефон відходить, плата знову починає оголошувати себе, і може під’єднатися інший телефон. Щоб керувати поза домом, вибери проєкт, що використовує панель Wi-Fi IoT у застосунку.