adsb_deku

Decoder for ADS-B(Automatic Dependent Surveillance-Broadcast) Downlink Format protocol packets from 1090mhz. Derived from Aeronautical Telecommunications Volume IV: Surveillance and Collision Avoidance Systems, Fifth Edition and ICAO 9871.

This library uses deku for serialization/deserialization of protocol.

Downlink Format support

| DF | Name | Section | | ---- | ------------------------------- | ----------- | | 0 | Short Air-Air Surveillance | 3.1.2.8.2 | | 4 | Surveillance Altitude Reply | 3.1.2.6.5 | | 5 | Surveillance Identity Reply | 3.1.2.6.7 | | 11 | All Call Reply | 2.1.2.5.2.2 | | 16 | Long Air-Air Surveillance | 3.1.2.8.3 | | 17 | Extended Squitter(ADS-B) | 3.1.2.8.6 | | 18 | Extended Squitter(TIS-B) | 3.1.2.8.7 | | 19 | Extended Squitter(Military) | 3.1.2.8.8 | | 20 | Comm-B Altitude Reply | 3.1.2.6.6 | | 21 | Comm-B Identity Reply | 3.1.2.6.8 | | 24 | Comm-D | 3.1.2.7.3 |

Comm-B support

| BDS | Name | Table | | ---- | ----------------------------------- | ----------- | | (0,0) | Empty | | | (1,0) | Data Link Capability | A-2-16 | | (2,0) | Aircraft Identification | A-2-32 |

ME support for ADSB Messages

| ME(Type Code) | Name | | --------------- | ------------------------------ | | 0 | NoPosition | | 1..=4 | AircraftIdentification | | 5..=8 | SurfacePosition | | 9..=18 | AirbornePositionBaroAltitude | | 19 | AirborneVelocity | | 20..=22 | AirbornePositionGNSSAltitude | | 23 | Reserved0 | | 24 | SurfaceSystemStatus | | 25..=27 | Reserved1 | | 28 | AircraftStatus | | 29 | TargetStateAndStatusInformation| | 30 | AircraftOperationalCoordination| | 31 | AircraftOperationStatus |

example usage

```rust use hexlit::hex; use adsbdeku::Frame; use adsbdeku::deku::DekuContainerRead;

let bytes = hex!("8da2c1bd587ba2adb31799cb802b"); let frame = Frame::frombytes((&bytes, 0)).unwrap().1; asserteq!( r#" Extended Squitter Airborne position (barometric altitude) ICAO Address: a2c1bd (Mode S / ADS-B) Air/Ground: airborne Altitude: 23650 ft barometric CPR type: Airborne CPR odd flag: even CPR NUCp/NIC: ? CPR latitude: (87769) CPR longitude: (71577) "#, frame.to_string() ); ```

Build the docs(> cargo doc), or see docs.rs for complete public API documentation.

testing and development

testing

Test data was generated using a rtl-sdr with dump1090-fa. ```text

cargo test ```

For testing this library, you can run our app 1090 with the following options for exiting program on missing fmt::Display or bytes protocol decode. ```text

cargo r --release --bin 1090 -- --debug --disable-airplanes --panic-decode --panic-display ```

This library is also fuzzed, ensuring no panic when parsing from demodulated bytes. ```text

cargo fuzz run fuzztarget1 ```

fmt

```text

cargo +nightly fmt ```

Applications

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.

(C) dump1090_fa

This is the most tested application/implementation of 2400 sample rate demodulation used by flightaware.

```text

./dump1090 --net --quiet ```

(Rust) dump1090_rs

This is a fork of dump1090_rs with only demodulation and data forwarding functions. ```text

cargo r --release ```

Client Applications

Client applications use this library to display the data accumulated in various ways.

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.

```text

Startup 1090 decode chain using this library

cd apps cargo r --bin 1090 --release -- --debug ```

radar tui

An ADS-B client for the terminal written in Rust. Radar connects to a demodulation server and displays the latitude/longitude output into a Map that is controllable by an operator. The binary also has the Coverage display which shows a history of aircraft locations and an Aircraft table for quickly zooming into a Aircraft on a map.

```text

Startup "radar" display in tui relative to your sdr position

cd apps cargo r --bin radar --release -- --lat="50.0" --long="50.0" --cities "(name,lat,long)" "(name,lat,long)" ```