From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:UF2" |
|---|
| claim | "A UF2 block is 512 bytes, little endian: 32-byte header, 476 bytes of data, 4-byte end magic." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "all UF2 files" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "UF2_Block" |
|---|
| size | "0x200" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "magicStart0" |
|---|
| notes | "0x0A324655" |
|---|
|
| offset | "0x4" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "magicStart1" |
|---|
| notes | "0x9E5D5157" |
|---|
|
| offset | "0x8" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "flags" |
|---|
|
| offset | "0xC" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "targetAddr" |
|---|
|
| offset | "0x10" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "payloadSize" |
|---|
| notes | "usually 256" |
|---|
|
| offset | "0x14" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "blockNo" |
|---|
|
| offset | "0x18" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "numBlocks" |
|---|
|
| offset | "0x1C" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "familyID_or_fileSize" |
|---|
|
| offset | "0x20" |
|---|
| size | 476 |
|---|
| type | "uint8_t[476]" |
|---|
| name | "data" |
|---|
|
| offset | "0x1FC" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "magicEnd" |
|---|
| notes | "0x0AB16F30" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "UF2_Block typedef and magic defines (the field at 0x1C is named reserved in uf2.h; README says familyID or fileSize)" |
|---|
| repo | "https://github.com/microsoft/uf2" |
|---|
| commit | "90e9741f217f5a40c98ba74d663e408041037578" |
|---|
| path | "uf2.h" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "UF2 block layout" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T18:23:45.372Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T07:38:51.532Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read uf2.h at the commit: UF2_Block is magicStart0, magicStart1, flags, targetAddr, payloadSize, blockNo, numBlocks, reserved (u32 each, 32 bytes), data[476], magicEnd = 512; magic constants as listed; header says all entries little endian. The u32 at 0x1C is named 'reserved' there; the flags UF2_FLAG_FAMILY_ID 0x2000 and UF2_FLAG_FILECONTAINER 0x1000 decide whether it is a family id or file size (README, not re-read)." |
|---|
|
|
|---|