保姆级教程：用ESP32和MicroPython驱动1.8寸ST7735S彩屏，5分钟显示你的第一张图片
零基础玩转ESP32：5分钟点亮ST7735S彩屏全攻略
第一次接触ESP32和MicroPython的硬件爱好者们，是否曾被复杂的SPI接线和驱动配置劝退？今天我们将用最直观的方式，带你绕过所有坑点，从零开始驱动1.8寸ST7735S彩屏。不同于常规教程的技术术语堆砌，本文特别设计了"接线可视化"、"文件保姆式定位"和"一键测试"三个安全机制，确保即使毫无经验的用户也能一次成功。
1. 硬件准备与接线图解
1.1 物料清单检查
在开始前，请确认你已备齐以下组件：
- ESP32开发板（推荐NodeMCU-32S或WROOM模组）
- 1.8寸ST7735S TFT屏幕（128x160分辨率）
- 杜邦线6根（建议使用不同颜色区分功能）
- Micro USB数据线
- 可选：面包板（方便固定连接）
关键识别点：正品ST7735S模块背面会有清晰的型号标识，且接口包含7个引脚（含背光控制）。市场上存在兼容型号，本文配置同样适用。
1.2 接线映射表与防错技巧
对照下表连接时，建议先完成GND和VCC的通电测试，再逐步接入信号线：
| 屏幕引脚 | ESP32对应引脚 | 功能说明 | 常见错误警示 |
|---|---|---|---|
| GND | GND | 地线 | 接反会烧毁模块 |
| VCC | 3.3V | 电源 | 严禁接5V |
| SCL | GPIO14 | SPI时钟线 | 与MOSI不可互换 |
| SDA | GPIO13 | SPI数据输出 | 需确保接触牢固 |
| RES | GPIO17 | 复位信号 | 首次必须连接 |
| DC | GPIO16 | 数据/命令选择 | 影响通信协议解析 |
| CS | GPIO18 | 片选信号 | 部分库要求常低电平 |
实操提示：使用彩色标签标记线材，GND用黑色、VCC用红色、信号线用黄色，可降低接错概率。若屏幕无显示，首先检查DC和RES是否虚接。
2. 驱动环境一键配置方案
2.1 MicroPython固件刷写
如果你的ESP32尚未安装MicroPython，按以下步骤操作：
- 下载最新固件（推荐v1.20.0）：
wget https://micropython.org/resources/firmware/esp32-20230426-v1.20.0.bin - 使用esptool.py刷写：
esptool.py --port /dev/ttyUSB0 erase_flash esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash 0x1000 esp32-20230426-v1.20.0.bin
2.2 驱动库极简部署
我们优化了原版ST7735驱动库，创建了开箱即用的安装包：
- 下载预配置资源包：
import upip upip.install('micropython-st7735s-optimized') - 或手动上传关键文件（适用于离线环境）：
ST7735.py→ 主驱动库tftbmp.py→ 图像显示脚本test128x160.bmp→ 测试图片
文件存放位置至关重要，必须确保：
/lib └── ST7735.py /tftbmp.py /test128x160.bmp3. 图像显示实战演练
3.1 基础显示测试
上传完成后，在REPL中执行：
import tftbmp tftbmp.show('test128x160.bmp')正常情况会立即显示经典的Lena测试图。若遇到以下问题：
- 白屏：检查CS引脚是否接地（部分模块需永久使能）
- 花屏：降低SPI时钟频率，修改
ST7735.py中的SPI_BAUDRATE = 20000000为更低值 - 偏色：调整
ST7735.init()中的颜色模式参数
3.2 自定义图片转换技巧
准备你的个性图片需要满足：
- 尺寸严格128x160像素
- 16位色深BMP格式
- 使用Linux下convert工具快速转换：
convert input.jpg -resize 128x160! -type truecolor BMP3:output.bmp
Windows用户可用Paint.NET，导出时选择"16位R5G6B5"格式。
4. 高阶应用与性能调优
4.1 双缓冲动画实现
通过帧缓冲技术实现流畅动画：
import ST7735 tft = ST7735.ST7735(SPI(1), dc=16, rst=17, cs=18) buffer = bytearray(128*160*2) # 每像素2字节 def draw_frame(): # 填充buffer数据... tft.blit_buffer(buffer, 0, 0, 128, 160)4.2 低功耗配置方案
针对电池供电场景：
tft.sleep(True) # 进入睡眠模式（功耗<0.1mA） tft.sleep(False) # 唤醒恢复实际测试数据显示：
| 模式 | 电流消耗 | 唤醒延迟 |
|---|---|---|
| 正常显示 | 25mA | - |
| 睡眠模式 | 0.08mA | 120ms |
| 关闭背光 | 15mA | 即时 |
我在实际项目中发现，GPIO16偶尔会出现信号不稳定的情况，这时可以尝试在初始化时增加50ms的延时，或者改用GPIO5作为DC引脚。对于需要频繁刷新的应用，建议将SPI时钟设置在10-15MHz之间，既能保证速度又不会导致数据错位。