adsb_deku

Decoder for ADS-B(Automatic Dependent Surveillance-Broadcast) Downlink Format protocol packets from 1090mhz. See dump1090rs for a Rust demodulator. View planes in the sky around you, with only a rtl-sdr!

See quickstart-guide for a quick installation guide.
See rsadsb-2024.09.02 for latest major release details.
This library uses deku for deserialization of protocol.

Applications

Minimum required rust version: 1.84.0.

Client Applications

Client applications use this library to display the data accumulated from an ADS-B demodulation server in various ways.

radar tui

An ADS-B client for the terminal written in Rust. Radar connects to an ADS-B demodulation server and stores this info, allowing an operator to control the display of the data.

Map Tab - Plot currently detected aircraft on lat/long grid. Add known locations with --locations option.
Coverage Tab - Plot all detected aircraft lat/long positions since starting radar. Features grayscale heatmap.
Aircraft Tab - Show detailed table of information about currently detected aircraft. Set aircraft position as center lat/long.
gpsd - Derive lat/long from a gpsd instance using --gpsd flag.

See apps/README.md for map control keybindings.

This application uses ratatui for generating the display to the terminal.

# Startup "radar" display in tui relative to your antenna position
> cargo r --bin radar --release -- --lat="50.0" --l --locations "(name,lat,long)" "(name,lat,long)"

1090

Display protocol data structures and currently tracked planes using this library in the same fashion as dump1090-fa to a terminal stdout. Optionally panic on missing implementation or fmt::Display, see > ./1090 -h.

# Startup 1090 decode chain using this library
> cargo r --bin 1090 --release -- --debug

1090 Example

Server/Demodulation(External) Applications

This library contains logic for decoding a message, you must use a server for demodulating the message from 1090mhz into bytes usable by this library. These are called Server applications.