ES-114Pemula

ESP32 Bluetooth Piano Ponsel

Ubah ponselmu jadi piano 8 tuts: tekan satu tuts dan buzzer pasif di ESP32 membunyikan nadanya, tanpa internet atau Wi-Fi. Ini panduan langkah demi langkah untuk template Bluetooth Piano ponsel di aplikasi, dirakit dengan buzzer dan dua kabel jumper. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Piano ponsel, lalu unggah kode lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini juga membuka wizard yang sama.

0.0(0)
ESP32 Bluetooth Piano Ponsel
Tekan satu tuts di ponselmu dan buzzer di mejamu membunyikan Do; lepas, dan ia diam: tanpa internet, router, atau server. ESP32 sudah punya Bluetooth bawaan, jadi ponsel tersambung langsung ke board. Delapan tuts berjajar dari Do rendah sampai Do tinggi. Saat tuts ditekan, ponsel mengirim frekuensi nadanya (262 Hz untuk Do rendah); saat dilepas, ponsel mengirim 0. Kalau sambungan putus, board diam sendiri. Rangkaiannya: satu buzzer pasif dan dua kabel, tanpa breadboard. Di aplikasi, pilih Bluetooth dan template Piano ponsel, unggah kode lewat Ambil kodenya, lalu cari board-mu di daftar. Yang dipelajari: Bluetooth Low Energy dengan baris teks pendek, frekuensi yang menentukan nada, dan beda buzzer pasif dengan aktif.

Video

Skema rangkaian

ESP32 Bluetooth Piano Ponsel - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Piyano                 │
5// └───────────────────────────┘
6// Piano ponsel
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-Piyano";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
15
16// Pin: ubah di sini kalau sambunganmu berbeda
17const int BUZZER_PIN = 25;  // pakai buzzer pasif (buzzer aktif hanya punya satu nada)
18
19void btWrite(const char *text);
20void onValue(const char *key, const char *value);
21void sendAll();
22void onLinkLost();
23
24// ── Aplikasi mengirim baris "kunci=nilai"; saat menerima "?" papan mengirim semua nilainya ──
25char line[65];
26uint8_t lineLen = 0;
27unsigned long lastRxMs = 0;
28
29bool is(const char *a, const char *b) { return strcmp(a, b) == 0; }
30bool isOn(const char *v) { return v[0] == '1'; }
31
32void sendText(const char *key, const char *value) {
33  char out[72];
34  snprintf(out, sizeof(out), "%s=%s\n", key, value);
35  btWrite(out);
36}
37
38void sendInt(const char *key, long value) {
39  char text[12];
40  snprintf(text, sizeof(text), "%ld", value);
41  sendText(key, text);
42}
43
44void sendFloat(const char *key, float value) {
45  char text[16];
46  dtostrf(value, 1, 1, text);
47  sendText(key, text);
48}
49
50void handleLine(char *text) {
51  char *eq = strchr(text, '=');
52  if (eq == nullptr) {
53    if (text[strlen(text) - 1] == '?') {
54      btWrite("@v=1.0\n");  // baris "@v" memberi tahu aplikasi versi kodenya
55      sendAll();
56    }
57    return;
58  }
59  *eq = '\0';
60  onValue(text, eq + 1);
61}
62
63void feed(char c) {
64  lastRxMs = millis();
65  if (c == '\n' || c == '\r') {
66    if (lineLen == 0) return;
67    line[lineLen] = '\0';
68    lineLen = 0;
69    handleLine(line);
70  } else if (lineLen < sizeof(line) - 1) {
71    line[lineLen++] = c;
72  }
73}
74
75// ── Bluetooth (Nordic UART) ──
76#define UART_SERVICE "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
77#define UART_RX "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
78#define UART_TX "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
79
80BLECharacteristic *txChar = nullptr;
81volatile bool linked = false;
82volatile bool linkLost = false;
83// byte yang masuk dipindah dari tugas Bluetooth ke loop() lewat buffer cincin kecil
84const int RX_SIZE = 256;
85volatile uint8_t rxBuf[RX_SIZE];
86volatile int rxHead = 0, rxTail = 0;
87
88class ServerEvents : public BLEServerCallbacks {
89  void onConnect(BLEServer *server) override { linked = true; }
90  void onDisconnect(BLEServer *server) override { linked = false; linkLost = true; }
91};
92
93class RxEvents : public BLECharacteristicCallbacks {
94  void onWrite(BLECharacteristic *c) override {
95    auto v = c->getValue();
96    for (size_t i = 0; i < v.length(); i++) {
97      int next = (rxHead + 1) % RX_SIZE;
98      if (next == rxTail) break;
99      rxBuf[rxHead] = (uint8_t)v[i];
100      rxHead = next;
101    }
102  }
103};
104
105// baris dikirim dalam paket 20 byte (bisa di semua ponsel)
106void btWrite(const char *text) {
107  if (!linked || txChar == nullptr) return;
108  size_t n = strlen(text);
109  for (size_t i = 0; i < n; i += 20) {
110    size_t len = n - i < 20 ? n - i : 20;
111    txChar->setValue((uint8_t *)text + i, len);
112    txChar->notify();
113    delay(4);
114  }
115}
116
117void btBegin() {
118  BLEDevice::init(BLE_NAME);
119  BLEServer *server = BLEDevice::createServer();
120  server->setCallbacks(new ServerEvents());
121  BLEService *uart = server->createService(UART_SERVICE);
122  txChar = uart->createCharacteristic(UART_TX, BLECharacteristic::PROPERTY_NOTIFY);
123  txChar->addDescriptor(new BLE2902());
124  BLECharacteristic *rx = uart->createCharacteristic(UART_RX, BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_WRITE_NR);
125  rx->setCallbacks(new RxEvents());
126  uart->start();
127  BLEAdvertisementData adv;
128  adv.setFlags(0x06);
129  adv.setCompleteServices(BLEUUID(UART_SERVICE));
130  BLEAdvertisementData scan;
131  scan.setName(BLE_NAME);
132  BLEAdvertising *advertising = BLEDevice::getAdvertising();
133  advertising->setAdvertisementData(adv);
134  advertising->setScanResponseData(scan);
135  BLEDevice::startAdvertising();
136}
137
138void btPoll() {
139  while (rxTail != rxHead) {
140    char c = (char)rxBuf[rxTail];
141    rxTail = (rxTail + 1) % RX_SIZE;
142    feed(c);
143  }
144  if (linkLost) {
145    linkLost = false;
146    onLinkLost();
147    delay(100);
148    BLEDevice::startAdvertising();
149  }
150}
151
152// ── ESP32 ──
153void onValue(const char *key, const char *value) {
154  if (is(key, "nota")) {  // "nota=Hz" membunyikan nada, "nota=0" menghentikannya
155    int hz = atoi(value);
156    if (hz > 0) tone(BUZZER_PIN, hz);
157    else noTone(BUZZER_PIN);
158  }
159}
160
161void sendAll() {
162  sendInt("nota", 0);
163}
164
165void onLinkLost() {
166  noTone(BUZZER_PIN);  // Koneksi terputus: suara berhenti
167}
168
169void setup() {
170  Serial.begin(115200);
171  pinMode(BUZZER_PIN, OUTPUT);
172  btBegin();
173  Serial.print(F("BlueGrays Bluetooth: "));
174  Serial.println(BLE_NAME);
175}
176
177void loop() {
178  btPoll();
179}
180

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.

Apa beda buzzer aktif dan buzzer pasif, dan mana yang dibutuhkan?

Proyek ini butuh buzzer pasif. Buzzer pasif bekerja seperti speaker mungil: ia membunyikan frekuensi apa pun yang kamu kirim. Buzzer aktif punya rangkaian sendiri di dalamnya dan selalu mengeluarkan bunyi tetap yang sama begitu diberi tegangan, jadi tuts tidak bisa dibedakan. Proyek ini bisa menunjukkan jenis buzzer yang kamu punya: kalau tiap tuts menghasilkan nada berbeda, itu pasif; kalau semua tuts berbunyi dengung yang sama, itu aktif. Saat membeli, cari kata pasif (passive) di nama produknya.

Bisakah menekan dua tuts sekaligus untuk memainkan akor?

Tidak. Buzzer hanya bisa membunyikan satu frekuensi dalam satu waktu, dan perintah tone di board menghasilkan satu nada saja. Kalau kamu menekan dua tuts bersamaan, nadanya tidak bertumpuk; board hanya membunyikan nada yang terakhir tiba. Mainkan melodi nada demi nada. Tombol Mainkan layar penuh di panel memperbesar tuts, dan di sana kamu juga bisa menggeser jari di atas tuts untuk berpindah dari satu nada ke nada lain.

Bisakah menambah nada lain atau lebih banyak tuts?

Delapan tuts di panel bersifat tetap: dari Do rendah sampai Do tinggi, tanpa kres atau mol, dan tuts tidak bisa ditambah dari aplikasi. Sisi board justru fleksibel: kode membunyikan setiap angka positif yang datang dari ponsel sebagai frekuensi dan diam saat menerima 0. Jadi kamu bisa mengubah bunyinya di kode; misalnya, kalikan frekuensi yang masuk dengan dua dan seluruh piano naik satu oktaf.