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.
17 #include <linux/kernel.h>
18 #include <linux/module.h>
20 #include <proto/802.11.h>
30 #include "wlc_types.h"
38 #include "phy/wlc_phy_hal.h"
39 #include "wlc_channel.h"
41 #include "wl_export.h"
45 #define MIN_SPATIAL_EXPANSION 0
46 #define MAX_SPATIAL_EXPANSION 1
48 #define WLC_STF_SS_STBC_RX(wlc) (WLCISNPHY(wlc->band) && \
49 NREV_GT(wlc->band->phyrev, 3) && NREV_LE(wlc->band->phyrev, 6))
51 static bool wlc_stf_stbc_tx_set(struct wlc_info *wlc, s32 int_val);
52 static int wlc_stf_txcore_set(struct wlc_info *wlc, u8 Nsts, u8 val);
53 static int wlc_stf_spatial_policy_set(struct wlc_info *wlc, int val);
54 static void wlc_stf_stbc_rx_ht_update(struct wlc_info *wlc, int val);
56 static void _wlc_stf_phy_txant_upd(struct wlc_info *wlc);
57 static u16 _wlc_stf_phytxchain_sel(struct wlc_info *wlc, ratespec_t rspec);
63 const u8 txcore_default[5] = {
64 (0), /* bitmap of the core enabled */
65 (0x01), /* For Nsts = 1, enable core 1 */
66 (0x03), /* For Nsts = 2, enable core 1 & 2 */
67 (0x07), /* For Nsts = 3, enable core 1, 2 & 3 */
68 (0x0f) /* For Nsts = 4, enable all cores */
71 static void wlc_stf_stbc_rx_ht_update(struct wlc_info *wlc, int val)
73 /* MIMOPHYs rev3-6 cannot receive STBC with only one rx core active */
74 if (WLC_STF_SS_STBC_RX(wlc)) {
75 if ((wlc->stf->rxstreams == 1) && (val != HT_CAP_RX_STBC_NO))
79 wlc->ht_cap.cap_info &= ~IEEE80211_HT_CAP_RX_STBC;
80 wlc->ht_cap.cap_info |= (val << IEEE80211_HT_CAP_RX_STBC_SHIFT);
83 wlc_update_beacon(wlc);
84 wlc_update_probe_resp(wlc, true);
88 /* every WLC_TEMPSENSE_PERIOD seconds temperature check to decide whether to turn on/off txchain */
89 void wlc_tempsense_upd(struct wlc_info *wlc)
91 wlc_phy_t *pi = wlc->band->pi;
92 uint active_chains, txchain;
94 /* Check if the chip is too hot. Disable one Tx chain, if it is */
95 /* high 4 bits are for Rx chain, low 4 bits are for Tx chain */
96 active_chains = wlc_phy_stf_chain_active_get(pi);
97 txchain = active_chains & 0xf;
99 if (wlc->stf->txchain == wlc->stf->hw_txchain) {
100 if (txchain && (txchain < wlc->stf->hw_txchain)) {
101 /* turn off 1 tx chain */
102 wlc_stf_txchain_set(wlc, txchain, true);
104 } else if (wlc->stf->txchain < wlc->stf->hw_txchain) {
105 if (txchain == wlc->stf->hw_txchain) {
106 /* turn back on txchain */
107 wlc_stf_txchain_set(wlc, txchain, true);
113 wlc_stf_ss_algo_channel_get(struct wlc_info *wlc, u16 *ss_algo_channel,
117 u8 siso_mcs_id, cdd_mcs_id, stbc_mcs_id;
119 /* Clear previous settings */
120 *ss_algo_channel = 0;
123 *ss_algo_channel = (u16) -1;
127 wlc_phy_txpower_get_current(wlc->band->pi, &power,
128 CHSPEC_CHANNEL(chanspec));
130 siso_mcs_id = (CHSPEC_IS40(chanspec)) ?
131 WL_TX_POWER_MCS40_SISO_FIRST : WL_TX_POWER_MCS20_SISO_FIRST;
132 cdd_mcs_id = (CHSPEC_IS40(chanspec)) ?
133 WL_TX_POWER_MCS40_CDD_FIRST : WL_TX_POWER_MCS20_CDD_FIRST;
134 stbc_mcs_id = (CHSPEC_IS40(chanspec)) ?
135 WL_TX_POWER_MCS40_STBC_FIRST : WL_TX_POWER_MCS20_STBC_FIRST;
137 /* criteria to choose stf mode */
139 /* the "+3dbm (12 0.25db units)" is to account for the fact that with CDD, tx occurs
142 if (power.target[siso_mcs_id] > (power.target[cdd_mcs_id] + 12))
143 setbit(ss_algo_channel, PHY_TXC1_MODE_SISO);
145 setbit(ss_algo_channel, PHY_TXC1_MODE_CDD);
147 /* STBC is ORed into to algo channel as STBC requires per-packet SCB capability check
148 * so cannot be default mode of operation. One of SISO, CDD have to be set
150 if (power.target[siso_mcs_id] <= (power.target[stbc_mcs_id] + 12))
151 setbit(ss_algo_channel, PHY_TXC1_MODE_STBC);
154 static bool wlc_stf_stbc_tx_set(struct wlc_info *wlc, s32 int_val)
156 if ((int_val != AUTO) && (int_val != OFF) && (int_val != ON)) {
160 if ((int_val == ON) && (wlc->stf->txstreams == 1))
163 if ((int_val == OFF) || (wlc->stf->txstreams == 1)
164 || !WLC_STBC_CAP_PHY(wlc))
165 wlc->ht_cap.cap_info &= ~IEEE80211_HT_CAP_TX_STBC;
167 wlc->ht_cap.cap_info |= IEEE80211_HT_CAP_TX_STBC;
169 wlc->bandstate[BAND_2G_INDEX]->band_stf_stbc_tx = (s8) int_val;
170 wlc->bandstate[BAND_5G_INDEX]->band_stf_stbc_tx = (s8) int_val;
175 bool wlc_stf_stbc_rx_set(struct wlc_info *wlc, s32 int_val)
177 if ((int_val != HT_CAP_RX_STBC_NO)
178 && (int_val != HT_CAP_RX_STBC_ONE_STREAM)) {
182 if (WLC_STF_SS_STBC_RX(wlc)) {
183 if ((int_val != HT_CAP_RX_STBC_NO)
184 && (wlc->stf->rxstreams == 1))
188 wlc_stf_stbc_rx_ht_update(wlc, int_val);
192 static int wlc_stf_txcore_set(struct wlc_info *wlc, u8 Nsts, u8 core_mask)
194 BCMMSG(wlc->wiphy, "wl%d: Nsts %d core_mask %x\n",
195 wlc->pub->unit, Nsts, core_mask);
197 if (WLC_BITSCNT(core_mask) > wlc->stf->txstreams) {
201 if ((WLC_BITSCNT(core_mask) == wlc->stf->txstreams) &&
202 ((core_mask & ~wlc->stf->txchain)
203 || !(core_mask & wlc->stf->txchain))) {
204 core_mask = wlc->stf->txchain;
207 wlc->stf->txcore[Nsts] = core_mask;
208 /* Nsts = 1..4, txcore index = 1..4 */
210 /* Needs to update beacon and ucode generated response
211 * frames when 1 stream core map changed
213 wlc->stf->phytxant = core_mask << PHY_TXC_ANT_SHIFT;
214 wlc_bmac_txant_set(wlc->hw, wlc->stf->phytxant);
216 wlc_suspend_mac_and_wait(wlc);
217 wlc_beacon_phytxctl_txant_upd(wlc, wlc->bcn_rspec);
225 static int wlc_stf_spatial_policy_set(struct wlc_info *wlc, int val)
230 BCMMSG(wlc->wiphy, "wl%d: val %x\n", wlc->pub->unit, val);
232 wlc->stf->spatial_policy = (s8) val;
233 for (i = 1; i <= MAX_STREAMS_SUPPORTED; i++) {
234 core_mask = (val == MAX_SPATIAL_EXPANSION) ?
235 wlc->stf->txchain : txcore_default[i];
236 wlc_stf_txcore_set(wlc, (u8) i, core_mask);
241 int wlc_stf_txchain_set(struct wlc_info *wlc, s32 int_val, bool force)
243 u8 txchain = (u8) int_val;
247 if (wlc->stf->txchain == txchain)
250 if ((txchain & ~wlc->stf->hw_txchain)
251 || !(txchain & wlc->stf->hw_txchain))
254 /* if nrate override is configured to be non-SISO STF mode, reject reducing txchain to 1 */
255 txstreams = (u8) WLC_BITSCNT(txchain);
256 if (txstreams > MAX_STREAMS_SUPPORTED)
259 if (txstreams == 1) {
260 for (i = 0; i < NBANDS(wlc); i++)
261 if ((RSPEC_STF(wlc->bandstate[i]->rspec_override) !=
263 || (RSPEC_STF(wlc->bandstate[i]->mrspec_override) !=
264 PHY_TXC1_MODE_SISO)) {
268 /* over-write the override rspec */
269 if (RSPEC_STF(wlc->bandstate[i]->rspec_override)
270 != PHY_TXC1_MODE_SISO) {
271 wlc->bandstate[i]->rspec_override = 0;
272 wiphy_err(wlc->wiphy, "%s(): temp "
273 "sense override non-SISO "
278 (wlc->bandstate[i]->mrspec_override) !=
279 PHY_TXC1_MODE_SISO) {
280 wlc->bandstate[i]->mrspec_override = 0;
281 wiphy_err(wlc->wiphy, "%s(): temp "
282 "sense override non-SISO "
289 wlc->stf->txchain = txchain;
290 wlc->stf->txstreams = txstreams;
291 wlc_stf_stbc_tx_set(wlc, wlc->band->band_stf_stbc_tx);
292 wlc_stf_ss_update(wlc, wlc->bandstate[BAND_2G_INDEX]);
293 wlc_stf_ss_update(wlc, wlc->bandstate[BAND_5G_INDEX]);
295 (wlc->stf->txstreams == 1) ? ANT_TX_FORCE_0 : ANT_TX_DEF;
296 _wlc_stf_phy_txant_upd(wlc);
298 wlc_phy_stf_chain_set(wlc->band->pi, wlc->stf->txchain,
301 for (i = 1; i <= MAX_STREAMS_SUPPORTED; i++)
302 wlc_stf_txcore_set(wlc, (u8) i, txcore_default[i]);
307 /* update wlc->stf->ss_opmode which represents the operational stf_ss mode we're using */
308 int wlc_stf_ss_update(struct wlc_info *wlc, struct wlcband *band)
314 prev_stf_ss = wlc->stf->ss_opmode;
316 /* NOTE: opmode can only be SISO or CDD as STBC is decided on a per-packet basis */
317 if (WLC_STBC_CAP_PHY(wlc) &&
318 wlc->stf->ss_algosel_auto
319 && (wlc->stf->ss_algo_channel != (u16) -1)) {
320 upd_stf_ss = (wlc->stf->no_cddstbc || (wlc->stf->txstreams == 1)
321 || isset(&wlc->stf->ss_algo_channel,
322 PHY_TXC1_MODE_SISO)) ? PHY_TXC1_MODE_SISO
325 if (wlc->band != band)
327 upd_stf_ss = (wlc->stf->no_cddstbc
328 || (wlc->stf->txstreams ==
329 1)) ? PHY_TXC1_MODE_SISO : band->
332 if (prev_stf_ss != upd_stf_ss) {
333 wlc->stf->ss_opmode = upd_stf_ss;
334 wlc_bmac_band_stf_ss_set(wlc->hw, upd_stf_ss);
340 int wlc_stf_attach(struct wlc_info *wlc)
342 wlc->bandstate[BAND_2G_INDEX]->band_stf_ss_mode = PHY_TXC1_MODE_SISO;
343 wlc->bandstate[BAND_5G_INDEX]->band_stf_ss_mode = PHY_TXC1_MODE_CDD;
345 if (WLCISNPHY(wlc->band) &&
346 (wlc_phy_txpower_hw_ctrl_get(wlc->band->pi) != PHY_TPC_HW_ON))
347 wlc->bandstate[BAND_2G_INDEX]->band_stf_ss_mode =
349 wlc_stf_ss_update(wlc, wlc->bandstate[BAND_2G_INDEX]);
350 wlc_stf_ss_update(wlc, wlc->bandstate[BAND_5G_INDEX]);
352 wlc_stf_stbc_rx_ht_update(wlc, HT_CAP_RX_STBC_NO);
353 wlc->bandstate[BAND_2G_INDEX]->band_stf_stbc_tx = OFF;
354 wlc->bandstate[BAND_5G_INDEX]->band_stf_stbc_tx = OFF;
356 if (WLC_STBC_CAP_PHY(wlc)) {
357 wlc->stf->ss_algosel_auto = true;
358 wlc->stf->ss_algo_channel = (u16) -1; /* Init the default value */
363 void wlc_stf_detach(struct wlc_info *wlc)
367 int wlc_stf_ant_txant_validate(struct wlc_info *wlc, s8 val)
371 /* when there is only 1 tx_streams, don't allow to change the txant */
372 if (WLCISNPHY(wlc->band) && (wlc->stf->txstreams == 1))
373 return ((val == wlc->stf->txant) ? bcmerror : -EINVAL);
380 val = ANT_TX_FORCE_0;
383 val = ANT_TX_FORCE_1;
386 val = ANT_TX_LAST_RX;
394 wlc->stf->txant = (s8) val;
401 * Centralized txant update function. call it whenever wlc->stf->txant and/or wlc->stf->txchain
404 * Antennas are controlled by ucode indirectly, which drives PHY or GPIO to
405 * achieve various tx/rx antenna selection schemes
407 * legacy phy, bit 6 and bit 7 means antenna 0 and 1 respectively, bit6+bit7 means auto(last rx)
408 * for NREV<3, bit 6 and bit 7 means antenna 0 and 1 respectively, bit6+bit7 means last rx and
409 * do tx-antenna selection for SISO transmissions
410 * for NREV=3, bit 6 and bit _8_ means antenna 0 and 1 respectively, bit6+bit7 means last rx and
411 * do tx-antenna selection for SISO transmissions
412 * for NREV>=7, bit 6 and bit 7 mean antenna 0 and 1 respectively, nit6+bit7 means both cores active
414 static void _wlc_stf_phy_txant_upd(struct wlc_info *wlc)
418 txant = (s8) wlc->stf->txant;
419 if (WLC_PHY_11N_CAP(wlc->band)) {
420 if (txant == ANT_TX_FORCE_0) {
421 wlc->stf->phytxant = PHY_TXC_ANT_0;
422 } else if (txant == ANT_TX_FORCE_1) {
423 wlc->stf->phytxant = PHY_TXC_ANT_1;
425 if (WLCISNPHY(wlc->band) &&
426 NREV_GE(wlc->band->phyrev, 3)
427 && NREV_LT(wlc->band->phyrev, 7)) {
428 wlc->stf->phytxant = PHY_TXC_ANT_2;
431 if (WLCISLCNPHY(wlc->band) || WLCISSSLPNPHY(wlc->band))
432 wlc->stf->phytxant = PHY_TXC_LCNPHY_ANT_LAST;
434 /* catch out of sync wlc->stf->txcore */
435 WARN_ON(wlc->stf->txchain <= 0);
437 wlc->stf->txchain << PHY_TXC_ANT_SHIFT;
441 if (txant == ANT_TX_FORCE_0)
442 wlc->stf->phytxant = PHY_TXC_OLD_ANT_0;
443 else if (txant == ANT_TX_FORCE_1)
444 wlc->stf->phytxant = PHY_TXC_OLD_ANT_1;
446 wlc->stf->phytxant = PHY_TXC_OLD_ANT_LAST;
449 wlc_bmac_txant_set(wlc->hw, wlc->stf->phytxant);
452 void wlc_stf_phy_txant_upd(struct wlc_info *wlc)
454 _wlc_stf_phy_txant_upd(wlc);
457 void wlc_stf_phy_chain_calc(struct wlc_info *wlc)
459 /* get available rx/tx chains */
460 wlc->stf->hw_txchain = (u8) getintvar(wlc->pub->vars, "txchain");
461 wlc->stf->hw_rxchain = (u8) getintvar(wlc->pub->vars, "rxchain");
463 /* these parameter are intended to be used for all PHY types */
464 if (wlc->stf->hw_txchain == 0 || wlc->stf->hw_txchain == 0xf) {
465 if (WLCISNPHY(wlc->band)) {
466 wlc->stf->hw_txchain = TXCHAIN_DEF_NPHY;
468 wlc->stf->hw_txchain = TXCHAIN_DEF;
472 wlc->stf->txchain = wlc->stf->hw_txchain;
473 wlc->stf->txstreams = (u8) WLC_BITSCNT(wlc->stf->hw_txchain);
475 if (wlc->stf->hw_rxchain == 0 || wlc->stf->hw_rxchain == 0xf) {
476 if (WLCISNPHY(wlc->band)) {
477 wlc->stf->hw_rxchain = RXCHAIN_DEF_NPHY;
479 wlc->stf->hw_rxchain = RXCHAIN_DEF;
483 wlc->stf->rxchain = wlc->stf->hw_rxchain;
484 wlc->stf->rxstreams = (u8) WLC_BITSCNT(wlc->stf->hw_rxchain);
486 /* initialize the txcore table */
487 memcpy(wlc->stf->txcore, txcore_default, sizeof(wlc->stf->txcore));
489 /* default spatial_policy */
490 wlc->stf->spatial_policy = MIN_SPATIAL_EXPANSION;
491 wlc_stf_spatial_policy_set(wlc, MIN_SPATIAL_EXPANSION);
494 static u16 _wlc_stf_phytxchain_sel(struct wlc_info *wlc, ratespec_t rspec)
496 u16 phytxant = wlc->stf->phytxant;
498 if (RSPEC_STF(rspec) != PHY_TXC1_MODE_SISO) {
499 phytxant = wlc->stf->txchain << PHY_TXC_ANT_SHIFT;
500 } else if (wlc->stf->txant == ANT_TX_DEF)
501 phytxant = wlc->stf->txchain << PHY_TXC_ANT_SHIFT;
502 phytxant &= PHY_TXC_ANT_MASK;
506 u16 wlc_stf_phytxchain_sel(struct wlc_info *wlc, ratespec_t rspec)
508 return _wlc_stf_phytxchain_sel(wlc, rspec);
511 u16 wlc_stf_d11hdrs_phyctl_txant(struct wlc_info *wlc, ratespec_t rspec)
513 u16 phytxant = wlc->stf->phytxant;
514 u16 mask = PHY_TXC_ANT_MASK;
516 /* for non-siso rates or default setting, use the available chains */
517 if (WLCISNPHY(wlc->band)) {
518 phytxant = _wlc_stf_phytxchain_sel(wlc, rspec);
519 mask = PHY_TXC_HTANT_MASK;
521 phytxant |= phytxant & mask;