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