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