2 * Copyright (c) 2010 Broadcom Corporation
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
11 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
13 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
14 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
28 * One doesn't need to include this file explicitly, gets included automatically if
29 * typedefs.h is included.
32 /* Use BCM_REFERENCE to suppress warnings about intentionally-unused function
33 * arguments or local variables.
35 #define BCM_REFERENCE(data) ((void)data)
37 /* Reclaiming text and data :
38 * The following macros specify special linker sections that can be reclaimed
39 * after a system is considered 'up'.
40 * BCMATTACHFN is also used for detach functions (it's not worth having a BCMDETACHFN,
41 * as in most cases, the attach function calls the detach function to clean up on error).
44 #define bcmreclaimed 0
45 #define BCMATTACHDATA(_data) _data
46 #define BCMATTACHFN(_fn) _fn
47 #define BCMPREATTACHDATA(_data) _data
48 #define BCMPREATTACHFN(_fn) _fn
49 #define BCMINITDATA(_data) _data
50 #define BCMINITFN(_fn) _fn
51 #define BCMUNINITFN(_fn) _fn
52 #define BCMNMIATTACHFN(_fn) _fn
53 #define BCMNMIATTACHDATA(_data) _data
54 #define BCMOVERLAY0DATA(_sym) _sym
55 #define BCMOVERLAY0FN(_fn) _fn
56 #define BCMOVERLAY1DATA(_sym) _sym
57 #define BCMOVERLAY1FN(_fn) _fn
58 #define BCMOVERLAYERRFN(_fn) _fn
61 #define BCMFASTPATH __attribute__ ((__section__(".text.fastpath")))
66 /* Put some library data/code into ROM to reduce RAM requirements */
67 #define BCMROMDATA(_data) _data
68 #define BCMROMDAT_NAME(_data) _data
69 #define BCMROMFN(_fn) _fn
70 #define BCMROMFN_NAME(_fn) _fn
72 #define BCMROMDAT_ARYSIZ(data) ARRAYSIZE(data)
73 #define BCMROMDAT_SIZEOF(data) sizeof(data)
74 #define BCMROMDAT_APATCH(data)
75 #define BCMROMDAT_SPATCH(data)
78 #define SI_BUS 0 /* SOC Interconnect */
79 #define PCI_BUS 1 /* PCI target */
80 #define SDIO_BUS 3 /* SDIO target */
81 #define JTAG_BUS 4 /* JTAG */
82 #define USB_BUS 5 /* USB (does not support R/W REG) */
83 #define SPI_BUS 6 /* gSPI target */
84 #define RPC_BUS 7 /* RPC target */
86 /* Allows size optimization for single-bus image */
88 #define BUSTYPE(bus) (BCMBUSTYPE)
90 #define BUSTYPE(bus) (bus)
93 /* Allows size optimization for single-backplane image */
95 #define CHIPTYPE(bus) (BCMCHIPTYPE)
97 #define CHIPTYPE(bus) (bus)
100 /* Allows size optimization for SPROM support */
101 #define SPROMBUS (PCI_BUS)
103 /* Allows size optimization for single-chip image */
105 #define CHIPID(chip) (BCMCHIPID)
107 #define CHIPID(chip) (chip)
111 #define CHIPREV(rev) (BCMCHIPREV)
113 #define CHIPREV(rev) (rev)
116 /* Defines for DMA Address Width - Shared between OSL and HNDDMA */
117 #define DMADDR_MASK_32 0x0 /* Address mask for 32-bits */
118 #define DMADDR_MASK_30 0xc0000000 /* Address mask for 30-bits */
119 #define DMADDR_MASK_0 0xffffffff /* Address mask for 0-bits (hi-part) */
121 #define DMADDRWIDTH_30 30 /* 30-bit addressing capability */
122 #define DMADDRWIDTH_32 32 /* 32-bit addressing capability */
123 #define DMADDRWIDTH_63 63 /* 64-bit addressing capability */
124 #define DMADDRWIDTH_64 64 /* 64-bit addressing capability */
132 typedef dma64addr_t dmaaddr_t;
133 #define PHYSADDRHI(_pa) ((_pa).hiaddr)
134 #define PHYSADDRHISET(_pa, _val) \
136 (_pa).hiaddr = (_val); \
138 #define PHYSADDRLO(_pa) ((_pa).loaddr)
139 #define PHYSADDRLOSET(_pa, _val) \
141 (_pa).loaddr = (_val); \
145 typedef unsigned long dmaaddr_t;
146 #define PHYSADDRHI(_pa) (0)
147 #define PHYSADDRHISET(_pa, _val)
148 #define PHYSADDRLO(_pa) ((_pa))
149 #define PHYSADDRLOSET(_pa, _val) \
153 #endif /* BCMDMA64OSL */
155 /* One physical DMA segment */
161 #define MAX_DMA_SEGS 4
164 void *oshdmah; /* Opaque handle for OSL to store its information */
165 uint origsize; /* Size of the virtual packet */
167 hnddma_seg_t segs[MAX_DMA_SEGS];
170 /* packet headroom necessary to accommodate the largest header in the system, (i.e TXOFF).
171 * By doing, we avoid the need to allocate an extra buffer for the header when bridging to WL.
172 * There is a compile time check in wlc.c which ensure that this value is at least as big
173 * as TXOFF. This value is used in dma_rxfill (hnddma.c).
176 #define BCMEXTRAHDROOM 172
178 /* Headroom required for dongle-to-host communication. Packets allocated
179 * locally in the dongle (e.g. for CDC ioctls or RNDIS messages) should
180 * leave this much room in front for low-level message headers which may
181 * be needed to get across the dongle bus to the host. (These messages
182 * don't go over the network, so room for the full WL header above would
185 #define BCMDONGLEHDRSZ 12
186 #define BCMDONGLEPADSZ 16
188 #define BCMDONGLEOVERHEAD (BCMDONGLEHDRSZ + BCMDONGLEPADSZ)
194 #ifndef BCMDBG_ASSERT
195 #define BCMDBG_ASSERT
196 #endif /* BCMDBG_ASSERT */
200 #if defined(BCMDBG_ASSERT)
201 #define BCMASSERT_SUPPORT
204 /* Macros for doing definition and get/set of bitfields
205 * Usage example, e.g. a three-bit field (bits 4-6):
206 * #define <NAME>_M BITFIELD_MASK(3)
209 * regval = R_REG(osh, ®s->regfoo);
210 * field = GFIELD(regval, <NAME>);
211 * regval = SFIELD(regval, <NAME>, 1);
212 * W_REG(osh, ®s->regfoo, regval);
214 #define BITFIELD_MASK(width) \
215 (((unsigned)1 << (width)) - 1)
216 #define GFIELD(val, field) \
217 (((val) >> field ## _S) & field ## _M)
218 #define SFIELD(val, field, bits) \
219 (((val) & (~(field ## _M << field ## _S))) | \
220 ((unsigned)(bits) << field ## _S))
222 /* define BCMSMALL to remove misc features for memory-constrained environments */
224 #define bcmspace TRUE /* if (bcmspace) code is retained */
226 /* Max. nvram variable table size */
227 #define MAXSZ_NVRAM_VARS 4096
229 #define LOCATOR_EXTERN static
231 #endif /* _bcmdefs_h_ */