devctrl.devices.led_controller.impl.dummy.DummyLedController

class DummyLedController

Bases: LedController, DummyDevice

Methods

add_device	Manually add a specific device.
allow_only_dummy_devices
connect
connect_device	This function should be overridden by device implementations only, and is not intended to be used directly.
connect_dummy	Connect an instance of the device's dummy implementation
get_base_classes	Return a flat dictionary of all base classes below this class :param recurse: If True, recursively search for base classes :return: dict of {class name: class}
get_brightness_percent
get_capabilities	Get controller capabilities
get_current_A
get_device_name
get_device_type_name
get_led_name
get_mode	Query the current device operating mode
get_status	Query the status of the device and return a string describing errors.
is_connected	Query whether the device is (still) connected
list_devices	Get a list of all devices for this type.
off	Set the LED brightness to 0%
on	Set the LED brightness to 100%
set_brightness_percent	Set the LED brightness to a specific percentage
set_current_A
set_mode	Set the LED controller operating mode

Attributes

BRIGHTNESS_ON_OFF
BRIGHTNESS_PERCENT
VALID_BRIGHTNESS_PERCENT

classmethod add_device(connect_info)

Manually add a specific device. The device will show up when list_devices() is called for the device type. Call this from the device class implementation, e.g. use ModelXYZ9000.add_device(‘GPIB:1234:5678’) to add a specific device with a fixed GPIB address. This is useful when automatic discovery is undesired/impossible, either because it is not implemented or it disturbs other devices which can’t handle a identification request. :param cls: The device implementation class :param connect_info: A string argument that is passed to the connect() method of the device implementation, when the device is being connected.

classmethod connect(device_type_name: str, device_name: str | None, **kwargs) → Device

Parameters:

• device_type_name – The name of the device class

• device_name – The name of the device class

classmethod connect_device(device_name)

This function should be overridden by device implementations only, and is not intended to be used directly. Instead, use list_devices() to get a list of devices, and pass the selected device type and name to connect() :param device_name: The name of the device class

classmethod connect_dummy(**kwargs) → Device

Connect an instance of the device’s dummy implementation

classmethod get_base_classes(recurse=True) → dict[str, type[Device]]

Return a flat dictionary of all base classes below this class :param recurse: If True, recursively search for base classes :return: dict of {class name: class}

get_capabilities() → int

Get controller capabilities

Returns:

Capabilities bitmask (BRIGHTNESS_PERCENT)

classmethod get_device_name() → str

Returns:

The specific type name of the device, e.g., SR830 or Keithly2600

classmethod get_device_type_name() → str

Returns:

The general type name of the device, e.g., Lock-In Amplifier or Voltmeter

get_mode() → str

Query the current device operating mode

Returns:

Current mode identifier string

get_status() → str

Query the status of the device and return a string describing errors. If everything is ok, empty string must be returned :return: String of device status

is_connected() → bool

Query whether the device is (still) connected

classmethod list_devices() → list[tuple[str, str]]

Get a list of all devices for this type. The list made up of: - Manually added devices - Available devices (those returned by _enumerate_devices) - A dummy device (if a dummy implementation exists) - List of all devices of child classes

Returns:

list of available devices

off()

Set the LED brightness to 0%

on()

Set the LED brightness to 100%

set_brightness_percent(level: int)

Set the LED brightness to a specific percentage

Parameters:

level – Brightness level in percent (0-100)

set_mode(mode: str)

Set the LED controller operating mode

Parameters:

mode – Operating mode string