TcpClientComponentAc.hpp

Go to the documentation of this file.

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

#ifndef Drv_TcpClientComponentAc_HPP
#define Drv_TcpClientComponentAc_HPP

#include "Drv/ByteStreamDriverModel/ByteStreamDataPortAc.hpp"
#include "Drv/ByteStreamDriverModel/ByteStreamReadyPortAc.hpp"
#include "Drv/ByteStreamDriverModel/ByteStreamSendPortAc.hpp"
#include "Fw/Buffer/BufferGetPortAc.hpp"
#include "Fw/Buffer/BufferSendPortAc.hpp"
#include "Fw/Comp/ActiveComponentBase.hpp"
#include "Fw/FPrimeBasicTypes.hpp"
#include "Fw/Port/InputSerializePort.hpp"
#include "Fw/Port/OutputSerializePort.hpp"
#include "Os/Mutex.hpp"

namespace Drv {

  class TcpClientComponentBase :
    public Fw::PassiveComponentBase
  {

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

      friend class TcpClientTesterBase;
      friend class TcpClientTester;

    protected:

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

      enum {
        NUM_RECVRETURNIN_INPUT_PORTS = 1,
        NUM_SEND_INPUT_PORTS = 1,
      };

      enum {
        NUM_ALLOCATE_OUTPUT_PORTS = 1,
        NUM_DEALLOCATE_OUTPUT_PORTS = 1,
        NUM_READY_OUTPUT_PORTS = 1,
        NUM_RECV_OUTPUT_PORTS = 1,
      };

    public:

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

      void init(
          FwEnumStoreType instance = 0 
      );

    public:

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

      Fw::InputBufferSendPort* get_recvReturnIn_InputPort(
          FwIndexType portNum 
      );

      Drv::InputByteStreamSendPort* get_send_InputPort(
          FwIndexType portNum 
      );

    public:

      // ----------------------------------------------------------------------
      // Connect typed input ports to typed output ports
      // ----------------------------------------------------------------------

      void set_allocate_OutputPort(
          FwIndexType portNum, 
          Fw::InputBufferGetPort* port 
      );

      void set_deallocate_OutputPort(
          FwIndexType portNum, 
          Fw::InputBufferSendPort* port 
      );

      void set_ready_OutputPort(
          FwIndexType portNum, 
          Drv::InputByteStreamReadyPort* port 
      );

      void set_recv_OutputPort(
          FwIndexType portNum, 
          Drv::InputByteStreamDataPort* port 
      );

#if FW_PORT_SERIALIZATION

    public:

      // ----------------------------------------------------------------------
      // Connect serial input ports to typed output ports
      // ----------------------------------------------------------------------

      void set_deallocate_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_ready_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_recv_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

#endif

    protected:

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

      TcpClientComponentBase(
          const char* compName = "" 
      );

      virtual ~TcpClientComponentBase();

    protected:

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

      static constexpr FwIndexType getNum_recvReturnIn_InputPorts() {
        return NUM_RECVRETURNIN_INPUT_PORTS;
      }

      static constexpr FwIndexType getNum_send_InputPorts() {
        return NUM_SEND_INPUT_PORTS;
      }

    protected:

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

      static constexpr FwIndexType getNum_allocate_OutputPorts() {
        return NUM_ALLOCATE_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_deallocate_OutputPorts() {
        return NUM_DEALLOCATE_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_ready_OutputPorts() {
        return NUM_READY_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_recv_OutputPorts() {
        return NUM_RECV_OUTPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Connection status queries for typed output ports
      // ----------------------------------------------------------------------

      bool isConnected_allocate_OutputPort(
          FwIndexType portNum 
      );

      bool isConnected_deallocate_OutputPort(
          FwIndexType portNum 
      );

      bool isConnected_ready_OutputPort(
          FwIndexType portNum 
      );

      bool isConnected_recv_OutputPort(
          FwIndexType portNum 
      );

    protected:

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

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

      virtual Drv::ByteStreamStatus send_handler(
          FwIndexType portNum, 
          Fw::Buffer& sendBuffer 
      ) = 0;

    protected:

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

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

      Drv::ByteStreamStatus send_handlerBase(
          FwIndexType portNum, 
          Fw::Buffer& sendBuffer 
      );

    protected:

      // ----------------------------------------------------------------------
      // Invocation functions for typed output ports
      // ----------------------------------------------------------------------

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

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

      void ready_out(
          FwIndexType portNum 
      );

      void recv_out(
          FwIndexType portNum, 
          Fw::Buffer& buffer,
          const Drv::ByteStreamStatus& status
      );

    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 void m_p_recvReturnIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          Fw::Buffer& fwBuffer 
      );

      static Drv::ByteStreamStatus m_p_send_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          Fw::Buffer& sendBuffer 
      );

    private:

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

      Fw::InputBufferSendPort m_recvReturnIn_InputPort[NUM_RECVRETURNIN_INPUT_PORTS];

      Drv::InputByteStreamSendPort m_send_InputPort[NUM_SEND_INPUT_PORTS];

    private:

      // ----------------------------------------------------------------------
      // Typed output ports
      // ----------------------------------------------------------------------

      Fw::OutputBufferGetPort m_allocate_OutputPort[NUM_ALLOCATE_OUTPUT_PORTS];

      Fw::OutputBufferSendPort m_deallocate_OutputPort[NUM_DEALLOCATE_OUTPUT_PORTS];

      Drv::OutputByteStreamReadyPort m_ready_OutputPort[NUM_READY_OUTPUT_PORTS];

      Drv::OutputByteStreamDataPort m_recv_OutputPort[NUM_RECV_OUTPUT_PORTS];

    private:

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

      Os::Mutex m_guardedPortMutex;

  };

}

#endif