CH32V307 SPI主从机通信避坑指南：从单机发送到双机互传的完整配置流程

CH32V307 SPI主从机通信实战：从硬件配置到双机互传的完整解决方案

在嵌入式开发中，SPI通信因其高速、全双工的特性成为设备间数据交换的首选方案之一。沁恒微电子的CH32V307作为RISC-V架构的高性能MCU，其SPI外设功能强大但配置细节较多，尤其在主从机双向通信场景下，开发者常会遇到数据收发异常、时序错乱等问题。本文将深入剖析两块CH32V307开发板通过SPI进行双向数据互传的全流程，覆盖硬件连接、模式选择、时序同步等关键环节。

1. 硬件架构设计与初始化配置

实现SPI主从通信的第一步是正确配置硬件连接。CH32V307的SPI接口通常位于GPIOA或GPIOB端口，具体引脚分配需参考芯片数据手册。两块开发板间的物理连接必须遵循以下对应关系：

• 主机MOSI（PA7） ↔ 从机MOSI（PB15）
• 主机MISO（PA6） ↔ 从机MISO（PB14）
• 主机SCK（PA5） ↔ 从机SCK（PB13）
• 主机NSS（PA4） ↔ 从机NSS（PB12）

注意：实际布线时应尽量缩短连线长度，避免信号反射导致通信失败。对于长距离通信，建议加入终端电阻匹配阻抗。

主机端GPIO初始化需要特别注意各引脚的工作模式差异：

// 主机SPI1初始化示例 void SPI1_Master_Init(void) { RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); GPIO_InitTypeDef GPIO_InitStructure = {0}; // NSS引脚配置为普通推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); // 初始状态置高 // SCK和MOSI配置为复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; 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); }

从机端配置与主机存在关键差异点：

2. 主从模式参数协同配置

SPI通信的稳定性很大程度上取决于主从设备参数的一致性。CH32V307的SPI初始化结构体中有几个关键参数必须严格匹配：

// 主机SPI初始化参数 SPI_InitTypeDef SPI_InitStructure = {0}; SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; // 必须与从机相同 SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge; // 必须与从机相同 SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_32; SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(SPI1, &SPI_InitStructure);

从机配置中需要特别关注以下几点：

• NSS模式：建议使用硬件模式（SPI_NSS_Hard），由硬件自动检测片选信号
• 时钟参数：CPOL和CPHA必须与主机完全一致
• 数据对齐：FirstBit设置应与主机匹配（通常都选择MSB先行）

常见配置错误导致的症状分析：

1. 数据全为0xFF或0x00

   • 检查MISO/MOSI接线是否交叉连接
   • 确认从机是否已正确初始化并供电

2. 数据高位或低位丢失

   • 核对SPI_FirstBit设置是否一致
   • 检查时钟极性(CPOL)和相位(CPHA)配置

3. 间歇性通信失败

   • 降低SPI时钟频率（增大BaudRatePrescaler值）
   • 检查硬件连接是否接触不良

3. 全双工通信的读写同步机制

SPI全双工模式下，数据收发是同步进行的，这要求开发者理解"假写"操作的必要性。当主机需要读取从机数据时，必须通过写入数据来产生时钟信号，这个写入的数据内容通常无关紧要（常用0xFF或0x00）。

典型的主从数据交换流程：

1. 主机拉低NSS信号启动通信
2. 主机发送第一个字节（触发时钟）
3. 从机在第一个时钟周期返回预置数据
4. 主机发送后续字节同时接收从机数据
5. 主机拉高NSS信号结束通信

// 主机端数据交换示例 uint8_t SPI_ExchangeByte(uint8_t txData) { while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) == RESET); // 等待发送缓冲区空 SPI_I2S_SendData(SPI1, txData); // 写入数据触发时钟 while(SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) == RESET); // 等待接收完成 return SPI_I2S_ReceiveData(SPI1); // 读取接收到的数据 } // 从机端数据准备 void SPI2_IRQHandler(void) { if(SPI_I2S_GetITStatus(SPI2, SPI_I2S_IT_TXE) != RESET) { SPI_I2S_SendData(SPI2, slaveTxBuffer[txIndex++]); // 填充待发送数据 } if(SPI_I2S_GetITStatus(SPI2, SPI_I2S_IT_RXNE) != RESET) { slaveRxBuffer[rxIndex++] = SPI_I2S_ReceiveData(SPI2); // 存储接收数据 } }

关键点：主机每次读取操作必须伴随写入操作，否则无法产生时钟信号。建议将读写操作封装成统一接口，确保时序一致性。

4. 调试技巧与性能优化

完成基础通信后，可通过以下方法验证系统可靠性并提升性能：

逻辑分析仪抓包分析

• 设置采样率至少为SPI时钟频率的4倍以上
• 触发条件设为NSS信号下降沿
• 重点检查时钟边沿与数据变化的对应关系

串口打印调试信息

printf("Sent: 0x%02X, Received: 0x%02X\n", txData, rxData);

SPI时钟优化方案

DMA传输配置对于大数据量传输，建议启用DMA减轻CPU负担：

// 主机DMA初始化示例 DMA_InitTypeDef DMA_InitStructure; RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); // 发送DMA配置 DMA_DeInit(DMA1_Channel3); DMA_InitStructure.DMA_PeripheralBaseAddr = (uint32_t)&SPI1->DATAR; DMA_InitStructure.DMA_MemoryBaseAddr = (uint32_t)txBuffer; DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralDST; DMA_InitStructure.DMA_BufferSize = BUFFER_SIZE; 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_High; DMA_InitStructure.DMA_M2M = DMA_M2M_Disable; DMA_Init(DMA1_Channel3, &DMA_InitStructure); // 启用SPI DMA请求 SPI_I2S_DMACmd(SPI1, SPI_I2S_DMAReq_Tx, ENABLE);

在实际项目中遇到SPI通信不稳定时，可尝试以下排查步骤：

1. 首先降低SPI时钟频率验证基础功能
2. 用示波器检查NSS、SCK信号质量
3. 确认电源稳定性，必要时增加去耦电容
4. 检查代码中是否有不当的中断抢占导致时序错乱