ES-112Beginner

ESP32 Bluetooth-tekst op een LCD

Typ een bericht op je telefoon en het verschijnt via Bluetooth op een 16x2-LCD, zonder internet of Wi-Fi. Dit project is de stap-voor-stapgids bij het Bluetooth-sjabloon Tekst op een LCD in de app, gebouwd met een ESP32 en een I2C-LCD. Ga naar Werkplaats › Apparaten › Apparaat toevoegen › Bluetooth, kies Tekst op een LCD en upload de code met Code ophalen. De knop Instellen als Bluetooth-paneel op deze pagina opent de wizard ook met dit sjabloon.

0.0(0)
ESP32 Bluetooth-tekst op een LCD
Typ een bericht op je telefoon, tik op Versturen en het verschijnt op de LCD op je bureau, zonder internet of server. De ESP32 heeft Bluetooth ingebouwd, dus je telefoon verbindt rechtstreeks met het board, en de I2C-module van het display heeft maar vier draden nodig. Een 16x2-display biedt ruimte voor 32 tekens: 16 op de bovenste rij, de rest eronder. De code zet letters met accenten zoals é, ü en ñ om in gewone Latijnse letters en toont een vraagteken bij onbekende tekens. De schakelaar Achtergrondverlichting in het paneel zet het licht aan en uit. Kies in de app het sjabloon Tekst op een LCD, upload de code en zoek je board in de lijst. Wat je leert: tekst versturen via Bluetooth Low Energy, een I2C-LCD aansturen, tekst over rijen verdelen en een tabel voor lettervervanging.

Video

Schakelschema

ESP32 Bluetooth-tekst op een LCD - Schakelschema

Broncode

C++ (Arduino IDE)
1// ┌───────────────────────────┐
2// │ BlueGrays · bluegrays.com │
3// │ Bluetooth · ESP32         │
4// │ BG-Ekran                  │
5// └───────────────────────────┘
6// Tekst op een LCD
7// Board in de Arduino IDE: ESP32 Dev Module
8// de BLE-bibliotheek zit in het ESP32-boardpakket, je hoeft niets extra te installeren
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";  // het board zendt deze naam uit, de app herkent het in de lijst aan deze naam
17
18// Pinnen: pas ze hier aan als je anders hebt aangesloten
19const int SDA_PIN = 21, SCL_PIN = 22;
20const int LCD_COLS = 16, LCD_ROWS = 2;  // LCD-formaat: kolommen × rijen
21const uint8_t LCD_ADDRESS = 0x27;  // de meeste I2C-adapters voor een LCD gebruiken 0x27; blijft het scherm leeg, probeer dan 0x3F
22
23void btWrite(const char *text);
24void onValue(const char *key, const char *value);
25void sendAll();
26void onLinkLost();
27
28// ── De app stuurt regels "sleutel=waarde"; bij "?" stuurt het board al zijn waarden ──
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");  // de regel "@v" geeft de app de codeversie door
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// binnenkomende bytes gaan via een kleine ringbuffer van de Bluetooth-taak naar loop()
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// regels worden in pakketten van 20 bytes verstuurd (werkt met elke telefoon)
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// zie je alleen blokjes, draai dan aan het blauwe trimpotje op de achterkant (contrast)
158LiquidCrystal_I2C lcd(LCD_ADDRESS, LCD_COLS, LCD_ROWS);
159char rows[LCD_ROWS][LCD_COLS + 1];
160bool lightOn = true;
161
162// het LCD kent alleen gewone Latijnse letters: letters met accenten worden vereenvoudigd (ë → e), andere worden ?
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=" verdeelt de tekst over de regels, "satir1=" … vervangt één regel
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

Veelgestelde vragen

Werkt het met een iPhone?

Ja. De ingebouwde Bluetooth Low Energy (BLE) van de ESP32 werkt met zowel iPhone als Android. Een iPhone kan niet verbinden met klassieke Bluetooth-modules zoals de HC-05 en HC-06, en dit project heeft ze niet nodig. Probeer het board niet te koppelen in de Bluetooth-instellingen van je telefoon; BLE-boards verschijnen daar mogelijk niet, dat is normaal. De BlueGrays-app maakt de verbinding.

Kan het letters met accenten tonen, zoals é, ü of ñ?

Niet als letters met accenten. Voordat de tekst naar het display gaat, zet de code Latijnse letters met accenten om in gewone letters: é wordt e, ü wordt u, ñ wordt n, ç wordt c. Typ je café, dan toont het display cafe, zodat de tekst leesbaar blijft. Tekens die niet in de conversietabel staan (emoji, Cyrillische of Japanse tekens, symbolen zoals ° en €) komen als vraagteken op het scherm. De LCD-voorvertoning in het paneel laat zien hoe de tekst eruit komt te zien voordat je hem verstuurt.

Kan ik een 20x4-LCD gebruiken?

Ja. De wizard en het codescherm hebben een keuze voor het LCD-type: 16x2 of 20x4. Kies je 20x4, dan genereert de app de code voor dat formaat. De bedrading is hetzelfde: vier draden op dezelfde pins. Pas de aantallen kolommen en rijen niet met de hand aan in code die je voor 16x2 hebt gekregen, want andere delen van de code hangen ook van het formaat af. De juiste manier is het LCD-type in de app wijzigen en de code opnieuw ophalen. Deze gids is gebouwd met een 16x2-display.

Hoeveel tekens passen op het scherm en scrolt lange tekst?

Een 16x2-display biedt ruimte voor 32 tekens: twee rijen van 16. Het tekstveld in het paneel accepteert niet meer. De eerste 16 tekens komen op de bovenste rij en de rest op de onderste; de code kijkt niet naar woorden, dus een woord kan aan het eind van een rij in tweeën worden gesplitst. De tekst scrolt niet, hij blijft staan waar hij staat. Wil je een woord naar de onderste rij duwen, voeg dan spaties ervoor toe; de LCD-voorvertoning toont de verdeling voordat je verstuurt. Een nieuwe tekst vervangt de oude.