ES-107Anfänger

ESP32 Bluetooth-Auto (L298N)

Steuere ein zweirädriges Auto per Bluetooth mit dem Joystick auf deinem Handy; ohne Internet, auf iPhone und Android. Dieses Projekt ist die Schritt-für-Schritt-Anleitung zur Bluetooth-Vorlage Auto-Fernbedienung in der App, gebaut mit ESP32, L298N und zwei Motoren. Geh zu Werkstatt › Geräte › Gerät hinzufügen › Bluetooth, wähl Auto-Fernbedienung und lade den Code aus Code holen hoch. Die Taste Als Bluetooth-Panel einrichten öffnet den Assistenten mit dieser Vorlage.

0.0(0)
1 abgeschlossen
ESP32 Bluetooth-Auto (L298N)
Wie wäre es, mit deinem Handy ein selbst gebautes Auto durch die Wohnung zu steuern? Das eingebaute Bluetooth des ESP32 spricht direkt mit deinem Handy, ohne Internet, Router oder Zusatzmodul. Füg in der App ein Bluetooth-Gerät hinzu, wähl die Vorlage Auto-Fernbedienung, lade den Code aus Code holen hoch und verbinde dich mit deinem Board aus der Liste. Ziehst du den Joystick, fährt das Auto, lässt du los, hält es; dazu kommen Pfeiltasten, ein Tempo-Regler und eine Vollbildansicht. Die Taste Als Bluetooth-Panel einrichten auf dieser Seite führt direkt zum Assistenten. Du lernst: Befehle über Bluetooth Low Energy empfangen, Motorrichtung und PWM-Tempo mit dem L298N, Joystick-Mischung und einen Sicherheitsstopp.

Video

Schaltplan

ESP32 Bluetooth-Auto (L298N) - Schaltplan

Quellcode

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Araba                  │
5// └───────────────────────────┘
6// Auto-Fernbedienung
7// Board in der Arduino IDE: ESP32 Dev Module
8// die BLE-Bibliothek kommt mit dem ESP32-Boardpaket, nichts extra zu installieren
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Araba";  // das Board sendet unter diesem Namen, die App findet es damit in der Liste
15
16// Pins: hier ändern, wenn du anders verkabelt hast
17const int ENA = 14, IN1 = 27, IN2 = 26;  // Motor A (ENA, IN1, IN2) ist das linke Rad, Motor B (ENB, IN3, IN4) das rechte
18const int ENB = 32, IN3 = 25, IN4 = 33;
19const unsigned long COMMAND_TIMEOUT_MS = 500;  // Sicherheit: Kommt 500 ms lang kein Befehl, stoppen die Motoren (beim Fahren wiederholt die App ihn)
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Die App sendet Zeilen im Format "Schlüssel=Wert"; bei "?" schickt das Board alle Werte ──
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");  // die Zeile "@v" meldet der App die Codeversion
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// eingehende Bytes gelangen über einen kleinen Ringpuffer vom Bluetooth-Task in loop()
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// Zeilen gehen in 20-Byte-Paketen raus (klappt mit jedem Handy)
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;  // Tempolimit aus der App (0–100 %)
156unsigned long lastCommandMs = 0;
157bool moving = false;
158
159// fährt das Auto rückwärts, tausche die zwei Kabel dieses Motors
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 vor/zurück, x lenkt; daraus werden linke und rechte Radgeschwindigkeit
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);  // Verbindung weg: die Motoren stoppen
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

Klappt das mit dem iPhone? Was ist der Unterschied zum HC-05?

Ja, es läuft auf iPhone und Android. Klassische Bluetooth-Module wie HC-05 und HC-06 können sich nicht mit einem iPhone verbinden, deshalb nutzt dieses Projekt das eingebaute Bluetooth Low Energy des ESP32, ein Zusatzmodul brauchst du nicht. Versuch nicht, das Board in den Bluetooth-Einstellungen des Handys zu koppeln; die Verbindung stellt nur die BlueGrays-App her.

Das Auto fährt rückwärts oder ein Rad dreht falsch herum.

Tausch die beiden Kabel des falsch drehenden Motors an der Schraubklemme des L298N (linker Motor OUT1/OUT2, rechter Motor OUT3/OUT4); das sagt auch der Kommentar im Code. Dreht sich das Auto bei Vorwärts auf der Stelle, ist nur ein Motor verpolt. Drehen beide richtig, aber links lenkt nach rechts, tausch linken und rechten Motor.

Wie versorge ich den ESP32? Dürfen USB und Batterie gleichzeitig dran sein?

Die 2× 18650 Akkus (7,4 V) gehen an den 12V-Eingang des L298N, und dessen 5V-Ausgang versorgt den VIN-Pin des ESP32; dafür muss der 5V-Regler-Jumper auf dem L298N gesteckt bleiben. So fährt das Auto ohne Kabel. Steckt beim Hochladen USB, schalte die Batterie aus oder zieh das 5V-Kabel ab, damit sich die beiden Versorgungen nicht stören. GND des L298N und GND des ESP32 müssen immer verbunden sein.

Wie groß ist die Reichweite? Was macht das Auto, wenn die Verbindung abreißt?

Bluetooth Low Energy reicht im Freien meist 10 bis 30 Meter; Wände und Menschen dazwischen verkürzen das. Reißt die Verbindung ab, stoppt das Board sofort die Motoren und sendet wieder, sodass du dich in der App neu verbinden kannst. Kommt 500 ms lang kein Befehl, hält das Auto ebenfalls an, es fährt dir also nie davon.