xref: /wlan-driver/qca-wifi-host-cmn/target_if/wifi_pos/inc/target_if_wifi_pos.h (revision 5113495b16420b49004c444715d2daae2066e7dc)
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2017, 2019-2020 The Linux Foundation. All rights reserved.
3*5113495bSYour Name  * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
4*5113495bSYour Name  *
5*5113495bSYour Name  * Permission to use, copy, modify, and/or distribute this software for
6*5113495bSYour Name  * any purpose with or without fee is hereby granted, provided that the
7*5113495bSYour Name  * above copyright notice and this permission notice appear in all
8*5113495bSYour Name  * copies.
9*5113495bSYour Name  *
10*5113495bSYour Name  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11*5113495bSYour Name  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12*5113495bSYour Name  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13*5113495bSYour Name  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14*5113495bSYour Name  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15*5113495bSYour Name  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16*5113495bSYour Name  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17*5113495bSYour Name  * PERFORMANCE OF THIS SOFTWARE.
18*5113495bSYour Name  */
19*5113495bSYour Name 
20*5113495bSYour Name /**
21*5113495bSYour Name  * DOC: target_if_wifi_pos.h
22*5113495bSYour Name  * This file declares the functions pertinent to wifi positioning component's
23*5113495bSYour Name  * target if layer.
24*5113495bSYour Name  */
25*5113495bSYour Name #ifndef _WIFI_POS_TGT_IF_H_
26*5113495bSYour Name #define _WIFI_POS_TGT_IF_H_
27*5113495bSYour Name 
28*5113495bSYour Name #include "qdf_types.h"
29*5113495bSYour Name #include "qdf_status.h"
30*5113495bSYour Name #include "wlan_cmn.h"
31*5113495bSYour Name #include "wmi_unified_api.h"
32*5113495bSYour Name #include "wifi_pos_utils_i.h"
33*5113495bSYour Name 
34*5113495bSYour Name struct oem_data_req;
35*5113495bSYour Name struct oem_data_rsp;
36*5113495bSYour Name struct wlan_objmgr_psoc;
37*5113495bSYour Name struct wlan_soc_southbound_cb;
38*5113495bSYour Name struct wlan_lmac_if_tx_ops;
39*5113495bSYour Name struct wlan_lmac_if_rx_ops;
40*5113495bSYour Name 
41*5113495bSYour Name #ifdef WLAN_FEATURE_CIF_CFR
42*5113495bSYour Name /**
43*5113495bSYour Name  * target_if_wifi_pos_get_indirect_data  - Get the indirect data from the
44*5113495bSYour Name  * response
45*5113495bSYour Name  * @priv_obj: Wifi Pos private object
46*5113495bSYour Name  * @indirect: Indirect data
47*5113495bSYour Name  * @rsp: Oem data response
48*5113495bSYour Name  * @cookie: Cookie
49*5113495bSYour Name  *
50*5113495bSYour Name  * Return: QDF_STATUS
51*5113495bSYour Name  */
52*5113495bSYour Name QDF_STATUS target_if_wifi_pos_get_indirect_data(
53*5113495bSYour Name 			struct wifi_pos_psoc_priv_obj *priv_obj,
54*5113495bSYour Name 			struct wmi_host_oem_indirect_data *indirect,
55*5113495bSYour Name 			struct oem_data_rsp *rsp, uint32_t *cookie);
56*5113495bSYour Name /**
57*5113495bSYour Name  * target_if_wifi_pos_replenish_ring() - Replenish the CFR DMA ring
58*5113495bSYour Name  * @priv: Pointer to Wifi Pos psoc private object
59*5113495bSYour Name  * @ring_idx: Ring Index
60*5113495bSYour Name  * @vaddr: Virtual address
61*5113495bSYour Name  * @cookie: Cookie
62*5113495bSYour Name  *
63*5113495bSYour Name  * Return: QDF_STATUS
64*5113495bSYour Name  */
65*5113495bSYour Name QDF_STATUS
66*5113495bSYour Name target_if_wifi_pos_replenish_ring(struct wifi_pos_psoc_priv_obj *priv,
67*5113495bSYour Name 				  uint8_t ring_idx,
68*5113495bSYour Name 				  void *vaddr, uint32_t cookie);
69*5113495bSYour Name #else
70*5113495bSYour Name static inline
target_if_wifi_pos_get_indirect_data(struct wifi_pos_psoc_priv_obj * priv_obj,struct wmi_host_oem_indirect_data * indirect,struct oem_data_rsp * rsp,uint32_t * cookie)71*5113495bSYour Name QDF_STATUS target_if_wifi_pos_get_indirect_data(
72*5113495bSYour Name 			struct wifi_pos_psoc_priv_obj *priv_obj,
73*5113495bSYour Name 			struct wmi_host_oem_indirect_data *indirect,
74*5113495bSYour Name 			struct oem_data_rsp *rsp, uint32_t *cookie)
75*5113495bSYour Name {
76*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
77*5113495bSYour Name }
78*5113495bSYour Name 
79*5113495bSYour Name static inline QDF_STATUS
target_if_wifi_pos_replenish_ring(struct wifi_pos_psoc_priv_obj * priv,uint8_t ring_idx,void * vaddr,uint32_t cookie)80*5113495bSYour Name target_if_wifi_pos_replenish_ring(struct wifi_pos_psoc_priv_obj *priv,
81*5113495bSYour Name 				  uint8_t ring_idx,
82*5113495bSYour Name 				  void *vaddr, uint32_t cookie)
83*5113495bSYour Name {
84*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
85*5113495bSYour Name }
86*5113495bSYour Name #endif
87*5113495bSYour Name 
88*5113495bSYour Name #ifdef WIFI_POS_CONVERGED
89*5113495bSYour Name /**
90*5113495bSYour Name  * target_if_wifi_pos_get_vht_ch_width: function to get vht channel width
91*5113495bSYour Name  * @psoc: pointer to psoc object
92*5113495bSYour Name  * @ch_width: pointer to the variable in which output value needs to be filled
93*5113495bSYour Name  *
94*5113495bSYour Name  * Return: status of operation
95*5113495bSYour Name  */
96*5113495bSYour Name QDF_STATUS target_if_wifi_pos_get_vht_ch_width(struct wlan_objmgr_psoc *psoc,
97*5113495bSYour Name 					       enum phy_ch_width *ch_width);
98*5113495bSYour Name #endif
99*5113495bSYour Name 
100*5113495bSYour Name #if defined(WLAN_FEATURE_CIF_CFR) && defined(WIFI_POS_CONVERGED)
101*5113495bSYour Name /**
102*5113495bSYour Name  * target_if_wifi_pos_init_cir_cfr_rings: set DMA ring cap in psoc private
103*5113495bSYour Name  * object
104*5113495bSYour Name  * @psoc: pointer to psoc object
105*5113495bSYour Name  * @hal_soc: pointer to hal soc
106*5113495bSYour Name  * @num_mac: number of mac
107*5113495bSYour Name  * @buf: buffer containing DMA ring cap
108*5113495bSYour Name  *
109*5113495bSYour Name  * Return: status of operation
110*5113495bSYour Name  */
111*5113495bSYour Name QDF_STATUS target_if_wifi_pos_init_cir_cfr_rings(struct wlan_objmgr_psoc *psoc,
112*5113495bSYour Name 					     void *hal_soc, uint8_t num_mac,
113*5113495bSYour Name 					     void *buf);
114*5113495bSYour Name /**
115*5113495bSYour Name  * target_if_wifi_pos_deinit_dma_rings: frees up DMA rings
116*5113495bSYour Name  * @psoc: pointer to psoc
117*5113495bSYour Name  *
118*5113495bSYour Name  * Return: status of operation
119*5113495bSYour Name  */
120*5113495bSYour Name QDF_STATUS target_if_wifi_pos_deinit_dma_rings(struct wlan_objmgr_psoc *psoc);
121*5113495bSYour Name #else
target_if_wifi_pos_init_cir_cfr_rings(struct wlan_objmgr_psoc * psoc,void * hal_soc,uint8_t num_mac,void * buf)122*5113495bSYour Name static inline QDF_STATUS target_if_wifi_pos_init_cir_cfr_rings(
123*5113495bSYour Name 				struct wlan_objmgr_psoc *psoc, void *hal_soc,
124*5113495bSYour Name 				uint8_t num_mac, void *buf)
125*5113495bSYour Name {
126*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
127*5113495bSYour Name }
128*5113495bSYour Name 
target_if_wifi_pos_deinit_dma_rings(struct wlan_objmgr_psoc * psoc)129*5113495bSYour Name static inline QDF_STATUS target_if_wifi_pos_deinit_dma_rings(
130*5113495bSYour Name 				struct wlan_objmgr_psoc *psoc)
131*5113495bSYour Name {
132*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
133*5113495bSYour Name }
134*5113495bSYour Name #endif
135*5113495bSYour Name 
136*5113495bSYour Name #ifndef CNSS_GENL
137*5113495bSYour Name /**
138*5113495bSYour Name  * target_if_wifi_pos_convert_pdev_id_host_to_target: function to get target
139*5113495bSYour Name  * pdev_id from host pdev_id
140*5113495bSYour Name  * @psoc: pointer to psoc object
141*5113495bSYour Name  * @host_pdev_id: host pdev id
142*5113495bSYour Name  * @target_pdev_id: target pdev id
143*5113495bSYour Name  *
144*5113495bSYour Name  * Return: QDF_STATUS_SUCCESS in case of success, error codes in
145*5113495bSYour Name  * case of failure
146*5113495bSYour Name  */
147*5113495bSYour Name QDF_STATUS target_if_wifi_pos_convert_pdev_id_host_to_target(
148*5113495bSYour Name 		struct wlan_objmgr_psoc *psoc, uint32_t host_pdev_id,
149*5113495bSYour Name 		uint32_t *target_pdev_id);
150*5113495bSYour Name 
151*5113495bSYour Name /**
152*5113495bSYour Name  * target_if_wifi_pos_convert_pdev_id_target_to_host: function to get host
153*5113495bSYour Name  * pdev_id from target pdev_id
154*5113495bSYour Name  * @psoc: pointer to psoc object
155*5113495bSYour Name  * @target_pdev_id: target pdev id
156*5113495bSYour Name  * @host_pdev_id: host pdev id
157*5113495bSYour Name  *
158*5113495bSYour Name  * Return: QDF_STATUS_SUCCESS in case of success, error codes in
159*5113495bSYour Name  * case of failure
160*5113495bSYour Name  */
161*5113495bSYour Name QDF_STATUS target_if_wifi_pos_convert_pdev_id_target_to_host(
162*5113495bSYour Name 		struct wlan_objmgr_psoc *psoc, uint32_t target_pdev_id,
163*5113495bSYour Name 		uint32_t *host_pdev_id);
164*5113495bSYour Name 
165*5113495bSYour Name #else
166*5113495bSYour Name 
target_if_wifi_pos_convert_pdev_id_host_to_target(struct wlan_objmgr_psoc * psoc,uint32_t host_pdev_id,uint32_t * target_pdev_id)167*5113495bSYour Name static inline QDF_STATUS target_if_wifi_pos_convert_pdev_id_host_to_target(
168*5113495bSYour Name 		struct wlan_objmgr_psoc *psoc, uint32_t host_pdev_id,
169*5113495bSYour Name 		uint32_t *target_pdev_id)
170*5113495bSYour Name {
171*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
172*5113495bSYour Name }
173*5113495bSYour Name 
target_if_wifi_pos_convert_pdev_id_target_to_host(struct wlan_objmgr_psoc * psoc,uint32_t target_pdev_id,uint32_t * host_pdev_id)174*5113495bSYour Name static inline QDF_STATUS target_if_wifi_pos_convert_pdev_id_target_to_host(
175*5113495bSYour Name 		struct wlan_objmgr_psoc *psoc, uint32_t target_pdev_id,
176*5113495bSYour Name 		uint32_t *host_pdev_id)
177*5113495bSYour Name {
178*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
179*5113495bSYour Name }
180*5113495bSYour Name #endif /* CNSS_GENL */
181*5113495bSYour Name #endif /* _WIFI_POS_TGT_IF_H_ */
182