ES-107Débutant

Voiture Bluetooth ESP32 (L298N)

Pilote une voiture à deux roues en Bluetooth avec le joystick de ton téléphone ; sans internet, sur iPhone et Android. Ce projet est le guide pas à pas du modèle Bluetooth Télécommande de voiture de l'appli, monté avec un ESP32, un L298N et deux moteurs. Va dans Mon Atelier › Appareils › Ajouter un appareil › Bluetooth, choisis Télécommande de voiture et téléverse le code de Obtenir le code. Le bouton Configurer en panneau Bluetooth ouvre l'assistant avec ce modèle.

0.0(0)
1 terminé
Voiture Bluetooth ESP32 (L298N)
Et si ton téléphone pilotait dans la maison une voiture construite de tes mains ? Le Bluetooth intégré de l'ESP32 se connecte directement au téléphone, sans internet, box ni module en plus. Dans l'appli, ajoute un appareil Bluetooth, choisis le modèle Télécommande de voiture, téléverse le code de Obtenir le code, puis connecte-toi à ta carte. Tu fais glisser le joystick, la voiture roule, tu lâches, elle s'arrête ; il y a aussi des flèches, un curseur de vitesse et une vue plein écran. Le bouton Configurer en panneau Bluetooth de cette page ouvre l'assistant. Tu apprends : recevoir des commandes en Bluetooth Low Energy, sens des moteurs et vitesse PWM avec le L298N, mixage du joystick et arrêt de sécurité.

Vidéo

Schéma du circuit

Voiture Bluetooth ESP32 (L298N) - Schéma du circuit

Code source

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Araba                  │
5// └───────────────────────────┘
6// Télécommande de voiture
7// Carte dans l’IDE Arduino : ESP32 Dev Module
8// la bibliothèque BLE est fournie avec le paquet de cartes ESP32, rien à installer en plus
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Araba";  // la carte s’annonce sous ce nom, l’appli la retrouve ainsi dans la liste
15
16// Broches : modifie-les ici si tu as câblé autrement
17const int ENA = 14, IN1 = 27, IN2 = 26;  // Le moteur A (ENA, IN1, IN2) est la roue gauche, le moteur B (ENB, IN3, IN4) la droite
18const int ENB = 32, IN3 = 25, IN4 = 33;
19const unsigned long COMMAND_TIMEOUT_MS = 500;  // Sécurité : sans commande pendant 500 ms, les moteurs s’arrêtent (l’appli la répète pendant que tu conduis)
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── L’appli envoie des lignes "clé=valeur" ; sur "?", la carte renvoie toutes ses valeurs ──
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");  // la ligne "@v" indique à l’appli la version du code
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// les octets reçus passent de la tâche Bluetooth à loop() par un petit tampon circulaire
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// les lignes partent en paquets de 20 octets (compatible avec tous les téléphones)
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;  // limite de vitesse réglée dans l’appli (0–100 %)
156unsigned long lastCommandMs = 0;
157bool moving = false;
158
159// si la voiture recule au lieu d’avancer, inverse les deux fils de ce moteur
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 avant/arrière, x tourne ; converti en vitesse des roues gauche et droite
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);  // Connexion perdue : les moteurs s’arrêtent
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

Ça marche avec un iPhone ? Quelle différence avec le HC-05 ?

Oui, ça marche sur iPhone et Android. Les modules Bluetooth classiques comme le HC-05 et le HC-06 ne peuvent pas se connecter à un iPhone ; ce projet utilise donc le Bluetooth Low Energy intégré de l'ESP32, sans module en plus. N'essaie pas d'appairer la carte dans les réglages Bluetooth du téléphone ; seule l'appli BlueGrays établit la connexion.

La voiture recule ou une roue tourne à l’envers.

Inverse les deux fils du moteur qui tourne à l'envers sur le bornier du L298N (moteur gauche OUT1/OUT2, moteur droit OUT3/OUT4) ; le commentaire du code le dit aussi. Si la voiture tourne sur place quand tu avances, un seul moteur est inversé. Si les deux tournent dans le bon sens mais que gauche part à droite, échange le moteur gauche et le moteur droit.

Comment alimenter l'ESP32 ? L'USB et la batterie peuvent-ils être branchés en même temps ?

Les 2× 18650 (7,4 V) vont sur l'entrée 12V du L298N, et la sortie 5V du L298N alimente la broche VIN de l'ESP32 ; pour cela, le cavalier du régulateur 5V du L298N doit rester en place. La voiture roule ainsi sans câble. Si l'USB est branché pendant le téléversement, coupe la batterie ou débranche le fil 5V pour que les deux alimentations ne se gênent pas. Le GND du L298N et celui de l'ESP32 doivent toujours être reliés.

Quelle est la portée ? Que fait la voiture si la connexion coupe ?

Le Bluetooth Low Energy porte en général de 10 à 30 mètres en terrain dégagé ; les murs et les personnes entre les deux réduisent cette distance. Si la connexion coupe, la carte arrête aussitôt les moteurs et se remet à émettre, tu peux donc te reconnecter depuis l'appli. La voiture s'arrête aussi si la carte ne reçoit aucune commande pendant 500 ms, elle ne file donc jamais hors de portée.