git.zerfleddert.de Git - proxmark3-svn/blob - client/cmdhf.c

   1 //-----------------------------------------------------------------------------
   2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
   3 // Merlok - 2017
   4 //
   5 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
   6 // at your option, any later version. See the LICENSE.txt file for the text of
   7 // the license.
   8 //-----------------------------------------------------------------------------
   9 // High frequency commands
  10 //-----------------------------------------------------------------------------
  11
  12 #include <stdlib.h>
  13 #include <stdio.h>
  14 #include <string.h>
  15 #include "proxmark3.h"
  16 #include "util.h"
  17 #include "data.h"
  18 #include "ui.h"
  19 #include "iso14443crc.h"
  20 #include "parity.h"
  21 #include "cmdmain.h"
  22 #include "cmdparser.h"
  23 #include "cmdhf.h"
  24 #include "cmdhf14a.h"
  25 #include "cmdhf14b.h"
  26 #include "cmdhf15.h"
  27 #include "cmdhfepa.h"
  28 #include "cmdhflegic.h"
  29 #include "cmdhficlass.h"
  30 #include "cmdhfmf.h"
  31 #include "cmdhfmfu.h"
  32 #include "cmdhftopaz.h"
  33 #include "protocols.h"
  34 #include "emv/cmdemv.h"
  35 #include "cmdhflist.h"
  36
  37 static int CmdHelp(const char *Cmd);
  38
  39 int CmdHFTune(const char *Cmd)
  40 {
  41   UsbCommand c={CMD_MEASURE_ANTENNA_TUNING_HF};
  42   SendCommand(&c);
  43   return 0;
  44 }
  45
  46 /**
  47  * @brief iso14443B_CRC_check Checks CRC in command or response
  48  * @param isResponse
  49  * @param data
  50  * @param len
  51  * @return  0 : CRC-command, CRC not ok
  52  *          1 : CRC-command, CRC ok
  53  *          2 : Not crc-command
  54  */
  55
  56 uint8_t iso14443B_CRC_check(bool isResponse, uint8_t* data, uint8_t len)
  57 {
  58         uint8_t b1,b2;
  59
  60         if(len <= 2) return 2;
  61
  62         ComputeCrc14443(CRC_14443_B, data, len-2, &b1, &b2);
  63         if(b1 != data[len-2] || b2 != data[len-1]) {
  64                 return 0;
  65         } else {
  66                 return 1;
  67         }
  68 }
  69
  70 /**
  71  * @brief iclass_CRC_Ok Checks CRC in command or response
  72  * @param isResponse
  73  * @param data
  74  * @param len
  75  * @return  0 : CRC-command, CRC not ok
  76  *              1 : CRC-command, CRC ok
  77  *          2 : Not crc-command
  78  */
  79 uint8_t iclass_CRC_check(bool isResponse, uint8_t* data, uint8_t len)
  80 {
  81         if(len < 4) return 2;//CRC commands (and responses) are all at least 4 bytes
  82
  83         uint8_t b1, b2;
  84
  85         if(!isResponse)//Commands to tag
  86         {
  87                 /**
  88                   These commands should have CRC. Total length leftmost
  89                   4     READ
  90                   4 READ4
  91                   12 UPDATE - unsecured, ends with CRC16
  92                   14 UPDATE - secured, ends with signature instead
  93                   4 PAGESEL
  94                   **/
  95                 if(len == 4 || len == 12)//Covers three of them
  96                 {
  97                         //Don't include the command byte
  98                         ComputeCrc14443(CRC_ICLASS, (data+1), len-3, &b1, &b2);
  99                         return b1 == data[len -2] && b2 == data[len-1];
 100                 }
 101                 return 2;
 102         }else{
 103                 /**
 104                 These tag responses should have CRC. Total length leftmost
 105
 106                 10  READ                data[8] crc[2]
 107                 34  READ4               data[32]crc[2]
 108                 10  UPDATE      data[8] crc[2]
 109                 10 SELECT       csn[8] crc[2]
 110                 10  IDENTIFY  asnb[8] crc[2]
 111                 10  PAGESEL   block1[8] crc[2]
 112                 10  DETECT    csn[8] crc[2]
 113
 114                 These should not
 115
 116                 4  CHECK                chip_response[4]
 117                 8  READCHECK data[8]
 118                 1  ACTALL    sof[1]
 119                 1  ACT       sof[1]
 120
 121                 In conclusion, without looking at the command; any response
 122                 of length 10 or 34 should have CRC
 123                   **/
 124                 if(len != 10 && len != 34) return true;
 125
 126                 ComputeCrc14443(CRC_ICLASS, data, len-2, &b1, &b2);
 127                 return b1 == data[len -2] && b2 == data[len-1];
 128         }
 129 }
 130
 131
 132 bool is_last_record(uint16_t tracepos, uint8_t *trace, uint16_t traceLen)
 133 {
 134         return(tracepos + sizeof(uint32_t) + sizeof(uint16_t) + sizeof(uint16_t) >= traceLen);
 135 }
 136
 137
 138 bool next_record_is_response(uint16_t tracepos, uint8_t *trace)
 139 {
 140         uint16_t next_records_datalen = *((uint16_t *)(trace + tracepos + sizeof(uint32_t) + sizeof(uint16_t)));
 141
 142         return(next_records_datalen & 0x8000);
 143 }
 144
 145
 146 bool merge_topaz_reader_frames(uint32_t timestamp, uint32_t *duration, uint16_t *tracepos, uint16_t traceLen, uint8_t *trace, uint8_t *frame, uint8_t *topaz_reader_command, uint16_t *data_len)
 147 {
 148
 149 #define MAX_TOPAZ_READER_CMD_LEN        16
 150
 151         uint32_t last_timestamp = timestamp + *duration;
 152
 153         if ((*data_len != 1) || (frame[0] == TOPAZ_WUPA) || (frame[0] == TOPAZ_REQA)) return false;
 154
 155         memcpy(topaz_reader_command, frame, *data_len);
 156
 157         while (!is_last_record(*tracepos, trace, traceLen) && !next_record_is_response(*tracepos, trace)) {
 158                 uint32_t next_timestamp = *((uint32_t *)(trace + *tracepos));
 159                 *tracepos += sizeof(uint32_t);
 160                 uint16_t next_duration = *((uint16_t *)(trace + *tracepos));
 161                 *tracepos += sizeof(uint16_t);
 162                 uint16_t next_data_len = *((uint16_t *)(trace + *tracepos)) & 0x7FFF;
 163                 *tracepos += sizeof(uint16_t);
 164                 uint8_t *next_frame = (trace + *tracepos);
 165                 *tracepos += next_data_len;
 166                 if ((next_data_len == 1) && (*data_len + next_data_len <= MAX_TOPAZ_READER_CMD_LEN)) {
 167                         memcpy(topaz_reader_command + *data_len, next_frame, next_data_len);
 168                         *data_len += next_data_len;
 169                         last_timestamp = next_timestamp + next_duration;
 170                 } else {
 171                         // rewind and exit
 172                         *tracepos = *tracepos - next_data_len - sizeof(uint16_t) - sizeof(uint16_t) - sizeof(uint32_t);
 173                         break;
 174                 }
 175                 uint16_t next_parity_len = (next_data_len-1)/8 + 1;
 176                 *tracepos += next_parity_len;
 177         }
 178
 179         *duration = last_timestamp - timestamp;
 180
 181         return true;
 182 }
 183
 184
 185 uint16_t printTraceLine(uint16_t tracepos, uint16_t traceLen, uint8_t *trace, uint8_t protocol, bool showWaitCycles, bool markCRCBytes)
 186 {
 187         bool isResponse;
 188         uint16_t data_len, parity_len;
 189         uint32_t duration;
 190         uint8_t topaz_reader_command[9];
 191         uint32_t timestamp, first_timestamp, EndOfTransmissionTimestamp;
 192         char explanation[30] = {0};
 193         uint8_t mfData[32] = {0};
 194         size_t mfDataLen = 0;
 195
 196         if (tracepos + sizeof(uint32_t) + sizeof(uint16_t) + sizeof(uint16_t) > traceLen) return traceLen;
 197
 198         first_timestamp = *((uint32_t *)(trace));
 199         timestamp = *((uint32_t *)(trace + tracepos));
 200
 201         tracepos += 4;
 202         duration = *((uint16_t *)(trace + tracepos));
 203         tracepos += 2;
 204         data_len = *((uint16_t *)(trace + tracepos));
 205         tracepos += 2;
 206
 207         if (data_len & 0x8000) {
 208           data_len &= 0x7fff;
 209           isResponse = true;
 210         } else {
 211           isResponse = false;
 212         }
 213         parity_len = (data_len-1)/8 + 1;
 214
 215         if (tracepos + data_len + parity_len > traceLen) {
 216                 return traceLen;
 217         }
 218         uint8_t *frame = trace + tracepos;
 219         tracepos += data_len;
 220         uint8_t *parityBytes = trace + tracepos;
 221         tracepos += parity_len;
 222
 223         if (protocol == TOPAZ && !isResponse) {
 224                 // topaz reader commands come in 1 or 9 separate frames with 7 or 8 Bits each.
 225                 // merge them:
 226                 if (merge_topaz_reader_frames(timestamp, &duration, &tracepos, traceLen, trace, frame, topaz_reader_command, &data_len)) {
 227                         frame = topaz_reader_command;
 228                 }
 229         }
 230
 231         //Check the CRC status
 232         uint8_t crcStatus = 2;
 233
 234         if (data_len > 2) {
 235                 switch (protocol) {
 236                         case ICLASS:
 237                                 crcStatus = iclass_CRC_check(isResponse, frame, data_len);
 238                                 break;
 239                         case ISO_14443B:
 240                         case TOPAZ:
 241                                 crcStatus = iso14443B_CRC_check(isResponse, frame, data_len);
 242                                 break;
 243                         case PROTO_MIFARE:
 244                                 crcStatus = mifare_CRC_check(isResponse, frame, data_len);
 245                                 break;
 246                         case ISO_14443A:
 247                                 crcStatus = iso14443A_CRC_check(isResponse, frame, data_len);
 248                                 break;
 249                         default:
 250                                 break;
 251                 }
 252         }
 253         //0 CRC-command, CRC not ok
 254         //1 CRC-command, CRC ok
 255         //2 Not crc-command
 256
 257         //--- Draw the data column
 258         //char line[16][110];
 259         char line[16][110];
 260
 261         for (int j = 0; j < data_len && j/16 < 16; j++) {
 262
 263                 uint8_t parityBits = parityBytes[j>>3];
 264                 if (protocol != ISO_14443B && (isResponse || protocol == ISO_14443A) && (oddparity8(frame[j]) != ((parityBits >> (7-(j&0x0007))) & 0x01))) {
 265                         snprintf(line[j/16]+(( j % 16) * 4),110, "%02x! ", frame[j]);
 266                 } else {
 267                         snprintf(line[j/16]+(( j % 16) * 4), 110, " %02x ", frame[j]);
 268                 }
 269
 270         }
 271
 272         if (markCRCBytes) {
 273                 if(crcStatus == 0 || crcStatus == 1)
 274                 {//CRC-command
 275                         char *pos1 = line[(data_len-2)/16]+(((data_len-2) % 16) * 4);
 276                         (*pos1) = '[';
 277                         char *pos2 = line[(data_len)/16]+(((data_len) % 16) * 4);
 278                         sprintf(pos2, "%c", ']');
 279                 }
 280         }
 281
 282         if(data_len == 0)
 283         {
 284                 if(data_len == 0){
 285                         sprintf(line[0],"<empty trace - possible error>");
 286                 }
 287         }
 288         //--- Draw the CRC column
 289
 290         char *crc = (crcStatus == 0 ? "!crc" : (crcStatus == 1 ? " ok " : "    "));
 291
 292         EndOfTransmissionTimestamp = timestamp + duration;
 293
 294         if (protocol == PROTO_MIFARE)
 295                 annotateMifare(explanation, sizeof(explanation), frame, data_len, parityBytes, parity_len, isResponse);
 296
 297         if(!isResponse)
 298         {
 299                 switch(protocol) {
 300                         case ICLASS:            annotateIclass(explanation,sizeof(explanation),frame,data_len); break;
 301                         case ISO_14443A:        annotateIso14443a(explanation,sizeof(explanation),frame,data_len); break;
 302                         case ISO_14443B:        annotateIso14443b(explanation,sizeof(explanation),frame,data_len); break;
 303                         case TOPAZ:                     annotateTopaz(explanation,sizeof(explanation),frame,data_len); break;
 304                         default:                        break;
 305                 }
 306         }
 307
 308         int num_lines = MIN((data_len - 1)/16 + 1, 16);
 309         for (int j = 0; j < num_lines ; j++) {
 310                 if (j == 0) {
 311                         PrintAndLog(" %10d | %10d | %s |%-64s | %s| %s",
 312                                 (timestamp - first_timestamp),
 313                                 (EndOfTransmissionTimestamp - first_timestamp),
 314                                 (isResponse ? "Tag" : "Rdr"),
 315                                 line[j],
 316                                 (j == num_lines-1) ? crc : "    ",
 317                                 (j == num_lines-1) ? explanation : "");
 318                 } else {
 319                         PrintAndLog("            |            |     |%-64s | %s| %s",
 320                                 line[j],
 321                                 (j == num_lines-1) ? crc : "    ",
 322                                 (j == num_lines-1) ? explanation : "");
 323                 }
 324         }
 325
 326         if (DecodeMifareData(frame, data_len, parityBytes, isResponse, mfData, &mfDataLen)) {
 327                 memset(explanation, 0x00, sizeof(explanation));
 328                 if (!isResponse) {
 329                         explanation[0] = '>';
 330                         annotateIso14443a(&explanation[1], sizeof(explanation) - 1, mfData, mfDataLen);
 331                 }
 332                 uint8_t crcc = iso14443A_CRC_check(isResponse, mfData, mfDataLen);
 333                 PrintAndLog("            |          * | dec |%-64s | %-4s| %s",
 334                         sprint_hex(mfData, mfDataLen),
 335                         (crcc == 0 ? "!crc" : (crcc == 1 ? " ok " : "    ")),
 336                         (true) ? explanation : "");
 337         };
 338
 339         if (is_last_record(tracepos, trace, traceLen)) return traceLen;
 340
 341         if (showWaitCycles && !isResponse && next_record_is_response(tracepos, trace)) {
 342                 uint32_t next_timestamp = *((uint32_t *)(trace + tracepos));
 343                 PrintAndLog(" %10d | %10d | %s | fdt (Frame Delay Time): %d",
 344                         (EndOfTransmissionTimestamp - first_timestamp),
 345                         (next_timestamp - first_timestamp),
 346                         "   ",
 347                         (next_timestamp - EndOfTransmissionTimestamp));
 348         }
 349
 350         return tracepos;
 351 }
 352
 353
 354 int CmdHFList(const char *Cmd)
 355 {
 356         bool showWaitCycles = false;
 357         bool markCRCBytes = false;
 358         char type[40] = {0};
 359         int tlen = param_getstr(Cmd,0,type, sizeof(type));
 360         char param1 = param_getchar(Cmd, 1);
 361         char param2 = param_getchar(Cmd, 2);
 362         bool errors = false;
 363         uint8_t protocol = 0;
 364         //Validate params
 365
 366         if(tlen == 0) {
 367                 errors = true;
 368         }
 369
 370         if(param1 == 'h'
 371                         || (param1 != 0 && param1 != 'f' && param1 != 'c')
 372                         || (param2 != 0 && param2 != 'f' && param2 != 'c')) {
 373                 errors = true;
 374         }
 375
 376         if(!errors) {
 377                 if(strcmp(type, "iclass") == 0) {
 378                         protocol = ICLASS;
 379                 } else if(strcmp(type, "mf") == 0) {
 380                         protocol = PROTO_MIFARE;
 381                 } else if(strcmp(type, "14a") == 0) {
 382                         protocol = ISO_14443A;
 383                 } else if(strcmp(type, "14b") == 0)     {
 384                         protocol = ISO_14443B;
 385                 } else if(strcmp(type,"topaz")== 0) {
 386                         protocol = TOPAZ;
 387                 } else if(strcmp(type,"raw")== 0) {
 388                         protocol = -1;//No crc, no annotations
 389                 } else {
 390                         errors = true;
 391                 }
 392         }
 393
 394         if (errors) {
 395                 PrintAndLog("List protocol data in trace buffer.");
 396                 PrintAndLog("Usage:  hf list <protocol> [f][c]");
 397                 PrintAndLog("    f      - show frame delay times as well");
 398                 PrintAndLog("    c      - mark CRC bytes");
 399                 PrintAndLog("Supported <protocol> values:");
 400                 PrintAndLog("    raw    - just show raw data without annotations");
 401                 PrintAndLog("    14a    - interpret data as iso14443a communications");
 402                 PrintAndLog("    mf     - interpret data as iso14443a communications and decrypt crypto1 stream");
 403                 PrintAndLog("    14b    - interpret data as iso14443b communications");
 404                 PrintAndLog("    iclass - interpret data as iclass communications");
 405                 PrintAndLog("    topaz  - interpret data as topaz communications");
 406                 PrintAndLog("");
 407                 PrintAndLog("example: hf list 14a f");
 408                 PrintAndLog("example: hf list iclass");
 409                 return 0;
 410         }
 411
 412
 413         if (param1 == 'f' || param2 == 'f') {
 414                 showWaitCycles = true;
 415         }
 416
 417         if (param1 == 'c' || param2 == 'c') {
 418                 markCRCBytes = true;
 419         }
 420
 421         uint8_t *trace;
 422         uint16_t tracepos = 0;
 423         trace = malloc(USB_CMD_DATA_SIZE);
 424
 425         // Query for the size of the trace
 426         UsbCommand response;
 427         GetFromBigBuf(trace, USB_CMD_DATA_SIZE, 0);
 428         WaitForResponse(CMD_ACK, &response);
 429         uint16_t traceLen = response.arg[2];
 430         if (traceLen > USB_CMD_DATA_SIZE) {
 431                 uint8_t *p = realloc(trace, traceLen);
 432                 if (p == NULL) {
 433                         PrintAndLog("Cannot allocate memory for trace");
 434                         free(trace);
 435                         return 2;
 436                 }
 437                 trace = p;
 438                 GetFromBigBuf(trace, traceLen, 0);
 439                 WaitForResponse(CMD_ACK, NULL);
 440         }
 441
 442         PrintAndLog("Recorded Activity (TraceLen = %d bytes)", traceLen);
 443         PrintAndLog("");
 444         PrintAndLog("Start = Start of Start Bit, End = End of last modulation. Src = Source of Transfer");
 445         PrintAndLog("iso14443a - All times are in carrier periods (1/13.56Mhz)");
 446         PrintAndLog("iClass    - Timings are not as accurate");
 447         PrintAndLog("");
 448         PrintAndLog("      Start |        End | Src | Data (! denotes parity error)                                   | CRC | Annotation         |");
 449         PrintAndLog("------------|------------|-----|-----------------------------------------------------------------|-----|--------------------|");
 450
 451         ClearAuthData();
 452         while(tracepos < traceLen)
 453         {
 454                 tracepos = printTraceLine(tracepos, traceLen, trace, protocol, showWaitCycles, markCRCBytes);
 455         }
 456
 457         free(trace);
 458         return 0;
 459 }
 460
 461 int CmdHFSearch(const char *Cmd){
 462         int ans = 0;
 463         PrintAndLog("");
 464         ans = CmdHF14AInfo("s");
 465         if (ans > 0) {
 466                 PrintAndLog("\nValid ISO14443A Tag Found - Quiting Search\n");
 467                 return ans;
 468         }
 469         ans = HFiClassReader("", false, false);
 470         if (ans) {
 471                 PrintAndLog("\nValid iClass Tag (or PicoPass Tag) Found - Quiting Search\n");
 472                 return ans;
 473         }
 474         ans = HF15Reader("", false);
 475         if (ans) {
 476                 PrintAndLog("\nValid ISO15693 Tag Found - Quiting Search\n");
 477                 return ans;
 478         }
 479         //14b is longest test currently (and rarest chip type) ... put last
 480         ans = HF14BInfo(false);
 481         if (ans) {
 482                 PrintAndLog("\nValid ISO14443B Tag Found - Quiting Search\n");
 483                 return ans;
 484         }
 485         PrintAndLog("\nno known/supported 13.56 MHz tags found\n");
 486         return 0;
 487 }
 488
 489 int CmdHFSnoop(const char *Cmd)
 490 {
 491         char * pEnd;
 492         UsbCommand c = {CMD_HF_SNIFFER, {strtol(Cmd, &pEnd,0),strtol(pEnd, &pEnd,0),0}};
 493         SendCommand(&c);
 494         return 0;
 495 }
 496
 497 static command_t CommandTable[] =
 498 {
 499         {"help",        CmdHelp,                1, "This help"},
 500         {"14a",         CmdHF14A,               1, "{ ISO14443A RFIDs... }"},
 501         {"14b",         CmdHF14B,               1, "{ ISO14443B RFIDs... }"},
 502         {"15",          CmdHF15,                1, "{ ISO15693 RFIDs... }"},
 503         {"epa",         CmdHFEPA,               1, "{ German Identification Card... }"},
 504         {"emv",         CmdHFEMV,               1, "{ EMV cards... }"},
 505         {"legic",       CmdHFLegic,             0, "{ LEGIC RFIDs... }"},
 506         {"iclass",      CmdHFiClass,    1, "{ ICLASS RFIDs... }"},
 507         {"mf",          CmdHFMF,                1, "{ MIFARE RFIDs... }"},
 508         {"mfu",         CmdHFMFUltra,   1, "{ MIFARE Ultralight RFIDs... }"},
 509         {"topaz",       CmdHFTopaz,             1, "{ TOPAZ (NFC Type 1) RFIDs... }"},
 510         {"tune",        CmdHFTune,              0, "Continuously measure HF antenna tuning"},
 511         {"list",        CmdHFList,              1, "List protocol data in trace buffer"},
 512         {"search",      CmdHFSearch,    1, "Search for known HF tags [preliminary]"},
 513         {"snoop",   CmdHFSnoop,     0, "<samples to skip (10000)> <triggers to skip (1)> Generic HF Snoop"},
 514         {NULL,          NULL,                   0, NULL}
 515 };
 516
 517 int CmdHF(const char *Cmd)
 518 {
 519   CmdsParse(CommandTable, Cmd);
 520   return 0;
 521 }
 522
 523 int CmdHelp(const char *Cmd)
 524 {
 525   CmdsHelp(CommandTable);
 526   return 0;
 527 }