gr-gmuground

Art produced and reused with permission from Jae Wook Choi.

Winner of the Outstanding ECE Senior Design Project Award for Spring 2020.

Installation

If you don't already have GNU Radio, you can quickly install it using this Shell script. For all scripts, it is assumed that Ubuntu 18.04 or later is being used (note that as of this commit, gr-limesdr isn't currently compatible with versions later than 18.04).

The following dependencies must be installed:

• GNU Radio (>=3.8.0)
• gr-limesdr (gr-3.8)
• gr-satellites
• gr-gpredict-doppler (maint-3.8)
• gr-filerepeater
• gr-fosphor (gr3.8)
• gr-display
• gr-guiextra
• libfec
• construct
• swig
• requests

For CW decoding, the following must be installed:

• gr-satnogs (2.0+) and related dependencies.

Once all dependencies are installed, run the commands:

git clone https://github.com/wbarnha/gr-gmuground.git
cd gr-gmuground
mkdir build
cd build
cmake ../
make
sudo make install
sudo ldconfig

Alternatively, you can run the setup.sh Bash script to install the dependencies and gr-gmuground.

git clone https://github.com/wbarnha/gr-gmuground.git
cd gr-gmuground
./setup.sh

(Note: The guide for installing gr-fosphor here indicates you must install the OpenCL libraries for Intel, AMD, or Nvidia. You must install the OpenCL library for your computer!) It is recommended to setup OpenCL for Intel CPUs by installing the SDK here. Once this is complete, running setup.sh will take care of everything for you.`

If you don't have a LimeSDR, feel free to install cubicsdr (It automatically installs most of the Soapy packages and it's useful to make sure everything is working fine), python3-soapysdr, and soapysdr-tools to expand your options to the RTL SDR, HackRF, etc., with gr-soapy.

Operation

To change the center frequency in real time, either double-click on the screen or enter the frequency in the upper-left corner. The center frequency is automatically shifted to process USB signals and decode these signals.

More information can be found in the Wiki. There's a lot of missing documentation here, since I've unfortunately had to move on to other projects. If you want a long 112 page document containing everything, feel free to send me an email.