Installing SDRangel for the SDRplay RSP1A and HackRF on a Raspberry Pi

SDRangel is an Open Source Qt5 / OpenGL 3.0+ SDR and signal analyzer frontend to various hardware. There are many analog and digital plugins. Transmit is supported on devices with that capability.

This document will guide you through installing SDRangel on the platform built in the Installing drivers and support for the SDRplay RSP1A on a Raspberry Pi document for your operating system and depends on that installation. This should work for the 64 bit version also.

This procedure is based on https://github.com/f4exb/sdrangel/wiki/Compile-from-source-in-Linux.

The documentation is on the wiki: https://github.com/f4exb/sdrangel/wiki.

Install:

• Before installing, set these compiler optimization flags.

  # For a 64-bit operating system on a Raspberry Pi 4:
  export CXXFLAGS='-O3 -mtune=cortex-a72'
  export CFLAGS='-O3 -mtune=cortex-a72'
  
  # For a 64-bit operating system on a Raspberry Pi 5:
  export CXXFLAGS='-O3 -mtune=cortex-a76'
  export CFLAGS='-O3 -mtune=cortex-a76'
  
  # For other operating systems:
  export CXXFLAGS='-O3 -march=native -mtune=native'
  export CFLAGS='-O3 -march=native -mtune=native'

• SDRangel
  • Prerequisites
    Most of the SDRangel requisites should be installed by now. We just need to add a few. The packager will install many additional packages.
    Install this for all OS versions:

    sudo apt-get install libopencv-dev libxml2-dev libavcodec-dev libavformat-dev graphviz bison flex ffmpeg libopus-dev libfaad-dev libqt5webengine5 qtwebengine5-dev qtbase5-private-dev libqt5svg5-dev libhidapi-dev libsamplerate0-dev libqt5gamepad5-dev libtool libflac-dev zlib1g-dev libasound2-dev zlib1g zlib1g-dev
    

  • Text to speech (optional)
    Install the espeak engine with a "dispatcher" and Qt 5 support.

    sudo apt install espeak libespeak1 speech-dispatcher-espeak libqt5texttospeech5 libqt5texttospeech5-dev qtbase5-dev qtdeclarative5-dev qtspeech5-speechd-plugin

  • Make the installation directories and assign ownership for the current user.
    

    sudo mkdir -p /opt/build
    sudo chown $USER:users /opt/build
    sudo mkdir -p /opt/install
    sudo chown $USER:users /opt/install
    

  • Install required dependencies.
    I have removed devices other than SDRplay and HackRF. We will use the previously installed hardware support. There is a new SDRplayV3 plugin built into the application. The SDRplay Mirics driver does not work for the RSP1A and has not been included.

    mkdir -p ~/SDRangel
    
    #APT
    #Aptdec is a FOSS program that decodes images transmitted by NOAA weather satellites.
    cd ~/SDRangel
    git clone https://github.com/srcejon/aptdec.git
    cd aptdec
    git checkout libaptdec
    git submodule update --init --recursive
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/aptdec ..
    make -j $(nproc) install
    
    #CM265cc
    cd ~/SDRangel
    git clone https://github.com/f4exb/cm256cc.git
    cd cm256cc
    git reset --hard 6f4a51802f5f302577d6d270a9fc0cb7a1ee28ef
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/cm256cc ..
    make -j $(nproc) install
    
    #LibDAB
    cd ~/SDRangel
    git clone https://github.com/srcejon/dab-cmdline
    cd dab-cmdline/library
    git checkout msvc
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/libdab ..
    make -j $(nproc) install
    
    #MBElib
    # If MBELIB is already installed, please skip this step.
    cd ~/
    git clone https://github.com/szechyjs/mbelib.git
    cd mbelib
    mkdir build; cd build
    cmake ..
    make -j $(nproc)
    sudo make install
    
    #SerialDV
    cd ~/SDRangel
    git clone https://github.com/f4exb/serialDV.git
    cd serialDV
    git reset --hard "v1.1.5"
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/serialdv ..
    make -j $(nproc) install
    
    #DSDcc
    cd ~/SDRangel
    git clone https://github.com/f4exb/dsdcc.git
    cd dsdcc
    git reset --hard "v1.9.6"
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/dsdcc -DUSE_MBELIB=ON -DLIBSERIALDV_INCLUDE_DIR=/opt/install/serialdv/include/serialdv -DLIBSERIALDV_LIBRARY=/opt/install/serialdv/lib/libserialdv.so ..
    make -j $(nproc) install
    
    #Codec2/FreeDV
    # If codec2/freedv is already installed, please skip this step.
    sudo apt install libspeexdsp-dev libsamplerate0-dev
    cd ~/
    git clone https://github.com/drowe67/codec2.git
    cd codec2
    mkdir build
    cd build
    cmake ..
    make -j $(nproc)
    sudo make install
    
    # manually install freedv_rx since it's not part of the default install package
    sudo install -m 0755 src/freedv_rx /usr/local/bin
    sudo install -m 0755 src/freedv_tx /usr/local/bin
    cd ../..
    sudo ldconfig
    
    #SGP4
    cd ~/SDRangel
    git clone https://github.com/dnwrnr/sgp4.git
    cd sgp4
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/sgp4 ..
    make -j $(nproc) install
    
    #LibSigMF
    #For Trixie and Ubuntu 24.04 and higher, LibSigMF will not compile with compiler optimization flags set.
    unset CXXFLAGS
    unset CFLAGS
    
    cd ~/SDRangel
    git clone https://github.com/f4exb/libsigmf.git
    cd libsigmf
    git checkout "new-namespaces"
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/libsigmf .. 
    make -j $(nproc) install
    
    #Restore the compiler flags from the beginning of this procedure.
    
    #GGMorse
    cd ~/SDRangel
    git clone https://github.com/ggerganov/ggmorse.git
    cd ggmorse
    mkdir build; cd build
    cmake -Wno-dev -DCMAKE_INSTALL_PREFIX=/opt/install/ggmorse -DGGMORSE_BUILD_TESTS=OFF -DGGMORSE_BUILD_EXAMPLES=OFF ..
    make -j $(nproc) install
    
    sudo ldconfig
    

  • Install SDRangel

    cd ~/SDRangel
    git clone https://github.com/f4exb/sdrangel.git
    cd sdrangel
    mkdir build; cd build
    cmake -Wno-dev -DDEBUG_OUTPUT=ON -DRX_SAMPLE_24BIT=ON \
    -DCMAKE_BUILD_TYPE=RelWithDebInfo \
    -DHACKRF_DIR=/usr/local \
    -DRTLSDR_DIR=/usr/lib/aarch64-linux-gnu \
    -DSOAPYSDR_DIR=/usr/local \
    -DUHD_DIR=/usr/local \
    -DAPT_DIR=/opt/install/aptdec \
    -DCM256CC_DIR=/opt/install/cm256cc \
    -DDSDCC_DIR=/opt/install/dsdcc \
    -DSERIALDV_DIR=/opt/install/serialdv \
    -DSGP4_DIR=/opt/install/sgp4 \
    -DLIBSIGMF_DIR=/opt/install/libsigmf \
    -DDAB_DIR=/opt/install/libdab \
    -DGGMORSE_DIR=/opt/install/ggmorse \
    -DCMAKE_INSTALL_PREFIX=/opt/install/sdrangel ..
    
    # If make fails, it could be a memory issue. Try make -j1 install
    make -j4 install
    sudo ldconfig
    

  • Generate a new fftw wisdom file to speed up the SDRangel startup time. This will take a long time, but it will save you from doing this every time you start SDRangel
    • Execute these commands in a terminal:

      cd ~/.config/
      # If you have not run SDRangel yet, create the settings directory.
      mkdir f4exb
      cd f4exb
      # Generate a new wisdom file for FFT sizes: 128, 256, 512, 1024, 2048, 4096, 8192, 16384 and 32768.
      # This will take a very long time.
      fftwf-wisdom -n -o fftw-wisdom 128 256 512 1024 2048 4096 8192 16384 32768
      

  • To run SDRangel, type /opt/install/sdrangel/bin/sdrangel --soapy --fftwf-wisdom ~/.config/f4exb/fftw-wisdom at the command prompt and press enter.
• Usage
  • For help setting up SDRangel, please visit: https://github.com/f4exb/sdrangel/wiki/Quick-start
  • To add an SDR device, click the Add RX device icon on the left side, in the top bar just to the right of W0 (Workspace 0).
    Select your SDR from the list and then click "OK" in the dialog.
    • Note: With SDRangel V6, it crashes when HackRF is selected. This mostly occurs in Windows, but there are problems with transmit on Linux. See https://github.com/f4exb/sdrangel/issues/718
      Use SoapySDR for HackRF.
  • Add a Channel.
    Near the top, in the Demodulator panel, click the icon just to the left of the SDR device name.
    Select the desired demodulator from the combo list and press the Apply button to add the channel to the passband. More than 1 channel can be added and active at the same time.
    When you are done, click the Close button.
    To start streaming, press the play button in the device panel.
  • To slow the waterfall display, in the Spectrum Display on the left, change Averaging type to Fix or Max. Increase the number of averaging samples to achieve the desired speed. Increase Spectrum maximum FPS until the display is smooth. Increasing the FFT size will improve the display resolution.
  • By default, the RTL-SDR has a decimation (Dec) value of 16. That leaves a very narrow bandwidth. I suggest that you change it to a lower number such as 1.
  • Click here for help setting up special digital features.
  • To set up transmitting,
    From the DeviceSets menu, select Add sink device set.
    Ensure that the desired transmit channel tab is selected on the right. (T1)
    Move on to the channels panel and click on the circled plus icon.
    Select the desired modulator from the list and click Apply.
    When you are done adding modulators, close the dialog with the Close button.
  • In the device panel, select the desired transmit channel tab on the top. (T1)
    To add an SDR device, change the device with the change device icon in the top bar of the device panel. It looks like a double arrow.
    Select your SDR from the list and then click "OK" in the dialog.
    If the transmit frequency is out of the bandpass of the receiver, it will not be able to receive a signal..
  • Click on the microphone icon in the transmit channels window to enable the sound input. Right-click on it to select the input device.
    In the device panel on the left, the Blue triangle icon means that the device is ready and can be started.
    Click it to start transmitting.
    Adjust the gain controls until you have sufficient transmit power.
  • voxangel v 1.1
    A simple pyAudio-based VOX utility for SDRangel
    • Download the script package from https://gitlab.wibisono.or.id/published/voxangel
      • From the download menu to the left of the Clone button, click one of the archive formats under Download source code
      • Save and extract it in ~/SDRangel.
      • Instructions are in ~/SDRangel/voxangel-master/README
    • The command line syntax is:
      python voxangel.py <Tx_device> [<Rx_device> <mode> <level> <delay_in_ms> <channel> <host> <port>]
    • Start the script with this command: ~/SDRangel/voxangel_1.1/voxangel.py 1 0 0 5 1100
      It will have a 1100 ms shut-off delay. By default it will monitor an input, typically the microphone if you have one.
• Set up a WSJT-X transceiver with SDRangel on a HackRF. These instructions are for FT8.
  • Prerequisites
    • WSJT-X
      • WSJT-X should be installed from the procedure on Installing utility software on a Raspberry Pi
      • voxangel, as installed above.
  • First, start two virtual audio channels, one for receive and one for transmit.

    pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
    pactl load-module module-null-sink sink_name=VirtualTx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualTx"
    

  • Start WSJT-X from the applications >Sound & Video menu
  • Start SDRangel

    /opt/install/sdrangel/bin/sdrangel --soapy --fftwf-wisdom ~/.config/f4exb/fftw-wisdom

  • Add an SDR device, baseband channel and SSB demodulator. Set it up for upper sideband. Low cut should be 0.1k, Hi cut 3.0k.
  • Add a sink device set, an SDR device, baseband channel and SSB modulator. Set it up for upper sideband. Low cut should be 0.1k, Hi cut 3.0k.
  • Set the desired SDR device frequencies for receiver and transmitter. It is best to offset the frequency by about 50 KHz to compensate for HackRF's zero spike. Add that amount to the demodulator and modulator shift.
  • In WSJT-X File>settings..., click the Audio tab. For Soundcard Input: select VirtualRx.monitor.
    For Soundcard Input: select VirtualRx. Click OK.
  • In SDRangel, click on the microphone icon in the transmit channels window to enable the sound input. Right-click on the demodulator speaker icon and select "System default device".
    Right-click on the modulator microphone icon and select "System default device".
    Start the receiver.
  • In Audio Volume control Playback tab, set QtPulseAudio:****:QtmPulseStream-****-******** on VirtualRx. (the one with receiver signal in the VU meter)
  • In Pulse Audio Volume control Recording tab, set QtPulseAudio:****:QtmPulseStream-****-******* from VirtualRx. (the one with receiver signal in the VU meter)
  • Start the transmitter. Make sure that it is connected to an acceptable antenna!
    In WSJT-X, click Tune
    In Audio Volume control Playback tab, set QtPulseAudio:****:QtmPulseStream-****-******* on VirtualTx (the strong steady signal)
  • In Pulse Audio Volume control Recording tab, set QtPulseAudio:****:QtmPulseStream-****-******** from VirtualTx (the strong steady signal)
  • Stop the transmitter and click Tune in WSJT-X to turn it off.
  • Start voxangel

    ~/SDRangel/voxangel_1.1/voxangel.py 1 0 0 5 1100

  • In Pulse Audio Volume control Recording tab, set "ALSA plug-in [python2.7]: ALSA capture from" to VirtualTx
  • Set WSJT-X to work FT8. When it transmits, SDRangel should switch to transmit. It should switch back to receive 1.1 seconds after WSJT-X stops. This time was chosen because the transmit buffer would not empty before that time. The remainder will be prepended to the next transmission. You will need to adjust the gain controls to get the best receive signal and transmit power.
  • Note: It appears that the receiver and transmitter will only work optimally if they are set to the same frequency and offset. There are times when having the same sample rate is best, however, the receiver works well at a 4 MHz sample rate. Transmit works well at a sample rate of 4000 Ks/s and Interp 32. Higher sample rates have lower latency, but watch out for dropouts.