单片机与物联网 / 系统课时
使用 SPI 通信
使用 SPI 通信
SPI 适合连接 ADC、显示屏、存储器等需要较高吞吐量的外设。本课以 ESP32 读取 MCP3008 ADC 为例,完成时钟、MISO、MOSI、片选和通信模式配置,并通过一次完整事务读取 10 位采样值,建立可迁移到其他 SPI 器件的操作方法。
学习目标
- 能区分 SCK、MOSI、MISO、CS 四类信号的职责并正确接线。
- 能根据数据手册设置 SPI 时钟频率、位序和模式。
- 能使用事务 API 完成片选控制、字节传输和结果解析。
接线和模式必须同时匹配
SPI 没有统一的设备地址,主机通常通过独立的 CS 线选择外设。以经典 ESP32 VSPI 常用引脚为例,可将 SCK、MISO、MOSI、CS 分别接到 GPIO 18、19、23、5;MCP3008 使用 3.3 V 供电时可直接与 ESP32 的 3.3 V 逻辑配合。

除接线外,还要从数据手册确认 SPI_MODE0~SPI_MODE3、最高时钟频率以及位序。MCP3008 支持 Mode 0 或 Mode 3,本例选择 SPI_MODE0,并将时钟设为 1 MHz,低于器件上限,便于初次联调。
一次 SPI 事务的边界
访问某个 SPI 外设时,应先调用 SPI.beginTransaction() 固定本次事务的频率、位序和模式,再把 CS 拉低,随后按设备协议调用 SPI.transfer(),最后把 CS 拉高并结束事务。
CS 的拉低到拉高定义了外设如何解释这一串时钟。不能只保证“传了三个字节”,还要保证字节出现在正确的 CS 窗口内。多个 SPI 外设共享 SCK、MOSI、MISO 时,也正是依靠各自的 CS 避免同时响应。
读取 MCP3008 通道
MCP3008 的单端读取需要发送启动位、单端选择位和通道号。下面程序读取 CH0,把返回的 10 位 ADC 原始值换算成基于 3.3 V 参考电压的近似电压。
#include <Arduino.h>
#include <SPI.h>
constexpr uint8_t PIN_SCK = 18;
constexpr uint8_t PIN_MISO = 19;
constexpr uint8_t PIN_MOSI = 23;
constexpr uint8_t PIN_CS = 5;
constexpr float VREF = 3.3f;
uint16_t readMcp3008(uint8_t channel) {
if (channel > 7) {
return 0;
}
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(PIN_CS, LOW);
SPI.transfer(0x01);
uint8_t high = SPI.transfer(static_cast<uint8_t>((0x08 | channel) << 4));
uint8_t low = SPI.transfer(0x00);
digitalWrite(PIN_CS, HIGH);
SPI.endTransaction();
// 返回数据的低 10 位由第二、第三个接收字节组成。
return static_cast<uint16_t>(((high & 0x03) << 8) | low);
}
void setup() {
Serial.begin(115200);
pinMode(PIN_CS, OUTPUT);
digitalWrite(PIN_CS, HIGH);
SPI.begin(PIN_SCK, PIN_MISO, PIN_MOSI, PIN_CS);
}
void loop() {
uint16_t raw = readMcp3008(0);
float voltage = raw * VREF / 1023.0f;
Serial.printf("CH0 raw=%u, voltage=%.3f V\n", raw, voltage);
delay(1000);
}预期输出
CH0 raw=<VALUE>, voltage=<VALUE> V<VALUE> 会随 CH0 输入电压变化;输入接近 0 V 时原始值应接近 0,输入接近 3.3 V 时应接近 1023。实际读数还会受到参考电压误差和模拟噪声影响。
读数异常时检查四个边界
始终读到 0 或满量程时,先确认模拟输入范围没有超过 MCP3008 的参考电压,并检查 AGND、DGND 与 ESP32 是否共地。读数随机跳变时,再检查 MISO/MOSI 是否接反、CS 是否真正拉低,以及信号线是否过长。
如果逻辑看似正确但外设完全不响应,优先核对 SPI mode 和时钟上限。模式不匹配会让主机和外设在错误的时钟边沿采样,而过高时钟可能造成偶发错误。稳定的 SPI 程序应把“引脚、CS 边界、模式、频率、字节协议”视为一个整体,而不是只关注 SPI.transfer()。