固件烧录
根据固件来源选择操作方式:
| 使用场景 | 操作入口 |
|---|---|
| 已获取示例源码,需要编译并下载 | 使用源码构建固件 |
| 已获取带版本、地址和镜像说明的固件包 | 使用预编译固件 |
| 电脑无法连接下载端口,或程序占用了 USB 引脚 | 手动进入下载模式 |
| 下载完成,需要确认程序是否正常运行 | 烧录后检查 |
当前预编译固件入口待补充。资料中保留的测试 BIN 尚缺烧录元数据,使用条件见 保留测试镜像的使用条件。
使用源码构建固件
按 ESP-IDF 开发 安装指定版本环境,在 VS Code 中打开所需示例文件夹。通过 ESP-IDF 扩展依次执行编译、选择端口和烧录,详细步骤见 编译与下载。
该方式使用同一次构建生成的镜像及烧录参数,不能只将应用 .bin 当成完整合并固件下载。
使用预编译固件
已确认的固件下载地址及操作截图待补充,入口见 ESP32-S31-Zero 示例程序与固件。
获取预编译固件后,先确认以下内容,再使用配套烧录工具:
- 固件目标明确为
esp32s31,并与所用硬件及外接设备匹配。 - 固件包明确记录源码版本、ESP-IDF 版本、镜像类型和烧录参数。
- 烧录工具支持 ESP32-S31,并能识别实际连接的端口。
- 分段镜像地址使用同次构建的
flasher_args.json或固件包清单;合并镜像地址使用包内声明值,不根据文件名猜测。
示例仓库提供的固件打包工具可生成含 manifest.json、校验文件、分段镜像和合并镜像的包,但存在打包工具不代表已有可下载或已验证的发布固件。
保留测试镜像的使用条件
资料中保留了 ESP32-S31-Zero-Test.bin,其对应源码提交、框架版本、合并镜像基址和配套转接板及外接设备要求尚未确认。该文件名不能用来推断烧录地址,也不能认定它与当前 11_board_test 工程构建结果相同。
在补齐原始构建与烧录信息前,不提供该镜像的烧录命令。
手动进入下载模式
通过 Type-C 接口连接电脑。如自动下载连接失败:
- 按住 BOOT 按键。
- 按下并松开 RESET 按键。
- 松开 BOOT,确认设备管理器中当前端口。
- 在烧录工具中选择该端口并重新下载。
下载完成后,松开 BOOT 并按 RESET 运行程序。普通运行状态下不要持续按住 BOOT 复位。
烧录后检查
- 按对应示例检查控制台和外设现象,不用单次下载成功替代功能验证。
- 示例 11 会在显示启动后占用 USB Serial/JTAG 的 GPIO33、GPIO34;USB 控制台断开需结合接口复用判断。
- 如果固件不能启动,先核对目标、框架、Flash 参数、分区和外接设备,再查看 常见问题。