arno/trezor-firmware
1
0
Fork 0
mirror of https://github.com/trezor/trezor-firmware.git synced 2024-12-25 15:58:08 +00:00
Code Issues Releases Wiki Activity

update info about bootloader format

Browse Source
This commit is contained in:
Pavol Rusnak 2016-05-10 16:42:20 +02:00
parent e1450e3f7f
commit 5fe006f41d
No known key found for this signature in database
GPG Key ID: 91F3B339B9A02A3D
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/bootloader.md
View File

@ -12,6 +12,8 @@ TREZOR Core firmware file consists of 3 parts:
###Vendor Header ###Vendor Header
Total length of vendor header is 82 + 32 * (number of pubkeys) + (length of vendor string) + (length of vendor image) bytes rounded up to the closest multiply of 256 bytes.
| offset | length | name | description | | offset | length | name | description |
|-------:|-------:|------|-------------| |-------:|-------:|------|-------------|
| 0x0000 | 4 | magic | firmware magic `TRZV` | | 0x0000 | 4 | magic | firmware magic `TRZV` |
@ -19,17 +21,20 @@ TREZOR Core firmware file consists of 3 parts:
| 0x0008 | 4 | expiry | valid until timestamp | | 0x0008 | 4 | expiry | valid until timestamp |
| 0x000C | 1 | vsig_m | number of signatures needed to run the firmware from this vendor | | 0x000C | 1 | vsig_m | number of signatures needed to run the firmware from this vendor |
| 0x000D | 1 | vsig_n | number of pubkeys vendor wants to use for signing | | 0x000D | 1 | vsig_n | number of pubkeys vendor wants to use for signing |
| 0x000E | 1 | vstr_len | vendor string length | | 0x000E | 2 | reserved | not used yet |
| 0x000F | ? | vstr | vendor string | | 0x0010 | 32 | vpub1 | vendor pubkey 1 |
| ? | ? | vimg | vendor image (in [TOIf format](toif.md)) |
| ? | 32 | vpub1 | vendor pubkey 1 |
| ... | ... | ... | ... | | ... | ... | ... | ... |
| ? | 32 | vpubn | vendor pubkey n | | ? | 32 | vpubn | vendor pubkey n |
| ? | 1 | slsigidx | SatoshiLabs signature indexes | | ? | 1 | vstr_len | vendor string length |
| ? | ? | vstr | vendor string |
| ? | ? | vimg | vendor image (in [TOIf format](toif.md)) |
| ? | 1 | slsigidx | SatoshiLabs signature indexes (bitmap) |
| ? | 64 | slsig | SatoshiLabs signature | | ? | 64 | slsig | SatoshiLabs signature |
###Firmware Header ###Firmware Header
Total length of firmware header is 256 bytes.
| offset | length | name | description | | offset | length | name | description |
|-------:|-------:|------|-------------| |-------:|-------:|------|-------------|
| 0x0000 | 4 | magic | firmware magic `TRZF` | | 0x0000 | 4 | magic | firmware magic `TRZF` |
@ -40,5 +45,6 @@ TREZOR Core firmware file consists of 3 parts:
| 0x0011 | 1 | vminor | version (minor) | | 0x0011 | 1 | vminor | version (minor) |
| 0x0012 | 1 | vpatch | version (patch) | | 0x0012 | 1 | vpatch | version (patch) |
| 0x0013 | 1 | vbuild | version (build) | | 0x0013 | 1 | vbuild | version (build) |
| 0x0014 | 1 | vidx | vendor signature indexes | | 0x0014 | 1 | vndsigidx | vendor signature indexes (bitmap) |
| 0x0015 | 64 | vsign | vendor signature | | 0x0015 | 64 | vndsig | vendor signature |
| 0x0079 | 135 | reserved | not used yet |