1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-22 08:04:49 -05:00
sdrangel/plugins/samplesource/sdrplayv3
2024-04-04 15:20:31 +01:00
..
CMakeLists.txt Update sdrplay lib to 3.14 2024-02-19 15:21:32 +00:00
readme.md add sdrplay rsp1b to samplesource plugin 2024-02-18 19:52:34 +01:00
sdrplayv3gui.cpp SDRplay: Prevent nullpointer dereference for #1825 2024-02-27 13:59:15 +00:00
sdrplayv3gui.h Allow replay time offset to be set by ctrl+left click in waterfall. 2023-12-06 10:09:30 +00:00
sdrplayv3gui.ui Add instant replay 2023-11-22 14:28:35 +00:00
sdrplayv3input.cpp add sdrplay rsp1b to samplesource plugin 2024-02-18 19:52:34 +01:00
sdrplayv3input.h add sdrplay rsp1b to samplesource plugin 2024-02-18 19:52:34 +01:00
sdrplayv3plugin.cpp Updated versions and changelogs 2024-02-21 13:56:59 +01:00
sdrplayv3plugin.h SDRPlay V3 API - don't call close unless open was a success, as will crash on Mac, 2023-12-01 11:54:14 +00:00
sdrplayv3settings.cpp Fix missing character. 2024-04-04 15:20:31 +01:00
sdrplayv3settings.h Add instant replay 2023-11-22 14:28:35 +00:00
sdrplayv3thread.cpp Remove tabs. 2023-12-06 10:53:28 +00:00
sdrplayv3thread.h Add instant replay 2023-11-22 14:28:35 +00:00
sdrplayv3webapiadapter.cpp Rewriting of copyright notices for plugins/samplesource. Part of #1893 2023-11-18 10:07:41 +01:00
sdrplayv3webapiadapter.h Rewriting of copyright notices for plugins/samplesource. Part of #1893 2023-11-18 10:07:41 +01:00

SDRplay plugin

Introduction

This plugin supports input from SDRplay RSP devices using V3 of SDRplay's API, including RSP1, RSP1A, RSP2, RSPduo and RSPdx.

Driver Prerequisites

This plugin requires the SDRplay API V3.14 to have been installed and for the service to be running. It can be downloaded for Windows, Linux and Mac from: https://www.sdrplay.com/softwarehome/

Interface

The top and bottom bars of the device window are described here

SDRplay v3 plugin GUI

1: Start/Stop

Device start / stop button.

  • Blue triangle icon: device is ready and can be started
  • Green square icon: device is running and can be stopped
  • Magenta (or pink) square icon: an error occurred. In the case the device was accidentally disconnected you may click on the icon to stop, plug back in, check the source on the sampling devices control panel and start again.

2: Sample rate

This is the sample rate at which IQ samples are transferred from the device to SDRangel, in kS/s (k).

3: Center frequency

This is the center frequency of reception in kHz.

4: Local oscillator frequency correction

This is the correction in tenths of ppm steps.

5: Tuner selection

Selects which tuner is used for input. For RSPduo this can be 1 or 2. Other RSP devices only have a single tuner.

6: Antenna port

Selects which antenna port is used. The antenna ports available depend upon the RSP device and tuner selected.

7. Transverter mode open dialog

This button opens a dialog to set the transverter mode frequency translation options. The details about this dialog can be found here

8: DC offset correction

Check this button to enable DC offset correction.

9: IQ imbalance correction

Check this button to enable IQ imbalance correction.

10: External reference clock output

Enable reference clock output. This is only available for RSP2 and DSPduo.

11: Bias tee

Enable bias tee. This is only available for RSP1A, RSP2, RSPduo tuner 2 and RSPdx.

12: AM notch filter

Enable AM notch filter. This is only available for RSPduo tuner 1.

13: MW/FM notch filter

Enable MW/FM notch filter. This is only available for RSP1A, RSP2, RSPduo and RSPdx.

14: DAB notch filter

Enable DAB notch filter. This is only available for RSP1A, RSPduo and RSPdx.

15: IF bandwidth

This selects the IF filter bandwidth. The following bandwidths are available:

  • 200 kHz
  • 300 kHz
  • 600 kHz
  • 1536 kHz
  • 5000 kHz
  • 6000 kHz
  • 7000 kHz
  • 8000 kHz

16: IF frequency

Warning there is no good support of non zero IF. It is advised to keep zero IF for normal use.

Some tricks are provided for expert use of non-zero IFs. You may want to start from these settings to experiment more with it.

This selects the IF frequency between these values:

  • 0 for zero IF
  • 450 kHz.
    • Move center frequency by -450 kHz (3).
      • Direct frequency reading is -450 kHz off from real Rx frequency.
      • You may use the transverter mode (7) with a shift of +450 kHz to correct the frequency reading
      • If you already use the transverter mode for transverter work just add 450 kHz to the current shift
    • Use 1536 kHz bandwidth (15)
    • After sample rate change (17) you may need to start/stop device to get things right.
    • Use decimation > 1 (18) with Inf position (19)
  • 1620 kHz:
    • Move center frequency by -1620 kHz (3).
      • Direct frequency reading is -1620 kHz off from real Rx frequency.
      • You may use the transverter mode (7) with a shift of +1620 kHz to correct the frequency reading
      • If you already use the transverter mode for transverter work just add 1620 kHz to the current shift
    • Use 5000 kHz bandwidth (15)
    • After sample rate change (17) you may need to start/stop device to get things right.
    • Use decimation > 1 (18) with Inf position (19)
  • 2048 kHz:
    • Move center frequency by -2048 kHz (3).
      • Direct frequency reading is -2048 kHz off from real Rx frequency.
      • You may use the transverter mode (7) with a shift of +2048 kHz to correct the frequency reading
      • If you already use the transverter mode for transverter work just add 2048 kHz to the current shift
    • Use 5000 kHz bandwidth (15)
    • After sample rate change (17) you may need to start/stop device to get things right.
    • Use decimation > 1 (18) with Inf position (19)

17: Sample rate

Sets the ADC IQ sample rats from 2M to 10.66M Hz.

18: Decimation

Decimation in powers of two from 1 (no decimation) to 64.

19: Decimated bandpass center frequency position relative to the SDRplay center frequency

  • Cen: the decimation operation takes place around the SDRplay center frequency Fs.
  • Inf: the decimation operation takes place around Fs - Fc.
  • Sup: the decimation operation takes place around Fs + Fc.

With SR as the sample rate before decimation Fc is calculated as:

  • if decimation n is 4 or lower: Fc = SR/2^(log2(n)-1). The device center frequency is on the side of the baseband. You need a RF filter bandwidth at least twice the baseband.
  • if decimation n is 8 or higher: Fc = SR/n. The device center frequency is half the baseband away from the side of the baseband. You need a RF filter bandwidth at least 3 times the baseband.

20. RF gain setting

Sets the LNA and mixer gain dB. The settings available depended upon the RSP device and frequency band.

21. IF AGC

Check this button to enable IF automatic gain control.

22. IF gain

Manual IF gain from 0 to -59 dB. Only enabled when IF AGC is disabled.