hardware/openscad/ rebuilds the broken Fusion models as OpenSCAD:
body (top/bottom plate, standoffs, battery bay, switch), legs (coxa
bracket, femur link, tibia, horn adapters, TPU socks, servo cables),
the whole robot, and the remote (shell, lid, Nextion 3.5", JH-D400X-R4
sticks, 18650 UPS board, IMU, Teensy 4.0, USB-C breakout). Every part
was checked by slicing against the original STEP solids; the original's
bugs are fixed and listed in PLANNING.md.
The robot now uses a hexagon leg layout (corner legs 60 deg round from
the mid legs; the corner coxa brackets need turning on their splines).
Physical limits from a collision sweep of the model are in Config.h:
per-leg coxa limits and LEG_CLEARANCE_MM 56 (a leg is 55.2 mm wide at
the joints); the sim API exports them (version 7). sim_smoke passes.
Unity loads the model (export_unity.py -> Resources/OpenScadModel,
OpenScadModel.cs builds a new rig in place of the old scene's robot).
The PCB model's mounting holes now use the exact EasyEDA grid. README
shows renders of both.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comments in Config.h and the README referred to LEGACY/, which is folded into the generation folders. Also 'from the repo root' -> 'from the 2026-current folder'. Comment and documentation changes only; approved by the owner.
- LEGACY/Hexapod_Teensy/: old robot sketch (reference only).
- platformio.ini: robot env targets teensy36 (owner-confirmed board).
- Config.h: per-servo SERVOS table (pin, pulse at 0 deg, signed
us/deg, pulse limits) built from the old sketch's pins, ranges, trims
and the old Unity servo directions. Rear-left/front-left coxa offsets
set to 0: the owner re-horns those two servos (the old +-90 left them
at the end of travel; the sim showed them clamping).
- ServoDriver: 18 servos on hardware PWM (50 Hz, 16-bit); the Teensy 3.6
Servo library stops at 12.
- Radio on CE 39 / CSN 15 with SPI SCK on pin 14.
- sim: analogWrite/PWM shims, pulses decoded through SERVOS (API v6).
- Docs: CLAUDE.md, READMEs.
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>
Robot-side firmware (Teensy 4.0) imported unchanged as extracted.
platformio.ini defines [env:robot] (teensy40) and [env:remote]
(teensy41); scripts/select_src_dir.py points each env at its own
sketch folder so robot/ and remote/ stay Arduino-style sketches.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
mangavalkandClaude Opus 5.5