1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
4 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
5 // at your option, any later version. See the LICENSE.txt file for the text of
7 //-----------------------------------------------------------------------------
8 // High frequency Legic commands
9 //-----------------------------------------------------------------------------
10 #include "cmdhflegic.h"
12 static int CmdHelp(const char *Cmd
);
14 #define SESSION_IV 0x55
15 #define MAX_LENGTH 1024
17 int usage_legic_calccrc8(void){
18 PrintAndLog("Calculates the legic crc8/crc16 on the input hexbytes.");
19 PrintAndLog("There must be an even number of hexsymbols as input.");
20 PrintAndLog("Usage: hf legic crc8 [h] b <hexbytes> u <uidcrc> c <crc type>");
21 PrintAndLog("Options:");
22 PrintAndLog(" h : this help");
23 PrintAndLog(" b <hexbytes> : hex bytes");
24 PrintAndLog(" u <uidcrc> : MCC hexbyte");
25 PrintAndLog(" c <crc type> : 8|16 bit crc size");
27 PrintAndLog("Samples:");
28 PrintAndLog(" hf legic crc8 b deadbeef1122");
29 PrintAndLog(" hf legic crc8 b deadbeef1122 u 9A c 16");
32 int usage_legic_load(void){
33 PrintAndLog("It loads datasamples from the file `filename` to device memory");
34 PrintAndLog("Usage: hf legic load [h] <file name>");
35 PrintAndLog("Options:");
36 PrintAndLog(" h : this help");
37 PrintAndLog(" <filename> : Name of file to load");
39 PrintAndLog("Samples:");
40 PrintAndLog(" hf legic load filename");
43 int usage_legic_read(void){
44 PrintAndLog("Read data from a legic tag.");
45 PrintAndLog("Usage: hf legic read [h] <offset> <length> <IV>");
46 PrintAndLog("Options:");
47 PrintAndLog(" h : this help");
48 PrintAndLog(" <offset> : offset in data array to start download from");
49 PrintAndLog(" <length> : number of bytes to download");
50 PrintAndLog(" <IV> : (optional) Initialization vector to use");
52 PrintAndLog("Samples:");
53 PrintAndLog(" hf legic read");
54 PrintAndLog(" hf legic read 10 4");
57 int usage_legic_sim(void){
58 PrintAndLog("Missing help text.");
61 int usage_legic_write(void){
62 PrintAndLog(" Write sample buffer to a legic tag. (use after load or read)");
63 PrintAndLog("Usage: hf legic write [h] <offset> <length> <IV>");
64 PrintAndLog("Options:");
65 PrintAndLog(" h : this help");
66 PrintAndLog(" <offset> : offset in data array to start writing from");
67 PrintAndLog(" <length> : number of bytes to write");
68 PrintAndLog(" <IV> : (optional) Initialization vector to use");
70 PrintAndLog("Samples:");
71 PrintAndLog(" hf legic write");
72 PrintAndLog(" hf legic write 10 4");
75 int usage_legic_rawwrite(void){
76 PrintAndLog("Write raw data direct to a specific address on legic tag.");
77 PrintAndLog("Usage: hf legic writeraw [h] <address> <value> <IV>");
78 PrintAndLog("Options:");
79 PrintAndLog(" h : this help");
80 PrintAndLog(" <address> : address to write to");
81 PrintAndLog(" <value> : value to write");
82 PrintAndLog(" <IV> : (optional) Initialization vector to use");
84 PrintAndLog("Samples:");
85 PrintAndLog(" hf legic writeraw");
86 PrintAndLog(" hf legic writeraw 10 4");
89 int usage_legic_fill(void){
90 PrintAndLog("Missing help text.");
95 * Output BigBuf and deobfuscate LEGIC RF tag data.
96 * This is based on information given in the talk held
97 * by Henryk Ploetz and Karsten Nohl at 26c3
99 int CmdLegicDecode(const char *Cmd
) {
101 int i
= 0, k
= 0, segmentNum
= 0, segment_len
= 0, segment_flag
= 0;
102 int crc
= 0, wrp
= 0, wrc
= 0;
103 uint8_t stamp_len
= 0;
104 uint8_t data_buf
[1052]; // receiver buffer
105 char token_type
[5] = {0,0,0,0,0};
107 int bIsSegmented
= 0;
109 // download EML memory, where the "legic read" command puts the data.
110 // copy data from proxmark into buffer
111 GetFromBigBuf(data_buf
,sizeof(data_buf
),0);
112 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2000)){
113 PrintAndLog("Command execute timeout");
117 // Output CDF System area (9 bytes) plus remaining header area (12 bytes)
119 uint32_t calc_crc
= CRC8Legic(data_buf
, 4);
121 PrintAndLog("\nCDF: System Area");
122 PrintAndLog("------------------------------------------------------");
123 PrintAndLog("MCD: %02x, MSN: %02x %02x %02x, MCC: %02x %s",
129 (calc_crc
== crc
) ? "OK":"Fail"
134 dcf
= ((int)data_buf
[6] << 8) | (int)data_buf
[5];
136 // New unwritten media?
139 PrintAndLog("DCF: %d (%02x %02x), Token Type=NM (New Media)",
145 } else if(dcf
> 60000) { // Master token?
149 if(data_buf
[6] == 0xec) {
150 strncpy(token_type
, "XAM", sizeof(token_type
));
152 stamp_len
= 0x0c - (data_buf
[5] >> 4);
154 switch (data_buf
[5] & 0x7f) {
156 strncpy(token_type
, "IAM", sizeof(token_type
));
157 fl
= (0x2f - (data_buf
[5] & 0x7f)) + 1;
160 strncpy(token_type
, "SAM", sizeof(token_type
));
161 fl
= (0x6f - (data_buf
[5] & 0x7f)) + 1;
164 strncpy(token_type
, "GAM", sizeof(token_type
));
165 fl
= (0x7f - (data_buf
[5] & 0x7f)) + 1;
169 stamp_len
= 0xfc - data_buf
[6];
172 PrintAndLog("DCF: %d (%02x %02x), Token Type=%s (OLE=%01u), OL=%02u, FL=%02u",
177 (data_buf
[5] & 0x80 )>> 7,
182 } else { // Is IM(-S) type of card...
184 if(data_buf
[7] == 0x9F && data_buf
[8] == 0xFF) {
186 strncpy(token_type
, "IM-S", sizeof(token_type
));
188 strncpy(token_type
, "IM", sizeof(token_type
));
191 PrintAndLog("DCF: %d (%02x %02x), Token Type=%s (OLE=%01u)",
196 (data_buf
[5]&0x80) >> 7
200 // Makes no sence to show this on blank media...
204 PrintAndLog("WRP=%02u, WRC=%01u, RD=%01u, SSC=%02x",
206 (data_buf
[7] & 0x70) >> 4,
207 (data_buf
[7] & 0x80) >> 7,
212 // Header area is only available on IM-S cards, on master tokens this data is the master token data itself
213 if(bIsSegmented
|| dcf
> 60000) {
215 PrintAndLog("Master token data");
216 PrintAndLog("%s", sprint_hex(data_buf
+8, 14));
218 PrintAndLog("Remaining Header Area");
219 PrintAndLog("%s", sprint_hex(data_buf
+9, 13));
224 uint8_t segCrcBytes
[8] = {0,0,0,0,0,0,0,0};
225 uint32_t segCalcCRC
= 0;
231 PrintAndLog("\nADF: User Area");
232 PrintAndLog("------------------------------------------------------");
236 // Data start point on segmented cards
240 for (segmentNum
=1; segmentNum
< 128; segmentNum
++ )
242 segment_len
= ((data_buf
[i
+1] ^ crc
) & 0x0f) * 256 + (data_buf
[i
] ^ crc
);
243 segment_flag
= ((data_buf
[i
+1] ^ crc
) & 0xf0) >> 4;
244 wrp
= (data_buf
[i
+2] ^ crc
);
245 wrc
= ((data_buf
[i
+3] ^ crc
) & 0x70) >> 4;
247 bool hasWRC
= (wrc
> 0);
248 bool hasWRP
= (wrp
> wrc
);
249 int wrp_len
= (wrp
- wrc
);
250 int remain_seg_payload_len
= (segment_len
- wrp
- 5);
252 // validate segment-crc
253 segCrcBytes
[0]=data_buf
[0]; //uid0
254 segCrcBytes
[1]=data_buf
[1]; //uid1
255 segCrcBytes
[2]=data_buf
[2]; //uid2
256 segCrcBytes
[3]=data_buf
[3]; //uid3
257 segCrcBytes
[4]=(data_buf
[i
] ^ crc
); //hdr0
258 segCrcBytes
[5]=(data_buf
[i
+1] ^ crc
); //hdr1
259 segCrcBytes
[6]=(data_buf
[i
+2] ^ crc
); //hdr2
260 segCrcBytes
[7]=(data_buf
[i
+3] ^ crc
); //hdr3
262 segCalcCRC
= CRC8Legic(segCrcBytes
, 8);
263 segCRC
= data_buf
[i
+4] ^ crc
;
265 PrintAndLog("Segment %02u \nraw header | 0x%02X 0x%02X 0x%02X 0x%02X \nSegment len: %u, Flag: 0x%X (valid:%01u, last:%01u), WRP: %02u, WRC: %02u, RD: %01u, CRC: 0x%02X (%s)",
273 (segment_flag
& 0x4) >> 2,
274 (segment_flag
& 0x8) >> 3,
277 ((data_buf
[i
+3]^crc
) & 0x80) >> 7,
279 ( segCRC
== segCalcCRC
) ? "OK" : "fail"
285 PrintAndLog("WRC protected area: (I %d | K %d| WRC %d)", i
, k
, wrc
);
286 PrintAndLog("\nrow | data");
287 PrintAndLog("-----+------------------------------------------------");
289 for ( k
=i
; k
< (i
+ wrc
); ++k
)
292 print_hex_break( data_buf
+i
, wrc
, 16);
298 PrintAndLog("Remaining write protected area: (I %d | K %d | WRC %d | WRP %d WRP_LEN %d)",i
, k
, wrc
, wrp
, wrp_len
);
299 PrintAndLog("\nrow | data");
300 PrintAndLog("-----+------------------------------------------------");
302 for (k
=i
; k
< (i
+wrp_len
); ++k
)
305 print_hex_break( data_buf
+i
, wrp_len
, 16);
309 // does this one work? (Answer: Only if KGH/BGH is used with BCD encoded card number! So maybe this will show just garbage...)
311 PrintAndLog("Card ID: %2X%02X%02X", data_buf
[i
-4]^crc
, data_buf
[i
-3]^crc
, data_buf
[i
-2]^crc
);
314 PrintAndLog("Remaining segment payload: (I %d | K %d | Remain LEN %d)", i
, k
, remain_seg_payload_len
);
315 PrintAndLog("\nrow | data");
316 PrintAndLog("-----+------------------------------------------------");
318 for ( k
=i
; k
< (i
+remain_seg_payload_len
); ++k
)
321 print_hex_break( data_buf
+i
, remain_seg_payload_len
, 16);
323 i
+= remain_seg_payload_len
;
325 PrintAndLog("-----+------------------------------------------------\n");
327 // end with last segment
328 if (segment_flag
& 0x8) return 0;
334 // Data start point on unsegmented cards
337 wrp
= data_buf
[7] & 0x0F;
338 wrc
= (data_buf
[7] & 0x70) >> 4;
340 bool hasWRC
= (wrc
> 0);
341 bool hasWRP
= (wrp
> wrc
);
342 int wrp_len
= (wrp
- wrc
);
343 int remain_seg_payload_len
= (1024 - 22 - wrp
); // Any chance to get physical card size here!?
345 PrintAndLog("Unsegmented card - WRP: %02u, WRC: %02u, RD: %01u",
348 (data_buf
[7] & 0x80) >> 7
352 PrintAndLog("WRC protected area: (I %d | WRC %d)", i
, wrc
);
353 PrintAndLog("\nrow | data");
354 PrintAndLog("-----+------------------------------------------------");
355 print_hex_break( data_buf
+i
, wrc
, 16);
360 PrintAndLog("Remaining write protected area: (I %d | WRC %d | WRP %d | WRP_LEN %d)", i
, wrc
, wrp
, wrp_len
);
361 PrintAndLog("\nrow | data");
362 PrintAndLog("-----+------------------------------------------------");
363 print_hex_break( data_buf
+ i
, wrp_len
, 16);
366 // does this one work? (Answer: Only if KGH/BGH is used with BCD encoded card number! So maybe this will show just garbage...)
368 PrintAndLog("Card ID: %2X%02X%02X", data_buf
[i
-4], data_buf
[i
-3], data_buf
[i
-2]);
371 PrintAndLog("Remaining segment payload: (I %d | Remain LEN %d)", i
, remain_seg_payload_len
);
372 PrintAndLog("\nrow | data");
373 PrintAndLog("-----+------------------------------------------------");
374 print_hex_break( data_buf
+ i
, remain_seg_payload_len
, 16);
375 i
+= remain_seg_payload_len
;
377 PrintAndLog("-----+------------------------------------------------\n");
383 int CmdLegicRFRead(const char *Cmd
) {
388 char cmdp
= param_getchar(Cmd
, 0);
389 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_read();
391 uint32_t offset
= 0, len
= 0, IV
= 0;
392 sscanf(Cmd
, "%x %x %x", &offset
, &len
, &IV
);
394 // OUT-OF-BOUNDS check
395 if(len
+ offset
> MAX_LENGTH
) len
= MAX_LENGTH
- offset
;
398 PrintAndLog("Current IV: 0x%02x", IV
);
400 UsbCommand c
= {CMD_READER_LEGIC_RF
, {offset
, len
, IV
}};
401 clearCommandBuffer();
406 int CmdLegicLoad(const char *Cmd
) {
408 // iceman: potential bug, where all filepaths or filename which starts with H or h will print the helptext :)
409 char cmdp
= param_getchar(Cmd
, 0);
410 if ( cmdp
== 'H' || cmdp
== 'h' || cmdp
== 0x00) return usage_legic_load();
412 char filename
[FILE_PATH_SIZE
] = {0x00};
413 int len
= strlen(Cmd
);
415 if (len
> FILE_PATH_SIZE
) {
416 PrintAndLog("Filepath too long (was %s bytes), max allowed is %s ", len
, FILE_PATH_SIZE
);
419 memcpy(filename
, Cmd
, len
);
421 FILE *f
= fopen(filename
, "r");
423 PrintAndLog("couldn't open '%s'", Cmd
);
429 uint8_t data
[USB_CMD_DATA_SIZE
] = {0x00};
432 while ( fgets(line
, sizeof(line
), f
) ) {
433 int res
= sscanf(line
, "%x %x %x %x %x %x %x %x",
434 (unsigned int *)&data
[index
],
435 (unsigned int *)&data
[index
+ 1],
436 (unsigned int *)&data
[index
+ 2],
437 (unsigned int *)&data
[index
+ 3],
438 (unsigned int *)&data
[index
+ 4],
439 (unsigned int *)&data
[index
+ 5],
440 (unsigned int *)&data
[index
+ 6],
441 (unsigned int *)&data
[index
+ 7]);
444 PrintAndLog("Error: could not read samples");
450 if ( index
== USB_CMD_DATA_SIZE
){
451 // PrintAndLog("sent %d | %d | %d", index, offset, totalbytes);
452 UsbCommand c
= { CMD_DOWNLOADED_SIM_SAMPLES_125K
, {offset
, 0, 0}};
453 memcpy(c
.d
.asBytes
, data
, sizeof(data
));
454 clearCommandBuffer();
456 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 1500)){
457 PrintAndLog("Command execute timeout");
470 UsbCommand c
= { CMD_DOWNLOADED_SIM_SAMPLES_125K
, {offset
, 0, 0}};
471 memcpy(c
.d
.asBytes
, data
, 8);
472 clearCommandBuffer();
474 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 1500)){
475 PrintAndLog("Command execute timeout");
481 PrintAndLog("loaded %u samples", totalbytes
);
485 int CmdLegicSave(const char *Cmd
) {
486 int requested
= 1024;
489 char filename
[FILE_PATH_SIZE
] = {0x00};
490 uint8_t got
[1024] = {0x00};
492 memset(filename
, 0, FILE_PATH_SIZE
);
494 sscanf(Cmd
, " %s %i %i", filename
, &requested
, &offset
);
496 /* If no length given save entire legic read buffer */
497 /* round up to nearest 8 bytes so the saved data can be used with legicload */
501 if (requested
% 8 != 0) {
502 int remainder
= requested
% 8;
503 requested
= requested
+ 8 - remainder
;
506 if (offset
+ requested
> sizeof(got
)) {
507 PrintAndLog("Tried to read past end of buffer, <bytes> + <offset> > 1024");
511 GetFromBigBuf(got
, requested
, offset
);
512 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2000)){
513 PrintAndLog("Command execute timeout");
517 FILE *f
= fopen(filename
, "w");
519 PrintAndLog("couldn't open '%s'", Cmd
+1);
523 for (int j
= 0; j
< requested
; j
+= 8) {
524 fprintf(f
, "%02x %02x %02x %02x %02x %02x %02x %02x\n",
525 got
[j
+0], got
[j
+1], got
[j
+2], got
[j
+3],
526 got
[j
+4], got
[j
+5], got
[j
+6], got
[j
+7]
529 if (delivered
>= requested
) break;
533 PrintAndLog("saved %u samples", delivered
);
537 //TODO: write a help text (iceman)
538 int CmdLegicRfSim(const char *Cmd
) {
539 UsbCommand c
= {CMD_SIMULATE_TAG_LEGIC_RF
, {6,3,0}};
540 sscanf(Cmd
, " %"lli
" %"lli
" %"lli
, &c
.arg
[0], &c
.arg
[1], &c
.arg
[2]);
541 clearCommandBuffer();
546 int CmdLegicRfWrite(const char *Cmd
) {
549 // offset - in tag memory
550 // length - num of bytes to be written
551 // IV - initialisation vector
553 char cmdp
= param_getchar(Cmd
, 0);
554 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_write();
556 uint32_t offset
= 0, len
= 0, IV
= SESSION_IV
;
558 UsbCommand c
= {CMD_WRITER_LEGIC_RF
, {0,0,0}};
559 int res
= sscanf(Cmd
, "%x %x %x", &offset
, &len
, &IV
);
561 PrintAndLog("Please specify the offset and length as two hex strings and, optionally, the IV also as an hex string");
565 // OUT-OF-BOUNDS check
566 if(len
+ offset
> MAX_LENGTH
) len
= MAX_LENGTH
- offset
;
570 PrintAndLog("Current IV: 0x%02x", IV
);
576 clearCommandBuffer();
581 int CmdLegicRfRawWrite(const char *Cmd
) {
583 char cmdp
= param_getchar(Cmd
, 0);
584 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_rawwrite();
586 uint32_t address
= 0, data
= 0, IV
= SESSION_IV
;
589 UsbCommand c
= { CMD_RAW_WRITER_LEGIC_RF
, {0,0,0} };
590 int res
= sscanf(Cmd
, "%x %x %x", &address
, &data
, &IV
);
592 return usage_legic_rawwrite();
594 // OUT-OF-BOUNDS check
595 if(address
> MAX_LENGTH
)
596 return usage_legic_rawwrite();
599 PrintAndLog("Current IV: 0x%02x", IV
);
605 if (c
.arg
[0] == 0x05 || c
.arg
[0] == 0x06) {
606 PrintAndLog("############# DANGER !! #############");
607 PrintAndLog("# changing the DCF is irreversible #");
608 PrintAndLog("#####################################");
609 PrintAndLog("do youe really want to continue? y(es) n(o)");
610 if (scanf(" %c", &answer
) > 0 && (answer
== 'y' || answer
== 'Y')) {
617 clearCommandBuffer();
622 //TODO: write a help text (iceman)
623 int CmdLegicRfFill(const char *Cmd
) {
624 UsbCommand cmd
= {CMD_WRITER_LEGIC_RF
, {0,0,0} };
625 int res
= sscanf(Cmd
, " 0x%"llx
" 0x%"llx
" 0x%"llx
, &cmd
.arg
[0], &cmd
.arg
[1], &cmd
.arg
[2]);
627 PrintAndLog("Please specify the offset, length and value as two hex strings");
632 UsbCommand c
= {CMD_DOWNLOADED_SIM_SAMPLES_125K
, {0, 0, 0}};
633 memset(c
.d
.asBytes
, cmd
.arg
[2], 48);
635 for(i
= 0; i
< 22; i
++) {
638 clearCommandBuffer();
640 WaitForResponse(CMD_ACK
, NULL
);
642 clearCommandBuffer();
647 int CmdLegicCalcCrc8(const char *Cmd
){
649 uint8_t *data
= NULL
;
650 uint8_t cmdp
= 0, uidcrc
= 0, type
=0;
655 while(param_getchar(Cmd
, cmdp
) != 0x00) {
656 switch(param_getchar(Cmd
, cmdp
)) {
659 // peek at length of the input string so we can
660 // figure out how many elements to malloc in "data"
662 if (param_getptr(Cmd
, &bg
, &en
, cmdp
+1)) {
668 // check that user entered even number of characters
669 // for hex data string
675 // it's possible for user to accidentally enter "b" parameter
676 // more than once - we have to clean previous malloc
677 if (data
) free(data
);
678 data
= malloc(len
>> 1);
679 if ( data
== NULL
) {
680 PrintAndLog("Can't allocate memory. exiting");
685 if (param_gethex(Cmd
, cmdp
+1, data
, len
)) {
695 uidcrc
= param_get8ex(Cmd
, cmdp
+1, 0, 16);
700 type
= param_get8ex(Cmd
, cmdp
+1, 0, 10);
708 PrintAndLog("Unknown parameter '%c'", param_getchar(Cmd
, cmdp
));
716 if (data
) free(data
);
717 return usage_legic_calccrc8();
722 PrintAndLog("LEGIC CRC16: %X", CRC16Legic(data
, len
, uidcrc
));
725 PrintAndLog("LEGIC CRC8: %X", CRC8Legic(data
, len
) );
729 if (data
) free(data
);
733 static command_t CommandTable
[] = {
734 {"help", CmdHelp
, 1, "This help"},
735 {"decode", CmdLegicDecode
, 0, "Display deobfuscated and decoded LEGIC RF tag data (use after hf legic reader)"},
736 {"read", CmdLegicRFRead
, 0, "[offset][length] <iv> -- read bytes from a LEGIC card"},
737 {"save", CmdLegicSave
, 0, "<filename> [<length>] -- Store samples"},
738 {"load", CmdLegicLoad
, 0, "<filename> -- Restore samples"},
739 {"sim", CmdLegicRfSim
, 0, "[phase drift [frame drift [req/resp drift]]] Start tag simulator (use after load or read)"},
740 {"write", CmdLegicRfWrite
,0, "<offset> <length> <iv> -- Write sample buffer (user after load or read)"},
741 {"writeraw",CmdLegicRfRawWrite
, 0, "<address> <value> <iv> -- Write direct to address"},
742 {"fill", CmdLegicRfFill
, 0, "<offset> <length> <value> -- Fill/Write tag with constant value"},
743 {"crc8", CmdLegicCalcCrc8
, 1, "Calculate Legic CRC8 over given hexbytes"},
744 {NULL
, NULL
, 0, NULL
}
747 int CmdHFLegic(const char *Cmd
) {
748 clearCommandBuffer();
749 CmdsParse(CommandTable
, Cmd
);
753 int CmdHelp(const char *Cmd
) {
754 CmdsHelp(CommandTable
);