Files
hexapod-robot/2026-current
mangavalkandClaude Opus 5.5 60605209fb 2026: remote v2 (flat console for the twist-grip sticks), STL/3MF exports, archive page
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>
2026-11-14 18:57:49 +01:00
..

Hexapod

A six-legged walking robot (Teensy 3.6) and its handheld remote (Teensy 4.0 + Nextion touchscreen), linked over nRF24L01.

The hexapod, OpenSCAD model in its standing pose The remote (v2), OpenSCAD model: black ASA with a red honeycomb and white ON/OFF inlay

The remote above is the new design (hardware/openscad/remote_v2.scad, not printed yet). The original printed remote is on the archive page.

robot/                     robot firmware: IK, gait, body pose, IMU stabilization, state machine
remote/                    remote firmware: 2 x 3-axis sticks, MPU6050 tilt, Nextion UI, RF24 TX
shared/                    HexapodProtocol: the CmdPacket wire format + radio settings used by both
sim/                       the unchanged robot firmware compiled into a DLL for the simulation
Hexapod_Simulation_Unity/  Unity project that runs that DLL on the 3D model
hardware/openscad/         OpenSCAD model of the robot (rebuilt from the Fusion designs) and the new remote
hardware/openscad/stl/     print-ready STL exports
hardware/fusion360/        Fusion 360 designs: body, legs, servo, servo horn, remote case
scripts/                   PlatformIO helper (per-environment sketch folder)

This is the 2026-current/ folder of the hexapod-robot repo; the earlier generations (2009 onwards) are in the folders next to it, see ../README.md.

Build (PlatformIO)

pio run                    # build both
pio run -e robot -t upload
pio run -e remote -t upload
pio device monitor -e robot

Simulation

From this 2026-current folder in PowerShell (the dev PC is Windows):

.\sim\build.ps1            # build hexapod_sim.dll + run the headless firmware checks

Then open Hexapod_Simulation_Unity and press Play. See sim/README.md.

Printing the remote (v2)

STLs in hardware/openscad/stl/remote_v2/, already in print orientation; everything prints in ASA without supports. Regenerate them from remote_v2.scad with -D 'PART="..."'.

File Part Notes
remote_v2_top_multicolor.3mf top shell with both inlays One object with three parts on filaments 1/2/3: case black, honeycomb red, ON/OFF white. The inlays are the first 3 layers (0.6 mm) of the face-down shell, so the colour swaps only happen there. Made by hardware/openscad/export_3mf.py from the three STLs below
remote_v2_top.stl + _inlay.stl + _text.stl the same, as STLs Load the three at once and keep them as one multi-part object
remote_v2_bottom.stl bottom shell flat underside on the bed
remote_v2_kickstand.stl table stand
remote_v2_eyelet.stl neck-strap eyelet on the top face (slots to balance it) or on the front edge
remote_v2_bail.stl body brace swings down and back to rest against your body

Hardware (besides the electronics of the old remote):

  • 14 x M3 heat-set inserts (4.0 mm hole, ~5.7 mm long): 4 shell screws, 2 + 2 eyelet (top and front), 2 brace pivots, 4 main-board clamps
  • M3 x 12 x 4 (shells), M3 x 8 button head x 2 (eyelet), M3 x 16 button head + washer x 2 (brace), M3 x 8 button head + 7 mm washer x 4 (main board clamps, no holes in the board), M3 x 40 + nut (kickstand pin)
  • M2.5 x 14 x 8 (joysticks, into their own boxes), M2.5 self-tapping x 4 (display), M3 self-tapping x 2 (UPS board), M2 self-tapping x 2 (switch)
  • Set the Nextion's display direction to 180 in the Nextion Editor: the display is mounted turned round so its connector clears the Teensy's USB plug.

Design notes, checks and open points: hardware/openscad/PLANNING.md.

Where to go next