MockDevice

class lsst.ts.ess.common.device.MockDevice(name: str, device_id: str, sensor: BaseSensor, callback_func: Callable, log: Logger, in_error_state: bool = False)

Bases: BaseDevice

Mock Sensor Device.

Parameters:

namestr

The name of the device.

device_idstr

The hardware device ID to connect to.

sensorBaseSensor

The sensor that produces the telemetry.

callback_funcCallable

Callback function to receive the telemetry.

loglogging.Logger

The logger to create a child logger for.

Attributes Summary

telemetry_interval

Methods Summary

basic_close()	Close the Sensor Device.
basic_open()	Open the Sensor Device.
close()	Stop the telemetry loop.
handle_readline_exception(exception)	Handle any exception that happened in the readline method.
open()	Generic open function.
readline()	Read a line of telemetry from the device.

Attributes Documentation

telemetry_interval = 1

Methods Documentation

async basic_close() → None

Close the Sensor Device.

async basic_open() → None

Open the Sensor Device.

async close() → None

Stop the telemetry loop.

async handle_readline_exception(exception: BaseException) → None

Handle any exception that happened in the readline method.

The default is to log and ignore but subclasses may override this method to customize the behavior.

Parameters:

exceptionBaseException

The exception to handle.

async open() → None

Generic open function.

Check if the device is open and, if not, call basic_open. Then start the telemetry loop.

Raises:

RuntimeError

In case the device already is open.

async readline() → str

Read a line of telemetry from the device.

Returns:

linestr

Line read from the device. Includes terminator string if there is one. May be returned empty if nothing was received or partial if the readline was started during device reception.