Выберите артефакт, а не расширение
Сборка может создавать отдельные файлы приложения, загрузчика и таблицы разделов. Расширение .bin не делает их взаимозаменяемыми. Сохраняйте целевой чип, настройки и список файлов вместе.
Распознанный объединённый образ содержит артефакты на объявленных позициях. Переименование или простое склеивание не доказывает такую разметку. Таблица показывает, какие сведения даёт файл.
Прокрутите таблицу вбок, чтобы сравнить все столбцы.
| Артефакт | Доступные сведения | Что он не доказывает |
|---|---|---|
| Только приложение | Заголовок, сегменты и доступная целостность | Отдельную разметку разделов |
| Распознанный объединённый образ | Загрузчик, таблица и приложение | Любую разметку или физическую исправность |
| Неизвестный/обрезанный файл | Только разбираемые байты | Годность по имени .bin |
Проверьте локальный файл подходящим esptool
Пример проверяет отдельный firmware.bin в окружении 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 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; 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"
Разберите первую неудачную проверку
Сохраняйте имя файла, цель, версии и оба раздела отчёта. Кандидат проверяется до замены запуска; ошибка не требует останавливать уже работающую прошивку.
- Ошибка заголовка, сегмента или суммы: получите целый артефакт либо пересоберите ту же цель; сравните опубликованный хеш при наличии.
- Структура верна, чип/flash не поддержан: выберите нужную классическую сборку или внешнее окружение, не меняйте маркировку заголовка.
- Разделы приложения неизвестны: сохраните неопределённость и найдите артефакты той же сборки.
- Разметка/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; не смешивайте формы команд.
Заменит ли неудачная проверка работающую прошивку?
Нет. Текущий запуск сохраняется. Страница загружает после обязательных проверок и не записывает реальную плату.