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>
This commit is contained in:
mangavalkandClaude Opus 5.5 committed 2026-11-17 22:52:44 +01:00
1 parent 1591105f26
commit 175a1a0da8
3 files changed
+41 -42

No files matched your search

+22 -25
View File
@@ -72,36 +72,33 @@ Hardware (besides the electronics of the old remote):
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
(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
display is mounted turned round so its connector clears the Teensy's USB plug.
- The display is mounted turned round so its connector clears the Teensy's USB
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).
## Planned
- **PC radio link (owner, later):** a USB nRF24L01 stick on the PC as the
PC-side radio, on the same air settings as the robot and the remote, so Unity
on the PC can both receive data from (telemetry) and send data to the robot
and the remote. The stick is now reverse-engineered and reflashed with our own
firmware (STM32F030 + Si24R1 + AT2401C); it shows up as a COM port and is
updated wire-free over USB. See **[dongle/README.md](dongle/README.md)**. Still
to do:
- map the stick's LED and AT2401C power-amp control pins (app toggles them);
- the radio protocol: today the remote only transmits a `CmdPacket` to the
robot and nothing comes back. Three nodes need an address per node (or
per pipe), a packet type byte, and telemetry back (e.g. as ack payloads
or in time slots) so the nodes don't talk over each other; who has
priority when the PC and the remote both send commands. Owner's
decisions: the remote wins, with a toggle on the remote that hands the
robot to Unity and lets the remote's sticks control Unity instead; the
PC is the hub while it's online, the robot is the hub when it isn't;
goals: mirror the real robot in Unity, 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
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".
- **PC radio link:** a USB nRF24L01 stick on the PC as the PC-side radio, on
the same air settings as the robot and the remote. It's reverse-engineered
and runs our own firmware (STM32F030 + Si24R1 + AT2401C, updated wire-free
over USB), see **[dongle/README.md](dongle/README.md)**. Done (2026-11-17):
its **bridge mode** lets the real remote drive the Unity simulation over the
air, with the sim's telemetry going back to the remote's display as the ack
payload ([sim/README.md](sim/README.md), "Using it in Unity"). There's no USB
link to the remote or the robot any more; everything goes over the radio.
Still to do:
- Unity driving the **real** robot (the dongle transmitting instead of
listening) and mirroring it;
- three nodes at once: today the dongle answers the remote *instead of* the
robot. Needs an address per node (or per pipe), a packet type byte, and a
rule for who has priority. Owner's decisions: the remote wins, with a
toggle on the remote that hands the robot to Unity and lets the remote's
sticks control Unity instead; the PC is the hub while it's online, the
robot is the hub when it isn't; goals: mirror the real robot in Unity,
drive it from Unity, remote data to the PC, and PC data to the remote.
- Remote battery level: see [remote/README.md](remote/README.md), "Planned".
- Robot power: a stable 6 V supply for the 18 servos, see
[hardware/openscad/PLANNING.md](hardware/openscad/PLANNING.md), "Notes for
future designs".