mifare_classic.h 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  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_auth_attempt(
  119. FuriHalNfcTxRxContext* tx_rx,
  120. MfClassicAuthContext* auth_ctx,
  121. uint64_t key);
  122. void mf_classic_reader_add_sector(
  123. MfClassicReader* reader,
  124. uint8_t sector,
  125. uint64_t key_a,
  126. uint64_t key_b);
  127. void mf_classic_read_sector(FuriHalNfcTxRxContext* tx_rx, MfClassicData* data, uint8_t sec_num);
  128. uint8_t mf_classic_read_card(
  129. FuriHalNfcTxRxContext* tx_rx,
  130. MfClassicReader* reader,
  131. MfClassicData* data);
  132. uint8_t mf_classic_update_card(FuriHalNfcTxRxContext* tx_rx, MfClassicData* data);
  133. bool mf_classic_emulator(MfClassicEmulator* emulator, FuriHalNfcTxRxContext* tx_rx);
  134. bool mf_classic_write_block(
  135. FuriHalNfcTxRxContext* tx_rx,
  136. MfClassicBlock* src_block,
  137. uint8_t block_num,
  138. MfClassicKey key_type,
  139. uint64_t key);
  140. bool mf_classic_write_sector(
  141. FuriHalNfcTxRxContext* tx_rx,
  142. MfClassicData* dest_data,
  143. MfClassicData* src_data,
  144. uint8_t sec_num);