/*
|
* Common [OS-independent] rate management
|
* 802.11 Networking Adapter Device Driver.
|
*
|
* Broadcom Proprietary and Confidential. Copyright (C) 2020,
|
* All Rights Reserved.
|
*
|
* This is UNPUBLISHED PROPRIETARY SOURCE CODE of Broadcom;
|
* the contents of this file may not be disclosed to third parties,
|
* copied or duplicated in any form, in whole or in part, without
|
* the prior written permission of Broadcom.
|
*
|
*
|
* <<Broadcom-WL-IPTag/Proprietary:>>
|
*/
|
|
#include <typedefs.h>
|
#include <osl.h>
|
#include <d11.h>
|
#include <802.11ax.h>
|
|
#include <bcmwifi_rspec.h>
|
#include <bcmwifi_rates.h>
|
|
/* TODO: Consolidate rspec utility functions from wlc_rate.c and bcmwifi_monitor.c
|
* into here if they're shared by non wl layer as well...
|
*/
|
|
/* ============================================ */
|
/* Moved from wlc_rate.c */
|
/* ============================================ */
|
|
/**
|
* Returns the rate in [Kbps] units.
|
*/
|
static uint
|
wf_he_rspec_to_rate(ratespec_t rspec, uint max_mcs, uint max_nss)
|
{
|
uint mcs = (rspec & WL_RSPEC_HE_MCS_MASK);
|
uint nss = (rspec & WL_RSPEC_HE_NSS_MASK) >> WL_RSPEC_HE_NSS_SHIFT;
|
bool dcm = (rspec & WL_RSPEC_DCM) != 0;
|
uint bw = RSPEC_BW(rspec);
|
uint gi = RSPEC_HE_LTF_GI(rspec);
|
|
ASSERT(mcs <= max_mcs);
|
ASSERT(nss <= max_nss);
|
|
if (mcs > max_mcs) {
|
return 0;
|
}
|
BCM_REFERENCE(max_nss);
|
|
return wf_he_mcs_to_rate(mcs, nss, bw, gi, dcm);
|
} /* wf_he_rspec_to_rate */
|
|
/* take a well formed ratespec_t arg and return phy rate in [Kbps] units.
|
* 'rsel' indicates if the call comes from rate selection.
|
*/
|
static uint
|
_wf_rspec_to_rate(ratespec_t rspec, bool rsel)
|
{
|
uint rate = (uint)(-1);
|
|
if (RSPEC_ISLEGACY(rspec)) {
|
rate = 500 * RSPEC2RATE(rspec);
|
} else if (RSPEC_ISHT(rspec)) {
|
uint mcs = (rspec & WL_RSPEC_HT_MCS_MASK);
|
|
ASSERT_FP(mcs <= 32 || IS_PROPRIETARY_11N_MCS(mcs));
|
|
if (mcs == 32) {
|
rate = wf_mcs_to_rate(mcs, 1, WL_RSPEC_BW_40MHZ, RSPEC_ISSGI(rspec));
|
} else {
|
#if defined(WLPROPRIETARY_11N_RATES)
|
uint nss = GET_11N_MCS_NSS(mcs);
|
mcs = wf_get_single_stream_mcs(mcs);
|
#else /* this ifdef prevents ROM abandons */
|
uint nss = 1 + (mcs / 8);
|
mcs = mcs % 8;
|
#endif /* WLPROPRIETARY_11N_RATES */
|
|
rate = wf_mcs_to_rate(mcs, nss, RSPEC_BW(rspec), RSPEC_ISSGI(rspec));
|
}
|
} else if (RSPEC_ISVHT(rspec)) {
|
uint mcs = (rspec & WL_RSPEC_VHT_MCS_MASK);
|
uint nss = (rspec & WL_RSPEC_VHT_NSS_MASK) >> WL_RSPEC_VHT_NSS_SHIFT;
|
|
if (rsel) {
|
rate = wf_mcs_to_rate(mcs, nss, RSPEC_BW(rspec), 0);
|
} else {
|
ASSERT_FP(mcs <= WLC_MAX_VHT_MCS);
|
ASSERT_FP(nss <= 8);
|
|
rate = wf_mcs_to_rate(mcs, nss, RSPEC_BW(rspec), RSPEC_ISSGI(rspec));
|
}
|
} else if (RSPEC_ISHE(rspec)) {
|
rate = wf_he_rspec_to_rate(rspec, WLC_MAX_HE_MCS, 8);
|
} else if (RSPEC_ISEHT(rspec)) {
|
rate = wf_he_rspec_to_rate(rspec, WLC_MAX_EHT_MCS, 16);
|
} else {
|
ASSERT(0);
|
}
|
|
return (rate == 0) ? (uint)(-1) : rate;
|
}
|
|
/* take a well formed ratespec_t 'rspec' and return phy rate in [Kbps] units */
|
uint
|
wf_rspec_to_rate(ratespec_t rspec)
|
{
|
return _wf_rspec_to_rate(rspec, FALSE);
|
}
|
|
/* take a well formed ratespec_t 'rspec' and return phy rate in [Kbps] units,
|
* FOR RATE SELECTION ONLY, WHICH USES LEGACY, HT, AND VHT RATES, AND VHT MCS
|
* COULD BE BIGGER THAN WLC_MAX_VHT_MCS!
|
*/
|
uint
|
wf_rspec_to_rate_rsel(ratespec_t rspec)
|
{
|
return _wf_rspec_to_rate(rspec, TRUE);
|
}
|
|
#ifdef BCMDBG
|
/* Return the rate in 500Kbps units if the rspec is legacy rate, assert otherwise */
|
uint
|
wf_rspec_to_rate_legacy(ratespec_t rspec)
|
{
|
ASSERT(RSPEC_ISLEGACY(rspec));
|
|
return rspec & WL_RSPEC_LEGACY_RATE_MASK;
|
}
|
#endif
|
|
/**
|
* Function for computing RSPEC from EHT PLCP
|
*
|
* TODO: add link to the HW spec.
|
*/
|
ratespec_t
|
wf_eht_plcp_to_rspec(uint8 *plcp)
|
{
|
ASSERT(!"wf_eht_plcp_to_rspec: not implemented!");
|
return 0;
|
}
|
|
/**
|
* Function for computing RSPEC from HE PLCP
|
*
|
* based on rev3.10 :
|
* https://docs.google.com/spreadsheets/d/
|
* 1eP6ZCRrtnF924ds1R-XmbcH0IdQ0WNJpS1-FHmWeb9g/edit#gid=1492656555
|
*/
|
ratespec_t
|
wf_he_plcp_to_rspec(uint8 *plcp)
|
{
|
uint8 rate;
|
uint8 nss;
|
uint8 bw;
|
uint8 gi;
|
ratespec_t rspec;
|
|
/* HE plcp - 6 B */
|
uint32 plcp0;
|
uint16 plcp1;
|
|
ASSERT(plcp);
|
|
plcp0 = ((plcp[3] << 24) | (plcp[2] << 16) | (plcp[1] << 8) | plcp[0]);
|
plcp1 = ((plcp[5] << 8) | plcp[4]);
|
|
/* TBD: only SU supported now */
|
rate = (plcp0 & HE_SU_RE_SIGA_MCS_MASK) >> HE_SU_RE_SIGA_MCS_SHIFT;
|
/* PLCP contains (NSTS - 1) while RSPEC stores NSTS */
|
nss = ((plcp0 & HE_SU_RE_SIGA_NSTS_MASK) >> HE_SU_RE_SIGA_NSTS_SHIFT) + 1;
|
rspec = HE_RSPEC(rate, nss);
|
|
/* GI info comes from CP/LTF */
|
gi = (plcp0 & HE_SU_RE_SIGA_GI_LTF_MASK) >> HE_SU_RE_SIGA_GI_LTF_SHIFT;
|
rspec |= HE_GI_TO_RSPEC(gi);
|
|
/* b19-b20 of plcp indicate bandwidth in the format (2-bit):
|
* 0 for 20M, 1 for 40M, 2 for 80M, and 3 for 80p80/160M
|
* SW store this BW in rspec format (3-bit):
|
* 1 for 20M, 2 for 40M, 3 for 80M, and 4 for 80p80/160M
|
*/
|
bw = ((plcp0 & HE_SU_SIGA_BW_MASK) >> HE_SU_SIGA_BW_SHIFT) + 1;
|
rspec |= (bw << WL_RSPEC_BW_SHIFT);
|
|
if (plcp1 & HE_SU_RE_SIGA_BEAMFORM_MASK)
|
rspec |= WL_RSPEC_TXBF;
|
if (plcp1 & HE_SU_RE_SIGA_CODING_MASK)
|
rspec |= WL_RSPEC_LDPC;
|
if (plcp1 & HE_SU_RE_SIGA_STBC_MASK)
|
rspec |= WL_RSPEC_STBC;
|
if (plcp0 & HE_SU_RE_SIGA_DCM_MASK)
|
rspec |= WL_RSPEC_DCM;
|
|
return rspec;
|
}
|
|
ratespec_t
|
wf_vht_plcp_to_rspec(uint8 *plcp)
|
{
|
uint8 rate;
|
uint vht_sig_a1, vht_sig_a2;
|
ratespec_t rspec;
|
|
ASSERT(plcp);
|
|
rate = wf_vht_plcp_to_rate(plcp) & ~WF_NON_HT_MCS;
|
|
vht_sig_a1 = plcp[0] | (plcp[1] << 8);
|
vht_sig_a2 = plcp[3] | (plcp[4] << 8);
|
|
rspec = VHT_RSPEC((rate & WL_RSPEC_VHT_MCS_MASK),
|
(rate >> WL_RSPEC_VHT_NSS_SHIFT));
|
#if ((((VHT_SIGA1_20MHZ_VAL + 1) << WL_RSPEC_BW_SHIFT) != WL_RSPEC_BW_20MHZ) || \
|
(((VHT_SIGA1_40MHZ_VAL + 1) << WL_RSPEC_BW_SHIFT) != WL_RSPEC_BW_40MHZ) || \
|
(((VHT_SIGA1_80MHZ_VAL + 1) << WL_RSPEC_BW_SHIFT) != WL_RSPEC_BW_80MHZ) || \
|
(((VHT_SIGA1_160MHZ_VAL + 1) << WL_RSPEC_BW_SHIFT) != WL_RSPEC_BW_160MHZ))
|
#error "VHT SIGA BW mapping to RSPEC BW needs correction"
|
#endif
|
rspec |= ((vht_sig_a1 & VHT_SIGA1_160MHZ_VAL) + 1) << WL_RSPEC_BW_SHIFT;
|
if (vht_sig_a1 & VHT_SIGA1_STBC)
|
rspec |= WL_RSPEC_STBC;
|
if (vht_sig_a2 & VHT_SIGA2_GI_SHORT)
|
rspec |= WL_RSPEC_SGI;
|
if (vht_sig_a2 & VHT_SIGA2_CODING_LDPC)
|
rspec |= WL_RSPEC_LDPC;
|
|
return rspec;
|
}
|
|
ratespec_t
|
wf_ht_plcp_to_rspec(uint8 *plcp)
|
{
|
return HT_RSPEC(plcp[0] & MIMO_PLCP_MCS_MASK);
|
}
|
|
/* ============================================ */
|
/* Moved from wlc_rate_def.c */
|
/* ============================================ */
|
|
/**
|
* Rate info per rate: tells for *pre* 802.11n rates whether a given rate is OFDM or not and its
|
* phy_rate value. Table index is a rate in [500Kbps] units, from 0 to 54Mbps.
|
* Contents of a table element:
|
* d[7] : 1=OFDM rate, 0=DSSS/CCK rate
|
* d[3:0] if DSSS/CCK rate:
|
* index into the 'M_RATE_TABLE_B' table maintained by ucode in shm
|
* d[3:0] if OFDM rate: encode rate per 802.11a-1999 sec 17.3.4.1, with lsb transmitted first.
|
* index into the 'M_RATE_TABLE_A' table maintained by ucode in shm
|
*/
|
/* Note: make this table 128 elements so the result of (rspec & 0x7f) can be safely
|
* used as the index into this table...
|
*/
|
const uint8 rate_info[128] = {
|
/* 0 1 2 3 4 5 6 7 8 9 */
|
/* 0 */ 0x00, 0x00, 0x0a, 0x00, 0x14, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 10 */ 0x00, 0x37, 0x8b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x8f, 0x00,
|
/* 20 */ 0x00, 0x00, 0x6e, 0x00, 0x8a, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 30 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x8e, 0x00, 0x00, 0x00,
|
/* 40 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x89, 0x00,
|
/* 50 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 60 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 70 */ 0x00, 0x00, 0x8d, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 80 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 90 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x88, 0x00, 0x00, 0x00,
|
/* 100 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x8c,
|
/* ------------- guard ------------ */ 0x00,
|
/* 110 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
/* 120 */ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
|
};
|
