Difference between revisions of "Software Defined Radio"

From SatNOGS Wiki
(adding links, categories)
(Airspy section: Add example station 1559 (DB2OS-VHF Omni))
 
(45 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Software Defined Radio (SDR)}}
+
==Introduction==
  
SatNOGS can use a variety of SDRs. The most cost-effective solution is to use an RTL-SDR with a Raspberry Pi.  More advanced SDRs can also be used, but they require more processing power than what a Raspberry Pi can offer.
+
Built upon [https://gnuradio.org/ GNU Radio] and [https://github.com/pothosware/SoapySDR/wiki SoapySDR] by using the [https://gitlab.com/librespacefoundation/gr-soapy gr-soapy] module SatNOGS supports a large variety of Software-Defined Radios (SDRs). The gr-soapy module was developed in the [https://sdrmaker.space/ SDR Makerspace] and is maintained by Libre Space Foundation to bring the vendor-neutral SDR support by SoapySDR to the flexible gnuradio ecosystem.
  
=== RTL-SDR: RTL2832U & R820T2-Based Software Defined Radios ===
+
The most cost-effective solution is to use an RTL-SDR with a Raspberry PiMore advanced SDRs are also used, but they require more processing power and thus might require a more powerful computing platform than the Raspberry Pi.
SatNOGS uses the RTL-SDR as the default signal receiver and tuner.  The RTL-SDR is based on two chips -- the versatile [http://www.realtek.com.tw/products/productsView.aspx?Langid=1&PFid=35&Level=4&Conn=3&ProdID=257 RTL2832U chip] and the [https://rtl-sdr.com/wp-content/uploads/2013/04/R820T_datasheet-Non_R-20111130_unlocked.pdf R820T tuner]. The RTL-SDR is currently the cheapest, most common, and most performing solution available in terms of general sensitivity having a frequency range of 24 – 1766 MHzA metal enclosure with SMA connector is preferred, along with a stable TCXO (low ppm).  HF coverage is optional.
 
  
These RTL-SDR "dongles" are known to work with Raspberry Pi 2 or greater:
+
==Supported Devices==
* [https://www.nooelec.com/store/sdr/sdr-receivers.html NooElec NESDR SMArt]
 
* [https://www.rtl-sdr.com/buy-rtl-sdr-dvb-t-dongles/ RTL-SDR Blog R820T2 RTL2832U]
 
* Full band UV HF RTL-SDR USB Tuner Receiver
 
  
=== Advanced Software Defined Radios ===
+
SoapySDR supports SDR devices through runtime-loadable modules [https://github.com/pothosware/SoapySDR/wiki#plugin-architecture]. You can find all available modules in the [https://github.com/pothosware/SoapySDR/wiki#modules SoapySDR wiki] (see right column). Most SDR modules are installed by default when setting up a SatNOGS station.
The following advanced SDRs are supported by SatNOGS.  These may require more processing power than a Raspberry Pi 3b can offer.  
+
 
* [https://www.ettus.com/product/category/USRP-Bus-Series USRP b200]
+
The following SDRs are supported by SatNOGS. SatNOGS uses the RTL-SDR as the recommended beginner signal receiver and tuner.   
* [https://www.ettus.com/product/category/USRP-Networked-Series USRP2] (not compatible with the SatNOGS client on Raspberry Pi 3)
+
The more advanced SDRs may require more processing power than a Raspberry Pi 3b or 4 can offer.  
* [https://airspy.com/ Airspy] (not compatible with the SatNOGS client on Raspberry Pi 3)
+
 
* [https://greatscottgadgets.com/hackrf/ HackRF One] (not compatible with the SatNOGS client on Raspberry Pi 3)
+
*[[Software Defined Radio#RTL-SDR Support|RTL-SDR]]
 +
**[https://www.nooelec.com/store/sdr/sdr-receivers.html NooElec NESDR SMArt]
 +
**[https://www.rtl-sdr.com/buy-rtl-sdr-dvb-t-dongles/ RTL-SDR Blog R820T2 RTL2832U]
 +
**Full band UV HF RTL-SDR USB Tuner Receiver
 +
 
 +
*[[Software Defined Radio#USRP support|USRP devices]]
 +
**[https://www.ettus.com/product/category/USRP-Bus-Series USRP B200]
 +
 
 +
*[[Software Defined Radio#Airspy support|Airspy]]
 +
*[[Software Defined Radio#LimeSDR support|LimeSuite devices]]
 +
**[https://limemicro.com/products/boards/limesdr-mini/ LimeSDR mini]
 +
*[[Software Defined Radio#PlutoSDR support|PlutoSDR]]
 +
**[https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/adalm-pluto.html#eb-overview ADALM-PLUTO] (untested)
 +
 
 +
{{Message|There are probably a lot more devices supported since the transition from gr-osmosdr to gr-soapy. Please update this list when you were able to successfully run a SatNOGS station with a new radio family or model. You can also link your station as an example to give others the ability to compare performance.}}
 +
 
 +
==Supported Devices with closed-source drivers==
 +
Unfortunately some vendors require closed-source drivers in their SoapySDR modules and thus those modules or dependencies can't be redistributed by others. Thus they must be manually installed by the user. The following devices require closed-source drivers:
 +
 
 +
*[[Software Defined Radio#SDRPlay support|SDRPlay]]
 +
 
 +
==Unsupported Devices==
 +
{{Warning|This section might be outdated due to the transition to gr-soapy. Please update when possible.}}
 +
<br />
 +
 
 +
*[https://greatscottgadgets.com/hackrf/ HackRF One] (not compatible with the SatNOGS client on Raspberry Pi, ''Update: works fine now on a Pi4, only tested with the 8GB version of the Pi4. Will probably work with a 2/4GB version too. Not tested on a Pi3, might not be powerful enough to handle 8MS/s'')
 +
 
 +
==RTL-SDR Support==
 +
The RTL-SDR is based on two chips -- the versatile [http://www.realtek.com.tw/products/productsView.aspx?Langid=1&PFid=35&Level=4&Conn=3&ProdID=257 RTL2832U chip] and the [https://rtl-sdr.com/wp-content/uploads/2013/04/R820T_datasheet-Non_R-20111130_unlocked.pdf R820T tuner]. The RTL-SDR is currently the cheapest, most common, and most performing solution available in terms of general sensitivity having a frequency range of 24 – 1766 MHz.  A metal enclosure with SMA connector is preferred, along with a stable TCXO (low ppm).  HF coverage is optional.
 +
 
 +
<br />
 +
 
 +
===Using RTL-SDR.com V3 Dongle's Bias-T Power Supply===
 +
The RTL-SDR.com V3 dongle has a built in software activated Bias-T voltage supply intended to be used for applications such as powering inline LNAs (Low Noise Amplifiers).  There are several ways to turn on the voltage, but through initial testing (as of this writing, 17 Aug 2019) it seems that the following procedure works best.
 +
 
 +
The below relates to Raspberry Pi installs only.  No testing has been performed on other systems as of yet.
 +
 
 +
{{Warning|Turning on the Bias-T with no LNA installed and a "shorted" style antenna (such as loops, egg-beaters, etc.) can damage the RTL-SDR.com V3 dongle.  Never activate the bias-t with no LNA installed between the antenna and the SDR dongle.}}
 +
 
 +
'''Requirements:'''
 +
 
 +
#Raspberry Pi running Raspbian Buster or newer (latest release of SatNogs image, [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/tags 2019091100], is demonstrated to work)
 +
#[https://www.rtl-sdr.com/buy-rtl-sdr-dvb-t-dongles/ RTL-SDR.com V3 SDR dongle]
 +
#[https://www.rtl-sdr.com/rtl-sdr-blog-v-3-dongles-user-guide/ RTL-SDR.com Bias-T Software Switch] for linux systems
 +
#LNA capable of being powered via feedline coax (note that some LNAs need modifications to be powered by the coax, and some cannot be powered by the coax at all.  Check the specifications for your LNA prior to attempting to turn on the Bias-T power supply)
 +
 
 +
<br />
 +
 
 +
====Instructions for installing RTL-SDR.com Bias-T Software Switch====
 +
 
 +
#Log into your SatNogs station either directly or via SSH
 +
#If your station does not have cmake installed (SatNogs Image 2019091100 does not), install cmake with <code>sudo apt install cmake</code>
 +
#Clone the source for the Bias-T software switch with <code>git clone <nowiki>https://github.com/rtlsdrblog/rtl_biast</nowiki></code>
 +
#<code>cd rtl_biast</code>
 +
#<code>mkdir build</code>
 +
#<code>cd build</code>
 +
#<code>cmake ..</code>  (if you get a <code>LibUSB 1.0 required to compile rtl-sdr</code> error here, then do <code>sudo apt install libusb-1.0-0-dev</code> prior to attempting <code>cmake ..</code> again)
 +
#<code>make</code>
 +
 
 +
 
 +
The software switch should now be installed in the "src" directory.    If you <code>cd src</code>, you can turn on the bias-t with the command <code>./rtl_biast -b 1</code> and turn it off with <code>./rtl_biast -b 0</code>.  Note that the developers of this switch have warned against attempting to <code>sudo make install</code> so that this command can be executed from ouside the src directory.  Testing has shown this warning to be accurate, so don't plan on running these commands from anywhere but the src directory, or else be sure to use the full path.
 +
 
 +
Switching the Bias-T on should yield between 4.5V and 5.0V across the center conductor and shield of the coax.  The voltage should rise almost instantly.  When switched off, the voltage seems to decrease gradually, over 5 to 10 seconds.
 +
 
 +
====Instructions to activate the bias-t for SatNogs Observations automatically:====
 +
 
 +
#Log into your SatNogs station either directly or via SSH
 +
#<code>sudo satnogs-setup</code>
 +
#select <code>Advanced</code>
 +
#for <code>Radio</code> -><code>SATNOGS_RF_GAIN</code>, enter a low gain value supported by your RTL-SDR.com V3 dongle (entering <code>rtl_test</code> at the command line prior to starting <code>satnogs-setup</code> will give you all allowable values of RF gain) and select <code>Ok</code>
 +
#for <code>Scripts</code> -><code>SATNOGS_PRE_OBSERVATION_SCRIPT,</code> enter <code>/home/pi/rtl_biast/build/src/rtl_biast -b 1</code> and select <code>Ok</code>
 +
#for <code>Scripts</code> -><code>SATNOGS_POST_OBSERVATION_SCRIPT,</code> enter <code>/home/pi/rtl_biast/build/src/rtl_biast -b 0</code> and select <code>Ok</code>
 +
#Select <code>Back</code>
 +
#Select <code>Apply</code> (allow system to update and hit enter when prompted)
 +
#Select <code>Back</code>
 +
 
 +
Your station is now set up to turn the Bias-T on for each scheduled observation (using the <code>SATNOGS_PRE_OBSERVATION_SCRIPT</code> string) and then turn it off at the conclusion of each observation (using the <code>SATNOGS_POST_OBSERVATION_SCRIPT</code>).
 +
 
 +
You should now schedule several observations to fine tune the <code>SATNOGS_RF_GAIN</code> value to get the best S/N performance for your station.  Some have reported needing zero RF gain, others have reported low RF gain required (between 5 and 10 db), and others have said they see little benefit even with very high gain. Each station will be different.
 +
 
 +
====E4000 Tuner Gain Settings====
 +
The RTLSDR Driver exposes six (!) IF gain settings (IF1 through IF6) for the E4000 tuner, along with a TUNER gain setting, which is actually a combined LNA and Mixer gain control. Details on the gain stages are available in page 28 of the E4000 data-sheet here: https://www.nooelec.com/files/e4000datasheet.pdf
 +
 
 +
When you follow the '[[Omnidirectional Station How To#Setting the gain|Setting the Gain]]' guide, all gain sliders (IF1 through IF6, and TUNER) should be presented in SoapySDR, allowing the user to adjust them to optimise for best performance. Once the correct values have been determined, you will need to define these specifically in satnogs-setup as follows:
 +
 
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Settings Field"</code>
 +
*<code>SATNOGS_OTHER_SETTINGS</code>=<code>"IF1=6,IF2=3,IF2=2,IF3=0,IF4=0,IF5=2,IF6=3,TUNER=30"</code>
 +
 
 +
(Replacing the values in the line above with the ones you determined)
 +
 
 +
====R820T Gain Settings====
 +
Unfortunately librtlsdr only exposes a single gain control for the R820T/T2 tuners, even though multiple gain adjustments are available. Use the standard SATNOGS_RF_GAIN option, with a gain between 0 and 42 (dB), as optimised for your station via the '[[Omnidirectional Station How To#Setting the gain|Setting the Gain]]' guide.
 +
 
 +
==Airspy support==
 +
Vendor: [https://airspy.com/ Airspy]
 +
 
 +
required SoapySDR module: [https://github.com/pothosware/SoapyAirspy/wiki SoapyAirspy]
 +
 
 +
Example stations:
 +
 
 +
*[https://network.satnogs.org/stations/1559/ 1559 - DB2OS-VHF-Omni] / [https://network.satnogs.org/observations/6307151/ Observation #6307151]
 +
 
 +
'''Note than none of the settings below should be entered with the "  " around the value. This is only for better readability in the Wiki !'''
 +
 
 +
===Gain settings===
 +
There are two possible gain modes:
 +
 
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Overall"</code>: (default) Use a single gain value.  Set the overall gain with <code>SATNOGS_RF_GAIN</code>,e.g. <code>SATNOGS_RF_GAIN</code>=<code>43</code>.
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Settings Field"</code>: Use granular gain values.  Set the different gain stages separately:
 +
**without pre-amp: <code>SATNOGS_OTHER_SETTINGS</code>=<code>"LNA=12,MIX=8,VGA=11"</code>
 +
**with pre-amp: <code>SATNOGS_OTHER_SETTINGS</code>=<code>"LNA=9,MIX=6,VGA=11"</code> (used in [https://network.satnogs.org/stations/49/ 49 - OZ7SAT])
 +
 
 +
 
 +
For reference see also the Airspy driver library linearity gain settings in [https://github.com/airspy/airspyone_host/blob/bceca18f9e3a5f89cff78c4d949c71771d92dfd3/libairspy/src/airspy.c#L117-L122 libairspy/src/airspy.c#L117-L122].
 +
 
 +
The airspy driver offers "Linearity" and "Sensitivity" gain settings, using a look-up table to configure all three gain stages from a single value (optimized for linearity and gain respectively). Those modes are unfortunately not available through the SoapyAirspy module (see [https://github.com/pothosware/SoapyAirspy/pull/14 SoapyAirspy#14]).
 +
 
 +
The "Overall" gain mode is a soapy-specific driver-independent mode to configure all gain stages based on the single gain value from <code>SATNOGS_RF_GAIN</code>. It tries to evenly distribute the gain, potentially resulting in non-optimal configuration. Thus for achieving optimal results the "Settings Field" mode is recommended, where all three gain stages can be configured separately.
 +
 
 +
===Sample rates===
 +
 
 +
*Airspy R2: <code>SATNOGS_RX_SAMPLE_RATE</code>=<code>2.5e6 or 10e6</code>
 +
*Airspy Mini: <code>SATNOGS_RX_SAMPLE_RATE</code>=<code>3e6 or 6e6</code>
 +
*Airspy HF+: <code>SATNOGS_RX_SAMPLE_RATE</code>=<code>768e3</code>
 +
 
 +
source: [https://twitter.com/DutchSpace/status/1241305651168661504]
 +
 
 +
If you want to activate the integrated bias tee, set <code>SATNOGS_DEV_ARGS</code>=<code>"biastee=true"</code>.
 +
Bit packing ("Enable packing 4 12-bit samples into 3 16-bit words for 25% less USB trafic.") could be enabled with <code>SATNOGS_DEV_ARGS</code>=<code>"bitpacking=true"</code> (untested). Device arguments can be concatenated with comma as delimiter.
 +
 
 +
 
 +
==SDRPlay support==
 +
Vendor: [http://www.sdrplay.com/ SDRPlay]
 +
 
 +
required SoapySDR module: [https://github.com/pothosware/SoapySDRPlay SoapySDRPlay]
 +
 
 +
The following settings [https://network.satnogs.org/observations/?norad=&observer=&station=1354&results=d1&start=2020-02-20+00%3A00&end=2020-02-24+23%3A59 worked well] for an [https://www.sdrplay.com/rspduo/ SDRplay RSPduo] when using cross-yagis and good [https://www.ssb.de/en/amplifiers/preamplifier/vox/100w SSB low-noise amplifiers]:
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE="driver=sdrplay"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE=2e6</code>
 +
*<code>SATNOGS_RX_BANDWIDTH=600e3</code>
 +
*<code>SATNOGS_RF_GAIN=34</code>
 +
*<code>SATNOGS_ANTENNA="Tuner 1 50 ohm"</code>
 +
 
 +
Note that 14-bits ADC resolution is only available when using sample rates below 6.048 MSPS, above which the resolution is reduced gradually to 12, 10, and 8 bits.
 +
 
 +
==USRP support==
 +
Vendor: [https://ettus.com Ettus Research]
 +
 
 +
required SoapySDR module: [https://github.com/pothosware/SoapyUHD/wiki SoapyUHD]
 +
 
 +
Recent USRPs that use the Analog Devices [https://www.analog.com/en/products/ad9361.html AD9361 RFIC] can use almost arbitrary sample rates and analog bandwidth settings. It can be an advantage to set the sample rate as high as the host computer can handle and the analog bandwidth to as narrow as meaningful. The following settings [https://network.satnogs.org/observations/?norad=&observer=&station=1353&results=d1&start=2020-02-20+00%3A00&end=2020-02-24+23%3A59 worked well] for a [https://www.ettus.com/all-products/ub210-kit/ USRP B210] when using cross-yagis and good [https://www.ssb.de/en/amplifiers/preamplifier/vox/100w SSB low-noise amplifiers]:
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE="driver=uhd"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE=2e6</code>
 +
*<code>SATNOGS_RX_BANDWIDTH=600e3</code>
 +
*<code>SATNOGS_RF_GAIN=50</code>
 +
*<code>SATNOGS_ANTENNA="RX2"</code>
 +
**on the B200 your Antenna options are <code>TX/RX</code> and <code>RX2</code>, be sure you select the right option for your configuration!
 +
 
 +
==LimeSDR support==
 +
Vendor: [https://limemicro.com Lime microsystems]
 +
 
 +
required SoapySDR module: [https://github.com/myriadrf/LimeSuite/tree/master/SoapyLMS7 SoapyLMS7 wrapper]
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE</code>=<code>"driver=lime"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE</code>=<code>"2.048e6"</code>
 +
*<code>SATNOGS_ANTENNA</code>=<code>"LNAW"</code>
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Settings Field"</code>
 +
*<code>SATNOGS_RF_GAIN</code>=<code>20</code>
 +
*<code>SATNOGS_OTHER_SETTINGS</code>=<code>"TIA=12,PGA=0,LNA=12"</code>
 +
 
 +
(untested, copied from station 1378)
 +
 
 +
Example stations:
 +
 
 +
*[https://network.satnogs.org/stations/1378/ 1378 - Wolbach library]
 +
 
 +
==PlutoSDR support==
 +
Vendor: [https://www.analog.com Analog Devices]
 +
 
 +
required SoapySDR module: [https://github.com/pothosware/SoapyPlutoSDR/wiki SoapyPlutoSDR]
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE</code>=<code>"driver=plutosdr"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE</code>=<code>"2e6"</code>
 +
*<code>SATNOGS_ANTENNA</code>=<code>"A_BALANCED"</code>
 +
*<code>SATNOGS_RF_GAIN</code>=<code>50</code>
 +
 
 +
==HackRF support==
 +
Vendor: [https://greatscottgadgets.com/hackrf/ Great Scott Gadgets]
 +
 
 +
required SoapySDR module: [https://github.com/pothosware/SoapyHackRF SoapyHackRF]
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE</code>=<code>"driver=hackrf"</code>
 +
*<code>SATNOGS_ANTENNA</code>=<code>"TX/RX"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE="8e6"</code>
 +
**HackRF supports 8 to 20MS/s. Higher than 8MS/s has not been tested with SatNOGS on a RaspberryPi
 +
**HackRF can run lower than 8MS/s, but it is not recommended as the ADC's filter is not designed for samplerates lower than 8MS/s
 +
 
 +
 
 +
There are two possible gain modes:
 +
 
 +
"Overal", specifying just one global gain:
 +
 
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Overall"</code>
 +
*<code>SATNOGS_RF_GAIN</code>=<code>"64"</code> (Supported gain range: 0-116dB)
 +
 
 +
 
 +
"Settings Field", specifying the individual gains.
 +
 
 +
*<code>SATNOGS_GAIN_MODE</code>=<code>"Settings Field"</code>
 +
*<code>SATNOGS_OTHER_SETTINGS</code>=<code>"AMP=14,LNA=40,VGA=48"</code>
 +
**AMP: supports 0 (amp disabled) and 14 (amp enabled)
 +
**LNA: supports 0-40dBin 8dB steps
 +
**VGA: supports 0-62dB in 2dB steps
 +
 
 +
 
 +
To activate bias-T power on the antenna port:
 +
 
 +
*<code>SATNOGS_DEV_ARGS</code>=<code>bias_tx=true</code>
 +
 
 +
 
 +
Example stations:
 +
 
 +
*[https://network.satnogs.org/stations/1868/ 1868 - HB9FXX S-Band]
 +
 
 +
==Remote==
 +
Using the SoapySDRServer running on the same machine or over the network.
 +
 
 +
Required SoapySDRServer module: [https://github.com/pothosware/SoapyRemote/wiki SoapyRemote].
 +
Optional SoapySDRUtil to probe for SDR and settings.
 +
Make sure to match the antenna and gain setting from the actual device connected to the remote. Also possible to select remote drivers and other parameters; <code>driver=remote,remote:driver=rtlsdr</code>
 +
 
 +
*<code>SATNOGS_SOAPY_RX_DEVICE</code>=<code>"driver=remote"</code>
 +
*<code>SATNOGS_RX_SAMP_RATE</code>=<code>"2e6"</code>
 +
*<code>SATNOGS_ANTENNA</code>=<code>"RX"</code>
 +
*<code>SATNOGS_RF_GAIN</code>=<code>20.7</code>
 +
 
 +
Not stable.
 +
 
 +
==References==
 +
 
 +
*[https://www.rtl-sdr.com/rtlsdr4everyone-review-of-5-rtl-sdr-dongles/ Review of 5 RTL-SDR Dongles]
 +
*[https://hackaday.com/2017/09/05/19-rtl-sdr-dongles-reviewed/ 19 RTL-SDR Dongles Reviewed]
 +
*[https://www.rtl-sdr.com/review-airspy-vs-sdrplay-rsp-vs-hackrf/ Review: Airspy VS. SDRplay RSP VS. HackRF]
 +
 
 +
[[Category:Build]]
 +
[[Category:Hardware]]
 +
[[Category:Software]]
  
=== References ===
 
* [https://www.rtl-sdr.com/rtlsdr4everyone-review-of-5-rtl-sdr-dongles/ Review of 5 RTL-SDR Dongles]
 
* [https://hackaday.com/2017/09/05/19-rtl-sdr-dongles-reviewed/ 19 RTL-SDR Dongles Reviewed]
 
* [https://www.rtl-sdr.com/review-airspy-vs-sdrplay-rsp-vs-hackrf/ Review: Airspy VS. SDRplay RSP VS. HackRF]
 
[[Category:SDR]]
 
[[Category:Radio]]
 
 
__NOEDITSECTION__
 
__NOEDITSECTION__

Latest revision as of 08:52, 9 August 2022

Introduction

Built upon GNU Radio and SoapySDR by using the gr-soapy module SatNOGS supports a large variety of Software-Defined Radios (SDRs). The gr-soapy module was developed in the SDR Makerspace and is maintained by Libre Space Foundation to bring the vendor-neutral SDR support by SoapySDR to the flexible gnuradio ecosystem.

The most cost-effective solution is to use an RTL-SDR with a Raspberry Pi. More advanced SDRs are also used, but they require more processing power and thus might require a more powerful computing platform than the Raspberry Pi.

Supported Devices

SoapySDR supports SDR devices through runtime-loadable modules [1]. You can find all available modules in the SoapySDR wiki (see right column). Most SDR modules are installed by default when setting up a SatNOGS station.

The following SDRs are supported by SatNOGS. SatNOGS uses the RTL-SDR as the recommended beginner signal receiver and tuner. The more advanced SDRs may require more processing power than a Raspberry Pi 3b or 4 can offer.

Idea.png
There are probably a lot more devices supported since the transition from gr-osmosdr to gr-soapy. Please update this list when you were able to successfully run a SatNOGS station with a new radio family or model. You can also link your station as an example to give others the ability to compare performance.

Supported Devices with closed-source drivers

Unfortunately some vendors require closed-source drivers in their SoapySDR modules and thus those modules or dependencies can't be redistributed by others. Thus they must be manually installed by the user. The following devices require closed-source drivers:

Unsupported Devices

Important.png
This section might be outdated due to the transition to gr-soapy. Please update when possible.


  • HackRF One (not compatible with the SatNOGS client on Raspberry Pi, Update: works fine now on a Pi4, only tested with the 8GB version of the Pi4. Will probably work with a 2/4GB version too. Not tested on a Pi3, might not be powerful enough to handle 8MS/s)

RTL-SDR Support

The RTL-SDR is based on two chips -- the versatile RTL2832U chip and the R820T tuner. The RTL-SDR is currently the cheapest, most common, and most performing solution available in terms of general sensitivity having a frequency range of 24 – 1766 MHz. A metal enclosure with SMA connector is preferred, along with a stable TCXO (low ppm). HF coverage is optional.


Using RTL-SDR.com V3 Dongle's Bias-T Power Supply

The RTL-SDR.com V3 dongle has a built in software activated Bias-T voltage supply intended to be used for applications such as powering inline LNAs (Low Noise Amplifiers). There are several ways to turn on the voltage, but through initial testing (as of this writing, 17 Aug 2019) it seems that the following procedure works best.

The below relates to Raspberry Pi installs only. No testing has been performed on other systems as of yet.

Important.png
Turning on the Bias-T with no LNA installed and a "shorted" style antenna (such as loops, egg-beaters, etc.) can damage the RTL-SDR.com V3 dongle. Never activate the bias-t with no LNA installed between the antenna and the SDR dongle.

Requirements:

  1. Raspberry Pi running Raspbian Buster or newer (latest release of SatNogs image, 2019091100, is demonstrated to work)
  2. RTL-SDR.com V3 SDR dongle
  3. RTL-SDR.com Bias-T Software Switch for linux systems
  4. LNA capable of being powered via feedline coax (note that some LNAs need modifications to be powered by the coax, and some cannot be powered by the coax at all. Check the specifications for your LNA prior to attempting to turn on the Bias-T power supply)


Instructions for installing RTL-SDR.com Bias-T Software Switch

  1. Log into your SatNogs station either directly or via SSH
  2. If your station does not have cmake installed (SatNogs Image 2019091100 does not), install cmake with sudo apt install cmake
  3. Clone the source for the Bias-T software switch with git clone https://github.com/rtlsdrblog/rtl_biast
  4. cd rtl_biast
  5. mkdir build
  6. cd build
  7. cmake .. (if you get a LibUSB 1.0 required to compile rtl-sdr error here, then do sudo apt install libusb-1.0-0-dev prior to attempting cmake .. again)
  8. make


The software switch should now be installed in the "src" directory. If you cd src, you can turn on the bias-t with the command ./rtl_biast -b 1 and turn it off with ./rtl_biast -b 0. Note that the developers of this switch have warned against attempting to sudo make install so that this command can be executed from ouside the src directory. Testing has shown this warning to be accurate, so don't plan on running these commands from anywhere but the src directory, or else be sure to use the full path.

Switching the Bias-T on should yield between 4.5V and 5.0V across the center conductor and shield of the coax. The voltage should rise almost instantly. When switched off, the voltage seems to decrease gradually, over 5 to 10 seconds.

Instructions to activate the bias-t for SatNogs Observations automatically:

  1. Log into your SatNogs station either directly or via SSH
  2. sudo satnogs-setup
  3. select Advanced
  4. for Radio ->SATNOGS_RF_GAIN, enter a low gain value supported by your RTL-SDR.com V3 dongle (entering rtl_test at the command line prior to starting satnogs-setup will give you all allowable values of RF gain) and select Ok
  5. for Scripts ->SATNOGS_PRE_OBSERVATION_SCRIPT, enter /home/pi/rtl_biast/build/src/rtl_biast -b 1 and select Ok
  6. for Scripts ->SATNOGS_POST_OBSERVATION_SCRIPT, enter /home/pi/rtl_biast/build/src/rtl_biast -b 0 and select Ok
  7. Select Back
  8. Select Apply (allow system to update and hit enter when prompted)
  9. Select Back

Your station is now set up to turn the Bias-T on for each scheduled observation (using the SATNOGS_PRE_OBSERVATION_SCRIPT string) and then turn it off at the conclusion of each observation (using the SATNOGS_POST_OBSERVATION_SCRIPT).

You should now schedule several observations to fine tune the SATNOGS_RF_GAIN value to get the best S/N performance for your station. Some have reported needing zero RF gain, others have reported low RF gain required (between 5 and 10 db), and others have said they see little benefit even with very high gain. Each station will be different.

E4000 Tuner Gain Settings

The RTLSDR Driver exposes six (!) IF gain settings (IF1 through IF6) for the E4000 tuner, along with a TUNER gain setting, which is actually a combined LNA and Mixer gain control. Details on the gain stages are available in page 28 of the E4000 data-sheet here: https://www.nooelec.com/files/e4000datasheet.pdf

When you follow the 'Setting the Gain' guide, all gain sliders (IF1 through IF6, and TUNER) should be presented in SoapySDR, allowing the user to adjust them to optimise for best performance. Once the correct values have been determined, you will need to define these specifically in satnogs-setup as follows:

  • SATNOGS_GAIN_MODE="Settings Field"
  • SATNOGS_OTHER_SETTINGS="IF1=6,IF2=3,IF2=2,IF3=0,IF4=0,IF5=2,IF6=3,TUNER=30"

(Replacing the values in the line above with the ones you determined)

R820T Gain Settings

Unfortunately librtlsdr only exposes a single gain control for the R820T/T2 tuners, even though multiple gain adjustments are available. Use the standard SATNOGS_RF_GAIN option, with a gain between 0 and 42 (dB), as optimised for your station via the 'Setting the Gain' guide.

Airspy support

Vendor: Airspy

required SoapySDR module: SoapyAirspy

Example stations:

Note than none of the settings below should be entered with the " " around the value. This is only for better readability in the Wiki !

Gain settings

There are two possible gain modes:

  • SATNOGS_GAIN_MODE="Overall": (default) Use a single gain value. Set the overall gain with SATNOGS_RF_GAIN,e.g. SATNOGS_RF_GAIN=43.
  • SATNOGS_GAIN_MODE="Settings Field": Use granular gain values. Set the different gain stages separately:
    • without pre-amp: SATNOGS_OTHER_SETTINGS="LNA=12,MIX=8,VGA=11"
    • with pre-amp: SATNOGS_OTHER_SETTINGS="LNA=9,MIX=6,VGA=11" (used in 49 - OZ7SAT)


For reference see also the Airspy driver library linearity gain settings in libairspy/src/airspy.c#L117-L122.

The airspy driver offers "Linearity" and "Sensitivity" gain settings, using a look-up table to configure all three gain stages from a single value (optimized for linearity and gain respectively). Those modes are unfortunately not available through the SoapyAirspy module (see SoapyAirspy#14).

The "Overall" gain mode is a soapy-specific driver-independent mode to configure all gain stages based on the single gain value from SATNOGS_RF_GAIN. It tries to evenly distribute the gain, potentially resulting in non-optimal configuration. Thus for achieving optimal results the "Settings Field" mode is recommended, where all three gain stages can be configured separately.

Sample rates

  • Airspy R2: SATNOGS_RX_SAMPLE_RATE=2.5e6 or 10e6
  • Airspy Mini: SATNOGS_RX_SAMPLE_RATE=3e6 or 6e6
  • Airspy HF+: SATNOGS_RX_SAMPLE_RATE=768e3

source: [2]

If you want to activate the integrated bias tee, set SATNOGS_DEV_ARGS="biastee=true". Bit packing ("Enable packing 4 12-bit samples into 3 16-bit words for 25% less USB trafic.") could be enabled with SATNOGS_DEV_ARGS="bitpacking=true" (untested). Device arguments can be concatenated with comma as delimiter.


SDRPlay support

Vendor: SDRPlay

required SoapySDR module: SoapySDRPlay

The following settings worked well for an SDRplay RSPduo when using cross-yagis and good SSB low-noise amplifiers:

  • SATNOGS_SOAPY_RX_DEVICE="driver=sdrplay"
  • SATNOGS_RX_SAMP_RATE=2e6
  • SATNOGS_RX_BANDWIDTH=600e3
  • SATNOGS_RF_GAIN=34
  • SATNOGS_ANTENNA="Tuner 1 50 ohm"

Note that 14-bits ADC resolution is only available when using sample rates below 6.048 MSPS, above which the resolution is reduced gradually to 12, 10, and 8 bits.

USRP support

Vendor: Ettus Research

required SoapySDR module: SoapyUHD

Recent USRPs that use the Analog Devices AD9361 RFIC can use almost arbitrary sample rates and analog bandwidth settings. It can be an advantage to set the sample rate as high as the host computer can handle and the analog bandwidth to as narrow as meaningful. The following settings worked well for a USRP B210 when using cross-yagis and good SSB low-noise amplifiers:

  • SATNOGS_SOAPY_RX_DEVICE="driver=uhd"
  • SATNOGS_RX_SAMP_RATE=2e6
  • SATNOGS_RX_BANDWIDTH=600e3
  • SATNOGS_RF_GAIN=50
  • SATNOGS_ANTENNA="RX2"
    • on the B200 your Antenna options are TX/RX and RX2, be sure you select the right option for your configuration!

LimeSDR support

Vendor: Lime microsystems

required SoapySDR module: SoapyLMS7 wrapper

  • SATNOGS_SOAPY_RX_DEVICE="driver=lime"
  • SATNOGS_RX_SAMP_RATE="2.048e6"
  • SATNOGS_ANTENNA="LNAW"
  • SATNOGS_GAIN_MODE="Settings Field"
  • SATNOGS_RF_GAIN=20
  • SATNOGS_OTHER_SETTINGS="TIA=12,PGA=0,LNA=12"

(untested, copied from station 1378)

Example stations:

PlutoSDR support

Vendor: Analog Devices

required SoapySDR module: SoapyPlutoSDR

  • SATNOGS_SOAPY_RX_DEVICE="driver=plutosdr"
  • SATNOGS_RX_SAMP_RATE="2e6"
  • SATNOGS_ANTENNA="A_BALANCED"
  • SATNOGS_RF_GAIN=50

HackRF support

Vendor: Great Scott Gadgets

required SoapySDR module: SoapyHackRF

  • SATNOGS_SOAPY_RX_DEVICE="driver=hackrf"
  • SATNOGS_ANTENNA="TX/RX"
  • SATNOGS_RX_SAMP_RATE="8e6"
    • HackRF supports 8 to 20MS/s. Higher than 8MS/s has not been tested with SatNOGS on a RaspberryPi
    • HackRF can run lower than 8MS/s, but it is not recommended as the ADC's filter is not designed for samplerates lower than 8MS/s


There are two possible gain modes:

"Overal", specifying just one global gain:

  • SATNOGS_GAIN_MODE="Overall"
  • SATNOGS_RF_GAIN="64" (Supported gain range: 0-116dB)


"Settings Field", specifying the individual gains.

  • SATNOGS_GAIN_MODE="Settings Field"
  • SATNOGS_OTHER_SETTINGS="AMP=14,LNA=40,VGA=48"
    • AMP: supports 0 (amp disabled) and 14 (amp enabled)
    • LNA: supports 0-40dBin 8dB steps
    • VGA: supports 0-62dB in 2dB steps


To activate bias-T power on the antenna port:

  • SATNOGS_DEV_ARGS=bias_tx=true


Example stations:

Remote

Using the SoapySDRServer running on the same machine or over the network.

Required SoapySDRServer module: SoapyRemote. Optional SoapySDRUtil to probe for SDR and settings. Make sure to match the antenna and gain setting from the actual device connected to the remote. Also possible to select remote drivers and other parameters; driver=remote,remote:driver=rtlsdr

  • SATNOGS_SOAPY_RX_DEVICE="driver=remote"
  • SATNOGS_RX_SAMP_RATE="2e6"
  • SATNOGS_ANTENNA="RX"
  • SATNOGS_RF_GAIN=20.7

Not stable.

References