mifare_classic.h 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200
  1. #pragma once
  2. #include <furi_hal_nfc.h>
  3. #include "crypto1.h"
  4. #define MF_CLASSIC_BLOCK_SIZE (16)
  5. #define MF_CLASSIC_TOTAL_BLOCKS_MAX (256)
  6. #define MF_CLASSIC_1K_TOTAL_SECTORS_NUM (16)
  7. #define MF_CLASSIC_4K_TOTAL_SECTORS_NUM (40)
  8. #define MF_CLASSIC_SECTORS_MAX (40)
  9. #define MF_CLASSIC_BLOCKS_IN_SECTOR_MAX (16)
  10. #define MF_CLASSIC_NO_KEY (0xFFFFFFFFFFFFFFFF)
  11. #define MF_CLASSIC_MAX_DATA_SIZE (16)
  12. #define MF_CLASSIC_KEY_SIZE (6)
  13. #define MF_CLASSIC_ACCESS_BYTES_SIZE (4)
  14. typedef enum {
  15. MfClassicType1k,
  16. MfClassicType4k,
  17. } MfClassicType;
  18. typedef enum {
  19. MfClassicKeyA,
  20. MfClassicKeyB,
  21. } MfClassicKey;
  22. typedef enum {
  23. MfClassicActionDataRead,
  24. MfClassicActionDataWrite,
  25. MfClassicActionDataInc,
  26. MfClassicActionDataDec,
  27. MfClassicActionKeyARead,
  28. MfClassicActionKeyAWrite,
  29. MfClassicActionKeyBRead,
  30. MfClassicActionKeyBWrite,
  31. MfClassicActionACRead,
  32. MfClassicActionACWrite,
  33. } MfClassicAction;
  34. typedef struct {
  35. uint8_t value[MF_CLASSIC_BLOCK_SIZE];
  36. } MfClassicBlock;
  37. typedef struct {
  38. uint8_t key_a[MF_CLASSIC_KEY_SIZE];
  39. uint8_t access_bits[MF_CLASSIC_ACCESS_BYTES_SIZE];
  40. uint8_t key_b[MF_CLASSIC_KEY_SIZE];
  41. } MfClassicSectorTrailer;
  42. typedef struct {
  43. uint8_t total_blocks;
  44. MfClassicBlock block[MF_CLASSIC_BLOCKS_IN_SECTOR_MAX];
  45. } MfClassicSector;
  46. typedef struct {
  47. MfClassicType type;
  48. uint32_t block_read_mask[MF_CLASSIC_TOTAL_BLOCKS_MAX / 32];
  49. uint64_t key_a_mask;
  50. uint64_t key_b_mask;
  51. MfClassicBlock block[MF_CLASSIC_TOTAL_BLOCKS_MAX];
  52. } MfClassicData;
  53. typedef struct {
  54. uint8_t sector;
  55. uint64_t key_a;
  56. uint64_t key_b;
  57. } MfClassicAuthContext;
  58. typedef struct {
  59. uint8_t sector_num;
  60. uint64_t key_a;
  61. uint64_t key_b;
  62. } MfClassicSectorReader;
  63. typedef struct {
  64. MfClassicType type;
  65. Crypto1 crypto;
  66. uint8_t sectors_to_read;
  67. MfClassicSectorReader sector_reader[MF_CLASSIC_SECTORS_MAX];
  68. } MfClassicReader;
  69. typedef struct {
  70. uint32_t cuid;
  71. Crypto1 crypto;
  72. MfClassicData data;
  73. bool data_changed;
  74. } MfClassicEmulator;
  75. const char* mf_classic_get_type_str(MfClassicType type);
  76. bool mf_classic_check_card_type(uint8_t ATQA0, uint8_t ATQA1, uint8_t SAK);
  77. MfClassicType mf_classic_get_classic_type(int8_t ATQA0, uint8_t ATQA1, uint8_t SAK);
  78. uint8_t mf_classic_get_total_sectors_num(MfClassicType type);
  79. uint16_t mf_classic_get_total_block_num(MfClassicType type);
  80. uint8_t mf_classic_get_sector_trailer_block_num_by_sector(uint8_t sector);
  81. bool mf_classic_is_sector_trailer(uint8_t block);
  82. uint8_t mf_classic_get_sector_by_block(uint8_t block);
  83. bool mf_classic_is_allowed_access_sector_trailer(
  84. MfClassicData* data,
  85. uint8_t block_num,
  86. MfClassicKey key,
  87. MfClassicAction action);
  88. bool mf_classic_is_allowed_access_data_block(
  89. MfClassicData* data,
  90. uint8_t block_num,
  91. MfClassicKey key,
  92. MfClassicAction action);
  93. bool mf_classic_is_key_found(MfClassicData* data, uint8_t sector_num, MfClassicKey key_type);
  94. void mf_classic_set_key_found(
  95. MfClassicData* data,
  96. uint8_t sector_num,
  97. MfClassicKey key_type,
  98. uint64_t key);
  99. void mf_classic_set_key_not_found(MfClassicData* data, uint8_t sector_num, MfClassicKey key_type);
  100. bool mf_classic_is_block_read(MfClassicData* data, uint8_t block_num);
  101. void mf_classic_set_block_read(MfClassicData* data, uint8_t block_num, MfClassicBlock* block_data);
  102. bool mf_classic_is_sector_data_read(MfClassicData* data, uint8_t sector_num);
  103. void mf_classic_set_sector_data_not_read(MfClassicData* data);
  104. bool mf_classic_is_sector_read(MfClassicData* data, uint8_t sector_num);
  105. bool mf_classic_is_card_read(MfClassicData* data);
  106. void mf_classic_get_read_sectors_and_keys(
  107. MfClassicData* data,
  108. uint8_t* sectors_read,
  109. uint8_t* keys_found);
  110. MfClassicSectorTrailer*
  111. mf_classic_get_sector_trailer_by_sector(MfClassicData* data, uint8_t sector);
  112. void mf_classic_auth_init_context(MfClassicAuthContext* auth_ctx, uint8_t sector);
  113. bool mf_classic_authenticate(
  114. FuriHalNfcTxRxContext* tx_rx,
  115. uint8_t block_num,
  116. uint64_t key,
  117. MfClassicKey key_type);
  118. bool mf_classic_authenticate_skip_activate(
  119. FuriHalNfcTxRxContext* tx_rx,
  120. uint8_t block_num,
  121. uint64_t key,
  122. MfClassicKey key_type,
  123. bool skip_activate,
  124. uint32_t cuid);
  125. bool mf_classic_auth_attempt(
  126. FuriHalNfcTxRxContext* tx_rx,
  127. MfClassicAuthContext* auth_ctx,
  128. uint64_t key);
  129. void mf_classic_reader_add_sector(
  130. MfClassicReader* reader,
  131. uint8_t sector,
  132. uint64_t key_a,
  133. uint64_t key_b);
  134. void mf_classic_read_sector(FuriHalNfcTxRxContext* tx_rx, MfClassicData* data, uint8_t sec_num);
  135. uint8_t mf_classic_read_card(
  136. FuriHalNfcTxRxContext* tx_rx,
  137. MfClassicReader* reader,
  138. MfClassicData* data);
  139. uint8_t mf_classic_update_card(FuriHalNfcTxRxContext* tx_rx, MfClassicData* data);
  140. bool mf_classic_emulator(MfClassicEmulator* emulator, FuriHalNfcTxRxContext* tx_rx);
  141. bool mf_classic_write_block(
  142. FuriHalNfcTxRxContext* tx_rx,
  143. MfClassicBlock* src_block,
  144. uint8_t block_num,
  145. MfClassicKey key_type,
  146. uint64_t key);
  147. bool mf_classic_write_sector(
  148. FuriHalNfcTxRxContext* tx_rx,
  149. MfClassicData* dest_data,
  150. MfClassicData* src_data,
  151. uint8_t sec_num);