Dire Wolf User Guide
Total Page:16
File Type:pdf, Size:1020Kb
Dire Wolf User Guide Decoded Information from Radio Emissions for Windows Or Linux Fans Version 1.6 -- October 2020 Canis Dirus (Dire Wolf) Harvard Museum of Natural History Contents 1 Introduction .......................................................................................................................................... 1 1.1 FX.25 - Forward Error Correction (FEC) ......................................................................................... 2 2 Features ................................................................................................................................................ 3 3 Connection to Radio.............................................................................................................................. 6 3.1 Don’t have a serial port? ............................................................................................................... 8 3.2 For Best Results ............................................................................................................................. 8 4 Installation & Operation – Microsoft Windows XP or later ................................................................ 10 4.1 Run Dire Wolf .............................................................................................................................. 11 4.2 Select better font ........................................................................................................................ 13 4.3 AGW TCPIP socket interface ....................................................................................................... 14 4.3.1 APRSISCE/32 ........................................................................................................................ 14 4.3.2 Ui-View ................................................................................................................................ 15 4.3.3 YAAC (Yet Another APRS Client).......................................................................................... 15 4.3.4 SARTrack ............................................................................................................................. 15 4.4 Kiss TNC emulation – serial port ................................................................................................. 16 4.4.1 APRSISCE/32 ........................................................................................................................ 16 4.4.2 UI-View32 ............................................................................................................................ 16 4.4.3 YAAC (Yet Another APRS Client).......................................................................................... 16 4.5 Kiss TNC emulation – network .................................................................................................... 17 4.5.1 Winlink / RMS Express ........................................................................................................ 17 4.5.2 APRSISCE/32 ........................................................................................................................ 17 4.6 Build Dire Wolf from source on Windows (optional).................................................................. 18 5 Installation & Operation – Linux ......................................................................................................... 20 5.1 Install Prerequisites ..................................................................................................................... 20 5.1.1 Optional Step: hamlib support ........................................................................................... 21 5.2 Download Dire Wolf source code ............................................................................................... 21 5.3 Start Build & Install ..................................................................................................................... 22 5.4 Finish build and install................................................................................................................. 22 5.5 Select UTF-8 character set .......................................................................................................... 24 5.6 Run Dire Wolf .............................................................................................................................. 25 5.7 AGW TCPIP socket interface ....................................................................................................... 25 5.7.1 Xastir ................................................................................................................................... 25 5.8 Kiss TNC emulation – serial port ................................................................................................. 25 5.8.1 Xastir ................................................................................................................................... 26 5.8.2 Linux AX25 ........................................................................................................................... 26 5.8.2.1 Unexpected transmissions .............................................................................................. 28 5.9 Automatic Start Up After Reboot ................................................................................................ 28 6 Macintosh OS X ................................................................................................................................... 30 6.1 Install Xcode/Command line tools. ............................................................................................. 30 6.2 Install Macports .......................................................................................................................... 30 6.3 Install Support tools and PortAudio Library. ............................................................................... 31 6.4 Compiling Direwolf...................................................................................................................... 31 6.5 Read the instructions to configure direwolf.conf file. ................................................................ 32 6.6 Running direwolf. ........................................................................................................................ 33 6.7 Read the rest of the User Guide. ................................................................................................ 33 6.8 In case of difficulties ................................................................................................................... 33 7 Basic Operation ................................................................................................................................... 34 7.1 Start up configuration information ............................................................................................. 34 7.2 Information for receiving and transmitting ................................................................................ 35 7.3 Periodic audio device statistics ................................................................................................... 40 8 Data Rates ........................................................................................................................................... 43 8.1 Bits per Second (bps) vs. Baud .................................................................................................... 43 8.2 1200 bps ...................................................................................................................................... 43 8.3 300 bps ........................................................................................................................................ 43 8.4 9600 bps ...................................................................................................................................... 44 8.5 2400 bps ...................................................................................................................................... 45 8.6 4800 bps ...................................................................................................................................... 46 8.7 AIS Reception - new in 1.6 .......................................................................................................... 47 9 Configuration File & command line options ....................................................................................... 49 9.1 Audio Device ............................................................................................................................... 49 9.1.1 Audio Device Selection – All Platforms ............................................................................... 51 9.1.2 Audio Device selection - Windows ...................................................................................... 51 9.1.3 Audio Device selection – Linux ALSA .................................................................................. 52 9.1.4 Audio Device selection – Mac OS X ..................................................................................... 55 9.1.5 Audio Device properties ...................................................................................................... 55 9.1.6 Use with Software Defined Radios...................................................................................... 55 9.1.6.1 gqrx ................................................................................................................................