direwolf/README.md

4.4 KiB

Dire Wolf

Decoded Information from Radio Emissions for Windows Or Linux Fans

In the early days of Amateur Packet Radio, it was necessary to use a “Terminal Node Controller” (TNC) with specialized hardware. Those days are gone. You can now get better results at lower cost by connecting your radio to the “soundcard” interface of a computer and using software to decode the signals.

Dire Wolf is a software "soundcard" modem/TNC and APRS encoder/decoder. It can be used stand-alone to observe APRS traffic, as a digipeater, APRStt gateway, or Internet Gateway (IGate). It can also be used as a virtual TNC for other applications such as APRSIS32, UI-View32, Xastir, APRS-TW, YAAC, UISS, Linux AX25, SARTrack, RMS Express, and many others.

Features

  • Lower cost, higher performance alternative to hardware TNC. Decodes more than 1000 error-free frames from WA8LMF TNC Test CD.

  • Ideal for building a Raspberry Pi digipeater & IGate.

  • 300, 1200, and 9600 baud operation.

  • Interface with applications by - AGW network protocol - KISS serial port - KISS network protocol

  • Decoding of received information for troubleshooting.

  • Logging and conversion to GPX file format.

  • Beaconing for yourself or other nearby entities.

  • Very flexible Digipeating with routing and filtering between up to 6 ports.

  • APRStt gateway - converts touch tone sequences to APRS objects and voice responses.

  • APRS Internet Gateway (IGate) with IPv6 support and special SATGate mode.

  • APRS Telemetry Toolkit.

  • Compatible with software defined radios (SDR) such as gqrx, rtl_fm, and SDR#.

  • Includes separate raw packet decoder, decode_aprs.

  • Open source so you can see how it works and make your own modifications.

  • Runs in 3 different environments: - Microsoft Windows XP or later - Linux, regular PC or single board computer such as Raspberry Pi, BeagleBone Black, or cubieboard 2 - Mac OS X

Installation

Windows

Go to the releases page. Download a zip file with "win" in its name, unzip it, and run direwolf.exe from a command window.

For more details see the User Guide in the doc directory.

Linux - Download with web browser

Go to the releases page. Chose desired release and download the source as zip or compressed tar file. Unpack the files, with "unzip" or "tar xfz," and then:

cd direwolf-*
make
sudo make install
make install-conf

For more details see the User Guide in the doc directory. Special considerations for the Raspberry Pi are found in Raspberry-Pi-APRS.pdf

Linux - Using git clone

cd ~
git clone https://www.github.com/wb2osz/direwolf
cd direwolf
make
sudo make install
make install-conf

This should give you the most recent stable release. If you want the latest (unstable) development version, use "git checkout dev" instead before the first "make" command.

For more details see the User Guide in the doc directory. Special considerations for the Raspberry Pi are found in Raspberry-Pi-APRS.pdf

Join the conversation

Here are some good places to share information:

The github "issues" section is for reporting software defects and enhancement requests. It is NOT a place to ask questions or have general discussions. Please use one of the locations above.