Component guide · Intermediate · 3 min read
ILI9488 3.5 Inch SPI TFT Touch Display

Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
This 3.5 inch display uses the ILI9488 driver for 480 × 320 colour pixels over SPI, with an XPT2046 resistive touch controller and usually an SD card slot on the same board. It is a good size for control panels and dashboards. Over SPI it sends 18-bit colour, so an ESP32 is the right controller; an Uno does not have the speed or memory.
Key specs at a glance
- Size
- 3.5 inch, 480 × 320 pixels
- Driver
- ILI9488 (18-bit colour over SPI)
- Touch
- XPT2046 resistive touch on SPI
- Interface
- SPI for display, touch and SD
- Supply
- 3.3 V logic, VCC 3.3 or 5 V (on-board regulator)
- Extras
- SD card slot on most boards
What the ILI9488 display is
The display, touch controller and SD card each have their own CS pin and share the SPI clock and data lines. Over SPI the ILI9488 needs 3 bytes per pixel, so a full screen redraw is slower than on the ILI9341; draw only what changes.
The MISO line of some ILI9488 boards does not release the bus, which can stop touch or SD working when shared. If that happens, leave the display's MISO unconnected.
ILI9488 display pinout
The pins on the ILI9488 display and what each one does.
| Pin | Function |
|---|---|
| VCC / GND | Supply and ground |
| CS | Display chip select |
| RESET | Reset |
| DC/RS | Data or command |
| SDI (MOSI) / SCK | SPI data and clock (shared) |
| LED | Backlight, to 3.3 V |
| SDO (MISO) | Display data out (often leave unconnected) |
| T_CLK T_CS T_DIN T_DO T_IRQ | Touch controller SPI and interrupt |
- VCC / GND
- Supply and ground
- CS
- Display chip select
- RESET
- Reset
- DC/RS
- Data or command
- SDI (MOSI) / SCK
- SPI data and clock (shared)
- LED
- Backlight, to 3.3 V
- SDO (MISO)
- Display data out (often leave unconnected)
- T_CLK T_CS T_DIN T_DO T_IRQ
- Touch controller SPI and interrupt
Wiring the ILI9488 display
Leave the display's SDO (MISO) unconnected if touch reads do not work. Logic is 3.3 V: do not connect 5 V signals.
| ILI9488 display pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC | Not recommended (too slow) | 3V3 or 5V (VIN) |
| GND | - | GND |
| CS | - | GPIO 15 |
| RESET | - | GPIO 4 |
| DC | - | GPIO 2 |
| SDI (MOSI) + T_DIN | - | GPIO 23 |
| SCK + T_CLK | - | GPIO 18 |
| T_DO | - | GPIO 19 |
| T_CS | - | GPIO 21 |
| LED | - | 3V3 |
- VCC
- Arduino Uno:
- Not recommended (too slow)
- ESP32:
- 3V3 or 5V (VIN)
- GND
- Arduino Uno:
- -
- ESP32:
- GND
- CS
- Arduino Uno:
- -
- ESP32:
- GPIO 15
- RESET
- Arduino Uno:
- -
- ESP32:
- GPIO 4
- DC
- Arduino Uno:
- -
- ESP32:
- GPIO 2
- SDI (MOSI) + T_DIN
- Arduino Uno:
- -
- ESP32:
- GPIO 23
- SCK + T_CLK
- Arduino Uno:
- -
- ESP32:
- GPIO 18
- T_DO
- Arduino Uno:
- -
- ESP32:
- GPIO 19
- T_CS
- Arduino Uno:
- -
- ESP32:
- GPIO 21
- LED
- Arduino Uno:
- -
- ESP32:
- 3V3
Example code
Print the cal[] values after calibration and pass them to tft.setTouch(cal) in later sketches so you only calibrate once. LVGL runs well on top of TFT_eSPI for buttons and menus.
// In TFT_eSPI User_Setup.h: #define ILI9488_DRIVER, TFT_MISO 19, TFT_MOSI 23,
// TFT_SCLK 18, TFT_CS 15, TFT_DC 2, TFT_RST 4, TOUCH_CS 21
#include <TFT_eSPI.h>
TFT_eSPI tft;
void setup() {
tft.init();
tft.setRotation(1); // landscape 480 x 320
tft.fillScreen(TFT_BLACK);
uint16_t cal[5];
tft.calibrateTouch(cal, TFT_WHITE, TFT_RED, 15); // tap the corners once
tft.fillScreen(TFT_BLACK);
}
void loop() {
uint16_t x, y;
if (tft.getTouch(&x, &y)) tft.fillCircle(x, y, 3, TFT_CYAN);
}Setup and tuning
pick ILI9488_DRIVER and set the pins in TFT_eSPI before compiling.
once and save the values.
redraw only the parts that change; full redraws take a moment over SPI.
give it its own CS pin and initialise it after the display.
What you need
Shop this list4 of 4 found in our store · ₹1,507
3.5" SPI TFT Touch Display ILI9488 480×320: the part this guide covers3.5" SPI TFT Touch Display ILI9488 480×320₹1,024
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
MicroSD card module (SPI): only if your board has no SD slotMicroSD Card Module (SPI)₹45
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- TFT displays: ILI9341, ST7789 and other drivers compared.
- ESP32 touchscreen dev boards: screen and ESP32 on one board, no wiring.
- GC9A01 round display: small round screen for gauges.
Common mistakes to avoid
- Using an Arduino Uno: too slow and too little memory.
- Sharing the display's MISO so touch and SD stop responding.
- Choosing ILI9341 instead of ILI9488 in the library, giving wrong colours or a blank screen.
- Skipping touch calibration so taps land in the wrong place.
Frequently asked questions
Does the ILI9488 work with Arduino Uno?
Not well; it needs more speed and memory. Use an ESP32.
Why does touch not work?
Often the display's MISO holds the bus. Disconnect it, and check TOUCH_CS is set.
ILI9488 or ILI9341?
ILI9488 has a bigger 480 × 320 screen; the ILI9341 is faster over SPI at 320 × 240.
Can I use LVGL?
Yes, LVGL works on an ESP32 with TFT_eSPI as the display driver.
Is the touch capacitive?
No, it is resistive: press with a fingertip or stylus.
Parts for this guide
Projects that use it
Put this into practice: 7 step-by-step builds in our project library use parts from this guide.
Keep learning
Sources
- ILI9488 a-Si TFT LCD single-chip driver datasheet (ILI Technology)
- XPT2046 touch screen controller datasheet
- TFT_eSPI library documentation (Bodmer)
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.
