1. EN-9210V20.zip Driver
2. readme1.txt File Contents

readme1.txt Driver File Contents (EN-9210V20.zip)

1. INTRODUCTION
---------------

The DP83820 driver is developed for use on Linux v2.2.X and has 
been tested with 2.2.12 and 2.2.14 versions of the kernel.  
It can be configured either as a static driver into the kernel or 
as a loadable module. The driver is capable of 10/100/1000Mbps 
Full/Half duplex mode operation via an 10/100/1000Mbps external PHY. 
Detailed features are given below.



1. FILES IN THIS RELEASE
------------------------

The following files are included in the zip file, dpm.zip
  README.Linux   - This file
  dp.c           - Linux Network OS Specific Module File
  dp83820.h      - Driver header file
  dpm.o          - Driver object module for 2.2.14 kernel
  hsm.c          - Hardware Specific Module File
  hsm.h          - Hardware Specific Module Header File
  nsm.h          - HSM related data structures
  nsmtypes.h     - Definition type define
  sp.c           - Tunable Parameters
  Makefile       - Rules to compile and install the driver.
 

2. INSTALLATION
---------------

This version of the driver requires a base RedHat Linux ver 6.x with 
linux kernel version 2.2.12, basic utilities and the C development 
system.

To install the driver, login as root, and extract the files into an 
appropriate directory.

	# mkdir dp83820
	# cd dp83820
	# unzip dpm.zip

To create a new driver object module, run

	# make

To install the current driver object module in the filesystem run,

	# make install

To make the driver load when the system boots up, the following lines
needs to be put in any of the startup scripts like /etc/rc.d/rc.local 
or /etc/rc.d/init.d/network

        # /sbin/insmod /working/oct1/dpm.o 
        # /sbin/ifconfig <interface-name> <ip-addr> 

The driver can be dynamically loaded and unloaded from a running kernel 
with the following commands,

	# insmod dpm
	# rmmod dpm

To install and test the driver, shutdown the network stack, install
the driver, and re-start the startup the stack again.

	# sh /etc/rc.d/init.d/network stop
	# insmod dpm
	# sh /etc/rc.d/init.d/network start

The tunable parameters of the driver like the Receive and Transmit 
buffers are put in the file nsm.h under the heading "Tunable parameters".
The default value of RX_QUEUE_SZ is 100, on a high end system putting 
a value of 200 for RX_QUEUE_SZ can give better performance.

To try jumbo frames, the mtu size can be increased using the ifconfig 
utility, as follows 

        # ifconfig <interface-name> mtu <mtu-size>
        eg: ifconfig eth0 mtu 3000

The BUF_SIZE_MAX value in nsm.h (Tunable parameter) should be changed to
4096. 

<mtu-size> can be increased upto 4000 bytes for sane operation.


3. FUNCTIONALITY TESTING
------------------------

When the driver is loaded into the system via `insmod' it probes the
PCI bus to locate all DP83820 devices, and creates control structures
for each. The driver logs a couple of messages available in
`/var/log/messages' for each device with information about its PCI
geographic location, IRQ, IO address, and some basic debug information 
(addresses of some important structures).

All the devices on the PCI bus can be listed by,

	# cat /proc/pci

IRQ and IO address information from this can be correlated with the
information displayed by the driver in `/var/log/messages'

When the TCP/IP stack is initialized, it opens all configured ethernet 
devices, and initializes them for use. At this time, the driver will
perform autonegotiation and log information about the link status.
The driver can then be tested by running ping, telnet, ftp, NFS etc.


4. KNOWN DRIVER PROBLEMS
------------------------

o  When first initializing the driver, it may take about 20ish second 
   for driver to perform autonegotiation.  After that, the link will 
   become active. 


5. REVISION HISTORY 
--------------------
v1.10 : this is the first release of the driver


6. DOCUMENTATION REFERENCES
---------------------------

o National Semiconductor DP83820 10/100/1000 Mb/s PCI Ethernet
  Network Interface Controller, 2000.


7. BUG REPORTS
--------------

Please contact to our distributor