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 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.
  PipeWire is required. PipeWire is intalled by default on Raspberry Pi OS Bookworm.
  - sudo apt install easyeffects
  - 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.
    - 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.
- 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.
  - 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
      In Poll, select S-mtr and Pwr out (you may click Set all)
      In Xcvr, press Init
- 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