The device windows have common top and bottom bars
The format is:
- Device type:
- R: receiver
- T: transmitter
- M: MIMO
- Semicolon separator
- Device set index. A "device set" is the set of a device and its corresponding channels
The tooltip shows the device type, sequence number and serial number of the device if it exists.
You may click on this area and drag the window with the mouse.
All device types have common settings. Clicking on the button opens a dialog to update them
Use this checkbox to toggle on/off the reverse API feature. With reverse API engaged the changes in the device settings are forwarded to an API endpoint given by address (A.2.2), port (A.2.3) and device index A.2.4) in the same format as the SDRangel REST API device settings endpoint. With the values of the screenshot the API URL is: http://127.0.0.1:8888/sdrangel/deviceset/0/device/settings
The JSON payload follows the same format as the SDRangel REST API device settings. For example with HackRF Rx this would be something like:
{
"deviceHwType": "HackRF",
"hackRFInputSettings": {
"LOppmTenths": 0,
"bandwidth": 1750000,
"biasT": 0,
"centerFrequency": 435000000,
"dcBlock": 0,
"devSampleRate": 2400000,
"fcPos": 2,
"iqCorrection": 0,
"linkTxFrequency": 0,
"lnaExt": 0,
"lnaGain": 16,
"log2Decim": 0,
"vgaGain": 16
},
"tx": 0
}
Note that the PATCH method is used. The full set of parameters is sent only when the reverse API is toggled on or a full settings update is done.
The start and stop actions are also forwarded with the /sdrangel/deviceset/{deviceSetIndex}/device/run
API endpoint using POST (start) or DELETE (stop) methods.
More details on this feature can be found on the corresponding Wiki page.
This is the IP address of the API endpoint
This is the IP port of the API endpoint
This is the targeted device index
Do not make any changes and exit dialog
Validates the data (saves it in the channel marker object) and exits the dialog
Opens a dialog that lets you choose a different device
Use this combo box to select the device. Only available devices will appear in the list. For devices having more than one channel (ex: LimeSDR) the channel number will appear next to the device sequence number inside the brackets. Ex: LimeSDR[0:1] 0009060B00473419
designates the second Rx (Rx #1) of the first encountered LimeSDR which serial number is 0009060B00473419.
Use the OK
button to confirm your choice and exit the dialog
Use the Cancel
button to exit the dialog without any change
This button activates a close/open sequence to recycle the device. It may be useful when the device is not streaming anymore or in an attempt to clear possible errors. Make sure the streaming is stopped first.
Opens a dialog to manage device set presets. Device set presets store configurations related to a single device set
You select a preset or a preset group by clicking on its line in the tree view. All actions (6) will be done relative to this preset or preset group. You can organize your presets into groups. Groups can be collapsed or expanded by using the caret icon on the left. The center frequency used in this preset is displayed here. "R" is displayed for a Rx device set and "T" for a Tx device set You can give a name to your preset. Names need not to be unique. Click on this icon to create a new preset with the current values in the selected sample device tab (Main window: 2). Click on this icon to create a update the selected preset with the current values in the selected sample device tab (Main window: 2). Please note that this does not save the preset immediately on disk to save presets immediately you need to use the save button (4). Opens a new window where you can change the group name and description.-
for group items you can rename the group or merge all group presets into an existing group by selecting this existing group
-
for preset items you can:
- move the preset to another existing group by selecting this existing group
- assign this preset to a new group by typing in this new group
- change the description
Opens a dialog to add one or more channels connected to the device.
Use this combo to select which channel type to add
Use this button to dismiss the dialog
Add a new channel by clicking on the Apply
button. You may click it several times to add more channels. The dialog can be dismissed with the Close
button or the closing window icon X
on the top bar.
The window title shows the device type and a sequence number.
You may click on this area and drag the window with the mouse.
Clicking on this button opens the documentation about the device controls in github in the browser.
Opens a dialog to choose a destination workspace to move the device window to. Nothing happens if the same workspace is selected.
Click this button to reduce the window to its minimum size
Click this button to close the window and removes the device set i.e. the device and all its channels.
When the main spectrum window of this device is hidden this will show it. It has no effect if the main spectrum window is displayed.
This will show all hidden channel windows if any. It has no effects on channel windows already displayed.
The status messages appear here if any.
You may click on this area and drag the window with the mouse.