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 #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
  28 // reader voltage field detector
  29 #define MF_MINFIELDV      4000
  30
  31 // debug
  32 #define MF_DBG_NONE          0  // no messages
  33 #define MF_DBG_ERROR         1  // errors only
  34 #define MF_DBG_INFO          2  // errors + info messages
  35 #define MF_DBG_DEBUG         3  // errors + info + debug messages
  36 #define MF_DBG_EXTENDED      4  // errors + info + debug + breaking debug messages
  37
  38 extern int MF_DBGLEVEL;
  39
  40 //functions
  41 int mifare_sendcmd(uint8_t cmd, uint8_t *data, uint8_t data_size, uint8_t* answer, uint8_t *answer_parity, uint32_t *timing);
  42 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);
  43
  44 // mifare classic
  45 int mifare_classic_auth(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t keyType, uint64_t ui64Key, uint8_t isNested, uint32_t *auth_timeout);
  46 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, uint32_t *auth_timeout);
  47 int mifare_classic_readblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  48 int mifare_classic_halt(struct Crypto1State *pcs, uint32_t uid);
  49 int mifare_classic_writeblock(struct Crypto1State *pcs, uint32_t uid, uint8_t blockNo, uint8_t *blockData);
  50
  51 // Ultralight/NTAG...
  52 int mifare_ul_ev1_auth(uint8_t *key, uint8_t *pack);
  53 int mifare_ultra_auth(uint8_t *key);
  54 int mifare_ultra_readblock(uint8_t blockNo, uint8_t *blockData);
  55 //int mifare_ultra_writeblock_compat(uint8_t blockNo, uint8_t *blockData);
  56 int mifare_ultra_writeblock(uint8_t blockNo, uint8_t *blockData);
  57 int mifare_ultra_halt();
  58
  59 // desfire
  60 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);
  61 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);
  62 int mifare_desfire_des_auth1(uint32_t uid, uint8_t *blockData);
  63 int mifare_desfire_des_auth2(uint32_t uid, uint8_t *key, uint8_t *blockData);
  64
  65 // crypto functions
  66 void mf_crypto1_decrypt(struct Crypto1State *pcs, uint8_t *receivedCmd, int len);
  67 void mf_crypto1_decryptEx(struct Crypto1State *pcs, uint8_t *data_in, int len, uint8_t *data_out);
  68 void mf_crypto1_encrypt(struct Crypto1State *pcs, uint8_t *data, uint16_t len, uint8_t *par);
  69 void mf_crypto1_encryptEx(struct Crypto1State *pcs, uint8_t *data, uint8_t *in, uint16_t len, uint8_t *par);
  70 uint8_t mf_crypto1_encrypt4bit(struct Crypto1State *pcs, uint8_t data);
  71
  72 // Mifare memory structure
  73 uint8_t NumBlocksPerSector(uint8_t sectorNo);
  74 uint8_t FirstBlockOfSector(uint8_t sectorNo);
  75 bool IsSectorTrailer(uint8_t blockNo);
  76 uint8_t SectorTrailer(uint8_t blockNo);
  77
  78 // emulator functions
  79 void emlClearMem(void);
  80 void emlSetMem(uint8_t *data, int blockNum, int blocksCount);
  81 void emlGetMem(uint8_t *data, int blockNum, int blocksCount);
  82 void emlGetMemBt(uint8_t *data, int bytePtr, int byteCount);
  83 uint64_t emlGetKey(int sectorNum, int keyType);
  84 int emlGetValBl(uint32_t *blReg, uint8_t *blBlock, int blockNum);
  85 int emlSetValBl(uint32_t blReg, uint8_t blBlock, int blockNum);
  86 int emlCheckValBl(int blockNum);
  87
  88 // mifare check keys
  89 typedef uint8_t TKeyIndex[2][40];
  90 int MifareChkBlockKey(uint8_t *uid, uint32_t *cuid, uint8_t *cascade_levels, uint64_t ui64Key, uint8_t blockNo, uint8_t keyType, uint32_t *auth_timeout, uint8_t debugLevel);
  91 int MifareChkBlockKeys(uint8_t *keys, uint8_t keyCount, uint8_t blockNo, uint8_t keyType, uint32_t *auth_timeout, uint8_t debugLevel);
  92 int MifareMultisectorChk(uint8_t *keys, uint8_t keyCount, uint8_t SectorCount, uint8_t keyType, uint32_t *auth_timeout, uint8_t debugLevel, TKeyIndex *keyIndex);
  93
  94 #endif