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 MAX_LENGTH 1024
16 int usage_legic_calccrc(void){
17 PrintAndLog("Calculates the legic crc8/crc16 on the given data.");
18 PrintAndLog("There must be an even number of hexsymbols as input.");
19 PrintAndLog("Usage: hf legic crc [h] d <data> u <uidcrc> c <8|16>");
20 PrintAndLog("Options:");
21 PrintAndLog(" h : this help");
22 PrintAndLog(" d <data> : (hex symbols) bytes to calculate crc over");
23 PrintAndLog(" u <uidcrc> : MCC hexbyte");
24 PrintAndLog(" c <8|16> : Crc type");
26 PrintAndLog("Samples:");
27 PrintAndLog(" hf legic crc b deadbeef1122");
28 PrintAndLog(" hf legic crc b deadbeef1122 u 9A c 16");
31 int usage_legic_rdmem(void){
32 PrintAndLog("Read data from a legic tag.");
33 PrintAndLog("Usage: hf legic rdmem [h] <offset> <length> <IV>");
34 PrintAndLog("Options:");
35 PrintAndLog(" h : this help");
36 PrintAndLog(" <offset> : (hex) offset in data array to start download from");
37 PrintAndLog(" <length> : (hex) number of bytes to read");
38 PrintAndLog(" <IV> : (hex) (optional) Initialization vector to use. Must be odd and 7bits max");
40 PrintAndLog("Samples:");
41 PrintAndLog(" hf legic rdmem 0 16 - reads from byte[0] 0x16 bytes(system header)");
42 PrintAndLog(" hf legic rdmem 0 4 55 - reads from byte[0] 0x4 bytes with IV 0x55");
43 PrintAndLog(" hf legic rdmem 0 100 55 - reads 0x100 bytes with IV 0x55");
46 int usage_legic_sim(void){
47 PrintAndLog("Simulates a LEGIC Prime tag. MIM22, MIM256, MIM1024 types can be emulated");
48 PrintAndLog("Use eload/esave to upload a dump into emulator memory");
49 PrintAndLog("Usage: hf legic sim [h] <tagtype> <phase> <frame> <reqresp>");
50 PrintAndLog("Options:");
51 PrintAndLog(" h : this help");
52 PrintAndLog(" <tagtype> : 0 = MIM22");
53 PrintAndLog(" : 1 = MIM256 (default)");
54 PrintAndLog(" : 2 = MIM1024");
55 PrintAndLog(" <phase> : phase drift");
56 PrintAndLog(" <frame> : frame drift");
57 PrintAndLog(" <reqresp> : reqresp drift");
59 PrintAndLog("Samples:");
60 PrintAndLog(" hf legic sim");
61 PrintAndLog(" hf legic sim ");
64 int usage_legic_write(void){
65 PrintAndLog("Write data to a LEGIC Prime tag. It autodetects tagsize to make sure size");
66 PrintAndLog("Usage: hf legic write [h] o <offset> d <data (hex symbols)>");
67 PrintAndLog("Options:");
68 PrintAndLog(" h : this help");
69 PrintAndLog(" o <offset> : (hex) offset in data array to start writing");
70 //PrintAndLog(" <IV> : (optional) Initialization vector to use (ODD and 7bits)");
71 PrintAndLog(" d <data> : (hex symbols) bytes to write ");
73 PrintAndLog("Samples:");
74 PrintAndLog(" hf legic write o 10 d 11223344 - Write 0x11223344 starting from offset 0x10");
77 int usage_legic_reader(void){
78 PrintAndLog("Read UID and type information from a legic tag.");
79 PrintAndLog("Usage: hf legic reader [h]");
80 PrintAndLog("Options:");
81 PrintAndLog(" h : this help");
83 PrintAndLog("Samples:");
84 PrintAndLog(" hf legic reader");
87 int usage_legic_info(void){
88 PrintAndLog("Reads information from a legic prime tag.");
89 PrintAndLog("Shows systemarea, user areas etc");
90 PrintAndLog("Usage: hf legic info [h]");
91 PrintAndLog("Options:");
92 PrintAndLog(" h : this help");
94 PrintAndLog("Samples:");
95 PrintAndLog(" hf legic info");
98 int usage_legic_dump(void){
99 PrintAndLog("Reads all pages from LEGIC Prime MIM22, MIM256, MIM1024");
100 PrintAndLog("and saves binary dump into the file `filename.bin` or `cardUID.bin`");
101 PrintAndLog("It autodetects card type.\n");
102 PrintAndLog("Usage: hf legic dump [h] o <filename w/o .bin>");
103 PrintAndLog("Options:");
104 PrintAndLog(" h : this help");
105 PrintAndLog(" o <filename> : filename w/o '.bin' to dump bytes");
107 PrintAndLog("Samples:");
108 PrintAndLog(" hf legic dump");
109 PrintAndLog(" hf legic dump o myfile");
112 int usage_legic_restore(void){
113 PrintAndLog("Reads binary file and it autodetects card type and verifies that the file has the same size");
114 PrintAndLog("Then write the data back to card. All bytes except the first 7bytes [UID(4) MCC(1) DCF(2)]\n");
115 PrintAndLog("Usage: hf legic restore [h] i <filename w/o .bin>");
116 PrintAndLog("Options:");
117 PrintAndLog(" h : this help");
118 PrintAndLog(" i <filename> : filename w/o '.bin' to restore bytes on to card from");
120 PrintAndLog("Samples:");
121 PrintAndLog(" hf legic restore i myfile");
124 int usage_legic_eload(void){
125 PrintAndLog("It loads binary dump from the file `filename.bin`");
126 PrintAndLog("Usage: hf legic eload [h] [card memory] <file name w/o `.bin`>");
127 PrintAndLog("Options:");
128 PrintAndLog(" h : this help");
129 PrintAndLog(" [card memory] : 0 = MIM22");
130 PrintAndLog(" : 1 = MIM256 (default)");
131 PrintAndLog(" : 2 = MIM1024");
132 PrintAndLog(" <filename> : filename w/o .bin to load");
134 PrintAndLog("Samples:");
135 PrintAndLog(" hf legic eload 2 myfile");
138 int usage_legic_esave(void){
139 PrintAndLog("It saves binary dump into the file `filename.bin` or `cardID.bin`");
140 PrintAndLog(" Usage: hf legic esave [h] [card memory] [file name w/o `.bin`]");
141 PrintAndLog("Options:");
142 PrintAndLog(" h : this help");
143 PrintAndLog(" [card memory] : 0 = MIM22");
144 PrintAndLog(" : 1 = MIM256 (default)");
145 PrintAndLog(" : 2 = MIM1024");
146 PrintAndLog(" <filename> : filename w/o .bin to load");
148 PrintAndLog("Samples:");
149 PrintAndLog(" hf legic esave 2 myfile");
152 int usage_legic_wipe(void){
153 PrintAndLog("Fills a legic tag memory with zeros. From byte7 and to the end.");
154 PrintAndLog(" Usage: hf legic wipe [h]");
155 PrintAndLog("Options:");
156 PrintAndLog(" h : this help");
158 PrintAndLog("Samples:");
159 PrintAndLog(" hf legic wipe");
163 * Output BigBuf and deobfuscate LEGIC RF tag data.
164 * This is based on information given in the talk held
165 * by Henryk Ploetz and Karsten Nohl at 26c3
167 int CmdLegicInfo(const char *Cmd
) {
169 char cmdp
= param_getchar(Cmd
, 0);
170 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_info();
172 int i
= 0, k
= 0, segmentNum
= 0, segment_len
= 0, segment_flag
= 0;
173 int crc
= 0, wrp
= 0, wrc
= 0;
174 uint8_t stamp_len
= 0;
175 uint8_t data
[1024]; // receiver buffer
176 char token_type
[5] = {0,0,0,0,0};
178 int bIsSegmented
= 0;
180 CmdLegicRdmem("0 22 55");
182 // copy data from device
183 GetEMLFromBigBuf(data
, sizeof(data
), 0);
184 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2000)){
185 PrintAndLog("Command execute timeout");
189 // Output CDF System area (9 bytes) plus remaining header area (12 bytes)
191 uint32_t calc_crc
= CRC8Legic(data
, 4);
193 PrintAndLog("\nCDF: System Area");
194 PrintAndLog("------------------------------------------------------");
195 PrintAndLog("MCD: %02x, MSN: %02x %02x %02x, MCC: %02x %s",
201 (calc_crc
== crc
) ? "OK":"Fail"
204 // MCD = Manufacturer ID (should be list meaning something?)
207 dcf
= ((int)data
[6] << 8) | (int)data
[5];
209 // New unwritten media?
212 PrintAndLog("DCF: %d (%02x %02x), Token Type=NM (New Media)",
218 } else if (dcf
> 60000) { // Master token?
222 if(data
[6] == 0xec) {
223 strncpy(token_type
, "XAM", sizeof(token_type
));
225 stamp_len
= 0x0c - (data
[5] >> 4);
227 switch (data
[5] & 0x7f) {
229 strncpy(token_type
, "IAM", sizeof(token_type
));
230 fl
= (0x2f - (data
[5] & 0x7f)) + 1;
233 strncpy(token_type
, "SAM", sizeof(token_type
));
234 fl
= (0x6f - (data
[5] & 0x7f)) + 1;
237 strncpy(token_type
, "GAM", sizeof(token_type
));
238 fl
= (0x7f - (data
[5] & 0x7f)) + 1;
242 stamp_len
= 0xfc - data
[6];
245 PrintAndLog("DCF: %d (%02x %02x), Token Type=%s (OLE=%01u), OL=%02u, FL=%02u",
250 (data
[5] & 0x80 )>> 7,
255 } else { // Is IM(-S) type of card...
257 if(data
[7] == 0x9F && data
[8] == 0xFF) {
259 strncpy(token_type
, "IM-S", sizeof(token_type
));
261 strncpy(token_type
, "IM", sizeof(token_type
));
264 PrintAndLog("DCF: %d (%02x %02x), Token Type=%s (OLE=%01u)",
273 // Makes no sence to show this on blank media...
277 PrintAndLog("WRP=%02u, WRC=%01u, RD=%01u, SSC=%02x",
279 (data
[7] & 0x70) >> 4,
280 (data
[7] & 0x80) >> 7,
285 // Header area is only available on IM-S cards, on master tokens this data is the master token data itself
286 if(bIsSegmented
|| dcf
> 60000) {
288 PrintAndLog("Master token data");
289 PrintAndLog("%s", sprint_hex(data
+8, 14));
291 PrintAndLog("Remaining Header Area");
292 PrintAndLog("%s", sprint_hex(data
+9, 13));
297 uint8_t segCrcBytes
[8] = {0,0,0,0,0,0,0,0};
298 uint32_t segCalcCRC
= 0;
304 PrintAndLog("\nADF: User Area");
305 PrintAndLog("------------------------------------------------------");
309 // Data start point on segmented cards
313 for (segmentNum
=1; segmentNum
< 128; segmentNum
++ )
315 segment_len
= ((data
[i
+1] ^ crc
) & 0x0f) * 256 + (data
[i
] ^ crc
);
316 segment_flag
= ((data
[i
+1] ^ crc
) & 0xf0) >> 4;
317 wrp
= (data
[i
+2] ^ crc
);
318 wrc
= ((data
[i
+3] ^ crc
) & 0x70) >> 4;
320 bool hasWRC
= (wrc
> 0);
321 bool hasWRP
= (wrp
> wrc
);
322 int wrp_len
= (wrp
- wrc
);
323 int remain_seg_payload_len
= (segment_len
- wrp
- 5);
325 // validate segment-crc
326 segCrcBytes
[0]=data
[0]; //uid0
327 segCrcBytes
[1]=data
[1]; //uid1
328 segCrcBytes
[2]=data
[2]; //uid2
329 segCrcBytes
[3]=data
[3]; //uid3
330 segCrcBytes
[4]=(data
[i
] ^ crc
); //hdr0
331 segCrcBytes
[5]=(data
[i
+1] ^ crc
); //hdr1
332 segCrcBytes
[6]=(data
[i
+2] ^ crc
); //hdr2
333 segCrcBytes
[7]=(data
[i
+3] ^ crc
); //hdr3
335 segCalcCRC
= CRC8Legic(segCrcBytes
, 8);
336 segCRC
= data
[i
+4] ^ crc
;
338 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)",
346 (segment_flag
& 0x4) >> 2,
347 (segment_flag
& 0x8) >> 3,
350 ((data
[i
+3]^crc
) & 0x80) >> 7,
352 ( segCRC
== segCalcCRC
) ? "OK" : "fail"
358 PrintAndLog("WRC protected area: (I %d | K %d| WRC %d)", i
, k
, wrc
);
359 PrintAndLog("\nrow | data");
360 PrintAndLog("-----+------------------------------------------------");
362 for ( k
=i
; k
< (i
+ wrc
); ++k
)
365 print_hex_break( data
+i
, wrc
, 16);
371 PrintAndLog("Remaining write protected area: (I %d | K %d | WRC %d | WRP %d WRP_LEN %d)",i
, k
, wrc
, wrp
, wrp_len
);
372 PrintAndLog("\nrow | data");
373 PrintAndLog("-----+------------------------------------------------");
375 for (k
=i
; k
< (i
+wrp_len
); ++k
)
378 print_hex_break( data
+i
, wrp_len
, 16);
382 // does this one work? (Answer: Only if KGH/BGH is used with BCD encoded card number! So maybe this will show just garbage...)
384 PrintAndLog("Card ID: %2X%02X%02X", data
[i
-4]^crc
, data
[i
-3]^crc
, data
[i
-2]^crc
);
387 PrintAndLog("Remaining segment payload: (I %d | K %d | Remain LEN %d)", i
, k
, remain_seg_payload_len
);
388 PrintAndLog("\nrow | data");
389 PrintAndLog("-----+------------------------------------------------");
391 for ( k
=i
; k
< (i
+remain_seg_payload_len
); ++k
)
394 print_hex_break( data
+i
, remain_seg_payload_len
, 16);
396 i
+= remain_seg_payload_len
;
398 PrintAndLog("-----+------------------------------------------------\n");
400 // end with last segment
401 if (segment_flag
& 0x8) return 0;
407 // Data start point on unsegmented cards
410 wrp
= data
[7] & 0x0F;
411 wrc
= (data
[7] & 0x70) >> 4;
413 bool hasWRC
= (wrc
> 0);
414 bool hasWRP
= (wrp
> wrc
);
415 int wrp_len
= (wrp
- wrc
);
416 int remain_seg_payload_len
= (1024 - 22 - wrp
); // Any chance to get physical card size here!?
418 PrintAndLog("Unsegmented card - WRP: %02u, WRC: %02u, RD: %01u",
421 (data
[7] & 0x80) >> 7
425 PrintAndLog("WRC protected area: (I %d | WRC %d)", i
, wrc
);
426 PrintAndLog("\nrow | data");
427 PrintAndLog("-----+------------------------------------------------");
428 print_hex_break( data
+i
, wrc
, 16);
433 PrintAndLog("Remaining write protected area: (I %d | WRC %d | WRP %d | WRP_LEN %d)", i
, wrc
, wrp
, wrp_len
);
434 PrintAndLog("\nrow | data");
435 PrintAndLog("-----+------------------------------------------------");
436 print_hex_break( data
+ i
, wrp_len
, 16);
439 // does this one work? (Answer: Only if KGH/BGH is used with BCD encoded card number! So maybe this will show just garbage...)
441 PrintAndLog("Card ID: %2X%02X%02X", data
[i
-4], data
[i
-3], data
[i
-2]);
444 PrintAndLog("Remaining segment payload: (I %d | Remain LEN %d)", i
, remain_seg_payload_len
);
445 PrintAndLog("\nrow | data");
446 PrintAndLog("-----+------------------------------------------------");
447 print_hex_break( data
+ i
, remain_seg_payload_len
, 16);
448 i
+= remain_seg_payload_len
;
450 PrintAndLog("-----+------------------------------------------------\n");
457 // offset in data memory
458 // number of bytes to read
459 int CmdLegicRdmem(const char *Cmd
) {
461 char cmdp
= param_getchar(Cmd
, 0);
462 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_rdmem();
464 uint32_t offset
= 0, len
= 0, IV
= 1;
465 sscanf(Cmd
, "%x %x %x", &offset
, &len
, &IV
);
468 legic_card_select_t card
;
469 if (legic_get_type(&card
)) {
470 PrintAndLog("Failed to identify tagtype");
474 legic_print_type(card
.cardsize
, 0);
476 // OUT-OF-BOUNDS check
477 // UID 4 bytes can't be written to.
478 if ( len
+ offset
>= card
.cardsize
) {
479 len
= card
.cardsize
- offset
;
480 PrintAndLog("Out-of-bounds, Cardsize = %d, Trunc offset+len = %d", card
.cardsize
, len
+ offset
);
485 UsbCommand c
= {CMD_READER_LEGIC_RF
, {offset
, len
, IV
}};
486 clearCommandBuffer();
489 if ( !WaitForResponseTimeout(CMD_ACK
, &resp
, 3000) ) {
490 PrintAndLog("command execution time out");
494 uint8_t isOK
= resp
.arg
[0] & 0xFF;
495 uint16_t readlen
= resp
.arg
[1];
497 PrintAndLog("failed reading tag");
501 uint8_t *data
= malloc(readlen
);
503 PrintAndLog("Cannot allocate memory");
507 if ( readlen
!= len
)
508 PrintAndLog("Fail, only managed to read 0x%02X bytes", readlen
);
510 // copy data from device
511 GetEMLFromBigBuf(data
, readlen
, 0);
512 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2500)){
513 PrintAndLog("Command execute timeout");
518 PrintAndLog("\n ## | 0 1 2 3 4 5 6 7 8 9 A B C D E F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F");
519 PrintAndLog("-----+------------------------------------------------------------------------------------------------");
520 print_hex_break( data
, readlen
, 32);
525 // should say which tagtype
526 // should load a tag to device mem.
527 // int phase, int frame, int reqresp
528 int CmdLegicRfSim(const char *Cmd
) {
529 UsbCommand c
= {CMD_SIMULATE_TAG_LEGIC_RF
, {6,3,0}};
530 sscanf(Cmd
, " %"lli
" %"lli
" %"lli
, &c
.arg
[0], &c
.arg
[1], &c
.arg
[2]);
531 clearCommandBuffer();
536 int CmdLegicRfWrite(const char *Cmd
) {
538 uint8_t *data
= NULL
;
542 uint32_t offset
= 0, IV
= 0x55;
544 while(param_getchar(Cmd
, cmdp
) != 0x00) {
545 switch(param_getchar(Cmd
, cmdp
)) {
548 // peek at length of the input string so we can
549 // figure out how many elements to malloc in "data"
551 if (param_getptr(Cmd
, &bg
, &en
, cmdp
+1)) {
557 // check that user entered even number of characters
558 // for hex data string
564 // limit number of bytes to write. This is not a 'restore' command.
565 if ( (len
>>1) > 100 ){
566 PrintAndLog("Max bound on 100bytes to write a one time.");
567 PrintAndLog("Use the 'hf legic restore' command if you want to write the whole tag at once");
571 // it's possible for user to accidentally enter "b" parameter
572 // more than once - we have to clean previous malloc
576 data
= malloc(len
>> 1);
577 if ( data
== NULL
) {
578 PrintAndLog("Can't allocate memory. exiting");
583 if (param_gethex(Cmd
, cmdp
+1, data
, len
)) {
593 offset
= param_get32ex(Cmd
, cmdp
+1, 4, 16);
601 PrintAndLog("Unknown parameter '%c'", param_getchar(Cmd
, cmdp
));
611 return usage_legic_write();
615 legic_card_select_t card
;
616 if (legic_get_type(&card
)) {
617 PrintAndLog("Failed to identify tagtype");
621 legic_print_type(card
.cardsize
, 0);
623 // OUT-OF-BOUNDS checks
624 // UID 4+1 bytes can't be written to.
626 PrintAndLog("Out-of-bounds, bytes 0-1-2-3-4 can't be written to. Offset = %d", offset
);
630 if ( len
+ offset
>= card
.cardsize
) {
631 PrintAndLog("Out-of-bounds, Cardsize = %d, [offset+len = %d ]", card
.cardsize
, len
+ offset
);
635 if (offset
== 5 || offset
== 6) {
636 PrintAndLog("############# DANGER ################");
637 PrintAndLog("# changing the DCF is irreversible #");
638 PrintAndLog("#####################################");
639 PrintAndLog("do you really want to continue? y(es) n(o)");
641 sscanf(" %c", &answer
);
642 bool exit
= !(answer
== 'n' || answer
== 'N');
645 printf("ICE DCF: %c answer, %d\n", answer
, exit
);
651 PrintAndLog("Writing to tag");
653 UsbCommand c
= {CMD_WRITER_LEGIC_RF
, {offset
, len
, IV
}};
654 memcpy(c
.d
.asBytes
, data
, len
);
656 clearCommandBuffer();
659 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 2000)) {
660 PrintAndLog("command execution time out");
663 uint8_t isOK
= resp
.arg
[0] & 0xFF;
665 PrintAndLog("failed writing tag");
672 int CmdLegicCalcCrc(const char *Cmd
){
674 uint8_t *data
= NULL
;
675 uint8_t cmdp
= 0, uidcrc
= 0, type
=0;
680 while(param_getchar(Cmd
, cmdp
) != 0x00) {
681 switch(param_getchar(Cmd
, cmdp
)) {
684 // peek at length of the input string so we can
685 // figure out how many elements to malloc in "data"
687 if (param_getptr(Cmd
, &bg
, &en
, cmdp
+1)) {
693 // check that user entered even number of characters
694 // for hex data string
700 // it's possible for user to accidentally enter "b" parameter
701 // more than once - we have to clean previous malloc
702 if (data
) free(data
);
703 data
= malloc(len
>> 1);
704 if ( data
== NULL
) {
705 PrintAndLog("Can't allocate memory. exiting");
710 if (param_gethex(Cmd
, cmdp
+1, data
, len
)) {
720 uidcrc
= param_get8ex(Cmd
, cmdp
+1, 0, 16);
725 type
= param_get8ex(Cmd
, cmdp
+1, 0, 10);
733 PrintAndLog("Unknown parameter '%c'", param_getchar(Cmd
, cmdp
));
741 if (data
) free(data
);
742 return usage_legic_calccrc();
747 PrintAndLog("Legic crc16: %X", CRC16Legic(data
, len
, uidcrc
));
750 PrintAndLog("Legic crc8: %X", CRC8Legic(data
, len
) );
754 if (data
) free(data
);
758 int legic_print_type(uint32_t tagtype
, uint8_t spaces
){
761 char *spacer
= spc
+ (10-spaces
);
764 PrintAndLog("%sTYPE : MIM%d card (outdated)", spacer
, tagtype
);
765 else if ( tagtype
== 256 )
766 PrintAndLog("%sTYPE : MIM%d card (234 bytes)", spacer
, tagtype
);
767 else if ( tagtype
== 1024 )
768 PrintAndLog("%sTYPE : MIM%d card (1002 bytes)", spacer
, tagtype
);
770 PrintAndLog("%sTYPE : Unknown %06x", spacer
, tagtype
);
773 int legic_get_type(legic_card_select_t
*card
){
775 if ( card
== NULL
) return 1;
777 UsbCommand c
= {CMD_LEGIC_INFO
, {0,0,0}};
778 clearCommandBuffer();
781 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 500))
784 uint8_t isOK
= resp
.arg
[0] & 0xFF;
788 memcpy(card
, (legic_card_select_t
*)resp
.d
.asBytes
, sizeof(legic_card_select_t
));
791 void legic_chk_iv(uint32_t *iv
){
792 if ( (*iv
& 0x7F) != *iv
){
794 PrintAndLog("Truncating IV to 7bits, %u", *iv
);
797 if ( (*iv
& 1) == 0 ){
799 PrintAndLog("LSB of IV must be SET %u", *iv
);
802 void legic_seteml(uint8_t *src
, uint32_t offset
, uint32_t numofbytes
) {
804 UsbCommand c
= {CMD_LEGIC_ESET
, {0, 0, 0}};
805 for(size_t i
= 0; i
< numofbytes
; i
+= USB_CMD_DATA_SIZE
) {
807 len
= MIN((numofbytes
- i
), USB_CMD_DATA_SIZE
);
808 c
.arg
[0] = i
; // offset
809 c
.arg
[1] = len
; // number of bytes
810 memcpy(c
.d
.asBytes
, src
+i
, len
);
811 clearCommandBuffer();
816 int HFLegicReader(const char *Cmd
, bool verbose
) {
818 char cmdp
= param_getchar(Cmd
, 0);
819 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_reader();
821 legic_card_select_t card
;
822 switch(legic_get_type(&card
)){
824 if ( verbose
) PrintAndLog("command execution time out");
828 if ( verbose
) PrintAndLog("legic card select failed");
832 PrintAndLog(" UID : %s", sprint_hex(card
.uid
, sizeof(card
.uid
)));
833 legic_print_type(card
.cardsize
, 0);
836 int CmdLegicReader(const char *Cmd
){
837 return HFLegicReader(Cmd
, TRUE
);
840 int CmdLegicDump(const char *Cmd
){
843 char filename
[FILE_PATH_SIZE
] = {0x00};
844 char *fnameptr
= filename
;
850 memset(filename
, 0, sizeof(filename
));
852 while(param_getchar(Cmd
, cmdp
) != 0x00) {
853 switch(param_getchar(Cmd
, cmdp
)) {
856 return usage_legic_dump();
859 fileNlen
= param_getstr(Cmd
, cmdp
+1, filename
);
862 if (fileNlen
> FILE_PATH_SIZE
-5)
863 fileNlen
= FILE_PATH_SIZE
-5;
867 PrintAndLog("Unknown parameter '%c'", param_getchar(Cmd
, cmdp
));
875 if(errors
) return usage_legic_dump();
878 legic_card_select_t card
;
879 if (legic_get_type(&card
)) {
880 PrintAndLog("Failed to identify tagtype");
883 dumplen
= card
.cardsize
;
885 legic_print_type(dumplen
, 0);
886 PrintAndLog("Reading tag memory...");
888 UsbCommand c
= {CMD_READER_LEGIC_RF
, {0x00, dumplen
, 0x55}};
889 clearCommandBuffer();
892 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 3000)) {
893 PrintAndLog("Command execute time-out");
897 uint8_t isOK
= resp
.arg
[0] & 0xFF;
899 PrintAndLog("Failed dumping tag data");
903 uint16_t readlen
= resp
.arg
[1];
904 uint8_t *data
= malloc(readlen
);
906 PrintAndLog("Fail, cannot allocate memory");
909 memset(data
, 0, readlen
);
911 if ( readlen
!= dumplen
)
912 PrintAndLog("Fail, only managed to read 0x%02X bytes of 0x%02X", readlen
, dumplen
);
914 // copy data from device
915 GetEMLFromBigBuf(data
, readlen
, 0);
916 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2500)) {
917 PrintAndLog("Fail, transfer from device time-out");
922 // user supplied filename?
924 sprintf(fnameptr
,"%02X%02X%02X%02X.bin", data
[0], data
[1], data
[2], data
[3]);
926 sprintf(fnameptr
+ fileNlen
,".bin");
928 if ((f
= fopen(filename
,"wb")) == NULL
) {
929 PrintAndLog("Could not create file name %s", filename
);
934 fwrite(data
, 1, readlen
, f
);
937 PrintAndLog("Wrote %d bytes to %s", readlen
, filename
);
941 int CmdLegicRestore(const char *Cmd
){
944 char filename
[FILE_PATH_SIZE
] = {0x00};
945 char *fnameptr
= filename
;
951 memset(filename
, 0, sizeof(filename
));
953 while(param_getchar(Cmd
, cmdp
) != 0x00) {
954 switch(param_getchar(Cmd
, cmdp
)) {
961 fileNlen
= param_getstr(Cmd
, cmdp
+1, filename
);
967 if (fileNlen
> FILE_PATH_SIZE
-5)
968 fileNlen
= FILE_PATH_SIZE
-5;
972 PrintAndLog("Unknown parameter '%c'", param_getchar(Cmd
, cmdp
));
980 if(errors
) return usage_legic_restore();
983 legic_card_select_t card
;
984 if (legic_get_type(&card
)) {
985 PrintAndLog("Failed to identify tagtype");
988 numofbytes
= card
.cardsize
;
991 uint8_t *data
= malloc(numofbytes
);
993 PrintAndLog("Fail, cannot allocate memory");
996 memset(data
, 0, numofbytes
);
998 legic_print_type(numofbytes
, 0);
1001 fnameptr
+= fileNlen
;
1002 sprintf(fnameptr
, ".bin");
1004 if ((f
= fopen(filename
,"rb")) == NULL
) {
1005 PrintAndLog("File %s not found or locked", filename
);
1009 // verify size of dumpfile is the same as card.
1010 fseek(f
, 0, SEEK_END
); // seek to end of file
1011 size_t filesize
= ftell(f
); // get current file pointer
1012 fseek(f
, 0, SEEK_SET
); // seek back to beginning of file
1014 if ( filesize
!= numofbytes
) {
1015 PrintAndLog("Fail, filesize and cardsize is not equal. [%u != %u]", filesize
, numofbytes
);
1022 size_t bytes_read
= fread(data
, 1, numofbytes
, f
);
1023 if ( bytes_read
== 0){
1024 PrintAndLog("File reading error");
1031 PrintAndLog("Restoring to card");
1033 // transfer to device
1035 UsbCommand c
= {CMD_WRITER_LEGIC_RF
, {0, 0, 0x55}};
1037 for(size_t i
= 7; i
< numofbytes
; i
+= USB_CMD_DATA_SIZE
) {
1039 len
= MIN((numofbytes
- i
), USB_CMD_DATA_SIZE
);
1040 c
.arg
[0] = i
; // offset
1041 c
.arg
[1] = len
; // number of bytes
1042 memcpy(c
.d
.asBytes
, data
+i
, len
);
1043 clearCommandBuffer();
1046 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4000)) {
1047 PrintAndLog("command execution time out");
1051 uint8_t isOK
= resp
.arg
[0] & 0xFF;
1053 PrintAndLog("failed writing tag [msg = %u]", resp
.arg
[1] & 0xFF);
1057 PrintAndLog("Wrote chunk [offset %d | len %d | total %d", i
, len
, i
+len
);
1061 PrintAndLog("\nWrote %d bytes to card from file %s", numofbytes
, filename
);
1065 int CmdLegicELoad(const char *Cmd
) {
1067 char filename
[FILE_PATH_SIZE
];
1068 char *fnameptr
= filename
;
1069 int len
, numofbytes
;
1070 int nameParamNo
= 1;
1072 char cmdp
= param_getchar(Cmd
, 0);
1073 if ( cmdp
== 'h' || cmdp
== 'H' || cmdp
== 0x00)
1074 return usage_legic_eload();
1077 case '0' : numofbytes
= 22; break;
1079 case '\0': numofbytes
= 256; break;
1080 case '2' : numofbytes
= 1024; break;
1081 default : numofbytes
= 256; nameParamNo
= 0;break;
1085 uint8_t *data
= malloc(numofbytes
);
1087 PrintAndLog("Fail, cannot allocate memory");
1090 memset(data
, 0, numofbytes
);
1093 len
= param_getstr(Cmd
, nameParamNo
, filename
);
1094 if (len
> FILE_PATH_SIZE
- 5)
1095 len
= FILE_PATH_SIZE
- 5;
1097 sprintf(fnameptr
, ".bin");
1100 if ((f
= fopen(filename
,"rb")) == NULL
) {
1101 PrintAndLog("File %s not found or locked", filename
);
1107 size_t bytes_read
= fread(data
, 1, numofbytes
, f
);
1108 if ( bytes_read
== 0){
1109 PrintAndLog("File reading error");
1116 // transfer to device
1117 legic_seteml(data
, 0, numofbytes
);
1120 PrintAndLog("\nLoaded %d bytes from file: %s to emulator memory", numofbytes
, filename
);
1124 int CmdLegicESave(const char *Cmd
) {
1126 char filename
[FILE_PATH_SIZE
];
1127 char *fnameptr
= filename
;
1128 int fileNlen
, numofbytes
, nameParamNo
= 1;
1130 memset(filename
, 0, sizeof(filename
));
1132 char cmdp
= param_getchar(Cmd
, 0);
1134 if ( cmdp
== 'h' || cmdp
== 'H' || cmdp
== 0x00)
1135 return usage_legic_esave();
1138 case '0' : numofbytes
= 22; break;
1140 case '\0': numofbytes
= 256; break;
1141 case '2' : numofbytes
= 1024; break;
1142 default : numofbytes
= 256; nameParamNo
= 0; break;
1145 fileNlen
= param_getstr(Cmd
, nameParamNo
, filename
);
1147 if (fileNlen
> FILE_PATH_SIZE
- 5)
1148 fileNlen
= FILE_PATH_SIZE
- 5;
1151 uint8_t *data
= malloc(numofbytes
);
1153 PrintAndLog("Fail, cannot allocate memory");
1156 memset(data
, 0, numofbytes
);
1158 // download emulator memory
1159 PrintAndLog("Reading emulator memory...");
1160 GetEMLFromBigBuf(data
, numofbytes
, 0);
1161 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2500)) {
1162 PrintAndLog("Fail, transfer from device time-out");
1167 // user supplied filename?
1169 sprintf(fnameptr
,"%02X%02X%02X%02X.bin", data
[0], data
[1], data
[2], data
[3]);
1171 sprintf(fnameptr
+ fileNlen
,".bin");
1174 if ((f
= fopen(filename
,"wb")) == NULL
) {
1175 PrintAndLog("Could not create file name %s", filename
);
1179 fwrite(data
, 1, numofbytes
, f
);
1182 PrintAndLog("\nSaved %d bytes from emulator memory to file: %s", numofbytes
, filename
);
1186 int CmdLegicWipe(const char *Cmd
){
1188 char cmdp
= param_getchar(Cmd
, 0);
1190 if ( cmdp
== 'h' || cmdp
== 'H') return usage_legic_wipe();
1193 legic_card_select_t card
;
1194 if (legic_get_type(&card
)) {
1195 PrintAndLog("Failed to identify tagtype");
1200 uint8_t *data
= malloc(card
.cardsize
);
1202 PrintAndLog("Fail, cannot allocate memory");
1205 memset(data
, 0, card
.cardsize
);
1207 legic_print_type(card
.cardsize
, 0);
1211 // transfer to device
1213 UsbCommand c
= {CMD_WRITER_LEGIC_RF
, {0, 0, 0x55}};
1215 for(size_t i
= 7; i
< card
.cardsize
; i
+= USB_CMD_DATA_SIZE
) {
1218 len
= MIN((card
.cardsize
- i
), USB_CMD_DATA_SIZE
);
1219 c
.arg
[0] = i
; // offset
1220 c
.arg
[1] = len
; // number of bytes
1221 memcpy(c
.d
.asBytes
, data
+i
, len
);
1222 clearCommandBuffer();
1225 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4000)) {
1226 PrintAndLog("command execution time out");
1230 uint8_t isOK
= resp
.arg
[0] & 0xFF;
1232 PrintAndLog("failed writing tag [msg = %u]", resp
.arg
[1] & 0xFF);
1241 int CmdLegicList(const char *Cmd
) {
1246 static command_t CommandTable
[] = {
1247 {"help", CmdHelp
, 1, "This help"},
1248 {"reader", CmdLegicReader
, 1, "LEGIC Prime Reader UID and tag info"},
1249 {"info", CmdLegicInfo
, 0, "Display deobfuscated and decoded LEGIC Prime tag data"},
1250 {"dump", CmdLegicDump
, 0, "Dump LEGIC Prime tag to binary file"},
1251 {"restore", CmdLegicRestore
, 0, "Restore a dump onto a LEGIC Prime tag"},
1252 {"rdmem", CmdLegicRdmem
, 0, "Read bytes from a LEGIC Prime tag"},
1253 {"sim", CmdLegicRfSim
, 0, "Start tag simulator"},
1254 {"write", CmdLegicRfWrite
, 0, "Write data to a LEGIC Prime tag"},
1255 {"crc", CmdLegicCalcCrc
, 1, "Calculate Legic CRC over given bytes"},
1256 {"eload", CmdLegicELoad
, 1, "Load binary dump to emulator memory"},
1257 {"esave", CmdLegicESave
, 1, "Save emulator memory to binary file"},
1258 {"list", CmdLegicList
, 1, "[Deprecated] List LEGIC history"},
1259 {"wipe", CmdLegicWipe
, 1, "Wipe a LEGIC Prime tag"},
1260 {NULL
, NULL
, 0, NULL
}
1263 int CmdHFLegic(const char *Cmd
) {
1264 clearCommandBuffer();
1265 CmdsParse(CommandTable
, Cmd
);
1269 int CmdHelp(const char *Cmd
) {
1270 CmdsHelp(CommandTable
);