ES-110Средний

ESP32 Bluetooth RGB-лента (WS2812B)

Меняй цвет, яркость и эффект ленты прямо с телефона: ESP32 подключается к нему напрямую через встроенный Bluetooth, а ленте WS2812B хватает трёх проводов. Это пошаговое руководство к Bluetooth-шаблону RGB-лента в приложении. Открой Мастерская › Устройства › Добавить устройство › Bluetooth, выбери шаблон «RGB-лента» и загрузи код в плату через Получить код. Кнопка Настроить как Bluetooth-панель на этой странице открывает мастер сразу с этим шаблоном.

0.0(0)
1 собрано
ESP32 Bluetooth RGB-лента (WS2812B)
Хочешь раскрашивать свет в комнате с телефона? Здесь ESP32 подключается к телефону напрямую по Bluetooth, так что интернет, роутер и сервер не нужны. На панели ты включаешь и выключаешь ленту, выбираешь любой цвет, двигаешь ползунок яркости и запускаешь эффект вроде радуги или дыхания. В приложении открой Мастерская › Устройства › Добавить устройство › Bluetooth, выбери шаблон RGB-лента, загрузи код через Получить код и подключись на шаге Найди свою плату. Кнопка Настроить как Bluetooth-панель на этой странице открывает мастер с тем же шаблоном. Чему научишься: построчные команды по Bluetooth Low Energy, управление лентой WS2812B через Adafruit NeoPixel, гамма-коррекция и плавные анимации эффектов.

Видео

Схема

ESP32 Bluetooth RGB-лента (WS2812B) - Схема

Исходный код

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Isik                   │
5// └───────────────────────────┘
6// RGB-лента
7// Плата в Arduino IDE: ESP32 Dev Module
8// библиотека BLE входит в пакет плат ESP32, ничего дополнительно ставить не нужно
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <Adafruit_NeoPixel.h>  // Менеджер библиотек: 'Adafruit NeoPixel'
14
15const char BLE_NAME[] = "BG-Isik";  // плата вещает под этим именем, приложение находит её в списке по нему
16
17// Пины: измени их здесь, если подключал иначе
18const int STRIP_PIN = 5;
19const int LED_COUNT = 30;  // количество светодиодов на твоей ленте
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Приложение шлёт строки «ключ=значение»; на «?» плата отправляет все свои значения ──
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");  // строка «@v» сообщает приложению версию кода
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// входящие байты попадают из задачи Bluetooth в 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// строки уходят пакетами по 20 байт (работает с любым телефоном)
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 ──
155Adafruit_NeoPixel strip(LED_COUNT, STRIP_PIN, NEO_GRB + NEO_KHZ800);
156bool stripOn = false;
157uint8_t cr = 255, cg = 255, cb = 255;
158int brightness = 70;
159char effect[16] = "sabit";
160uint16_t hue = 0;
161unsigned long lastFrameMs = 0;
162
163uint8_t level() { return map(brightness, 0, 100, 0, 255); }
164
165// гамма-коррекция: цвета на ленте ближе к цветам на экране
166void fillColor(uint32_t color, uint8_t bright) {
167  strip.setBrightness(bright);
168  strip.fill(strip.gamma32(color));
169  strip.show();
170}
171
172void paint() {
173  if (!stripOn) { strip.clear(); strip.show(); return; }
174  fillColor(strip.Color(cr, cg, cb), level());
175}
176
177void onValue(const char *key, const char *value) {
178  if (is(key, "acik")) {
179    stripOn = isOn(value);
180  } else if (is(key, "renk") && value[0] == '#' && strlen(value) == 7) {
181    long c = strtol(value + 1, nullptr, 16);
182    cr = c >> 16; cg = (c >> 8) & 0xFF; cb = c & 0xFF;
183  } else if (is(key, "parlaklik")) {
184    brightness = constrain(atoi(value), 0, 100);
185  } else if (is(key, "efekt")) {
186    strncpy(effect, value, sizeof(effect) - 1);
187  }
188  paint();
189}
190
191void sendAll() {
192  char hex[8];
193  snprintf(hex, sizeof(hex), "#%02X%02X%02X", cr, cg, cb);
194  sendInt("acik", stripOn);
195  sendText("renk", hex);
196  sendInt("parlaklik", brightness);
197  sendText("efekt", effect);
198}
199
200void onLinkLost() {
201}
202
203void setup() {
204  Serial.begin(115200);
205  strip.begin();
206  paint();
207  btBegin();
208  Serial.print(F("BlueGrays Bluetooth: "));
209  Serial.println(BLE_NAME);
210}
211
212void loop() {
213  btPoll();
214  if (stripOn && !is(effect, "sabit")) {
215    // эффект на миг замирает, пока приходит команда (во время записи в ленту прерывания выключены)
216    if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217      lastFrameMs = millis();
218      if (is(effect, "gokkusagi")) {  // радуга бежит по ленте
219        hue += 512;
220        strip.setBrightness(level());
221        for (int i = 0; i < LED_COUNT; i++) strip.setPixelColor(i, strip.gamma32(strip.ColorHSV(hue + i * 65536L / LED_COUNT)));
222        strip.show();
223      } else if (is(effect, "nefes")) {  // плавно гаснет и снова загорается
224        float wave = (sin(millis() / 600.0) + 1.0) / 2.0;
225        fillColor(strip.Color(cr, cg, cb), level() * (0.15 + 0.85 * wave));
226      } else if (is(effect, "yanip_sonme")) {  // мигает каждые полсекунды
227        fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228      } else if (is(effect, "renk_dongusu")) {  // вся лента одного цвета, плавная смена оттенка
229        hue += 128;
230        fillColor(strip.ColorHSV(hue), level());
231      }
232    }
233  }
234}
235

Частые вопросы

Это работает с iPhone?

Да. В проекте используется встроенный Bluetooth Low Energy (BLE) платы ESP32, а он работает и на iPhone, и на Android. iPhone не умеет подключаться к модулям классического Bluetooth вроде HC-05 или HC-06, поэтому отдельного модуля здесь нет. Не пытайся сопрягать плату в настройках Bluetooth телефона: соединение устанавливает только приложение BlueGrays.

Сколько светодиодов можно подключить и какой нужен блок питания?

Каждый светодиод на полном белом потребляет до 60 mA, значит 30 штук дают около 1,8 A. USB-порт компьютера столько не выдаст, поэтому для короткой проверки от USB держи яркость около 20. Для постоянной работы питай ленту от отдельного адаптера 5 V 2 A и соедини его GND с GND платы ESP32. Для более длинной ленты поменяй LED_COUNT в коде и подбирай адаптер из расчёта 60 mA на светодиод. Конденсатор 1000 мкФ на входе ленты и резистор 330 Ω последовательно в линии данных защищают ленту.

Почему цвета не такие, как на экране?

Яркость светодиода растёт прямо пропорционально значению, а глаз воспринимает свет иначе: без коррекции цвета выглядят бледными и белёсыми. Поэтому код исправляет каждый цвет через gamma32. Тёмные и пастельные оттенки становятся ближе к экранным, но точь-в-точь не совпадут. На очень низкой яркости цвета смещаются, а смешанные оттенки вроде жёлтого и оранжевого блекнут; выше 40 разница заметно меньше.

Что будет с лентой после отключения электричества?

Плата всегда стартует с выключенной лентой: цвет возвращается к белому, яркость к 70, эффект к «Ровный», потому что значения на плате не сохраняются. Когда приложение снова подключится, панель покажет текущие значения, которые пришлёт плата; просто включи «Свет». Если оборвётся только связь с телефоном, лента продолжит светиться как была.