blob: 0b27863f155c49bac2f810ec5ae9a09f6497e2e4 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001Wed 2-Aug-95 <matti.aarnio@utu.fi>
2
3 Linux network driver modules
4
5 Do not mistake this for "README.modules" at the top-level
6 directory! That document tells about modules in general, while
7 this one tells only about network device driver modules.
8
9 This is a potpourri of INSMOD-time(*) configuration options
10 (if such exists) and their default values of various modules
11 in the Linux network drivers collection.
12
13 Some modules have also hidden (= non-documented) tunable values.
14 The choice of not documenting them is based on general belief, that
15 the less the user needs to know, the better. (There are things that
16 driver developers can use, others should not confuse themselves.)
17
18 In many cases it is highly preferred that insmod:ing is done
19 ONLY with defining an explicit address for the card, AND BY
20 NOT USING AUTO-PROBING!
21
22 Now most cards have some explicitly defined base address that they
23 are compiled with (to avoid auto-probing, among other things).
24 If that compiled value does not match your actual configuration,
25 do use the "io=0xXXX" -parameter for the insmod, and give there
26 a value matching your environment.
27
28 If you are adventurous, you can ask the driver to autoprobe
29 by using the "io=0" parameter, however it is a potentially dangerous
30 thing to do in a live system. (If you don't know where the
31 card is located, you can try autoprobing, and after possible
32 crash recovery, insmod with proper IO-address..)
33
34 --------------------------
35 (*) "INSMOD-time" means when you load module with
36 /sbin/insmod you can feed it optional parameters.
37 See "man insmod".
38 --------------------------
39
40
41 8390 based Network Modules (Paul Gortmaker, Nov 12, 1995)
42 --------------------------
43
44(Includes: smc-ultra, ne, wd, 3c503, hp, hp-plus, e2100 and ac3200)
45
46The 8390 series of network drivers now support multiple card systems without
47reloading the same module multiple times (memory efficient!) This is done by
48specifying multiple comma separated values, such as:
49
50 insmod 3c503.o io=0x280,0x300,0x330,0x350 xcvr=0,1,0,1
51
52The above would have the one module controlling four 3c503 cards, with card 2
53and 4 using external transceivers. The "insmod" manual describes the usage
54of comma separated value lists.
55
56It is *STRONGLY RECOMMENDED* that you supply "io=" instead of autoprobing.
57If an "io=" argument is not supplied, then the ISA drivers will complain
58about autoprobing being not recommended, and begrudgingly autoprobe for
59a *SINGLE CARD ONLY* -- if you want to use multiple cards you *have* to
60supply an "io=0xNNN,0xQQQ,..." argument.
61
62The ne module is an exception to the above. A NE2000 is essentially an
638390 chip, some bus glue and some RAM. Because of this, the ne probe is
64more invasive than the rest, and so at boot we make sure the ne probe is
65done last of all the 8390 cards (so that it won't trip over other 8390 based
66cards) With modules we can't ensure that all other non-ne 8390 cards have
67already been found. Because of this, the ne module REQUIRES an "io=0xNNN"
68argument passed in via insmod. It will refuse to autoprobe.
69
70It is also worth noting that auto-IRQ probably isn't as reliable during
71the flurry of interrupt activity on a running machine. Cards such as the
72ne2000 that can't get the IRQ setting from an EEPROM or configuration
73register are probably best supplied with an "irq=M" argument as well.
74
75
76----------------------------------------------------------------------
77Card/Module List - Configurable Parameters and Default Values
78----------------------------------------------------------------------
79
803c501.c:
81 io = 0x280 IO base address
82 irq = 5 IRQ
83 (Probes ports: 0x280, 0x300)
84
853c503.c:
86 io = 0 (It will complain if you don't supply an "io=0xNNN")
87 irq = 0 (IRQ software selected by driver using autoIRQ)
88 xcvr = 0 (Use xcvr=1 to select external transceiver.)
89 (Probes ports: 0x300, 0x310, 0x330, 0x350, 0x250, 0x280, 0x2A0, 0x2E0)
90
913c505.c:
92 io = 0
93 irq = 0
94 dma = 6 (not autoprobed)
95 (Probes ports: 0x300, 0x280, 0x310)
96
973c507.c:
98 io = 0x300
99 irq = 0
100 (Probes ports: 0x300, 0x320, 0x340, 0x280)
101
1023c509.c:
103 io = 0
104 irq = 0
105 ( Module load-time probing Works reliably only on EISA, ISA ID-PROBE
106 IS NOT RELIABLE! Compile this driver statically into kernel for
107 now, if you need it auto-probing on an ISA-bus machine. )
108
1098390.c:
110 (No public options, several other modules need this one)
111
112a2065.c:
113 Since this is a Zorro board, it supports full autoprobing, even for
114 multiple boards. (m68k/Amiga)
115
116ac3200.c:
117 io = 0 (Checks 0x1000 to 0x8fff in 0x1000 intervals)
118 irq = 0 (Read from config register)
119 (EISA probing..)
120
121apricot.c:
122 io = 0x300 (Can't be altered!)
123 irq = 10
124
125arcnet.c:
126 io = 0
127 irqnum = 0
128 shmem = 0
129 num = 0
130 DO SET THESE MANUALLY AT INSMOD!
131 (When probing, looks at the following possible addresses:
132 Suggested ones:
133 0x300, 0x2E0, 0x2F0, 0x2D0
134 Other ones:
135 0x200, 0x210, 0x220, 0x230, 0x240, 0x250, 0x260, 0x270,
136 0x280, 0x290, 0x2A0, 0x2B0, 0x2C0,
137 0x310, 0x320, 0x330, 0x340, 0x350, 0x360, 0x370,
138 0x380, 0x390, 0x3A0, 0x3E0, 0x3F0 )
139
140ariadne.c:
141 Since this is a Zorro board, it supports full autoprobing, even for
142 multiple boards. (m68k/Amiga)
143
144at1700.c:
145 io = 0x260
146 irq = 0
147 (Probes ports: 0x260, 0x280, 0x2A0, 0x240, 0x340, 0x320, 0x380, 0x300)
148
149atari_bionet.c:
150 Supports full autoprobing. (m68k/Atari)
151
152atari_pamsnet.c:
153 Supports full autoprobing. (m68k/Atari)
154
155atarilance.c:
156 Supports full autoprobing. (m68k/Atari)
157
158atp.c: *Not modularized*
159 (Probes ports: 0x378, 0x278, 0x3BC;
160 fixed IRQs: 5 and 7 )
161
162cops.c:
163 io = 0x240
164 irq = 5
165 nodeid = 0 (AutoSelect = 0, NodeID 1-254 is hand selected.)
166 (Probes ports: 0x240, 0x340, 0x200, 0x210, 0x220, 0x230, 0x260,
167 0x2A0, 0x300, 0x310, 0x320, 0x330, 0x350, 0x360)
168
169de4x5.c:
170 io = 0x000b
171 irq = 10
172 is_not_dec = 0 -- For non-DEC card using DEC 21040/21041/21140 chip, set this to 1
173 (EISA, and PCI probing)
174
175de600.c:
176 de600_debug = 0
177 (On port 0x378, irq 7 -- lpt1; compile time configurable)
178
179de620.c:
180 bnc = 0, utp = 0 <-- Force media by setting either.
181 io = 0x378 (also compile-time configurable)
182 irq = 7
183
184depca.c:
185 io = 0x200
186 irq = 7
187 (Probes ports: ISA: 0x300, 0x200;
188 EISA: 0x0c00 )
189
190dummy.c:
191 No options
192
193e2100.c:
194 io = 0 (It will complain if you don't supply an "io=0xNNN")
195 irq = 0 (IRQ software selected by driver)
196 mem = 0 (Override default shared memory start of 0xd0000)
197 xcvr = 0 (Use xcvr=1 to select external transceiver.)
198 (Probes ports: 0x300, 0x280, 0x380, 0x220)
199
200eepro.c:
201 io = 0x200
202 irq = 0
203 (Probes ports: 0x200, 0x240, 0x280, 0x2C0, 0x300, 0x320, 0x340, 0x360)
204
205eexpress.c:
206 io = 0x300
207 irq = 0 (IRQ value read from EEPROM)
208 (Probes ports: 0x300, 0x270, 0x320, 0x340)
209
210eql.c:
211 (No parameters)
212
213ewrk3.c:
214 io = 0x300
215 irq = 5
216 (With module no autoprobing!
217 On EISA-bus does EISA probing.
218 Static linkage probes ports on ISA bus:
219 0x100, 0x120, 0x140, 0x160, 0x180, 0x1A0, 0x1C0,
220 0x200, 0x220, 0x240, 0x260, 0x280, 0x2A0, 0x2C0, 0x2E0,
221 0x300, 0x340, 0x360, 0x380, 0x3A0, 0x3C0)
222
223hp-plus.c:
224 io = 0 (It will complain if you don't supply an "io=0xNNN")
225 irq = 0 (IRQ read from configuration register)
226 (Probes ports: 0x200, 0x240, 0x280, 0x2C0, 0x300, 0x320, 0x340)
227
228hp.c:
229 io = 0 (It will complain if you don't supply an "io=0xNNN")
230 irq = 0 (IRQ software selected by driver using autoIRQ)
231 (Probes ports: 0x300, 0x320, 0x340, 0x280, 0x2C0, 0x200, 0x240)
232
233hp100.c:
234 hp100_port = 0 (IO-base address)
235 (Does EISA-probing, if on EISA-slot;
236 On ISA-bus probes all ports from 0x100 thru to 0x3E0
237 in increments of 0x020)
238
239hydra.c:
240 Since this is a Zorro board, it supports full autoprobing, even for
241 multiple boards. (m68k/Amiga)
242
243ibmtr.c:
244 io = 0xa20, 0xa24 (autoprobed by default)
245 irq = 0 (driver cannot select irq - read from hardware)
246 mem = 0 (shared memory base set at 0xd0000 and not yet
247 able to override thru mem= parameter.)
248
249lance.c: *Not modularized*
250 (PCI, and ISA probing; "CONFIG_PCI" needed for PCI support)
251 (Probes ISA ports: 0x300, 0x320, 0x340, 0x360)
252
253loopback.c: *Static kernel component*
254
255ne.c:
256 io = 0 (Explicitly *requires* an "io=0xNNN" value)
257 irq = 0 (Tries to determine configured IRQ via autoIRQ)
258 (Probes ports: 0x300, 0x280, 0x320, 0x340, 0x360)
259
260net_init.c: *Static kernel component*
261
262ni52.c: *Not modularized*
263 (Probes ports: 0x300, 0x280, 0x360, 0x320, 0x340
264 mems: 0xD0000, 0xD2000, 0xC8000, 0xCA000,
265 0xD4000, 0xD6000, 0xD8000 )
266
267ni65.c: *Not modularized* **16MB MEMORY BARRIER BUG**
268 (Probes ports: 0x300, 0x320, 0x340, 0x360)
269
270pi2.c: *Not modularized* (well, NON-STANDARD modularization!)
271 Only one card supported at this time.
272 (Probes ports: 0x380, 0x300, 0x320, 0x340, 0x360, 0x3A0)
273
274plip.c:
275 io = 0
276 irq = 0 (by default, uses IRQ 5 for port at 0x3bc, IRQ 7
277 for port at 0x378, and IRQ 2 for port at 0x278)
278 (Probes ports: 0x278, 0x378, 0x3bc)
279
280ppp.c:
281 No options (ppp-2.2+ has some, this is based on non-dynamic
282 version from ppp-2.1.2d)
283
284seeq8005.c: *Not modularized*
285 (Probes ports: 0x300, 0x320, 0x340, 0x360)
286
Linus Torvalds1da177e2005-04-16 15:20:36 -0700287skeleton.c: *Skeleton*
288
289slhc.c:
290 No configuration parameters
291
292slip.c:
293 slip_maxdev = 256 (default value from SL_NRUNIT on slip.h)
294
295
296smc-ultra.c:
297 io = 0 (It will complain if you don't supply an "io=0xNNN")
298 irq = 0 (IRQ val. read from EEPROM)
299 (Probes ports: 0x200, 0x220, 0x240, 0x280, 0x300, 0x340, 0x380)
300
301tulip.c: *Partial modularization*
302 (init-time memory allocation makes problems..)
303
304tunnel.c:
305 No insmod parameters
306
307wavelan.c:
308 io = 0x390 (Settable, but change not recommended)
309 irq = 0 (Not honoured, if changed..)
310
311wd.c:
312 io = 0 (It will complain if you don't supply an "io=0xNNN")
313 irq = 0 (IRQ val. read from EEPROM, ancient cards use autoIRQ)
314 mem = 0 (Force shared-memory on address 0xC8000, or whatever..)
315 mem_end = 0 (Force non-std. mem. size via supplying mem_end val.)
316 (eg. for 32k WD8003EBT, use mem=0xd0000 mem_end=0xd8000)
317 (Probes ports: 0x300, 0x280, 0x380, 0x240)
318
319znet.c: *Not modularized*
320 (Only one device on Zenith Z-Note (notebook?) systems,
321 configuration information from (EE)PROM)