Installing utility software on a Raspberry Pi

This document will guide you through the installation of utility applications on one of the platforms on the Operating System and driver installation page and depends on that installation.

Install:

Before installing any compiled software, set these compiler optimization flags. This must be repeated after a reboot or if you use a different terminal window. Note that with this optimization, this image may not work on other Raspberry Pi hardware.

# 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'

Hamlib (if you want to integrate WSJT-X with your SDR)
The Ham Radio Control Library-Hamlib, for short-is a project to provide programs with a consistent Application Programming Interface (API) for controlling the myriad of radios and rotators available to amateur radio and communications users. Check if hamlib is already installed and remove if you install from source. Type apt list -a libhamlib*. Look for "[installed]" in the list.
Here are two ways to install Hamlib. Choose only one.
- Installing from source
  Download the hamlib-4.5.5.tar.gz archive from https://github.com/Hamlib/Hamlib/releases to a directory such as your home directory.
```
cd ~/
tar -zxvf hamlib-4.5.5.tar.gz
cd hamlib-4.5.5
./configure
make -j 4
sudo make install
sudo ldconfig
```
- Installing from packages. It may not be the latest version. Debian Bookworm may have installed libhamlib by default.
  - sudo apt install libhamlib4 libhamlib-utils libhamlib-dev
wsjt-x
Implements digital communication protocols or "modes" called FT4, FT8, JT4, JT9, JT65, QRA64, ISCAT, MSK144, and WSPR, as well as one called Echo for detecting and measuring your own radio signals reflected from the Moon. Has comprehensive rig control using hamlib.
- Prerequisites
```
sudo apt-get install gcc g++ gfortran libgfortran5 libpulse-dev pulseaudio paprefs subversion libreadline-dev libudev-dev libportaudio2 portaudio19-dev

# This procedure does not install the docs, but if you do:
sudo apt-get install asciidoc asciidoctor texinfo

#Only if you did not install Hamlib:
#sudo apt-get install libhamlib-dev
```
- Installing from source
  - Download the latest source tarball from https://wsjt.sourceforge.io/wsjtx.html and save it in your home directory.
  - Assuming the archive is wsjtx-2.6.1.tgz, in a terminal window paste or type these commands. Installing from source instead of the packager version can give you the latest. This will take some time.
```
cd ~/
tar -zxvf wsjtx-2.6.1.tgz
cd wsjtx-2.6.1
mkdir build
cd build/
cmake -DWSJT_SKIP_MANPAGES=ON -DWSJT_GENERATE_DOCS=OFF ..
cmake --build .
sudo cmake --build . --target install
sudo ldconfig
```
- Installing from packages
  If you installed hamlib from packages, you may install WSJT-X from packages, but it may not be the latest version.
  - sudo apt install wsjtx wsjtx-data
- Setting up WSJT-X for GridTracker
  WSJT-X will appear in the Applications menu under Sound & Video.
  
  In WSJT-X File / Settings / General tab, you will need to have your Callsign and Maidenhead Grid Square set, it is recommended to set your "MH6" grid square (eg: CN84NL vs CN84) for higher map and Spot reporting accuracy. Optionally you can enable "Double-click on call sets Tx enable" and "Disable Tx after sending 73"
  You can find your grid square at http://www.levinecentral.com/ham/grid_square.php
  
  On the Reporting tab, options "Prompt me to log QSO", "Clear DX call and grid after logging" and "Accept UDP requests" are required for GridTracker to function properly with WSJT-X. Not having these enabled can lead to frustration, lost logs and strange behavior in the Map view.
  
  It is recommended to "Enable PSK Reporter Spotting" to help other WSJT-X users as well as GridTracker users to know if they are propagating and give more data to the "Band Activity Graph" in your area.
  
  In the Audio tab, select a valid Input and Output audio device.
GridTracker2
- GridTracker2 now works on a Raspberry Pi 5 running Debian.
- Download the latest GridTracker for your system (arm64.tar.gz for Raspberry Pi) from https://gridtracker.org/index.php/downloads/gridtracker-downloads
  Extract it to your home directory so that the files are in ~/GridTracker2/.
  
  A desktop file for the start menu can be found in Adding programs to the Applications Menu
fldigi
Ham Radio Digital Modem Application
- Prerequisites
```
sudo apt install libfltk1.3 libfltk1.3-dev libxft-dev libportaudio2 portaudio19-dev libsamplerate0-dev libsndfile1 libsndfile1-dev
```
- Install
  Go to http://www.w1hkj.com/files/fldigi to find the latest version.
```
cd ~/
# where 'x.xx.xx' is the version number of the most recently posted source archive...
wget http://www.w1hkj.com/files/fldigi/fldigi-x.xx.xx.tar.gz
tar xzf fldigi-x.xx.xx.tar.gz
cd fldigi-x.xx.xx
./configure

# Check that the summary printed at the end of configure is similar to the Configuration summary: on
https://sourceforge.net/p/fldigi/wiki/debian_howto/

make -j4
sudo make install
sudo ldconfig
```
- Configure and run
  - fldigi can be found in the Internet menu.
    
    In the configuration wizard that will appear on the first run, click Next.
    Enter your station information. Click Next.
    In Soundcard/Devices, select PortAudio and configure the Capture and Playback audio devices to be pulse.
    Click Next.
    Click Next.
    Click Next.
    In Rig Control/Hamlib, check Use Hamlib. In Rig: select Hamlib NET rigctl.
    You can use flrig instead of hamlib for a transceiver. The flrig installation is here.
    In Device, enter 127.0.0.1:7356. Click Initialize.
    Click Finish.
    Note: you may have to check Use Hamlib again and Click Initialize when you connect to the SDR/Radio.
    
    With the Raspberry Pi, I have found that the CPU load is too high when running run both fldigi and gqrx.
    With Cubic SDR, set audio device to Default. While receiving a signal, check that fldigi is getting audio on the indicator at the bottom of the window.
    To use hamlib with CubicSDR, run rigctld and set up as detailed in Setting up WSJT-X to work with your SDR program.
    
    Click RxID to enable the RSID (automatic mode detection and tuning) feature.
  - You can widen the waterfall display.
    - From the Configure menu, select Config Dialog > Waterfall > FFT Processing.
      Increase the upper limit to 4000
      Click Save.
  - Help finding and identifying digital signals
QSSTV Slow Scan Television (SSTV)
- Prerequisites
```
sudo apt install libv4l-0 libv4lconvert0 libv4l-dev libopenjp2-7 libopenjp2-7-dev libasound2-dev
```
- Install from source
  You can install an older version from packages, but only if you installed hamlib from packages. These instructions are for installing from source.
```
cd ~/
git clone https://github.com/ON4QZ/QSSTV.git
cd QSSTV
mkdir src/build
cd src/build
qmake .. # Ignore Compiling for x86 message
make -j4
sudo make install
sudo ldconfig

# Copy the start menu item
cp ~/QSSTV/qsstv.desktop ~/.local/share/applications
```
- Run the program
```
qsstv
```
- Setup
  - Start the virtual audio cable if not already done.
```
pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
```
  - Run your favorite SDR receiver.
  - If your SDR program is set up for hamlib, make sure that it is enabled.
  - In qsstv Options/Configuration/CAT, under Hamlib Control, select Hamlib NET rigctl
    In Serial Port/Host enter 127.0.0.1:7356
    Click Enable Hamlib Cat Interface.
    Click Restart Cat Interface. It should turn green.
    Click OK.
    In the status bar, "No Rig" will be displayed if there is no connection to the rig. Otherwise, the current frequency of the radio will be displayed.
  - To add frequencies to the menu
    Go to Options/Configuration/Frequencies. You may have to scroll the tabs to see Frequencies.
    Click add
    Enter the Frequency information.
    Go to Options/Configuration/Sound
    Click ALSA and select an audio interface.
    Click OK
  - If using GQRX,
    Open Pulse Audio Volume Control.
    Click on the Playback tab. Change "GQRX audio output on" to VirtualRx. ALSA plug-in [qsstv]: should already have Built-in Audio Digital Stereo selected.
    Click on the Recording tab. Change "ALSA plug-in [qsstv]: ALSA capture from" to "Monitor of VirtualRx".
  - Here are some starting settings for your SDR.
    - Tune to a common SSTV frequency such as 14.230 MHz USB.
      
      SDR filter bandwidth, wide enough to cover most formats:
      Low cut 800 Hz.
      High cut 3000 Hz

ADS-B (dump1090) for SDRplay
dump1090 will decode aircraft transponder messages that you can receive with your SDR.

Installation based on the github page and SDRplay Non-Windows API 3.07 workshop webinar.

sudo apt-get install librtlsdr-dev

cd ~/
git clone https://github.com/SDRplay/dump1090
cd dump1090
SDRPLAY=1 make dump1090

Run the program to see which planes you can receive along with their flight data.

cd ~/dump1090

# For SDRplay
./dump1090 --dev-sdrplay --interactive --net --fix

# For RTL-SDR 0
./dump1090 --interactive --net --fix

# To specify an RTL-SDR, change the "0" to the index number of the RTL-SDR that you want to use.
./dump1090 --device-index 0 --interactive --net --fix

Press CTRL-C when you wish to stop the program.

Install Virtual Radar Server Running under Linux with Mono
Virtual Radar Server will display the planes from dump1090 on a map.
- Install Mono
  Mono is an open source implementation of Microsoft's .NET Framework.
```
sudo apt-get install mono-complete
```
- Install Virtual Radar Server
  - Go to http://www.virtualradarserver.co.uk/Download.aspx
  - Click Download Mono Tarball to download Virtual Radar Server
  - Extract VirtualRadar.tar.gz to ~/VirtualRadar using xarchiver
  - Download VirtualRadar.exe.config.tar.gz
  - Extract VirtualRadar.exe.config to ~/VirtualRadar with xarchiver
  - Change the html port to avoid a conflict with dump1090
    - Create InstallerConfiguration.xml
```
mkdir ~/.local/share/VirtualRadar
mousepad ~/.local/share/VirtualRadar/InstallerConfiguration.xml

# Add these lines to the file and save:
<?xml version="1.0" encoding="utf-8" ?>
<InstallerSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<WebServerPort>8081</WebServerPort>
</InstallerSettings>
```
  - Start VirtualRadar.exe
```
cd ~/VirtualRadar
mono VirtualRadar.exe
```
  - Configure Virtual Radar Server
    - In the Tools menu, select Options
      Click on Receiver Locations.
      Click the green +, Enter your location name (Home), your Latitude and Longitude
      Under Receivers, click receiver.
      Click Wizard. Select A software defined radio, Dump1090, and Yes if the server is running on this computer. Click Next, then Finish.
      For Location, select the location you created (Home)
      Click OK.
  - Start dump1090
  - Open a web browser and go to http://127.0.0.1:8081/VirtualRadar/desktop.html
  - In the web browser window, Click the Gear Menu / Options
    Click "Set current location". A marker will appear on the map at the current location, probably just west of London, UK, which you can then drag over to where you actually are.
    Once it's in the right place you can remove the marker by unchecking "Set current location".
    The distances will be calculated from wherever you left the marker. By default a little blue ball on the map shows the current location.
Dire Wolf
Dire Wolf will decode APRS signals weaker than SDRangel or the gqrx AFSK1200 Decoder can decode. It will also parse the data to make it more readable.
- Prerequisites
```
sudo apt-get install avahi-daemon libavahi-client-dev libavahi-common-dev
```
  Optional if you want to transmit the location from a GPS receiver only if you have one:
  This will make the Dream installation fail.
```
sudo apt-get install gpsd libgps-dev
```
- Install Dire Wolf
  Installing Dire Wolf from packages will also install libgps and libhamlib4. Hamlib was installed from source earlier and may cause a conflict. These instructions install the latest Dire Wolf version from source.
```
cd ~/
git clone https://www.github.com/wb2osz/direwolf
cd direwolf
mkdir build && cd build
cmake ..
make -j4
sudo make install
make install-conf
sudo ldconfig
```
- There are several ways to configure Dire Wolf to receive APRS. Here are two. Choose one.
  - Using a virtual audio cable
    If you haven't already, start a virtual audio cable.
```
pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
```
```
cd ~/
direwolf -p
```
    Run your favorite SDR receiver, installation detailed later.
    If using GQRX,
    Tune to a ARPS frequency. The most common is 144.39 MHz. Mode narrow FM 12.5 KHz bandwidth. Make sure that the squelch is always open.
    Open Pulse Audio Volume Control.
    Click on the Playback tab. Change "GQRX audio output on" to VirtualRx. ALSA plug-in [direwolf]: should already have Built-in Audio Digital Stereo selected.
    Click on the Recording tab. Change "ALSA plug-in [direwolf]: ALSA capture to "Monitor of VirtualRx".
  - Stream audio to Dire Wolf over UDP with GQRX, based on this procedure.
    Run gqrx.
    Click the audio tab at the bottom of the settings area.
    Click UDP.
    Click ...
    Click the Network tab.
    Enter UDP host 127.0.0.1 (localhost does not work with direwolf).
    Enter UDP port 7355
    Close the dialogue box.
```
cd ~/
direwolf -p -n 1 -r 48000 -b 16 -D2 udp:7355
```
    If you see a warning about audio input level being too high, don't worry about it. It's only a potential problem when using the analog input of a sound card.
  - For configuration options, especially if you are transmitting, see the documentation.
    The comments in the configuration file (direwolf.conf) are helpful.
Xastir
View APRS data from Dire Wolf on a map
- Install Xastir
```
sudo apt-get install xfonts-100dpi xfonts-75dpi
xset +fp /usr/share/fonts/X11/100dpi,/usr/share/fonts/X11/75dpi

sudo apt install xastir xastir-data

# Below the Configuring xastir text box, tab to <OK> and press enter.

# After the question, Should non-superusers be able to use native AX.25 interfaces?
# Tab to <Yes> and press enter.

# Do this after the install completes, changing "pi" to your actual user:
sudo usermod -a -G xastir-ax25 pi
reboot
```
  1. From a bash shell window, run "direwolf -p" if you are using virtual audio cable or "direwolf -p -n 1 -r 48000 -b 16 -D2 udp:7355" if you are using UDP network audio.
  2. Run Xastir from another window.
  3. If Configure Station desn't appear automatically, Select menu File > Configure > Station. Enter your Callsign, location, etc.
  4. From the "Interface" menu, pick "Interface Control."
  5. Click the "Add" button.
  6. From the "Choose Interface Type" list, pick "Serial KISS TNC" and click the "Add" button.
  7. For TNC Port, enter "/tmp/kisstnc". Take all the other default values and click on "OK" button.
  8. You should now be back to the "Interface Control" dialog box. Select the device mentioning "Serial KISS TNC" and click the "Start" button. The device status should now be "UP."
  9. Click the "Close" button.
  10. Watch stations appear on the map.
- Setup suggestions
  - The default map has very little detail. To change it, from the Map menu, select Map Chooser. Most other maps will make Xastir slower.
    Click the Clear button. Click on another map such at Online/OSM_tiled_mapnic.geo. I suggest that you do not select maps that end in "/" as Xastir will be very slow.
  - Map menu/Configure/Station Text Style/Text on Black makes the type more readable.
  - With some zoom levels, blank areas may develop around the map.
Dream AM/DRM Receiver
Dream is a software implementation of a Digital Radio Mondiale (DRM) receiver. DRM can deliver FM-comparable sound quality and are specifically designed to utilise the AM broadcast bands below 30MHz (Long Wave, medium Wave and Short Wave) which allow for very-long-distance signal propagation.
Dream will decode audio from an SDR receiver to produce high quality sound.
- Prerequisites
```
sudo apt-get install apt-utils libqt5webkit5-dev libqt5webenginewidgets5 libqt5svg5-dev libpcap-dev libfdk-aac2 libfdk-aac-dev libasound2-dev libspeex1 libspeexdsp1 libspeexdsp-dev libfftw3-single3 libfftw3-double3 libfftw3-bin libfftw3-dev

# There is varying information as to how the faac and faad aac audio decoders should be installed.
# On most systems, the package version will work.
# In Bullseye, it appears that the FAAD2 and FAAC library packages have DRM enabled.
# Here are the 2 installation options for faac and faad.
```
- Option 1 - install faad and faac using packages
```
sudo apt install faad libfaad-dev libfaad2 libfaad2 faac libfaac0 libfaac-dev
```
- Option 2 - install faad and faac from source
```
# Uninistalling libfaad2 will also remove applications such as liquidsoap, muon and VLC.
sudo apt-get remove libfaad2 faac libfaac0
sudo apt install libtool-bin
```
  - Build and install the FAAD2 library
```
cd ~/
wget https://sourceforge.net/projects/faac/files/faad2-src/faad2-2.8.0/faad2-2.8.8.tar.gz
tar zxf faad2-2.8.8.tar.gz
cd faad2-2.8.8
./configure --enable-shared --disable-static --without-xmms --with-drm --without-mpeg4ip
make -j4
sudo make install
sudo ldconfig
```
  - Build and install the FAAC library
```
cd ~/
wget https://sourceforge.net/projects/faac/files/faac-src/faac-1.30/faac-1_30.tar.gz
tar zxf faac-1_30.tar.gz
cd faac-1_30
./bootstrap
# It has been suggested that --enable-drm which is supposed to enable support for encoding files for Digital Radio Mondiale actually breaks the base functionality of the package.
# This needs to be verified, as compiling without --enable-drm causes Dream to display a aac not found error message on startup.
./configure --with-pic --enable-shared --without-mp4v2 --enable-drm
make -j4
sudo make install
sudo ldconfig
```
- Build and install Dream
  This version now has the option to use SDRs through SoapySDR.
```
cd ~/
https://sourceforge.net/p/drm/code/HEAD/tree/branches/dream-mjf/

# Click Download snapshot
# Save the file. The file name will automatically change to the latest version.
drm-code-r1412-branches-dream-mjf.zip
# extract it to ~/dream
# If you extract the archive with a utility such as xarchiver, it will extract to ~/drm-code-r1412-branches-dream-mjf
# Rename the directory to dream

# Version r1412 has been modified for Hamlib 4.6. If you are using Hamlib 4.5.5, you will need to edit some files.
# Change the lines in Hamlib.h and Hamlib.cpp to add 'const' back for hamlib 4.5.5 as shown below:

# In ~/dream/src/util/Hamlib.h line 116, replace the similar line with this one:
	static int PrintHamlibModelList(const struct rig_caps* caps, void* data);

#In ~/dream/src/util/Hamlib.cpp line 344, replace the similar line with this one:
CHamlib::PrintHamlibModelList(const struct rig_caps *caps, void *data)

# Save and close the files.

cd ~/dream
qmake CONFIG+=alsa CONFIG+=sound
make -j4
sudo cp dream /usr/local/bin/dream
```
- Setting up Dream for use with an SDR receiver.
  - Start your favorite SDR receiver. I used GQRX for the examples.
  - Tune the SDR receiver to the DRM signal.
    The frequency marker should be below the lower frequency edge of the signal.
    Set receiver to USB and adjust the receiver width to encompass the signal, normally 10 KHz wide. Make the bandpass a little larger than the signal.
  - If you haven't already, start a virtual audio cable.
```
pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
```
  - Run Dream
    If Dream doesn't like your audio device, it will crash. After experimentation, I found that this works.
```
# Display help to see the command line switches
dream -h

cd ~/dream
./dream -I pulse -O pulse
```
  - Open Pulse Audio Volume Control.
    Click on the Playback tab. Change "GQRX audio output on" to VirtualRx. ALSA plug-in [dream]: should already have Built-in Audio Digital Stereo selected.
    Click on the Recording tab. Change "ALSA plug-in [dream]: ALSA capture from" to "Monitor of VirtualRx".
  - Check that there is a signal level displayed in green under Level [DB] in the Dream window.
  - From the View menu, open Evaluation dialog...
    When all of the boxes in the top center area are green, it will decode the signal and play it through the speakers. User comments suggest that SNR should be at least 20 dB.
    Suggestions:
    Set "MLC Number of Iterations" to 4.
    Select "Bandpass Filter" under "Interferer Rejection".
    If you set up hamlib, you can control it with the Stations dialog... from the View menu.
- Setting up Dream for use with an SDR using SoapySDR
  - ```
  cd ~/dream
  
  # First run Dream with a sound card input. Some systems may have a slightly different audio device string.
  ./dream --sigsrate 96000 -I pulse -O pulse
```
- Look for your SDR:
  In the Dream window, select Settings > Sound Card > Signal Input > Device
  Note your SDR's SoapySDR device # from the menu.
  Quit Deam.
  
  Once you know your SDR device name, specify it at the command line. The sigsrate 96000 is a valid sample rate for the SDRplay.
```
  ./dream --sigsrate 96000 -I "SoapySDR device #2" -O pulse
```
- Quit Dream.
  Edit ~/dream/Dream.ini. These settings improve reception for SDRplay SDRs.
  Under the section: [FrontEnd] modify the line beginning with sdr-config to be like the line below:
```
  sdr-config=gain_ctrl_mode=LEGACY,rfgain_sel=0,iqcorr_ctrl=true,agc_setpoint=-15,biasT_ctrl=false,rfnotch_ctrl=false,dabnotch_ctrl=false
```
  Change tunerfreqoffset=0 to tunerfreqoffset=-10
- Under the section: [Receiver]
  Change the lines below to match these examples:
```
  frequency=10000
  inchansel=4
  samplerateaud=48000
  sampleratesig=96000
  sigdownratio=2
  sigupratio=1
```
- Save and close Dream.ini
- To run Dream with your SDR selected, use something like the example below:
```
  ./dream -I "SoapySDR device #2" -O pulse
```
  or to use the SDR and audio output device saved in Dream.ini
```
  ./dream
```
  You may select your SDR from the Settings menu. Be sure to select a valid audio output device.
- From the View menu, open Evaluation dialog...
  When all of the boxes in the top center area are green, it will decode the signal and play it through the speakers. User comments suggest that SNR should be at least 20 dB.
  Suggestions:
  Set "MLC Number of Iterations" to 4.
  Select "Bandpass Filter" under "Interferer Rejection".
- From the View menu, open Stations dialog...
  Click Update to download the radio stations.
  Click on the station you want to listen to.
- To listen to analog radio stations
  - In the Dream window, select Settings > AM (analog).
  - If Stations window is not displayed, View > Stations Dialogue
    Click Update to download the radio stations.
    Click on the station you want to listen to.
  - In the Analog Demodulation window Input PSD display, click on 10 KHz.
    Adjust the bandwidth to your preference, usually just less than 10 KHz.
    Select an AGC setting, such as Medium.
  - Noise reduction will change the quality of the sound. The Speex option is very effective.
Soapy Remote
- Prerequisites - SoapySDR must be installed and...
```
sudo apt-get install avahi-daemon libavahi-client-dev
```
- Building Soapy Remote
  Soapy Remote allows you to fully access your SDR over your local network. CubicSDR works with this.
```
cd ~/
git clone https://github.com/pothosware/SoapyRemote.git
cd SoapyRemote
mkdir build
cd build
cmake ..
make -j 4
sudo make install
sudo ldconfig
```
- To launch the server from a terminal command prompt, simply type:
```
SoapySDRServer --bind
```
  - Alternately, you can manually specify a custom bind address:port as in these examples:
```
SoapySDRServer --bind="0.0.0.0:1234"

# IPv6 address URLs are also supported:
SoapySDRServer --bind="[::]:1234"
```
  - Substitute your IP address. The default is port 55132.
- Connecting remotely
  - You need to know the IP address of your server.
    - In a command prompt enter ip address and press enter.
    - For the network interface that you will be using, for example, wlan0, look for a line similar to inet 192.168.1.90/24
      In this example, use 192.168.1.90 for the IP address in the strings below.
- With gqrx
  - In Configure I/O Devices, under Device, select other...
    In Device string, using your IP address, enter a device string similar to one of these, depending on your SDR:
  - For SDRplay devices:
    driver=remote,remote=tcp://192.168.1.90:55132,remote:driver=sdrplay,soapy=1
  - For RTL-SDR devices:
    driver=remote,remote=tcp://192.168.1.90:55132,remote:driver=rtlsdr,soapy=1
  - For HackRF devices:
    driver=remote,remote=tcp://192.168.1.90:55132,remote:driver=hackrf,soapy=0
  - Note that with gqrx, communication may freeze with Input rates higher than 250000. HackRF works better with input rates as high as 512000.
- With CubicSDR
  - Select your device under Local Net.
  - If your devices do not appear in the SDR Devices dialogue under Local Net, using your IP address
    - Click Add,
      In the Manually add.. dialogue, select SoapyRemote
      Enter 192.168.1.90:55132 in remote address:port
- With SDRangel
  - With SoapySDRServer running, start SDRangel. Be sure to include --soapy in the command line if you are running V7 or higher.
  - To add an SDR device, click the change device icon on the left side, 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. The device name will begin with "SoapySDR".
  - Ensure that the Sample Rate (SR) is low enough for your network. Set Bandwidth (BW) the same as SR.
  - Set the frequency and press the Play button.
RSP TCP Server
- A server for SDRplay devices to make the RSP IQ stream compatible with existing RTL based software and streaming methods.This software also has an extended mode to fully support all of the RSPs capabilities and 16bit IQ stream values.
  
  Building from Source Code
```
cd ~/
git clone https://github.com/SDRplay/RSPTCPServer.git
cd RSPTCPServer
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig
```
- Run the program from a terminal command prompt
```
# Display help
rsp_tcp -h

# Examples
rsp_tcp -a 0.0.0.0 -s 960000
rsp_tcp -s 1024000
# To access from another computer on your local network
rsp_tcp -a <Your IP address> -s <Sample Rate>

# If you can set up your router, you can access rsp_tcp from the Internet.
```
- Complete instructions can be found in https://www.sdrplay.com/docs/SDRplay_RSP_TCP_Server_Guide.pdf
rtl-sdr server
- Turns your Realtek RTL2832 based DVB dongle into a SDR receiver and server. The documentation is at https://osmocom.org/projects/rtl-sdr/wiki
  
  Building from Source Code
```
cd ~/
git clone https://gitea.osmocom.org/sdr/rtl-sdr.git
cd rtl-sdr
mkdir build
cd build
cmake ../ -DINSTALL_UDEV_RULES=ON
make -j4
sudo make install
sudo cp ../rtl-sdr.rules /etc/udev/rules.d/
sudo ldconfig
```
- Terminal command prompt usage example
  - rtl_tcp -a 10.0.0.2 [-p listen port (default: 1234)":http://www.sbrac.org/files/build-gnuradio]
- To run the server and listen on all IP address (for use with remote computers)
  - rtl_tcp -a 0.0.0.0
- With gqrx
  - In Configure I/O Devices, under Device, select other...
    In Device string, using your IP address, enter rtl_tcp=192.168.1.90:1234
  - An Input rate of 960000 works very well.
HD Radio NRSC5 decoder
Some of these depencencies are for NRSC5-DUI. See the NRSC5-DUI installation below.
- Find your local stations in the HD radio guide.
- Dependencies
  - Python 3 - should have been installed previously
  - PyGObject - should have been installed previously
```
# If it needs to be installed:
# sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0
```
  - Pillow
    - For Bullseye and older systems
```
# Pillow and PIL cannot co-exist in the same environment. Before installing Pillow, please uninstall PIL.
sudo python3 -m pip install --upgrade pip
sudo python3 -m pip install --upgrade Pillow
```
    - Starting with Bookworm, pip install will fail. Recent versions of PIL have pillow included. Test the installation first as shown below.
```
sudo apt install python3-pil python3-pil.imagetk

#Test installation:
python3
import PIL
# There should be no error
^D to exit.
```
  - NumPy - should have been installed previously
  - Python Dateutil, pyOpenSSL and musicbrainzngs
```
sudo apt install python3-dateutil python3-openssl python3-musicbrainzngs
```
  - urllib3 - should have been installed previously
  - ```
  sudo apt install libao-dev libtool
  # This should have been installed for ADS-B:
  # sudo apt-get install librtlsdr-dev
```
- To install NRSC5 for SDRplay instead of the following steps. Click here.
- Install NRSC5 for RTL-SDR.
```
cd ~/
git clone https://github.com/theori-io/nrsc5.git
cd nrsc5
mkdir build
cd build
cmake -DUSE_NEON=ON -DUSE_FAAD2=ON -DLIBRARY_DEBUG_LEVEL=1 ..
make -j4
sudo make install
sudo ldconfig
```
- Running NRSC5 with a SDRplay device on the RTL-SDR version
  - To display help
```
nrsc5
```
  - Open a terminal window to start the TCP Server
```
# This will allow the server to listen on all IP addresses for more versatility.
rsp_tcp -a 0.0.0.0 -s 960000
```
  - Open another terminal window to start the NRSC5 receiver
    It may take a minute or so to get the gain set and connection made.
```
# Syntax: nrsc5 -H <IP Address> <Radios Station Frequency> <Program>
# For example:
nrsc5 -H 127.0.0.1 91.7 0
```
  - Usage
    - To switch between audio programs while the program is running, press a number 0-7
    - To quit, press Q.
- Install NRSC5-DUI
  Use nrsc5-dui to play HD Radio instead of nrsc5. It adds a GUI and other features to nrsc5.
  - The prerequisites should have been installed for nrsc5 above.
  - ```
  cd ~/
  git clone https://github.com/markjfine/nrsc5-dui.git
```
- Open another terminal window to start the TCP Server if it isn't running already.
```
  # This will allow the server to listen on all IP addresses for more versatility.
  rsp_tcp -a 0.0.0.0 -s 960000
```
- Run nrsc5-dui
```
  cd ~/nrsc5-dui
  python3 nrsc5-dui.py
```
- Configure NRSC5-DUI (for SDRplay and rsp_tcp server)
  - Click on the Settings tab
  - In SDR Radio: select RTL-SDR
  - In RTL_TCP IP, enter 127.0.0.1:1234
  - Click Enable.
  - Enable the options you want, such as Download Album Art, Include Station Art, etc.
  - In the Frequency box, enter the frequency of the station that you wish to hear.
  - Click the Triangle Play button. It will be a minute or so before it starts to play.
  - Click the Info tab to see Station Info.
  - Album Art will be present on the Album Art tab if the station supports it.
  - On the Maps tab, there may be traffic and weather maps.
- To use an RTL-SDR, use the above procedure except deselect Enable to the right of RTL_TCP IP.

pyspectrum
Python based spectrum analyser with web browser UI and sdr input

Prerequisites

sudo apt install python3-numpy python3-websockets python3-matplotlib python3-matplotlib-venn python3-soapysdr python3-flask python3-flask-restful

Due to changes in Python installation practices, we will install the remaining Python modules in a virtual environment.

Create the Python vitual environment

cd ~/
sudo apt install pipenv
pipenv shell

# Press Ctrl-D to exit when the prompt reappears.

# Your virtual environment will be located:
~/.local/share/virtualenvs/pi-xxxxxx where xxxxxx is unique

Install the additional Python modules

Install rtlsdr if you need it.

cd ~/
pipenv shell
pip install pyrtlsdr
pip install sigmf

#Test installation:
python3
import rtlsdr
import sigmf
# There should be no error
# Press Ctrl-D once to exit.

Install pyspectrum

cd ~
git clone https://github.com/naj1024/pyspectrum.git

# Press Ctrl-D to exit.

Run pyspectrum

Example command lines. Try one for an SDR that you have.

pipenv shell
cd ~/pyspectrum

# SDRplay
python3 ./src/pyspectrum.py -isoapy:sdrplay -s2e6 -c433.92e6

# HackRF, there is no feature to disable the large DC spike in the center.
python3 ./src/pyspectrum.py -isoapy:hackrf -s10e6 -c433.92e6

# RTL-SDR
python3 ./src/pyspectrum.py -irtlsdr:0 -c433.92e6 -s1e6

Open it in a web browser
- Go to http://localhost:8080.
- From another computer on your local network, use http://<local IP address of your Raspberry Pi>:8080
- If you can set up your router, you can access pyspectrum from the Internet.
- When you are finished, press Ctrl-C in the terminal to exit pyspectrum.
- Press Ctrl-D to exit the virtual environment.
For help, type python3 ./src/pyspectrum.py -h

SigDigger
A free digital signal analyzer designed to extract information of unknown radio signals. It allows adjustable demodulation of FSK, PSK and ASK signals, decode analog video, analyze bursty signals and listen to analog voice channels (all in real time). Read the User's Manual.
We would use the develop branch to get the latest features and fixes, but some of the master branches are the latest. The develop branch is not a full release.

Prerequisites

Sigutils

sudo apt install libsndfile1 libsndfile1-dev

cd ~/
git clone --recurse-submodules -b master https://github.com/BatchDrake/sigutils
cd sigutils
mkdir build
cd build
cmake ..
make -j4
sudo make install
sudo ldconfig

Suscan

sudo apt install libxml2-dev build-essential cppcheck

cd ~/
git clone --recurse-submodules -b master https://github.com/BatchDrake/suscan
cd suscan
mkdir build
cd build
cmake ..
make -j4
sudo make install
sudo ldconfig

# verify your installation by running:
suscan.status

# If everything went fine, you should see the message:
suscan.status: suscan library loaded successfully.

SuWidgets

cd ~/
git clone --recurse-submodules -b master https://github.com/BatchDrake/SuWidgets
cd SuWidgets
qmake SuWidgetsLib.pro
make -j4
sudo make install
sudo ldconfig

SigDigger

sudo apt-get install libkf5widgetsaddons-dev

cd ~/
git clone --recurse-submodules -b master https://github.com/BatchDrake/SigDigger
cd SigDigger
qmake SigDigger.pro
make -j4
sudo make install
sudo ldconfig

# To run SigDigger, type:
SigDigger

# Note that this application is under development.
# There will be a long delay when starting the application for the first time while generating FFT wisdom.

Click the Settings button. In the Source tab, select your SDR, Sample rate and Bandwidth.
Click the Audio output tab and select an Output device. PulseAudio Sound Server usually works.
The first time you enable Baseband audio preview, it will take some time to start.

Multimon-ng
MultimonNG is a Linux based decoder which is lightweight enough to run on a Raspberry Pi. It runs in a terminal window.
It decodes a variety of digital transmission modes including pagers such as POCSAG and FLEX. Click here for the full list.
There is a lot of discussion about the legailty of receiving pager messages. According to the FCC, Commercial paging is a Commercial Mobile Radio Service (CMRS) and is thus, 1) provided for profit, 2) interconnected to the public switched network, and 3) available to the public.
The rules governing commercial paging are found in the Code of Federal Regulations, Volume 47, Part 1 and Part 22 (and Part 90 for 929 MHz channels).
It is, however, illegal to disclose the contents of the messages or use any of the information you receive for illegal purposes or pecuniary gain or advantage.
- Install Multimon-ng
```
cd ~/
git clone https://github.com/EliasOenal/multimon-ng.git
cd multimon-ng
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig
```
- Decoding signals from your favorite SDR receiver
  - If you haven't already, start a virtual audio cable.
```
pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
```
  - Tune your SDR to the pager frequency.
    Set receive mode to FM, bandwidth of about 12.5 KHz. Ensure that the squelch is disabled.
  - Run Multimon-ng
    Here are some examples
```
multimon-ng -a FLEX
multimon-ng -a FLEX -a SCOPE
multimon-ng -a FLEX -a FLEX_NEXT -a SCOPE
multimon-ng -a FLEX -a POCSAG1200 -a POCSAG512 -a POCSAG2400
```
  - With PulseAudio Volume Control, on the Playback tab, set the receiver's output to VirtualRx and on the record tab, set multimon-ng to record from VirtualRx.
    Set the volume level to something reasonable, adjust for reliable decoding.
- To display only one pager's messages
  Start Multimon-ng using a command similar to this:
```
multimon-ng -a FLEX -a FLEX_NEXT | grep 1234567890
```
  Where 1234567890 is the pager's 9 or 10 digit address (capcode)

Back to the index