Protocol v4: CmdPacket grows to 26 bytes (cal_cmd, cal_servo, cal_value); new 30-byte Telemetry rides back on the nRF24 ack payload (robot state, IMU, battery, 18 joint angles, packets/s, servo-cal echo). Each end drops wrong-length packets, so version mismatches still fail closed. Robot (owner-approved): SERVO_CAL state while disarmed, per-servo centre trims (+-200 us) in EEPROM, telemetry, battery reading; the IMU estimate now always runs (leveling still gated by ROBOT GYRO). Remote: generated HMI (scripts/make_remote_hmi.py) with pages splash, drive, status, servos, cal, setup, upload; page-aware NextionUI that only writes the showing page and only what changed; servo calibration and UPDATE DISPLAY on the touchscreen and serial console; battery module. The display is on Serial2 (pins 7/8), found on the real remote; the old sketch's Serial1 was never connected to it. Sim: RF24 shim supports ack payloads, API version 8 (hxsim_get_ack_payload); sim_smoke checks telemetry and every CAL command. Unity CmdPacket mirror updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
68 lines
2.5 KiB
C++
68 lines
2.5 KiB
C++
#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);
|
|
};
|