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.