#pragma once #include "UiTypes.h" #include "Config.h" // Nextion serial HMI driver. No Nextion library - the protocol is small: // // Nextion -> remote: custom frames the HMI's touch events send with printh: // '#' [value] e.g. printh 23 01 41 (ToggleArm) // printh 23 02 56 + prints hSpeed.val,1 // Command bytes are listed in NEXTION.md and in NextionUI.cpp. Every // page's Preinitialize event sends 'P' + its page id, so the remote always // knows which page is showing. Native Nextion return frames (terminated // FF FF FF) are parsed too: a display reset (0x88 "ready") triggers a // full redraw, and the reply to `sendme` (0x66 page) gives the page after // the remote itself restarted. // // remote -> Nextion: plain instructions ("bArm.txt=\"ARMED\"" + FF FF FF). // // Only the page that is showing is written (by local component names), and // only what changed: every instruction is hashed into a per-page cache. The // remote is authoritative: buttons are plain buttons, they only send // requests, and render() repaints whatever the remote state actually is. A // Nextion reboot or a dropped byte self-heals on the next periodic full // refresh. class NextionUI { public: void begin(); bool poll(UiEvent& out); // call every loop; returns one decoded event at a time void render(const UiView& v, uint32_t now_ms); // Nextion Editor upload through the remote's USB port. Never returns. [[noreturn]] void runUploadPassthrough(); private: enum class Rx : uint8_t { Idle, CustomLen, CustomBody, Native }; Rx rx_ = Rx::Idle; uint8_t body_[4]; uint8_t body_len_ = 0, body_got_ = 0; uint8_t native_buf_[8]; uint8_t native_len_ = 0, ff_run_ = 0; uint8_t page_ = PAGE_UNKNOWN; bool force_full_ = true; uint32_t last_full_ms_ = 0; uint32_t last_render_ms_ = 0; // Change cache: one hash per instruction, in the order a page's render // issues them (the same every time). static constexpr int MAX_SLOTS = 96; uint32_t cache_[MAX_SLOTS] = {}; uint8_t slot_ = 0; bool full_ = false; void cmd(const char* fmt, ...); void put(const char* fmt, ...); // like cmd(), but only if it changed void setPage(uint8_t page); void renderTopBar(const UiView& v); void renderDrive(const UiView& v); void renderStatus(const UiView& v); void renderServos(const UiView& v); void renderCal(const UiView& v); void renderSetup(const UiView& v); bool decodeCustom(UiEvent& out); bool decodeNative(UiEvent& out); };