ds1054z 0.2.9.1

Python package and software for the Rigol DS1054Z oscilloscope.

This package allows you to connect to your Rigol DS1054Z oscilloscope via Ethernet. It comes with a command line tool as well as with a class to control the scope with your own script.

Installation

The installation is dead simple:

pip install ds1054z[savescreen,discovery]

ds1054z depends on python-vxi11 which should automatically get installed along with itself.

For more information on the installation, please consult the installation section of the package documentation.

Features

• Discovering your scope via mDNS / DNS-SD

• Saving Screenshots (incl. adjustable dimming of on-screen controls)

• Running / stopping the scope

• Acquiring waveforms

• … more to come!

Usage

Command Line Tool

This package installs a versatile command line (CLI) tool called ds1054z. You can use it to save the screen of your scope, for example:

ds1054z \
  --save-screen 'default' --overlay 0.3 \
  192.168.0.23

As a result, a file like this will be saved to your current working directory:

oscilloscope screenshot

Find out more ways to use the CLI tool with ds1054z --help

Developers

If you’re into Python programming, use the DS1054Z class in your own code:

from ds1054z import DS1054Z

scope = DS1054Z('192.168.0.23')
print("Connected to: ", scope.idn)

print("Currently displayed channels: ", str(scope.displayed_channels))

Author

• Philipp Klaus

  [e-mail]

Resources

• This Python package was inspired by DS1054Z_screen_capture.

• The device discovery built into this software is largely based on this code by MerseyViking / GeoSpark.

• There is a Qt4 based GUI interface for the scope called DSRemote.