Repository files navigation

dump1090-fa is a ADS-B, Mode S, and Mode 3A/3C demodulator and decoder thatwill receive and decode aircraft transponder messages received viaa directly connected software defined radio, or from data provided over anetwork connection.

It is the successor todump1090-mutability and ismaintained byFlightAware.

It can provide a display of locally received aircraft data in a terminal orvia a browser map. Together withPiAwareit can be used to contribute crowd-sourced flight tracking data to FlightAware.

It is designed to build as a Debian package, but should also be buildable onmany other Linux or Unix-like systems.

$ sudo apt-get install build-essential fakeroot debhelper librtlsdr-dev pkg-config libncurses5-dev libbladerf-dev libhackrf-dev liblimesuite-dev libsoapysdr-dev$ ./prepare-build.sh bullseye# or buster, or stretch$cd package-bullseye# or buster, or stretch$ dpkg-buildpackage -b --no-sign

(Supported for bullseye and buster builds only)

The package supports some build profiles to allow building without allrequired SDR libraries being present. This will produce a package withlimited SDR support only.

Pass--build-profiles todpkg-buildpackage with a comma-separated list ofprofiles. The list of profiles should includecustom and zero or more ofrtlsdr,bladerf,hackrf,limesdr, 'soapysdr' depending on what you want:

$ dpkg-buildpackage -b --no-sign --build-profiles=custom,rtlsdr# builds with rtlsdr support only$ dpkg-buildpackage -b --no-sign --build-profiles=custom,rtlsdr,bladerf# builds with rtlsdr and bladeRF support$ dpkg-buildpackage -b --no-sign --build-profiles=custom# builds with _no_ SDR support (network support only)

You can probably just run "make" after installing the required dependencies.Binaries are built in the source directory; you will need to arrange toinstall them (and a method for starting them) yourself.

make BLADERF=no will disable bladeRF support and remove the dependency onlibbladeRF.

make RTLSDR=no will disable rtl-sdr support and remove the dependency onlibrtlsdr.

make HACKRF=no will disable HackRF support and remove the dependency onlibhackrf.

make LIMESDR=no will disable LimeSDR support and remove the dependency onlibLimeSuite.

make SOAPYSDR=no will disable SoapySDR support and remove the dependency onlibSoapySDR.

Minimal testing on Mojave 10.14.6, YMMV.

$ brew install librtlsdr$ brew install libbladerf$ brew install hackrf$ brew install pkg-config$ make

Minimal testing on 12.1-RELEASE, YMMV.

# pkg install gmake# pkg install pkgconf# pkg install rtl-sdr# pkg install bladerf# pkg install hackrf$ gmake

dump1090-fa usesstarch to buildmultiple versions of the DSP code and choose the fastest supported by thehardware at runtime. The implementations chosen can been seen by runningdump1090-fa --version.

The implementations used are controlled by "wisdom files", a list ofimplementations to use in order of priority. For each DSP function, the firstimplementation listed that's supported by the current hardware is used.By default dump1090-fa provides compiled-in wisdom forx86,ARM 32-bit, andARM 64-bit. If the defaultsare not suitable for your hardware or if you're building on a differentarchitecture, you may want to generate your own external wisdom file.

Ideally, to get stable results, you want to do this on an idle systemwith CPU frequency scaling disabled. Running the benchmarks will takesome time (10s of minutes).

Run/usr/share/dump1090-fa/generate-wisdom. Wait.

Follow the instructions to copy the resulting wisdom file to/etc/dump1090-fa/wisdom.local.

Restart dump1090.

Runmake wisdom.local. Wait.

Copy the resultingwisdom.local file somewhere appropriate.

Update the dump1090-fa command-line options to include--wisdom /path/to/wisdom.local