]> cvs.zerfleddert.de Git - proxmark3-svn/blob - armsrc/mifareutil.h
Fix memory bounds error
[proxmark3-svn] / armsrc / mifareutil.h
1 //-----------------------------------------------------------------------------
2 // Merlok, May 2011
3 // Many authors, that makes it possible
4 //
5 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
6 // at your option, any later version. See the LICENSE.txt file for the text of
7 // the license.
8 //-----------------------------------------------------------------------------
9 // code for work with mifare cards.
10 //-----------------------------------------------------------------------------
11
12 #ifndef __MIFAREUTIL_H
13 #define __MIFAREUTIL_H
14
15 #include <stdint.h>
16 #include <stdbool.h>
17
18 #include "crapto1/crapto1.h"
19 #include "usb_cdc.h"
20
21 // mifare authentication
22 #define CRYPT_NONE 0
23 #define CRYPT_ALL 1
24 #define CRYPT_REQUEST 2
25 #define AUTH_FIRST 0
26 #define AUTH_NESTED 2
27 #define AUTHENTICATION_TIMEOUT 848 // card times out 1ms after wrong authentication (according to NXP documentation)
28 #define PRE_AUTHENTICATION_LEADTIME 400 // some (non standard) cards need a pause after select before they are ready for first authentication
29
30 // mifare 4bit card answers
31 #define CARD_ACK 0x0A // 1010 - ACK
32 #define CARD_NACK_NA 0x04 // 0100 - NACK, not allowed (command not allowed)
33 #define CARD_NACK_TR 0x05 // 0101 - NACK, transmission error
34
35 // reader voltage field detector
36 #define MF_MINFIELDV 4000
37
38 // debug
39 // 0 - no debug messages 1 - error messages 2 - all messages 4 - extended debug mode
40 #define MF_DBG_NONE 0
41 #define MF_DBG_ERROR 1
42 #define MF_DBG_ALL 2
43 #define MF_DBG_EXTENDED 4
44
45 extern int MF_DBGLEVEL;
46
47 //functions
48 int mifare_sendcmd(uint8_t cmd, uint8_t *data, uint8_t data_size, uint8_t* answer, uint8_t *answer_parity, uint32_t *timing);
49 int mifare_sendcmd_short(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t data, uint8_t* answer, uint8_t *answer_parity, uint32_t *timing);
50
51 // mifare classic
52 int mifare_classic_auth(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t keyType, uint64_t ui64Key, uint8_t isNested);
53 int mifare_classic_authex(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t keyType, uint64_t ui64Key, uint8_t isNested, uint32_t * ntptr, uint32_t *timing);
54 int mifare_classic_readblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
55 int mifare_classic_halt(struct Crypto1State *pcs, uint32_t uid);
56 int mifare_classic_writeblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
57
58 // Ultralight/NTAG...
59 int mifare_ul_ev1_auth(uint8_t *key, uint8_t *pack);
60 int mifare_ultra_auth(uint8_t *key);
61 int mifare_ultra_readblock(uint8_t blockNo, uint8_t *blockData);
62 //int mifare_ultra_writeblock_compat(uint8_t blockNo, uint8_t *blockData);
63 int mifare_ultra_writeblock(uint8_t blockNo, uint8_t *blockData);
64 int mifare_ultra_halt();
65
66 // desfire
67 int mifare_sendcmd_special(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t* data, uint8_t* answer, uint8_t *answer_parity, uint32_t *timing);
68 int mifare_sendcmd_special2(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t* data, uint8_t* answer,uint8_t *answer_parity, uint32_t *timing);
69 int mifare_desfire_des_auth1(uint32_t uid, uint8_t *blockData);
70 int mifare_desfire_des_auth2(uint32_t uid, uint8_t *key, uint8_t *blockData);
71
72 // crypto functions
73 void mf_crypto1_decrypt(struct Crypto1State *pcs, uint8_t *receivedCmd, int len);
74 void mf_crypto1_decryptEx(struct Crypto1State *pcs, uint8_t *data_in, int len, uint8_t *data_out);
75 void mf_crypto1_encrypt(struct Crypto1State *pcs, uint8_t *data, uint16_t len, uint8_t *par);
76 uint8_t mf_crypto1_encrypt4bit(struct Crypto1State *pcs, uint8_t data);
77
78 // Mifare memory structure
79 uint8_t NumBlocksPerSector(uint8_t sectorNo);
80 uint8_t FirstBlockOfSector(uint8_t sectorNo);
81 bool IsSectorTrailer(uint8_t blockNo);
82 uint8_t SectorTrailer(uint8_t blockNo);
83
84 // emulator functions
85 void emlClearMem(void);
86 void emlSetMem(uint8_t *data, int blockNum, int blocksCount);
87 void emlGetMem(uint8_t *data, int blockNum, int blocksCount);
88 void emlGetMemBt(uint8_t *data, int bytePtr, int byteCount);
89 uint64_t emlGetKey(int sectorNum, int keyType);
90 int emlGetValBl(uint32_t *blReg, uint8_t *blBlock, int blockNum);
91 int emlSetValBl(uint32_t blReg, uint8_t blBlock, int blockNum);
92 int emlCheckValBl(int blockNum);
93
94 // mifare check keys
95 typedef uint8_t TKeyIndex[2][40];
96 int MifareChkBlockKey(uint8_t *uid, uint32_t *cuid, uint8_t *cascade_levels, uint64_t ui64Key, uint8_t blockNo, uint8_t keyType, uint8_t debugLevel);
97 int MifareChkBlockKeys(uint8_t *keys, uint8_t keyCount, uint8_t blockNo, uint8_t keyType, uint8_t debugLevel);
98 int MifareMultisectorChk(uint8_t *keys, uint8_t keyCount, uint8_t SectorCount, uint8_t keyType, uint8_t debugLevel, TKeyIndex *keyIndex);
99
100 #endif
Impressum, Datenschutz