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 //-----------------------------------------------------------------------------
13 #include "proxmark3.h"
16 #include "cmdparser.h"
17 #include "cmdhflegic.h"
21 static int CmdHelp(const char *Cmd
);
23 int usage_legic_calccrc8(void){
24 PrintAndLog("Calculates the legic crc8 on the input hexbytes.");
25 PrintAndLog("There must be an even number of hexsymbols as input.");
26 PrintAndLog("Usage: hf legic crc8 <hexbytes>");
27 PrintAndLog("Options :");
28 PrintAndLog(" <hexbytes> : hex bytes in a string");
30 PrintAndLog("Sample : hf legic crc8 deadbeef1122");
34 int usage_legic_load(void){
35 PrintAndLog("It loads datasamples from the file `filename` to device memory");
36 PrintAndLog("Usage: hf legic load <file name>");
37 PrintAndLog(" sample: hf legic load filename");
41 int usage_legic_read(void){
42 PrintAndLog("Read data from a legic tag.");
43 PrintAndLog("Usage: hf legic read <offset> <num of bytes>");
44 PrintAndLog("Options :");
45 PrintAndLog(" <offset> : offset in data array to start download from");
46 PrintAndLog(" <num of bytes> : number of bytes to download");
48 PrintAndLog(" sample: hf legic read");
53 * Output BigBuf and deobfuscate LEGIC RF tag data.
54 * This is based on information given in the talk held
55 * by Henryk Ploetz and Karsten Nohl at 26c3
57 int CmdLegicDecode(const char *Cmd
) {
58 // Index for the bytearray.
60 int k
= 0, segmentNum
;
63 uint8_t stamp_len
= 0;
67 uint8_t data_buf
[1024]; // receiver buffer, should be 1024..
70 // download EML memory, where the "legic read" command puts the data.
71 GetEMLFromBigBuf(data_buf
, sizeof(data_buf
), 0);
72 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2000)){
73 PrintAndLog("Command execute timeout");
77 // Output CDF System area (9 bytes) plus remaining header area (12 bytes)
79 uint32_t calc_crc
= CRC8Legic(data_buf
, 4);
81 PrintAndLog("\nCDF: System Area");
82 PrintAndLog("------------------------------------------------------");
83 PrintAndLog("MCD: %02x, MSN: %02x %02x %02x, MCC: %02x %s",
89 (calc_crc
== crc
) ? "OK":"Fail"
92 switch (data_buf
[5] & 0x7f) {
94 strncpy(token_type
, "IAM",sizeof(token_type
));
97 strncpy(token_type
, "SAM",sizeof(token_type
));
100 strncpy(token_type
, "GAM",sizeof(token_type
));
103 strncpy(token_type
, "???",sizeof(token_type
));
107 stamp_len
= 0xfc - data_buf
[6];
109 PrintAndLog("DCF: %02x %02x, Token Type=%s (OLE=%01u), Stamp len=%02u",
113 (data_buf
[5]&0x80)>>7,
117 PrintAndLog("WRP=%02u, WRC=%01u, RD=%01u, raw=%02x, SSC=%02x",
119 (data_buf
[7]&0x70)>>4,
120 (data_buf
[7]&0x80)>>7,
125 PrintAndLog("Remaining Header Area");
126 PrintAndLog("%s", sprint_hex(data_buf
+9, 13));
128 uint8_t segCrcBytes
[8] = {0x00};
129 uint32_t segCalcCRC
= 0;
132 // see if user area is xored or just zeros.
134 for (int index
=22; index
< 256; ++index
){
135 if ( data_buf
[index
] == 0x00 )
138 // if possible zeros is less then 60%, lets assume data is xored
139 // 256 - 22 (header) = 234
140 // 1024 - 22 (header) = 1002
141 int isXored
= (numOfZeros
*100/stamp_len
) < 50;
142 PrintAndLog("is data xored? %d ( %d %)", isXored
, (numOfZeros
*100/stamp_len
));
144 print_hex_break( data_buf
, 33, 16);
148 PrintAndLog("\nADF: User Area");
149 PrintAndLog("------------------------------------------------------");
151 // 64 potential segements
152 // how to detect there is no segments?!?
153 for ( segmentNum
=0; segmentNum
<64; segmentNum
++ ) {
154 segment_len
= ((data_buf
[i
+1]^crc
)&0x0f) * 256 + (data_buf
[i
]^crc
);
155 segment_flag
= ((data_buf
[i
+1]^crc
)&0xf0)>>4;
157 wrp
= (data_buf
[i
+2]^crc
);
158 wrc
= ((data_buf
[i
+3]^crc
)&0x70)>>4;
160 bool hasWRC
= (wrc
> 0);
161 bool hasWRP
= (wrp
> wrc
);
162 int wrp_len
= (wrp
- wrc
);
163 int remain_seg_payload_len
= (segment_len
- wrp
- 5);
165 // validate segment-crc
166 segCrcBytes
[0]=data_buf
[0]; //uid0
167 segCrcBytes
[1]=data_buf
[1]; //uid1
168 segCrcBytes
[2]=data_buf
[2]; //uid2
169 segCrcBytes
[3]=data_buf
[3]; //uid3
170 segCrcBytes
[4]=(data_buf
[i
]^crc
); //hdr0
171 segCrcBytes
[5]=(data_buf
[i
+1]^crc
); //hdr1
172 segCrcBytes
[6]=(data_buf
[i
+2]^crc
); //hdr2
173 segCrcBytes
[7]=(data_buf
[i
+3]^crc
); //hdr3
175 segCalcCRC
= CRC8Legic(segCrcBytes
, 8);
176 segCRC
= data_buf
[i
+4]^crc
;
178 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)",
186 (segment_flag
& 0x4) >> 2,
187 (segment_flag
& 0x8) >> 3,
190 ((data_buf
[i
+3]^crc
) & 0x80) >> 7,
192 ( segCRC
== segCalcCRC
) ? "OK" : "fail"
198 PrintAndLog("WRC protected area: (I %d | K %d| WRC %d)", i
, k
, wrc
);
199 PrintAndLog("\nrow | data");
200 PrintAndLog("-----+------------------------------------------------");
201 // de-xor? if not zero, assume it needs xoring.
203 for ( k
=i
; k
< wrc
; ++k
)
206 print_hex_break( data_buf
+i
, wrc
, 16);
212 PrintAndLog("Remaining write protected area: (I %d | K %d | WRC %d | WRP %d WRP_LEN %d)",i
, k
, wrc
, wrp
, wrp_len
);
213 PrintAndLog("\nrow | data");
214 PrintAndLog("-----+------------------------------------------------");
217 for (k
=i
; k
< wrp_len
; ++k
)
221 print_hex_break( data_buf
+i
, wrp_len
, 16);
225 // does this one work?
227 PrintAndLog("Card ID: %2X%02X%02X", data_buf
[i
-4]^crc
, data_buf
[i
-3]^crc
, data_buf
[i
-2]^crc
);
230 PrintAndLog("Remaining segment payload: (I %d | K %d | Remain LEN %d)", i
, k
, remain_seg_payload_len
);
231 PrintAndLog("\nrow | data");
232 PrintAndLog("-----+------------------------------------------------");
234 for ( k
=i
; k
< remain_seg_payload_len
; ++k
)
238 print_hex_break( data_buf
+i
, remain_seg_payload_len
, 16);
240 i
+= remain_seg_payload_len
;
242 PrintAndLog("-----+------------------------------------------------\n");
244 // end with last segment
245 if (segment_flag
& 0x8) return 0;
251 int CmdLegicRFRead(const char *Cmd
) {
256 char cmdp
= param_getchar(Cmd
, 0);
257 if ( cmdp
== 'H' || cmdp
== 'h' ) return usage_legic_read();
259 int byte_count
=0, offset
=0;
260 sscanf(Cmd
, "%i %i", &offset
, &byte_count
);
261 if(byte_count
== 0) byte_count
= -1;
262 if(byte_count
+ offset
> 1024) byte_count
= 1024 - offset
;
264 UsbCommand c
= {CMD_READER_LEGIC_RF
, {offset
, byte_count
, 0}};
265 clearCommandBuffer();
270 int CmdLegicLoad(const char *Cmd
) {
272 char cmdp
= param_getchar(Cmd
, 0);
273 if ( cmdp
== 'H' || cmdp
== 'h' || cmdp
== 0x00) return usage_legic_load();
275 char filename
[FILE_PATH_SIZE
] = {0x00};
276 int len
= strlen(Cmd
);
278 if (len
> FILE_PATH_SIZE
) {
279 PrintAndLog("Filepath too long (was %s bytes), max allowed is %s ", len
, FILE_PATH_SIZE
);
282 memcpy(filename
, Cmd
, len
);
284 FILE *f
= fopen(filename
, "r");
286 PrintAndLog("couldn't open '%s'", Cmd
);
292 uint8_t data
[USB_CMD_DATA_SIZE
] = {0x00};
295 while ( fgets(line
, sizeof(line
), f
) ) {
296 int res
= sscanf(line
, "%x %x %x %x %x %x %x %x",
297 (unsigned int *)&data
[index
],
298 (unsigned int *)&data
[index
+ 1],
299 (unsigned int *)&data
[index
+ 2],
300 (unsigned int *)&data
[index
+ 3],
301 (unsigned int *)&data
[index
+ 4],
302 (unsigned int *)&data
[index
+ 5],
303 (unsigned int *)&data
[index
+ 6],
304 (unsigned int *)&data
[index
+ 7]);
307 PrintAndLog("Error: could not read samples");
313 if ( index
== USB_CMD_DATA_SIZE
){
314 // PrintAndLog("sent %d | %d | %d", index, offset, totalbytes);
315 UsbCommand c
= { CMD_DOWNLOADED_SIM_SAMPLES_125K
, {offset
, 0, 0}};
316 memcpy(c
.d
.asBytes
, data
, sizeof(data
));
317 clearCommandBuffer();
319 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 1500)){
320 PrintAndLog("Command execute timeout");
333 UsbCommand c
= { CMD_DOWNLOADED_SIM_SAMPLES_125K
, {offset
, 0, 0}};
334 memcpy(c
.d
.asBytes
, data
, 8);
335 clearCommandBuffer();
337 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 1500)){
338 PrintAndLog("Command execute timeout");
344 PrintAndLog("loaded %u samples", totalbytes
);
348 int CmdLegicSave(const char *Cmd
) {
349 int requested
= 1024;
352 char filename
[FILE_PATH_SIZE
];
353 uint8_t got
[1024] = {0x00};
355 sscanf(Cmd
, " %s %i %i", filename
, &requested
, &offset
);
357 /* If no length given save entire legic read buffer */
358 /* round up to nearest 8 bytes so the saved data can be used with legicload */
362 if (requested
% 8 != 0) {
363 int remainder
= requested
% 8;
364 requested
= requested
+ 8 - remainder
;
367 if (offset
+ requested
> sizeof(got
)) {
368 PrintAndLog("Tried to read past end of buffer, <bytes> + <offset> > 1024");
372 GetFromBigBuf(got
, requested
, offset
);
373 if ( !WaitForResponseTimeout(CMD_ACK
, NULL
, 2000)){
374 PrintAndLog("Command execute timeout");
378 FILE *f
= fopen(filename
, "w");
380 PrintAndLog("couldn't open '%s'", Cmd
+1);
384 for (int j
= 0; j
< requested
; j
+= 8) {
385 fprintf(f
, "%02x %02x %02x %02x %02x %02x %02x %02x\n",
386 got
[j
+0], got
[j
+1], got
[j
+2], got
[j
+3],
387 got
[j
+4], got
[j
+5], got
[j
+6], got
[j
+7]
390 if (delivered
>= requested
) break;
394 PrintAndLog("saved %u samples", delivered
);
398 //TODO: write a help text (iceman)
399 int CmdLegicRfSim(const char *Cmd
) {
400 UsbCommand c
= {CMD_SIMULATE_TAG_LEGIC_RF
, {6,3,0}};
401 sscanf(Cmd
, " %"lli
" %"lli
" %"lli
, &c
.arg
[0], &c
.arg
[1], &c
.arg
[2]);
402 clearCommandBuffer();
407 //TODO: write a help text (iceman)
408 int CmdLegicRfWrite(const char *Cmd
) {
409 UsbCommand c
= {CMD_WRITER_LEGIC_RF
};
410 int res
= sscanf(Cmd
, " 0x%"llx
" 0x%"llx
, &c
.arg
[0], &c
.arg
[1]);
412 PrintAndLog("Please specify the offset and length as two hex strings");
415 clearCommandBuffer();
420 int CmdLegicRfFill(const char *Cmd
) {
421 UsbCommand cmd
= {CMD_WRITER_LEGIC_RF
};
422 int res
= sscanf(Cmd
, " 0x%"llx
" 0x%"llx
" 0x%"llx
, &cmd
.arg
[0], &cmd
.arg
[1], &cmd
.arg
[2]);
424 PrintAndLog("Please specify the offset, length and value as two hex strings");
429 UsbCommand c
= {CMD_DOWNLOADED_SIM_SAMPLES_125K
, {0, 0, 0}};
430 for(i
= 0; i
< 48; i
++) {
431 c
.d
.asBytes
[i
] = cmd
.arg
[2];
434 for(i
= 0; i
< 22; i
++) {
437 WaitForResponse(CMD_ACK
,NULL
);
439 clearCommandBuffer();
444 int CmdLegicCalcCrc8(const char *Cmd
){
446 int len
= strlen(Cmd
);
447 if ( len
& 1 ) return usage_legic_calccrc8();
449 // add 1 for null terminator.
450 uint8_t *data
= malloc(len
+1);
451 if ( data
== NULL
) return 1;
453 if (param_gethex(Cmd
, 0, data
, len
)) {
455 return usage_legic_calccrc8();
458 uint32_t checksum
= CRC8Legic(data
, len
/2);
459 PrintAndLog("Bytes: %s || CRC8: %X", sprint_hex(data
, len
/2), checksum
);
464 static command_t CommandTable
[] = {
465 {"help", CmdHelp
, 1, "This help"},
466 {"decode", CmdLegicDecode
, 0, "Display deobfuscated and decoded LEGIC RF tag data (use after hf legic reader)"},
467 {"read", CmdLegicRFRead
, 0, "[offset][length] -- read bytes from a LEGIC card"},
468 {"save", CmdLegicSave
, 0, "<filename> [<length>] -- Store samples"},
469 {"load", CmdLegicLoad
, 0, "<filename> -- Restore samples"},
470 {"sim", CmdLegicRfSim
, 0, "[phase drift [frame drift [req/resp drift]]] Start tag simulator (use after load or read)"},
471 {"write", CmdLegicRfWrite
,0, "<offset> <length> -- Write sample buffer (user after load or read)"},
472 {"fill", CmdLegicRfFill
, 0, "<offset> <length> <value> -- Fill/Write tag with constant value"},
473 {"crc8", CmdLegicCalcCrc8
, 1, "Calculate Legic CRC8 over given hexbytes"},
474 {NULL
, NULL
, 0, NULL
}
477 int CmdHFLegic(const char *Cmd
) {
478 clearCommandBuffer();
479 CmdsParse(CommandTable
, Cmd
);
483 int CmdHelp(const char *Cmd
) {
484 CmdsHelp(CommandTable
);