8.9 Hamlib -- rigctld - table catcodeshl
The following section deals with configuring buttons for those commands that are supported by rigctld.
(Unsupported commands can use \send_cmd_rx which is discussed separately )
rigctld commands are text based and so configuration is similar to the ASCII configuration system.
Prior reading of the section on Database tables - configuration is assumed.
Some reading of ASCII text CAT - configuration would be useful.
catcodeshl is used on the server to communicate with the radio for buttons and frequency.
(None of its data is loaded to the client)
- rig The current radio - drop down selector (from radios table)
Must have same spelling through the tables.
- description Descriptive text- no function
- code The link to the buttons table - your choice unless has fixed function coded in piWebCAT
Note that for frequency reading and setting, the code must be FREQ (hard coded)
- abx A or B if there is pair of entries one for each VFO (eg: Mute RxA, RxB)
X if A or B not relevant. (eg:swap VFOs, Tuner etc ) See also: vx and abx
- readmask The character string used to read from the rig via rigctld.
- setmask The character string used to write to the rig via rigctld.
Contains # which is substituted on button action by the data from buttonshl.
- answermask This is only used for commands not supported by rigctld where we use \send_cmd_rx.
It is the character pattern of the answer and has the same format as in the ASCII system.
See Command masks
Note that catcodeshl may contain either one record (abx = X) or two records (abx = A or B) for each buttonshl
button or group of buttons. This the same in the ASCII, YAESU5 and CIV configuration systems.
See: README - vx and abx
In the above table:
code = SPSW is speech processor on / off
readmask is the command sent to rigctld. ie: \get_func Main COMP
This command is not VF0/receiver-specific, but FTdx101D needs --vfo mode and so the word Main must be
present (as a dummy) in the command string.
The response is a numeric and is handled internally. The answermask field is not used
setmask is \set_func Main COMP #.
The # is substituted by the seton or setoff fields value sent from the buttonshl record in the client.
(or from the nset field fro grouped buttons )
- so we actually sent to rigctld: \set_func Main COMP 0 or \set_func Main COMP 1
Note that the Vox and Speech proc. switching have a single record with abx = X.
and that DNR and NB each have two records (for Main rx and Sub rx) with abx = A and abx = B
See: vx and abx
Note that catcodeshl contains the records for reading and setting VFO frequency.
These must use code=FREQ and abx = A and B.
They are linked internally to piWebCAT's tuner.