StaticMemoryComponentAc.hpp

Go to the documentation of this file.

// ======================================================================
// \title  StaticMemoryComponentAc.hpp
// \author Generated by fpp-to-cpp
// \brief  hpp file for StaticMemory component base class
// ======================================================================

#ifndef Svc_StaticMemoryComponentAc_HPP
#define Svc_StaticMemoryComponentAc_HPP

#include "Fw/Buffer/BufferGetPortAc.hpp"
#include "Fw/Buffer/BufferSendPortAc.hpp"
#include "Fw/Comp/ActiveComponentBase.hpp"
#include "Fw/FPrimeBasicTypes.hpp"
#if !FW_DIRECT_PORT_CALLS
#include "Fw/Port/InputSerializePort.hpp"
#endif
#if !FW_DIRECT_PORT_CALLS
#include "Fw/Port/OutputSerializePort.hpp"
#endif
#include "Os/Mutex.hpp"

namespace Svc {

  class StaticMemoryComponentBase :
    public Fw::PassiveComponentBase
  {

      // ----------------------------------------------------------------------
      // Friend classes
      // ----------------------------------------------------------------------

      friend class StaticMemoryTesterBase;
      friend class StaticMemoryTester;

    protected:

      // ----------------------------------------------------------------------
      // Constants
      // ----------------------------------------------------------------------

      enum {
        NUM_BUFFERALLOCATE_INPUT_PORTS = 4,
        NUM_BUFFERDEALLOCATE_INPUT_PORTS = 4,
      };

    public:

      // ----------------------------------------------------------------------
      // Component initialization
      // ----------------------------------------------------------------------

      void init(
          FwEnumStoreType instance = 0 
      );

#if !FW_DIRECT_PORT_CALLS

    public:

      // ----------------------------------------------------------------------
      // Getters for typed input ports
      // ----------------------------------------------------------------------

      Fw::InputBufferGetPort* get_bufferAllocate_InputPort(
          FwIndexType portNum 
      );

      Fw::InputBufferSendPort* get_bufferDeallocate_InputPort(
          FwIndexType portNum 
      );

#endif

    protected:

      // ----------------------------------------------------------------------
      // Component construction and destruction
      // ----------------------------------------------------------------------

      StaticMemoryComponentBase(
          const char* compName = "" 
      );

      virtual ~StaticMemoryComponentBase();

    protected:

      // ----------------------------------------------------------------------
      // Getters for numbers of typed input ports
      // ----------------------------------------------------------------------

      static constexpr FwIndexType getNum_bufferAllocate_InputPorts() {
        return NUM_BUFFERALLOCATE_INPUT_PORTS;
      }

      static constexpr FwIndexType getNum_bufferDeallocate_InputPorts() {
        return NUM_BUFFERDEALLOCATE_INPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Handlers to implement for typed input ports
      // ----------------------------------------------------------------------

      virtual Fw::Buffer bufferAllocate_handler(
          FwIndexType portNum, 
          FwSizeType size 
      ) = 0;

      virtual void bufferDeallocate_handler(
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      ) = 0;

#if FW_DIRECT_PORT_CALLS
    public:
#else
    protected:
#endif

      // ----------------------------------------------------------------------
      // Port handler base-class functions for typed input ports
      //
      // Call these functions directly to bypass the corresponding ports
      // ----------------------------------------------------------------------

      Fw::Buffer bufferAllocate_handlerBase(
          FwIndexType portNum, 
          FwSizeType size 
      );

      void bufferDeallocate_handlerBase(
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      );

    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_bufferAllocate_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          FwSizeType size 
      );

      static void m_p_bufferDeallocate_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      );

#if !FW_DIRECT_PORT_CALLS

    private:

      // ----------------------------------------------------------------------
      // Typed input ports
      // ----------------------------------------------------------------------

      Fw::InputBufferGetPort m_bufferAllocate_InputPort[NUM_BUFFERALLOCATE_INPUT_PORTS];

      Fw::InputBufferSendPort m_bufferDeallocate_InputPort[NUM_BUFFERDEALLOCATE_INPUT_PORTS];

#endif

    private:

      // ----------------------------------------------------------------------
      // Mutexes
      // ----------------------------------------------------------------------

      Os::Mutex m_guardedPortMutex;

  };

}

#endif