Crate adsb_deku

Expand description

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

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`

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.