ES-108Pemula

ESP32 Bluetooth LED dan Relay

Nyalakan dan matikan LED dan relay dari ponsel lewat Bluetooth, tanpa internet atau Wi-Fi. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth LED dan relay di aplikasi, dirakit dengan ESP32 dan modul relay 5 V. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih LED dan relay, lalu unggah kode lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini juga membuka wizard dengan template ini.

0.0(0)
ESP32 Bluetooth LED dan Relay
Ketuk sakelar di ponselmu, dan relay di mejamu berbunyi klik: tanpa internet, tanpa router, tanpa server di tengahnya. ESP32 sudah punya Bluetooth bawaan, jadi ponsel tersambung langsung ke board dan dua sakelar di panel mengatur LED dan relay. Saat panel terbuka, board mengirim keadaan sebenarnya, jadi yang kamu lihat di layar sama dengan yang terjadi di board. Di aplikasi, tambah perangkat baru, pilih Bluetooth dan template LED dan relay, unggah kode lewat Ambil kodenya, lalu cari board-mu di daftar. Tombol di halaman ini juga membawamu ke sana. Yang dipelajari: berkomunikasi lewat Bluetooth Low Energy dengan baris teks pendek, relay yang aktif saat LOW, dan board yang melaporkan keadaannya ke panel. Catatan relay: papan ini bekerja dengan 3,3 V. Gunakan modul relay dengan optocoupler yang bisa dipicu sinyal 3,3 V; modul 5 V tanpa optocoupler bisa saja tidak mati dengan sinyal 3,3 V.

Video

Skema rangkaian

ESP32 Bluetooth LED dan Relay - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Lamba                  │
5// └───────────────────────────┘
6// LED dan relay
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
14const char BLE_NAME[] = "BG-Lamba";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
15
16// Pin: ubah di sini kalau sambunganmu berbeda
17const int LED_PIN = 2;
18const int RELAY_PIN = 26;
19const bool RELAY_ACTIVE_LOW = true;  // kebanyakan modul relay aktif saat LOW
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 ──
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); }  // saat mati pin dilepas: HIGH 3,3 V tidak cukup untuk mematikan modul 5 V
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

FAQ

Apakah bisa dipakai dengan iPhone?

Bisa. Bluetooth Low Energy (BLE) bawaan ESP32 bisa berkomunikasi dengan iPhone dan Android. iPhone tidak bisa tersambung ke modul Bluetooth klasik seperti HC-05 dan HC-06, dan proyek ini memang tidak memakainya. Jangan coba memasangkan (pairing) board dari pengaturan Bluetooth ponsel; board BLE bisa saja tidak muncul di sana, itu normal. Sambungannya dibuat oleh aplikasi BlueGrays.

Bolehkah aku memasang lampu sungguhan ke relay?

Modul relay bisa menyambung listrik PLN 220 V, tapi listrik PLN bisa mematikan. Di proyek ini terminal COM dan NO tidak tersambung ke apa pun; relay menunjukkan bahwa ia bekerja lewat bunyi klik dan LED modul. Kalau mau mencoba beban, mulai dengan rangkaian tegangan rendah seperti baterai atau adaptor 12 V. Kalau mau pindah ke 220 V, lakukan bersama orang yang berpengalaman, jangan biarkan kabel atau sekrup terbuka, dan jangan melebihi arus yang tertulis di modul.

Kenapa LED biru di board ikut menyala bersama LED-ku?

Di banyak board ESP32 DevKit, LED biru bawaan juga tersambung ke GPIO2. LED-mu ada di pin yang sama, jadi keduanya berkedip bersamaan; ini bukan kerusakan. Malah membantu: kalau ada kabel yang longgar, LED biru tetap menunjukkan bahwa perintah sudah sampai ke board. Kalau tidak mau, pindahkan LED-mu ke pin lain (misalnya GPIO4) dan ubah LED_PIN di kode.

Perlu internet atau Wi-Fi? Seberapa jauh jangkauannya?

Tidak perlu. Ponsel tersambung langsung ke board lewat Bluetooth, tanpa router atau server. Di dalam rumah jangkauannya biasanya sekitar 10 meter, dan dinding memperpendeknya. Board hanya tersambung ke satu ponsel dalam satu waktu; begitu ponsel itu terputus, board kembali memancarkan sinyal dan ponsel lain bisa tersambung. Untuk mengontrol dari luar rumah, pilih proyek yang memakai panel IoT Wi-Fi di aplikasi.