Enable bundled AMMC tools and document decoder simulation

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

View File

@@ -80,7 +80,7 @@ Varje fysisk decoder ska ha en unik IP. Varje aktiverad AMMC-process ska ha en u
AMMC körs på samma dator som startats med `npm start` eller `npm.cmd start`. Webbläsaren kan köras på en annan dator.
På Linux x86-64 kräver den bundlade `AMMC/linux_x86-64/ammc-amb` GLIBC 2.39 eller senare. Kontrollera med `ldd --version` eller `npm run verify`. RC RaceCore kan köras på en äldre host, men just denna bundlade AMMC-binär fungerar då inte.
På Linux x86-64 kräver alla bundlade program i `AMMC/linux_x86-64` GLIBC 2.39 eller senare. Kontrollera med `ldd --version` eller `npm run verify`. RC RaceCore kan köras på en äldre host, men dessa bundlade AMMC-program fungerar då inte.
1. Starta backend.
2. Öppna `Inställningar`.
@@ -142,6 +142,37 @@ ammc-amb -w <WebSocket-port på backend> <fysisk decoder-IP>
Starta bara processerna för de roller som används. Stäng av `Hanterad AMMC` om processerna startas manuellt, annars kan två processer försöka använda samma portar.
## Fake decoder med AMMC Simulator
`ammc-sim` simulerar en fysisk decoder. Den ersätter inte AMMC:s WebSocket-konverterare: starta först simulatorn och låt sedan `ammc-amb` ansluta till simulatorns dator. Håll testuppsättningen borta från det skarpa decodernätet under ett officiellt race.
Linux-exempel med fyra simulerade förare och en passering var 15:e till 22:a sekund:
```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
```
På Windows används samma argument med `ammc-sim.exe` och `ammc-amb.exe`. Byt `192.168.1.100` till adressen för datorn som kör simulatorn. RC RaceCore ansluter fortfarande till `ws://<AMMC-host>:9000`. Använd transpondernummer som är registrerade i RaceCore, eller kör Open Practice för att visa okända nummer direkt.
Användbara simulatorval:
| Val | Funktion |
|---|---|
| `--transponder 123,456` | ID:n som fake decodern skickar |
| `--passing-delay 15000-22000` | Slumpad tid mellan passeringar i millisekunder |
| `--passing-numbers 1-500` | Stoppa efter angivet intervall av passeringsnummer |
| `--startup_delay_secs 5` | Vänta innan passeringarna börjar |
| `--my_ip <adress>` | Adress som returneras vid decoder-autodiscovery |
Kör `ammc-sim --help` för valen i den bundlade versionen. Simulatorn är bara en testkälla; varvvalidering, stintlogik, leaderboard och lagring går fortfarande genom RaceCores vanliga eventflöde.
## Brandvägg
Portarna öppnas på backend-datorn, inte på operatörens laptop.