xref: /wlan-driver/qca-wifi-host-cmn/target_if/init_deinit/inc/init_deinit_lmac.h (revision 5113495b16420b49004c444715d2daae2066e7dc)
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
3*5113495bSYour Name  *
4*5113495bSYour Name  * Permission to use, copy, modify, and/or distribute this software for
5*5113495bSYour Name  * any purpose with or without fee is hereby granted, provided that the
6*5113495bSYour Name  * above copyright notice and this permission notice appear in all
7*5113495bSYour Name  * copies.
8*5113495bSYour Name  *
9*5113495bSYour Name  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10*5113495bSYour Name  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11*5113495bSYour Name  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12*5113495bSYour Name  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13*5113495bSYour Name  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14*5113495bSYour Name  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15*5113495bSYour Name  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16*5113495bSYour Name  * PERFORMANCE OF THIS SOFTWARE.
17*5113495bSYour Name  */
18*5113495bSYour Name 
19*5113495bSYour Name /**
20*5113495bSYour Name  * DOC: init_deinit_lmac.h
21*5113495bSYour Name  *
22*5113495bSYour Name  * Public APIs to get target_if info
23*5113495bSYour Name  */
24*5113495bSYour Name 
25*5113495bSYour Name #ifndef _INIT_DEINIT_LMAC_H_
26*5113495bSYour Name #define _INIT_DEINIT_LMAC_H_
27*5113495bSYour Name 
28*5113495bSYour Name /**
29*5113495bSYour Name  * lmac_get_tgt_res_cfg() - get target resource config
30*5113495bSYour Name  * @psoc: pointer to psoc
31*5113495bSYour Name  *
32*5113495bSYour Name  * API to get target resource config
33*5113495bSYour Name  *
34*5113495bSYour Name  * Return: target resource configuration
35*5113495bSYour Name  */
36*5113495bSYour Name target_resource_config *lmac_get_tgt_res_cfg(struct wlan_objmgr_psoc *psoc);
37*5113495bSYour Name 
38*5113495bSYour Name /**
39*5113495bSYour Name  * lmac_get_target_cap() - get target capability
40*5113495bSYour Name  * @psoc: pointer to psoc
41*5113495bSYour Name  *
42*5113495bSYour Name  * API to get target capability
43*5113495bSYour Name  *
44*5113495bSYour Name  * Return: target capability Information
45*5113495bSYour Name  */
46*5113495bSYour Name struct wlan_psoc_target_capability_info *lmac_get_target_cap(
47*5113495bSYour Name 				struct wlan_objmgr_psoc *psoc);
48*5113495bSYour Name 
49*5113495bSYour Name /**
50*5113495bSYour Name  * lmac_get_pdev_idx() - get pdev id
51*5113495bSYour Name  * @pdev: pointer to pdev
52*5113495bSYour Name  *
53*5113495bSYour Name  * API to get pdev id
54*5113495bSYour Name  *
55*5113495bSYour Name  * Return: pdev id
56*5113495bSYour Name  */
57*5113495bSYour Name int32_t lmac_get_pdev_idx(struct wlan_objmgr_pdev *pdev);
58*5113495bSYour Name 
59*5113495bSYour Name /**
60*5113495bSYour Name  * lmac_get_pdev_target_type() - check pdev target type
61*5113495bSYour Name  * @pdev: pointer to pdev
62*5113495bSYour Name  * @target_type: target type ptr, it is assigned with pdev target_type
63*5113495bSYour Name  *               target type stores the radio code
64*5113495bSYour Name  *
65*5113495bSYour Name  * API to check pdev target type
66*5113495bSYour Name  *
67*5113495bSYour Name  * Return: Success if found required target type else Failure
68*5113495bSYour Name  */
69*5113495bSYour Name QDF_STATUS lmac_get_pdev_target_type(struct wlan_objmgr_pdev *pdev,
70*5113495bSYour Name 				uint32_t *target_type);
71*5113495bSYour Name 
72*5113495bSYour Name /**
73*5113495bSYour Name  * lmac_get_tgt_type() - get target type
74*5113495bSYour Name  * @psoc: pointer to psoc
75*5113495bSYour Name  *
76*5113495bSYour Name  * API to get target type
77*5113495bSYour Name  *
78*5113495bSYour Name  * Return: target type (value to identify particular radio)
79*5113495bSYour Name  */
80*5113495bSYour Name uint32_t lmac_get_tgt_type(struct wlan_objmgr_psoc *psoc);
81*5113495bSYour Name 
82*5113495bSYour Name /**
83*5113495bSYour Name  * lmac_get_tgt_version() - get target version
84*5113495bSYour Name  * @psoc: pointer to psoc
85*5113495bSYour Name  *
86*5113495bSYour Name  * API to get target version
87*5113495bSYour Name  *
88*5113495bSYour Name  * Return: target version
89*5113495bSYour Name  */
90*5113495bSYour Name uint32_t lmac_get_tgt_version(struct wlan_objmgr_psoc *psoc);
91*5113495bSYour Name 
92*5113495bSYour Name /**
93*5113495bSYour Name  * lmac_get_tgt_revision() - get target revision
94*5113495bSYour Name  * @psoc: pointer to psoc
95*5113495bSYour Name  *
96*5113495bSYour Name  * API to get target revision
97*5113495bSYour Name  *
98*5113495bSYour Name  * Return: target revision
99*5113495bSYour Name  */
100*5113495bSYour Name uint32_t lmac_get_tgt_revision(struct wlan_objmgr_psoc *psoc);
101*5113495bSYour Name 
102*5113495bSYour Name /**
103*5113495bSYour Name  * lmac_is_target_ar900b() - checks the target type
104*5113495bSYour Name  * @psoc: pointer to psoc
105*5113495bSYour Name  *
106*5113495bSYour Name  * API to check target type
107*5113495bSYour Name  *
108*5113495bSYour Name  * Return: True on presence of required target type else false
109*5113495bSYour Name  */
110*5113495bSYour Name bool lmac_is_target_ar900b(struct wlan_objmgr_psoc *psoc);
111*5113495bSYour Name 
112*5113495bSYour Name /**
113*5113495bSYour Name  * lmac_get_wmi_hdl() - get wmi handle
114*5113495bSYour Name  * @psoc: pointer to psoc
115*5113495bSYour Name  *
116*5113495bSYour Name  * API to get wmi handle
117*5113495bSYour Name  *
118*5113495bSYour Name  * Return: wmi handler
119*5113495bSYour Name  */
120*5113495bSYour Name struct wmi_unified *lmac_get_wmi_hdl(struct wlan_objmgr_psoc *psoc);
121*5113495bSYour Name 
122*5113495bSYour Name /**
123*5113495bSYour Name  * lmac_get_wmi_unified_hdl() - get wmi handle
124*5113495bSYour Name  * @psoc: pointer to psoc
125*5113495bSYour Name  *
126*5113495bSYour Name  * API to get wmi handle
127*5113495bSYour Name  *
128*5113495bSYour Name  * Return: wmi handler
129*5113495bSYour Name  */
130*5113495bSYour Name wmi_unified_t lmac_get_wmi_unified_hdl(struct wlan_objmgr_psoc *psoc);
131*5113495bSYour Name 
132*5113495bSYour Name /**
133*5113495bSYour Name  * lmac_get_htc_hdl() - get htc handler
134*5113495bSYour Name  * @psoc: pointer to psoc
135*5113495bSYour Name  *
136*5113495bSYour Name  * API to get htc handle
137*5113495bSYour Name  *
138*5113495bSYour Name  * Return: htc handler
139*5113495bSYour Name  */
140*5113495bSYour Name HTC_HANDLE lmac_get_htc_hdl(struct wlan_objmgr_psoc *psoc);
141*5113495bSYour Name 
142*5113495bSYour Name /**
143*5113495bSYour Name  * lmac_set_htc_hdl() - set htc handle
144*5113495bSYour Name  * @psoc: pointer to psoc
145*5113495bSYour Name  * @htc_hdl: HTC handle
146*5113495bSYour Name  *
147*5113495bSYour Name  * API to set htc handle
148*5113495bSYour Name  *
149*5113495bSYour Name  * Return: void
150*5113495bSYour Name  */
151*5113495bSYour Name void lmac_set_htc_hdl(struct wlan_objmgr_psoc *psoc,
152*5113495bSYour Name 		      HTC_HANDLE htc_hdl);
153*5113495bSYour Name 
154*5113495bSYour Name /**
155*5113495bSYour Name  * lmac_get_hif_hdl() - get hif handle
156*5113495bSYour Name  * @psoc: pointer to psoc
157*5113495bSYour Name  *
158*5113495bSYour Name  * API to get hif handle
159*5113495bSYour Name  *
160*5113495bSYour Name  * Return: hif handler
161*5113495bSYour Name  */
162*5113495bSYour Name struct hif_opaque_softc *lmac_get_hif_hdl(struct wlan_objmgr_psoc *psoc);
163*5113495bSYour Name 
164*5113495bSYour Name /**
165*5113495bSYour Name  * lmac_get_ol_hif_hdl() - get hif handle
166*5113495bSYour Name  * @psoc: pointer to psoc
167*5113495bSYour Name  *
168*5113495bSYour Name  * API to get hif handle
169*5113495bSYour Name  *
170*5113495bSYour Name  * Return: hif handler
171*5113495bSYour Name  */
172*5113495bSYour Name struct hif_opaque_softc *lmac_get_ol_hif_hdl(struct wlan_objmgr_psoc *psoc);
173*5113495bSYour Name 
174*5113495bSYour Name /**
175*5113495bSYour Name  * lmac_get_pdev_wmi_handle() - get pdev wmi handle
176*5113495bSYour Name  * @pdev: pointer to dev
177*5113495bSYour Name  *
178*5113495bSYour Name  * API to get wmi handle
179*5113495bSYour Name  *
180*5113495bSYour Name  * Return: wmi handle
181*5113495bSYour Name  */
182*5113495bSYour Name struct wmi_unified *lmac_get_pdev_wmi_handle(
183*5113495bSYour Name 		struct wlan_objmgr_pdev *pdev);
184*5113495bSYour Name 
185*5113495bSYour Name /**
186*5113495bSYour Name  * lmac_get_pdev_wmi_unified_handle() - get pdev wmi handle
187*5113495bSYour Name  * @pdev: pointer to dev
188*5113495bSYour Name  *
189*5113495bSYour Name  * API to get wmi handle
190*5113495bSYour Name  *
191*5113495bSYour Name  * Return: wmi handle
192*5113495bSYour Name  */
193*5113495bSYour Name wmi_unified_t lmac_get_pdev_wmi_unified_handle(
194*5113495bSYour Name 		struct wlan_objmgr_pdev *pdev);
195*5113495bSYour Name 
196*5113495bSYour Name /**
197*5113495bSYour Name  * lmac_get_psoc_feature_ptr() - get feature pointer
198*5113495bSYour Name  * @psoc: pointer to psoc
199*5113495bSYour Name  *
200*5113495bSYour Name  * API to get legacy pointer
201*5113495bSYour Name  *
202*5113495bSYour Name  * Return: feature pointer
203*5113495bSYour Name  */
204*5113495bSYour Name void *lmac_get_psoc_feature_ptr(struct wlan_objmgr_psoc *psoc);
205*5113495bSYour Name 
206*5113495bSYour Name /**
207*5113495bSYour Name  * lmac_get_pdev_feature_ptr() - get feature pointer
208*5113495bSYour Name  * @pdev: pointer to pdev
209*5113495bSYour Name  *
210*5113495bSYour Name  * API to get legacy pointer
211*5113495bSYour Name  *
212*5113495bSYour Name  * Return: pdev feature pointer
213*5113495bSYour Name  */
214*5113495bSYour Name void *lmac_get_pdev_feature_ptr(struct wlan_objmgr_pdev *pdev);
215*5113495bSYour Name 
216*5113495bSYour Name /**
217*5113495bSYour Name  * lmac_get_num_radios() - get number of radios
218*5113495bSYour Name  * @psoc: pointer to psoc
219*5113495bSYour Name  *
220*5113495bSYour Name  * API to get number of radios
221*5113495bSYour Name  *
222*5113495bSYour Name  * Return: number of radios
223*5113495bSYour Name  */
224*5113495bSYour Name uint32_t lmac_get_num_radios(struct wlan_objmgr_psoc *psoc);
225*5113495bSYour Name 
226*5113495bSYour Name /**
227*5113495bSYour Name  * lmac_get_preferred_hw_mode() - get preferred hw mode
228*5113495bSYour Name  * @psoc: pointer to psoc
229*5113495bSYour Name  *
230*5113495bSYour Name  * API to get the preferred hw mode
231*5113495bSYour Name  *
232*5113495bSYour Name  * Return: preferred how mode
233*5113495bSYour Name  */
234*5113495bSYour Name enum wmi_host_hw_mode_config_type lmac_get_preferred_hw_mode(
235*5113495bSYour Name 				struct wlan_objmgr_psoc *psoc);
236*5113495bSYour Name 
237*5113495bSYour Name #endif /* _INIT_DEINIT_LMAC_H_ */
238