[PATCH] bcm43xx: ucode debug status via sysfs
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / net / wireless / bcm43xx / bcm43xx.h
blob6d4ea36bc5644753b8933deedb8222ca83afc957
1 #ifndef BCM43xx_H_
2 #define BCM43xx_H_
4 #include <linux/hw_random.h>
5 #include <linux/version.h>
6 #include <linux/kernel.h>
7 #include <linux/spinlock.h>
8 #include <linux/interrupt.h>
9 #include <linux/stringify.h>
10 #include <linux/pci.h>
11 #include <net/ieee80211.h>
12 #include <net/ieee80211softmac.h>
13 #include <asm/atomic.h>
14 #include <asm/io.h>
17 #include "bcm43xx_debugfs.h"
18 #include "bcm43xx_leds.h"
21 #define PFX KBUILD_MODNAME ": "
23 #define BCM43xx_SWITCH_CORE_MAX_RETRIES 50
24 #define BCM43xx_IRQWAIT_MAX_RETRIES 50
26 #define BCM43xx_IO_SIZE 8192
28 /* Active Core PCI Configuration Register. */
29 #define BCM43xx_PCICFG_ACTIVE_CORE 0x80
30 /* SPROM control register. */
31 #define BCM43xx_PCICFG_SPROMCTL 0x88
32 /* Interrupt Control PCI Configuration Register. (Only on PCI cores with rev >= 6) */
33 #define BCM43xx_PCICFG_ICR 0x94
35 /* MMIO offsets */
36 #define BCM43xx_MMIO_DMA0_REASON 0x20
37 #define BCM43xx_MMIO_DMA0_IRQ_MASK 0x24
38 #define BCM43xx_MMIO_DMA1_REASON 0x28
39 #define BCM43xx_MMIO_DMA1_IRQ_MASK 0x2C
40 #define BCM43xx_MMIO_DMA2_REASON 0x30
41 #define BCM43xx_MMIO_DMA2_IRQ_MASK 0x34
42 #define BCM43xx_MMIO_DMA3_REASON 0x38
43 #define BCM43xx_MMIO_DMA3_IRQ_MASK 0x3C
44 #define BCM43xx_MMIO_DMA4_REASON 0x40
45 #define BCM43xx_MMIO_DMA4_IRQ_MASK 0x44
46 #define BCM43xx_MMIO_DMA5_REASON 0x48
47 #define BCM43xx_MMIO_DMA5_IRQ_MASK 0x4C
48 #define BCM43xx_MMIO_STATUS_BITFIELD 0x120
49 #define BCM43xx_MMIO_STATUS2_BITFIELD 0x124
50 #define BCM43xx_MMIO_GEN_IRQ_REASON 0x128
51 #define BCM43xx_MMIO_GEN_IRQ_MASK 0x12C
52 #define BCM43xx_MMIO_RAM_CONTROL 0x130
53 #define BCM43xx_MMIO_RAM_DATA 0x134
54 #define BCM43xx_MMIO_PS_STATUS 0x140
55 #define BCM43xx_MMIO_RADIO_HWENABLED_HI 0x158
56 #define BCM43xx_MMIO_SHM_CONTROL 0x160
57 #define BCM43xx_MMIO_SHM_DATA 0x164
58 #define BCM43xx_MMIO_SHM_DATA_UNALIGNED 0x166
59 #define BCM43xx_MMIO_XMITSTAT_0 0x170
60 #define BCM43xx_MMIO_XMITSTAT_1 0x174
61 #define BCM43xx_MMIO_REV3PLUS_TSF_LOW 0x180 /* core rev >= 3 only */
62 #define BCM43xx_MMIO_REV3PLUS_TSF_HIGH 0x184 /* core rev >= 3 only */
64 /* 32-bit DMA */
65 #define BCM43xx_MMIO_DMA32_BASE0 0x200
66 #define BCM43xx_MMIO_DMA32_BASE1 0x220
67 #define BCM43xx_MMIO_DMA32_BASE2 0x240
68 #define BCM43xx_MMIO_DMA32_BASE3 0x260
69 #define BCM43xx_MMIO_DMA32_BASE4 0x280
70 #define BCM43xx_MMIO_DMA32_BASE5 0x2A0
71 /* 64-bit DMA */
72 #define BCM43xx_MMIO_DMA64_BASE0 0x200
73 #define BCM43xx_MMIO_DMA64_BASE1 0x240
74 #define BCM43xx_MMIO_DMA64_BASE2 0x280
75 #define BCM43xx_MMIO_DMA64_BASE3 0x2C0
76 #define BCM43xx_MMIO_DMA64_BASE4 0x300
77 #define BCM43xx_MMIO_DMA64_BASE5 0x340
78 /* PIO */
79 #define BCM43xx_MMIO_PIO1_BASE 0x300
80 #define BCM43xx_MMIO_PIO2_BASE 0x310
81 #define BCM43xx_MMIO_PIO3_BASE 0x320
82 #define BCM43xx_MMIO_PIO4_BASE 0x330
84 #define BCM43xx_MMIO_PHY_VER 0x3E0
85 #define BCM43xx_MMIO_PHY_RADIO 0x3E2
86 #define BCM43xx_MMIO_ANTENNA 0x3E8
87 #define BCM43xx_MMIO_CHANNEL 0x3F0
88 #define BCM43xx_MMIO_CHANNEL_EXT 0x3F4
89 #define BCM43xx_MMIO_RADIO_CONTROL 0x3F6
90 #define BCM43xx_MMIO_RADIO_DATA_HIGH 0x3F8
91 #define BCM43xx_MMIO_RADIO_DATA_LOW 0x3FA
92 #define BCM43xx_MMIO_PHY_CONTROL 0x3FC
93 #define BCM43xx_MMIO_PHY_DATA 0x3FE
94 #define BCM43xx_MMIO_MACFILTER_CONTROL 0x420
95 #define BCM43xx_MMIO_MACFILTER_DATA 0x422
96 #define BCM43xx_MMIO_RADIO_HWENABLED_LO 0x49A
97 #define BCM43xx_MMIO_GPIO_CONTROL 0x49C
98 #define BCM43xx_MMIO_GPIO_MASK 0x49E
99 #define BCM43xx_MMIO_TSF_0 0x632 /* core rev < 3 only */
100 #define BCM43xx_MMIO_TSF_1 0x634 /* core rev < 3 only */
101 #define BCM43xx_MMIO_TSF_2 0x636 /* core rev < 3 only */
102 #define BCM43xx_MMIO_TSF_3 0x638 /* core rev < 3 only */
103 #define BCM43xx_MMIO_RNG 0x65A
104 #define BCM43xx_MMIO_POWERUP_DELAY 0x6A8
106 /* SPROM offsets. */
107 #define BCM43xx_SPROM_BASE 0x1000
108 #define BCM43xx_SPROM_BOARDFLAGS2 0x1c
109 #define BCM43xx_SPROM_IL0MACADDR 0x24
110 #define BCM43xx_SPROM_ET0MACADDR 0x27
111 #define BCM43xx_SPROM_ET1MACADDR 0x2a
112 #define BCM43xx_SPROM_ETHPHY 0x2d
113 #define BCM43xx_SPROM_BOARDREV 0x2e
114 #define BCM43xx_SPROM_PA0B0 0x2f
115 #define BCM43xx_SPROM_PA0B1 0x30
116 #define BCM43xx_SPROM_PA0B2 0x31
117 #define BCM43xx_SPROM_WL0GPIO0 0x32
118 #define BCM43xx_SPROM_WL0GPIO2 0x33
119 #define BCM43xx_SPROM_MAXPWR 0x34
120 #define BCM43xx_SPROM_PA1B0 0x35
121 #define BCM43xx_SPROM_PA1B1 0x36
122 #define BCM43xx_SPROM_PA1B2 0x37
123 #define BCM43xx_SPROM_IDL_TSSI_TGT 0x38
124 #define BCM43xx_SPROM_BOARDFLAGS 0x39
125 #define BCM43xx_SPROM_ANTENNA_GAIN 0x3a
126 #define BCM43xx_SPROM_VERSION 0x3f
128 /* BCM43xx_SPROM_BOARDFLAGS values */
129 #define BCM43xx_BFL_BTCOEXIST 0x0001 /* implements Bluetooth coexistance */
130 #define BCM43xx_BFL_PACTRL 0x0002 /* GPIO 9 controlling the PA */
131 #define BCM43xx_BFL_AIRLINEMODE 0x0004 /* implements GPIO 13 radio disable indication */
132 #define BCM43xx_BFL_RSSI 0x0008 /* software calculates nrssi slope. */
133 #define BCM43xx_BFL_ENETSPI 0x0010 /* has ephy roboswitch spi */
134 #define BCM43xx_BFL_XTAL_NOSLOW 0x0020 /* no slow clock available */
135 #define BCM43xx_BFL_CCKHIPWR 0x0040 /* can do high power CCK transmission */
136 #define BCM43xx_BFL_ENETADM 0x0080 /* has ADMtek switch */
137 #define BCM43xx_BFL_ENETVLAN 0x0100 /* can do vlan */
138 #define BCM43xx_BFL_AFTERBURNER 0x0200 /* supports Afterburner mode */
139 #define BCM43xx_BFL_NOPCI 0x0400 /* leaves PCI floating */
140 #define BCM43xx_BFL_FEM 0x0800 /* supports the Front End Module */
141 #define BCM43xx_BFL_EXTLNA 0x1000 /* has an external LNA */
142 #define BCM43xx_BFL_HGPA 0x2000 /* had high gain PA */
143 #define BCM43xx_BFL_BTCMOD 0x4000 /* BFL_BTCOEXIST is given in alternate GPIOs */
144 #define BCM43xx_BFL_ALTIQ 0x8000 /* alternate I/Q settings */
146 /* GPIO register offset, in both ChipCommon and PCI core. */
147 #define BCM43xx_GPIO_CONTROL 0x6c
149 /* SHM Routing */
150 #define BCM43xx_SHM_SHARED 0x0001
151 #define BCM43xx_SHM_WIRELESS 0x0002
152 #define BCM43xx_SHM_PCM 0x0003
153 #define BCM43xx_SHM_HWMAC 0x0004
154 #define BCM43xx_SHM_UCODE 0x0300
156 /* MacFilter offsets. */
157 #define BCM43xx_MACFILTER_SELF 0x0000
158 #define BCM43xx_MACFILTER_ASSOC 0x0003
160 /* Chipcommon registers. */
161 #define BCM43xx_CHIPCOMMON_CAPABILITIES 0x04
162 #define BCM43xx_CHIPCOMMON_PLLONDELAY 0xB0
163 #define BCM43xx_CHIPCOMMON_FREFSELDELAY 0xB4
164 #define BCM43xx_CHIPCOMMON_SLOWCLKCTL 0xB8
165 #define BCM43xx_CHIPCOMMON_SYSCLKCTL 0xC0
167 /* PCI core specific registers. */
168 #define BCM43xx_PCICORE_BCAST_ADDR 0x50
169 #define BCM43xx_PCICORE_BCAST_DATA 0x54
170 #define BCM43xx_PCICORE_SBTOPCI2 0x108
172 /* SBTOPCI2 values. */
173 #define BCM43xx_SBTOPCI2_PREFETCH 0x4
174 #define BCM43xx_SBTOPCI2_BURST 0x8
176 /* Chipcommon capabilities. */
177 #define BCM43xx_CAPABILITIES_PCTL 0x00040000
178 #define BCM43xx_CAPABILITIES_PLLMASK 0x00030000
179 #define BCM43xx_CAPABILITIES_PLLSHIFT 16
180 #define BCM43xx_CAPABILITIES_FLASHMASK 0x00000700
181 #define BCM43xx_CAPABILITIES_FLASHSHIFT 8
182 #define BCM43xx_CAPABILITIES_EXTBUSPRESENT 0x00000040
183 #define BCM43xx_CAPABILITIES_UARTGPIO 0x00000020
184 #define BCM43xx_CAPABILITIES_UARTCLOCKMASK 0x00000018
185 #define BCM43xx_CAPABILITIES_UARTCLOCKSHIFT 3
186 #define BCM43xx_CAPABILITIES_MIPSBIGENDIAN 0x00000004
187 #define BCM43xx_CAPABILITIES_NRUARTSMASK 0x00000003
189 /* PowerControl */
190 #define BCM43xx_PCTL_IN 0xB0
191 #define BCM43xx_PCTL_OUT 0xB4
192 #define BCM43xx_PCTL_OUTENABLE 0xB8
193 #define BCM43xx_PCTL_XTAL_POWERUP 0x40
194 #define BCM43xx_PCTL_PLL_POWERDOWN 0x80
196 /* PowerControl Clock Modes */
197 #define BCM43xx_PCTL_CLK_FAST 0x00
198 #define BCM43xx_PCTL_CLK_SLOW 0x01
199 #define BCM43xx_PCTL_CLK_DYNAMIC 0x02
201 #define BCM43xx_PCTL_FORCE_SLOW 0x0800
202 #define BCM43xx_PCTL_FORCE_PLL 0x1000
203 #define BCM43xx_PCTL_DYN_XTAL 0x2000
205 /* COREIDs */
206 #define BCM43xx_COREID_CHIPCOMMON 0x800
207 #define BCM43xx_COREID_ILINE20 0x801
208 #define BCM43xx_COREID_SDRAM 0x803
209 #define BCM43xx_COREID_PCI 0x804
210 #define BCM43xx_COREID_MIPS 0x805
211 #define BCM43xx_COREID_ETHERNET 0x806
212 #define BCM43xx_COREID_V90 0x807
213 #define BCM43xx_COREID_USB11_HOSTDEV 0x80a
214 #define BCM43xx_COREID_IPSEC 0x80b
215 #define BCM43xx_COREID_PCMCIA 0x80d
216 #define BCM43xx_COREID_EXT_IF 0x80f
217 #define BCM43xx_COREID_80211 0x812
218 #define BCM43xx_COREID_MIPS_3302 0x816
219 #define BCM43xx_COREID_USB11_HOST 0x817
220 #define BCM43xx_COREID_USB11_DEV 0x818
221 #define BCM43xx_COREID_USB20_HOST 0x819
222 #define BCM43xx_COREID_USB20_DEV 0x81a
223 #define BCM43xx_COREID_SDIO_HOST 0x81b
225 /* Core Information Registers */
226 #define BCM43xx_CIR_BASE 0xf00
227 #define BCM43xx_CIR_SBTPSFLAG (BCM43xx_CIR_BASE + 0x18)
228 #define BCM43xx_CIR_SBIMSTATE (BCM43xx_CIR_BASE + 0x90)
229 #define BCM43xx_CIR_SBINTVEC (BCM43xx_CIR_BASE + 0x94)
230 #define BCM43xx_CIR_SBTMSTATELOW (BCM43xx_CIR_BASE + 0x98)
231 #define BCM43xx_CIR_SBTMSTATEHIGH (BCM43xx_CIR_BASE + 0x9c)
232 #define BCM43xx_CIR_SBIMCONFIGLOW (BCM43xx_CIR_BASE + 0xa8)
233 #define BCM43xx_CIR_SB_ID_HI (BCM43xx_CIR_BASE + 0xfc)
235 /* Mask to get the Backplane Flag Number from SBTPSFLAG. */
236 #define BCM43xx_BACKPLANE_FLAG_NR_MASK 0x3f
238 /* SBIMCONFIGLOW values/masks. */
239 #define BCM43xx_SBIMCONFIGLOW_SERVICE_TOUT_MASK 0x00000007
240 #define BCM43xx_SBIMCONFIGLOW_SERVICE_TOUT_SHIFT 0
241 #define BCM43xx_SBIMCONFIGLOW_REQUEST_TOUT_MASK 0x00000070
242 #define BCM43xx_SBIMCONFIGLOW_REQUEST_TOUT_SHIFT 4
243 #define BCM43xx_SBIMCONFIGLOW_CONNID_MASK 0x00ff0000
244 #define BCM43xx_SBIMCONFIGLOW_CONNID_SHIFT 16
246 /* sbtmstatelow state flags */
247 #define BCM43xx_SBTMSTATELOW_RESET 0x01
248 #define BCM43xx_SBTMSTATELOW_REJECT 0x02
249 #define BCM43xx_SBTMSTATELOW_CLOCK 0x10000
250 #define BCM43xx_SBTMSTATELOW_FORCE_GATE_CLOCK 0x20000
252 /* sbtmstatehigh state flags */
253 #define BCM43xx_SBTMSTATEHIGH_SERROR 0x00000001
254 #define BCM43xx_SBTMSTATEHIGH_BUSY 0x00000004
255 #define BCM43xx_SBTMSTATEHIGH_TIMEOUT 0x00000020
256 #define BCM43xx_SBTMSTATEHIGH_COREFLAGS 0x1FFF0000
257 #define BCM43xx_SBTMSTATEHIGH_DMA64BIT 0x10000000
258 #define BCM43xx_SBTMSTATEHIGH_GATEDCLK 0x20000000
259 #define BCM43xx_SBTMSTATEHIGH_BISTFAILED 0x40000000
260 #define BCM43xx_SBTMSTATEHIGH_BISTCOMPLETE 0x80000000
262 /* sbimstate flags */
263 #define BCM43xx_SBIMSTATE_IB_ERROR 0x20000
264 #define BCM43xx_SBIMSTATE_TIMEOUT 0x40000
266 /* PHYVersioning */
267 #define BCM43xx_PHYTYPE_A 0x00
268 #define BCM43xx_PHYTYPE_B 0x01
269 #define BCM43xx_PHYTYPE_G 0x02
271 /* PHYRegisters */
272 #define BCM43xx_PHY_ILT_A_CTRL 0x0072
273 #define BCM43xx_PHY_ILT_A_DATA1 0x0073
274 #define BCM43xx_PHY_ILT_A_DATA2 0x0074
275 #define BCM43xx_PHY_G_LO_CONTROL 0x0810
276 #define BCM43xx_PHY_ILT_G_CTRL 0x0472
277 #define BCM43xx_PHY_ILT_G_DATA1 0x0473
278 #define BCM43xx_PHY_ILT_G_DATA2 0x0474
279 #define BCM43xx_PHY_A_PCTL 0x007B
280 #define BCM43xx_PHY_G_PCTL 0x0029
281 #define BCM43xx_PHY_A_CRS 0x0029
282 #define BCM43xx_PHY_RADIO_BITFIELD 0x0401
283 #define BCM43xx_PHY_G_CRS 0x0429
284 #define BCM43xx_PHY_NRSSILT_CTRL 0x0803
285 #define BCM43xx_PHY_NRSSILT_DATA 0x0804
287 /* RadioRegisters */
288 #define BCM43xx_RADIOCTL_ID 0x01
290 /* StatusBitField */
291 #define BCM43xx_SBF_MAC_ENABLED 0x00000001
292 #define BCM43xx_SBF_2 0x00000002 /*FIXME: fix name*/
293 #define BCM43xx_SBF_CORE_READY 0x00000004
294 #define BCM43xx_SBF_400 0x00000400 /*FIXME: fix name*/
295 #define BCM43xx_SBF_4000 0x00004000 /*FIXME: fix name*/
296 #define BCM43xx_SBF_8000 0x00008000 /*FIXME: fix name*/
297 #define BCM43xx_SBF_XFER_REG_BYTESWAP 0x00010000
298 #define BCM43xx_SBF_MODE_NOTADHOC 0x00020000
299 #define BCM43xx_SBF_MODE_AP 0x00040000
300 #define BCM43xx_SBF_RADIOREG_LOCK 0x00080000
301 #define BCM43xx_SBF_MODE_MONITOR 0x00400000
302 #define BCM43xx_SBF_MODE_PROMISC 0x01000000
303 #define BCM43xx_SBF_PS1 0x02000000
304 #define BCM43xx_SBF_PS2 0x04000000
305 #define BCM43xx_SBF_NO_SSID_BCAST 0x08000000
306 #define BCM43xx_SBF_TIME_UPDATE 0x10000000
307 #define BCM43xx_SBF_80000000 0x80000000 /*FIXME: fix name*/
309 /* Microcode */
310 #define BCM43xx_UCODE_REVISION 0x0000
311 #define BCM43xx_UCODE_PATCHLEVEL 0x0002
312 #define BCM43xx_UCODE_DATE 0x0004
313 #define BCM43xx_UCODE_TIME 0x0006
314 #define BCM43xx_UCODE_STATUS 0x0040
316 /* MicrocodeFlagsBitfield (addr + lo-word values?)*/
317 #define BCM43xx_UCODEFLAGS_OFFSET 0x005E
319 #define BCM43xx_UCODEFLAG_AUTODIV 0x0001
320 #define BCM43xx_UCODEFLAG_UNKBGPHY 0x0002
321 #define BCM43xx_UCODEFLAG_UNKBPHY 0x0004
322 #define BCM43xx_UCODEFLAG_UNKGPHY 0x0020
323 #define BCM43xx_UCODEFLAG_UNKPACTRL 0x0040
324 #define BCM43xx_UCODEFLAG_JAPAN 0x0080
326 /* Generic-Interrupt reasons. */
327 #define BCM43xx_IRQ_READY (1 << 0)
328 #define BCM43xx_IRQ_BEACON (1 << 1)
329 #define BCM43xx_IRQ_PS (1 << 2)
330 #define BCM43xx_IRQ_REG124 (1 << 5)
331 #define BCM43xx_IRQ_PMQ (1 << 6)
332 #define BCM43xx_IRQ_PIO_WORKAROUND (1 << 8)
333 #define BCM43xx_IRQ_XMIT_ERROR (1 << 11)
334 #define BCM43xx_IRQ_RX (1 << 15)
335 #define BCM43xx_IRQ_SCAN (1 << 16)
336 #define BCM43xx_IRQ_NOISE (1 << 18)
337 #define BCM43xx_IRQ_XMIT_STATUS (1 << 29)
339 #define BCM43xx_IRQ_ALL 0xffffffff
340 #define BCM43xx_IRQ_INITIAL (BCM43xx_IRQ_PS | \
341 BCM43xx_IRQ_REG124 | \
342 BCM43xx_IRQ_PMQ | \
343 BCM43xx_IRQ_XMIT_ERROR | \
344 BCM43xx_IRQ_RX | \
345 BCM43xx_IRQ_SCAN | \
346 BCM43xx_IRQ_NOISE | \
347 BCM43xx_IRQ_XMIT_STATUS)
350 /* Initial default iw_mode */
351 #define BCM43xx_INITIAL_IWMODE IW_MODE_INFRA
353 /* Bus type PCI. */
354 #define BCM43xx_BUSTYPE_PCI 0
355 /* Bus type Silicone Backplane Bus. */
356 #define BCM43xx_BUSTYPE_SB 1
357 /* Bus type PCMCIA. */
358 #define BCM43xx_BUSTYPE_PCMCIA 2
360 /* Threshold values. */
361 #define BCM43xx_MIN_RTS_THRESHOLD 1U
362 #define BCM43xx_MAX_RTS_THRESHOLD 2304U
363 #define BCM43xx_DEFAULT_RTS_THRESHOLD BCM43xx_MAX_RTS_THRESHOLD
365 #define BCM43xx_DEFAULT_SHORT_RETRY_LIMIT 7
366 #define BCM43xx_DEFAULT_LONG_RETRY_LIMIT 4
368 /* Max size of a security key */
369 #define BCM43xx_SEC_KEYSIZE 16
370 /* Security algorithms. */
371 enum {
372 BCM43xx_SEC_ALGO_NONE = 0, /* unencrypted, as of TX header. */
373 BCM43xx_SEC_ALGO_WEP,
374 BCM43xx_SEC_ALGO_UNKNOWN,
375 BCM43xx_SEC_ALGO_AES,
376 BCM43xx_SEC_ALGO_WEP104,
377 BCM43xx_SEC_ALGO_TKIP,
380 #ifdef assert
381 # undef assert
382 #endif
383 #ifdef CONFIG_BCM43XX_DEBUG
384 #define assert(expr) \
385 do { \
386 if (unlikely(!(expr))) { \
387 printk(KERN_ERR PFX "ASSERTION FAILED (%s) at: %s:%d:%s()\n", \
388 #expr, __FILE__, __LINE__, __FUNCTION__); \
390 } while (0)
391 #else
392 #define assert(expr) do { /* nothing */ } while (0)
393 #endif
395 /* rate limited printk(). */
396 #ifdef printkl
397 # undef printkl
398 #endif
399 #define printkl(f, x...) do { if (printk_ratelimit()) printk(f ,##x); } while (0)
400 /* rate limited printk() for debugging */
401 #ifdef dprintkl
402 # undef dprintkl
403 #endif
404 #ifdef CONFIG_BCM43XX_DEBUG
405 # define dprintkl printkl
406 #else
407 # define dprintkl(f, x...) do { /* nothing */ } while (0)
408 #endif
410 /* Helper macro for if branches.
411 * An if branch marked with this macro is only taken in DEBUG mode.
412 * Example:
413 * if (DEBUG_ONLY(foo == bar)) {
414 * do something
416 * In DEBUG mode, the branch will be taken if (foo == bar).
417 * In non-DEBUG mode, the branch will never be taken.
419 #ifdef DEBUG_ONLY
420 # undef DEBUG_ONLY
421 #endif
422 #ifdef CONFIG_BCM43XX_DEBUG
423 # define DEBUG_ONLY(x) (x)
424 #else
425 # define DEBUG_ONLY(x) 0
426 #endif
428 /* debugging printk() */
429 #ifdef dprintk
430 # undef dprintk
431 #endif
432 #ifdef CONFIG_BCM43XX_DEBUG
433 # define dprintk(f, x...) do { printk(f ,##x); } while (0)
434 #else
435 # define dprintk(f, x...) do { /* nothing */ } while (0)
436 #endif
439 struct net_device;
440 struct pci_dev;
441 struct bcm43xx_dmaring;
442 struct bcm43xx_pioqueue;
444 struct bcm43xx_initval {
445 u16 offset;
446 u16 size;
447 u32 value;
448 } __attribute__((__packed__));
450 /* Values for bcm430x_sprominfo.locale */
451 enum {
452 BCM43xx_LOCALE_WORLD = 0,
453 BCM43xx_LOCALE_THAILAND,
454 BCM43xx_LOCALE_ISRAEL,
455 BCM43xx_LOCALE_JORDAN,
456 BCM43xx_LOCALE_CHINA,
457 BCM43xx_LOCALE_JAPAN,
458 BCM43xx_LOCALE_USA_CANADA_ANZ,
459 BCM43xx_LOCALE_EUROPE,
460 BCM43xx_LOCALE_USA_LOW,
461 BCM43xx_LOCALE_JAPAN_HIGH,
462 BCM43xx_LOCALE_ALL,
463 BCM43xx_LOCALE_NONE,
466 #define BCM43xx_SPROM_SIZE 64 /* in 16-bit words. */
467 struct bcm43xx_sprominfo {
468 u16 boardflags2;
469 u8 il0macaddr[6];
470 u8 et0macaddr[6];
471 u8 et1macaddr[6];
472 u8 et0phyaddr:5;
473 u8 et1phyaddr:5;
474 u8 et0mdcport:1;
475 u8 et1mdcport:1;
476 u8 boardrev;
477 u8 locale:4;
478 u8 antennas_aphy:2;
479 u8 antennas_bgphy:2;
480 u16 pa0b0;
481 u16 pa0b1;
482 u16 pa0b2;
483 u8 wl0gpio0;
484 u8 wl0gpio1;
485 u8 wl0gpio2;
486 u8 wl0gpio3;
487 u8 maxpower_aphy;
488 u8 maxpower_bgphy;
489 u16 pa1b0;
490 u16 pa1b1;
491 u16 pa1b2;
492 u8 idle_tssi_tgt_aphy;
493 u8 idle_tssi_tgt_bgphy;
494 u16 boardflags;
495 u16 antennagain_aphy;
496 u16 antennagain_bgphy;
499 /* Value pair to measure the LocalOscillator. */
500 struct bcm43xx_lopair {
501 s8 low;
502 s8 high;
503 u8 used:1;
505 #define BCM43xx_LO_COUNT (14*4)
507 struct bcm43xx_phyinfo {
508 /* Hardware Data */
509 u8 version;
510 u8 type;
511 u8 rev;
512 u16 antenna_diversity;
513 u16 savedpctlreg;
514 u16 minlowsig[2];
515 u16 minlowsigpos[2];
516 u8 connected:1,
517 calibrated:1,
518 is_locked:1, /* used in bcm43xx_phy_{un}lock() */
519 dyn_tssi_tbl:1; /* used in bcm43xx_phy_init_tssi2dbm_table() */
520 /* LO Measurement Data.
521 * Use bcm43xx_get_lopair() to get a value.
523 struct bcm43xx_lopair *_lo_pairs;
525 /* TSSI to dBm table in use */
526 const s8 *tssi2dbm;
527 /* idle TSSI value */
528 s8 idle_tssi;
530 /* Values from bcm43xx_calc_loopback_gain() */
531 u16 loopback_gain[2];
533 /* PHY lock for core.rev < 3
534 * This lock is only used by bcm43xx_phy_{un}lock()
536 spinlock_t lock;
538 /* Firmware. */
539 const struct firmware *ucode;
540 const struct firmware *pcm;
541 const struct firmware *initvals0;
542 const struct firmware *initvals1;
546 struct bcm43xx_radioinfo {
547 u16 manufact;
548 u16 version;
549 u8 revision;
551 /* Desired TX power in dBm Q5.2 */
552 u16 txpower_desired;
553 /* TX Power control values. */
554 union {
555 /* B/G PHY */
556 struct {
557 u16 baseband_atten;
558 u16 radio_atten;
559 u16 txctl1;
560 u16 txctl2;
562 /* A PHY */
563 struct {
564 u16 txpwr_offset;
568 /* Current Interference Mitigation mode */
569 int interfmode;
570 /* Stack of saved values from the Interference Mitigation code.
571 * Each value in the stack is layed out as follows:
572 * bit 0-11: offset
573 * bit 12-15: register ID
574 * bit 16-32: value
575 * register ID is: 0x1 PHY, 0x2 Radio, 0x3 ILT
577 #define BCM43xx_INTERFSTACK_SIZE 26
578 u32 interfstack[BCM43xx_INTERFSTACK_SIZE];
580 /* Saved values from the NRSSI Slope calculation */
581 s16 nrssi[2];
582 s32 nrssislope;
583 /* In memory nrssi lookup table. */
584 s8 nrssi_lt[64];
586 /* current channel */
587 u8 channel;
588 u8 initial_channel;
590 u16 lofcal;
592 u16 initval;
594 u8 enabled:1;
595 /* ACI (adjacent channel interference) flags. */
596 u8 aci_enable:1,
597 aci_wlan_automatic:1,
598 aci_hw_rssi:1;
601 /* Data structures for DMA transmission, per 80211 core. */
602 struct bcm43xx_dma {
603 struct bcm43xx_dmaring *tx_ring0;
604 struct bcm43xx_dmaring *tx_ring1;
605 struct bcm43xx_dmaring *tx_ring2;
606 struct bcm43xx_dmaring *tx_ring3;
607 struct bcm43xx_dmaring *tx_ring4;
608 struct bcm43xx_dmaring *tx_ring5;
610 struct bcm43xx_dmaring *rx_ring0;
611 struct bcm43xx_dmaring *rx_ring3; /* only available on core.rev < 5 */
614 /* Data structures for PIO transmission, per 80211 core. */
615 struct bcm43xx_pio {
616 struct bcm43xx_pioqueue *queue0;
617 struct bcm43xx_pioqueue *queue1;
618 struct bcm43xx_pioqueue *queue2;
619 struct bcm43xx_pioqueue *queue3;
622 #define BCM43xx_MAX_80211_CORES 2
624 #ifdef CONFIG_BCM947XX
625 #define core_offset(bcm) (bcm)->current_core_offset
626 #else
627 #define core_offset(bcm) 0
628 #endif
630 /* Generic information about a core. */
631 struct bcm43xx_coreinfo {
632 u8 available:1,
633 enabled:1,
634 initialized:1;
635 /** core_rev revision number */
636 u8 rev;
637 /** Index number for _switch_core() */
638 u8 index;
639 /** core_id ID number */
640 u16 id;
641 /** Core-specific data. */
642 void *priv;
645 /* Additional information for each 80211 core. */
646 struct bcm43xx_coreinfo_80211 {
647 /* PHY device. */
648 struct bcm43xx_phyinfo phy;
649 /* Radio device. */
650 struct bcm43xx_radioinfo radio;
651 union {
652 /* DMA context. */
653 struct bcm43xx_dma dma;
654 /* PIO context. */
655 struct bcm43xx_pio pio;
659 /* Context information for a noise calculation (Link Quality). */
660 struct bcm43xx_noise_calculation {
661 struct bcm43xx_coreinfo *core_at_start;
662 u8 channel_at_start;
663 u8 calculation_running:1;
664 u8 nr_samples;
665 s8 samples[8][4];
668 struct bcm43xx_stats {
669 u8 link_quality;
670 u8 noise;
671 struct iw_statistics wstats;
672 /* Store the last TX/RX times here for updating the leds. */
673 unsigned long last_tx;
674 unsigned long last_rx;
677 struct bcm43xx_key {
678 u8 enabled:1;
679 u8 algorithm;
682 /* Driver initialization status. */
683 enum {
684 BCM43xx_STAT_UNINIT, /* Uninitialized. */
685 BCM43xx_STAT_INITIALIZING, /* init_board() in progress. */
686 BCM43xx_STAT_INITIALIZED, /* Fully operational. */
687 BCM43xx_STAT_SHUTTINGDOWN, /* free_board() in progress. */
688 BCM43xx_STAT_RESTARTING, /* controller_restart() called. */
690 #define bcm43xx_status(bcm) atomic_read(&(bcm)->init_status)
691 #define bcm43xx_set_status(bcm, stat) do { \
692 atomic_set(&(bcm)->init_status, (stat)); \
693 smp_wmb(); \
694 } while (0)
696 /* *** THEORY OF LOCKING ***
698 * We have two different locks in the bcm43xx driver.
699 * => bcm->mutex: General sleeping mutex. Protects struct bcm43xx_private
700 * and the device registers. This mutex does _not_ protect
701 * against concurrency from the IRQ handler.
702 * => bcm->irq_lock: IRQ spinlock. Protects against IRQ handler concurrency.
704 * Please note that, if you only take the irq_lock, you are not protected
705 * against concurrency from the periodic work handlers.
706 * Most times you want to take _both_ locks.
709 struct bcm43xx_private {
710 struct ieee80211_device *ieee;
711 struct ieee80211softmac_device *softmac;
713 struct net_device *net_dev;
714 struct pci_dev *pci_dev;
715 unsigned int irq;
717 void __iomem *mmio_addr;
719 spinlock_t irq_lock;
720 struct mutex mutex;
722 /* Driver initialization status BCM43xx_STAT_*** */
723 atomic_t init_status;
725 u16 was_initialized:1, /* for PCI suspend/resume. */
726 __using_pio:1, /* Internal, use bcm43xx_using_pio(). */
727 bad_frames_preempt:1, /* Use "Bad Frames Preemption" (default off) */
728 reg124_set_0x4:1, /* Some variable to keep track of IRQ stuff. */
729 short_preamble:1, /* TRUE, if short preamble is enabled. */
730 firmware_norelease:1; /* Do not release the firmware. Used on suspend. */
732 struct bcm43xx_stats stats;
734 /* Bus type we are connected to.
735 * This is currently always BCM43xx_BUSTYPE_PCI
737 u8 bustype;
739 u16 board_vendor;
740 u16 board_type;
741 u16 board_revision;
743 u16 chip_id;
744 u8 chip_rev;
745 u8 chip_package;
747 struct bcm43xx_sprominfo sprom;
748 #define BCM43xx_NR_LEDS 4
749 struct bcm43xx_led leds[BCM43xx_NR_LEDS];
750 spinlock_t leds_lock;
752 /* The currently active core. */
753 struct bcm43xx_coreinfo *current_core;
754 #ifdef CONFIG_BCM947XX
755 /** current core memory offset */
756 u32 current_core_offset;
757 #endif
758 struct bcm43xx_coreinfo *active_80211_core;
759 /* coreinfo structs for all possible cores follow.
760 * Note that a core might not exist.
761 * So check the coreinfo flags before using it.
763 struct bcm43xx_coreinfo core_chipcommon;
764 struct bcm43xx_coreinfo core_pci;
765 struct bcm43xx_coreinfo core_80211[ BCM43xx_MAX_80211_CORES ];
766 /* Additional information, specific to the 80211 cores. */
767 struct bcm43xx_coreinfo_80211 core_80211_ext[ BCM43xx_MAX_80211_CORES ];
768 /* Number of available 80211 cores. */
769 int nr_80211_available;
771 u32 chipcommon_capabilities;
773 /* Reason code of the last interrupt. */
774 u32 irq_reason;
775 u32 dma_reason[6];
776 /* saved irq enable/disable state bitfield. */
777 u32 irq_savedstate;
778 /* Link Quality calculation context. */
779 struct bcm43xx_noise_calculation noisecalc;
780 /* if > 0 MAC is suspended. if == 0 MAC is enabled. */
781 int mac_suspended;
783 /* Threshold values. */
784 //TODO: The RTS thr has to be _used_. Currently, it is only set via WX.
785 u32 rts_threshold;
787 /* Interrupt Service Routine tasklet (bottom-half) */
788 struct tasklet_struct isr_tasklet;
790 /* Periodic tasks */
791 struct work_struct periodic_work;
792 unsigned int periodic_state;
794 struct work_struct restart_work;
796 /* Informational stuff. */
797 char nick[IW_ESSID_MAX_SIZE + 1];
799 /* encryption/decryption */
800 u16 security_offset;
801 struct bcm43xx_key key[54];
802 u8 default_key_idx;
804 /* Random Number Generator. */
805 struct hwrng rng;
806 char rng_name[20 + 1];
808 /* Debugging stuff follows. */
809 #ifdef CONFIG_BCM43XX_DEBUG
810 struct bcm43xx_dfsentry *dfsentry;
811 #endif
815 static inline
816 struct bcm43xx_private * bcm43xx_priv(struct net_device *dev)
818 return ieee80211softmac_priv(dev);
821 struct device;
823 static inline
824 struct bcm43xx_private * dev_to_bcm(struct device *dev)
826 struct net_device *net_dev;
827 struct bcm43xx_private *bcm;
829 net_dev = dev_get_drvdata(dev);
830 bcm = bcm43xx_priv(net_dev);
832 return bcm;
836 /* Helper function, which returns a boolean.
837 * TRUE, if PIO is used; FALSE, if DMA is used.
839 #if defined(CONFIG_BCM43XX_DMA) && defined(CONFIG_BCM43XX_PIO)
840 static inline
841 int bcm43xx_using_pio(struct bcm43xx_private *bcm)
843 return bcm->__using_pio;
845 #elif defined(CONFIG_BCM43XX_DMA)
846 static inline
847 int bcm43xx_using_pio(struct bcm43xx_private *bcm)
849 return 0;
851 #elif defined(CONFIG_BCM43XX_PIO)
852 static inline
853 int bcm43xx_using_pio(struct bcm43xx_private *bcm)
855 return 1;
857 #else
858 # error "Using neither DMA nor PIO? Confused..."
859 #endif
861 /* Helper functions to access data structures private to the 80211 cores.
862 * Note that we _must_ have an 80211 core mapped when calling
863 * any of these functions.
865 static inline
866 struct bcm43xx_coreinfo_80211 *
867 bcm43xx_current_80211_priv(struct bcm43xx_private *bcm)
869 assert(bcm->current_core->id == BCM43xx_COREID_80211);
870 return bcm->current_core->priv;
872 static inline
873 struct bcm43xx_pio * bcm43xx_current_pio(struct bcm43xx_private *bcm)
875 assert(bcm43xx_using_pio(bcm));
876 return &(bcm43xx_current_80211_priv(bcm)->pio);
878 static inline
879 struct bcm43xx_dma * bcm43xx_current_dma(struct bcm43xx_private *bcm)
881 assert(!bcm43xx_using_pio(bcm));
882 return &(bcm43xx_current_80211_priv(bcm)->dma);
884 static inline
885 struct bcm43xx_phyinfo * bcm43xx_current_phy(struct bcm43xx_private *bcm)
887 return &(bcm43xx_current_80211_priv(bcm)->phy);
889 static inline
890 struct bcm43xx_radioinfo * bcm43xx_current_radio(struct bcm43xx_private *bcm)
892 return &(bcm43xx_current_80211_priv(bcm)->radio);
896 static inline
897 struct bcm43xx_lopair * bcm43xx_get_lopair(struct bcm43xx_phyinfo *phy,
898 u16 radio_attenuation,
899 u16 baseband_attenuation)
901 return phy->_lo_pairs + (radio_attenuation + 14 * (baseband_attenuation / 2));
905 static inline
906 u16 bcm43xx_read16(struct bcm43xx_private *bcm, u16 offset)
908 return ioread16(bcm->mmio_addr + core_offset(bcm) + offset);
911 static inline
912 void bcm43xx_write16(struct bcm43xx_private *bcm, u16 offset, u16 value)
914 iowrite16(value, bcm->mmio_addr + core_offset(bcm) + offset);
917 static inline
918 u32 bcm43xx_read32(struct bcm43xx_private *bcm, u16 offset)
920 return ioread32(bcm->mmio_addr + core_offset(bcm) + offset);
923 static inline
924 void bcm43xx_write32(struct bcm43xx_private *bcm, u16 offset, u32 value)
926 iowrite32(value, bcm->mmio_addr + core_offset(bcm) + offset);
929 static inline
930 int bcm43xx_pci_read_config16(struct bcm43xx_private *bcm, int offset, u16 *value)
932 return pci_read_config_word(bcm->pci_dev, offset, value);
935 static inline
936 int bcm43xx_pci_read_config32(struct bcm43xx_private *bcm, int offset, u32 *value)
938 return pci_read_config_dword(bcm->pci_dev, offset, value);
941 static inline
942 int bcm43xx_pci_write_config16(struct bcm43xx_private *bcm, int offset, u16 value)
944 return pci_write_config_word(bcm->pci_dev, offset, value);
947 static inline
948 int bcm43xx_pci_write_config32(struct bcm43xx_private *bcm, int offset, u32 value)
950 return pci_write_config_dword(bcm->pci_dev, offset, value);
953 /** Limit a value between two limits */
954 #ifdef limit_value
955 # undef limit_value
956 #endif
957 #define limit_value(value, min, max) \
958 ({ \
959 typeof(value) __value = (value); \
960 typeof(value) __min = (min); \
961 typeof(value) __max = (max); \
962 if (__value < __min) \
963 __value = __min; \
964 else if (__value > __max) \
965 __value = __max; \
966 __value; \
969 /** Helpers to print MAC addresses. */
970 #define BCM43xx_MACFMT "%02x:%02x:%02x:%02x:%02x:%02x"
971 #define BCM43xx_MACARG(x) ((u8*)(x))[0], ((u8*)(x))[1], \
972 ((u8*)(x))[2], ((u8*)(x))[3], \
973 ((u8*)(x))[4], ((u8*)(x))[5]
975 #endif /* BCM43xx_H_ */