This archive contains a device driver for gigabit ethernet adapters
based on the National Semiconductor DP83820/DP83821 gigabit ethernet
controller chip and the DP83861 gigabit ethernet copper PHY.

Supported platforms:
-------------------

	FreeBSD 4.2-RELEASE i386
	FreeBSD 4.2-RELEASE alpha
	FreeBSD 4.3-RELEASE i386
	FreeBSD 4.3-RELEASE alpha

Note that this driver has been merged into the FreeBSD source tree
and will ship as a standard OS component starting with FreeBSD 4.4-RELEASE.

Included files:
--------------

ns83820_drv/README			This file

ns83820_drv/src/nge/Makefile		Source for DP83820 driver
ns83820_drv/src/nge/if_nge.c
ns83820_drv/src/nge/if_ngereg.h

ns83820_drv/src/nsgphy/Makefile		Source for DP83861 PHY driver
ns83820_drv/src/nsgphy/nsgphy.c

ns83820_drv/src/mii/miidevs		Misc header files
ns83820_drv/src/mii/miidevs.h
ns83820_drv/src/mii/miivar.h
ns83820_drv/src/mii/nsgphyreg.h

ns83820_drv/src/man4/nge.4		Manual page

ns83820_drv/modules/x86/if_nge.ko	Driver modules for x86 platform
ns83820_drv/modules/x86/nsgphy.ko

ns83820_drv/modules/alpha/nsgphy.ko	Driver modules for alpha platform
ns83820_drv/modules/alpha/if_nge.ko

Supported cards:
---------------

     o   SMC EZ Card 1000 (SMC9462TX)
     o   D-Link DGE-500T
     o   Asante FriendlyNet GigaNIX 1000TA and 1000TPC
     o   Addtron AEG320T
     o   LinkSys EG1032 (32-bit PCI) and EG1064 (64-bit PCI)
     o   Surecom Technology EP-320G-TX
     o   Netgear GA622T

Hardware documentation:
----------------------

	http://www.national.com/ds/DP/DP83820.pdf
	http://www.national.com/ds/DP/DP83821.pdf
	http://www.national.com/ds/DP/DP83861.pdf


Usage instructions:
------------------

To load the driver into a running system, do the following:

- cd modules/<platform>		where <platform> is x86 or alpha
- kldload ./nsgphy.ko		load the 83861 PHY driver
- kldload ./if_nge.ko		load the 83820 MAC driver

You should see something like the following displayed on the console:

nge0: <National Semiconductor Gigabit Ethernet> port 0x10100-0x101ff mem 0x8204c000-0x8204cfff irq 10 at device 7.0 on pci0
nge0: Ethernet address: 00:04:e2:0e:d3:f0
miibus0: <MII bus> on nge0
nsgphy0: <DP83861 10/100/1000 media interface> on miibus0
nsgphy0:  1000baseTX-FDX, 1000baseTX, 100baseTX-FDX, 100baseTX, 10baseT-FDX, 10baseT, auto

To have the driver loaded automatically when the system is booted:

- cd modules/<platform>		where <platform> is x86 or alpha
- cp *.ko /modules		copy modules to the /modules directory
- edit /boot/loader.conf and add the following lines:

	nsgphy_load="YES"
	if_nge_load="YES"

- edit /etc/rc.conf and create the appropriate ifconfig_nge0 entry.
