VxWorks Reference Manual : Libraries

ntEnd

NAME

ntEnd - END network interface driver to ULIP for vxSim for Windows NT

ROUTINES

ntLoad( ) - initialize the driver and device
ntParse( ) - parse the init string
ntMemInit( ) - initialize memory for the chip
ntPollStart( ) - start polled mode operations
ntPollStop( ) - stop polled mode operations
ntInt( ) - handle controller interrupt

DESCRIPTION

        This driver provides a fake ethernet intface to the "ULIP" driver written by WRS. The driver essentially gets packets from vxWorks, and writes them directly to file, where the ULIP driver handles them.

The macro SYS_ENET_ADDR_GET is used to get the ethernet address (MAC) for the device. The single argument to this routine is the NTEND_DEVICE pointer. By default this routine copies the ethernet address stored in the global variable ntEnetAddr into the NTEND_DEVICE structure.

INCLUDES

end.h endLib.h etherMultiLib.h

SEE ALSO

ntEnd, muxLib, endLib Writing and Enhanced Network Driver


Libraries : Routines

ntLoad( )

NAME

ntLoad( ) - initialize the driver and device

SYNOPSIS

END_OBJ * ntLoad
    (
    char * initString, /* String to be parse by the driver. */
    void * nothing
    )

DESCRIPTION

This routine initializes the driver and the device to the operational state. All of the device specific parameters are passed in the initString.

The string contains the target specific parameters like this:

"unit:register addr:int vector:int level:shmem addr:shmem size:shmem width"

RETURNS

An END object pointer or NULL on error.

SEE ALSO

ntEnd


Libraries : Routines

ntParse( )

NAME

ntParse( ) - parse the init string

SYNOPSIS

STATUS ntParse
    (
    NTEND_DEVICE * pDrvCtrl,
    char *         initString
    )

DESCRIPTION

Parse the input string. Fill in values in the driver control structure.

The initialization string format is:

 "unit:csrAdr:rapAdr:vecnum:intLvl:memAdrs:memSize:memWidth"
unit
Device unit number, a small integer.

vecNum
Interrupt vector number (used with sysIntConnect)

intLvl
Interrupt level (isn't really used)

RETURNS

OK or ERROR for invalid arguments.

SEE ALSO

ntEnd


Libraries : Routines

ntMemInit( )

NAME

ntMemInit( ) - initialize memory for the chip

SYNOPSIS

STATUS ntMemInit
    (
    NTEND_DEVICE * pDrvCtrl /* device to be initialized */
    )

DESCRIPTION

This routine is highly specific to the device.

RETURNS

OK or ERROR.

SEE ALSO

ntEnd


Libraries : Routines

ntPollStart( )

NAME

ntPollStart( ) - start polled mode operations

SYNOPSIS

STATUS ntPollStart
    (
    NTEND_DEVICE* pDrvCtrl
    )

DESCRIPTION

RETURNS

OK or ERROR.

SEE ALSO

ntEnd


Libraries : Routines

ntPollStop( )

NAME

ntPollStop( ) - stop polled mode operations

SYNOPSIS

STATUS ntPollStop
    (
    NTEND_DEVICE* pDrvCtrl
    )

DESCRIPTION

This function terminates polled mode operation. The device returns to interrupt mode.

The device interrupts are enabled, the current mode flag is switched to indicate interrupt mode and the device is then reconfigured for interrupt operation.

RETURNS

OK or ERROR.

SEE ALSO

ntEnd


Libraries : Routines

ntInt( )

NAME

ntInt( ) - handle controller interrupt

SYNOPSIS

void ntInt
    (
    NTEND_DEVICE * pDrvCtrl,
    void *         pRcvBuffer,
    int            rcvLen
    )

DESCRIPTION

This routine is called at interrupt level in response to an interrupt from the controller.

RETURNS

N/A.

SEE ALSO

ntEnd