ES-114Початківець

Піаніно на смартфоні через Bluetooth на ESP32

Перетвори телефон на піаніно з 8 клавіш: натисни клавішу, і пасивний зумер на ESP32 зіграє цю ноту, без інтернету й Wi-Fi. Це покроковий посібник до Bluetooth-шаблону Піаніно на смартфоні в застосунку, зібраного із зумера й двох проводів-перемичок. Перейди в Майстерня › Пристрої › Додати пристрій › Bluetooth, вибери «Піаніно на смартфоні» й завантаж код через Отримати код. Кнопка Налаштувати як панель Bluetooth на цій сторінці теж відкриває майстер із цим шаблоном.

0.0(0)
Піаніно на смартфоні через Bluetooth на ESP32
Натисни клавішу на телефоні, і зумер на столі зіграє До; відпусти, і він замовкне: між ними немає ні інтернету, ні роутера, ні сервера. В ESP32 вбудовано Bluetooth, тож телефон під’єднується прямо до плати. Вісім клавіш ідуть від низького До до високого До. Натисни одну, і телефон надішле частоту цієї ноти (262 Hz для низького До); відпусти, і він надішле 0 для тиші. Якщо з’єднання обривається, плата автоматично замовкає. Схема складається з одного пасивного зумера й двох дротів, без макетної плати. У застосунку вибери 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

Поширені запитання

Чи працює це з iPhone?

Так. Вбудований Bluetooth Low Energy (BLE) плати ESP32 працює і з iPhone, і з Android. iPhone не може під’єднатися до класичних модулів Bluetooth, як-от HC-05 і HC-06, і цьому проєкту вони не потрібні. Не намагайся з’єднати плату в налаштуваннях Bluetooth телефона; BLE-плати можуть там не з’являтися, і це нормально. З’єднання встановлює застосунок BlueGrays.

Чим відрізняються активний і пасивний зумери і який потрібен?

Потрібен пасивний зумер. Пасивний зумер працює як крихітний динамік: грає будь-яку частоту, яку на нього подають. Активний зумер має власну схему всередині й видає той самий фіксований звук щоразу, коли отримує живлення, тож клавіші неможливо розрізнити. Цей проєкт допоможе визначити, який у тебе зумер: якщо клавіші грають різні ноти, він пасивний, якщо кожна клавіша дає однакове дзижчання, він активний. Під час купівлі шукай слово «пасивний» (passive) у назві товару.

Чи можна натиснути дві клавіші одночасно й зіграти акорд?

Ні. Зумер може грати лише одну частоту за раз, а команда tone на платі видає одну ноту. Якщо натиснути дві клавіші разом, ноти не накладаються; плата грає лише ту ноту, що надійшла останньою. Грай мелодії по одній ноті. Кнопка «Грати на весь екран» на панелі збільшує клавіші, і там також можна проводити пальцем по клавішах, плавно переходячи від ноти до ноти.

Чи можна додати інші ноти або більше клавіш?

Вісім клавіш на панелі фіксовані: від низького До до високого До, без дієзів і бемолів, і додати клавіші з застосунку не можна. Зате сторона плати гнучка: код грає як частоту будь-яке додатне число, що приходить із телефона, і замовкає, коли отримує 0. Тож звук можна змінити в коді; наприклад, помнож вхідну частоту на два, і все піаніно підніметься на октаву вище.