확장자가 아니라 산출물 선택
컴파일은 앱,부트로더,파티션 테이블을 별도 바이너리로 만들 수 있습니다. 모두.bin이라고 서로 바꿔 쓸 수는 없습니다. 대상 칩,설정,파일 목록을 함께 보관하세요.
인식되는 병합 이미지는 여러 산출물을 선언된 위치에 포함합니다. 이름을 바꾸거나 단순 연결해도 그 배치가 입증되지 않습니다. 표에서 선택한 파일이 제공하는 증거를 확인하세요.
옆으로 스크롤하여 모든 열을 비교하세요.
| 산출물 | 확인 가능한 증거 | 입증하지 못하는 것 |
|---|---|---|
| 앱 단독 | 앱 헤더·세그먼트·가용 무결성 정보 | 별도의 파티션 구성 |
| 인식된 병합 이미지 | 부트·테이블·앱 산출물 | 모든 배치 지원이나 실물 유효성 |
| 불명·잘린 파일 | 실제로 분석할 수 있는 바이트 | .bin 이름만으로 정상 여부 |
맞는 esptool로 로컬 파일 검사
다음 예제는 esptool 4.8.1 환경에서 개별 firmware.bin을 검사합니다. 로컬 파일을 읽으며 시리얼 연결은 열지 않습니다. 옵션을 복사하기 전에 설치 버전을 확인하세요.
# 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을 확인합니다. 해시가 없다고 곧바로 손상은 아니며 유효한 해시도 작성자나 실물 동작을 증명하지 않습니다.
실행 지원은 별도 판단입니다. 이 런타임에는 알려진 DIO/4MiB 플래시 정보와 실행 가능한 배치를 갖춘 지원 클래식 ESP32 프로필이 필요합니다. S3/C3 헤더 인식이 해당 칩의 에뮬레이션을 뜻하지는 않습니다. 두 결과를 모두 읽으세요.
옆으로 스크롤하여 모든 열을 비교하세요.
| 결과 | 의미 | 다음 점검 |
|---|---|---|
| 구조·체크섬 오류 | 구조상 허용되지 않은 후보 | 재복사·재빌드하고 현재 실행 유지 |
| 구조 정상·S3/C3 | 검사와 클래식 실행은 별개 | 맞는 대상·환경 사용 |
| 앱 단독·파티션 불명 | 배치 증거가 파일에 없음 | 불명 유지·매니페스트 확인 |
| 병합·배치 미지원 | 런타임 지원 범위 밖 | 구체적인 배치 항목 확인 |
모르는 파티션은 모르는 상태로 유지
앱 단독 파일에는 별도 산출물인 파티션 테이블이 없습니다. 해당되는 경우 에뮬레이터가 자체 기본 클래식 부트·파티션 프로필을 제공합니다. 이는 사용자 파일에서 복원한 정보가 아니며 사용자 정의 배치도 검증하지 않습니다.
구현된 파티션 검사는 인식된 병합 이미지에만 적용됩니다. 경계,겹침,형식,무결성 오류는 확인해야 합니다. 지원 부분을 통과했다고 모든 ESP-IDF 배치나 실제 조립이 인증되는 것은 아닙니다.
같은 빌드의 매니페스트로만 병합
병합 예제는 실제 flash_args를 만든 해당 클래식 ESP32 ESP-IDF 빌드 디렉터리에서만 사용합니다. 같은 빌드의 파일·오프셋 쌍으로 로컬 출력을 만들며 장치에는 쓰지 않습니다. 다른 보드의 오프셋을 복사하지 마세요.
# 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"
처음 실패한 검사부터 확인
파일 이름,빌드 대상,도구 버전과 두 보고서 영역을 보관하세요. 후보는 실행을 바꾸기 전에 검사합니다. 실패했다고 이미 실행 중인 펌웨어를 중지할 필요는 없습니다.
- 헤더·세그먼트·체크섬 실패: 정상 산출물을 받거나 같은 대상으로 재빌드하고 제공자의 해시가 있으면 비교합니다.
- 구조는 유효하지만 칩·플래시 미지원: 맞는 클래식 빌드나 외부 환경을 사용하고 헤더를 바꿔 표시하지 마세요.
- 앱 단독 파티션 불명: 불명 상태를 유지하고 필요하면 같은 빌드 산출물을 찾습니다.
- 배치·런타임 미지원: 표시된 항목부터 확인합니다. 필요한 검사를 마친 뒤 로드하며 브라우저는 하드웨어에 펌웨어를 쓰지 않습니다.
BIN 파일 질문
유효한 앱 단독 BIN이면 파티션도 입증되나요?
아니요. 테이블은 별도 빌드 산출물입니다. 시뮬레이터의 기본 프로필은 실행 가정이며 원래 사용자 정의 배치의 증거가 아닙니다.
구조가 정상인데도 거부되는 이유는 무엇인가요?
구조와 에뮬레이터 지원은 다른 검사입니다. 칩,플래시 정보,배치가 현재 클래식 ESP32 프로필 밖일 수 있습니다.
esptool 5.1.0에서 image_info나 --version이 안 되는 이유는 무엇인가요?
5.1.0에서는 image-info를 사용합니다. 새 출력이 기본이며 --version은 제거됐습니다.4.8.1 예제는 image_info --version 2를 씁니다. 문법을 섞지 마세요.
사전 검사 실패가 실행 중인 펌웨어를 바꾸나요?
아니요. 현재 실행이 유지됩니다. 필요한 검사 후에 로드하며 실제 보드에 쓰지 않습니다.