jketterl / digiham

tools for decoding digital ham communication
GNU General Public License v3.0
46 stars 14 forks source link
dmr gfsk hamradio sdr software-defined-radio ysf

Digital Ham Radio decoding tools

This is a simple set of command-line tools that is intended to be used to decode digital modulations used by ham radio operators. The main focus is on digital voice modes.

Right now this project enables you to decode DMR and YSF, future plans include NXDN and D-Star.

The main use of this project is to run in the backend of OpenWebRX, where it decodes the available information, which is then displayed on the receiver's website.

Requirements

Please make sure you install the following dependencies before compiling digiham:

About the AMBE codec

Most digital voice modes in the ham radio universe right now use some version of the AMBE digital voice codec. In order to decode them, you will need to setup the correspoding decoding infrastructure.

This project comes with mbe_synthesizer that can send the received audio data to a codecserver instance for decoding.

Installation

The OpenWebRX project is hosting digiham packages in their repositories. Please click the respective link for Debian or Ubuntu.

Compiling from source

This project comes with a cmake build. It is recommended to build in a separate directory.

mkdir build
cd build
cmake ..
make
sudo make install

Examples

You can find shell scripts that show the basic usage of the components in the examples folder.