Stratux Cursor-on-Target Gateway.
Project description
The Stratux Cursor on Target Gateway transforms Stratux aircraft position information into Cursor on Target (CoT) Position Location Information (PLI) for display on Situational Awareness (SA) applications such as the Android Team Awareness Kit (ATAK), WinTAK, RaptorX, et al.
Stratux messages are received via the /traffic Websocket.
For more information on the TAK suite of tools, see: https://www.civtak.org/
For more information on the Stratux Portable ADS-B receiver, see: http://stratux.me/
Installation
The Stratux to Cursor on Target Gateway is provided by a command-line tool called stratuxcot, which can be installed several ways.
Installing as a Debian/Ubuntu Package:
$ wget https://github.com/ampledata/aircot/releases/latest/download/python3-aircot_latest_all.deb $ sudo apt install -f ./python3-aircot_latest_all.deb $ wget https://github.com/ampledata/pytak/releases/latest/download/python3-pytak_latest_all.deb $ sudo apt install -f ./python3-pytak_latest_all.deb $ wget https://github.com/ampledata/stratuxcot/releases/latest/download/python3-stratuxcot_latest_all.deb $ sudo apt install -f ./python3-stratuxcot_latest_all.deb
Install from the Python Package Index:
$ pip install stratuxcot
Install from this source tree:
$ git clone https://github.com/ampledata/stratuxcot.git $ cd aircot/ $ python setup.py stratuxcot
Usage
The stratuxcot command-line program has several runtime arguments:
$ stratuxcot -h usage: stratuxcot [-h] [-c CONFIG_FILE] [-d] [-U COT_URL] [-W STRATUX_WS] [-S COT_STALE] [-F FILTER_CONFIG] [-K KNOWN_CRAFT] optional arguments: -h, --help show this help message and exit -c CONFIG_FILE, --CONFIG_FILE CONFIG_FILE -d, --DEBUG Enable DEBUG logging -U COT_URL, --COT_URL COT_URL URL to CoT Destination. Must be a URL, e.g. tcp:1.2.3.4:1234 or tls:...:1234, etc. -W STRATUX_WS, --STRATUX_WS STRATUX_WS Stratux Websocket URL. -S COT_STALE, --COT_STALE COT_STALE CoT Stale period, in seconds -F FILTER_CONFIG, --FILTER_CONFIG FILTER_CONFIG FILTER_CONFIG -K KNOWN_CRAFT, --KNOWN_CRAFT KNOWN_CRAFT KNOWN_CRAFT
Troubleshooting
To report bugs, please set the DEBUG=1 environment variable to collect logs.
Source
The source for stratuxcot can be found on Github: https://github.com/ampledata/stratuxcot
Copyright
stratuxcot is Copyright 2020 Orion Labs, Inc. https://www.orionlabs.io
License
stratuxcot is licensed under the Apache License, Version 2.0. See LICENSE for details.
Examples
Connect to the Stratux device at ws://172.17.2.188/traffic, and forward CoT to TCP Port 8087 on Host 172.17.2.152:
$ stratuxcot -U tcp:172.17.2.152:8087 -W ws://172.17.2.188/traffic
Running as a Daemon
First, install supervisor:
$ sudo yum install supervisor $ sudo service supervisord start
Create /etc/supervisor.d/stratuxcot.ini with the following content:
[program:stratuxcot] command=stratuxcot -U tcp:172.17.2.152:8087 -W ws://172.17.2.188/traffic
And update supervisor:
$ sudo supervisorctl update
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for stratuxcot-1.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff47bd8ae0043783089c695a7c0b5ee07adb7e8fb1eb535199bdaeb2664d6c11 |
|
MD5 | 0bffc98c30fe911c82a36c9f7a02893f |
|
BLAKE2b-256 | fd7f30910b8381838e6b9f6117d5e83756672aef1f302a87c0d837925ee41f33 |