Skip to content

Commit 44014b9

Browse files
committed
Merge branch 'master' of github.com:Hamlib/Hamlib
2 parents ad20668 + 9fe15f3 commit 44014b9

File tree

4 files changed

+134
-123
lines changed

4 files changed

+134
-123
lines changed

doc/man1/rigctl.1

Lines changed: 38 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -81,13 +81,15 @@ Use
8181
.I device
8282
as the file name of the port connected to the radio.
8383
.IP
84-
Typically /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0 ,
84+
Typically
85+
.IR /dev/ttyS0 ", " /dev/ttyS1 ", " /dev/ttyUSB0 ,
8586
etc. on Linux,
8687
.IR COM1 ", " COM2 ,
8788
etc. on MS Windows. The BSD flavors and Mac OS/X have their own designations.
8889
See your system's documentation.
8990
.IP
90-
Can be a network address:port, e.g. 127.0.0.1:12345
91+
Can be a network address:port, e.g.
92+
.IR 127.0.0.1:12345
9193
.IP
9294
The special string \(lquh\-rig\(rq may be given to enable micro-ham device
9395
support.
@@ -189,27 +191,27 @@ above. Will exit if no -r is given. Note the dummy device has no serial paramete
189191
Set configuration parameter(s). Some common ones are:
190192
.in +4n
191193
.EX
192-
.RB async: "True enables asynchronous data transfer for backends that support it. This allows use of transceive and spectrum data."
193-
.RB auto_power_on: "True enables compatible rigs to be powered up on open"
194-
.RB auto_power_off: "True enables compatible rigs to be powered down on close"
195-
.RB auto_disable_screensaver: "True enables compatible rigs to have their screen saver disabled on open"
196-
.RB dcd_type: "Data Carrier Detect (or squelch) interface type override"
197-
.RB dcd_pathname: "Path name to the device file of the Data Carrier Detect (or squelch)"
198-
.RB disable_yaesu_bandselect: "True disables the automatic band select on band change for Yaesu rigs"
199-
.RB dtr_state: "ON turns on DTR, OFF turns it off, Unset disables it"
200-
.RB lo_freq: "Frequency to add to the VFO frequency for use with a transverter"
201-
.RB post_write_delay: "Delay in ms between each command sent out"
202-
.RB ptt_share: "True enables ptt port to be shared with other apps"
203-
.RB ptt_type: "Push-To-Talk interface type override"
204-
.RB ptt_pathname: "Path name to the device file of the Push-To-Talk"
205-
.RB ptt_bitnum: "Push-To-Talk GPIO bit number"
206-
.RB retry: "Max number of retry"
207-
.RB rts_state: "ON turns on DTR, OFF turns it off, Unset disables it"
208-
.RB twiddle_timeout: "For satellite ops when VFOB is twiddled will pause VFOB commands until timeout"
209-
.RB twiddle_rit: "Suppress get_freq on VFOB for RIT tuning satellites"
210-
.RB timeout: "Timeout in ms"
211-
.RB write_delay: "Delay in ms between each byte sent out"
212-
.RB tuner_control_pathname: "Path name to a script/program to control a tuner with 1 argument of 0/1 for Tuner Off/On"
194+
.BR async: "True enables asynchronous data transfer for backends that support it. This allows use of transceive and spectrum data."
195+
.BR auto_power_on: "True enables compatible rigs to be powered up on open"
196+
.BR auto_power_off: "True enables compatible rigs to be powered down on close"
197+
.BR auto_disable_screensaver: "True enables compatible rigs to have their screen saver disabled on open"
198+
.BR dcd_type: "Data Carrier Detect (or squelch) interface type override"
199+
.BR dcd_pathname: "Path name to the device file of the Data Carrier Detect (or squelch)"
200+
.BR disable_yaesu_bandselect: "True disables the automatic band select on band change for Yaesu rigs"
201+
.BR dtr_state: "ON turns on DTR, OFF turns it off, Unset disables it"
202+
.BR lo_freq: "Frequency to add to the VFO frequency for use with a transverter"
203+
.BR post_write_delay: "Delay in ms between each command sent out"
204+
.BR ptt_share: "True enables ptt port to be shared with other apps"
205+
.BR ptt_type: "Push-To-Talk interface type override"
206+
.BR ptt_pathname: "Path name to the device file of the Push-To-Talk"
207+
.BR ptt_bitnum: "Push-To-Talk GPIO bit number"
208+
.BR retry: "Max number of retry"
209+
.BR rts_state: "ON turns on DTR, OFF turns it off, Unset disables it"
210+
.BR twiddle_timeout: "For satellite ops when VFOB is twiddled will pause VFOB commands until timeout"
211+
.BR twiddle_rit: "Suppress get_freq on VFOB for RIT tuning satellites"
212+
.BR timeout: "Timeout in ms"
213+
.BR write_delay: "Delay in ms between each byte sent out"
214+
.BR tuner_control_pathname: "Path name to a script/program to control a tuner with 1 argument of 0/1 for Tuner Off/On"
213215
.EE
214216
.in
215217
.IP
@@ -335,7 +337,7 @@ Sets the cookie to be used for remote access security
335337
.
336338
.TP
337339
.BR \-# ", " \-\-skip_init
338-
Skips most startup intialization.
340+
Skips most startup initialization.
339341
.
340342
.TP
341343
.B \-
@@ -701,7 +703,7 @@ and
701703
.IP
702704
Number is 1-based antenna# (\(oq1\(cq, \(oq2\(cq, \(oq3\(cq, ...).
703705
.IP
704-
Option depends on rig..for Icom it probably sets the Tx & Rx antennas as in the IC-7851. See your manual for rig specific option values. Most rigs don't care about the option.
706+
Option depends on rig. For Icom it probably sets the Tx & Rx antennas as in the IC-7851. See your manual for rig specific option values. Most rigs don't care about the option.
705707
.IP
706708
For the IC-7851, FTDX3000 (and perhaps others) it means this:
707709
.IP
@@ -727,7 +729,7 @@ A value of 0 for Antenna will return the current TX antenna
727729

728730

729731
.IP
730-
Option returned depends on rig..for Icom is likely the RX only flag.
732+
Option returned depends on rig. For Icom it is likely the RX only flag.
731733
.
732734
.TP
733735
.BR b ", " send_morse " \(aq" \fIMorse\fP \(aq
@@ -737,6 +739,7 @@ symbols. For Yaesu rigs use memory#1-5 or up to 50 char msg
737739
.EX
738740
Example from command line: rigctl -m 3073 -r /dev/ttyUSB0 b "CQ CQ DE ME"
739741
Yaesu example to send message#1: rigctl -m 1035 -r /dev/ttyUSB0 b 1
742+
.EE
740743
.
741744
.TP
742745
.BR 0xbb ", " stop_morse "
@@ -828,7 +831,7 @@ code.
828831
.BR 0x93 ", " get_dcs_sql
829832
Get
830833
.RI \(aq "DCS Sql" \(aq
831-
code.
834+
code.
832835
.
833836
.TP
834837
.BR N ", " set_ts " \(aq" "\fITuning Step\fP" \(aq
@@ -1138,7 +1141,6 @@ Sets memory channel information
11381141
Get channel memory.
11391142
.IP
11401143
If readonly!=0 then only channel data is returned and rig remains on the current channel. If readonly=0 then rig will be set to the channel requested.
1141-
data.
11421144
.
11431145
.TP
11441146
.BR A ", " set_trn " \(aq" \fITransceive\fP \(aq
@@ -1405,68 +1407,63 @@ Returns current lock mode status 1=On, 2=Off (only useful when using rigctld)
14051407
.
14061408
.TP
14071409
.BR send_raw " \(aq" \fITerminator\fP "\(aq \(aq" \fIString\fP \(aq
1408-
.EX
14091410
Can send ASCII string or 0xnn values or xnn values -- there can be no spaces in the command string.
14101411
Possible terminator values are CR, LF, ;, ICOM, 0-100 (bytes to read), or -1 meaning unknown (will timeout on read)
14111412
Examples (note that a ; must be escaped in Unix/Linux):
1413+
.IP
14121414
For Windows & Unix/Linux we have a new colon-separated format for hex digits
1415+
.EX
14131416
send_raw icom 0xFE:0xFE:0x94:0x03:0xFD Note: colon-separated does not have to be escaped on Unix/Linux
14141417
send_raw -1 0xFE:0xFE:0x94:0x03:0xFD
14151418
send_raw 14 0xFE:0xFE:0x94:0x03:0xFD
14161419
Note that ASCII commands still require escaping the semicolon on Unix/Linux
14171420
send_raw \; FA\;MD\;
1418-
1421+
.EE
14191422
For Windows:
1423+
.EX
14201424
send_raw icom 0xFE;0xFE;0x94;0x03;0xFD
14211425
send_raw -1 0xFE;0xFE;0x94;0x03;0xFD
14221426
send_raw 14 0xFE;0xFE;0x94;0x03;0xFD
1423-
1424-
For Unix/Linux
1427+
.EE
1428+
For Unix/Linux
1429+
.EX
14251430
send_raw icom 0xFE\;0xFE\;0x94\;0x03\;0xFD
14261431
send_raw \; FA\;MD\;
14271432
send_raw -1 0xFE\;0xFE\;0x94\;0x03\;0xFD
14281433
send_raw 14 0xFE\;0xFE\;0x94\;0x03\;0xFD
1434+
.EE
14291435
.
14301436
.TP
14311437
.BR client_version " \(aq" \fIString\fP "\(aq
1432-
.EX
14331438
Client can send its version to rigctld and get feedback on compatibility, deprecation, and alternatives
14341439
.TP
14351440
.BR hamlib_version
1436-
.EX
14371441
Returns hamlib version with ISO8601 date/time
14381442
.
14391443
.TP
14401444
.BR test
1441-
.EX
14421445
Performs test routines. Under development.
14431446
.
14441447
.TP
14451448
.BR set_gpio " \(aq" \fIGPIO#\fP "\(aq
1446-
.EX
14471449
Sets GPIO1, GPIO2, GPIO3, GPIO4 on the GPIO ptt port
14481450
Can also use 1,2,3,4
14491451
.
14501452
.TP
14511453
.BR get_gpio " \(aq" \fIGPIO#\fP "\(aq
1452-
.EX
14531454
Reads GPIO1, GPIO2, GPIO3, GPIO4 on the GPIO ptt port
14541455
Can also use 1,2,3,4
14551456
.
14561457
.TP
14571458
.BR skip_init
1458-
.EX
14591459
Skips rig initialization -- useful when executing commands with rigctl to speed up things
14601460
.
14611461
.TP
14621462
.BR freq_skip " " 'skip'
1463-
.EX
14641463
When skip!=0 skips setting freq on TX_VFO when in RX and on RX_VFO when in TX -- for use with gpredict and rigs that do not have TARGETABLE_VFO
14651464
.
14661465
.SH READLINE
14671466
.
1468-
.SH READLINE
1469-
.
14701467
If
14711468
.B Readline
14721469
library development files are found at configure time,

0 commit comments

Comments
 (0)