ES-107Початківець

Машинка з Bluetooth на ESP32 (L298N)

Керуй двоколісною машинкою через Bluetooth джойстиком на телефоні; інтернет не потрібен, працює на iPhone і Android. Цей проєкт є покроковим посібником до Bluetooth-шаблону Пульт для машинки в застосунку, зібраного на ESP32, L298N і двох двигунах. Перейди в Майстерня › Пристрої › Додати пристрій › Bluetooth, вибери «Пульт для машинки» й завантаж код через Отримати код. Кнопка Налаштувати як панель Bluetooth на цій сторінці відкриває майстер із цим шаблоном.

0.0(0)
1 готово
Машинка з Bluetooth на ESP32 (L298N)
Як щодо того, щоб перетворити телефон на пульт і їздити по дому машинкою, яку зібрано власноруч? Вбудований Bluetooth ESP32 під’єднується прямо до телефона, без інтернету, роутера чи додаткового модуля. У застосунку додай новий пристрій Bluetooth, вибери шаблон «Пульт для машинки», завантаж код через «Отримати код», потім знайди свою плату в списку й під’єднайся. Потягни джойстик, і машинка їде, відпусти, і вона зупиняється; є ще клавіші-стрілки, повзунок швидкості й повноекранний режим керування. Кнопка «Налаштувати як панель Bluetooth» на сторінці цього проєкту веде просто до майстра. Що вивчиш: отримання команд через Bluetooth Low Energy, напрямок і швидкість двигунів через PWM з L298N, змішування осей джойстика й аварійну зупинку.

Відео

Схема

Машинка з Bluetooth на ESP32 (L298N) - Схема

Вихідний код

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Araba                  │
5// └───────────────────────────┘
6// Car remote
7// Arduino IDE board: ESP32 Dev Module
8// the BLE library comes with the ESP32 board package, nothing extra to install
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Araba";  // the board advertises with this name, the app finds it in the list by it
15
16// Pins: change them here if you wired differently
17const int ENA = 14, IN1 = 27, IN2 = 26;  // Motor A (ENA, IN1, IN2) is the left wheel, motor B (ENB, IN3, IN4) the right one
18const int ENB = 32, IN3 = 25, IN4 = 33;
19const unsigned long COMMAND_TIMEOUT_MS = 500;  // Safety: the motors stop if no command arrives for 500 ms (the app repeats it while you drive)
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── The app sends "key=value" lines; on "?" the board sends all its values ──
27char line[65];
28uint8_t lineLen = 0;
29unsigned long lastRxMs = 0;
30
31bool is(const char *a, const char *b) { return strcmp(a, b) == 0; }
32bool isOn(const char *v) { return v[0] == '1'; }
33
34void sendText(const char *key, const char *value) {
35  char out[72];
36  snprintf(out, sizeof(out), "%s=%s\n", key, value);
37  btWrite(out);
38}
39
40void sendInt(const char *key, long value) {
41  char text[12];
42  snprintf(text, sizeof(text), "%ld", value);
43  sendText(key, text);
44}
45
46void sendFloat(const char *key, float value) {
47  char text[16];
48  dtostrf(value, 1, 1, text);
49  sendText(key, text);
50}
51
52void handleLine(char *text) {
53  char *eq = strchr(text, '=');
54  if (eq == nullptr) {
55    if (text[strlen(text) - 1] == '?') {
56      btWrite("@v=1.0\n");  // the "@v" line tells the app the code version
57      sendAll();
58    }
59    return;
60  }
61  *eq = '\0';
62  onValue(text, eq + 1);
63}
64
65void feed(char c) {
66  lastRxMs = millis();
67  if (c == '\n' || c == '\r') {
68    if (lineLen == 0) return;
69    line[lineLen] = '\0';
70    lineLen = 0;
71    handleLine(line);
72  } else if (lineLen < sizeof(line) - 1) {
73    line[lineLen++] = c;
74  }
75}
76
77// ── Bluetooth (Nordic UART) ──
78#define UART_SERVICE "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
79#define UART_RX "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
80#define UART_TX "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
81
82BLECharacteristic *txChar = nullptr;
83volatile bool linked = false;
84volatile bool linkLost = false;
85// incoming bytes move from the Bluetooth task to loop() through a small ring buffer
86const int RX_SIZE = 256;
87volatile uint8_t rxBuf[RX_SIZE];
88volatile int rxHead = 0, rxTail = 0;
89
90class ServerEvents : public BLEServerCallbacks {
91  void onConnect(BLEServer *server) override { linked = true; }
92  void onDisconnect(BLEServer *server) override { linked = false; linkLost = true; }
93};
94
95class RxEvents : public BLECharacteristicCallbacks {
96  void onWrite(BLECharacteristic *c) override {
97    auto v = c->getValue();
98    for (size_t i = 0; i < v.length(); i++) {
99      int next = (rxHead + 1) % RX_SIZE;
100      if (next == rxTail) break;
101      rxBuf[rxHead] = (uint8_t)v[i];
102      rxHead = next;
103    }
104  }
105};
106
107// lines go out in 20-byte packets (works with every phone)
108void btWrite(const char *text) {
109  if (!linked || txChar == nullptr) return;
110  size_t n = strlen(text);
111  for (size_t i = 0; i < n; i += 20) {
112    size_t len = n - i < 20 ? n - i : 20;
113    txChar->setValue((uint8_t *)text + i, len);
114    txChar->notify();
115    delay(4);
116  }
117}
118
119void btBegin() {
120  BLEDevice::init(BLE_NAME);
121  BLEServer *server = BLEDevice::createServer();
122  server->setCallbacks(new ServerEvents());
123  BLEService *uart = server->createService(UART_SERVICE);
124  txChar = uart->createCharacteristic(UART_TX, BLECharacteristic::PROPERTY_NOTIFY);
125  txChar->addDescriptor(new BLE2902());
126  BLECharacteristic *rx = uart->createCharacteristic(UART_RX, BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_WRITE_NR);
127  rx->setCallbacks(new RxEvents());
128  uart->start();
129  BLEAdvertisementData adv;
130  adv.setFlags(0x06);
131  adv.setCompleteServices(BLEUUID(UART_SERVICE));
132  BLEAdvertisementData scan;
133  scan.setName(BLE_NAME);
134  BLEAdvertising *advertising = BLEDevice::getAdvertising();
135  advertising->setAdvertisementData(adv);
136  advertising->setScanResponseData(scan);
137  BLEDevice::startAdvertising();
138}
139
140void btPoll() {
141  while (rxTail != rxHead) {
142    char c = (char)rxBuf[rxTail];
143    rxTail = (rxTail + 1) % RX_SIZE;
144    feed(c);
145  }
146  if (linkLost) {
147    linkLost = false;
148    onLinkLost();
149    delay(100);
150    BLEDevice::startAdvertising();
151  }
152}
153
154// ── ESP32 ──
155int speedLimit = 80;  // speed limit from the app (0–100 %)
156unsigned long lastCommandMs = 0;
157bool moving = false;
158
159// if the car drives backwards, swap that motor's two wires
160void motor(int en, int a, int b, int power) {
161  power = constrain(power, -100, 100);
162  digitalWrite(a, power > 0 ? HIGH : LOW);
163  digitalWrite(b, power < 0 ? HIGH : LOW);
164  analogWrite(en, abs(power) * speedLimit * 255L / 10000);
165}
166
167void drive(int left, int right) {
168  motor(ENA, IN1, IN2, left);
169  motor(ENB, IN3, IN4, right);
170  moving = left != 0 || right != 0;
171  lastCommandMs = millis();
172}
173
174void onValue(const char *key, const char *value) {
175  if (is(key, "joy")) {  // Joystick: y is forward/back, x turns; mixed into left and right wheel speeds
176    const char *comma = strchr(value, ',');
177    int x = atoi(value), y = comma ? atoi(comma + 1) : 0;
178    drive(constrain(y + x, -100, 100), constrain(y - x, -100, 100));
179  } else if (is(key, "yon")) {
180    if (is(value, "ileri")) drive(100, 100);
181    else if (is(value, "geri")) drive(-100, -100);
182    else if (is(value, "sol")) drive(-70, 70);
183    else if (is(value, "sag")) drive(70, -70);
184    else drive(0, 0);
185  } else if (is(key, "hiz")) {
186    speedLimit = constrain(atoi(value), 0, 100);
187  }
188}
189
190void sendAll() {
191  sendInt("hiz", speedLimit);
192}
193
194void onLinkLost() {
195  drive(0, 0);  // Connection lost: the motors stop
196}
197
198void setup() {
199  Serial.begin(115200);
200  int pins[] = { ENA, IN1, IN2, ENB, IN3, IN4 };
201  for (int pin : pins) pinMode(pin, OUTPUT);
202  drive(0, 0);
203  btBegin();
204  Serial.print(F("BlueGrays Bluetooth: "));
205  Serial.println(BLE_NAME);
206}
207
208void loop() {
209  btPoll();
210  if (moving && millis() - lastCommandMs > COMMAND_TIMEOUT_MS) drive(0, 0);
211}
212

Поширені запитання

Чи працює з iPhone? Чим це відрізняється від HC-05?

Так, працює на iPhone і Android. Класичні модулі Bluetooth, як-от HC-05 і HC-06, не можуть під’єднатися до iPhone, тому цей проєкт використовує вбудований Bluetooth Low Energy плати ESP32 і не потребує додаткового модуля. Не намагайся з’єднати плату в налаштуваннях Bluetooth телефона; з’єднання встановлює лише застосунок BlueGrays.

Машинка їде назад або одне колесо крутиться не в той бік.

Поміняй місцями два дроти двигуна, що крутиться не в той бік, на гвинтовій клемі L298N (лівий двигун OUT1/OUT2, правий двигун OUT3/OUT4); коментар у коді каже те саме. Якщо машинка крутиться на місці, коли натискаєш «вперед», розвернуто лише один двигун. Якщо обидва крутяться правильно, але вліво кермує вправо, поміняй місцями лівий і правий двигуни.

Як живити ESP32? Чи можна одночасно під’єднати USB і акумулятор?

Акумулятори 2× 18650 (7,4 V) під’єднуються до входу 12V модуля L298N, а вихід 5V модуля L298N живить пін VIN плати ESP32; для цього перемичка стабілізатора 5V на L298N має залишатися на місці. Так машинка їздить без кабелю. Якщо під час завантаження під’єднано USB, вимкни акумулятор або від’єднай дріт 5V, щоб два джерела живлення не конфліктували. GND модуля L298N і GND плати ESP32 завжди мають бути з’єднані.

Яка дальність? Що робить машинка, якщо з’єднання обривається?

Bluetooth Low Energy на відкритому просторі зазвичай дістає на 10–30 м; стіни й люди на шляху зменшують відстань. Якщо з’єднання обривається, плата одразу зупиняє двигуни й знову починає оголошувати себе, тож можна під’єднатися з застосунку ще раз. Машинка також зупиняється, якщо плата 500 мс не отримує команд, тож вона ніколи не втече за межі зв’язку.