* cRadio 0.9 (c) Copywrite 1998 Carl van Schaik * * * * Read the web page for more information www.leg.uct.ac.za/cRadio * * * * Author : Carl van Schaik * * carl@leg.uct.ac.za / cvansch@eng.uct.ac.za * * * * I am a second year student at UCT (University of Cape-Town) doing * * electrical engineering *
last modified 19:06, Aug 5 1998
All code except parts of the radio card hardware side were written by hand from scratch. Written with a high level of object orientation and use of SIGNALS & SLOTS using the "qt" librarys. Designed to be able to extend to other radio cards.
(Any new card support / fixes are welcome )
- Installation
-- Make sure your radiocard is in place -- Untar the files in some test dicrectory -- Read INSTALL -- Edit the Makefile -- Compile / use the binary -- Make sure you have the qt librarys installed -- Either use the /dev/audio video 4 linux drivers or
you will need ROOT! to be able to run this program -- Also try to setuid (if you don't want to run as root)
Note that I have just started learning to program in liunx
therefore there may be infinitly many other problems that
I have not foreseen.
Also note that I am running linux 2.1.95. Who knows whether
it will run on anything else.
READ video4linux for the kernel radio/video API
USAGE
Becarefull on first use, the wrong card may be selected!!!
Quick Keys :
[1-9] = Channels
+/- = Volume
<- -> = Tuneing
SPACE = (UN)Mute
CTRL-Q = Quit
Options :
This is a GUI configuration, you figure it out.
About the hardware: RadioTrack Part
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 with two aims in mind:
- One to learn X-windows programming
- and the other because I was fed up with there being
no decent radio card programs for linux
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.
- starting up is slow, performing volume calculations / have to wait
for the card to respond
- Lastly
I must say here that a lot of this documentation was got from Gideon le Grange (legrang@active.co.za or legrang@cs.sun.ac.za) and Frans Brinkman (brinkman@esd.nl) ,and their documentation for xradiotrack 1.1
* * * This is software with ABSOLUTELY NO WARRANTY * * Use it at your OWN RISK. It may be possible to damage * * e.g. hardware or your hearing due to a bug or for other reasons. * * * * I cannont warrant that this program is free of infringement to * * AimsLab or any other third-party patents * * * * Read COPYING for licence agreements (This applies to all files in * * this software) *
Please send me an e-mail if you use this progam. I like to know what people think about my programs. Also report any bugs or problems, thanks.
carl@leg.uct.ac.za / navlrac@hotmail.com
(Carl van Schaik)
http://www.leg.uct.ac.za/cRadio