Plesty K10CR1 Device

Plesty device for the Thorlabs K10CR1 motorized 360° cage rotation stage, driven over USB serial with the binary APT protocol (no Kinesis/.NET runtime required, works on Windows and Linux).

Device constants (unit scaling, software limits, stage defaults, runtime defaults) live in plesty/k10cr1/config.yaml; the parameter set is defined in plesty/k10cr1/schema_param.json.

Installation

git clone https://gitlab.com/plesty/hub/devices/thorlab/plesty-k10cr1.git
cd plesty-k10cr1
uv sync

Run As TCP Server

Windows only: the controller's custom FTDI product id is claimed by no driver macOS can load, and no rig here has bound it on Linux. The simulator (--mock) runs anywhere. See the docs for the detail.

Connect the stage via USB. The server opens the stage named by the first of these that is set: the controller's serial number from the unit's label (DEVICE_SERIAL or --serial, e.g. 55001327), the serial port (DEVICE_PORT or --port, e.g. COM3), or else the one controller carrying Thorlabs' USB id 0403:FAF0 (DEVICE_VID_PID or --vid-pid). On a host with several stages, give each server its serial number: it stays valid when a replug moves the COM name, and with two controllers and neither set the server refuses rather than guess. Then:

uv run python -m plesty.k10cr1 --tcp-port 5555

Pass --mock to serve the in-memory APT motor simulator instead of real hardware.

Run pytest

All tests run against the simulator; set DEVICE_PORT in .env to also run the real-device test.

uv run pytest