Component guide · Intermediate · 3 min read
2.4 and 2.8 Inch ILI9341 TFT Touch Display

SPI Module and Uno Shield
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The 2.4 and 2.8 inch 240x320 colour TFTs come in two forms. The SPI module (red board, 14 pins) uses an ILI9341 controller plus an XPT2046 resistive touch chip and suits ESP32 and Pi. The Uno shield plugs on top of an Uno or Mega, uses an 8-bit parallel bus and has a microSD slot, and is driven with the MCUFRIEND_kbv library, which detects its controller.
Key specs at a glance
- Resolution
- 240 x 320, 65K colours
- Size
- 2.4 or 2.8 inch
- Controller
- ILI9341 on SPI modules; ILI9341, ILI9325 or ST7781 on Uno shields
- Touch
- Resistive: XPT2046 SPI chip (module) or 4-wire analog (shield)
- Logic
- 3.3 V on the SPI module (VCC 3.3 or 5 V with on-board regulator)
- Extras
- microSD slot on most versions
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
What the ILI9341 TFT display is
Use the SPI module with an ESP32 for fast graphics, LVGL dashboards and touch menus. Use the shield when you want to plug a screen onto an Uno with no wiring; it takes almost all Uno pins, so only a few remain free.
Touch on the shield is read with the analog pins and the TouchScreen library; touch on the SPI module shares the SPI bus with its own CS pin.
ILI9341 TFT display pinout
The pins on the ILI9341 TFT display and what each one does.
| Pin | Function |
|---|---|
| VCC / GND | Power (3.3 V or 5 V, see J1 jumper) |
| CS | Display chip select |
| RESET | Display reset |
| DC | Data / command |
| SDI (MOSI) / SCK | SPI data and clock |
| LED | Backlight (3.3 V or PWM) |
| SDO (MISO) | SPI read (optional) |
| T_CLK / T_CS / T_DIN / T_DO / T_IRQ | XPT2046 touch SPI |
- VCC / GND
- Power (3.3 V or 5 V, see J1 jumper)
- CS
- Display chip select
- RESET
- Display reset
- DC
- Data / command
- SDI (MOSI) / SCK
- SPI data and clock
- LED
- Backlight (3.3 V or PWM)
- SDO (MISO)
- SPI read (optional)
- T_CLK / T_CS / T_DIN / T_DO / T_IRQ
- XPT2046 touch SPI
Wiring the ILI9341 TFT display
The SPI module's signals are 3.3 V only: with an Uno use a level shifter or 1 k / 2 k dividers on every input. The ESP32 connects directly. The Uno shield needs no wiring at all.
| ILI9341 TFT display pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC / LED | 3.3V (via level shifter on signals) | 3V3 |
| CS | D10 | GPIO 15 |
| RESET | D8 | GPIO 4 |
| DC | D9 | GPIO 2 |
| SDI / T_DIN | D11 | GPIO 23 |
| SCK / T_CLK | D13 | GPIO 18 |
| SDO / T_DO | D12 | GPIO 19 |
| T_CS | D7 | GPIO 21 |
- VCC / LED
- Arduino Uno:
- 3.3V (via level shifter on signals)
- ESP32:
- 3V3
- CS
- Arduino Uno:
- D10
- ESP32:
- GPIO 15
- RESET
- Arduino Uno:
- D8
- ESP32:
- GPIO 4
- DC
- Arduino Uno:
- D9
- ESP32:
- GPIO 2
- SDI / T_DIN
- Arduino Uno:
- D11
- ESP32:
- GPIO 23
- SCK / T_CLK
- Arduino Uno:
- D13
- ESP32:
- GPIO 18
- SDO / T_DO
- Arduino Uno:
- D12
- ESP32:
- GPIO 19
- T_CS
- Arduino Uno:
- D7
- ESP32:
- GPIO 21
Example code
For the Uno shield, use MCUFRIEND_kbv with Adafruit_GFX and the TouchScreen library; run its graphictest_kbv example first to see which controller ID it reports.
#include <TFT_eSPI.h> // set ILI9341_DRIVER and pins in User_Setup.h
TFT_eSPI tft;
void setup() {
tft.init();
tft.setRotation(1);
tft.fillScreen(TFT_BLACK);
tft.setTextColor(TFT_WHITE, TFT_BLACK);
tft.drawString("Touch the screen", 20, 20, 4);
uint16_t cal[5] = {300, 3500, 300, 3500, 1}; // run Touch_calibrate example for yours
tft.setTouch(cal);
}
void loop() {
uint16_t x, y;
if (tft.getTouch(&x, &y)) tft.fillCircle(x, y, 3, TFT_YELLOW);
}Setup and tuning
edit User_Setup.h for ILI9341_DRIVER, your pins and TOUCH_CS before compiling.
run the Touch_calibrate example and paste the five values into setTouch().
usually the wrong controller; MCUFRIEND_kbv reads the ID and prints it.
shares SPI; give it its own CS pin and use FAT32 cards.
What you need
Shop this list8 of 9 found in our store · ₹3,389
SPI TFT Touch Display Module, 240x320 (2.4 / 2.8 inch): the part this guide coversSPI TFT Touch Display Module, 240x320 (2.4 / 2.8 inch)₹515
2.4″ TFT Touch Screen Display Shield for Arduino UNO Mega: another version this guide covers2.4″ TFT Touch Screen Display Shield for Arduino UNO Mega₹506
2.4-inch TFT Touch Screen Module for Arduino UNO R3: another version this guide covers2.4-inch TFT Touch Screen Module for Arduino UNO R3₹669
TFT Display Shield for Arduino Uno / Mega: another version this guide coversTFT Display Shield for Arduino Uno / Mega₹265- Uno R3 development board: the controller used in the wiring tableFind this part
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
Arduino Mega 2560 Rev3: for the shield with pins left overArduino Mega 2560 Rev3₹980
4-channel logic level converter (BSS138): to connect 5 V and 3.3 V signals safely4-Channel Logic Level Converter (BSS138)₹20
MicroSD card module: to store images for the displayMicroSD Card Module (SPI)₹45Closest match, check the specs
Alternatives and when to choose them
- ILI9488 3.5 inch TFT: larger 320x480 screen.
- ST7735 TFT: smaller 1.8 inch 128x160.
- TFT displays: controllers and interfaces compared.
Common mistakes to avoid
- Wiring 5 V Uno pins straight to the SPI module.
- Not setting the driver and pins in TFT_eSPI User_Setup.h.
- Skipping touch calibration so taps land in the wrong place.
- Expecting free pins on an Uno with the shield fitted.
Frequently asked questions
Why is my screen white?
Wrong driver or wiring. For the shield, run MCUFRIEND_kbv's diagnostic; for the module, check RESET, DC and the TFT_eSPI setup.
Can I use it with a Raspberry Pi?
The SPI module, yes, with the fbcp-ili9341 driver or Python libraries; the shield is Uno and Mega only.
Is the touch capacitive?
No, it is resistive: press with a fingertip or stylus.
Does the module work at 5 V?
VCC can be 5 V with the regulator, but the signal pins are 3.3 V.
Which library is fastest?
TFT_eSPI on ESP32; LVGL runs on top of it for menus.
Parts for this guide
Projects that use it
Put this into practice: 2 step-by-step builds in our project library use parts from this guide.
Keep learning
Sources
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.

