Barevný displej 1.14" ST7789 s ESP32-S3: zapojení, knihovna a demo
Malý barevný displej 1.14" s rozlišením 135×240 bodů je ideální na stavové informace, menu nebo jednoduchou grafiku. Ukážeme, jak ho připojit k ESP32-S3, jakou knihovnu použít a na co si dát pozor, aby obraz nebyl posunutý nebo displej nezůstal černý. V článku najdete i kompletní demo, které otestuje barvy, okraje, podsvícení i rychlost.

Co budete potřebovat
- Barevný displej IPS 1.14" 135x240 ST7789V SPI.
- Vývojová deska s ESP32-S3, my jsme použili ESP32-S3-DevKitC-1. Kód funguje i s jinými deskami ESP32, jen upravte čísla pinů. Pozor na klasické ESP32: tam jsou GPIO6 až GPIO11 vyhrazené pro paměť flash a použít je nelze, GPIO12 navíc ovlivňuje start.
- Osm propojovacích vodičů samice–samice, například DuPont F-F 10 cm nebo DuPont F-F 30 cm.
- Arduino IDE 2 s podporou ESP32 (balík esp32 by Espressif Systems verze 3.x).
Zapojení
Displej komunikuje přes SPI a pracuje s napětím 3,3 V, takže ho k ESP32 připojíte přímo bez převodníku úrovní.
| Displej | ESP32-S3 | Význam |
|---|---|---|
| GND | GND | zem |
| VCC | 3V3 | napájení 3,3 V |
| SCL | GPIO12 | hodiny SPI |
| SDA | GPIO11 | data SPI (MOSI) |
| RES | GPIO10 | reset displeje |
| DC | GPIO9 | přepínání příkaz/data |
| CS | GPIO13 | výběr čipu |
| BLK | GPIO14 | podsvícení (lze stmívat PWM) |
Na DevKitC-1 jsou GPIO9 až GPIO14 vedle sebe na jedné liště. Žádný z nich nemá na ESP32-S3 zvláštní funkci při startu (na rozdíl od GPIO0, 3, 45 a 46). Pozor jen na napájení: hned vedle GPIO14 je pin 5V, ale VCC displeje patří na 3V3 na opačném konci lišty.
Knihovna a nastavení Arduino IDE
V Arduino IDE otevřete Nástroje → Spravovat knihovny, vyhledejte GFX Library for Arduino (autor Moon On Our Nation) a nainstalujte ji. Knihovna podporuje desítky displejů a na ESP32 využívá hardwarové SPI, takže je rychlá. Demo jsme odzkoušeli s verzí 1.6.2 a balíkem esp32 3.3.2.
Jako desku zvolte Nástroje → Deska → ESP32S3 Dev Module. DevKitC-1 má dva konektory USB-C. Výpis do sériového monitoru (115200 Bd) uvidíte na portu označeném UART. Pokud používáte port USB, zapněte Nástroje → USB CDC On Boot → Enabled.
U tohoto displeje je klíčový jeden řádek:
Arduino_GFX *gfx = new Arduino_ST7789(bus, TFT_RST, 1, true, 135, 240, 52, 40, 53, 40);
- 135, 240 je rozlišení panelu.
- 52, 40, 53, 40 jsou posuny obrazu. Řadič ST7789V má paměť pro 240×320 bodů a panel 135×240 ukazuje jen výřez z jejího středu. Bez posunu by byl obraz useknutý a u okraje by byl pruh náhodných pixelů.
- true znamená IPS panel, který potřebuje inverzi barev. Bez ní se černá zobrazí jako bílá a všechny barvy budou obrácené.
- 1 je rotace. Hodnoty 1 a 3 dávají orientaci na šířku (240×135), 0 a 2 na výšku. Demo je rozvržené na šířku, na výšku by se delší nápisy zalomily.
Ukázkový kód
Demo běží dokola ve čtyřech krocích:
- Barvy: červená, zelená, modrá, bílá a černá s nápisem. Nápis musí odpovídat barvě pozadí.
- Rámeček a přechody: bílý rámeček musí být vidět po celém obvodu. Tím ověříte, že sedí posuny. Barevný přechod z modré do červené a šedý přechod mají být plynulé.
- Podsvícení: obrazovka plynule ztmavne a zase se rozsvítí.
- Animace: barevné kuličky se odrážejí od okrajů. Každý snímek se nejdřív nakreslí do paměti a pak se pošle na displej najednou, takže obraz nebliká. Na ESP32-S3 se SPI na 40 MHz to dává zhruba 47 snímků za sekundu (s výchozím nastavením, tedy vypnutou PSRAM). Rychlost se vypisuje do sériového monitoru.
// Demo: barevný IPS displej 1.14" 135x240 (ST7789V) s ESP32-S3
// Knihovna: "GFX Library for Arduino" (Arduino_GFX), deska: ESP32 core 3.x
#include <Arduino_GFX_Library.h>
// Zapojení displeje k ESP32-S3
#define TFT_SCK 12 // SCL
#define TFT_MOSI 11 // SDA
#define TFT_RST 10 // RES
#define TFT_DC 9 // DC
#define TFT_CS 13 // CS
#define TFT_BL 14 // BLK (podsvícení)
Arduino_DataBus *bus = new Arduino_ESP32SPI(TFT_DC, TFT_CS, TFT_SCK, TFT_MOSI, GFX_NOT_DEFINED);
// Panel 135x240 je jen výřez z paměti řadiče 240x320, proto posuny 52/40 a 53/40.
// rotace 1 = na šířku (240x135), true = IPS panel (inverze barev)
Arduino_GFX *gfx = new Arduino_ST7789(bus, TFT_RST, 1, true, 135, 240, 52, 40, 53, 40);
int W, H;
// Celá obrazovka v jedné barvě s nápisem
void napis(const char *text, uint16_t barvaTextu, uint16_t barvaPozadi) {
gfx->fillScreen(barvaPozadi);
gfx->setTextColor(barvaTextu);
gfx->setTextSize(3);
gfx->setCursor(10, H / 2 - 12);
gfx->print(text);
}
// 1) Základní barvy: nápis musí odpovídat barvě pozadí
void testBarev() {
struct { const char *nazev; uint16_t pozadi; uint16_t text; } barvy[] = {
{"CERVENA", RGB565_RED, RGB565_WHITE},
{"ZELENA", RGB565_GREEN, RGB565_BLACK},
{"MODRA", RGB565_BLUE, RGB565_WHITE},
{"BILA", RGB565_WHITE, RGB565_BLACK},
{"CERNA", RGB565_BLACK, RGB565_WHITE},
};
for (auto &b : barvy) {
napis(b.nazev, b.text, b.pozadi);
delay(1200);
}
}
// 2) Rámeček po okraji (kontrola posunu obrazu) a barevné přechody
void testRamecku() {
gfx->fillScreen(RGB565_BLACK);
gfx->drawRect(0, 0, W, H, RGB565_WHITE); // musí být vidět po celém obvodu
gfx->drawRect(2, 2, W - 4, H - 4, RGB565_RED);
gfx->setTextSize(2);
gfx->setTextColor(RGB565_WHITE);
gfx->setCursor(12, 14);
gfx->printf("%dx%d ST7789V", W, H);
int sirka = W - 24;
for (int x = 0; x < sirka; x++) {
uint8_t v = x * 255 / sirka;
gfx->drawFastVLine(12 + x, 50, 30, gfx->color565(v, 0, 255 - v)); // modrá -> červená
gfx->drawFastVLine(12 + x, 90, 30, gfx->color565(v, v, v)); // černá -> bílá
}
delay(4000);
}
// 3) Podsvícení přes PWM: plynule ztmavit a rozsvítit
void testPodsviceni() {
napis("PODSVIT", RGB565_WHITE, RGB565_DARKGREY);
for (int v = 255; v >= 0; v -= 5) { ledcWrite(TFT_BL, v); delay(15); }
for (int v = 0; v <= 255; v += 5) { ledcWrite(TFT_BL, v); delay(15); }
}
// 4) Animace kuliček: snímek se kreslí do paměti a posílá se najednou (bez blikání)
void animace() {
const int N = 12, R = 8;
float x[N], y[N], vx[N], vy[N];
uint16_t barva[N];
for (int i = 0; i < N; i++) {
x[i] = random(R, W - R);
y[i] = random(R, H - R);
vx[i] = random(15, 40) / 10.0 * (random(2) ? 1 : -1);
vy[i] = random(15, 40) / 10.0 * (random(2) ? 1 : -1);
barva[i] = gfx->color565(random(80, 256), random(80, 256), random(80, 256));
}
uint16_t *snimek = (uint16_t *)malloc(W * H * 2); // 240*135*2 = 64,8 kB
if (!snimek) {
Serial.println("Malo pameti pro snimek, animace se preskoci");
return;
}
uint32_t start = millis(), mereni = millis(), pocet = 0;
while (millis() - start < 15000) {
for (int yy = 0; yy < H; yy++) // pozadí s přechodem
for (int xx = 0; xx < W; xx++)
snimek[yy * W + xx] = gfx->color565(0, yy * 60 / H, 40 + xx * 60 / W);
for (int i = 0; i < N; i++) {
x[i] += vx[i]; y[i] += vy[i];
if (x[i] < R || x[i] > W - R) vx[i] = -vx[i];
if (y[i] < R || y[i] > H - R) vy[i] = -vy[i];
for (int dy = -R; dy <= R; dy++)
for (int dx = -R; dx <= R; dx++)
if (dx * dx + dy * dy <= R * R) {
int px = x[i] + dx, py = y[i] + dy;
if (px >= 0 && px < W && py >= 0 && py < H) snimek[py * W + px] = barva[i];
}
}
gfx->draw16bitRGBBitmap(0, 0, snimek, W, H);
pocet++;
if (millis() - mereni >= 1000) {
Serial.printf("FPS: %lu\n", (unsigned long)pocet);
pocet = 0; mereni = millis();
}
}
free(snimek);
}
void setup() {
Serial.begin(115200);
ledcAttach(TFT_BL, 5000, 8); // PWM pro podsvícení, 8 bitů (0-255)
ledcWrite(TFT_BL, 0); // podsvícení zatím vypnuté
gfx->begin(40000000); // SPI 40 MHz
gfx->fillScreen(RGB565_BLACK);
ledcWrite(TFT_BL, 255); // rozsvítit až po smazání obrazovky
W = gfx->width();
H = gfx->height();
}
void loop() {
testBarev();
testRamecku();
testPodsviceni();
animace();
}
Když to nefunguje
- Podsvícení svítí, ale obraz je černý: nejčastěji jsou prohozené vodiče DC a RES. Stalo se nám to i při psaní tohoto článku. Zkontrolujte také SCL a SDA.
- Nesvítí ani podsvícení: zkontrolujte napájení (VCC na 3V3, GND). Pokud je BLK připojený k ESP32, program ho musí nastavit na vysokou úroveň.
- Obraz je posunutý nebo je u okraje pruh šumu: nesedí posuny v konstruktoru, zkontrolujte čísla 52, 40, 53, 40.
- Barvy jsou obrácené (černá je bílá): v konstruktoru chybí
truepro IPS panel. - Obraz se kazí nebo občas zmizí: zkuste kratší vodiče nebo nižší rychlost SPI, například
gfx->begin(20000000). - Chyba při překladu
'ledcAttach' was not declarednebo'RGB565_RED' was not declared: máte starý balík esp32 (2.x) nebo starou knihovnu. Aktualizujte balík esp32 na verzi 3.x a knihovnu GFX Library for Arduino na 1.6.x. - V sériovém monitoru nic není: zkontrolujte rychlost 115200 Bd a port (viz nastavení výše). Rychlost animace se vypisuje až ve čtvrtém kroku, zhruba 12 sekund po startu.
Displej najdete u nás v e-shopu: Barevný displej IPS 1.14" 135x240 ST7789V SPI.
Leave a Comment