# Connecting a drone to the software

#### Connecting a Drone

**Overview**

Connecting your drone to Asv.Drones is a straightforward process that involves creating a TCP client port through the "Connections" tab. This establishes a communication link between the software and your drone, enabling seamless control and data exchange during missions.

**Steps to Connect a Drone**

1. **Open Asv.Drones:**
   * Launch Asv.Drones on your device.
2. **Navigate to the "Connections" menu in Settings:**
   * Locate and click on the "Ports" sub-menu.

![](https://1971512749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F89kZVDkCsTPUIdsj8tit%2Fuploads%2Fgit-blob-6094ca3fca1f1e918bcc7921aac69adb7f33f75d%2Fconnections-page-empty.png?alt=media)

3. **Create a New TCP Client Port:**
   * Within the "Connections" tab, find the option to create a new TCP port.
   * Choose "TCP Client" as the connection type.

![](https://1971512749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F89kZVDkCsTPUIdsj8tit%2Fuploads%2Fgit-blob-44af9ae58aa64ea0433573de86863d296fa39dde%2Fconnections-page-add-tcp.png?alt=media)

4. **Configure Connection Settings:**
   * Enter the necessary details, including port name, the drone's IP address and port number.
   * Ensure that the specified port is open and accessible for communication.
5. **Save and Activate Connection:**
   * Save the configuration settings.
   * Activate the connection to establish a link between Asv.Drones and the drone.

![](https://1971512749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F89kZVDkCsTPUIdsj8tit%2Fuploads%2Fgit-blob-8b271e8fe559524a7642b06df32bed30a85eb0f4%2Fconnections-page-established-connection.png?alt=media)

6. **Verify Connection Status:**
   * Check the connection status at "Device list" sub-menu to confirm a successful link.
   * If the connection is established, you are ready to control and monitor your drone using Asv.Drones.

![](https://1971512749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F89kZVDkCsTPUIdsj8tit%2Fuploads%2Fgit-blob-228a7685199b85263f75b43abd70c2231c08be91%2Fconnections-page-connected-devices.png?alt=media)

**Additional Considerations**

* **Firewall Settings:**
  * Ensure that any firewall or security software on your device allows communication through the specified port.
* **Drone Compatibility:**
  * Confirm that your drone is compatible with Asv.Drones. Check for specific compatibility requirements in the drone's documentation.
* **Telemetry Data:**
  * Once connected, the software will start receiving real-time telemetry data from the drone, providing insights into its status and performance.

**Troubleshooting**

If you encounter issues during the connection process, ensure that the drone is powered on, within range, and the specified connection details are accurate.

#### Example Configuration:

* **Port title:** My new port
* **IP Address:** 127.0.0.1
* **Port Number:** 5762
* **Connection Type:** TCP Client

By following these steps, you can establish a reliable connection between Asv.Drones and your drone, unlocking the full potential of the software for mission planning, control, and data analysis.