先定板子，再定固件
小智的发布包按「板卡目录 + 固件变体」组织，烧错固件轻则屏幕不显示，重则反复重启，所以选板与选固件要一起做。先把三组官方数字摆出来（均按 2026-11-12 抓取）：
| 来源 | 口径 | 数字 |
|---|---|---|
| 官方 README 的硬件一节 | 「支持 138 个板卡目录、171 个固件发布变体」，其「近期更新」一节也写「当前矩阵包含 171 个变体」 | 138、171 |
| 官方 v2.5.2 发布包的 release manifest | board_count=154、firmware_count=188，发布自述同样写明 188 firmware variants for 154 board directories | 154、188 |
| 官方自定义开发板指南开头 | 「支持 70 多种 ESP32 系列开发板」，属于该文档的旧口径 | 70 多种 |
三组数字来自三份不同时间的官方材料，实际查找固件时一律以 v2.5.2 发布包的 manifest 为准，本页不把任何一个数字写成唯一真理。
manifest 字段与命名规则
v2.5.2 发布包的 release-manifest.json 中，每个变体有四个字段：
| 字段 | 含义 | 示例 |
|---|---|---|
| board | 厂商/板卡目录 | alientek/atk-dnesp32s3 |
| name | 板内变体名 | |
| full_name | 固件 ZIP 名前缀 | alientek-atk-dnesp32s3 |
| target | 芯片目标 |
manifest 顶层还有 schema_version、version、tag、source_sha、idf_version、board_count、firmware_count、variants 等字段，按本发布包口径 idf_version=6.1.0。target 分布为 esp32s3 126、esp32p4 27、esp32c3 10、esp32c6 10、esp32 7、esp32s31 4、esp32c5 4，esp32s3 是数量最多的目标；其中 ESP32-S31 变体需要 IDF 6.1 或以上版本，对自行编译的玩家有影响。
同一块板可以有多个变体：waveshare/esp32-p4-wifi6-touch-lcd 一个目录下有 18 个变体，对应不同外设组合；bread-compact-wifi 目录下有 bread-compact-wifi、bread-compact-wifi-128x64、bread-compact-wifi-lcd 等变体，按屏幕配置区分。
board 以 bread- 开头的面包板系列共 10 个变体（如 bread-compact-esp32、bread-compact-ml307、bread-compact-nt26、bread-compact-wifi-s3cam 等），覆盖 Wi-Fi、ML307、NT26 联网方式与 128x32、128x64、LCD 屏幕配置。
manifest 里可检索到的常见板还有 espressif-esp-box-3、lckfb-lichuang-dev（立创实战派）、lckfb-lichuang-c3-dev、magiclick-2p4（神奇按钮 2.4）、xmini-c3（虾哥 Mini C3）及其 4G、v3 变体，以及 m5stack-atom-echos3r、m5stack-core-s3 等多款 M5Stack 板。
按自己的板子在发布包里找 ZIP
- 打开 v2.5.2 发布包的 release-manifest.json，用板子型号、厂商名或别名搜索（如 lckfb、esp-box-3、m5stack、bread）。预期结果：找到 board、name、full_name、target 四字段齐全的条目，例如 full_name 为 lckfb-lichuang-dev。
- 按 full_name 前缀在发布页 assets 里找同名的固件 ZIP（发布包共 190 个 assets，另含 release-manifest.json 与 SHA256SUMS，可校验下载完整性）。预期结果：拿到与 manifest 条目同名的 ZIP，解压出合并 bin。
- 把解压出的 bin 放到不含中文字符的目录，转入烧录流程。预期结果：本地有可烧录的 bin 文件，路径全英文，板型与固件的对应关系已核对。
manifest 中检索不到的板子没有现成固件，官方教程明说直接烧录其他板的程序可能无法运行，需要按自定义开发板指南改源码重新编译适配，路线见「自定义开发板」专页。
面包板方案：认准 N16R8，分清接线版本
自己搭面包板的玩家，官方硬件清单要求开发板选 ESP32-S3-DevKitC-1 的 WROOM N16R8 模组，即 16MB Flash + 8MB PSRAM；若用 N8R2，需要把 PSRAM 工作模式从 OCTAL 改为 QUAD、Flash 大小改为 8MB、自定义分区表改为 partitions_8M.csv，再重新编译固件，不适合走免编译路径的玩家。
另外部分开发板的 RGB 灯没有接通，需焊接灯座旁的两个小焊点才能显示状态。麦克风、功放、屏幕、4G 模块等配套清单见「面包板硬件清单与接线」专页。
开发板还分 44 引脚乐鑫标准版与 42 引脚果云版两种常见板型：两者的外部模块接线一致、使用同样的程序固件，但板载排布不同——版本 1 左上方的 3V3 供电口在版本 2 调整到左下方，版本 2 左边增加了 GPIO19、GPIO20、多了 4 个固定开孔，也少了左右最下方的两个 GND，接线时按各自表格对照。
接线方案另有第一版与新版/第二版之分：新版/第二版接线方案适用于固件版本不低于 V0.3.0，两版接线方案的固件互不兼容，固件版本在 0.3 之前的均采用第一版接线方案；官方教程还提供 Duplex 与 Simplex 两种 I2S 接线模式，默认配置使用 Simplex 模式。
官方教程为早期固件口径，当前固件以 v2.5.2 发布包为准；烧录 bread 系列变体前，务必核对手上的接线属于哪一版。购买第三方开发板或成品时，先向卖家确认板型与固件变体名，再按上面的步骤在发布包里找对应 ZIP。