Boards / Common wiring

ESP32 + ILI9341 2.8" SPI

The classic breadboard combination: ESP32 DevKit, 2.8" ILI9341, XPT2046 resistive touch on the same SPI bus.

At a glance


Maker	Generic
MCU	ESP32 (WROOM / WROVER) Xtensa LX6 dual-core @ 240 MHz, 520 KB SRAM (+ up to 8 MB PSRAM on WROVER)
Display	Ilitek ILI9341, 240 x 320 px, SPI (4-wire serial), 16-bit colour
Touch	XPTek XPT2046 (resistive, SPI)
Backlight	GPIO 21, dimmable (PWM)
PSRAM	No
Graphics library	TFT_eSPI

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

XPT2046: 2500 kHz, shares the display bus.

Check your revision. Wiring template rather than a fixed board - adjust to match how you actually wired it.

Choose ESP32 + ILI9341 2.8" 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 TFT_eSPI 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.
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 (WROOM / WROVER). No native RGB parallel peripheral - use SPI or an 8/16-bit i80 bus.

TFT_eSPI. Fastest for SPI panels on ESP32. Configured via User_Setup.h build defines.

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