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.

Barevný IPS displej 1.14 palce 135×240 s řadičem ST7789V a běžící animací z ukázkového kódu

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í.

DisplejESP32-S3Význam
GNDGNDzem
VCC3V3napájení 3,3 V
SCLGPIO12hodiny SPI
SDAGPIO11data SPI (MOSI)
RESGPIO10reset displeje
DCGPIO9přepínání příkaz/data
CSGPIO13výběr čipu
BLKGPIO14podsví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:

  1. Barvy: červená, zelená, modrá, bílá a černá s nápisem. Nápis musí odpovídat barvě pozadí.
  2. 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é.
  3. Podsvícení: obrazovka plynule ztmavne a zase se rozsvítí.
  4. 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í true pro 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 declared nebo '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.