NAME
rigswr - measure VSWR vs frequency using hamlib
SYNOPSIS
rigswr [OPTION]... start_freq
stop_freq [freq_step]
DESCRIPTION
rigswr uses Hamlib to control a rig to
measure VSWR vs frequency:
It scans frequencies from start_freq to stop_freq with step
freq_step. For each frequency, it transmits at 25% of total POWER
during 0.5 second in CW mode and read VSWR.
Frequency and corresponding VSWR are then printed on stdout.
To work correctly, rigswr needs a rig that could measure VSWR and a
Hamlib backend that is able to get it.
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 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.
- -p, --ptt-file=device
- Use device as the file name of the Push-To-Talk device
to operate on. This is only needed if the radio doesn't have legacy
PTT control.
- -p, --ptt-type=type
- Use type device as the kind of the Push-To-Talk device
to operate on. Supported types are RIG, DTR, RTS, PARALLEL, NONE.
This is only needed if the radio doesn't have legacy PTT control.
- -C, --set-conf=parm=val[,parm=val]*
- Set config parameter. See -L option of rigctl 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
rigswr 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
rigswr -m 209 -r /dev/tty1 14000000 14350000 50000
> cswr
Scans frequencies between 14MHz and 14.200MHz with 50KHz step on a
TS850 and record VSWR measurements in file cswr.
After completion, cswr file contains the following lines :
14000000 1.50
14050000 1.31
14100000 1.22
14150000 1.07
14200000 1.07
- Result could then be ploted with gnuplot:
-
gnuplot
set data style linespoints
set grid
plot "cswr"
AUTHOR
Man page written by Thierry Leconte & Stephane
Fillod .
BUGS
Depending on keyer/QSK setup, transmits in CW mode may
not be modulated thus giving possibly wrong result. Please report
this situation if it happens.
REPORTING BUGS
Report bugs to <hamlib-developer@users.sourceforge.net>.
COPYRIGHT
Copyright © 2004-2006 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)