STM32 SPI协议深度解析：从硬件连接到时序模式与实战配置

1. SPI协议从硬件连接到时序模式的深度解析搞嵌入式开发尤其是用STM32这类MCUSPISerial Peripheral Interface总线是绕不开的一道坎。它不像I2C那样需要上拉电阻和复杂的地址协议也不像UART那样需要精确的波特率匹配。SPI以其简单、高速、全双工的特性在连接Flash、SD卡、显示屏、传感器等外设时成为了工程师们的首选。但“简单”往往意味着细节决定成败CPOL、CPHA、NSS这些概念以及STM32里那些复杂的配置选项没搞明白的话调起通信来真是分分钟让人抓狂。今天我就结合自己多年在STM32F1系列上摸爬滚打的经验把SPI从协议原理到STM32的实操配置掰开揉碎了讲清楚让你不仅能连上更能知道为什么这么连避开那些我踩过的坑。SPI本质上是一种同步串行通信接口所谓“同步”就是通信双方需要一根时钟线SCK来统一步调。它采用主从架构一个主机可以带多个从机通过片选线NSS/CS来选中具体的通信对象。通信是全双工的意味着数据可以同时收发效率很高。对于STM32F1系列尤其是我们常用的中低容量型号其内置的SPI模块功能相当完善支持主从模式、多种数据格式和时钟模式。理解SPI核心在于抓住其硬件连接和通信时序这两个基石而用好STM32的SPI则需要对CubeMX配置和HAL/LL库的API有透彻的理解。1.1 硬件连接四线制与拓扑结构SPI的物理连接非常直观主要依靠四根线SCK (Serial Clock): 时钟信号线由主机产生并输出给所有从机。所有数据的传输都严格跟随这个时钟的边沿进行这是同步通信的核心。MOSI (Master Out Slave In): 主设备输出从设备输入。主机通过这根线向从机发送数据。MISO (Master In Slave Out): 主设备输入从设备输出。从机通过这根线向主机返回数据。NSS/CS (Slave Select / Chip Select): 从设备选择线低电平有效。主机通过控制这根线的电平来“点名”要与哪个从机通信。在一主多从的系统中每个从机都需要一根独立的NSS线。连接时主机的MOSI接所有从机的MOSI主机的MISO接所有从机的MISO主机的SCK接所有从机的SCK而主机的每个GPIO用于模拟NSS则分别连接到对应从机的NSS引脚。这种“星型”拓扑结构简单明了。这里有一个非常重要的实操细节STM32的硬件NSS引脚功能比较复杂特别是在多主或多从模式下容易出问题。因此我强烈建议在绝大多数应用场景下不要使用STM32 SPI模块自带的硬件NSS管理功能而是用一个普通的GPIO口来模拟片选信号。这样做的好处是控制权完全在你手里时序非常灵活可以轻松实现通信间隔、软复位等操作完全避开了硬件NSS那些令人困惑的模式如NSS硬件输入/输出模式可能带来的坑。1.2 通信时序CPOL与CPHA的四种组合模式SPI协议没有统一的标准其灵活性主要体现在时钟极性CPOL和时钟相位CPHA的配置上这两者共同定义了数据的采样和锁存时刻形成了四种模式。通信双方必须工作在同一模式下否则数据会错位。CPOL (Clock Polarity): 时钟极性定义SCK线在空闲状态即两次传输之间时的电平。CPOL 0: SCK空闲时为低电平。CPOL 1: SCK空闲时为高电平。CPHA (Clock Phase): 时钟相位定义数据是在SCK的哪个边沿被采样捕获。CPHA 0: 数据在SCK的第一个边沿即从空闲状态跳变到活动状态的边沿被采样。对于CPOL0第一个边沿是上升沿对于CPOL1第一个边沿是下降沿。CPHA 1: 数据在SCK的第二个边沿即从活动状态跳变回空闲状态的边沿被采样。对于CPOL0第二个边沿是下降沿对于CPOL1第二个边沿是上升沿。为了更直观我们通常用模式0、1、2、3来指代模式0 (CPOL0 CPHA0): 空闲时SCK为低数据在SCK上升沿被采样下降沿变化。模式1 (CPOL0 CPHA1): 空闲时SCK为低数据在SCK下降沿被采样上升沿变化。模式2 (CPOL1 CPHA0): 空闲时SCK为高数据在SCK下降沿被采样上升沿变化。模式3 (CPOL1 CPHA1): 空闲时SCK为高数据在SCK上升沿被采样下降沿变化。如何选择模式这完全取决于你的从设备如传感器、Flash芯片的数据手册。手册里一定会明确规定它支持哪种SPI模式。你必须将STM32主机的模式配置得与从机一致。一个常见的误区是认为模式0是“默认”或“最常用”的其实不然很多器件比如某些型号的NOR Flash就工作在模式3。所以第一步永远是查阅从机数据手册。此外数据位的传输顺序MSB-first或LSB-first也需要配置。大部分器件是MSB最高位先传但有些特殊器件如某些音频编解码器可能是LSB先传。同样遵循从机数据手册的规定。注意在调试时如果通信失败除了检查接线首要怀疑对象就是CPOL和CPHA的设置是否与从机匹配。用逻辑分析仪抓取SCK、MOSI、MISO的波形对照从机时序图是排查这类问题最有效的方法。2. STM32F1 SPI模块配置详解从CubeMX到代码理解了协议我们来看如何在STM32F1上具体实现。ST提供的CubeMX工具和HAL/LL库大大简化了配置过程但知其然更要知其所以然我们一步步来。2.1 使用CubeMX进行图形化配置在CubeMX中启用并配置SPI模块非常直观引脚分配: 在Pinout Configuration标签页找到对应的SPI外设如SPI1。激活它CubeMX会自动为你分配MOSI、MISO、SCK引脚。对于NSS引脚我建议你在这里不要启用硬件NSS即保持为Disable我们后续用GPIO模拟。参数配置: 在Configuration标签页的SPI设置中关键参数如下Mode: 选择Full-Duplex Master全双工主机或Full-Duplex Slave全双工从机。这是最常用的模式。Data Size: 选择8 bits或16 bits。根据外设要求选择8位更通用。First Bit: 选择MSB First或LSB First。Clock Polarity (CPOL): 选择Low或High。Clock Phase (CPHA): 选择1 Edge对应CPHA0或2 Edge对应CPHA1。这里的“Edge”指的是采样边沿。NSS: 选择Disable。这就是禁用硬件NSS管理将其设置为软件模式Software NSS Management。此时该引脚可以被重新配置为普通GPIO。Baud Rate Prescaler: 波特率分频器。SPI时钟由APB总线时钟分频得到。计算公式为SCK频率 APB时钟频率 / Prescaler。需要根据从机支持的最高SCK频率来选择合适的预分频值留有一定余量。生成代码: 配置完成后生成代码。CubeMX会帮你初始化GPIO和SPI外设但不会自动调用HAL_SPI_Init()或LL_SPI_Enable()这是一个常见的坑点与UART不同SPI模块的使能需要你在用户代码中手动完成。2.2 关键初始化结构体与API解析以LL库为例LL库提供了更接近寄存器的底层控制适合对性能和代码大小有要求的场景。我们重点看初始化结构体LL_SPI_InitTypeDeftypedef struct { uint32_t TransferDirection; // 传输方向全双工、半双工收、半双工发 uint32_t Mode; // 主从模式 uint32_t DataWidth; // 数据宽度8位或16位 uint32_t ClockPolarity; // 时钟极性 CPOL uint32_t ClockPhase; // 时钟相位 CPHA uint32_t NSS; // NSS模式软件管理推荐或硬件管理 uint32_t BaudRate; // 波特率预分频 uint32_t BitOrder; // 位顺序MSB或LSB在先 uint32_t CRCCalculation; // CRC计算使能 uint32_t CRCPoly; // CRC多项式 } LL_SPI_InitTypeDef;关键字段解读与避坑指南TransferDirection: 除非外设特别要求如某些单线SPI器件否则一律选择LL_SPI_FULL_DUPLEX全双工。即使在只读或只写场景下全双工模式也是兼容的只是你需要处理“无用”的收发数据。NSS:务必设置为LL_SPI_NSS_SOFT软件NSS管理。这是CubeMX中Disable选项对应的模式。在此模式下硬件NSS引脚功能被禁用你可以将其配置为普通推挽输出GPIO通过HAL_GPIO_WritePin或LL_GPIO_WriteOutputPin来控制片选。千万不要去碰LL_SPI_NSS_HARD_INPUT和LL_SPI_NSS_HARD_OUTPUT它们的逻辑复杂且容易导致主模式错误MODF。BaudRate: 选择分频系数如LL_SPI_BAUDRATEPRESCALER_DIV8。确保计算出的SCK频率不超过从机规格。CRCCalculation: SPI通信本身没有硬件CRC校验但STM32的SPI模块提供了可选的CRC计算单元用于多字节传输的完整性校验。在普通传感器、Flash读写中一般不需要启用。初始化函数LL_SPI_Init会根据这个结构体配置SPI寄存器。但初始化后SPI模块仍处于禁用状态必须手动调用LL_SPI_Enable(SPIx)来开启。这是很多新手容易遗漏的一步导致通信始终无法开始。2.3 状态标志位通信流程的指挥棒SPI通信是状态驱动的我们需要轮询或通过中断来检测几个关键标志位TXE (Transmit buffer Empty): 发送数据寄存器为空。当你可以安全地向数据寄存器DR写入下一个待发送数据时此位为1。写入操作会清除此标志。RXNE (Receive buffer Not Empty): 接收数据寄存器非空。当SPI已经从线上接收完一个数据并存入DR寄存器时此位为1。读取DR寄存器会清除此标志。BSY (Busy): 通信忙标志。当SPI正在发送或接收数据时此位为1。注意在查询方式通信时不建议用BSY来判断单次传输结束因为它会在整个数据传输期间保持为高。更标准的做法是结合TXE和RXNE。例如发送时等待TXE置位后写入数据接收时在发送完Dummy数据后等待RXNE置位再读取。OVR (Overrun): 溢出错误。当接收端尚未读取前一个数据RXNE仍为1而新的数据已经到来时会发生溢出此位置1。发生溢出时后续数据会丢失。这是一个严重的错误通常意味着你的接收处理速度跟不上发送速度或者在查询方式下漏读了数据。在使能了RXNE中断的系统中如果中断服务程序没有及时读取数据就极易引发OVR。MODF (Mode Fault): 模式错误。在硬件NSS模式下如果主机检测到自己的NSS引脚被拉低意味着有另一个主机试图控制总线就会发生此错误SPI模块会自动禁用。这正是我们禁用硬件NSS改用GPIO模拟的主要原因之一可以完全避免此问题。LL库提供了LL_SPI_IsActiveFlag_TXE、LL_SPI_IsActiveFlag_RXNE等函数来查询这些标志位以及LL_SPI_ClearFlag_OVR来清除溢出标志。3. SPI数据收发实战查询、中断与DMA配置好SPI后核心就是数据的收发了。根据应用对速度和CPU占用的要求我们可以选择查询、中断或DMA三种方式。3.1 查询方式最简单直接的阻塞通信查询方式就是在主循环中不断检查标志位代码流程清晰适合低速、非实时性要求的场景。主机发送单字节数据void SPI_WriteByte(SPI_TypeDef *SPIx uint8_t data) { // 1. 拉低片选假设CS引脚为GPIOA Pin 4 LL_GPIO_ResetOutputPin(GPIOA LL_GPIO_PIN_4); // 2. 等待发送缓冲区为空 while(!LL_SPI_IsActiveFlag_TXE(SPIx)); // 3. 写入数据启动传输 LL_SPI_TransmitData8(SPIx data); // 4. 可选等待传输完成等待RXNE因为全双工下发送的同时也在接收 while(!LL_SPI_IsActiveFlag_RXNE(SPIx)); // 5. 读取接收到的数据可能是无效数据清除RXNE标志 volatile uint8_t dummy LL_SPI_ReceiveData8(SPIx); // 6. 拉高片选 LL_GPIO_SetOutputPin(GPIOA LL_GPIO_PIN_4); }主机接收单字节数据 接收数据需要主机提供时钟。因此主机必须发送一个“哑元”Dummy字节通常为0xFF或0x00来产生SCK从而读取从机返回的数据。uint8_t SPI_ReadByte(SPI_TypeDef *SPIx) { uint8_t received_data 0; LL_GPIO_ResetOutputPin(GPIOA LL_GPIO_PIN_4); // 先读一次DR确保缓冲区为空避免之前的数据干扰 if(LL_SPI_IsActiveFlag_RXNE(SPIx)) { volatile uint8_t clear_dummy LL_SPI_ReceiveData8(SPIx); } // 发送Dummy字节以产生时钟 while(!LL_SPI_IsActiveFlag_TXE(SPIx)); LL_SPI_TransmitData8(SPIx 0xFF); // 发送0xFF作为时钟源 // 等待数据接收完成 while(!LL_SPI_IsActiveFlag_RXNE(SPIx)); received_data LL_SPI_ReceiveData8(SPIx); LL_GPIO_SetOutputPin(GPIOA LL_GPIO_PIN_4); return received_data; }实操心得在连续收发多字节时片选信号CS的时机很关键。有些器件要求在整个命令序列如写使能命令地址数据期间CS保持低电平中间不能拉高而有些器件则每个字节都需要CS脉冲。务必仔细阅读外设数据手册的时序图。对于需要CS持续拉低的器件我的习惯是在传输开始前拉低CS在全部字节发送/接收完毕后再拉高确保时序严格符合要求。3.2 中断方式提高CPU效率当需要非阻塞通信或处理不定长数据时中断方式是更好的选择。我们需要使能TXE和/或RXNE中断。初始化中断// 在SPI初始化后使能RXNE中断假设我们需要在接收完成时处理 LL_SPI_EnableIT_RXNE(SPI1); // 同时使能SPI全局中断在NVIC中 NVIC_SetPriority(SPI1_IRQn 0); NVIC_EnableIRQ(SPI1_IRQn);中断服务程序ISRvoid SPI1_IRQHandler(void) { // 检查是否是RXNE中断 if(LL_SPI_IsActiveFlag_RXNE(SPI1) LL_SPI_IsEnabledIT_RXNE(SPI1)) { // 读取接收到的数据 uint8_t data LL_SPI_ReceiveData8(SPI1); // 将数据存入缓冲区或进行其他处理 user_rx_buffer[rx_index] data; // 如果需要继续接收主机需要继续发送Dummy字节来产生时钟 // 可以在中断里发送也可以在主循环里控制 if(rx_index EXPECTED_LENGTH) { LL_SPI_TransmitData8(SPI1 0xFF); // 发送下一个Dummy字节 } else { // 接收完成拉高CS等操作 LL_GPIO_SetOutputPin(GPIOA LL_GPIO_PIN_4); } } // 检查TXE中断如果需要流控发送数据 if(LL_SPI_IsActiveFlag_TXE(SPI1) LL_SPI_IsEnabledIT_TXE(SPI1)) { if(tx_index tx_length) { LL_SPI_TransmitData8(SPI1 user_tx_buffer[tx_index]); } else { // 发送完成禁用TXE中断避免空中断 LL_SPI_DisableIT_TXE(SPI1); } } // 检查错误中断OVR MODF if(LL_SPI_IsActiveFlag_OVR(SPI1)) { // 处理溢出错误读取DR清除标志并记录错误 volatile uint8_t dummy LL_SPI_ReceiveData8(SPI1); LL_SPI_ClearFlag_OVR(SPI1); error_flag | SPI_ERROR_OVR; } }中断方式的核心是状态管理。你需要维护发送和接收缓冲区及其索引并在适当的时候开启或关闭TXE/RXNE中断。对于全双工连续传输一种常见的模式是在TXE中断中发送数据同时硬件会自动接收数据并触发RXNE中断。你需要确保处理速度能跟上否则可能溢出。3.3 DMA方式解放CPU实现高速大数据传输当需要传输大量数据如读写SPI Flash、刷新LCD屏时DMA直接存储器访问是必选项。它可以在不占用CPU的情况下自动在内存和SPI数据寄存器之间搬运数据。SPI DMA发送配置流程配置DMA流Stream和通道Channel在CubeMX中为SPI的TX请求选择对应的DMA流和通道如SPI1_TX对应DMA1_Stream3通道3。配置方向为内存到外设数据宽度匹配8位或16位使能内存地址递增外设地址固定。编写DMA传输函数void SPI_Transmit_DMA(uint8_t *pData uint16_t Size) { // 1. 确保SPI和DMA已使能 // 2. 配置DMA源地址pData目的地址SPI1-DR数据长度Size LL_DMA_SetDataLength(DMA1 LL_DMA_STREAM_3 Size); LL_DMA_SetMemoryAddress(DMA1 LL_DMA_STREAM_3 (uint32_t)pData); LL_DMA_SetPeriphAddress(DMA1 LL_DMA_STREAM_3 (uint32_t)SPI1-DR); // 3. 拉低片选 LL_GPIO_ResetOutputPin(GPIOA LL_GPIO_PIN_4); // 4. 使能SPI的TX DMA请求 LL_SPI_EnableDMAReq_TX(SPI1); // 5. 使能DMA流开始传输 LL_DMA_EnableStream(DMA1 LL_DMA_STREAM_3); // 6. 等待DMA传输完成中断或查询标志位 // 7. 传输完成后禁用SPI TX DMA请求拉高片选 // LL_SPI_DisableDMAReq_TX(SPI1); // LL_GPIO_SetOutputPin(GPIOA LL_GPIO_PIN_4); }处理DMA传输完成中断在DMA传输完成中断TCIF中进行清理工作禁用DMA流禁用SPI的DMA请求拉高片选通知主程序传输完成。SPI DMA接收的特别注意点 SPI的DMA接收需要特别小心。因为SPI是全双工的主机在接收数据时必须同时发送数据以产生SCK时钟。因此纯粹的DMA接收是不存在的通常需要配合DMA发送。方法一双DMA模式同时启用SPI的TX DMA和RX DMA。TX DMA负责循环发送Dummy数据如0xFFRX DMA负责将接收到的数据存入缓冲区。这是最高效的方式。方法二查询发送DMA接收在启动RX DMA后用查询或中断方式不断发送Dummy字节。这种方式CPU参与度较高。方法三单DMA发送查询接收对于低速或数据量不大的场景也可以用DMA发送有效数据或Dummy数据然后在DMA发送完成中断中用查询方式读取SPI_DR中已经接收到的数据。DMA模式下的关键APILL_SPI_EnableDMAReq_TX()/LL_SPI_EnableDMAReq_RX(): 使能SPI的DMA发送/接收请求。LL_SPI_GetDMAReqRegAddr(): 获取SPI数据寄存器DR的地址用于配置DMA的外设地址。LL库中对应的函数可能是LL_SPI_DMA_GetRegAddr。DMA相关的配置函数如LL_DMA_InitLL_DMA_SetDataLength等。重要避坑指南在DMA传输开始前务必确保SPI的发送缓冲区是空的TXE1并且接收缓冲区也是空的通过预读一次DR清除可能的RXNE。否则可能会造成第一个字节传输错位或丢失。此外DMA传输完成后一定要先禁用SPI的DMA请求LL_SPI_DisableDMAReq_XX再禁用DMA流最后再操作片选等GPIO这个顺序可以避免残留的DMA请求造成误操作。4. 常见问题排查与实战经验分享即使按照手册配置SPI通信也难免遇到问题。下面是我总结的一些常见故障和排查思路希望能帮你快速定位问题。4.1 通信完全无反应SCK没有波形检查电源和地线确保主从设备共地且供电正常。检查引脚配置确认MOSI、MISO、SCK、CS引脚配置正确没有与其他功能冲突。特别注意STM32的某些引脚有复用功能重映射确保你使用的SPI引脚是正确的AF复用功能模式。检查SPI是否使能这是最容易被忽略的一点调用LL_SPI_Enable(SPIx)了吗检查时钟源SPI的时钟来源于APB总线。检查RCC中是否已经使能了对应SPI外设的时钟LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_SPI1)。检查片选信号用示波器或逻辑分析仪看CS引脚是否被正确拉低。如果你的代码里忘记操作CS通信永远不会开始。检查从机是否支持该模式确认从机的CPOL、CPHA、数据位宽、最大SCK频率是否与主机配置匹配。4.2 能收到数据但数据错误错位、全0、全1、0xFF时序模式不匹配CPOL/CPHA这是数据错误的最常见原因用逻辑分析仪同时抓取SCK、MOSI、MISO波形对照从机数据手册的时序图看采样边沿是否对齐。一个字节一个字节地比对。数据位顺序错误检查LL_SPI_MSB_FIRST或LL_SPI_LSB_FIRST的设置是否与从机一致。时钟速度过快从机可能无法在高速SCK下稳定工作。尝试降低波特率预分频系数增大分频数。信号完整性问题对于长导线或高速通信可能因为信号反射、边沿变缓导致采样错误。尝试降低速度或在信号线上串联一个小电阻如22-100欧姆。全双工下的数据读取问题在主机发送数据时即使你不关心接收到的数据也必须定期读取SPI-DR来清除RXNE标志否则会导致溢出OVR。在查询式接收时忘记发送Dummy字节也会导致收不到数据MISO线为高阻读回可能是0xFF或0x00。4.3 DMA传输异常数据丢失、传输不完整缓冲区溢出OVRDMA接收时如果CPU或DMA来不及从DR寄存器取走数据而新数据又来了就会发生OVR。确保DMA的搬运速度跟得上SPI的数据速率。检查DMA中断优先级是否被不必要的高优先级中断打断。DMA传输长度设置错误LL_DMA_SetDataLength设置的是传输项目数Number of Data Items如果数据宽度是字节那就是字节数如果是半字16位那就是半字数。设置错误会导致传输提前结束或超出缓冲区。内存/外设地址未对齐如果数据宽度是16位半字那么内存地址和SPI_DR地址都应该是2字节对齐的。使用8位数据宽度可以避免此问题。DMA与CPU访问冲突确保DMA操作的缓冲区内存区域不会被CPU同时修改。可以考虑使用__attribute__((section(.dma_buffer)))将缓冲区定义到特定的非缓存如果支持或确保一致性的内存区域。传输完成中断处理不当在DMA传输完成中断中必须按照“禁用SPI DMA请求 - 禁用DMA流 - 清除中断标志 - 进行后续处理如拉高CS”的顺序操作。顺序错乱可能导致状态机混乱。4.4 多从机系统下的干扰问题片选信号串扰确保在操作一个从机时其他从机的CS引脚处于高电平未被选中。GPIO模拟CS时注意初始化将所有CS引脚设为高电平输出。MISO线冲突所有从机的MISO线在未被选中时必须处于高阻态。确保你的从机器件支持此特性通常SPI器件都支持。如果某个器件不支持则需要为每个从机的MISO线加上三态缓冲器由主机的CS信号控制其使能。电源噪声多个器件同时切换可能引起电源波动在电源引脚增加足够的去耦电容如100nF陶瓷电容靠近器件电源引脚。最后再分享一个调试利器逻辑分析仪。一个几十块钱的USB逻辑分析仪配合Saleae Logic或PulseView软件可以同时捕获多路SPI信号直观地显示时钟、数据和片选波形并能直接解析出十六进制或二进制数据。在调试SPI问题时它比示波器更直观高效。养成习惯在通信异常时第一时间用逻辑分析仪抓取波形对照时序图分析绝大多数问题都能迎刃而解。SPI是一个“简单”但细节丰富的接口。吃透CPOL/CPHA谨慎处理NSS善用状态标志和DMA再配上逻辑分析仪这个“火眼金睛”你就能稳稳地驾驭STM32的SPI让它成为你项目中最可靠的通信桥梁。