ES-107Începător

Mașinuță Bluetooth cu ESP32 (L298N)

Condu o mașinuță cu două roți prin Bluetooth, cu joystick pe telefon, fără internet, pe iPhone și Android. Proiectul explică pas cu pas șablonul Bluetooth Telecomandă auto din aplicație, cu ESP32, L298N și două motoare. Mergi la Atelier › Dispozitive › Adaugă un dispozitiv › Bluetooth, alege Telecomandă auto și încarcă codul din Obține codul. Butonul Configurează ca panou Bluetooth de pe pagină deschide asistentul cu acest șablon.

0.0(0)
1 finalizat
Mașinuță Bluetooth cu ESP32 (L298N)
Ce-ar fi să transformi telefonul într-o telecomandă și să conduci prin casă o mașinuță construită de tine? Funcția Bluetooth integrată în ESP32 permite conectarea directă la telefon, fără internet, router sau modul suplimentar. În aplicație, adaugă un dispozitiv Bluetooth nou, alege șablonul Telecomandă auto, încarcă codul din Obține codul, apoi găsește placa în listă și conectează-te la ea. Trage de joystick și mașinuța pornește; când îi dai drumul, se oprește. Ai și butoane de direcție, un glisor pentru viteză și un mod de condus pe tot ecranul. Butonul Configurează ca panou Bluetooth de pe pagina proiectului te duce direct la asistentul de configurare. Înveți să primești comenzi prin Bluetooth Low Energy, să controlezi sensul motoarelor și viteza prin PWM cu L298N, să combini comenzile joystickului pentru cele două motoare și să implementezi o oprire de siguranță.

Video

Schemă electrică

Mașinuță Bluetooth cu ESP32 (L298N) - Schemă electrică

Cod sursă

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

Întrebări frecvente

Funcționează cu un iPhone? Care este diferența față de HC-05?

Da, funcționează pe iPhone și Android. Modulele Bluetooth clasice, precum HC-05 și HC-06, nu se pot conecta la un iPhone, așa că acest proiect folosește Bluetooth Low Energy integrat în ESP32 și nu necesită un modul suplimentar. Nu încerca să asociezi placa din setările Bluetooth ale telefonului; conexiunea se realizează doar prin aplicația BlueGrays.

De ce merge mașinuța înapoi sau se rotește o roată în sens greșit?

Inversează cele două fire ale motorului care se rotește în sens greșit la bornele cu șurub ale modulului L298N (motorul stâng OUT1/OUT2, motorul drept OUT3/OUT4); comentariul din cod spune același lucru. Dacă mașinuța se rotește pe loc când apeși înainte, doar un motor are sensul inversat. Dacă ambele se rotesc corect, dar mașinuța virează la dreapta când apeși stânga, schimbă între ele conexiunile motoarelor stâng și drept.

Cum alimentez placa ESP32? Pot conecta simultan USB-ul și acumulatorii?

Cei 2 acumulatori 18650 (7,4 V) se conectează la intrarea 12V a modulului L298N, iar ieșirea 5V a acestuia alimentează pinul VIN al plăcii ESP32; pentru asta, jumperul regulatorului 5V de pe L298N trebuie să rămână montat. Astfel, mașinuța funcționează fără cablu. Dacă ai conectat USB-ul pentru încărcarea codului, oprește alimentarea de la acumulatori sau deconectează firul 5V, ca cele două surse să nu interfereze. GND de pe L298N și GND de pe ESP32 trebuie să fie mereu conectate între ele.

Care este raza de acțiune? Ce face mașinuța dacă se pierde conexiunea?

Bluetooth Low Energy are de obicei o rază de acțiune între 10 și 30 de metri în spațiu deschis; pereții și oamenii aflați în cale reduc această distanță. Dacă se pierde conexiunea, placa oprește imediat motoarele și devine din nou detectabilă, ca să te poți reconecta din aplicație. Mașinuța se oprește și dacă placa nu primește nicio comandă timp de 500 ms, așa că nu continuă să meargă când iese din raza de acțiune.