![]() Fixes: sdrgui/device/deviceuiset.cpp:353:36: 2nd function call argument is an uninitialized value [clang-analyzer-core.CallAndMessage] |
||
---|---|---|
.. | ||
devicegui.cpp | ||
devicegui.h | ||
deviceuiset.cpp | ||
deviceuiset.h | ||
readme.md |
readme.md
Device common controls
The device windows have common top and bottom bars
A: Top bar
A.1 Device type and index
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.
A.2: Device common settings
All device types have common settings. Clicking on the button opens a dialog to update them
A.2.1: Toggle reverse API feature
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.
A.2.2: API address
This is the IP address of the API endpoint
A.2.3: API port
This is the IP port of the API endpoint
A.2.4: Device index
This is the targeted device index
A.2.5: Cancel changes and exit dialog
Do not make any changes and exit dialog
A.2.6: Validate and exit dialog
Validates the data (saves it in the channel marker object) and exits the dialog
A.3: Change device
Opens a dialog that lets you choose a different device
A.3.1: Device selection combo
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.
A.3.2: Device selection confirmation
Use the OK
button to confirm your choice and exit the dialog
A.3.3: Device selection cancellation
Use the Cancel
button to exit the dialog without any change
A.4: Reload device
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.
A.5: Device set presets
Opens a dialog to manage device set presets. Device set presets store configurations related to a single device set
A.5.1: Preset selection
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.A.5.2: Group
You can organize your presets into groups. Groups can be collapsed or expanded by using the caret icon on the left.A.5.3: Center frequency
The center frequency used in this preset is displayed here.A.5.4: Rx/Tx indicator
"R" is displayed for a Rx device set and "T" for a Tx device setA.5.5: Preset name
You can give a name to your preset. Names need not to be unique.A.5.6: Preset control or actions
A.5.6.1: New preset
Click on this icon to create a new preset with the current values in the selected sample device tab (Main window: 2).A.5.6.2: Update preset
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).A.5.6.3: Edit preset
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
A.5.6.4: Export preset
Using the previous icon presets are saved globally in a system dependent place. Using this icon you can export a specific preset in a single file that can be imported on another machine possibly with a different O/S. The preset binary data (BLOB) is saved in Base-64 format.A.5.6.5: Import preset
This is the opposite of the previous operation. This will create a new preset in the selected group or the same group as the preset being selected.A.5.6.6: Delete preset
on a preset item: deletes the selected preset. on a preset group: deletes the group and all its presets.A.5.6.7: Load preset
Applies the selected preset to the current device set (source and channel plugins).A.6: Add channels
Opens a dialog to add one or more channels connected to the device.
A.6.1: Channel selection
Use this combo to select which channel type to add
A.6.2: Close dialog
Use this button to dismiss the dialog
A.6.3: Add channel
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.
A.7: Title
The window title shows the device type and a sequence number.
You may click on this area and drag the window with the mouse.
A.8: Help
Clicking on this button opens the documentation about the device controls in github in the browser.
A.9: Move to another workspace
Opens a dialog to choose a destination workspace to move the device window to. Nothing happens if the same workspace is selected.
A.10: Shrink window
Click this button to reduce the window to its minimum size
A.11: Close window
Click this button to close the window and removes the device set i.e. the device and all its channels.
B: Bottom bar
B.1: Show spectrum
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.
B.2: Show all channels
This will show all hidden channel windows if any. It has no effects on channel windows already displayed.
B.3: Status text
The status messages appear here if any.
You may click on this area and drag the window with the mouse.