home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 29 Fixes_o / 29-Fixes_o.zip / us8210b4.dsk / IBMCOM / MACS / MACS.ZIP / ibmcom / macs / tr2kndis.txt < prev    next >
Text File  |  1995-09-28  |  7KB  |  158 lines
  1. TMS380/2000 NDIS MAC 2.0x Drivers for DOS and OS/2
  2.  
  3. General information on optional parameters for TR2KNDIS drivers.
  4.  
  5.      1. Driver File Names and files.
  6.  
  7.     DOS:    File Name:    TR2KNDIS.DOS      DOS NDIS 2.0x MAC Driver
  8.                 OEMSETUP.INF    WFW Installation file
  9.                 TR2KFPA.COD    PacketBlaster adapter code 
  10.     
  11.  
  12.     OS2:    File Name:    TR2KNDIS.OS2    OS2 NDIS 2.0x MAC Driver
  13.                 TR2KNDIS.MSG    OS2 Message file
  14.                 TR2KNDIS.NIF    OS2 Installation file
  15.  
  16.       2. Typical CONFIG.SYS entries:
  17.  
  18.           DEVICE=[drive:directory]TR2KNDIS.OS2
  19.                or
  20.           DEVICE=[drive:directory]TR2KNDIS.DOS
  21.  
  22.         This line should be entered immediately following the line
  23.         which installs the PROTMAN.OS2 or PROTMAN.DOS device
  24.         driver.
  25.  
  26.     OS/2 NOTE: You must specify a DPATH in CONFIG.SYS to the subdirectory
  27.           containing the TR2KNDIS.MSG file to enable driver error
  28.           messages and alleviate the "Cannot find message file" error
  29.           at boot time.
  30.  
  31.      3. Add the following section to PROTOCOL.INI
  32.  
  33.           [TR2KNDIS_NIF]
  34.               DriverName = TR2NDS$
  35.  
  36.      4. Add TR2KNDIS_NIF to the bindings list of the protocol in the
  37.         PROTOCOL.INI. An example protocol section follows.
  38.  
  39.           [NETBEUI_XIF]
  40.                DriverName = NETBEUI$
  41.                Bindings = TR2KNDIS_NIF
  42.  
  43.  
  44. TR2KNDIS Parameters
  45.  
  46.      The PROTOCOL.INI file defines the configuration of NDIS Protocol
  47.      and NDIS MAC drivers. The following table summarizes TR2KNDIS
  48.      parameters. For additional information about the PROTOCOL.INI
  49.      file and network device drivers, refer to the Microsoft LAN
  50.      Manager Network Device Driver Guide.
  51.  
  52. ┌────────────────────┬──────────────────────────────┬──────────┬──────────┐ 
  53. │  Parameter         │         Range                │ Default  │ Default  │
  54. │                    │                              │   DOS    │   OS/2   │
  55. ├────────────────────┼──────────────────────────────┼──────────┼──────────┤ 
  56. │  DRIVERNAME        │ TR2NDS$ or TR2NDSn$          │ Required │ Required │
  57. │  IOADDRESS or PORT │ See description.             │   0xA20  │   0xA20  │
  58. │  BIT16             │                              │     -    │     -    │
  59. │  LOOKAHEAD         │ See description.             │     -    │     -    │
  60. │  MAXTRANSMITS      │ 3 - 50                       │     3    │     6    │
  61. │  NETADDRESS        │ "400000000000"-"7FFFFFFFFFFF"│    BIA   │    BIA   │
  62. │  NOEARLYRELEASE    │                              │     -    │     -    │
  63. │  NUMRXBUFFERS      │ 3 - 100                      │     3    │     6    │
  64. │  PCI               │ See description.             │    N/A   │   0xA20  │
  65. │  PIU               │ 265 - 2048                   │    265   │    265   │
  66. │  PROMISCUOUS       │ See description.             │     -    │     -    │
  67. │  RXBUFFERSIZE      │ 256 - 17960                  │    2048  │    2048  │
  68. └────────────────────┴──────────────────────────────┴──────────┴──────────┘
  69.  
  70. DRIVERNAME
  71.      Identifies the network device driver. The DRIVERNAME is TR2NDS$
  72.      for the first driver and TR2NDS2$ for the second, and so on.
  73.      This parameter is required.
  74.  
  75. IOADDRESS or PORT
  76.      If no PORT is specified, the driver will assume the default
  77.      address. Valid addresses reside on a 32-bit boundary between
  78.      hexadecimal 0x100 and 0xFFE0. This parameter is required when
  79.      multiple adapter support is desired.
  80.  
  81. BIT16
  82.      Directs the driver to use 16 bit I/O data transfers to and from the 
  83.      network adapter.  Without this keyword, the driver will attempt to
  84.      auto-detect the adapter data path width.
  85.  
  86. LOOKAHEAD
  87.      Directs the driver to use the Receive Lookahead method in lieu of
  88.      the default Receive Chain method.  NDIS requires the upper protocol
  89.      to support either method.  Some protocols have been found to only
  90.      support Receive Lookahead.  Receive Chain will typically give better
  91.      performance on DMA and PIO based adapters.
  92.  
  93. MAXTRANSMITS
  94.      Sets the number of transmits that can be queued simultaneously
  95.      by the driver.
  96.  
  97. NETADDRESS
  98.      This entry allows the driver to override the burned in address
  99.      (BIA). The entry must be a 12 character string of hexadecimal
  100.      digits, and must be enclosed in quotes.
  101.  
  102. NOEARLYRELEASE
  103.      This entry informs the driver to disable early token release.
  104.      Early token release reduces the average time another network
  105.      adapter must wait to transmit a frame. This entry is not
  106.      followed by an equal sign.
  107.  
  108. NUMRXBUFFERS
  109.      Sets the number of receive buffers to allocate.
  110.  
  111. PCI
  112.      (Required for OS/2 only) Instructs the driver that the adapter
  113.      port given on the PCI line of PROTOCOL.INI is a PCI adapter.
  114.      Valid I/O addresses for PCI are 0x100 to 0xFFE0.
  115.  
  116. PIU
  117.      Instructs the driver to implement Lying Sends on all transmits smaller
  118.      than the given PIU (Program Interchange Unit) size.  The driver by default 
  119.      will verify each transmit on the physical ring before confirming the
  120.      transmit to the upper protocol.  Personal Communications 3270 ver 3.0x
  121.      reqires all PIU transfers to confirm the transmit before it is physically
  122.      transmitted on the ring. The PIU option enables this 'Lying' send.  
  123.  
  124. PROMISCUOUS
  125.      Enable driver PROMISCUOUS function to allow adapter to copy all
  126.      frames to the upper protocol.  Used for LAN analysis tools. Must 
  127.      install TR2KCAF.COD (or TR2KFPA.COD if PacketBlaster is used) in
  128.      the root directory of the default drive to support this feature.
  129.  
  130. RXBUFFERSIZE
  131.      Sets the size of buffers used to queue received frames in the
  132.      driver. Several buffers may be required to queue a large
  133.      frame. Performance is improved if a received frame fits in one
  134.      buffer. Use the following formula to determine maximum frame
  135.      size. MediaMaxSize equals 17960 @ 16 Mbps, or 4490 @ 4 Mbps.
  136.  
  137.      MaxFrameSize = 
  138.           min(min(8, NumReceiveBuffers) x ReceiveBufferSize, MediaMaxSize)
  139.  
  140. Note:
  141.      Adapters equipped with the FPA PacketBlaster option must use special
  142.      microcode to enable this feature.  Copy the file TR2KFPA.COD to the
  143.      root directory of the default drive to allow this code to be downloaded
  144.      to the adapter hardware. This will increase overall adapter performance.
  145.  
  146.  
  147.  
  148. Sample PROTOCOL.INI file:
  149.  
  150.      [TR2KNDIS_NIF]
  151.           DRIVERNAME = TR2NDS$
  152.           PORT = 0xFCE0
  153.           MAXTRANSMITS = 10
  154.           NUMRXBUFFERS = 12
  155.           RXBUFFERSIZE = 1024
  156.           NETADDRESS = "400000000312"
  157.  
  158.