ES-113Pemula

Sensor parkir Bluetooth dengan ESP32 (HC-SR04)

Ukur jarak ke halangan dengan HC-SR04 dan pantau di telefonmu; buzzer berbunyi bip lebih pantas apabila semakin dekat. Tanpa internet. Panduan langkah demi langkah bagi templat Bluetooth Sensor parkir dalam aplikasi, dibina dengan ESP32. Pergi ke Bengkelku › Peranti › Tambah peranti › Bluetooth, pilih Sensor parkir dan muat naik kod dengan Dapatkan kod. Butang Sediakan sebagai panel Bluetooth di halaman ini juga membuka panduan persediaan dengan templat ini.

0.0(0)
Sensor parkir Bluetooth dengan ESP32 (HC-SR04)
Gerakkan tanganmu ke arah sensor: tolok di telefonmu menurun, bunyi bip semakin laju dan pada 10 cm nadanya berterusan. Kira-kira 10 kali sesaat, ESP32 mengukur masa gema ultrasonik, menukarnya kepada jarak dan menghantarnya ke panel melalui Bluetooth; tiada internet diperlukan. Bunyi bip bermula pada 100 cm; suis Bunyi amaran menyenyapkan buzzer sementara bacaan terus diterima. Dalam aplikasi, tambah peranti, pilih Bluetooth dan Sensor parkir, muat naik kod dengan Dapatkan kod dan cari papanmu dalam senarai. Ini projek pembelajaran dan model untuk meja atau kereta mainan, bukan untuk keselamatan pemanduan dalam kenderaan sebenar. Yang kamu pelajari: pengukuran jarak ultrasonik, pembahagi voltan untuk isyarat gema 5 V dan melaporkan bacaan kepada panel.

Video

Gambar Rajah Litar

Sensor parkir Bluetooth dengan ESP32 (HC-SR04) - Gambar Rajah Litar

Kod Sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Park                   │
5// └───────────────────────────┘
6// Parking sensor
7// Arduino IDE board: ESP32 Dev Module
8// the BLE library comes with the ESP32 board package, nothing extra to install
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Park";  // the board advertises with this name, the app finds it in the list by it
15
16// Pins: change them here if you wired differently
17const int TRIG_PIN = 5, ECHO_PIN = 18;  // ECHO outputs 5 V: connect it through a 1k/2k divider
18const int BUZZER_PIN = 19;
19const int ALARM_FROM_CM = 100;  // Alarm: under 100 cm it beeps faster as the obstacle gets closer, continuous under 10 cm
20
21void btWrite(const char *text);
22void onValue(const char *key, const char *value);
23void sendAll();
24void onLinkLost();
25
26// ── The app sends "key=value" lines; on "?" the board sends all its values ──
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");  // the "@v" line tells the app the code version
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// incoming bytes move from the Bluetooth task to loop() through a small ring buffer
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// lines go out in 20-byte packets (works with every phone)
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;  // no echo: nothing within 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

Soalan Lazim

Adakah ia berfungsi dengan iPhone?

Ya. Bluetooth Low Energy (BLE) terbina dalam ESP32 berkomunikasi dengan iPhone dan Android. iPhone tidak dapat bersambung ke modul Bluetooth klasik seperti HC-05 dan HC-06, dan projek ini tidak memerlukannya. Jangan cuba menggandingkan papan dalam tetapan Bluetooth telefonmu; papan BLE mungkin tidak muncul di situ, dan itu perkara biasa. Aplikasi BlueGrays yang membuat sambungan.

Mengapakah saya memerlukan pembahagi voltan? Bolehkah saya menyambungkan ECHO terus ke papan?

HC-SR04 berjalan pada 5 V dan pin ECHOnya mengeluarkan isyarat 5 V. Pin ESP32 berfungsi pada 3.3 V dan tidak tahan 5 V. Perintang 1 kΩ dan 2 kΩ membahagikan isyarat itu supaya kira-kira 3.3 V sampai ke GPIO 18. Jika disambung terus, litar mungkin kelihatan berfungsi, tetapi kamu boleh merosakkan pin; jangan langkau pembahagi. TRIG tidak memerlukan pembahagi, kerana di situ papan yang menghantar isyarat. Jika kamu tiada perintang 2 kΩ, letakkan dua perintang 1 kΩ satu selepas satu lagi (bersiri).

Bolehkah saya memasangnya pada kereta sebenar saya?

Tidak, ini projek pembelajaran dan model. Ia menjalankan tugasnya di atas meja, pada kereta mainan atau apabila kamu mencuba mendekati dinding garaj. HC-SR04 dan breadboard tidak dibuat untuk hujan, lumpur dan getaran; bacaan menjadi salah pada permukaan yang lembut atau condong dan sambungan Bluetooth boleh terputus. Ia bukan sistem parkir untuk keselamatan pemanduan dalam kenderaan sebenar, jadi jangan bergantung padanya di situ.

Adakah ia berbunyi bip apabila tiada telefon yang bersambung?

Ya. Pengukuran dan bunyi bip berlaku pada papan; telefon hanya untuk menunjukkan jarak dan untuk mematikan serta menghidupkan bunyi. Papan bermula dengan Bunyi amaran hidup setiap kali dihidupkan, jadi dengan power bank ia berbunyi bip dari 100 cm tanpa sebarang telefon. Jika sambungan terputus, pengukuran dan bunyi bip diteruskan. Jika kamu menyenyapkannya dengan suis dalam panel, ia kekal senyap sehingga kamu menghidupkan suis semula atau papan dimulakan semula. Internet dan Wi-Fi tidak pernah diperlukan.