单片机与物联网 / 系统课时
SPI 设备通信
SPI 设备通信
SPI 通过同步时钟在主机与外设之间高速交换数据。本课将把 SCK、MOSI、MISO 和片选信号连成完整通信链路,并用 STM32 HAL 读取 SPI Flash 的 JEDEC ID,验证时钟模式、片选控制和基础收发是否正确。
学习目标
- 说明 SCK、MOSI、MISO 与 CS 的职责
- 根据外设手册选择正确的 CPOL 和 CPHA
- 使用 HAL 完成一次带片选控制的 SPI 收发
SPI 通信的关键角色
SPI 通常由主机产生时钟,并用独立片选线决定当前与哪个从设备通信。SCK 负责同步位传输,MOSI 承载主机发出的数据,MISO 返回从设备数据,CS 在一次事务开始前拉到有效电平,事务结束后恢复无效电平。
SPI 没有统一的地址、应答和重发机制。命令格式、寄存器地址、连续读写规则都由具体器件定义,因此接线正确只代表总线具备通信条件,真正收发前还必须阅读器件数据手册。

四种时钟模式
时钟极性 CPOL 决定空闲时 SCK 的电平,时钟相位 CPHA 决定接收方在第一个还是第二个有效边沿采样。主机与从设备必须使用同一种模式,否则常见现象是数据整体错位、读值不稳定或始终得到错误字节。
| SPI 模式 | CPOL | CPHA | 空闲电平 | 采样边沿 |
|---|---|---|---|---|
| Mode 0 | 0 | 0 | 低 | 第一个边沿,上升沿 |
| Mode 1 | 0 | 1 | 低 | 第二个边沿,下降沿 |
| Mode 2 | 1 | 0 | 高 | 第一个边沿,下降沿 |
| Mode 3 | 1 | 1 | 高 | 第二个边沿,上升沿 |
器件手册若写明“数据在上升沿锁存、时钟空闲为低”,通常对应 Mode 0。不要只凭示例工程猜测模式,还要核对最大时钟频率、位序是 MSB First 还是 LSB First,以及 CS 的有效电平。

CubeMX 配置与基础收发
以常见 SPI Flash 为例,可将 SPI1 配置为 Master、Full-Duplex、8-bit、MSB First、软件管理 NSS,并按芯片手册选择 Mode 0。首次联调时应使用较低分频,确认通信稳定后再提高速率。
下面是片段示例,依赖 STM32CubeMX 已生成的 SystemClock_Config、MX_GPIO_Init、MX_SPI1_Init 和 hspi1。CS 使用普通 GPIO 控制,读取命令 0x9F 后连续接收三个 JEDEC ID 字节。
#include "main.h"
#include "gpio.h"
#include "spi.h"
#define FLASH_CS_PORT GPIOA
#define FLASH_CS_PIN GPIO_PIN_4
static HAL_StatusTypeDef SPI_ReadJedecId(uint8_t id[3])
{
const uint8_t command = 0x9F;
HAL_StatusTypeDef status = HAL_OK;
/* 一次完整事务必须在 CS 拉低后开始,并在任何退出路径上恢复 CS。 */
HAL_GPIO_WritePin(FLASH_CS_PORT, FLASH_CS_PIN, GPIO_PIN_RESET);
if (HAL_SPI_Transmit(&hspi1, (uint8_t *)&command, 1, 100) != HAL_OK) {
status = HAL_ERROR;
} else if (HAL_SPI_Receive(&hspi1, id, 3, 100) != HAL_OK) {
status = HAL_ERROR;
}
HAL_GPIO_WritePin(FLASH_CS_PORT, FLASH_CS_PIN, GPIO_PIN_SET);
return status;
}
int main(void)
{
volatile uint8_t jedec_id[3] = {0};
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
MX_SPI1_Init();
if (SPI_ReadJedecId((uint8_t *)jedec_id) != HAL_OK) {
jedec_id[0] = 0xFF;
jedec_id[1] = 0xFF;
jedec_id[2] = 0xFF;
}
while (1) {
}
}预期结果
在调试器中观察 jedec_id。
连接 W25Q128 时,典型值为 EF 40 18。
实际型号不同,三个字节会随厂商、存储类型和容量变化。验证与典型故障
先确认 CS 空闲为高,调用期间出现一次完整低脉冲;再确认 SCK 的空闲电平和采样边沿符合外设手册;最后检查 MOSI 是否发出 0x9F,MISO 是否返回三个稳定字节。逻辑分析仪能同时看到四根信号,是定位模式和片选问题最直接的方法。
读回全为 0xFF 时,常见原因是从设备未被选中、MISO 悬空或器件未供电;全为 0x00 时,应检查 MISO 短路、复位状态和时钟模式。偶发错误则优先降低 SPI 时钟,并检查连线长度、地线和电源去耦。