home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / wr07060a.zip / US7060B2.DSK / DRIVERS / TI.ZIP / tr2kndis.txt < prev   
Text File  |  1994-10-18  |  6KB  |  163 lines
  1. Automatic Installation
  2.  
  3.     This driver supports the automatic installation procedure defined
  4.     by the IBM LAN Adapter and Protocol Support (LAPS) module. LAPS is
  5.     provided by IBM with the following services:
  6.  
  7.         IBM OS/2 Extended Services 1.0
  8.         IBM OS/2 LAN Server 2.0
  9.         IBM OS/2 LAN Requester 2.0
  10.  
  11. Manual Installation
  12.  
  13.      1. Copy the driver TR2KNDIS.OS2, and the message file TR2KNDIS.MSG
  14.         from the installation diskette to the desired fixed disk
  15.         drive and directory.
  16.  
  17.      2. Add the following line to the CONFIG.SYS.
  18.  
  19.           DEVICE=[drive:directory]TR2KNDIS.OS2
  20.  
  21.         This line should be entered immediately following the line
  22.         which installs the PROTMAN.OS2 device driver.
  23.  
  24.     NOTE: You must specify a DPATH in CONFIG.SYS to the subdirectory
  25.           containing the TR2KNDIS.MSG file to enable driver error
  26.           messages and alleviate the "Cannot find message file" error
  27.           at boot time.
  28.  
  29.      3. Add the following section to PROTOCOL.INI
  30.  
  31.           [TR2KNDIS_NIF]
  32.               DriverName = TR2NDS$
  33.  
  34.      4. Add TR2KNDIS_NIF to the bindings list of the protocol in the
  35.         PROTOCOL.INI. An example protocol section follows.
  36.  
  37.           [NETBEUI_XIF]
  38.                DriverName = NETBEUI$
  39.                Bindings = TR2KNDIS_NIF
  40.  
  41. TR2KNDIS Parameters
  42.  
  43.      The PROTOCOL.INI file defines the configuration of protocol
  44.      and NDIS drivers. The following table summarizes TR2KNDIS
  45.      parameters.
  46.  
  47. ┌────────────────────┬──────────────────────────────┬──────────┐ 
  48. │  Parameter         │         Range                │ Default  │
  49. │                    │                              │   OS/2   │
  50. ├────────────────────┼──────────────────────────────┼──────────┤ 
  51. │  DRIVERNAME        │ TR2NDS$ or TR2NDSn$          │ Required │
  52. │  PORT              │ See description.             │   0xA20  │
  53. │  INT               │ 2 - 12                       │     9    │
  54. │  DMA               │ 0, 1, 3, 5, 6 or 7           │   PSDMA  │
  55. │  SPEED             │ 4 or 16                      │    16    │
  56. │  BIT16             │                              │     -    │
  57. │  WS0               │                              │     -    │
  58. │  MAXTRANSMITS      │ 3 - 50                       │     6    │
  59. │  NUMRXBUFFERS      │ 3 - 100                      │     6    │
  60. │  RXBUFFERSIZE      │ 256 - 17960                  │    2048  │
  61. │  NOEARLYRELEASE    │                              │     -    │
  62. │  NETADDRESS        │ "000000000000"-"7FFFFFFFFFFF"│    BIA   │
  63. │  RPL               │                              │     -    │
  64. └────────────────────┴──────────────────────────────┴──────────┘
  65.  
  66. DRIVERNAME
  67.      Identifies the network device driver. The DRIVERNAME is TR2NDS$
  68.      for the first driver and TR2NDS2$ for the second, and so on.
  69.      This parameter is required. NOTE: the "K" in "TR2K" is NOT present
  70.      in the DRIVERNAME due to character limitations.
  71.  
  72. PORT
  73.      If no PORT is specified, the driver will assume the default
  74.      address. Valid addresses reside on a 32-bit boundary between
  75.      hexadecimal 0x40 and 0x7fe0. This parameter is required when
  76.      multiple adapter support is desired.
  77.  
  78. INT
  79.      Selects the interrupt (IRQ) value to use for communication with
  80.      the adapter. This parameter is required when multiple adapter
  81.      support is desired.
  82.  
  83. DMA
  84.      Sets the appropriate DMA channel to select on adapters that support
  85.      DMA. If DMA is not specified, Pseudo DMA mode is assumed.
  86.  
  87. SPEED
  88.      Sets the speed at which the adapter is to open onto the ring. This
  89.      has no effect on adapters that don't support software selection
  90.      for speed (i.e. must be a TMS380C26+ based adapter).
  91.  
  92. BIT16
  93.      Directs the driver to do 16-bit Pseudo DMA I/O at the base IOADDRESS
  94.      plus 0x10 register. This provides a performance enhancement for adapters
  95.      supporting this feature. This is only valid in Pseudo DMA mode. This
  96.      entry is not followed by an equal sign. BIT16 and WS0 are mutually
  97.      exclusive.
  98.  
  99. WS0
  100.      Directs the driver to do 8-bit Pseudo DMA I/O at the base IOADDRESS
  101.      plus 0x10 register. This provides a performance enhancement for
  102.      adapters that support zero wait state I/O's. This is only valid in
  103.      Pseudo DMA mode. This entry is not followed by an equal sign. WS0
  104.      and BIT16 are mutually exclusive.
  105.  
  106. MAXTRANSMITS
  107.      Sets the number of transmits that can be queued simultaneously
  108.      by the driver.
  109.  
  110. NUMRXBUFFERS
  111.      Sets the number of receive buffers to allocate.
  112.  
  113. RXBUFFERSIZE
  114.      Sets the size of buffers used to queue received frames in the
  115.      driver. Several buffers may be required to queue a large
  116.      frame. Performance is improved if a received frame fits in one
  117.      buffer. Use the following formula to determine maximum frame
  118.      size. MediaMaxSize equals 17960 @ 16 Mbps, or 4490 @ 4 Mbps.
  119.  
  120.      MaxFrameSize = 
  121.           min(min(8, NumReceiveBuffers) x ReceiveBufferSize, MediaMaxSize)
  122.  
  123. NOEARLYRELEASE
  124.      This entry informs the driver to disable early token release.
  125.      Early token release reduces the average time another network
  126.      adapter must wait to transmit a frame. This entry is not
  127.      followed by an equal sign.
  128.  
  129. NETADDRESS
  130.      This entry allows the driver to override the burned in address
  131.      (BIA). The entry must be a 12 character string of hexadecimal
  132.      digits, and must be enclosed in quotes.
  133.  
  134. RPL
  135.      This entry provides compatibility when RPLing under OS/2. This
  136.      parameter should be specified for each station performing RPL.
  137.      This entry should NOT be specified on server or non-RPLing PC's.
  138.  
  139.  
  140.  
  141. *** NOTE ***
  142.      Unpredictable results will occur if adapter hardware settings 
  143.      do not match parameter or default values. Unpredictable results
  144.      will also occur if parameters are specified on adapters that
  145.      don't support that particular feature.
  146.  
  147.  
  148. For example, the following is a sample PROTOCOL.INI file:
  149.  
  150.      [TR2KNDIS_NIF]
  151.           DRIVERNAME = TR2NDS$
  152.           PORT = 0xA20
  153.           MAXTRANSMITS = 10
  154.           NUMRXBUFFERS = 12
  155.           RXBUFFERSIZE = 1024
  156.           NETADDRESS = "400000000312"
  157.           BIT16
  158.           SPEED = 4
  159.  
  160. If the Token Ring adapter is equipped with the Fast Packet Accelerator 
  161. chip (FPA device), the microcode file RTR16FPA.COD must be copied to 
  162. the boot directory.
  163.