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

嵌入式Linux屏幕驱动移植实战ST7789V驱动适配ST7735S全解析在嵌入式开发中遇到非标准屏幕的驱动适配问题可谓家常便饭。最近在为一个工业控制项目选型时我们遇到了ST7735S这款性价比极高的1.8寸TFT屏幕却发现官方驱动支持有限。经过多次尝试发现修改ST7789V的驱动来适配ST7735S是最优解。本文将完整呈现这个驱动移植过程从原理分析到实战操作帮你避开那些我踩过的坑。1. 驱动适配原理与技术背景为什么ST7789V的驱动可以适配ST7735S这个问题困扰了我整整两天。直到仔细对比了两款屏幕的数据手册才发现它们都属于STMicroelectronics的TFT控制器系列采用相似的SPI通信协议和寄存器架构。关键相似点相同的8位/16位SPI接口近似的初始化序列结构兼容的像素数据格式类似的电源管理寄存器但差异也不容忽视初始化参数值不同伽马校正曲线有区别最大刷新率存在差异提示驱动移植的核心在于保持通信协议不变只修改初始化参数和显示配置下表是两款屏幕的主要参数对比特性ST7735SST7789V分辨率128x160240x320接口SPI 8/16bitSPI 8/16bit色彩深度65K色65K色工作电压2.4-3.3V2.4-3.3V典型应用小型嵌入式设备中型嵌入式设备2. 内核驱动修改实战2.1 准备开发环境首先确保你的Linux内核版本是5.10其他版本可能需要调整路径# 检查内核版本 uname -r # 进入内核源码目录 cd linux-5.102.2 修改fb_st7789v.c文件这个文件位于drivers/staging/fbtft/目录。我们需要修改两个关键部分初始化序列修改static int init_display(struct fbtft_par *par) { par-fbtftops.reset(par); // 硬件复位 mdelay(50); // 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,0xB4,0x03); // 列反转 // 电源控制序列 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模式 // 伽马校正 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; }显示参数调整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, }, };2.3 GPIO配置调整在fbtft-core.c中我们需要确保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 -EPROBE_DEFER) return gpio; 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; }3. 设备树配置详解设备树配置是驱动正常工作的关键。以下是一个完整的SPI屏幕节点配置示例spi0 { status okay; pinctrl-names default; pinctrl-0 spi0_pins; st7789v0 { status okay; compatible sitronix,st7789v; reg 0; spi-max-frequency 32000000; // 适当降低频率提高稳定性 rotate 90; // 屏幕旋转90度 spi-cpol; // SPI时钟极性 spi-cpha; // SPI时钟相位 rgb; // RGB颜色格式 fps 30; // 帧率 buswidth 8; // 数据总线宽度 // GPIO配置 dc-gpios pio 1 6 GPIO_ACTIVE_LOW; // 数据/命令选择 reset-gpios pio 1 5 GPIO_ACTIVE_LOW; // 复位信号 debug 0; // 调试信息关闭 }; };关键参数说明spi-max-frequency根据屏幕规格和PCB布线质量调整rotate设置屏幕显示方向spi-cpol/spi-cpha必须与屏幕规格书一致dc-gpios数据/命令选择线通信时序关键4. 内核配置与编译4.1 内核菜单配置执行以下命令进入内核配置界面make ARCHarm menuconfig需要配置的选项路径Device Drivers --- Staging drivers --- Support for small TFT LCD display modules --- M FB driver for the ST7789V LCD controller [*] FBTFT debugging [*] FBTFT device bus access debugging4.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部署到开发板后可以通过以下命令测试# 测试屏幕显示 cat /dev/urandom /dev/fb0 # 查看驱动加载信息 dmesg | grep fbtft5. 常见问题与调试技巧在项目实践中我遇到了几个典型问题问题1屏幕能亮但显示异常检查初始化序列是否正确确认SPI时钟极性和相位设置验证颜色格式(rgb/bgr)配置问题2屏幕完全不亮测量背光电压是否正常检查复位信号时序确认SPI通信是否建立用逻辑分析仪抓波形问题3显示内容错位调整屏幕旋转参数检查宽度高度设置确认显存与物理屏幕的映射关系一个实用的调试技巧是在初始化函数中添加打印fbtft_par_dbg(DEBUG_INIT_DISPLAY, par, %s()\n, __func__);然后在系统启动时观察内核日志# 动态查看内核日志 dmesg -w6. 性能优化建议经过多次测试总结出以下优化方向SPI时钟优化从10MHz开始逐步提高直到出现显示异常我们的项目最终稳定在32MHz帧率优化修改设备树中的fps参数平衡流畅度和CPU占用率内存优化// 在驱动中减少不必要的缓冲区 par-txbuf.len width * height * 2; // RGB565格式实际项目中通过合理配置这些参数我们成功将系统资源占用降低了40%同时保持了流畅的30fps刷新率。