ESPHome 2026.2.1
Loading...
Searching...
No Matches
nfc.cpp
Go to the documentation of this file.
1#include "nfc.h"
2#include <cstdio>
4#include "esphome/core/log.h"
5
6namespace esphome {
7namespace nfc {
8
9static const char *const TAG = "nfc";
10
11char *format_uid_to(char *buffer, std::span<const uint8_t> uid) {
12 return format_hex_pretty_to(buffer, FORMAT_UID_BUFFER_SIZE, uid.data(), uid.size(), '-');
13}
14
15char *format_bytes_to(char *buffer, std::span<const uint8_t> bytes) {
16 return format_hex_pretty_to(buffer, FORMAT_BYTES_BUFFER_SIZE, bytes.data(), bytes.size(), ' ');
17}
18
19#pragma GCC diagnostic push
20#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
21// Deprecated wrappers intentionally use heap-allocating version for backward compatibility
22std::string format_uid(std::span<const uint8_t> uid) {
23 return format_hex_pretty(uid.data(), uid.size(), '-', false); // NOLINT
24}
25std::string format_bytes(std::span<const uint8_t> bytes) {
26 return format_hex_pretty(bytes.data(), bytes.size(), ' ', false); // NOLINT
27}
28#pragma GCC diagnostic pop
29
30uint8_t guess_tag_type(uint8_t uid_length) {
31 if (uid_length == 4) {
32 return TAG_TYPE_MIFARE_CLASSIC;
33 } else {
34 return TAG_TYPE_2;
35 }
36}
37
38uint8_t get_mifare_classic_ndef_start_index(std::vector<uint8_t> &data) {
39 for (uint8_t i = 0; i < MIFARE_CLASSIC_BLOCK_SIZE; i++) {
40 if (data[i] == 0x00) {
41 // Do nothing, skip
42 } else if (data[i] == 0x03) {
43 return i;
44 } else {
45 return -2;
46 }
47 }
48 return -1;
49}
50
51bool decode_mifare_classic_tlv(std::vector<uint8_t> &data, uint32_t &message_length, uint8_t &message_start_index) {
53 if (data[i] != 0x03) {
54 ESP_LOGE(TAG, "Error, Can't decode message length.");
55 return false;
56 }
57 if (data[i + 1] == 0xFF) {
58 message_length = ((0xFF & data[i + 2]) << 8) | (0xFF & data[i + 3]);
59 message_start_index = i + MIFARE_CLASSIC_LONG_TLV_SIZE;
60 } else {
61 message_length = data[i + 1];
62 message_start_index = i + MIFARE_CLASSIC_SHORT_TLV_SIZE;
63 }
64 return true;
65}
66
67uint32_t get_mifare_ultralight_buffer_size(uint32_t message_length) {
68 uint32_t buffer_size = message_length + 2 + 1;
69 if (buffer_size % MIFARE_ULTRALIGHT_READ_SIZE != 0)
70 buffer_size = ((buffer_size / MIFARE_ULTRALIGHT_READ_SIZE) + 1) * MIFARE_ULTRALIGHT_READ_SIZE;
71 return buffer_size;
72}
73
74uint32_t get_mifare_classic_buffer_size(uint32_t message_length) {
75 uint32_t buffer_size = message_length;
76 if (message_length < 255) {
77 buffer_size += MIFARE_CLASSIC_SHORT_TLV_SIZE + 1;
78 } else {
79 buffer_size += MIFARE_CLASSIC_LONG_TLV_SIZE + 1;
80 }
81 if (buffer_size % MIFARE_CLASSIC_BLOCK_SIZE != 0) {
82 buffer_size = ((buffer_size / MIFARE_CLASSIC_BLOCK_SIZE) + 1) * MIFARE_CLASSIC_BLOCK_SIZE;
83 }
84 return buffer_size;
85}
86
87bool mifare_classic_is_first_block(uint8_t block_num) {
88 if (block_num < MIFARE_CLASSIC_BLOCKS_PER_SECT_LOW * MIFARE_CLASSIC_16BLOCK_SECT_START) {
89 return (block_num % MIFARE_CLASSIC_BLOCKS_PER_SECT_LOW == 0);
90 } else {
91 return (block_num % MIFARE_CLASSIC_BLOCKS_PER_SECT_HIGH == 0);
92 }
93}
94
95bool mifare_classic_is_trailer_block(uint8_t block_num) {
96 if (block_num < MIFARE_CLASSIC_BLOCKS_PER_SECT_LOW * MIFARE_CLASSIC_16BLOCK_SECT_START) {
97 return ((block_num + 1) % MIFARE_CLASSIC_BLOCKS_PER_SECT_LOW == 0);
98 } else {
99 return ((block_num + 1) % MIFARE_CLASSIC_BLOCKS_PER_SECT_HIGH == 0);
100 }
101}
102
103} // namespace nfc
104} // namespace esphome
bool decode_mifare_classic_tlv(std::vector< uint8_t > &data, uint32_t &message_length, uint8_t &message_start_index)
Definition nfc.cpp:51
char * format_bytes_to(char *buffer, std::span< const uint8_t > bytes)
Format bytes to buffer with ' ' separator (e.g., "04 11 22 33"). Returns buffer for inline use.
Definition nfc.cpp:15
uint32_t get_mifare_ultralight_buffer_size(uint32_t message_length)
Definition nfc.cpp:67
std::string format_uid(std::span< const uint8_t > uid)
Definition nfc.cpp:22
uint8_t get_mifare_classic_ndef_start_index(std::vector< uint8_t > &data)
Definition nfc.cpp:38
std::string format_bytes(std::span< const uint8_t > bytes)
Definition nfc.cpp:25
char * format_uid_to(char *buffer, std::span< const uint8_t > uid)
Format UID to buffer with '-' separator (e.g., "04-11-22-33"). Returns buffer for inline use.
Definition nfc.cpp:11
uint8_t guess_tag_type(uint8_t uid_length)
Definition nfc.cpp:30
bool mifare_classic_is_trailer_block(uint8_t block_num)
Definition nfc.cpp:95
uint32_t get_mifare_classic_buffer_size(uint32_t message_length)
Definition nfc.cpp:74
bool mifare_classic_is_first_block(uint8_t block_num)
Definition nfc.cpp:87
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7
char * format_hex_pretty_to(char *buffer, size_t buffer_size, const uint8_t *data, size_t length, char separator)
Format byte array as uppercase hex to buffer (base implementation).
Definition helpers.cpp:353
std::string format_hex_pretty(const uint8_t *data, size_t length, char separator, bool show_length)
Format a byte array in pretty-printed, human-readable hex format.
Definition helpers.cpp:401