Component guide · Intermediate · 3 min read
ST7789 IPS LCD (1.14 and 1.69 Inch)

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The ST7789 is the controller in most small IPS colour screens, including the Waveshare 1.14 inch (240x135) and 1.69 inch (240x280, rounded corners) modules. They connect over 4-wire SPI with DC, RST and backlight pins, run from 3.3 V or 5 V (the boards have a regulator and level shifting), and give wide viewing angles and bright colour for watches, meters and small dashboards.
Key specs at a glance
- Controller
- ST7789V / ST7789V2
- Resolution
- 240 x 135 (1.14 inch), 240 x 280 (1.69 inch)
- Panel
- IPS, 65K or 262K colours, wide viewing angle
- Interface
- 4-wire SPI, up to about 60 MHz
- Supply
- 3.3 V or 5 V (Waveshare boards)
- Pins
- VCC, GND, DIN, CLK, CS, DC, RST, BL
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
Option 1Waveshare 1.14 inch IPS LCD Module, 240x135, SPI₹800
Option 2Waveshare 1.69 inch IPS LCD Display Module, 240x280₹1,000
What the ST7789 IPS display is
The panel is smaller than the ST7789's 240x320 memory, so libraries need an offset (for example 40 and 52 on the 1.14 inch, 0 and 20 on the 1.69 inch). Without the right offset, the picture shifts and shows noise at one edge.
The BL pin turns the backlight on and can be dimmed with PWM.
ST7789 IPS display pinout
The pins on the ST7789 IPS display and what each one does.
| Pin | Function |
|---|---|
| VCC | 3.3 or 5 V |
| GND | Ground |
| DIN | SPI MOSI |
| CLK | SPI SCK |
| CS | Chip select |
| DC | Data / command |
| RST | Reset |
| BL | Backlight (HIGH or PWM) |
- VCC
- 3.3 or 5 V
- GND
- Ground
- DIN
- SPI MOSI
- CLK
- SPI SCK
- CS
- Chip select
- DC
- Data / command
- RST
- Reset
- BL
- Backlight (HIGH or PWM)
Wiring the ST7789 IPS display
The Waveshare modules level-shift their inputs, so an Uno can connect directly; generic bare ST7789 boards are 3.3 V only. On a Raspberry Pi Pico, use SPI0 (GP18 SCK, GP19 MOSI).
| ST7789 IPS display pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC / GND | 5V / GND | 3V3 / GND |
| DIN | D11 | GPIO 23 |
| CLK | D13 | GPIO 18 |
| CS | D10 | GPIO 15 |
| DC | D9 | GPIO 2 |
| RST | D8 | GPIO 4 |
| BL | D6 (PWM) | GPIO 32 |
- VCC / GND
- Arduino Uno:
- 5V / GND
- ESP32:
- 3V3 / GND
- DIN
- Arduino Uno:
- D11
- ESP32:
- GPIO 23
- CLK
- Arduino Uno:
- D13
- ESP32:
- GPIO 18
- CS
- Arduino Uno:
- D10
- ESP32:
- GPIO 15
- DC
- Arduino Uno:
- D9
- ESP32:
- GPIO 2
- RST
- Arduino Uno:
- D8
- ESP32:
- GPIO 4
- BL
- Arduino Uno:
- D6 (PWM)
- ESP32:
- GPIO 32
Example code
The Adafruit library sets the panel offsets for these sizes. With TFT_eSPI, choose ST7789_DRIVER and set TFT_WIDTH, TFT_HEIGHT and the offsets in User_Setup.h.
#include <Adafruit_GFX.h>
#include <Adafruit_ST7789.h>
#define TFT_CS 10
#define TFT_DC 9
#define TFT_RST 8
Adafruit_ST7789 tft(TFT_CS, TFT_DC, TFT_RST);
void setup() {
pinMode(6, OUTPUT); digitalWrite(6, HIGH); // backlight
tft.init(240, 280); // 1.69 inch; use init(135, 240) for 1.14 inch
tft.setRotation(1);
tft.fillScreen(ST77XX_BLACK);
tft.setTextColor(ST77XX_CYAN);
tft.setTextSize(3);
tft.setCursor(20, 40);
tft.print("ST7789");
}
void loop() {}Setup and tuning
if the image is shifted, set the column and row offsets for your size.
call invertDisplay(true) or set TFT_INVERSION_ON.
on ESP32 use 40 to 80 MHz SPI with TFT_eSPI for smooth animation.
drive BL with PWM to save power on battery projects.
What you need
Shop this list5 of 6 found in our store · ₹2,657
Waveshare 1.14 inch IPS LCD Module, 240x135, SPI: the part this guide coversWaveshare 1.14 inch IPS LCD Module, 240x135, SPI₹800
Waveshare 1.69 inch IPS LCD Display Module, 240x280: another version this guide coversWaveshare 1.69 inch IPS LCD Display Module, 240x280₹1,000- 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
Raspberry Pi Pico WH: a small board for watch or meter projectsRaspberry Pi Pico₹419
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- GC9A01 round display: 1.28 inch round 240x240.
- ST7735 TFT: older, cheaper 128x160 TFT.
- SSD1306 OLED: monochrome, very low power.
Common mistakes to avoid
- Using a 240x320 setting on a 240x280 panel and getting a shifted image.
- Leaving BL unconnected and seeing a black screen.
- Connecting a bare 3.3 V ST7789 board to 5 V pins.
- Swapping DC and CS.
Frequently asked questions
Why is half my screen noise?
The panel offset is wrong; use the correct init size or offsets.
Can I use it with a Raspberry Pi Pico?
Yes, with Arduino-Pico or MicroPython st7789 drivers on SPI0.
Why are the colours wrong?
Turn on display inversion or change the RGB/BGR order.
Does it have touch?
These two modules do not. The Waveshare 1.28 inch round module has touch.
Is it 5 V tolerant?
The Waveshare modules are; generic bare modules are not.
Parts for 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.


