Crate adsb_deku

adsb_deku provides decoding for the ADS-B Downlink protocol by using the deku crate.

See rsadsb.github.io for more details.

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 Altitude Reply and Comm-B Identity Reply Comm-B Support

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

Extended Squitter(ADS-B) and Extended Squitter(TIS-B) Type Code Support

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

Example

To begin using adsb_deku, import the Frame struct as well as the trait deku::DekuContainerRead. This trait is re-exported for your convenience. Frame::from_bytes() provides the interface for decoding bytes into adsb data.

use hexlit::hex;
use adsb_deku::Frame;
use adsb_deku::deku::DekuContainerRead;

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

Apps

The apps/ directory of the project repository contains programs radar and 1090 for showcasing different adsb_deku uses. See the README.md for examples of use.

Re-exports

pub use deku;

Modules

adsb

All data structures needed for parsing DF::ADSB or DF::TisB messages

bds

B-Definition Subfield for Comm-B Messages

cpr

Compact Position Reporting for Position Reporting

Structs

AC13Field

13 bit encoded altitude

Altitude

Latitude, Longitude and Altitude information

Frame

Downlink ADS-B Packet

ICAO

ICAO Address; Mode S transponder code

IdentityCode

13 bit identity code

UtilityMessage

Enums

CPRFormat

Even / Odd

Capability

Transponder level and additional information (3.1.2.5.2.2.1)

DF

Downlink Format (3.1.2.3.2.1.2)

DownlinkRequest

Type of DownlinkRequest

FlightStatus

Airborne / Ground and SPI

KE

Uplink / Downlink

Sign

Positive / Negative

SurveillanceStatus

SPI Condition

UtilityMessageType

Message Type