feat(decoder): warn when the decoder's clock is off (1.42.4)
The decoder's time is never changed. Passings (also during warm-up) measure it against the computer's clock, and Race Day's preflight and the decoder diagnostics warn when it is over a minute off, e.g. after the switch to winter time.
This commit is contained in:
1 parent
ca88fd9ecc
commit
35eb3eb059
14 files changed
+180
-5
No files matched your search
@@ -0,0 +1,37 @@
|
||||
// The decoder's clock is the source of truth for timing and is never changed by RaceCore. It
|
||||
// is set by hand (it doesn't follow summer/winter time), and when it is off, everything that
|
||||
// compares a passing with "now" goes wrong: a heat's first lap from the start signal, a
|
||||
// practice pass on the phone, Even laps. Lap times themselves (two decoder times) stay right,
|
||||
// which is why it goes unnoticed. This only measures how far off it is, to warn about it.
|
||||
export const DECODER_CLOCK_WARNING_MS = 60 * 1000;
|
||||
const SAMPLES = 5;
|
||||
|
||||
export function createDecoderClockCheck() {
|
||||
const samples = new Map();
|
||||
return {
|
||||
// rawTs: the decoder's own time for a passing, receivedAt: the computer's clock on arrival.
|
||||
record(role, rawTs, receivedAt = Date.now()) {
|
||||
if (!Number.isFinite(rawTs)) return;
|
||||
const list = samples.get(role) || [];
|
||||
list.push(receivedAt - rawTs);
|
||||
if (list.length > SAMPLES) list.shift();
|
||||
samples.set(role, list);
|
||||
},
|
||||
// How far the decoder is behind the computer (ms; negative = ahead), or null before any
|
||||
// passing. The smallest recent sample: a passing delivered late (resent after a reconnect)
|
||||
// only makes the decoder look further behind than it is.
|
||||
skewMs(role) {
|
||||
const list = samples.get(role);
|
||||
return list?.length ? Math.min(...list) : null;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
// null when the clocks agree; otherwise how far and which way the decoder is off.
|
||||
export function describeDecoderClockSkew(skewMs) {
|
||||
if (!Number.isFinite(skewMs) || Math.abs(skewMs) < DECODER_CLOCK_WARNING_MS) return null;
|
||||
const totalMinutes = Math.round(Math.abs(skewMs) / 60000);
|
||||
return { ahead: skewMs < 0, hours: Math.floor(totalMinutes / 60), minutes: totalMinutes % 60 };
|
||||
}
|
||||
|
||||
export const decoderClockCheck = createDecoderClockCheck();
|
||||
Reference in new issue
Block a user