drivers/net/wireless/rockchip_wlan/rtl8822be/include/hal_phy.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 __HAL_PHY_H__
  21 #define __HAL_PHY_H__
  22
  23
  24 #if DISABLE_BB_RF
  25         #define HAL_FW_ENABLE                           0
  26         #define HAL_MAC_ENABLE                  0
  27         #define HAL_BB_ENABLE                           0
  28         #define HAL_RF_ENABLE                           0
  29 #else /* FPGA_PHY and ASIC */
  30         #define HAL_FW_ENABLE                           1
  31         #define HAL_MAC_ENABLE                  1
  32         #define HAL_BB_ENABLE                           1
  33         #define HAL_RF_ENABLE                           1
  34 #endif
  35
  36 #define RF6052_MAX_TX_PWR                       0x3F
  37 #define RF6052_MAX_REG_88E                      0xFF
  38 #define RF6052_MAX_REG_92C                      0x7F
  39
  40 #define RF6052_MAX_REG  \
  41         ((RF6052_MAX_REG_88E > RF6052_MAX_REG_92C) ? RF6052_MAX_REG_88E : RF6052_MAX_REG_92C)
  42
  43 #define GET_RF6052_REAL_MAX_REG(_Adapter)       \
  44         (IS_HARDWARE_TYPE_8188E(_Adapter) ? RF6052_MAX_REG_88E : RF6052_MAX_REG_92C)
  45
  46 #define RF6052_MAX_PATH                         2
  47
  48 /*
  49  * Antenna detection method, i.e., using single tone detection or RSSI reported from each antenna detected.
  50  * Added by Roger, 2013.05.22.
  51  *   */
  52 #define ANT_DETECT_BY_SINGLE_TONE       BIT0
  53 #define ANT_DETECT_BY_RSSI                              BIT1
  54 #define IS_ANT_DETECT_SUPPORT_SINGLE_TONE(__Adapter)            ((GET_HAL_DATA(__Adapter)->AntDetection) & ANT_DETECT_BY_SINGLE_TONE)
  55 #define IS_ANT_DETECT_SUPPORT_RSSI(__Adapter)           ((GET_HAL_DATA(__Adapter)->AntDetection) & ANT_DETECT_BY_RSSI)
  56
  57
  58 /*--------------------------Define Parameters-------------------------------*/
  59 typedef enum _RF_TYPE {
  60         RF_TYPE_MIN = 0,        /* 0 */
  61         RF_8225 = 1,                    /* 1 11b/g RF for verification only */
  62         RF_8256 = 2,                    /* 2 11b/g/n */
  63         RF_8258 = 3,                    /* 3 11a/b/g/n RF */
  64         RF_6052 = 4,                    /* 4 11b/g/n RF */
  65         RF_PSEUDO_11N = 5,      /* 5, It is a temporality RF. */
  66         RF_TYPE_MAX
  67 } RF_TYPE_E, *PRF_TYPE_E;
  68
  69 #define TX_1S                   0
  70 #define TX_2S                   1
  71 #define TX_3S                   2
  72 #define TX_4S                   3
  73
  74 #define RF_PATH_MAX_92C_88E             2
  75 #define RF_PATH_MAX_90_8812             4       /* Max RF number 90 support */
  76
  77 typedef enum _ANTENNA_PATH {
  78         ANTENNA_NONE    = 0,
  79         ANTENNA_D               = 1,
  80         ANTENNA_C               = 2,
  81         ANTENNA_CD      = 3,
  82         ANTENNA_B               = 4,
  83         ANTENNA_BD      = 5,
  84         ANTENNA_BC      = 6,
  85         ANTENNA_BCD     = 7,
  86         ANTENNA_A               = 8,
  87         ANTENNA_AD      = 9,
  88         ANTENNA_AC      = 10,
  89         ANTENNA_ACD     = 11,
  90         ANTENNA_AB      = 12,
  91         ANTENNA_ABD     = 13,
  92         ANTENNA_ABC     = 14,
  93         ANTENNA_ABCD    = 15
  94 } ANTENNA_PATH;
  95
  96 typedef enum _RF_CONTENT {
  97         radioa_txt = 0x1000,
  98         radiob_txt = 0x1001,
  99         radioc_txt = 0x1002,
 100         radiod_txt = 0x1003
 101 } RF_CONTENT;
 102
 103 typedef enum _BaseBand_Config_Type {
 104         BaseBand_Config_PHY_REG = 0,                    /* Radio Path A */
 105         BaseBand_Config_AGC_TAB = 1,                    /* Radio Path B */
 106         BaseBand_Config_AGC_TAB_2G = 2,
 107         BaseBand_Config_AGC_TAB_5G = 3,
 108         BaseBand_Config_PHY_REG_PG
 109 } BaseBand_Config_Type, *PBaseBand_Config_Type;
 110
 111 typedef enum _HW_BLOCK {
 112         HW_BLOCK_MAC = 0,
 113         HW_BLOCK_PHY0 = 1,
 114         HW_BLOCK_PHY1 = 2,
 115         HW_BLOCK_RF = 3,
 116         HW_BLOCK_MAXIMUM = 4, /* Never use this */
 117 } HW_BLOCK_E, *PHW_BLOCK_E;
 118
 119 typedef enum _WIRELESS_MODE {
 120         WIRELESS_MODE_UNKNOWN = 0x00,
 121         WIRELESS_MODE_A = 0x01,
 122         WIRELESS_MODE_B = 0x02,
 123         WIRELESS_MODE_G = 0x04,
 124         WIRELESS_MODE_AUTO = 0x08,
 125         WIRELESS_MODE_N_24G = 0x10,
 126         WIRELESS_MODE_N_5G = 0x20,
 127         WIRELESS_MODE_AC_5G = 0x40,
 128         WIRELESS_MODE_AC_24G  = 0x80,
 129         WIRELESS_MODE_AC_ONLY  = 0x100,
 130 } WIRELESS_MODE;
 131
 132 typedef enum _SwChnlCmdID {
 133         CmdID_End,
 134         CmdID_SetTxPowerLevel,
 135         CmdID_BBRegWrite10,
 136         CmdID_WritePortUlong,
 137         CmdID_WritePortUshort,
 138         CmdID_WritePortUchar,
 139         CmdID_RF_WriteReg,
 140 } SwChnlCmdID;
 141
 142 typedef struct _SwChnlCmd {
 143         SwChnlCmdID     CmdID;
 144         u32                             Para1;
 145         u32                             Para2;
 146         u32                             msDelay;
 147 } SwChnlCmd;
 148
 149 typedef struct _R_ANTENNA_SELECT_OFDM {
 150         u32                     r_tx_antenna:4;
 151         u32                     r_ant_l:4;
 152         u32                     r_ant_non_ht:4;
 153         u32                     r_ant_ht1:4;
 154         u32                     r_ant_ht2:4;
 155         u32                     r_ant_ht_s1:4;
 156         u32                     r_ant_non_ht_s1:4;
 157         u32                     OFDM_TXSC:2;
 158         u32                     Reserved:2;
 159 } R_ANTENNA_SELECT_OFDM;
 160
 161 typedef struct _R_ANTENNA_SELECT_CCK {
 162         u8                      r_cckrx_enable_2:2;
 163         u8                      r_cckrx_enable:2;
 164         u8                      r_ccktx_enable:4;
 165 } R_ANTENNA_SELECT_CCK;
 166
 167 typedef struct RF_Shadow_Compare_Map {
 168         /* Shadow register value */
 169         u32             Value;
 170         /* Compare or not flag */
 171         u8              Compare;
 172         /* Record If it had ever modified unpredicted */
 173         u8              ErrorOrNot;
 174         /* Recorver Flag */
 175         u8              Recorver;
 176         /*  */
 177         u8              Driver_Write;
 178 } RF_SHADOW_T;
 179
 180 /*--------------------------Exported Function prototype---------------------*/
 181
 182 u32
 183 PHY_CalculateBitShift(
 184         u32 BitMask
 185 );
 186
 187 u32
 188 PHY_RFShadowRead(
 189         IN      PADAPTER                Adapter,
 190         IN      u8                              eRFPath,
 191         IN      u32                             Offset);
 192
 193 VOID
 194 PHY_RFShadowWrite(
 195         IN      PADAPTER                Adapter,
 196         IN      u8                              eRFPath,
 197         IN      u32                             Offset,
 198         IN      u32                             Data);
 199
 200 BOOLEAN
 201 PHY_RFShadowCompare(
 202         IN      PADAPTER                Adapter,
 203         IN      u8                              eRFPath,
 204         IN      u32                             Offset);
 205
 206 VOID
 207 PHY_RFShadowRecorver(
 208         IN      PADAPTER                Adapter,
 209         IN      u8                              eRFPath,
 210         IN      u32                             Offset);
 211
 212 VOID
 213 PHY_RFShadowCompareAll(
 214         IN      PADAPTER                Adapter);
 215
 216 VOID
 217 PHY_RFShadowRecorverAll(
 218         IN      PADAPTER                Adapter);
 219
 220 VOID
 221 PHY_RFShadowCompareFlagSet(
 222         IN      PADAPTER                Adapter,
 223         IN      u8                              eRFPath,
 224         IN      u32                             Offset,
 225         IN      u8                              Type);
 226
 227 VOID
 228 PHY_RFShadowRecorverFlagSet(
 229         IN      PADAPTER                Adapter,
 230         IN      u8                              eRFPath,
 231         IN      u32                             Offset,
 232         IN      u8                              Type);
 233
 234 VOID
 235 PHY_RFShadowCompareFlagSetAll(
 236         IN      PADAPTER                Adapter);
 237
 238 VOID
 239 PHY_RFShadowRecorverFlagSetAll(
 240         IN      PADAPTER                Adapter);
 241
 242 VOID
 243 PHY_RFShadowRefresh(
 244         IN      PADAPTER                Adapter);
 245
 246 #endif /* __HAL_COMMON_H__ */