]>
cvs.zerfleddert.de Git - proxmark3-svn/blob - client/cmdhfmf.c
1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2011,2012 Merlok
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 MIFARE commands
9 //-----------------------------------------------------------------------------
20 #include "cmdhfmfhard.h"
23 #include "util_posix.h"
26 #include "mifare/mifarehost.h"
28 #include "mifare/mfkey.h"
29 #include "hardnested/hardnested_bf_core.h"
30 #include "cliparser/cliparser.h"
32 #include "mifare/mifaredefault.h"
33 #include "mifare/mifare4.h"
34 #include "mifare/mad.h"
35 #include "mifare/ndef.h"
38 #define NESTED_SECTOR_RETRY 10 // how often we try mfested() until we give up
40 static int CmdHelp ( const char * Cmd
);
42 int CmdHF14AMifare ( const char * Cmd
)
46 isOK
= mfDarkside (& key
);
48 case - 1 : PrintAndLog ( "Button pressed. Aborted." ); return 1 ;
49 case - 2 : PrintAndLog ( "Card is not vulnerable to Darkside attack (doesn't send NACK on authentication requests)." ); return 1 ;
50 case - 3 : PrintAndLog ( "Card is not vulnerable to Darkside attack (its random number generator is not predictable)." ); return 1 ;
51 case - 4 : PrintAndLog ( "Card is not vulnerable to Darkside attack (its random number generator seems to be based on the wellknown" );
52 PrintAndLog ( "generating polynomial with 16 effective bits only, but shows unexpected behaviour." ); return 1 ;
53 case - 5 : PrintAndLog ( "Aborted via keyboard." ); return 1 ;
54 default : PrintAndLog ( "Found valid key:%012" PRIx64
" \n " , key
);
62 int CmdHF14AMfWrBl ( const char * Cmd
)
66 uint8_t key
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
67 uint8_t bldata
[ 16 ] = { 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 };
72 PrintAndLog ( "Usage: hf mf wrbl <block number> <key A/B> <key (12 hex symbols)> <block data (32 hex symbols)>" );
73 PrintAndLog ( " sample: hf mf wrbl 0 A FFFFFFFFFFFF 000102030405060708090A0B0C0D0E0F" );
77 blockNo
= param_get8 ( Cmd
, 0 );
78 cmdp
= param_getchar ( Cmd
, 1 );
80 PrintAndLog ( "Key type must be A or B" );
83 if ( cmdp
!= 'A' && cmdp
!= 'a' ) keyType
= 1 ;
84 if ( param_gethex ( Cmd
, 2 , key
, 12 )) {
85 PrintAndLog ( "Key must include 12 HEX symbols" );
88 if ( param_gethex ( Cmd
, 3 , bldata
, 32 )) {
89 PrintAndLog ( "Block data must include 32 HEX symbols" );
92 PrintAndLog ( "--block no:%d, key type:%c, key:%s" , blockNo
, keyType
? 'B' : 'A' , sprint_hex ( key
, 6 ));
93 PrintAndLog ( "--data: %s" , sprint_hex ( bldata
, 16 ));
95 UsbCommand c
= { CMD_MIFARE_WRITEBL
, { blockNo
, keyType
, 0 }};
96 memcpy ( c
. d
. asBytes
, key
, 6 );
97 memcpy ( c
. d
. asBytes
+ 10 , bldata
, 16 );
101 if ( WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
102 uint8_t isOK
= resp
. arg
[ 0 ] & 0xff ;
103 PrintAndLog ( "isOk:%02x" , isOK
);
105 PrintAndLog ( "Command execute timeout" );
111 int CmdHF14AMfRdBl ( const char * Cmd
)
115 uint8_t key
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
121 PrintAndLog ( "Usage: hf mf rdbl <block number> <key A/B> <key (12 hex symbols)>" );
122 PrintAndLog ( " sample: hf mf rdbl 0 A FFFFFFFFFFFF " );
126 blockNo
= param_get8 ( Cmd
, 0 );
127 cmdp
= param_getchar ( Cmd
, 1 );
129 PrintAndLog ( "Key type must be A or B" );
132 if ( cmdp
!= 'A' && cmdp
!= 'a' ) keyType
= 1 ;
133 if ( param_gethex ( Cmd
, 2 , key
, 12 )) {
134 PrintAndLog ( "Key must include 12 HEX symbols" );
137 PrintAndLog ( "--block no:%d, key type:%c, key:%s " , blockNo
, keyType
? 'B' : 'A' , sprint_hex ( key
, 6 ));
139 UsbCommand c
= { CMD_MIFARE_READBL
, { blockNo
, keyType
, 0 }};
140 memcpy ( c
. d
. asBytes
, key
, 6 );
144 if ( WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
145 uint8_t isOK
= resp
. arg
[ 0 ] & 0xff ;
146 uint8_t * data
= resp
. d
. asBytes
;
149 PrintAndLog ( "isOk:%02x data:%s" , isOK
, sprint_hex ( data
, 16 ));
151 PrintAndLog ( "isOk:%02x" , isOK
);
155 if ( mfIsSectorTrailer ( blockNo
) && ( data
[ 6 ] || data
[ 7 ] || data
[ 8 ])) {
156 PrintAndLogEx ( NORMAL
, "Trailer decoded:" );
157 int bln
= mfFirstBlockOfSector ( mfSectorNum ( blockNo
));
158 int blinc
= ( mfNumBlocksPerSector ( mfSectorNum ( blockNo
)) > 4 ) ? 5 : 1 ;
159 for ( int i
= 0 ; i
< 4 ; i
++) {
160 PrintAndLogEx ( NORMAL
, "Access block %d%s: %s" , bln
, (( blinc
> 1 ) && ( i
< 3 ) ? "+" : "" ) , mfGetAccessConditionsDesc ( i
, & data
[ 6 ]));
163 PrintAndLogEx ( NORMAL
, "UserData: %s" , sprint_hex_inrow (& data
[ 9 ], 1 ));
166 PrintAndLog ( "Command execute timeout" );
173 int CmdHF14AMfRdSc ( const char * Cmd
)
176 uint8_t sectorNo
= 0 ;
178 uint8_t key
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
180 uint8_t * data
= NULL
;
184 PrintAndLog ( "Usage: hf mf rdsc <sector number> <key A/B> <key (12 hex symbols)>" );
185 PrintAndLog ( " sample: hf mf rdsc 0 A FFFFFFFFFFFF " );
189 sectorNo
= param_get8 ( Cmd
, 0 );
191 PrintAndLog ( "Sector number must be less than 40" );
194 cmdp
= param_getchar ( Cmd
, 1 );
195 if ( cmdp
!= 'a' && cmdp
!= 'A' && cmdp
!= 'b' && cmdp
!= 'B' ) {
196 PrintAndLog ( "Key type must be A or B" );
199 if ( cmdp
!= 'A' && cmdp
!= 'a' ) keyType
= 1 ;
200 if ( param_gethex ( Cmd
, 2 , key
, 12 )) {
201 PrintAndLog ( "Key must include 12 HEX symbols" );
204 PrintAndLog ( "--sector no:%d key type:%c key:%s " , sectorNo
, keyType
? 'B' : 'A' , sprint_hex ( key
, 6 ));
206 UsbCommand c
= { CMD_MIFARE_READSC
, { sectorNo
, keyType
, 0 }};
207 memcpy ( c
. d
. asBytes
, key
, 6 );
212 if ( WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
213 isOK
= resp
. arg
[ 0 ] & 0xff ;
214 data
= resp
. d
. asBytes
;
216 PrintAndLog ( "isOk:%02x" , isOK
);
218 for ( i
= 0 ; i
< ( sectorNo
< 32 ? 3 : 15 ); i
++) {
219 PrintAndLog ( "data : %s" , sprint_hex ( data
+ i
* 16 , 16 ));
221 PrintAndLog ( "trailer: %s" , sprint_hex ( data
+ ( sectorNo
< 32 ? 3 : 15 ) * 16 , 16 ));
223 PrintAndLogEx ( NORMAL
, "Trailer decoded:" );
224 int bln
= mfFirstBlockOfSector ( sectorNo
);
225 int blinc
= ( mfNumBlocksPerSector ( sectorNo
) > 4 ) ? 5 : 1 ;
226 for ( i
= 0 ; i
< 4 ; i
++) {
227 PrintAndLogEx ( NORMAL
, "Access block %d%s: %s" , bln
, (( blinc
> 1 ) && ( i
< 3 ) ? "+" : "" ) , mfGetAccessConditionsDesc ( i
, &( data
+ ( sectorNo
< 32 ? 3 : 15 ) * 16 )[ 6 ]));
230 PrintAndLogEx ( NORMAL
, "UserData: %s" , sprint_hex_inrow (&( data
+ ( sectorNo
< 32 ? 3 : 15 ) * 16 )[ 9 ], 1 ));
233 PrintAndLog ( "Command execute timeout" );
239 uint8_t FirstBlockOfSector ( uint8_t sectorNo
)
244 return 32 * 4 + ( sectorNo
- 32 ) * 16 ;
248 uint8_t NumBlocksPerSector ( uint8_t sectorNo
)
257 static int ParamCardSizeSectors ( const char c
) {
260 case '0' : numSectors
= 5 ; break ;
261 case '2' : numSectors
= 32 ; break ;
262 case '4' : numSectors
= 40 ; break ;
263 default : numSectors
= 16 ;
268 static int ParamCardSizeBlocks ( const char c
) {
269 int numBlocks
= 16 * 4 ;
271 case '0' : numBlocks
= 5 * 4 ; break ;
272 case '2' : numBlocks
= 32 * 4 ; break ;
273 case '4' : numBlocks
= 32 * 4 + 8 * 16 ; break ;
274 default : numBlocks
= 16 * 4 ;
279 int CmdHF14AMfDump ( const char * Cmd
)
281 uint8_t sectorNo
, blockNo
;
283 uint8_t keys
[ 2 ][ 40 ][ 6 ];
284 uint8_t rights
[ 40 ][ 4 ];
285 uint8_t carddata
[ 256 ][ 16 ];
286 uint8_t numSectors
= 16 ;
293 char cmdp
= param_getchar ( Cmd
, 0 );
294 numSectors
= ParamCardSizeSectors ( cmdp
);
296 if ( strlen ( Cmd
) > 3 || cmdp
== 'h' || cmdp
== 'H' ) {
297 PrintAndLog ( "Usage: hf mf dump [card memory] [k|m]" );
298 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
299 PrintAndLog ( " k: Always try using both Key A and Key B for each sector, even if access bits would prohibit it" );
300 PrintAndLog ( " m: When missing access bits or keys, replace that block with NULL" );
302 PrintAndLog ( "Samples: hf mf dump" );
303 PrintAndLog ( " hf mf dump 4" );
304 PrintAndLog ( " hf mf dump 4 m" );
308 char opts
= param_getchar ( Cmd
, 1 );
309 bool useBothKeysAlways
= false ;
310 if ( opts
== 'k' || opts
== 'K' ) useBothKeysAlways
= true ;
311 bool nullMissingKeys
= false ;
312 if ( opts
== 'm' || opts
== 'M' ) nullMissingKeys
= true ;
314 if (( fin
= fopen ( "dumpkeys.bin" , "rb" )) == NULL
) {
315 PrintAndLog ( "Could not find file dumpkeys.bin" );
319 // Read keys from file
320 for ( int group
= 0 ; group
<= 1 ; group
++) {
321 for ( sectorNo
= 0 ; sectorNo
< numSectors
; sectorNo
++) {
322 size_t bytes_read
= fread ( keys
[ group
][ sectorNo
], 1 , 6 , fin
);
323 if ( bytes_read
!= 6 ) {
324 PrintAndLog ( "File reading error." );
333 PrintAndLog ( "|-----------------------------------------|" );
334 PrintAndLog ( "|------ Reading sector access bits...-----|" );
335 PrintAndLog ( "|-----------------------------------------|" );
337 for ( sectorNo
= 0 ; sectorNo
< numSectors
; sectorNo
++) {
338 for ( tries
= 0 ; tries
< 3 ; tries
++) {
339 UsbCommand c
= { CMD_MIFARE_READBL
, { FirstBlockOfSector ( sectorNo
) + NumBlocksPerSector ( sectorNo
) - 1 , 0 , 0 }};
340 // At least the Access Conditions can always be read with key A.
341 memcpy ( c
. d
. asBytes
, keys
[ 0 ][ sectorNo
], 6 );
344 if ( WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
345 uint8_t isOK
= resp
. arg
[ 0 ] & 0xff ;
346 uint8_t * data
= resp
. d
. asBytes
;
348 rights
[ sectorNo
][ 0 ] = (( data
[ 7 ] & 0x10 )>> 2 ) | (( data
[ 8 ] & 0x1 )<< 1 ) | (( data
[ 8 ] & 0x10 )>> 4 ); // C1C2C3 for data area 0
349 rights
[ sectorNo
][ 1 ] = (( data
[ 7 ] & 0x20 )>> 3 ) | (( data
[ 8 ] & 0x2 )<< 0 ) | (( data
[ 8 ] & 0x20 )>> 5 ); // C1C2C3 for data area 1
350 rights
[ sectorNo
][ 2 ] = (( data
[ 7 ] & 0x40 )>> 4 ) | (( data
[ 8 ] & 0x4 )>> 1 ) | (( data
[ 8 ] & 0x40 )>> 6 ); // C1C2C3 for data area 2
351 rights
[ sectorNo
][ 3 ] = (( data
[ 7 ] & 0x80 )>> 5 ) | (( data
[ 8 ] & 0x8 )>> 2 ) | (( data
[ 8 ] & 0x80 )>> 7 ); // C1C2C3 for sector trailer
353 } else if ( tries
== 2 ) { // on last try set defaults
354 PrintAndLog ( "Could not get access rights for sector %2d. Trying with defaults..." , sectorNo
);
355 rights
[ sectorNo
][ 0 ] = rights
[ sectorNo
][ 1 ] = rights
[ sectorNo
][ 2 ] = 0x00 ;
356 rights
[ sectorNo
][ 3 ] = 0x01 ;
359 PrintAndLog ( "Command execute timeout when trying to read access rights for sector %2d. Trying with defaults..." , sectorNo
);
360 rights
[ sectorNo
][ 0 ] = rights
[ sectorNo
][ 1 ] = rights
[ sectorNo
][ 2 ] = 0x00 ;
361 rights
[ sectorNo
][ 3 ] = 0x01 ;
366 PrintAndLog ( "|-----------------------------------------|" );
367 PrintAndLog ( "|----- Dumping all blocks to file... -----|" );
368 PrintAndLog ( "|-----------------------------------------|" );
371 for ( sectorNo
= 0 ; isOK
&& sectorNo
< numSectors
; sectorNo
++) {
372 for ( blockNo
= 0 ; isOK
&& blockNo
< NumBlocksPerSector ( sectorNo
); blockNo
++) {
373 bool received
= false ;
374 for ( tries
= 0 ; tries
< 3 ; tries
++) {
375 if ( blockNo
== NumBlocksPerSector ( sectorNo
) - 1 ) { // sector trailer. At least the Access Conditions can always be read with key A.
376 UsbCommand c
= { CMD_MIFARE_READBL
, { FirstBlockOfSector ( sectorNo
) + blockNo
, 0 , 0 }};
377 memcpy ( c
. d
. asBytes
, keys
[ 0 ][ sectorNo
], 6 );
379 received
= WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 );
380 } else if ( useBothKeysAlways
) {
381 // Always try both keys, even if access conditions wouldn't work.
382 for ( int k
= 0 ; k
<= 1 ; k
++) {
383 UsbCommand c
= { CMD_MIFARE_READBL
, { FirstBlockOfSector ( sectorNo
) + blockNo
, 1 , 0 }};
384 memcpy ( c
. d
. asBytes
, keys
[ k
][ sectorNo
], 6 );
386 received
= WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 );
388 // Don't try the other one on success.
389 if ( resp
. arg
[ 0 ] & 0xff ) break ;
391 } else { // data block. Check if it can be read with key A or key B
392 uint8_t data_area
= sectorNo
< 32 ? blockNo
: blockNo
/ 5 ;
393 if (( rights
[ sectorNo
][ data_area
] == 0x03 ) || ( rights
[ sectorNo
][ data_area
] == 0x05 )) { // only key B would work
394 UsbCommand c
= { CMD_MIFARE_READBL
, { FirstBlockOfSector ( sectorNo
) + blockNo
, 1 , 0 }};
395 memcpy ( c
. d
. asBytes
, keys
[ 1 ][ sectorNo
], 6 );
397 received
= WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 );
398 } else if ( rights
[ sectorNo
][ data_area
] == 0x07 ) { // no key would work
399 PrintAndLog ( "Access rights do not allow reading of sector %2d block %3d" , sectorNo
, blockNo
);
400 if ( nullMissingKeys
) {
401 memset ( resp
. d
. asBytes
, 0 , 16 );
403 PrintAndLog ( " ... filling the block with NULL" );
409 } else { // key A would work
410 UsbCommand c
= { CMD_MIFARE_READBL
, { FirstBlockOfSector ( sectorNo
) + blockNo
, 0 , 0 }};
411 memcpy ( c
. d
. asBytes
, keys
[ 0 ][ sectorNo
], 6 );
413 received
= WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 );
417 isOK
= resp
. arg
[ 0 ] & 0xff ;
423 isOK
= resp
. arg
[ 0 ] & 0xff ;
424 uint8_t * data
= resp
. d
. asBytes
;
425 if ( blockNo
== NumBlocksPerSector ( sectorNo
) - 1 ) { // sector trailer. Fill in the keys.
426 memcpy ( data
, keys
[ 0 ][ sectorNo
], 6 );
427 memcpy ( data
+ 10 , keys
[ 1 ][ sectorNo
], 6 );
430 memcpy ( carddata
[ FirstBlockOfSector ( sectorNo
) + blockNo
], data
, 16 );
431 PrintAndLog ( "Successfully read block %2d of sector %2d." , blockNo
, sectorNo
);
433 PrintAndLog ( "Could not read block %2d of sector %2d" , blockNo
, sectorNo
);
439 PrintAndLog ( "Command execute timeout when trying to read block %2d of sector %2d." , blockNo
, sectorNo
);
446 if (( fout
= fopen ( "dumpdata.bin" , "wb" )) == NULL
) {
447 PrintAndLog ( "Could not create file name dumpdata.bin" );
450 uint16_t numblocks
= FirstBlockOfSector ( numSectors
- 1 ) + NumBlocksPerSector ( numSectors
- 1 );
451 fwrite ( carddata
, 1 , 16 * numblocks
, fout
);
453 PrintAndLog ( "Dumped %d blocks (%d bytes) to file dumpdata.bin" , numblocks
, 16 * numblocks
);
459 int CmdHF14AMfRestore ( const char * Cmd
)
461 uint8_t sectorNo
, blockNo
;
463 uint8_t key
[ 6 ] = { 0xFF , 0xFF , 0xFF , 0xFF , 0xFF , 0xFF };
464 uint8_t bldata
[ 16 ] = { 0x00 };
472 char cmdp
= param_getchar ( Cmd
, 0 );
474 case '0' : numSectors
= 5 ; break ;
476 case '\0' : numSectors
= 16 ; break ;
477 case '2' : numSectors
= 32 ; break ;
478 case '4' : numSectors
= 40 ; break ;
479 default : numSectors
= 16 ;
482 if ( strlen ( Cmd
) > 1 || cmdp
== 'h' || cmdp
== 'H' ) {
483 PrintAndLog ( "Usage: hf mf restore [card memory]" );
484 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
486 PrintAndLog ( "Samples: hf mf restore" );
487 PrintAndLog ( " hf mf restore 4" );
491 if (( fkeys
= fopen ( "dumpkeys.bin" , "rb" )) == NULL
) {
492 PrintAndLog ( "Could not find file dumpkeys.bin" );
496 for ( sectorNo
= 0 ; sectorNo
< numSectors
; sectorNo
++) {
497 size_t bytes_read
= fread ( keyA
[ sectorNo
], 1 , 6 , fkeys
);
498 if ( bytes_read
!= 6 ) {
499 PrintAndLog ( "File reading error (dumpkeys.bin)." );
505 for ( sectorNo
= 0 ; sectorNo
< numSectors
; sectorNo
++) {
506 size_t bytes_read
= fread ( keyB
[ sectorNo
], 1 , 6 , fkeys
);
507 if ( bytes_read
!= 6 ) {
508 PrintAndLog ( "File reading error (dumpkeys.bin)." );
516 if (( fdump
= fopen ( "dumpdata.bin" , "rb" )) == NULL
) {
517 PrintAndLog ( "Could not find file dumpdata.bin" );
520 PrintAndLog ( "Restoring dumpdata.bin to card" );
522 for ( sectorNo
= 0 ; sectorNo
< numSectors
; sectorNo
++) {
523 for ( blockNo
= 0 ; blockNo
< NumBlocksPerSector ( sectorNo
); blockNo
++) {
524 UsbCommand c
= { CMD_MIFARE_WRITEBL
, { FirstBlockOfSector ( sectorNo
) + blockNo
, keyType
, 0 }};
525 memcpy ( c
. d
. asBytes
, key
, 6 );
527 size_t bytes_read
= fread ( bldata
, 1 , 16 , fdump
);
528 if ( bytes_read
!= 16 ) {
529 PrintAndLog ( "File reading error (dumpdata.bin)." );
534 if ( blockNo
== NumBlocksPerSector ( sectorNo
) - 1 ) { // sector trailer
535 bldata
[ 0 ] = ( keyA
[ sectorNo
][ 0 ]);
536 bldata
[ 1 ] = ( keyA
[ sectorNo
][ 1 ]);
537 bldata
[ 2 ] = ( keyA
[ sectorNo
][ 2 ]);
538 bldata
[ 3 ] = ( keyA
[ sectorNo
][ 3 ]);
539 bldata
[ 4 ] = ( keyA
[ sectorNo
][ 4 ]);
540 bldata
[ 5 ] = ( keyA
[ sectorNo
][ 5 ]);
541 bldata
[ 10 ] = ( keyB
[ sectorNo
][ 0 ]);
542 bldata
[ 11 ] = ( keyB
[ sectorNo
][ 1 ]);
543 bldata
[ 12 ] = ( keyB
[ sectorNo
][ 2 ]);
544 bldata
[ 13 ] = ( keyB
[ sectorNo
][ 3 ]);
545 bldata
[ 14 ] = ( keyB
[ sectorNo
][ 4 ]);
546 bldata
[ 15 ] = ( keyB
[ sectorNo
][ 5 ]);
549 PrintAndLog ( "Writing to block %3d: %s" , FirstBlockOfSector ( sectorNo
) + blockNo
, sprint_hex ( bldata
, 16 ));
551 memcpy ( c
. d
. asBytes
+ 10 , bldata
, 16 );
555 if ( WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
556 uint8_t isOK
= resp
. arg
[ 0 ] & 0xff ;
557 PrintAndLog ( "isOk:%02x" , isOK
);
559 PrintAndLog ( "Command execute timeout" );
568 //----------------------------------------------
570 //----------------------------------------------
572 static void parseParamTDS ( const char * Cmd
, const uint8_t indx
, bool * paramT
, bool * paramD
, uint8_t * timeout
) {
574 int len
= param_getlength ( Cmd
, indx
);
575 if ( len
> 0 && len
< 4 ){
576 param_getstr ( Cmd
, indx
, ctmp3
, sizeof ( ctmp3
));
578 * paramT
|= ( ctmp3
[ 0 ] == 't' || ctmp3
[ 0 ] == 'T' );
579 * paramD
|= ( ctmp3
[ 0 ] == 'd' || ctmp3
[ 0 ] == 'D' );
580 bool paramS1
= * paramT
|| * paramD
;
582 // slow and very slow
583 if ( ctmp3
[ 0 ] == 's' || ctmp3
[ 0 ] == 'S' || ctmp3
[ 1 ] == 's' || ctmp3
[ 1 ] == 'S' ) {
584 * timeout
= 11 ; // slow
586 if (! paramS1
&& ( ctmp3
[ 1 ] == 's' || ctmp3
[ 1 ] == 'S' )) {
587 * timeout
= 53 ; // very slow
589 if ( paramS1
&& ( ctmp3
[ 2 ] == 's' || ctmp3
[ 2 ] == 'S' )) {
590 * timeout
= 53 ; // very slow
596 int CmdHF14AMfNested ( const char * Cmd
)
598 int i
, j
, res
, iterations
;
599 sector_t
* e_sector
= NULL
;
602 uint8_t trgBlockNo
= 0 ;
603 uint8_t trgKeyType
= 0 ;
604 uint8_t SectorsCnt
= 0 ;
605 uint8_t key
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
606 uint8_t keyBlock
[ MifareDefaultKeysSize
* 6 ];
608 // timeout in units. (ms * 106)/10 or us*0.0106
609 uint8_t btimeout14a
= MF_CHKKEYS_DEFTIMEOUT
; // fast by default
611 bool autosearchKey
= false ;
613 bool transferToEml
= false ;
614 bool createDumpFile
= false ;
616 uint8_t standart
[ 6 ] = { 0xFF , 0xFF , 0xFF , 0xFF , 0xFF , 0xFF };
617 uint8_t tempkey
[ 6 ] = { 0xFF , 0xFF , 0xFF , 0xFF , 0xFF , 0xFF };
622 PrintAndLog ( "Usage:" );
623 PrintAndLog ( " all sectors: hf mf nested <card memory> <block number> <key A/B> <key (12 hex symbols)> [t|d|s|ss]" );
624 PrintAndLog ( " all sectors autosearch key: hf mf nested <card memory> * [t|d|s|ss]" );
625 PrintAndLog ( " one sector: hf mf nested o <block number> <key A/B> <key (12 hex symbols)>" );
626 PrintAndLog ( " <target block number> <target key A/B> [t]" );
628 PrintAndLog ( "card memory - 0 - MINI(320 bytes), 1 - 1K, 2 - 2K, 4 - 4K, <other> - 1K" );
629 PrintAndLog ( "t - transfer keys to emulator memory" );
630 PrintAndLog ( "d - write keys to binary file dumpkeys.bin" );
631 PrintAndLog ( "s - Slow (1ms) check keys (required by some non standard cards)" );
632 PrintAndLog ( "ss - Very slow (5ms) check keys" );
634 PrintAndLog ( " sample1: hf mf nested 1 0 A FFFFFFFFFFFF " );
635 PrintAndLog ( " sample2: hf mf nested 1 0 A FFFFFFFFFFFF t " );
636 PrintAndLog ( " sample3: hf mf nested 1 0 A FFFFFFFFFFFF d " );
637 PrintAndLog ( " sample4: hf mf nested o 0 A FFFFFFFFFFFF 4 A" );
638 PrintAndLog ( " sample5: hf mf nested 1 * t" );
639 PrintAndLog ( " sample6: hf mf nested 1 * ss" );
644 cmdp
= param_getchar ( Cmd
, 0 );
645 if ( cmdp
== 'o' || cmdp
== 'O' ) {
649 SectorsCnt
= ParamCardSizeSectors ( cmdp
);
652 // <block number>. number or autosearch key (*)
653 if ( param_getchar ( Cmd
, 1 ) == '*' ) {
654 autosearchKey
= true ;
656 parseParamTDS ( Cmd
, 2 , & transferToEml
, & createDumpFile
, & btimeout14a
);
658 PrintAndLog ( "--nested. sectors:%2d, block no:*, eml:%c, dmp=%c checktimeout=%d us" ,
659 SectorsCnt
, transferToEml
? 'y' : 'n' , createDumpFile
? 'y' : 'n' , (( int ) btimeout14a
* 10000 ) / 106 );
661 blockNo
= param_get8 ( Cmd
, 1 );
663 ctmp
= param_getchar ( Cmd
, 2 );
664 if ( ctmp
!= 'a' && ctmp
!= 'A' && ctmp
!= 'b' && ctmp
!= 'B' ) {
665 PrintAndLog ( "Key type must be A or B" );
669 if ( ctmp
!= 'A' && ctmp
!= 'a' )
672 if ( param_gethex ( Cmd
, 3 , key
, 12 )) {
673 PrintAndLog ( "Key must include 12 HEX symbols" );
677 // check if we can authenticate to sector
678 res
= mfCheckKeys ( blockNo
, keyType
, true , 1 , key
, & key64
);
680 PrintAndLog ( "Can't authenticate to block:%3d key type:%c key:%s" , blockNo
, keyType
? 'B' : 'A' , sprint_hex ( key
, 6 ));
686 trgBlockNo
= param_get8 ( Cmd
, 4 );
688 ctmp
= param_getchar ( Cmd
, 5 );
689 if ( ctmp
!= 'a' && ctmp
!= 'A' && ctmp
!= 'b' && ctmp
!= 'B' ) {
690 PrintAndLog ( "Target key type must be A or B" );
693 if ( ctmp
!= 'A' && ctmp
!= 'a' )
696 parseParamTDS ( Cmd
, 6 , & transferToEml
, & createDumpFile
, & btimeout14a
);
698 parseParamTDS ( Cmd
, 4 , & transferToEml
, & createDumpFile
, & btimeout14a
);
701 PrintAndLog ( "--nested. sectors:%2d, block no:%3d, key type:%c, eml:%c, dmp=%c checktimeout=%d us" ,
702 SectorsCnt
, blockNo
, keyType
? 'B' : 'A' , transferToEml
? 'y' : 'n' , createDumpFile
? 'y' : 'n' , (( int ) btimeout14a
* 10000 ) / 106 );
706 if ( cmdp
== 'o' ) { // ------------------------------------ one sector working
707 PrintAndLog ( "--target block no:%3d, target key type:%c " , trgBlockNo
, trgKeyType
? 'B' : 'A' );
708 int16_t isOK
= mfnested ( blockNo
, keyType
, key
, trgBlockNo
, trgKeyType
, keyBlock
, true );
711 case - 1 : PrintAndLog ( "Error: No response from Proxmark. \n " ); break ;
712 case - 2 : PrintAndLog ( "Button pressed. Aborted. \n " ); break ;
713 case - 3 : PrintAndLog ( "Tag isn't vulnerable to Nested Attack (random numbers are not predictable). \n " ); break ;
714 default : PrintAndLog ( "Unknown Error. \n " );
718 key64
= bytes_to_num ( keyBlock
, 6 );
720 PrintAndLog ( "Found valid key:%012" PRIx64
, key64
);
722 // transfer key to the emulator
724 uint8_t sectortrailer
;
725 if ( trgBlockNo
< 32 * 4 ) { // 4 block sector
726 sectortrailer
= trgBlockNo
| 0x03 ;
727 } else { // 16 block sector
728 sectortrailer
= trgBlockNo
| 0x0f ;
730 mfEmlGetMem ( keyBlock
, sectortrailer
, 1 );
733 num_to_bytes ( key64
, 6 , keyBlock
);
735 num_to_bytes ( key64
, 6 , & keyBlock
[ 10 ]);
736 mfEmlSetMem ( keyBlock
, sectortrailer
, 1 );
737 PrintAndLog ( "Key transferred to emulator memory." );
740 PrintAndLog ( "No valid key found" );
743 else { // ------------------------------------ multiple sectors working
745 msclock1
= msclock ();
747 e_sector
= calloc ( SectorsCnt
, sizeof ( sector_t
));
748 if ( e_sector
== NULL
) return 1 ;
750 //test current key and additional standard keys first
751 for ( int defaultKeyCounter
= 0 ; defaultKeyCounter
< MifareDefaultKeysSize
; defaultKeyCounter
++){
752 num_to_bytes ( MifareDefaultKeys
[ defaultKeyCounter
], 6 , ( uint8_t *)( keyBlock
+ defaultKeyCounter
* 6 ));
755 PrintAndLog ( "Testing known keys. Sector count=%d" , SectorsCnt
);
756 mfCheckKeysSec ( SectorsCnt
, 2 , btimeout14a
, true , MifareDefaultKeysSize
, keyBlock
, e_sector
);
758 // get known key from array
759 bool keyFound
= false ;
761 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
762 for ( j
= 0 ; j
< 2 ; j
++) {
763 if ( e_sector
[ i
]. foundKey
[ j
]) {
767 num_to_bytes ( e_sector
[ i
]. Key
[ j
], 6 , key
);
775 // Can't found a key....
777 PrintAndLog ( "Can't found any of the known keys." );
781 PrintAndLog ( "--auto key. block no:%3d, key type:%c key:%s" , blockNo
, keyType
? 'B' : 'A' , sprint_hex ( key
, 6 ));
786 PrintAndLog ( "nested..." );
787 bool calibrate
= true ;
788 for ( i
= 0 ; i
< NESTED_SECTOR_RETRY
; i
++) {
789 for ( uint8_t sectorNo
= 0 ; sectorNo
< SectorsCnt
; sectorNo
++) {
790 for ( trgKeyType
= 0 ; trgKeyType
< 2 ; trgKeyType
++) {
791 if ( e_sector
[ sectorNo
]. foundKey
[ trgKeyType
]) continue ;
792 PrintAndLog ( "-----------------------------------------------" );
793 int16_t isOK
= mfnested ( blockNo
, keyType
, key
, FirstBlockOfSector ( sectorNo
), trgKeyType
, keyBlock
, calibrate
);
796 case - 1 : PrintAndLog ( "Error: No response from Proxmark. \n " ); break ;
797 case - 2 : PrintAndLog ( "Button pressed. Aborted. \n " ); break ;
798 case - 3 : PrintAndLog ( "Tag isn't vulnerable to Nested Attack (random numbers are not predictable). \n " ); break ;
799 default : PrintAndLog ( "Unknown Error. \n " );
809 key64
= bytes_to_num ( keyBlock
, 6 );
811 PrintAndLog ( "Found valid key:%012" PRIx64
, key64
);
812 e_sector
[ sectorNo
]. foundKey
[ trgKeyType
] = 1 ;
813 e_sector
[ sectorNo
]. Key
[ trgKeyType
] = key64
;
815 // try to check this key as a key to the other sectors
816 mfCheckKeysSec ( SectorsCnt
, 2 , btimeout14a
, true , 1 , keyBlock
, e_sector
);
822 // print nested statistic
823 PrintAndLog ( " \n\n ----------------------------------------------- \n Nested statistic: \n Iterations count: %d" , iterations
);
824 PrintAndLog ( "Time in nested: %1.3f (%1.3f sec per key)" , (( float )( msclock () - msclock1
))/ 1000.0 , (( float )( msclock () - msclock1
))/ iterations
/ 1000.0 );
827 PrintAndLog ( "|---|----------------|---|----------------|---|" );
828 PrintAndLog ( "|sec|key A |res|key B |res|" );
829 PrintAndLog ( "|---|----------------|---|----------------|---|" );
830 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
831 PrintAndLog ( "|%03d| %012" PRIx64
" | %d | %012" PRIx64
" | %d |" , i
,
832 e_sector
[ i
]. Key
[ 0 ], e_sector
[ i
]. foundKey
[ 0 ], e_sector
[ i
]. Key
[ 1 ], e_sector
[ i
]. foundKey
[ 1 ]);
834 PrintAndLog ( "|---|----------------|---|----------------|---|" );
836 // transfer keys to the emulator memory
838 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
839 mfEmlGetMem ( keyBlock
, FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 , 1 );
840 if ( e_sector
[ i
]. foundKey
[ 0 ])
841 num_to_bytes ( e_sector
[ i
]. Key
[ 0 ], 6 , keyBlock
);
842 if ( e_sector
[ i
]. foundKey
[ 1 ])
843 num_to_bytes ( e_sector
[ i
]. Key
[ 1 ], 6 , & keyBlock
[ 10 ]);
844 mfEmlSetMem ( keyBlock
, FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 , 1 );
846 PrintAndLog ( "Keys transferred to emulator memory." );
850 if ( createDumpFile
) {
851 if (( fkeys
= fopen ( "dumpkeys.bin" , "wb" )) == NULL
) {
852 PrintAndLog ( "Could not create file dumpkeys.bin" );
856 PrintAndLog ( "Printing keys to binary file dumpkeys.bin..." );
857 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
858 if ( e_sector
[ i
]. foundKey
[ 0 ]){
859 num_to_bytes ( e_sector
[ i
]. Key
[ 0 ], 6 , tempkey
);
860 fwrite ( tempkey
, 1 , 6 , fkeys
);
863 fwrite ( & standart
, 1 , 6 , fkeys
);
866 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
867 if ( e_sector
[ i
]. foundKey
[ 1 ]){
868 num_to_bytes ( e_sector
[ i
]. Key
[ 1 ], 6 , tempkey
);
869 fwrite ( tempkey
, 1 , 6 , fkeys
);
872 fwrite ( & standart
, 1 , 6 , fkeys
);
884 int CmdHF14AMfNestedHard ( const char * Cmd
)
888 uint8_t trgBlockNo
= 0 ;
889 uint8_t trgKeyType
= 0 ;
890 uint8_t key
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
891 uint8_t trgkey
[ 6 ] = { 0 , 0 , 0 , 0 , 0 , 0 };
894 ctmp
= param_getchar ( Cmd
, 0 );
896 if ( ctmp
!= 'R' && ctmp
!= 'r' && ctmp
!= 'T' && ctmp
!= 't' && strlen ( Cmd
) < 20 ) {
897 PrintAndLog ( "Usage:" );
898 PrintAndLog ( " hf mf hardnested <block number> <key A|B> <key (12 hex symbols)>" );
899 PrintAndLog ( " <target block number> <target key A|B> [known target key (12 hex symbols)] [w] [s]" );
900 PrintAndLog ( " or hf mf hardnested r [known target key]" );
902 PrintAndLog ( "Options: " );
903 PrintAndLog ( " w: Acquire nonces and write them to binary file nonces.bin" );
904 PrintAndLog ( " s: Slower acquisition (required by some non standard cards)" );
905 PrintAndLog ( " r: Read nonces.bin and start attack" );
906 PrintAndLog ( " iX: set type of SIMD instructions. Without this flag programs autodetect it." );
907 PrintAndLog ( " i5: AVX512" );
908 PrintAndLog ( " i2: AVX2" );
909 PrintAndLog ( " ia: AVX" );
910 PrintAndLog ( " is: SSE2" );
911 PrintAndLog ( " im: MMX" );
912 PrintAndLog ( " in: none (use CPU regular instruction set)" );
914 PrintAndLog ( " sample1: hf mf hardnested 0 A FFFFFFFFFFFF 4 A" );
915 PrintAndLog ( " sample2: hf mf hardnested 0 A FFFFFFFFFFFF 4 A w" );
916 PrintAndLog ( " sample3: hf mf hardnested 0 A FFFFFFFFFFFF 4 A w s" );
917 PrintAndLog ( " sample4: hf mf hardnested r" );
919 PrintAndLog ( "Add the known target key to check if it is present in the remaining key space:" );
920 PrintAndLog ( " sample5: hf mf hardnested 0 A A0A1A2A3A4A5 4 A FFFFFFFFFFFF" );
924 bool know_target_key
= false ;
925 bool nonce_file_read
= false ;
926 bool nonce_file_write
= false ;
932 if ( ctmp
== 'R' || ctmp
== 'r' ) {
933 nonce_file_read
= true ;
935 if (! param_gethex ( Cmd
, 1 , trgkey
, 12 )) {
936 know_target_key
= true ;
939 } else if ( ctmp
== 'T' || ctmp
== 't' ) {
940 tests
= param_get32ex ( Cmd
, 1 , 100 , 10 );
942 if (! param_gethex ( Cmd
, 2 , trgkey
, 12 )) {
943 know_target_key
= true ;
947 blockNo
= param_get8 ( Cmd
, 0 );
948 ctmp
= param_getchar ( Cmd
, 1 );
949 if ( ctmp
!= 'a' && ctmp
!= 'A' && ctmp
!= 'b' && ctmp
!= 'B' ) {
950 PrintAndLog ( "Key type must be A or B" );
953 if ( ctmp
!= 'A' && ctmp
!= 'a' ) {
957 if ( param_gethex ( Cmd
, 2 , key
, 12 )) {
958 PrintAndLog ( "Key must include 12 HEX symbols" );
962 trgBlockNo
= param_get8 ( Cmd
, 3 );
963 ctmp
= param_getchar ( Cmd
, 4 );
964 if ( ctmp
!= 'a' && ctmp
!= 'A' && ctmp
!= 'b' && ctmp
!= 'B' ) {
965 PrintAndLog ( "Target key type must be A or B" );
968 if ( ctmp
!= 'A' && ctmp
!= 'a' ) {
974 if (! param_gethex ( Cmd
, 5 , trgkey
, 12 )) {
975 know_target_key
= true ;
980 while (( ctmp
= param_getchar ( Cmd
, i
))) {
981 if ( ctmp
== 's' || ctmp
== 'S' ) {
983 } else if ( ctmp
== 'w' || ctmp
== 'W' ) {
984 nonce_file_write
= true ;
985 } else if ( param_getlength ( Cmd
, i
) == 2 && ctmp
== 'i' ) {
988 PrintAndLog ( "Possible options are w , s and/or iX" );
995 SetSIMDInstr ( SIMD_AUTO
);
997 while (( ctmp
= param_getchar ( Cmd
, iindx
))) {
998 if ( param_getlength ( Cmd
, iindx
) == 2 && ctmp
== 'i' ) {
999 switch ( param_getchar_indx ( Cmd
, 1 , iindx
)) {
1001 SetSIMDInstr ( SIMD_AVX512
);
1004 SetSIMDInstr ( SIMD_AVX2
);
1007 SetSIMDInstr ( SIMD_AVX
);
1010 SetSIMDInstr ( SIMD_SSE2
);
1013 SetSIMDInstr ( SIMD_MMX
);
1016 SetSIMDInstr ( SIMD_NONE
);
1019 PrintAndLog ( "Unknown SIMD type. %c" , param_getchar_indx ( Cmd
, 1 , iindx
));
1027 PrintAndLog ( "--target block no:%3d, target key type:%c, known target key: 0x%02x%02x%02x%02x%02x%02x%s, file action: %s, Slow: %s, Tests: %d " ,
1030 trgkey
[ 0 ], trgkey
[ 1 ], trgkey
[ 2 ], trgkey
[ 3 ], trgkey
[ 4 ], trgkey
[ 5 ],
1031 know_target_key
? "" : " (not set)" ,
1032 nonce_file_write
? "write" : nonce_file_read
? "read" : "none" ,
1036 int16_t isOK
= mfnestedhard ( blockNo
, keyType
, key
, trgBlockNo
, trgKeyType
, know_target_key
? trgkey
: NULL
, nonce_file_read
, nonce_file_write
, slow
, tests
);
1040 case 1 : PrintAndLog ( "Error: No response from Proxmark. \n " ); break ;
1041 case 2 : PrintAndLog ( "Button pressed. Aborted. \n " ); break ;
1051 int CmdHF14AMfChk ( const char * Cmd
)
1053 if ( strlen ( Cmd
)< 3 ) {
1054 PrintAndLog ( "Usage: hf mf chk <block number>|<*card memory> <key type (A/B/?)> [t|d|s|ss] [<key (12 hex symbols)>] [<dic (*.dic)>]" );
1055 PrintAndLog ( " * - all sectors" );
1056 PrintAndLog ( "card memory - 0 - MINI(320 bytes), 1 - 1K, 2 - 2K, 4 - 4K, <other> - 1K" );
1057 PrintAndLog ( "d - write keys to binary file \n " );
1058 PrintAndLog ( "t - write keys to emulator memory" );
1059 PrintAndLog ( "s - slow execute. timeout 1ms" );
1060 PrintAndLog ( "ss - very slow execute. timeout 5ms" );
1061 PrintAndLog ( " sample: hf mf chk 0 A 1234567890ab keys.dic" );
1062 PrintAndLog ( " hf mf chk *1 ? t" );
1063 PrintAndLog ( " hf mf chk *1 ? d" );
1064 PrintAndLog ( " hf mf chk *1 ? s" );
1065 PrintAndLog ( " hf mf chk *1 ? dss" );
1070 char filename
[ FILE_PATH_SIZE
]={ 0 };
1072 uint8_t * keyBlock
= NULL
, * p
;
1073 uint16_t stKeyBlock
= 20 ;
1079 uint8_t blockNo
= 0 ;
1080 uint8_t SectorsCnt
= 0 ;
1081 uint8_t keyType
= 0 ;
1083 // timeout in units. (ms * 106)/10 or us*0.0106
1084 uint8_t btimeout14a
= MF_CHKKEYS_DEFTIMEOUT
; // fast by default
1085 bool param3InUse
= false ;
1087 bool transferToEml
= 0 ;
1088 bool createDumpFile
= 0 ;
1090 sector_t
* e_sector
= NULL
;
1092 keyBlock
= calloc ( stKeyBlock
, 6 );
1093 if ( keyBlock
== NULL
) return 1 ;
1095 int defaultKeysSize
= MifareDefaultKeysSize
;
1096 for ( int defaultKeyCounter
= 0 ; defaultKeyCounter
< defaultKeysSize
; defaultKeyCounter
++){
1097 num_to_bytes ( MifareDefaultKeys
[ defaultKeyCounter
], 6 , ( uint8_t *)( keyBlock
+ defaultKeyCounter
* 6 ));
1100 if ( param_getchar ( Cmd
, 0 )== '*' ) {
1101 SectorsCnt
= ParamCardSizeSectors ( param_getchar ( Cmd
+ 1 , 0 ));
1104 blockNo
= param_get8 ( Cmd
, 0 );
1106 ctmp
= param_getchar ( Cmd
, 1 );
1107 clen
= param_getlength ( Cmd
, 1 );
1120 PrintAndLog ( "Key type must be A , B or ?" );
1126 parseParamTDS ( Cmd
, 2 , & transferToEml
, & createDumpFile
, & btimeout14a
);
1128 param3InUse
= transferToEml
| createDumpFile
| ( btimeout14a
!= MF_CHKKEYS_DEFTIMEOUT
);
1130 PrintAndLog ( "--chk keys. sectors:%2d, block no:%3d, key type:%c, eml:%c, dmp=%c checktimeout=%d us" ,
1131 SectorsCnt
, blockNo
, keyType
? 'B' : 'A' , transferToEml
? 'y' : 'n' , createDumpFile
? 'y' : 'n' , (( int ) btimeout14a
* 10000 ) / 106 );
1133 for ( i
= param3InUse
; param_getchar ( Cmd
, 2 + i
); i
++) {
1134 if (! param_gethex ( Cmd
, 2 + i
, keyBlock
+ 6 * keycnt
, 12 )) {
1135 if ( stKeyBlock
- keycnt
< 2 ) {
1136 p
= realloc ( keyBlock
, 6 *( stKeyBlock
+= 10 ));
1138 PrintAndLog ( "Cannot allocate memory for Keys" );
1144 PrintAndLog ( "chk key[%2d] %02x%02x%02x%02x%02x%02x" , keycnt
,
1145 ( keyBlock
+ 6 * keycnt
)[ 0 ],( keyBlock
+ 6 * keycnt
)[ 1 ], ( keyBlock
+ 6 * keycnt
)[ 2 ],
1146 ( keyBlock
+ 6 * keycnt
)[ 3 ], ( keyBlock
+ 6 * keycnt
)[ 4 ], ( keyBlock
+ 6 * keycnt
)[ 5 ], 6 );
1149 // May be a dic file
1150 if ( param_getstr ( Cmd
, 2 + i
, filename
, sizeof ( filename
)) >= FILE_PATH_SIZE
) {
1151 PrintAndLog ( "File name too long" );
1156 if ( ( f
= fopen ( filename
, "r" )) ) {
1157 while ( fgets ( buf
, sizeof ( buf
), f
) ){
1158 if ( strlen ( buf
) < 12 || buf
[ 11 ] == ' \n ' )
1161 while ( fgetc ( f
) != ' \n ' && ! feof ( f
)) ; //goto next line
1163 if ( buf
[ 0 ]== '#' ) continue ; //The line start with # is comment, skip
1165 if (! isxdigit (( unsigned char ) buf
[ 0 ])){
1166 PrintAndLog ( "File content error. '%s' must include 12 HEX symbols" , buf
);
1172 if ( stKeyBlock
- keycnt
< 2 ) {
1173 p
= realloc ( keyBlock
, 6 *( stKeyBlock
+= 10 ));
1175 PrintAndLog ( "Cannot allocate memory for defKeys" );
1182 memset ( keyBlock
+ 6 * keycnt
, 0 , 6 );
1183 num_to_bytes ( strtoll ( buf
, NULL
, 16 ), 6 , keyBlock
+ 6 * keycnt
);
1184 PrintAndLog ( "chk custom key[%2d] %012" PRIx64
, keycnt
, bytes_to_num ( keyBlock
+ 6 * keycnt
, 6 ));
1186 memset ( buf
, 0 , sizeof ( buf
));
1190 PrintAndLog ( "File: %s: not found or locked." , filename
);
1198 // fill with default keys
1200 PrintAndLog ( "No key specified, trying default keys" );
1201 for (; keycnt
< defaultKeysSize
; keycnt
++)
1202 PrintAndLog ( "chk default key[%2d] %02x%02x%02x%02x%02x%02x" , keycnt
,
1203 ( keyBlock
+ 6 * keycnt
)[ 0 ],( keyBlock
+ 6 * keycnt
)[ 1 ], ( keyBlock
+ 6 * keycnt
)[ 2 ],
1204 ( keyBlock
+ 6 * keycnt
)[ 3 ], ( keyBlock
+ 6 * keycnt
)[ 4 ], ( keyBlock
+ 6 * keycnt
)[ 5 ], 6 );
1207 // initialize storage for found keys
1208 e_sector
= calloc ( SectorsCnt
, sizeof ( sector_t
));
1209 if ( e_sector
== NULL
) {
1213 for ( uint8_t keyAB
= 0 ; keyAB
< 2 ; keyAB
++) {
1214 for ( uint16_t sectorNo
= 0 ; sectorNo
< SectorsCnt
; sectorNo
++) {
1215 e_sector
[ sectorNo
]. Key
[ keyAB
] = 0xffffffffffff ;
1216 e_sector
[ sectorNo
]. foundKey
[ keyAB
] = 0 ;
1221 bool foundAKey
= false ;
1222 uint32_t max_keys
= keycnt
> USB_CMD_DATA_SIZE
/ 6 ? USB_CMD_DATA_SIZE
/ 6 : keycnt
;
1224 PrintAndLog ( "To cancel this operation press the button on the proxmark..." );
1226 for ( uint32_t c
= 0 ; c
< keycnt
; c
+= max_keys
) {
1228 uint32_t size
= keycnt
- c
> max_keys
? max_keys
: keycnt
- c
;
1229 res
= mfCheckKeysSec ( SectorsCnt
, keyType
, btimeout14a
, true , size
, & keyBlock
[ 6 * c
], e_sector
); // timeout is (ms * 106)/10 or us*0.0106
1240 PrintAndLog ( "Command execute timeout" );
1244 int keyAB
= keyType
;
1246 for ( uint32_t c
= 0 ; c
< keycnt
; c
+= max_keys
) {
1248 uint32_t size
= keycnt
- c
> max_keys
? max_keys
: keycnt
- c
;
1249 res
= mfCheckKeys ( blockNo
, keyAB
& 0x01 , true , size
, & keyBlock
[ 6 * c
], & key64
);
1253 PrintAndLog ( "Found valid key:[%d:%c]%012" PRIx64
, blockNo
, ( keyAB
& 0x01 )? 'B' : 'A' , key64
);
1257 PrintAndLog ( "Command execute timeout" );
1260 } while (-- keyAB
> 0 );
1267 PrintAndLog ( "|---|----------------|---|----------------|---|" );
1268 PrintAndLog ( "|sec|key A |res|key B |res|" );
1269 PrintAndLog ( "|---|----------------|---|----------------|---|" );
1270 for ( i
= 0 ; i
< SectorsCnt
; i
++) {
1271 PrintAndLog ( "|%03d| %012" PRIx64
" | %d | %012" PRIx64
" | %d |" , i
,
1272 e_sector
[ i
]. Key
[ 0 ], e_sector
[ i
]. foundKey
[ 0 ], e_sector
[ i
]. Key
[ 1 ], e_sector
[ i
]. foundKey
[ 1 ]);
1274 PrintAndLog ( "|---|----------------|---|----------------|---|" );
1278 PrintAndLog ( "No valid keys found." );
1281 if ( transferToEml
) {
1283 for ( uint16_t sectorNo
= 0 ; sectorNo
< SectorsCnt
; sectorNo
++) {
1284 if ( e_sector
[ sectorNo
]. foundKey
[ 0 ] || e_sector
[ sectorNo
]. foundKey
[ 1 ]) {
1285 mfEmlGetMem ( block
, FirstBlockOfSector ( sectorNo
) + NumBlocksPerSector ( sectorNo
) - 1 , 1 );
1286 for ( uint16_t t
= 0 ; t
< 2 ; t
++) {
1287 if ( e_sector
[ sectorNo
]. foundKey
[ t
]) {
1288 num_to_bytes ( e_sector
[ sectorNo
]. Key
[ t
], 6 , block
+ t
* 10 );
1291 mfEmlSetMem ( block
, FirstBlockOfSector ( sectorNo
) + NumBlocksPerSector ( sectorNo
) - 1 , 1 );
1294 PrintAndLog ( "Found keys have been transferred to the emulator memory" );
1297 if ( createDumpFile
) {
1298 FILE * fkeys
= fopen ( "dumpkeys.bin" , "wb" );
1299 if ( fkeys
== NULL
) {
1300 PrintAndLog ( "Could not create file dumpkeys.bin" );
1306 for ( uint8_t t
= 0 ; t
< 2 ; t
++) {
1307 for ( uint8_t sectorNo
= 0 ; sectorNo
< SectorsCnt
; sectorNo
++) {
1308 num_to_bytes ( e_sector
[ sectorNo
]. Key
[ t
], 6 , mkey
);
1309 fwrite ( mkey
, 1 , 6 , fkeys
);
1313 PrintAndLog ( "Found keys have been dumped to file dumpkeys.bin. 0xffffffffffff has been inserted for unknown keys." );
1322 void readerAttack ( nonces_t ar_resp
[], bool setEmulatorMem
, bool doStandardAttack
) {
1323 #define ATTACK_KEY_COUNT 7 // keep same as define in iso14443a.c -> Mifare1ksim()
1324 // cannot be more than 7 or it will overrun c.d.asBytes(512)
1330 st_t sector_trailer
[ ATTACK_KEY_COUNT
];
1331 memset ( sector_trailer
, 0x00 , sizeof ( sector_trailer
));
1333 uint8_t stSector
[ ATTACK_KEY_COUNT
];
1334 memset ( stSector
, 0x00 , sizeof ( stSector
));
1335 uint8_t key_cnt
[ ATTACK_KEY_COUNT
];
1336 memset ( key_cnt
, 0x00 , sizeof ( key_cnt
));
1338 for ( uint8_t i
= 0 ; i
< ATTACK_KEY_COUNT
; i
++) {
1339 if ( ar_resp
[ i
]. ar2
> 0 ) {
1340 //PrintAndLog("DEBUG: Trying sector %d, cuid %08x, nt %08x, ar %08x, nr %08x, ar2 %08x, nr2 %08x",ar_resp[i].sector, ar_resp[i].cuid,ar_resp[i].nonce,ar_resp[i].ar,ar_resp[i].nr,ar_resp[i].ar2,ar_resp[i].nr2);
1341 if ( doStandardAttack
&& mfkey32 ( ar_resp
[ i
], & key
)) {
1342 PrintAndLog ( " Found Key%s for sector %02d: [%04x%08x]" , ( ar_resp
[ i
]. keytype
) ? "B" : "A" , ar_resp
[ i
]. sector
, ( uint32_t ) ( key
>> 32 ), ( uint32_t ) ( key
& 0xFFFFFFFF ));
1344 for ( uint8_t ii
= 0 ; ii
< ATTACK_KEY_COUNT
; ii
++) {
1345 if ( key_cnt
[ ii
]== 0 || stSector
[ ii
]== ar_resp
[ i
]. sector
) {
1346 if ( ar_resp
[ i
]. keytype
== 0 ) {
1348 sector_trailer
[ ii
]. keyA
= key
;
1349 stSector
[ ii
] = ar_resp
[ i
]. sector
;
1354 sector_trailer
[ ii
]. keyB
= key
;
1355 stSector
[ ii
] = ar_resp
[ i
]. sector
;
1361 } else if ( mfkey32_moebius ( ar_resp
[ i
+ ATTACK_KEY_COUNT
], & key
)) {
1362 uint8_t sectorNum
= ar_resp
[ i
+ ATTACK_KEY_COUNT
]. sector
;
1363 uint8_t keyType
= ar_resp
[ i
+ ATTACK_KEY_COUNT
]. keytype
;
1365 PrintAndLog ( "M-Found Key%s for sector %02d: [%012" PRIx64
"]"
1366 , keyType
? "B" : "A"
1371 for ( uint8_t ii
= 0 ; ii
< ATTACK_KEY_COUNT
; ii
++) {
1372 if ( key_cnt
[ ii
]== 0 || stSector
[ ii
]== sectorNum
) {
1375 sector_trailer
[ ii
]. keyA
= key
;
1376 stSector
[ ii
] = sectorNum
;
1381 sector_trailer
[ ii
]. keyB
= key
;
1382 stSector
[ ii
] = sectorNum
;
1392 //set emulator memory for keys
1393 if ( setEmulatorMem
) {
1394 for ( uint8_t i
= 0 ; i
< ATTACK_KEY_COUNT
; i
++) {
1396 uint8_t memBlock
[ 16 ];
1397 memset ( memBlock
, 0x00 , sizeof ( memBlock
));
1399 memset ( cmd1
, 0x00 , sizeof ( cmd1
));
1400 snprintf ( cmd1
, sizeof ( cmd1
), "%04x%08xFF078069%04x%08x" ,( uint32_t ) ( sector_trailer
[ i
]. keyA
>> 32 ), ( uint32_t ) ( sector_trailer
[ i
]. keyA
& 0xFFFFFFFF ),( uint32_t ) ( sector_trailer
[ i
]. keyB
>> 32 ), ( uint32_t ) ( sector_trailer
[ i
]. keyB
& 0xFFFFFFFF ));
1401 PrintAndLog ( "Setting Emulator Memory Block %02d: [%s]" , stSector
[ i
]* 4 + 3 , cmd1
);
1402 if ( param_gethex ( cmd1
, 0 , memBlock
, 32 )) {
1403 PrintAndLog ( "block data must include 32 HEX symbols" );
1407 UsbCommand c
= { CMD_MIFARE_EML_MEMSET
, {( stSector
[ i
]* 4 + 3 ), 1 , 0 }};
1408 memcpy ( c
. d
. asBytes
, memBlock
, 16 );
1409 clearCommandBuffer ();
1415 //un-comment to use as well moebius attack
1416 for (uint8_t i = ATTACK_KEY_COUNT; i<ATTACK_KEY_COUNT*2; i++) {
1417 if (ar_resp[i].ar2 > 0) {
1418 if (tryMfk32_moebius(ar_resp[i], &key)) {
1419 PrintAndLog("M-Found Key%s for sector %02d: [%04x%08x]", (ar_resp[i].keytype) ? "B" : "A", ar_resp[i].sector, (uint32_t) (key>>32), (uint32_t) (key &0xFFFFFFFF));
1425 int usage_hf14_mfsim ( void ) {
1426 PrintAndLog ( "Usage: hf mf sim [h] [*<card memory>] [u <uid (8, 14, or 20 hex symbols)>] [n <numreads>] [i] [x]" );
1427 PrintAndLog ( "options:" );
1428 PrintAndLog ( " h (Optional) this help" );
1429 PrintAndLog ( " card memory: 0 - MINI(320 bytes), 1 - 1K, 2 - 2K, 4 - 4K, <other, default> - 1K" );
1430 PrintAndLog ( " u (Optional) UID 4 or 7 bytes. If not specified, the UID 4B from emulator memory will be used" );
1431 PrintAndLog ( " n (Optional) Automatically exit simulation after <numreads> blocks have been read by reader. 0 = infinite" );
1432 PrintAndLog ( " i (Optional) Interactive, means that console will not be returned until simulation finishes or is aborted" );
1433 PrintAndLog ( " x (Optional) Crack, performs the 'reader attack', nr/ar attack against a legitimate reader, fishes out the key(s)" );
1434 PrintAndLog ( " e (Optional) set keys found from 'reader attack' to emulator memory (implies x and i)" );
1435 PrintAndLog ( " f (Optional) get UIDs to use for 'reader attack' from file 'f <filename.txt>' (implies x and i)" );
1436 PrintAndLog ( " r (Optional) Generate random nonces instead of sequential nonces. Standard reader attack won't work with this option, only moebius attack works." );
1437 PrintAndLog ( "samples:" );
1438 PrintAndLog ( " hf mf sim u 0a0a0a0a" );
1439 PrintAndLog ( " hf mf sim *4" );
1440 PrintAndLog ( " hf mf sim u 11223344556677" );
1441 PrintAndLog ( " hf mf sim f uids.txt" );
1442 PrintAndLog ( " hf mf sim u 0a0a0a0a e" );
1447 int CmdHF14AMfSim ( const char * Cmd
) {
1449 uint8_t uid
[ 7 ] = { 0 };
1450 uint8_t exitAfterNReads
= 0 ;
1453 bool setEmulatorMem
= false ;
1454 bool attackFromFile
= false ;
1456 char filename
[ FILE_PATH_SIZE
];
1457 memset ( filename
, 0x00 , sizeof ( filename
));
1462 bool errors
= false ;
1463 uint8_t cardsize
= '1' ;
1465 while ( param_getchar ( Cmd
, cmdp
) != 0x00 ) {
1466 switch ( param_getchar ( Cmd
, cmdp
)) {
1468 cardsize
= param_getchar ( Cmd
+ 1 , cmdp
);
1474 default : cardsize
= '1' ;
1480 setEmulatorMem
= true ;
1482 flags
|= FLAG_INTERACTIVE
;
1483 flags
|= FLAG_NR_AR_ATTACK
;
1488 len
= param_getstr ( Cmd
, cmdp
+ 1 , filename
, sizeof ( filename
));
1490 PrintAndLog ( "error no filename found" );
1493 attackFromFile
= true ;
1495 flags
|= FLAG_INTERACTIVE
;
1496 flags
|= FLAG_NR_AR_ATTACK
;
1501 return usage_hf14_mfsim ();
1504 flags
|= FLAG_INTERACTIVE
;
1509 exitAfterNReads
= param_get8 ( Cmd
, cmdp
+ 1 );
1514 flags
|= FLAG_RANDOM_NONCE
;
1520 if ( param_gethex_ex ( Cmd
, cmdp
+ 1 , uid
, & uidlen
)) {
1521 return usage_hf14_mfsim ();
1524 case 14 : flags
= FLAG_7B_UID_IN_DATA
; break ;
1525 case 8 : flags
= FLAG_4B_UID_IN_DATA
; break ;
1526 default : return usage_hf14_mfsim ();
1532 flags
|= FLAG_NR_AR_ATTACK
;
1536 PrintAndLog ( "Unknown parameter '%c'" , param_getchar ( Cmd
, cmdp
));
1543 if ( errors
) return usage_hf14_mfsim ();
1546 if ( attackFromFile
) {
1549 f
= fopen ( filename
, "r" );
1551 PrintAndLog ( "File %s not found or locked" , filename
);
1554 PrintAndLog ( "Loading file and simulating. Press keyboard to abort" );
1555 while (! feof ( f
) && ! ukbhit ()){
1556 memset ( buf
, 0 , sizeof ( buf
));
1557 memset ( uid
, 0 , sizeof ( uid
));
1559 if ( fgets ( buf
, sizeof ( buf
), f
) == NULL
) {
1560 if ( count
> 0 ) break ;
1562 PrintAndLog ( "File reading error." );
1566 if (! strlen ( buf
) && feof ( f
)) break ;
1568 uidlen
= strlen ( buf
)- 1 ;
1570 case 14 : flags
|= FLAG_7B_UID_IN_DATA
; break ;
1571 case 8 : flags
|= FLAG_4B_UID_IN_DATA
; break ;
1573 PrintAndLog ( "uid in file wrong length at %d (length: %d) [%s]" , count
, uidlen
, buf
);
1578 for ( uint8_t i
= 0 ; i
< uidlen
; i
+= 2 ) {
1579 sscanf (& buf
[ i
], "%02x" , ( unsigned int *)& uid
[ i
/ 2 ]);
1582 PrintAndLog ( "mf sim cardsize: %s, uid: %s, numreads:%d, flags:%d (0x%02x) - press button to abort" ,
1583 cardsize
== '0' ? "Mini" :
1584 cardsize
== '2' ? "2K" :
1585 cardsize
== '4' ? "4K" : "1K" ,
1586 flags
& FLAG_4B_UID_IN_DATA
? sprint_hex ( uid
, 4 ):
1587 flags
& FLAG_7B_UID_IN_DATA
? sprint_hex ( uid
, 7 ): "N/A" ,
1592 UsbCommand c
= { CMD_SIMULATE_MIFARE_CARD
, { flags
, exitAfterNReads
, cardsize
}};
1593 memcpy ( c
. d
. asBytes
, uid
, sizeof ( uid
));
1594 clearCommandBuffer ();
1597 while (! WaitForResponseTimeout ( CMD_ACK
,& resp
, 1500 )) {
1598 //We're waiting only 1.5 s at a time, otherwise we get the
1599 // annoying message about "Waiting for a response... "
1602 nonces_t ar_resp
[ ATTACK_KEY_COUNT
* 2 ];
1603 memcpy ( ar_resp
, resp
. d
. asBytes
, sizeof ( ar_resp
));
1604 // We can skip the standard attack if we have RANDOM_NONCE set.
1605 readerAttack ( ar_resp
, setEmulatorMem
, !( flags
& FLAG_RANDOM_NONCE
));
1606 if (( bool ) resp
. arg
[ 1 ]) {
1607 PrintAndLog ( "Device button pressed - quitting" );
1615 } else { //not from file
1617 PrintAndLog ( "mf sim cardsize: %s, uid: %s, numreads:%d, flags:%d (0x%02x) " ,
1618 cardsize
== '0' ? "Mini" :
1619 cardsize
== '2' ? "2K" :
1620 cardsize
== '4' ? "4K" : "1K" ,
1621 flags
& FLAG_4B_UID_IN_DATA
? sprint_hex ( uid
, 4 ):
1622 flags
& FLAG_7B_UID_IN_DATA
? sprint_hex ( uid
, 7 ): "N/A" ,
1627 UsbCommand c
= { CMD_SIMULATE_MIFARE_CARD
, { flags
, exitAfterNReads
, cardsize
}};
1628 memcpy ( c
. d
. asBytes
, uid
, sizeof ( uid
));
1629 clearCommandBuffer ();
1632 if ( flags
& FLAG_INTERACTIVE
) {
1633 PrintAndLog ( "Press pm3-button to abort simulation" );
1634 while (! WaitForResponseTimeout ( CMD_ACK
, & resp
, 1500 )) {
1635 //We're waiting only 1.5 s at a time, otherwise we get the
1636 // annoying message about "Waiting for a response... "
1639 if ( flags
& FLAG_NR_AR_ATTACK
) {
1640 nonces_t ar_resp
[ ATTACK_KEY_COUNT
* 2 ];
1641 memcpy ( ar_resp
, resp
. d
. asBytes
, sizeof ( ar_resp
));
1642 // We can skip the standard attack if we have RANDOM_NONCE set.
1643 readerAttack ( ar_resp
, setEmulatorMem
, !( flags
& FLAG_RANDOM_NONCE
));
1651 int CmdHF14AMfDbg ( const char * Cmd
)
1653 int dbgMode
= param_get32ex ( Cmd
, 0 , 0 , 10 );
1655 PrintAndLog ( "Max debug mode parameter is 4 \n " );
1658 if ( strlen ( Cmd
) < 1 || ! param_getchar ( Cmd
, 0 ) || dbgMode
> 4 ) {
1659 PrintAndLog ( "Usage: hf mf dbg <debug level>" );
1660 PrintAndLog ( " 0 - no debug messages" );
1661 PrintAndLog ( " 1 - error messages" );
1662 PrintAndLog ( " 2 - plus information messages" );
1663 PrintAndLog ( " 3 - plus debug messages" );
1664 PrintAndLog ( " 4 - print even debug messages in timing critical functions" );
1665 PrintAndLog ( " Note: this option therefore may cause malfunction itself" );
1669 UsbCommand c
= { CMD_MIFARE_SET_DBGMODE
, { dbgMode
, 0 , 0 }};
1675 int CmdHF14AMfEGet ( const char * Cmd
)
1677 uint8_t blockNo
= 0 ;
1678 uint8_t data
[ 16 ] = { 0x00 };
1680 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
1681 PrintAndLog ( "Usage: hf mf eget <block number>" );
1682 PrintAndLog ( " sample: hf mf eget 0 " );
1686 blockNo
= param_get8 ( Cmd
, 0 );
1689 if (! mfEmlGetMem ( data
, blockNo
, 1 )) {
1690 PrintAndLog ( "data[%3d]:%s" , blockNo
, sprint_hex ( data
, 16 ));
1692 PrintAndLog ( "Command execute timeout" );
1698 int CmdHF14AMfEClear ( const char * Cmd
)
1700 if ( param_getchar ( Cmd
, 0 ) == 'h' ) {
1701 PrintAndLog ( "Usage: hf mf eclr" );
1702 PrintAndLog ( "It set card emulator memory to empty data blocks and key A/B FFFFFFFFFFFF \n " );
1706 UsbCommand c
= { CMD_MIFARE_EML_MEMCLR
, { 0 , 0 , 0 }};
1712 int CmdHF14AMfESet ( const char * Cmd
)
1714 uint8_t memBlock
[ 16 ];
1715 uint8_t blockNo
= 0 ;
1717 memset ( memBlock
, 0x00 , sizeof ( memBlock
));
1719 if ( strlen ( Cmd
) < 3 || param_getchar ( Cmd
, 0 ) == 'h' ) {
1720 PrintAndLog ( "Usage: hf mf eset <block number> <block data (32 hex symbols)>" );
1721 PrintAndLog ( " sample: hf mf eset 1 000102030405060708090a0b0c0d0e0f " );
1725 blockNo
= param_get8 ( Cmd
, 0 );
1727 if ( param_gethex ( Cmd
, 1 , memBlock
, 32 )) {
1728 PrintAndLog ( "block data must include 32 HEX symbols" );
1733 return mfEmlSetMem ( memBlock
, blockNo
, 1 );
1737 int CmdHF14AMfELoad ( const char * Cmd
)
1740 char filename
[ FILE_PATH_SIZE
];
1741 char * fnameptr
= filename
;
1742 char buf
[ 64 ] = { 0x00 };
1743 uint8_t buf8
[ 64 ] = { 0x00 };
1744 int i
, len
, blockNum
, numBlocks
;
1745 int nameParamNo
= 1 ;
1747 char ctmp
= param_getchar ( Cmd
, 0 );
1749 if ( ctmp
== 'h' || ctmp
== 0x00 ) {
1750 PrintAndLog ( "It loads emul dump from the file `filename.eml`" );
1751 PrintAndLog ( "Usage: hf mf eload [card memory] <file name w/o `.eml`>" );
1752 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
1754 PrintAndLog ( " sample: hf mf eload filename" );
1755 PrintAndLog ( " hf mf eload 4 filename" );
1760 case '0' : numBlocks
= 5 * 4 ; break ;
1762 case '\0' : numBlocks
= 16 * 4 ; break ;
1763 case '2' : numBlocks
= 32 * 4 ; break ;
1764 case '4' : numBlocks
= 256 ; break ;
1771 len
= param_getstr ( Cmd
, nameParamNo
, filename
, sizeof ( filename
));
1773 if ( len
> FILE_PATH_SIZE
- 5 ) len
= FILE_PATH_SIZE
- 5 ;
1777 sprintf ( fnameptr
, ".eml" );
1780 f
= fopen ( filename
, "r" );
1782 PrintAndLog ( "File %s not found or locked" , filename
);
1788 memset ( buf
, 0 , sizeof ( buf
));
1790 if ( fgets ( buf
, sizeof ( buf
), f
) == NULL
) {
1792 if ( blockNum
>= numBlocks
) break ;
1794 PrintAndLog ( "File reading error." );
1799 if ( strlen ( buf
) < 32 ){
1800 if ( strlen ( buf
) && feof ( f
))
1802 PrintAndLog ( "File content error. Block data must include 32 HEX symbols" );
1807 for ( i
= 0 ; i
< 32 ; i
+= 2 ) {
1808 sscanf (& buf
[ i
], "%02x" , ( unsigned int *)& buf8
[ i
/ 2 ]);
1811 if ( mfEmlSetMem ( buf8
, blockNum
, 1 )) {
1812 PrintAndLog ( "Cant set emul block: %3d" , blockNum
);
1819 if ( blockNum
>= numBlocks
) break ;
1824 if (( blockNum
!= numBlocks
)) {
1825 PrintAndLog ( "File content error. Got %d must be %d blocks." , blockNum
, numBlocks
);
1828 PrintAndLog ( "Loaded %d blocks from file: %s" , blockNum
, filename
);
1833 int CmdHF14AMfESave ( const char * Cmd
)
1836 char filename
[ FILE_PATH_SIZE
];
1837 char * fnameptr
= filename
;
1839 int i
, j
, len
, numBlocks
;
1840 int nameParamNo
= 1 ;
1842 memset ( filename
, 0 , sizeof ( filename
));
1843 memset ( buf
, 0 , sizeof ( buf
));
1845 char ctmp
= param_getchar ( Cmd
, 0 );
1847 if ( ctmp
== 'h' || ctmp
== 'H' ) {
1848 PrintAndLog ( "It saves emul dump into the file `filename.eml` or `cardID.eml`" );
1849 PrintAndLog ( " Usage: hf mf esave [card memory] [file name w/o `.eml`]" );
1850 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
1852 PrintAndLog ( " sample: hf mf esave " );
1853 PrintAndLog ( " hf mf esave 4" );
1854 PrintAndLog ( " hf mf esave 4 filename" );
1859 case '0' : numBlocks
= 5 * 4 ; break ;
1861 case '\0' : numBlocks
= 16 * 4 ; break ;
1862 case '2' : numBlocks
= 32 * 4 ; break ;
1863 case '4' : numBlocks
= 256 ; break ;
1870 len
= param_getstr ( Cmd
, nameParamNo
, filename
, sizeof ( filename
));
1872 if ( len
> FILE_PATH_SIZE
- 5 ) len
= FILE_PATH_SIZE
- 5 ;
1874 // user supplied filename?
1876 // get filename (UID from memory)
1877 if ( mfEmlGetMem ( buf
, 0 , 1 )) {
1878 PrintAndLog ( "Can \' t get UID from block: %d" , 0 );
1879 len
= sprintf ( fnameptr
, "dump" );
1883 for ( j
= 0 ; j
< 7 ; j
++, fnameptr
+= 2 )
1884 sprintf ( fnameptr
, "%02X" , buf
[ j
]);
1890 // add file extension
1891 sprintf ( fnameptr
, ".eml" );
1894 f
= fopen ( filename
, "w+" );
1897 PrintAndLog ( "Can't open file %s " , filename
);
1902 for ( i
= 0 ; i
< numBlocks
; i
++) {
1903 if ( mfEmlGetMem ( buf
, i
, 1 )) {
1904 PrintAndLog ( "Cant get block: %d" , i
);
1907 for ( j
= 0 ; j
< 16 ; j
++)
1908 fprintf ( f
, "%02X" , buf
[ j
]);
1913 PrintAndLog ( "Saved %d blocks to file: %s" , numBlocks
, filename
);
1919 int CmdHF14AMfECFill ( const char * Cmd
)
1921 uint8_t keyType
= 0 ;
1922 uint8_t numSectors
= 16 ;
1924 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
1925 PrintAndLog ( "Usage: hf mf ecfill <key A/B> [card memory]" );
1926 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
1928 PrintAndLog ( "samples: hf mf ecfill A" );
1929 PrintAndLog ( " hf mf ecfill A 4" );
1930 PrintAndLog ( "Read card and transfer its data to emulator memory." );
1931 PrintAndLog ( "Keys must be laid in the emulator memory. \n " );
1935 char ctmp
= param_getchar ( Cmd
, 0 );
1936 if ( ctmp
!= 'a' && ctmp
!= 'A' && ctmp
!= 'b' && ctmp
!= 'B' ) {
1937 PrintAndLog ( "Key type must be A or B" );
1940 if ( ctmp
!= 'A' && ctmp
!= 'a' ) keyType
= 1 ;
1942 ctmp
= param_getchar ( Cmd
, 1 );
1944 case '0' : numSectors
= 5 ; break ;
1946 case '\0' : numSectors
= 16 ; break ;
1947 case '2' : numSectors
= 32 ; break ;
1948 case '4' : numSectors
= 40 ; break ;
1949 default : numSectors
= 16 ;
1952 printf ( "--params: numSectors: %d, keyType:%d \n " , numSectors
, keyType
);
1953 UsbCommand c
= { CMD_MIFARE_EML_CARDLOAD
, { numSectors
, keyType
, 0 }};
1959 int CmdHF14AMfEKeyPrn ( const char * Cmd
)
1962 uint8_t numSectors
= 16 ;
1964 uint64_t keyA
, keyB
;
1965 bool createDumpFile
= false ;
1967 if ( param_getchar ( Cmd
, 0 ) == 'h' ) {
1968 PrintAndLog ( "It prints the keys loaded in the emulator memory" );
1969 PrintAndLog ( "Usage: hf mf ekeyprn [card memory] [d]" );
1970 PrintAndLog ( " [card memory]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
1971 PrintAndLog ( " [d] : write keys to binary file dumpkeys.bin" );
1973 PrintAndLog ( " sample: hf mf ekeyprn 1" );
1978 while ( param_getchar ( Cmd
, cmdp
) != 0x00 ) {
1979 switch ( param_getchar ( Cmd
, cmdp
)) {
1980 case '0' : numSectors
= 5 ; break ;
1982 case '\0' : numSectors
= 16 ; break ;
1983 case '2' : numSectors
= 32 ; break ;
1984 case '4' : numSectors
= 40 ; break ;
1986 case 'D' : createDumpFile
= true ; break ;
1991 PrintAndLog ( "|---|----------------|----------------|" );
1992 PrintAndLog ( "|sec|key A |key B |" );
1993 PrintAndLog ( "|---|----------------|----------------|" );
1994 for ( i
= 0 ; i
< numSectors
; i
++) {
1995 if ( mfEmlGetMem ( data
, FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 , 1 )) {
1996 PrintAndLog ( "error get block %d" , FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 );
1999 keyA
= bytes_to_num ( data
, 6 );
2000 keyB
= bytes_to_num ( data
+ 10 , 6 );
2001 PrintAndLog ( "|%03d| %012" PRIx64
" | %012" PRIx64
" |" , i
, keyA
, keyB
);
2003 PrintAndLog ( "|---|----------------|----------------|" );
2006 if ( createDumpFile
) {
2008 if (( fkeys
= fopen ( "dumpkeys.bin" , "wb" )) == NULL
) {
2009 PrintAndLog ( "Could not create file dumpkeys.bin" );
2012 PrintAndLog ( "Printing keys to binary file dumpkeys.bin..." );
2013 for ( i
= 0 ; i
< numSectors
; i
++) {
2014 if ( mfEmlGetMem ( data
, FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 , 1 )) {
2015 PrintAndLog ( "error get block %d" , FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 );
2018 fwrite ( data
+ 6 , 1 , 6 , fkeys
);
2020 for ( i
= 0 ; i
< numSectors
; i
++) {
2021 if ( mfEmlGetMem ( data
, FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 , 1 )) {
2022 PrintAndLog ( "error get block %d" , FirstBlockOfSector ( i
) + NumBlocksPerSector ( i
) - 1 );
2025 fwrite ( data
+ 10 , 1 , 6 , fkeys
);
2034 int CmdHF14AMfCSetUID ( const char * Cmd
)
2036 uint8_t uid
[ 8 ] = { 0x00 };
2037 uint8_t oldUid
[ 8 ] = { 0x00 };
2038 uint8_t atqa
[ 2 ] = { 0x00 };
2039 uint8_t sak
[ 1 ] = { 0x00 };
2040 uint8_t atqaPresent
= 0 ;
2043 uint8_t needHelp
= 0 ;
2046 if ( param_getchar ( Cmd
, 0 ) && param_gethex ( Cmd
, 0 , uid
, 8 )) {
2047 PrintAndLog ( "UID must include 8 HEX symbols" );
2051 if ( param_getlength ( Cmd
, 1 ) > 1 && param_getlength ( Cmd
, 2 ) > 1 ) {
2055 if ( param_gethex ( Cmd
, 1 , atqa
, 4 )) {
2056 PrintAndLog ( "ATQA must include 4 HEX symbols" );
2060 if ( param_gethex ( Cmd
, 2 , sak
, 2 )) {
2061 PrintAndLog ( "SAK must include 2 HEX symbols" );
2066 while ( param_getchar ( Cmd
, cmdp
) != 0x00 )
2068 switch ( param_getchar ( Cmd
, cmdp
))
2075 PrintAndLog ( "ERROR: Unknown parameter '%c'" , param_getchar ( Cmd
, cmdp
));
2082 if ( strlen ( Cmd
) < 1 || needHelp
) {
2084 PrintAndLog ( "Usage: hf mf csetuid <UID 8 hex symbols> [ATQA 4 hex symbols SAK 2 hex symbols]" );
2085 PrintAndLog ( "sample: hf mf csetuid 01020304" );
2086 PrintAndLog ( "sample: hf mf csetuid 01020304 0004 08" );
2087 PrintAndLog ( "Set UID, ATQA, and SAK for magic Chinese card (only works with such cards)" );
2091 PrintAndLog ( "uid:%s" , sprint_hex ( uid
, 4 ));
2093 PrintAndLog ( "--atqa:%s sak:%02x" , sprint_hex ( atqa
, 2 ), sak
[ 0 ]);
2096 res
= mfCSetUID ( uid
, ( atqaPresent
)? atqa
: NULL
, ( atqaPresent
)? sak
: NULL
, oldUid
);
2098 PrintAndLog ( "Can't set UID. Error=%d" , res
);
2102 PrintAndLog ( "old UID:%s" , sprint_hex ( oldUid
, 4 ));
2103 PrintAndLog ( "new UID:%s" , sprint_hex ( uid
, 4 ));
2107 int CmdHF14AMfCWipe ( const char * Cmd
)
2110 int numBlocks
= 16 * 4 ;
2111 bool wipeCard
= false ;
2112 bool fillCard
= false ;
2114 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
2115 PrintAndLog ( "Usage: hf mf cwipe [card size] [w] [f]" );
2116 PrintAndLog ( "sample: hf mf cwipe 1 w f" );
2117 PrintAndLog ( "[card size]: 0 = 320 bytes (Mifare Mini), 1 = 1K (default), 2 = 2K, 4 = 4K" );
2118 PrintAndLog ( "w - Wipe magic Chinese card (only works with gen:1a cards)" );
2119 PrintAndLog ( "f - Fill the card with default data and keys (works with gen:1a and gen:1b cards only)" );
2123 gen
= mfCIdentify ();
2124 if (( gen
!= 1 ) && ( gen
!= 2 ))
2127 numBlocks
= ParamCardSizeBlocks ( param_getchar ( Cmd
, 0 ));
2130 while ( param_getchar ( Cmd
, cmdp
) != 0x00 ){
2131 switch ( param_getchar ( Cmd
, cmdp
)) {
2146 if (! wipeCard
&& ! fillCard
)
2149 PrintAndLog ( "--blocks count:%2d wipe:%c fill:%c" , numBlocks
, ( wipeCard
)? 'y' : 'n' , ( fillCard
)? 'y' : 'n' );
2152 /* generation 1b magic card */
2154 PrintAndLog ( "WARNING: can't wipe magic card 1b generation" );
2156 res
= mfCWipe ( numBlocks
, true , false , fillCard
);
2158 /* generation 1a magic card by default */
2159 res
= mfCWipe ( numBlocks
, false , wipeCard
, fillCard
);
2163 PrintAndLog ( "Can't wipe. error=%d" , res
);
2170 int CmdHF14AMfCSetBlk ( const char * Cmd
)
2172 uint8_t memBlock
[ 16 ] = { 0x00 };
2173 uint8_t blockNo
= 0 ;
2174 bool wipeCard
= false ;
2177 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
2178 PrintAndLog ( "Usage: hf mf csetblk <block number> <block data (32 hex symbols)> [w]" );
2179 PrintAndLog ( "sample: hf mf csetblk 1 01020304050607080910111213141516" );
2180 PrintAndLog ( "Set block data for magic Chinese card (only works with such cards)" );
2181 PrintAndLog ( "If you also want wipe the card then add 'w' at the end of the command line" );
2185 gen
= mfCIdentify ();
2186 if (( gen
!= 1 ) && ( gen
!= 2 ))
2189 blockNo
= param_get8 ( Cmd
, 0 );
2191 if ( param_gethex ( Cmd
, 1 , memBlock
, 32 )) {
2192 PrintAndLog ( "block data must include 32 HEX symbols" );
2196 char ctmp
= param_getchar ( Cmd
, 2 );
2197 wipeCard
= ( ctmp
== 'w' || ctmp
== 'W' );
2198 PrintAndLog ( "--block number:%2d data:%s" , blockNo
, sprint_hex ( memBlock
, 16 ));
2201 /* generation 1b magic card */
2202 res
= mfCSetBlock ( blockNo
, memBlock
, NULL
, wipeCard
, CSETBLOCK_SINGLE_OPER
| CSETBLOCK_MAGIC_1B
);
2204 /* generation 1a magic card by default */
2205 res
= mfCSetBlock ( blockNo
, memBlock
, NULL
, wipeCard
, CSETBLOCK_SINGLE_OPER
);
2209 PrintAndLog ( "Can't write block. error=%d" , res
);
2216 int CmdHF14AMfCLoad ( const char * Cmd
)
2219 char filename
[ FILE_PATH_SIZE
] = { 0x00 };
2220 char * fnameptr
= filename
;
2221 char buf
[ 256 ] = { 0x00 };
2222 uint8_t buf8
[ 256 ] = { 0x00 };
2223 uint8_t fillFromEmulator
= 0 ;
2224 int i
, len
, blockNum
, flags
= 0 , gen
= 0 , numblock
= 64 ;
2226 if ( param_getchar ( Cmd
, 0 ) == 'h' || param_getchar ( Cmd
, 0 )== 0x00 ) {
2227 PrintAndLog ( "It loads magic Chinese card from the file `filename.eml`" );
2228 PrintAndLog ( "or from emulator memory (option `e`). 4K card: (option `4`)" );
2229 PrintAndLog ( "Usage: hf mf cload [file name w/o `.eml`][e][4]" );
2230 PrintAndLog ( " or: hf mf cload e [4]" );
2231 PrintAndLog ( "Sample: hf mf cload filename" );
2232 PrintAndLog ( " hf mf cload filname 4" );
2233 PrintAndLog ( " hf mf cload e" );
2234 PrintAndLog ( " hf mf cload e 4" );
2238 char ctmp
= param_getchar ( Cmd
, 0 );
2239 if ( ctmp
== 'e' || ctmp
== 'E' ) fillFromEmulator
= 1 ;
2240 ctmp
= param_getchar ( Cmd
, 1 );
2241 if ( ctmp
== '4' ) numblock
= 256 ;
2243 gen
= mfCIdentify ();
2244 PrintAndLog ( "Loading magic mifare %dK" , numblock
== 256 ? 4 : 1 );
2246 if ( fillFromEmulator
) {
2247 for ( blockNum
= 0 ; blockNum
< numblock
; blockNum
+= 1 ) {
2248 if ( mfEmlGetMem ( buf8
, blockNum
, 1 )) {
2249 PrintAndLog ( "Cant get block: %d" , blockNum
);
2252 if ( blockNum
== 0 ) flags
= CSETBLOCK_INIT_FIELD
+ CSETBLOCK_WUPC
; // switch on field and send magic sequence
2253 if ( blockNum
== 1 ) flags
= 0 ; // just write
2254 if ( blockNum
== numblock
- 1 ) flags
= CSETBLOCK_HALT
+ CSETBLOCK_RESET_FIELD
; // Done. Magic Halt and switch off field.
2257 /* generation 1b magic card */
2258 flags
|= CSETBLOCK_MAGIC_1B
;
2259 if ( mfCSetBlock ( blockNum
, buf8
, NULL
, 0 , flags
)) {
2260 PrintAndLog ( "Cant set magic card block: %d" , blockNum
);
2266 param_getstr ( Cmd
, 0 , filename
, sizeof ( filename
));
2268 len
= strlen ( filename
);
2269 if ( len
> FILE_PATH_SIZE
- 5 ) len
= FILE_PATH_SIZE
- 5 ;
2271 //memcpy(filename, Cmd, len);
2274 sprintf ( fnameptr
, ".eml" );
2277 f
= fopen ( filename
, "r" );
2279 PrintAndLog ( "File not found or locked." );
2286 memset ( buf
, 0 , sizeof ( buf
));
2288 if ( fgets ( buf
, sizeof ( buf
), f
) == NULL
) {
2290 PrintAndLog ( "File reading error." );
2294 if ( strlen ( buf
) < 32 ) {
2295 if ( strlen ( buf
) && feof ( f
))
2297 PrintAndLog ( "File content error. Block data must include 32 HEX symbols" );
2301 for ( i
= 0 ; i
< 32 ; i
+= 2 )
2302 sscanf (& buf
[ i
], "%02x" , ( unsigned int *)& buf8
[ i
/ 2 ]);
2304 if ( blockNum
== 0 ) flags
= CSETBLOCK_INIT_FIELD
+ CSETBLOCK_WUPC
; // switch on field and send magic sequence
2305 if ( blockNum
== 1 ) flags
= 0 ; // just write
2306 if ( blockNum
== numblock
- 1 ) flags
= CSETBLOCK_HALT
+ CSETBLOCK_RESET_FIELD
; // Done. Switch off field.
2309 /* generation 1b magic card */
2310 flags
|= CSETBLOCK_MAGIC_1B
;
2311 if ( mfCSetBlock ( blockNum
, buf8
, NULL
, 0 , flags
)) {
2312 PrintAndLog ( "Can't set magic card block: %d" , blockNum
);
2318 if ( blockNum
>= numblock
) break ; // magic card type - mifare 1K 64 blocks, mifare 4k 256 blocks
2322 //if (blockNum != 16 * 4 && blockNum != 32 * 4 + 8 * 16){
2323 if ( blockNum
!= numblock
){
2324 PrintAndLog ( "File content error. There must be %d blocks" , numblock
);
2327 PrintAndLog ( "Loaded from file: %s" , filename
);
2333 int CmdHF14AMfCGetBlk ( const char * Cmd
) {
2334 uint8_t memBlock
[ 16 ];
2335 uint8_t blockNo
= 0 ;
2337 memset ( memBlock
, 0x00 , sizeof ( memBlock
));
2339 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
2340 PrintAndLog ( "Usage: hf mf cgetblk <block number>" );
2341 PrintAndLog ( "sample: hf mf cgetblk 1" );
2342 PrintAndLog ( "Get block data from magic Chinese card (only works with such cards) \n " );
2346 gen
= mfCIdentify ();
2348 blockNo
= param_get8 ( Cmd
, 0 );
2350 PrintAndLog ( "--block number:%2d " , blockNo
);
2353 /* generation 1b magic card */
2354 res
= mfCGetBlock ( blockNo
, memBlock
, CSETBLOCK_SINGLE_OPER
| CSETBLOCK_MAGIC_1B
);
2356 /* generation 1a magic card by default */
2357 res
= mfCGetBlock ( blockNo
, memBlock
, CSETBLOCK_SINGLE_OPER
);
2360 PrintAndLog ( "Can't read block. error=%d" , res
);
2364 PrintAndLog ( "block data:%s" , sprint_hex ( memBlock
, 16 ));
2366 if ( mfIsSectorTrailer ( blockNo
)) {
2367 PrintAndLogEx ( NORMAL
, "Trailer decoded:" );
2368 PrintAndLogEx ( NORMAL
, "Key A: %s" , sprint_hex_inrow ( memBlock
, 6 ));
2369 PrintAndLogEx ( NORMAL
, "Key B: %s" , sprint_hex_inrow (& memBlock
[ 10 ], 6 ));
2370 int bln
= mfFirstBlockOfSector ( mfSectorNum ( blockNo
));
2371 int blinc
= ( mfNumBlocksPerSector ( mfSectorNum ( blockNo
)) > 4 ) ? 5 : 1 ;
2372 for ( int i
= 0 ; i
< 4 ; i
++) {
2373 PrintAndLogEx ( NORMAL
, "Access block %d%s: %s" , bln
, (( blinc
> 1 ) && ( i
< 3 ) ? "+" : "" ) , mfGetAccessConditionsDesc ( i
, & memBlock
[ 6 ]));
2376 PrintAndLogEx ( NORMAL
, "UserData: %s" , sprint_hex_inrow (& memBlock
[ 9 ], 1 ));
2382 int CmdHF14AMfCGetSc ( const char * Cmd
) {
2383 uint8_t memBlock
[ 16 ] = { 0x00 };
2384 uint8_t sectorNo
= 0 ;
2385 int i
, res
, flags
, gen
= 0 , baseblock
= 0 , sect_size
= 4 ;
2387 if ( strlen ( Cmd
) < 1 || param_getchar ( Cmd
, 0 ) == 'h' ) {
2388 PrintAndLog ( "Usage: hf mf cgetsc <sector number>" );
2389 PrintAndLog ( "sample: hf mf cgetsc 0" );
2390 PrintAndLog ( "Get sector data from magic Chinese card (only works with such cards) \n " );
2394 sectorNo
= param_get8 ( Cmd
, 0 );
2396 if ( sectorNo
> 39 ) {
2397 PrintAndLog ( "Sector number must be in [0..15] in MIFARE classic 1k and [0..39] in MIFARE classic 4k." );
2401 PrintAndLog ( "--sector number:%d " , sectorNo
);
2403 gen
= mfCIdentify ();
2405 flags
= CSETBLOCK_INIT_FIELD
+ CSETBLOCK_WUPC
;
2406 if ( sectorNo
< 32 ) {
2407 baseblock
= sectorNo
* 4 ;
2409 baseblock
= 128 + 16 * ( sectorNo
- 32 );
2412 if ( sectorNo
> 31 ) sect_size
= 16 ;
2414 for ( i
= 0 ; i
< sect_size
; i
++) {
2415 if ( i
== 1 ) flags
= 0 ;
2416 if ( i
== sect_size
- 1 ) flags
= CSETBLOCK_HALT
+ CSETBLOCK_RESET_FIELD
;
2419 /* generation 1b magic card */
2420 flags
|= CSETBLOCK_MAGIC_1B
;
2422 res
= mfCGetBlock ( baseblock
+ i
, memBlock
, flags
);
2424 PrintAndLog ( "Can't read block. %d error=%d" , baseblock
+ i
, res
);
2428 PrintAndLog ( "block %3d data:%s" , baseblock
+ i
, sprint_hex ( memBlock
, 16 ));
2430 if ( mfIsSectorTrailer ( baseblock
+ i
)) {
2431 PrintAndLogEx ( NORMAL
, "Trailer decoded:" );
2432 PrintAndLogEx ( NORMAL
, "Key A: %s" , sprint_hex_inrow ( memBlock
, 6 ));
2433 PrintAndLogEx ( NORMAL
, "Key B: %s" , sprint_hex_inrow (& memBlock
[ 10 ], 6 ));
2434 int bln
= baseblock
;
2435 int blinc
= ( mfNumBlocksPerSector ( sectorNo
) > 4 ) ? 5 : 1 ;
2436 for ( int i
= 0 ; i
< 4 ; i
++) {
2437 PrintAndLogEx ( NORMAL
, "Access block %d%s: %s" , bln
, (( blinc
> 1 ) && ( i
< 3 ) ? "+" : "" ) , mfGetAccessConditionsDesc ( i
, & memBlock
[ 6 ]));
2440 PrintAndLogEx ( NORMAL
, "UserData: %s" , sprint_hex_inrow (& memBlock
[ 9 ], 1 ));
2447 int CmdHF14AMfCSave ( const char * Cmd
) {
2450 char filename
[ FILE_PATH_SIZE
] = { 0x00 };
2451 char * fnameptr
= filename
;
2452 uint8_t fillFromEmulator
= 0 ;
2453 uint8_t buf
[ 256 ] = { 0x00 };
2454 int i
, j
, len
, flags
, gen
= 0 , numblock
= 64 ;
2456 // memset(filename, 0, sizeof(filename));
2457 // memset(buf, 0, sizeof(buf));
2459 if ( param_getchar ( Cmd
, 0 ) == 'h' ) {
2460 PrintAndLog ( "It saves `magic Chinese` card dump into the file `filename.eml` or `cardID.eml`" );
2461 PrintAndLog ( "or into emulator memory (option `e`). 4K card: (option `4`)" );
2462 PrintAndLog ( "Usage: hf mf csave [file name w/o `.eml`][e][4]" );
2463 PrintAndLog ( "Sample: hf mf csave " );
2464 PrintAndLog ( " hf mf csave filename" );
2465 PrintAndLog ( " hf mf csave e" );
2466 PrintAndLog ( " hf mf csave 4" );
2467 PrintAndLog ( " hf mf csave filename 4" );
2468 PrintAndLog ( " hf mf csave e 4" );
2472 char ctmp
= param_getchar ( Cmd
, 0 );
2473 if ( ctmp
== 'e' || ctmp
== 'E' ) fillFromEmulator
= 1 ;
2474 if ( ctmp
== '4' ) numblock
= 256 ;
2475 ctmp
= param_getchar ( Cmd
, 1 );
2476 if ( ctmp
== '4' ) numblock
= 256 ;
2478 gen
= mfCIdentify ();
2479 PrintAndLog ( "Saving magic mifare %dK" , numblock
== 256 ? 4 : 1 );
2481 if ( fillFromEmulator
) {
2482 // put into emulator
2483 flags
= CSETBLOCK_INIT_FIELD
+ CSETBLOCK_WUPC
;
2484 for ( i
= 0 ; i
< numblock
; i
++) {
2485 if ( i
== 1 ) flags
= 0 ;
2486 if ( i
== numblock
- 1 ) flags
= CSETBLOCK_HALT
+ CSETBLOCK_RESET_FIELD
;
2489 /* generation 1b magic card */
2490 flags
|= CSETBLOCK_MAGIC_1B
;
2492 if ( mfCGetBlock ( i
, buf
, flags
)) {
2493 PrintAndLog ( "Cant get block: %d" , i
);
2497 if ( mfEmlSetMem ( buf
, i
, 1 )) {
2498 PrintAndLog ( "Cant set emul block: %d" , i
);
2504 param_getstr ( Cmd
, 0 , filename
, sizeof ( filename
));
2506 len
= strlen ( filename
);
2507 if ( len
> FILE_PATH_SIZE
- 5 ) len
= FILE_PATH_SIZE
- 5 ;
2509 ctmp
= param_getchar ( Cmd
, 0 );
2510 if ( len
< 1 || ( ctmp
== '4' )) {
2513 flags
= CSETBLOCK_SINGLE_OPER
;
2515 /* generation 1b magic card */
2516 flags
|= CSETBLOCK_MAGIC_1B
;
2517 if ( mfCGetBlock ( 0 , buf
, flags
)) {
2518 PrintAndLog ( "Cant get block: %d" , 0 );
2519 len
= sprintf ( fnameptr
, "dump" );
2523 for ( j
= 0 ; j
< 7 ; j
++, fnameptr
+= 2 )
2524 sprintf ( fnameptr
, "%02x" , buf
[ j
]);
2527 //memcpy(filename, Cmd, len);
2531 sprintf ( fnameptr
, ".eml" );
2534 f
= fopen ( filename
, "w+" );
2537 PrintAndLog ( "File not found or locked." );
2542 flags
= CSETBLOCK_INIT_FIELD
+ CSETBLOCK_WUPC
;
2543 for ( i
= 0 ; i
< numblock
; i
++) {
2544 if ( i
== 1 ) flags
= 0 ;
2545 if ( i
== numblock
- 1 ) flags
= CSETBLOCK_HALT
+ CSETBLOCK_RESET_FIELD
;
2548 /* generation 1b magic card */
2549 flags
|= CSETBLOCK_MAGIC_1B
;
2550 if ( mfCGetBlock ( i
, buf
, flags
)) {
2551 PrintAndLog ( "Cant get block: %d" , i
);
2554 for ( j
= 0 ; j
< 16 ; j
++)
2555 fprintf ( f
, "%02x" , buf
[ j
]);
2560 PrintAndLog ( "Saved to file: %s" , filename
);
2567 int CmdHF14AMfSniff ( const char * Cmd
){
2569 bool wantLogToFile
= 0 ;
2570 bool wantDecrypt
= 0 ;
2571 //bool wantSaveToEml = 0; TODO
2572 bool wantSaveToEmlFile
= 0 ;
2583 uint8_t atqa
[ 2 ] = { 0x00 };
2586 uint8_t * buf
= NULL
;
2587 uint16_t bufsize
= 0 ;
2588 uint8_t * bufPtr
= NULL
;
2591 char ctmp
= param_getchar ( Cmd
, 0 );
2592 if ( ctmp
== 'h' || ctmp
== 'H' ) {
2593 PrintAndLog ( "It continuously gets data from the field and saves it to: log, emulator, emulator file." );
2594 PrintAndLog ( "You can specify:" );
2595 PrintAndLog ( " l - save encrypted sequence to logfile `uid.log`" );
2596 PrintAndLog ( " d - decrypt sequence and put it to log file `uid.log`" );
2597 PrintAndLog ( " n/a e - decrypt sequence, collect read and write commands and save the result of the sequence to emulator memory" );
2598 PrintAndLog ( " f - decrypt sequence, collect read and write commands and save the result of the sequence to emulator dump file `uid.eml`" );
2599 PrintAndLog ( "Usage: hf mf sniff [l][d][e][f]" );
2600 PrintAndLog ( " sample: hf mf sniff l d e" );
2604 for ( int i
= 0 ; i
< 4 ; i
++) {
2605 ctmp
= param_getchar ( Cmd
, i
);
2606 if ( ctmp
== 'l' || ctmp
== 'L' ) wantLogToFile
= true ;
2607 if ( ctmp
== 'd' || ctmp
== 'D' ) wantDecrypt
= true ;
2608 //if (ctmp == 'e' || ctmp == 'E') wantSaveToEml = true; TODO
2609 if ( ctmp
== 'f' || ctmp
== 'F' ) wantSaveToEmlFile
= true ;
2612 printf ( "------------------------------------------------------------------------- \n " );
2613 printf ( "Executing command. \n " );
2614 printf ( "Press the key on the proxmark3 device to abort both proxmark3 and client. \n " );
2615 printf ( "Press the key on pc keyboard to abort the client. \n " );
2616 printf ( "------------------------------------------------------------------------- \n " );
2618 UsbCommand c
= { CMD_MIFARE_SNIFFER
, { 0 , 0 , 0 }};
2619 clearCommandBuffer ();
2628 printf ( " \n aborted via keyboard! \n " );
2633 if ( WaitForResponseTimeoutW ( CMD_ACK
, & resp
, 2000 , false )) {
2634 res
= resp
. arg
[ 0 ] & 0xff ;
2635 uint16_t traceLen
= resp
. arg
[ 1 ];
2638 if ( res
== 0 ) { // we are done
2642 if ( res
== 1 ) { // there is (more) data to be transferred
2643 if ( pckNum
== 0 ) { // first packet, (re)allocate necessary buffer
2644 if ( traceLen
> bufsize
|| buf
== NULL
) {
2646 if ( buf
== NULL
) { // not yet allocated
2647 p
= malloc ( traceLen
);
2648 } else { // need more memory
2649 p
= realloc ( buf
, traceLen
);
2652 PrintAndLog ( "Cannot allocate memory for trace" );
2660 memset ( buf
, 0x00 , traceLen
);
2662 memcpy ( bufPtr
, resp
. d
. asBytes
, len
);
2667 if ( res
== 2 ) { // received all data, start displaying
2668 blockLen
= bufPtr
- buf
;
2671 PrintAndLog ( "received trace len: %d packages: %d" , blockLen
, pckNum
);
2672 while ( bufPtr
- buf
< blockLen
) {
2673 bufPtr
+= 6 ; // skip (void) timing information
2674 len
= *(( uint16_t *) bufPtr
);
2681 parlen
= ( len
- 1 ) / 8 + 1 ;
2683 if (( len
== 14 ) && ( bufPtr
[ 0 ] == 0xff ) && ( bufPtr
[ 1 ] == 0xff ) && ( bufPtr
[ 12 ] == 0xff ) && ( bufPtr
[ 13 ] == 0xff )) {
2684 memcpy ( uid
, bufPtr
+ 2 , 7 );
2685 memcpy ( atqa
, bufPtr
+ 2 + 7 , 2 );
2686 uid_len
= ( atqa
[ 0 ] & 0xC0 ) == 0x40 ? 7 : 4 ;
2688 PrintAndLog ( "tag select uid:%s atqa:0x%02x%02x sak:0x%02x" ,
2689 sprint_hex ( uid
+ ( 7 - uid_len
), uid_len
),
2693 if ( wantLogToFile
|| wantDecrypt
) {
2694 FillFileNameByUID ( logHexFileName
, uid
+ ( 7 - uid_len
), ".log" , uid_len
);
2695 AddLogCurrentDT ( logHexFileName
);
2698 mfTraceInit ( uid
, atqa
, sak
, wantSaveToEmlFile
);
2700 oddparitybuf ( bufPtr
, len
, parity
);
2701 PrintAndLog ( "%s(%d):%s [%s] c[%s]%c" ,
2702 isTag
? "TAG" : "RDR" ,
2704 sprint_hex ( bufPtr
, len
),
2705 printBitsPar ( bufPtr
+ len
, len
),
2706 printBitsPar ( parity
, len
),
2707 memcmp ( bufPtr
+ len
, parity
, len
/ 8 + 1 ) ? '!' : ' ' );
2709 AddLogHex ( logHexFileName
, isTag
? "TAG: " : "RDR: " , bufPtr
, len
);
2711 mfTraceDecode ( bufPtr
, len
, bufPtr
[ len
], wantSaveToEmlFile
);
2715 bufPtr
+= parlen
; // ignore parity
2724 msleep ( 300 ); // wait for exiting arm side.
2725 PrintAndLog ( "Done." );
2729 //needs nt, ar, at, Data to decrypt
2730 int CmdDecryptTraceCmds ( const char * Cmd
){
2733 param_gethex_ex ( Cmd
, 3 , data
, & len
);
2734 return tryDecryptWord ( param_get32ex ( Cmd
, 0 , 0 , 16 ), param_get32ex ( Cmd
, 1 , 0 , 16 ), param_get32ex ( Cmd
, 2 , 0 , 16 ), data
, len
/ 2 );
2737 int CmdHF14AMfAuth4 ( const char * cmd
) {
2738 uint8_t keyn
[ 20 ] = { 0 };
2740 uint8_t key
[ 16 ] = { 0 };
2743 CLIParserInit ( "hf mf auth4" ,
2744 "Executes AES authentication command in ISO14443-4" ,
2745 "Usage: \n\t hf mf auth4 4000 000102030405060708090a0b0c0d0e0f -> executes authentication \n "
2746 " \t hf mf auth4 9003 FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF -> executes authentication \n " );
2748 void * argtable
[] = {
2750 arg_str1 ( NULL
, NULL
, "<Key Num (HEX 2 bytes)>" , NULL
),
2751 arg_str1 ( NULL
, NULL
, "<Key Value (HEX 16 bytes)>" , NULL
),
2754 CLIExecWithReturn ( cmd
, argtable
, true );
2756 CLIGetHexWithReturn ( 1 , keyn
, & keynlen
);
2757 CLIGetHexWithReturn ( 2 , key
, & keylen
);
2761 PrintAndLog ( "ERROR: <Key Num> must be 2 bytes long instead of: %d" , keynlen
);
2766 PrintAndLog ( "ERROR: <Key Value> must be 16 bytes long instead of: %d" , keylen
);
2770 return MifareAuth4 ( NULL
, keyn
, key
, true , false , true );
2773 // https://www.nxp.com/docs/en/application-note/AN10787.pdf
2774 int CmdHF14AMfMAD ( const char * cmd
) {
2776 CLIParserInit ( "hf mf mad" ,
2777 "Checks and prints Mifare Application Directory (MAD)" ,
2778 "Usage: \n\t hf mf mad -> shows MAD if exists \n "
2779 " \t hf mf mad -a 03e1 -k ffffffffffff -b -> shows NDEF data if exists. read card with custom key and key B \n " );
2781 void * argtable
[] = {
2783 arg_lit0 ( "vV" , "verbose" , "show technical data" ),
2784 arg_str0 ( "aA" , "aid" , "print all sectors with aid" , NULL
),
2785 arg_str0 ( "kK" , "key" , "key for printing sectors" , NULL
),
2786 arg_lit0 ( "bB" , "keyb" , "use key B for access printing sectors (by default: key A)" ),
2789 CLIExecWithReturn ( cmd
, argtable
, true );
2790 bool verbose
= arg_get_lit ( 1 );
2791 uint8_t aid
[ 2 ] = { 0 };
2793 CLIGetHexWithReturn ( 2 , aid
, & aidlen
);
2794 uint8_t key
[ 6 ] = { 0 };
2796 CLIGetHexWithReturn ( 3 , key
, & keylen
);
2797 bool keyB
= arg_get_lit ( 4 );
2801 if ( aidlen
!= 2 && keylen
> 0 ) {
2802 PrintAndLogEx ( WARNING
, "do not need a key without aid." );
2805 uint8_t sector0
[ 16 * 4 ] = { 0 };
2806 uint8_t sector10
[ 16 * 4 ] = { 0 };
2807 if ( mfReadSector ( MF_MAD1_SECTOR
, MF_KEY_A
, ( uint8_t *) g_mifare_mad_key
, sector0
)) {
2808 PrintAndLogEx ( ERR
, "read sector 0 error. card don't have MAD or don't have MAD on default keys." );
2813 for ( int i
= 0 ; i
< 4 ; i
++)
2814 PrintAndLogEx ( NORMAL
, "[%d] %s" , i
, sprint_hex (& sector0
[ i
* 16 ], 16 ));
2817 bool haveMAD2
= false ;
2818 MAD1DecodeAndPrint ( sector0
, verbose
, & haveMAD2
);
2821 if ( mfReadSector ( MF_MAD2_SECTOR
, MF_KEY_A
, ( uint8_t *) g_mifare_mad_key
, sector10
)) {
2822 PrintAndLogEx ( ERR
, "read sector 0x10 error. card don't have MAD or don't have MAD on default keys." );
2826 MAD2DecodeAndPrint ( sector10
, verbose
);
2830 uint16_t aaid
= ( aid
[ 0 ] << 8 ) + aid
[ 1 ];
2831 PrintAndLogEx ( NORMAL
, " \n -------------- AID 0x%04x ---------------" , aaid
);
2833 uint16_t mad
[ 7 + 8 + 8 + 8 + 8 ] = { 0 };
2835 if ( MADDecode ( sector0
, sector10
, mad
, & madlen
)) {
2836 PrintAndLogEx ( ERR
, "can't decode mad." );
2840 uint8_t akey
[ 6 ] = { 0 };
2841 memcpy ( akey
, g_mifare_ndef_key
, 6 );
2843 memcpy ( akey
, key
, 6 );
2846 for ( int i
= 0 ; i
< madlen
; i
++) {
2847 if ( aaid
== mad
[ i
]) {
2848 uint8_t vsector
[ 16 * 4 ] = { 0 };
2849 if ( mfReadSector ( i
+ 1 , keyB
? MF_KEY_B
: MF_KEY_A
, akey
, vsector
)) {
2850 PrintAndLogEx ( NORMAL
, "" );
2851 PrintAndLogEx ( ERR
, "read sector %d error." , i
+ 1 );
2855 for ( int j
= 0 ; j
< ( verbose
? 4 : 3 ); j
++)
2856 PrintAndLogEx ( NORMAL
, " [%03d] %s" , ( i
+ 1 ) * 4 + j
, sprint_hex (& vsector
[ j
* 16 ], 16 ));
2864 int CmdHFMFNDEF ( const char * cmd
) {
2866 CLIParserInit ( "hf mf ndef" ,
2867 "Prints NFC Data Exchange Format (NDEF)" ,
2868 "Usage: \n\t hf mf ndef -> shows NDEF data \n "
2869 " \t hf mf ndef -a 03e1 -k ffffffffffff -b -> shows NDEF data with custom AID, key and with key B \n " );
2871 void * argtable
[] = {
2873 arg_litn ( "vV" , "verbose" , 0 , 2 , "show technical data" ),
2874 arg_str0 ( "aA" , "aid" , "replace default aid for NDEF" , NULL
),
2875 arg_str0 ( "kK" , "key" , "replace default key for NDEF" , NULL
),
2876 arg_lit0 ( "bB" , "keyb" , "use key B for access sectors (by default: key A)" ),
2879 CLIExecWithReturn ( cmd
, argtable
, true );
2881 bool verbose
= arg_get_lit ( 1 );
2882 bool verbose2
= arg_get_lit ( 1 ) > 1 ;
2883 uint8_t aid
[ 2 ] = { 0 };
2885 CLIGetHexWithReturn ( 2 , aid
, & aidlen
);
2886 uint8_t key
[ 6 ] = { 0 };
2888 CLIGetHexWithReturn ( 3 , key
, & keylen
);
2889 bool keyB
= arg_get_lit ( 4 );
2893 uint16_t ndefAID
= 0x03e1 ;
2895 ndefAID
= ( aid
[ 0 ] << 8 ) + aid
[ 1 ];
2897 uint8_t ndefkey
[ 6 ] = { 0 };
2898 memcpy ( ndefkey
, g_mifare_ndef_key
, 6 );
2900 memcpy ( ndefkey
, key
, 6 );
2903 uint8_t sector0
[ 16 * 4 ] = { 0 };
2904 uint8_t sector10
[ 16 * 4 ] = { 0 };
2905 uint8_t data
[ 4096 ] = { 0 };
2908 PrintAndLogEx ( NORMAL
, "" );
2910 if ( mfReadSector ( MF_MAD1_SECTOR
, MF_KEY_A
, ( uint8_t *) g_mifare_mad_key
, sector0
)) {
2911 PrintAndLogEx ( ERR
, "read sector 0 error. card don't have MAD or don't have MAD on default keys." );
2915 bool haveMAD2
= false ;
2916 int res
= MADCheck ( sector0
, NULL
, verbose
, & haveMAD2
);
2918 PrintAndLogEx ( ERR
, "MAD error %d." , res
);
2923 if ( mfReadSector ( MF_MAD2_SECTOR
, MF_KEY_A
, ( uint8_t *) g_mifare_mad_key
, sector10
)) {
2924 PrintAndLogEx ( ERR
, "read sector 0x10 error. card don't have MAD or don't have MAD on default keys." );
2929 uint16_t mad
[ 7 + 8 + 8 + 8 + 8 ] = { 0 };
2931 if ( MADDecode ( sector0
, ( haveMAD2
? sector10
: NULL
), mad
, & madlen
)) {
2932 PrintAndLogEx ( ERR
, "can't decode mad." );
2936 printf ( "data reading:" );
2937 for ( int i
= 0 ; i
< madlen
; i
++) {
2938 if ( ndefAID
== mad
[ i
]) {
2939 uint8_t vsector
[ 16 * 4 ] = { 0 };
2940 if ( mfReadSector ( i
+ 1 , keyB
? MF_KEY_B
: MF_KEY_A
, ndefkey
, vsector
)) {
2941 PrintAndLogEx ( ERR
, "read sector %d error." , i
+ 1 );
2945 memcpy (& data
[ datalen
], vsector
, 16 * 3 );
2954 PrintAndLogEx ( ERR
, "no NDEF data." );
2959 PrintAndLogEx ( NORMAL
, "NDEF data:" );
2960 dump_buffer ( data
, datalen
, stdout
, 1 );
2963 NDEFDecodeAndPrint ( data
, datalen
, verbose
);
2968 static command_t CommandTable
[] =
2970 { "help" , CmdHelp
, 1 , "This help" },
2971 { "dbg" , CmdHF14AMfDbg
, 0 , "Set default debug mode" },
2972 { "rdbl" , CmdHF14AMfRdBl
, 0 , "Read MIFARE classic block" },
2973 { "rdsc" , CmdHF14AMfRdSc
, 0 , "Read MIFARE classic sector" },
2974 { "dump" , CmdHF14AMfDump
, 0 , "Dump MIFARE classic tag to binary file" },
2975 { "restore" , CmdHF14AMfRestore
, 0 , "Restore MIFARE classic binary file to BLANK tag" },
2976 { "wrbl" , CmdHF14AMfWrBl
, 0 , "Write MIFARE classic block" },
2977 { "auth4" , CmdHF14AMfAuth4
, 0 , "ISO14443-4 AES authentication" },
2978 { "chk" , CmdHF14AMfChk
, 0 , "Test block keys" },
2979 { "mifare" , CmdHF14AMifare
, 0 , "Read parity error messages." },
2980 { "hardnested" , CmdHF14AMfNestedHard
, 0 , "Nested attack for hardened Mifare cards" },
2981 { "nested" , CmdHF14AMfNested
, 0 , "Test nested authentication" },
2982 { "sniff" , CmdHF14AMfSniff
, 0 , "Sniff card-reader communication" },
2983 { "sim" , CmdHF14AMfSim
, 0 , "Simulate MIFARE card" },
2984 { "eclr" , CmdHF14AMfEClear
, 0 , "Clear simulator memory" },
2985 { "eget" , CmdHF14AMfEGet
, 0 , "Get simulator memory block" },
2986 { "eset" , CmdHF14AMfESet
, 0 , "Set simulator memory block" },
2987 { "eload" , CmdHF14AMfELoad
, 0 , "Load from file emul dump" },
2988 { "esave" , CmdHF14AMfESave
, 0 , "Save to file emul dump" },
2989 { "ecfill" , CmdHF14AMfECFill
, 0 , "Fill simulator memory with help of keys from simulator" },
2990 { "ekeyprn" , CmdHF14AMfEKeyPrn
, 0 , "Print keys from simulator memory" },
2991 { "cwipe" , CmdHF14AMfCWipe
, 0 , "Wipe magic Chinese card" },
2992 { "csetuid" , CmdHF14AMfCSetUID
, 0 , "Set UID for magic Chinese card" },
2993 { "csetblk" , CmdHF14AMfCSetBlk
, 0 , "Write block - Magic Chinese card" },
2994 { "cgetblk" , CmdHF14AMfCGetBlk
, 0 , "Read block - Magic Chinese card" },
2995 { "cgetsc" , CmdHF14AMfCGetSc
, 0 , "Read sector - Magic Chinese card" },
2996 { "cload" , CmdHF14AMfCLoad
, 0 , "Load dump into magic Chinese card" },
2997 { "csave" , CmdHF14AMfCSave
, 0 , "Save dump from magic Chinese card into file or emulator" },
2998 { "decrypt" , CmdDecryptTraceCmds
, 1 , "[nt] [ar_enc] [at_enc] [data] - to decrypt snoop or trace" },
2999 { "mad" , CmdHF14AMfMAD
, 0 , "Checks and prints MAD" },
3000 { "ndef" , CmdHFMFNDEF
, 0 , "Prints NDEF records from card" },
3001 { NULL
, NULL
, 0 , NULL
}
3004 int CmdHFMF ( const char * Cmd
)
3006 ( void ) WaitForResponseTimeout ( CMD_ACK
, NULL
, 100 );
3007 CmdsParse ( CommandTable
, Cmd
);
3011 int CmdHelp ( const char * Cmd
)
3013 CmdsHelp ( CommandTable
);