mirror of
https://github.com/Hamlib/Hamlib.git
synced 2024-09-22 02:47:21 +00:00
21c346453a
CAT protocols that don't allow direct addressing of VFOs require that
the "other" VFO be queried or set via a select then get/set then
select back to original or swap then get/set then swap again. When
both frequncy and mode need to be set the sequences can be optimized
if a single funciton is avaiable.
This enhancement adds those single functions rig_set_split_freq_mode()
and rig_get_split_freq_mode() with a default impelementation that
calls the individual rig_{get,set}_split_{freq,mode}() functions. Back
ends can choose to implement an optimized version which is used
instead of the default if present.
Using these functions when an optimized implementation is available
allows the TX VFO's frequency and mode to be set in a single operation
with only one VFO exchange or selection either side of the
operation. Many CAT protocols are very efficient when getting or
setting both frequency and mode and some even combine the two in a
single command.
The letters 'K' and 'k' are used for the rigctl short command name for
these functions.
|
||
|---|---|---|
| .. | ||
| config | ||
| rigctl.test | ||
| testbcd.test | ||
| testfreq.test | ||
| testloc.test | ||
| dumpcaps_rot.c | ||
| dumpcaps.c | ||
| dumpmem.c | ||
| example.c | ||
| listrigs.c | ||
| Makefile.am | ||
| memcsv.c | ||
| memload.c | ||
| memsave.c | ||
| README | ||
| rig_bench.c | ||
| rig_split_lst.awk | ||
| rigctl_parse.c | ||
| rigctl_parse.h | ||
| rigctl.1 | ||
| rigctl.c | ||
| rigctld.1 | ||
| rigctld.c | ||
| rigmatrix_head.html | ||
| rigmatrix.c | ||
| rigmem.1 | ||
| rigmem.c | ||
| rigsmtr.1 | ||
| rigsmtr.c | ||
| rigswr.1 | ||
| rigswr.c | ||
| rotctl_parse.c | ||
| rotctl_parse.h | ||
| rotctl.1 | ||
| rotctl.c | ||
| rotctld.1 | ||
| rotctld.c | ||
| sprintflst.c | ||
| sprintflst.h | ||
| testbcd.c | ||
| testctld.pl | ||
| testfreq.c | ||
| testloc.c | ||
| testrig.c | ||
| testrotctld.pl | ||
| testtrn.c | ||
| uthash.h | ||
You will find in the tests/ subdirectory various programs to exercise
the Hamlib library.
Most of the time, you will have to make sure that the backend for
your rig is loaded by passing the model number of your rig by argument.
If you don't know the number, listrigs can give it to you,
"rigctl --list" will also output something like this:
Rig# Mfg Model Vers.
1 Hamlib Dummy 0.1
105 Yaesu FT-747GX 0.1
210 Kenwood TS-870S 0.1
311 Icom IC-706MkIIG 0.2
1506 Winradio WR-3500 0.6
[etc.]
In any case, you are encouraged to check for correct initialization
by reading the source code, at the begining of the main(). Check also
that the program is setup for your rig path strncpy(my_rig->state.rig_path...
dumpcaps - Output the caps contents of a rig
dumpmem - Dump the memory contents of the rig
listrigs - Condensed list of all the models supported by backends
rigmatrix - Output the HTML table of supported rigs, with .png files for freqs
(Better call 'make rigmatrix.html' which builds the HTML table
and additional information in sup-info subdirectory.)
testbcd - Simple program to test BCD conversion, takes a number as arg.
testfreq - Simple program to test Freq conversion, takes a number as arg.
testrig - Sample program calling common API calls, uses rig_probe
testtrn - Sample program using event notification (transceive mode)
rigctl - Combined tool to execute any call of the API, see man page
rigmem - Combined tool to load/save content of rig memory, see man page
rotctl - Similar to 'rigctl' but for rotators, see man page
rigctld - A simple daemon to process 'rigctl' commands received over a
network socket. Useful for scripting languages or remote access
via an SSH tunnel (unsecure program). See man page.
rotctld - A simple daemon to process 'rotctl' commands received over a
network socket. Useful for scripting languages or remote access
via an SSH tunnel (unsecure program). See man page.
testctld.pl A Perl program to test 'rigctld' and provide some example code.