VxWorks Reference Manual : Libraries

if_ultra

NAME

if_ultra - SMC Elite Ultra Ethernet network interface driver

ROUTINES

ultraattach( ) - publish ultra interface and initialize device
ultraPut( ) - copy a packet to the interface.
ultraShow( ) - display statistics for the ultra network interface

DESCRIPTION

This module implements the SMC Elite Ultra Ethernet network interface driver.

This driver supports single transmission and multiple reception. The Current register is a write pointer to the ring. The Bound register is a read pointer from the ring. This driver gets the Current register at the interrupt level and sets the Bound register at the task level. The interrupt is never masked at the task level.

CONFIGURATION

The W1 jumper should be set in the position of "Software Configuration". The defined I/O address in config.h must match the one stored in EEROM. The RAM address, the RAM size, and the IRQ level are defined in config.h. IRQ levels 2,3,5,7,10,11,15 are supported.

EXTERNAL INTERFACE

The only user-callable routines are ultraattach( ) and ultraShow( ):

ultraattach( )

publishes the ultra interface and initializes the driver and device.

ultraShow( )

displays statistics that are collected in the interrupt handler.

SEE ALSO

if_ultra

---

Libraries : Routines

ultraattach( )

NAME

ultraattach( ) - publish ultra interface and initialize device

SYNOPSIS

STATUS ultraattach
    (
    int unit,    /* unit number */
    int ioAddr,  /* address of ultra's shared memory */
    int ivec,    /* interrupt vector to connect to */
    int ilevel,  /* interrupt level */
    int memAddr, /* address of ultra's shared memory */
    int memSize, /* size of ultra's shared memory */
    int config   /* 0: RJ45 + AUI(Thick) 1: RJ45 + BNC(Thin) */
    )

DESCRIPTION

This routine attaches an ultra Ethernet interface to the network if the device exists. It makes the interface available by filling in the network interface record. The system will initialize the interface when it is ready to accept packets.

RETURNS

OK or ERROR.

SEE ALSO

if_ultra, ifLib, netShow

---

Libraries : Routines

ultraPut( )

NAME

ultraPut( ) - copy a packet to the interface.

SYNOPSIS

#ifdef BSD43_DRIVER LOCAL void ultraPut
    (
    int unit /* device unit number */
    )

DESCRIPTION

Copy from mbuf chain to transmitter buffer in shared memory.

RETURNS

N/A

SEE ALSO

if_ultra

---

Libraries : Routines

ultraShow( )

NAME

ultraShow( ) - display statistics for the ultra network interface

SYNOPSIS

void ultraShow
    (
    int  unit, /* interface unit */
    BOOL zap   /* zero totals */
    )

DESCRIPTION

This routine displays statistics about the elc Ethernet network interface. It has two parameters:

unit

interface unit; should be 0.

zap

if 1, all collected statistics are cleared to zero.

RETURNS

N/A

SEE ALSO

if_ultra