GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RIGSMTR (1)

NAME

rigsmtr - measure S-Meter vs azimuth using Hamlib

CONTENTS

Synopsis
Description
Options
Return Value
Example
Author
Bugs
Reporting Bugs
Copyright
See Also

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)

Search for    or go to Top of page |  Section 1 |  Main Index


Hamlib RIGSMTR (1) January 5, 2008

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.