dot15d4

dot15d4 is a IEEE 802.15.4 frame parsing library written in Rust. It uses the same style of parsing and emitting as the smoltcp library.

Another library that is similar to dot15d4 is the ieee802154 library. However, dot15d4 is more focused on implementing MAC layer functionality (unslotted CSMA and TSCH), and parsing frames.

Usage

[!NOTE] This library is still in development and is not yet published to crates.io.

Add this to your Cargo.toml:

[dependencies]
dot15d4 = "0.1.0"

For more information, see the API documentation.

dot15d4 as a binary

This repository also contains a binary that can be used to parse IEEE 802.15.4 frames.

Usage

dot15d4 40ebcdabffff0100010001000100003f1188061a0e0000000000011c0001c800011b00

Output:

Frame Control
  frame type: Enhanced Beacon
  security: 0
  frame pending: 0
  ack request: 0
  pan id compression: 1
  sequence number suppression: 1
  information elements present: 1
  dst addressing mode: Short
  src addressing mode: Extended
  frame version: 2 (Ieee802154_2020)
Addressing
  dst pan id: abcd
  dst addr: ff:ff (broadcast)
  src addr: 00:01:00:01:00:01:00:01
Information Elements
  Header Information Elements
    HeaderTermination1
  Payload Information Elements
    MLME
      TschSynchronization
        ASN: 14, join metric: 0
      TschTimeslot
        slot ID: 0
      ChannelHopping
        sequence ID: 0
      TschSlotframeAndLink
        #slot frames: 0

Coverage

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.