rigsmtr (1) Linux Manual Page
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 publicised 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 Hamlib; 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 :
- 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 [at] users.sourceforge.net>.Copyright
Copyright © 2004-2009 Thierry Leconte & Stephane FillodThis is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.