SimulatedConsole

Defined in: console-sdk/src/testing/simulatedConsole.ts:98

The “person at the machine + the firmware” — everything a test can do to one simulated console (SDK_PLAN.md §3.11.2). Obtain instances from SimulatedTransport.console(ref) / .addConsole(spec).

Clock gating (§3.11.2’s table): run() frames, reconnect budgets, and command timeouts need clock.advance(...); presence flips, pressKey, and emitFrame take effect immediately (microtask queue).

Methods

appear()

appear(): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:107

Comes (back) into radio range: scannable and connectable again.

Returns

void

---

dropConnection()

dropConnection(): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:111

Unexpected BLE link loss → the reconnect-policy path.

Returns

void

---

emitFrame()

emitFrame(frame): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:122

Emits one frame — the current state shallow-merged with frame.

Parameters

frame

Partial<LiveMetrics>

Returns

void

---

failNextCommand()

failNextCommand(command, mode): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:129

Injects a protocol-level fault into the NEXT matching command: 'timeout' drops the response frame, 'reject' answers with the firmware failure result. One-shot; cleared once consumed.

Parameters

command

"start" | "programWorkout" | "stop" | "fetchRecord"

mode

"timeout" | "reject"

Returns

void

---

powerOff()

powerOff(): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:115

Clean shutdown: disconnect + not scannable.

Returns

void

---

pressKey()

pressKey(key): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:118

Presses a front-panel key. HOME mid-workout = premature-FINISH abort.

Parameters

key

"select" | "home"

Returns

void

---

restoreConnection()

restoreConnection(): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:113

Becomes connectable again after SimulatedConsole.dropConnection.

Returns

void

---

run()

run(script): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:120

Runs an autopilot workout: realistic frames on the clock.

Parameters

script

ConsoleScript

Returns

void

---

vanish()

vanish(): void

Defined in: console-sdk/src/testing/simulatedConsole.ts:109

Goes out of range: stops advertising — the scan-TTL expiry path.

Returns

void

Properties

id

readonly id: DeviceId

Defined in: console-sdk/src/testing/simulatedConsole.ts:100

Stable transport-level device id.

---

model

readonly model: DeviceModel

Defined in: console-sdk/src/testing/simulatedConsole.ts:104

Hardware model.

---

received

readonly received: object

Defined in: console-sdk/src/testing/simulatedConsole.ts:135

What the SDK wrote to this console — assert on programming/setup.

displayUnits

displayUnits: DisplayUnits | null

Display units applied by the SDK, or null before any write.

heartRateBpm

heartRateBpm: number | null

Last heart-rate forward, bpm, or null before any write.

program

program: unknown

The decoded programmed workout, or null before any SET_WORKOUT.

utcSynced

utcSynced: boolean

Whether a clock-sync command has been received.

---

serial

readonly serial: string

Defined in: console-sdk/src/testing/simulatedConsole.ts:102

User-visible serial / console id.

---

workoutState

readonly workoutState: "idle" | "working" | "resting" | "finished"

Defined in: console-sdk/src/testing/simulatedConsole.ts:147

Firmware lifecycle phase, as the console itself would report it.