1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-10-31 15:07:12 -04:00
Mirror of f4exb's SDRAngel
Go to file
2018-11-23 00:25:27 +01:00
app SoapySDR support: build infrastructure and input plugin enumeration 2018-10-29 16:39:25 +01:00
appbench SoapySDR support: build infrastructure and input plugin enumeration 2018-10-29 16:39:25 +01:00
apple SDRDaemon: removed references to nanomsg entirely 2018-09-09 10:45:34 +02:00
appsrv SoapySDR support: build infrastructure and input plugin enumeration 2018-10-29 16:39:25 +01:00
cm256cc Windows: MSVC2017: adapt sdrdaemoninput plugin module (2) 2018-11-13 14:08:41 +01:00
cmake Fixed find ffmpeg cmake module 2018-11-23 00:24:42 +01:00
debian SoapySDR support: input: documentation 2018-11-22 00:41:28 +01:00
desktop Created an icon for the SDRangel desktop entry 2017-01-07 21:51:53 +01:00
devices Windows: MSVC2017: BladeRF support 2018-11-16 13:44:58 +01:00
doc SoapySDR support: updated documentation 2018-11-23 00:25:27 +01:00
dsdcc Windows: MSVC2017: adapt more channel plugin modules (1) 2018-11-13 17:29:34 +01:00
exports Windows: MSVC2017: changes in sdrbase (3) serialdv 2018-11-12 17:22:19 +01:00
fcdhid Windows build: upgrade to libusb 1.0.22. Modified install script for BladeRF 2018-09-28 16:45:08 +02:00
fcdlib FCDPro: use Qt for FCD audio device handling. Fixes in FCDProPlus 2018-11-20 01:48:17 +01:00
httpserver Windows: MSVC2017: adapt more channel plugin modules (1) 2018-11-13 17:29:34 +01:00
libairspy Windows: experimental MSVC2017 toolchain (2) 2018-11-09 19:06:23 +01:00
libairspyhf Windows: experimental MSVC2017 toolchain (2) 2018-11-09 19:06:23 +01:00
libbladerf Windows build: upgrade to libusb 1.0.22. Modified install script for BladeRF 2018-09-28 16:45:08 +02:00
libhackrf Windows: experimental MSVC2017 toolchain (2) 2018-11-09 19:06:23 +01:00
libiio Windows build: upgrade to libusb 1.0.22. Modified install script for BladeRF 2018-09-28 16:45:08 +02:00
liblimesuite LimeSuite 18.10.0: adapted Debian build 2018-10-22 18:21:09 +02:00
libmirisdr Debian build: added the detach kernel driver option for librtlsdr and libmirisdr 2017-01-09 01:00:12 +01:00
libperseus Windows build: upgrade to libusb 1.0.22. Modified install script for BladeRF 2018-09-28 16:45:08 +02:00
librtlsdr Windows: experimental MSVC2017 toolchain (2) 2018-11-09 19:06:23 +01:00
libsqlite3 CRLF problem 2017-10-04 02:00:55 +02:00
logging Windows: experimental MSVC2017 toolchain (2) 2018-11-09 19:06:23 +01:00
mbelib Windows: experimental MSVC2017 toolchain (1) 2018-11-08 19:01:13 +01:00
plugins SoapySDR support: updated documentation 2018-11-23 00:25:27 +01:00
pluginssrv BladeRF output (2) 2018-09-29 09:56:54 +02:00
qrtplib PVS-Studio Analysis corrections for less serious issues 2018-11-18 11:06:41 +01:00
rescuesdriq FileRecord improvement: unit test for the rescue program 2018-10-09 18:28:59 +02:00
sdrbase FCDProPlus: use Qt for FCD audio device handling. Fixes start up error 2018-11-19 02:33:44 +01:00
sdrbench Fixes for Arch. Manual merge of pull request #183. DATV demod: fixed some of ffmpeg deprecation warnings 2018-06-13 00:20:51 +02:00
sdrgui SoapySDR support: updated documentation 2018-11-23 00:25:27 +01:00
sdrsrv SDRDaemonSource: updated documentation 2018-09-15 10:33:04 +02:00
serialdv Windows: MSVC2017: changes in sdrbase (3) serialdv 2018-11-12 17:22:19 +01:00
swagger SoapySDR support: REST API: input: format settings and report 2018-11-14 02:06:36 +01:00
udev-rules BladerRF2 input support (7). GUI and Plugin 2018-09-25 00:38:38 +02:00
.gitignore FileRecord improvement: finalized the command to rescue corrupted .sdriq files 2018-10-09 01:06:39 +02:00
cmake_uninstall.cmake.in cmake: added install and uninstall targets 2016-02-24 11:51:36 +01:00
CMakeLists.txt LibbladeRF2: Debian build 2018-09-20 01:19:34 +02:00
Readme.md Updated general Readme with most recent changes 2018-11-07 16:37:58 +01:00
ReadmeDeveloper.md REST API: Renamed UDPSrc to UDPSink 2018-09-12 00:36:30 +02:00
ReadmeMacOS.md SDRDaemon: removed references to nanomsg entirely 2018-09-09 10:45:34 +02:00
ReadmeWindowsBuild.md SDRDaemon: removed references to nanomsg entirely 2018-09-09 10:45:34 +02:00
sdrangel.android.pro Windows build: code re-organization in two libraries sdrbase and sdrgui 2017-10-22 19:31:11 +02:00
sdrangel.macos.pro Rebuild of 3.12.0 version on macOS 10.12.6 (16G1212). 2018-03-13 13:50:34 +01:00
sdrangel.windows.pro Windows: MSVC2017: completed SoapySDR support 2018-11-16 08:15:10 +01:00
windows64.install.bat SDRDaemon: removed references to nanomsg entirely 2018-09-09 10:45:34 +02:00
windows.install.bat BladeRF: updated Windows install script 2018-10-07 19:50:23 +02:00
windowsms.install.bat Windows: MSVC2017: BladeRF support 2018-11-16 13:44:58 +01:00

SDR Angel banner

SDRangel is an Open Source Qt5 / OpenGL 3.0+ SDR and signal analyzer frontend to various hardware.

Check the discussion group here

⚠ SDRangel is intended for the power user. We expect you to already have some experience with SDR applications and digital signal processing in general. SDRangel might be a bit overwhelming for you however you are encouraged to use the discussion group above to look for help. You can also find more information in the Wiki.

Hardware requirements

SDRangel is a near real time application that is demanding on CPU power and clock speeds for low latency. Recent (2015 or later) Core i7 class CPU is recommended preferably with 4 HT CPU cores (8 logical CPUs or more) with nominal clock over 2 GHz and at least 8 GB RAM. Modern Intel processors will include a GPU suitable for proper OpenGL support. On the other hand SDRangel is not as demanding as recent computer games for graphics and CPU integrated graphics are perfectly fine. USB-3 ports are also preferable for high speed, low latency USB communication. It may run on beefy SBCs and was tested successfully on a Udoo Ultra.

The server variant does not need a graphical display and therefore OpenGL support. It can run on smaller devices check the Wiki for hardware requirements and a list of successful cases.

Source code

Repository branches

  • master: the production branch
  • dev: the development branch
  • legacy: the modified code from the parent application hexameron rtl-sdrangelove before a major redesign of the code was carried out and sync was lost.

Untested plugins

These plugins come from the parent code base and have been maintained so that they compile but they are not being actively tested:

channelrx:

  • demodlora

Specific features

Multiple device support

Since version 2 SDRangel can integrate more than one hardware device running concurrently.

Transmission support

Since version 3 transmission or signal generation is supported for BladeRF, HackRF (since version 3.1), LimeSDR (since version 3.4) and PlutoSDR (since version 3.7.8) using a sample sink plugin. These plugins are:

REST API

Since version 4 a REST API is available to interact with the SDRangel application. More details are provided in the server instance documentation in the sdrsrv folder.

Server instance

Since version 4 the sdrangelsrv binary launches a server mode SDRangel instance that runs wihout the GUI. More information is provided in the Readme file of the sdrsrv folder.

Detached RF head server (SDRdaemon)

Since version 4.1 the previously separated project SDRdaemon has been modified and included in SDRangel. The sdrangelsrv headless variant can be used for this purpose using the Daemon source or sink channels.

Notes on pulseaudio setup

The audio devices with Qt are supported through pulseaudio and unless you are using a single sound chip (or card) with a single output port or you are an expert with pulseaudio config files you may get into trouble when trying to route the audio to a different output port. These notes are a follow-up of issue #31 with my own experiments with HDMI audio output on the Udoo x86 board. So using this example of HDMI output you can do the following:

  • Install pavucontrol. It is included in most distributions for example:
    • Ubuntu/Debian: sudo apt-get install pavucontrol
    • openSUSE: sudo zypper in pavucontrol
  • Check the audio config with alsamixer. On the Udoo x86 the HDMI output depends on the S/PDIF control and it occasionally gets muted when the HDMI monitor is turned off or goes to sleep. So in any case make sure nothing is muted there.
  • Open pavucontrol and open the last tab (rightmost) called 'Configuration'
  • Select HDMI from the profiles list in the 'Configuration' tab
  • Then in the 'Output devices' tab the HDMI / display port is selected as it is normally the only one. Just double check this
  • In SDRangel's Preferences/Audio menu make sure something like alsa_output.pci-0000_00_1b.0.hdmi-stereo is selected. The default might also work after the pulseaudio configuration you just made.

In case you cannot see anything related to HDMI or your desired audio device in pavucontrol just restart pulseaudio with pulseaudio -k (-k kills the previous instance before restarting) and do the above steps again.

Supported hardware

Airspy

Airspy R2 and Airspy Mini are supported through the libairspy library that should be installed in your system for proper build of the software and operation support. Add libairspy-dev to the list of dependencies to install.

If you use your own location for libairspy install directory you need to specify library and include locations. Example with /opt/install/libairspy with the following defines on cmake command line:

-DLIBAIRSPY_LIBRARIES=/opt/install/libairspy/lib/libairspy.so -DLIBAIRSPY_INCLUDE_DIR=/opt/install/libairspy/include

Please note that if you are using a recent version of libairspy (>= 1.0.6) the dynamic retrieval of sample rates is supported. To benefit from it you should modify the plugins/samplesource/airspy/CMakeLists.txt and change line add_definitions(${QT_DEFINITIONS}) by add_definitions("${QT_DEFINITIONS} -DLIBAIRSPY_DYN_RATES"). In fact both lines are present with the last one commented out.

Be also aware that the lower rates (2.5 MS/s or 5 MS/s with modified firmware) are affected by a noise artifact so 10 MS/s is preferable for weak signal work or instrumentation. A decimation by 64 was implemented to facilitate narrow band work at 10 MS/s input rate.

Airspy HF+

Airspy HF+ is supported through the airspyhf library.

If you use your own location for libairspyhf install directory you need to specify library and include locations. Example with /opt/install/libairspyhf with the following defines on cmake command line:

-DLIBAIRSPYHF_LIBRARIES=/opt/install/libairspyhf/lib/libairspyhf.so -DLIBAIRSPYHF_INCLUDE_DIR=/opt/install/libairspyhf/include

It is recommended to add -DRX_SAMPLE_24BIT=ON on the cmake command line to activate the Rx 24 bit DSP build and take advantage of improved dynamic range when using decimation.

☞ From version 3.12.0 the Linux binaries are built with the 24 bit Rx option.

BladeRF classic (v.1)

BladeRF1 is supported through the libbladeRF library that should be installed in your system for proper build of the software and operation support. Add libbladerf-dev to the list of dependencies to install. Note that libbladeRF v2 is used since version 4.2.0 (git tag 2018.08).

If you compile and use your own location for libbladeRF install directory you need to specify library and include locations. Example with /opt/install/libbladerf with the following defines on cmake command line:

-DLIBBLADERF_LIBRARIES=/opt/install/libbladeRF/lib/libbladeRF.so -DLIBBLADERF_INCLUDE_DIR=/opt/install/libbladeRF/include

☞ Please note that if you use your own library the FPGA image hostedx40.rbf or hostedx115.rbf shoud be placed in e.g. /opt/install/libbladeRF/share/Nuand/bladeRF unless you have flashed the FPGA image inside the BladeRF.

The plugins used to support BladeRF classic are specific to this version of the BladeRF:

BladeRF micro (v.2)

From version 4.2.0.

BladeRF 2 micro is also supported using libbladeRF library that should be installed and configured in the same way as for BladeRF1.

The plugins used to support BladeRF 2 micro are specific to this version of the BladeRF:

FunCube Dongle

Linux only.

Both Pro and Pro+ are supported with the plugins in fcdpro and fcdproplus respectively. For the Pro+ the band filter selection is not effective as it is handled by the firmware using the center frequency.

The control interface is based on qthid and has been built in the software in the fcdhid library. You don't need anything else than libusb support. Library fcdlib is used to store the constants for each dongle type.

The Pro+ has trouble starting. The sound card interface is not recognized when you just plug it in and start SDRAngel. The workaround is to start qthid then a recording program like Audacity and start recording in Audacity. Then just quit Audacity without saving and quit qthid. After this operation the Pro+ should be recognized by SDRAngel until you unplug it.

HackRF

HackRF is supported through the libhackrf library that should be installed in your system for proper build of the software and operation support. Add libhackrf-dev to the list of dependencies to install. Please note that you will need a recent version (2015.07.2 at least) of libhackrf that supports the sequential listing of devices and the antenna power control (bias tee). To be safe anyway you may choose to build and install the Github version: https://github.com/mossmann/hackrf.git. Note also that the firmware must be updated to match the library version as per instructions found in the HackRF wiki.

If you use your own location for libhackrf install directory you need to specify library and include locations. Example with /opt/install/libhackrf with the following defines on cmake command line:

-DLIBHACKRF_LIBRARIES=/opt/install/libhackrf/lib/libhackrf.so -DLIBHACKRF_INCLUDE_DIR=/opt/install/libhackrf/include

HackRF is better used with a sampling rate of 4.8 MS/s and above. The 2.4 and 3.2 MS/s rates are considered experimental and are way out of specs of the ADC. You may or may not achieve acceptable results depending on the unit. A too low sampling rate will typically create ghost signals (images) and/or raise the noise floor.

LimeSDR

LimeSDR and its smaller clone LimeSDR Mini are supported using LimeSuite library (see next).

⚠ Version 18.10.0 of LimeSuite is used in the builds and corresponding gateware loaded in the LimeSDR should be is used. If you compile from source version 18.10.0 of LimeSuite must be used.

⚠ LimeSDR-Mini seems to have problems with Zadig driver therefore it is supported in Linux only.

  • sudo apt-get install libsqlite3-dev
  • git clone https://github.com/myriadrf/LimeSuite.git
  • cd LimeSuite
  • mkdir builddir
  • cd builddir
  • cmake -DCMAKE_INSTALL_PREFIX=/opt/install/LimeSuite ..
  • make -j8
  • make install

Then add the following defines on cmake command line:

-DLIMESUITE_INCLUDE_DIR=/opt/install/LimeSuite/include -DLIMESUITE_LIBRARY=/opt/install/LimeSuite/lib/libLimeSuite.so

Perseus

Linux only.

The Perseus is supported with my fork of libperseus-sdr library on the fixes branch which is the default. There are a few fixes from the original mainly to make it work in a multi-device context.

Please note that the Perseus input plugin will be built only if the 24 bit Rx DSP chain is activated in the compilation with the -DRX_SAMPLE_24BIT=ON option on the cmake command line.

If you use your own location for libperseus-sdr install directory you need to specify library and include locations. Example with /opt/install/libperseus with the following defines on cmake command line: -DLIBPERSEUS_INCLUDE_DIR=/opt/install/libperseus/include -DLIBPERSEUS_LIBRARIES=/opt/install/libperseus/lib/libperseus-sdr.so.

☞ From version 3.12.0 the Linux binaries are built with the 24 bit Rx option and Perseus input plugin.

PlutoSDR

PlutoSDR is supported with the libiio interface. This library should be installed in your system for proper build of the software and operation support. Add libiio-dev to the list of dependencies to install. Be aware that version 0.10 is needed and is not available yet in all distributions. You may have to compile it from source instead.

If you use your own location for libiio install directory you need to specify library and include locations. Example with /opt/install/libiio with the following defines on cmake command line: -DLIBIIO_INCLUDE_DIR=/opt/install/libiio/include -DLIBIIO_LIBRARY=/opt/install/libiio/lib/libiio.so. In openSUSE the lib directory path would be: -DLIBIIO_LIBRARY=/opt/install/libiio/lib64/libiio.so.

RTL-SDR

RTL-SDR based dongles are supported through the librtlsdr library that should be installed in your system for proper build of the software and operation support. Add librtlsdr-dev to the list of dependencies to install.

If you use your own location for librtlsdr install directory you need to specify library and include locations. Example with /opt/install/librtlsdr with the following defines on cmake command line:

-DLIBRTLSDR_LIBRARIES=/opt/install/librtlsdr/lib/librtlsdr.so -DLIBRTLSDR_INCLUDE_DIR=/opt/install/librtlsdr/include

SDRplay RSP1

Linux only.

SDRplay RSP1 is supported through the libmirisdr-4 library found in this very same Github space. There is no package distribution for this library and you will have to clone it, build and install it in your system. However Debian packages of SDRangel contain a pre-compiled version of this library.

If you use your own location for libmirisdr-4 install directory you need to specify library and include locations with cmake. For example with /opt/install/libmirisdr the following defines must be added on cmake command line:

-DLIBMIRISDR_LIBRARIES=/opt/install/libmirisdr/lib/libmirisdr.so -DLIBMIRISDR_INCLUDE_DIR=/opt/install/libmirisdr/include

⚠ The RSP1 has been discontinued in favor of RSP1A. Unfortunately due to their closed source nature RSP1A nor RSP2 can be supported in SDRangel.

Plugins for special devices

These plugins do not use any hardware device connected to your system.

File input

The File source plugin allows the playback of a recorded IQ file. Such a file is obtained using the recording feature. Click on the record button on the left of the main frequency dial to toggle recording. The file has a fixed name test_<n>.sdriq created in the current directory where <n> is the device tab index.

Note that this plugin does not require any of the hardware support libraries nor the libusb library. It is always available in the list of devices as FileSource[0] even if no physical device is connected.

The .sdriq format produced are the 2x2 bytes I/Q samples with a header containing the center frequency of the baseband, the sample rate and the timestamp of the recording start. Note that this header length is a multiple of the sample size so the file can be read with a simple 2x2 bytes I/Q reader such as a GNU Radio file source block. It will just produce a short glitch at the beginning corresponding to the header data.

File output

The File sink plugin allows the recording of the I/Q baseband signal produced by a transmission chain to a file in the .sdriq format thus readable by the file source plugin described just above.

Note that this plugin does not require any of the hardware support libraries nor the libusb library. It is always available in the list of devices as FileSink[0] even if no physical device is connected.

Test source

The Test source plugin is an internal continuous wave generator that can be used to carry out test of software internals.

SDRdaemon receiver input

Linux only.

The SDRdaemon source input plugin is the client side of an instance of SDRangel running the Daemon Sink channel plugin. On the "Data" line you must specify the local address and UDP port to which the remote server connects and samples will flow into the SDRangel application (default is 127.0.0.1port 9090). It uses the meta data to retrieve the sample flow characteristics such as sample rate and receiving center frequency. The remote is entirely controlled by the REST API. On the "API" line you can specify the address and port at which the remote REST API listens. However it is used just to display basic information about the remote.

The data blocks transmitted via UDP are protected against loss with a Cauchy MDS block erasure codec. This makes the transmission more robust in particular with WiFi links.

There is an automated skew rate compensation in place. During rate readjustment streaming can be suspended or signal glitches can occur for about one second.

This plugin will be built only if the CM256cc library is installed in your system. For CM256cc if you install it in a non standard directory you will then have to specify the include and library paths on the cmake command line. Say if you install cm256cc in /opt/install/cm256cc you will have to add -DCM256CC_INCLUDE_DIR=/opt/install/cm256cc/include/cm256cc -DCM256CC_LIBRARIES=/opt/install/cm256cc/lib/libcm256cc.so to the cmake commands.

Note that this plugin does not require any of the hardware support libraries nor the libusb library. It is always available in the list of devices as SDRdaemonSource[0] even if no physical device is connected.

SDRdaemon transmitter output

Linux only.

The SDRdaemon sink output plugin is the client side of and instance of SDRangel running the Daemon Source channel plugin. On the "Data" line you must specify the distant address and UDP port to which the plugin connects and samples from the SDRangel application will flow into the transmitter server (default is 127.0.0.1port 9090). The remote is entirely controlled by the REST API. On the "API" line you can specify the address and port at which the remote REST API listens. The API is pinged regularly to retrieve the status of the data blocks queue and allow rate control to stabilize the queue length. Therefore it is important to connect to the API properly (The status line must return "API OK" and the API label should be lit in green).

The data blocks sent via UDP are protected against loss with a Cauchy MDS block erasure codec. This makes the transmission more robust in particular with WiFi links.

This plugin will be built only if the CM256cc library IS installed in your system. For CM256cc if you install it in a non standard directory you will then have to specify the include and library paths on the cmake command line. Say if you install cm256cc in /opt/install/cm256cc you will have to add -DCM256CC_INCLUDE_DIR=/opt/install/cm256cc/include/cm256cc -DCM256CC_LIBRARIES=/opt/install/cm256cc/lib/libcm256cc.so to the cmake commands.

Note that this plugin does not require any of the hardware support libraries nor the libusb library. It is always available in the list of devices as SDRdaemonSink[0] even if no physical device is connected.

Channel plugins with special conditions

DSD (Digital Speech Decoder)

This is the demoddsd plugin. At present it can be used to decode the following digital speech formats:

  • DMR/MOTOTRBO
  • dPMR
  • D-Star
  • Yaesu System Fusion (YSF)
  • NXDN

It is based on the DSDcc C++ library which is a rewrite of the original DSD program. So you will need to have DSDcc installed in your system. Please follow instructions in DSDcc readme to build and install DSDcc. If you install it in a custom location say /opt/install/dsdcc you will need to add these defines to the cmake command: -DLIBDSDCC_INCLUDE_DIR=/opt/install/dsdcc/include/dsdcc -DLIBDSDCC_LIBRARIES=/opt/install/dsdcc/lib/libdsdcc.so

If you have one or more serial devices interfacing the AMBE3000 chip in packet mode you can use them to decode AMBE voice frames. For that purpose you will need to compile with SerialDV support. Please refer to this project Readme.md to compile and install SerialDV. If you install it in a custom location say /opt/install/serialdv you will need to add these defines to the cmake command: -DLIBSERIALDV_INCLUDE_DIR=/opt/install/serialdv/include/serialdv -DLIBSERIALDV_LIBRARY=/opt/install/serialdv/lib/libserialdv.so Also your user must be a member of group dialout (Ubuntu/Debian) or uucp (Arch) to be able to use the dongle.

Although such serial devices work with a serial interface at 400 kb in practice maybe for other reasons they are capable of handling only one conversation at a time. The software will allocate the device dynamically to a conversation with an inactivity timeout of 1 second so that conversations do not get interrupted constantly making the audio output too choppy. In practice you will have to have as many devices connected to your system as the number of conversations you would like to be handled in parallel.

Alternatively you can use mbelib but mbelib comes with some copyright issues (see next). If you have mbelib installed in a custom location, say /opt/install/mbelib you will need to add these defines to the cmake command: -DLIBMBE_INCLUDE_DIR=/opt/install/mbelib/include -DLIBMBE_LIBRARY=/opt/install/mbelib/lib/libmbe.so

Possible copyright issues apart (see next) the audio quality with the DVSI AMBE chip is much better.

While DSDcc is intended to be patent-free, mbelib that it uses describes functions that may be covered by one or more U.S. patents owned by DVSI Inc. The source code itself should not be infringing as it merely describes possible methods of implementation. Compiling or using mbelib may infringe on patents rights in your jurisdiction and/or require licensing. It is unknown if DVSI will sell licenses for software that uses mbelib.

Possible copyright issues apart the audio quality with the DVSI AMBE chip is much better.

If you are not comfortable with this just do not install DSDcc and/or mbelib and the plugin will not be compiled and added to SDRangel. For packaged distributions just remove from the installation directory:

  • For Linux distributions: plugins/channel/libdemoddsd.so
  • For Windows distribution: dsdcc.dll, mbelib.dll, plugins\channel\demoddsd.dll

Software distributions

In the releases section one can find binary distributions for some Debian based distributions:

  • Ubuntu 18.04 (Bionic)
  • Ubuntu 16.04 (Xenial)
  • Debian Stretch

Debian distributions

It is provided in the form of .deb packages for x86_64 architectures with SSE 4.1 support.

Install it as usual for .deb packages:

  • Make sure the universe repository is in your /etc/apt/sources.list

Prior to apt-get v 1.1 (before Ubuntu 16.04) in a terminal do:

  • sudo apt-get update
  • sudo apt-get upgrade
  • sudo dpkg -i sdrangel_vx.y.z-1_amd64.deb where x.y.z is the version number
  • sudo apt-get -f install this will install missing dependencies

Since apt-get v 1.1 installation is possible from a local file:

  • cd to where the archive has been downloaded
  • sudo apt-get install ./sdrangel_vx.y.z-1_amd64.deb where x.y.z is the version number
  • sudo apt-get -f install this will install missing dependencies

The software is installed in /opt/sdrangel you can start it from the command line with:

  • /opt/sdrangel/bin/sdrangel

The udev rules are not set by the package installation so you will have to set it manually in order to be able to access the various SDR hardware. The udev-rules folder contains the rules file and the install.sh script that you can run as sudo to install all rules files. You may also adapt the script to copy only the required files.

Ubuntu 18.04

The default CPU governor is now powersave which exhibits excessive CPU usage when running SDRangel. In the case of benchmarking and maybe high throughput usage it is recommended to switch to performance before running SDRangel by running the command: sudo cpupower frequency-set --governor performance. You can turn it back to powersave any time by running: sudo cpupower frequency-set --governor powersave. It is normal that with a lower CPU frequency the relative CPU usage rises for the same actual load. If not impairing operation this is normal and overall beneficial for heat and power consumption.

Windows distribution

This is the archive of the complete binary distribution that expands to the sdrangel directory. You can install it anywhere you like and click on sdrangel.exe to start.

⚠ Windows distribution is provided as a by product thanks to the Qt toolchain. The platform of choice to run SDRangel is definitely Linux and very little support can be given for this Windows distribution.

Software build

Qt version

To be sure you will need at least Qt version 5.5. It definitely does not work with versions earlier than 5.3 but neither 5.3 nor 5.4 were tested.

  • Linux builds are made with 5.5.1 (Xenial), 5.9 (Artful, Stretch, Bionic) and 5.11 (Cosmic)
  • Windows build is made with 5.10.1 in 32 bit mode and has Qt ANGLE support (OpenGL emulation with DirectX)

24 bit DSP

By default all Rx DSP processes use 16 bit samples coded on int16 fields. In order to use 24 bit samples coded on int32 fields you can specify -DRX_SAMPLE_24BIT=ON on the cmake command line. This will give more dynamic range when the number of bits with decimation exceeds 16 bits:

  • RTL-SDR, HackRF: (8 bit native) no advantage
  • Funcube Pro and Pro+: (16 bit native) no decimation hence no advantage
  • Airspy, BladeRF, LimeSDR, PlutoSDR, SDRPlay: (12 bit native) advantage for decimation by 32 or 64
  • AirspyHF: (16 bit native) advantage for any decimation

☞ From version 3.12.0 the Linux binaries are built with the 24 bit Rx option.

Ubuntu

Prerequisites for 14.04 LTS

Prerequisite to install Qt5 libraries properly: sudo apt-get install libgles2-mesa-dev

Install cmake version 3:

  • sudo apt-get install software-properties-common
  • sudo add-apt-repository ppa:george-edison55/cmake-3.x
  • sudo apt-get update
  • sudo apt-get remove cmake (if already installed)
  • sudo apt-get install cmake

Prerequisites for 16.04 LTS

For DATV demodulator support you need to install the ffmpeg v.3 suite. Therefore you will need to add this PPA to the sources list using this command: sudo add-apt-repository ppa:jonathonf/ffmpeg-3

Then do sudo apt-get update and go to the next step. Alternatively if you have an older version of ffmpeg suite already installed just do sudo apt-get dist-upgrde.

With newer versions just do:

  • sudo apt-get install cmake g++ pkg-config libfftw3-dev libqt5multimedia5-plugins qtmultimedia5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtbase5-dev libusb-1.0 librtlsdr-dev libboost-all-dev libasound2-dev pulseaudio libopencv-dev libsqlite3-dev libxml2-dev bison flex ffmpeg libavcodec-dev libavformat-dev
  • mkdir build && cd build && cmake ../ && make

librtlsdr-dev is in the universe repo. (utopic 14.10 amd64.)

Mint

Tested with Cinnamon 17.2. Since it is based on Ubuntu 14.04 LTS please follow instructions for this distribution (paragraph just above).

Debian

For any version of Debian you will need Qt5.

Debian 7 "wheezy" uses Qt4. Qt5 is available from the "wheezy-backports" repo, but this will remove Qt4. Debian 8 "jessie" uses Qt5.

For Debian Jessie or Stretch:

sudo apt-get install cmake g++ pkg-config libfftw3-dev libusb-1.0-0-dev libusb-dev qt5-default qtbase5-dev qtchooser libqt5multimedia5-plugins qtmultimedia5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtbase5-dev librtlsdr-dev libboost-all-dev libasound2-dev pulseaudio libopencv-dev libsqlite3-dev libxml2-dev bison flex ffmpeg libavcodec-dev libavformat-dev

mkdir build && cd build && cmake ../ && make

openSUSE

This has been tested with the Leap 42.3 distribution:

sudo zypper install Mesa-libGL1 Mesa-libEGL-devel Mesa-libGL-devel Mesa-libGLESv1_CM-devel Mesa-libGLESv2-devel Mesa-libGLESv3-devel Mesa-libglapi-devel libOSMesa-devel

sudo zypper install cmake fftw3-devel gcc-c++ libusb-1_0-devel libqt5-qtbase-devel libQt5OpenGL-devel libqt5-qtmultimedia-devel libqt5-qttools-devel libQt5Network-devel libQt5Widgets-devel boost-devel alsa-devel pulseaudio opencv-devel

Then you should be all set to build the software with cmake and make as discussed earlier.

  • Note1: if you are on Leap you will need a more recent g++ compiler so in place of gcc-c++ use gcc6-c++ or gcc7-c++ then add the following in the cmake command: -DCMAKE_C_COMPILER=/usr/bin/gcc-7 -DCMAKE_CXX_COMPILER=/usr/bin/g++-7 (for gcc 7) and then -DCMAKE_INSTALL_PREFIX:PATH=... for the custom install path (not -DCMAKE_INSTALL_PREFIX=...)
  • Note2 for udev rules: installed udev rules for BladeRF and HackRF are targeted at Debian or Ubuntu systems that have a plugdev group for USB hotplug devices. This is not the case in openSUSE. To fix it you can either:
    • make the udev rules file compatible just remove the GROUP parameter on all lines and change MODE parameter to 666.
    • create a plugdev group and add it tou your user group list: sudo groupadd plugdev then sudo usermod -G plugdev -a <user>
  • Note3: A package has been created in openSUSE thanks to Martin, see: sdrangel. It is based on the latest release on master branch.

Fedora

This has been tested with Fedora 23 and 22:

  • sudo dnf groupinstall "C Development Tools and Libraries"
  • sudo dnf install mesa-libGL-devel
  • sudo dnf install cmake gcc-c++ pkgconfig fftw-devel libusb-devel qt5-qtbase-devel qt5-qtmultimedia-devel qt5-qttools-devel boost-devel pulseaudio alsa-lib-devel

Then you should be all set to build the software with cmake and make as discussed earlier.

  • Note for udev rules: the same as for openSUSE applies. This is detailed in the previous paragraph for openSUSE.

Arch Linux / Manjaro

Tested with the 15.09 version with LXDE desktop (community supported). The exact desktop environment should not matter anyway. Prerequisites should be similar for Arch and all derivatives.

sudo pacman -S cmake pkg-config fftw qt5-multimedia qt5-tools qt5-base libusb boost boost-libs pulseaudio

Then you should be all set to build the software with cmake and make as discussed earlier.

  • Note1 for udev rules: the same as for openSUSE and Fedora applies.
  • Note2: Two package are avaliable in the AUR (thanks Mikos!), sdrangel, which provides the lastest tagged release (stable), and sdrangel-git, which builds the latest commit from this repository (unstable).

Windows

This is a rather long story and one may prefer using the software distribution instead. However the brave may follow this link

Mac O/S

A Mac O/S build was contributed from version 2.0.1. Please be aware that this is still experimental.

Android

Despite several attempts and the presence of Android related stuff still present in the .pro files there is no Android build available. An APK can be built but Qt fails miserably at porting applications other than its ridiculously simple examples. When multi-threading is involved a lot like in SDRangel this simply crashes at the very beginning of the application when starting the event loop.

Contributors welcome!

Software installation on Linux flavours

Simply do make install or sudo make install depending on you user rights on the target installation directory. On most systems the default installation directory is /usr/local a custom installation directory can be specified with the -DCMAKE_INSTALL_PREFIX=... option on the cmake command line as usual with cmake.

You can uninstall the software with make uninstall or sudo make uninstall from the build directory (it needs the install_manifest.txt file in the same directory and is automatically created by the make installcommand). Note that this will not remove the possible empty directories.

Known Issues

  • The message queuing model supports a n:1 connection to an object (on its input queue) and a 1:1 connection from an object (on its output queue). Assuming a different model can cause insidious disruptions.
  • As the objects input and output queues can be publicly accessed there is no strict control of which objects post messages on these queues. The correct assumption is that messages can be popped from the input queue only by its holder and that messages can be pushed on the output queue only by its holder.
  • Objects managing more than one message queue (input + output for example) do not work well under stress conditions. Output queue removed from sample sources but this model has to be revised throughout the application.
  • SDRdaemon FEC plugin: it has trouble doing the first connection or reconnecting to another device. The best option is to try then acknowledge the error message and restart SDRangel.

Limitations

  • Your hardware. Still SDRangel is relatively conservative on computer resources.
  • OpenGL 3+

Features

Changes from SDRangelove

See the v1.0.1 first official release release notes

To Do

Since version 3.3.2 the "todos" are in the form of tickets opened in the Issues section with the label "feature". When a specific release is targeted it will appear as a milestone. Thus anyone can open a "feature" issue to request a new feature.

Other ideas:

  • Enhance presets management (Edit, Move, Import/Export from/to human readable format like JSON).
  • Allow arbitrary sample rate for channelizers and demodulators (not multiple of 48 kHz). Prerequisite for polyphase channelizer
  • Implement polyphase channelizer
  • Level calibration
  • Even more demods. Contributors welcome!

Developer's notes

Please check the developer's specific readme