TmFramer.hpp

Go to the documentation of this file.

// ======================================================================
// \title  TmFramer.hpp
// \author thomas-bc
// \brief  hpp file for TmFramer component implementation class
// ======================================================================

#ifndef Svc_CCSDS_TmFramer_HPP
#define Svc_CCSDS_TmFramer_HPP

#include "Svc/CCSDS/TmFramer/TmFramerComponentAc.hpp"
#include "Svc/CCSDS/Types/FppConstantsAc.hpp"
#include "Svc/CCSDS/Types/SpacePacketHeaderSerializableAc.hpp"
#include "Svc/CCSDS/Types/TMHeaderSerializableAc.hpp"
#include "Svc/CCSDS/Types/TMTrailerSerializableAc.hpp"

namespace Svc {

namespace CCSDS {

class TmFramer final : public TmFramerComponentBase {
    friend class TmFramerTester;

    static_assert(ComCfg::TmFrameFixedSize > TMHeader::SERIALIZED_SIZE + TMTrailer::SERIALIZED_SIZE,
                  "TM Frame Fixed Size must be at least large enough to hold header, trailer and data");
    // These are to ensure the frame can hold the packet buffer, its SP header and an idle packet of 1 byte
    // This is because TM specifies a frame to be padded with an idle packet of at least 1 byte of idle data
    static_assert(
        ComCfg::TmFrameFixedSize >= FW_COM_BUFFER_MAX_SIZE + (2 * SpacePacketHeader::SERIALIZED_SIZE) + 1,
        "TM Frame Fixed Size must be at least large enough to hold a full com buffer, 2 SP headers and 1 byte");
    static_assert(
        ComCfg::TmFrameFixedSize >= FW_FILE_BUFFER_MAX_SIZE + (2 * SpacePacketHeader::SERIALIZED_SIZE) + 1,
        "TM Frame Fixed Size must be at least large enough to hold a full com buffer, 2 SP headers and 1 byte");

    static constexpr U8 IDLE_DATA_PATTERN = 0x44;

    enum class BufferOwnershipState {
        NOT_OWNED,  
        OWNED,      
    };

  public:
    // ----------------------------------------------------------------------
    // Component construction and destruction
    // ----------------------------------------------------------------------

    TmFramer(const char* const compName  
    );

    ~TmFramer();

  private:
    // ----------------------------------------------------------------------
    // Handler implementations for typed input ports
    // ----------------------------------------------------------------------

    void comStatusIn_handler(FwIndexType portNum,    
                             Fw::Success& condition  
                             ) override;

    void dataIn_handler(FwIndexType portNum,  
                        Fw::Buffer& data,
                        const ComCfg::FrameContext& context) override;

    void dataReturnIn_handler(FwIndexType portNum,  
                              Fw::Buffer& data,
                              const ComCfg::FrameContext& context) override;

    // ----------------------------------------------------------------------
    // Helpers
    // ----------------------------------------------------------------------
  private:
    void fill_with_idle_packet(Fw::SerializeBufferBase& serializer);

    // ----------------------------------------------------------------------
    // Members
    // ----------------------------------------------------------------------
  private:
    // Because the TM protocol use fixed width frames, and only one frame is in transit between ComQueue and
    // ComInterface at a time, we can use a member fixed-size buffer to hold the frame data
    U8 m_frameBuffer[ComCfg::TmFrameFixedSize];                        
    BufferOwnershipState m_bufferState = BufferOwnershipState::OWNED;  

    // Current implementation uses a single virtual channel, so we can use a single virtual frame count
    U8 m_masterFrameCount;   
    U8 m_virtualFrameCount;  
};

}  // namespace CCSDS
}  // namespace Svc

#endif