rsp_tcp

(c)2018 F4FHH Nicolas ([email protected]). Licensed under the GNU GPL V3

(c)2020 ON5HB Bas Heijermans, Forked and adjusted for websdr.org - V2.0 driver!

Development stopped due to undocumented API and too many bugs in the API

Please use v1 driver if your box is supported by it

PLEASE DO NOT CONTACT ME ABOUT CLONES, I DO NOT SUPPORT THEM, YOU ARE ON YOUR OWN IF YOU BUY THOSE. THEY HURT SDRPLAY AS A COMPANY.

An rtl_tcp compatible IQ server for the RSP range of SDRPlay SDR but DOES support the RSPdx (untested)

The best SDRplay to buy and use for websdr.org is the RSP1A, it has the best filters and notches!!!!!!!

As you can use just 1 antenna at the time it makes no sense to get any other.

rsp_tcp is a direct port of rtl_tcp for the RSP range of SDRPlay SDR.

As the rtl_tcp protocol is only 8 bits IQ it still uses the 15bit range, but you can reduce it:

1. It will work with any rtl_tcp capable frontend (probably), see usage below
2. As it's opensource, you could compile it on any Linux server

OPTIONS

Usage:

-a listen address

-p listen port (default: 1234)

-d RSP device to use (default: 1, first found)

-P Antenna Port select* (0/1/2, default: 0, Port A)

-T Bias-T enable* (default: disabled)

-R Refclk output enable* (default: disabled)

-f frequency to tune to [Hz] - If freq set centerfreq and progfreq is ignored!!

-s samplerate in [Hz] - If sample rate is set it will be ignored from client!!

-W wideband enable (default: 2 / values: 0 small / 1 wide / 2 = optimised)

-E Edgefilter digital enable* (default: disabled)

-r rfgain only works if -g is set (default: -1 internal table / values 20-59)

-l lnalevel (default: 0 / typical used values 0-6 depending on the device)
	
-G AGC setpoint (default: -24 / recommended values -10 / -40)

-g AGC disable (default: enabled)

-n max number of linked list buffers to keep (default: 512)
		
-A MW HiZ bandfilter* (default: enabled) - RspDuo

-B MW bandfilter* (default: enabled) - Rsp1a/2/2pro/duo/dx
    
-D DAB bandfilter* (default: enabled) - Rsp1a/duo/dx
    
-F FM bandnotch* (default: enabled) - Rsp1a/2/2pro/duo/dx
    
-v Verbose debug output* (default: disabled)

USAGE

• This software is optimised for usage with websdr.org software.
• Use !rtl_sdr adress/port/ppm like you normally would with an RTL-dongle
• RSP RF gain / LNA is set inside the source as a table, only RSP1A tested.
• RTL sample rates tested are those in the websdr.org documentation but lower even down to 62500 has been tested.
• Install the HW/API >3.07 driver from RSPplay for the RSP1A first!! (on website shown as 3.06)

BUILDING

  apt install build-essential (debian)
  mkdir build
  cd build
  cmake ..
  make
  sudo make install

NOTES

• a RSP API version 3.07 (no other tested!) must be installed on the linux server, see sdrplay linux downloads
• It does compile and run on Raspbian 32bit, not on 64bit! (Raspberry Pi2 tested but isn't fast enough)
• It should compile on windows as the initial code from rtl_tcp does
• The goal of this software is ONLY to work well with websdr.org, no other websdr servers or RTL-compatible software but it may work.
• This is a first attempt, not all parameters work!!

TODO

• Find a way to send 16bit samples, so far no luck.
• BiasT doesn't work no matter what I try, tested 2 RSP1A no BiasT

HISTORY (later versions are forked by Bas ON5HB from original of F4FHH)

• Version 0.1.0: Initial build
• Version 0.1.4: Added extra options Bas.
• Version 0.4.5: Added more samplerates that work 64/96/128/192/384/512/768/1024/1536/2048/2880K
• Version 1.1.5: Removed clicks on overloads.
• Version 1.1.6: -w removed and combined with -W to avoid ghost-signals appear. Many new bit conversions and default to 15.5bit.
• Version 1.1.7: 14.5bit as default and fixed box reporting, now correct and box-name, only tested on RSP1A.
• Version 2.0.0: New driver that works with API 3.07 and supports all current boxes. First working version.
• Version 2.0.1: Loads of fixes, Wideband, Decimate for websdr.org etc.
• Version 2.0.4: Added RFgain, LNAlevel and AGC on/off
• Version 2.0.5: Changed conversion to 8 bit drasticly.
• Version 2.0.7: Added random rounding with sample-rate 99 = experimental 14 + dithering mode.
• Version 2.1.0: AGC setpoint, set default values for all boxes, should work instantly, probably only AGC-setpoint and LNA needed to optimise for you.
• Version 2.1.1: Some commandline options where not working like -d, it would fail to init the correct box.
• Version 2.1.8: Fixed conversion errors.
• Version 2.2.0: Fixed decimate and bandfilters, also added auto-optimised for eacht band (=default) driver not 100% tested, just updated.
• Version 2.3.0: Added noise-shaping, not tested, just updated and it compiles 100%, so it should work.

CREDITS

• Open Source Mobile Communications (OSMOCOM) team for the original rtl_tcp code
• Thierry Leconte for many ideas that I found in his Airspy port of rtl_tcp
• Tony Hoyle for the initial idea
• Pothosware for the cmake build examples
• Nicolas F4FHH for creating the original code to work with rtl_tcp compatible software