xref: /linux/Documentation/networking/device_drivers/atm/fore200e.rst (revision 4b4193256c8d3bc3a5397b5cd9494c2ad386317d)
1*9633a0e9SJakub Kicinski.. SPDX-License-Identifier: GPL-2.0
2*9633a0e9SJakub Kicinski
3*9633a0e9SJakub Kicinski=============================================
4*9633a0e9SJakub KicinskiFORE Systems PCA-200E/SBA-200E ATM NIC driver
5*9633a0e9SJakub Kicinski=============================================
6*9633a0e9SJakub Kicinski
7*9633a0e9SJakub KicinskiThis driver adds support for the FORE Systems 200E-series ATM adapters
8*9633a0e9SJakub Kicinskito the Linux operating system. It is based on the earlier PCA-200E driver
9*9633a0e9SJakub Kicinskiwritten by Uwe Dannowski.
10*9633a0e9SJakub Kicinski
11*9633a0e9SJakub KicinskiThe driver simultaneously supports PCA-200E and SBA-200E adapters on
12*9633a0e9SJakub Kicinskii386, alpha (untested), powerpc, sparc and sparc64 archs.
13*9633a0e9SJakub Kicinski
14*9633a0e9SJakub KicinskiThe intent is to enable the use of different models of FORE adapters at the
15*9633a0e9SJakub Kicinskisame time, by hosts that have several bus interfaces (such as PCI+SBUS,
16*9633a0e9SJakub Kicinskior PCI+EISA).
17*9633a0e9SJakub Kicinski
18*9633a0e9SJakub KicinskiOnly PCI and SBUS devices are currently supported by the driver, but support
19*9633a0e9SJakub Kicinskifor other bus interfaces such as EISA should not be too hard to add.
20*9633a0e9SJakub Kicinski
21*9633a0e9SJakub Kicinski
22*9633a0e9SJakub KicinskiFirmware Copyright Notice
23*9633a0e9SJakub Kicinski-------------------------
24*9633a0e9SJakub Kicinski
25*9633a0e9SJakub KicinskiPlease read the fore200e_firmware_copyright file present
26*9633a0e9SJakub Kicinskiin the linux/drivers/atm directory for details and restrictions.
27*9633a0e9SJakub Kicinski
28*9633a0e9SJakub Kicinski
29*9633a0e9SJakub KicinskiFirmware Updates
30*9633a0e9SJakub Kicinski----------------
31*9633a0e9SJakub Kicinski
32*9633a0e9SJakub KicinskiThe FORE Systems 200E-series driver is shipped with firmware data being
33*9633a0e9SJakub Kicinskiuploaded to the ATM adapters at system boot time or at module loading time.
34*9633a0e9SJakub KicinskiThe supplied firmware images should work with all adapters.
35*9633a0e9SJakub Kicinski
36*9633a0e9SJakub KicinskiHowever, if you encounter problems (the firmware doesn't start or the driver
37*9633a0e9SJakub Kicinskiis unable to read the PROM data), you may consider trying another firmware
38*9633a0e9SJakub Kicinskiversion. Alternative binary firmware images can be found somewhere on the
39*9633a0e9SJakub KicinskiForeThought CD-ROM supplied with your adapter by FORE Systems.
40*9633a0e9SJakub Kicinski
41*9633a0e9SJakub KicinskiYou can also get the latest firmware images from FORE Systems at
42*9633a0e9SJakub Kicinskihttps://en.wikipedia.org/wiki/FORE_Systems. Register TACTics Online and go to
43*9633a0e9SJakub Kicinskithe 'software updates' pages. The firmware binaries are part of
44*9633a0e9SJakub Kicinskithe various ForeThought software distributions.
45*9633a0e9SJakub Kicinski
46*9633a0e9SJakub KicinskiNotice that different versions of the PCA-200E firmware exist, depending
47*9633a0e9SJakub Kicinskion the endianness of the host architecture. The driver is shipped with
48*9633a0e9SJakub Kicinskiboth little and big endian PCA firmware images.
49*9633a0e9SJakub Kicinski
50*9633a0e9SJakub KicinskiName and location of the new firmware images can be set at kernel
51*9633a0e9SJakub Kicinskiconfiguration time:
52*9633a0e9SJakub Kicinski
53*9633a0e9SJakub Kicinski1. Copy the new firmware binary files (with .bin, .bin1 or .bin2 suffix)
54*9633a0e9SJakub Kicinski   to some directory, such as linux/drivers/atm.
55*9633a0e9SJakub Kicinski
56*9633a0e9SJakub Kicinski2. Reconfigure your kernel to set the new firmware name and location.
57*9633a0e9SJakub Kicinski   Expected pathnames are absolute or relative to the drivers/atm directory.
58*9633a0e9SJakub Kicinski
59*9633a0e9SJakub Kicinski3. Rebuild and re-install your kernel or your module.
60*9633a0e9SJakub Kicinski
61*9633a0e9SJakub Kicinski
62*9633a0e9SJakub KicinskiFeedback
63*9633a0e9SJakub Kicinski--------
64*9633a0e9SJakub Kicinski
65*9633a0e9SJakub KicinskiFeedback is welcome. Please send success stories/bug reports/
66*9633a0e9SJakub Kicinskipatches/improvement/comments/flames to <lizzi@cnam.fr>.
67