-
Notifications
You must be signed in to change notification settings - Fork 0
Buttons
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.
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.
The button is highlighted in blue to indicate that your frequency is in the band portion corresponding to the button's mode, but you have a different mode selected (according to 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.
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.
The button is highlighted in blue to indicate that your frequency is in the band portion corresponding to one of the button's modes, but you have a different mode selected.
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.
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).
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. If you radio does not support it, the button changes the frequency into the desired band, to the center of the band portion corresponding to the currently selected mode (according to the IARU region 1 bandplan).
Example:
{
"type": "hamlib.SwitchToBand",
"index": 0,
"band": "80m"
}
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
This button switches between transmitting and receiveing ("manuall operated transmit"). It indicates the transmitting mode by flashing.
Example:
{
"type": "hamlib.MOX",
"index": 31
}
This button switches to a specific VFO.
Example:
{
"type": "hamlib.SetVFO",
"index": 16,
"label": "VFO A",
"vfo": "VFOA"
}
The following buttons allow to control the ExpertSDR software using the TCI protocol. To enable those buttons you need to provide the --tci command line parameter with a hostname and port number of the ExpertSDR software you want to control, e.g. --tci=192.168.1.44:40001.
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.
The button is highlighted in blue to indicate that your frequency is in the band portion corresponding to the button's mode, but you have a different mode selected (according to the IARU region 1 bandplan).
Example:
{
"type": "tci.SetMode",
"index": 8,
"mode": "cw",
"label": "CW"
}
The label property is optional. If it is omitted, the button shows the corresponding mode instead.
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.
The button is highlighted in blue to indicate that your frequency is in the band portion corresponding to one of the button's modes, but you have a different mode selected.
Example:
{
"type": "tci.ToggleMode",
"index": 9,
"mode1": "digl",
"label1": "DataL",
"mode2": "digu",
"label2": "DataU"
}
The label1 and label2 properties are optional. If they are omitted, the button shows the corresponding mode instead.
This button allows to select a specific filter band for the AF using a bottom and a top frequency. It can also switch the mode.
The button has an icon (filter, filter_small, filter_medium, filter_usb, filter_small_usb, filter_lsb, filter_small_lsb) and a text label.
The button is highlighted in blue to indicate that your frequency is in the band portion corresponding to one of the button's modes, but you have a different mode selected.
Example:
{
"type": "tci.SetFilter",
"index": 19,
"label": "CW 100",
"icon": "filter_small",
"bottom_frequency": -50,
"top_frequency": 50,
"mode": "cw"
}
This button switches between transmitting and receiveing ("manuall operated transmit"). It indicates the transmitting mode by flashing.
Example:
{
"type": "tci.MOX",
"index": 31
}
This button switches the tuning transmission of ExpertSDR. It indicates the transmitting mode by flashing.
Example:
{
"type": "tci.Tune",
"index": 30
}
This button mutes the main volume of ExpertSDR.
Example:
{
"type": "tci.Mute",
"index": 24
}
This button sets the drive level to a specific value. It indicates if this specific value is currently selected.
Example:
{
"type": "tci.SetDrive",
"index": 15,
"value": 50,
"label": "50%"
}
This button increments or decrements the drive level by a specific value. If it is set up for incrementing (positive increment value) and the current drive level is 100 (the maximum value), this button shows "100%" instead of the configured label. If it is set up for decrementing (negative increment value) and the current drive level is 0 (the minimum value), this button shows "0%" instead of the configured label.
A long-press on this button sets the drive level to the maximum or minimum value, depending on the configured increment value.
Example:
{
"type": "tci.IncrementDrive",
"index": 14,
"label": "P -",
"increment": -5
}
The increment property can also be negative to decrement the drive level.
This button increments or decrements the main volume of ExpertSDR. If it is set up for incrementing (positive increment value) and the current volume is 0dB (the maximum value), this button shows "0dB" instead of the configured label. If it is set up for decrementing (negative increment value) and the current volume is -60dB (the minimum value), this button shows "-60dB" instead of the configured label.
Example:
{
"type": "tci.IncrementVolume",
"index": 26,
"label": "Main",
"increment": 5
}
The increment property can also be negative to decrement the volume.
This button switches to a specific band. Because TCI currently does not support band switching, the button changes the frequency into the desired band, to the center of the band portion corresponding to the currently selected mode (according to the IARU region 1 bandplan).
Example:
{
"type": "tci.SwitchToBand",
"index": 0,
"band": "80m"
}