Represents a PUS Type A (Telemetry) header. More...

#include <PusServices.h>

Inheritance diagram for PusA:

Collaboration diagram for PusA:

Public Member Functions
	PusA ()=default

	PusA (const uint8_t version, const uint8_t serviceType, const uint8_t serviceSubtype, const uint8_t sourceID, const uint32_t dataLength)
	Constructs a PusA object with all fields explicitly set.

void	setDataLength (const uint16_t dataLength) override
	Sets the length of the data associated with the packet.

uint8_t	getVersion () const

uint8_t	getServiceType () const

uint8_t	getServiceSubtype () const

uint8_t	getSourceID () const

uint16_t	getDataLength () const override
	Gets the length of the data associated with the packet if applicable.

uint16_t	getSize () const override
	Gets the size of the header in bytes.

std::string	getType () const override
	Retrieves the name of the packet.

std::vector< uint8_t >	serialize () const override
	Retrieves the serialized representation of the header.

CCSDS::ResultBool	deserialize (const std::vector< uint8_t > &data) override
	takes a buffer if data (vector uint8) and creates the header

Public Member Functions inherited from CCSDS::SecondaryHeaderAbstract
virtual	~SecondaryHeaderAbstract ()=default

Private Attributes
uint8_t	m_version {}

uint8_t	m_serviceType {}

uint8_t	m_serviceSubType {}

uint8_t	m_sourceID {}

uint16_t	m_dataLength {}

const std::string	m_type = "PusA"

const uint16_t	m_size = 6

Detailed Description

Represents a PUS Type A (Telemetry) header.

Contains fields used for telemetry data.

Field Summary:

Version: 3 bits, PUS standard version.
Service Type: 8 bits, type of service (e.g., 0x01 for telemetry).
Service Subtype: 8 bits, subtype of the service.
Source ID: 8 bits, source identifier (e.g., satellite ID).
Data Length: 16 bits, length of the telemetry data in bytes.

Definition at line 19 of file PusServices.h.

Constructor & Destructor Documentation

◆ PusA() [1/2]

PusA::PusA ( )

default

◆ PusA() [2/2]

PusA::PusA	(	const uint8_t	version,
		const uint8_t	serviceType,
		const uint8_t	serviceSubtype,
		const uint8_t	sourceID,
		const uint32_t	dataLength
	)

inlineexplicit

Constructs a PusA object with all fields explicitly set.

Parameters

version	PUS version (3 bits).
serviceType	Service type (8 bits).
serviceSubtype	Service subtype (8 bits).
sourceID	Source identifier (8 bits).
dataLength	Length of the telemetry data (16 bits).

Definition at line 31 of file PusServices.h.

                                                                     : m_version(version & 0x7),
                                                                       m_serviceType(serviceType),
                                                                       m_serviceSubType(serviceSubtype),
                                                                       m_sourceID(sourceID), m_dataLength(dataLength) {
    }

Member Function Documentation

◆ deserialize()

CCSDS::ResultBool PusA::deserialize ( const std::vector< uint8_t > & data )

overridevirtual

takes a buffer if data (vector uint8) and creates the header

Returns: Boolean true on success or Error.

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 4 of file PusServices.cpp.

                                                                {
  RET_IF_ERR_MSG(data.size() != m_size, CCSDS::ErrorCode::INVALID_SECONDARY_HEADER_DATA,
                 "PUS-A header not correct size (size != 6 bytes)");
 
  m_version = data[0] & 0x5;
  m_serviceType = data[1];
  m_serviceSubType = data[2];
  m_sourceID = data[3];
  m_dataLength = data[4] << 8 | data[5];
  return true;
}

◆ getDataLength()

uint16_t PusA::getDataLength ( ) const

inlineoverridevirtual

Gets the length of the data associated with the packet if applicable.

Returns: The length of the data in bytes set in the header.

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 44 of file PusServices.h.

44{ return m_dataLength; }

◆ getServiceSubtype()

uint8_t PusA::getServiceSubtype ( ) const

inline

Definition at line 42 of file PusServices.h.

42{ return m_serviceSubType; }

◆ getServiceType()

uint8_t PusA::getServiceType ( ) const

inline

Definition at line 41 of file PusServices.h.

41{ return m_serviceType; }

◆ getSize()

uint16_t PusA::getSize ( ) const

inlineoverridevirtual

Gets the size of the header in bytes.

Returns: The size of the header in bytes.

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 45 of file PusServices.h.

45{ return m_size; }

◆ getSourceID()

uint8_t PusA::getSourceID ( ) const

inline

Definition at line 43 of file PusServices.h.

43{ return m_sourceID; }

◆ getType()

std::string PusA::getType ( ) const

inlineoverridevirtual

Retrieves the name of the packet.

Returns: A vector containing the header bytes. (does not include data field)

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 46 of file PusServices.h.

46{ return m_type; }

PusA::m_type

const std::string m_type

Definition PusServices.h:58

◆ getVersion()

uint8_t PusA::getVersion ( ) const

inline

Definition at line 40 of file PusServices.h.

40{ return m_version; }

◆ serialize()

std::vector< uint8_t > PusA::serialize ( ) const

overridevirtual

Retrieves the serialized representation of the header.

Returns: A vector containing the header bytes. (does not include data field)

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 16 of file PusServices.cpp.

                                         {
  std::vector data{
    static_cast<uint8_t>(m_version & 0x7),
    m_serviceType,
    m_serviceSubType,
    m_sourceID,
    static_cast<uint8_t>(m_dataLength >> 8 & 0xFF),
    static_cast<uint8_t>(m_dataLength & 0xFF),
  };
 
  return data;
}

◆ setDataLength()

void PusA::setDataLength ( const uint16_t dataLength )

inlineoverridevirtual

Sets the length of the data associated with the packet.

Parameters

dataLength Length of the data in bytes.

Implements CCSDS::SecondaryHeaderAbstract.

Definition at line 38 of file PusServices.h.

38{ m_dataLength = dataLength; }

Member Data Documentation

◆ m_dataLength

uint16_t PusA::m_dataLength {}

private

Definition at line 56 of file PusServices.h.

56{}; // Data Length 16 Length of the telemetry data in bytes

◆ m_serviceSubType

uint8_t PusA::m_serviceSubType {}

private

Definition at line 54 of file PusServices.h.

54{}; // Service Subtype 8 Subtype of the service (e.g., specific telemetry type)

◆ m_serviceType

uint8_t PusA::m_serviceType {}

private

Definition at line 53 of file PusServices.h.

53{}; // Service Type 8 Type of service (e.g., 0x01 for telemetry)

◆ m_size

const uint16_t PusA::m_size = 6

private

Definition at line 59 of file PusServices.h.

◆ m_sourceID

uint8_t PusA::m_sourceID {}

private

Definition at line 55 of file PusServices.h.

55{}; // Source ID 8 ID of the source (e.g., satellite or sensor)

◆ m_type

const std::string PusA::m_type = "PusA"

private

Definition at line 58 of file PusServices.h.

◆ m_version

uint8_t PusA::m_version {}

private

Definition at line 52 of file PusServices.h.

52{}; // Version 3 Version of the PUS standard

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

inc/PusServices.h
src/PusServices.cpp

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PusA() [1/2]

◆ PusA() [2/2]

Member Function Documentation

◆ deserialize()

◆ getDataLength()

◆ getServiceSubtype()

◆ getServiceType()

◆ getSize()

◆ getSourceID()

◆ getType()

◆ getVersion()

◆ serialize()

◆ setDataLength()

Member Data Documentation

◆ m_dataLength

◆ m_serviceSubType

◆ m_serviceType

◆ m_size

◆ m_sourceID

◆ m_type

◆ m_version