Installing additional 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'

Equalizers and notch filters. You should only need one.
- pulseaudio-equalizer
  - sudo apt install pulseaudio-equalizer
```
mousepad ~/.config/pulse/default.pa
```
    Ensure that this include statement is present in the file:
```
.include /etc/pulse/default.pa
```
    Add these lines to the end of the file:
```
load-module module-equalizer-sink
load-module module-dbus-protocol
```
  - reboot
  - Start the pulseaudio equalizer
    - qpaeq
    - If you are a wayland user, start the equalizer this way instead:
      QT_QPA_PLATFORM=wayland qpaeq
  - Set your SDR program (source) to use the FFT based equalizer sink.
    If you resize the equalizer's window, widening it, more controls appear for narrower audio frequency bands, allowing finer tuning.
    To notch out an unwanted heterodyne (continuous tone), lower the slider for the offending frequency.
- Easy Effects, Audio effects for PipeWire applications. For systems using PulseAudio, click here to install PulseEffects.
  PipeWire is required. PipeWire is installed by default on Raspberry Pi OS Bookworm.
  If you want to install the rnnoise filter, you will have to compile easyeffects from source.
  Choose one of the installation methods below:
  - Install the package
    - sudo apt install easyeffects
    - Jump down to the reboot step.
  - Compile from source
    - Prerequisites
```
sudo apt install build-essential libpipewire-0.3-dev libpulse-dev libjack-dev portaudio19-dev libgtk-3-dev libglib2.0-dev meson ninja-build desktop-file-utils
sudo apt install autogen configure-debian dh-autoreconf libspeex1 libspeexdsp1 libspeexdsp-dev libspeex-dev calf-plugins mda-lv2 lsp-plugins-lv2 zam-plugins
sudo apt install gettext itstool ladspa-sdk libzita-convolver4 libzita-convolver-dev libtbb12 libtbb-dev libgtk-4-bin libgtk-4-dev libadwaita-1-0 libadwaita-1-dev libsigc++-3.0-0 libsigc++-3.0-dev
sudo apt install liblilv-0-0 liblilv-dev libbs2b0 libbs2b-dev libebur128-1 libebur128-dev libsamplerate0 libsamplerate0-dev librubberband2 rubberband-ladspa librubberband-dev libsoundtouch1 libsoundtouch-dev

# Build rnnoise
cd ~/
git clone https://gitlab.xiph.org/xiph/rnnoise.git
cd rnnoise
./autogen.sh
./configure
make -j4
sudo make install
sudo ldconfig
```
    - Build easyeffects
```
cd ~/
git clone https://github.com/wwmm/easyeffects.git
cd easyeffects

# For bookworm, v7.0.1 is the latest version that will work.
git checkout v7.0.1
meson _build --prefix=/usr
sudo ninja -C _build install
sudo ldconfig
```
  - reboot
  - Make a notch filter with easyeffects
    - In Easy Effects, select the Output from your application
      Click Effects at the bottom of the window.
      Click Add Effect.
      Scroll down to Filter and click "+".
      In the filter window, select 18dB/oct Bandreject.
      Under resonance, enter 30 dB.
      Enter the frequency that you want to notch out.
  - Customizing the spectrum display
    - Click the Menu button on the title bar near the right edge.
      Click Preferences.
      Click the Spectrum tab.
      You can increase the number of points to help in identifying an unwanted carrier.
      You can choose lines if you prefer to make the display have curves.
  - Noise reduction with Speech Processor using Speex
    This noise reduction is very effective. Sometimes a strong signal will temporarily interfere with its operation.
    - In Easy Effects, select the Output from your application
      Click Effects at the bottom of the window.
      Click Add Effect.
      Scroll down to Speech Processor and click "+".
      In the filter window, enable Denoise
      In Noise Suppression, adjust Level. Start at -12.0 dB.
Grig
A simple Ham Radio control (CAT) program based on Hamlib. It provides a graphical user interface for your radio and can remotely control SDR radios using Hamlib NET rigctl.
Note that grig will require modification when used with Hamlib versions greater than 4.5.5
- Prerequisites
- Hamlib from Installing utility software on a Raspberry Pi
- These packages
```
sudo apt install libgdk-pixbuf-2.0-0 libglib2.0-0 libgtk2.0-0 libgtk2.0-dev libpango-1.0-0 autopoint gettext libtool
```
- Install Grig
```
cd ~/
git clone https://github.com/fillods/grig.git
cd grig
autoreconf -i
./configure
make -j $(nproc)
sudo make install
sudo ldconfig

# If you haven't already, add yourself to the dialout group.
sudo gpasswd --add ${USER} dialout
# reboot for permissions to take effect.
```
- Using Grig
  For help with the command syntax, type grig -h
  - Find the rig number for the radio that you want to control:
    - ```
    grig -l
```
  Look through the list to find your rig and note the number.
- Control your SDR with Hamlib NET rigctl
  Set up your SDR with Hamlib NET rigctl. Use Setting up WSJT-X to work with your SDR program as a guide.
  - Start grig with Hamlib NET rigctl
```
  grig -m 2 -r 127.0.0.1:7356
```
- Control a radio
  - Yaesu FT-890 connected to a USB RS-232 adapter on linux
```
  grig -m 1015 -r /dev/ttyUSB0 -s 4800 --set-conf=stop_bits="2"
```
  - On a Windows computer using the COM3 RS-232 port
```
  grig -m 1015 -r COM3 -s 4800 --set-conf=stop_bits="2"
```
flrig
Rig control program, cooperates with fldigi
- Prerequisites
```
sudo apt install libfltk1.3-dev libfltk1.3 libsamplerate0-dev libsamplerate0 libpng16-16 libxft-dev libxft2
```
- Install
  Go to http://www.w1hkj.com/files/flrig for the latest stable version.
  The latest test version can be found here: http://www.w1hkj.com/alpha/flrig/
```
cd ~/
# where 'x.xx.xx' is the version number of the most recently posted source archive...
wget http://www.w1hkj.com/files/flrig/flrig-x.xx.xx.tar.gz
tar xzf flrig-x.xx.xx.tar.gz
cd flrig-x.xx.xx
./configure
make -j4
sudo make install
sudo ldconfig

# If you haven't already, add yourself to the dialout group.
sudo gpasswd --add ${USER} dialout
# reboot for permissions to take effect.
```
- Setup example for a Yaesu FT-890
  - Ensure that Use tcpip is not checked.
    In the Config menu, select Setup/Transceiver
    Click Xcvr
    Select your rig (for example FT-890)
    In Update, select /dev/ttyUSB0 for a USB to serial converter
    Baud should be 4800
    Click Activate
    Press Init
    In Poll, select S-mtr and Pwr out (you may click Set all)
Chrony
- Time synchronization is somewhat critical for WSJT-X. If your time is off by about 2 seconds, you may not receive the packets. This can be caused by latency in your SDR software. With Chrony, we can add an offset to the time server to compensate. If you are not receiving data from WSJT-X, this may be why. On the other hand, your transmit may be late.
  Install Chrony with this command in a terminal:
```
sudo apt-get install chrony
```
- Open Chrony's config file with this command in a terminal:
```
sudo mousepad /etc/chrony/chrony.conf
```
- Edit the following line in the file to look something like this. Don't overdo the offset as it will also affect your transmit time.
  - For receiving with a SDR that has latency
```
pool 2.debian.pool.ntp.org iburst offset -1.5
```
  - With a transceiver, the Raspberry Pi may seem to be slow. This will speed it up.
```
pool 2.debian.pool.ntp.org iburst offset 0.5
```
- Save and close the config file, then restart Chrony with the following:
```
sudo invoke-rc.d chrony restart
```

Back to the index