WIP FPC-III support
[linux/fpc-iii.git] / Documentation / networking / device_drivers / ethernet / ti / tlan.rst
blob4fdc0907f4fcb76cd0ba604478d746bc5eea756c
1 .. SPDX-License-Identifier: GPL-2.0
3 =====================
4 TLAN driver for Linux
5 =====================
7 :Version: 1.14a
9 (C) 1997-1998 Caldera, Inc.
11 (C) 1998 James Banks
13 (C) 1999-2001 Torben Mathiasen <tmm@image.dk, torben.mathiasen@compaq.com>
15 For driver information/updates visit http://www.compaq.com
21 I. Supported Devices
22 ====================
24     Only PCI devices will work with this driver.
26     Supported:
28     =========   =========       ===========================================
29     Vendor ID   Device ID       Name
30     =========   =========       ===========================================
31     0e11        ae32            Compaq Netelligent 10/100 TX PCI UTP
32     0e11        ae34            Compaq Netelligent 10 T PCI UTP
33     0e11        ae35            Compaq Integrated NetFlex 3/P
34     0e11        ae40            Compaq Netelligent Dual 10/100 TX PCI UTP
35     0e11        ae43            Compaq Netelligent Integrated 10/100 TX UTP
36     0e11        b011            Compaq Netelligent 10/100 TX Embedded UTP
37     0e11        b012            Compaq Netelligent 10 T/2 PCI UTP/Coax
38     0e11        b030            Compaq Netelligent 10/100 TX UTP
39     0e11        f130            Compaq NetFlex 3/P
40     0e11        f150            Compaq NetFlex 3/P
41     108d        0012            Olicom OC-2325
42     108d        0013            Olicom OC-2183
43     108d        0014            Olicom OC-2326
44     =========   =========       ===========================================
47     Caveats:
49     I am not sure if 100BaseTX daughterboards (for those cards which
50     support such things) will work.  I haven't had any solid evidence
51     either way.
53     However, if a card supports 100BaseTx without requiring an add
54     on daughterboard, it should work with 100BaseTx.
56     The "Netelligent 10 T/2 PCI UTP/Coax" (b012) device is untested,
57     but I do not expect any problems.
60 II. Driver Options
61 ==================
63         1. You can append debug=x to the end of the insmod line to get
64            debug messages, where x is a bit field where the bits mean
65            the following:
67            ====         =====================================
68            0x01         Turn on general debugging messages.
69            0x02         Turn on receive debugging messages.
70            0x04         Turn on transmit debugging messages.
71            0x08         Turn on list debugging messages.
72            ====         =====================================
74         2. You can append aui=1 to the end of the insmod line to cause
75            the adapter to use the AUI interface instead of the 10 Base T
76            interface.  This is also what to do if you want to use the BNC
77            connector on a TLAN based device.  (Setting this option on a
78            device that does not have an AUI/BNC connector will probably
79            cause it to not function correctly.)
81         3. You can set duplex=1 to force half duplex, and duplex=2 to
82            force full duplex.
84         4. You can set speed=10 to force 10Mbs operation, and speed=100
85            to force 100Mbs operation. (I'm not sure what will happen
86            if a card which only supports 10Mbs is forced into 100Mbs
87            mode.)
89         5. You have to use speed=X duplex=Y together now. If you just
90            do "insmod tlan.o speed=100" the driver will do Auto-Neg.
91            To force a 10Mbps Half-Duplex link do "insmod tlan.o speed=10
92            duplex=1".
94         6. If the driver is built into the kernel, you can use the 3rd
95            and 4th parameters to set aui and debug respectively.  For
96            example::
98                 ether=0,0,0x1,0x7,eth0
100            This sets aui to 0x1 and debug to 0x7, assuming eth0 is a
101            supported TLAN device.
103            The bits in the third byte are assigned as follows:
105                 ====   ===============
106                 0x01   aui
107                 0x02   use half duplex
108                 0x04   use full duplex
109                 0x08   use 10BaseT
110                 0x10   use 100BaseTx
111                 ====   ===============
113            You also need to set both speed and duplex settings when forcing
114            speeds with kernel-parameters.
115            ether=0,0,0x12,0,eth0 will force link to 100Mbps Half-Duplex.
117         7. If you have more than one tlan adapter in your system, you can
118            use the above options on a per adapter basis. To force a 100Mbit/HD
119            link with your eth1 adapter use::
121                 insmod tlan speed=0,100 duplex=0,1
123            Now eth0 will use auto-neg and eth1 will be forced to 100Mbit/HD.
124            Note that the tlan driver supports a maximum of 8 adapters.
127 III. Things to try if you have problems
128 =======================================
130         1. Make sure your card's PCI id is among those listed in
131            section I, above.
132         2. Make sure routing is correct.
133         3. Try forcing different speed/duplex settings
136 There is also a tlan mailing list which you can join by sending "subscribe tlan"
137 in the body of an email to majordomo@vuser.vu.union.edu.
139 There is also a tlan website at http://www.compaq.com