ESP32 Bluetooth Kunci Servo
Kendalikan servo SG90 sebagai gerendel kecil dari ponsel lewat Bluetooth: kunci, buka, atau atur sudutnya, tanpa internet atau Wi-Fi. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth Kunci servo di aplikasi: ESP32, satu servo, dan 3 kabel. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Kunci servo, lalu unggah kode lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini membuka wizard yang sama.

Video
Skema rangkaian

Kode sumber
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Kilit │
5// └───────────────────────────┘
6// Kunci servo
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#include <ESP32Servo.h> // Library Manager: 'ESP32Servo'
14
15const char BLE_NAME[] = "BG-Kilit"; // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
16
17// Pin: ubah di sini kalau sambunganmu berbeda
18const int SERVO_PIN = 13;
19const int LOCKED_ANGLE = 90, OPEN_ANGLE = 0; // sudut servo saat terkunci dan terbuka
20const bool LOCK_ON_DISCONNECT = true; // Jika koneksi putus, kunci menutup (ubah ke false agar tetap seperti semula)
21
22void btWrite(const char *text);
23void onValue(const char *key, const char *value);
24void sendAll();
25void onLinkLost();
26
27// ── Aplikasi mengirim baris "kunci=nilai"; saat menerima "?" papan mengirim semua nilainya ──
28char line[65];
29uint8_t lineLen = 0;
30unsigned long lastRxMs = 0;
31
32bool is(const char *a, const char *b) { return strcmp(a, b) == 0; }
33bool isOn(const char *v) { return v[0] == '1'; }
34
35void sendText(const char *key, const char *value) {
36 char out[72];
37 snprintf(out, sizeof(out), "%s=%s\n", key, value);
38 btWrite(out);
39}
40
41void sendInt(const char *key, long value) {
42 char text[12];
43 snprintf(text, sizeof(text), "%ld", value);
44 sendText(key, text);
45}
46
47void sendFloat(const char *key, float value) {
48 char text[16];
49 dtostrf(value, 1, 1, text);
50 sendText(key, text);
51}
52
53void handleLine(char *text) {
54 char *eq = strchr(text, '=');
55 if (eq == nullptr) {
56 if (text[strlen(text) - 1] == '?') {
57 btWrite("@v=1.0\n"); // baris "@v" memberi tahu aplikasi versi kodenya
58 sendAll();
59 }
60 return;
61 }
62 *eq = '\0';
63 onValue(text, eq + 1);
64}
65
66void feed(char c) {
67 lastRxMs = millis();
68 if (c == '\n' || c == '\r') {
69 if (lineLen == 0) return;
70 line[lineLen] = '\0';
71 lineLen = 0;
72 handleLine(line);
73 } else if (lineLen < sizeof(line) - 1) {
74 line[lineLen++] = c;
75 }
76}
77
78// ── Bluetooth (Nordic UART) ──
79#define UART_SERVICE "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
80#define UART_RX "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
81#define UART_TX "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
82
83BLECharacteristic *txChar = nullptr;
84volatile bool linked = false;
85volatile bool linkLost = false;
86// byte yang masuk dipindah dari tugas Bluetooth ke loop() lewat buffer cincin kecil
87const int RX_SIZE = 256;
88volatile uint8_t rxBuf[RX_SIZE];
89volatile int rxHead = 0, rxTail = 0;
90
91class ServerEvents : public BLEServerCallbacks {
92 void onConnect(BLEServer *server) override { linked = true; }
93 void onDisconnect(BLEServer *server) override { linked = false; linkLost = true; }
94};
95
96class RxEvents : public BLECharacteristicCallbacks {
97 void onWrite(BLECharacteristic *c) override {
98 auto v = c->getValue();
99 for (size_t i = 0; i < v.length(); i++) {
100 int next = (rxHead + 1) % RX_SIZE;
101 if (next == rxTail) break;
102 rxBuf[rxHead] = (uint8_t)v[i];
103 rxHead = next;
104 }
105 }
106};
107
108// baris dikirim dalam paket 20 byte (bisa di semua ponsel)
109void btWrite(const char *text) {
110 if (!linked || txChar == nullptr) return;
111 size_t n = strlen(text);
112 for (size_t i = 0; i < n; i += 20) {
113 size_t len = n - i < 20 ? n - i : 20;
114 txChar->setValue((uint8_t *)text + i, len);
115 txChar->notify();
116 delay(4);
117 }
118}
119
120void btBegin() {
121 BLEDevice::init(BLE_NAME);
122 BLEServer *server = BLEDevice::createServer();
123 server->setCallbacks(new ServerEvents());
124 BLEService *uart = server->createService(UART_SERVICE);
125 txChar = uart->createCharacteristic(UART_TX, BLECharacteristic::PROPERTY_NOTIFY);
126 txChar->addDescriptor(new BLE2902());
127 BLECharacteristic *rx = uart->createCharacteristic(UART_RX, BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_WRITE_NR);
128 rx->setCallbacks(new RxEvents());
129 uart->start();
130 BLEAdvertisementData adv;
131 adv.setFlags(0x06);
132 adv.setCompleteServices(BLEUUID(UART_SERVICE));
133 BLEAdvertisementData scan;
134 scan.setName(BLE_NAME);
135 BLEAdvertising *advertising = BLEDevice::getAdvertising();
136 advertising->setAdvertisementData(adv);
137 advertising->setScanResponseData(scan);
138 BLEDevice::startAdvertising();
139}
140
141void btPoll() {
142 while (rxTail != rxHead) {
143 char c = (char)rxBuf[rxTail];
144 rxTail = (rxTail + 1) % RX_SIZE;
145 feed(c);
146 }
147 if (linkLost) {
148 linkLost = false;
149 onLinkLost();
150 delay(100);
151 BLEDevice::startAdvertising();
152 }
153}
154
155// ── ESP32 ──
156Servo servo;
157bool locked = true;
158int angle = LOCKED_ANGLE;
159
160void moveTo(int a) {
161 angle = constrain(a, 0, 180);
162 servo.write(angle);
163}
164
165void onValue(const char *key, const char *value) {
166 if (is(key, "kilit")) {
167 locked = isOn(value);
168 moveTo(locked ? LOCKED_ANGLE : OPEN_ANGLE);
169 sendInt("aci", angle);
170 } else if (is(key, "aci")) {
171 moveTo(atoi(value));
172 if (locked != (angle == LOCKED_ANGLE)) {
173 locked = !locked;
174 sendInt("kilit", locked);
175 }
176 }
177}
178
179void sendAll() {
180 sendInt("kilit", locked);
181 sendInt("aci", angle);
182}
183
184void onLinkLost() {
185 if (LOCK_ON_DISCONNECT && !locked) {
186 locked = true;
187 moveTo(LOCKED_ANGLE);
188 }
189}
190
191void setup() {
192 Serial.begin(115200);
193 servo.setPeriodHertz(50);
194 servo.attach(SERVO_PIN, 500, 2500);
195 moveTo(LOCKED_ANGLE);
196 btBegin();
197 Serial.print(F("BlueGrays Bluetooth: "));
198 Serial.println(BLE_NAME);
199}
200
201void loop() {
202 btPoll();
203}
204FAQ
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.
Kenapa kuncinya mengunci sendiri saat sambungan terputus?
Itu memang disengaja. Karena setelan LOCK_ON_DISCONNECT di kode bernilai true, board mengembalikan gerendel ke sudut terkunci (90 derajat) saat ponsel menjauh atau aplikasi ditutup; dengan begitu kunci tidak tertinggal terbuka. Board juga menyala dalam keadaan terkunci. Kalau kamu ingin kunci tetap terbuka, ubah nilai itu menjadi false lalu unggah ulang kodenya. Perlindungan yang sama bekerja kalau gerendel kamu buka dengan slider Sudut servo, bukan dengan sakelar Kunci: board menganggap semua sudut selain 90 sebagai terbuka.
Bisakah ini mengunci pintu sungguhan atau brankas?
Tidak, ini proyek belajar. SG90 adalah servo hobi kecil dengan roda gigi plastik; lengannya berputar kalau dipaksa, dan begitu dayanya diputus servo tidak menahan apa-apa lagi. Selain itu, sambungan Bluetooth di kode ini tidak memakai kata sandi: ponsel lain di dekatnya juga bisa tersambung ke board dan mengirim perintah. Cobalah pada gerendel kotak, laci, atau pintu maket; jangan percayakan pintu sungguhan atau barang berharga padanya.
Apa beda sakelar kunci dan slider sudut?
Sakelar Kunci menggerakkan gerendel ke dua posisi yang tertulis di kode: terkunci di 90 derajat, terbuka di 0. Setiap kali berubah, board melaporkan sudut baru ke panel sehingga slider ikut pindah ke nilai itu. Slider Sudut servo memutar lengan ke titik mana pun antara 0 dan 180 derajat; berguna untuk mencari di mana gerendelmu benar-benar menutup. Tulis nilai yang kamu temukan ke baris LOCKED_ANGLE dan OPEN_ANGLE di kode. Kalau slider kamu geser ke sudut selain 90, board menganggap kunci terbuka dan sakelar Kunci di panel ikut menunjukkannya; saat kembali tepat ke 90, kunci tampil terkunci lagi.
