【资源自取】ST7789 配置文件快速指南:3 步跑通 2.8 寸屏初始化
【资源自取】ST7789 配置文件快速指南:3 步跑通 2.8 寸屏初始化
这个项目包含一套 ST7789 配置文件与参考手册:一份 2.8 寸屏的完整初始化序列(ST7789+2.8CTC.ini),一份 ST7789V 芯片规格书。克隆下来,照着寄存器写序就能把 SPI 液晶屏初始化点亮。
适合谁用:能解决什么问题
- 第一次接 2.8 寸 ST7789 SPI 屏(如 2.8CTC 模组),不知道初始化命令该按什么顺序发送
- 屏能亮,但显示倒装、镜像或偏色,需要拿一份验证过的写序逐项对照检查
- 在 MCU 固件里移植点屏代码,想要一份在实屏上跑通的寄存器序列作底稿
- 查寄存器定义、接口协议与刷新参数,需要一份可靠的规格书
从克隆到跑通:3 步上手
-
克隆项目:
git clone https://gitcode.com/open-source-toolkit/143c0。仓库根目录有一个压缩包 ST7789V+2.8CTC.7z,约 2.6MB。 -
解压压缩包:
7z x ST7789V+2.8CTC.7z。得到两个文件:配置文件ST7789+2.8CTC.ini和手册ST7789V_SPEC_V1.3.pdf。 -
应用配置:把 .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 区提交即可。
登录后查看全文