ClearCore::EthernetTcpServer Class Reference

Detailed Description

ClearCore TCP server class.

This class manages an instance of a TCP server and manages interactions with multiple Ethernet TCP client connections.

For more detailed information on the ClearCore Ethernet system, check out the ClearCore Ethernet informational page.

ClearCore TCP server class. More...

#include <EthernetTcpServer.h>

Inheritance diagram for ClearCore::EthernetTcpServer:

Collaboration diagram for ClearCore::EthernetTcpServer:

Public Member Functions
	EthernetTcpServer (uint16_t port)
	Construct a TCP server.
void	Begin ()
	Set up the server to begin listening for incoming TCP connections.
EthernetTcpClient	Available ()
	Return a reference to a client that has incoming data.
EthernetTcpClient	Accept ()
	Return a client with an active connection.
uint32_t	Send (const uint8_t *buff, uint32_t size) override
	Send data to all clients managed by the server.
uint32_t	Send (uint8_t charToSend)
	Send data to all clients managed by the server.
uint32_t	Send (const char *nullTermStr)
	Send data to all clients managed by the server.
bool	Ready ()
	Is the server ready to accept a client?

Constructor & Destructor Documentation

EthernetTcpServer()

ClearCore::EthernetTcpServer::EthernetTcpServer ( uint16_t  port )

explicit

Construct a TCP server.

Parameters

[in]

port

The local port to listen for incoming TCP connections on.

Member Function Documentation

Accept()

EthernetTcpClient ClearCore::EthernetTcpServer::Accept

(

)

Return a client with an active connection.

Returns a client with an active connection. The server will only return an active client once, and then the server will no longer manage the client's connection.

Returns

Returns a TCP client with an active connection.

Note

The server will no longer track the client's reference.

Available()

EthernetTcpClient ClearCore::EthernetTcpServer::Available

(

)

Return a reference to a client that has incoming data.

Returns a reference to a client that has incoming data available to read. The server will continue to manage the client.

Returns

Returns a TCP client that has incoming data available to read.

Note

The server will continue to track the client's reference.

Ready()

bool ClearCore::EthernetTcpServer::Ready

(

)

Is the server ready to accept a client?

Returns

Return true if the server is ready to accept clients.

Send() [1/3]

uint32_t ClearCore::EthernetTcpServer::Send ( const char *  nullTermStr )

inline

Send data to all clients managed by the server.

Send a TCP packet to each client managed by the server with a string of characters as the payload.

Parameters

[in]

nullTermStr

A string to send to the clients.

Returns

The number of bytes written to each client.

Send() [2/3]

uint32_t ClearCore::EthernetTcpServer::Send ( const uint8_t *  buff, uint32_t  size  )

override

Send data to all clients managed by the server.

Send a TCP packet to each client managed by the server with the contents of the provided buffer as the packet's payload.

Parameters

[in]	buff	A pointer to the beginning of the data to send.
[in]	size	The maximum number of bytes to send.

Returns

The number of bytes written to each client.

Note

The contents of the supplied buffer represents the payload in an outgoing TCP packet.

Send() [3/3]

uint32_t ClearCore::EthernetTcpServer::Send ( uint8_t  charToSend )

inline

Send data to all clients managed by the server.

Send a TCP packet to each client managed by the server with a character as the payload.

Parameters

[in]

charToSend

A character to send to the clients.

Returns

The number of bytes written to each client.

---

The documentation for this class was generated from the following file:

• EthernetTcpServer.h