1. GE1164SC_XP.zip Driver
2. LINUX.TXT File Contents

LINUX.TXT Driver File Contents (GE1164SC_XP.zip)

Introduction
============

This document presents information to users about National Semiconductor's
DP83820 Gigabit Ethernet adapter and the relevant LINUX software driver 
version 1.02 for LINUX operating system kernel version 2.2.x-4.x.

Installation and Configuration
==============================

The following subsections describe the procedure for installing the 
driver for LINUX.

LINUX Driver Installation
-------------------------

Follow this sequence for installation under LINUX.

 1.To install the driver, login as root, insert the floppy disk with
   the driver, and mount the disk into the system with the following
   command.

         # mount -t msdos /dev/fd0 /mnt

 2.Copy the files from floppy into an appropriate directory.

         # mkdir dp83820
         # cd dp83820
         # cp /mnt/linux/22-24/* . (*)
         
        (*)The directory "22-24" stands for the Linux kernel version
           you use.
           Do "ls -al /lib/modules" to find out the exact version number 
           of linux kernel.

 3.To create a new driver object module and install the current
   driver object module in the file system run

         # make
         # cp dpm.o /lib/modules/2.2.12-4.x/net (*)
         
        (*)The directory "2.2.12-4.x" stands for the Linux kernel version
           you use.
           Do "ls -al /lib/modules" to find out the exact version number 
           of linux kernel.

 4.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 /lib/modules/2.2.12-4.x/net/dpm.o (*)
         # /sbin/ifconfig <interface-name> <ip-addr>
         
        (*)The directory "2.2.12-4.x" stands for the Linux kernel version
           you use.
           Do "ls -al /lib/modules" to find out the exact version number 
           of linux kernel.

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

         # insmod dpm.o
         # rmmod dpm.o

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.o
         # 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.


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.