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 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 :
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)