Microduck Robot●microduck-robot.com

ESP32 BIN: приложение, объединённый образ и проверка

До загрузки определите артефакт сборки. Файл приложения не доказывает разметку разделов; корректный образ может не поддерживаться классическим эмулятором. При неудачной предпроверке текущая прошивка продолжает работать.

Команды: esptool 4.8.1 и 5.1.0. Основа сайта: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4. Источники проверены 2026-11-15.

Выберите артефакт, а не расширение

Сборка может создавать отдельные файлы приложения, загрузчика и таблицы разделов. Расширение .bin не делает их взаимозаменяемыми. Сохраняйте целевой чип, настройки и список файлов вместе.

Распознанный объединённый образ содержит артефакты на объявленных позициях. Переименование или простое склеивание не доказывает такую разметку. Таблица показывает, какие сведения даёт файл.

Прокрутите таблицу вбок, чтобы сравнить все столбцы.

АртефактДоступные сведенияЧто он не доказывает
Только приложениеЗаголовок, сегменты и доступная целостностьОтдельную разметку разделов
Распознанный объединённый образЗагрузчик, таблица и приложениеЛюбую разметку или физическую исправность
Неизвестный/обрезанный файлТолько разбираемые байтыГодность по имени .bin

Проверьте локальный файл подходящим esptool

Пример проверяет отдельный firmware.bin в окружении esptool 4.8.1. Он читает локальный файл без подключения к последовательному порту. Перед копированием параметров проверьте установленную версию.

Локальная проверка · esptool 4.8.1
# 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
# esptool 5.1.0 environment
python -m pip show esptool
python -m esptool image-info "firmware.bin"

Разделяйте структуру и поддержку эмулятора

Структурная проверка охватывает заголовки, согласованность сегментов, XOR-сумму и добавленный SHA-256 при наличии. Отсутствие хеша не означает повреждение; верный хеш не доказывает авторство или работу оборудования.

Исполнение оценивается отдельно. Нужен поддерживаемый классический профиль ESP32 с известными DIO/4 MiB-параметрами flash и исполнимой разметкой. Распознавание заголовка S3/C3 не означает эмуляцию этих чипов. Читайте оба раздела отчёта.

Прокрутите таблицу вбок, чтобы сравнить все столбцы.

РезультатЗначениеСледующая проверка
Неверная структура/суммаКандидат структурно не принятСкопировать/собрать заново; сохранить запуск
Структура верна; S3/C3Распознавание не равно исполнениюВыбрать нужную цель/среду
Только приложение; разделы неизвестныВ файле нет доказательства разметкиОставить неизвестным; найти манифест
Объединённый; разметка не поддержанаЗа пределами профиля runtimeИзучить конкретное ограничение

Не выдавайте неизвестную разметку за проверенную

Файл приложения не содержит отдельного артефакта таблицы разделов. В допустимом случае эмулятор добавляет собственный классический профиль загрузки/разметки. Это предположение, а не восстановление пользовательской разметки из файла.

Проверки разделов применимы лишь к распознанному объединённому образу. Ошибки границ, перекрытий, формата или целостности требуют разбора. Поддержанный набор проверок не сертифицирует любую разметку ESP-IDF или собранное устройство.

Объединяйте по манифесту той же сборки

Пример объединения предназначен только для соответствующего каталога классической ESP32-сборки ESP-IDF, где действительно создан flash_args. Он содержит пары файл/смещение этой сборки. Создаётся локальный файл, а не запись в плату. Не копируйте смещения другой платы.

Локальное объединение по манифесту · 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"

Для esptool 5.1.0 используйте отдельную форму команды. Экспорт Arduino может иметь другой рецепт: сохраняйте его манифест/журнал, не создавая вымышленный flash_args. Команды не прошивают, не стирают и не подменяют заголовок ради видимости совместимости.

Локальное объединение по манифесту · 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"

Разберите первую неудачную проверку

Сохраняйте имя файла, цель, версии и оба раздела отчёта. Кандидат проверяется до замены запуска; ошибка не требует останавливать уже работающую прошивку.

  1. Ошибка заголовка, сегмента или суммы: получите целый артефакт либо пересоберите ту же цель; сравните опубликованный хеш при наличии.
  2. Структура верна, чип/flash не поддержан: выберите нужную классическую сборку или внешнее окружение, не меняйте маркировку заголовка.
  3. Разделы приложения неизвестны: сохраните неопределённость и найдите артефакты той же сборки.
  4. Разметка/runtime всё ещё отклонены: разберите конкретный пункт. Загружайте после обязательных проверок; браузер не прошивает оборудование.

Вопросы о BIN

Доказывает ли корректный BIN приложения разметку?

Нет. Таблица разделов — отдельный артефакт. Стандартный профиль эмулятора является предположением исполнения, а не подтверждением исходной пользовательской разметки.

Почему структурно правильный файл отклонён?

Структура и поддержка эмулятора проверяются отдельно. Чип, параметры flash или разметка могут не входить в классический профиль ESP32.

Почему image_info или --version не работает в esptool 5.1.0?

В 5.1.0 используйте image-info. Новый формат стал стандартным, а --version удалён. Пример 4.8.1 использует image_info --version 2; не смешивайте формы команд.

Заменит ли неудачная проверка работающую прошивку?

Нет. Текущий запуск сохраняется. Страница загружает после обязательных проверок и не записывает реальную плату.

Источники проекта

Связаться с нами