WSPR daemon for RTL receivers
 
 
 
Go to file
Guenael 474c95df29 WIP chore: formatting 2021-12-22 21:36:55 -05:00
.github chore(doc): issue templates update 2021-12-20 00:26:14 -05:00
art chore(doc): cute icons & logo 2021-12-04 18:59:34 -05:00
signals feat(rtlsdr_wsprd.c): new load/save fct + ref signal + coef rework 2021-12-10 23:40:43 -05:00
wsprd WIP chore: formatting 2021-12-22 21:36:55 -05:00
.clang-format feat(reformat): using Google c++ style everywhere 2021-12-04 15:24:12 -05:00
.gitignore chore(CI): gitpod dockerfile update 2021-12-11 21:29:03 -05:00
.gitpod.Dockerfile chore(CI): gitpod dockerfile update 2021-12-11 21:29:03 -05:00
.gitpod.yml chore(CI): gitpod badge button disabled 2021-12-11 22:20:32 -05:00
Dockerfile Container image 2021-12-18 23:41:21 +11:00
LICENSE fix(licence): issue with GNU GPLv3 included in this project 2021-12-11 23:05:22 -05:00
Makefile WIP chore: wsprd lib update part2 2021-12-22 21:22:06 -05:00
README.md fix: typos 2021-12-19 19:51:27 +01:00
rtlsdr_wsprd.c WIP chore: wsprd lib update partial 2021-12-22 00:43:49 -05:00
rtlsdr_wsprd.h feat(sampling): double buffering used, major refactor 2021-12-15 22:05:32 -05:00

README.md

rtlsdr-wsprd -- WSPR daemon for RTL receivers

rtlsdr-wsprd

Project Status Workflow Status Last commit Commit activity LGTM Alerts LGTM Grade

TL;DR

This project aim at decoding WSPR signals using an RTL device, usually connected to a Raspberry Pi. To install and use your dongle on a Raspberry Pi with a Raspberry Pi OS, follow these steps:

echo "== Install dependencies"
sudo apt-get update && sudo apt-get -y install build-essential clang cmake libfftw3-dev libusb-1.0-0-dev libcurl4-gnutls-dev ntp git

echo "== Install rtl-sdr library (on RPi, don't use your distro package)"
git clone https://github.com/osmocom/rtl-sdr
cd rtl-sdr
mkdir -p make
cd make
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr -DDETACH_KERNEL_DRIVER=ON -Wno-dev ..
make
sudo make install
cd ../..

echo "== Install rtlsdr-wsprd"
git clone https://github.com/Guenael/rtlsdr-wsprd
cd rtlsdr-wsprd
make
make install

echo "== Start/test rtlsdr-wsprd"
rtlsdr_wsprd -f 2m -c A1XYZ -l AB12cd -g 29

Overview

This non-interactive application allows automatic reporting of WSPR spots on WSPRnet. The initial idea was to allow a small computer like a Raspberry Pi and a RTL-SDR device to send WSPR reports for VHF/UHF bands. This kind of lightweight setup could run continuously without maintenance and help to get additional propagation reports. The code is massively based on Steven Franke (K9AN) implementation of Joe Taylor (K1JT) publication and work.

This application written in C does:

  • A time alignment (2 mins, required NTPd to run on the OS)
  • Start the reception using the RTL lib
  • Decimate the IQ data (2.4Msps to 375 sps)
  • Decode WSPR signals
  • Push any spots on WSPRnet
  • Repeat, again and again...

Installation

  1. Install a Linux compatible distro on your device.

    For Raspberry Pi, you can download official images here.

  2. It's a good practice to update your OS. With Pi OS, run this command as usual:

    sudo apt-get update && sudo apt-get upgrade
    
  3. Install dependencies & useful tools (for example, NTP for time synchronization). Example with a Debian based OS, like Rasbian, or Raspberry Pi OS:

    sudo apt-get update && sudo apt-get -y install build-essential clang cmake libfftw3-dev libusb-1.0-0-dev libcurl4-gnutls-dev ntp git
    
  4. Install rtl-sdr library manually. Do not use the librtlsdr-dev package on Raspberry PiOS. There is a know bug with this lib and rtlsdr_wsprd will not be able to get enough samples (don't decode anything & 100% CPU pattern).

    git clone https://github.com/osmocom/rtl-sdr
    cd rtl-sdr
    mkdir -p make
    cd make
    cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr -DDETACH_KERNEL_DRIVER=ON -Wno-dev ..
    make
    sudo make install
    cd ../..
    

Note: You may have to re-plug you dongle if it was already connected, or play with udev if not automatically detected.

  1. Clone this repository:

    git clone https://github.com/Guenael/rtlsdr-wsprd
    
  2. Build the application:

    cd rtlsdr-wsprd
    make
    sudo make install
    
  3. Finally, start the application with the right parameters/options for you (frequency, callsign, locator etc... Fake example below):

    rtlsdr_wsprd -f 2m -c A1XYZ -l AB12cd -g 29
    

Container Image

As an alternative to the above steps, a pre-built container image containing rtlsdr-wsprd is available for use with Docker or Podman.

The RTL DVB kernel modules must first be blacklisted on the host running the container. RTL-SDR itself is not required on the host running the container. This can be permanently accomplished using the following commands:

echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/blacklist-dvb_usb_rtl28xxu.conf
sudo modprobe -r dvb_usb_rtl28xxu

If the modprobe -r command errors, a reboot is recommended to unload the module.

You can then start the container with the right parameters/options for you (frequency, callsign, locator etc... Fake example below):

docker run --rm -it --pull=always --device=/dev/bus/usb ghcr.io/guenael/rtlsdr-wsprd:latest -f 2m -c A1XYZ -l AB12cd -g 29

Tips (for your Raspberry Pi and SDR dongles)

  • Use ferrite bead on the USB cable to limit the QRN
  • Use an external clean power supply
  • Cut off the display (could help to reduce QRN)
    /opt/vc/bin/tvservice -o
    
  • Remove unused modules (for example, /etc/modules: #snd-bcm2835)
  • Use an enclosure, and ground it

Crystal stability

Most of RTL dongles use a cheap crystal, and frequency drift can effect the decoding & performance. The use of no-name RTL dongle for VHF/UHF bands usually require crystal modification, for a better one. External clock could be also used, like GPSDO or rubidium reference clock, aligned on 28.8MHz.

Some manufacturers integrate a 0.5ppm TCXO. It's the best second option, after an external clock. Based on my personal experience:

  • NooElec NESDR SMART : Works fine out of the box
  • RTL-SDR Blog 1PPM TCXO : Works with some drift, require additional mass, or a better enclosure
  • Other no-name like : RT820, E4000, FC0012, FC0013, can work, but require modification and usually drift a lot