Back to Contents Page

ODI Driver Software: Broadcom NetXtreme II™ Network Adapter User Guide

Overview

ODI Client32

DOS ODI

Overview

Three drivers are discussed in this section:

The examples used in the ODI Client32 section only refer to the BX2.LAN driver. The examples used in the DOS ODI section refer to the BX2.COM driver, but also apply to the BNX2EV.COM driver.

ODI Client32

The Open Data-Link Interface (ODI) driver software allows LAN drivers to work together irrespective of differences between the hardware and/or the protocol stacks of communicating systems. An intervening layer, called the link support layer (LSL), is responsible for routing different packet types between local area network (LAN) drivers and protocol stacks.

Installing the Driver Software

The ODI Driver software must be installed on a system having an MS-DOS operating system. MS-DOS 6.22 is recommended.

Preinstallation Requirements
  1. Copy the Broadcom ODI driver files to a floppy disk. Copy the BX2.LAN and BX2.LDI files for the Client32 driver.
  2. Go to the Novell web site http://www.novell.com/coolsolutions/tools/13555.html and download the NetWare DOS Client files to the hard disk: download the dw271e.zip file for the Client32 installation.
Installing the Novell NetWare Client32 Driver for MS-DOS
  1. Extract the dw271.zip file to a temporary directory on the hard disk.
  2. Double-click the dw271e.exe file.
  3. Type y and then press ENTER when you are prompted for a response.
  4. Restart your system in MS-DOS mode.
  5. Change to the directory where the extracted files are located.
  6. Type install, and then press ENTER.
  7. Read the agreement, and then press ENTER to accept the agreement.
  8. Using the UP ARROW or DOWN ARROW key as necessary, highlight Novell Client for DOS (required), and then press F10 to save and continue.
  9. Highlight 32-bit LAN Drivers, and then press F10 to save and continue.
  10. Insert the floppy disk containing the Broadcom 32-bit LAN driver files into the floppy disk drive.
  11. Highlight USER SPECIFIED 32-BIT DRIVER, and then press ENTER.
  12. Press ENTER.
  13. Highlight the NetXtreme II Gigabit Ethernet Driver, and then press ENTER.
  14. Press ENTER.
  15. Select Receive Buffers, type 32 for the value, and then press F10 to save and continue.
  16. NOTE: Do not change the default settings for any of the other items in the Installation Configuration Summary.

  17. Press F10 to save and continue. The Bx2.LAN and Bx2.LDI files are copied to the directory.
  18. Restart the system to complete the install.
  19. As the files are being loaded, the system attempts to attach to a NetWare server using the frame types specified in Net.cfg. If the connection is successful, a dialog box is displayed.
  20. Change to drive F and log on to the NetWare server.
  21. NOTE: The driver loads during system configuration, and the Broadcom banner, the adapter name, the MAC address, the IRQ number, the detected line speed, and the bus number (BusNum) and device number (DevNum) of the adapter are displayed. If the driver fails to load, an initialization fail message appears.

Configuring the Driver Software

The ODI driver software can be configured by adding specific optional keywords to the Net.cfg file.

If multiple (or multiport) Broadcom NetXtreme II adapters are installed in a system, the ODI driver software loads by default on the adapter/port that has a good link. If two or more adapters have a good link, the ODI driver software loads on the adapter having the latest Device ID. If two or more adapters that have a good link have the same Device ID, the ODI driver software loads on the adapter that is located in the slot having the lowest bus number.

If it is necessary to have the ODI driver load on certain adapters in a certain order, the BusNum, DevNum, and FuncNum keywords can be used. Do not use these keywords unless you know how to configure PCI devices.

The BusNum keyword value, which represents the PCI bus number in which the adapter is located, is a hexadecimal number ranging from 0 to FF.

The FuncNum keyword value, which represents the function (port) number of a multiport adapter, is a hexadecimal number with 0 representing the first port and 1 representing the second port.

The DevNum keyword value, which represents the assigned device number, is a hexadecimal number ranging from 0 to 1F.

NOTES:

The LineSpeed keyword is used to force the speed of the network connection. The LineSpeed keyword requires a decimal number and of either 10, 100, or 1000. Technically, a line speed of 1000 Mbit/s cannot be forced and can be achieved only through auto-negotiation. For the sake of simplicity, the driver performs auto-negotiation when the line speed is set to a value of 1000.

The Duplex keyword is used to force the duplex mode of the adapter. The Duplex keyword requires a text string of either HALF or FULL. When the Duplex keyword is used, the LineSpeed keyword must also be used. If neither keyword is used, the network adapter defaults to auto-negotiation mode.

Example keyword entries for the LineSpeed, and Duplex keywords are shown below:

LINK DRIVER BX2
LINESPEED 100
DUPLEX FULL 

DOS ODI

The Open Data-Link Interface (ODI) driver software allows LAN drivers to work together irrespective of differences between the hardware and/or the protocol stacks of communicating computers. An intervening layer, called the link support layer (LSL), is responsible for routing different packet types between LAN drivers and protocol stacks.

NOTE: The examples used in this section refer to the BX2.COM driver, but also apply to the BNX2EV.COM driver.

Installing the Driver Software

Installing the DOS/ODI driver software involves the following steps:

  1. Verifying that the DOS 6.22 operating system files are installed on your computer hard disk or are available on a removable storage device.
  2. Installing the DOS/ODI driver software in the DOS environment.
  3. If necessary, reconfiguring the driver software after installation.
Preinstallation Requirements
  1. Verify that the Broadcom Ethernet adapter driver software has been installed on your computer and install it if it has not (see Installing the Driver Software). Otherwise, you cannot use a Broadcom Ethernet adapter in the DOS environment.
  2. NOTE: To successfully install the adapter driver for DOS, the adapter must be installed in the computer before you install the driver.

  3. Install the DOS 6.22 files on your computer hard disk or have them available on a removable storage device.
Installing the DOS ODI Driver on DOS 6.22
  1. Copy the DOS ODI driver file to the root directory of the hard disk.
  2. Copy Lsl.com, Ipxodi.com, and Vlm.com to the same directory (these files are provided by Novell).
  3. Edit the Autoexec.bat file by adding the following lines:
  4. C:\LSL
    C:\BX2
    C:\IPXODI
    C:\VLM
  5. Edit the Net.cfg file and place the file in the same location as the Autoexec.bat file (located in drive C) to configure the driver to bind with different frame types.
  6. Example:

    LINK DRIVER BX2
    FRAME ETHERNET_802.2
    FRAME ETHERNET_802.3
    FRAME ETHERNET_II
    FRAME ETHERNET_SNAP

    NetWare DOS Requester
    FIRST NETWORK DRIVE=F
    NETWARE PROTOCOL=NDS BIND

    PROTOCOL IPXODI
  7. Restart the computer to complete the installation.
  8. As the files are being loaded, the computer attempts to attach to a NetWare server using the frame types specified in Net.cfg.  If the connection is successful, a dialog box appears. 
  9. Change to drive F and log onto the NetWare server.
  10. F: <enter>
    
    F:\login admin <enter>
    

    NOTE: The driver loads during system configuration, and the Broadcom banner, the adapter name, the MAC address, the IRQ number, the detected line speed, and the BUSNUM and DEVNUM of the adapter are displayed. If the driver fails to load, an initialization fail message appears.

Configuring Parameters for the BX2.com/BX2EV.COM Driver (in the Net.cfg file)

The following are optional custom keywords used in the Net.cfg file:

BUSNUM
DEVNUM
FUNNUM
SUBVID
MODEL

The first two keywords (BUSNUM and DEVNUM) are used together and have been included for manufacturing purposes.  Do not use them unless you are familiar with PCI device configuration. These two keywords are needed if multiple Broadcom NetXtreme II adapters are installed on a system, and each adapter must be loaded in a specific order.

BUSNUM specifies the PCI bus number and DEVNUM specifies the device number that is assigned to the board when it is configured by the PCI BIOS.

The values for these adapter parameters are displayed in hexadecimal notation when the driver loads (the Net.cfg file expects hexadecimal values). A PCI device scan utility can also be used to find this information. If the driver loads on a single adapter, the displayed values can be used in the Net.cfg file.

If a PCI scan utility displays card 1 at bus 4 and device 11 (hexadecimal), and card 3 at bus 3 and device 13 (hexadecimal), the following load instructions are written to the Net.cfg file (load card 3 first, and optionally load card 1 second):

LINK DRIVER BX2
BUSNUM 3
DEVNUM 13 (13 hex = 19 decimal)
LINK DRIVER BX2
BUSNUM 4
DEVNUM 11 (11 hex = 17 decimal)

The FUNNUM keyword is used to determine which function/port the driver is to load on when using a multifunction (multiport) adapter. Function number values are limited to 0 and 1, for the first and second function of the adapter.

The SUBVID keyword is used to for load the driver only on the first network interface card found that has a subvendor ID (SVID) that matches the one set in Net.cfg. The driver ignores all other network interface cards that do not have a matching SVID. SUBVID expects a hexadecimal number.

Example:

LINK DRIVER BX2
SUBVID 14E4

SUBVID cannot be used with BUSNUM, DEVNUM or FUNNUM.

The MODEL keyword is for loading the driver only on the first network interface card found that has a subvendor ID (SVID) that matches the one set in MODEL. The driver ignores all other NICs that do not have a matching SVID. MODEL expects a decimal number.

Example:

LINK DRIVER B44
MODEL 5348


Back to Contents Page