oscope - Digital Oscilloscope via Sound Card/ProbeScope/osziFOX/bitscope

Copyright (C) 1996 - 2002 Tim Witham <twitham@quiknet.com>

This program is 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; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it 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

	(see the file COPYING for more details)

Latest official version and more is available at:

		http://xoscope.sourceforge.net/


	SUMMARY:

x*oscope is a digital oscilloscope that uses a sound card (via
/dev/dsp or EsounD) and/or Radio Shack ProbeScope (Cat. No. 220-0310)
a.k.a osziFOX as the signal input.  Either or both devices may be used
simultaneously.  You may find the manual for Radio Shack's ProbeScope
device at: http://support.tandy.com/support_meters/33352.htm

This device is also known as osziFOX and you may be able to get more
information on and pictures of it at: http://www.wtt-germany.com/

Bitscope support is currently under development and is included here
only on an as-is basis.  Basic data capture may work at a fixed rate.
Advanced features such as control and subsampling are not yet
included.  For the latest bitscope development code, please check it
out from CVS on sourceforge.  Bitscope is: http://www.bitscope.com


	NEWS

Has moved to the NEWS file, complete with version history!


	INSTALLATION:

* ./configure

* make

* make install


	WHAT YOU NEED:

LINUX:

A modern Linux distribution should be able to build xoscope from
source as shown above.  If not, all things mentioned here can be found
by a search on http://www.freshmeat.net.

* You will need an audio mixer program to select input source and
  levels.  Examples are "gmix", "xfmix", "xmix", and "aumix".

* You will need "GTK+" to build the X client (highly recommended).

* OR (outdated) you can use "libsx" to build an X client if you don't
  have GTK+.  Last tried with version 2.03.

* You will need "libvga" from the "svgalib" package to build the
  SVGA console version.  You may already have this in /usr/lib.

* You will need "libvgamisc" from the "g3vga" kit to get text on the
  console version (recommended if you use the console version).  You
  only need to make misc/libvgamisc.a then move it to somewhere like
  /usr/local/lib or /usr/lib.

If you have X11 and would like to do simultaneous Spectrum Analysis,
see the file README.f51 for extra optional instructions.  WARNING: I
haven't tried this lately.

DOS:

I never use DOS, so I can't really support it.  But it worked in
version 1.4 and should still work in theory.  Please see Makefile.dos
for more information.


	USAGE:

Please see the man page for instructions on how to use x*oscope.  Also
use the option `-h' to show command-line options, and the `?' key to
show the key help.  If you're interested in doing advanced signal math
at run-time, see the operl and offt.c external math command examples.


	PLATFORMS:

LINUX:

/dev/dsp supported sound card or EsounD & ProbeScope/osziFOX optional

x*oscope was developed specifically for Linux on:

 - Linux kernel 1.2.10	and later on:	2.2.16
 - gcc 2.6.3				gcc 2.96
 - svgalib 1.2.9			1.4.2
 - libsx 1.1				GTK+ 1.2.8
 - SoundBlaster 16
 - ATI Win Turbo 2MB VRAM
 - 32MB RAM				96MB RAM
 - 100 MHz Intel Pentium(R) Processor	Celeron 300A

x*oscope can be ported to other platforms by simply writing display
(gr_*.c) sound card (sc_*.c) and serial port (ser_*.c) connections.


	EXTRA:

If you like to build things, check out the HARDWARE file.


	CREDITS:

Have moved to the AUTHORS file.


	DISCLAIMER:

This was written by me on my own time and equipment.  My employer has
absolutely nothing to do with it.  See also the file COPYING.

Please send any comments, bug reports or suggestions to me:

-- 
Tim Witham <twitham@quiknet.com> a.k.a. <twitham@pcocd2.intel.com>