ES-111Başlanğıc

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.

0.0(0)
ESP32 Bluetooth servo kilid
Telefonundakı kilid açarına toxun, servo 90 dərəcəyə fırlanıb mandalı bağlasın; bir daha toxun, 0-a qayıdıb açsın. İnternet və ya modem yoxdur: telefon ESP32-yə birbaşa Bluetooth ilə qoşulur. Sürüşdürücü bucağı 0 ilə 180 dərəcə arasında tənzimləyir. Plata kilidli başlayır; kilid açıq olanda qoşulma kəsilsə, özünü yenidən kilidləyir. SG90 kiçik hobbi servosudur: bu, qutu, siyirmə və ya maket qapı mandalı üçün öyrənmə layihəsidir, real qapı və ya qiymətli əşya kilidini əvəz etmir. Tətbiqdə Bluetooth-u və Servo kilid şablonunu seç, Kodu al ilə kodu yüklə, platanı siyahıda tap. Öyrənəcəkləriniz: servo bucağı, Bluetooth Low Energy ilə qısa mətn sətirləri və platanın vəziyyətini panelə bildirməsi.

Video

Dövrə sxemi

ESP32 Bluetooth servo kilid - Dövrə sxemi

Mənbə kodu

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

Tez-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.