Plesty PyForPICam

Python ctypes bindings for the Princeton Instruments PICam library.

This is a low-level support module for plesty-picamccd: it wraps the C functions exposed by the PICam SDK (Picam.dll) as plain synchronous Python functions. It is not a Plesty device on its own — it provides the raw call surface that a device driver builds on.

Async use is not baked in here. Callers that need await wrap the consuming device with plesty.lib.device.async_wrapper.AsyncWrapperSafe, which offloads the blocking ctypes calls to a worker thread.

Installation

uv add "plesty-pyforpicam @ git+https://gitlab.com/plesty/hub/devices/princeton_instruments/pyforpicam.git"

Usage

import plesty.pyforpicam as pyforpicam
from plesty.pyforpicam.PiFunctions import Picam_InitializeLibrary

Each Picam_* function takes the loaded PICam handle as its first argument and returns True on success, raising the matching PicamError subclass otherwise.

License

Licensed under the GNU General Public License, version 3 or later (GPL-3.0-or-later); see LICENSE. Note that PiFunctions.py derives from PythonForPicam by Joe Lowney, distributed under the GNU General Public License (see COPYING), and has been modified by the Plesty team.