KG0CQ's 'yaesu' program.  v.13 README file.

On 28-Jul-04 Mr. Donn Washburn, N5XWB, provided me with some updates to the
code to work on recent Linux machines.

Updated 20-Sep-98 to include new copying policy and other minor documentation
modifications.

-----------------------
Overview:

This is my program to control a Yaesu FT-890 HF transceiver via its CAT port
and an RS-232C (com port) on your computer.  Please see the bugs list, 
disclaimer and copying section below.  I wrote it to learn some C and hoped
someone would use it to build a GUI since it is function based.  The code is
probably dirty, but it works!  Functionality is broad, but the user interface
is lacking.
I can envision using this program, or some derivation thereof, to remotely
control a transceiver with streaming audio for a remote base and/or cross band
repeater of some sort (within the rules governing the amateur service).

-----------------------
Installation and Usage:

First you need to get a level converter so that your computer's RS-232C signals
can be read by your 890's TTL circuit.  You have one of many options to pursue
in order to achieve this, I will mention two.  
	One:  Purchase Yaesu's ~$100 FIF-232C box (not recommended for the
              money conscious).  
	Two:  Make one.  You can look in the February 1993 QST, page 37.
	      Here you will find a VERY simple one to build for less than
	      $10.
I use option two, it is cheap and I can always appreciate a circuit that I
built myself (especially if it works too!).  Once you have the box, connect it
as per the instructions included (some com port to the 6-pin mini din on the
transceiver's rear).  You HAVE to know what com port your box is on, be sure
to make a note of it.  Off to usage...

Using my program is very simple, to execute it you must provide the com port
as an argument to the command line.  Remember, com1 is /dev/ttyE0 and com2 
is /dev/ttyE1, etc.  As an example, my box is on com4 (/dev/ttyE3), so I must
type in the following...

		'yaesu 3'

where 3 represents com4.

If you need to use a different device, you can specify that with -p serial_device,
for example:

	yaesu -p /dev/ttyC1

Once you have gotten this far with the correct port,
the program's menu should guide you along.  Please see the bug list, disclaimer
and copying section below.

If you would like to recompile the binary, just type 'make'.

-----------------------
Copying:

Previously this program had some restrictions, however the following policy
supercedes any previously published:

The program and it's associated source code is placed in the public domain.
Do whatever you want with it.  If you decide to continue work on this program
or use it's source as part of something else, please be considerate and
acknowledge any of my work.

-----------------------
Disclaimer:

	The author is not responsible for any consequences resulting from 
	  the usage of this program, whether undesired or otherwise.  
	The user uses the program solely at his/her risk.
	The author is under no obligation to provide support, maintenance,
	  updates, or modifications.
	Anything else I am forgetting. :)

-----------------------
Bugs (To do list):

Each function must check to see if the radio is in a suitable to mode to 
	execute itself fully (tx has been taken care of, I think).
Check to see if ptt will report high SWR.
CLAR will only toggler CLAR off when in memory mode because the data record
	only returns what is set in memory, NOT the display.
CLAR will not set clarifier offset, don't know why.  Yaesu's fault? 
Test the tuner functions, do not have one.
The vfo tuning should be steppable via the keyboard (arrows even).
Memory saving feature does not work, file opening/closing problems.
There should be a file to parse that has frequencies the user wants
	to scan.
Possibly a "yank freq/mode etc" to be part of a logging database.
Use meter_rd hex output to convert to S meter reading.

And many more to come I am sure.

-----------------------

Enjoy my program, this is why it was written.  Hope to catch you on the air!!

	Emarit Ranu  KG0CQ
	email:       kg0cq@ampr.org
