【MicroPython ESP32】ST7735 TFT中文显示实战：从固件烧录到多行文本渲染

1. 准备工作硬件与固件选择玩转MicroPython和ESP32的硬件组合最让人头疼的往往不是代码本身而是前期准备工作。我刚开始接触ST7735屏幕时光是选对固件就折腾了好几天。这里分享几个关键点帮你少走弯路。首先说说硬件选择。ESP32开发板市面上五花八门但建议选择带有SPI接口的标准开发板比如ESP32-DevKitC。我实测过合宙的1.8寸TFT屏幕型号ST7735S性价比很高160x128的分辨率足够显示多行中文。屏幕引脚接线要特别注意SCK接GPIO18MOSI接GPIO23DC接GPIO21CS接GPIO16RST接GPIO22。背光引脚BL可以不接直接用3.3V供电就行。固件选择是中文显示的关键。普通MicroPython固件不支持中文必须使用带中文字库的定制版本。推荐使用开源的ssd1306-MicroPython-ESP32-Chinese项目提供的固件这个固件内置了GB2312字符集支持12x12和16x16两种点阵字体。烧录固件时要注意选择与开发板匹配的版本比如ESP32-WROOM-32D和ESP32-WROVER的固件就不同。2. ST7735驱动移植与配置拿到屏幕第一件事就是移植驱动程序。ST7735的驱动代码看起来复杂其实核心就是通过SPI发送控制命令和数据。我优化过的这个版本支持旋转显示和RGB565色彩模式比原厂代码更易用。驱动代码中最关键的是初始化序列。ST7735需要依次发送睡眠退出、颜色模式、内存访问控制等命令。这里有个坑不同厂商的ST7735初始化参数可能不同。比如合宙的屏幕需要发送INVON命令开启颜色反转而某些山寨屏则需要INVOFF。如果发现显示颜色异常可以尝试调整这个参数。旋转功能通过MADCTL寄存器控制。实测发现当rot参数为0时是竖屏模式1是90度横屏2是180度竖屏3是270度横屏。但要注意旋转后显示坐标会变化需要在show()方法中调整CASET和RASET的起始位置。我在代码里已经处理了这些细节你直接传rot参数就行。3. 中文字体加载与渲染中文显示的核心是字体文件处理。MicroPython本身不支持TrueType字体需要使用点阵字体。推荐使用GB2312-12.fon这种二进制字体文件它包含了GB2312标准的所有汉字约7000个每个字符12x12像素。字体加载使用font_load()方法注意文件路径要正确。我遇到过字体加载失败的问题后来发现是文件系统空间不足。ESP32的SPIFFS分区通常只有1MB左右建议先用os.listdir()检查文件是否存在再用os.stat()看文件大小是否正常。文本渲染最麻烦的是多行处理。原始驱动只支持单行显示我扩展了text()方法自动处理换行和截断。当文本超出屏幕宽度时会自动换到下一行。显示位置通过x,y参数指定颜色用RGB565格式。比如0xf800是红色0x07e0是绿色0x001f是蓝色。可以用rgb()方法将RGB值转换为565格式。4. 实战多行彩色中文显示现在我们来个完整示例。首先确保字体文件GB2312-12.fon已经上传到设备根目录。然后运行以下代码from st7735 import ST7735 from machine import Pin,SPI import time # 初始化SPI spi SPI(2, baudrate20000000, polarity0, phase0, sckPin(18), mosiPin(23)) # 初始化LCDrot2表示180度旋转 lcd ST7735(128, 160, spi, dcPin(21), csPin(16), rstPin(22), rot2, bgr0) # 加载字体 lcd.font_load(./GB2312-12.fon) # 显示多行彩色中文 lcd.text(MicroPython中文显示实战, 5, 5, 0xF800) # 红色 lcd.text(ESP32驱动ST7735屏幕, 5, 20, 0x07E0) # 绿色 lcd.text(支持多行文本自动换行, 5, 35, 0x001F) # 蓝色 lcd.text(字体大小12x12像素, 5, 50, 0xFFE0) # 黄色 lcd.text(作者嵌入式开发老鸟, 5, 65, 0xF81F) # 粉色 lcd.show() # 刷新显示这个例子展示了如何用不同颜色显示多行中文。注意y坐标要留出足够间距12像素的字体加上2像素行距每行间隔14像素比较合适。如果显示乱码很可能是字体文件不匹配建议重新下载GB2312编码的字体文件。5. 常见问题排查调试时最常遇到的问题是白屏。首先检查接线是否正确特别是RST引脚必须接。然后用逻辑分析仪或示波器看SPI是否有信号。如果SPI正常但还是白屏可能是初始化序列不对可以尝试调整SLPOUT后的延时我代码里是120ms。中文显示乱码通常是编码问题。MicroPython默认使用UTF-8而GB2312字体需要GBK编码。确保你的.py文件保存为UTF-8格式但文本内容要符合GB2312字符集。比如嵌入式这三个字在GB2312中都有但哔哩哔哩就可能显示为问号。内存不足也是个常见坑。ESP32的堆内存有限显示大尺寸图片时容易崩溃。建议将大资源存到文件系统使用时分段加载。另外频繁刷新屏幕会消耗大量内存可以用framebuf局部刷新优化性能。