保姆级教程：在华大HC32L136上驱动SPI屏，用DMA发送数据的完整配置流程

华大HC32L136 SPI屏DMA驱动实战：从零构建高效显示引擎

1. 项目背景与硬件选型思考

在嵌入式显示方案中，SPI接口的LCD/OLED屏幕因其接线简单、占用IO少等优势，成为中小尺寸屏的首选。而国产MCU的崛起，为开发者提供了更具性价比的解决方案。华大半导体的HC32L136以其低功耗特性与丰富的外设资源，特别适合对能耗敏感的显示终端设备。

选择这款MCU驱动SPI屏幕时，开发者常面临三个核心挑战：

• 数据传输效率：屏幕刷新需要持续发送大量像素数据
• 系统资源占用：传统轮询方式会阻塞CPU运行
• 时序稳定性：特别是CS信号与最后字节的同步问题

通过DMA（直接内存访问）技术，可以实现后台数据传输，将CPU从繁重的搬运工作中解放出来。但在实际项目中，我们发现华大MCU的SPI+DMA组合存在一些特殊注意事项：

关键发现：官方手册对触发方式的描述存在歧义，实测硬件触发才是可靠方案

2. 硬件架构与引脚配置

2.1 最小系统搭建

先准备以下硬件组件：

• HC32L136开发板
• SPI接口显示屏（如ST7789驱动的240x240 LCD）
• 杜邦线若干
• 逻辑分析仪（用于调试时序）

典型连接方式：

2.2 GPIO初始化代码实现

// 引脚定义 #define LCD_CS_PORT GpioPortA #define LCD_CS_PIN GpioPin4 #define LCD_SCK_PORT GpioPortA #define LCD_SCK_PIN GpioPin5 #define LCD_MOSI_PORT GpioPortA #define LCD_MOSI_PIN GpioPin7 void GPIO_Configuration(void) { stc_gpio_cfg_t gpioCfg; // 结构体初始化为默认值 DDL_ZERO_STRUCT(gpioCfg); // 开启GPIO时钟 Sysctrl_SetPeripheralGate(SysctrlPeripheralGpio, TRUE); // 配置CS引脚 gpioCfg.enDir = GpioDirOut; gpioCfg.enDrv = GpioDrvH; Gpio_Init(LCD_CS_PORT, LCD_CS_PIN, &gpioCfg); // 配置SCK和MOSI为复用功能 Gpio_SetAfMode(LCD_SCK_PORT, LCD_SCK_PIN, GpioAf1); Gpio_SetAfMode(LCD_MOSI_PORT, LCD_MOSI_PIN, GpioAf1); }

3. SPI与DMA协同配置详解

3.1 SPI主机模式设置

SPI配置需要特别注意时钟极性与相位，必须与屏幕规格书保持一致。以下是240x240 LCD的典型配置：

void SPI_InitConfiguration(void) { stc_spi_cfg_t spiCfg; // 开启SPI1时钟 Sysctrl_SetPeripheralGate(SysctrlPeripheralSpi1, TRUE); // 主机模式配置 DDL_ZERO_STRUCT(spiCfg); spiCfg.enSpiMode = SpiMskMaster; spiCfg.enPclkDiv = SpiClkMskDiv4; // 系统时钟4分频 spiCfg.enCPOL = SpiMskCpolLow; // 时钟极性 spiCfg.enCPHA = SpiMskCphaseEdge1; // 第一边沿采样 Spi_Init(M0P_SPI1, &spiCfg); // 启用SPI DMA发送功能 Spi_FuncEnable(M0P_SPI1, SpiMskDmaTxEn); }

3.2 DMA传输核心参数

DMA配置是项目成功的关键，华大MCU的DMA控制器支持多种传输模式，但在SPI场景下需要特别注意：

void DMA_InitForSPI(void) { stc_dma_cfg_t dmaCfg; extern uint8_t displayBuffer[240*240*2]; // 显示缓冲区 // 开启DMA时钟 Sysctrl_SetPeripheralGate(SysctrlPeripheralDma, TRUE); DDL_ZERO_STRUCT(dmaCfg); dmaCfg.enMode = DmaMskBlock; // 块传输模式 dmaCfg.u16BlockSize = 1; // 每次传输1个数据单元 dmaCfg.u16TransferCnt = sizeof(displayBuffer); // 总传输次数 dmaCfg.enTransferWidth = DmaMsk8Bit; // 8位传输 dmaCfg.enSrcAddrMode = DmaMskSrcAddrInc; // 源地址递增 dmaCfg.enDstAddrMode = DmaMskDstAddrFix; // 目标地址固定(SPI数据寄存器) dmaCfg.enRequestNum = DmaSPI1TXTrig; // SPI1发送硬件触发 dmaCfg.u32SrcAddress = (uint32_t)displayBuffer; dmaCfg.u32DstAddress = (uint32_t)&(M0P_SPI1->DATA); // 初始化DMA通道1 Dma_InitChannel(DmaCh1, &dmaCfg); Dma_Enable(); }

重要提示：务必选择硬件触发(DmaSPI1TXTrig)，软件触发在连续传输时会出现数据丢失

4. 实战中的疑难问题解决

4.1 最后一个字节传输异常

这是华大MCU的一个已知问题现象：当DMA传输完成中断触发后，最后一个字节可能尚未完全送出。解决方法是在拉高CS前插入微小延时：

void SendFrameToDisplay(void) { M0P_SPI1->SSN = FALSE; // 拉低CS // 启动DMA传输 Dma_EnableChannel(DmaCh1); // 等待传输完成 while(Dma_GetStat(DmaCh1) != DmaTransferComplete); delay10us(1); // 关键延时 M0P_SPI1->SSN = TRUE; // 拉高CS }

4.2 屏幕初始化序列发送

不同屏幕需要特定的初始化命令序列，建议封装为专用函数：

void LCD_InitSequence(void) { static const uint8_t initCmd[] = { 0x01, 0x02, 0x03, // 示例命令，需替换为实际值 // ...更多初始化命令 }; // 临时禁用DMA，使用轮询方式发送初始化命令 Spi_FuncDisable(M0P_SPI1, SpiMskDmaTxEn); M0P_SPI1->SSN = FALSE; for(int i=0; i<sizeof(initCmd); i++) { while(!Spi_GetStatus(M0P_SPI1, SpiMskTxEmpty)); Spi_WriteData(M0P_SPI1, initCmd[i]); } M0P_SPI1->SSN = TRUE; // 重新启用DMA Spi_FuncEnable(M0P_SPI1, SpiMskDmaTxEn); }

5. 性能优化与高级应用

5.1 双缓冲技术实现

为避免屏幕撕裂现象，可采用双缓冲机制：

uint8_t frameBuffer[2][SCREEN_BUFFER_SIZE]; volatile uint8_t activeBuffer = 0; void SwapBuffers(void) { // 等待当前传输完成 while(Dma_GetStat(DmaCh1) == DmaTransferInProgress); // 切换活跃缓冲区 activeBuffer ^= 1; // 更新DMA源地址 Dma_SetSrcAddress(DmaCh1, (uint32_t)frameBuffer[activeBuffer]); }

5.2 动态刷新率控制

根据不同场景调整刷新频率可以显著降低功耗：

void SetRefreshRate(uint16_t fps) { uint32_t interval = 1000 / fps; // 毫秒间隔 // 配置定时器中断 // ...定时器初始化代码 // 在定时器中断中触发刷新 // 注意：需确保前一次传输已完成 }

6. 系统集成与调试技巧

6.1 逻辑分析仪抓包分析

建议使用Saleae逻辑分析仪检查SPI时序，重点关注：

• CS信号与数据的关系
• 时钟极性和相位
• 数据传输间隔

6.2 常见问题排查表

在项目后期，我们还可以考虑加入帧率统计功能，实时监控系统性能：

uint32_t frameCount = 0; uint32_t lastTick = 0; void FrameRateMonitor(void) { frameCount++; uint32_t current = GetSystemTick(); if(current - lastTick >= 1000) { printf("FPS: %d\n", frameCount); frameCount = 0; lastTick = current; } }