1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0 */ 2*4882a593Smuzhiyun /* Copyright(c) 2009-2010 Realtek Corporation.*/ 3*4882a593Smuzhiyun 4*4882a593Smuzhiyun #ifndef __RTL8821AE_PHY_H__ 5*4882a593Smuzhiyun #define __RTL8821AE_PHY_H__ 6*4882a593Smuzhiyun 7*4882a593Smuzhiyun /* MAX_TX_COUNT must always be set to 4, otherwise read 8*4882a593Smuzhiyun * efuse table sequence will be wrong. 9*4882a593Smuzhiyun */ 10*4882a593Smuzhiyun #define MAX_TX_COUNT 4 11*4882a593Smuzhiyun #define TX_1S 0 12*4882a593Smuzhiyun #define TX_2S 1 13*4882a593Smuzhiyun #define TX_3S 2 14*4882a593Smuzhiyun #define TX_4S 3 15*4882a593Smuzhiyun 16*4882a593Smuzhiyun #define MAX_POWER_INDEX 0x3F 17*4882a593Smuzhiyun 18*4882a593Smuzhiyun #define MAX_PRECMD_CNT 16 19*4882a593Smuzhiyun #define MAX_RFDEPENDCMD_CNT 16 20*4882a593Smuzhiyun #define MAX_POSTCMD_CNT 16 21*4882a593Smuzhiyun 22*4882a593Smuzhiyun #define MAX_DOZE_WAITING_TIMES_9x 64 23*4882a593Smuzhiyun 24*4882a593Smuzhiyun #define RT_CANNOT_IO(hw) false 25*4882a593Smuzhiyun #define HIGHPOWER_RADIOA_ARRAYLEN 22 26*4882a593Smuzhiyun 27*4882a593Smuzhiyun #define IQK_ADDA_REG_NUM 16 28*4882a593Smuzhiyun #define IQK_BB_REG_NUM 9 29*4882a593Smuzhiyun #define MAX_TOLERANCE 5 30*4882a593Smuzhiyun #define IQK_DELAY_TIME 10 31*4882a593Smuzhiyun #define index_mapping_NUM 15 32*4882a593Smuzhiyun 33*4882a593Smuzhiyun #define APK_BB_REG_NUM 5 34*4882a593Smuzhiyun #define APK_AFE_REG_NUM 16 35*4882a593Smuzhiyun #define APK_CURVE_REG_NUM 4 36*4882a593Smuzhiyun #define PATH_NUM 2 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun #define LOOP_LIMIT 5 39*4882a593Smuzhiyun #define MAX_STALL_TIME 50 40*4882a593Smuzhiyun #define ANTENNADIVERSITYVALUE 0x80 41*4882a593Smuzhiyun #define MAX_TXPWR_IDX_NMODE_92S 63 42*4882a593Smuzhiyun #define RESET_CNT_LIMIT 3 43*4882a593Smuzhiyun 44*4882a593Smuzhiyun #define IQK_ADDA_REG_NUM 16 45*4882a593Smuzhiyun #define IQK_MAC_REG_NUM 4 46*4882a593Smuzhiyun 47*4882a593Smuzhiyun #define RF6052_MAX_PATH 2 48*4882a593Smuzhiyun 49*4882a593Smuzhiyun #define CT_OFFSET_MAC_ADDR 0X16 50*4882a593Smuzhiyun 51*4882a593Smuzhiyun #define CT_OFFSET_CCK_TX_PWR_IDX 0x5A 52*4882a593Smuzhiyun #define CT_OFFSET_HT401S_TX_PWR_IDX 0x60 53*4882a593Smuzhiyun #define CT_OFFSET_HT402S_TX_PWR_IDX_DIFF 0x66 54*4882a593Smuzhiyun #define CT_OFFSET_HT20_TX_PWR_IDX_DIFF 0x69 55*4882a593Smuzhiyun #define CT_OFFSET_OFDM_TX_PWR_IDX_DIFF 0x6C 56*4882a593Smuzhiyun 57*4882a593Smuzhiyun #define CT_OFFSET_HT40_MAX_PWR_OFFSET 0x6F 58*4882a593Smuzhiyun #define CT_OFFSET_HT20_MAX_PWR_OFFSET 0x72 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun #define CT_OFFSET_CHANNEL_PLAH 0x75 61*4882a593Smuzhiyun #define CT_OFFSET_THERMAL_METER 0x78 62*4882a593Smuzhiyun #define CT_OFFSET_RF_OPTION 0x79 63*4882a593Smuzhiyun #define CT_OFFSET_VERSION 0x7E 64*4882a593Smuzhiyun #define CT_OFFSET_CUSTOMER_ID 0x7F 65*4882a593Smuzhiyun 66*4882a593Smuzhiyun #define RTL8821AE_MAX_PATH_NUM 2 67*4882a593Smuzhiyun 68*4882a593Smuzhiyun #define TARGET_CHNL_NUM_2G_5G_8812 59 69*4882a593Smuzhiyun 70*4882a593Smuzhiyun enum swchnlcmd_id { 71*4882a593Smuzhiyun CMDID_END, 72*4882a593Smuzhiyun CMDID_SET_TXPOWEROWER_LEVEL, 73*4882a593Smuzhiyun CMDID_BBREGWRITE10, 74*4882a593Smuzhiyun CMDID_WRITEPORT_ULONG, 75*4882a593Smuzhiyun CMDID_WRITEPORT_USHORT, 76*4882a593Smuzhiyun CMDID_WRITEPORT_UCHAR, 77*4882a593Smuzhiyun CMDID_RF_WRITEREG, 78*4882a593Smuzhiyun }; 79*4882a593Smuzhiyun 80*4882a593Smuzhiyun struct swchnlcmd { 81*4882a593Smuzhiyun enum swchnlcmd_id cmdid; 82*4882a593Smuzhiyun u32 para1; 83*4882a593Smuzhiyun u32 para2; 84*4882a593Smuzhiyun u32 msdelay; 85*4882a593Smuzhiyun }; 86*4882a593Smuzhiyun 87*4882a593Smuzhiyun enum hw90_block_e { 88*4882a593Smuzhiyun HW90_BLOCK_MAC = 0, 89*4882a593Smuzhiyun HW90_BLOCK_PHY0 = 1, 90*4882a593Smuzhiyun HW90_BLOCK_PHY1 = 2, 91*4882a593Smuzhiyun HW90_BLOCK_RF = 3, 92*4882a593Smuzhiyun HW90_BLOCK_MAXIMUM = 4, 93*4882a593Smuzhiyun }; 94*4882a593Smuzhiyun 95*4882a593Smuzhiyun enum baseband_config_type { 96*4882a593Smuzhiyun BASEBAND_CONFIG_PHY_REG = 0, 97*4882a593Smuzhiyun BASEBAND_CONFIG_AGC_TAB = 1, 98*4882a593Smuzhiyun }; 99*4882a593Smuzhiyun 100*4882a593Smuzhiyun enum ra_offset_area { 101*4882a593Smuzhiyun RA_OFFSET_LEGACY_OFDM1, 102*4882a593Smuzhiyun RA_OFFSET_LEGACY_OFDM2, 103*4882a593Smuzhiyun RA_OFFSET_HT_OFDM1, 104*4882a593Smuzhiyun RA_OFFSET_HT_OFDM2, 105*4882a593Smuzhiyun RA_OFFSET_HT_OFDM3, 106*4882a593Smuzhiyun RA_OFFSET_HT_OFDM4, 107*4882a593Smuzhiyun RA_OFFSET_HT_CCK, 108*4882a593Smuzhiyun }; 109*4882a593Smuzhiyun 110*4882a593Smuzhiyun enum antenna_path { 111*4882a593Smuzhiyun ANTENNA_NONE, 112*4882a593Smuzhiyun ANTENNA_D, 113*4882a593Smuzhiyun ANTENNA_C, 114*4882a593Smuzhiyun ANTENNA_CD, 115*4882a593Smuzhiyun ANTENNA_B, 116*4882a593Smuzhiyun ANTENNA_BD, 117*4882a593Smuzhiyun ANTENNA_BC, 118*4882a593Smuzhiyun ANTENNA_BCD, 119*4882a593Smuzhiyun ANTENNA_A, 120*4882a593Smuzhiyun ANTENNA_AD, 121*4882a593Smuzhiyun ANTENNA_AC, 122*4882a593Smuzhiyun ANTENNA_ACD, 123*4882a593Smuzhiyun ANTENNA_AB, 124*4882a593Smuzhiyun ANTENNA_ABD, 125*4882a593Smuzhiyun ANTENNA_ABC, 126*4882a593Smuzhiyun ANTENNA_ABCD 127*4882a593Smuzhiyun }; 128*4882a593Smuzhiyun 129*4882a593Smuzhiyun struct r_antenna_select_ofdm { 130*4882a593Smuzhiyun u32 r_tx_antenna:4; 131*4882a593Smuzhiyun u32 r_ant_l:4; 132*4882a593Smuzhiyun u32 r_ant_non_ht:4; 133*4882a593Smuzhiyun u32 r_ant_ht1:4; 134*4882a593Smuzhiyun u32 r_ant_ht2:4; 135*4882a593Smuzhiyun u32 r_ant_ht_s1:4; 136*4882a593Smuzhiyun u32 r_ant_non_ht_s1:4; 137*4882a593Smuzhiyun u32 ofdm_txsc:2; 138*4882a593Smuzhiyun u32 reserved:2; 139*4882a593Smuzhiyun }; 140*4882a593Smuzhiyun 141*4882a593Smuzhiyun struct r_antenna_select_cck { 142*4882a593Smuzhiyun u8 r_cckrx_enable_2:2; 143*4882a593Smuzhiyun u8 r_cckrx_enable:2; 144*4882a593Smuzhiyun u8 r_ccktx_enable:4; 145*4882a593Smuzhiyun }; 146*4882a593Smuzhiyun 147*4882a593Smuzhiyun struct efuse_contents { 148*4882a593Smuzhiyun u8 mac_addr[ETH_ALEN]; 149*4882a593Smuzhiyun u8 cck_tx_power_idx[6]; 150*4882a593Smuzhiyun u8 ht40_1s_tx_power_idx[6]; 151*4882a593Smuzhiyun u8 ht40_2s_tx_power_idx_diff[3]; 152*4882a593Smuzhiyun u8 ht20_tx_power_idx_diff[3]; 153*4882a593Smuzhiyun u8 ofdm_tx_power_idx_diff[3]; 154*4882a593Smuzhiyun u8 ht40_max_power_offset[3]; 155*4882a593Smuzhiyun u8 ht20_max_power_offset[3]; 156*4882a593Smuzhiyun u8 channel_plan; 157*4882a593Smuzhiyun u8 thermal_meter; 158*4882a593Smuzhiyun u8 rf_option[5]; 159*4882a593Smuzhiyun u8 version; 160*4882a593Smuzhiyun u8 oem_id; 161*4882a593Smuzhiyun u8 regulatory; 162*4882a593Smuzhiyun }; 163*4882a593Smuzhiyun 164*4882a593Smuzhiyun struct tx_power_struct { 165*4882a593Smuzhiyun u8 cck[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 166*4882a593Smuzhiyun u8 ht40_1s[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 167*4882a593Smuzhiyun u8 ht40_2s[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 168*4882a593Smuzhiyun u8 ht20_diff[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 169*4882a593Smuzhiyun u8 legacy_ht_diff[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 170*4882a593Smuzhiyun u8 legacy_ht_txpowerdiff; 171*4882a593Smuzhiyun u8 groupht20[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 172*4882a593Smuzhiyun u8 groupht40[RTL8821AE_MAX_PATH_NUM][CHANNEL_MAX_NUMBER]; 173*4882a593Smuzhiyun u8 pwrgroup_cnt; 174*4882a593Smuzhiyun u32 mcs_original_offset[4][16]; 175*4882a593Smuzhiyun }; 176*4882a593Smuzhiyun enum _ANT_DIV_TYPE { 177*4882a593Smuzhiyun NO_ANTDIV = 0xFF, 178*4882a593Smuzhiyun CG_TRX_HW_ANTDIV = 0x01, 179*4882a593Smuzhiyun CGCS_RX_HW_ANTDIV = 0x02, 180*4882a593Smuzhiyun FIXED_HW_ANTDIV = 0x03, 181*4882a593Smuzhiyun CG_TRX_SMART_ANTDIV = 0x04, 182*4882a593Smuzhiyun CGCS_RX_SW_ANTDIV = 0x05, 183*4882a593Smuzhiyun 184*4882a593Smuzhiyun }; 185*4882a593Smuzhiyun 186*4882a593Smuzhiyun u32 rtl8821ae_phy_query_bb_reg(struct ieee80211_hw *hw, 187*4882a593Smuzhiyun u32 regaddr, u32 bitmask); 188*4882a593Smuzhiyun void rtl8821ae_phy_set_bb_reg(struct ieee80211_hw *hw, 189*4882a593Smuzhiyun u32 regaddr, u32 bitmask, u32 data); 190*4882a593Smuzhiyun u32 rtl8821ae_phy_query_rf_reg(struct ieee80211_hw *hw, 191*4882a593Smuzhiyun enum radio_path rfpath, u32 regaddr, 192*4882a593Smuzhiyun u32 bitmask); 193*4882a593Smuzhiyun void rtl8821ae_phy_set_rf_reg(struct ieee80211_hw *hw, 194*4882a593Smuzhiyun enum radio_path rfpath, u32 regaddr, 195*4882a593Smuzhiyun u32 bitmask, u32 data); 196*4882a593Smuzhiyun bool rtl8821ae_phy_mac_config(struct ieee80211_hw *hw); 197*4882a593Smuzhiyun bool rtl8821ae_phy_bb_config(struct ieee80211_hw *hw); 198*4882a593Smuzhiyun bool rtl8821ae_phy_rf_config(struct ieee80211_hw *hw); 199*4882a593Smuzhiyun void rtl8821ae_phy_switch_wirelessband(struct ieee80211_hw *hw, 200*4882a593Smuzhiyun u8 band); 201*4882a593Smuzhiyun void rtl8821ae_phy_get_hw_reg_originalvalue(struct ieee80211_hw *hw); 202*4882a593Smuzhiyun void rtl8821ae_phy_get_txpower_level(struct ieee80211_hw *hw, 203*4882a593Smuzhiyun long *powerlevel); 204*4882a593Smuzhiyun void rtl8821ae_phy_set_txpower_level(struct ieee80211_hw *hw, 205*4882a593Smuzhiyun u8 channel); 206*4882a593Smuzhiyun void rtl8821ae_phy_scan_operation_backup(struct ieee80211_hw *hw, 207*4882a593Smuzhiyun u8 operation); 208*4882a593Smuzhiyun void rtl8821ae_phy_set_bw_mode_callback(struct ieee80211_hw *hw); 209*4882a593Smuzhiyun void rtl8821ae_phy_set_bw_mode(struct ieee80211_hw *hw, 210*4882a593Smuzhiyun enum nl80211_channel_type ch_type); 211*4882a593Smuzhiyun void rtl8821ae_phy_sw_chnl_callback(struct ieee80211_hw *hw); 212*4882a593Smuzhiyun u8 rtl8821ae_phy_sw_chnl(struct ieee80211_hw *hw); 213*4882a593Smuzhiyun void rtl8821ae_phy_iq_calibrate(struct ieee80211_hw *hw, 214*4882a593Smuzhiyun bool b_recovery); 215*4882a593Smuzhiyun void rtl8812ae_phy_iq_calibrate(struct ieee80211_hw *hw, 216*4882a593Smuzhiyun bool b_recovery); 217*4882a593Smuzhiyun void rtl8821ae_phy_ap_calibrate(struct ieee80211_hw *hw, s8 delta); 218*4882a593Smuzhiyun void rtl8821ae_phy_lc_calibrate(struct ieee80211_hw *hw); 219*4882a593Smuzhiyun void rtl8821ae_phy_set_rfpath_switch(struct ieee80211_hw *hw, bool bmain); 220*4882a593Smuzhiyun bool rtl8812ae_phy_config_rf_with_headerfile(struct ieee80211_hw *hw, 221*4882a593Smuzhiyun enum radio_path rfpath); 222*4882a593Smuzhiyun bool rtl8821ae_phy_config_rf_with_headerfile(struct ieee80211_hw *hw, 223*4882a593Smuzhiyun enum radio_path rfpath); 224*4882a593Smuzhiyun bool rtl8821ae_phy_set_io_cmd(struct ieee80211_hw *hw, enum io_type iotype); 225*4882a593Smuzhiyun bool rtl8821ae_phy_set_rf_power_state(struct ieee80211_hw *hw, 226*4882a593Smuzhiyun enum rf_pwrstate rfpwr_state); 227*4882a593Smuzhiyun u8 _rtl8812ae_get_right_chnl_place_for_iqk(u8 chnl); 228*4882a593Smuzhiyun void rtl8821ae_phy_set_txpower_level_by_path(struct ieee80211_hw *hw, 229*4882a593Smuzhiyun u8 channel, u8 path); 230*4882a593Smuzhiyun void rtl8812ae_do_iqk(struct ieee80211_hw *hw, u8 delta_thermal_index, 231*4882a593Smuzhiyun u8 thermal_value, u8 threshold); 232*4882a593Smuzhiyun void rtl8821ae_do_iqk(struct ieee80211_hw *hw, u8 delta_thermal_index, 233*4882a593Smuzhiyun u8 thermal_value, u8 threshold); 234*4882a593Smuzhiyun void rtl8821ae_reset_iqk_result(struct ieee80211_hw *hw); 235*4882a593Smuzhiyun u32 phy_get_tx_swing_8812A(struct ieee80211_hw *hw, u8 band, u8 rf_path); 236*4882a593Smuzhiyun 237*4882a593Smuzhiyun #endif 238