Skip to main content

Control of DC Power Supplies/DC Electronic Loads/DMMs/SourceMeters through python

Project description

dcps

Control of DC Power Supplies through python

This is intended to be a generic package to control various DC power supplies using various access methods with a common API. It utilizes pyVISA and the SCPI command set. For now, this supports only the following DC power supplies:

  • Rigol DP800 series (tested with DP832A)
  • Aim TTi PL-P series (tested with PL303QMD-P)
    • Aim TTi CPX series (tested by a contributor with CPX400D)
  • BK Precision 9115 series (tested with 9115)
  • Agilent/Keysight E364xA series (tested with E3642A)

These DC power supplies are each part of a series of products. All products within the series that use a common programming language should be supported but only the indicated models were used for development and testing.

As new power supplies are added, they should each have their own sub-package.

Other contributors have added support for the following DC power supplies:

  • ITECH 6500C/D series 2 quadrant DC Power Supply/load

In addition to the above traditional power supplies, a few other instruments have been added that have a similar control paradigm such as current sources, volt meters and, perhaps in the future, source meters that can both source and measure voltages and currents. These all can either source a voltage or current and/or measure a voltage or current. They stub off unused functions so that common scripts can still be created with a common interface and they retain the ability to target any of these instruments. These alternative instruments that are supported are:

  • Keithley/Tektronix 622x series Precision Current Source (tested with 6220)
  • Keithley/Tektronix 2182/2182A Nanovoltmeter (tested with 2182A)
  • Keithley/Tektronix 2400 series SourceMeter (tested with 2400)

Installation

You need to install the pyvisa and pyvisa-py packages.

To install the dcps package, run the command:

python setup.py install

Alternatively, can add a path to this package to the environment variable PYTHONPATH or even add the path to it at the start of your python script. Use your favorite web search engine to find out more details.

Even better, dcps is now on PyPi, so you can simply use the following and the required depedancies should get installed for you:

pip install dcps

Requirements

  • python [Works with 2.7+ and 3+]
    • Python 2 is now officially "end of life" so upgrade your code to Python 3
  • pyvisa 1.9
    • avoid 1.11.0 because it fails to work on Fedora/CentOS/etc.
  • pyvisa-py 0.4.1

With the use of pyvisa-py, should not have to install the National Instruments NIVA VISA driver.

If using the USB communications method, must also install:

Ethernet to GPIB Interface

Several of these devices, such as the Agilent and Keithley models, have no Ethernet or USB interface. To make them easier to access in a lab environment, An Ethernet to GPIB or USB to GPIB interface can be used. The only such interfaces that have been tested so far are:

For the Agilent/Keysight E364xA, both the Prologix and KISS-488 have been tested and work. For the Keithley 622x, 2182 and 2400, only the Prologix interface works. If a TCPIP0 resource string is used for these models, the code automatically determines which device is used. See the code comments for these models to learn more.

WARNING!

Be really careful since you are controlling a power supply that may be connected to something that does not like to go to 33V when you meant to output 3.3V but a bug in your script commanded 33V. That device connected to the power supply may express its displeasure of getting 33V by exploding all over the place. So be sure to do ALL testing without a device connected, as much as possible, and make use of the protections built into the power supply. For example, you can often set voltage and current limits that the power supply will obey and ignore requests by these commands to go outside these allowable ranges. There are even SCPI commands to set these limits, although it may be safer that they be set manually.

Usage

The code is a very basic class for controlling and accessing the supported power supplies. Before running any example, be extra sure that the power supply is disconnected from any device in case voltsges unexpectedly go to unexpected values.

If running the examples embedded in the individual package source files, be sure to edit the resource string or VISA descriptor of your particular device. For many of the packages, an environment variable can be set and used as the VISA resource string.

  • for RigolDP800.py, it is DP800_IP
  • for AimTTiPLP.py, it is TTIPLP_IP
  • for BK 9115, it is BK9115_USB
  • for Keysight E364xA, it is E364XA_VISA
  • for Keithley 622x, it is K622X_VISA
  • for Keithley 2182, it is K2182_VISA
  • for Keithley 24xx, it is K2400_VISA
# Lookup environment variable DP800_IP and use it as the resource
# name or use the TCPIP0 string if the environment variable does
# not exist
from dcps import RigolDP800
from os import environ
resource = environ.get('DP800_IP', 'TCPIP0::172.16.2.13::INSTR')

# create your visa instrument
rigol = RigolDP800(resource)
rigol.open()

# set to channel 1
rigol.channel = 1

# Query the voltage/current limits of the power supply
print('Ch. {} Settings: {:6.4f} V  {:6.4f} A'.
         format(rigol.channel, rigol.queryVoltage(),
                    rigol.queryCurrent()))

# Enable output of channel
rigol.outputOn()

# Measure actual voltage and current
print('{:6.4f} V'.format(rigol.measureVoltage()))
print('{:6.4f} A'.format(rigol.measureCurrent()))

# change voltage output to 2.7V
rigol.setVoltage(2.7)

# turn off the channel
rigol.outputOff()

# return to LOCAL mode
rigol.setLocal()

rigol.close()

Taking it Further

This implements a small subset of available commands.

For information on what is possible with specific commands for the various supported power supplies and related equipment, see:

For what is possible with general power supplies that adhere to the IEEE 488 SCPI specification, like the Rigol DP8xx, see the SCPI 1999 Specification and the SCPI Wikipedia entry.

Contact

Please send bug reports or feedback to Stephen Goadhouse

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dcps-0.8.0.tar.gz (63.2 kB view details)

Uploaded Source

Built Distribution

dcps-0.8.0-py3-none-any.whl (82.9 kB view details)

Uploaded Python 3

File details

Details for the file dcps-0.8.0.tar.gz.

File metadata

  • Download URL: dcps-0.8.0.tar.gz
  • Upload date:
  • Size: 63.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.7

File hashes

Hashes for dcps-0.8.0.tar.gz
Algorithm Hash digest
SHA256 3789755f2da0061cd658971ae5539c7c515cddaacccedf5fae1ebbed4c27291e
MD5 3ef6fcc5ee79cdedc72b2d0f884b4ecb
BLAKE2b-256 337b79014fff8448a46d1ea3fe793b7791de1af1c82815bfc660a50ad90f961f

See more details on using hashes here.

File details

Details for the file dcps-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: dcps-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 82.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.7

File hashes

Hashes for dcps-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 15cb4b96b58ad09649ce66d0a42f6a911ff5c14d7af892d8b04b4b24dd975b4f
MD5 ba829b745a15731678c05cd9573ff7ab
BLAKE2b-256 ea4654686e8824109032d324fd2f10b83c207b63af04d0e64314c8f21369a1d4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page