ESPHome 2026.8.0-dev
Loading...
Searching...
No Matches
nextion.cpp
Go to the documentation of this file.
1#include "nextion.h"
2
3#include <cinttypes>
4#include <new>
5
8#include "esphome/core/log.h"
10#include "esphome/core/util.h"
11
12namespace esphome::nextion {
13
14static const char *const TAG = "nextion";
15
16// Nextion command terminator: three consecutive 0xFF bytes (per Nextion Instruction Set v1.1).
17static constexpr uint8_t COMMAND_DELIMITER[3] = {0xFF, 0xFF, 0xFF};
18static constexpr size_t DELIMITER_SIZE = sizeof(COMMAND_DELIMITER);
19
20void Nextion::setup() {
21 this->is_setup_ = false;
22 this->connection_state_.ignore_is_setup_ = true;
23
24 // Wake up the nextion and ensure clean communication state
25 this->send_command_("sleep=0"); // Exit sleep mode if sleeping
26 this->send_command_("bkcmd=0"); // Disable return data during init sequence
27
28 // Reset device for clean state - critical for reliable communication
29 this->send_command_("rest");
30
31 this->connection_state_.ignore_is_setup_ = false;
32}
33
34bool Nextion::send_command_(const std::string &command) {
35 if (!this->connection_state_.ignore_is_setup_ && !this->is_setup()) {
36 return false;
37 }
38
39#ifdef USE_NEXTION_COMMAND_SPACING
41 if (!this->connection_state_.ignore_is_setup_ && !this->command_pacer_.can_send(now)) {
42 ESP_LOGN(TAG, "Command spacing: delaying '%s'", command.c_str());
43 return false;
44 }
45#endif // USE_NEXTION_COMMAND_SPACING
46
47 ESP_LOGN(TAG, "cmd: %s", command.c_str());
48
49 this->write_str(command.c_str());
50 const uint8_t to_send[3] = {0xFF, 0xFF, 0xFF};
51 this->write_array(to_send, sizeof(to_send));
52
53#ifdef USE_NEXTION_COMMAND_SPACING
54 // Mark sent immediately after writing to UART. The pacer enforces inter-command
55 // spacing from the transmit side. Marking on ACK (0x01) would leave last_command_time_
56 // at zero indefinitely, making can_send() always return true and spacing a no-op.
57 // ignore_is_setup_ commands (setup/init sequence) bypass spacing intentionally.
58 if (!this->connection_state_.ignore_is_setup_) {
59 this->command_pacer_.mark_sent(now);
60 }
61#endif // USE_NEXTION_COMMAND_SPACING
62
63 return true;
64}
65
67 if (this->connection_state_.is_connected_)
68 return true;
69
70#ifdef USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
71 ESP_LOGW(TAG, "Connected (no handshake)"); // Log the connection status without handshake
72 this->connection_state_.is_connected_ = true; // Set the connection status to true
73 return true; // Return true indicating the connection is set
74#else // USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
75 if (this->comok_sent_ == 0) {
76 this->reset_(false);
77
78 this->connection_state_.ignore_is_setup_ = true;
79 this->send_command_("boguscommand=0"); // bogus command. needed sometimes after updating
80#ifdef USE_NEXTION_CONFIG_EXIT_REPARSE_ON_START
81 this->send_command_("DRAKJHSUYDGBNCJHGJKSHBDN");
82#endif // USE_NEXTION_CONFIG_EXIT_REPARSE_ON_START
83 this->send_command_("connect");
84
86 this->connection_state_.ignore_is_setup_ = false;
87
88 return false;
89 }
90
91 if (App.get_loop_component_start_time() - this->comok_sent_ <= 500) // Wait 500 ms
92 return false;
93
94 std::string response;
95
96 this->recv_ret_string_(response, 0, false);
97 if (!response.empty() && response[0] == 0x1A) {
98 // Swallow invalid variable name responses that may be caused by the above commands
99 ESP_LOGV(TAG, "0x1A error ignored (setup)");
100 return false;
101 }
102 if (response.empty() || response.find("comok") == std::string::npos) {
103#ifdef NEXTION_PROTOCOL_LOG
104 ESP_LOGN(TAG, "Bad connect: %s", response.c_str());
105 for (size_t i = 0; i < response.length(); i++) {
106 ESP_LOGN(TAG, "resp: %s %d %d %c", response.c_str(), i, response[i], response[i]);
107 }
108#endif // NEXTION_PROTOCOL_LOG
109
110 ESP_LOGW(TAG, "Not connected");
111 this->comok_sent_ = 0;
112 return false;
113 }
114
115 this->connection_state_.ignore_is_setup_ = true;
116 ESP_LOGI(TAG, "Connected");
117 this->connection_state_.is_connected_ = true;
118
119 ESP_LOGN(TAG, "connect: %s", response.c_str());
120
121 // Parse comok response fields directly
122 // Format: comok <touch>,<reserved>,<model>,<fw>,<mcu_code>,<serial>,<flash>
123 size_t field_count = 0;
124 size_t start = 0;
125 size_t end = 0;
126 auto copy_field = [&](char *dst, size_t cap) {
127 size_t len = (end == std::string::npos ? response.size() : end) - start;
128 size_t n = len < cap ? len : cap;
129 std::memcpy(dst, response.data() + start, n);
130 dst[n] = '\0';
131 };
132 while ((start = response.find_first_not_of(',', end)) != std::string::npos) {
133 end = response.find(',', start);
134 switch (field_count) {
135 case 2:
136 copy_field(this->device_model_, this->NEXTION_MODEL_MAX);
137 break;
138 case 3:
139 copy_field(this->firmware_version_, this->NEXTION_FW_MAX);
140 break;
141 case 5:
142 copy_field(this->serial_number_, this->NEXTION_SERIAL_MAX);
143 break;
144 case 6:
145 this->flash_size_ = static_cast<uint32_t>(std::strtoul(response.data() + start, nullptr, 10));
146 break;
147 default:
148 break;
149 }
150 ++field_count;
151 }
152
153 this->is_detected_ = (field_count == 7);
154 if (this->is_detected_) {
155 ESP_LOGN(TAG, "Connect info: %zu fields", field_count);
156 } else {
157 ESP_LOGE(TAG, "Bad connect value: '%s'", response.c_str());
158 }
159
160 this->connection_state_.ignore_is_setup_ = false;
161 this->dump_config();
162 return true;
163#endif // USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
164}
165
166void Nextion::reset_(bool reset_nextion) {
167 uint8_t d;
168
169 while (this->available()) { // Clear receive buffer
170 this->read_byte(&d);
171 }
172 for (auto *entry : this->nextion_queue_) {
173 if (entry->component != nullptr && entry->component->get_queue_type() == NextionQueueType::NO_RESULT) {
174 delete entry->component; // NOLINT(cppcoreguidelines-owning-memory)
175 }
176 delete entry; // NOLINT(cppcoreguidelines-owning-memory)
177 }
178 this->nextion_queue_.clear();
179#ifdef USE_NEXTION_WAVEFORM
180 for (auto *entry : this->waveform_queue_) {
181 delete entry; // NOLINT(cppcoreguidelines-owning-memory)
182 }
183 this->waveform_queue_.clear();
184#endif // USE_NEXTION_WAVEFORM
185}
186
188 ESP_LOGCONFIG(TAG, "Nextion:");
189
190#ifdef USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
191 ESP_LOGCONFIG(TAG, " Skip handshake: YES");
192#else // USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
193 if (this->is_setup()) {
194 ESP_LOGCONFIG(TAG,
195 " Device Model: %s\n"
196 " FW Version: %s\n"
197 " Serial Number: %s\n"
198 " Flash Size: %" PRIu32 " bytes",
199 this->device_model_, this->firmware_version_, this->serial_number_, this->flash_size_);
200 } else {
201 ESP_LOGCONFIG(TAG, " Device info: not yet detected");
202 }
203 ESP_LOGCONFIG(TAG,
204#ifdef USE_NEXTION_CONFIG_EXIT_REPARSE_ON_START
205 " Exit reparse: YES\n"
206#endif // USE_NEXTION_CONFIG_EXIT_REPARSE_ON_START
207 " Max queue age: %u ms\n"
208 " Startup override: %u ms\n"
209 " Wake On Touch: %s\n"
210 " Touch Timeout: %" PRIu16,
211 this->max_q_age_ms_, this->startup_override_ms_, YESNO(this->connection_state_.auto_wake_on_touch_),
212 this->touch_sleep_timeout_);
213#endif // USE_NEXTION_CONFIG_SKIP_CONNECTION_HANDSHAKE
214
215#ifdef USE_NEXTION_MAX_COMMANDS_PER_LOOP
216 ESP_LOGCONFIG(TAG, " Max commands per loop: %u", this->max_commands_per_loop_);
217#endif // USE_NEXTION_MAX_COMMANDS_PER_LOOP
218
219 if (this->wake_up_page_ != 255) {
220 ESP_LOGCONFIG(TAG, " Wake Up Page: %u", this->wake_up_page_);
221 }
222
223#ifdef USE_NEXTION_CONF_START_UP_PAGE
224 if (this->start_up_page_ != 255) {
225 ESP_LOGCONFIG(TAG, " Start Up Page: %u", this->start_up_page_);
226 }
227#endif // USE_NEXTION_CONF_START_UP_PAGE
228
229#ifdef USE_NEXTION_COMMAND_SPACING
230 ESP_LOGCONFIG(TAG, " Cmd spacing: %u ms", this->command_pacer_.get_spacing());
231#endif // USE_NEXTION_COMMAND_SPACING
232
233#ifdef USE_NEXTION_MAX_QUEUE_SIZE
234 ESP_LOGCONFIG(TAG, " Max queue size: %zu", this->max_queue_size_);
235#endif
236#ifdef USE_NEXTION_TFT_UPLOAD
237 ESP_LOGCONFIG(TAG,
238 " TFT URL: %s\n"
239 " TFT upload HTTP timeout: %" PRIu16 "ms\n"
240 " TFT upload HTTP retries: %u",
241 this->tft_url_.c_str(), this->tft_upload_http_timeout_, this->tft_upload_http_retries_);
242#ifdef USE_ESP32
243 if (this->tft_upload_watchdog_timeout_ > 0) {
244 ESP_LOGCONFIG(TAG, " TFT upload WDT timeout: %" PRIu32 "ms", this->tft_upload_watchdog_timeout_);
245 }
246#endif // USE_ESP32
247#endif // USE_NEXTION_TFT_UPLOAD
248}
249
250void Nextion::update() {
251 if (!this->is_setup()) {
252 return;
253 }
254 if (this->writer_.has_value()) {
255 (*this->writer_)(*this);
256 }
257}
258
260 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || this->is_sleeping())
261 return;
262
263 for (auto *binarysensortype : this->binarysensortype_) {
264 binarysensortype->update_component();
265 }
266 for (auto *sensortype : this->sensortype_) {
267 sensortype->update_component();
268 }
269 for (auto *switchtype : this->switchtype_) {
270 switchtype->update_component();
271 }
272 for (auto *textsensortype : this->textsensortype_) {
273 textsensortype->update_component();
274 }
275}
276
277bool Nextion::send_command(const char *command) {
278 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || this->is_sleeping())
279 return false;
280
281 this->add_no_result_to_queue_with_command_("command", command);
282 return true;
283}
284
285bool Nextion::send_command_printf(const char *format, ...) {
286 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || this->is_sleeping())
287 return false;
288
289 char buffer[256];
290 va_list arg;
291 va_start(arg, format);
292 int ret = vsnprintf(buffer, sizeof(buffer), format, arg);
293 va_end(arg);
294 if (ret <= 0) {
295 ESP_LOGW(TAG, "Bad cmd format: '%s'", format);
296 return false;
297 }
298
299 this->add_no_result_to_queue_with_command_("command_printf", buffer);
300 return true;
301}
302
303#ifdef NEXTION_PROTOCOL_LOG
305 ESP_LOGN(TAG, "print_queue_members_ (top 10) size %zu", this->nextion_queue_.size());
306 ESP_LOGN(TAG, "*******************************************");
307 int count = 0;
308 for (auto *i : this->nextion_queue_) {
309 if (count++ == 10)
310 break;
311
312 if (i == nullptr) {
313 ESP_LOGN(TAG, "Queue null");
314 } else {
315 ESP_LOGN(TAG, "Queue type: %d:%s, name: %s", i->component->get_queue_type(),
316 i->component->get_queue_type_string(), i->component->get_variable_name().c_str());
317 }
318 }
319 ESP_LOGN(TAG, "*******************************************");
320}
321#endif
322
323void Nextion::loop() {
324 if (!this->check_connect_() || this->connection_state_.is_updating_)
325 return;
326
327 if (this->connection_state_.nextion_reports_is_setup_ && !this->connection_state_.sent_setup_commands_) {
328 this->connection_state_.ignore_is_setup_ = true;
329 this->connection_state_.sent_setup_commands_ = true;
330 this->send_command_("bkcmd=3"); // Always, returns 0x00 to 0x23 result of serial command.
331
332 if (this->brightness_.has_value()) {
333 this->set_backlight_brightness(this->brightness_.value());
334 }
335
336#ifdef USE_NEXTION_CONF_START_UP_PAGE
337 // Check if a startup page has been set and send the command
338 if (this->start_up_page_ != 255) {
339 this->goto_page(this->start_up_page_);
340 }
341#endif // USE_NEXTION_CONF_START_UP_PAGE
342
343 if (this->wake_up_page_ != 255) {
344 this->set_wake_up_page(this->wake_up_page_);
345 }
346
347 if (this->touch_sleep_timeout_ != 0) {
349 }
350
351 this->set_auto_wake_on_touch(this->connection_state_.auto_wake_on_touch_);
352
353 this->connection_state_.ignore_is_setup_ = false;
354 }
355
356 this->process_serial_(); // Receive serial data
357 this->process_nextion_commands_(); // Process nextion return commands
358 this->purge_stale_queue_entries_(); // Drop expired entries even when the display sends no data
359
360 if (!this->connection_state_.nextion_reports_is_setup_) {
361 if (this->started_ms_ == 0)
363
364 if (this->startup_override_ms_ > 0 &&
365 App.get_loop_component_start_time() - this->started_ms_ > this->startup_override_ms_) {
366 ESP_LOGV(TAG, "Manual ready set");
367 this->connection_state_.nextion_reports_is_setup_ = true;
368 }
369 }
370
371#ifdef USE_NEXTION_COMMAND_SPACING
373#ifdef USE_NEXTION_WAVEFORM
374 if (!this->waveform_queue_.empty()) {
376 }
377#endif // USE_NEXTION_WAVEFORM
378#endif // USE_NEXTION_COMMAND_SPACING
379}
380
381#ifdef USE_NEXTION_COMMAND_SPACING
383#ifdef USE_NEXTION_MAX_COMMANDS_PER_LOOP
384 size_t commands_sent = 0;
385#endif // USE_NEXTION_MAX_COMMANDS_PER_LOOP
386
387 for (auto *item : this->nextion_queue_) {
388 if (item == nullptr || item->pending_command.empty()) {
389 continue; // Already sent, waiting for ACK — skip, don't stop
390 }
391
392#ifdef USE_NEXTION_MAX_COMMANDS_PER_LOOP
393 if (++commands_sent > this->max_commands_per_loop_) {
394 ESP_LOGV(TAG, "Pending cmds: loop limit reached, deferring");
395 break;
396 }
397#endif // USE_NEXTION_MAX_COMMANDS_PER_LOOP
398
400 if (!this->command_pacer_.can_send(now)) {
401 break; // Spacing not elapsed, stop for this loop iteration
402 }
403
404 if (!this->send_command_(item->pending_command)) {
405 break; // Unexpected send failure, stop
406 }
407 item->pending_command.clear();
408 ESP_LOGVV(TAG, "Pending cmd sent: %s", item->component->get_variable_name().c_str());
409 }
410}
411#endif // USE_NEXTION_COMMAND_SPACING
412
413bool Nextion::remove_from_q_(bool report_empty) {
414 if (this->nextion_queue_.empty()) {
415 if (report_empty) {
416 ESP_LOGE(TAG, "Queue empty");
417 }
418 return false;
419 }
420
421 NextionQueue *nb = this->nextion_queue_.front();
422 if (!nb || !nb->component) {
423 ESP_LOGE(TAG, "Invalid queue");
424 this->nextion_queue_.pop_front();
425 return false;
426 }
427 NextionComponentBase *component = nb->component;
428
429 ESP_LOGN(TAG, "Removed: %s", component->get_variable_name().c_str());
430
431 if (component->get_queue_type() == NextionQueueType::NO_RESULT) {
432 if (component->get_variable_name() == "sleep_wake") {
433 this->is_sleeping_ = false;
434 }
435 delete component; // NOLINT(cppcoreguidelines-owning-memory)
436 }
437 delete nb; // NOLINT(cppcoreguidelines-owning-memory)
438 this->nextion_queue_.pop_front();
439 return true;
440}
441
443 // Read all available bytes in batches to reduce UART call overhead.
444 size_t avail = this->available();
445 uint8_t buf[64];
446 while (avail > 0) {
447 size_t to_read = std::min(avail, sizeof(buf));
448 if (!this->read_array(buf, to_read)) {
449 break;
450 }
451 avail -= to_read;
452
453 this->command_data_.append(reinterpret_cast<const char *>(buf), to_read);
454 }
455}
456// nextion.tech/instruction-set/
458 if (this->command_data_.empty()) {
459 return;
460 }
461
462#ifdef USE_NEXTION_MAX_COMMANDS_PER_LOOP
463 size_t commands_processed = 0;
464#endif // USE_NEXTION_MAX_COMMANDS_PER_LOOP
465
466 size_t to_process_length = 0;
467 std::string to_process;
468
469 ESP_LOGN(TAG, "command_data_ %s len %d", this->command_data_.c_str(), this->command_data_.length());
470#ifdef NEXTION_PROTOCOL_LOG
471 this->print_queue_members_();
472#endif
473 while ((to_process_length = this->command_data_.find(reinterpret_cast<const char *>(COMMAND_DELIMITER), 0,
474 DELIMITER_SIZE)) != std::string::npos) {
475#ifdef USE_NEXTION_MAX_COMMANDS_PER_LOOP
476 if (++commands_processed > this->max_commands_per_loop_) {
477 ESP_LOGV(TAG, "Command limit reached, deferring");
478 break;
479 }
480#endif // USE_NEXTION_MAX_COMMANDS_PER_LOOP
481 ESP_LOGN(TAG, "queue size: %zu", this->nextion_queue_.size());
482 while (to_process_length + DELIMITER_SIZE < this->command_data_.length() &&
483 static_cast<uint8_t>(this->command_data_[to_process_length + DELIMITER_SIZE]) == 0xFF) {
484 ++to_process_length;
485 ESP_LOGN(TAG, "Add 0xFF");
486 }
487
488 const uint8_t nextion_event = this->command_data_[0];
489
490 to_process_length -= 1;
491 to_process = this->command_data_.substr(1, to_process_length);
492
493 switch (nextion_event) {
494 case 0x00: // instruction sent by user has failed
495 ESP_LOGW(TAG, "Invalid instruction");
496 this->remove_from_q_();
497
498 break;
499 case 0x01: // instruction sent by user was successful
500
501 ESP_LOGVV(TAG, "Cmd OK");
502 ESP_LOGN(TAG, "this->nextion_queue_.empty() %s", YESNO(this->nextion_queue_.empty()));
503
504 this->remove_from_q_();
505 if (!this->is_setup_) {
506 if (this->nextion_queue_.empty()) {
507 this->is_setup_ = true;
508 this->setup_callback_.call();
509 }
510 }
511 break;
512 case 0x02: // invalid Component ID or name was used
513 ESP_LOGW(TAG, "Invalid component ID/name");
514 this->remove_from_q_();
515 break;
516 case 0x03: // invalid Page ID or name was used
517 ESP_LOGW(TAG, "Invalid page ID");
518 this->remove_from_q_();
519 break;
520 case 0x04: // invalid Picture ID was used
521 ESP_LOGW(TAG, "Invalid picture ID");
522 this->remove_from_q_();
523 break;
524 case 0x05: // invalid Font ID was used
525 ESP_LOGW(TAG, "Invalid font ID");
526 this->remove_from_q_();
527 break;
528 case 0x06: // File operation fails
529 ESP_LOGW(TAG, "File operation failed");
530 break;
531 case 0x09: // Instructions with CRC validation fails their CRC check
532 ESP_LOGW(TAG, "CRC validation failed");
533 break;
534 case 0x11: // invalid Baud rate was used
535 ESP_LOGW(TAG, "Invalid baud rate");
536 break;
537 case 0x12: // invalid Waveform ID or Channel # was used
538#ifdef USE_NEXTION_WAVEFORM
539 if (this->waveform_queue_.empty()) {
540 ESP_LOGW(TAG, "Waveform ID/ch used but no sensor queued");
541 } else {
542 auto &nb = this->waveform_queue_.front();
543 NextionComponentBase *component = nb->component;
544 ESP_LOGW(TAG, "Invalid waveform ID %d/ch %d", component->get_component_id(),
545 component->get_wave_channel_id());
546 ESP_LOGN(TAG, "Remove waveform ID %d/ch %d", component->get_component_id(), component->get_wave_channel_id());
547 delete nb; // NOLINT(cppcoreguidelines-owning-memory)
548 this->waveform_queue_.pop();
549 }
550#else // USE_NEXTION_WAVEFORM
551 ESP_LOGW(TAG, "Waveform ID/ch error but waveform not enabled");
552#endif // USE_NEXTION_WAVEFORM
553 break;
554 case 0x1A: // variable name invalid
555 ESP_LOGW(TAG, "Invalid variable name");
556 this->remove_from_q_();
557 break;
558 case 0x1B: // variable operation invalid
559 ESP_LOGW(TAG, "Invalid variable operation");
560 this->remove_from_q_();
561 break;
562 case 0x1C: // failed to assign
563 ESP_LOGW(TAG, "Variable assign failed");
564 this->remove_from_q_();
565 break;
566 case 0x1D: // operate EEPROM failed
567 ESP_LOGW(TAG, "EEPROM operation failed");
568 break;
569 case 0x1E: // parameter quantity invalid
570 ESP_LOGW(TAG, "Invalid parameter count");
571 this->remove_from_q_();
572 break;
573 case 0x1F: // IO operation failed
574 ESP_LOGW(TAG, "Invalid component I/O");
575 break;
576 case 0x20: // undefined escape characters
577 ESP_LOGW(TAG, "Undefined escape chars");
578 this->remove_from_q_();
579 break;
580 case 0x23: // too long variable name
581 ESP_LOGW(TAG, "Variable name too long");
582 this->remove_from_q_();
583 break;
584 case 0x24: // Serial Buffer overflow occurs
585 // Buffer will continue to receive the current instruction, all previous instructions are lost.
586 ESP_LOGE(TAG, "Serial buffer overflow");
587 this->buffer_overflow_callback_.call();
588 break;
589 case 0x65: { // touch event return data
590 if (to_process_length != 3) {
591 ESP_LOGW(TAG, "Incorrect touch len: %zu (need 3)", to_process_length);
592 break;
593 }
594
595 uint8_t page_id = to_process[0];
596 uint8_t component_id = to_process[1];
597 uint8_t touch_event = to_process[2]; // 0 -> release, 1 -> press
598 ESP_LOGV(TAG, "Touch %s: page %u comp %u", touch_event ? "PRESS" : "RELEASE", page_id, component_id);
599 for (auto *touch : this->touch_) {
600 touch->process_touch(page_id, component_id, touch_event != 0);
601 }
602 this->touch_callback_.call(page_id, component_id, touch_event != 0);
603 break;
604 }
605 case 0x66: { // Nextion initiated new page event return data.
606 // Also is used for sendme command which we never explicitly initiate
607 if (to_process_length != 1) {
608 ESP_LOGW(TAG, "Page event: expect 1, got %zu", to_process_length);
609 break;
610 }
611
612 uint8_t page_id = to_process[0];
613 ESP_LOGV(TAG, "New page: %u", page_id);
614 this->page_callback_.call(page_id);
615 break;
616 }
617 case 0x67: { // Touch Coordinate (awake)
618 break;
619 }
620 case 0x68: { // touch coordinate data (sleep)
621
622 if (to_process_length != 5) {
623 ESP_LOGW(TAG, "Touch coordinate: expect 5, got %zu", to_process_length);
624 ESP_LOGW(TAG, "%s", to_process.c_str());
625 break;
626 }
627
628 const uint16_t x = (uint16_t(to_process[0]) << 8) | to_process[1];
629 const uint16_t y = (uint16_t(to_process[2]) << 8) | to_process[3];
630 const uint8_t touch_event = to_process[4]; // 0 -> release, 1 -> press
631 ESP_LOGV(TAG, "Touch %s at %u,%u", touch_event ? "PRESS" : "RELEASE", x, y);
632 break;
633 }
634
635 // 0x70 0x61 0x62 0x31 0x32 0x33 0xFF 0xFF 0xFF
636 // Returned when using get command for a string.
637 // Each byte is converted to char.
638 // data: ab123
639 case 0x70: // string variable data return
640 {
641 if (this->nextion_queue_.empty()) {
642 ESP_LOGW(TAG, "String return but queue is empty");
643 break;
644 }
645
646 NextionQueue *nb = this->nextion_queue_.front();
647 if (!nb || !nb->component) {
648 ESP_LOGE(TAG, "Invalid queue entry");
649 this->nextion_queue_.pop_front();
650 return;
651 }
652 NextionComponentBase *component = nb->component;
653
654 if (component->get_queue_type() != NextionQueueType::TEXT_SENSOR) {
655 ESP_LOGE(TAG, "String return but '%s' not text sensor", component->get_variable_name().c_str());
656 } else {
657 ESP_LOGN(TAG, "String resp: '%s' id: %s type: %s", to_process.c_str(), component->get_variable_name().c_str(),
658 component->get_queue_type_string());
659 component->set_state_from_string(to_process, true, false);
660 }
661
662 delete nb; // NOLINT(cppcoreguidelines-owning-memory)
663 this->nextion_queue_.pop_front();
664
665 break;
666 }
667 // 0x71 0x01 0x02 0x03 0x04 0xFF 0xFF 0xFF
668 // Returned when get command to return a number
669 // 4 byte 32-bit value in little endian order.
670 // (0x01+0x02*256+0x03*65536+0x04*16777216)
671 // data: 67305985
672 case 0x71: // numeric variable data return
673 {
674 if (this->nextion_queue_.empty()) {
675 ESP_LOGE(TAG, "Numeric return but queue empty");
676 break;
677 }
678
679 if (to_process_length < 4) {
680 ESP_LOGE(TAG, "Numeric return but insufficient data (need 4, got %zu)", to_process_length);
681 break;
682 }
683
684 int value = static_cast<int>(encode_uint32(to_process[3], to_process[2], to_process[1], to_process[0]));
685
686 NextionQueue *nb = this->nextion_queue_.front();
687 if (!nb || !nb->component) {
688 ESP_LOGE(TAG, "Invalid queue");
689 this->nextion_queue_.pop_front();
690 return;
691 }
692 NextionComponentBase *component = nb->component;
693
694 if (component->get_queue_type() != NextionQueueType::SENSOR &&
695 component->get_queue_type() != NextionQueueType::BINARY_SENSOR &&
696 component->get_queue_type() != NextionQueueType::SWITCH) {
697 ESP_LOGE(TAG, "Numeric return but '%s' invalid type %d", component->get_variable_name().c_str(),
698 component->get_queue_type());
699 } else {
700 ESP_LOGN(TAG, "Numeric: %s type %d:%s val %d", component->get_variable_name().c_str(),
701 component->get_queue_type(), component->get_queue_type_string(), value);
702 component->set_state_from_int(value, true, false);
703 }
704
705 delete nb; // NOLINT(cppcoreguidelines-owning-memory)
706 this->nextion_queue_.pop_front();
707
708 break;
709 }
710
711 case 0x86: { // device automatically enters into sleep mode
712 ESP_LOGVV(TAG, "Auto sleep");
713 this->is_sleeping_ = true;
714 this->sleep_callback_.call();
715 break;
716 }
717 case 0x87: // device automatically wakes up
718 {
719 ESP_LOGVV(TAG, "Auto wake");
720 this->is_sleeping_ = false;
721 this->wake_callback_.call();
722 this->all_components_send_state_(false);
723 break;
724 }
725 case 0x88: // system successful start up
726 {
727 ESP_LOGV(TAG, "System start: %zu", to_process_length);
728 this->connection_state_.nextion_reports_is_setup_ = true;
729 break;
730 }
731 case 0x89: { // start SD card upgrade
732 break;
733 }
734 // Data from nextion is
735 // 0x90 - Start
736 // variable length of 0x70 return formatted data (bytes) that contain the variable name: prints "temp1",0
737 // 00 - NULL
738 // 00/01 - Single byte for on/off
739 // FF FF FF - End
740 case 0x90: { // Switched component
741 std::string variable_name;
742
743 // Get variable name
744 auto index = to_process.find('\0');
745 if (index == std::string::npos || (to_process_length - index - 1) < 1) {
746 ESP_LOGE(TAG, "Bad switch data (0x90)");
747 ESP_LOGN(TAG, "proc: %s %zu %zu", to_process.c_str(), to_process_length, index);
748 break;
749 }
750
751 variable_name = to_process.substr(0, index);
752 ++index;
753
754 ESP_LOGN(TAG, "Switch %s: %s", ONOFF(to_process[index] != 0), variable_name.c_str());
755
756#ifdef USE_NEXTION_TRIGGER_CUSTOM_SWITCH
757 this->custom_switch_callback_.call(StringRef(variable_name), to_process[index] != 0);
758#endif // USE_NEXTION_TRIGGER_CUSTOM_SWITCH
759
760 for (auto *switchtype : this->switchtype_) {
761 switchtype->process_bool(variable_name, to_process[index] != 0);
762 }
763 break;
764 }
765 // Data from nextion is
766 // 0x91 - Start
767 // variable length of 0x70 return formatted data (bytes) that contain the variable name: prints "temp1",0
768 // 00 - NULL
769 // variable length of 0x71 return data: prints temp1.val,0
770 // FF FF FF - End
771 case 0x91: { // Sensor component
772 std::string variable_name;
773
774 auto index = to_process.find('\0');
775 if (index == std::string::npos || (to_process_length - index - 1) != 4) {
776 ESP_LOGE(TAG, "Bad sensor data (0x91)");
777 ESP_LOGN(TAG, "proc: %s %zu %zu", to_process.c_str(), to_process_length, index);
778 break;
779 }
780
781 index = to_process.find('\0');
782 variable_name = to_process.substr(0, index);
783 // // Get variable name
784 int value = static_cast<int>(
785 encode_uint32(to_process[index + 4], to_process[index + 3], to_process[index + 2], to_process[index + 1]));
786
787 ESP_LOGN(TAG, "Sensor: %s=%d", variable_name.c_str(), value);
788
789#ifdef USE_NEXTION_TRIGGER_CUSTOM_SENSOR
790 this->custom_sensor_callback_.call(StringRef(variable_name), value);
791#endif // USE_NEXTION_TRIGGER_CUSTOM_SENSOR
792
793 for (auto *sensor : this->sensortype_) {
794 sensor->process_sensor(variable_name, value);
795 }
796 break;
797 }
798
799 // Data from nextion is
800 // 0x92 - Start
801 // variable length of 0x70 return formatted data (bytes) that contain the variable name: prints "temp1",0
802 // 00 - NULL
803 // variable length of 0x70 return formatted data (bytes) that contain the text prints temp1.txt,0
804 // 00 - NULL
805 // FF FF FF - End
806 case 0x92: { // Text Sensor Component
807 std::string variable_name;
808 std::string text_value;
809
810 // Get variable name
811 auto index = to_process.find('\0');
812 if (index == std::string::npos || (to_process_length - index - 1) < 1) {
813 ESP_LOGE(TAG, "Bad text data (0x92)");
814 ESP_LOGN(TAG, "proc: %s %zu %zu", to_process.c_str(), to_process_length, index);
815 break;
816 }
817
818 variable_name = to_process.substr(0, index);
819 ++index;
820
821 // Get variable value without terminating NUL byte. Length check above ensures substr len >= 0.
822 text_value = to_process.substr(index, to_process_length - index - 1);
823
824 ESP_LOGN(TAG, "Text sensor: %s='%s'", variable_name.c_str(), text_value.c_str());
825
826 // NextionTextSensorResponseQueue *nq = new NextionTextSensorResponseQueue;
827 // nq->variable_name = variable_name;
828 // nq->state = text_value;
829 // this->textsensorq_.push_back(nq);
830
831#ifdef USE_NEXTION_TRIGGER_CUSTOM_TEXT_SENSOR
832 this->custom_text_sensor_callback_.call(StringRef(variable_name), StringRef(text_value));
833#endif // USE_NEXTION_TRIGGER_CUSTOM_TEXT_SENSOR
834
835 for (auto *textsensortype : this->textsensortype_) {
836 textsensortype->process_text(variable_name, text_value);
837 }
838 break;
839 }
840 // Data from nextion is
841 // 0x93 - Start
842 // variable length of 0x70 return formatted data (bytes) that contain the variable name: prints "temp1",0
843 // 00 - NULL
844 // 00/01 - Single byte for on/off
845 // FF FF FF - End
846 case 0x93: { // Binary Sensor component
847 std::string variable_name;
848
849 // Get variable name
850 auto index = to_process.find('\0');
851 if (index == std::string::npos || (to_process_length - index - 1) < 1) {
852 ESP_LOGE(TAG, "Bad binary data (0x93)");
853 ESP_LOGN(TAG, "proc: %s %zu %zu", to_process.c_str(), to_process_length, index);
854 break;
855 }
856
857 variable_name = to_process.substr(0, index);
858 ++index;
859
860 ESP_LOGN(TAG, "Binary sensor: %s=%s", variable_name.c_str(), ONOFF(to_process[index] != 0));
861
862#ifdef USE_NEXTION_TRIGGER_CUSTOM_BINARY_SENSOR
863 this->custom_binary_sensor_callback_.call(StringRef(variable_name), to_process[index] != 0);
864#endif // USE_NEXTION_TRIGGER_CUSTOM_BINARY_SENSOR
865
866 for (auto *binarysensortype : this->binarysensortype_) {
867 binarysensortype->process_bool(&variable_name[0], to_process[index] != 0);
868 }
869 break;
870 }
871 case 0xFD: { // data transparent transmit finished
872 ESP_LOGVV(TAG, "Data transmit done");
873#ifdef USE_NEXTION_WAVEFORM
875#endif // USE_NEXTION_WAVEFORM
876 break;
877 }
878 case 0xFE: { // data transparent transmit ready
879 ESP_LOGVV(TAG, "Ready for transmit");
880#ifdef USE_NEXTION_WAVEFORM
881 if (this->waveform_queue_.empty()) {
882 ESP_LOGE(TAG, "No waveforms queued");
883 break;
884 }
885 auto &nb = this->waveform_queue_.front();
886 auto *component = nb->component;
887 size_t buffer_to_send = component->get_wave_buffer_size() < 255 ? component->get_wave_buffer_size() : 255;
888 this->write_array(component->get_wave_buffer().data(), static_cast<int>(buffer_to_send));
889 ESP_LOGN(TAG, "Send waveform: component id %d, waveform id %d, size %zu", component->get_component_id(),
890 component->get_wave_channel_id(), buffer_to_send);
891 component->clear_wave_buffer(buffer_to_send);
892 delete nb; // NOLINT(cppcoreguidelines-owning-memory)
893 this->waveform_queue_.pop();
894#else // USE_NEXTION_WAVEFORM
895 ESP_LOGW(TAG, "Waveform transmit ready but waveform not enabled");
896#endif // USE_NEXTION_WAVEFORM
897 break;
898 }
899 default:
900 ESP_LOGW(TAG, "Unknown event: 0x%02X", nextion_event);
901 break;
902 }
903
904 this->command_data_.erase(0, to_process_length + DELIMITER_SIZE + 1);
905 }
906
907 ESP_LOGN(TAG, "Loop end");
908 this->process_serial_();
909} // Nextion::process_nextion_commands_()
910
913
914 if (this->max_q_age_ms_ > 0 && !this->nextion_queue_.empty() &&
915 ms - this->nextion_queue_.front()->queue_time > this->max_q_age_ms_) {
916 for (auto it = this->nextion_queue_.begin(); it != this->nextion_queue_.end();) {
917 if (ms - (*it)->queue_time > this->max_q_age_ms_) {
918 NextionComponentBase *component = (*it)->component;
919 ESP_LOGV(TAG, "Remove old queue '%s':'%s'", component->get_queue_type_string(),
920 component->get_variable_name().c_str());
921
922 if (component->get_queue_type() == NextionQueueType::NO_RESULT) {
923 if (component->get_variable_name() == "sleep_wake") {
924 this->is_sleeping_ = false;
925 }
926 delete component; // NOLINT(cppcoreguidelines-owning-memory)
927 }
928
929 delete *it; // NOLINT(cppcoreguidelines-owning-memory)
930 it = this->nextion_queue_.erase(it);
931
932 } else {
933 break;
934 }
935 }
936 }
937}
938
939void Nextion::set_nextion_sensor_state(int queue_type, const std::string &name, float state) {
940 this->set_nextion_sensor_state(static_cast<NextionQueueType>(queue_type), name, state);
941}
942
943void Nextion::set_nextion_sensor_state(NextionQueueType queue_type, const std::string &name, float state) {
944 ESP_LOGN(TAG, "State: %s=%lf (type %d)", name.c_str(), state, queue_type);
945
946 switch (queue_type) {
948 for (auto *sensor : this->sensortype_) {
949 if (name == sensor->get_variable_name()) {
950 sensor->set_state(state, true, true);
951 break;
952 }
953 }
954 break;
955 }
957 for (auto *sensor : this->binarysensortype_) {
958 if (name == sensor->get_variable_name()) {
959 sensor->set_state(state != 0, true, true);
960 break;
961 }
962 }
963 break;
964 }
966 for (auto *sensor : this->switchtype_) {
967 if (name == sensor->get_variable_name()) {
968 sensor->set_state(state != 0, true, true);
969 break;
970 }
971 }
972 break;
973 }
974 default: {
975 ESP_LOGW(TAG, "set_sensor_state: bad type %d", queue_type);
976 }
977 }
978}
979
980void Nextion::set_nextion_text_state(const std::string &name, const std::string &state) {
981 ESP_LOGV(TAG, "State: %s='%s'", name.c_str(), state.c_str());
982
983 for (auto *sensor : this->textsensortype_) {
984 if (name == sensor->get_variable_name()) {
985 sensor->set_state(state, true, true);
986 break;
987 }
988 }
989}
990
991void Nextion::all_components_send_state_(bool force_update) {
992 ESP_LOGV(TAG, "Send states");
993 for (auto *binarysensortype : this->binarysensortype_) {
994 if (force_update || binarysensortype->get_needs_to_send_update())
995 binarysensortype->send_state_to_nextion();
996 }
997 for (auto *sensortype : this->sensortype_) {
998#ifdef USE_NEXTION_WAVEFORM
999 if ((force_update || sensortype->get_needs_to_send_update()) && sensortype->get_wave_channel_id() == UINT8_MAX) {
1000#else // USE_NEXTION_WAVEFORM
1001 if (force_update || sensortype->get_needs_to_send_update()) {
1002#endif // USE_NEXTION_WAVEFORM
1003 sensortype->send_state_to_nextion();
1004 }
1005 }
1006 for (auto *switchtype : this->switchtype_) {
1007 if (force_update || switchtype->get_needs_to_send_update())
1008 switchtype->send_state_to_nextion();
1009 }
1010 for (auto *textsensortype : this->textsensortype_) {
1011 if (force_update || textsensortype->get_needs_to_send_update())
1012 textsensortype->send_state_to_nextion();
1013 }
1014}
1015
1016void Nextion::update_components_by_prefix(const std::string &prefix) {
1017 for (auto *binarysensortype : this->binarysensortype_) {
1018 if (binarysensortype->get_variable_name().find(prefix, 0) != std::string::npos)
1019 binarysensortype->update_component_settings(true);
1020 }
1021 for (auto *sensortype : this->sensortype_) {
1022 if (sensortype->get_variable_name().find(prefix, 0) != std::string::npos)
1023 sensortype->update_component_settings(true);
1024 }
1025 for (auto *switchtype : this->switchtype_) {
1026 if (switchtype->get_variable_name().find(prefix, 0) != std::string::npos)
1027 switchtype->update_component_settings(true);
1028 }
1029 for (auto *textsensortype : this->textsensortype_) {
1030 if (textsensortype->get_variable_name().find(prefix, 0) != std::string::npos)
1031 textsensortype->update_component_settings(true);
1032 }
1033}
1034
1035uint16_t Nextion::recv_ret_string_(std::string &response, uint32_t timeout, bool recv_flag) {
1036 uint8_t c = 0;
1037 uint8_t nr_of_ff_bytes = 0;
1038 bool exit_flag = false;
1039 bool ff_flag = false;
1040
1041 const uint32_t start = millis();
1042
1043 while ((timeout == 0 && this->available()) || millis() - start <= timeout) {
1044 if (!this->available()) {
1045 App.feed_wdt();
1046 delay(1);
1047 continue;
1048 }
1049
1050 this->read_byte(&c);
1051 if (c == 0xFF) {
1052 nr_of_ff_bytes++;
1053 } else {
1054 nr_of_ff_bytes = 0;
1055 ff_flag = false;
1056 }
1057
1058 if (nr_of_ff_bytes >= 3)
1059 ff_flag = true;
1060
1061 response += (char) c;
1062 if (recv_flag) {
1063 if (response.find(0x05) != std::string::npos) {
1064 exit_flag = true;
1065 }
1066 }
1067 App.feed_wdt();
1068 delay(2);
1069
1070 if (exit_flag || ff_flag) {
1071 break;
1072 }
1073 }
1074
1075 if (ff_flag)
1076 response = response.substr(0, response.length() - 3); // Remove last 3 0xFF
1077
1078 return response.length();
1079}
1080
1091void Nextion::add_no_result_to_queue_(const std::string &variable_name) {
1092#ifdef USE_NEXTION_MAX_QUEUE_SIZE
1093 if (this->max_queue_size_ > 0 && this->nextion_queue_.size() >= this->max_queue_size_) {
1094 ESP_LOGW(TAG, "Queue full (%zu), drop: %s", this->nextion_queue_.size(), variable_name.c_str());
1095 return;
1096 }
1097#endif
1098
1099 RAMAllocator<nextion::NextionQueue> allocator;
1100 nextion::NextionQueue *nextion_queue = allocator.allocate(1);
1101 if (nextion_queue == nullptr) {
1102 ESP_LOGW(TAG, "Queue alloc failed");
1103 return;
1104 }
1105 new (nextion_queue) nextion::NextionQueue();
1106
1107 // NOLINTNEXTLINE(cppcoreguidelines-owning-memory)
1108 nextion_queue->component = new (std::nothrow) nextion::NextionComponentBase;
1109 if (nextion_queue->component == nullptr) {
1110 ESP_LOGW(TAG, "Component alloc failed");
1111 nextion_queue->~NextionQueue();
1112 allocator.deallocate(nextion_queue, 1);
1113 return;
1114 }
1115 nextion_queue->component->set_variable_name(variable_name);
1116
1117 nextion_queue->queue_time = App.get_loop_component_start_time();
1118
1119 this->nextion_queue_.push_back(nextion_queue);
1120
1121 ESP_LOGN(TAG, "Queue NORESULT: %s", nextion_queue->component->get_variable_name().c_str());
1122}
1123
1138void Nextion::add_no_result_to_queue_with_command_(const std::string &variable_name, const std::string &command) {
1139 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || command.empty())
1140 return;
1141
1142 if (this->send_command_(command)) {
1143 this->add_no_result_to_queue_(variable_name);
1144#ifdef USE_NEXTION_COMMAND_SPACING
1145 } else {
1146 // Command blocked by spacing, add to queue WITH the command for retry
1147 this->add_no_result_to_queue_with_pending_command_(variable_name, command);
1148#endif // USE_NEXTION_COMMAND_SPACING
1149 }
1150}
1151
1152#ifdef USE_NEXTION_COMMAND_SPACING
1153void Nextion::add_no_result_to_queue_with_pending_command_(const std::string &variable_name,
1154 const std::string &command) {
1155#ifdef USE_NEXTION_MAX_QUEUE_SIZE
1156 if (this->max_queue_size_ > 0 && this->nextion_queue_.size() >= this->max_queue_size_) {
1157 ESP_LOGW(TAG, "Queue full (%zu), drop: %s", this->nextion_queue_.size(), variable_name.c_str());
1158 return;
1159 }
1160#endif
1161
1162 RAMAllocator<nextion::NextionQueue> allocator;
1163 nextion::NextionQueue *nextion_queue = allocator.allocate(1);
1164 if (nextion_queue == nullptr) {
1165 ESP_LOGW(TAG, "Queue alloc failed");
1166 return;
1167 }
1168 new (nextion_queue) nextion::NextionQueue();
1169
1170 nextion_queue->component = new (std::nothrow) nextion::NextionComponentBase;
1171 if (nextion_queue->component == nullptr) {
1172 ESP_LOGW(TAG, "Component alloc failed");
1173 nextion_queue->~NextionQueue();
1174 allocator.deallocate(nextion_queue, 1);
1175 return;
1176 }
1177 nextion_queue->component->set_variable_name(variable_name);
1178 nextion_queue->queue_time = App.get_loop_component_start_time();
1179 nextion_queue->pending_command = command; // Store command for retry
1180
1181 this->nextion_queue_.push_back(nextion_queue);
1182 ESP_LOGVV(TAG, "Queue with pending command: %s", variable_name.c_str());
1183}
1184#endif // USE_NEXTION_COMMAND_SPACING
1185
1186bool Nextion::add_no_result_to_queue_with_ignore_sleep_printf_(const std::string &variable_name, const char *format,
1187 ...) {
1188 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_))
1189 return false;
1190
1191 char buffer[256];
1192 va_list arg;
1193 va_start(arg, format);
1194 int ret = vsnprintf(buffer, sizeof(buffer), format, arg);
1195 va_end(arg);
1196 if (ret <= 0) {
1197 ESP_LOGW(TAG, "Bad cmd format: '%s'", format);
1198 return false;
1199 }
1200
1201 this->add_no_result_to_queue_with_command_(variable_name, buffer);
1202 return true;
1203}
1204
1212bool Nextion::add_no_result_to_queue_with_printf_(const std::string &variable_name, const char *format, ...) {
1213 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || this->is_sleeping())
1214 return false;
1215
1216 char buffer[256];
1217 va_list arg;
1218 va_start(arg, format);
1219 int ret = vsnprintf(buffer, sizeof(buffer), format, arg);
1220 va_end(arg);
1221 if (ret <= 0) {
1222 ESP_LOGW(TAG, "Bad cmd format: '%s'", format);
1223 return false;
1224 }
1225
1226 this->add_no_result_to_queue_with_command_(variable_name, buffer);
1227 return true;
1228}
1229
1239void Nextion::add_no_result_to_queue_with_set(NextionComponentBase *component, int32_t state_value) {
1240 this->add_no_result_to_queue_with_set(component->get_variable_name(), component->get_variable_name_to_send(),
1241 state_value);
1242}
1243
1244void Nextion::add_no_result_to_queue_with_set(const std::string &variable_name,
1245 const std::string &variable_name_to_send, int32_t state_value) {
1246 this->add_no_result_to_queue_with_set_internal_(variable_name, variable_name_to_send, state_value);
1247}
1248
1249void Nextion::add_no_result_to_queue_with_set_internal_(const std::string &variable_name,
1250 const std::string &variable_name_to_send, int32_t state_value,
1251 bool is_sleep_safe) {
1252 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || (!is_sleep_safe && this->is_sleeping()))
1253 return;
1254
1255 this->add_no_result_to_queue_with_ignore_sleep_printf_(variable_name, "%s=%" PRId32, variable_name_to_send.c_str(),
1256 state_value);
1257}
1258
1267void Nextion::add_no_result_to_queue_with_set(NextionComponentBase *component, const std::string &state_value) {
1268 this->add_no_result_to_queue_with_set(component->get_variable_name(), component->get_variable_name_to_send(),
1269 state_value);
1270}
1271void Nextion::add_no_result_to_queue_with_set(const std::string &variable_name,
1272 const std::string &variable_name_to_send,
1273 const std::string &state_value) {
1274 this->add_no_result_to_queue_with_set_internal_(variable_name, variable_name_to_send, state_value);
1275}
1276
1277void Nextion::add_no_result_to_queue_with_set_internal_(const std::string &variable_name,
1278 const std::string &variable_name_to_send,
1279 const std::string &state_value, bool is_sleep_safe) {
1280 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || (!is_sleep_safe && this->is_sleeping()))
1281 return;
1282
1283 this->add_no_result_to_queue_with_printf_(variable_name, "%s=\"%s\"", variable_name_to_send.c_str(),
1284 state_value.c_str());
1285}
1286
1296void Nextion::add_to_get_queue(NextionComponentBase *component) {
1297 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_))
1298 return;
1299
1300#ifdef USE_NEXTION_MAX_QUEUE_SIZE
1301 if (this->max_queue_size_ > 0 && this->nextion_queue_.size() >= this->max_queue_size_) {
1302 ESP_LOGW(TAG, "Queue full (%zu), drop GET: %s", this->nextion_queue_.size(),
1303 component->get_variable_name().c_str());
1304 return;
1305 }
1306#endif
1307
1308 RAMAllocator<nextion::NextionQueue> allocator;
1309 nextion::NextionQueue *nextion_queue = allocator.allocate(1);
1310 if (nextion_queue == nullptr) {
1311 ESP_LOGW(TAG, "Queue alloc failed");
1312 return;
1313 }
1314 new (nextion_queue) nextion::NextionQueue();
1315
1316 nextion_queue->component = component;
1317 nextion_queue->queue_time = App.get_loop_component_start_time();
1318
1319 ESP_LOGN(TAG, "Queue %s: %s", component->get_queue_type_string(), component->get_variable_name().c_str());
1320
1321 std::string command = "get " + component->get_variable_name_to_send();
1322
1323#ifdef USE_NEXTION_COMMAND_SPACING
1324 // Always enqueue first so the response handler is present when the command
1325 // is eventually sent. Store the command for retry if spacing blocked it;
1326 // process_pending_in_queue_() will transmit it when the pacer allows.
1327 nextion_queue->pending_command = command;
1328 this->nextion_queue_.push_back(nextion_queue);
1329 if (this->send_command_(command)) {
1330 nextion_queue->pending_command.clear();
1331 }
1332#else // USE_NEXTION_COMMAND_SPACING
1333 if (this->send_command_(command)) {
1334 this->nextion_queue_.push_back(nextion_queue);
1335 } else {
1336 delete nextion_queue; // NOLINT(cppcoreguidelines-owning-memory)
1337 }
1338#endif // USE_NEXTION_COMMAND_SPACING
1339}
1340
1341#ifdef USE_NEXTION_WAVEFORM
1347void Nextion::add_addt_command_to_queue(NextionComponentBase *component) {
1348 if ((!this->is_setup() && !this->connection_state_.ignore_is_setup_) || this->is_sleeping())
1349 return;
1350
1351 RAMAllocator<nextion::NextionQueue> allocator;
1352 nextion::NextionQueue *nextion_queue = allocator.allocate(1);
1353 if (nextion_queue == nullptr) {
1354 ESP_LOGW(TAG, "Queue alloc failed");
1355 return;
1356 }
1357 new (nextion_queue) nextion::NextionQueue();
1358
1359 nextion_queue->component = component;
1360 nextion_queue->queue_time = App.get_loop_component_start_time();
1361
1362 if (!this->waveform_queue_.push(nextion_queue)) {
1363 ESP_LOGW(TAG, "Waveform queue full, drop");
1364 delete nextion_queue; // NOLINT(cppcoreguidelines-owning-memory)
1365 return;
1366 }
1367 if (this->waveform_queue_.size() == 1)
1369}
1370
1372 if (this->waveform_queue_.empty())
1373 return;
1374
1375 auto *nb = this->waveform_queue_.front();
1376 auto *component = nb->component;
1377 size_t buffer_to_send = component->get_wave_buffer_size() < 255 ? component->get_wave_buffer_size() : 255;
1378
1379 char command[24]; // "addt " + uint8 + "," + uint8 + "," + uint8 + null = max 17 chars
1380 buf_append_printf(command, sizeof(command), 0, "addt %u,%u,%zu", component->get_component_id(),
1381 component->get_wave_channel_id(), buffer_to_send);
1382 // If spacing or setup state blocks the send, leave the entry at the front
1383 // of waveform_queue_ for retry on the next loop iteration via
1384 // check_pending_waveform_(). Only pop on a successful send.
1385 this->send_command_(command);
1386}
1387#endif // USE_NEXTION_WAVEFORM
1388
1389void Nextion::set_writer(const nextion_writer_t &writer) { this->writer_ = writer; }
1390
1391bool Nextion::is_updating() { return this->connection_state_.is_updating_; }
1392
1393} // namespace esphome::nextion
void feed_wdt()
Feed the task watchdog.
uint32_t IRAM_ATTR HOT get_loop_component_start_time() const
Get the cached time in milliseconds from when the current component started its loop execution.
uint8_t get_spacing() const
Get current command spacing.
Definition nextion.h:57
bool can_send(uint32_t now) const
Check if enough time has passed to send the next command.
Definition nextion.h:65
void mark_sent(uint32_t now)
Record the transmit timestamp for the most recently sent command.
Definition nextion.h:73
std::vector< NextionComponentBase * > touch_
Definition nextion.h:1592
std::vector< NextionComponentBase * > switchtype_
Definition nextion.h:1593
std::vector< NextionComponentBase * > binarysensortype_
Definition nextion.h:1596
StaticRingBuffer< NextionQueue *, 4 > waveform_queue_
Fixed-size ring buffer for waveform queue.
Definition nextion.h:1466
uint16_t max_q_age_ms_
Maximum age for queue items in ms.
Definition nextion.h:1640
bool send_command_(const std::string &command)
Manually send a raw command to the display and don't wait for an acknowledgement packet.
static constexpr size_t NEXTION_MODEL_MAX
Max observed ~18 chars from product numbering rules.
Definition nextion.h:1621
std::vector< NextionComponentBase * > textsensortype_
Definition nextion.h:1595
char firmware_version_[NEXTION_FW_MAX+1]
Definition nextion.h:1625
void purge_stale_queue_entries_()
Drop queue entries older than max_q_age_ms_.
CallbackManager< void(uint8_t)> page_callback_
Definition nextion.h:1600
CallbackManager< void(StringRef, int32_t)> custom_sensor_callback_
Definition nextion.h:1607
void set_wake_up_page(uint8_t wake_up_page=255)
Sets which page Nextion loads when exiting sleep mode.
void all_components_send_state_(bool force_update=false)
void set_nextion_sensor_state(int queue_type, const std::string &name, float state)
Set the nextion sensor state object.
char serial_number_[NEXTION_SERIAL_MAX+1]
Definition nextion.h:1626
void add_addt_command_to_queue(NextionComponentBase *component) override
uint32_t flash_size_
Flash size in bytes — plain integer, no string needed.
Definition nextion.h:1627
uint16_t max_commands_per_loop_
Definition nextion.h:1440
nextion_writer_t writer_
Definition nextion.h:1616
uint16_t startup_override_ms_
Timeout before forcing setup complete.
Definition nextion.h:1639
void add_to_get_queue(NextionComponentBase *component) override
bool send_command_printf(const char *format,...) __attribute__((format(printf
Manually send a raw formatted command to the display.
std::list< NextionQueue * > nextion_queue_
Definition nextion.h:1462
void set_auto_wake_on_touch(bool auto_wake_on_touch)
Sets if Nextion should auto-wake from sleep when touch press occurs.
bool remove_from_q_(bool report_empty=true)
std::vector< NextionComponentBase * > sensortype_
Definition nextion.h:1594
bool add_no_result_to_queue_with_printf_(const std::string &variable_name, const char *format,...) __attribute__((format(printf
void set_touch_sleep_timeout(uint16_t touch_sleep_timeout=0)
Set the touch sleep timeout of the display using the thsp command.
CallbackManager< void()> setup_callback_
Definition nextion.h:1597
std::string command_data_
Definition nextion.h:1636
optional< float > brightness_
Definition nextion.h:1617
CallbackManager< void()> wake_callback_
Definition nextion.h:1599
bool is_updating() override
Check if the TFT update process is currently running.
uint16_t recv_ret_string_(std::string &response, uint32_t timeout, bool recv_flag)
struct esphome::nextion::Nextion::@147 connection_state_
Status flags for Nextion display state management.
void goto_page(const char *page)
Show the page with a given name.
bool void add_no_result_to_queue_with_set_internal_(const std::string &variable_name, const std::string &variable_name_to_send, int32_t state_value, bool is_sleep_safe=false)
bool void add_no_result_to_queue_with_command_(const std::string &variable_name, const std::string &command)
CallbackManager< void(StringRef, bool)> custom_binary_sensor_callback_
Definition nextion.h:1604
bool send_command(const char *command)
Manually send a raw command to the display.
CallbackManager< void()> sleep_callback_
Definition nextion.h:1598
void reset_(bool reset_nextion=true)
void process_pending_in_queue_()
Process any commands in the queue that are pending due to command spacing.
static constexpr size_t NEXTION_FW_MAX
'S' prefix + integer (e.g. 'S99' or 123)
Definition nextion.h:1622
void add_no_result_to_queue_(const std::string &variable_name)
CallbackManager< void(uint8_t, uint8_t, bool)> touch_callback_
Definition nextion.h:1601
void dump_config() override
NextionCommandPacer command_pacer_
Definition nextion.h:1447
void set_nextion_text_state(const std::string &name, const std::string &state)
bool add_no_result_to_queue_with_ignore_sleep_printf_(const std::string &variable_name, const char *format,...) __attribute__((format(printf
void update() override
CallbackManager< void()> buffer_overflow_callback_
Definition nextion.h:1602
void set_writer(const nextion_writer_t &writer)
char device_model_[NEXTION_MODEL_MAX+1]
Definition nextion.h:1624
CallbackManager< void(StringRef, StringRef)> custom_text_sensor_callback_
Definition nextion.h:1613
void add_no_result_to_queue_with_pending_command_(const std::string &variable_name, const std::string &command)
Add a command to the Nextion queue with a pending command for retry.
void add_no_result_to_queue_with_set(NextionComponentBase *component, int32_t state_value) override
static constexpr size_t NEXTION_SERIAL_MAX
Consistently 16 hex chars across all documented examples.
Definition nextion.h:1623
CallbackManager< void(StringRef, bool)> custom_switch_callback_
Definition nextion.h:1610
void update_components_by_prefix(const std::string &prefix)
uint32_t tft_upload_watchdog_timeout_
WDT timeout in ms (0 = no adjustment)
Definition nextion.h:1559
void set_backlight_brightness(float brightness)
Set the brightness of the backlight.
optional< std::array< uint8_t, N > > read_array()
Definition uart.h:38
void write_str(const char *str)
Definition uart.h:32
bool read_byte(uint8_t *data)
Definition uart.h:34
void write_array(const uint8_t *data, size_t len)
Definition uart.h:26
const Component * component
Definition component.cpp:34
bool state
Definition fan.h:2
const char *const name
Definition lsm6ds.cpp:11
display::DisplayWriter< Nextion > nextion_writer_t
Definition nextion.h:36
const char *const TAG
Definition spi.cpp:7
const char int const __FlashStringHelper * format
Definition log.h:74
va_end(args)
const void size_t len
Definition hal.h:64
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:881
size_t size_t const char va_start(args, fmt)
void HOT delay(uint32_t ms)
Definition hal.cpp:85
uint32_t IRAM_ATTR HOT millis()
Definition hal.cpp:28
Application App
Global storage of Application pointer - only one Application can exist.
static void uint32_t
uint8_t end[39]
Definition sun_gtil2.cpp:17
uint16_t x
Definition tt21100.cpp:5
uint16_t y
Definition tt21100.cpp:6