PageRenderTime 32ms CodeModel.GetById 16ms app.highlight 12ms RepoModel.GetById 1ms app.codeStats 1ms

/drivers/net/wireless/brcm80211/brcmsmac/pub.h

http://github.com/mirrors/linux
C++ Header | 348 lines | 218 code | 38 blank | 92 comment | 0 complexity | 3dad83a121377ce86ba3d4e03165d759 MD5 | raw file
  1/*
  2 * Copyright (c) 2010 Broadcom Corporation
  3 *
  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.
  7 *
  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.
 15 */
 16
 17#ifndef _BRCM_PUB_H_
 18#define _BRCM_PUB_H_
 19
 20#include <linux/bcma/bcma.h>
 21#include <brcmu_wifi.h>
 22#include "types.h"
 23#include "defs.h"
 24
 25#define	BRCMS_NUMRATES	16	/* max # of rates in a rateset */
 26
 27/* phy types */
 28#define	PHY_TYPE_A	0	/* Phy type A */
 29#define	PHY_TYPE_G	2	/* Phy type G */
 30#define	PHY_TYPE_N	4	/* Phy type N */
 31#define	PHY_TYPE_LP	5	/* Phy type Low Power A/B/G */
 32#define	PHY_TYPE_SSN	6	/* Phy type Single Stream N */
 33#define	PHY_TYPE_LCN	8	/* Phy type Single Stream N */
 34#define	PHY_TYPE_LCNXN	9	/* Phy type 2-stream N */
 35#define	PHY_TYPE_HT	7	/* Phy type 3-Stream N */
 36
 37/* bw */
 38#define BRCMS_10_MHZ	10	/* 10Mhz nphy channel bandwidth */
 39#define BRCMS_20_MHZ	20	/* 20Mhz nphy channel bandwidth */
 40#define BRCMS_40_MHZ	40	/* 40Mhz nphy channel bandwidth */
 41
 42#define	BRCMS_RSSI_MINVAL	-200	/* Low value, e.g. for forcing roam */
 43#define	BRCMS_RSSI_NO_SIGNAL	-91	/* NDIS RSSI link quality cutoffs */
 44#define	BRCMS_RSSI_VERY_LOW	-80	/* Very low quality cutoffs */
 45#define	BRCMS_RSSI_LOW		-70	/* Low quality cutoffs */
 46#define	BRCMS_RSSI_GOOD		-68	/* Good quality cutoffs */
 47#define	BRCMS_RSSI_VERY_GOOD	-58	/* Very good quality cutoffs */
 48#define	BRCMS_RSSI_EXCELLENT	-57	/* Excellent quality cutoffs */
 49
 50/* a large TX Power as an init value to factor out of min() calculations,
 51 * keep low enough to fit in an s8, units are .25 dBm
 52 */
 53#define BRCMS_TXPWR_MAX		(127)	/* ~32 dBm = 1,500 mW */
 54
 55/* rate related definitions */
 56#define	BRCMS_RATE_FLAG	0x80	/* Flag to indicate it is a basic rate */
 57#define	BRCMS_RATE_MASK	0x7f	/* Rate value mask w/o basic rate flag */
 58
 59/* legacy rx Antenna diversity for SISO rates */
 60#define	ANT_RX_DIV_FORCE_0	0	/* Use antenna 0 */
 61#define	ANT_RX_DIV_FORCE_1	1	/* Use antenna 1 */
 62#define	ANT_RX_DIV_START_1	2	/* Choose starting with 1 */
 63#define	ANT_RX_DIV_START_0	3	/* Choose starting with 0 */
 64#define	ANT_RX_DIV_ENABLE	3	/* APHY bbConfig Enable RX Diversity */
 65/* default antdiv setting */
 66#define ANT_RX_DIV_DEF		ANT_RX_DIV_START_0
 67
 68/* legacy rx Antenna diversity for SISO rates */
 69/* Tx on antenna 0, "legacy term Main" */
 70#define ANT_TX_FORCE_0		0
 71/* Tx on antenna 1, "legacy term Aux" */
 72#define ANT_TX_FORCE_1		1
 73/* Tx on phy's last good Rx antenna */
 74#define ANT_TX_LAST_RX		3
 75/* driver's default tx antenna setting */
 76#define ANT_TX_DEF		3
 77
 78/* Tx Chain values */
 79/* def bitmap of txchain */
 80#define TXCHAIN_DEF		0x1
 81/* default bitmap of tx chains for nphy */
 82#define TXCHAIN_DEF_NPHY	0x3
 83/* default bitmap of tx chains for nphy */
 84#define TXCHAIN_DEF_HTPHY	0x7
 85/* def bitmap of rxchain */
 86#define RXCHAIN_DEF		0x1
 87/* default bitmap of rx chains for nphy */
 88#define RXCHAIN_DEF_NPHY	0x3
 89/* default bitmap of rx chains for nphy */
 90#define RXCHAIN_DEF_HTPHY	0x7
 91/* no antenna switch */
 92#define ANTSWITCH_NONE		0
 93/* antenna switch on 4321CB2, 2of3 */
 94#define ANTSWITCH_TYPE_1	1
 95/* antenna switch on 4321MPCI, 2of3 */
 96#define ANTSWITCH_TYPE_2	2
 97/* antenna switch on 4322, 2of3 */
 98#define ANTSWITCH_TYPE_3	3
 99
100#define RXBUFSZ		PKTBUFSZ
101
102#define MAX_STREAMS_SUPPORTED	4	/* max number of streams supported */
103
104struct brcm_rateset {
105	/* # rates in this set */
106	u32 count;
107	/* rates in 500kbps units w/hi bit set if basic */
108	u8 rates[WL_NUMRATES];
109};
110
111struct brcms_c_rateset {
112	uint count;		/* number of rates in rates[] */
113	 /* rates in 500kbps units w/hi bit set if basic */
114	u8 rates[BRCMS_NUMRATES];
115	u8 htphy_membership;	/* HT PHY Membership */
116	u8 mcs[MCSSET_LEN];	/* supported mcs index bit map */
117};
118
119/* All the HT-specific default advertised capabilities (including AMPDU)
120 * should be grouped here at one place
121 */
122#define AMPDU_DEF_MPDU_DENSITY	6	/* default mpdu density (110 ==> 4us) */
123
124/* wlc internal bss_info */
125struct brcms_bss_info {
126	u8 BSSID[ETH_ALEN];	/* network BSSID */
127	u16 flags;		/* flags for internal attributes */
128	u8 SSID_len;		/* the length of SSID */
129	u8 SSID[32];		/* SSID string */
130	s16 RSSI;		/* receive signal strength (in dBm) */
131	s16 SNR;		/* receive signal SNR in dB */
132	u16 beacon_period;	/* units are Kusec */
133	u16 chanspec;	/* Channel num, bw, ctrl_sb and band */
134	struct brcms_c_rateset rateset;	/* supported rates */
135};
136
137#define MAC80211_PROMISC_BCNS	(1 << 0)
138#define MAC80211_SCAN		(1 << 1)
139
140/*
141 * Public portion of common driver state structure.
142 * The wlc handle points at this.
143 */
144struct brcms_pub {
145	struct brcms_c_info *wlc;
146	struct ieee80211_hw *ieee_hw;
147	struct scb_ampdu *global_ampdu;
148	uint mac80211_state;
149	uint unit;		/* device instance number */
150	uint corerev;		/* core revision */
151	struct si_pub *sih;	/* SI handle (cookie for siutils calls) */
152	bool up;		/* interface up and running */
153	bool hw_off;		/* HW is off */
154	bool hw_up;		/* one time hw up/down */
155	bool _piomode;		/* true if pio mode */
156	uint _nbands;		/* # bands supported */
157	uint now;		/* # elapsed seconds */
158
159	bool delayed_down;	/* down delayed */
160	bool associated;	/* true:part of [I]BSS, false: not */
161	/* (union of stas_associated, aps_associated) */
162	bool _ampdu;		/* ampdu enabled or not */
163	u8 _n_enab;		/* bitmap of 11N + HT support */
164
165	u8 cur_etheraddr[ETH_ALEN];	/* our local ethernet address */
166
167	u32 radio_disabled;	/* bit vector for radio disabled reasons */
168
169	u16 boardrev;	/* version # of particular board */
170	u8 sromrev;		/* version # of the srom */
171	char srom_ccode[BRCM_CNTRY_BUF_SZ];	/* Country Code in SROM */
172	u32 boardflags;	/* Board specific flags from srom */
173	u32 boardflags2;	/* More board flags if sromrev >= 4 */
174	bool phy_11ncapable;	/* the PHY/HW is capable of 802.11N */
175
176	struct wl_cnt *_cnt;	/* low-level counters in driver */
177	struct dentry *dbgfs_dir;
178};
179
180enum wlc_par_id {
181	IOV_MPC = 1,
182	IOV_RTSTHRESH,
183	IOV_QTXPOWER,
184	IOV_BCN_LI_BCN		/* Beacon listen interval in # of beacons */
185};
186
187/***********************************************
188 * Feature-related macros to optimize out code *
189 * *********************************************
190 */
191
192#define ENAB_1x1	0x01
193#define ENAB_2x2	0x02
194#define ENAB_3x3	0x04
195#define ENAB_4x4	0x08
196#define SUPPORT_11N	(ENAB_1x1|ENAB_2x2)
197#define SUPPORT_HT	(ENAB_1x1|ENAB_2x2|ENAB_3x3)
198
199/* WL11N Support */
200#define AMPDU_AGG_HOST	1
201
202/* network protection config */
203#define	BRCMS_PROT_G_SPEC		1	/* SPEC g protection */
204#define	BRCMS_PROT_G_OVR		2	/* SPEC g prot override */
205#define	BRCMS_PROT_G_USER		3	/* gmode specified by user */
206#define	BRCMS_PROT_OVERLAP	4	/* overlap */
207#define	BRCMS_PROT_N_USER		10	/* nmode specified by user */
208#define	BRCMS_PROT_N_CFG		11	/* n protection */
209#define	BRCMS_PROT_N_CFG_OVR	12	/* n protection override */
210#define	BRCMS_PROT_N_NONGF	13	/* non-GF protection */
211#define	BRCMS_PROT_N_NONGF_OVR	14	/* non-GF protection override */
212#define	BRCMS_PROT_N_PAM_OVR	15	/* n preamble override */
213#define	BRCMS_PROT_N_OBSS		16	/* non-HT OBSS present */
214
215/*
216 * 54g modes (basic bits may still be overridden)
217 *
218 * GMODE_LEGACY_B
219 *	Rateset: 1b, 2b, 5.5, 11
220 *	Preamble: Long
221 *	Shortslot: Off
222 * GMODE_AUTO
223 *	Rateset: 1b, 2b, 5.5b, 11b, 18, 24, 36, 54
224 *	Extended Rateset: 6, 9, 12, 48
225 *	Preamble: Long
226 *	Shortslot: Auto
227 * GMODE_ONLY
228 *	Rateset: 1b, 2b, 5.5b, 11b, 18, 24b, 36, 54
229 *	Extended Rateset: 6b, 9, 12b, 48
230 *	Preamble: Short required
231 *	Shortslot: Auto
232 * GMODE_B_DEFERRED
233 *	Rateset: 1b, 2b, 5.5b, 11b, 18, 24, 36, 54
234 *	Extended Rateset: 6, 9, 12, 48
235 *	Preamble: Long
236 *	Shortslot: On
237 * GMODE_PERFORMANCE
238 *	Rateset: 1b, 2b, 5.5b, 6b, 9, 11b, 12b, 18, 24b, 36, 48, 54
239 *	Preamble: Short required
240 *	Shortslot: On and required
241 * GMODE_LRS
242 *	Rateset: 1b, 2b, 5.5b, 11b
243 *	Extended Rateset: 6, 9, 12, 18, 24, 36, 48, 54
244 *	Preamble: Long
245 *	Shortslot: Auto
246 */
247#define GMODE_LEGACY_B		0
248#define GMODE_AUTO		1
249#define GMODE_ONLY		2
250#define GMODE_B_DEFERRED	3
251#define GMODE_PERFORMANCE	4
252#define GMODE_LRS		5
253#define GMODE_MAX		6
254
255/* MCS values greater than this enable multiple streams */
256#define HIGHEST_SINGLE_STREAM_MCS	7
257
258#define	MAXBANDS		2	/* Maximum #of bands */
259
260/* max number of antenna configurations */
261#define ANT_SELCFG_MAX		4
262
263struct brcms_antselcfg {
264	u8 ant_config[ANT_SELCFG_MAX];	/* antenna configuration */
265	u8 num_antcfg;	/* number of available antenna configurations */
266};
267
268/* common functions for every port */
269extern struct brcms_c_info *
270brcms_c_attach(struct brcms_info *wl, struct bcma_device *core, uint unit,
271	       bool piomode, uint *perr);
272extern uint brcms_c_detach(struct brcms_c_info *wlc);
273extern int brcms_c_up(struct brcms_c_info *wlc);
274extern uint brcms_c_down(struct brcms_c_info *wlc);
275
276extern bool brcms_c_chipmatch(struct bcma_device *core);
277extern void brcms_c_init(struct brcms_c_info *wlc, bool mute_tx);
278extern void brcms_c_reset(struct brcms_c_info *wlc);
279
280extern void brcms_c_intrson(struct brcms_c_info *wlc);
281extern u32 brcms_c_intrsoff(struct brcms_c_info *wlc);
282extern void brcms_c_intrsrestore(struct brcms_c_info *wlc, u32 macintmask);
283extern bool brcms_c_intrsupd(struct brcms_c_info *wlc);
284extern bool brcms_c_isr(struct brcms_c_info *wlc);
285extern bool brcms_c_dpc(struct brcms_c_info *wlc, bool bounded);
286extern bool brcms_c_sendpkt_mac80211(struct brcms_c_info *wlc,
287				     struct sk_buff *sdu,
288				     struct ieee80211_hw *hw);
289extern bool brcms_c_aggregatable(struct brcms_c_info *wlc, u8 tid);
290extern void brcms_c_protection_upd(struct brcms_c_info *wlc, uint idx,
291				   int val);
292extern int brcms_c_get_header_len(void);
293extern void brcms_c_set_addrmatch(struct brcms_c_info *wlc,
294				  int match_reg_offset,
295				  const u8 *addr);
296extern void brcms_c_wme_setparams(struct brcms_c_info *wlc, u16 aci,
297			      const struct ieee80211_tx_queue_params *arg,
298			      bool suspend);
299extern struct brcms_pub *brcms_c_pub(struct brcms_c_info *wlc);
300extern void brcms_c_ampdu_flush(struct brcms_c_info *wlc,
301			    struct ieee80211_sta *sta, u16 tid);
302extern void brcms_c_ampdu_tx_operational(struct brcms_c_info *wlc, u8 tid,
303					 u8 ba_wsize, uint max_rx_ampdu_bytes);
304extern int brcms_c_module_register(struct brcms_pub *pub,
305				   const char *name, struct brcms_info *hdl,
306				   int (*down_fn)(void *handle));
307extern int brcms_c_module_unregister(struct brcms_pub *pub, const char *name,
308				     struct brcms_info *hdl);
309extern void brcms_c_suspend_mac_and_wait(struct brcms_c_info *wlc);
310extern void brcms_c_enable_mac(struct brcms_c_info *wlc);
311extern void brcms_c_associate_upd(struct brcms_c_info *wlc, bool state);
312extern void brcms_c_scan_start(struct brcms_c_info *wlc);
313extern void brcms_c_scan_stop(struct brcms_c_info *wlc);
314extern int brcms_c_get_curband(struct brcms_c_info *wlc);
315extern int brcms_c_set_channel(struct brcms_c_info *wlc, u16 channel);
316extern int brcms_c_set_rate_limit(struct brcms_c_info *wlc, u16 srl, u16 lrl);
317extern void brcms_c_get_current_rateset(struct brcms_c_info *wlc,
318				 struct brcm_rateset *currs);
319extern int brcms_c_set_rateset(struct brcms_c_info *wlc,
320					struct brcm_rateset *rs);
321extern int brcms_c_set_beacon_period(struct brcms_c_info *wlc, u16 period);
322extern u16 brcms_c_get_phy_type(struct brcms_c_info *wlc, int phyidx);
323extern void brcms_c_set_shortslot_override(struct brcms_c_info *wlc,
324				    s8 sslot_override);
325extern void brcms_c_set_beacon_listen_interval(struct brcms_c_info *wlc,
326					u8 interval);
327extern u64 brcms_c_tsf_get(struct brcms_c_info *wlc);
328extern void brcms_c_tsf_set(struct brcms_c_info *wlc, u64 tsf);
329extern int brcms_c_set_tx_power(struct brcms_c_info *wlc, int txpwr);
330extern int brcms_c_get_tx_power(struct brcms_c_info *wlc);
331extern bool brcms_c_check_radio_disabled(struct brcms_c_info *wlc);
332extern void brcms_c_mute(struct brcms_c_info *wlc, bool on);
333extern bool brcms_c_tx_flush_completed(struct brcms_c_info *wlc);
334extern void brcms_c_start_station(struct brcms_c_info *wlc, u8 *addr);
335extern void brcms_c_start_ap(struct brcms_c_info *wlc, u8 *addr,
336			     const u8 *bssid, u8 *ssid, size_t ssid_len);
337extern void brcms_c_start_adhoc(struct brcms_c_info *wlc, u8 *addr);
338extern void brcms_c_update_beacon(struct brcms_c_info *wlc);
339extern void brcms_c_set_new_beacon(struct brcms_c_info *wlc,
340				   struct sk_buff *beacon, u16 tim_offset,
341				   u16 dtim_period);
342extern void brcms_c_set_new_probe_resp(struct brcms_c_info *wlc,
343				       struct sk_buff *probe_resp);
344extern void brcms_c_enable_probe_resp(struct brcms_c_info *wlc, bool enable);
345extern void brcms_c_set_ssid(struct brcms_c_info *wlc, u8 *ssid,
346			     size_t ssid_len);
347
348#endif				/* _BRCM_PUB_H_ */