pydcscontrol 0.2.0

Network client for Advanced Illumination DCS light controllers

pydcscontrol

Python client library for communicating with Advanced Illumination DCS light controllers over the Ethernet interface.

This package implements the controller's SCPI-like command protocol over TCP (default port 777).

Even though the DCS controller is super simple, it is nice to be able to pull in a package to one-liner the most common operations.

These common operation wrappers also do a validation of the current configurations for a sanity check.

Usage

Command line (Using uv)

Using the easy-set CLI script to set the current of one or more DCS channels to 100 mA:

uvx --from pydcscontrol easy-set 100 --channels 1 2

Using the turn-off CLI script to turn off one or more DCS channels:

uvx --from pydcscontrol turn-off

Both commands default to channels 1 and 2 when --channels is omitted.

Python script

Install the package:

uv add pydcscontrol
# or
pip install pydcscontrol

Using continuous mode to set the current of one or more DCS channels to 100 mA:

from pydcscontrol import DCSController

if DCSController().easy_set(channels=[1, 2], current=100):
    print("DCS channels configured successfully")
else:
    print("DCS channels configuration failed")

Quickly turn DCS output off:

from pydcscontrol import DCSController

if DCSController().turn_off(channels=[1, 2]):
    print("DCS channels turned off successfully")
else:
    print("Failed to turn off DCS channels")

Development

uv sync
uv run ruff check
uv run ruff format .
uv run pytest
uv build
git tag -a vX.Y.Z -m vX.Y.Z
git push --tags

If a deployment fails

git tag -d vX.Y.Z
git push origin :refs/tags/vX.Y.Z
git tag -a vX.Y.Z -m vX.Y.Z
git push --tags