**
**
**  VIA Rhine Family Fast Ethernet Adapter
**
**  MAX OS X (10.2.x) driver
**
**  v1.09    Dec. 2005
**
** 

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

  The Fast Ethernet 10/100M MAC OS X (10.2.x) driver is enclosed. This document 
  shows you how to setup the driver.

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

    OSX.txt               This file.
    fetmacx.dmg           The disk image of the driver. 

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

    1) Install the adapter to the computer, and remember the PCI Slot number
       which is written on the back pane of the computer.

    2) Login as root. 

    3) Copy the disk image fetmacx.dmg to the desktop 

    4) Click the disk image fetmacx.dmg to mount it.

    5) Click the package fetmacx.pkg in the folder fetmacx to install it.

    6) Click the restart button to restart the computer

    7) Please refer to documents of MAC OS X to set up the network connection. 

Connection media type selection
===============================
    You can use ifconfig command parameter to set the connection media type.
The supporting connection type and the ifconfig command parameters are listed
below (suppose the NIC is hooked on interface 4):

    1) Auto-negotiation    : ifconfig en4 media autoselect
    2) 100Mbps Half-duplex : ifconfig en4 media 100baseTX mediaopt half-duplex
    3) 100Mbps Full-duplex : ifconfig en4 media 100baseTX mediaopt full-duplex
    4) 10Mbps  Half-duplex : ifconfig en4 media 10baseT/UTP mediaopt half-duplex
    5) 10Mbps  Full-duplex : ifconfig en4 media 10baseT/UTP mediaopt full-duplex

Driver tunable properties (Experts only)
========================================

    You can tune up the performance of driver by modified the Info.plist file 
after the driver is installed. The file Info.plist can be located at directory
/System/Library/Extensions/fetmacx.kext/Contents/.

    The Info.plist file is written in XML format. To modify it, you may find the 
key matching the keys listed below and then change the value. 

The tunable properties is listed as following:

RxDescriptors:

    RxDescriptors is used for the number of descriptors to be used for receiving.

    Value: 
       Default: 64
       Value:   16-128

TxDescriptors:

    TxDescriptors is used for the number of descriptors to be used for transmitting.

    Value: 
       Default: 64
       Range:   16-128

DMALength:

    DMALength is used for controlling the DMA length.

    Value:
        0: 8 DWORDs 
        1: 16 DWORDs (Default)
        2: 32 DWORDs
        3: 64 DWORDs
        4: 128 DWORDs
        5: 256 DWORDs
        6: SF(flush till emply)
        7: SF(flush till emply)

TxThresh:

    TxThresh 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

RxThresh:

    RxThresh 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 the we use store and forward.

FlowControl

    FlowControl is used for setting the flow control ability of NIC.

    Value:
        1: hardware deafult. Use Hardware default value in ANAR.
        2: disable PAUSE in ANAR. (Default)
        3: enable PAUSE in ANAR.

ValPktLen:

    ValPktLen is used to drop 802.3 frame with invalid length.

    Value:
        No: Disable (Default)
        Yes: Enable 

TxChecksumOffload (Management NIC only)
    TxChecksumoffload is used for enable/disable hardware TCP/IP checksum offload.
         
    Value:
        No:  Disable (Default)
        Yes: Enable 
