A data product Container. More...

#include <Fw/Dp/DpContainer.hpp>

Classes
struct	Header
	A DpContainer packet header. More...

Public Member Functions
	DpContainer (FwDpIdType id, const Fw::Buffer &buffer)
	Constructor for initialized container. More...

	DpContainer ()
	Constructor for container with default initialization. More...

virtual	~DpContainer ()
	Destructor. More...

FwDpIdType	getId () const

FwSizeType	getDataSize () const

Fw::Buffer	getBuffer () const

FwSizeType	getPacketSize () const
	Get the packet size corresponding to the data size. More...

FwDpPriorityType	getPriority () const

Fw::Time	getTimeTag () const

Fw::DpState	getState () const
	Get the product state. More...

DpCfg::ProcType::SerialType	getProcTypes () const

DpState	getDpState () const
	Get the data product state. More...

Fw::SerializeStatus	deserializeHeader ()

void	serializeHeader ()

void	setId (FwDpIdType id)
	Set the id. More...

void	setPriority (FwDpPriorityType priority)
	Set the priority. More...

void	setTimeTag (Fw::Time timeTag)
	Set the time tag. More...

void	setProcTypes (DpCfg::ProcType::SerialType procTypes)
	Set the processing types bit mask. More...

void	setDpState (DpState dpState)
	Set the data product state. More...

void	setDataSize (FwSizeType dataSize)
	Set the data size. More...

void	setBuffer (const Buffer &buffer)
	Set the packet buffer. More...

void	shrinkBufferSize ()

void	invalidateBuffer ()
	Invalidate the packet buffer. More...

Utils::HashBuffer	getHeaderHash () const

Utils::HashBuffer	computeHeaderHash () const

void	setHeaderHash (const Utils::HashBuffer &hash)
	Set the header hash. More...

void	updateHeaderHash ()
	Compute and set the header hash. More...

Success::T	checkHeaderHash (Utils::HashBuffer &storedHash, Utils::HashBuffer &computedHash) const
	Check the header hash. More...

FwSizeType	getDataHashOffset () const
	Get the data hash offset. More...

Utils::HashBuffer	getDataHash () const

Utils::HashBuffer	computeDataHash () const

void	setDataHash (Utils::HashBuffer hash)
	Set the data hash. More...

void	updateDataHash ()
	Update the data hash. More...

Success::T	checkDataHash (Utils::HashBuffer &storedHash, Utils::HashBuffer &computedHash) const
	Check the data hash. More...

Static Public Member Functions
static constexpr FwSizeType	getPacketSizeForDataSize (FwSizeType dataSize)
	Get the packet size for a given data size. More...

Public Attributes
Header::UserData	m_userData
	The user data. More...

Static Public Attributes
static constexpr FwSizeType	HEADER_HASH_OFFSET = Header::SIZE
	The header hash offset. More...

static constexpr FwSizeType	DATA_OFFSET = HEADER_HASH_OFFSET + HASH_DIGEST_LENGTH
	The data offset. More...

static constexpr FwSizeType	MIN_PACKET_SIZE = Header::SIZE + 2 * HASH_DIGEST_LENGTH

Protected Member Functions
DpContainer &	operator= (const DpContainer &src)=default
	Copy assignment operator. More...

Protected Attributes
FwDpIdType	m_id

FwDpPriorityType	m_priority
	The priority. More...

Time	m_timeTag
	The time tag. More...

DpCfg::ProcType::SerialType	m_procTypes
	The processing types. More...

DpState	m_dpState
	The data product state. More...

FwSizeType	m_dataSize
	The data size. More...

Buffer	m_buffer
	The packet buffer. More...

Fw::ExternalSerializeBufferWithMemberCopy	m_dataBuffer

Friends
class	Fw::DpContainerTester

Detailed Description

A data product Container.

Definition at line 26 of file DpContainer.hpp.

Constructor & Destructor Documentation

◆ DpContainer() [1/2]

Fw::DpContainer::DpContainer	(	FwDpIdType	id,
		const Fw::Buffer &	buffer
	)

Constructor for initialized container.

Parameters

id	The container id
buffer	The buffer

Definition at line 19 of file DpContainer.cpp.

◆ DpContainer() [2/2]

Fw::DpContainer::DpContainer ( )

Constructor for container with default initialization.

Definition at line 28 of file DpContainer.cpp.

◆ ~DpContainer()

virtual Fw::DpContainer::~DpContainer ( )

inlinevirtual

Destructor.

Definition at line 81 of file DpContainer.hpp.

Member Function Documentation

◆ checkDataHash()

Success::T Fw::DpContainer::checkDataHash	(	Utils::HashBuffer &	storedHash,
		Utils::HashBuffer &	computedHash
	)		const

Check the data hash.

Parameters

storedHash	The stored hash (output)
computedHash	The computed hash (output)

Definition at line 240 of file DpContainer.cpp.

◆ checkHeaderHash()

Success::T Fw::DpContainer::checkHeaderHash	(	Utils::HashBuffer &	storedHash,
		Utils::HashBuffer &	computedHash
	)		const

Check the header hash.

Parameters

storedHash	The stored hash (output)
computedHash	The computed hash (output)

Definition at line 193 of file DpContainer.cpp.

◆ computeDataHash()

Utils::HashBuffer Fw::DpContainer::computeDataHash ( ) const

Compute the data hash from the data

Returns: The hash

Definition at line 210 of file DpContainer.cpp.

◆ computeHeaderHash()

Utils::HashBuffer Fw::DpContainer::computeHeaderHash ( ) const

Compute the header hash from the header data

Returns: The hash

Definition at line 170 of file DpContainer.cpp.

◆ deserializeHeader()

Fw::SerializeStatus Fw::DpContainer::deserializeHeader ( )

Deserialize the header from the packet buffer Buffer must be valid, and its size must be at least MIN_PACKET_SIZE Before calling this function, you should call checkHeaderHash() to check the header hash

Returns: The serialize status

Definition at line 38 of file DpContainer.cpp.

◆ getBuffer()

Fw::Buffer Fw::DpContainer::getBuffer ( ) const

inline

Get the packet buffer

Returns: The buffer

Definition at line 106 of file DpContainer.hpp.

◆ getDataHash()

Utils::HashBuffer Fw::DpContainer::getDataHash ( ) const

Get the stored data hash

Returns: The hash

Definition at line 199 of file DpContainer.cpp.

◆ getDataHashOffset()

FwSizeType Fw::DpContainer::getDataHashOffset ( ) const

inline

Get the data hash offset.

Definition at line 212 of file DpContainer.hpp.

◆ getDataSize()

FwSizeType Fw::DpContainer::getDataSize ( ) const

inline

Get the data size

Returns: The data size

Definition at line 102 of file DpContainer.hpp.

◆ getDpState()

DpState Fw::DpContainer::getDpState ( ) const

inline

Get the data product state.

Definition at line 127 of file DpContainer.hpp.

◆ getHeaderHash()

Utils::HashBuffer Fw::DpContainer::getHeaderHash ( ) const

Get the stored header hash

Returns: The hash

Definition at line 161 of file DpContainer.cpp.

◆ getId()

FwDpIdType Fw::DpContainer::getId ( ) const

inline

Get the container id

Returns: The id

Definition at line 98 of file DpContainer.hpp.

◆ getPacketSize()

FwSizeType Fw::DpContainer::getPacketSize ( ) const

inline

Get the packet size corresponding to the data size.

Definition at line 109 of file DpContainer.hpp.

◆ getPacketSizeForDataSize()

static constexpr FwSizeType Fw::DpContainer::getPacketSizeForDataSize ( FwSizeType dataSize )

inlinestatic

Get the packet size for a given data size.

Parameters

dataSize The data size

Definition at line 243 of file DpContainer.hpp.

◆ getPriority()

FwDpPriorityType Fw::DpContainer::getPriority ( ) const

inline

Get the priority

Returns: The priority

Definition at line 113 of file DpContainer.hpp.

◆ getProcTypes()

DpCfg::ProcType::SerialType Fw::DpContainer::getProcTypes ( ) const

inline

Get the processing types

Returns: The processing types

Definition at line 124 of file DpContainer.hpp.

◆ getState()

Fw::DpState Fw::DpContainer::getState ( ) const

inline

Get the product state.

Definition at line 120 of file DpContainer.hpp.

◆ getTimeTag()

Fw::Time Fw::DpContainer::getTimeTag ( ) const

inline

Get the time tag

Returns: The time tag

Definition at line 117 of file DpContainer.hpp.

◆ invalidateBuffer()

void Fw::DpContainer::invalidateBuffer ( )

inline

Invalidate the packet buffer.

Definition at line 185 of file DpContainer.hpp.

◆ operator=()

DpContainer& Fw::DpContainer::operator= ( const DpContainer & src )

protecteddefault

Copy assignment operator.

◆ serializeHeader()

void Fw::DpContainer::serializeHeader ( )

Serialize the header into the packet buffer and update the header hash Buffer must be valid, and its size must be at least MIN_PACKET_SIZE

Definition at line 89 of file DpContainer.cpp.

◆ setBuffer()

void Fw::DpContainer::setBuffer ( const Buffer & buffer )

Set the packet buffer.

Parameters

buffer The packet buffer

Definition at line 122 of file DpContainer.cpp.

◆ setDataHash()

void Fw::DpContainer::setDataHash ( Utils::HashBuffer hash )

Set the data hash.

Parameters

hash The hash

Definition at line 222 of file DpContainer.cpp.

◆ setDataSize()

void Fw::DpContainer::setDataSize ( FwSizeType dataSize )

inline

Set the data size.

Parameters

dataSize The data size

Definition at line 171 of file DpContainer.hpp.

◆ setDpState()

void Fw::DpContainer::setDpState ( DpState dpState )

inline

Set the data product state.

Parameters

dpState The data product state

Definition at line 165 of file DpContainer.hpp.

◆ setHeaderHash()

void Fw::DpContainer::setHeaderHash ( const Utils::HashBuffer & hash )

Set the header hash.

Parameters

hash The hash

Definition at line 180 of file DpContainer.cpp.

◆ setId()

void Fw::DpContainer::setId ( FwDpIdType id )

inline

Set the id.

Parameters

id The id

Definition at line 141 of file DpContainer.hpp.

◆ setPriority()

void Fw::DpContainer::setPriority ( FwDpPriorityType priority )

inline

Set the priority.

Parameters

priority The priority

Definition at line 147 of file DpContainer.hpp.

◆ setProcTypes()

void Fw::DpContainer::setProcTypes ( DpCfg::ProcType::SerialType procTypes )

inline

Set the processing types bit mask.

Parameters

procTypes The processing types

Definition at line 159 of file DpContainer.hpp.

◆ setTimeTag()

void Fw::DpContainer::setTimeTag ( Fw::Time timeTag )

inline

Set the time tag.

Parameters

timeTag The time tag

Definition at line 153 of file DpContainer.hpp.

◆ shrinkBufferSize()

void Fw::DpContainer::shrinkBufferSize ( )

Shrink the Fw::Buffer size to match the DataSize in the container header

Definition at line 145 of file DpContainer.cpp.

◆ updateDataHash()

void Fw::DpContainer::updateDataHash ( )

Update the data hash.

Definition at line 236 of file DpContainer.cpp.

◆ updateHeaderHash()

void Fw::DpContainer::updateHeaderHash ( )

Compute and set the header hash.

Definition at line 189 of file DpContainer.cpp.

Friends And Related Function Documentation

◆ Fw::DpContainerTester

friend class Fw::DpContainerTester

friend

Definition at line 27 of file DpContainer.hpp.

Member Data Documentation

◆ DATA_OFFSET

constexpr FwSizeType Fw::DpContainer::DATA_OFFSET = HEADER_HASH_OFFSET + HASH_DIGEST_LENGTH

static

The data offset.

Definition at line 61 of file DpContainer.hpp.

◆ HEADER_HASH_OFFSET

constexpr FwSizeType Fw::DpContainer::HEADER_HASH_OFFSET = Header::SIZE

static

The header hash offset.

Definition at line 59 of file DpContainer.hpp.

◆ m_buffer

Buffer Fw::DpContainer::m_buffer

protected

The packet buffer.

Definition at line 289 of file DpContainer.hpp.

◆ m_dataBuffer

Fw::ExternalSerializeBufferWithMemberCopy Fw::DpContainer::m_dataBuffer

protected

The data buffer We use member copy semantics because m_dataBuffer points into m_buffer, which is owned by this object

Definition at line 294 of file DpContainer.hpp.

◆ m_dataSize

FwSizeType Fw::DpContainer::m_dataSize

protected

The data size.

Definition at line 286 of file DpContainer.hpp.

◆ m_dpState

DpState Fw::DpContainer::m_dpState

protected

The data product state.

Definition at line 283 of file DpContainer.hpp.

◆ m_id

FwDpIdType Fw::DpContainer::m_id

protected

The container id This is a system-global id (component-local id + component base id)

Definition at line 271 of file DpContainer.hpp.

◆ m_priority

FwDpPriorityType Fw::DpContainer::m_priority

protected

The priority.

Definition at line 274 of file DpContainer.hpp.

◆ m_procTypes

DpCfg::ProcType::SerialType Fw::DpContainer::m_procTypes

protected

The processing types.

Definition at line 280 of file DpContainer.hpp.

◆ m_timeTag

Time Fw::DpContainer::m_timeTag

protected

The time tag.

Definition at line 277 of file DpContainer.hpp.

◆ m_userData

Header::UserData Fw::DpContainer::m_userData

The user data.

Definition at line 262 of file DpContainer.hpp.

◆ MIN_PACKET_SIZE

constexpr FwSizeType Fw::DpContainer::MIN_PACKET_SIZE = Header::SIZE + 2 * HASH_DIGEST_LENGTH

static

The minimum packet size Reserve space for the header, the header hash, and the data hash This is also the number of non-data bytes in the packet

Definition at line 65 of file DpContainer.hpp.

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

Fw/Dp/DpContainer.hpp
Fw/Dp/DpContainer.cpp

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ DpContainer() [1/2]

◆ DpContainer() [2/2]

◆ ~DpContainer()

Member Function Documentation

◆ checkDataHash()

◆ checkHeaderHash()

◆ computeDataHash()

◆ computeHeaderHash()

◆ deserializeHeader()

◆ getBuffer()

◆ getDataHash()

◆ getDataHashOffset()

◆ getDataSize()

◆ getDpState()

◆ getHeaderHash()

◆ getId()

◆ getPacketSize()

◆ getPacketSizeForDataSize()

◆ getPriority()

◆ getProcTypes()

◆ getState()

◆ getTimeTag()

◆ invalidateBuffer()

◆ operator=()

◆ serializeHeader()

◆ setBuffer()

◆ setDataHash()

◆ setDataSize()

◆ setDpState()

◆ setHeaderHash()

◆ setId()

◆ setPriority()

◆ setProcTypes()

◆ setTimeTag()

◆ shrinkBufferSize()

◆ updateDataHash()

◆ updateHeaderHash()

Friends And Related Function Documentation

◆ Fw::DpContainerTester

Member Data Documentation

◆ DATA_OFFSET

◆ HEADER_HASH_OFFSET

◆ m_buffer

◆ m_dataBuffer

◆ m_dataSize

◆ m_dpState

◆ m_id

◆ m_priority

◆ m_procTypes

◆ m_timeTag

◆ m_userData

◆ MIN_PACKET_SIZE