ES-110Gemiddeld

ESP32 Bluetooth RGB-ledstrip (WS2812B)

Verander de kleur, helderheid en het effect van je strip met je telefoon: de ESP32 verbindt via de ingebouwde Bluetooth en de WS2812B-strip heeft maar 3 draden nodig. Dit is de gids bij het Bluetooth-sjabloon RGB-ledstrip. Ga naar Werkplaats › Apparaten › Apparaat toevoegen › Bluetooth, kies RGB-ledstrip en upload de code met Code ophalen. Instellen als Bluetooth-paneel opent de wizard met dit sjabloon.

0.0(0)
1 voltooid
ESP32 Bluetooth RGB-ledstrip (WS2812B)
Wil je het licht in je kamer vanaf je telefoon inkleuren? In dit project verbindt de ESP32 rechtstreeks met je telefoon via zijn eigen Bluetooth; je hebt geen internet, router of server nodig. In het paneel zet je de strip aan en uit, kies je elke kleur, stel je de helderheid in en kies je een effect zoals regenboog of ademen. Ga in de app naar Werkplaats › Apparaten › Apparaat toevoegen › Bluetooth, kies het sjabloon RGB-ledstrip, upload de code met Code ophalen en maak verbinding in de stap Zoek je board. De knop Instellen als Bluetooth-paneel op deze pagina opent de wizard met hetzelfde sjabloon. Wat je leert: commando's regel voor regel via Bluetooth Low Energy, een WS2812B-strip aansturen met Adafruit NeoPixel, gammacorrectie en vloeiende effectanimaties.

Video

Schakelschema

ESP32 Bluetooth RGB-ledstrip (WS2812B) - Schakelschema

Broncode

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Isik                   │
5// └───────────────────────────┘
6// RGB-ledstrip
7// Board in de Arduino IDE: ESP32 Dev Module
8// de BLE-bibliotheek zit in het ESP32-boardpakket, je hoeft niets extra te installeren
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";  // het board zendt deze naam uit, de app herkent het in de lijst aan deze naam
16
17// Pinnen: pas ze hier aan als je anders hebt aangesloten
18const int STRIP_PIN = 5;
19const int LED_COUNT = 30;  // aantal leds op je strip
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── De app stuurt regels "sleutel=waarde"; bij "?" stuurt het board al zijn waarden ──
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");  // de regel "@v" geeft de app de codeversie door
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// binnenkomende bytes gaan via een kleine ringbuffer van de Bluetooth-taak naar 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// regels worden in pakketten van 20 bytes verstuurd (werkt met elke telefoon)
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// gammacorrectie: kleuren zien er op de leds uit zoals op het scherm
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    // het effect pauzeert even terwijl er een commando binnenkomt (tijdens het bijwerken van de strip staan interrupts uit)
216    if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217      lastFrameMs = millis();
218      if (is(effect, "gokkusagi")) {  // een regenboog stroomt over de 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")) {  // dooft langzaam uit en gaat weer aan
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")) {  // knippert elke halve seconde
227        fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228      } else if (is(effect, "renk_dongusu")) {  // hele strip één kleur, vloeiende kleurovergang
229        hue += 128;
230        fillColor(strip.ColorHSV(hue), level());
231      }
232    }
233  }
234}
235

Veelgestelde vragen

Werkt het met een iPhone?

Ja. Het project gebruikt de ingebouwde Bluetooth Low Energy (BLE) van de ESP32, die werkt op zowel iPhone als Android. Een iPhone kan niet verbinden met klassieke Bluetooth-modules zoals de HC-05 of HC-06, daarom is er hier geen extra module. Probeer het board niet te koppelen in de Bluetooth-instellingen van je telefoon; alleen de BlueGrays-app maakt de verbinding.

Hoeveel leds kan ik aansluiten en welke voeding heb ik nodig?

Elke led trekt tot 60 mA bij volledig wit, dus 30 leds komen op ongeveer 1,8 A. De USB-poort van een computer kan dat niet leveren; houd de helderheid daarom rond 20 bij een snelle test via USB. Voed de strip voor dagelijks gebruik met een aparte 5V-2A-adapter en verbind de GND daarvan met de GND van de ESP32. Voor een langere strip pas je LED_COUNT in de code aan en kies je een adapter met 60 mA per led. Een condensator van 1000 µF bij de stripingang en een weerstand van 330 Ω in serie met de datalijn beschermen de strip.

Waarom zien de kleuren er anders uit dan op het scherm?

De helderheid van een led stijgt lineair met de waarde, maar je oog ziet licht niet zo; zonder correctie zien kleuren er flets en wittig uit. Daarom corrigeert de code elke kleur met gamma32. Donkere en pastelkleuren komen dicht bij het scherm, maar nooit exact. Bij zeer lage helderheid verschuiven kleuren en vervagen mengkleuren zoals geel en oranje; boven ongeveer 40 wordt het verschil kleiner.

Wat doet de strip na een stroomuitval?

Het board start altijd met de strip uit: de kleur gaat terug naar wit, de helderheid naar 70 en het effect naar Vast, omdat de waarden niet op het board worden opgeslagen. Als de app opnieuw verbindt, toont het paneel de actuele waarden die het board stuurt; zet gewoon de schakelaar Licht aan. Als alleen de telefoon de verbinding verliest, blijft de strip branden zoals hij was.