ESPHome 2026.2.1
Loading...
Searching...
No Matches
seeed_mr60fda2.cpp
Go to the documentation of this file.
1#include "seeed_mr60fda2.h"
3#include "esphome/core/log.h"
4
5#include <cinttypes>
6#include <utility>
7
8namespace esphome {
9namespace seeed_mr60fda2 {
10
11static const char *const TAG = "seeed_mr60fda2";
12
13// Maximum bytes to log in verbose hex output
14static constexpr size_t MR60FDA2_MAX_LOG_BYTES = 64;
15
16// Prints the component's configuration data. dump_config() prints all of the component's configuration
17// items in an easy-to-read format, including the configuration key-value pairs.
19 ESP_LOGCONFIG(TAG, "MR60FDA2:");
20#ifdef USE_BINARY_SENSOR
21 LOG_BINARY_SENSOR(" ", "People Exist Binary Sensor", this->people_exist_binary_sensor_);
22 LOG_BINARY_SENSOR(" ", "Is Fall Binary Sensor", this->fall_detected_binary_sensor_);
23#endif
24#ifdef USE_BUTTON
25 LOG_BUTTON(" ", "Get Radar Parameters Button", this->get_radar_parameters_button_);
26 LOG_BUTTON(" ", "Reset Radar Button", this->factory_reset_button_);
27#endif
28#ifdef USE_SELECT
29 LOG_SELECT(" ", "Install Height Select", this->install_height_select_);
30 LOG_SELECT(" ", "Height Threshold Select", this->height_threshold_select_);
31 LOG_SELECT(" ", "Sensitivity Select", this->sensitivity_select_);
32#endif
33}
34
35// Initialisation functions
37 this->check_uart_settings(115200);
38
39 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
40 this->current_frame_id_ = 0;
41 this->current_frame_len_ = 0;
42 this->current_data_frame_len_ = 0;
43 this->current_frame_type_ = 0;
45
46 memset(this->current_frame_buf_, 0, FRAME_BUF_MAX_SIZE);
47 memset(this->current_data_buf_, 0, DATA_BUF_MAX_SIZE);
48}
49
50// main loop
52 // Read all available bytes in batches to reduce UART call overhead.
53 size_t avail = this->available();
54 uint8_t buf[64];
55 while (avail > 0) {
56 size_t to_read = std::min(avail, sizeof(buf));
57 if (!this->read_array(buf, to_read)) {
58 break;
59 }
60 avail -= to_read;
61
62 for (size_t i = 0; i < to_read; i++) {
63 this->split_frame_(buf[i]); // split data frame
64 }
65 }
66}
67
78static uint8_t calculate_checksum(const uint8_t *data, size_t len) {
79 uint8_t checksum = 0;
80 for (size_t i = 0; i < len; i++) {
81 checksum ^= data[i];
82 }
83 checksum = ~checksum;
84 return checksum;
85}
86
98static bool validate_checksum(const uint8_t *data, size_t len, uint8_t expected_checksum) {
99 return calculate_checksum(data, len) == expected_checksum;
100}
101
102static uint8_t find_nearest_index(float value, const float *arr, int size) {
103 int nearest_index = 0;
104 float min_diff = std::abs(value - arr[0]);
105 for (int i = 1; i < size; ++i) {
106 float diff = std::abs(value - arr[i]);
107 if (diff < min_diff) {
108 min_diff = diff;
109 nearest_index = i;
110 }
111 }
112 return nearest_index;
113}
114
123static void float_to_bytes(float value, unsigned char *bytes) {
124 union {
125 float float_value;
126 unsigned char byte_array[4];
127 } u;
128
129 u.float_value = value;
130 memcpy(bytes, u.byte_array, 4);
131}
132
141static void int_to_bytes(uint32_t value, unsigned char *bytes) {
142 bytes[0] = value & 0xFF;
143 bytes[1] = (value >> 8) & 0xFF;
144 bytes[2] = (value >> 16) & 0xFF;
145 bytes[3] = (value >> 24) & 0xFF;
146}
147
148void MR60FDA2Component::split_frame_(uint8_t buffer) {
149 switch (this->current_frame_locate_) {
150 case LOCATE_FRAME_HEADER: // starting buffer
151 if (buffer == FRAME_HEADER_BUFFER) {
152 this->current_frame_len_ = 1;
153 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
154 this->current_frame_locate_++;
155 }
156 break;
157 case LOCATE_ID_FRAME1:
158 this->current_frame_id_ = buffer << 8;
159 this->current_frame_len_++;
160 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
161 this->current_frame_locate_++;
162 break;
163 case LOCATE_ID_FRAME2:
164 this->current_frame_id_ += buffer;
165 this->current_frame_len_++;
166 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
167 this->current_frame_locate_++;
168 break;
170 this->current_data_frame_len_ = buffer << 8;
171 if (this->current_data_frame_len_ == 0x00) {
172 this->current_frame_len_++;
173 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
174 this->current_frame_locate_++;
175 } else {
176 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
177 }
178 break;
180 this->current_data_frame_len_ += buffer;
181 if (this->current_data_frame_len_ > DATA_BUF_MAX_SIZE) {
182 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
183 } else {
184 this->current_frame_len_++;
185 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
186 this->current_frame_locate_++;
187 }
188 break;
190 this->current_frame_type_ = buffer << 8;
191 this->current_frame_len_++;
192 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
193 this->current_frame_locate_++;
194 break;
196 this->current_frame_type_ += buffer;
197 if ((this->current_frame_type_ == IS_FALL_TYPE_BUFFER) ||
198 (this->current_frame_type_ == PEOPLE_EXIST_TYPE_BUFFER) ||
199 (this->current_frame_type_ == RESULT_INSTALL_HEIGHT) || (this->current_frame_type_ == RESULT_PARAMETERS) ||
200 (this->current_frame_type_ == RESULT_HEIGHT_THRESHOLD) || (this->current_frame_type_ == RESULT_SENSITIVITY)) {
201 this->current_frame_len_++;
202 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
203 this->current_frame_locate_++;
204 } else {
205 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
206 }
207 break;
209 if (validate_checksum(this->current_frame_buf_, this->current_frame_len_, buffer)) {
210 this->current_frame_len_++;
211 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
212 this->current_frame_locate_++;
213 } else {
214 ESP_LOGD(TAG, "HEAD_CKSUM_FRAME ERROR: 0x%02x", buffer);
215#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
216 char frame_buf[format_hex_pretty_size(MR60FDA2_MAX_LOG_BYTES)];
217 char byte_buf[format_hex_pretty_size(1)];
218#endif
219 ESP_LOGV(TAG, "CURRENT_FRAME: %s %s",
220 format_hex_pretty_to(frame_buf, this->current_frame_buf_, this->current_frame_len_),
221 format_hex_pretty_to(byte_buf, &buffer, 1));
222 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
223 }
224 break;
226 this->current_frame_len_++;
227 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
228 this->current_data_buf_[this->current_frame_len_ - LEN_TO_DATA_FRAME] = buffer;
229 if (this->current_frame_len_ - LEN_TO_HEAD_CKSUM == this->current_data_frame_len_) {
230 this->current_frame_locate_++;
231 }
232 if (this->current_frame_len_ > FRAME_BUF_MAX_SIZE) {
233 ESP_LOGD(TAG, "PRACTICE_DATA_FRAME_LEN ERROR: %d", this->current_frame_len_ - LEN_TO_HEAD_CKSUM);
234 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
235 }
236 break;
238 if (validate_checksum(this->current_data_buf_, this->current_data_frame_len_, buffer)) {
239 this->current_frame_len_++;
240 this->current_frame_buf_[this->current_frame_len_ - 1] = buffer;
241 this->current_frame_locate_++;
242 this->process_frame_();
243 } else {
244 ESP_LOGD(TAG, "DATA_CKSUM_FRAME ERROR: 0x%02x", buffer);
245#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
246 char frame_buf[format_hex_pretty_size(MR60FDA2_MAX_LOG_BYTES)];
247 char byte_buf[format_hex_pretty_size(1)];
248#endif
249 ESP_LOGV(TAG, "GET CURRENT_FRAME: %s %s",
250 format_hex_pretty_to(frame_buf, this->current_frame_buf_, this->current_frame_len_),
251 format_hex_pretty_to(byte_buf, &buffer, 1));
252
253 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
254 }
255 break;
256 default:
257 break;
258 }
259}
260
261void MR60FDA2Component::process_frame_() {
262 switch (this->current_frame_type_) {
263 case IS_FALL_TYPE_BUFFER:
264 if (this->fall_detected_binary_sensor_ != nullptr) {
265 this->fall_detected_binary_sensor_->publish_state(this->current_frame_buf_[LEN_TO_HEAD_CKSUM]);
266 }
267 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
268 break;
269
270 case PEOPLE_EXIST_TYPE_BUFFER:
271 if (this->people_exist_binary_sensor_ != nullptr)
272 this->people_exist_binary_sensor_->publish_state(this->current_frame_buf_[LEN_TO_HEAD_CKSUM]);
273 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
274 break;
275
276 case RESULT_INSTALL_HEIGHT:
277 if (this->current_data_buf_[0]) {
278 ESP_LOGD(TAG, "Successfully set the mounting height");
279 } else {
280 ESP_LOGD(TAG, "Failed to set the mounting height");
281 }
282 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
283 break;
284
285 case RESULT_HEIGHT_THRESHOLD:
286 if (this->current_data_buf_[0]) {
287 ESP_LOGD(TAG, "Successfully set the height threshold");
288 } else {
289 ESP_LOGD(TAG, "Failed to set the height threshold");
290 }
291 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
292 break;
293
294 case RESULT_SENSITIVITY:
295 if (this->current_data_buf_[0]) {
296 ESP_LOGD(TAG, "Successfully set the sensitivity");
297 } else {
298 ESP_LOGD(TAG, "Failed to set the sensitivity");
299 }
300 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
301 break;
302
303 case RESULT_PARAMETERS: {
304 float install_height_float = 0;
305 float height_threshold_float = 0;
306 uint32_t current_sensitivity = 0;
307 if (this->install_height_select_ != nullptr) {
308 uint32_t current_install_height_int =
309 encode_uint32(current_data_buf_[3], current_data_buf_[2], current_data_buf_[1], current_data_buf_[0]);
310
311 install_height_float = bit_cast<float>(current_install_height_int);
312 uint32_t select_index = find_nearest_index(install_height_float, INSTALL_HEIGHT, 7);
313 this->install_height_select_->publish_state(select_index);
314 }
315
316 if (this->height_threshold_select_ != nullptr) {
317 uint32_t current_height_threshold_int =
318 encode_uint32(current_data_buf_[7], current_data_buf_[6], current_data_buf_[5], current_data_buf_[4]);
319
320 height_threshold_float = bit_cast<float>(current_height_threshold_int);
321 size_t select_index = find_nearest_index(height_threshold_float, HEIGHT_THRESHOLD, 7);
322 this->height_threshold_select_->publish_state(select_index);
323 }
324
325 if (this->sensitivity_select_ != nullptr) {
326 current_sensitivity =
327 encode_uint32(current_data_buf_[11], current_data_buf_[10], current_data_buf_[9], current_data_buf_[8]);
328
329 uint32_t select_index = find_nearest_index(current_sensitivity, SENSITIVITY, 3);
330 this->sensitivity_select_->publish_state(select_index);
331 }
332
333 ESP_LOGD(TAG, "Mounting height: %.2f, Height threshold: %.2f, Sensitivity: %" PRIu32, install_height_float,
334 height_threshold_float, current_sensitivity);
335 this->current_frame_locate_ = LOCATE_FRAME_HEADER;
336 break;
337 }
338 default:
339 break;
340 }
341}
342
343// Send Heartbeat Packet Command
345 uint8_t send_data[13] = {0x01, 0x00, 0x00, 0x00, 0x04, 0x0E, 0x04, 0xF0, 0x00, 0x00, 0x00, 0x00, 0x00};
346 float_to_bytes(INSTALL_HEIGHT[index], &send_data[8]);
347 send_data[12] = calculate_checksum(send_data + 8, 4);
348 this->write_array(send_data, 13);
349#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
350 char hex_buf[format_hex_pretty_size(13)];
351#endif
352 ESP_LOGV(TAG, "SEND INSTALL HEIGHT FRAME: %s", format_hex_pretty_to(hex_buf, send_data, 13));
353}
354
356 uint8_t send_data[13] = {0x01, 0x00, 0x00, 0x00, 0x04, 0x0E, 0x08, 0xFC, 0x00, 0x00, 0x00, 0x00, 0x00};
357 float_to_bytes(HEIGHT_THRESHOLD[index], &send_data[8]);
358 send_data[12] = calculate_checksum(send_data + 8, 4);
359 this->write_array(send_data, 13);
360#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
361 char hex_buf[format_hex_pretty_size(13)];
362#endif
363 ESP_LOGV(TAG, "SEND HEIGHT THRESHOLD: %s", format_hex_pretty_to(hex_buf, send_data, 13));
364}
365
367 uint8_t send_data[13] = {0x01, 0x00, 0x00, 0x00, 0x04, 0x0E, 0x0A, 0xFE, 0x00, 0x00, 0x00, 0x00, 0x00};
368
369 int_to_bytes(SENSITIVITY[index], &send_data[8]);
370
371 send_data[12] = calculate_checksum(send_data + 8, 4);
372 this->write_array(send_data, 13);
373#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
374 char hex_buf[format_hex_pretty_size(13)];
375#endif
376 ESP_LOGV(TAG, "SEND SET SENSITIVITY: %s", format_hex_pretty_to(hex_buf, send_data, 13));
377}
378
380 uint8_t send_data[8] = {0x01, 0x00, 0x00, 0x00, 0x00, 0x0E, 0x06, 0xF6};
381 this->write_array(send_data, 8);
382#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
383 char hex_buf[format_hex_pretty_size(8)];
384#endif
385 ESP_LOGV(TAG, "SEND GET PARAMETERS: %s", format_hex_pretty_to(hex_buf, send_data, 8));
386}
387
389 uint8_t send_data[8] = {0x01, 0x00, 0x00, 0x00, 0x00, 0x21, 0x10, 0xCF};
390 this->write_array(send_data, 8);
391#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
392 char hex_buf[format_hex_pretty_size(8)];
393#endif
394 ESP_LOGV(TAG, "SEND RESET: %s", format_hex_pretty_to(hex_buf, send_data, 8));
395 this->get_radar_parameters();
396}
397
398} // namespace seeed_mr60fda2
399} // namespace esphome
uint8_t checksum
Definition bl0906.h:3
optional< std::array< uint8_t, N > > read_array()
Definition uart.h:38
void check_uart_settings(uint32_t baud_rate, uint8_t stop_bits=1, UARTParityOptions parity=UART_CONFIG_PARITY_NONE, uint8_t data_bits=8)
Check that the configuration of the UART bus matches the provided values and otherwise print a warnin...
Definition uart.cpp:16
void write_array(const uint8_t *data, size_t len)
Definition uart.h:26
std::vector< uint8_t > bytes
Definition sml_parser.h:13
Providing packet encoding functions for exchanging data with a remote host.
Definition a01nyub.cpp:7
std::string size_t len
Definition helpers.h:692
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
size_t size
Definition helpers.h:729
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:978
constexpr uint32_t encode_uint32(uint8_t byte1, uint8_t byte2, uint8_t byte3, uint8_t byte4)
Encode a 32-bit value given four bytes in most to least significant byte order.
Definition helpers.h:536
To bit_cast(const From &src)
Convert data between types, without aliasing issues or undefined behaviour.
Definition helpers.h:76