NAME
    dpl847 - Doppler correction client for *predict*

SYNOPSIS
    dpl847 -s *satellite* [-h] [-V] [-v *verbose level*] [-o] [-p *predict
    server*] [-l] [-d *serial port*] [-r] [-n] [-f] [-S]

DESCRIPTION
    Doppler correction client for *predict* multi-user satellite tracking
    and orbital prediction program written by John A. Magliacane, KD2BD.
    Simple radio control for Yaesu FT-847 is implemented. The radio needs to
    be set first to the satellite mode. The *dpl847* keeps the receiver
    frequency fixed by tuning the transmit frequency. It can also do Doppler
    correction for both receive and transmit frequencies for a repeater type
    satellite. Other settings need to be done manually from Yaesu FT-847.

OPTIONS
    -s satellite name

    -h display a short help text

    -V print version

    -v verbose level

    -o print information on terminal during satellite pass

    -d serial port, e.g. /dev/ttyUSB0 or /dev/ttyS1

    -p predict server, default is localhost:1210

    -l ask from *predict* list of satellites in database

    -r repeater type satellite

    -n non-inverting mode

    -f log frequencies to a file

    -S simulate serial communication

EXAMPLE
    Correct frequency for AO-51, radio is connected to /dev/ttyUSB0 and
    print Doppler correction during satellite pass:

    dpl847 -s AO-51 -d /dev/ttyUSB0 -r -o

FILES
    If accessible ~/.predict/predict.db can be used to show up- and downlink
    frequencies and modes for satellites with switch -l. You need to edit
    $preddb variable in the script. The up- and downlink frequencies for
    Doppler calculation are also "hardwired" in variables %fup and %fdown.

    The $doplfile points to a file for manual correction of frequency. This
    may be needed if there is offset to the theoretical value or the clock
    is not exactly at right time. You can use this while *dpl847* is
    running, for example -1 kHz correction

    echo -0.001 U > .dopf

    The flag "U" means that the uplink frequency is unlocked. You can lock
    it with flag "L". The frequency is in MHz's.

    The $logfile gives name for a log file to record the used frequencies
    during the satellite pass.

DIAGNOSTICS
    The *dpl847* has been tested with *predict* v2.2.2 and with perl v5.8.0.
    It uses Socket and Getopt::Std perl modules. You may need to adapt the
    script to your environment.

BUGS
    If reception frequency is tuned manually on transceiver during frequency
    correction, the serial communication may be jammed. In this case restart
    the program.

AUTHORS
    The socket communication is based on the predict *demo* client written
    by Rich Parry, W9IF.

    Jaakko Koivuniemi OH7BF, if tod lars ta fb7ho

SEE ALSO
    predict(1), Socket(3pm), Getopt::Std(3pm)