
IC Plus - TAMARACK TC902X 10/100/1000 ETHERNET ADAPTER
                   Linux Driver
                                                     

*******************************************************************************
**      Compiling and Installing the driver                                  **
*******************************************************************************

To compile and install the driver, follow the procedures:

1) Login as some common user or the root.

2) Unzip and untar driver (do not do it under Windows!)

In any directory, unzip and untar the driver, for example:

    #chdir /root
    #mkdir tc902x
    #cd tc902x
    #mount /mnt/floppy
    #cp /mnt/floppy/tc902x.v037.tar.gz .
    #tar -zvxf tc902x.v037.tar.gz    

The above commands end up with the following files in the /root/tc902x
directory:

Makefile
tc902x.c
tc902x.h
tc902x_constants.h
tc902x_macros.h
tc902x_structs.h
tc902x_tune.h

3) "make" the driver

In the directory where you unzipped and untarred the driver, type "make" at
the prompt, as:

    make,

or
    make clean; make

Hopefully, the make utility will be in your path and will run. Also hopefully
gcc, ld, and any other utilities needed will be in your path.

If and when the make completes, there should be an tc902x.o file in the same
directory.

4) Install the driver
Once you have the driver compiled, you have to switch yourself to user "root".
At the same directory and command prompt, type:

    insmod tc902x.o

This should install the driver module into the kernel. Dependent on what other
ethernet NICs are installed, the TC902x NIC will be assigned the desigation
eth0, eth1, eth2, etc. Using this designation, you can open the interface using
the "ifconfig" command (man ifconfig), then you are on the way. For example,

    ifconfig eth1 172.16.10.20


*******************************************************************************
**      Special Notice                                                       **
*******************************************************************************
The default include files of the linux gcc compiler is typically under the
/usr/include directory. However, since the driver is not a application but a
kernel module, it is better to have the kernel source installed on your
system to compile the driver, which is typically /usr/src/linux, where the
Makefile directs the include path. This is especially true under Red Hat 7.0,
becuase its kernel is version 2.2.16, while the /usr/include is incorrectly
version 2.4.2. Therefore, if you are using Red Hat 7.0, you have to make sure
the /usr/src/linux exists with kernel source codes installed there.

