Manual Reference Pages - RIGSMTR (1)
rigsmtr - measure S-Meter vs azimuth using Hamlib
rigsmtr [OPTION]... [time_step]
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 hasnt 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.
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.
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
doesnt have the required capabilities.
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 :
Result could then be ploted with gnuplot:
set angles degrees
set grid polar 15.
set style data line
set rrange [-60:60]
set xrange [-60:60]
set yrange [-60:60]
Man page written by Stephane Fillod.
Need more testing. Reports are welcome.
Report bugs to <firstname.lastname@example.org>.
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.
|Hamlib ||RIGSMTR (1) ||January 5, 2008 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.