Skip to main content

APRS Cursor-on-Target Gateway.

Project description

Screenshot of APRS points in ATAK-Div Developer Edition.

aprscot receives APRS Frames from APRS-IS and outputs them in as Cursor-on-Target (CoT) PLI, for use with CoT systems such as ATAK, WinTAK, RaptorX, et al. See https://www.civtak.org/ for more information on the TAK program.

Currently supports APRS-IS and Location-type APRS messages, and sending to TCP CoT Hosts & TAK Servers.

Installation

The command-line daemon aprscot can be install from this source tree (A), or from the Python Package Index (PyPI) (B).

  1. To install from this source tree:

    $ git clone https://github.com/ampledata/aprscot.git
    $ cd aprscot/
    $ python setup.py install
    
  2. To install from PyPI:

    $ pip install aprscot
    

Usage

The aprscot daemon has several runtime arguments:

$ aprscot --help
usage: aprscot [-h] -c CALLSIGN -C COT_HOST [-p PASSCODE] [-a APRS_HOST]
               [-f FILTER]

optional arguments:
  -h, --help            show this help message and exit
  -c CALLSIGN, --callsign CALLSIGN
                        APRS-IS Login Callsign
  -C COT_HOST, --cot_host COT_HOST
                        Cursor-on-Target Host or Host:Port
  -p PASSCODE, --passcode PASSCODE
                        APRS-IS Passcode
  -a APRS_HOST, --aprs_host APRS_HOST
                        APRS-IS Host (or Host:Port).
  -f FILTER, --filter FILTER
                        APRS-IS Filter, see:
                        http://www.aprs-is.net/javAPRSFilter.aspx

For minimum operation, -c CALLSIGN & -C COT_HOST are required.

The following example forwards all APRS Frames within 50 meters of W2GMD-9’s last known location to the Cursor-on-Target host at 10.1.2.3 port 4242 (TCP):

aprscot -c W2GMD-9 -C 10.1.2.3:4242 -f m/50

Example Cursor-on-Target Event

The aprscot daemon will output CoT XML Events similar to this example:

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<event version="1.0" type="a-f-G-E-V-C" uid="APRS.W2GMD-1"
    time="2020-09-24T14:53:28.945221Z" start="2020-09-24T14:53:28.945221Z"
    stale="2020-09-24T15:53:28.945221Z" how="h-e">
   <point lat="38.51167" lon="-122.99883" hae="10" ce="10" le="10" />
</event>

Build Status

Master:

https://travis-ci.com/ampledata/aprscot.svg?branch=master

Develop:

https://travis-ci.com/ampledata/aprscot.svg?branch=develop

Author

Greg Albrecht W2GMD oss@undef.net

https://ampledata.org/

License

Apache License, Version 2.0. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aprscot, version 4.0.0
Filename, size File type Python version Upload date Hashes
Filename, size aprscot-4.0.0.tar.gz (6.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page