BonBear/open-ps3005d

Open-source control software for the Velleman PS3005D programmable lab power
supply (0–30 V / 0–5 A, USB/RS232) on Windows and Linux: a desktop app with live
graphs, a command-line tool, and an MCP server so an AI agent can drive the supply
while testing hardware.
## Features
Live readout and graphs of voltage, current and power, with max values since
the last reset, CSV export and continuous CSV logging.
Setpoints applied immediately, output on/off, OCP and OVP.
Memories M1–M5: read, recall and store, without interrupting a running output.
Step sequences: voltage / current limit / duration steps, repeated N times or
until stopped; load/save as CSV or import the vendor app's step table.
AI control over MCP, either standalone (ps3005d-mcp, stdio) or hosted by the
GUI over local HTTP with a key, so you can watch the graphs and stop at any time while
the AI works. Operator-set limits that the AI cannot raise.
English, Swedish and German user interface.
Built-in simulator to try everything without hardware.
Workarounds for the firmware quirks found while testing a real unit (see below).
## Supported hardware
Developed and verified against a Velleman PS3005D (IDN? → VELLEMANLABPS3005DV2.0)
over USB. The PS3005D speaks the Korad KA3005P command set, so similar single-channel
Korad/Tenma/RND supplies will probably work too, but they have not been tested.
## Installation
### Windows: ready-made programs (no Python needed)
Download open-ps3005d- -windows-x64.zip from the
latest release, unzip it
anywhere and start ps3005d-gui.exe. The folder also contains ps3005d.exe (command
line) and ps3005d-mcp.exe (MCP server).
The programs are not code-signed yet, so the first start shows "Windows protected your
PC": choose More info → Run anyway. The supply appears as a COM port with the driver
built into Windows 10/11.
### With Python (Windows and Linux)
Requires Python 3.11 or newer. The package is not on PyPI yet; install it from GitHub:
bash
pip install "ps3005d[gui] @ git+https://github.com/BonBear/open-ps3005d"
The gui extra includes the MCP server. For the CLI and the standalone MCP server only,
use ps3005d[mcp]; for just the CLI, plain ps3005d.
Windows: start the app with ps3005d-gui.
Linux: the supply appears as /dev/ttyACM0. Your user needs to be in the dialout
group. Optionally install docs/udev/99-ps3005d.rules; it
stops ModemManager from probing the supply and adds a stable /dev/ps3005d link.
## Desktop app
bash
ps3005d-gui # choose the port in the window
ps3005d-gui --port /dev/ttyACM0 --connect # or COM3 on Windows
ps3005d-gui --sim --connect # simulator with a 10 Ω load
ps3005d-gui --lang de # en, sv or de (also in the Language menu)
Voltage and current limit are sent as soon as you change them (arrows, or Enter after
typing). The mouse wheel only acts on a field that has focus.
Memories are read when you connect (with the output off). Recall sets the stored
values directly, so a running output is not interrupted. The supply can only store a
memory with the output off, so a Store with the output on is written as soon as you
switch the output off, and the label says so until then.
Closing the window switches the output off, unless you uncheck Output off on exit.