IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

interface has its own IP configuration and is used by the TCP/IP stack for IP communication in the same way
as the pre-installed internal devices of the IPC@CHIP (e.g. Internal Ethernet, PPP server or PPPclient).
For more detailed description and a generic example see How to add an TCP/IP device driver/link layer
interface.
On the first DEV_OPEN_IFACE call for installing a TCP/IP device driver, the IfaceHandle member of the
DevUserDriver structure at [ES:DI] must be NULL. If an interface is closed with DEV_CLOSE_IFACE and the
user wants to reopen that device interface (e.g. for changing IP configuration) , the IfaceHandle value set
by the system in the first DEV_OPEN_IFACE call must be preserved.
You will find all needed types, constants and prototypes in the CLIB header files TCPIPAPI.H and TCPIP.H.
Clib TCPIP.C implementation of this function:
int Dev_Open_Interface( DevUserDriver far * DriverInfo,
int * errorcode)
Please note: The API calls 0xA0 through 0xA7 for implementing your own TCP/IP device drivers are
not part of our six official @CHIP-RTOS versions. For ordering special version including this feature,
please contact support@beck-ipc.com.
Related Topics
Top of list
Index page
DEV_CLOSE_IFACE - Close device driver interface
DEV_WAIT_DHCP_COMPLETE - Wait for DHCP IP configuration
Example - Installing device driver
Interrupt 0xAC service 0xA1: DEV_CLOSE_IFACE, Close TCP/IP device driver/interface
Parameters
AH
ES:DI
Close a TCP device driver/interface, remove an added link layer from the internal TCP/IP stack.
0xA1 (=DEV_CLOSE_IFACE)
Device handle from the IfaceHandle member of the DevUserDriver structure used at the
DEV_OPEN_IFACE call.
Return Value
Comments
DX = 0, AX = 0: Success.
DX = -1: AX contains error code
222: Invalid parameter
236: Closing already in progress
237: Device already closed
This function closes the device driver/interface. It calls the driver close function and deactivates the layer from
the internal TCP/IP stack of the @CHIP-RTOS.
Page 150 / 400