手把手教你用ST7789V驱动点亮ST7735S小屏幕（Linux 5.10内核 + 设备树配置）

用ST7789V驱动点亮ST7735S屏幕的深度实践指南在嵌入式开发中我们常常会遇到硬件与驱动不匹配的情况——手头的屏幕型号可能没有官方驱动支持或者现有驱动存在兼容性问题。本文将详细介绍如何利用Linux内核中成熟的ST7789V驱动来驱动更廉价的ST7735S屏幕这种驱动混用技巧不仅能解决实际问题还能帮助开发者深入理解SPI屏幕驱动的工作原理。1. 理解ST7735S与ST7789V的兼容性基础ST7735S和ST7789V虽然属于不同系列但它们在寄存器结构和通信协议上存在大量相似之处。这种相似性为我们提供了驱动混用的可能性SPI接口兼容性两者都支持标准4线SPI通信模式CPOL/CPHA可配置寄存器重叠区域约60%的基础功能寄存器定义相同如显示开关、内存访问控制等色彩深度支持均支持16位RGB565色彩模式初始化流程相似电源序列、伽马校正等基本操作流程框架一致提示驱动混用的核心在于识别差异点并针对性修改而非全盘重写。ST7789V驱动已经处理了90%的通用逻辑我们只需调整关键参数。主要差异点对比特性ST7735SST7789V最大分辨率132x162240x320帧率控制特殊B1-B3寄存器简化帧率设置伽马曲线自定义12点校正预设5点校正电源序列更复杂的电压控制步骤简化电源管理2. 修改fb_st7789v.c驱动文件2.1 调整init_display初始化函数驱动适配的核心在于正确修改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); // RTNA设置 write_reg(par,0xB2,0x05,0x3C,0x3C); // Front Porch控制 write_reg(par,0xB3,0x05,0x3C,0x3C,0x05,0x3C,0x3C); // 分区控制 // 电源序列配置 write_reg(par,0xC0,0x28,0x08,0x04); // 电源控制1 write_reg(par,0xC1,0xC0); // 电源控制2 write_reg(par,0xC2,0x0D,0x00); // 电源控制3 write_reg(par,0xC3,0x8D,0x2A); // VCOM控制1 write_reg(par,0xC4,0x8D,0xEE); // VCOM控制2 // 内存访问控制 write_reg(par,0x36,0xC0); // MX,MY,RGB模式 // 伽马校正设置 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; }关键修改点解析帧率控制(B1-B3寄存器)ST7735S需要更精细的帧率调节参数0x05,0x3C,0x3C分别控制RTNA、Front Porch和Back Porch电源序列(C0-C4寄存器)需要严格按照ST7735S规格书配置特别注意VCOM电压设置(0xC3,0xC4)对显示对比度的影响伽马校正(E0,E1寄存器)ST7735S需要12点伽马校正这些值直接影响色彩还原准确性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循环因为其伽马校正已在init_display中完整设置。3. GPIO与设备树配置实战3.1 修改fbtft-core.c中的GPIO处理为确保GPIO控制稳定可靠需要修改驱动中的GPIO申请函数static int fbtft_request_one_gpio(struct fbtft_par *par, const char *name, int index, struct gpio_desc **gpiop) { struct device *dev par-info-device; struct device_node *node dev-of_node; int gpio, flags, ret 0; enum of_gpio_flags of_flags; if (of_find_property(node, name, NULL)) { gpio of_get_named_gpio_flags(node, name, index, of_flags); if (gpio -ENOENT) return 0; if (gpio 0) { dev_err(dev, failed to get %s from DT\n, name); return gpio; } flags (of_flags OF_GPIO_ACTIVE_LOW) ? GPIOF_OUT_INIT_LOW : GPIOF_OUT_INIT_HIGH; ret devm_gpio_request_one(dev, gpio, flags, dev-driver-name); if (ret) { dev_err(dev, gpio_request_one(%s%d) failed with %d\n, name, gpio, ret); return ret; } *gpiop gpio_to_desc(gpio); } return ret; }常见问题排查GPIO申请失败检查设备树中GPIO定义是否冲突电平极性错误确认OF_GPIO_ACTIVE_LOW标志设置正确资源泄漏确保使用devm_系列函数管理资源3.2 设备树节点配置示例完整的SPI屏幕设备树节点配置spi0 { status okay; st7789v0 { status okay; compatible sitronix,st7789v; reg 0; spi-max-frequency 48000000; // SPI时钟48MHz rotate 90; // 屏幕旋转90度 spi-cpol; // SPI模式CPOL1 spi-cpha; // SPI模式CPHA1 rgb; // RGB颜色格式 fps 30; // 刷新率30Hz buswidth 8; // 8位总线宽度 dc-gpios pio 1 6 GPIO_ACTIVE_LOW; // DC引脚 reset-gpios pio 1 5 GPIO_ACTIVE_LOW; // 复位引脚 debug 0; // 关闭调试输出 }; };配置要点SPI时钟频率根据屏幕规格选择ST7735S通常支持最高50MHz旋转设置支持0、90、180、270度四个方向GPIO极性确保与硬件电路一致特别是复位序列时序4. 内核配置与编译部署4.1 内核菜单配置执行make ARCHarm menuconfig后需要确保以下选项被正确配置Device Drivers --- Staging drivers --- Support for small TFT LCD display modules --- * FB driver for the ST7789V LCD controller [*] FBTFT debugging support [*] FBTFT device tree support [*] FBTFT GPIO support提示虽然我们使用ST7789V驱动但最终目标是驱动ST7735S因此不需要启用ST7735R驱动选项。4.2 内核编译与部署使用交叉编译工具链进行编译# 编译内核镜像 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j16 # 编译内核模块 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j16 INSTALL_MOD_PATHout modules make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- -j16 INSTALL_MOD_PATHout modules_install # 编译设备树 make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- dtbs部署步骤将生成的zImage和dtb文件复制到启动分区确保所有修改的驱动模块已正确安装根据需要更新u-boot环境变量5. 测试与验证5.1 基础功能测试屏幕驱动加载后可以通过以下命令测试基本功能# 显示随机噪声图案雪花点 cat /dev/urandom /dev/fb0 # 清屏为红色 echo -ne \xFF\x00\x00 /dev/fb0 # 显示测试图案 fbtest -f 1 # 需要fbtest工具5.2 控制台输出配置如需在屏幕上显示Linux控制台需修改u-boot的bootargssetenv bootargs consoletty0 consolettyS0,115200 panic5 rootwait root/dev/mmcblk0p2 earlyprintk rw vt.global_cursor_default0 saveenv常见问题解决方案屏幕无显示检查背光电路是否正常工作用逻辑分析仪验证SPI信号确认复位时序符合规格要求显示花屏检查色彩模式设置(0x3A寄存器)验证内存访问控制寄存器(0x36)配置确认SPI时钟极性(CPOL/CPHA)设置显示偏移调整显示起始行/列寄存器检查屏幕旋转参数与实际硬件方向是否匹配在实际项目中我发现ST7735S对初始化时序特别敏感建议严格按照数据手册中的时间参数设置延时。另外某些廉价屏幕的伽马曲线可能与标准值有偏差可能需要根据实际显示效果微调E0/E1寄存器的值。