
File Name:    RELEASE.TXT
Product Name: NI5210-NDISDRV
Description:  OS/2 NDIS 2.01 Driver for Racal Interlan NI5210
Version:      5.03
Part Number:  158-0195-00 
	      149-0195-00


SECTION 1 - Overview
--------------------
The driver in this directory allows the Racal Interlan NI5210 to be used in
OS/2-based systems to run networking software written to the NDIS specification.

This driver has been written for conformance to the NDIS specification as 
described in "Microsoft/3COM LAN Manager Network Driver Interface 
Specification - Version 2.0.1.". 

Version 3.60 of this driver was included on the distribution diskettes for
Microsoft LAN Manager 2.1.

Version 3.64 included a fix for clearing the direction flag (cld) and 
changes to support OS/2 Extended Edition.

Version 3.65 supports IBM OS/2 v2.0. It has been tested in the Racal Interlan 
labs for correct operation with LAN Manager 2.1.

Version 5.03 supports multiple (up uo 4) NI5210 cards in a system.

Note that the explanations in Section 4 and Section 5 generally apply to
LAN Manager systems. They may or may not apply to other protocol stacks 
that use NDIS drivers. Complete details can be found by referencing the 
driver section of your network software documentation.


SECTION 2 - Contents of this directory
---------------------------------------
To help you install and use this product, the following files are included
in this directory:

RELEASE.TXT  - This file

SAMPLES.TXT  - Sample configuration files for commonly used NDIS-based 
	       protocol stacks.

NI5210.OS2   - NI5210 OS/2 NDIS Driver 

PROTOCOL.INI - Text file that describes the configuration of the driver
	       and data-link card to the networking software. 

	       You may have to edit this file to match the physical
	       configuration of your card. For more information, see 
	       Section 4 for an explanation of the PROTOCOL.INI parameters.

The NI5210.OS2 and PROTOCOL.INI files are included in the \MSLANMAN.OS2 
directory on this diskette in the structure recommended by Microsoft to 
allow automatic installation under LAN Manager. 

Also included under \MSLANMAN.OS2 is the NI5210.NIF file, which is used by
the LAN Manager setup program to display available network drivers. See 
Section 5 for an explanation of the NI5210.NIF parameters.



SECTION 3 - Installing NDIS drivers under LAN Manager
-----------------------------------------------------
To install a network driver under LAN Manager, we recommend that you import 
and configure the driver using the SETUP program, as follows:

1) Move to the LANMAN installation directory (typically C:\LANMAN) and 
   invoke SETUP. 

2) Select the IMPORT option from the ACTION menu, and follow the instructions 
   for installing a driver disk.

3) Once the driver has been imported, select the VIEW/MODIFY option from 
   the ACTION menu to configure the driver. (Repeat this step if installing
   more than one NI5210 card in your system.)

SETUP should make the necessary driver modifications to the CONFIG.SYS and
PROTOCOL.INI files.

For example, if you configured the NetBEUI protocol stack to bind with two 
NI5210 cards (one with I/O base address 360 and another with 340), the 
resulting PROTOCOL.INI file should contain the following:

  [NETBEUI_XIF]
    DRIVERNAME = NETBEUI$
    BINDINGS = "NI5210_NIF", "NI5210_NIF2"

  [NI5210_NIF]
    DRIVERNAME = NI5210$
    IOBASE = 0x360         (NI5210 with I/O base address 360)

  [NI5210_NIF2]
    DRIVERNAME = NI52102$
    IOBASE = 0x340         (NI5210 with I/O base address 340)

The NI5210 driver should appear twice in CONFIG.SYS, with the I/O base address
specified as follows:

   DEVICE=C:\LANMAN\DRIVERS\ETHERNET\NI5210\NI5210.OS2 /p:360
   DEVICE=C:\LANMAN\DRIVERS\ETHERNET\NI5210\NI5210.OS2 /p:340



SECTION 4 - Entries in the PROTOCOL.INI File
---------------------------------------------
The following tables summarize the possible entries and values in 
the [NI5210_NIF] section of the PROTOCOL.INI file:

		Table 1 - Entries in the PROTOCOL.INI file
---------------------------------------------------------------------
Entry                           Explanation
---------------------------------------------------------------------
BASEMEM         The base memory address of the shared memory on the
		NI5210 NIC.  This must match the setting on the card.
---------------------------------------------------------------------
DRIVERNAME      Identifies the network device driver.  DRIVERNAME is
		the base portion of the file name, plus a digit if
		more than one NI5210 is installed.  DRIVERNAME is
		NI5210$ for the first NI5210, NI52102$ for the 
		second, and so on.
---------------------------------------------------------------------
IOBASE          Indicates the base I/O address for the NIC.  If this
		entry does not match the NIC's I/O address jumper
		settings, the driver reports an error. 
---------------------------------------------------------------------
IRQ             Indicates the interrupt level of the NIC.  If this 
		entry does not match the NIC's interrupt level 
		jumper settings, the driver reports an error.
---------------------------------------------------------------------
MAXMULTICASTS   Sets the maximum number of multicast addresses the 
		driver supports.
---------------------------------------------------------------------
MAXRECEIVES     Sets the number of receives that can be queued 
		simultaneously.
---------------------------------------------------------------------
MAXTRANSMITS    Sets the number of TrasmitChain commands that can be
		queued simultaneously.
---------------------------------------------------------------------

These entries can have the following minimum and maximum values:

			Table 2 - Min/Max Entries
---------------------------------------------------------------------
Entry           Minimum         Maximum         Default
---------------------------------------------------------------------
BASEMEM         0xC0000 hex     0xEC000 hex     0xD0000 hex     
---------------------------------------------------------------------
DRIVERNAME      NI5210$         NI5210n$        required entry
---------------------------------------------------------------------
IOBASE          0x200 hex       0x3F8 hex       0x300 hex       
---------------------------------------------------------------------
IRQ             2               7               2       
---------------------------------------------------------------------
MAXMULTICASTS   1               16              10
---------------------------------------------------------------------
MAXRECEIVES     1               6               3
---------------------------------------------------------------------
MAXTRANSMITS    1               50              6
---------------------------------------------------------------------



SECTION 5 - Entries in the *.NIF File
-------------------------------------

			Table 3 - Entries in the *.NIF file
---------------------------------------------------------------------
Model           Used by the LAN Manager SETUP program to display the
		name of the driver.
---------------------------------------------------------------------
Path            Directory location of all files pertinent to the 
		driver, i.e. the PROTOCOL.INI file and the driver 
		itself (NI5210.DOS or NI5210.OS2).  The LAN Manager
		installation program appends the value of this field
		to "@lanroot\drivers\" to create a complete path for
		accessing PROTOCOL.INI and the device drivers. Check 
		the value of "@lanroot\drivers" (or equivalent field
		for other network operating systems) if your installation 
		program can not find the driver or PROTOCOL.INI files.
---------------------------------------------------------------------
DeviceDriver    Name of the driver that will be added to CONFIG.SYS.  
		If more than one driver must be added, then multiple
		"DeviceDriver" lines should be specified.
---------------------------------------------------------------------
Type            Specifies that the driver is an NDIS driver.
---------------------------------------------------------------------
Xports          Applies to NDIS drivers only and indicates the 
		transports that this driver has been tested with. A
		warning may be generated by the LAN Manager SETUP 
		program if the user attempts to combine the driver with 
		a transport that is not listed in the Xports list.
---------------------------------------------------------------------



