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

❍ Device Receive function
❍ Device FreeReceive function
❍ Device Get PhysicalAddress function
❍ Implementation of an interrupt service routine (ISR) and receiver task
❍ Install the device driver
Device Open function
Top of list
Index page
The TCP/IP stack calls this (optional) function to initialize the hardware and (optional) to install an Interrupt
Service handler. If Borland C compilers are used the driver functions must be declared as huge (see below).
Microsoft C users must declare driver functions as far _saveregs _loadds .
The function should return 0 if initialization was successful. If initialization failed, return -1.
Generic Example:
int huge myDevOpen(DevUserIfaceHandle ifaceHandle)
{
// Install (if necessary) a RTOS Interrupt Service function with
// HWAPI handler function 0xA1 service 0x84
return 0;
}
Device Close function
Top of list
Index page
The TCP/IP stack will execute this (optional) function when the device driver interface is closed with the
DEV_CLOSE_IFACE API call.
This callback function should return 0 if the closing of the device was successful, otherwise -1 on failure.
Generic example:
int huge myDevClose(DevUserIfaceHandle ifaceHandle)
{
// DeInitialize the hardware
// Remove the ISR handler
return 0;
}
Device Send function
This callback function is used by the TCP/IP stack to send the data out the device. The TCP/IP stack does not
call this function from within a separate transmit task. This callback executes in the thread which made the send
call, e.g. API_SEND API.
This callback function should return 0 if the sending of data was successful, otherwise -1 on error.
Important:
If the input parameter flaghas value 1 (this indicates this is last frame in block) you must call
DEV_SND_COMPLETEto tell the TCP/IP stack that the send buffer is no longer in use.
Page 344 / 400