File	Date	Author	Commit
src	2016-03-20	Matt Reilly	[8a5a3b] added rigol_data
CMakeLists.txt	2016-03-20	Matt Reilly	[4f302c] bumped version number
README	2016-03-20	Matt Reilly	[90ccf5] Added description of rigol_data to README
saved_git_version.txt	2016-03-20	Matt Reilly	[4f302c] bumped version number
version.h.in	2016-03-19	Matt Reilly	[451929] screen dump is now done

Read Me

SCPI_Utils utilities for manipulating SCPI devices via the USBTMC driver

PREREQUISITES
---- 

SCPI_Utils uses the CMake build system.  You will need
a version of cmake that is newer than 3.0.

Boost version 1.48 or later -- current builds are against boost 1.57


INSTALL Quick Start
----

(X.X.X is the version that you just downloaded, 
e.g. SCPI_Utils-X.X.X.tar.gz might be SCPI_Utils-1.0.0_src.tar.gz...)

# unpack SCPI_Utils-X.X.X_src.tar.gz 
tar xzvf SCPI_Utils-X.X.X_src.tar.gz
cd SCPI_Utils-X.X.X_src
mkdir build
cd build
cmake ../
make
make install


HOWTO 
----

Right now there are only two programs that does anything useful: rigol_screen and rigol_data

rigol_screen --device /dev/usbtmc0 myfile.jpg

captures the screen from the Rigol scop on /dev/usbtmc0 and writes it to
myfile.jpg.


rigol_data --device /dev/usbtmc0 mydat.dat

captures the waveform from channel 1 as shown on the screen and dumps it to
a two-column data file.  The first column is the time for the sample in the second column.

rigol_data --device /dev/usbtmc0 --channels 1,2 mydat.dat

will capture the waveforms from both channel 1 and 2.   Y axis for channel 1 is in
column 2 and Y axis for channel 2 is in column 3.

The channels parameter specifies a comma separated list of channels.  The order
of appearance on the command line is used to dictate the order of assignment of columns
in the data file, so

rigol_data --device /dev/usbtmc0 --channels 4,1,2 mydat.dat

will capture the waveforms from channels 1, 2, and 4.   Y axis for channel 4 is in
column 2, Y axis for channel 1 is in column 3, and Y axis for channel 2 is in column 4.