xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821ae/phy.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
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