T1108 TR2KASI.SYS DEVICE DRIVER The LLC code file, TR2KLLC.COD in combination with the TR2KASI.SYS device driver provides the same programming interface as the IBM Token Ring PC Adapter DLC driver, DXMC0MOD.SYS. Thus, when TR2KASI.SYS is used in place of DXMC0MOD.SYS, programs that have been written for the IBM PC interface will also work on Token Ring adapters that comply to the generic T1108 specification. To install the device driver, replace DXMC0MOD.SYS in the CONFIG.SYS file with TR2KASI.SYS. To configure the device driver there are command line options that can be specified in the CONFIG.SYS file. The format for specifying the options is as follows: DEVICE=TR2KASI.SYS [NODE ADDRESS] [PORT ADDRESS] [INT] [SPEED] [ALT] [BIT16] [WS0] [BUFFER SIZE] [AIB] Brackets [] are used to indicate optional parameters. If the NODE ADDRESS parameter is specified, it must be the first parameter on the line. All other parameters may occur in any order. All parameters except NODE ADDRESS, are preceded by a "/". NODE ADDRESS is used to specify a 12 character node address to be used in place of the burned in address (BIA). The address MUST be a 12 digit hexadecimal number in the range of 000000000000 to 7FFFFFFFFFFF. If this parameter is omitted then the adapter BIA address will be used . PORT ADDRESS is used to indicate the port I/O address of the installed adapter. To select a specific I/O PORT ADDRESS, use the /PORT=xxxx option, where xxxx a valid 4 digit hexadecimal address. If the /PORT= option is omitted, the default PORT ADDRESS is 0A20. ***** NOTE: The PORT ADDRESS MUST be 4 digits. Leading zeros MUST be present (i.e. /PORT=0A40). The INT option is used to specify which interrupt (IRQ) is being used to communicate to the adapter. INT 2 is the default if the INT parameter is not specified. To override the default, select the /INT = xx option, where xx is a one or two digit decimal value indicating the valid INT selected for the Token Ring adapter. If INT 9 is specified, INT 2 will be used to provide compatibility with 8 bit interfaces and 3270 emulation programs. The SPEED parameter may be used to software select a ring speed of 4 Mbps. The adapter will default to 16 Mbps. The syntax for this option is /SPEED=4. The ALT parameter may be used to specify an adapter as the ALTERNATE or SECONDARY adapter. The BIT16 parameter is used to select 16 bit pseudo DMA transfers to/ from the base PORT ADDRESS plus 0x10. Pseudo DMA defaults to 8 bit mode to/from the base PORT ADDRESS. To select 16 bit mode, specify the /BIT16 option. The WS0 parameter tells the driver to select 8 bit pseudo DMA transfers to/from the base PORT ADDRESS plus 0x10. This allows adapters designed to support this feature to perform zero wait-state I/O's. To select zero wait-state 8 bit mode, specify the /WS0 option. BUFFER SIZE can be used to select any receive buffer size up to 18000 bytes. Default BUFFER SIZE is 4216 bytes. To set the BUFFER SIZE, include the /BUF= parameter followed by the number of bytes to allocate for the receive buffer. For example, /BUF=2048 would set the receive buffer size to 2K. ***** WARNING: Do not configure your network to generate frames that exceed the maximum receive buffer size. AIB is used to install a 256 byte block of data in base system memory to provide adapter information to 3270 communications programs. This is needed for Token Ring Adapters which have no on-board ROM, or which have ROM disabled. If used on PS/2 type systems with an extended BIOS data segment at 639K an additional 7.2KBytes may be allocated to align to an 8K boundry. INSTALLING TR2KASI FOR A TOKEN RING LAN ADAPTER CARD: ====================================================== To install TR2KASI.SYS for use with NETBIOS, replace DXMA0MOD.SYS and DXMC0MOD.SYS with TR2KA0.SYS and TR2KASI.SYS in the CONFIG.SYS file and include any desired parameters. An example follows: Example 1. DEVICE=TR2KA0.SYS DEVICE=TR2KASI.SYS DEVICE=DXMT0MOD.SYS Example 1 loads TR2KASI.SYS with the default parameters: the node address is determined by the adapter BIA, the adapter speed is 16 mbps , the port address is A20, and pseudo DMA is enabled. The buffer size will be 4K. Example 2. DEVICE=TR2KA0.SYS DEVICE=TR2KASI.SYS /PORT=0A40 /BIT16 DEVICE=DXMT0MOD.SYS Example 3. DEVICE=TR2KA0.SYS DEVICE=TR2KASI.SYS /PORT=0A20 /BUF=16384 DEVICE=DXMT0MOD.SYS Example 4. DEVICE=TR2KA0.SYS DEVICE=TR2KASI.SYS 400000001111 /SPEED=4 /BUF=1100 DEVICE=DXMT0MOD.SYS Example 5. DEVICE=TR2KA0.SYS DEVICE=TR2KASI /PORT=0A20 /INT=2 DEVICE=TR2KASI /ALT /PORT=0A40 /INT=3 DEVICE=DXMT0MOD.SYS Example 2 installs the adapter with a port address of A40. The adapter will use its adapter BIA for the node address. The adapter will perform data transfers in 16 bit pseudo DMA mode. The receive buffer size for both adapters is set to 4K bytes. Example 3 installs the adapter with a port address of A20. The adapter will use its adapter BIA for the node address. The receive buffer size is set to the 16K. Example 4 installs the adapter with a node address of 400000001111. The buffer size will be 1100 bytes. The adapter will software select a ring speed of 4 Mbps. Example 5 installs the TR2KA0 Interrupt Arbitrator and then loads the PRIMARY adapter at PORT 0A20 using Interrupt 2, and then loads the ALTERNATE adapter at PORT A40 using Interrupt 3. If NETBIOS is not needed, omit the DXMT0MOD.SYS line. The LLC code required by the T1108 adapter resides in a file called TR2KLLC.COD. This file must be available in the root directory for TR2KASI.SYS to read during load time. ***** NOTE: Unpredictable results will occur if hardware capabilities or jumper selections do not match those selected by the parameter or default values.