ui.screens.wfl

Wait-for-light screens: calibration (legacy) and auto-detection.

Classes

WFLMeasureResult

Result from WFLMeasureScreen.

WFLMeasureScreen

Measure light on or off state for wait-for-light calibration.

WFLConfirmResult

Result from WFLConfirmScreen.

WFLConfirmScreen

Confirm wait-for-light calibration values.

WFLDetectScreen

Status display for automatic wait-for-light detection.

Module Contents

class ui.screens.wfl.WFLMeasureResult

Result from WFLMeasureScreen.

value: float
class ui.screens.wfl.WFLMeasureScreen(port: int, is_on: bool)

Bases: ui.screen.UIScreen[WFLMeasureResult]

Measure light on or off state for wait-for-light calibration.

Shows light bulb visualization and real-time sensor reading. Returns sensor value when button is pressed.

title = 'Wait for Light Calibration'
port
is_on
build() → ui.widgets.Widget

Build the screen layout.

Called on every render. Return a Widget tree describing what to display.

async on_press()
class ui.screens.wfl.WFLConfirmResult

Result from WFLConfirmScreen.

confirmed: bool
light_off: float
light_on: float
property threshold: float
class ui.screens.wfl.WFLConfirmScreen(port: int, light_off: float, light_on: float)

Bases: ui.screen.UIScreen[WFLConfirmResult]

Confirm wait-for-light calibration values.

Shows measured values (editable), threshold, and difference. User can confirm or retry.

title = 'Wait for Light Calibration'
port
light_off
light_on
property threshold: float
property difference: float
property is_good: bool
build() → ui.widgets.Widget

Build the screen layout.

Called on every render. Return a Widget tree describing what to display.

async on_off_change(value: float)
async on_on_change(value: float)
async on_retry()
async on_confirm()
class ui.screens.wfl.WFLDetectScreen

Bases: ui.screen.UIScreen[None]

Status display for automatic wait-for-light detection.

Shows the current sensor value, Kalman-filtered baseline, trigger threshold, and detection status. Supports an interactive test mode where the user verifies the lamp would trigger before the system is truly armed.

States:

WARMING UP — collecting baseline samples TEST MODE — detects lamp but will NOT start the mission TRIGGERED — lamp detected during test (big confirmation) ARMED — fully armed, real trigger starts the mission GO! — lamp detected for real, mission starting

title = 'Wait for Light'
status: str = 'WARMING UP'
status_color: str = 'amber'
raw_value: int = 0
baseline: float = 0.0
threshold: float = 0.0
test_count: int = 0
hint: str = ''
request_test_mode: bool = False
request_reinit: bool = False
build() → ui.widgets.Widget

Build the screen layout.

Called on every render. Return a Widget tree describing what to display.

async on_test()
async on_reinit()