Appendix · Display Drivers

Display Drivers

Copy-paste configs for ILI9341, ST7789, ST7735, and friends.

The driver chip is silk-screened on most panels' PCBs. If you can't find it, try the most common one (ILI9341 for 320×240, ST7789 for 240×240) - wrong driver shows as a blank or noisy screen, not as smoke.

ILI9341

320×240 (most common 2.4–2.8" panels)

yamlILI9341 display block

spi:
  clk_pin: GPIO18
  mosi_pin: GPIO23
  miso_pin: GPIO19

display:
  - platform: ili9xxx
    model: ili9341
    cs_pin: GPIO5
    dc_pin: GPIO2
    reset_pin: GPIO4
    rotation: 90
    auto_clear_enabled: false

Pin numbers vary by board. The GPIOs above are typical for an ESP32 dev kit - if you have a WT32-SC01, T-Display-S3, or another integrated panel, check the board's pinout in its docs and replace the numbers accordingly.

Always set auto_clear_enabled: false when LVGL is driving the display - LVGL manages its own buffer, and the auto-clear would fight it.