Hamlib/tests/rigsmtr.1

164 wiersze
4.4 KiB
Groff

.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH RIGSMTR "1" "January 5, 2008" "Hamlib"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
rigsmtr \- measure S-Meter vs azimuth using Hamlib
.SH SYNOPSIS
.B rigsmtr
[\fIOPTION\fR]... [time_step]
.SH DESCRIPTION
\fBrigsmtr\fP uses Hamlib to control a rig to measure S-Meter vs azimuth:
.br
It rotates the antenna from minimum azimuth to maximum azimuth.
Every second or \fItime_step\fP if specified in seconds, it retrieves the signal strength.
.br
Azimuth in degree and corresponding S-Meter level in dB relative to S9 are then printed on stdout.
.br
To work correctly, rigsmtr needs a rig that could measure S-Meter and a Hamlib backend that
is able to get it, mounted on a Hamlib supported rotator.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
Keep in mind that \fBHamlib\fP is still BETA level software.
A lof of stuff hasn't been tested thoroughly, and the API may change
without publicised notice. Please report bugs and feedback at
the e-mail address given in the REPORTING BUGS section.
.SH OPTIONS
This program follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
.TP
.B \-m, \-\-model=id
Select radio model number. See model list provided by rigctl.
.TP
.B \-r, \-\-rig\-file=device
Use \fBdevice\fP as the file name of the radio to operate on.
.TP
.B \-s, \-\-serial\-speed=baud
Set radio serial speed to \fBbaud\fP rate. Uses maximal rig speed as default.
.TP
.B \-c, \-\-civaddr=id
Use \fBid\fP as the CI-V address to communicate with the rig.
Only for Icom rigs. NB: the id is in decimal, unless prefixed by \fB0x\fP,
in which case it is hexadecimal.
.TP
.B \-C, \-\-set\-conf=parm=val[,parm=val]*
Set radio config parameter. See -L option of rigctl for a list.
.TP
.B \-M, \-\-rot\-model=id
Select radio model number. See model list provided by rotctl.
.TP
.B \-R, \-\-rot\-file=device
Use \fBdevice\fP as the file name of the rotator to operate on.
.TP
.B \-S, \-\-rot\-serial\-speed=baud
Set rotator serial speed to \fBbaud\fP rate. Uses maximal speed as default.
.TP
.B \-N, \-\-rot\-set\-conf=parm=val[,parm=val]*
Set rotator config parameter. See -L option of rotctl for a list.
.TP
.B \-v, \-\-verbose
Set verbose mode, cumulative (BUG, ERR, WARN, VERBOSE, TRACE).
.TP
.B \-h, \-\-help
Show summary of options and exit.
.TP
.B \-V, \-\-version
Show version of program and exit.
.SH RETURN VALUE
rigsmtr exits with:
0 if all operations went fine; 1 if there was an invalid command line
option or arg; 2 if an error was returned by Hamlib; 3 if the rig
doesn't have the required capabilities.
.SH EXAMPLE
rigsmtr -m 209 -r /dev/ttyS1 -M 202 > csmtr
.br
Collect S-Meter readings on a TS850 while an EasycommII rotator makes a
full 360\(de, and record measurements in file csmtr.
.br
After completion, csmtr file contains for example the following lines :
.br
0 -47
.br
30 -40
.br
60 -22
.br
90 -3
.br
120 10
.br
150 1
.br
180 -11
.br
210 -24
.br
240 -35
.br
270 -42
.br
300 -48
.br
330 -51
.br
360 -49
.TP
Result could then be ploted with gnuplot:
.br
gnuplot
.br
set angles degrees
.br
set polar
.br
set grid polar 15.
.br
unset border
.br
unset param
.br
set style data line
.br
set rrange [-60:60]
.br
set xrange [-60:60]
.br
set yrange [-60:60]
.br
plot "csmtr"
.SH AUTHOR
Man page written by Stephane Fillod.
.SH BUGS
Need more testing. Reports are welcome.
.SH REPORTING BUGS
Report bugs to <hamlib-developer@users.sourceforge.net>.
.SH COPYRIGHT
Copyright \(co 2004-2008 Thierry Leconte & Stephane Fillod
.br
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
.SH SEE ALSO
.BR hamlib (3), rigctl (1), rotctl (1)