KCTT driver by F6FBB
====================

To use the Kansas-City Tracker/Tuner board, you first have to patch the kernel
and then compile a new one. I shall not describe how to compile a kernel here.
It has already been documented.

To patch the kernel, you need :

1/ Install a clean source kernel version 2.2.13

2/ Goto /usr/src

3/ Run the command :
   zcat kctt_distrib_path/patch/kct0_02-2.2.13-patch.diff.gz | patch -p0
   
4/ Goto /usr/src/linux

5/ Run make menuconfig (or make xconfig under X11)

6/ Select "Character devices"

7/ At the end of the list, select "m" or "y"

8/ Make other needed configuration

9/ Save and quit the Linux Kernel Configuration

10/ Compile the kernel.

When the kernel is successfully compiled install it. Compile the modules and
install them if needed.

You now need to create the devices.

run :

mknod /dev/kctt0 c 190 0
mknod /dev/kctt1 c 190 1


KCTT Applications by F6FBB
==========================

3 applications are provided :

- kctcal : Gives the values of the A/D converters for an antenna position.
  Mainly for test purpose and to calibrate the value/degree conversion.
  
- rotord : daemon which receives the position and frequency requests from the
  satellite tracking software (predict for instance) and interfaces the driver.
  
- rotor : sets the rotor postition

- tuner : sets the frequency of a rig.


Rotor calibration
-----------------

Copy rotor.conf to /etc/ax25 directory

Edit rotor.conf

Run kctcal. If you get "Cannot open kctt0", you certainly did not load the
module or create the device.

--
in the [CALIBRATION] part of the file do :

Put the azimuth rotor to the left limit. 
Put the position of the rotor to AZIMUTH_ORIGIN
Put the value given by kctcal to AZIMUTH_MIN (should be near 0)

Put the azimuth rotor to the right limit
Put the value given by kctcal to AZIMUTH_MAX (should be near 255)

Put the antenna Horizontal (0 degree)
Put 0 to ELEVATION_ORIGIN
Put the value given by kctcal to ELEVATION_MIN (should be near 0)

Put the position of the elevation rotor at 180 degrees
Put the value given by kctcal to ELEVATION_MAX (should be near 255)

--
in the [PARK] part give the values you want for the antenna parking

--
The other parts of the file are the parameters specific to satellites. The name
of the satellite within bracket MUST be the one given by the tracking program
(predict for instance).

Today, only ICOM tranceivers are supported.

--
Save the file and abort kctcal. The rotor is now ready for use.


Tests
-----

The rotord daemon receives commands and execute them. Commands may be sent by an
application such as tracker, tuner or a satellite tracking program such as
predict.

By default rotord parks the antennas when the connection of the application
ends. This can be disabled by the "-n" (nopark) option.

The option "-v" (verbose) makes the daemon writting to the current message log.

Giving two "-v" makes it more verbose (Warning, it is very verbose !)

Sending a SIGHUP to the daemon reloads the configuration file

--
the kctpos application asks rotord to set an azimuth and elevation position. The
"-v" (verbose) option displays the rotors position.

--
the kctfreq application sets a rig to the given frequency

