# Precision Landing

Precision Landing is a feature that enables drones to land on the landing pad with high precision. This feature is useful when the drone needs to land in the docking station without any collision or damage to the drone while landing over the tag.

To perform a precision landing, the drone has to be above the landing tag, to trigger visual guidance for the drone to land in the docking station safely and precisely. This minimizes the need for manual intervention for the seamless landing of the drone in the Docking Station.

Once the drone is added and is online on the dashboard.

* Click on **Settings** from the right corner to configure **Precision Landing**.&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FiIt1m807x94vf5qpkIVN%2Fimage.png?alt=media&#x26;token=725c0e93-bfa2-490d-82a0-24267750e112" alt=""><figcaption><p>Settings</p></figcaption></figure>

*

```
Select the drone from the drop-down menu at the top left corner of the settings tab and click on the **Precision Landing** tab should be chosen.
```

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FQeoE89KQyCdSQcuOhIZo%2Fimage.png?alt=media&#x26;token=5c6d7dcc-02e6-4da6-9739-81f62196e4f8" alt=""><figcaption><p>Precision Landing Setting</p></figcaption></figure>

Before performing Precision Landing with the drone, it is important to ensure that certain settings have been properly configured:

**Landing Tags:** It is a combination of ArUco marker landing tags arranged in a particular format to guide the drone to the docking station while landing.

{% tabs %}
{% tab title="Vision- Precision Landing" %}

* The default precision landing mode is set to **Vision**, which uses ArUco markers for landing. But the operator check before configuring further settings.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FGUkiUfz6tN5V6BJnaaDd%2Fplmode-vision.png?alt=media&#x26;token=de7824b3-968a-47e0-9022-fd5ad269c32e" alt=""><figcaption><p>Precision Landing: vision mode</p></figcaption></figure>

* Click on **Add** to configure a Precision Landing tag for the selected drone.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FqxdtNbJDjCWLsdqsCFA1%2Fimage.png?alt=media&#x26;token=03c8e143-70f0-4958-bc6a-0a2c674ae6e9" alt=""><figcaption><p>Adding PL Tag</p></figcaption></figure>

* The operator can choose from the following set of tag altitudes from which the drone should trigger a precision landing.&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2F5hl853DssKaYLO37S211%2Fimage.png?alt=media&#x26;token=5081f7be-8b9c-4538-8d4c-93284d79d9c2" alt=""><figcaption><p>Different tag configurations</p></figcaption></figure>

{% hint style="success" %}
As the drone closes the distance between itself and the tag, the bigger tags exceed the Field of View (FOV) of the drone's camera. So a pattern with tags of different sizes is used, to cope with the minimum and maximum distance of detection.
{% endhint %}

* Once the height is set, click on **Next**.&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FSSY42EmqIn0ONplKm8Ei%2Fimage.png?alt=media&#x26;token=3e363d07-c0c1-4792-96a2-97e1feb5ca35" alt=""><figcaption><p>Setup an AruCo tag Tab</p></figcaption></figure>

* In the **What to expect tab,** read the points carefully mentioned & proceed ahead by **clicking on next.**&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FQutWVdpG2kDxfRvsd8Vr%2Fimage.png?alt=media&#x26;token=77d94b1e-f922-4125-a4de-80c76a4cc115" alt=""><figcaption><p>Requirement for Landing Tab</p></figcaption></figure>

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FvmyReiLnXverkGQ1EvK9%2Fimage.png?alt=media&#x26;token=e46fc87b-3ae9-4fb1-8164-6a09245f76c9" alt=""><figcaption><p>Requirement for Landing Tab</p></figcaption></figure>

**Landing Threshold:** This setting determines the altitude at which the drone will position itself over the target landing area before executing the DJI Land command. It allows for precise control over the altitude at which the drone begins its final descent for landing. The drone doesn't perform any recovery after reaching the threshold.

**Guided Final Approach:** This setting determines whether the drone will be guided all the way to the ground during the precision landing process, or whether it will only be guided to the landing threshold height before executing the DJI Land command. Enabling this setting will cause the drone to continue following the vision guidance all the way to the ground, allowing for a more precise landing. Disabling this setting will cause the drone to stop following vision guidance at the landing threshold height and execute the DJI Land command at the set Landing Threshold.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FLlUDMZkWGbTbB8ysnDcE%2Fimage.png?alt=media&#x26;token=edd1969f-d192-4aa5-8a78-bdcc373ed535" alt=""><figcaption><p>Precision Landing configurations</p></figcaption></figure>

### Precision Landing Failsafe

This failsafe action is triggered when the drone isn't able to perform PL during the set time interval due to either being unable to detect the tag while hovering over the docking station or being unable to maintain its position over the tag till the landing threshold altitude, making it perform precision landing failsafe action.&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2Fd6pqqjByRTkidIlFjZLW%2Fimage.png?alt=media&#x26;token=f071faa1-8766-4a08-8775-a6cd684bc24f" alt=""><figcaption><p>Configure Precision Landing Failsafe</p></figcaption></figure>

#### To trigger Precision Landing manually&#x20;

* When the drone is above the docking station or in the range for the drone to detect the precision landing tag trigger precision landing from the main dashboard manually by clicking the<img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FlFY7GCLViKrCeMO67sR3%2FGroup%2018481.png?alt=media&#x26;token=2f3244c8-8c44-4ad3-ab8e-07f8cec4eafe" alt="" data-size="line">icon located at the right bottom side of the dashboard.&#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FuHuaH4HkHOjtsjErpDnV%2Fimage.png?alt=media&#x26;token=99b27c33-19d2-4e34-be04-b2ee39b21527" alt=""><figcaption><p>Precision Landing icon</p></figcaption></figure>

#### **Triggering Vision-Precision Landing as pre-set final action**

To trigger vision- Precision Landing during missions, create the mission and configure the finish actions as:&#x20;

* **Return To Docking Station(RTDS)**\
  Setting finish action as RTDS will bring the drone back on top of the Docking Stations Location once the mission is completed. At the docking station location, the Precision Landing will be initiated and the drone will align itself with the ArUco marker tag to land precisely on the tag inside the Docking Station enclosure.&#x20;
* **Return To Home (RTH) with Precision Landing (RTH-PL)**\
  Setting finish action as RTH-PL will bring the drone back to its home location once the mission is completed. At the home location, Precision Landing will be initiated and the drone will align itself with the ArUco marker tag to land precisely at the home location.&#x20;
* **Land with Precision Landing** **(Land-PL)**\
  Setting the finish action as Land - Precision Land will initiate precision landing at the drone's current location. Users need to ensure that there is a landing pad below the drone's current location to use this finish action. Vision - Precision Landing will be initiated and the drone will align itself with the ArUco marker tag to land precisely.&#x20;

#### Aborting the Precision Landing Action and Taking Manual Control

To abort the drone's current action and regain manual control, click on the abort button<img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FbTvXheIe97wnxw7wzSQZ%2FPause.png?alt=media&#x26;token=dec48de2-8097-472c-a567-ac110dcffe72" alt="" data-size="line">.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FjM2UVxUO3u4QFVbWX0sB%2Fimage.png?alt=media&#x26;token=aee41b09-cb9c-4f4a-8ea8-2ae7a0c893a4" alt=""><figcaption><p>Aborting the current Precision Landing action</p></figcaption></figure>

* To regain [<mark style="color:blue;">manual control</mark>](https://legacydocs.flytbase.com/features/settings/key-binding) of the drone, click on the **Joypad** button and use the on-screen joypad, keyboard mouse, or joystick controls to fly the drone. Alternatively, the operator can switch the drone's RC mode from **P** to **S** for taking control of the drone using the physical RC controller.
  {% endtab %}

{% tab title="RTK- Precision Landing" %}
{% hint style="warning" %}
Even when using the FlytBase RTK-PL feature for precision landing, the operator is still required to configure the vision PL settings.&#x20;
{% endhint %}

* The default precision landing mode is set to **Vision**, which uses ArUco markers for landing. To switch to **RTK-based precision landing**, use the drop-down menu in the **Precision Landing** section of the **Settings** menu and select **RTK** as the landing mode.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FJf5ovhM2p3qcHB0d7Jb9%2Fimage.png?alt=media&#x26;token=d9f87a2e-7fdb-40f6-ae91-2b200c536397" alt=""><figcaption><p>Precision Landing: RTK selection mode</p></figcaption></figure>

{% hint style="info" %}
When using RTK positioning, the drone will not take off unless an RTK fix is obtained, regardless of the precision landing mode.
{% endhint %}

### Configuring RTK-PL Settings

* **Landing Threshold:** This setting determines the altitude at which the drone will position itself over the target landing area before executing the DJI Land command. It allows for precise control over the altitude at which the drone begins its final descent for landing. The drone doesn't perform any recovery after reaching the threshold.
* **RTK PL trigger height:** This setting allows the operator to set the altitude at which the drone will begin to perform an RTK-based precision landing. It allows for a minimum height to be specified at which RTK-based precision landing will be triggered, with options of 5, 10, or 15 meters. This helps ensure that the drone is at a safe altitude before initiating the precision landing process.
* **Guided Final Approach:** This setting determines whether the drone will be guided all the way to the ground during the precision landing process, or whether it will only be guided to the landing threshold height before executing the DJI Land command. Enabling this setting will cause the drone to continue following the RTK guidance all the way to the ground, allowing for a more precise landing. Disabling this setting will cause the drone to stop following RTK guidance at the landing threshold height and execute the DJI Land command at the set Landing Threshold.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FrCDBilvy9ObTH9Moh16K%2Fimage.png?alt=media&#x26;token=7186e877-520f-47e2-bda1-5b1f7376b7b1" alt=""><figcaption></figcaption></figure>

* **Precision Landing Failsafe**: This setting instructs the drone to perform the set failsafe action if it is unable to perform the RTK-PL-based landing due to issues with the RTK fix. Operators can navigate to the Failsafes section to set specific actions for their drones.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FdwHqbKfySWum2PvEJMYa%2Fimage.png?alt=media&#x26;token=e328c5c4-a2b5-42ed-8a5d-fe0c807e366f" alt=""><figcaption><p>Precision Landing Failsafe Setting</p></figcaption></figure>

## Expected Behavior during RTK-Precision Landing

{% hint style="info" %}
FlytBase only supports the D-RTK base station for now.
{% endhint %}

#### Successful Precision Landing

* Before starting a mission, the RTK base station must be turned on and connected to the drone.
* Once the RTK pole is connected, the drone's RTK positioning solution must be in "FIXED" or "FIXED\_POINT" mode, indicating that it has a stable and accurate position.&#x20;
* Before the drone takes off, the RTK's fixed position (GPS coordinates) and the drone's heading (orientation) are recorded by FlytBase.
* Precision Landing command is initiated only when the drone is within a **20m radius** of the docking station, and it utilizes real-time data from the RTK base station's fixed position to guide the drone for precise landing.
* The RTK-PL algorithm uses real-time kinematics and heading to maneuver the drone and land on the drone docking station with centimetre-level accuracy.

{% hint style="warning" %}
If the RTK positioning solution is not in "FIXED" or "FIXED\_POINT" mode, the drone will not be able to take off.
{% endhint %}

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FOoWEXV8SNTVTGEkEgYaa%2Fimage.png?alt=media&#x26;token=b9977f8f-d22a-42e5-b872-baf19ca199d7" alt=""><figcaption></figcaption></figure>

### When does the drone perform RTK- Precision Landing?&#x20;

{% hint style="warning" %}
Before initiating an RTK-based precision landing, ensure that the "Precision Landing mode" is set to "RTK" in the "Settings" menu. Failure to do so may result in the drone attempting to perform a vision-based precision landing, which may not be successful if the required conditions are not met.
{% endhint %}

The Drone can be configured to perform RTK- Precision Landing in case of the following mission scenarios :

#### Triggering RTK-Precision Landing manually from the FlytBase dashboard

* When the drone is in the air, the RTK- Precision Landing can be triggered by the dashboard clicking the RTK-PL button<img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FLyctfYXx0eAAXLrVUBFQ%2FGroup%2018335.png?alt=media&#x26;token=8abb620a-70c5-447e-b2b6-a0059b807ba4" alt="" data-size="line">from the control panel from the right-bottom corner. &#x20;

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FP0JjufFeOLcrB85gP3u5%2Fimage.png?alt=media&#x26;token=43770cfe-5eaf-44f5-b887-544f111c08be" alt=""><figcaption><p> Precision landing icon to trigger manual RTK-PL</p></figcaption></figure>

* The drone must be **within 20 meters** of the take-off position before activating the RTK-PL. Furthermore, the RTK data received from the RTK pole must be healthy, or RTK health must be OK. If the aforementioned conditions are met, the drone is permitted to perform RTK-PL.
* Once RTK-PL is triggered, FlytBase's Precision Landing (RTK-GPS Based) algorithm uses the recorded GPS coordinates and heading and real-time kinematics to manoeuvre the drone and land on the drone dock with centimetre-level accuracy.

{% hint style="warning" %}
The Precision Landing command is rejected if it is triggered more than 20 meters from the takeoff location.
{% endhint %}

#### **Triggering RTK-Precision Landing as pre-set final action**

To trigger RTK- Precision Landing during missions, create the mission and configure the finish actions as:&#x20;

* **Return To Docking Station(RTDS)**\
  Setting finish action as RTDS will bring the drone back on top of the Docking Stations Location once the mission is completed. At dock's the location, the RTK- Precision Landing will be initiated and the drone will align, approaches, and lands precisely inside the Docking Station enclosure.&#x20;
* **Return To Home (RTH) with Precision Landing (RTH-PL)**\
  Setting finish action as RTH-PL will bring the drone back to its home location once the mission is completed. At the home location, the RTK-Precision Landing will be initiated and the drone will align, approach, and lands precisely inside the Docking Station enclosure.&#x20;
* **Land with Precision Landing** **(Land-PL)**\
  Setting the finish action as Land (Precision Land) will initiate precision landing at the drone's current location. Users need to ensure that there is a landing pad below the drone's current location to use this finish action. RTK- Precision Landing will be initiated and the drone aligns, approaches, and lands precisely on the target area. &#x20;

## Aborting the RTK- Precision Landing Action and Taking Manual Control

To abort the drone's current action and regain manual control, click on the abort button<img src="broken-reference" alt="" data-size="line">.

<figure><img src="https://2978718896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYYKeStDMySe3v9HDpIo%2Fuploads%2FQfDUE9FyUZ3sylxp8LCn%2Fimage.png?alt=media&#x26;token=ab8b7745-72c6-4d8f-a8b9-72a7230af8b6" alt=""><figcaption><p>Aborting the Precision Landing action</p></figcaption></figure>

* To regain [<mark style="color:green;">manual control</mark>](https://legacydocs.flytbase.com/features/settings/broken-reference) of the drone, click on the **Joypad** button and use the on-screen joypad, keyboard mouse, or joystick controls to fly the drone. Alternatively, the operator can switch the drone's RC mode from **P** to **S** for taking control of the drone using the physical RC controller.

{% hint style="success" %}
For more information on common issues with DJI drones, please refer to the frequently Reported Issues [<mark style="color:green;">here</mark>](https://docs.flytnow.com/troubleshooting/troubleshooting-for-dji-drones).
{% endhint %}

{% hint style="info" %}
This feature an add-on and if you don't have it on your dashboard, that means it is not in your current package, please feel free to contact <mark style="color:green;"><support@flytbase.com></mark> if you find this feature useful and would like to add it.
{% endhint %}
{% endtab %}
{% endtabs %}
