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 ISO14443B commands
9 //-----------------------------------------------------------------------------
16 #include "iso14443crc.h"
17 #include "proxmark3.h"
22 #include "cmdparser.h"
27 static int CmdHelp(const char *Cmd
);
29 int CmdHF14BList(const char *Cmd
)
31 PrintAndLog("Deprecated command, use 'hf list 14b' instead");
36 int CmdHF14BSim(const char *Cmd
)
38 UsbCommand c
={CMD_SIMULATE_TAG_ISO_14443B
};
44 int CmdHF14BSnoop(const char *Cmd
)
46 UsbCommand c
= {CMD_SNOOP_ISO_14443B
};
52 /* New command to read the contents of a SRI512 tag
53 * SRI512 tags are ISO14443-B modulated memory tags,
54 * this command just dumps the contents of the memory
56 int CmdSri512Read(const char *Cmd
)
58 UsbCommand c
= {CMD_READ_SRI512_TAG
, {strtol(Cmd
, NULL
, 0), 0, 0}};
64 /* New command to read the contents of a SRIX4K tag
65 * SRIX4K tags are ISO14443-B modulated memory tags,
66 * this command just dumps the contents of the memory/
68 int CmdSrix4kRead(const char *Cmd
)
70 UsbCommand c
= {CMD_READ_SRIX4K_TAG
, {strtol(Cmd
, NULL
, 0), 0, 0}};
78 UsbCommand c
= {CMD_ISO_14443B_COMMAND
, {0, 0, 0}};
81 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
87 int HF14BCmdRaw(bool reply
, bool *crc
, bool power
, uint8_t *data
, uint8_t *datalen
, bool verbose
){
89 UsbCommand c
= {CMD_ISO_14443B_COMMAND
, {0, 0, 0}}; // len,recv,power
92 uint8_t first
, second
;
93 ComputeCrc14443(CRC_14443_B
, data
, *datalen
, &first
, &second
);
94 data
[*datalen
] = first
;
95 data
[*datalen
+ 1] = second
;
102 memcpy(c
.d
.asBytes
,data
,*datalen
);
103 clearCommandBuffer();
106 if (!reply
) return 1;
108 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,1000)) {
109 if (verbose
) PrintAndLog("timeout while waiting for reply.");
112 *datalen
= resp
.arg
[0];
113 if (verbose
) PrintAndLog("received %u octets", *datalen
);
114 if(*datalen
<2) return 0;
116 memcpy(data
, resp
.d
.asBytes
, *datalen
);
117 if (verbose
) PrintAndLog("%s", sprint_hex(data
, *datalen
));
119 uint8_t first
, second
;
120 ComputeCrc14443(CRC_14443_B
, data
, *datalen
-2, &first
, &second
);
121 if(data
[*datalen
-2] == first
&& data
[*datalen
-1] == second
) {
122 if (verbose
) PrintAndLog("CRC OK");
125 if (verbose
) PrintAndLog("CRC failed");
131 int CmdHF14BCmdRaw (const char *Cmd
) {
136 uint8_t data
[100] = {0x00};
141 PrintAndLog("Usage: hf 14b raw [-r] [-c] [-p] <0A 0B 0C ... hex>");
142 PrintAndLog(" -r do not read response");
143 PrintAndLog(" -c calculate and append CRC");
144 PrintAndLog(" -p leave the field on after receive");
149 while (*Cmd
==' ' || *Cmd
=='\t') Cmd
++;
151 while (Cmd
[i
]!='\0') {
152 if (Cmd
[i
]==' ' || Cmd
[i
]=='\t') { i
++; continue; }
168 PrintAndLog("Invalid option");
174 if ((Cmd
[i
]>='0' && Cmd
[i
]<='9') ||
175 (Cmd
[i
]>='a' && Cmd
[i
]<='f') ||
176 (Cmd
[i
]>='A' && Cmd
[i
]<='F') ) {
177 buf
[strlen(buf
)+1]=0;
178 buf
[strlen(buf
)]=Cmd
[i
];
181 if (strlen(buf
)>=2) {
182 sscanf(buf
,"%x",&temp
);
183 data
[datalen
++]=(uint8_t)(temp
& 0xff);
188 PrintAndLog("Invalid char on input");
193 PrintAndLog("Missing data input");
197 return HF14BCmdRaw(reply
, &crc
, power
, data
, &datalen
, true);
200 // print full atqb info
201 static void print_atqb_resp(uint8_t *data
){
202 PrintAndLog (" UID: %s", sprint_hex(data
+1,4));
203 PrintAndLog (" App Data: %s", sprint_hex(data
+5,4));
204 PrintAndLog (" Protocol: %s", sprint_hex(data
+9,3));
205 uint8_t BitRate
= data
[9];
207 PrintAndLog (" Bit Rate: 106 kbit/s only PICC <-> PCD");
209 PrintAndLog (" Bit Rate: 212 kbit/s PICC -> PCD supported");
211 PrintAndLog (" Bit Rate: 424 kbit/s PICC -> PCD supported");
213 PrintAndLog (" Bit Rate: 847 kbit/s PICC -> PCD supported");
215 PrintAndLog (" Bit Rate: 212 kbit/s PICC <- PCD supported");
217 PrintAndLog (" Bit Rate: 424 kbit/s PICC <- PCD supported");
219 PrintAndLog (" Bit Rate: 847 kbit/s PICC <- PCD supported");
221 PrintAndLog (" Same bit rate <-> required");
223 uint16_t maxFrame
= data
[10]>>4;
225 maxFrame
= 8*maxFrame
+ 16;
226 else if (maxFrame
== 5)
228 else if (maxFrame
== 6)
230 else if (maxFrame
== 7)
232 else if (maxFrame
== 8)
237 PrintAndLog ("Max Frame Size: %d%s",maxFrame
, (maxFrame
== 257) ? "+ RFU" : "");
239 uint8_t protocolT
= data
[10] & 0xF;
240 PrintAndLog (" Protocol Type: Protocol is %scompliant with ISO/IEC 14443-4",(protocolT
) ? "" : "not " );
241 PrintAndLog ("Frame Wait Int: %d", data
[11]>>4);
242 PrintAndLog (" App Data Code: Application is %s",(data
[11]&4) ? "Standard" : "Proprietary");
243 PrintAndLog (" Frame Options: NAD is %ssupported",(data
[11]&2) ? "" : "not ");
244 PrintAndLog (" Frame Options: CID is %ssupported",(data
[11]&1) ? "" : "not ");
249 // get SRx chip model (from UID) // from ST Microelectronics
250 char *get_ST_Chip_Model(uint8_t data
){
251 static char model
[20];
252 char *retStr
= model
;
253 memset(model
,0, sizeof(model
));
256 case 0x0: sprintf(retStr
, "SRIX4K (Special)"); break;
257 case 0x2: sprintf(retStr
, "SR176"); break;
258 case 0x3: sprintf(retStr
, "SRIX4K"); break;
259 case 0x4: sprintf(retStr
, "SRIX512"); break;
260 case 0x6: sprintf(retStr
, "SRI512"); break;
261 case 0x7: sprintf(retStr
, "SRI4K"); break;
262 case 0xC: sprintf(retStr
, "SRT512"); break;
263 default : sprintf(retStr
, "Unknown"); break;
268 int print_ST_Lock_info(uint8_t model
){
269 //assume connection open and tag selected...
270 uint8_t data
[16] = {0x00};
277 if (model
== 0x2) { //SR176 has special command:
286 if (HF14BCmdRaw(true, &crc
, true, data
, &datalen
, false)==0) return rawClose();
288 if (datalen
!= resplen
|| !crc
) return rawClose();
290 PrintAndLog("Chip Write Protection Bits:");
291 // now interpret the data
293 case 0x0: //fall through (SRIX4K special)
294 case 0x3: //fall through (SRIx4K)
298 PrintAndLog(" raw: %s",printBits(1,data
+3));
299 PrintAndLog(" 07/08:%slocked", (data
[3] & 1) ? " not " : " " );
300 for (uint8_t i
= 1; i
<8; i
++){
301 PrintAndLog(" %02u:%slocked", blk1
, (data
[3] & (1 << i
)) ? " not " : " " );
305 case 0x4: //fall through (SRIX512)
306 case 0x6: //fall through (SRI512)
307 case 0xC: // (SRT512)
308 //need data[2] and data[3]
310 PrintAndLog(" raw: %s",printBits(2,data
+2));
311 for (uint8_t b
=2; b
<4; b
++){
312 for (uint8_t i
=0; i
<8; i
++){
313 PrintAndLog(" %02u:%slocked", blk1
, (data
[b
] & (1 << i
)) ? " not " : " " );
321 PrintAndLog(" raw: %s",printBits(1,data
+2));
322 for (uint8_t i
= 0; i
<8; i
++){
323 PrintAndLog(" %02u/%02u:%slocked", blk1
, blk1
+1, (data
[2] & (1 << i
)) ? " " : " not " );
333 // print UID info from SRx chips (ST Microelectronics)
334 static void print_st_general_info(uint8_t *data
){
335 //uid = first 8 bytes in data
336 PrintAndLog(" UID: %s", sprint_hex(SwapEndian64(data
,8,8),8));
337 PrintAndLog(" MFG: %02X, %s", data
[6], getTagInfo(data
[6]));
338 PrintAndLog(" Chip: %02X, %s", data
[5]>>2, get_ST_Chip_Model(data
[5]>>2));
342 // 14b get and print UID only (general info)
343 int HF14BStdReader(uint8_t *data
, uint8_t *datalen
){
344 //05 00 00 = find one tag in field
345 //1d xx xx xx xx 20 00 08 01 00 = attrib xx=crc
346 //a3 = ? (resp 03 e2 c2)
347 //02 = ? (resp 02 6a d3)
348 // 022b (resp 02 67 00 [29 5b])
349 // 0200a40400 (resp 02 67 00 [29 5b])
350 // 0200a4040c07a0000002480300 (resp 02 67 00 [29 5b])
351 // 0200a4040c07a0000002480200 (resp 02 67 00 [29 5b])
352 // 0200a4040006a0000000010100 (resp 02 6a 82 [4b 4c])
353 // 0200a4040c09d27600002545500200 (resp 02 67 00 [29 5b])
354 // 0200a404000cd2760001354b414e4d30310000 (resp 02 6a 82 [4b 4c])
355 // 0200a404000ca000000063504b43532d313500 (resp 02 6a 82 [4b 4c])
356 // 0200a4040010a000000018300301000000000000000000 (resp 02 6a 82 [4b 4c])
357 //03 = ? (resp 03 [e3 c2])
358 //c2 = ? (resp c2 [66 15])
359 //b2 = ? (resp a3 [e9 67])
367 if (HF14BCmdRaw(true, &crc
, false, data
, datalen
, false)==0) return 0;
369 if (data
[0] != 0x50 || *datalen
!= 14 || !crc
) return 0;
371 PrintAndLog ("\n14443-3b tag found:");
372 PrintAndLog (" UID: %s", sprint_hex(data
+1,4));
377 // 14b get and print Full Info (as much as we know)
378 int HF14BStdInfo(uint8_t *data
, uint8_t *datalen
){
379 if (!HF14BStdReader(data
,datalen
)) return 0;
382 print_atqb_resp(data
);
387 // SRx get and print general info about SRx chip from UID
388 int HF14B_ST_Reader(uint8_t *data
, uint8_t *datalen
, bool closeCon
){
396 // verbose on for now for testing - turn off when functional
397 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)==0) return rawClose();
399 if (*datalen
!= 3 || !crc
) return rawClose();
401 uint8_t chipID
= data
[0];
408 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)==0) return rawClose();
410 if (*datalen
!= 3 || !crc
|| data
[0] != chipID
) return rawClose();
417 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)==0) return rawClose();
419 if (*datalen
!= 10 || !crc
) return rawClose();
422 if (closeCon
) rawClose();
424 PrintAndLog("\n14443-3b ST tag found:");
425 print_st_general_info(data
);
429 // SRx get and print full info (needs more info...)
430 int HF14B_ST_Info(uint8_t *data
, uint8_t *datalen
){
431 if (!HF14B_ST_Reader(data
, datalen
, false)) return 0;
433 //add locking bit information here.
434 if (print_ST_Lock_info(data
[5]>>2))
440 // test for other 14b type tags (mimic another reader - don't have tags to identify)
441 int HF14B_Other_Reader(uint8_t *data
, uint8_t *datalen
){
450 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)!=0) {
451 if (*datalen
> 2 || !crc
) {
452 PrintAndLog ("\n14443-3b tag found:");
453 PrintAndLog ("Unknown tag type answered to a 0x000b3f80 command ans:");
454 PrintAndLog ("%s",sprint_hex(data
,*datalen
));
464 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)!=0) {
466 PrintAndLog ("\n14443-3b tag found:");
467 PrintAndLog ("Unknown tag type answered to a 0x0A command ans:");
468 PrintAndLog ("%s",sprint_hex(data
,*datalen
));
478 if (HF14BCmdRaw(true, &crc
, true, data
, datalen
, false)!=0) {
480 PrintAndLog ("\n14443-3b tag found:");
481 PrintAndLog ("Unknown tag type answered to a 0x0C command ans:");
482 PrintAndLog ("%s",sprint_hex(data
,*datalen
));
491 // get and print all info known about any known 14b tag
492 int HF14BInfo(bool verbose
){
496 // try std 14b (atqb)
497 if (HF14BStdInfo(data
, &datalen
)) return 1;
500 if (HF14B_ST_Info(data
, &datalen
)) return 1;
502 // try unknown 14b read commands (to be identified later)
503 // could be read of calypso, CEPAS, moneo, or pico pass.
504 if (HF14B_Other_Reader(data
, &datalen
)) return 1;
506 if (verbose
) PrintAndLog("no 14443B tag found");
510 // menu command to get and print all info known about any known 14b tag
511 int CmdHF14Binfo(const char *Cmd
){
512 return HF14BInfo(true);
515 // get and print general info about all known 14b chips
516 int HF14BReader(bool verbose
){
520 // try std 14b (atqb)
521 if (HF14BStdReader(data
, &datalen
)) return 1;
524 if (HF14B_ST_Reader(data
, &datalen
, true)) return 1;
526 // try unknown 14b read commands (to be identified later)
527 // could be read of calypso, CEPAS, moneo, or pico pass.
528 if (HF14B_Other_Reader(data
, &datalen
)) return 1;
530 if (verbose
) PrintAndLog("no 14443B tag found");
534 // menu command to get and print general info about all known 14b chips
535 int CmdHF14BReader(const char *Cmd
){
536 return HF14BReader(true);
539 int CmdSriWrite( const char *Cmd
){
541 * For SRIX4K blocks 00 - 7F
542 * hf 14b raw -c -p 09 $srix4kwblock $srix4kwdata
544 * For SR512 blocks 00 - 0F
545 * hf 14b raw -c -p 09 $sr512wblock $sr512wdata
547 * Special block FF = otp_lock_reg block.
550 char cmdp
= param_getchar(Cmd
, 0);
551 uint8_t blockno
= -1;
552 uint8_t data
[4] = {0x00};
553 bool isSrix4k
= true;
556 if (strlen(Cmd
) < 1 || cmdp
== 'h' || cmdp
== 'H') {
557 PrintAndLog("Usage: hf 14b write <1|2> <BLOCK> <DATA>");
558 PrintAndLog(" [1 = SRIX4K]");
559 PrintAndLog(" [2 = SRI512]");
560 PrintAndLog(" [BLOCK number depends on tag, special block == FF]");
561 PrintAndLog(" sample: hf 14b write 1 7F 11223344");
562 PrintAndLog(" : hf 14b write 1 FF 11223344");
563 PrintAndLog(" : hf 14b write 2 15 11223344");
564 PrintAndLog(" : hf 14b write 2 FF 11223344");
571 //blockno = param_get8(Cmd, 1);
573 if ( param_gethex(Cmd
,1, &blockno
, 2) ) {
574 PrintAndLog("Block number must include 2 HEX symbols");
579 if ( blockno
> 0x7f && blockno
!= 0xff ){
580 PrintAndLog("Block number out of range");
584 if ( blockno
> 0x0f && blockno
!= 0xff ){
585 PrintAndLog("Block number out of range");
590 if (param_gethex(Cmd
, 2, data
, 8)) {
591 PrintAndLog("Data must include 8 HEX symbols");
595 if ( blockno
== 0xff)
596 PrintAndLog("[%s] Write special block %02X [ %s ]", (isSrix4k
)?"SRIX4K":"SRI512" , blockno
, sprint_hex(data
,4) );
598 PrintAndLog("[%s] Write block %02X [ %s ]", (isSrix4k
)?"SRIX4K":"SRI512", blockno
, sprint_hex(data
,4) );
600 sprintf(str
, "-c 09 %02x %02x%02x%02x%02x", blockno
, data
[0], data
[1], data
[2], data
[3]);
606 static command_t CommandTable
[] =
608 {"help", CmdHelp
, 1, "This help"},
609 {"info", CmdHF14Binfo
, 0, "Find and print details about a 14443B tag"},
610 {"list", CmdHF14BList
, 0, "[Deprecated] List ISO 14443B history"},
611 {"reader", CmdHF14BReader
, 0, "Act as a 14443B reader to identify a tag"},
612 {"sim", CmdHF14BSim
, 0, "Fake ISO 14443B tag"},
613 {"snoop", CmdHF14BSnoop
, 0, "Eavesdrop ISO 14443B"},
614 {"sri512read", CmdSri512Read
, 0, "Read contents of a SRI512 tag"},
615 {"srix4kread", CmdSrix4kRead
, 0, "Read contents of a SRIX4K tag"},
616 {"sriwrite", CmdSriWrite
, 0, "Write data to a SRI512 | SRIX4K tag"},
617 {"raw", CmdHF14BCmdRaw
, 0, "Send raw hex data to tag"},
618 {NULL
, NULL
, 0, NULL
}
621 int CmdHF14B(const char *Cmd
)
623 CmdsParse(CommandTable
, Cmd
);
627 int CmdHelp(const char *Cmd
)
629 CmdsHelp(CommandTable
);