USER LIBRARY AND EXAMPLE PROGRAMS FOR TALKING TO TEKTRONIX SCOPES
(TDS3000/DPO4000) AND AFG'S USING THE VXI11 RPC (ETHERNET) PROTOCOL
===================================================================

By and (C) Steve D. Sharples, May 2007.

This is a collection of source code that will allow you to talk to Tektronix
scopes (currently TDS3000/DPO4000 series) and Abitrary Function Generators
using the VXI11 protocol, from Linux. It is currently available from:
http://optics.eee.nottingham.ac.uk/tek/

You will also need my vxi11 source, vxi11.tar.gz, currently available from:
http://optics.eee.nottingham.ac.uk/vxi11/

This code, tek.tar.gz, contains a user library (tek_user.c) containing 
functions that perform many of the common tasks that you might want to do with
your scope or AFG, including (at time of writing) grabbing traces from the
scope, loading and saving setups, and uploading arbitrary waveforms to your 
AFG.

There are also a handful of (for me anyway) useful utility programs:
- tgetwf - saves waveforms from the scope, uses our own in-house header
  system. See below about how to load into Matlab (or octave maybe? Not
  tried, to be honest). You will probably want to save your traces in a
  different format - .wf and .wfi files are what we've been using 
  historically, since the old days of orange screen LeCroys.
- tek_save_setup - saves the scope settings in a file
- tek_load_setup - uploads previously-saved scope settings
- tek_afg_upload_arb - upload a binary file to the AFG

In the matlab directory, you will find loadwf.m - this is a very cheesy, badly
written, continually-bodged-over-the-years Matlab script to load in the .wf 
and .wfi files created using tgetwf. There are also a couple of scripts to 
generate arbitrary waveforms, that you can test tek_afg_upload_arb with.

Further reading
---------------
See the README.txt file in the vxi11_X.XX directory.
Have a look at the CHANGELOG.txt file.
There is a license file, GNU_General_Public_License.txt

Compiling
---------
- put vxi11_X.XX.tar.gz and tek_X.XX.tar.gz in the same directory
  (of your choice) (where X.XX are the version numbers)
- tar -xvzf vxi11_X.XX.tar.gz
  (as well as creating a "vxi11_X.XX/" directory, it also creates a symbolic
   link to this directory called "vxi11/" )
- tar -xvzf tek_X.XX.tar.gz
- cd vxi11
- make
- make install (as root, if you want to install vxi11_cmd)
- cd ../tek_X.XX
- make
- make install (as root, if you want to install the utilities described above)

Apologies for cheesy Makefiles and scripts!

License
-------
See GNU_General_Public_License.txt

Fairly obvious. All programs, source, readme files etc are covered by the
GNU General Public License.

These programs are free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; version 2
of the License.

These programs are distributed in the hope that they will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

The author's email address is steve.no.spam.sharples@nottingham.ac.uk
(you can work it out!)

All trademarks and copyrights are acknowledged.