【资源自取】ST7789 配置文件快速指南:3 步跑通 2.8 寸屏初始化

原创2026-11-14 15:43:261,898 阅读

【资源自取】ST7789 配置文件快速指南:3 步跑通 2.8 寸屏初始化

这个项目包含一套 ST7789 配置文件与参考手册:一份 2.8 寸屏的完整初始化序列(ST7789+2.8CTC.ini),一份 ST7789V 芯片规格书。克隆下来,照着寄存器写序就能把 SPI 液晶屏初始化点亮。

适合谁用:能解决什么问题

  • 第一次接 2.8 寸 ST7789 SPI 屏(如 2.8CTC 模组),不知道初始化命令该按什么顺序发送
  • 屏能亮,但显示倒装、镜像或偏色,需要拿一份验证过的写序逐项对照检查
  • 在 MCU 固件里移植点屏代码,想要一份在实屏上跑通的寄存器序列作底稿
  • 查寄存器定义、接口协议与刷新参数,需要一份可靠的规格书

从克隆到跑通:3 步上手

  1. 克隆项目:git clone https://gitcode.com/open-source-toolkit/143c0。仓库根目录有一个压缩包 ST7789V+2.8CTC.7z,约 2.6MB。

  2. 解压压缩包:7z x ST7789V+2.8CTC.7z。得到两个文件:配置文件 ST7789+2.8CTC.ini 和手册 ST7789V_SPEC_V1.3.pdf。

  3. 应用配置:把 .ini 导入 LCD 初始化工具走 SPI 下发,或把其中的 Write(Command, …) / Write(Parameter, …) 行按顺序抄进固件的屏初始化函数;遇到不懂的寄存器,查包内规格书。

关键参数速查:.ini 里哪几行不能错

参数 含义 典型值 改错的后果
0x11 + Delayms(120) Sleep Out 唤醒,发后必须等待 120ms 屏不亮,或等待过短出现闪烁
0x36 = 0x00 显示方向 / 扫描方向控制 0x00 显示倒装、左右镜像
0x3a = 0x05 接口像素格式 0x05(16bit) 颜色发虚、整体偏色
0xc6 = 0x0f 刷新率设置 0x0f(60Hz) 刷新异常、画面抖动
0xe0 / 0xe1 Gamma 校正(正极 / 负极) 见 .ini 对比度差、灰阶发闷
0x29 Display On,序列最后一条 — 漏发则屏始终不亮

常见坑与排查:黑屏、倒装、偏色

  • 现象:屏始终不亮。原因:0x11 没发或唤醒等待不足。处理:补发 0x11,至少等待 120ms 后再发 0x29。
  • 现象:显示倒装或镜像。原因:0x36(MADCTL)与模组物理方向不匹配。处理:对照规格书改 0x36 的位组合,重新初始化对比。
  • 现象:整体偏色。原因:0x3a 像素格式与驱动接口不一致。处理:统一用 16bit 的 0x05,或与接口硬件格式对齐。
  • 现象:查不到某个寄存器的定义。原因:规格书章节不熟。处理:打开 ST7789V_SPEC_V1.3.pdf 检索 "SET" 命令表,.ini 里的初始化值都能在表中对上。

项目采用 MIT 许可证(见 LICENSE),配置与手册可自由使用和修改;遇到问题在仓库 Issue 区提交即可。

登录后查看全文
ST7789配置文件及参考手册