DS1054Z_screen_capture

'OscScreenGrabLAN.py' is a Python script that captures whatever is displayed on the screen of a Rigol DS1000Z series oscilloscope.

It can save data as a WYSIWYG (What You See Is What You Get) picture of the oscilloscope screen, or as a text file in CSV (Comma Separated Values) format.

To achieve this, SCPI (Standard Commands for Programmable Instruments) are sent from the computer to the oscilloscope, using the LXI (LAN-based eXtensions for Instrumentation) protocol over a Telnet connection. The computer and the oscilloscope are connected together by a LAN (Local Area Network). No USB (Universal Serial Bus), no VISA (Virtual Instrument Software Architecture), no IVI (Interchangeable Virtual Instrument) and no Rigol drivers are required. Python 2 is required. Python 3 is not supported.

Tested with Windows 10, Python 2.7.12, pillow and Rigol DS1104Z (a fully upgraded DS1054Z oscilloscope). Tested with Linux Ubuntu 16.04.1, Python 2.7.12 and pillow.

User Manual:

This program captures either the waveform or the whole screen of a Rigol DS1000Z series oscilloscope, then save it on the computer as a CSV, PNG or BMP file with a timestamp in the file name.

The program is using LXI protocol, so the computer
must have LAN connection with the oscilloscope.
USB and/or GPIB connections are not used by this software.

No VISA, IVI or Rigol drivers are needed.

Installation:

Installation on a clean Windows 10 machine
    1. download and install Python 2.7.12 from https://www.python.org/downloads/
	2. to install pillow, open a Command Prompt and type
	    pip install pillow
	3. download and unzip 'DS1054Z_screen_capture-master.zip' from https://github.com/RoGeorge/DS1054Z_screen_capture
	4. connect the oscilloscope to the LAN (in this example, the oscilloscope have fix IP=192.168.1.3)
	5. in the Command Prompt, change the directory (CD) to the path were 'OscScreenGrabLAN.py' was un-zipped
	    cd path_where_the_OscScreenGrabLAN.py_was_unzipped
	6. to run the OscScreenGrabLAN.py in the Command Prompt, type
	    python OscScreenGrabLAN.py png 192.168.1.3
		
Installation on a clean Ubuntu 16.04.1
    1. Python is already installed in Ubuntu 16.04.1 desktop
    2. to install pillow, open a Terminal and type:
	    sudo add-apt-repository universe
		sudo apt-get update
		sudo apt-get install python-pip
		pip install pillow
	3. download and unzip 'DS1054Z_screen_capture-master.zip' from https://github.com/RoGeorge/DS1054Z_screen_capture
	4. connect the oscilloscope to the LAN (in this example, the oscilloscope have fix IP=192.168.1.3)
	5. in the Terminal, change the directory (CD) to the path were 'OscScreenGrabLAN.py' was un-zipped
	    cd path_where_the_OscScreenGrabLAN.py_was_unzipped
	6. to run the OscScreenGrabLAN.py in the Terminal, type
	    python OscScreenGrabLAN.py png 192.168.1.3			

Other usages syntax:

python OscScreenGrabLAN.py png|bmp|csv oscilloscope_IP

Usage examples:

python OscScreenGrabLAN.py png 192.168.1.3
python OscScreenGrabLAN.py csv 192.168.1.3