2.9 KiB
Feature common controls
The feature windows have common top and bottom bars
Top bar
1: Feature index
Displays the index of the feature in the list of features as "F" followed by semicolon and index number.
The tooltip displays the feature type name.
You may click on this area and drag the window with the mouse.
2: Common feature settings
Opens a dialog to update the common feature settings
2.1: Window title
Changes the feature window title
2.2: Reset title to default
Resets the title to the feature type name.
2.3: Toggle reverse API feature
Use this checkbox to toggle on/off the reverse API feature. With reverse API engaged the changes in the feature settings are forwarded to an API endpoint given by address (8.2.4), port (8.2.5), feature set index (8.2.6) and feature index (8.2.7) in the same format as the SDRangel REST API feature settings endpoint. With the values of the screenshot the API URL is: http://127.0.0.1:8888/sdrangel/featureeset/0/feature/0/settings
The JSON payload follows the same format as the SDRangel REST API feature settings. Using the same example this would be:
{
"SimplePTTSettings": {
"reverseAPIAddress": "127.0.0.1",
"reverseAPIChannelIndex": 0,
"reverseAPIDeviceIndex": 0,
"reverseAPIPort": 8888,
"rgbColor": -65536,
"rx2TxDelayMs": 200,
"rxDeviceSetIndex": 0,
"title": "Simple PTT",
"tx2RxDelayMs": 200,
"txDeviceSetIndex": 1,
"useReverseAPI": 0
},
"featureType": "SimplePTT"
}
Note that the PATCH method is used. The full set of parameters is sent with the PUT method only when the reverse API is toggled on or a full settings update is done.
2.4: API address
This is the IP address of the API endpoint
2.5: API port
This is the IP port of the API endpoint
2.6: Feature set index
This is the targeted feature set index
2.7: Feature index
This is the targeted feature index
2.8: Cancel changes and exit dialog
Do not make any changes and exit dialog
2.9: Validate and exit dialog
Validates the data and exits the dialog
3: Title
This is the default feature title or as set with (2.1).
You may click on this area and drag the window with the mouse.
4: Help
Clicking on this button opens the documentation about the feature controls in github in the browser.
5: Move to another workspace
Opens a dialog to choose a destination workspace to move the feature window to. Nothing happens if the same workspace is selected.
6: Shrink window
Click this button to reduce the window to its minimum size
7: Close window
Closes the window and deletes the feature
8: Status
Status messages if any appear here.
You may click on this area and drag the window with the mouse.