rigsmtr(1)

1RIGSMTR(1)                  General Commands Manual                 RIGSMTR(1)
2
3
4

NAME

6       rigsmtr - measure S-Meter vs azimuth using Hamlib
7

SYNOPSIS

9       rigsmtr [OPTION]... [time_step]
10

DESCRIPTION

12       rigsmtr uses Hamlib to control a rig to measure S-Meter vs azimuth:
13       It  rotates the antenna from minimum azimuth to maximum azimuth.  Every
14       second or time_step if specified in seconds, it  retrieves  the  signal
15       strength.
16       Azimuth  in degree and corresponding S-Meter level in dB relative to S9
17       are then printed on stdout.
18       To work correctly, rigsmtr needs a rig that could measure S-Meter and a
19       Hamlib  backend  that  is able to get it, mounted on a Hamlib supported
20       rotator.
21
22       Keep in mind that Hamlib is still BETA level software.  A lof of  stuff
23       hasn't  been  tested  thoroughly, and the API may change without publi‐
24       cised notice. Please report bugs and feedback  at  the  e-mail  address
25       given in the REPORTING BUGS section.
26

OPTIONS

28       This  program  follow  the  usual  GNU  command  line syntax, with long
29       options starting with two  dashes  (`-').   A  summary  of  options  is
30       included below.
31
32       -m, --model=id
33              Select radio model number. See model list provided by rigctl.
34
35       -r, --rig-file=device
36              Use device as the file name of the radio to operate on.
37
38       -s, --serial-speed=baud
39              Set  radio  serial speed to baud rate. Uses maximal rig speed as
40              default.
41
42       -c, --civaddr=id
43              Use id as the CI-V address to communicate with  the  rig.   Only
44              for  Icom rigs. NB: the id is in decimal, unless prefixed by 0x,
45              in which case it is hexadecimal.
46
47       -C, --set-conf=parm=val[,parm=val]*
48              Set radio config parameter. See -L option of rigctl for a list.
49
50       -M, --rot-model=id
51              Select radio model number. See model list provided by rotctl.
52
53       -R, --rot-file=device
54              Use device as the file name of the rotator to operate on.
55
56       -S, --rot-serial-speed=baud
57              Set rotator serial speed to baud rate.  Uses  maximal  speed  as
58              default.
59
60       -N, --rot-set-conf=parm=val[,parm=val]*
61              Set  rotator  config  parameter.  See  -L option of rotctl for a
62              list.
63
64       -v, --verbose
65              Set verbose mode, cumulative (BUG, ERR, WARN, VERBOSE, TRACE).
66
67       -h, --help
68              Show summary of options and exit.
69
70       -V, --version
71              Show version of program and exit.
72
73

RETURN VALUE

75       rigsmtr exits with: 0 if all operations went fine; 1 if  there  was  an
76       invalid  command line option or arg; 2 if an error was returned by Ham‐
77       lib; 3 if the rig doesn't have the required capabilities.
78
79

EXAMPLE

81       rigsmtr -m 209 -r /dev/ttyS1 -M 202 > csmtr
82
83       Collect S-Meter readings on a TS850 while an EasycommII rotator makes a
84       full 360°, and record measurements in file csmtr.
85       After completion, csmtr file contains for example the following lines :
86         0 -47
87         30 -40
88         60 -22
89         90 -3
90         120 10
91         150 1
92         180 -11
93         210 -24
94         240 -35
95         270 -42
96         300 -48
97         330 -51
98         360 -49
99
100
101       Result could then be ploted with gnuplot:
102              gnuplot
103              set angles degrees
104              set polar
105              set grid polar 15.
106              unset border
107              unset param
108              set style data line
109              set rrange [-60:60]
110              set xrange [-60:60]
111              set yrange [-60:60]
112              plot "csmtr"
113

AUTHOR

115       Man page written by Stephane Fillod.
116

BUGS

118       Need more testing. Reports are welcome.
119

REPORTING BUGS

121       Report bugs to <hamlib-developer@users.sourceforge.net>.
122

COPYRIGHT

124       Copyright © 2004-2009 Thierry Leconte & Stephane Fillod
125       This is free software; see the source for copying conditions.  There is
126       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
127       PURPOSE.
128