Boards / Common wiring

ESP32-S3 + ILI9341 SPI

ESP32-S3 DevKitC wired to a 2.8" ILI9341 with XPT2046 touch.

At a glance


Maker	Generic
MCU	ESP32-S3 Xtensa LX7 dual-core @ 240 MHz, 512 KB SRAM (+ up to 8 MB PSRAM)
Display	Ilitek ILI9341, 240 x 320 px, SPI (4-wire serial), 16-bit colour
Touch	XPTek XPT2046 (resistive, SPI)
Backlight	GPIO 47, dimmable (PWM)
PSRAM	Yes
Graphics library	LovyanGFX

ILI9341 on SPI (4-wire serial): SPI clock 40 MHz, host SPI2_HOST, BGR colour order, inversion off.

XPT2046: 2500 kHz, shares the display bus.

Check your revision. Wiring template - change the pins to match your build.

Choose ESP32-S3 + ILI9341 SPI on the Hardware tab (or use the button above) and every pin on this page is filled in. The export writes the sketch, lcd_pins.h, the LovyanGFX configuration, lv_conf.h and platformio.ini - a project that builds for this board as it comes.
The XPT2046 is resistive, so the firmware calibrates it on the device: touch the crosses on the first boot after an upload and the result is saved. The screen says whether it worked.
The backlight is dimmable: give a slider or a button a Set backlight action.
With PSRAM the LVGL memory pool can live there, leaving internal RAM for everything else.
Screens are designed for 240 x 320 px in either orientation, with LVGL 9 or LVGL 8.

ILI9341. The most common hobby TFT. 2.2"-2.8" modules, usually with an XPT2046 resistive panel.

XPT2046. The classic 4-wire resistive controller. Needs calibration. Can share the display SPI bus with its own CS.

ESP32-S3. The only common Arduino target with a hardware RGB565 LCD peripheral. PSRAM is effectively required for RGB panels.

LovyanGFX. Widest panel and bus coverage, DMA on ESP32. Configured with a C++ config class.

Nobody has published a design for this board yet. Publish yours from the designer and it appears here and in the gallery.