在实际嵌入式开发中，单片机与外设芯片的通信是项目的基础。无论是读取传感器数据、驱动显示屏，还是与存储芯片交互，都需要一个可靠、高效的通信协议。SPI（Serial Peripheral Interface）协议因其简单、高速、全双工的特性，成为单片机与众多外设（如Flash、SD卡、TFT屏幕、ADC/DAC芯片）通信的首选方案之一。然而，很多开发者在初次接触SPI时，往往只停留在“接线、调用库函数”的层面，一旦遇到通信失败、数据错乱、时序不匹配等问题，便无从下手。理解SPI的硬件机制、四种工作模式、时钟极性与相位，以及软件片选与硬件片选的差异，是确保通信稳定性的关键。

本文面向正在学习或使用STM32、ESP32、51单片机等平台进行嵌入式开发的工程师和学生。我们将从SPI协议最核心的物理层和时序层讲起，通过对比UART、I2C来明确SPI的适用场景。然后，我们将深入解析CPOL和CPHA这两个决定通信模式的核心参数，并给出四种模式下的波形图。接着，我们会以一个具体的例子——使用STM32的HAL库驱动SPI Flash（如W25Q128）——来展示从引脚配置、初始化、到发送接收数据的完整流程。最后，文章将重点分析SPI通信中常见的故障现象，如数据全为0xFF、时钟无输出、片选信号异常等，并提供一套从硬件到软件的排查清单。掌握这些内容后，你将能独立解决大部分SPI通信问题，并能在不同单片机平台和外设间正确配置SPI。

1. 理解SPI：为什么它是单片机与外设通信的“正确姿势”

在单片机系统中，UART、I2C和SPI是最常见的三种串行通信协议。选择SPI往往基于其对速度和实时性的要求。

1.1 SPI协议的核心优势与适用场景

SPI是一种同步、全双工、主从式的串行通信总线。同步意味着通信双方依靠同一个时钟信号（SCLK）来同步数据位传输，这避免了UART需要预先约定波特率可能产生的误差积累问题。全双工则意味着主设备和从设备可以同时发送和接收数据，提高了通信效率。

与I2C相比，SPI没有复杂的寻址机制和多主设备仲裁逻辑，结构更简单，速度通常更快（可达数十MHz）。与UART相比，SPI是同步通信，时序更精确，没有起始位和停止位的开销。

因此，SPI非常适合与对速度要求高、数据交换频繁的外设通信，例如：

• 存储器：SPI Flash（W25Q系列）、SD卡（SPI模式）。
• 显示模块：TFT屏幕驱动芯片（如ST7789、ILI9341）。
• 传感器：某些高精度ADC（如AD7705）、陀螺仪。
• 数字电位器、音频编解码器等。

它的主要缺点是需要占用较多的I/O口（至少4根线），且没有硬件应答机制，通信的可靠性完全由主设备时序和从设备性能保证。

1.2 SPI的物理连接：四线制与三线制

一个标准的SPI总线需要4根信号线：

1. SCLK (Serial Clock)：时钟信号，由主设备产生，用于同步数据。
2. MOSI (Master Out Slave In)：主设备输出，从设备输入的数据线。
3. MISO (Master In Slave Out)：主设备输入，从设备输出的数据线。
4. CS/SS (Chip Select / Slave Select)：片选信号，由主设备控制，低电平有效。每个从设备都需要独立的片选线。

当总线上只有一个从设备时，可以采用固定拉低CS的方式，这就是“三线制”SPI（仅SCLK, MOSI, MISO），但这种方式无法支持多从设备，且要求从设备必须支持CS常低。

下图清晰地展示了SPI主设备与单个从设备以及多个从设备的连接方式：

主设备 (单片机) 从设备A 从设备B MOSI --------------------> SDI MISO <-------------------- SDO SCLK --------------------> SCK CS1 --------------------> CS CS2 --------------------------------------------> CS

(连接示意图：多从设备时，SCLK、MOSI、MISO共享，每个从设备有独立的CS线)

2. 深入SPI时序：CPOL与CPHA决定通信模式

SPI通信能否成功，八成取决于时序是否匹配。而时序的核心由两个参数决定：时钟极性（CPOL）和时钟相位（CPHA）。它们共同构成了SPI的四种工作模式（Mode 0, 1, 2, 3）。

2.1 时钟极性（CPOL）与时钟相位（CPHA）详解

• 时钟极性（CPOL）：定义SCLK时钟线在空闲状态（即CS有效前和失效后）的电平。
  • CPOL = 0：SCLK空闲时为低电平。
  • CPOL = 1：SCLK空闲时为高电平。
• 时钟相位（CPHA）：定义数据在时钟的哪个边沿被采样（捕获）。
  • CPHA = 0：数据在时钟的第一个边沿（即SCLK从空闲状态跳变到相反状态的边沿）被采样，在下一个边沿切换。
  • CPHA = 1：数据在时钟的第二个边沿被采样，在第一个边沿切换。

这两个参数的组合产生了四种模式。最关键的原则是：主设备与从设备的CPOL和CPHA必须完全一致。

2.2 SPI四种工作模式波形图与对照表

为了直观理解，我们以传输一个字节数据0xAA（二进制10101010）为例，描述四种模式下的波形。假设数据在MSB（最高位）先出。

Mode 0 波形分析（最常用）：

1. CS拉低，通信开始。此时SCLK为低电平（空闲状态）。
2. 第一个SCLK边沿是上升沿（从低到高）。根据CPHA=0，主机在上升沿采样MISO数据，从机在上升沿采样MOSI数据。但此时数据线（MOSI/MISO）上的数据位（第一位，MSB）是何时准备好的呢？是在SCLK上升沿之前，由发送方在SCLK的下降沿放置到数据线上的。
3. 因此，对于Mode 0：数据在时钟下降沿切换，在随后的时钟上升沿被稳定采样。

重要提示：很多初学者混淆“采样”和“切换”。请记住：采样边沿是接收方读取数据线的时刻，切换边沿是发送方改变数据线的时刻。两者相差半个时钟周期。

如何确定外设的模式？最可靠的方法是查阅其数据手册（Datasheet）中的时序图。通常会在“Serial Interface Timing Characteristics”章节找到类似“CPHA=0, CPOL=0”的描述和波形图。

3. 实战：使用STM32 HAL库驱动SPI Flash（W25Q128）

理论需要实践验证。我们以STM32CubeIDE开发环境为例，演示如何配置STM32的SPI1与一块W25Q128JV SPI Flash芯片通信，实现器件ID读取和页编程。

3.1 硬件连接与CubeMX配置

首先，在STM32CubeMX中创建工程，选择你的STM32型号。

1. 引脚配置：

   • 找到SPI1。
   • 将SPI1模式设置为“Full-Duplex Master”。
   • 自动分配的引脚通常是：PA5(SCK),PA6(MISO),PA7(MOSI)。
   • 我们需要手动配置一个GPIO作为片选CS。例如选择PA4，将其设置为“GPIO_Output”。初始电平设置为高电平（因为CS低有效）。

2. 参数配置：

   • 在SPI1的配置页面，根据W25Q128的数据手册，我们需要设置为Mode 0。
     • Clock Polarity (CPOL): Low
     • Clock Phase (CPHA): 1 Edge (即CPHA=0)
   • Baud Rate: 可以先设置为较低速度如PCLK/64，确保初始通信稳定，后续可提高。
   • Data Size: 8 Bits
   • First Bit: MSB First
   • CRC Calculation: Disable
   • NSS Signal Type: Software (软件控制片选，即我们手动控制PA4)。

3. 生成代码：配置好时钟树等项目基本设置后，生成代码。

3.2 软件实现：封装底层驱动

生成的代码提供了HAL_SPI_TransmitReceive等函数，但直接使用它们操作Flash比较繁琐。更好的做法是封装一个驱动层。

首先，在main.c或单独的驱动文件中，定义片选引脚操作宏和Flash指令：

/* 片选引脚定义 (PA4) */ #define FLASH_CS_GPIO_PORT GPIOA #define FLASH_CS_GPIO_PIN GPIO_PIN_4 #define FLASH_CS_LOW() HAL_GPIO_WritePin(FLASH_CS_GPIO_PORT, FLASH_CS_GPIO_PIN, GPIO_PIN_RESET) #define FLASH_CS_HIGH() HAL_GPIO_WritePin(FLASH_CS_GPIO_PORT, FLASH_CS_GPIO_PIN, GPIO_PIN_SET) /* W25Q128JV 部分指令 */ #define CMD_READ_JEDEC_ID 0x9F #define CMD_WRITE_ENABLE 0x06 #define CMD_PAGE_PROGRAM 0x02 #define CMD_READ_DATA 0x03 #define DUMMY_BYTE 0xFF

然后，编写核心的SPI读写函数和Flash操作函数：

/** * @brief 通过SPI发送并接收一个字节 * @param txData: 要发送的字节 * @retval 接收到的字节 */ static uint8_t SPI_Flash_SendByte(uint8_t txData) { uint8_t rxData = 0; HAL_SPI_TransmitReceive(&hspi1, &txData, &rxData, 1, HAL_MAX_DELAY); return rxData; } /** * @brief 读取Flash的JEDEC ID（制造商和设备ID） * @param manufacturerID: 返回制造商ID * @param deviceID: 返回设备ID（两个字节） * @retval HAL status */ HAL_StatusTypeDef Flash_ReadID(uint8_t *manufacturerID, uint16_t *deviceID) { uint8_t cmd = CMD_READ_JEDEC_ID; uint8_t idBuf[3] = {0}; FLASH_CS_LOW(); // 启动通信 SPI_Flash_SendByte(cmd); // 发送指令 idBuf[0] = SPI_Flash_SendByte(DUMMY_BYTE); // 读制造商ID idBuf[1] = SPI_Flash_SendByte(DUMMY_BYTE); // 读存储器类型 idBuf[2] = SPI_Flash_SendByte(DUMMY_BYTE); // 读容量 FLASH_CS_HIGH(); // 结束通信 *manufacturerID = idBuf[0]; // 例如 Winbond: 0xEF *deviceID = (idBuf[1] << 8) | idBuf[2]; // 例如 W25Q128JV: 0x4018 return HAL_OK; } /** * @brief 向Flash指定地址写入一页数据（最多256字节） * @param addr: 写入地址（24位） * @param pData: 待写入数据指针 * @param size: 数据大小（1-256） * @retval HAL status */ HAL_StatusTypeDef Flash_PageProgram(uint32_t addr, uint8_t *pData, uint16_t size) { uint8_t cmdBuf[4]; // 1. 发送写使能指令 FLASH_CS_LOW(); SPI_Flash_SendByte(CMD_WRITE_ENABLE); FLASH_CS_HIGH(); HAL_Delay(1); // 等待指令生效 // 2. 发送页编程指令和地址 FLASH_CS_LOW(); cmdBuf[0] = CMD_PAGE_PROGRAM; cmdBuf[1] = (addr >> 16) & 0xFF; // 地址高字节 cmdBuf[2] = (addr >> 8) & 0xFF; // 地址中字节 cmdBuf[3] = addr & 0xFF; // 地址低字节 HAL_SPI_Transmit(&hspi1, cmdBuf, 4, HAL_MAX_DELAY); // 发送指令和地址 // 3. 发送数据 HAL_SPI_Transmit(&hspi1, pData, size, HAL_MAX_DELAY); FLASH_CS_HIGH(); // 4. 等待写入完成（实际项目中应轮询状态寄存器BUSY位） HAL_Delay(5); // 页编程典型时间，此处简化处理 return HAL_OK; }

3.3 在主函数中调用与验证

在main函数的初始化部分后，添加测试代码：

int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_SPI1_Init(); // ... 其他初始化 uint8_t manuID = 0; uint16_t devID = 0; uint8_t writeData[] = "Hello, SPI!"; uint8_t readData[20] = {0}; // 测试1：读取ID if(Flash_ReadID(&manuID, &devID) == HAL_OK) { printf("Manufacturer ID: 0x%02X\r\n", manuID); printf("Device ID: 0x%04X\r\n", devID); // 判断ID是否正确，例如：manuID == 0xEF, devID == 0x4018 } // 测试2：写入并读取数据 Flash_PageProgram(0x000000, writeData, sizeof(writeData)); // 写入到地址0 HAL_Delay(10); // 等待写入完成 // 实现Flash_ReadData函数（类似PageProgram，发送读指令0x03和地址，然后连续读） Flash_ReadData(0x000000, readData, sizeof(writeData)); printf("Read Data: %s\r\n", readData); // 应输出 "Hello, SPI!" while (1) { // 主循环 } }

通过串口助手查看输出，如果正确打印出芯片ID和写入的字符串，说明SPI通信成功。

4. SPI通信常见问题与深度排查指南

即使按照示例连接和编程，SPI通信仍可能失败。以下是典型问题及其排查路径，请按顺序检查。

4.1 问题一：读取数据始终是0xFF或0x00

这是最常见的问题。

• 现象：调用HAL_SPI_Receive或自定义读取函数后，接收缓冲区全是0xFF或0x00。
• 排查步骤：
  1. 检查硬件连接：使用万用表或示波器，确保SCLK、MOSI、MISO、CS四根线没有虚焊、短路，且与软件配置的引脚一致。
  2. 检查片选信号CS：用示波器或逻辑分析仪观察CS引脚。通信期间CS必须为低电平。常见错误是CS引脚配置错误（如上拉/下拉模式不对）、软件中忘记拉低CS、或拉低/拉高的时序不对。
  3. 检查时钟信号SCLK：观察SCLK是否有波形输出。如果没有，检查SPI外设是否使能、时钟是否配置、SPI是否初始化成功。如果有时钟，检查其频率是否过高（超过从设备支持的最大SCLK频率）。
  4. 检查模式匹配：这是重中之重。用示波器同时捕捉CS、SCLK和MOSI波形。对照从设备数据手册的时序图，检查CPOL和CPHA是否匹配。Mode不匹配会导致采样点错位，读回无效数据。
  5. 检查MISO线：如果主设备发送正常（MOSI有数据），但MISO线始终为高电平（0xFF）或低电平（0x00），可能是从设备未正常工作（供电不足、未初始化、进入休眠模式）、MISO引脚损坏或配置错误（应配置为浮空输入或上拉输入）。

4.2 问题二：SPI时钟（SCLK）无输出

• 现象：用示波器测量SCLK引脚，没有任何波形。
• 排查步骤：
  1. 确认SPI外设已正确初始化和使能：在CubeMX生成的代码中，检查MX_SPI1_Init()函数是否被调用，且没有提前返回错误。
  2. 确认引脚复用配置：STM32的引脚需要配置为复用功能（Alternate Function）并映射到正确的SPI外设。在CubeMX中检查引脚颜色是否已变为绿色（表示已分配功能）。
  3. 检查时钟树：确保SPI外设所在的APB总线时钟已使能且不为0。例如SPI1通常在APB2总线上。
  4. 检查是否有其他代码禁用了SPI：例如低功耗模式下可能关闭了外设时钟。

4.3 问题三：通信速度慢或大数据量传输出错

• 现象：少量数据传输正常，但连续读写大量数据时出错或系统卡死。
• 排查步骤：
  1. 检查DMA配置：对于大数据量传输，应使用DMA而非阻塞式传输（HAL_MAX_DELAY）。检查DMA通道是否配置正确，中断是否开启，缓冲区是否对齐。
  2. 检查缓冲区溢出：确保接收/发送缓冲区大小足够，且指针有效。
  3. 检查从设备忙状态：许多SPI设备（如Flash）在执行写操作或擦除操作时需要时间。主设备在发送下一条指令前，必须通过读状态寄存器等方式确认设备就绪，否则后续指令会被忽略。示例中简单的HAL_Delay在生产环境中是不可靠的。
  4. 降低时钟频率：长距离布线或板子噪声较大时，高频时钟可能导致信号畸变。尝试降低SPI波特率分频系数。

4.4 硬件片选与软件片选的选择

• 硬件片选（Hardware NSS）：将STM32的SPI外设的NSS引脚（如PA4for SPI1）配置为硬件NSS模式。在此模式下，SPI硬件会自动在数据传输开始和结束时控制NSS引脚的电平。这种方式节省CPU开销，但通常一个SPI外设只能控制一个硬件片选。
• 软件片选（Software NSS）：如示例所示，将任意GPIO配置为输出模式，在代码中手动控制其电平。这是最灵活的方式，可以轻松控制多个从设备，也是大多数项目的选择。

建议：在项目初期或从设备多于一个时，优先使用软件片选，控制逻辑更清晰，排错也更方便。

5. 进阶实践与最佳建议

掌握了基础通信和排错后，以下建议能帮助你在实际项目中更稳健地使用SPI。

5.1 编写健壮的SPI驱动层

不要在每个业务函数里直接调用HAL库函数。应抽象出一层驱动，实现以下功能：

• 设备初始化与反初始化。
• 基本的单字节/多字节收发函数。
• 设备特定指令封装（如Flash的读ID、写使能、读状态等）。
• 超时与错误重试机制。
• 互斥锁（如果SPI总线被多个任务共享）。

5.2 使用逻辑分析仪或示波器调试

万用表只能测电平，逻辑分析仪是调试SPI的利器。它能同时捕捉多路信号（CS, SCLK, MOSI, MISO），并以时序波形和协议解码的形式展示出来。你可以直观地看到：

• 片选信号是否在正确的时间有效。
• 时钟频率和模式是否正确。
• 主机发送的数据（MOSI）是否符合从设备指令格式。
• 从设备返回的数据（MISO）是什么。

许多便宜的逻辑分析仪（如Saleae Logic克隆版）配合PulseView软件就能完成这项工作，投资回报率极高。

5.3 不同单片机平台的注意事项

• STM32 (HAL/LL库)：注意时钟配置和引脚复用。LL库提供更底层的寄存器操作，效率更高。
• ESP32：其SPI外设功能强大，支持DMA和多种工作模式，但VSPI和HSPI总线是固定的，需注意引脚映射。
• 51/STC单片机：通常通过软件模拟SPI时序（Bit-banging），需要严格按照时序图在代码中控制引脚电平变化，对时序精度要求高时需注意中断干扰。
• Arduino：使用SPI.h库，注意SPI.setBitOrder(),SPI.setDataMode(),SPI.setClockDivider()等函数来设置模式。

5.4 生产环境检查清单

在将SPI相关功能部署到生产环境前，请对照此清单检查：

SPI协议本身并不复杂，但其稳定性的关键在于对细节的把握：严格遵循从设备的时序要求，在硬件连接和软件配置上做到精确匹配。从理解CPOL/CPHA开始，到用逻辑分析仪验证波形，再到编写带错误处理和状态检查的健壮驱动，每一步都是构建可靠嵌入式系统的基石。当你再次遇到SPI通信故障时，按照从硬件连接到软件时序，从模式匹配到信号质量的路径系统排查，绝大多数问题都能迎刃而解。