www.beck-ipc.com

@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

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

    SC12SC13SC11SC1x3SC2x
    V1.10V1.00V1.00V0.90V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document