proxmark3/doc/ext_flash_notes.md

130 lines
4.6 KiB
Markdown
Raw Normal View History

2019-07-18 03:11:34 +08:00
# External flash
2021-12-31 17:55:16 +08:00
<a id="Top"></a>
2019-07-18 03:11:34 +08:00
External 256kbytes flash is a unique feature of the RDV4 edition.
2021-12-31 17:55:16 +08:00
# Table of Contents
- [External flash](#external-flash)
- [Table of Contents](#table-of-contents)
- [Addresses](#addresses)
- [Layout](#layout)
- [Page3 Layout](#page3-layout)
- [RSA signature](#rsa-signature)
- [backup first!](#backup-first)
2019-07-18 03:11:34 +08:00
## Addresses
2021-12-31 17:55:16 +08:00
^[Top](#top)
2019-07-18 03:11:34 +08:00
Flash memory is
2023-04-06 20:54:00 +08:00
* 256KB (0x40000= 262144)
* divided into 4 pages of 64KB (0x10000 = 65536)
* 4 pages divided into 16 sectors of 4KB (0x1000 = 4096), so last sector is at 0x3F000
2019-07-18 03:11:34 +08:00
Therefore a flash address can be interpreted as such:
```
0xPSxxx e.g. 0x3FF7F
^ page ^ page 3
^ sector ^ sector 0xF
^^^ offset ^^^ offset 0xF7F
```
## Layout
2021-12-31 17:55:16 +08:00
^[Top](#top)
2019-07-18 03:11:34 +08:00
Page 0:
* available for user data
* to dump it: `mem dump f page0_dump o 0 l 65536`
* to erase it: `mem wipe p 0`
Page 1:
* available for user data
* to dump it: `mem dump f page1_dump o 65536 l 65536`
* to erase it: `mem wipe p 1`
Page 2:
* available for user data
* to dump it: `mem dump f page2_dump o 131072 l 65536`
* to erase it: `mem wipe p 2`
Page 3:
* used by Proxmark3 RDV4 specific functions: flash signature and keys dictionaries, see below for details
* to dump it: `mem dump f page3_dump o 196608 l 65536`
* to erase it:
* **Beware** it will erase your flash signature so better to back it up first as you won't be able to regenerate it by yourself!
* edit the source code to enable Page 3 as a valid input in the `mem wipe` command.
2019-07-18 03:11:34 +08:00
* Updating keys dictionaries doesn't require to erase page 3.
## Page3 Layout
2021-12-31 17:55:16 +08:00
^[Top](#top)
2019-07-18 03:11:34 +08:00
Page3 is used as follows by the Proxmark3 RDV4 firmware:
* **MF_KEYS**
* offset: page 3 sector 9 (0x9) @ 3*0x10000+9*0x1000=0x39000
* length: 2 sectors
* **ICLASS_KEYS**
* offset: page 3 sector 11 (0xB) @ 3*0x10000+11*0x1000=0x3B000
* length: 1 sector
* **T55XX_KEYS**
* offset: page 3 sector 12 (0xC) @ 3*0x10000+12*0x1000=0x3C000
* length: 1 sector
* **T55XX_CONFIG**
* offset: page 3 sector 13 (0xD) @ 3*0x10000+13*0x1000=0x3D000
* length: 1 sector (actually only a few bytes are used to store `t55xx_config` structure)
* **RSA SIGNATURE**, see below for details
* offset: page 3 sector 15 (0xF) offset 0xF7F @ 3*0x10000+15*0x1000+0xF7F=0x3FF7F (decimal 262015)
2019-07-18 03:11:34 +08:00
* length: 128 bytes
* offset should have been 0x3FF80 but historically it's one byte off and therefore the last byte of the flash is unused
## RSA signature
2021-12-31 17:55:16 +08:00
^[Top](#top)
2019-07-18 03:11:34 +08:00
To ensure your Proxmark3 RDV4 is not a counterfeit product, its external flash contains a RSA signature of the flash unique ID.
You can verify it with: `mem info`
2021-03-07 17:18:50 +08:00
Here below is a sample output of a RDV4 device.
2019-07-18 03:11:34 +08:00
```
2021-03-07 17:18:50 +08:00
[usb] pm3 --> mem info
[=] --- Flash memory Information ---------
[=] ID................... 25AD99A782A867D5
[=] SHA1................. 67C3B9BA2FA90AD4B283926B70017066C082C156
[+] Signature............ ( ok )
[=] --- RDV4 RSA signature ---------------
[=] C7C7DF7FA3A2391A2B36E97D227C746ED8BB475E8766F54A13BAA9AAB29299BE
[=] 37546AACCC29157ABF8AFBF3A1CFB24275442D565F7E996C6B08090528ADE25E
[=] ED1498E3089C72C68348D83CBD13F1247327BDBC9D75B09ECE3E051E19FE19BB
[=] 98CB038757F2EDFD2DC5060D05C3296BC19A6F768290D555DFD50407E0E13A70
[=] --- RDV4 RSA Public key --------------
[=] Len.................. 128
[=] Exponent............. 010001
[=] Public key modulus N
[=] E28D809BF323171D11D1ACA4C32A5B7E0A8974FD171E75AD120D60E9B76968FF
[=] 4B0A6364AE50583F9555B8EE1A725F279E949246DF0EFCE4C02B9F3ACDCC623F
[=] 9337F21C0C066FFB703D8BFCB5067F309E056772096642C2B1A8F50305D5EC33
[=] DB7FB5A3C8AC42EB635AE3C148C910750ABAA280CE82DC2F180F49F30A1393B5
[+] RSA public key validation.... ( ok )
[+] RSA private key validation... ( ok )
[+] RSA verification..... ( ok )
[+] Genuine Proxmark3 RDV4 signature detected
2019-07-18 03:11:34 +08:00
```
2021-03-07 17:18:50 +08:00
# backup first!
2021-12-31 17:55:16 +08:00
^[Top](#top)
To make a backup of the signature to file:
2021-03-07 17:18:50 +08:00
`mem dump -f flash_signature_dump -o 262015 -l 128`
2019-07-18 03:11:34 +08:00