rigsmtr man page on DragonFly
[printable version]
RIGSMTR(1) RIGSMTR(1)
NAME
rigsmtr - measure S-Meter vs azimuth using Hamlib
SYNOPSIS
rigsmtr [OPTION]... [time_step]
DESCRIPTION
rigsmtr uses Hamlib to control a rig to measure S-Meter vs azimuth:
It rotates the antenna from minimum azimuth to maximum azimuth. Every
second or time_step if specified in seconds, it retrieves the signal
strength.
Azimuth in degree and corresponding S-Meter level in dB relative to S9
are then printed on stdout.
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.
Keep in mind that Hamlib is still BETA level software. A lof of stuff
hasn't been tested thoroughly, and the API may change without publi‐
cised notice. Please report bugs and feedback at the e-mail address
given in the REPORTING BUGS section.
OPTIONS
This program follow the usual GNU command line syntax, with long
options starting with two dashes (`-'). A summary of options is
included below.
-m, --model=id
Select radio model number. See model list provided by rigctl.
-r, --rig-file=device
Use device as the file name of the radio to operate on.
-s, --serial-speed=baud
Set radio serial speed to baud rate. Uses maximal rig speed as
default.
-c, --civaddr=id
Use id as the CI-V address to communicate with the rig. Only
for Icom rigs. NB: the id is in decimal, unless prefixed by 0x,
in which case it is hexadecimal.
-C, --set-conf=parm=val[,parm=val]*
Set radio config parameter. See -L option of rigctl for a list.
-M, --rot-model=id
Select radio model number. See model list provided by rotctl.
-R, --rot-file=device
Use device as the file name of the rotator to operate on.
-S, --rot-serial-speed=baud
Set rotator serial speed to baud rate. Uses maximal speed as
default.
-N, --rot-set-conf=parm=val[,parm=val]*
Set rotator config parameter. See -L option of rotctl for a
list.
-v, --verbose
Set verbose mode, cumulative (BUG, ERR, WARN, VERBOSE, TRACE).
-h, --help
Show summary of options and exit.
-V, --version
Show version of program and exit.
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 Ham‐
lib; 3 if the rig doesn't have the required capabilities.
EXAMPLE
rigsmtr -m 209 -r /dev/ttyS1 -M 202 > csmtr
Collect S-Meter readings on a TS850 while an EasycommII rotator makes a
full 360°, and record measurements in file csmtr.
After completion, csmtr file contains for example the following lines :
0 -47
30 -40
60 -22
90 -3
120 10
150 1
180 -11
210 -24
240 -35
270 -42
300 -48
330 -51
360 -49
Result could then be ploted with gnuplot:
gnuplot
set angles degrees
set polar
set grid polar 15.
unset border
unset param
set style data line
set rrange [-60:60]
set xrange [-60:60]
set yrange [-60:60]
plot "csmtr"
AUTHOR
Man page written by Stephane Fillod.
BUGS
Need more testing. Reports are welcome.
REPORTING BUGS
Report bugs to <hamlib-developer@users.sourceforge.net>.
COPYRIGHT
Copyright © 2004-2009 Thierry Leconte & Stephane Fillod
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
SEE ALSO
hamlib(3),rigctl(1),rotctl(1)
Hamlib January 5, 2008 RIGSMTR(1)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|