**
**
**  VIA Rhine Family Fast Ethernet Adapter                      
**
**  Solaris 8/9
**
**  v1.03   Aug. 2003
**
**

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

    This document describes the procedure to install the Solaris 8/9 driver for 
"VIA Rhine Family Fast Ethernet Adapter".


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

    fets.pkg            The ethernet driver for Solaris 8/9.
    fets.txt            This file.


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

    Solaris 8/9 

    Installing driver procedure on Solaris 8/9 :
    -----------------------------------------
      Before you start with the installation process, make sure that the
      Solaris 8/9 system is properly installed. Similarly, your adapter
      should also be properly installed in your machine.

     1. Installation Diskette in DOS format.
        Put the "VIA Rhine Family Fast Ethernet Adapter" Solaris 8/9 Driver
        diskette to floppy A: and copy driver package into Solaris's directories.

       # volcheck
       # cp /floppy/floppy0/fets.pkg  /tmp

     2. Run 'pkgadd' utility to add the driver software to system.

       # pkgadd -d /tmp/fets.pkg
         => Select "1 fets VIA Rhine Family Fast Ethernet Adapter Driver"
            to add the driver package to the system.
         => quit

     3. Create or rename the /etc/hostname.XXX# to /etc/hostname.fets#
     	
        The '#' of filename /etc/hostname.fetsX is the instance number of
     driver. You can find this instance by examine the output of program
     'dmesg'.        

     4. Shutdown and reboot the system.

       # cd /
       # sync;sync;reboot

     NOTE:
      
      	1. This driver can support up to four network adapters.


Network driver options:
=======================

    The following parameters can be set after we installed the driver. 
You can add all parameters to /kernel/drv/fets.conf

	The syntax of parameter is:
	
         <parameter name>=value1,value2,value3,...;

    For example, if you have 3 NIC cards, and you want to set the speed_duplex 
paramter value of them .

    You can add the following line to set it.

    speed_duplex=1,2,3;

    Then, the parameter value of first NIC card with index=0 will be 1 
(100Mbps half duplex mode), the second NIC card with index=1 will be 2 
(100Mbps full duplex mode), and the third NIC card with index=2 will be 3 
(10Mbps half duplex mode). You can use 'dmesg' to find out the index number
of each card.

1) speed_duplex
   speed_duplex[] is used for setting the speed and duplex mode of NIC.
   Value:
       0: indicate autonegotiation for both speed and duplex mode (Default).
       1: indicate 100Mbps half duplex mode
       2: indicate 100Mbps full duplex mode
       3: indicate 10Mbps half duplex mode
       4: indicate 10Mbps full duplex mode

2) enable_tagging (For management adapter only) 
   enable_tagging[] is used for enabling VLAN ID setting and enabling
   priority transmit.
   Value:
       0: disable VID setting and priority transmit (Default).
       1: enable VID setting and priority transmit.

3) VID_setting (For management adapter only) 
   VID_setting[] is used for setting the VLAN ID of NIC.
   Value:
       0: default VID.
       1-4094: other VIDs.


4) flow_control
   flow_control[] is used for setting the flow control ability of NIC.
   Value:
       1: hardware deafult (Default). Use Hardware default value in ANAR.
       2: disable PAUSE in ANAR.
       3: enable PAUSE in ANAR.




5) tx_thresh
   tx_thresh[] is used for controlling the transmit fifo threshold.
   Value:
       0: indicate the txfifo threshold is 128 bytes (Default).
       1: indicate the txfifo threshold is 256 bytes.
       2: indicate the txfifo threshold is 512 bytes.
       3: indicate the txfifo threshold is 1024 bytes.
       4: indicate that we use store and forward

6) rx_thresh
   rx_thresh[] is used for controlling the receive fifo threshold.
   Value:
       0: indicate the rxfifo threshold is 64 bytes (Default).
       1: indicate the rxfifo threshold is 32 bytes.
       2: indicate the rxfifo threshold is 128 bytes.
       3: indicate the rxfifo threshold is 256 bytes.
       4: indicate the rxfifo threshold is 512 bytes.
       5: indicate the rxfifo threshold is 768 bytes.
       6: indicate the rxfifo threshold is 1024 bytes.   
       7: indicate that we use store and forward
       
7) DMA_length
   DMA_length[] is used for controlling the DMA length.
   Value:
       0: 8 DWORDs
       1: 16 DWORDs (Deafult)
       2: 32 DWORDs
       3: 64 DWORDs
       4: 128 DWORDs
       5: 256 DWORDs
       6: SF(flush till emply)
       7: SF(flush till emply)