.\" Copyright (c) 2000
.\"	A. Maitland Bottoms
.\"
.Dd December 10, 2000
.Dt HAM 1
.Os Debian
.Sh NAME
.Nm rx320
.Nd control a Ten-Tec RX-320 receiver via serial port
.Sh SYNOPSIS
.Nm rx320
.Op Fl m Ar --mode
.Op Fl b Ar --bandwidth
.Op Fl f Ar --frequency
.Ar /dev/ttyS0
.Nm rx320
.Op Fl v Ar --volume
.Op Fl s Ar --speaker
.Op Fl l Ar --line
.Ar VOLUME
.Ar /dev/ttyS0
.Nm rx320
.Op Fl a Ar --agc
.Ar /dev/ttyS0
.Nm rx320
.Op Fl M Ar --meter
.Ar /dev/ttyS0
.Nm rx320
.Op Fl S Ar --signal
.Ar /dev/ttyS0
.Nm rx320
.Op Fl V Ar --Version
.Ar /dev/ttyS0
.Pp
Maybe substitute your own serial port device instead of
/dev/ttyS0 - but it needs to be given every time.
.Sh INTRODUCTION
.Nm rx320
is a complete implementation of the documented command set
of the Ten Tec RX-320 receiver, allowing easy control from
.Xr \&sh 1
scripts, or any command line environment. Run "rx320 --help"
to see the built-in information, and/or read on...
.Pp
.Bl -tag -width flag
.It Fl m
Detection Mode.
The radio will do AM, USB, LSB and CW.
.It Fl b
Filter bandwidth.
The radio supports 34 different bandwidths between 300 and 8000 Hz.
.It Fl f
Frequency.
Decimal floating point number in kHz.
.It Fl v
Volume.
Sets both line out and speaker out audio levels.
Note: 0 (zero) is loudest, 63 is quiet.
.It Fl l
Set line out volume only.
.It Fl s
Set speaker volume only.
.It Fl a
AGC mode.
The AGC mode can be SLOW, MEDIUM or FAST.
.It Fl S
Reports signal strength.
.It Fl M
Repeatedly report signal strength. Use to make plots vs. time.
.Ar delay
value in seconds to wait between reports.
.It Fl V
Report Firmware version. This program was made for
.Pp
.Dl VER 106
.El
.Ss Setting frequency mode bandwidth
To put the receiver into a valid state, frequency mode and filter bandwidth
need to be given to the 
.Nm rx320
program at the same time.
Other options may or may not be given on the same invocation, but these
three must be used together.
.Pp
.Ss Setting volume
It might be just as well to use -v or --volume with
.Nm rx320
to set both the line out and the speaker out audio levels.
Control freaks will be happy to know that -l or --line
and -s or --speaker options allow levels on these ports to be set
independently.
.Pp
.Ss AGC
The Automatic Gain Control mode can be set to
LOW MEDIUM or FAST.
.Pp
.Ss Signal Strength
The -S or --signal command option returns a decimal value for signal
strength.
.Pp
.Ss Firmware version
If you are at your wits end with this program, check to see if
maybe your radio is the same as mine. Use -V or --Version to report
the radio's firmware version. Mine is VER 106.
.Pp
.Ss Meter
Rather than call this program over and over just to get signal strength,
the -m or --meter option, along with a delay, will run an infinite loop
for you. Not that the delay can be 0 (zero), but you won't get an infinite
number of reports per second because the program still has to talk to the
radio at 1200 baud. Delay factors larger than a minute produce date and
time stamped output. Be careful what you parse this output with!
.Pp
.Ss Debug
There is a -d or --debug which might tell you a little more
about what goes on.
.Pp
.Sh SUMMARY
(Good luck)
.Pp
The receiver only accepts seven basic commands, of which only two
provide and return data.
.Pp
Options can be used in almost any combination.
.Ss frequency
Floating point number, units kiloHertz. Nominal range
0-30000. WWV is at 2500, 5000, 10000,... etc., see if you can hear it.
.Pp
.Ss mode
AM USB LSB CW
- OK, case not important. Oh, and
.Nm rx320
only looks at the first character of the mode parameter
in any case.
.Pp
.Ss bandwidth
Filter bandwidth in Hz.
There are a bunch of factory preset bandwidths.
Specify any positive integer, and you'll get the closest fitting filter.
(Caveat: Attention Hackers! Specifying a 12 Hz filter actually gets you a
2700 Hz filter. The narrowest filter in the radio is 300 Hz, so I used
the numbers 0-33 to select the filters by number.)
.Pp
.Ss volume
Still not hearing anything? Turn up the volume - all the way up to zero!
This value perhaps should be called "audio attenuation" instead, it is
specified by positive decimal integers in the range 0-63, and 63 sounds
like "off" to me.
.Pp
.Ss AGC
This can be one of FAST MEDIUM or SLOW.
OK, so case doesn't matter. Oh, and only the first letter is checked
in any case.
.Pp

.Nm
types
.Dq Li VER 106
and exits.
.Sh EXAMPLE USAGE
Listen to WWV at 10 MHz:
.Pp
.Nm rx320
--frequency=10000 --mode=AM --bandwidth=3000 --volume=0 /dev/ttyS0
.Pp
That's nice. What's the signal strength?
.Pp
.Nm rx320
--signal /dev/ttyS0
.Pp
Hmm. Now try:
.Pp
.Nm rx320
--meter=5 /dev/ttyS0
.Pp
Attention unix nerds:
.Pp
.Nm rx320
-v 63 - > /dev/ttyS0
.Pp
This program uses the GNU libc argp method to handle command line
arguments, which should be familiar to you.
.Sh ENVIRONMENT
.Nm rx320
does not use environment variables.
.Sh FILES
None.
It is up to the user to keep track of state when necessary.
.Pp
.Sh SEE ALSO
.Xr pcrd 1 ,
.Xr tkpcr 1 ,
.Xr sfmike 1 ,
.Xr multimon 1 ,
.Xr mtrg 1 ,
and
.Rs
.Pp
.%T "RX-320 PC-RADIO Programmer's Reference Guide" .
.Re
Rev B. Copyright 1998 Ten-Tec Inc .
.Pp
.Sh HISTORY
An AMRAD (http://www.amrad.org/) project came up where it would
be useful to run radio receivers remotely. It seemed that
.Nm Debian
would be a useful and stable platform to handle dial up
telephone access, control of the radio, and digitizing of
the audio at a remote site.
See
.%T "http://www.amrad.org/projects/lf/"
to see if this really worked.
.Pp
.Sh BUGS
Doesn't do anything with the string sent by the radio upon
power up.
Does not honor or use serial port locking conventions.
Does not share a common syntax to the
.At pcrd
Icom PCR-1000 receiver control program, making common front end
user interfaces harder to write.
.Pp
.\" This bug is no longer:
.\" No man page.