This document covers the driver settings for the dmfe driver for the
Davicom DM9102A Ethernet chipset used in the Netra[TM] X1 and Sun Fire[TM] V100.


1.0 Driver Software
-------------------

Package information for Solaris[TM] 8 driver (from the pkginfo output):
system      SUNWdmfex      Sun Davicom 10/100Mb Ethernet Drivers (64-bit)

Files in package:
/platform/SUNW,UltraAX-i2/kernel/drv/dmfe.conf
/platform/SUNW,UltraAX-i2/kernel/drv/sparcv9/dmfe

There are no 32 bit drivers because the Netra X1 and Sun Fire V100 only run
in 64 bit Kernel mode. This driver is part of the Solaris 8 2/02 hardware
release, or can be installed on older releases of Solaris 8 by following the
procedure in Infodoc 26310.

The man page for the dmfe interface for Solaris 8 is provided with revision
38 or later of patch 108808.

2.0 Checking and setting driver parameters using the ndd command
----------------------------------------------------------------

In the following examples /dev/dmfe0 is used for interface dmfe0. To use
ndd with the dmfe1 interface, specify /dev/dmfe1 when using the ndd
command.

NOTE: Unlike other Sun Ethernet interfaces, the instance number is
specified at the command line by specifying /dev/dmfe0 or /dev/dmfe1 
instead of using ndd to set the instance value for the driver.

To check the speed and mode the interface is operating in, run the
following commands as root:

ndd -get /dev/dmfe0 link_status
( 0 = link down, 1 = link up )
ndd -get /dev/dmfe0 link_speed
( 100 = 100 megabit, 10 = 10 megabit, 0 = link down )
ndd -get /dev/dmfe0 link_mode
( 0 = half duplex, 1 = full duplex )

By default, the dmfe interfaces will attempt to auto negotiate speed and 
mode. The ndd command can be used to force the interfaces to a specific 
speed and mode instead of using auto negotiation. To force the dmfe0 
interface to run at 100 megabit full duplex and disable auto negotiation., 
run the following commands as root:

ndd -set /dev/dmfe0 adv_100fdx_cap 1    (enable 100 megabit full duplex)
ndd -set /dev/dmfe0 adv_100hdx_cap 0    (disable 100 megabit half duplex)
ndd -set /dev/dmfe0 adv_10fdx_cap 0     (disable 10 megabit full duplex)
ndd -set /dev/dmfe0 adv_10hdx_cap 0     (disable 10 megabit half duplex)
ndd -set /dev/dmfe0 adv_autoneg_cap 0   (turn auto negotiation. off)

Changes made by the ndd command are not preserved when the system reboots.
For permanent entries you can create a script in the /etc/rc2.d directory
to set the interface on boot. If that is the case, then just use ndd
commands as specified above.

It is usually recommended that the script be called S95net-tune to 
indicate that this particular script is specific to tuning network 
parameters on that specific host.

3.0 Forcing speed and mode using the dmfe.conf file
---------------------------------------------------

Forcing speed and mode of the interfaces can also be done using the
/platform/SUNW,UltraAX-i2/kernel/drv/dmfe.conf file. For example, the
following entries in dmfe.conf would force the dmfe interfaces to run at
100 megabit full duplex mode:

speed=100;
full-duplex=1;

4.0 Forcing speed and mode using the /etc/system file
-----------------------------------------------------

It is not possible to set auto negotiation. or force speed and mode for the
dmfe driver using the /etc/system file.

5.0 Patches
-----------

5.1 Hardware patches
--------------------

111952  Hardware/PROM: Netra X1 PROM upgrade patch

5.2 Patches for Solaris 8
-------------------------

108808  Manual Page updates for Solaris 8
109202  /kernel/misc/gld and /kernel/misc/sparcv9/gld patch
110693  Netra X1 dmfe Ethernet driver, Link light
112168  patch dmfe and mii header file

6.0 Related documentation
-------------------------

806-6137        Netra X1 Server Product Notes

7.0 References
--------------

7.1 Web References
------------------

http://www.sun.com/servers/entry/X1/
http://www.sun.com/servers/entry/v100/

7.2 Sunsolve Infodocs and SRDBs
-------------------------------

Infodoc 18474   Flash PROM patches / Minimum OE revisions for Sun systems
Infodoc 26310   Reinstalling Solaris 8 on the Netra X1

Keywords: dmfe, driver, davicom, ethernet, netra, Sun Fire, DM9102A            

               
Author information: 


    Martin Winkelman
        
    mw@sun.com 
    

Document history: 

5-15-2001 - First draft 

6-4-2002 - Updated Solaris 8 information and added Sun Fire V100
comments.