F´ Flight Software - C/C++ Documentation
A framework for building embedded system applications to NASA flight quality standards.
TcpServerComponentImpl.hpp
Go to the documentation of this file.
1 // ======================================================================
2 // \title TcpServerComponentImpl.hpp
3 // \author mstarch
4 // \brief hpp file for TcpServerComponentImpl component implementation class
5 //
6 // \copyright
7 // Copyright 2009-2020, by the California Institute of Technology.
8 // ALL RIGHTS RESERVED. United States Government Sponsorship
9 // acknowledged.
10 //
11 // ======================================================================
12 
13 #ifndef TcpServerComponentImpl_HPP
14 #define TcpServerComponentImpl_HPP
15 
16 #include <Drv/Ip/IpSocket.hpp>
19 #include <config/IpCfg.hpp>
21 
22 namespace Drv {
23 
25  friend class TcpServerTester;
26 
27  public:
28  // ----------------------------------------------------------------------
29  // Construction, initialization, and destruction
30  // ----------------------------------------------------------------------
31 
36  TcpServerComponentImpl(const char* const compName);
37 
42 
43  // ----------------------------------------------------------------------
44  // Helper methods to start and stop socket
45  // ----------------------------------------------------------------------
46 
63  SocketIpStatus configure(const char* hostname,
64  const U16 port,
65  const U32 send_timeout_seconds = SOCKET_SEND_TIMEOUT_SECONDS,
66  const U32 send_timeout_microseconds = SOCKET_SEND_TIMEOUT_MICROSECONDS,
67  FwSizeType buffer_size = 1024);
68 
72  bool isStarted();
73 
81 
87  void terminate();
88 
97  U16 getListenPort();
98 
99  protected:
100  // ----------------------------------------------------------------------
101  // Implementations for socket read task virtual methods
102  // ----------------------------------------------------------------------
103 
112  IpSocket& getSocketHandler() override;
113 
122  Fw::Buffer getBuffer() override;
123 
132  void sendBuffer(Fw::Buffer buffer, SocketIpStatus status) override;
133 
137  void connected() override;
138 
142  void readLoop() override;
143 
144  private:
145  // ----------------------------------------------------------------------
146  // Handler implementations for user-defined typed input ports
147  // ----------------------------------------------------------------------
148 
163  Drv::ByteStreamStatus send_handler(const FwIndexType portNum, Fw::Buffer& fwBuffer) override;
164 
168  void recvReturnIn_handler(FwIndexType portNum,
169  Fw::Buffer& fwBuffer
170  ) override;
171 
172  Drv::TcpServerSocket m_socket;
173 
174  FwSizeType m_allocation_size;
175 };
176 
177 } // end namespace Drv
178 
179 #endif // end TcpServerComponentImpl
Auto-generated base for TcpServer component.
void sendBuffer(Fw::Buffer buffer, SocketIpStatus status) override
sends a buffer to be filled with data
PlatformSizeType FwSizeType
IpSocket & getSocketHandler() override
returns a reference to the socket handler
Helper for setting up Tcp using Berkeley sockets as a server.
supports a task to read a given socket adaptation
void readLoop() override
read from the socket, overridden to start and terminate the server socket
Status returned by the send call.
SocketIpStatus configure(const char *hostname, const U16 port, const U32 send_timeout_seconds=SOCKET_SEND_TIMEOUT_SECONDS, const U32 send_timeout_microseconds=SOCKET_SEND_TIMEOUT_MICROSECONDS, FwSizeType buffer_size=1024)
Configures the TcpServer settings but does not open the connection.
void connected() override
called when the IPv4 system has been connected
TcpServerComponentImpl(const char *const compName)
construct the TcpServer component.
void terminate()
terminate the server socket
~TcpServerComponentImpl()
Destroy the component.
U16 getListenPort()
get the port being listened on
PlatformIndexType FwIndexType
SocketIpStatus
Status enumeration for socket return values.
Definition: IpSocket.hpp:29
Helper base-class for setting up Berkeley sockets.
Definition: IpSocket.hpp:57
Fw::Buffer getBuffer() override
returns a buffer to fill with data
SocketIpStatus startup()
startup the server socket for communications