手把手教你为LuckFox Pico移植ST7735/GC9306 SPI屏幕驱动（附完整DTS配置与内核补丁）

嵌入式Linux SPI屏幕驱动移植实战：从零适配ST7735/GC9306到LuckFox Pico

当一块全新的SPI液晶屏拿到手时，如何快速将其驱动移植到嵌入式Linux平台？这个问题困扰着许多嵌入式开发者。本文将以LuckFox Pico开发板为例，详细解析ST7735和GC9306两款常见SPI屏幕的驱动移植全过程，涵盖硬件引脚配置、设备树修改、内核驱动适配等关键环节，并分享实际项目中的调试技巧和避坑指南。

1. 硬件准备与引脚规划

在开始软件移植前，合理的硬件连接是成功的基础。LuckFox Pico基于Rockchip RV1103G芯片，其SPI0接口通常包含以下信号线：

• SCLK ：时钟信号（GPIO1_C1）
• MOSI ：主机输出从机输入（GPIO1_C2）
• MISO ：主机输入从机输出（GPIO1_C3，本例中复用为CS）
• CS ：片选信号（通常需要单独GPIO控制）

对于ST7735/GC9306屏幕，还需要额外控制线：

硬件连接注意事项 ：

• 确认开发板供电能力，部分高分辨率屏幕需要额外供电
• 避免将控制信号线与高频信号线平行走线，减少干扰
• 对于长距离连接，建议在SCLK线上串联33Ω电阻以抑制振铃

提示：使用逻辑分析仪或示波器验证SPI信号质量可以节省大量调试时间。我曾在一个项目中因为SCLK信号振铃导致显示异常，最终通过缩短走线距离解决问题。

2. 设备树(DTS)深度配置

设备树是Linux内核识别硬件的关键。对于SPI设备，需要完成以下配置：

2.1 引脚控制组配置

首先在 pinctrl 节点中定义GPIO控制组：

&pinctrl {
    /* LCD控制信号 */
    gpio1-pc3 { /* CS */
        gpio1_pc3: gpio1-pc3 {
            rockchip,pins = <1 RK_PC3 RK_FUNC_GPIO &pcfg_pull_none>;
        };
    };
    gpio0-pa4 { /* 背光控制 */
        gpio0_pa4: gpio0-pa4 {
            rockchip,pins = <0 RK_PA4 RK_FUNC_GPIO &pcfg_pull_none>;
        };
    };
    gpio1-pd0 { /* DC */
        gpio1_pd0: gpio1-pd0 {
            rockchip,pins = <1 RK_PD0 RK_FUNC_GPIO &pcfg_pull_none>;
        };
    };
    gpio1-pd1 { /* 复位 */
        gpio1_pd1: gpio1-pd1 {
            rockchip,pins = <1 RK_PD1 RK_FUNC_GPIO &pcfg_pull_none>;
        };
    };

    spi0 {
        spi0m0_pins: spi0m