SPI通信协议详解：从时序模式到DMA实战与故障排查

在嵌入式开发里摸爬滚打这么多年SPI 这名字几乎天天见。它是串行数据传输总线里真正的中流砥柱单片机、传感器、Flash 存储、甚至 FPGA 和主控芯片之间的高速通信十有八九都离不开它。我最早接触 SPI 是从 STM32F103 上用软件模拟时序点亮一块 OLED 屏幕开始的后来慢慢过渡到硬件 SPI、DMA 传输、多设备挂载一路踩了不少坑也积累了不少心得。这篇内容就打算把 SPI 从协议本身到工程落地的核心要点完整梳理一遍包括时序模式、片选管理、DMA 收发、常见故障排查以及它在不同存储方案里的实际应用思路。不论你是刚入门还是已经写了一阵子驱动这里的内容都能给你一些参考。我尽量不写那种教科书式的枯燥定义而是用做过项目的人视角把 SPI 的底层逻辑和各种工程细节讲明白。有的地方会补充原理推导有的地方直接给你可抄的代码思路还有一些问题是文档里根本不会写但实战中一定会碰到的。开始之前先明确一下这篇文章讲的是 SPI——串行外设接口Serial Peripheral Interface一条时钟线、两条数据线、一条片选线就能撑起高速全双工通信的老牌协议。1. 内容整体设计与思路拆解很多人一开始学通信协议容易陷入背引脚、背寄存器、背时序图的循环里。我自己的体会是真正想用好 SPI首先得搞明白它为什么长成这样以及它在整个总线家族里到底处于什么位置。这一节先讲设计层面的东西把 SPI 的骨架和血统理清楚。1.1 四条线的底层逻辑SPI 引脚少得可怜标准配置就是四条线SCLK串行时钟、MOSI主出从入、MISO主入从出、CS/SS片选。它没有地址线也没有应答机制所有通信都靠主机控制时钟来驱动。这就带来一个很有意思的特性SPI 是全双工的主机发一个 bit 的同时从机也能回一个 bit。这一点跟 UART 的单线半双工或者 I2C 的开漏半双工有本质区别。你不需要像 I2C 那样等应答位也不用像 UART 那样对波特率精度敏感SPI 的时钟直接决定了数据速率靠的是“节奏感”而不是“时间约定”。我当年第一次用逻辑分析仪抓 SPI 波形的时候最大的感受就是“干净”SCLK 是一条规规矩矩的方波MOSI 和 MISO 在时钟沿前后稳定输出数据CS 低电平表示选中。相比 I2C 那套复杂的起始条件、停止条件、应答位机制SPI 的波形看起来简直就是“说话直给”。线少带来的是布线简单但也带来一个隐藏问题没有内置的流控和错误校验机制。I2C 有 ACK 位UART 有校验位CAN 有 CRC 和仲裁而 SPI 把这些全部交给上层软件去处理。这就意味着你一旦把 SPI 用起来就得自己操心数据完整性这也是很多新手觉得 SPI “有时候不稳定”的根本原因——不是 SPI 不稳定而是你少做了保护。1.2 ATM 机式的同步机制打个比方SPI 的通信方式很像 ATM 机前的取号排队主机是柜台工作人员从机是客户SCLK 就是叫号器的节奏每叫一次号双方同时递出一张单据、接回一张单据。CS 则是“请这位客户到 3 号窗口”的提示——拉低 CS就是从机知道“现在轮到我了”。因为节奏完全由主机掌握不依赖于双方内部的时钟精度所以 SPI 可以跑得飞快从几十 KHz 到几十 MHz 都有实际产品在用。理解了这层“同步时钟推进数据流动”的本质你会更容易理解后面要讲的 Mode 0 到 Mode 3、DMA 传输、以及为什么 SPI 几乎没有“帧”的概念——它更像一个字节流管道协议层的帧格式完全由软件自己定义。这和 CAN 那种自带 ID、DLC、CRC 的完整帧结构有很大的设计理念差异。2. SPI 时序与模式选择的门道做 SPI 驱动最先碰到的硬骨头就是四种工作模式Mode 0、Mode 1、Mode 2、Mode 3。很多人栽在这上面不是因为没有资料而是因为资料总把 CPOL 和 CPHA 讲得极其绕。我换个说法。2.1 CPOL 与 CPHA 的直观理解CPOL 决定 SCLK 空闲时的电平CPOL 0空闲低电平就是时钟线闲着的时候是 0CPOL 1空闲高电平闲着的时候是 1。CPHA 决定采数据的边沿CPHA 0在第一个边沿采样CPHA 1在第二个边沿采样。这里有个关键点所谓“第一个边沿”是指从空闲状态跳变到非空闲状态的那个边沿。举个例子CPOL0 时时钟空闲为低第一个边沿就是上升沿CPOL1 时时钟空闲为高第一个边沿就是下降沿。把这两个维度组合起来就是 Mode 0 到 Mode 3。模式CPOLCPHA采样边沿常见应用Mode 000上升沿第一个边沿大多数 Flash、传感器、OLEDMode 101下降沿第二个边沿部分 ADC、特殊外设Mode 210下降沿第一个边沿部分音频芯片、PLC 外设Mode 311上升沿第二个边沿很多高速存储器件我自己的经验接一个新芯片时先看数据手册里的时序图找到“Data setup”“Data valid”标注的位置再静静数一下采样点在哪个边沿比硬背 Mode 编号靠谱得多。数据手册通常不会直接告诉你“用 Mode 0”但一定会画清楚波形。你照着波形把 CPOL 和 CPHA 定好基本就不太会翻车。2.2 波形实测眼见为实没有逻辑分析仪之前我一直觉得 SPI 时序很抽象。后来用了一台便宜的逻辑分析仪抓波形一切瞬间明了。把 MOSI、MISO、SCLK、CS 四根线接好随便发几个字节你能直接看到时钟的空闲电平、数据在哪个边沿变化、CS 低电平持续时长。这些信息对于排查“SPI 通信不生效”这种问题价值极大。举一个实际案例某次我调试一款磁编码器芯片手册时序图画得比较复杂。我按照 Mode 0 写驱动读回来的数据始终是乱的。后来抓波形才发现芯片实际是在 CPOL1、CPHA1 也就是 Mode 3 下工作因为它的数据输出在时钟的非活动沿才会更新。改完模式参数数据立刻正常。这类问题在实战中太常见了所以别嫌波形抓取麻烦这一步能省下后面几小时的猜测时间。3. 片选管理硬件片选与软件片选之争片选CS看似只是拉低再拉高但管理方式不同对整个系统的稳定性和并发能力影响很大。这一节把硬件片选和软件片选的区别、适用场景讲透。3.1 从“一根线选一个从机”说起SPI 总线上可以挂多个从机每个从机独占一根 CS 线。主机想跟哪个从机通信就把那根 CS 拉低其他从机的 CS 保持高电平。这就是最基础的片选逻辑。如果你只有一个从机直接把 CS 接地也不是不行但那意味着你放弃了片选提供的“复位通信状态”能力——一旦通信跑飞没有 CS 重新拉高再拉低的操作从机可能一直处在半死不活的状态。后来实际做项目我基本都坚持“一个从机一根 CS软件管理”的方案。这样做的最大好处是灵活你可以在任意时间点决定片选的拉低和释放完全按照从机手册要求的时序来。比如某些传感器要求 CS 低电平持续时间必须大于某个值或者两次通信之间要有一个 CS 高电平间隔软件片选可以轻松满足。3.2 什么场景该用硬件片选硬件片选是 MCU 的外设自动控制 CS 引脚你只需要把数据写入发送寄存器外设会在发送第一个 bit 前自动拉低 CS发送完最后一个 bit 后自动拉高。它的优点是 CPU 占用少、响应快特别适合持续流式读取的场景比如配合 DMA 不停读一个 FIFO 型传感器或者音频数据流。但硬件片选也有明显的坑——它在连续发送多个字节时CS 可能不会在每个字节之间拉高导致从机以为你还是在同一次“事务”里。有些从机要求每帧一个 CS 低脉冲硬件片选的自动行为就完全不匹配。我之前用 STM32F103 驱动一款 SPI 触摸屏控制器时就栽在这个坑里。硬件片选模式下发送配置命令后读回的数据总是不对后来用软件片选手动控制 CS 时序严格让每次命令发送都配上完整的 CS 拉低-拉高周期问题立刻消失。维度硬件片选软件片选CPU 负担低外设自动控制高需要手动拉低拉高时序灵活性低受外设逻辑限制高可以精确控制适用场景连续流式传输、DMA 搭配不规则命令帧、多种从机混挂典型坑点CS 脉冲宽度不符合从机要求忘记释放 CS 导致总线卡死3.3 多从机挂载时的片选策略SPI 总线上挂多从机时还要考虑一个容易忽略的问题从机 MISO 引脚的输出控制。正常情况下只有 CS 被拉低的从机才应该把 MISO 驱动起来其他从机的 MISO 必须处于高阻态。如果某个从机的 MISO 没有设计成三态输出或者你的片选逻辑有问题两个从机会同时驱动 MISO造成总线冲突轻则数据错误重则损坏引脚。我的做法是在原理图阶段就给每个从机 MISO 加上串联电阻顺便对从机手册里关于“MISO 是否在未选中时保持高阻”做一次确认。比如常见 SPI Flash 芯片 W25Q64 的 MISO 在 CS 拉高时确实会变高阻但有些老型号则不会这种差异就会在挂第二个从机时暴露出来。4. 实操STM32F103 用 CubeMX 配置 SPI 加 DMA 读芯片数据理论说再多不如一段能跑起来的工程代码有说服力。这里我就以 STM32F103 为例演示如何通过 CubeMX 配置 SPI 外设再配合 DMA 读取外部芯片的数据。实际场景是我在调试一款 MT6701 磁编码器芯片需要以较高频率读取角度值。4.1 CubeMX 中的关键配置项在 CubeMX 里选好 MCU 型号后先把 SPI1 的 Mode 设为 Full-Duplex Master硬件 NSS 设为 Disabled因为我要用软件片选让 NSS 引脚作为普通 GPIO 使用。接着配置参数Baud Rate Prescaler根据分频关系设置比如 APB2 时钟 72MHz分频 32 就是 2.25MHz。MT6701 支持较高 SPI 时钟这里我选择了一个安全值。CPOL / CPHAMT6701 手册时序对应 Mode 3CPOL1、CPHA1我在上面已经说过怎么看时序图这里直接按图索骥。Data Size8 bit。虽然 MT6701 一次返回多个字节但 SPI 数据位宽设为 8 bit 最通用多字节按顺序读就行。First BitMSB First这是绝大多数 SPI 设备的标准。生成代码之后记得把 CS 引脚初始化成普通推挽输出默认拉高。在 CubeMX 的 GPIO 设置里给 CS 引脚取个有意义的标签比如 CS_MT6701后续代码可读性会好很多。// 片选控制宏定义 #define MT6701_CS_LOW() HAL_GPIO_WritePin(CS_MT6701_GPIO_Port, CS_MT6701_Pin, GPIO_PIN_RESET) #define MT6701_CS_HIGH() HAL_GPIO_WritePin(CS_MT6701_GPIO_Port, CS_MT6701_Pin, GPIO_PIN_SET)4.2 DMA 收发流程与代码思路读 MT6701 这类芯片通常需要先发一个命令字节再读回若干字节。用 DMA 的好处是数据搬运不占 CPU你可以把 SPI 的收发任务丢给 DMA 控制器CPU 继续处理别的逻辑等 DMA 传输完成中断再回来取数据。我这里给出一段模式不是贴完整工程那太长而是给你代码骨架和思路。// 定义收发缓冲区 uint8_t spi_tx_buf[4] {0x00, 0x00, 0x00, 0x00}; uint8_t spi_rx_buf[4] {0}; volatile uint8_t spi_dma_done 0; // 启动一次 DMA 读操作 void MT6701_Read_Angle_DMA(void) { // 拉低片选开始一次事务 MT6701_CS_LOW(); // 启动 SPI DMA 收发 HAL_SPI_TransmitReceive_DMA(hspi1, spi_tx_buf, spi_rx_buf, 4); // 传输完成后片选拉高在回调里做更稳妥 } // DMA 传输完成回调 void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { // 传输完成拉高片选 MT6701_CS_HIGH(); // 置标志位通知主循环处理数据 spi_dma_done 1; } }这里有几个关键细节为什么用HAL_SPI_TransmitReceive_DMA而不是HAL_SPI_Receive_DMA因为 SPI 是全双工协议从机只有在接收时钟的情况下才能输出数据。如果只调用 Receive主机需要同时发送一些“空字节”来产生时钟。用 TransmitReceive 同时指定发送和接收缓冲区逻辑上最直观也避免了自己构造 dummy 字节的麻烦。回调里拉高 CS 而不是启动 DMA 之前是为了确保所有字节都接收完成再结束事务。有些芯片如果在最后一个字节还没有完全移出时就拉高 CS会产生错误数据。spi_tx_buf的前导字节通常是寄存器地址或者命令字。以 MT6701 为例它的角度数据是 12 位的一次读操作可能要连续读 2 个字节再多一两个具体要参考手册。这一段我建议你在实际调试时先用固定值发命令打印收到的原始字节再对照手册验证解析逻辑。DMA 在这里的优势是 CPU 占用小特别是你要用一个定时器以几十 kHz 的频率轮询读取角度值时如果每次都靠 CPU 阻塞收发系统就什么也别干了。DMA 加回调把这件事变得非常简单定时器中断里启动一次 DMA 读传输完成置标志位主循环解析数据一整套流程行云流水。4.3 SPI 半双工模式的补充说明ST 的很多 MCU SPI 外设还支持半双工模式也就是 MOSI 和 MISO 可以是同一根线比如某些屏幕模组只有一根数据线。STM32F103 的数据手册里叫 BDMBidirectional Data Mode。这种模式在一些对引脚数量敏感的传感器和屏幕上很常见。半双工模式下SCLK 照常工作数据线方向由控制位切换。启用半双工后你就不能同时发送和接收了必须遵循“先发命令再切换方向再读数据”的时序。我做过一个项目某温湿度传感器就是这种单数据线 SPI我用软件模拟 GPIO 翻转实现因为那样比硬件半双工模式更直观。如果你坚持要用硬件半双工注意在每次方向切换后加一点延时给对端芯片留出切换时间否则容易读回全 0 或者乱码。5. 从存储方案看 SPI 的影响力SPI NOR 与系统启动SPI 最大的应用场景之一就是板载存储设备尤其是 SPI NOR Flash。在很多嵌入式主控方案里SPI NOR 承担着引导代码和关键配置数据的存储任务因为它容量适中、接口简单、随机读取性能也能满足需求。5.1 SPI NOR Flash 为什么常驻引导区以 RK3588S 这类高性能应用处理器为例常见的混合存储方案是SPI NOR 存储引导程序PCIe NVMe SSD 存储操作系统和大型数据。这种方案非常有意思。NOR Flash 的特点是支持片上执行XIPCPU 可以直接从 NOR 里取指令执行不像 NAND 需要先拷贝到 RAM 再执行。SPI NOR 的容量虽然不如 eMMC、NVMe但对于几百 KB 到几十 MB 的引导代码来说绰绰有余。更关键的是SPI 接口的 NOR 芯片启动逻辑极其简单主控上电后直接从固定的 SPI 片选地址读取数据不需要复杂的初始化流程所以几乎所有应用处理器都保留了 SPI NOR 启动通道。我在 RK3588S 平台上的经历是先用 MaskROM 模式下烧写 SPI NOR把 U-Boot 放进去然后 U-Boot 再去初始化 PCIe 控制器、加载 NVMe 驱动、读取内核和根文件系统。整个过程里SPI NOR 是“第一棒选手”它不需要跑得快但必须极其可靠。这个场景下SPI 的频率往往不用拉满对外设来说稳定性远比峰值带宽重要。另一类让我印象深刻的场景是网络交换芯片有些型号甚至支持通过 SPI 接口在启动阶段加载固件。你在做这类硬件调试时SPI 接口的布线长度、串阻、上拉电阻配置都会影响固件加载的成功率。说白了SPI 这种看似简单的接口一旦进入量产阶段细微的硬件设计差别就会显现出来。5.2 SPI 与 I2C、UART、CAN 的适用边界经常有人问“SPI 和 I2C、UART、CAN 到底怎么选”我的判断逻辑很简单UART点对点、双方地位平等、异步适合两个设备之间的低速调试与透传。I2C多主机、多从机、引脚少适合板内低速外设的连接比如 EEPROM、传感器、PMIC。SPI速度快、全双工、主机独占主导权适合连续高速读写比如 Flash、ADC、LCD、编码器。CAN差分信号、短帧、带优先级仲裁适合多节点工业现场和车载环境。选总线时先看速率需求。外设要求 50MHz 持续吞吐I2C 和 UART 基本没戏直接 SPI。再看数据流方向如果只是偶尔读几个字节状态I2C 更省引脚也更省电。最后看设备距离和抗干扰节点多、距离长、环境恶劣CAN 这类差分总线才是答案。把 SPI 放进这个坐标系里你会发现它的定位非常清晰它是主机和从机之间最快、最简单、最容易实现的板级串行通道代价是你得自己维护片选逻辑和数据完整性。6. 实战踩坑SPI 通信不生效的几种典型原因最后这一部分特别有价值因为这些全是我或者同事实际调试过程中碰到过的问题。每一个都经历过“抓耳挠腮半天最后发现原因竟然这么简单”的阶段。6.1 引脚复用没配好STM32 这类 MCU 的引脚复用功能特别容易出问题。CubeMX 生成代码时如果你没有正确配置 SPI 引脚的复用功能或者 GPIO 速度设置过低SPI 时钟波形就会变形尤其在高频率下更明显。我自己有过一次经历把 SPI 时钟配置成 18MHz结果 MISO 上的数据乱七八糟后来把 GPIO 输出速度从 Low 改到 Very High问题立刻消失。SPI 时钟频率较高时GPIO 速度设置不能太低这是一条容易踩的隐藏规则。排查方法也很简单用逻辑分析仪抓 SCLK 和 MOSI看波形上升沿和下降沿是否明显如果沿很缓多半是 GPIO slew rate 设置问题。6.2 片选时序不符合从机要求片选问题前面已经讲过一部分这里补一个真实教训某次调试一颗 ADC 芯片命令正确、时钟正确、数据却偶尔错位。后来仔细看手册发现芯片要求在 CS 拉低后至少等待 1us 才能开始提供时钟。我在代码里 CS 拉低后立刻调用 SPI 发送函数时钟马上来了芯片还没来得及准备好数据自然不对。修复方法就是在片选拉低后加一个微秒级延时或者把片选拉低提前到某个不影响性能的位置。这类“CS 建立时间”在传感器里很常见调试前值得先查一下手册。6.3 DMA 缓冲区生命周期问题用 DMA 时有一个经典的坑DMA 传输是非阻塞的函数返回不代表传输结束。如果你在调用HAL_SPI_TransmitReceive_DMA后立刻修改发送缓冲区或者局部缓冲区在函数退出后就被回收DMA 控制器可能从无效内存搬运数据导致发送内容完全不可控。解决方法是把收发缓冲区定义为全局变量或静态变量并且依靠 DMA 传输完成回调来确认数据已经完整发送/接收后再进行下一步操作。这也是为什么我在第 4 节的示例代码里使用了全局缓冲区加回调标志位的方式这不仅是代码风格问题更是稳定性问题。6.4 SPI 通信不生效排查速查表现象可能原因快速排查方法读回全 0从机没被选中、MOSI/MISO 接反检查 CS 拉低时序用逻辑分析仪看引脚波形读回乱码CPOL/CPHA 不匹配、时钟频率过高核对数据手册时序图降频实测数据偶尔错位片选建立时间不足、没有等待从机就绪CS 拉低后加延时确认从机 Ready 状态DMA 传输数据不对缓冲区生命周期问题全局缓冲区回调后再处理多从机互相干扰MISO 高阻态控制失效每个从机确认未选中的 MISO 状态必要时加隔离电阻高速时不稳定布线过长、GPIO 速度设置不当缩短走线调整 GPIO 速度等级关于 SPI 的高频布线还有一个细节SPI 的 SCLK 属于周期性信号如果走线太长且没有参考平面会产生明显的振铃和过冲。采样点的偏移会造成偶发错误。所以在 PCB 设计阶段SPI 信号线尽量短、尽量平行靠近地片选线不要跟 SCLK 并行走太长距离否则容易受串扰影响。写在最后的体会如果你问我做了这么多项目对 SPI 最深的感受是什么我会说SPI 并不是因为简单才有这么多人用而是因为它在简单和高速之间找到了一个极佳的平衡点。它把所有复杂性全部交给了软件工程师——没有应答机制、没有流控制、没有错误处理但这恰恰是它的魅力所在。你可以完全掌控每一次传输的细节也可以把它封装成一套很优雅的驱动库让上层应用完全不需要关心时序。从最早用软件模拟时序点亮屏幕到用 CubeMX 加 DMA 高速读取编码器数据再到 RK3588S 这种复杂方案里的 SPI NOR 启动设计SPI 一直扮演着基础而关键的通信角色。它的学习曲线不算陡峭但深度和广度都远超表面看起来那么简单。如果你现在正在被 SPI 的一些奇怪问题困扰记住我上面提到的排查思路先抓波形再对照手册检查时序参数最后考虑软件逻辑问题。大部分 SPI 问题本质上都是时序认知不够精确造成的。把波形看明白了SPI 其实一点也不神秘。