ES-113Pemula

ESP32 Bluetooth Sensor Parkir (HC-SR04)

Ukur jarak ke penghalang dengan HC-SR04 dan pantau di ponselmu; buzzer berbunyi makin cepat saat penghalang mendekat. Tanpa internet. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth Sensor parkir di aplikasi, dirakit dengan ESP32. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Sensor parkir, lalu unggah kode lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini membuka wizard yang sama.

0.0(0)
ESP32 Bluetooth Sensor Parkir (HC-SR04)
Dekatkan tanganmu ke sensor: penunjuk di ponsel turun, bunyi bip makin cepat, dan pada 10 cm suaranya terus-menerus. Sekitar 10 kali per detik ESP32 mengukur waktu pantulan ultrasonik, mengubahnya menjadi jarak, lalu mengirimnya ke panel lewat Bluetooth; tanpa internet. Bip mulai pada 100 cm; sakelar Bunyi peringatan membungkam buzzer, sementara pengukuran tetap jalan. Di aplikasi, tambah perangkat, pilih Bluetooth dan Sensor parkir, unggah kode lewat Ambil kodenya, lalu cari board-mu di daftar. Ini proyek belajar dan maket untuk meja atau mobil mainan, bukan untuk keselamatan berkendara di kendaraan sungguhan. Yang dipelajari: pengukuran ultrasonik, pembagi tegangan untuk sinyal pantulan 5 V, dan mengirim hasil ukur ke panel.

Video

Skema rangkaian

ESP32 Bluetooth Sensor Parkir (HC-SR04) - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Park                   │
5// └───────────────────────────┘
6// Sensor parkir
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-Park";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
15
16// Pin: ubah di sini kalau sambunganmu berbeda
17const int TRIG_PIN = 5, ECHO_PIN = 18;  // ECHO mengeluarkan 5 V: sambungkan lewat pembagi 1k/2k
18const int BUZZER_PIN = 19;
19const int ALARM_FROM_CM = 100;  // Alarm: di bawah 100 cm berbunyi makin cepat saat halangan mendekat, terus-menerus di bawah 10 cm
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 ──
155bool alarmOn = true;
156bool buzzing = false;
157int distanceCm = -1, sentCm = -100;
158unsigned long lastMeasureMs = 0, lastSentMs = 0, lastBeepMs = 0;
159
160int measureCm() {
161  digitalWrite(TRIG_PIN, LOW);
162  delayMicroseconds(2);
163  digitalWrite(TRIG_PIN, HIGH);
164  delayMicroseconds(10);
165  digitalWrite(TRIG_PIN, LOW);
166  unsigned long us = pulseIn(ECHO_PIN, HIGH, 25000UL);
167  if (us == 0) return 400;  // tidak ada pantulan: tak ada benda dalam 4 m
168  return min(400UL, us / 58);
169}
170
171void buzz(bool on) {
172  if (on == buzzing) return;
173  buzzing = on;
174  if (on) tone(BUZZER_PIN, 2000);
175  else noTone(BUZZER_PIN);
176}
177
178void onValue(const char *key, const char *value) {
179  if (is(key, "alarm")) alarmOn = isOn(value);
180}
181
182void sendAll() {
183  if (distanceCm >= 0) sendInt("mesafe", distanceCm);
184  sendInt("alarm", alarmOn);
185}
186
187void onLinkLost() {
188}
189
190void setup() {
191  Serial.begin(115200);
192  pinMode(TRIG_PIN, OUTPUT);
193  pinMode(ECHO_PIN, INPUT);
194  pinMode(BUZZER_PIN, OUTPUT);
195  btBegin();
196  Serial.print(F("BlueGrays Bluetooth: "));
197  Serial.println(BLE_NAME);
198}
199
200void loop() {
201  btPoll();
202  if (millis() - lastMeasureMs >= 100) {
203    lastMeasureMs = millis();
204    distanceCm = measureCm();
205    if ((distanceCm != sentCm && millis() - lastSentMs >= 250) || millis() - lastSentMs >= 2000) {
206      sendInt("mesafe", distanceCm);
207      sentCm = distanceCm;
208      lastSentMs = millis();
209    }
210  }
211  if (!alarmOn || distanceCm < 0 || distanceCm > ALARM_FROM_CM) {
212    buzz(false);
213  } else if (distanceCm <= 10) {
214    buzz(true);
215  } else if (millis() - lastBeepMs >= (unsigned long)map(distanceCm, 10, ALARM_FROM_CM, 60, 600)) {
216    lastBeepMs = millis();
217    buzz(!buzzing);
218  }
219}
220

FAQ

Apakah bisa dipakai dengan iPhone?

Bisa. Bluetooth Low Energy (BLE) bawaan ESP32 bisa berkomunikasi dengan iPhone dan Android. iPhone tidak bisa tersambung ke modul Bluetooth klasik seperti HC-05 dan HC-06, dan proyek ini memang tidak memakainya. Jangan coba memasangkan (pairing) board dari pengaturan Bluetooth ponsel; board BLE bisa saja tidak muncul di sana, itu normal. Sambungannya dibuat oleh aplikasi BlueGrays.

Kenapa perlu pembagi tegangan? Bolehkah ECHO disambung langsung?

HC-SR04 bekerja dengan 5 V dan pin ECHO mengeluarkan sinyal 5 V. Pin ESP32 bekerja pada 3,3 V dan tidak tahan 5 V. Resistor 1 kΩ dan 2 kΩ membagi sinyal itu sehingga yang sampai di GPIO 18 sekitar 3,3 V. Kalau disambung langsung, rangkaian bisa saja tampak berfungsi, tetapi pin berisiko rusak; jangan lewati pembagi tegangan. TRIG tidak perlu pembagi, karena di sana board yang mengirim sinyal. Kalau tidak punya resistor 2 kΩ, sambungkan dua resistor 1 kΩ secara seri.

Bolehkah ini dipasang di mobil sungguhan?

Tidak, ini proyek belajar dan maket. Proyek ini cocok di atas meja, di mobil mainan, atau saat mencoba mendekati dinding garasi. HC-SR04 dan breadboard tidak dibuat untuk hujan, lumpur, dan getaran; permukaan yang lunak atau miring membuat pengukuran meleset, dan sambungan Bluetooth bisa putus. Ini bukan sistem parkir untuk keselamatan berkendara di kendaraan sungguhan, jadi jangan mengandalkannya di sana.

Apakah tetap berbunyi tanpa ponsel yang tersambung?

Ya. Pengukuran dan bunyi bip berjalan di board; ponsel hanya menampilkan jarak dan menyalakan atau mematikan suara. Setiap kali dinyalakan, board mulai dengan Bunyi peringatan aktif, jadi dengan power bank ia berbunyi mulai 100 cm tanpa ponsel. Kalau sambungan putus, pengukuran dan bunyi tetap jalan. Kalau suara dimatikan lewat sakelar di panel, board tetap diam sampai suara dinyalakan lagi atau board dinyalakan ulang. Internet dan Wi-Fi tidak diperlukan sama sekali.