**
**
**  VIA Networking Velocity Family Gigabit Ethernet Adapter
**
**  MAX OS X (10.2.x) driver
**
**  v1.04    Jan. 2006
**
**

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

  The Gigabit Ethernet 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.
    getmacx.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 getmacx.dmg to the desktop

    3) Click the disk image getmacx.dmg to mount it.

    4) Click the package getmacx.pkg in the folder getmacx to install it.

    5) Click the restart button to restart the computer

    6) 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/getmacx.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:

ConnectionType:

    ConnectionType is used for forcing connection type in loading driver.

    Value:
        0: AUTO (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

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
        2: 32 DWORDs
        3: 64 DWORDs
        4: 128 DWORDs (Default)
        5: 256 DWORDs
        6: SF(flush till emply)
        7: SF(flush till emply)

FlowControl:

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

    Value:
        0: Disalbe flow control
        1: Enalbe flow control
        2: Enalbe Receive flow control
        3: Enalbe Transmit flow control
        4: hardware deafult (Default). Use Hardware default value 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