查找支持的开发板与变体
“这块板在出售”“芯片是 S3”和“所选固件支持它”是不同信息。以固件仓库和当前构建目录核对实际支持范围。
先识别硬件
准备板卡正反面丝印、主控/Flash/PSRAM、屏幕和音频芯片型号，以及 Wi-Fi/4G 等通信方式。同一系列不同修订版可能使用另一组引脚。
1. 在现行目录中查找
sh
python scripts/build.py --list-boards
python scripts/build.py --list-boards --json列表的目录名、板型类型、构建名称各有用途；发布包有时还包含制造商前缀。匹配完整身份，不只比较文件名里是否含“C3”或“S3”。
2. 找到适合的指南
| 硬件 | 本站入口 |
|---|---|
| S3 + I2S 麦克风 + OLED | 基础面包板 |
| S3 + SPI LCD | 彩屏扩展 |
| 带摄像头的 S3 方案 | 摄像头面包板 |
| C3 + ES8311 | C3 面包板或Xmini 系列 |
| 经典 ESP32 | 经典 ESP32 面包板 |
| SF32LB52 | 独立 SF32 插件版项目，不使用 ESP32 固件 |
没有本站专页的板仍可能被固件支持，先看版本化 boards 目录和板内 README。
3. 选择固件
找到准确变体后，优先使用在线编译并烧录；需要离线安装或固定版本时再从官方发布获取固件。若自己改过引脚，应建立独立板型，而不是接受标准板的 OTA 身份。
停售、缺货或商家链接失效不等于已经取消固件支持。采购渠道单独维护，价格与库存以商家当前页面为准。
完成标志
实物、构建目录、变体、内存和外设可以一一对应；没有靠“名字最接近”选择固件。