drivers/net/wireless/rockchip_wlan/rtl8723cs/include/rtw_vht.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of version 2 of the GNU General Public License as
   7  * published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  12  * more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along with
  15  * this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
  17  *
  18  *
  19  ******************************************************************************/
  20 #ifndef _RTW_VHT_H_
  21 #define _RTW_VHT_H_
  22
  23 #define LDPC_VHT_ENABLE_RX                      BIT0
  24 #define LDPC_VHT_ENABLE_TX                      BIT1
  25 #define LDPC_VHT_TEST_TX_ENABLE         BIT2
  26 #define LDPC_VHT_CAP_TX                         BIT3
  27
  28 #define STBC_VHT_ENABLE_RX                      BIT0
  29 #define STBC_VHT_ENABLE_TX                      BIT1
  30 #define STBC_VHT_TEST_TX_ENABLE         BIT2
  31 #define STBC_VHT_CAP_TX                         BIT3
  32
  33 #define BEAMFORMING_VHT_BEAMFORMER_ENABLE       BIT0    /* Declare our NIC supports beamformer */
  34 #define BEAMFORMING_VHT_BEAMFORMEE_ENABLE       BIT1    /* Declare our NIC supports beamformee */
  35 #define BEAMFORMING_VHT_MU_MIMO_AP_ENABLE               BIT2                    /*Declare our NIC support MU-MIMO AP mode*/
  36 #define BEAMFORMING_VHT_MU_MIMO_STA_ENABLE      BIT3                    /*Declare our NIC support MU-MIMO STA mode*/
  37 #define BEAMFORMING_VHT_BEAMFORMER_TEST         BIT4                    /*Transmiting Beamforming no matter the target supports it or not*/
  38 #define BEAMFORMING_VHT_BEAMFORMER_STS_CAP              (BIT8 | BIT9 | BIT10)           /*Asoc rsp cap*/
  39 #define BEAMFORMING_VHT_BEAMFORMEE_SOUND_DIM            (BIT12 | BIT13 | BIT14)         /*Asoc rsp cap*/
  40
  41
  42 /* VHT capability info */
  43 #define SET_VHT_CAPABILITY_ELE_MAX_MPDU_LENGTH(_pEleStart, _val)                        SET_BITS_TO_LE_1BYTE(_pEleStart, 0, 2, _val)
  44 #define SET_VHT_CAPABILITY_ELE_CHL_WIDTH(_pEleStart, _val)                      SET_BITS_TO_LE_1BYTE(_pEleStart, 2, 2, _val)
  45 #define SET_VHT_CAPABILITY_ELE_RX_LDPC(_pEleStart, _val)                        SET_BITS_TO_LE_1BYTE(_pEleStart, 4, 1, _val)
  46 #define SET_VHT_CAPABILITY_ELE_SHORT_GI80M(_pEleStart, _val)                            SET_BITS_TO_LE_1BYTE(_pEleStart, 5, 1, _val)
  47 #define SET_VHT_CAPABILITY_ELE_SHORT_GI160M(_pEleStart, _val)                           SET_BITS_TO_LE_1BYTE(_pEleStart, 6, 1, _val)
  48 #define SET_VHT_CAPABILITY_ELE_TX_STBC(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE(_pEleStart, 7, 1, _val)
  49 #define SET_VHT_CAPABILITY_ELE_RX_STBC(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+1, 0, 3, _val)
  50 #define SET_VHT_CAPABILITY_ELE_SU_BFER(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+1, 3, 1, _val)
  51 #define SET_VHT_CAPABILITY_ELE_SU_BFEE(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+1, 4, 1, _val)
  52 #define SET_VHT_CAPABILITY_ELE_BFER_ANT_SUPP(_pEleStart, _val)                          SET_BITS_TO_LE_1BYTE((_pEleStart)+1, 5, 3, _val)
  53 #define SET_VHT_CAPABILITY_ELE_SOUNDING_DIMENSIONS(_pEleStart, _val)                            SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 0, 3, _val)
  54
  55 #define SET_VHT_CAPABILITY_ELE_MU_BFER(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 3, 1, _val)
  56 #define SET_VHT_CAPABILITY_ELE_MU_BFEE(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 4, 1, _val)
  57 #define SET_VHT_CAPABILITY_ELE_TXOP_PS(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 5, 1, _val)
  58 #define SET_VHT_CAPABILITY_ELE_HTC_VHT(_pEleStart, _val)                                SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 6, 1, _val)
  59 #define SET_VHT_CAPABILITY_ELE_MAX_RXAMPDU_FACTOR(_pEleStart, _val)             SET_BITS_TO_LE_2BYTE((_pEleStart)+2, 7, 3, _val) /* B23~B25 */
  60 #define SET_VHT_CAPABILITY_ELE_LINK_ADAPTION(_pEleStart, _val)                          SET_BITS_TO_LE_1BYTE((_pEleStart)+2, 2, 2, _val)
  61 #define SET_VHT_CAPABILITY_ELE_MCS_RX_MAP(_pEleStart, _val)                             SET_BITS_TO_LE_2BYTE((_pEleStart)+4, 0, 16, _val)   /* B0~B15 indicate Rx MCS MAP, we write 0 to indicate MCS0~7. by page */
  62 #define SET_VHT_CAPABILITY_ELE_MCS_RX_HIGHEST_RATE(_pEleStart, _val)                            SET_BITS_TO_LE_2BYTE((_pEleStart)+6, 0, 13, _val)
  63 #define SET_VHT_CAPABILITY_ELE_MCS_TX_MAP(_pEleStart, _val)                             SET_BITS_TO_LE_2BYTE((_pEleStart)+8, 0, 16, _val)   /* B0~B15 indicate Tx MCS MAP, we write 0 to indicate MCS0~7. by page */
  64 #define SET_VHT_CAPABILITY_ELE_MCS_TX_HIGHEST_RATE(_pEleStart, _val)                            SET_BITS_TO_LE_2BYTE((_pEleStart)+10, 0, 13, _val)
  65
  66
  67 #define GET_VHT_CAPABILITY_ELE_MAX_MPDU_LENGTH(_pEleStart)                      LE_BITS_TO_1BYTE(_pEleStart, 0, 2)
  68 #define GET_VHT_CAPABILITY_ELE_CHL_WIDTH(_pEleStart)                            LE_BITS_TO_1BYTE(_pEleStart, 2, 2)
  69 #define GET_VHT_CAPABILITY_ELE_RX_LDPC(_pEleStart)                      LE_BITS_TO_1BYTE(_pEleStart, 4, 1)
  70 #define GET_VHT_CAPABILITY_ELE_SHORT_GI80M(_pEleStart)                          LE_BITS_TO_1BYTE(_pEleStart, 5, 1)
  71 #define GET_VHT_CAPABILITY_ELE_SHORT_GI160M(_pEleStart)                         LE_BITS_TO_1BYTE(_pEleStart, 6, 1)
  72 #define GET_VHT_CAPABILITY_ELE_TX_STBC(_pEleStart)                              LE_BITS_TO_1BYTE(_pEleStart, 7, 1)
  73 #define GET_VHT_CAPABILITY_ELE_RX_STBC(_pEleStart)                              LE_BITS_TO_1BYTE((_pEleStart)+1, 0, 3)
  74 #define GET_VHT_CAPABILITY_ELE_SU_BFER(_pEleStart)                                      LE_BITS_TO_1BYTE((_pEleStart)+1, 3, 1)
  75 #define GET_VHT_CAPABILITY_ELE_SU_BFEE(_pEleStart)                                      LE_BITS_TO_1BYTE((_pEleStart)+1, 4, 1)
  76 /*phydm-beamforming*/
  77 #define GET_VHT_CAPABILITY_ELE_SU_BFEE_STS_CAP(_pEleStart)      LE_BITS_TO_2BYTE((_pEleStart)+1, 5, 3)
  78 #define GET_VHT_CAPABILITY_ELE_SU_BFER_SOUND_DIM_NUM(_pEleStart)        LE_BITS_TO_2BYTE((_pEleStart)+2, 0, 3)
  79 #define GET_VHT_CAPABILITY_ELE_MU_BFER(_pEleStart)                              LE_BITS_TO_1BYTE((_pEleStart)+2, 3, 1)
  80 #define GET_VHT_CAPABILITY_ELE_MU_BFEE(_pEleStart)                              LE_BITS_TO_1BYTE((_pEleStart)+2, 4, 1)
  81 #define GET_VHT_CAPABILITY_ELE_TXOP_PS(_pEleStart)                              LE_BITS_TO_1BYTE((_pEleStart)+2, 5, 1)
  82 #define GET_VHT_CAPABILITY_ELE_MAX_RXAMPDU_FACTOR(_pEleStart)   LE_BITS_TO_2BYTE((_pEleStart)+2, 7, 3)
  83 #define GET_VHT_CAPABILITY_ELE_RX_MCS(_pEleStart)                                              ((_pEleStart)+4)
  84 #define GET_VHT_CAPABILITY_ELE_MCS_RX_HIGHEST_RATE(_pEleStart)                  LE_BITS_TO_2BYTE((_pEleStart)+6, 0, 13)
  85 #define GET_VHT_CAPABILITY_ELE_TX_MCS(_pEleStart)                                              ((_pEleStart)+8)
  86 #define GET_VHT_CAPABILITY_ELE_MCS_TX_HIGHEST_RATE(_pEleStart)                  LE_BITS_TO_2BYTE((_pEleStart)+10, 0, 13)
  87
  88
  89 /* VHT Operation Information Element */
  90 #define SET_VHT_OPERATION_ELE_CHL_WIDTH(_pEleStart, _val)                       SET_BITS_TO_LE_1BYTE(_pEleStart, 0, 8, _val)
  91 #define SET_VHT_OPERATION_ELE_CHL_CENTER_FREQ1(_pEleStart, _val)                        SET_BITS_TO_LE_1BYTE(_pEleStart+1, 0, 8, _val)
  92 #define SET_VHT_OPERATION_ELE_CHL_CENTER_FREQ2(_pEleStart, _val)                        SET_BITS_TO_LE_1BYTE(_pEleStart+2, 0, 8, _val)
  93 #define SET_VHT_OPERATION_ELE_BASIC_MCS_SET(_pEleStart, _val)                   SET_BITS_TO_LE_2BYTE((_pEleStart)+3, 0, 16, _val)
  94
  95 #define GET_VHT_OPERATION_ELE_CHL_WIDTH(_pEleStart)             LE_BITS_TO_1BYTE(_pEleStart, 0, 8)
  96 #define GET_VHT_OPERATION_ELE_CENTER_FREQ1(_pEleStart)  LE_BITS_TO_1BYTE((_pEleStart)+1, 0, 8)
  97 #define GET_VHT_OPERATION_ELE_CENTER_FREQ2(_pEleStart)     LE_BITS_TO_1BYTE((_pEleStart)+2, 0, 8)
  98
  99 /* VHT Operating Mode */
 100 #define SET_VHT_OPERATING_MODE_FIELD_CHNL_WIDTH(_pEleStart, _val)               SET_BITS_TO_LE_1BYTE(_pEleStart, 0, 2, _val)
 101 #define SET_VHT_OPERATING_MODE_FIELD_RX_NSS(_pEleStart, _val)                   SET_BITS_TO_LE_1BYTE(_pEleStart, 4, 3, _val)
 102 #define SET_VHT_OPERATING_MODE_FIELD_RX_NSS_TYPE(_pEleStart, _val)      SET_BITS_TO_LE_1BYTE(_pEleStart, 7, 1, _val)
 103 #define GET_VHT_OPERATING_MODE_FIELD_CHNL_WIDTH(_pEleStart)                     LE_BITS_TO_1BYTE(_pEleStart, 0, 2)
 104 #define GET_VHT_OPERATING_MODE_FIELD_RX_NSS(_pEleStart)                         LE_BITS_TO_1BYTE(_pEleStart, 4, 3)
 105 #define GET_VHT_OPERATING_MODE_FIELD_RX_NSS_TYPE(_pEleStart)            LE_BITS_TO_1BYTE(_pEleStart, 7, 1)
 106
 107 #define SET_EXT_CAPABILITY_ELE_OP_MODE_NOTIF(_pEleStart, _val)                  SET_BITS_TO_LE_1BYTE((_pEleStart)+7, 6, 1, _val)
 108 #define GET_EXT_CAPABILITY_ELE_OP_MODE_NOTIF(_pEleStart)                                LE_BITS_TO_1BYTE((_pEleStart)+7, 6, 1)
 109
 110 struct vht_priv {
 111         u8      vht_option;
 112
 113         u8      ldpc_cap;
 114         u8      stbc_cap;
 115         u16     beamform_cap;
 116
 117         u8      sgi_80m;/* short GI */
 118         u8      ampdu_len;
 119
 120         u8      vht_op_mode_notify;
 121         u8      vht_highest_rate;
 122         u8      vht_mcs_map[2];
 123
 124         u8      vht_cap[32];
 125 };
 126
 127 u8      rtw_get_vht_highest_rate(u8 *pvht_mcs_map);
 128 u16     rtw_vht_mcs_to_data_rate(u8 bw, u8 short_GI, u8 vht_mcs_rate);
 129 u64     rtw_vht_mcs_map_to_bitmap(u8 *mcs_map, u8 nss);
 130 void    rtw_vht_use_default_setting(_adapter *padapter);
 131 u32     rtw_build_vht_operation_ie(_adapter *padapter, u8 *pbuf, u8 channel);
 132 u32     rtw_build_vht_op_mode_notify_ie(_adapter *padapter, u8 *pbuf, u8 bw);
 133 u32     rtw_build_vht_cap_ie(_adapter *padapter, u8 *pbuf);
 134 void    update_sta_vht_info_apmode(_adapter *padapter, PVOID psta);
 135 void    update_hw_vht_param(_adapter *padapter);
 136 void    VHT_caps_handler(_adapter *padapter, PNDIS_802_11_VARIABLE_IEs pIE);
 137 void    VHT_operation_handler(_adapter *padapter, PNDIS_802_11_VARIABLE_IEs pIE);
 138 void    rtw_process_vht_op_mode_notify(_adapter *padapter, u8 *pframe, PVOID sta);
 139 u32     rtw_restructure_vht_ie(_adapter *padapter, u8 *in_ie, u8 *out_ie, uint in_len, uint *pout_len);
 140 void    VHTOnAssocRsp(_adapter *padapter);
 141 u8      rtw_vht_mcsmap_to_nss(u8 *pvht_mcs_map);
 142 void rtw_vht_nss_to_mcsmap(u8 nss, u8 *target_mcs_map, u8 *cur_mcs_map);
 143
 144 #endif /* _RTW_VHT_H_ */