Dronology Documentation

We recommend that you follow the quick installation guide at the end of this page. For additional information please read the more detailed installation instructions.

Installation

Setting up and Installing Dronology requires 3 different parts to be installed:

• Python, Dronekit and SITL is requried to run the Groundcontrol Station and simulate Virtual UAVs using the Ardupilot Software-in-the-Loop SITL simulator

• The Dronology Groundstation - GCS (Python)

• The Dronology Core (Java)

Scripts:

We provide shell scripts for installing Dronekit and SITL setup_dronekit.sh, installing the Dronology-GCS setup_dronology_GCS.sh, and installing the Dronology Core setup_dronology_core.sh in Linux (tested in Ubuntu 16 and 18)

---

Before running the install scripts please make sure that you change the variables accordingly!!

---

• REPOS_DIR: the (relative) local directoy the repository will be cloned to (default: git).
• REPOS_PARENT_DIR: the parent folder of the git directoy the repository will be cloned to (default: $HOME, i.e., /home/username).
• REPO_URL The URL of the github repo (usually does not need to be changed).
• REPO_NAME The name of the repository
• BRANCH: The branch to use.

Setup

Per default Dronology is configured to run on a single machine. If either the Dronology UI and/or the Dronology GCS are supposed to run on a different machine please follow these instructions: Distributed Setup

Run

Run Dronology

Scripts:

We provide scripts for running Dronogy shell script which only runs Dronology or tmux script which runs both Dronology and the Groundstation UI (requires tmux 2.6 or higher) and the Dronology Groundstation GCS-UI shell script, GCS Runner shell script

Misc

Quick Installation Guide:

Please check the scripts before running and adapt target installation locations if necessary!

1. Clone this repository
2. run setup_dronekit.sh in scripts Folder
3. run setup_dronology-GCS.sh in scripts Folder
4. run setup_dronology-core.sh in scripts Folder
5. run mvn clean in Dronology-Core folder
6. run mvn install in Dronology-Core folder
7. check Dronology-GCS/multi_comm/cfg/global_cfg.json. Update the ardupath to reflect the correct path to ardupilot (e.g., replace UAV with your user name).
8. Either run run_dronology.sh and run_dronology-GCS_ui.sh or run_dronology_tmux.sh in scripts Folder. To run the tmux script you'll need to install tmux (apt-get install tmux) first. (The GUI for connecting physical UAVs or created simulated ones should appear within about 1 minute.) To test Dronology create one or more virtual drones using the "add virtual drone" button.
9. Open your browser with the url: http://localhost:8080/vaadinui/ If everything is setup correctly UAVs will appear on the map and in the left hand panel within about 1 minute.

Docker Container

coming soon..

VM Image

We provide a fully configured VMWare and VirtualBox image. Dronology and GCS code can be found in the /home/uav/git folder. To start Dronology execute the run-dronology.sh shell script on the Desktop.

Please contact us for further information on the VM Image and the download link.