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