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
);