1 //-----------------------------------------------------------------------------
3 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>, Hagen Fritsch
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 "mifarehost.h"
31 #include "cliparser/cliparser.h"
32 #include "emv/apduinfo.h"
33 #include "emv/emvcore.h"
35 static int CmdHelp(const char *Cmd
);
36 static int waitCmd(uint8_t iLen
);
38 // structure and database for uid -> tagtype lookups
44 static const manufactureName manufactureMapping
[] = {
45 // ID, "Vendor Country"
46 { 0x01, "Motorola UK" },
47 { 0x02, "ST Microelectronics SA France" },
48 { 0x03, "Hitachi, Ltd Japan" },
49 { 0x04, "NXP Semiconductors Germany" },
50 { 0x05, "Infineon Technologies AG Germany" },
51 { 0x06, "Cylink USA" },
52 { 0x07, "Texas Instrument France" },
53 { 0x08, "Fujitsu Limited Japan" },
54 { 0x09, "Matsushita Electronics Corporation, Semiconductor Company Japan" },
55 { 0x0A, "NEC Japan" },
56 { 0x0B, "Oki Electric Industry Co. Ltd Japan" },
57 { 0x0C, "Toshiba Corp. Japan" },
58 { 0x0D, "Mitsubishi Electric Corp. Japan" },
59 { 0x0E, "Samsung Electronics Co. Ltd Korea" },
60 { 0x0F, "Hynix / Hyundai, Korea" },
61 { 0x10, "LG-Semiconductors Co. Ltd Korea" },
62 { 0x11, "Emosyn-EM Microelectronics USA" },
63 { 0x12, "INSIDE Technology France" },
64 { 0x13, "ORGA Kartensysteme GmbH Germany" },
65 { 0x14, "SHARP Corporation Japan" },
66 { 0x15, "ATMEL France" },
67 { 0x16, "EM Microelectronic-Marin SA Switzerland" },
68 { 0x17, "KSW Microtec GmbH Germany" },
69 { 0x18, "ZMD AG Germany" },
70 { 0x19, "XICOR, Inc. USA" },
71 { 0x1A, "Sony Corporation Japan Identifier Company Country" },
72 { 0x1B, "Malaysia Microelectronic Solutions Sdn. Bhd Malaysia" },
73 { 0x1C, "Emosyn USA" },
74 { 0x1D, "Shanghai Fudan Microelectronics Co. Ltd. P.R. China" },
75 { 0x1E, "Magellan Technology Pty Limited Australia" },
76 { 0x1F, "Melexis NV BO Switzerland" },
77 { 0x20, "Renesas Technology Corp. Japan" },
78 { 0x21, "TAGSYS France" },
79 { 0x22, "Transcore USA" },
80 { 0x23, "Shanghai belling corp., ltd. China" },
81 { 0x24, "Masktech Germany Gmbh Germany" },
82 { 0x25, "Innovision Research and Technology Plc UK" },
83 { 0x26, "Hitachi ULSI Systems Co., Ltd. Japan" },
84 { 0x27, "Cypak AB Sweden" },
85 { 0x28, "Ricoh Japan" },
86 { 0x29, "ASK France" },
87 { 0x2A, "Unicore Microsystems, LLC Russian Federation" },
88 { 0x2B, "Dallas Semiconductor/Maxim USA" },
89 { 0x2C, "Impinj, Inc. USA" },
90 { 0x2D, "RightPlug Alliance USA" },
91 { 0x2E, "Broadcom Corporation USA" },
92 { 0x2F, "MStar Semiconductor, Inc Taiwan, ROC" },
93 { 0x30, "BeeDar Technology Inc. USA" },
94 { 0x31, "RFIDsec Denmark" },
95 { 0x32, "Schweizer Electronic AG Germany" },
96 { 0x33, "AMIC Technology Corp Taiwan" },
97 { 0x34, "Mikron JSC Russia" },
98 { 0x35, "Fraunhofer Institute for Photonic Microsystems Germany" },
99 { 0x36, "IDS Microchip AG Switzerland" },
100 { 0x37, "Kovio USA" },
101 { 0x38, "HMT Microelectronic Ltd Switzerland Identifier Company Country" },
102 { 0x39, "Silicon Craft Technology Thailand" },
103 { 0x3A, "Advanced Film Device Inc. Japan" },
104 { 0x3B, "Nitecrest Ltd UK" },
105 { 0x3C, "Verayo Inc. USA" },
106 { 0x3D, "HID Global USA" },
107 { 0x3E, "Productivity Engineering Gmbh Germany" },
108 { 0x3F, "Austriamicrosystems AG (reserved) Austria" },
109 { 0x40, "Gemalto SA France" },
110 { 0x41, "Renesas Electronics Corporation Japan" },
111 { 0x42, "3Alogics Inc Korea" },
112 { 0x43, "Top TroniQ Asia Limited Hong Kong" },
113 { 0x44, "Gentag Inc (USA) USA" },
114 { 0x00, "no tag-info available" } // must be the last entry
117 // get a product description based on the UID
119 // returns description of the best match
120 char* getTagInfo(uint8_t uid
) {
123 int len
= sizeof(manufactureMapping
) / sizeof(manufactureName
);
125 for ( i
= 0; i
< len
; ++i
)
126 if ( uid
== manufactureMapping
[i
].uid
)
127 return manufactureMapping
[i
].desc
;
129 //No match, return default
130 return manufactureMapping
[len
-1].desc
;
133 int CmdHF14AList(const char *Cmd
)
135 PrintAndLog("Deprecated command, use 'hf list 14a' instead");
139 int CmdHF14AReader(const char *Cmd
) {
140 uint32_t cm
= ISO14A_CONNECT
;
141 bool leaveSignalON
= false;
143 CLIParserInit("hf 14a reader", "Executes ISO1443A anticollision-select group of commands.", NULL
);
146 arg_lit0("kK", "keep", "keep the field active after command executed"),
147 arg_lit0("xX", "drop", "just drop the signal field"),
148 arg_lit0("3", NULL
, "ISO14443-3 select only (skip RATS)"),
151 if (CLIParserParseString(Cmd
, argtable
, arg_getsize(argtable
), true)){
156 leaveSignalON
= arg_get_lit(1);
157 if (arg_get_lit(2)) {
158 cm
= cm
- ISO14A_CONNECT
;
160 if (arg_get_lit(3)) {
161 cm
|= ISO14A_NO_RATS
;
167 cm
|= ISO14A_NO_DISCONNECT
;
169 UsbCommand c
= {CMD_READER_ISO_14443a
, {cm
, 0, 0}};
172 if (ISO14A_CONNECT
& cm
) {
174 WaitForResponse(CMD_ACK
,&resp
);
176 iso14a_card_select_t card
;
177 memcpy(&card
, (iso14a_card_select_t
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
));
179 uint64_t select_status
= resp
.arg
[0]; // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision
181 if(select_status
== 0) {
182 PrintAndLog("iso14443a card select failed");
186 if(select_status
== 3) {
187 PrintAndLog("Card doesn't support standard iso14443-3 anticollision");
188 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]);
192 PrintAndLog(" UID : %s", sprint_hex(card
.uid
, card
.uidlen
));
193 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]);
194 PrintAndLog(" SAK : %02x [%" PRIu64
"]", card
.sak
, resp
.arg
[0]);
195 if(card
.ats_len
>= 3) { // a valid ATS consists of at least the length byte (TL) and 2 CRC bytes
196 PrintAndLog(" ATS : %s", sprint_hex(card
.ats
, card
.ats_len
));
199 PrintAndLog("Card is selected. You can now start sending commands");
203 if (!leaveSignalON
) {
204 PrintAndLog("Field dropped.");
210 int CmdHF14AInfo(const char *Cmd
)
212 UsbCommand c
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT
| ISO14A_NO_DISCONNECT
, 0, 0}};
216 WaitForResponse(CMD_ACK
,&resp
);
218 iso14a_card_select_t card
;
219 memcpy(&card
, (iso14a_card_select_t
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
));
221 uint64_t select_status
= resp
.arg
[0]; // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS, 3: proprietary Anticollision
223 if(select_status
== 0) {
224 if (Cmd
[0] != 's') PrintAndLog("iso14443a card select failed");
233 if(select_status
== 3) {
234 PrintAndLog("Card doesn't support standard iso14443-3 anticollision");
235 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]);
244 PrintAndLog(" UID : %s", sprint_hex(card
.uid
, card
.uidlen
));
245 PrintAndLog("ATQA : %02x %02x", card
.atqa
[1], card
.atqa
[0]);
246 PrintAndLog(" SAK : %02x [%" PRIu64
"]", card
.sak
, resp
.arg
[0]);
248 bool isMifareClassic
= true;
251 isMifareClassic
= false;
253 //***************************************test****************
260 uint32_t tagT
= GetHF14AMfU_Type();
261 ul_print_type(tagT
, 0);
263 //reconnect for further tests
264 c
.arg
[0] = ISO14A_CONNECT
| ISO14A_NO_DISCONNECT
;
271 WaitForResponse(CMD_ACK
,&resp
);
273 memcpy(&card
, (iso14a_card_select_t
*)resp
.d
.asBytes
, sizeof(iso14a_card_select_t
));
275 select_status
= resp
.arg
[0]; // 0: couldn't read, 1: OK, with ATS, 2: OK, no ATS
277 if(select_status
== 0) {
278 //PrintAndLog("iso14443a card select failed");
288 // check if the tag answers to GETVERSION (0x60)
289 c.arg[0] = ISO14A_RAW | ISO14A_APPEND_CRC | ISO14A_NO_DISCONNECT;
292 c.d.asBytes[0] = 0x60;
294 WaitForResponse(CMD_ACK,&resp);
296 uint8_t version[10] = {0};
297 memcpy(version, resp.d.asBytes, resp.arg[0] < sizeof(version) ? resp.arg[0] : sizeof(version));
298 uint8_t len = resp.arg[0] & 0xff;
300 // todo, identify "Magic UL-C tags". // they usually have a static nonce response to 0x1A command.
301 // UL-EV1, size, check version[6] == 0x0b (smaller) 0x0b * 4 == 48
302 case 0x0A:PrintAndLog("TYPE : NXP MIFARE Ultralight EV1 %d bytes", (version[6] == 0xB) ? 48 : 128);break;
303 case 0x01:PrintAndLog("TYPE : NXP MIFARE Ultralight C");break;
304 case 0x00:PrintAndLog("TYPE : NXP MIFARE Ultralight");break;
308 case 0x01: PrintAndLog("TYPE : NXP TNP3xxx Activision Game Appliance"); break;
309 case 0x04: PrintAndLog("TYPE : NXP MIFARE (various !DESFire !DESFire EV1)"); break;
310 case 0x08: PrintAndLog("TYPE : NXP MIFARE CLASSIC 1k | Plus 2k SL1"); break;
311 case 0x09: PrintAndLog("TYPE : NXP MIFARE Mini 0.3k"); break;
312 case 0x10: PrintAndLog("TYPE : NXP MIFARE Plus 2k SL2"); break;
313 case 0x11: PrintAndLog("TYPE : NXP MIFARE Plus 4k SL2"); break;
314 case 0x18: PrintAndLog("TYPE : NXP MIFARE Classic 4k | Plus 4k SL1"); break;
315 case 0x20: PrintAndLog("TYPE : NXP MIFARE DESFire 4k | DESFire EV1 2k/4k/8k | Plus 2k/4k SL3 | JCOP 31/41"); break;
316 case 0x24: PrintAndLog("TYPE : NXP MIFARE DESFire | DESFire EV1"); break;
317 case 0x28: PrintAndLog("TYPE : JCOP31 or JCOP41 v2.3.1"); break;
318 case 0x38: PrintAndLog("TYPE : Nokia 6212 or 6131 MIFARE CLASSIC 4K"); break;
319 case 0x88: PrintAndLog("TYPE : Infineon MIFARE CLASSIC 1K"); break;
320 case 0x98: PrintAndLog("TYPE : Gemplus MPCOS"); break;
324 // Double & triple sized UID, can be mapped to a manufacturer.
325 // HACK: does this apply for Ultralight cards?
326 if ( card
.uidlen
> 4 ) {
327 PrintAndLog("MANUFACTURER : %s", getTagInfo(card
.uid
[0]));
330 // try to request ATS even if tag claims not to support it
331 if (select_status
== 2) {
332 uint8_t rats
[] = { 0xE0, 0x80 }; // FSDI=8 (FSD=256), CID=0
333 c
.arg
[0] = ISO14A_RAW
| ISO14A_APPEND_CRC
| ISO14A_NO_DISCONNECT
;
336 memcpy(c
.d
.asBytes
, rats
, 2);
338 WaitForResponse(CMD_ACK
,&resp
);
340 memcpy(card
.ats
, resp
.d
.asBytes
, resp
.arg
[0]);
341 card
.ats_len
= resp
.arg
[0]; // note: ats_len includes CRC Bytes
344 if(card
.ats_len
>= 3) { // a valid ATS consists of at least the length byte (TL) and 2 CRC bytes
345 bool ta1
= 0, tb1
= 0, tc1
= 0;
348 if (select_status
== 2) {
349 PrintAndLog("SAK incorrectly claims that card doesn't support RATS");
351 PrintAndLog(" ATS : %s", sprint_hex(card
.ats
, card
.ats_len
));
352 PrintAndLog(" - TL : length is %d bytes", card
.ats
[0]);
353 if (card
.ats
[0] != card
.ats_len
- 2) {
354 PrintAndLog("ATS may be corrupted. Length of ATS (%d bytes incl. 2 Bytes CRC) doesn't match TL", card
.ats_len
);
357 if (card
.ats
[0] > 1) { // there is a format byte (T0)
358 ta1
= (card
.ats
[1] & 0x10) == 0x10;
359 tb1
= (card
.ats
[1] & 0x20) == 0x20;
360 tc1
= (card
.ats
[1] & 0x40) == 0x40;
361 int16_t fsci
= card
.ats
[1] & 0x0f;
362 PrintAndLog(" - T0 : TA1 is%s present, TB1 is%s present, "
363 "TC1 is%s present, FSCI is %d (FSC = %ld)",
364 (ta1
? "" : " NOT"), (tb1
? "" : " NOT"), (tc1
? "" : " NOT"),
366 fsci
< 5 ? (fsci
- 2) * 8 :
367 fsci
< 8 ? (fsci
- 3) * 32 :
375 dr
[0] = ds
[0] = '\0';
376 if (card
.ats
[pos
] & 0x10) strcat(ds
, "2, ");
377 if (card
.ats
[pos
] & 0x20) strcat(ds
, "4, ");
378 if (card
.ats
[pos
] & 0x40) strcat(ds
, "8, ");
379 if (card
.ats
[pos
] & 0x01) strcat(dr
, "2, ");
380 if (card
.ats
[pos
] & 0x02) strcat(dr
, "4, ");
381 if (card
.ats
[pos
] & 0x04) strcat(dr
, "8, ");
382 if (strlen(ds
) != 0) ds
[strlen(ds
) - 2] = '\0';
383 if (strlen(dr
) != 0) dr
[strlen(dr
) - 2] = '\0';
384 PrintAndLog(" - TA1 : different divisors are%s supported, "
385 "DR: [%s], DS: [%s]",
386 (card
.ats
[pos
] & 0x80 ? " NOT" : ""), dr
, ds
);
390 uint32_t sfgi
= card
.ats
[pos
] & 0x0F;
391 uint32_t fwi
= card
.ats
[pos
] >> 4;
392 PrintAndLog(" - TB1 : SFGI = %d (SFGT = %s%ld/fc), FWI = %d (FWT = %ld/fc)",
394 sfgi
? "" : "(not needed) ",
395 sfgi
? (1 << 12) << sfgi
: 0,
402 PrintAndLog(" - TC1 : NAD is%s supported, CID is%s supported",
403 (card
.ats
[pos
] & 0x01) ? "" : " NOT",
404 (card
.ats
[pos
] & 0x02) ? "" : " NOT");
407 if (card
.ats
[0] > pos
) {
409 if (card
.ats
[0] - pos
>= 7) {
410 if (memcmp(card
.ats
+ pos
, "\xC1\x05\x2F\x2F\x01\xBC\xD6", 7) == 0) {
411 tip
= "-> MIFARE Plus X 2K or 4K";
412 } else if (memcmp(card
.ats
+ pos
, "\xC1\x05\x2F\x2F\x00\x35\xC7", 7) == 0) {
413 tip
= "-> MIFARE Plus S 2K or 4K";
416 PrintAndLog(" - HB : %s%s", sprint_hex(card
.ats
+ pos
, card
.ats
[0] - pos
), tip
);
417 if (card
.ats
[pos
] == 0xC1) {
418 PrintAndLog(" c1 -> Mifare or (multiple) virtual cards of various type");
419 PrintAndLog(" %02x -> Length is %d bytes",
420 card
.ats
[pos
+ 1], card
.ats
[pos
+ 1]);
421 switch (card
.ats
[pos
+ 2] & 0xf0) {
423 PrintAndLog(" 1x -> MIFARE DESFire");
426 PrintAndLog(" 2x -> MIFARE Plus");
429 switch (card
.ats
[pos
+ 2] & 0x0f) {
431 PrintAndLog(" x0 -> <1 kByte");
434 PrintAndLog(" x1 -> 1 kByte");
437 PrintAndLog(" x2 -> 2 kByte");
440 PrintAndLog(" x3 -> 4 kByte");
443 PrintAndLog(" x4 -> 8 kByte");
446 switch (card
.ats
[pos
+ 3] & 0xf0) {
448 PrintAndLog(" 0x -> Engineering sample");
451 PrintAndLog(" 2x -> Released");
454 switch (card
.ats
[pos
+ 3] & 0x0f) {
456 PrintAndLog(" x0 -> Generation 1");
459 PrintAndLog(" x1 -> Generation 2");
462 PrintAndLog(" x2 -> Generation 3");
465 switch (card
.ats
[pos
+ 4] & 0x0f) {
467 PrintAndLog(" x0 -> Only VCSL supported");
470 PrintAndLog(" x1 -> VCS, VCSL, and SVC supported");
473 PrintAndLog(" xE -> no VCS command supported");
479 PrintAndLog("proprietary non iso14443-4 card found, RATS not supported");
483 // try to see if card responses to "chinese magic backdoor" commands.
486 if (isMifareClassic
) {
487 switch(DetectClassicPrng()) {
489 PrintAndLog("Prng detection: HARDENED (hardnested)");
492 PrintAndLog("Prng detection: WEAK");
495 PrintAndLog("Prng detection error.");
499 return select_status
;
502 // Collect ISO14443 Type A UIDs
503 int CmdHF14ACUIDs(const char *Cmd
)
505 // requested number of UIDs
507 // collect at least 1 (e.g. if no parameter was given)
510 PrintAndLog("Collecting %d UIDs", n
);
511 PrintAndLog("Start: %" PRIu64
, msclock()/1000);
513 for (int i
= 0; i
< n
; i
++) {
514 // execute anticollision procedure
515 UsbCommand c
= {CMD_READER_ISO_14443a
, {ISO14A_CONNECT
| ISO14A_NO_RATS
, 0, 0}};
519 WaitForResponse(CMD_ACK
,&resp
);
521 iso14a_card_select_t
*card
= (iso14a_card_select_t
*) resp
.d
.asBytes
;
523 // check if command failed
524 if (resp
.arg
[0] == 0) {
525 PrintAndLog("Card select failed.");
528 for (uint16_t i
= 0; i
< card
->uidlen
; i
++) {
529 sprintf(&uid_string
[2*i
], "%02X", card
->uid
[i
]);
531 PrintAndLog("%s", uid_string
);
534 PrintAndLog("End: %" PRIu64
, msclock()/1000);
539 // ## simulate iso14443a tag
540 // ## greg - added ability to specify tag UID
541 int CmdHF14ASim(const char *Cmd
)
543 UsbCommand c
= {CMD_SIMULATE_TAG_ISO_14443a
,{0,0,0}};
545 // Retrieve the tag type
546 uint8_t tagtype
= param_get8ex(Cmd
,0,0,10);
548 // When no argument was given, just print help message
551 PrintAndLog(" Emulating ISO/IEC 14443 type A tag with 4 or 7 byte UID");
553 PrintAndLog(" syntax: hf 14a sim <type> <uid>");
554 PrintAndLog(" types: 1 = MIFARE Classic");
555 PrintAndLog(" 2 = MIFARE Ultralight");
556 PrintAndLog(" 3 = MIFARE Desfire");
557 PrintAndLog(" 4 = ISO/IEC 14443-4");
558 PrintAndLog(" 5 = MIFARE Tnp3xxx");
563 // Store the tag type
566 // Retrieve the full 4 or 7 byte long uid
567 uint64_t long_uid
= param_get64ex(Cmd
,1,0,16);
569 // Are we handling the (optional) second part uid?
570 if (long_uid
> 0xffffffff) {
571 PrintAndLog("Emulating ISO/IEC 14443 type A tag with 7 byte UID (%014" PRIx64
")",long_uid
);
572 // Store the second part
573 c
.arg
[2] = (long_uid
& 0xffffffff);
575 // Store the first part, ignore the first byte, it is replaced by cascade byte (0x88)
576 c
.arg
[1] = (long_uid
& 0xffffff);
578 PrintAndLog("Emulating ISO/IEC 14443 type A tag with 4 byte UID (%08x)",long_uid
);
579 // Only store the first part
580 c
.arg
[1] = long_uid
& 0xffffffff;
583 // At lease save the mandatory first part of the UID
584 c.arg[0] = long_uid & 0xffffffff;
587 PrintAndLog("Emulating ISO/IEC 14443 type A tag with UID %01d %08x %08x",c.arg[0],c.arg[1],c.arg[2]);
592 PrintAndLog("Emulating ISO/IEC 14443-3 type A tag with 4 byte UID");
593 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)};
596 PrintAndLog("Emulating ISO/IEC 14443-4 type A tag with 7 byte UID");
599 PrintAndLog("Error: unkown tag type (%d)",c.arg[0]);
600 PrintAndLog("syntax: hf 14a sim <uid>",c.arg[0]);
601 PrintAndLog(" type1: 4 ",c.arg[0]);
608 unsigned int hi = 0, lo = 0;
610 while (sscanf(&Cmd[i++], "%1x", &n ) == 1) {
611 hi= (hi << 4) | (lo >> 28);
612 lo= (lo << 4) | (n & 0xf);
615 // 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)};
616 // PrintAndLog("Emulating ISO/IEC 14443 type A tag with UID %01d %08x %08x",c.arg[0],c.arg[1],c.arg[2]);
621 int CmdHF14ASnoop(const char *Cmd
) {
624 uint8_t ctmp
= param_getchar(Cmd
, 0) ;
625 if (ctmp
== 'h' || ctmp
== 'H') {
626 PrintAndLog("It get data from the field and saves it into command buffer.");
627 PrintAndLog("Buffer accessible from command hf list 14a.");
628 PrintAndLog("Usage: hf 14a snoop [c][r]");
629 PrintAndLog("c - triggered by first data from card");
630 PrintAndLog("r - triggered by first 7-bit request from reader (REQ,WUP,...)");
631 PrintAndLog("sample: hf 14a snoop c r");
635 for (int i
= 0; i
< 2; i
++) {
636 ctmp
= param_getchar(Cmd
, i
);
637 if (ctmp
== 'c' || ctmp
== 'C') param
|= 0x01;
638 if (ctmp
== 'r' || ctmp
== 'R') param
|= 0x02;
641 UsbCommand c
= {CMD_SNOOP_ISO_14443a
, {param
, 0, 0}};
647 UsbCommand c
= {CMD_READER_ISO_14443a
, {0, 0, 0}};
651 int ExchangeAPDU14a(uint8_t *datain
, int datainlen
, bool activateField
, bool leaveSignalON
, uint8_t *dataout
, int maxdataoutlen
, int *dataoutlen
) {
655 cmdc
|= ISO14A_CONNECT
| ISO14A_CLEAR_TRACE
;
658 cmdc
|= ISO14A_NO_DISCONNECT
;
660 // "Command APDU" length should be 5+255+1, but javacard's APDU buffer might be smaller - 133 bytes
661 // https://stackoverflow.com/questions/32994936/safe-max-java-card-apdu-data-command-and-respond-size
662 // here length USB_CMD_DATA_SIZE=512
663 // timeout must be authomatically set by "get ATS"
664 UsbCommand c
= {CMD_READER_ISO_14443a
, {ISO14A_APDU
| cmdc
, (datainlen
& 0xFFFF), 0}};
665 memcpy(c
.d
.asBytes
, datain
, datainlen
);
672 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) {
673 PrintAndLog("APDU ERROR: Proxmark connection timeout.");
676 if (resp
.arg
[0] != 1) {
677 PrintAndLog("APDU ERROR: Proxmark error %d.", resp
.arg
[0]);
682 if (WaitForResponseTimeout(CMD_ACK
, &resp
, 1500)) {
683 recv
= resp
.d
.asBytes
;
684 int iLen
= resp
.arg
[0];
686 *dataoutlen
= iLen
- 2;
690 if (maxdataoutlen
&& *dataoutlen
> maxdataoutlen
) {
691 PrintAndLog("APDU ERROR: Buffer too small(%d). Needs %d bytes", *dataoutlen
, maxdataoutlen
);
695 memcpy(dataout
, recv
, *dataoutlen
);
698 PrintAndLog("APDU ERROR: No APDU response.");
704 PrintAndLog("APDU ERROR: Block type mismatch.");
710 PrintAndLog("APDU ERROR: ISO 14443A CRC error.");
716 PrintAndLog("APDU ERROR: Small APDU response. Len=%d", iLen
);
721 PrintAndLog("APDU ERROR: Reply timeout.");
728 // ISO14443-4. 7. Half-duplex block transmission protocol
729 int CmdHF14AAPDU(const char *cmd
) {
730 uint8_t data
[USB_CMD_DATA_SIZE
];
732 bool activateField
= false;
733 bool leaveSignalON
= false;
734 bool decodeTLV
= false;
736 CLIParserInit("hf 14a apdu",
737 "Sends an ISO 7816-4 APDU via ISO 14443-4 block transmission protocol (T=CL)",
738 "Sample:\n\thf 14a apdu -st 00A404000E325041592E5359532E444446303100\n");
742 arg_lit0("sS", "select", "activate field and select card"),
743 arg_lit0("kK", "keep", "leave the signal field ON after receive response"),
744 arg_lit0("tT", "tlv", "executes TLV decoder if it possible"),
745 arg_strx1(NULL
, NULL
, "<APDU (hex)>", NULL
),
748 CLIExecWithReturn(cmd
, argtable
, false);
750 activateField
= arg_get_lit(1);
751 leaveSignalON
= arg_get_lit(2);
752 decodeTLV
= arg_get_lit(3);
753 // len = data + PCB(1b) + CRC(2b)
754 CLIGetStrBLessWithReturn(4, data
, &datalen
, 1 + 2);
758 // PrintAndLog("---str [%d] %s", arg_get_str(4)->count, arg_get_str(4)->sval[0]);
759 PrintAndLog(">>>>[%s%s%s] %s", activateField
? "sel ": "", leaveSignalON
? "keep ": "", decodeTLV
? "TLV": "", sprint_hex(data
, datalen
));
761 int res
= ExchangeAPDU14a(data
, datalen
, activateField
, leaveSignalON
, data
, USB_CMD_DATA_SIZE
, &datalen
);
766 PrintAndLog("<<<< %s", sprint_hex(data
, datalen
));
768 PrintAndLog("APDU response: %02x %02x - %s", data
[datalen
- 2], data
[datalen
- 1], GetAPDUCodeDescription(data
[datalen
- 2], data
[datalen
- 1]));
771 if (decodeTLV
&& datalen
> 4) {
772 TLVPrintFromBuffer(data
, datalen
- 2);
778 int CmdHF14ACmdRaw(const char *cmd
) {
779 UsbCommand c
= {CMD_READER_ISO_14443a
, {0, 0, 0}};
784 bool active_select
= false;
785 bool no_rats
= false;
786 uint16_t numbits
= 0;
787 bool bTimeout
= false;
788 uint32_t timeout
= 0;
789 bool topazmode
= false;
790 uint8_t data
[USB_CMD_DATA_SIZE
];
793 // extract parameters
794 CLIParserInit("hf 14a raw", "Send raw hex data to tag",
796 "\thf 14a raw -pa -b7 -t1000 52 -- execute WUPA\n"\
797 "\thf 14a raw -p 9320 -- anticollision\n"\
798 "\thf 14a raw -psc 60 00 -- select and mifare AUTH\n");
801 arg_lit0("rR", "nreply", "do not read response"),
802 arg_lit0("cC", "crc", "calculate and append CRC"),
803 arg_lit0("pP", "power", "leave the signal field ON after receive"),
804 arg_lit0("aA", "active", "active signal field ON without select"),
805 arg_lit0("sS", "actives", "active signal field ON with select"),
806 arg_int0("bB", "bits", NULL
, "number of bits to send. Useful for send partial byte"),
807 arg_int0("t", "timeout", NULL
, "timeout in ms"),
808 arg_lit0("T", "topaz", "use Topaz protocol to send command"),
809 arg_lit0("3", NULL
, "ISO14443-3 select only (skip RATS)"),
810 arg_strx1(NULL
, NULL
, "<data (hex)>", NULL
),
817 if (CLIParserParseString(cmd
, argtable
, arg_getsize(argtable
), false)){
822 reply
= !arg_get_lit(1);
823 crc
= arg_get_lit(2);
824 power
= arg_get_lit(3);
825 active
= arg_get_lit(4);
826 active_select
= arg_get_lit(5);
827 numbits
= arg_get_int(6) & 0xFFFF;
828 timeout
= arg_get_int(7);
829 bTimeout
= (timeout
> 0);
830 topazmode
= arg_get_lit(8);
831 no_rats
= arg_get_lit(9);
832 // len = data + CRC(2b)
833 if (CLIParamHexToBuf(arg_get_str(10), data
, sizeof(data
) -2, &datalen
)) {
841 if(crc
&& datalen
>0 && datalen
<sizeof(data
)-2)
843 uint8_t first
, second
;
845 ComputeCrc14443(CRC_14443_B
, data
, datalen
, &first
, &second
);
847 ComputeCrc14443(CRC_14443_A
, data
, datalen
, &first
, &second
);
849 data
[datalen
++] = first
;
850 data
[datalen
++] = second
;
853 if(active
|| active_select
)
855 c
.arg
[0] |= ISO14A_CONNECT
| ISO14A_CLEAR_TRACE
;
857 c
.arg
[0] |= ISO14A_NO_SELECT
;
861 #define MAX_TIMEOUT 40542464 // = (2^32-1) * (8*16) / 13560000Hz * 1000ms/s
862 c
.arg
[0] |= ISO14A_SET_TIMEOUT
;
863 if(timeout
> MAX_TIMEOUT
) {
864 timeout
= MAX_TIMEOUT
;
865 PrintAndLog("Set timeout to 40542 seconds (11.26 hours). The max we can wait for response");
867 c
.arg
[2] = 13560000 / 1000 / (8*16) * timeout
; // timeout in ETUs (time to transfer 1 bit, approx. 9.4 us)
871 c
.arg
[0] |= ISO14A_NO_DISCONNECT
;
875 c
.arg
[0] |= ISO14A_RAW
;
879 c
.arg
[0] |= ISO14A_TOPAZMODE
;
883 c
.arg
[0] |= ISO14A_NO_RATS
;
886 // Max buffer is USB_CMD_DATA_SIZE (512)
887 c
.arg
[1] = (datalen
& 0xFFFF) | ((uint32_t)numbits
<< 16);
888 memcpy(c
.d
.asBytes
,data
,datalen
);
896 if (!res
&& datalen
> 0)
903 static int waitCmd(uint8_t iSelect
) {
908 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1500)) {
909 recv
= resp
.d
.asBytes
;
910 uint8_t iLen
= resp
.arg
[0];
914 PrintAndLog("Card selected. UID[%i]:", iLen
);
916 PrintAndLog("Can't select card.");
919 PrintAndLog("received %i bytes:", iLen
);
923 hexout
= (char *)malloc(iLen
* 3 + 1);
924 if (hexout
!= NULL
) {
925 for (int i
= 0; i
< iLen
; i
++) { // data in hex
926 sprintf(&hexout
[i
* 3], "%02X ", recv
[i
]);
928 PrintAndLog("%s", hexout
);
931 PrintAndLog("malloc failed your client has low memory?");
935 PrintAndLog("timeout while waiting for reply.");
941 static command_t CommandTable
[] =
943 {"help", CmdHelp
, 1, "This help"},
944 {"list", CmdHF14AList
, 0, "[Deprecated] List ISO 14443a history"},
945 {"reader", CmdHF14AReader
, 0, "Start acting like an ISO14443 Type A reader"},
946 {"info", CmdHF14AInfo
, 0, "Reads card and shows information about it"},
947 {"cuids", CmdHF14ACUIDs
, 0, "<n> Collect n>0 ISO14443 Type A UIDs in one go"},
948 {"sim", CmdHF14ASim
, 0, "<UID> -- Simulate ISO 14443a tag"},
949 {"snoop", CmdHF14ASnoop
, 0, "Eavesdrop ISO 14443 Type A"},
950 {"apdu", CmdHF14AAPDU
, 0, "Send an ISO 7816-4 APDU via ISO 14443-4 block transmission protocol"},
951 {"raw", CmdHF14ACmdRaw
, 0, "Send raw hex data to tag"},
952 {NULL
, NULL
, 0, NULL
}
955 int CmdHF14A(const char *Cmd
) {
956 (void)WaitForResponseTimeout(CMD_ACK
,NULL
,100);
957 CmdsParse(CommandTable
, Cmd
);
961 int CmdHelp(const char *Cmd
)
963 CmdsHelp(CommandTable
);