手把手教你用ST7789V驱动点亮ST7735S屏幕（Linux 5.10内核，附完整设备树配置）
手把手教你用ST7789V驱动点亮ST7735S屏幕（Linux 5.10内核，附完整设备树配置）
在嵌入式开发中，遇到屏幕驱动不完善的情况并不少见。最近我在一个项目中就碰到了这样的问题：手头有一块ST7735S屏幕，但内核中的原生驱动支持有限。经过一番探索，我发现通过修改ST7789V驱动来适配ST7735S屏幕是个不错的解决方案。这种方法不仅解决了驱动问题，还让我对Linux的FBTFT驱动框架有了更深入的理解。下面就把这个过程中的关键步骤和注意事项分享给大家。
1. 驱动适配原理与准备工作
ST7735S和ST7789V虽然属于不同系列，但它们都是基于SPI接口的小型TFT液晶屏，且寄存器结构有一定相似性。这就是为什么我们可以利用ST7789V的驱动框架来驱动ST7735S屏幕。
需要准备的环境和工具：
- 运行Linux 5.10内核的开发板
- 已连接好的ST7735S屏幕（SPI接口）
- 交叉编译工具链
- 内核源码树
提示：在开始修改前，建议先备份原始驱动文件，以便出现问题时可以快速恢复。
2. 修改ST7789V驱动文件
驱动适配的核心在于修改fb_st7789v.c文件，这个文件通常位于内核源码的drivers/staging/fbtft目录下。我们需要修改两个关键部分：初始化序列和屏幕参数定义。
2.1 调整初始化序列
ST7735S的初始化序列与ST7789V有所不同，我们需要在init_display函数中替换为正确的寄存器设置：
static int init_display(struct fbtft_par *par) { par->fbtftops.reset(par); // 硬件复位 mdelay(50); write_reg(par, 0x11); // 软件复位 mdelay(100); // ST7735S帧率控制 write_reg(par, 0xB1, 0x05, 0x3C, 0x3C); write_reg(par, 0xB2, 0x05, 0x3C, 0x3C); write_reg(par, 0xB3, 0x05, 0x3C, 0x3C, 0x05, 0x3C, 0x3C); // 电源控制序列 write_reg(par, 0xC0, 0x28, 0x08, 0x04); write_reg(par, 0xC1, 0xC0); write_reg(par, 0xC2, 0x0D, 0x00); write_reg(par, 0xC3, 0x8D, 0x2A); // VCOM设置 write_reg(par, 0xC4, 0x8D, 0xEE); // MX, MY, RGB模式 // Gamma校正设置 write_reg(par, 0xE0, 0x04, 0x22, 0x07, 0x0A, 0x2E, 0x30, 0x25, 0x2A, 0x28, 0x26, 0x2E, 0x3A, 0x00, 0x01, 0x03, 0x13); write_reg(par, 0xE1, 0x04, 0x16, 0x06, 0x0D, 0x2D, 0x26, 0x23, 0x27, 0x27, 0x25, 0x2D, 0x3B, 0x00, 0x01, 0x04, 0x13); write_reg(par, 0x3A, 0x05); // 65K色彩模式 write_reg(par, 0x29); // 开启显示 mdelay(100); return 0; }2.2 修改屏幕参数结构体
接下来需要调整fbtft_display结构体中的屏幕参数，确保它们与ST7735S的实际规格匹配：
static struct fbtft_display display = { .regwidth = 8, .width = 128, // ST7735S的实际宽度 .height = 160, // ST7735S的实际高度 .gamma_num = 2, .gamma_len = 14, .gamma = HSD20_IPS_GAMMA, .fbtftops = { .init_display = init_display, .set_var = set_var, .set_gamma = set_gamma, .blank = blank, }, };注意：对于ST7735S屏幕，可能需要注释掉
set_gamma函数中的for循环部分，具体取决于屏幕型号和版本。
3. 设备树配置详解
正确的设备树配置是驱动能够正常工作的关键。下面是一个完整的SPI屏幕节点配置示例：
&spi0 { status = "okay"; st7789v@0 { status = "okay"; compatible = "sitronix,st7789v"; reg = <0>; spi-max-frequency = <48000000>; // SPI时钟频率 rotate = <90>; // 屏幕旋转角度 spi-cpol; // SPI时钟极性 spi-cpha; // SPI时钟相位 rgb; // 颜色格式为RGB fps = <30>; // 刷新率 buswidth = <8>; // 数据总线宽度 dc-gpios = <&pio 1 6 GPIO_ACTIVE_LOW>; // 数据/命令选择引脚 reset-gpios = <&pio 1 5 GPIO_ACTIVE_LOW>; // 复位引脚 debug = <0>; // 调试信息关闭 }; };关键参数说明：
| 参数 | 说明 | 典型值 |
|---|---|---|
| spi-max-frequency | SPI通信最大频率 | 48000000 (48MHz) |
| rotate | 屏幕旋转角度 | 0, 90, 180, 270 |
| fps | 屏幕刷新率 | 30-60 |
| dc-gpios | 数据/命令选择引脚 | 根据硬件连接确定 |
| reset-gpios | 复位控制引脚 | 根据硬件连接确定 |
4. 内核配置与编译
完成驱动修改后，需要配置内核以包含我们修改后的FBTFT驱动：
- 进入内核配置界面：
make ARCH=arm menuconfig确保以下选项已启用：
- Device Drivers → Staging drivers → Support for small TFT LCD display modules → FB driver for ST7789V displays
编译内核和设备树：
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j16 make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs- 安装模块（如果需要）：
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- INSTALL_MOD_PATH=out modules_install5. 测试与验证
将编译好的内核和设备树文件部署到开发板后，可以通过以下方法测试屏幕是否正常工作：
- 检查设备节点：
ls /dev/fb*- 显示测试图案：
cat /dev/urandom > /dev/fb0如果屏幕出现随机噪点（雪花效果），说明驱动已成功加载。
- 启用控制台显示（可选）： 修改u-boot环境变量，添加
console=tty0参数：
setenv bootargs "console=tty0 console=ttyS0,115200 panic=5 rootwait root=/dev/mmcblk0p2 earlyprintk rw vt.global_cursor_default=0" saveenv6. 常见问题排查
在实际操作中可能会遇到各种问题，这里列出几个常见问题及解决方法：
问题1：屏幕无任何反应
- 检查电源连接是否正常
- 确认SPI总线是否已启用（检查
/dev/spidev*是否存在） - 验证复位信号是否正确
问题2：显示内容错乱
- 检查屏幕旋转参数是否正确
- 确认SPI时钟极性和相位设置（spi-cpol/spi-cpha）
- 验证色彩模式设置（rgb参数）
问题3：显示颜色异常
- 检查Gamma校正设置
- 确认色彩深度设置（65K色模式）
- 验证初始化序列中的色彩相关寄存器
7. 性能优化技巧
为了让屏幕表现更好，可以考虑以下优化措施：
调整SPI时钟频率：
- 逐步提高
spi-max-frequency值，直到出现显示异常，然后回退到稳定值 - 典型值在30-50MHz之间
- 逐步提高
优化刷新率：
- 适当提高fps值，但要注意CPU负载
- 对于静态内容，可以降低刷新率以节省功耗
使用DMA传输：
- 在内核配置中启用SPI DMA支持
- 可以减少CPU占用，提高整体性能
双缓冲技术：
- 实现帧缓冲的双缓冲切换
- 可以避免屏幕刷新时的撕裂现象
通过这次ST7789V驱动适配ST7735S屏幕的经历，我深刻体会到Linux驱动框架的灵活性。虽然过程有些曲折，但最终能够看到屏幕正常点亮的那一刻，所有的努力都值得了。建议大家在修改驱动时保持耐心，仔细对照数据手册检查每个寄存器设置，这样能少走很多弯路。