ES-108Başlangıç

ESP32 Bluetooth LED ve Röle

Telefonundan Bluetooth ile bir LED'i ve bir röleyi aç, kapat; internet ya da Wi-Fi gerekmez. Bu proje, uygulamadaki LED ve röle Bluetooth şablonunun adım adım rehberi: ESP32 ve 5 V röle modülüyle kurulur. Atölyem › Cihazlarım › Yeni cihaz ekle › Bluetooth yolunu izle, LED ve röle şablonunu seç, Kodu al ile kodu karta yükle. Bu sayfadaki Bluetooth paneli olarak kur düğmesi de sihirbazı bu şablonla açar.

0.0(0)
ESP32 Bluetooth LED ve Röle
Telefonundaki bir anahtara dokun, masadaki röle tık diye çeksin: arada internet, modem ya da sunucu yok. ESP32'nin içinde Bluetooth var; telefon karta doğrudan bağlanır, paneldeki iki anahtar LED'i ve röleyi yönetir. Panel açılınca kart gerçek durumunu söyler, yani ekranda gördüğün kartta olanla aynıdır. Uygulamada yeni cihaz ekle, Bluetooth'u ve LED ve röle şablonunu seç, Kodu al ile kodu karta yükle, sonra kartını listede bul. Bu sayfadaki düğme de seni aynı kuruluma götürür. Öğrenme: Bluetooth Low Energy ile kısa metin satırlarıyla haberleşme, LOW ile çeken röle ve kartın durumunu panele bildirmesi. Röle notu: Bu kart 3,3 V ile çalışır. Röle modülü olarak 3,3 V sinyalle tetiklenebilen optokuplörlü bir modül kullan; optokuplörsüz 5 V modüller 3,3 V sinyalle kapanmayabilir.

Video

Devre Şeması

ESP32 Bluetooth LED ve Röle - Devre Şeması

Kaynak Kodu

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Lamba                  │
5// └───────────────────────────┘
6// LED ve röle
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
14const char BLE_NAME[] = "BG-Lamba";  // kart bu adla yayın yapar, uygulama onu listede bu adla bulur
15
16// Pinler: farklı bağladıysan buradan değiştir
17const int LED_PIN = 2;
18const int RELAY_PIN = 26;
19const bool RELAY_ACTIVE_LOW = true;  // çoğu röle modülü LOW ile çeker
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 ──
155bool ledOn = false, relayOn = false;
156
157void setRelay(bool on) {
158  if (RELAY_ACTIVE_LOW) {
159    if (on) { pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, LOW); }
160    else { pinMode(RELAY_PIN, INPUT); }  // kapatırken pin boşa alınır: 3,3 V HIGH, 5 V modülü kapatmaya yetmez
161  } else {
162    pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, on ? HIGH : LOW);
163  }
164}
165
166void apply() {
167  digitalWrite(LED_PIN, ledOn ? HIGH : LOW);
168  setRelay(relayOn);
169}
170
171void onValue(const char *key, const char *value) {
172  if (is(key, "led")) ledOn = isOn(value);
173  else if (is(key, "role")) relayOn = isOn(value);
174  apply();
175}
176
177void sendAll() {
178  sendInt("led", ledOn);
179  sendInt("role", relayOn);
180}
181
182void onLinkLost() {
183}
184
185void setup() {
186  Serial.begin(115200);
187  pinMode(LED_PIN, OUTPUT);
188  apply();
189  btBegin();
190  Serial.print(F("BlueGrays Bluetooth: "));
191  Serial.println(BLE_NAME);
192}
193
194void loop() {
195  btPoll();
196}
197

Sıkça Sorulanlar

iPhone ile çalışır mı?

Evet. ESP32'nin içindeki Bluetooth Low Energy (BLE) hem iPhone hem Android ile konuşur. HC-05 ve HC-06 gibi klasik Bluetooth modüllerine iPhone bağlanamaz, bu projede onlara gerek de yok. Kartı telefonun Bluetooth ayarlarından eşleştirmeye çalışma; BLE kartlar orada görünmeyebilir, bu normal. Bağlantıyı BlueGrays uygulaması kurar.

Röleye gerçek bir lamba bağlayabilir miyim?

Röle modülü 220 V'u anahtarlayabilir ama şebeke elektriği hayati tehlike taşır. Bu projede rölenin COM ve NO uçlarına bir şey bağlı değil; röle tık sesi ve modül LED'iyle çalıştığını gösterir. Bir yük denemek istersen önce pil ya da 12 V adaptör gibi düşük gerilimli bir devreyle dene. 220 V'a geçeceksen bunu işi bilen biriyle yap, açıkta kablo ve vida bırakma, modülün üzerindeki akım sınırını aşma.

Kartın üstündeki mavi LED neden benim LED'imle birlikte yanıyor?

Birçok ESP32 DevKit kartında üstteki mavi LED de GPIO2'ye bağlıdır. Senin LED'in de aynı pinde olduğu için ikisi birlikte yanıp söner; bu bir hata değil. Hatta işine yarar: kabloda sorun olsa bile mavi LED komutun karta ulaştığını gösterir. İstemiyorsan LED'i başka bir pine (ör. GPIO4) taşı ve koddaki LED_PIN değerini değiştir.

İnternet ya da Wi-Fi gerekir mi, menzil ne kadar?

Gerekmez. Telefon karta doğrudan Bluetooth ile bağlanır, modem ve sunucu kullanılmaz. Menzil ev içinde genelde 10 metre civarıdır, duvarlar kısaltır. Kart aynı anda tek telefona bağlanır; bir telefon ayrılınca kart yeniden yayına başlar ve başka bir telefon bağlanabilir. Evin dışından kontrol istersen uygulamadaki Wi-Fi'lı IoT panelini kullanan bir proje seç.