xref: /OK3568_Linux_fs/kernel/Documentation/networking/device_drivers/fddi/skfp.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun.. include:: <isonum.txt>
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun========================
6*4882a593SmuzhiyunSysKonnect driver - SKFP
7*4882a593Smuzhiyun========================
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun|copy| Copyright 1998-2000 SysKonnect,
10*4882a593Smuzhiyun
11*4882a593Smuzhiyunskfp.txt created 11-May-2000
12*4882a593Smuzhiyun
13*4882a593SmuzhiyunReadme File for skfp.o v2.06
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun
16*4882a593Smuzhiyun.. This file contains
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun   (1) OVERVIEW
19*4882a593Smuzhiyun   (2) SUPPORTED ADAPTERS
20*4882a593Smuzhiyun   (3) GENERAL INFORMATION
21*4882a593Smuzhiyun   (4) INSTALLATION
22*4882a593Smuzhiyun   (5) INCLUSION OF THE ADAPTER IN SYSTEM START
23*4882a593Smuzhiyun   (6) TROUBLESHOOTING
24*4882a593Smuzhiyun   (7) FUNCTION OF THE ADAPTER LEDS
25*4882a593Smuzhiyun   (8) HISTORY
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun1. Overview
29*4882a593Smuzhiyun===========
30*4882a593Smuzhiyun
31*4882a593SmuzhiyunThis README explains how to use the driver 'skfp' for Linux with your
32*4882a593Smuzhiyunnetwork adapter.
33*4882a593Smuzhiyun
34*4882a593SmuzhiyunChapter 2: Contains a list of all network adapters that are supported by
35*4882a593Smuzhiyunthis driver.
36*4882a593Smuzhiyun
37*4882a593SmuzhiyunChapter 3:
38*4882a593Smuzhiyun	   Gives some general information.
39*4882a593Smuzhiyun
40*4882a593SmuzhiyunChapter 4: Describes common problems and solutions.
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunChapter 5: Shows the changed functionality of the adapter LEDs.
43*4882a593Smuzhiyun
44*4882a593SmuzhiyunChapter 6: History of development.
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun2. Supported adapters
48*4882a593Smuzhiyun=====================
49*4882a593Smuzhiyun
50*4882a593SmuzhiyunThe network driver 'skfp' supports the following network adapters:
51*4882a593SmuzhiyunSysKonnect adapters:
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun  - SK-5521 (SK-NET FDDI-UP)
54*4882a593Smuzhiyun  - SK-5522 (SK-NET FDDI-UP DAS)
55*4882a593Smuzhiyun  - SK-5541 (SK-NET FDDI-FP)
56*4882a593Smuzhiyun  - SK-5543 (SK-NET FDDI-LP)
57*4882a593Smuzhiyun  - SK-5544 (SK-NET FDDI-LP DAS)
58*4882a593Smuzhiyun  - SK-5821 (SK-NET FDDI-UP64)
59*4882a593Smuzhiyun  - SK-5822 (SK-NET FDDI-UP64 DAS)
60*4882a593Smuzhiyun  - SK-5841 (SK-NET FDDI-FP64)
61*4882a593Smuzhiyun  - SK-5843 (SK-NET FDDI-LP64)
62*4882a593Smuzhiyun  - SK-5844 (SK-NET FDDI-LP64 DAS)
63*4882a593Smuzhiyun
64*4882a593SmuzhiyunCompaq adapters (not tested):
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun  - Netelligent 100 FDDI DAS Fibre SC
67*4882a593Smuzhiyun  - Netelligent 100 FDDI SAS Fibre SC
68*4882a593Smuzhiyun  - Netelligent 100 FDDI DAS UTP
69*4882a593Smuzhiyun  - Netelligent 100 FDDI SAS UTP
70*4882a593Smuzhiyun  - Netelligent 100 FDDI SAS Fibre MIC
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun
73*4882a593Smuzhiyun3. General Information
74*4882a593Smuzhiyun======================
75*4882a593Smuzhiyun
76*4882a593SmuzhiyunFrom v2.01 on, the driver is integrated in the linux kernel sources.
77*4882a593SmuzhiyunTherefore, the installation is the same as for any other adapter
78*4882a593Smuzhiyunsupported by the kernel.
79*4882a593Smuzhiyun
80*4882a593SmuzhiyunRefer to the manual of your distribution about the installation
81*4882a593Smuzhiyunof network adapters.
82*4882a593Smuzhiyun
83*4882a593SmuzhiyunMakes my life much easier :-)
84*4882a593Smuzhiyun
85*4882a593Smuzhiyun4. Troubleshooting
86*4882a593Smuzhiyun==================
87*4882a593Smuzhiyun
88*4882a593SmuzhiyunIf you run into problems during installation, check those items:
89*4882a593Smuzhiyun
90*4882a593SmuzhiyunProblem:
91*4882a593Smuzhiyun	  The FDDI adapter cannot be found by the driver.
92*4882a593Smuzhiyun
93*4882a593SmuzhiyunReason:
94*4882a593Smuzhiyun	  Look in /proc/pci for the following entry:
95*4882a593Smuzhiyun
96*4882a593Smuzhiyun	     'FDDI network controller: SysKonnect SK-FDDI-PCI ...'
97*4882a593Smuzhiyun
98*4882a593Smuzhiyun	  If this entry exists, then the FDDI adapter has been
99*4882a593Smuzhiyun	  found by the system and should be able to be used.
100*4882a593Smuzhiyun
101*4882a593Smuzhiyun	  If this entry does not exist or if the file '/proc/pci'
102*4882a593Smuzhiyun	  is not there, then you may have a hardware problem or PCI
103*4882a593Smuzhiyun	  support may not be enabled in your kernel.
104*4882a593Smuzhiyun
105*4882a593Smuzhiyun	  The adapter can be checked using the diagnostic program
106*4882a593Smuzhiyun	  which is available from the SysKonnect web site:
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun	      www.syskonnect.de
109*4882a593Smuzhiyun
110*4882a593Smuzhiyun	  Some COMPAQ machines have a problem with PCI under
111*4882a593Smuzhiyun	  Linux. This is described in the 'PCI howto' document
112*4882a593Smuzhiyun	  (included in some distributions or available from the
113*4882a593Smuzhiyun	  www, e.g. at 'www.linux.org') and no workaround is available.
114*4882a593Smuzhiyun
115*4882a593SmuzhiyunProblem:
116*4882a593Smuzhiyun	  You want to use your computer as a router between
117*4882a593Smuzhiyun	  multiple IP subnetworks (using multiple adapters), but
118*4882a593Smuzhiyun	  you cannot reach computers in other subnetworks.
119*4882a593Smuzhiyun
120*4882a593SmuzhiyunReason:
121*4882a593Smuzhiyun	  Either the router's kernel is not configured for IP
122*4882a593Smuzhiyun	  forwarding or there is a problem with the routing table
123*4882a593Smuzhiyun	  and gateway configuration in at least one of the
124*4882a593Smuzhiyun	  computers.
125*4882a593Smuzhiyun
126*4882a593SmuzhiyunIf your problem is not listed here, please contact our
127*4882a593Smuzhiyuntechnical support for help.
128*4882a593Smuzhiyun
129*4882a593SmuzhiyunYou can send email to: linux@syskonnect.de
130*4882a593Smuzhiyun
131*4882a593SmuzhiyunWhen contacting our technical support,
132*4882a593Smuzhiyunplease ensure that the following information is available:
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun- System Manufacturer and Model
135*4882a593Smuzhiyun- Boards in your system
136*4882a593Smuzhiyun- Distribution
137*4882a593Smuzhiyun- Kernel version
138*4882a593Smuzhiyun
139*4882a593Smuzhiyun
140*4882a593Smuzhiyun5. Function of the Adapter LEDs
141*4882a593Smuzhiyun===============================
142*4882a593Smuzhiyun
143*4882a593Smuzhiyun	The functionality of the LED's on the FDDI network adapters was
144*4882a593Smuzhiyun	changed in SMT version v2.82. With this new SMT version, the yellow
145*4882a593Smuzhiyun	LED works as a ring operational indicator. An active yellow LED
146*4882a593Smuzhiyun	indicates that the ring is down. The green LED on the adapter now
147*4882a593Smuzhiyun	works as a link indicator where an active GREEN LED indicates that
148*4882a593Smuzhiyun	the respective port has a physical connection.
149*4882a593Smuzhiyun
150*4882a593Smuzhiyun	With versions of SMT prior to v2.82 a ring up was indicated if the
151*4882a593Smuzhiyun	yellow LED was off while the green LED(s) showed the connection
152*4882a593Smuzhiyun	status of the adapter. During a ring down the green LED was off and
153*4882a593Smuzhiyun	the yellow LED was on.
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun	All implementations indicate that a driver is not loaded if
156*4882a593Smuzhiyun	all LEDs are off.
157*4882a593Smuzhiyun
158*4882a593Smuzhiyun
159*4882a593Smuzhiyun6. History
160*4882a593Smuzhiyun==========
161*4882a593Smuzhiyun
162*4882a593Smuzhiyunv2.06 (20000511) (In-Kernel version)
163*4882a593Smuzhiyun    New features:
164*4882a593Smuzhiyun
165*4882a593Smuzhiyun	- 64 bit support
166*4882a593Smuzhiyun	- new pci dma interface
167*4882a593Smuzhiyun	- in kernel 2.3.99
168*4882a593Smuzhiyun
169*4882a593Smuzhiyunv2.05 (20000217) (In-Kernel version)
170*4882a593Smuzhiyun    New features:
171*4882a593Smuzhiyun
172*4882a593Smuzhiyun	- Changes for 2.3.45 kernel
173*4882a593Smuzhiyun
174*4882a593Smuzhiyunv2.04 (20000207) (Standalone version)
175*4882a593Smuzhiyun    New features:
176*4882a593Smuzhiyun
177*4882a593Smuzhiyun	- Added rx/tx byte counter
178*4882a593Smuzhiyun
179*4882a593Smuzhiyunv2.03 (20000111) (Standalone version)
180*4882a593Smuzhiyun    Problems fixed:
181*4882a593Smuzhiyun
182*4882a593Smuzhiyun	- Fixed printk statements from v2.02
183*4882a593Smuzhiyun
184*4882a593Smuzhiyunv2.02 (991215) (Standalone version)
185*4882a593Smuzhiyun    Problems fixed:
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun	- Removed unnecessary output
188*4882a593Smuzhiyun	- Fixed path for "printver.sh" in makefile
189*4882a593Smuzhiyun
190*4882a593Smuzhiyunv2.01 (991122) (In-Kernel version)
191*4882a593Smuzhiyun    New features:
192*4882a593Smuzhiyun
193*4882a593Smuzhiyun	- Integration in Linux kernel sources
194*4882a593Smuzhiyun	- Support for memory mapped I/O.
195*4882a593Smuzhiyun
196*4882a593Smuzhiyunv2.00 (991112)
197*4882a593Smuzhiyun    New features:
198*4882a593Smuzhiyun
199*4882a593Smuzhiyun	- Full source released under GPL
200*4882a593Smuzhiyun
201*4882a593Smuzhiyunv1.05 (991023)
202*4882a593Smuzhiyun    Problems fixed:
203*4882a593Smuzhiyun
204*4882a593Smuzhiyun	- Compilation with kernel version 2.2.13 failed
205*4882a593Smuzhiyun
206*4882a593Smuzhiyunv1.04 (990427)
207*4882a593Smuzhiyun    Changes:
208*4882a593Smuzhiyun
209*4882a593Smuzhiyun	- New SMT module included, changing LED functionality
210*4882a593Smuzhiyun
211*4882a593Smuzhiyun    Problems fixed:
212*4882a593Smuzhiyun
213*4882a593Smuzhiyun	- Synchronization on SMP machines was buggy
214*4882a593Smuzhiyun
215*4882a593Smuzhiyunv1.03 (990325)
216*4882a593Smuzhiyun    Problems fixed:
217*4882a593Smuzhiyun
218*4882a593Smuzhiyun	- Interrupt routing on SMP machines could be incorrect
219*4882a593Smuzhiyun
220*4882a593Smuzhiyunv1.02 (990310)
221*4882a593Smuzhiyun    New features:
222*4882a593Smuzhiyun
223*4882a593Smuzhiyun	- Support for kernel versions 2.2.x added
224*4882a593Smuzhiyun	- Kernel patch instead of private duplicate of kernel functions
225*4882a593Smuzhiyun
226*4882a593Smuzhiyunv1.01 (980812)
227*4882a593Smuzhiyun    Problems fixed:
228*4882a593Smuzhiyun
229*4882a593Smuzhiyun	Connection hangup with telnet
230*4882a593Smuzhiyun	Slow telnet connection
231*4882a593Smuzhiyun
232*4882a593Smuzhiyunv1.00 beta 01 (980507)
233*4882a593Smuzhiyun    New features:
234*4882a593Smuzhiyun
235*4882a593Smuzhiyun	None.
236*4882a593Smuzhiyun
237*4882a593Smuzhiyun    Problems fixed:
238*4882a593Smuzhiyun
239*4882a593Smuzhiyun	None.
240*4882a593Smuzhiyun
241*4882a593Smuzhiyun    Known limitations:
242*4882a593Smuzhiyun
243*4882a593Smuzhiyun	- tar archive instead of standard package format (rpm).
244*4882a593Smuzhiyun	- FDDI statistic is empty.
245*4882a593Smuzhiyun	- not tested with 2.1.xx kernels
246*4882a593Smuzhiyun	- integration in kernel not tested
247*4882a593Smuzhiyun	- not tested simultaneously with FDDI adapters from other vendors.
248*4882a593Smuzhiyun	- only X86 processors supported.
249*4882a593Smuzhiyun	- SBA (Synchronous Bandwidth Allocator) parameters can
250*4882a593Smuzhiyun	  not be configured.
251*4882a593Smuzhiyun	- does not work on some COMPAQ machines. See the PCI howto
252*4882a593Smuzhiyun	  document for details about this problem.
253*4882a593Smuzhiyun	- data corruption with kernel versions below 2.0.33.
254