path: root/drivers/net/wireless/brcm80211/brcmsmac/pub.h

/*
 * Copyright (c) 2010 Broadcom Corporation
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef _BRCM_PUB_H_
#define _BRCM_PUB_H_

#include <brcmu_wifi.h>
#include "types.h"
#include "defs.h"

enum brcms_srom_id {
	BRCMS_SROM_NULL,
	BRCMS_SROM_CONT,
	BRCMS_SROM_AA2G,
	BRCMS_SROM_AA5G,
	BRCMS_SROM_AG0,
	BRCMS_SROM_AG1,
	BRCMS_SROM_AG2,
	BRCMS_SROM_AG3,
	BRCMS_SROM_ANTSWCTL2G,
	BRCMS_SROM_ANTSWCTL5G,
	BRCMS_SROM_ANTSWITCH,
	BRCMS_SROM_BOARDFLAGS2,
	BRCMS_SROM_BOARDFLAGS,
	BRCMS_SROM_BOARDNUM,
	BRCMS_SROM_BOARDREV,
	BRCMS_SROM_BOARDTYPE,
	BRCMS_SROM_BW40PO,
	BRCMS_SROM_BWDUPPO,
	BRCMS_SROM_BXA2G,
	BRCMS_SROM_BXA5G,
	BRCMS_SROM_CC,
	BRCMS_SROM_CCK2GPO,
	BRCMS_SROM_CCKBW202GPO,
	BRCMS_SROM_CCKBW20UL2GPO,
	BRCMS_SROM_CCODE,
	BRCMS_SROM_CDDPO,
	BRCMS_SROM_DEVID,
	BRCMS_SROM_ET1MACADDR,
	BRCMS_SROM_EXTPAGAIN2G,
	BRCMS_SROM_EXTPAGAIN5G,
	BRCMS_SROM_FREQOFFSET_CORR,
	BRCMS_SROM_HW_IQCAL_EN,
	BRCMS_SROM_IL0MACADDR,
	BRCMS_SROM_IQCAL_SWP_DIS,
	BRCMS_SROM_LEDBH0,
	BRCMS_SROM_LEDBH1,
	BRCMS_SROM_LEDBH2,
	BRCMS_SROM_LEDBH3,
	BRCMS_SROM_LEDDC,
	BRCMS_SROM_LEGOFDM40DUPPO,
	BRCMS_SROM_LEGOFDMBW202GPO,
	BRCMS_SROM_LEGOFDMBW205GHPO,
	BRCMS_SROM_LEGOFDMBW205GLPO,
	BRCMS_SROM_LEGOFDMBW205GMPO,
	BRCMS_SROM_LEGOFDMBW20UL2GPO,
	BRCMS_SROM_LEGOFDMBW20UL5GHPO,
	BRCMS_SROM_LEGOFDMBW20UL5GLPO,
	BRCMS_SROM_LEGOFDMBW20UL5GMPO,
	BRCMS_SROM_MACADDR,
	BRCMS_SROM_MCS2GPO0,
	BRCMS_SROM_MCS2GPO1,
	BRCMS_SROM_MCS2GPO2,
	BRCMS_SROM_MCS2GPO3,
	BRCMS_SROM_MCS2GPO4,
	BRCMS_SROM_MCS2GPO5,
	BRCMS_SROM_MCS2GPO6,
	BRCMS_SROM_MCS2GPO7,
	BRCMS_SROM_MCS32PO,
	BRCMS_SROM_MCS5GHPO0,
	BRCMS_SROM_MCS5GHPO1,
	BRCMS_SROM_MCS5GHPO2,
	BRCMS_SROM_MCS5GHPO3,
	BRCMS_SROM_MCS5GHPO4,
	BRCMS_SROM_MCS5GHPO5,
	BRCMS_SROM_MCS5GHPO6,
	BRCMS_SROM_MCS5GHPO7,
	BRCMS_SROM_MCS5GLPO0,
	BRCMS_SROM_MCS5GLPO1,
	BRCMS_SROM_MCS5GLPO2,
	BRCMS_SROM_MCS5GLPO3,
	BRCMS_SROM_MCS5GLPO4,
	BRCMS_SROM_MCS5GLPO5,
	BRCMS_SROM_MCS5GLPO6,
	BRCMS_SROM_MCS5GLPO7,
	BRCMS_SROM_MCS5GPO0,
	BRCMS_SROM_MCS5GPO1,
	BRCMS_SROM_MCS5GPO2,
	BRCMS_SROM_MCS5GPO3,
	BRCMS_SROM_MCS5GPO4,
	BRCMS_SROM_MCS5GPO5,
	BRCMS_SROM_MCS5GPO6,
	BRCMS_SROM_MCS5GPO7,
	BRCMS_SROM_MCSBW202GPO,
	BRCMS_SROM_MCSBW205GHPO,
	BRCMS_SROM_MCSBW205GLPO,
	BRCMS_SROM_MCSBW205GMPO,
	BRCMS_SROM_MCSBW20UL2GPO,
	BRCMS_SROM_MCSBW20UL5GHPO,
	BRCMS_SROM_MCSBW20UL5GLPO,
	BRCMS_SROM_MCSBW20UL5GMPO,
	BRCMS_SROM_MCSBW402GPO,
	BRCMS_SROM_MCSBW405GHPO,
	BRCMS_SROM_MCSBW405GLPO,
	BRCMS_SROM_MCSBW405GMPO,
	BRCMS_SROM_MEASPOWER,
	BRCMS_SROM_OFDM2GPO,
	BRCMS_SROM_OFDM5GHPO,
	BRCMS_SROM_OFDM5GLPO,
	BRCMS_SROM_OFDM5GPO,
	BRCMS_SROM_OPO,
	BRCMS_SROM_PA0B0,
	BRCMS_SROM_PA0B1,
	BRCMS_SROM_PA0B2,
	BRCMS_SROM_PA0ITSSIT,
	BRCMS_SROM_PA0MAXPWR,
	BRCMS_SROM_PA1B0,
	BRCMS_SROM_PA1B1,
	BRCMS_SROM_PA1B2,
	BRCMS_SROM_PA1HIB0,
	BRCMS_SROM_PA1HIB1,
	BRCMS_SROM_PA1HIB2,
	BRCMS_SROM_PA1HIMAXPWR,
	BRCMS_SROM_PA1ITSSIT,
	BRCMS_SROM_PA1LOB0,
	BRCMS_SROM_PA1LOB1,
	BRCMS_SROM_PA1LOB2,
	BRCMS_SROM_PA1LOMAXPWR,
	BRCMS_SROM_PA1MAXPWR,
	BRCMS_SROM_PDETRANGE2G,
	BRCMS_SROM_PDETRANGE5G,
	BRCMS_SROM_PHYCAL_TEMPDELTA,
	BRCMS_SROM_RAWTEMPSENSE,
	BRCMS_SROM_REGREV,
	BRCMS_SROM_REV,
	BRCMS_SROM_RSSISAV2G,
	BRCMS_SROM_RSSISAV5G,
	BRCMS_SROM_RSSISMC2G,
	BRCMS_SROM_RSSISMC5G,
	BRCMS_SROM_RSSISMF2G,
	BRCMS_SROM_RSSISMF5G,
	BRCMS_SROM_RXCHAIN,
	BRCMS_SROM_RXPO2G,
	BRCMS_SROM_RXPO5G,
	BRCMS_SROM_STBCPO,
	BRCMS_SROM_TEMPCORRX,
	BRCMS_SROM_TEMPOFFSET,
	BRCMS_SROM_TEMPSENSE_OPTION,
	BRCMS_SROM_TEMPSENSE_SLOPE,
	BRCMS_SROM_TEMPTHRESH,
	BRCMS_SROM_TRI2G,
	BRCMS_SROM_TRI5GH,
	BRCMS_SROM_TRI5GL,
	BRCMS_SROM_TRI5G,
	BRCMS_SROM_TRISO2G,
	BRCMS_SROM_TRISO5G,
	BRCMS_SROM_TSSIPOS2G,
	BRCMS_SROM_TSSIPOS5G,
	BRCMS_SROM_TXCHAIN,
	/*
	 * per-path identifiers (see srom.c)
	 */
	BRCMS_SROM_ITT2GA0,
	BRCMS_SROM_ITT2GA1,
	BRCMS_SROM_ITT2GA2,
	BRCMS_SROM_ITT2GA3,
	BRCMS_SROM_ITT5GA0,
	BRCMS_SROM_ITT5GA1,
	BRCMS_SROM_ITT5GA2,
	BRCMS_SROM_ITT5GA3,
	BRCMS_SROM_MAXP2GA0,
	BRCMS_SROM_MAXP2GA1,
	BRCMS_SROM_MAXP2GA2,
	BRCMS_SROM_MAXP2GA3,
	BRCMS_SROM_MAXP5GA0,
	BRCMS_SROM_MAXP5GA1,
	BRCMS_SROM_MAXP5GA2,
	BRCMS_SROM_MAXP5GA3,
	BRCMS_SROM_MAXP5GHA0,
	BRCMS_SROM_MAXP5GHA1,
	BRCMS_SROM_MAXP5GHA2,
	BRCMS_SROM_MAXP5GHA3,
	BRCMS_SROM_MAXP5GLA0,
	BRCMS_SROM_MAXP5GLA1,
	BRCMS_SROM_MAXP5GLA2,
	BRCMS_SROM_MAXP5GLA3,
	BRCMS_SROM_PA2GW0A0,
	BRCMS_SROM_PA2GW0A1,
	BRCMS_SROM_PA2GW0A2,
	BRCMS_SROM_PA2GW0A3,
	BRCMS_SROM_PA2GW1A0,
	BRCMS_SROM_PA2GW1A1,
	BRCMS_SROM_PA2GW1A2,
	BRCMS_SROM_PA2GW1A3,
	BRCMS_SROM_PA2GW2A0,
	BRCMS_SROM_PA2GW2A1,
	BRCMS_SROM_PA2GW2A2,
	BRCMS_SROM_PA2GW2A3,
	BRCMS_SROM_PA5GHW0A0,
	BRCMS_SROM_PA5GHW0A1,
	BRCMS_SROM_PA5GHW0A2,
	BRCMS_SROM_PA5GHW0A3,
	BRCMS_SROM_PA5GHW1A0,
	BRCMS_SROM_PA5GHW1A1,
	BRCMS_SROM_PA5GHW1A2,
	BRCMS_SROM_PA5GHW1A3,
	BRCMS_SROM_PA5GHW2A0,
	BRCMS_SROM_PA5GHW2A1,
	BRCMS_SROM_PA5GHW2A2,
	BRCMS_SROM_PA5GHW2A3,
	BRCMS_SROM_PA5GLW0A0,
	BRCMS_SROM_PA5GLW0A1,
	BRCMS_SROM_PA5GLW0A2,
	BRCMS_SROM_PA5GLW0A3,
	BRCMS_SROM_PA5GLW1A0,
	BRCMS_SROM_PA5GLW1A1,
	BRCMS_SROM_PA5GLW1A2,
	BRCMS_SROM_PA5GLW1A3,
	BRCMS_SROM_PA5GLW2A0,
	BRCMS_SROM_PA5GLW2A1,
	BRCMS_SROM_PA5GLW2A2,
	BRCMS_SROM_PA5GLW2A3,
	BRCMS_SROM_PA5GW0A0,
	BRCMS_SROM_PA5GW0A1,
	BRCMS_SROM_PA5GW0A2,
	BRCMS_SROM_PA5GW0A3,
	BRCMS_SROM_PA5GW1A0,
	BRCMS_SROM_PA5GW1A1,
	BRCMS_SROM_PA5GW1A2,
	BRCMS_SROM_PA5GW1A3,
	BRCMS_SROM_PA5GW2A0,
	BRCMS_SROM_PA5GW2A1,
	BRCMS_SROM_PA5GW2A2,
	BRCMS_SROM_PA5GW2A3,
};

#define	BRCMS_NUMRATES	16	/* max # of rates in a rateset */
#define	D11_PHY_HDR_LEN	6	/* Phy header length - 6 bytes */

/* phy types */
#define	PHY_TYPE_A	0	/* Phy type A */
#define	PHY_TYPE_G	2	/* Phy type G */
#define	PHY_TYPE_N	4	/* Phy type N */
#define	PHY_TYPE_LP	5	/* Phy type Low Power A/B/G */
#define	PHY_TYPE_SSN	6	/* Phy type Single Stream N */
#define	PHY_TYPE_LCN	8	/* Phy type Single Stream N */
#define	PHY_TYPE_LCNXN	9	/* Phy type 2-stream N */
#define	PHY_TYPE_HT	7	/* Phy type 3-Stream N */

/* bw */
#define BRCMS_10_MHZ	10	/* 10Mhz nphy channel bandwidth */
#define BRCMS_20_MHZ	20	/* 20Mhz nphy channel bandwidth */
#define BRCMS_40_MHZ	40	/* 40Mhz nphy channel bandwidth */

#define	BRCMS_RSSI_MINVAL	-200	/* Low value, e.g. for forcing roam */
#define	BRCMS_RSSI_NO_SIGNAL	-91	/* NDIS RSSI link quality cutoffs */
#define	BRCMS_RSSI_VERY_LOW	-80	/* Very low quality cutoffs */
#define	BRCMS_RSSI_LOW		-70	/* Low quality cutoffs */
#define	BRCMS_RSSI_GOOD		-68	/* Good quality cutoffs */
#define	BRCMS_RSSI_VERY_GOOD	-58	/* Very good quality cutoffs */
#define	BRCMS_RSSI_EXCELLENT	-57	/* Excellent quality cutoffs */

/* a large TX Power as an init value to factor out of min() calculations,
 * keep low enough to fit in an s8, units are .25 dBm
 */
#define BRCMS_TXPWR_MAX		(127)	/* ~32 dBm = 1,500 mW */

/* rate related definitions */
#define	BRCMS_RATE_FLAG	0x80	/* Flag to indicate it is a basic rate */
#define	BRCMS_RATE_MASK	0x7f	/* Rate value mask w/o basic rate flag */

/* legacy rx Antenna diversity for SISO rates */
#define	ANT_RX_DIV_FORCE_0	0	/* Use antenna 0 */
#define	ANT_RX_DIV_FORCE_1	1	/* Use antenna 1 */
#define	ANT_RX_DIV_START_1	2	/* Choose starting with 1 */
#define	ANT_RX_DIV_START_0	3	/* Choose starting with 0 */
#define	ANT_RX_DIV_ENABLE	3	/* APHY bbConfig Enable RX Diversity */
/* default antdiv setting */
#define ANT_RX_DIV_DEF		ANT_RX_DIV_START_0

/* legacy rx Antenna diversity for SISO rates */
/* Tx on antenna 0, "legacy term Main" */
#define ANT_TX_FORCE_0		0
/* Tx on antenna 1, "legacy term Aux" */
#define ANT_TX_FORCE_1		1
/* Tx on phy's last good Rx antenna */
#define ANT_TX_LAST_RX		3
/* driver's default tx antenna setting */
#define ANT_TX_DEF		3

/* Tx Chain values */
/* def bitmap of txchain */
#define TXCHAIN_DEF		0x1
/* default bitmap of tx chains for nphy */
#define TXCHAIN_DEF_NPHY	0x3
/* default bitmap of tx chains for nphy */
#define TXCHAIN_DEF_HTPHY	0x7
/* def bitmap of rxchain */
#define RXCHAIN_DEF		0x1
/* default bitmap of rx chains for nphy */
#define RXCHAIN_DEF_NPHY	0x3
/* default bitmap of rx chains for nphy */
#define RXCHAIN_DEF_HTPHY	0x7
/* no antenna switch */
#define ANTSWITCH_NONE		0
/* antenna switch on 4321CB2, 2of3 */
#define ANTSWITCH_TYPE_1	1
/* antenna switch on 4321MPCI, 2of3 */
#define ANTSWITCH_TYPE_2	2
/* antenna switch on 4322, 2of3 */
#define ANTSWITCH_TYPE_3	3

#define RXBUFSZ		PKTBUFSZ

#define MAX_STREAMS_SUPPORTED	4	/* max number of streams supported */

struct brcm_rateset {
	/* # rates in this set */
	u32 count;
	/* rates in 500kbps units w/hi bit set if basic */
	u8 rates[WL_NUMRATES];
};

struct brcms_c_rateset {
	uint count;		/* number of rates in rates[] */
	 /* rates in 500kbps units w/hi bit set if basic */
	u8 rates[BRCMS_NUMRATES];
	u8 htphy_membership;	/* HT PHY Membership */
	u8 mcs[MCSSET_LEN];	/* supported mcs index bit map */
};

/* All the HT-specific default advertised capabilities (including AMPDU)
 * should be grouped here at one place
 */
#define AMPDU_DEF_MPDU_DENSITY	6	/* default mpdu density (110 ==> 4us) */

/* wlc internal bss_info */
struct brcms_bss_info {
	u8 BSSID[ETH_ALEN];	/* network BSSID */
	u16 flags;		/* flags for internal attributes */
	u8 SSID_len;		/* the length of SSID */
	u8 SSID[32];		/* SSID string */
	s16 RSSI;		/* receive signal strength (in dBm) */
	s16 SNR;		/* receive signal SNR in dB */
	u16 beacon_period;	/* units are Kusec */
	u16 chanspec;	/* Channel num, bw, ctrl_sb and band */
	struct brcms_c_rateset rateset;	/* supported rates */
};

#define MAC80211_PROMISC_BCNS	(1 << 0)
#define MAC80211_SCAN		(1 << 1)

/*
 * Public portion of common driver state structure.
 * The wlc handle points at this.
 */
struct brcms_pub {
	struct brcms_c_info *wlc;
	struct ieee80211_hw *ieee_hw;
	struct scb_ampdu *global_ampdu;
	uint mac80211_state;
	uint unit;		/* device instance number */
	uint corerev;		/* core revision */
	struct si_pub *sih;	/* SI handle (cookie for siutils calls) */
	bool up;		/* interface up and running */
	bool hw_off;		/* HW is off */
	bool hw_up;		/* one time hw up/down */
	bool _piomode;		/* true if pio mode */
	uint _nbands;		/* # bands supported */
	uint now;		/* # elapsed seconds */

	bool promisc;		/* promiscuous destination address */
	bool delayed_down;	/* down delayed */
	bool associated;	/* true:part of [I]BSS, false: not */
	/* (union of stas_associated, aps_associated) */
	bool _ampdu;		/* ampdu enabled or not */
	u8 _n_enab;		/* bitmap of 11N + HT support */