2001-07-20 11:07:51 +00:00
|
|
|
.\" Hey, EMACS: -*- nroff -*-
|
|
|
|
.\" First parameter, NAME, should be all caps
|
|
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
|
|
.\" other parameters are allowed: see man(7), man(1)
|
2008-09-21 19:24:47 +00:00
|
|
|
.TH RIGCTL "1" "September 21, 2008" "Hamlib" "Radio Control Program"
|
2001-07-20 11:07:51 +00:00
|
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
|
|
.\"
|
|
|
|
.\" Some roff macros, for reference:
|
|
|
|
.\" .nh disable hyphenation
|
|
|
|
.\" .hy enable hyphenation
|
|
|
|
.\" .ad l left justify
|
|
|
|
.\" .ad b justify to both left and right margins
|
|
|
|
.\" .nf disable filling
|
|
|
|
.\" .fi enable filling
|
|
|
|
.\" .br insert line break
|
|
|
|
.\" .sp <n> insert n+1 empty lines
|
|
|
|
.\" for manpage-specific macros, see man(7)
|
|
|
|
.SH NAME
|
2004-07-11 11:53:14 +00:00
|
|
|
rigctl \- control radio transceivers and receivers
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B rigctl
|
|
|
|
[\fIOPTION\fR]... [\fICOMMAND\fR]...
|
|
|
|
.SH DESCRIPTION
|
2004-07-11 11:53:14 +00:00
|
|
|
Control radio transceivers and receivers.
|
2007-02-24 20:24:34 +00:00
|
|
|
\fBrigctl\fP accepts \fBcommands\fP from the command line as well as in
|
|
|
|
interactive mode if none are provided on the command line.
|
2001-07-20 11:07:51 +00:00
|
|
|
.PP
|
|
|
|
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
2007-02-24 20:24:34 +00:00
|
|
|
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
|
2001-07-20 11:07:51 +00:00
|
|
|
.\" respectively.
|
2007-02-24 20:24:34 +00:00
|
|
|
Keep in mind that \fBHamlib\fP is BETA level software.
|
|
|
|
While a lot of backend libraries lack complete rig support, the basic functions
|
|
|
|
are usually well supported. The API may change without publicized notice,
|
|
|
|
while an advancement of the minor version (e.g. 1.1.x to 1.2.x) indicates such
|
|
|
|
a change.
|
|
|
|
.PP
|
|
|
|
Please report bugs and provide feedback at the e-mail address given in the
|
|
|
|
REPORTING BUGS section. Patches and code enhancements are also welcome.
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH OPTIONS
|
2007-02-24 20:24:34 +00:00
|
|
|
This program follows the usual GNU command line syntax, with long
|
2001-07-20 11:07:51 +00:00
|
|
|
options starting with two dashes (`-').
|
2007-02-24 20:24:34 +00:00
|
|
|
|
|
|
|
Here is a summary of the supported options:
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-m, --model=id
|
|
|
|
Select radio model number. See model list (use 'rigctl -l').
|
|
|
|
.br
|
|
|
|
NB: \fBrigctl\fP (or third party software) will use rig model 1901
|
|
|
|
when using \fBrpc.rigd\fP.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B \-r, --rig-file=device
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fIdevice\fP as the file name of the port the radio is connected.
|
|
|
|
Often a serial port, but could be a USB to serial adapter. Typically
|
|
|
|
/dev/ttyS0, /dev/ttyS1, /dev/ttyUSB0, etc.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B \-p, --ptt-file=device
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fIdevice\fP as the file name of the Push-To-Talk device using a
|
|
|
|
device file as described above.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B \-d, --dcd-file=device
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fIdevice\fP as the file name of the Data Carrier Detect device using a
|
|
|
|
device file as described above.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B \-P, --ptt-type=type
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fItype\fP of Push-To-Talk device.
|
2008-07-08 16:43:21 +00:00
|
|
|
Supported types are RIG, DTR, RTS, PARALLEL, NONE, overriding PTT type
|
|
|
|
defined in the rig's backend.
|
|
|
|
|
|
|
|
Some side effects of this command are that when type is set to DTR, read
|
|
|
|
PTT state comes from Hamlib frontend, not read from the radio. When set
|
|
|
|
to NONE, PTT state cannot be read or set even if rig backend supports
|
|
|
|
reading/setting PTT status from the rig.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B \-D, --dcd-type=type
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fItype\fP of Data Carrier Detect device.
|
2003-08-17 22:39:07 +00:00
|
|
|
Supported types are RIG, DSR, CTS, CD, PARALLEL, NONE.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2001-12-26 23:34:56 +00:00
|
|
|
.B \-s, --serial-speed=baud
|
2007-02-24 20:24:34 +00:00
|
|
|
Set serial speed to \fIbaud\fP rate. Uses maximum serial speed from rig
|
|
|
|
backend capabilities as the default.
|
2001-12-26 23:34:56 +00:00
|
|
|
.TP
|
2001-09-22 11:49:53 +00:00
|
|
|
.B \-c, --civaddr=id
|
2007-02-24 20:24:34 +00:00
|
|
|
Use \fIid\fP as the CI-V address to communicate with the rig. Only useful for
|
|
|
|
Icom rigs.
|
|
|
|
.br
|
|
|
|
NB: the \fIid\fP is in decimal notation, unless prefixed by
|
|
|
|
\fI0x\fP, in which case it is hexadecimal.
|
2001-09-22 11:49:53 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-L, --show-conf
|
|
|
|
List all config parameters for the radio defined with -m above.
|
2001-12-26 23:34:56 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-C, --set-conf=parm=val[,parm=val]*
|
|
|
|
Set config parameter. e.g. stop_bits=2
|
|
|
|
.br
|
|
|
|
Use -L option for a list.
|
2001-12-26 23:34:56 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-l, --list
|
|
|
|
List all model numbers defined in \fBHamlib\fP and exit.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-u, --dump-caps
|
|
|
|
Dump capabilities for the radio defined with -m above and exit.
|
2002-09-06 14:07:17 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-o, --vfo
|
|
|
|
Set vfo mode, requiring an extra VFO argument in front of each appropriate
|
|
|
|
command. Otherwise, VFO_CURR is assumed when this option is not set.
|
2003-03-27 23:51:52 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-v, --verbose
|
|
|
|
Set verbose mode, cumulative (see DIAGNOSTICS below).
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-h, --help
|
|
|
|
Show summary of these options and exit.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B \-V, --version
|
|
|
|
Show version of \fBrigctl\fP and exit.
|
|
|
|
.PP
|
2008-01-10 03:42:35 +00:00
|
|
|
\fBN.B.\fP Some options may not be implemented by a given backend and will
|
2007-02-24 20:24:34 +00:00
|
|
|
return an error. This is most likely to occur with the \fI\-\-set-conf\fP
|
|
|
|
and \fI\-\-show-conf\fP options.
|
2008-01-10 03:42:35 +00:00
|
|
|
.pp
|
|
|
|
Please note that the backend for the radio to be controlled,
|
|
|
|
or the radio itself may not support some commands. In that case,
|
|
|
|
the operation will fail with a \fBHamlib\fP error code.
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH COMMANDS
|
|
|
|
Commands can be entered either as a single char, or as a long command name.
|
2002-09-06 14:07:17 +00:00
|
|
|
Basically, the commands do not take a dash in front of them on the command
|
2007-02-24 20:24:34 +00:00
|
|
|
line, as the options do. They may be typed in when in interactive mode
|
|
|
|
or provided as argument(s) in command line interface mode.
|
2002-09-06 14:07:17 +00:00
|
|
|
.PP
|
2007-02-24 20:24:34 +00:00
|
|
|
Since most of the \fBHamlib\fP operations have a \fIset\fP and a \fIget\fP method,
|
|
|
|
an upper case letter will be used for \fIset\fP method whereas the
|
|
|
|
corresponding lower case letter refers to the \fIget\fP method.
|
|
|
|
In interactive mode, prepend a backslash to enter a long command name.
|
|
|
|
.br
|
|
|
|
Example: Use "\\dump_caps" to see what this radio can do.
|
2001-07-20 11:07:51 +00:00
|
|
|
.PP
|
|
|
|
Please note that the backend for the radio to be controlled,
|
|
|
|
or the radio itself may not support some commands. In that case,
|
2007-02-24 20:24:34 +00:00
|
|
|
the operation will fail with a \fBHamlib\fP error message.
|
2001-07-20 11:07:51 +00:00
|
|
|
.PP
|
2007-02-24 20:24:34 +00:00
|
|
|
Here is a summary of the supported commands:
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B F, set_freq
|
2002-04-23 21:55:25 +00:00
|
|
|
Set frequency, in Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B f, get_freq
|
2002-04-23 21:55:25 +00:00
|
|
|
Get frequency, in Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B M, set_mode
|
2004-08-08 19:42:59 +00:00
|
|
|
Set mode/passband: AM, FM, CW, CWR, USB, LSB, RTTY, RTTYR, WFM, AMS,
|
2008-01-10 03:42:35 +00:00
|
|
|
PKTLSB, PKTUSB, PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.
|
2004-08-08 19:42:59 +00:00
|
|
|
|
2002-04-23 21:55:25 +00:00
|
|
|
The passband is the exact passband in Hz, or 0 for the default.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B m, get_mode
|
|
|
|
Get mode/passband.
|
|
|
|
.TP
|
|
|
|
.B V, set_vfo
|
2008-01-10 03:42:35 +00:00
|
|
|
Set VFO: VFOA, VFOB, VFOC, currVFO, VFO, MEM, Main, Sub, TX, RX.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B v, get_vfo
|
2002-04-23 21:55:25 +00:00
|
|
|
Get current VFO.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-08-22 23:44:50 +00:00
|
|
|
.B J, set_rit
|
|
|
|
Set RIT, in Hz.
|
|
|
|
.TP
|
|
|
|
.B j, get_rit
|
|
|
|
Get RIT, in Hz.
|
|
|
|
.TP
|
2003-03-27 23:51:52 +00:00
|
|
|
.B Z, set_xit
|
2002-11-28 22:25:46 +00:00
|
|
|
Set XIT, in Hz.
|
|
|
|
.TP
|
2003-03-27 23:51:52 +00:00
|
|
|
.B z, get_xit
|
2002-11-28 22:25:46 +00:00
|
|
|
Get XIT, in Hz.
|
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B T, set_ptt
|
2002-04-23 21:55:25 +00:00
|
|
|
Set PTT, 0 or 1.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B t, get_ptt
|
2002-04-23 21:55:25 +00:00
|
|
|
Get PTT status.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2008-09-21 19:24:47 +00:00
|
|
|
.B get_dcd
|
|
|
|
Get DCD status.
|
|
|
|
.TP
|
2001-07-20 11:07:51 +00:00
|
|
|
.B R, set_rptr_shift
|
2002-04-23 21:55:25 +00:00
|
|
|
Set repeater shift: "+", "-" or something else for none.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B r, get_rptr_shift
|
|
|
|
Get repeater shift.
|
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B O, set_rptr_offs
|
2002-04-23 21:55:25 +00:00
|
|
|
Set repeater offset, in Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B o, get_rptr_offs
|
2001-07-20 11:07:51 +00:00
|
|
|
Get repeater offset.
|
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B C, set_ctcss_tone
|
2002-04-23 21:55:25 +00:00
|
|
|
Set CTCSS tone, in tenth of Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B c, get_ctcss_tone
|
2002-04-23 21:55:25 +00:00
|
|
|
Get CTCSS tone, in tenth of Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B D, set_dcs_code
|
2001-07-20 11:07:51 +00:00
|
|
|
Set DCS code.
|
|
|
|
.TP
|
2002-03-04 13:16:54 +00:00
|
|
|
.B d, get_dcs_code
|
2001-07-20 11:07:51 +00:00
|
|
|
Get DCS code.
|
|
|
|
.TP
|
2008-09-21 19:24:47 +00:00
|
|
|
.B set_ctcss_sql
|
|
|
|
Set CTCSS squelch tone, in tenth of Hz.
|
|
|
|
.TP
|
|
|
|
.B get_ctcss_sql
|
|
|
|
Get CTCSS squelch tone, in tenth of Hz.
|
|
|
|
.TP
|
|
|
|
.B set_dcs_sql
|
|
|
|
Set DCS squelch code.
|
|
|
|
.TP
|
|
|
|
.B get_dcs_sql
|
|
|
|
Get DCS squelch code.
|
|
|
|
.TP
|
2001-07-20 11:07:51 +00:00
|
|
|
.B I, set_split_freq
|
2002-04-23 21:55:25 +00:00
|
|
|
Set TX frequency, in Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B i, get_split_freq
|
|
|
|
Get TX frequency.
|
|
|
|
.TP
|
2003-04-06 18:40:36 +00:00
|
|
|
.B X, set_split_mode
|
2004-08-08 19:42:59 +00:00
|
|
|
Set transmit mode/passband: AM, FM, CW, CWR, USB, LSB, RTTY, RTTYR, WFM, AMS,
|
2008-01-10 03:42:35 +00:00
|
|
|
PKTLSB, PKTUSB, PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.
|
2004-08-08 19:42:59 +00:00
|
|
|
|
2003-04-06 18:40:36 +00:00
|
|
|
The passband is the exact passband in Hz, or 0 for the default.
|
|
|
|
.TP
|
|
|
|
.B x, get_split_mode
|
|
|
|
Get transmit mode/passband.
|
|
|
|
.TP
|
|
|
|
.B S, set_split_vfo
|
|
|
|
Set split mode, 0 or 1, and transmit VFO.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2003-04-06 18:40:36 +00:00
|
|
|
.B s, get_split_vfo
|
|
|
|
Get split mode and transmit VFO.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B N, set_ts
|
2002-04-23 21:55:25 +00:00
|
|
|
Set tuning step, in Hz.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B n, get_ts
|
|
|
|
Get tuning step.
|
|
|
|
.TP
|
2002-09-06 14:07:17 +00:00
|
|
|
.B U, set_func
|
|
|
|
Set func/status:
|
2008-01-10 03:42:35 +00:00
|
|
|
FAGC, NB, COMP, VOX, TONE, TSQL, SBKIN, FBKIN, ANF, NR, AIP, APF, MON, MN,
|
|
|
|
RF, ARO, LOCK, MUTE, VSC, REV, SQL, ABM, BC, MBC, AFC, SATMODE, SCOPE,
|
|
|
|
RESUME, TBURST, TUNER.
|
2002-09-06 14:07:17 +00:00
|
|
|
.TP
|
|
|
|
.B u, get_func
|
|
|
|
Get func status.
|
|
|
|
.TP
|
2001-07-20 11:07:51 +00:00
|
|
|
.B L, set_level
|
2002-04-23 21:55:25 +00:00
|
|
|
Set level/value:
|
2008-01-10 03:42:35 +00:00
|
|
|
PREAMP, ATT, VOX, AF, RF, SQL, IF, APF, NR, PBT_IN, PBT_OUT, CWPITCH, RFPOWER,
|
|
|
|
MICGAIN, KEYSPD, NOTCHF, COMP, AGC, BKINDL, BAL, METER, VOXGAIN, ANTIVOX.
|
|
|
|
SLOPE_LOW, SLOPE_HIGH, RAWSTR, SQLSTAT, SWR, ALC, STRENGTH.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B l, get_level
|
2008-01-10 03:42:35 +00:00
|
|
|
Get level value.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-04-23 21:55:25 +00:00
|
|
|
.B P, set_parm
|
|
|
|
Set parm/value:
|
2008-01-10 03:42:35 +00:00
|
|
|
ANN, APO, BACKLIGHT, BEEP, TIME, BAT, KEYLIGHT.
|
2002-04-23 21:55:25 +00:00
|
|
|
.TP
|
|
|
|
.B p, get_parm
|
|
|
|
Get parm value.
|
|
|
|
.TP
|
2001-07-20 11:07:51 +00:00
|
|
|
.B B, set_bank
|
|
|
|
Set bank.
|
|
|
|
.TP
|
|
|
|
.B E, set_mem
|
|
|
|
Set memory channel number.
|
|
|
|
.TP
|
|
|
|
.B e, get_mem
|
|
|
|
Get memory channel number.
|
|
|
|
.TP
|
|
|
|
.B G, vfo_op
|
2002-04-23 21:55:25 +00:00
|
|
|
Perform VFO operation:
|
2008-01-10 03:42:35 +00:00
|
|
|
CPY, XCHG, FROM_VFO, TO_VFO, MCL, UP, DOWN, BAND_UP, BAND_DOWN, LEFT, RIGHT,
|
|
|
|
TUNE, TOGGLE.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
|
|
|
.B g, scan_op
|
2008-01-10 03:42:35 +00:00
|
|
|
Perform scan operation/channel: STOP, MEM, SLCT, PRIO, PROG, DELTA, VFO, PLT.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-04-23 21:55:25 +00:00
|
|
|
.B H, set_channel
|
|
|
|
Set memory channel data. Not implemented yet.
|
2001-07-20 11:07:51 +00:00
|
|
|
.TP
|
2002-04-23 21:55:25 +00:00
|
|
|
.B h, get_channel
|
2001-07-20 11:07:51 +00:00
|
|
|
Get memory channel data.
|
2002-01-09 23:09:10 +00:00
|
|
|
.TP
|
|
|
|
.B A, set_trn
|
2003-05-03 13:17:25 +00:00
|
|
|
Set transceive mode (reporting event): OFF, RIG, POLL.
|
2002-01-09 23:09:10 +00:00
|
|
|
.TP
|
|
|
|
.B a, get_trn
|
|
|
|
Get transceive mode (reporting event).
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B Y, set_ant
|
2002-11-28 22:25:46 +00:00
|
|
|
Set antenna number (0, 1, 2, ..).
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B y, get_ant
|
2002-11-28 22:25:46 +00:00
|
|
|
Get antenna number (0, 1, 2, ..).
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B *, reset
|
2004-06-06 21:59:54 +00:00
|
|
|
Reset.
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B b, send_morse
|
2004-06-06 21:59:54 +00:00
|
|
|
Send morse symbols.
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B 0x87, set_powerstat
|
2004-06-06 21:59:54 +00:00
|
|
|
Set power status.
|
|
|
|
.TP
|
2008-01-10 03:42:35 +00:00
|
|
|
.B 0x88, get_powerstat
|
2004-06-06 21:59:54 +00:00
|
|
|
Get power status.
|
|
|
|
.TP
|
2008-09-21 19:24:47 +00:00
|
|
|
.B 0x89, send_dtmf
|
|
|
|
Set DTMF digits.
|
|
|
|
.TP
|
|
|
|
.B 0x8a, recv_dtmf
|
|
|
|
Get DTMF digits.
|
|
|
|
.TP
|
2002-01-09 23:09:10 +00:00
|
|
|
.B _, get_info
|
2002-04-23 21:55:25 +00:00
|
|
|
Get misc information about the rig.
|
2002-09-06 14:07:17 +00:00
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B 1, dump_caps
|
2008-01-10 03:42:35 +00:00
|
|
|
Not a real rig remote command, it just dumps capabilities, i.e. what the
|
|
|
|
backend knows about this model, and what it can do. TODO: Ensure this is
|
|
|
|
in a consistent format so it can be read into a hash, dictionary, etc.
|
2007-01-13 16:19:46 +00:00
|
|
|
.TP
|
2008-05-23 14:26:09 +00:00
|
|
|
.B 3, dump_conf
|
|
|
|
Not a real rig remote command, it just dumps a list of all config parameters
|
|
|
|
defined for the radio.
|
|
|
|
.TP
|
2007-02-24 20:24:34 +00:00
|
|
|
.B 2, power2mW
|
|
|
|
Converts a power value in a range of \fI0.0 ... 1.0\fP to the real transmit
|
|
|
|
power in milli-Watts. The \fIfrequency\fP and \fImode\fP also need to be
|
|
|
|
provided as output power may vary according to these values.
|
|
|
|
.TP
|
2007-01-13 16:19:46 +00:00
|
|
|
.B w, send_cmd
|
2008-01-10 03:42:35 +00:00
|
|
|
Send raw command string to rig.
|
|
|
|
.br
|
|
|
|
For binary protocols enter values as \\0xAA\\0xBB
|
|
|
|
|
2007-02-24 20:24:34 +00:00
|
|
|
.SH EXAMPLES
|
|
|
|
Start \fBrigctl\fP for a Yaesu FT-920 using a USB to serial adapter in
|
|
|
|
interactive mode:
|
|
|
|
|
|
|
|
$ rigctl -m 114 -r /dev/ttyUSB1
|
2001-07-20 11:07:51 +00:00
|
|
|
|
2007-02-24 20:24:34 +00:00
|
|
|
Start \fBrigctl\fP for a Yaesu FT-920 using COM1 while generating TRACE output
|
|
|
|
to \fBstderr\fP:
|
2001-07-20 11:07:51 +00:00
|
|
|
|
2007-02-24 20:24:34 +00:00
|
|
|
$ rigctl -m 114 -r /dev/ttyS0 -vvvvv
|
|
|
|
|
|
|
|
Start \fBrigctl\fP for a Yaesu FT-920 using a USB to serial adapter while
|
|
|
|
setting baud rate and stop bits:
|
|
|
|
|
|
|
|
$ rigctl -m 114 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2
|
|
|
|
|
|
|
|
Start \fBrigctl\fP using \fBrpc.rigd\fP and setting the frequency and mode:
|
|
|
|
|
|
|
|
$ rigctl -m 1901 -r localhost F 7253500 M LSB 0
|
|
|
|
.SH DIAGNOSTICS
|
2008-07-08 16:43:21 +00:00
|
|
|
The \fB-v\fP, \fB--verbose\fP option allows different levels of diagnostics
|
2007-02-24 20:24:34 +00:00
|
|
|
to be output to \fBstderr\fP and correspond to -v for BUG, -vv for ERR,
|
|
|
|
-vvv for WARN, -vvvv for VERBOSE, or -vvvvv for TRACE.
|
|
|
|
|
|
|
|
A given verbose level is useful for providing needed debugging information to
|
|
|
|
the email address below. For example, TRACE output shows all of the values
|
|
|
|
sent to and received from the radio which is very useful for radio backend
|
|
|
|
library development and may be requested by the developers.
|
|
|
|
.SH EXIT STATUS
|
|
|
|
\fBrigctl\fP exits with:
|
|
|
|
.br
|
|
|
|
0 if all operations completed normally;
|
|
|
|
.br
|
|
|
|
1 if there was an invalid command line option or argument;
|
|
|
|
.br
|
|
|
|
2 if an error was returned by \fBHamlib\fP.
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH BUGS
|
2003-03-27 23:51:52 +00:00
|
|
|
set_chan has no entry method as of yet, hence left unimplemented.
|
2007-02-24 20:24:34 +00:00
|
|
|
|
2001-09-22 11:49:53 +00:00
|
|
|
This almost empty section...
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH REPORTING BUGS
|
2007-02-24 20:24:34 +00:00
|
|
|
Report bugs to <hamlib-developer@lists.sourceforge.net>.
|
|
|
|
.br
|
|
|
|
We are already aware of the bugs in the previous section :-)
|
|
|
|
.SH AUTHORS
|
|
|
|
Written by Stephane Fillod and the Hamlib Group
|
2001-07-20 11:07:51 +00:00
|
|
|
.br
|
2007-02-24 20:24:34 +00:00
|
|
|
<http://www.hamlib.org>.
|
2001-07-20 11:07:51 +00:00
|
|
|
.SH COPYRIGHT
|
2008-07-08 16:43:21 +00:00
|
|
|
Copyright \(co 2000-2008 Stephane Fillod, Frank Singleton, and the Hamlib
|
2007-02-24 20:24:34 +00:00
|
|
|
Group.
|
2001-07-20 11:07:51 +00:00
|
|
|
.br
|
|
|
|
This is free software; see the source for copying conditions.
|
|
|
|
There is NO warranty; not even for MERCHANTABILITY
|
|
|
|
or FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
.SH SEE ALSO
|
2007-02-24 20:24:34 +00:00
|
|
|
.BR hamlib (3),
|
|
|
|
.BR rpc.rigd (8)
|
2001-07-20 11:07:51 +00:00
|
|
|
|