ST7789 彩色 TFT 显示屏

Overview

基础概况

ST7789 刷新速度快，驱动库成熟，适合作为 ESP32 或 Arduino 项目的主显示界面。

Engineering

工程要点

难度: 中级
数据状态: 待核实
接口: SPIGPIO
常用主控: ESP32ArduinoSTM32Raspberry Pi Pico

供电与采购

供电: 3.3V
购买关键词: ST7789 彩色 TFT 显示屏ST7789 TFT彩色 SPI 屏

典型搭配

状态显示面板

显示项目状态、提示信息或动画反馈。

ST7789 彩色 TFT 显示屏 + ESP32

Specifications

基础参数

参数	值	分组	备注
常见接口	SPI	接口	-
常见分辨率	240x240 / 240x320 px	显示参数	-
逻辑电平	3.3 V	电气参数	-

Pinout

引脚与接线

引脚	说明	连接建议	注意
VCC	电源正极	3.3V	-
GND	地线	GND	-
SCL/SCK	SPI 时钟	ESP32 GPIO 18	-
SDA/MOSI	SPI 数据	ESP32 GPIO 23	-
RES/RST	复位	ESP32 GPIO 4	-
DC	数据/命令选择	ESP32 GPIO 2	-
BLK	背光控制	3.3V 或 PWM GPIO	-

Examples

代码示例

SPI 屏幕初始化

python

# 需要对应 ST7789 MicroPython 驱动库
from machine import Pin, SPI

spi = SPI(1, baudrate=40000000, sck=Pin(18), mosi=Pin(23))
reset = Pin(4, Pin.OUT)
dc = Pin(2, Pin.OUT)
print("ST7789 SPI ready")

Arduino 初始化框架

cpp

#include <Adafruit_GFX.h>
#include <Adafruit_ST7789.h>

#define TFT_CS  -1
#define TFT_DC   2
#define TFT_RST  4
Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);

void setup() {
  tft.init(240, 240);
  tft.fillScreen(ST77XX_BLACK);
  tft.setCursor(10, 10);
  tft.setTextColor(ST77XX_WHITE);
  tft.print("Hello Maker");
}

void loop() {}

Applications

应用场景

APP

交互式信息显示

ST7789 彩色 TFT 显示屏可显示状态、图标、传感器读数或视觉交互结果。

ST7789 彩色 TFT 显示屏ESP32

Warnings

注意事项

屏幕排线和背光电流要按模块说明接线，避免直接接错电源。

Relations

ST7789 彩色 TFT 显示屏

编辑图片

基础概况

工程要点

工程要点

供电与采购

典型搭配

基础参数

引脚与接线

代码示例

应用场景

交互式信息显示

注意事项

相关模块

ESP32-S3 开发板

ESP32-WROOM-32 开发板