OTN

Introduction

Open Tak Navigation is an open source project for the TAK environment.

The project started back when the VNS (Vehicle Navigation Sytem) was not yet publicly available, with the same prime objective to deliver an offline routing instrument for the ATAK app. OTN manages this making use of Open Street Map data and the GraphHopper routing engine, but the project aims to integrate many other improvements and features.

The project is comprised of two parts, OTN, the main plug-in for the ATAK app, and OTN-C (OTN-Companion), a computer program to generate the graphs needed for the routing.

A new release is on the way. The project is soon to be out of beta.

Note

OTN can't directly generate a graph for the routing on the phone itself. For this purpose, check out OTN-C.

For users

1. On your pc, generate the graphs of the geografical area you need using OTN-C.
2. On the GitHub project page, go to releases and download the .apk file relative to your Atak version.
3. Install the .apk on your smartphone.
4. Copy the graphs you generated with OTN-C in the atak\tools\otn\graphs directory.
5. On the Atak app, go to the plugins list and load OTN.
6. Now that OTN is loaded, go to the routes tool and select OTN offline routing as the routing method.
7. Pick a starting point, a destination and a profile.
8. Success! Here's a cat to celebrate!

Current features:

• Implementation of route around regions.
• Possibility to route through waypoints.
• Support for multiple graph storage on your device. Easy to pick one for each route in app.
• Ruting engine has been updated from GraphHopper 4 to GraphHopper 6.
• New GUI realized following Arsenal guidelines.
• The graph area can now be displayed as an overlay (note: the graph must contain its polyline).
• New preference menu.
• Routing mode toggle between memory mode and flash mode.
• Manual available here.

Future Features:

• 3D routing calculations using DTED.
• Support for online routing engines.
• Different vehicles recogntion from the ATAK route system.

Current limitations:

• Graphs must be located in atak\tools\OTN\graphs.
• Bloodhund is implemented and should be stable, but further testing is required.
• Geocode and reverse-geocode are set to the Atak default ones, which up to version 4.8.1 and below have been reported to cause some issues on some devices.
• Errors and/or crashes may still occur. If so enable logcat and kindly share the logs with us. Logs ar found at atak\support\logs. We will do our best to fix all bugs.

For developers

The steps to compile repo are based on this.

1. Create keystore, using keytool type jks, named keystore.debug in \ca key alias: androiddebugkey keypassword and keystore password: android
2. Open the repo folder in AndroidStudio.
3. Install sdk21 (min sdk).
4. Synch gradle project.
5. Because of a Proguard limitations, dependency libraries that have module info.class and multirelease.class must be 'hacked': Copy the .jar file from the remote repository and remove those two module types, save the file and place it back in the libs directory. The hacked libraries aren't on git. To find them, check the build.gradle :app the dependency are listed as a local import.
6. Build.

Contact

For any issue, suggestion or question, feel free to open an issue on the GitHub issues page.

License

check the license.md

---

plugin developed and tested on a huawei p10 light (android 8.0 API 26) 4gb ram kirin658 cpu atak version 4.7.0.3 developer build (28/07/2022).