Home

固件包格式

Web ESPTool 支持多种形式的固件格式。

UF2

ESP-IDF 自 v4.3 开始支持 UF2 的构建。命令如下：

idf.py uf2

执行生成的文件位于 build/uf2.bin，可直接拖进 Web ESPTool 烧录。

此外，也支持 Zephyr RTOS 等其它环境构建的 *.uf2 文件。

Merged Binary

ESP-IDF 自 v5.3 开始支持将产物合并为单个 .bin 文件。命令如下：

idf.py merge-bin

执行生成的文件位于 build/merged-binary.bin。

当向 Web ESPTool 拖入扩展名为 .bin 的文件（除了 uf2.bin）时，它将被视作 Merged Binary，即一个偏移值为 0x0 的单个分区。

此外，若向 Web ESPTool 拖入 ZIP 压缩包，且压缩包中存在名称包含 merged-binary 的 BIN 文件时，这个文件也会被视作 Merged Binary 被解压并烧录到偏移值 0x0 上。

Build ZIP

Build ZIP 是手动从 build 目录打包的 ZIP 压缩包。它的典型结构如下：

Archive:  hello_world.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
      141  08-24-2021 11:12   flash_args
    18944  08-24-2021 12:25   bootloader/bootloader.bin
   749536  08-24-2021 12:25   hello_world.bin
     3072  08-24-2021 11:16   partition_table/partition-table.bin
---------                     -------
   771693                     4 files

它由 flash_args 以及其它相关分区的镜像文件构成（镜像相对路径与 flash_args 中定义的路径对应）。

flash_args 文件以及这些分区镜像可以在你的项目 build 目录下找到。一个典型的 flash_args 文件如下（请注意，该文件的内容会因具体芯片型号、配置不同而有所不同）：

--flash_mode dio --flash_freq 80m --flash_size 2MB
0x0 bootloader/bootloader.bin
0x10000 hello_world.bin
0x8000 partition_table/partition-table.bin

固件包可以在项目目录中使用下列命令一键生成（生成的固件包位于 build/flash.zip）：

pushd build && zip flash.zip flash_args $(cat flash_args | while read _ f; do; [[ -f $f ]] && echo $f; done) && popd