xref: /wlan-dirver/qca-wifi-host-cmn/umac/cfr/dispatcher/inc/wlan_cfr_utils_api.h (revision 6d768494e5ce14eb1603a695c86739d12ecc6ec2)
1 
2 /*
3  * Copyright (c) 2019-2020 The Linux Foundation. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 #ifndef _WLAN_CFR_UTILS_API_H_
21 #define _WLAN_CFR_UTILS_API_H_
22 
23 #include <wlan_objmgr_cmn.h>
24 #include <qdf_streamfs.h>
25 #ifdef WLAN_ENH_CFR_ENABLE
26 #include <qdf_timer.h>
27 #endif
28 
29 #define cfr_alert(format, args...) \
30 		QDF_TRACE_FATAL(QDF_MODULE_ID_CFR, format, ## args)
31 
32 #define cfr_err(format, args...) \
33 		QDF_TRACE_ERROR(QDF_MODULE_ID_CFR, format, ## args)
34 
35 #define cfr_warn(format, args...) \
36 		QDF_TRACE_WARN(QDF_MODULE_ID_CFR, format, ## args)
37 
38 #define cfr_info(format, args...) \
39 		QDF_TRACE_INFO(QDF_MODULE_ID_CFR, format, ## args)
40 
41 #define cfr_debug(format, args...) \
42 		QDF_TRACE_DEBUG(QDF_MODULE_ID_CFR, format, ## args)
43 
44 #define DBR_EVENT_TIMEOUT_IN_MS_CFR 1
45 #define DBR_NUM_RESP_PER_EVENT_CFR 1
46 #define MAX_CFR_ENABLED_CLIENTS 10
47 #ifdef WLAN_ENH_CFR_ENABLE
48 #define MAX_CFR_MU_USERS 4
49 #define NUM_CHAN_CAPTURE_STATUS 4
50 #define NUM_CHAN_CAPTURE_REASON 6
51 #define MAX_TA_RA_ENTRIES 16
52 #define MAX_RESET_CFG_ENTRY 0xFFFF
53 #define CFR_INVALID_VDEV_ID 0xff
54 #define DEFAULT_SRNGID_CFR 0
55 #endif
56 
57 enum cfrmetaversion {
58 	CFR_META_VERSION_NONE,
59 	CFR_META_VERSION_1,
60 	CFR_META_VERSION_2,
61 	CFR_META_VERSION_3,
62 	CFR_META_VERSION_MAX = 0xFF,
63 };
64 
65 enum cfrdataversion {
66 	CFR_DATA_VERSION_NONE,
67 	CFR_DATA_VERSION_1,
68 	CFR_DATA_VERSION_MAX = 0xFF,
69 };
70 
71 enum cfrplatformtype {
72 	CFR_PLATFORM_TYPE_NONE,
73 	CFR_PLATFORM_TYPE_MIPS,
74 	CFR_PLATFORM_TYPE_ARM,
75 	CFR_PLATFFORM_TYPE_MAX = 0xFF,
76 };
77 
78 enum cfrradiotype {
79 	CFR_CAPTURE_RADIO_NONE,
80 	CFR_CAPTURE_RADIO_OSPREY,
81 	CFR_CAPTURE_RADIO_PEAKCOCK,
82 	CFR_CAPTURE_RADIO_SCORPION,
83 	CFR_CAPTURE_RADIO_HONEYBEE,
84 	CFR_CAPTURE_RADIO_DRAGONFLY,
85 	CFR_CAPTURE_RADIO_JET,
86 	CFR_CAPTURE_RADIO_PEREGRINE = 17,
87 	CFR_CAPTURE_RADIO_SWIFT,
88 	CFR_CAPTURE_RADIO_BEELINER,
89 	CFR_CAPTURE_RADIO_CASCADE,
90 	CFR_CAPTURE_RADIO_DAKOTA,
91 	CFR_CAPTURE_RADIO_BESRA,
92 	CFR_CAPTURE_RADIO_HKV2,
93 	CFR_CAPTURE_RADIO_CYP,
94 	CFR_CAPTURE_RADIO_HSP,
95 	CFR_CAPTURE_RADIO_PINE,
96 	CFR_CAPTURE_RADIO_MAX = 0xFF,
97 };
98 
99 enum ack_capture_mode {
100 	CFR_LEGACY_ACK     = 0,
101 	CFR_DUP_LEGACY_ACK = 1,
102 	CFR_HT_ACK         = 2,
103 	CFR_VHT_ACK        = 3,
104 	CFR_INVALID_ACK, /*Always keep this at last*/
105 };
106 
107 /* Similar to WMI_PEER_CFR_CAPTURE_METHOD used in one-shot capture */
108 enum cfr_capture_type {
109 	CFR_TYPE_METHOD_NULL_FRAME = 0,
110 	CFR_TYPE_METHOD_NULL_FRAME_WITH_PHASE = 1,
111 	CFR_TYPE_METHOD_PROBE_RESP = 2,
112 	CFR_TYPE_METHOD_TM = 3,
113 	CFR_TYPE_METHOD_FTM = 4,
114 	CFR_TYPE_METHOD_ACK_RESP_TO_TM_FTM = 5,
115 	CFR_TYPE_METHOD_TA_RA_TYPE_FILTER = 6,
116 	CFR_TYPE_METHOD_NDPA_NDP = 7,
117 	CFR_TYPE_METHOD_ALL_PACKET = 8,
118 	/* Add new capture methods before this line */
119 	CFR_TYPE_METHOD_LAST_VALID,
120 	CFR_TYPE_METHOD_AUTO = 0xff,
121 	CFR_TYPE_METHOD_MAX,
122 };
123 
124 struct cfr_metadata_version_1 {
125 	u_int8_t    peer_addr[QDF_MAC_ADDR_SIZE];
126 	u_int8_t    status;
127 	u_int8_t    capture_bw;
128 	u_int8_t    channel_bw;
129 	u_int8_t    phy_mode;
130 	u_int16_t   prim20_chan;
131 	u_int16_t   center_freq1;
132 	u_int16_t   center_freq2;
133 	u_int8_t    capture_mode;
134 	u_int8_t    capture_type;
135 	u_int8_t    sts_count;
136 	u_int8_t    num_rx_chain;
137 	u_int32_t   timestamp;
138 	u_int32_t   length;
139 } __attribute__ ((__packed__));
140 
141 #define HOST_MAX_CHAINS 8
142 
143 struct cfr_metadata_version_2 {
144 	u_int8_t    peer_addr[QDF_MAC_ADDR_SIZE];
145 	u_int8_t    status;
146 	u_int8_t    capture_bw;
147 	u_int8_t    channel_bw;
148 	u_int8_t    phy_mode;
149 	u_int16_t   prim20_chan;
150 	u_int16_t   center_freq1;
151 	u_int16_t   center_freq2;
152 	u_int8_t    capture_mode;
153 	u_int8_t    capture_type;
154 	u_int8_t    sts_count;
155 	u_int8_t    num_rx_chain;
156 	u_int32_t   timestamp;
157 	u_int32_t   length;
158 	u_int32_t   chain_rssi[HOST_MAX_CHAINS];
159 	u_int16_t   chain_phase[HOST_MAX_CHAINS];
160 } __attribute__ ((__packed__));
161 
162 #ifdef WLAN_ENH_CFR_ENABLE
163 struct cfr_metadata_version_3 {
164 	u_int8_t    status;
165 	u_int8_t    capture_bw;
166 	u_int8_t    channel_bw;
167 	u_int8_t    phy_mode;
168 	u_int16_t   prim20_chan;
169 	u_int16_t   center_freq1;
170 	u_int16_t   center_freq2;
171 	u_int8_t    capture_mode; /* ack_capture_mode */
172 	u_int8_t    capture_type; /* cfr_capture_type */
173 	u_int8_t    sts_count;
174 	u_int8_t    num_rx_chain;
175 	u_int32_t   timestamp;
176 	u_int32_t   length;
177 	u_int8_t    is_mu_ppdu;
178 	u_int8_t    num_mu_users;
179 	union {
180 		u_int8_t    su_peer_addr[QDF_MAC_ADDR_SIZE];
181 		u_int8_t    mu_peer_addr[MAX_CFR_MU_USERS][QDF_MAC_ADDR_SIZE];
182 	} peer_addr;
183 	u_int32_t   chain_rssi[HOST_MAX_CHAINS];
184 	u_int16_t   chain_phase[HOST_MAX_CHAINS];
185 } __attribute__ ((__packed__));
186 #endif
187 
188 struct csi_cfr_header {
189 	u_int32_t   start_magic_num;
190 	u_int32_t   vendorid;
191 	u_int8_t    cfr_metadata_version;
192 	u_int8_t    cfr_data_version;
193 	u_int8_t    chip_type;
194 	u_int8_t    pltform_type;
195 	u_int32_t   Reserved;
196 
197 	union {
198 		struct cfr_metadata_version_1 meta_v1;
199 		struct cfr_metadata_version_2 meta_v2;
200 #ifdef WLAN_ENH_CFR_ENABLE
201 		struct cfr_metadata_version_3 meta_v3;
202 #endif
203 	} u;
204 } __attribute__ ((__packed__));
205 
206 /**
207  * struct cfr_capture_params - structure to store cfr config param
208  * bandwidth: bandwitdh of capture
209  * period: period of capture
210  * method: enum of method being followed to capture cfr data. 0-QoS null data
211  */
212 struct cfr_capture_params {
213 	u_int8_t   bandwidth;
214 	u_int32_t  period;
215 	u_int8_t   method;
216 };
217 
218 /**
219  * struct psoc_cfr - private psoc object for cfr
220  * psoc_obj: pointer to psoc object
221  * is_cfr_capable: flag to determine if cfr is enabled or not
222  */
223 struct psoc_cfr {
224 	struct wlan_objmgr_psoc *psoc_obj;
225 	uint8_t is_cfr_capable;
226 };
227 
228 /**
229  * struct cfr_wmi_host_mem_chunk - wmi mem chunk related
230  * vaddr: pointer to virtual address
231  * paddr: physical address
232  * len: len of the mem chunk allocated
233  * req_id: reqid related to the mem chunk
234  */
235 struct cfr_wmi_host_mem_chunk {
236 	uint32_t *vaddr;
237 	uint32_t paddr;
238 	uint32_t len;
239 	uint32_t req_id;
240 };
241 
242 struct whal_cfir_dma_hdr {
243 	uint16_t
244 		// 'BA'
245 		tag                 : 8,
246 		// '02', length of header in 4 octet units
247 		length              : 6,
248 		// 00
249 		reserved            : 2;
250 	uint16_t
251 		// [16]
252 		upload_done         : 1,
253 		// [17:18], 0: invalid, 1: CFR, 2: CIR, 3: DebugH
254 		capture_type        : 3,
255 		// [19:20], 0: Legacy, 1: HT, 2: VHT, 3: HE
256 		preamble_type       : 2,
257 		// [21:23], 0: 1-stream, 1: 2-stream, ..., 7: 8-stream
258 		nss                 : 3,
259 		// [24:27], 0: invalid, 1: 1-chain, 2: 2-chain, etc.
260 		num_chains          : 3,
261 		// [28:30], 0: 20 MHz, 1: 40 MHz, 2: 80 MHz, 3: 160 MHz
262 		upload_pkt_bw       : 3,    // [31]
263 		sw_peer_id_valid    : 1;
264 	uint16_t
265 		sw_peer_id          : 16;   // [15:0]
266 	uint16_t
267 		phy_ppdu_id         : 16;   // [15:0]
268 };
269 
270 #define MAX_LUT_ENTRIES 140 /* For HKv2 136 is max */
271 
272 /**
273  * struct look_up_table - Placeholder for 2 asynchronous events (DBR and
274  * TXRX event)
275  * dbr_recv: Indicates whether WMI for DBR completion is received or not
276  * tx_recv: Indicates whether WMI for TX completion (or) WDI event for RX
277  * status is received or not
278  * data: pointer to CFR data that ucode DMAs to host memory
279  * data_len: length of CFR data DMAed by ucode
280  * dbr_ppdu_id: PPDU id retrieved from DBR completion WMI event
281  * tx_ppdu_id: PPDU id retrieved from WMI TX completion event (or) PPDU status
282  * TLV
283  * dbr_address: Physical address of the CFR data dump retrieved from DBR
284  * completion WMI event
285  * tx_address1: Physical address of the CFR data from TX/RX event
286  * tx_address2: Physical address of the CFR data from TX/RX event
287  * csi_cfr_header: CFR header constructed by host
288  * whal_cfir_enhanced_hdr: CFR header constructed by ucode
289  * tx_tstamp: Timestamp when TX/RX event was received
290  * dbr_tstamp: Timestamp when DBR completion event was received
291  * header_length: Length of header DMAed by ucode in words
292  * payload_length: Length of CFR payload
293  */
294 struct look_up_table {
295 	bool dbr_recv;
296 	bool tx_recv;
297 	uint8_t *data; /* capture payload */
298 	uint32_t data_len; /* capture len */
299 	uint16_t dbr_ppdu_id; /* ppdu id from dbr */
300 	uint16_t tx_ppdu_id; /* ppdu id from TX event */
301 	qdf_dma_addr_t dbr_address; /* capture len */
302 	uint32_t tx_address1; /* capture len */
303 	uint32_t tx_address2; /* capture len */
304 	struct csi_cfr_header header;
305 	struct whal_cfir_dma_hdr dma_hdr;
306 	uint64_t txrx_tstamp;
307 	uint64_t dbr_tstamp;
308 	uint32_t header_length;
309 	uint32_t payload_length;
310 };
311 
312 struct unassoc_pool_entry {
313 	struct qdf_mac_addr mac;
314 	struct cfr_capture_params cfr_params;
315 	bool is_valid;
316 };
317 
318 #ifdef WLAN_ENH_CFR_ENABLE
319 /**
320  * struct ta_ra_cfr_cfg - structure to store configuration of 16 groups in
321  * M_TA_RA mode
322  * filter_group_id: Filter group number for which the below filters needs to be
323  * applied
324  * bw: CFR capture will be done for packets matching the bandwidths specified
325  * within this bitmask
326  * nss: CFR capture will be done for packets matching the Nss specified within
327  * this bitmask
328  * valid_ta: Ta_addr is valid if set
329  * valid_ta_mask: Ta_addr_mask is valid if set
330  * valid_ra: Ra_addr is valid if set
331  * valid_ra_mask: Ra_addr_mask is valid if set
332  * valid_bw_mask: Bandwidth is valid if set
333  * valid_nss_mask: NSS is valid if set
334  * valid_mgmt_subtype: Mgmt_subtype is valid if set
335  * valid_ctrl_subtype: Ctrl_subtype is valid if set
336  * valid_data_subtype: Data_subtype is valid if set
337  * mgmt_subtype_filter: Managments Packets matching the subtype filter
338  * categories will be filtered in by MAC for CFR capture.
339  * ctrl_subtype_filter: Control Packets matching the subtype filter
340  * categories will be filtered in by MAC for CFR capture.
341  * data_subtype_filter: Data Packets matching the subtype filter
342  * categories will be filtered in by MAC for CFR capture.
343  * tx_addr: Packets whose transmitter address matches (tx_addr & tx_addr_mask)
344  * will be filtered in by MAC
345  * tx_addr_mask: Packets whose transmitter address matches (tx_addr &
346  * tx_addr_mask) will be filtered in by MAC
347  * rx_addr: Packets whose receiver address matches (rx_addr & rx_addr_mask)
348  * will be filtered in by MAC
349  * rx_addr_mask: Packets whose receiver address matches (rx_addr &
350  * rx_addr_mask) will be filtered in by MAC
351  */
352 struct ta_ra_cfr_cfg {
353 	uint8_t filter_group_id;
354 	uint16_t bw                          :5,
355 		 nss                         :8,
356 		 rsvd0                       :3;
357 	uint16_t valid_ta                    :1,
358 		 valid_ta_mask               :1,
359 		 valid_ra                    :1,
360 		 valid_ra_mask               :1,
361 		 valid_bw_mask               :1,
362 		 valid_nss_mask              :1,
363 		 valid_mgmt_subtype          :1,
364 		 valid_ctrl_subtype          :1,
365 		 valid_data_subtype          :1,
366 		 rsvd1                       :7;
367 	uint16_t mgmt_subtype_filter;
368 	uint16_t ctrl_subtype_filter;
369 	uint16_t data_subtype_filter;
370 	uint8_t tx_addr[QDF_MAC_ADDR_SIZE];
371 	uint8_t rx_addr[QDF_MAC_ADDR_SIZE];
372 	uint8_t tx_addr_mask[QDF_MAC_ADDR_SIZE];
373 	uint8_t rx_addr_mask[QDF_MAC_ADDR_SIZE];
374 
375 } qdf_packed;
376 
377 /**
378  * struct cfr_rcc_param - structure to store cfr config param
379  * pdev_id: pdev_id for identifying the MAC
380  * vdev_id: vdev_id of current rcc configures
381  * srng_id: srng id of current rcc configures
382  * capture_duration: Capture Duration field for which CFR capture has to happen,
383  * in microsecond units
384  * capture_interval: Capture interval field which is time in between
385  * consecutive CFR capture, in microsecond units
386  * ul_mu_user_mask_lower: Bitfields indicates which of the users in the current
387  * UL MU tranmission are enabled for CFR capture.
388  * ul_mu_user_mask_upper: This is contiuation of the above lower mask.
389  * freeze_tlv_delay_cnt_en: Enable Freeze TLV delay counter in MAC
390  * freeze_tlv_delay_cnt_thr: Indicates the number of consecutive Rx packets to
391  * be skipped before CFR capture is enabled again.
392  * filter_group_bitmap: Bitfields set indicates which of the CFR group config is
393  * enabled
394  * m_directed_ftm: Filter Directed FTM ACK frames for CFR capture
395  * m_all_ftm_ack: Filter All FTM ACK frames for CFR capture
396  * m_ndpa_ndp_directed: Filter NDPA NDP Directed Frames for CFR capture
397  * m_ndpa_ndp_all: Filter all NDPA NDP for CFR capture
398  * m_ta_ra_filter: Filter Frames based on TA/RA/Subtype as provided in CFR Group
399  * config
400  * m_all_packet: Filter in All packets for CFR Capture
401  * num_grp_tlvs: Indicates the number of groups in M_TA_RA mode, that have
402  * changes in the current commit session, use to construct WMI group TLV(s)
403  * curr: Placeholder for M_TA_RA group config in current commit session
404  * modified_in_curr_session: Bitmap indicating number of groups in M_TA_RA mode
405  * that have changed in current commit session.
406  */
407 struct cfr_rcc_param {
408 	uint8_t pdev_id;
409 	uint8_t vdev_id;
410 	uint8_t srng_id;
411 	uint32_t capture_duration;
412 	uint32_t capture_interval;
413 	uint32_t ul_mu_user_mask_lower;
414 	uint32_t ul_mu_user_mask_upper;
415 	uint16_t freeze_tlv_delay_cnt_en  :1,
416 		 freeze_tlv_delay_cnt_thr :8,
417 		 rsvd0 :7;
418 	uint16_t filter_group_bitmap;
419 	uint8_t m_directed_ftm      : 1,
420 		m_all_ftm_ack       : 1,
421 		m_ndpa_ndp_directed : 1,
422 		m_ndpa_ndp_all      : 1,
423 		m_ta_ra_filter      : 1,
424 		m_all_packet        : 1,
425 		rsvd1               : 2;
426 	uint8_t num_grp_tlvs;
427 
428 	struct ta_ra_cfr_cfg curr[MAX_TA_RA_ENTRIES];
429 	uint16_t modified_in_curr_session;
430 };
431 #endif /* WLAN_ENH_CFR_ENABLE */
432 
433 /**
434  * struct pdev_cfr - private pdev object for cfr
435  * pdev_obj: pointer to pdev object
436  * is_cfr_capable: flag to determine if cfr is enabled or not
437  * cfr_timer_enable: flag to enable/disable timer
438  * chip_type: chip type which is defined in enum cfrradiotype
439  * cfr_mem_chunk: Region of memory used for storing cfr data
440  * cfr_max_sta_count: Maximum stations supported in one-shot capture mode
441  * num_subbufs: No. of sub-buffers used in relayfs
442  * subbuf_size: Size of sub-buffer used in relayfs
443  * chan_ptr: Channel in relayfs
444  * dir_ptr: Parent directory of relayfs file
445  * lut: lookup table used to store asynchronous DBR and TX/RX events for
446  * correlation
447  * lut_num: Number of lut
448  * dbr_buf_size: Size of DBR completion buffer
449  * dbr_num_bufs: No. of DBR completions
450  * tx_evt_cnt: No. of TX completion events till CFR stop was issued
451  * total_tx_evt_cnt: No. of Tx completion events since wifi was up
452  * dbr_evt_cnt: No. of WMI DBR completion events
453  * release_cnt: No. of CFR data buffers relayed to userspace
454  * tx_peer_status_cfr_fail: No. of tx events without tx status set to
455  * PEER_CFR_CAPTURE_EVT_STATUS_MASK indicating CFR capture failure on a peer.
456  * tx_evt_status_cfr_fail: No. of tx events without tx status set to
457  * CFR_TX_EVT_STATUS_MASK indicating CFR capture status failure.
458  * tx_dbr_cookie_lookup_fail: No. of dbr cookie lookup failures during tx event
459  * process.
460  * rcc_param: Structure to store CFR config for the current commit session
461  * global: Structure to store accumulated CFR config
462  * rx_tlv_evt_cnt: Number of CFR WDI events from datapath
463  * lut_age_timer: Timer to flush pending TXRX/DBR events in lookup table
464  * lut_timer_init: flag to determine if lut_age_timer is initialized or not
465  * is_cfr_rcc_capable: Flag to determine if RCC is enabled or not.
466  * flush_dbr_cnt: No. of un-correlated DBR completions flushed when a newer PPDU
467  * is correlated successfully with newer DBR completion
468  * invalid_dma_length_cnt: No. of buffers for which CFR DMA header length (or)
469  * data length was invalid
470  * flush_timeout_dbr_cnt: No. of DBR completion flushed out in ageout logic
471  * clear_txrx_event: No. of PPDU status TLVs over-written in LUT
472  * last_success_tstamp: DBR timestamp which indicates that both DBR and TX/RX
473  * events have been received successfully.
474  * cfr_dma_aborts: No. of CFR DMA aborts in ucode
475  * unassoc_pool: Pool of un-associated clients used when capture method is
476  * CFR_CAPTURE_METHOD_PROBE_RESPONSE
477  * lut_lock: Lock to protect access to cfr lookup table
478  */
479 /*
480  * To be extended if we get more capbality info
481  * from FW's extended service ready event.
482  */
483 struct pdev_cfr {
484 	struct wlan_objmgr_pdev *pdev_obj;
485 	uint8_t is_cfr_capable;
486 	uint8_t cfr_timer_enable;
487 	uint8_t chip_type;
488 	struct cfr_wmi_host_mem_chunk cfr_mem_chunk;
489 	uint16_t cfr_max_sta_count;
490 	uint16_t cfr_current_sta_count;
491 	uint32_t num_subbufs;
492 	uint32_t subbuf_size;
493 	qdf_streamfs_chan_t chan_ptr;
494 	qdf_dentry_t dir_ptr;
495 	struct look_up_table **lut;
496 	uint32_t lut_num;
497 	uint32_t dbr_buf_size;
498 	uint32_t dbr_num_bufs;
499 	uint64_t tx_evt_cnt;
500 	uint64_t total_tx_evt_cnt;
501 	uint64_t dbr_evt_cnt;
502 	uint64_t release_cnt;
503 	uint64_t tx_peer_status_cfr_fail;
504 	uint64_t tx_evt_status_cfr_fail;
505 	uint64_t tx_dbr_cookie_lookup_fail;
506 #ifdef WLAN_ENH_CFR_ENABLE
507 	struct cfr_rcc_param rcc_param;
508 	struct ta_ra_cfr_cfg global[MAX_TA_RA_ENTRIES];
509 	uint64_t rx_tlv_evt_cnt;
510 	qdf_timer_t lut_age_timer;
511 	uint8_t lut_timer_init;
512 	uint8_t is_cfr_rcc_capable;
513 	uint64_t flush_dbr_cnt;
514 	uint64_t invalid_dma_length_cnt;
515 	uint64_t flush_timeout_dbr_cnt;
516 	uint64_t clear_txrx_event;
517 	uint64_t last_success_tstamp;
518 	uint64_t cfr_dma_aborts;
519 #endif
520 	struct unassoc_pool_entry unassoc_pool[MAX_CFR_ENABLED_CLIENTS];
521 	qdf_spinlock_t lut_lock;
522 };
523 
524 /**
525  * enum cfr_capt_status - CFR capture status
526  */
527 enum cfr_capt_status {
528 	/* Capture not in progress */
529 	PEER_CFR_CAPTURE_DISABLE,
530 	/* Capture in progress */
531 	PEER_CFR_CAPTURE_ENABLE,
532 };
533 
534 /**
535  * struct peer_cfr - private peer object for cfr
536  * peer_obj: pointer to peer_obj
537  * request: Type of request (start/stop)
538  * bandwidth: bandwitdth of capture for this peer
539  * capture_method: enum determining type of cfr data capture.
540  *                 0-Qos null data
541  */
542 struct peer_cfr {
543 	struct wlan_objmgr_peer *peer_obj;
544 	u_int8_t   request;            /* start/stop */
545 	u_int8_t   bandwidth;
546 	u_int32_t  period;
547 	u_int8_t   capture_method;
548 };
549 
550 /**
551  * cfr_initialize_pdev() - cfr initialize pdev
552  * @pdev: Pointer to pdev_obj
553  *
554  * Return: status of cfr pdev init
555  */
556 QDF_STATUS cfr_initialize_pdev(struct wlan_objmgr_pdev *pdev);
557 
558 /**
559  * cfr_deinitialize_pdev() - cfr deinitialize pdev
560  * @pdev: Pointer to pdev_obj
561  *
562  * Return: status of cfr pdev deinit
563  */
564 QDF_STATUS cfr_deinitialize_pdev(struct wlan_objmgr_pdev *pdev);
565 
566 /**
567  * wlan_cfr_init() - Global init for cfr.
568  *
569  * Return: status of global init pass/fail
570  */
571 QDF_STATUS wlan_cfr_init(void);
572 
573 /**
574  * wlan_cfr_deinit() - Global de-init for cfr.
575  *
576  * Return: status of global de-init pass/fail
577  */
578 QDF_STATUS wlan_cfr_deinit(void);
579 
580 /**
581  * wlan_cfr_pdev_open() - pdev_open function for cfr.
582  * @pdev: pointer to pdev object
583  *
584  * Return: status of pdev_open pass/fail
585  */
586 QDF_STATUS wlan_cfr_pdev_open(struct wlan_objmgr_pdev *pdev);
587 
588 /**
589  * wlan_cfr_pdev_close() - pdev_close function for cfr.
590  * @pdev: pointer to pdev object
591  *
592  * Return: status of pdev_close pass/fail
593  */
594 QDF_STATUS wlan_cfr_pdev_close(struct wlan_objmgr_pdev *pdev);
595 
596 /**
597  * count_set_bits() - function to count set bits in a bitmap
598  * @value: input bitmap
599  *
600  * Return: No. of set bits
601  */
602 uint8_t count_set_bits(uint32_t value);
603 
604 /**
605  * wlan_cfr_is_feature_disabled() - Check if cfr feature is disabled
606  * @pdev - the physical device object.
607  *
608  * Return : true if cfr is disabled, else false.
609  */
610 bool wlan_cfr_is_feature_disabled(struct wlan_objmgr_pdev *pdev);
611 
612 #ifdef WLAN_ENH_CFR_ENABLE
613 /**
614  * wlan_cfr_rx_tlv_process() - Process PPDU status TLVs and store info in
615  * lookup table
616  * @pdev_obj: PDEV object
617  * @nbuf: ppdu info
618  *
619  * Return: none
620  */
621 void wlan_cfr_rx_tlv_process(struct wlan_objmgr_pdev *pdev, void *nbuf);
622 #endif
623 #endif
624