ESP32-S3实战指南：SPI总线配置与多设备管理

最新推荐文章于 2026-06-25 16:23:33 发布

原创

最新推荐文章于 2026-06-25 16:23:33 发布 · 469 阅读

实战派 ESP32-S3，双模无线开发板

ESP32-S3 原生支持 ESP-IDF，WiFi + 蓝牙一次搞定

点击查看

1. 从零开始：理解ESP32-S3的SPI总线

如果你刚拿到ESP32-S3开发板，想用它连接个屏幕、读个SD卡或者驱动个传感器，那你大概率会碰到一个叫SPI的东西。别被这个缩写吓到，它其实就是一种非常常见的“聊天”协议，让芯片和外设能互相传数据。你可以把它想象成一条多车道的公路，ESP32-S3是交警兼收费站，而各种外设（比如Flash存储芯片、ADC模数转换器）就是路上跑的不同车辆。我们今天要做的，就是学会怎么修好这条路（配置SPI总线），并且管理好路上同时跑的多种车辆（多设备管理）。

ESP32-S3内部其实有4条这样的“公路”，编号是SPI0到SPI3。但这里有个坑你得先知道：SPI0和SPI1这两条“高速路”通常被系统内部征用了，专门用来连接板载的Flash闪存或者PSRAM内存。所以，留给我们自由发挥的，一般就是SPI2和SPI3这两条“省道”。这就像你家房子有四个车库，但两个已经停了自家的车，剩下两个才能用来接待客人的车。

SPI通信有几个关键角色，对应着开发板上的几个物理引脚（GPIO）。SCLK是时钟线，像节拍器一样，所有数据传输都踩着它的点子进行。MOSI是主设备输出、从设备输入线，数据从ESP32-S3流向外部设备。MISO则相反，是主设备输入、从设备输出线，数据从外部设备流回ESP32-S3。最后是CS，也叫片选线，这是实现“一拖多”的关键。每条SPI总线（比如SPI2）的SCLK、MOSI、MISO是大家共用的，但每个外设都有自己独立的CS线。只有当ESP32-S3把某个外设的CS线拉低（激活）时，它才“听得到”总线上的对话，其他CS线为高电平的外设则自动“装聋作哑”。这就好比在同一条广播频道上，给每个外设分配了不同的呼叫码，只有呼叫码匹配的设备才会响应。

我刚开始玩的时候，总觉得配置SPI一堆参数很头疼。但后来发现，只要抓住两个核心步骤就清晰了：第一步是初始化SPI总线本身，也就是把共用的那几条车道（SCLK、MOSI、MISO）规划好；第二步是往这条总线上添加具体的设备，给每个设备分配一个独立的“收费站口”（CS引脚）并设置它的通行规则（比如速度多快）。下面，我们就一步步拆解开来实操。

2. 第一步：SPI总线初始化配置详解

初始化总线，相当于为我们的数据公路打下地基。在ESP-IDF框架下，这个工作主要由 spi_bus_initialize 这个函数来完成。它需要三个参数，我们一个一个来啃透。

2.1 选择你的主机：host_id参数

这个参数最简单，就是告诉程序你要用哪条SPI总线。根据我们前面说的，通常就选 SPI2_HOST 或 SPI3_HOST。在代码里，它是一个枚举类型。这里有个小细节，有些教程里可能还会看到 SPI1_HOST，但在ESP32-S3上，除非你很清楚自己在做什么，否则最好别用SPI1，它可能和一些内部功能有冲突。我的经验是，如果项目不复杂，直接无脑选 SPI2_HOST 就行，这是最省心、兼容性最好的选择。

2.2 配置公路参数：spi_bus_config_t结构体

这是配置的重头戏，一个结构体里包含了十多个字段。别慌，大部分情况下我们只需要关心其中几个关键的，其他的用默认值-1填充即可。

spi_bus_config_t bus_config = {
    .mosi_io_num = GPIO_NUM_7,  // 主出从入引脚，接外设的SDI或DI
    .miso_io_num = GPIO_NUM_6,  // 主入从出引脚，接外设的SDO或DO
    .sclk_io_num = GPIO_NUM_5,  // 时钟引脚
    .quadwp_io_num = -1,        // 写保护引脚，普通SPI用不到
    .quadhd_io_num = -1,        // 保持引脚，普通SPI用不到
    .max_transfer_sz = 4092,    // 单次DMA传输最大字节数
    .flags = SPICOMMON_BUSFLAG_MASTER, // 明确我们是主模式
    .intr_flags = ESP_INTR_FLAG_IRAM // 中断标志，追求高性能时设置
};

引脚分配：mosi_io_num、miso_io_num、sclk_io_num 这三个是必须指定的。你需要根据你的电路原理图，把外设对应的引脚号填进去。ESP32-S3的大部分GPIO都可以复用为SPI功能，非常灵活。但要注意，有些引脚有特殊限制，比如一些引脚在芯片启动时会有上拉或下拉，如果设计不当可能导致设备初始化不正常。我一般会避开GPIO0、GPIO2这些在启动时有特殊功能的引脚。

传输大小：max_transfer_sz 这个参数决定了单次通过DMA能传输的最大数据量。如果你启用了DMA（后面会讲），默认值4092字节对于大多数应用都足够了。但如果你要传输一张图片或者大量的音频数据，可能需要调大这个值。不过也别盲目设得巨大，因为它会占用内部DMA缓冲区内存。

标志位：flags 字段里，SPICOMMON_BUSFLAG_MASTER 是最常用的，表明ESP32-S3作为主设备。如果你的应用里SPI总线很长，或者线上有干扰，可以加上 SPICOMMON_BUSFLAG_IOMUX_PINS 来强制使用IO_MUX功能，这能获得更好的信号完整性，但可选的引脚就受限了。

2.3 要不要上DMA？dma_chan参数抉择

DMA（直接内存访问）是个好东西。它允许数据在外设和内存之间直接搬运，而不需要CPU核心插手。这意味着在传输大量数据时，CPU可以去处理其他任务，系统效率更高。对于ESP32-S3，这个参数通常有两个选择：SPI_DMA_DISABLED 和 SPI_DMA_CH_AUTO。

如果你只是偶尔读几个字节的传感器数据，用不用DMA差别不大，甚至禁用DMA代码更简单。但如果你要驱动屏幕进行刷屏，或者高速读写SD卡，强烈建议启用DMA。选择 SPI_DMA_CH_AUTO 让驱动自动分配DMA通道就行，非常省心。启用DMA后，你会发现 spi_device_transmit 这种传输函数在数据搬运期间CPU占用率几乎为零。

这里我踩过一个坑：早期我为了省事，所有项目都禁用DMA。后来做一个音频流项目时，SPI传输大量音频数据导致CPU负载过高，系统其他任务（比如处理Wi-Fi）就卡顿了。启用DMA后，问题迎刃而解。所以，如果你的项目涉及实时性要求高或大数据量传输，别犹豫，直接用DMA。

把上面这些参数都填好，调用 spi_bus_initialize(SPI2_HOST, &bus_config, SPI_DMA_CH_AUTO)，如果返回 ESP_OK，恭喜你，SPI总线这条“公路”的基础设施就建好了！但这路上还没有车（设备），接下来我们就得往上面添加“车辆”。