WMAmfm Version 1.1.2
====================
WMAmfm is a WindowMaker dockable app that controls GemTek based radio module
(ex. Justy Radion-maru) attached to a serial port, under Linux.

This program was compiled and tested using the following:
  ELF Linux (kernel version 2.2.9 SMP)
  pgcc-2.91.66

Also take a look at the homepage of WMAmfm:
http://members.xoom.com/ume/amfm.html

Will work with
==============
* Justy Radion-maru(http://www.justy.co.jp/JFM-01.html) 
* Unit Rajikoma(http://www.myshop.co.jp/unita/radio/koma.htm)
* GemTek WIZARD RADIO(http://www.gemtek.com.tw/WIZARD.HTM)
* GemTek RADIOMAN(http://www.gemtek.com.tw/radman.HTM)

FYI, Radion-maru is similar to WIZARD RADIO.
And, Rajikoma and RADIOMAN are just alike. :-)

WMAmfm is not tested with GemTek devices, but probably will work.

Usage
=====
wmamfm [-n] [-v] [-h] [-p [filename]]

options:
-n   turn radio on initially on startup
-v   show version information
-h   deliver usage information
-p   specify rc file name

buttons:
The ^ and v arrow buttons on the top-left are for fine tuning.
Also, pressing button-1 in the freq digit box works as v arrow button does,
and pressing button-2,3 in the box is equal to ^ arrow button.

In the middle-left, there is a two digit box in which currently selected 
preset # will be shown. The < and > arrow buttons on the each side of the box
allow to switch presets.
Also, pressing button-1 in the two digit box works as < arrow button does,
and pressing button-2,3 in the box is equal to > arrow button.

The button with LED on the bottom-left is used to turn your radio ON/OFF.

The button with a box on the bottom-middle is for changing FM/AM.

The slide bar on the right is for increasing/decreasing volume.


WMAmfm initially reads the rc file(~/.wmamfmrc).
When ~/.wmamfmrc doesn't exist, /usr/local/share/wmamfm/system.wmamfmrc is used
instead. 
You can change rc file name by -p option.

Usage part2
===========
wmamfmctl [-n] [-f] [-s [freq]] [-c [freq]] [-v [vol]]

options:
-n   power on
-f   power off
-s   FM tuning (76.0-108.0)MHz
-c   AM tuning (531-1602)kHz
-v   volume (0-100)%

wmamfmctl is a command line interface for wmamfm.
It simply communicates with wmamfm, and controls wmamfm.
So, wmamfmctl does not work without wmamfm running.
All options can be used at once.
If you use conflicting options (-n and -f, -s and -c) at once, 
the latter one precedes the other one.
(ex. if you use "-n -f", -n will be discarded.)

Usage part3
===========
wmamfm -a -p [filename] [-n] 
wmamfmctl -a [-n] [-f] [-s [freq]] [-c [freq]] [-v [vol]]

If you have 2 radio devices and 2 soundcards,
you can run second wmamfm using -a option as above.

Also, you can control the second wmamfm by wmamfmctl -a.

Installation
============
Just type "make", this should create wmamfm.

Then, type "make install" to install wmamfm.
Be sure that you are superuser, when doing this.

You should make a symbolic link to the tty you are going to use.
Type this to make it:
ln -s /dev/ttySX /dev/radio
Also, you must make sure your user has write access to the tty. 

Bugs
====
None known.:)
Any comments and requests are always welcome.

Copyright
=========
This program and documentation is 
Copyright (c) 1998,1999 Atsushi Umeshima<ume@tka.att.ne.jp> 
and being distributed under the GPL2(see COPYING)

Radion-maru is a trademark of Try Corporation (c) 1996
All Rights Reserved.

Rajikoma is a trademark of Unit Corporation (c) 1997
All Rights Reserved.

Warranty
========
There is NO WARRANTY for this program.

Acknowledgment
==============
This code was mainly put together by looking at the Soren's wmtune, 
and Stew Benedict's pcfm. And also uses Chris Radek's pcradio code,
And, Jorge Ventura sent me a patch.
Thanks to all of them.

Author
======
Atsushi Umeshima
ume@tka.att.ne.jp
http://members.xoom.com/ume/index.html
