xref: /OK3568_Linux_fs/external/rkwifibt/drivers/rtl8723ds/hal/phydm/txbf/halcomtxbf.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /******************************************************************************
2*4882a593Smuzhiyun  *
3*4882a593Smuzhiyun  * Copyright(c) 2007 - 2017  Realtek Corporation.
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * This program is free software; you can redistribute it and/or modify it
6*4882a593Smuzhiyun  * under the terms of version 2 of the GNU General Public License as
7*4882a593Smuzhiyun  * published by the Free Software Foundation.
8*4882a593Smuzhiyun  *
9*4882a593Smuzhiyun  * This program is distributed in the hope that it will be useful, but WITHOUT
10*4882a593Smuzhiyun  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11*4882a593Smuzhiyun  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
12*4882a593Smuzhiyun  * more details.
13*4882a593Smuzhiyun  *
14*4882a593Smuzhiyun  * The full GNU General Public License is included in this distribution in the
15*4882a593Smuzhiyun  * file called LICENSE.
16*4882a593Smuzhiyun  *
17*4882a593Smuzhiyun  * Contact Information:
18*4882a593Smuzhiyun  * wlanfae <wlanfae@realtek.com>
19*4882a593Smuzhiyun  * Realtek Corporation, No. 2, Innovation Road II, Hsinchu Science Park,
20*4882a593Smuzhiyun  * Hsinchu 300, Taiwan.
21*4882a593Smuzhiyun  *
22*4882a593Smuzhiyun  * Larry Finger <Larry.Finger@lwfinger.net>
23*4882a593Smuzhiyun  *
24*4882a593Smuzhiyun  *****************************************************************************/
25*4882a593Smuzhiyun #ifndef __HAL_COM_TXBF_H__
26*4882a593Smuzhiyun #define __HAL_COM_TXBF_H__
27*4882a593Smuzhiyun 
28*4882a593Smuzhiyun #if 0
29*4882a593Smuzhiyun typedef	bool
30*4882a593Smuzhiyun (*TXBF_GET)(
31*4882a593Smuzhiyun 	void*			adapter,
32*4882a593Smuzhiyun 	u8			get_type,
33*4882a593Smuzhiyun 	void*			p_out_buf
34*4882a593Smuzhiyun 	);
35*4882a593Smuzhiyun 
36*4882a593Smuzhiyun typedef	bool
37*4882a593Smuzhiyun (*TXBF_SET)(
38*4882a593Smuzhiyun 	void*			adapter,
39*4882a593Smuzhiyun 	u8			set_type,
40*4882a593Smuzhiyun 	void*			p_in_buf
41*4882a593Smuzhiyun 	);
42*4882a593Smuzhiyun #endif
43*4882a593Smuzhiyun 
44*4882a593Smuzhiyun enum txbf_set_type {
45*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_ENTER,
46*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_LEAVE,
47*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_RATE,
48*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_STATUS,
49*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_FW_NDPA,
50*4882a593Smuzhiyun 	TXBF_SET_SOUNDING_CLK,
51*4882a593Smuzhiyun 	TXBF_SET_TX_PATH_RESET,
52*4882a593Smuzhiyun 	TXBF_SET_GET_TX_RATE
53*4882a593Smuzhiyun };
54*4882a593Smuzhiyun 
55*4882a593Smuzhiyun enum txbf_get_type {
56*4882a593Smuzhiyun 	TXBF_GET_EXPLICIT_BEAMFORMEE,
57*4882a593Smuzhiyun 	TXBF_GET_EXPLICIT_BEAMFORMER,
58*4882a593Smuzhiyun 	TXBF_GET_MU_MIMO_STA,
59*4882a593Smuzhiyun 	TXBF_GET_MU_MIMO_AP
60*4882a593Smuzhiyun };
61*4882a593Smuzhiyun 
62*4882a593Smuzhiyun /* @2 HAL TXBF related */
63*4882a593Smuzhiyun struct _HAL_TXBF_INFO {
64*4882a593Smuzhiyun 	u8 txbf_idx;
65*4882a593Smuzhiyun 	u8 ndpa_idx;
66*4882a593Smuzhiyun 	u8 BW;
67*4882a593Smuzhiyun 	u8 rate;
68*4882a593Smuzhiyun 
69*4882a593Smuzhiyun 	struct phydm_timer_list txbf_fw_ndpa_timer;
70*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
71*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_enter_work_item;
72*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_leave_work_item;
73*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_fw_ndpa_work_item;
74*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_clk_work_item;
75*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_status_work_item;
76*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_rate_work_item;
77*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_reset_tx_path_work_item;
78*4882a593Smuzhiyun 	RT_WORK_ITEM txbf_get_tx_rate_work_item;
79*4882a593Smuzhiyun #endif
80*4882a593Smuzhiyun };
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun #ifdef PHYDM_BEAMFORMING_SUPPORT
83*4882a593Smuzhiyun 
84*4882a593Smuzhiyun void hal_com_txbf_beamform_init(
85*4882a593Smuzhiyun 	void *dm_void);
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun void hal_com_txbf_config_gtab(
88*4882a593Smuzhiyun 	void *dm_void);
89*4882a593Smuzhiyun 
90*4882a593Smuzhiyun void hal_com_txbf_enter_work_item_callback(
91*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
92*4882a593Smuzhiyun 	void *adapter
93*4882a593Smuzhiyun #else
94*4882a593Smuzhiyun 	void *dm_void
95*4882a593Smuzhiyun #endif
96*4882a593Smuzhiyun 	);
97*4882a593Smuzhiyun 
98*4882a593Smuzhiyun void hal_com_txbf_leave_work_item_callback(
99*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
100*4882a593Smuzhiyun 	void *adapter
101*4882a593Smuzhiyun #else
102*4882a593Smuzhiyun 	void *dm_void
103*4882a593Smuzhiyun #endif
104*4882a593Smuzhiyun 	);
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun void hal_com_txbf_fw_ndpa_work_item_callback(
107*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
108*4882a593Smuzhiyun 	void *adapter
109*4882a593Smuzhiyun #else
110*4882a593Smuzhiyun 	void *dm_void
111*4882a593Smuzhiyun #endif
112*4882a593Smuzhiyun 	);
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun void hal_com_txbf_clk_work_item_callback(
115*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
116*4882a593Smuzhiyun 	void *adapter
117*4882a593Smuzhiyun #else
118*4882a593Smuzhiyun 	void *dm_void
119*4882a593Smuzhiyun #endif
120*4882a593Smuzhiyun 	);
121*4882a593Smuzhiyun 
122*4882a593Smuzhiyun void hal_com_txbf_reset_tx_path_work_item_callback(
123*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
124*4882a593Smuzhiyun 	void *adapter
125*4882a593Smuzhiyun #else
126*4882a593Smuzhiyun 	void *dm_void
127*4882a593Smuzhiyun #endif
128*4882a593Smuzhiyun 	);
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun void hal_com_txbf_get_tx_rate_work_item_callback(
131*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
132*4882a593Smuzhiyun 	void *adapter
133*4882a593Smuzhiyun #else
134*4882a593Smuzhiyun 	void *dm_void
135*4882a593Smuzhiyun #endif
136*4882a593Smuzhiyun 	);
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun void hal_com_txbf_rate_work_item_callback(
139*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
140*4882a593Smuzhiyun 	void *adapter
141*4882a593Smuzhiyun #else
142*4882a593Smuzhiyun 	void *dm_void
143*4882a593Smuzhiyun #endif
144*4882a593Smuzhiyun 	);
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun void hal_com_txbf_fw_ndpa_timer_callback(
147*4882a593Smuzhiyun 	struct phydm_timer_list *timer);
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun void hal_com_txbf_status_work_item_callback(
150*4882a593Smuzhiyun #if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
151*4882a593Smuzhiyun 	void *adapter
152*4882a593Smuzhiyun #else
153*4882a593Smuzhiyun 	void *dm_void
154*4882a593Smuzhiyun #endif
155*4882a593Smuzhiyun 	);
156*4882a593Smuzhiyun 
157*4882a593Smuzhiyun boolean
158*4882a593Smuzhiyun hal_com_txbf_set(
159*4882a593Smuzhiyun 	void *dm_void,
160*4882a593Smuzhiyun 	u8 set_type,
161*4882a593Smuzhiyun 	void *p_in_buf);
162*4882a593Smuzhiyun 
163*4882a593Smuzhiyun boolean
164*4882a593Smuzhiyun hal_com_txbf_get(
165*4882a593Smuzhiyun 	void *adapter,
166*4882a593Smuzhiyun 	u8 get_type,
167*4882a593Smuzhiyun 	void *p_out_buf);
168*4882a593Smuzhiyun 
169*4882a593Smuzhiyun #else
170*4882a593Smuzhiyun #define hal_com_txbf_beamform_init(dm_void) NULL
171*4882a593Smuzhiyun #define hal_com_txbf_config_gtab(dm_void) NULL
172*4882a593Smuzhiyun #define hal_com_txbf_enter_work_item_callback(_adapter) NULL
173*4882a593Smuzhiyun #define hal_com_txbf_leave_work_item_callback(_adapter) NULL
174*4882a593Smuzhiyun #define hal_com_txbf_fw_ndpa_work_item_callback(_adapter) NULL
175*4882a593Smuzhiyun #define hal_com_txbf_clk_work_item_callback(_adapter) NULL
176*4882a593Smuzhiyun #define hal_com_txbf_rate_work_item_callback(_adapter) NULL
177*4882a593Smuzhiyun #define hal_com_txbf_fw_ndpa_timer_callback(_adapter) NULL
178*4882a593Smuzhiyun #define hal_com_txbf_status_work_item_callback(_adapter) NULL
179*4882a593Smuzhiyun #define hal_com_txbf_get(_adapter, _get_type, _pout_buf)
180*4882a593Smuzhiyun 
181*4882a593Smuzhiyun #endif
182*4882a593Smuzhiyun 
183*4882a593Smuzhiyun #endif /*  @#ifndef __HAL_COM_TXBF_H__ */
184