1. usr-7904.zip Driver
2. sk98lin.install.txt File Contents

sk98lin.install.txt Driver File Contents (usr-7904.zip)

Copyright © 2005 U.S. Robotics Corporation. All rights reserved.
===========================================================================

sk98lin.install.txt

Driver Installation Instructions for sk98lin, Linux driver for the U.S. Robotics
10/100/1000 Mbps 64-bit PCI NIC 


This file contains
 1  Overview
 2  Required Files
 3  Installation notes
 4  Driver Installation
 5  Manual module loading
 6  Unloading the module
 7  Driver Parameters
 8  Troubleshooting

For additional information, including driver parameters, see sk98lin.desc.txt.
================================================================================


1  Overview
===========

The Driver installation script, install.sh, supports the USR997904 on 
Linux 2.4.13 and above. It has been tested with Linux on Intel/x86 machines.
***


2  Required Files
=================

The linux kernel source available in directory (/usr/src/linux)
Compiler tools (such as gcc or make.)
***


3  Installation notes
=====================

The installation script will automatically compile and load the sk98lin driver 
on your host system. Before performing both compilation and loading, it is 
necessary to shut down any device using the sk98lin kernel module and to unload 
the old sk98lin kernel module. The installation script will do this 
automatically by default. If you want to shut down and unload the old sk98lin 
kernel module manually, run the script in the EXPERT mode.

Please plug a card into your machine. Without a card we aren't able to check
the full driver functionality.

Be sure to use the same kernel source and kernel version. For instance, 
it might be that you run kernel version 2.4.20, but the header files the 
kernel module will be compiled with refer to kernel version 2.4.21. If you 
don't have the same kernel version, please install the sources and compile
a new kernel. It's not possible to mix different kernel versions!
***


4  Driver Installation
======================

To install the newest linux driver, proceed as follows:

    1.  Login as 'root'.
    2.  Make the driver executable with the following command:
	
	chmod 755 install.sh    

    3.  Copy the driver source files to a convenient directory
	    and start the build process with the following commands:

        # mv sk98lin.tar sk98lin.tar.bz2        
    	# ./install.sh

    4.  Choose your favorite installation method.
    5.  The driver will be compiled and installed.
***


5  Manual module loading
========================

To load the module manually, proceed as follows:

    1. Enter "modprobe sk98lin".
    2. If any USR997904 based adapter is installed in your computer 
	and you have a /proc file system, execute the command:
    	# ls /proc/net/sk98lin/ 
    This should produce an output containing a line with the following 
    format:
    eth0   eth1  ...
    which indicates that your adapter has been found and initialized.
   
    NOTE: For further information take a look in the sk98lin.txt file
***


6  Unloading the module
=======================

To stop and unload the driver modules, proceed as follows:

    1. Execute the command "ifconfig YOUR_DEVICE down".
        # ifconfig eth0 down
        # ifconfig eth1 down
    2. Execute the command "rmmod sk98lin".
***


7  Driver Parameters
====================

When loading the driver as a kernel module, additional parameters
can be passed to the driver for configuration.

Those parameters can be passed in two ways:

 a) You can either state them on the modprobe command line
 b) You can set them in the file /etc/modules.conf (or old name: 
    /etc/conf.modules), in order to force the kernel module loader
    to pass them to the driver at load-time.

   NOTE: For further information about the parameters and their
         possible values take a look in the sk98lin.desc.txt file

8  Troubleshooting
==================

If any problems occur during the installation process, check the 
following list:


Problem:  The USR997904 can not be found by the driver.
Solution: In /proc/pci search for the following entry:
             'Ethernet controller: PCI device 16ec:4320 (U.S. Robotics) ...'
          If this entry exists, the USR997904 has 
          been found by the system and should be operational.
          If this entry does not exist or if the file '/proc/pci' is not 
          found, there may be a hardware problem or the PCI support may 
          not be enabled in your kernel.
          
          Some COMPAQ machines have problems dealing with PCI under Linux.
          Linux. This problem is described in the 'PCI howto' document
          (included in some distributions or available from the
          web, e.g. at 'www.linux.org'). 


Problem:  Programs such as 'ifconfig' or 'route' can not be found or the 
          error message 'Operation not permitted' is displayed.
Reason:   You are not logged in as user 'root'.
Solution: Logout and login as 'root' or change to 'root' via 'su'.


Problem:  Upon use of the command 'ping <address>' the message
          "ping: sendto: Network is unreachable" is displayed.
Reason:   Your route is not set correctly.
Solution: If you are using RedHat, you probably forgot to set up the 
          route in the 'network configuration'.
          Check the existing routes with the 'route' command and check 
          if an entry for 'eth0' exists, and if so, if it is set correctly.


Problem:  The driver can be started, the adapter is connected to the 
          network, but you cannot receive or transmit any packets; 
          e.g. 'ping' does not work.
Reason:   There is an incorrect route in your routing table.
Solution: Check the routing table with the command 'route' and read the 
          manual help pages dealing with routes (enter 'man route').

NOTE: Although the 2.2.x kernel versions generate the routing entry 
      automatically, problems of this kind may occur here as well. We've 
      come across a situation in which the driver started correctly at 
      system start, but after the driver has been removed and reloaded,
      the route of the adapter's network pointed to the 'dummy0'device 
      and had to be corrected manually.


Problem:  Your computer should act as a router between multiple 
          IP subnetworks (using multiple adapters), but computers in 
          other subnetworks cannot be reached.
Reason:   Either the router's kernel is not configured for IP forwarding 
          or the routing table and gateway configuration of at least one 
          computer is not working.

Problem:  Upon driver start, the following error message is displayed:
          "eth0: -- ERROR --
          Class: internal Software error
          Nr:    0xcc
          Msg:   SkGeInitPort() cannot init running ports"
Reason:   You are using a driver compiled for single processor machines 
          on a multiprocessor machine with SMP (Symmetric MultiProcessor) 
          kernel.
Solution: Configure your kernel appropriately and recompile the kernel or
          the modules.



If your problem is not listed here, please visit the U.S. Robotics Customer
support site for help (www.usr.com/support).
When contacting our technical support, please ensure that the following 
information is available:
- System Manufacturer and HW Information (CPU, Memory... )
- PCI-Boards in your system
- Distribution
- Kernel version
- Driver version
- U.S. Robotics product number (7904) and serial number, located on the box.


***End of sk98lin.install.txt***