drivers/net/wireless/realtek/rtw88/rtw8723d.h

   1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
   2 /* Copyright(c) 2018-2019  Realtek Corporation
   3  */
   4
   5 #ifndef __RTW8723D_H__
   6 #define __RTW8723D_H__
   7
   8 enum rtw8723d_path {
   9         PATH_S1,
  10         PATH_S0,
  11         PATH_NR,
  12 };
  13
  14 enum rtw8723d_iqk_round {
  15         IQK_ROUND_0,
  16         IQK_ROUND_1,
  17         IQK_ROUND_2,
  18         IQK_ROUND_HYBRID,
  19         IQK_ROUND_SIZE,
  20         IQK_ROUND_INVALID = 0xff,
  21 };
  22
  23 enum rtw8723d_iqk_result {
  24         IQK_S1_TX_X,
  25         IQK_S1_TX_Y,
  26         IQK_S1_RX_X,
  27         IQK_S1_RX_Y,
  28         IQK_S0_TX_X,
  29         IQK_S0_TX_Y,
  30         IQK_S0_RX_X,
  31         IQK_S0_RX_Y,
  32         IQK_NR,
  33         IQK_SX_NR = IQK_NR / PATH_NR,
  34 };
  35
  36 struct rtw8723de_efuse {
  37         u8 mac_addr[ETH_ALEN];          /* 0xd0 */
  38         u8 vender_id[2];
  39         u8 device_id[2];
  40         u8 sub_vender_id[2];
  41         u8 sub_device_id[2];
  42 };
  43
  44 struct rtw8723du_efuse {
  45         u8 res4[48];                    /* 0xd0 */
  46         u8 vender_id[2];                /* 0x100 */
  47         u8 product_id[2];               /* 0x102 */
  48         u8 usb_option;                  /* 0x104 */
  49         u8 res5[2];                     /* 0x105 */
  50         u8 mac_addr[ETH_ALEN];          /* 0x107 */
  51 };
  52
  53 struct rtw8723ds_efuse {
  54         u8 res4[0x4a];                  /* 0xd0 */
  55         u8 mac_addr[ETH_ALEN];          /* 0x11a */
  56 };
  57
  58 struct rtw8723d_efuse {
  59         __le16 rtl_id;
  60         u8 rsvd[2];
  61         u8 afe;
  62         u8 rsvd1[11];
  63
  64         /* power index for four RF paths */
  65         struct rtw_txpwr_idx txpwr_idx_table[4];
  66
  67         u8 channel_plan;                /* 0xb8 */
  68         u8 xtal_k;
  69         u8 thermal_meter;
  70         u8 iqk_lck;
  71         u8 pa_type;                     /* 0xbc */
  72         u8 lna_type_2g[2];              /* 0xbd */
  73         u8 lna_type_5g[2];
  74         u8 rf_board_option;
  75         u8 rf_feature_option;
  76         u8 rf_bt_setting;
  77         u8 eeprom_version;
  78         u8 eeprom_customer_id;
  79         u8 tx_bb_swing_setting_2g;
  80         u8 res_c7;
  81         u8 tx_pwr_calibrate_rate;
  82         u8 rf_antenna_option;           /* 0xc9 */
  83         u8 rfe_option;
  84         u8 country_code[2];
  85         u8 res[3];
  86         union {
  87                 struct rtw8723de_efuse e;
  88                 struct rtw8723du_efuse u;
  89                 struct rtw8723ds_efuse s;
  90         };
  91 };
  92
  93 extern const struct rtw_chip_info rtw8723d_hw_spec;
  94
  95 /* phy status page0 */
  96 #define GET_PHY_STAT_P0_PWDB(phy_stat)                                         \
  97         le32_get_bits(*((__le32 *)(phy_stat) + 0x00), GENMASK(15, 8))
  98
  99 /* phy status page1 */
 100 #define GET_PHY_STAT_P1_PWDB_A(phy_stat)                                       \
 101         le32_get_bits(*((__le32 *)(phy_stat) + 0x00), GENMASK(15, 8))
 102 #define GET_PHY_STAT_P1_PWDB_B(phy_stat)                                       \
 103         le32_get_bits(*((__le32 *)(phy_stat) + 0x00), GENMASK(23, 16))
 104 #define GET_PHY_STAT_P1_RF_MODE(phy_stat)                                      \
 105         le32_get_bits(*((__le32 *)(phy_stat) + 0x03), GENMASK(29, 28))
 106 #define GET_PHY_STAT_P1_L_RXSC(phy_stat)                                       \
 107         le32_get_bits(*((__le32 *)(phy_stat) + 0x01), GENMASK(11, 8))
 108 #define GET_PHY_STAT_P1_HT_RXSC(phy_stat)                                      \
 109         le32_get_bits(*((__le32 *)(phy_stat) + 0x01), GENMASK(15, 12))
 110 #define GET_PHY_STAT_P1_RXEVM_A(phy_stat)                                      \
 111         le32_get_bits(*((__le32 *)(phy_stat) + 0x04), GENMASK(7, 0))
 112 #define GET_PHY_STAT_P1_CFO_TAIL_A(phy_stat)                                   \
 113         le32_get_bits(*((__le32 *)(phy_stat) + 0x05), GENMASK(7, 0))
 114 #define GET_PHY_STAT_P1_RXSNR_A(phy_stat)                                      \
 115         le32_get_bits(*((__le32 *)(phy_stat) + 0x06), GENMASK(7, 0))
 116
 117 static inline s32 iqkxy_to_s32(s32 val)
 118 {
 119         /* val is Q10.8 */
 120         return sign_extend32(val, 9);
 121 }
 122
 123 static inline s32 iqk_mult(s32 x, s32 y, s32 *ext)
 124 {
 125         /* x, y and return value are Q10.8 */
 126         s32 t;
 127
 128         t = x * y;
 129         if (ext)
 130                 *ext = (t >> 7) & 0x1;  /* Q.16 --> Q.9; get LSB of Q.9 */
 131
 132         return (t >> 8);        /* Q.16 --> Q.8 */
 133 }
 134
 135 #define OFDM_SWING_A(swing)             FIELD_GET(GENMASK(9, 0), swing)
 136 #define OFDM_SWING_B(swing)             FIELD_GET(GENMASK(15, 10), swing)
 137 #define OFDM_SWING_C(swing)             FIELD_GET(GENMASK(21, 16), swing)
 138 #define OFDM_SWING_D(swing)             FIELD_GET(GENMASK(31, 22), swing)
 139 #define RTW_DEF_OFDM_SWING_INDEX        28
 140 #define RTW_DEF_CCK_SWING_INDEX         28
 141
 142 #define MAX_TOLERANCE   5
 143 #define IQK_TX_X_ERR    0x142
 144 #define IQK_TX_Y_ERR    0x42
 145 #define IQK_RX_X_UPPER  0x11a
 146 #define IQK_RX_X_LOWER  0xe6
 147 #define IQK_RX_Y_LMT    0x1a
 148 #define IQK_TX_OK       BIT(0)
 149 #define IQK_RX_OK       BIT(1)
 150 #define PATH_IQK_RETRY  2
 151
 152 #define SPUR_THRES              0x16
 153 #define CCK_DFIR_NR             3
 154 #define DIS_3WIRE               0xccf000c0
 155 #define EN_3WIRE                0xccc000c0
 156 #define START_PSD               0x400000
 157 #define FREQ_CH13               0xfccd
 158 #define FREQ_CH14               0xff9a
 159 #define RFCFGCH_CHANNEL_MASK    GENMASK(7, 0)
 160 #define RFCFGCH_BW_MASK         (BIT(11) | BIT(10))
 161 #define RFCFGCH_BW_20M          (BIT(11) | BIT(10))
 162 #define RFCFGCH_BW_40M          BIT(10)
 163 #define BIT_MASK_RFMOD          BIT(0)
 164 #define BIT_LCK                 BIT(15)
 165
 166 #define REG_GPIO_INTM           0x0048
 167 #define REG_BTG_SEL             0x0067
 168 #define BIT_MASK_BTG_WL         BIT(7)
 169 #define REG_LTECOEX_PATH_CONTROL        0x0070
 170 #define REG_LTECOEX_CTRL        0x07c0
 171 #define REG_LTECOEX_WRITE_DATA  0x07c4
 172 #define REG_LTECOEX_READ_DATA   0x07c8
 173 #define REG_PSDFN               0x0808
 174 #define REG_BB_PWR_SAV1_11N     0x0874
 175 #define REG_ANA_PARAM1          0x0880
 176 #define REG_ANALOG_P4           0x088c
 177 #define REG_PSDRPT              0x08b4
 178 #define REG_FPGA1_RFMOD         0x0900
 179 #define REG_BB_SEL_BTG          0x0948
 180 #define REG_BBRX_DFIR           0x0954
 181 #define BIT_MASK_RXBB_DFIR      GENMASK(27, 24)
 182 #define BIT_RXBB_DFIR_EN        BIT(19)
 183 #define REG_CCK0_SYS            0x0a00
 184 #define BIT_CCK_SIDE_BAND       BIT(4)
 185 #define REG_CCK_ANT_SEL_11N     0x0a04
 186 #define REG_PWRTH               0x0a08
 187 #define REG_CCK_FA_RST_11N      0x0a2c
 188 #define BIT_MASK_CCK_CNT_KEEP   BIT(12)
 189 #define BIT_MASK_CCK_CNT_EN     BIT(13)
 190 #define BIT_MASK_CCK_CNT_KPEN   (BIT_MASK_CCK_CNT_KEEP | BIT_MASK_CCK_CNT_EN)
 191 #define BIT_MASK_CCK_FA_KEEP    BIT(14)
 192 #define BIT_MASK_CCK_FA_EN      BIT(15)
 193 #define BIT_MASK_CCK_FA_KPEN    (BIT_MASK_CCK_FA_KEEP | BIT_MASK_CCK_FA_EN)
 194 #define REG_CCK_FA_LSB_11N      0x0a5c
 195 #define REG_CCK_FA_MSB_11N      0x0a58
 196 #define REG_CCK_CCA_CNT_11N     0x0a60
 197 #define BIT_MASK_CCK_FA_MSB     GENMASK(7, 0)
 198 #define BIT_MASK_CCK_FA_LSB     GENMASK(15, 8)
 199 #define REG_PWRTH2              0x0aa8
 200 #define REG_CSRATIO             0x0aaa
 201 #define REG_OFDM_FA_HOLDC_11N   0x0c00
 202 #define BIT_MASK_OFDM_FA_KEEP   BIT(31)
 203 #define REG_BB_RX_PATH_11N      0x0c04
 204 #define REG_TRMUX_11N           0x0c08
 205 #define REG_OFDM_FA_RSTC_11N    0x0c0c
 206 #define BIT_MASK_OFDM_FA_RST    BIT(31)
 207 #define REG_A_RXIQI             0x0c14
 208 #define BIT_MASK_RXIQ_S1_X      0x000003FF
 209 #define BIT_MASK_RXIQ_S1_Y1     0x0000FC00
 210 #define BIT_SET_RXIQ_S1_Y1(y)   ((y) & 0x3F)
 211 #define REG_OFDM0_RXDSP         0x0c40
 212 #define BIT_MASK_RXDSP          GENMASK(28, 24)
 213 #define BIT_EN_RXDSP            BIT(9)
 214 #define REG_OFDM_0_ECCA_THRESHOLD       0x0c4c
 215 #define BIT_MASK_OFDM0_EXT_A    BIT(31)
 216 #define BIT_MASK_OFDM0_EXT_C    BIT(29)
 217 #define BIT_MASK_OFDM0_EXTS     (BIT(31) | BIT(29) | BIT(28))
 218 #define BIT_SET_OFDM0_EXTS(a, c, d) (((a) << 31) | ((c) << 29) | ((d) << 28))
 219 #define REG_OFDM0_XAAGC1        0x0c50
 220 #define REG_OFDM0_XBAGC1        0x0c58
 221 #define REG_AGCRSSI             0x0c78
 222 #define REG_OFDM_0_XA_TX_IQ_IMBALANCE   0x0c80
 223 #define BIT_MASK_TXIQ_ELM_A     0x03ff
 224 #define BIT_SET_TXIQ_ELM_ACD(a, c, d) (((d) << 22) | (((c) & 0x3F) << 16) |    \
 225                                        ((a) & 0x03ff))
 226 #define BIT_MASK_TXIQ_ELM_C     GENMASK(21, 16)
 227 #define BIT_SET_TXIQ_ELM_C2(c)  ((c) & 0x3F)
 228 #define BIT_MASK_TXIQ_ELM_D     GENMASK(31, 22)
 229 #define REG_TXIQK_MATRIXA_LSB2_11N      0x0c94
 230 #define BIT_SET_TXIQ_ELM_C1(c)  (((c) & 0x000003C0) >> 6)
 231 #define REG_RXIQK_MATRIX_LSB_11N        0x0ca0
 232 #define BIT_MASK_RXIQ_S1_Y2     0xF0000000
 233 #define BIT_SET_RXIQ_S1_Y2(y)   (((y) >> 6) & 0xF)
 234 #define REG_TXIQ_AB_S0          0x0cd0
 235 #define BIT_MASK_TXIQ_A_S0      0x000007FE
 236 #define BIT_MASK_TXIQ_A_EXT_S0  BIT(0)
 237 #define BIT_MASK_TXIQ_B_S0      0x0007E000
 238 #define REG_TXIQ_CD_S0          0x0cd4
 239 #define BIT_MASK_TXIQ_C_S0      0x000007FE
 240 #define BIT_MASK_TXIQ_C_EXT_S0  BIT(0)
 241 #define BIT_MASK_TXIQ_D_S0      GENMASK(22, 13)
 242 #define BIT_MASK_TXIQ_D_EXT_S0  BIT(12)
 243 #define REG_RXIQ_AB_S0          0x0cd8
 244 #define BIT_MASK_RXIQ_X_S0      0x000003FF
 245 #define BIT_MASK_RXIQ_Y_S0      0x003FF000
 246 #define REG_OFDM_FA_TYPE1_11N   0x0cf0
 247 #define BIT_MASK_OFDM_FF_CNT    GENMASK(15, 0)
 248 #define BIT_MASK_OFDM_SF_CNT    GENMASK(31, 16)
 249 #define REG_OFDM_FA_RSTD_11N    0x0d00
 250 #define BIT_MASK_OFDM_FA_RST1   BIT(27)
 251 #define BIT_MASK_OFDM_FA_KEEP1  BIT(31)
 252 #define REG_CTX                 0x0d03
 253 #define BIT_MASK_CTX_TYPE       GENMASK(6, 4)
 254 #define REG_OFDM1_CFOTRK        0x0d2c
 255 #define BIT_EN_CFOTRK           BIT(28)
 256 #define REG_OFDM1_CSI1          0x0d40
 257 #define REG_OFDM1_CSI2          0x0d44
 258 #define REG_OFDM1_CSI3          0x0d48
 259 #define REG_OFDM1_CSI4          0x0d4c
 260 #define REG_OFDM_FA_TYPE2_11N   0x0da0
 261 #define BIT_MASK_OFDM_CCA_CNT   GENMASK(15, 0)
 262 #define BIT_MASK_OFDM_PF_CNT    GENMASK(31, 16)
 263 #define REG_OFDM_FA_TYPE3_11N   0x0da4
 264 #define BIT_MASK_OFDM_RI_CNT    GENMASK(15, 0)
 265 #define BIT_MASK_OFDM_CRC_CNT   GENMASK(31, 16)
 266 #define REG_OFDM_FA_TYPE4_11N   0x0da8
 267 #define BIT_MASK_OFDM_MNS_CNT   GENMASK(15, 0)
 268 #define REG_FPGA0_IQK_11N       0x0e28
 269 #define BIT_MASK_IQK_MOD        0xffffff00
 270 #define EN_IQK                  0x808000
 271 #define RST_IQK                 0x000000
 272 #define REG_TXIQK_TONE_A_11N    0x0e30
 273 #define REG_RXIQK_TONE_A_11N    0x0e34
 274 #define REG_TXIQK_PI_A_11N      0x0e38
 275 #define REG_RXIQK_PI_A_11N      0x0e3c
 276 #define REG_TXIQK_11N           0x0e40
 277 #define BIT_SET_TXIQK_11N(x, y) (0x80007C00 | ((x) << 16) | (y))
 278 #define REG_RXIQK_11N           0x0e44
 279 #define REG_IQK_AGC_PTS_11N     0x0e48
 280 #define REG_IQK_AGC_RSP_11N     0x0e4c
 281 #define REG_TX_IQK_TONE_B       0x0e50
 282 #define REG_RX_IQK_TONE_B       0x0e54
 283 #define REG_IQK_RES_TX          0x0e94
 284 #define BIT_MASK_RES_TX         GENMASK(25, 16)
 285 #define REG_IQK_RES_TY          0x0e9c
 286 #define BIT_MASK_RES_TY         GENMASK(25, 16)
 287 #define REG_IQK_RES_RX          0x0ea4
 288 #define BIT_MASK_RES_RX         GENMASK(25, 16)
 289 #define REG_IQK_RES_RY          0x0eac
 290 #define BIT_IQK_TX_FAIL         BIT(28)
 291 #define BIT_IQK_RX_FAIL         BIT(27)
 292 #define BIT_IQK_DONE            BIT(26)
 293 #define BIT_MASK_RES_RY         GENMASK(25, 16)
 294 #define REG_PAGE_F_RST_11N              0x0f14
 295 #define BIT_MASK_F_RST_ALL              BIT(16)
 296 #define REG_IGI_C_11N                   0x0f84
 297 #define REG_IGI_D_11N                   0x0f88
 298 #define REG_HT_CRC32_CNT_11N            0x0f90
 299 #define BIT_MASK_HT_CRC_OK              GENMASK(15, 0)
 300 #define BIT_MASK_HT_CRC_ERR             GENMASK(31, 16)
 301 #define REG_OFDM_CRC32_CNT_11N          0x0f94
 302 #define BIT_MASK_OFDM_LCRC_OK           GENMASK(15, 0)
 303 #define BIT_MASK_OFDM_LCRC_ERR          GENMASK(31, 16)
 304 #define REG_HT_CRC32_CNT_11N_AGG        0x0fb8
 305
 306 #endif