GNU Linux-libre 4.14.266-gnu1
[releases.git] / drivers / staging / rtl8188eu / include / hal_intf.h
1 /******************************************************************************
2  *
3  * Copyright(c) 2007 - 2012 Realtek Corporation. All rights reserved.
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of version 2 of the GNU General Public License as
7  * published by the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12  * more details.
13  *
14  ******************************************************************************/
15 #ifndef __HAL_INTF_H__
16 #define __HAL_INTF_H__
17
18 #include <osdep_service.h>
19 #include <drv_types.h>
20 #include <Hal8188EPhyCfg.h>
21
22 enum RTL871X_HCI_TYPE {
23         RTW_PCIE        = BIT(0),
24         RTW_USB         = BIT(1),
25         RTW_SDIO        = BIT(2),
26         RTW_GSPI        = BIT(3),
27 };
28
29 enum _CHIP_TYPE {
30         NULL_CHIP_TYPE,
31         RTL8712_8188S_8191S_8192S,
32         RTL8188C_8192C,
33         RTL8192D,
34         RTL8723A,
35         RTL8188E,
36         MAX_CHIP_TYPE
37 };
38
39 enum hw_variables {
40         HW_VAR_MEDIA_STATUS,
41         HW_VAR_MEDIA_STATUS1,
42         HW_VAR_SET_OPMODE,
43         HW_VAR_MAC_ADDR,
44         HW_VAR_BSSID,
45         HW_VAR_INIT_RTS_RATE,
46         HW_VAR_BASIC_RATE,
47         HW_VAR_TXPAUSE,
48         HW_VAR_BCN_FUNC,
49         HW_VAR_CORRECT_TSF,
50         HW_VAR_CHECK_BSSID,
51         HW_VAR_MLME_DISCONNECT,
52         HW_VAR_MLME_SITESURVEY,
53         HW_VAR_MLME_JOIN,
54         HW_VAR_BEACON_INTERVAL,
55         HW_VAR_SLOT_TIME,
56         HW_VAR_RESP_SIFS,
57         HW_VAR_ACK_PREAMBLE,
58         HW_VAR_SEC_CFG,
59         HW_VAR_BCN_VALID,
60         HW_VAR_DM_FUNC_OP,
61         HW_VAR_DM_FUNC_SET,
62         HW_VAR_DM_FUNC_CLR,
63         HW_VAR_CAM_EMPTY_ENTRY,
64         HW_VAR_CAM_INVALID_ALL,
65         HW_VAR_CAM_WRITE,
66         HW_VAR_CAM_READ,
67         HW_VAR_AC_PARAM_VO,
68         HW_VAR_AC_PARAM_VI,
69         HW_VAR_AC_PARAM_BE,
70         HW_VAR_AC_PARAM_BK,
71         HW_VAR_ACM_CTRL,
72         HW_VAR_AMPDU_MIN_SPACE,
73         HW_VAR_AMPDU_FACTOR,
74         HW_VAR_RXDMA_AGG_PG_TH,
75         HW_VAR_SET_RPWM,
76         HW_VAR_H2C_FW_PWRMODE,
77         HW_VAR_H2C_FW_JOINBSSRPT,
78         HW_VAR_FWLPS_RF_ON,
79         HW_VAR_H2C_FW_P2P_PS_OFFLOAD,
80         HW_VAR_TDLS_WRCR,
81         HW_VAR_TDLS_INIT_CH_SEN,
82         HW_VAR_TDLS_RS_RCR,
83         HW_VAR_TDLS_DONE_CH_SEN,
84         HW_VAR_INITIAL_GAIN,
85         HW_VAR_TRIGGER_GPIO_0,
86         HW_VAR_BT_SET_COEXIST,
87         HW_VAR_BT_ISSUE_DELBA,
88         HW_VAR_CURRENT_ANTENNA,
89         HW_VAR_ANTENNA_DIVERSITY_LINK,
90         HW_VAR_ANTENNA_DIVERSITY_SELECT,
91         HW_VAR_SWITCH_EPHY_WoWLAN,
92         HW_VAR_EFUSE_USAGE,
93         HW_VAR_EFUSE_BYTES,
94         HW_VAR_EFUSE_BT_USAGE,
95         HW_VAR_EFUSE_BT_BYTES,
96         HW_VAR_FIFO_CLEARN_UP,
97         HW_VAR_CHECK_TXBUF,
98         HW_VAR_APFM_ON_MAC, /* Auto FSM to Turn On, include clock, isolation,
99                              * power control for MAC only */
100         /*  The valid upper nav range for the HW updating, if the true value is
101          *  larger than the upper range, the HW won't update it. */
102         /*  Unit in microsecond. 0 means disable this function. */
103         HW_VAR_NAV_UPPER,
104         HW_VAR_RPT_TIMER_SETTING,
105         HW_VAR_TX_RPT_MAX_MACID,
106         HW_VAR_H2C_MEDIA_STATUS_RPT,
107         HW_VAR_CHK_HI_QUEUE_EMPTY,
108 };
109
110 enum hal_def_variable {
111         HAL_DEF_UNDERCORATEDSMOOTHEDPWDB,
112         HAL_DEF_IS_SUPPORT_ANT_DIV,
113         HAL_DEF_CURRENT_ANTENNA,
114         HAL_DEF_DRVINFO_SZ,
115         HAL_DEF_MAX_RECVBUF_SZ,
116         HAL_DEF_RX_PACKET_OFFSET,
117         HAL_DEF_DBG_DUMP_RXPKT,/* for dbg */
118         HAL_DEF_DBG_DM_FUNC,/* for dbg */
119         HAL_DEF_RA_DECISION_RATE,
120         HAL_DEF_RA_SGI,
121         HAL_DEF_PT_PWR_STATUS,
122         HW_VAR_MAX_RX_AMPDU_FACTOR,
123         HW_DEF_RA_INFO_DUMP,
124         HAL_DEF_DBG_DUMP_TXPKT,
125         HW_DEF_FA_CNT_DUMP,
126         HW_DEF_ODM_DBG_FLAG,
127 };
128
129 enum hal_odm_variable {
130         HAL_ODM_STA_INFO,
131         HAL_ODM_P2P_STATE,
132         HAL_ODM_WIFI_DISPLAY_STATE,
133 };
134
135 enum hal_intf_ps_func {
136         HAL_USB_SELECT_SUSPEND,
137         HAL_MAX_ID,
138 };
139
140 enum rt_eeprom_type {
141         EEPROM_93C46,
142         EEPROM_93C56,
143         EEPROM_BOOT_EFUSE,
144 };
145
146 #define RF_CHANGE_BY_INIT       0
147 #define RF_CHANGE_BY_IPS        BIT(28)
148 #define RF_CHANGE_BY_PS         BIT(29)
149 #define RF_CHANGE_BY_HW         BIT(30)
150 #define RF_CHANGE_BY_SW         BIT(31)
151
152 enum hardware_type {
153         HARDWARE_TYPE_RTL8188EU,
154         HARDWARE_TYPE_MAX,
155 };
156
157 #define GET_EEPROM_EFUSE_PRIV(adapter) (&adapter->eeprompriv)
158
159 #define is_boot_from_eeprom(adapter) (adapter->eeprompriv.EepromOrEfuse)
160
161 void UpdateHalRAMask8188EUsb(struct adapter *adapt, u32 mac_id, u8 rssi_level);
162 u32 rtl8188eu_hal_deinit(struct adapter *Adapter);
163 u32 rtl8188eu_hal_init(struct adapter *Adapter);
164 void rtw_hal_def_value_init(struct adapter *padapter);
165
166 void    rtw_hal_free_data(struct adapter *padapter);
167
168 void rtw_hal_dm_init(struct adapter *padapter);
169 void rtw_hal_sw_led_init(struct adapter *padapter);
170 void rtw_hal_sw_led_deinit(struct adapter *padapter);
171
172 u32 rtw_hal_power_on(struct adapter *padapter);
173 uint rtw_hal_init(struct adapter *padapter);
174 uint rtw_hal_deinit(struct adapter *padapter);
175 void rtw_hal_stop(struct adapter *padapter);
176 void rtw_hal_set_hwreg(struct adapter *padapter, u8 variable, u8 *val);
177 void rtw_hal_get_hwreg(struct adapter *padapter, u8 variable, u8 *val);
178
179 void rtw_hal_chip_configure(struct adapter *padapter);
180 void rtw_hal_read_chip_info(struct adapter *padapter);
181 void rtw_hal_read_chip_version(struct adapter *padapter);
182
183 u8 rtw_hal_get_def_var(struct adapter *padapter,
184                        enum hal_def_variable eVariable, void *pValue);
185
186 void rtw_hal_set_odm_var(struct adapter *padapter,
187                          enum hal_odm_variable eVariable, void *pValue1,
188                          bool bSet);
189
190 u32     rtw_hal_inirp_init(struct adapter *padapter);
191 void    rtw_hal_inirp_deinit(struct adapter *padapter);
192 void usb_intf_stop(struct adapter *padapter);
193
194 s32     rtw_hal_xmit(struct adapter *padapter, struct xmit_frame *pxmitframe);
195 s32     rtw_hal_mgnt_xmit(struct adapter *padapter,
196                           struct xmit_frame *pmgntframe);
197
198 s32     rtw_hal_init_xmit_priv(struct adapter *padapter);
199
200 int     rtw_hal_init_recv_priv(struct adapter *padapter);
201 void    rtw_hal_free_recv_priv(struct adapter *padapter);
202
203 void rtw_hal_update_ra_mask(struct adapter *padapter, u32 mac_id, u8 level);
204 void    rtw_hal_add_ra_tid(struct adapter *adapt, u32 bitmap, u8 arg, u8 level);
205 void    rtw_hal_clone_data(struct adapter *dst_adapt,
206                            struct adapter *src_adapt);
207
208 void rtw_hal_bcn_related_reg_setting(struct adapter *padapter);
209
210 u32     rtw_hal_read_rfreg(struct adapter *padapter, enum rf_radio_path eRFPath,
211                            u32 RegAddr, u32 BitMask);
212
213 void    rtw_hal_set_bwmode(struct adapter *padapter,
214                            enum ht_channel_width Bandwidth, u8 Offset);
215 void    rtw_hal_set_chan(struct adapter *padapter, u8 channel);
216 void    rtw_hal_dm_watchdog(struct adapter *padapter);
217
218 u8      rtw_hal_antdiv_before_linked(struct adapter *padapter);
219 void    rtw_hal_antdiv_rssi_compared(struct adapter *padapter,
220                                      struct wlan_bssid_ex *dst,
221                                      struct wlan_bssid_ex *src);
222
223 void rtw_hal_sreset_init(struct adapter *padapter);
224
225 void rtw_hal_notch_filter(struct adapter *adapter, bool enable);
226
227 void indicate_wx_scan_complete_event(struct adapter *padapter);
228 u8 rtw_do_join(struct adapter *padapter);
229
230 #endif /* __HAL_INTF_H__ */