ES-114เริ่มต้น

เปียโนบนโทรศัพท์ผ่าน Bluetooth ด้วย ESP32

เปลี่ยนโทรศัพท์เป็นเปียโน 8 คีย์ กดคีย์แล้ว บัซเซอร์แบบพาสซีฟ ที่ต่อกับ ESP32 จะเล่นโน้ตนั้น ไม่ต้องใช้อินเทอร์เน็ตหรือ Wi-Fi คู่มือนี้สอนใช้เทมเพลต Bluetooth เปียโนบนโทรศัพท์ ทีละขั้นตอน ใช้บัซเซอร์และสายจัมเปอร์ 2 เส้น ไปที่ คลังของฉัน › อุปกรณ์ › เพิ่มอุปกรณ์ › Bluetooth เลือกเปียโนบนโทรศัพท์ แล้วอัปโหลดโค้ดด้วย รับโค้ด ปุ่ม ตั้งค่าเป็นแผงควบคุม Bluetooth ในหน้านี้ก็เปิดตัวช่วยตั้งค่าพร้อมเทมเพลตนี้ได้

0.0(0)
เปียโนบนโทรศัพท์ผ่าน Bluetooth ด้วย ESP32
กดคีย์บนโทรศัพท์แล้วบัซเซอร์บนโต๊ะจะเล่นเสียงโด ปล่อยนิ้วแล้วเสียงก็หยุด โดยไม่ต้องผ่านอินเทอร์เน็ต เราเตอร์ หรือเซิร์ฟเวอร์ ESP32 มี Bluetooth ในตัว โทรศัพท์จึงเชื่อมต่อกับบอร์ดได้โดยตรง มีคีย์ 8 คีย์ไล่จากโดต่ำไปถึงโดสูง เมื่อกดคีย์ โทรศัพท์จะส่งความถี่ของโน้ตนั้น เช่น 262 Hz สำหรับโดต่ำ เมื่อปล่อยจะส่งค่า 0 เพื่อหยุดเสียง หากการเชื่อมต่อหลุด บอร์ดจะหยุดเสียงเอง วงจรใช้เพียงบัซเซอร์แบบพาสซีฟ 1 ตัวกับสายไฟ 2 เส้น ไม่ต้องใช้เบรดบอร์ด ในแอปให้เพิ่มอุปกรณ์ เลือก Bluetooth และเทมเพลตเปียโนบนโทรศัพท์ อัปโหลดโค้ดด้วยรับโค้ด แล้วหาบอร์ดของคุณในรายการ สิ่งที่จะได้เรียนรู้คือการสื่อสารผ่าน Bluetooth Low Energy ด้วยข้อความสั้นๆ ความถี่กำหนดโน้ตอย่างไร และความแตกต่างระหว่างบัซเซอร์แบบพาสซีฟกับแบบแอกทีฟ

วิดีโอ

แผนผังวงจร

เปียโนบนโทรศัพท์ผ่าน Bluetooth ด้วย ESP32 - แผนผังวงจร

ซอร์สโค้ด

C++ (Arduino IDE)
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}
180

FAQ

ใช้กับ iPhone ได้ไหม

ได้ Bluetooth Low Energy (BLE) ในตัว ESP32 สื่อสารได้ทั้งกับ iPhone และ Android แม้ iPhone จะเชื่อมต่อกับโมดูล Bluetooth แบบคลาสสิกอย่าง HC-05 และ HC-06 ไม่ได้ แต่โปรเจกต์นี้ไม่ต้องใช้โมดูลเหล่านั้น ไม่ต้องจับคู่บอร์ดจากการตั้งค่า Bluetooth ของโทรศัพท์ บอร์ด BLE อาจไม่แสดงในหน้านั้นซึ่งเป็นเรื่องปกติ ให้แอป BlueGrays เป็นตัวเชื่อมต่อ

บัซเซอร์แบบแอกทีฟกับแบบพาสซีฟต่างกันอย่างไร และต้องใช้แบบไหน

โปรเจกต์นี้ต้องใช้บัซเซอร์แบบพาสซีฟ ซึ่งทำงานคล้ายลำโพงขนาดเล็ก ส่งความถี่ใดไปก็เล่นโน้ตตามความถี่นั้น ส่วนบัซเซอร์แบบแอกทีฟมีวงจรสร้างเสียงในตัว เมื่อได้รับไฟจะส่งเสียงเดิมตลอด จึงแยกเสียงแต่ละคีย์ไม่ได้ ใช้โปรเจกต์นี้ทดสอบบัซเซอร์ที่มีอยู่ได้ ถ้าแต่ละคีย์ให้โน้ตต่างกันก็เป็นแบบพาสซีฟ ถ้าทุกคีย์ให้เสียงหึ่งเหมือนกันก็เป็นแบบแอกทีฟ ตอนซื้อให้มองหาคำว่า passive ในชื่อสินค้า

กด 2 คีย์พร้อมกันเพื่อเล่นคอร์ดได้ไหม

ไม่ได้ บัซเซอร์เล่นได้ทีละความถี่ และคำสั่ง tone บนบอร์ดก็สร้างโน้ตได้ครั้งละเสียง หากกด 2 คีย์พร้อมกัน เสียงจะไม่ซ้อนกัน บอร์ดจะเล่นเฉพาะโน้ตที่ได้รับล่าสุด ให้เล่นทำนองทีละโน้ต ปุ่มเล่นเต็มหน้าจอบนแผงควบคุมจะขยายคีย์ให้ใหญ่ขึ้น และในโหมดนั้นยังลากนิ้วผ่านคีย์เพื่อเล่นไล่โน้ตได้ด้วย

เพิ่มโน้ตอื่นหรือเพิ่มคีย์ได้ไหม

คีย์ทั้ง 8 คีย์บนแผงควบคุมกำหนดไว้ตายตัว ตั้งแต่โดต่ำถึงโดสูง ไม่มีชาร์ปหรือแฟลต และเพิ่มคีย์จากแอปไม่ได้ แต่โค้ดฝั่งบอร์ดปรับได้ โดยจะใช้จำนวนบวกที่ได้รับจากโทรศัพท์เป็นความถี่เสียง และหยุดเสียงเมื่อได้รับค่า 0 จึงเปลี่ยนเสียงในโค้ดได้ เช่น คูณความถี่ที่รับมาด้วย 2 ก็จะทำให้เปียโนทั้งชุดมีเสียงสูงขึ้น 1 อ็อกเทฟ