Microduck Robot●microduck-robot.com

BIN ESP32 : application, image fusionnée et contrôles

Identifiez l’artefact avant de le charger. Une application seule ne prouve pas la disposition des partitions; une image valide peut rester incompatible avec l’émulateur classique. Un échec de précontrôle laisse le firmware actuel fonctionner.

Commandes : esptool 4.8.1 et 5.1.0. Base du site : Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4. Sources vérifiées le 2026-11-15.

Choisir l’artefact, pas seulement l’extension

Une compilation peut produire séparément application, bootloader et table de partitions. Leur extension .bin ne les rend pas interchangeables. Conservez cible, configuration et liste de fichiers ensemble.

Une image fusionnée reconnue contient plusieurs artefacts à leurs positions déclarées. Renommer ou concaténer des fichiers ne prouve pas cette disposition. Le tableau distingue les informations réellement disponibles.

Faites défiler horizontalement pour comparer toutes les colonnes.

ArtefactÉléments vérifiablesCe qu’il ne prouve pas
Application seuleEn-tête, segments et intégrité disponibleDisposition séparée des partitions
Image fusionnée reconnueDémarrage, table et application reconnaissablesCompatibilité universelle ou validité physique
Fichier inconnu ou tronquéUniquement les octets analysablesValidité par son nom .bin

Inspecter un fichier local avec le bon esptool

Cet exemple inspecte une firmware.bin individuelle dans un environnement esptool 4.8.1 fixé. Il lit le fichier local sans connexion série. Vérifiez la version installée avant de reprendre ses options.

Inspection locale · esptool 4.8.1
# esptool 4.8.1 environment
python -m pip show esptool
python -m esptool image_info --version 2 "firmware.bin"

Avec esptool 5.1.0, utilisez image-info au lieu de image_info et retirez --version. Pour une image fusionnée, gardez composants et manifeste : image-info n’est pas un validateur complet des partitions.

Inspection locale · esptool 5.1.0
# esptool 5.1.0 environment
python -m pip show esptool
python -m esptool image-info "firmware.bin"

Séparer structure et prise en charge

La structure comprend les en-têtes, la cohérence des segments, leur somme XOR et le SHA-256 ajouté s’il existe. Un condensat absent ne prouve pas une corruption; un condensat valide ne prouve ni l’auteur ni le fonctionnement matériel.

L’exécution est une décision séparée. Ce runtime demande un profil ESP32 classique pris en charge, des métadonnées DIO/4 MiB connues et une disposition exécutable. Reconnaître un en-tête S3/C3 ne signifie pas émuler ces puces. Lisez les deux parties du rapport.

Faites défiler horizontalement pour comparer toutes les colonnes.

RésultatSensContrôle suivant
Structure/somme incorrecteCandidat non accepté structurellementRecopier/recompiler; conserver l’exécution
Structure valide; S3/C3Inspection sans exécution classiqueChoisir la cible/l’environnement adapté
Application seule; partitions inconnuesAucune preuve du partitionnementGarder inconnu; retrouver le manifeste
Fusionnée; disposition non prise en chargeHors du sous-ensemble du runtimeLire le constat de disposition

Garder inconnue une disposition non prouvée

Une application seule ne contient pas l’artefact séparé de table des partitions. L’émulateur peut fournir son propre profil classique de démarrage/partitionnement si applicable. C’est une hypothèse, non une disposition personnalisée retrouvée dans le fichier.

Seule une image fusionnée reconnue permet les contrôles de partitions implémentés. Limites, chevauchements, format ou intégrité doivent être examinés en cas d’erreur. Réussir le sous-ensemble admis ne certifie pas tout ESP-IDF ni l’appareil assemblé.

Fusionner à partir du manifeste du même build

Cet exemple de fusion concerne uniquement le répertoire du build ESP-IDF classique correspondant, qui a réellement généré flash_args. Ce fichier fournit les couples fichier/décalage du build. La sortie est locale, aucun appareil n’est écrit. Ne reprenez pas les décalages d’une autre carte.

Fusion locale depuis le manifeste · 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"

Utilisez l’autre syntaxe pour esptool 5.1.0. Les exports Arduino peuvent suivre une autre recette : gardez leur manifeste ou journal plutôt que d’inventer flash_args. Aucun exemple ne programme, n’efface ou ne réécrit automatiquement un en-tête pour simuler une compatibilité.

Fusion locale depuis le manifeste · 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"

Suivre le premier contrôle en échec

Gardez nom du fichier, cible, versions et les deux parties du rapport. Le candidat est contrôlé avant remplacement; un échec ne demande pas d’arrêter le firmware déjà en cours.

  1. En-tête, segment ou somme invalide : obtenir un fichier intact ou reconstruire la même cible; comparer le hash fourni par l’éditeur.
  2. Structure valide mais puce/flash non pris en charge : utiliser le bon build classique ou environnement externe, sans maquiller l’en-tête.
  3. Partitions inconnues pour une application seule : conserver cette incertitude et chercher les artefacts du même build.
  4. Disposition/runtime toujours refusé : lire le constat précis. Charger après les contrôles requis; le navigateur ne programme aucun matériel.

Questions sur les BIN

Une application BIN valide prouve-t-elle les partitions ?

Non. La table est un artefact séparé. Le profil par défaut du simulateur est une hypothèse d’exécution, pas une preuve de la disposition personnalisée d’origine.

Pourquoi refuser une image dont la structure est valide ?

Structure et compatibilité de l’émulateur sont distinctes. Puce, métadonnées flash ou disposition peuvent dépasser le profil ESP32 classique actuel.

Pourquoi image_info ou --version ne fonctionne-t-il plus avec esptool 5.1.0 ?

Dans 5.1.0, utilisez image-info. Le nouveau format est celui par défaut et --version a été supprimé. L’exemple 4.8.1 utilise image_info --version 2 : ne mélangez pas les formes.

Un précontrôle en échec remplace-t-il le firmware actif ?

Non. L’exécution actuelle est conservée. La page charge après les contrôles nécessaires et ne programme aucune carte réelle.

Sources du projet

Contact