ES-110Menengah

ESP32 Bluetooth Strip LED RGB (WS2812B)

Ubah warna, kecerahan, dan efek strip LED-mu dari ponsel: ESP32 terhubung langsung ke ponselmu lewat Bluetooth bawaannya, dan strip WS2812B cukup dipasang dengan 3 kabel. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth Strip LED RGB di aplikasi. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Strip LED RGB, lalu unggah kodenya lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini membuka wizard dengan template ini.

0.0(0)
1 selesai
ESP32 Bluetooth Strip LED RGB (WS2812B)
Mau mewarnai lampu kamarmu dari ponsel? Di sini ESP32 terhubung langsung ke ponselmu lewat Bluetooth; tidak perlu internet, router, atau server. Di panel kamu menyalakan strip, memilih warna apa saja, menggeser kecerahan, dan memilih efek seperti pelangi atau napas. Di aplikasi buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih template Strip LED RGB, unggah kodenya lewat Ambil kodenya, lalu sambungkan di langkah Cari board-mu. Tombol Siapkan sebagai panel Bluetooth di halaman ini juga membuka wizard dengan template yang sama. Yang dipelajari: perintah baris demi baris lewat Bluetooth Low Energy, mengendalikan strip WS2812B dengan Adafruit NeoPixel, koreksi gamma, dan animasi yang halus.

Video

Skema rangkaian

ESP32 Bluetooth Strip LED RGB (WS2812B) - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Isik                   │
5// └───────────────────────────┘
6// Strip LED RGB
7// Board di Arduino IDE: ESP32 Dev Module
8// library BLE sudah ikut paket board ESP32, tidak perlu pasang apa-apa lagi
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";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
16
17// Pin: ubah di sini kalau sambunganmu berbeda
18const int STRIP_PIN = 5;
19const int LED_COUNT = 30;  // jumlah LED di strip-mu
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Aplikasi mengirim baris "kunci=nilai"; saat menerima "?" papan mengirim semua nilainya ──
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");  // baris "@v" memberi tahu aplikasi versi kodenya
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// byte yang masuk dipindah dari tugas Bluetooth ke loop() lewat buffer cincin kecil
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// baris dikirim dalam paket 20 byte (bisa di semua ponsel)
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// koreksi gamma: warna di LED mirip dengan di layar
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    // efek berhenti sebentar saat perintah datang (interupsi mati selama strip ditulis)
216    if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217      lastFrameMs = millis();
218      if (is(effect, "gokkusagi")) {  // pelangi mengalir di sepanjang 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")) {  // meredup lalu menyala lagi pelan-pelan
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")) {  // berkedip setiap setengah detik
227        fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228      } else if (is(effect, "renk_dongusu")) {  // seluruh strip satu warna, pergantian rona yang halus
229        hue += 128;
230        fillColor(strip.ColorHSV(hue), level());
231      }
232    }
233  }
234}
235

FAQ

Apakah bisa dipakai dengan iPhone?

Bisa. Proyek ini memakai Bluetooth Low Energy (BLE) bawaan ESP32, yang berjalan di iPhone maupun Android. iPhone tidak bisa tersambung ke modul Bluetooth klasik seperti HC-05 atau HC-06, karena itu di sini tidak ada modul tambahan. Jangan mencoba memasangkan board dari pengaturan Bluetooth ponsel; sambungannya hanya dibuat oleh aplikasi BlueGrays.

Berapa LED yang bisa kupasang dan catu daya apa yang dibutuhkan?

Setiap LED menarik hingga 60 mA saat putih penuh, jadi 30 LED sekitar 1,8 A. Port USB komputer tidak sanggup memberi arus sebesar itu, jadi saat mencoba sebentar lewat USB, atur kecerahan sekitar 20. Untuk pemakaian sehari-hari, beri daya strip dari adaptor 5 V 2 A terpisah dan sambungkan GND adaptor ke GND ESP32. Untuk strip yang lebih panjang, ubah LED_COUNT di kode dan pilih adaptor dengan hitungan 60 mA per LED. Kapasitor 1000 µF di masukan strip dan resistor 330 Ω seri di jalur data melindungi strip.

Kenapa warnanya berbeda dengan di layar?

Kecerahan LED naik lurus mengikuti nilainya, tapi mata kita tidak melihat cahaya seperti itu; tanpa koreksi warna tampak pucat dan keputihan. Karena itu kode mengoreksi setiap warna dengan gamma32. Warna gelap dan pastel jadi mendekati layar, meski tidak pernah sama persis. Saat kecerahan sangat rendah warna bergeser dan warna campuran seperti kuning dan oranye memudar; di atas sekitar 40 perbedaannya mengecil.

Apa yang terjadi pada strip setelah listrik padam?

Board selalu mulai dengan strip mati: warna kembali putih, kecerahan 70, dan efek Diam, karena nilainya tidak disimpan di board. Saat aplikasi tersambung lagi, panel menampilkan nilai terkini yang dikirim board; cukup nyalakan Lampu. Kalau hanya sambungan ke ponsel yang putus, strip tetap menyala seperti sebelumnya.