แถบไฟ RGB LED ผ่าน Bluetooth ด้วย ESP32 (WS2812B)
เปลี่ยนสี ความสว่าง และเอฟเฟกต์แถบไฟจากโทรศัพท์ ESP32 เชื่อมต่อโดยตรงผ่าน Bluetooth ในตัว ส่วนแถบไฟ WS2812B ใช้สายไฟเพียง 3 เส้น คู่มือนี้สอนใช้เทมเพลต Bluetooth แถบไฟ RGB LED ทีละขั้นตอน ไปที่ คลังของฉัน › อุปกรณ์ › เพิ่มอุปกรณ์ › Bluetooth เลือกแถบไฟ RGB LED แล้วกด รับโค้ด เพื่ออัปโหลดลงบอร์ด ปุ่ม ตั้งค่าเป็นแผงควบคุม Bluetooth ในหน้านี้จะเปิดตัวช่วยตั้งค่าพร้อมเทมเพลตนี้

วิดีโอ
แผนผังวงจร

ซอร์สโค้ด
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Isik │
5// └───────────────────────────┘
6// RGB LED strip
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 <Adafruit_NeoPixel.h> // Library Manager: 'Adafruit NeoPixel'
14
15const char BLE_NAME[] = "BG-Isik"; // 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 STRIP_PIN = 5;
19const int LED_COUNT = 30; // number of LEDs on your strip
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 ──
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// gamma correction: colors look on the LEDs like they do on screen
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 // the effect pauses for a moment while a command arrives (interrupts are off while the strip updates)
216 if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217 lastFrameMs = millis();
218 if (is(effect, "gokkusagi")) { // a rainbow flows along the strip
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")) { // slowly fades out and in
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")) { // blinks every half second
227 fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228 } else if (is(effect, "renk_dongusu")) { // whole strip one color, smooth hue shift
229 hue += 128;
230 fillColor(strip.ColorHSV(hue), level());
231 }
232 }
233 }
234}
235FAQ
ใช้กับ iPhone ได้ไหม
ใช้ได้ โปรเจกต์นี้ใช้ Bluetooth Low Energy (BLE) ในตัว ESP32 ซึ่งใช้ได้ทั้งกับ iPhone และ Android ส่วน iPhone เชื่อมต่อกับโมดูล Bluetooth แบบคลาสสิกอย่าง HC-05 หรือ HC-06 ไม่ได้ โปรเจกต์นี้จึงไม่ใช้โมดูลเสริม ไม่ต้องจับคู่บอร์ดจากการตั้งค่า Bluetooth ของโทรศัพท์ ให้เชื่อมต่อผ่านแอป BlueGrays เท่านั้น
ต่อ LED ได้กี่ดวง และต้องใช้แหล่งจ่ายไฟแบบไหน
LED แต่ละดวงใช้กระแสสูงสุด 60 mA เมื่อเปิดสีขาวเต็มความสว่าง ดังนั้น LED 30 ดวงจะใช้ประมาณ 1.8 A พอร์ต USB ของคอมพิวเตอร์จ่ายกระแสได้ไม่พอ หากทดลองสั้นๆ ผ่าน USB ให้ตั้งความสว่างไว้ประมาณ 20 สำหรับการใช้งานจริง ให้จ่ายไฟเข้าแถบไฟด้วยอะแดปเตอร์ 5 V 2 A แยกต่างหาก และต่อ GND ของอะแดปเตอร์เข้ากับ GND ของ ESP32 หากใช้แถบไฟยาวขึ้น ให้เปลี่ยนค่า LED_COUNT ในโค้ดและเลือกอะแดปเตอร์โดยคำนวณกระแส 60 mA ต่อ LED 1 ดวง การต่อตัวเก็บประจุ 1000 µF ที่จุดรับไฟของแถบไฟและตัวต้านทาน 330 Ω อนุกรมกับสายข้อมูลช่วยป้องกันแถบไฟได้
ทำไมสีถึงดูต่างจากบนหน้าจอ
ความสว่างของ LED เพิ่มขึ้นเป็นเส้นตรงตามค่าที่กำหนด แต่สายตาเราไม่ได้รับรู้แสงแบบนั้น หากไม่ปรับแก้ สีจะดูซีดและออกขาว โค้ดจึงปรับทุกสีด้วย gamma32 เพื่อให้โทนมืดและสีพาสเทลใกล้เคียงกับที่เห็นบนหน้าจอ แต่จะไม่เหมือนกันทั้งหมด เมื่อความสว่างต่ำมาก สีจะเพี้ยนและสีผสมอย่างสีเหลืองกับสีส้มจะซีดลง หากเพิ่มความสว่างให้เกินประมาณ 40 ความแตกต่างจะลดลง
เมื่อไฟดับแล้วกลับมา แถบไฟจะทำงานอย่างไร
ทุกครั้งที่บอร์ดเริ่มทำงาน แถบไฟจะปิดอยู่เสมอ สีกลับเป็นสีขาว ความสว่างกลับเป็น 70 และเอฟเฟกต์กลับเป็นสีคงที่ เพราะบอร์ดไม่ได้บันทึกค่าเหล่านี้ไว้ เมื่อแอปเชื่อมต่ออีกครั้ง แผงควบคุมจะแสดงค่าปัจจุบันที่บอร์ดส่งมา เพียงเปิดสวิตช์ไฟก็ใช้งานได้ หากมีแค่โทรศัพท์ที่ตัดการเชื่อมต่อ แถบไฟจะยังสว่างตามค่าล่าสุด
