1 //----------------------------------------------------------------------------- 
   2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>, Hagen Fritsch 
   3 // 2011, 2017 - 2019 Merlok 
   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 
   8 //----------------------------------------------------------------------------- 
   9 // High frequency ISO14443A commands 
  10 //----------------------------------------------------------------------------- 
  21 #include "util_posix.h" 
  22 #include "iso14443crc.h" 
  25 #include "cmdparser.h" 
  30 #include "mifare/mifarehost.h" 
  31 #include "cliparser/cliparser.h" 
  32 #include "emv/apduinfo.h" 
  33 #include "emv/emvcore.h" 
  36 static int CmdHelp(const char *Cmd
); 
  37 static int waitCmd(uint8_t iLen
); 
  39 // iso14a apdu input frame length 
  40 static uint16_t frameLength 
= 0; 
  41 uint16_t atsFSC
[] = {16, 24, 32, 40, 48, 64, 96, 128, 256}; 
  43 int CmdHF14AList(const char *Cmd
) 
  45         PrintAndLog("Deprecated command, use 'hf list 14a' instead"); 
  49 int Hf14443_4aGetCardData(iso14a_card_select_t 
* card
) { 
  50         UsbCommand c 
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT
, 0, 0}}; 
  54         WaitForResponse(CMD_ACK
,&resp
); 
  56         memcpy(card
, (iso14a_card_select_t 
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
)); 
  58         uint64_t select_status 
= resp
.arg
[0];       // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision 
  60         if(select_status 
== 0) { 
  61                 PrintAndLog("E->iso14443a card select failed"); 
  65         if(select_status 
== 2) { 
  66                 PrintAndLog("E->Card doesn't support iso14443-4 mode"); 
  70         if(select_status 
== 3) { 
  71                 PrintAndLog("E->Card doesn't support standard iso14443-3 anticollision"); 
  72                 PrintAndLog("\tATQA : %02x %02x", card
->atqa
[1], card
->atqa
[0]); 
  76         PrintAndLog(" UID: %s", sprint_hex(card
->uid
, card
->uidlen
)); 
  77         PrintAndLog("ATQA: %02x %02x", card
->atqa
[1], card
->atqa
[0]); 
  78         PrintAndLog(" SAK: %02x [%" PRIu64 
"]", card
->sak
, resp
.arg
[0]); 
  79         if(card
->ats_len 
< 3) {         // a valid ATS consists of at least the length byte (TL) and 2 CRC bytes 
  80                 PrintAndLog("E-> Error ATS length(%d) : %s", card
->ats_len
, sprint_hex(card
->ats
, card
->ats_len
)); 
  83         PrintAndLog(" ATS: %s", sprint_hex(card
->ats
, card
->ats_len
)); 
  88 int CmdHF14AReader(const char *Cmd
) { 
  89         uint32_t cm 
= ISO14A_CONNECT
; 
  90         bool leaveSignalON 
= false; 
  92         CLIParserInit("hf 14a reader", "Executes ISO1443A anticollision-select group of commands.", NULL
); 
  95                 arg_lit0("kK",  "keep",    "keep the field active after command executed"), 
  96                 arg_lit0("xX",  "drop",    "just drop the signal field"), 
  97                 arg_lit0("3",   NULL
,      "ISO14443-3 select only (skip RATS)"), 
 100         if (CLIParserParseString(Cmd
, argtable
, arg_getsize(argtable
), true)){ 
 105         leaveSignalON 
= arg_get_lit(1); 
 106         if (arg_get_lit(2)) { 
 107                 cm 
= cm 
- ISO14A_CONNECT
; 
 109         if (arg_get_lit(3)) { 
 110                 cm 
|= ISO14A_NO_RATS
; 
 116                 cm 
|= ISO14A_NO_DISCONNECT
; 
 118         UsbCommand c 
= {CMD_READER_ISO_14443a
, {cm
, 0, 0}}; 
 121         if (ISO14A_CONNECT 
& cm
) { 
 123                 WaitForResponse(CMD_ACK
,&resp
); 
 125                 iso14a_card_select_t card
; 
 126                 memcpy(&card
, (iso14a_card_select_t 
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
)); 
 128                 uint64_t select_status 
= resp
.arg
[0];       // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision 
 130                 if(select_status 
== 0) { 
 131                         PrintAndLog("iso14443a card select failed"); 
 135                 if(select_status 
== 3) { 
 136                         PrintAndLog("Card doesn't support standard iso14443-3 anticollision"); 
 137                         PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]); 
 141                 PrintAndLog(" UID : %s", sprint_hex(card
.uid
, card
.uidlen
)); 
 142                 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]); 
 143                 PrintAndLog(" SAK : %02x [%" PRIu64 
"]", card
.sak
, resp
.arg
[0]); 
 144                 if(card
.ats_len 
>= 3) {         // a valid ATS consists of at least the length byte (TL) and 2 CRC bytes 
 145                         PrintAndLog(" ATS : %s", sprint_hex(card
.ats
, card
.ats_len
)); 
 148                         PrintAndLog("Card is selected. You can now start sending commands"); 
 152         if (!leaveSignalON
) { 
 153                 PrintAndLog("Field dropped."); 
 159 int CmdHF14AInfo(const char *Cmd
) 
 161         UsbCommand c 
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT 
| ISO14A_NO_DISCONNECT
, 0, 0}}; 
 165         WaitForResponse(CMD_ACK
,&resp
); 
 167         iso14a_card_select_t card
; 
 168         memcpy(&card
, (iso14a_card_select_t 
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
)); 
 170         uint64_t select_status 
= resp
.arg
[0];       // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision 
 172         if(select_status 
== 0) { 
 173                 if (Cmd
[0] != 's') PrintAndLog("iso14443a card select failed"); 
 182         if(select_status 
== 3) { 
 183                 PrintAndLog("Card doesn't support standard iso14443-3 anticollision"); 
 184                 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]); 
 193         PrintAndLog(" UID : %s", sprint_hex(card
.uid
, card
.uidlen
)); 
 194         PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]); 
 195         PrintAndLog(" SAK : %02x [%" PRIu64 
"]", card
.sak
, resp
.arg
[0]); 
 197         bool isMifareClassic 
= true; 
 200                         isMifareClassic 
= false; 
 202                         //***************************************test**************** 
 209                         uint32_t tagT 
= GetHF14AMfU_Type(); 
 210                         ul_print_type(tagT
, 0); 
 212                         //reconnect for further tests 
 213                         c
.arg
[0] = ISO14A_CONNECT 
| ISO14A_NO_DISCONNECT
; 
 220                         WaitForResponse(CMD_ACK
,&resp
); 
 222                         memcpy(&card
, (iso14a_card_select_t 
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
)); 
 224                         select_status 
= resp
.arg
[0];        // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS 
 226                         if(select_status 
== 0) { 
 227                                 //PrintAndLog("iso14443a card select failed"); 
 237                         // check if the tag answers to GETVERSION (0x60) 
 238                         c.arg[0] = ISO14A_RAW | ISO14A_APPEND_CRC | ISO14A_NO_DISCONNECT; 
 241                         c.d.asBytes[0] = 0x60; 
 243                         WaitForResponse(CMD_ACK,&resp); 
 245                         uint8_t version[10] = {0}; 
 246                         memcpy(version, resp.d.asBytes, resp.arg[0] < sizeof(version) ? resp.arg[0] : sizeof(version)); 
 247                         uint8_t len = resp.arg[0] & 0xff; 
 249                                 // todo, identify "Magic UL-C tags". // they usually have a static nonce response to 0x1A command. 
 250                                 // UL-EV1, size, check version[6] == 0x0b (smaller)  0x0b * 4 == 48 
 251                                 case 0x0A:PrintAndLog("TYPE : NXP MIFARE Ultralight EV1 %d bytes", (version[6] == 0xB) ? 48 : 128);break; 
 252                                 case 0x01:PrintAndLog("TYPE : NXP MIFARE Ultralight C");break; 
 253                                 case 0x00:PrintAndLog("TYPE : NXP MIFARE Ultralight");break; 
 257                 case 0x01: PrintAndLog("TYPE : NXP TNP3xxx Activision Game Appliance"); break; 
 258                 case 0x04: PrintAndLog("TYPE : NXP MIFARE (various !DESFire !DESFire EV1)"); break; 
 259                 case 0x08: PrintAndLog("TYPE : NXP MIFARE CLASSIC 1k | Plus 2k SL1"); break; 
 260                 case 0x09: PrintAndLog("TYPE : NXP MIFARE Mini 0.3k"); break; 
 261                 case 0x10: PrintAndLog("TYPE : NXP MIFARE Plus 2k SL2"); break; 
 262                 case 0x11: PrintAndLog("TYPE : NXP MIFARE Plus 4k SL2"); break; 
 263                 case 0x18: PrintAndLog("TYPE : NXP MIFARE Classic 4k | Plus 4k SL1"); break; 
 264                 case 0x20: PrintAndLog("TYPE : NXP MIFARE DESFire 4k | DESFire EV1 2k/4k/8k | Plus 2k/4k SL3 | JCOP 31/41"); break; 
 265                 case 0x24: PrintAndLog("TYPE : NXP MIFARE DESFire | DESFire EV1"); break; 
 266                 case 0x28: PrintAndLog("TYPE : JCOP31 or JCOP41 v2.3.1"); break; 
 267                 case 0x38: PrintAndLog("TYPE : Nokia 6212 or 6131 MIFARE CLASSIC 4K"); break; 
 268                 case 0x88: PrintAndLog("TYPE : Infineon MIFARE CLASSIC 1K"); break; 
 269                 case 0x98: PrintAndLog("TYPE : Gemplus MPCOS"); break; 
 273         // Double & triple sized UID, can be mapped to a manufacturer. 
 274         // HACK: does this apply for Ultralight cards? 
 275         if ( card
.uidlen 
> 4 ) { 
 276                 PrintAndLog("MANUFACTURER : %s", getManufacturerName(card
.uid
[0])); 
 279         // try to request ATS even if tag claims not to support it 
 280         if (select_status 
== 2) { 
 281                 uint8_t rats
[] = { 0xE0, 0x80 }; // FSDI=8 (FSD=256), CID=0 
 282                 c
.arg
[0] = ISO14A_RAW 
| ISO14A_APPEND_CRC 
| ISO14A_NO_DISCONNECT
; 
 285                 memcpy(c
.d
.asBytes
, rats
, 2); 
 287                 WaitForResponse(CMD_ACK
,&resp
); 
 289                 memcpy(card
.ats
, resp
.d
.asBytes
, resp
.arg
[0]); 
 290                 card
.ats_len 
= resp
.arg
[0];             // note: ats_len includes CRC Bytes 
 293         if(card
.ats_len 
>= 3) {         // a valid ATS consists of at least the length byte (TL) and 2 CRC bytes 
 294                 bool ta1 
= 0, tb1 
= 0, tc1 
= 0; 
 297                 if (select_status 
== 2) { 
 298                         PrintAndLog("SAK incorrectly claims that card doesn't support RATS"); 
 300                 PrintAndLog(" ATS : %s", sprint_hex(card
.ats
, card
.ats_len
)); 
 301                 PrintAndLog("       -  TL : length is %d bytes", card
.ats
[0]); 
 302                 if (card
.ats
[0] != card
.ats_len 
- 2) { 
 303                         PrintAndLog("ATS may be corrupted. Length of ATS (%d bytes incl. 2 Bytes CRC) doesn't match TL", card
.ats_len
); 
 306                 if (card
.ats
[0] > 1) {      // there is a format byte (T0) 
 307                         ta1 
= (card
.ats
[1] & 0x10) == 0x10; 
 308                         tb1 
= (card
.ats
[1] & 0x20) == 0x20; 
 309                         tc1 
= (card
.ats
[1] & 0x40) == 0x40; 
 310                         int16_t fsci 
= card
.ats
[1] & 0x0f; 
 311                         PrintAndLog("       -  T0 : TA1 is%s present, TB1 is%s present, " 
 312                                         "TC1 is%s present, FSCI is %d (FSC = %ld)", 
 313                                 (ta1 
? "" : " NOT"), (tb1 
? "" : " NOT"), (tc1 
? "" : " NOT"), 
 315                                 fsci 
< sizeof(atsFSC
) ? atsFSC
[fsci
] : -1 
 321                         dr
[0] = ds
[0] = '\0'; 
 322                         if (card
.ats
[pos
] & 0x10) strcat(ds
, "2, "); 
 323                         if (card
.ats
[pos
] & 0x20) strcat(ds
, "4, "); 
 324                         if (card
.ats
[pos
] & 0x40) strcat(ds
, "8, "); 
 325                         if (card
.ats
[pos
] & 0x01) strcat(dr
, "2, "); 
 326                         if (card
.ats
[pos
] & 0x02) strcat(dr
, "4, "); 
 327                         if (card
.ats
[pos
] & 0x04) strcat(dr
, "8, "); 
 328                         if (strlen(ds
) != 0) ds
[strlen(ds
) - 2] = '\0'; 
 329                         if (strlen(dr
) != 0) dr
[strlen(dr
) - 2] = '\0'; 
 330                         PrintAndLog("       - TA1 : different divisors are%s supported, " 
 331                                         "DR: [%s], DS: [%s]", 
 332                                         (card
.ats
[pos
] & 0x80 ? " NOT" : ""), dr
, ds
); 
 336                         uint32_t sfgi 
= card
.ats
[pos
] & 0x0F; 
 337                         uint32_t fwi 
= card
.ats
[pos
] >> 4; 
 338                         PrintAndLog("       - TB1 : SFGI = %d (SFGT = %s%ld/fc), FWI = %d (FWT = %ld/fc)", 
 340                                         sfgi 
? "" : "(not needed) ", 
 341                                         sfgi 
? (1 << 12) << sfgi 
: 0, 
 348                         PrintAndLog("       - TC1 : NAD is%s supported, CID is%s supported", 
 349                                         (card
.ats
[pos
] & 0x01) ? "" : " NOT", 
 350                                         (card
.ats
[pos
] & 0x02) ? "" : " NOT"); 
 353                 if (card
.ats
[0] > pos
) { 
 355                         if (card
.ats
[0] - pos 
>= 7) { 
 356                                 if (memcmp(card
.ats 
+ pos
, "\xC1\x05\x2F\x2F\x01\xBC\xD6", 7) == 0) { 
 357                                         tip 
= "-> MIFARE Plus X 2K or 4K"; 
 358                                 } else if (memcmp(card
.ats 
+ pos
, "\xC1\x05\x2F\x2F\x00\x35\xC7", 7) == 0) { 
 359                                         tip 
= "-> MIFARE Plus S 2K or 4K"; 
 362                         PrintAndLog("       -  HB : %s%s", sprint_hex(card
.ats 
+ pos
, card
.ats
[0] - pos
), tip
); 
 363                         if (card
.ats
[pos
] == 0xC1) { 
 364                                 PrintAndLog("               c1 -> Mifare or (multiple) virtual cards of various type"); 
 365                                 PrintAndLog("                  %02x -> Length is %d bytes", 
 366                                                 card
.ats
[pos 
+ 1], card
.ats
[pos 
+ 1]); 
 367                                 switch (card
.ats
[pos 
+ 2] & 0xf0) { 
 369                                                 PrintAndLog("                     1x -> MIFARE DESFire"); 
 372                                                 PrintAndLog("                     2x -> MIFARE Plus"); 
 375                                 switch (card
.ats
[pos 
+ 2] & 0x0f) { 
 377                                                 PrintAndLog("                     x0 -> <1 kByte"); 
 380                                                 PrintAndLog("                     x1 -> 1 kByte"); 
 383                                                 PrintAndLog("                     x2 -> 2 kByte"); 
 386                                                 PrintAndLog("                     x3 -> 4 kByte"); 
 389                                                 PrintAndLog("                     x4 -> 8 kByte"); 
 392                                 switch (card
.ats
[pos 
+ 3] & 0xf0) { 
 394                                                 PrintAndLog("                        0x -> Engineering sample"); 
 397                                                 PrintAndLog("                        2x -> Released"); 
 400                                 switch (card
.ats
[pos 
+ 3] & 0x0f) { 
 402                                                 PrintAndLog("                        x0 -> Generation 1"); 
 405                                                 PrintAndLog("                        x1 -> Generation 2"); 
 408                                                 PrintAndLog("                        x2 -> Generation 3"); 
 411                                 switch (card
.ats
[pos 
+ 4] & 0x0f) { 
 413                                                 PrintAndLog("                           x0 -> Only VCSL supported"); 
 416                                                 PrintAndLog("                           x1 -> VCS, VCSL, and SVC supported"); 
 419                                                 PrintAndLog("                           xE -> no VCS command supported"); 
 425                 PrintAndLog("proprietary non iso14443-4 card found, RATS not supported"); 
 429         // try to see if card responses to "chinese magic backdoor" commands. 
 432         if (isMifareClassic
) { 
 433                 switch(DetectClassicPrng()) { 
 435                         PrintAndLog("Prng detection: HARDENED (hardnested)"); 
 438                         PrintAndLog("Prng detection: WEAK"); 
 441                         PrintAndLog("Prng detection error."); 
 445         return select_status
; 
 448 // Collect ISO14443 Type A UIDs 
 449 int CmdHF14ACUIDs(const char *Cmd
) 
 451         // requested number of UIDs 
 453         // collect at least 1 (e.g. if no parameter was given) 
 456         PrintAndLog("Collecting %d UIDs", n
); 
 457         PrintAndLog("Start: %" PRIu64
, msclock()/1000); 
 459         for (int i 
= 0; i 
< n
; i
++) { 
 460                 // execute anticollision procedure 
 461                 UsbCommand c 
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT 
| ISO14A_NO_RATS
, 0, 0}}; 
 465                 WaitForResponse(CMD_ACK
,&resp
); 
 467                 iso14a_card_select_t 
*card 
= (iso14a_card_select_t 
*) resp
.d
.asBytes
; 
 469                 // check if command failed 
 470                 if (resp
.arg
[0] == 0) { 
 471                         PrintAndLog("Card select failed."); 
 474                         for (uint16_t i 
= 0; i 
< card
->uidlen
; i
++) { 
 475                                 sprintf(&uid_string
[2*i
], "%02X", card
->uid
[i
]); 
 477                         PrintAndLog("%s", uid_string
); 
 480         PrintAndLog("End: %" PRIu64
, msclock()/1000); 
 485 // ## simulate iso14443a tag 
 486 // ## greg - added ability to specify tag UID 
 487 int CmdHF14ASim(const char *Cmd
) 
 489         UsbCommand c 
= {CMD_SIMULATE_TAG_ISO_14443a
,{0,0,0}}; 
 491         // Retrieve the tag type 
 492         uint8_t tagtype 
= param_get8ex(Cmd
,0,0,10); 
 494         // When no argument was given, just print help message 
 497                 PrintAndLog(" Emulating ISO/IEC 14443 type A tag with 4 or 7 byte UID"); 
 499                 PrintAndLog("   syntax: hf 14a sim <type> <uid>"); 
 500                 PrintAndLog("    types: 1 = MIFARE Classic"); 
 501                 PrintAndLog("           2 = MIFARE Ultralight"); 
 502                 PrintAndLog("           3 = MIFARE Desfire"); 
 503                 PrintAndLog("           4 = ISO/IEC 14443-4"); 
 504                 PrintAndLog("           5 = MIFARE Tnp3xxx"); 
 509         // Store the tag type 
 512         // Retrieve the full 4 or 7 byte long uid 
 513         uint64_t long_uid 
= param_get64ex(Cmd
,1,0,16); 
 515         // Are we handling the (optional) second part uid? 
 516         if (long_uid 
> 0xffffffff) { 
 517                 PrintAndLog("Emulating ISO/IEC 14443 type A tag with 7 byte UID (%014" PRIx64 
")",long_uid
); 
 518                 // Store the second part 
 519                 c
.arg
[2] = (long_uid 
& 0xffffffff); 
 521                 // Store the first part, ignore the first byte, it is replaced by cascade byte (0x88) 
 522                 c
.arg
[1] = (long_uid 
& 0xffffff); 
 524                 PrintAndLog("Emulating ISO/IEC 14443 type A tag with 4 byte UID (%08x)",long_uid
); 
 525                 // Only store the first part 
 526                 c
.arg
[1] = long_uid 
& 0xffffffff; 
 529                 // At lease save the mandatory first part of the UID 
 530                 c.arg[0] = long_uid & 0xffffffff; 
 533                 PrintAndLog("Emulating ISO/IEC 14443 type A tag with UID %01d %08x %08x",c.arg[0],c.arg[1],c.arg[2]); 
 538                         PrintAndLog("Emulating ISO/IEC 14443-3 type A tag with 4 byte UID"); 
 539                         UsbCommand c = {CMD_SIMULATE_TAG_ISO_14443a,param_get32ex(Cmd,0,0,10),param_get32ex(Cmd,1,0,16),param_get32ex(Cmd,2,0,16)}; 
 542                         PrintAndLog("Emulating ISO/IEC 14443-4 type A tag with 7 byte UID"); 
 545                         PrintAndLog("Error: unkown tag type (%d)",c.arg[0]); 
 546                         PrintAndLog("syntax: hf 14a sim <uid>",c.arg[0]); 
 547                         PrintAndLog(" type1: 4 ",c.arg[0]); 
 554   unsigned int hi = 0, lo = 0; 
 556   while (sscanf(&Cmd[i++], "%1x", &n ) == 1) { 
 557         hi= (hi << 4) | (lo >> 28); 
 558         lo= (lo << 4) | (n & 0xf); 
 561 //  UsbCommand c = {CMD_SIMULATE_TAG_ISO_14443a,param_get32ex(Cmd,0,0,10),param_get32ex(Cmd,1,0,16),param_get32ex(Cmd,2,0,16)}; 
 562 //  PrintAndLog("Emulating ISO/IEC 14443 type A tag with UID %01d %08x %08x",c.arg[0],c.arg[1],c.arg[2]); 
 568 int CmdHF14ASnoop(const char *Cmd
) { 
 571         uint8_t ctmp 
= param_getchar(Cmd
, 0) ; 
 572         if (ctmp 
== 'h' || ctmp 
== 'H') { 
 573                 PrintAndLog("It get data from the field and saves it into command buffer."); 
 574                 PrintAndLog("Buffer accessible from command hf list 14a."); 
 575                 PrintAndLog("Usage:  hf 14a snoop [c][r]"); 
 576                 PrintAndLog("c - triggered by first data from card"); 
 577                 PrintAndLog("r - triggered by first 7-bit request from reader (REQ,WUP,...)"); 
 578                 PrintAndLog("sample: hf 14a snoop c r"); 
 582         for (int i 
= 0; i 
< 2; i
++) { 
 583                 ctmp 
= param_getchar(Cmd
, i
); 
 584                 if (ctmp 
== 'c' || ctmp 
== 'C') param 
|= 0x01; 
 585                 if (ctmp 
== 'r' || ctmp 
== 'R') param 
|= 0x02; 
 588         UsbCommand c 
= {CMD_SNOOP_ISO_14443a
, {param
, 0, 0}}; 
 595         UsbCommand c 
= {CMD_READER_ISO_14443a
, {0, 0, 0}}; 
 600 int ExchangeRAW14a(uint8_t *datain
, int datainlen
, bool activateField
, bool leaveSignalON
, uint8_t *dataout
, int maxdataoutlen
, int *dataoutlen
) { 
 601         static bool responseNum 
= false; 
 609                 // Anticollision + SELECT card 
 610                 UsbCommand ca 
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT 
| ISO14A_NO_DISCONNECT 
| ISO14A_CLEAR_TRACE
, 0, 0}}; 
 612                 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 613                         PrintAndLog("14aRAW ERROR: Proxmark connection timeout."); 
 618                 if (resp
.arg
[0] == 0) { 
 619                         PrintAndLog("14aRAW ERROR: No card in field."); 
 623                 if (resp
.arg
[0] != 1 && resp
.arg
[0] != 2) { 
 624                         PrintAndLog("14aRAW ERROR: card not in iso14443-4. res=%d.", resp
.arg
[0]); 
 628                 if (resp
.arg
[0] == 2) {     // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision 
 630                         UsbCommand cr 
= {CMD_READER_ISO_14443a
, {ISO14A_RAW 
| ISO14A_APPEND_CRC 
| ISO14A_NO_DISCONNECT
, 2, 0}}; 
 631                         uint8_t rats
[] = { 0xE0, 0x80 }; // FSDI=8 (FSD=256), CID=0 
 632                         memcpy(cr
.d
.asBytes
, rats
, 2); 
 634                         if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 635                                 PrintAndLog("14aRAW ERROR: Proxmark connection timeout."); 
 639                         if (resp
.arg
[0] <= 0) { // ats_len 
 640                                 PrintAndLog("14aRAW ERROR: Can't get ATS."); 
 647                 cmdc 
|= ISO14A_NO_DISCONNECT
; 
 649         UsbCommand c 
= {CMD_READER_ISO_14443a
, {ISO14A_RAW 
| ISO14A_APPEND_CRC 
| cmdc
, (datainlen 
& 0xFFFF) + 2, 0}}; 
 650         uint8_t header
[] = {0x0a | responseNum
, 0x00}; 
 652         memcpy(c
.d
.asBytes
, header
, 2); 
 653         memcpy(&c
.d
.asBytes
[2], datain
, datainlen
); 
 659         if (WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 660                 recv 
= resp
.d
.asBytes
; 
 661                 int iLen 
= resp
.arg
[0]; 
 664                         PrintAndLog("14aRAW ERROR: No card response."); 
 668                 *dataoutlen 
= iLen 
- 2; 
 672                 if (maxdataoutlen 
&& *dataoutlen 
> maxdataoutlen
) { 
 673                         PrintAndLog("14aRAW ERROR: Buffer too small(%d). Needs %d bytes", *dataoutlen
, maxdataoutlen
); 
 677                 if (recv
[0] != header
[0]) { 
 678                         PrintAndLog("14aRAW ERROR: iso14443-4 framing error. Card send %2x must be %2x", dataout
[0], header
[0]); 
 682                 memcpy(dataout
, &recv
[2], *dataoutlen
); 
 686                         PrintAndLog("14aRAW ERROR: ISO 14443A CRC error."); 
 692                 PrintAndLog("14aRAW ERROR: Reply timeout."); 
 700 static int SelectCard14443_4(bool disconnect
, iso14a_card_select_t 
*card
) { 
 706                 memset(card
, 0, sizeof(iso14a_card_select_t
)); 
 710         // Anticollision + SELECT card 
 711         UsbCommand ca 
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT 
| ISO14A_NO_DISCONNECT
, 0, 0}}; 
 713         if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 714                 PrintAndLogEx(ERR
, "Proxmark connection timeout."); 
 719         if (resp
.arg
[0] == 0) { 
 720                 PrintAndLogEx(ERR
, "No card in field."); 
 724         if (resp
.arg
[0] != 1 && resp
.arg
[0] != 2) { 
 725                 PrintAndLogEx(ERR
, "Card not in iso14443-4. res=%d.", resp
.arg
[0]); 
 729         if (resp
.arg
[0] == 2) {     // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision 
 730                 // try to get ATS although SAK indicated that it is not ISO14443-4 compliant 
 731                 UsbCommand cr 
= {CMD_READER_ISO_14443a
, {ISO14A_RAW 
| ISO14A_APPEND_CRC 
| ISO14A_NO_DISCONNECT
, 2, 0}}; 
 732                 uint8_t rats
[] = { 0xE0, 0x80 }; // FSDI=8 (FSD=256), CID=0 
 733                 memcpy(cr
.d
.asBytes
, rats
, 2); 
 735                 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 736                         PrintAndLogEx(ERR
, "Proxmark connection timeout."); 
 740                 if (resp
.arg
[0] <= 0) { // ats_len 
 741                         PrintAndLogEx(ERR
, "Can't get ATS."); 
 746         // get frame length from ATS 
 747         iso14a_card_select_t 
*vcard 
= (iso14a_card_select_t 
*) resp
.d
.asBytes
; 
 748         if (vcard
->ats_len 
> 1) { 
 749                 uint8_t fsci 
= vcard
->ats
[1] & 0x0f; 
 750                 if (fsci 
< sizeof(atsFSC
)) 
 751                         frameLength 
= atsFSC
[fsci
]; 
 755                 memcpy(card
, vcard
, sizeof(iso14a_card_select_t
)); 
 766 static int ExchangeAPDU(bool chainingin
, uint8_t *datain
, int datainlen
, bool activateField
, uint8_t *dataout
, int maxdataoutlen
, int *dataoutlen
, bool *chainingout
) 
 768         *chainingout 
= false; 
 771                 // select with no disconnect and set frameLength 
 772                 int selres 
= SelectCard14443_4(false, NULL
); 
 779                 cmdc 
= ISO14A_SEND_CHAINING
; 
 781         // "Command APDU" length should be 5+255+1, but javacard's APDU buffer might be smaller - 133 bytes 
 782         // https://stackoverflow.com/questions/32994936/safe-max-java-card-apdu-data-command-and-respond-size 
 783         // here length USB_CMD_DATA_SIZE=512 
 784         // timeout must be authomatically set by "get ATS" 
 785         UsbCommand c 
= {CMD_READER_ISO_14443a
, {ISO14A_APDU 
| ISO14A_NO_DISCONNECT 
| cmdc
, (datainlen 
& 0xFFFF), 0}}; 
 786         memcpy(c
.d
.asBytes
, datain
, datainlen
); 
 792         if (WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) { 
 793                 recv 
= resp
.d
.asBytes
; 
 794                 int iLen 
= resp
.arg
[0]; 
 795                 uint8_t res 
= resp
.arg
[1]; 
 802                 if (maxdataoutlen 
&& *dataoutlen 
> maxdataoutlen
) { 
 803                         PrintAndLog("APDU ERROR: Buffer too small(%d). Needs %d bytes", *dataoutlen
, maxdataoutlen
); 
 808                 if ((res 
& 0xf2) == 0xa2) { 
 815                         PrintAndLog("APDU ERROR: No APDU response."); 
 820                 if (iLen 
< 2 && iLen 
>= 0) { 
 821                         PrintAndLog("APDU ERROR: Small APDU response. Len=%d", iLen
); 
 827                         PrintAndLog("APDU ERROR: Block type mismatch."); 
 831                 memcpy(dataout
, recv
, dlen
); 
 834                 if ((res 
& 0x10) != 0) { 
 840                         PrintAndLog("APDU ERROR: ISO 14443A CRC error."); 
 844                 PrintAndLog("APDU ERROR: Reply timeout."); 
 852 int ExchangeAPDU14a(uint8_t *datain
, int datainlen
, bool activateField
, bool leaveSignalON
, uint8_t *dataout
, int maxdataoutlen
, int *dataoutlen
) { 
 854         bool chaining 
= false; 
 857         // 3 byte here - 1b framing header, 2b crc16 
 858         if ( (frameLength 
&& (datainlen 
> frameLength 
- 3)) || (datainlen 
> USB_CMD_DATA_SIZE 
- 3) ) { 
 861                 bool vActivateField 
= activateField
; 
 864                         int vlen 
= MIN(frameLength 
- 3, datainlen 
- clen
); 
 865                         bool chainBlockNotLast 
= ((clen 
+ vlen
) < datainlen
); 
 868                         res 
= ExchangeAPDU(chainBlockNotLast
, &datain
[clen
], vlen
, vActivateField
, dataout
, maxdataoutlen
, dataoutlen
, &chaining
); 
 877                         if ((*dataoutlen 
== 0) && (*dataoutlen 
!= 0 || chaining 
!= chainBlockNotLast
)) { 
 885                         vActivateField 
= false; 
 887                                 if (clen 
!= datainlen
) 
 888                                         PrintAndLogEx(WARNING
, "APDU: I-block/R-block sequence error. Data len=%d, Sent=%d, Last packet len=%d", datainlen
, clen
, *dataoutlen
); 
 891                 } while (clen 
< datainlen
); 
 893                 res 
= ExchangeAPDU(false, datain
, datainlen
, activateField
, dataout
, maxdataoutlen
, dataoutlen
, &chaining
); 
 903                 // I-block with chaining 
 904                 res 
= ExchangeAPDU(false, NULL
, 0, false, &dataout
[*dataoutlen
], maxdataoutlen
, dataoutlen
, &chaining
); 
 920 // ISO14443-4. 7. Half-duplex block transmission protocol 
 921 int CmdHF14AAPDU(const char *cmd
) { 
 922         uint8_t data
[USB_CMD_DATA_SIZE
]; 
 924         bool activateField 
= false; 
 925         bool leaveSignalON 
= false; 
 926         bool decodeTLV 
= false; 
 928         CLIParserInit("hf 14a apdu", 
 929                 "Sends an ISO 7816-4 APDU via ISO 14443-4 block transmission protocol (T=CL)", 
 930                 "Sample:\n\thf 14a apdu -st 00A404000E325041592E5359532E444446303100\n"); 
 934                 arg_lit0("sS",  "select",  "activate field and select card"), 
 935                 arg_lit0("kK",  "keep",    "leave the signal field ON after receive response"), 
 936                 arg_lit0("tT",  "tlv",     "executes TLV decoder if it possible"), 
 937                 arg_strx1(NULL
, NULL
,      "<APDU (hex)>", NULL
), 
 940         CLIExecWithReturn(cmd
, argtable
, false); 
 942         activateField 
= arg_get_lit(1); 
 943         leaveSignalON 
= arg_get_lit(2); 
 944         decodeTLV 
= arg_get_lit(3); 
 945         // len = data + PCB(1b) + CRC(2b) 
 946         CLIGetHexBLessWithReturn(4, data
, &datalen
, 1 + 2); 
 950 //  PrintAndLog("---str [%d] %s", arg_get_str(4)->count, arg_get_str(4)->sval[0]); 
 951         PrintAndLog(">>>>[%s%s%s] %s", activateField 
? "sel ": "", leaveSignalON 
? "keep ": "", decodeTLV 
? "TLV": "", sprint_hex(data
, datalen
)); 
 953         int res 
= ExchangeAPDU14a(data
, datalen
, activateField
, leaveSignalON
, data
, USB_CMD_DATA_SIZE
, &datalen
); 
 958         PrintAndLog("<<<< %s", sprint_hex(data
, datalen
)); 
 960         PrintAndLog("APDU response: %02x %02x - %s", data
[datalen 
- 2], data
[datalen 
- 1], GetAPDUCodeDescription(data
[datalen 
- 2], data
[datalen 
- 1])); 
 963         if (decodeTLV 
&& datalen 
> 4) { 
 964                 TLVPrintFromBuffer(data
, datalen 
- 2); 
 970 int CmdHF14ACmdRaw(const char *cmd
) { 
 971         UsbCommand c 
= {CMD_READER_ISO_14443a
, {0, 0, 0}}; 
 976         bool active_select 
= false; 
 977         bool no_rats 
= false; 
 978         uint16_t numbits 
= 0; 
 979         bool bTimeout 
= false; 
 980         uint32_t timeout 
= 0; 
 981         bool topazmode 
= false; 
 982         uint8_t data
[USB_CMD_DATA_SIZE
]; 
 985         // extract parameters 
 986         CLIParserInit("hf 14a raw", "Send raw hex data to tag", 
 988                 "\thf 14a raw -pa -b7 -t1000 52  -- execute WUPA\n"\
 
 989                 "\thf 14a raw -p 9320            -- anticollision\n"\
 
 990                 "\thf 14a raw -psc 60 00         -- select and mifare AUTH\n"); 
 993                 arg_lit0("rR",  "nreply",  "do not read response"), 
 994                 arg_lit0("cC",  "crc",     "calculate and append CRC"), 
 995                 arg_lit0("pP",  "power",   "leave the signal field ON after receive"), 
 996                 arg_lit0("aA",  "active",  "active signal field ON without select"), 
 997                 arg_lit0("sS",  "actives", "active signal field ON with select"), 
 998                 arg_int0("bB",  "bits",    NULL
, "number of bits to send. Useful for send partial byte"), 
 999                 arg_int0("t",   "timeout", NULL
, "timeout in ms"), 
1000                 arg_lit0("T",   "topaz",   "use Topaz protocol to send command"), 
1001                 arg_lit0("3",   NULL
,      "ISO14443-3 select only (skip RATS)"), 
1002                 arg_strx1(NULL
, NULL
,      "<data (hex)>", NULL
), 
1009         if (CLIParserParseString(cmd
, argtable
, arg_getsize(argtable
), false)){ 
1014         reply 
= !arg_get_lit(1); 
1015         crc 
= arg_get_lit(2); 
1016         power 
= arg_get_lit(3); 
1017         active 
= arg_get_lit(4); 
1018         active_select 
= arg_get_lit(5); 
1019         numbits 
= arg_get_int(6) & 0xFFFF; 
1020         timeout 
= arg_get_int(7); 
1021         bTimeout 
= (timeout 
> 0); 
1022         topazmode 
= arg_get_lit(8); 
1023         no_rats 
= arg_get_lit(9); 
1024         // len = data + CRC(2b) 
1025         if (CLIParamHexToBuf(arg_get_str(10), data
, sizeof(data
) -2, &datalen
)) { 
1033         if(crc 
&& datalen
>0 && datalen
<sizeof(data
)-2) 
1035                 uint8_t first
, second
; 
1037                         ComputeCrc14443(CRC_14443_B
, data
, datalen
, &first
, &second
); 
1039                         ComputeCrc14443(CRC_14443_A
, data
, datalen
, &first
, &second
); 
1041                 data
[datalen
++] = first
; 
1042                 data
[datalen
++] = second
; 
1045         if(active 
|| active_select
) 
1047                 c
.arg
[0] |= ISO14A_CONNECT 
| ISO14A_CLEAR_TRACE
; 
1049                         c
.arg
[0] |= ISO14A_NO_SELECT
; 
1053                 #define MAX_TIMEOUT 40542464    // = (2^32-1) * (8*16) / 13560000Hz * 1000ms/s 
1054                 c
.arg
[0] |= ISO14A_SET_TIMEOUT
; 
1055                 if(timeout 
> MAX_TIMEOUT
) { 
1056                         timeout 
= MAX_TIMEOUT
; 
1057                         PrintAndLog("Set timeout to 40542 seconds (11.26 hours). The max we can wait for response"); 
1059                 c
.arg
[2] = 13560000 / 1000 / (8*16) * timeout
; // timeout in ETUs (time to transfer 1 bit, approx. 9.4 us) 
1063                 c
.arg
[0] |= ISO14A_NO_DISCONNECT
; 
1067                 c
.arg
[0] |= ISO14A_RAW
; 
1071                 c
.arg
[0] |= ISO14A_TOPAZMODE
; 
1075                 c
.arg
[0] |= ISO14A_NO_RATS
; 
1078         // Max buffer is USB_CMD_DATA_SIZE (512) 
1079         c
.arg
[1] = (datalen 
& 0xFFFF) | ((uint32_t)numbits 
<< 16); 
1080         memcpy(c
.d
.asBytes
,data
,datalen
); 
1088                 if (!res 
&& datalen 
> 0) 
1095 static int waitCmd(uint8_t iSelect
) { 
1100         if (WaitForResponseTimeout(CMD_ACK
,&resp
,1500)) { 
1101                 recv 
= resp
.d
.asBytes
; 
1102                 uint8_t iLen 
= resp
.arg
[0]; 
1106                                 PrintAndLog("Card selected. UID[%i]:", iLen
); 
1108                                 PrintAndLog("Can't select card."); 
1111                         PrintAndLog("received %i bytes:", iLen
); 
1115                 hexout 
= (char *)malloc(iLen 
* 3 + 1); 
1116                 if (hexout 
!= NULL
) { 
1117                         for (int i 
= 0; i 
< iLen
; i
++) { // data in hex 
1118                                 sprintf(&hexout
[i 
* 3], "%02X ", recv
[i
]); 
1120                         PrintAndLog("%s", hexout
); 
1123                         PrintAndLog("malloc failed your client has low memory?"); 
1127                 PrintAndLog("timeout while waiting for reply."); 
1133 static command_t CommandTable
[] = 
1135         {"help",     CmdHelp
,              1, "This help"}, 
1136         {"list",     CmdHF14AList
,         0, "[Deprecated] List ISO 14443a history"}, 
1137         {"reader",   CmdHF14AReader
,       0, "Start acting like an ISO14443 Type A reader"}, 
1138         {"info",     CmdHF14AInfo
,         0, "Reads card and shows information about it"}, 
1139         {"cuids",    CmdHF14ACUIDs
,        0, "<n> Collect n>0 ISO14443 Type A UIDs in one go"}, 
1140         {"sim",      CmdHF14ASim
,          0, "<UID> -- Simulate ISO 14443a tag"}, 
1141         {"snoop",    CmdHF14ASnoop
,        0, "Eavesdrop ISO 14443 Type A"}, 
1142         {"apdu",     CmdHF14AAPDU
,         0, "Send an ISO 7816-4 APDU via ISO 14443-4 block transmission protocol"}, 
1143         {"raw",      CmdHF14ACmdRaw
,       0, "Send raw hex data to tag"}, 
1144         {NULL
,       NULL
,                 0, NULL
} 
1147 int CmdHF14A(const char *Cmd
) { 
1148         (void)WaitForResponseTimeout(CMD_ACK
,NULL
,100); 
1149         CmdsParse(CommandTable
, Cmd
); 
1153 int CmdHelp(const char *Cmd
) 
1155   CmdsHelp(CommandTable
);