xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/rockchip_wlan/rtl8723ds/include/hal_sdio.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /******************************************************************************
3  *
4  * Copyright(c) 2007 - 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 __HAL_SDIO_H_
17 #define __HAL_SDIO_H_
18 
19 #define ffaddr2deviceId(pdvobj, addr)	(pdvobj->Queue2Pipe[addr])
20 
21 #ifndef RTW_HALMAC
22 extern const char *_sdio_tx_queue_str[];
23 #define sdio_tx_queue_str(_page_idx) (_page_idx >= SDIO_MAX_TX_QUEUE ? "UNKNOWN" : _sdio_tx_queue_str[_page_idx])
24 #endif
25 
26 u8 rtw_hal_sdio_max_txoqt_free_space(_adapter *padapter);
27 u8 rtw_hal_sdio_query_tx_freepage(_adapter *padapter, u8 PageIdx, u8 RequiredPageNum);
28 void rtw_hal_sdio_update_tx_freepage(_adapter *padapter, u8 PageIdx, u8 RequiredPageNum);
29 void rtw_hal_set_sdio_tx_max_length(PADAPTER padapter, u8 numHQ, u8 numNQ, u8 numLQ, u8 numPubQ, u8 div_num);
30 u32 rtw_hal_get_sdio_tx_max_length(PADAPTER padapter, u8 queue_idx);
31 bool sdio_power_on_check(PADAPTER padapter);
32 
33 #ifdef CONFIG_SDIO_TX_ENABLE_AVAL_INT
34 #if defined(CONFIG_RTL8188F) || defined(CONFIG_RTL8188GTV) ||defined(CONFIG_RTL8188E) || defined(CONFIG_RTL8821A) || defined(CONFIG_RTL8192F) || defined(CONFIG_RTL8723D)
35 void rtw_hal_sdio_avail_page_threshold_init(_adapter *adapter);
36 void rtw_hal_sdio_avail_page_threshold_en(_adapter *adapter, u8 qidx, u8 pg_num);
37 #endif
38 #endif /* CONFIG_SDIO_TX_ENABLE_AVAL_INT */
39 
40 #ifdef CONFIG_FW_C2H_REG
41 void sd_c2h_hisr_hdl(_adapter *adapter);
42 #endif
43 
44 #if defined(CONFIG_RTL8188F) || defined (CONFIG_RTL8188GTV) || defined (CONFIG_RTL8192F) || defined(CONFIG_RTL8723D)
45 #define SDIO_LOCAL_CMD_ADDR(addr) ((SDIO_LOCAL_DEVICE_ID << 13) | ((addr) & SDIO_LOCAL_MSK))
46 #endif
47 
48 #ifdef CONFIG_SDIO_CHK_HCI_RESUME
49 bool sdio_chk_hci_resume(struct intf_hdl *pintfhdl);
50 void sdio_chk_hci_suspend(struct intf_hdl *pintfhdl);
51 #else
52 #define sdio_chk_hci_resume(pintfhdl) _FALSE
53 #define sdio_chk_hci_suspend(pintfhdl) do {} while (0)
54 #endif /* CONFIG_SDIO_CHK_HCI_RESUME */
55 
56 #ifdef CONFIG_SDIO_INDIRECT_ACCESS
57 /* program indirect access register in sdio local to read/write page0 registers */
58 s32 sdio_iread(PADAPTER padapter, u32 addr, u8 size, u8 *v);
59 s32 sdio_iwrite(PADAPTER padapter, u32 addr, u8 size, u8 *v);
60 u8 sdio_iread8(struct intf_hdl *pintfhdl, u32 addr);
61 u16 sdio_iread16(struct intf_hdl *pintfhdl, u32 addr);
62 u32 sdio_iread32(struct intf_hdl *pintfhdl, u32 addr);
63 s32 sdio_iwrite8(struct intf_hdl *pintfhdl, u32 addr, u8 val);
64 s32 sdio_iwrite16(struct intf_hdl *pintfhdl, u32 addr, u16 val);
65 s32 sdio_iwrite32(struct intf_hdl *pintfhdl, u32 addr, u32 val);
66 #endif /* CONFIG_SDIO_INDIRECT_ACCESS */
67 u32 cmd53_4byte_alignment(struct intf_hdl *pintfhdl, u32 addr);
68 
69 #ifndef CONFIG_SDIO_TX_TASKLET
70 #ifdef SDIO_FREE_XMIT_BUF_SEMA
71 void _rtw_sdio_free_xmitbuf_sema_up(struct xmit_priv *xmit);
72 void _rtw_sdio_free_xmitbuf_sema_down(struct xmit_priv *xmit);
73 #ifdef DBG_SDIO_FREE_XMIT_BUF_SEMA
74 void dbg_rtw_sdio_free_xmitbuf_sema_up(struct xmit_priv *xmit, const char *caller);
75 void dbg_rtw_sdio_free_xmitbuf_sema_down(struct xmit_priv *xmit, const char *caller);
76 #define rtw_sdio_free_xmitbuf_sema_up(_xmit) dbg_rtw_sdio_free_xmitbuf_sema_up(_xmit, __func__)
77 #define rtw_sdio_free_xmitbuf_sema_down(_xmit) dbg_rtw_sdio_free_xmitbuf_sema_down(_xmit, __func__)
78 #else
79 #define rtw_sdio_free_xmitbuf_sema_up(_xmit) _rtw_sdio_free_xmitbuf_sema_up(_xmit)
80 #define rtw_sdio_free_xmitbuf_sema_down(_xmit) _rtw_sdio_free_xmitbuf_sema_down(_xmit)
81 #endif /* DBG_SDIO_FREE_XMIT_BUF_SEMA */
82 #endif /* SDIO_FREE_XMIT_BUF_SEMA */
83 #endif /* !CONFIG_SDIO_TX_TASKLET */
84 
85 #endif /* __HAL_SDIO_H_ */
86