ES-110Intermedio

ESP32 Bluetooth Striscia LED RGB (WS2812B)

Cambia colore, luminosità ed effetto della tua striscia dal telefono: l'ESP32 si collega direttamente al telefono via Bluetooth e la striscia WS2812B richiede solo 3 fili. È la guida passo passo del modello Bluetooth Striscia LED RGB dell'app. Vai in La Mia Officina › Dispositivi › Aggiungi dispositivo › Bluetooth, scegli Striscia LED RGB e carica il codice con Ottieni il codice. Il pulsante Configura come pannello Bluetooth qui apre la procedura con questo modello.

0.0(0)
1 completato
ESP32 Bluetooth Striscia LED RGB (WS2812B)
Vuoi colorare la tua stanza dal telefono? Qui l'ESP32 si collega direttamente al telefono via Bluetooth, senza internet, router o server. Nel pannello accendi la striscia, scegli qualsiasi colore, regoli la luminosità e avvii un effetto come arcobaleno o respiro. Nell'app vai in La Mia Officina › Dispositivi › Aggiungi dispositivo › Bluetooth, scegli il modello Striscia LED RGB, carica il codice con Ottieni il codice e collegati nel passo Trova la tua scheda. Il pulsante Configura come pannello Bluetooth in questa pagina apre la procedura con questo modello. Impari: comandi riga per riga via Bluetooth Low Energy, pilotare una striscia WS2812B con Adafruit NeoPixel, correzione gamma e animazioni fluide.

Video

Schema circuito

ESP32 Bluetooth Striscia LED RGB (WS2812B) - Schema circuito

Codice sorgente

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Isik                   │
5// └───────────────────────────┘
6// Striscia LED RGB
7// Scheda in Arduino IDE: ESP32 Dev Module
8// la libreria BLE arriva con il pacchetto schede ESP32, niente da installare in più
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <Adafruit_NeoPixel.h>  // Gestore librerie: 'Adafruit NeoPixel'
14
15const char BLE_NAME[] = "BG-Isik";  // la scheda si annuncia con questo nome e l’app la trova così nell’elenco
16
17// Pin: cambiali qui se hai collegato in modo diverso
18const int STRIP_PIN = 5;
19const int LED_COUNT = 30;  // numero di LED della tua striscia
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── L’app invia righe "chiave=valore"; con "?" la scheda manda tutti i suoi valori ──
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");  // la riga "@v" comunica all’app la versione del codice
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// i byte in arrivo passano dal task Bluetooth a loop() tramite un piccolo buffer circolare
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// le righe partono in pacchetti da 20 byte (funziona con ogni telefono)
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// correzione gamma: i colori sui LED somigliano a quelli sullo schermo
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    // l’effetto si ferma un attimo mentre arriva un comando (durante la scrittura della striscia gli interrupt sono spenti)
216    if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217      lastFrameMs = millis();
218      if (is(effect, "gokkusagi")) {  // un arcobaleno scorre lungo la striscia
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")) {  // si spegne e si riaccende lentamente
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")) {  // lampeggia ogni mezzo secondo
227        fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228      } else if (is(effect, "renk_dongusu")) {  // tutta la striscia dello stesso colore, passaggio morbido di tonalità
229        hue += 128;
230        fillColor(strip.ColorHSV(hue), level());
231      }
232    }
233  }
234}
235

FAQ

Funziona con iPhone?

Sì. Il progetto usa il Bluetooth Low Energy (BLE) integrato dell'ESP32, che funziona sia su iPhone sia su Android. Un iPhone non può collegarsi ai moduli Bluetooth classici come HC-05 o HC-06, per questo qui non c'è un modulo in più. Non provare ad associare la scheda dalle impostazioni Bluetooth del telefono; la connessione la crea solo l'app BlueGrays.

Quanti LED posso collegare e che alimentatore serve?

Ogni LED assorbe fino a 60 mA in bianco pieno, quindi 30 LED arrivano a circa 1,8 A. La porta USB di un computer non basta: in una prova breve via USB tieni la luminosità intorno a 20. Per l'uso di tutti i giorni alimenta la striscia con un alimentatore separato da 5 V 2 A e collega il suo GND al GND dell'ESP32. Per una striscia più lunga cambia LED_COUNT nel codice e scegli l'alimentatore contando 60 mA per LED. Un condensatore da 1000 µF all'ingresso della striscia e una resistenza da 330 Ω in serie sulla linea dati proteggono la striscia.

Perché i colori sono diversi da quelli sullo schermo?

La luminosità di un LED sale in linea retta con il valore, ma il tuo occhio non percepisce la luce così; senza correzione i colori sembrano slavati e biancastri. Per questo il codice corregge ogni colore con gamma32. Le tonalità scure e pastello si avvicinano allo schermo, ma non sono mai identiche. A luminosità molto bassa i colori si spostano e le tinte miste come giallo e arancione sbiadiscono; sopra circa 40 la differenza cala.

Cosa fa la striscia dopo un'interruzione di corrente?

La scheda parte sempre con la striscia spenta: il colore torna bianco, la luminosità 70 e l'effetto Fisso, perché i valori non vengono salvati sulla scheda. Quando l'app si ricollega, il pannello mostra i valori attuali inviati dalla scheda; basta accendere Luce. Se cade solo la connessione con il telefono, la striscia resta accesa com'era.