inrcot 5.0.2

inReach Cursor-on-Target Gateway.

• Pictured: Screenshot of INRCOT being used on a Search & Rescue mission in Arizona.

The inReach to Cursor on Target Gateway (INRCOT) transforms Garmin inReach position messages into Cursor on Target (CoT) Points for display on TAK Products like ATAK, WinTAK, iTAK, et al. Single or multi-device feeds are supported.

Other situational awareness products, including as RaptorX, TAKX & COPERS have been tested.

INRCOT requires a Garmin inReach device with service.

Support Development

Tech Support: Email [e-mail] or Signal/WhatsApp: [phone]

This tool has been developed for the Disaster Response, Public Safety and Frontline Healthcare community. This software is currently provided at no-cost to users. Any contribution you can make to further this project’s development efforts is greatly appreciated.

Use Cases

There are numerous applications for satellite based position location information, including:

1. Blue Force Tracking

2. Search & Rescue (SAR)

3. Partner Forces PLI

4. Asset Tracking

5. Data diode, CDS & cybersecurity considerations

INRCOT may also be of use in wildland firefighting, see Section 1114.d of the Dingell Act:

Location Systems for Wildland Firefighters.--
(1) In general.--Not later than 2 years after the date of
    enactment of this Act, subject to the availability of
    appropriations, the Secretaries, in coordination with State
    wildland firefighting agencies, shall jointly develop and
    operate a tracking system (referred to in this subsection as the
    ``system'') to remotely locate the positions of fire resources
    for use by wildland firefighters, including, at a minimum, any
    fire resources assigned to Federal type 1 wildland fire incident
    management teams.

Requirements

INRCOT uses the Garmin Explore “MapShare” feature.

1. Login to Garmin Explore: https://explore.garmin.com/

2. Browse to the “MY INFO” page: https://explore.garmin.com/Inbox

3. Click “Social”.

4. Under MapShare > Enable MapShare click to enable ‘MapShare: On’.

5. Click “Feeds” and note the “Raw KML Data” URL, we’ll use this URL, write it down.

For more information on inReach KML Feeds see: https://support.garmin.com/en-US/?faq=tdlDCyo1fJ5UxjUbA9rMY8

Install

INRCOT functionality is provided via a command-line tool named inrcot. To install inrcot:

Debian, Ubuntu, Raspbian, Raspberry OS:

$ sudo apt update
$ 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/inrcot/releases/latest/download/python3-inrcot_latest_all.deb
$ sudo apt install -f ./python3-inrcot_latest_all.deb

CentOS, et al:

$ sudo python3 -m pip install inrcot

Install from source:

$ git clone https://github.com/ampledata/inrcot.git
$ cd inrcot/
$ python3 setup.py install

Usage

The inrcot program has two command-line arguments:

$ inrcot -h
usage: inrcot [-h] [-c CONFIG_FILE]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG_FILE, --CONFIG_FILE     Sets the path to a config file. Default: config.ini

Configuration

Configuration parameters can be specified either via environment variables or in a INI-stile configuration file. You must create a configuration file, see example-config.ini in the source respository.

Parameters:

• DEFAULT_POLL_INTERVAL: How many seconds between checking for new messages at the Spot API? Default: 120 (seconds).

• DEFAULT_COT_STALE: How many seconds until CoT is stale? Default: 600 (seconds)

• DEFAULT_COT_TYPE: CoT Event Type / 2525 type / SIDC-like. Default: neutral ground

TLS & other configuration parameters available via PyTAK.

Example Configurations

An example config:

[inrcot]
COT_URL = tcp://takserver.example.com:8088
POLL_INTERVAL = 120

[inrcot_feed_aaa]
FEED_URL = https://share.garmin.com/Feed/Share/aaa

Multiple feeds can be added by creating multiple inrcot_feed sections:

[inrcot]
COT_URL = tcp://takserver.example.com:8088
POLL_INTERVAL = 120

[inrcot_feed_xxx]
FEED_URL = https://share.garmin.com/Feed/Share/xxx

[inrcot_feed_yyy]
FEED_URL = https://share.garmin.com/Feed/Share/yyy

Individual feeds CoT output can be customized as well:

[inrcot]
COT_URL = tcp://takserver.example.com:8088
POLL_INTERVAL = 120

[inrcot_feed_zzz]
FEED_URL = https://share.garmin.com/Feed/Share/zzz
COT_TYPE = a-f-G-U-C
COT_STALE = 600
COT_NAME = Team Lead
COT_ICON = my_package/team_lead.png

Protected feeds are also supported:

[inrcot]
COT_URL = tcp://takserver.example.com:8088
POLL_INTERVAL = 120

[inrcot_feed_ppp]
FEED_URL = https://share.garmin.com/Feed/Share/ppp
FEED_USERNAME = secretsquirrel
FEED_PASSWORD = supersecret

Source

INRCOT Source can be found on Github: https://github.com/ampledata/inrcot

Author

INRCOT is written and maintained by Greg Albrecht W2GMD [e-mail]

https://ampledata.org/

Copyright

INRCOT is Copyright 2022 Greg Albrecht

License

Copyright 2022 Greg Albrecht <[e-mail]>

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.