Skip to main content

wokwi-ili9341 Reference

Full color 240x320 2.8" LCD-TFT display with SPI interface

Pin names

#NameDescriptionArduino Uno pin
1VCCSupply voltage5V
2GNDGroundGND
3CSChip select10†
4RSTReset*-
5D/CData/command pin9†
6MOSISPI data (MCU → LCD)11
7SCKSPI clock13
8LEDBacklight LED*5V
9MISOSPI data (LCD → MCU)‡12

* The RST and backlight (LED) pins are not available in the simulation.
† You connect CS and D/C to any digital Arduino pin. The pin numbers here are just an example.
‡ You can leave MISO disconnected, unless you need to read data back from the LCD.

Attributes

NameDescriptionDefault value
flipHorizontalSet to "1" to flip the display horizontally""
flipVerticalSet to "1" to flip the display vertically""

Using in Arduino

You can use the Adafruit_ILI9341 library or the lcdgfx library to interface with the LCD display. The following code example shows basic usage with Adafruit_ILI9341. It works with the pin connections from the table above:

#include "SPI.h"
#include "Adafruit_GFX.h"
#include "Adafruit_ILI9341.h"

#define TFT_DC 9
#define TFT_CS 10
Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC);

void setup() {
tft.begin();

tft.setCursor(26, 120);
tft.setTextColor(ILI9341_RED);
tft.setTextSize(3);
tft.println("Hello, TFT!");

tft.setCursor(20, 160);
tft.setTextColor(ILI9341_GREEN);
tft.setTextSize(2);
tft.println("I can has colors?");
}

void loop() { }

Run this example on Wokwi

Simulator examples