ES-112Pemula

ESP32 Bluetooth: Teks di LCD

Ketik pesan di ponselmu dan pesan itu muncul di LCD 16x2 lewat Bluetooth, tanpa internet atau Wi-Fi. Proyek ini adalah panduan langkah demi langkah untuk template Bluetooth Teks di LCD di aplikasi, dirakit dengan ESP32 dan LCD I2C. Buka Labku › Perangkat › Tambah perangkat › Bluetooth, pilih Teks di LCD, lalu unggah kode lewat Ambil kodenya. Tombol Siapkan sebagai panel Bluetooth di halaman ini juga membuka wizard dengan template ini.

0.0(0)
ESP32 Bluetooth: Teks di LCD
Ketik pesan di ponselmu, ketuk Kirim, dan pesan itu muncul di LCD di mejamu, tanpa internet atau server. ESP32 sudah punya Bluetooth bawaan, jadi ponsel tersambung langsung ke board, dan berkat modul I2C layarnya hanya butuh empat kabel. LCD 16x2 memuat 32 karakter: 16 di baris atas, sisanya di bawah. Kode mengubah huruf beraksen seperti é, ü, dan ñ menjadi huruf polos dan menaruh tanda tanya untuk karakter yang tidak dikenal. Sakelar Lampu latar di panel menyalakan dan mematikan lampu. Di aplikasi, pilih template Teks di LCD, unggah kodenya, lalu cari board-mu di daftar. Yang dipelajari: mengirim teks lewat Bluetooth Low Energy, memakai LCD I2C, membagi teks ke baris, dan mengubah huruf dengan tabel.

Video

Skema rangkaian

ESP32 Bluetooth: Teks di LCD - Skema rangkaian

Kode sumber

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Ekran                  │
5// └───────────────────────────┘
6// Teks di LCD
7// Board di Arduino IDE: ESP32 Dev Module
8// library BLE sudah ikut paket board ESP32, tidak perlu pasang apa-apa lagi
9
10#include <BLEDevice.h>
11#include <BLEServer.h>
12#include <BLE2902.h>
13#include <Wire.h>
14#include <LiquidCrystal_I2C.h>  // Library Manager: 'LiquidCrystal I2C' (Frank de Brabander)
15
16const char BLE_NAME[] = "BG-Ekran";  // papan menyiarkan nama ini, aplikasi menemukannya di daftar dengan nama ini
17
18// Pin: ubah di sini kalau sambunganmu berbeda
19const int SDA_PIN = 21, SCL_PIN = 22;
20const int LCD_COLS = 16, LCD_ROWS = 2;  // ukuran LCD: kolom × baris
21const uint8_t LCD_ADDRESS = 0x27;  // kebanyakan LCD I2C memakai 0x27; jika layar tetap kosong, coba 0x3F
22
23void btWrite(const char *text);
24void onValue(const char *key, const char *value);
25void sendAll();
26void onLinkLost();
27
28// ── Aplikasi mengirim baris "kunci=nilai"; saat menerima "?" papan mengirim semua nilainya ──
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");  // baris "@v" memberi tahu aplikasi versi kodenya
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// byte yang masuk dipindah dari tugas Bluetooth ke loop() lewat buffer cincin kecil
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// baris dikirim dalam paket 20 byte (bisa di semua ponsel)
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// kalau hanya muncul kotak-kotak, putar potensio biru di belakang (kontras)
158LiquidCrystal_I2C lcd(LCD_ADDRESS, LCD_COLS, LCD_ROWS);
159char rows[LCD_ROWS][LCD_COLS + 1];
160bool lightOn = true;
161
162// LCD hanya mengenal huruf Latin dasar: tanda aksen dihapus (é → e), huruf lain menjadi ?
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=" mengalirkan teks ke baris-baris, "satir1=" … mengganti satu baris saja
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}
245

FAQ

Apakah bisa dipakai dengan iPhone?

Bisa. Bluetooth Low Energy (BLE) bawaan ESP32 bisa berkomunikasi dengan iPhone dan Android. iPhone tidak bisa tersambung ke modul Bluetooth klasik seperti HC-05 dan HC-06, dan proyek ini memang tidak memakainya. Jangan coba memasangkan (pairing) board dari pengaturan Bluetooth ponsel; board BLE bisa saja tidak muncul di sana, itu normal. Sambungannya dibuat oleh aplikasi BlueGrays.

Apakah huruf beraksen atau huruf non-Latin bisa tampil?

Teks bahasa Indonesia tampil apa adanya karena hurufnya Latin polos. Huruf Latin beraksen diubah kode menjadi huruf polos sebelum dikirim ke layar: é menjadi e, ü menjadi u, ñ menjadi n, ç menjadi c. Jadi kata café tampil sebagai cafe. Karakter yang tidak ada di tabel konversi (emoji, huruf Kiril, Arab, atau Jepang, simbol seperti ° dan €, tanda kutip melengkung dari sebagian keyboard) tampil sebagai tanda tanya. Pratinjau LCD di panel menunjukkan tampilan teks sebelum kamu mengirimnya.

Bisakah aku memakai LCD 20x4?

Bisa. Wizard dan layar kode punya pilihan Jenis LCD: 16x2 atau 20x4. Kalau kamu memilih 20x4, aplikasi membuat kode untuk ukuran itu. Kabelnya sama: empat kabel di pin yang sama. Jangan mengubah sendiri jumlah kolom dan baris di kode yang kamu ambil untuk 16x2, karena bagian lain dari kode juga bergantung pada ukurannya. Cara yang benar: ganti jenis LCD di aplikasi lalu ambil kodenya lagi. Panduan ini dirakit dengan layar 16x2.

Berapa karakter yang muat? Apakah teks panjang bergulir?

LCD 16x2 memuat 32 karakter: dua baris, masing-masing 16. Kolom teks di panel juga tidak menerima lebih dari itu. 16 karakter pertama masuk ke baris atas dan sisanya ke baris bawah; kode tidak melihat kata, jadi sebuah kata bisa terpotong di ujung baris. Teks tidak bergulir, tetap diam di tempatnya. Untuk mendorong sebuah kata ke baris bawah, tambahkan spasi di depannya; Pratinjau LCD menunjukkan pembagiannya sebelum dikirim. Teks baru menggantikan teks lama.