【LuckFox Pico】SPI LCD驱动移植实战：基于FBTFT适配ST7735与GC9306
1. 硬件准备与引脚分析
在开始移植FBTFT驱动之前，首先要确保硬件连接正确。LuckFox Pico开发板通过SPI接口与LCD屏幕通信，我们需要明确每个引脚的功能定义。以ST7735和GC9306两款屏幕为例，它们的典型引脚包括：
- SCK：SPI时钟信号
- MOSI：SPI主设备输出从设备输入
- CS：片选信号（低电平有效）
- DC：数据/命令选择线
- RESET：硬件复位线
- BL：背光控制
实际项目中，我遇到过引脚复用冲突的问题。比如某次调试时发现屏幕无响应，最终发现是因为SPI0的MISO引脚被默认配置为UART功能。解决方法是在设备树中注释掉相关UART节点，就像这样：
&uart4 { status = "disabled"; // 释放GPIO1_PC3引脚 };2. 设备树配置实战
设备树(DTS)是Linux内核识别硬件的关键。对于SPI LCD的配置，需要重点关注以下几个部分：
2.1 GPIO引脚定义
首先为每个控制引脚创建节点，例如背光控制引脚：
gpio0pa4: gpio0pa4 { compatible = "regulator-fixed"; pinctrl-names = "default"; pinctrl-0 = <&gpio0_pa4>; regulator-name = "gpio0_pa4"; regulator-always-on; };2.2 SPI控制器配置
配置SPI0控制器时，需要特别注意时钟频率的设置。根据我的实测，ST7735在6MHz下工作稳定，而GC9306可以跑到24MHz：
&spi0 { status = "okay"; pinctrl-0 = <&spi0m0_pins>; spi-max-frequency = <6000000>; // 6MHz时钟 lcd: lcd@0 { compatible = "sitronix,st7735"; reg = <0>; spi-cpol; // 时钟极性 spi-cpha; // 时钟相位 rotate = <0>; // 显示方向 }; };3. 内核驱动移植详解
3.1 Makefile修改
在drivers/staging/fbtft/Makefile中添加驱动编译选项：
obj-$(CONFIG_FB_TFT_ST7735) += fb_st7735.o obj-$(CONFIG_FB_TFT_GC9306) += fb_gc9306.o3.2 Kconfig配置
为驱动添加菜单选项：
config FB_TFT_ST7735 tristate "FB driver for ST7735 LCD" depends on FB_TFT help Support for ST7735 based displays3.3 核心驱动修改
由于内核版本差异，fbtft-core.c可能需要适配。关键修改点包括：
- GPIO请求函数改造：
static int fbtft_request_one_gpio(struct fbtft_par *par, const char *name, int index, struct gpio_desc **gpiop) { // 添加OF_GPIO_ACTIVE_LOW标志处理 flags = (of_flags & OF_GPIO_ACTIVE_LOW) ? GPIOF_OUT_INIT_LOW : GPIOF_OUT_INIT_HIGH; }- 复位时序优化：
static void fbtft_reset(struct fbtft_par *par) { gpiod_set_value_cansleep(par->gpio.reset, 1); usleep_range(20, 40); gpiod_set_value_cansleep(par->gpio.reset, 0); msleep(120); }4. 屏幕驱动开发实战
4.1 ST7735驱动实现
初始化序列需要严格按照数据手册编写：
static int init_display(struct fbtft_par *par) { write_reg(par, 0xB1, 0x05, 0x3C, 0x3C); // 帧率控制 write_reg(par, 0xC0, 0x28, 0x08, 0x04); // 电源控制1 write_reg(par, 0x36, 0xC0); // 内存访问控制 write_reg(par, MIPI_DCS_SET_DISPLAY_ON); // 开启显示 return 0; }4.2 GC9306驱动特点
GC9306需要特殊的Gamma校正设置：
static int set_gamma(struct fbtft_par *par, u32 *curves) { write_reg(par, 0xF0, 0x02, 0x00, 0x00, 0x1B, 0x1F, 0x0B); write_reg(par, 0xF1, 0x01, 0x03, 0x00, 0x28, 0x2B, 0x0E); return 0; }5. 驱动验证与调试
编译烧录后，通过以下命令验证驱动：
- 查看内核日志：
dmesg | grep fb_ # 正常应显示类似： # fb_gc9306 frame buffer, 240x320, 150 KiB video memory- 测试屏幕显示：
# 花屏测试 cat /dev/urandom > /dev/fb0 # 清屏测试 cat /dev/zero > /dev/fb0常见问题排查：
- 屏幕白屏：检查背光电路和BL引脚配置
- 显示错位：确认rotate参数和扫描方向设置
- 颜色异常：检查SPI数据位宽和像素格式
6. 进阶优化建议
性能调优：
- 增大SPI时钟频率（需确保信号质量）
- 启用DMA传输减少CPU占用
- 调整fps参数平衡刷新率和功耗
电源管理：
lcd: lcd@0 { power-supply = <&vcc_lcd>; // 添加电源控制 backlight = <&backlight>; // 背光控制节点 };- 多屏幕支持：
&spi0 { lcd1: lcd@0 { reg = <0>; }; lcd2: lcd@1 { reg = <1>; }; // 第二个屏幕 };移植过程中最耗时的往往是硬件时序调试。建议准备逻辑分析仪观察SPI波形，确保时钟极性(CPOL)和相位(CPHA)设置与屏幕规格一致。我曾遇到某款GC9306屏幕必须设置CPHA=1才能正常显示，而数据手册却标注为可选，这种特殊情况只能通过实际测试验证。