ST7789显示屏MicroPython驱动开发：从硬件适配到项目实战

在嵌入式系统开发中，ST7789显示屏凭借其高性价比和广泛兼容性成为开发者首选。本文基于st7789py_mpy驱动库，通过"问题-方案-实践"三段式框架，从零开始讲解ST7789显示屏的MicroPython驱动开发，帮助开发者快速掌握从环境搭建到高级优化的全流程技术。

核心价值解析：为什么选择st7789py_mpy驱动库

面对市场上众多的显示屏驱动方案，st7789py_mpy库凭借其独特优势脱颖而出。该驱动库不仅简化了ST7789显示屏的初始化流程，还提供了丰富的图形显示功能，让开发者能够专注于应用逻辑而非底层硬件细节。核心驱动源码集中在lib/st7789py.py文件中，通过模块化设计实现了高效的显示控制。

💡 技术提示：与其他驱动相比，st7789py_mpy的创新之处在于其硬件抽象层设计，可通过 tft_configs/目录下的配置模板快速适配不同开发板，大大降低了硬件适配难度。

环境部署指南：零基础搭建ST7789开发环境

源码获取与项目结构解析

首先获取项目源码，在终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/st/st7789py_mpy

项目主要目录结构如下：

• lib/：核心驱动实现
• examples/：功能演示代码
• tft_configs/：硬件配置模板
• romfonts/：内置字体资源
• utils/：辅助工具脚本

开发环境配置步骤

1. 安装MicroPython固件到开发板
2. 使用ampy或rshell工具上传库文件
3. 根据开发板型号选择对应的配置模板

⚠️ 注意事项：确保开发板已正确安装MicroPython固件，不同型号开发板的固件有所区别，需从官方网站下载对应版本。

硬件适配方案：ST7789显示屏与开发板连接实战

硬件连接指南

ST7789显示屏通常通过SPI接口与主控板连接，典型的连接方式如下：

• SCK：时钟线，连接到开发板的SPI时钟引脚
• SDA：数据线，连接到开发板的SPI MOSI引脚
• DC：数据/命令选择引脚
• RST：复位引脚
• CS：片选引脚
• VCC：电源引脚（通常为3.3V）
• GND：接地引脚

配置文件修改实例

以ESP32开发板为例，修改tft_configs/esp32_320x240/tft_config.py文件：

from machine import Pin, SPI
import st7789py as st7789

def config(rotation=0):
    # 配置SPI接口
    spi = SPI(2, baudrate=40000000, sck=Pin(18), mosi=Pin(19))
    
    # 初始化显示屏
    return st7789.ST7789(
        spi,
        240, 320,  # 屏幕宽高
        reset=Pin(23, Pin.OUT),
        cs=Pin(5, Pin.OUT),
        dc=Pin(16, Pin.OUT),
        backlight=Pin(4, Pin.OUT),
        rotation=rotation
    )

💡 技术提示：不同开发板的引脚定义不同，可参考tft_configs/目录下的对应配置模板进行修改。

功能实现手册：ST7789显示功能从零开始实现

基础显示功能实现

下面是一个简单的"Hello World"显示示例：

import st7789py as st7789
import tft_config
import vga2_bold_16x32 as font

# 初始化显示屏
tft = tft_config.config()

# 清屏并设置黑色背景
tft.fill(st7789.BLACK)

# 在屏幕中央显示文本
text = "Hello World!"
text_width = len(text) * font.WIDTH
text_height = font.HEIGHT
x = (tft.width - text_width) // 2
y = (tft.height - text_height) // 2

tft.text(font, text, x, y, st7789.WHITE, st7789.BLACK)

ST7789驱动显示Hello World文本效果，展示了MicroPython显示功能的基本实现

字体显示与管理

st7789py_mpy提供了丰富的字体资源，位于romfonts/目录。以下代码演示如何使用不同字体：

import st7789py as st7789
import tft_config
import vga1_8x8 as small_font
import vga2_bold_16x32 as large_font

tft = tft_config.config()
tft.fill(st7789.BLACK)

# 显示小号字体
tft.text(small_font, "Small Font", 10, 10, st7789.RED)

# 显示大号粗体字体
tft.text(large_font, "Large Bold", 10, 30, st7789.GREEN)

ST7789驱动下不同字体的显示效果对比，展示了MicroPython驱动的字体渲染能力

屏幕旋转功能实现

st7789py_mpy支持四种屏幕旋转模式，满足不同安装需求：

import st7789py as st7789
import tft_config
import vga2_bold_16x32 as font

tft = tft_config.config(rotation=0)  # 0度旋转
tft.fill(st7789.BLACK)
tft.text(font, "Rotation 0", 10, 100, st7789.WHITE)

# 可以通过以下代码动态改变旋转角度
# tft.rotation(1)  # 90度
# tft.rotation(2)  # 180度
# tft.rotation(3)  # 270度

ST7789显示屏四种旋转角度的显示效果，展示了MicroPython驱动的屏幕方向控制功能

图形绘制功能实现

st7789py_mpy提供了丰富的图形绘制API：

import st7789py as st7789
import tft_config

tft = tft_config.config()
tft.fill(st7789.BLACK)

# 绘制基本图形
tft.line(0, 0, tft.width-1, tft.height-1, st7789.RED)
tft.rect(10, 10, 50, 50, st7789.GREEN)
tft.fill_rect(70, 10, 50, 50, st7789.BLUE)
tft.circle(150, 35, 25, st7789.YELLOW)

场景应用案例：ST7789显示屏项目实战

彩色测试图案显示

以下代码实现了一个彩色测试图案，可用于检测显示屏色彩显示效果：

import st7789py as st7789
import tft_config

tft = tft_config.config()
width = tft.width
height = tft.height

# 绘制三原色测试条
tft.fill_rect(0, 0, width, height//3, st7789.RED)
tft.fill_rect(0, height//3, width, height//3, st7789.GREEN)
tft.fill_rect(0, 2*height//3, width, height//3, st7789.BLUE)

# 显示颜色名称
import vga2_bold_16x32 as font
tft.text(font, "Red", 10, 10, st7789.WHITE)
tft.text(font, "Green", 10, height//3 + 10, st7789.WHITE)
tft.text(font, "Blue", 10, 2*height//3 + 10, st7789.WHITE)

ST7789显示屏彩色测试图案，展示了MicroPython驱动的色彩显示能力

彩色条显示实现

彩色条显示是测试显示屏效果的常用方法：

import st7789py as st7789
import tft_config

tft = tft_config.config()
width = tft.width
height = tft.height
color_count = 8
bar_width = width // color_count

# 定义彩虹色序列
colors = [
    st7789.RED, st7789.ORANGE, st7789.YELLOW,
    st7789.GREEN, st7789.CYAN, st7789.BLUE,
    st7789.PURPLE, st7789.MAGENTA
]

# 绘制彩色条
for i in range(color_count):
    tft.fill_rect(i*bar_width, 0, bar_width, height, colors[i])

ST7789显示屏彩色条显示效果，展示了MicroPython驱动的色彩渐变能力

进阶优化策略：提升ST7789显示性能的实战技巧

内存管理优化

在资源受限的嵌入式设备上，合理管理内存至关重要：

# 优化内存使用的技巧
import st7789py as st7789
import tft_config

tft = tft_config.config()

# 1. 使用局部变量而非全局变量
def draw_something():
    # 局部变量在函数结束后自动释放
    buffer = bytearray(100)
    # 使用buffer进行绘制操作
    # ...

# 2. 及时删除不再使用的大型对象
large_bitmap = None  # 将不再使用的大型对象设为None，触发垃圾回收

💡 技术提示：使用gc.collect()可以手动触发垃圾回收，但应谨慎使用，最好在内存密集型操作后调用。

显示性能调优

提高显示性能的关键技巧：

# 性能优化示例
import st7789py as st7789
import tft_config
import time

tft = tft_config.config()

# 1. 使用批量绘制代替多次单个绘制
start_time = time.ticks_ms()

# 不推荐：多次单独绘制
# for i in range(100):
#     tft.pixel(i, i, st7789.WHITE)

# 推荐：使用填充矩形一次绘制
tft.fill_rect(0, 0, 100, 100, st7789.WHITE)

end_time = time.ticks_ms()
print(f"绘制时间: {end_time - start_time}ms")

低功耗实现策略

在电池供电的设备上，降低功耗至关重要：

# 低功耗实现示例
import st7789py as st7789
import tft_config
import machine

tft = tft_config.config()

# 1. 降低SPI通信速率
# 在初始化时设置较低的波特率
# spi = SPI(2, baudrate=10000000, sck=Pin(18), mosi=Pin(19))

# 2. 控制背光
backlight = machine.Pin(4, machine.Pin.OUT)

def set_brightness(level):
    """设置亮度等级(0-100)"""
    # 这里假设使用PWM控制背光
    pwm = machine.PWM(backlight)
    pwm.freq(1000)
    pwm.duty_u16(int(level / 100 * 65535))

# 降低亮度以节省电量
set_brightness(50)

# 3. 屏幕休眠
def sleep_mode(enable=True):
    if enable:
        tft.fill(st7789.BLACK)
        backlight.value(0)  # 关闭背光
    else:
        backlight.value(1)  # 打开背光

⚠️ 注意事项：不同的显示屏模块可能有不同的低功耗特性，需参考具体硬件手册进行优化。

通过本文介绍的st7789py_mpy驱动库使用方法，开发者可以快速实现ST7789显示屏的各种显示功能。无论是简单的文本显示还是复杂的图形绘制，该驱动库都提供了简洁而强大的API接口。通过合理应用进阶优化策略，还可以进一步提升显示性能并降低系统功耗，满足不同嵌入式项目的需求。