xref: /wlan-driver/qcacld-3.0/core/hdd/src/wlan_hdd_lpass.h (revision 5113495b16420b49004c444715d2daae2066e7dc)
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2012-2018 The Linux Foundation. All rights reserved.
3*5113495bSYour Name  * Copyright (c) 2023 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 #if !defined(WLAN_HDD_LPASS_H)
21*5113495bSYour Name #define WLAN_HDD_LPASS_H
22*5113495bSYour Name 
23*5113495bSYour Name struct cds_config_info;
24*5113495bSYour Name struct wma_tgt_cfg;
25*5113495bSYour Name struct hdd_context;
26*5113495bSYour Name struct hdd_adapter;
27*5113495bSYour Name 
28*5113495bSYour Name #ifdef WLAN_FEATURE_LPSS
29*5113495bSYour Name /**
30*5113495bSYour Name  * hdd_lpass_target_config() - Handle LPASS target configuration
31*5113495bSYour Name  * @hdd_ctx: HDD global context where lpass information is stored
32*5113495bSYour Name  * @target_config: Target configuration containing lpass info
33*5113495bSYour Name  *
34*5113495bSYour Name  * This function updates the HDD context with lpass-specific
35*5113495bSYour Name  * information provided by the target.
36*5113495bSYour Name  *
37*5113495bSYour Name  * Return: none
38*5113495bSYour Name  */
39*5113495bSYour Name void hdd_lpass_target_config(struct hdd_context *hdd_ctx,
40*5113495bSYour Name 			     struct wma_tgt_cfg *target_config);
41*5113495bSYour Name 
42*5113495bSYour Name /**
43*5113495bSYour Name  * hdd_lpass_populate_cds_config() - Populate LPASS configuration
44*5113495bSYour Name  * @cds_config: CDS configuration to populate with lpass info
45*5113495bSYour Name  * @hdd_ctx: HDD global context which contains lpass information
46*5113495bSYour Name  *
47*5113495bSYour Name  * This function seeds the CDS configuration structure with
48*5113495bSYour Name  * lpass-specific information gleaned from the HDD context.
49*5113495bSYour Name  *
50*5113495bSYour Name  * Return: none
51*5113495bSYour Name  */
52*5113495bSYour Name void hdd_lpass_populate_cds_config(struct cds_config_info *cds_config,
53*5113495bSYour Name 				   struct hdd_context *hdd_ctx);
54*5113495bSYour Name 
55*5113495bSYour Name /**
56*5113495bSYour Name  * hdd_lpass_populate_pmo_config() - Populate LPASS configuration
57*5113495bSYour Name  * @pmo_config: PMO configuration to populate with lpass info
58*5113495bSYour Name  * @hdd_ctx: HDD global context which contains lpass information
59*5113495bSYour Name  *
60*5113495bSYour Name  * This function seeds the PMO configuration structure with
61*5113495bSYour Name  * lpass-specific information gleaned from the HDD context.
62*5113495bSYour Name  *
63*5113495bSYour Name  * Return: none
64*5113495bSYour Name  */
65*5113495bSYour Name void hdd_lpass_populate_pmo_config(struct pmo_psoc_cfg *pmo_config,
66*5113495bSYour Name 				   struct hdd_context *hdd_ctx);
67*5113495bSYour Name 
68*5113495bSYour Name /**
69*5113495bSYour Name  * hdd_lpass_notify_connect() - Notify LPASS of interface connect
70*5113495bSYour Name  * @link_info: Link info pointer in HDD adapter
71*5113495bSYour Name  *
72*5113495bSYour Name  * This function is used to notify the LPASS feature that an adapter
73*5113495bSYour Name  * has connected.
74*5113495bSYour Name  *
75*5113495bSYour Name  * Return: none
76*5113495bSYour Name  */
77*5113495bSYour Name void hdd_lpass_notify_connect(struct wlan_hdd_link_info *link_info);
78*5113495bSYour Name 
79*5113495bSYour Name /**
80*5113495bSYour Name  * hdd_lpass_notify_disconnect() - Notify LPASS of interface disconnect
81*5113495bSYour Name  * @link_info: Link info pointer in HDD adapter
82*5113495bSYour Name  *
83*5113495bSYour Name  * This function is used to notify the LPASS feature that an adapter
84*5113495bSYour Name  * has disconnected.
85*5113495bSYour Name  *
86*5113495bSYour Name  * Return: none
87*5113495bSYour Name  */
88*5113495bSYour Name void hdd_lpass_notify_disconnect(struct wlan_hdd_link_info *link_info);
89*5113495bSYour Name 
90*5113495bSYour Name /**
91*5113495bSYour Name  * hdd_lpass_notify_mode_change() - Notify LPASS of interface mode change
92*5113495bSYour Name  * @link_info: Link info pointer in HDD adapter
93*5113495bSYour Name  *
94*5113495bSYour Name  * This function is used to notify the LPASS feature that an adapter
95*5113495bSYour Name  * had its mode changed.
96*5113495bSYour Name  *
97*5113495bSYour Name  * Return: none
98*5113495bSYour Name  */
99*5113495bSYour Name void hdd_lpass_notify_mode_change(struct wlan_hdd_link_info *link_info);
100*5113495bSYour Name 
101*5113495bSYour Name /**
102*5113495bSYour Name  * hdd_lpass_notify_start() - Notify LPASS of driver start
103*5113495bSYour Name  * @link_info: Link info pointer in HDD adapter
104*5113495bSYour Name  *
105*5113495bSYour Name  * This function is used to notify the LPASS feature that the wlan
106*5113495bSYour Name  * driver has (re-)started.
107*5113495bSYour Name  *
108*5113495bSYour Name  * Return: none
109*5113495bSYour Name  */
110*5113495bSYour Name void hdd_lpass_notify_start(struct wlan_hdd_link_info *link_info);
111*5113495bSYour Name 
112*5113495bSYour Name /**
113*5113495bSYour Name  * hdd_lpass_notify_stop() - Notify LPASS of driver stop
114*5113495bSYour Name  * @hdd_ctx: The global HDD context
115*5113495bSYour Name  *
116*5113495bSYour Name  * This function is used to notify the LPASS feature that the wlan
117*5113495bSYour Name  * driver has stopped.
118*5113495bSYour Name  *
119*5113495bSYour Name  * Return: none
120*5113495bSYour Name  */
121*5113495bSYour Name void hdd_lpass_notify_stop(struct hdd_context *hdd_ctx);
122*5113495bSYour Name 
123*5113495bSYour Name /**
124*5113495bSYour Name  * hdd_lpass_is_supported() - Is lpass feature supported?
125*5113495bSYour Name  * @hdd_ctx: The global HDD context
126*5113495bSYour Name  *
127*5113495bSYour Name  * Return: true if feature is enabled and supported by firmware, false
128*5113495bSYour Name  * if the feature is not enabled or not supported by firmware.
129*5113495bSYour Name  */
130*5113495bSYour Name bool hdd_lpass_is_supported(struct hdd_context *hdd_ctx);
131*5113495bSYour Name 
132*5113495bSYour Name /*
133*5113495bSYour Name  * hdd_lpass_notify_wlan_version() - Notify LPASS WLAN Host/FW version
134*5113495bSYour Name  * @hdd_ctx: The global HDD context
135*5113495bSYour Name  *
136*5113495bSYour Name  * Notify LPASS for the WLAN host/firmware and hardware version.
137*5113495bSYour Name  *
138*5113495bSYour Name  * Return: none
139*5113495bSYour Name  */
140*5113495bSYour Name void hdd_lpass_notify_wlan_version(struct hdd_context *hdd_ctx);
141*5113495bSYour Name #else
hdd_lpass_target_config(struct hdd_context * hdd_ctx,struct wma_tgt_cfg * target_config)142*5113495bSYour Name static inline void hdd_lpass_target_config(struct hdd_context *hdd_ctx,
143*5113495bSYour Name 					   struct wma_tgt_cfg *target_config)
144*5113495bSYour Name {
145*5113495bSYour Name }
146*5113495bSYour Name static inline
hdd_lpass_populate_cds_config(struct cds_config_info * cds_config,struct hdd_context * hdd_ctx)147*5113495bSYour Name void hdd_lpass_populate_cds_config(struct cds_config_info *cds_config,
148*5113495bSYour Name 				   struct hdd_context *hdd_ctx)
149*5113495bSYour Name {
150*5113495bSYour Name }
151*5113495bSYour Name 
152*5113495bSYour Name static inline
hdd_lpass_populate_pmo_config(struct pmo_psoc_cfg * pmo_config,struct hdd_context * hdd_ctx)153*5113495bSYour Name void hdd_lpass_populate_pmo_config(struct pmo_psoc_cfg *pmo_config,
154*5113495bSYour Name 				   struct hdd_context *hdd_ctx)
155*5113495bSYour Name {
156*5113495bSYour Name }
157*5113495bSYour Name 
158*5113495bSYour Name static inline void
hdd_lpass_notify_connect(struct wlan_hdd_link_info * link_info)159*5113495bSYour Name hdd_lpass_notify_connect(struct wlan_hdd_link_info *link_info)
160*5113495bSYour Name {
161*5113495bSYour Name }
162*5113495bSYour Name 
163*5113495bSYour Name static inline void
hdd_lpass_notify_disconnect(struct wlan_hdd_link_info * link_info)164*5113495bSYour Name hdd_lpass_notify_disconnect(struct wlan_hdd_link_info *link_info)
165*5113495bSYour Name {
166*5113495bSYour Name }
167*5113495bSYour Name 
168*5113495bSYour Name static inline void
hdd_lpass_notify_mode_change(struct wlan_hdd_link_info * link_info)169*5113495bSYour Name hdd_lpass_notify_mode_change(struct wlan_hdd_link_info *link_info)
170*5113495bSYour Name {
171*5113495bSYour Name }
172*5113495bSYour Name 
173*5113495bSYour Name static inline void
hdd_lpass_notify_start(struct wlan_hdd_link_info * link_info)174*5113495bSYour Name hdd_lpass_notify_start(struct wlan_hdd_link_info *link_info)
175*5113495bSYour Name {
176*5113495bSYour Name }
177*5113495bSYour Name 
hdd_lpass_notify_stop(struct hdd_context * hdd_ctx)178*5113495bSYour Name static inline void hdd_lpass_notify_stop(struct hdd_context *hdd_ctx) { }
hdd_lpass_is_supported(struct hdd_context * hdd_ctx)179*5113495bSYour Name static inline bool hdd_lpass_is_supported(struct hdd_context *hdd_ctx)
180*5113495bSYour Name {
181*5113495bSYour Name 	return false;
182*5113495bSYour Name }
183*5113495bSYour Name 
hdd_lpass_notify_wlan_version(struct hdd_context * hdd_ctx)184*5113495bSYour Name static inline void hdd_lpass_notify_wlan_version(struct hdd_context *hdd_ctx)
185*5113495bSYour Name {
186*5113495bSYour Name }
187*5113495bSYour Name 
188*5113495bSYour Name #endif
189*5113495bSYour Name 
190*5113495bSYour Name #endif /* WLAN_HDD_LPASS_H */
191