1. 开篇:为什么要在Luckfox Pico上折腾SPI LCD?
如果你手头有一块Luckfox Pico开发板,又恰好从某宝淘来了一块小巧的SPI接口LCD屏幕,比如常见的ST7735或者GC9306,那么你很可能正面临一个经典问题:怎么让这块屏幕在板子上亮起来,并且能显示点东西?我刚开始玩Luckfox的时候,也卡在这个环节好几天。官方SDK对这类小屏的支持并不直接,网上资料也零零散散,不是针对树莓派就是其他平台,直接拿来用总会遇到各种水土不服。
其实,核心思路就是为Linux内核添加对应的Framebuffer驱动,也就是我们常说的fbtft驱动。这听起来有点吓人,感觉要深入内核源码。但别怕,我折腾下来发现,整个过程更像是在玩一个“配置拼图”游戏。你需要做的,主要是修改设备树(DTS)来描述硬件连接,然后在内核配置里把对应的驱动选项打开,最后再根据屏幕型号微调一下初始化序列。一旦跑通,系统里就会出现一个/dev/fb0设备,之后无论是用cat /dev/urandom > /dev/fb0测试花屏,还是用LVGL这种图形库来绘制复杂的UI,都有了坚实的基础。
这篇文章,我就以手头一块ST7735(1.44寸,128x160)和一块GC9306(2.0寸,240x320)的屏幕为例,带你完整走一遍从硬件引脚确认、设备树修改、内核驱动配置与编译,到最终上电测试的全过程。我会把过程中踩过的坑、需要注意的细节都讲清楚,目标是让你看完就能动手,把自己的屏幕点亮。咱们不搞那些虚的理论,直接上干货。
2. 硬件连接与引脚规划:你的屏幕怎么接?
动手改软件之前,硬件连接必须百分百确定。这是所有后续工作的基石,接错了线,代码调上天也没用。
2.1 理解SPI LCD的必备信号线
一块典型的SPI接口LCD(区别于并口RGB屏),除了电源和地,核心信号线通常有这几根:
- SCK (SPI Clock):时钟线,由主设备(Luckfox)产生。
- MOSI (Master Out Slave In):主设备输出,从设备输入,也就是数据线。
- CS (Chip Select):片选线,低电平有效,用于选中当前这块SPI从设备。当总线上有多个设备时,靠它来区分。
- DC (Data/Command):数据/命令选择线。这是控制LCD的一个关键引脚。发送命令(如设置显示区域、旋转方向)时,需要拉低;发送像素数据时,需要拉高。
- RES (Reset):复位线,低电平复位屏幕控制器。上电后通常需要一个复位序列来确保屏幕处于已知状态。
- BL (Backlight):背光控制。可以是简单的GPIO高低电平控制开关,也可以是PWM引脚控制亮度。
我的ST7735和GC9306屏幕模块都使用了这6根信号线。你需要根据你的屏幕原理图或商品描述,确认好每一根线对应的功能。
2.2 Luckfox Pico的引脚分配策略
Luckfox Pico的引脚资源比较紧张,很多引脚是复用的。我们的目标是把这些LCD信号线,合理地“映射”到开发板的物理引脚上,并且不能和其他重要功能(如调试串口)冲突。
我选择的方案是使用 SPI0 这个硬件SPI控制器,因为它性能稳定。查看Luckfox Pico的原理图和数据手册,SPI0对应的引脚是:
- SPI0_CLK_M0: GPIO1_C1
- SPI0_MOSI_M0: GPIO1_C2
- SPI0_MISO_M0: GPIO1_C3
这里有个小技巧:对于只写的LCD屏幕,MISO(主设备输入)线其实是用不到的。我们可以把它“废物利用”,配置为一个普通的GPIO,用来作为LCD的片选(CS)信号。这样既节省了一个GPIO,又让所有LCD控制线在逻辑上更集中。
其他控制引脚,我选择了附近空闲的GPIO:
- DC: GPIO1_D0
- RES: GPIO1_D1
- BL (背光): GPIO0_A4
这样,我们一共使用了6个GPIO,其中3个属于SPI0硬件控制器,3个是普通GPIO。接线时,务必对照开发板的丝印,把屏幕的这6根线一一对应焊好或者用杜邦线连接牢固。硬件连接确认无误后,我们就可以进入关键的软件配置阶段了。
3. 修改设备树:告诉内核硬件长什么样
设备树(Device Tree)是Linux内核用来描述硬件拓扑结构的一种数据格式。简单说,它就是一份写给内核看的“硬件接线说明书”。我们需要修改它,告诉内核:“嘿,我们的SPI0上挂了一个LCD设备,它的CS、DC、RES、BL引脚分别是哪几个。”
3.1 定位并备份你的设备树文件
Luckfox的SDK中,设备树源文件(.dts)通常位于 sysdrv/source/kernel/arch/arm/boot/dts/ 目录下。对于Luckfox Pico,核心文件是 rv1103g-luckfox-pico.dts(也可能是类似名称)。在修改前,强烈建议先复制一份备份,这是避免翻车的好习惯。
cd sysdrv/source/kernel/arch/arm/boot/dts/
cp rv1103g-luckfox-pico.dts rv1103g-luckfox-pico.dts.backup
3.2 编写LCD相关的设备树节点
修改设备树是移植工作的核心。我们需要做两件事:1) 定义用到的GPIO引脚;2) 在SPI0控制器下添加LCD设备节点。下面是我修改后的关键部分,我加了详细注释,你可以对照理解:
// 首先,在根节点`/`下,为我们用作普通GPIO的引脚定义节点。
// 这些节点将引脚声明为“始终开启”的固定调节器,是一种常见的GPIO控制方式。
/ {
/* LCD_CS -- 复用原本的SPI0_MISO引脚 (GPIO1_C3) */
gpio1pc3: gpio1pc3 {
compatible = "regulator-fixed";
pinctrl-names = "default";
pinctrl-0 = <&gpio1_pc3>;
regulator-name = "gpio1_pc3";
regulator-always-on; // 保持一直有效
};
/* LCD_BL -- 背光控制 (GPIO0_A4) */
gpio0pa4: gpio0pa4 {
c
439



被折叠的 条评论
为什么被折叠?



