sdrangel/sdrgui/feature/readme.md

2.9 KiB

Feature common controls

The feature windows have common top and bottom bars

Feature window

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

Feature window

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.