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érifiables | Ce qu’il ne prouve pas |
|---|---|---|
| Application seule | En-tête, segments et intégrité disponible | Disposition séparée des partitions |
| Image fusionnée reconnue | Démarrage, table et application reconnaissables | Compatibilité universelle ou validité physique |
| Fichier inconnu ou tronqué | Uniquement les octets analysables | Validité 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.
# 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.
# 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ésultat | Sens | Contrôle suivant |
|---|---|---|
| Structure/somme incorrecte | Candidat non accepté structurellement | Recopier/recompiler; conserver l’exécution |
| Structure valide; S3/C3 | Inspection sans exécution classique | Choisir la cible/l’environnement adapté |
| Application seule; partitions inconnues | Aucune preuve du partitionnement | Garder inconnu; retrouver le manifeste |
| Fusionnée; disposition non prise en charge | Hors du sous-ensemble du runtime | Lire 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.
# 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é.
# 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.
- En-tête, segment ou somme invalide : obtenir un fichier intact ou reconstruire la même cible; comparer le hash fourni par l’éditeur.
- Structure valide mais puce/flash non pris en charge : utiliser le bon build classique ou environnement externe, sans maquiller l’en-tête.
- Partitions inconnues pour une application seule : conserver cette incertitude et chercher les artefacts du même build.
- 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.