ESP32 拿到多个 bin,怎样区分合并包和分地址烧录
ESP32 拿到多个 bin,先找发布包里的构建烧录清单,不要凭文件名猜地址。bootloader.bin、partition-table.bin 与应用 bin 常分别放在不同偏移;合并包则把这些地址关系编码进一个文件。重复叠加偏移,可能把本来正确的镜像整体写错位置。
三种交付形式分开看
第一种是多个 BIN 加“偏移—文件”清单,write-flash 接受多组这样的参数。第二种是 raw 合并 BIN,文件内的间隙通常以 FF 填充,发布方应交代文件对应的目标起始地址。第三种是 Intel HEX,记录中包含地址且可以不填充间隙,不能只改扩展名假装两种格式等价。
以下仅采用乐鑫文档中原版 ESP32 的示例关系:bootloader 为 0x1000、分区表为 0x8000、app 为 0x10000。ESP32-S3 和自定义配置可能不同;现场应读取本工程 build 目录里的 flash_args 等构建产物,并记录目标芯片。文件叫 esp32.bin 不能证明适配哪一款板。
| 文件角色 | 分文件示例偏移 | 默认 raw 合并文件中的位置 |
|---|---|---|
| bootloader | 0x1000 | 距合并基址 0 的 0x1000 |
| partition-table | 0x8000 | 距基址 0 的 0x8000 |
| app | 0x10000 | 距基址 0 的 0x10000 |
这不是可直接用于任意开发板的烧录表。分区表决定应用与数据范围,偏移还受构建配置影响,必须将清单、芯片与包版本作为一个整体核对。
先做不写设备的包检查
保存原始压缩包和文件摘要,展开发布说明,逐项列出文件大小、偏移、目标芯片与用途。使用本机 esptool 的 image-info 检查可识别映像信息,但它不能从一个 app 的头部推断所有板级引脚和资源适配。对 raw 合并文件,它能分析的信息也不等于重建完整发布清单。
如果有工程,在 build 目录使用官方文档给出的思路,从 flash_args 合并到新文件;这一步是离线处理,不涉及设备写入。不要手工拼接几个 BIN,因为中间偏移与填充会丢失。记录 esptool 版本和完整参数,尤其是改变目标偏移的选项。
核对合并基址,避免二次偏移
官方例子默认生成从 0x0 对应的 raw 合并包,随后写到 0x0。若使用 --target-offset,合并包应写入的起点会不同,因此“合并包都写 0”也不成立。必须由发布清单明确 base,满足目标地址=base+文件内偏移。
raw 合并时 FF 间隙也是文件内容,写入会影响所覆盖间隙的擦除区。若发布包只更新 app,却用整合镜像跨过了 NVS 或参数区,可能丢配置。写之前还要核对擦除范围,不能只说“三个有效段没有重叠就安全”。使用分文件或 HEX 也应按工具文档确认实际擦除行为。
验收与交付边界
附件提供教学偏移表和区间检查脚本,检查没有越界和冲突,不执行烧录。真实写入前,还需按固件身份清单核对版本、来源与摘要;写入后保留设备启动日志和应用版本。本文没有连接 ESP32 完成烧录,合并样本只用于布局推演。
常见问题
只有一个 bin 就一定是合并包吗? 不一定,可能仅是应用。缺清单时向发布者确认,不靠体积猜。
把 app 写到 0x0 试试可以吗? 不应试猜,可能覆盖启动器等区域;应先确认映像角色与地址。
不同芯片用相同偏移能启动吗? 偏移相同不表示映像和硬件兼容,目标芯片、Flash 配置与板级定义都要匹配。
来源与配套记录
下载本文样例或空白记录(N064.json)。附件的 kind 明确区分合成数据与待填写记录,空值不是实测结果。
本文依据官方文档与自建合成样例整理,未连接真实设备完成现场测试;计算结果以附件脚本输出为准。核对日期:2026-10-23。
操作入口见esptool 软件说明;继续处理相关任务可看烧录成功不等于包没拿错:ESP32 固件来源与摘要怎样交付。
本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。
- esptool 基础命令:地址、读取和合并 ↗
docs.espressif.com/projects/esptool/en/latest/esp32/esptool/basic-commands.html
- ESP-IDF 分区表说明 ↗
docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/partition-tables.html