xref: /wlan-dirver/qca-wifi-host-cmn/umac/dfs/core/src/dfs.h (revision b4466310b5c0ded95ce954f146e3e4ce6f87f267)
1 /*
2  * Copyright (c) 2013, 2016-2021 The Linux Foundation.  All rights reserved.
3  * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
4  * Copyright (c) 2005-2006 Atheros Communications, Inc.
5  *
6  * Permission to use, copy, modify, and/or distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 /**
20  * DOC: This file has main dfs structures.
21  */
22 
23 #ifndef _DFS_H_
24 #define _DFS_H_
25 
26 #include <qdf_types.h>       /* QDF_NBUF_EXEMPT_NO_EXEMPTION, etc. */
27 #include <qdf_net_types.h>   /* QDF_NBUF_EXEMPT_NO_EXEMPTION, etc. */
28 #include <qdf_nbuf.h>        /* qdf_nbuf_t, etc. */
29 #include <qdf_util.h>        /* qdf_assert */
30 #include <qdf_lock.h>        /* qdf_spinlock */
31 #include <qdf_time.h>
32 #include <qdf_timer.h>
33 #include <qdf_hrtimer.h>
34 #include <qdf_str.h>         /* qdf_str_lcopy */
35 
36 #include <wlan_dfs_ioctl.h>
37 #include "dfs_structs.h"
38 #include "dfs_channel.h"
39 #include "dfs_ioctl_private.h"
40 #include <i_qdf_types.h>     /* For qdf_packed*/
41 #include "queue.h"           /* For STAILQ_ENTRY */
42 #include <wlan_objmgr_psoc_obj.h>
43 #include <wlan_objmgr_pdev_obj.h>
44 #include <osdep.h>
45 #include <wlan_cmn.h>
46 #include "target_type.h"
47 #include <wlan_dfs_public_struct.h>
48 #include <reg_services_public_struct.h>
49 
50 /* File Line and Submodule String */
51 #define FLSM(x, str)   #str " : " FL(x)
52 /* Cast to dfs type */
53 #define DC(x)  ((struct wlan_dfs *)(x))
54 
55 /**
56  * dfs_log: dfs logging using submodule MASKs and
57  * QDF trace level.
58  * The logging is controlled by two bitmasks:
59  * 1) submodule bitmask: sm
60  * 2) trace level masks: level
61  *
62  * @dfs: The dfs object pointer or NULL if dfs is not defined.
63  * @sm: Submodule BITMASK.
64  * @level: QDF trace level.
65  * @args...: Variable argument list.
66  *
67  * The submodule(sm) cannot be empty even if argument dfs is NULL.
68  * Else the macro will create a  compilation  error.
69  * One may provide WLAN_DEBUG_DFS_ALWAYS when  the argument dfs is NULL.
70  * Example:-
71  * dfs_log(NULL, WLAN_DEBUG_DFS_ALWAYS, QDF_TRACE_LEVEL_INFO,"Error pulse");
72  *
73  * Why DC(x) is required?
74  * Since NULL is defined as ((void *)(0)), if the argument "dfs"
75  * in a call to the macro "dfs_log" is NULL
76  * then during compilation (NULL)->dfs_debug_mask will dereference
77  * a (void *) type, which is illegal. Therefore, we need
78  * the cast: (DC(dfs))->dfs_debug_mask.
79  * Example:-
80  * dfs_log(NULL, WLAN_DEBUG_DFS, QDF_TRACE_LEVEL_INFO,"dfs is NULL");
81  */
82 #define dfs_log(dfs, sm, level, args...)  do {        \
83 	if (((dfs) == NULL) ||                            \
84 			((sm) == WLAN_DEBUG_DFS_ALWAYS) ||        \
85 			((sm) & ((DC(dfs))->dfs_debug_mask))) {   \
86 		QDF_TRACE(QDF_MODULE_ID_DFS, level, ## args); \
87 	}                                                 \
88 } while (0)
89 
90 #define dfs_logfl(dfs, level, sm, format, args...) \
91 	dfs_log(dfs, sm, level, FLSM(format, sm), ## args)
92 
93 #define dfs_alert(dfs, sm, format, args...) \
94 	dfs_logfl(dfs, QDF_TRACE_LEVEL_FATAL, sm, format, ## args)
95 
96 #define dfs_err(dfs, sm, format, args...) \
97 	dfs_logfl(dfs, QDF_TRACE_LEVEL_ERROR, sm, format, ## args)
98 
99 #define dfs_warn(dfs, sm, format, args...) \
100 	dfs_logfl(dfs, QDF_TRACE_LEVEL_WARN, sm, format, ## args)
101 
102 #define dfs_info(dfs, sm, format, args...) \
103 	dfs_logfl(dfs, QDF_TRACE_LEVEL_INFO, sm, format, ## args)
104 
105 #define dfs_debug(dfs, sm, format, args...) \
106 	dfs_logfl(dfs, QDF_TRACE_LEVEL_DEBUG, sm, format, ## args)
107 
108 #define DFS_MIN(a, b) ((a) < (b)?(a):(b))
109 #define DFS_MAX(a, b) ((a) > (b)?(a) : (b))
110 #define DFS_DIFF(a, b)(DFS_MAX(a, b) - DFS_MIN(a, b))
111 
112 /**
113  * Maximum number of radar events to be processed in a single iteration.
114  * Allows soft watchdog to run.
115  */
116 #define MAX_EVENTS 100
117 
118 /**
119  * Constants to use for chirping detection.
120  *
121  * All are unconverted as HW reports them.
122  *
123  * XXX Are these constants with or without fast clock 5GHz operation?
124  * XXX Peregrine reports pulses in microseconds, not hardware clocks!
125  */
126 
127 #define MAX_DUR_FOR_LOW_RSSI 4
128 
129 /**
130  * Cascade has issue with reported duration especially when there is a
131  * crossover of chirp from one segment to another. It may report a value
132  * of duration that is well below 50us for a valid FCC type 5 chirping
133  * pulse. For now changing minimum duration as a work around. This will
134  * affect all chips but since we detect chirp with Merlin+, we may be OK
135  * for now. We need a more robust solution for this.
136  */
137 #define MIN_BIN5_DUR_CAS            25 /* 50 * 1.25*/
138 #define MIN_BIN5_DUR_MICROSEC_CAS   20
139 #define MIN_BIN5_DUR                63 /* 50 * 1.25*/
140 #define MIN_BIN5_DUR_MICROSEC       50
141 #define MAYBE_BIN5_DUR              35 /* 28 * 1.25*/
142 #define MAYBE_BIN5_DUR_MICROSEC     28
143 
144 /* Conversion is already done using dfs->dur_multiplier */
145 #define MAX_BIN5_DUR                145   /* use 145 for osprey */
146 #define MAX_BIN5_DUR_MICROSEC       105
147 
148 #define DFS_MARGIN_EQUAL(a, b, margin)	((DFS_DIFF(a, b)) <= margin)
149 #define DFS_MAX_STAGGERED_BURSTS    3
150 
151 /**
152  * All filter thresholds in the radar filter tables are effective at a 50%
153  * channel loading.
154  */
155 #define DFS_CHAN_LOADING_THRESH     50
156 #define DFS_EXT_CHAN_LOADING_THRESH 30
157 #define DFS_DEFAULT_PRI_MARGIN      6
158 #define DFS_DEFAULT_FIXEDPATTERN_PRI_MARGIN	4
159 
160 #define WLAN_DFSQ_LOCK(_dfs)         qdf_spin_lock_bh(&(_dfs)->dfs_radarqlock)
161 #define WLAN_DFSQ_UNLOCK(_dfs)       qdf_spin_unlock_bh(&(_dfs)->dfs_radarqlock)
162 #define WLAN_DFSQ_LOCK_CREATE(_dfs)  qdf_spinlock_create( \
163 		&(_dfs)->dfs_radarqlock)
164 #define WLAN_DFSQ_LOCK_DESTROY(_dfs) qdf_spinlock_destroy( \
165 		&(_dfs)->dfs_radarqlock)
166 
167 #define WLAN_ARQ_LOCK(_dfs)          qdf_spin_lock_bh(&(_dfs)->dfs_arqlock)
168 #define WLAN_ARQ_UNLOCK(_dfs)        qdf_spin_unlock_bh(&(_dfs)->dfs_arqlock)
169 #define WLAN_ARQ_LOCK_CREATE(_dfs)   qdf_spinlock_create(&(_dfs)->dfs_arqlock)
170 #define WLAN_ARQ_LOCK_DESTROY(_dfs)  qdf_spinlock_destroy(&(_dfs)->dfs_arqlock)
171 
172 #define WLAN_DFSEVENTQ_LOCK(_dfs)         qdf_spin_lock_bh(&(_dfs)->dfs_eventqlock)
173 #define WLAN_DFSEVENTQ_UNLOCK(_dfs)       qdf_spin_unlock_bh( \
174 		&(_dfs)->dfs_eventqlock)
175 #define WLAN_DFSEVENTQ_LOCK_CREATE(_dfs)  qdf_spinlock_create( \
176 		&(_dfs)->dfs_eventqlock)
177 #define WLAN_DFSEVENTQ_LOCK_DESTROY(_dfs) qdf_spinlock_destroy( \
178 		&(_dfs)->dfs_eventqlock)
179 
180 #define WLAN_DFSNOL_LOCK(_dfs)         qdf_spin_lock_bh(&(_dfs)->dfs_nol_lock)
181 #define WLAN_DFSNOL_UNLOCK(_dfs)       qdf_spin_unlock_bh(&(_dfs)->dfs_nol_lock)
182 #define WLAN_DFSNOL_LOCK_CREATE(_dfs)  qdf_spinlock_create( \
183 		&(_dfs)->dfs_nol_lock)
184 #define WLAN_DFSNOL_LOCK_DESTROY(_dfs) qdf_spinlock_destroy( \
185 		&(_dfs)->dfs_nol_lock)
186 
187 #define PRECAC_LIST_LOCK(_dfs)         qdf_spin_lock_irqsave( \
188 		&(_dfs)->dfs_precac_lock)
189 #define PRECAC_LIST_UNLOCK(_dfs)       qdf_spin_unlock_irqrestore( \
190 		&(_dfs)->dfs_precac_lock)
191 #define PRECAC_LIST_LOCK_CREATE(_dfs)  qdf_spinlock_create( \
192 		&(_dfs)->dfs_precac_lock)
193 #define PRECAC_LIST_LOCK_DESTROY(_dfs) qdf_spinlock_destroy( \
194 		&(_dfs)->dfs_precac_lock)
195 
196 #define WLAN_DFS_DATA_STRUCT_LOCK(_dfs) \
197 	qdf_spin_lock_bh(&(_dfs)->dfs_data_struct_lock)
198 #define WLAN_DFS_DATA_STRUCT_UNLOCK(_dfs) \
199 	qdf_spin_unlock_bh(&(_dfs)->dfs_data_struct_lock)
200 #define WLAN_DFS_DATA_STRUCT_LOCK_CREATE(_dfs) \
201 	qdf_spinlock_create(&(_dfs)->dfs_data_struct_lock)
202 #define WLAN_DFS_DATA_STRUCT_LOCK_DESTROY(_dfs) \
203 	qdf_spinlock_destroy(&(_dfs)->dfs_data_struct_lock)
204 
205 /* Wrappers to call MLME radar during mode switch lock. */
206 #define DFS_RADAR_MODE_SWITCH_LOCK(_dfs) \
207 	dfs_mlme_acquire_radar_mode_switch_lock((_dfs)->dfs_pdev_obj)
208 #define DFS_RADAR_MODE_SWITCH_UNLOCK(_dfs) \
209 	dfs_mlme_release_radar_mode_switch_lock((_dfs)->dfs_pdev_obj)
210 
211 /* Mask for time stamp from descriptor */
212 #define DFS_TSMASK    0xFFFFFFFF
213 /* Shift for time stamp from descriptor */
214 #define DFS_TSSHIFT   32
215 /* 64 bit TSF wrap value */
216 #define DFS_TSF_WRAP  0xFFFFFFFFFFFFFFFFULL
217 /* TS mask for 64 bit value */
218 #define DFS_64BIT_TSFMASK 0x0000000000007FFFULL
219 
220 #define DFS_AR_RADAR_RSSI_THR          5 /* in dB */
221 #define DFS_AR_RADAR_RESET_INT         1 /* in secs */
222 #define DFS_AR_RADAR_MAX_HISTORY       500
223 #define DFS_AR_REGION_WIDTH            128
224 #define DFS_AR_RSSI_THRESH_STRONG_PKTS 17 /* in dB */
225 #define DFS_AR_RSSI_DOUBLE_THRESHOLD   15 /* in dB */
226 #define DFS_AR_MAX_NUM_ACK_REGIONS     9
227 #define DFS_AR_ACK_DETECT_PAR_THRESH   20
228 #define DFS_AR_PKT_COUNT_THRESH        20
229 
230 #define DFS_MAX_DL_SIZE                64
231 #define DFS_MAX_DL_MASK                0x3F
232 
233 #define DFS_NOL_TIME DFS_NOL_TIMEOUT_US
234 /* 30 minutes in usecs */
235 
236 #define DFS_WAIT_TIME (60*1000000) /* 1 minute in usecs */
237 
238 #define DFS_DISABLE_TIME (3*60*1000000) /* 3 minutes in usecs */
239 
240 #define DFS_MAX_B5_SIZE 128
241 #define DFS_MAX_B5_MASK 0x0000007F /* 128 */
242 
243 /* Max number of overlapping filters */
244 #define DFS_MAX_RADAR_OVERLAP 16
245 
246 /* Max number of dfs events which can be q'd */
247 #define DFS_MAX_EVENTS 1024
248 
249 #define DFS_RADAR_EN       0x80000000 /* Radar detect is capable */
250 #define DFS_AR_EN          0x40000000 /* AR detect is capable */
251 /* Radar detect in second segment is capable */
252 #define DFS_SECOND_SEGMENT_RADAR_EN 0x20000000
253 #define DFS_MAX_RSSI_VALUE 0x7fffffff /* Max rssi value */
254 
255 #define DFS_BIN_MAX_PULSES 60 /* max num of pulses in a burst */
256 #define DFS_BIN5_PRI_LOWER_LIMIT 990 /* us */
257 
258 /**
259  * To cover the single pusle burst case, change from 2010 us to
260  * 2010000 us.
261  */
262 
263 /**
264  * This is reverted back to 2010 as larger value causes false
265  * bin5 detect (EV76432, EV76320)
266  */
267 #define DFS_BIN5_PRI_HIGHER_LIMIT 2010 /* us */
268 
269 #define DFS_BIN5_WIDTH_MARGIN 4 /* us */
270 #define DFS_BIN5_RSSI_MARGIN  5 /* dBm */
271 
272 /**
273  * Following threshold is not specified but should be
274  * okay statistically.
275  */
276 #define DFS_BIN5_BRI_LOWER_LIMIT 300000   /* us */
277 #define DFS_BIN5_BRI_UPPER_LIMIT 12000000 /* us */
278 
279 /* Max number of pulses kept in buffer */
280 #define DFS_MAX_PULSE_BUFFER_SIZE   1024
281 #define DFS_MAX_PULSE_BUFFER_MASK   0x3ff
282 
283 #define DFS_FAST_CLOCK_MULTIPLIER    (800/11)
284 #define DFS_NO_FAST_CLOCK_MULTIPLIER (80)
285 #define DFS_BIG_SIDX 10000
286 
287 /* Min value of valid psidx diff */
288 #define DFS_MIN_PSIDX_DIFF 4
289 /* Max value of valid psidx diff */
290 #define DFS_MAX_PSIDX_DIFF 16
291 
292 /**
293  * Software use: channel interference used for as AR as well as RADAR
294  * interference detection.
295  */
296 #define CHANNEL_INTERFERENCE    0x01
297 
298 /* qdf_packed - denotes structure is packed. */
299 #define qdf_packed __qdf_packed
300 
301 #define SEG_ID_PRIMARY         0
302 #define SEG_ID_SECONDARY       1
303 
304 /* MIN and MAX width for different regions */
305 #define REG0_MIN_WIDTH 33
306 #define REG0_MAX_WIDTH 38
307 #define REG1_MIN_WIDTH 39
308 #define REG1_MAX_WIDTH 44
309 #define REG2_MIN_WIDTH 53
310 #define REG2_MAX_WIDTH 58
311 #define REG3_MIN_WIDTH 126
312 #define REG3_MAX_WIDTH 140
313 #define REG4_MIN_WIDTH 141
314 #define REG4_MAX_WIDTH 160
315 #define REG5_MIN_WIDTH 189
316 #define REG5_MAX_WIDTH 210
317 #define REG6_MIN_WIDTH 360
318 #define REG6_MAX_WIDTH 380
319 #define REG7_MIN_WIDTH 257
320 #define REG7_MAX_WIDTH 270
321 #define REG8_MIN_WIDTH 295
322 #define REG8_MAX_WIDTH 302
323 
324 #define OVER_SAMPLING_FREQ 44000
325 #define SAMPLING_FREQ 40000
326 #define HUNDRED 100
327 #define NUM_BINS 128
328 #define THOUSAND 1000
329 
330 /* Array offset to ETSI legacy pulse */
331 #define ETSI_LEGACY_PULSE_ARR_OFFSET 4
332 
333 #define ETSI_RADAR_EN302_502_FREQ_LOWER 5725
334 #define ETSI_RADAR_EN302_502_FREQ_UPPER 5865
335 
336 #define DFS_NOL_ADD_CHAN_LOCKED(dfs, freq, timeout)         \
337 	do {                                                \
338 		WLAN_DFSNOL_LOCK(dfs);                      \
339 		dfs_nol_addchan(dfs, freq, timeout);        \
340 		WLAN_DFSNOL_UNLOCK(dfs);                    \
341 	} while (0)
342 
343 /*
344  * Free the NOL element in a thread. This is to avoid freeing the
345  * timer object from within timer callback function . The nol element
346  * contains the timer Object.
347  */
348 #define DFS_NOL_DELETE_CHAN_LOCKED(dfs, freq, chwidth)      \
349 	do {                                                \
350 		WLAN_DFSNOL_LOCK(dfs);                      \
351 		dfs_nol_delete(dfs, freq, chwidth);         \
352 		qdf_sched_work(NULL, &dfs->dfs_nol_elem_free_work); \
353 		WLAN_DFSNOL_UNLOCK(dfs);                    \
354 	} while (0)
355 
356 #define DFS_GET_NOL_LOCKED(dfs, dfs_nol, nchan)             \
357 	do {                                                \
358 		WLAN_DFSNOL_LOCK(dfs);                      \
359 		dfs_get_nol(dfs, dfs_nol, nchan);           \
360 		WLAN_DFSNOL_UNLOCK(dfs);                    \
361 	} while (0)
362 
363 #define DFS_PRINT_NOL_LOCKED(dfs)                           \
364 	do {                                                \
365 		WLAN_DFSNOL_LOCK(dfs);                      \
366 		dfs_print_nol(dfs);                         \
367 		WLAN_DFSNOL_UNLOCK(dfs);                    \
368 	} while (0)
369 
370 #define DFS_NOL_FREE_LIST_LOCKED(dfs)                       \
371 	do {                                                \
372 		WLAN_DFSNOL_LOCK(dfs);                      \
373 		dfs_nol_free_list(dfs);                     \
374 		WLAN_DFSNOL_UNLOCK(dfs);                    \
375 	} while (0)
376 
377 /* Host sends the average parameters of the radar pulses and starts the status
378  * wait timer with this timeout.
379  */
380 #if defined(WLAN_DFS_PARTIAL_OFFLOAD) && defined(HOST_DFS_SPOOF_TEST)
381 #define HOST_DFS_STATUS_WAIT_TIMER_MS 350
382 #endif
383 
384 /*
385  * USENOL_DISABLE_NOL_HOST_AND_FW : Do not add radar hit channel to NOL
386  * in host and FW. Enable CSA on the same channel.
387  */
388 #define USENOL_DISABLE_NOL_HOST_AND_FW 0
389 /*
390  * USENOL_ENABLE_NOL_HOST_AND_FW : Add the radar hit channel to NOL in
391  * host and FW (in case of FO). NOL timer cannot be configured by the user
392  * as FW does not allow manipulating NOL timeout. If noltimeout is configured,
393  * (say 1 min) FW will not be intimated about the configuration and hence NOL
394  * timer may elapse at different instances in host (after 1 min) and FW (after
395  * default 30 min) which could lead to DFS Violation if host tries to come up
396  * on the channel after host NOL timeout (of 1 min) as the FW would still
397  * have the channel in NOL list.
398  */
399 #define USENOL_ENABLE_NOL_HOST_AND_FW 1
400 /*
401  * USENOL_ENABLE_NOL_HOST_DISABLE_NOL_FW : Add the radar hit channel to NOL
402  * in host. NOL timer can be configured by user. NOL in FW (for FO) is disabled.
403  */
404 #define USENOL_ENABLE_NOL_HOST_DISABLE_NOL_FW 2
405 
406 /**
407  * enum detector_id - Detector ID values.
408  * @DETECTOR_ID_0: Detector ID 0 (Non Agile).
409  * @DETECTOR_ID_1: Detector ID 1 (Non Agile in 80p80MHz supported devices,
410  *                 Agile detector in true 160MHz supported devices).
411  * @DETECTOR_ID_2: Detector ID 2 (Agile detector in 80p80MHZ supported devices).
412  * @AGILE_DETECTOR_ID_TRUE_160MHZ:  Agile detector ID in true 160MHz devices.
413  * @AGILE_DETECTOR_11BE:  Agile detector ID in true 320 MHz devices.
414  * @AGILE_DETECTOR_ID_80p80: Agile detector ID in 80p80MHz supported devices.
415  * @INVALID_DETECTOR_ID: Invalid detector id.
416  */
417 enum detector_id {
418 	DETECTOR_ID_0,
419 	DETECTOR_ID_1,
420 	DETECTOR_ID_2,
421 	AGILE_DETECTOR_ID_TRUE_160MHZ = DETECTOR_ID_1,
422 	AGILE_DETECTOR_11BE = DETECTOR_ID_1,
423 	AGILE_DETECTOR_ID_80P80 = DETECTOR_ID_2,
424 	INVALID_DETECTOR_ID,
425 };
426 
427 /**
428  * struct dfs_pulseparams - DFS pulse param structure.
429  * @p_time:        Time for start of pulse in usecs.
430  * @p_dur:         Duration of pulse in usecs.
431  * @p_rssi:        RSSI of pulse.
432  * @p_seg_id:      Segment id.
433  * @p_sidx:        Sidx value.
434  * @p_delta_peak:  Delta peak value.
435  * @p_psidx_diff:  The difference in the FFT peak index between the short FFT
436  *                 and the first long FFT.
437  * @p_seq_num:     Sequence number.
438  */
439 struct dfs_pulseparams {
440 	uint64_t p_time;
441 	uint8_t  p_dur;
442 	uint8_t  p_rssi;
443 	uint8_t  p_seg_id;
444 	int16_t  p_sidx;
445 	int8_t   p_delta_peak;
446 	int16_t  p_psidx_diff;
447 	uint32_t p_seq_num;
448 } qdf_packed;
449 
450 /**
451  * struct dfs_pulseline - Pulseline structure.
452  * @pl_elems[]:     array of pulses in delay line.
453  * @pl_firstelem:   Index of the first element.
454  * @pl_lastelem:    Index of the last element.
455  * @pl_numelems:    Number of elements in the delay line.
456  */
457 struct dfs_pulseline {
458 	struct dfs_pulseparams pl_elems[DFS_MAX_PULSE_BUFFER_SIZE];
459 	uint32_t pl_firstelem;
460 	uint32_t pl_lastelem;
461 	uint32_t pl_numelems;
462 } qdf_packed;
463 
464 #define DFS_EVENT_CHECKCHIRP  0x01 /* Whether to check the chirp flag */
465 #define DFS_EVENT_HW_CHIRP    0x02 /* hardware chirp */
466 #define DFS_EVENT_SW_CHIRP    0x04 /* software chirp */
467 /* Whether the event contains valid psidx diff value*/
468 #define DFS_EVENT_VALID_PSIDX_DIFF 0x08
469 
470 /* Use this only if the event has CHECKCHIRP set. */
471 #define DFS_EVENT_ISCHIRP(e) \
472 	((e)->re_flags & (DFS_EVENT_HW_CHIRP | DFS_EVENT_SW_CHIRP))
473 
474 /**
475  * Check if the given event is to be rejected as not possibly
476  * a chirp.  This means:
477  *   (a) it's a hardware or software checked chirp, and
478  *   (b) the HW/SW chirp bits are both 0.
479  */
480 #define DFS_EVENT_NOTCHIRP(e) \
481 	(((e)->re_flags & (DFS_EVENT_CHECKCHIRP)) && (!DFS_EVENT_ISCHIRP((e))))
482 
483 /**
484  * struct dfs_event - DFS event structure.
485  * @re_full_ts:          64-bit full timestamp from interrupt time.
486  * @re_ts:               Original 15 bit recv timestamp.
487  * @re_rssi:             Rssi of radar event.
488  * @re_dur:              Duration of radar pulse.
489  * @re_chanindex:        Channel of event.
490  * @re_flags:            Event flags.
491  * @re_freq:             Centre frequency of event, KHz.
492  * @re_freq_lo:          Lower bounds of frequency, KHz.
493  * @re_freq_hi:          Upper bounds of frequency, KHz.
494  * @re_seg_id:           HT80_80/HT160 use.
495  * @re_sidx:             Seg index.
496  * @re_freq_offset_khz:  Freq offset in KHz
497  * @re_peak_mag:         Peak mag.
498  * @re_total_gain:       Total gain.
499  * @re_mb_gain:          Mb gain.
500  * @re_relpwr_db:        Relpower in db.
501  * @re_delta_diff:       Delta diff.
502  * @re_delta_peak:       Delta peak.
503  * @re_psidx_diff:       Psidx diff.
504  * @re_list:             List of radar events.
505  */
506 struct dfs_event {
507 	uint64_t  re_full_ts;
508 	uint32_t  re_ts;
509 	uint8_t   re_rssi;
510 	uint8_t   re_dur;
511 	uint8_t   re_chanindex;
512 	uint8_t   re_flags;
513 	uint32_t  re_freq;
514 	uint32_t  re_freq_lo;
515 	uint32_t  re_freq_hi;
516 	uint8_t   re_seg_id;
517 	int       re_sidx;
518 	u_int     re_freq_offset_khz;
519 	int       re_peak_mag;
520 	int       re_total_gain;
521 	int       re_mb_gain;
522 	int       re_relpwr_db;
523 	uint8_t   re_delta_diff;
524 	int8_t    re_delta_peak;
525 	int16_t   re_psidx_diff;
526 
527 	STAILQ_ENTRY(dfs_event) re_list;
528 } qdf_packed;
529 
530 #define DFS_AR_MAX_ACK_RADAR_DUR   511
531 #define DFS_AR_MAX_NUM_PEAKS       3
532 #define DFS_AR_ARQ_SIZE            2048 /* 8K AR events for buffer size */
533 #define DFS_AR_ARQ_SEQSIZE         2049 /* Sequence counter wrap for AR */
534 
535 #define DFS_RADARQ_SIZE      512 /* 1K radar events for buffer size */
536 #define DFS_RADARQ_SEQSIZE   513 /* Sequence counter wrap for radar */
537 /* Number of radar channels we keep state for */
538 #define DFS_NUM_RADAR_STATES 64
539 /* Max number radar filters for each type */
540 #define DFS_MAX_NUM_RADAR_FILTERS 10
541 /* Number of different radar types */
542 #define DFS_MAX_RADAR_TYPES  32
543 /* Number of filter index table rows */
544 #define DFS_NUM_FT_IDX_TBL_ROWS  256
545 
546 /* RADAR filter pattern type 1*/
547 #define WLAN_DFS_RF_PATTERN_TYPE_1 1
548 
549 /**
550  * struct dfs_ar_state - DFS AR state structure.
551  * @ar_prevwidth:         Previous width.
552  * @ar_phyerrcount[]:     Phy error count.
553  * @ar_acksum:            Acksum.
554  * @ar_packetthreshold:   Thresh to determine traffic load.
555  * @ar_parthreshold:      Thresh to determine peak.
556  * @ar_radarrssi:         Rssi threshold for AR event.
557  * @ar_prevtimestamp:     Prev time stamp.
558  * @ar_peaklist[]:        Peak list.
559  */
560 struct dfs_ar_state {
561 	uint32_t ar_prevwidth;
562 	uint32_t ar_phyerrcount[DFS_AR_MAX_ACK_RADAR_DUR];
563 	uint32_t ar_acksum;
564 	uint32_t ar_packetthreshold;
565 	uint32_t ar_parthreshold;
566 	uint32_t ar_radarrssi;
567 	uint16_t ar_prevtimestamp;
568 	uint16_t ar_peaklist[DFS_AR_MAX_NUM_PEAKS];
569 };
570 
571 /**
572  * struct dfs_delayelem - Delay Element.
573  * @de_time:       Current "filter" time for start of pulse in usecs.
574  * @de_dur:        Duration of pulse in usecs.
575  * @de_rssi:       Rssi of pulse in dB.
576  * @de_ts:         Time stamp for this delay element.
577  * @de_seg_id:     Segment id for HT80_80/HT160 use.
578  * @de_sidx:       Sidx value.
579  * @de_delta_peak: Delta peak.
580  * @de_psidx_diff: Psidx diff.
581  * @de_seq_num:    Sequence number.
582  */
583 struct dfs_delayelem {
584 	uint32_t de_time;
585 	uint8_t  de_dur;
586 	uint8_t  de_rssi;
587 	uint64_t de_ts;
588 	uint8_t  de_seg_id;
589 	int16_t  de_sidx;
590 	int8_t   de_delta_peak;
591 	int16_t  de_psidx_diff;
592 	uint32_t de_seq_num;
593 } qdf_packed;
594 
595 /**
596  * struct dfs_delayline - DFS Delay Line.
597  * @dl_elems[]:    Array of pulses in delay line.
598  * @dl_last_ts:    Last timestamp the delay line was used (in usecs).
599  * @dl_firstelem:  Index of the first element.
600  * @dl_lastelem:   Index of the last element.
601  * @dl_numelems:   Number of elements in the delay line.
602  * The following is to handle fractional PRI pulses that can cause false
603  * detection.
604  * @dl_seq_num_start: Sequence number of first pulse that was part of
605  *                    threshold match.
606  * @dl_seq_num_stop:  Sequence number of last pulse that was part of threshold
607  *                    match.
608  * The following is required because the first pulse may or may not be in the
609  * delay line but we will find it iin the pulse line using dl_seq_num_second's
610  * diff_ts value.
611  * @dl_seq_num_second: Sequence number of second pulse that was part of
612  *                     threshold match.
613  * @dl_search_pri:     We need final search PRI to identify possible fractional
614  *                     PRI issue.
615  * @dl_min_sidx:       Minimum sidx value of pulses used to match thershold.
616  *                     Used for sidx spread check.
617  * @dl_max_sidx:       Maximum sidx value of pulses used to match thershold.
618  *                     Used for sidx spread check.
619  * @dl_delta_peak_match_count: Number of pulse in the delay line that had valid
620  *                             delta peak value.
621  * @dl_psidx_diff_match_count: Number of pulse in the delay line that had valid
622  *                             psidx diff value.
623  */
624 struct dfs_delayline {
625 	struct dfs_delayelem dl_elems[DFS_MAX_DL_SIZE];
626 	uint64_t dl_last_ts;
627 	uint32_t dl_firstelem;
628 	uint32_t dl_lastelem;
629 	uint32_t dl_numelems;
630 	uint32_t dl_seq_num_start;
631 	uint32_t dl_seq_num_stop;
632 	uint32_t dl_seq_num_second;
633 	uint32_t dl_search_pri;
634 	int16_t  dl_min_sidx;
635 	int8_t   dl_max_sidx;
636 	uint8_t  dl_delta_peak_match_count;
637 	uint8_t  dl_psidx_diff_match_count;
638 } qdf_packed;
639 
640 /**
641  * struct dfs_filter - Dfs filter.
642  * @rf_dl:              Delay line of pulses for this filter.
643  * @rf_numpulses:       Number of pulses in the filter.
644  * @rf_minpri:          Min pri to be considered for this filter.
645  * @rf_maxpri:          Max pri to be considered for this filter.
646  * @rf_threshold:       Match filter output threshold for radar detect.
647  * @rf_filterlen:       Length (in usecs) of the filter.
648  * @rf_patterntype:     Fixed or variable pattern type.
649  * @rf_fixed_pri_radar_pulse: indicates if it is a fixed pri pulse.
650  * @rf_mindur:          Min duration for this radar filter.
651  * @rf_maxdur:          Max duration for this radar filter.
652  * @rf_ignore_pri_window: Ignore pri window.
653  * @rf_pulseid:         Unique ID corresponding to the original filter ID.
654  * To reduce false detection, look at frequency spread. For now we will use
655  * sidx spread. But for HT160 frequency spread will be a better measure.
656  * @rf_sidx_spread:     Maximum SIDX value spread in a matched sequence
657  *                      excluding FCC Bin 5.
658  * @rf_check_delta_peak: Minimum allowed delta_peak value for a pulse to be
659  *                       considetred for this filter's match.
660  */
661 struct dfs_filter {
662 	struct dfs_delayline rf_dl;
663 	uint32_t  rf_numpulses;
664 	uint32_t  rf_minpri;
665 	uint32_t  rf_maxpri;
666 	uint32_t  rf_threshold;
667 	uint32_t  rf_filterlen;
668 	uint32_t  rf_patterntype;
669 	uint32_t  rf_fixed_pri_radar_pulse;
670 	uint32_t  rf_mindur;
671 	uint32_t  rf_maxdur;
672 	uint32_t  rf_ignore_pri_window;
673 	uint32_t  rf_pulseid;
674 	uint16_t  rf_sidx_spread;
675 	int8_t    rf_check_delta_peak;
676 } qdf_packed;
677 
678 /**
679  * struct dfs_filtertype - Structure of DFS Filter type.
680  * @ft_filters[]:      Array of ptrs storing addresses for struct of dfs_filter.
681  * @ft_filterdur:      Duration of pulse which specifies filter type.
682  * @ft_numfilters:     Num filters of this type.
683  * @ft_last_ts:        Last timestamp this filtertype was used (in usecs).
684  * @ft_mindur:         Min pulse duration to be considered for this filter type.
685  * @ft_maxdur:         Max pulse duration to be considered for this filter type.
686  * @ft_rssithresh:     Min rssi to be considered for this filter type.
687  * @ft_numpulses:      Num pulses in each filter of this type.
688  * @ft_patterntype:    Fixed or variable pattern type.
689  * @ft_minpri:         Min pri to be considered for this type.
690  * @ft_rssimargin:     Rssi threshold margin. In Turbo Mode HW reports rssi 3dB
691  *                     lower than in non TURBO mode. This will offset that diff.
692  */
693 struct dfs_filtertype {
694 	struct dfs_filter *ft_filters[DFS_MAX_NUM_RADAR_FILTERS];
695 	uint32_t  ft_filterdur;
696 	uint32_t  ft_numfilters;
697 	uint64_t  ft_last_ts;
698 	uint32_t  ft_mindur;
699 	uint32_t  ft_maxdur;
700 	uint32_t  ft_rssithresh;
701 	uint32_t  ft_numpulses;
702 	uint32_t  ft_patterntype;
703 	uint32_t  ft_minpri;
704 	uint32_t  ft_rssimargin;
705 };
706 
707 /**
708  * struct dfs_channel - Channel structure for dfs component.
709  * @dfs_ch_freq:                Frequency in Mhz.
710  * @dfs_ch_flags:               Channel flags.
711  * @dfs_ch_flagext:             Extended channel flags.
712  * @dfs_ch_ieee:                IEEE channel number.
713  * @dfs_ch_vhtop_ch_freq_seg1:  IEEE Channel Center of primary segment
714  * @dfs_ch_vhtop_ch_freq_seg2:  IEEE Channel Center applicable for 80+80MHz
715  *                              mode of operation.
716  * @dfs_ch_mhz_freq_seg1:       Channel center frequency of primary segment in
717  *                              MHZ.
718  * @dfs_ch_mhz_freq_seg2:       Channel center frequency of secondary segment
719  *                              in MHZ applicable only for 80+80MHZ mode of
720  *                              operation.
721  * @dfs_ch_punc_pattern:        Bitmap representing puncturing patterns.
722  */
723 struct dfs_channel {
724 	uint16_t       dfs_ch_freq;
725 	uint64_t       dfs_ch_flags;
726 	uint16_t       dfs_ch_flagext;
727 	uint8_t        dfs_ch_ieee;
728 	uint8_t        dfs_ch_vhtop_ch_freq_seg1;
729 	uint8_t        dfs_ch_vhtop_ch_freq_seg2;
730 	uint16_t       dfs_ch_mhz_freq_seg1;
731 	uint16_t       dfs_ch_mhz_freq_seg2;
732 #ifdef WLAN_FEATURE_11BE
733 	/* If the bitmap is all 0 then nothing is punctured. If any bit is 1
734 	 * then corresponding 20MHz sub-channel is puntured. For example, for
735 	 * channel 100 (BW 240MHz), it will treated as a 320MHz channel and the
736 	 * bit-map will be b1111_0000_0000_0000 (where the most significant bit
737 	 * indicates the rightmost sub20channel and the least significant bit
738 	 * indicates the leftmost sub20channel).
739 	 */
740 	uint16_t       dfs_ch_punc_pattern;
741 #endif
742 };
743 
744 /**
745  * struct dfs_state - DFS state.
746  * @rs_chan:            Channel info.
747  * @rs_chanindex:       Channel index in radar structure.
748  * @rs_numradarevents:  Number of radar events.
749  * @rs_param:           Phy param.
750  */
751 struct dfs_state {
752 	struct dfs_channel rs_chan;
753 	uint8_t  rs_chanindex;
754 	uint32_t rs_numradarevents;
755 	struct wlan_dfs_phyerr_param rs_param;
756 };
757 
758 #define DFS_NOL_TIMEOUT_S  (30*60)    /* 30 minutes in seconds */
759 #define DFS_NOL_TIMEOUT_MS (DFS_NOL_TIMEOUT_S * 1000)
760 #define DFS_NOL_TIMEOUT_US (DFS_NOL_TIMEOUT_MS * 1000)
761 
762 /**
763  * struct dfs_nolelem - DFS NOL element.
764  * @nol_dfs           Back pointer to dfs object.
765  * @nol_freq:         Centre frequency.
766  * @nol_chwidth:      Event width (MHz).
767  * @nol_start_us:     NOL start time in us.
768  * @nol_timeout_ms:   NOL timeout value in msec.
769  * @nol_timer:        Per element NOL timer.
770  * @nol_next:         Next element pointer.
771  */
772 struct dfs_nolelem {
773 	TAILQ_ENTRY(dfs_nolelem) nolelem_list;
774 	struct wlan_dfs *nol_dfs;
775 	uint32_t       nol_freq;
776 	uint32_t       nol_chwidth;
777 	uint64_t       nol_start_us;
778 	uint32_t       nol_timeout_ms;
779 	qdf_hrtimer_data_t    nol_timer;
780 	struct dfs_nolelem *nol_next;
781 };
782 
783 
784 /**
785  * struct dfs_info - DFS Info.
786  * @rn_ftindex:            Number of different types of radars.
787  * @rn_lastfull_ts:        Last 64 bit timstamp from recv interrupt.
788  * @rn_last_ts:            last 15 bit ts from recv descriptor.
789  * @rn_last_unique_ts:     last unique 32 bit ts from recv descriptor.
790  * @rn_ts_prefix:          Prefix to prepend to 15 bit recv ts.
791  * @rn_numbin5radars:      Number of bin5 radar pulses to search for.
792  * @rn_fastdivGCval:       Value of fast diversity gc limit from init file.
793  * @rn_minrssithresh:      Min rssi for all radar types.
794  * @rn_maxpulsedur:        Max pulse width in TSF ticks.
795  * @dfs_ext_chan_busy:     Ext chan busy.
796  * @ext_chan_busy_ts:      Ext chan busy time.
797  * @dfs_bin5_chirp_ts:     Ext bin5 chrip time.
798  * @dfs_last_bin5_dur:     Last bin5 during.
799  */
800 struct dfs_info {
801 	uint32_t  rn_ftindex;
802 	uint64_t  rn_lastfull_ts;
803 	uint16_t  rn_last_ts;
804 	uint32_t  rn_last_unique_ts;
805 	uint64_t  rn_ts_prefix;
806 	uint32_t  rn_numbin5radars;
807 	uint32_t  rn_fastdivGCval;
808 	int32_t   rn_minrssithresh;
809 	uint32_t  rn_maxpulsedur;
810 	uint8_t   dfs_ext_chan_busy;
811 	uint64_t  ext_chan_busy_ts;
812 	uint64_t  dfs_bin5_chirp_ts;
813 	uint8_t   dfs_last_bin5_dur;
814 } qdf_packed;
815 
816 /**
817  * struct dfs_bin5elem - BIN5 elements.
818  * @be_ts:   Timestamp for the bin5 element.
819  * @be_rssi: Rssi for the bin5 element.
820  * @be_dur:  Duration of bin5 element.
821  */
822 struct dfs_bin5elem {
823 	uint64_t  be_ts;
824 	uint32_t  be_rssi;
825 	uint32_t  be_dur;
826 };
827 
828 /**
829  * struct dfs_bin5radars - BIN5 radars.
830  * @br_elems[]:    List of bin5 elems that fall within the time window.
831  * @br_firstelem:  Index of the first element.
832  * @br_lastelem:   Index of the last element.
833  * @br_numelems:   Number of elements in the delay line.
834  * @br_pulse:      Original info about bin5 pulse.
835  */
836 struct dfs_bin5radars {
837 	struct dfs_bin5elem br_elems[DFS_MAX_B5_SIZE];
838 	uint32_t  br_firstelem;
839 	uint32_t  br_lastelem;
840 	uint32_t  br_numelems;
841 	struct dfs_bin5pulse br_pulse;
842 };
843 
844 /**
845  * struct dfs_stats - DFS stats.
846  * @num_radar_detects:    Total num. of radar detects.
847  * @num_seg_two_radar_detects: Total num. of radar detected in secondary segment
848  * @total_phy_errors:     Total PHY errors.
849  * @owl_phy_errors:       OWL PHY errors.
850  * @pri_phy_errors:       Primary channel phy errors.
851  * @ext_phy_errors:       Extension channel phy errors.
852  * @dc_phy_errors:        DC PHY errors.
853  * @early_ext_phy_errors: Extension channel early radar found error.
854  * @bwinfo_errors:        Bogus bandwidth info received in descriptor.
855  * @datalen_discards:     data length at least three bytes of payload.
856  * @rssi_discards:        RSSI is not accurate.
857  * @last_reset_tstamp:    Last reset timestamp.
858  */
859 struct dfs_stats {
860 	uint32_t       num_radar_detects;
861 	uint32_t  num_seg_two_radar_detects;
862 	uint32_t  total_phy_errors;
863 	uint32_t  owl_phy_errors;
864 	uint32_t  pri_phy_errors;
865 	uint32_t  ext_phy_errors;
866 	uint32_t  dc_phy_errors;
867 	uint32_t  early_ext_phy_errors;
868 	uint32_t  bwinfo_errors;
869 	uint32_t  datalen_discards;
870 	uint32_t  rssi_discards;
871 	uint64_t  last_reset_tstamp;
872 };
873 
874 #define DFS_EVENT_LOG_SIZE      256
875 
876 /**
877  * struct dfs_event_log - DFS event log.
878  * @ts:               64-bit full timestamp from interrupt time.
879  * @diff_ts:          Diff timestamp.
880  * @rssi:             Rssi of radar event.
881  * @dur:              Duration of radar pulse.
882  * @is_chirp:         Chirp flag.
883  * @seg_id:           HT80_80/HT160 use.
884  * @sidx:             Seg index.
885  * @freq_offset_khz:  Freq offset in KHz
886  * @peak_mag:         Peak mag.
887  * @total_gain:       Total gain.
888  * @mb_gain:          Mb gain.
889  * @relpwr_db:        Relpower in db.
890  * @delta_diff:       Delta diff.
891  * @delta_peak:       Delta peak.
892  * @psidx_diff:       Psidx diff.
893  */
894 
895 struct dfs_event_log {
896 	uint64_t  ts;
897 	uint32_t  diff_ts;
898 	uint8_t   rssi;
899 	uint8_t   dur;
900 	int       is_chirp;
901 	uint8_t   seg_id;
902 	int       sidx;
903 	u_int     freq_offset_khz;
904 	int       peak_mag;
905 	int       total_gain;
906 	int       mb_gain;
907 	int       relpwr_db;
908 	uint8_t   delta_diff;
909 	int8_t    delta_peak;
910 	int16_t   psidx_diff;
911 };
912 
913 #define WLAN_DFS_WEATHER_CHANNEL_WAIT_MIN 10 /*10 minutes*/
914 #define WLAN_DFS_WEATHER_CHANNEL_WAIT_S (WLAN_DFS_WEATHER_CHANNEL_WAIT_MIN * 60)
915 #define WLAN_DFS_WEATHER_CHANNEL_WAIT_MS  \
916 	((WLAN_DFS_WEATHER_CHANNEL_WAIT_S) * 1000) /*in MS*/
917 
918 #define WLAN_DFS_WAIT_POLL_PERIOD 2  /* 2 seconds */
919 #define WLAN_DFS_WAIT_POLL_PERIOD_MS  \
920 	((WLAN_DFS_WAIT_POLL_PERIOD) * 1000)  /*in MS*/
921 
922 #define DFS_DEBUG_TIMEOUT_S     30 /* debug timeout is 30 seconds */
923 #define DFS_DEBUG_TIMEOUT_MS    (DFS_DEBUG_TIMEOUT_S * 1000)
924 
925 #define RSSI_POSSIBLY_FALSE              50
926 #define SEARCH_FFT_REPORT_PEAK_MAG_THRSH 40
927 
928 #define MIN_DFS_SUBCHAN_BW 20 /* Minimum bandwidth of each subchannel. */
929 
930 #define FREQ_OFFSET_BOUNDARY_FOR_80MHZ 40
931 
932 #define FREQ_OFFSET_BOUNDARY_FOR_160MHZ 80
933 
934 /**
935  * struct dfs_mode_switch_defer_params - Parameters storing DFS information
936  * before defer, as part of HW mode switch.
937  *
938  * @radar_params: Deferred radar parameters.
939  * @is_cac_completed: Boolean representing CAC completion event.
940  * @is_radar_detected: Boolean representing radar event.
941  */
942 struct dfs_mode_switch_defer_params {
943 	struct radar_found_info *radar_params;
944 	bool is_cac_completed;
945 	bool is_radar_detected;
946 };
947 
948 #ifdef QCA_SUPPORT_AGILE_DFS
949 #define DFS_PSOC_NO_IDX 0xFF
950 /**
951  * enum dfs_agile_sm_state - DFS AGILE SM states.
952  * @DFS_AGILE_S_INIT:     Default state or the start state of the Agile SM.
953  * @DFS_AGILE_S_RUNNING:  Agile Engine is being run.
954  * @DFS_AGILE_S_COMPLETE: The Agile Engine's minimum run is complete.
955 			  However, it is still running. Used only for RCAC
956 			  as RCAC needs to run continuously (uninterrupted)
957 			  until the channel change.
958  * @DFS_AGILE_S_MAX:      Max (invalid) state.
959  */
960 enum dfs_agile_sm_state {
961 	DFS_AGILE_S_INIT,
962 	DFS_AGILE_S_RUNNING,
963 	DFS_AGILE_S_COMPLETE,
964 	DFS_AGILE_S_MAX,
965 };
966 
967 /**
968  * struct dfs_rcac_params - DFS Rolling CAC channel parameters.
969  * @rcac_pri_freq: Rolling CAC channel's primary frequency.
970  * @rcac_ch_params: Rolling CAC channel parameters.
971  */
972 struct dfs_rcac_params {
973 	qdf_freq_t rcac_pri_freq;
974 	struct ch_params rcac_ch_params;
975 };
976 #endif
977 
978 /**
979  * struct wlan_dfs -                 The main dfs structure.
980  * @dfs_debug_mask:                  Current debug bitmask.
981  * @dfs_curchan_radindex:            Current channel radar index.
982  * @dfs_extchan_radindex:            Extension channel radar index.
983  * @dfsdomain:                       Current DFS domain.
984  * @dfs_proc_phyerr:                 Flags for Phy Errs to process.
985  * @dfs_eventq:                      Q of free dfs event objects.
986  * @dfs_eventqlock:                  Lock for free dfs event list.
987  * @dfs_radarq:                      Q of radar events.
988  * @dfs_radarqlock:                  Lock for dfs q.
989  * @dfs_arq:                         Q of AR events.
990  * @dfs_arqlock:                     Lock for AR q.
991  * @dfs_ar_state:                    AR state.
992  * @dfs_radar[]:                     Per-Channel Radar detector state.
993  * @dfs_radarf[]:                    One filter for each radar pulse type.
994  * @dfs_rinfo:                       State vars for radar processing.
995  * @dfs_b5radars:                    Array of bin5 radar events.
996  * @dfs_ftindextable:                Map of radar durs to filter types.
997  * @dfs_nol:                         Non occupancy list for radar.
998  * @dfs_nol_count:                   How many items?
999  * @dfs_defaultparams:               Default phy params per radar state.
1000  * @wlan_dfs_stats:                  DFS related stats.
1001  * @pulses:                          Pulse history.
1002  * @events:                          Events structure.
1003  * @wlan_radar_tasksched:            Radar task is scheduled.
1004  * @wlan_dfswait:                    Waiting on channel for radar detect.
1005  * @wlan_dfstest:                    Test timer in progress.
1006  * @dfs_caps:                        Object of wlan_dfs_caps structure.
1007  * @wlan_dfstest_ieeechan:           IEEE chan num to return to after a dfs mute
1008  *                                   test.
1009  * @wlan_dfs_cac_time:               CAC period.
1010  * @wlan_dfstesttime:                Time to stay off chan during dfs test.
1011  * @wlan_dfstesttimer:               Dfs mute test timer.
1012  * @dfs_bangradar_type:              Radar simulation type.
1013  * @is_radar_found_on_secondary_seg: Radar on second segment.
1014  * @is_radar_during_precac:          Radar found during precac.
1015  * @dfs_precac_lock:                 Lock to protect precac lists.
1016  * @dfs_precac_secondary_freq_mhz:   Second segment freq in MHZ for precac.
1017  *                                   Applicable to only legacy chips.
1018  * @dfs_precac_primary_freq_mhz:     PreCAC Primary freq in MHZ applicable only
1019  *                                   to legacy chips.
1020  * @dfs_defer_precac_channel_change: Defer precac channel change.
1021  * @dfs_precac_inter_chan_freq:      Intermediate non-DFS freq used while
1022  *                                   doing precac.
1023  * @dfs_autoswitch_chan:             Desired channel of dfs_channel structure
1024  *                                   which will be prioritized for preCAC.
1025  * @dfs_autoswitch_des_mode:         Desired PHY mode which has to be used
1026  *                                   after precac.
1027  * @wlan_dfs_task_timer:             Dfs wait timer.
1028  * @dur_multiplier:                  Duration multiplier.
1029  * @wlan_dfs_isdfsregdomain:         True when AP is in DFS domain
1030  * @wlan_dfs_false_rssi_thres:       False RSSI Threshold.
1031  * @wlan_dfs_peak_mag:               Peak mag.
1032  * @radar_log[]:                     Radar log.
1033  * @dfs_event_log_count:             Event log count.
1034  * @dfs_event_log_on:                Event log on.
1035  * @dfs_phyerr_count:                Same as number of PHY radar interrupts.
1036  * @dfs_phyerr_reject_count:         When TLV is supported, # of radar events
1037  *                                   ignored after TLV is parsed.
1038  * @dfs_phyerr_queued_count:         Number of radar events queued for matching
1039  *                                   the filters.
1040  * @dfs_phyerr_freq_min:             Phyerr min freq.
1041  * @dfs_phyerr_freq_max:             Phyerr max freq.
1042  * @dfs_phyerr_w53_counter:          Phyerr w53 counter.
1043  * @dfs_pri_multiplier:              Allow pulse if they are within multiple of
1044  *                                   PRI for the radar type.
1045  * @wlan_dfs_nol_timeout:            NOL timeout.
1046  * @update_nol:                      Update NOL.
1047  * @dfs_seq_num:                     Sequence number.
1048  * @dfs_nol_free_list:               NOL free list.
1049  * @dfs_nol_elem_free_work:          The work queue to free an NOL element.
1050  * @dfs_cac_timer:                   CAC timer.
1051  * @dfs_cac_valid_timer:             Ignore CAC when this timer is running.
1052  * @dfs_cac_timeout_override:        Overridden cac timeout.
1053  * @dfs_enable:                      DFS Enable.
1054  * @dfs_cac_timer_running:           DFS CAC timer running.
1055  * @dfs_ignore_dfs:                  Ignore DFS.
1056  * @dfs_ignore_cac:                  Ignore CAC.
1057  * @dfs_cac_valid:                   DFS CAC valid.
1058  * @dfs_cac_valid_time:              Time for which CAC will be valid and will
1059  *                                   not be re-done.
1060  * @dfs_precac_timeout_override:     Overridden precac timeout.
1061  * @dfs_precac_list:                 PreCAC list (contains individual trees).
1062  * @dfs_precac_chwidth:              PreCAC channel width enum.
1063  * @dfs_curchan:                     DFS current channel.
1064  * @dfs_prevchan:                    DFS previous channel.
1065  * @dfs_cac_started_chan:            CAC started channel.
1066  * @dfs_pdev_obj:                    DFS pdev object.
1067  * @dfs_is_offload_enabled:          Set if DFS offload enabled.
1068  * @dfs_is_bangradar_320_supported:  Set if DFS 320MHZ enabled.
1069  * @dfs_is_radar_found_chan_freq_eq_center_freq:
1070  *                                   Set if chan_freq parameter of the radar
1071  *                                   found wmi event indicates channel center.
1072  * @dfs_agile_precac_freq_mhz:       Freq in MHZ configured on Agile DFS engine.
1073  * @dfs_use_nol:                     Use the NOL when radar found(default: TRUE)
1074  * @dfs_nol_lock:                    Lock to protect nol list.
1075  * @tx_leakage_threshold:            Tx leakage threshold for dfs.
1076  * @dfs_use_nol_subchannel_marking:  Use subchannel marking logic to add only
1077  *                                   radar affected subchannel instead of all
1078  *                                   bonding channels.
1079  * @dfs_host_wait_timer:             The timer that is started from host after
1080  *                                   sending the average radar parameters.
1081  *                                   Before this timeout host expects its dfs
1082  *                                   status from fw.
1083  * @dfs_average_pri:                 Average pri value of the received radar
1084  *                                   pulses.
1085  * @dfs_average_duration:            Average duration of the received radar
1086  *                                   pulses.
1087  * @dfs_average_sidx:                Average sidx of the received radar pulses.
1088  * @dfs_is_host_wait_running:        Indicates if host dfs status wait timer is
1089  *                                   running.
1090  * @dfs_average_params_sent:         Indicates if host has sent the average
1091  *                                   radar parameters.
1092  * @dfs_no_res_from_fw:              Indicates no response from fw.
1093  * @dfs_spoof_check_failed:          Indicates if the spoof check has failed.
1094  * @dfs_spoof_test_done:             Indicates if the sppof test is done.
1095  * @dfs_status_timeout_override:     Used to change the timeout value of
1096  *                                   dfs_host_wait_timer.
1097  * @dfs_is_stadfs_enabled:           Is STADFS enabled.
1098  * @dfs_min_sidx:                    Minimum sidx of the received radar pulses.
1099  * @dfs_max_sidx:                    Maximum sidx of the received radar pulses.
1100  * @dfs_seg_id:                      Segment ID of the radar hit channel.
1101  * @dfs_is_chirp:                    Radar Chirp in pulse present or not.
1102  * @dfs_bw_reduced:                  DFS bandwidth reduced channel bit.
1103  * @dfs_freq_offset:                 Frequency offset where radar was found.
1104  * @dfs_cac_aborted:                 DFS cac is aborted.
1105  * @dfs_disable_radar_marking:       To mark or unmark NOL chan as radar hit.
1106  * @dfs_data_struct_lock:            DFS data structure lock. This is to protect
1107  *                                   all the filtering data structures. For
1108  *                                   example: dfs_bin5radars, dfs_filtertype,
1109  *                                   etc.
1110  * @dfs_nol_ie_bandwidth:            Minimum Bandwidth of subchannels that
1111  *                                   are added to NOL.
1112  * @dfs_nol_ie_startfreq:            The centre frequency of the starting
1113  *                                   subchannel in the current channel list
1114  *                                   to be sent in NOL IE with RCSA.
1115  * @dfs_nol_ie_bitmap:               The bitmap of radar affected subchannels
1116  *                                   in the current channel list
1117  *                                   to be sent in NOL IE with RCSA.
1118  * @dfs_is_rcsa_ie_sent:             To send or to not send RCSA IE.
1119  * @dfs_is_nol_ie_sent:              To send or to not send NOL IE.
1120  * @dfs_agile_precac_ucfg:           User configuration for agile preCAC.
1121  * @dfs_bw_expand_target_freq:       User configured Channel frequency for
1122  *                                   bandwidth expansion feature.
1123  * @dfs_bw_expand_des_mode:          User configured Channel Phymode for
1124  *                                   bandwidth expansion feature.
1125  * @dfs_use_bw_expand:               User configured value for enabling or
1126  *                                   disabling BW Expansion feature.
1127  * @dfs_use_puncture:                User configured value for enabling or
1128  *                                   disabling DFS puncturing feature.
1129  * @dfs_agile_rcac_ucfg:             User configuration for Rolling CAC.
1130  * @dfs_fw_adfs_support_320:         Target Agile DFS support for 320 BW.
1131  * @dfs_fw_adfs_support_non_160:     Target Agile DFS support for non-160 BWs.
1132  * @dfs_fw_adfs_support_160:         Target Agile DFS support for 160 BW.
1133  * @dfs_allow_hw_pulses:             Allow/Block HW pulses. When synthetic
1134  *                                   pulses are injected, the HW pulses should
1135  *                                   be blocked and this variable should be
1136  *                                   false so that HW pulses and synthetic
1137  *                                   pulses do not get mixed up.
1138  *                                   defer timer running.
1139  * @dfs_defer_params:                DFS deferred event parameters (allocated
1140  *                                   only for the duration of defer alone).
1141  * @dfs_agile_detector_id:           Agile detector ID for the DFS object.
1142  * @dfs_agile_rcac_freq_ucfg:        User programmed Rolling CAC frequency in
1143  *                                   MHZ.
1144  * @dfs_rcac_param:                  Primary frequency and Channel params of
1145  *                                   the selected RCAC channel.
1146  * @dfs_chan_postnol_freq:           Frequency the AP switches to, post NOL.
1147  * @dfs_chan_postnol_mode:           Phymode the AP switches to, post NOL.
1148  * @dfs_chan_postnol_cfreq2:         Secondary center frequency the AP
1149  *                                   switches to, post NOL.
1150  * @dfs_channel_state_array:         Stores the channel states like CAC STARTED,
1151  *                                   CAC REQUIRED, CAC COMPLETED, NOL,
1152  *                                   PRECAC STARTED, PRECAC COMPLETED etc. of
1153  *                                   all the DFS channels.
1154  */
1155 struct wlan_dfs {
1156 	uint32_t       dfs_debug_mask;
1157 #ifdef WLAN_DFS_PARTIAL_OFFLOAD
1158 	int16_t        dfs_curchan_radindex;
1159 	int16_t        dfs_extchan_radindex;
1160 	struct dfs_ar_state   dfs_ar_state;
1161 	struct dfs_state      dfs_radar[DFS_NUM_RADAR_STATES];
1162 	struct dfs_filtertype *dfs_radarf[DFS_MAX_RADAR_TYPES];
1163 	struct dfs_info       dfs_rinfo;
1164 	struct dfs_bin5radars *dfs_b5radars;
1165 	int8_t                **dfs_ftindextable;
1166 	struct wlan_dfs_phyerr_param dfs_defaultparams;
1167 	struct dfs_event      *events;
1168 	struct wlan_dfs_caps dfs_caps;
1169 	qdf_timer_t    wlan_dfs_task_timer;
1170 	int            dur_multiplier;
1171 	uint16_t       wlan_dfs_isdfsregdomain;
1172 	int            dfs_phyerr_w53_counter;
1173 	uint32_t       dfs_seq_num;
1174 	int32_t        dfs_min_sidx;
1175 	int32_t        dfs_max_sidx;
1176 	qdf_spinlock_t dfs_data_struct_lock;
1177 	uint16_t       dfs_lowest_pri_limit;
1178 
1179 	STAILQ_HEAD(, dfs_event) dfs_eventq;
1180 	STAILQ_HEAD(, dfs_event) dfs_radarq;
1181 	STAILQ_HEAD(, dfs_event) dfs_arq;
1182 
1183 #ifdef HOST_DFS_SPOOF_TEST
1184 	qdf_timer_t    dfs_host_wait_timer;
1185 	uint32_t       dfs_average_pri;
1186 	uint32_t       dfs_average_duration;
1187 	uint32_t       dfs_average_sidx;
1188 	uint8_t        dfs_is_host_wait_running:1,
1189 				   dfs_average_params_sent:1,
1190 				   dfs_no_res_from_fw:1,
1191 				   dfs_spoof_check_failed:1;
1192 	struct dfs_channel dfs_radar_found_chan;
1193 	int            dfs_status_timeout_override;
1194 #endif
1195 #ifdef WLAN_DFS_SYNTHETIC_RADAR
1196 	bool           dfs_allow_hw_pulses;
1197 #endif
1198 #endif /* WLAN_DFS_PARTIAL_OFFLOAD */
1199 	uint32_t       dfsdomain;
1200 	uint32_t       dfs_proc_phyerr;
1201 
1202 	qdf_spinlock_t dfs_eventqlock;
1203 
1204 	qdf_spinlock_t dfs_radarqlock;
1205 
1206 	qdf_spinlock_t dfs_arqlock;
1207 	struct dfs_nolelem    *dfs_nol;
1208 	int                   dfs_nol_count;
1209 	struct dfs_stats      wlan_dfs_stats;
1210 	struct dfs_pulseline  *pulses;
1211 	uint32_t       wlan_radar_tasksched:1,
1212 		       wlan_dfswait:1,
1213 		       wlan_dfstest:1;
1214 	uint8_t        wlan_dfstest_ieeechan;
1215 	uint32_t       wlan_dfs_cac_time;
1216 	uint32_t       wlan_dfstesttime;
1217 	qdf_timer_t    wlan_dfstesttimer;
1218 	enum dfs_bangradar_types dfs_bangradar_type;
1219 	bool           is_radar_found_on_secondary_seg;
1220 	bool           is_radar_during_precac;
1221 	qdf_spinlock_t dfs_precac_lock;
1222 #ifdef CONFIG_CHAN_FREQ_API
1223 	uint16_t        dfs_precac_secondary_freq_mhz;
1224 	uint16_t        dfs_precac_primary_freq_mhz;
1225 #endif
1226 	uint8_t        dfs_defer_precac_channel_change;
1227 #ifdef WLAN_DFS_PRECAC_AUTO_CHAN_SUPPORT
1228 	enum wlan_phymode dfs_autoswitch_des_mode;
1229 #endif
1230 #ifdef WLAN_DFS_PRECAC_AUTO_CHAN_SUPPORT
1231 #ifdef CONFIG_CHAN_FREQ_API
1232 	struct dfs_channel *dfs_autoswitch_chan;
1233 	uint16_t       dfs_precac_inter_chan_freq;
1234 #endif
1235 #endif
1236 	int            wlan_dfs_false_rssi_thres;
1237 	int            wlan_dfs_peak_mag;
1238 	struct dfs_event_log radar_log[DFS_EVENT_LOG_SIZE];
1239 	int            dfs_event_log_count;
1240 	int            dfs_event_log_on;
1241 	int            dfs_phyerr_count;
1242 	int            dfs_phyerr_reject_count;
1243 	int            dfs_phyerr_queued_count;
1244 	int            dfs_phyerr_freq_min;
1245 	int            dfs_phyerr_freq_max;
1246 	int            dfs_pri_multiplier;
1247 	int            wlan_dfs_nol_timeout;
1248 	bool           update_nol;
1249 
1250 	TAILQ_HEAD(, dfs_nolelem) dfs_nol_free_list;
1251 	qdf_work_t     dfs_nol_elem_free_work;
1252 
1253 	qdf_hrtimer_data_t    dfs_cac_timer;
1254 	qdf_timer_t    dfs_cac_valid_timer;
1255 	int            dfs_cac_timeout_override;
1256 	uint8_t        dfs_enable:1,
1257 				   dfs_cac_timer_running:1,
1258 				   dfs_ignore_dfs:1,
1259 				   dfs_ignore_cac:1,
1260 				   dfs_cac_valid:1;
1261 	uint32_t       dfs_cac_valid_time;
1262 	int            dfs_precac_timeout_override;
1263 #if defined(WLAN_DFS_FULL_OFFLOAD) && defined(QCA_DFS_NOL_OFFLOAD)
1264 	uint8_t        dfs_disable_radar_marking;
1265 #endif
1266 	TAILQ_HEAD(, dfs_precac_entry) dfs_precac_list;
1267 	enum phy_ch_width dfs_precac_chwidth;
1268 
1269 	struct dfs_channel *dfs_curchan;
1270 	struct dfs_channel *dfs_prevchan;
1271 	struct dfs_channel dfs_cac_started_chan;
1272 	struct wlan_objmgr_pdev *dfs_pdev_obj;
1273 	struct dfs_soc_priv_obj *dfs_soc_obj;
1274 #if defined(QCA_SUPPORT_AGILE_DFS) || defined(ATH_SUPPORT_ZERO_CAC_DFS)
1275 	uint8_t dfs_psoc_idx;
1276 #endif
1277 #ifdef CONFIG_CHAN_FREQ_API
1278 	uint16_t       dfs_agile_precac_freq_mhz;
1279 #endif
1280 	bool           dfs_is_offload_enabled;
1281 	bool           dfs_is_bangradar_320_supported;
1282 	bool           dfs_is_radar_found_chan_freq_eq_center_freq;
1283 	int            dfs_use_nol;
1284 	qdf_spinlock_t dfs_nol_lock;
1285 	uint16_t tx_leakage_threshold;
1286 	bool dfs_use_nol_subchannel_marking;
1287 	uint8_t        dfs_spoof_test_done:1;
1288 	bool           dfs_is_stadfs_enabled;
1289 	uint8_t        dfs_seg_id;
1290 	uint8_t        dfs_is_chirp;
1291 	bool           dfs_bw_reduced;
1292 	int32_t        dfs_freq_offset;
1293 	bool           dfs_cac_aborted;
1294 #if defined(QCA_DFS_RCSA_SUPPORT)
1295 	uint8_t        dfs_nol_ie_bandwidth;
1296 	uint16_t       dfs_nol_ie_startfreq;
1297 	uint8_t        dfs_nol_ie_bitmap;
1298 	bool           dfs_is_rcsa_ie_sent;
1299 	bool           dfs_is_nol_ie_sent;
1300 #endif
1301 #if defined(QCA_DFS_BW_EXPAND)
1302 	qdf_freq_t      dfs_bw_expand_target_freq;
1303 	enum wlan_phymode dfs_bw_expand_des_mode;
1304 	bool           dfs_use_bw_expand;
1305 #endif
1306 	bool           dfs_use_puncture;
1307 	uint8_t        dfs_agile_precac_ucfg:1,
1308 #if defined(QCA_SUPPORT_ADFS_RCAC)
1309 		       dfs_agile_rcac_ucfg:1,
1310 #endif
1311 #ifdef WLAN_FEATURE_11BE
1312 		       dfs_fw_adfs_support_320:1,
1313 #endif
1314 		       dfs_fw_adfs_support_non_160:1,
1315 		       dfs_fw_adfs_support_160:1;
1316 	struct dfs_mode_switch_defer_params dfs_defer_params;
1317 	uint8_t        dfs_agile_detector_id;
1318 #if defined(QCA_SUPPORT_ADFS_RCAC)
1319 	uint16_t       dfs_agile_rcac_freq_ucfg;
1320 	struct dfs_rcac_params dfs_rcac_param;
1321 #endif
1322 #if defined(QCA_SUPPORT_DFS_CHAN_POSTNOL)
1323 	qdf_freq_t     dfs_chan_postnol_freq;
1324 	enum phy_ch_width dfs_chan_postnol_mode;
1325 	qdf_freq_t     dfs_chan_postnol_cfreq2;
1326 #endif
1327 #if defined(WLAN_DISP_CHAN_INFO)
1328 	enum channel_dfs_state dfs_channel_state_array[NUM_DFS_CHANS];
1329 #endif /* WLAN_DISP_CHAN_INFO */
1330 #ifdef QCA_SUPPORT_AGILE_DFS
1331 #endif
1332 };
1333 
1334 #if defined(QCA_SUPPORT_AGILE_DFS) || defined(ATH_SUPPORT_ZERO_CAC_DFS)
1335 /**
1336  * struct wlan_dfs_priv - dfs private struct with agile capability info
1337  * @wlan_dfs: pointer to wlan_dfs object.
1338  * @agile_precac_active: agile precac active information for wlan_dfs_priv obj
1339  */
1340 struct wlan_dfs_priv {
1341 	struct wlan_dfs *dfs;
1342 	bool agile_precac_active;
1343 };
1344 #endif
1345 
1346 /**
1347  * struct dfs_soc_priv_obj - dfs private data
1348  * @psoc: pointer to PSOC object information
1349  * @pdev: pointer to PDEV object information
1350  * @dfs_is_phyerr_filter_offload: For some chip like Rome indicates too many
1351  *                                phyerr packets in a short time, which causes
1352  *                                OS hang. If this field is configured as true,
1353  *                                FW will do the pre-check, filter out some
1354  *                                kinds of invalid phyerrors and indicate
1355  *                                radar detection related information to host.
1356  * @dfs_priv: array of dfs private structs with agile capability info
1357  * @num_dfs_privs: array size of dfs private structs for given psoc.
1358  * @cur_dfs_index: index of the current dfs object using the Agile Engine.
1359  *                 It is used to index struct wlan_dfs_priv dfs_priv[] array.
1360  * @dfs_precac_timer: agile precac timer
1361  * @dfs_precac_timer_running: precac timer running flag
1362  * @ocac_status: Off channel CAC complete status
1363  * @dfs_nol_ctx: dfs NOL data for all radios.
1364  * @dfs_rcac_timer: Agile RCAC (Rolling CAC) timer.
1365  * @dfs_agile_sm_hdl: The handle for the state machine that drives Agile
1366  *                    Engine.
1367  * @dfs_agile_sm_cur_state: Current state of the Agile State Machine.
1368  * @dfs_rcac_sm_lock: DFS Rolling CAC state machine lock.
1369  */
1370 struct dfs_soc_priv_obj {
1371 	struct wlan_objmgr_psoc *psoc;
1372 	struct wlan_objmgr_pdev *pdev;
1373 	bool dfs_is_phyerr_filter_offload;
1374 #if defined(QCA_SUPPORT_AGILE_DFS) || defined(ATH_SUPPORT_ZERO_CAC_DFS)
1375 	struct wlan_dfs_priv dfs_priv[WLAN_UMAC_MAX_PDEVS];
1376 	uint8_t num_dfs_privs;
1377 	uint8_t cur_agile_dfs_index;
1378 	qdf_hrtimer_data_t    dfs_precac_timer;
1379 	uint8_t dfs_precac_timer_running;
1380 	bool precac_state_started;
1381 	bool ocac_status;
1382 #endif
1383 	struct dfsreq_nolinfo *dfs_psoc_nolinfo;
1384 #ifdef QCA_SUPPORT_ADFS_RCAC
1385 	qdf_hrtimer_data_t dfs_rcac_timer;
1386 #endif
1387 #ifdef QCA_SUPPORT_AGILE_DFS
1388 	struct wlan_sm *dfs_agile_sm_hdl;
1389 	enum dfs_agile_sm_state dfs_agile_sm_cur_state;
1390 	qdf_spinlock_t dfs_agile_sm_lock;
1391 #endif
1392 };
1393 
1394 /**
1395  * enum DFS debug - This should match the table from if_ath.c.
1396  * @WLAN_DEBUG_DFS:             Minimal DFS debug.
1397  * @WLAN_DEBUG_DFS1:            Normal DFS debug.
1398  * @WLAN_DEBUG_DFS2:            Maximal DFS debug.
1399  * @WLAN_DEBUG_DFS3:            Matched filterID display.
1400  * @WLAN_DEBUG_DFS_PHYERR:      Phy error parsing.
1401  * @WLAN_DEBUG_DFS_NOL:         NOL related entries.
1402  * @WLAN_DEBUG_DFS_PHYERR_SUM:  PHY error summary.
1403  * @WLAN_DEBUG_DFS_PHYERR_PKT:  PHY error payload.
1404  * @WLAN_DEBUG_DFS_BIN5:        BIN5 checks.
1405  * @WLAN_DEBUG_DFS_BIN5_FFT:    BIN5 FFT check.
1406  * @WLAN_DEBUG_DFS_BIN5_PULSE:  BIN5 pulse check.
1407  * @WLAN_DEBUG_DFS_FALSE_DET:   False detection debug related prints.
1408  * @WLAN_DEBUG_DFS_FALSE_DET2:  Second level check to confirm poisitive
1409  *                              detection.
1410  * @WLAN_DEBUG_DFS_RANDOM_CHAN: Random channel selection.
1411  * @WLAN_DEBUG_DFS_AGILE:       Agile PreCAC/RCAC
1412  */
1413 enum {
1414 	WLAN_DEBUG_DFS  = 0x00000100,
1415 	WLAN_DEBUG_DFS1 = 0x00000200,
1416 	WLAN_DEBUG_DFS2 = 0x00000400,
1417 	WLAN_DEBUG_DFS3 = 0x00000800,
1418 	WLAN_DEBUG_DFS_PHYERR = 0x00001000,
1419 	WLAN_DEBUG_DFS_NOL    = 0x00002000,
1420 	WLAN_DEBUG_DFS_PHYERR_SUM = 0x00004000,
1421 	WLAN_DEBUG_DFS_PHYERR_PKT = 0x00008000,
1422 	WLAN_DEBUG_DFS_BIN5       = 0x00010000,
1423 	WLAN_DEBUG_DFS_BIN5_FFT   = 0x00020000,
1424 	WLAN_DEBUG_DFS_BIN5_PULSE = 0x00040000,
1425 	WLAN_DEBUG_DFS_FALSE_DET  = 0x00080000,
1426 	WLAN_DEBUG_DFS_FALSE_DET2 = 0x00100000,
1427 	WLAN_DEBUG_DFS_RANDOM_CHAN = 0x00200000,
1428 	WLAN_DEBUG_DFS_AGILE       = 0x00400000,
1429 	WLAN_DEBUG_DFS_MAX        = 0x80000000,
1430 	WLAN_DEBUG_DFS_ALWAYS     = WLAN_DEBUG_DFS_MAX
1431 };
1432 
1433 /**
1434  * enum host dfs spoof check status.
1435  * @HOST_DFS_CHECK_PASSED: Host indicates RADAR detected and the FW
1436  *                         confirms it to be spoof radar to host.
1437  * @HOST_DFS_CHECK_FAILED: Host doesn't indicate RADAR detected or spoof
1438  *                         radar parameters by
1439  *                         WMI_HOST_DFS_RADAR_FOUND_CMDID doesn't match.
1440  * @HOST_DFS_STATUS_CHECK_HW_RADAR: Host indicates RADAR detected and the
1441  *                             FW confirms it to be real HW radar to host.
1442  */
1443 #if defined(WLAN_DFS_PARTIAL_OFFLOAD) && defined(HOST_DFS_SPOOF_TEST)
1444 enum {
1445 	HOST_DFS_STATUS_CHECK_PASSED = 0,
1446 	HOST_DFS_STATUS_CHECK_FAILED = 1,
1447 	HOST_DFS_STATUS_CHECK_HW_RADAR = 2
1448 };
1449 #endif
1450 
1451 /**
1452  * struct dfs_phy_err - DFS phy error.
1453  * @fulltsf:             64-bit TSF as read from MAC.
1454  * @is_pri:              Detected on primary channel.
1455  * @is_ext:              Detected on extension channel.
1456  * @is_dc:               Detected at DC.
1457  * @is_early:            Early detect.
1458  * @do_check_chirp:      Whether to check hw_chirp/sw_chirp.
1459  * @is_hw_chirp:         Hardware-detected chirp.
1460  * @is_sw_chirp:         Software detected chirp.
1461  * @rs_tstamp:           32 bit TSF from RX descriptor (event).
1462  * @freq:                Centre frequency of event - KHz.
1463  * @freq_lo:             Lower bounds of frequency - KHz.
1464  * @freq_hi:             Upper bounds of frequency - KHz.
1465  * @rssi:                Pulse RSSI.
1466  * @dur:                 Pulse duration, raw (not uS).
1467  * @seg_id:              HT80_80/HT160 use.
1468  * @sidx:                Seg index.
1469  * @freq_offset_khz:     Freq offset in KHz.
1470  * @peak_mag:            Peak mag.
1471  * @total_gain:          Total gain.
1472  * @mb_gain:             Mb gain.
1473  * @relpwr_db:           Relpower in DB.
1474  * @pulse_delta_diff:    Pulse delta diff.
1475  * @pulse_delta_peak:    Pulse delta peak.
1476  * @pulse_psidx_diff:    Pulse psidx diff.
1477  *
1478  * Chirp notes!
1479  *
1480  * Pre-Sowl chips don't do FFT reports, so chirp pulses simply show up
1481  * as long duration pulses.
1482  *
1483  * The bin5 checking code would simply look for a chirp pulse of the correct
1484  * duration (within MIN_BIN5_DUR and MAX_BIN5_DUR) and add it to the "chirp"
1485  * pattern.
1486  *
1487  * For Sowl and later, an FFT was done on longer duration frames.  If those
1488  * frames looked like a chirp, their duration was adjusted to fall within
1489  * the chirp duration limits.  If the pulse failed the chirp test (it had
1490  * no FFT data or the FFT didn't meet the chirping requirements) then the
1491  * pulse duration was adjusted to be greater than MAX_BIN5_DUR, so it
1492  * would always fail chirp detection.
1493  *
1494  * This is pretty horrible.
1495  *
1496  * The eventual goal for chirp handling is thus:
1497  *
1498  * 1)In case someone ever wants to do chirp detection with this code on
1499  *   chips that don't support chirp detection, you can still do it based
1500  *   on pulse duration.  That's your problem to solve.
1501  *
1502  * 2)For chips that do hardware chirp detection or FFT, the "do_check_chirp"
1503  *   bit should be set.
1504  *
1505  * 3)Then, either is_hw_chirp or is_sw_chirp is set, indicating that
1506  *   the hardware or software post-processing of the chirp event found
1507  *   that indeed it was a chirp.
1508  *
1509  * 4)Finally, the bin5 code should just check whether the chirp bits are
1510  *   set and behave appropriately, falling back onto the duration checks
1511  *   if someone wishes to use this on older hardware (or with disabled
1512  *   FFTs, for whatever reason.)
1513  *
1514  * XXX TODO:
1515  *
1516  * 1)add duration in uS and raw duration, so the PHY error parsing
1517  *   code is responsible for doing the duration calculation;
1518  * 2)add ts in raw and corrected, so the PHY error parsing
1519  *   code is responsible for doing the offsetting, not the radar
1520  *   event code.
1521  */
1522 struct dfs_phy_err {
1523 	uint64_t fulltsf;
1524 	uint32_t is_pri:1,
1525 			 is_ext:1,
1526 			 is_dc:1,
1527 			 is_early:1,
1528 			 do_check_chirp:1,
1529 			 is_hw_chirp:1,
1530 			 is_sw_chirp:1;
1531 	uint32_t rs_tstamp;
1532 	uint32_t freq;
1533 	uint32_t freq_lo;
1534 	uint32_t freq_hi;
1535 	uint8_t  rssi;
1536 	uint8_t  dur;
1537 	uint8_t  seg_id;
1538 	int      sidx;
1539 	u_int    freq_offset_khz;
1540 	int      peak_mag;
1541 	int      total_gain;
1542 	int      mb_gain;
1543 	int      relpwr_db;
1544 	uint8_t  pulse_delta_diff;
1545 	int8_t   pulse_delta_peak;
1546 	int16_t  pulse_psidx_diff;
1547 };
1548 
1549 /**
1550  * struct rx_radar_status - Parsed radar status
1551  * @raw_tsf:           Raw tsf
1552  * @tsf_offset:        TSF offset.
1553  * @rssi:              RSSI.
1554  * @pulse_duration:    Pulse duration.
1555  * @is_chirp:          Is chirp.
1556  * @delta_peak:        Delta peak.
1557  * @delta_diff:        Delta diff.
1558  * @sidx:              Starting frequency.
1559  * @freq_offset:       Frequency offset.
1560  * @agc_total_gain:    AGC total gain.
1561  * @agc_mb_gain:       AGC MB gain.
1562  */
1563 struct rx_radar_status {
1564 	uint32_t raw_tsf;
1565 	uint32_t tsf_offset;
1566 	int      rssi;
1567 	int      pulse_duration;
1568 	int      is_chirp:1;
1569 	int      delta_peak;
1570 	int      delta_diff;
1571 	int      sidx;
1572 	int      freq_offset; /* in KHz */
1573 	int      agc_total_gain;
1574 	int      agc_mb_gain;
1575 };
1576 
1577 /**
1578  * struct rx_search_fft_report - FFT report.
1579  * @total_gain_db:     Total gain in Db.
1580  * @base_pwr_db:       Base power in Db.
1581  * @fft_chn_idx:       FFT channel index.
1582  * @peak_sidx:         Peak sidx.
1583  * @relpwr_db:         Real power in Db.
1584  * @avgpwr_db:         Average power in Db.
1585  * @peak_mag:          Peak Mag.
1586  * @num_str_bins_ib:   Num dtr BINs IB
1587  * @seg_id:            Segment ID
1588  */
1589 struct rx_search_fft_report {
1590 	uint32_t total_gain_db;
1591 	uint32_t base_pwr_db;
1592 	int      fft_chn_idx;
1593 	int      peak_sidx;
1594 	int      relpwr_db;
1595 	int      avgpwr_db;
1596 	int      peak_mag;
1597 	int      num_str_bins_ib;
1598 	int      seg_id;
1599 };
1600 
1601 /**
1602  * dfs_process_radarevent() - process the radar event generated for a pulse.
1603  * @dfs: Pointer to wlan_dfs structure.
1604  * @chan: Current channel.
1605  *
1606  * There is currently no way to specify that a radar event has occurred on
1607  * a specific channel, so the current methodology is to mark both the pri
1608  * and ext channels as being unavailable. This should be fixed for 802.11ac
1609  * or we'll quickly run out of valid channels to use.
1610  *
1611  * If Radar found, this marks the channel (and the extension channel, if HT40)
1612  * as having seen a radar event. It marks CHAN_INTERFERENCE and will add it to
1613  * the local NOL implementation. This is only done for 'usenol=1', as the other
1614  * two modes don't do radar notification or CAC/CSA/NOL; it just notes there
1615  * was a radar.
1616  */
1617 void  dfs_process_radarevent(struct wlan_dfs *dfs,
1618 		struct dfs_channel *chan);
1619 
1620 /**
1621  * dfs_nol_addchan() - Add channel to NOL.
1622  * @dfs: Pointer to wlan_dfs structure.
1623  * @freq: frequency to add to NOL.
1624  * @dfs_nol_timeout: NOL timeout.
1625  */
1626 void dfs_nol_addchan(struct wlan_dfs *dfs,
1627 		uint16_t freq,
1628 		uint32_t dfs_nol_timeout);
1629 
1630 /**
1631  * dfs_get_nol() - Get NOL.
1632  * @dfs: Pointer to wlan_dfs structure.
1633  * @dfs_nol: Pointer to dfsreq_nolelem structure to save the channels from NOL.
1634  * @nchan: Number of channels.
1635  */
1636 void dfs_get_nol(struct wlan_dfs *dfs,
1637 		struct dfsreq_nolelem *dfs_nol,
1638 		int *nchan);
1639 
1640 /**
1641  * dfs_set_nol() - Set NOL.
1642  * @dfs: Pointer to wlan_dfs structure.
1643  * @dfs_nol: Pointer to dfsreq_nolelem structure.
1644  * @nchan: Number of channels.
1645  */
1646 void dfs_set_nol(struct wlan_dfs *dfs,
1647 		 struct dfsreq_nolelem *dfs_nol,
1648 		 int nchan);
1649 
1650 /**
1651  * dfs_nol_update() - NOL update
1652  * @dfs: Pointer to wlan_dfs structure.
1653  *
1654  * Notify the driver/umac that it should update the channel radar/NOL flags
1655  * based on the current NOL list.
1656  */
1657 void dfs_nol_update(struct wlan_dfs *dfs);
1658 
1659 /**
1660  * dfs_nol_timer_cleanup() - NOL timer cleanup.
1661  * @dfs: Pointer to wlan_dfs structure.
1662  *
1663  * Cancels the NOL timer and frees the NOL elements.
1664  */
1665 void dfs_nol_timer_cleanup(struct wlan_dfs *dfs);
1666 
1667 /**
1668  * dfs_nol_timer_detach() - Free NOL timer.
1669  * @dfs: Pointer to wlan_dfs structure.
1670  */
1671 void dfs_nol_timer_detach(struct wlan_dfs *dfs);
1672 
1673 /**
1674  * dfs_nol_workqueue_cleanup() - Flushes NOL workqueue.
1675  * @dfs: Pointer to wlan_dfs structure.
1676  *
1677  * Flushes the NOL workqueue.
1678  */
1679 void dfs_nol_workqueue_cleanup(struct wlan_dfs *dfs);
1680 
1681 /**
1682  * dfs_retain_bin5_burst_pattern() - Retain the BIN5 burst pattern.
1683  * @dfs: Pointer to wlan_dfs structure.
1684  * @diff_ts: Timestamp diff.
1685  * @old_dur: Old duration.
1686  */
1687 uint8_t dfs_retain_bin5_burst_pattern(struct wlan_dfs *dfs,
1688 		uint32_t diff_ts,
1689 		uint8_t old_dur);
1690 
1691 /**
1692  * dfs_bin5_check_pulse() - BIN5 check pulse.
1693  * @dfs: Pointer to wlan_dfs structure.
1694  * @re: Pointer to dfs_event structure.
1695  * @br: Pointer to dfs_bin5radars structure.
1696  *
1697  * Reject the pulse if:
1698  * 1) It's outside the RSSI threshold;
1699  * 2) It's outside the pulse duration;
1700  * 3) It's been verified by HW/SW chirp checking
1701  *    and neither of those found a chirp.
1702  */
1703 int dfs_bin5_check_pulse(struct wlan_dfs *dfs,
1704 		struct dfs_event *re,
1705 		struct dfs_bin5radars *br);
1706 
1707 /**
1708  * dfs_bin5_addpulse() - BIN5 add pulse.
1709  * @dfs: Pointer to wlan_dfs structure.
1710  * @br: Pointer to dfs_bin5radars structure.
1711  * @re: Pointer to dfs_event structure.
1712  * @thists: Timestamp.
1713  */
1714 int dfs_bin5_addpulse(struct wlan_dfs *dfs,
1715 		struct dfs_bin5radars *br,
1716 		struct dfs_event *re,
1717 		uint64_t thists);
1718 
1719 /**
1720  * dfs_bin5_check() - BIN5 check.
1721  * @dfs: Pointer to wlan_dfs structure.
1722  *
1723  * If the dfs structure is NULL (which should be illegal if everything is working
1724  * properly, then signify that a bin5 radar was found.
1725  */
1726 int dfs_bin5_check(struct wlan_dfs *dfs);
1727 
1728 /**
1729  * dfs_check_chirping() - Check chirping.
1730  * @dfs: Pointer to wlan_dfs structure.
1731  * @buf: Phyerr buffer
1732  * @datalen: Phyerr buf length
1733  * @is_ctl: detected on primary channel.
1734  * @is_ext: detected on extension channel.
1735  * @slope: Slope
1736  * @is_dc: DC found
1737  *
1738  * This examines the FFT data contained in the PHY error information to figure
1739  * out whether the pulse is moving across frequencies.
1740  */
1741 int dfs_check_chirping(struct wlan_dfs *dfs,
1742 		void *buf,
1743 		uint16_t datalen,
1744 		int is_ctl,
1745 		int is_ext,
1746 		int *slope,
1747 		int *is_dc);
1748 
1749 /**
1750  * dfs_get_random_bin5_dur() - Get random BIN5 duration.
1751  * @dfs: Pointer to wlan_dfs structure.
1752  * @tstamp: Timestamp.
1753  *
1754  * Chirping pulses may get cut off at DC and report lower durations.
1755  * This function will compute a suitable random duration for each pulse.
1756  * Duration must be between 50 and 100 us, but remember that in
1757  * wlan_process_phyerr() which calls this function, we are dealing with the
1758  * HW reported duration (unconverted). dfs_process_radarevent() will
1759  * actually convert the duration into the correct value.
1760  * This function doesn't take into account whether the hardware
1761  * is operating in 5GHz fast clock mode or not.
1762  * And this function doesn't take into account whether the hardware
1763  * is peregrine or not.
1764  */
1765 int dfs_get_random_bin5_dur(struct wlan_dfs *dfs,
1766 		uint64_t tstamp);
1767 
1768 /**
1769  * dfs_print_delayline() - Prints delayline.
1770  * @dfs: Pointer to wlan_dfs structure.
1771  * @dl: Pointer to dfs_delayline structure.
1772  */
1773 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
1774 void dfs_print_delayline(struct wlan_dfs *dfs,
1775 		struct dfs_delayline *dl);
1776 #else
1777 static inline
1778 void dfs_print_delayline(struct wlan_dfs *dfs, struct dfs_delayline *dl)
1779 {
1780 }
1781 #endif
1782 
1783 /**
1784  * dfs_print_nol() - Print NOL elements.
1785  * @dfs: Pointer to wlan_dfs structure.
1786  */
1787 void dfs_print_nol(struct wlan_dfs *dfs);
1788 
1789 /**
1790  * dfs_print_filter() - Prints the filter.
1791  * @dfs: Pointer to wlan_dfs structure.
1792  * @rf: Pointer to dfs_filter structure.
1793  */
1794 void dfs_print_filter(struct wlan_dfs *dfs,
1795 		struct dfs_filter *rf);
1796 
1797 /**
1798  * dfs_getchanstate() - Get chan state.
1799  * @dfs: Pointer to wlan_dfs structure.
1800  * @index: To save the index of dfs_radar[]
1801  * @ext_chan_flag: Extension channel flag;
1802  */
1803 struct dfs_state *dfs_getchanstate(struct wlan_dfs *dfs,
1804 		uint8_t *index,
1805 		int ext_ch_flag);
1806 
1807 /**
1808  * dfs_round() - DFS found.
1809  * @val: Convert durations to TSF ticks.
1810  *
1811  * Return: TSF ticks.
1812  */
1813 uint32_t dfs_round(int32_t val);
1814 
1815 /**
1816  * dfs_reset_alldelaylines() - Reset alldelaylines.
1817  * @dfs: Pointer to wlan_dfs structure.
1818  */
1819 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
1820 void dfs_reset_alldelaylines(struct wlan_dfs *dfs);
1821 #else
1822 static inline void dfs_reset_alldelaylines(struct wlan_dfs *dfs)
1823 {
1824 }
1825 #endif
1826 
1827 /**
1828  * dfs_reset_delayline() - Clear only a single delay line.
1829  * @dl: Pointer to dfs_delayline structure.
1830  */
1831 void dfs_reset_delayline(struct dfs_delayline *dl);
1832 
1833 /**
1834  * dfs_reset_filter_delaylines() - Reset filter delaylines.
1835  * @dft: Pointer to dfs_filtertype structure.
1836  */
1837 void dfs_reset_filter_delaylines(struct dfs_filtertype *dft);
1838 
1839 /**
1840  * dfs_reset_radarq() - Reset radar queue.
1841  * @dfs: Pointer to wlan_dfs structure.
1842  */
1843 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
1844 void dfs_reset_radarq(struct wlan_dfs *dfs);
1845 #else
1846 static inline void dfs_reset_radarq(struct wlan_dfs *dfs)
1847 {
1848 }
1849 #endif
1850 
1851 /**
1852  * dfs_add_pulse() - Adds pulse to the queue.
1853  * @dfs: Pointer to wlan_dfs structure.
1854  * @rf: Pointer to dfs_filter structure.
1855  * @re: Pointer to dfs_event structure.
1856  * @deltaT: deltaT value.
1857  * @this_ts: Last time stamp.
1858  */
1859 void dfs_add_pulse(struct wlan_dfs *dfs,
1860 		struct dfs_filter *rf,
1861 		struct dfs_event *re,
1862 		uint32_t deltaT,
1863 		uint64_t this_ts);
1864 
1865 /**
1866  * dfs_bin_check() - BIN check
1867  * @dfs: Pointer to wlan_dfs structure.
1868  * @rf: Pointer to dfs_filter structure.
1869  * @deltaT: deltaT value.
1870  * @width: Width
1871  * @ext_chan_flag: Extension channel flag.
1872  */
1873 int dfs_bin_check(struct wlan_dfs *dfs,
1874 		struct dfs_filter *rf,
1875 		uint32_t deltaT,
1876 		uint32_t dur,
1877 		int ext_chan_flag);
1878 
1879 /**
1880  * dfs_bin_pri_check() - BIN PRI check
1881  * @dfs: Pointer to wlan_dfs structure.
1882  * @rf: Pointer to dfs_filter structure.
1883  * @dl: Pointer to dfs_delayline structure.
1884  * @score: Primary score.
1885  * @refpri: Current "filter" time for start of pulse in usecs.
1886  * @refdur: Duration value.
1887  * @ext_chan_flag: Extension channel flag.
1888  * @fundamentalpri: Highest PRI.
1889  */
1890 int dfs_bin_pri_check(struct wlan_dfs *dfs,
1891 		struct dfs_filter *rf,
1892 		struct dfs_delayline *dl,
1893 		uint32_t score,
1894 		uint32_t refpri,
1895 		uint32_t refdur,
1896 		int ext_chan_flag,
1897 		int fundamentalpri);
1898 
1899 /**
1900  * dfs_staggered_check() - Detection implementation for staggered PRIs.
1901  * @dfs: Pointer to wlan_dfs structure.
1902  * @rf: Pointer to dfs_filter structure.
1903  * @deltaT: Delta of the Timestamp.
1904  * @width: Duration of radar pulse.
1905  *
1906  * Return: 1 on success and 0 on failure.
1907  */
1908 int dfs_staggered_check(struct wlan_dfs *dfs,
1909 		struct dfs_filter *rf,
1910 		uint32_t deltaT,
1911 		uint32_t width);
1912 
1913 /**
1914  * dfs_get_pri_margin() - Get Primary margin.
1915  * @dfs: Pointer to wlan_dfs structure.
1916  * @is_extchan_detect: Extension channel detect.
1917  * @is_fixed_pattern: Fixed pattern.
1918  *
1919  * For the extension channel, if legacy traffic is present, we see a lot of
1920  * false alarms, so make the PRI margin narrower depending on the busy % for
1921  * the extension channel.
1922  *
1923  * Return: Returns pri_margin.
1924  */
1925 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
1926 int dfs_get_pri_margin(struct wlan_dfs *dfs,
1927 		int is_extchan_detect,
1928 		int is_fixed_pattern);
1929 #else
1930 static inline
1931 int dfs_get_pri_margin(struct wlan_dfs *dfs,
1932 		       int is_extchan_detect,
1933 		       int is_fixed_pattern)
1934 {
1935 	return 0;
1936 }
1937 #endif
1938 
1939 /**
1940  * dfs_get_filter_threshold() - Get filter threshold.
1941  * @dfs: Pointer to wlan_dfs structure.
1942  * @rf: Pointer to dfs_filter structure.
1943  * @is_extchan_detect: Extension channel detect.
1944  *
1945  * For the extension channel, if legacy traffic is present, we see a lot of
1946  * false alarms, so make the thresholds higher depending on the busy % for the
1947  * extension channel.
1948  *
1949  * Return: Returns threshold.
1950  */
1951 int dfs_get_filter_threshold(struct wlan_dfs *dfs,
1952 		struct dfs_filter *rf,
1953 		int is_extchan_detect);
1954 
1955 #if defined(MOBILE_DFS_SUPPORT)
1956 /**
1957  * dfs_process_ar_event() - Process the ar event.
1958  * @dfs: Pointer to wlan_dfs structure.
1959  * @chan: Current channel structure.
1960  */
1961 static inline void dfs_process_ar_event(struct wlan_dfs *dfs,
1962 					struct dfs_channel *chan)
1963 {
1964 }
1965 
1966 /**
1967  * dfs_reset_ar() - resets the ar state.
1968  * @dfs: pointer to wlan_dfs structure.
1969  */
1970 static inline void dfs_reset_ar(struct wlan_dfs *dfs)
1971 {
1972 }
1973 
1974 /**
1975  * dfs_reset_arq() - resets the ar queue.
1976  * @dfs: pointer to wlan_dfs structure.
1977  */
1978 static inline void dfs_reset_arq(struct wlan_dfs *dfs)
1979 {
1980 }
1981 
1982 #else
1983 void dfs_process_ar_event(struct wlan_dfs *dfs,
1984 			  struct dfs_channel *chan);
1985 
1986 void dfs_reset_ar(struct wlan_dfs *dfs);
1987 void dfs_reset_arq(struct wlan_dfs *dfs);
1988 #endif
1989 
1990 /**
1991  * dfs_is_radar_enabled() - check if radar detection is enabled.
1992  * @dfs: Pointer to wlan_dfs structure.
1993  * @ignore_dfs: if 1 then radar detection is disabled..
1994  */
1995 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
1996 void dfs_is_radar_enabled(struct wlan_dfs *dfs,
1997 			  int *ignore_dfs);
1998 #else
1999 static inline void dfs_is_radar_enabled(struct wlan_dfs *dfs,
2000 					int *ignore_dfs)
2001 {
2002 }
2003 #endif
2004 
2005 /**
2006  * dfs_process_phyerr_bb_tlv() - Parses the PHY error and populates the
2007  *                               dfs_phy_err struct.
2008  * @dfs: Pointer to wlan_dfs structure.
2009  * @buf: Phyerr buffer
2010  * @datalen: Phyerr buf len
2011  * @rssi: RSSI
2012  * @ext_rssi: Extension RSSI.
2013  * @rs_tstamp: Time stamp.
2014  * @fulltsf: TSF64.
2015  * @e: Pointer to dfs_phy_err structure.
2016  *
2017  * Return: Returns 1.
2018  */
2019 int dfs_process_phyerr_bb_tlv(struct wlan_dfs *dfs,
2020 		void *buf,
2021 		uint16_t datalen,
2022 		uint8_t rssi,
2023 		uint8_t ext_rssi,
2024 		uint32_t rs_tstamp,
2025 		uint64_t fulltsf,
2026 		struct dfs_phy_err *e);
2027 
2028 /**
2029  * dfs_reset() - DFS reset
2030  * @dfs: Pointer to wlan_dfs structure.
2031  */
2032 void dfs_reset(struct wlan_dfs *dfs);
2033 
2034 /**
2035  * dfs_radar_enable() - Enables the radar.
2036  * @dfs: Pointer to wlan_dfs structure.
2037  * @no_cac: If no_cac is 0, it cancels the CAC.
2038  */
2039 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2040 void dfs_radar_enable(struct wlan_dfs *dfs,
2041 		int no_cac, uint32_t opmode);
2042 #else
2043 static inline void dfs_radar_enable(struct wlan_dfs *dfs,
2044 		int no_cac, uint32_t opmode)
2045 {
2046 }
2047 #endif
2048 
2049 /**
2050  * dfs_process_phyerr() - Process phyerr.
2051  * @dfs: Pointer to wlan_dfs structure.
2052  * @buf: Phyerr buffer.
2053  * @datalen: phyerr buffer length.
2054  * @r_rssi: RSSI.
2055  * @r_ext_rssi: Extension channel RSSI.
2056  * @r_rs_tstamp: Timestamp.
2057  * @r_fulltsf: TSF64.
2058  */
2059 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2060 void dfs_process_phyerr(struct wlan_dfs *dfs,
2061 		void *buf,
2062 		uint16_t datalen,
2063 		uint8_t r_rssi,
2064 		uint8_t r_ext_rssi,
2065 		uint32_t r_rs_tstamp,
2066 		uint64_t r_fulltsf);
2067 #else
2068 static inline void dfs_process_phyerr(struct wlan_dfs *dfs,
2069 		void *buf,
2070 		uint16_t datalen,
2071 		uint8_t r_rssi,
2072 		uint8_t r_ext_rssi,
2073 		uint32_t r_rs_tstamp,
2074 		uint64_t r_fulltsf)
2075 {
2076 }
2077 #endif
2078 
2079 #ifdef QCA_SUPPORT_DFS_CHAN_POSTNOL
2080 /**
2081  * dfs_switch_to_postnol_chan_if_nol_expired() - Find if NOL is expired
2082  * in the postNOL channel configured. If true, trigger channel change.
2083  * @dfs: Pointer to DFS of wlan_dfs structure.
2084  *
2085  * Return: True, if channel change is triggered, else false.
2086  */
2087 bool dfs_switch_to_postnol_chan_if_nol_expired(struct wlan_dfs *dfs);
2088 #else
2089 static inline bool
2090 dfs_switch_to_postnol_chan_if_nol_expired(struct wlan_dfs *dfs)
2091 {
2092 	return false;
2093 }
2094 #endif
2095 
2096 #ifdef MOBILE_DFS_SUPPORT
2097 /**
2098  * dfs_process_phyerr_filter_offload() - Process radar event.
2099  * @dfs: Pointer to wlan_dfs structure.
2100  * @wlan_radar_event: Pointer to radar_event_info structure.
2101  *
2102  * Return: None
2103  */
2104 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2105 void dfs_process_phyerr_filter_offload(struct wlan_dfs *dfs,
2106 		struct radar_event_info *wlan_radar_event);
2107 #else
2108 static inline void dfs_process_phyerr_filter_offload(
2109 		struct wlan_dfs *dfs,
2110 		struct radar_event_info *wlan_radar_event)
2111 {
2112 }
2113 #endif
2114 #endif
2115 
2116 /**
2117  * dfs_get_radars() - Based on the chipset, calls init radar table functions.
2118  * @dfs: Pointer to wlan_dfs structure.
2119  */
2120 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2121 void dfs_get_radars(struct wlan_dfs *dfs);
2122 #else
2123 static inline void dfs_get_radars(struct wlan_dfs *dfs)
2124 {
2125 }
2126 #endif
2127 
2128 /**
2129  * dfs_attach() - Wrapper function to allocate memory for wlan_dfs members.
2130  * @dfs: Pointer to wlan_dfs structure.
2131  */
2132 int dfs_attach(struct wlan_dfs *dfs);
2133 
2134 
2135 /**
2136  * dfs_create_object() - Creates DFS object.
2137  * @dfs: Pointer to wlan_dfs structure.
2138  */
2139 int dfs_create_object(struct wlan_dfs **dfs);
2140 
2141 /**
2142  * dfs_destroy_object() - Destroys the DFS object.
2143  * @dfs: Pointer to wlan_dfs structure.
2144  */
2145 void dfs_destroy_object(struct wlan_dfs *dfs);
2146 
2147 /**
2148  * dfs_detach() - Wrapper function to free dfs variables.
2149  * @dfs: Pointer to wlan_dfs structure.
2150  */
2151 void dfs_detach(struct wlan_dfs *dfs);
2152 
2153 #ifdef QCA_SUPPORT_DFS_CAC
2154 /**
2155  * dfs_stacac_stop() - Clear the STA CAC timer.
2156  * @dfs: Pointer to wlan_dfs structure.
2157  */
2158 void dfs_stacac_stop(struct wlan_dfs *dfs);
2159 
2160 /**
2161  * dfs_is_cac_required() - Check if DFS CAC is required for the current channel.
2162  * @dfs: Pointer to wlan_dfs structure.
2163  * @cur_chan: Pointer to current channel of dfs_channel structure.
2164  * @prev_chan: Pointer to previous channel of dfs_channel structure.
2165  * @continue_current_cac: If AP can start CAC then this variable indicates
2166  * whether to continue with the current CAC or restart the CAC. This variable
2167  * is valid only if this function returns true.
2168  * @is_vap_restart: Flag to indicate if vap is restarted/started.
2169  * True: VAP restart. False: VAP start
2170  *
2171  * Return: true if AP requires CAC or can continue current CAC, else false.
2172  */
2173 bool dfs_is_cac_required(struct wlan_dfs *dfs,
2174 			 struct dfs_channel *cur_chan,
2175 			 struct dfs_channel *prev_chan,
2176 			 bool *continue_current_cac,
2177 			 bool is_vap_restart);
2178 
2179 /**
2180  * dfs_send_dfs_events_for_chan() - Send CAC RESET events
2181  * @dfs: Pointer to wlan_dfs structure.
2182  * @chan: Pointer to dfs_channel structure.
2183  * @event: WLAN_DFS_EVENTS values
2184  */
2185 void dfs_send_dfs_events_for_chan(struct wlan_dfs *dfs,
2186 				  struct dfs_channel *chan,
2187 				  enum WLAN_DFS_EVENTS event);
2188 
2189 /**
2190  * dfs_cac_stop() - Clear the AP CAC timer.
2191  * @dfs: Pointer to wlan_dfs structure.
2192  */
2193 void dfs_cac_stop(struct wlan_dfs *dfs);
2194 
2195 /**
2196  * dfs_cancel_cac_timer() - Cancels the CAC timer.
2197  * @dfs: Pointer to wlan_dfs structure.
2198  */
2199 void dfs_cancel_cac_timer(struct wlan_dfs *dfs);
2200 
2201 /**
2202  * dfs_start_cac_timer() - Starts the CAC timer.
2203  * @dfs: Pointer to wlan_dfs structure.
2204  */
2205 void dfs_start_cac_timer(struct wlan_dfs *dfs);
2206 
2207 /**
2208  * dfs_cac_valid_reset_for_freq() - Cancels the dfs_cac_valid_timer timer.
2209  * @dfs: Pointer to wlan_dfs structure.
2210  * @prevchan_chan: Prevchan frequency
2211  * @prevchan_flags: Prevchan flags.
2212  */
2213 #ifdef CONFIG_CHAN_FREQ_API
2214 void dfs_cac_valid_reset_for_freq(struct wlan_dfs *dfs,
2215 				  uint16_t prevchan_freq,
2216 				  uint32_t prevchan_flags);
2217 #endif
2218 
2219 /**
2220  * dfs_get_override_cac_timeout() -  Get override CAC timeout value.
2221  * @dfs: Pointer to DFS object.
2222  * @cac_timeout: Pointer to save the CAC timeout value.
2223  */
2224 int dfs_get_override_cac_timeout(struct wlan_dfs *dfs,
2225 				 int *cac_timeout);
2226 
2227 /**
2228  * dfs_override_cac_timeout() -  Override the default CAC timeout.
2229  * @dfs: Pointer to DFS object.
2230  * @cac_timeout: CAC timeout value.
2231  */
2232 int dfs_override_cac_timeout(struct wlan_dfs *dfs,
2233 			     int cac_timeout);
2234 
2235 /**
2236  * dfs_is_ap_cac_timer_running() - Returns the dfs cac timer.
2237  * @dfs: Pointer to wlan_dfs structure.
2238  */
2239 int dfs_is_ap_cac_timer_running(struct wlan_dfs *dfs);
2240 
2241 /**
2242  * dfs_cac_timer_attach() - Initialize cac timers.
2243  * @dfs: Pointer to wlan_dfs structure.
2244  */
2245 void dfs_cac_timer_attach(struct wlan_dfs *dfs);
2246 
2247 /**
2248  * dfs_cac_timer_reset() - Cancel dfs cac timers.
2249  * @dfs: Pointer to wlan_dfs structure.
2250  */
2251 void dfs_cac_timer_reset(struct wlan_dfs *dfs);
2252 
2253 /**
2254  * dfs_cac_timer_detach() - Free dfs cac timers.
2255  * @dfs: Pointer to wlan_dfs structure.
2256  */
2257 void dfs_cac_timer_detach(struct wlan_dfs *dfs);
2258 
2259 /**
2260  * dfs_deliver_cac_state_events() - Deliver the DFS CAC events namely
2261  * WLAN_EV_CAC_STARTED on cac started channel(current channel) and
2262  * WLAN_EV_CAC_RESET on previous dfs channel.
2263  *
2264  * @dfs: Pointer to wlan_dfs structure.
2265  */
2266 #if defined(WLAN_DISP_CHAN_INFO)
2267 void dfs_deliver_cac_state_events(struct wlan_dfs *dfs);
2268 #else
2269 static inline
2270 void dfs_deliver_cac_state_events(struct wlan_dfs *dfs)
2271 {
2272 }
2273 #endif
2274 #else
2275 static inline
2276 void dfs_stacac_stop(struct wlan_dfs *dfs)
2277 {
2278 }
2279 
2280 static inline
2281 bool dfs_is_cac_required(struct wlan_dfs *dfs,
2282 			 struct dfs_channel *cur_chan,
2283 			 struct dfs_channel *prev_chan,
2284 			 bool *continue_current_cac,
2285 			 bool is_vap_restart)
2286 {
2287 	return false;
2288 }
2289 
2290 static inline
2291 void dfs_cac_stop(struct wlan_dfs *dfs)
2292 {
2293 }
2294 
2295 static inline
2296 void dfs_send_dfs_events_for_chan(struct wlan_dfs *dfs,
2297 				  struct dfs_channel *chan,
2298 				  enum WLAN_DFS_EVENTS event)
2299 {
2300 }
2301 
2302 static inline
2303 void dfs_cancel_cac_timer(struct wlan_dfs *dfs)
2304 {
2305 }
2306 
2307 static inline
2308 void dfs_start_cac_timer(struct wlan_dfs *dfs)
2309 {
2310 }
2311 
2312 #ifdef CONFIG_CHAN_FREQ_API
2313 static inline
2314 void dfs_cac_valid_reset_for_freq(struct wlan_dfs *dfs,
2315 				  uint16_t prevchan_freq,
2316 				  uint32_t prevchan_flags)
2317 {
2318 }
2319 #endif
2320 
2321 static inline
2322 int dfs_get_override_cac_timeout(struct wlan_dfs *dfs,
2323 				 int *cac_timeout)
2324 {
2325 	return 0;
2326 }
2327 
2328 static inline
2329 int dfs_override_cac_timeout(struct wlan_dfs *dfs,
2330 			     int cac_timeout)
2331 {
2332 	return 0;
2333 }
2334 
2335 static inline
2336 int dfs_is_ap_cac_timer_running(struct wlan_dfs *dfs)
2337 {
2338 	return 0;
2339 }
2340 
2341 static inline
2342 void dfs_cac_timer_attach(struct wlan_dfs *dfs)
2343 {
2344 }
2345 
2346 static inline
2347 void dfs_cac_timer_reset(struct wlan_dfs *dfs)
2348 {
2349 }
2350 
2351 static inline
2352 void dfs_cac_timer_detach(struct wlan_dfs *dfs)
2353 {
2354 }
2355 
2356 static inline
2357 void dfs_deliver_cac_state_events(struct wlan_dfs *dfs)
2358 {
2359 }
2360 #endif
2361 /**
2362  * dfs_set_update_nol_flag() - Sets update_nol flag.
2363  * @dfs: Pointer to wlan_dfs structure.
2364  * @val: update_nol flag.
2365  */
2366 void dfs_set_update_nol_flag(struct wlan_dfs *dfs,
2367 		bool val);
2368 
2369 /**
2370  * dfs_get_update_nol_flag() - Returns update_nol flag.
2371  * @dfs: Pointer to wlan_dfs structure.
2372  */
2373 bool dfs_get_update_nol_flag(struct wlan_dfs *dfs);
2374 
2375 /**
2376  * dfs_get_use_nol() - Get usenol.
2377  * @dfs: Pointer to wlan_dfs structure.
2378  */
2379 int dfs_get_use_nol(struct wlan_dfs *dfs);
2380 
2381 /**
2382  * dfs_get_nol_timeout() - Get NOL timeout.
2383  * @dfs: Pointer to wlan_dfs structure.
2384  */
2385 int dfs_get_nol_timeout(struct wlan_dfs *dfs);
2386 
2387 /**
2388  * dfs_control()- Used to process ioctls related to DFS.
2389  * @dfs: Pointer to wlan_dfs structure.
2390  * @id: Command type.
2391  * @indata: Input buffer.
2392  * @insize: size of the input buffer.
2393  * @outdata: A buffer for the results.
2394  * @outsize: Size of the output buffer.
2395  */
2396 int dfs_control(struct wlan_dfs *dfs,
2397 		u_int id,
2398 		void *indata,
2399 		uint32_t insize,
2400 		void *outdata,
2401 		uint32_t *outsize);
2402 
2403 /**
2404  * dfs_getnol() - Wrapper function for dfs_get_nol()
2405  * @dfs: Pointer to wlan_dfs structure.
2406  * @dfs_nolinfo: Pointer to dfsreq_nolinfo structure.
2407  */
2408 void dfs_getnol(struct wlan_dfs *dfs,
2409 		void *dfs_nolinfo);
2410 
2411 /**
2412  * dfs_clear_nolhistory() - unmarks WLAN_CHAN_CLR_HISTORY_RADAR flag for
2413  *                          all the channels in dfs_ch_channels.
2414  * @dfs: Pointer to wlan_dfs structure.
2415  */
2416 #if !defined(MOBILE_DFS_SUPPORT)
2417 void dfs_clear_nolhistory(struct wlan_dfs *dfs);
2418 #else
2419 static inline void
2420 dfs_clear_nolhistory(struct wlan_dfs *dfs)
2421 {
2422 }
2423 #endif
2424 
2425 /**
2426  * ol_if_dfs_configure() - Initialize the RADAR table for offload chipsets.
2427  * @dfs: Pointer to wlan_dfs structure.
2428  *
2429  * This is called during a channel change or regulatory domain
2430  * reset; in order to fetch the new configuration information and
2431  * program the DFS pattern matching module.
2432  *
2433  * Eventually this should be split into "fetch config" (which can
2434  * happen at regdomain selection time) and "configure DFS" (which
2435  * can happen at channel config time) so as to minimise overheads
2436  * when doing channel changes.  However, this'll do for now.
2437  */
2438 void ol_if_dfs_configure(struct wlan_dfs *dfs);
2439 
2440 /**
2441  * dfs_init_radar_filters() - Init Radar filters.
2442  * @dfs: Pointer to wlan_dfs structure.
2443  * @radar_info: Pointer to wlan_dfs_radar_tab_info structure.
2444  */
2445 int dfs_init_radar_filters(struct wlan_dfs *dfs,
2446 		struct wlan_dfs_radar_tab_info *radar_info);
2447 
2448 /**
2449  * dfs_print_filters() - Print the filters.
2450  * @dfs: Pointer to wlan_dfs structure.
2451  */
2452 void dfs_print_filters(struct wlan_dfs *dfs);
2453 
2454 /**
2455  * dfs_clear_stats() - Clear stats.
2456  * @dfs: Pointer to wlan_dfs structure.
2457  */
2458 void dfs_clear_stats(struct wlan_dfs *dfs);
2459 
2460 /**
2461  * dfs_radar_disable() - Disables the radar.
2462  * @dfs: Pointer to wlan_dfs structure.
2463  */
2464 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2465 int dfs_radar_disable(struct wlan_dfs *dfs);
2466 #else
2467 static inline int dfs_radar_disable(struct wlan_dfs *dfs)
2468 {
2469 	return 0;
2470 }
2471 #endif
2472 
2473 /**
2474  * dfs_get_debug_info() - Get debug info.
2475  * @dfs: Pointer to wlan_dfs structure.
2476  * @data: void pointer to the data to save dfs_proc_phyerr.
2477  */
2478 int dfs_get_debug_info(struct wlan_dfs *dfs,
2479 		void *data);
2480 
2481 
2482 /**
2483  * dfs_nol_timer_init() - Initialize NOL timers.
2484  * @dfs: Pointer to wlan_dfs structure.
2485  */
2486 void dfs_nol_timer_init(struct wlan_dfs *dfs);
2487 
2488 /**
2489  * dfs_nol_attach() - Initialize NOL variables.
2490  * @dfs: Pointer to wlan_dfs structure.
2491  */
2492 void dfs_nol_attach(struct wlan_dfs *dfs);
2493 
2494 /**
2495  * dfs_nol_detach() - Detach NOL variables.
2496  * @dfs: Pointer to wlan_dfs structure.
2497  */
2498 void dfs_nol_detach(struct wlan_dfs *dfs);
2499 
2500 /**
2501  * dfs_print_nolhistory() - Print NOL history.
2502  * @dfs: Pointer to wlan_dfs structure.
2503  */
2504 void dfs_print_nolhistory(struct wlan_dfs *dfs);
2505 
2506 /**
2507  * dfs_find_precac_secondary_vht80_chan() - Get a VHT80 channel with the
2508  *                                          precac primary center frequency.
2509  * @dfs: Pointer to wlan_dfs structure.
2510  * @chan: Pointer to dfs channel structure.
2511  */
2512 void dfs_find_precac_secondary_vht80_chan(struct wlan_dfs *dfs,
2513 		struct dfs_channel *chan);
2514 
2515 #ifdef WLAN_DFS_PRECAC_AUTO_CHAN_SUPPORT
2516 /**
2517  * dfs_precac_csa() - Automatically switch the channel to the DFS channel
2518  *			on which PreCAC was completed without finding a RADAR.
2519  *			Use CSA with TBTT_COUNT to switch the channel.
2520  * @dfs: Pointer to dfs handler.
2521  *
2522  * Return: Void
2523  */
2524 void dfs_precac_csa(struct wlan_dfs *dfs);
2525 #endif
2526 
2527 /**
2528  * dfs_phyerr_param_copy() - Function to copy src buf to dest buf.
2529  * @dst: dest buf.
2530  * @src: src buf.
2531  */
2532 void dfs_phyerr_param_copy(struct wlan_dfs_phyerr_param *dst,
2533 		struct wlan_dfs_phyerr_param *src);
2534 
2535 /**
2536  * dfs_get_thresholds() - Get the threshold value.
2537  * @dfs: Pointer to wlan_dfs structure.
2538  * @param: Pointer to wlan_dfs_phyerr_param structure.
2539  */
2540 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2541 int dfs_get_thresholds(struct wlan_dfs *dfs,
2542 		struct wlan_dfs_phyerr_param *param);
2543 #else
2544 static inline int dfs_get_thresholds(struct wlan_dfs *dfs,
2545 		struct wlan_dfs_phyerr_param *param)
2546 {
2547 		return 0;
2548 }
2549 #endif
2550 
2551 /**
2552  * dfs_set_thresholds() - Sets the threshold value.
2553  * @dfs: Pointer to wlan_dfs structure.
2554  * @threshtype: DFS ioctl param type.
2555  * @value: Threshold value.
2556  */
2557 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2558 int dfs_set_thresholds(struct wlan_dfs *dfs,
2559 		const uint32_t threshtype,
2560 		const uint32_t value);
2561 #else
2562 static inline int dfs_set_thresholds(struct wlan_dfs *dfs,
2563 		const uint32_t threshtype,
2564 		const uint32_t value)
2565 {
2566 		return 0;
2567 }
2568 #endif
2569 
2570 /**
2571  * dfs_check_intersect_excl() - Check whether curfreq falls within lower_freq
2572  * and upper_freq, exclusively.
2573  * @low_freq : lower bound frequency value.
2574  * @high_freq: upper bound frequency value.
2575  * @chan_freq: Current frequency value to be checked.
2576  *
2577  * Return: returns true if overlap found, else returns false.
2578  */
2579 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2580 bool dfs_check_intersect_excl(int low_freq, int high_freq, int chan_freq);
2581 #else
2582 static inline bool dfs_check_intersect_excl(int low_freq, int high_freq,
2583 					    int chan_freq)
2584 {
2585 		return false;
2586 }
2587 #endif
2588 
2589 /**
2590  * dfs_check_etsi_overlap() - Check whether given frequency centre/channel
2591  * width entry overlap with frequency spread in any way.
2592  * @center_freq         : current channel centre frequency.
2593  * @chan_width          : current channel width.
2594  * @en302_502_freq_low  : overlap frequency lower bound.
2595  * @en302_502_freq_high : overlap frequency upper bound.
2596  *
2597  * Return: returns 1 if overlap found, else returns 0.
2598  */
2599 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2600 int dfs_check_etsi_overlap(int center_freq, int chan_width,
2601 			   int en302_502_freq_low, int en302_502_freq_high);
2602 #else
2603 static inline int dfs_check_etsi_overlap(int center_freq, int chan_width,
2604 					 int en302_502_freq_low,
2605 					 int en302_502_freq_high)
2606 {
2607 		return 0;
2608 }
2609 #endif
2610 
2611 /**
2612  * dfs_is_en302_502_applicable() - Check whether current channel frequecy spread
2613  *					overlaps with EN 302 502 radar type
2614  *					frequency range.
2615  *@dfs: Pointer to wlan_dfs structure.
2616  *
2617  * Return: returns true if overlap found, else returns false.
2618  */
2619 #if defined(WLAN_DFS_PARTIAL_OFFLOAD)
2620 bool dfs_is_en302_502_applicable(struct wlan_dfs *dfs);
2621 #else
2622 static inline bool dfs_is_en302_502_applicable(struct wlan_dfs *dfs)
2623 {
2624 		return false;
2625 }
2626 #endif
2627 
2628 #ifdef CONFIG_CHAN_FREQ_API
2629 /**
2630  * dfs_set_current_channel_for_freq() - Set DFS current channel.
2631  * @dfs: Pointer to wlan_dfs structure.
2632  * @dfs_chan_freq: Frequency in Mhz.
2633  * @dfs_chan_flags: Channel flags.
2634  * @dfs_chan_flagext: Extended channel flags.
2635  * @dfs_chan_ieee: IEEE channel number.
2636  * @dfs_chan_vhtop_freq_seg1: Channel Center frequency1.
2637  * @dfs_chan_vhtop_freq_seg2: Channel Center frequency2.
2638  * @dfs_chan_mhz_freq_seg1: Channel center frequency of primary segment in MHZ.
2639  * @dfs_chan_mhz_freq_seg2: Channel center frequency of secondary segment in MHZ
2640  *                          applicable only for 80+80MHZ mode of operation.
2641  * @dfs_chan_op_puncture_bitmap: Static channel puncturing of current channel.
2642  * @is_channel_updated: boolean to represent channel update.
2643  */
2644 void dfs_set_current_channel_for_freq(struct wlan_dfs *dfs,
2645 				      uint16_t dfs_chan_freq,
2646 				      uint64_t dfs_chan_flags,
2647 				      uint16_t dfs_chan_flagext,
2648 				      uint8_t dfs_chan_ieee,
2649 				      uint8_t dfs_chan_vhtop_freq_seg1,
2650 				      uint8_t dfs_chan_vhtop_freq_seg2,
2651 				      uint16_t dfs_chan_mhz_freq_seg1,
2652 				      uint16_t dfs_chan_mhz_freq_seg2,
2653 				      uint16_t dfs_chan_op_puncture_bitmap,
2654 				      bool *is_channel_updated);
2655 #endif
2656 /**
2657  * dfs_get_nol_chfreq_and_chwidth() - Get channel freq and width from NOL list.
2658  * @dfs_nol: Pointer to NOL channel entry.
2659  * @nol_chfreq: Pointer to save channel frequency.
2660  * @nol_chwidth: Pointer to save channel width.
2661  * @index: Index to dfs_nol list.
2662  */
2663 void dfs_get_nol_chfreq_and_chwidth(struct dfsreq_nolelem *dfs_nol,
2664 		uint32_t *nol_chfreq,
2665 		uint32_t *nol_chwidth,
2666 		int index);
2667 
2668 /**
2669  * bin5_rules_check_internal() - This is a extension of dfs_bin5_check().
2670  * @dfs: Pointer to wlan_dfs structure.
2671  * @br: Pointer to dfs_bin5radars structure.
2672  * @bursts: Bursts.
2673  * @numevents: Number of events.
2674  * @prev: prev index.
2675  * @i: Index.
2676  * @this: index to br_elems[]
2677  */
2678 void bin5_rules_check_internal(struct wlan_dfs *dfs,
2679 		struct dfs_bin5radars *br,
2680 		uint32_t *bursts,
2681 		uint32_t *numevents,
2682 		uint32_t prev,
2683 		uint32_t i,
2684 		uint32_t this,
2685 		int *index);
2686 
2687 /**
2688  * dfs_main_task_testtimer_init() - Initialize dfs task testtimer.
2689  * @dfs: Pointer to wlan_dfs structure.
2690  */
2691 void dfs_main_task_testtimer_init(struct wlan_dfs *dfs);
2692 
2693 /**
2694  * dfs_stop() - Clear dfs timers.
2695  * @dfs: Pointer to wlan_dfs structure.
2696  */
2697 void dfs_stop(struct wlan_dfs *dfs);
2698 
2699 /**
2700  * dfs_update_cur_chan_flags() - Update DFS channel flag and flagext.
2701  * @dfs: Pointer to wlan_dfs structure.
2702  * @flags: New channel flags
2703  * @flagext: New Extended flags
2704  */
2705 void dfs_update_cur_chan_flags(struct wlan_dfs *dfs,
2706 		uint64_t flags,
2707 		uint16_t flagext);
2708 
2709 /**
2710  * wlan_psoc_get_dfs_txops() - Get dfs_tx_ops pointer
2711  * @psoc: Pointer to psoc structure.
2712  *
2713  * Return: Pointer to dfs_tx_ops.
2714  */
2715 struct wlan_lmac_if_dfs_tx_ops *
2716 wlan_psoc_get_dfs_txops(struct wlan_objmgr_psoc *psoc);
2717 
2718 /**
2719  * dfs_nol_free_list() - Free NOL elements.
2720  * @dfs: Pointer to wlan_dfs structure.
2721  */
2722 void dfs_nol_free_list(struct wlan_dfs *dfs);
2723 
2724 /**
2725  * dfs_second_segment_radar_disable() - Disables the second segment radar.
2726  * @dfs: Pointer to wlan_dfs structure.
2727  *
2728  * This is called when AP detects the radar, to (potentially) disable
2729  * the radar code.
2730  *
2731  * Return: returns 0.
2732  */
2733 int dfs_second_segment_radar_disable(struct wlan_dfs *dfs);
2734 
2735 /**
2736  * dfs_fetch_nol_ie_info() - Fill NOL information to be sent with RCSA.
2737  * @dfs                    - Pointer to wlan_dfs structure.
2738  * @nol_ie_bandwidth       - Minimum subchannel bandwidth.
2739  * @nol_ie_startfreq       - Radar affected channel list's first subchannel's
2740  *                         - centre frequency.
2741  * @nol_ie_bitmap          - NOL bitmap denoting affected subchannels.
2742  */
2743 #if defined(QCA_DFS_RCSA_SUPPORT)
2744 void dfs_fetch_nol_ie_info(struct wlan_dfs *dfs, uint8_t *nol_ie_bandwidth,
2745 			   uint16_t *nol_ie_startfreq, uint8_t *nol_ie_bitmap);
2746 #else
2747 static inline
2748 void dfs_fetch_nol_ie_info(struct wlan_dfs *dfs, uint8_t *nol_ie_bandwidth,
2749 			   uint16_t *nol_ie_startfreq, uint8_t *nol_ie_bitmap)
2750 {
2751 	*nol_ie_bandwidth = 0;
2752 	*nol_ie_startfreq = 0;
2753 	*nol_ie_bitmap = 0;
2754 }
2755 #endif
2756 
2757 /**
2758  * dfs_set_rcsa_flags() - Set flags that are required for sending RCSA and
2759  * NOL IE.
2760  * @dfs: Pointer to wlan_dfs structure.
2761  * @is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
2762  * @is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
2763  */
2764 #if defined(QCA_DFS_RCSA_SUPPORT)
2765 void dfs_set_rcsa_flags(struct wlan_dfs *dfs, bool is_rcsa_ie_sent,
2766 			bool is_nol_ie_sent);
2767 #else
2768 static inline
2769 void dfs_set_rcsa_flags(struct wlan_dfs *dfs, bool is_rcsa_ie_sent,
2770 			bool is_nol_ie_sent)
2771 {
2772 }
2773 #endif
2774 
2775 /**
2776  * dfs_get_rcsa_flags() - Get flags that are required for sending RCSA and
2777  * NOL IE.
2778  * @dfs: Pointer to wlan_dfs structure.
2779  * @is_rcsa_ie_sent: Boolean to check if RCSA IE should be sent or not.
2780  * @is_nol_ie_sent: Boolean to check if NOL IE should be sent or not.
2781  */
2782 #if defined(QCA_DFS_RCSA_SUPPORT)
2783 void dfs_get_rcsa_flags(struct wlan_dfs *dfs, bool *is_rcsa_ie_sent,
2784 			bool *is_nol_ie_sent);
2785 #else
2786 static inline
2787 void dfs_get_rcsa_flags(struct wlan_dfs *dfs, bool *is_rcsa_ie_sent,
2788 			bool *is_nol_ie_sent)
2789 {
2790 	*is_rcsa_ie_sent = false;
2791 	*is_nol_ie_sent = false;
2792 }
2793 #endif
2794 
2795 /**
2796  * dfs_process_nol_ie_bitmap() - Update NOL with external radar information.
2797  * @dfs               - Pointer to wlan_dfs structure.
2798  * @nol_ie_bandwidth  - Minimum subchannel bandwidth.
2799  * @nol_ie_starfreq   - Radar affected channel list's first subchannel's
2800  *                    - centre frequency.
2801  * @nol_ie_bitmap     - Bitmap denoting radar affected subchannels.
2802  *
2803  * Return: True if NOL IE should be propagated, else false.
2804  */
2805 #if defined(QCA_DFS_RCSA_SUPPORT)
2806 bool dfs_process_nol_ie_bitmap(struct wlan_dfs *dfs, uint8_t nol_ie_bandwidth,
2807 			       uint16_t nol_ie_startfreq,
2808 			       uint8_t nol_ie_bitmap);
2809 #else
2810 static inline
2811 bool dfs_process_nol_ie_bitmap(struct wlan_dfs *dfs, uint8_t nol_ie_bandwidth,
2812 			       uint16_t nol_ie_startfreq,
2813 			       uint8_t nol_ie_bitmap)
2814 {
2815 	return false;
2816 }
2817 #endif
2818 
2819 /**
2820  * dfs_task_testtimer_reset() - stop dfs test timer.
2821  * @dfs: Pointer to wlan_dfs structure.
2822  */
2823 void dfs_task_testtimer_reset(struct wlan_dfs *dfs);
2824 
2825 /**
2826  * dfs_is_freq_in_nol() - check if given channel in nol list
2827  * @dfs: Pointer to wlan_dfs structure
2828  * @freq: channel frequency
2829  *
2830  * check if given channel in nol list.
2831  *
2832  * Return: true if channel in nol, false else
2833  */
2834 bool dfs_is_freq_in_nol(struct wlan_dfs *dfs, uint32_t freq);
2835 
2836 /**
2837  * dfs_task_testtimer_detach() - Free dfs test timer.
2838  * @dfs: Pointer to wlan_dfs structure.
2839  */
2840 void dfs_task_testtimer_detach(struct wlan_dfs *dfs);
2841 
2842 /**
2843  * dfs_timer_detach() - Free dfs timers.
2844  * @dfs: Pointer to wlan_dfs structure.
2845  */
2846 void dfs_timer_detach(struct wlan_dfs *dfs);
2847 
2848 /**
2849  * dfs_is_disable_radar_marking_set() - Check if radar marking is set on
2850  * NOL chan.
2851  * @dfs: Pointer to wlan_dfs structure.
2852  */
2853 #if defined(WLAN_DFS_FULL_OFFLOAD) && defined(QCA_DFS_NOL_OFFLOAD)
2854 int dfs_is_disable_radar_marking_set(struct wlan_dfs *dfs,
2855 				     bool *disable_radar_marking);
2856 #else
2857 static inline int dfs_is_disable_radar_marking_set(struct wlan_dfs *dfs,
2858 						   bool *disable_radar_marking)
2859 {
2860 	return QDF_STATUS_SUCCESS;
2861 }
2862 #endif
2863 /**
2864  * dfs_get_disable_radar_marking() - Get the value of disable radar marking.
2865  * @dfs: Pointer to wlan_dfs structure.
2866  */
2867 #if defined(WLAN_DFS_FULL_OFFLOAD) && defined(QCA_DFS_NOL_OFFLOAD)
2868 bool dfs_get_disable_radar_marking(struct wlan_dfs *dfs);
2869 #else
2870 static inline bool dfs_get_disable_radar_marking(struct wlan_dfs *dfs)
2871 {
2872 	return false;
2873 }
2874 #endif
2875 
2876 /**
2877  * dfs_reset_agile_config() - Reset the ADFS config variables.
2878  * @dfs: Pointer to dfs_soc_priv_obj.
2879  */
2880 #ifdef QCA_SUPPORT_AGILE_DFS
2881 void dfs_reset_agile_config(struct dfs_soc_priv_obj *dfs_soc);
2882 #endif
2883 
2884 /**
2885  * dfs_reinit_timers() - Reinit timers in DFS.
2886  * @dfs: Pointer to wlan_dfs.
2887  */
2888 int dfs_reinit_timers(struct wlan_dfs *dfs);
2889 
2890 /**
2891  * dfs_reset_dfs_prevchan() - Reset DFS previous channel structure.
2892  * @dfs: Pointer to wlan_dfs object.
2893  *
2894  * Return: None.
2895  */
2896 void dfs_reset_dfs_prevchan(struct wlan_dfs *dfs);
2897 
2898 /**
2899  * dfs_init_tmp_psoc_nol() - Init temporary psoc NOL structure.
2900  * @dfs: Pointer to wlan_dfs object.
2901  * @num_radios: Num of radios in the PSOC.
2902  *
2903  * Return: void.
2904  */
2905 void dfs_init_tmp_psoc_nol(struct wlan_dfs *dfs, uint8_t num_radios);
2906 
2907 /**
2908  * dfs_deinit_tmp_psoc_nol() - De-init temporary psoc NOL structure.
2909  * @dfs: Pointer to wlan_dfs object.
2910  *
2911  * Return: void.
2912  */
2913 void dfs_deinit_tmp_psoc_nol(struct wlan_dfs *dfs);
2914 
2915 /**
2916  * dfs_save_dfs_nol_in_psoc() - Save NOL data of given pdev.
2917  * @dfs: Pointer to wlan_dfs object.
2918  * @pdev_id: The pdev ID which will have the NOL data.
2919  *
2920  * Based on the frequency of the NOL channel, copy it to the target pdev_id
2921  * structure in psoc.
2922  *
2923  * Return: void.
2924  */
2925 void dfs_save_dfs_nol_in_psoc(struct wlan_dfs *dfs, uint8_t pdev_id);
2926 
2927 /**
2928  * dfs_reinit_nol_from_psoc_copy() - Reinit saved NOL data to corresponding
2929  * DFS object.
2930  * @dfs: Pointer to wlan_dfs object.
2931  * @pdev_id: pdev_id of the given dfs object.
2932  * @low_5ghz_freq: The low 5GHz frequency value of the target pdev id.
2933  * @high_5ghz_freq: The high 5GHz frequency value of the target pdev id.
2934  *
2935  * Return: void.
2936  */
2937 void dfs_reinit_nol_from_psoc_copy(struct wlan_dfs *dfs,
2938 				   uint8_t pdev_id,
2939 				   uint16_t low_5ghz_freq,
2940 				   uint16_t high_5ghz_freq);
2941 
2942 /**
2943  * dfs_is_hw_mode_switch_in_progress() - Check if HW mode switch in progress.
2944  * @dfs: Pointer to wlan_dfs object.
2945  *
2946  * Return: True if mode switch is in progress, else false.
2947  */
2948 #ifdef QCA_HW_MODE_SWITCH
2949 bool dfs_is_hw_mode_switch_in_progress(struct wlan_dfs *dfs);
2950 #else
2951 static inline
2952 bool dfs_is_hw_mode_switch_in_progress(struct wlan_dfs *dfs)
2953 {
2954 	return false;
2955 }
2956 #endif
2957 
2958 /**
2959  * dfs_start_mode_switch_defer_timer() - start mode switch defer timer.
2960  * @dfs: Pointer to wlan_dfs object.
2961  *
2962  * Return: void.
2963  */
2964 void dfs_start_mode_switch_defer_timer(struct wlan_dfs *dfs);
2965 
2966 /**
2967  * dfs_complete_deferred_tasks() - Process mode switch completion event and
2968  * handle deferred tasks.
2969  * @dfs: Pointer to wlan_dfs object.
2970  *
2971  * Return: void.
2972  */
2973 void dfs_complete_deferred_tasks(struct wlan_dfs *dfs);
2974 
2975 /**
2976  * dfs_process_cac_completion() - Process DFS CAC completion event.
2977  * @dfs: Pointer to wlan_dfs object.
2978  *
2979  * Return: void.
2980  */
2981 void dfs_process_cac_completion(struct wlan_dfs *dfs);
2982 
2983 #ifdef WLAN_DFS_TRUE_160MHZ_SUPPORT
2984 /**
2985  * dfs_is_true_160mhz_supported() - Find if true 160MHz is supported.
2986  * @dfs: Pointer to wlan_dfs object.
2987  *
2988  * Return: True if true 160MHz is supported, else false.
2989  */
2990 bool dfs_is_true_160mhz_supported(struct wlan_dfs *dfs);
2991 
2992 /**
2993  * dfs_is_restricted_80p80mhz_supported() - Find if restricted 80p80mhz is
2994  * supported.
2995  * @dfs: Pointer to wlan_dfs object.
2996  *
2997  * Return: True if restricted 160MHz is supported, else false.
2998  */
2999 bool dfs_is_restricted_80p80mhz_supported(struct wlan_dfs *dfs);
3000 #else
3001 static inline bool dfs_is_true_160mhz_supported(struct wlan_dfs *dfs)
3002 {
3003 	return false;
3004 }
3005 
3006 static inline bool dfs_is_restricted_80p80mhz_supported(struct wlan_dfs *dfs)
3007 {
3008 	return false;
3009 }
3010 #endif /* WLAN_DFS_TRUE_160MHZ_SUPPORT */
3011 
3012 /**
3013  * dfs_get_agile_detector_id() - Find the Agile detector ID for given DFS.
3014  * @dfs: Pointer to wlan_dfs object.
3015  *
3016  * Return: Agile detector value (uint8_t).
3017  */
3018 #ifdef QCA_SUPPORT_AGILE_DFS
3019 uint8_t dfs_get_agile_detector_id(struct wlan_dfs *dfs);
3020 #else
3021 static inline uint8_t dfs_get_agile_detector_id(struct wlan_dfs *dfs)
3022 {
3023 	return INVALID_DETECTOR_ID;
3024 }
3025 #endif
3026 
3027 /**
3028  * dfs_is_new_chan_subset_of_old_chan() - Find if new channel is subset of
3029  *                                        old channel.
3030  * @dfs: Pointer to wlan_dfs structure.
3031  * @new_chan: Pointer to new channel of dfs_channel structure.
3032  * @old_chan: Pointer to old channel of dfs_channel structure.
3033  *
3034  * Return: True if new channel is subset of old channel, else false.
3035  */
3036 bool dfs_is_new_chan_subset_of_old_chan(struct wlan_dfs *dfs,
3037 					struct dfs_channel *new_chan,
3038 					struct dfs_channel *old_chan);
3039 
3040 /**
3041  * dfs_find_dfs_sub_channels_for_freq() - Given a dfs channel, find its
3042  *                                        HT20 subset channels.
3043  * @dfs: Pointer to wlan_dfs structure.
3044  * @chan: Pointer to dfs_channel structure.
3045  * @subchan_arr: Pointer to subchannels array.
3046  *
3047  * Return: Number of sub channels.
3048  */
3049 uint8_t dfs_find_dfs_sub_channels_for_freq(struct  wlan_dfs *dfs,
3050 					   struct dfs_channel *chan,
3051 					   uint16_t *subchan_arr);
3052 
3053 /**
3054  * dfs_clear_cac_started_chan() - Clear dfs cac started channel.
3055  * @dfs: Pointer to wlan_dfs structure.
3056  */
3057 void dfs_clear_cac_started_chan(struct wlan_dfs *dfs);
3058 
3059 #ifdef QCA_DFS_BANGRADAR
3060 /**
3061  * dfs_bangradar() - Handles all type of Bangradar.
3062  * @dfs: Pointer to wlan_dfs structure.
3063  * @indata: reference to input data
3064  * @insize:  input data size
3065  *
3066  */
3067 int dfs_bang_radar(struct wlan_dfs *dfs, void *indata, uint32_t insize);
3068 #else
3069 static inline int
3070 dfs_bang_radar(struct wlan_dfs *dfs, void *indata, uint32_t insize)
3071 {
3072 	return 0;
3073 }
3074 #endif
3075 
3076 #if defined(QCA_SUPPORT_DFS_CHAN_POSTNOL)
3077 void dfs_postnol_attach(struct wlan_dfs *dfs);
3078 #else
3079 static inline void dfs_postnol_attach(struct wlan_dfs *dfs)
3080 {
3081 }
3082 #endif
3083 
3084 #ifdef CONFIG_HOST_FIND_CHAN
3085 /**
3086  * wlan_is_chan_radar() - Checks if a given dfs channel is in NOL or not.
3087  * @dfs: Pointer to wlan_dfs structure.
3088  * @chan: Pointer to the dfs channel structure.
3089  *
3090  * Return: True if the channel has detected radar, else false.
3091  */
3092 bool wlan_is_chan_radar(struct wlan_dfs *dfs, struct dfs_channel *chan);
3093 
3094 /**
3095  * wlan_is_chan_history_radar() - Checks if a given dfs channel is in NOL
3096  * history or not.
3097  * @dfs: Pointer to wlan_dfs structure.
3098  * @chan: Pointer to the dfs channel structure.
3099  *
3100  * Return: True if the channel is marked as radar history, else false.
3101  */
3102 bool wlan_is_chan_history_radar(struct wlan_dfs *dfs, struct dfs_channel *chan);
3103 #else
3104 static inline bool
3105 wlan_is_chan_radar(struct wlan_dfs *dfs, struct dfs_channel *chan)
3106 {
3107 	return false;
3108 }
3109 
3110 static inline bool
3111 wlan_is_chan_history_radar(struct wlan_dfs *dfs, struct dfs_channel *chan)
3112 {
3113 	return false;
3114 }
3115 #endif /* CONFIG_HOST_FIND_CHAN */
3116 
3117 #if defined(QCA_SUPPORT_ADFS_RCAC) && \
3118 	defined(WLAN_DFS_PRECAC_AUTO_CHAN_SUPPORT) && \
3119 	defined(QCA_SUPPORT_AGILE_DFS)
3120 /**
3121  * dfs_restart_rcac_on_nol_expiry() - If the chosen desired channel is
3122  * radar infected during RCAC, trigger RCAC on desired channel after
3123  * NOL expiry.
3124  * @dfs: Pointer to wlan_dfs structure.
3125  *
3126  * Return: True if rcac is started, false otherwise
3127  */
3128 bool dfs_restart_rcac_on_nol_expiry(struct wlan_dfs *dfs);
3129 #else
3130 static inline bool
3131 dfs_restart_rcac_on_nol_expiry(struct wlan_dfs *dfs)
3132 {
3133 	return false;
3134 }
3135 #endif
3136 
3137 /**
3138  * dfs_chan_to_ch_width: Outputs the channel width in MHz of the given input
3139  * dfs_channel.
3140  *
3141  * chan: Pointer to the input dfs_channel structure.
3142  *
3143  * Return: Channel width in MHz. (uint16) -EINVAL on invalid channel.
3144  */
3145 uint16_t dfs_chan_to_ch_width(struct dfs_channel *chan);
3146 #endif  /* _DFS_H_ */
3147