基于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上升沿或事务结束时产生中断。

二、配置步骤

  1. 选择SPI外设:ESP32有SPI1/SPI2/SPI3,其中SPI1通常用于Flash,建议使用SPI2(HSPI)或SPI3(VSPI)作为从机。
  2. 配置GPIO矩阵:将SCLK、MOSI、MISO、CS映射到空闲引脚,注意输入输出方向。
  3. 设置从机模式:使能SPI_SLAVE_REG中的从机位,配置CS极性。
  4. 配置时序:根据主机CPOL/CPHA设置SPI_CTRL_REG中的时钟极性位,确保采样边沿一致。
  5. 配置DMA:分配收发缓冲区,设置DMA描述符链。
  6. 注册中断:在事务完成或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可以灵活嵌入各类主从架构,扩展通信能力。