doc/mfu_binary_format_notes.md

   1 # Notes on MFU binary formats
   2 <a id="Top"></a>
   3
   4
   5 # Table of Contents
   6 - [Notes on MFU binary formats](#notes-on-mfu-binary-formats)
   7 - [Table of Contents](#table-of-contents)
   8   - [New mfu format](#new-mfu-format)
   9   - [Old mfu format](#old-mfu-format)
  10   - [Plain mfu format](#plain-mfu-format)
  11   - [future mfu format](#future-mfu-format)
  12
  13
  14
  15 ## New mfu format
  16 ^[Top](#top)
  17
  18 The new mfu binary format was created to compensate for different manufactures tag functions.
  19 Like UL-Ev1 has three counter and tearing bytes,  while NTAG only has one counter and tearing byte.
  20 PACK was removed from header, since its just normally part of the tag memory,  unreadable,  but when
  21 a proxmark3 dumps a tag and we have pwd/pack,  we add those to their normal location in memory.
  22 This makes memory not a exact memory dump from a tag, but a "what it should have looked like" if we could read all memory
  23
  24 ```
  25 // New Ultralight/NTAG dump file format
  26 // Length must be aligned to 4 bytes (UL/NTAG page)
  27 #define MFU_DUMP_PREFIX_LENGTH 56
  28
  29 typedef struct {
  30     uint8_t version[8];
  31     uint8_t tbo[2];
  32     uint8_t tbo1[1];
  33     uint8_t pages;                  // max page number in dump
  34     uint8_t signature[32];
  35     uint8_t counter_tearing[3][4];  // 3 bytes counter, 1 byte tearing flag
  36     uint8_t data[1024];
  37 } PACKED mfu_dump_t;
  38 ```
  39
  40 ## Old mfu format
  41 ^[Top](#top)
  42
  43 The old binary format saved the extra data on tag in order for the Proxmark3 to able to simulate a real tag.
  44
  45 ```
  46 // Old Ultralight/NTAG dump file format
  47 #define OLD_MFU_DUMP_PREFIX_LENGTH 48
  48
  49 typedef struct {
  50     uint8_t version[8];
  51     uint8_t tbo[2];
  52     uint8_t tearing[3];
  53     uint8_t pack[2];
  54     uint8_t tbo1[1];
  55     uint8_t signature[32];
  56     uint8_t data[1024];
  57 } old_mfu_dump_t;
  58 ```
  59
  60 ## Plain mfu format
  61 ^[Top](#top)
  62
  63 The first binary format for MFU was just a memory dump from the tag block 0 to end.
  64 No extra data was saved.
  65 ```
  66     uint8_t data[1024];
  67 ```
  68
  69 ## future mfu format
  70 ^[Top](#top)
  71
  72 For developers of apps and other tools, like libnfc,   we don't recommend using binary formats.
  73 We decided to adopt a JSON based format,  which is much more flexible to changes of new tag functionality.
  74
  75 Example
  76 ```
  77 {
  78   "Created": "proxmark3",
  79   "FileType": "mfu",
  80   "Card": {
  81     "UID": "04F654CAFC388",
  82     "Version": "0004030101000B0",
  83     "TBO_0": "000",
  84     "TBO_1": "0",
  85     "Signature": "BC9BFD4B550C16B2B5A5ABA10B644A027B4CB03DDB46F94D992DC0FB02E0C3F",
  86     "Counter0": "00000",
  87     "Tearing0": "BD",
  88     "Counter1": "00000",
  89     "Tearing1": "BD",
  90     "Counter2": "00000",
  91     "Tearing2": "BD"
  92   },
  93   "blocks": {
  94     "0": "04F6542",
  95     "1": "CAFC388",
  96     "2": "8E48000",
  97     "3": "E110120",
  98     "4": "0103A00",
  99     "5": "340300F",
 100     "6": "0000000",
 101     "7": "0000000",
 102     "8": "0000000",
 103     "9": "0000000",
 104     "10": "0000000",
 105     "11": "0000000",
 106     "12": "1122334",
 107     "13": "0000000",
 108     "14": "0000000",
 109     "15": "0000000",
 110     "16": "000000F",
 111     "17": "0005000",
 112     "18": "0000000",
 113     "19": "0000000"
 114   }
 115 }
 116 ```