README for xradiotrack V.1.1
****************************


from : Frans Brinkman (brinkman@esd.nl)

date : 1 May 1996
version : 1.1 

Changes from 1.O:

	Added scanning, mute button, general code cleanup
	Same hardware also sells as "Radio Reveal" in some countries
        A "Trust' (?) radio seems remarkably similar, may work.
	
Warning :

        Please read the installation section and the radio.conf file
        before proceeding. Wrong port base setting may interfere
        with other hardware.

For V1.1 the .tgz file should contain the following files :

Makefile         : use as is or modify as required
README           : this file
commondefs.h     : general includes
config.h         : flex source and include
config.l
radio.conf       : sample, should go into /etc with read for all
                   MODIFY to suit your own taste!
                   It should be forward compatible with Gideon La Grange's
                   commandline version, but xradiotrack will allow some
                   characters in the stationnames, like '-'.
xcard.c          : code wich talks to the card
xpriv.c          : code for handling privileges
xpriv.h
xradioinit.c     : mostly initialisation code
xradioinit.h
xradiotrack*     : executable (ELF as from V 1.1), usually in /usr/local/bin
xradiotrack.c    : mainline code
xradiotrack.h
xrt.xpm          : icon, tested with fvwm
                   usually goes to /usr/X11R6/include/X11/pixmaps/xrt.xpm
                   modify fvwm rc file to use it.

Installation :

   - make sure your radiocard is in place
   - untar files in test directory
   - Need root privileges for now
   - read and edit radio.conf as required, note the port address!
   - move files to user directories as per above, set protection if required

Usage : should be self-evident.

Compiling:

   - compiled/tested using linux 1.2.13 (slackware) and gcc 2.7.0,
     but should work with earlier versions.
   - I attempted to use bog-standard X stuff only, so should
     (hopefully) work with Motif etc. as well.


About the software and the hardware:

First:

Thanks to Gideon le Grange (legrang@active.co.za or legrang@cs.sun.ac.za)
who put his command line version of radiotrack free on the net. I've used
lots of his code, mainly added the X-stuff.

So (hope Gideon doesn't mind) I might as well go the whole way and copy
part of his readme file as well:


About the hardware

This software was written to control the AIMS Lab RadioTrack 
FM Stereo Radio Card. The Card is an 8-bit ISA card. For 
programming information take a look at card.c 

The author acknowledges all rights of AIMS Lab which he has been able
to understand.

From the bottom of the RadioTrack box: 

"(c) 1994 AIMS Lab, Inc. ALL RIGHTS RESERVED. AIMS Lab, the AIMS 
 Lab logo and RadioTrack are trademarks of AIMS Lab, Inc. All other
 trademarks and registered trademarks are those of their respective 
 companies."
 

About the software

I wrote this software because I wanted to control my RadioTrack card
from Linux. 

THERE IS NO WARRANTY ON THIS SOFTWARE OR ANY FILES CONTAINED IN THE
ARCHIVE AT ALL AND THE AUTHOR IS NOT RESPONSIBLE IF YOU OR OTHERS
SUFFER IN ANY WAY DUE TO THE USE OR MISUSE OF THE SOFTWARE.


End of quotes, all this applies to this program as well. Like Gideon,
I was unable to get any usable reaction from the manufacturers.

The source is hereby released, please acknowledge Gideon le Grange and
myself if you use any part of it.

For V1.1 thanks to Alberto Vignani (alberto.vignani@torino.alpcom.it) for
tracing the scanning mode.

known problems/limitations:

     - The program cannot reliably check whether hardware is present
       or it's status, so it'll run happily with no radiocard present
       at all. In this case it might interfere with hardware using
       I/O registers at 0x20c or 0x30c.
     - user may run multiple copies, no locking. This is intentional for now.
     - after quit/restart program forgets what station was tuned, if
       any. That's because I cannot read it back from the card as
       far as I know, and also would not be sensible if I don't lock
       out a second copy of the program.
     - remote use is possible, this is intentional.

general:

     Comments to brinkman@esd.nl please.