F´ Flight Software - C/C++ Documentation
A framework for building embedded system applications to NASA flight quality standards.
TcpServerComponentImpl.cpp
Go to the documentation of this file.
1 // ======================================================================
2 // \title TcpServerComponentImpl.cpp
3 // \author mstarch
4 // \brief cpp 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 
14 #include <Fw/FPrimeBasicTypes.hpp>
15 #include <limits>
16 #include "Fw/Logger/Logger.hpp"
17 #include "Fw/Types/Assert.hpp"
18 
19 namespace Drv {
20 
21 // ----------------------------------------------------------------------
22 // Construction, initialization, and destruction
23 // ----------------------------------------------------------------------
24 
26 
28  const U16 port,
29  const U32 send_timeout_seconds,
30  const U32 send_timeout_microseconds,
31  FwSizeType buffer_size) {
32  m_allocation_size = buffer_size; // Store the buffer size
33  (void)m_socket.configure(hostname, port, send_timeout_seconds, send_timeout_microseconds);
34  return startup();
35 }
36 
38 
39 // ----------------------------------------------------------------------
40 // Implementations for socket read task virtual methods
41 // ----------------------------------------------------------------------
42 
44  return m_socket.getListenPort();
45 }
46 
48  return m_socket;
49 }
50 
52  return allocate_out(0, m_allocation_size);
53 }
54 
57  if (status == SOCK_SUCCESS) {
58  recvStatus = ByteStreamStatus::OP_OK;
59  } else if (status == SOCK_NO_DATA_AVAILABLE) {
60  recvStatus = ByteStreamStatus::RECV_NO_DATA;
61  } else {
62  recvStatus = ByteStreamStatus::OTHER_ERROR;
63  }
64  this->recv_out(0, buffer, recvStatus);
65 }
66 
69  this->ready_out(0);
70  }
71 }
72 
74  Os::ScopeLock scopedLock(this->m_lock);
75  return this->m_descriptor.serverFd != -1;
76 }
77 
79  Os::ScopeLock scopedLock(this->m_lock);
81  // Prevent multiple startup attempts
82  if (this->m_descriptor.serverFd == -1) {
83  status = this->m_socket.startup(this->m_descriptor);
84  }
85  return status;
86 }
87 
89  Os::ScopeLock scopedLock(this->m_lock);
90  this->m_socket.terminate(this->m_descriptor);
91  this->m_descriptor.serverFd = -1;
92 }
93 
96  // Keep trying to reconnect until the status is good, told to stop, or reconnection is turned off
97  do {
98  status = this->startup();
99  if (status != SOCK_SUCCESS) {
100  Fw::Logger::log("[WARNING] Failed to listen on port %hu with status %d\n", this->getListenPort(), status);
102  continue;
103  }
104  } while (this->running() && status != SOCK_SUCCESS && this->m_reopen);
105  // If start up was successful then perform normal operations
106  if (this->running() && status == SOCK_SUCCESS) {
107  // Perform the nominal read loop
109  }
110  // Terminate the server
111  this->terminate();
112 }
113 
114 // ----------------------------------------------------------------------
115 // Handler implementations for user-defined typed input ports
116 // ----------------------------------------------------------------------
117 
118 Drv::ByteStreamStatus TcpServerComponentImpl::send_handler(const FwIndexType portNum, Fw::Buffer& fwBuffer) {
119  Drv::SocketIpStatus status = this->send(fwBuffer.getData(), fwBuffer.getSize());
120  Drv::ByteStreamStatus returnStatus;
121  switch (status) {
123  returnStatus = ByteStreamStatus::SEND_RETRY;
124  break;
125  case SOCK_SUCCESS:
126  returnStatus = ByteStreamStatus::OP_OK;
127  break;
128  default:
129  returnStatus = ByteStreamStatus::OTHER_ERROR;
130  break;
131  }
132  return returnStatus;
133 }
134 
135 void TcpServerComponentImpl::recvReturnIn_handler(FwIndexType portNum, Fw::Buffer& fwBuffer) {
136  this->deallocate_out(0, fwBuffer);
137 }
138 
139 } // end namespace Drv
static Status delay(Fw::TimeInterval interval)
delay the current task
Definition: Task.cpp:199
bool m_reopen
Force reopen on disconnect.
Auto-generated base for TcpServer component.
Interrupted status for retries.
Definition: IpSocket.hpp:36
SocketIpStatus startup(SocketDescriptor &socketDescriptor)
Opens the server socket and listens, does not block.
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
bool isConnected_ready_OutputPort(FwIndexType portNum)
SocketIpStatus send(const U8 *const data, const FwSizeType size)
send data to the IP socket from the given buffer
static void log(const char *format,...)
log a formated string with supplied arguments
Definition: Logger.cpp:21
U8 * getData() const
Definition: Buffer.cpp:56
Error occurred, retrying may succeed.
Receive worked, but there was no data.
void readLoop() override
read from the socket, overridden to start and terminate the server socket
Status returned by the send call.
Socket operation successful.
Definition: IpSocket.hpp:30
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.
U16 getListenPort()
get the port being listened on
Operation worked as expected.
void connected() override
called when the IPv4 system has been connected
void recv_out(FwIndexType portNum, Fw::Buffer &buffer, const Drv::ByteStreamStatus &status)
Invoke output port recv.
TcpServerComponentImpl(const char *const compName)
construct the TcpServer component.
Fw::Buffer allocate_out(FwIndexType portNum, FwSizeType size)
Invoke output port allocate.
void terminate()
terminate the server socket
~TcpServerComponentImpl()
Destroy the component.
virtual SocketIpStatus configure(const char *hostname, const U16 port, const U32 send_timeout_seconds, const U32 send_timeout_microseconds)
configure the ip socket with host and transmission timeouts
Definition: IpSocket.cpp:51
FwSizeType getSize() const
Definition: Buffer.cpp:60
U16 getListenPort()
get the port being listened on
PlatformIndexType FwIndexType
locks a mutex within the current scope
Definition: Mutex.hpp:80
static const Fw::TimeInterval SOCKET_RETRY_INTERVAL
Definition: IpCfg.hpp:24
virtual void readLoop()
receive off the TCP socket
SocketIpStatus
Status enumeration for socket return values.
Definition: IpSocket.hpp:29
void terminate(const SocketDescriptor &socketDescriptor)
close the server socket created by the startup call
Socket has not been started.
Definition: IpSocket.hpp:43
Helper base-class for setting up Berkeley sockets.
Definition: IpSocket.hpp:57
No data available or read operation would block.
Definition: IpSocket.hpp:45
Fw::Buffer getBuffer() override
returns a buffer to fill with data
SocketIpStatus startup()
startup the server socket for communications
int serverFd
Used for server sockets to track the listening file descriptor.
Definition: IpSocket.hpp:23
bool running()
is the read loop running
void deallocate_out(FwIndexType portNum, Fw::Buffer &fwBuffer)
Invoke output port deallocate.
void ready_out(FwIndexType portNum)
Invoke output port ready.