Files
TeslaRel410/restoration/rio-firmware/wedge-explained.md
T
Cyd def5840e07 Import RIO board firmware from RIOjoy repo (history preserved)
Board firmware dumps, disassembly, make_patch.py, patched images
(RIO 4.3 + FastRIO), analysis, and bench testlogs — moved from the
RIOjoy repo into the Tesla cockpit restoration archive.

git-subtree-dir: restoration/rio-firmware
git-subtree-mainline: 6c0dfcf792
git-subtree-split: 4fb91775fc
2026-07-19 20:45:16 -05:00

35 lines
1.9 KiB
Markdown

# Why your pod's stick sometimes "died" mid-battle — and why it won't anymore
*A plain-language explanation for pod owners. The technical write-up is in
[RIOv4_2-ANALYSIS.md](RIOv4_2-ANALYSIS.md).*
Inside every pod is a small computer board from 1994 (the **RIO**) whose job
is to tell the game what you're doing: which buttons you pressed, and where
you've moved the stick, throttle, and pedals.
The board and the game talk like two people on walkie-talkies. Every time the
board reports your stick position, it waits for the game to answer *"got it."*
During calm flying that works fine. But in a frantic firefight — lamps
flashing, buttons hammering — the channel gets crowded, and once in a while
that little *"got it"* gets drowned out.
When that happens, the board repeats itself a few times and then, sensibly,
gives up and moves on. Here's the bug: while it's sending a position report,
the board puts up a mental sticky note that says *"busy — already sending
one."* When a report goes through normally, it takes the note down. But on the
give-up path, the 1994 programmers forgot one line — **the note never comes
down.** From that moment the board looks at the sticky note, decides it's still
busy, and quietly throws away every stick and throttle update forever after.
That's the "wedge" you may have felt: mid-mission, your stick and throttle
just stop doing anything, while the buttons and lamps still work fine —
because those travel a different path that the sticky note doesn't block.
Starting a new mission always cured it, since a new game tells the board to
clean house, sticky note included.
The **RIO 4.3** firmware adds the one missing instruction: whenever the board
gives up on a report, it now takes the sticky note down too. We stress-tested
it by mashing buttons at over nine presses *per second* for two minutes
straight — the old board wedged under that abuse; the new one never misses a
beat.