*** Controlling a Kenwood Transceiver using existing IRLP hardware***
***                Copyright Ken Arck, AH6LE, 2002                ***
*** All rights reserved. All included scripts and binaries may be ***
***                used by Amateurs for Amateur use only.         ***
***     Commercial use permitted by written authorization only    ***
*********************************************************************

This is a work in progress. As such, not everything yet works. As of this release,the following
is working:

*Entering frequencies via DTMF
*Selecting mode (LSB,USB,AM,FM)
*Selection of 3 operating modes - receive only, transceive and off.

Things I am still working on:

*Add voice readback of frequency and command confirmation
*Automatic Antenna Tuner control

**UPDATE 9/9 - Added voice readback of command entry and entered frequency.





HARDWARE REQUIREMENTS
----------------------

*Linux computer running IRLP, having one extra serial port and located at the same physical
location as the HF radio.

*Full-Duplex radio link (this requirement may be changed in the future)



INSTALLATION
------------

1) Log onto your IRLP computer as user "repeater"

2) At the prompt type mkdir /home/irlp/hf

3) Copy all files in the hf directory in the included zip file to /home/irlp/hf

4) Edit your /home/irlp/custom/custom_decode file and add the following lines at the top of 
the file, before all the "if ["$1" lines: (it is highly recommended you make a backup of 
custom_decode first):


touch $HF/dtmf_present
DTMF_STRING=$1
LENGTH=${#DTMF_STRING}


Add the following lines to the end of any existing commands already existing in custm_decode:


if [ "$1" = "A77" ] ; then "$HF"/hf_control receive ; exit 1 ; fi
if [ "$1" = "A78" ] ; then "$HF"/hf_control xmt; exit 1 ; fi
if [ "$1" = "A79" ] ; then "$HF"/hf_control off; exit 1 ; fi
if [ "$1" = "A771" ] ; then "$HF"/hf_control lsb; exit 1 ; fi
if [ "$1" = "A772" ] ; then "$HF"/hf_control usb; exit 1 ; fi
if [ "$1" = "A773" ] ; then "$HF"/hf_control fm; exit 1 ; fi
if [ "$1" = "A774" ] ; then "$HF"/hf_control am; exit 1 ; fi
if [ $LENGTH = "8" ] || [ $LENGTH = "9" ] ; then "$HF"/freq_decode $1 ; exit 1 ; fi

Save the file. You can change the codes used if you so desire - I've chosen the codes shown 
so as to be compatible with my repeater control codes. For example "A77" can be changed to 
whatever you want. Just make certain each code is unique.  One word on the last line:

$LENGTH refers to the total length of the string passed to this file from the IRLP DTMF 
decoding program. Obviously, if your commands differ in length from mine, you will need 
to adjust the values of $LENGTH above. In the above case, the command I use to enter a 
frequency into the radio is A77xxxxx (for 14.195) or A77xxxxxx (for 144.200). So let's 
say your code will be only one digit long as opposed to my 3. Simply change the 
$LENGTH = "8" to $LENGTH = "6" and the $LENGTH = "9" to $LENGTH = "7". You get the idea....

5) Edit your /home/irlp/custom/environment file and add the following line at the very end:

export HF=/home/irlp/hf

Save the file. 

6) Connect a serial cable from your computer's ttyS1 (Com2) to your radio (CAUTION! If your 
radio isn't set up for direct connection to an RS-232 port, you will need a level converter. 
Consult your radio's manual if you have ANY doubt, as you can do serious damage to your radio 
and/or computer.