dump1090

dump1090
Name	dump1090
Developer	GNU Radio contributors, community developers
Latest release	2018-2020 (various forks)
Programming language	C, C++
Operating system	Debian, Ubuntu, Raspbian, Windows, macOS
Platform	x86, ARM
Genre	Software defined radio, ADS‑B decoder
License	MIT, GPL (various forks)

dump1090

dump1090 is an open-source Mode S and ADS‑B decoder and network broadcaster for software‑defined radio receivers, designed to process 1090 MHz signals sent by transponders on civil aircraft. It provides real-time decoding, plotting, and forwarding of aircraft surveillance data to clients and aggregators such as FlightRadar24, FlightAware, OpenSky Network, ADSBExchange, and local flight-tracking dashboards. Originally authored to complement low-cost receivers like the RTL2832U dongle and platforms such as the Raspberry Pi, it became central to DIY aviation tracking, hobbyist communities, and research projects in surveillance and signal processing.

Overview

dump1090 implements decoding of Mode S downlink and automatic dependent surveillance–broadcast (ADS‑B) messages transmitted on 1090 MHz by transponders installed on aircraft such as those operated by Boeing, Airbus, Embraer, and Bombardier. The software demodulates raw IQ samples from front ends like the Realtek RTL2832U‑based USB DVB‑T receivers and hardware such as the Airspy and SDRplay devices. It outputs decoded fields including ICAO 24‑bit addresses, position, altitude, velocity, and squawk codes compatible with network protocols used by collectors including Beast, Basestation, and SBS‑1. The project intersected with communities around GNU Radio, SoapySDR, PiAware, and various mapping and visualization tools.

History and Development

Initial work on 1090 MHz decoders emerged alongside the growth of affordable SDR hardware and projects like rtl-sdr and GNU Radio. Early contributors included community developers and hobbyists who adapted algorithms for Mode S frame detection, pulse‑position demodulation, and error‑checking derived from ICAO specifications. Over time, forks and successors appeared to add features such as improved multi‑threading, GUI visualization, and network services; notable downstream projects were integrated with platforms like Raspberry Pi Foundation devices used by volunteers for FlightAware and FlightRadar24 feeders. The ecosystem matured through collaboration at forums and events such as DEF CON, makerspaces, and regional aircraft spotting clubs.

Features and Functionality

dump1090 supports real‑time demodulation, DF (downlink format) parsing, Mode S parity validation, and surface/airborne position decoding using both raw ADS‑B and multilateration inputs. It provides JSON and Beast binary interfaces consumed by display projects such as VirtualRadarServer, VRS installations, and web maps built on Leaflet or OpenLayers. Advanced forks introduced MLAT support by forwarding timestamped samples to collectors using protocols adopted by networks like OpenSky Network. It also offers spectrum visualization and signal reporting useful to researchers affiliated with institutions such as MIT, ETH Zurich, and University of Cambridge for studies in passive surveillance and airspace monitoring.

Installation and Usage

Typical deployment uses a low‑cost USB SDR (e.g., RTL2832U) attached to a small computer like a Raspberry Pi running Raspbian or Debian. Installation usually involves compiling from source with toolchains from GCC and linking against SDR libraries like librtlsdr or libusb. Run modes include a command‑line daemon that feeds decoded messages to web servers, collectors, or local databases managed by projects such as InfluxDB and Grafana for visualization. Community guides often reference integration with feeders for FlightAware's PiAware image and instructions published by organizations including FlightAware and volunteer groups in the ADS-B Exchange network.

Performance and Limitations

Performance depends on antenna quality, radio front end, computing platform, and RF environment near infrastructures like airports and urban transmitters. On decent hardware, dump1090 decodes thousands of ADS‑B messages per hour and can support multiple simultaneous client connections; however, limitations include sensitivity to co‑channel interference caused by strong nearby transponders, packet loss on congested USB buses, and degraded decoding at low signal‑to‑noise ratios. Multilateration accuracy requires time‑synchronized inputs and dense receiver networks similar to those operated by OpenSky Network and regional ADS‑B feeders. Legal and regulatory constraints established by authorities such as FAA and EASA influence acceptable collection and sharing practices in various jurisdictions.

Forks and Related Projects

Several forks evolved to address stability, feature expansion, and licensing. Notable related projects include a multi‑threaded variant optimized for embedded devices, network‑forwarding builds used by FlightAware's PiAware, and community forks adding web interfaces and map overlays that interoperate with VirtualRadarServer and ADSBHub. Complementary software in the ecosystem includes demodulators and data pipelines like dump978 for 978 MHz UAT, the SDR# family for Windows, and libraries from OSS contributors who build tools for research groups and spotting communities. The result is an expansive network of interoperable tools favored by aviation enthusiasts, academic researchers, and volunteer data collectors.

Security and Privacy Considerations

ADS‑B transmissions are unencrypted and include aircraft identifiers and positional data, raising privacy and operational security discussions among stakeholders such as commercial operators (IATA) and regulatory agencies (FAA, EASA). Researchers and operators recommend careful handling of logs and selective sharing to respect policies like controlled airspace protections and European privacy regulations (e.g., instruments enacted by European Commission). Misuse scenarios include unauthorized tracking of sensitive flights operated by entities such as diplomatic missions and law enforcement; mitigations include network access controls, data minimization, and participation in anonymization efforts by community aggregators and institutions like OpenSky Network that provide curated data access.

Category:Software for radio receivers