Skip to content

Commit aa95d3f

Browse files
authored
Create FreeTAKUAS.md
1 parent 9ae639a commit aa95d3f

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

docs/docs/tools/FreeTAKUAS.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
![freeTAKUAS_Logo](https://user-images.githubusercontent.com/60719165/124395705-edc52180-dcdb-11eb-879b-725d486eaa43.png)
2+
3+
# Introduction
4+
FreeTAK UAS (FTUAS) is an Android application that can:
5+
* control any DJI drone supported by the current DJI SDK
6+
* Stream the position of the drone to all the connected TAK clients
7+
* Stream the video Feed to all the connected TAK clients
8+
9+
# Requirements
10+
* FreeTAK UAS app
11+
* DJI compatible drone
12+
* FTS v 1.9 (or better): the application will NOT support the legacy TAK server.
13+
* the FTS REST API service must be activated
14+
* You have a valid REST Token (created in the FTS UI under System User)
15+
* FTH Video Service (or compatible RTMP server) if you want to stream live videos
16+
17+
# Installation
18+
Assuming that you have installed and configured your [FTS](https://freetakteam.github.io/FreeTAKServer-User-Docs/Installation/PyPi/Linux/Install.html) and the [video service](https://github.com/FreeTAKTeam/FreeTAKHub/blob/main/README.md), download the APK installation file on your phone / tablet and follow the instructions.
19+
if the installation is suvcessful you should have a new Icon
20+
21+
![image](https://user-images.githubusercontent.com/60719165/124396013-9d4ec380-dcdd-11eb-8cf9-bf1deaa7adc0.png)
22+
23+
24+
# Usage
25+
26+
## Connection
27+
![image](https://user-images.githubusercontent.com/60719165/124395573-3e884a80-dcdb-11eb-8a89-9f6b4a8df202.png)
28+
* start your drone
29+
* start your controller
30+
* connect the phone with FTUAS to the controller
31+
* a popup will ask wich application you want to open
32+
* select FTUAS and configure the following:
33+
* FTS IP and Port
34+
* Video Server IP and port
35+
* the Drone name
36+
* Now click on UAS [READY]
37+
38+
## Interface
39+
![image](https://user-images.githubusercontent.com/60719165/124395601-64155400-dcdb-11eb-8142-67e14c08d712.png)
40+
the FTUAS interface is typical of DJI the following is special:
41+
* As soon you switch to it the drone will start streaming the camera
42+
* As soon you switch to it the drone will share his position with the FTS server, that will foward to all the connected clients
43+
* the "Red Dot" in the middle can be tappped to create a geoObject of type "Unknow" call target and send to all the connected clients
44+
* the vertical aim of the "Red Dot" can be changed by moving the gimbal
45+
* in some model, it's also possible to aim the gimbal independent from the position of the drone by dragging the position on screen
46+
* In the current version, the aim is not perfect so expect some delta
47+
48+
## ATAK Interface
49+
### Map
50+
![image](https://user-images.githubusercontent.com/60719165/124395620-77c0ba80-dcdb-11eb-88dd-f3eac3468962.png)
51+
In ATAK the drone shows:
52+
* a white zone (field of view)
53+
* a Sensor Point of Interest (SPI)
54+
* the position and name of the drone
55+
56+
### Menu
57+
![image](https://user-images.githubusercontent.com/60719165/124395651-9fb01e00-dcdb-11eb-892f-20e3eb8a3484.png)
58+
to visualize the video tap the drone's icon and then the video icon
59+
60+
### Video Player
61+
![image](https://user-images.githubusercontent.com/60719165/124395672-be161980-dcdb-11eb-9aea-162bd605080e.png)
62+
In alternative open the ATAK video player and search for the name of your drone
63+
64+
NOTICE: in the current version, every time a new video endpoint will be created, this must be manually deleted.
65+
66+

0 commit comments

Comments
 (0)