tdsdump Files

tdsdump version 0.1, Copyright (C) 1999 Jeff Otterson <otterson@mindspring.com>
26 December 1999

DESCRIPTION
-----------

  This software allows you to attach your Tektronix TDS210 Digital Real-Time
Oscilloscope, with the TDS2CM communications module, to your Linux system for
the purposes of capturing the hardcopy output of the oscilloscope for printing.

  This frees you from having to use a dedicated printer for your oscilloscope.

  The 'scope is set up to send an encapsulated Postscript when the "Hardcopy"
button is pressed, tdsdump detects the "%!PS-Adobe" header and "%%EOF" footer
and spools the file to the printer.  On RedHat 6.0, the printer filter detects
the file format and rasterizes the postscript data and prints the hardcopy 
to an attached printer.

  It is possible that the program may work with other devices that output
Postscript or Encapsulated Postscript.

LATEST VERSION
--------------

The latest version of this program can be found at 

http://www.mindspring.com/~otterson/tdsdump/index.html

WARRANTY
--------

tdsdump comes with ABSOLUTELY NO WARRANTY; See COPYING for details.
This is free software, and you are welcome to redistribute it
under certain conditions; See COPYING for 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

USAGE
------
        Optional parameters are :
		 -t input tty      	default /dev/ttyS0
		 -l lpr command    	default lpr -r %s
		 -v print version and exit
		 -h this help screen

NOTES
-----

  The TDS210 must be set up as follows:

  Utility->Options->Hard Copy Setup
    Layout: either LANDSCAPE or PORTRAIT.
    Format: EPSIMAGE
    Port:   RS232

  Utility->Options->RS232 Setup
    Baud:         19200
    Flow Control: Hard Flagging
    EOL String:   CR
    Parity:       None


  Serial Cable Wiring:  

   9 Pin Female                   9 Pin Female

  2 Receive Data <-------------> 3 Transmit Data 
  3 Transmit Data <------------> 2 Receive Data
  5 Signal Ground <------------> 5 Signal Ground
  7 Request to Send <----------> 8 Clear to Send 
  8 Clear to Send <------------> 7 Request to Send
  1 Carrier Detect <------+  +-> 1 Carrier Detect
  4 Data Terminal Ready <-+  +-> 6 Data Set Ready
  6 Data Set Ready <------+  +-> 4 Data Terminal Ready
  9 Ring Indicator (N/C)   (N/C) 9 Ring Indicator

  
  For some reason, the TDS210 takes a minute or two to dump the hardcopy.
I don't know why, but don't start looking for something wrong for two or
three minutes after pressing the hardcopy button.