Crate spacepacket

Yet another CCSDS space packet protocol implementation with built in encoding and decoding.

Why another packet crate?

This crate’s interface provides a wrapper for a CCSDS packet payload (including secondary headers), opposed to just parsing header bytes. The full packet is parsed into a SpacePacket struct, all overhead for the payload encoding length (including with CRC validation) is handled for the end user.

This crate was created after viewing other rust-based CCSDS crates and wanting a more friendly user interface for packet interaction.

Currently this crate assumes Big Endian for all byte streams. Though this may change to be generic over endian in the future.

Optional Features

CRC Support

This crate provides data validation via CRC-16 calculation through the crc crate.

Sink/Stream Support

Another optional feature this crate provides is support for for sapcepacket I/O via sinks and stream through the async-codec and tokio-codec features. This allows users to easily create asynchronous listeners for spacepackets with optional sync markers and CRC support.

Examples

use spacepacket::{GroupingFlag, PacketType, SpacePacket};

let payload = b"secret payload".to_vec();
let packet = SpacePacket::new(
    0,
    PacketType::Command,
    0x012,
    GroupingFlag::Unsegm,
    3,
    true,
    payload,
);

let bytestream = packet.encode();
let recovered_packet = SpacePacket::decode(&mut bytestream.as_slice()).unwrap();
assert_eq!(packet, recovered_packet)

Modules

• codecasync-codec or tokio-codec
  This module provides implementations to provide Sink/Stream support for parsing SpacePackets from network data with a synchronization marker.
• crccrc
  A re-export of the crc crate.

Structs

• PrimaryHeader
  CCSCS Primary header defined in 133.0-B-2 June 2020 This struct is only mean to be used within a SpacePacket to contain all information on the packet. The packet length is omitted because it is calculated at encoding time.
• SpacePacket
  CCSCS Space Packet defined in 133.0-B-2 June 2020 Primary header generated automatically when initializing this structue.

Enums

• CompletePacket
  A thin wrapper for CRC enable SpacePackets This is used to distinguish between a packet with an invalid CRC but valid form And and unrecoverable decoding error.
• GroupingFlag
  CCSDS grouping flag to determine packet location in a stream.
• PacketType
  Possible CCSDS packet types. Used to differentiate between command and telemetry packets.