How to Use TFT ST7789V 2.8': Examples, Pinouts, and Specs

Introduction

The TFT ST7789V 2.8' is a 2.8-inch thin-film transistor (TFT) display module that utilizes the ST7789V driver. This display is known for its high resolution, vibrant color output, and compact size, making it ideal for a wide range of embedded applications. It supports 240x320 pixel resolution and can display up to 262K colors, providing excellent visual clarity for graphical interfaces.

Explore Projects Built with TFT ST7789V 2.8'

Use Cirkit Designer to design, explore, and prototype these projects online. Some projects support real-time simulation. Click "Open Project" to start designing instantly!

ESP32-Powered 1.3 inch TFT Display Module for Visual Data Output

This circuit connects an ESP32 microcontroller to a 1.3 inch TFT display module (ST7789). The ESP32 provides power and control signals to the display, enabling it to show graphical data.

Open Project in Cirkit Designer

ESP32-C6 and ST7735S Display: Wi-Fi Controlled TFT Display Module

This circuit features an ESP32-C6 microcontroller interfaced with a China ST7735S 160x128 TFT display. The ESP32-C6 controls the display via SPI communication, providing power, ground, and control signals to render graphics and text on the screen.

Open Project in Cirkit Designer

STM32F103C8T6-Based Spectral Sensor with ST7735S Display and Pushbutton Control

This circuit features an STM32F103C8T6 microcontroller interfaced with a China ST7735S 160x128 display and two spectral sensors (Adafruit AS7262 and AS7261). It also includes two pushbuttons for user input, with the microcontroller managing the display and sensor data processing.

Open Project in Cirkit Designer

RTL8720DN-Based Interactive Button-Controlled TFT Display

This circuit features an RTL8720DN microcontroller interfaced with a China ST7735S 160x128 TFT LCD display and four pushbuttons. The microcontroller reads the states of the pushbuttons and displays their statuses on the TFT LCD, providing a visual feedback system for button presses.

Open Project in Cirkit Designer

Common Applications and Use Cases

• Handheld devices and portable electronics
• IoT dashboards and smart home displays
• Wearable devices
• Industrial control panels
• Educational and hobbyist projects with microcontrollers (e.g., Arduino, Raspberry Pi)

Technical Specifications

Below are the key technical details and pin configuration for the TFT ST7789V 2.8' module:

Key Technical Details

Pin Configuration and Descriptions

The TFT ST7789V module typically has an 8-pin interface. Below is the pinout description:

Usage Instructions

How to Use the Component in a Circuit

1. Power Supply: Connect the VCC pin to a 3.3V power source and the GND pin to ground.
2. SPI Communication: Connect the SCL (clock) and SDA (data) pins to the corresponding SPI pins on your microcontroller.
3. Control Pins:
   • Connect the RES pin to a GPIO pin on your microcontroller for resetting the display.
   • Use the DC pin to differentiate between data and command signals.
   • Connect the CS pin to a GPIO pin to enable or disable communication with the display.
4. Backlight: Connect the BLK pin to 3.3V for full brightness or to a PWM pin for adjustable brightness.

Important Considerations and Best Practices

• Voltage Levels: Ensure all signal lines operate at 3.3V logic levels. Use a level shifter if your microcontroller operates at 5V.
• Capacitors: Add decoupling capacitors (e.g., 0.1µF) near the power pins to stabilize the power supply.
• Reset Timing: Hold the RES pin low for at least 10ms during initialization to ensure proper startup.
• SPI Speed: Use an SPI clock speed of up to 15MHz for optimal performance.

Example Code for Arduino UNO

Below is an example of how to interface the TFT ST7789V with an Arduino UNO using the Adafruit ST7789 library:

#include <Adafruit_GFX.h>    // Core graphics library
#include <Adafruit_ST7789.h> // ST7789 driver library
#include <SPI.h>             // SPI library

// Define pin connections
#define TFT_CS    10  // Chip Select pin
#define TFT_RST   9   // Reset pin
#define TFT_DC    8   // Data/Command pin

// Initialize the display object
Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);

void setup() {
  // Initialize serial communication for debugging
  Serial.begin(9600);
  Serial.println("TFT ST7789V Test");

  // Initialize the display
  tft.init(240, 320); // Initialize with 240x320 resolution
  tft.setRotation(1); // Set display orientation (0-3)

  // Fill the screen with a color
  tft.fillScreen(ST77XX_BLACK);

  // Draw a simple message
  tft.setTextColor(ST77XX_WHITE);
  tft.setTextSize(2);
  tft.setCursor(10, 10);
  tft.println("Hello, ST7789!");
}

void loop() {
  // Add your code here to update the display
}

Notes:

• Install the Adafruit GFX and Adafruit ST7789 libraries via the Arduino Library Manager before running the code.
• Adjust the pin definitions (TFT_CS, TFT_RST, TFT_DC) to match your wiring.

Troubleshooting and FAQs

Common Issues and Solutions

1. Display Not Turning On:

   • Verify the power connections (VCC and GND).
   • Ensure the backlight pin (BLK) is connected to 3.3V or a PWM signal.

2. No Output on the Screen:

   • Check the SPI connections (SCL, SDA, CS, DC).
   • Ensure the RES pin is properly connected and initialized in the code.

3. Flickering or Distorted Display:

   • Reduce the SPI clock speed in the code.
   • Add decoupling capacitors near the power pins.

4. Incorrect Colors or Orientation:

   • Verify the initialization code and ensure the correct rotation is set using tft.setRotation().

FAQs

Q: Can I use this display with a 5V microcontroller?
A: Yes, but you must use level shifters to convert the 5V logic signals to 3.3V.

Q: What is the maximum SPI clock speed supported?
A: The ST7789V supports SPI clock speeds up to 15MHz.

Q: Can I control the backlight brightness?
A: Yes, connect the BLK pin to a PWM-capable pin on your microcontroller to adjust brightness.

Q: Is this display compatible with Raspberry Pi?
A: Yes, the display can be used with Raspberry Pi via SPI, but you may need to configure the SPI interface in the Raspberry Pi OS.

This concludes the documentation for the TFT ST7789V 2.8' module.