xref: /OK3568_Linux_fs/external/rkwifibt/drivers/rtl8821cs/hal/rtl8821c/rtl8821c.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1 /******************************************************************************
2  *
3  * Copyright(c) 2016 - 2017 Realtek Corporation.
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 _RTL8821C_H_
16 #define _RTL8821C_H_
17 
18 #include <drv_types.h>		/* PADAPTER */
19 #include <rtw_rf.h>		/* CHANNEL_WIDTH */
20 #include <rtw_xmit.h>		/* struct pkt_attrib, struct xmit_frame */
21 #include <rtw_recv.h>		/* struct recv_frame */
22 #include <hal_intf.h>		/* HAL_DEF_VARIABLE */
23 #include <rtl8821c_dm.h>
24 
25 #define DRIVER_EARLY_INT_TIME_8821C	0x05
26 #define BCN_DMA_ATIME_INT_TIME_8821C	0x02
27 
28 /* rtl8821c_halinit.c */
29 u32 rtl8821c_power_on(PADAPTER);
30 void rtl8821c_power_off(PADAPTER);
31 u8 rtl8821c_mac_init(PADAPTER);
32 u8 rtl8821c_mac_verify(PADAPTER);
33 void rtl8821c_hal_init_misc(PADAPTER padapter);
34 u32 rtl8821c_hal_init(PADAPTER);
35 u32 rtl8821c_hal_deinit(PADAPTER);
36 void rtl8821c_init_default_value(PADAPTER);
37 u8 rtl8821c_phy_init(PADAPTER adapter);
38 u8 rtl8821c_init_phy_parameter_mac(PADAPTER adapter);
39 
40 /* rtl8821c_mac.c */
41 #ifdef CONFIG_XMIT_ACK
42 u8 rtl8821c_set_mgnt_xmit_ack(_adapter *adapter);
43 #endif
44 u8 rtl8821c_rx_ba_ssn_appended(PADAPTER);
45 u8 rtl8821c_rx_fcs_append_switch(PADAPTER, u8 enable);
46 u8 rtl8821c_rx_fcs_appended(PADAPTER);
47 u8 rtl8821c_rx_tsf_addr_filter_config(_adapter *adapter, u8 config);
48 s32 rtl8821c_fw_dl(PADAPTER, u8 wowlan);
49 s32 rtl8821c_fw_mem_dl(PADAPTER adapter, enum fw_mem mem);
50 
51 #define BIT_PRETXERR_HANDLE_IMR	BIT(31)
52 #define BIT_PRETXERR_HANDLE_ISR	BIT(31)
53 
54 #ifdef CONFIG_AMPDU_PRETX_CD
55 #define BIT_PRETXERR			BIT(7)
56 
57 void rtl8821c_pretx_cd_config(_adapter *adapter);
58 #endif
59 /* rtl8821c_ops.c */
60 u8 rtl8821c_read_efuse(PADAPTER);
61 void rtl8821c_run_thread(PADAPTER);
62 void rtl8821c_cancel_thread(PADAPTER);
63 u8 rtl8821c_sethwreg(PADAPTER, u8 variable, u8 *pval);
64 void rtl8821c_gethwreg(PADAPTER, u8 variable, u8 *pval);
65 u8 rtl8821c_sethaldefvar(PADAPTER, HAL_DEF_VARIABLE, void *pval);
66 u8 rtl8821c_gethaldefvar(PADAPTER, HAL_DEF_VARIABLE, void *pval);
67 void rtl8821c_set_hal_ops(PADAPTER);
68 
69 /* tx */
70 void rtl8821c_init_xmit_priv(_adapter *adapter);
71 void rtl8821c_fill_txdesc_sectype(struct pkt_attrib *, u8 *ptxdesc);
72 void rtl8821c_fill_txdesc_vcs(PADAPTER, struct pkt_attrib *, u8 *ptxdesc);
73 void rtl8821c_fill_txdesc_phy(PADAPTER, struct pkt_attrib *, u8 *ptxdesc);
74 u8 rtl8821c_bw_mapping(PADAPTER, struct pkt_attrib *);
75 u8 rtl8821c_sc_mapping(PADAPTER, struct pkt_attrib *);
76 void rtl8821c_cal_txdesc_chksum(PADAPTER, u8 *ptxdesc);
77 void rtl8821c_update_txdesc(struct xmit_frame *, u8 *pbuf);
78 void rtl8821c_dbg_dump_tx_desc(PADAPTER, int frame_tag, u8 *ptxdesc);
79 void fill_txdesc_force_bmc_camid(struct pkt_attrib *pattrib, u8 *ptxdesc);
80 void fill_txdesc_bmc_tx_rate(struct pkt_attrib *pattrib, u8 *ptxdesc);
81 
82 /* rx */
83 void rtl8821c_rxdesc2attribute(struct rx_pkt_attrib *a, u8 *desc);
84 void rtl8821c_query_rx_desc(union recv_frame *, u8 *pdesc);
85 
86 /* rtl8821c_cmd.c */
87 s32 rtl8821c_fillh2ccmd(PADAPTER, u8 id, u32 buf_len, u8 *pbuf);
88 void _rtl8821c_set_FwPwrMode_cmd(PADAPTER adapter, u8 psmode, u8 rfon_ctrl);
89 void rtl8821c_set_FwPwrMode_cmd(PADAPTER adapter, u8 psmode);
90 void rtl8821c_set_FwPwrMode_rfon_ctrl_cmd(PADAPTER adapter, u8 rfon_ctrl);
91 void rtl8821c_set_FwPwrModeInIPS_cmd(PADAPTER adapter, u8 cmd_param);
92 #ifdef CONFIG_WOWLAN
93 void rtl8821c_set_fw_pwrmode_inips_cmd_wowlan(PADAPTER padapter, u8 ps_mode);
94 #endif /* CONFIG_WOWLAN */
95 void c2h_handler_rtl8821c(_adapter *adapter, u8 *pbuf, u16 length);
96 void c2h_pre_handler_rtl8821c(_adapter *adapter, u8 *pbuf, s32 length);
97 #ifdef CONFIG_BT_COEXIST
98 void rtl8821c_download_BTCoex_AP_mode_rsvd_page(PADAPTER);
99 #endif /* CONFIG_BT_COEXIST */
100 
101 /* rtl8821c_phy.c */
102 u32 rtl8821c_read_bb_reg(PADAPTER, u32 addr, u32 mask);
103 void rtl8821c_write_bb_reg(PADAPTER, u32 addr, u32 mask, u32 val);
104 u32 rtl8821c_read_rf_reg(PADAPTER adapter, enum rf_path path, u32 addr, u32 mask);
105 void rtl8821c_write_rf_reg(PADAPTER adapter, enum rf_path path, u32 addr, u32 mask, u32 val);
106 void rtl8821c_set_channel_bw(PADAPTER adapter, u8 center_ch, enum channel_width, u8 offset40, u8 offset80);
107 void rtl8821c_set_tx_power_level(PADAPTER, u8 channel);
108 void rtl8821c_set_tx_power_index(PADAPTER adapter, u32 powerindex, enum rf_path rfpath, u8 rate);
109 void rtl8821c_notch_filter_switch(PADAPTER, bool enable);
110 #ifdef CONFIG_BEAMFORMING
111 void rtl8821c_phy_bf_init(PADAPTER);
112 void rtl8821c_phy_bf_enter(PADAPTER, struct sta_info*);
113 void rtl8821c_phy_bf_leave(PADAPTER, u8 *addr);
114 void rtl8821c_phy_bf_set_gid_table(PADAPTER, struct beamformer_entry*);
115 #endif /* CONFIG_BEAMFORMING */
116 #endif /* _RTL8821C_H_ */
117