xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/rockchip_wlan/rtl8821cs/include/rtl8814b_hal.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /******************************************************************************
3  *
4  * Copyright(c) 2015 - 2017 Realtek Corporation.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of version 2 of the GNU General Public License as
8  * published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13  * more details.
14  *
15  *****************************************************************************/
16 #ifndef _RTL8814B_HAL_H_
17 #define _RTL8814B_HAL_H_
18 
19 #include <osdep_service.h>		/* BIT(x) */
20 #include <drv_types.h>			/* PADAPTER */
21 #include "../hal/halmac/halmac_api.h"	/* MAC REG definition */
22 
23 
24 #ifdef CONFIG_SUPPORT_TRX_SHARED
25 #define MAX_RECVBUF_SZ		46080	/* 45KB, TX: (256-64)KB */
26 #else /* !CONFIG_SUPPORT_TRX_SHARED */
27 #define MAX_RECVBUF_SZ		24576	/* 24KB, TX: 256KB */
28 #endif /* !CONFIG_SUPPORT_TRX_SHARED */
29 
30 #if 0
31 /*
32  * MAC Register definition
33  */
34 #define REG_AFE_XTAL_CTRL	REG_AFE_CTRL1_8814B	/* hal_com.c & phydm */
35 #define REG_AFE_PLL_CTRL	REG_AFE_CTRL2_8814B	/* hal_com.c & phydm */
36 #define REG_MAC_PHY_CTRL	REG_AFE_CTRL3_8814B	/* phydm only */
37 #endif
38 #define REG_LEDCFG0		REG_LED_CFG_8814B	/* rtw_mp.c */
39 #if 0
40 #define MSR			(REG_CR_8814B + 2)	/* rtw_mp.c & hal_com.c */
41 #define MSR1			REG_CR_EXT_8814B	/* rtw_mp.c & hal_com.c */
42 #endif
43 #define REG_C2HEVT_MSG_NORMAL	0x1A0			/* hal_com.c */
44 #if 0
45 #define REG_C2HEVT_CLEAR	0x1AF			/* hal_com.c */
46 
47 #define REG_GPIO_PIN_CTRL_2		REG_GPIO_EXT_CTRL_8814B		/* hal_com.c */
48 #endif
49 #define REG_WKFMCAM_NUM		REG_WKFMCAM_CMD_8814B	/* hal_com.c: WOWLAN */
50 #define REG_WOWLAN_WAKE_REASON	0x01C7 /* hal_com.c: WOWLAN */
51 #define REG_RXPKTBUF_CTRL	(REG_PKTBUF_DBG_CTRL_8814B + 2)	/* hal_com.c: WOWLAN */
52 #define REG_RXPKT_NUM		REG_RXDMA_CTRL_8814B	/* hal_com.c: WOWLAN */
53 
54 /* RXERR_RPT, for rtw_mp.c */
55 #define RXERR_TYPE_OFDM_PPDU		0
56 #define RXERR_TYPE_OFDM_FALSE_ALARM	2
57 #define RXERR_TYPE_OFDM_MPDU_OK		0
58 #define RXERR_TYPE_OFDM_MPDU_FAIL	1
59 #define RXERR_TYPE_CCK_PPDU		3
60 #define RXERR_TYPE_CCK_FALSE_ALARM	5
61 #define RXERR_TYPE_CCK_MPDU_OK		3
62 #define RXERR_TYPE_CCK_MPDU_FAIL	4
63 #define RXERR_TYPE_HT_PPDU		8
64 #define RXERR_TYPE_HT_FALSE_ALARM	9
65 #define RXERR_TYPE_HT_MPDU_TOTAL	6
66 #define RXERR_TYPE_HT_MPDU_OK		6
67 #define RXERR_TYPE_HT_MPDU_FAIL		7
68 #define RXERR_TYPE_RX_FULL_DROP		10
69 
70 #define RXERR_COUNTER_MASK		BIT_MASK_RPT_COUNTER_8814B
71 #define RXERR_RPT_RST			BIT_RXERR_RPT_RST_8814B
72 #define _RXERR_RPT_SEL(type)		(BIT_RXERR_RPT_SEL_V1_3_0_8814B(type) \
73 					| ((type & 0x10) ? BIT_RXERR_RPT_SEL_V1_4_8814B : 0))
74 
75 /* hal_com.c:rtw_lps_state_chk() */
76 #define BIT_PWRBIT_OW_EN		BIT_WMAC_TCRPWRMGT_HWDATA_EN_8814B
77 
78 /*
79  * BB Register definition
80  */
81 #define rPMAC_Reset			0x100	/* hal_mp.c */
82 
83 #define	rFPGA0_RFMOD			0x800
84 #define rFPGA0_TxInfo			0x804
85 #define rOFDMCCKEN_Jaguar		0x808	/* hal_mp.c */
86 #define rFPGA0_TxGainStage		0x80C	/* phydm only */
87 #define rFPGA0_XA_HSSIParameter1	0x820	/* hal_mp.c */
88 #define rFPGA0_XA_HSSIParameter2	0x824	/* hal_mp.c */
89 #define rFPGA0_XB_HSSIParameter1	0x828	/* hal_mp.c */
90 #define rFPGA0_XB_HSSIParameter2	0x82C	/* hal_mp.c */
91 #define rTxAGC_B_Rate18_06		0x830
92 #define rTxAGC_B_Rate54_24		0x834
93 #define rTxAGC_B_CCK1_55_Mcs32		0x838
94 #define rCCAonSec_Jaguar		0x838	/* hal_mp.c */
95 #define rTxAGC_B_Mcs03_Mcs00		0x83C
96 #define rTxAGC_B_Mcs07_Mcs04		0x848
97 #define rTxAGC_B_Mcs11_Mcs08		0x84C
98 #define rFPGA0_XA_RFInterfaceOE		0x860
99 #define rFPGA0_XB_RFInterfaceOE		0x864
100 #define rTxAGC_B_Mcs15_Mcs12		0x868
101 #define rTxAGC_B_CCK11_A_CCK2_11	0x86C
102 #define rFPGA0_XAB_RFInterfaceSW	0x870
103 #define rFPGA0_XAB_RFParameter		0x878
104 #define rFPGA0_AnalogParameter4		0x88C	/* hal_mp.c & phydm */
105 #define rFPGA0_XB_LSSIReadBack		0x8A4	/* phydm */
106 #define rHSSIRead_Jaguar		0x8B0	/* RF read addr (rtl8814b_phy.c) */
107 
108 #define	rC_TxScale_Jaguar2		0x181C  /* Pah_C TX scaling factor (hal_mp.c) */
109 #define	rC_IGI_Jaguar2			0x1850	/* Initial Gain for path-C (hal_mp.c) */
110 
111 #define rFPGA1_TxInfo			0x90C	/* hal_mp.c */
112 #define rSingleTone_ContTx_Jaguar	0x914	/* hal_mp.c */
113 /* TX BeamForming */
114 #define REG_BB_TX_PATH_SEL_1_8814B	0x93C	/* rtl8814b_phy.c */
115 #define REG_BB_TX_PATH_SEL_2_8814B	0x940	/* rtl8814b_phy.c */
116 
117 /* TX BeamForming */
118 #define REG_BB_TXBF_ANT_SET_BF1_8814B	0x19AC	/* rtl8814b_phy.c */
119 #define REG_BB_TXBF_ANT_SET_BF0_8814B	0x19B4	/* rtl8814b_phy.c */
120 
121 #define rCCK0_System			0xA00
122 #define rCCK0_AFESetting		0xA04
123 
124 #define rCCK0_DSPParameter2		0xA1C
125 #define rCCK0_TxFilter1			0xA20
126 #define rCCK0_TxFilter2			0xA24
127 #define rCCK0_DebugPort			0xA28
128 #define rCCK0_FalseAlarmReport		0xA2C
129 
130 #define	rD_TxScale_Jaguar2		0x1A1C  /* Path_D TX scaling factor (hal_mp.c) */
131 #define	rD_IGI_Jaguar2			0x1A50	/* Initial Gain for path-D (hal_mp.c) */
132 
133 #define rOFDM0_TRxPathEnable		0xC04
134 #define rOFDM0_TRMuxPar			0xC08
135 #define rA_TxScale_Jaguar		0xC1C	/* Pah_A TX scaling factor (hal_mp.c) */
136 #define rOFDM0_RxDetector1		0xC30	/* rtw_mp.c */
137 #define rOFDM0_ECCAThreshold		0xC4C	/* phydm only */
138 #define rOFDM0_XAAGCCore1		0xC50	/* phydm only */
139 #define rA_IGI_Jaguar			0xC50	/* Initial Gain for path-A (hal_mp.c) */
140 #define rOFDM0_XBAGCCore1		0xC58	/* phydm only */
141 #define rOFDM0_XATxIQImbalance		0xC80	/* phydm only */
142 #define rA_LSSIWrite_Jaguar		0xC90	/* RF write addr, LSSI Parameter (rtl8814b_phy.c) */
143 
144 #define rOFDM1_LSTF			0xD00
145 #define rOFDM1_TRxPathEnable		0xD04	/* hal_mp.c */
146 #define rA_PIRead_Jaguar		0xD04	/* RF readback with PI (rtl8814b_phy.c) */
147 #define rA_SIRead_Jaguar		0xD08	/* RF readback with SI (rtl8814b_phy.c) */
148 #define rB_PIRead_Jaguar		0xD44	/* RF readback with PI (rtl8814b_phy.c) */
149 #define rB_SIRead_Jaguar		0xD48	/* RF readback with SI (rtl8814b_phy.c) */
150 
151 #define rTxAGC_A_Rate18_06		0xE00
152 #define rTxAGC_A_Rate54_24		0xE04
153 #define rTxAGC_A_CCK1_Mcs32		0xE08
154 #define rTxAGC_A_Mcs03_Mcs00		0xE10
155 #define rTxAGC_A_Mcs07_Mcs04		0xE14
156 #define rTxAGC_A_Mcs11_Mcs08		0xE18
157 #define rTxAGC_A_Mcs15_Mcs12		0xE1C
158 #define rB_TxScale_Jaguar		0xE1C	/* Path_B TX scaling factor (hal_mp.c) */
159 #define rB_IGI_Jaguar			0xE50	/* Initial Gain for path-B (hal_mp.c) */
160 #define rB_LSSIWrite_Jaguar		0xE90	/* RF write addr, LSSI Parameter (rtl8814b_phy.c) */
161 /* RFE */
162 #define rA_RFE_Pinmux_Jaguar	0xCB0	/* hal_mp.c */
163 #define	rB_RFE_Pinmux_Jaguar	0xEB0	/* Path_B RFE control pinmux */
164 #define	rA_RFE_Inv_Jaguar		0xCB4	/* Path_A RFE cotrol */
165 #define	rB_RFE_Inv_Jaguar		0xEB4	/* Path_B RFE control */
166 #define	rA_RFE_Jaguar			0xCB8 	/* Path_A RFE cotrol */
167 #define	rB_RFE_Jaguar			0xEB8	/* Path_B RFE control */
168 #define	rA_RFE_Inverse_Jaguar	0xCBC	/* Path_A RFE control inverse */
169 #define	rB_RFE_Inverse_Jaguar	0xEBC	/* Path_B RFE control inverse */
170 #define	r_ANTSEL_SW_Jaguar		0x900	/* ANTSEL SW Control */
171 #define	bMask_RFEInv_Jaguar	0x3FF00000
172 #define	bMask_AntselPathFollow_Jaguar 0x00030000
173 
174 #define		rC_RFE_Pinmux_Jaguar	0x18B4	/* Path_C RFE cotrol pinmux*/
175 #define		rD_RFE_Pinmux_Jaguar	0x1AB4	/* Path_D RFE cotrol pinmux*/
176 #define		rA_RFE_Sel_Jaguar2		0x1990
177 
178 /* Page1(0x100) */
179 #define bBBResetB			0x100
180 
181 /* Page8(0x800) */
182 #define bCCKEn				0x1000000
183 #define bOFDMEn				0x2000000
184 /* Reg 0x80C rFPGA0_TxGainStage */
185 #define bXBTxAGC			0xF00
186 #define bXCTxAGC			0xF000
187 #define bXDTxAGC			0xF0000
188 
189 /* PageA(0xA00) */
190 #define bCCKBBMode			0x3
191 
192 #define bCCKScramble			0x8
193 #define bCCKTxRate			0x3000
194 
195 /* General */
196 #define bMaskByte0		0xFF		/* mp, rtw_odm.c & phydm */
197 #define bMaskByte1		0xFF00		/* hal_mp.c & phydm */
198 #define bMaskByte2		0xFF0000	/* hal_mp.c & phydm */
199 #define bMaskByte3		0xFF000000	/* hal_mp.c & phydm */
200 #define bMaskHWord		0xFFFF0000	/* hal_com.c, rtw_mp.c */
201 #define bMaskLWord		0x0000FFFF	/* mp, hal_com.c & phydm */
202 #define bMaskDWord		0xFFFFFFFF	/* mp, hal, rtw_odm.c & phydm */
203 
204 #define bEnable			0x1		/* hal_mp.c, rtw_mp.c */
205 #define bDisable		0x0		/* rtw_mp.c */
206 
207 #define MAX_STALL_TIME		50		/* unit: us, hal_com_phycfg.c */
208 
209 #define Rx_Smooth_Factor	20		/* phydm only */
210 
211 /*
212  * RF Register definition
213  */
214 #define RF_AC			0x00
215 #define RF_AC_Jaguar		0x00	/* hal_mp.c */
216 #define RF_CHNLBW		0x18	/* rtl8814b_phy.c */
217 #define RF_ModeTableAddr	0x30	/* rtl8814b_phy.c */
218 #define RF_ModeTableData0	0x31	/* rtl8814b_phy.c */
219 #define RF_ModeTableData1	0x32	/* rtl8814b_phy.c */
220 #define RF_0x52			0x52
221 #define RF_WeLut_Jaguar		0xEF	/* rtl8814b_phy.c */
222 
223 /* General Functions */
224 void rtl8814b_init_hal_spec(PADAPTER);				/* hal/hal_com.c */
225 
226 #ifdef CONFIG_MP_INCLUDED
227 /* MP Functions */
228 #include <rtw_mp.h>		/* struct mp_priv */
229 void rtl8814b_prepare_mp_txdesc(PADAPTER, struct mp_priv *);	/* rtw_mp.c */
230 void rtl8814b_mp_config_rfpath(PADAPTER);			/* hal_mp.c */
231 #endif
232 void hw_var_set_dl_rsvd_page(PADAPTER adapter, u8 mstatus);
233 
234 #ifdef CONFIG_USB_HCI
235 #include <rtl8814bu_hal.h>
236 #elif defined(CONFIG_PCI_HCI)
237 #include <rtl8814be_hal.h>
238 #endif
239 
240 #endif /* _RTL8814B_HAL_H_ */
241