shortwave receiver for use with sdrplay, hackrf, dabsticks and pmsdr
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
appimage
cmake CMakeLists.txt-qt5 Dec 25, 2018
decimators further changes Dec 19, 2018
decoders changes in drm decoder Feb 18, 2019
devices changes in drm decoder Feb 18, 2019
docs/synchronization-in-drm
filters scopes Jan 16, 2019
output
scopes-qwt6
various
.gitignore further changes Dec 19, 2018
.travis.yml next try Dec 25, 2018
AUTHORS
CMakeLists.txt
CMakeLists.txt-qt4
CMakeLists.txt-qt5
COPYING
LICENSE
README.md Update README.md Jan 2, 2019
faad2-2.8.8.tar.gz
hackrf.tgz trying to get appimage back Dec 25, 2018
main.cpp further changes Dec 19, 2018
moc_fac-data.cpp changes in drm decoder Feb 18, 2019
newUser.txt further changes Dec 19, 2018
newradio.ui
radio-constants.h further changes Dec 19, 2018
radio.cpp testdecoder Jan 28, 2019
radio.h further changes Dec 19, 2018
resources.qrc
rtl-sdr.tgz trying to get appimage back Dec 25, 2018
swradio-8.pro changes in drm decoder Feb 18, 2019
swradio-hackrf.png
swradio-installer.iss
swradio-pmsdr-drm.png
swradio-rtlsdr-drm.png
swradio-sdrplay.png
swradio.desktop further changes Dec 19, 2018
swradio.ico
swradio.png
travis.yml
travis.yml-qt4 changed gainsetting for rtlsdr Dec 26, 2018

README.md

swradio-8 Build Status

swradio is Software for Linux and windows for listening to short wave radio. It is a rewrite and simplification of sdr-j-sw.


Windows

For Windows there is an installer, to be found in the releases section, setup-swradio.exe, for the swradio. The installer will install an executable as well as the required dll's. The installer will call the official installer for the dll implementing the api to get access to the SDRplay device.


Linux

For Linux there is a description of how to create an executable, it is written for Ubuntu, it is, however, simply to translate to scripts to be used with other distros.

Furthermore there is an "appImage", to be found in the releases section (while the indicator at the top mentions "failure", the appImage is correct). The appImage was created - using the travis service - in an Ubuntu 14 environment, it contains the required libraries and should run on any more or less recent Linux environment. (Note that a passwd is asked form since the software tries to install the udev rules for the devices).


Introduction

swradio-8 is software (both Linux and Windows) for listening to short waves and amateur radio. The software supports a number of decoders, often used by radio amateurs, such as psk, cw and rtty. swradio-8 is the result of rewriting and simplifying the set of sdr-j-sw programs.

The program can be configured to use the SDRplay, the HACKrf, RTLSDR-based dabsticks or the - soundcard based - pmsdr as input device, and is able to

  • dump the (decimated) input onto a file in PCM format;
  • use such a file as input.

To distinguish between "fast" and "slow" input, the version for the pmsdr is named "swradio-pmsdr", while the regular version is configured to be named "swradio-8". In the build for Windows there is also an experimental version for use with extio plugins for soundcard devices called "swradio-extio".

If a configured device is connected to the computer where the program runs, the device will be connected and opened. If no device is detected, it is assumed that file input is requested and a file selection menu will appear.

Input files in PCM format, with a 2 channel, 96000 samples/second configuration will be accepted.


Using rtlsdr based devices

For the rtlsdr based devices, use was made of a special version of the library, the one by Oliver Jowett. Sources are included in the source tree of this program. This library makes it possible to use frequencies as low as 14 MHz.

swradio-8

It is obvious that reception will improve if some form of filtering is applied to the input, e.g. a tuned loop.


Using a pmSDR device and a soundcard

I dusted off my old pmSDR, dating from the era that the data was entering the computer through the soundcard. Now, in that time I bought an HP Pavilion since - according to the specs - it could deliver samples with a rate of 192K, sufficient to do experiments with FM demodulation, which is what I wanted to do at that time.

And indeed, samples could be read with a speed of 192k, however, some internal filtering in the stupid computer halved the signal in bandwidth, so receiving a signal sampled at 192k gave me a signal with a bandwidth of less than 96k, completely useless for FM decoding (it is a time ago but still pretty frustrated about it).

(frustration section:) Even further, when sampling on 96k, the band was halved as well, so the effective bandwidth then would only be 48k. Of course a solution to get 96K was to decimate (in software) a signal sampled at 192k with a factor 2, but it was not why I bought the stupid thing.

I'll not report on the discussion I had with the HP service desk (bad for my health), I cannot remember to have met such unwilling (ignorant?) people (and I can assure you that I met lots of them). They, the HP people, (c/w)ould not confirm or falsify that the band was halved. They claimed that they did not have a program to verify my claim, so my claim was ("by definition") false. Seems a little silly for a large organization like HP. Of course, the programs that I wrote to show the bandwidth/samplerates were mine, not from HP, so results I sent them (nice spectrum pictures) were "not admissable as evidence", so after some talking they decided that there was no problem whatsoever, so no need to communicate further. Needless to say that I'll never buy an HP laptop again. (end of frustration section)

Anyway, for using a soundcard, I had to buy an external card, an EMU-202 with which I did all kinds of FM decoding at the time in combination with the pmSDR. Here we need "only" 96k, it works well under Linux and at the time it worked on W7. However, it does not like Windows-10, using it under W10 leads to a crash.

swradio-8


Using extio devices with soundcard

One of the windows versions of the swradio software is set to use "extio" plugins for handling the radio device. To keep things simple the use is limited to radio devices with data being sent using the soundcard.

The version is pretty experimental.


Using the hackrf device

The hackrf device works quite well. With this program I test it only on shortwave frequencies. It handles the cw as well as modes such as psk and drm well.

swradio-8


Using the SDRplay

The SDRplay provides the full band and makes it easy to receive short wave programs. Absolutely one of my favorites.

swradio-8


Preferred frequencies

Preferred frequencies can be stored, together with a user defined label (a program name). A table of preferred frequencies (programs) is maintained between program invocations. A selected frequency can be stored by pressing the save frequency button. If touched, one is asked to specify a name to be used to label that frequency. The pair (name, frequency) then is added to the list.

Selecting such a "preferred program" is just by clicking the mouse on the programname or the associated field with the frequency.


Frequency selection

Frequency selection is with a keypad, separated from the main widget, that will appear when touching the Frequency select key. Specification of a frequency is either in kHz or mHz. Fine frequency selection - up to an accuracy of 1 Hz - is with the mousewheel (when the main widget is activated). (The stepsize for the frequency changes can be set from the main widget, default is 5 Hz).

Of course clicking the mouse on one of the two spectra will also select the selected frequency pointed to.

As a "quick" help, a button "middle" is present that, when pressed - will set the oscillator such that the selected frequency is in the middle of the right half of the spectrum display.


Waterfall displays

Note that clicking the right mouse button on any of the two displays, that display will switch from spectrum to waterfall display (or vice-versa).


Implemented decoders

Decoders* are:

  • am
  • ssb, with selection for usb or lsb;
  • psk, with a wide selection of modes and settings and with a visual tuning aid,
  • mfsk, with a visual tuning aid,
  • rtty, with a wide selection of modes and settings;
  • cw, with (almost) automatic selection of speed and a visual tuning aid,
  • drm, limited to 10 k bandwidth;
  • amtor, with a wide selection of options;
  • weatherfax decoder, with selection of a variety of settings.

As can be seen from the pictures, the main widget has two main displays, and one smaller display to show the audio output. The top display has a width of 96k (this width can be changed in the settings) showing the spectrum of the incoming data, the bottom one width a width of 12k - showing the spectrum of the data sent to the decoder, i.e. after being filtered and shifted. The small display shows the spectrum of the resulting audio.

One may select among a number of different filterings:

  • wide, used for e.g. DRM decoding, uses the full 12 k bandwidth;
  • am, used - as the name suggests - for am decoding, uses 9 k;
  • usb, used for smallband decoding in the upper side band, has a width of 2500 Hz;
  • lsb, used for ssb decoding is the lower sideband, has a width of 2500 Hz

The input can be written to a file, that file can be processed later on.


Linux

The current version is developed under Linux (Fedora). For Ubuntu Linux, a description is given how to build an executable


Ubuntu Linux

For generating an executable under Ubuntu (16.04 or newer) one may take the following steps.

  1. Download the source tree (it is assumed that you have a git client and cmake installed.

    git clone https://github.com/JvanKatwijk/swradio-8
    
  2. Fetch needed components

    sudo apt-get update
    sudo apt-get install qt5-qmake build-essential g++
    sudo apt-get install libsndfile1-dev qt5-default libfftw3-dev portaudio19-dev 
    sudo apt-get install zlib1g-dev libusb-1.0-0-dev mesa-common-dev
    sudo apt-get install libgl1-mesa-dev libqt5opengl5-dev libsamplerate0-dev libqwt-qt5-dev
    sudo apt-get install qtbase5-dev
    
    
  3. Create the faad_drm library if you want to use the drm decoder. To make life easy, the sources for the faad library are included in the source tree (packed).

    cd ./swradio-8
    tar zxvf faad2-2.8.8.tar.gz
    cd faad2-2.8.8
    ./configure
    make
    sudo make install
    cd ..
    rm -rf faad2-2.8.8
    
  4. Device support

a) if you have an SDRplay device, I assume you already have installed the library, otherwise visit "www.sdrplay.com" and follow the instructions. Make sure to uncomment in swradio-8.pro the line

CONFIG += sdrplay

b) the sources for using the pmSDR device are part of the sourcetree. Note that for pmSDR the cardread functions are installed. The idea is to use either the pmSDR or the "fast" devices, reflected in the name. A configuration with (only) pmSDR will be named "swradio-pmsdr", a configuration with (only) fast input devices will be named "swradio-8".

For selecting the pmSDR, make sure to uncomment in swradio-8.pro the line

CONFIG += pmsdr

and to comment out the lines

#CONFIG += sdrplay
#CONFIG += rtlsdr
#CONFIG += hackrf

Create a file /etc/udev/rules.d/96-pmsdr.rules with as content

#
# udev rules file for Microchip 18F4455 USB Micro (PMSDR)
#
SUBSYSTEM=="usb", ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="000c", MODE:="0666"

to ensure non-root access to the device through usb.

c) To make life easy, the sources for the required -non-standard - rtlsdr library used are included in the source tree, again as a packed file.

 tar zxvf rtl-sdr.tgz
 cd rtl-sdr/
 mkdir build
 cd build
 cmake ../ -DINSTALL_UDEV_RULES=ON -DDETACH_KERNEL_DRIVER=ON
 make
 sudo make install
 rm -rf rtl-sdr
 sudo ldconfig
 cd ..
 rm -rf build
 cd ..

Make sure that a file exists in the /etc/udev/rules.d directory describing the device, allowing "ordinary" users to access the device.

d) Create a library for the hackrf device by downloading the sources and compiling

git clone https://github.com/mossmann/hackrf
cd hackrf
cd host
mkdir build
cd build
cmake .. -DINSTALL_UDEV_RULES=ON
sudo make install

Make sure that a file exists in the /etc/udev/rules.d directory describing the device, allowing "ordinary" users to access the device. I.e. add yourself to the "plugdev" group.

  1. Edit the swradio-8.pro file for configuring the supported devices and decoders. For the devices

    • CONFIG += sdrplay
    • CONFIG += hackrf
    • CONFIG += rtlsdr or
    • CONFIG += pmsdr

    Select - or deselect - decoders:

    • CONFIG += am-decoder
    • CONFIG += ssb-decoder
    • CONFIG += cw-decoder
    • CONFIG += amtor-decoder
    • CONFIG += psk-decoder
    • CONFIG += rtty-decoder
    • CONFIG += fax-decoder
    • CONFIG += drm-decoder
    • CONFIG += mfsk-decoder

Note that the "faad_drm" library is (only) needed for the drm decoder.

The "DESTDIR" parameter in the unix section in the ".pro" file tells where the result is to be put.

  1. Check the installation path to qwt. If you were downloading it from http://qwt.sourceforge.net/qwtinstall.html please mention the correct path in qt-dab.pro file (for other installation change it accordingly):
INCLUDEPATH += /usr/local/include  /usr/local/qwt-6.1.3
  1. Build and make
qmake qt-dab.pro
make

Alternatively, you could use the "cmake" route. The file CMakeLists.txt-qt5 can be used for qt-5, the file CMakeLists.txt-qt4 is merely used for the construction of the appImage. The configurations here include the three mentioned "fast" devices.


Windows

The releases section of the qt-dab repository contains a zip file with executables, among which an executable of swradio-8 and the required dll's. Note that the library for SDRplay support is not included, one has to obtain that from SDRplay.com



Copyright

Copyright (C)  2013, 2014, 2015, 2016, 2017, 2018
Jan van Katwijk (J.vanKatwijk@gmail.com)
Lazy Chair Computing

The swradio software is made available under the GPL-2.0.
The SDR-J software, of which the sw-radio software is a part, 
is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

swradio-8