2007-05-21 20:02:57 +00:00
|
|
|
.\" 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)
|
2008-01-05 15:07:26 +00:00
|
|
|
.TH RIGSMTR "1" "January 5, 2008" "Hamlib"
|
2007-05-21 20:02:57 +00:00
|
|
|
.\" 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
|
2008-01-05 15:07:26 +00:00
|
|
|
rigsmtr \- measure S-Meter vs azimuth using Hamlib
|
2007-05-21 20:02:57 +00:00
|
|
|
.SH SYNOPSIS
|
2008-01-05 15:07:26 +00:00
|
|
|
.B rigsmtr
|
|
|
|
[\fIOPTION\fR]... [time_step]
|
2007-05-21 20:02:57 +00:00
|
|
|
.SH DESCRIPTION
|
2008-01-05 15:07:26 +00:00
|
|
|
\fBrigsmtr\fP uses Hamlib to control a rig to measure S-Meter vs azimuth:
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
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.
|
2007-05-21 20:02:57 +00:00
|
|
|
.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
|
2008-01-05 15:07:26 +00:00
|
|
|
is able to get it, mounted on a Hamlib supported rotator.
|
2007-05-21 20:02:57 +00:00
|
|
|
.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
|
2008-01-05 15:07:26 +00:00
|
|
|
.B \-r, \-\-rig\-file=device
|
2007-05-21 20:02:57 +00:00
|
|
|
Use \fBdevice\fP as the file name of the radio to operate on.
|
|
|
|
.TP
|
2008-01-05 15:07:26 +00:00
|
|
|
.B \-s, \-\-serial\-speed=baud
|
|
|
|
Set radio serial speed to \fBbaud\fP rate. Uses maximal rig speed as default.
|
2007-05-21 20:02:57 +00:00
|
|
|
.TP
|
2008-01-05 15:07:26 +00:00
|
|
|
.B \-c, \-\-civaddr=id
|
2007-05-21 20:02:57 +00:00
|
|
|
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
|
2008-01-05 15:07:26 +00:00
|
|
|
.B \-C, \-\-set\-conf=parm=val[,parm=val]*
|
|
|
|
Set radio config parameter. See -L option of rigctl for a list.
|
2007-05-21 20:02:57 +00:00
|
|
|
.TP
|
2008-01-05 15:07:26 +00:00
|
|
|
.B \-M, \-\-rot\-model=id
|
|
|
|
Select radio model number. See model list provided by rotctl.
|
2007-05-21 20:02:57 +00:00
|
|
|
.TP
|
2008-01-05 15:07:26 +00:00
|
|
|
.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.
|
2007-05-21 20:02:57 +00:00
|
|
|
.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
|
2008-01-05 15:07:26 +00:00
|
|
|
rigsmtr exits with:
|
2007-05-21 20:02:57 +00:00
|
|
|
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
|
2008-01-05 15:07:26 +00:00
|
|
|
rigsmtr -m 209 -r /dev/ttyS1 -M 202 > csmtr
|
2007-05-21 20:02:57 +00:00
|
|
|
|
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
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
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
150 1
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
180 -11
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
210 -24
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
240 -35
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
270 -42
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
300 -48
|
|
|
|
.br
|
|
|
|
330 -51
|
|
|
|
.br
|
|
|
|
360 -49
|
2007-05-21 20:02:57 +00:00
|
|
|
|
|
|
|
.TP
|
|
|
|
Result could then be ploted with gnuplot:
|
|
|
|
.br
|
|
|
|
gnuplot
|
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
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]
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
set yrange [-60:60]
|
2007-05-21 20:02:57 +00:00
|
|
|
.br
|
2008-01-05 15:07:26 +00:00
|
|
|
plot "csmtr"
|
2007-05-21 20:02:57 +00:00
|
|
|
.SH AUTHOR
|
2008-01-05 15:07:26 +00:00
|
|
|
Man page written by Stephane Fillod.
|
2007-05-21 20:02:57 +00:00
|
|
|
.SH BUGS
|
2008-01-05 15:07:26 +00:00
|
|
|
Need more testing. Reports are welcome.
|
2007-05-21 20:02:57 +00:00
|
|
|
.SH REPORTING BUGS
|
|
|
|
Report bugs to <hamlib-developer@users.sourceforge.net>.
|
|
|
|
.SH COPYRIGHT
|
2009-02-20 12:26:13 +00:00
|
|
|
Copyright \(co 2004-2009 Thierry Leconte & Stephane Fillod
|
2007-05-21 20:02:57 +00:00
|
|
|
.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
|
2008-01-05 15:07:26 +00:00
|
|
|
.BR hamlib (3), rigctl (1), rotctl (1)
|
2007-05-21 20:02:57 +00:00
|
|
|
|