ESPHome 2026.6.0-dev
Loading...
Searching...
No Matches
xiaomi_rtcgq02lm.cpp
Go to the documentation of this file.
1#include "xiaomi_rtcgq02lm.h"
3#include "esphome/core/log.h"
4
5#ifdef USE_ESP32
6
8
9static const char *const TAG = "xiaomi_rtcgq02lm";
10
11static constexpr size_t RTCGQ02LM_BINDKEY_SIZE = 16;
12
14 char bindkey_hex[format_hex_pretty_size(RTCGQ02LM_BINDKEY_SIZE)];
15 ESP_LOGCONFIG(TAG, "Xiaomi RTCGQ02LM");
16 ESP_LOGCONFIG(TAG, " Bindkey: %s", format_hex_pretty_to(bindkey_hex, this->bindkey_, RTCGQ02LM_BINDKEY_SIZE, '.'));
17#ifdef USE_BINARY_SENSOR
18 LOG_BINARY_SENSOR(" ", "Motion", this->motion_);
19 LOG_BINARY_SENSOR(" ", "Light", this->light_);
20 LOG_BINARY_SENSOR(" ", "Button", this->button_);
21#endif
22#ifdef USE_SENSOR
23 LOG_SENSOR(" ", "Battery Level", this->battery_level_);
24#endif
25}
26
28 if (device.address_uint64() != this->address_) {
29 ESP_LOGVV(TAG, "parse_device(): unknown MAC address.");
30 return false;
31 }
32 char addr_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
33 const char *addr_str = device.address_str_to(addr_buf);
34 ESP_LOGVV(TAG, "parse_device(): MAC address %s found.", addr_str);
35
36 bool success = false;
37 for (auto &service_data : device.get_service_datas()) {
38 auto res = xiaomi_ble::parse_xiaomi_header(service_data);
39 if (!res.has_value()) {
40 continue;
41 }
42 if (res->is_duplicate) {
43 continue;
44 }
45 if (res->has_encryption &&
46 (!(xiaomi_ble::decrypt_xiaomi_payload(const_cast<std::vector<uint8_t> &>(service_data.data), this->bindkey_,
47 this->address_)))) {
48 continue;
49 }
50 if (!(xiaomi_ble::parse_xiaomi_message(service_data.data, *res))) {
51 continue;
52 }
53
54 if (!(xiaomi_ble::report_xiaomi_results(res, addr_str))) {
55 continue;
56 }
57#ifdef USE_BINARY_SENSOR
58 if (res->has_motion.has_value() && this->motion_ != nullptr) {
59 this->motion_->publish_state(*res->has_motion);
60 this->set_timeout("motion_timeout", this->motion_timeout_, [this]() { this->motion_->publish_state(false); });
61 }
62 if (res->is_light.has_value() && this->light_ != nullptr)
63 this->light_->publish_state(*res->is_light);
64 if (res->button_press.has_value() && this->button_ != nullptr) {
65 this->button_->publish_state(*res->button_press);
66 this->set_timeout("button_timeout", this->button_timeout_, [this]() { this->button_->publish_state(false); });
67 }
68#endif
69#ifdef USE_SENSOR
70 if (res->battery_level.has_value() && this->battery_level_ != nullptr)
71 this->battery_level_->publish_state(*res->battery_level);
72#endif
73 success = true;
74 }
75
76 return success;
77}
78
79void XiaomiRTCGQ02LM::set_bindkey(const char *bindkey) { parse_hex(bindkey, this->bindkey_, sizeof(this->bindkey_)); }
80
81} // namespace esphome::xiaomi_rtcgq02lm
82
83#endif
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_timeout(const std voi set_timeout)(const char *name, uint32_t timeout, std::function< void()> &&f)
Set a timeout function with a unique name.
Definition component.h:493
void publish_state(bool new_state)
Publish a new state to the front-end.
const char * address_str_to(std::span< char, MAC_ADDRESS_PRETTY_BUFFER_SIZE > buf) const
Format MAC address into provided buffer, returns pointer to buffer for convenience.
const std::vector< ServiceData > & get_service_datas() const
void publish_state(float state)
Publish a new state to the front-end.
Definition sensor.cpp:68
binary_sensor::BinarySensor * motion_
binary_sensor::BinarySensor * button_
bool parse_device(const esp32_ble_tracker::ESPBTDevice &device) override
bool decrypt_xiaomi_payload(std::vector< uint8_t > &raw, const uint8_t *bindkey, const uint64_t &address)
optional< XiaomiParseResult > parse_xiaomi_header(const esp32_ble_tracker::ServiceData &service_data)
bool parse_xiaomi_message(const std::vector< uint8_t > &message, XiaomiParseResult &result)
bool report_xiaomi_results(const optional< XiaomiParseResult > &result, const char *address)
size_t parse_hex(const char *str, size_t length, uint8_t *data, size_t count)
Parse bytes from a hex-encoded string into a byte array.
Definition helpers.cpp:274
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:340
constexpr size_t format_hex_pretty_size(size_t byte_count)
Calculate buffer size needed for format_hex_pretty_to with separator: "XX:XX:...:XX\0".
Definition helpers.h:1386