ESP32 Bluetooth Servo Kilit
Telefonundan Bluetooth ile bir SG90 servoyu kilit mandalı gibi çevir: kilitle, aç ya da açıyı ayarla; internet ya da Wi-Fi gerekmez. Bu proje, uygulamadaki Servo kilit Bluetooth şablonunun adım adım rehberi: ESP32, bir servo ve 3 kabloyla kurulur. Atölyem › Cihazlarım › Yeni cihaz ekle › Bluetooth yolunu izle, Servo kilit şablonunu seç, Kodu al ile kodu karta yükle. Bu sayfadaki Bluetooth paneli olarak kur düğmesi de sihirbazı bu şablonla açar.

Video
Devre Şeması

Kaynak Kodu
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Kilit │
5// └───────────────────────────┘
6// Servo kilit
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 <ESP32Servo.h> // Kütüphane Yöneticisi: 'ESP32Servo'
14
15const char BLE_NAME[] = "BG-Kilit"; // 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 SERVO_PIN = 13;
19const int LOCKED_ANGLE = 90, OPEN_ANGLE = 0; // kilitli ve açık servo açıları
20const bool LOCK_ON_DISCONNECT = true; // Bağlantı koparsa kilit kapanır (olduğu gibi kalsın istersen false yap)
21
22void btWrite(const char *text);
23void onValue(const char *key, const char *value);
24void sendAll();
25void onLinkLost();
26
27// ── Uygulama "anahtar=değer" satırları yollar; "?" gelince kart bütün değerlerini gönderir ──
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"); // "@v" satırı uygulamaya kod sürümünü bildirir
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// gelen baytlar Bluetooth görevinden loop()'a küçük bir halka tamponla geçer
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// satırlar 20 baytlık paketlerle gider (her telefonla çalışır)
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}
204Sı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.
Bağlantı kopunca neden kendi kendine kilitleniyor?
Bilerek böyle. Koddaki LOCK_ON_DISCONNECT ayarı true olduğu için telefon uzaklaşınca ya da uygulama kapanınca kart mandalı kilitli açıya (90 derece) geri çevirir; böylece kilit açık unutulmaz. Kart açılışta da kilitli başlar. Açık kalsın istersen bu ayarı false yapıp kodu yeniden yükle. Mandalı Kilit anahtarı yerine Servo açısı kaydırıcısıyla açtıysan da aynı koruma çalışır: kart 90 dışındaki her açıyı açık sayar.
Gerçek bir kapıyı ya da kasayı kilitleyebilir miyim?
Hayır, bu bir öğrenme projesi. SG90 plastik dişlili küçük bir hobi servosudur; kolu zorlanınca döner, enerjisi kesilince de tutma gücü kalmaz. Ayrıca bu koddaki Bluetooth bağlantısında şifre yok: yakındaki başka bir telefon da karta bağlanıp komut gönderebilir. Bir kutu, çekmece ya da maket kapı mandalında dene; gerçek bir kapıyı ya da değerli eşyayı buna emanet etme.
Kilit anahtarı ile açı kaydırıcısının farkı ne?
Kilit anahtarı mandalı kodda yazılı iki konuma götürür: kilitli 90, açık 0 derece. Her değişimde kart yeni açıyı panele bildirir, kaydırıcı da o değere gelir. Servo açısı kaydırıcısı ise kolu 0 ile 180 derece arasında istediğin yere çevirir; mandalın tam nerede kapandığını bulmak için kullanışlıdır. Bulduğun değerleri koddaki LOCKED_ANGLE ve OPEN_ANGLE satırlarına yaz. Kaydırıcıyı 90'dan başka bir açıya getirince kart kilidi açık sayar ve paneldeki Kilit anahtarı da bunu gösterir; tam 90'a dönünce yeniden kilitli görünür.
