pygpp 0.1.0

A Python abstraction layer for GW-Instek GPP power supplies

pyGPP

pyGPP is a Python Hardware Abstraction Layer (HAL) over SCPI commands using PyVISA for controlling GW-Instek GPP series power supplies. It simplifies automation, allowing you to focus on your test logic rather than looking up raw SCPI command strings.

Supported Models:

• GPP-3060
• GPP-6030
• GPP-3650

Why this library?

• Type-safe API (Enums, Dataclasses) instead of magic strings
• Model-aware validation (prevents sending 70V to a 30V channel)
• Auto-disables outputs on exit/error via context manager
• Returns structured data, not CSV strings

Quick Start

from pygpp import GPP3060, ChannelMode

with GPP3060(address='ASRL3::INSTR') as psu:
    # Example: Using the GPP as an electronic load
    psu.ch1.set_mode(ChannelMode.LOAD_CC)
    psu.ch1.set_current(0.5)  # Sink 0.5A
    psu.ch1.enable()
    data = psu.ch1.measure()
    print(f"Sinking {data.power} W")

Examples

The examples/ directory demonstrates the features in progressive complexity. The plot below was generated using examples/04_python_sequence.py to sweep the load on a GPP-3060 and characterize a buck converter:

Prerequisites

• Hardware: A supported GW-Instek programmable power supply.
• Drivers:
  • GW-Instek USB Driver (not needed in LAN mode)
  • VISA Backend (choose one):
    • NI-VISA (recommended, full-featured)
    • PyVISA-py (pure Python, no binary install): pip install pyvisa-py
• Tooling: uv (optional)

Installation

As a Dependency (for users)

If you want to use pyGPP in your own project, install it directly from PyPI:

pip install pygpp

Try the examples:

git clone https://gitlab.com/samshahrokni/pyGPP.git
cd pyGPP
uv sync --group examples

# Run any example directly:
uv run python -m examples.01_connection_check

For Development (for contributors)

Clone the repository and sync dependencies (automatically fetches Python):

git clone https://gitlab.com/samshahrokni/pyGPP.git
cd pyGPP
uv sync --all-extras
pre-commit install

Notes

• Incomplete Implementation: Not all SCPI commands are implemented. See the GPP Series User Manual for the full command list.