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 |