2026 remote: tabbed Nextion UI, robot telemetry, servo centre calibration
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>
This commit is contained in:
1 parent
481610c9fd
commit
0b836af8de
40 files changed
+1463
-281
No files matched your search
@@ -116,9 +116,27 @@ ignore walk commands.
|
||||
## Link with the remote
|
||||
|
||||
- `CmdPacket` and the `FLAG_*` bits in `shared/HexapodProtocol` are the
|
||||
exact wire format. Both radios set a static payload size of
|
||||
exact wire format. `Comms` drops any packet whose length isn't
|
||||
`sizeof(CmdPacket)`, so a robot and remote built from different protocol
|
||||
versions won't receive each other at all (and the robot fails safe).
|
||||
- **Telemetry back to the remote:** after every packet received, `Comms`
|
||||
loads a fresh `Telemetry` (robot state, IMU roll/pitch, battery, the 18
|
||||
commanded joint angles, packets per second, servo-cal echo) as the radio's
|
||||
ack payload. It goes back on the auto-ack of the remote's next packet:
|
||||
no extra transmissions. `sendTelemetry()` in `robot.ino` fills it every
|
||||
loop. The IMU attitude is now estimated whether or not robot gyro is on
|
||||
(the remote shows it); only the leveling is gated by `FLAG_ROBOT_GYRO`.
|
||||
- **Servo centre calibration** (remote's CAL page): while disarmed, a
|
||||
`cal_cmd` other than `CAL_NONE` puts the robot in SERVO_CAL. Every servo
|
||||
is driven to the centre pose (coxa 0, femur 0, tibia −90: legs straight
|
||||
out, shins straight down) and `CAL_SET` adjusts one servo's centre trim
|
||||
(µs, ±200, on top of `Config.h` `SERVOS`; it shifts the whole pulse range
|
||||
like the old `servoCallibration[]`). `CAL_SAVE` stores the 18 trims in
|
||||
EEPROM (`ServoDriver`, address 0, loaded at power-on), `CAL_REVERT`
|
||||
reloads them. `CAL_NONE`, arming or link loss relaxes the servos again.
|
||||
Put the robot on a stand first.
|
||||
- **Battery:** `Battery` reads `BATTERY_SENSE_PIN` through a divider
|
||||
(`Config.h`). Not wired yet (pin 255): the remote shows "--".
|
||||
- Failsafe: if no packet arrives for `LINK_TIMEOUT_SEC`, `Comms::linkOk()`
|
||||
goes false and the main loop falls back to a zeroed `CmdPacket`, which
|
||||
disarms the robot.
|
||||
|
||||
Reference in new issue
Block a user