rigol_grab

Capture Rigol DS1054Z Oscilloscope Display as a .png file, for MacOS, Linux and Windows

The Rigol DS1054Z Oscilloscope is a powerful multi-channel tool for the hobbyist and professional alike. It includes a USB port, but there's not much in the way of software support for Linux and macOS systems.

rigol_grab is a cross-platform Python-based script that lets you capture the contents of the Rigol Oscilloscope display to a .png file, such as this:

Setup

The setup process assumes you already have git, Python and pipenv set up on your machine. In a shell window:

> cd <your chosen directory>
> git clone https://github.com/rdpoor/rigol-grab.git
> cd rigol-grab
> pipenv install

Running rigol_grab

First, plug the Rigol 'scope into your computer via USB cable. Then, in a shell window:

> cd <your chosen directory>/rigol-grab
> pipenv shell
> python rigol_grab.py --auto_open

Note that the --auto_open argument will cause the .png file to be opened immediately using the default viewer for your system.

Options

rigol_grab.py accepts command line arguments:

--verbose: print additional information
--filename <filename.png>: specify the pathname of the saved .png file (default: rigol.png)
--auto_open: automatically open the .png using your system viewer

Caveats

There are a few known bugs. Top scientists are investigating these issues and hope to have a fix. Or you can propose a fix with a pull request:

The program always throws an error upon exiting. This appears to be benign.
Once every two or three times, the .png data is corrupted. If this happens, just re-run the script.
There's been zero testing on Linux or Windows systems. But it might work.

Support

Feel free to post issues and feature requests in the Issues section.