smc911x: Fix undefined CONFIG_ symbol warning
[linux-2.6] / drivers / net / wireless / wavelan.p.h
1 /*
2  *      WaveLAN ISA driver
3  *
4  *              Jean II - HPLB '96
5  *
6  * Reorganisation and extension of the driver.
7  *
8  * This file contains all definitions and declarations necessary for the
9  * WaveLAN ISA driver.  This file is a private header, so it should
10  * be included only in wavelan.c!
11  */
12
13 #ifndef WAVELAN_P_H
14 #define WAVELAN_P_H
15
16 /************************** DOCUMENTATION ***************************/
17 /*
18  * This driver provides a Linux interface to the WaveLAN ISA hardware.
19  * The WaveLAN is a product of Lucent (http://www.wavelan.com/).
20  * This division was formerly part of NCR and then AT&T.
21  * WaveLANs are also distributed by DEC (RoamAbout DS) and Digital Ocean.
22  *
23  * To learn how to use this driver, read the NET3 HOWTO.
24  * If you want to exploit the many other functionalities, read the comments
25  * in the code.
26  *
27  * This driver is the result of the effort of many people (see below).
28  */
29
30 /* ------------------------ SPECIFIC NOTES ------------------------ */
31 /*
32  * Web page
33  * --------
34  *      I try to maintain a web page with the Wireless LAN Howto at :
35  *          http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Wavelan.html
36  *
37  * SMP
38  * ---
39  *      We now are SMP compliant (I eventually fixed the remaining bugs).
40  *      The driver has been tested on a dual P6-150 and survived my usual
41  *      set of torture tests.
42  *      Anyway, I spent enough time chasing interrupt re-entrancy during
43  *      errors or reconfigure, and I designed the locked/unlocked sections
44  *      of the driver with great care, and with the recent addition of
45  *      the spinlock (thanks to the new API), we should be quite close to
46  *      the truth.
47  *      The SMP/IRQ locking is quite coarse and conservative (i.e. not fast),
48  *      but better safe than sorry (especially at 2 Mb/s ;-).
49  *
50  *      I have also looked into disabling only our interrupt on the card
51  *      (via HACR) instead of all interrupts in the processor (via cli),
52  *      so that other driver are not impacted, and it look like it's
53  *      possible, but it's very tricky to do right (full of races). As
54  *      the gain would be mostly for SMP systems, it can wait...
55  *
56  * Debugging and options
57  * ---------------------
58  *      You will find below a set of '#define" allowing a very fine control
59  *      on the driver behaviour and the debug messages printed.
60  *      The main options are :
61  *      o SET_PSA_CRC, to have your card correctly recognised by
62  *        an access point and the Point-to-Point diagnostic tool.
63  *      o USE_PSA_CONFIG, to read configuration from the PSA (EEprom)
64  *        (otherwise we always start afresh with some defaults)
65  *
66  * wavelan.o is too darned big
67  * ---------------------------
68  *      That's true!  There is a very simple way to reduce the driver
69  *      object by 33%!  Comment out the following line:
70  *              #include <linux/wireless.h>
71  *      Other compile options can also reduce the size of it...
72  *
73  * MAC address and hardware detection:
74  * -----------------------------------
75  *      The detection code for the WaveLAN checks that the first three
76  *      octets of the MAC address fit the company code.  This type of
77  *      detection works well for AT&T cards (because the AT&T code is
78  *      hardcoded in wavelan.h), but of course will fail for other
79  *      manufacturers.
80  *
81  *      If you are sure that your card is derived from the WaveLAN,
82  *      here is the way to configure it:
83  *      1) Get your MAC address
84  *              a) With your card utilities (wfreqsel, instconf, etc.)
85  *              b) With the driver:
86  *                      o compile the kernel with DEBUG_CONFIG_INFO enabled
87  *                      o Boot and look the card messages
88  *      2) Set your MAC code (3 octets) in MAC_ADDRESSES[][3] (wavelan.h)
89  *      3) Compile and verify
90  *      4) Send me the MAC code.  I will include it in the next version.
91  *
92  */
93
94 /* --------------------- WIRELESS EXTENSIONS --------------------- */
95 /*
96  * This driver is the first to support "wireless extensions".
97  * This set of extensions provides a standard way to control the wireless
98  * characteristics of the hardware.  Applications such as mobile IP may
99  * take advantage of it.
100  *
101  * It might be a good idea as well to fetch the wireless tools to
102  * configure the device and play a bit.
103  */
104
105 /* ---------------------------- FILES ---------------------------- */
106 /*
107  * wavelan.c:           actual code for the driver:  C functions
108  *
109  * wavelan.p.h:         private header:  local types and variables for driver
110  *
111  * wavelan.h:           description of the hardware interface and structs
112  *
113  * i82586.h:            description of the Ethernet controller
114  */
115
116 /* --------------------------- HISTORY --------------------------- */
117 /*
118  * This is based on information in the drivers' headers. It may not be
119  * accurate, and I guarantee only my best effort.
120  *
121  * The history of the WaveLAN drivers is as complicated as the history of
122  * the WaveLAN itself (NCR -> AT&T -> Lucent).
123  *
124  * It all started with Anders Klemets <klemets@paul.rutgers.edu>
125  * writing a WaveLAN ISA driver for the Mach microkernel.  Girish
126  * Welling <welling@paul.rutgers.edu> had also worked on it.
127  * Keith Moore modified this for the PCMCIA hardware.
128  * 
129  * Robert Morris <rtm@das.harvard.edu> ported these two drivers to BSDI
130  * and added specific PCMCIA support (there is currently no equivalent
131  * of the PCMCIA package under BSD).
132  *
133  * Jim Binkley <jrb@cs.pdx.edu> ported both BSDI drivers to FreeBSD.
134  *
135  * Bruce Janson <bruce@cs.usyd.edu.au> ported the BSDI ISA driver to Linux.
136  *
137  * Anthony D. Joseph <adj@lcs.mit.edu> started to modify Bruce's driver
138  * (with help of the BSDI PCMCIA driver) for PCMCIA.
139  * Yunzhou Li <yunzhou@strat.iol.unh.edu> finished this work.
140  * Joe Finney <joe@comp.lancs.ac.uk> patched the driver to start
141  * 2.00 cards correctly (2.4 GHz with frequency selection).
142  * David Hinds <dahinds@users.sourceforge.net> integrated the whole in his
143  * PCMCIA package (and bug corrections).
144  *
145  * I (Jean Tourrilhes - jt@hplb.hpl.hp.com) then started to make some
146  * patches to the PCMCIA driver.  Later, I added code in the ISA driver
147  * for Wireless Extensions and full support of frequency selection
148  * cards.  Then, I did the same to the PCMCIA driver, and did some
149  * reorganisation.  Finally, I came back to the ISA driver to
150  * upgrade it at the same level as the PCMCIA one and reorganise
151  * the code.
152  * Loeke Brederveld <lbrederv@wavelan.com> from Lucent has given me
153  * much needed information on the WaveLAN hardware.
154  */
155
156 /* The original copyrights and literature mention others' names and
157  * credits.  I don't know what their part in this development was.
158  */
159
160 /* By the way, for the copyright and legal stuff:
161  * almost everybody wrote code under the GNU or BSD license (or similar),
162  * and want their original copyright to remain somewhere in the
163  * code (for myself, I go with the GPL).
164  * Nobody wants to take responsibility for anything, except the fame.
165  */
166
167 /* --------------------------- CREDITS --------------------------- */
168 /*
169  * This software was developed as a component of the
170  * Linux operating system.
171  * It is based on other device drivers and information
172  * either written or supplied by:
173  *      Ajay Bakre <bakre@paul.rutgers.edu>,
174  *      Donald Becker <becker@cesdis.gsfc.nasa.gov>,
175  *      Loeke Brederveld <Loeke.Brederveld@Utrecht.NCR.com>,
176  *      Brent Elphick <belphick@uwaterloo.ca>,
177  *      Anders Klemets <klemets@it.kth.se>,
178  *      Vladimir V. Kolpakov <w@stier.koenig.ru>,
179  *      Marc Meertens <Marc.Meertens@Utrecht.NCR.com>,
180  *      Pauline Middelink <middelin@polyware.iaf.nl>,
181  *      Robert Morris <rtm@das.harvard.edu>,
182  *      Jean Tourrilhes <jt@hpl.hp.com>,
183  *      Girish Welling <welling@paul.rutgers.edu>,
184  *      Clark Woodworth <clark@hiway1.exit109.com>
185  *      Yongguang Zhang <ygz@isl.hrl.hac.com>
186  *
187  * Thanks go also to:
188  *      James Ashton <jaa101@syseng.anu.edu.au>,
189  *      Alan Cox <alan@redhat.com>,
190  *      Allan Creighton <allanc@cs.usyd.edu.au>,
191  *      Matthew Geier <matthew@cs.usyd.edu.au>,
192  *      Remo di Giovanni <remo@cs.usyd.edu.au>,
193  *      Eckhard Grah <grah@wrcs1.urz.uni-wuppertal.de>,
194  *      Vipul Gupta <vgupta@cs.binghamton.edu>,
195  *      Mark Hagan <mhagan@wtcpost.daytonoh.NCR.COM>,
196  *      Tim Nicholson <tim@cs.usyd.edu.au>,
197  *      Ian Parkin <ian@cs.usyd.edu.au>,
198  *      John Rosenberg <johnr@cs.usyd.edu.au>,
199  *      George Rossi <george@phm.gov.au>,
200  *      Arthur Scott <arthur@cs.usyd.edu.au>,
201  *      Stanislav Sinyagin <stas@isf.ru>
202  *      and Peter Storey for their assistance and advice.
203  *
204  * Additional Credits:
205  *
206  *      My development has been done initially under Debian 1.1 (Linux 2.0.x)
207  *      and now under Debian 2.2, initially with an HP Vectra XP/60, and now
208  *      an HP Vectra XP/90.
209  *
210  */
211
212 /* ------------------------- IMPROVEMENTS ------------------------- */
213 /*
214  * I proudly present:
215  *
216  * Changes made in first pre-release:
217  * ----------------------------------
218  *      - reorganisation of the code, function name change
219  *      - creation of private header (wavelan.p.h)
220  *      - reorganised debug messages
221  *      - more comments, history, etc.
222  *      - mmc_init:  configure the PSA if not done
223  *      - mmc_init:  correct default value of level threshold for PCMCIA
224  *      - mmc_init:  2.00 detection better code for 2.00 initialization
225  *      - better info at startup
226  *      - IRQ setting (note:  this setting is permanent)
227  *      - watchdog:  change strategy (and solve module removal problems)
228  *      - add wireless extensions (ioctl and get_wireless_stats)
229  *        get/set nwid/frequency on fly, info for /proc/net/wireless
230  *      - more wireless extensions:  SETSPY and GETSPY
231  *      - make wireless extensions optional
232  *      - private ioctl to set/get quality and level threshold, histogram
233  *      - remove /proc/net/wavelan
234  *      - suppress useless stuff from lp (net_local)
235  *      - kernel 2.1 support (copy_to/from_user instead of memcpy_to/fromfs)
236  *      - add message level (debug stuff in /var/adm/debug and errors not
237  *        displayed at console and still in /var/adm/messages)
238  *      - multi device support
239  *      - start fixing the probe (init code)
240  *      - more inlines
241  *      - man page
242  *      - many other minor details and cleanups
243  *
244  * Changes made in second pre-release:
245  * -----------------------------------
246  *      - clean up init code (probe and module init)
247  *      - better multiple device support (module)
248  *      - name assignment (module)
249  *
250  * Changes made in third pre-release:
251  * ----------------------------------
252  *      - be more conservative on timers
253  *      - preliminary support for multicast (I still lack some details)
254  *
255  * Changes made in fourth pre-release:
256  * -----------------------------------
257  *      - multicast (revisited and finished)
258  *      - avoid reset in set_multicast_list (a really big hack)
259  *        if somebody could apply this code for other i82586 based drivers
260  *      - share onboard memory 75% RU and 25% CU (instead of 50/50)
261  *
262  * Changes made for release in 2.1.15:
263  * -----------------------------------
264  *      - change the detection code for multi manufacturer code support
265  *
266  * Changes made for release in 2.1.17:
267  * -----------------------------------
268  *      - update to wireless extensions changes
269  *      - silly bug in card initial configuration (psa_conf_status)
270  *
271  * Changes made for release in 2.1.27 & 2.0.30:
272  * --------------------------------------------
273  *      - small bug in debug code (probably not the last one...)
274  *      - remove extern keyword for wavelan_probe()
275  *      - level threshold is now a standard wireless extension (version 4 !)
276  *      - modules parameters types (new module interface)
277  *
278  * Changes made for release in 2.1.36:
279  * -----------------------------------
280  *      - byte count stats (courtesy of David Hinds)
281  *      - remove dev_tint stuff (courtesy of David Hinds)
282  *      - encryption setting from Brent Elphick (thanks a lot!)
283  *      - 'ioaddr' to 'u_long' for the Alpha (thanks to Stanislav Sinyagin)
284  *
285  * Other changes (not by me) :
286  * -------------------------
287  *      - Spelling and gramar "rectification".
288  *
289  * Changes made for release in 2.0.37 & 2.2.2 :
290  * ------------------------------------------
291  *      - Correct status in /proc/net/wireless
292  *      - Set PSA CRC to make PtP diagnostic tool happy (Bob Gray)
293  *      - Module init code don't fail if we found at least one card in
294  *        the address list (Karlis Peisenieks)
295  *      - Missing parenthesis (Christopher Peterson)
296  *      - Correct i82586 configuration parameters
297  *      - Encryption initialisation bug (Robert McCormack)
298  *      - New mac addresses detected in the probe
299  *      - Increase watchdog for busy environments
300  *
301  * Changes made for release in 2.0.38 & 2.2.7 :
302  * ------------------------------------------
303  *      - Correct the reception logic to better report errors and avoid
304  *        sending bogus packet up the stack
305  *      - Delay RU config to avoid corrupting first received packet
306  *      - Change config completion code (to actually check something)
307  *      - Avoid reading out of bound in skbuf to transmit
308  *      - Rectify a lot of (useless) debugging code
309  *      - Change the way to `#ifdef SET_PSA_CRC'
310  *
311  * Changes made for release in 2.2.11 & 2.3.13 :
312  * -------------------------------------------
313  *      - Change e-mail and web page addresses
314  *      - Watchdog timer is now correctly expressed in HZ, not in jiffies
315  *      - Add channel number to the list of frequencies in range
316  *      - Add the (short) list of bit-rates in range
317  *      - Developp a new sensitivity... (sens.value & sens.fixed)
318  *
319  * Changes made for release in 2.2.14 & 2.3.23 :
320  * -------------------------------------------
321  *      - Fix check for root permission (break instead of exit)
322  *      - New nwid & encoding setting (Wireless Extension 9)
323  *
324  * Changes made for release in 2.3.49 :
325  * ----------------------------------
326  *      - Indentation reformating (Alan)
327  *      - Update to new network API (softnet - 2.3.43) :
328  *              o replace dev->tbusy (Alan)
329  *              o replace dev->tstart (Alan)
330  *              o remove dev->interrupt (Alan)
331  *              o add SMP locking via spinlock in splxx (me)
332  *              o add spinlock in interrupt handler (me)
333  *              o use kernel watchdog instead of ours (me)
334  *              o increase watchdog timeout (kernel is more sensitive) (me)
335  *              o verify that all the changes make sense and work (me)
336  *      - Fixup a potential gotcha when reconfiguring and thighten a bit
337  *              the interactions with Tx queue.
338  *
339  * Changes made for release in 2.4.0 :
340  * ---------------------------------
341  *      - Fix spinlock stupid bugs that I left in. The driver is now SMP
342  *              compliant and doesn't lockup at startup.
343  *
344  * Changes made for release in 2.5.2 :
345  * ---------------------------------
346  *      - Use new driver API for Wireless Extensions :
347  *              o got rid of wavelan_ioctl()
348  *              o use a bunch of iw_handler instead
349  *
350  * Changes made for release in 2.5.35 :
351  * ----------------------------------
352  *      - Set dev->trans_start to avoid filling the logs
353  *      - Handle better spurious/bogus interrupt
354  *      - Avoid deadlocks in mmc_out()/mmc_in()
355  *
356  * Wishes & dreams:
357  * ----------------
358  *      - roaming (see Pcmcia driver)
359  */
360
361 /***************************** INCLUDES *****************************/
362
363 #include        <linux/module.h>
364
365 #include        <linux/kernel.h>
366 #include        <linux/sched.h>
367 #include        <linux/types.h>
368 #include        <linux/fcntl.h>
369 #include        <linux/interrupt.h>
370 #include        <linux/stat.h>
371 #include        <linux/ptrace.h>
372 #include        <linux/ioport.h>
373 #include        <linux/in.h>
374 #include        <linux/string.h>
375 #include        <linux/delay.h>
376 #include        <linux/bitops.h>
377 #include        <asm/system.h>
378 #include        <asm/io.h>
379 #include        <asm/dma.h>
380 #include        <asm/uaccess.h>
381 #include        <linux/errno.h>
382 #include        <linux/netdevice.h>
383 #include        <linux/etherdevice.h>
384 #include        <linux/skbuff.h>
385 #include        <linux/slab.h>
386 #include        <linux/timer.h>
387 #include        <linux/init.h>
388
389 #include <linux/wireless.h>             /* Wireless extensions */
390 #include <net/iw_handler.h>             /* Wireless handlers */
391
392 /* WaveLAN declarations */
393 #include        "i82586.h"
394 #include        "wavelan.h"
395
396 /************************** DRIVER OPTIONS **************************/
397 /*
398  * `#define' or `#undef' the following constant to change the behaviour
399  * of the driver...
400  */
401 #undef SET_PSA_CRC              /* Calculate and set the CRC on PSA (slower) */
402 #define USE_PSA_CONFIG          /* Use info from the PSA. */
403 #undef STRUCT_CHECK             /* Verify padding of structures. */
404 #undef EEPROM_IS_PROTECTED      /* doesn't seem to be necessary */
405 #define MULTICAST_AVOID         /* Avoid extra multicast (I'm sceptical). */
406 #undef SET_MAC_ADDRESS          /* Experimental */
407
408 /* Warning:  this stuff will slow down the driver. */
409 #define WIRELESS_SPY            /* Enable spying addresses. */
410 #undef HISTOGRAM                /* Enable histogram of signal level. */
411
412 /****************************** DEBUG ******************************/
413
414 #undef DEBUG_MODULE_TRACE       /* module insertion/removal */
415 #undef DEBUG_CALLBACK_TRACE     /* calls made by Linux */
416 #undef DEBUG_INTERRUPT_TRACE    /* calls to handler */
417 #undef DEBUG_INTERRUPT_INFO     /* type of interrupt and so on */
418 #define DEBUG_INTERRUPT_ERROR   /* problems */
419 #undef DEBUG_CONFIG_TRACE       /* Trace the config functions. */
420 #undef DEBUG_CONFIG_INFO        /* what's going on */
421 #define DEBUG_CONFIG_ERROR      /* errors on configuration */
422 #undef DEBUG_TX_TRACE           /* transmission calls */
423 #undef DEBUG_TX_INFO            /* header of the transmitted packet */
424 #undef DEBUG_TX_FAIL            /* Normal failure conditions */
425 #define DEBUG_TX_ERROR          /* Unexpected conditions */
426 #undef DEBUG_RX_TRACE           /* transmission calls */
427 #undef DEBUG_RX_INFO            /* header of the received packet */
428 #undef DEBUG_RX_FAIL            /* Normal failure conditions */
429 #define DEBUG_RX_ERROR          /* Unexpected conditions */
430
431 #undef DEBUG_PACKET_DUMP        /* Dump packet on the screen if defined to 32. */
432 #undef DEBUG_IOCTL_TRACE        /* misc. call by Linux */
433 #undef DEBUG_IOCTL_INFO         /* various debugging info */
434 #define DEBUG_IOCTL_ERROR       /* what's going wrong */
435 #define DEBUG_BASIC_SHOW        /* Show basic startup info. */
436 #undef DEBUG_VERSION_SHOW       /* Print version info. */
437 #undef DEBUG_PSA_SHOW           /* Dump PSA to screen. */
438 #undef DEBUG_MMC_SHOW           /* Dump mmc to screen. */
439 #undef DEBUG_SHOW_UNUSED        /* Show unused fields too. */
440 #undef DEBUG_I82586_SHOW        /* Show i82586 status. */
441 #undef DEBUG_DEVICE_SHOW        /* Show device parameters. */
442
443 /************************ CONSTANTS & MACROS ************************/
444
445 #ifdef DEBUG_VERSION_SHOW
446 static const char       *version        = "wavelan.c : v24 (SMP + wireless extensions) 11/12/01\n";
447 #endif
448
449 /* Watchdog temporisation */
450 #define WATCHDOG_JIFFIES        (512*HZ/100)
451
452 /* ------------------------ PRIVATE IOCTL ------------------------ */
453
454 #define SIOCSIPQTHR     SIOCIWFIRSTPRIV         /* Set quality threshold */
455 #define SIOCGIPQTHR     SIOCIWFIRSTPRIV + 1     /* Get quality threshold */
456
457 #define SIOCSIPHISTO    SIOCIWFIRSTPRIV + 2     /* Set histogram ranges */
458 #define SIOCGIPHISTO    SIOCIWFIRSTPRIV + 3     /* Get histogram values */
459
460 /****************************** TYPES ******************************/
461
462 /* Shortcuts */
463 typedef struct net_device_stats en_stats;
464 typedef struct iw_statistics    iw_stats;
465 typedef struct iw_quality       iw_qual;
466 typedef struct iw_freq          iw_freq;
467 typedef struct net_local        net_local;
468 typedef struct timer_list       timer_list;
469
470 /* Basic types */
471 typedef u_char          mac_addr[WAVELAN_ADDR_SIZE];    /* Hardware address */
472
473 /*
474  * Static specific data for the interface.
475  *
476  * For each network interface, Linux keeps data in two structures:  "device"
477  * keeps the generic data (same format for everybody) and "net_local" keeps
478  * additional specific data.
479  * Note that some of this specific data is in fact generic (en_stats, for
480  * example).
481  */
482 struct net_local
483 {
484   net_local *   next;           /* linked list of the devices */
485   struct net_device *   dev;            /* reverse link */
486   spinlock_t    spinlock;       /* Serialize access to the hardware (SMP) */
487   en_stats      stats;          /* Ethernet interface statistics */
488   int           nresets;        /* number of hardware resets */
489   u_char        reconfig_82586; /* We need to reconfigure the controller. */
490   u_char        promiscuous;    /* promiscuous mode */
491   int           mc_count;       /* number of multicast addresses */
492   u_short       hacr;           /* current host interface state */
493
494   int           tx_n_in_use;
495   u_short       rx_head;
496   u_short       rx_last;
497   u_short       tx_first_free;
498   u_short       tx_first_in_use;
499
500   iw_stats      wstats;         /* Wireless-specific statistics */
501
502   struct iw_spy_data    spy_data;
503   struct iw_public_data wireless_data;
504
505 #ifdef HISTOGRAM
506   int           his_number;             /* number of intervals */
507   u_char        his_range[16];          /* boundaries of interval ]n-1; n] */
508   u_long        his_sum[16];            /* sum in interval */
509 #endif  /* HISTOGRAM */
510 };
511
512 /**************************** PROTOTYPES ****************************/
513
514 /* ----------------------- MISC. SUBROUTINES ------------------------ */
515 static u_char
516         wv_irq_to_psa(int);
517 static int
518         wv_psa_to_irq(u_char);
519 /* ------------------- HOST ADAPTER SUBROUTINES ------------------- */
520 static inline u_short           /* data */
521         hasr_read(u_long);      /* Read the host interface:  base address */
522 static inline void
523         hacr_write(u_long,      /* Write to host interface:  base address */
524                    u_short),    /* data */
525         hacr_write_slow(u_long,
526                    u_short),
527         set_chan_attn(u_long,   /* ioaddr */
528                       u_short), /* hacr   */
529         wv_hacr_reset(u_long),  /* ioaddr */
530         wv_16_off(u_long,       /* ioaddr */
531                   u_short),     /* hacr   */
532         wv_16_on(u_long,        /* ioaddr */
533                  u_short),      /* hacr   */
534         wv_ints_off(struct net_device *),
535         wv_ints_on(struct net_device *);
536 /* ----------------- MODEM MANAGEMENT SUBROUTINES ----------------- */
537 static void
538         psa_read(u_long,        /* Read the Parameter Storage Area. */
539                  u_short,       /* hacr */
540                  int,           /* offset in PSA */
541                  u_char *,      /* buffer to fill */
542                  int),          /* size to read */
543         psa_write(u_long,       /* Write to the PSA. */
544                   u_short,      /* hacr */
545                   int,          /* offset in PSA */
546                   u_char *,     /* buffer in memory */
547                   int);         /* length of buffer */
548 static inline void
549         mmc_out(u_long,         /* Write 1 byte to the Modem Manag Control. */
550                 u_short,
551                 u_char),
552         mmc_write(u_long,       /* Write n bytes to the MMC. */
553                   u_char,
554                   u_char *,
555                   int);
556 static inline u_char            /* Read 1 byte from the MMC. */
557         mmc_in(u_long,
558                u_short);
559 static inline void
560         mmc_read(u_long,        /* Read n bytes from the MMC. */
561                  u_char,
562                  u_char *,
563                  int),
564         fee_wait(u_long,        /* Wait for frequency EEPROM:  base address */
565                  int,           /* base delay to wait for */
566                  int);          /* time to wait */
567 static void
568         fee_read(u_long,        /* Read the frequency EEPROM:  base address */
569                  u_short,       /* destination offset */
570                  u_short *,     /* data buffer */
571                  int);          /* number of registers */
572 /* ---------------------- I82586 SUBROUTINES ----------------------- */
573 static /*inline*/ void
574         obram_read(u_long,      /* ioaddr */
575                    u_short,     /* o */
576                    u_char *,    /* b */
577                    int);        /* n */
578 static inline void
579         obram_write(u_long,     /* ioaddr */
580                     u_short,    /* o */
581                     u_char *,   /* b */
582                     int);       /* n */
583 static void
584         wv_ack(struct net_device *);
585 static inline int
586         wv_synchronous_cmd(struct net_device *,
587                            const char *),
588         wv_config_complete(struct net_device *,
589                            u_long,
590                            net_local *);
591 static int
592         wv_complete(struct net_device *,
593                     u_long,
594                     net_local *);
595 static inline void
596         wv_82586_reconfig(struct net_device *);
597 /* ------------------- DEBUG & INFO SUBROUTINES ------------------- */
598 #ifdef DEBUG_I82586_SHOW
599 static void
600         wv_scb_show(unsigned short);
601 #endif
602 static inline void
603         wv_init_info(struct net_device *);      /* display startup info */
604 /* ------------------- IOCTL, STATS & RECONFIG ------------------- */
605 static en_stats *
606         wavelan_get_stats(struct net_device *); /* Give stats /proc/net/dev */
607 static iw_stats *
608         wavelan_get_wireless_stats(struct net_device *);
609 static void
610         wavelan_set_multicast_list(struct net_device *);
611 /* ----------------------- PACKET RECEPTION ----------------------- */
612 static inline void
613         wv_packet_read(struct net_device *,     /* Read a packet from a frame. */
614                        u_short,
615                        int),
616         wv_receive(struct net_device *);        /* Read all packets waiting. */
617 /* --------------------- PACKET TRANSMISSION --------------------- */
618 static inline int
619         wv_packet_write(struct net_device *,    /* Write a packet to the Tx buffer. */
620                         void *,
621                         short);
622 static int
623         wavelan_packet_xmit(struct sk_buff *,   /* Send a packet. */
624                             struct net_device *);
625 /* -------------------- HARDWARE CONFIGURATION -------------------- */
626 static inline int
627         wv_mmc_init(struct net_device *),       /* Initialize the modem. */
628         wv_ru_start(struct net_device *),       /* Start the i82586 receiver unit. */
629         wv_cu_start(struct net_device *),       /* Start the i82586 command unit. */
630         wv_82586_start(struct net_device *);    /* Start the i82586. */
631 static void
632         wv_82586_config(struct net_device *);   /* Configure the i82586. */
633 static inline void
634         wv_82586_stop(struct net_device *);
635 static int
636         wv_hw_reset(struct net_device *),       /* Reset the WaveLAN hardware. */
637         wv_check_ioaddr(u_long,         /* ioaddr */
638                         u_char *);      /* mac address (read) */
639 /* ---------------------- INTERRUPT HANDLING ---------------------- */
640 static irqreturn_t
641         wavelan_interrupt(int,          /* interrupt handler */
642                           void *);
643 static void
644         wavelan_watchdog(struct net_device *);  /* transmission watchdog */
645 /* ------------------- CONFIGURATION CALLBACKS ------------------- */
646 static int
647         wavelan_open(struct net_device *),      /* Open the device. */
648         wavelan_close(struct net_device *),     /* Close the device. */
649         wavelan_config(struct net_device *, unsigned short);/* Configure one device. */
650 extern struct net_device *wavelan_probe(int unit);      /* See Space.c. */
651
652 /**************************** VARIABLES ****************************/
653
654 /*
655  * This is the root of the linked list of WaveLAN drivers
656  * It is use to verify that we don't reuse the same base address
657  * for two different drivers and to clean up when removing the module.
658  */
659 static net_local *      wavelan_list    = (net_local *) NULL;
660
661 /*
662  * This table is used to translate the PSA value to IRQ number
663  * and vice versa.
664  */
665 static u_char   irqvals[]       =
666 {
667            0,    0,    0, 0x01,
668         0x02, 0x04,    0, 0x08,
669            0,    0, 0x10, 0x20,
670         0x40,    0,    0, 0x80,
671 };
672
673 /*
674  * Table of the available I/O addresses (base addresses) for WaveLAN
675  */
676 static unsigned short   iobase[]        =
677 {
678 #if     0
679   /* Leave out 0x3C0 for now -- seems to clash with some video
680    * controllers.
681    * Leave out the others too -- we will always use 0x390 and leave
682    * 0x300 for the Ethernet device.
683    * Jean II:  0x3E0 is fine as well.
684    */
685   0x300, 0x390, 0x3E0, 0x3C0
686 #endif  /* 0 */
687   0x390, 0x3E0
688 };
689
690 #ifdef  MODULE
691 /* Parameters set by insmod */
692 static int      io[4];
693 static int      irq[4];
694 static char     *name[4];
695 module_param_array(io, int, NULL, 0);
696 module_param_array(irq, int, NULL, 0);
697 module_param_array(name, charp, NULL, 0);
698
699 MODULE_PARM_DESC(io, "WaveLAN I/O base address(es),required");
700 MODULE_PARM_DESC(irq, "WaveLAN IRQ number(s)");
701 MODULE_PARM_DESC(name, "WaveLAN interface neme(s)");
702 #endif  /* MODULE */
703
704 #endif  /* WAVELAN_P_H */