ESP32 Bluetooth फ़ोन पियानो
अपने फ़ोन को 8 कुंजी वाला पियानो बनाएँ: कोई कुंजी दबाएँ और ESP32 पर लगा पैसिव बज़र वही सुर बजाता है, इंटरनेट या Wi-Fi की ज़रूरत नहीं। यह ऐप के फ़ोन पियानो Bluetooth टेम्पलेट की स्टेप बाय स्टेप गाइड है, जो एक बज़र और दो जम्पर वायर से बनी है। मेरी वर्कशॉप › मेरे डिवाइस › डिवाइस जोड़ें › Bluetooth पर जाएँ, फ़ोन पियानो चुनें और कोड लें से कोड अपलोड करें। इस पेज का Bluetooth पैनल बनाएँ बटन भी इसी टेम्पलेट के साथ विज़ार्ड खोलता है।

वीडियो
सर्किट डायग्राम

सोर्स कोड
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Piyano │
5// └───────────────────────────┘
6// Phone piano
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-Piyano"; // 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 BUZZER_PIN = 25; // use a passive buzzer (an active one only makes a single tone)
18
19void btWrite(const char *text);
20void onValue(const char *key, const char *value);
21void sendAll();
22void onLinkLost();
23
24// ── The app sends "key=value" lines; on "?" the board sends all its values ──
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"); // the "@v" line tells the app the code version
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// incoming bytes move from the Bluetooth task to loop() through a small ring buffer
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// lines go out in 20-byte packets (works with every phone)
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" plays the note, "nota=0" stops it
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); // Connection lost: the sound stops
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}
180FAQ
क्या यह iPhone के साथ चलता है?
हाँ। ESP32 का बिल्ट-इन Bluetooth Low Energy (BLE) iPhone और Android दोनों से बात करता है। iPhone, HC-05 और HC-06 जैसे क्लासिक Bluetooth मॉड्यूल से कनेक्ट नहीं हो सकता, और इस प्रोजेक्ट को उनकी ज़रूरत भी नहीं। बोर्ड को फ़ोन की Bluetooth सेटिंग्स में पेयर करने की कोशिश न करें; BLE बोर्ड वहाँ शायद न दिखें, यह सामान्य है। कनेक्शन BlueGrays ऐप बनाता है।
एक्टिव और पैसिव बज़र में क्या फ़र्क है, और कौन-सा चाहिए?
आपको पैसिव बज़र चाहिए। पैसिव बज़र एक छोटे स्पीकर की तरह काम करता है: आप जो फ़्रीक्वेंसी भेजें, वही बजाता है। एक्टिव बज़र के अंदर अपना सर्किट होता है और पावर मिलते ही हमेशा एक ही तय आवाज़ करता है, इसलिए कुंजियों में फ़र्क नहीं पता चलता। यह प्रोजेक्ट बता देता है कि आपके पास कौन-सा है: कुंजियाँ अलग-अलग सुर बजाएँ तो पैसिव है, हर कुंजी एक जैसी भिनभिनाहट दे तो एक्टिव। खरीदते समय प्रोडक्ट के नाम में passive शब्द देखें।
क्या दो कुंजियाँ एक साथ दबाकर कॉर्ड बजाया जा सकता है?
नहीं। बज़र एक समय में सिर्फ़ एक फ़्रीक्वेंसी बजा सकता है, और बोर्ड का tone कमांड एक ही सुर बनाता है। दो कुंजियाँ एक साथ दबाने पर सुर जुड़ते नहीं; बोर्ड सिर्फ़ आखिर में आया सुर बजाता है। धुनें एक-एक सुर करके बजाएँ। पैनल का फ़ुल स्क्रीन में बजाएँ बटन कुंजियों को बड़ा कर देता है, और वहाँ आप एक सुर से दूसरे पर फिसलने के लिए कुंजियों पर उँगली भी सरका सकते हैं।
क्या दूसरे सुर या ज़्यादा कुंजियाँ जोड़ी जा सकती हैं?
पैनल की आठ कुंजियाँ तय हैं: नीचे वाले C से ऊँचे C तक, बिना शार्प या फ़्लैट के, और ऐप से कुंजियाँ नहीं जोड़ी जा सकतीं। लेकिन बोर्ड वाला हिस्सा लचीला है: कोड फ़ोन से आने वाले किसी भी पॉज़िटिव नंबर को फ़्रीक्वेंसी की तरह बजाता है और 0 मिलने पर चुप हो जाता है। इसलिए आप कोड में आवाज़ बदल सकते हैं; जैसे, आने वाली फ़्रीक्वेंसी को दो से गुणा करें, तो पूरा पियानो एक ऑक्टेव ऊपर चला जाता है।
