Buttons

Hamlib

The following buttons allow to control a radio through the Hamlib network protocol (model #2). To enable those buttons you need to provide the --hamlib command line parameter with a hostname and port number of the rigctld server you want to control, e.g. --hamlib=192.168.1.44:4532.

hamlib.SetMode

This button sets the mode of your TRX. It shows a label and indicates if the corresponding mode is active. A long-press on this button sets the current VFO to the center of the band section corresponding to the button's mode, according the IARU Region 1 bandplan.

Example:

{
  "type": "hamlib.SetMode",
  "index": 9,
  "mode": "PKTUSB",
  "label": "DataU"
}

The label property is optional. If it is omitted, the button shows the corresponding mode instead.

hamlib.ToggleMode

This button toggles between two modes. It shows two labels. The label of the currently selected mode is rendered with a larger font. If one of both modes is currently active, the button is rendered inverted. A long-press on this button sets the current VFO to the center of the band section corresponding to the button's selected mode, according the IARU Region 1 bandplan.

Example:

{
  "type": "hamlib.ToggleMode",
  "index": 10,
  "mode1": "LSB",
  "label1": "L"
  "mode2": "USB",
  "label2": "U"
}

The label1 and label2 properties are optional. If they are omitted, the button shows the corresponding mode instead.

hamlib.Set

This button allows to send a command to the rigctld server, for example \vfo_op BAND_UP to switch to the next band upwards.

Example:

{
  "type": "hamlib.Set",
  "index": 12,
  "label": "Band▴",
  "command": "vfo_op",
  "args": ["BAND_UP"]
},

The command property contains the extended name of the command, the args property takes an array of arguments. For more details about the Hamlib commands, see man rigctl(1).

hamlib.SwitchToBand

This button uses the Hamlib commands vfo_op BAND_UP and vfo_op BAND_DOWN to switch to a specific band. Those commands are not supported for all radios.

Example:

{
  "type": "hamlib.SwitchToBand",
  "index": 0,
  "band": "80m"
}

hamlib.SetPowerLevel

This button allows you to set the power level of your TRX to a specific value.

Example:

{
  "type": "hamlib.SetPowerLevel",
  "index": 13,
  "label": "10W",
  "value": 0.1
}

The content of the value property depends on your radio. To find the correct values, manually set the output level and then retrieve the value using rigctl -m <your radio model number> [whatever options you need to connect to your radio] RFPOWER

hamlib.MOX

This button switches between transmitting and receiveing ("manuall operated transmit"). It indicates the transmitting mode by flashing.

Example:

{
  "type": "hamlib.MOX",
  "index": 31
}

hamlib.SetVFO

This button switches to a specific VFO.

Example:

{
  "type": "hamlib.SetVFO",
  "index": 16,
  "label": "VFO A",
  "vfo": "VFOA"
}