- README / CLAUDE.md layout: dongle/, hardware/, tools/ submodule,
make_remote_hmi.py; telemetry in the protocol; the PC can take the
robot's place on the radio. CLAUDE.md: NextionUI is on Serial2 (said
Serial1); remote-without-robot via the dongle + sim.
- remote/README: MPU6050 supply row; stick calibration button names of the
new SETUP page; upload/USB-port hints.
- remote/NEXTION.md: display on Serial2, how the Editor upload goes.
- robot/README: Battery in the file list, Comms/ServoDriver roles, packet
structs instead of payload size, check the IMU gives live data (the
remote's MPU6050 needed a full reset; RobotIMU::begin() only wakes it).
- sim/README: smoke test covers telemetry and servo calibration;
OpenScadModel.
- dongle/README: AT2401C test result, app command table, SignalRGB note,
air settings incl. ack payloads.
- PLANNING.md: the display direction is in the generated HMI.
- Unity README: what the project is.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- PLANNING.md: IMU on the pin headers is done; battery firmware is done
except the % curve and the low-battery warning.
- README "Where to go next": link sim/README and dongle/README.
- remote/README intro: telemetry comes back; the sim can answer via the dongle.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- README: the HMI is generated turned round (nothing to set in the Editor);
PC radio link: bridge mode done, no USB links any more, what's left
(Unity driving the real robot, three nodes at once).
- remote/README checklist: sticks and IMU checked, display uploaded, radio
checked against the sim through the dongle; replace the IMU board.
- CLAUDE.md: display runs the new HMI; next steps.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
make_remote_hmi.py now builds the project with Editor display direction 270
(landscape, flipped) before adding pictures and fonts, so they're stored for
that direction. Checked in Nextion Editor and on the real display.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Nextion is on Serial2 (pins 7/8) - already in the last commit; docs updated.
- MPU6050 on Wire (18/19) so everything is on the edge headers (owner's
choice); the two stick wires from 18/19 move to A7/A8 (21/22).
- Stick mapping checked on the real remote: left stick X/Y/twist on
A3/A7/A8, right on A0/A1/A2, all inverted but the right twist.
- RemoteIMU: full device reset before waking. The remote's MPU6050 (likely
a clone) answers and wakes without it but every data register reads 0.
Axis defaults confirmed (+pitch nose down, +roll right side down).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
The old HMI's pages are 0 splashsceen, 1 main, 2 servocal, 3 page0,
4 uploadscreen, 5 joysticks; the link-status texts are main.t1 and
page0.t1 (not page1.t1/page3.t1, which the display silently ignored).
remote.HMI is the 2019 project re-saved by Nextion Editor 1.68, to work
on here instead of in 2019-teensy-nrf24/.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
remote_v2.scad: a new remote for the same electronics, 216 x 116 x 32 mm,
ASA, two shells printed without supports and joined with M3 heat-set
inserts. Hangs level from a neck strap on a balance-point eyelet (top face
or front edge) with a fold-out body brace; kickstand for the table.
JH-D300X-R1 sticks clamp the plate; main perfboard (Teensy 4.0, nRF24,
IMU) clamped at its sides under the display; UPS board with its LEDs
through the floor. Red honeycomb and white ON/OFF inlays in the first
3 layers. Every part checked for collisions.
- stl/remote_v2/: print-ready STLs, plus a multi-part 3MF (export_3mf.py)
with the inlays on filaments 2 and 3
- ARCHIVE.md: the original remote with the owner's photos; README shows v2
and how to print it
- Notes for later: battery-voltage reading, IMU on Wire (18/19) with two
stick axes moved to A7/A8, a stable 6 V supply for the 18 servos
- remote.scad: its sticks are JH-D300X-R1 (the model uses the D400X drawing)
- *.3mf through Git LFS; repo README says Teensy 4.0 remote
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Board teensy41 -> teensy40. All pins exist on the 4.0; the MPU6050's
Wire2 (SDA2 25 / SCL2 24) is on the underside solder pads.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The LEGACY copies of HexapodRobot, Hexapod_NEW, Hexapod_Teensy and the old remote sketch were identical to the imported repos and are removed. The old Nextion design moves to 2019-teensy-nrf24/remote-nextion/, the 2019 remote case files to 2019-teensy-nrf24/remote-case/. Paths in CLAUDE.md, READMEs, remote/ comments, sim/build.ps1, the Unity DLL message and .vscode/settings.json now point to the new places. robot/ is not touched (its CLAUDE.md asks to check with the owner first).
- LEGACY/remote/teensy/: old remote sketch from
https://mangavalk.com/Hexapod/remote.git @ 492dece (reference only).
- remote/Config.h: sticks on A0-A5, Nextion on Serial1 (0/1), as in the
old sketch; MPU6050 moved to Wire2 (25/24) since A4/A5 are Wire's pins.
- NextionUI: controls on a vscope-global "control" page added to the
old HMI; keeps the old t1 status texts; the old page-1 b2 button (and
serial 'U') enter Nextion upload passthrough, following the PC's baud.
- Docs: NEXTION.md, remote README wiring, CLAUDE.md.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Simulation
- sim/: the unchanged robot firmware compiled into hexapod_sim.dll
against PC stand-ins (Arduino, Servo, Wire + register-level MPU6050,
RF24 with matching-config radio), a kinematic body model (support
plane + planted-foot odometry) that also drives the simulated IMU,
and a headless smoke test (sim_smoke). build.ps1 builds and tests.
- Hexapod_Simulation_Unity/ folded in (history kept in a bundle
outside the repo). Assets/HexapodSim loads the DLL, drives the
existing leg rig, and offers joystick / keyboard / robot-serial
input plus a test panel.
Robot (all found or confirmed in the simulation)
- Config.h geometry taken from the Unity model.
- IK femur elevation sign, gait stance direction, body pose
rotation direction, yaw lever arm.
- Stance feet integrated from the current command; gait restarts at
mid-stance; heading integrates the applied turn rate, only while
walking.
- Leg clearance and reach checks (Limits::feetFeasible); walk command
and body pose scaled as a whole, pose scale rate-limited, planted
feet guarded so the body never snaps or legs collide.
- Robot-gyro self-leveling as an integrator.
- Heading mode: steering relative to the body; S walks backward.
- Standing height from the remote (STANCE_HEIGHT_RANGE_MM).
Protocol v3 (reflash both boards)
- CmdPacket gains body_height (22 bytes).
Remote
- Height slider (Nextion hHeight/nHeight, serial [ ]).
- Fixed unspecified I2C read order in RemoteIMU.
LEGACY/: owner's old Nextion HMI and remote hardware assets.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Not yet verified on hardware.
- shared/HexapodProtocol: CmdPacket (now 20 bytes, adds remote_roll /
remote_pitch), FLAG_* bits and radio settings as the single protocol
definition; static payload size = sizeof(CmdPacket) on both radios.
- robot: use the shared protocol; vx = forward (harness w/x <-> q/e);
InputMapper adds remote tilt on top of the right stick when
FLAG_REMOTE_GYRO is set, and robot.ino no longer zeroes stick
roll/pitch when it's off.
- remote (Teensy 4.1): Sticks (calibration, EEPROM), RemoteIMU,
RemoteState (interlocks, link-loss disarm, smoothing), PacketBuilder,
RadioLink, NextionUI, SerialConsole.
- CLAUDE.md, README.md, remote/README.md, remote/NEXTION.md.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>