告别官方库！手把手教你用ESP32模拟SPI驱动ST7735屏幕（附完整代码与避坑指南）-开发者社区

告别官方库！手把手教你用ESP32模拟SPI驱动ST7735屏幕（附完整代码与避坑指南）

在嵌入式开发中，我们常常会遇到这样的困境：官方提供的库文件要么过于臃肿，要么与我们的硬件配置不完全兼容。特别是当你在Arduino IDE环境下尝试使用常见的TFT库（如Adafruit_ST7735）驱动ST7735屏幕时，可能会遇到各种令人头疼的问题——引脚冲突、功能限制、性能瓶颈，甚至是莫名其妙的兼容性问题。这时候，放弃现成的"黑盒"库，从底层掌握SPI通信原理，自己动手实现驱动，反而可能是一条更高效、更可控的路径。

本文将带你深入理解ST7735屏幕的驱动原理，详细对比ESP32上模拟SPI与硬件SPI的优劣，并手把手教你如何从零开始实现一个轻量级、高度可定制的驱动方案。无论你是遇到了库文件不兼容的问题，还是单纯想深入了解底层驱动的工作原理，这篇文章都将为你提供实用的解决方案和清晰的实现路径。

1. 为什么选择模拟SPI？硬件SPI的局限与突破

在开始编码之前，我们需要明确一个基本问题：为什么要放弃ESP32内置的硬件SPI，转而使用模拟SPI？答案并非绝对，而是取决于你的具体需求和面临的约束条件。

硬件SPI确实有其不可替代的优势：

更高的时钟频率：通常能达到几十MHz
更低的CPU占用率：数据传输由硬件自动处理
更精确的时序控制：硬件保证信号边沿的准确性

然而，硬件SPI在实际应用中也可能面临诸多限制：

引脚固定：ESP32的硬件SPI引脚是预定义的（如VSPI默认使用GPIO 18、19、23），当这些引脚被其他功能占用时，就会产生冲突。
库文件限制：许多现成的TFT库对SPI配置做了硬编码，难以灵活调整。
功能过剩：对于ST7735这样的屏幕，其SPI接口通常工作在几MHz的频率下，硬件SPI的性能优势无法充分发挥。

相比之下，模拟SPI提供了以下优势：

引脚任意配置：可以使用任何GPIO引脚
代码完全透明：每个信号变化都在你的控制之下
调试更方便：可以随时插入调试语句观察信号状态
资源占用更少：不需要链接庞大的库文件

// 模拟SPI的引脚定义示例 - 完全可自定义 #define LCD_SCLK 13 // 时钟线 #define LCD_MOSI 12 // 数据线 #define LCD_CS 26 // 片选 #define LCD_DC 27 // 数据/命令选择 #define LCD_RST 14 // 复位 #define LCD_BL 25 // 背光控制

提示：在实际项目中，建议将引脚定义集中放在头文件中，方便后期调整和维护。

2. ST7735驱动原理深度解析

要自己实现驱动，首先需要理解ST7735控制器的基本工作原理。ST7735是一款常见的TFT液晶驱动芯片，支持262K色显示（18位RGB，6位每色），内置显存（132×162×18位），通过SPI接口与主控通信。

2.1 ST7735的通信协议

ST7735支持3线或4线SPI接口。在3线模式下，数据线是双向的；而在4线模式下，有单独的数据输入和输出线。为了简化实现，我们通常使用4线模式（虽然只用到输入）。

通信的基本单元是9位：

第1位：DC（数据/命令选择）
- 0：后续8位是命令
- 1：后续8位是数据
后8位：实际传输的数据

每次传输的基本流程如下：

拉低CS（片选）激活设备
设置DC电平（决定传输的是命令还是数据）
在SCLK的上升沿，MOSI上的数据被采样
传输完成后拉高CS

// 模拟SPI写8位数据的实现 void LCD_WriteByte(uint8_t data) { digitalWrite(LCD_CS, LOW); // 使能设备 for(int i=0; i<8; i++) { digitalWrite(LCD_SCLK, LOW); // 准备时钟下降沿 // 设置数据线 if(data & 0x80) { digitalWrite(LCD_MOSI, HIGH); } else { digitalWrite(LCD_MOSI, LOW); } digitalWrite(LCD_SCLK, HIGH); // 产生上升沿，设备采样 data <<= 1; // 移出最高位 } digitalWrite(LCD_CS, HIGH); // 禁用设备 }

2.2 关键命令解析

ST7735有数十个控制命令，但最常用的包括：

命令代码	名称	功能描述
0x01	SWRESET	软件复位
0x11	SLPOUT	退出睡眠模式
0x29	DISPON	开启显示
0x2A	CASET	设置列地址范围
0x2B	RASET	设置行地址范围
0x2C	RAMWR	写入显存数据

其中，CASET和RAMWR是实现图形显示的核心命令。CASET设置X坐标范围，RASET设置Y坐标范围，RAMWR则开始向显存写入像素数据。

3. 从零构建驱动：代码实现与优化

现在，我们已经掌握了足够的基础知识，可以开始构建自己的驱动了。下面将分步骤实现一个完整的驱动方案。

3.1 初始化序列

ST7735上电后需要进行一系列初始化设置才能正常工作。不同厂商的屏幕可能需要略有不同的初始化序列，这通常是现成库不兼容的主要原因之一。

void LCD_Init() { // 硬件复位 digitalWrite(LCD_RST, HIGH); delay(100); digitalWrite(LCD_RST, LOW); delay(100); digitalWrite(LCD_RST, HIGH); delay(120); // 软件复位 LCD_WriteCommand(0x01); delay(120); // 退出睡眠模式 LCD_WriteCommand(0x11); delay(120); // 设置颜色模式：16位RGB LCD_WriteCommand(0x3A); LCD_WriteData(0x05); // 设置显示方向 LCD_WriteCommand(0x36); LCD_WriteData(0x08); // 竖屏模式 // 更多初始化命令... // 开启显示 LCD_WriteCommand(0x29); delay(100); }

注意：初始化序列中的延时非常关键，过短的延时可能导致命令未被正确执行。如果屏幕显示异常，尝试增加这些延时。

3.2 基本绘图功能实现

有了初始化序列，接下来实现基本的绘图功能。核心是设置显示区域，然后连续写入像素数据。

// 设置显示区域 void LCD_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WriteCommand(0x2A); // CASET LCD_WriteData(x1 >> 8); LCD_WriteData(x1 & 0xFF); LCD_WriteData(x2 >> 8); LCD_WriteData(x2 & 0xFF); LCD_WriteCommand(0x2B); // RASET LCD_WriteData(y1 >> 8); LCD_WriteData(y1 & 0xFF); LCD_WriteData(y2 >> 8); LCD_WriteData(y2 & 0xFF); LCD_WriteCommand(0x2C); // RAMWR } // 绘制单个像素 void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color) { LCD_SetWindow(x, y, x, y); LCD_WriteData(color >> 8); LCD_WriteData(color & 0xFF); }

3.3 性能优化技巧

直接使用上述基础实现虽然可行，但在实际应用中可能会遇到性能问题。以下是几个关键的优化点：

批量写入优化：避免为每个像素都设置窗口，而是批量写入连续像素。

// 填充矩形区域 void LCD_FillRect(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color) { LCD_SetWindow(x, y, x+w-1, y+h-1); uint32_t pixels = w * h; for(uint32_t i=0; i<pixels; i++) { LCD_WriteData(color >> 8); LCD_WriteData(color & 0xFF); } }

双缓冲技术：在内存中维护一个屏幕缓冲区，只在必要时刷新到屏幕，减少SPI通信次数。
时钟速度调整：适当提高模拟SPI的时钟频率（但需确保ST7735能够可靠接收）。

4. 常见问题排查与解决方案

即使按照上述步骤仔细实现，在实际调试中仍可能遇到各种问题。下面列出一些常见问题及其解决方案：

4.1 屏幕无任何显示

检查硬件连接：
- 确认所有引脚连接正确
- 检查电源电压是否稳定（通常需要3.3V）
- 确保背光控制引脚被正确驱动
检查初始化序列：
- 确认复位信号有效
- 尝试增加初始化命令间的延时
- 查阅屏幕规格书，确认正确的初始化序列
检查SPI信号：
- 用逻辑分析仪观察SPI波形
- 确认CS、DC信号时序正确

4.2 显示内容错位或颜色异常

显示方向设置：尝试调整0x36命令的参数，常见选项包括：
- 0x08：竖屏
- 0x68：横屏
- 0xC8：竖屏反转
- 0xA8：横屏反转
颜色格式设置：确认0x3A命令设置的颜色格式与你的实现匹配：
- 0x03：12位RGB
- 0x05：16位RGB
- 0x06：18位RGB
显存偏移调整：某些屏幕在X/Y方向有固定的偏移量，需要在设置窗口时补偿：

// 在LCD_SetWindow中添加偏移补偿 x1 += 2; x2 += 2; y1 += 1; y2 += 1;

4.3 显示闪烁或残影

提高刷新速度：
- 优化SPI写函数，减少不必要的延时
- 考虑使用硬件SPI加速数据传输
合理使用局部刷新：只刷新屏幕上实际变化的部分，而不是整个屏幕
电源稳定性：
- 确保电源有足够的滤波电容
- 避免电源线上有过大的电压波动

5. 进阶功能扩展

掌握了基本驱动后，我们可以进一步扩展功能，打造更完善的图形显示方案。

5.1 文本显示实现

基于像素绘制函数，我们可以实现字符显示功能。基本思路是使用字模数据，将每个字符转换为一系列像素点。

// 显示单个ASCII字符 void LCD_DrawChar(uint16_t x, uint16_t y, char c, uint16_t color, uint16_t bg, uint8_t size) { // 获取字符的字模数据 const uint8_t *font = &font_8x8[c * 8]; for(uint8_t i=0; i<8; i++) { uint8_t line = font[i]; for(uint8_t j=0; j<8; j++) { if(line & 0x01) { if(size == 1) { LCD_DrawPixel(x+j, y+i, color); } else { LCD_FillRect(x+j*size, y+i*size, size, size, color); } } else if(bg != color) { if(size == 1) { LCD_DrawPixel(x+j, y+i, bg); } else { LCD_FillRect(x+j*size, y+i*size, size, size, bg); } } line >>= 1; } } }

5.2 图形加速技巧

对于更复杂的图形应用，可以考虑以下优化：

快速水平/垂直线：专门优化直线绘制算法，减少SPI命令开销
图形缓存：在内存中维护部分屏幕内容，减少实际刷新次数
异步刷新：使用ESP32的双核特性，在一个核心处理业务逻辑的同时，另一个核心负责屏幕刷新

5.3 多屏幕支持与抽象层设计

如果需要支持多种不同类型的屏幕，可以设计一个抽象层，将底层驱动细节与上层应用分离：

// 显示驱动接口抽象 typedef struct { void (*init)(void); void (*set_window)(uint16_t, uint16_t, uint16_t, uint16_t); void (*write_pixel)(uint16_t); // 更多通用函数... } DisplayDriver; // ST7735的具体实现 const DisplayDriver st7735_driver = { .init = LCD_Init, .set_window = LCD_SetWindow, .write_pixel = LCD_WritePixel, // ... };

这种设计使得上层应用代码可以完全不关心具体使用哪种屏幕，只需通过统一的接口操作显示设备，大大提高了代码的可移植性和可维护性。

6. 完整代码示例与项目结构

为了帮助你快速上手，下面提供一个完整的项目结构示例和核心代码片段。

6.1 项目文件结构

ESP32_ST7735_Driver/ ├── src/ │ ├── main.cpp # 主应用程序 │ ├── st7735.h # 驱动头文件 │ ├── st7735.cpp # 驱动实现 │ ├── fonts.h # 字模数据 │ └── graphics.h # 高级图形功能 ├── platformio.ini # PlatformIO配置文件 └── README.md # 项目说明

6.2 核心驱动代码

st7735.h:

#ifndef ST7735_H #define ST7735_H #include <stdint.h> // 引脚定义 #define LCD_WIDTH 128 #define LCD_HEIGHT 160 // 常用颜色定义 #define ST7735_BLACK 0x0000 #define ST7735_BLUE 0x001F #define ST7735_RED 0xF800 #define ST7735_GREEN 0x07E0 #define ST7735_WHITE 0xFFFF // 函数声明 void LCD_Init(); void LCD_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2); void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color); void LCD_FillRect(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color); void LCD_DrawChar(uint16_t x, uint16_t y, char c, uint16_t color, uint16_t bg, uint8_t size); void LCD_DrawString(uint16_t x, uint16_t y, const char *str, uint16_t color, uint16_t bg, uint8_t size); #endif

st7735.cpp:

#include "st7735.h" #include <Arduino.h> // 引脚定义 #define LCD_SCLK 13 #define LCD_MOSI 12 #define LCD_CS 26 #define LCD_DC 27 #define LCD_RST 14 #define LCD_BL 25 // 私有函数 static void LCD_WriteCommand(uint8_t cmd); static void LCD_WriteData(uint8_t data); static void LCD_WriteByte(uint8_t data); void LCD_Init() { // 初始化GPIO pinMode(LCD_SCLK, OUTPUT); pinMode(LCD_MOSI, OUTPUT); pinMode(LCD_CS, OUTPUT); pinMode(LCD_DC, OUTPUT); pinMode(LCD_RST, OUTPUT); pinMode(LCD_BL, OUTPUT); // 硬件复位 digitalWrite(LCD_RST, HIGH); delay(100); digitalWrite(LCD_RST, LOW); delay(100); digitalWrite(LCD_RST, HIGH); delay(120); // 初始化序列 LCD_WriteCommand(0x01); // SWRESET delay(120); LCD_WriteCommand(0x11); // SLPOUT delay(120); // ... 完整初始化序列 // 开启背光 digitalWrite(LCD_BL, HIGH); } // 其他函数实现...

6.3 示例应用

main.cpp:

#include <Arduino.h> #include "st7735.h" void setup() { LCD_Init(); // 填充屏幕为白色 LCD_FillRect(0, 0, LCD_WIDTH, LCD_HEIGHT, ST7735_WHITE); // 绘制红色矩形 LCD_FillRect(20, 20, 80, 40, ST7735_RED); // 显示文本 LCD_DrawString(30, 70, "Hello ST7735!", ST7735_BLACK, ST7735_WHITE, 2); } void loop() { // 主循环可以添加动画或交互逻辑 }

在实际项目中遇到问题时，记住调试是开发过程中不可或缺的一部分。通过逻辑分析仪观察SPI信号，或者添加串口打印语句跟踪程序执行流程，都是非常有效的调试手段。