UIP application functions
[The UIP TCP/IP stack]

Connect to a remote host using TCP.

This function is used to start a new connection to the specified port on the specied host. It allocates a new connection identifier, sets the connection to the SYN_SENT state and sets the retransmission timer to 0. This will cause a TCP SYN segment to be sent out the next time this connection is periodically processed, which usually is done within 0.5 seconds after the call to uip_connect().

Note:

This function is avaliable only if support for active open has been configured by defining UIP_ACTIVE_OPEN to 1 in uipopt.h.

Since this function requires the port number to be in network byte order, a conversion using HTONS() or htons() is necessary.

 uip_ipaddr_t ipaddr;

 uip_ipaddr(&ipaddr, 192,168,1,2);
 uip_connect(&ipaddr, HTONS(80));

Parameters:

ripaddr	The IP address of the remote hot.
port	A 16-bit port number in network byte order.

Returns:

A pointer to the UIP connection identifier for the new connection, or NULL if no connection could be allocated.

Note:

Parameters:

@retval

Definition at line 443 of file uip.c.

Start listening to the specified port.

Note:

Since this function expects the port number in network byte order, a conversion using HTONS() or htons() is necessary.

 uip_listen(HTONS(80));

Parameters:

port	A 16-bit port number in network byte order.

Definition at line 572 of file uip.c.

Send data on the current connection.

This function is used to send out a single segment of TCP data. Only applications that have been invoked by UIP for event processing can send data.

The amount of data that actually is sent out after a call to this funcion is determined by the maximum amount of data TCP allows. UIP will automatically crop the data so that only the appropriate amount of data is sent. The function uip_mss() can be used to query UIP for the amount of data that actually will be sent.

Note:

This function does not guarantee that the sent data will arrive at the destination. If the data is lost in the network, the application will be invoked with the uip_rexmit() event being set. The application will then have to resend the data using this function.

Parameters:

data	A pointer to the data which is to be sent.
len	The maximum amount of data bytes to be sent.

Definition at line 2050 of file uip.c.

Set up a new UDP connection.

This function sets up a new UDP connection. The function will automatically allocate an unused local port for the new connection. However, another port can be chosen by using the uip_udp_bind() call, after the uip_udp_new() function has been called.

Example:

 uip_ipaddr_t addr;
 struct uip_udp_conn *c;
 
 uip_ipaddr(&addr, 192,168,2,1);
 c = uip_udp_new(&addr, HTONS(12345));
 if(c != NULL) {
   uip_udp_bind(c, HTONS(12344));
 }

Parameters:

ripaddr	The IP address of the remote host.
rport	The remote port number in network byte order.

Returns:

The uip_udp_conn structure for the new connection or NULL if no connection could be allocated.

Note:

Parameters:

@retval

Definition at line 516 of file uip.c.

Stop listening to the specified port.

Note:

Since this function expects the port number in network byte order, a conversion using HTONS() or htons() is necessary.

 uip_unlisten(HTONS(80));

Parameters:

port	A 16-bit port number in network byte order.

Definition at line 562 of file uip.c.