sk98lin.txt

《嵌入式系统设计与实例开发实验教材二源码》Linux内核移植与编译实验

(C)Copyright 1999-2001 SysKonnect GmbH.
All rights reserved
===========================================================================

sk98lin.txt created 28-May-2001

Readme File for sk98lin v4.06
SK-NET Gigabit Ethernet PCI driver for LINUX

This file contains
(1) OVERVIEW
(2) REQUIRED FILES
(3) INSTALLATION
(4) INCLUSION OF ADAPTER AT SYSTEM START
(5) DRIVER PARAMETERS
(6) LARGE FRAME SUPPORT
(7) TROUBLESHOOTING
(8) HISTORY

===========================================================================


(1) OVERVIEW
============

The sk98lin driver supports the SysKonnect SK-NET Gigabit Ethernet
Adapter SK-98xx family on Linux 2.2.x and above.
It has been tested with Linux on Intel/x86 machines.
From v3.02 on, the driver is integrated in the linux kernel source.
***


(2) REQUIRED FILES
==================

The linux kernel source.
No additional files required.
***


(3) INSTALLATION
================

The following steps describe the actions that are required to install
the driver and to start it manually. These steps should be carried
out for the initial driver setup. Once confirmed to be ok, they can
be included in the system start which is described in the next
chapter.

NOTE 1: You must have 'root' access to the system to perform
        the following tasks.
NOTE 2:	IMPORTANT: In case of problems, please read the section
	"Troubleshooting" below.

1) The driver can either be integrated into the kernel or it can
   be compiled as a module.
   Select the appropriate option during the kernel configuration.
   For use as a module, your kernel must have
   'loadable module support' enabled.
   For automatic driver start, you also need 'Kernel module loader'
   enabled.
   Configure those options, build and install the new kernel. If you
   choose to use the driver as a module, do "make modules" and
   "make modules_install".
   Reboot your system.

2) Load the module manually by entering:
       modprobe sk98lin
   If the SysKonnect SK-98xx adapter is installed in your
   computer and you have a /proc filesystem, running the command
   'more /proc/net/dev' should produce an output containing a
   line with the following format:
       eth0:    0    0 ...
   which means that your adapter has been found and initialized.
   
   NOTE 1: If you have more than one SysKonnect SK-98xx adapter, the
           adapters will be listed as 'eth0', 'eth1', 'eth2', etc.
           For each adapter, repeat the steps 3) and 4).
   NOTE 2: If you have other Ethernet adapters installed,
           your SysKonnect SK-98xx adapter can be mapped to 'eth1' or
	   'eth2' ...
	   The module installation message (in system logfile or
	   on console, depending on /etc/syslog.conf) prints a line
	   for each adapter that is found, containing the
	   corresponding 'ethX'.

3) Select an IP address and assign it to the respective adapter by
   entering:
       ifconfig eth0 <ip-address>
   This causes the adapter to connect to the ethernet. The solitary
   yellow LED at the adapter is now active, the link status LED of
   the primary port is on and the link status LED of the secondary
   port (on dual port adapters) is blinking (only if the laters are
   connected to a switch or hub).
   You will also get a status message on the console saying
   "ethX: network connection up using port Y" and indicating
   the selected connection parameters.
   
   NOTE: If you are in doubt about IP addresses, ask your network
         administrator for assistance.

4) Your adapter should now be fully operational.
   Use 'ping <otherstation>' to verify the connection to other
   computers on your network.
   By viewing /proc/net/sk98lin/[devicename], you can check some 
   information regarding to the adapter configuration.


5) The driver module can be stopped and unloaded using the following
   commands:
       ifconfig eth0 down
       rmmod sk98lin
***


(4) INCLUSION OF ADAPTER AT SYSTEM START
========================================

Since a large number of different Linux distributions are 
available, we are unable to describe a general installation procedure
for the driver module.
Because the driver is now integrated in the kernel, installation should
be easy, using the standard mechanism of your distribution.
Refer to the distribution's manual for installation of ethernet adapters.
***


(5) DRIVER PARAMETERS
=====================

Parameters can be set at the command line while loading the
module with 'modprobe'. The configuration tools of some distributions
can also give parameters to the driver module.
If you use the kernel module loader, you can set driver parameters
in the file /etc/modules.conf (or old name: /etc/conf.modules).
Insert a line of the form:

options sk98lin ...

For "...", use the same syntax as described below for the command
line paramaters of modprobe.
You either have to reboot your computer or unload and reload
the driver to activate the new parameters.
The syntax of the driver parameters is:

modprobe sk98lin parameter=value1[,value2[,value3...]]

value1 is for the first adapter, value2 for the second one etc.
All Parameters are case sensitive, so write them exactly as
shown below.

Sample: Suppose you have two adapters. You want to set AutoNegotiation
	on Port A of the first adapter to ON and on Port A of the
	second adapter to OFF.
	You also want to set DuplexCapabilities on Port A of the first
	adapter to FULL and on Port A of the second adapter to HALF.
	You must enter:

	modprobe sk98lin AutoNeg_A=On,Off DupCap_A=Full,Half

NOTE: The number of adapters that can be configured this way is
      limited in the driver (file skge.c, constant SK_MAX_CARD_PARAM).
      The current limit is 16. If you happen to install
      more adapters, adjust this and recompile.


5.1 Per-Port Parameters
-----------------------
Those setting are available for each port on the adapter.
In the following description, '?' stands for the port for
which you set the parameter (A or B).

- Auto Negotiation
  Parameter:	AutoNeg_?
  Values:	On, Off, Sense
  Default:	Sense
  
  The "Sense"-mode finds out automatically whether the link
  partner supports autonegotiation or not.

- Duplex Capabilities
  Parameter:	DupCap_?
  Values:	Half, Full, Both
  Default:	Both

  This parameters is relevant only if autonegotiation for
  this port is not "Sense". If autonegotiation is "On", all
  three values are possible. If it is "Off", only "Full" and
  "Half" are allowed.
  It is usefull if your link partner does not support all
  possible combinations.

- Flow Control
  Parameter:	FlowCtrl_?
  Values:	Sym, SymOrRem, LocSend, None
  Default:	SymOrRem

  This parameter can be used to set the flow control capabilities
  that the port reports during autonegotiation.
  The meaning of the different modes is:
-- Sym = Symetric: both link partners are allowed to send PAUSE frames
-- SymOrRem = SymetricOrRemote: both or only remote partner are allowed
   to send PAUSE frames
-- LocSend = LocalSend: only local link partner is allowed to send
   PAUSE frames
-- None: no link partner is allowed to send PAUSE frames
  
  NOTE: This parameter is ignored if autonegotiation is set to "Off".

- Role in Master-Slave-Negotiation (1000Base-T only).
  Parameter:    Role_?
  Values:       Auto, Master, Slave
  Default:      Auto
  
  This parameter is only valid for the SK-9821 and SK-9822 adapters.
  For two 1000Base-T ports to communicate, one must take the role as
  master (providing timing information), while the other must be slave.
  Normally, this is negotiated between the two ports during link 
  establishment. If this should ever fail, you can force a port to a
  specific setting with this parameter.
  

5.2 Per-Adapter Parameters
--------------------------

- Preferred Port
  Parameter:	PrefPort
  Values:	A, B
  Default:	A

  This is used to force the preferred port to A or B (on two-port NICs).
  The preferred port is the one that is used if both are detected as
  fully functional.

- RLMT (Redundant Link Management Technology) Mode
  Parameter:	RlmtMode
  Values:	CheckLinkState,CheckLocalPort, CheckSeg, DualNet
  Default:	CheckLinkState

  RLMT (the driver part that decides which port to use) knows three
  ways of checking if a port is available for use:

-- CheckLinkState = Check link state only: RLMT uses the link state
   reported by the adapter hardware for each individual port to determine
   whether a port can be used for all network traffic or not.

-- CheckLocalPort - Check other port on adapter: RLMT sends test frames
   from each port to each other port and checks if they are received by
   the other port, respectively. Thus, the ports must be connected to the
   network such that LLC test frames can be exchanged between them
   (i.e. there must be no routers between the ports).

-- CheckSeg - Check other port and segmentation: RLMT checks the other port
   and in addition requests information from the Gigabit Ethernet
   switch next to each port to see if the network is segmented between
   the ports. Thus, this mode is only to be used if you have Gigabit
   Ethernet switches installed in your network that have been configured
   to use the Spanning Tree protocol.

-- DualNet - Both ports A and B are used as separate devices at the same
   time. So if you have a dual port adapter, port A will show up as eth0