ES-114Başlangıç

ESP32 Bluetooth Telefon Piyanosu

Telefonunu 8 tuşlu bir piyanoya çevir: tuşa basınca ESP32'deki pasif buzzer o notayı çalar; internet ya da Wi-Fi gerekmez. Bu proje, uygulamadaki Telefon piyanosu Bluetooth şablonunun adım adım rehberi: bir buzzer ve iki jumper kabloyla kurulur. Atölyem › Cihazlarım › Yeni cihaz ekle › Bluetooth yolunu izle, şablonu seç, Kodu al ile kodu karta yükle. Bu sayfadaki Bluetooth paneli olarak kur düğmesi de sihirbazı bu şablonla açar.

0.0(0)
ESP32 Bluetooth Telefon Piyanosu
Telefonundaki tuşa bas, masadaki buzzer Do desin; parmağını kaldır, sussun: arada internet, modem ya da sunucu yok. ESP32'nin içinde Bluetooth var; telefon karta doğrudan bağlanır. Sekiz tuş kalın Do'dan ince Do'ya uzanır. Tuşa basınca telefon o notanın frekansını yollar (kalın Do için 262 Hz), bırakınca 0 yollar ve ses kesilir. Bağlantı koparsa kart kendi kendine susar. Devre bir pasif buzzer ve iki kablodan ibaret, breadboard bile gerekmez. Uygulamada yeni cihaz ekle, Bluetooth'u ve Telefon piyanosu şablonunu seç, Kodu al ile kodu karta yükle, sonra kartını listede bul. Öğrenme: Bluetooth Low Energy ile kısa metin satırlarıyla haberleşme, frekansın notayı belirlemesi ve pasif ile aktif buzzer farkı.

Video

Devre Şeması

ESP32 Bluetooth Telefon Piyanosu - Devre Şeması

Kaynak Kodu

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Piyano                 │
5// └───────────────────────────┘
6// Telefon piyanosu
7// Arduino IDE kartı: ESP32 Dev Module
8// BLE kütüphanesi ESP32 kart paketiyle gelir, ayrıca kurulmaz
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13
14const char BLE_NAME[] = "BG-Piyano";  // kart bu adla yayın yapar, uygulama onu listede bu adla bulur
15
16// Pinler: farklı bağladıysan buradan değiştir
17const int BUZZER_PIN = 25;  // pasif buzzer kullan (aktif buzzer tek bir ses çıkarır)
18
19void btWrite(const char *text);
20void onValue(const char *key, const char *value);
21void sendAll();
22void onLinkLost();
23
24// ── Uygulama "anahtar=değer" satırları yollar; "?" gelince kart bütün değerlerini gönderir ──
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");  // "@v" satırı uygulamaya kod sürümünü bildirir
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// gelen baytlar Bluetooth görevinden loop()'a küçük bir halka tamponla geçer
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// satırlar 20 baytlık paketlerle gider (her telefonla çalışır)
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" notayı çalar, "nota=0" susturur
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);  // Bağlantı koptu: ses susar
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

Sıkça Sorulanlar

iPhone ile çalışır mı?

Evet. ESP32'nin içindeki Bluetooth Low Energy (BLE) hem iPhone hem Android ile konuşur. HC-05 ve HC-06 gibi klasik Bluetooth modüllerine iPhone bağlanamaz, bu projede onlara gerek de yok. Kartı telefonun Bluetooth ayarlarından eşleştirmeye çalışma; BLE kartlar orada görünmeyebilir, bu normal. Bağlantıyı BlueGrays uygulaması kurar.

Aktif buzzer ile pasif buzzer arasındaki fark ne, hangisi gerekli?

Bu projede pasif buzzer gerekir. Pasif buzzer küçük bir hoparlör gibidir: hangi frekansı gönderirsen o notayı çalar. Aktif buzzer'ın içinde kendi devresi vardır, gerilim alınca hep kendi sabit sesini çıkarır; onunla tuşlar birbirinden ayırt edilmez. Elindekinin hangisi olduğunu bu projeyle anlayabilirsin: tuşlar farklı notalar veriyorsa pasif, hepsi aynı cızırtılı sesi veriyorsa aktiftir. Satın alırken ürün adında pasif (passive) yazdığına bak.

Aynı anda iki tuşa basıp akor çalabilir miyim?

Hayır. Buzzer aynı anda tek bir frekans çalabilir; karttaki tone komutu da her seferinde tek bir nota üretir. İki tuşa birlikte basarsan notalar üst üste binmez, kart yalnız en son gelen notayı çalar. Melodileri nota nota çal. Paneldeki Tam ekranda çal düğmesi tuşları büyütür; orada parmağını tuşların üzerinde kaydırarak notadan notaya da geçebilirsin.

Başka notalar ya da daha fazla tuş ekleyebilir miyim?

Paneldeki sekiz tuş sabittir: kalın Do'dan ince Do'ya, diyez ve bemol yok; uygulamadan tuş eklenmez. Kart tarafı ise esnektir: kod, telefondan gelen her pozitif sayıyı frekans olarak çalar, 0 gelince susar. Yani sesi kodda değiştirebilirsin; örneğin gelen frekansı ikiyle çarparsan bütün piyano bir oktav incelir.