1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
3 // Modified 2010-2012 by <adrian -at- atrox.at>
4 // Modified 2012 by <vsza at vsza.hu>
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 ISO15693 commands
11 //-----------------------------------------------------------------------------
12 // There are three basic operation modes, depending on which device (proxmark/pc)
13 // the signal processing, (de)modulation, transmission protocol and logic is done.
15 // All steps are done on the proxmark, the output of the commands is returned via
16 // USB-debug-print commands.
18 // The protocol is done on the PC, passing only Iso15693 data frames via USB. This
19 // allows direct communication with a tag on command level
21 // The proxmark just samples the antenna and passes this "analog" data via USB to
22 // the client. Signal Processing & decoding is done on the pc. This is the slowest
23 // variant, but offers the possibility to analyze the waveforms directly.
29 //#include "proxusb.h"
30 #include "proxmark3.h"
34 #include "cmdparser.h"
36 #include "../common/iso15693tools.h"
39 #define FrameSOF Iso15693FrameSOF
40 #define Logic0 Iso15693Logic0
41 #define Logic1 Iso15693Logic1
42 #define FrameEOF Iso15693FrameEOF
44 #define Crc(data,datalen) Iso15693Crc(data,datalen)
45 #define AddCrc(data,datalen) Iso15693AddCrc(data,datalen)
46 #define sprintUID(target,uid) Iso15693sprintUID(target,uid)
48 // structure and database for uid -> tagtype lookups
51 int mask
; // how many MSB bits used
56 const productName uidmapping
[] = {
57 // UID, #significant Bits, "Vendor(+Product)"
58 { 0xE001000000000000LL
, 16, "Motorola" },
59 { 0xE002000000000000LL
, 16, "ST Microelectronics" },
60 { 0xE003000000000000LL
, 16, "Hitachi" },
61 { 0xE004000000000000LL
, 16, "Philips" },
62 { 0xE004010000000000LL
, 24, "Philips; IC SL2 ICS20" },
63 { 0xE005000000000000LL
, 16, "Infineon" },
64 { 0xE005400000000000LL
, 24, "Infineon; 56x32bit" },
65 { 0xE006000000000000LL
, 16, "Cylinc" },
66 { 0xE007000000000000LL
, 16, "Texas Instrument; " },
67 { 0xE007000000000000LL
, 20, "Texas Instrument; Tag-it HF-I Plus Inlay; 64x32bit" },
68 { 0xE007100000000000LL
, 20, "Texas Instrument; Tag-it HF-I Plus Chip; 64x32bit" },
69 { 0xE007800000000000LL
, 23, "Texas Instrument; Tag-it HF-I Plus (RF-HDT-DVBB tag or Third Party Products)" },
70 { 0xE007C00000000000LL
, 23, "Texas Instrument; Tag-it HF-I Standard; 8x32bit" },
71 { 0xE007C40000000000LL
, 23, "Texas Instrument; Tag-it HF-I Pro; 8x23bit; password" },
72 { 0xE008000000000000LL
, 16, "Fujitsu" },
73 { 0xE009000000000000LL
, 16, "Matsushita" },
74 { 0xE00A000000000000LL
, 16, "NEC" },
75 { 0xE00B000000000000LL
, 16, "Oki Electric" },
76 { 0xE00C000000000000LL
, 16, "Toshiba" },
77 { 0xE00D000000000000LL
, 16, "Mitsubishi" },
78 { 0xE00E000000000000LL
, 16, "Samsung" },
79 { 0xE00F000000000000LL
, 16, "Hyundai" },
80 { 0xE010000000000000LL
, 16, "LG-Semiconductors" },
81 { 0xE012000000000000LL
, 16, "HID Corporation" },
82 { 0xE016000000000000LL
, 16, "EM-Marin SA (Skidata)" },
83 { 0xE016040000000000LL
, 24, "EM-Marin SA (Skidata Keycard-eco); EM4034? no 'read', just 'readmulti'" },
84 { 0xE0160c0000000000LL
, 24, "EM-Marin SA; EM4035?" },
85 { 0xE016100000000000LL
, 24, "EM-Marin SA (Skidata); EM4135; 36x64bit start page 13" },
86 { 0xE016940000000000LL
, 24, "EM-Marin SA (Skidata); 51x64bit" },
87 { 0,0,"no tag-info available" } // must be the last entry
91 // fast method to just read the UID of a tag (collission detection not supported)
92 // *buf should be large enough to fit the 64bit uid
93 // returns 1 if suceeded
94 int getUID(uint8_t *buf
)
98 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
99 uint8_t *req
=c
.d
.asBytes
;
102 for (int retry
=0;retry
<3; retry
++) { // don't give up the at the first try
104 req
[0]= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
105 ISO15_REQ_INVENTORY
| ISO15_REQINV_SLOT1
;
106 req
[1]=ISO15_CMD_INVENTORY
;
107 req
[2]=0; // mask length
108 reqlen
=AddCrc(req
,3);
113 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
114 recv
= resp
.d
.asBytes
;
115 if (resp
.arg
[0]>=12 && ISO15_CRC_CHECK
==Crc(recv
,12)) {
116 memcpy(buf
,&recv
[2],8);
126 // get a product description based on the UID
128 // returns description of the best match
129 static char* getTagInfo(uint8_t *uid
) {
132 memcpy(&myuid
,uid
,sizeof(uint64_t));
133 while (uidmapping
[i
].mask
>0) {
134 mask
=(~0LL) <<(64-uidmapping
[i
].mask
);
135 if ((myuid
& mask
) == uidmapping
[i
].uid
) {
139 if (uidmapping
[i
].mask
>uidmapping
[best
].mask
) {
147 if (best
>=0) return uidmapping
[best
].desc
;
149 return uidmapping
[i
].desc
;
153 // return a clear-text message to an errorcode
154 static char* TagErrorStr(uint8_t error
) {
156 case 0x01: return "The command is not supported";
157 case 0x02: return "The command is not recognised";
158 case 0x03: return "The option is not supported.";
159 case 0x0f: return "Unknown error.";
160 case 0x10: return "The specified block is not available (doesn’t exist).";
161 case 0x11: return "The specified block is already -locked and thus cannot be locked again";
162 case 0x12: return "The specified block is locked and its content cannot be changed.";
163 case 0x13: return "The specified block was not successfully programmed.";
164 case 0x14: return "The specified block was not successfully locked.";
165 default: return "Reserved for Future Use or Custom command error.";
171 int CmdHF15Demod(const char *Cmd
)
173 // The sampling rate is 106.353 ksps/s, for T = 18.8 us
176 int max
= 0, maxPos
= 0;
180 if (GraphTraceLen
< 1000) return 0;
182 // First, correlate for SOF
183 for (i
= 0; i
< 100; i
++) {
185 for (j
= 0; j
< arraylen(FrameSOF
); j
+= skip
) {
186 corr
+= FrameSOF
[j
] * GraphBuffer
[i
+ (j
/ skip
)];
193 PrintAndLog("SOF at %d, correlation %d", maxPos
,
194 max
/ (arraylen(FrameSOF
) / skip
));
196 i
= maxPos
+ arraylen(FrameSOF
) / skip
;
199 memset(outBuf
, 0, sizeof(outBuf
));
202 int corr0
= 0, corr1
= 0, corrEOF
= 0;
203 for (j
= 0; j
< arraylen(Logic0
); j
+= skip
) {
204 corr0
+= Logic0
[j
] * GraphBuffer
[i
+ (j
/ skip
)];
206 for (j
= 0; j
< arraylen(Logic1
); j
+= skip
) {
207 corr1
+= Logic1
[j
] * GraphBuffer
[i
+ (j
/ skip
)];
209 for (j
= 0; j
< arraylen(FrameEOF
); j
+= skip
) {
210 corrEOF
+= FrameEOF
[j
] * GraphBuffer
[i
+ (j
/ skip
)];
212 // Even things out by the length of the target waveform.
216 if (corrEOF
> corr1
&& corrEOF
> corr0
) {
217 PrintAndLog("EOF at %d", i
);
219 } else if (corr1
> corr0
) {
220 i
+= arraylen(Logic1
) / skip
;
223 i
+= arraylen(Logic0
) / skip
;
230 if ((i
+ (int)arraylen(FrameEOF
)) >= GraphTraceLen
) {
231 PrintAndLog("ran off end!");
236 PrintAndLog("error, uneven octet! (discard extra bits!)");
237 PrintAndLog(" mask=%02x", mask
);
239 PrintAndLog("%d octets", k
);
241 for (i
= 0; i
< k
; i
++) {
242 PrintAndLog("# %2d: %02x ", i
, outBuf
[i
]);
244 PrintAndLog("CRC=%04x", Iso15693Crc(outBuf
, k
- 2));
250 // * Acquire Samples as Reader (enables carrier, sends inquiry)
251 int CmdHF15Read(const char *Cmd
)
253 UsbCommand c
= {CMD_ACQUIRE_RAW_ADC_SAMPLES_ISO_15693
};
258 // Record Activity without enabeling carrier
259 int CmdHF15Record(const char *Cmd
)
261 UsbCommand c
= {CMD_RECORD_RAW_ADC_SAMPLES_ISO_15693
};
266 int CmdHF15Reader(const char *Cmd
)
268 UsbCommand c
= {CMD_READER_ISO_15693
, {strtol(Cmd
, NULL
, 0), 0, 0}};
273 // Simulation is still not working very good
274 int CmdHF15Sim(const char *Cmd
)
276 UsbCommand c
= {CMD_SIMTAG_ISO_15693
, {strtol(Cmd
, NULL
, 0), 0, 0}};
281 // finds the AFI (Application Family Idendifier) of a card, by trying all values
282 // (There is no standard way of reading the AFI, allthough some tags support this)
283 int CmdHF15Afi(const char *Cmd
)
285 UsbCommand c
= {CMD_ISO_15693_FIND_AFI
, {strtol(Cmd
, NULL
, 0), 0, 0}};
290 // Reads all memory pages
291 int CmdHF15DumpMem(const char*Cmd
) {
295 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
296 uint8_t *req
=c
.d
.asBytes
;
302 PrintAndLog("No Tag found.");
306 PrintAndLog("Reading memory from tag UID=%s",sprintUID(NULL
,uid
));
307 PrintAndLog("Tag Info: %s",getTagInfo(uid
));
309 for (int retry
=0; retry
<5; retry
++) {
311 req
[0]= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
312 ISO15_REQ_NONINVENTORY
| ISO15_REQ_ADDRESS
;
313 req
[1]=ISO15_CMD_READ
;
314 memcpy(&req
[2],uid
,8);
316 reqlen
=AddCrc(req
,11);
321 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
322 recv
= resp
.d
.asBytes
;
323 if (ISO15_CRC_CHECK
==Crc(recv
,resp
.arg
[0])) {
324 if (!(recv
[0] & ISO15_RES_ERROR
)) {
326 *output
=0; // reset outputstring
327 sprintf(output
, "Block %2i ",blocknum
);
328 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) { // data in hex
329 sprintf(output
+strlen(output
),"%02X ",recv
[i
]);
332 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) { // data in cleaned ascii
333 sprintf(output
+strlen(output
),"%c",(recv
[i
]>31 && recv
[i
]<127)?recv
[i
]:'.');
335 PrintAndLog("%s",output
);
337 // PrintAndLog("bn=%i",blocknum);
339 PrintAndLog("Tag returned Error %i: %s",recv
[1],TagErrorStr(recv
[1]));
342 } // else PrintAndLog("crc");
343 } // else PrintAndLog("r null");
346 // if (resp.arg[0]<3)
347 // PrintAndLog("Lost Connection");
348 // else if (ISO15_CRC_CHECK!=Crc(resp.d.asBytes,resp.arg[0]))
349 // PrintAndLog("CRC Failed");
351 // PrintAndLog("Tag returned Error %i: %s",recv[1],TagErrorStr(recv[1]));
358 static command_t CommandTable15
[] =
360 {"help", CmdHF15Help
, 1, "This help"},
361 {"demod", CmdHF15Demod
, 1, "Demodulate ISO15693 from tag"},
362 {"read", CmdHF15Read
, 0, "Read HF tag (ISO 15693)"},
363 {"record", CmdHF15Record
, 0, "Record Samples (ISO 15693)"}, // atrox
364 {"reader", CmdHF15Reader
, 0, "Act like an ISO15693 reader"},
365 {"sim", CmdHF15Sim
, 0, "Fake an ISO15693 tag"},
366 {"cmd", CmdHF15Cmd
, 0, "Send direct commands to ISO15693 tag"},
367 {"findafi", CmdHF15Afi
, 0, "Brute force AFI of an ISO15693 tag"},
368 {"dumpmemory", CmdHF15DumpMem
, 0, "Read all memory pages of an ISO15693 tag"},
369 {NULL
, NULL
, 0, NULL
}
372 int CmdHF15(const char *Cmd
)
374 CmdsParse(CommandTable15
, Cmd
);
378 int CmdHF15Help(const char *Cmd
)
380 CmdsHelp(CommandTable15
);
385 // "HF 15 Cmd" Interface
386 // Allows direct communication with the tag on command level
388 int CmdHF15CmdInquiry(const char *Cmd
)
392 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
393 uint8_t *req
=c
.d
.asBytes
;
396 req
[0]= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
397 ISO15_REQ_INVENTORY
| ISO15_REQINV_SLOT1
;
398 req
[1]=ISO15_CMD_INVENTORY
;
399 req
[2]=0; // mask length
400 reqlen
=AddCrc(req
,3);
405 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
406 if (resp
.arg
[0]>=12) {
407 recv
= resp
.d
.asBytes
;
408 PrintAndLog("UID=%s",sprintUID(NULL
,&recv
[2]));
409 PrintAndLog("Tag Info: %s",getTagInfo(&recv
[2]));
411 PrintAndLog("Response to short, just %i bytes. No tag?\n",resp
.arg
[0]);
414 PrintAndLog("timeout.");
420 // Turns debugging on(1)/off(0)
421 int CmdHF15CmdDebug( const char *cmd
) {
424 PrintAndLog("Usage: hf 15 cmd debug <0/1>");
425 PrintAndLog(" 0..no debugging output 1..turn debugging on");
429 UsbCommand c
= {CMD_ISO_15693_DEBUG
, {debug
, 0, 0}};
435 int CmdHF15CmdRaw (const char *cmd
) {
438 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
445 unsigned int datalen
=0, temp
;
450 PrintAndLog("Usage: hf 15 cmd raw [-r] [-2] [-c] <0A 0B 0C ... hex>");
451 PrintAndLog(" -r do not read response");
452 PrintAndLog(" -2 use slower '1 out of 256' mode");
453 PrintAndLog(" -c calculate and append CRC");
454 PrintAndLog(" Tip: turn on debugging for verbose output");
459 while (*cmd
==' ' || *cmd
=='\t') cmd
++;
461 while (cmd
[i
]!='\0') {
462 if (cmd
[i
]==' ' || cmd
[i
]=='\t') { i
++; continue; }
477 PrintAndLog("Invalid option");
483 if ((cmd
[i
]>='0' && cmd
[i
]<='9') ||
484 (cmd
[i
]>='a' && cmd
[i
]<='f') ||
485 (cmd
[i
]>='A' && cmd
[i
]<='F') ) {
486 buf
[strlen(buf
)+1]=0;
487 buf
[strlen(buf
)]=cmd
[i
];
490 if (strlen(buf
)>=2) {
491 sscanf(buf
,"%x",&temp
);
492 data
[datalen
]=(uint8_t)(temp
& 0xff);
498 PrintAndLog("Invalid char on input");
501 if (crc
) datalen
=AddCrc(data
,datalen
);
506 memcpy(c
.d
.asBytes
,data
,datalen
);
511 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
512 recv
= resp
.d
.asBytes
;
513 PrintAndLog("received %i octets",resp
.arg
[0]);
514 hexout
= (char *)malloc(resp
.arg
[0] * 3 + 1);
515 if (hexout
!= NULL
) {
516 for (int i
= 0; i
< resp
.arg
[0]; i
++) { // data in hex
517 sprintf(&hexout
[i
* 3], "%02X ", recv
[i
]);
519 PrintAndLog("%s", hexout
);
523 PrintAndLog("timeout while waiting for reply.");
532 * parses common HF 15 CMD parameters and prepares some data structures
536 int prepareHF15Cmd(char **cmd
, UsbCommand
*c
, uint8_t iso15cmd
[], int iso15cmdlen
) {
538 uint8_t *req
=c
->d
.asBytes
, uid
[8];
542 while (**cmd
==' ' || **cmd
=='\t') (*cmd
)++;
544 if (strstr(*cmd
,"-2")==*cmd
) {
545 c
->arg
[1]=0; // use 1of256
550 while (**cmd
==' ' || **cmd
=='\t') (*cmd
)++;
552 if (strstr(*cmd
,"-o")==*cmd
) {
553 req
[reqlen
]=ISO15_REQ_OPTION
;
558 while (**cmd
==' ' || **cmd
=='\t') (*cmd
)++;
562 PrintAndLog("missing addr");
567 // you must have selected the tag earlier
568 req
[reqlen
++]|= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
569 ISO15_REQ_NONINVENTORY
| ISO15_REQ_SELECT
;
570 memcpy(&req
[reqlen
],&iso15cmd
[0],iso15cmdlen
);
575 // unaddressed mode may not be supported by all vendors
576 req
[reqlen
++]|= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
577 ISO15_REQ_NONINVENTORY
;
578 memcpy(&req
[reqlen
],&iso15cmd
[0],iso15cmdlen
);
582 // we scan for the UID ourself
583 req
[reqlen
++]|= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
584 ISO15_REQ_NONINVENTORY
| ISO15_REQ_ADDRESS
;
585 memcpy(&req
[reqlen
],&iso15cmd
[0],iso15cmdlen
);
588 PrintAndLog("No Tag found");
591 memcpy(req
+reqlen
,uid
,8);
592 PrintAndLog("Detected UID %s",sprintUID(NULL
,uid
));
596 req
[reqlen
++]|= ISO15_REQ_SUBCARRIER_SINGLE
| ISO15_REQ_DATARATE_HIGH
|
597 ISO15_REQ_NONINVENTORY
| ISO15_REQ_ADDRESS
;
598 memcpy(&req
[reqlen
],&iso15cmd
[0],iso15cmdlen
);
601 /* sscanf(cmd,"%hX%hX%hX%hX%hX%hX%hX%hX",
602 (short unsigned int *)&uid[7],(short unsigned int *)&uid[6],
603 (short unsigned int *)&uid[5],(short unsigned int *)&uid[4],
604 (short unsigned int *)&uid[3],(short unsigned int *)&uid[2],
605 (short unsigned int *)&uid[1],(short unsigned int *)&uid[0]); */
606 for (int i
=0;i
<8 && (*cmd
)[i
*2] && (*cmd
)[i
*2+1];i
++) { // parse UID
607 sscanf((char[]){(*cmd
)[i
*2],(*cmd
)[i
*2+1],0},"%X",&temp
);
611 PrintAndLog("Using UID %s",sprintUID(NULL
,uid
));
612 memcpy(&req
[reqlen
],&uid
[0],8);
615 // skip to next space
616 while (**cmd
!=' ' && **cmd
!='\t') (*cmd
)++;
617 // skip over the space
618 while (**cmd
==' ' || **cmd
=='\t') (*cmd
)++;
625 * Commandline handling: HF15 CMD SYSINFO
626 * get system information from tag/VICC
628 int CmdHF15CmdSysinfo(const char *Cmd
) {
631 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
632 uint8_t *req
=c
.d
.asBytes
;
636 char output
[2048]="";
643 PrintAndLog("Usage: hf 15 cmd sysinfo [options] <uid|s|u|*>");
644 PrintAndLog(" options:");
645 PrintAndLog(" -2 use slower '1 out of 256' mode");
646 PrintAndLog(" uid (either): ");
647 PrintAndLog(" <8B hex> full UID eg E011223344556677");
648 PrintAndLog(" s selected tag");
649 PrintAndLog(" u unaddressed mode");
650 PrintAndLog(" * scan for tag");
651 PrintAndLog(" start#: page number to start 0-255");
652 PrintAndLog(" count#: number of pages");
656 prepareHF15Cmd(&cmd
, &c
,(uint8_t[]){ISO15_CMD_SYSINFO
},1);
659 reqlen
=AddCrc(req
,reqlen
);
664 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000) && resp
.arg
[0]>2) {
665 recv
= resp
.d
.asBytes
;
666 if (ISO15_CRC_CHECK
==Crc(recv
,resp
.arg
[0])) {
667 if (!(recv
[0] & ISO15_RES_ERROR
)) {
668 *output
=0; // reset outputstring
669 for ( i
=1; i
<resp
.arg
[0]-2; i
++) {
670 sprintf(output
+strlen(output
),"%02X ",recv
[i
]);
672 strcat(output
,"\n\r");
673 strcat(output
,"UID = ");
674 strcat(output
,sprintUID(NULL
,recv
+2));
675 strcat(output
,"\n\r");
676 strcat(output
,getTagInfo(recv
+2)); //ABC
677 strcat(output
,"\n\r");
680 sprintf(output
+strlen(output
),"DSFID supported, set to %02X\n\r",recv
[i
++]);
682 strcat(output
,"DSFID not supported\n\r");
684 sprintf(output
+strlen(output
),"AFI supported, set to %03X\n\r",recv
[i
++]);
686 strcat(output
,"AFI not supported\n\r");
687 if (recv
[1] & 0x04) {
688 strcat(output
,"Tag provides info on memory layout (vendor dependent)\n\r");
689 sprintf(output
+strlen(output
)," %i (or %i) bytes/page x %i pages \n\r",
690 (recv
[i
+1]&0x1F)+1, (recv
[i
+1]&0x1F), recv
[i
]+1);
693 strcat(output
,"Tag does not provide information on memory layout\n\r");
694 if (recv
[1] & 0x08) sprintf(output
+strlen(output
),"IC reference given: %02X\n\r",recv
[i
++]);
695 else strcat(output
,"IC reference not given\n\r");
698 PrintAndLog("%s",output
);
700 PrintAndLog("Tag returned Error %i: %s",recv
[0],TagErrorStr(recv
[0]));
703 PrintAndLog("CRC failed");
706 PrintAndLog("timeout: no answer");
713 * Commandline handling: HF15 CMD READMULTI
714 * Read multiple blocks at once (not all tags support this)
716 int CmdHF15CmdReadmulti(const char *Cmd
) {
719 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
720 uint8_t *req
=c
.d
.asBytes
;
721 int reqlen
=0, pagenum
,pagecount
;
724 char output
[2048]="";
730 PrintAndLog("Usage: hf 15 cmd readmulti [options] <uid|s|u|*> <start#> <count#>");
731 PrintAndLog(" options:");
732 PrintAndLog(" -2 use slower '1 out of 256' mode");
733 PrintAndLog(" uid (either): ");
734 PrintAndLog(" <8B hex> full UID eg E011223344556677");
735 PrintAndLog(" s selected tag");
736 PrintAndLog(" u unaddressed mode");
737 PrintAndLog(" * scan for tag");
738 PrintAndLog(" start#: page number to start 0-255");
739 PrintAndLog(" count#: number of pages");
743 prepareHF15Cmd(&cmd
, &c
,(uint8_t[]){ISO15_CMD_READMULTI
},1);
746 pagenum
=strtol(cmd
,NULL
,0);
748 // skip to next space
749 while (*cmd
!=' ' && *cmd
!='\t') cmd
++;
750 // skip over the space
751 while (*cmd
==' ' || *cmd
=='\t') cmd
++;
753 pagecount
=strtol(cmd
,NULL
,0);
754 if (pagecount
>0) pagecount
--; // 0 means 1 page, 1 means 2 pages, ...
756 req
[reqlen
++]=(uint8_t)pagenum
;
757 req
[reqlen
++]=(uint8_t)pagecount
;
759 reqlen
=AddCrc(req
,reqlen
);
765 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000) && resp
.arg
[0]>2) {
766 recv
= resp
.d
.asBytes
;
767 if (ISO15_CRC_CHECK
==Crc(recv
,resp
.arg
[0])) {
768 if (!(recv
[0] & ISO15_RES_ERROR
)) {
769 *output
=0; // reset outputstring
770 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) {
771 sprintf(output
+strlen(output
),"%02X ",recv
[i
]);
774 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) {
775 sprintf(output
+strlen(output
),"%c",recv
[i
]>31 && recv
[i
]<127?recv
[i
]:'.');
777 PrintAndLog("%s",output
);
779 PrintAndLog("Tag returned Error %i: %s",recv
[0],TagErrorStr(recv
[0]));
782 PrintAndLog("CRC failed");
785 PrintAndLog("no answer");
792 * Commandline handling: HF15 CMD READ
793 * Reads a single Block
795 int CmdHF15CmdRead(const char *Cmd
) {
798 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
799 uint8_t *req
=c
.d
.asBytes
;
800 int reqlen
=0, pagenum
;
809 PrintAndLog("Usage: hf 15 cmd read [options] <uid|s|u|*> <page#>");
810 PrintAndLog(" options:");
811 PrintAndLog(" -2 use slower '1 out of 256' mode");
812 PrintAndLog(" uid (either): ");
813 PrintAndLog(" <8B hex> full UID eg E011223344556677");
814 PrintAndLog(" s selected tag");
815 PrintAndLog(" u unaddressed mode");
816 PrintAndLog(" * scan for tag");
817 PrintAndLog(" page#: page number 0-255");
821 prepareHF15Cmd(&cmd
, &c
,(uint8_t[]){ISO15_CMD_READ
},1);
824 pagenum
=strtol(cmd
,NULL
,0);
826 PrintAndLog("invalid pagenum");
830 req
[reqlen
++]=(uint8_t)pagenum
;
832 reqlen
=AddCrc(req
,reqlen
);
838 if (WaitForResponseTimeout(CMD_ACK
,&resp
,1000) && resp
.arg
[0]>2) {
839 recv
= resp
.d
.asBytes
;
840 if (ISO15_CRC_CHECK
==Crc(recv
,resp
.arg
[0])) {
841 if (!(recv
[0] & ISO15_RES_ERROR
)) {
842 *output
=0; // reset outputstring
843 //sprintf(output, "Block %2i ",blocknum);
844 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) {
845 sprintf(output
+strlen(output
),"%02X ",recv
[i
]);
848 for ( int i
=1; i
<resp
.arg
[0]-2; i
++) {
849 sprintf(output
+strlen(output
),"%c",recv
[i
]>31 && recv
[i
]<127?recv
[i
]:'.');
851 PrintAndLog("%s",output
);
853 PrintAndLog("Tag returned Error %i: %s",recv
[1],TagErrorStr(recv
[1]));
856 PrintAndLog("CRC failed");
859 PrintAndLog("no answer");
867 * Commandline handling: HF15 CMD WRITE
868 * Writes a single Block - might run into timeout, even when successful
870 int CmdHF15CmdWrite(const char *Cmd
) {
873 UsbCommand c
= {CMD_ISO_15693_COMMAND
, {0, 1, 1}}; // len,speed,recv?
874 uint8_t *req
=c
.d
.asBytes
;
875 int reqlen
=0, pagenum
, temp
;
884 PrintAndLog("Usage: hf 15 cmd write [options] <uid|s|u|*> <page#> <hexdata>");
885 PrintAndLog(" options:");
886 PrintAndLog(" -2 use slower '1 out of 256' mode");
887 PrintAndLog(" -o set OPTION Flag (needed for TI)");
888 PrintAndLog(" uid (either): ");
889 PrintAndLog(" <8B hex> full UID eg E011223344556677");
890 PrintAndLog(" s selected tag");
891 PrintAndLog(" u unaddressed mode");
892 PrintAndLog(" * scan for tag");
893 PrintAndLog(" page#: page number 0-255");
894 PrintAndLog(" hexdata: data to be written eg AA BB CC DD");
898 prepareHF15Cmd(&cmd
, &c
,(uint8_t[]){ISO15_CMD_WRITE
},1);
901 // *cmd -> page num ; *cmd2 -> data
903 while (*cmd2
!=' ' && *cmd2
!='\t' && *cmd2
) cmd2
++;
907 pagenum
=strtol(cmd
,NULL
,0);
909 PrintAndLog("invalid pagenum");
912 req
[reqlen
++]=(uint8_t)pagenum
;
915 while (cmd2
[0] && cmd2
[1]) { // hexdata, read by 2 hexchars
920 sscanf((char[]){cmd2
[0],cmd2
[1],0},"%X",&temp
);
921 req
[reqlen
++]=temp
& 0xff;
925 reqlen
=AddCrc(req
,reqlen
);
931 if (WaitForResponseTimeout(CMD_ACK
,&resp
,2000) && resp
.arg
[0]>2) {
932 recv
= resp
.d
.asBytes
;
933 if (ISO15_CRC_CHECK
==Crc(recv
,resp
.arg
[0])) {
934 if (!(recv
[0] & ISO15_RES_ERROR
)) {
937 PrintAndLog("Tag returned Error %i: %s",recv
[1],TagErrorStr(recv
[1]));
940 PrintAndLog("CRC failed");
943 PrintAndLog("timeout: no answer - data may be written anyway");
951 static command_t CommandTable15Cmd
[] =
953 {"help", CmdHF15CmdHelp
, 1, "This Help"},
954 {"inquiry", CmdHF15CmdInquiry
, 0, "Search for tags in range"},
956 {"select", CmdHF15CmdSelect, 0, "Select an tag with a specific UID for further commands"},
958 {"read", CmdHF15CmdRead
, 0, "Read a block"},
959 {"write", CmdHF15CmdWrite
, 0, "Write a block"},
960 {"readmulti",CmdHF15CmdReadmulti
, 0, "Reads multiple Blocks"},
961 {"sysinfo",CmdHF15CmdSysinfo
, 0, "Get Card Information"},
962 {"raw", CmdHF15CmdRaw
, 0, "Send raw hex data to tag"},
963 {"debug", CmdHF15CmdDebug
, 0, "Turn debugging on/off"},
964 {NULL
, NULL
, 0, NULL
}
967 int CmdHF15Cmd(const char *Cmd
)
969 CmdsParse(CommandTable15Cmd
, Cmd
);
973 int CmdHF15CmdHelp(const char *Cmd
)
975 CmdsHelp(CommandTable15Cmd
);