【STM32CubeMX学习指南---SPI之DMA】

使用STM32CubeMX生成SPI DMA工程的步骤

安装并启动STM32CubeMX
确保已安装最新版本的STM32CubeMX。启动软件后，选择目标STM32系列型号（如STM32F1），或通过“New Project”创建新项目。

配置SPI外设
在“Pinout & Configuration”标签页中，找到SPI模块（如SPI1、SPI2等）。将SPI模式设置为“Full-Duplex Master”或根据需求选择其他模式。
启用硬件NSS信号（如需从机选择）或使用软件NSS。配置时钟极性（CPOL）和相位（CPHA）以匹配外设时序要求。

启用DMA传输
在“DMA Settings”选项卡中，为SPI的发送（TX）和接收（RX）通道添加DMA请求。选择优先级（如“Medium”）和模式：

• 正常模式：单次传输后停止。
• 循环模式：持续传输（适用于连续数据流）。

确保DMA中断已启用（如“DMAx Channelx Global Interrupt”），以便处理传输完成事件。

时钟配置
在“Clock Configuration”标签页中，设置系统时钟（HCLK）和SPI外设时钟（APB1/APB2）。确保SPI时钟不超过其最大频率（参考芯片手册）。

生成代码
在“Project Manager”中设置项目名称、路径和IDE（如Keil、IAR或STM32CubeIDE）。勾选“Generate peripheral initialization as a pair of .c/.h files”以便模块化管理代码。
点击“Generate Code”生成工程文件。

关键代码示例

以下是生成的代码中需要关注的函数和配置：

SPI初始化（由CubeMX生成）

/* SPI1 init function */
void MX_SPI1_Init(void) {
  hspi1.Instance = SPI1;
  hspi1.Init.Mode = SPI_MODE_MASTER;
  hspi1.Init.Direction = SPI_DIRECTION_2LINES;
  hspi1.Init.DataSize = SPI_DATASIZE_8BIT;
  hspi1.Init.CLKPolarity = SPI_POLARITY_LOW;
  hspi1.Init.CLKPhase = SPI_PHASE_1EDGE;
  hspi1.Init.NSS = SPI_NSS_SOFT;
  hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_16;
  hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB;
  hspi1.Init.TIMode = SPI_TIMODE_DISABLE;
  hspi1.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;
  hspi1.Init.CRCPolynomial = 10;
  if (HAL_SPI_Init(&hspi1) != HAL_OK) {
    Error_Handler();
  }
}

DMA发送/接收数据

// 启动SPI DMA传输（发送+接收）
HAL_SPI_TransmitReceive_DMA(&hspi1, txBuffer, rxBuffer, bufferSize);

// DMA传输完成回调函数（需用户实现）
void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) {
  if (hspi == &hspi1) {
    // 处理接收到的数据
  }
}

常见问题解决

DMA传输不触发
检查DMA通道是否与SPI外设正确绑定，并确认NVIC中已启用DMA中断。验证时钟配置是否使能了DMA控制器时钟。

数据错位或丢失
调整SPI的CPOL/CPHA参数以匹配外设时序。确保DMA缓冲区地址对齐（如32位对齐），并检查缓冲区大小是否匹配。

循环模式下的数据覆盖
在循环模式中，DMA会持续覆盖缓冲区。如需实时处理数据，使用双缓冲区模式或半传输中断（HTIE）。