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>
24 #include <proto/802.11.h>
33 #include <wlc_channel.h>
34 #include <wlc_bsscfg.h>
35 #include <wlc_mac80211.h>
37 #include <wl_export.h>
42 #define MIN_SPATIAL_EXPANSION 0
43 #define MAX_SPATIAL_EXPANSION 1
45 #define WLC_STF_SS_STBC_RX(wlc) (WLCISNPHY(wlc->band) && \
46 NREV_GT(wlc->band->phyrev, 3) && NREV_LE(wlc->band->phyrev, 6))
48 static bool wlc_stf_stbc_tx_set(struct wlc_info
*wlc
, s32 int_val
);
49 static int wlc_stf_txcore_set(struct wlc_info
*wlc
, u8 Nsts
, u8 val
);
50 static int wlc_stf_spatial_policy_set(struct wlc_info
*wlc
, int val
);
51 static void wlc_stf_stbc_rx_ht_update(struct wlc_info
*wlc
, int val
);
53 static void _wlc_stf_phy_txant_upd(struct wlc_info
*wlc
);
54 static u16
_wlc_stf_phytxchain_sel(struct wlc_info
*wlc
, ratespec_t rspec
);
60 const u8 txcore_default
[5] = {
61 (0), /* bitmap of the core enabled */
62 (0x01), /* For Nsts = 1, enable core 1 */
63 (0x03), /* For Nsts = 2, enable core 1 & 2 */
64 (0x07), /* For Nsts = 3, enable core 1, 2 & 3 */
65 (0x0f) /* For Nsts = 4, enable all cores */
68 static void wlc_stf_stbc_rx_ht_update(struct wlc_info
*wlc
, int val
)
70 ASSERT((val
== HT_CAP_RX_STBC_NO
)
71 || (val
== HT_CAP_RX_STBC_ONE_STREAM
));
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
&= ~HT_CAP_RX_STBC_MASK
;
80 wlc
->ht_cap
.cap_info
|= (val
<< 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 WL_TRACE("wl%d: %s: Nsts %d core_mask %x\n",
195 wlc
->pub
->unit
, __func__
, Nsts
, core_mask
);
197 ASSERT((Nsts
> 0) && (Nsts
<= MAX_STREAMS_SUPPORTED
));
199 if (WLC_BITSCNT(core_mask
) > wlc
->stf
->txstreams
) {
203 if ((WLC_BITSCNT(core_mask
) == wlc
->stf
->txstreams
) &&
204 ((core_mask
& ~wlc
->stf
->txchain
)
205 || !(core_mask
& wlc
->stf
->txchain
))) {
206 core_mask
= wlc
->stf
->txchain
;
209 ASSERT(!core_mask
|| Nsts
<= WLC_BITSCNT(core_mask
));
211 wlc
->stf
->txcore
[Nsts
] = core_mask
;
212 /* Nsts = 1..4, txcore index = 1..4 */
214 /* Needs to update beacon and ucode generated response
215 * frames when 1 stream core map changed
217 wlc
->stf
->phytxant
= core_mask
<< PHY_TXC_ANT_SHIFT
;
218 wlc_bmac_txant_set(wlc
->hw
, wlc
->stf
->phytxant
);
220 wlc_suspend_mac_and_wait(wlc
);
221 wlc_beacon_phytxctl_txant_upd(wlc
, wlc
->bcn_rspec
);
229 static int wlc_stf_spatial_policy_set(struct wlc_info
*wlc
, int val
)
234 WL_TRACE("wl%d: %s: val %x\n", wlc
->pub
->unit
, __func__
, val
);
236 wlc
->stf
->spatial_policy
= (s8
) val
;
237 for (i
= 1; i
<= MAX_STREAMS_SUPPORTED
; i
++) {
238 core_mask
= (val
== MAX_SPATIAL_EXPANSION
) ?
239 wlc
->stf
->txchain
: txcore_default
[i
];
240 wlc_stf_txcore_set(wlc
, (u8
) i
, core_mask
);
245 int wlc_stf_txchain_set(struct wlc_info
*wlc
, s32 int_val
, bool force
)
247 u8 txchain
= (u8
) int_val
;
251 if (wlc
->stf
->txchain
== txchain
)
254 if ((txchain
& ~wlc
->stf
->hw_txchain
)
255 || !(txchain
& wlc
->stf
->hw_txchain
))
258 /* if nrate override is configured to be non-SISO STF mode, reject reducing txchain to 1 */
259 txstreams
= (u8
) WLC_BITSCNT(txchain
);
260 if (txstreams
> MAX_STREAMS_SUPPORTED
)
263 if (txstreams
== 1) {
264 for (i
= 0; i
< NBANDS(wlc
); i
++)
265 if ((RSPEC_STF(wlc
->bandstate
[i
]->rspec_override
) !=
267 || (RSPEC_STF(wlc
->bandstate
[i
]->mrspec_override
) !=
268 PHY_TXC1_MODE_SISO
)) {
272 /* over-write the override rspec */
273 if (RSPEC_STF(wlc
->bandstate
[i
]->rspec_override
)
274 != PHY_TXC1_MODE_SISO
) {
275 wlc
->bandstate
[i
]->rspec_override
= 0;
276 WL_ERROR("%s(): temp sense override non-SISO rspec_override\n",
280 (wlc
->bandstate
[i
]->mrspec_override
) !=
281 PHY_TXC1_MODE_SISO
) {
282 wlc
->bandstate
[i
]->mrspec_override
= 0;
283 WL_ERROR("%s(): temp sense override non-SISO mrspec_override\n",
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 ASSERT(isset(&wlc
->stf
->ss_algo_channel
, PHY_TXC1_MODE_CDD
)
321 || isset(&wlc
->stf
->ss_algo_channel
,
322 PHY_TXC1_MODE_SISO
));
323 upd_stf_ss
= (wlc
->stf
->no_cddstbc
|| (wlc
->stf
->txstreams
== 1)
324 || isset(&wlc
->stf
->ss_algo_channel
,
325 PHY_TXC1_MODE_SISO
)) ? PHY_TXC1_MODE_SISO
328 if (wlc
->band
!= band
)
330 upd_stf_ss
= (wlc
->stf
->no_cddstbc
331 || (wlc
->stf
->txstreams
==
332 1)) ? PHY_TXC1_MODE_SISO
: band
->
335 if (prev_stf_ss
!= upd_stf_ss
) {
336 wlc
->stf
->ss_opmode
= upd_stf_ss
;
337 wlc_bmac_band_stf_ss_set(wlc
->hw
, upd_stf_ss
);
343 int wlc_stf_attach(struct wlc_info
*wlc
)
345 wlc
->bandstate
[BAND_2G_INDEX
]->band_stf_ss_mode
= PHY_TXC1_MODE_SISO
;
346 wlc
->bandstate
[BAND_5G_INDEX
]->band_stf_ss_mode
= PHY_TXC1_MODE_CDD
;
348 if (WLCISNPHY(wlc
->band
) &&
349 (wlc_phy_txpower_hw_ctrl_get(wlc
->band
->pi
) != PHY_TPC_HW_ON
))
350 wlc
->bandstate
[BAND_2G_INDEX
]->band_stf_ss_mode
=
352 wlc_stf_ss_update(wlc
, wlc
->bandstate
[BAND_2G_INDEX
]);
353 wlc_stf_ss_update(wlc
, wlc
->bandstate
[BAND_5G_INDEX
]);
355 wlc_stf_stbc_rx_ht_update(wlc
, HT_CAP_RX_STBC_NO
);
356 wlc
->bandstate
[BAND_2G_INDEX
]->band_stf_stbc_tx
= OFF
;
357 wlc
->bandstate
[BAND_5G_INDEX
]->band_stf_stbc_tx
= OFF
;
359 if (WLC_STBC_CAP_PHY(wlc
)) {
360 wlc
->stf
->ss_algosel_auto
= true;
361 wlc
->stf
->ss_algo_channel
= (u16
) -1; /* Init the default value */
366 void wlc_stf_detach(struct wlc_info
*wlc
)
370 int wlc_stf_ant_txant_validate(struct wlc_info
*wlc
, s8 val
)
372 int bcmerror
= BCME_OK
;
374 /* when there is only 1 tx_streams, don't allow to change the txant */
375 if (WLCISNPHY(wlc
->band
) && (wlc
->stf
->txstreams
== 1))
376 return ((val
== wlc
->stf
->txant
) ? bcmerror
: BCME_RANGE
);
383 val
= ANT_TX_FORCE_0
;
386 val
= ANT_TX_FORCE_1
;
389 val
= ANT_TX_LAST_RX
;
392 bcmerror
= BCME_RANGE
;
396 if (bcmerror
== BCME_OK
)
397 wlc
->stf
->txant
= (s8
) val
;
404 * Centralized txant update function. call it whenever wlc->stf->txant and/or wlc->stf->txchain
407 * Antennas are controlled by ucode indirectly, which drives PHY or GPIO to
408 * achieve various tx/rx antenna selection schemes
410 * legacy phy, bit 6 and bit 7 means antenna 0 and 1 respectively, bit6+bit7 means auto(last rx)
411 * for NREV<3, bit 6 and bit 7 means antenna 0 and 1 respectively, bit6+bit7 means last rx and
412 * do tx-antenna selection for SISO transmissions
413 * for NREV=3, bit 6 and bit _8_ means antenna 0 and 1 respectively, bit6+bit7 means last rx and
414 * do tx-antenna selection for SISO transmissions
415 * for NREV>=7, bit 6 and bit 7 mean antenna 0 and 1 respectively, nit6+bit7 means both cores active
417 static void _wlc_stf_phy_txant_upd(struct wlc_info
*wlc
)
421 txant
= (s8
) wlc
->stf
->txant
;
422 ASSERT(txant
== ANT_TX_FORCE_0
|| txant
== ANT_TX_FORCE_1
423 || txant
== ANT_TX_LAST_RX
);
425 if (WLC_PHY_11N_CAP(wlc
->band
)) {
426 if (txant
== ANT_TX_FORCE_0
) {
427 wlc
->stf
->phytxant
= PHY_TXC_ANT_0
;
428 } else if (txant
== ANT_TX_FORCE_1
) {
429 wlc
->stf
->phytxant
= PHY_TXC_ANT_1
;
431 if (WLCISNPHY(wlc
->band
) &&
432 NREV_GE(wlc
->band
->phyrev
, 3)
433 && NREV_LT(wlc
->band
->phyrev
, 7)) {
434 wlc
->stf
->phytxant
= PHY_TXC_ANT_2
;
437 if (WLCISLCNPHY(wlc
->band
) || WLCISSSLPNPHY(wlc
->band
))
438 wlc
->stf
->phytxant
= PHY_TXC_LCNPHY_ANT_LAST
;
440 /* keep this assert to catch out of sync wlc->stf->txcore */
441 ASSERT(wlc
->stf
->txchain
> 0);
443 wlc
->stf
->txchain
<< PHY_TXC_ANT_SHIFT
;
447 if (txant
== ANT_TX_FORCE_0
)
448 wlc
->stf
->phytxant
= PHY_TXC_OLD_ANT_0
;
449 else if (txant
== ANT_TX_FORCE_1
)
450 wlc
->stf
->phytxant
= PHY_TXC_OLD_ANT_1
;
452 wlc
->stf
->phytxant
= PHY_TXC_OLD_ANT_LAST
;
455 wlc_bmac_txant_set(wlc
->hw
, wlc
->stf
->phytxant
);
458 void wlc_stf_phy_txant_upd(struct wlc_info
*wlc
)
460 _wlc_stf_phy_txant_upd(wlc
);
463 void wlc_stf_phy_chain_calc(struct wlc_info
*wlc
)
465 /* get available rx/tx chains */
466 wlc
->stf
->hw_txchain
= (u8
) getintvar(wlc
->pub
->vars
, "txchain");
467 wlc
->stf
->hw_rxchain
= (u8
) getintvar(wlc
->pub
->vars
, "rxchain");
469 /* these parameter are intended to be used for all PHY types */
470 if (wlc
->stf
->hw_txchain
== 0 || wlc
->stf
->hw_txchain
== 0xf) {
471 if (WLCISNPHY(wlc
->band
)) {
472 wlc
->stf
->hw_txchain
= TXCHAIN_DEF_NPHY
;
474 wlc
->stf
->hw_txchain
= TXCHAIN_DEF
;
478 wlc
->stf
->txchain
= wlc
->stf
->hw_txchain
;
479 wlc
->stf
->txstreams
= (u8
) WLC_BITSCNT(wlc
->stf
->hw_txchain
);
481 if (wlc
->stf
->hw_rxchain
== 0 || wlc
->stf
->hw_rxchain
== 0xf) {
482 if (WLCISNPHY(wlc
->band
)) {
483 wlc
->stf
->hw_rxchain
= RXCHAIN_DEF_NPHY
;
485 wlc
->stf
->hw_rxchain
= RXCHAIN_DEF
;
489 wlc
->stf
->rxchain
= wlc
->stf
->hw_rxchain
;
490 wlc
->stf
->rxstreams
= (u8
) WLC_BITSCNT(wlc
->stf
->hw_rxchain
);
492 /* initialize the txcore table */
493 memcpy(wlc
->stf
->txcore
, txcore_default
, sizeof(wlc
->stf
->txcore
));
495 /* default spatial_policy */
496 wlc
->stf
->spatial_policy
= MIN_SPATIAL_EXPANSION
;
497 wlc_stf_spatial_policy_set(wlc
, MIN_SPATIAL_EXPANSION
);
500 static u16
_wlc_stf_phytxchain_sel(struct wlc_info
*wlc
, ratespec_t rspec
)
502 u16 phytxant
= wlc
->stf
->phytxant
;
504 if (RSPEC_STF(rspec
) != PHY_TXC1_MODE_SISO
) {
505 ASSERT(wlc
->stf
->txstreams
> 1);
506 phytxant
= wlc
->stf
->txchain
<< PHY_TXC_ANT_SHIFT
;
507 } else if (wlc
->stf
->txant
== ANT_TX_DEF
)
508 phytxant
= wlc
->stf
->txchain
<< PHY_TXC_ANT_SHIFT
;
509 phytxant
&= PHY_TXC_ANT_MASK
;
513 u16
wlc_stf_phytxchain_sel(struct wlc_info
*wlc
, ratespec_t rspec
)
515 return _wlc_stf_phytxchain_sel(wlc
, rspec
);
518 u16
wlc_stf_d11hdrs_phyctl_txant(struct wlc_info
*wlc
, ratespec_t rspec
)
520 u16 phytxant
= wlc
->stf
->phytxant
;
521 u16 mask
= PHY_TXC_ANT_MASK
;
523 /* for non-siso rates or default setting, use the available chains */
524 if (WLCISNPHY(wlc
->band
)) {
525 ASSERT(wlc
->stf
->txchain
!= 0);
526 phytxant
= _wlc_stf_phytxchain_sel(wlc
, rspec
);
527 mask
= PHY_TXC_HTANT_MASK
;
529 phytxant
|= phytxant
& mask
;