GD32F103实战：SPI+DMA高效数据搬运配置详解

1. 为什么需要SPIDMA在嵌入式开发中SPISerial Peripheral Interface是最常用的高速通信接口之一常用于连接Flash、显示屏、传感器等外设。但传统的SPI轮询或中断方式有个致命问题每传输一个字节都需要CPU介入当数据量达到KB级别时CPU会被完全拖垮。我曾在项目中遇到过这样的场景需要从SPI Flash读取一张800x480的图片数据采用轮询方式传输时CPU占用率直接飙到90%以上系统几乎无法响应其他任务。后来改用DMADirect Memory Access方案后CPU占用直接降到5%以下整个过程就像给SPI接口装上了自动驾驶系统。DMA的本质是硬件级的数据搬运工它能直接在存储器和外设之间搬运数据完全不需要CPU参与。具体到GD32F103的SPIDMA方案主要有三大优势零CPU占用数据传输全程由DMA控制器接管双工传输效率翻倍可同时配置发送和接收DMA通道硬件级稳定性避免因中断延迟导致的数据丢失注意GD32的DMA通道与STM32有所不同配置时务必参考官方《DMA请求映射表》2. GD32F103的SPI主模式配置2.1 硬件连接检查在开始写代码前先确认硬件连接。以SPI0为例对应GD32库中的SPI1典型引脚配置如下引脚功能引脚号配置模式CSPA4推挽输出SCKPA5复用推挽输出MOSIPA7复用推挽输出MISOPA6浮空输入这里有个坑点要注意GD32的SPI外设编号在时钟使能时从0开始计数如SPI0但在初始化函数中又从1开始计数如SPI1。我第一次移植STM32代码时就栽在这个细节上调试了半天才发现问题。2.2 初始化代码详解完整的SPI主模式初始化代码如下关键参数已用注释标注void SPI1Init(void) { GPIO_InitPara GPIO_InitStructure; SPI_InitPara SPI_InitStructure; // 开启GPIO和SPI时钟 rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_SPI0); // 注意这里是SPI0 // 配置SCK和MOSI为复用推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_PIN_5 | GPIO_PIN_7; GPIO_InitStructure.GPIO_Mode GPIO_MODE_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_SPEED_50MHZ; GPIO_Init(GPIOA, GPIO_InitStructure); // 配置MISO为浮空输入 GPIO_InitStructure.GPIO_Pin GPIO_PIN_6; GPIO_InitStructure.GPIO_Mode GPIO_MODE_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); // 配置CS引脚为推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_PIN_4; GPIO_InitStructure.GPIO_Mode GPIO_MODE_OUT_PP; GPIO_Init(GPIOA, GPIO_InitStructure); SPI1_CS_HIGH(); // 默认拉高CS // SPI参数配置 SPI_InitStructure.SPI_TransType SPI_TRANSTYPE_FULLDUPLEX; // 全双工模式 SPI_InitStructure.SPI_Mode SPI_MODE_MASTER; // 主模式 SPI_InitStructure.SPI_FrameFormat SPI_FRAMEFORMAT_8BIT; // 8位数据帧 SPI_InitStructure.SPI_SCKPL SPI_SCKPL_LOW; // 时钟极性 SPI_InitStructure.SPI_SCKPH SPI_SCKPH_1EDGE; // 时钟相位 SPI_InitStructure.SPI_SWNSSEN SPI_SWNSS_SOFT; // 软件控制CS SPI_InitStructure.SPI_PSC SPI_PSC_4; // 时钟预分频 SPI_InitStructure.SPI_FirstBit SPI_FIRSTBIT_MSB; // 高位先行 SPI_Init(SPI1, SPI_InitStructure); // 注意这里变成SPI1 SPI_Enable(SPI1, ENABLE); // 使能SPI }实测中发现当SPI时钟超过18MHz时需要将GPIO速度设置为50MHz以上否则会出现波形畸变。如果使用杜邦线连接建议将时钟降到10MHz以下。3. DMA通道配置实战3.1 DMA通道映射关系GD32F103的DMA通道与STM32有所不同以下是SPI0对应的DMA请求映射外设方向DMA0通道请求编号SPI0_TX发送通道31SPI0_RX接收通道22这个映射关系非常重要我曾经因为搞混通道号导致DMA无法触发后来在手册第23章找到了这张表才解决问题。3.2 双通道DMA初始化发送和接收需要分别配置DMA通道以下是完整配置代码void SPI1DMAInit(void) { DMA_InitPara DMA_InitStructure; rcu_periph_clock_enable(RCU_DMA0); // 发送DMA配置内存-SPI DMA_DeInit(DMA1_CHANNEL3); DMA_InitStructure.DMA_PeripheralBaseAddr (uint32_t)(SPI1-DTR); DMA_InitStructure.DMA_MemoryBaseAddr 0; // 动态设置 DMA_InitStructure.DMA_DIR DMA_DIR_PERIPHERALDST; DMA_InitStructure.DMA_BufferSize 0; DMA_InitStructure.DMA_PeripheralInc DMA_PERIPHERALINC_DISABLE; DMA_InitStructure.DMA_MemoryInc DMA_MEMORYINC_ENABLE; DMA_InitStructure.DMA_PeripheralDataSize DMA_PERIPHERALDATASIZE_BYTE; DMA_InitStructure.DMA_MemoryDataSize DMA_MEMORYDATASIZE_BYTE; DMA_InitStructure.DMA_Mode DMA_MODE_NORMAL; DMA_InitStructure.DMA_Priority DMA_PRIORITY_MEDIUM; DMA_Init(DMA1_CHANNEL3, DMA_InitStructure); // 接收DMA配置SPI-内存 DMA_DeInit(DMA1_CHANNEL2); DMA_InitStructure.DMA_DIR DMA_DIR_PERIPHERALSRC; DMA_InitStructure.DMA_BufferSize 0; DMA_Init(DMA1_CHANNEL2, DMA_InitStructure); DMA_ClearIntBitState(DMA1_INT_TC2 | DMA1_INT_TC3); }关键点说明发送方向配置为DMA_DIR_PERIPHERALDST内存到外设接收方向配置为DMA_DIR_PERIPHERALSRC外设到内存内存地址递增必须开启否则只能传输首字节传输数据宽度建议保持字节单位避免对齐问题4. 双工传输的内存管理策略4.1 传输启动函数实现SPI是全双工接口发送和接收是同步进行的。以下是经过实战验证的传输函数void SPI1DMATransfer(uint8_t *tx_buf, uint8_t *rx_buf, uint16_t len) { // 禁用DMA通道 DMA_Enable(DMA1_CHANNEL3, DISABLE); DMA_Enable(DMA1_CHANNEL2, DISABLE); // 等待通道就绪 while(DMA_GetCmdStatus(DMA1_CHANNEL3)); while(DMA_GetCmdStatus(DMA1_CHANNEL2)); // 配置发送通道 DMA_SetCurrDataCounter(DMA1_CHANNEL3, len); DMA_MemoryTargetConfig(DMA1_CHANNEL3, (uint32_t)tx_buf); // 配置接收通道 DMA_SetCurrDataCounter(DMA1_CHANNEL2, len); DMA_MemoryTargetConfig(DMA1_CHANNEL2, (uint32_t)rx_buf); // 使能SPI DMA请求 SPI_I2S_DMA_Enable(SPI1, SPI_I2S_DMA_TX, ENABLE); SPI_I2S_DMA_Enable(SPI1, SPI_I2S_DMA_RX, ENABLE); // 启动DMA传输 DMA_Enable(DMA1_CHANNEL3, ENABLE); DMA_Enable(DMA1_CHANNEL2, ENABLE); // 等待传输完成 while(!DMA_GetIntBitState(DMA1_INT_TC2)); DMA_ClearIntBitState(DMA1_INT_TC2); while(!DMA_GetIntBitState(DMA1_INT_TC3)); DMA_ClearIntBitState(DMA1_INT_TC3); }4.2 内存地址的巧妙设计在实际项目中我发现可以优化内存使用当只需要发送数据时接收缓冲区可以用临时变量当只需要接收数据时发送缓冲区可以填充哑元数据。例如// 仅发送模式 uint8_t tx_data[256]; SPI1DMATransfer(tx_data, (uint8_t*)dummy, 256); // 仅接收模式 uint8_t rx_data[256]; memset(tx_dummy, 0xFF, sizeof(tx_dummy)); SPI1DMATransfer(tx_dummy, rx_data, 256);这种设计在读写SPI Flash时特别有用既能节省内存又能保证时序正确。5. 常见问题与解决方案5.1 DMA传输不触发可能原因及解决方法时钟未开启检查是否调用了rcu_periph_clock_enable(RCU_DMA0)通道映射错误对照手册确认SPI对应的DMA通道号SPI未使能DMA请求检查是否调用了SPI_I2S_DMA_Enable缓冲区地址未对齐确保内存地址是4字节对齐的5.2 数据错位问题如果发现接收数据总是错位一位可能是时钟相位配置问题。建议检查SPI_SCKPH参数是否符合外设要求用逻辑分析仪捕获SPI波形确认时钟边沿尝试调整SPI_PSC降低时钟频率5.3 大数据量传输稳定性传输超过1KB数据时建议使用DMA_MODE_CIRCULAR循环模式启用DMA半传输和完成中断采用双缓冲机制ping-pong buffer我在驱动SPI屏时就采用了循环DMA双缓冲的方案即使传输1920x1080的图像数据也能稳定运行。关键是要合理设置DMA优先级避免被其他高优先级DMA通道打断。