1RIGSMTR(1) Hamlib Utilities RIGSMTR(1)
2
6 rigsmtr - measure S-Meter vs azimuth using Hamlib
7
9 rigsmtr [-hvV] [-m id] [-r device] [-s baud] [-c id] [-C parm=val]
10 [-M id] [-R device] [-S baud] [-N parm=val] [time_step]
11
13 rigsmtr uses Hamlib to control a radio to measure S-Meter value versus
14 antenna azimuth.
15 It rotates the antenna from minimum azimuth to maximum azimuth. Every
17 second, or time_step if specified in seconds, it retrieves the signal
18 strength. Azimuth in degrees and the corresponding S-Meter level in dB
19 relative to S9 are then printed on stdout.
20 To work correctly, rigsmtr needs a radio that could measure S-Meter and
22 a Hamlib backend that is able to retrieve it, connected to a Hamlib
23 supported rotator.
24 Keep in mind that Hamlib is BETA level software. While a lot of back‐
26 end libraries lack complete radio support, the basic functions are usu‐
27 ally well supported.
28 Please report bugs and provide feedback at the e-mail address given in
30 the BUGS section below. Patches and code enhancements sent to the same
31 address are welcome.
32
34 This program follows the usual GNU command line syntax. Short options
35 that take an argument may have the value follow immediately or be sepa‐
36 rated by a space. Long options starting with two dashes (‘-’) require
37 an ‘=’ between the option and any argument.
38 Here is a summary of the supported options.
40 -m, --model=id
42 Select radio model number.
43 See model list (use “rigctl -l”).
45 -r, --rig-file=device
47 Use device as the file name of the port connected to the radio.
48 Often a serial port, but could be a USB to serial adapter. Typ‐
50 ically /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc. on Linux,
51 COM1, COM2, etc. on MS Windows. The BSD flavors and Mac OS/X
52 have their own designations. See your system's documentation.
53 -s, --serial-speed=baud
55 Set radio serial speed to baud rate.
56 Uses maximum serial speed from radio backend capabilities as the
58 default.
59 -c, --civaddr=id
61 Use id as the CI-V address to communicate with the radio.
62 Only useful for Icom and some Ten-Tec radios.
64 Note: The id is in decimal notation, unless prefixed by 0x, in
66 which case it is hexadecimal.
67 -C, --set-conf=parm=val[,parm=val]
69 Set radio configuration parameter(s), e.g. stop_bits=2.
70 Use the -L option of rigctl for a list of configuration parame‐
72 ters for a given model number.
73 -M, --rot-model=id
75 Select rotator model number.
76 See model list (use “rotctl -l”).
78 -R, --rot-file=device
80 Use device as the file name of the port connected to the rota‐
81 tor.
82 Often a serial port, but could be a USB to serial adapter. Typ‐
84 ically /dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc. on Linux,
85 COM1, COM2, etc. on MS Windows. The BSD flavors and Mac OS/X
86 have their own designations. See your system's documentation.
87 -S, --rot-serial-speed=baud
89 Set rotator serial speed to baud rate.
90 Uses maximum serial speed from rotator backend capabilities as
92 the default.
93 -N, --rot-set-conf=parm=val[,parm=val]
95 Set rotator configuration parameter(s), e.g. stop_bits=2.
96 Use the -L option of rotctl for a list of configuration parame‐
98 ters for a given model number.
99 -v, --verbose
101 Set verbose mode, cumulative (see DIAGNOSTICS below).
102 -h, --help
104 Show a summary of these options and exit.
105 -V, --version
107 Show version of rigsmtr and exit.
108 Note: Some options may not be implemented by a given backend and will
110 return an error. This is most likely to occur with the --set-conf and
111 --rot-set-conf options.
112
114 The -v, --verbose option allows different levels of diagnostics to be
115 output to stderr and correspond to -v for BUG, -vv for ERR, -vvv for
116 WARN, -vvvv for VERBOSE, or -vvvvv for TRACE.
117 A given verbose level is useful for providing needed debugging informa‐
119 tion to the email address below. For example, TRACE output shows all
120 of the values sent to and received from the radio which is very useful
121 for radio backend library development and may be requested by the
122 developers.
123
125 rigsmtr exits with:
126 0 if all operations completed normally;
128 1 if there was an invalid command line option or argument;
130 2 if an error was returned by Hamlib;
132 3 if the radio doesn't have the required capabilities.
134
136 Collect S-Meter readings on a TS-850 while an EasycommII rotator makes
137 a full 360° rotation and record measurements in the file csmtr (typed
138 text shown in bold):
139 $ rigsmtr -m 2009 -r /dev/ttyS1 -M 202 > csmtr
141 After completion the file csmtr contains lines such as:
143 0 -47
145 30 -40
146 60 -22
147 90 -3
148 120 10
149 150 1
150 180 -11
151 210 -24
152 240 -35
153 270 -42
154 300 -48
155 330 -51
156 360 -49
157 The results can be plotted with gnuplot(1):
159 $ gnuplot
161 set angles degrees
162 set polar
163 set grid polar 15.
164 unset border
165 unset param
166 set style data line
167 set rrange [-60:60]
168 set xrange [-60:60]
169 set yrange [-60:60]
170 plot csmtr
171
173 Report bugs to:
174 Hamlib Developer mailing list
176 ⟨hamlib-developer@lists.sourceforge.net⟩
177
179 This file is part of Hamlib, a project to develop a library that sim‐
180 plifies radio, rotator, and amplifier control functions for developers
181 of software primarily of interest to radio amateurs and those inter‐
182 ested in radio communications.
183 Copyright © 2007-2009 Stephane Fillod
185 Copyright © 2018-2020 Nate Bargmann
186 This is free software; see the file COPYING for copying conditions.
188 There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
189 PARTICULAR PURPOSE.
190
192 gnuplot(1), rigctl(1), rotctl(1), hamlib(7)
193
195 Links to the Hamlib Wiki, Git repository, release archives, and daily
196 snapshot archives are available via hamlib.org ⟨http://www.hamlib.org⟩.
197Hamlib 2020-09-09 RIGSMTR(1)