1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>, Hagen Fritsch
3 // Copyright (C) 2011 Gerhard de Koning Gans
4 // Copyright (C) 2014 Midnitesnake & Andy Davies & Martin Holst Swende
6 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
7 // at your option, any later version. See the LICENSE.txt file for the text of
9 //-----------------------------------------------------------------------------
10 // High frequency iClass commands
11 //-----------------------------------------------------------------------------
17 #include "iso14443crc.h" // Can also be used for iClass, using 0xE012 as CRC-type
19 //#include "proxusb.h"
20 #include "proxmark3.h"
22 #include "cmdparser.h"
23 #include "cmdhficlass.h"
27 #include "loclass/des.h"
28 #include "loclass/cipherutils.h"
29 #include "loclass/cipher.h"
30 #include "loclass/ikeys.h"
31 #include "loclass/elite_crack.h"
32 #include "loclass/fileutils.h"
34 static int CmdHelp(const char *Cmd
);
36 int xorbits_8(uint8_t val
)
38 uint8_t res
= val
^ (val
>> 1); //1st pass
39 res
= res
^ (res
>> 1); // 2nd pass
40 res
= res
^ (res
>> 2); // 3rd pass
41 res
= res
^ (res
>> 4); // 4th pass
45 int CmdHFiClassList(const char *Cmd
)
48 bool ShowWaitCycles
= false;
49 char param
= param_getchar(Cmd
, 0);
52 PrintAndLog("List data in trace buffer.");
53 PrintAndLog("Usage: hf iclass list");
54 PrintAndLog("h - help");
55 PrintAndLog("sample: hf iclass list");
60 GetFromBigBuf(got
,sizeof(got
),0);
61 WaitForResponse(CMD_ACK
,NULL
);
63 PrintAndLog("Recorded Activity");
65 PrintAndLog("Start = Start of Start Bit, End = End of last modulation. Src = Source of Transfer");
66 PrintAndLog("All times are in carrier periods (1/13.56Mhz)");
68 PrintAndLog(" Start | End | Src | Data");
69 PrintAndLog("-----------|-----------|-----|--------");
72 uint32_t first_timestamp
= 0;
78 uint32_t EndOfTransmissionTimestamp
= 0;
83 //First 32 bits contain
85 // timestamp (remaining)
88 timestamp
= *((uint32_t *)(got
+i
));
89 parityBits
= *((uint32_t *)(got
+i
+4));
92 uint32_t next_timestamp
= (*((uint32_t *)(got
+i
+9))) & 0x7fffffff;
94 tagToReader
= timestamp
& 0x80000000;
95 timestamp
&= 0x7fffffff;
98 first_timestamp
= timestamp
;
101 // Break and stick with current result idf buffer was not completely full
102 if (frame
[0] == 0x44 && frame
[1] == 0x44 && frame
[2] == 0x44 && frame
[3] == 0x44) break;
104 char line
[1000] = "";
106 if(len
)//We have some data to display
110 for(j
= 0; j
< len
; j
++)
112 oddparity
= 0x01 ^ xorbits_8(frame
[j
] & 0xFF);
114 if (tagToReader
&& (oddparity
!= ((parityBits
>> (len
- j
- 1)) & 0x01))) {
115 sprintf(line
+(j
*4), "%02x! ", frame
[j
]);
117 sprintf(line
+(j
*4), "%02x ", frame
[j
]);
122 if (ShowWaitCycles
) {
123 sprintf(line
, "fdt (Frame Delay Time): %d", (next_timestamp
- timestamp
));
132 if(!tagToReader
&& len
== 4) {
133 // Rough guess that this is a command from the reader
134 // For iClass the command byte is not part of the CRC
135 ComputeCrc14443(CRC_ICLASS
, &frame
[1], len
-3, &b1
, &b2
);
138 // For other data.. CRC might not be applicable (UPDATE commands etc.)
139 ComputeCrc14443(CRC_ICLASS
, frame
, len
-2, &b1
, &b2
);
142 if (b1
!= frame
[len
-2] || b2
!= frame
[len
-1]) {
143 crc
= (tagToReader
& (len
< 8)) ? "" : " !crc";
148 EndOfTransmissionTimestamp
= (*((uint32_t *)(got
+i
))) & 0x7fffffff;
150 // Not implemented for iclass on the ARM-side
151 //if (!ShowWaitCycles) i += 9;
153 PrintAndLog(" %9d | %9d | %s | %s %s",
154 (timestamp
- first_timestamp
),
155 (EndOfTransmissionTimestamp
- first_timestamp
),
156 (len
?(tagToReader
? "Tag" : "Rdr"):" "),
162 int CmdHFiClassListOld(const char *Cmd
)
165 GetFromBigBuf(got
,sizeof(got
),0);
167 PrintAndLog("recorded activity:");
168 PrintAndLog(" ETU :rssi: who bytes");
169 PrintAndLog("---------+----+----+-----------");
180 int timestamp
= *((uint32_t *)(got
+i
));
181 if (timestamp
& 0x80000000) {
182 timestamp
&= 0x7fffffff;
191 int parityBits
= *((uint32_t *)(got
+i
+4));
192 // 4 bytes of additional information...
193 // maximum of 32 additional parity bit information
196 // at each quarter bit period we can send power level (16 levels)
197 // or each half bit period in 256 levels.
205 if (i
+ len
>= 1900) {
209 uint8_t *frame
= (got
+i
+9);
211 // Break and stick with current result if buffer was not completely full
212 if (frame
[0] == 0x44 && frame
[1] == 0x44 && frame
[3] == 0x44) { break; }
214 char line
[1000] = "";
216 for (j
= 0; j
< len
; j
++) {
217 int oddparity
= 0x01;
221 oddparity
^= (((frame
[j
] & 0xFF) >> k
) & 0x01);
224 //if((parityBits >> (len - j - 1)) & 0x01) {
225 if (isResponse
&& (oddparity
!= ((parityBits
>> (len
- j
- 1)) & 0x01))) {
226 sprintf(line
+(j
*4), "%02x! ", frame
[j
]);
229 sprintf(line
+(j
*4), "%02x ", frame
[j
]);
237 for (j
= 0; j
< (len
- 1); j
++) {
238 // gives problems... search for the reason..
239 /*if(frame[j] == 0xAA) {
242 crc = "[1] Two drops close after each other";
245 crc = "[2] Potential SOC with a drop in second half of bitperiod";
248 crc = "[3] Segment Z after segment X is not possible";
251 crc = "[4] Parity bit of a fully received byte was wrong";
254 crc = "[?] Unknown error";
261 if (strlen(crc
)==0) {
262 if(!isResponse
&& len
== 4) {
263 // Rough guess that this is a command from the reader
264 // For iClass the command byte is not part of the CRC
265 ComputeCrc14443(CRC_ICLASS
, &frame
[1], len
-3, &b1
, &b2
);
268 // For other data.. CRC might not be applicable (UPDATE commands etc.)
269 ComputeCrc14443(CRC_ICLASS
, frame
, len
-2, &b1
, &b2
);
271 //printf("%1x %1x",(unsigned)b1,(unsigned)b2);
272 if (b1
!= frame
[len
-2] || b2
!= frame
[len
-1]) {
273 crc
= (isResponse
& (len
< 8)) ? "" : " !crc";
282 char metricString
[100];
284 sprintf(metricString
, "%3d", metric
);
286 strcpy(metricString
, " ");
289 PrintAndLog(" +%7d: %s: %s %s %s",
290 (prev
< 0 ? 0 : (timestamp
- prev
)),
292 (isResponse
? "TAG" : " "), line
, crc
);
300 int CmdHFiClassSnoop(const char *Cmd
)
302 UsbCommand c
= {CMD_SNOOP_ICLASS
};
307 int CmdHFiClassSim(const char *Cmd
)
310 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
313 PrintAndLog("Usage: hf iclass sim [0 <CSN>] | x");
314 PrintAndLog(" options");
315 PrintAndLog(" 0 <CSN> simulate the given CSN");
316 PrintAndLog(" 1 simulate default CSN");
317 PrintAndLog(" 2 iterate CSNs, gather MACs");
318 PrintAndLog(" sample: hf iclass sim 0 031FEC8AF7FF12E0");
319 PrintAndLog(" sample: hf iclass sim 2");
323 simType
= param_get8(Cmd
, 0);
327 if (param_gethex(Cmd
, 1, CSN
, 16)) {
328 PrintAndLog("A CSN should consist of 16 HEX symbols");
331 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
336 PrintAndLog("Undefined simptype %d", simType
);
339 uint8_t numberOfCSNs
=0;
343 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,63}};
344 UsbCommand resp
= {0};
347 0x00,0x0B,0x0F,0xFF,0xF7,0xFF,0x12,0xE0 ,
348 0x00,0x13,0x94,0x7e,0x76,0xff,0x12,0xe0 ,
349 0x2a,0x99,0xac,0x79,0xec,0xff,0x12,0xe0 ,
350 0x17,0x12,0x01,0xfd,0xf7,0xff,0x12,0xe0 ,
351 0xcd,0x56,0x01,0x7c,0x6f,0xff,0x12,0xe0 ,
352 0x4b,0x5e,0x0b,0x72,0xef,0xff,0x12,0xe0 ,
353 0x00,0x73,0xd8,0x75,0x58,0xff,0x12,0xe0 ,
354 0x0c,0x90,0x32,0xf3,0x5d,0xff,0x12,0xe0 };
356 memcpy(c
.d
.asBytes
, csns
, 64);
359 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
360 PrintAndLog("Command timed out");
364 uint8_t num_mac_responses
= resp
.arg
[1];
365 PrintAndLog("Mac responses: %d MACs obtained (should be 8)", num_mac_responses
);
367 size_t datalen
= 8*24;
369 * Now, time to dump to file. We'll use this format:
370 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
371 * So, it should wind up as
374 * The returndata from the pm3 is on the following format
375 * <4 byte NR><4 byte MAC>
376 * CC are all zeroes, CSN is the same as was sent in
378 void* dump
= malloc(datalen
);
379 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
381 for(i
= 0 ; i
< 8 ; i
++)
383 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
384 //8 zero bytes here...
385 //Then comes NR_MAC (eight bytes from the response)
386 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
389 /** Now, save to dumpfile **/
390 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
394 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
395 memcpy(c
.d
.asBytes
, CSN
, 8);
402 int CmdHFiClassReader(const char *Cmd
)
404 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
408 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
409 uint8_t isOK
= resp
.arg
[0] & 0xff;
410 uint8_t * data
= resp
.d
.asBytes
;
412 PrintAndLog("isOk:%02x", isOK
);
416 PrintAndLog("CSN: %s",sprint_hex(data
,8));
420 PrintAndLog("CC: %s",sprint_hex(data
+8,8));
422 PrintAndLog("No CC obtained");
425 PrintAndLog("Command execute timeout");
432 int CmdHFiClassReader_Replay(const char *Cmd
)
434 uint8_t readerType
= 0;
435 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
438 PrintAndLog("Usage: hf iclass replay <MAC>");
439 PrintAndLog(" sample: hf iclass replay 00112233");
443 if (param_gethex(Cmd
, 0, MAC
, 8)) {
444 PrintAndLog("MAC must include 8 HEX symbols");
448 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
449 memcpy(c
.d
.asBytes
, MAC
, 4);
455 int CmdHFiClassReader_Dump(const char *Cmd
)
457 uint8_t readerType
= 0;
458 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
459 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
460 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
461 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
462 //uint8_t CC_temp[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
463 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
464 uint8_t keytable
[128] = {0};
470 PrintAndLog("Usage: hf iclass dump <Key> [e]");
471 PrintAndLog(" Key - A 16 byte master key");
472 PrintAndLog(" e - If 'e' is specified, the key is interpreted as the 16 byte");
473 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
474 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
475 PrintAndLog(" sample: hf iclass dump 0011223344556677");
481 if (param_gethex(Cmd
, 0, KEY
, 16))
483 PrintAndLog("KEY must include 16 HEX symbols");
487 if (param_getchar(Cmd
, 1) == 'e')
489 PrintAndLog("Elite switch on");
493 hash2(KEY
, keytable
);
498 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
499 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
;
505 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
506 uint8_t isOK
= resp
.arg
[0] & 0xff;
507 uint8_t * data
= resp
.d
.asBytes
;
510 memcpy(CCNR
,data
+8,8);
512 PrintAndLog("isOk:%02x", isOK
);
516 PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
522 uint8_t key_sel
[8] = {0};
523 uint8_t key_sel_p
[8] = { 0 };
524 //Get the key index (hash1)
525 uint8_t key_index
[8] = {0};
527 hash1(CSN
, key_index
);
528 printvar("hash1", key_index
,8);
529 for(i
= 0; i
< 8 ; i
++)
530 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
531 printvar("k_sel", key_sel
,8);
532 //Permute from iclass format to standard format
533 permutekey_rev(key_sel
,key_sel_p
);
534 used_key
= key_sel_p
;
539 printvar("CC:",CCNR
,8);
540 printvar("Used key",used_key
,8);
541 diversifyKey(CSN
,used_key
, div_key
);
542 printvar("Div key", div_key
, 8);
543 doMAC(CCNR
,12,div_key
, MAC
);
544 printvar("MAC", MAC
, 4);
546 UsbCommand d
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
547 memcpy(d
.d
.asBytes
, MAC
, 4);
551 PrintAndLog("Failed to obtain CC! Aborting");
554 PrintAndLog("Command execute timeout");
560 int CmdHFiClass_iso14443A_write(const char *Cmd
)
562 uint8_t readerType
= 0;
563 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
564 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
565 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
566 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
567 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
570 uint8_t bldata
[8]={0};
574 PrintAndLog("Usage: hf iclass write <Key> <Block> <Data>");
575 PrintAndLog(" sample: hf iclass write 0011223344556677 10 AAAAAAAAAAAAAAAA");
579 if (param_gethex(Cmd
, 0, KEY
, 16))
581 PrintAndLog("KEY must include 16 HEX symbols");
585 blockNo
= param_get8(Cmd
, 1);
588 PrintAndLog("Error: Maximum number of blocks is 32 for iClass 2K Cards!");
591 if (param_gethex(Cmd
, 2, bldata
, 8))
593 PrintAndLog("Block data must include 8 HEX symbols");
597 UsbCommand c
= {CMD_ICLASS_ISO14443A_WRITE
, {0}};
601 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
602 uint8_t isOK
= resp
.arg
[0] & 0xff;
603 uint8_t * data
= resp
.d
.asBytes
;
606 memcpy(CCNR
,data
+8,8);
607 PrintAndLog("DEBUG: %s",sprint_hex(CSN
,8));
608 PrintAndLog("DEBUG: %s",sprint_hex(CCNR
,8));
609 PrintAndLog("isOk:%02x", isOK
);
611 PrintAndLog("Command execute timeout");
614 diversifyKey(CSN
,KEY
, div_key
);
616 PrintAndLog("Div Key: %s",sprint_hex(div_key
,8));
617 doMAC(CCNR
, 12,div_key
, MAC
);
619 UsbCommand c2
= {CMD_ICLASS_ISO14443A_WRITE
, {readerType
,blockNo
}};
620 memcpy(c2
.d
.asBytes
, bldata
, 8);
621 memcpy(c2
.d
.asBytes
+8, MAC
, 4);
624 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1500)) {
625 uint8_t isOK
= resp
.arg
[0] & 0xff;
626 uint8_t * data
= resp
.d
.asBytes
;
629 PrintAndLog("isOk:%02x data:%s", isOK
, sprint_hex(data
, 4));
631 PrintAndLog("isOk:%02x", isOK
);
633 PrintAndLog("Command execute timeout");
639 static command_t CommandTable
[] =
641 {"help", CmdHelp
, 1, "This help"},
642 {"list", CmdHFiClassList
, 0, "List iClass history"},
643 {"snoop", CmdHFiClassSnoop
, 0, "Eavesdrop iClass communication"},
644 {"sim", CmdHFiClassSim
, 0, "Simulate iClass tag"},
645 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
646 {"replay",CmdHFiClassReader_Replay
, 0, "Read an iClass tag via Reply Attack"},
647 {"dump", CmdHFiClassReader_Dump
, 0, "Authenticate and Dump iClass tag"},
648 {"write", CmdHFiClass_iso14443A_write
, 0, "Authenticate and Write iClass block"},
649 {NULL
, NULL
, 0, NULL
}
652 int CmdHFiClass(const char *Cmd
)
654 CmdsParse(CommandTable
, Cmd
);
658 int CmdHelp(const char *Cmd
)
660 CmdsHelp(CommandTable
);