Update ci.yml

Upload artifact v2 doesn't work anymore.

.github/workflows/ci.yml

@@ -0,0 +1,162 @@
+name: 'build direwolf'
+
+on:
+  # permit to manually trigger the CI
+  workflow_dispatch:
+    inputs:
+      cmake_flags:
+        description: 'Custom CMAKE flags'
+        required: false
+  push:
+    paths-ignore:
+      - '.github/**'
+  pull_request:
+    paths-ignore:
+      - '.github/**'
+
+jobs:
+  build:
+    name: ${{ matrix.config.name }}
+    runs-on: ${{ matrix.config.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+          - {
+              name: 'Windows Latest MinGW 64bit',
+              os: windows-latest,
+              cc: 'x86_64-w64-mingw32-gcc',
+              cxx: 'x86_64-w64-mingw32-g++',
+              ar: 'x86_64-w64-mingw32-ar',
+              windres: 'x86_64-w64-mingw32-windres',
+              arch: 'x86_64',
+              build_type: 'Release',
+              cmake_extra_flags: '-G "MinGW Makefiles"'
+            }
+          - {
+              name: 'Windows 2019 MinGW 32bit',
+              os: windows-2019,
+              cc: 'i686-w64-mingw32-gcc',
+              cxx: 'i686-w64-mingw32-g++',
+              ar: 'i686-w64-mingw32-ar',
+              windres: 'i686-w64-mingw32-windres',
+              arch: 'i686',
+              build_type: 'Release',
+              cmake_extra_flags: '-G "MinGW Makefiles"'
+            }
+          - {
+              name: 'macOS latest',
+              os: macos-latest,
+              cc: 'clang',
+              cxx: 'clang++',
+              arch: 'x86_64',
+              build_type: 'Release',
+              cmake_extra_flags: ''
+            }
+          - {
+              name: 'Ubuntu latest Debug',
+              os: ubuntu-latest,
+              cc: 'gcc',
+              cxx: 'g++',
+              arch: 'x86_64',
+              build_type: 'Debug',
+              cmake_extra_flags: ''
+            }
+          - {
+              name: 'Ubuntu 22.04',
+              os: ubuntu-22.04,
+              cc: 'gcc',
+              cxx: 'g++',
+              arch: 'x86_64',
+              build_type: 'Release',
+              cmake_extra_flags: ''
+            }
+          - {
+              name: 'Ubuntu 20.04',
+              os: ubuntu-20.04,
+              cc: 'gcc',
+              cxx: 'g++',
+              arch: 'x86_64',
+              build_type: 'Release',
+              cmake_extra_flags: ''
+            }
+
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 8
+      - name: dependency
+        shell: bash
+        run: |
+          # this is not perfect but enought for now
+          if [ "$RUNNER_OS" == "Linux" ]; then
+            sudo apt-get update
+            sudo apt-get install libasound2-dev libudev-dev libhamlib-dev gpsd
+          elif [ "$RUNNER_OS" == "macOS" ]; then
+            # just to simplify I use homebrew but
+            # we can use macports (latest direwolf is already available as port)
+            brew install portaudio hamlib gpsd
+          elif [ "$RUNNER_OS" == "Windows" ]; then
+            # add the folder to PATH
+            echo "C:\msys64\mingw32\bin" >> $GITHUB_PATH
+          fi
+      - name: create build environment
+        run: |
+          cmake -E make_directory ${{github.workspace}}/build
+      - name: configure
+        shell: bash
+        working-directory: ${{github.workspace}}/build
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            export CC=${{ matrix.config.cc }}
+            export CXX=${{ matrix.config.cxx }}
+            export AR=${{ matrix.config.ar }}
+            export WINDRES=${{ matrix.config.windres }}
+          fi
+          cmake $GITHUB_WORKSPACE \
+            -DCMAKE_BUILD_TYPE=${{ matrix.config.build_type }} \
+            -DCMAKE_C_COMPILER=${{ matrix.config.cc }} \
+            -DCMAKE_CXX_COMPILER=${{ matrix.config.cxx }} \
+            -DCMAKE_CXX_FLAGS="-Werror" -DUNITTEST=1 \
+            ${{ matrix.config.cmake_extra_flags }} \
+            ${{ github.event.inputs.cmake_flags }}
+      - name: build
+        shell: bash
+        working-directory: ${{github.workspace}}/build
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ]; then
+            export CC=${{ matrix.config.cc }}
+            export CXX=${{ matrix.config.cxx }}
+            export AR=${{ matrix.config.ar }}
+            export WINDRES=${{ matrix.config.windres }}
+          fi
+          cmake --build . --config ${{ matrix.config.build_type }} \
+            ${{ github.event.inputs.cmake_flags }}
+      - name: test
+        continue-on-error: true
+        shell: bash
+        working-directory: ${{github.workspace}}/build
+        run: |
+          ctest -C ${{ matrix.config.build_type }} \
+            --parallel 2 --output-on-failure \
+            ${{ github.event.inputs.cmake_flags }}
+      - name: package
+        shell: bash
+        working-directory: ${{github.workspace}}/build
+        run: |
+          if [ "$RUNNER_OS" == "Windows" ] ||  [ "$RUNNER_OS" == "macOS" ]; then
+            make package
+          fi
+      - name: archive binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: direwolf_${{ matrix.config.os }}_${{ matrix.config.arch }}_${{ github.sha }}
+          path: |
+            ${{github.workspace}}/build/direwolf-*.zip
+            ${{github.workspace}}/build/direwolf.conf
+            ${{github.workspace}}/build/src/*
+            ${{github.workspace}}/build/CMakeCache.txt
+            !${{github.workspace}}/build/src/cmake_install.cmake
+            !${{github.workspace}}/build/src/CMakeFiles
+            !${{github.workspace}}/build/src/Makefile

.github/workflows/codeql-analysis-python.yml

@@ -0,0 +1,64 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL - Python"
+
+on:
+  push:
+    branches: [ dev ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ dev ]
+  schedule:
+    - cron: '25 8 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        setup-python-dependencies: true
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,74 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL - CPP"
+
+on:
+  push:
+    branches: [ dev ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ dev ]
+  schedule:
+    - cron: '25 8 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'cpp' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        setup-python-dependencies: true
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    - run: |
+       mkdir build
+       cd build
+       cmake -DUNITTEST=1 ..
+       make
+       make test
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

.gitignore

@@ -105,3 +105,9 @@ $RECYCLE.BIN/
 
 # Windows shortcuts
 *.lnk
+/use_this_sdk
+*.dSYM
+
+# cmake
+build/
+tmp/

CHANGES.md

@@ -2,32 +2,201 @@
 # Revision History #
 
 
+## Version 1.7  --  October 2023 ##
+
+
+### New Documentation: ###
+
+Additional documentation location to slow down growth of main repository.  [https://github.com/wb2osz/direwolf-doc](https://github.com/wb2osz/direwolf-doc) .   These are more oriented toward achieving a goal and understanding, as opposed to the User Guide which describes the functionality.
+
+- ***APRS Digipeaters***
+
+- ***Internal Packet Routing***
+
+- ***Radio Interface Guide***
+
+- ***Successful IGate Operation***
+
+- ***Understanding APRS Packets***
+
+
+### New Features: ###
+
+
+
+- New ICHANNEL configuration option to map a KISS client application channel to APRS-IS. Packets from APRS-IS will be presented to client applications as the specified channel. Packets sent, by client applications, to that channel will go to APRS-IS rather than a radio channel.  Details in ***Internal-Packet-Routing.pdf***.
+
+- New variable speed option for gen_packets. For example,  "-v 5,0.1" would generate packets from 5% too slow to 5% too fast with increments of 0.1.  Some implementations might have imprecise timing.  Use this to test how well TNCs tolerate sloppy timing.
+
+- Improved Layer 2 Protocol [(IL2P)](https://en.wikipedia.org/wiki/FX.25_Forward_Error_Correction).    Compatible with Nino TNC for 1200 and 9600 bps.  Use "-I 1" on command line to enable transmit for first channel.  For more general case, add to config file (simplified version, see User Guide for more details):
+
+    > After:   "CHANNEL 1"   (or other channel)
+    >
+    > Add:     "IL2PTX 1"
+
+- Limited support for CM108/CM119 GPIO PTT on Windows.
+
+- Dire Wolf now advertises itself using DNS Service Discovery.  This allows suitable APRS / Packet Radio applications to find a network KISS TNC without knowing the IP address or TCP port.    Thanks to Hessu for providing this.  Currently available only for Linux and Mac OSX.  [Read all about it here.](https://github.com/hessu/aprs-specs/blob/master/TCP-KISS-DNS-SD.md)
+
+- The transmit calibration tone (-x) command line option now accepts a radio channel number and/or a single letter mode:  a = alternate tones, m = mark tone, s = space tone, p = PTT only no sound.
+
+- The BEACON configuration now recognizes the SOURCE= option.  This replaces the AX.25 source address rather than using the MYCALL value for the channel.  This is useful for sending more than 5 analog telemetry channels.  Use two, or more, source addresses with up to 5 analog channels each.
+
+- For more flexibility, the FX.25 transmit property can now be set individually by channel, rather than having a global setting for all channels.  The -X on the command line applies only to channel 0.  For other channels you need to add a new line to the configuration file.  You can specify a specific number of parity bytes (16, 32, 64) or 1 to choose automatically based on packet size.
+
+    > After:   "CHANNEL 1"   (or other channel)
+    >
+    > Add:     "FX25TX 1" (or 16 or 32 or 64)
+
+
+
+### Bugs Fixed: ###
+
+- The t/m packet filter incorrectly included bulletins.  It now allows only "messages" to specific stations.  Use of t/m is discouraged.  i/180 is the preferred filter for messages to users recently heard locally.
+
+- Packet filtering now skips over any third party header before classifying packet types.
+
+- Fixed build for Alpine Linux.
+
+### Notes: ###
+
+The Windows binary distribution now uses gcc (MinGW) version 11.3.0.
+The Windows version is built for both 32 and 64 bit operating systems.
+Use the 64 bit version if possible; it runs considerably faster.
+
+## Version 1.6  --  October 2020 ##
+
+### New Build Procedure: ###
+
+
+- Rather than trying to keep a bunch of different platform specific Makefiles in sync, "cmake" is now used for greater portability and easier maintenance.  This was contributed by Davide Gerhard.
+
+- README.md has a quick summary of the process.  More details in the ***User Guide***.
+
+
+### New Features: ###
+
+
+- "-X" option enables FX.25 transmission.  FX.25 reception is always enabled so you don't need to do anything special.  "What is FX.25?" you might ask.  It is forward error correction (FEC) added in a way that is completely compatible with an ordinary AX.25 frame.  See new document ***AX25\_plus\_FEC\_equals\_FX25.pdf*** for details.
+
+- Receive AIS location data from ships.  Enable by using "-B AIS" command line option or "MODEM AIS" in the configuration file.  AIS NMEA sentences are encapsulated in APRS user-defined data with a "{DA" prefix.  This uses 9600 bps so you need to use wide band audio, not what comes out of the speaker.  There is also a "-A" option to generate APRS Object Reports.
+
+- Receive Emergency Alert System (EAS) Specific Area Message Encoding (SAME).  Enable by using "-B EAS" command line option or "MODEM EAS" in the configuration file.  EAS SAME messages are encapsulated in APRS user-defined data with a "{DE" prefix.  This uses low speed AFSK so speaker output is fine.
+
+- "-t" option now accepts more values to accommodate inconsistent handling of text color control codes by different terminal emulators.  The default, 1, should work with most modern terminal types.  If the colors are not right, try "-t 9" to see the result of the different choices and pick the best one.  If none of them look right, file a bug report and specify: operating system version (e.g. Raspbian Buster), terminal emulator type and version (e.g.  LXTerminal 0.3.2).   Include a screen capture.
+
+
+- "-g" option to force G3RUH mode for lower speeds where a different modem type may be the default.
+
+- 2400 bps compatibility with MFJ-2400.  See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** for details
+
+- "atest -h" will display the frame in hexadecimal for closer inspection.
+
+- Add support for Multi-GNSS NMEA sentences.
+
+
+
+### Bugs Fixed: ###
+
+- Proper counting of frames in transmit queue for AGW protocol 'Y' command.
+
+
+
+### New Documentation: ###
+
+- ***AX.25 + FEC = FX.25***
+
+- ***AIS Reception***
+
+- ***AX.25 Throughput: Why is 9600 bps Packet Radio only twice as fast as 1200?***
+
+- [***Ham Radio of Things (HRoT) - IoT over Ham Radio***](https://github.com/wb2osz/hrot)
+
+- [***EAS SAME to APRS Message Converter***](https://github.com/wb2osz/eas2aprs)
+
+- [***Dire Wolf PowerPoint Slide Show***](https://github.com/wb2osz/direwolf-presentation)
+
+### Notes: ###
+
+The Windows binary distribution now uses gcc (MinGW) version 7.4.0.
+The Windows version is built for both 32 and 64 bit operating systems.
+Use the 64 bit version if possible; it runs considerably faster.
+
+
+
+## Version 1.5  --  September 2018 ##
+
+
+### New Features: ###
+
+- PTT using GPIO pin of CM108/CM119 (e.g. DMK URI, RB-USB RIM), Linux only.
+
+- More efficient error recovery for AX.25 connected mode.  Better generation and processing of REJ and SREJ to reduce unnecessary duplicate "**I**" frames.
+
+- New configuration option, "**V20**", for listing stations known to not understand AX.25 v2.2.  This will speed up connection by going right to SABM and not trying SABME first and failing.
+
+- New "**NOXID**" configuration file option to avoid sending XID command to listed station(s).  If other end is a partial v2.2 implementation, which recognizes SABME, but not XID, we would waste a lot of time resending XID many times before giving up.   This is less drastic than the "**V20**" option which doesn't even attempt to use v2.2 with listed station(s).
+
+- New application "**kissutil**" for troubleshooting a KISS TNC or interfacing to an application via files.
+
+- KISS "Set Hardware" command to report transmit queue length.
+
+- TCP KISS can now handle multiple concurrent applications.
+
+- Linux can use serial port for KISS in addition to a pseudo terminal.
+
+- decode_aprs utility can now accept KISS frames and AX.25 frames as series of two digit hexadecimal numbers.
+
+- Full Duplex operation.  (Put "FULLDUP ON" in channel section of configuration file.)
+
+- Time slots for beaconing.
+
+- Allow single log file with fixed name rather than starting a new one each day.
+
+
+
+### Bugs Fixed: ###
+
+- Possible crash when CDIGIPEAT did not include the optional alias.
+
+- PACLEN configuration item no longer restricts length of received frames.
+
+- Strange failures when trying to use multiple KISS client applications over TCP.  Only Linux was affected.  
+
+- Under certain conditions, outgoing connected mode data would get stuck in a queue and not be transmitted.  This could happen if client application sends a burst of data larger than the "window" size (MAXFRAME or EMAXFRAME option).
+
+
+- Little typographical / spelling errors in messages.
+
+
+### Documentation: ###
+
+
+- New document ***Bluetooth-KISS-TNC.pdf*** explaining how to use KISS over Bluetooth.
+
+- Updates describing cheap SDR frequency inaccuracy and how to compensate for it.
+
+### Notes: ###
+
+Windows binary distribution now uses gcc (MinGW) version 6.3.0.
 
 ----------
 
-## Version 1.4  -- Development snapshot D --  November 2016 ##
-
-This is a snapshot at some semi-stable point in the development of the next version.  It is not well tested.  New features might be incomplete, poorly documented, and subject to change.
+## Version 1.4  -- April 2017 ##
 
 
 ### New Features: ###
 
 - AX.25 v2.2 connected mode.  See chapter 10 of User Guide for details.
 
-
-----------
-
-## Version 1.4  -- Development snapshot C --  June 2016 ##
-
-This is a snapshot at some semi-stable point in the development of the next version.  It is not well tested.  New features might be incomplete, poorly documented, and subject to change.
-
-
-### New Features: ###
+- New client side packet filter to select "messages" only to stations that have been heard nearby recently.  This is now the default if no IS to RF filter is specified.
 
 - New beacon type, IBEACON, for sending IGate statistics.
 
-- 2400 & 4800 bps PSK modems.  See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** in the doc directory for discussion.
+- Expanded debug options so you can understand what is going on with packet filtering.
 
+- Added new document ***Successful-APRS-IGate-Operation.pdf*** with IGate background, configuration, and troubleshooting tips.
+- 2400 & 4800 bps PSK modems.  See ***2400-4800-PSK-for-APRS-Packet-Radio.pdf*** in the doc directory for discussion.
 
 - The top speed of 9600 bps has been increased to 38400.  You will need a sound card capable of 96k or 192k samples per second for the higher rates.  Radios must also have adequate bandwidth.  See ***Going-beyond-9600-baud.pdf*** in the doc directory for more details.
 
@@ -39,8 +208,25 @@ This is a snapshot at some semi-stable point in the development of the next vers
  - $PMGNWPL	- Magellan, more complete for stationary objects.
  - $PKWDWPL	- Kenwood with APRS style symbol but missing comment.
 
+
+- DTMF tones can be sent by putting "DTMF" in the destination address,  similar to the way that Morse Code is sent.
+
+- Take advantage of new 'gpio' group and new /sys/class/gpio ownership in Raspbian Jessie.
+
+- Handle more complicated gpio naming for CubieBoard, etc.
+
+- More flexible dw-start.sh start up script for both GUI and CLI environments.
+
+
+ 
 ### Bugs Fixed: ###
 
+- The transmitter (PTT control) was being turned off too soon when sending Morse Code.
+
+- The -qd (quiet decode) command line option now suppresses errors about improperly formed Telemetry packets.
+
+- Longer tocall.txt files can now be handled.  
+
 - Sometimes kissattach would have an issue with the Dire Wolf pseudo terminal.  This showed up most often on Raspbian but sometimes occurred with other versions of Linux.
 
 	*kissattach: Error setting line discipline: TIOCSETD: Device or resource busy
@@ -56,9 +242,17 @@ received frames are not being printed.  After a while this message will appear:
   	frozen.  This can be caused by using a pseudo terminal (direwolf -p) where 
   	another application is not reading the frames from the other side.*
 
+- -p command line option caused segmentation fault with glibc >= 2.24.
+
 
 - The Windows version 1.3 would crash when starting to transmit on Windows XP. There have also been some other reports of erratic behavior on Windows. The crashing problem was fixed in in the 1.3.1 patch release.   Linux version was not affected.
 
+- IGate did not retain nul characters in the information part of a packet.  This should never happen with a valid APRS packet but there are a couple cases where it has.  If we encounter these malformed packets, pass them along as-is, rather than truncating.
+
+- Don't digipeat packets when the source is my call.
+
+
+
 ----------
 
 ## Version 1.3  -- May 2016 ##

CMakeLists.txt

@@ -0,0 +1,414 @@
+cmake_minimum_required(VERSION 3.5.0)
+
+project(direwolf)
+
+# configure version
+set(direwolf_VERSION_MAJOR "1")
+set(direwolf_VERSION_MINOR "7")
+set(direwolf_VERSION_PATCH "0")
+set(direwolf_VERSION_SUFFIX "Development")
+
+# options
+# See Issue 297.
+option(FORCE_SSE "Compile with SSE instruction only" ON)
+option(FORCE_SSSE3 "Compile with SSSE3 instruction only" OFF)
+option(FORCE_SSE41 "Compile with SSE4.1 instruction only" OFF)
+option(OPTIONAL_TEST "Compile optional test (might be broken)" OFF)
+# UNITTEST option must be after CMAKE_BUILT_TYPE
+
+# where cmake find custom modules
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_SOURCE_DIR}/cmake/modules)
+
+# fix c standard used on the project
+set(CMAKE_C_STANDARD 99)
+
+# Set additional project information
+set(COMPANY "wb2osz")
+add_definitions("-DCOMPANY=\"${COMPANY}\"")
+set(APPLICATION_NAME "Dire Wolf")
+add_definitions("-DAPPLICATION_NAME=\"${APPLICATION_NAME}\"")
+set(APPLICATION_MAINTAINER="John Langner, WB2OSZ")
+set(COPYRIGHT "Copyright (c) 2019 John Langner, WB2OSZ. All rights reserved.")
+add_definitions("-DCOPYRIGHT=\"${COPYRIGHT}\"")
+set(IDENTIFIER "com.${COMPANY}.${APPLICATION_NAME}")
+add_definitions("-DIDENTIFIER=\"${IDENTIFIER}\"")
+# raspberry as only lxterminal not xterm
+if(NOT (WIN32 OR CYGWIN))
+  find_program(BINARY_TERMINAL_BIN lxterminal)
+  if(BINARY_TERMINAL_BIN)
+    set(APPLICATION_DESKTOP_EXEC "${BINARY_TERMINAL_BIN} -e ${CMAKE_PROJECT_NAME}")
+  else()
+    set(APPLICATION_DESKTOP_EXEC "xterm -e ${CMAKE_PROJECT_NAME}")
+  endif()
+endif()
+
+find_package(Git)
+if(GIT_FOUND AND EXISTS "${CMAKE_SOURCE_DIR}/.git/")
+  # we can also use `git describe --tags`
+  execute_process(COMMAND "${GIT_EXECUTABLE}" rev-parse --short HEAD
+    WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+    RESULT_VARIABLE res
+    OUTPUT_VARIABLE out
+    ERROR_QUIET
+    OUTPUT_STRIP_TRAILING_WHITESPACE)
+  if(NOT res)
+    string(REGEX REPLACE "^v([0-9]+)\.([0-9]+)\.([0-9]+)-" "" git_commit ${out})
+    set(direwolf_VERSION_SUFFIX "-${git_commit}")
+    set(direwolf_VERSION_COMMIT "${git_commit}")
+  endif()
+endif()
+
+# set variables
+set(direwolf_VERSION "${direwolf_VERSION_MAJOR}.${direwolf_VERSION_MINOR}.${direwolf_VERSION_PATCH}${direwolf_VERSION_SUFFIX}")
+message(STATUS "${APPLICATION_NAME} Version: ${direwolf_VERSION}")
+add_definitions("-DIREWOLF_VERSION=\"${direwolf_VERSION}\"")
+add_definitions("-DMAJOR_VERSION=${direwolf_VERSION_MAJOR}")
+add_definitions("-DMINOR_VERSION=${direwolf_VERSION_MINOR}")
+if(direwolf_VERSION_COMMIT)
+  add_definitions("-DEXTRA_VERSION=${direwolf_VERSION_COMMIT}")
+endif()
+
+set(CUSTOM_SRC_DIR "${CMAKE_SOURCE_DIR}/src")
+set(CUSTOM_EXTERNAL_DIR "${CMAKE_SOURCE_DIR}/external")
+set(CUSTOM_MISC_DIR "${CUSTOM_EXTERNAL_DIR}/misc")
+set(CUSTOM_REGEX_DIR "${CUSTOM_EXTERNAL_DIR}/regex")
+set(CUSTOM_HIDAPI_DIR "${CUSTOM_EXTERNAL_DIR}/hidapi")
+set(CUSTOM_GEOTRANZ_DIR "${CUSTOM_EXTERNAL_DIR}/geotranz")
+set(CUSTOM_DATA_DIR "${CMAKE_SOURCE_DIR}/data")
+set(CUSTOM_SCRIPTS_DIR "${CMAKE_SOURCE_DIR}/scripts")
+set(CUSTOM_TELEMETRY_DIR "${CUSTOM_SCRIPTS_DIR}/telemetry-toolkit")
+set(CUSTOM_CONF_DIR "${CMAKE_SOURCE_DIR}/conf")
+set(CUSTOM_DOC_DIR "${CMAKE_SOURCE_DIR}/doc")
+set(CUSTOM_MAN_DIR "${CMAKE_SOURCE_DIR}/man")
+set(CUSTOM_TEST_DIR "${CMAKE_SOURCE_DIR}/test")
+set(CUSTOM_TEST_SCRIPTS_DIR "${CUSTOM_TEST_DIR}/scripts")
+set(CUSTOM_SHELL_SHABANG "#!/bin/sh -e")
+
+# cpack variables
+set(CPACK_GENERATOR "ZIP")
+set(CPACK_STRIP_FILES true)
+set(CPACK_PACKAGE_NAME "${CMAKE_PROJECT_NAME}")
+# This has architecture of the build machine, not the target platform.
+# e.g. Comes out as x86_64 when building for i686 target platform.
+#set(CPACK_PACKAGE_FILE_NAME "${CMAKE_PROJECT_NAME}-${direwolf_VERSION}_${CMAKE_SYSTEM_PROCESSOR}")
+# We don't know the target yet so this is set after FindCPUflags.
+set(CPACK_PACKAGE_CONTACT "https://github.com/wb2osz/direwolf")
+SET(CPACK_PACKAGE_DESCRIPTION_SUMMARY "Dire Wolf is an AX.25 soundcard TNC, digipeater, APRS IGate, GPS tracker, and APRStt gateway")
+set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_SOURCE_DIR}/README.md")
+set(CPACK_RESOURCE_FILE_README "${CMAKE_SOURCE_DIR}/README.md")
+set(CPACK_RESOURCE_FILE_LICENSE "${CMAKE_SOURCE_DIR}/LICENSE")
+set(CPACK_SOURCE_IGNORE_FILES "${PROJECT_BINARY_DIR};/.git/;.gitignore;menu.yml;.travis.yml;.appveyor.yml;default.nix;.envrc;TODOs.org;/.scripts/")
+SET(CPACK_PACKAGE_VERSION "${direwolf_VERSION}")
+SET(CPACK_PACKAGE_VERSION_MAJOR "${direwolf_VERSION_MAJOR}")
+SET(CPACK_PACKAGE_VERSION_MINOR "${direwolf_VERSION_MINOR}")
+SET(CPACK_PACKAGE_VERSION_PATCH "${direwolf_VERSION_PATCH}")
+SET(CPACK_DEBIAN_PACKAGE_DEPENDS "libasound2,libgps23")
+
+# if we don't set build_type
+if(NOT DEFINED CMAKE_BUILD_TYPE OR "${CMAKE_BUILD_TYPE}" STREQUAL "")
+  set(CMAKE_BUILD_TYPE Release CACHE STRING "Build type" FORCE)
+endif()
+message(STATUS "Build type set to: ${CMAKE_BUILD_TYPE}")
+message("CMake system: ${CMAKE_SYSTEM_NAME}")
+
+# Unittest should be on for dev builds and off for releases.
+if(CMAKE_BUILD_TYPE MATCHES "Release")
+  option(UNITTEST "Build unittest binaries." OFF)
+else()
+  option(UNITTEST "Build unittest binaries." ON)
+endif()
+
+# set compiler
+include(FindCompiler)
+
+# find cpu flags (and set compiler)
+include(FindCPUflags)
+
+if(${ARCHITECTURE} MATCHES "x86")
+  set(CPACK_PACKAGE_FILE_NAME "${CMAKE_PROJECT_NAME}-${direwolf_VERSION}_i686")
+else()
+  set(CPACK_PACKAGE_FILE_NAME "${CMAKE_PROJECT_NAME}-${direwolf_VERSION}_${ARCHITECTURE}")
+endif()
+
+# auto include current directory
+set(CMAKE_INCLUDE_CURRENT_DIR ON)
+
+# set OS dependent variables
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Linux")
+  set(LINUX TRUE)
+
+  configure_file("${CMAKE_SOURCE_DIR}/cmake/cpack/${CMAKE_PROJECT_NAME}.desktop.in"
+    "${CMAKE_BINARY_DIR}/${CMAKE_PROJECT_NAME}.desktop" @ONLY)
+
+elseif(${CMAKE_SYSTEM_NAME} STREQUAL "FreeBSD")
+  set(FREEBSD TRUE)
+  configure_file("${CMAKE_SOURCE_DIR}/cmake/cpack/${CMAKE_PROJECT_NAME}.desktop.in"
+    "${CMAKE_BINARY_DIR}/${CMAKE_PROJECT_NAME}.desktop" @ONLY)
+
+elseif(${CMAKE_SYSTEM_NAME} STREQUAL "OpenBSD")
+  set(OPENBSD TRUE)
+  set(HAVE_SNDIO TRUE)
+
+elseif(APPLE)
+  if("${CMAKE_OSX_DEPLOYMENT_TARGET}" STREQUAL "")
+    message(STATUS "Build for macOS target: local version")
+  else()
+    message(STATUS "Build for macOS target: ${CMAKE_OSX_DEPLOYMENT_TARGET}")
+  endif()
+
+  # prepend path to find_*()
+  set(CMAKE_FIND_ROOT_PATH "/opt/local")
+
+  set(CMAKE_MACOSX_RPATH ON)
+  message(STATUS "RPATH support: ${CMAKE_MACOSX_RPATH}")
+
+  # just blindly enable dns-sd
+  set(USE_MACOS_DNSSD ON)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_MACOS_DNSSD")
+
+elseif (WIN32)
+  if(C_MSVC)
+    if (NOT VS2015 AND NOT VS2017 AND NOT VS2019)
+      message(FATAL_ERROR "You must use Microsoft Visual Studio 2015, 2017 or 2019 as compiler")
+    else()
+      # compile with full multicore
+      set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /MP")
+      set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /MP")
+      set(CUSTOM_SHELL_BIN "")
+    endif()
+  endif()
+endif()
+
+if (C_CLANG OR C_GCC)
+  # _BSD_SOURCE is deprecated we need to use _DEFAULT_SOURCE.
+  #
+  # That works find for more modern compilers but we have issues with:
+  #	Centos 7, gcc 4.8.5, glibc 2.17
+  #	Centos 6, gcc 4.4.7, glibc 2.12
+  #
+  # CentOS 6 & 7:  Without -D_BSD_SOURCE, we get Warning: Implicit declaration of
+  # functions alloca, cfmakeraw, scandir, setlinebuf, strcasecmp, strncasecmp, and strsep.
+  # When a function (like strsep) returns a pointer, the compiler instead assumes a 32 bit
+  # int and sign extends it out to be a 64 bit pointer.  Use the pointer and Kaboom!
+  #
+  # CentOS 6: We have additional problem.  Without -D_POSIX_C_SOURCE=199309L, we get
+  # implicit declaration of function clock_gettime and the linker can't find it.
+  #
+  # It turns out that -D_GNU_SOURCE can be used instead of both of those.  For more information, 
+  # see https://www.gnu.org/software/libc/manual/html_node/Feature-Test-Macros.html
+  #
+  # Why was this not an issue before?  If gcc is used without the -std=c99 option, 
+  # it is perfectly happy with clock_gettime, strsep, etc. but with the c99 option, it no longer
+  # recognizes a bunch of commonly used functions.  Using _GNU_SOURCE, rather than _DEFAULT_SOURCE
+  # solves the problem for CentOS 6 & 7.  This also makes -D_XOPEN_SOURCE= unnecessary.
+  # I hope it doesn't break with newer versions of glibc.
+  #
+  # I also took out -Wextra because it spews out so much noise a serious problem was not noticed.
+  # It might go back in someday when I have more patience to clean up all the warnings.
+  #
+
+  # TODO:
+  # Try error checking -fsanitize=bounds-strict -fsanitize=leak
+  # Requires libubsan and liblsan, respectively.
+
+  ###set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wvla -ffast-math -ftree-vectorize -D_XOPEN_SOURCE=600 -D_DEFAULT_SOURCE ${EXTRA_FLAGS}")
+  if(FREEBSD)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wvla -ffast-math -ftree-vectorize -D_DEFAULT_SOURCE ${EXTRA_FLAGS}")
+  else()
+    #set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wvla -ffast-math -ftree-vectorize -D_GNU_SOURCE -fsanitize=bounds-strict ${EXTRA_FLAGS}")
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wvla -ffast-math -ftree-vectorize -D_GNU_SOURCE ${EXTRA_FLAGS}")
+  endif()
+  #
+  #
+  # -lm is needed for functions in math.h
+  if (LINUX)
+    # We have another problem with CentOS 6.  clock_gettime() is in librt so we need -lrt.
+    # The clock_* functions were moved into gnu libc for version 2.17.
+    #   https://sourceware.org/ml/libc-announce/2012/msg00001.html
+    # If using gnu libc 2.17, or later, the -lrt is no longer needed but doesn't hurt.
+    # I'm making this conditional on LINUX because it is not needed for BSD and MacOSX.
+    link_libraries("-lrt -lm")
+  else()
+    link_libraries("-lm")
+  endif()
+elseif (C_MSVC)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -W3 -MP ${EXTRA_FLAGS}")
+endif()
+
+if (C_CLANG)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -ferror-limit=1")
+elseif (C_GCC)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fmax-errors=1")
+endif()
+
+# set installation directories
+if (WIN32 OR CYGWIN)
+  set(INSTALL_BIN_DIR ".")
+  set(INSTALL_DOC_DIR "doc")
+  set(INSTALL_CONF_DIR ".")
+  set(INSTALL_SCRIPTS_DIR "scripts")
+  set(INSTALL_MAN_DIR "man")
+  set(INSTALL_DATA_DIR "data")
+else()
+  set(INSTALL_BIN_DIR "bin")
+  set(INSTALL_DOC_DIR "share/doc/${CMAKE_PROJECT_NAME}")
+  set(INSTALL_CONF_DIR "${INSTALL_DOC_DIR}/conf")
+  set(INSTALL_SCRIPTS_DIR "${INSTALL_DOC_DIR}/scripts")
+  if(FREEBSD)
+    set(INSTALL_MAN_DIR "man/man1")
+  else()
+    set(INSTALL_MAN_DIR "share/man/man1")
+  endif()
+  set(INSTALL_DATA_DIR "share/${PROJECT_NAME}")
+endif(WIN32 OR CYGWIN)
+
+# requirements
+
+include(CheckSymbolExists)
+
+# Some platforms provide their own strlcpy & strlcat. (BSD, MacOSX)
+# Others don't so we provide our own. (Windows, most, but not all Linux)
+# Here we detect whether these are provided by the OS and set a symbol
+# so that:
+#  (1) libgps does not supply its own version.
+#  (2) we know whether we need to supply our own copy.
+#
+# This was all working fine until these were added to the gnu c library 2.38.
+# References:
+#  - https://www.gnu.org/software/libc/sources.html
+#  - https://sourceware.org/git/?p=glibc.git;a=blob_plain;f=NEWS;hb=HEAD
+#
+# This test is not detecting them for glibc 2.38 resulting in a conflict.
+# Why?  Are they declared in a different file or in some strange way?
+#
+# This is how they are declared in include/string.h:
+#
+#	extern __typeof (strlcpy) __strlcpy;
+#	libc_hidden_proto (__strlcpy)
+#	extern __typeof (strlcat) __strlcat;
+#	libc_hidden_proto (__strlcat)
+#
+# Apparently cmake does not recognize this style.
+# Keep this here for BSD type systems where it behaves as expected.
+# We will need to add a hack in direwolf.h to define these if glibc version >= 2.38.
+
+check_symbol_exists(strlcpy string.h HAVE_STRLCPY)
+if(HAVE_STRLCPY)
+    add_compile_options(-DHAVE_STRLCPY)
+endif()
+check_symbol_exists(strlcat string.h HAVE_STRLCAT)
+if(HAVE_STRLCAT)
+    add_compile_options(-DHAVE_STRLCAT)
+endif()
+
+set(THREADS_PREFER_PTHREAD_FLAG ON)
+find_package(Threads REQUIRED)
+
+find_package(GPSD)
+if(GPSD_FOUND)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DENABLE_GPSD")
+else()
+  set(GPSD_INCLUDE_DIRS "")
+  set(GPSD_LIBRARIES "")
+endif()
+
+find_package(hamlib)
+if(HAMLIB_FOUND)
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_HAMLIB")
+else()
+  set(HAMLIB_INCLUDE_DIRS "")
+  set(HAMLIB_LIBRARIES "")
+endif()
+
+if(LINUX)
+  find_package(ALSA REQUIRED)
+  if(ALSA_FOUND)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_ALSA")
+  endif()
+
+  find_package(udev)
+  if(UDEV_FOUND)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_CM108")
+  endif()
+
+  find_package(Avahi)
+  if(AVAHI_CLIENT_FOUND)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_AVAHI_CLIENT")
+  endif()
+
+elseif (HAVE_SNDIO)
+  find_package(sndio REQUIRED)
+  if(SNDIO_FOUND)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_SNDIO")
+  endif()
+
+elseif (NOT WIN32 AND NOT CYGWIN)
+  find_package(Portaudio REQUIRED)
+  if(PORTAUDIO_FOUND)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_PORTAUDIO")
+  endif()
+
+else()
+  set(ALSA_INCLUDE_DIRS "")
+  set(ALSA_LIBRARIES "")
+  set(UDEV_INCLUDE_DIRS "")
+  set(UDEV_LIBRARIES "")
+  # Version 1.7 supports CM108/CM119 GPIO PTT for Windows.
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DUSE_CM108")
+  set(PORTAUDIO_INCLUDE_DIRS "")
+  set(PORTAUDIO_LIBRARIES "")
+  set(SNDIO_INCLUDE_DIRS "")
+  set(SNDIO_LIBRARIES "")
+endif()
+
+# manage and fetch new data
+add_subdirectory(data)
+
+# external libraries
+add_subdirectory(${CUSTOM_GEOTRANZ_DIR})
+add_subdirectory(${CUSTOM_REGEX_DIR})
+add_subdirectory(${CUSTOM_HIDAPI_DIR})
+add_subdirectory(${CUSTOM_MISC_DIR})
+
+# direwolf source code and utilities
+add_subdirectory(src)
+
+# ctest
+if(UNITTEST)
+  message(STATUS "Build unit test binaries")
+  include(CTest)
+  enable_testing()
+  add_subdirectory(test)
+endif(UNITTEST)
+
+# manage scripts
+add_subdirectory(scripts)
+
+# manage config
+add_subdirectory(conf)
+
+# install basic docs
+install(FILES ${CMAKE_SOURCE_DIR}/CHANGES.md DESTINATION ${INSTALL_DOC_DIR})
+install(FILES ${CMAKE_SOURCE_DIR}/LICENSE DESTINATION ${INSTALL_DOC_DIR})
+install(FILES ${CMAKE_SOURCE_DIR}/external/LICENSE DESTINATION ${INSTALL_DOC_DIR}/external)
+add_subdirectory(doc)
+add_subdirectory(man)
+
+# install desktop link
+if (LINUX OR FREEBSD)
+  install(FILES ${CMAKE_BINARY_DIR}/${CMAKE_PROJECT_NAME}.desktop DESTINATION share/applications)
+  install(FILES ${CMAKE_SOURCE_DIR}/cmake/cpack/${CMAKE_PROJECT_NAME}_icon.png DESTINATION share/pixmaps)
+endif()
+
+############ uninstall target ################
+configure_file(
+  "${CMAKE_CURRENT_SOURCE_DIR}/cmake/include/uninstall.cmake.in"
+  "${CMAKE_CURRENT_BINARY_DIR}/uninstall.cmake"
+  IMMEDIATE @ONLY)
+
+add_custom_target(uninstall
+  COMMAND ${CMAKE_COMMAND} -P
+  ${CMAKE_CURRENT_BINARY_DIR}/uninstall.cmake)
+
+############ packaging ################
+add_subdirectory(cmake/cpack)

Makefile

@@ -1,16 +1,36 @@
-# Select proper Makefile for operating system.
-# The Windows version is built with the help of Cygwin. 
 
-# In my case, I see CYGWIN_NT-6.1-WOW so we don't check for 
-# equal to some value.   Your mileage my vary.
-
-win := $(shell uname | grep CYGWIN)
-dar := $(shell uname | grep Darwin)
-
-ifneq ($(win),)
-   include Makefile.win
-else ifeq ($(dar),Darwin)
-   include Makefile.macosx
-else
-   include Makefile.linux
-endif
+all:
+	@echo "The build procedure has changed in version 1.6."
+	@echo "In general, it now looks like this:"
+	@echo " "
+	@echo "Download the source code:"
+	@echo " "
+	@echo "	cd ~"
+	@echo "	git clone https://www.github.com/wb2osz/direwolf"
+	@echo "	cd direwolf"
+	@echo " "
+	@echo "Optional - Do this to get the latest development version"
+	@echo "rather than the latest stable release."
+	@echo " "
+	@echo "	git checkout dev"
+	@echo " "
+	@echo "Build it.  There are two new steps not used for earlier releases."
+	@echo " "
+	@echo "	mkdir build && cd build"
+	@echo "	cmake .."
+	@echo "	make -j4"
+	@echo " "
+	@echo "Install:"
+	@echo " "
+	@echo "	sudo make install"
+	@echo "	make install-conf"
+	@echo " "
+	@echo "You will probably need to install additional applications and"
+	@echo "libraries depending on your operating system."
+	@echo "More details are in the README.md file."
+	@echo " "
+	@echo "Questions?"
+	@echo " "
+	@echo " - Extensive documentation can be found in the 'doc' directory."
+	@echo " - Join the discussion forum here:   https://groups.io/g/direwolf"
+	@echo " "

Makefile.linux

@@ -1,832 +0,0 @@
-#
-# Makefile for Linux version of Dire Wolf.
-#
-
-APPS := direwolf decode_aprs text2tt tt2text ll2utm utm2ll aclients atest log2gpx gen_packets ttcalc
-
-all :  $(APPS) direwolf.desktop direwolf.conf
-	@echo " "
-	@echo "Next step - install with:"
-	@echo " "
-	@echo "        sudo make install"
-	@echo " "
-
-CC := gcc
-CFLAGS := -O3 -pthread -Igeotranz
-
-LDFLAGS := -lm -lpthread -lrt
-
-
-
-#
-# The DSP filters spend a lot of time spinning around in little
-# loops multiplying and adding arrays of numbers.  The Intel "SSE"
-# instructions, introduced in 1999 with the Pentium III series,
-# can speed this up considerably.
-#
-# SSE2 instructions, added in 2000, don't seem to offer any advantage.
-#
-#
-# Let's take a look at the effect of the compile options.
-#
-#
-# Times are elapsed time to process Track 2 of the TNC test CD.
-#
-# i.e.   "./atest 02_Track_2.wav"
-# Default demodulator type is new "E" added for version 1.2.
-#
-
-#
-# ---------- x86 (32 bit) ---------- 
-#
-
-#
-# gcc 4.6.3 running on Ubuntu 12.04.05.
-# Intel(R) Celeron(R) CPU 2.53GHz.  Appears to have only 32 bit instructions.
-# Probably from around 2004 or 2005.
-#
-# When gcc is generating code for a 32 bit x86 target, it assumes the ancient 
-# i386 processor.  This is good for portability but bad for performance.
-#
-# The code can run considerably faster by taking advantage of the SSE instructions 
-# available in the Pentium 3 or later.
-#
-#       seconds options		comments
-#       ------  -------		--------
-#         524	
-#         183	-O2     
-#         182	-O3	
-#         183	-O3 -ffast-math  	(should be same as -Ofast)
-#         184	-Ofast 	   	
-#         189	-O3 -ffast-math -march=pentium
-#         122	-O3 -ffast-math -msse
-#         122	-O3 -ffast-math -march=pentium -msse
-#         121	-O3 -ffast-math -march=pentium3   (this implies -msse)
-#         120	-O3 -ffast-math -march=native
-#
-# Note that "-march=native" is essentially the same as "-march=pentium3."  
-#
-
-# If the compiler is generating code for the i386 target, we can
-# get much better results by telling it we have at least a Pentium 3.
-
-arch := $(shell echo | gcc -E -dM - | grep __i386__)
-ifneq ($(arch),)
-CFLAGS += -march=pentium3
-endif
-
-
-#
-# ---------- x86_64 ---------- 
-#
-
-#
-# gcc 4.8.2 running on Ubuntu 14.04.1.
-# Intel Core 2 Duo from around 2007 or 2008.
-#
-# 64 bit target implies that we have SSE and probably even better vector instructions.
-#
-#       seconds options		comments
-#       ------  -------		--------
-#         245	
-#          75	-01
-#          72 	-02
-#          71  	-03     
-#          73  	-O3 -march=native
-#          42	-O3 -ffast-math  
-#          42  	-Ofast			(note below)   
-#          40	-O3 -ffast-math -march=native    
-#	  
-#
-# Note that "-Ofast" is a newer option roughly equivalent to "-O3 -ffast-math".
-# I use the longer form because it is compatible with older compilers.
-#
-# Why don't I don't have "-march=native?"
-# Older compilers don't recognize "native" as one of the valid options.  
-# One article said it was added with gcc 4.2 but I haven't verified that.
-#
-
-# Add -ffastmath in only if compiler version recognizes it.
-
-useffast := $(shell gcc --help -v 2>/dev/null | grep ffast-math)
-ifneq ($(useffast),)
-CFLAGS += -ffast-math
-endif
-
-
-#
-# ---------- ARM - Raspberry Pi 1 models ---------- 
-#
-# Raspberry Pi (before RPi model 2), ARM11 (ARMv6 + VFP2)
-# gcc (Debian 4.6.3-14+rpi1) 4.6.3
-# 
-#
-#       seconds options 	comments
-#       ------  -------		---------
-#         892	-O3   	
-#         887	-O3 -ffast-math  	
-#          x  	-O3 -ffast-math -march=native	(error: bad value for -march switch)
-#         887 	-O3 -ffast-math -mfpu=vfp
-#         890   -O3 -ffast-math -march=armv6zk -mcpu=arm1176jzf-s -mfloat-abi=hard -mfpu=vfp
-#
-#
-# The compiler, supplied with Raspbian, is configured with these options which are
-# good for the pre version 2 models.
-#	--with-arch=armv6 --with-fpu=vfp --with-float=hard
-# 
-# Run "gcc --help -v 2" and look near the end.
-#
-#
-
-#
-# ---------- ARM - Raspberry Pi 2  ---------- 
-#
-# Besides the higher clock speed, the Raspberry Pi 2 has the NEON instruction set 
-# which which should make things considerably faster.  
-#
-#
-#       seconds options 	comments
-#       ------  -------		---------
-#         426	-O3 -ffast-math  		(already more than twice as fast)
-#         429 	-O3 -mfpu=neon
-#         419 	-O3 -mfpu=neon -funsafe-math-optimizations
-#         412 	-O3 -ffast-math -mfpu=neon
-#         413 	-O3 -ffast-math -mfpu=neon-vfpv4
-#         430 	-O3 -ffast-math -mfpu=neon-vfpv4 -march=armv7-a
-#         412 	-O3 -ffast-math -mfpu=neon-vfpv4 -mtune=arm7
-#         410	-O3 -ffast-math -mfpu=neon-vfpv4 -funsafe-math-optimizations
-
-#
-#	gcc -march=armv7-a -mfpu=neon-vfpv4 
-#
-# I expected the -mfpu=neon option to have a much larger impact.
-# Adding -march=armv7-a makes it slower!
-
-#
-# If you compile with the RPi 2 specific options above and try to run it on the RPi 
-# model B (pre version 2), it will die with "illegal instruction."
-#
-# Dire Wolf is known to work on the BeagleBone, CubieBoard2, etc.
-# The best compiler options will depend on the specific type of processor
-# and the compiler target defaults.
-#
-
-neon := $(shell cat /proc/cpuinfo | grep neon)
-ifneq ($(neon),)
-CFLAGS += -mfpu=neon
-endif
-
-
-#
-# You would expect "-march=native" to produce the fastest code.
-# Why don't I use it here?
-#
-#	1. In my benchmarks, above, it has a negligible impact if any at all.
-#	2. Some older versions of gcc don't recognize "native" as a valid choice.
-#	3. Results are less portable.  Not a consideration if you are 
-#		building only for your own use but very important for anyone
-#		redistributing a "binary" version.
-#
-# If you are planning to distribute the binary version to other 
-# people (in some ham radio software collection, RPM, or DEB package), 
-# avoid fine tuning it for your particular computer.  It could
-# cause compatibility issues for those with older computers.
-#
-
-
-# If you want to use OSS (for FreeBSD, OpenBSD) instead of
-# ALSA (for Linux), comment out (or remove) the two lines below.
-
-CFLAGS += -DUSE_ALSA
-LDFLAGS += -lasound
-
-
-# Enable GPS if header file is present.
-# Finding libgps.so* is more difficult because it
-# is in different places on different operating systems.
-
-enable_gpsd := $(wildcard /usr/include/gps.h)
-ifneq ($(enable_gpsd),)
-CFLAGS += -DENABLE_GPSD
-LDFLAGS += -lgps
-endif
-
-
-# Uncomment following lines to enable hamlib support.
-#CFLAGS += -DUSE_HAMLIB
-#LDFLAGS += -lhamlib
-
-
-# Name of current directory.
-# Used to generate zip file name for distribution.
-
-z := $(notdir ${CURDIR})
-
-
-
-# --------------------------------  Main application  -----------------------------------------
-
-
-
-direwolf : direwolf.o config.o recv.o demod.o dsp.o demod_afsk.o demod_psk.o demod_9600.o hdlc_rec.o \
-		hdlc_rec2.o multi_modem.o rdq.o rrbb.o dlq.o \
-		fcs_calc.o ax25_pad.o  ax25_pad2.o xid.o \
-		decode_aprs.o symbols.o server.o kiss.o kissnet.o kiss_frame.o hdlc_send.o fcs_calc.o \
-		gen_tone.o audio.o audio_stats.o digipeater.o cdigipeater.o pfilter.o dedupe.o tq.o xmit.o morse.o \
-		ptt.o beacon.o encode_aprs.o latlong.o encode_aprs.o latlong.o textcolor.o \
-		dtmf.o aprs_tt.o tt_user.o tt_text.o igate.o waypoint.o serial_port.o log.o telemetry.o \
-		dwgps.o dwgpsnmea.o dwgpsd.o dtime_now.o mheard.o ax25_link.o \
-		misc.a geotranz.a
-	$(CC) -o $@ $^ $(LDFLAGS)
-ifneq ($(enable_gpsd),)
-	@echo " "
-	@echo "This includes support for gpsd."
-else
-	@echo " "
-	@echo "This does NOT include support for gpsd."
-endif
-
-# Optimization for slow processors.
-
-demod.o      : fsk_fast_filter.h
-
-demod_afsk.o : fsk_fast_filter.h
-
-
-fsk_fast_filter.h : gen_fff
-	./gen_fff > fsk_fast_filter.h
-
-gen_fff : demod_afsk.c dsp.c textcolor.c
-	echo " " > tune.h
-	$(CC) $(CFLAGS) -DGEN_FFF -o $@ $^ $(LDFLAGS)
-
-
-#
-# The destination field is often used to identify the manufacturer/model.
-# These are not hardcoded into Dire Wolf.  Instead they are read from
-# a file called tocalls.txt at application start up time.
-#
-# The original permanent symbols are built in but the "new" symbols,
-# using overlays, are often updated.  These are also read from files.
-#
-# You can obtain an updated copy by typing "make tocalls-symbols".
-# This is not part of the normal build process.  You have to do this explicitly.
-#
-# The locations below appear to be the most recent.
-# The copy at http://www.aprs.org/tocalls.txt is out of date.
-#
-
-.PHONY: tocalls-symbols
-tocalls-symbols :
-	cp tocalls.txt tocalls.txt~
-	wget http://www.aprs.org/aprs11/tocalls.txt -O tocalls.txt
-	-diff -Z tocalls.txt~ tocalls.txt
-	cp symbols-new.txt symbols-new.txt~
-	wget http://www.aprs.org/symbols/symbols-new.txt -O symbols-new.txt
-	-diff -Z symbols-new.txt~ symbols-new.txt
-	cp symbolsX.txt symbolsX.txt~
-	wget http://www.aprs.org/symbols/symbolsX.txt -O symbolsX.txt
-	-diff -Z symbolsX.txt~ symbolsX.txt
-
-
-# ---------------------------------------- Other utilities included ------------------------------
-
-
-# Separate application to decode raw data.
-
-decode_aprs : decode_aprs.c dwgpsnmea.o dwgps.o dwgpsd.o serial_port.o symbols.o ax25_pad.o textcolor.o fcs_calc.o latlong.o log.o telemetry.o tt_text.o misc.a
-	$(CC) $(CFLAGS) -DDECAMAIN -o $@ $^ $(LDFLAGS)
-
-
-
-# Convert between text and touch tone representation.
-
-text2tt : tt_text.c misc.a
-	$(CC) $(CFLAGS) -DENC_MAIN -o $@ $^ $(LDFLAGS)
-
-tt2text : tt_text.c misc.a
-	$(CC) $(CFLAGS) -DDEC_MAIN -o $@ $^ $(LDFLAGS)
-
-
-# Convert between Latitude/Longitude and UTM coordinates.
-
-ll2utm : ll2utm.c geotranz.a textcolor.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-
-utm2ll : utm2ll.c geotranz.a textcolor.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-
-
-# Convert from log file to GPX.
-
-log2gpx : log2gpx.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-
-
-# Test application to generate sound.
-
-gen_packets : gen_packets.c ax25_pad.c hdlc_send.c fcs_calc.c gen_tone.c morse.c textcolor.c dsp.c misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-
-# Unit test for AFSK demodulator
-
-atest : atest.c demod.o demod_afsk.o demod_psk.o demod_9600.o \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o rrbb.o \
-		fcs_calc.o ax25_pad.o decode_aprs.o dwgpsnmea.o \
-		dwgps.o dwgpsd.o serial_port.o telemetry.o dtime_now.o latlong.o symbols.o tt_text.o textcolor.o \
-		misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-
-
-# Multiple AGWPE network or serial port clients to test TNCs side by side.
-
-aclients : aclients.c ax25_pad.c fcs_calc.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -g -o $@ $^ 
-
-
-# Touch Tone to Speech sample application.
-
-ttcalc : ttcalc.o ax25_pad.o fcs_calc.o textcolor.o misc.a
-	$(CC) $(CFLAGS) -g -o $@ $^ 
-
-
-# -----------------------------------------  Libraries  --------------------------------------------
-
-# UTM, USNG, MGRS conversions.
-
-geotranz.a : error_string.o  mgrs.o  polarst.o  tranmerc.o  ups.o  usng.o  utm.o
-	ar -cr $@ $^
-
-error_string.o : geotranz/error_string.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-mgrs.o : geotranz/mgrs.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-polarst.o : geotranz/polarst.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-tranmerc.o : geotranz/tranmerc.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-ups.o : geotranz/ups.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-usng.o : geotranz/usng.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-utm.o : geotranz/utm.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-
-# Provide our own copy of strlcpy and strlcat because they are not included with Linux.
-# We don't need the others in that same directory.
-
-misc.a : strlcpy.o strlcat.o
-	ar -cr $@ $^	
- 
-strlcpy.o : misc/strlcpy.c
-	$(CC) $(CFLAGS) -I. -c -o $@ $^
-
-strlcat.o : misc/strlcat.c
-	$(CC) $(CFLAGS) -I. -c -o $@ $^
-
-
-
-# -------------------------------------  Installation  ----------------------------------
-
-
-
-# Generate apprpriate sample configuration file for this platform.
-# Originally, there was one sample for all platforms.  It got too cluttered
-# and confusing saying, this is for windows, and this is for Linux, and this ...
-# Trying to maintain 3 different versions in parallel is error prone.
-# We now have a single generic version which can be used to generate
-# the various platform specific versions.
-
-# generic.conf should be checked into source control.
-# direwolf.conf should NOT.  It is generated when compiling on the target platform.
-
-direwolf.conf : generic.conf
-	egrep '^C|^L' generic.conf | cut -c2-999 > direwolf.conf
-
-
-# Where should we install it?
-
-# My understanding, of the convention, is that something you compile
-# from source, that is not a standard part of the operating system,
-# should go in /usr/local/bin.
-
-# However, if you are preparing a "binary" DEB or RPM package, the
-# installation location should be /usr/bin.
-
-# This is a step in the right direction but not sufficient to use /usr instead.
-# Eventually I'd like to have targets here to build the .DEB and .RPM packages.
-
-INSTALLDIR := /usr/local
-
-# Command to "install" to system directories.  Use "ginstall" for Mac.
-
-INSTALL=install
-
-# direwolf.desktop was previously handcrafted for the Raspberry Pi.
-# It was hardcoded with lxterminal, /home/pi, and so on.
-# In version 1.2, try to customize this to match other situations better.
-
-# TODO:  Test this better.
-
-
-direwolf.desktop :
-	@echo "Generating customized direwolf.desktop ..."
-	@echo '[Desktop Entry]' > $@
-	@echo 'Type=Application' >> $@
-ifneq ($(wildcard /usr/bin/lxterminal),)
-	@echo "Exec=lxterminal -t \"Dire Wolf\" -e \"$(INSTALLDIR)/bin/direwolf\"" >> $@ 
-else ifneq ($(wildcard /usr/bin/lxterm),)
-	@echo "Exec=lxterm -hold -title \"Dire Wolf\" -bg white -e \"$(INSTALLDIR)/bin/direwolf\"" >> $@ 
-else
-	@echo "Exec=xterm -hold -title \"Dire Wolf\" -bg white -e \"$(INSTALLDIR)/bin/direwolf\"" >> $@
-endif
-	@echo 'Name=Dire Wolf' >> $@
-	@echo 'Comment=APRS Soundcard TNC' >> $@
-	@echo 'Icon=/usr/share/direwolf/dw-icon.png' >> $@
-	@echo "Path=$(HOME)" >> $@
-	@echo '#Terminal=true' >> $@
-	@echo 'Categories=HamRadio' >> $@
-	@echo 'Keywords=Ham Radio;APRS;Soundcard TNC;KISS;AGWPE;AX.25' >> $@
-
-
-# Installation into /usr/local/...
-# Needs to be run as root or with sudo.
-
-
-.PHONY: install
-install : $(APPS) direwolf.conf tocalls.txt symbols-new.txt symbolsX.txt dw-icon.png direwolf.desktop
-#
-# Applications, not installed with package manager, normally go in /usr/local/bin.
-# /usr/bin is used instead when installing from .DEB or .RPM package.
-#
-	$(INSTALL) direwolf $(INSTALLDIR)/bin
-	$(INSTALL) decode_aprs $(INSTALLDIR)/bin
-	$(INSTALL) text2tt $(INSTALLDIR)/bin
-	$(INSTALL) tt2text $(INSTALLDIR)/bin
-	$(INSTALL) ll2utm $(INSTALLDIR)/bin
-	$(INSTALL) utm2ll $(INSTALLDIR)/bin
-	$(INSTALL) aclients $(INSTALLDIR)/bin
-	$(INSTALL) log2gpx $(INSTALLDIR)/bin
-	$(INSTALL) gen_packets $(INSTALLDIR)/bin
-	$(INSTALL) atest $(INSTALLDIR)/bin
-	$(INSTALL) ttcalc $(INSTALLDIR)/bin
-	$(INSTALL) dwespeak.sh $(INSTALLDIR)/bin
-#
-# Telemetry Toolkit executables.   Other .conf and .txt files will go into doc directory.
-#
-	$(INSTALL) telemetry-toolkit/telem-balloon.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-bits.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-data.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-data91.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-eqns.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-parm.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-seq.sh $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-unit.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-volts.py $(INSTALLDIR)/bin
-#
-# Misc. data such as "tocall" to system mapping.
-#
-	$(INSTALL) -D --mode=644 tocalls.txt /usr/share/direwolf/tocalls.txt
-	$(INSTALL) -D --mode=644 symbols-new.txt /usr/share/direwolf/symbols-new.txt
-	$(INSTALL) -D --mode=644 symbolsX.txt /usr/share/direwolf/symbolsX.txt
-	$(INSTALL) -D --mode=644 dw-icon.png /usr/share/direwolf/dw-icon.png
-	$(INSTALL) -D --mode=644 direwolf.desktop /usr/share/applications/direwolf.desktop
-#
-# Documentation.  Various plain text files and PDF.
-#
-	$(INSTALL) -D --mode=644 CHANGES.md $(INSTALLDIR)/share/doc/direwolf/CHANGES.md
-	$(INSTALL) -D --mode=644 LICENSE-dire-wolf.txt $(INSTALLDIR)/share/doc/direwolf/LICENSE-dire-wolf.txt
-	$(INSTALL) -D --mode=644 LICENSE-other.txt $(INSTALLDIR)/share/doc/direwolf/LICENSE-other.txt
-#
-# ./README.md is an overview for the project main page.
-# doc/README.md contains an overview of the PDF file contents and is more useful here.
-#
-	$(INSTALL) -D --mode=644 doc/README.md $(INSTALLDIR)/share/doc/direwolf/README.md
-	$(INSTALL) -D --mode=644 doc/User-Guide.pdf $(INSTALLDIR)/share/doc/direwolf/User-Guide.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-APRS.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-APRS-Tracker.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS-Tracker.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-SDR-IGate.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-SDR-IGate.pdf
-	$(INSTALL) -D --mode=644 doc/APRStt-Implementation-Notes.pdf $(INSTALLDIR)/share/doc/direwolf/APRStt-Implementation-Notes.pdf
-	$(INSTALL) -D --mode=644 doc/APRStt-interface-for-SARTrack.pdf $(INSTALLDIR)/share/doc/direwolf/APRStt-interface-for-SARTrack.pdf
-	$(INSTALL) -D --mode=644 doc/APRS-Telemetry-Toolkit.pdf $(INSTALLDIR)/share/doc/direwolf/APRS-Telemetry-Toolkit.pdf
-	$(INSTALL) -D --mode=644 doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf $(INSTALLDIR)/share/doc/direwolf/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf
-	$(INSTALL) -D --mode=644 doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf $(INSTALLDIR)/share/doc/direwolf/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf
-#
-# Various sample config and other files go into examples under the doc directory.
-# When building from source, these can be put in home directory with "make install-conf".
-# When installed from .DEB or .RPM package, the user will need to copy these to
-# the home directory or other desired location.
-#
-	$(INSTALL) -D --mode=644 direwolf.conf $(INSTALLDIR)/share/doc/direwolf/examples/direwolf.conf
-	$(INSTALL) -D --mode=644 dw-start.sh $(INSTALLDIR)/share/doc/direwolf/examples/dw-start.sh
-	$(INSTALL) -D --mode=644 sdr.conf $(INSTALLDIR)/share/doc/direwolf/examples/sdr.conf
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-m0xer-3.txt $(INSTALLDIR)/share/doc/direwolf/examples/telem-m0xer-3.txt
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-balloon.conf $(INSTALLDIR)/share/doc/direwolf/examples/telem-balloon.conf
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-volts.conf $(INSTALLDIR)/share/doc/direwolf/examples/telem-volts.conf
-#
-# "man" pages
-#
-	$(INSTALL) -D --mode=644 man1/aclients.1 $(INSTALLDIR)/man/man1/aclients.1
-	$(INSTALL) -D --mode=644 man1/atest.1 $(INSTALLDIR)/man/man1/atest.1
-	$(INSTALL) -D --mode=644 man1/decode_aprs.1 $(INSTALLDIR)/man/man1/decode_aprs.1
-	$(INSTALL) -D --mode=644 man1/direwolf.1 $(INSTALLDIR)/man/man1/direwolf.1
-	$(INSTALL) -D --mode=644 man1/gen_packets.1 $(INSTALLDIR)/man/man1/gen_packets.1
-	$(INSTALL) -D --mode=644 man1/ll2utm.1 $(INSTALLDIR)/man/man1/ll2utm.1
-	$(INSTALL) -D --mode=644 man1/log2gpx.1 $(INSTALLDIR)/man/man1/log2gpx.1
-	$(INSTALL) -D --mode=644 man1/text2tt.1 $(INSTALLDIR)/man/man1/text2tt.1
-	$(INSTALL) -D --mode=644 man1/tt2text.1 $(INSTALLDIR)/man/man1/tt2text.1
-	$(INSTALL) -D --mode=644 man1/utm2ll.1 $(INSTALLDIR)/man/man1/utm2ll.1
-#
-	@echo " "
-	@echo "If this is your first install, not an upgrade, type this to put a copy"
-	@echo "of the sample configuration file (direwolf.conf) in your home directory:"
-	@echo " "
-	@echo "        make install-conf"
-	@echo " "
-
-
-# These would be done as ordinary user.
-
-# The Raspberry Pi has ~/Desktop but Ubuntu does not.
-
-# TODO: Handle Linux variations correctly.
-
-
-.PHONY: install-conf
-install-conf : direwolf.conf
-	cp direwolf.conf ~
-	cp sdr.conf ~
-	cp telemetry-toolkit/telem-m0xer-3.txt ~
-	cp telemetry-toolkit/telem-*.conf ~
-ifneq ($(wildcard $(HOME)/Desktop),)
-	@echo " "
-	@echo "This will add a desktop icon on some systems:"
-	@echo " "
-	@echo "        make install-rpi"
-	@echo " "
-endif
-
-
-.PHONY: install-rpi
-install-rpi : dw-start.sh
-	cp dw-start.sh ~
-	ln -f -s /usr/share/applications/direwolf.desktop ~/Desktop/direwolf.desktop
-
-
-
-# ----------------------------------  Automated Smoke Test  --------------------------------
-
-
-
-# Combine some unit tests into a single regression sanity check.
-
-
-check : dtest ttest tttexttest pftest tlmtest lltest enctest kisstest pad2test xidtest check-modem1200 check-modem300 check-modem9600 check-modem19200 check-modem2400 check-modem4800
-
-# Can we encode and decode at popular data rates?
-
-check-modem1200 : gen_packets atest
-	./gen_packets -n 100 -o /tmp/test12.wav
-	./atest -F0 -PE -L63 -G71 /tmp/test12.wav
-	./atest -F1 -PE -L70 -G75 /tmp/test12.wav
-	rm /tmp/test12.wav
-
-check-modem300 : gen_packets atest
-	./gen_packets -B300 -n 100 -o /tmp/test3.wav
-	./atest -B300 -F0 -L68 -G69 /tmp/test3.wav
-	./atest -B300 -F1 -L73 -G75 /tmp/test3.wav
-	rm /tmp/test3.wav
-
-check-modem9600 : gen_packets atest
-	./gen_packets -B9600 -n 100 -o /tmp/test96.wav
-	./atest -B9600 -F0 -L50 -G54 /tmp/test96.wav
-	./atest -B9600 -F1 -L55 -G59 /tmp/test96.wav
-	rm /tmp/test96.wav
-
-check-modem19200 : gen_packets atest
-	./gen_packets -r 96000 -B19200 -n 100 -o /tmp/test19.wav
-	./atest -B19200 -F0 -L55 -G59 /tmp/test19.wav
-	./atest -B19200 -F1 -L60 -G64 /tmp/test19.wav
-	rm /tmp/test19.wav
-
-check-modem2400 : gen_packets atest
-	./gen_packets -B2400 -n 100 -o /tmp/test24.wav
-	./atest -B2400 -F0 -L70 -G78 /tmp/test24.wav
-	./atest -B2400 -F1 -L80 -G87 /tmp/test24.wav
-	rm /tmp/test24.wav
-
-check-modem4800 : gen_packets atest
-	./gen_packets -B2400 -n 100 -o /tmp/test48.wav
-	./atest -B2400 -F0 -L70 -G79 /tmp/test48.wav
-	./atest -B2400 -F1 -L80 -G90 /tmp/test48.wav
-	rm /tmp/test48.wav
-
-
-# Unit test for inner digipeater algorithm
-
-.PHONY : dtest
-dtest : digipeater.c dedupe.c \
-		pfilter.o ax25_pad.o fcs_calc.o tq.o textcolor.o \
-		decode_aprs.o dwgpsnmea.o dwgps.o dwgpsd.o serial_port.o latlong.o telemetry.o symbols.o tt_text.o misc.a
-	$(CC) $(CFLAGS) -DDIGITEST -o $@ $^ $(LDFLAGS)
-	./dtest
-	rm dtest
-
-
-# Unit test for APRStt tone sequence parsing.
-
-.PHONY : ttest
-ttest : aprs_tt.c tt_text.c latlong.o textcolor.o misc.a geotranz.a misc.a
-	$(CC) $(CFLAGS) -DTT_MAIN  -o $@ $^ $(LDFLAGS)
-	./ttest
-	rm ttest
-
-
-# Unit test for APRStt tone sequence / text conversions.
-
-.PHONY: tttexttest
-tttexttest : tt_text.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DTTT_TEST -o $@ $^ $(LDFLAGS)
-	./tttexttest
-	rm tttexttest
-
-
-# Unit test for Packet Filtering.
-
-.PHONY: pftest
-pftest : pfilter.c ax25_pad.o textcolor.o fcs_calc.o decode_aprs.o dwgpsnmea.o dwgps.o dwgpsd.o serial_port.o latlong.o symbols.o telemetry.o tt_text.o misc.a 
-	$(CC) $(CFLAGS) -DPFTEST -o $@ $^ $(LDFLAGS)
-	./pftest
-	rm pftest
-
-# Unit test for telemetry decoding.
-
-.PHONY: tlmtest
-tlmtest : telemetry.c ax25_pad.o fcs_calc.o textcolor.o misc.a
-	$(CC) $(CFLAGS) -DTEST -o $@ $^ $(LDFLAGS)
-	./tlmtest
-	rm tlmtest
-
-# Unit test for location coordinate conversion.
-
-.PHONY: lltest
-lltest : latlong.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DLLTEST -o $@ $^ $(LDFLAGS)
-	./lltest
-	rm lltest
-
-# Unit test for encoding position & object report.
-
-.PHONY: enctest
-enctest : encode_aprs.c latlong.c textcolor.c misc.a
-	$(CC) $(CFLAGS) -DEN_MAIN -o $@ $^ $(LDFLAGS)
-	./enctest
-	rm enctest
-
-
-# Unit test for KISS encapsulation.
-
-.PHONY: kisstest
-kisstest : kiss_frame.c
-	$(CC) $(CFLAGS) -DKISSTEST -o $@ $^ $(LDFLAGS)
-	./kisstest
-	rm kisstest
-
-# Unit test for constructing frames besides UI.
-
-.PHONY: pad2test
-pad2test : ax25_pad2.c ax25_pad.c fcs_calc.o textcolor.o misc.a
-	$(CC) $(CFLAGS) -DPAD2TEST -o $@ $^ $(LDFLAGS)
-	./pad2test
-	rm pad2test
-
-
-# Unit Test for XID frame encode/decode.
-
-.PHONY: xidtest
-xidtest : xid.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DXIDTEST -o $@ $^  $(LDFLAGS)
-	./xidtest
-	rm xidtest
-
-
-
-#  -----------------------------  Manual tests and experiments  ---------------------------
-
-# These are not included in a normal build.  Might be broken.
-
-# Unit test for IGate
-
-itest : igate.c textcolor.c ax25_pad.c fcs_calc.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DITEST -o $@ $^
-	./itest
-
-# Unit test for UDP reception with AFSK demodulator.
-# Temporary during development.  Might not be useful anymore.
-
-udptest : udp_test.c demod.o dsp.o demod_afsk.o demod_psk.o demod_9600.o hdlc_rec.o hdlc_rec2.o multi_modem.o rrbb.o \
-		fcs_calc.o ax25_pad.o decode_aprs.o symbols.o textcolor.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)
-	./udptest
-
-# For demodulator tweaking experiments.
-# Dependencies of demod*.c, rather than .o, are intentional.
-
-demod.o      : tune.h
-
-demod_afsk.o : tune.h
-
-demod_9600.o : tune.h
-
-demod_psk.o  : tune.h
-
-tune.h :
-	echo " " > tune.h
-
-
-testagc : atest.c demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.c hdlc_rec.o hdlc_rec2.o multi_modem.o rrbb.o \
-		fcs_calc.o ax25_pad.o decode_aprs.o telemetry.o dtime_now.o latlong.o symbols.o tune.h textcolor.o misc.a
-	$(CC) $(CFLAGS) -o atest $^ $(LDFLAGS)
-	./atest 02_Track_2.wav | grep "packets decoded in" > atest.out
-
-
-testagc96 : atest.c fsk_fast_filter.h tune.h demod.c demod_afsk.c demod_psk.c demod_9600.c \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o \
-		dwgpsnmea.o dwgps.o dwgpsd.o serial_port.o latlong.o \
-		symbols.o tt_text.o textcolor.o telemetry.o dtime_now.o \
-		misc.a
-	rm -f atest96
-	$(CC) $(CFLAGS) -o atest96 $^ $(LDFLAGS)
-	./atest96 -B 9600 ../walkabout9600c.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 noisy96.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 19990303_0225_9600_8bis_22kHz.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600  19990303_0225_9600_16bit_22kHz.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 -P + z8-22k.wav| grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 test9600.wav | grep "packets decoded in" >atest.out
-	echo " " > tune.h
-
-
-
-
-# -------------------------------   Source distribution  ---------------------------------
-
-# probably obsolete and can be removed after move to github.
-
-
-
-.PHONY: dist-src
-dist-src : README.md CHANGES.md 
-		doc/User-Guide.pdf doc/Raspberry-Pi-APRS.pdf \
-		doc/Raspberry-Pi-APRS-Tracker.pdf doc/APRStt-Implementation-Notes.pdf \
-		dw-start.sh dwespeak.bat dwespeak.sh \
-		tocalls.txt symbols-new.txt symbolsX.txt direwolf.spec
-	rm -f fsk_fast_filter.h
-	echo " " > tune.h
-	rm -f ../$z-src.zip
-	(cd .. ; zip $z-src.zip \
-		$z/README.md \
-		$z/CHANGES.md \
-		$z/LICENSE* \
-		$z/doc/User-Guide.pdf \
-		$z/doc/Raspberry-Pi-APRS.pdf \
-		$z/doc/Raspberry-Pi-APRS-Tracker.pdf \
-		$z/doc/APRStt-Implementation-Notes.pdf \
-		$z/doc/APRS-Telemetry-Toolkit.pdf \
-		$z/Makefile* \
-		$z/*.c $z/*.h \
-		$z/regex/* $z/misc/* $z/geotranz/* \
-		$z/man1/* \
-		$z/generic.conf \
-		$z/tocalls.txt $z/symbols-new.txt $z/symbolsX.txt \
-		$z/dw-icon.png $z/dw-icon.rc $z/dw-icon.ico \
-		$z/dw-start.sh $z/direwolf.spec \
-		$z/dwespeak.bat $z/dwespeak.sh \
-		$z/telemetry-toolkit/* )
-		
-
-# -----------------------------------------------------------------------------------------
-
-
-.PHONY: clean
-clean :
-	rm -f $(APPS) gen_fff tune.h fsk_fast_filter.h *.o *.a direwolf.desktop
-
-
-depend : $(wildcard *.c)
-	makedepend -f $(lastword $(MAKEFILE_LIST)) -- $(CFLAGS) -- $^
-
-
-#
-# The following is updated by "make depend"
-#
-# DO NOT DELETE
-
-

Makefile.macosx

@@ -1,630 +0,0 @@
-#
-# Makefile for Macintosh 10.6+ version of Dire Wolf.
-#
-
-# TODO: This is a modified version of Makefile.linux and it
-# has fallen a little behind.  For example, it is missing the check target.
-# It would be more maintainable if we could use a single file for both.
-# The differences are not that great.
-# Maybe the most of the differences could go in to platform specific include
-# files rather than cluttering it up with too many if blocks.
-
-# Changes:
-#
-# 16 Dec 2015
-# 1. Added condition check for gps/gpsd code. Commented out due to 32/64 bit
-#    library issues. Macports gpsd build problem.
-# 2. SDK version checks are now performed by a bash script 'search_sdks.sh'.
-#    This should resolve the varied locations Apple stored the SDKs on the different
-#    Xcode/OS versions. Executing 'make' on the first pass asks the operator
-#    which SDK he/she wishes to use. Executing 'make clean' resets the SDK
-#    selection and operator intervention is once again required. Selected SDK
-#    information resides in a file named './use_this_sdk' in the current working
-#    directory.
-# 3. Removed fsk_fast_filter.h from atest receipe, clang compiler was having
-#    a hissy fit. Not check with GCC.
-
-APPS := direwolf decode_aprs text2tt tt2text ll2utm utm2ll aclients atest log2gpx gen_packets ttcalc
-
-all :  $(APPS) direwolf.desktop direwolf.conf	@echo " "
-	@echo "Next step install with: "
-	@echo " "
-	@echo "      sudo make install"
-	@echo " "
-	@echo " "
-
-SYS_LIBS :=
-SYS_MIN :=
-#SDK := $(shell find /Developer -maxdepth 1 -type d -name "SDKs")
-#$(info $$SDK = ${SDK})
-#ifeq (${SDK},/Developer/SDKs)
-#	SDK := $(shell find /Developer/SDKs -maxdepth 1 -type d -name "MacOSX10.8.sdk")
-#	ifeq (${SDK},/Developer/SDKs/MacOSX10.8.sdk)
-#		SYS_LIBS := -isystem /Developer/SDKs/MacOSX10.8.sdk
-#		SYS_MIN := -mmacosx-version-min=10.8
-#	else
-#		SDK := $(shell find /Developer/SDKs -maxdepth 1 -type d -name "MacOSX10.9.sdk")
-#		ifeq (${SDK},/Developer/SDKs/MacOSX10.9.sdk)
-#			SYS_LIBS := -isystem /Developer/SDKs/MacOSX10.9.sdk
-#			SYS_MIN := -mmacosx-version-min=10.9
-#		else
-#			SDK := $(shell find /Developer/SDKs -maxdepth 1 -type d -name "MacOSX10.10.sdk")
-#			ifeq (${SDK},/Developer/SDKs/MacOSX10.10.sdk)
-#				SYS_LIBS := -isystem /Developer/SDKs/MacOSX10.10.sdk
-#				SYS_MIN := -mmacosx-version-min=10.10
-#			endif
-#		endif
-#	endif
-#endif
-
-SYS_LIBS := $(shell ./search_sdks.sh)
-EXTRA_CFLAGS :=
-DARWIN_CC := $(shell which clang)
-ifeq (${DARWIN_CC},)
-DARWIN_CC := $(shell which gcc)
-EXTRA_CFLAGS :=
-else
-EXTRA_CFLAGS := -fvectorize -fslp-vectorize -fslp-vectorize-aggressive -pthread
-endif
-
-# Change as required in support of the available libraries
-
-#CC := $(DARWIN_CC) -m64 $(SYS_LIBS) $(SYS_MIN)
-CC := $(DARWIN_CC) -m32 $(SYS_LIBS) $(SYS_MIN)
-CFLAGS := -Os -pthread -Igeotranz $(EXTRA_CFLAGS)
-# $(info $$CC is [${CC}])
-
-#
-# The DSP filters spend a lot of time spinning around in little
-# loops multiplying and adding arrays of numbers.  The Intel "SSE"
-# instructions, introduced in 1999 with the Pentium III series,
-# can speed this up considerably.
-#
-# SSE2 instructions, added in 2000, don't seem to offer any advantage.
-#
-#
-# Let's take a look at the effect of the compile options.
-#
-#
-# Times are elapsed time to process Track 2 of the TNC test CD.
-#
-# i.e.   "./atest 02_Track_2.wav"
-# Default demodulator type is new "E" added for version 1.2.
-#
-
-#
-# ---------- x86 (32 bit) ----------
-#
-
-#
-# gcc 4.6.3 running on Ubuntu 12.04.05.
-# Intel(R) Celeron(R) CPU 2.53GHz.  Appears to have only 32 bit instructions.
-# Probably from around 2004 or 2005.
-#
-# When gcc is generating code for a 32 bit x86 target, it assumes the ancient
-# i386 processor.  This is good for portability but bad for performance.
-#
-# The code can run considerably faster by taking advantage of the SSE instructions
-# available in the Pentium 3 or later.
-#
-#       seconds options		comments
-#       ------  -------		--------
-#         524
-#         183	-O2
-#         182	-O3
-#         183	-O3 -ffast-math  	(should be same as -Ofast)
-#         184	-Ofast
-#         189	-O3 -ffast-math -march=pentium
-#         122	-O3 -ffast-math -msse
-#         122	-O3 -ffast-math -march=pentium -msse
-#         121	-O3 -ffast-math -march=pentium3   (this implies -msse)
-#         120	-O3 -ffast-math -march=native
-#
-# Note that "-march=native" is essentially the same as "-march=pentium3."
-#
-
-# If the compiler is generating code for the i386 target, we can
-# get much better results by telling it we have at least a Pentium 3.
-
-CFLAGS += -march=core2 -msse4.1 -std=gnu99
-#CFLAGS += -march=pentium3 -sse
-
-#
-# gcc 4.8.2 running on Ubuntu 14.04.1.
-# Intel Core 2 Duo from around 2007 or 2008.
-#
-# 64 bit target implies that we have SSE and probably even better vector instructions.
-#
-#       seconds options		comments
-#       ------  -------		--------
-#         245
-#          75	-01
-#          72 	-02
-#          71  	-03
-#          73  	-O3 -march=native
-#          42	-O3 -ffast-math
-#          42  	-Ofast			(note below)
-#          40	-O3 -ffast-math -march=native
-#
-#
-# Note that "-Ofast" is a newer option roughly equivalent to "-O3 -ffast-math".
-# I use the longer form because it is compatible with older compilers.
-#
-# Why don't I don't have "-march=native?"
-# Older compilers don't recognize "native" as one of the valid options.
-# One article said it was added with gcc 4.2 but I haven't verified that.
-#
-
-# Add -ffastmath in only if compiler version recognizes it.
-
-useffast := $(shell gcc --help -v 2>/dev/null | grep ffast-math)
-ifneq ($(useffast),)
-CFLAGS += -ffast-math
-endif
-
-#
-# You would expect "-march=native" to produce the fastest code.
-# Why don't I use it here?
-#
-#	1. In my benchmarks, above, it has a negligible impact if any at all.
-#	2. Some older versions of gcc don't recognize "native" as a valid choice.
-#	3. Results are less portable.  Not a consideration if you are
-#		building only for your own use but very important for anyone
-#		redistributing a "binary" version.
-#
-# If you are planning to distribute the binary version to other
-# people (in some ham radio software collection, RPM, or DEB package),
-# avoid # fine tuning it for your particular computer.  It could
-# cause compatibility issues for those with older computers.
-#
-
-#CFLAGS += -D_FORTIFY_SOURCE
-
-# Use PortAudio Library
-
-# Force static linking of portaudio if the static library is available.
-PA_LIB_STATIC := $(shell find /opt/local/lib -maxdepth 1 -type f -name "libportaudio.a")
-#$(info $$PA_LIB_STATIC is [${PA_LIB_STATIC}])
-ifeq (${PA_LIB_STATIC},)
-LDLIBS += -L/opt/local/lib -lportaudio
-else
-LDLIBS += /opt/local/lib/libportaudio.a
-endif
-
-# Include libraries portaudio requires.
-LDLIBS += -framework CoreAudio -framework AudioUnit -framework AudioToolbox
-LDLIBS += -framework Foundation -framework CoreServices
-
-CFLAGS += -DUSE_PORTAUDIO -I/opt/local/include
-
-# Uncomment following lines to enable GPS interface & tracker function.
-# Not available for MacOSX (as far as I know).
-# Although MacPorts has gpsd, wonder if it's the same thing. Add the check
-# just in case it works.
-# Well never mind, issue with Macports with 64bit libs ;-( leave the check in
-# until (if ever) Macports fixes the issue.
-
-#GPS_HEADER := $(shell find /opt/local/include -maxdepth 1 -type f -name "gps.h")
-#ifeq (${GPS_HEADER},)
-#GPS_OBJS :=
-#else
-#CFLAGS += -DENABLE_GPSD
-#LDLIBS += -L/opt/local/lib -lgps -lgpsd
-#GPS_OBJS := dwgps.o dwgpsnmea.o dwgpsd.o
-#endif
-
-# Name of current directory.
-# Used to generate zip file name for distribution.
-
-z := $(notdir ${CURDIR})
-
-
-# Main application.
-
-direwolf : direwolf.o aprs_tt.o audio_portaudio.o audio_stats.o ax25_link.o ax25_pad.o  ax25_pad2.o beacon.o \
-		config.o decode_aprs.o dedupe.o demod_9600.o demod_afsk.o demod_psk.o \
-		demod.o digipeater.o cdigipeater.o dlq.o dsp.o dtime_now.o dtmf.o dwgps.o \
-		encode_aprs.o encode_aprs.o fcs_calc.o fcs_calc.o gen_tone.o \
-		geotranz.a hdlc_rec.o hdlc_rec2.o hdlc_send.o igate.o kiss_frame.o \
-		kiss.o kissnet.o latlong.o latlong.o log.o morse.o multi_modem.o \
-		waypoint.o serial_port.o pfilter.o ptt.o rdq.o recv.o rrbb.o server.o \
-		symbols.o telemetry.o textcolor.o tq.o tt_text.o tt_user.o xid.o xmit.o \
-		dwgps.o dwgpsnmea.o mheard.o
-	$(CC) $(CFLAGS) -o $@ $^ -lpthread $(LDLIBS) -lm
-
-
-# Optimization for slow processors.
-
-demod.o      : fsk_fast_filter.h
-
-demod_afsk.o : fsk_fast_filter.h
-
-
-fsk_fast_filter.h : gen_fff
-	./gen_fff > fsk_fast_filter.h
-
-gen_fff : demod_afsk.c dsp.c textcolor.c
-	echo " " > tune.h
-	$(CC) $(CFLAGS) -DGEN_FFF -o $@ $^ $(LDFLAGS)
-
-
-
-# UTM, USNG, MGRS conversions.
-
-geotranz.a : error_string.o  mgrs.o  polarst.o  tranmerc.o  ups.o  usng.o  utm.o
-	ar -cr $@ $^
-
-error_string.o : geotranz/error_string.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-mgrs.o : geotranz/mgrs.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-polarst.o : geotranz/polarst.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-tranmerc.o : geotranz/tranmerc.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-ups.o : geotranz/ups.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-usng.o : geotranz/usng.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-utm.o : geotranz/utm.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-
-
-# Generate apprpriate sample configuration file for this platform.
-
-direwolf.conf : generic.conf
-	egrep '^C|^M' generic.conf | cut -c2-999 > direwolf.conf
-
-
-# Where should we install it?
-
-# My understanding, of the convention, is that something you compile
-# from source, that is not a standard part of the operating system,
-# should go in /usr/local/bin.
-
-# This is a step in the right direction but not sufficient to use /usr instead.
-
-INSTALLDIR := /usr/local
-
-# TODO:  Test this better.
-
-# Optional installation into /usr/local/...
-# Needs to be run as root or with sudo.
-# TODO: Review file locations.
-
-# Command to "install" to system directories.  "install" for Linux.  "ginstall" for Mac.
-
-INSTALL=ginstall
-
-.PHONY: install
-install : $(APPS) direwolf.conf tocalls.txt symbols-new.txt symbolsX.txt dw-icon.png direwolf.desktop
-#
-# Applications, not installed with package manager, normally go in /usr/local/bin.
-# /usr/bin is used instead when installing from .DEB or .RPM package.
-#
-	$(INSTALL) direwolf $(INSTALLDIR)/bin
-	$(INSTALL) decode_aprs $(INSTALLDIR)/bin
-	$(INSTALL) text2tt $(INSTALLDIR)/bin
-	$(INSTALL) tt2text $(INSTALLDIR)/bin
-	$(INSTALL) ll2utm $(INSTALLDIR)/bin
-	$(INSTALL) utm2ll $(INSTALLDIR)/bin
-	$(INSTALL) aclients $(INSTALLDIR)/bin
-	$(INSTALL) log2gpx $(INSTALLDIR)/bin
-	$(INSTALL) gen_packets $(INSTALLDIR)/bin
-	$(INSTALL) atest $(INSTALLDIR)/bin
-	$(INSTALL) ttcalc $(INSTALLDIR)/bin
-	$(INSTALL) dwespeak.sh $(INSTALLDIR)/bin
-#
-# Telemetry Toolkit executables.   Other .conf and .txt files will go into doc directory.
-#
-	$(INSTALL) telemetry-toolkit/telem-balloon.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-bits.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-data.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-data91.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-eqns.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-parm.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-unit.pl $(INSTALLDIR)/bin
-	$(INSTALL) telemetry-toolkit/telem-volts.py $(INSTALLDIR)/bin
-#
-# Misc. data such as "tocall" to system mapping.
-#
-	$(INSTALL) -D --mode=644 tocalls.txt /usr/share/direwolf/tocalls.txt
-	$(INSTALL) -D --mode=644 symbols-new.txt /usr/share/direwolf/symbols-new.txt
-	$(INSTALL) -D --mode=644 symbolsX.txt /usr/share/direwolf/symbolsX.txt
-	$(INSTALL) -D --mode=644 dw-icon.png /usr/share/direwolf/dw-icon.png
-	$(INSTALL) -D --mode=644 direwolf.desktop /usr/share/applications/direwolf.desktop
-#
-# Documentation.  Various plain text files and PDF.
-#
-	$(INSTALL) -D --mode=644 README.md $(INSTALLDIR)/share/doc/direwolf/README.md
-	$(INSTALL) -D --mode=644 CHANGES.md $(INSTALLDIR)/share/doc/direwolf/CHANGES.md
-	$(INSTALL) -D --mode=644 LICENSE-dire-wolf.txt $(INSTALLDIR)/share/doc/direwolf/LICENSE-dire-wolf.txt
-	$(INSTALL) -D --mode=644 LICENSE-other.txt $(INSTALLDIR)/share/doc/direwolf/LICENSE-other.txt
-#
-	$(INSTALL) -D --mode=644 doc/User-Guide.pdf $(INSTALLDIR)/share/doc/direwolf/User-Guide.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-APRS.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-APRS-Tracker.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS-Tracker.pdf
-	$(INSTALL) -D --mode=644 doc/Raspberry-Pi-SDR-IGate.pdf $(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-SDR-IGate.pdf
-	$(INSTALL) -D --mode=644 doc/APRStt-Implementation-Notes.pdf $(INSTALLDIR)/share/doc/direwolf/APRStt-Implementation-Notes.pdf
-	$(INSTALL) -D --mode=644 doc/APRStt-interface-for-SARTrack.pdf $(INSTALLDIR)/share/doc/direwolf/APRStt-interface-for-SARTrack.pdf
-	$(INSTALL) -D --mode=644 doc/APRS-Telemetry-Toolkit.pdf $(INSTALLDIR)/share/doc/direwolf/APRS-Telemetry-Toolkit.pdf
-	$(INSTALL) -D --mode=644 doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf $(INSTALLDIR)/share/doc/direwolf/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf
-	$(INSTALL) -D --mode=644 doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf $(INSTALLDIR)/share/doc/direwolf/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf
-#
-# Sample config files also go into the doc directory.
-# When building from source, these can be put in home directory with "make install-conf".
-# When installed from .DEB or .RPM package, the user will need to copy these to
-# the home directory or other desired location.
-# Someone suggested that these could go into an "examples" subdirectory under doc.
-#
-	$(INSTALL) -D --mode=644 direwolf.conf $(INSTALLDIR)/share/doc/direwolf/direwolf.conf
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-m0xer-3.txt $(INSTALLDIR)/share/doc/direwolf/telem-m0xer-3.txt
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-balloon.conf $(INSTALLDIR)/share/doc/direwolf/telem-balloon.conf
-	$(INSTALL) -D --mode=644 telemetry-toolkit/telem-volts.conf $(INSTALLDIR)/share/doc/direwolf/telem-volts.conf
-#
-# "man" pages
-#
-	$(INSTALL) -D --mode=644 man1/aclients.1 $(INSTALLDIR)/man/man1/aclients.1
-	$(INSTALL) -D --mode=644 man1/atest.1 $(INSTALLDIR)/man/man1/atest.1
-	$(INSTALL) -D --mode=644 man1/decode_aprs.1 $(INSTALLDIR)/man/man1/decode_aprs.1
-	$(INSTALL) -D --mode=644 man1/direwolf.1 $(INSTALLDIR)/man/man1/direwolf.1
-	$(INSTALL) -D --mode=644 man1/gen_packets.1 $(INSTALLDIR)/man/man1/gen_packets.1
-	$(INSTALL) -D --mode=644 man1/ll2utm.1 $(INSTALLDIR)/man/man1/ll2utm.1
-	$(INSTALL) -D --mode=644 man1/log2gpx.1 $(INSTALLDIR)/man/man1/log2gpx.1
-	$(INSTALL) -D --mode=644 man1/text2tt.1 $(INSTALLDIR)/man/man1/text2tt.1
-	$(INSTALL) -D --mode=644 man1/tt2text.1 $(INSTALLDIR)/man/man1/tt2text.1
-	$(INSTALL) -D --mode=644 man1/utm2ll.1 $(INSTALLDIR)/man/man1/utm2ll.1
-#
-	@echo " "
-	@echo "If this is your first install, not an upgrade, type this to put a copy"
-	@echo "of the sample configuration file (direwolf.conf) in your home directory:"
-	@echo " "
-	@echo "        make install-conf"
-	@echo " "
-
-
-# TODO:  Should we put the sample direwolf.conf file somewhere like
-# /usr/share/doc/direwolf/examples and add that to the
-# end of the search path list?
-# That would make it easy to see user customizations compared to the
-# latest sample.
-
-# These would be done as ordinary user.
-
-
-.PHONY: install-conf
-install-conf : direwolf.conf
-	cp direwolf.conf ~
-	cp telemetry-toolkit/telem-m0xer-3.txt ~
-	cp telemetry-toolkit/telem-*.conf ~
-
-
-# Separate application to decode raw data.
-
-decode_aprs : decode_aprs.c dwgpsnmea.o dwgps.o dwgpsd.o serial_port.o symbols.o ax25_pad.o textcolor.o fcs_calc.o latlong.o log.o telemetry.o tt_text.o
-	$(CC) $(CFLAGS) -DDECAMAIN -o $@ $^ -lm
-
-# Convert between text and touch tone representation.
-
-text2tt : tt_text.c
-	$(CC) $(CFLAGS) -DENC_MAIN -o $@ $^
-
-tt2text : tt_text.c
-	$(CC) $(CFLAGS) -DDEC_MAIN -o $@ $^
-
-
-# Convert between Latitude/Longitude and UTM coordinates.
-
-ll2utm : ll2utm.c geotranz.a
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-
-utm2ll : utm2ll.c geotranz.a
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-
-
-# Convert from log file to GPX.
-
-log2gpx : log2gpx.c
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-
-
-# Test application to generate sound.
-
-gen_packets : gen_packets.c ax25_pad.c hdlc_send.c fcs_calc.c gen_tone.c morse.c textcolor.c dsp.c
-	$(CC) $(CFLAGS) -o $@ $^ $(LDLIBS) -lm
-
-demod.o      : tune.h
-
-demod_afsk.o : tune.h
-
-demod_9600.o : tune.h
-
-demod_psk.o  : tune.h
-
-tune.h :
-	echo " " > tune.h
-
-
-testagc : atest.c demod.c dsp.c demod_afsk.c demod_9600.c hdlc_rec.c hdlc_rec2.o multi_modem.o rrbb.o \
-        fcs_calc.c ax25_pad.c decode_aprs.c telemetry.c dtime_now.o latlong.c symbols.c tune.h textcolor.c
-	$(CC) $(CFLAGS) -o atest $^ -lm
-	./atest 02_Track_2.wav | grep "packets decoded in" > atest.out
-
-
-# Unit test for demodulators
-
-atest : atest.c demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.c hdlc_rec.c hdlc_rec2.o multi_modem.o rrbb.o \
-        fcs_calc.c ax25_pad.c decode_aprs.c dwgpsnmea.o dwgps.o serial_port.o telemetry.c dtest_now.o latlong.c symbols.c textcolor.c tt_text.c
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-#atest : atest.c fsk_fast_filter.h demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.c hdlc_rec.c hdlc_rec2.o multi_modem.o rrbb.o \
-#        fcs_calc.c ax25_pad.c decode_aprs.c dwgpsnmea.o dwgps.o serial_port.o telemetry.c latlong.c symbols.c textcolor.c tt_text.c
-#	$(CC) $(CFLAGS) -o $@ $^ -lm
-
-# Unit test for inner digipeater algorithm
-
-
-dtest : digipeater.c pfilter.o ax25_pad.o dedupe.o fcs_calc.o tq.o textcolor.o \
-		decode_aprs.o dwgpsnmea.o dwgps.o serial_port.o latlong.o telemetry.o symbols.o tt_text.o
-	$(CC) $(CFLAGS) -DTEST -o $@ $^
-	./dtest
-
-
-# Unit test for APRStt.
-
-ttest : aprs_tt.c tt_text.c  latlong.c geotranz.a
-	$(CC) $(CFLAGS) -DTT_MAIN  -o $@ $^
-
-
-# Unit test for IGate
-
-
-itest : igate.c textcolor.c ax25_pad.c fcs_calc.c
-	$(CC) $(CFLAGS) -DITEST -o $@ $^
-	./itest
-
-
-# Unit test for UDP reception with AFSK demodulator
-
-udptest : udp_test.c demod.c dsp.c demod_afsk.c demod_9600.c hdlc_rec.c hdlc_rec2.c multi_modem.c rrbb.c fcs_calc.c ax25_pad.c decode_aprs.c symbols.c textcolor.c
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-	./udptest
-
-
-# Unit test for telemetry decoding.
-
-
-tlmtest : telemetry.c ax25_pad.c fcs_calc.c textcolor.c
-	$(CC) $(CFLAGS) -o $@ $^ -lm
-	./tlmtest
-
-
-# Multiple AGWPE network or serial port clients to test TNCs side by side.
-
-aclients : aclients.c ax25_pad.c fcs_calc.c textcolor.c
-	$(CC) $(CFLAGS) -g -o $@ $^
-
-
-# Touch Tone to Speech sample application.
-
-ttcalc : ttcalc.o ax25_pad.o fcs_calc.o textcolor.o
-	$(CC) $(CFLAGS) -g -o $@ $^
-
-
-depend : $(wildcard *.c)
-	makedepend -f $(lastword $(MAKEFILE_LIST)) -- $(CFLAGS) -- $^
-
-
-.PHONY: clean
-clean :
-	rm -f $(APPS) gen_fff \
-		fsk_fast_filter.h *.o *.a use_this_sdk
-	echo " " > tune.h
-
-
-.PHONY: dist-mac
-dist-mac: direwolf decode_aprs text2tt tt2text ll2utm utm2ll aclients log2gpx gen_packets \
-		tocalls.txt symbols-new.txt symbolsX.txt dw-icon.png
-	rm -f ../direwolf_dist_bin.zip
-	(cd .. ; zip direwolf_dist_bin.zip \
-	$(INSTALLDIR)/bin/direwolf \
-	$(INSTALLDIR)/bin/decode_aprs \
-	$(INSTALLDIR)/bin/text2tt \
-	$(INSTALLDIR)/bin/tt2text \
-	$(INSTALLDIR)/bin/ll2utm \
-	$(INSTALLDIR)/bin/utm2ll \
-	$(INSTALLDIR)/bin/aclients \
-	$(INSTALLDIR)/bin/log2gpx \
-	$(INSTALLDIR)/bin/gen_packets \
-	$(INSTALLDIR)/bin/atest \
-	$(INSTALLDIR)/bin/ttcalc \
-	$(INSTALLDIR)/bin/dwespeak.sh \
-	$(INSTALLDIR)/share/direwolf/tocalls.txt \
-	$(INSTALLDIR)/share/direwolf/config/direwolf.conf \
-	$(INSTALLDIR)/share/direwolf/symbols-new.txt \
-	$(INSTALLDIR)/share/direwolf/symbolsX.txt \
-	$(INSTALLDIR)/share/direwolf/dw-icon.png \
-	$(INSTALLDIR)/share/doc/direwolf/README.md \
-	$(INSTALLDIR)/share/doc/direwolf/CHANGES.md \
-	$(INSTALLDIR)/share/doc/direwolf/LICENSE-dire-wolf.txt \
-	$(INSTALLDIR)/share/doc/direwolf/LICENSE-other.txt \
-	$(INSTALLDIR)/share/doc/direwolf/User-Guide.pdf \
-	$(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS.pdf \
-	$(INSTALLDIR)/share/doc/direwolf/Raspberry-Pi-APRS-Tracker.pdf \
-	$(INSTALLDIR)/share/doc/direwolf/APRStt-Implementation-Notes.pdf \
-	$(INSTALLDIR)/share/doc/direwolf/APRS-Telemetry-Toolkit.pdf \
-	$(INSTALLDIR)/man/man1/aclients.1 \
-	$(INSTALLDIR)/man/man1/atest.1 \
-	$(INSTALLDIR)/man/man1/decode_aprs.1 \
-	$(INSTALLDIR)/man/man1/direwolf.1 \
-	$(INSTALLDIR)/man/man1/gen_packets.1 \
-	$(INSTALLDIR)/man/man1/ll2utm.1 \
-	$(INSTALLDIR)/man/man1/log2gpx.1 \
-	$(INSTALLDIR)/man/man1/text2tt.1 \
-	$(INSTALLDIR)/man/man1/tt2text.1 \
-	$(INSTALLDIR)/man/man1/utm2ll.1 \
-	)
-
-# Package it up for distribution.
-
-.PHONY: dist-src
-dist-src : README.md CHANGES.md \
-		doc/User-Guide.pdf doc/Raspberry-Pi-APRS.pdf \
-		doc/Raspberry-Pi-APRS-Tracker.pdf doc/APRStt-Implementation-Notes.pdf \
-		dw-start.sh dwespeak.bat dwespeak.sh \
-		tocalls.txt symbols-new.txt symbolsX.txt direwolf.spec
-	rm -f fsk_fast_filter.h
-	echo " " > tune.h
-	rm -f ../$z-src.zip
-	(cd .. ; zip $z-src.zip \
-		$z/README.md \
-		$z/CHANGES.md \
-		$z/LICENSE* \
-		$z/doc/User-Guide.pdf \
-		$z/doc/Raspberry-Pi-APRS.pdf \
-		$z/doc/Raspberry-Pi-APRS-Tracker.pdf \
-		$z/doc/APRStt-Implementation-Notes.pdf \
-		$z/Makefile* \
-		$z/*.c $z/*.h \
-		$z/regex/* $z/misc/* $z/geotranz/* \
-		$z/man1/* \
-		$z/generic.conf \
-		$z/tocalls.txt $z/symbols-new.txt $z/symbolsX.txt \
-		$z/dw-icon.png $z/dw-icon.rc $z/dw-icon.ico \
-		$z/dw-start.sh $z/direwolf.spec \
-		$z/dwespeak.bat $z/dwespeak.sh \
-		$z/telemetry-toolkit/* )
-
-
-#
-# The destination field is often used to identify the manufacturer/model.
-# These are not hardcoded into Dire Wolf.  Instead they are read from
-# a file called tocalls.txt at application start up time.
-#
-# The original permanent symbols are built in but the "new" symbols,
-# using overlays, are often updated.  These are also read from files.
-#
-# You can obtain an updated copy by typing "make tocalls-symbols".
-# This is not part of the normal build process.  You have to do this explicitly.
-#
-# The locations below appear to be the most recent.
-# The copy at http://www.aprs.org/tocalls.txt is out of date.
-#
-
-.PHONY: tocalls-symbols
-tocalls-symbols :
-	cp tocalls.txt tocalls.txt~
-	wget http://www.aprs.org/aprs11/tocalls.txt -O tocalls.txt
-	-diff -Z tocalls.txt~ tocalls.txt
-	cp symbols-new.txt symbols-new.txt~
-	wget http://www.aprs.org/symbols/symbols-new.txt -O symbols-new.txt
-	-diff -Z symbols-new.txt~ symbols-new.txt
-	cp symbolsX.txt symbolsX.txt~
-	wget http://www.aprs.org/symbols/symbolsX.txt -O symbolsX.txt
-	-diff -Z symbolsX.txt~ symbolsX.txt

Makefile.win

@@ -1,637 +0,0 @@
-#
-# Makefile for native Windows version of Dire Wolf.
-#
-#
-# This is built in the Cygwin environment but with the 
-# compiler from http://www.mingw.org/ so there is no
-# dependency on extra DLLs.
-#
-# The MinGW/bin directory must be in the PATH for the 
-# compiler.  e.g.   export PATH=/cygdrive/c/MinGW/bin:$PATH
-#
-# Failure to have the path set correctly will result in the
-# obscure message:     Makefile.win:... recipe for target ... failed. 
-#
-# Type "which gcc" to make sure you are getting the right one!
-#
-
-
-all : direwolf decode_aprs text2tt tt2text ll2utm utm2ll aclients log2gpx gen_packets atest ttcalc tnctest
-
-
-# People say we need -mthreads option for threads to work properly.
-# They also say it creates a dependency on mingwm10.dll but I'm not seeing that.
-# Maybe that is for pthreads.  We are using the Windows threads.
-
-# -Ofast was added in gcc 4.6 which was the MinGW version back in 2012.
-
-CC := gcc
-CFLAGS :=    -Wall -Ofast -march=pentium3 -msse -Iregex -Iutm -Igeotranz -mthreads -DUSE_REGEX_STATIC
-#CFLAGS :=   -Wall        -march=pentium3 -msse -Iregex -Iutm -Igeotranz -mthreads -DUSE_REGEX_STATIC
-AR := ar
-
-CFLAGS += -g
-
-# For version 1.4, we upgrade from 4.6.2 to 4.9.3.
-
-# gcc 4.8 adds these.  Try them just for fun.
-# No, it needs libasan which is not on Windows.
-#CFLAGS += -fsanitize=address -fno-omit-frame-pointer
-
-
-
-#
-# Let's see impact of various optimization levels.
-# Benchmark results with MinGW gcc version 4.6.2.
-#
-#	seconds	options, comments
-#	------	-----------------
-#	119.8	-O2	Used for version 0.8
-#	 92.1	-O3
-#	 88.7	-Ofast  (should be same as -O3 -ffastmath)
-#	 87.5	-Ofast -march=pentium
-#	 74.1	-Ofast -msse
-#	 72.2	-Ofast -march=pentium -msse
-#	 62.0	-Ofast -march=pentium3   (this implies -msse)
-#	 61.9	-Ofast -march=pentium3 -msse
-#
-# A minimum of Windows XP is required due to some of the system
-# features being used.  XP requires a Pentium processor or later.
-# The DSP filters can be sped up considerably with the SSE instructions.
-# The SSE instructions were introduced in 1999 with the 
-# Pentium III series.  
-# SSE2 instructions, added in 2000, don't seem to offer any advantage.
-#
-# For version 0.9, a Pentium 3 or equivalent is now the minimum required
-# for the prebuilt Windows distribution.
-# If you insist on using a computer from the previous century,
-# you can compile this yourself with different options.
-#
-
-
-
-
-# --------------------------------------  Main application   --------------------------------
-
-# Not sure why this is here.
-
-demod.o      : fsk_demod_state.h
-
-demod_9600.o : fsk_demod_state.h
-
-demod_afsk.o : fsk_demod_state.h
-
-demod_psk.o  : fsk_demod_state.h
-
-
-direwolf : direwolf.o config.o recv.o demod.o dsp.o demod_afsk.o demod_psk.o demod_9600.o hdlc_rec.o \
-		hdlc_rec2.o multi_modem.o rdq.o rrbb.o dlq.o \
-		fcs_calc.o ax25_pad.o ax25_pad2.o xid.o \
-		decode_aprs.o symbols.o server.o kiss.o kissnet.o kiss_frame.o hdlc_send.o fcs_calc.o \
-		gen_tone.o morse.o audio_win.o audio_stats.o digipeater.o cdigipeater.o pfilter.o dedupe.o tq.o xmit.o \
-		ptt.o beacon.o dwgps.o encode_aprs.o latlong.o textcolor.o \
-		dtmf.o aprs_tt.o tt_user.o tt_text.o igate.o waypoint.o serial_port.o log.o telemetry.o \
-		dwgps.o dwgpsnmea.o dtime_now.o mheard.o ax25_link.o \
-		dw-icon.o regex.a misc.a geotranz.a
-	$(CC) $(CFLAGS) -o $@ $^ -lwinmm -lws2_32
-
-dw-icon.o : dw-icon.rc dw-icon.ico
-	windres dw-icon.rc -o $@
-
-
-# Optimization for slow processors.
-
-demod.o : fsk_fast_filter.h
-
-demod_afsk.o : fsk_fast_filter.h
-
-
-fsk_fast_filter.h : gen_fff
-	./gen_fff > fsk_fast_filter.h
-
-gen_fff : demod_afsk.c dsp.c textcolor.c
-	echo " " > tune.h
-	$(CC) $(CFLAGS) -DGEN_FFF -o $@ $^
-
-
-#
-# The destination field is often used to identify the manufacturer/model.
-# These are not hardcoded into Dire Wolf.  Instead they are read from
-# a file called tocalls.txt at application start up time.
-#
-# The original permanent symbols are built in but the "new" symbols,
-# using overlays, are often updated.  These are also read from files.
-#
-# You can obtain an updated copy by typing "make tocalls-symbols".
-# This is not part of the normal build process.  You have to do this explicitly.
-#
-# The locations below appear to be the most recent.
-# The copy at http://www.aprs.org/tocalls.txt is out of date.
-#
-
-.PHONY: tocalls-symbols
-tocalls-symbols :
-	cp tocalls.txt tocalls.txt~
-	wget http://www.aprs.org/aprs11/tocalls.txt -O tocalls.txt
-	-diff tocalls.txt~ tocalls.txt
-	cp symbols-new.txt symbols-new.txt~
-	wget http://www.aprs.org/symbols/symbols-new.txt -O symbols-new.txt
-	-diff symbols-new.txt~ symbols-new.txt
-	cp symbolsX.txt symbolsX.txt~
-	wget http://www.aprs.org/symbols/symbolsX.txt -O symbolsX.txt
-	-diff symbolsX.txt~ symbolsX.txt
-
-
-
-# ----------------------------  Other utilities included with distribution  -------------------------
-
-
-# Separate application to decode raw data.
-
-decode_aprs : decode_aprs.c dwgpsnmea.o dwgps.o serial_port.o symbols.o ax25_pad.o textcolor.o fcs_calc.o latlong.o log.o telemetry.o tt_text.c regex.a misc.a geotranz.a
-	$(CC) $(CFLAGS) -DDECAMAIN -o decode_aprs $^
-
-
-# Convert between text and touch tone representation.
-
-text2tt : tt_text.c misc.a
-	$(CC) $(CFLAGS) -DENC_MAIN -o $@ $^
-
-tt2text : tt_text.c misc.a
-	$(CC) $(CFLAGS) -DDEC_MAIN -o $@ $^
-
-
-# Convert between Latitude/Longitude and UTM coordinates.
-
-ll2utm : ll2utm.c textcolor.c geotranz.a misc.a
-	$(CC) $(CFLAGS) -o $@ $^
-
-utm2ll : utm2ll.c textcolor.c geotranz.a misc.a
-	$(CC) $(CFLAGS) -o $@ $^
-
-
-# Convert from log file to GPX.
-
-log2gpx : log2gpx.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^
-
-
-# Test application to generate sound.
-
-gen_packets : gen_packets.o  ax25_pad.o hdlc_send.o fcs_calc.o gen_tone.o morse.o textcolor.o dsp.o misc.a regex.a
-	$(CC) $(CFLAGS) -o $@ $^
-
-
-
-# -------------------------------------------  Libraries  --------------------------------------------
-
-
-
-# UTM, USNG, MGRS conversions.
-
-geotranz.a : error_string.o  mgrs.o  polarst.o  tranmerc.o  ups.o  usng.o  utm.o
-	ar -cr $@ $^
-
-error_string.o : geotranz/error_string.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-mgrs.o : geotranz/mgrs.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-polarst.o : geotranz/polarst.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-tranmerc.o : geotranz/tranmerc.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-ups.o : geotranz/ups.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-usng.o : geotranz/usng.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-utm.o : geotranz/utm.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-
-#
-# When building for Linux, we use regular expression
-# functions supplied by the gnu C library.
-# For the native WIN32 version, we need to use our own copy.
-# These were copied from http://gnuwin32.sourceforge.net/packages/regex.htm
-#
-
-regex.a : regex.o
-	ar -cr $@ $^	
- 
-regex.o : regex/regex.c
-	$(CC) $(CFLAGS) -Dbool=int -Dtrue=1 -Dfalse=0 -c -o $@ $^
-
-
-# There are several string functios found in Linux
-# but not on Windows.  Need to provide our own copy.
-
-misc.a : strsep.o strtok_r.o strcasestr.o strlcpy.o strlcat.o
-	ar -cr $@ $^	
- 
-strsep.o : misc/strsep.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-strtok_r.o : misc/strtok_r.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-strcasestr.o : misc/strcasestr.c
-	$(CC) $(CFLAGS) -c -o $@ $^
-
-strlcpy.o : misc/strlcpy.c
-	$(CC) $(CFLAGS) -I. -c -o $@ $^
-
-strlcat.o : misc/strlcat.c
-	$(CC) $(CFLAGS) -I. -c -o $@ $^
-
-
-# ---------------------------------  Automated Smoke Test  --------------------------------
-
-
-# Combine some unit tests into a single regression sanity check.
-
-
-check : dtest ttest tttexttest pftest tlmtest lltest enctest kisstest pad2test xidtest check-modem1200 check-modem300 check-modem9600 check-modem19200 check-modem2400 check-modem4800
-
-# Can we encode and decode at popular data rates?
-# Verify that single bit fixup increases the count.
-
-check-modem1200 : gen_packets atest
-	gen_packets -n 100 -o test12.wav
-	atest -F0 -PE -L64 -G72 test12.wav
-	atest -F1 -PE -L70 -G75 test12.wav
-	rm test12.wav
-
-check-modem300 : gen_packets atest
-	gen_packets -B300 -n 100 -o test3.wav
-	atest -B300 -F0 -L68 -G69 test3.wav
-	atest -B300 -F1 -L71 -G75 test3.wav
-	rm test3.wav
-
-check-modem9600 : gen_packets atest
-	gen_packets -B9600 -n 100 -o test96.wav
-	sleep 1
-	atest -B9600 -F0 -L50 -G54 test96.wav
-	atest -B9600 -F1 -L55 -G59 test96.wav
-	sleep 1
-	rm test96.wav
-
-check-modem19200 : gen_packets atest
-	gen_packets -r 96000 -B19200 -n 100 -o test19.wav
-	sleep 1
-	atest -B19200 -F0 -L55 -G59 test19.wav
-	atest -B19200 -F1 -L60 -G64 test19.wav
-	sleep 1
-	rm test19.wav
-
-check-modem2400 : gen_packets atest
-	gen_packets -B2400 -n 100 -o test24.wav
-	sleep 1
-	atest -B2400 -F0 -L70 -G78 test24.wav
-	atest -B2400 -F1 -L80 -G87 test24.wav
-	sleep 1
-	rm test24.wav
-
-check-modem4800 : gen_packets atest
-	gen_packets -B4800 -n 100 -o test48.wav
-	sleep 1
-	atest -B4800 -F0 -L70 -G74 test48.wav
-	atest -B4800 -F1 -L79 -G84 test48.wav
-	sleep 1
-	rm test48.wav
-
-
-# Unit test for demodulators
-
-atest : atest.c fsk_fast_filter.h demod.c demod_afsk.c demod_psk.c demod_9600.c \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o \
-		dwgpsnmea.o dwgps.o serial_port.o latlong.c \
-		symbols.c tt_text.c textcolor.c telemetry.c dtime_now.o \
-		decode_aprs.o log.o \
-		misc.a regex.a
-	echo " " > tune.h
-	$(CC) $(CFLAGS) -o $@ $^
-	#./atest ..\\direwolf-0.2\\02_Track_2.wav
-	#atest -B 9600 z9.wav
-	#atest za100.wav
-
-atest9 : atest.c demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.c hdlc_rec.c hdlc_rec2.c multi_modem.c \
-		rrbb.c fcs_calc.c ax25_pad.c decode_aprs.c latlong.c symbols.c textcolor.c telemetry.c dtime_now.o misc.a regex.a \
-		fsk_fast_filter.h
-	echo " " > tune.h
-	$(CC) $(CFLAGS) -o $@ $^
-	./atest9 -B 9600 ../walkabout9600.wav | grep "packets decoded in" >atest.out
-	#./atest9 -B 9600 noise96.wav
-
-
-# Unit test for inner digipeater algorithm
-
-.PHONY: dtest
-dtest : digipeater.c dedupe.c \
-		pfilter.o ax25_pad.o fcs_calc.o tq.o textcolor.o \
-		decode_aprs.o dwgpsnmea.o dwgps.o serial_port.o latlong.o telemetry.o symbols.o tt_text.o misc.a regex.a
-	$(CC) $(CFLAGS) -DDIGITEST -o $@ $^
-	./dtest
-	rm dtest.exe
-
-# Unit test for APRStt tone seqence parsing.
-
-.PHONTY: ttest
-ttest : aprs_tt.c tt_text.c latlong.o textcolor.o geotranz.a misc.a
-	$(CC) $(CFLAGS) -Igeotranz -DTT_MAIN  -o $@ $^
-	./ttest
-	rm ttest.exe
-
-# Unit test for APRStt tone sequence / text conversions.
-
-.PHONY: tttexttest
-tttexttest : tt_text.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DTTT_TEST -o $@ $^
-	./tttexttest
-	rm tttexttest.exe
-
-# Unit test for Packet Filtering.
-
-.PHONY: pftest
-pftest : pfilter.c ax25_pad.o textcolor.o fcs_calc.o decode_aprs.o dwgpsnmea.o dwgps.o serial_port.o latlong.o symbols.o telemetry.o tt_text.o misc.a regex.a
-	$(CC) $(CFLAGS) -DPFTEST -o $@ $^
-	./pftest
-	rm pftest.exe
-
-
-
-# Unit test for telemetry decoding.
-
-.PHONY: tlmtest
-tlmtest : telemetry.c ax25_pad.o fcs_calc.o textcolor.o misc.a regex.a
-	$(CC) $(CFLAGS) -DTEST -o $@ $^
-	./tlmtest
-	rm tlmtest.exe
-
-
-# Unit test for location coordinate conversion.
-
-.PHONY: lltest
-lltest : latlong.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DLLTEST -o $@ $^
-	./lltest
-	rm lltest.exe
-
-# Unit test for encoding position & object report.
-
-.PHONY: enctest
-enctest : encode_aprs.c latlong.c textcolor.c misc.a
-	$(CC) $(CFLAGS) -DEN_MAIN -o $@ $^
-	./enctest
-	rm enctest.exe
-
-
-# Unit test for KISS encapsulation.
-
-.PHONY: kisstest
-kisstest : kiss_frame.c
-	$(CC) $(CFLAGS) -DKISSTEST -o $@ $^
-	./kisstest
-	rm kisstest.exe
-
-
-# Unit test for constructing frames besides UI.
-
-.PHONY: pad2test
-pad2test : ax25_pad2.c ax25_pad.c fcs_calc.o textcolor.o regex.a misc.a
-	$(CC) $(CFLAGS) -DPAD2TEST -o $@ $^
-	./pad2test
-	rm pad2test.exe
-
-# Unit Test for XID frame encode/decode.
-
-.PHONY: xidtest
-xidtest : xid.c textcolor.o misc.a
-	$(CC) $(CFLAGS) -DXIDTEST -o $@ $^
-	./xidtest
-	rm xidtest.exe
-
-
-
-# ------------------------------ Other manual testing & experimenting  -------------------------------
-
-
-tnctest : tnctest.c textcolor.o dtime_now.o serial_port.o misc.a
-	$(CC) $(CFLAGS) -o $@ $^ -lwinmm -lws2_32
-
-
-# For tweaking the demodulator.
-
-demod.o      : tune.h
-demod_9600.o : tune.h
-demod_afsk.o : tune.h
-demod_psk.o  : tune.h
-
-testagc : atest.c demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.o fsk_demod_agc.h \
-		hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o latlong.o symbols.o textcolor.o telemetry.o \
-		dwgpsnmea.o dwgps.o serial_port.o tt_text.o dtime_now.o regex.a misc.a
-	rm -f atest.exe
-	$(CC) $(CFLAGS) -o atest $^
-	./atest -P GGG- -F 0 ../02_Track_2.wav | grep "packets decoded in" >atest.out
-	echo " " > tune.h
-
-
-noisy3.wav : gen_packets
-	./gen_packets -B 300 -n 100 -o noisy3.wav
-
-testagc3 : atest.c demod.c dsp.c demod_afsk.c demod_psk.c demod_9600.c hdlc_rec.c hdlc_rec2.c multi_modem.c \
-		rrbb.c fcs_calc.c ax25_pad.c decode_aprs.c latlong.c symbols.c textcolor.c telemetry.c dtime_now.o regex.a misc.a \
-		tune.h 
-	rm -f atest3.exe
-	$(CC) $(CFLAGS) -o atest3 $^
-	./atest3 -B 300 -P D -D 3 noisy3.wav | grep "packets decoded in" >atest.out
-	echo " " > tune.h
-
-
-noisy96.wav : gen_packets
-	./gen_packets -B 9600 -n 100 -o noisy96.wav
-
-testagc96 : atest.c fsk_fast_filter.h tune.h demod.c demod_afsk.c demod_psk.c demod_9600.c \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o \
-		dwgpsnmea.o dwgps.o serial_port.o latlong.o \
-		symbols.o tt_text.o textcolor.o telemetry.o dtime_now.o \
-		misc.a regex.a
-	rm -f atest96.exe
-	$(CC) $(CFLAGS) -o atest96 $^
-	./atest96 -B 9600 ../walkabout9600c.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 noisy96.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 19990303_0225_9600_8bis_22kHz.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600  19990303_0225_9600_16bit_22kHz.wav | grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 -P + z8-22k.wav| grep "packets decoded in" >atest.out
-	#./atest96 -B 9600 test9600.wav | grep "packets decoded in" >atest.out
-	echo " " > tune.h
-
-testagc24 : atest.c fsk_fast_filter.h tune.h demod.c demod_afsk.c demod_psk.c demod_9600.c \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o \
-		dwgpsnmea.o dwgps.o serial_port.o latlong.o \
-		symbols.o tt_text.o textcolor.o telemetry.o dtime_now.o \
-		misc.a regex.a
-	rm -f atest24.exe
-	sleep 1
-	$(CC) $(CFLAGS) -o atest24 $^
-	./atest24 -B 2400 test2400.wav | grep "packets decoded in" >atest.out
-	echo " " > tune.h
-
-testagc48 : atest.c fsk_fast_filter.h tune.h demod.c demod_afsk.c demod_psk.c demod_9600.c \
-		dsp.o hdlc_rec.o hdlc_rec2.o multi_modem.o \
-		rrbb.o fcs_calc.o ax25_pad.o decode_aprs.o \
-		dwgpsnmea.o dwgps.o serial_port.o latlong.o \
-		symbols.o tt_text.o textcolor.o telemetry.o dtime_now.o \
-		misc.a regex.a
-	rm -f atest48.exe
-	sleep 1
-	$(CC) $(CFLAGS) -o atest48 $^
-	./atest48 -B 4800 test4800.wav | grep "packets decoded in" >atest.out
-	#./atest48 -B 4800 test4800.wav 
-	echo " " > tune.h
-
-
-# Unit test for IGate
-
-itest : igate.c textcolor.c ax25_pad.c fcs_calc.c misc.a regex.a
-	$(CC) $(CFLAGS) -DITEST -o $@ $^ -lwinmm -lws2_32
-
-
-
-
-
-# Multiple AGWPE network or serial port clients to test TNCs side by side.
-
-aclients : aclients.c ax25_pad.c fcs_calc.c textcolor.c misc.a regex.a
-	$(CC) $(CFLAGS) -o $@ $^ -lwinmm -lws2_32
-
-
-# Touch Tone to Speech sample application.
-
-ttcalc : ttcalc.o ax25_pad.o fcs_calc.o textcolor.o misc.a regex.a
-	$(CC) $(CFLAGS) -o $@ $^ -lwinmm -lws2_32
-
-
-# Send GPS location to KISS TNC each second.
-
-walk96 : walk96.c dwgps.o dwgpsnmea.o kiss_frame.o \
-		latlong.o encode_aprs.o serial_port.o textcolor.o \
-		ax25_pad.o fcs_calc.o \
-		xmit.o hdlc_send.o gen_tone.o ptt.o tq.o \
-		hdlc_rec.o hdlc_rec2.o rrbb.o dsp.o audio_win.o \
-		multi_modem.o demod.o demod_afsk.o demod_psk.c demod_9600.o rdq.o \
-		server.o morse.o audio_stats.o dtime_now.o dlq.o \
-		regex.a misc.a 
-	$(CC) $(CFLAGS) -DWALK96 -o $@ $^ -lwinmm -lws2_32
-
-
-
-#--------------------------------------------------------------
-
-
-.PHONY: depend
-depend : $(wildcard *.c)
-	makedepend -f $(lastword $(MAKEFILE_LIST)) -- $(CFLAGS) -- $^
-
-.PHONY: clean
-clean :
-	rm -f *.o *.a *.exe fsk_fast_filter.h noisy96.wav
-	echo " " > tune.h
-
-
-
-# -------------------------------  Packaging for distribution  ----------------------
-
-# Name of zip file for distribution.
-
-z := $(notdir ${CURDIR})
-
-
-.PHONY: dist-win
-dist-win : direwolf.exe decode_aprs.exe text2tt.exe tt2text.exe ll2utm.exe utm2ll.exe \
-			aclients.exe log2gpx.exe gen_packets.exe atest.exe ttcalc.exe \
-		 	generic.conf dwespeak.bat \
-			README.md CHANGES.md \
-			doc/User-Guide.pdf \
-			doc/Raspberry-Pi-APRS.pdf \
-			doc/APRStt-Implementation-Notes.pdf 
-	rm -f ../$z-win.zip
-	egrep '^C|^W' generic.conf | cut -c2-999 > direwolf.conf
-	unix2dos direwolf.conf
-	zip --junk-paths ../$z-win.zip \
-		README.md \
-		CHANGES.md \
-		doc/User-Guide.pdf \
-		doc/Raspberry-Pi-APRS.pdf \
-		doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf \
-		doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf \
-		doc/APRS-Telemetry-Toolkit.pdf \
-		doc/APRStt-Implementation-Notes.pdf \
-		doc/APRStt-interface-for-SARTrack.pdf \
-		doc/APRStt-Listening-Example.pdf \
-		doc/Raspberry-Pi-APRS.pdf \
-		doc/Raspberry-Pi-APRS-Tracker.pdf \
-		doc/Raspberry-Pi-SDR-IGate.pdf \
-		doc/User-Guide.pdf \
-		doc/WA8LMF-TNC-Test-CD-Results.pdf \
-		LICENSE* \
-		direwolf.conf \
-		direwolf.exe \
-		decode_aprs.exe \
-		tocalls.txt symbols-new.txt symbolsX.txt \
-		text2tt.exe tt2text.exe \
-		ll2utm.exe utm2ll.exe \
-		aclients.exe \
-		log2gpx.exe \
-		gen_packets.exe \
-		atest.exe \
-		ttcalc.exe \
-		dwespeak.bat \
-		telemetry-toolkit/*
-
-
-# Reminders if pdf files are not up to date.
-
-doc/User-Guide.pdf : doc/User-Guide.docx
-	echo "***** User-Guide.pdf is out of date *****"
-
-doc/Raspberry-Pi-APRS.pdf : doc/Raspberry-Pi-APRS.docx
-	echo "***** Raspberry-Pi-APRS.pdf is out of date *****" 
-
-doc/Raspberry-Pi-APRS-Tracker.pdf : doc/Raspberry-Pi-APRS-Tracker.docx
-	echo "***** Raspberry-Pi-APRS-Tracker.pdf is out of date *****" 
-
-doc/APRStt-Implementation-Notes.pdf : doc/APRStt-Implementation-Notes.docx
-	echo "***** APRStt-Implementation-Notes.pdf is out of date *****"
-
-doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf : doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.docx
-	echo "***** A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf is out of date *****"
-
-doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf : doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.docx
-	echo "***** A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf is out of date *****"
-
-doc/APRS-Telemetry-Toolkit.pdf : doc/APRS-Telemetry-Toolkit.docx
-	echo "***** APRS-Telemetry-Toolkit.pdf is out of date *****"
-
-
-
-.PHONY: backup
-backup :
-	mkdir /cygdrive/e/backup-cygwin-home/`date +"%Y-%m-%d"`
-	cp -r . /cygdrive/e/backup-cygwin-home/`date +"%Y-%m-%d"`
-
-
-#
-# The following is updated by "make depend"
-#
-# DO NOT DELETE
-

README.md

@@ -3,96 +3,231 @@
 
 ### 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](http://www.aprs.org/) encoder/decoder.   It can be used stand-alone to observe APRS traffic, as a digipeater, [APRStt](http://www.aprs.org/aprstt.html) gateway, or Internet Gateway (IGate).    It can also be used as a virtual TNC for other applications such as [APRSIS32](http://aprsisce.wikidot.com/), [UI-View32](http://www.ui-view.net/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [RMS Express](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), and many others.
+In the early days of Amateur Packet Radio, it was necessary to use an expensive "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.
+
+Why waste $200 and settle for mediocre receive performance from a 1980's technology  TNC using an old modem chip?   Dire Wolf decodes over 1000 error-free frames from Track 2 of the [WA8LMF TNC Test CD](https://github.com/wb2osz/direwolf/tree/dev/doc/WA8LMF-TNC-Test-CD-Results.pdf), leaving all the hardware TNCs, and first generation "soundcard" modems, behind in the dust.
+
+![](tnc-test-cd-results.png)
+
+Dire Wolf includes [FX.25](https://en.wikipedia.org/wiki/FX.25_Forward_Error_Correction) which adds Forward Error Correction (FEC) in a way that is completely compatible with existing systems.  If both ends are capable of FX.25, your information will continue to get through under conditions where regular AX.25 is completely useless. This was originally developed for satellites and is now seeing widespread use on HF.
+
+![](fx25.png)
+
+Version 1.7 adds [IL2P](https://en.wikipedia.org/wiki/Improved_Layer_2_Protocol), a different method of FEC with less overhead but it is not compatible with AX.25.
+
+
+
+### Dire Wolf is a modern software replacement for the old 1980's style TNC built with special hardware. ###
+
+Without any additional software, it can perform as:
+
+ - APRS GPS Tracker
+ - Digipeater
+ - Internet Gateway (IGate)
+- [APRStt](http://www.aprs.org/aprstt.html) gateway
+
+
+It can also be used as a virtual TNC for other applications such as [APRSIS32](http://aprsisce.wikidot.com/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [PinPoint APRS](http://www.pinpointaprs.com/), [UI-View32](http://www.ui-view.net/),[UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), [Ham Radio of Things](https://github.com/wb2osz/hrot), [Packet Compressed Sensing Imaging (PCSI)](https://maqifrnswa.github.io/PCSI/), and many others.
  
  
-## Features ##
+## Features & Benefits ##
 
-- Lower cost, higher performance alternative to hardware TNC.
-Decodes more than 1000 error-free frames from [WA8LMF TNC Test CD](http://wa8lmf.net/TNCtest/).  
+![](direwolf-block-diagram.png)
 
-- Ideal for building a Raspberry Pi digipeater & IGate.
+### Dire Wolf includes: ###
 
-- Data rates: 300 AFSK, 1200 AFSK, 2400 QPSK, 4800 8PSK, and 9600/19200/38400 K9NG/G3RUH.
 
-- Interface with applications by
-      - [AGW](http://uz7.ho.ua/includes/agwpeapi.htm) network protocol
-      - [KISS](http://www.ax25.net/kiss.aspx) serial port
-      - [KISS](http://www.ax25.net/kiss.aspx) network protocol
-      
-- Decoding of received information for troubleshooting.
 
-- Conversion from APRS to waypoint sentences in popular formats:  $GPWPL, $PGRMW, $PMGNWPL, $PKWDWPL.
+- **Beaconing, Tracker, Telemetry Toolkit.**
 
-- Logging and conversion to GPX file format.
+     Send periodic beacons to provide information to others.  For tracking the location is provided by a GPS receiver.
+     Build your own telemetry applications with the toolkit.
 
-- Beaconing for yourself or other nearby entities.
 
-- Very flexible Digipeating with routing and filtering between up to 6 ports.
+- **APRStt Gateway.**
 
-- APRStt gateway - converts touch tone sequences to APRS objects and voice responses.
+     Very few hams have portable equipment for APRS but nearly everyone has a handheld radio that can send DTMF tones.  APRStt allows a user, equipped with only DTMF (commonly known as Touch Tone) generation capability, to enter information into the global APRS data network.  Responses can be sent by Morse Code or synthesized speech.
 
-- APRS Internet Gateway (IGate) with IPv6 support and special SATGate mode.
+- **Digipeaters for APRS and traditional Packet Radio.**
 
-- APRS Telemetry Toolkit.
+    Extend the range of other stations by re-transmitting their signals. Unmatched flexibility for cross band repeating and filtering to limit what is retransmitted.
 
-- Compatible with software defined radios (SDR) such as [gqrx](http://gqrx.dk/),  [rtl_fm](http://sdr.osmocom.org/trac/wiki/rtl-sdr), and SDR#.
+- **Internet Gateway (IGate).**
 
-- Includes separate raw packet decoder, decode_aprs.
+    IGate stations allow communication between disjoint radio networks by allowing some content to flow between them over the Internet.
 
-- AX.25 v2.2 connected mode.  (New in version 1.4.)
+- **Ham Radio of Things (HRoT).**
 
-- Open source so you can see how it works and make your own modifications.
+    There have been occasional mentions of merging Ham Radio with the Internet of Things but only ad hoc incompatible narrowly focused applications. Here is a proposal for a standardized more flexible method so different systems can communicate with each other.
 
-- 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
+    [Ham Radio of Things - IoT over Ham Radio](https://github.com/wb2osz/hrot)
+
+- **AX.25 v2.2 Link Layer.**
+
+    Traditional connected mode packet radio where the TNC automatically retries transmissions and delivers data in the right order.
+
+- **KISS Interface (TCP/IP, serial port, Bluetooth) & AGW network Interface (TCP/IP).**
+
+    Dire Wolf can be used as a virtual TNC for applications such as [APRSIS32](http://aprsisce.wikidot.com/), [Xastir](http://xastir.org/index.php/Main_Page), [APRS-TW](http://aprstw.blandranch.net/), [YAAC](http://www.ka2ddo.org/ka2ddo/YAAC.html), [PinPoint APRS](http://www.pinpointaprs.com/), [UI-View32](http://www.ui-view.net/),[UISS](http://users.belgacom.net/hamradio/uiss.htm), [Linux AX25](http://www.linux-ax25.org/wiki/Main_Page), [SARTrack](http://www.sartrack.co.nz/index.html), [Winlink Express (formerly known as RMS Express, formerly known as Winlink 2000 or WL2K)](http://www.winlink.org/RMSExpress), [BPQ32](http://www.cantab.net/users/john.wiseman/Documents/BPQ32.html), [Outpost PM](http://www.outpostpm.org/), [Ham Radio of Things](https://github.com/wb2osz/hrot), [Packet Compressed Sensing Imaging (PCSI)](https://maqifrnswa.github.io/PCSI/), and many others.
+
+### Radio Interfaces:   ###
+
+- **Uses computer's "soundcard" and digital signal processing.**
+
+    Lower cost and better performance than specialized hardware. 
+
+    Compatible interfaces include [DRAWS](http://nwdigitalradio.com/draws/), [UDRC](https://nw-digital-radio.groups.io/g/udrc/wiki/UDRC%E2%84%A2-and-Direwolf-Packet-Modem), [SignaLink USB](http://www.tigertronics.com/slusbmain.htm), [DMK URI](http://www.dmkeng.com/URI_Order_Page.htm), [RB-USB RIM](http://www.repeater-builder.com/products/usb-rim-lite.html), [RA-35](http://www.masterscommunications.com/products/radio-adapter/ra35.html), [DINAH](https://hamprojects.info/dinah/), [SHARI](https://hamprojects.info/shari/), and many others.
+
+
+
+- **Modems:**
+
+    300 bps AFSK for HF
+
+    1200 bps AFSK most common for VHF/UHF
+
+    2400 & 4800 bps PSK
+
+    9600 bps GMSK/G3RUH
+
+    AIS reception
+
+    EAS SAME reception
+
+
+
+- **DTMF ("Touch Tone") Decoding and Encoding.**
  
+- **Speech Synthesizer interface & Morse code generator.**
+
+    Transmit human understandable messages.
+
+- **Compatible with Software Defined Radios such as gqrx, rtl_fm, and SDR#.**
+
+- **Concurrent operation with up to 3 soundcards and 6 radios.**
+
+### Portable & Open Source:   ###
+
+- **Runs on Windows, Linux (PC/laptop, Raspberry Pi, etc.), Mac OSX.**
+
+
+
+## Documentation ##
+
+
+[Stable Version](https://github.com/wb2osz/direwolf/tree/master/doc)
+
+[Latest Development Version ("dev" branch)](https://github.com/wb2osz/direwolf/tree/dev/doc)
+
+[Additional Topics](https://github.com/wb2osz/direwolf-doc)
+
+[Power Point presentations](https://github.com/wb2osz/direwolf-presentation)  -- Why not give a talk at a local club meeting?
+
+Youtube has many interesting and helpful videos.  Searching for [direwolf tnc](https://www.youtube.com/results?search_query=direwolf+tnc) or [direwolf aprs](https://www.youtube.com/results?search_query=direwolf+aprs)  will produce the most relevant results. 
+
 ## Installation ##
 
 ### Windows ###
 
-Go to the [releases page](https://github.com/wb2osz/direwolf/releases).   Download a zip file with "win" in its name, unzip it, and run direwolf.exe from a command window.
+Go to the [**releases** page](https://github.com/wb2osz/direwolf/releases).   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](https://github.com/wb2osz/direwolf/tree/master/doc).  
+You can also build it yourself from source.  For more details see the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).
 
 
-### Linux - Download with web browser ###
 
-Go to the [releases page](https://github.com/wb2osz/direwolf/releases).  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
+### Linux - Using git clone (recommended) ###
 
-For more details see the **User Guide** in the [doc directory](https://github.com/wb2osz/direwolf/tree/master/doc).  Special considerations for the Raspberry Pi are found in **Raspberry-Pi-APRS.pdf**
+***Note that this has changed for version 1.6.  There are now a couple extra steps.***
 
-### Linux - Using git clone ###
+
+First you will need to install some software development packages using different commands depending on your flavor of Linux.
+In most cases, the first few  will already be there and the package installer will tell you that installation is not necessary.
+
+On Debian / Ubuntu / Raspbian / Raspberry Pi OS:
+
+    sudo apt-get install git
+    sudo apt-get install gcc
+    sudo apt-get install g++
+    sudo apt-get install make
+    sudo apt-get install cmake
+    sudo apt-get install libasound2-dev
+    sudo apt-get install libudev-dev
+    sudo apt-get install libavahi-client-dev
+
+Or on Red Hat / Fedora / CentOS:
+
+    sudo yum install git
+    sudo yum install gcc
+    sudo yum install gcc-c++
+    sudo yum install make
+    sudo yum install alsa-lib-devel
+    sudo yum install libudev-devel
+    sudo yum install avahi-devel
+
+CentOS 6 & 7 currently have cmake 2.8 but we need 3.1 or later.
+First you need to enable the EPEL repository.  Add a symlink if you don't already have the older version and want to type cmake rather than cmake3.
+
+    sudo yum install epel-release
+	sudo rpm -e cmake
+	sudo yum install cmake3
+	sudo ln -s /usr/bin/cmake3 /usr/bin/cmake
+
+Then on any flavor of Linux:
 
 	cd ~
 	git clone https://www.github.com/wb2osz/direwolf
 	cd direwolf
-	make
+    git checkout dev
+	mkdir build && cd build
+	cmake ..
+	make -j4
 	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.
+This gives you the latest development version.  Leave out the "git checkout dev" to get the most recent stable release.
+
+For more details see the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).  Special considerations for the Raspberry Pi are found in **Raspberry-Pi-APRS.pdf**
+
+
+### Linux - Using apt-get (Debian flavor operating systems) ###
+
+Results will vary depending on your hardware platform and operating system version because it depends on various volunteers who perform the packaging. Expect the version to lag significantly behind development.
+
+	sudo apt-get update
+	apt-cache showpkg direwolf
+	sudo apt-get install direwolf
+
+
+### Linux - Using yum (Red Hat flavor operating systems) ###
+
+Results will vary depending on your hardware platform and operating system version because it depends on various volunteers who perform the packaging.  Expect the version to lag significantly behind development.
+
+	sudo yum check-update
+	sudo yum list direwolf
+	sudo yum install direwolf
+
+
+### Macintosh OS X ###
+
+Read the **User Guide** in the [**doc** directory](https://github.com/wb2osz/direwolf/tree/master/doc).   It is more complicated than Linux.
+
+If you have problems,  post them to the [Dire Wolf packet TNC](https://groups.io/g/direwolf) discussion group.
+
+You can also install a pre-built version from Mac Ports.  Keeping this up to date depends on volunteers who perform the packaging. This version could lag behind development.
+
+	sudo port install direwolf
 
-For more details see the **User Guide** in the [doc directory](https://github.com/wb2osz/direwolf/tree/master/doc).  Special considerations for the Raspberry Pi are found in **Raspberry-Pi-APRS.pdf**
 
 ## Join the conversation  ##
  
-Here are some good places to share information:
+Here are some good places to ask questions and share your experience:
 
-- [Dire Wolf packet TNC](https://groups.yahoo.com/neo/groups/direwolf_packet/info) 
+- [Dire Wolf Software TNC](https://groups.io/g/direwolf) 
 
-- [Raspberry Pi 4 Ham Radio](https://groups.yahoo.com/neo/groups/Raspberry_Pi_4-Ham_RADIO/info)
+- [Raspberry Pi 4 Ham Radio](https://groups.io/g/RaspberryPi-4-HamRadio)
 
-- [linuxham](https://groups.yahoo.com/neo/groups/linuxham/info)
+- [linuxham](https://groups.io/g/linuxham)
 
 - [TAPR aprssig](http://www.tapr.org/pipermail/aprssig/)
  

cmake/cpack/CMakeLists.txt

@@ -0,0 +1 @@
+include(CPack)

cmake/cpack/direwolf.desktop.in

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Name=@APPLICATION_NAME@
+Comment=APRS Soundcard TNC
+Exec=@APPLICATION_DESKTOP_EXEC@
+Icon=@CMAKE_PROJECT_NAME@_icon.png
+StartupNotify=true
+Terminal=false
+Type=Application
+Categories=HamRadio
+Keywords=Ham Radio;APRS;Soundcard TNC;KISS;AGWPE;AX.25

cmake/cpack/direwolf.rc

@@ -0,0 +1 @@
+MAINICON ICON "direwolf_icon.ico"

cmake/cpu_tests/test_arm_neon.cxx

@@ -0,0 +1,16 @@
+#include <stdint.h>
+#include <arm_neon.h>
+#include <stdlib.h>
+#include <signal.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	uint32x4_t x={0};
+	x=veorq_u32(x,x);
+	return 0;
+}

cmake/cpu_tests/test_x86_avx.cxx

@@ -0,0 +1,15 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <immintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m256d x = _mm256_setzero_pd();
+	x=_mm256_addsub_pd(x,x);
+	return 0;
+}

cmake/cpu_tests/test_x86_avx2.cxx

@@ -0,0 +1,15 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <immintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m256i x = _mm256_setzero_si256();
+	x=_mm256_add_epi64 (x,x);
+	return 0;
+}

cmake/cpu_tests/test_x86_avx512.cxx

@@ -0,0 +1,16 @@
+#include <stdint.h>
+#include <stdlib.h>
+#include <signal.h>
+#include <immintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+    uint64_t x[8] = {0};
+    __m512i y = _mm512_loadu_si512((__m512i*)x);
+    return 0;
+}

cmake/cpu_tests/test_x86_sse2.cxx

@@ -0,0 +1,15 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <emmintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m128i x = _mm_setzero_si128();
+	x=_mm_add_epi64(x,x);
+	return 0;
+}

cmake/cpu_tests/test_x86_sse3.cxx

@@ -0,0 +1,16 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <emmintrin.h>
+#include <pmmintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m128d x = _mm_setzero_pd();
+	x=_mm_addsub_pd(x,x);
+	return 0;
+}

cmake/cpu_tests/test_x86_sse41.cxx

@@ -0,0 +1,18 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <emmintrin.h>
+#include <smmintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m128i x = _mm_setzero_si128();
+	__m128i a = _mm_setzero_si128();
+	__m128i b = _mm_setzero_si128();
+	x=_mm_blend_epi16(a,b,4);
+	return 0;
+}

cmake/cpu_tests/test_x86_sse42.cxx

@@ -0,0 +1,15 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <nmmintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	unsigned int x=32;
+	x=_mm_crc32_u8(x,4);
+	return 0;
+}

cmake/cpu_tests/test_x86_ssse3.cxx

@@ -0,0 +1,16 @@
+#include <signal.h>
+#include <stdlib.h>
+#include <emmintrin.h>
+#include <tmmintrin.h>
+
+void signalHandler(int signum) {
+    exit(signum); // SIGILL = 4
+}
+
+int main(int argc, char* argv[])
+{
+    signal(SIGILL, signalHandler);
+	__m128i x = _mm_setzero_si128();
+	x=_mm_alignr_epi8(x,x,2);
+	return 0;
+}

cmake/include/uninstall.cmake.in

@@ -0,0 +1,21 @@
+if(NOT EXISTS "@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt")
+  message(FATAL_ERROR "Cannot find install manifest: @CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt")
+endif(NOT EXISTS "@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt")
+
+file(READ "@CMAKE_CURRENT_BINARY_DIR@/install_manifest.txt" files)
+string(REGEX REPLACE "\n" ";" files "${files}")
+foreach(file ${files})
+  message(STATUS "Uninstalling $ENV{DESTDIR}${file}")
+  if(IS_SYMLINK "$ENV{DESTDIR}${file}" OR EXISTS "$ENV{DESTDIR}${file}")
+    exec_program(
+      "@CMAKE_COMMAND@" ARGS "-E remove \"$ENV{DESTDIR}${file}\""
+      OUTPUT_VARIABLE rm_out
+      RETURN_VALUE rm_retval
+      )
+    if(NOT "${rm_retval}" STREQUAL 0)
+      message(FATAL_ERROR "Problem when removing $ENV{DESTDIR}${file}")
+    endif(NOT "${rm_retval}" STREQUAL 0)
+  else(IS_SYMLINK "$ENV{DESTDIR}${file}" OR EXISTS "$ENV{DESTDIR}${file}")
+    message(STATUS "File $ENV{DESTDIR}${file} does not exist.")
+  endif(IS_SYMLINK "$ENV{DESTDIR}${file}" OR EXISTS "$ENV{DESTDIR}${file}")
+endforeach(file)

cmake/modules/FindAvahi.cmake

@@ -0,0 +1,19 @@
+
+find_library(AVAHI_COMMON_LIBRARY NAMES avahi-common PATHS ${PC_AVAHI_CLIENT_LIBRARY_DIRS})
+if(AVAHI_COMMON_LIBRARY)
+    set(AVAHI_COMMON_FOUND TRUE)
+endif()
+
+find_library(AVAHI_CLIENT_LIBRARY NAMES avahi-client PATHS ${PC_AVAHI_CLIENT_LIBRARY_DIRS})
+if(AVAHI_CLIENT_LIBRARY)
+    set(AVAHI_CLIENT_FOUND TRUE)
+endif()
+
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(Avahi DEFAULT_MSG AVAHI_COMMON_FOUND AVAHI_CLIENT_FOUND)
+
+if (AVAHI_FOUND)
+    set(AVAHI_INCLUDE_DIRS ${AVAHI_UI_INCLUDE_DIR})
+    set(AVAHI_LIBRARIES ${AVAHI_COMMON_LIBRARY} ${AVAHI_CLIENT_LIBRARY})
+endif()
+
+mark_as_advanced(AVAHI_INCLUDE_DIRS AVAHI_LIBRARIES)

cmake/modules/FindCPUflags.cmake

@@ -0,0 +1,383 @@
+# Clang or AppleClang (see CMP0025)
+if(NOT DEFINED C_CLANG AND CMAKE_CXX_COMPILER_ID MATCHES "Clang")
+    set(C_CLANG 1)
+elseif(NOT DEFINED C_GCC AND CMAKE_CXX_COMPILER_ID MATCHES "GNU")
+    set(C_GCC 1)
+elseif(NOT DEFINED C_MSVC AND CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
+    set(C_MSVC 1)
+endif()
+
+# Detect current compilation architecture and create standard definitions
+include(CheckSymbolExists)
+function(detect_architecture symbol arch)
+    if (NOT DEFINED ARCHITECTURE)
+        set(CMAKE_REQUIRED_QUIET 1)
+        check_symbol_exists("${symbol}" "" ARCHITECTURE_${arch})
+        unset(CMAKE_REQUIRED_QUIET)
+
+        # The output variable needs to be unique across invocations otherwise
+        # CMake's crazy scope rules will keep it defined
+        if (ARCHITECTURE_${arch})
+            set(ARCHITECTURE "${arch}" PARENT_SCOPE)
+            set(ARCHITECTURE_${arch} 1 PARENT_SCOPE)
+            add_definitions(-DARCHITECTURE_${arch}=1)
+        endif()
+    endif()
+endfunction()
+
+# direwolf versions thru 1.5 were available pre-built for 32 bit Windows targets.
+# Research and experimentation revealed that the SSE instructions made a big
+# difference in runtime speed but SSE2 and later were not significantly better
+# for this application.  I decided to build with only the SSE instructions making
+# the Pentium 3 the minimum requirement. SSE2 would require at least a Pentium 4
+# and offered no significant performance advantage.
+# These are ancient history - from the previous Century - but old computers, generally
+# considered useless for anything else, often end up in the ham shack.
+#
+# When cmake was first used for direwolf, the default target became 64 bit and the
+# SSE2, SSE3, SSE4.1, and SSE4.2 instructions were automatically enabled based on the
+# build machine capabilities.  This was fine until I tried running the application
+# on a computer much older than where it was built.  It did not have the SSE4 instructions
+# and the application died without a clue for the reason.
+# Just how much benefit do these new instructions provide for this application?
+#
+# These were all run on the same computer, but compiled in different ways.
+# Times to run atest with Track 1 of the TNC test CD:
+#
+#   direwolf 1.5 - 32 bit target - gcc 6.3.0
+#
+#	60.4 sec. Pentium 3 with SSE
+#
+#   direwolf 1.6 - 32 bit target - gcc 7.4.0
+#
+#	81.0 sec. with no SIMD instructions enabled.
+#	54.4 sec. with SSE
+#	52.0 sec. with SSE2
+#	52.4 sec. with SSE2, SSE3
+#	52.3 sec. with SSE2, SSE3, SSE4.1, SSE4.2
+#	49.9 sec. Fedora standard: -m32 -march=i686 -mtune=generic -msse2 -mfpmath=sse
+#	50.4 sec. sse not sse2:    -m32 -march=i686 -mtune=generic -msse -mfpmath=sse
+#
+#	That's what I found several years ago with a much older compiler.
+#	The original SSE helped a lot but SSE2 and later made little difference.
+#
+#   direwolf 1.6 - 64 bit target - gcc 7.4.0
+#
+#	34.8 sec. with no SIMD instructions enabled.
+#	34.8 sec. with SSE
+#	34.8 sec. with SSE2
+#	34.2 sec. with SSE2, SSE3
+#	33.5 sec. with SSE2, SSE3, SSE4.1, SSE4.2
+#	33.4 Fedora standard: -mtune=generic
+#
+# 	Why do we see such little variation?  64-bit target implies
+#	SSE, SSE2, SSE3 instructions are available.
+#
+# Building for a 64 bit target makes it run about 1.5x faster on the same hardware.
+#
+# The default will be set for maximum portability so packagers won't need to
+# to anything special.
+#
+#
+# While ENABLE_GENERIC also had the desired result (for x86_64), I don't think
+# it is the right approach.  It prevents the detection of the architecture,
+# i.e. x86, x86_64, ARM, ARM64.  That's why it did not go looking for the various
+# SSE instructions.   For x86, we would miss out on using SSE.
+
+if (NOT ENABLE_GENERIC)
+    if (C_MSVC)
+        detect_architecture("_M_AMD64" x86_64)
+        detect_architecture("_M_IX86" x86)
+        detect_architecture("_M_ARM" ARM)
+        detect_architecture("_M_ARM64" ARM64)
+    else()
+        detect_architecture("__x86_64__" x86_64)
+        detect_architecture("__i386__" x86)
+        detect_architecture("__arm__" ARM)
+        detect_architecture("__aarch64__" ARM64)
+    endif()
+endif()
+if (NOT DEFINED ARCHITECTURE)
+    set(ARCHITECTURE "GENERIC")
+    set(ARCHITECTURE_GENERIC 1)
+    add_definitions(-DARCHITECTURE_GENERIC=1)
+endif()
+message(STATUS "Target architecture: ${ARCHITECTURE}")
+
+set(TEST_DIR ${PROJECT_SOURCE_DIR}/cmake/cpu_tests)
+
+# flag that set the minimum cpu flag requirements
+# used to create re-distribuitable binary
+
+if (${ARCHITECTURE} MATCHES "x86_64|x86" AND (FORCE_SSE OR FORCE_SSSE3 OR FORCE_SSE41))
+  if (FORCE_SSE)
+    set(HAS_SSE ON CACHE BOOL "SSE SIMD enabled")
+    if(C_GCC OR C_CLANG)
+      if (${ARCHITECTURE} MATCHES "x86_64")
+          # All 64-bit capable chips support MMX, SSE, SSE2, and SSE3
+          # so they are all enabled automatically.  We don't want to use
+          # SSE4, based on build machine capabilites, because the application
+          # would not run properly on an older CPU.
+          set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mtune=generic" )
+          set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mtune=generic" )
+      else()
+          # Fedora standard uses -msse2 here.
+          # I dropped it down to -msse for greater compatibility and little penalty.
+          set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -m32 -march=i686 -mtune=generic -msse -mfpmath=sse" )
+          set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -m32 -march=i686 -mtune=generic -msse -mfpmath=sse" )
+      endif()
+      message(STATUS "Use SSE SIMD instructions")
+      add_definitions(-DUSE_SSE)
+    elseif(C_MSVC)
+      set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:SSE" )
+      set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSE" )
+      set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+      message(STATUS "Use MSVC SSSE3 SIMD instructions")
+      add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+      add_definitions(-DUSE_SSSE3)
+    endif()
+  elseif (FORCE_SSSE3)
+    set(HAS_SSSE3 ON CACHE BOOL "SSSE3 SIMD enabled")
+    if(C_GCC OR C_CLANG)
+      set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mssse3" )
+      set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mssse3" )
+      message(STATUS "Use SSSE3 SIMD instructions")
+      add_definitions(-DUSE_SSSE3)
+    elseif(C_MSVC)
+      set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:SSSE3" )
+      set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSSE3" )
+      set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+      message(STATUS "Use MSVC SSSE3 SIMD instructions")
+      add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+      add_definitions(-DUSE_SSSE3)
+    endif()
+  elseif (FORCE_SSE41)
+    set(HAS_SSSE3 ON CACHE BOOL "SSSE3 SIMD enabled")
+    set(HAS_SSE4_1 ON CACHE BOOL "Architecture has SSE 4.1 SIMD enabled")
+    if(C_GCC OR C_CLANG)
+      set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -msse4.1" )
+      set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -msse4.1" )
+      message(STATUS "Use SSE 4.1 SIMD instructions")
+      add_definitions(-DUSE_SSSE3)
+      add_definitions(-DUSE_SSE4_1)
+    elseif(C_MSVC)
+      # seems that from MSVC 2015 comiler doesn't support those flags
+      set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:SSE4_1" )
+      set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSE4_1" )
+      set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+      set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+      message(STATUS "Use SSE 4.1 SIMD instructions")
+      add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+      add_definitions(-DUSE_SSSE3)
+      add_definitions(-DUSE_SSE4_1)
+    endif()
+  endif()
+else ()
+  if (${ARCHITECTURE} MATCHES "x86_64|x86")
+    if(C_MSVC)
+      try_run(RUN_SSE2 COMPILE_SSE2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse2.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+      try_run(RUN_SSE2 COMPILE_SSE2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse2.cxx" COMPILE_DEFINITIONS -msse2 -O0)
+    endif()
+    if(COMPILE_SSE2 AND RUN_SSE2 EQUAL 0)
+      set(HAS_SSE2 ON CACHE BOOL "Architecture has SSSE2 SIMD enabled")
+      message(STATUS "Use SSE2 SIMD instructions")
+      if(C_GCC OR C_CLANG)
+        set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -msse2" )
+        set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -msse2" )
+        add_definitions(-DUSE_SSE2)
+      elseif(C_MSVC)
+        set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:SSE2" )
+        set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSE2" )
+        set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:SSE2" )
+        set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:SSE2" )
+        set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+        add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+        add_definitions(-DUSE_SSE2)
+      endif()
+    else()
+      set(HAS_SSE2 OFF CACHE BOOL "Architecture does not have SSSE2 SIMD enabled")
+    endif()
+    if(C_MSVC)
+      try_run(RUN_SSSE3 COMPILE_SSSE3 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_ssse3.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+      try_run(RUN_SSSE3 COMPILE_SSSE3 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_ssse3.cxx" COMPILE_DEFINITIONS -mssse3 -O0)
+    endif()
+    if(COMPILE_SSSE3 AND RUN_SSSE3 EQUAL 0)
+      set(HAS_SSSE3 ON CACHE BOOL "Architecture has SSSE3 SIMD enabled")
+      message(STATUS "Use SSSE3 SIMD instructions")
+      if(C_GCC OR C_CLANG)
+        set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mssse3" )
+        set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mssse3" )
+        add_definitions(-DUSE_SSSE3)
+       elseif(C_MSVC)
+         # seems not present on MSVC 2017
+         #set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:SSSE3" )
+         set( CMAKE_C_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+         set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+         set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+         add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+         add_definitions(-DUSE_SSSE3)
+         endif()
+       else()
+         set(HAS_SSSE3 OFF CACHE BOOL "Architecture does not have SSSE3 SIMD enabled")
+       endif()
+       if(C_MSVC)
+         try_run(RUN_SSE4_1 COMPILE_SSE4_1 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse41.cxx" COMPILE_DEFINITIONS /O0)
+       else()
+        try_run(RUN_SSE4_1 COMPILE_SSE4_1 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse41.cxx" COMPILE_DEFINITIONS -msse4.1 -O0)
+    endif()
+    if(COMPILE_SSE4_1 AND RUN_SSE4_1 EQUAL 0)
+      set(HAS_SSE4_1 ON CACHE BOOL "Architecture has SSE 4.1 SIMD enabled")
+      message(STATUS "Use SSE 4.1 SIMD instructions")
+      if(C_GCC OR C_CLANG)
+        set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -msse4.1" )
+        set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -msse4.1" )
+        add_definitions(-DUSE_SSE4_1)
+       elseif(C_MSVC)
+           # seems not present on MSVC 2017
+           #set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSE4_1" )
+           #set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:SSE4_1" )
+           set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+           set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+           set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+           add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+           add_definitions(-DUSE_SSE4_1)
+       endif()
+    else()
+       set(HAS_SSE4_1 OFF CACHE BOOL "Architecture does not have SSE 4.1 SIMD enabled")
+    endif()
+    if(C_MSVC)
+        try_run(RUN_SSE4_2 COMPILE_SSE4_2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse42.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+        try_run(RUN_SSE4_2 COMPILE_SSE4_2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_sse42.cxx" COMPILE_DEFINITIONS -msse4.2 -O0)
+    endif()
+    if(COMPILE_SSE4_2 AND RUN_SSE4_2 EQUAL 0)
+       set(HAS_SSE4_2 ON CACHE BOOL "Architecture has SSE 4.2 SIMD enabled")
+       message(STATUS "Use SSE 4.2 SIMD instructions")
+       if(C_GCC OR C_CLANG)
+           set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -msse4.2" )
+           set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -msse4.2" )
+           add_definitions(-DUSE_SSE4_2)
+       elseif(C_MSVC)
+           # seems not present on MSVC 2017
+           #set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:SSE4_2" )
+           #set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:SSE4_2" )
+           set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+           set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox" )
+           set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+           add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+           add_definitions(-DUSE_SSE4_2)
+       endif()
+    else()
+       set(HAS_SSE4_2 OFF CACHE BOOL "Architecture does not have SSE 4.2 SIMD enabled")
+    endif()
+    if(C_MSVC)
+        try_run(RUN_AVX COMPILE_AVX "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+        try_run(RUN_AVX COMPILE_AVX "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx.cxx" COMPILE_DEFINITIONS -mavx -O0)
+    endif()
+    if(COMPILE_AVX AND RUN_AVX EQUAL 0)
+       set(HAS_AVX ON CACHE BOOL "Architecture has AVX SIMD enabled")
+       message(STATUS "Use AVX SIMD instructions")
+       if(C_GCC OR C_CLANG)
+           set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mavx" )
+           set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mavx" )
+           add_definitions(-DUSE_AVX)
+       elseif(C_MSVC)
+         set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:AVX" )
+         set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:AVX" )
+         set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX" )
+         set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX" )
+         set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+         add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+         add_definitions(-DUSE_AVX)
+       endif()
+    else()
+       set(HAS_AVX OFF CACHE BOOL "Architecture does not have AVX SIMD enabled")
+    endif()
+    if(C_MSVC)
+        try_run(RUN_AVX2 COMPILE_AVX2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx2.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+        try_run(RUN_AVX2 COMPILE_AVX2 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx2.cxx" COMPILE_DEFINITIONS -mavx2 -O0)
+    endif()
+    if(COMPILE_AVX2 AND RUN_AVX2 EQUAL 0)
+       set(HAS_AVX2 ON CACHE BOOL "Architecture has AVX2 SIMD enabled")
+       message(STATUS "Use AVX2 SIMD instructions")
+       if(C_GCC OR C_CLANG)
+           set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mavx2" )
+           set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mavx2" )
+           add_definitions(-DUSE_AVX2)
+         elseif(C_MSVC)
+         set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:AVX2" )
+         set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:AVX2" )
+         set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX2" )
+         set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX2" )
+         set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+         add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+         add_definitions(-DUSE_AVX2)
+       endif()
+    else()
+       set(HAS_AVX2 OFF CACHE BOOL "Architecture does not have AVX2 SIMD enabled")
+    endif()
+    if(C_MSVC)
+        try_run(RUN_AVX512 COMPILE_AVX512 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx512.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+        try_run(RUN_AVX512 COMPILE_AVX512 "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_x86_avx512.cxx" COMPILE_DEFINITIONS -mavx512f -O0)
+    endif()
+    if(COMPILE_AVX512 AND RUN_AVX512 EQUAL 0)
+       set(HAS_AVX512 ON CACHE BOOL "Architecture has AVX512 SIMD enabled")
+       message(STATUS "Use AVX512 SIMD instructions")
+       if(C_GCC OR C_CLANG)
+           set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mavx512f" )
+           set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mavx512f" )
+           add_definitions(-DUSE_AVX512)
+       elseif(C_MSVC)
+         set( CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} /arch:AVX512" )
+         set( CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /arch:AVX512" )
+         set( CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX512" )
+         set( CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Oi /GL /Ot /Ox /arch:AVX512" )
+         set( CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG" )
+         add_definitions (/D "_CRT_SECURE_NO_WARNINGS")
+         add_definitions(-DUSE_AVX512)
+       endif()
+    else()
+       set(HAS_AVX512 OFF CACHE BOOL "Architecture does not have AVX512 SIMD enabled")
+    endif()
+elseif(ARCHITECTURE_ARM)
+    if(C_MSVC)
+        try_run(RUN_NEON COMPILE_NEON "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_arm_neon.cxx" COMPILE_DEFINITIONS /O0)
+    else()
+        if(${CMAKE_HOST_SYSTEM_PROCESSOR} STREQUAL ${CMAKE_SYSTEM_PROCESSOR})
+          try_run(RUN_NEON COMPILE_NEON "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_arm_neon.cxx" COMPILE_DEFINITIONS -mfpu=neon -O0)
+        else()  
+          try_compile(COMPILE_NEON "${CMAKE_BINARY_DIR}/tmp" "${TEST_DIR}/test_arm_neon.cxx" COMPILE_DEFINITIONS -mfpu=neon -O0)
+          set(RUN_NEON  0)
+        endif()
+    endif()
+    if(COMPILE_NEON AND RUN_NEON EQUAL 0)
+       set(HAS_NEON ON CACHE BOOL "Architecture has NEON SIMD enabled")
+       message(STATUS "Use NEON SIMD instructions")
+       if(C_GCC OR C_CLANG)
+           set( CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mfpu=neon" )
+           set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mfpu=neon" )
+           add_definitions(-DUSE_NEON)
+       endif()
+    else()
+       set(HAS_NEON OFF CACHE BOOL "Architecture does not have NEON SIMD enabled")
+    endif()
+elseif(ARCHITECTURE_ARM64)
+    # Advanced SIMD (aka NEON) is mandatory for AArch64
+    set(HAS_NEON ON CACHE BOOL "Architecture has NEON SIMD enabled")
+    message(STATUS "Use NEON SIMD instructions")
+    add_definitions(-DUSE_NEON)
+endif()
+endif()
+
+# clear binary test folder
+FILE(REMOVE_RECURSE ${CMAKE_BINARY_DIR}/tmp)

cmake/modules/FindCompiler.cmake

@@ -0,0 +1,15 @@
+# Clang or AppleClang (see CMP0025)
+if(NOT DEFINED C_CLANG AND CMAKE_CXX_COMPILER_ID MATCHES "Clang")
+  set(C_CLANG 1)
+elseif(NOT DEFINED C_GCC AND CMAKE_CXX_COMPILER_ID MATCHES "GNU")
+  set(C_GCC 1)
+elseif(NOT DEFINED C_MSVC AND CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
+  set(C_MSVC 1)
+  if(MSVC_VERSION GREATER_EQUAL 1920 AND MSVC_VERSION LESS_EQUAL 1929)
+    set(VS2019 ON)
+  elseif(MSVC_VERSION GREATER_EQUAL 1910 AND MSVC_VERSION LESS_EQUAL 1919)
+    set(VS2017 ON)
+  elseif(MSVC_VERSION GREATER 1899 AND MSVC_VERSION LESS 1910)
+    set(VS2015 ON)
+  endif()
+endif()

cmake/modules/FindGPSD.cmake

@@ -0,0 +1,88 @@
+# - Try to find GPSD
+# Once done this will define
+#
+#  GPSD_FOUND - system has GPSD
+#  GPSD_INCLUDE_DIRS - the GPSD include directory
+#  GPSD_LIBRARIES - Link these to use GPSD
+#  GPSD_DEFINITIONS - Compiler switches required for using GPSD
+#
+#  Copyright (c) 2006 Andreas Schneider <mail@cynapses.org>
+#
+#  Redistribution and use is allowed according to the terms of the New
+#  BSD license.
+#  For details see the accompanying COPYING-CMAKE-SCRIPTS file.
+#
+
+set(GPSD_ROOT_DIR
+  "${GPSD_ROOT_DIR}"
+  CACHE
+  PATH
+  "Directory to search for gpsd")
+
+find_package(PkgConfig QUIET)
+if(PKG_CONFIG_FOUND)
+  pkg_check_modules(PC_GPSD libgps)
+endif()
+
+if (GPSD_LIBRARIES AND GPSD_INCLUDE_DIRS)
+  # in cache already
+  set(GPSD_FOUND TRUE)
+else (GPSD_LIBRARIES AND GPSD_INCLUDE_DIRS)
+  find_path(GPSD_INCLUDE_DIRS
+    NAMES
+    gps.h
+    PATHS
+    /usr/include
+    /usr/local/include
+    /opt/local/include
+    /sw/include
+    /usr/include/gps
+    /usr/local/include/gps
+    /opt/local/include/gps
+    /sw/include/gps
+    HINTS
+    ${PC_GPSD_INCLUDEDIR}
+    ${GPSD_ROOT_DIR}
+    )
+
+  # debian uses version suffixes
+  # add suffix evey new release
+  find_library(GPSD_LIBRARIES
+    NAMES
+    gps
+    PATHS
+    /usr/lib64
+    /usr/lib
+    /usr/local/lib
+    /opt/local/lib
+    /sw/lib
+    HINTS
+    ${PC_GPSD_LIBDIR}
+    ${GPSD_ROOT_DIR}
+    )
+
+  if (GPSD_INCLUDE_DIRS AND GPSD_LIBRARIES)
+    set(GPSD_FOUND TRUE)
+  endif (GPSD_INCLUDE_DIRS AND GPSD_LIBRARIES)
+
+  if (GPSD_FOUND)
+    if (NOT GPSD_FIND_QUIETLY)
+      message(STATUS "Found GPSD: ${GPSD_LIBRARIES}")
+    endif (NOT GPSD_FIND_QUIETLY)
+  else (GPSD_FOUND)
+    if (GPSD_FIND_REQUIRED)
+      message(FATAL_ERROR "Could not find GPSD")
+    endif (GPSD_FIND_REQUIRED)
+  endif (GPSD_FOUND)
+
+  # show the GPSD_INCLUDE_DIRS and GPSD_LIBRARIES variables only in the advanced view
+  mark_as_advanced(GPSD_INCLUDE_DIRS GPSD_LIBRARIES)
+
+endif (GPSD_LIBRARIES AND GPSD_INCLUDE_DIRS)
+
+# maybe on CYGWIN gpsd works
+if (WIN32)
+  set(GPSD_FOUND FALSE)
+  set(GPSD_LIBRARIES "")
+  set(GPSD_INCLUDE_DIRS "")
+endif (WIN32)

cmake/modules/FindPortaudio.cmake

@@ -0,0 +1,64 @@
+# - Try to find Portaudio
+# Once done this will define
+#
+#  PORTAUDIO_FOUND - system has Portaudio
+#  PORTAUDIO_INCLUDE_DIRS - the Portaudio include directory
+#  PORTAUDIO_LIBRARIES - Link these to use Portaudio
+
+set(PORTAUDIO_ROOT_DIR
+  "${PORTAUDIO_ROOT_DIR}"
+  CACHE
+  PATH
+  "Directory to search for portaudio")
+
+find_package(PkgConfig QUIET)
+if(PKG_CONFIG_FOUND)
+  pkg_check_modules(PC_PORTAUDIO portaudio-2.0)
+endif()
+
+find_path(PORTAUDIO_INCLUDE_DIRS
+  NAMES
+  portaudio.h
+  PATHS
+  /usr/local/include
+  /usr/include
+  /opt/local/include
+  HINTS
+  ${PC_PORTAUDIO_INCLUDEDIR}
+  ${PORTAUDIO_ROOT_DIR}
+  )
+
+find_library(PORTAUDIO_LIBRARIES
+  NAMES
+  portaudio
+  PATHS
+  /usr/local/lib
+  /usr/lib
+  /usr/lib64
+  /opt/local/lib
+  HINTS
+  ${PC_PORTAUDIO_LIBDIR}
+  ${PORTAUDIO_ROOT_DIR}
+  )
+
+mark_as_advanced(PORTAUDIO_INCLUDE_DIRS PORTAUDIO_LIBRARIES)
+
+# Found PORTAUDIO, but it may be version 18 which is not acceptable.
+if(EXISTS ${PORTAUDIO_INCLUDE_DIRS}/portaudio.h)
+  include(CheckCXXSourceCompiles)
+  set(CMAKE_REQUIRED_INCLUDES_SAVED ${CMAKE_REQUIRED_INCLUDES})
+  set(CMAKE_REQUIRED_INCLUDES ${PORTAUDIO_INCLUDE_DIRS})
+  CHECK_CXX_SOURCE_COMPILES(
+    "#include <portaudio.h>\nPaDeviceIndex pa_find_device_by_name(const char *name); int main () {return 0;}"
+    PORTAUDIO2_FOUND)
+  set(CMAKE_REQUIRED_INCLUDES ${CMAKE_REQUIRED_INCLUDES_SAVED})
+  unset(CMAKE_REQUIRED_INCLUDES_SAVED)
+  if(PORTAUDIO2_FOUND)
+    INCLUDE(FindPackageHandleStandardArgs)
+    FIND_PACKAGE_HANDLE_STANDARD_ARGS(PORTAUDIO DEFAULT_MSG PORTAUDIO_INCLUDE_DIRS PORTAUDIO_LIBRARIES)
+  else(PORTAUDIO2_FOUND)
+    message(STATUS
+      "  portaudio.h not compatible (requires API 2.0)")
+    set(PORTAUDIO_FOUND FALSE)
+  endif(PORTAUDIO2_FOUND)
+endif()

cmake/modules/Findhamlib.cmake

@@ -0,0 +1,67 @@
+# - Try to find Hamlib
+#
+# HAMLIB_FOUND - system has Hamlib
+# HAMLIB_LIBRARIES - location of the library for hamlib
+# HAMLIB_INCLUDE_DIRS - location of the include files for hamlib
+#
+# Requires these CMake modules:
+#  FindPackageHandleStandardArgs (known included with CMake >=2.6.2)
+#
+# Original Author:
+# 2019 Davide Gerhard <rainbow@irh.it>
+
+set(HAMLIB_ROOT_DIR
+  "${HAMLIB_ROOT_DIR}"
+  CACHE
+  PATH
+  "Directory to search for hamlib")
+
+find_package(PkgConfig QUIET)
+if(PKG_CONFIG_FOUND)
+  pkg_check_modules(PC_HAMLIB hamlib)
+endif()
+
+find_path(HAMLIB_INCLUDE_DIR
+  NAMES hamlib/rig.h
+  PATHS
+  /usr/include
+  /usr/local/include
+  /opt/local/include
+  HINTS
+  ${PC_HAMLIB_INCLUDEDIR}
+  ${HAMLIB_ROOT_DIR}
+  )
+
+find_library(HAMLIB_LIBRARY
+  NAMES hamlib
+  PATHS
+  /usr/lib64/hamlib
+  /usr/lib/hamlib
+  /usr/lib64
+  /usr/lib
+  /usr/local/lib64/hamlib
+  /usr/local/lib/hamlib
+  /usr/local/lib64
+  /usr/local/lib
+  /opt/local/lib
+  /opt/local/lib/hamlib
+  HINTS
+  ${PC_HAMLIB_LIBDIR}
+  ${HAMLIB_ROOT_DIR}
+
+  )
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(hamlib
+  DEFAULT_MSG
+  HAMLIB_LIBRARY
+  HAMLIB_INCLUDE_DIR
+  )
+
+if(HAMLIB_FOUND)
+  list(APPEND HAMLIB_LIBRARIES ${HAMLIB_LIBRARY})
+  list(APPEND HAMLIB_INCLUDE_DIRS ${HAMLIB_INCLUDE_DIR})
+  mark_as_advanced(HAMLIB_ROOT_DIR)
+endif()
+
+mark_as_advanced(HAMLIB_INCLUDE_DIR HAMLIB_LIBRARY)

cmake/modules/Findsndio.cmake

@@ -0,0 +1,42 @@
+# - Try to find sndio
+#
+#  SNDIO_FOUND - system has sndio
+#  SNDIO_LIBRARIES - location of the library for sndio
+#  SNDIO_INCLUDE_DIRS - location of the include files for sndio
+
+set(SNDIO_ROOT_DIR
+  "${SNDIO_ROOT_DIR}"
+  CACHE
+  PATH
+  "Directory to search for sndio")
+
+# no need to check pkg-config
+
+find_path(SNDIO_INCLUDE_DIRS
+  NAMES
+  sndio.h
+  PATHS
+  /usr/local/include
+  /usr/include
+  /opt/local/include
+  HINTS
+  ${SNDIO_ROOT_DIR}
+  )
+
+find_library(SNDIO_LIBRARIES
+  NAMES
+  sndio
+  PATHS
+  /usr/local/lib
+  /usr/lib
+  /usr/lib64
+  /opt/local/lib
+  HINTS
+  ${SNDIIO_ROOT_DIR}
+  )
+
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(SNDIO DEFAULT_MSG SNDIO_INCLUDE_DIRS SNDIO_LIBRARIES)
+
+mark_as_advanced(SNDIO_INCLUDE_DIRS SNDIO_LIBRARIES)

cmake/modules/Findudev.cmake

@@ -0,0 +1,85 @@
+# - try to find the udev library
+#
+# Cache Variables: (probably not for direct use in your scripts)
+#  UDEV_INCLUDE_DIR
+#  UDEV_SOURCE_DIR
+#  UDEV_LIBRARY
+#
+# Non-cache variables you might use in your CMakeLists.txt:
+#  UDEV_FOUND
+#  UDEV_INCLUDE_DIRS
+#  UDEV_LIBRARIES
+#
+# Requires these CMake modules:
+#  FindPackageHandleStandardArgs (known included with CMake >=2.6.2)
+#
+# Original Author:
+# 2014 Kevin M. Godby <kevin@godby.org>
+#
+# Distributed under the Boost Software License, Version 1.0.
+# (See accompanying file LICENSE_1_0.txt or copy at
+# http://www.boost.org/LICENSE_1_0.txt)
+
+set(UDEV_ROOT_DIR
+  "${UDEV_ROOT_DIR}"
+  CACHE
+  PATH
+  "Directory to search for udev")
+
+find_package(PkgConfig QUIET)
+if(PKG_CONFIG_FOUND)
+  pkg_check_modules(PC_LIBUDEV libudev)
+endif()
+
+find_library(UDEV_LIBRARY
+  NAMES
+  udev
+  PATHS
+  ${PC_LIBUDEV_LIBRARY_DIRS}
+  ${PC_LIBUDEV_LIBDIR}
+  /usr/lib64
+  /usr/lib
+  /usr/local/lib
+  HINTS
+  "${UDEV_ROOT_DIR}"
+  PATH_SUFFIXES
+  lib
+  )
+
+get_filename_component(_libdir "${UDEV_LIBRARY}" PATH)
+
+find_path(UDEV_INCLUDE_DIR
+  NAMES
+  libudev.h
+  PATHS
+  /usr/include
+  /usr/local/include
+  ${PC_LIBUDEV_INCLUDE_DIRS}
+  ${PC_LIBUDEV_INCLUDEDIR}
+  HINTS
+  "${_libdir}"
+  "${_libdir}/.."
+  "${UDEV_ROOT_DIR}"
+  PATH_SUFFIXES
+  include
+  )
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(udev
+  DEFAULT_MSG
+  UDEV_LIBRARY
+  UDEV_INCLUDE_DIR
+  )
+
+if (UDEV_INCLUDE_DIR AND UDEV_LIBRARY)
+  set(UDEV_FOUND TRUE)
+endif (UDEV_INCLUDE_DIR AND UDEV_LIBRARY)
+
+if(UDEV_FOUND)
+  list(APPEND UDEV_LIBRARIES ${UDEV_LIBRARY})
+  list(APPEND UDEV_INCLUDE_DIRS ${UDEV_INCLUDE_DIR})
+  mark_as_advanced(UDEV_ROOT_DIR)
+endif()
+
+mark_as_advanced(UDEV_INCLUDE_DIR
+  UDEV_LIBRARY)

conf/99-direwolf-cmedia.rules

@@ -0,0 +1,36 @@
+# Normally, all of /dev/hidraw* are accessible only by root.
+#
+#	$ ls -l /dev/hidraw*
+#	crw------- 1 root root 247, 0 Sep 24 09:40 /dev/hidraw0
+#
+# An ordinary user, trying to access it will be denied.
+#
+# Unnecessarily running applications as root is generally a bad idea because it makes it too easy
+# to accidentally trash your system.  We need to relax the restrictions so ordinary users can use these devices.
+#
+# If all went well with installation, the  /etc/udev/rules.d directory should contain a file called
+# 99-direwolf-cmedia.rules  containing:
+#
+
+SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0d8c", GROUP="audio", MODE="0660"
+
+#
+# I used the "audio" group, mimicking the permissions on the sound side of the device.
+#
+#	$ ls -l /dev/snd/pcm*
+#	crw-rw----+ 1 root audio 116, 16 Sep 24 09:40 /dev/snd/pcmC0D0p
+#	crw-rw----+ 1 root audio 116, 17 Sep 24 09:40 /dev/snd/pcmC0D1p
+#
+# You should see something similar to this where someone in the "audio" group has read-write access.
+#
+#	$ ls -l /dev/hidraw*
+#	crw-rw---- 1 root audio 247, 0 Oct  6 19:24 /dev/hidraw0
+#
+# Read the User Guide and run the "cm108" application for more information.
+#
+
+#
+# Same thing for the "All In One Cable."
+#
+
+SUBSYSTEM=="hidraw", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="7388", GROUP="audio", MODE="0660"

conf/CMakeLists.txt

@@ -0,0 +1,48 @@
+# generate conf per platform
+file(READ "${CUSTOM_CONF_DIR}/generic.conf" file_content)
+
+if(LINUX)
+  string(REGEX REPLACE "\n%W%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%M%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%L%([^\n]*)" "\n\\1" file_content "${file_content}")
+elseif(WIN32 OR CYGWIN)
+  string(REGEX REPLACE "\n%M%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%L%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%W%([^\n]*)" "\n\\1" file_content "${file_content}")
+else() # macOS FreeBSD OpenBSD
+  string(REGEX REPLACE "\n%W%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%L%[^\n]*" "" file_content "${file_content}")
+  string(REGEX REPLACE "\n%M%([^\n]*)" "\n\\1" file_content "${file_content}")
+endif()
+
+# remove remark
+string(REGEX REPLACE "\n%R%[^\n]*" "" file_content "${file_content}")
+
+# clear common lines
+string(REGEX REPLACE "\n%C%([^\n]*)" "\n\\1" file_content "${file_content}")
+string(REGEX REPLACE "^%C%([^\n]*)" "\\1" file_content "${file_content}")
+
+file(WRITE "${CMAKE_BINARY_DIR}/direwolf.conf" "${file_content}")
+
+# install udev rules for CM108
+if(LINUX)
+  install(FILES "${CUSTOM_CONF_DIR}/99-direwolf-cmedia.rules" DESTINATION /etc/udev/rules.d/)
+endif()
+
+install(FILES "${CMAKE_BINARY_DIR}/direwolf.conf" DESTINATION ${INSTALL_CONF_DIR})
+install(FILES "${CUSTOM_CONF_DIR}/sdr.conf" DESTINATION ${INSTALL_CONF_DIR})
+
+# Put sample configuration & startup files in home directory.
+# This step would be done as ordinary user.
+# Some people like to put the direwolf config file in /etc/ax25.
+# Note that all of these are also in $(DESTDIR)/share/doc/direwolf/examples/.
+if(NOT (WIN32 OR CYGWIN))
+  add_custom_target(install-conf
+    COMMAND ${CMAKE_COMMAND}
+    -DCUSTOM_BINARY_DIR="${CMAKE_BINARY_DIR}"
+    -DCUSTOM_CONF_DIR="${CUSTOM_CONF_DIR}"
+    -DCUSTOM_SCRIPTS_DIR="${CUSTOM_SCRIPTS_DIR}"
+    -DCUSTOM_TELEMETRY_DIR="${CUSTOM_TELEMETRY_DIR}"
+    -P "${CMAKE_SOURCE_DIR}/conf/install_conf.cmake"
+    )
+endif()

conf/generic.conf

@@ -0,0 +1,537 @@
+%C%#############################################################
+%C%#                                                           #
+%C%#               Configuration file for Dire Wolf            #
+%C%#                                                           #
+%L%#                   Linux version                           #
+%W%#                   Windows version                         #
+%M%#                   Macintosh version                       #
+%C%#                                                           #
+%C%#############################################################
+%R%
+%R%
+%R%	The sample config file was getting pretty messy
+%R%	with the Windows and Linux differences.
+%R%	It would be a maintenance burden to keep most of
+%R%	two different versions in sync.
+%R%	This common source is now used to generate the
+%R%	two different variations while having only a single
+%R%	copy of the common parts.
+%R%
+%R%	The first column contains one of the following:
+%R%
+%R%		R	remark which is discarded.
+%R%		C	common to both versions.
+%R%		W	Windows version only.
+%R%		L	Linux version only.
+%R%		M	Macintosh version and possibly others (portaudio used).
+%R%
+%C%#
+%C%# Extensive documentation can be found here:
+%C%# Stable release -       https://github.com/wb2osz/direwolf/tree/master/doc
+%C%# Latest development -   https://github.com/wb2osz/direwolf/tree/dev/doc
+%C%# Additional topics -    https://github.com/wb2osz/direwolf-doc
+%C%#
+%W%# The basic documentation set can also be found in the doc folder.
+%L%# The basic documentation set can also be found in
+%L%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
+%L%# Concise "man" pages are also available for Linux.
+%M%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
+%M%# Concise "man" pages are also available for Mac OSX.
+%C%#
+%C%# Questions???  Join the discussion forum:  https://groups.io/g/direwolf
+%C%#
+%C%#
+%C%# This sample file does not have examples for all of the possibilities.
+%C%# Consult the User Guide for more details on configuration options
+%C%# and other documents for more details for different uses.
+%C%#
+%C%# These are the most likely settings you might change:
+%C%#
+%C%#	(1)   	MYCALL 	-  call sign and SSID for your station.
+%C%#
+%C%#			Look for lines starting with MYCALL and
+%C%#			change NOCALL to your own.
+%C%#
+%C%#	(2)	PBEACON	-  enable position beaconing.
+%C%#
+%C%#			Look for lines starting with PBEACON and
+%C%#			modify for your call, location, etc.
+%C%#
+%C%#	(3)	DIGIPEATER  -  configure digipeating rules.
+%C%#
+%C%#			Look for lines starting with DIGIPEATER.
+%C%#			Most people will probably use the given example.
+%C%#			Just remove the "#" from the start of the line
+%C%#			to enable it.
+%C%#
+%C%#	(4)	IGSERVER, IGLOGIN  - IGate server and login
+%C%#
+%C%#			Configure an IGate client to relay messages between
+%C%#			radio and internet servers.
+%C%#
+%C%#
+%C%# The default location is "direwolf.conf" in the current working directory.
+%L%# On Linux, the user's home directory will also be searched.
+%C%# An alternate configuration file location can be specified with the "-c" command line option.
+%C%#
+%C%# As you probably guessed by now, # indicates a comment line.
+%C%#
+%C%# Remove the # at the beginning of a line if you want to use a sample
+%C%# configuration that is currently commented out.
+%C%#
+%C%# Commands are a keyword followed by parameters.
+%C%#
+%C%# Command key words are case insensitive.  i.e. upper and lower case are equivalent.
+%C%#
+%C%# Command parameters are generally case sensitive.  i.e. upper and lower case are different.
+%C%#
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               FIRST AUDIO DEVICE PROPERTIES               #
+%C%#               (Channel 0 + 1 if in stereo)                #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#
+%C%# Many people will simply use the default sound device.
+%C%# Some might want to use an alternative device by choosing it here.
+%C%#
+%C%#
+%C%# Many examples of radio interfaces and PTT options can be found in: 
+%C%# https://github.com/wb2osz/direwolf-doc/blob/main/Radio-Interface-Guide.pdf
+%C%#
+%C%#
+%R% ---------- Windows ----------
+%R%
+%W%# When the Windows version starts up, it displays something like
+%W%# this with the available sound devices and capabilities:
+%W%#
+%W%#	Available audio input devices for receive (*=selected):
+%W%#	   *  0: Microphone (C-Media USB Headpho   (channel 2)
+%W%#	      1: Microphone (Bluetooth SCO Audio
+%W%#	      2: Microphone (Bluetooth AV Audio)
+%W%#	 *    3: Microphone (Realtek High Defini   (channels 0 & 1)
+%W%#	Available audio output devices for transmit (*=selected):
+%W%#	   *  0: Speakers (C-Media USB Headphone   (channel 2)
+%W%#	      1: Speakers (Bluetooth SCO Audio)
+%W%#	      2: Realtek Digital Output(Optical)
+%W%#	      3: Speakers (Bluetooth AV Audio)
+%W%#	 *    4: Speakers (Realtek High Definiti   (channels 0 & 1)
+%W%#	      5: Realtek Digital Output (Realtek
+%W%#
+%W%# Example: To use the microphone and speaker connections on the
+%W%# system board, either of these forms can be used:
+%W%
+%W%#ADEVICE High
+%W%#ADEVICE  3 4
+%W%
+%W%
+%W%# Example: To use the USB Audio, use a command like this with
+%W%# the input and output device numbers.  (Remove the # comment character.)
+%W%#ADEVICE USB
+%W%
+%W%# You can also use "-" or "stdin" to pipe stdout from
+%W%# some other application such as a software defined radio.
+%W%# "stdin" is not an audio device.  Don't use this unless you
+%W%# understand what this means.  Read the User Guide.
+%W%# You can also specify "UDP:" and an optional port for input.
+%W%# Something different must be specified for output.
+%W%
+%W%# ADEVICE stdin 0
+%W%# ADEVICE UDP:7355 0
+%W%
+%W%# The position in the list can change when devices (e.g. USB) are added and removed.
+%W%# You can also specify devices by using part of the name.
+%W%# Here is an example of specifying the USB Audio device.
+%W%# This is case-sensitive.  Upper and lower case are not treated the same.
+%W%
+%W%#ADEVICE USB
+%W%
+%W%
+%R% ---------- Linux ----------
+%R%
+%L%# Linux ALSA is complicated.  See User Guide for discussion.
+%L%# To use something other than the default, generally use plughw
+%L%# and a card number reported by "arecord -l" command.  Example:
+%L%
+%L%# ADEVICE  plughw:1,0
+%L%
+%L%# You can also use "-" or "stdin" to pipe stdout from
+%L%# some other application such as a software defined radio.
+%L%# "stdin" is not an audio device.  Don't use this unless you
+%L%# understand what this means.  Read the User Guide.
+%L%# You can also specify "UDP:" and an optional port for input.
+%L%# Something different must be specified for output.
+%L%
+%L%# ADEVICE stdin plughw:1,0
+%L%# ADEVICE UDP:7355 default
+%L%
+%R% ---------- Mac ----------
+%R%
+%M%# Macintosh Operating System uses portaudio driver for audio
+%M%# input/output. Default device selection not available. User/OP
+%M%# must configure the sound input/output option.  Note that
+%M%# the device names can contain spaces.  In this case, the names
+%M%# must be enclosed by quotes.
+%M%#
+%M%# Examples:
+%M%#
+%M%ADEVICE "Built-in Input" "Built-in Output"
+%M%
+%M%# ADEVICE  "USB Audio Codec:6"  "USB Audio Codec:5"
+%M%#
+%M%#
+%M%# You can also use "-" or "stdin" to pipe stdout from
+%M%# some other application such as a software defined radio.
+%M%# "stdin" is not an audio device.  Don't use this unless you
+%M%# understand what this means.  Read the User Guide.
+%M%# You can also specify "UDP:" and an optional port for input.
+%M%# Something different must be specified for output.
+%M%
+%M%# ADEVICE UDP:7355 default
+%M%#
+%C%
+%C%#
+%C%# Number of audio channels for this souncard:  1 (mono) or 2 (stereo).
+%C%# 1 is the default so there is no need to specify it.
+%C%#
+%C%
+%C%#ACHANNELS 2
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               SECOND AUDIO DEVICE PROPERTIES              #
+%C%#               (Channel 2 + 3 if in stereo)                #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#ADEVICE1  ...
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               THIRD AUDIO DEVICE PROPERTIES               #
+%C%#               (Channel 4 + 5 if in stereo)                #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#ADEVICE2  ...
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               CHANNEL 0 PROPERTIES                        #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%CHANNEL 0
+%C%
+%C%#
+%C%# The following MYCALL, MODEM, PTT, etc. configuration items
+%C%# apply to the most recent CHANNEL.
+%C%#
+%C%
+%C%#
+%C%# Station identifier for this channel.
+%C%# Multiple channels can have the same or different names.
+%C%#
+%C%# It can be up to 6 letters and digits with an optional ssid.
+%C%# The APRS specification requires that it be upper case.
+%C%#
+%C%# Example (don't use this unless you are me):  MYCALL WB2OSZ-5
+%C%#
+%C%
+%C%MYCALL N0CALL
+%C%
+%C%#
+%C%# Pick a suitable modem speed based on your situation.
+%C%#	1200 	Most common for VHF/UHF.  This is the default if not specified.
+%C%#	2400	QPSK compatible with MFJ-2400, and probably PK232-2400 & KPC-2400.
+%C%#	300	Low speed for HF SSB.  Default tones 1600 & 1800.
+%C%#	EAS	Emergency Alert System (EAS) Specific Area Message Encoding (SAME).
+%C%#	9600	G3RUH style - Can't use Microphone and Speaker connections.
+%C%#	AIS	International system for tracking ships on VHF.
+%C%#			Also uses 9600 bps so Speaker connection won't work.
+%C%#
+%C%# In most cases you can just specify the speed.  Examples:
+%C%#
+%C%
+%C%MODEM 1200
+%C%#MODEM 9600
+%C%
+%C%#
+%C%# Many options are available for great flexibility.
+%C%# See User Guide for details.
+%C%#
+%C%
+%C%#
+%C%# Uncomment line below to enable the DTMF decoder for this channel.
+%C%#
+%C%
+%C%#DTMF
+%C%
+%C%# Push to Talk (PTT) can be confusing because there are so many different cases.
+%C%# Radio-Interface-Guide.pdf  in  https://github.com/wb2osz/direwolf-doc
+%C%# goes into detail about the various options.
+%C%
+%L%# If using a C-Media CM108/CM119 or similar USB Audio Adapter,
+%L%# you can use a GPIO pin for PTT control. This is very convenient
+%L%# because a single USB connection is used for both audio and PTT.
+%L%# Example:
+%L%
+%L%#PTT CM108
+%L%
+%W%# If using a C-Media CM108/CM119 or similar USB Audio Adapter,
+%W%# you can use a GPIO pin for PTT control. This is very convenient
+%W%# because a single USB connection is used for both audio and PTT.
+%W%# Example:
+%W%
+%W%#PTT CM108
+%W%%C%#
+%C%# The transmitter Push to Talk (PTT) control can be wired to a serial port
+%C%# with a suitable interface circuit.  DON'T connect it directly!
+%C%#
+%C%# For the PTT command, specify the device and either RTS or DTR.
+%C%# RTS or DTR may be preceded by "-" to invert the signal.
+%C%# Both can be used for interfaces that want them driven with opposite polarity.
+%C%#
+%L%# COM1 can be used instead of /dev/ttyS0, COM2 for /dev/ttyS1, and so on.
+%L%#
+%C%
+%C%#PTT COM1 RTS
+%C%#PTT COM1 RTS -DTR
+%L%#PTT /dev/ttyUSB0 RTS
+%L%#PTT /dev/ttyUSB0 RTS -DTR
+%C%
+%L%#
+%L%# On Linux, you can also use general purpose I/O pins if
+%L%# your system is configured for user access to them.
+%L%# This would apply mostly to microprocessor boards, not a regular PC.
+%L%# See separate Raspberry Pi document for more details.
+%L%# The number may be preceded by "-" to invert the signal.
+%L%#
+%L%
+%L%#PTT GPIO 25
+%L%
+%C%# The Data Carrier Detect (DCD) signal can be sent to most of the same places
+%C%# as the PTT signal.  This could be used to light up an LED like a normal TNC.
+%C%
+%C%#DCD COM1 -DTR
+%L%#DCD GPIO 24
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               CHANNEL 1 PROPERTIES                        #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#CHANNEL 1
+%C%
+%C%#
+%C%# Specify MYCALL, MODEM, PTT, etc. configuration items for
+%C%# CHANNEL 1.   Repeat for any other channels.
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               TEXT TO SPEECH COMMAND FILE                 #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%W%#SPEECH dwespeak.bat
+%L%#SPEECH dwespeak.sh
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               VIRTUAL TNC SERVER PROPERTIES               #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#
+%C%# Dire Wolf acts as a virtual TNC and can communicate with
+%C%# client applications by different protocols:
+%C%#
+%C%#	- the "AGW TCPIP Socket Interface" - default port 8000
+%C%#	- KISS protocol over TCP socket - default port 8001
+%W%#	- KISS TNC via serial port
+%L%#	- KISS TNC via pseudo terminal   (-p command line option)
+%C%#
+%C%
+%C%AGWPORT 8000
+%C%KISSPORT 8001
+%C%
+%W%#
+%W%# Some applications are designed to operate with only a physical
+%W%# TNC attached to a serial port.  For these, we provide a virtual serial
+%W%# port that appears to be connected to a TNC.
+%W%#
+%W%# Take a look at the User Guide for instructions to set up
+%W%# two virtual serial ports named COM3 and COM4 connected by
+%W%# a null modem.
+%W%#
+%W%# Using the  configuration described, Dire Wolf will connect to
+%W%# COM3 and the client application will use COM4.
+%W%#
+%W%# Uncomment following line to use this feature.
+%W%
+%W%#NULLMODEM COM3
+%W%
+%W%
+%C%#
+%C%# It is sometimes possible to recover frames with a bad FCS.
+%C%# This is not a global setting.
+%C%# It applies only the the most recent CHANNEL specified.
+%C%#
+%C%#	0 - Don't try to repair.  (default)
+%C%#	1 - Attempt to fix single bit error.
+%C%#
+%C%
+%C%#FIX_BITS 0
+%C%
+%C%#
+%C%#############################################################
+%C%#                                                           #
+%C%#           FIXED POSIION BEACONING PROPERTIES              #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%
+%C%#
+%C%# Beaconing is configured with these two commands:
+%C%#
+%C%#	PBEACON		- for a position report (usually yourself)
+%C%#	OBEACON		- for an object report (usually some other entity)
+%C%#
+%C%# Each has a series of keywords and values for options.
+%C%# See User Guide for details.
+%C%#
+%C%# Example:
+%C%#
+%C%# This results in a broadcast once every 10 minutes.
+%C%# Every half hour, it can travel via one digipeater hop.
+%C%# The others are kept local.
+%C%#
+%C%
+%C%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1
+%C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
+%C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
+%C%
+%C%#
+%C%# Did you know that APRS comments and messages can contain UTF-8 characters, not only plain ASCII?
+%C%#
+%C%#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xe0\xb8\xa7\xe0\xb8\xb4\xe0\xb8\x97\xe0\xb8\xa2\xe0\xb8\xb8\xe0\xb8\xaa\xe0\xb8\xa1\xe0\xb8\xb1\xe0\xb8\x84\xe0\xb8\xa3\xe0\xb9\x80\xe0\xb8\xa5\xe0\xb9\x88\xe0\xb8\x99"
+%C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xce\xa1\xce\xb1\xce\xb4\xce\xb9\xce\xbf\xce\xb5\xcf\x81\xce\xb1\xcf\x83\xce\xb9\xcf\x84\xce\xb5\xcf\x87\xce\xbd\xce\xb9\xcf\x83\xce\xbc\xcf\x8c\xcf\x82"
+%C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W comment=" Did you know that APRS comments and messages can contain UTF-8 characters?   \xe3\x82\xa2\xe3\x83\x9e\xe3\x83\x81\xe3\x83\xa5\xe3\x82\xa2\xe7\x84\xa1\xe7\xb7\x9a"
+%C%#
+%C%# With UTM coordinates instead of latitude and longitude.
+%C%
+%C%#PBEACON delay=1 every=10 overlay=S symbol="digi" zone=19T easting=307477 northing=4720178
+%C%
+%C%
+%C%#
+%C%# When the destination field is set to "SPEECH" the information part is
+%C%# converted to speech rather than transmitted as a data frame.
+%C%#
+%C%
+%C%#CBEACON dest="SPEECH" info="Club meeting tonight at 7 pm."
+%C%
+%C%# Similar for Morse code.  If SSID is specified, it is multiplied
+%C%# by 2 to get speed in words per minute (WPM).
+%C%
+%C%#CBEACON dest="MORSE-6" info="de MYCALL"
+%C%
+%C%
+%C%#
+%C%# Modify for your particular situation before removing
+%C%# the # comment character from the beginning of appropriate lines above.
+%C%#
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#             APRS DIGIPEATER PROPERTIES                    #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#
+%C%# For most common situations, use something like this by removing
+%C%# the "#" from the beginning of the line below.
+%C%#
+%C%
+%C%#DIGIPEAT 0 0 ^WIDE[3-7]-[1-7]$|^TEST$ ^WIDE[12]-[12]$
+%C%
+%C%# See User Guide and "APRS-Digipeaters.pdf" for more explanation of what
+%C%# this means and how it can be customized for your particular needs.
+%C%
+%C%
+%C%# Traditional connected mode packet radio uses a different
+%C%# type of digipeating.  See User Guide for details.
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               INTERNET GATEWAY                            #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%# First you need to specify the name of a Tier 2 server.
+%C%# The current preferred way is to use one of these regional rotate addresses:
+%C%
+%C%#	noam.aprs2.net 		- for North America
+%C%#	soam.aprs2.net		- for South America
+%C%#	euro.aprs2.net		- for Europe and Africa
+%C%#	asia.aprs2.net 		- for Asia
+%C%#	aunz.aprs2.net		- for Oceania
+%C%
+%C%#IGSERVER noam.aprs2.net
+%C%
+%C%# You also need to specify your login name and passcode.
+%C%# Contact the author if you can't figure out how to generate the passcode.
+%C%
+%C%#IGLOGIN WB2OSZ-5 123456
+%C%
+%C%# That's all you need for a receive only IGate which relays
+%C%# messages from the local radio channel to the global servers.
+%C%
+%C%# Some might want to send an IGate client position directly to a server
+%C%# without sending it over the air and relying on someone else to
+%C%# forward it to an IGate server.  This is done by using sendto=IG rather
+%C%# than a radio channel number. Overlay R for receive only, T for two way.
+%C%# There is no need to send it as often as you would over the radio.
+%C%
+%C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=R lat=42^37.14N long=071^20.83W
+%C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=T lat=42^37.14N long=071^20.83W
+%C%
+%C%
+%C%# To relay messages from the Internet to radio, you need to add
+%C%# one more option with the transmit channel number and a VIA path.
+%C%
+%C%#IGTXVIA 0 WIDE1-1,WIDE2-1
+%C%
+%C%
+%C%# Finally, we don't want to flood the radio channel.
+%C%# The IGate function will limit the number of packets transmitted
+%C%# during 1 minute and 5 minute intervals.   If a limit would
+%C%# be exceeded, the packet is dropped and message is displayed in red.
+%C%# This might be low for APRS Thursday when there is abnormally high activity.
+%C%
+%C%IGTXLIMIT 6 10
+%C%
+%C%
+%C%#############################################################
+%C%#                                                           #
+%C%#               APRStt GATEWAY                              #
+%C%#                                                           #
+%C%#############################################################
+%C%
+%C%#
+%C%# Dire Wolf can receive DTMF (commonly known as Touch Tone)
+%C%# messages and convert them to packet objects.
+%C%#
+%C%# See separate "APRStt-Implementation-Notes" document for details.
+%C%#
+

conf/install_conf.cmake

@@ -0,0 +1,23 @@
+if(NOT EXISTS $ENV{HOME}/direwolf.conf)
+  configure_file("${CUSTOM_BINARY_DIR}/direwolf.conf" $ENV{HOME})
+endif()
+
+if(NOT EXISTS $ENV{HOME}/sdr.conf)
+  configure_file("${CUSTOM_CONF_DIR}/sdr.conf" $ENV{HOME})
+endif()
+
+if(NOT EXISTS $ENV{HOME}/dw-start.sh)
+  configure_file("${CUSTOM_SCRIPTS_DIR}/dw-start.sh" $ENV{HOME})
+endif()
+
+if(NOT EXISTS $ENV{HOME}/telem-m0xer-3.txt)
+  configure_file("${CUSTOM_TELEMETRY_DIR}/telem-m0xer-3.txt" $ENV{HOME})
+endif()
+
+if(NOT EXISTS $ENV{HOME}/telem-balloon.conf)
+  configure_file("${CUSTOM_TELEMETRY_DIR}/telem-balloon.conf" $ENV{HOME})
+endif()
+
+if(NOT EXISTS $ENV{HOME}/telem-volts.conf)
+  configure_file("${CUSTOM_TELEMETRY_DIR}/telem-volts.conf" $ENV{HOME})
+endif()

data/CMakeLists.txt

@@ -0,0 +1,41 @@
+#
+# Update: 1 May 2023  (still 1.7 dev version)
+#
+# The original intention was to allow an easy way to download the most
+# recent versions of some files.
+#
+# "update-data" would only work once.
+#
+# These locations are no longer being maintained:
+#	http://www.aprs.org/aprs11/tocalls.txt		-- 14 Dec 2021
+#	http://www.aprs.org/symbols/symbols-new.txt	-- 17 Mar 2021
+#	http://www.aprs.org/symbols/symbolsX.txt	-- 25 Nov 2015
+# so there is no reason to provide a capability grab the latest version.
+#
+# Rather than fixing an obsolete capability, it will just be removed.
+#
+# The destination field is often used to identify the manufacturer/model.
+# These are not hardcoded into Dire Wolf.  Instead they are read from
+# a file called tocalls.txt at application start up time.
+#
+# The original permanent symbols are built in but the "new" symbols,
+# using overlays, are often updated.  These are also read from files.
+#
+
+
+include(ExternalProject)
+
+set(TOCALLS_TXT "tocalls.txt")
+set(SYMBOLS-NEW_TXT "symbols-new.txt")
+set(SYMBOLSX_TXT "symbolsX.txt")
+set(CUSTOM_BINARY_DATA_DIR "${CMAKE_BINARY_DIR}/data")
+
+# we can also move to a separate cmake file and use file(download)
+# see conf/install_conf.cmake as example
+file(COPY "${CUSTOM_DATA_DIR}/${TOCALLS_TXT}" DESTINATION "${CUSTOM_BINARY_DATA_DIR}")
+file(COPY "${CUSTOM_DATA_DIR}/${SYMBOLS-NEW_TXT}" DESTINATION "${CUSTOM_BINARY_DATA_DIR}")
+file(COPY "${CUSTOM_DATA_DIR}/${SYMBOLSX_TXT}" DESTINATION "${CUSTOM_BINARY_DATA_DIR}")
+
+install(FILES "${CUSTOM_BINARY_DATA_DIR}/${TOCALLS_TXT}" DESTINATION ${INSTALL_DATA_DIR})
+install(FILES "${CUSTOM_BINARY_DATA_DIR}/${SYMBOLS-NEW_TXT}" DESTINATION ${INSTALL_DATA_DIR})
+install(FILES "${CUSTOM_BINARY_DATA_DIR}/${SYMBOLSX_TXT}" DESTINATION ${INSTALL_DATA_DIR})

data/symbols-new.txt

@@ -1,20 +1,28 @@
-APRS SYMBOL OVERLAY and EXTENSION TABLES in APRS 1.2      18 Oct 2016
----------------------------------------------------------------------
+APRS SYMBOL OVERLAY and EXTENSION TABLES in APRS 1.2      17 Mar 2021
+------------------------------------------------------------------------
 
-BACKGROUND:  This file addresses new additions proposals (OVERLAYS) 
-to the APRS symbol set after 1 October 2007.  The master symbol 
-document remains on the www.aprs.org/symbols/symbolsX.txt page, but
-only has one line per symbol character.  Since each of the symbols
-can have up to 36 overlays, this gives us thousands of symbols codes.
+BACKGROUND:  Since October 2007, overlay characters (36/symbol) are
+allowed on all symbols.  This allows thousands of uniquely specified
+symbols instead of the original 188 (94 primary and 94 alternate).
+But the master symbol document,  http://aprs.org/symbols/symbolsX.txt, 
+only has one line per symbol.  So this added overlay list below gives 
+us thousands of new symbol codes.
+
+17 Mar 21 Added L& for LORA Igate
+24 Jun18: Updated CAR symbols 
+17 Jun18: Added several overlays for RAIL symbol
+03 Apr17: Added Methane Hazard symbol "MH"
+13 Feb17: Added Ez = Emergency Power (shelter), Cars: P> = Plugin
+          S> = Solar powered. Moved Ham club C- to Buildings Ch.
+          Added C- to house for combined renewables and added R% 
+          Renewable to power plants
+
+18 Oct16: Added G,Y,R for Flood gauges + N for Normal.(on H2O symbol)
+          Added DIGIPEATERS
+22 Mar16: Added A0 overlay circle for ALSTAR nodes and V0 for VOIP. 
+          Combined echolink and IRLP. P& for PSKmail node. W& for
+          Wires-X (was W0 for WiresII). Ya for Yaesu C4FM repeaters
 
-18 Oct 2016:  Added Green, Yellow, Red for Flood gaures using G,Y,R
-              overlays + N for Normal. (on existing H2O symbol)
-              Added DIGIPEATERS
-22 Mar 2016:  Added A0 overlay circle for ALSTAR nodes 
-              and V0 for VOIP combined echolink and IRLP
-              and P& for PSKmail node
-              and W& for Wirese-X as opposed to W0 for WiresII
-              and Ya for Yaesu C4FM repeaters
 Update 29 Oct 2015:  Reorgainized list to Alphabetical Order.
   + Added many new Balloons (due to lost DoD radar Blimp yesterday)
   + Confirmed D^ for Drones was already in there since 2014
@@ -25,27 +33,20 @@ Update 29 Oct 2015:  Reorgainized list to Alphabetical Order.
 
 UPDATES/REVISIONS/CORRECTIONS:
 
-28 Aug 14  Added numerous OpenAPRS symbols see "(new Aug 2014)"
-20 May 14  Changed Da to DSTAR (2700 of them) from Dutch Ares
-19 May 14  Added Submarine&torpedo to ships and lots of Aircraft
-           search for "(new may 2014)"
-07 Oct 13  Added new overlays to ships such as Jet Ski, Js
-           Added Ham Club symbol as a C overlay on House, C-
-19 Sep 11  Added T and 2 overlays for TX 1 and 2 hop IGates
-           Added overlays to (;) portable, to show event types
-23 Mar 11  Added Radiation Detector (RH)
-20 Apr 10  Byonics requested (BY)
-04 Jan 10  added #A to the table (correcting earlier omission)
-12 Oct 09  Added W0 for Yaesu WIRES nodes
-09 Apr 09  Changed APRStt symbol to overlayed BOX (#A)
-21 Aug 08  Added RFID R=, Babystroller B], Radio#Y, skull&Xbones XH
+2014 Added numerous OpenAPRS symbol. Changed Da to DSTAR from Dutch 
+     ARES. Added Subs to ships and lots of Aircraft overlays.
+2013 Added ship overlay Jet Ski. Ham Club as C overlay on House, C-
+2011 Added T and 2 overlays for TX 1 and 2 hop IGates
+     Added overlays to (;) Portables  Added Radiation Detector (RH)
+2010 Byonics requested (BY) and added #A to the table 
+2009 Added W0 for Yaesu WIRES and APRStt symbol to overlayed BOX (#A)
+2008 Added RFID R=, Babystroller B], Radio#Y, skull&Xbones XH
 
 
-25 Mar 08 Modified these Alternate Symbol codes for expanded Overlays.
-Prior to this, each Alternate Table basic symbol had a unique defini-
-tion, but this was every restrictive.  SO the following alternate 
-base symbols were redefined so that the basic symbol could take on
-dozens of unique overlay definitions:
+DEPRICATION AND MAJOR REVISION:  25 Mar 08 Modified several Alternate 
+Symbol codes for expanded Overlays.  The following alternate base 
+symbols were redefined so that the basic symbol could take on dozens 
+of unique overlay definitions:
 
 \= - Had been undefined
 \0 - Several overlays for the numbered Circle
@@ -58,16 +59,17 @@ dozens of unique overlay definitions:
 \u - Overlay Trucks.  "Tu" is a tanker. "Gu" is a gas truck, etc
 \< - Advisories may now have overlays
 \8 - Nodes with overlays. "G8" would be 802.11G
-\[ - \[ is wall cloud, but overlays are humans. S[ is a skier.
-\h - Buildings. \h is a Ham store, "Hh" is Home Depot, etc.
+\[ - \[ was wall cloud, but overlays are humans. S[ is a skier.
+\h - Was Ham store, Now Overlays are buildings "Hh" Home Depot, etc.
 
-Previous edition was 4 Oct 2007.
+
+4 Oct 2007.   ORIGINAL EXPANSION to OVERLAYS ON ALL SYMBOLS
 
 In April 2007, a proposal to expand the use of overlay bytes for 
 the extension of the APRS symbol set was added to the draft APRS1.2 
 addendum web page.  The following document addresses that proposal:
 
-www.aprs.org/symbols/symbols-overlays.txt
+http://aprs.org/symbols/symbols-overlays.txt
 
 For details on Upgrading your symbol set, please see the background
 information on Symbols prepared by Stephen Smith, WA8LMF:
@@ -97,8 +99,9 @@ small subset of alternate symbols.  Those original overlayable
 alternate symbols were labeled with a "#" and called "numbered"
 symbols.   (UIview requires "No." in the symbols.ini file) 
 
-STATUS OF OVERLAYS 1 OCTOBER 2007:  the APRS symbol set only had a 
-few remaining unused symbol codes that had not yet been defined:
+STATUS OF OVERLAYS 1 OCTOBER 2007:  the APRS symbol set was limited
+to about 94 symbols and only had a few remaining unused symbol 
+codes that had not yet been defined:
 
 OF THE 94 Primary Symbols.  The following were available:
    10 symbols (/0 - /9) that mostly look like billiard balls now
@@ -110,7 +113,7 @@ OF THE 94 Alternate  Symbols.  The following were available:
    8 series \1 through \8  that can support 36 overlays each
    3 reserved series.
 
-ADDITIONAL OVERLAY PROPOSAL:  But any of the other 79 alternate 
+BASIS FOR OVERLAY EXPANSION:  But any of the other 79 alternate 
 symbols could all have multiple (36) overlays if they can make sense 
 with the existing underlying basic symbol that we have been using for 
 that basic alternate symbol.  That is, any new definition of a 
@@ -131,7 +134,7 @@ letting that define a new graphic just for that combination.
 The following tables will attempt to keep track of these and
 any other useful generic applications of overlay characters.
 
-AMPLIFIED some existing ALTERNATE SYMBOL Overlays: (new Aug 2014)
+AMPLIFIED some existing ALTERNATE SYMBOL Overlays: (Aug 2014)
 change Flooding #W to include Avalanche, Mudslide/Landslide
 Update #' name to crash & incident sites
 Update \D (was available) to DEPOT family
@@ -181,6 +184,7 @@ MO = Manned Balloon  (2015)
 TO = Teathered       (2015)
 CO = Constant Pressure - Long duration (2015)
 RO = Rocket bearing Balloon (Rockoon)  (2015)
+WO = World-round balloon (2018)
 
 BOX SYMBOL: #A (and other system inputted symbols)
 /A = Aid station
@@ -199,17 +203,27 @@ etc
 BUILDINGS: #h
 /h = Hospital
 \h = Ham Store       ** <= now used for HAMFESTS
+Ch = Club (ham radio)
+Eh = Electronics Store
 Fh = HamFest (new Aug 2014)
-Hh = Home Dept etc..
+Hh = Hardware Store etc..
 
 CARS: #> (Vehicles)
 /> = normal car (side view)
 \> = Top view and symbol POINTS in direction of travel
 #> = Reserve overlays 1-9 for numbered cars (new Aug 2014)
-E> = Electric 
+3> = Model 3 (Tesla)
+B> = BEV - Battery EV(was E for electric)
+D> = DIY - Do it yourself 
+E> = Ethanol (was electric)
+F> = Fuelcell or hydrogen 
 H> = Hybrid
+L> = Leaf
+P> = PHEV - Plugin-hybrid
 S> = Solar powered
-V> = GM Volt
+T> = Tesla  (temporary)
+V> = Volt (temporary)
+X> = Model X
 
 CIVIL DEFENSE or TRIANGLE: #c
 /c = Incident Command Post
@@ -260,6 +274,7 @@ FE = (F overlay) Fog                  was \{
 GATEWAYS: #&
 /& = HF Gateway  <= the original primary table definition
 I& = Igate Generic (please use more specific overlay)
+L& - Lora Igate
 R& = Receive only IGate (do not send msgs back to RF)
 P& = PSKmail node
 T& = TX igate with path set to 1 hop only)
@@ -274,6 +289,7 @@ A\ = Avmap G5      * <= Recommend special symbol
 HAZARDS: #H
 /H = hotel
 \H = Haze
+MH = Methane Hazard (new Apr 2017)
 RH = Radiation detector (new mar 2011)
 WH = Hazardous Waste
 XH = Skull&Crossbones
@@ -289,16 +305,16 @@ H[ = Hiker
 HOUSE: #-
 /- = House
 \- = (was HF)
-5- = 50 Hz mains power
-6- = 60 Hz mains power
-B- = Backup Battery Power
-C- = Club, as in Ham club
-E- = Emergency power
+5- = 50 Hz if non standard
+6- = 60 Hz if non standard
+B- = Battery or off grid
+C- = Combined alternatives
+E- = Emergency power (grid down)
 G- = Geothermal
 H- = Hydro powered
 O- = Operator Present
-S- = Solar Powered
-W- = Wind powered
+S- = Solar Power
+W- = Wind power
 
 INCIDENT SITES: #'
 /' = Small Aircraft (original primary symbol)
@@ -329,18 +345,39 @@ I; = Islands on the air
 S; = Summits on the air
 W; = WOTA
 
-POWER or ENERGY: #%  
+POWER and ENERGY: #%  
 /% = DX cluster  <= the original primary table definition
 C% = Coal
 E% = Emergency  (new Aug 2014)
-G% = Geothermal
+G% = Gas Turbine
 H% = Hydroelectric
 N% = Nuclear
 P% = Portable (new Aug 2014)
+R% = Renewable (hydrogen etc fuels)
 S% = Solar
-T% = Turbine
+T% = Thermal (geo)
 W% = Wind
 
+RAIL Symbols: #=
+/= = generic train (use steam engine shape for quick recognition)
+\= = tbd    (use same symbol for now)
+B= = Bus-rail/trolley/streetcar/guiderail
+C= = Commuter
+D= = Diesel
+E= = Electric
+F= = Freight
+G= = Gondola
+H= = High Speed Rail (& Hyperloop?)
+I= = Inclined Rail
+L= = eLevated
+M= = Monorail
+P= = Passenger
+S= = Steam
+T= = Terminal (station)
+U= = sUbway (& Hyperloop?)
+X= = eXcursion
+
+
 RESTAURANTS: #R 
 \R = Restaurant (generic)
 7R = 7/11
@@ -368,6 +405,7 @@ SHELTERS: #z
 /z = was available
 \z = overlayed shelter
 Cz = Clinic (new Aug 2014)
+Ez = Emergency Power
 Gz = Government building  (new Aug 2014)
 Mz = Morgue (new Aug 2014)
 Tz = Triage (new Aug 2014)

data/tocalls.txt

@@ -1,23 +1,40 @@
-APRS TO-CALL VERSION NUMBERS                            14 Nov 2016
--------------------------------------------------------------------
-                                                             WB4APR
-14 Nov 16 Added APINxx for PinPoint by AB0WV
-09 Nov 16 added APNICx for SQ5EKU http://sq5eku.blogspot.com/
-24 Oct 16 added APTKPT TrackPoint N0LP, removed APZTKP
-24 Aug 16 added APK004 for Kenwood THD-74
-29 Apr 16 added APFPRS for FreeDV by Jeroen PE1RXQ
-25 Feb 16 Added APCDS0 for Leon Lessing ZS6LMG's cell tracker
-21 Jan 16 added APDNOx for APRSduino by DO3SWW
-18 Nov 15 Added APSTPO for N0AGI
-03 Nov 15 Updated APAND1 and APDRxx for androids
-26 Oct 15 added APZ247 for UPRS
-09 Sep 15 added APHTxx for HMTracker by IU0AAC 
-06 Aug 15 added APMTxx for LZ1PPL for tracker
-27 Apr 15 added APZMAJ for Martyn M1MAJ DeLorme inReach Tracker
-21 Apr 15 added APB2MF & APR2MF DL2MF - MF2APRS Radiosonde   
-06 Apr 15 added APAVT5 SainSonic AP510 - a 1watt tracker 
-. . . . . ...
-11 Jan 12 added APYTxx for YagTracker and updated Yaesu APY008/350
+<title>
+APRS TO-CALL VERSION NUMBERS                              14 Dec 2021
+---------------------------------------------------------------------
+                                                               WB4APR
+</title>
+<version_notes>
+07 Jun 23 Added APK005 for Kenwood TH-D75
+14 Dec 21 Added APATAR ATA-R APRS Digipeater by TA7W/OH2UDS and TA6AEU
+26 Sep 21 Added APRRDZ EPS32 https://github.com/dl9rdz/rdz_ttgo_sonde
+18 Sep 21 Added APCSS  for AMSAT Cubesat Simulator https://cubesatsim.org
+16 Sep 21 Added APY05D for Yaesu FT5D series
+04 Sep 21 APLOxx  LoRa KISS TNC/Tracker https://github.com/SQ9MDD/TTGO-T-Beam-LoRa-APRS
+24 Aug 21 Added APLSxx SARIMESH http://www.sarimesh.net  
+22 Aug 21 Added APE2Ax for VA3NNW's Email-2-APRS ap
+30 Jun 21 Added APCNxx for carNET by DG5OAW
+14 Jun 21 Added APN2xx for NOSaprs JNOS 2.0 - VE4KLM
+24 Apr 21 Added APMPAD for DF1JSL's WXBot clone and extension
+20 Apr 21 Added APLCxx for APRScube by DL3DCW
+19 Apr 21 Added APVMxx for DRCC-DVM Voice (Digital Radio China Club)     
+13 Apr 21 Added APIxxx for all Dstar ICOMS (APRS via DPRS)
+23 MAr 20 Added APW9xx For 9A9Y Weather Tracker
+16 Feb 21 Added API970 for I com 9700
+
+2020 Added APHBLx,APIZCI,APLGxx,APLTxx,APNVxx,APY300,APESPG,APESPW
+           APGDTx,APOSWx,APOSBx,APBT62,APCLUB,APMQxx
+2019 Added APTPNx,APJ8xx,APBSDx,APNKMX,APAT51,APMGxx,APTCMA,
+           APATxx,APQTHx,APLIGx 
+2018 added APRARX,APELKx,APGBLN,APBKxx,APERSx,APTCHE
+2017 Added APHWxx,APDVxx,APPICO,APBMxx,APP6xx,APTAxx,APOCSG,APCSMS,
+           APPMxx,APOFF,APDTMF,APRSON,APDIGI,APSAT,APTBxx,APIExx,
+           APSFxx
+2016 added APYSxx,APINxx,APNICx,APTKPT,APK004,APFPRS,APCDS0,APDNOx
+2015 Added APSTPO,APAND1,APDRxx,APZ247,APHTxx,APMTxx,APZMAJ
+           APB2MF,APR2MF,APAVT5
+
+</version_notes>
+<description>
 
 In APRS, the AX.25  Destination address is not used for packet 
 routing as is normally done in AX.25.  So APRS uses it for two 
@@ -28,6 +45,13 @@ bytes of the field are available to indicate the software version
 number or application.  The following applications have requested 
 a TOCALL number series:
 
+Authors with similar alphabetic requirements are encouraged to share
+their address space with other software.  Work out agreements amongst
+yourselves and keep me informed.
+
+</description>
+<tocalls>
+
  APn  3rd digit is a number
       AP1WWX  TAPR T-238+ WX station
       AP1MAJ  Martyn M1MAJ DeLorme inReach Tracker
@@ -42,18 +66,30 @@ a TOCALL number series:
       APAHxx  AHub
       APAND1  APRSdroid (pre-release) http://aprsdroid.org/
       APAMxx  Altus Metrum GPS trackers
+      APATAR  ATA-R APRS Digipeater by TA7W/OH2UDS and TA6AEU
+      APAT8x  for Anytone. 81 for 878 HT 
+      APAT51  for Anytone AT-D578UV APRS mobile radio 
       APAVT5  SainSonic AP510 which is a 1watt tracker
       APAWxx  AGWPE 
  APB  APBxxx  Beacons or Rabbit TCPIP micros?
       APB2MF  DL2MF - MF2APRS Radiosonde for balloons
       APBLxx  BigRedBee BeeLine  
       APBLO   MOdel Rocketry K7RKT
-      APBPQx  John G8BPQ Digipeater/IGate 
+      APBKxx  PY5BK Bravo Tracker in Brazil
+      APBPQx  John G8BPQ Digipeater/IGate
+      APBMxx  BrandMeister DMR Server for R3ABM
+      APBSDx  HamBSD https://hambsd.org/
+      APBT62  BTech DMR 6x2 
  APC  APCxxx  Cellular applications
-      APCBBx  for VE7UDP Blackberry Applications
+      APCBBx  VE7UDP Blackberry Applications
+      APCDS0  Leon Lessing ZS6LMG's cell tracker
       APCLEY  EYTraker GPRS/GSM tracker by ZS6EY
-      APCLWX  EYWeather GPRS/GSM WX station by ZS6EY
       APCLEZ  Telit EZ10 GSM application ZS6CEY
+      APCLUB  Brazil APRS network
+      APCLWX  EYWeather GPRS/GSM WX station by ZS6EY
+      APCNxx  for carNET by DG5OAW
+      APCSMS  for Cosmos (used for sending commands @USNA)
+      APCSS   for AMSAT cubesats https://cubesatsim.org
       APCWP8  John GM7HHB, WinphoneAPRS
       APCYxx  Cybiko applications
  APD  APD4xx  UP4DAR platform
@@ -62,6 +98,8 @@ a TOCALL number series:
       APDGxx  D-Star Gateways by G4KLX ircDDB
       APDHxx  WinDV (DUTCH*Star DV Node for Windows)
       APDInn  DIXPRS - Bela, HA5DI
+      APDIGI  Used by PSAT2 to indicate the digi is ON
+      APDIGI  digi ON for PSAT2 and QIKCOM-2
       APDKxx  KI4LKF g2_ircddb Dstar gateway software
       APDNOx  APRSduino by DO3SWW
       APDOxx  ON8JL Standalone DStar Node
@@ -69,24 +107,49 @@ a TOCALL number series:
       APDRxx  APRSdroid Android App http://aprsdroid.org/
       APDSXX  SP9UOB for dsDigi and ds-tracker
       APDTxx  APRStouch Tone (DTMF)
+      APDTMF  digi off mode on QIKCOM2 and DTMF ON
       APDUxx  U2APRS by JA7UDE
+      APDVxx  OE6PLD's SSTV with APRS status exchange
       APDWxx  DireWolf, WB2OSZ
  APE  APExxx  Telemetry devices
+      APE2Ax  VA3NNW's Email-2-APRS ap
       APECAN  Pecan Pico APRS Balloon Tracker
+      APELKx  WB8ELK balloons
       APERXQ  Experimental tracker by PE1RXQ
+      APERSx  Runner tracking by Jason,KG7YKZ
+      APESPG  ESP SmartBeacon APRS-IS Client
+      APESPW  ESP Weather Station APRS-IS Client
  APF  APFxxx  Firenet
       APFGxx  Flood Gage (KP4DJT)
       APFIxx  for APRS.FI OH7LZB, Hessu
       APFPRS  for FreeDV by Jeroen PE1RXQ
  APG  APGxxx  Gates, etc
       APGOxx  for AA3NJ PDA application
+      APGBLN  for NW5W's GoBalloon
+      APGDTx  for VK4FAST's Graphic Data Terminal
  APH  APHKxx  for LA1BR tracker/digipeater
       APHAXn  SM2APRS by PY2UEP
+      APHBLx  for DMR Gateway by Eric - KF7EEL
       APHTxx  HMTracker by IU0AAC 
- API  APICQx  for ICQ
-      APICxx  for HA9MCQ Pic IGate
-      APINxx for PinPoint by AB0WV
- APJ  APJAxx  JavAPRS
+      APHWxx  for use in "HamWAN
+ API  API282  for ICOM IC-2820
+      API31   for ICOM ID-31
+      API410  for ICOM ID-4100
+      API51   for ICOM ID-51
+      API510  for ICOM ID-5100
+      API710  for ICOM IC-7100
+      API80   for ICOM IC-80
+      API880  for ICOM ID-880
+      API910  for ICOM IC-9100
+      API92   for ICOM IC-92      
+      API970  for ICOM 9700
+      APICQx  for ICQ
+      APICxx  HA9MCQ's Pic IGate
+      APIExx  W7KMV's PiAPRS system
+      APINxx  PinPoint by AB0WV
+      APIZCI  hymTR IZCI Tracker by TA7W/OH2UDS and TA6AEU
+ APJ  APJ8xx  Jordan / KN4CRD JS8Call application
+      APJAxx  JavAPRS
       APJExx  JeAPRS
       APJIxx  jAPRSIgate
       APJSxx  javAPRSSrvr
@@ -94,16 +157,26 @@ a TOCALL number series:
  APK  APK0xx  Kenwood TH-D7's
       APK003  Kenwood TH-D72
       APK004  Kenwood TH-D74
+      APK005  Kenwood TH-D75
       APK1xx  Kenwood D700's
       APK102  Kenwood D710
       APKRAM  KRAMstuff.com - Mark. G7LEU
- APL  APLQRU  Charlie - QRU Server
+ APL  APLCxx  APRScube by DL3DCW
+      APLGxx  LoRa Gateway/Digipeater OE5BPA
+      APLIGx  LightAPRS - TA2MUN and TA9OHC
+      APLOxx  LoRa KISS TNC/Tracker
+      APLQRU  Charlie - QRU Server
       APLMxx  WA0TQG transceiver controller
+      APLSxx  SARIMESH  ( http://www.sarimesh.net ) 
+      APLTxx  LoRa Tracker - OE5BPA
  APM  APMxxx  MacAPRS, 
-      APMGxx  MiniGate - Alex, AB0TJ
+      APMGxx  PiCrumbs and MiniGate - Alex, AB0TJ
       APMIxx  SQ3PLX http://microsat.com.pl/
+      APMPAD  DF1JSL's WXBot clone and extension
+      APMQxx  Ham Radio of Things WB2OSZ
       APMTxx  LZ1PPL for tracker
  APN  APNxxx  Network nodes, digis, etc
+      APN2xx  NOSaprs for JNOS 2.0 - VE4KLM
       APN3xx  Kantronics KPC-3 rom versions
       APN9xx  Kantronics KPC-9612 Roms
       APNAxx  WB6ZSU's APRServe
@@ -112,23 +185,34 @@ a TOCALL number series:
       APNK01  Kenwood D700 (APK101) type
       APNK80  KAM version 8.0
       APNKMP  KAM+
+      APNKMX  KAM-XL
       APNMxx  MJF TNC roms
       APNPxx  Paccom TNC roms
       APNTxx  SV2AGW's TNT tnc as a digi
       APNUxx  UIdigi
+      APNVxx  SQ8L's VP digi and Nodes
       APNXxx  TNC-X  (K6DBG)
       APNWxx  SQ3FYK.com WX/Digi and SQ3PLX http://microsat.com.pl/
  APO  APRSpoint
+      APOFF   Used by PSAT and PSAT2 to indicate the digi is OFF
       APOLUx  for OSCAR satellites for AMSAT-LU by LU9DO
       APOAxx  OpenAPRS - Greg Carter
-      APOTxx  Open Track
+      APOCSG  For N0AGI's APRS to POCSAG project
       APOD1w  Open Track with 1 wire WX
+      APOSBx  openSPOT3 by HA2NON at sharkrf.com
+      APOSWx  openSPOT2
+      APOTxx  Open Track
       APOU2k  Open Track for Ultimeter
       APOZxx  www.KissOZ.dk Tracker. OZ1EKD and OZ7HVO
- APP  APPTxx  KetaiTracker by  JF6LZE, Takeki (msg capable)
+ APP  APP6xx  for APRSlib
+      APPICx  DB1NTO' PicoAPRS 
+      APPMxx  DL1MX's RTL-SDR pytohon Igate
+      APPTxx  KetaiTracker by  JF6LZE, Takeki (msg capable)
  APQ  APQxxx  Earthquake data
+      APQTHx  W8WJB's QTH.app
  APR  APR8xx  APRSdos versions 800+
       APR2MF  DL2MF - MF2APRS Radiosonde WX reporting
+      APRARX  VK5QI's radiosonde tracking
       APRDxx  APRSdata, APRSdr
       APRGxx  aprsg igate software, OH2GVE
       APRHH2  HamHud 2
@@ -136,14 +220,17 @@ a TOCALL number series:
       APRNOW  W5GGW ipad application
       APRRTx  RPC electronics
       APRS    Generic, (obsolete. Digis should use APNxxx instead)
+      APRSON  Used by PSAT to indicate the DIGI is ON
       APRXxx  >40 APRSmax
-      APRXxx  <39 for OH2MQK's RX-igate
+      APRXxx  <39 for OH2MQK's igate
       APRTLM  used in MIM's and Mic-lites, etc
       APRtfc  APRStraffic
       APRSTx  APRStt (Touch tone)
  APS  APSxxx  APRS+SA, etc
       APSARx  ZL4FOX's SARTRACK
+      APSAT   digi ON for QIKCOM-1
       APSCxx  aprsc APRS-IS core server (OH7LZB, OH2MQK)
+      APSFxx  F5OPV embedded devices - was APZ40
       APSK63  APRS Messenger -over-PSK63
       APSK25  APRS Messenger GMSK-250
       APSMSx  Paul Dufresne's SMSGTE - SMS Gateway
@@ -152,8 +239,12 @@ a TOCALL number series:
  APT  APT2xx  Tiny Track II
       APT3xx  Tiny Track III
       APTAxx  K4ATM's tiny track
+      APTBxx  TinyAPRS by BG5HHP Was APTAxx till Sep 2017
+      APTCHE  PU3IKE in Brazil TcheTracker/Tcheduino
+      APTCMA  CAPI tracker - PU1CMA Brazil
       APTIGR  TigerTrack
       APTKPT  TrackPoint N0LP
+      APTPNx  TARPN Packet Node Tracker by KN4ORB http://tarpn.net/ 
       APTTxx  Tiny Track
       APTWxx  Byons WXTrac
       APTVxx  for ATV/APRN and SSTV applications
@@ -162,37 +253,47 @@ a TOCALL number series:
       APU3xx  UIview terminal program
       APUDRx  NW Digital Radio's UDR (APRS/Dstar)
  APV  APVxxx  Voice over Internet  applications
+      APVMxx  DRCC-DVM Digital Voice (Digital Radio China Club)
       APVRxx  for IRLP
       APVLxx  for I-LINK
       APVExx  for ECHO link
  APW  APWxxx  WinAPRS, etc
+      APW9xx  9A9Y Weather Tracker
       APWAxx  APRSISCE Android version
       APWSxx  DF4IAN's WS2300 WX station
       APWMxx  APRSISCE KJ4ERJ
       APWWxx  APRSISCE win32 version
  APX  APXnnn  Xastir
       APXRnn  Xrouter
- APY  APYxxx  Yeasu
+ APY  APYxxx  Yaesu Radios
       APY008  Yaesu VX-8 series
-      APY350  Yaesu FTM-350 series
-      APYTxx  for YagTracker
+      APY01D  Yaesu FT1D series
+      APY02D  Yaesu FT2D series
+      APY03D  Yaesu FT3D series
+      APY05D  Yaesu FT5D series
+      APY100  Yaesu FTM-100D series
+      APY300  Yaesu FTM-300D series
+      APY350  Yaesu FTM-350  series
+      APY400  Yaesu FTM-400D series
  APZ  APZxxx  Experimental
+      APZ200  old versions of JNOS 
       APZ247  for UPRS NR0Q
       APZ0xx  Xastir (old versions. See APX)
       APZMAJ  Martyn M1MAJ DeLorme inReach Tracker
+      APZMDM  github/codec2_talkie  - product code not registered
       APZMDR  for HaMDR trackers - hessu * hes.iki.fi]
       APZPAD  Smart Palm 
       APZTKP  TrackPoint, Nick N0LP (Balloon tracking)(depricated)
       APZWIT  MAP27 radio (Mountain Rescue) EI7IG
       APZWKR  GM1WKR NetSked application
+</tocalls>
+<notes>
 
-Authors with similar alphabetic requirements are encouraged to share
-their address space with other software.  Work out agreements amongst
-yourselves and keep me informed.
+</notes>
+<altnets>
 
-
-REGISTERED ALTNETS:
--------------------
+REGISTERED TOCALL ALTNETS:
+--------------------------
 
 ALTNETS are uses of the AX-25 tocall to distinguish specialized
 traffic that may be flowing on the APRS-IS, but that are not intended
@@ -215,9 +316,11 @@ The following is a list of ALTNETS that may be of interest to other
 users.  This list is by no means complete, since ANY combination of
 characters other than APxxxx are considered an ALTNET.  But this list 
 can give consisntecy to ALTNETS that may be using the global APRS-IS 
-and need some special recognition:
+and need some special recognition.  Here are some ideas:
+</altnets>
+<altnet_list>
 
-  TEST   - A generic ALTNET for use during testing
-  PSKAPR - PSKmail .  But it is not AX.25 anyway
-
-de WB4APR, Bob
+  SATERN - Salvation Army Altnet
+  AFMARS - Airforce Mars
+  AMARS  - Army Mars
+</altnet_list>

debian/README.Debian

@@ -0,0 +1,5 @@
+In order to start direwolf as a service the configuration file
+/etc/direwolf.conf needs to exist. Otherwise attempting to start the service
+returns an 'Assertion failed' error. An example configuration file which may be
+used as a model can be found in
+/usr/share/doc/direwolf/examples/direwolf.conf.gz

debian/changelog

@@ -0,0 +1 @@
+../CHANGES.md

debian/compat

@@ -0,0 +1 @@
+10

debian/control

@@ -0,0 +1,30 @@
+Source: direwolf
+Maintainer: Debian Hamradio Maintainers <debian-hams@lists.debian.org>
+Uploaders: Iain R. Learmonth <irl@debian.org>
+Section: hamradio
+Priority: optional
+Build-Depends: debhelper (>= 9),
+               libasound2-dev,
+               libgps-dev,
+               libhamlib-dev,
+	       dh-systemd
+Standards-Version: 4.1.0
+Vcs-Browser: https://anonscm.debian.org/cgit/pkg-hamradio/direwolf.git/
+Vcs-Git: https://anonscm.debian.org/git/pkg-hamradio/direwolf.git
+Homepage: https://github.com/wb2osz/direwolf
+
+Package: direwolf
+Architecture: alpha amd64 arm64 armel armhf i386 mipsel ppc64el sh4 x32
+Depends: ${shlibs:Depends},
+         ${misc:Depends},
+         adduser,
+         libhamlib2
+Suggests: gpsd, libhamlib-utils
+Breaks: direwolf-docs (<< 1.1-1)
+Replaces: direwolf-docs (<< 1.1-1)
+Description: Soundcard TNC for APRS
+ Dire Wolf is a software "soundcard" modem/TNC and APRS encoder/decoder. It can
+ be used stand-alone to receive APRS messages, 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, and many others.

debian/copyright

@@ -0,0 +1,176 @@
+Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: direwolf
+Files-Excluded: doc/*.pdf
+Source: https://github.com/wb2osz/direwolf
+Comment:
+ The files in misc/ are copied directly from the Cygwin source code. These are
+ listed here as dual licensed as they are both part of the Cygwin distribution
+ and originally part of BSD. See misc/README-dire-wolf.txt for more information.
+ .
+ Please see ftp-master's comments on this here:
+ https://lists.debian.org/debian-hams/2014/09/msg00063.html
+ https://lists.debian.org/debian-hams/2014/10/msg00003.html
+
+Files: *
+Copyright: (C) 2011-2014 John Langner WB2OSZ
+License: GPL-2+
+
+Files: geotranz/*
+Copyright: National Geospatial-Intelligence Agency
+License: Permissive-NGA
+
+Files: regex/*
+Copyright: (C) 2002, 2003, 2005 Free Software Foundation, Inc.
+License: LGPL-2.1+
+
+Files: misc/strcasestr.c
+Copyright:
+ (C) 1990, 1993 The Regents of the University of California
+ (C) RedHat
+License: BSD-4-clause or GPL-2+
+
+Files: misc/strtok_r.c misc/strsep.c
+Copyright:
+ (C) 1988 Regents of the University of California
+ (C) RedHat
+License: BSD-3-clause or GPL-2+
+
+Files: debian/*
+Copyright: (C) 2014 Iain R. Learmonth <irl@fsfe.org>
+License: GPL-2+
+
+License: BSD-3-clause
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ .
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ .
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+ .
+ 3. Neither the name of the University nor the names of its contributors
+    may be used to endorse or promote products derived from this software
+    without specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+License: BSD-4-clause
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ .
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ .
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+ .
+ 3. All advertising materials mentioning features or use of this software
+    must display the following acknowledgement:
+        This product includes software developed by the University of
+        California, Berkeley and its contributors.
+ .
+ 4. Neither the name of the University nor the names of its contributors
+    may be used to endorse or promote products derived from this software
+    without specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+License: GPL-2+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 2 of the License, or
+ (at your option) any later version.
+ .
+ This program 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.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ .
+ On Debian systems, a copy of the full license text is available in
+ /usr/share/common-licenses/GPL-2.
+
+License: LGPL-2.1+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+ .
+ This library 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
+ Lesser General Public License for more details.
+ .
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ .
+ On Debian systems, a copy of the full license text is available in
+ /usr/share/common-licenses/LGPL-2.1.
+
+License: Permissive-NGA
+ 1. The GEOTRANS source code ("the software") is provided free of charge by the
+ National Geospatial-Intelligence Agency (NGA) of the United States Department
+ of Defense. Although NGA makes no copyright claim under Title 17 U.S.C., NGA
+ claims copyrights in the source code under other legal regimes. NGA hereby
+ grants to each user of the software a license to use and distribute the
+ software, and develop derivative works.
+ .
+ 2. NGA requests that products developed using the software credit the source of
+ the software with the following statement, "The product was developed using
+ GEOTRANS, a product of the National Geospatial-Intelligence Agency (NGA) and
+ U.S. Army Engineering Research and Development Center."  Do not use the name
+ GEOTRANS for any derived work.
+ .
+ 3. Warranty Disclaimer: The software was developed to meet only the internal
+ requirements of the National Geospatial-Intelligence Agency (NGA). The software
+ is provided "as is," and no warranty, express or implied, including but not
+ limited to the implied warranties of merchantability and fitness for particular
+ purpose or arising by statute or otherwise in law or from a course of dealing
+ or usage in trade, is made by NGA as to the accuracy and functioning of the
+ software.
+ .
+ 4. NGA and its personnel are not required to provide technical support or
+ general assistance with respect to public use of the software.  Government
+ customers may contact NGA.
+ .
+ 5. Neither NGA nor its personnel will be liable for any claims, losses, or
+ damages arising from or connected with the use of the software. The user agrees
+ to hold harmless the United States National Geospatial-Intelligence Agency
+ (NGA). The user's sole and exclusive remedy is to stop using the software.
+ .
+ 6. Please be advised that pursuant to the United States Code, 10 U.S.C. 425,
+ the name of the National Geospatial-Intelligence Agency, the initials "NGA",
+ the seal of the National Geospatial-Intelligence Agency, or any colorable
+ imitation thereof shall not be used to imply approval, endorsement, or
+ authorization of a product without prior written permission from United States
+ Secretary of Defense.  Do not create the impression that NGA, the Secretary of
+ Defense or the Director of National Intelligence has endorsed any product
+ derived from GEOTRANS.

debian/direwolf.postinst

@@ -0,0 +1,33 @@
+#!/bin/sh
+
+set -e
+
+. /usr/share/debconf/confmodule
+
+add_group_if_missing() {
+    if ! getent group direwolf >/dev/null; then
+        addgroup --system --force-badname direwolf || true
+    fi
+}
+
+add_user_if_missing() {
+    if ! id -u direwolf > /dev/null 2>&1; then
+        mkdir -m 02750 -p /var/lib/direwolf
+        adduser --system --home /var/lib/direwolf \
+          --disabled-password \
+          --force-badname direwolf \
+          --ingroup direwolf
+        adduser direwolf dialout
+        chown direwolf:direwolf /var/lib/direwolf
+    fi
+}
+
+add_group_if_missing
+add_user_if_missing
+
+db_stop
+
+#DEBHELPER#
+
+exit 0
+

debian/direwolf.postrm

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+set -e
+
+case "$1" in
+    purge)
+        rm -rf /var/lib/direwolf/
+    ;;
+    remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
+    ;;
+    *)
+        echo "postrm called with unknown argument \`$1'" >&2
+        exit 1
+esac
+
+#DEBHELPER#
+
+exit 0
+

debian/rules

@@ -0,0 +1,7 @@
+#!/usr/bin/make -f
+
+%:
+	dh $@ --parallel
+
+override_dh_auto_configure:
+	dh_auto_configure -- -DFORCE_SSE=1

debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

demod_psk.c

@@ -1,852 +0,0 @@
-//
-//    This file is part of Dire Wolf, an amateur radio packet TNC.
-// 
-//    Copyright (C) 2016  John Langner, WB2OSZ
-//
-//    This program is free software: you can redistribute it and/or modify
-//    it under the terms of the GNU General Public License as published by
-//    the Free Software Foundation, either version 2 of the License, or
-//    (at your option) any later version.
-//
-//    This program 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.
-//
-//    You should have received a copy of the GNU General Public License
-//    along with this program.  If not, see <http://www.gnu.org/licenses/>.
-//
-
-
-//#define DEBUG1 1	/* display debugging info */
-
-//#define DEBUG3 1	/* print carrier detect changes. */
-
-//#define DEBUG4 1	/* capture PSK demodulator output to log files */
-
-
-
-/*------------------------------------------------------------------
- *
- * Module:      demod_psk.c
- *
- * Purpose:   	Demodulator for Phase Shift Keying (PSK).
- *
- *		This is my initial attempt at implementing a 2400 bps mode.
- *		The MFJ-2400 & AEA PK232-2400 used V.26 / Bell 201 so I will follow that precedent.
- *
- *		
- * Input:	Audio samples from either a file or the "sound card."
- *
- * Outputs:	Calls hdlc_rec_bit() for each bit demodulated.
- *
- * Current Status:	New for Version 1.4.
- *
- *		Don't know if this is correct and/or compatible with
- *		other implementations.
- *		There is a lot of stuff going on here with phase
- *		shifting, gray code, bit order for the dibit, NRZI and
- *		bit-stuffing for HDLC.  Plenty of opportunity for
- *		misinterpreting a protocol spec or just stupid mistakes.
- *
- * References:	MFJ-2400 Product description and manual:
- *
- *			http://www.mfjenterprises.com/Product.php?productid=MFJ-2400
- *			http://www.mfjenterprises.com/Downloads/index.php?productid=MFJ-2400&filename=MFJ-2400.pdf&company=mfj
- *
- *		AEA had a 2400 bps packet modem, PK232-2400.
- *
- *			http://www.repeater-builder.com/aea/pk232/pk232-2400-baud-dpsk-modem.pdf
- *
- *		There was also a Kantronics KPC-2400 that had 2400 bps.
- *
- *			http://www.brazoriacountyares.org/winlink-collection/TNC%20manuals/Kantronics/2400_modem_operators_guide@rgf.pdf
- *
- *
- *		The MFJ and AEA both use the EXAR XR-2123 PSK modem chip.
- *		The Kantronics has a P423 ???
- *
- *		Can't find the chip specs on the EXAR website so Google it.
- *
- *			http://www.komponenten.es.aau.dk/fileadmin/komponenten/Data_Sheet/Linear/XR2123.pdf
- *
- *		The XR-2123 implements the V.26 / Bell 201 standard:
- *
- *			https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-V.26-198811-I!!PDF-E&type=items
- *			https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-V.26bis-198811-I!!PDF-E&type=items
- *			https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-V.26ter-198811-I!!PDF-E&type=items
- *
- *		"bis" and "ter" are from Latin for second and third.
- *		I used the "ter" version which has phase shifts of 0, 90, 180, and 270 degrees.
- *
- *		There are other references to an alternative B which uses other multiples of 45.
- *		The XR-2123 data sheet mentions only multiples of 90.  That's what I went with.
- *
- *		The XR-2123 does not perform the scrambling as specified in V.26 so I wonder if
- *		the vendors implemented it in software or just left it out.
- *		I left out scrambling for now.  Eventually, I'd like to get my hands on an old
- *		2400 bps TNC for compatibility testing.
- *
- *		After getting QPSK working, it was not much more effort to add V.27 with 8 phases.
- *
- *			https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-V.27bis-198811-I!!PDF-E&type=items
- *			https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-V.27ter-198811-I!!PDF-E&type=items
- *
- *---------------------------------------------------------------*/
-
-#include "direwolf.h"
-
-#include <stdlib.h>
-#include <stdio.h>
-#include <math.h>
-#include <unistd.h>
-#include <sys/stat.h>
-#include <string.h>
-#include <assert.h>
-#include <ctype.h>
-
-
-#include "audio.h"
-#include "tune.h"
-#include "fsk_demod_state.h"
-#include "fsk_gen_filter.h"
-#include "hdlc_rec.h"
-#include "textcolor.h"
-#include "demod_psk.h"
-#include "dsp.h"
-
-
-/* Add sample to buffer and shift the rest down. */
-
-__attribute__((hot)) __attribute__((always_inline))
-static inline void push_sample (float val, float *buff, int size)
-{
-	memmove(buff+1,buff,(size-1)*sizeof(float));
-	buff[0] = val; 
-}
-
-
-/* FIR filter kernel. */
-
-__attribute__((hot)) __attribute__((always_inline))
-static inline float convolve (const float *__restrict__ data, const float *__restrict__ filter, int filter_size)
-{
-	float sum = 0.0;
-	int j;
-
-	for (j=0; j<filter_size; j++) {
-	    sum += filter[j] * data[j];
-	}
-
-	return (sum);
-}
-
-
-/* Might replace this with faster, lower precision version someday. */
-
-static inline float my_atan2f (float y, float x)
-{
-	if ( y == 0 && x == 0) return (0.0);		// different atan2 implementations behave differently.
-
-	return (atan2f(y,x));
-}
-
-
-/*------------------------------------------------------------------
- *
- * Name:        demod_psk_init
- *
- * Purpose:     Initialization for an psk demodulator.
- *		Select appropriate parameters and set up filters.
- *
- * Inputs:   	modem_type	- MODEM_QPSK or MODEM_8PSK.
- *
- *		samples_per_sec	- Audio sample rate.
- *
- *		bps		- Bits per second.  
- *				  Should be 2400 for V.26 but we don't enforce it.
- *				  The carrier frequency will be proportional.
- *
- *		profile		- Select different variations.  For QPSK:
- *
- *					P - Using self-correlation technique.
- *					Q - Same preceded by bandpass filter.
- *					R - Using local oscillator to derive phase.
- *					S - Same with bandpass filter.
- *
- *				  For 8-PSK:
- *
- *					T, U, V, W  same as above.
- *	
- *		D		- Pointer to demodulator state for given channel.
- *
- * Outputs:	D->ms_filter_size
- *
- * Returns:     None.
- *		
- * Bugs:	This doesn't do much error checking so don't give it
- *		anything crazy.
- *
- *----------------------------------------------------------------*/
-
-void demod_psk_init (enum modem_t modem_type, int samples_per_sec, int bps, char profile, struct demodulator_state_s *D)
-{
-	int correct_baud;	// baud is not same as bits/sec here!
-	int carrier_freq;
-	int j;
-
-
-	memset (D, 0, sizeof(struct demodulator_state_s));
-
-	D->modem_type = modem_type;
-	D->num_slicers = 1;		// Haven't thought about this yet.  Is it even applicable?
-	
-
-
-
-#ifdef TUNE_PROFILE
-	profile = TUNE_PROFILE;
-#endif
-
-	if (modem_type == MODEM_QPSK) {
-
-	  correct_baud = bps / 2;
-	  // Originally I thought of scaling it to the data rate,
-	  // e.g. 2400 bps -> 1800 Hz, but decided to make it a
-	  // constant since it is the same for V.26 and V.27.
-	  carrier_freq = 1800;
-
-#if DEBUG1
-	  dw_printf ("demod_psk_init QPSK (sample rate=%d, bps=%d, baud=%d, carrier=%d, profile=%c\n",
-		samples_per_sec, bps, correct_baud, carrier_freq, profile);
-#endif
-
-	  switch (toupper(profile)) {
-
-	    case 'P':				/* Self correlation technique. */
-
-	      D->use_prefilter = 0;		/* No bandpass filter. */
-
-	      D->lpf_baud = 0.60;
-	      D->lp_filter_len_bits = 39. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.95;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    case 'Q':				/* Self correlation technique. */
-
-	      D->use_prefilter = 1;		/* Add a bandpass filter. */
-	      D->prefilter_baud = 1.3;		
-	      D->pre_filter_len_bits = 55. * 1200. / 44100.;	
-	      D->pre_window = BP_WINDOW_COSINE;
-
-	      D->lpf_baud = 0.60;
-	      D->lp_filter_len_bits = 39. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.87;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    default:
-	      text_color_set (DW_COLOR_ERROR);
-	      dw_printf ("Invalid demodulator profile %c for v.26 QPSK.  Valid choices are P, Q, R, S.  Using default.\n", profile);
-	      // fall thru.
-
-	    case 'R':				/* Mix with local oscillator. */
-
-	      D->psk_use_lo = 1;
-
-	      D->use_prefilter = 0;		/* No bandpass filter. */
-
-	      D->lpf_baud = 0.70;
-	      D->lp_filter_len_bits = 37. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_TRUNCATED;
-
-	      D->pll_locked_inertia = 0.925;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    case 'S':				/* Mix with local oscillator. */
-
-	      D->psk_use_lo = 1;
-
-	      D->use_prefilter = 1;		/* Add a bandpass filter. */
-	      D->prefilter_baud = 0.55;		
-	      D->pre_filter_len_bits = 74. * 1200. / 44100.;	
-	      D->pre_window = BP_WINDOW_FLATTOP;
-
-	      D->lpf_baud = 0.60;
-	      D->lp_filter_len_bits = 39. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.925;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-	  }
-
-	  D->ms_filter_len_bits = 1.25;		// Delay line > 13/12 * symbol period		
-
-	  D->coffs = (int) round( (11. / 12.) * (float)samples_per_sec / (float)correct_baud );
-	  D->boffs = (int) round(               (float)samples_per_sec / (float)correct_baud );
-	  D->soffs = (int) round( (13. / 12.) * (float)samples_per_sec / (float)correct_baud );
-	}
-	else {
-
-	  correct_baud = bps / 3;
-	  carrier_freq = 1800;
-
-#if DEBUG1
-	  dw_printf ("demod_psk_init 8-PSK (sample rate=%d, bps=%d, baud=%d, carrier=%d, profile=%c\n",
-		samples_per_sec, bps, correct_baud, carrier_freq, profile);
-#endif
-
-	  switch (toupper(profile)) {
-
-
-	    case 'T':				/* Self correlation technique. */
-
-	      D->use_prefilter = 0;		/* No bandpass filter. */
-
-	      D->lpf_baud = 1.15;
-	      D->lp_filter_len_bits = 32. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.95;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    case 'U':				/* Self correlation technique. */
-
-	      D->use_prefilter = 1;		/* Add a bandpass filter. */
-	      D->prefilter_baud = 0.9;		
-	      D->pre_filter_len_bits = 21. * 1200. / 44100.;	
-	      D->pre_window = BP_WINDOW_FLATTOP;
-
-	      D->lpf_baud = 1.15;
-	      D->lp_filter_len_bits = 32. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.87;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    default:
-	      text_color_set (DW_COLOR_ERROR);
-	      dw_printf ("Invalid demodulator profile %c for v.27 8PSK.  Valid choices are T, U, V, W.  Using default.\n", profile);
-	      // fall thru.
-
-	    case 'V':				/* Mix with local oscillator. */
-
-	      D->psk_use_lo = 1;
-
-	      D->use_prefilter = 0;		/* No bandpass filter. */
-
-	      D->lpf_baud = 0.85;
-	      D->lp_filter_len_bits = 31. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.925;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-
-	    case 'W':				/* Mix with local oscillator. */
-
-	      D->psk_use_lo = 1;
-
-	      D->use_prefilter = 1;		/* Add a bandpass filter. */
-	      D->prefilter_baud = 0.85;		
-	      D->pre_filter_len_bits = 31. * 1200. / 44100.;	
-	      D->pre_window = BP_WINDOW_COSINE;
-
-	      D->lpf_baud = 0.85;
-	      D->lp_filter_len_bits = 31. * 1200. / 44100.;
-	      D->lp_window = BP_WINDOW_COSINE;
-
-	      D->pll_locked_inertia = 0.925;
-	      D->pll_searching_inertia = 0.50;
-
-	      break;
-	  }
-
-	  D->ms_filter_len_bits = 1.25;		// Delay line > 10/9 * symbol period		
-
-	  D->coffs = (int) round( (8. / 9.)  * (float)samples_per_sec / (float)correct_baud );
-	  D->boffs = (int) round(              (float)samples_per_sec / (float)correct_baud );
-	  D->soffs = (int) round( (10. / 9.) * (float)samples_per_sec / (float)correct_baud );
-	}
-
-
-	if (D->psk_use_lo) {
-	  D->lo_step = (int) round( 256. * 256. * 256. * 256. * carrier_freq / (float)samples_per_sec);
-
-	  assert (MAX_FILTER_SIZE >= 256);
-	  for (j = 0; j < 256; j++) {
-	    D->m_sin_table[j] = sinf(2. * M_PI * j / 256.);
-	  }
-	}
-
-#ifdef TUNE_PRE_BAUD
-	D->prefilter_baud = TUNE_PRE_BAUD;
-#endif
-#ifdef TUNE_PRE_WINDOW
-	D->pre_window = TUNE_PRE_WINDOW;
-#endif
-
-
-
-#ifdef TUNE_LPF_BAUD
-	D->lpf_baud = TUNE_LPF_BAUD;
-#endif
-#ifdef TUNE_LP_WINDOW
-	D->lp_window = TUNE_LP_WINDOW;
-#endif
-
-
-#ifdef TUNE_HYST
-	D->hysteresis = TUNE_HYST;
-#endif
-
-#if defined(TUNE_PLL_SEARCHING)
-	D->pll_searching_inertia = TUNE_PLL_SEARCHING;
-#endif
-#if defined(TUNE_PLL_LOCKED)
-	D->pll_locked_inertia = TUNE_PLL_LOCKED;
-#endif
-
-
-/*
- * Calculate constants used for timing.
- * The audio sample rate must be at least a few times the data rate.
- */
-
-	D->pll_step_per_sample = (int) round((TICKS_PER_PLL_CYCLE * (double)correct_baud) / ((double)samples_per_sec));
-
-/*
- * Convert number of symbol times to number of taps.
- */
-
-	D->pre_filter_size = (int) round( D->pre_filter_len_bits * (float)samples_per_sec / (float)correct_baud );
-	D->ms_filter_size  = (int) round( D->ms_filter_len_bits * (float)samples_per_sec / (float)correct_baud );
-	D->lp_filter_size =  (int) round( D->lp_filter_len_bits * (float)samples_per_sec / (float)correct_baud );
-
-
-#ifdef TUNE_PRE_FILTER_SIZE
-	D->pre_filter_size = TUNE_PRE_FILTER_SIZE;
-#endif
-
-#ifdef TUNE_LP_FILTER_SIZE
-	D->lp_filter_size = TUNE_LP_FILTER_SIZE;
-#endif
-
-
-	if (D->pre_filter_size > MAX_FILTER_SIZE) 
-	{
-	  text_color_set (DW_COLOR_ERROR);
-	  dw_printf ("Calculated filter size of %d is too large.\n", D->pre_filter_size);
-	  dw_printf ("Decrease the audio sample rate or increase the baud rate or\n");
-	  dw_printf ("recompile the application with MAX_FILTER_SIZE larger than %d.\n",
-							MAX_FILTER_SIZE);
-	  exit (1);
-	}
-
-	if (D->ms_filter_size > MAX_FILTER_SIZE) 
-	{
-	  text_color_set (DW_COLOR_ERROR);
-	  dw_printf ("Calculated filter size of %d is too large.\n", D->ms_filter_size);
-	  dw_printf ("Decrease the audio sample rate or increase the baud rate or\n");
-	  dw_printf ("recompile the application with MAX_FILTER_SIZE larger than %d.\n",
-							MAX_FILTER_SIZE);
-	  exit (1);
-	}
-
-	if (D->lp_filter_size > MAX_FILTER_SIZE) 
-	{
-	  text_color_set (DW_COLOR_ERROR);
-	  dw_printf ("Calculated filter size of %d is too large.\n", D->pre_filter_size);
-	  dw_printf ("Decrease the audio sample rate or increase the baud rate or\n");
-	  dw_printf ("recompile the application with MAX_FILTER_SIZE larger than %d.\n",
-							MAX_FILTER_SIZE);
-	  exit (1);
-	}
-
-/* 
- * Optionally apply a bandpass ("pre") filter to attenuate
- * frequencies outside the range of interest.
- */
-
-	if (D->use_prefilter) {
-	  float f1, f2;
-
-	  f1 = carrier_freq - D->prefilter_baud * correct_baud;
-	  f2 = carrier_freq + D->prefilter_baud * correct_baud;
-#if 0
-	  text_color_set(DW_COLOR_DEBUG);
-	  dw_printf ("Generating prefilter %.0f to %.0f Hz.\n", f1, f2);
-#endif
-	  if (f1 <= 0) {
-	    text_color_set (DW_COLOR_ERROR);
-	    dw_printf ("Prefilter of %.0f to %.0f Hz doesn't make sense.\n", f1, f2);
-	    f1 = 10;
-	  }
-
-	  f1 = f1 / (float)samples_per_sec;
-	  f2 = f2 / (float)samples_per_sec;
-	  
-	  gen_bandpass (f1, f2, D->pre_filter, D->pre_filter_size, D->pre_window);
-	}
-
-/*
- * Now the lowpass filter.
- */
-
-	float fc = correct_baud * D->lpf_baud / (float)samples_per_sec;
-	gen_lowpass (fc, D->lp_filter, D->lp_filter_size, D->lp_window);
-
-/*
- * No point in having multiple numbers for signal level.
- */
-
-	D->alevel_mark_peak = -1;
-	D->alevel_space_peak = -1;
-
-}  /* demod_psk_init */
-
-
-
-
-/*-------------------------------------------------------------------
- *
- * Name:        demod_psk_process_sample
- *
- * Purpose:     (1) Demodulate the psk signal into I & Q components.
- *		(2) Recover clock and sample data at the right time.
- *		(3) Produce two bits per symbol based on phase change from previous.
- *
- * Inputs:	chan	- Audio channel.  0 for left, 1 for right.
- *		subchan - modem of the channel.
- *		sam	- One sample of audio.
- *			  Should be in range of -32768 .. 32767.
- *
- * Outputs:	For each recovered data bit, we call:
- *
- *			  hdlc_rec (channel, demodulated_bit);
- *
- *		to decode HDLC frames from the stream of bits.
- *
- * Returns:	None 
- *
- * Descripion:	All the literature, that I could find, described mixing
- *		with a local oscillator.  First we multiply the input by
- *		cos and sin then low pass filter each.  This gives us
- *		correlation to the different phases.  The signs of these two
- *		results produces two data bits per symbol period.
- *
- *		An 1800 Hz local oscillator was derived from the 1200 Hz
- *		PLL used to sample the data.
- *		This worked wonderfully for the ideal condition where
- *		we start off with the proper phase and all the timing
- *		is perfect.  However, when random delays were added
- *		before the frame, the PLL would lock on only about 
- *		half the time.
- *
- *		Late one night, it dawned on me that there is no
- *		need for a local oscillator (LO) at the carrier frequency.
- *		Simply correlate the signal with the previous symbol,
- *		phase shifted by + and - 45 degrees.
- *		The code is much simpler and very reliable.
- *
- *		Later, I realized it was not necessary to synchronize the LO
- *		because we only care about the phase shift between symbols.
- *
- *		This works better under noisy conditions because we are
- *		including the noise from only the current symbol and not
- *		the previous one.
- *
- *		Finally, once we know how to distinguish 4 different phases,
- *		it is not much effort to use 8 phases to double the bit rate.
- *
- *--------------------------------------------------------------------*/
-
-
-
-static void inline nudge_pll (int chan, int subchan, int slice, int demod_bits, struct demodulator_state_s *D);
-
-__attribute__((hot))
-void demod_psk_process_sample (int chan, int subchan, int sam, struct demodulator_state_s *D)
-{
-	float fsam;
-	float sam_x_cos, sam_x_sin;
-	float I, Q;
-	int demod_phase_shift;		// Phase shift relative to previous symbol.
-					// range 0-3, 1 unit for each 90 degrees.
-	int slice = 0;
-
-#if DEBUG4
-	static FILE *demod_log_fp = NULL;
-	static int log_file_seq = 0;		/* Part of log file name */
-#endif
-
-
-	assert (chan >= 0 && chan < MAX_CHANS);
-	assert (subchan >= 0 && subchan < MAX_SUBCHANS);
-
-
-	/* Scale to nice number for plotting during debug. */
-
-	fsam = sam / 16384.0f;
-
-
-/*
- * Optional bandpass filter before the phase detector.
- */
-
-	if (D->use_prefilter) {
-	  push_sample (fsam, D->raw_cb, D->pre_filter_size);
-	  fsam = convolve (D->raw_cb, D->pre_filter, D->pre_filter_size);
-	}
-
-	if (D->psk_use_lo) {
-	  float a, delta;
-	  int id;
-/*
- * Mix with local oscillator to obtain phase.
- * The absolute phase doesn't matter.  
- * We are just concerned with the change since the previous symbol.
- */
-
-	  sam_x_cos = fsam * D->m_sin_table[((D->lo_phase >> 24) + 64) & 0xff];
-
-	  sam_x_sin = fsam * D->m_sin_table[(D->lo_phase >> 24) & 0xff];
-
-	  push_sample (sam_x_cos, D->m_amp_cb, D->lp_filter_size);
-	  I = convolve (D->m_amp_cb, D->lp_filter, D->lp_filter_size);
-
-	  push_sample (sam_x_sin, D->s_amp_cb, D->lp_filter_size);
-	  Q = convolve (D->s_amp_cb, D->lp_filter, D->lp_filter_size);
-
-	  a = my_atan2f(I,Q);
-	  push_sample (a, D->ms_in_cb, D->ms_filter_size);
-
-	  delta = a - D->ms_in_cb[D->boffs];
-
-	  /* 256 units/cycle makes modulo processing easier. */
-	  /* Make sure it is positive before truncating to integer. */
-
-	  id = ((int)((delta / (2.f * M_PI) + 1.f) * 256.f)) & 0xff;
-	  
-	  if (D->modem_type == MODEM_QPSK) {
-	    demod_phase_shift = ((id + 32) >> 6) & 0x3;
-	  }
-	  else {
-	    demod_phase_shift = ((id + 16) >> 5) & 0x7;
-	  }
-	  nudge_pll (chan, subchan, slice, demod_phase_shift, D);
-
-	  D->lo_phase += D->lo_step;
-	}
-	else {
-/*
- * Correlate with previous symbol.  We are looking for the phase shift.
- */
-	  push_sample (fsam, D->ms_in_cb, D->ms_filter_size);
-
-	  sam_x_cos = fsam *  D->ms_in_cb[D->coffs];
-	  sam_x_sin = fsam *  D->ms_in_cb[D->soffs];
-
-	  push_sample (sam_x_cos, D->m_amp_cb, D->lp_filter_size);
-	  I = convolve (D->m_amp_cb, D->lp_filter, D->lp_filter_size);
-
-	  push_sample (sam_x_sin, D->s_amp_cb, D->lp_filter_size);
-	  Q = convolve (D->s_amp_cb, D->lp_filter, D->lp_filter_size);
-
-	  if (D->modem_type == MODEM_QPSK) {
-
-#if 1				// Speed up special case.		
-	    if (I > 0) {
-	      if (Q > 0)
-	        demod_phase_shift = 0;	/* 0 to 90 degrees, etc. */
-	      else
-	        demod_phase_shift = 1;
-	    }
-	    else {
-	      if (Q > 0)
-	        demod_phase_shift = 3;
-	      else
-	        demod_phase_shift = 2;
-	    }
-#else
-	    a = my_atan2f(I,Q);
-	    int id = ((int)((a / (2.f * M_PI) + 1.f) * 256.f)) & 0xff;
-	    // 128 compensates for 180 degree phase shift due
-	    // to 1 1/2 carrier cycles per symbol period.
-	    demod_phase_shift = ((id + 128) >> 6) & 0x3;
-#endif
-	  }
-	  else {
-	    float a;
-	    int idelta;
-
-	    a = my_atan2f(I,Q);
-	    idelta = ((int)((a / (2.f * M_PI) + 1.f) * 256.f)) & 0xff;
-	    // 32 (90 degrees) compensates for 1800 carrier vs. 1800 baud.
-	    // 16 is to set threshold between constellation points.
-	    demod_phase_shift = ((idelta - 32 - 16) >> 5) & 0x7;
-	  }
-
-	  nudge_pll (chan, subchan, slice, demod_phase_shift, D);
-	}
-
-#if DEBUG4
-
-	if (chan == 0) {
-
-	  if (1) {
-	  //if (hdlc_rec_gathering (chan, subchan, slice)) {
-	    char fname[30];
-
-	  
-	    if (demod_log_fp == NULL) {
-	      log_file_seq++;
-	      snprintf (fname, sizeof(fname), "demod/%04d.csv", log_file_seq);
-	      //if (log_file_seq == 1) mkdir ("demod", 0777);
-	      if (log_file_seq == 1) mkdir ("demod");
-
-	      demod_log_fp = fopen (fname, "w");
-	      text_color_set(DW_COLOR_DEBUG);
-	      dw_printf ("Starting demodulator log file %s\n", fname);
-	      fprintf (demod_log_fp, "Audio, sin,  cos,  *cos, *sin,   I,    Q, phase, Clock\n");
-	    }
-
-	    fprintf (demod_log_fp, "%.3f, %.3f, %.3f, %.3f, %.3f, %.3f, %.2f, %.2f, %.2f\n", 
-			fsam + 2,
-			- D->ms_in_cb[D->soffs] + 6,
-			- D->ms_in_cb[D->coffs] + 6,
-			sam_x_cos + 8,
-			sam_x_sin + 10, 
-			2 * I + 12,
-			2 * Q + 12,
-			demod_phase_shift * 2. / 3. + 14.,
-			(D->slicer[slice].data_clock_pll & 0x80000000) ? .5 : .0);
-
-	    fflush (demod_log_fp);
-	  }
-	  else {
-	    if (demod_log_fp != NULL) {
-	      fclose (demod_log_fp);
-	      demod_log_fp = NULL;
-	    }
-	  }
-	}
-#endif
-
-
-} /* end demod_psk_process_sample */
-
-static const int phase_to_gray_v26[4] = {0, 1, 3, 2};	
-static const int phase_to_gray_v27[8] = {1, 0, 2, 3, 7, 6, 4, 5};	
-
-
-
-__attribute__((hot))
-static void inline nudge_pll (int chan, int subchan, int slice, int demod_bits, struct demodulator_state_s *D)
-{
-
-/*
- * Finally, a PLL is used to sample near the centers of the data bits.
- *
- * D points to a demodulator for a channel/subchannel pair so we don't
- * have to keep recalculating it.
- *
- * D->data_clock_pll is a SIGNED 32 bit variable.
- * When it overflows from a large positive value to a negative value, we 
- * sample a data bit from the demodulated signal.
- *
- * Ideally, the the demodulated signal transitions should be near
- * zero we we sample mid way between the transitions.
- *
- * Nudge the PLL by removing some small fraction from the value of 
- * data_clock_pll, pushing it closer to zero.
- * 
- * This adjustment will never change the sign so it won't cause
- * any erratic data bit sampling.
- *
- * If we adjust it too quickly, the clock will have too much jitter.
- * If we adjust it too slowly, it will take too long to lock on to a new signal.
- *
- * Be a little more agressive about adjusting the PLL
- * phase when searching for a signal.
- * Don't change it as much when locked on to a signal.
- *
- * I don't think the optimal value will depend on the audio sample rate
- * because this happens for each transition from the demodulator.
- */
-
-
-	D->slicer[slice].prev_d_c_pll = D->slicer[slice].data_clock_pll;
-
-	D->slicer[slice].data_clock_pll += D->pll_step_per_sample;
-
-	if (D->slicer[slice].data_clock_pll < 0 && D->slicer[slice].prev_d_c_pll >= 0) {
-
-	  /* Overflow of PLL counter. */
-	  /* This is where we sample the data. */
-
-	  if (D->modem_type == MODEM_QPSK) {
-
-	    int gray = phase_to_gray_v26[ demod_bits ];
-
-#if DEBUG4
-	    text_color_set(DW_COLOR_DEBUG);
-
-	    dw_printf ("a=%.2f deg, delta=%.2f deg, phaseshift=%d, bits= %d %d \n", 
-		a * 360 / (2*M_PI), delta * 360 / (2*M_PI), demod_bits, (gray >> 1) & 1, gray & 1);
-
-	    //dw_printf ("phaseshift=%d, bits= %d %d \n", demod_bits, (gray >> 1) & 1, gray & 1);
-#endif
-	    hdlc_rec_bit (chan, subchan, slice, (gray >> 1) & 1, 0, -1);
-	    hdlc_rec_bit (chan, subchan, slice, gray & 1, 0, -1);
-	  }
-	  else {
-	    int gray = phase_to_gray_v27[ demod_bits ];
-
-	    hdlc_rec_bit (chan, subchan, slice, (gray >> 2) & 1, 0, -1);
-	    hdlc_rec_bit (chan, subchan, slice, (gray >> 1) & 1, 0, -1);
-	    hdlc_rec_bit (chan, subchan, slice, gray & 1, 0, -1);
-	  }
-	}
-
-/*
- * If demodulated data has changed,
- * pull the PLL phase closer to zero.
- */
-
-        if (demod_bits != D->slicer[slice].prev_demod_data) {
-
-	  if (hdlc_rec_gathering (chan, subchan, slice)) {
-	    D->slicer[slice].data_clock_pll = (int)floor((double)(D->slicer[slice].data_clock_pll) * D->pll_locked_inertia);
-	  }
-	  else {
-	    D->slicer[slice].data_clock_pll = (int)floor((double)(D->slicer[slice].data_clock_pll) * D->pll_searching_inertia);
-	  }
-	}
-
-/*
- * Remember demodulator output so we can compare next time.
- */
-	D->slicer[slice].prev_demod_data = demod_bits;
-
-} /* end nudge_pll */
-
-
-
-/* end demod_psk.c */

demod_psk.h

@@ -1,7 +0,0 @@
-
-/* demod_psk.h */
-
-
-void demod_psk_init (enum modem_t modem_type, int samples_per_sec, int bps, char profile, struct demodulator_state_s *D);
-
-void demod_psk_process_sample (int chan, int subchan, int sam, struct demodulator_state_s *D);

direwolf.spec

@@ -1,62 +0,0 @@
-Name:           direwolf
-Version:        1.1b1
-Release:        1%{?dist}
-Summary:        Soundcard based AX.25 TNC
-
-Group:          Applications/Communications
-License:        GPLv2
-URL:            http://home.comcast.net/~wb2osz
-Source0:        http://home.comcast.net/~wb2osz/Version%201.1/direwolf-%{version}.tgz
-Packager:       David Ranch (KI6ZHD) <dranch@trinnet.net>
-Distribution:   RedHat Linux
-
-Patch0:         direwolf-makefile7.patch
-
-BuildRequires:  automake
-BuildRequires:  alsa-lib-devel
-
-
-%description
-Dire Wolf is a software "soundcard" modem/TNC and APRS encoder/decoder.   It can 
-be used stand-alone to receive APRS messages, 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.
-
-%prep
-
-%setup -q -n %{name}-%{version}
-%patch0 -p0
-
-%build 
-make -f Makefile.linux tocalls-symbols
-make %{?_smp_mflags} -f Makefile.linux
-
-
-%install
-make -f Makefile.linux install DESTDIR=$RPM_BUILD_ROOT
-make -f Makefile.linux install-conf DESTDIR=$RPM_BUILD_ROOT
-
-# Install icon
-mkdir -p ${RPM_BUILD_ROOT}%{_datadir}/pixmaps/
-cp dw-icon.png ${RPM_BUILD_ROOT}%{_datadir}/pixmaps/
-mv symbols-new.txt ${RPM_BUILD_ROOT}%{_docdir}/%{name}/
-mv symbolsX.txt ${RPM_BUILD_ROOT}%{_docdir}/%{name}/
-mv tocalls.txt ${RPM_BUILD_ROOT}%{_docdir}/%{name}/
-desktop-file-install \
-        --dir=${RPM_BUILD_ROOT}%{_datadir}/applications direwolf.desktop
-
-
-%files
-%{_sysconfdir}/ax25/direwolf.conf
-%{_bindir}/* 
-%{_datadir}/pixmaps/dw-icon.png
-%{_datadir}/applications/%{name}.desktop
-%{_datadir}/direwolf/*
-%{_docdir}/%{name}/*
-
-
-
-%changelog
-* Sat Dec 20 2014 David Ranch <dranch@trinnet.net> - 1.1b1-1
-- new spec file

direwolf.txt

@@ -1,532 +0,0 @@
-C#############################################################
-C#                                                           #
-C#               Configuration file for Dire Wolf            #
-C#                                                           #
-L#                   Linux version                           #
-W#                   Windows version                         #
-C#                                                           #
-C#############################################################
-R
-R
-R	The sample config file was getting pretty messy
-R	with the Windows and Linux differences.
-R	It would be a maintenance burden to keep most of
-R	two different versions in sync.
-R	This common source is now used to generate the 
-R	two different variations while having only a single
-R	copy of the common parts.
-R
-R	The first column contains one of the following:
-R
-R		R	remark which is discarded.
-R		C	common to both versions.
-R		W	Windows version only.
-R		L	Linux version only.
-R
-C#
-C# Consult the User Guide for more details on configuration options.
-C#
-C#
-C# These are the most likely settings you might change:
-C#
-C#	(1)   	MYCALL 	-  call sign and SSID for your station.
-C#
-C#			Look for lines starting with MYCALL and 
-C#			change NOCALL to your own.
-C#
-C#	(2)	PBEACON	-  enable position beaconing.
-C#
-C#			Look for lines starting with PBEACON and 
-C#			modify for your call, location, etc.
-C#
-C#	(3)	DIGIPEATER  -  configure digipeating rules.
-C#
-C#			Look for lines starting with DIGIPEATER.
-C#			Most people will probably use the given example.
-C#			Just remove the "#" from the start of the line
-C#			to enable it.
-C#
-C#	(4)	IGSERVER, IGLOGIN  - IGate server and login
-C#
-C#			Configure an IGate client to relay messages between 
-C#			radio and internet servers.
-C#
-C#
-C# The default location is "direwolf.conf" in the current working directory.
-L# On Linux, the user's home directory will also be searched.
-C# An alternate configuration file location can be specified with the "-c" command line option.  
-C#
-C# As you probably guessed by now, # indicates a comment line.
-C#
-C# Remove the # at the beginning of a line if you want to use a sample
-C# configuration that is currently commented out.
-C#
-C# Commands are a keyword followed by parameters.
-C#
-C# Command key words are case insensitive.  i.e. upper and lower case are equivalent.
-C#
-C# Command parameters are generally case sensitive.  i.e. upper and lower case are different.
-C#
-C
-C
-C#############################################################
-C#                                                           #
-C#               FIRST AUDIO DEVICE PROPERTIES               #
-C#               (Channel 0 + 1 if in stereo)                #
-C#                                                           #
-C#############################################################
-C
-C#
-C# Many people will simply use the default sound device.
-C# Some might want to use an alternative device by chosing it here.
-C#
-W# When the Windows version starts up, it displays something like 
-W# this with the available sound devices and capabilities:
-W#
-W#	Available audio input devices for receive (*=selected):
-W#	   *  0: Microphone (C-Media USB Headpho   (channel 2)
-W#	      1: Microphone (Bluetooth SCO Audio
-W#	      2: Microphone (Bluetooth AV Audio)
-W#	 *    3: Microphone (Realtek High Defini   (channels 0 & 1)
-W#	Available audio output devices for transmit (*=selected):
-W#	   *  0: Speakers (C-Media USB Headphone   (channel 2)
-W#	      1: Speakers (Bluetooth SCO Audio)
-W#	      2: Realtek Digital Output(Optical)
-W#	      3: Speakers (Bluetooth AV Audio)
-W#	 *    4: Speakers (Realtek High Definiti   (channels 0 & 1)
-W#	      5: Realtek Digital Output (Realtek
-W#	
-W# Example: To use the microphone and speaker connections on the 
-W# system board, either of these forms can be used:
-W
-W#ADEVICE High
-W#ADEVICE  3 4 
-W
-W
-W# Example: To use the USB Audio, use a command like this with
-W# the input and output device numbers.  (Remove the # comment character.)
-W#ADEVICE USB
-W
-W# The position in the list can change when devices (e.g. USB) are added and removed.
-W# You can also specify devices by using part of the name.
-W# Here is an example of specifying the USB Audio device.
-W# This is case-sensitive.  Upper and lower case are not treated the same.
-W
-W#ADEVICE USB
-W
-W
-L# Linux ALSA is complicated.  See User Guide for discussion.
-L# To use something other than the default, generally use plughw
-L# and a card number reported by "arecord -l" command.  Example:
-L
-L# ADEVICE  plughw:1,0
-L
-L# Starting with version 1.0, you can also use "-" or "stdin" to 
-L# pipe stdout from some other application such as a software defined
-L# radio.  You can also specify "UDP:" and an optional port for input.
-L# Something different must be specified for output.
-L
-W# ADEVICE - 0
-W# ADEVICE UDP:7355 0
-L# ADEVICE - plughw:1,0
-L# ADEVICE UDP:7355 default
-L
-L
-C
-C#
-C# Number of audio channels for this souncard:  1 or 2.
-C#
-C
-CACHANNELS 1
-C#ACHANNELS 2
-C
-C
-C#############################################################
-C#                                                           #
-C#               SECOND AUDIO DEVICE PROPERTIES              #
-C#               (Channel 2 + 3 if in stereo)                #
-C#                                                           #
-C#############################################################
-C
-C#ADEVICE1  ...
-C
-C
-C#############################################################
-C#                                                           #
-C#               THIRD AUDIO DEVICE PROPERTIES               #
-C#               (Channel 4 + 5 if in stereo)                #
-C#                                                           #
-C#############################################################
-C
-C#ADEVICE2  ...
-C
-C
-C#############################################################
-C#                                                           #
-C#               CHANNEL 0 PROPERTIES                        #
-C#                                                           #
-C#############################################################
-C
-CCHANNEL 0
-C
-C#
-C# The following MYCALL, MODEM, PTT, etc. configuration items
-C# apply to the most recent CHANNEL.
-C#
-C
-C#
-C# Station identifier for this channel.
-C# Multiple channels can have the same or different names.
-C#
-C# It can be up to 6 letters and digits with an optional ssid.
-C# The APRS specification requires that it be upper case.
-C#
-C# Example (don't use this unless you are me):  MYCALL	WB2OSZ-5
-C#
-C
-CMYCALL N0CALL
-C
-C#
-C# Pick a suitable modem speed based on your situation.
-C#	1200 	Most common for VHF/UHF.  Default if not specified.
-C#	300	Low speed for HF SSB.
-C#	9600	High speed - Can't use Microphone and Speaker connections.
-C#
-C# In the simplest form, just specify the speed. 
-C# 
-C
-CMODEM 1200
-C#MODEM 300
-C#MODEM 9600
-C
-C#
-C# These are the defaults should be fine for most cases.  In special situations, 
-C# you might want to specify different AFSK tones or the baseband mode which does
-C# not use AFSK.
-C#
-C#MODEM 1200 1200:2200
-C#MODEM 300  1600:1800
-C#MODEM 9600 0:0
-C#
-C#
-C# On HF SSB, you might want to use multiple demodulators on slightly different
-C# frequencies to compensate for stations off frequency.  Here we have 7 different
-C# demodulators at 30 Hz intervals.  This takes a lot of CPU power so you will 
-C# probably need to reduce the audio sampling rate with the /n option.
-C
-C#MODEM 300 1600:1800 7@30 /4
-C
-C
-C#
-C# Uncomment line below to enable the DTMF decoder for this channel.
-C#
-C
-C#DTMF
-C
-C# 
-C# If not using a VOX circuit, the transmitter Push to Talk (PTT) 
-C# control is usually wired to a serial port with a suitable interface circuit.  
-C# DON'T connect it directly!
-C#
-C# For the PTT command, specify the device and either RTS or DTR.
-C# RTS or DTR may be preceded by "-" to invert the signal.
-C# Both can be used for interfaces that want them driven with opposite polarity.
-C#
-L# COM1 can be used instead of /dev/ttyS0, COM2 for /dev/ttyS1, and so on.
-L#
-C
-C#PTT COM1 RTS
-C#PTT COM1 RTS -DTR
-L#PTT /dev/ttyUSB0 RTS
-C
-L#
-L# On Linux, you can also use general purpose I/O pins if
-L# your system is configured for user access to them. 
-L# This would apply mostly to microprocessor boards, not a regular PC.
-L# See separate Raspberry Pi document for more details.
-L# The number may be preceded by "-" to invert the signal.
-L#
-L
-L#PTT GPIO 25
-L
-C# The Data Carrier Detect (DCD) signal can be sent to the same places
-C# as the PTT signal.  This could be used to light up an LED like a normal TNC.
-C
-C#DCD COM1 -DTR
-L#DCD GPIO 24
-C
-C
-C#############################################################
-C#                                                           #
-C#               CHANNEL 1 PROPERTIES                        #
-C#                                                           #
-C#############################################################
-C
-C#CHANNEL 1
-C
-C#
-C# Specify MYCALL, MODEM, PTT, etc. configuration items for 
-C# CHANNEL 1.   Repeat for any other channels.
-C
-C
-C#############################################################
-C#                                                           #
-C#               TEXT TO SPEECH COMMAND FILE                 #
-C#                                                           #
-C#############################################################
-C
-W#SPEECH dwespeak.bat
-L#SPEECH dwespeak.sh
-C
-C
-C#############################################################
-C#                                                           #
-C#               VIRTUAL TNC SERVER PROPERTIES               #
-C#                                                           #
-C#############################################################
-C
-C#
-C# Dire Wolf acts as a virtual TNC and can communicate with
-C# client applications by different protocols:
-C#
-C#	- the "AGW TCPIP Socket Interface" - default port 8000
-C#	- KISS protocol over TCP socket - default port 8001
-W#	- KISS TNC via serial port
-L#	- KISS TNC via pseudo terminal   (-p command line option)
-C#
-C
-CAGWPORT 8000
-CKISSPORT 8001
-C
-W#
-W# Some applications are designed to operate with only a physical
-W# TNC attached to a serial port.  For these, we provide a virtual serial
-W# port that appears to be connected to a TNC.
-W#
-W# Take a look at the User Guide for instructions to set up
-W# two virtual serial ports named COM3 and COM4 connected by
-W# a null modem.
-W#
-W# Using the  configuration described, Dire Wolf will connect to 
-W# COM3 and the client application will use COM4.
-W#
-W# Uncomment following line to use this feature.
-W
-W#NULLMODEM COM3
-W
-W
-C#
-C# It is sometimes possible to recover frames with a bad FCS.
-C# This applies to all channels.  
-C#
-C#	0  [NONE] - Don't try to repair.
-C#	1  [SINGLE] - Attempt to fix single bit error.  (default)
-C#	2  [DOUBLE] - Also attempt to fix two adjacent bits.
-C#	... see User Guide for more values and in-depth discussion.
-C#
-C
-C#FIX_BITS 0
-C
-C#	
-C#############################################################
-C#                                                           #
-C#               BEACONING PROPERTIES                        #
-C#                                                           #
-C#############################################################
-C
-C
-C#
-C# Beaconing is configured with these two commands:
-C#
-C#	PBEACON		- for a position report (usually yourself)
-C#	OBEACON		- for an object report (usually some other entity)
-C#
-C# Each has a series of keywords and values for options.  
-C# See User Guide for details.
-C#
-C# Example:
-C#
-C# This results in a broadcast once every 10 minutes.
-C# Every half hour, it can travel via two digipeater hops.
-C# The others are kept local.
-C#
-C
-C#PBEACON delay=1  every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1,WIDE2-1 
-C#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"  
-C#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"  
-C
-C
-C# With UTM coordinates instead of latitude and longitude.
-C
-C#PBEACON delay=1 every=10 overlay=S symbol="digi" zone=19T easting=307477 northing=4720178 
-C
-C
-C#
-C# When the destination field is set to "SPEECH" the information part is
-C# converted to speech rather than transmitted as a data frame.
-C#
-C
-C#CBEACON dest="SPEECH" info="Club meeting tonight at 7 pm."
-C
-C
-C#
-C# Modify for your particular situation before removing 
-C# the # comment character from the beginning of appropriate lines above.
-C# 
-C
-C
-C#############################################################
-C#                                                           #
-C#               DIGIPEATER PROPERTIES                       #
-C#                                                           #
-C#############################################################
-C
-C#
-C# For most common situations, use something like this by removing
-C# the "#" from the beginning of the line below.  
-C#
-C
-C#DIGIPEAT 0 0 ^WIDE[3-7]-[1-7]$|^TEST$ ^WIDE[12]-[12]$ TRACE 
-C
-C# See User Guide for more explanation of what this means and how
-C# it can be customized for your particular needs.
-C 
-C# Filtering can be used to limit was is digipeated.
-C# For example, only weather weather reports, received on channel 0,
-C# will be retransmitted on channel 1.
-C#
-C
-C#FILTER 0 1 t/wn 
-C
-C
-C#############################################################
-C#                                                           #
-C#               INTERNET GATEWAY                            #
-C#                                                           #
-C#############################################################
-C
-C# First you need to specify the name of a Tier 2 server.  
-C# The current preferred way is to use one of these regional rotate addresses:
-C
-C#	noam.aprs2.net 		- for North America
-C#	soam.aprs2.net		- for South America
-C#	euro.aprs2.net		- for Europe and Africa
-C#	asia.aprs2.net 		- for Asia
-C#	aunz.aprs2.net		- for Oceania 
-C
-C#IGSERVER noam.aprs2.net
-C
-C# You also need to specify your login name and passcode. 
-C# Contact the author if you can't figure out how to generate the passcode.
-C 
-C#IGLOGIN WB2OSZ-5 123456
-C
-C# That's all you need for a receive only IGate which relays
-C# messages from the local radio channel to the global servers.
-C
-C# Some might want to send an IGate client position directly to a server
-C# without sending it over the air and relying on someone else to 
-C# forward it to an IGate server.  This is done by using sendto=IG rather
-C# than a radio channel number. Overlay R for receive only, T for two way.
-C
-C#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=R lat=42^37.14N long=071^20.83W 
-C#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=T lat=42^37.14N long=071^20.83W 
-C
-C
-C# To relay messages from the Internet to radio, you need to add
-C# one more option with the transmit channel number and a VIA path.
-C
-C#IGTXVIA 0 WIDE1-1
-C
-C# You might want to apply a filter for what packets will be obtained from the server.
-C# Read about filters here:  http://www.aprs-is.net/javaprsfilter.aspx
-C# Example, positions and objects within 50 km of my location:
-C
-C#IGFILTER m/50 
-C
-C# That is known as a server-side filter.  It is processed by the IGate server.
-C# You can also apply local filtering to limit what will be transmitted on the 
-C# RF side.  For example, transmit only "messages" on channel 0 and weather 
-C# reports on channel 1. 
-C
-C#FILTER IG 0 t/m
-C#FILTER IG 1 t/wn
-C
-C# Finally, we don't want to flood the radio channel.  
-C# The IGate function will limit the number of packets transmitted 
-C# during 1 minute and 5 minute intervals.   If a limit would 
-C# be exceeded, the packet is dropped and message is displayed in red.
-C
-CIGTXLIMIT 6 10
-C
-C
-C#############################################################
-C#                                                           #
-C#               APRStt GATEWAY                              #
-C#                                                           #
-C#############################################################
-C
-C#
-C# Dire Wolf can receive DTMF (commonly known as Touch Tone)
-C# messages and convert them to packet objects.
-C#
-C# See separate "APRStt-Implementation-Notes" document for details.
-C#
-C
-C#
-C# Sample gateway configuration based on:
-C#
-C#	http://www.aprs.org/aprstt/aprstt-coding24.txt
-C#	http://www.aprs.org/aprs-jamboree-2013.html
-C#
-C
-C# Define specific points.
-C
-CTTPOINT  B01  37^55.37N  81^7.86W  			
-CTTPOINT  B7495088  42.605237  -71.34456		
-CTTPOINT  B934  42.605237  -71.34456			
-C
-CTTPOINT B901  42.661279  -71.364452 
-CTTPOINT B902  42.660411  -71.364419 
-CTTPOINT B903  42.659046  -71.364452 
-CTTPOINT B904  42.657578  -71.364602 
-C
-C
-C# For location at given bearing and distance from starting point.
-C
-CTTVECTOR  B5bbbddd  37^55.37N  81^7.86W  0.01  mi
-C
-C# For location specified by x, y coordinates.
-C
-CTTGRID   Byyyxxx    37^50.00N  81^00.00W  37^59.99N  81^09.99W   
-C
-C# UTM location for Lowell-Dracut-Tyngsborough State Forest.
-C
-CTTUTM  B6xxxyyy  19T  10  300000  4720000
-C
-C
-C
-C# Location for the corral.
-C
-CTTCORRAL   37^55.50N  81^7.00W  0^0.02N
-C
-C# Compact messages - Fixed locations xx and object yyy where 
-C#   	Object numbers 100 - 199	= bicycle	
-C#	Object numbers 200 - 299	= fire truck
-C#	Others				= dog
-C
-CTTMACRO  xx1yy  B9xx*AB166*AA2B4C5B3B0A1yy
-CTTMACRO  xx2yy  B9xx*AB170*AA3C4C7C3B0A2yy
-CTTMACRO  xxyyy  B9xx*AB180*AA3A6C4A0Ayyy
-C
-CTTMACRO  z  Cz
-C
-C# Receive on channel 0, Transmit object reports on channel 1 with optional via path.
-C
-C#TTOBJ 0 1 WIDE1-1
-C
-C# Advertise gateway position with beacon.
-C
-C# OBEACON DELAY=0:15 EVERY=10:00 VIA=WIDE1-1 OBJNAME=WB2OSZ-tt SYMBOL=APRStt LAT=42^37.14N LONG=71^20.83W COMMENT="APRStt Gateway"  
-C
-C

doc/CMakeLists.txt

@@ -0,0 +1,21 @@
+
+install(FILES "${CUSTOM_DOC_DIR}/README.md" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/2400-4800-PSK-for-APRS-Packet-Radio.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/AIS-Reception.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/APRS-Telemetry-Toolkit.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/APRStt-Implementation-Notes.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/APRStt-interface-for-SARTrack.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/APRStt-Listening-Example.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/AX25_plus_FEC_equals_FX25.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Bluetooth-KISS-TNC.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Going-beyond-9600-baud.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Raspberry-Pi-APRS.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Raspberry-Pi-APRS-Tracker.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Raspberry-Pi-SDR-IGate.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Successful-APRS-IGate-Operation.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/User-Guide.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/WA8LMF-TNC-Test-CD-Results.pdf" DESTINATION ${INSTALL_DOC_DIR})
+install(FILES "${CUSTOM_DOC_DIR}/Why-is-9600-only-twice-as-fast-as-1200.pdf" DESTINATION ${INSTALL_DOC_DIR})

doc/README.md

@@ -1,13 +1,21 @@
 # Documentation for Dire Wolf #
 
+Click on the document name to view in your web browser or the link following to download the PDF file.
+
+
+## Slide Show ##
+
+Brief summary of packet radio / APRS history and the capbilities of Dire Wolf.
+
+[Power Point presentation](https://github.com/wb2osz/direwolf-presentation)  -- Why not give a talk at a local club meeting?
 
 ## Essential Reading ##
  
-- [User Guide](User-Guide.pdf)
+- [**User Guide**](User-Guide.pdf)  [ [*download*](../../../raw/master/doc/User-Guide.pdf) ]
 
 	This is your primary source of information about installation, operation, and configuration.
 
-- [Raspberry Pi APRS](Raspberry-Pi-APRS.pdf)
+- [**Raspberry Pi APRS**](Raspberry-Pi-APRS.pdf)   [ [*download*](../../../raw/master/doc/Raspberry-Pi-APRS.pdf) ]
 
 	The Raspberry Pi has some special considerations that
 	make it different from other generic Linux systems.
@@ -19,26 +27,59 @@
 These dive into more detail for specialized topics or typical usage scenarios.
 
 
-- [APRStt Implementation Notes](APRStt-Implementation-Notes.pdf)
+
+- [**AX.25 + FEC = FX.25**](AX25_plus_FEC_equals_FX25.pdf)  [ [*download*](../../../raw/dev/doc/AX25_plus_FEC_equals_FX25.pdf) ]
+
+	What can you do if your radio signal isn’t quite strong enough to get through reliably?  Move to higher ground?  Get a better antenna?  More power?  Use very narrow bandwidth and very slow data?
+
+    Sometimes those are not options.  Another way to improve communication reliability is to add redundant information so the message will still get through even if small parts are missing.  FX.25 adds forward error correction (FEC) which maintaining complete compatibility with older equipment.
+
+
+- [**AX.25 Throughput: Why is 9600 bps Packet Radio only twice as fast as 1200?**](Why-is-9600-only-twice-as-fast-as-1200.pdf)  [ [*download*](../../../raw/dev/doc/Why-is-9600-only-twice-as-fast-as-1200.pdf) ]
+
+	Simply switching to a higher data rate will probably result in great disappointment.  You might expect it to be 8 times faster but it can turn out to be only twice as fast.
+
+    In this document, we look at why a large increase in data bit rate can produce a much smaller increase in throughput.  We will explore techniques that can be used to make large improvements and drastically speed up large data transfer.
+
+
+
+
+- [**Successful APRS IGate Operation**](Successful-APRS-IGate-Operation.pdf)  [ [*download*](../../../raw/dev/doc/Successful-APRS-IGate-Operation.pdf) ]
+
+
+	Dire Wolf can serve as a gateway between the APRS radio network and APRS-IS servers on the Internet.
+
+    This explains how it all works, proper configuration, and troubleshooting.
+
+- [**Bluetooth KISS TNC**](Bluetooth-KISS-TNC.pdf)  [ [*download*](../../../raw/master/doc/Bluetooth-KISS-TNC.pdf) ]
+
+	Eliminate the cable between your TNC and application.  Use Bluetooth instead.  
+
+- [**APRStt Implementation Notes**](APRStt-Implementation-Notes.pdf)  [ [*download*](../../../raw/master/doc/APRStt-Implementation-Notes.pdf) ]
 
 	Very few hams have portable equipment for APRS but nearly everyone has a handheld radio that can send DTMF tones.  APRStt allows a user, equipped with only DTMF (commonly known as Touch Tone) generation capability, to enter information into the global APRS data network.
 	This document explains how the APRStt concept was implemented in the Dire Wolf application.  
 
-- [APRStt Interface for SARTrack](APRStt-interface-for-SARTrack.pdf)
+- [**APRStt Interface for SARTrack**](APRStt-interface-for-SARTrack.pdf) [ [*download*](../../../raw/master/doc/APRStt-interface-for-SARTrack.pdf) ]
 
 	This example illustrates how APRStt can be integrated with other applications such as SARTrack, APRSISCE/32, YAAC, or Xastir.  
 
-- [APRStt Listening Example](APRStt-Listening-Example.pdf)
+- [**APRStt Listening Example**](APRStt-Listening-Example.pdf)  [ [*download*](../../../raw/master/doc/APRStt-Listening-Example.pdf) ]
+
 
 	WB4APR described a useful application for the [QIKCOM-2 Satallite Transponder](http://www.tapr.org/pipermail/aprssig/2015-November/045035.html). 
 
     Don’t have your own QIKCOM-2 Satellite Transponder?  No Problem.  You can do the same thing with an ordinary computer and the APRStt gateway built into Dire Wolf.   Here’s how.
 
-- [Raspberry Pi SDR IGate](Raspberry-Pi-SDR-IGate.pdf)
+- [**Raspberry Pi APRS Tracker**](Raspberry-Pi-APRS-Tracker.pdf)   [ [*download*](../../../raw/master/doc/Raspberry-Pi-APRS-Tracker.pdf) ]
+
+	Build a tracking device which transmits position from a GPS receiver.
+
+- [**Raspberry Pi SDR IGate**](Raspberry-Pi-SDR-IGate.pdf)   [ [*download*](../../../raw/master/doc/Raspberry-Pi-SDR-IGate.pdf) ]
 
 	It's easy to build a receive-only APRS Internet Gateway (IGate) with only a Raspberry Pi and a software defined radio (RTL-SDR) dongle.  Here’s how.
 
-- [APRS Telemetry Toolkit](APRS-Telemetry-Toolkit.pdf)
+- [**APRS Telemetry Toolkit**](APRS-Telemetry-Toolkit.pdf)   [ [*download*](../../../raw/master/doc/APRS-Telemetry-Toolkit.pdf) ]
 
 	Describes scripts and methods to generate telemetry.
 	Includes a complete example of attaching an analog to 
@@ -47,19 +88,41 @@ These dive into more detail for specialized topics or typical usage scenarios.
 
 
 
-- [2400 & 4800 bps PSK for APRS / Packet Radio](2400-4800-PSK-for-APRS-Packet-Radio.pdf)
+- [**2400 & 4800 bps PSK for APRS / Packet Radio**](2400-4800-PSK-for-APRS-Packet-Radio.pdf)  [ [*download*](../../../raw/master/doc/2400-4800-PSK-for-APRS-Packet-Radio.pdf) ]
+
 
 	Double or quadruple your data rate by sending  multiple bits at the same time.
 
-- [Going beyond 9600 baud](Going-beyond-9600-baud.pdf)
+- [**Going beyond 9600 baud**](Going-beyond-9600-baud.pdf) [ [*download*](../../../raw/master/doc/Going-beyond-9600-baud.pdf) ]
+
 
 	Why stop at 9600 baud?  Go faster if your soundcard and radio can handle it.
 
+- [**AIS Reception**](AIS-Reception.pdf) [ [*download*](../../../raw/dev/doc/AIS-Reception.pdf) ]
+
+
+	AIS is an international tracking system for ships.  Messages can contain position, speed, course, name, destination, status, vessel dimensions, and many other types of information.  Learn how to receive these signals with an ordindary ham transceiver and display the ship locations with APRS applications or [OpenCPN](https://opencpn.org).
+
+- **[EAS to APRS message converter](https://github.com/wb2osz/eas2aprs)**
+
+
+	The [U.S. National Weather Service](https://www.weather.gov/nwr/) (NWS) operates more than 1,000 VHF FM radio stations that continuously transmit weather information.  These stations also transmit special warnings about severe weather, disasters (natural & manmade), and public safety.
+
+    Alerts are sent in a digital form known as Emergency Alert System (EAS) Specific Area Message Encoding (SAME). [You can hear a sample here](https://en.wikipedia.org/wiki/Specific_Area_Message_Encoding).
+
+    It is possible to buy radios that decode these messages but what fun is that? We are ham radio operators so we want to build our own from stuff that we already have sitting around.
+
 
 ## Miscellaneous ##
 
+- **[Ham Radio of Things (HRoT)](https://github.com/wb2osz/hrot)**
 
-- [A Better APRS Packet Demodulator, part 1, 1200 baud](A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf)
+
+	Now that billions of computers and mobile phones (which are handheld computers) are all connected by the Internet, the large growth is expected from the “Internet of Things.” What is a “thing?” It could be a temperature sensor, garage door opener, motion detector, flood water level, smoke alarm, antenna rotator, coffee maker, lights, home thermostat, …, just about anything you might want to monitor or control.
+
+    There have been other occasional mentions of merging Ham Radio with the Internet of Things but only ad hoc incompatible narrowly focused applications. Here is a proposal for a standardized more flexible method so different systems can communicate with each other.
+
+- [**A Better APRS Packet Demodulator, part 1, 1200 baud**](A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf) [ [*download*](../../../raw/master/doc/A-Better-APRS-Packet-Demodulator-Part-1-1200-baud.pdf) ]
 
 	Sometimes it's a little mystifying why an
 APRS / AX.25 Packet TNC will decode some signals
@@ -71,7 +134,7 @@ and a couple things that can be done about it.
 
 
 
-- [A Better APRS Packet Demodulator, part 2, 9600 baud](A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf)
+- [**A Better APRS Packet Demodulator, part 2, 9600 baud**](A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf) [ [*download*](../../../raw/master/doc/A-Better-APRS-Packet-Demodulator-Part-2-9600-baud.pdf) ]
 
 	In the first part of this series we discussed 1200 baud audio frequency shift keying (AFSK).  The mismatch 
 	between FM 	transmitter pre-emphasis and the 
@@ -80,13 +143,36 @@ and a couple things that can be done about it.
 	This makes it more difficult to demodulate them accurately.
 	9600 baud operation is an entirely different animal.  ...
 
-- [WA8LMF TNC Test CD Results a.k.a. Battle of the TNCs](WA8LMF-TNC-Test-CD-Results.pdf)
+- [**WA8LMF TNC Test CD Results a.k.a. Battle of the TNCs**](WA8LMF-TNC-Test-CD-Results.pdf)  [ [*download*](../../../raw/master/doc/WA8LMF-TNC-Test-CD-Results.pdf) ]
 
 	How can we compare how well the TNCs perform under real world conditions?
 	The de facto standard of measurement is the number of packets decoded from [WA8LMF’s TNC Test CD](http://wa8lmf.net/TNCtest/index.htm).
 	Many have published the number of packets they have been able to decode from this test. Here they are, all gathered in one place, for your reading pleasure.
 
-- [A Closer Look at the WA8LMF TNC Test CD](A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf)
+- [**A Closer Look at the WA8LMF TNC Test CD**](A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf)  [ [*download*](../../../raw/master/doc/A-Closer-Look-at-the-WA8LMF-TNC-Test-CD.pdf) ]
 
     Here, we take a closer look at some of the frames on the TNC Test CD in hopes of gaining some insights into why some are easily decoded and others are more difficult.
-    There are a lot of ugly signals out there.   Many can be improved by decreasing the transmit volume.   Others are just plain weird and you have to wonder how they are being generated.
+    There are a lot of ugly signals out there.   Many can be improved by decreasing the transmit volume.   Others are just plain weird and you have to wonder how they are being generated.
+
+
+## Additional Documentation for Dire Wolf Software TNC #
+
+
+When there was little documentation, it was all added to the source code repository [https://github.com/wb2osz/direwolf/tree/master/doc](https://github.com/wb2osz/direwolf/tree/master/doc) 
+
+The growing number of documentation files and revisions are making the source code repository very large which means long download times.  Additional documentation, not tied to a specific release, is now being added to  [https://github.com/wb2osz/direwolf-doc](https://github.com/wb2osz/direwolf-doc) 
+
+## Questions?  Experiences to share?  ##
+ 
+Here are some good places to ask questions and share your experiences:
+
+- [Dire Wolf Software TNC](https://groups.io/g/direwolf)
+
+- [Raspberry Pi 4 Ham Radio](https://groups.io/g/RaspberryPi-4-HamRadio)
+
+- [linuxham](https://groups.io/g/linuxham)
+
+- [TAPR aprssig](http://www.tapr.org/pipermail/aprssig/)
+ 
+
+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.

dsp.h

@@ -1,10 +0,0 @@
-
-/* dsp.h */
-
-// TODO:  put prefixes on these names.
-
-float window (bp_window_t type, int size, int j);
-
-void gen_lowpass (float fc, float *lp_filter, int filter_size, bp_window_t wtype);
-
-void gen_bandpass (float f1, float f2, float *bp_filter, int filter_size, bp_window_t wtype);

dtime_now.c

@@ -1,61 +0,0 @@
-
-#include "direwolf.h"
-#include "textcolor.h"
-#include "dtime_now.h"
-
-
-/* Current time in seconds but more resolution than time(). */
-
-/* We don't care what date a 0 value represents because we */
-/* only use this to calculate elapsed real time. */
-
-
-
-#include <time.h>
-
-#ifdef __APPLE__
-#include <sys/time.h>
-#endif
-
-
-
-
-
-double dtime_now (void)
-{
-	double result;
-
-#if __WIN32__
-	/* 64 bit integer is number of 100 nanosecond intervals from Jan 1, 1601. */
-
-	FILETIME ft;
-	
-	GetSystemTimeAsFileTime (&ft);
-
-	result = ((( (double)ft.dwHighDateTime * (256. * 256. * 256. * 256.) + 
-			(double)ft.dwLowDateTime ) / 10000000.) - 11644473600.);
-#else
-	/* tv_sec is seconds from Jan 1, 1970. */
-
-	struct timespec ts;
-
-#ifdef __APPLE__
-	struct timeval tp;
-	gettimeofday(&tp, NULL);
-	ts.tv_nsec = tp.tv_usec * 1000;
-	ts.tv_sec  = tp.tv_sec;
-#else
-	clock_gettime (CLOCK_REALTIME, &ts);
-#endif
-
-	result = ((double)(ts.tv_sec) + (double)(ts.tv_nsec) * 0.000000001);
-	
-#endif
-
-#if DEBUG	
-	text_color_set(DW_COLOR_DEBUG);
-	dw_printf ("dtime_now() returns %.3f\n", result );
-#endif
-
-	return (result);
-}

dtime_now.h

@@ -1,3 +0,0 @@
-
-
-extern double dtime_now (void);

dtmf.h

@@ -1,12 +0,0 @@
-/* dtmf.h */
-
-
-#include "audio.h"
-
-void dtmf_init (struct audio_s *p_audio_config);
-
-char dtmf_sample (int c, float input);
-
-
-/* end dtmf.h */
-

dw-icon.rc

@@ -1 +0,0 @@
-MAINICON ICON "dw-icon.ico"

dw-start.sh

@@ -1,100 +0,0 @@
-#!/bin/bash
-
-#
-# Run this from crontab periodically to start up
-# Dire Wolf automatically.
-#
-# I prefer this method instead of putting something
-# in ~/.config/autostart.  That would start an application
-# only when the desktop first starts up.
-#
-# This method will restart the application if it
-# crashes or stops for any other reason.
-#
-# This script has some specifics the Raspberry Pi.
-# Some adjustments might be needed for other Linux variations.
-#
-
-#
-# When running from cron, we have a very minimal environment
-# including PATH=/usr/bin:/bin.
-#
-
-export PATH=/usr/local/bin:$PATH
-
-# First wait a little while in case we just rebooted
-# and the desktop hasn't started up yet.
-#
-
-sleep 30
-LOGFILE=/tmp/dw-start.log
-
-#
-# Nothing to do if it is already running.
-#
-
-a=`pgrep direwolf`
-if [ "$a" != "" ] 
-then
-  #date >> /tmp/dw-start.log
-  #echo "Already running." >> $LOGFILE
-  exit
-fi
-
-#
-# In my case, the Raspberry Pi is not connected to a monitor.
-# I access it remotely using VNC as described here:
-# http://learn.adafruit.com/adafruit-raspberry-pi-lesson-7-remote-control-with-vnc
-#
-# If VNC server is running, use its display number.
-# Otherwise default to :0.
-#
-
-date >> /tmp/dw-start.log
-
-export DISPLAY=":0"
-
-v=`ps -ef | grep Xtightvnc | grep -v grep`
-if [ "$v" != "" ]
-then
-  d=`echo "$v" | sed 's/.*tightvnc *\(:[0-9]\).*/\1/'`
-  export DISPLAY="$d"
-fi
-
-echo "DISPLAY=$DISPLAY" >> $LOGFILE
-
-echo "Start up application." >> $LOGFILE
-
-#
-# For normal operation as TNC, digipeater, IGate, etc.
-# Print audio statistics each 100 seconds for troubleshooting.
-#
-
-DWCMD="direwolf -a 100"
-
-# Alternative for running with SDR receiver.
-# Piping one application into another makes it a little more complicated.
-# We need to use bash for the | to be recognized. 
-
-#DWCMD="bash -c 'rtl_fm -f 144.39M - | direwolf -c sdr.conf -r 24000 -D 1 -'"
-
-# 
-# Adjust for your particular situation:  gnome-terminal, xterm, etc.
-#
-
-
-if [ -x /usr/bin/lxterminal ]
-then
-  /usr/bin/lxterminal -t "Dire Wolf" -e "$DWCMD" &
-elif [ -x /usr/bin/xterm ] 
-then
-  /usr/bin/xterm -bg white -fg black -e "$DWCMD" &
-elif [ -x /usr/bin/x-terminal-emulator ]
-then
-  /usr/bin/x-terminal-emulator -e "$DWCMD" &
-else
-  echo "Did not find an X terminal emulator."
-fi
-
-echo "-----------------------" >> $LOGFILE
-

external/geotranz/CMakeLists.txt

@@ -0,0 +1,17 @@
+# UTM, USNG, MGRS conversions
+
+set(GEOTRANZ_LIBRARIES geotranz CACHE INTERNAL "geotranz")
+
+list(APPEND geotranz_SOURCES
+  error_string.c
+  mgrs.c
+  polarst.c
+  tranmerc.c
+  ups.c
+  usng.c
+  utm.c
+  )
+
+add_library(geotranz STATIC
+  ${geotranz_SOURCES}
+  )

external/geotranz/mgrs.c

@@ -400,7 +400,7 @@ long Make_MGRS_String (char* MGRS,
   if (Zone)
     i = sprintf (MGRS+i,"%2.2ld",Zone);
   else
-    strncpy(MGRS, "  ", 2);  // 2 spaces
+    strcpy(MGRS, "  ");  // 2 spaces - Should i be set to 2?
 
   for (j=0;j<3;j++)
     MGRS[i++] = alphabet[Letters[j]];
@@ -868,7 +868,7 @@ long Convert_MGRS_To_Geodetic (char* MGRS,
  */
 { /* Convert_MGRS_To_Geodetic */
   long zone;
-  char hemisphere;
+  char hemisphere = '?';
   double easting;
   double northing;
   long zone_exists;
@@ -1260,9 +1260,9 @@ long Convert_MGRS_To_UPS ( char   *MGRS,
   double false_northing;      /* False northing for 3rd letter              */
   double grid_easting;        /* easting for 100,000 meter grid square      */
   double grid_northing;       /* northing for 100,000 meter grid square     */
-  long zone;
+  long zone = 0;
   long letters[MGRS_LETTERS];
-  long in_precision;
+  long in_precision = 0;
   int index = 0;
   long error_code = MGRS_NO_ERROR;
 

external/geotranz/mgrs.h

@@ -236,7 +236,7 @@ extern "C" {
  *  The function Convert_MGRS_To_UPS converts an MGRS coordinate string
  *  to UPS (hemisphere, easting, and northing) coordinates, according 
  *  to the current ellipsoid parameters. If any errors occur, the error 
- *  code(s) are returned by the function, otherwide UPS_NO_ERROR is returned.
+ *  code(s) are returned by the function, otherwise UPS_NO_ERROR is returned.
  *
  *    MGRS          : MGRS coordinate string           (input)
  *    Hemisphere    : Hemisphere either 'N' or 'S'     (output)

external/geotranz/usng.c

@@ -367,7 +367,7 @@ long Make_USNG_String (char* USNG,
   if (Zone)
     i = sprintf (USNG+i,"%2.2ld",Zone);
   else
-    strncpy(USNG, "  ", 2);  // 2 spaces
+    strcpy(USNG, "  ");  // 2 spaces - Should i be set to 2?
 
   for (j=0;j<3;j++)
     USNG[i++] = alphabet[Letters[j]];
@@ -577,6 +577,9 @@ long UTM_To_USNG (long Zone,
     Northing = 0.0;
   }
 
+  ltr2_low_value = LETTER_A;	// Make compiler shut up about possibly uninitialized value.
+				// It should be set by the following but compiler doesn't know.
+
   USNG_Get_Grid_Values(Zone, &ltr2_low_value, &ltr2_high_value, &pattern_offset);
 
   error_code = USNG_Get_Latitude_Letter(Latitude, &letters[0]);
@@ -779,7 +782,7 @@ long Convert_USNG_To_Geodetic (char* USNG,
  */
 { /* Convert_USNG_To_Geodetic */
   long zone;
-  char hemisphere;
+  char hemisphere = '?';
   double easting;
   double northing;
   long zone_exists;
@@ -960,6 +963,9 @@ long Convert_USNG_To_UTM (char   *USNG,
         else
           *Hemisphere = 'N';
 
+        ltr2_low_value = LETTER_A;	// Make compiler shut up about possibly uninitialized values.
+	ltr2_high_value = LETTER_Z;	// They should be set by the following but compiler doesn't know.
+
         USNG_Get_Grid_Values(*Zone, &ltr2_low_value, &ltr2_high_value, &pattern_offset);
 
         /* Check that the second letter of the USNG string is within
@@ -1172,9 +1178,9 @@ long Convert_USNG_To_UPS ( char   *USNG,
   double false_northing;      /* False northing for 3rd letter              */
   double grid_easting;        /* easting for 100,000 meter grid square      */
   double grid_northing;       /* northing for 100,000 meter grid square     */
-  long zone;
+  long zone = 0;
   long letters[USNG_LETTERS];
-  long in_precision;
+  long in_precision = 0;
   int index = 0;
   long error_code = USNG_NO_ERROR;