Automatic Installation This driver supports the automatic installation procedure defined by the IBM LAN Adapter and Protocol Support (LAPS) module. LAPS is provided by IBM with the following services: IBM OS/2 Extended Services 1.0 IBM OS/2 LAN Server 2.0 IBM OS/2 LAN Requester 2.0 Manual Installation 1. Copy the driver TR2KNDIS.OS2, and the message file TR2KNDIS.MSG from the installation diskette to the desired fixed disk drive and directory. 2. Add the following line to the CONFIG.SYS. DEVICE=[drive:directory]TR2KNDIS.OS2 This line should be entered immediately following the line which installs the PROTMAN.OS2 device driver. NOTE: You must specify a DPATH in CONFIG.SYS to the subdirectory containing the TR2KNDIS.MSG file to enable driver error messages and alleviate the "Cannot find message file" error at boot time. 3. Add the following section to PROTOCOL.INI [TR2KNDIS_NIF] DriverName = TR2NDS$ 4. Add TR2KNDIS_NIF to the bindings list of the protocol in the PROTOCOL.INI. An example protocol section follows. [NETBEUI_XIF] DriverName = NETBEUI$ Bindings = TR2KNDIS_NIF TR2KNDIS Parameters The PROTOCOL.INI file defines the configuration of protocol and NDIS drivers. The following table summarizes TR2KNDIS parameters. 旼컴컴컴컴컴컴컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴컴커 � Parameter � Range � Default � � � � OS/2 � 쳐컴컴컴컴컴컴컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴컴캑 � DRIVERNAME � TR2NDS$ or TR2NDSn$ � Required � � PORT � See description. � 0xA20 � � INT � 2 - 12 � 9 � � DMA � 0, 1, 3, 5, 6 or 7 � PSDMA � � SPEED � 4 or 16 � 16 � � BIT16 � � - � � WS0 � � - � � MAXTRANSMITS � 3 - 50 � 6 � � NUMRXBUFFERS � 3 - 100 � 6 � � RXBUFFERSIZE � 256 - 17960 � 2048 � � NOEARLYRELEASE � � - � � NETADDRESS � "000000000000"-"7FFFFFFFFFFF"� BIA � � RPL � � - � 읕컴컴컴컴컴컴컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴컴켸 DRIVERNAME Identifies the network device driver. The DRIVERNAME is TR2NDS$ for the first driver and TR2NDS2$ for the second, and so on. This parameter is required. NOTE: the "K" in "TR2K" is NOT present in the DRIVERNAME due to character limitations. PORT If no PORT is specified, the driver will assume the default address. Valid addresses reside on a 32-bit boundary between hexadecimal 0x40 and 0x7fe0. This parameter is required when multiple adapter support is desired. INT Selects the interrupt (IRQ) value to use for communication with the adapter. This parameter is required when multiple adapter support is desired. DMA Sets the appropriate DMA channel to select on adapters that support DMA. If DMA is not specified, Pseudo DMA mode is assumed. SPEED Sets the speed at which the adapter is to open onto the ring. This has no effect on adapters that don't support software selection for speed (i.e. must be a TMS380C26+ based adapter). BIT16 Directs the driver to do 16-bit Pseudo DMA I/O at the base IOADDRESS plus 0x10 register. This provides a performance enhancement for adapters supporting this feature. This is only valid in Pseudo DMA mode. This entry is not followed by an equal sign. BIT16 and WS0 are mutually exclusive. WS0 Directs the driver to do 8-bit Pseudo DMA I/O at the base IOADDRESS plus 0x10 register. This provides a performance enhancement for adapters that support zero wait state I/O's. This is only valid in Pseudo DMA mode. This entry is not followed by an equal sign. WS0 and BIT16 are mutually exclusive. MAXTRANSMITS Sets the number of transmits that can be queued simultaneously by the driver. NUMRXBUFFERS Sets the number of receive buffers to allocate. RXBUFFERSIZE Sets the size of buffers used to queue received frames in the driver. Several buffers may be required to queue a large frame. Performance is improved if a received frame fits in one buffer. Use the following formula to determine maximum frame size. MediaMaxSize equals 17960 @ 16 Mbps, or 4490 @ 4 Mbps. MaxFrameSize = min(min(8, NumReceiveBuffers) x ReceiveBufferSize, MediaMaxSize) NOEARLYRELEASE This entry informs the driver to disable early token release. Early token release reduces the average time another network adapter must wait to transmit a frame. This entry is not followed by an equal sign. NETADDRESS This entry allows the driver to override the burned in address (BIA). The entry must be a 12 character string of hexadecimal digits, and must be enclosed in quotes. RPL This entry provides compatibility when RPLing under OS/2. This parameter should be specified for each station performing RPL. This entry should NOT be specified on server or non-RPLing PC's. *** NOTE *** Unpredictable results will occur if adapter hardware settings do not match parameter or default values. Unpredictable results will also occur if parameters are specified on adapters that don't support that particular feature. For example, the following is a sample PROTOCOL.INI file: [TR2KNDIS_NIF] DRIVERNAME = TR2NDS$ PORT = 0xA20 MAXTRANSMITS = 10 NUMRXBUFFERS = 12 RXBUFFERSIZE = 1024 NETADDRESS = "400000000312" BIT16 SPEED = 4 If the Token Ring adapter is equipped with the Fast Packet Accelerator chip (FPA device), the microcode file RTR16FPA.COD must be copied to the boot directory.