Skip to content
forked from rdpoor/rigol-grab

Capture Rigol MSO5074 Oscilloscope display as a .bmp file

License

Notifications You must be signed in to change notification settings

odaki/rigol-grab

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rigol_grab

Capture Rigol MSO5074 Oscilloscope Display as a .bmp file, for MacOS, Linux and Windows

The Rigol MSO5074 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 .bmp file via USB or Ethernet connection, such as this:

Rigol Screen Capture

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 or connect it to your network and note its IP address. Then, in a shell window use these commands for a USB connection:

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

Or use these commands for an Ethernet connection (substitute your Rigol's own IP address):

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

Note that the --auto_view argument will cause the .bmp 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.bmp>: specify the pathname of the saved .bmp file (default: rigol.bmp)
--auto_view: automatically open the .bmp using your system viewer
--port: IP address of the oscilloscope if using Ethernet instead of USB

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 .bmp data is corrupted. If this happens, just re-run the script.
  • There's been zero testing on Linux systems. But it might work.

Support

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

And if the spirit so moves you, please submit pull requests for enhancements.

About

Capture Rigol MSO5074 Oscilloscope display as a .bmp file

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%