ESP32 Bluetooth ile LCD'ye Yazı
Telefonundan yazdığın yazı Bluetooth ile 16x2 LCD ekranda belirsin; internet ya da Wi-Fi gerekmez. Bu proje, uygulamadaki LCD'ye yazı Bluetooth şablonunun adım adım rehberi: ESP32 ve I2C modüllü bir LCD ile kurulur. Atölyem › Cihazlarım › Yeni cihaz ekle › Bluetooth yolunu izle, LCD'ye yazı şablonunu seç, Kodu al ile kodu karta yükle. Bu sayfadaki Bluetooth paneli olarak kur düğmesi de sihirbazı bu şablonla açar.

Video
Devre Şeması

Kaynak Kodu
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32 │
4// │ BG-Ekran │
5// └───────────────────────────┘
6// LCD'ye yazı
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#include <Wire.h>
14#include <LiquidCrystal_I2C.h> // Kütüphane Yöneticisi: 'LiquidCrystal I2C' (Frank de Brabander)
15
16const char BLE_NAME[] = "BG-Ekran"; // kart bu adla yayın yapar, uygulama onu listede bu adla bulur
17
18// Pinler: farklı bağladıysan buradan değiştir
19const int SDA_PIN = 21, SCL_PIN = 22;
20const int LCD_COLS = 16, LCD_ROWS = 2; // LCD boyutu: sütun × satır
21const uint8_t LCD_ADDRESS = 0x27; // çoğu I2C LCD 0x27 adresindedir; ekran boş kalırsa 0x3F dene
22
23void btWrite(const char *text);
24void onValue(const char *key, const char *value);
25void sendAll();
26void onLinkLost();
27
28// ── Uygulama "anahtar=değer" satırları yollar; "?" gelince kart bütün değerlerini gönderir ──
29char line[65];
30uint8_t lineLen = 0;
31unsigned long lastRxMs = 0;
32
33bool is(const char *a, const char *b) { return strcmp(a, b) == 0; }
34bool isOn(const char *v) { return v[0] == '1'; }
35
36void sendText(const char *key, const char *value) {
37 char out[72];
38 snprintf(out, sizeof(out), "%s=%s\n", key, value);
39 btWrite(out);
40}
41
42void sendInt(const char *key, long value) {
43 char text[12];
44 snprintf(text, sizeof(text), "%ld", value);
45 sendText(key, text);
46}
47
48void sendFloat(const char *key, float value) {
49 char text[16];
50 dtostrf(value, 1, 1, text);
51 sendText(key, text);
52}
53
54void handleLine(char *text) {
55 char *eq = strchr(text, '=');
56 if (eq == nullptr) {
57 if (text[strlen(text) - 1] == '?') {
58 btWrite("@v=1.0\n"); // "@v" satırı uygulamaya kod sürümünü bildirir
59 sendAll();
60 }
61 return;
62 }
63 *eq = '\0';
64 onValue(text, eq + 1);
65}
66
67void feed(char c) {
68 lastRxMs = millis();
69 if (c == '\n' || c == '\r') {
70 if (lineLen == 0) return;
71 line[lineLen] = '\0';
72 lineLen = 0;
73 handleLine(line);
74 } else if (lineLen < sizeof(line) - 1) {
75 line[lineLen++] = c;
76 }
77}
78
79// ── Bluetooth (Nordic UART) ──
80#define UART_SERVICE "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
81#define UART_RX "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
82#define UART_TX "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
83
84BLECharacteristic *txChar = nullptr;
85volatile bool linked = false;
86volatile bool linkLost = false;
87// gelen baytlar Bluetooth görevinden loop()'a küçük bir halka tamponla geçer
88const int RX_SIZE = 256;
89volatile uint8_t rxBuf[RX_SIZE];
90volatile int rxHead = 0, rxTail = 0;
91
92class ServerEvents : public BLEServerCallbacks {
93 void onConnect(BLEServer *server) override { linked = true; }
94 void onDisconnect(BLEServer *server) override { linked = false; linkLost = true; }
95};
96
97class RxEvents : public BLECharacteristicCallbacks {
98 void onWrite(BLECharacteristic *c) override {
99 auto v = c->getValue();
100 for (size_t i = 0; i < v.length(); i++) {
101 int next = (rxHead + 1) % RX_SIZE;
102 if (next == rxTail) break;
103 rxBuf[rxHead] = (uint8_t)v[i];
104 rxHead = next;
105 }
106 }
107};
108
109// satırlar 20 baytlık paketlerle gider (her telefonla çalışır)
110void btWrite(const char *text) {
111 if (!linked || txChar == nullptr) return;
112 size_t n = strlen(text);
113 for (size_t i = 0; i < n; i += 20) {
114 size_t len = n - i < 20 ? n - i : 20;
115 txChar->setValue((uint8_t *)text + i, len);
116 txChar->notify();
117 delay(4);
118 }
119}
120
121void btBegin() {
122 BLEDevice::init(BLE_NAME);
123 BLEServer *server = BLEDevice::createServer();
124 server->setCallbacks(new ServerEvents());
125 BLEService *uart = server->createService(UART_SERVICE);
126 txChar = uart->createCharacteristic(UART_TX, BLECharacteristic::PROPERTY_NOTIFY);
127 txChar->addDescriptor(new BLE2902());
128 BLECharacteristic *rx = uart->createCharacteristic(UART_RX, BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_WRITE_NR);
129 rx->setCallbacks(new RxEvents());
130 uart->start();
131 BLEAdvertisementData adv;
132 adv.setFlags(0x06);
133 adv.setCompleteServices(BLEUUID(UART_SERVICE));
134 BLEAdvertisementData scan;
135 scan.setName(BLE_NAME);
136 BLEAdvertising *advertising = BLEDevice::getAdvertising();
137 advertising->setAdvertisementData(adv);
138 advertising->setScanResponseData(scan);
139 BLEDevice::startAdvertising();
140}
141
142void btPoll() {
143 while (rxTail != rxHead) {
144 char c = (char)rxBuf[rxTail];
145 rxTail = (rxTail + 1) % RX_SIZE;
146 feed(c);
147 }
148 if (linkLost) {
149 linkLost = false;
150 onLinkLost();
151 delay(100);
152 BLEDevice::startAdvertising();
153 }
154}
155
156// ── ESP32 ──
157// yalnız kutucuklar görünürse arkadaki mavi potu çevir (kontrast)
158LiquidCrystal_I2C lcd(LCD_ADDRESS, LCD_COLS, LCD_ROWS);
159char rows[LCD_ROWS][LCD_COLS + 1];
160bool lightOn = true;
161
162// LCD yalnız temel Latin harflerini bilir: işaretli harfler sadeleşir (ş → s), diğerleri ? olur
163const char FOLD[] = "AAAAAAACEEEEIIIIDNOOOOOxOUUUUYPsaaaaaaaceeeeiiiidnooooo/ouuuuypyAaAaAaCcCcCcCcDdDdEeEeEeEeEeGgGgGgGgHhHhIiIiIiIiIiJjJjKkkLlLlLlLlLlNnNnNnnNnOoOoOoOoRrRrRrSsSsSsSsTtTtTtUuUuUuUuUuUuWwYyYZzZzZzs";
164
165void toAscii(const char *in, char *out, size_t size) {
166 size_t n = 0;
167 const unsigned char *p = (const unsigned char *)in;
168 while (*p && n + 1 < size) {
169 unsigned char c = *p;
170 if (c < 0x80) { out[n++] = c >= 32 ? c : ' '; p++; continue; }
171 int len = c >= 0xF0 ? 4 : c >= 0xE0 ? 3 : c >= 0xC0 ? 2 : 1;
172 unsigned int code = (len == 2 && p[1]) ? ((c & 0x1F) << 6) | (p[1] & 0x3F) : 0;
173 out[n++] = (code >= 0xC0 && code <= 0x17F) ? FOLD[code - 0xC0] : '?';
174 for (int k = 0; k < len && *p; k++) p++;
175 }
176 out[n] = '\0';
177}
178
179void showRows() {
180 for (int r = 0; r < LCD_ROWS; r++) {
181 lcd.setCursor(0, r);
182 bool ended = false;
183 for (int c = 0; c < LCD_COLS; c++) {
184 if (rows[r][c] == '\0') ended = true;
185 lcd.write(ended ? ' ' : rows[r][c]);
186 }
187 }
188}
189
190// "yazi=" metni satırlara sırayla yayar, "satir1=" … tek satırı değiştirir
191void setText(const char *text) {
192 char flat[LCD_COLS * LCD_ROWS + 1];
193 toAscii(text, flat, sizeof(flat));
194 int len = strlen(flat);
195 for (int r = 0; r < LCD_ROWS; r++) {
196 int start = r * LCD_COLS;
197 int n = len > start ? min(LCD_COLS, len - start) : 0;
198 memcpy(rows[r], flat + start, n);
199 rows[r][n] = '\0';
200 }
201}
202
203void onValue(const char *key, const char *value) {
204 if (is(key, "yazi")) {
205 setText(value);
206 showRows();
207 } else if (strncmp(key, "satir", 5) == 0) {
208 int r = atoi(key + 5) - 1;
209 if (r < 0 || r >= LCD_ROWS) return;
210 toAscii(value, rows[r], LCD_COLS + 1);
211 showRows();
212 } else if (is(key, "isik")) {
213 lightOn = isOn(value);
214 if (lightOn) lcd.backlight(); else lcd.noBacklight();
215 }
216}
217
218void sendAll() {
219 char flat[LCD_COLS * LCD_ROWS + 1];
220 snprintf(flat, sizeof(flat), rows[1][0] ? "%-16s%s" : "%s", rows[0], rows[1]);
221 if (flat[0]) sendText("yazi", flat);
222 sendInt("isik", lightOn);
223}
224
225void onLinkLost() {
226}
227
228void setup() {
229 Serial.begin(115200);
230 Wire.begin(SDA_PIN, SCL_PIN);
231 lcd.init();
232 lcd.backlight();
233 setText("BlueGrays");
234 strncpy(rows[1], BLE_NAME, LCD_COLS);
235 rows[1][LCD_COLS] = '\0';
236 showRows();
237 btBegin();
238 Serial.print(F("BlueGrays Bluetooth: "));
239 Serial.println(BLE_NAME);
240}
241
242void loop() {
243 btPoll();
244}
245Sı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.
Türkçe harfler ekranda çıkar mı?
Türkçe harf olarak çıkmaz. Kod, yazıyı ekrana basmadan önce aksanlı harfleri düz hâline çevirir: ç c olur, ğ g, ı i, ö o, ş s, ü u. Yani Günaydın yazarsan ekranda Gunaydin görürsün; yazı okunur kalır. Çeviri tablosunda olmayan karakterler (emoji, Kiril ya da Japon harfleri, ° ve € gibi işaretler) soru işareti olarak çıkar. Paneldeki LCD önizleme, yazının ekranda nasıl görüneceğini göndermeden önce gösterir.
20x4 LCD kullanabilir miyim?
Evet. Sihirbazda ve kod ekranında LCD türü seçimi var: 16x2 ya da 20x4. 20x4'ü seçersen uygulama kodu o boyuta göre üretir. Bağlantı aynıdır: dört kablo, aynı pinler. 16x2 için aldığın kodda sütun ve satır sayısını elle değiştirme; kodun başka yerleri de boyuta bağlı. Doğru yol, uygulamada LCD türünü değiştirip kodu yeniden almak. Bu rehber 16x2 ekranla kuruldu.
Ekrana kaç karakter sığar, uzun yazı kayar mı?
16x2 ekrana 32 karakter sığar: iki satır, her satırda 16 karakter. Paneldeki yazı alanı da daha fazlasını kabul etmez. İlk 16 karakter üst satıra, kalanı alt satıra yazılır; kod kelimeye bakmaz, bu yüzden bir kelime satır sonunda ikiye bölünebilir. Yazı kaymaz, olduğu yerde durur. Bir kelimeyi alt satıra itmek için önüne boşluk ekle; LCD önizleme bölünmeyi göndermeden önce gösterir. Yeni yazı gönderince eskisinin yerini alır.
