单片机与物联网 / 系统课时
执行 SPI 全双工数据交换
执行 SPI 全双工数据交换
本课使用 STM32F401 的 SPI1 外设,以裸机寄存器方式完成一次 8 位全双工交换。你将配置 SPI 时钟与引脚、手动控制片选、依次发送两个字节并读取从设备响应,最后用逻辑分析仪验证时序,避免出现发送成功却丢失接收数据的问题。
学习目标
- 理解 SPI 全双工交换和片选的实际时序。
- 使用寄存器配置 SPI1 并完成两字节收发。
- 根据 RXNE、TXE、BSY 和逻辑分析仪结果定位异常。
理解全双工交换与片选时序
SPI 使用 SCK、MOSI、MISO 和 NSS(片选)信号。主机驱动时钟,发送一个位的同时接收一个位,因此发送一个 8 位字节必然伴随接收一个 8 位字节。即使主机只想读取数据,也需要继续发送填充字节以产生时钟。
本课采用 SPI Mode 0:CPOL=0、CPHA=0,SCK 空闲为低电平,接收端在上升沿采样,发送端在下降沿更新后续数据。配置为 MSB First、8 位帧、软件控制片选。示例把 SPI 时钟限制到 1 MHz,适合先验证连接;实际最高频率必须服从从设备数据手册。
一次两字节交换的时序如下:

需要注意,MISO 的返回字节完全由从设备协议决定。第一帧可能只是命令阶段,收到的是无效数据;第二帧才可能返回有效数据。没有指定从设备协议时,不能把任意返回值解释为正确的寄存器内容。
确定硬件连接与时钟参数
本课以 STM32F401、CMSIS 设备头文件 stm32f401xe.h 和 SPI1 为例,适用于具有对应寄存器布局的 STM32F401xE 工程。假设系统已经把 HCLK 配置为 16 MHz,并且 APB2 分频为 1,因而 SPI1 的外设时钟 PCLK2 为 16 MHz。若工程使用其他时钟树,必须重新计算分频。
| 主机引脚 | 功能 | 连接方式 |
|---|---|---|
| PA4 | GPIO 片选 | 连接从设备 CS,低有效 |
| PA5 | SPI1_SCK,AF5 | 连接 SCK |
| PA6 | SPI1_MISO,AF5 | 连接 MISO |
| PA7 | SPI1_MOSI,AF5 | 连接 MOSI |
| GND | 地 | 与从设备共地 |
双方必须采用兼容的 3.3 V 逻辑电平,不要把不支持 5 V 的输入直接连接到 5 V 输出。主机使用 PA4 作为普通 GPIO 输出,而不是硬件 NSS 输出。
SPI1 的波特率由 SPI_CR1_BR 设置,计算关系为:
本课取 BR=3,即 16 MHz 除以 16,得到 1 MHz。寄存器还需要配置 MSTR=1、SSM=1、SSI=1、CPOL=0、CPHA=0、DFF=0 和 LSBFIRST=0。其中 SSI=1 保证软件 NSS 管理时内部 NSS 保持高电平,避免主机模式故障。
编写寄存器级全双工交换程序
下面的完整示例适用于已经具备 STM32F401 启动文件、CMSIS 设备头文件和正常系统时钟初始化的裸机工程。SystemInit() 由启动流程调用;此处假设其执行后 PCLK2 为 16 MHz,并使用独立的测试从设备。测试从设备约定:片选有效期间,每收到 0x9A 返回 0x3C,每收到 0x55 返回 0xC7,且这两个响应在相应字节的同一帧期间输出。普通 SPI Flash 或传感器不会自动满足这一约定。
#include <stdint.h>
#include "stm32f401xe.h"
static void spi1_init(void)
{
RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN;
RCC->APB2ENR |= RCC_APB2ENR_SPI1EN;
(void)RCC->APB2ENR;
// 先释放片选,再将 PA4 切换为推挽输出。
GPIOA->BSRR = (1U << 4);
GPIOA->MODER &= ~((3U << 8) | (3U << 10) |
(3U << 12) | (3U << 14));
GPIOA->MODER |= (1U << 8) | (2U << 10) |
(2U << 12) | (2U << 14);
GPIOA->OTYPER &= ~(1U << 4);
GPIOA->OSPEEDR |= (3U << 10) | (3U << 12) | (3U << 14);
GPIOA->PUPDR &= ~((3U << 8) | (3U << 10) |
(3U << 12) | (3U << 14));
GPIOA->AFR[0] &= ~((15U << 20) | (15U << 24) |
(15U << 28));
GPIOA->AFR[0] |= (5U << 20) | (5U << 24) | (5U << 28);
// SPI 关闭时设置:主机、软件 NSS、Mode 0、8 位、1 MHz。
SPI1->CR1 = SPI_CR1_MSTR | SPI_CR1_SSM |
SPI_CR1_SSI | SPI_CR1_BR_0 | SPI_CR1_BR_1;
SPI1->CR2 = 0U;
SPI1->CR1 |= SPI_CR1_SPE;
}
static uint8_t spi1_transfer(uint8_t tx)
{
while ((SPI1->SR & SPI_SR_TXE) == 0U) { }
// 用 8 位访问数据寄存器,避免产生额外的数据帧。
*(__IO uint8_t *)&SPI1->DR = tx;
while ((SPI1->SR & SPI_SR_RXNE) == 0U) { }
return *(__IO uint8_t *)&SPI1->DR;
}
int main(void)
{
volatile uint8_t rx0;
volatile uint8_t rx1;
volatile uint32_t test_ok;
spi1_init();
GPIOA->BSRR = (1U << (4 + 16));
rx0 = spi1_transfer(0x9A);
rx1 = spi1_transfer(0x55);
// 最后一帧完全结束后才能释放片选。
while ((SPI1->SR & SPI_SR_TXE) == 0U) { }
while ((SPI1->SR & SPI_SR_BSY) != 0U) { }
GPIOA->BSRR = (1U << 4);
test_ok = (rx0 == 0x3C && rx1 == 0xC7) ? 1U : 0U;
while (1) { }
}预期结果:在上述测试从设备、连接和时钟条件成立时,程序停在末尾循环,可通过调试器查看三个变量:
rx0 = 0x3C
rx1 = 0xC7
test_ok = 1这些值是调试器应观察到的变量值,并非串口打印结果;不同从设备的返回值可能不同。如果测试从设备协议未定义对应响应,应记录实际接收值并按该设备协议验证。示例采用无超时轮询,仅用于初次裸机验证,断线时可能永久等待 RXNE。
检查片选和状态标志的执行顺序
TXE=1 仅表示发送缓冲区可以接收新数据,不表示线上的最后一个位已经发送完毕。RXNE=1 表示接收缓冲区中有尚未读取的数据。BSY=1 表示 SPI 仍在忙碌,因此释放片选前还必须确认 BSY=0。
一次交换按以下顺序执行:
- 将 PA4 拉低,保持片选有效。
- 等待
TXE=1,以 8 位访问方式写入DR。 - 等待
RXNE=1,读取DR,保存当前帧的接收字节。 - 第二个字节重复发送和接收过程,片选始终保持低电平。
- 等待
TXE=1且BSY=0,然后释放片选。

如果收到字节后不读取 DR,后续帧可能发生接收溢出 OVR。STM32F401 在标准双线全双工接收中,发生 OVR 后需要先读取 DR 再读取 SR 来清除标志。正常交换应逐帧读取,不能等所有字节发送完才开始接收。
用逻辑分析仪验证与排错
将逻辑分析仪四个通道分别连接 PA4、PA5、PA7、PA6,并共地,采样率设置为至少 10 MS/s,以便观察 1 MHz SCK。配置 SPI 解码为 Mode 0、8 bits、MSB First、低有效片选。
一次正常交换应满足以下检查条件:
| 检查项 | 预期结果 |
|---|---|
| CS 有效窗口 | 覆盖完整两字节交换,中途不拉高 |
| SCK | 1 MHz 左右,共 16 个时钟周期 |
| MOSI | 依次解码出 0x9A、0x55 |
| MISO | 测试从设备依次返回 0x3C、0xC7 |
| 程序变量 | rx0、rx1 与总线解码结果一致 |
如果读到的每一位都发生偏移,先检查主从 CPHA 和 CPOL 是否一致;如果 SCK 没有波形,检查 GPIO 的 AF5、SPI1 外设时钟和 SPE 位;如果 MOSI 正常而 MISO 始终是 0xFF 或 0x00,优先核对从设备供电、共地、MISO 接线、片选极性与协议响应阶段。
当逻辑分析仪能稳定解码两帧、接收变量与从设备协议一致,而且片选只在最后一个时钟完成后释放,就完成了 SPI 全双工交换的基本验收。