.\" Copyright 1999 Hansi Reiser (dl9rdz)
.\" May be distributed under the GNU General Public License
.\" "
.TH PSK31SB 1 "26 March 1999" "User's manual"
.SH NAME
PSK31SB \- amateur radio PSK31 modem via soundcard
.SH SYNOPSIS
.B psk31sb
.RI "[-d audiodevice] [-q] [-l] [-x]"
.br

.SH DESCRIPTION
.B psk31sb
blaa blub

.SH COMMAND-LINE
.TP 0.5i
.B -d
specifies the audio device to use. If no device is specified, the
default value 
.I /dev/audio
is used.
.TP 0.5i
.B -q
turns on QPSK mode (default is BPSK)
.TP 0.5i
.B -l
turns on inverted mode. Overrides LSB setting in initialisation file
.TP 0.5i
.B -x
turns on TX-follows-RX-frequency. Overrides TXTRACK setting in
initialisation file


.SH DATA FILES
.B psk31sb
needs its code table 
.B psk31.cod
for varicode coding. The default location for this file is
.I /usr/local/share/psk31/
and can be modified at compile time. If this file
does not exist, psk31sb additionally searches 
the current home and working directory for this file.

.SH CONFIGURATION
.PP
.B psk31sb
searches for its configuration file at the following places:
.PD 0
.TP 0
.B $(HOME)/.psk31
.TP 0
.B $(HOME)/psk31.ini
.TP 0
.B ./psk31.ini
.TP 0
.B /usr/local/share/psk31/psk31.ini
.PD 1
.PP
The configuration file contains lines of the form
.B NAME=NUMBER
and
.B NAME="STRING".
It contains the following entries:
.PD 0
.TP 1i
.B CALL
Operators callsign, used for CW ID

.TP 1i
.B FREQ
Local IF frequency used by the encoder/decoder. The actual PSK31
operating frequency is by 
.I FREQ
Hz above (below for LSB) the frequency setting of your transceiver

.TP 1i
.B LSB
A value of
.I 1
turns on "inverted mode" for LSB operation (significant only for QPSK).

.TP 1i
.B TXTRACK
Setting
.I TXTRACK
to
.I 1
turns on the TX-follows-RX-frequency switch

.TP 1i
.B PASSALL
Setting
.I PASSALL
to
.I 1
turns on the PASSALL flag (display decoder output regardless of the
DCD flag)

.TP 1i
.B MACRO1..9
Defines Macro texts which can be transmitted by the appropriate
function keys F1..F9

.PD 1

.SH HARDWARE INTERFACE
The simpliest way to use PSK31 is to connect input and output of the
soundcard to your transmitter, and to use the TRX's internal VOX for
keying. psk31sb does not yet provide functionality for explicitly
keying the transmitter. It also does not yet control the sound cards
mixer, thus input and output control must be done via an external
audio mixer tool.

.SH USE
This document does not yet contain information on how to use PSK31.
If you are new to PSK31, please have a look at the operation hints
given in MSDOS or Windows software packages for PSK31.

.SH "SEE ALSO"
Currently my PSK31 for Linux/Soundcard is distributed via my personal
amateur radio home page located at
.I http://home.pages.de/~dl9rdz/hamradio/
.PP
Excellent information about PSK31 in generall and lots of PSK31
related software can be found at the official PSK31 homepage,
located at
.I http://bipt106.bi.ehu.es/psk31.html


.SH AUTHOR
psk31sb was written by Hansi Reiser
(Email: Hansi.Reiser@stud.uni-erlangen.de or dl9rdz@amsat.org; 
Amateur Packet Radio: dl9rdz@oe5xbl.#oe5.aut.eu)

It is based on algorithms developed by Peter Martinez G3PLX and based on
the MSDOS software for PSK31 written by Andrew Senior G0TJZ and Peter
Martinet G3PLX.