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. Left unset, the server finds the APT controller attached to the host — set DEVICE_PORT in .env (or --port, or running.port in config.yaml) only to name one stage among several: either the serial port (COM3) or, better, the controller's serial number from the unit's label (55001327), which stays valid when replugging moves the COM name. 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