Installing Trunk Recorder and Rdio Scanner on a Raspberry Pi

Install:

Trunk Recorder
If you wish to provide feed to broadcastify, consult the documentation. This procedure will set up a local scanner that may be shared over the Internet.
- Prerequisites
  - We will need to add the deb-multimedia repository.
    Please skip this step if it has been done previously.
```
sudo mousepad /etc/apt/sources.list

# Add this line to the end of the file:
deb https://www.deb-multimedia.org bookworm main non-free
# Save and close

# Download the keys for the apt source and install them:

cd ~/Downloads
wget https://www.deb-multimedia.org/pool/main/d/deb-multimedia-keyring/deb-multimedia-keyring_2024.9.1_all.deb
sudo dpkg -i deb-multimedia-keyring_2024.9.1_all.deb

# Verify the package integrity with:
sha256sum deb-multimedia-keyring_2024.9.1_all.deb
# It should display this:
8dc6cbb266c701cfe58bd1d2eb9fe2245a1d6341c7110cfbfe3a5a975dcf97ca deb-multimedia-keyring_2024.9.1_all.deb

# Update the OS:
sudo apt update
sudo apt dist-upgrade
```
  - Install packages
```
sudo apt install libssl-dev openssl curl git fdkaac sox libcurl3-gnutls libcurl4 libcurl4-openssl-dev build-essential libboost-all-dev libusb-1.0-0-dev libsndfile1-dev
```
- Build and install
```
cd ~/
mkdir trunk-build
git clone https://github.com/robotastic/trunk-recorder.git
cd trunk-build
cmake ../trunk-recorder
make -j $(nproc)
sudo make install
sudo ldconfig
```
- Configuring Trunk Recorder for a P25 trunked system
  For complete information, go to https://trunkrecorder.com/docs/CONFIGURE
  The examples here show configurations for rdio scanner. If you want to use broadcastify, see the documentation.
  - Find the information for your system on The RadioReference Database. Search for your location and then select a system
    - Note the control channels and alternate control channels.
    - Note the System ID.
  - Open a sample configuration file in ~/trunk-recorder/examples or try one of mine:
    - config-MPSCS-SDRplay.json
    - config-MPSCS-HackRF.json
  - Test the control channel and tuning error.
    - Try receiving the control channels with an SDR receiver such as gqrx. Note the frequency difference from what is specified.
      - Calculate the error by subtracting the actual frequency found in radioreference from the frequency you tuned in the SDR receiver.
        Received Frequency - Actual Frequency = Error
      - Place this number in the "error:" field for this SDR in the config.json file.
  - Gain
    - Setting "gain": 0 should cause Trunk Recorder to use automatic gain. The individual gains do not work for SDRplay.
      - Gain settings that work for HackRF
        "gain": 14, "ifGain": 40, "bbGain": 18,
  - Center Frequency
    - Look at the list of frequencies for your system. Note the highest frequency and lowest frequency listed. Find the frequency is the middle of these.
    - Place this number in the "center:" field for this SDR in the config.json file.
  - Enter the "control_channels" for your system. Separate the control channels with a comma.
  - Make a talkgroups file. You can get a csv file from radioreference.com. Save your talkgroups.csv file in ~/trunk-build under the name specified in your config file.
  - Sample Rate
    - Preferably, enter a sample rate that will give coverage from the lowest frequency to the highest. If your SDR does not have a high enough sample rate for this, you will have to compromise or add another SDR.
      Note that HackRF does not work with sample rates above 10000000 in Trunk Recorder.
    - Enter this number in the "rate" field for this SDR in the config.json file.
  - "device"
    - You can take the appropriate device string from gqrx. In these examples we will use the osmosdr device for HackRF, but the SoapySDR device works best for SDRplay devices.
      - Enter this string in the "device" field for this SDR in the config.json file. Remember to change the serial number to the one for your device.
  - Save your configuration file in ~/trunk-build
  - Start Trunk Recorder
    - Start trunk-recorder with your custom config file (Example)
```
cd ~/trunk-build
./trunk-recorder --config=config-MPSCS-SDRplay.json
```
Rdio Scanner
- Prerequisites
  - Trunk Recorder installed previously
- Install
  - Go to https://github.com/chuot/rdio-scanner
  - Download the latest precompiled version of Rdio Scanner from the releases section.
  - Extract the files to ~/rdio-scanner-linux-arm64-v6.6.3 (or whatever version you have)
- More detailed instructions are available in the rdio-scanner.pdf file located where you extracted the archive files.
- Start Rdio Scanner
```
cd ~/rdio-scanner-linux-arm64-v6.6.3
./rdio-scanner
```
- Open a web browser to a link provided in the terminal:
  2024/03/05 00:31:16 main interface at http://127.0.0.1:3000/
  2024/03/05 00:31:16 admin interface at http://127.0.0.1:3000/admin
- Configuration
  - Open the admin interface to finalize the configuration.
  - Log in to the admin page. The default password is rdio-scanner.
    Open Config
    Under ApiKey, click new Api key.
    Click NewApiKey.
    Under Disabled, "Disable the API key." Ensure that the switch to the left, which is off, meaning do not disable the API key.
    Use the copy button to copy the key, then paste it into the "apiKey" of your config.json files for trunk-recorder.
    Make an identifier in the Ident field.
    In "Access", click Choose systems and select the type of systems you want to hear.
    Be sure to click the name for the system you created in trunk-recorder or won't save.
    Restart Trunk Recorder so it will recognize the apiKey.
    
    Under Dirwatch, open NewDirWatch.
    Disabled > Off
    Delete After > On
    Type > Trunk Recorder
    
    Directory should be Capture Directory: that appears in the terminal when you start trunk-recorder.
    The wav files should be in the folder named after your system short name.
    
    # Example Trunk Recorder tempDir config parameter:
    Directory > /dev/shm/MPSCS
    
    # Example Trunk Recorder captureDir config parameter, wav files:
    /home/pi/trunk-build/MPSCS
    
    Extension > wav
    
    Under Systems click the name of your system or click New System.
    ID > the ID number you created in trunk-recorder config systemId field.
    Label > Use the name of the system that you want to see in the display.
    Under Systems, Auto Populate is slid to the right, turning it on.
    
    Options/Audio Conversion
    # If you hear talkgroups that are really quiet while other are loud
    # Adds some distortion
    Select Enabled with normalization
    
    Save.
  - Once configuration is done, click Live Feed in rdio-scanner. The light in the corner should turn green.
  - Note that the wav files will remain in ~/trunk-build/your-system-name
    To delete them after you quit Trunk Recorder:
    - cd ~/trunk-build
    - rm -r -v your-system-name/*
  - Under tools, you can import talkgroups from Trunk Recorder or Radio reference files.
    This could take a long time if there are many talkgroups.
    You could click "Import to configuration", but if there are more than 800 talkgroups, it is not advised.
    If you don't import the talkgroups, it will import them as you receive them.