ESPHome 2026.11.0b6
Loading...
Searching...
No Matches
pvvx_mithermometer.cpp
Go to the documentation of this file.
3#include "esphome/core/log.h"
4
6
7ESPHOME_LOG_TAG(TAG, "pvvx_mithermometer");
8
9void PVVXMiThermometer::dump_config() {
10 ESP_LOGCONFIG(TAG, "PVVX MiThermometer");
11 LOG_SENSOR(" ", "Temperature", this->temperature_sensor_);
12 LOG_SENSOR(" ", "Humidity", this->humidity_sensor_);
13 LOG_SENSOR(" ", "Battery Level", this->battery_level_sensor_);
14 LOG_SENSOR(" ", "Battery Voltage", this->battery_voltage_sensor_);
15}
16
17bool PVVXMiThermometer::parse_device(const ble_device_base::ESPBTDevice &device) {
18 if (device.address_uint64() != this->address_) {
19 ESP_LOGVV(TAG, "parse_device(): unknown MAC address.");
20 return false;
21 }
22 char addr_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
23 const char *addr_str = device.address_str_to(addr_buf);
24 ESP_LOGVV(TAG, "parse_device(): MAC address %s found.", addr_str);
25
26 bool success = false;
27 for (auto &service_data : device.get_service_datas()) {
28 auto res = parse_header_(service_data);
29 if (!res.has_value()) {
30 continue;
31 }
32 if (!(parse_message_(service_data.data, *res))) {
33 continue;
34 }
35 if (!(report_results_(res, addr_str))) {
36 continue;
37 }
38 publish_optional(this->temperature_sensor_, res->temperature);
39 publish_optional(this->humidity_sensor_, res->humidity);
40 publish_optional(this->battery_level_sensor_, res->battery_level);
41 publish_optional(this->battery_voltage_sensor_, res->battery_voltage);
42 PUBLISH_STATE(this->signal_strength_sensor_, device.get_rssi());
43 success = true;
44 }
45
46 return success;
47}
48
49optional<ParseResult> PVVXMiThermometer::parse_header_(const ble_device_base::ServiceData &service_data) {
50 ParseResult result;
51 if (!service_data.uuid.contains(0x1A, 0x18)) {
52 ESP_LOGVV(TAG, "parse_header(): no service data UUID magic bytes.");
53 return {};
54 }
55
56 const auto &raw = service_data.data;
57 if (raw.size() < 14) {
58 ESP_LOGVV(TAG, "parse_header_(): service data too short (%zu).", raw.size());
59 return {};
60 }
61
62 if (this->last_frame_count_ == raw[13]) {
63 ESP_LOGVV(TAG, "parse_header(): duplicate data packet received (%hhu).", this->last_frame_count_);
64 return {};
65 }
66 this->last_frame_count_ = raw[13];
67
68 return result;
69}
70
71bool PVVXMiThermometer::parse_message_(const std::vector<uint8_t> &message, ParseResult &result) {
72 /*
73 All data little endian
74 uint8_t size; // = 19
75 uint8_t uid; // = 0x16, 16-bit UUID
76 uint16_t UUID; // = 0x181A, GATT Service 0x181A Environmental Sensing
77 uint8_t MAC[6]; // [0] - lo, .. [5] - hi digits
78 int16_t temperature; // x 0.01 degree [6,7]
79 uint16_t humidity; // x 0.01 % [8,9]
80 uint16_t battery_mv; // mV [10,11]
81 uint8_t battery_level; // 0..100 % [12]
82 uint8_t counter; // measurement count [13]
83 uint8_t flags; [14]
84 */
85
86 const uint8_t *data = message.data();
87 const int data_length = 15;
88
89 if (message.size() != data_length) {
90 ESP_LOGVV(TAG, "parse_message(): payload has wrong size (%d)!", message.size());
91 return false;
92 }
93
94 // int16_t temperature; // x 0.01 degree [6,7]
95 const int16_t temperature = encode_value_le<int16_t>(&data[6]);
96 result.temperature = temperature / 1.0e2f;
97
98 // uint16_t humidity; // x 0.01 % [8,9]
99 const int16_t humidity = encode_value_le<int16_t>(&data[8]);
100 result.humidity = humidity / 1.0e2f;
101
102 // uint16_t battery_mv; // mV [10,11]
103 const int16_t battery_voltage = encode_value_le<int16_t>(&data[10]);
104 result.battery_voltage = battery_voltage / 1.0e3f;
105
106 // uint8_t battery_level; // 0..100 % [12]
107 result.battery_level = uint8_t(data[12]);
108
109 return true;
110}
111
112bool PVVXMiThermometer::report_results_(const optional<ParseResult> &result, const char *address) {
113 if (!result.has_value()) {
114 ESP_LOGVV(TAG, "report_results(): no results available.");
115 return false;
116 }
117
118 ESP_LOGD(TAG, "Got PVVX MiThermometer (%s):", address);
119
120 if (result->temperature.has_value()) {
121 ESP_LOGD(TAG, " Temperature: %.2f °C", *result->temperature);
122 }
123 if (result->humidity.has_value()) {
124 ESP_LOGD(TAG, " Humidity: %.2f %%", *result->humidity);
125 }
126 if (result->battery_level.has_value()) {
127 ESP_LOGD(TAG, " Battery Level: %.0f %%", *result->battery_level);
128 }
129 if (result->battery_voltage.has_value()) {
130 ESP_LOGD(TAG, " Battery Voltage: %.3f V", *result->battery_voltage);
131 }
132
133 return true;
134}
135
136} // namespace esphome::pvvx_mithermometer
uint8_t raw[35]
Definition bl0939.h:0
ESPDEPRECATED("Use address_str_to() instead. Removed in 2027.2.0.", "2026.8.0") std const char * address_str_to(char *buf) const
Return MAC as "XX:XX:XX:XX:XX:XX" string.
uint64_t address_uint64() const
Return MAC as packed uint64 (byte 0 in LSB — matches esp32's address_uint64).
const std::vector< ServiceData > & get_service_datas() const
Definition ble_device.h:225
bool contains(uint8_t data1, uint8_t data2) const
True if the UUID value contains the adjacent byte pair (data1, data2).
bool parse_message_(const std::vector< uint8_t > &message, ParseResult &result)
optional< ParseResult > parse_header_(const ble_device_base::ServiceData &service_data)
bool report_results_(const optional< ParseResult > &result, const char *address)
const LogString * message
Definition component.cpp:35
ESPHOME_LOG_TAG(TAG, "display.pvvx_mithermometer")
constexpr T encode_value_le(const uint8_t *bytes)
Encode a value from its constituent bytes (from least to most significant) in an array with length si...
Definition helpers.h:1084
void publish_optional(E *entity, const optional< V > &value)
Publish value to entity when the entity is configured and the value is set.
uint16_t temperature
Definition sun_gtil2.cpp:12