1. 从点亮屏幕到显示中文:我的ESP32实战之旅
大家好,我是老王,一个喜欢捣鼓嵌入式开发的老玩家。最近在做一个智能家居的小项目,需要一块小屏幕来显示一些状态信息,比如温度、湿度,当然还有中文的天气提示。我手头正好有一块ESP32开发板和一块1.54寸的240x240彩色IPS屏幕,琢磨着用microPython来驱动它。一开始我以为就是调用个库、写几行代码的事儿,结果在显示中文上结结实实地踩了几个坑。今天我就把这些实战经验,特别是如何让这块小屏幕流畅、省内存地显示多语言(尤其是中文)的优化方案,毫无保留地分享给大家。不管你是刚入门microPython的新手,还是想给项目加个中文界面的朋友,相信这篇内容都能帮你少走弯路。
你可能听说过ESP32搭配microPython开发起来很快,但真到显示中文的时候,会发现官方库和常见的驱动大多只支持英文字符。直接显示中文要么乱码,要么就得自己动手丰衣足食。我参考了网上王铭东老师的一些基础教程,但发现要实现一个稳定、高效且支持多种字号的中文显示,还需要做不少“外科手术”式的改造。这不仅仅是加个字体文件那么简单,还涉及到内存管理、显示效率、甚至驱动底层的修改。下面,我就带你一步步拆解这个过程,从硬件连接到代码优化,手把手让你也能在自己的240x240屏幕上秀出漂亮的中文。
2. 硬件连接与驱动准备:避开第一个坑
工欲善其事,必先利其器。咱们先得把ESP32和屏幕正确地连起来,并把驱动环境搭好。这块240x240屏幕的驱动芯片通常是ST7789,它是一种很常见的SPI接口显示屏控制器。别看它分辨率不高,但色彩表现和响应速度对于物联网设备的状态显示来说,完全够用。
2.1 引脚连接:一张图搞定
连接其实很简单,主要是SPI通信的那几根线。我用的ESP32开发板是经典的ESP32-DevKitC,屏幕是通用的1.54寸IPS模块。根据我的实测,下面这个连接方式最稳定:
| ESP32引脚 | 240x240屏幕引脚 | 说明 |
|---|---|---|
| 3V3 | VCC | 电源,接3.3V,有些屏幕也支持5V,但ESP32输出是3.3V,最稳妥。 |
| GND | GND | 电源地,必须接。 |
| GPIO18 | SCL/SCK | SPI时钟线。 |
| GPIO23 | SDA/MOSI | SPI数据线,主设备输出,从设备输入。 |
| GPIO2 | DC | 数据/命令选择线,这个引脚状态决定了你发送的是数据还是命令,非常关键。 |
| GPIO5 | CS | 片选线,低电平有效,用来选择当前通信的SPI从设备。 |
| GPIO22 | BL | 背光控制,高电平点亮,你可以用PWM来控制亮度。 |
| GPIO17 | RES | 复位引脚,用于硬件复位屏幕。 |
这里有个小经验:DC和CS引脚一定要接对,很多驱动不工作的问题都出在这里。另外,背光引脚BL如果不接或者接错,屏幕可能一切正常但就是一片漆黑,让你误以为驱动没跑起来,白白折腾半天。
2.2 驱动下载与“坑”的修复
驱动方面,我直接用了GitHub上比较流行的 st7789py_mpy 这个microPython库。但是,如果你完全照搬原版驱动,有很大概率会遇到屏幕点不亮的情况。这不是你的问题,是驱动库和某些屏幕硬件之间有点小“脾气”。
我一开始也中招了,屏幕死活不亮。后来打开驱动源码 st7789py.py 仔细看,发现在初始化函数 __init__ 里,有两行复位代码可能会出问题。原版驱动会先执行硬件复位(hard_reset)和软件复位(soft_reset),但对于某些屏幕模组,这个复位时序可能不太对。
我的修改方法是这样的: 找到驱动文件中初始化屏幕的那部分代码(大概在200行附近),你会看到类似下面的内容:
self.hard_reset()
self.soft_reset()
我直接把这两行给注释掉了。然后,在这之后,手动初始化几个关键的控制引脚状态。我添加了这么三行:
self.cs.init(self.cs.OUT, value=1) # 片选先置高,不选中
self.dc.init(self.dc.OUT, value=0) # 数据/命令线先设为命令模式
self.reset.init(self.reset.OUT, value=1) # 复位引脚置高,解除复位状态
另外,背光控制那里也有个小改动。原代码可能是 backlight.value(1),但为了统一和保险,我改成了:
if backlight is not None:
# backlight.value(1)
self.backlight.init(self.backlight.OUT, value=1) # 初始化背光引脚为输出并点亮
这几处改动看似微小,但却是让屏幕正常亮起来的关键。修改后保存文件,重新上传到ESP32,屏幕应该就能正常初始化了。这一步解决了“有信号无显示”的玄学问题,算是闯过了第一关。
3. 核心挑战:为microPython引擎注入中文字符显示能力
屏幕能亮了,显示英文也没问题了,接下来才是重头戏:显示中文。microPython原生的帧缓冲(framebuf)模块和大多数显示驱动,默认只处理ASCII字符(英文字母、数字、符号)。中文的GB2312/GBK编码,一个字符占两个字节,而且字形复杂,需要额外的点阵字库来支持。
3.1 理解点阵字库:中文如何被“画”出来
中文显示的本质是图形绘制。每个汉字对应一个二维的点阵图,比如16x16的点阵,就有256个点,每个点用1个比特(bit)表示是亮(前景色)还是灭(背景色)。所以,一个16x16的汉字需要 16 * 16 / 8 = 32 个字节来存储它的图形信息。
我们需要提前准备好这些汉字的点阵数据,也就是字库。对于嵌入式设备,尤其是内存紧张的ESP32(尽管它比传统单片机宽裕多了),把整个GB2312的六七千个汉字全放进去是不现实的。通常的做法是按需取模,只把你项目里需要用到的汉字生成点阵数据。
我推荐一个非常顺手的在线工具:“在线点阵取模”工具。你只需要在网页上输入需要的汉字,选择字体(如宋体、黑体)和大小(16x16, 24x24等),它就能帮你生成对应的十六进制字节数组。这里有个关键设置:记得选择“反转位序”(或类似选项,如“字节内位反转”)。这是因为屏幕驱动的数据格式可能和我们直觉的位顺序相反,设置不对,显示出来的字就是乱的。
3.2 改造驱动:添加多字号中文绘制方法
原版的 st7789py 驱动只有一个通用的 text() 方法,它识别不了我们自定义的中文字体结构。所以,我们必须为它“嫁接”新的能力。我的做法是在 ST7789 类里增加几个专门的方法,比如 _text_gb16(), text_gb24(), text_gb32(), text_gb48(),分别用于绘制16x16、24x24、32x32、48x48大小的中文。
以 _text_gb16 为例,我来讲讲原理:
- 逐字绘制:方法接收一个字符串,比如“天气”,然后循环处理每个字符。
- 边界检查:在画之前,先算一下这个字画在当前位置会不会超出屏幕边界,避免出错。
- 分块渲染:一个16x16的点阵,可以看成上下两行,每行8个像素高。所以循环
line in range(2),每次处理8行像素。 - 数据解析与缓冲:这是核心。从字库字典里取出当前字符的32字节数组。对于每一行的16个字节(即16列),我们要把每个字节的8个比特拆开,检查每一位是1还是0。如果是1,就用前景色(比如白色)的565颜色值打包成一个2字节的
short;如果是0,就用背景色。把这些颜色值依次存入一个缓冲区(buffer)。 - 发送显示:最后,调用驱动底层的
blit_buffer方法,把这一行8像素高、16像素宽的缓冲区数据一次性发送到屏幕的指定位置。
代码看起来有点复杂,但逻辑很清晰。24x24、32x32的原理类似,只是行数变成了3行或4行。我把这些方法都集成到了驱动类里,然后修改了原有的 text() 方法,让它能根据传入的字体模块的标志(比如我设置了一个 font.flag == 'gb16')自动选择用原来的英文绘制方法还是新的中文绘制方法。
这样做的好处是,向上兼容。你原来的显示英文的代码完全不用改,只需要在需要显示中文时,传入中文字体模块和对应的字号标识即可。
3.3 字体文件的组织:平衡内存与便利性
字库数据怎么存放?最直接的办法是放在Python字典里,就像原始文章里那样。但这有个大问题:太占内存。Python字典虽然用起来方便,但它的哈希表结构有额外的内存开销。当你需要显示几十上百个汉字时,内存消耗会急剧上升,很可能导致ESP32报内存不足的错误。
我的优化方案是 “分级存储”:
- 高频字内存化:对于界面中始终要显示的、高频使用的汉字(比如“温度”、“湿度”、“设置”),依然用字典存在内存里,保证最快的读取速度。
- 大量字库文件化:对于可能用到的所有汉字(比如城市名、天气现象),将它们的点阵数据以二进制格式写入到ESP32的Flash文件系统中。需要显示某个字时,再去文件里读取对应的数据块。Flash的读取速度虽然比内存慢,但对于更新频率不高的文本来说完全可接受。这能极大地节省宝贵的RAM。
具体操作上,你可以写一个简单的字体管理类。这个类在初始化时,把内存字典里的高频字加载好。同时提供一个 get_font_data(char) 方法,如果字符在内存字典里,直接返回;如果不在,则根据字符的编码计算出它在外部字体文件中的偏移位置,然后读取对应长度的字节数据返回。这样,你就拥有了一个“无限”扩展的字体系统,而内存占用始终可控。
4. 内存管理与显示性能的深度优化技巧
让中文显示出来只是第一步,让它显示得流畅、稳定,不拖垮整个系统,才是真正的挑战。ESP32的RAM资源有限,而图形操作和字体数据都是“内存大户”。
4.1 帧缓冲与局部刷新:告别卡顿
如果你每次更新显示都清空整个屏幕再重画所有内容(全屏刷新),那会非常慢,而且有强烈的闪烁感。对于时钟、传感器数值这种只有局部变化的界面,局部刷新是必须掌握的技巧。
局部刷新的核心思想是:只更新屏幕上发生变化的那一小块区域。 以我之前做的数字时钟为例,只有秒位数字变化最频繁。我就在内存里记录上一次显示的时、分、秒。在每次刷新时,我只比较当前时间和上次记录:
- 如果小时数变了,我只重画小时数字所在的那一小块矩形区域。
- 如果分钟数变了,只重画分钟区域。
- 秒数同理。
如何实现?st7789py 驱动提供的 blit_buffer 方法本身就支持指定起始坐标和宽高。我们只需要在绘制数字或文字时,精确地控制它写入的缓冲区大小和位置,然后只调用 blit_buffer 更新那个特定区域即可。同时,在重画新数字前,可以先用背景色填充那个小区域,相当于“擦除”旧内容。
这带来的性能提升是巨大的。从全屏240240=57600个像素的刷新,降低到可能只刷新3248=1536个像素的区域,速度相差几十倍,视觉上也完全没有闪烁。
4.2 颜色深度与缓冲区大小的权衡
我们的屏幕是RGB565的彩色屏,每个像素点用16位(2字节)表示颜色。这意味着,哪怕只是缓存一个16x16汉字的一行(16像素宽,8像素高),需要的缓冲区大小就是 16 * 8 * 2 = 256 字节。如果缓存整个16x16的汉字,就是512字节。这还不算其他图形数据。
所以,缓冲区能小则小。在我的中文绘制函数里,你看我都是按“行”来生成和发送缓冲区的。我并没有为整个汉字创建一个完整的缓冲区,而是循环内逐行生成、逐行发送。这样,任何时候内存中只需要维持一行像素的缓冲区,极大降低了峰值内存占用。
另外,对于静态不变的UI元素(比如标签、边框),可以考虑在初始化时一次性画好,之后就不再刷新它们。只把需要变化的区域(文本、数值、进度条)设置为可刷新区。这种动静分离的设计,能进一步减轻刷新时的计算和内存负担。
4.3 字体数据的压缩与按需加载
前面提到把大量字库存到文件里。这里还可以进一步优化:压缩字体数据。点阵数据本身有一定的规律,可以考虑使用简单的游程编码(RLE)进行压缩,在读取到内存后再解压。对于ESP32来说,解压算法的开销可能比从Flash读取大量数据的开销要小,总体上是划算的。
更高级的做法是,实现一个字体缓存机制。最近显示过的几个汉字,其点阵数据可以暂时保留在一个小的LRU(最近最少使用)缓存字典里。当需要显示一个字时,先查缓存,没有再读文件。这对于有重复文字的界面(比如循环显示几条信息)效果非常好,能显著减少文件IO操作。
5. 实战:构建一个多语言信息显示终端
理论说了这么多,我们最后来整合一下,打造一个实实在在的小项目:一个能显示中文、英文,并且能动态更新信息的桌面小终端。假设它要显示时间、日期、室内温湿度以及一句简单的天气提示。
5.1 项目结构与代码组织
一个好的项目结构能让代码更易维护。我的建议是这样的:
/project_root
├── main.py # 主程序入口
├── drivers/
│ └── st7789py.py # 修改后的屏幕驱动
├── fonts/
│ ├── en_vga_16x32.py # 英文字体
│ ├── gb_16x16.py # 16点阵中文常用字库(内存字典)
│ ├── gb_24x24.py # 24点阵中文常用字库
│ └── font_loader.py # 字体加载与管理器(负责文件字库)
├── utils/
│ └── weather.py # 模拟获取天气数据的模块
└── data/
└── gb2312_16x16.bin # 完整的16点阵GB2312字库文件(二进制)
main.py 是核心,它负责协调所有模块。font_loader.py 是我们前面说的字体管理类,它内部维护一个小内存字典,并知道如何从 data/gb2312_16x16.bin 里读取任意汉字。
5.2 主程序逻辑与优化细节
主程序的大致逻辑如下,我加了很多注释来说明优化点:
import time
from machine import Pin, SPI
from drivers import st7789py as st
from fonts import en_vga_16x32 as font_en
from fonts import gb_16x16 as font_gb_small
from fonts import font_loader
from utils import weather
# 初始化字体加载器,预加载“时间温度湿度天气”等高频字
font_loader = font_loader.FontLoader('data/gb2312_16x16.bin', preload_chars='时间温度湿度天气晴雨雪')
class SmartDisplay:
def __init__(self):
# 1. 硬件初始化
spi = SPI(2, baudrate=40000000, polarity=1, phase=1) # 提高SPI速率到40MHz,加快刷新
self.tft = st.ST7789(spi, 240, 240,
reset=Pin(17), dc=Pin(2),
cs=Pin(5), backlight=Pin(22),
rotation=0) # rotation控制旋转方向
self.tft.init()
# 2. 定义颜色(RGB565格式)
self.COLORS = {
'white': st.color565(255, 255, 255),
'black': st.color565(0, 0, 0),
'red': st.color565(255, 0, 0),
'green': st.color565(0, 255, 0),
'blue': st.color565(0, 0, 255),
'yellow': st.color565(255, 255, 0)
}
# 3. 状态变量,用于局部刷新
self.last_time = (0, 0, 0) # (时,分,秒)
self.last_temp = None
self.last_humi = None
self.last_weather = ''
# 4. 绘制静态界面(只画一次)
self._draw_static_ui()
def _draw_static_ui(self):
'''绘制静态界面:标题、标签等不变的元素'''
self.tft.fill(self.COLORS['black']) # 清屏
# 用大号中文显示标题
self.tft.text_gb24(font_gb_small, 24, '环境监测终端', 30, 10, self.COLORS['yellow'])
# 用英文小字体画标签
self.tft.text(font_en, 16, 'Time:', 20, 60, self.COLORS['white'])
self.tft.text(font_en, 16, 'Temp:', 20, 100, self.COLORS['white'])
self.tft.text(font_en, 16, 'Humi:', 20, 140, self.COLORS['white'])
self.tft.text(font_en, 16, 'Weather:', 20, 180, self.COLORS['white'])
# 画一些装饰性线条
self.tft.hline(10, 50, 220, self.COLORS['blue'])
self.tft.hline(10, 190, 220, self.COLORS['blue'])
def _update_time(self, hour, minute, second):
'''局部更新时间,只有数字变化时才重绘'''
# 小时
if hour != self.last_time[0]:
# 先清除旧区域(用背景色填充一个矩形)
self.tft.fill_rect(80, 60, 40, 32, self.COLORS['black'])
# 绘制新时间,使用字体加载器获取点阵数据
hour_str = '{:02d}'.format(hour)
for i, char in enumerate(hour_str):
# 这里假设是数字,直接使用英文字体。如果是中文,调用text_gb方法。
self.tft.text(font_en, 32, char, 80+i*20, 60, self.COLORS['green'])
# 分钟和秒的更新逻辑类似,此处省略...
self.last_time = (hour, minute, second)
def _update_weather(self, weather_text):
'''更新天气信息,中英文混合'''
if weather_text != self.last_weather:
# 清除旧信息区域
self.tft.fill_rect(100, 180, 130, 24, self.COLORS['black'])
x_pos = 100
# 假设weather_text是像 "晴,26°C" 这样的字符串
# 我们需要解析并分别绘制中文和英文部分
# 这里简化处理,调用一个能处理混合字符串的函数
self._draw_mixed_text(weather_text, x_pos, 180)
self.last_weather = weather_text
def _draw_mixed_text(self, text, x, y):
'''绘制中英文混合字符串的辅助函数'''
# 这是一个简化的示例,实际需要更复杂的字符识别和切换字体的逻辑
# 基本思路:遍历字符串,判断每个字符是ASCII还是中文字符(字节大于127)
# 然后分别调用tft.text(英文字体)或tft.text_gb(中文字体)
pass
def refresh_all_data(self):
'''刷新所有动态数据'''
# 获取实时数据(这里用模拟数据)
now = time.localtime()
temp, humi = 25.6, 65.2 # 模拟传感器读数
weather_str = "晴" # 模拟天气
# 局部更新各个区域
self._update_time(now[3], now[4], now[5])
self._update_sensor(temp, humi) # 需要实现的方法
self._update_weather(weather_str)
def run(self):
'''主循环'''
print("Display started.")
try:
while True:
self.refresh_all_data()
time.sleep(1) # 每秒刷新一次
except KeyboardInterrupt:
print("Display stopped.")
self.tft.fill(self.COLORS['black']) # 退出时清屏
# 启动显示
if __name__ == '__main__':
display = SmartDisplay()
display.run()
在这个例子里,你可以看到我如何将局部刷新、字体管理、动静分离的思想融合在一起。_draw_static_ui 只在开始时调用一次,绘制所有不变的框架。主循环里每秒调用 refresh_all_data,它内部再根据数据变化情况,决定是否更新以及更新屏幕的哪一小块。对于天气信息这种可能包含中文的字符串,我设计了一个 _draw_mixed_text 的函数框架,你需要根据字体加载器的能力去实现它,让它能自动切换字体来绘制混合字符串。
5.3 调试与常见问题排查
做这类项目,调试是免不了的。分享几个我踩过的坑和解决思路:
- 屏幕花屏或错位:首先检查SPI的速率(
baudrate)、极性(polarity)和相位(phase)。不同屏幕模组可能要求不同,常见的是polarity=1, phase=1。如果不行,尝试降低SPI速率。 - 中文显示为乱码或倒置:99%的问题出在取模设置上。务必确认在线取模工具设置的“扫描方式”、“取模走向”与你的驱动代码中的像素读取顺序匹配。我的代码是基于“列行式、高位在前”的取模数据写的。如果你的字显示出来是反的或者乱的,调整取模工具的“位序反转”等选项,或者调整代码中解析字节位的顺序。
- 内存分配失败:如果程序运行一会儿就报
MemoryError,首先用import gc; gc.mem_free()打印剩余内存,监控内存变化。重点检查是否在循环中不断创建新的缓冲区或大对象。确保字体数据是按需加载,并且大缓冲区能及时释放。 - 刷新速度慢:除了用局部刷新,还可以尝试提高SPI时钟频率(但不要超过屏幕和数据手册的限制)。另外,减少单次
blit_buffer调用的数据量,分多次发送小数据块,有时比发送一个大块更高效,因为给了ESP32的垃圾回收器喘息的机会。
折腾这块小屏幕的过程,就像是在有限的画布上做微雕。资源紧张,但乐趣也正在于此。当你看到清晰的中文和流畅的动画出现在这块小小的240x240屏幕上时,那种成就感是巨大的。希望我的这些经验和代码片段,能成为你项目的垫脚石。
371



被折叠的 条评论
为什么被折叠?



