企业官网建设流程全解析

ESP32-S3 多SPI并发翻车？3套引脚方案一次讲透

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32

刚上电的板子，TFT 花屏还没持续三秒，SD 卡就开始报文件系统坏块，紧接着 brownout 重启。排查一周你大概会得出和我一样的结论：ESP32-S3 多SPI并发的问题，九成出在引脚接法和初始化代码上，不在器件本身。

默认引脚定义为何就是冲突源头

冲突的起点就藏在板级定义文件里：variants/esp32s3/pins_arduino.h给整块板子只划出了一组 SPI 物理引脚，四根信号线全部固定：

static const uint8_t SS = 10; static const uint8_t MOSI = 11; static const uint8_t MISO = 13; static const uint8_t SCK = 12;

图1：HSPI VSPI 引脚分配时先对照开发板丝印，避开 Flash/PSRAM 占用脚

再叠加一个容易踩空的事实：S3/S2/C3 上FSPI与HSPI是同一个 GPSPI 控制器的两个别名（见libraries/SPI/src/SPI.cpp末尾的构造逻辑）。你new SPIClass(HSPI)再new SPIClass(VSPI)，只要两组 begin() 想挂两组不同的 SCK，第二个挂载必然失败。也就是说：一条总线可以挂 N 个片选，但要"同时跑"，必须真的有两组独立引脚。

按设备数量选SPI策略

三档策略，先对号入座，再往下读：

1~2个设备：单总线双片选，最小改动

两块芯片共用 SCK/MOSI/MISO，各自独占一根 CS。切换 CS 就是切换设备，硬件零成本，改动量最小。

#include <SPI.h> void setup() { SPI.begin(12, 13, 11, 10); pinMode(9, OUTPUT); // 第二片设备片选 digitalWrite(10, HIGH); digitalWrite(9, HIGH); } void loop() { SPI.beginTransaction(SPISettings(10000000, MSBFIRST, SPI_MODE0)); digitalWrite(10, LOW); SPI.transfer(0x42); digitalWrite(10, HIGH); SPI.endTransaction(); }

⚠️ 这条总线上的时钟必须取最慢那片能吃的频率，快屏跟着传感器降速是常态。

3~4个设备：HSPI与VSPI双总线拆分

到了第三片，就该拆线了。S3 用户侧的 SPI 控制器只有一个，所以拆的不是"控制器"，而是引脚组：一组走默认脚，另一组走任意空闲 GPIO（S3 上 GPSPI 支持 GPIO 矩阵，begin(sck, miso, mosi, ss)传参即可改道，官方示例libraries/SPI/examples/SPI_Multiple_Buses/SPI_Multiple_Buses.ino就是这么干的）。

引脚分配一次到位，别留"以后再说"：

下面这段完成两条总线的初始化，并用 SPI 事务把 CS 拉低到拉高包起来，保证多任务下没人半路插队：

#include <SPI.h> SPIClass *busA = new SPIClass(FSPI); // 默认引脚组 SPIClass *busB = new SPIClass(HSPI); // 别名：同一 GPSPI，走第二组引脚 void setup() { busA->begin(); // SCK12/MISO13/MOSI11 busB->begin(45, 47, 48, 21); // 自定义第二组引脚 pinMode(9, OUTPUT); digitalWrite(9, HIGH); pinMode(21, OUTPUT); digitalWrite(21, HIGH); } void sdRead(uint8_t *buf, size_t len) { busA->beginTransaction(SPISettings(40000000, MSBFIRST, SPI_MODE0)); digitalWrite(10, LOW); busA->transferBytes(nullptr, buf, len); digitalWrite(10, HIGH); busA->endTransaction(); } void tftWrite(uint8_t *buf, size_t len) { busB->beginTransaction(SPISettings(20000000, MSBFIRST, SPI_MODE3)); digitalWrite(21, LOW); busB->transfer(buf, len); digitalWrite(21, HIGH); busB->endTransaction(); }

SPI 事务管理在这里不是仪式感：beginTransaction/endTransaction之外直接调transfer()不会锁参数，多任务里两个任务同时改时钟分频，波形就花了。

图2：两条总线各出一路 SPI 波形的示波实录，SPI 总线分离成功的直接证据

≥5个设备：硬件SPI带2片，其余bit-bang

第五条线接上来时，别再找第三条硬件总线了：S3 的高速 GPIO 控制器就这么多，DMA 通道也是有限资源。现实做法是硬件 SPI 带最吃带宽的 2 片（SD 卡 + 大屏），剩余 3 片交给软件 SPI——bit-bang 不占 DMA 通道，跟硬件总线真并行。传感器跑几百 kHz 绰绰有余。

typedef struct { int sck, mosi, cs; } SPISw; SPISw sw = { .sck = 5, .mosi = 6, .cs = 7 }; uint8_t swTransfer(uint8_t out) { uint8_t in = 0; for (int i = 7; i >= 0; i--) { digitalWrite(sw.mosi, (out >> i) & 1); digitalWrite(sw.sck, HIGH); in = (in << 1) | digitalRead(sw.misi); digitalWrite(sw.sck, LOW); } return in; } void swWrite(uint8_t *buf, size_t len) { digitalWrite(sw.cs, LOW); for (size_t i = 0; i < len; i++) swTransfer(buf[i]); digitalWrite(sw.cs, HIGH); }

DMA 通道的分配不用手动：Arduino 的 SPI 驱动对 64 字节以上的批量transfer自动走 DMA，小于 64 字节走 FIFO。所以 DMA 通道优化的要点不是抢通道，而是把批量传输攒大——1 KB 一次搬运和 1 KB 拆 16 次 64 字节，前者才进 DMA，CPU 占用差一个量级。

验证与排障

引脚分完了，怎么确认没接错？上电自检走一遍 5 步：

1. 两个 begin() 都返回 true
2. 逻辑分析仪看第二路 SCK 有波形
3. 只拉低 CS-A，确认 CS-B 无时钟
4. 模式与器件 datasheet 一致
5. 满速压 10 分钟，复位计数为 0

第 2 步最容易翻车：很多人以为"双总线"生效了，其实第二路根本没有时钟出来。压一压底，用这段骨架跑一分钟，错误率低于百万分之一才算过关：

void stressSPI(SPIClass *a, SPIClass *b) { uint32_t bad = 0, n = 1000000; for (uint32_t i = 0; i < n; i++) { size_t len = 4 + (i & 4095); a->beginTransaction(SPISettings(20000000, MSBFIRST, SPI_MODE0)); a->transferBytes(nullptr, nullptr, len); a->endTransaction(); b->beginTransaction(SPISettings(10000000, MSBFIRST, SPI_MODE3)); b->transfer(0xA5); b->endTransaction(); if (i % 100000 == 0) { Serial.printf("%u bad=%u\n", i, bad); } } Serial.printf("err rate: %.4f%%\n", bad * 100.0 / n); }

两个高频故障，现象-根因-修复直接抄：

故障一：第二条总线 begin() 返回 false。现象：总线一初始化就失败，串口打出 "Attaching pins to SPI failed"。根因：选的 GPIO 撞进 Flash/PSRAM 占用区，或两个实例都往同一个控制器挂不同 SCK。修复：换到空闲 GPIO，确认两次 begin() 都返回 true。

故障二：双屏显示错乱，疑似并发冲突。现象：两屏互相串画面，降速就好。根因：第二总线根本没跑起来，两屏实际共用一条物理线，只是 CS 不同。修复：把第二块屏的 SCK/MOSI/MISO 改接到第二组 GPIO，begin 传参。

说到底，ESP32-S3 多SPI并发的解法很朴素：一条总线只挂一组物理引脚，芯片多了就拆线或 bit-bang，并发能力由物理接线决定，不靠运气。想抄作业的话，从 libraries/SPI/examples/SPI_Multiple_Buses/ 开始改最快。

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32