git.zerfleddert.de Git - proxmark3-svn/blob - common/protocols.h

   1 #ifndef PROTOCOLS_H
   2 #define PROTOCOLS_H
   3
   4 //The following data is taken from http://www.proxmark.org/forum/viewtopic.php?pid=13501#p13501
   5 /*
   6 ISO14443A (usually NFC tags)
   7         26 (7bits) = REQA
   8         30 = Read (usage: 30+1byte block number+2bytes ISO14443A-CRC - answer: 16bytes)
   9         A2 = Write (usage: A2+1byte block number+4bytes data+2bytes ISO14443A-CRC - answer: 0A [ACK] or 00 [NAK])
  10         52 (7bits) = WUPA (usage: 52(7bits) - answer: 2bytes ATQA)
  11         93 20 = Anticollision (usage: 9320 - answer: 4bytes UID+1byte UID-bytes-xor)
  12         93 70 = Select (usage: 9370+5bytes 9320 answer - answer: 1byte SAK)
  13         95 20 = Anticollision of cascade level2
  14         95 70 = Select of cascade level2
  15         50 00 = Halt (usage: 5000+2bytes ISO14443A-CRC - no answer from card)
  16 Mifare
  17         60 = Authenticate with KeyA
  18         61 = Authenticate with KeyB
  19         40 (7bits) = Used to put Chinese Changeable UID cards in special mode (must be followed by 43 (8bits) - answer: 0A)
  20         C0 = Decrement
  21         C1 = Increment
  22         C2 = Restore
  23         B0 = Transfer
  24 Ultralight C
  25         A0 = Compatibility Write (to accomodate MIFARE commands)
  26         1A = Step1 Authenticate
  27         AF = Step2 Authenticate
  28
  29
  30 ISO14443B
  31         05 = REQB
  32         1D = ATTRIB
  33         50 = HALT
  34
  35         BA = PING (reader -> tag)
  36         AB = PONG (tag -> reader)
  37 SRIX4K (tag does not respond to 05)
  38         06 00 = INITIATE
  39         0E xx = SELECT ID (xx = Chip-ID)
  40         0B = Get UID
  41         08 yy = Read Block (yy = block number)
  42         09 yy dd dd dd dd = Write Block (yy = block number; dd dd dd dd = data to be written)
  43         0C = Reset to Inventory
  44         0F = Completion
  45         0A 11 22 33 44 55 66 = Authenticate (11 22 33 44 55 66 = data to authenticate)
  46
  47
  48 ISO15693
  49         MANDATORY COMMANDS (all ISO15693 tags must support those)
  50                 01 = Inventory (usage: 260100+2bytes ISO15693-CRC - answer: 12bytes)
  51                 02 = Stay Quiet
  52         OPTIONAL COMMANDS (not all tags support them)
  53                 20 = Read Block (usage: 0220+1byte block number+2bytes ISO15693-CRC - answer: 4bytes)
  54                 21 = Write Block (usage: 0221+1byte block number+4bytes data+2bytes ISO15693-CRC - answer: 4bytes)
  55                 22 = Lock Block
  56                 23 = Read Multiple Blocks (usage: 0223+1byte 1st block to read+1byte last block to read+2bytes ISO15693-CRC)
  57                 25 = Select
  58                 26 = Reset to Ready
  59                 27 = Write AFI
  60                 28 = Lock AFI
  61                 29 = Write DSFID
  62                 2A = Lock DSFID
  63                 2B = Get_System_Info (usage: 022B+2bytes ISO15693-CRC - answer: 14 or more bytes)
  64                 2C = Read Multiple Block Security Status (usage: 022C+1byte 1st block security to read+1byte last block security to read+2bytes ISO15693-CRC)
  65
  66 EM Microelectronic CUSTOM COMMANDS
  67         A5 = Active EAS (followed by 1byte IC Manufacturer code+1byte EAS type)
  68         A7 = Write EAS ID (followed by 1byte IC Manufacturer code+2bytes EAS value)
  69         B8 = Get Protection Status for a specific block (followed by 1byte IC Manufacturer code+1byte block number+1byte of how many blocks after the previous is needed the info)
  70         E4 = Login (followed by 1byte IC Manufacturer code+4bytes password)
  71 NXP/Philips CUSTOM COMMANDS
  72         A0 = Inventory Read
  73         A1 = Fast Inventory Read
  74         A2 = Set EAS
  75         A3 = Reset EAS
  76         A4 = Lock EAS
  77         A5 = EAS Alarm
  78         A6 = Password Protect EAS
  79         A7 = Write EAS ID
  80         A8 = Read EPC
  81         B0 = Inventory Page Read
  82         B1 = Fast Inventory Page Read
  83         B2 = Get Random Number
  84         B3 = Set Password
  85         B4 = Write Password
  86         B5 = Lock Password
  87         B6 = Bit Password Protection
  88         B7 = Lock Page Protection Condition
  89         B8 = Get Multiple Block Protection Status
  90         B9 = Destroy SLI
  91         BA = Enable Privacy
  92         BB = 64bit Password Protection
  93         40 = Long Range CMD (Standard ISO/TR7003:1990)
  94
  95 ISO 7816-4 Basic interindustry commands. For command APDU's.
  96         B0 = READ BINARY
  97         D0 = WRITE BINARY
  98         D6 = UPDATE BINARY
  99         0E = ERASE BINARY
 100         B2 = READ RECORDS
 101         D2 = WRITE RECORDS
 102         E2 = APPEND RECORD
 103         DC = UPDATE RECORD
 104         CA = GET DATA
 105         DA = PUT DATA
 106         A4 = SELECT FILE
 107         20 = VERIFY
 108         88 = INTERNAL AUTHENTICATION
 109         82 = EXTERNAL AUTHENTICATION
 110         B4 = GET CHALLENGE
 111         70 = MANAGE CHANNEL
 112
 113         For response APDU's
 114         90 00 = OK
 115         6x xx = ERROR
 116 */
 117
 118 #define ICLASS_CMD_ACTALL           0x0A
 119 #define ICLASS_CMD_READ_OR_IDENTIFY 0x0C
 120 #define ICLASS_CMD_SELECT           0x81
 121 #define ICLASS_CMD_PAGESEL          0x84
 122 #define ICLASS_CMD_READCHECK_KD     0x88
 123 #define ICLASS_CMD_READCHECK_KC     0x18
 124 #define ICLASS_CMD_CHECK            0x05
 125 #define ICLASS_CMD_DETECT           0x0F
 126 #define ICLASS_CMD_HALT             0x00
 127 #define ICLASS_CMD_UPDATE                       0x87
 128 #define ICLASS_CMD_ACT              0x8E
 129 #define ICLASS_CMD_READ4            0x06
 130
 131
 132 #define ISO14443A_CMD_REQA       0x26
 133 #define ISO14443A_CMD_READBLOCK  0x30
 134 #define ISO14443A_CMD_WUPA       0x52
 135 #define ISO14443A_CMD_ANTICOLL_OR_SELECT     0x93
 136 #define ISO14443A_CMD_ANTICOLL_OR_SELECT_2   0x95
 137 #define ISO14443A_CMD_WRITEBLOCK 0xA0
 138 #define ISO14443A_CMD_HALT       0x50
 139 #define ISO14443A_CMD_RATS       0xE0
 140
 141 #define MIFARE_AUTH_KEYA            0x60
 142 #define MIFARE_AUTH_KEYB            0x61
 143 #define MIFARE_MAGICWUPC1           0x40
 144 #define MIFARE_MAGICWUPC2               0x43
 145 #define MIFARE_MAGICWIPEC               0x41
 146 #define MIFARE_CMD_INC          0xC0
 147 #define MIFARE_CMD_DEC          0xC1
 148 #define MIFARE_CMD_RESTORE      0xC2
 149 #define MIFARE_CMD_TRANSFER     0xB0
 150
 151 #define MIFARE_ULC_WRITE        0xA2
 152 //#define MIFARE_ULC__COMP_WRITE  0xA0
 153 #define MIFARE_ULC_AUTH_1       0x1A
 154 #define MIFARE_ULC_AUTH_2       0xAF
 155
 156 #define MIFARE_ULEV1_AUTH               0x1B
 157 #define MIFARE_ULEV1_VERSION    0x60
 158 #define MIFARE_ULEV1_FASTREAD   0x3A
 159 #define MIFARE_ULEV1_READ_CNT   0x39
 160 #define MIFARE_ULEV1_INCR_CNT   0xA5
 161 #define MIFARE_ULEV1_READSIG    0x3C
 162 #define MIFARE_ULEV1_CHECKTEAR  0x3E
 163 #define MIFARE_ULEV1_VCSL               0x4B
 164
 165 /**
 166 06 00 = INITIATE
 167 0E xx = SELECT ID (xx = Chip-ID)
 168 0B = Get UID
 169 08 yy = Read Block (yy = block number)
 170 09 yy dd dd dd dd = Write Block (yy = block number; dd dd dd dd = data to be written)
 171 0C = Reset to Inventory
 172 0F = Completion
 173 0A 11 22 33 44 55 66 = Authenticate (11 22 33 44 55 66 = data to authenticate)
 174 **/
 175
 176 #define ISO14443B_REQB         0x05
 177 #define ISO14443B_ATTRIB       0x1D
 178 #define ISO14443B_HALT         0x50
 179 #define ISO14443B_INITIATE     0x06
 180 #define ISO14443B_SELECT       0x0E
 181 #define ISO14443B_GET_UID      0x0B
 182 #define ISO14443B_READ_BLK     0x08
 183 #define ISO14443B_WRITE_BLK    0x09
 184 #define ISO14443B_RESET        0x0C
 185 #define ISO14443B_COMPLETION   0x0F
 186 #define ISO14443B_AUTHENTICATE 0x0A
 187 #define ISO14443B_PING             0xBA
 188 #define ISO14443B_PONG             0xAB
 189
 190 //First byte is 26
 191 #define ISO15693_INVENTORY     0x01
 192 #define ISO15693_STAYQUIET     0x02
 193 //First byte is 02
 194 #define ISO15693_READBLOCK            0x20
 195 #define ISO15693_WRITEBLOCK           0x21
 196 #define ISO15693_LOCKBLOCK            0x22
 197 #define ISO15693_READ_MULTI_BLOCK     0x23
 198 #define ISO15693_SELECT               0x25
 199 #define ISO15693_RESET_TO_READY       0x26
 200 #define ISO15693_WRITE_AFI            0x27
 201 #define ISO15693_LOCK_AFI             0x28
 202 #define ISO15693_WRITE_DSFID          0x29
 203 #define ISO15693_LOCK_DSFID           0x2A
 204 #define ISO15693_GET_SYSTEM_INFO      0x2B
 205 #define ISO15693_READ_MULTI_SECSTATUS 0x2C
 206
 207
 208 // Topaz command set:
 209 #define TOPAZ_REQA                                              0x26    // Request
 210 #define TOPAZ_WUPA                                              0x52    // WakeUp
 211 #define TOPAZ_RID                                               0x78    // Read ID
 212 #define TOPAZ_RALL                                              0x00    // Read All (all bytes)
 213 #define TOPAZ_READ                                              0x01    // Read (a single byte)
 214 #define TOPAZ_WRITE_E                                   0x53    // Write-with-erase (a single byte)
 215 #define TOPAZ_WRITE_NE                                  0x1a    // Write-no-erase (a single byte)
 216 // additional commands for Dynamic Memory Model
 217 #define TOPAZ_RSEG                                              0x10    // Read segment
 218 #define TOPAZ_READ8                                             0x02    // Read (eight bytes)
 219 #define TOPAZ_WRITE_E8                                  0x54    // Write-with-erase (eight bytes)
 220 #define TOPAZ_WRITE_NE8                                 0x1B    // Write-no-erase (eight bytes)
 221
 222
 223 #define ISO_14443A      0
 224 #define ICLASS          1
 225 #define ISO_14443B      2
 226 #define TOPAZ           3
 227 #define ISO_7816_4  4
 228
 229 //-- Picopass fuses
 230 #define FUSE_FPERS   0x80
 231 #define FUSE_CODING1 0x40
 232 #define FUSE_CODING0 0x20
 233 #define FUSE_CRYPT1  0x10
 234 #define FUSE_CRYPT0  0x08
 235 #define FUSE_FPROD1  0x04
 236 #define FUSE_FPROD0  0x02
 237 #define FUSE_RA      0x01
 238
 239 // ISO 7816-4 Basic interindustry commands. For command APDU's.
 240 #define ISO7816_READ_BINARY 0xB0
 241 #define ISO7816_WRITE_BINARY 0xD0
 242 #define ISO7816_UPDATE_BINARY 0xD6
 243 #define ISO7816_ERASE_BINARY 0x0E
 244 #define ISO7816_READ_RECORDS 0xB2
 245 #define ISO7816_WRITE_RECORDS 0xD2
 246 #define ISO7816_APPEND_RECORD 0xE2
 247 #define ISO7816_UPDATE_RECORD 0xDC
 248 #define ISO7816_GET_DATA 0xCA
 249 #define ISO7816_PUT_DATA 0xDA
 250 #define ISO7816_SELECT_FILE 0xA4
 251 #define ISO7816_VERIFY 0x20
 252 #define ISO7816_INTERNAL_AUTHENTICATION 0x88
 253 #define ISO7816_EXTERNAL_AUTHENTICATION 0x82
 254 #define ISO7816_GET_CHALLENGE 0xB4
 255 #define ISO7816_MANAGE_CHANNEL 0x70
 256
 257 // ISO7816-4    For response APDU's
 258 #define ISO7816_OK      0x9000
 259 //      6x xx = ERROR
 260
 261 void printIclassDumpInfo(uint8_t* iclass_dump);
 262
 263 #endif // PROTOCOLS_H