Mayank Gupta / Mbed OS pelion-example-frdm

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   FXAS21002 FXOS8700Q

Embed: (wiki syntax)

« Back to documentation index

FtcdCommSocket Class Reference
Public Member Functions

FtcdCommSocket Class Reference

FtcdCommSocket implements the logic of listening for TCP connections and process incoming messages from the Factory Tool. More...

#include <ftcd_comm_socket.h>

Inherits FtcdCommBase.

Public Member Functions

 FtcdCommSocket (const void *interfaceHandler, ftcd_socket_domain_e domain, const uint16_t port_num, ftcd_comm_network_endianness_e network_endianness=FTCD_COMM_NET_ENDIANNESS_BIG, int32_t timeout=INFINITE_SOCKET_TIMEOUT)
 The Socket Constructor Initializes private variables and sets network interface handler, IP and port number.
 FtcdCommSocket (const void *interfaceHandler, ftcd_socket_domain_e domain, const uint16_t port_num, ftcd_comm_network_endianness_e network_endianness, const uint8_t *header_token, bool use_signature, int32_t timeout=INFINITE_SOCKET_TIMEOUT)
 The Socket Constructor Initializes private variables and sets network interface handler, IP and port number.
virtual ~FtcdCommSocket ()
 The Socket Destructor Closes opened resources and frees allocated memory.
virtual bool init (void)
 Initializes Network interface and prints its address.
virtual void finish (void)
 Closes opened sockets.
virtual ftcd_comm_status_e wait_for_message (uint8_t **message_out, uint32_t *message_size_out)
 Wait and read complete message from the communication line.
virtual ftcd_comm_status_e is_token_detected (void)
 Detects the message token from the communication line medium.
virtual uint32_t read_message_size (void)
 Reads the message size in bytes from the communication line medium.
virtual bool read_message (uint8_t *message_out, size_t message_size)
 Reads the message size in bytes from the communication line medium.
virtual bool read_message_signature (uint8_t *sig, size_t sig_size)
 Reads the message size in bytes from the communication line medium.
virtual bool send (const uint8_t *data, uint32_t data_size)
 Writes the given data to the communication line medium.
ftcd_comm_status_e send_response (const uint8_t *response_message, uint32_t response_message_size)
 Writes a response message to the communication line.
ftcd_comm_status_e send_response (const uint8_t *response_message, uint32_t response_message_size, ftcd_comm_status_e status_code)
 Writes a response message with status to the communication line.

Detailed Description

FtcdCommSocket implements the logic of listening for TCP connections and process incoming messages from the Factory Tool.

Definition at line 50 of file ftcd_comm_socket.h.

Constructor & Destructor Documentation

FtcdCommSocket ( const void *  interfaceHandler,
ftcd_socket_domain_e  domain,
const uint16_t  port_num,
ftcd_comm_network_endianness_e  network_endianness = FTCD_COMM_NET_ENDIANNESS_BIG,
int32_t  timeout = INFINITE_SOCKET_TIMEOUT 
)

The Socket Constructor Initializes private variables and sets network interface handler, IP and port number.

If port_num is 0, then random port will be generated.

Definition at line 110 of file ftcd_comm_socket.cpp.

FtcdCommSocket ( const void *  interfaceHandler,
ftcd_socket_domain_e  domain,
const uint16_t  port_num,
ftcd_comm_network_endianness_e  network_endianness,
const uint8_t *  header_token,
bool  use_signature,
int32_t  timeout = INFINITE_SOCKET_TIMEOUT 
)

The Socket Constructor Initializes private variables and sets network interface handler, IP and port number.

If port_num is 0, then random port will be generated.

Definition at line 128 of file ftcd_comm_socket.cpp.

~FtcdCommSocket (  ) [virtual]

The Socket Destructor Closes opened resources and frees allocated memory.

Definition at line 146 of file ftcd_comm_socket.cpp.

Member Function Documentation

void finish ( void   ) [virtual]

Closes opened sockets.

Reimplemented from FtcdCommBase.

Definition at line 249 of file ftcd_comm_socket.cpp.

bool init ( void   ) [virtual]

Initializes Network interface and prints its address.

Reimplemented from FtcdCommBase.

Definition at line 161 of file ftcd_comm_socket.cpp.

ftcd_comm_status_e is_token_detected ( void   ) [virtual]

Detects the message token from the communication line medium.

Returns:
true, if token detected and false otherwise

Implements FtcdCommBase.

Definition at line 335 of file ftcd_comm_socket.cpp.

bool read_message ( uint8_t *  message_out,
size_t  message_size 
) [virtual]

Reads the message size in bytes from the communication line medium.

This is the amount of bytes needed to allocate for the upcoming message bytes.

Parameters:
message_outThe buffer to read into and return to the caller.
message_sizeThe message size in bytes.
Returns:
true upon success, false otherwise

Implements FtcdCommBase.

Definition at line 373 of file ftcd_comm_socket.cpp.

bool read_message_signature ( uint8_t *  sig,
size_t  sig_size 
) [virtual]

Reads the message size in bytes from the communication line medium.

This is the amount of bytes needed to allocate for the upcoming message bytes.

Parameters:
sigThe buffer to read into and return to the caller.
sig_sizeThe sig buffer size in bytes.
Returns:
The message size in bytes in case of success, zero bytes otherwise.

Implements FtcdCommBase.

Definition at line 393 of file ftcd_comm_socket.cpp.

uint32_t read_message_size ( void   ) [virtual]

Reads the message size in bytes from the communication line medium.

This is the amount of bytes needed to allocate for the upcoming message bytes.

Returns:
The message size in bytes in case of success, zero bytes otherwise.

Implements FtcdCommBase.

Definition at line 359 of file ftcd_comm_socket.cpp.

bool send ( const uint8_t *  data,
uint32_t  data_size 
) [virtual]

Writes the given data to the communication line medium.

Parameters:
dataThe bytes to send through the communication line medium
data_sizeThe data size in bytes
Returns:
true upon success, false otherwise

Implements FtcdCommBase.

Definition at line 432 of file ftcd_comm_socket.cpp.

ftcd_comm_status_e send_response ( const uint8_t *  response_message,
uint32_t  response_message_size 
) [inherited]

Writes a response message to the communication line.

The method build response message with header and signature (if requested) and writes it to the line

Parameters:
response_messageThe message to send through the communication line medium
response_message_sizeThe message size in bytes
Returns:
FTCD_COMM_STATUS_SUCCESS on success, otherwise appropriate error from ftcd_comm_status_e

Definition at line 152 of file ftcd_comm_base.cpp.

ftcd_comm_status_e send_response ( const uint8_t *  response_message,
uint32_t  response_message_size,
ftcd_comm_status_e  status_code 
) [inherited]

Writes a response message with status to the communication line.

The method build response message with status, header and signature (if requested) and writes it to the line

Parameters:
response_messageThe message to send through the communication line medium
response_message_sizeThe message size in bytes
Returns:
FTCD_COMM_STATUS_SUCCESS on success, otherwise appropriate error from ftcd_comm_status_e

Definition at line 157 of file ftcd_comm_base.cpp.

ftcd_comm_status_e wait_for_message ( uint8_t **  message_out,
uint32_t *  message_size_out 
) [virtual]

Wait and read complete message from the communication line.

The method waits in blocking mode for new message, allocate and read the message, and sets message_out and message_size_out

Parameters:
message_outThe message allocated and read from the communication line
message_size_outThe message size in bytes
Returns:
FTCD_COMM_STATUS_SUCCESS - On success. In this case the client socket, and accepted connection remain open waiting for the next message with next call. FTCD_COMM_NETWORK_TIMEOUT - This means a timeout has occurred, client socket close and next call will create a new socket and accept a new connection. Other ftcd_comm_status_e error code - some other error has occurred, client socket will be closed and next call will create and open a new socket, and wait for a new connection.

Reimplemented from FtcdCommBase.

Definition at line 295 of file ftcd_comm_socket.cpp.

Generated on Tue Jul 12 2022 20:21:05 by  doxygen 1.7.2