3 Commits
Author SHA1 Message Date
mangavalkandClaude Opus 5.5 179afdb705 2026 docs: review of every README against today's state
- 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>
2026-11-17 22:56:14 +01:00
mangavalkandClaude Opus 5.5 a59faf3b03 2026 docs: update the planned/future notes
- 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>
2026-11-17 22:54:10 +01:00
mangavalkandClaude Opus 5.5 175a1a0da8 2026 docs: catch the READMEs up with today's state
- 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>
2026-11-17 22:52:44 +01:00
9 changed files with 149 additions and 83 deletions

No files matched your search

+14 -8
View File
@@ -14,7 +14,10 @@ remote/ Teensy 4.0 firmware (PlatformIO env remote)
shared/HexapodProtocol/ wire protocol, used by robot, remote and sim shared/HexapodProtocol/ wire protocol, used by robot, remote and sim
sim/ robot firmware -> hexapod_sim.dll (CMake + g++), headless smoke test sim/ robot firmware -> hexapod_sim.dll (CMake + g++), headless smoke test
Hexapod_Simulation_Unity/ Unity 6000.6 project that loads the DLL (Assets/HexapodSim/) Hexapod_Simulation_Unity/ Unity 6000.6 project that loads the DLL (Assets/HexapodSim/)
scripts/ PlatformIO helper dongle/ USB nRF24 stick firmware (STM32F030): the PC's radio, bridge mode for Unity
hardware/ OpenSCAD rebuild + new remote case, Fusion 360 designs, PCB notes
scripts/ PlatformIO helper, make_remote_hmi.py (generates remote/remote.HMI)
tools/nextion-hmi-tools/ git submodule: nxhmi (.HMI read/write/render, MCP server)
``` ```
This folder is `2026-current/` inside the `hexapod-robot` repo. The older generations sit next to it This folder is `2026-current/` inside the `hexapod-robot` repo. The older generations sit next to it
@@ -145,7 +148,7 @@ link-loss disarm, servo-trim read-back from telemetry) → PacketBuilder →
| `PacketBuilder` | the inverse of InputMapper: stick frame → body frame per the contract, per-submode right-stick mapping, `FLAG_WALK` with 250 ms linger (twist ignored in mode B), tilt deadzone/scale × fade, zeros motion when disarmed | | `PacketBuilder` | the inverse of InputMapper: stick frame → body frame per the contract, per-submode right-stick mapping, `FLAG_WALK` with 250 ms linger (twist ignored in mode B), tilt deadzone/scale × fade, zeros motion when disarmed |
| `RadioLink` | nRF24 TX, short retries (1, 3), ack-based link status and 32-packet quality %, telemetry from the ack payloads (stale after `TELEMETRY_STALE_MS`) | | `RadioLink` | nRF24 TX, short retries (1, 3), ack-based link status and 32-packet quality %, telemetry from the ack payloads (stale after `TELEMETRY_STALE_MS`) |
| `Battery` | handset battery through a divider; `BATTERY_SENSE_PIN` 255 = not wired yet (planned A6) | | `Battery` | handset battery through a divider; `BATTERY_SENSE_PIN` 255 = not wired yet (planned A6) |
| `NextionUI` | library-free Nextion driver on `Serial1`. HMI sends `'#' len cmd [val]` frames via `printh`; every page's Preinitialize sends `'P'` + page id (and `sendme` / 0x66 recovers the page after a remote restart). The remote writes **only the showing page**, by local component name, and only what changed (FNV hash per instruction in a per-page slot cache), 20 Hz (SERVOS 10 Hz), never blocking on a full TX buffer; full refresh every 2 s and on the 0x88 "ready" frame. UPDATE DISPLAY (tapped twice) or serial `U` runs `runUploadPassthrough()`: USB ↔ display bridge for Nextion Editor, following `Serial.baud()`, never returns | | `NextionUI` | library-free Nextion driver on `Serial2` (pins 7/8). HMI sends `'#' len cmd [val]` frames via `printh`; every page's Preinitialize sends `'P'` + page id (and `sendme` / 0x66 recovers the page after a remote restart). The remote writes **only the showing page**, by local component name, and only what changed (FNV hash per instruction in a per-page slot cache), 20 Hz (SERVOS 10 Hz), never blocking on a full TX buffer; full refresh every 2 s and on the 0x88 "ready" frame. UPDATE DISPLAY (tapped twice) or serial `U` runs `runUploadPassthrough()`: USB ↔ display bridge for Nextion Editor, following `Serial.baud()`, never returns |
| `SerialConsole` | USB keystrokes that mirror every UI command plus diagnostics | | `SerialConsole` | USB keystrokes that mirror every UI command plus diagnostics |
| `SmoothedValue.h` | copy of the robot's (kept separate so robot/ stays untouched) | | `SmoothedValue.h` | copy of the robot's (kept separate so robot/ stays untouched) |
| `NEXTION.md` | the HMI: pages, command bytes, which components the firmware writes | | `NEXTION.md` | the HMI: pages, command bytes, which components the firmware writes |
@@ -236,6 +239,9 @@ Remote stick-frame convention: logical X + = right, Y + = forward, twist +
- **Robot firmware in simulation:** `sim/build/sim_smoke.exe` (headless, - **Robot firmware in simulation:** `sim/build/sim_smoke.exe` (headless,
scripted checks), or Unity Play mode with Keyboard input or the real scripted checks), or Unity Play mode with Keyboard input or the real
remote over the radio (USB nRF24 dongle). remote over the radio (USB nRF24 dongle).
- **Remote without robot:** the Unity sim behind the USB nRF24 dongle
answers like the robot (telemetry, servo calibration), see
`sim/README.md`.
- **Remote without robot or display:** the USB serial console (see - **Remote without robot or display:** the USB serial console (see
`remote/README.md`). `p` shows raw/mapped sticks, IMU, link and state. `remote/README.md`). `p` shows raw/mapped sticks, IMU, link and state.
`d` dumps packets at 10 Hz. With no robot, the link shows DOWN and `d` dumps packets at 10 Hz. With no robot, the link shows DOWN and
@@ -409,9 +415,8 @@ Remote (`remote/README.md` has detail):
- The Nextion must have `bauds=115200` in Program.s, and the HMI must match - The Nextion must have `bauds=115200` in Program.s, and the HMI must match
`NEXTION.md`. The working HMI is `remote/remote.HMI`, generated by `NEXTION.md`. The working HMI is `remote/remote.HMI`, generated by
`scripts/make_remote_hmi.py` (owner-approved design, 2026-11-17; the old 6-page one in `scripts/make_remote_hmi.py` (owner-approved design, 2026-11-17; the old 6-page one in
`../2019-teensy-nrf24/remote-nextion/` only lends its splash picture). The display still `../2019-teensy-nrf24/remote-nextion/` only lends its splash picture). It's on the real
runs the old HMI until the new `.tft` is uploaded: use serial key `U` for that first upload, display (turned 180°, see `remote/NEXTION.md`). Edit and render it with the `nxhmi` MCP server
the old UPLOAD button isn't recognised any more. Edit and render it with the `nxhmi` MCP server
(registered in the repo root `.mcp.json`; code is the git submodule `tools/nextion-hmi-tools`, (registered in the repo root `.mcp.json`; code is the git submodule `tools/nextion-hmi-tools`,
run `git submodule update --init` after cloning; CLI `python -m nxhmi` with `PYTHONPATH` = run `git submodule update --init` after cloning; CLI `python -m nxhmi` with `PYTHONPATH` =
`tools/nextion-hmi-tools/src`): `info`, `get_page`, `render_page`, `set_attributes`, `tools/nextion-hmi-tools/src`): `info`, `get_page`, `render_page`, `set_attributes`,
@@ -468,6 +473,7 @@ Remote (`remote/README.md` has detail):
rate limiting on any setpoint that can jump, and paired `.h/.cpp` per rate limiting on any setpoint that can jump, and paired `.h/.cpp` per
concern. concern.
- Planned or possible next steps: wire the battery dividers (firmware is - Planned or possible next steps: wire the battery dividers (firmware is
ready on both sides, pins still 255) and add a low-battery warning; try ready on both sides, pins still 255) and add a low-battery warning;
ack-payload telemetry and servo calibration on the real radios (only flash the robot with protocol v4 and try telemetry and servo calibration
simulated so far). with it (the real remote ↔ dongle ↔ Unity sim path already works over the
air, 2026-11-17); Unity driving the real robot through the dongle.
@@ -1 +1,5 @@
Hexapod Hexapod
The Unity side of the firmware simulation: it runs the unchanged robot firmware
(`../sim/build/hexapod_sim.dll`) on the 3D model, driven by the keyboard or by the
real remote over the radio (USB nRF24 dongle). See `../sim/README.md`.
+38 -32
View File
@@ -1,7 +1,9 @@
# Hexapod # Hexapod
A six-legged walking robot (Teensy 3.6) and its handheld remote A six-legged walking robot (Teensy 3.6) and its handheld remote
(Teensy 4.0 + Nextion touchscreen), linked over nRF24L01. (Teensy 4.0 + Nextion touchscreen), linked over nRF24L01: commands from the
remote, telemetry back from the robot. A USB nRF24 stick lets the PC (the
Unity simulation) take the robot's place on the radio.
![The hexapod, OpenSCAD model in its standing pose](hardware/openscad/renders/hexapod.png) ![The hexapod, OpenSCAD model in its standing pose](hardware/openscad/renders/hexapod.png)
![The remote (v2), OpenSCAD model: black ASA with a red honeycomb and white ON/OFF inlay](hardware/openscad/renders/remote_v2.png) ![The remote (v2), OpenSCAD model: black ASA with a red honeycomb and white ON/OFF inlay](hardware/openscad/renders/remote_v2.png)
@@ -11,16 +13,19 @@ printed yet). The original printed remote is on the
[archive page](hardware/openscad/ARCHIVE.md). [archive page](hardware/openscad/ARCHIVE.md).
``` ```
robot/ robot firmware: IK, gait, body pose, IMU stabilization, state machine 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 servo centre calibration, telemetry
shared/ HexapodProtocol: the CmdPacket wire format + radio settings used by both remote/ remote firmware: 2 x 3-axis sticks, MPU6050 tilt, Nextion UI, RF24 link
(+ remote.HMI, the touchscreen project)
shared/ HexapodProtocol: CmdPacket + Telemetry wire formats + radio settings
sim/ the unchanged robot firmware compiled into a DLL for the simulation 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 Hexapod_Simulation_Unity/ Unity project that runs that DLL on the 3D model
dongle/ USB nRF24 stick firmware (STM32F030): the PC-side radio, see dongle/README.md dongle/ USB nRF24 stick firmware (STM32F030): the PC-side radio, see dongle/README.md
hardware/openscad/ OpenSCAD model of the robot (rebuilt from the Fusion designs) and the new remote hardware/openscad/ OpenSCAD model of the robot (rebuilt from the Fusion designs) and the new remote
hardware/openscad/stl/ print-ready STL exports hardware/openscad/stl/ print-ready STL exports
hardware/fusion360/ Fusion 360 designs: body, legs, servo, servo horn, remote case hardware/fusion360/ Fusion 360 designs: body, legs, servo, servo horn, remote case
scripts/ PlatformIO helper (per-environment sketch folder) scripts/ PlatformIO helper (per-environment sketch folder), make_remote_hmi.py
tools/nextion-hmi-tools/ git submodule: .HMI reader/writer/renderer (nxhmi), used by the HMI generator
``` ```
This is the `2026-current/` folder of the hexapod-robot repo; the earlier This is the `2026-current/` folder of the hexapod-robot repo; the earlier
@@ -72,36 +77,33 @@ Hardware (besides the electronics of the old remote):
board clamps, no holes in the board), M3 x 40 + nut (kickstand pin) board clamps, no holes in the board), M3 x 40 + nut (kickstand pin)
- M2.5 x 14 x 8 (joysticks, into their own boxes), M3 x 5 machine screws x 4 - M2.5 x 14 x 8 (joysticks, into their own boxes), M3 x 5 machine screws x 4
(display, tap the posts M3), M3 self-tapping x 2 (UPS board), M2 self-tapping x 2 (switch) (display, tap the posts M3), 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 - The display is mounted turned round so its connector clears the Teensy's USB
display is mounted turned round so its connector clears the Teensy's USB plug. plug. `remote.HMI` is generated for that (display direction 270 in the
Editor's terms, see [remote/NEXTION.md](remote/NEXTION.md)), nothing to set.
Design notes, checks and open points: [hardware/openscad/PLANNING.md](hardware/openscad/PLANNING.md). Design notes, checks and open points: [hardware/openscad/PLANNING.md](hardware/openscad/PLANNING.md).
## Planned ## Planned
- **PC radio link (owner, later):** a USB nRF24L01 stick on the PC as the - **PC radio link:** a USB nRF24L01 stick on the PC as the PC-side radio, on
PC-side radio, on the same air settings as the robot and the remote, so Unity the same air settings as the robot and the remote. It's reverse-engineered
on the PC can both receive data from (telemetry) and send data to the robot and runs our own firmware (STM32F030 + Si24R1 + AT2401C, updated wire-free
and the remote. The stick is now reverse-engineered and reflashed with our own over USB), see **[dongle/README.md](dongle/README.md)**. Done (2026-11-17):
firmware (STM32F030 + Si24R1 + AT2401C); it shows up as a COM port and is its **bridge mode** lets the real remote drive the Unity simulation over the
updated wire-free over USB. See **[dongle/README.md](dongle/README.md)**. Still air, with the sim's telemetry going back to the remote's display as the ack
to do: payload ([sim/README.md](sim/README.md), "Using it in Unity"). There's no USB
- map the stick's LED and AT2401C power-amp control pins (app toggles them); link to the remote or the robot any more; everything goes over the radio.
- the radio protocol: today the remote only transmits a `CmdPacket` to the Still to do:
robot and nothing comes back. Three nodes need an address per node (or - Unity driving the **real** robot (the dongle transmitting instead of
per pipe), a packet type byte, and telemetry back (e.g. as ack payloads listening) and mirroring it;
or in time slots) so the nodes don't talk over each other; who has - three nodes at once: today the dongle answers the remote *instead of* the
priority when the PC and the remote both send commands. Owner's robot. Needs an address per node (or per pipe), a packet type byte, and a
decisions: the remote wins, with a toggle on the remote that hands the rule for who has priority. Owner's decisions: the remote wins, with a
robot to Unity and lets the remote's sticks control Unity instead; the toggle on the remote that hands the robot to Unity and lets the remote's
PC is the hub while it's online, the robot is the hub when it isn't; sticks control Unity instead; the PC is the hub while it's online, the
goals: mirror the real robot in Unity, drive it from Unity, remote data robot is the hub when it isn't; goals: mirror the real robot in Unity,
to the PC, and PC data to the remote; drive it from Unity, remote data to the PC, and PC data to the remote.
- Unity side: a serial-port reader/writer next to the simulation (the - Remote battery level: see [remote/README.md](remote/README.md), "Planned".
2019 generation already drove the robot from Unity, through the remote
over USB: see `../2019-teensy-nrf24/`).
- Remote battery level and the IMU on the normal pin headers: see
[remote/README.md](remote/README.md), "Planned".
- Robot power: a stable 6 V supply for the 18 servos, see - Robot power: a stable 6 V supply for the 18 servos, see
[hardware/openscad/PLANNING.md](hardware/openscad/PLANNING.md), "Notes for [hardware/openscad/PLANNING.md](hardware/openscad/PLANNING.md), "Notes for
future designs". future designs".
@@ -113,7 +115,11 @@ Design notes, checks and open points: [hardware/openscad/PLANNING.md](hardware/o
robot without a remote. robot without a remote.
- **[remote/README.md](remote/README.md)**: wiring, control scheme, stick - **[remote/README.md](remote/README.md)**: wiring, control scheme, stick
calibration, and the remote's serial console. calibration, and the remote's serial console.
- **[remote/NEXTION.md](remote/NEXTION.md)**: how to build the touchscreen - **[remote/NEXTION.md](remote/NEXTION.md)**: the touchscreen HMI (generated
HMI. by `scripts/make_remote_hmi.py`).
- **[sim/README.md](sim/README.md)**: the robot firmware in simulation, headless
and in Unity, with the keyboard or the real remote over the radio.
- **[dongle/README.md](dongle/README.md)**: the USB nRF24 stick, its firmware,
flashing and the bridge protocol.
- **[shared/HexapodProtocol/HexapodProtocol.h](shared/HexapodProtocol/HexapodProtocol.h)**: - **[shared/HexapodProtocol/HexapodProtocol.h](shared/HexapodProtocol/HexapodProtocol.h)**:
the protocol. Change it only by reflashing both boards. the protocol. Change it only by reflashing both boards.
+27 -10
View File
@@ -30,15 +30,31 @@ Found by probing the board over SWD and confirmed at runtime by our firmware:
| SPI1 SCK / MISO / MOSI | PA5 / PA6 / PA7 → Si24R1 | | SPI1 SCK / MISO / MOSI | PA5 / PA6 / PA7 → Si24R1 |
| nRF CSN / CE / IRQ | PA3 / PA4 / PA2 | | nRF CSN / CE / IRQ | PA3 / PA4 / PA2 |
| status LED (active-high) | **PA0** — confirmed by eye | | status LED (active-high) | **PA0** — confirmed by eye |
| AT2401C TX/RX enable + unused | PA1, PB1, PF0, PF1 — **not yet distinguished** | | AT2401C TX/RX enable + unused | PA1, PB1, PF0, PF1 — **not distinguishable** (see below) |
PA0 drives the LED (HIGH = on). The AT2401C control lines are among PA1, PB1, PA0 drives the LED (HIGH = on). The AT2401C control lines would be among PA1,
PF0, PF1 (the TSSOP-20 has no other GPIO). Listening for ambient 2.4 GHz with PB1, PF0, PF1 (the TSSOP-20 has no other GPIO). Listening for ambient 2.4 GHz
the radio's carrier-detect bit was too noisy to tell them apart, so they need a with the radio's carrier-detect bit was too noisy to tell them apart. The real
real link test (dongle ↔ robot/remote, trying each pin while watching whether link test (2026-11-17: receiving the remote while switching all 16 on/off
packets get through). The radio still works without driving the amplifier, just combinations, at the desk and a few rooms away with the remote at minimum
at reduced range. The app firmware can drive any pin (`0`-`4`), sweep them all power) got every packet in every combination, so either the link has plenty of
(`a`), and run a carrier-detect finder (`f`/`n`). margin or the amplifier is switched in hardware. The firmware leaves them low;
the link works.
### App commands (USB serial, 115200, single keys, when not bridging)
| Key | Action |
|-----|--------|
| `v` | banner: version and a few radio registers |
| `r` | dump nRF registers |
| `x` | RX test on the hexapod's air settings; prints packets/s once a second |
| `0`-`4` | toggle PA0 (LED) / PA1 / PB1 / PF0 / PF1 |
| `a` | sweep every free pin high for 3 s each |
| `f` / `n` | carrier-detect finder on / next channel |
| `b` | reset into safeboot (what `safeboot_flash.py` uses) |
**SignalRGB** (if installed) opens every CH340 COM port it sees and holds it;
quit it while using the dongle.
### Programming header (5 holes next to the CH330N) ### Programming header (5 holes next to the CH330N)
@@ -162,14 +178,15 @@ safeboot's 1.5 s cold-boot window.
## Air settings ## Air settings
Matches `shared/HexapodProtocol/HexapodProtocol.h`: 2.4 GHz channel 96 Matches `shared/HexapodProtocol/HexapodProtocol.h`: 2.4 GHz channel 96
(2.496 GHz), 250 kbps, 5-byte address `HXPD1`, 16-bit CRC. The app sets these on (2.496 GHz), 250 kbps, 5-byte address `HXPD1`, 16-bit CRC, auto-ack with
dynamic payload lengths and ack payloads (protocol v4). The app sets these on
the Si24R1 over SPI (same register layout as the nRF24L01+). the Si24R1 over SPI (same register layout as the nRF24L01+).
## Status / next ## Status / next
- [x] identify the hardware, map the radio + serial pins - [x] identify the hardware, map the radio + serial pins
- [x] permanent two-stage firmware, wire-free USB flashing - [x] permanent two-stage firmware, wire-free USB flashing
- [ ] identify the LED and AT2401C TX/RX-enable pins (app toggles the 5 free pins) - [x] LED pin (PA0)
- [x] bridge mode: the dongle stands in for the robot's radio, Unity runs the - [x] bridge mode: the dongle stands in for the robot's radio, Unity runs the
robot firmware (sim) behind it — see "Bridge mode" below robot firmware (sim) behind it — see "Bridge mode" below
- [ ] the other direction: Unity as the remote, driving the real robot - [ ] the other direction: Unity as the remote, driving the real robot
+9 -6
View File
@@ -159,7 +159,8 @@ charge/on LEDs show through two slots in the floor.
plate into the box (no nuts). Reaches 28.5 mm down. Pots (d16.5, 9.2 out) plate into the box (no nuts). Reaches 28.5 mm down. Pots (d16.5, 9.2 out)
towards the middle and towards the user. towards the middle and towards the user.
- Display mounted turned 180 deg so its J1 connector is on the right, clear - Display mounted turned 180 deg so its J1 connector is on the right, clear
of the Teensy's USB plug: set display direction 180 in the Nextion Editor. of the Teensy's USB plug. `remote/remote.HMI` is generated for that
(direction 270 in the Nextion Editor's terms; done 2026-11-17).
Glass 1.0 mm under the top face, board on 4 posts tapped M3 (3.66 mm of thread, 1.2 mm under the top face); Glass 1.0 mm under the top face, board on 4 posts tapped M3 (3.66 mm of thread, 1.2 mm under the top face);
LCD 85.7 x 55 x 3.86 plus a 1.3 mm flex cable on one side, 11.21 mm glass to LCD 85.7 x 55 x 3.86 plus a 1.3 mm flex cable on one side, 11.21 mm glass to
back of J1 (owner measured). back of J1 (owner measured).
@@ -213,15 +214,17 @@ charge/on LEDs show through two slots in the floor.
for the stall current. The battery must also fit the bay (see open for the stall current. The battery must also fit the bay (see open
question 3) and leave room for the servo plugs. question 3) and leave room for the servo plugs.
- Remote: connect the IMU to the normal pin headers instead of the Teensy - Remote: the IMU is on the normal pin headers (done 2026-11-17: Wire on
4.0's underside pads; see `remote/README.md`, "Planned" (Wire on 18/19, 18/19, the two stick axes that were there moved to A7/A8; display on
the two stick axes there move to A7/A8). Serial2, 7/8). Pinout in `remote/README.md`, "Wiring".
- Remote: measure the 18650's voltage on the Teensy to show how much charge - Remote: measure the 18650's voltage on the Teensy to show how much charge
is left (owner, later). Divider ~100k/100k from the cell's + (holder or the is left (owner, later). Divider ~100k/100k from the cell's + (holder or the
UPS board's B+, not the 5 V output) to A6 (pin 20, free), 100 nF to GND; UPS board's B+, not the 5 V output) to A6 (pin 20, free), 100 nF to GND;
full cell = ~2.1 V at the pin. Firmware: average, Li-ion curve to %, show full cell = ~2.1 V at the pin. Firmware: reading, smoothing and the volts
on the Nextion with a low-battery warning (optionally send it to the robot). on the STATUS page are done (`remote/Battery`, pin still 255 = not wired);
still to do: Li-ion curve to %, and a low-battery warning. The robot
already sends its own battery voltage back in the telemetry.
- Servo wires barely fit on the real robot: the six servo headers hang - Servo wires barely fit on the real robot: the six servo headers hang
above the battery bay, and the front pair sits right over the bay's end above the battery bay, and the front pair sits right over the bay's end
+8 -1
View File
@@ -7,7 +7,14 @@ It's **generated** by `../scripts/make_remote_hmi.py`: change the layout
there and re-run it, rather than editing the `.HMI` in Nextion Editor (an there and re-run it, rather than editing the `.HMI` in Nextion Editor (an
Editor edit is lost on the next run). Then open `remote.HMI` in Nextion Editor edit is lost on the next run). Then open `remote.HMI` in Nextion
Editor, compile, and upload the `.tft`: SETUP › UPDATE DISPLAY (tap twice) Editor, compile, and upload the `.tft`: SETUP › UPDATE DISPLAY (tap twice)
or serial key `U` puts the remote in USB passthrough for the upload. or serial key `U` puts the remote in USB passthrough for the upload. In the
Editor, upload to the Teensy's COM port with the baud rate on auto. When the
Editor is newer than the display's firmware, the upload first updates that
firmware: don't interrupt it. Power-cycle the remote afterwards to leave
upload mode.
The display is on the remote's **Serial2** (Teensy RX2 = pin 7, TX2 = pin 8),
at 115200.
``` ```
python scripts\make_remote_hmi.py (from 2026-current) python scripts\make_remote_hmi.py (from 2026-current)
+27 -17
View File
@@ -4,7 +4,9 @@ Handheld transmitter for the hexapod. It reads two 3-axis twist-grip
joysticks and an MPU6050, takes operator commands from a Nextion joysticks and an MPU6050, takes operator commands from a Nextion
touchscreen, and sends a `CmdPacket` (defined in touchscreen, and sends a `CmdPacket` (defined in
`../shared/HexapodProtocol/HexapodProtocol.h`) to the robot over nRF24L01 `../shared/HexapodProtocol/HexapodProtocol.h`) to the robot over nRF24L01
at 100 Hz. at 100 Hz. The robot's `Telemetry` comes back in the radio's ack payloads.
Without the robot, the Unity simulation can answer instead, through the
USB nRF24 dongle (`../sim/README.md`).
## Planned ## Planned
@@ -20,6 +22,10 @@ at 100 Hz.
From the `2026-current` folder: `pio run -e remote`, flash with From the `2026-current` folder: `pio run -e remote`, flash with
`pio run -e remote -t upload`, monitor with `pio device monitor -e remote`. `pio run -e remote -t upload`, monitor with `pio device monitor -e remote`.
The upload opens Teensy Loader; if the Teensy doesn't reboot into it by
itself, press its program button. If flashing works but the USB serial port
then won't open or goes quiet, try another USB port or cable before
suspecting the firmware (a bare Teensy 4.0 showed exactly that on one port).
## Wiring (edge headers only; edit `Config.h` if yours differs) ## Wiring (edge headers only; edit `Config.h` if yours differs)
@@ -29,6 +35,7 @@ From the `2026-current` folder: `pio run -e remote`, flash with
| nRF24L01 | CE / CSN | 9 / 10 | | nRF24L01 | CE / CSN | 9 / 10 |
| nRF24L01 | VCC | 3.3 V, with a 10–100 µF cap right at the module | | nRF24L01 | VCC | 3.3 V, with a 10–100 µF cap right at the module |
| MPU6050 | SDA / SCL | **18 / 19 (Wire)** | | MPU6050 | SDA / SCL | **18 / 19 (Wire)** |
| MPU6050 | VCC | 3.3 V (a GY-521 runs fine on it). Check the polarity: one supply reversal killed the first board's regulator |
| Nextion | TX → RX2, RX ← TX2 | 7 / 8 (Serial2), 5 V supply (found on the real remote) | | Nextion | TX → RX2, RX ← TX2 | 7 / 8 (Serial2), 5 V supply (found on the real remote) |
| Sticks | 6 axes | left stick X / Y / twist on **A3 / A7 / A8** (17 / 21 / 22), right stick on **A0 / A1 / A2** (14 / 15 / 16). A7/A8 hold the two wires that were on A4/A5 (18/19). All but the right twist read inverted (`STICK_INVERT`). Checked on the real remote | | Sticks | 6 axes | left stick X / Y / twist on **A3 / A7 / A8** (17 / 21 / 22), right stick on **A0 / A1 / A2** (14 / 15 / 16). A7/A8 hold the two wires that were on A4/A5 (18/19). All but the right twist read inverted (`STICK_INVERT`). Checked on the real remote |
| Battery (planned) | divider | A6 (20) | | Battery (planned) | divider | A6 (20) |
@@ -122,12 +129,13 @@ reads it after every send, and it counts as stale after
1. Power on with both sticks released and the remote held still. Each 1. Power on with both sticks released and the remote held still. Each
axis's resting center is captured automatically. axis's resting center is captured automatically.
2. For full calibration, disarm, then tap **CAL** (or press `c` on the 2. For full calibration, disarm, then tap **CAL STICKS** on the SETUP page
serial console). Move every axis of both sticks to both limits, release (or press `c` on the serial console). Move every axis of both sticks to
them, and tap **SAVE CAL** (`c`). The result is saved to EEPROM. both limits, release them, and tap **SAVE CAL** (`c`). The result is
saved to EEPROM, so it survives power cycles and reflashing.
3. If any axis moved less than `CAL_MIN_HALF_SPAN` either side of center, 3. If any axis moved less than `CAL_MIN_HALF_SPAN` either side of center,
the save is refused and you stay in calibration mode. **CANCEL CAL** the save is refused and you stay in calibration mode. **CANCEL** (`x`)
(`x`) aborts. aborts.
4. `p` prints the calibration in a form you can paste into `Config.h` 4. `p` prints the calibration in a form you can paste into `Config.h`
defaults. `R` wipes EEPROM back to the `Config.h` defaults. defaults. `R` wipes EEPROM back to the `Config.h` defaults.
@@ -158,18 +166,20 @@ and the servo-calibration state.
1. **Stick directions:** with `p`, confirm each logical axis reads 1. **Stick directions:** with `p`, confirm each logical axis reads
positive for right / forward / counterclockwise twist. Flip it in positive for right / forward / counterclockwise twist. Flip it in
`STICK_INVERT[]` if not. `STICK_INVERT[]` if not. Done on the real remote (2026-11-17), then
the sweep calibration.
2. **IMU mounting:** with `p`, dip the right edge down to get +roll, and 2. **IMU mounting:** with `p`, dip the right edge down to get +roll, and
tip the far edge down to get +pitch. If not, fix `IMU_AXIS_FROM_CHIP` / tip the far edge down to get +pitch. If not, fix `IMU_AXIS_FROM_CHIP` /
`IMU_AXIS_SIGN`. `IMU_AXIS_SIGN`. Done (defaults are right). The first GY-521 got its
3. **Nextion baud:** the generated HMI sets `bauds=115200` in Program.s. supply reversed once and its regulator now runs hot: redo this check
The display still runs the old HMI (probably 9600) until you upload on the replacement, and see whether it still needs the reset in
the new one; Nextion Editor finds the baud rate by itself. For that `RemoteIMU::begin()`.
first upload use serial key `U`: the old HMI's UPLOAD button isn't 3. **Nextion:** the generated HMI sets `bauds=115200` in Program.s and is
recognised any more. on the display (upload through SETUP › UPDATE DISPLAY or serial `U`).
4. **Radio:** with the robot powered, `tLink` / `p` should show ~100%, and 4. **Radio:** with the robot (or the Unity sim behind the USB dongle)
`p` should print robot telemetry. If it reads NO LINK, check that both running, `tLink` / `p` should show ~100%, and `p` should print robot
boards were built from the same `HexapodProtocol.h`: each end drops telemetry. If it reads NO LINK, check that both ends were built from
packets of the wrong size. the same `HexapodProtocol.h`: each end drops packets of the wrong size.
Done against the Unity sim through the dongle; not yet with the robot.
5. **End to end with the robot on a stand:** use `d` to dump packets and 5. **End to end with the robot on a stand:** use `d` to dump packets and
confirm each field changes the way the table above says. confirm each field changes the way the table above says.
+13 -6
View File
@@ -41,8 +41,9 @@ still a placeholder. Check all of it against the real robot:
needed ±90° offsets there, which left the servos at the end of their needed ±90° offsets there, which left the servos at the end of their
travel. travel.
- `RADIO_CE_PIN` / `RADIO_CSN_PIN` / `RADIO_SCK_PIN`: 39 / 15 / 14, as in - `RADIO_CE_PIN` / `RADIO_CSN_PIN` / `RADIO_SCK_PIN`: 39 / 15 / 14, as in
the old sketch. Address, channel, data rate, PA level and payload size the old sketch. Address, channel, data rate, PA level and the packet
are in `shared/HexapodProtocol` so they can't drift from the remote. structs are in `shared/HexapodProtocol` so they can't drift from the
remote.
## Bench-check checklist (do this before the first stand-up) ## Bench-check checklist (do this before the first stand-up)
@@ -62,7 +63,11 @@ for your build:
down). down).
3. **RobotIMU register map** (`RobotIMU.cpp`) — written for an MPU6050-style 3. **RobotIMU register map** (`RobotIMU.cpp`) — written for an MPU6050-style
chip (I2C addr `0x68`). If your gyro is a different part, its register chip (I2C addr `0x68`). If your gyro is a different part, its register
addresses and scale factors will differ; swap them in. addresses and scale factors will differ; swap them in. Also check that
it gives live readings at all (the robot's roll/pitch on the remote's
STATUS page): the remote's MPU6050 answered and woke up but read all
zeros until it got a full device reset (`PWR_MGMT_1 = 0x80`), which
`RobotIMU::begin()` doesn't do.
4. **Sit-pose assumption** — the built-in sit pose in `robot.ino` assumes all 4. **Sit-pose assumption** — the built-in sit pose in `robot.ino` assumes all
six feet stay grounded and simply lowers the body (a 0.4x height blend). six feet stay grounded and simply lowers the body (a 0.4x height blend).
If your chassis is meant to rest its belly on the ground instead, this If your chassis is meant to rest its belly on the ground instead, this
@@ -83,7 +88,8 @@ for your build:
This exact code also compiles for the PC and runs in the Unity model. See This exact code also compiles for the PC and runs in the Unity model. See
`../sim/README.md`. `sim/build/sim_smoke.exe` is a quick headless check `../sim/README.md`. `sim/build/sim_smoke.exe` is a quick headless check
after every change. after every change. In Unity the simulated robot can also be driven by the
real remote over the radio, through the USB nRF24 dongle.
## Testing without a remote yet ## Testing without a remote yet
@@ -163,6 +169,7 @@ robot/
├── StateMachine.h/.cpp - DISARMED/SIT/STAND/WALKING with smoothed sit-stand blend ├── StateMachine.h/.cpp - DISARMED/SIT/STAND/WALKING with smoothed sit-stand blend
├── InputMapper.h/.cpp - CmdPacket -> twist/pose/mode decoding ├── InputMapper.h/.cpp - CmdPacket -> twist/pose/mode decoding
├── Limits.h/.cpp - workspace clamp, joint rate limit, stance polygon check ├── Limits.h/.cpp - workspace clamp, joint rate limit, stance polygon check
├── Comms.h/.cpp - nRF24L01 receive (packet definition is in shared/HexapodProtocol) ├── Comms.h/.cpp - nRF24L01 receive + telemetry as ack payload (packets in shared/HexapodProtocol)
└── ServoDriver.h/.cpp - servo attach/relax/write ├── ServoDriver.h/.cpp - servo PWM write/relax, per-servo centre trims (EEPROM), SERVO_CAL
└── Battery.h/.cpp - battery voltage through a divider (not wired yet)
``` ```
+9 -3
View File
@@ -65,15 +65,21 @@ It drives the firmware the way the remote would and checks:
- **`+vx` moves the body forward**, - **`+vx` moves the body forward**,
- link loss disarms, - link loss disarms,
- a wrong-size packet is ignored, - a wrong-size packet is ignored,
- the serial harness still works. - the robot's telemetry comes back in the ack payload, and every servo
calibration command (HOLD / SET / SAVE / REVERT, arming refused) works,
- the serial harness still works,
- plus the body-pose, leg-clearance, heading and robot-gyro checks listed
in the file.
## Using it in Unity ## Using it in Unity
Open `Hexapod_Simulation_Unity` and press Play in `Main.unity`. No scene Open `Hexapod_Simulation_Unity` and press Play in `Main.unity`. No scene
edits are needed: `HexapodSimBootstrap` adds a `HexapodSimulation` object, edits are needed: `HexapodSimBootstrap` adds a `HexapodSimulation` object,
disables the old movement scripts (`Walk`, `RotationControl`, `Leg`), and disables the old movement scripts (`Walk`, `RotationControl`, `Leg`), and
binds the existing leg rig by name (`Leg` → `hip1` / `Hip2` / `Knie`). The binds the existing leg rig by name (`Leg` → `hip1` / `Hip2` / `Knie`). By
on-screen panel (F1 toggles it) offers two input sources: default `OpenScadModel` swaps the old scene's robot for the OpenSCAD model
of the real one (`HexapodSimulation.useOpenScadModel`). The on-screen panel
(F1 toggles it) offers two input sources:
- **Keyboard:** test without a remote. WASD walks, Q/E turns, IJKL + U/O - **Keyboard:** test without a remote. WASD walks, Q/E turns, IJKL + U/O
drive the right stick, 1–7 flip the toggles, Backspace disarms, +/- drive the right stick, 1–7 flip the toggles, Backspace disarms, +/-