ESPHome 2026.11.0b6
Loading...
Searching...
No Matches
xiaomi_ble.h
Go to the documentation of this file.
1#pragma once
2
5
6#include <initializer_list>
7
8namespace esphome::xiaomi_ble {
9
49
51 uint8_t key[16];
52 uint8_t plaintext[16];
53 uint8_t ciphertext[16];
54 uint8_t authdata[16];
55 uint8_t iv[16];
56 uint8_t tag[16];
57 size_t keysize;
58 size_t authsize;
59 size_t datasize;
60 size_t tagsize;
61 size_t ivsize;
62};
63
65static constexpr size_t XIAOMI_MAX_ENCRYPTED_FRAME_SIZE = 24;
66
67bool parse_xiaomi_value(uint16_t value_type, const uint8_t *data, uint8_t value_length, XiaomiParseResult &result);
68bool parse_xiaomi_message(const uint8_t *message, size_t size, XiaomiParseResult &result);
70optional<XiaomiParseResult> parse_xiaomi_header(const uint8_t *raw, size_t size);
72bool decrypt_xiaomi_payload(uint8_t *raw, size_t size, const uint8_t *bindkey, uint64_t address);
73
76 public:
77 void set_address(uint64_t address) { this->address_ = address; }
78 bool parse_device(const ble_device_base::ESPBTDevice &device) override {
79 return this->parse_xiaomi_device_(device, nullptr);
80 }
81
82 protected:
84 bool parse_xiaomi_device_(const ble_device_base::ESPBTDevice &device, const uint8_t *bindkey);
85 virtual void publish_result(const XiaomiParseResult &result) = 0;
86
87 uint64_t address_{0};
88 optional<uint8_t> last_frame_count_;
89};
90
93 public:
94 void set_bindkey(std::initializer_list<uint8_t> bindkey);
95 bool parse_device(const ble_device_base::ESPBTDevice &device) override {
96 return this->parse_xiaomi_device_(device, this->bindkey_);
97 }
98
99 protected:
100 void dump_bindkey_(const char *tag) const;
101
102 uint8_t bindkey_[16]{};
103};
104
106 public:
107 bool parse_device(const ble_device_base::ESPBTDevice &device) override;
108};
109
110} // namespace esphome::xiaomi_ble
uint8_t raw[35]
Definition bl0939.h:0
A Xiaomi MiBeacon device: matches its address, decodes each frame once and hands it to publish_result...
Definition xiaomi_ble.h:75
optional< uint8_t > last_frame_count_
Definition xiaomi_ble.h:88
bool parse_device(const ble_device_base::ESPBTDevice &device) override
Definition xiaomi_ble.h:78
bool parse_xiaomi_device_(const ble_device_base::ESPBTDevice &device, const uint8_t *bindkey)
Encrypted frames are dropped when bindkey is null.
virtual void publish_result(const XiaomiParseResult &result)=0
void set_address(uint64_t address)
Definition xiaomi_ble.h:77
A XiaomiDevice whose frames are encrypted with a bindkey.
Definition xiaomi_ble.h:92
bool parse_device(const ble_device_base::ESPBTDevice &device) override
Definition xiaomi_ble.h:95
void set_bindkey(std::initializer_list< uint8_t > bindkey)
void dump_bindkey_(const char *tag) const
bool parse_device(const ble_device_base::ESPBTDevice &device) override
const LogString * message
Definition component.cpp:35
bool parse_xiaomi_message(const uint8_t *message, size_t size, XiaomiParseResult &result)
bool decrypt_xiaomi_payload(uint8_t *raw, size_t size, const uint8_t *bindkey, uint64_t address)
Decrypts the payload of raw in place and clears its encryption flag.
bool parse_xiaomi_value(uint16_t value_type, const uint8_t *data, uint8_t value_length, XiaomiParseResult &result)
optional< XiaomiParseResult > parse_xiaomi_header(const uint8_t *raw, size_t size)
Parses the frame control and product id; the caller checks the 0xFE95 UUID and filters duplicates.
uint16_t size
Definition helpers.cpp:34
enum esphome::xiaomi_ble::XiaomiParseResult::@206 type