## 1. 硬件连接：从零开始的ESP32与TFT屏“牵手” 如果你手头正好有一块ESP32开发板和一块小巧的TFT彩屏，比如ST7735或者ST7789驱动的，想把它们连起来让屏幕亮起来、显示点东西，那第一步就是搞定硬件连接。别担心，这个过程其实就像搭积木，只要线接对了，后面的事情就顺理成章。我刚开始玩的时候也犯过迷糊，把数据线接反了，结果屏幕要么一片白，要么花屏，折腾了好久。所以，咱们先把这第一步走扎实了。 ESP32和这类SPI接口的TFT屏，连接的核心就是几根关键线：电源、地线、时钟线、数据线，还有几根控制线。听起来好像很多，但其实它们各司其职，理解了就很简单。**电源（VCC和GND）** 是给屏幕供电的，必须接对，否则屏幕根本不工作。**SCL（时钟线）** 和 **SDA（数据线）** 是SPI通信的“指挥棒”和“传声筒”，数据一位一位地跟着时钟节奏传输。**RST（复位）** 引脚就像屏幕的重启按钮，有时候初始化不正常，拉低一下这个引脚就能让屏幕恢复初始状态。**DC（数据/命令选择）** 引脚非常关键，它告诉屏幕芯片，接下来发送的是一个控制命令，还是一屏要显示的图像数据。**CS（片选）** 引脚在连接多个SPI设备时会用到，用来选择当前要和哪个设备“说话”，如果只接一块屏，通常可以直接接地（始终选中）。最后，**BL（背光）** 引脚控制屏幕背光的亮灭，不接的话屏幕可能一片漆黑（但仔细看能有显示），接了就能控制亮度了。 那么，具体怎么接到ESP32上呢？ESP32有很多GPIO引脚，我们得选一组支持硬件SPI的引脚，这样驱动效率最高。通常，我们会使用ESP32的 **SPI2（HSPI）** 接口，它对应的默认引脚是： - **SCLK (时钟)**： GPIO 14 - **MOSI (主设备输出，从设备输入)**： GPIO 13 - **MISO (主设备输入，从设备输出)**： GPIO 12（对于纯输出的显示屏，这根线可以不接） 但是，这些默认引脚可能被板载其他部件（比如PSRAM、SD卡）占用了，尤其是在ESP32-S3这类高性能型号上。所以，更常见的做法是**灵活配置**，使用其他空闲的、也支持硬件SPI功能的引脚。根据我自己的项目经验，下面这个接法非常稳定，也避开了常用功能引脚： | TFT显示屏引脚 | ESP32 GPIO引脚 | 说明 | | :--- | :--- | :--- | | VCC | 3.3V | 接3.3V电源，**切勿接5V**，会烧屏！ | | GND | GND | 共地，必不可少 | | SCL (SCK) | IO4 | 时钟信号线 | | SDA (MOSI) | IO5 | 数据输出线（ESP32 -> 屏幕） | | RES (RST) | IO6 | 复位引脚，低电平有效 | | DC (A0) | IO7 | 数据/命令选择引脚 | | CS | IO15 | 片选引脚，低电平选中 | | BL | IO18 | 背光控制，可接PWM引脚实现调光 | 你可能会问，为什么选这些引脚？首先，IO4、IO5、IO18、IO19等引脚在ESP32上功能比较“干净”，不像一些引脚（如IO6、IO7、IO8-11）在启动时有特殊电平要求，用起来更省心。其次，这样连接对于ST7735和ST7789是完全通用的，你不需要因为换屏幕而重新飞线，只需要在代码里切换一下驱动类就行，这是我踩过坑后总结出的“懒人”接法。 接线时，强烈建议使用杜邦线和面包板先进行测试。确认所有连接牢固，没有虚接。特别是电源和地线，接触不良是很多诡异问题的根源。接好后，先别急着写代码，用万用表量一下屏幕VCC引脚是不是稳稳的3.3V，这能排除一半的硬件问题。 ### 1.1 电源与接地的注意事项 给TFT屏供电这件事，看似简单，实则藏着几个新手容易踩的坑。第一个大坑就是**电压**。绝大多数ST7735/ST7789屏幕的工作电压是**3.3V**，而我们的ESP32开发板通常也提供3.3V的输出。但是，有些屏幕模块为了兼容性，会自带一个3.3V稳压芯片，这时模块的VCC引脚可能标注着“5V”。你一定要仔细看屏幕模块的说明书或丝印。如果模块明确写了“VCC: 3.3V/5V”，那说明它内部有稳压，接5V也可以。但如果只写了3.3V，或者你不确定，**一律接3.3V最安全**。我亲眼见过一块屏因为误接5V，芯片瞬间发烫然后“归西”的惨剧。 第二个坑是**电流**。ESP32开发板上的3.3V引脚输出电流能力有限，通常在500mA左右。而TFT屏幕，尤其是点亮背光时，功耗不小。一块240x240的ST7789全白高亮显示时，电流可能达到100-200mA。如果你还连接了其他传感器，就可能造成3.3V电源被拉低，导致ESP32重启或者屏幕显示异常。我的建议是：对于简单的实验，直接使用开发板的3.3V可以；但如果你的项目是长期运行，或者屏幕较大，最好**为屏幕单独供电**。比如，使用一个外部的3.3V稳压模块，或者从电源输入端（如USB的5V）经过一个高效的降压模块得到3.3V专供屏幕。 **接地（GND）** 的重要性不亚于电源。所有设备的GND必须连接在一起，形成一个共同的参考零电位。如果ESP32和屏幕的GND没有接好，或者通过很长的导线连接引入了电阻，就会导致两地之间存在电压差，SPI通信的电平识别会出错，数据传输出错，表现就是屏幕显示乱码或者根本无反应。所以，确保GND连接线短而粗，接触良好。在面包板上，我习惯用一根独立的跳线专门连接ESP32的GND和面包板的负电源轨，然后把所有设备的GND都接到这个电源轨上，这样最可靠。 最后，关于**背光（BL）** 引脚。很多屏幕的背光是LED串联一个限流电阻。直接接3.3V，背光会以最大亮度常亮。如果你想控制亮度，甚至息屏省电，就需要将BL引脚接到一个GPIO上。这个GPIO最好支持PWM（脉冲宽度调制）输出，这样你就可以通过代码调节背光亮度了。比如接在ESP32的IO18上（很多GPIO都支持PWM），在代码里初始化一个PWM通道，就能实现从0到100%的无级调光，晚上使用不刺眼，非常实用。 ## 2. 驱动代码移植与修改：让ST7789“跑起来” 硬件连好了，就像舞台搭好了，接下来需要演员（代码）登场。网上能找到很多MicroPython的ST7735驱动，但ST7789的完整驱动，特别是适配ESP32-S3这种新芯片的，往往不那么“开箱即用”。最稳妥高效的办法，就是在成熟的ST7735驱动基础上进行修改。这就像你已经有一辆能跑的汽车（ST7735驱动），现在想换一个更大的发动机（ST7789），车架（SPI通信框架）和控制系统（上层API）大部分可以沿用，只需要调整发动机的安装接口和参数（初始化序列和分辨率设置）。 为什么选择修改而不是重写？因为ST7735和ST7789同属ST公司的产品，它们的底层SPI通信协议、基本命令集（如设置行列地址、写入显存）是非常相似的。主要的区别在于**初始化序列（Init Sequence）** 和**屏幕物理分辨率**。我们只需要针对这两点进行“外科手术式”的修改，就能得到一个稳定的ST7789驱动，这比从头研究数据手册、调试每个命令要快得多，也稳得多。 首先，你需要一个基础的ST7735驱动类。这个类通常会包含以下核心方法：`__init__`（初始化SPI和引脚）、`_write`（向屏幕发送命令或数据）、`_reset`（硬件复位）、`_init`（发送初始化命令序列）、`fill`（填充颜色）、`pixel`（画点）、`text`（显示文字，可能依赖其他库）以及`show`（将内存帧缓冲区刷新到屏幕）。我们的修改将主要集中在`_init`和`show`方法，以及类初始化时对分辨率的处理。 ### 2.1 初始化序列的“密码本” 初始化序列是驱动芯片上电后，主控（ESP32）发送给屏幕驱动芯片（ST7789）的一系列配置命令。这些命令告诉芯片如何工作：比如色彩深度是16位还是18位，扫描方向是横屏还是竖屏，伽马校正曲线用什么，内部电压如何调节等等。这些命令和参数组合，就是点亮和正确控制屏幕的“密码本”。 ST7735和ST7789的密码本大部分不同。下面是我从实际项目中提取并验证过的两个初始化序列核心部分，你可以清晰地看到差异： ```python # ST7735 的初始化命令序列 (示例片段) _init_commands_st7735 = [ (0x01, None), # 软件复位 (0x11, None), # 退出睡眠模式 (0xB1, b'\x01\x2C\x2D'), # 帧率控制（正常模式） (0xB2, b'\x01\x2C\x2D'), # 帧率控制（空闲模式） (0xB3, b'\x01\x2C\x2D\x01\x2C\x2D'), # 帧率控制（局部模式） (0x36, b'\xC8'), # 内存访问控制（MADCTL），设置扫描方向等 (0x3A, b'\x05'), # 色彩格式，0x05代表16位RGB565 (0x29, None), # 开启显示 ] # ST7789 的初始化命令序列 (示例片段) _init_commands_st7789 = [ (0x01, None), # 软件复位 (0x11, None), # 退出睡眠模式 (0x36, b'\xC0'), # 内存访问控制（MADCTL），注意参数不同！ (0x3A, b'\x55'), # 色彩格式，0x55代表16位RGB565（ST7789特有格式） (0xB2, b'\x0C\x0C\x00\x33\x33'), # porch控制 (0x21, None), # 开启反色显示（有时需要，取决于屏幕模块） (0x2A, b'\x00\x00\x00\xEF'), # 设置列地址（X方向），0-239 (0x2B, b'\x00\x00\x00\xEF'), # 设置行地址（Y方向），0-239 (0x29, None), # 开启显示 ] ``` 关键修改点解析： 1. **命令0x36 (MADCTL)**：这个命令控制显示方向、颜色顺序等。`b'\xC8'`和`b'\xC0'`的差异决定了屏幕的默认旋转和BGR/RGB顺序。如果你发现屏幕颜色不对（红蓝互换），或者显示方向不对，首先就要调整这个参数。ST7789常用的`0xC0`表示行地址顺序更新、列地址顺序更新、RGB顺序。 2. **命令0x3A (COLMOD)**：设置颜色深度。ST7735常用`0x05`表示16位RGB565。而ST7789的数据手册指出，对于16位接口，应使用`0x55`或`0x65`等。`0x55`是RGB565格式，这是我们需要用的。 3. **新增的行列地址设置 (0x2A, 0x2B)**：在ST7789初始化中，我们显式地设置了屏幕的显示区域为0到239。这对于某些屏幕模块是必需的，能确保驱动芯片知道有效的显示范围。 4. **其他优化命令**：如`0xB2`（Porch设置）、`0x21`（反色显示）等，这些参数来源于屏幕模块厂商的推荐配置或社区调试成果，能优化显示效果和稳定性。 在你的驱动类中，你需要将原来的`_init`方法里的命令序列替换为ST7789的序列。同时，确保`_write`方法能正确地将这些命令和数据通过SPI发送出去。一个常见的`_write`函数实现如下： ```python def _write(self, command, data=None): self.dc(0) # 拉低DC，表示接下来发送的是命令 self.cs(0) # 拉低CS，选中屏幕 self.spi.write(bytearray([command])) # 发送命令字节 self.cs(1) # 取消选中 if data is not None: # 如果有数据要发送 self.dc(1) # 拉高DC，表示接下来发送的是数据 self.cs(0) # 再次选中屏幕 self.spi.write(data) # 发送数据字节 self.cs(1) ``` ### 2.2 分辨率适配与显示函数调整 ST7735常见分辨率是128x160，而ST7789常见的是240x240或240x320。分辨率变了，驱动里相关的地方都要跟着改。 首先，在创建显示对象时，需要传入正确的宽度和高度。我们可以通过一个配置变量来灵活选择： ```python # 配置选择 DISPLAY_TYPE = 'ST7789' # 可选 'ST7735' 或 'ST7789' # SPI初始化（引脚根据你的接线调整） spi = SPI(2, baudrate=40000000, polarity=0, phase=0, sck=Pin(4), mosi=Pin(5), miso=None) # 提高波特率至40M，ST7789能承受 # 引脚定义 dc = Pin(7, Pin.OUT) cs = Pin(15, Pin.OUT) rst = Pin(6, Pin.OUT) bl = Pin(18, Pin.OUT) # 根据类型初始化不同的显示屏对象 if DISPLAY_TYPE == 'ST7735': from st7735 import ST7735 tft = ST7735(128, 160, spi, dc, cs, rst, bl, rotate=0) elif DISPLAY_TYPE == 'ST7789': from st7789 import ST7789 # 这是我们修改后保存的驱动文件 tft = ST7789(240, 240, spi, dc, cs, rst, bl, rotate=1) # 注意分辨率和旋转参数 ``` 其次，在驱动类内部的`show`方法中，需要更新设置行列地址的命令参数。这个命令告诉驱动芯片，接下来要写入的显存数据对应屏幕上的哪个矩形区域。对于全屏刷新，这个区域就是整个屏幕。 ```python # 在ST7735驱动类中 def show(self): self._write(0x2A, b'\x00\x00\x00\x7F') # 列地址: 0 到 127 (0x7F) self._write(0x2B, b'\x00\x00\x00\x9F') # 行地址: 0 到 159 (0x9F) self._write(0x2C, self.buffer) # 开始写入帧缓冲数据 # 在ST7789驱动类中 def show(self): self._write(0x2A, b'\x00\x00\x00\xEF') # 列地址: 0 到 239 (0xEF) self._write(0x2B, b'\x00\x00\x00\xEF') # 行地址: 0 到 239 (0xEF) self._write(0x2C, self.buffer) # 开始写入帧缓冲数据 ``` 这里`b'\x00\x00\x00\xEF'`是四个字节，前两个字节是起始地址（0x0000），后两个字节是结束地址（0x00EF，即十进制的239）。如果你用的是240x320的屏幕，那么行地址结束值应该是`0x013F`（十进制的319），需要发送`b'\x00\x00\x01\x3F'`。 完成这些修改后，将新的驱动类保存为`st7789.py`文件，上传到ESP32。写一个简单的测试脚本，填充屏幕颜色或者画个方块，如果屏幕能正确显示，那么恭喜你，驱动移植就成功了！ ## 3. 中文字库的集成与优化：告别“豆腐块” 屏幕驱动起来了，能显示图形和英文字符了，但一到显示中文，就变成了一个个“口口口”的豆腐块。这是因为MicroPython默认的字体库只包含基本的ASCII字符，没有中文字形。要在TFT屏上流畅显示中文，我们需要集成一个自定义的中文字库，并优化显示逻辑。 ### 3.1 字库格式的选择与制作 首先面临的问题是字库格式。常见的有点阵字库和矢量字库。在嵌入式设备上，我们主要使用**点阵字库**，因为它渲染简单，速度快，不占用太多CPU资源。点阵字库的本质就是一个巨大的“字典”，里面存储了每个汉字对应的黑白像素点阵图。 制作或获取点阵字库有几种方法： 1. **使用现成的工具生成**：这是最推荐的方法。PCtoLCD、FontMaker等软件可以让你选择字体（如宋体、黑体）、字号（如16x16, 24x24, 32x32），然后生成包含你指定汉字范围的二进制字库文件。你可以选择生成整个GB2312字符集（约6000多个汉字）的字库，但文件会很大（比如16点阵字库约260KB）。更聪明的做法是**只提取项目用到的汉字**，这能极大节省宝贵的ESP32闪存空间。 2. **从开源项目获取**：很多开源嵌入式GUI项目（如LVGL、U8g2）都附带精简的中文字库，你可以尝试提取使用。 3. **手动编码（不推荐）**：对于极少量汉字，可以手动计算点阵并写成数组，但效率极低。 我通常使用PCtoLCD软件。操作步骤是：选择字体和字号 -> 设置取模方式（非常重要！必须与你的读取代码匹配，通常是“纵向取模，字节倒序”）-> 输入或导入需要生成的汉字文本 -> 生成字库文件。生成的文件是一个二进制文件，我们需要一个配套的、能读取这个文件格式的MicroPython类。 这个读取类（比如叫`BMFont`）需要做几件事：打开字库文件、解析文件头（确认格式和版本）、根据汉字的编码（如GB2312码）快速定位到该汉字点阵数据在文件中的位置、读取点阵数据并返回。一个健壮的字库类还会处理不同字号、自动换行、字符间距等高级功能。 ### 3.2 字库类的集成与显示优化 有了字库文件和读取类，接下来就是把它和我们的TFT驱动结合起来。核心思路是：扩展我们之前写的`text`显示函数，使其在遇到中文字符时，不去调用MicroPython内置的字体，而是去查询我们的自定义字库类。 这里有一个关键优化点：**分辨率感知的自动换行**。在ST7735（128宽）上能显示7个24x24的汉字，但在ST7789（240宽）上就能显示10个。如果显示代码写死了换行逻辑，切换屏幕后排版就会乱。因此，我们需要在字库类或显示函数中，加入屏幕分辨率参数，实现智能换行。 ```python class BMFont: def __init__(self, font_file, screen_width=240, screen_height=240): self.font_file = font_file self.screen_width = screen_width self.screen_height = screen_height # ... 其他初始化代码，如打开文件，读取文件头信息 ... def draw_text(self, display, string, x, y, color, font_size=24, auto_wrap=True): """在指定display上绘制文字""" start_x = x for char in string: # 1. 自动换行判断 char_width = font_size if ord(char) > 0xff else font_size // 2 # 中文全宽，英文半宽（假设） if auto_wrap and (x + char_width > self.screen_width): y += font_size # 换到下一行 x = start_x # 行首对齐 # 2. 获取字符点阵数据 if ord(char) > 0xff: # 假设大于255的是中文 bitmap_data = self.get_gb2312_bitmap(char, font_size) else: bitmap_data = self.get_ascii_bitmap(char, font_size) # 或者使用系统字体 # 3. 在display的指定位置(x, y)绘制这个点阵 # 这里需要将二进制的点阵数据，转换成对应颜色的像素数据，并调用display的blit方法 # 例如，对于单色点阵和RGB565颜色： color_data = self._mono_to_color(bitmap_data, color, font_size) display.blit(framebuf.FrameBuffer(color_data, font_size, font_size, framebuf.RGB565), x, y) # 4. 更新下一个字符的x坐标 x += char_width ``` 在上面的伪代码中，`screen_width`和`screen_height`在初始化字库对象时传入，这样`draw_text`方法就知道当前屏幕的边界在哪里，从而做出正确的换行判断。`get_gb2312_bitmap`方法会根据汉字的GB2312编码，从字库文件中读取对应的点阵数据。 另一个重要优化是**颜色渲染**。点阵字库通常是单色（1位）的，我们需要将其渲染成指定的颜色（如红色、蓝色）。这可以通过一个转换函数实现：遍历点阵的每一个比特，如果是1（表示要显示的点），就填入目标颜色的RGB565值；如果是0（背景），就填入背景色（通常是黑色或透明色）。这个过程在ESP32上用Python实现可能有点慢，但对于显示静态文本或更新不频繁的界面来说完全够用。如果追求极致速度，可以考虑预先将常用颜色的字符渲染成图片缓存起来。 最后，记得将字库文件（比如`font_24.bin`）和`bmfont.py`字库类文件一起上传到ESP32的文件系统中。在主程序中导入并使用它： ```python import bmfont # 初始化字库对象，传入屏幕分辨率 font = bmfont.BMFont('font_24.bin', screen_width=240, screen_height=240) # 在tft对象上显示中文 font.draw_text(tft, "你好，ST7789！", 10, 50, color=0xF800) # 红色文字 tft.show() ``` 当屏幕上清晰显示出你设定的中文时，那种成就感是无与伦比的。这标志着你的ESP32显示系统从“能看”进化到了“好用”。 ## 4. 实战技巧与性能调优 驱动和中文显示都搞定后，项目算是成功了一大半。但要想做得更专业、体验更好，还需要一些实战技巧和性能调优。这些是我在多个项目中摸爬滚打总结出来的经验，能帮你避开不少坑。 **SPI通信速度优化**：显示流畅度的关键。在初始化SPI时，`baudrate`（波特率）参数直接影响数据刷新速度。ST7789芯片的SPI时钟最高可达62.5MHz，但ESP32的MicroPython SPI驱动实际能稳定工作的速度会低一些。我测试过，在ESP32-S3上，设置`baudrate=40000000`（40MHz）通常非常稳定。如果设置过高，可能会导致数据错乱，屏幕出现雪花点或条纹。你可以从20MHz开始尝试，逐步提高，直到显示异常，然后退回一个稳定的值。另外，确保`polarity`和`phase`参数与屏幕驱动芯片要求的一致，对于ST系列屏，通常都是`polarity=0, phase=0`。 **双缓冲与局部刷新**：如果你需要做动画或者频繁更新部分界面，频繁的全屏刷新（`tft.show()`）会带来明显的闪烁感。一个高级技巧是使用**双缓冲**：创建两个帧缓冲区（`framebuf`），一个用于后台绘制下一帧画面，另一个是当前显示的画面。绘制完成后，交换缓冲区，然后只更新屏幕上发生变化的部分区域（通过设置`0x2A`和`0x2B`命令定义更新区域），最后发送局部数据。这能极大减少数据量和刷新时间，实现流畅动画。MicroPython的`framebuf`本身不支持硬件双缓冲，但你可以创建两个`bytearray`作为缓冲区，手动管理。 **内存管理**：高分辨率屏（如240x240）的帧缓冲区很大。RGB565格式下，一个像素占2字节，240x240的屏幕需要`240*240*2 = 115200`字节，即112.5KB的连续内存！ESP32虽然有几百KB的RAM，但MicroPython环境下的堆内存是紧张的。创建这么大的缓冲区可能导致`MemoryError`。解决办法有：1. 使用ESP32-S3等带有额外PSRAM的型号，并将帧缓冲区分配到PSRAM中（需要特定的MicroPython固件支持）。2. 如果显示内容以静态UI和文本为主，可以考虑不用全屏帧缓冲区，而是采用**直接绘制**（Direct Draw）模式，即画每个图形或文字时直接计算并发送对应的SPI数据，但这会大大增加代码复杂度。3. 优化显示逻辑，减少同时需要渲染的图形量。 **功耗考虑**：对于电池供电的项目，屏幕是耗电大户。除了用PWM调低背光亮度，你还可以在不需要显示时，通过发送命令（如`0x28`）将屏幕置于**睡眠模式**（Sleep Mode），此时功耗可以降到极低。当需要显示时，再发送`0x29`命令唤醒。此外，如果刷新不频繁，可以降低SPI时钟频率来省电。 **调试与排错**：当屏幕显示不正常时，要有条理地排查。1. **电源和接线**：用万用表确认电压和连通性。2. **初始化序列**：确认发送的命令序列完全正确，特别是关键命令如`0x36`（MADCTL）、`0x3A`（COLMOD）的参数。可以尝试注释掉部分非关键配置命令，看是否能点亮。3. **SPI信号**：如果有逻辑分析仪，抓取SPI总线上的数据，与数据手册的命令对比，这是最直接的调试手段。4. **软件层面**：在代码中添加打印语句，确认程序执行到了哪一步，缓冲区数据是否正确。 最后，分享一个我常用的测试模式：写一个循环，依次用红、绿、蓝、白、黑填充屏幕，并短暂延时。这能快速检查屏幕色彩显示是否正常、有无坏点、以及刷新是否流畅。如果这个测试通过了，那么硬件连接和基础驱动就基本没问题了，可以放心地进行后续的应用开发了。