ESP32 Bluetooth servo kilid
Telefonundan Bluetooth ilə SG90 servonu kilid mandalı kimi fırlat: kilidlə, aç və ya bucağı tənzimlə; internet və ya Wi-Fi lazım deyil. Bu layihə tətbiqdəki Servo kilid Bluetooth şablonunun addım-addım bələdçisidir: ESP32, bir servo və 3 naqillə qurulur. Emalatxanam › Cihazlarım › Yeni cihaz əlavə et › Bluetooth yolunu izlə, Servo kilid şablonunu seç, Kodu al ilə kodu plataya yüklə. Bu səhifədəki Bluetooth paneli kimi qur düyməsi də sehrbazı bu şablonla açır.

Video
Dövrə sxemi

Mənbə kodu
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Kilit │
5// └───────────────────────────┘
6// Servo kilid
7// Arduino IDE-də plata: ESP32 Dev Module
8// BLE kitabxanası ESP32 plata paketi ilə gəlir, ayrıca quraşdırılmır
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"; // plata bu adla yayım edir, tətbiq onu siyahıda bu adla tapır
16
17// Pinlər: fərqli qoşmusansa, buradan dəyiş
18const int SERVO_PIN = 13;
19const int LOCKED_ANGLE = 90, OPEN_ANGLE = 0; // kilidli və açıq vəziyyət üçün servo bucaqları
20const bool LOCK_ON_DISCONNECT = true; // Əlaqə kəsilsə, kilid bağlanır (olduğu kimi qalmasını istəyirsənsə, false et)
21
22void btWrite(const char *text);
23void onValue(const char *key, const char *value);
24void sendAll();
25void onLinkLost();
26
27// ── Tətbiq "açar=dəyər" sətirləri göndərir; "?" gələndə plata bütün dəyərlərini göndərir ──
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" sətri tətbiqə kodun versiyası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// gələn baytlar Bluetooth tapşırığından loop()-a kiçik dairəvi bufer vasitəsilə keçir
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// sətirlər 20 baytlıq paketlərlə göndərilir (hər telefonla işləyir)
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}
204Tez-tez verilən suallar
iPhone ilə işləyir?
Bəli. ESP32-nin daxilindəki Bluetooth Low Energy (BLE) həm iPhone, həm Android ilə işləyir. HC-05 və HC-06 kimi klassik Bluetooth modullarına iPhone qoşula bilmir, bu layihədə onlara ehtiyac da yoxdur. Platanı telefonun Bluetooth ayarlarından cütləşdirməyə çalışma; BLE platalar orada görünməyə bilər, bu normaldır. Qoşulmanı BlueGrays tətbiqi qurur.
Qoşulma kəsiləndə niyə özü-özünə kilidlənir?
Bilərəkdən belədir. Koddakı LOCK_ON_DISCONNECT ayarı true olduğu üçün telefon uzaqlaşanda və ya tətbiq bağlananda plata mandalı kilidli bucağa (90 dərəcə) qaytarır; beləliklə kilid açıq unudulmur. Plata açılışda da kilidli başlayır. Açıq qalsın istəsən, bu ayarı false et və kodu yenidən yüklə. Mandalı Kilid açarı əvəzinə Servo bucağı sürüşdürücüsü ilə açmısansa, eyni qoruma işləyir: plata 90-dan başqa hər bucağı açıq sayır.
Real qapını və ya seyfi kilidləyə bilərəm?
Xeyr, bu bir öyrənmə layihəsidir. SG90 plastik dişlisi olan kiçik hobbi servosudur; qolu zorlananda fırlanır, enerjisi kəsiləndə də saxlama gücü qalmır. Bundan əlavə, bu koddakı Bluetooth qoşulmasında şifrə yoxdur: yaxındakı başqa telefon da plataya qoşulub komanda göndərə bilər. Qutu, siyirmə və ya maket qapı mandalında sına; real qapını və ya qiymətli əşyanı buna etibar etmə.
Kilid açarı ilə bucaq sürüşdürücüsünün fərqi nədir?
Kilid açarı mandalı kodda yazılmış iki mövqeyə aparır: kilidli 90, açıq 0 dərəcə. Hər dəyişiklikdə plata yeni bucağı panelə bildirir, sürüşdürücü də həmin dəyərə gəlir. Servo bucağı sürüşdürücüsü isə qolu 0 ilə 180 dərəcə arasında istədiyin yerə fırladır; mandalın dəqiq harada bağlandığını tapmaq üçün əlverişlidir. Tapdığın dəyərləri koddakı LOCKED_ANGLE və OPEN_ANGLE sətirlərinə yaz. Sürüşdürücünü 90-dan başqa bucağa gətirəndə plata kilidi açıq sayır və paneldəki Kilid açarı da bunu göstərir; tam 90-a qayıdanda yenidən kilidli görünür.
