
              D-Link DL10050 based 10/100 Adapter Installation
                     For Linux

Contents
========
 - Compatibility List
 - Compiling the Driver
 - Installing the Driver
   - Red Hat v6.0
   - Red Hat v6.1
 - Configuration Script Sample
 - Troubleshooting


Compatiblity List
=================
Adapter Support:

D-Link DFE-550TX FAST Ethernet 10/100 Adapter.
D-Link DFE-580TX 4 port Server Adapter.
D-Link DL10050 based 10/100 Adapter.

The driver support Linux kernal 2.0.x and 2.2.x. We had tested it on the
environments below.

 . red hat v6.0 (kernal 2.2.5-15)
 . red hat v6.1 (kernal 2.2.12-20)


Compiling the Driver
====================
  In Linux, NIC drivers are most commonly configured as loadable modules.
The approach of building a monolithic kernel has become obsolete. The driver
can be compiled as part of a monolithic kernel, but is strongly discouraged.
The remainder of this section assumes the driver is built as a loadable module.
In the Linux environment, it is a good idea to rebuild the driver from the
source instead of relying on a precompiled version. This approach provides
better reliability since a precompiled driver might depend on libraries or
kernel features that are not present in a given Linux installation.

The 3 files necessary to build Linux device driver are DLH5X.C, DLH5X.H and
MAKEFILE. To compile, the Linux installation must include the gcc compiler,
the kernel source, and the kernel headers. The Linux driver supports Linux
Kernels 2.0.x and 2.2.x. Copy the files to a directory and enter the following
command to compile and link the driver:

; CD-ROM drive
[root@XXX /] mkdir cdrom
[root@XXX /] mount -t iso9660 -o conv=auto /dev/hdc /cdrom (if cdrom is on /dev/hdc)
[root@XXX /root] mkdir dlh5x
[root@XXX /root] cd dlh5x
[root@XXX /dlh5x] cp /cdrom/linux/dlh5x.c /root/dlh5x
[root@XXX /dlh5x] cp /cdrom/linux/dlh5x.h /root/dlh5x
[root@XXX /dlh5x] cp /cdrom/linux/makefile /root/dlh5x
[root@XXX /dlh5x] make all

; Floppy disc drive
[root@XXX /root] mkdir dlh5x
[root@XXX /root] cd dlh5x
[root@XXX /dlh5x] mcopy a:\linux\dlh5x.c      ; use mcopy command
[root@XXX /dlh5x] mcopy a:\linux\dlh5x.h      ; use mcopy command
[root@XXX /dlh5x] mcopy a:\linux\makefile     ; use mcopy command
[root@XXX /dlh5x] make all


Installing the Driver
=====================

  Manual Installation
  -------------------
  Once the driver has been compiled, it must be loaded, enabled, and bound
  to a protocol stack in order to establish network connectivity. To load a
  module enter the command:

  insmod dlh5x.o

  or

  insmod dlh5x.o <optional parameter>    ; add parameter

  Please reference the list of the command line parameters supported by
  the Linux device driver below.

  The insmod command only loads the driver and gives it a name of the form
  eth0, eth1, etc. To bring the NIC into an operational state,
  it is necessary to issue the following command:

  ifconfig eth1 up

  Finally, to bind the driver to the active protocol (e.g., TCP/IP with
  Linux), enter the following command:

  ifup eth1

  Note that this is meaningful only if the system can find a configuration
  script that contains the necessary network information. A sample will be
  given in the next paragraph.

  The commands to unload a driver are as follows:

  ifdown eth1
  ifconfig eth1 down
  rmmod dlh5x.o

  The following are the commands to list the currently loaded modules and
  to see the current network configuration.

  lsmod
  ifconfig


  Automated Installation
  ----------------------
  This section describes how to install the driver such that it is
  automatically loaded and configured at boot time. The following description
  is based on a Red Hat 6.0 distribution, but it can easily be ported to
  other distributions as well.

  Red Hat v6.0/6.1
  ----------------
  1. Copy dlh5x.o to the network modules directory, typically
     /lib/modules/2.2.x-xx/net.
  2. Locate the boot module configuration file, most commonly conf.modules
     in the /etc directory. Add the following lines:

     alias ethx dlh5x
     options dlh5x <optional parameters>

     where ethx will be eth0 if the NIC is the only ethernet adapter, eth1 if
     one other ethernet adapter is installed, etc. Refer to the table in the
     previous section for the list of optional parameters.
  3. Locate the network configuration scripts, normally the
     /etc/sysconfig/network-scripts directory, and create a configuration
     script named ifcfg-ethx that contains network information.
  4. Note that for most Linux distributions, Red Hat included, a configuration
     utility with a graphical user interface is provided to perform steps 2
     and 3 above.


Configuration Script Sample
===========================
Here is a sample of a simple configuration script:

DEVICE=eth1
USERCTL=no
ONBOOT=yes
POOTPROTO=none
BROADCAST=207.200.5.255
NETWORK=207.200.5.0
NETMASK=255.255.255.0
IPADDR=207.200.5.2


Troubleshooting
===============
. Couldn't compiler the driver ?
Ans: Copy all necessary files on same current directory. Make sure all files are Unix file format (no LF).
     You can use some convertible program conver it from DOS to UNIX. (Like dos2unix,  UltraEdit-32 ...).
      

