Public/Live_RC
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Enable bundled AMMC tools and document decoder simulation

Browse Source
This commit is contained in:
larssand
2026-09-02 21:13:49 +02:00
parent 9aeb638211
commit f2ba4b3c7b
14 changed files with 123 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
docs/decoder-setup.md
View File

@@ -69,7 +69,7 @@ Each physical decoder needs a unique IP. Each enabled AMMC process needs a uniqu
AMMC runs on the computer started with `npm start` or `npm.cmd start`, not on a remote browser laptop.
On x86-64 Linux, the bundled `AMMC/linux_x86-64/ammc-amb` requires GLIBC 2.39 or newer. Check with `ldd --version` or `npm run verify`. RC RaceCore itself may run on an older host, but this bundled AMMC binary will not.
On x86-64 Linux, all bundled programs in `AMMC/linux_x86-64` require GLIBC 2.39 or newer. Check with `ldd --version` or `npm run verify`. RC RaceCore itself may run on an older host, but these bundled AMMC programs will not.
1. Start the backend and open `Settings`.
2. From remote devices use backend URL `http://192.168.1.100:8081`.
@@ -108,6 +108,37 @@ Syntax: `ammc-amb -w <backend WebSocket port> <physical decoder IP>`.
Disable Managed AMMC when starting these processes manually, otherwise two processes may compete for the same port.
## Fake decoder with AMMC Simulator
`ammc-sim` emulates a physical decoder. It does not replace the AMMC WebSocket converter: run the simulator first, then point `ammc-amb` at the simulator host. Keep this setup off the live decoder network during an official race.
Linux example with four simulated drivers and a passing every 15 to 22 seconds:
```bash
./AMMC/linux_x86-64/ammc-sim \
--transponder 1111111,2222222,3333333,4444444 \
--passing-delay 15000-22000 \
--my_ip 192.168.1.100 \
--skip_telemetry_upload \
AMB
./AMMC/linux_x86-64/ammc-amb -w 9000 192.168.1.100
```
Windows uses the same arguments with `ammc-sim.exe` and `ammc-amb.exe`. Replace `192.168.1.100` with the computer running the simulator. RC RaceCore still connects to `ws://<AMMC-host>:9000`. Use transponder numbers registered in RC RaceCore, or use Open Practice to display unknown numbers directly.
Useful simulator options:
| Option | Purpose |
|---|---|
| `--transponder 123,456` | IDs emitted by the fake decoder |
| `--passing-delay 15000-22000` | Random delay between passings in milliseconds |
| `--passing-numbers 1-500` | Stop after the configured passing-number range |
| `--startup_delay_secs 5` | Wait before sending passings |
| `--my_ip <address>` | Address returned during decoder auto-discovery |
Run `ammc-sim --help` for the options supported by the bundled version. The simulator is a test input only; all lap validation, stint handling, leaderboard updates, and persistence continue through the normal RaceCore event pipeline.
## Firewall
Open ports on the backend host, not the operator laptop.