sdrangel/plugins/samplesource/sdrplayv3
f4exb 7880a523a7 SDRPlayV3: prevent segfault when SDRPlay library fails to initialize 2022-02-06 20:30:33 +01:00
..
CMakeLists.txt
readme.md
sdrplayv3gui.cpp
sdrplayv3gui.h
sdrplayv3gui.ui
sdrplayv3input.cpp SDRPlayV3: prevent segfault when SDRPlay library fails to initialize 2022-02-06 20:30:33 +01:00
sdrplayv3input.h
sdrplayv3plugin.cpp
sdrplayv3plugin.h
sdrplayv3settings.cpp
sdrplayv3settings.h
sdrplayv3thread.cpp SDRPlayV3: prevent segfault when SDRPlay library fails to initialize 2022-02-06 20:30:33 +01:00
sdrplayv3thread.h SDRPlayV3: prevent segfault when SDRPlay library fails to initialize 2022-02-06 20:30:33 +01:00
sdrplayv3webapiadapter.cpp
sdrplayv3webapiadapter.h

readme.md

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.07 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

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 transfered 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: DC offset correction

Check this button to enable DC offset correction.

8: IQ imbalance correction

Check this button to enable IQ imbalance correction.

9: External reference clock output

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

10: Bias tee

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

11: AM notch filter

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

12: MW/FM notch filter

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

13: DAB notch filter

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

14: 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

15: IF frequency

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

This selects the IF frequency between these values:

  • 0 for zero IF
  • 450 kHz. Some practical tricks that may or may not work:
    • Frequency is shifted by -450 kHZ.
    • Do not set center frequency lower than 450 kHz down the target frequency
    • Use at least 1536 kHz bandwidth (14)
    • After sample rate change (16) you may need to start/stop device to get thins right.
    • Use decimation > 1 (17) with Inf position (18)
  • 1620 kHz: do not use
  • 2048 kHz: do not use

16: Sample rate

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

17: Decimation

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

18: Decimated bandpass center frequency position relative 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.

19. RF gain setting

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

20. IF AGC

Check this button to enable IF automatic gain control.

21. IF gain

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