ES-107初級

ESP32 Bluetoothラジコンカー(L298N)

スマホのジョイスティックで、2輪の車をBluetoothで走らせます。インターネットは不要で、iPhoneでもAndroidでも動きます。このプロジェクトは、アプリのBluetoothテンプレートラジコンカーの手順ガイドです。ESP32、L298N、モーター2個で組み立てます。マイ工房 › デバイス › デバイスを追加 › Bluetoothからラジコンカーを選び、コードを取得のコードをボードに書き込みます。このページのBluetoothパネルとして設定ボタンを押すと、このテンプレートでウィザードが開きます。

0.0(0)
1 完了
ESP32 Bluetoothラジコンカー(L298N)
スマホをリモコンにして、自分で作った車を部屋の中で走らせてみませんか?ESP32に内蔵のBluetoothがスマホに直接つながるので、インターネットもルーターも追加のモジュールもいりません。アプリで新しいBluetoothデバイスを追加し、ラジコンカーのテンプレートを選び、コードを取得のコードをボードに書き込んだら、一覧でボードを見つけて接続します。ジョイスティックをドラッグすると車が走り、指を離すと止まります。方向キー、速度スライダー、全画面の運転画面もあります。このプロジェクトページのBluetoothパネルとして設定ボタンから、すぐにウィザードへ進めます。学べること:Bluetooth Low Energyでのコマンド受信、L298Nによるモーターの向きとPWMでの速度調整、ジョイスティックのミキシング、安全のための自動停止。

動画

回路図

ESP32 Bluetoothラジコンカー(L298N) - 回路図

ソースコード

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Araba                  │
5// └───────────────────────────┘
6// ラジコンカー
7// Arduino IDEのボード:ESP32 Dev Module
8// BLEライブラリはESP32ボードパッケージに含まれているので、追加のインストールは不要です
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Araba";  // ボードはこの名前で発信し、アプリは一覧でこの名前を探します
15
16// ピン:配線が違う場合はここを変更してください
17const int ENA = 14, IN1 = 27, IN2 = 26;  // モーターA(ENA, IN1, IN2)が左車輪、モーターB(ENB, IN3, IN4)が右車輪です
18const int ENB = 32, IN3 = 25, IN4 = 33;
19const unsigned long COMMAND_TIMEOUT_MS = 500;  // 安全対策:500 msコマンドが来なければモーターは止まります(運転中はアプリがコマンドを繰り返し送ります)
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── アプリは「キー=値」の行を送ります。「?」を受け取るとボードは全部の値を返します ──
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");  // 「@v」の行でアプリにコードのバージョンを伝えます
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// 受信したバイトは小さなリングバッファを通ってBluetoothタスクから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// 行は20バイトずつのパケットで送ります(どのスマホでも動きます)
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;  // アプリで決める速度の上限(0〜100 %)
156unsigned long lastCommandMs = 0;
157bool moving = false;
158
159// 車が逆に進む場合は、そのモーターの2本の線を入れ替えてください
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")) {  // ジョイスティック:yで前後、xで旋回。左右の車輪の速さに変換します
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);  // 接続が切れたらモーターを止めます
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でも使えます。HC-05やHC-06のようなクラシックBluetoothモジュールはiPhoneにつながりません。そのためこのプロジェクトではESP32に内蔵のBluetooth Low Energyを使い、追加のモジュールは不要です。スマホのBluetooth設定でボードをペアリングしようとしないでください。接続はBlueGraysアプリだけが行います。

車が後ろに進む、または片方の車輪が逆に回ります。

逆に回るモーターの2本の線を、L298Nのネジ端子で入れ替えてください(左モーターはOUT1/OUT2、右モーターはOUT3/OUT4)。コードのコメントにも同じことが書いてあります。前進を押したのにその場で回る場合は、モーター1個だけが逆です。両方正しく回るのに左を押すと右に曲がる場合は、左右のモーターを入れ替えます。

ESP32の電源はどうしますか?USBと電池を同時につないでもいいですか?

18650電池2本(7.4 V)をL298Nの12V入力につなぎ、L298Nの5V出力からESP32のVINピンに給電します。そのためL298Nの5Vレギュレーター用ジャンパーは付けたままにします。これで車はケーブルなしで走ります。書き込みのときにUSBをつないでいるなら、電池のスイッチを切るか5Vの線を外して、2つの電源がぶつからないようにしてください。L298NのGNDとESP32のGNDは必ずつないでおきます。

届く距離はどのくらいですか?接続が切れたら車はどうなりますか?

Bluetooth Low Energyは見通しのよい場所でふつう10〜30メートルほど届きます。壁や人が間にあると短くなります。接続が切れると、ボードはすぐにモーターを止めて再び発信を始めるので、アプリからもう一度接続できます。500 msコマンドが届かないときも車は止まるので、圏外へ走り去ることはありません。