]> git.zerfleddert.de Git - proxmark3-svn/blame - client/cmdhf.c
Update README.md
[proxmark3-svn] / client / cmdhf.c
CommitLineData
a553f267 1//-----------------------------------------------------------------------------
2// Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
4f131b53 3// Merlok - 2017
a553f267 4//
5// This code is licensed to you under the terms of the GNU GPL, version 2 or,
6// at your option, any later version. See the LICENSE.txt file for the text of
7// the license.
8//-----------------------------------------------------------------------------
9// High frequency commands
10//-----------------------------------------------------------------------------
11
acf0582d 12#include <stdlib.h>
7fe9b0b7 13#include <stdio.h>
4c3de57a 14#include <string.h>
902cb3c0 15#include "proxmark3.h"
7cb8516c 16#include "util.h"
acf0582d 17#include "data.h"
7fe9b0b7 18#include "ui.h"
7cb8516c 19#include "iso14443crc.h"
1f065e1d 20#include "parity.h"
7cb8516c 21#include "cmdmain.h"
7fe9b0b7 22#include "cmdparser.h"
23#include "cmdhf.h"
24#include "cmdhf14a.h"
25#include "cmdhf14b.h"
26#include "cmdhf15.h"
5acd09bd 27#include "cmdhfepa.h"
7fe9b0b7 28#include "cmdhflegic.h"
cee5a30d 29#include "cmdhficlass.h"
9ca155ba 30#include "cmdhfmf.h"
5ee70129 31#include "cmdhfmfu.h"
05ddb52c 32#include "cmdhftopaz.h"
b67f7ec3 33#include "protocols.h"
3c5fce2b 34#include "emv/cmdemv.h"
4f131b53 35#include "cmdhflist.h"
7fe9b0b7 36
37static int CmdHelp(const char *Cmd);
38
39int CmdHFTune(const char *Cmd)
40{
41 UsbCommand c={CMD_MEASURE_ANTENNA_TUNING_HF};
42 SendCommand(&c);
43 return 0;
44}
4c3de57a 45
ef00343c 46/**
47 * @brief iso14443B_CRC_check Checks CRC in command or response
41fdd0f0
MHS
48 * @param isResponse
49 * @param data
50 * @param len
51 * @return 0 : CRC-command, CRC not ok
52 * 1 : CRC-command, CRC ok
53 * 2 : Not crc-command
54 */
55
56uint8_t iso14443B_CRC_check(bool isResponse, uint8_t* data, uint8_t len)
57{
58 uint8_t b1,b2;
59
60 if(len <= 2) return 2;
61
62 ComputeCrc14443(CRC_14443_B, data, len-2, &b1, &b2);
63 if(b1 != data[len-2] || b2 != data[len-1]) {
ef00343c 64 return 0;
65 } else {
66 return 1;
41fdd0f0 67 }
41fdd0f0
MHS
68}
69
49726b40
MHS
70/**
71 * @brief iclass_CRC_Ok Checks CRC in command or response
72 * @param isResponse
73 * @param data
74 * @param len
75 * @return 0 : CRC-command, CRC not ok
76 * 1 : CRC-command, CRC ok
77 * 2 : Not crc-command
78 */
41fdd0f0 79uint8_t iclass_CRC_check(bool isResponse, uint8_t* data, uint8_t len)
49726b40
MHS
80{
81 if(len < 4) return 2;//CRC commands (and responses) are all at least 4 bytes
82
83 uint8_t b1, b2;
84
85 if(!isResponse)//Commands to tag
86 {
87 /**
88 These commands should have CRC. Total length leftmost
89 4 READ
90 4 READ4
91 12 UPDATE - unsecured, ends with CRC16
92 14 UPDATE - secured, ends with signature instead
93 4 PAGESEL
94 **/
95 if(len == 4 || len == 12)//Covers three of them
96 {
97 //Don't include the command byte
98 ComputeCrc14443(CRC_ICLASS, (data+1), len-3, &b1, &b2);
99 return b1 == data[len -2] && b2 == data[len-1];
100 }
101 return 2;
102 }else{
103 /**
104 These tag responses should have CRC. Total length leftmost
105
106 10 READ data[8] crc[2]
107 34 READ4 data[32]crc[2]
108 10 UPDATE data[8] crc[2]
109 10 SELECT csn[8] crc[2]
110 10 IDENTIFY asnb[8] crc[2]
111 10 PAGESEL block1[8] crc[2]
112 10 DETECT csn[8] crc[2]
113
114 These should not
115
116 4 CHECK chip_response[4]
117 8 READCHECK data[8]
118 1 ACTALL sof[1]
119 1 ACT sof[1]
120
121 In conclusion, without looking at the command; any response
122 of length 10 or 34 should have CRC
123 **/
124 if(len != 10 && len != 34) return true;
125
126 ComputeCrc14443(CRC_ICLASS, data, len-2, &b1, &b2);
127 return b1 == data[len -2] && b2 == data[len-1];
128 }
129}
4c3de57a 130
ee1eadee 131
a8904ebd 132bool is_last_record(uint16_t tracepos, uint8_t *trace, uint16_t traceLen)
4c3de57a 133{
a8904ebd 134 return(tracepos + sizeof(uint32_t) + sizeof(uint16_t) + sizeof(uint16_t) >= traceLen);
135}
136
137
138bool next_record_is_response(uint16_t tracepos, uint8_t *trace)
139{
140 uint16_t next_records_datalen = *((uint16_t *)(trace + tracepos + sizeof(uint32_t) + sizeof(uint16_t)));
141
142 return(next_records_datalen & 0x8000);
143}
144
145
ef00343c 146bool merge_topaz_reader_frames(uint32_t timestamp, uint32_t *duration, uint16_t *tracepos, uint16_t traceLen, uint8_t *trace, uint8_t *frame, uint8_t *topaz_reader_command, uint16_t *data_len)
a8904ebd 147{
148
48ece4a7 149#define MAX_TOPAZ_READER_CMD_LEN 16
a8904ebd 150
151 uint32_t last_timestamp = timestamp + *duration;
152
ef00343c 153 if ((*data_len != 1) || (frame[0] == TOPAZ_WUPA) || (frame[0] == TOPAZ_REQA)) return false;
4c3de57a 154
ef00343c 155 memcpy(topaz_reader_command, frame, *data_len);
a8904ebd 156
157 while (!is_last_record(*tracepos, trace, traceLen) && !next_record_is_response(*tracepos, trace)) {
158 uint32_t next_timestamp = *((uint32_t *)(trace + *tracepos));
159 *tracepos += sizeof(uint32_t);
ef00343c 160 uint16_t next_duration = *((uint16_t *)(trace + *tracepos));
a8904ebd 161 *tracepos += sizeof(uint16_t);
162 uint16_t next_data_len = *((uint16_t *)(trace + *tracepos)) & 0x7FFF;
163 *tracepos += sizeof(uint16_t);
164 uint8_t *next_frame = (trace + *tracepos);
165 *tracepos += next_data_len;
ef00343c 166 if ((next_data_len == 1) && (*data_len + next_data_len <= MAX_TOPAZ_READER_CMD_LEN)) {
a8904ebd 167 memcpy(topaz_reader_command + *data_len, next_frame, next_data_len);
168 *data_len += next_data_len;
ef00343c 169 last_timestamp = next_timestamp + next_duration;
170 } else {
171 // rewind and exit
172 *tracepos = *tracepos - next_data_len - sizeof(uint16_t) - sizeof(uint16_t) - sizeof(uint32_t);
173 break;
174 }
a8904ebd 175 uint16_t next_parity_len = (next_data_len-1)/8 + 1;
176 *tracepos += next_parity_len;
177 }
178
179 *duration = last_timestamp - timestamp;
ef00343c 180
181 return true;
ee1eadee 182}
183
184
05ddb52c 185uint16_t printTraceLine(uint16_t tracepos, uint16_t traceLen, uint8_t *trace, uint8_t protocol, bool showWaitCycles, bool markCRCBytes)
4c3de57a
MHS
186{
187 bool isResponse;
a8904ebd 188 uint16_t data_len, parity_len;
189 uint32_t duration;
ee1eadee 190 uint8_t topaz_reader_command[9];
4c3de57a
MHS
191 uint32_t timestamp, first_timestamp, EndOfTransmissionTimestamp;
192 char explanation[30] = {0};
7b215d14
OM
193 uint8_t mfData[32] = {0};
194 size_t mfDataLen = 0;
4c3de57a 195
f71f4deb 196 if (tracepos + sizeof(uint32_t) + sizeof(uint16_t) + sizeof(uint16_t) > traceLen) return traceLen;
197
4c3de57a
MHS
198 first_timestamp = *((uint32_t *)(trace));
199 timestamp = *((uint32_t *)(trace + tracepos));
4c3de57a
MHS
200
201 tracepos += 4;
202 duration = *((uint16_t *)(trace + tracepos));
203 tracepos += 2;
204 data_len = *((uint16_t *)(trace + tracepos));
205 tracepos += 2;
206
207 if (data_len & 0x8000) {
208 data_len &= 0x7fff;
209 isResponse = true;
210 } else {
211 isResponse = false;
212 }
213 parity_len = (data_len-1)/8 + 1;
214
f71f4deb 215 if (tracepos + data_len + parity_len > traceLen) {
216 return traceLen;
4c3de57a 217 }
4c3de57a
MHS
218 uint8_t *frame = trace + tracepos;
219 tracepos += data_len;
220 uint8_t *parityBytes = trace + tracepos;
221 tracepos += parity_len;
222
ee1eadee 223 if (protocol == TOPAZ && !isResponse) {
ef00343c 224 // topaz reader commands come in 1 or 9 separate frames with 7 or 8 Bits each.
ee1eadee 225 // merge them:
ef00343c 226 if (merge_topaz_reader_frames(timestamp, &duration, &tracepos, traceLen, trace, frame, topaz_reader_command, &data_len)) {
227 frame = topaz_reader_command;
228 }
ee1eadee 229 }
230
27eabcdc
MHS
231 //Check the CRC status
232 uint8_t crcStatus = 2;
233
234 if (data_len > 2) {
ee1eadee 235 switch (protocol) {
236 case ICLASS:
237 crcStatus = iclass_CRC_check(isResponse, frame, data_len);
238 break;
239 case ISO_14443B:
ef00343c 240 case TOPAZ:
a8904ebd 241 crcStatus = iso14443B_CRC_check(isResponse, frame, data_len);
ee1eadee 242 break;
4f131b53 243 case PROTO_MIFARE:
6612a5a2 244 crcStatus = mifare_CRC_check(isResponse, frame, data_len);
245 break;
ee1eadee 246 case ISO_14443A:
ef00343c 247 crcStatus = iso14443A_CRC_check(isResponse, frame, data_len);
ee1eadee 248 break;
249 default:
250 break;
27eabcdc
MHS
251 }
252 }
253 //0 CRC-command, CRC not ok
254 //1 CRC-command, CRC ok
255 //2 Not crc-command
9e8255d4 256
4c3de57a 257 //--- Draw the data column
9e8255d4 258 //char line[16][110];
4c3de57a 259 char line[16][110];
9e8255d4
MHS
260
261 for (int j = 0; j < data_len && j/16 < 16; j++) {
262
4c3de57a 263 uint8_t parityBits = parityBytes[j>>3];
1f065e1d 264 if (protocol != ISO_14443B && (isResponse || protocol == ISO_14443A) && (oddparity8(frame[j]) != ((parityBits >> (7-(j&0x0007))) & 0x01))) {
9e8255d4 265 snprintf(line[j/16]+(( j % 16) * 4),110, "%02x! ", frame[j]);
4c3de57a 266 } else {
ef00343c 267 snprintf(line[j/16]+(( j % 16) * 4), 110, " %02x ", frame[j]);
9e8255d4 268 }
27eabcdc
MHS
269
270 }
05ddb52c 271
272 if (markCRCBytes) {
273 if(crcStatus == 0 || crcStatus == 1)
274 {//CRC-command
275 char *pos1 = line[(data_len-2)/16]+(((data_len-2) % 16) * 4);
276 (*pos1) = '[';
277 char *pos2 = line[(data_len)/16]+(((data_len) % 16) * 4);
278 sprintf(pos2, "%c", ']');
279 }
9e8255d4 280 }
05ddb52c 281
9e8255d4
MHS
282 if(data_len == 0)
283 {
284 if(data_len == 0){
285 sprintf(line[0],"<empty trace - possible error>");
4c3de57a
MHS
286 }
287 }
288 //--- Draw the CRC column
4c3de57a 289
49726b40 290 char *crc = (crcStatus == 0 ? "!crc" : (crcStatus == 1 ? " ok " : " "));
4c3de57a
MHS
291
292 EndOfTransmissionTimestamp = timestamp + duration;
293
6612a5a2 294 if (protocol == PROTO_MIFARE)
b957bcd3 295 annotateMifare(explanation, sizeof(explanation), frame, data_len, parityBytes, parity_len, isResponse);
6612a5a2 296
4c3de57a
MHS
297 if(!isResponse)
298 {
ee1eadee 299 switch(protocol) {
300 case ICLASS: annotateIclass(explanation,sizeof(explanation),frame,data_len); break;
301 case ISO_14443A: annotateIso14443a(explanation,sizeof(explanation),frame,data_len); break;
302 case ISO_14443B: annotateIso14443b(explanation,sizeof(explanation),frame,data_len); break;
303 case TOPAZ: annotateTopaz(explanation,sizeof(explanation),frame,data_len); break;
304 default: break;
305 }
4c3de57a
MHS
306 }
307
9e8255d4
MHS
308 int num_lines = MIN((data_len - 1)/16 + 1, 16);
309 for (int j = 0; j < num_lines ; j++) {
4c3de57a 310 if (j == 0) {
48ece4a7 311 PrintAndLog(" %10d | %10d | %s |%-64s | %s| %s",
4c3de57a
MHS
312 (timestamp - first_timestamp),
313 (EndOfTransmissionTimestamp - first_timestamp),
314 (isResponse ? "Tag" : "Rdr"),
315 line[j],
316 (j == num_lines-1) ? crc : " ",
317 (j == num_lines-1) ? explanation : "");
318 } else {
48ece4a7 319 PrintAndLog(" | | |%-64s | %s| %s",
4c3de57a 320 line[j],
ee1eadee 321 (j == num_lines-1) ? crc : " ",
4c3de57a
MHS
322 (j == num_lines-1) ? explanation : "");
323 }
324 }
b957bcd3 325
2d7bdee3 326 if (DecodeMifareData(frame, data_len, parityBytes, isResponse, mfData, &mfDataLen)) {
747885a6
OM
327 memset(explanation, 0x00, sizeof(explanation));
328 if (!isResponse) {
329 explanation[0] = '>';
330 annotateIso14443a(&explanation[1], sizeof(explanation) - 1, mfData, mfDataLen);
331 }
332 uint8_t crcc = iso14443A_CRC_check(isResponse, mfData, mfDataLen);
28ee794f 333 PrintAndLog(" | * | dec |%-64s | %-4s| %s",
7b215d14 334 sprint_hex(mfData, mfDataLen),
747885a6 335 (crcc == 0 ? "!crc" : (crcc == 1 ? " ok " : " ")),
28ee794f 336 (true) ? explanation : "");
7b215d14 337 };
4c3de57a 338
a8904ebd 339 if (is_last_record(tracepos, trace, traceLen)) return traceLen;
f71f4deb 340
a8904ebd 341 if (showWaitCycles && !isResponse && next_record_is_response(tracepos, trace)) {
4c3de57a 342 uint32_t next_timestamp = *((uint32_t *)(trace + tracepos));
275d9e61 343 PrintAndLog(" %10d | %10d | %s | fdt (Frame Delay Time): %d",
a8904ebd 344 (EndOfTransmissionTimestamp - first_timestamp),
345 (next_timestamp - first_timestamp),
346 " ",
347 (next_timestamp - EndOfTransmissionTimestamp));
4c3de57a 348 }
f71f4deb 349
4c3de57a
MHS
350 return tracepos;
351}
352
f71f4deb 353
4c3de57a
MHS
354int CmdHFList(const char *Cmd)
355{
356 bool showWaitCycles = false;
05ddb52c 357 bool markCRCBytes = false;
4c3de57a 358 char type[40] = {0};
874572d4 359 int tlen = param_getstr(Cmd,0,type, sizeof(type));
05ddb52c 360 char param1 = param_getchar(Cmd, 1);
361 char param2 = param_getchar(Cmd, 2);
4c3de57a 362 bool errors = false;
b689b842 363 uint8_t protocol = 0;
4c3de57a 364 //Validate params
05ddb52c 365
366 if(tlen == 0) {
4c3de57a
MHS
367 errors = true;
368 }
05ddb52c 369
370 if(param1 == 'h'
371 || (param1 != 0 && param1 != 'f' && param1 != 'c')
372 || (param2 != 0 && param2 != 'f' && param2 != 'c')) {
4c3de57a
MHS
373 errors = true;
374 }
05ddb52c 375
376 if(!errors) {
ee1eadee 377 if(strcmp(type, "iclass") == 0) {
b689b842 378 protocol = ICLASS;
4f131b53 379 } else if(strcmp(type, "mf") == 0) {
380 protocol = PROTO_MIFARE;
ee1eadee 381 } else if(strcmp(type, "14a") == 0) {
b689b842 382 protocol = ISO_14443A;
ee1eadee 383 } else if(strcmp(type, "14b") == 0) {
b689b842 384 protocol = ISO_14443B;
ef00343c 385 } else if(strcmp(type,"topaz")== 0) {
ee1eadee 386 protocol = TOPAZ;
387 } else if(strcmp(type,"raw")== 0) {
b689b842 388 protocol = -1;//No crc, no annotations
ee1eadee 389 } else {
b689b842
MHS
390 errors = true;
391 }
392 }
4c3de57a
MHS
393
394 if (errors) {
395 PrintAndLog("List protocol data in trace buffer.");
05ddb52c 396 PrintAndLog("Usage: hf list <protocol> [f][c]");
92623113 397 PrintAndLog(" f - show frame delay times as well");
05ddb52c 398 PrintAndLog(" c - mark CRC bytes");
92623113
MHS
399 PrintAndLog("Supported <protocol> values:");
400 PrintAndLog(" raw - just show raw data without annotations");
337818f7 401 PrintAndLog(" 14a - interpret data as iso14443a communications");
4f131b53 402 PrintAndLog(" mf - interpret data as iso14443a communications and decrypt crypto1 stream");
41fdd0f0 403 PrintAndLog(" 14b - interpret data as iso14443b communications");
4c3de57a 404 PrintAndLog(" iclass - interpret data as iclass communications");
ee1eadee 405 PrintAndLog(" topaz - interpret data as topaz communications");
4c3de57a
MHS
406 PrintAndLog("");
407 PrintAndLog("example: hf list 14a f");
408 PrintAndLog("example: hf list iclass");
409 return 0;
410 }
b689b842 411
4c3de57a 412
05ddb52c 413 if (param1 == 'f' || param2 == 'f') {
4c3de57a
MHS
414 showWaitCycles = true;
415 }
416
05ddb52c 417 if (param1 == 'c' || param2 == 'c') {
418 markCRCBytes = true;
419 }
4c3de57a 420
f71f4deb 421 uint8_t *trace;
4c3de57a 422 uint16_t tracepos = 0;
f71f4deb 423 trace = malloc(USB_CMD_DATA_SIZE);
424
425 // Query for the size of the trace
426 UsbCommand response;
427 GetFromBigBuf(trace, USB_CMD_DATA_SIZE, 0);
428 WaitForResponse(CMD_ACK, &response);
429 uint16_t traceLen = response.arg[2];
430 if (traceLen > USB_CMD_DATA_SIZE) {
431 uint8_t *p = realloc(trace, traceLen);
432 if (p == NULL) {
433 PrintAndLog("Cannot allocate memory for trace");
434 free(trace);
435 return 2;
436 }
437 trace = p;
438 GetFromBigBuf(trace, traceLen, 0);
439 WaitForResponse(CMD_ACK, NULL);
440 }
441
442 PrintAndLog("Recorded Activity (TraceLen = %d bytes)", traceLen);
4c3de57a
MHS
443 PrintAndLog("");
444 PrintAndLog("Start = Start of Start Bit, End = End of last modulation. Src = Source of Transfer");
445 PrintAndLog("iso14443a - All times are in carrier periods (1/13.56Mhz)");
446 PrintAndLog("iClass - Timings are not as accurate");
447 PrintAndLog("");
de15fc5f 448 PrintAndLog(" Start | End | Src | Data (! denotes parity error) | CRC | Annotation |");
449 PrintAndLog("------------|------------|-----|-----------------------------------------------------------------|-----|--------------------|");
4c3de57a 450
aadc6bf1 451 ClearAuthData();
f71f4deb 452 while(tracepos < traceLen)
4c3de57a 453 {
05ddb52c 454 tracepos = printTraceLine(tracepos, traceLen, trace, protocol, showWaitCycles, markCRCBytes);
4c3de57a 455 }
f71f4deb 456
457 free(trace);
4c3de57a
MHS
458 return 0;
459}
460
8ceb6b03 461int CmdHFSearch(const char *Cmd){
462 int ans = 0;
6ce0e538 463 PrintAndLog("");
fe842bed 464 ans = CmdHF14AInfo("s");
6ce0e538 465 if (ans > 0) {
466 PrintAndLog("\nValid ISO14443A Tag Found - Quiting Search\n");
467 return ans;
ff4fdb32 468 }
aa53efc3 469 ans = HFiClassReader("", false, false);
ff4fdb32 470 if (ans) {
aa53efc3 471 PrintAndLog("\nValid iClass Tag (or PicoPass Tag) Found - Quiting Search\n");
ff4fdb32 472 return ans;
473 }
979c7655 474 ans = HF15Reader("", false);
6ce0e538 475 if (ans) {
979c7655 476 PrintAndLog("\nValid ISO15693 Tag Found - Quiting Search\n");
6ce0e538 477 return ans;
478 }
979c7655 479 //14b is longest test currently (and rarest chip type) ... put last
480 ans = HF14BInfo(false);
6ce0e538 481 if (ans) {
979c7655 482 PrintAndLog("\nValid ISO14443B Tag Found - Quiting Search\n");
6ce0e538 483 return ans;
484 }
ff4fdb32 485 PrintAndLog("\nno known/supported 13.56 MHz tags found\n");
8ceb6b03 486 return 0;
487}
7fe9b0b7 488
0472d76d 489int CmdHFSnoop(const char *Cmd)
490{
491 char * pEnd;
492 UsbCommand c = {CMD_HF_SNIFFER, {strtol(Cmd, &pEnd,0),strtol(pEnd, &pEnd,0),0}};
493 SendCommand(&c);
494 return 0;
495}
496
7fe9b0b7 497static command_t CommandTable[] =
498{
05ddb52c 499 {"help", CmdHelp, 1, "This help"},
500 {"14a", CmdHF14A, 1, "{ ISO14443A RFIDs... }"},
501 {"14b", CmdHF14B, 1, "{ ISO14443B RFIDs... }"},
502 {"15", CmdHF15, 1, "{ ISO15693 RFIDs... }"},
503 {"epa", CmdHFEPA, 1, "{ German Identification Card... }"},
3c5fce2b 504 {"emv", CmdHFEMV, 1, "{ EMV cards... }"},
05ddb52c 505 {"legic", CmdHFLegic, 0, "{ LEGIC RFIDs... }"},
506 {"iclass", CmdHFiClass, 1, "{ ICLASS RFIDs... }"},
507 {"mf", CmdHFMF, 1, "{ MIFARE RFIDs... }"},
508 {"mfu", CmdHFMFUltra, 1, "{ MIFARE Ultralight RFIDs... }"},
509 {"topaz", CmdHFTopaz, 1, "{ TOPAZ (NFC Type 1) RFIDs... }"},
510 {"tune", CmdHFTune, 0, "Continuously measure HF antenna tuning"},
511 {"list", CmdHFList, 1, "List protocol data in trace buffer"},
7624e8b2 512 {"search", CmdHFSearch, 1, "Search for known HF tags [preliminary]"},
b2fe0e77 513 {"snoop", CmdHFSnoop, 0, "<samples to skip (10000)> <triggers to skip (1)> Generic HF Snoop"},
05ddb52c 514 {NULL, NULL, 0, NULL}
7fe9b0b7 515};
516
517int CmdHF(const char *Cmd)
518{
519 CmdsParse(CommandTable, Cmd);
520 return 0;
521}
522
523int CmdHelp(const char *Cmd)
524{
525 CmdsHelp(CommandTable);
526 return 0;
527}
Impressum, Datenschutz