**
**                                   
**  VIA Networking Velocity Family Gigabit Ethernet Adapter
** 
**  ODI Driver for NetWare 3.12 Server
** 
**  v2.01    Oct, 2004
**
**

Introduction:
=============

  The Gigabit Ethernet Adapter Driver for NetWare 3.12 Servers confirms to 
  the Novell Open Data-Link Interface (ODI) specification. This document 
  shows you how to setup the driver and how to use the enhanced functions 
  by setting the custom keywords.


Contents of the Subdirectory:
=============================

    NW312.TXT           This file.
    GETNWSA.LAN         The ODI driver for NetWare 3.12 Server.
    ETHERTSM.NLM        Patch file for Netware 3.12 Server (v3.80).
    MSM31X.NLM          Patch file for Netware 3.12 Server (v3.95).
    NBI31X.NLM          Patch file for Netware 3.12 Server (v2.25).

Installation:
=============

  Before starting with the installation process, make sure that the adapter
  is properly installed and configured. You can use the diagnostic program
  (A:\SETUP.EXE) in DOS mode to make sure your connection with the network is
  correct.

  Using Server Install utility:
  -----------------------------
    1) On the server console, execute the INSTALL.NLM program:

                LOAD INSTALL <Enter>

    2) Choose "System Options/Edit AUTOEXEC.NCF file". If you had not create
       AUTOEXEC.NCF file, please choose "System Options/Create AUTOEXEC.NCF
       file" at first. 
    
    3) Add the LOAD and BIND command lines to the AUTOEXEC.NCF file so
       that the LAN driver will be loaded automatically while the server
       is starting up.


  Loading Driver Manually:
  ------------------------
    1) On the server console, load the driver directly, for example:

          LOAD A:\NETWARE\NWSERVER.312\GETNWSA FRAME=Ethernet_802.2

    2) Bind with IPX:

          BIND IPX GETNWSA

    3) You can login the server from a workstation, and then copy GETNWSA.LAN to
       the directory SYS:\SYSTEM on server. Add the LOAD and BIND command lines
       to AUTOEXEC.NCF file so that the lan driver will be loaded automatically
       while the server starting up next time.


  NOTE:
  -----
    1) Multiple Lan Adapters in a system:
        If you want to install mutiple lan adapters in a server, you have to use
        the keyword, SLOT, to let driver locate the right adapter.
        For example:

            LOAD GETNWSA SLOT=1 FRAME=Ethernet_802.2 NAME=Lan_1
            BIND IPX TO Lan_1 NET=2001
            LOAD GETNWSA SLOT=2 FRAME=Ethernet_802.2 NAME=Lan_2
            BIND IPX TO Lan_2 NET=2002

        And the server's packet receive buffers probably need to be increased.
        To do this, setting the following command to STARTUP.NCF file.

            SET MINIMUM PACKET RECEIVE BUFFERS=500  (Or higher)

    2) Tagging ability :
        If keyword "TAG" is supported, the transmited packets
        will be tagged packets. It's only supportted by management adapter.

    3) VLAN support :
        For now, we only support one VID value setting. It's only supportted by 
        management adapter.

    4) The required minimum versions of the three support NLMs are :

        For NW3.12 and later                    
        NBI31X.NLM  (v2.25 10/20/98 )           
        MSM31X.NLM  (v3.95 05/12/99 )           
        ETHERTSM.NLM(v3.8  03/01/99 )           

        NBI.NLM (or NBI31X.NLM) must be loaded before MSM and ETHERTSM.
        NetWare 3.12 needs MSM31X.NLM renamed to MSM.NLM.

        We recommends you use the latest Novell Service Packs. The latest server 
        NLMs and support files for NetWare can be found on Novell's automated 
        services under the heading of "Minimum Patch List".

    5) Flow Control ability:
        "Hardware Default (Auto)" means the flow control ability depends on the
        auto-negotiation result with the link partner.
        In other settings ("Enable Tx", "Enable Rx", "Enable Tx/Rx"), driver will
        set the Tx or Rx flow control ability without auto-negotiation.

    6) If the receive buffers are not enough for flow control ability using,
       driver will disable flow control automatically.

    7) Tx Rx buffers setting :
        If you want to set buffer size, you have to use the two keywords "TBUF" "RBUF".


Configuration Parameters:
=========================

    Custom Keywords:
    ----------------
    
        CONNECTIONTYPE                  This keyword is used to specify media type.
        
            CONNECTIONTYPE=AutoSense
            CONNECTIONTYPE=10BASET
            CONNECTIONTYPE=10BASETFD
            CONNECTIONTYPE=100BASETX
            CONNECTIONTYPE=100BASETXFD
            
        FLOW_CONTROL                    This keyword is used to specify flow control
                                        ability.
            FLOW_CONTROL=DISABLE
            FLOW_CONTROL=ENABLE
            FLOW_CONTROL=TX
            FLOW_CONTROL=RX
            FLOW_CONTROL=HARDWARE_DEFAULT   (default)
            
        TAG                             This keyword is used to enable TX tagging.
                                        It's combined with VID keyword for transmitting
                                        tagged packet. Only be supported by management 
                                        adapter.
            TAG=ENABLE
            TAG=DISABLE                 (default)
            
        VID                             This keyword is used to support VLAN's VID.
                                        Only be supported by management adapter.
            VID=1~4094

        TBUF                            This keyword is used to set buffers of transmitting.
                                        It determines the number of TD.
            TBUF=48~128

        RBUF                            This keyword is used to set buffers of receiving.
                                        It determines the number of RD.
                                        (The server's packet receive buffers probably need to
                                         be increased if you want to increase the default value
                                         of RBUF. Setting the following command to STARTUP.NCF
                                         file can increase receive buffers.

                                         SET MINIMUM PACKET RECEIVE BUFFERS=500  (Or higher)    )
            RBUF=48~128