sat-rs/satrs-core/src/parsers/ccsds.rs

102 lines
3.2 KiB
Rust
Raw Normal View History

2023-09-18 16:17:24 +02:00
#[cfg(feature = "alloc")]
use alloc::vec::Vec;
#[cfg(feature = "alloc")]
use hashbrown::HashSet;
2023-09-18 18:27:08 +02:00
use spacepackets::PacketId;
2023-09-18 16:17:24 +02:00
use crate::tmtc::ReceivesTcCore;
2023-09-18 16:17:24 +02:00
pub trait PacketIdLookup {
2023-09-18 18:27:08 +02:00
fn validate(&self, packet_id: u16) -> bool;
2023-09-18 16:17:24 +02:00
}
#[cfg(feature = "alloc")]
impl PacketIdLookup for Vec<u16> {
2023-09-18 18:27:08 +02:00
fn validate(&self, packet_id: u16) -> bool {
self.contains(&packet_id)
}
}
#[cfg(feature = "alloc")]
impl PacketIdLookup for Vec<PacketId> {
fn validate(&self, packet_id: u16) -> bool {
self.contains(&PacketId::from(packet_id))
2023-09-18 16:17:24 +02:00
}
}
#[cfg(feature = "alloc")]
impl PacketIdLookup for HashSet<u16> {
2023-09-18 18:27:08 +02:00
fn validate(&self, packet_id: u16) -> bool {
self.contains(&packet_id)
}
}
#[cfg(feature = "alloc")]
impl PacketIdLookup for HashSet<PacketId> {
fn validate(&self, packet_id: u16) -> bool {
self.contains(&PacketId::from(packet_id))
2023-09-18 16:17:24 +02:00
}
}
impl PacketIdLookup for &[u16] {
2023-09-18 18:27:08 +02:00
fn validate(&self, packet_id: u16) -> bool {
if self.binary_search(&packet_id).is_ok() {
2023-09-18 16:17:24 +02:00
return true;
}
false
}
}
2023-09-18 18:27:08 +02:00
impl PacketIdLookup for &[PacketId] {
fn validate(&self, packet_id: u16) -> bool {
if self.binary_search(&PacketId::from(packet_id)).is_ok() {
return true;
}
false
}
}
2023-09-18 16:17:24 +02:00
/// This function parses a given buffer for tightly packed CCSDS space packets. It uses the
/// [PacketId] field of the CCSDS packets to detect the start of a CCSDS space packet and then
/// uses the length field of the packet to extract CCSDS packets.
///
/// This function is also able to deal with broken tail packets at the end as long a the parser
/// can read the full 6 bytes which constitue a space packet header. If broken tail packets are
/// detected, they are moved to the front of the buffer, and the write index for future write
/// operations will be written to the `next_write_idx` argument.
///
/// The parser will write all packets which were decoded successfully to the given `tc_receiver`.
pub fn parse_buffer_for_ccsds_space_packets<E>(
buf: &mut [u8],
packet_id_lookup: &dyn PacketIdLookup,
tc_receiver: &mut dyn ReceivesTcCore<Error = E>,
2023-09-18 16:17:24 +02:00
next_write_idx: &mut usize,
) -> Result<u32, E> {
let packets_found = 0;
let mut current_idx = 0;
let buf_len = buf.len();
loop {
if current_idx + 7 >= buf.len() {
break;
}
let packet_id = u16::from_be_bytes(buf[current_idx..current_idx + 2].try_into().unwrap());
if packet_id_lookup.validate(packet_id) {
let length_field =
u16::from_be_bytes(buf[current_idx + 4..current_idx + 6].try_into().unwrap());
let packet_size = length_field + 7;
if (current_idx + packet_size as usize) < buf_len {
tc_receiver.pass_tc(&buf[current_idx..current_idx + packet_size as usize])?;
} else {
// Move packet to start of buffer if applicable.
if current_idx > 0 {
buf.copy_within(current_idx.., 0);
*next_write_idx = current_idx;
}
}
current_idx += packet_size as usize;
continue;
}
current_idx += 1;
}
Ok(packets_found)
}