Microduck Robot●microduck-robot.com

ESP32 BIN:應用程式映像(app-only)、合併映像與預檢

載入前先確認編譯產物。應用程式映像(app-only)僅包含應用程式部分,不能據此認定可獨立開機,也無法證明分割區配置。結構有效的映像仍可能不受經典ESP32模擬器支援。候選檔預檢失敗時,目前韌體繼續執行。

命令版本:esptool 4.8.1/5.1.0。本站基準:Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4。資料核對日:2026-11-15。

選擇產物,不只看副檔名

編譯可能分別產生應用程式映像、bootloader與分割區表二進位檔。不能因為都以.bin結尾就互相替代。請一起保留目標晶片、設定與檔案清單。

可辨識的合併映像包含位於聲明位置的多項建置產物。改名或直接串接不能證明配置正確。下表說明各類檔案能提供哪些證據。

橫向捲動以比較所有欄位。

產物可檢查的證據不能證明什麼
應用程式映像應用程式標頭、區段及已有完整性資訊另一檔案中的分割區配置
可辨識合併映像可辨識的啟動、分割區表及應用產物通用配置支援或實物正確性
未知或截斷檔案實際可解析的位元組僅靠.bin檔名判定有效

用對應esptool檢查本機檔案

以下範例在固定esptool 4.8.1環境中檢查單獨的firmware.bin。命令只讀取本機檔案,不開啟序列埠。複製參數前先確認安裝的套件版本。

本機檢查 · esptool 4.8.1
# esptool 4.8.1 environment
python -m pip show esptool
python -m esptool image_info --version 2 "firmware.bin"

esptool 5.1.0改用image-info,不是image_info,也不帶舊的--version。檢查合併映像時仍須保留原始元件與清單;image-info不是完整的分割區驗證器。

本機檢查 · esptool 5.1.0
# esptool 5.1.0 environment
python -m pip show esptool
python -m esptool image-info "firmware.bin"

分別閱讀結構與模擬器支援

結構檢查包括標頭、區段一致性、區段XOR檢查碼,以及存在時附加的SHA-256。沒有摘要不自動代表損壞;摘要有效也不能證明作者身分或實物執行正確。

能否執行是另一項判斷。這個執行環境需要受支援的經典ESP32設定、已知DIO/4MiB快閃記憶體資訊及可執行配置。辨識S3/C3標頭不代表能模擬這些晶片。請分別閱讀兩部分報告。

橫向捲動以比較所有欄位。

觀察結果意義下一步
結構/檢查碼錯誤候選檔未被結構檢查接受重新複製/編譯,保留目前執行
結構有效;S3/C3辨識不等於經典晶片執行支援選擇正確目標/環境
應用程式映像;分割區未知檔案沒有提供配置證據保留未知,查找建置清單
合併映像;配置不支援超出目前執行環境的支援子集查看具體配置檢查項

分割區未知就保留未知

這類應用程式映像不包含另行產生的分割區表檔案。符合條件時,模擬器可補入自己的經典啟動/分割區預設設定;這不是從使用者檔案還原的資訊,也未驗證自訂配置。

只有可辨識的合併映像才能進行已實作的分割區檢查。邊界、重疊、格式或表格完整性失敗都須釐清。支援子集通過,不等於認證所有ESP-IDF配置或已組裝硬體。

只依同一次建置的清單合併

合併範例只適用於真正產生flash_args的同一次經典ESP32 ESP-IDF建置目錄。該檔提供這次建置的檔案/位移配對。命令產生本機檔案,不寫入裝置;不要照抄其他板卡的位移。

依建置清單離線合併 · esptool 4.8.1
# esptool 4.8.1; matching classic ESP32 ESP-IDF build directory
python -m esptool --chip esp32 merge_bin -o "merged-flash.bin" "@flash_args"

esptool 5.1.0使用下方獨立語法。Arduino匯出可能採用其他建置規則,應保留實際清單或紀錄,不要自行編造flash_args。這裡不執行燒錄、抹除,也不自動改標頭來假裝相容。

依建置清單離線合併 · esptool 5.1.0
# esptool 5.1.0; matching classic ESP32 ESP-IDF build directory
python -m esptool --chip esp32 merge-bin -o "merged-flash.bin" "@flash_args"

沿著第一個失敗項目排查

保留檔名、建置目標、工具版本與兩部分報告。網站在替換執行之前檢查候選檔;預檢失敗不要求停止已執行的韌體。

  1. 標頭、區段或檢查碼失敗:重新取得完整產物或以同一目標重編譯;發布者提供hash時應比對。
  2. 結構通過但晶片/快閃資訊不支援:選擇匹配的經典建置或外部環境,不要修改標頭位元組冒充。
  3. 應用程式映像的分割區未知:保留不確定性,需要配置證據時尋找對應建置產物。
  4. 配置/執行條件仍不支援:先閱讀具體檢查項。必要檢查通過後再載入;瀏覽器不會燒錄實物。

BIN檔常見問題

應用程式映像有效,就能證明分割區配置嗎?

不能。它只包含應用程式部分,分割區表是另一項建置產物,不能據此認定可獨立開機。模擬器補入的預設設定只是執行假設,不是原始自訂配置的證據。

為什麼結構通過仍被拒絕?

結構與模擬器支援是不同檢查。晶片、快閃資訊或配置可能不符合目前經典ESP32設定。

為什麼esptool 5.1.0不接受image_info或--version?

5.1.0使用image-info,新輸出為預設格式,--version已移除。4.8.1範例使用image_info --version 2,兩套語法不要混用。

預檢失敗會替換目前執行的韌體嗎?

不會。目前執行會保留。頁面在必要檢查完成後才載入,也不會寫入真實開發板。

專案資料來源

聯絡我們