tcp_connect

#include <rtl.h>

BOOL tcp_connect (
    U8  socket,       /* Socket handle of the local machine. */
    U8* remip,        /* Pointer to IP address of remote machine. */
    U16 remport,      /* Port number of remote machine. */
    U16 locport );    /* Port number of local machine. */

The tcp_connect function initiates a connection to a remote server. The argument socket is a handle to the socket to use for communication on the local machine. The argument locport specifies the port to use for communication on the local machine. If locport is set to 0, TCPnet automatically allocates the first free TCP port.

The argument remip points to the buffer containing the ip address octets of the remote server to connect to. The argument remport specifies the TCP port number on the remote machine to communicate with.

The tcp_connect function is in the RL-TCPnet library. The prototype is defined in rtl.h.

note

• Only a socket of type TCP_TYPE_CLIENT or TCP_TYPE_CLIENT_SERVER can call the tcp_connect function.

The tcp_connect function returns __TRUE when the connection establishment procedure has been started successfully. Otherwise, the function returns __FALSE.

tcp_abort, tcp_close, tcp_listen

#include <RTL.h>

U8 tcp_soc;

U16 tcp_callback (U8 soc, U8 event, U8 *ptr, U16 par) {
  /* This function is called on TCP event */
   ..
  return (0);
}

void main (void) {
  U8 rem_ip[4] = {192,168,1,110};

  init ();
  /* Initialize the TcpNet */
  init_TcpNet ();
  tcp_soc = tcp_get_socket (TCP_TYPE_CLIENT, 0, 30, tcp_callback);
  if (tcp_soc != 0) {
    /* Start Connection */
    tcp_connect (tcp_soc, rem_ip, 80, 1000);
  }

  while (1);
    /* Run main TcpNet 'thread' */
    main_TcpNet ();
     ..
  }
}