xref: /wlan-driver/qcacld-3.0/core/hdd/src/wlan_hdd_dcs.h (revision 5113495b16420b49004c444715d2daae2066e7dc)
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2020, 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 any
6*5113495bSYour Name  * purpose with or without fee is hereby granted, provided that the above
7*5113495bSYour Name  * copyright notice and this permission notice appear in all copies.
8*5113495bSYour Name  *
9*5113495bSYour Name  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10*5113495bSYour Name  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11*5113495bSYour Name  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12*5113495bSYour Name  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13*5113495bSYour Name  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14*5113495bSYour Name  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15*5113495bSYour Name  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16*5113495bSYour Name  */
17*5113495bSYour Name 
18*5113495bSYour Name /**
19*5113495bSYour Name  * DOC: wlan_hdd_dcs.h
20*5113495bSYour Name  *
21*5113495bSYour Name  * WLAN Host Device Driver dcs related implementation
22*5113495bSYour Name  *
23*5113495bSYour Name  */
24*5113495bSYour Name 
25*5113495bSYour Name #if !defined(WLAN_HDD_DCS_H)
26*5113495bSYour Name #define WLAN_HDD_DCS_H
27*5113495bSYour Name 
28*5113495bSYour Name #include <wlan_hdd_main.h>
29*5113495bSYour Name 
30*5113495bSYour Name #ifdef DCS_INTERFERENCE_DETECTION
31*5113495bSYour Name /**
32*5113495bSYour Name  * hdd_dcs_register_cb() - register dcs callback
33*5113495bSYour Name  * @hdd_ctx: hdd ctx
34*5113495bSYour Name  *
35*5113495bSYour Name  * This function is used to register the HDD callbacks with dcs component
36*5113495bSYour Name  *
37*5113495bSYour Name  * Return: None
38*5113495bSYour Name  */
39*5113495bSYour Name void hdd_dcs_register_cb(struct hdd_context *hdd_ctx);
40*5113495bSYour Name 
41*5113495bSYour Name /**
42*5113495bSYour Name  * hdd_dcs_hostapd_set_chan() - switch sap channel to dcs channel
43*5113495bSYour Name  * @hdd_ctx: hdd ctx
44*5113495bSYour Name  * @vdev_id: vdev id
45*5113495bSYour Name  * @dcs_ch_freq: dcs channel freq
46*5113495bSYour Name  *
47*5113495bSYour Name  * This function is used to switch sap channel to dcs channel using (E)CSA
48*5113495bSYour Name  *
49*5113495bSYour Name  * Return: None
50*5113495bSYour Name  */
51*5113495bSYour Name QDF_STATUS hdd_dcs_hostapd_set_chan(struct hdd_context *hdd_ctx,
52*5113495bSYour Name 				    uint8_t vdev_id,
53*5113495bSYour Name 				    qdf_freq_t dcs_ch_freq);
54*5113495bSYour Name 
55*5113495bSYour Name /**
56*5113495bSYour Name  * hdd_dcs_chan_select_complete() - dcs triggered channel select
57*5113495bSYour Name  * complete handling
58*5113495bSYour Name  * @adapter: hdd adapter pointer
59*5113495bSYour Name  *
60*5113495bSYour Name  * When dcs triggered channel select complete, this function is used to do
61*5113495bSYour Name  * switch sap to new dcs channel or just to enable interference mitigation
62*5113495bSYour Name  *
63*5113495bSYour Name  * Return: None
64*5113495bSYour Name  */
65*5113495bSYour Name void hdd_dcs_chan_select_complete(struct hdd_adapter *adapter);
66*5113495bSYour Name 
67*5113495bSYour Name /**
68*5113495bSYour Name  * hdd_dcs_clear() - clear dcs information
69*5113495bSYour Name  * @adapter: hdd adapter pointer
70*5113495bSYour Name  *
71*5113495bSYour Name  * This function is used to clear sap dcs related information such as
72*5113495bSYour Name  * im stats and freq ctrl params
73*5113495bSYour Name  *
74*5113495bSYour Name  * Return: None
75*5113495bSYour Name  */
76*5113495bSYour Name void hdd_dcs_clear(struct hdd_adapter *adapter);
77*5113495bSYour Name #else
hdd_dcs_register_cb(struct hdd_context * hdd_ctx)78*5113495bSYour Name static inline void hdd_dcs_register_cb(struct hdd_context *hdd_ctx)
79*5113495bSYour Name {
80*5113495bSYour Name }
81*5113495bSYour Name 
hdd_dcs_hostapd_set_chan(struct hdd_context * hdd_ctx,uint8_t vdev_id,qdf_freq_t dcs_ch_freq)82*5113495bSYour Name static inline QDF_STATUS hdd_dcs_hostapd_set_chan(struct hdd_context *hdd_ctx,
83*5113495bSYour Name 						  uint8_t vdev_id,
84*5113495bSYour Name 						  qdf_freq_t dcs_ch_freq)
85*5113495bSYour Name {
86*5113495bSYour Name 	return QDF_STATUS_SUCCESS;
87*5113495bSYour Name }
88*5113495bSYour Name 
hdd_dcs_chan_select_complete(struct hdd_adapter * adapter)89*5113495bSYour Name static inline void hdd_dcs_chan_select_complete(struct hdd_adapter *adapter)
90*5113495bSYour Name {
91*5113495bSYour Name }
92*5113495bSYour Name 
hdd_dcs_clear(struct hdd_adapter * adapter)93*5113495bSYour Name static inline void hdd_dcs_clear(struct hdd_adapter *adapter)
94*5113495bSYour Name {
95*5113495bSYour Name }
96*5113495bSYour Name #endif
97*5113495bSYour Name 
98*5113495bSYour Name #endif /* end #if !defined(WLAN_HDD_DCS_H) */
99