1 /******************************************************************************
3 * Copyright(c) 2007 - 2012 Realtek Corporation. All rights reserved.
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.
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
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
19 ******************************************************************************/
20 #ifndef __HAL_INTF_H__
21 #define __HAL_INTF_H__
23 #include <osdep_service.h>
24 #include <drv_types.h>
25 #include <Hal8188EPhyCfg.h>
27 enum RTL871X_HCI_TYPE {
36 RTL8712_8188S_8191S_8192S,
56 HW_VAR_MLME_DISCONNECT,
57 HW_VAR_MLME_SITESURVEY,
59 HW_VAR_BEACON_INTERVAL,
70 HW_VAR_CAM_EMPTY_ENTRY,
71 HW_VAR_CAM_INVALID_ALL,
79 HW_VAR_AMPDU_MIN_SPACE,
81 HW_VAR_RXDMA_AGG_PG_TH,
83 HW_VAR_H2C_FW_PWRMODE,
84 HW_VAR_H2C_FW_JOINBSSRPT,
86 HW_VAR_H2C_FW_P2P_PS_OFFLOAD,
88 HW_VAR_TDLS_INIT_CH_SEN,
90 HW_VAR_TDLS_DONE_CH_SEN,
92 HW_VAR_TRIGGER_GPIO_0,
93 HW_VAR_BT_SET_COEXIST,
94 HW_VAR_BT_ISSUE_DELBA,
95 HW_VAR_CURRENT_ANTENNA,
96 HW_VAR_ANTENNA_DIVERSITY_LINK,
97 HW_VAR_ANTENNA_DIVERSITY_SELECT,
98 HW_VAR_SWITCH_EPHY_WoWLAN,
101 HW_VAR_EFUSE_BT_USAGE,
102 HW_VAR_EFUSE_BT_BYTES,
103 HW_VAR_FIFO_CLEARN_UP,
105 HW_VAR_APFM_ON_MAC, /* Auto FSM to Turn On, include clock, isolation,
106 * power control for MAC only */
107 /* The valid upper nav range for the HW updating, if the true value is
108 * larger than the upper range, the HW won't update it. */
109 /* Unit in microsecond. 0 means disable this function. */
111 HW_VAR_RPT_TIMER_SETTING,
112 HW_VAR_TX_RPT_MAX_MACID,
113 HW_VAR_H2C_MEDIA_STATUS_RPT,
114 HW_VAR_CHK_HI_QUEUE_EMPTY,
117 enum hal_def_variable {
118 HAL_DEF_UNDERCORATEDSMOOTHEDPWDB,
119 HAL_DEF_IS_SUPPORT_ANT_DIV,
120 HAL_DEF_CURRENT_ANTENNA,
122 HAL_DEF_MAX_RECVBUF_SZ,
123 HAL_DEF_RX_PACKET_OFFSET,
124 HAL_DEF_DBG_DUMP_RXPKT,/* for dbg */
125 HAL_DEF_DBG_DM_FUNC,/* for dbg */
126 HAL_DEF_RA_DECISION_RATE,
128 HAL_DEF_PT_PWR_STATUS,
129 HW_VAR_MAX_RX_AMPDU_FACTOR,
131 HAL_DEF_DBG_DUMP_TXPKT,
136 enum hal_odm_variable {
139 HAL_ODM_WIFI_DISPLAY_STATE,
142 enum hal_intf_ps_func {
143 HAL_USB_SELECT_SUSPEND,
147 typedef s32 (*c2h_id_filter)(u8 id);
150 u32 (*hal_power_on)(struct adapter *padapter);
151 u32 (*hal_init)(struct adapter *padapter);
152 u32 (*hal_deinit)(struct adapter *padapter);
154 void (*free_hal_data)(struct adapter *padapter);
156 u32 (*inirp_init)(struct adapter *padapter);
157 u32 (*inirp_deinit)(struct adapter *padapter);
159 s32 (*init_xmit_priv)(struct adapter *padapter);
160 void (*free_xmit_priv)(struct adapter *padapter);
162 s32 (*init_recv_priv)(struct adapter *padapter);
163 void (*free_recv_priv)(struct adapter *padapter);
165 void (*InitSwLeds)(struct adapter *padapter);
166 void (*DeInitSwLeds)(struct adapter *padapter);
168 void (*dm_init)(struct adapter *padapter);
169 void (*dm_deinit)(struct adapter *padapter);
170 void (*read_chip_version)(struct adapter *padapter);
172 void (*init_default_value)(struct adapter *padapter);
174 void (*intf_chip_configure)(struct adapter *padapter);
176 void (*read_adapter_info)(struct adapter *padapter);
178 void (*enable_interrupt)(struct adapter *padapter);
179 void (*disable_interrupt)(struct adapter *padapter);
180 s32 (*interrupt_handler)(struct adapter *padapter);
182 void (*set_bwmode_handler)(struct adapter *padapter,
183 enum ht_channel_width Bandwidth,
185 void (*set_channel_handler)(struct adapter *padapter, u8 channel);
187 void (*hal_dm_watchdog)(struct adapter *padapter);
189 void (*SetHwRegHandler)(struct adapter *padapter, u8 variable,
191 void (*GetHwRegHandler)(struct adapter *padapter, u8 variable,
194 u8 (*GetHalDefVarHandler)(struct adapter *padapter,
195 enum hal_def_variable eVariable,
197 u8 (*SetHalDefVarHandler)(struct adapter *padapter,
198 enum hal_def_variable eVariable,
201 void (*GetHalODMVarHandler)(struct adapter *padapter,
202 enum hal_odm_variable eVariable,
203 void *pValue1, bool bSet);
204 void (*SetHalODMVarHandler)(struct adapter *padapter,
205 enum hal_odm_variable eVariable,
206 void *pValue1, bool bSet);
208 void (*UpdateRAMaskHandler)(struct adapter *padapter,
209 u32 mac_id, u8 rssi_level);
210 void (*SetBeaconRelatedRegistersHandler)(struct adapter *padapter);
212 void (*Add_RateATid)(struct adapter *adapter, u32 bitmap, u8 arg,
214 void (*run_thread)(struct adapter *adapter);
215 void (*cancel_thread)(struct adapter *adapter);
217 u8 (*AntDivBeforeLinkHandler)(struct adapter *adapter);
218 void (*AntDivCompareHandler)(struct adapter *adapter,
219 struct wlan_bssid_ex *dst,
220 struct wlan_bssid_ex *src);
221 u8 (*interface_ps_func)(struct adapter *padapter,
222 enum hal_intf_ps_func efunc_id, u8 *val);
224 s32 (*hal_xmit)(struct adapter *padapter,
225 struct xmit_frame *pxmitframe);
226 s32 (*mgnt_xmit)(struct adapter *padapter,
227 struct xmit_frame *pmgntframe);
229 u32 (*read_bbreg)(struct adapter *padapter, u32 RegAddr,
231 void (*write_bbreg)(struct adapter *padapter, u32 RegAddr,
232 u32 BitMask, u32 Data);
233 u32 (*read_rfreg)(struct adapter *padapter,
234 enum rf_radio_path eRFPath, u32 RegAddr,
236 void (*write_rfreg)(struct adapter *padapter,
237 enum rf_radio_path eRFPath, u32 RegAddr,
238 u32 BitMask, u32 Data);
240 void (*EfusePowerSwitch)(struct adapter *padapter, u8 bWrite,
242 void (*ReadEFuse)(struct adapter *padapter, u8 efuseType, u16 _offset,
243 u16 _size_byte, u8 *pbuf, bool bPseudoTest);
244 void (*EFUSEGetEfuseDefinition)(struct adapter *padapter, u8 efuseType,
245 u8 type, void *pOut, bool bPseudoTest);
246 u16 (*EfuseGetCurrentSize)(struct adapter *padapter, u8 efuseType,
248 int (*Efuse_PgPacketRead)(struct adapter *adapter, u8 offset,
249 u8 *data, bool bPseudoTest);
250 int (*Efuse_PgPacketWrite)(struct adapter *padapter, u8 offset,
251 u8 word_en, u8 *data, bool bPseudoTest);
252 u8 (*Efuse_WordEnableDataWrite)(struct adapter *padapter,
253 u16 efuse_addr, u8 word_en,
254 u8 *data, bool bPseudoTest);
255 bool (*Efuse_PgPacketWrite_BT)(struct adapter *padapter, u8 offset,
256 u8 word_en, u8 *data, bool test);
258 void (*sreset_init_value)(struct adapter *padapter);
259 void (*sreset_reset_value)(struct adapter *padapter);
260 void (*silentreset)(struct adapter *padapter);
261 void (*sreset_xmit_status_check)(struct adapter *padapter);
262 void (*sreset_linked_status_check) (struct adapter *padapter);
263 u8 (*sreset_get_wifi_status)(struct adapter *padapter);
265 int (*IOL_exec_cmds_sync)(struct adapter *padapter,
266 struct xmit_frame *frame, u32 max_wait,
269 void (*hal_notch_filter)(struct adapter *adapter, bool enable);
270 void (*hal_reset_security_engine)(struct adapter *adapter);
271 s32 (*c2h_handler)(struct adapter *padapter,
272 struct c2h_evt_hdr *c2h_evt);
273 c2h_id_filter c2h_id_filter_ccx;
276 enum rt_eeprom_type {
282 #define RF_CHANGE_BY_INIT 0
283 #define RF_CHANGE_BY_IPS BIT28
284 #define RF_CHANGE_BY_PS BIT29
285 #define RF_CHANGE_BY_HW BIT30
286 #define RF_CHANGE_BY_SW BIT31
289 HARDWARE_TYPE_RTL8180,
290 HARDWARE_TYPE_RTL8185,
291 HARDWARE_TYPE_RTL8187,
292 HARDWARE_TYPE_RTL8188,
293 HARDWARE_TYPE_RTL8190P,
294 HARDWARE_TYPE_RTL8192E,
295 HARDWARE_TYPE_RTL819xU,
296 HARDWARE_TYPE_RTL8192SE,
297 HARDWARE_TYPE_RTL8192SU,
298 HARDWARE_TYPE_RTL8192CE,
299 HARDWARE_TYPE_RTL8192CU,
300 HARDWARE_TYPE_RTL8192DE,
301 HARDWARE_TYPE_RTL8192DU,
302 HARDWARE_TYPE_RTL8723AE,
303 HARDWARE_TYPE_RTL8723AU,
304 HARDWARE_TYPE_RTL8723AS,
305 HARDWARE_TYPE_RTL8188EE,
306 HARDWARE_TYPE_RTL8188EU,
307 HARDWARE_TYPE_RTL8188ES,
311 /* RTL8188E Series */
312 #define IS_HARDWARE_TYPE_8188EE(_Adapter) \
313 (((struct adapter *)_Adapter)->HardwareType == HARDWARE_TYPE_RTL8188EE)
314 #define IS_HARDWARE_TYPE_8188EU(_Adapter) \
315 (((struct adapter *)_Adapter)->HardwareType == HARDWARE_TYPE_RTL8188EU)
316 #define IS_HARDWARE_TYPE_8188ES(_Adapter) \
317 (((struct adapter *)_Adapter)->HardwareType == HARDWARE_TYPE_RTL8188ES)
318 #define IS_HARDWARE_TYPE_8188E(_Adapter) \
319 (IS_HARDWARE_TYPE_8188EE(_Adapter) || IS_HARDWARE_TYPE_8188EU(_Adapter) || \
320 IS_HARDWARE_TYPE_8188ES(_Adapter))
322 #define GET_EEPROM_EFUSE_PRIV(adapter) (&adapter->eeprompriv)
324 #define is_boot_from_eeprom(adapter) (adapter->eeprompriv.EepromOrEfuse)
326 void rtw_hal_def_value_init(struct adapter *padapter);
328 void rtw_hal_free_data(struct adapter *padapter);
330 void rtw_hal_dm_init(struct adapter *padapter);
331 void rtw_hal_dm_deinit(struct adapter *padapter);
332 void rtw_hal_sw_led_init(struct adapter *padapter);
333 void rtw_hal_sw_led_deinit(struct adapter *padapter);
335 u32 rtw_hal_power_on(struct adapter *padapter);
336 uint rtw_hal_init(struct adapter *padapter);
337 uint rtw_hal_deinit(struct adapter *padapter);
338 void rtw_hal_stop(struct adapter *padapter);
339 void rtw_hal_set_hwreg(struct adapter *padapter, u8 variable, u8 *val);
340 void rtw_hal_get_hwreg(struct adapter *padapter, u8 variable, u8 *val);
342 void rtw_hal_chip_configure(struct adapter *padapter);
343 void rtw_hal_read_chip_info(struct adapter *padapter);
344 void rtw_hal_read_chip_version(struct adapter *padapter);
346 u8 rtw_hal_set_def_var(struct adapter *padapter,
347 enum hal_def_variable eVariable, void *pValue);
348 u8 rtw_hal_get_def_var(struct adapter *padapter,
349 enum hal_def_variable eVariable, void *pValue);
351 void rtw_hal_set_odm_var(struct adapter *padapter,
352 enum hal_odm_variable eVariable, void *pValue1,
354 void rtw_hal_get_odm_var(struct adapter *padapter,
355 enum hal_odm_variable eVariable,
356 void *pValue1, bool bSet);
358 void rtw_hal_enable_interrupt(struct adapter *padapter);
359 void rtw_hal_disable_interrupt(struct adapter *padapter);
361 u32 rtw_hal_inirp_init(struct adapter *padapter);
362 u32 rtw_hal_inirp_deinit(struct adapter *padapter);
364 u8 rtw_hal_intf_ps_func(struct adapter *padapter,
365 enum hal_intf_ps_func efunc_id, u8 *val);
367 s32 rtw_hal_xmit(struct adapter *padapter, struct xmit_frame *pxmitframe);
368 s32 rtw_hal_mgnt_xmit(struct adapter *padapter,
369 struct xmit_frame *pmgntframe);
371 s32 rtw_hal_init_xmit_priv(struct adapter *padapter);
372 void rtw_hal_free_xmit_priv(struct adapter *padapter);
374 s32 rtw_hal_init_recv_priv(struct adapter *padapter);
375 void rtw_hal_free_recv_priv(struct adapter *padapter);
377 void rtw_hal_update_ra_mask(struct adapter *padapter, u32 mac_id, u8 level);
378 void rtw_hal_add_ra_tid(struct adapter *adapt, u32 bitmap, u8 arg, u8 level);
379 void rtw_hal_clone_data(struct adapter *dst_adapt,
380 struct adapter *src_adapt);
381 void rtw_hal_start_thread(struct adapter *padapter);
382 void rtw_hal_stop_thread(struct adapter *padapter);
384 void rtw_hal_bcn_related_reg_setting(struct adapter *padapter);
386 u32 rtw_hal_read_bbreg(struct adapter *padapter, u32 RegAddr, u32 BitMask);
387 void rtw_hal_write_bbreg(struct adapter *padapter, u32 RegAddr, u32 BitMask,
389 u32 rtw_hal_read_rfreg(struct adapter *padapter, enum rf_radio_path eRFPath,
390 u32 RegAddr, u32 BitMask);
391 void rtw_hal_write_rfreg(struct adapter *padapter,
392 enum rf_radio_path eRFPath, u32 RegAddr,
393 u32 BitMask, u32 Data);
395 s32 rtw_hal_interrupt_handler(struct adapter *padapter);
397 void rtw_hal_set_bwmode(struct adapter *padapter,
398 enum ht_channel_width Bandwidth, u8 Offset);
399 void rtw_hal_set_chan(struct adapter *padapter, u8 channel);
400 void rtw_hal_dm_watchdog(struct adapter *padapter);
402 u8 rtw_hal_antdiv_before_linked(struct adapter *padapter);
403 void rtw_hal_antdiv_rssi_compared(struct adapter *padapter,
404 struct wlan_bssid_ex *dst,
405 struct wlan_bssid_ex *src);
407 void rtw_hal_sreset_init(struct adapter *padapter);
408 void rtw_hal_sreset_reset(struct adapter *padapter);
409 void rtw_hal_sreset_reset_value(struct adapter *padapter);
410 void rtw_hal_sreset_xmit_status_check(struct adapter *padapter);
411 void rtw_hal_sreset_linked_status_check(struct adapter *padapter);
412 u8 rtw_hal_sreset_get_wifi_status(struct adapter *padapter);
414 int rtw_hal_iol_cmd(struct adapter *adapter, struct xmit_frame *xmit_frame,
415 u32 max_wating_ms, u32 bndy_cnt);
417 void rtw_hal_notch_filter(struct adapter *adapter, bool enable);
418 void rtw_hal_reset_security_engine(struct adapter *adapter);
420 s32 rtw_hal_c2h_handler(struct adapter *adapter,
421 struct c2h_evt_hdr *c2h_evt);
422 c2h_id_filter rtw_hal_c2h_id_filter_ccx(struct adapter *adapter);
423 void indicate_wx_scan_complete_event(struct adapter *padapter);
424 u8 rtw_do_join(struct adapter *padapter);
426 #endif /* __HAL_INTF_H__ */