From 9f73c0d189e881cad71e0417b818dee9f89fef90 Mon Sep 17 00:00:00 2001 From: larssand Date: Mon, 16 Nov 2026 20:16:35 +0100 Subject: [PATCH] docs(guide): simulator needs no real transponders, made-up or real numbers both work (1.89.43) --- CHANGELOG.md | 4 ++++ README.md | 2 +- README.sv.md | 2 +- package-lock.json | 4 ++-- package.json | 2 +- src/app.js | 4 ++-- 6 files changed, 11 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 70e4945..1ba84b0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,10 @@ The application version is maintained in `package.json` and displayed in the adm No changes recorded yet. +## 1.89.43 - 2026-11-16 + +- Guide and README: the decoder simulator section now says plainly that no real transponders are needed - add drivers with made-up numbers (e.g. 2001, 2002, 2003) and put them in a heat - and that real names and transponder numbers work just as well. + ## 1.89.42 - 2026-11-16 - RC RaceCore is now licensed under the GNU Affero General Public License v3.0 (`LICENSE`). Clubs can use and change it freely; anyone who shares a changed version or runs one as a service must share their source code under the same license. The README (English and Swedish) has a License section that also lists the third-party licenses (AMMC, flags, fonts). diff --git a/README.md b/README.md index 1078a50..f784e1b 100644 --- a/README.md +++ b/README.md @@ -496,7 +496,7 @@ AMMC sends PASSING messages like this ([AMMC docs](https://www.ammconverter.eu/d ### Testing without a decoder -Settings → "Decoder simulator" starts it from the UI (port 9099, the app connects by itself). From a terminal, `npm run sim` starts a decoder simulator on `ws://127.0.0.1:9000` (the app's default decoder address) that replaces AMMC and the decoder, so it also runs on a laptop without either. It sends passings with realistic lap times (about 18 s, a crash now and then) for the transponders in the active heat (sponsor heats: the cars), and follows when you switch heat. Start the heat on Race Day and the laps come in. Options: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. If port 9000 is busy (AMMC running), stop AMMC or use `--port 9100` and set the decoder address to `ws://127.0.0.1:9100`. +Settings → "Decoder simulator" starts it from the UI (port 9099, the app connects by itself). From a terminal, `npm run sim` starts a decoder simulator on `ws://127.0.0.1:9000` (the app's default decoder address) that replaces AMMC and the decoder, so it also runs on a laptop without either. It sends passings with realistic lap times (about 18 s, a crash now and then) for the transponders in the active heat (sponsor heats: the cars), and follows when you switch heat. Start the heat on Race Day and the laps come in. No real transponders are needed: add a few drivers under Directory → Drivers with made-up transponder numbers (for example 2001, 2002, 2003) and put them in a heat. Real names and transponder numbers work just as well, and then everything is ready for race day. Options: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. If port 9000 is busy (AMMC running), stop AMMC or use `--port 9100` and set the decoder address to `ws://127.0.0.1:9100`. **Test data:** `test-data/` has 12 drivers (`drivers.csv`), 4 rental cars (`cars.csv`) and 8 guest names (`sponsor-gaster.txt`). Import the CSVs under Settings → System & backup (Import drivers CSV / Import cars CSV), paste the names into a sponsor event, and run it with the simulator. diff --git a/README.sv.md b/README.sv.md index 91486f7..444d64f 100644 --- a/README.sv.md +++ b/README.sv.md @@ -509,7 +509,7 @@ AMMC skickar PASSING-meddelanden så här ([AMMC-dokumentation](https://www.ammc ### Testa utan decoder -Inställningar → "Decoder-simulator" startar den från UI (port 9099, appen ansluter själv). Från en terminal startar `npm run sim` en decoder-simulator på `ws://127.0.0.1:9000` (appens standardadress för decodern) som ersätter AMMC och decodern, så den fungerar även på en laptop utan dem. Den skickar passeringar med realistiska varvtider (runt 18 s, en krasch ibland) för transpondrarna i det aktiva heatet (sponsorheat: bilarna) och följer med när du byter heat. Starta heatet på Race Day så kommer varven. Val: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. Är port 9000 upptagen (AMMC körs) stoppar du AMMC eller kör `--port 9100` och sätter decoderadressen till `ws://127.0.0.1:9100`. +Inställningar → "Decoder-simulator" startar den från UI (port 9099, appen ansluter själv). Från en terminal startar `npm run sim` en decoder-simulator på `ws://127.0.0.1:9000` (appens standardadress för decodern) som ersätter AMMC och decodern, så den fungerar även på en laptop utan dem. Den skickar passeringar med realistiska varvtider (runt 18 s, en krasch ibland) för transpondrarna i det aktiva heatet (sponsorheat: bilarna) och följer med när du byter heat. Starta heatet på Race Day så kommer varven. Inga riktiga transpondrar behövs: lägg upp några förare under Register → Förare med påhittade transpondernummer (till exempel 2001, 2002, 2003) och lägg dem i ett heat. Riktiga namn och transpondernummer fungerar lika bra, och då är allt klart till tävlingen. Val: `npm run sim -- --lap 15 --spread 2 --tp 1001,1002 --port 9000`. Är port 9000 upptagen (AMMC körs) stoppar du AMMC eller kör `--port 9100` och sätter decoderadressen till `ws://127.0.0.1:9100`. **Testdata:** `test-data/` har 12 förare (`drivers.csv`), 4 hyrbilar (`cars.csv`) och 8 gästnamn (`sponsor-gaster.txt`). Importera CSV-filerna under Inställningar → System & backup (Importera förare CSV / Importera bilar CSV), klistra in namnen i ett sponsorevent och kör med simulatorn. diff --git a/package-lock.json b/package-lock.json index c9806fa..35644e1 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "rc-racecore", - "version": "1.89.42", + "version": "1.89.43", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "rc-racecore", - "version": "1.89.42", + "version": "1.89.43", "hasInstallScript": true, "license": "AGPL-3.0-or-later", "dependencies": { diff --git a/package.json b/package.json index d25a103..4ebc406 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "rc-racecore", - "version": "1.89.42", + "version": "1.89.43", "private": true, "license": "AGPL-3.0-or-later", "description": "RC RaceCore live timing and race control with AMMC ingest and SQLite persistence", diff --git a/src/app.js b/src/app.js index 0f5e2f7..e0250ed 100644 --- a/src/app.js +++ b/src/app.js @@ -3434,7 +3434,7 @@ const TRANSLATIONS = { "guide.audio_10": "10. Bättre röst utan internet: under Inställningar -> Ljud -> Röstmotor, klicka Installera en gång (hämtar Piper och svenska + engelska röster, kräver internet just då) och välj Lokal röst. Välj manlig eller kvinnlig röst per språk under Svensk röst / Engelsk röst och lyssna med Testa rösten. Klicka sedan Förgenerera fraser och förarnamn före racedagen. Allt körs sedan lokalt; saknas Piper eller dröjer den används webbläsarens röst automatiskt.", "guide.sim_title": "Testa utan decoder (simulator)", "guide.sim_1": "1. Inställningar → Anslutning → Decoder-simulator → Starta. Den ersätter AMMC och MyLaps-decodern (fungerar på Linux, Windows och en laptop utan decoder). Appen byter själv till simulatorns adress (port 9099) och ansluter; Stoppa sätter tillbaka den riktiga decoderadressen.", - "guide.sim_2": "2. Välj ungefärlig varvtid och spridning mellan bilarna. Simulatorn kör transpondrarna i det aktiva heatet (i sponsorheat bilarna) med realistiska varv och en krasch ibland, och följer med när du byter heat. Utan heat kör den klubbens förare eller 9001–9004.", + "guide.sim_2": "2. Välj ungefärlig varvtid och spridning mellan bilarna. Simulatorn kör transpondrarna i det aktiva heatet (i sponsorheat bilarna) med realistiska varv och en krasch ibland, och följer med när du byter heat. Utan heat kör den klubbens förare eller 9001–9004. Inga riktiga transpondrar behövs: lägg upp förare under Register → Förare med påhittade nummer (t.ex. 2001, 2002, 2003) och lägg dem i ett heat. Riktiga namn och transpondernummer fungerar lika bra – då är allt klart till tävlingen.", "guide.sim_3": "3. Starta heatet på Race Day som vanligt – nedräkning, start, utrop, overlay och resultat fungerar som med en riktig decoder. Simulatorn startar om av sig själv när servern startas om (npm restart).", "guide.sim_4": "4. Testdata: mappen test-data/ har 12 förare, 4 hyrbilar och 8 gästnamn. Importera förare och bilar under Inställningar → System & backup, klistra in gästnamnen i ett sponsorevent, starta simulatorn och kör. Från terminalen: npm run sim (port 9000, val --lap, --spread, --tp, --port).", "guide.sponsor_title": "Skapa Sponsor Event: 10 personer, 4 bilar", @@ -5857,7 +5857,7 @@ const TRANSLATIONS = { "guide.audio_10": "10. Better voice without internet: under Settings -> Audio -> Voice engine, click Install once (downloads Piper plus Swedish and English voices, needs internet just then) and choose Local voice. Pick a male or female voice per language under Swedish voice / English voice and listen with Test the voice. Then click Pre-generate phrases and driver names before race day. Everything then runs locally; if Piper is missing or slow the browser voice is used automatically.", "guide.sim_title": "Testing without a decoder (simulator)", "guide.sim_1": "1. Settings → Connection → Decoder simulator → Start. It replaces AMMC and the MyLaps decoder (works on Linux, Windows and a laptop without a decoder). The app switches to the simulator's address (port 9099) and connects; Stop puts the real decoder address back.", - "guide.sim_2": "2. Pick a rough lap time and the spread between the cars. The simulator drives the transponders of the active heat (the cars in sponsor heats) with realistic laps and a crash now and then, and follows when you switch heat. With no heat it drives the club's drivers or 9001-9004.", + "guide.sim_2": "2. Pick a rough lap time and the spread between the cars. The simulator drives the transponders of the active heat (the cars in sponsor heats) with realistic laps and a crash now and then, and follows when you switch heat. With no heat it drives the club's drivers or 9001-9004. No real transponders are needed: add drivers under Directory → Drivers with made-up numbers (e.g. 2001, 2002, 2003) and put them in a heat. Real names and transponder numbers work just as well – then everything is ready for race day.", "guide.sim_3": "3. Start the heat on Race Day as usual - count-down, start, calls, overlay and results work as with a real decoder. The simulator starts again by itself when the server restarts (npm restart).", "guide.sim_4": "4. Test data: the test-data/ folder has 12 drivers, 4 rental cars and 8 guest names. Import drivers and cars under Settings → System & backup, paste the guest names into a sponsor event, start the simulator and run. From a terminal: npm run sim (port 9000, options --lap, --spread, --tp, --port).", "guide.sponsor_title": "Create Sponsor Event: 10 drivers, 4 cars",