Microduck Robot●microduck-robot.com

ESP32-BIN prüfen: App, Gesamtimage und Partitionen

Bestimmen Sie vor dem Laden das Build-Artefakt. Eine reine App-Datei belegt keine Partitionierung; ein strukturell gültiges Image kann trotzdem außerhalb der Emulatorunterstützung liegen. Eine fehlgeschlagene Vorprüfung lässt die bisherige Firmware weiterlaufen.

Befehle: esptool 4.8.1 und 5.1.0. Website-Basis: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4. Quellen geprüft am 2026-11-15.

Das Artefakt statt nur die Endung auswählen

Ein Build kann Anwendung, Bootloader und Partitionstabelle als getrennte Binärdateien liefern. Die Endung .bin macht sie nicht austauschbar. Bewahren Sie Zielchip, Konfiguration und Dateiliste zusammen auf.

Ein erkanntes Gesamtimage enthält mehrere Artefakte an ihren deklarierten Positionen. Umbenennen oder bloßes Aneinanderhängen belegt diese Anordnung nicht. Die Tabelle zeigt, welche Aussage die ausgewählte Datei ermöglicht.

Seitlich scrollen, um alle Spalten zu vergleichen.

ArtefaktVerfügbare BelegeNicht damit belegt
Nur AnwendungApp-Header, Segmente und vorhandene IntegritätsfelderDie separate Partitionierung
Erkanntes GesamtimageErkennbare Boot-, Tabellen- und App-ArtefakteBeliebige Layouts oder reale Funktion
Unbekannte/gekürzte DateiNur tatsächlich lesbare DatenGültigkeit allein durch .bin-Endung

Eine lokale Datei mit passendem esptool prüfen

Das folgende Beispiel untersucht eine einzelne firmware.bin in einer Umgebung mit esptool 4.8.1. Es liest die lokale Datei ohne serielle Verbindung. Prüfen Sie die installierte Paketversion, bevor Sie Optionen übernehmen.

Lokale Prüfung · esptool 4.8.1
# esptool 4.8.1 environment
python -m pip show esptool
python -m esptool image_info --version 2 "firmware.bin"

Unter esptool 5.1.0 verwenden Sie image-info statt image_info und lassen die alte Option --version weg. Halten Sie bei Gesamtimages die Einzeldateien und das Manifest bereit; image-info prüft nicht die vollständige Partitionierung.

Lokale Prüfung · esptool 5.1.0
# esptool 5.1.0 environment
python -m pip show esptool
python -m esptool image-info "firmware.bin"

Struktur und Simulatorunterstützung trennen

Zur Struktur gehören Header, Segmentkonsistenz, Segment-XOR-Prüfsumme und eine vorhandene angehängte SHA-256-Prüfsumme. Ein fehlender Digest beweist keine Beschädigung; ein gültiger Digest belegt weder Herkunft noch richtiges Hardwareverhalten.

Die Ausführung wird getrennt bewertet. Diese Laufzeit benötigt ein unterstütztes klassisches ESP32-Profil mit bekannten DIO/4 MiB-Flashdaten und ausführbarem Layout. Ein erkanntes S3/C3-Headerfeld bedeutet keine Emulationsunterstützung. Lesen Sie beide Berichtsteile.

Seitlich scrollen, um alle Spalten zu vergleichen.

BefundBedeutungNächste Prüfung
Struktur/Prüfsumme fehlerhaftKandidat strukturell nicht akzeptiertNeu kopieren/bauen; bisherigen Lauf erhalten
Struktur gültig; S3/C3Erkennung ist keine klassische AusführungPassendes Ziel/Umgebung verwenden
Nur App; Partitionen unbekanntDatei enthält keinen PartitionsnachweisUnbekannt lassen; Manifest suchen
Gesamtimage; Layout nicht unterstütztDaten liegen außerhalb des LaufzeitprofilsKonkreten Layoutbefund prüfen

Unbekannte Partitionierung nicht als geprüft behandeln

Eine reine App-Datei enthält nicht das separate Partitionstabellen-Artefakt. Der Emulator kann gegebenenfalls sein eigenes klassisches Boot-/Partitionsprofil ergänzen. Diese Annahme stammt nicht aus der Datei und bestätigt kein benutzerdefiniertes Layout.

Nur ein erkanntes Gesamtimage erlaubt die implementierten Partitionsprüfungen. Fehler bei Grenzen, Überlappung, Format oder Tabellenintegrität müssen geklärt werden. Das Bestehen der unterstützten Teilmenge zertifiziert weder jedes ESP-IDF-Layout noch das Gerät.

Nur mit dem Manifest desselben Builds zusammenführen

Dieses Zusammenführungsbeispiel gilt nur im zugehörigen klassischen ESP32-ESP-IDF-Buildverzeichnis mit tatsächlich erzeugter flash_args. Die Datei enthält die Datei-/Offsetpaare dieses Builds. Geschrieben wird eine lokale Datei, kein Gerät. Übernehmen Sie keine Offsets einer fremden Platine.

Offline mit Buildmanifest zusammenführen · 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"

Für esptool 5.1.0 gilt die getrennte Syntax unten. Arduino-Exporte können andere Buildrezepte nutzen: Bewahren Sie deren Manifest oder Protokoll auf, statt flash_args zu erfinden. Hier wird weder geflasht noch gelöscht oder ein Header automatisch passend umgeschrieben.

Offline mit Buildmanifest zusammenführen · 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"

Den ersten Fehler gezielt untersuchen

Bewahren Sie Dateiname, Ziel, Toolversionen und beide Berichtsteile auf. Die Website prüft den Kandidaten vor dem Wechsel. Ein Fehler verlangt nicht, dass die bisher laufende Firmware angehalten wird.

  1. Header, Segment oder Prüfsumme fehlerhaft: intakte Datei beschaffen oder dasselbe Ziel neu bauen; vorhandenen Herausgeber-Hash vergleichen.
  2. Struktur gültig, Chip/Flash nicht unterstützt: passenden klassischen Build oder externe Umgebung nutzen; Headerbytes nicht umetikettieren.
  3. Partitionen bei reiner App unbekannt: Unsicherheit beibehalten und nötigenfalls die passenden Build-Artefakte suchen.
  4. Layout/Laufzeit weiter abgewiesen: zuerst den konkreten Befund prüfen. Erst nach den nötigen Prüfungen laden; der Browser flasht keine Hardware.

Fragen zu BIN-Dateien

Beweist eine gültige reine App-BIN die Partitionierung?

Nein. Die Partitionstabelle ist ein separates Build-Artefakt. Ein ergänztes Simulator-Standardprofil ist eine Ausführungsannahme, kein Beleg des ursprünglichen benutzerdefinierten Layouts.

Warum wird ein strukturell gültiges Image trotzdem abgewiesen?

Struktur und Emulatorunterstützung sind getrennte Prüfungen. Chip, Flashdaten oder Layout können außerhalb des aktuellen klassischen ESP32-Profils liegen.

Warum funktionieren image_info oder --version in esptool 5.1.0 nicht?

In 5.1.0 gilt image-info. Das neue Ausgabeformat ist Standard; --version wurde entfernt. Das 4.8.1-Beispiel nutzt image_info --version 2. Vermischen Sie die Befehlsformen nicht.

Ersetzt eine fehlgeschlagene Vorprüfung die laufende Firmware?

Nein. Der bisherige Lauf bleibt erhalten. Die Seite lädt erst nach den erforderlichen Prüfungen und schreibt keine reale Platine.

Projektquellen

Kontakt