Enum Packet 

pub enum Packet<'input> {
    Unsecured {
        basic: BasicHeader,
        common: CommonHeader,
        extended: Option<ExtendedHeader>,
        payload: &'input [u8],
    },
    Secured {
        basic: BasicHeader,
        secured: Ieee1609Dot2Data<'input>,
        common: CommonHeader,
        extended: Option<ExtendedHeader>,
    },
}

C-ITS GeoNetworking packet

A geonetworking packet always contains a basic and common header. When message signing (secured packet) is used, a secured header is added after the basic header which signs all data following itself.

Usually a message will continue with an extended header. The payload is directly present in Unsecured packets or needs to be retrieved using Self::secured_payload_after_gn in Self::Secured

Variants

Unsecured

Fields

basic: BasicHeader

common: CommonHeader

extended: Option<ExtendedHeader>

payload: &'input [u8]

Secured

Fields

basic: BasicHeader

secured: Ieee1609Dot2Data<'input>

common: CommonHeader

extended: Option<ExtendedHeader>

Implementations

impl<'p> Packet<'p>

pub fn secured_payload_after_gn(&self) -> Option<&'p [u8]>

Retrieves the slice of the secured IEEE 1609.2 data that represents the payload after GeoNetworking Common and Extended headers.

Example

Consider a CAM message with BTB-B and secured GeoNetworking Header

Ieee1609Dot2Data->content->signed_data->tbs_data->payload->data->content->unsecured_data
|---Common---|---Extended---|--BTP-B--|--------CAM---------|
                            ^                              ^
                            |_________return slice_________|

pub fn common(&self) -> &CommonHeader

Returns a reference to the Common header regardless of Packet type

pub fn basic(&self) -> &BasicHeader

Returns a reference to the Basic header regardless of Packet type

pub fn extended(&self) -> &Option<ExtendedHeader>

Returns a reference to the Extended header regardless of Packet type

pub fn payload(&self) -> Option<&'p [u8]>

Returns a reference to the payload of a signed or unsigned packet (or None if secured packet has not payload)

The payload buffer will contain a header (usually BTP) as specified in the next_header field of the common header.

pub fn btp_payload(&self) -> Result<&'p [u8], String>

Extracts the BTP payload

Errors

Returns a human-readable string if

• a secured packet has no payload
• or the next header is not a BTP header

pub fn is_hopped(&self) -> bool

Determines if the packet was hopped

pub fn is_secured(&self) -> bool

Determines if the packet is a secured packet

pub fn source_position_vector(&self) -> Option<LongPositionVector>

Gets the source position vector from the extended header (if header is present)

Trait Implementations

impl<'input> Clone for Packet<'input>

fn clone(&self) -> Packet<'input>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'input> Debug for Packet<'input>

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

Formats the value using the given formatter.

impl<'s> Decode<'s> for Packet<'s>

fn decode<'input: 's, I: Into<&'input [u8]>>( input: I, ) -> Result<Decoded<Self>, DecodeError<&'input [u8]>>

Decodes the data type from a binary buffer

impl Encode for Packet<'_>

fn encode(&self, output: &mut Encoder) -> Result<(), EncodeError>

Encodes itself as binary data to the output Encoder

fn encode_to_vec(&self) -> Result<Vec<u8>, EncodeError>

Encodes itself as binary data

fn encode_to_json(&self) -> Result<String, EncodeError>

where Self: Sized + Serialize,

Encodes itself to a JSON representation

impl<'input> PartialEq for Packet<'input>

fn eq(&self, other: &Packet<'input>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'input> Serialize for Packet<'input>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'input> StructuralPartialEq for Packet<'input>

impl Validate for Packet<'_>

fn validate(&self) -> Result<ValidationResult, ValidationError>

Checks whether the implementing type is valid.