<think>我们正在讨论的是MicroPython中ST7789V显示屏的驱动库。根据引用内容，有两个主要的开源项目： 1. st7789py_mpy (引用[1][4]) 2. st7789_mpy (引用[3]) 这两个库都是为MicroPython设计的ST7789驱动，但由不同的开发者维护，可能具有不同的特性和API。 下面我将分别介绍这两个库，并提供基本的使用方法。 </think> ### MicroPython ST7789V驱动库介绍与使用指南 #### 一、主要ST7789V驱动库对比 | 项目名称 | st7789py_mpy [^1][^4] | st7789_mpy [^3] | |----------------|--------------------------------|--------------------------------| | 开发者 | Russ Hughes | Fast pure-C驱动团队 | | 核心语言 | Python | C语言优化 | | 主要特性 | 基础绘图、文本显示 | 高性能渲染、帧缓冲支持 | | 中文支持 | 需额外字库处理 | 需自定义中文显示方案 | | 适用场景 | 基础显示需求、初学者项目 | 高性能应用、动画效果 | | GitHub地址 | [gh_mirrors/st](https://gitcode.com/gh_mirrors/st/st7789py_mpy) | [gh_mirrors/st7](https://gitcode.com/gh_mirrors/st7/st7789_mpy) | --- #### 二、基础使用方法（以st7789py_mpy为例） ##### 1. 硬件连接（ESP32示例） ```python # SPI引脚配置 from machine import Pin, SPI spi = SPI(1, baudrate=40000000, sck=Pin(18), mosi=Pin(19)) # 显示屏控制引脚 cs = Pin(5, Pin.OUT) dc = Pin(16, Pin.OUT) rst = Pin(23, Pin.OUT) ``` ##### 2. 库安装与初始化 ```python # 安装库 (通过mip) import mip mip.install("github:gh_mirrors/st/st7789py_mpy") # 初始化显示屏 import st7789 tft = st7789.ST7789( spi, 240, 135, # 屏幕尺寸(WxH) reset=rst, cs=cs, dc=dc, rotation=1 # 旋转方向(0-3) ) tft.init() ``` ##### 3. 基本显示操作 ```python # 填充背景色 tft.fill(st7789.BLUE) # 绘制矩形 tft.rect(10, 10, 100, 50, st7789.RED) # 显示文本 tft.text("Hello MicroPython!", 20, 70, st7789.WHITE) # 绘制单像素点 tft.pixel(120, 67, st7789.GREEN) ``` --- #### 三、进阶功能实现 ##### 1. 中文显示方案 ```python # 加载自定义字库 import framebuf with open('unifont-14.pf', 'rb') as f: font = framebuf.FrameBuffer(bytearray(f.read()), 16, 16, framebuf.MONO_HLSB) # 显示中文字符 def show_chinese(text, x, y, color): for char in text: char_bytes = char.encode('gb2312') tft.bitmap(font, x, y, 16, 16, color, char_bytes) x += 18 # 字符间距 ``` ##### 2. 图像显示 ```python # 转换图像为RGB565格式 from uctypes import struct, LITTLE_ENDIAN, UINT16 with open('logo.rgb', 'rb') as f: img_data = f.read() # 显示图像 tft.blit_buffer( struct(img_data, {"pixels": (0, UINT16 | len(img_data)//2)}).pixels, 0, 0, # 起始坐标 100, 100 # 图像尺寸 ) ``` ##### 3. 与LVGL集成（引用[5]） ```python import lvgl as lv from lv_utils import driver # 初始化LVGL显示驱动 disp_buf = lv.disp_draw_buf_create() disp_drv = lv.disp_drv_create() driver.disp_drv_register(disp_drv, disp_buf, tft) # 创建LVGL按钮 btn = lv.btn(lv.scr_act()) btn.set_size(100, 50) btn.align(lv.ALIGN.CENTER, 0, 0) label = lv.label(btn) label.set_text("LVGL按钮") ``` --- #### 四、性能优化技巧 1. **双缓冲技术**（仅限st7789_mpy） ```python # 启用帧缓冲 tft = st7789.ST7789(..., buffer_size=240*135*2) tft.jpg('bg.jpg', 0, 0) # 直接解码JPEG到帧缓冲 ``` 2. **局部刷新优化** ```python # 仅刷新变化区域 tft.set_window(x, y, width, height) tft.write_data(buffer) ``` 3. **SPI超频设置** ```python # 提升SPI时钟（ESP32最高80MHz） spi.init(baudrate=80000000) ``` --- #### 五、常见问题解决 1. **显示花屏** - 检查SPI接线是否松动 - 降低SPI频率测试：`spi.init(baudrate=20000000)` - 验证复位时序：`tft.reset()`后延迟`time.sleep_ms(100)` 2. **中文乱码** - 确保字库文件为GB2312编码 - 使用压缩字库工具：[microPython_Font_To_Py](https://github.com/peterhinch/micropython-font-to-py) 3. **内存不足** ```python # 使用分块渲染 for y in range(0, 135, 20): tft.blit_buffer(partial_buffer, 0, y, 240, 20) ``` > **实测性能**：在ESP32上，st7789_mpy可实现30fps的动画刷新率，比纯Python实现快5倍以上[^3]。 ---