feat(sim): decoder simulator for testing without a decoder (1.64.0)
This commit is contained in:
1 parent
d0a5df6992
commit
0ce7280cbf
6 files changed
+133
-4
No files matched your search
@@ -8,6 +8,12 @@ The application version is maintained in `package.json` and displayed in the adm
|
|||||||
|
|
||||||
No changes recorded yet.
|
No changes recorded yet.
|
||||||
|
|
||||||
|
## 1.64.0 - 2026-11-05
|
||||||
|
|
||||||
|
### Added
|
||||||
|
|
||||||
|
- `npm run sim`: a decoder simulator for testing without a MyLaps decoder or AMMC (also on Linux). It listens on ws://127.0.0.1:9000, the app's default decoder address, and sends passings with realistic lap times for the transponders in the active heat (sponsor heats: the cars), following when you switch heat. Options `--lap`, `--spread`, `--tp`, `--port`, `--app`.
|
||||||
|
|
||||||
## 1.63.0 - 2026-11-05
|
## 1.63.0 - 2026-11-05
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
|
|||||||
@@ -429,6 +429,10 @@ AMMC sends PASSING messages like this ([AMMC docs](https://www.ammconverter.eu/d
|
|||||||
{ "msg": "PASSING", "passing_number": 1, "transponder": 232323, "rtc_time": "2022-10-11T22:57:36.099+02:00", "strength": 0.0, "resend": false, "loop_id": "55" }
|
{ "msg": "PASSING", "passing_number": 1, "transponder": 232323, "rtc_time": "2022-10-11T22:57:36.099+02:00", "strength": 0.0, "resend": false, "loop_id": "55" }
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Testing without a decoder
|
||||||
|
|
||||||
|
`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`.
|
||||||
|
|
||||||
## Development and tests
|
## Development and tests
|
||||||
|
|
||||||
- **Unit, logic and API tests:** `npm test`. The SQLite integration tests start their own server against a temporary database and never touch `data/`.
|
- **Unit, logic and API tests:** `npm test`. The SQLite integration tests start their own server against a temporary database and never touch `data/`.
|
||||||
|
|||||||
@@ -442,6 +442,10 @@ AMMC skickar PASSING-meddelanden så här ([AMMC-dokumentation](https://www.ammc
|
|||||||
{ "msg": "PASSING", "passing_number": 1, "transponder": 232323, "rtc_time": "2022-10-11T22:57:36.099+02:00", "strength": 0.0, "resend": false, "loop_id": "55" }
|
{ "msg": "PASSING", "passing_number": 1, "transponder": 232323, "rtc_time": "2022-10-11T22:57:36.099+02:00", "strength": 0.0, "resend": false, "loop_id": "55" }
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Testa utan decoder
|
||||||
|
|
||||||
|
`npm run sim` startar 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`.
|
||||||
|
|
||||||
## Utveckling och tester
|
## Utveckling och tester
|
||||||
|
|
||||||
- **Enhets-, logik- och API-tester:** `npm test`. SQLite-integrationstesterna startar en egen server mot en tillfällig databas och rör aldrig `data/`.
|
- **Enhets-, logik- och API-tester:** `npm test`. SQLite-integrationstesterna startar en egen server mot en tillfällig databas och rör aldrig `data/`.
|
||||||
|
|||||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "rc-racecore",
|
"name": "rc-racecore",
|
||||||
"version": "1.63.0",
|
"version": "1.64.0",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
"": {
|
"": {
|
||||||
"name": "rc-racecore",
|
"name": "rc-racecore",
|
||||||
"version": "1.63.0",
|
"version": "1.64.0",
|
||||||
"hasInstallScript": true,
|
"hasInstallScript": true,
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"better-sqlite3": "^12.11.1",
|
"better-sqlite3": "^12.11.1",
|
||||||
|
|||||||
+3
-2
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "rc-racecore",
|
"name": "rc-racecore",
|
||||||
"version": "1.63.0",
|
"version": "1.64.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"description": "RC RaceCore live timing and race control with AMMC ingest and SQLite persistence",
|
"description": "RC RaceCore live timing and race control with AMMC ingest and SQLite persistence",
|
||||||
"engines": {
|
"engines": {
|
||||||
@@ -25,7 +25,8 @@
|
|||||||
"audit:prod": "npm audit --omit=dev",
|
"audit:prod": "npm audit --omit=dev",
|
||||||
"test": "node --experimental-default-type=module tests/run.js",
|
"test": "node --experimental-default-type=module tests/run.js",
|
||||||
"test:browser": "node --experimental-default-type=module tests/browser_smoke.js",
|
"test:browser": "node --experimental-default-type=module tests/browser_smoke.js",
|
||||||
"setup:windows": "powershell -NoProfile -ExecutionPolicy Bypass -File windows/setup.ps1"
|
"setup:windows": "powershell -NoProfile -ExecutionPolicy Bypass -File windows/setup.ps1",
|
||||||
|
"sim": "node scripts/fake-decoder.mjs"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"better-sqlite3": "^12.11.1",
|
"better-sqlite3": "^12.11.1",
|
||||||
|
|||||||
Executable
+114
@@ -0,0 +1,114 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
// Decoder simulator for testing without a MyLaps decoder: pretends to be AMMC on
|
||||||
|
// ws://127.0.0.1:9000 (the app's default decoder address) and sends PASSING messages with
|
||||||
|
// realistic lap times. Usage: npm run sim [-- --lap 18 --spread 1.5 --tp 1001,1002 --port 9000]
|
||||||
|
// Without --tp it asks the running app which transponders are in the active heat (sponsor
|
||||||
|
// heats: the cars), and follows when you switch heat.
|
||||||
|
import { createHash } from "node:crypto";
|
||||||
|
import { createServer } from "node:http";
|
||||||
|
|
||||||
|
const args = Object.fromEntries(process.argv.slice(2).reduce((pairs, arg, index, all) => {
|
||||||
|
if (arg.startsWith("--")) pairs.push([arg.slice(2), all[index + 1] && !all[index + 1].startsWith("--") ? all[index + 1] : "true"]);
|
||||||
|
return pairs;
|
||||||
|
}, []));
|
||||||
|
const PORT = Number(args.port || 9000);
|
||||||
|
const APP = String(args.app || `http://127.0.0.1:${process.env.PORT || 8081}`);
|
||||||
|
const BASE_LAP_MS = Number(args.lap || 18) * 1000;
|
||||||
|
const SPREAD_MS = Number(args.spread || 1.5) * 1000;
|
||||||
|
const FIXED_TPS = args.tp ? String(args.tp).split(",").map((value) => value.trim()).filter(Boolean) : null;
|
||||||
|
|
||||||
|
const sockets = new Set();
|
||||||
|
const cars = new Map(); // transponder -> { paceMs, nextAt }
|
||||||
|
|
||||||
|
function frame(text) {
|
||||||
|
const payload = Buffer.from(text);
|
||||||
|
const header = payload.length < 126
|
||||||
|
? Buffer.from([0x81, payload.length])
|
||||||
|
: Buffer.from([0x81, 126, payload.length >> 8, payload.length & 0xff]);
|
||||||
|
return Buffer.concat([header, payload]);
|
||||||
|
}
|
||||||
|
|
||||||
|
function send(message) {
|
||||||
|
const data = frame(JSON.stringify(message));
|
||||||
|
for (const socket of sockets) socket.write(data);
|
||||||
|
}
|
||||||
|
|
||||||
|
// A lap: the car's own pace, +-0.6 s, and now and then a crash or a marshal (+3-8 s).
|
||||||
|
function nextLapMs(car) {
|
||||||
|
const noise = (Math.random() + Math.random() - 1) * 600;
|
||||||
|
const crash = Math.random() < 0.05 ? 3000 + Math.random() * 5000 : 0;
|
||||||
|
return Math.max(4000, Math.round(car.paceMs + noise + crash));
|
||||||
|
}
|
||||||
|
|
||||||
|
function setTransponders(list) {
|
||||||
|
const wanted = new Set(list);
|
||||||
|
for (const tp of [...cars.keys()]) if (!wanted.has(tp)) cars.delete(tp);
|
||||||
|
list.forEach((tp, index) => {
|
||||||
|
if (cars.has(tp)) return;
|
||||||
|
const paceMs = BASE_LAP_MS + (Math.random() - 0.3) * SPREAD_MS;
|
||||||
|
cars.set(tp, { paceMs, nextAt: Date.now() + 1500 + index * 700 + Math.random() * 2000 });
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
async function transpondersFromApp() {
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${APP}/api/state`);
|
||||||
|
const state = (await response.json())?.state;
|
||||||
|
if (!state) return null;
|
||||||
|
const sessions = state.sessions || [];
|
||||||
|
const session = sessions.find((item) => item.id === state.activeSessionId)
|
||||||
|
|| sessions.find((item) => ["running", "paused"].includes(item.status));
|
||||||
|
const driverTp = (id) => (state.drivers || []).find((driver) => driver.id === id)?.transponder;
|
||||||
|
const carTp = (id) => (state.cars || []).find((car) => car.id === id)?.transponder;
|
||||||
|
let list = [];
|
||||||
|
if (session?.carAssignments && Object.keys(session.carAssignments).length) list = Object.values(session.carAssignments).map(carTp);
|
||||||
|
else if (session?.assignments?.length) list = session.assignments.map((item) => carTp(item.carId));
|
||||||
|
else if (session?.driverIds?.length) list = session.driverIds.map(driverTp);
|
||||||
|
if (!list.filter(Boolean).length) list = (state.drivers || []).filter((driver) => !driver.guestEventId).map((driver) => driver.transponder).slice(0, 8);
|
||||||
|
return { list: [...new Set(list.map((value) => String(value || "").trim()).filter(Boolean))], session };
|
||||||
|
} catch {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
let lastLabel = "";
|
||||||
|
async function refreshTransponders() {
|
||||||
|
if (FIXED_TPS) { setTransponders(FIXED_TPS); return; }
|
||||||
|
const found = await transpondersFromApp();
|
||||||
|
const list = found?.list?.length ? found.list : ["9001", "9002", "9003", "9004"];
|
||||||
|
const label = `${found?.session ? `heat "${found.session.name}" (${found.session.status})` : found ? "no active heat" : `app not reachable at ${APP}`}: ${list.join(", ")}`;
|
||||||
|
if (label !== lastLabel) { console.log(`Transponders - ${label}`); lastLabel = label; }
|
||||||
|
setTransponders(list);
|
||||||
|
}
|
||||||
|
|
||||||
|
const server = createServer((_req, res) => { res.writeHead(200); res.end("Live_RC decoder simulator\n"); });
|
||||||
|
server.on("upgrade", (req, socket) => {
|
||||||
|
const key = req.headers["sec-websocket-key"];
|
||||||
|
if (!key) { socket.destroy(); return; }
|
||||||
|
const accept = createHash("sha1").update(key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").digest("base64");
|
||||||
|
socket.write(["HTTP/1.1 101 Switching Protocols", "Upgrade: websocket", "Connection: Upgrade", `Sec-WebSocket-Accept: ${accept}`, "", ""].join("\r\n"));
|
||||||
|
sockets.add(socket);
|
||||||
|
console.log(`App connected (${sockets.size} open)`);
|
||||||
|
socket.on("data", () => {}); // client frames (if any) are not needed
|
||||||
|
socket.on("error", () => sockets.delete(socket));
|
||||||
|
socket.on("close", () => { sockets.delete(socket); console.log(`App disconnected (${sockets.size} open)`); });
|
||||||
|
});
|
||||||
|
server.on("error", (error) => {
|
||||||
|
if (error.code === "EADDRINUSE") console.error(`Port ${PORT} is busy - probably AMMC. Stop it (Settings → decoder → Stop AMMC) or run: npm run sim -- --port 9100 and set the decoder address to ws://127.0.0.1:9100.`);
|
||||||
|
else console.error(error.message);
|
||||||
|
process.exit(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
server.listen(PORT, "127.0.0.1", async () => {
|
||||||
|
console.log(`Decoder simulator on ws://127.0.0.1:${PORT} - laps around ${BASE_LAP_MS / 1000} s. Ctrl+C stops.`);
|
||||||
|
await refreshTransponders();
|
||||||
|
setInterval(refreshTransponders, 5000);
|
||||||
|
setInterval(() => {
|
||||||
|
const now = Date.now();
|
||||||
|
for (const [tp, car] of cars) {
|
||||||
|
if (now < car.nextAt) continue;
|
||||||
|
send({ msg: "PASSING", transponder: tp, rtc_time: new Date(now).toISOString(), strength: 90 + Math.round(Math.random() * 30), loop_id: "1" });
|
||||||
|
car.nextAt = now + nextLapMs(car);
|
||||||
|
}
|
||||||
|
}, 50);
|
||||||
|
});
|
||||||
Reference in new issue
Block a user