小智 AI 免开发环境固件烧录
新手第一次操作，官方 README 建议先不搭建开发环境，直接使用免开发环境烧录固件，固件默认接入 xiaozhi.me 官方服务器。
- 当前发布包为 v2.5.2（按 2026-11-12 抓取的官方 main 分支 / v2.5.2 发布包）
- release 附带 release-manifest.json 与 SHA256SUMS
- 每个固件 ZIP 内都有合并好的 merged-binary.bin
- 共 188 个固件变体、对应 154 个板目录
官方教程为早期固件口径，当前固件以 v2.5.2 发布包为准。
一、找到自己板子的固件
- 打开官方 Releases 页，查看 release-manifest.json，其中每条 variant 记录含 board（厂商/目录）、name、full_name（固件 ZIP 名前缀）、target 字段。按 full_name 找与自己板子对应的 ZIP。预期结果：能检索到自己的板型，例如面包板 WiFi 方案对应 bread-compact-wifi，另有 bread-compact-wifi-128x64、bread-compact-wifi-lcd、bread-compact-ml307 等变体；加装 ML307R（AT）4G 模块选 ML307 版本。
- 下载固件 ZIP 并解压，得到 merged-binary.bin，存放到不含中文字符的目录（建议放到烧录工具的 bin 目录下）。预期结果：路径全英文，bin 文件可被工具加载。
- 旧教程中的 v0.X.X_bread-compact-wifi.zip、v1.5.5、v1.6.0 等固件名为早期口径，仅作对照示例，不要当作当前版本下载；烧录时建议烧录最新固件版本。
二、Flash Download Tool 烧录
- 下载并解压 flash_download_tool_3.9.7 到无中文的目录，双击 flash_download_tool_3.9.7.exe 运行，无需安装。预期结果：工具正常启动。工具与固件路径都不能含中文，否则可能无法加载文件。
- 用能传数据的 Type-C 数据线连接开发板与电脑（不能是 2 芯的普通充电线）。开发板正面 TypeC 接口朝下时，右边的接口为 UART 接口，左边为 USB 接口，不要接错；个别定制板请按 USB 接口正面或背面丝印 COM 识别。预期结果：电脑识别出串口。
- 运行工具，三项选择：芯片类型选 ESP32-S3，工作模式选 Develop，加载模式选 UART。预期结果：进入 SPI 下载设置界面。
- 在第一行空白框点「...」按钮导入解压出的 merged-binary.bin，并勾选 bin 文件前面的复选框（一定要勾选），在后面的输入框填写地址 0x0 或 0x00 或 0（表示下载到开发板存储器 1 区起始位置）。预期结果：bin 已勾选且地址已填。
- 确认 COM 端口：在「此电脑」右键属性、设备管理器、端口（COM 和 LPT）中查看插入开发板对应的 COM 号，不确定可插拔 USB 看新识别的端口。ESP32-S3 开发板常见 CH340/CH343 芯片驱动（端口带 CH34 字样）或 CP210x，CH340/CH343 驱动可在 wch.cn 对应产品页下载。预期结果：工具中选到与设备管理器一致的 COM 口。
- SPI 的 SPEED 和 MODE 保持默认（不要选 QOUT 和 DOUT），波特率可选高一点的。预期结果：配置完成。
- 点 START 开始烧录，进度条出现，直到状态显示 FINISH，一般几分钟到十来分钟。若开发板 sRGB 灯焊点未接通，工具会出现 warning 警告，不影响烧录，可先忽略。预期结果：状态显示 FINISH。
- 烧录完成后点击工具的 RST（Restart）按钮重启开发板，即可进入 Wi-Fi 配网模式。预期结果：sRGB 蓝灯闪烁，进入配网状态。
三、ESP-Launchpad 浏览器烧录
- 用 Chrome 或 Edge 访问 https://espressif.github.io/esp-launchpad/ ，切换到 DIY 菜单页（首页默认烧录 ESP-RainMaker 固件，不用管）。预期结果：页面打开。
- 点 DIY 页面右上方的 Connect，在弹出层选中电脑上开发板的 COM 串口，点连接按钮授权。预期结果：网页显示 Connected to device: ESP32-S3，菜单 Connect 变为 Disconnect。
- 点 DIY 页面中间的选择文件按钮，浏览到 bin 固件所在文件夹，选中后点打开加载。预期结果：页面上显示刚加载的 bin 文件。
- 在 Flash Address 输入框填写 0x0 或 0。固件包已合并为一个 merged-binary.bin，不需要再添加别的 bin。预期结果：地址已填、文件已加载。
- 点 Program 开始烧录，网页自动跳转到 Console 控制台菜单页显示烧录进程。预期结果：控制台黑屏上看到写入完成 100% 并提示 Leaving...。
- 固件烧录完成后设备不会自动重启，需点网页上的 Reset Device 按钮，再点 Confirm 确认重启。预期结果：控制台加载小智终端串口日志，输出中出现网卡地址和 WiFi 配网提示，表示烧录成功。
四、常见异常与进 boot 模式
| 现象 | 处理办法 |
|---|---|
| 开发板连接不上 | 考虑接口插错、多个端口时选错、或 COM 串口被其他软件占用 |
| Program 按钮灰色不能点 | 先确认已显示 Connected to device: ESP32-S3；再按 F5 或 Ctrl+R 刷新页面，重新加载 bin，或断开 Disconnect 后重新 Connect |
| 烧录后程序不断重启或出现 E 级报错 | 多为开发板与固件不匹配，请回到第一步核对板型对应的固件 |
| 需要手动进 boot 模式时 | 按住 BOOT 键不放，再按下 RST 键约 0.5s，然后松开 BOOT 键，串口会出现烧录模式提示，可反复尝试 |