@CHIP-RTOS C Library - TCP/IP API

Dev_Recv_Interface

Receive and process incoming data at the TCP/IP stack.

int Dev_Recv_Interface( DevUserIfaceHandle DevHandlePtr,
                        int * errorcode);

Parameters

DevHandlePtr

Device handle

errorcode

Output parameter:  Failure code, 0 on success.

Return Value

0: success
-1: See reported errorcode .

Comments

Go here for example usage of this API.

This API invokes your device driver's receiver callback function to collect the incoming data from your device.   Your receiver callback function will then pass the received data up the TCP/IP stack.

See Also

Dev_Open_Interface        Dev_Recv_Wait        Dev_Notify_ISR
Dev_Send_Complete        Dev_Wait_DHCP_Complete        

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

On SC1x3/SC2x (RTOS version >=1.13, CLIB version >=2.10) there's also a version of this function which uses dynamic linking instead of a software interrupt, which reduces the function's overhead and thus speeds up your application. This function's name is Dev_Recv_Interface_Dyn. You should however not use this function directly. Instead you should add the define TCPIP_DYN_LINK_DEV to your program before including the CLIB's header file(s):

#define TCPIP_DYN_LINK_DEV
#include <clib.h>

This will map the original function's name to the dynamic linking version. This way you can also easily switch existing programs to dynamic linking.

Related Topics

Example - function which would be called by this API

Example - Receiver Task which calls this API

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
V1.10	V1.00	V1.00	V0.90	V1.00