git.zerfleddert.de Git - proxmark3-svn/blob - 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 // mifare authentication
  16 #define CRYPT_NONE    0
  17 #define CRYPT_ALL     1
  18 #define CRYPT_REQUEST 2
  19 #define AUTH_FIRST    0
  20 #define AUTH_NESTED   2
  21
  22 // mifare 4bit card answers
  23 #define CARD_ACK      0x0A  // 1010 - ACK
  24 #define CARD_NACK_NA  0x04  // 0100 - NACK, not allowed (command not allowed)
  25 #define CARD_NACK_TR  0x05  // 0101 - NACK, transmission error
  26
  27 // reader voltage field detector
  28 #define MF_MINFIELDV      4000
  29
  30 // debug
  31 // 0 - no debug messages 1 - error messages 2 - all messages 4 - extended debug mode
  32 #define MF_DBG_NONE          0
  33 #define MF_DBG_ERROR         1
  34 #define MF_DBG_ALL           2
  35 #define MF_DBG_EXTENDED      4
  36
  37 extern int MF_DBGLEVEL;
  38
  39 //mifare emulator states
  40 #define MFEMUL_NOFIELD      0
  41 #define MFEMUL_IDLE         1
  42 #define MFEMUL_SELECT1      2
  43 #define MFEMUL_SELECT2      3
  44 #define MFEMUL_AUTH1        4
  45 #define MFEMUL_AUTH2        5
  46 #define MFEMUL_WORK             6
  47 #define MFEMUL_WRITEBL2     7
  48 #define MFEMUL_INTREG_INC   8
  49 #define MFEMUL_INTREG_DEC   9
  50 #define MFEMUL_INTREG_REST 10
  51 #define MFEMUL_HALTED      11
  52
  53 #define cardSTATE_TO_IDLE() cardSTATE = MFEMUL_IDLE; LED_B_OFF(); LED_C_OFF();
  54
  55 //functions
  56 uint8_t* mifare_get_bigbufptr(void);
  57 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);
  58 int mifare_sendcmd_short_special(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t *data, uint8_t *answer, uint8_t *answer_parity, uint32_t *timing);
  59
  60 int mifare_sendcmd_short_mfucauth(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t *data, uint8_t *answer, uint8_t *answer_parity, uint32_t *timing);
  61 int mifare_sendcmd_shortex(struct Crypto1State *pcs, uint8_t crypted, uint8_t cmd, uint8_t data, uint8_t* answer, uint8_t *answer_parity, uint32_t *timing);
  62
  63 int mifare_classic_auth(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t keyType, uint64_t ui64Key, uint8_t isNested);
  64 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);
  65 int mifare_classic_readblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  66 int mifare_ultra_auth1(uint32_t cuid, uint8_t *blockData);
  67 int mifare_ultra_auth2(uint32_t cuid, uint8_t *key, uint8_t *blockData);
  68 int mifare_ultra_readblock(uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  69 int mifare_classic_writeblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  70 int mifare_ultra_writeblock(uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  71 int mifare_ultra_special_writeblock(uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  72 int mifare_classic_halt(struct Crypto1State *pcs, uint32_t uid);
  73 int mifare_ultra_halt(uint32_t uid);
  74
  75 // desfire
  76 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);
  77 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);
  78 int mifare_desfire_des_auth1(uint32_t uid, uint8_t *blockData);
  79 int mifare_desfire_des_auth2(uint32_t uid, uint8_t *key, uint8_t *blockData);
  80
  81 // crypto functions
  82 void mf_crypto1_decrypt(struct Crypto1State *pcs, uint8_t *receivedCmd, int len);
  83 void mf_crypto1_encrypt(struct Crypto1State *pcs, uint8_t *data, uint16_t len, uint8_t *par);
  84 uint8_t mf_crypto1_encrypt4bit(struct Crypto1State *pcs, uint8_t data);
  85
  86 // memory management
  87 uint8_t* get_bigbufptr_recvrespbuf(void);
  88 uint8_t* get_bigbufptr_recvcmdbuf(void);
  89 uint8_t* get_bigbufptr_emlcardmem(void);
  90
  91 // Mifare memory structure
  92 uint8_t NumBlocksPerSector(uint8_t sectorNo);
  93 uint8_t FirstBlockOfSector(uint8_t sectorNo);
  94
  95 // emulator functions
  96 void emlClearMem(void);
  97 void emlSetMem(uint8_t *data, int blockNum, int blocksCount);
  98 void emlGetMem(uint8_t *data, int blockNum, int blocksCount);
  99 void emlGetMemBt(uint8_t *data, int bytePtr, int byteCount);
 100 uint64_t emlGetKey(int sectorNum, int keyType);
 101 int emlGetValBl(uint32_t *blReg, uint8_t *blBlock, int blockNum);
 102 int emlSetValBl(uint32_t blReg, uint8_t blBlock, int blockNum);
 103 int emlCheckValBl(int blockNum);
 104
 105 #endif