From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:ESP32 application image" |
|---|
| claim | "8-byte common header (magic, segments, flash_mode, flash_size_freq, u32 entry) then a 16-byte extended header: wp_pin, 3 drive bytes, u16 chip_id, u8 min_rev, u16 min_rev_full, u16 max_rev_full, 4 padding bytes, append_digest." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "ESP32 family images" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "esp_image_header" |
|---|
| size | "0x18" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "magic" |
|---|
|
| offset | "0x1" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "segment_count" |
|---|
|
| offset | "0x2" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "spi_mode" |
|---|
|
| offset | "0x3" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "spi_speed_size" |
|---|
|
| offset | "0x4" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "entry_addr" |
|---|
|
| offset | "0x8" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "wp_pin" |
|---|
|
| offset | "0x9" |
|---|
| size | 3 |
|---|
| type | "uint8_t[3]" |
|---|
| name | "spi_pin_drv" |
|---|
|
| offset | "0xC" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "chip_id" |
|---|
|
| offset | "0xE" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "min_chip_rev" |
|---|
|
| offset | "0xF" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "min_chip_rev_full" |
|---|
|
| offset | "0x11" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "max_chip_rev_full" |
|---|
|
| offset | "0x13" |
|---|
| size | 4 |
|---|
| type | "uint8_t[4]" |
|---|
| name | "padding" |
|---|
|
| offset | "0x17" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "hash_appended" |
|---|
|
|
|---|
| endianness | "little" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "load_common_header struct '<BBBBI'; EXTENDED_HEADER_STRUCT_FMT '<BBBBHBHH'+B*4+B; load_extended_header" |
|---|
| repo | "https://github.com/espressif/esptool" |
|---|
| commit | "af1ed10290e6328416cf8c73076bba15b459cbb2" |
|---|
| path | "esptool/bin_image.py" |
|---|
| lines | "245-256,723,1004-1027" |
|---|
|
| type | "source" |
|---|
| detail | "struct.unpack("<BBBBI") image header; EXTENDED_HEADER_STRUCT_FMT = "<BBBBHBHH..."" |
|---|
| repo | "https://github.com/espressif/esptool" |
|---|
| commit | "af1ed10290e6328416cf8c73076bba15b459cbb2" |
|---|
| path | "esptool/bin_image.py" |
|---|
| lines | "252, 723" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Image header and extended header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T18:23:45.863Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T11:03:43.328Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read esptool/bin_image.py at af1ed102: load_common_header unpacks '<BBBBI' (8 bytes); EXTENDED_HEADER_STRUCT_FMT '<BBBBHBHH' + 'B'*4 + 'B' = 16 bytes read by load_extended_header into wp_pin, 3 drive bytes, chip_id, min_rev, min_rev_full, max_rev_full, 4 padding, append_digest (0 or 1); offsets 0x8..0x17 match." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:39:39.433Z" |
|---|
| summary | "Set byte order little: esptool packs and unpacks the image and extended headers with '<' formats." |
|---|
| changed | |
|---|
|
|
|---|