ES-111Başlangıç

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.

0.0(0)
ESP32 Bluetooth Servo Kilit
Telefonundaki kilit anahtarına dokun, servo 90 dereceye dönüp mandalı kapatsın; bir daha dokun, 0'a dönüp açsın. İnternet ya da modem yok: telefon ESP32'ye doğrudan Bluetooth ile bağlanır. Kaydırıcı açıyı 0 ile 180 derece arasında ayarlar. Kart kilitli başlar; kilit açıkken bağlantı koparsa kendini yeniden kilitler. SG90 küçük bir hobi servosudur: bu, bir kutu, çekmece ya da maket kapı mandalı için öğrenme projesidir, gerçek bir kapı ya da değerli eşya kilidi yerine geçmez. Uygulamada Bluetooth'u ve Servo kilit şablonunu seç, Kodu al ile kodu yükle, kartını listede bul. Öğrenme: servo açısı, Bluetooth Low Energy ile kısa metin satırları ve kartın durumunu panele bildirmesi.

Video

Devre Şeması

ESP32 Bluetooth Servo Kilit - Devre Şeması

Kaynak Kodu

C++ (Arduino IDE)
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}
204

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.

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.