Packet

Struct Packet 

Source
pub struct Packet<'a, const N: usize> { /* private fields */ }
Expand description

N is the maximum packet size we can handle Panics if N >= 8191

Implementations§

Source§

impl<'a, const N: usize> Packet<'a, N>

Source

pub fn new(buf: &'a mut [u8; N]) -> Self

Source

pub fn clone_backing<'b>(&self, buf: &'b mut [u8; N]) -> Packet<'b, N>

Source

pub fn decode(buf: Buffer<'a, N>) -> Result<Self, DecodeError>

Expects bytes in the buf buf is used as the backing buffer for the Packet

Source

pub fn encode(&self) -> &[u8]

Source

pub fn semi_encode(self) -> Result<Buffer<'a, N>, (EncodeError, Self)>

Directly after the CRC block in The Pipeline

Source

pub fn semi_decode(buf: Buffer<'a, N>) -> Result<Self, DecodeError>

Directly after the CRC block in The Pipeline Expects bytes in the buf buf is used as the backing buffer for the Packet

Source

pub fn fully_encode<const M: usize>( self, out: &mut Buffer<'_, M>, ) -> Result<(), EncodeError>

Encodes packet for transmission on the air. Includes the data length L, but does not include the preamble or sync word.

Source

pub fn fully_decode( data: &[u8], buf: &'a mut [u8; N], ) -> Result<Self, DecodeError>

Decodes packet that was received over the air. Packet shouldn’t have preamble, sync word, or data langth L. Expects bytes in data buf is used as the backing buffer for the Packet

Source

pub fn fully_decode_soft<const M: usize, T: DecodeFrom>( data: &mut [T], buf: &'a mut [u8; N], ) -> Result<Self, DecodeError>

Expects soft bits in data. Bits should be LLR, with positive numbers more likely to be 0. Returns DecodeError::Overflow if M is less than data.len().

Source

pub fn iter(&self) -> ValidatedWhiskerIter<'_>

Source

pub fn identification(&self) -> Option<Identification>

Source

pub fn add_identification( &mut self, w: Identification, ) -> Result<(), EncodeError>

Source

pub fn clear_identification(&mut self)

Source

pub fn timestamp(&self) -> Option<Timestamp>

Source

pub fn add_timestamp(&mut self, w: Timestamp) -> Result<(), EncodeError>

Source

pub fn clear_timestamp(&mut self)

Source

pub fn gps(&self) -> Option<Gps>

Source

pub fn add_gps(&mut self, w: Gps) -> Result<(), EncodeError>

Source

pub fn clear_gps(&mut self)

Source

pub fn route(&self) -> Option<Route>

Source

pub fn add_route(&mut self, w: Route) -> Result<(), EncodeError>

Source

pub fn clear_route(&mut self)

Source

pub fn node_info(&self) -> Option<NodeInfo>

Source

pub fn add_node_info(&mut self, w: NodeInfo) -> Result<(), EncodeError>

Source

pub fn clear_node_info(&mut self)

Source

pub fn destination_iter( &self, ) -> FilterMap<ValidatedWhiskerIter<'_>, fn(Whisker) -> Option<Destination>>

Source

pub fn add_destination(&mut self, w: Destination) -> Result<(), EncodeError>

Source

pub fn clear_destination(&mut self)

Source

pub fn arbitrary_iter( &self, ) -> FilterMap<ValidatedWhiskerIter<'_>, fn(Whisker) -> Option<Arbitrary>>

Source

pub fn add_arbitrary(&mut self, w: Arbitrary) -> Result<(), EncodeError>

Source

pub fn clear_arbitrary(&mut self)

Source

pub fn comment<'b>(&self, buf: &'b mut [u8]) -> Result<&'b str, CommentError>

Source

pub fn add_comment(&mut self, comment: &str) -> Result<(), EncodeError>

Source

pub fn clear_comment(&mut self)

Source

pub fn should_digipeat( &self, identity: Identity<'_>, ) -> Result<(), DigipeatError>

Given the callsign and ssid of a node, should it digipeat this packet? Takes into account things such as if we’ve digipeated it already, the max hops, etc.

Source

pub fn append_to_route( &mut self, callsign: &str, ssid: u8, rssi: Option<f64>, ) -> Result<(), PacketRouteAppendError>

Note that if this fails due to a CATS overflow, it will wipe the route off of the packet

Trait Implementations§

Source§

impl<const N: usize> Debug for Packet<'_, N>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<'a, const N: usize> Freeze for Packet<'a, N>

§

impl<'a, const N: usize> RefUnwindSafe for Packet<'a, N>

§

impl<'a, const N: usize> Send for Packet<'a, N>

§

impl<'a, const N: usize> Sync for Packet<'a, N>

§

impl<'a, const N: usize> Unpin for Packet<'a, N>

§

impl<'a, const N: usize> !UnwindSafe for Packet<'a, N>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> Conv for T

Source§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<T> FmtForward for T

Source§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
Source§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
Source§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
Source§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
Source§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
Source§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
Source§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
Source§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
Source§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Pipe for T
where T: ?Sized,

Source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
Source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
Source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
Source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
Source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
Source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<T> Tap for T

Source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
Source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
Source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
Source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
Source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
Source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
Source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
Source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
Source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
Source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> TryConv for T

Source§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.