ESPHome 2026.6.0-dev
Loading...
Searching...
No Matches
ruuvi_ble.cpp
Go to the documentation of this file.
1#include "ruuvi_ble.h"
2#include "esphome/core/log.h"
3
4#ifdef USE_ESP32
5
7
8static const char *const TAG = "ruuvi_ble";
9
11 const uint8_t data_type = adv_data[0];
12 const auto *data = &adv_data[1];
13 switch (data_type) {
14 case 0x03: { // RAWv1
15 if (adv_data.size() != 14)
16 return false;
17
18 const uint8_t temp_sign = (data[1] >> 7) & 1;
19 const float temp_val = (data[1] & 0x7F) + (data[2] / 100.0f);
20 const float temperature = temp_sign == 0 ? temp_val : -1 * temp_val;
21
22 const float humidity = data[0] * 0.5f;
23 const float pressure = (encode_uint16(data[3], data[4]) + 50000.0f) / 100.0f;
24 const float acceleration_x = static_cast<int16_t>(encode_uint16(data[5], data[6])) / 1000.0f;
25 const float acceleration_y = static_cast<int16_t>(encode_uint16(data[7], data[8])) / 1000.0f;
26 const float acceleration_z = static_cast<int16_t>(encode_uint16(data[9], data[10])) / 1000.0f;
27 const float battery_voltage = encode_uint16(data[11], data[12]) / 1000.0f;
28
29 result.humidity = humidity;
30 result.temperature = temperature;
31 result.pressure = pressure;
32 result.acceleration_x = acceleration_x;
33 result.acceleration_y = acceleration_y;
34 result.acceleration_z = acceleration_z;
35 result.acceleration =
36 sqrtf(acceleration_x * acceleration_x + acceleration_y * acceleration_y + acceleration_z * acceleration_z);
37 result.battery_voltage = battery_voltage;
38
39 return true;
40 }
41 case 0x05: { // RAWv2
42 if (adv_data.size() != 24)
43 return false;
44
45 const float temperature = static_cast<int16_t>(encode_uint16(data[0], data[1])) * 0.005f;
46 const float humidity = encode_uint16(data[2], data[3]) / 400.0f;
47 const float pressure = (encode_uint16(data[4], data[5]) + 50000.0f) / 100.0f;
48 const float acceleration_x = static_cast<int16_t>(encode_uint16(data[6], data[7])) / 1000.0f;
49 const float acceleration_y = static_cast<int16_t>(encode_uint16(data[8], data[9])) / 1000.0f;
50 const float acceleration_z = static_cast<int16_t>(encode_uint16(data[10], data[11])) / 1000.0f;
51
52 const uint16_t power_info = encode_uint16(data[12], data[13]);
53 const float battery_voltage = ((power_info >> 5) + 1600.0f) / 1000.0f;
54 const float tx_power = ((power_info & 0x1F) * 2.0f) - 40.0f;
55
56 const float movement_counter = float(data[14]);
57 const float measurement_sequence_number = float(encode_uint16(data[15], data[16]));
58
59 result.temperature = data[0] == 0x7F && data[1] == 0xFF ? NAN : temperature;
60 result.humidity = data[2] == 0xFF && data[3] == 0xFF ? NAN : humidity;
61 result.pressure = data[4] == 0xFF && data[5] == 0xFF ? NAN : pressure;
62 result.acceleration_x = data[6] == 0xFF && data[7] == 0xFF ? NAN : acceleration_x;
63 result.acceleration_y = data[8] == 0xFF && data[9] == 0xFF ? NAN : acceleration_y;
64 result.acceleration_z = data[10] == 0xFF && data[11] == 0xFF ? NAN : acceleration_z;
65 if ((data[6] != 0xFF || data[7] != 0xFF) && (data[8] != 0xFF || data[9] != 0xFF) &&
66 (data[10] != 0xFF || data[11] != 0xFF)) {
67 result.acceleration =
68 sqrtf(acceleration_x * acceleration_x + acceleration_y * acceleration_y + acceleration_z * acceleration_z);
69 } else {
70 result.acceleration = NAN;
71 }
72 result.battery_voltage = (power_info >> 5) == 0x7FF ? NAN : battery_voltage;
73 result.tx_power = (power_info & 0x1F) == 0x1F ? NAN : tx_power;
74 result.movement_counter = movement_counter;
75 result.measurement_sequence_number = measurement_sequence_number;
76
77 return true;
78 }
79 default:
80 return false;
81 }
82}
83optional<RuuviParseResult> parse_ruuvi(const esp32_ble_tracker::ESPBTDevice &device) {
84 bool success = false;
85 RuuviParseResult result{};
86 for (auto &it : device.get_manufacturer_datas()) {
87 bool is_ruuvi = it.uuid.contains(0x99, 0x04);
88 if (!is_ruuvi)
89 continue;
90
91 if (parse_ruuvi_data_byte(it.data, result))
92 success = true;
93 }
94 if (!success)
95 return {};
96 return result;
97}
98
100 auto res = parse_ruuvi(device);
101 if (!res.has_value())
102 return false;
103
104 char addr_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
105 ESP_LOGD(TAG, "Got RuuviTag (%s):", device.address_str_to(addr_buf));
106
107 if (res->humidity.has_value()) {
108 ESP_LOGD(TAG, " Humidity: %.2f%%", *res->humidity);
109 }
110 if (res->temperature.has_value()) {
111 ESP_LOGD(TAG, " Temperature: %.2f°C", *res->temperature);
112 }
113 if (res->pressure.has_value()) {
114 ESP_LOGD(TAG, " Pressure: %.2fhPa", *res->pressure);
115 }
116 if (res->acceleration.has_value()) {
117 ESP_LOGD(TAG, " Acceleration: %.3fG", *res->acceleration);
118 }
119 if (res->acceleration_x.has_value()) {
120 ESP_LOGD(TAG, " Acceleration X: %.3fG", *res->acceleration_x);
121 }
122 if (res->acceleration_y.has_value()) {
123 ESP_LOGD(TAG, " Acceleration Y: %.3fG", *res->acceleration_y);
124 }
125 if (res->acceleration_z.has_value()) {
126 ESP_LOGD(TAG, " Acceleration Z: %.3fG", *res->acceleration_z);
127 }
128 if (res->battery_voltage.has_value()) {
129 ESP_LOGD(TAG, " Battery Voltage: %.3fV", *res->battery_voltage);
130 }
131 if (res->tx_power.has_value()) {
132 ESP_LOGD(TAG, " TX Power: %.0fdBm", *res->tx_power);
133 }
134 if (res->movement_counter.has_value()) {
135 ESP_LOGD(TAG, " Movement Counter: %.0f", *res->movement_counter);
136 }
137 if (res->measurement_sequence_number.has_value()) {
138 ESP_LOGD(TAG, " Measurement Sequence Number: %.0f", *res->measurement_sequence_number);
139 }
140
141 return true;
142}
143
144} // namespace esphome::ruuvi_ble
145
146#endif
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_manufacturer_datas() const
bool parse_device(const esp32_ble_tracker::ESPBTDevice &device) override
Definition ruuvi_ble.cpp:99
std::vector< uint8_t > adv_data_t
bool parse_ruuvi_data_byte(const esp32_ble_tracker::adv_data_t &adv_data, RuuviParseResult &result)
Definition ruuvi_ble.cpp:10
optional< RuuviParseResult > parse_ruuvi(const esp32_ble_tracker::ESPBTDevice &device)
Definition ruuvi_ble.cpp:83
constexpr uint16_t encode_uint16(uint8_t msb, uint8_t lsb)
Encode a 16-bit value given the most and least significant byte.
Definition helpers.h:859
optional< float > measurement_sequence_number
Definition ruuvi_ble.h:21
uint16_t temperature
Definition sun_gtil2.cpp:12
uint8_t pressure
Definition tt21100.cpp:7