8.11 Hamlib -- rigctld - table meterhl
piWebCAT has an S meter on receive and five button-selected meter options on transmit.
The five Tx buttons are set up in the buttonshl table.
The meterhl table controls the subsequent repetitive meter reading.
The timing table sets the meter repetition interval
The link between the buttonshl table and the meterhl table is the btnno field values, 61 to 65.
The meterhl table is shown below for my FTdx101D
The are two S meter records (RxA and RXb) and eight Tx meter records (reflected power not available on FTdx101D)
The S meter code values SMTA and SMTB are fixed in code and so must be entered as these
so that the server will recognise them.
The Tx meter code fields are copied to the client at startup and so you can use any code of your choice.
Five of the Tx meters have been assigned to the available five option buttons as shown below
In the meterhl table, these are the items with a non-zero btnno field (ie: 61 to 65 )
Meter table field list:
- rig The current radio - drop down selector (from radios table)
- description Descriptive text- no function
- caption The caption to the left of the slider. Note that this only applies to the central
column of sliders with no adjacent on/off button with identifying caption.
- btnno The sliders's unique, fixed, numeric identifier as discussed earlier.
- code Specified once here. Used in message from client and recognised in server.
- abx If A or B, Client sends Vfo A or B to server. abx allows server to read appropriate meter.
For Tx meters abx = X (not VFO-specific)
- 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 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
We use \send_cmd_rx here because not all the metering levels are supported by rigctld.
- mult Multiplier (default = 1)
- divide Divisor (default = 1) Meter CAT value is scaled by (CAT * mult) / divide
before being optionally modified by the metercal table data.
- usecal Y or N. If Y, then the CAT value is processed by the calibration table.
( 20 point calibration for each meter with linear interpolation between points)
Four of the records in the illustrated table use \send_cmd_rx.
These are explained in the next section : Unsupported commands