ESP32 Bluetooth RGB LED Şerit (WS2812B)
Şeridin rengini, parlaklığını ve efektini telefondan değiştir: ESP32 yerleşik Bluetooth'uyla telefona doğrudan bağlanır, WS2812B şerit yalnız 3 kabloyla takılır. Bu proje uygulamadaki RGB LED şerit Bluetooth şablonunun adım adım rehberi. Atölyem › Cihazlarım › Yeni cihaz ekle › Bluetooth yolunu izle, RGB LED şerit'i seç, Kodu al ile kodu karta yükle. Bu sayfadaki Bluetooth paneli olarak kur düğmesi sihirbazı bu şablonla açar.

Video
Devre Şeması

Kaynak Kodu
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Isik │
5// └───────────────────────────┘
6// RGB LED şerit
7// Arduino IDE kartı: ESP32 Dev Module
8// BLE kütüphanesi ESP32 kart paketiyle gelir, ayrıca kurulmaz
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <Adafruit_NeoPixel.h> // Kütüphane Yöneticisi: 'Adafruit NeoPixel'
14
15const char BLE_NAME[] = "BG-Isik"; // kart bu adla yayın yapar, uygulama onu listede bu adla bulur
16
17// Pinler: farklı bağladıysan buradan değiştir
18const int STRIP_PIN = 5;
19const int LED_COUNT = 30; // şeridindeki LED sayısı
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Uygulama "anahtar=değer" satırları yollar; "?" gelince kart bütün değerlerini gönderir ──
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" satırı uygulamaya kod sürümünü bildirir
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// gelen baytlar Bluetooth görevinden loop()'a küçük bir halka tamponla geçer
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// satırlar 20 baytlık paketlerle gider (her telefonla çalışır)
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 düzeltmesi: renk LED'de ekrandakine yakın görünür
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 // komut gelirken efekt bir an durur (şerit yazılırken kesmeler kapanır, komut bozulmasın)
216 if (millis() - lastRxMs > 150 && millis() - lastFrameMs >= 30) {
217 lastFrameMs = millis();
218 if (is(effect, "gokkusagi")) { // gökkuşağı şerit boyunca akar
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")) { // yavaşça sönüp yanar
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")) { // yarım saniyede bir yanıp söner
227 fillColor(strip.Color(cr, cg, cb), (millis() / 500) % 2 ? level() : 0);
228 } else if (is(effect, "renk_dongusu")) { // tüm şerit aynı renk, yumuşak ton geçişi
229 hue += 128;
230 fillColor(strip.ColorHSV(hue), level());
231 }
232 }
233 }
234}
235Sıkça Sorulanlar
iPhone ile çalışır mı?
Evet. Projede ESP32'nin yerleşik Bluetooth Low Energy (BLE) özelliği kullanılıyor; iPhone'da da Android'de de çalışır. iPhone, HC-05 ve HC-06 gibi klasik Bluetooth modüllerine bağlanamaz, bu yüzden projede ayrı bir modül yok. Kartı telefonun Bluetooth ayarlarından eşleştirmeye çalışma; bağlantıyı yalnız BlueGrays uygulaması kurar.
Kaç LED bağlayabilirim, nasıl bir güç kaynağı gerekir?
Her LED tam beyazda 60 mA'e kadar çeker; 30 LED yaklaşık 1,8 A eder. Bilgisayarın USB'si bunu karşılamaz, bu yüzden USB ile kısa denemede parlaklığı 20 civarında tut. Kalıcı kullanımda şeridi ayrı bir 5 V 2 A adaptörden besle ve adaptörün GND'sini ESP32'nin GND'sine bağla. Daha uzun şerit için koddaki LED_COUNT sayısını değiştir, adaptörü LED başına 60 mA hesabıyla seç. Şerit girişine 1000 µF kondansatör ve veri hattına seri 330 Ω direnç şeridi korur.
Renkler neden ekrandakinden farklı görünüyor?
LED'in parlaklığı değerle düz bir çizgide artar, gözümüz ise ışığı öyle algılamaz; düzeltme olmasa renkler soluk ve beyazımsı görünür. Bu yüzden kod her rengi gamma32 ile düzeltir. Koyu ve pastel tonlar ekrandakine yaklaşır ama birebir aynı olmaz. Parlaklık çok düşükken renkler kayar, sarı ve turuncu gibi karışık renkler solar; parlaklığı 40'ın üstüne çıkarınca fark azalır.
Elektrik gidip gelince şerit ne yapar?
Kart her açılışta şerit kapalı başlar: renk beyaza, parlaklık 70'e, efekt Sabit'e döner, çünkü değerler kartta saklanmaz. Uygulama yeniden bağlanınca panel kartın gönderdiği güncel değerleri gösterir; Işık anahtarını açman yeter. Yalnız telefonun bağlantısı koparsa şerit son hâliyle yanmaya devam eder.
