当前位置：首页 > news >正文

基于沁恒CH32V307的SPI TFT屏驱动移植：从官方库到逐飞框架的适配实战

news 2026/5/23 17:04:19

1. 项目背景与硬件选型

最近在做一个机器人项目，需要一块大尺寸显示屏作为"人脸"交互界面。在淘宝上逛了一圈，最终选择了4.0英寸的SPI串口TFT液晶屏。这种屏幕性价比高，接口简单，特别适合嵌入式开发场景。不过在实际开发中遇到了一个典型问题：官方提供的驱动库和我们使用的开发环境不兼容。

我们选用的主控芯片是沁恒微电子的CH32V307，这是一款基于RISC-V架构的32位MCU，性能不错而且价格亲民。开发环境用的是逐飞科技的库配合MounRiver Studio。这个组合在实际项目中挺常见的，但问题在于官方提供的例程主要是针对CH32F1、F2系列，而且用的是标准库，和我们的开发框架存在不少差异。

2. 移植前的准备工作

2.1 硬件连接规划

在开始移植前，首先要理清楚硬件连接。我采用的引脚分配方案如下：

电源部分：

VCC → 5V/3.3V
GND → GND

数据线部分：

SDI(MOSI) → PA7
SDO(MISO) → 悬空（因为不需要读取屏幕数据）

控制线部分：

LED → PD0（背光控制）
SCK → PA5
LCD_RS → PD7（数据/命令选择）
LCD_RST → PB7（复位）
LCD_CS → PD4（片选）

这种分配方案主要考虑了以下几点：

SPI外设的引脚复用功能
GPIO的分布均匀性
后续可能的扩展需求

2.2 工程文件准备

从官方demo中提取了以下关键文件：

lcd.c/.h：屏幕驱动核心
FONT.h：字库文件
GUI.c/.h：简单图形界面
test.c/.h：测试用例

把这些文件添加到MounRiver工程后，不出所料地出现了一大堆编译错误。主要问题集中在SPI和GPIO的接口差异上，这正是我们需要重点解决的部分。

3. SPI驱动适配实战

3.1 SPI函数对比分析

官方库提供了三个关键SPI函数：

u8 SPI_WriteByte(SPI_TypeDef* SPIx,u8 Byte)
void SPI1_Init(void)
void SPI_SetSpeed(SPI_TypeDef* SPIx,u8 SpeedSet)

而逐飞库的SPI接口设计完全不同，我们需要逐个适配。

3.1.1 数据写入函数改造

官方库的SPI_WriteByte有返回值，而逐飞的spi_write_8bit没有返回值。我的解决方案是：

u8 SPI_WriteByte(spi_index_enum spi_n, uint8_t data) { uint8_t spi_write_8bit(spi_n, data); return ((SPI_TypeDef *)(spi_index[spi_n]))->DATAR; }

这种封装方式有个好处：不需要修改lcd.c中大量调用SPI_WriteByte的地方，只需要调整参数类型即可。

3.1.2 SPI初始化适配

官方库的初始化非常简单，而逐飞库提供了更丰富的参数配置：

// 原调用 SPI1_Init(); // 新调用 spi_init(SPI_1, 0, 10*1000*1000, SPI1_SCK_A5, SPI1_MOSI_A7, SPI1_MISO_A6, D4);

这里有几个关键参数需要注意：

模式选择0（SPI模式0）
波特率设置为10MHz（实际测试发现这个值对刷新率影响很大）
明确指定了每个功能引脚

3.1.3 速度设置函数实现

逐飞库没有直接提供SPI速度设置函数，需要自己实现：

void SPI_SetSpeed(spi_index_enum SPIx, uint8_t SpeedSet) { uint32_t spi_baudrate_div; if(SpeedSet == 1) { spi_baudrate_div = SPI_BaudRatePrescaler_2; } else { spi_baudrate_div = SPI_BaudRatePrescaler_8; } switch(SPIx) { case SPI_1: SPI1->CTLR1 |= spi_baudrate_div; break; case SPI_2: SPI2->CTLR1 |= spi_baudrate_div; break; default: break; } }

这个实现完美复现了官方库的功能逻辑，1表示二分频，其他值为八分频。

4. LCD驱动深度适配

4.1 引脚定义修改

根据实际硬件连接，需要修改lcd.h中的引脚定义：

#define LED D0 // 背光控制 #define LCD_CS D4 // 片选 #define LCD_RS D7 // 数据/命令选择 #define LCD_RST B7 // 复位

4.2 GPIO操作优化

官方库使用了位带操作来实现快速GPIO控制，但RISC-V架构不支持这个特性。我的解决方案是：

typedef struct { uint32_t bit0 :1; uint32_t bit1 :1; // ...省略中间位... uint32_t bit31 :1; } GPIO_REG; #define PDout(n) (((GPIO_REG *)(&(GPIOD->OUTDR)))->bit##n) #define LCD_LED PDout(0) // 背光控制

这种位域结构体模拟的方式虽然效率略低于真正的位带操作，但在大多数应用场景下已经足够。

4.3 初始化函数简化

使用逐飞库后，GPIO初始化变得异常简单：

void LCD_GPIOInit(void) { gpio_init(D0, GPO, 0, GPIO_PIN_CONFIG); gpio_init(D4, GPO, 0, GPIO_PIN_CONFIG); gpio_init(D7, GPO, 0, GPIO_PIN_CONFIG); gpio_init(B7, GPO, 0, GPIO_PIN_CONFIG); LCD_LED=1; // 默认点亮背光 }

不需要手动开启时钟，也不需要配置复杂的结构体，一行代码就搞定一个引脚。