Repository navigation
Installation and Usage
The system consists of a web application running on the host. The sniffing service is written in Python and is responsible for monitoring, capturing, and filtering incoming Wi-Fi Beacon frames as well as checking whether the packets contain a valid Remote ID.
The system is meant to run in any Linux distribution. For better portability we suggest installing it into a Raspberry Pi that will run the monitoring service and will expose a web user interface that can be accessed from any other device, independently of the platform, as long as it is on the same network.
Our setup consisted of a Raspberry Pi 4 running a Lite OS 64-bit and an iPad Air 4th Generation. However, performance on RPI can be low and sometimes a lot of packets are lost.
A useful advantage of installing the system on a Raspi is its portability. Once set up, it can simply be plugged into most devices and is ready to go without requiring any client-side installation but only a web browser.
In our tests we installed Lite OS 64-bits into a Raspberry Pi 4.
To install the application on the Raspi, connect to it from another device via ssh:
ssh <raspberrypi_hostname>@raspberrypi_ipaddress>.local
Download the repository and follow the installation steps mentioned in the README file
The user can interact with the monitoring system via the web UI. The system's UI can be accessed via a web browser over the local network and it has been tested with the following web browsers: Safari, Chrome and Firefox.
- a WLAN interface with monitoring/promiscuous capabilities (e.g., EDIMAX EW-7811Un Wi-Fi adapter)
- a client with Internet connection and a browser to access the web UI. The client can be the same machine running the system or an additional device (if a RPI is used to run the system) connected to the same network.
Note: make sure you have the right drivers for the wireless adapters to be in monitor mode. Some kernels do not bring them installed by default.
If the installation was done on a laptop no additional client is needed. If the installation was done on a Raspi, connect the client to the same network as the Raspi (LAN/WLAN) and browse the Raspi's IP address from the web browser.
From the client device open a browser and visit <web_app_host_ip>.
Whenever a user accesses the application for the first time, a setup view appears (see below), requesting a google maps key.

To start monitoring, a WLAN interface (with monitor mode capabilities) has to be chosen via the Settings (in the top left corner) and saved.
The WLAN interface has to be plugged into the system where the installation was done (e.g., RPI or Laptop running the app) before running the application.
Actively monitored drones are listed in the list in the bottom left corner. Optionally the flown path of the drone as well as the pilot location ("P"-pin) and the starting point (home location, "H"-pin). Each drone receives its own colour to distinguish the different drones. To display drone details, simply click on the drone.

An already completed flight of a drone can be replayed by the "play"-button displayed in the metrics data of the drone. This can be opened by either clicking on a drone or via the "Active Drones" list and clicking the metrics-emoji.

For further instructions please read Section 5.2.2 of the Bachelor thesis.