選擇產物,不只看副檔名
編譯可能分別產生應用程式映像、bootloader與分割區表二進位檔。不能因為都以.bin結尾就互相替代。請一起保留目標晶片、設定與檔案清單。
可辨識的合併映像包含位於聲明位置的多項建置產物。改名或直接串接不能證明配置正確。下表說明各類檔案能提供哪些證據。
橫向捲動以比較所有欄位。
| 產物 | 可檢查的證據 | 不能證明什麼 |
|---|---|---|
| 應用程式映像 | 應用程式標頭、區段及已有完整性資訊 | 另一檔案中的分割區配置 |
| 可辨識合併映像 | 可辨識的啟動、分割區表及應用產物 | 通用配置支援或實物正確性 |
| 未知或截斷檔案 | 實際可解析的位元組 | 僅靠.bin檔名判定有效 |
用對應esptool檢查本機檔案
以下範例在固定esptool 4.8.1環境中檢查單獨的firmware.bin。命令只讀取本機檔案,不開啟序列埠。複製參數前先確認安裝的套件版本。
# 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 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; 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; matching classic ESP32 ESP-IDF build directory
python -m esptool --chip esp32 merge-bin -o "merged-flash.bin" "@flash_args"
沿著第一個失敗項目排查
保留檔名、建置目標、工具版本與兩部分報告。網站在替換執行之前檢查候選檔;預檢失敗不要求停止已執行的韌體。
- 標頭、區段或檢查碼失敗:重新取得完整產物或以同一目標重編譯;發布者提供hash時應比對。
- 結構通過但晶片/快閃資訊不支援:選擇匹配的經典建置或外部環境,不要修改標頭位元組冒充。
- 應用程式映像的分割區未知:保留不確定性,需要配置證據時尋找對應建置產物。
- 配置/執行條件仍不支援:先閱讀具體檢查項。必要檢查通過後再載入;瀏覽器不會燒錄實物。
BIN檔常見問題
應用程式映像有效,就能證明分割區配置嗎?
不能。它只包含應用程式部分,分割區表是另一項建置產物,不能據此認定可獨立開機。模擬器補入的預設設定只是執行假設,不是原始自訂配置的證據。
為什麼結構通過仍被拒絕?
結構與模擬器支援是不同檢查。晶片、快閃資訊或配置可能不符合目前經典ESP32設定。
為什麼esptool 5.1.0不接受image_info或--version?
5.1.0使用image-info,新輸出為預設格式,--version已移除。4.8.1範例使用image_info --version 2,兩套語法不要混用。
預檢失敗會替換目前執行的韌體嗎?
不會。目前執行會保留。頁面在必要檢查完成後才載入,也不會寫入真實開發板。