ES-107Pemula

Mobil Bluetooth ESP32 (L298N)

Kemudikan mobil roda dua lewat Bluetooth dengan joystick di ponselmu; tanpa internet, jalan di iPhone dan Android. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth Remote mobil di aplikasi, dirakit dengan ESP32, L298N, dan dua motor. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Remote mobil, lalu unggah kode dari Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini membuka wizard dengan template ini.

0.0(0)
1 selesai
Mobil Bluetooth ESP32 (L298N)
Bagaimana kalau ponselmu jadi remote dan kamu mengendarai mobil buatanmu sendiri keliling rumah? Bluetooth bawaan ESP32 tersambung langsung ke ponsel, tanpa internet, router, atau modul tambahan. Di aplikasi, tambahkan perangkat Bluetooth, pilih template Remote mobil, unggah kode dari Ambil kodenya, lalu sambungkan ke board-mu. Geser joystick dan mobil melaju, lepaskan dan mobil berhenti; ada juga tombol arah, slider kecepatan, dan tampilan layar penuh. Tombol Siapkan sebagai panel Bluetooth di halaman proyek ini membawamu langsung ke wizard. Yang dipelajari: menerima perintah lewat Bluetooth Low Energy, arah motor dan kecepatan PWM dengan L298N, pencampuran joystick, dan berhenti otomatis demi keamanan.

Video

Skema rangkaian

Mobil Bluetooth ESP32 (L298N) - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Araba                  │
5// └───────────────────────────┘
6// Remote mobil
7// Board di Arduino IDE: ESP32 Dev Module
8// library BLE sudah ikut paket board ESP32, tidak perlu pasang apa-apa lagi
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Araba";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
15
16// Pin: ubah di sini kalau sambunganmu berbeda
17const int ENA = 14, IN1 = 27, IN2 = 26;  // Motor A (ENA, IN1, IN2) roda kiri, motor B (ENB, IN3, IN4) roda kanan
18const int ENB = 32, IN3 = 25, IN4 = 33;
19const unsigned long COMMAND_TIMEOUT_MS = 500;  // Keamanan: jika 500 ms tidak ada perintah, motor berhenti (aplikasi mengulang perintah selama kamu menyetir)
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── Aplikasi mengirim baris "kunci=nilai"; saat menerima "?" papan mengirim semua nilainya ──
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");  // baris "@v" memberi tahu aplikasi versi kodenya
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// byte yang masuk dipindah dari tugas Bluetooth ke loop() lewat buffer cincin kecil
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// baris dikirim dalam paket 20 byte (bisa di semua ponsel)
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;  // batas kecepatan dari aplikasi (0–100 %)
156unsigned long lastCommandMs = 0;
157bool moving = false;
158
159// kalau mobil berjalan mundur, tukar dua kabel motor itu
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 maju/mundur, x belok; diubah jadi kecepatan roda kiri dan kanan
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);  // Koneksi terputus: motor berhenti
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

Apakah bisa dengan iPhone? Apa bedanya dengan HC-05?

Bisa, jalan di iPhone dan Android. Modul Bluetooth klasik seperti HC-05 dan HC-06 tidak bisa tersambung ke iPhone, karena itu proyek ini memakai Bluetooth Low Energy bawaan ESP32 dan tidak butuh modul tambahan. Jangan coba memasangkan board lewat pengaturan Bluetooth ponsel; sambungan hanya dibuat oleh aplikasi BlueGrays.

Mobil berjalan mundur atau satu roda berputar terbalik.

Tukar dua kabel motor yang berputar terbalik di terminal sekrup L298N (motor kiri OUT1/OUT2, motor kanan OUT3/OUT4); komentar di kode juga bilang begitu. Kalau saat maju mobil malah berputar di tempat, hanya satu motor yang terbalik. Kalau keduanya berputar benar tapi kiri malah belok ke kanan, tukar posisi motor kiri dan kanan.

Bagaimana memberi daya ESP32? Boleh USB dan baterai tersambung bersamaan?

Baterai 2× 18650 (7,4 V) masuk ke input 12V L298N, dan output 5V L298N memberi daya ke pin VIN ESP32; untuk itu jumper regulator 5V di L298N harus tetap terpasang. Dengan begitu mobil jalan tanpa kabel. Kalau USB tersambung saat mengunggah kode, matikan baterai atau cabut kabel 5V supaya dua sumber daya tidak bertabrakan. GND L298N dan GND ESP32 harus selalu tersambung.

Berapa jangkauannya? Apa yang terjadi kalau koneksi putus?

Bluetooth Low Energy biasanya menjangkau 10 sampai 30 meter di area terbuka; dinding dan orang di antaranya memperpendek jarak itu. Kalau koneksi putus, board langsung menghentikan motor dan mulai memancarkan sinyal lagi, jadi kamu bisa menyambung ulang dari aplikasi. Mobil juga berhenti kalau board tidak menerima perintah selama 500 ms, jadi mobil tidak akan kabur keluar jangkauan.