拡張子ではなく成果物を選ぶ
コンパイルではアプリ、ブートローダー、パーティションテーブルが別ファイルになる場合があります。拡張子が.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を確認します。ハッシュがないだけで破損とは言えず、正しいハッシュも作者や実機動作の証明にはなりません。
実行対応は別の判定です。このランタイムには既知のDIO/4MiBフラッシュ情報と実行可能な配置を持つ、対応した従来型ESP32プロファイルが必要です。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"
最初に失敗した検査から確認する
ファイル名、ビルド対象、ツールの版と両方の検査結果を保存します。候補は実行を置き換える前に検査されます。失敗しても、動作中のファームウェアを止める必要はありません。
- ヘッダー・セグメント・チェックサム失敗:正常な成果物を入手するか同じ対象を再ビルドし、提供元のハッシュがあれば照合します。
- 構造は正常でもチップ・フラッシュが非対応:正しい従来型ビルドか外部環境を使い、ヘッダーを書き換えて装わないでください。
- アプリ単体でパーティション不明:不明の判定を保ち、必要なら同じビルドの成果物を探します。
- 配置・実行条件が非対応:指摘された項目を先に確認します。必要な検査の後に読み込み、ブラウザーから実機へ書き込みません。
BINファイルの疑問
正常なアプリ単体BINならパーティションも証明できますか?
できません。テーブルは別のビルド成果物です。シミュレーターの標準設定は実行上の仮定で、元の独自配置の証拠ではありません。
構造が正常でも拒否されるのはなぜですか?
構造と実行対応は別の検査です。チップ、フラッシュ情報、配置が現在の従来型ESP32プロファイルに対応しない場合があります。
esptool 5.1.0でimage_infoや--versionが使えないのはなぜですか?
5.1.0ではimage-infoを使います。新形式が標準となり--versionは削除されました。4.8.1の例はimage_info --version 2です。構文を混ぜないでください。
事前検査の失敗で実行中のファームウェアは置き換わりますか?
いいえ。現在の実行は維持されます。必要な検査を終えてから読み込み、実物のボードには書き込みません。