BufferManagerComponentAc.hpp

Go to the documentation of this file.

// ======================================================================
// \title  BufferManagerComponentAc.hpp
// \author Generated by fpp-to-cpp
// \brief  hpp file for BufferManager component base class
// ======================================================================
 
#ifndef Svc_BufferManagerComponentAc_HPP
#define Svc_BufferManagerComponentAc_HPP
 
#include "FpConfig.hpp"
#include "Fw/Buffer/BufferGetPortAc.hpp"
#include "Fw/Buffer/BufferSendPortAc.hpp"
#include "Fw/Comp/ActiveComponentBase.hpp"
#include "Fw/Log/LogPortAc.hpp"
#include "Fw/Log/LogString.hpp"
#if FW_ENABLE_TEXT_LOGGING == 1
#include "Fw/Log/LogTextPortAc.hpp"
#endif
#include "Fw/Port/InputSerializePort.hpp"
#include "Fw/Port/OutputSerializePort.hpp"
#include "Fw/Time/TimePortAc.hpp"
#include "Fw/Tlm/TlmPortAc.hpp"
#include "Fw/Tlm/TlmString.hpp"
#include "Os/Mutex.hpp"
#include "Svc/Sched/SchedPortAc.hpp"
 
namespace Svc {
 
  class BufferManagerComponentBase :
    public Fw::PassiveComponentBase
  {
 
      // ----------------------------------------------------------------------
      // Friend classes
      // ----------------------------------------------------------------------
 
      friend class BufferManagerComponentBaseFriend;
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Constants
      // ----------------------------------------------------------------------
 
      enum {
        NUM_BUFFERGETCALLEE_INPUT_PORTS = 1,
        NUM_BUFFERSENDIN_INPUT_PORTS = 1,
        NUM_SCHEDIN_INPUT_PORTS = 1,
      };
 
      enum {
        NUM_EVENTOUT_OUTPUT_PORTS = 1,
        NUM_TEXTEVENTOUT_OUTPUT_PORTS = 1,
        NUM_TIMECALLER_OUTPUT_PORTS = 1,
        NUM_TLMOUT_OUTPUT_PORTS = 1,
      };
 
      enum {
        EVENTID_NOBUFFSAVAILABLE = 0x0, 
        EVENTID_ZEROSIZEBUFFER = 0x1, 
      };
 
      enum {
        EVENTID_NOBUFFSAVAILABLE_THROTTLE = 10, 
        EVENTID_ZEROSIZEBUFFER_THROTTLE = 10, 
      };
 
      enum {
        CHANNELID_TOTALBUFFS = 0x0, 
        CHANNELID_CURRBUFFS = 0x1, 
        CHANNELID_HIBUFFS = 0x2, 
        CHANNELID_NOBUFFS = 0x3, 
        CHANNELID_EMPTYBUFFS = 0x4, 
      };
 
    public:
 
      // ----------------------------------------------------------------------
      // Component initialization
      // ----------------------------------------------------------------------
 
      void init(
          FwEnumStoreType instance = 0 
      );
 
    public:
 
      // ----------------------------------------------------------------------
      // Getters for typed input ports
      // ----------------------------------------------------------------------
 
      Fw::InputBufferGetPort* get_bufferGetCallee_InputPort(
          FwIndexType portNum 
      );
 
      Fw::InputBufferSendPort* get_bufferSendIn_InputPort(
          FwIndexType portNum 
      );
 
      Svc::InputSchedPort* get_schedIn_InputPort(
          FwIndexType portNum 
      );
 
    public:
 
      // ----------------------------------------------------------------------
      // Connect input ports to special output ports
      // ----------------------------------------------------------------------
 
      void set_eventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputLogPort* port 
      );
 
#if FW_ENABLE_TEXT_LOGGING == 1
 
      void set_textEventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputLogTextPort* port 
      );
 
#endif
 
      void set_timeCaller_OutputPort(
          FwIndexType portNum, 
          Fw::InputTimePort* port 
      );
 
      void set_tlmOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputTlmPort* port 
      );
 
#if FW_PORT_SERIALIZATION
 
    public:
 
      // ----------------------------------------------------------------------
      // Connect serial input ports to special output ports
      // ----------------------------------------------------------------------
 
      void set_eventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );
 
#if FW_ENABLE_TEXT_LOGGING == 1
 
      void set_textEventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );
 
#endif
 
      void set_timeCaller_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );
 
      void set_tlmOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );
 
#endif
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Component construction and destruction
      // ----------------------------------------------------------------------
 
      BufferManagerComponentBase(
          const char* compName = "" 
      );
 
      virtual ~BufferManagerComponentBase();
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Getters for numbers of typed input ports
      // ----------------------------------------------------------------------
 
      FwIndexType getNum_bufferGetCallee_InputPorts() const;
 
      FwIndexType getNum_bufferSendIn_InputPorts() const;
 
      FwIndexType getNum_schedIn_InputPorts() const;
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Getters for numbers of special output ports
      // ----------------------------------------------------------------------
 
      FwIndexType getNum_eventOut_OutputPorts() const;
 
#if FW_ENABLE_TEXT_LOGGING == 1
 
      FwIndexType getNum_textEventOut_OutputPorts() const;
 
#endif
 
      FwIndexType getNum_timeCaller_OutputPorts() const;
 
      FwIndexType getNum_tlmOut_OutputPorts() const;
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Connection status queries for special output ports
      // ----------------------------------------------------------------------
 
      bool isConnected_eventOut_OutputPort(
          FwIndexType portNum 
      );
 
#if FW_ENABLE_TEXT_LOGGING == 1
 
      bool isConnected_textEventOut_OutputPort(
          FwIndexType portNum 
      );
 
#endif
 
      bool isConnected_timeCaller_OutputPort(
          FwIndexType portNum 
      );
 
      bool isConnected_tlmOut_OutputPort(
          FwIndexType portNum 
      );
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Handlers to implement for typed input ports
      // ----------------------------------------------------------------------
 
      virtual Fw::Buffer bufferGetCallee_handler(
          FwIndexType portNum, 
          U32 size 
      ) = 0;
 
      virtual void bufferSendIn_handler(
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      ) = 0;
 
      virtual void schedIn_handler(
          FwIndexType portNum, 
          U32 context 
      ) = 0;
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Port handler base-class functions for typed input ports
      //
      // Call these functions directly to bypass the corresponding ports
      // ----------------------------------------------------------------------
 
      Fw::Buffer bufferGetCallee_handlerBase(
          FwIndexType portNum, 
          U32 size 
      );
 
      void bufferSendIn_handlerBase(
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      );
 
      void schedIn_handlerBase(
          FwIndexType portNum, 
          U32 context 
      );
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Event logging functions
      // ----------------------------------------------------------------------
 
      void log_WARNING_HI_NoBuffsAvailable(
          U32 size 
      );
 
      void log_WARNING_HI_ZeroSizeBuffer();
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Event throttle reset functions
      // ----------------------------------------------------------------------
 
      void log_WARNING_HI_NoBuffsAvailable_ThrottleClear();
 
      void log_WARNING_HI_ZeroSizeBuffer_ThrottleClear();
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Telemetry write functions
      // ----------------------------------------------------------------------
 
      void tlmWrite_TotalBuffs(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      );
 
      void tlmWrite_CurrBuffs(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      );
 
      void tlmWrite_HiBuffs(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      );
 
      void tlmWrite_NoBuffs(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      );
 
      void tlmWrite_EmptyBuffs(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      );
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Time
      // ----------------------------------------------------------------------
 
      Fw::Time getTime();
 
    PROTECTED:
 
      // ----------------------------------------------------------------------
      // Mutex operations for guarded ports
      //
      // You can override these operations to provide more sophisticated
      // synchronization
      // ----------------------------------------------------------------------
 
      virtual void lock();
 
      virtual void unLock();
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Calls for messages received on typed input ports
      // ----------------------------------------------------------------------
 
      static Fw::Buffer m_p_bufferGetCallee_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          U32 size 
      );
 
      static void m_p_bufferSendIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      );
 
      static void m_p_schedIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          U32 context 
      );
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Typed input ports
      // ----------------------------------------------------------------------
 
      Fw::InputBufferGetPort m_bufferGetCallee_InputPort[NUM_BUFFERGETCALLEE_INPUT_PORTS];
 
      Fw::InputBufferSendPort m_bufferSendIn_InputPort[NUM_BUFFERSENDIN_INPUT_PORTS];
 
      Svc::InputSchedPort m_schedIn_InputPort[NUM_SCHEDIN_INPUT_PORTS];
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Special output ports
      // ----------------------------------------------------------------------
 
      Fw::OutputLogPort m_eventOut_OutputPort[NUM_EVENTOUT_OUTPUT_PORTS];
 
#if FW_ENABLE_TEXT_LOGGING == 1
 
      Fw::OutputLogTextPort m_textEventOut_OutputPort[NUM_TEXTEVENTOUT_OUTPUT_PORTS];
 
#endif
 
      Fw::OutputTimePort m_timeCaller_OutputPort[NUM_TIMECALLER_OUTPUT_PORTS];
 
      Fw::OutputTlmPort m_tlmOut_OutputPort[NUM_TLMOUT_OUTPUT_PORTS];
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Counter values for event throttling
      // ----------------------------------------------------------------------
 
      FwIndexType m_NoBuffsAvailableThrottle;
 
      FwIndexType m_ZeroSizeBufferThrottle;
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // First update flags for telemetry channels
      // ----------------------------------------------------------------------
 
      bool m_first_update_TotalBuffs;
 
      bool m_first_update_CurrBuffs;
 
      bool m_first_update_HiBuffs;
 
      bool m_first_update_NoBuffs;
 
      bool m_first_update_EmptyBuffs;
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Last value storage for telemetry channels
      // ----------------------------------------------------------------------
 
      U32 m_last_TotalBuffs;
 
      U32 m_last_CurrBuffs;
 
      U32 m_last_HiBuffs;
 
      U32 m_last_NoBuffs;
 
      U32 m_last_EmptyBuffs;
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Mutexes
      // ----------------------------------------------------------------------
 
      Os::Mutex m_guardedPortMutex;
 
  };
 
}
 
#endif