Skip to main content

AIS Cursor-on-Target Gateway.

Project description

Screenshot of AIS points in ATAK-Div Developer Edition.

aiscot receives AIS Sentences from an AIS Receiver, such as ais-decoder, converts them to Cursor-on-Target, and transmits the CoT to a UDP destination.

For use with CoT systems such as ATAK, WinTAK, RaptorX, Falconview, etc. See https://www.civtak.org/ for more information on the TAK program.

Installation

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

  1. To install from this source tree:

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

    $ pip install aiscot

Usage

The aiscot daemon has several runtime arguments:

$ aiscot --help
usage: aiscot [-h] [-P AIS_PORT] -C COT_HOST

optional arguments:
  -h, --help            show this help message and exit
  -P AIS_PORT, --ais_port AIS_PORT
                        AIS UDP Port
  -C COT_HOST, --cot_host COT_HOST
                        Cursor-on-Target Host or Host:Port

For minimum operation, -P AIS_PORT & -C COT_HOST are required.

The following example listens for AIS Sentences on UDP 0.0.0.0:5050, and forwards CoT messages to UDP 172.17.2.222:4242:

$ aiscot -P 5050 -C 172.17.2.222:4242

Example Cursor-on-Target Event

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

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<event version="2.0" type="a-f-G-E-V-C" uid="AIS.993692014"
    time="2020-09-25T14:15:01.639741Z" start="2020-09-25T14:15:01.639741Z"
    stale="2020-09-25T15:15:01.639741Z" how="h-e">
  <point lat="37.815" lon="-122.78695" hae="10" ce="10" le="10" />
  <detail>
    <uid Droid="6N                  @" />
  </detail>
</event>

Build Status

Master:

https://travis-ci.org/ampledata/aiscot.svg?branch=master

Develop:

https://travis-ci.org/ampledata/aiscot.svg?branch=develop

Source

Github: https://github.com/ampledata/aiscot

Author

Greg Albrecht W2GMD oss@undef.net

http://ampledata.org/

License

Apache License, Version 2.0. See LICENSE for details.

Debugging Cursor-on-Target

The publicly available ATAK source was a good reference for some of the parsing errors the ATAK-Civ Development Build was giving me, namely Invalid CoT message received: Missing or invalid CoT event and/or point attributes. Many errors are unfortunately caught in a single try/catch block:

https://github.com/deptofdefense/AndroidTacticalAssaultKit-CIV/blob/6dc1941f45af3f9716e718dccebf42555a8c08fd/commoncommo/core/impl/cotmessage.cpp#L448

Project details


Download files

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

Source Distribution

aiscot-1.0.0.tar.gz (5.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page