ES-107Cơ bản

Xe Bluetooth với ESP32 (L298N)

Lái một chiếc xe hai bánh qua Bluetooth bằng joystick trên điện thoại; không cần internet, chạy trên cả iPhone và Android. Dự án này là hướng dẫn từng bước cho mẫu Bluetooth Điều khiển xe trong ứng dụng, làm với ESP32, L298N và hai động cơ. Vào Xưởng › Thiết bị › Thêm thiết bị › Bluetooth, chọn Điều khiển xe và nạp code từ Lấy code. Nút Cài đặt thành bảng điều khiển Bluetooth trên trang này mở trình hướng dẫn với mẫu này.

0.0(0)
1 đã hoàn thành
Xe Bluetooth với ESP32 (L298N)
Bạn thấy sao nếu biến điện thoại thành remote và lái chiếc xe tự làm đi khắp nhà? Bluetooth tích hợp của ESP32 kết nối thẳng với điện thoại, không cần internet, router hay module thêm nào. Trong ứng dụng, thêm một thiết bị Bluetooth mới, chọn mẫu Điều khiển xe, nạp code từ Lấy code, rồi tìm bo mạch của bạn trong danh sách và kết nối. Kéo joystick là xe chạy, thả tay là xe dừng; còn có các phím mũi tên, thanh trượt tốc độ và chế độ lái toàn màn hình. Nút Cài đặt thành bảng điều khiển Bluetooth trên trang dự án này đưa bạn thẳng tới trình hướng dẫn. Bạn học được: nhận lệnh qua Bluetooth Low Energy, chiều quay động cơ và tốc độ PWM với L298N, trộn tín hiệu joystick và dừng an toàn.

Video

Sơ đồ mạch

Xe Bluetooth với ESP32 (L298N) - Sơ đồ mạch

Mã nguồn

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

FAQ

Nó có chạy với iPhone không? Nó khác HC-05 ở điểm nào?

Có, nó chạy trên iPhone và Android. Các module Bluetooth cổ điển như HC-05 và HC-06 không kết nối được với iPhone, nên dự án này dùng Bluetooth Low Energy tích hợp của ESP32 và không cần module thêm. Đừng cố ghép nối bo mạch trong cài đặt Bluetooth của điện thoại; chỉ ứng dụng BlueGrays mới tạo kết nối.

Xe chạy lùi hoặc một bánh quay sai chiều.

Đổi chỗ hai dây của động cơ quay sai chiều ở cầu đấu dây của L298N (động cơ trái OUT1/OUT2, động cơ phải OUT3/OUT4); chú thích trong code cũng nói như vậy. Nếu xe xoay tại chỗ khi bạn nhấn tiến, chỉ có một động cơ bị ngược. Nếu cả hai quay đúng chiều nhưng rẽ trái lại thành rẽ phải, hãy đổi chỗ động cơ trái và phải.

Mình cấp nguồn cho ESP32 thế nào? Có thể nối USB và pin cùng lúc không?

2 pin 18650 (7,4 V) nối vào ngõ vào 12V của L298N, còn ngõ ra 5V của L298N cấp nguồn cho chân VIN của ESP32; để làm vậy, jumper mạch ổn áp 5V trên L298N phải được giữ nguyên. Nhờ vậy xe chạy mà không cần cáp. Nếu cắm USB trong lúc nạp code, hãy tắt pin hoặc rút dây 5V để hai nguồn không xung đột. GND của L298N và GND của ESP32 phải luôn được nối với nhau.

Tầm hoạt động bao xa? Xe làm gì nếu mất kết nối?

Bluetooth Low Energy thường đạt 10 đến 30 mét ở chỗ thoáng; tường và người chắn ở giữa sẽ làm giảm khoảng cách đó. Nếu mất kết nối, bo mạch dừng động cơ ngay lập tức và bắt đầu phát tín hiệu quảng bá lại, để bạn có thể kết nối lại từ ứng dụng. Xe cũng dừng nếu bo mạch không nhận được lệnh nào trong 500 ms, nên nó không bao giờ chạy mất ra ngoài tầm phủ sóng.