Files
hexapod-robot/2026-current/remote/NextionUI.h
T

67 lines
2.5 KiB
C++
Raw Normal View History

#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:
// '#' <len> <cmd> [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);
};