C++ class representing a view of a MIP packet. More...

#include <mip_packet.hpp>

Inheritance diagram for mip::PacketView:

Classes
class	AllocatedField

class	FieldIterator

Public Member Functions
	PacketView (uint8_t *buffer, size_t bufferSize, uint8_t descriptorSet)
	Create a brand-new MIP packet in the given buffer. More...

	PacketView (const uint8_t *buffer, size_t length)
	Initializes a MIP packet from an existing buffer. More...

	PacketView (const C::mip_packet_view *other)
	Constructs a C++ PacketRef class from the base C object. More...

	PacketView (const C::mip_packet_view &other)
	Constructs a C++ PacketRef class from the base C object. More...

	PacketView (microstrain::U8ArrayView buffer, uint8_t descriptorSet)
	Create a new MIP packet in an existing buffer. More...

	PacketView (microstrain::ConstU8ArrayView buffer)
	Create a reference to an existing MIP packet. More...

bool	isData () const

const uint8_t *	pointer () const

const uint8_t *	payloadPointer () const
	Get a pointer to the entire packet data. More...

uint8_t	payload (size_t i) const
	Get a pointer to the payload data. More...

const uint8_t *	bufferPointer () const

uint8_t *	bufferPointerWr ()
	Returns a writable pointer to the data buffer. More...

Serializer	createField (uint8_t fieldDescriptor, uint8_t length)

microstrain::ConstU8ArrayView	data () const
	Gets a const byte view for the whole packet. More...

microstrain::ConstU8ArrayView	payload () const
	Gets a const byte view of just the payload. More...

microstrain::ConstU8ArrayView	buffer () const
	Gets a const view to the entire storage buffer (usually more than just the packet). More...

microstrain::U8ArrayView	bufferWr ()
	Gets a writeable view to the entire storage buffer (usually more than just the packet). More...

bool	addField (const FieldView &field)
	Copies the given mip field to the packet. More...

bool	addField (uint8_t fieldDescriptor, microstrain::ConstU8ArrayView payload)
	Creates a mip field with the given descriptor and copies the given payload. More...

AllocatedField	createField (uint8_t fieldDescriptor)

uint8_t	operator[] (unsigned int index) const

FieldIterator	begin () const

FieldIterator	end () const

FieldView	firstField () const
	Returns the first field in the packet. More...

template<class FieldType >
bool	addField (const FieldType &field, uint8_t fieldDescriptor=INVALID_FIELD_DESCRIPTOR)
	Adds a field of the given type to the packet. More...

bool	copyPacketTo (microstrain::U8ArrayView buffer) const
	Copies this packet to an external buffer (span version). More...

Static Public Member Functions
template<class FieldType >
static PacketView	createFromField (microstrain::ConstU8ArrayView packetBuffer, const FieldType &field, uint8_t fieldDescriptor=INVALID_FIELD_DESCRIPTOR)
	Creates a new PacketRef containing a single MIP field from an instance of the field type. More...

Static Public Attributes
static constexpr size_t	PAYLOAD_LENGTH_MAX = C::MIP_PACKET_PAYLOAD_LENGTH_MAX

static constexpr size_t	PACKET_SIZE_MIN = C::MIP_PACKET_LENGTH_MIN

static constexpr size_t	PACKET_SIZE_MAX = C::MIP_PACKET_LENGTH_MAX

Detailed Description

C++ class representing a view of a MIP packet.

This is a thin wrapper around the mip_packet_view C structure. Like the C version, it does not contain or own the data buffer. Any of the C functions can be used with the C++ packet class because it inherits from the C struct.

Fields may be iterated over using the C-style methods, with an iterator, or with a range-based for loop:

for(PacketRef::Iterator iter = packet.begin(); iter != packet.end(); ++iter) { ... }

for(Field field : packet) { ... }

Constructor & Destructor Documentation

◆ PacketView() [1/6]

mip::PacketView::PacketView	(	uint8_t *	buffer,
		size_t	bufferSize,
		uint8_t	descriptorSet
	)

inline

Create a brand-new MIP packet in the given buffer.

Use this along with the packet building functions to create MIP packets.

Parameters

packet
buffer	This is where the packet bytes will be stored. Must be at least MIP_PACKET_LENGTH_MIN bytes in size.
buffer_size	The size of buffer, in bytes.
descriptor_set	The MIP descriptor set for the packet.

◆ PacketView() [2/6]

mip::PacketView::PacketView	(	const uint8_t *	buffer,
		size_t	length
	)

inline

Initializes a MIP packet from an existing buffer.

Use this when receiving or parsing MIP packets.

The data in the buffer should be a valid or suspected MIP packet.

Parameters

packet
buffer	The data buffer containing the bytes for a MIP packet. Must be at least MIP_PACKET_LENGTH_MIN bytes in size.
length	The length of the data pointed to by buffer.

Note: The data does not need to be a valid MIP packet, for instance to use the mip_packet_is_sane() or mip_packet_is_valid() functions. However, if it is NOT a valid MIP packet, the result of calling any accessor function is unpredictable. In particular, if length is less than MIP_PACKET_LENGTH_MIN bytes, calling the accessor functions is undefined behavior.

◆ PacketView() [3/6]

mip::PacketView::PacketView ( const C::mip_packet_view * other )

inline

Constructs a C++ PacketRef class from the base C object.

◆ PacketView() [4/6]

mip::PacketView::PacketView ( const C::mip_packet_view & other )

inline

Constructs a C++ PacketRef class from the base C object.

◆ PacketView() [5/6]

mip::PacketView::PacketView	(	microstrain::U8ArrayView	buffer,
		uint8_t	descriptorSet
	)

inline

Create a new MIP packet in an existing buffer.

Parameters

buffer	Place to store the MIP packet bytes.
descriptorSet	Initializes the packet to this descriptor set.

◆ PacketView() [6/6]

mip::PacketView::PacketView ( microstrain::ConstU8ArrayView buffer )

inline

Create a reference to an existing MIP packet.

Parameters

buffer Buffer containing an existing MIP packet.

Warning: Do not call functions which modify the packet (addField, finalize, reset, etc) unless you know the buffer is not const.

Member Function Documentation

◆ addField() [1/3]

template<class FieldType >

bool mip::PacketView::addField	(	const FieldType &	field,
		uint8_t	fieldDescriptor = `INVALID_FIELD_DESCRIPTOR`
	)

inline

Adds a field of the given type to the packet.

Template Parameters

FieldType Any field class from a file in the mip/definitions directory.

Parameters

field	Instance of the field to add to the packet.
fieldDescriptor	If specified, overrides the field descriptor.

Returns: True if the field was added, false if the packet has insufficient space.

◆ addField() [2/3]

bool mip::PacketView::addField ( const FieldView & field )

inline

Copies the given mip field to the packet.

◆ addField() [3/3]

bool mip::PacketView::addField	(	uint8_t	fieldDescriptor,
		microstrain::ConstU8ArrayView	payload
	)

inline

Creates a mip field with the given descriptor and copies the given payload.

◆ begin()

FieldIterator mip::PacketView::begin ( ) const

inline

Returns a forward iterator to the first field in the packet.

◆ buffer()

microstrain::ConstU8ArrayView mip::PacketView::buffer ( ) const

inline

Gets a const view to the entire storage buffer (usually more than just the packet).

◆ bufferPointer()

const uint8_t* mip::PacketView::bufferPointer ( ) const

inline

◆ bufferPointerWr()

uint8_t* mip::PacketView::bufferPointerWr ( )

inline

Returns a writable pointer to the data buffer.

◆ bufferWr()

microstrain::U8ArrayView mip::PacketView::bufferWr ( )

inline

Gets a writeable view to the entire storage buffer (usually more than just the packet).

Warning: : The buffer can only be modified if the packet was constructed with a non-const buffer!

◆ copyPacketTo()

bool mip::PacketView::copyPacketTo ( microstrain::U8ArrayView buffer ) const

inline

Copies this packet to an external buffer (span version).

This packet must be sane (see isSane()). Undefined behavior otherwise due to lookup of totalLength().

Parameters

buffer Data is copied to this buffer.

Returns: true if successful.; false if maxLength is too short.

◆ createField() [1/2]

AllocatedField mip::PacketView::createField ( uint8_t fieldDescriptor )

inline

◆ createField() [2/2]

Serializer mip::PacketView::createField	(	uint8_t	fieldDescriptor,
		uint8_t	length
	)

inline

◆ createFromField()

template<class FieldType >

static PacketView mip::PacketView::createFromField	(	microstrain::ConstU8ArrayView	packetBuffer,
		const FieldType &	field,
		uint8_t	fieldDescriptor = `INVALID_FIELD_DESCRIPTOR`
	)

inlinestatic

Creates a new PacketRef containing a single MIP field from an instance of the field type.

This works just like the addField<FieldType>() function but also initializes and finalizes the packet. It is assumed that the field will fit in an empty packet; otherwise the field can't ever be used. The field classes are predefined so this doesn't need runtime checking.

Template Parameters

FieldType Any field class from a file in the mip/definitions directory.

Parameters

packetBuffer	Buffer to hold the packet bytes.
field	Instance of the field to add to the packet.
fieldDescriptor	If specified, overrides the field descriptor.

Returns: A PacketRef object containing the field.

◆ data()

microstrain::ConstU8ArrayView mip::PacketView::data ( ) const

inline

Gets a const byte view for the whole packet.

◆ end()

FieldIterator mip::PacketView::end ( ) const

inline

Returns a sentry object representing the end of fields in the packet.

◆ firstField()

FieldView mip::PacketView::firstField ( ) const

inline

Returns the first field in the packet.

Subsequent fields can be obtained via the returned Field class, but iteration is best done with begin()/end() or the range-based for loop.

Note: Packets can be empty, so make sure that the returned field is valid before using it.

Returns: A Field instance representing the first field (if any).

◆ isData()

bool mip::PacketView::isData ( ) const

inline

◆ operator[]()

uint8_t mip::PacketView::operator[] ( unsigned int index ) const

inline

◆ payload() [1/2]

microstrain::ConstU8ArrayView mip::PacketView::payload ( ) const

inline

Gets a const byte view of just the payload.

◆ payload() [2/2]

uint8_t mip::PacketView::payload ( size_t i ) const

inline

Get a pointer to the payload data.

◆ payloadPointer()

const uint8_t* mip::PacketView::payloadPointer ( ) const

inline

Get a pointer to the entire packet data.

◆ pointer()

const uint8_t* mip::PacketView::pointer ( ) const

inline

Member Data Documentation

◆ PACKET_SIZE_MAX

constexpr size_t mip::PacketView::PACKET_SIZE_MAX = C::MIP_PACKET_LENGTH_MAX

staticconstexpr

◆ PACKET_SIZE_MIN

constexpr size_t mip::PacketView::PACKET_SIZE_MIN = C::MIP_PACKET_LENGTH_MIN

staticconstexpr

◆ PAYLOAD_LENGTH_MAX

constexpr size_t mip::PacketView::PAYLOAD_LENGTH_MAX = C::MIP_PACKET_PAYLOAD_LENGTH_MAX

staticconstexpr

The documentation for this class was generated from the following file:

src/cpp/mip/mip_packet.hpp

Classes

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PacketView() [1/6]

◆ PacketView() [2/6]

◆ PacketView() [3/6]

◆ PacketView() [4/6]

◆ PacketView() [5/6]

◆ PacketView() [6/6]

Member Function Documentation

◆ addField() [1/3]

◆ addField() [2/3]

◆ addField() [3/3]

◆ begin()

◆ buffer()

◆ bufferPointer()

◆ bufferPointerWr()

◆ bufferWr()

◆ copyPacketTo()

◆ createField() [1/2]

◆ createField() [2/2]

◆ createFromField()

◆ data()

◆ end()

◆ firstField()

◆ isData()

◆ operator[]()

◆ payload() [1/2]

◆ payload() [2/2]

◆ payloadPointer()

◆ pointer()

Member Data Documentation

◆ PACKET_SIZE_MAX

◆ PACKET_SIZE_MIN

◆ PAYLOAD_LENGTH_MAX