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 "proxmark3.h"
21 #include "cmdparser.h"
22 #include "cmdhficlass.h"
23 #include "../include/common.h"
26 #include "loclass/des.h"
27 #include "loclass/cipherutils.h"
28 #include "loclass/cipher.h"
29 #include "loclass/ikeys.h"
30 #include "loclass/elite_crack.h"
31 #include "loclass/fileutils.h"
33 static int CmdHelp(const char *Cmd
);
35 int xorbits_8(uint8_t val
)
37 uint8_t res
= val
^ (val
>> 1); //1st pass
38 res
= res
^ (res
>> 1); // 2nd pass
39 res
= res
^ (res
>> 2); // 3rd pass
40 res
= res
^ (res
>> 4); // 4th pass
44 int CmdHFiClassList(const char *Cmd
)
47 bool ShowWaitCycles
= false;
48 char param
= param_getchar(Cmd
, 0);
51 PrintAndLog("List data in trace buffer.");
52 PrintAndLog("Usage: hf iclass list");
53 PrintAndLog("h - help");
54 PrintAndLog("sample: hf iclass list");
59 GetFromBigBuf(got
,sizeof(got
),0);
60 WaitForResponse(CMD_ACK
,NULL
);
62 PrintAndLog("Recorded Activity");
64 PrintAndLog("Start = Start of Start Bit, End = End of last modulation. Src = Source of Transfer");
65 PrintAndLog("All times are in carrier periods (1/13.56Mhz)");
67 PrintAndLog(" Start | End | Src | Data");
68 PrintAndLog("-----------|-----------|-----|--------");
71 uint32_t first_timestamp
= 0;
77 uint32_t EndOfTransmissionTimestamp
= 0;
82 //First 32 bits contain
84 // timestamp (remaining)
87 timestamp
= *((uint32_t *)(got
+i
));
88 parityBits
= *((uint32_t *)(got
+i
+4));
91 uint32_t next_timestamp
= (*((uint32_t *)(got
+i
+9))) & 0x7fffffff;
93 tagToReader
= timestamp
& 0x80000000;
94 timestamp
&= 0x7fffffff;
97 first_timestamp
= timestamp
;
100 // Break and stick with current result idf buffer was not completely full
101 if (frame
[0] == 0x44 && frame
[1] == 0x44 && frame
[2] == 0x44 && frame
[3] == 0x44) break;
103 char line
[1000] = "";
105 if(len
)//We have some data to display
109 for(j
= 0; j
< len
; j
++)
111 oddparity
= 0x01 ^ xorbits_8(frame
[j
] & 0xFF);
113 if (tagToReader
&& (oddparity
!= ((parityBits
>> (len
- j
- 1)) & 0x01))) {
114 sprintf(line
+(j
*4), "%02x! ", frame
[j
]);
116 sprintf(line
+(j
*4), "%02x ", frame
[j
]);
121 if (ShowWaitCycles
) {
122 sprintf(line
, "fdt (Frame Delay Time): %d", (next_timestamp
- timestamp
));
131 if(!tagToReader
&& len
== 4) {
132 // Rough guess that this is a command from the reader
133 // For iClass the command byte is not part of the CRC
134 ComputeCrc14443(CRC_ICLASS
, &frame
[1], len
-3, &b1
, &b2
);
137 // For other data.. CRC might not be applicable (UPDATE commands etc.)
138 ComputeCrc14443(CRC_ICLASS
, frame
, len
-2, &b1
, &b2
);
141 if (b1
!= frame
[len
-2] || b2
!= frame
[len
-1]) {
142 crc
= (tagToReader
& (len
< 8)) ? "" : " !crc";
147 EndOfTransmissionTimestamp
= (*((uint32_t *)(got
+i
))) & 0x7fffffff;
149 // Not implemented for iclass on the ARM-side
150 //if (!ShowWaitCycles) i += 9;
152 PrintAndLog(" %9d | %9d | %s | %s %s",
153 (timestamp
- first_timestamp
),
154 (EndOfTransmissionTimestamp
- first_timestamp
),
155 (len
?(tagToReader
? "Tag" : "Rdr"):" "),
161 int CmdHFiClassListOld(const char *Cmd
)
164 GetFromBigBuf(got
,sizeof(got
),0);
166 PrintAndLog("recorded activity:");
167 PrintAndLog(" ETU :rssi: who bytes");
168 PrintAndLog("---------+----+----+-----------");
179 int timestamp
= *((uint32_t *)(got
+i
));
180 if (timestamp
& 0x80000000) {
181 timestamp
&= 0x7fffffff;
190 int parityBits
= *((uint32_t *)(got
+i
+4));
191 // 4 bytes of additional information...
192 // maximum of 32 additional parity bit information
195 // at each quarter bit period we can send power level (16 levels)
196 // or each half bit period in 256 levels.
204 if (i
+ len
>= 1900) {
208 uint8_t *frame
= (got
+i
+9);
210 // Break and stick with current result if buffer was not completely full
211 if (frame
[0] == 0x44 && frame
[1] == 0x44 && frame
[3] == 0x44) { break; }
213 char line
[1000] = "";
215 for (j
= 0; j
< len
; j
++) {
216 int oddparity
= 0x01;
220 oddparity
^= (((frame
[j
] & 0xFF) >> k
) & 0x01);
223 //if((parityBits >> (len - j - 1)) & 0x01) {
224 if (isResponse
&& (oddparity
!= ((parityBits
>> (len
- j
- 1)) & 0x01))) {
225 sprintf(line
+(j
*4), "%02x! ", frame
[j
]);
228 sprintf(line
+(j
*4), "%02x ", frame
[j
]);
236 for (j
= 0; j
< (len
- 1); j
++) {
237 // gives problems... search for the reason..
238 /*if(frame[j] == 0xAA) {
241 crc = "[1] Two drops close after each other";
244 crc = "[2] Potential SOC with a drop in second half of bitperiod";
247 crc = "[3] Segment Z after segment X is not possible";
250 crc = "[4] Parity bit of a fully received byte was wrong";
253 crc = "[?] Unknown error";
260 if (strlen(crc
)==0) {
261 if(!isResponse
&& len
== 4) {
262 // Rough guess that this is a command from the reader
263 // For iClass the command byte is not part of the CRC
264 ComputeCrc14443(CRC_ICLASS
, &frame
[1], len
-3, &b1
, &b2
);
267 // For other data.. CRC might not be applicable (UPDATE commands etc.)
268 ComputeCrc14443(CRC_ICLASS
, frame
, len
-2, &b1
, &b2
);
270 //printf("%1x %1x",(unsigned)b1,(unsigned)b2);
271 if (b1
!= frame
[len
-2] || b2
!= frame
[len
-1]) {
272 crc
= (isResponse
& (len
< 8)) ? "" : " !crc";
281 char metricString
[100];
283 sprintf(metricString
, "%3d", metric
);
285 strcpy(metricString
, " ");
288 PrintAndLog(" +%7d: %s: %s %s %s",
289 (prev
< 0 ? 0 : (timestamp
- prev
)),
291 (isResponse
? "TAG" : " "), line
, crc
);
299 int CmdHFiClassSnoop(const char *Cmd
)
301 UsbCommand c
= {CMD_SNOOP_ICLASS
};
306 int CmdHFiClassSim(const char *Cmd
)
309 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
312 PrintAndLog("Usage: hf iclass sim [0 <CSN>] | x");
313 PrintAndLog(" options");
314 PrintAndLog(" 0 <CSN> simulate the given CSN");
315 PrintAndLog(" 1 simulate default CSN");
316 PrintAndLog(" 2 iterate CSNs, gather MACs");
317 PrintAndLog(" sample: hf iclass sim 0 031FEC8AF7FF12E0");
318 PrintAndLog(" sample: hf iclass sim 2");
322 simType
= param_get8(Cmd
, 0);
326 if (param_gethex(Cmd
, 1, CSN
, 16)) {
327 PrintAndLog("A CSN should consist of 16 HEX symbols");
330 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
335 PrintAndLog("Undefined simptype %d", simType
);
338 uint8_t numberOfCSNs
=0;
342 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,63}};
343 UsbCommand resp
= {0};
346 0x00,0x0B,0x0F,0xFF,0xF7,0xFF,0x12,0xE0 ,
347 0x00,0x13,0x94,0x7e,0x76,0xff,0x12,0xe0 ,
348 0x2a,0x99,0xac,0x79,0xec,0xff,0x12,0xe0 ,
349 0x17,0x12,0x01,0xfd,0xf7,0xff,0x12,0xe0 ,
350 0xcd,0x56,0x01,0x7c,0x6f,0xff,0x12,0xe0 ,
351 0x4b,0x5e,0x0b,0x72,0xef,0xff,0x12,0xe0 ,
352 0x00,0x73,0xd8,0x75,0x58,0xff,0x12,0xe0 ,
353 0x0c,0x90,0x32,0xf3,0x5d,0xff,0x12,0xe0 };
355 memcpy(c
.d
.asBytes
, csns
, 64);
358 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
359 PrintAndLog("Command timed out");
363 uint8_t num_mac_responses
= resp
.arg
[1];
364 PrintAndLog("Mac responses: %d MACs obtained (should be 8)", num_mac_responses
);
366 size_t datalen
= 8*24;
368 * Now, time to dump to file. We'll use this format:
369 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
370 * So, it should wind up as
373 * The returndata from the pm3 is on the following format
374 * <4 byte NR><4 byte MAC>
375 * CC are all zeroes, CSN is the same as was sent in
377 void* dump
= malloc(datalen
);
378 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
380 for(i
= 0 ; i
< 8 ; i
++)
382 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
383 //8 zero bytes here...
384 //Then comes NR_MAC (eight bytes from the response)
385 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
388 /** Now, save to dumpfile **/
389 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
393 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
394 memcpy(c
.d
.asBytes
, CSN
, 8);
401 int CmdHFiClassReader(const char *Cmd
)
403 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
407 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
408 uint8_t isOK
= resp
.arg
[0] & 0xff;
409 uint8_t * data
= resp
.d
.asBytes
;
411 PrintAndLog("isOk:%02x", isOK
);
415 PrintAndLog("CSN: %s",sprint_hex(data
,8));
419 PrintAndLog("CC: %s",sprint_hex(data
+8,8));
421 PrintAndLog("No CC obtained");
424 PrintAndLog("Command execute timeout");
431 int CmdHFiClassReader_Replay(const char *Cmd
)
433 uint8_t readerType
= 0;
434 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
437 PrintAndLog("Usage: hf iclass replay <MAC>");
438 PrintAndLog(" sample: hf iclass replay 00112233");
442 if (param_gethex(Cmd
, 0, MAC
, 8)) {
443 PrintAndLog("MAC must include 8 HEX symbols");
447 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
448 memcpy(c
.d
.asBytes
, MAC
, 4);
454 int CmdHFiClassReader_Dump(const char *Cmd
)
456 uint8_t readerType
= 0;
457 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
458 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
459 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
460 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
461 //uint8_t CC_temp[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
462 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
463 uint8_t keytable
[128] = {0};
469 PrintAndLog("Usage: hf iclass dump <Key> [e]");
470 PrintAndLog(" Key - A 16 byte master key");
471 PrintAndLog(" e - If 'e' is specified, the key is interpreted as the 16 byte");
472 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
473 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
474 PrintAndLog(" sample: hf iclass dump 0011223344556677");
480 if (param_gethex(Cmd
, 0, KEY
, 16))
482 PrintAndLog("KEY must include 16 HEX symbols");
486 if (param_getchar(Cmd
, 1) == 'e')
488 PrintAndLog("Elite switch on");
492 hash2(KEY
, keytable
);
493 printarr_human_readable("keytable", keytable
, 128);
498 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
499 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
;
504 uint8_t key_sel
[8] = {0x00};
505 uint8_t key_sel_p
[8] = {0x00};
507 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
508 uint8_t isOK
= resp
.arg
[0] & 0xff;
509 uint8_t * data
= resp
.d
.asBytes
;
512 memcpy(CCNR
,data
+8,8);
514 PrintAndLog("isOk:%02x", isOK
);
518 PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
525 //Get the key index (hash1)
526 uint8_t key_index
[8] = {0};
528 hash1(CSN
, key_index
);
529 printvar("hash1", key_index
,8);
530 for(i
= 0; i
< 8 ; i
++)
531 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
532 printvar("k_sel", key_sel
,8);
533 //Permute from iclass format to standard format
534 permutekey_rev(key_sel
,key_sel_p
);
535 used_key
= key_sel_p
;
537 //Perhaps this should also be permuted to std format?
538 // Something like the code below? I have no std system
539 // to test this with /Martin
541 //uint8_t key_sel_p[8] = { 0 };
542 //permutekey_rev(KEY,key_sel_p);
543 //used_key = key_sel_p;
548 printvar("Used key",used_key
,8);
549 diversifyKey(CSN
,used_key
, div_key
);
550 printvar("Div key", div_key
, 8);
551 printvar("CC_NR:",CCNR
,12);
552 doMAC(CCNR
,12,div_key
, MAC
);
553 printvar("MAC", MAC
, 4);
555 UsbCommand d
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
556 memcpy(d
.d
.asBytes
, MAC
, 4);
560 PrintAndLog("Failed to obtain CC! Aborting");
563 PrintAndLog("Command execute timeout");
569 int CmdHFiClass_iso14443A_write(const char *Cmd
)
571 uint8_t readerType
= 0;
572 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
573 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
574 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
575 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
576 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
579 uint8_t bldata
[8]={0};
583 PrintAndLog("Usage: hf iclass write <Key> <Block> <Data>");
584 PrintAndLog(" sample: hf iclass write 0011223344556677 10 AAAAAAAAAAAAAAAA");
588 if (param_gethex(Cmd
, 0, KEY
, 16))
590 PrintAndLog("KEY must include 16 HEX symbols");
594 blockNo
= param_get8(Cmd
, 1);
597 PrintAndLog("Error: Maximum number of blocks is 32 for iClass 2K Cards!");
600 if (param_gethex(Cmd
, 2, bldata
, 8))
602 PrintAndLog("Block data must include 8 HEX symbols");
606 UsbCommand c
= {CMD_ICLASS_ISO14443A_WRITE
, {0}};
610 if (WaitForResponseTimeout(CMD_ACK
,&resp
,4500)) {
611 uint8_t isOK
= resp
.arg
[0] & 0xff;
612 uint8_t * data
= resp
.d
.asBytes
;
615 memcpy(CCNR
,data
+8,8);
616 PrintAndLog("DEBUG: %s",sprint_hex(CSN
,8));
617 PrintAndLog("DEBUG: %s",sprint_hex(CCNR
,8));
618 PrintAndLog("isOk:%02x", isOK
);
620 PrintAndLog("Command execute timeout");
623 diversifyKey(CSN
,KEY
, div_key
);
625 PrintAndLog("Div Key: %s",sprint_hex(div_key
,8));
626 doMAC(CCNR
, 12,div_key
, MAC
);
628 UsbCommand c2
= {CMD_ICLASS_ISO14443A_WRITE
, {readerType
,blockNo
}};
629 memcpy(c2
.d
.asBytes
, bldata
, 8);
630 memcpy(c2
.d
.asBytes
+8, MAC
, 4);
633 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1500)) {
634 uint8_t isOK
= resp
.arg
[0] & 0xff;
635 uint8_t * data
= resp
.d
.asBytes
;
638 PrintAndLog("isOk:%02x data:%s", isOK
, sprint_hex(data
, 4));
640 PrintAndLog("isOk:%02x", isOK
);
642 PrintAndLog("Command execute timeout");
648 static command_t CommandTable
[] =
650 {"help", CmdHelp
, 1, "This help"},
651 {"list", CmdHFiClassList
, 0, "List iClass history"},
652 {"snoop", CmdHFiClassSnoop
, 0, "Eavesdrop iClass communication"},
653 {"sim", CmdHFiClassSim
, 0, "Simulate iClass tag"},
654 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
655 {"replay",CmdHFiClassReader_Replay
, 0, "Read an iClass tag via Reply Attack"},
656 {"dump", CmdHFiClassReader_Dump
, 0, "Authenticate and Dump iClass tag"},
657 {"write", CmdHFiClass_iso14443A_write
, 0, "Authenticate and Write iClass block"},
658 {"replay", CmdHFiClassReader_Replay
, 0, "Read an iClass tag via Reply Attack"},
659 {"dump", CmdHFiClassReader_Dump
, 0, "Authenticate and Dump iClass tag"},
660 {"write", CmdHFiClass_iso14443A_write
, 0, "Authenticate and Write iClass block"},
661 {NULL
, NULL
, 0, NULL
}
664 int CmdHFiClass(const char *Cmd
)
666 CmdsParse(CommandTable
, Cmd
);
670 int CmdHelp(const char *Cmd
)
672 CmdsHelp(CommandTable
);