Logic Analyzer v0.2


(C) 1997 Nuno Sucena Almeida
DEE @ University of Coimbra - Portugal - Europe
slug@student.dee.uc.pt



Hello, this is a simple Xforms based program which displays the values of
an input port on a graphical display, similar to a Digital Logic Analyzer.
It's my first Xforms & C program released to the general public so be
patient with the several bugs that might arise during use of this
software. I'm not responsible for any damage that this program may cause
to you , your computer, your house , your relatives, your pets or even
your social/sexual life.

			USE AT YOUR OWN RISK!

This program is freeware, you can do with it everything you want but if you
make money some way , related with this program , i want a share.If you use it
on another program please give me credit! If you want you can send me
a $donation$ so i can buy a scope or a post card of your place would be
nice too.

HOW-TO compile the damn thing:

1) Edit the Makefile
	- check where you have installed your Xforms lib & include file
	- change the XFORMS_LIB and XFORMS_INCLUDE accordingly
		( i have both at /usr/local/lib/xforms )
( check at the end of this file where to get a recent version of the
xforms lib - this program needs version 0.86 or greater ! )

2) Edit the util.h file to select the ports . I use 0x300 and 0x31f
because i have a homemade board with 256 In/Out lines.You can only
select the first and the last,ie, a range of ports.Be SURE that the
MIN_PORT is less or equal to MAX_PORT !

3) make ( ignore the warnings, unless it doesn't compile :(  )

4) make install ( it will go to /usr/local/bin by default )

5) try it. ( type analyzer_main ) ( AT YOUR OWN RISK i REPEAT ! )


USAGE:

Run the program.

You have 5 buttons and 2 sliders at your disposal.

Start Button	- Starts the counter ( reading periodicly from input port )
Stop Button	- Stops the Counter ( Use Resume to Continue )
Resume Button	- Resume the Counter
Channels Slider - Selects the number of channels ( bits of a port ) that
		you want to watch
Sampling Period - Selects the amount of time between each port read.

The other buttons are obvious.

Since Linux or xforms are not intended to be used in a real time
application this program is not very precise if your system is overloaded.
My timer is constructed using a xforms timer object as you can see by
examining the source code so it's not very good. I'll change it , but be
patient.I started this program 2 days ago using my spare time...

This program was developed on a 486 Linux 2.0.30 X11R6 3.2 system using
gcc 2.7.2 , xforms 0.86 , libc 5.3.12 , libm 5.0.7 , libX11 6.1 , 
xjed 0.F97.14 , fdesign 0.47
If you can get this program running on a different system please tell me
so i can add it to this file.


You can get the xforms lib from :

   http://bragg.phys.uwm.edu/xforms

or from

ftp://einstein.phys.uwm.edu/pub/xforms
ftp://ftp.cs.ruu.nl/pub/XFORMS (mirror site)
ftp://laue.phys.uwm.edu/pub/xforms (mirror site)
ftp://imageek.york.cuny.edu/xforms  (mirror site)



Any comment , bug reports , opinions, ideas , money :) send to one of
these:

slug@student.dee.uc.pt
slug@student.dei.uc.pt
slug@cygnus.ci.uc.pt

flames go to /dev/null as usual :)


Thanks go to:

         Pedro Rocha ( sewerrat@ThePentagon.com ) who gave me moral
support writing this tiny README file.

         and all the other cool guys that i know here @ Portugal.
