基于ESP32的SPI从机模式实现:寄存器配置与主机时序对齐实战
ESP32的SPI外设默认以主机模式工作,但在实际项目中,ESP32常需要作为从机与FPGA、STM32主控或专用芯片通信。从机模式对时序和寄存器配置更敏感,稍有不慎就会出现数据错位、丢包或总线挂死。本文以ESP-IDF的spi_slave驱动为基础,结合寄存器级配置,讲清从机模式的实现要点。
一、SPI从机模式原理
SPI从机与主机的核心区别在于时钟来源:从机不产生SCLK,而是由主机提供。ESP32的SPI从机需要关注以下信号:
- SCLK:主机输出,从机输入,决定采样/移位的节奏。
- MOSI:主机输出从机输入,从机在对应边沿采样。
- MISO:从机输出主机输入,从机在对应边沿移位输出。
- CS:片选,低有效,从机据此判断一帧的开始与结束。
ESP32的SPI从机支持全双工,内部通过GPIO矩阵将信号映射到任意引脚。关键寄存器包括:
-
SPI_CMD_REG:启动/停止传输。 -
SPI_USER_REG:配置DOUTDIN、FDUMMY等位。 -
SPI_CTRL_REG:设置位宽、时钟极性。 -
SPI_SLAVE_REG:从机模式使能、CS检测。 -
SPI_DMA_CONF_REG:DMA缓冲配置。
从机模式下,ESP32通过DMA将接收数据写入缓冲区,并在CS上升沿或事务结束时产生中断。
二、配置步骤
- 选择SPI外设:ESP32有SPI1/SPI2/SPI3,其中SPI1通常用于Flash,建议使用SPI2(HSPI)或SPI3(VSPI)作为从机。
- 配置GPIO矩阵:将SCLK、MOSI、MISO、CS映射到空闲引脚,注意输入输出方向。
-
设置从机模式:使能
SPI_SLAVE_REG中的从机位,配置CS极性。 -
配置时序:根据主机CPOL/CPHA设置
SPI_CTRL_REG中的时钟极性位,确保采样边沿一致。 - 配置DMA:分配收发缓冲区,设置DMA描述符链。
- 注册中断:在事务完成或CS上升沿触发中断,读取数据。
三、完整代码示例
以下代码基于ESP-IDF,使用SPI2作为从机,主机每次发送4字节,从机回传4字节。
#include "driver/spi_slave.h"
#include "driver/gpio.h"
#include "esp_log.h"
#define PIN_SCLK 18
#define PIN_MOSI 23
#define PIN_MISO 19
#define PIN_CS 5
static const char *TAG = "SPI_SLAVE";
void app_main(void)
{
// 1. 配置SPI总线
spi_bus_config_t buscfg = {
.mosi_io_num = PIN_MOSI,
.miso_io_num = PIN_MISO,
.sclk_io_num = PIN_SCLK,
.quadwp_io_num = -1,
.quadhd_io_num = -1,
.max_transfer_sz = 32,
};
// 2. 配置从机接口
spi_slave_interface_config_t slvcfg = {
.mode = 0, // CPOL=0, CPHA=0
.spics_io_num = PIN_CS,
.queue_size = 3,
.flags = 0,
};
// 3. 初始化总线与从机
ESP_ERROR_CHECK(spi_slave_initialize(SPI2_HOST, &buscfg, &slvcfg, SPI_DMA_CH_AUTO));
// 4. 准备收发缓冲区
uint8_t tx_buf[4] = {0x11, 0x22, 0x33, 0x44};
uint8_t rx_buf[4] = {0};
spi_slave_transaction_t t = {
.length = 4 * 8, // 位长度
.tx_buffer = tx_buf,
.rx_buffer = rx_buf,
};
while (1) {
// 5. 等待主机事务
esp_err_t ret = spi_slave_transmit(SPI2_HOST, &t, portMAX_DELAY);
if (ret == ESP_OK) {
ESP_LOGI(TAG, "RX: %02X %02X %02X %02X",
rx_buf[0], rx_buf[1], rx_buf[2], rx_buf[3]);
} else {
ESP_LOGE(TAG, "SPI slave transmit failed: %s", esp_err_to_name(ret));
}
}
}
四、主机时序对齐要点
从机模式最容易出问题的是时序对齐。需重点确认:
- CPOL/CPHA一致:主机与从机的模式必须相同。模式0(CPOL=0,CPHA=0)最常见,数据在SCLK上升沿采样。
- CS建立/保持时间:主机拉低CS后应等待至少一个SCLK周期再发时钟,避免从机未就绪。
-
位宽匹配:
length以位为单位,必须与主机实际发送位数一致,否则DMA会等待超时。 - MISO方向切换:从机在CS有效期间驱动MISO,CS无效后释放,避免总线冲突。
- 时钟频率:ESP32从机最高支持约10MHz,实际建议不超过8MHz,留出余量。
五、注意事项
- 不要使用SPI1:SPI1连接Flash,复用会导致系统崩溃。
- DMA缓冲区对齐:收发缓冲区建议4字节对齐,避免DMA异常。
- 中断优先级:从机中断不宜过高,避免影响WiFi/BT任务。
- CS抖动:若主机CS信号有毛刺,可在GPIO上增加RC滤波或软件去抖。
- 调试手段:用逻辑分析仪抓取SCLK、MOSI、MISO、CS四线,确认采样边沿与数据稳定区。
六、总结
ESP32 SPI从机模式的核心是“寄存器配置正确 + 时序与主机严格对齐”。通过spi_slave_initialize完成基础配置后,重点检查CPOL/CPHA、CS时序和位宽匹配。配合逻辑分析仪验证,可快速定位数据错位问题。掌握从机模式后,ESP32可以灵活嵌入各类主从架构,扩展通信能力。
暂无评论,来抢沙发~