(C)Copyright 2003-2005 Marvell(R).
All rights reserved.

=======================================================================

dlgebsd53x86-6.12.1.3.htm created 02-Mar-2005

Readme File for dlgebsd53x86-6.12.1.3.tgz 

DGE-530T Gigabit Ethernet Adapter


This file contains 
  1  Overview 
  2  Required Files 
  3  Installation 

    3.1  Installation of driver software 
    3.2  Deinstallation of driver software 

  4  Parameters 





1  Overview 
The dlgebsd driver supports the DGE-530T Gigabit Ethernet Adapter
on the FreeBSD 5.3 operating system running on Intel x86 hardware.


2  Required Files 
For proper software installation the following package file is required:
dlgebsd53x86-6.12.1.3.tgz .


3  Installation 
This section describes the installation of the driver software on a
computer running FreeBSD 5.3.

3.1  Installation of driver software 

NOTE: root privileges are necessary to install the driver.
First of all, the package containing the driver software must be installed.
This is done by typing:

pkg_add dlgebsd53x86-6.12.1.3.tgz

This installs the driver binary into /boot/kernel and the manpage into
/usr/share/man/man4.
In order for the system to load the driver automatically on booting, the
following line must be added to the file /boot/loader.conf:

if_dlge_load="YES"

In addition to this, the following line must be added to the /etc/rc.conf
file to configure the interface when the system is booted:

ifconfig_dlge0="inet 192.168.100.1"

This assumes a local IP address of 192.168.100.1. You must replace this
IP address with your computer's IP address.
On reboot, the driver will be loaded and the interface configured
automatically.

It is also possible to load and unload the kernel module by hand. To load
the kernel module by hand, type:

kldload if_dlge.ko

To unload the kernel module by hand, type:

kldunload if_dlge.ko

3.2  Deinstallation of driver software 

To deinstall the driver, type:

pkg_delete dlgebsd53x86-6.12.1.3

Note that this merely removes the driver kernel module from the
/boot/kernel directory, as well as the manpage from the /usr/share/man/man4
directory.
If you have set up your machine to load the driver automatically, you must
delete the lines you added in /boot/loader.conf and /etc/rc.conf


4  Parameters 

There are a number of driver parameters that can be changed to suit different
operating conditions. These parameters include:

o Speed
o Duplex settings
o Hardware checksumming
o Clocking Master
o Virtual LANs
o Jumbo frames

All these parameters are modified with the ifconfig utility. For detailed
information about the usage of this program, please consult the relevant
FreeBSD manual pages (ie. man ifconfig).

Speed
=====
The following adapter speed settings are available:
auto         Auto-negotiated speed setting (default)
1000baseTX   1000baseTX, no auto-negotiation
100baseTX    100baseTX, no auto-negotiation
10baseT/UTP  10baseT/UTP, no auto-negotiation

To change the adapter speed setting to 100baseTX, type:

ifconfig dlge0 media 100baseTX

To switch it back to auto-negotiation, type:

ifconfig dlge0 media auto

Duplex
======
Please note that half duplex at 1000baseTX is not supported.
Duplex settings (full or half duplex) are set with the mediaopt keyword. For
example, to set 100baseTX, half duplex, type:

ifconfig dlge0 media 100baseTX mediaopt half-duplex

To clear half-duplex mode, prefix the mediaopt keyword with a hyphen:

ifconfig dlge0 media 100baseTX -mediaopt half-duplex

Note that clearing half-duplex mode implies setting full-duplex.

Checksumming
============
By default, hardware checksumming is enabled for both receive and transmit.
To turn this feature off, type:

ifconfig dlge0 -rxcsum

or

ifconfig dlge0 -txcsum

Note that it is currently not possible to switch hardware checksumming on or
off independently. It is only possible to switch both transmit and receive
together.

To turn hardware checksumming on, type:

ifconfig dlge0 rxcsum

or

ifconfig dlge0 txcsum

Clocking Master
===============
This parameter only applies to Copper adapters with a fixed speed of
1000baseTX. In this case, autonegotiation is disabled and each side of the
link must agree on who is clocking master and who is slave. By default,
the adapter is clocking slave ie. the other end is the master. If the
reverse is desired (this adapter should be clocking master), the
"flag0" media option must be set via ifconfig.

To set clocking master, type:

ifconfig dlge0 media 1000baseTX mediaopt flag0

To reset clocking master to the default of slave, type:

ifconfig dlge0 media 1000baseTX -mediaopt flag0

Virtual LANs
============
Virtual LAN (VLAN) functionality is supported by the dlge driver
in conjunction with FreeBSD's if_vlan driver. This can be verified by
checking the output of ifconfig, where the line listing the interface
options should include VLAN_MTU. This means that the driver (and thus
the hardware) can accept packets that are 4 bytes longer than the norm
(due to the added vlan tag). For further details, see the section 4
manpage for vlan.

To use vlans, one or more vlan interfaces must be created and bound
to the physical interface. In the example below, we assume a physical
interface of dlge0 and two vlan interfaces, vlan0 and vlan1,
with vlan IDs of 2 and 3 respectively.

Create two vlan interfaces:

ifconfig vlan0 create
ifconfig vlan1 create

Assign a vlan ID to each vlan device and attach a physical interface:

ifconfig vlan0 vlan 2 vlandev dlge0
ifconfig vlan1 vlan 3 vlandev dlge0

Use vlan interface as normal:

ifconfig vlan0 inet 192.168.100.1
ifconfig vlan1 inet 192.168.101.1

To remove the vlans and their interfaces:

ifconfig vlan0 destroy
ifconfig vlan1 destroy

Jumbo frames
============
For some applications throughput can be enhanced by the use of frames
larger than the default of 1500 bytes. These so-called jumbo frames are
set by the mtu (maximum transfer unit) switch of ifconfig.
To set the frame size to the maximum of 9000 bytes, type:

ifconfig dlge0 mtu 9000

To reset the adapter to use normal (1500 byte) frames, type:

ifconfig dlge0 mtu 1500

Note that any frame size between 1500 and 9000 is valid. Note also that
your switch must be capable of processing large frames and must be
appropriately configured to do so.
If you are using jumbo frames, do not forget to configure other hosts
on the same switch and network to use the same frame size. Failure to
do this will result in faulty network operation with large numbers of
frame errors.


			***End of Readme File***

