首页/资讯中心/详情

STM32 SPI从机模式+DMA双机通信实战：配置、协议与避坑指南

STM32 SPI从机模式+DMA双机通信实战：配置、协议与避坑指南
📅 发布时间：2026/7/31 16:17:54

1. 从“主”到“从”：一个被忽视的SPI应用场景

在嵌入式开发圈子里，一提到STM32的SPI，大家脑子里蹦出来的第一个应用场景大概率是驱动外设：SPI Flash、TFT屏幕、无线模块、各类传感器……在这些场景里，STM32稳坐“主机”宝座，掌控着时钟（SCK）的生杀大权，指挥着数据的流动。主机模式下的配置、DMA传输、中断处理，相关的教程和代码示例铺天盖地，几乎成了每个STM32开发者的必修课。

但不知道你有没有遇到过这样的需求：两块STM32之间需要高速、全双工地交换数据，I2C太慢，UART又占用了宝贵的串口资源，或者需要同步时钟。这时候，SPI的双机通信就成了一个非常优雅的解决方案。然而，一旦涉及到让其中一块STM32扮演“从机”角色，很多人的经验就瞬间清零了。网上的资料也呈现出一种“冰火两重天”的态势：主机模式的资料汗牛充栋，而从机模式，尤其是稳定、高效、带DMA的从机模式，相关的深入讨论和避坑指南却少得可怜。

我自己就在一个数据采集项目中踩过这个坑。项目里，一块STM32F4作为前端传感器数据采集单元（从机），需要将实时采集的AD数据高速发送给另一块负责复杂算法处理和网络上传的STM32H7（主机）。最初尝试用查询方式做从机发送，结果不是丢数据就是程序被“卡死”在等待标志位上，主机时钟一停，从机就“傻等”。后来改用中断，虽然有所改善，但在大数据量连续传输时，中断开销又成了瓶颈，CPU利用率居高不下。最终，经过一番折腾，才把SPI从机+DMA这套组合拳打通。

今天，我就把自己从“主机思维”切换到“从机实战”过程中积累的经验、踩过的坑，以及如何结合DMA实现高效、稳定的双机SPI通信，系统地梳理出来。如果你正在或即将面临类似的需求，希望这篇内容能帮你少走弯路。

2. SPI从机模式的本质：被动响应与同步之舞

要玩转SPI从机，首先得从根上理解它和主机模式的核心差异。这不是简单的配置参数改动，而是工作哲学的根本不同。

2.1 时钟主权与数据流控制

在SPI协议中，SCK时钟信号由主机独家产生，这是主机权力的象征。对于从机而言，SCK是一个纯粹的输入信号。这意味着：

  • 从机无法发起通信：从机不能主动产生一个时钟周期来发送或请求数据。它的一切行为都必须等待主机发出的SCK边沿来触发。
  • 从机必须严格同步：从机的内部移位寄存器必须在主机SCK的驱动下，与主机保持严格的位同步。主机发一个脉冲，双方就各自移出一位，移入一位。

这种“被动性”是理解所有从机模式问题的基石。你的从机代码逻辑，必须建立在“响应主机时钟”这一前提下，而不是试图去“控制”或“预测”通信流程。

2.2 STM32 SPI从机硬件架构要点

以STM32F4/H7系列常见的SPI外设为例，在从机模式下，以下几个硬件特性需要特别关注：

  1. NSS引脚（片选）的角色变化：

    • 在主机模式下，NSS通常可以配置为软件管理或作为通用输出引脚去控制外部从器件的片选。
    • 在从机模式下，NSS必须被硬件管理（Hardware Slave Select Management）。这意味着NSS引脚必须配置为输入模式，并由外部的主机来控制其电平。当NSS为低电平时，本设备被选为从机，SPI接口激活；当NSS为高时，SPI接口被禁用，通常也会复位内部状态。这是一个极易配置错误的点，如果配置成软件管理，从机可能根本无法正常工作。

  2. 数据寄存器（DR）与移位寄存器的交互：

    • 当主机发起传输，SCK开始跳动时，从机的移位寄存器就开始工作。如果从机需要发送数据，它必须在主机SCK驱动第一个边沿到来之前，将待发送的数据写入发送缓冲区（TXE标志置1后写入DR寄存器）。写入DR的数据会被立即或很快加载到移位寄存器中，等待SCK移出。
    • 对于接收数据，从机在SCK驱动下将MOSI线上的数据移入移位寄存器，当收到一个完整的数据帧（比如8位或16位）后，接收缓冲区非空（RXNE标志置1），数据可以从DR寄存器中读取。
    • 关键点：从机的“发送”和“接收”在硬件层面是同时进行的（全双工）。即使你只想接收，也必须写入一个“哑元数据”（Dummy Data）到DR寄存器以产生SCK时钟（实际上SCK由主机产生，但主机需要从机在MISO线上给出电平，这个电平就来自哑元数据）。反之亦然。

  3. 时钟极性（CPOL）与相位（CPHA）的从机视角：

    • CPOL/CPHA决定了数据在SCK的哪个边沿被采样和更新。从机的CPOL和CPHA配置必须与主机严格一致，否则读到的将是乱码。这一点和主机模式要求一样，但在双机通信中，因为两端都是可编程的MCU，更容易因疏忽而导致配置不匹配。

理解了这些本质，我们就能明白，编写SPI从机程序的核心思想是：提前准备好要发送的数据，并时刻准备好在主机时钟的驱动下完成发送和接收，同时通过中断或DMA及时处理接收到的数据和准备下一帧要发送的数据。

3. 从机模式配置详解：从CubeMX到代码

理论说再多，不如一行配置。我们以STM32CubeMX工具配合HAL库为例，一步步拆解一个SPI从机的配置过程。这里假设我们使用SPI1，目标是与另一块STM32主机进行全双工16位数据通信。

3.1 CubeMX图形化配置

  1. 模式选择：在Pinout & Configuration标签页，找到SPI1。将Mode设置为Full-Duplex Slave。注意，这里没有“Transmit Only Slave”或“Receive Only Slave”，全双工是硬件基础。
  2. 硬件NSS管理：将Hardware NSS Signal设置为Hardware NSS Input。这个选项至关重要，它决定了NSS引脚的模式。通常，你会看到SS引脚（比如PA4）被自动配置为输入模式。
  3. 基本参数：
    • Frame Format:Motorola。
    • Data Size: 根据需求选择，例如16 Bits。注意主机和从机必须相同。
    • First Bit: 通常选择MSB First。
    • Clock Polarity和Clock Phase: 这里必须和你的主机配置一模一样！假设主机配置为Low和1 Edge，那么这里就选Low和1 Edge。一个记忆方法是看主机空闲时SCK的电平（CPOL）和在第几个边沿采样数据（CPHA）。
  4. CRC计算与NSSP脉冲模式：在从机模式下，除非协议特殊要求，通常关闭CRC计算（CRC Calculation->Disable）。NSS Pulse Mode也通常禁用，它用于在多从机系统中，每次传输后产生一个NSS脉冲，在标准双机通信中一般不需要。
  5. DMA配置（关键步骤）：
    • 点击DMA Settings标签页。
    • 点击Add添加DMA请求。对于SPI从机，我们需要两个DMA流/通道：一个用于发送（SPI1_TX），一个用于接收（SPI1_RX）。
    • 发送DMA（TX）配置：
      • Mode:Normal或Circular。如果数据是连续、循环发送的（如实时音频、传感器流），用Circular；如果是定长数据块，用Normal。
      • Increment Address: 使能。因为我们要传输的是一个数组。
      • Data Width: 根据Data Size选择，如果数据是16位，这里选Half Word。
    • 接收DMA（RX）配置：
      • Mode: 同样根据需求选择Normal或Circular。强烈建议接收使用Circular模式，这样可以构建一个环形缓冲区，持续接收主机发来的数据，避免溢出。
      • Increment Address: 使能。
      • Data Width:Half Word。
    • DMA中断：为了在传输完成或半传输时得到通知，建议使能接收DMA流的传输完成中断（TC）和半传输中断（HT）。在NVIC Settings中使能DMA对应的全局中断。

3.2 生成代码与关键函数解析

生成代码后，HAL库已经为我们初始化好了SPI和DMA。我们需要关注以下几个核心函数和操作：

  1. 启动DMA接收：这是从机准备接收数据的起点。必须在主机开始传输之前调用。

    // 假设我们定义了一个接收缓冲区 uint16_t rx_buffer[BUFFER_SIZE]; // 在main初始化部分或某个准备函数中，启动循环DMA接收 HAL_SPI_Receive_DMA(&hspi1, (uint8_t*)rx_buffer, BUFFER_SIZE);

    调用这个函数后，DMA控制器就会“盯住”SPI的DR寄存器。一旦主机开始传输，SPI收到数据并存入DR，DMA就会自动将其搬运到rx_buffer中，同时递增地址。当填满整个缓冲区（或半满时，如果使能了HT中断），会触发相应的DMA中断。

  2. 启动DMA发送：从机发送数据也需要DMA来驱动。

    // 假设我们定义了一个发送缓冲区，并已经填充了数据 uint16_t tx_buffer[BUFFER_SIZE]; // 填充tx_buffer... // 启动DMA发送 HAL_SPI_Transmit_DMA(&hspi1, (uint8_t*)tx_buffer, BUFFER_SIZE);

    这里有一个极其重要的细节：对于从机，调用HAL_SPI_Transmit_DMA并不会立即开始发送。它只是配置DMA，将tx_buffer中的数据预先搬运到SPI的发送缓冲区。真正的发送动作，要等到主机拉低NSS并开始产生SCK时钟时才会发生。从机的DMA会在每个数据被发送后（TXE标志），自动加载下一个数据到DR寄存器。

  3. 中断处理：我们需要在DMA的中断服务函数中处理接收到的数据。

    // 在stm32f4xx_it.c或类似文件中 void DMA2_Stream0_IRQHandler(void) // 假设SPI1_RX使用DMA2_Stream0 { if(__HAL_DMA_GET_HT_FLAG(&hdma_spi1_rx)) { // 半传输完成，可以处理rx_buffer的前半部分数据 process_rx_data(rx_buffer, 0, BUFFER_SIZE/2); __HAL_DMA_CLEAR_FLAG(&hdma_spi1_rx, DMA_FLAG_HTIF0_4); } if(__HAL_DMA_GET_TC_FLAG(&hdma_spi1_rx)) { // 全传输完成，可以处理rx_buffer的后半部分数据 process_rx_data(rx_buffer, BUFFER_SIZE/2, BUFFER_SIZE); __HAL_DMA_CLEAR_FLAG(&hdma_spi1_rx, DMA_FLAG_TCIF0_4); } }

    这种“双缓冲”机制是处理连续流数据的关键，可以在处理一半数据时，另一半继续接收，实现无缝衔接。

3.3 一个常见的初始化流程示例

void SPI_Slave_Init(void) { // CubeMX已生成SPI和DMA的初始化代码（HAL_SPI_MspInit等） // 1. 先启动循环DMA接收，让从机随时准备“听” HAL_SPI_Receive_DMA(&hspi1, (uint8_t*)spi_rx_buffer, SPI_BUFFER_SIZE); // 2. 准备要发送的数据，并启动DMA发送（等待主机时钟） prepare_transmit_data(spi_tx_buffer, SPI_BUFFER_SIZE); HAL_SPI_Transmit_DMA(&hspi1, (uint8_t*)spi_tx_buffer, SPI_BUFFER_SIZE); // 此时，从机已就绪。 // SPI_RX的DMA在循环接收，数据会源源不断存入spi_rx_buffer。 // SPI_TX的DMA已就绪，数据已装载，一旦主机选通（NSS拉低）并产生SCK，数据就会自动发出。 }

4. 双机通信的同步与协议设计

硬件和驱动配置好了，两块板子也连上了线（MISO-MOSI交叉，SCK和NSS直连，GND共地），是不是就能愉快地通信了？还不行。没有协议的通信就像没有交通规则的十字路口，迟早要撞车。SPI硬件只负责搬运比特，数据的意义需要软件来定义。

4.1 主从同步启动问题

这是第一个拦路虎。主机怎么知道从机的DMA接收/发送已经准备好了？一个稳健的做法是引入一个简单的握手信号。

  • 方案一：利用GPIO握手。从机初始化完成后，将一个GPIO引脚（例如，READY_PIN）置高。主机程序在开始SPI传输前，先循环检测这个引脚是否为高。一旦检测到，说明从机已就绪，主机再拉低NSS开始传输。传输结束后，主机可以将该引脚拉低，或由从机在数据处理完后拉低，以指示“忙”状态。
  • 方案二：利用首字节/帧协议。主机发送一个特定的命令帧（例如，0xAA55）作为通信开始的标志。从机在DMA接收缓冲区中持续检测这个特定模式。一旦检测到，就从下一个数据开始作为有效数据来处理。这种方式不需要额外的连线，但软件逻辑稍复杂。

4.2 数据帧结构设计

对于双机通信，设计一个包含帧头、长度、数据、校验的帧结构是非常必要的。

typedef struct { uint16_t header; // 帧头，如 0x5AA5 uint16_t length; // 有效数据载荷长度 uint8_t cmd; // 命令字 uint8_t data[256]; // 数据载荷 uint16_t checksum; // CRC16校验和 } SPI_Frame_t;
  • 帧头：用于在连续的比特流中识别一帧的开始。从机的接收处理程序需要在DMA环形缓冲区中搜索这个帧头。
  • 长度：指明后面data字段的真实长度，避免解析错误。
  • 命令字：定义这帧数据的用途，例如“读取传感器”、“设置参数”、“心跳包”等。
  • 校验和：用于验证数据传输的正确性。SPI硬件本身没有错误检测机制，软件校验是保证数据可靠性的最后一道防线。

4.3 从机端的“流”解析

由于从机的DMA接收是循环的，我们得到的是一个源源不断的字节流。需要在中断（半传输/全传输）服务函数中，实现一个状态机来解析这个流，提取出完整的帧。

typedef enum { FRAME_STATE_IDLE, FRAME_STATE_HEADER1, FRAME_STATE_HEADER2, FRAME_STATE_LENGTH, FRAME_STATE_CMD, FRAME_STATE_DATA, FRAME_STATE_CHECKSUM } FrameParseState; void process_rx_buffer(uint16_t* buf, uint32_t start, uint32_t end) { static FrameParseState state = FRAME_STATE_IDLE; static SPI_Frame_t current_frame; static uint16_t data_index = 0; static uint16_t calc_checksum = 0; for(uint32_t i = start; i < end; i++) { uint8_t byte = (uint8_t)(buf[i] & 0xFF); // 假设我们按字节解析 switch(state) { case FRAME_STATE_IDLE: if(byte == 0x5A) state = FRAME_STATE_HEADER1; break; case FRAME_STATE_HEADER1: if(byte == 0xA5) { state = FRAME_STATE_LENGTH; calc_checksum = 0; // 可以开始计算校验，或重置帧结构 } else { state = FRAME_STATE_IDLE; // 头错误，复位状态机 } break; // ... 其他状态处理长度、命令、数据 case FRAME_STATE_CHECKSUM: // 校验接收到的校验和与计算的calc_checksum是否一致 if(checksum_ok) { // 将完整的current_frame交给应用层处理 handle_received_frame(&current_frame); } state = FRAME_STATE_IDLE; // 处理完毕，复位状态机 break; } } }

这个状态机在DMA中断中运行，每次处理半个或整个缓冲区。它不阻塞主循环，实现了通信与处理的解耦。

5. 避坑指南：从机模式下的那些“雷”

纸上得来终觉浅，绝知此事要踩坑。下面是我在实际项目中遇到的几个典型问题及其解决方案。

5.1 NSS引脚配置错误导致通信全无

  • 现象：逻辑分析仪显示主机在疯狂产生SCK，但MISO线上完全没有数据，或者数据全是0xFF/0x00。
  • 排查：首先检查硬件连线。然后，重点检查从机的NSS引脚配置。在CubeMX中确认Hardware NSS Signal设置为Hardware NSS Input，而不是SoftWare。在代码中，检查生成的GPIO初始化代码，确认NSS引脚（如PA4）被初始化为GPIO_MODE_AF_PP（复用推挽输出）？不对！对于从机模式的NSS输入，它应该被初始化为浮空输入(GPIO_MODE_INPUT)或上拉输入，具体看硬件连接。但CubeMX配置为Hardware NSS Input后，通常会自动将其设置为正确的复用功能输入模式。最可靠的验证方法是，用示波器或逻辑分析仪同时测量主机的NSS输出和从机的NSS输入，看电平是否同步变化。如果从机NSS引脚一直为高，SPI外设根本不会工作。
  • 解决：确保CubeMX配置正确，并检查原理图，确认NSS线连接无误。有时为了简化，在单一从机系统中，主机可以不用NSS，而将从机的NSS引脚直接接地（永久选中）。但这仅限于一对一通信，且从机SPI需支持该模式（有些SPI从机NSS必须有时序）。

5.2 DMA传输模式与缓冲区溢出

  • 现象：通信一开始正常，一段时间后数据错乱，或者DMA中断不再触发。
  • 排查：
    • 发送端：如果从机发送DMA配置为Normal模式，当传输完指定长度后，DMA传输完成中断（TC）触发，DMA停止。如果主机还在继续要数据，但从机已经没有新的DMA传输来提供数据，SPI的TXE标志会一直置起，但DR寄存器里没有新数据，可能导致发送0xFFFF或旧数据。主机读到的数据就会出错。
    • 接收端：如果接收DMA配置为Normal模式，收满指定长度后停止。此时如果主机继续发送数据，SPI会收到数据并试图存入DR，但DMA已停止搬运，会导致溢出错误（OVR标志置位），后续数据全部丢失。
  • 解决：
    • 对于连续流数据，接收DMA务必使用Circular模式。这样DMA会在缓冲区首尾循环，永不停止，只要处理速度跟上，就不会丢数据。
    • 对于发送，根据业务决定。如果是应答式通信（主机发命令，从机回数据），用Normal模式，每次主机发起新传输前，从机重新启动一次DMA发送。如果是从机持续推送数据（如传感器流），也需要用Circular模式，并确保应用层能及时填充发送缓冲区的下一半（利用DMA发送的半传输完成中断HT）。

5.3 时钟相位与极性不匹配

  • 现象：逻辑分析仪显示SCK、MOSI、MISO上都有信号，但主机和从机读到的数据完全对不上，或者只有某些特定模式的数据能对上。
  • 排查：这是最经典的SPI问题。用逻辑分析仪抓取SCK和MOSI/MISO的波形。对照数据手册，仔细确认：
    1. CPOL：SCK在空闲时是高电平(1)还是低电平(0)？主机和从机是否一致？
    2. CPHA：数据是在SCK的第一个边沿（上升沿或下降沿）采样，还是在第二个边沿采样？主机和从机是否一致？
    • 一个快速验证方法：让主机发送一个简单的字节，例如0xAA (1010 1010)。用逻辑分析仪看MOSI线上的数据位，是在SCK的哪个边沿稳定的（数据应在采样边沿之前保持稳定）。对比从机SPI配置的采样边沿。
  • 解决：修改主机或从机一方的CPOL/CPHA配置，确保两者完全一致。记住，从机必须服从主机的时钟时序。

5.4 数据位宽与DMA数据宽度不匹配

  • 现象：通信能进行，但数据的高8位和低8位是反的，或者隔一个数据正确。
  • 排查：检查SPI的Data Size设置和DMA的Data Width设置。如果SPI配置为16位通信(Data Size = 16 Bits)，那么每次传输的单位是16位（2字节）。DMA的Data Width也必须设置为Half Word（16位）。如果你定义的数据缓冲区是uint8_t数组，但DMA以16位为单位去搬运，就会导致内存访问错位。
  • 解决：保持数据宽度一致。如果SPI是16位，则：
    • 数据缓冲区定义为uint16_t数组。
    • HAL库函数调用时，数据长度参数以16位字为单位。例如，HAL_SPI_Receive_DMA(&hspi1, (uint8_t*)rx_buf, 100)，这里的100意味着接收100个16位数据，即200字节。如果你的缓冲区rx_buf是uint16_t[100]，那就对了。
    • DMA配置中，外设和内存的数据宽度都设为Half Word。

5.5 从机发送数据未提前准备

  • 现象：从机似乎只接收，不发送，或者发送的第一字节总是错的。
  • 根因：如前所述，从机的发送数据必须在主机SCK第一个边沿到来之前就位。如果你在主机开始传输后才去准备数据并启动DMA发送，那么第一个时钟边沿到来时，从机的发送缓冲区可能是空的（TXE已置位但DR是旧的或未定义值），导致发送出去的是“哑元”或错误数据。
  • 解决：先启动从机的发送DMA，再让主机开始传输。在从机初始化序列的最后，调用HAL_SPI_Transmit_DMA。此时DMA会将第一个数据加载到SPI的发送缓冲区。当主机拉低NSS并产生SCK时，第一个数据就能被正确移出。对于后续数据，DMA会在TXE事件时自动加载。

6. 进阶优化：提升稳定性与吞吐量

当基础通信打通后，我们可以考虑一些优化措施，让系统更稳健、效率更高。

6.1 使用硬件CRC（如果支持）

一些高端的STM32系列（如H7）的SPI支持硬件CRC计算。在双机通信中启用硬件CRC，可以极大地减轻CPU负担，并提高校验的可靠性。配置SPI的CRC Calculation为Enable，并设置合适的CRC Polynomial。在发送端，硬件会自动在数据帧后附加CRC值；在接收端，硬件会自动计算并比较CRC，并可通过标志位或中断通知结果。这比软件计算CRC16要快得多，也更可靠。

6.2 利用FIFO与阈值

STM32的SPI通常带有一定深度的TX/RX FIFO（例如4个字）。结合DMA，可以通过设置FIFO阈值来优化DMA请求的触发时机。例如，设置RX FIFO阈值为1/4满（即收到4个数据中的1个）就产生DMA请求，可以减少DMA传输的延迟，对于高速通信尤其有益。这需要在SPI初始化时通过寄存器进行精细配置，HAL库可能没有直接接口，需要直接操作寄存器。

6.3 双缓冲与乒乓操作

对于超高吞吐量的应用，简单的DMA环形缓冲区可能仍然会在中断处理数据时面临被新数据覆盖的风险（如果处理速度慢于接收速度）。此时可以采用“乒乓缓冲”策略：准备两个独立的缓冲区A和B。DMA首先循环填充缓冲区A。当A半满或全满时，触发中断，在中断服务程序中，立即将DMA的目标地址切换到缓冲区B，然后主程序可以安全地处理缓冲区A的数据。当B快满时，再切回A。这需要动态控制DMA的目标内存地址，可以通过__HAL_DMA_SET_MEM_ADDR等宏来实现，实现零拷贝的数据交换。

6.4 总线矩阵与内存访问优化

在STM32H7等高性能MCU上，SPI和DMA可能通过不同的总线矩阵（如AXI, AHB）访问内存（DTCM, SRAM, SDRAM）。如果DMA访问的内存位于低速存储区，或者存在总线竞争，可能会成为性能瓶颈。确保用于DMA传输的缓冲区位于高速、且与DMA控制器和SPI外设访问路径一致的内存中（如H7的DTCM或AXI-SRAM）。可以使用__attribute__((section(".ram_section")))来指定变量的存储位置。

打通STM32的SPI从机模式，特别是结合DMA，就像是为你的嵌入式系统打开了一扇高速数据交换的后门。它摆脱了查询方式的低效和中断方式的频繁上下文切换，在主机时钟的驱动下，实现了近乎“无感”的并行数据搬运。关键在于理解从机的被动同步本质，精心配置NSS和DMA模式，设计好软件协议来管理数据流，并避开那些硬件层面的陷阱。

回顾整个实现过程，最深刻的体会是“准备”二字。从机的代码，核心思想就是“时刻准备着”——提前配置好DMA，提前装载好发送数据，提前开辟好接收缓冲区，并设计好状态机来解析源源不断的比特流。当主机这位“指挥家”挥下时钟的指挥棒时，从机这个“乐团”就能精准、流畅地奏出数据的乐章。