ADS‐B Aircraft Tracking - aaronwmorris/indi-allsky GitHub Wiki

Overview

indi-allsky can utilize data generated by a Software Defined Radio and ADS-B broadcasts to gather information about local aircraft in your region.

Hardware

A software defined radio [SDR] device such as a RTL-SDR RTL2832U USB dongle and an antenna are all that is necessary to receive aircraft ADSB Mode-S transmissions.

Note: The SDR does NOT need to run on the all sky camera device. It can run on a different device and the JSON data will be available via a web server.

Software

dump1090-mutability is available in the Debian repositories, but dump1090-fa should function just as well.

sudo apt-get install dump1090-mutability

# Indicate dump1090 should be started automatically at boot

Device permissions

sudo usermod -a -G plugdev dump1090

Web server

If you operate the SDR on the same system as your allsky camera, you will need to disable lighttpd since Apache is already installed.

sudo systemctl disable lighttpd

dump1090-mutability installs lighttpd for the web server component, but Apache is already use for indi-allsky. The Apache config for indi-allsky has some commented configuration to enable serving the aircraft.json file. /etc/apache2/sites-enabled/indi-allsky.conf

Location Precision

In order to accurately calculate the location of aircraft relative to your position, your latitude and longitude need to be defined with at least 2 digits of precision. Three digits of precision is recommended.

Testing ADS-B

There is a test script will will execute the same code that indi-allsky utilizes so you do not have to start the program to validate the behavior.

source virtualenv/indi-allsky/bin/activate

./misc/adsb_test.py

aircraft.json URL variations

Label Variables

Name Type Add Date Info
id str flight, squawk, or hex identifier. This ensures a name is assigned to the aircraft.
flight str flight id (may not be populated)
squawk str Aircraft squawk (may not be populated)
hex str ADS-B hex id
latitude float Geocentric latitude
longitude float Geocentric longitude
elevation float Pressure altitude
altitude float Alias of elevation
distance float Ground distance (km)
range float Range to aircraft (km)
alt float Angular altitude
az float Azimuth
dir str Cardinal direction from observer