1 /* 2 * Copyright (c) 2019-2021 The Linux Foundation. All rights reserved. 3 * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. 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 #define CFR_CAPTURE_HOST_MEM_REQ_ID 9 48 #define CFR_HOST_MEM_READ_INDEX_DEFAULT 8 49 #define CFR_VENDOR_ID 0x8cfdf0 50 #ifdef WLAN_ENH_CFR_ENABLE 51 #define MAX_CFR_MU_USERS 4 52 #define NUM_CHAN_CAPTURE_STATUS 4 53 #define NUM_CHAN_CAPTURE_REASON 6 54 #if defined(QCA_WIFI_QCA6750) || defined(QCA_WIFI_QCA6490) 55 #define MAX_TA_RA_ENTRIES 4 56 #define MAX_RESET_CFG_ENTRY 0xF 57 #else 58 #define MAX_TA_RA_ENTRIES 16 59 #define MAX_RESET_CFG_ENTRY 0xFFFF 60 #endif 61 #define CFR_INVALID_VDEV_ID 0xff 62 #define DEFAULT_SRNGID_CFR 0 63 #endif 64 65 #define MAX_CFR_PRD (10 * 60 * 1000) /* 10 minutes */ 66 #define CFR_MOD_PRD 10 /* CFR period to be multiples of 10ms */ 67 68 #define MAX_AGC_GAIN 62 69 70 enum cfrmetaversion { 71 CFR_META_VERSION_NONE, 72 CFR_META_VERSION_1, /* initial version for legacy_cfr_metadata */ 73 CFR_META_VERSION_2, /* initial version for dbr_cfr_metadata */ 74 CFR_META_VERSION_3, /* initial version for enh_cfr_metadata */ 75 CFR_META_VERSION_4, /* agc gain, cfo, rx_start_ts in dbr_cfr_metadata */ 76 CFR_META_VERSION_5, /* agc gain, cfo, rx_start_ts in enh_cfr_metadata */ 77 CFR_META_VERSION_6, /* mcs, gi_type in dbr_cfr_metadata */ 78 CFR_META_VERSION_7, /* mcs, gi_type, sig_info in enh_cfr_metadata */ 79 CFR_META_VERSION_8, /* agc gain table index in dbr_cfr_metadata */ 80 CFR_META_VERSION_9, /* agc gain table index in enh_cfr_metadata */ 81 CFR_META_VERSION_MAX = 0xFF, 82 }; 83 84 enum cfrdataversion { 85 CFR_DATA_VERSION_NONE, 86 CFR_DATA_VERSION_1, 87 CFR_DATA_VERSION_MAX = 0xFF, 88 }; 89 90 enum cfrplatformtype { 91 CFR_PLATFORM_TYPE_NONE, 92 CFR_PLATFORM_TYPE_MIPS, 93 CFR_PLATFORM_TYPE_ARM, 94 CFR_PLATFFORM_TYPE_MAX = 0xFF, 95 }; 96 97 enum cfrradiotype { 98 CFR_CAPTURE_RADIO_NONE, 99 CFR_CAPTURE_RADIO_OSPREY, 100 CFR_CAPTURE_RADIO_PEAKCOCK, 101 CFR_CAPTURE_RADIO_SCORPION, 102 CFR_CAPTURE_RADIO_HONEYBEE, 103 CFR_CAPTURE_RADIO_DRAGONFLY, 104 CFR_CAPTURE_RADIO_JET, 105 CFR_CAPTURE_RADIO_PEREGRINE = 17, 106 CFR_CAPTURE_RADIO_SWIFT, 107 CFR_CAPTURE_RADIO_BEELINER, 108 CFR_CAPTURE_RADIO_CASCADE, 109 CFR_CAPTURE_RADIO_DAKOTA, 110 CFR_CAPTURE_RADIO_BESRA, 111 CFR_CAPTURE_RADIO_HKV2, 112 CFR_CAPTURE_RADIO_CYP, 113 CFR_CAPTURE_RADIO_HSP, 114 CFR_CAPTURE_RADIO_PINE, 115 CFR_CAPTURE_RADIO_ADRASTEA, 116 CFR_CAPTURE_RADIO_MAPLE, 117 CFR_CAPTURE_RADIO_MOSELLE, 118 CFR_CAPTURE_RADIO_SPRUCE, 119 CFR_CAPTURE_RADIO_ALDER, 120 CFR_CAPTURE_RADIO_WAIKIKI, 121 CFR_CAPTURE_RADIO_KIWI, 122 CFR_CAPTURE_RADIO_MANGO, 123 CFR_CAPTURE_RADIO_MIAMI, 124 CFR_CAPTURE_RADIO_YORK, 125 CFR_CAPTURE_RADIO_MAX = 0xFF, 126 }; 127 128 enum ack_capture_mode { 129 CFR_LEGACY_ACK = 0, 130 CFR_DUP_LEGACY_ACK = 1, 131 CFR_HT_ACK = 2, 132 CFR_VHT_ACK = 3, 133 CFR_INVALID_ACK, /*Always keep this at last*/ 134 }; 135 136 /* Similar to WMI_PEER_CFR_CAPTURE_METHOD used in one-shot capture */ 137 enum cfr_capture_type { 138 CFR_TYPE_METHOD_NULL_FRAME = 0, 139 CFR_TYPE_METHOD_NULL_FRAME_WITH_PHASE = 1, 140 CFR_TYPE_METHOD_PROBE_RESP = 2, 141 CFR_TYPE_METHOD_TM = 3, 142 CFR_TYPE_METHOD_FTM = 4, 143 CFR_TYPE_METHOD_ACK_RESP_TO_TM_FTM = 5, 144 CFR_TYPE_METHOD_TA_RA_TYPE_FILTER = 6, 145 CFR_TYPE_METHOD_NDPA_NDP = 7, 146 CFR_TYPE_METHOD_ALL_PACKET = 8, 147 /* Add new capture methods before this line */ 148 CFR_TYPE_METHOD_LAST_VALID, 149 CFR_TYPE_METHOD_AUTO = 0xff, 150 CFR_TYPE_METHOD_MAX, 151 }; 152 153 #define HOST_MAX_CHAINS 8 154 155 /* ensure to add new members at the end of the structure only */ 156 struct dbr_cfr_metadata { 157 u_int8_t peer_addr[QDF_MAC_ADDR_SIZE]; 158 u_int8_t status; 159 u_int8_t capture_bw; 160 u_int8_t channel_bw; 161 u_int8_t phy_mode; 162 u_int16_t prim20_chan; 163 u_int16_t center_freq1; 164 u_int16_t center_freq2; 165 u_int8_t capture_mode; 166 u_int8_t capture_type; 167 u_int8_t sts_count; 168 u_int8_t num_rx_chain; 169 u_int32_t timestamp; 170 u_int32_t length; 171 u_int32_t chain_rssi[HOST_MAX_CHAINS]; 172 u_int16_t chain_phase[HOST_MAX_CHAINS]; 173 u_int32_t rtt_cfo_measurement; 174 u_int8_t agc_gain[HOST_MAX_CHAINS]; 175 u_int32_t rx_start_ts; 176 u_int16_t mcs_rate; 177 u_int16_t gi_type; 178 u_int8_t agc_gain_tbl_index[HOST_MAX_CHAINS]; 179 } __attribute__ ((__packed__)); 180 181 #ifdef WLAN_ENH_CFR_ENABLE 182 struct cfr_su_sig_info { 183 u_int8_t coding; 184 u_int8_t stbc; 185 u_int8_t beamformed; 186 u_int8_t dcm; 187 u_int8_t ltf_size; 188 u_int8_t sgi; 189 u_int16_t reserved; 190 } __attribute__ ((__packed__)); 191 192 /* ensure to add new members at the end of the structure only */ 193 struct enh_cfr_metadata { 194 u_int8_t status; 195 u_int8_t capture_bw; 196 u_int8_t channel_bw; 197 u_int8_t phy_mode; 198 u_int16_t prim20_chan; 199 u_int16_t center_freq1; 200 u_int16_t center_freq2; 201 u_int8_t capture_mode; /* ack_capture_mode */ 202 u_int8_t capture_type; /* cfr_capture_type */ 203 u_int8_t sts_count; 204 u_int8_t num_rx_chain; 205 u_int64_t timestamp; 206 u_int32_t length; 207 u_int8_t is_mu_ppdu; 208 u_int8_t num_mu_users; 209 union { 210 u_int8_t su_peer_addr[QDF_MAC_ADDR_SIZE]; 211 u_int8_t mu_peer_addr[MAX_CFR_MU_USERS][QDF_MAC_ADDR_SIZE]; 212 } peer_addr; 213 u_int32_t chain_rssi[HOST_MAX_CHAINS]; 214 u_int16_t chain_phase[HOST_MAX_CHAINS]; 215 u_int32_t rtt_cfo_measurement; 216 u_int8_t agc_gain[HOST_MAX_CHAINS]; 217 u_int32_t rx_start_ts; 218 u_int16_t mcs_rate; 219 u_int16_t gi_type; 220 struct cfr_su_sig_info sig_info; 221 u_int8_t agc_gain_tbl_index[HOST_MAX_CHAINS]; 222 } __attribute__ ((__packed__)); 223 #endif 224 225 #define CFR_META_DATA_LEN \ 226 (sizeof(struct csi_cfr_header) - sizeof(struct cfr_header_cmn)) 227 228 struct cfr_header_cmn { 229 u_int32_t start_magic_num; 230 u_int32_t vendorid; 231 u_int8_t cfr_metadata_version; 232 u_int8_t cfr_data_version; 233 u_int8_t chip_type; 234 u_int8_t pltform_type; 235 u_int32_t cfr_metadata_len; 236 u_int64_t host_real_ts; 237 } __attribute__ ((__packed__)); 238 239 struct csi_cfr_header { 240 struct cfr_header_cmn cmn; 241 union { 242 struct dbr_cfr_metadata meta_dbr; 243 #ifdef WLAN_ENH_CFR_ENABLE 244 struct enh_cfr_metadata meta_enh; 245 #endif 246 } u; 247 } __attribute__ ((__packed__)); 248 249 /** 250 * struct cfr_capture_params - structure to store cfr config param 251 * bandwidth: bandwidth of capture 252 * period: period of capture 253 * method: enum of method being followed to capture cfr data. 0-QoS null data 254 */ 255 struct cfr_capture_params { 256 u_int8_t bandwidth; 257 u_int32_t period; 258 u_int8_t method; 259 }; 260 261 /** 262 * struct psoc_cfr - private psoc object for cfr 263 * psoc_obj: pointer to psoc object 264 * is_cfr_capable: flag to determine if cfr is enabled or not 265 * is_cap_interval_mode_sel_support: flag to determine if target supports both 266 * capture_count and capture_duration modes 267 * with a nob provided to configure 268 * is_mo_marking_support: flag to determine if MO marking is supported or not 269 */ 270 struct psoc_cfr { 271 struct wlan_objmgr_psoc *psoc_obj; 272 uint8_t is_cfr_capable; 273 #ifdef WLAN_ENH_CFR_ENABLE 274 uint8_t is_cap_interval_mode_sel_support; 275 uint8_t is_mo_marking_support; 276 uint8_t is_aoa_for_rcc_support; 277 #endif 278 }; 279 280 /** 281 * struct cfr_wmi_host_mem_chunk - wmi mem chunk related 282 * vaddr: pointer to virtual address 283 * paddr: physical address 284 * len: len of the mem chunk allocated 285 * req_id: reqid related to the mem chunk 286 */ 287 struct cfr_wmi_host_mem_chunk { 288 uint32_t *vaddr; 289 qdf_dma_addr_t paddr; 290 uint32_t len; 291 uint32_t req_id; 292 }; 293 294 struct whal_cfir_dma_hdr { 295 uint16_t 296 // 'BA' 297 tag : 8, 298 // '02', length of header in 4 octet units 299 length : 6, 300 // 00 301 reserved : 2; 302 uint16_t 303 // [16] 304 upload_done : 1, 305 // [17:18], 0: invalid, 1: CFR, 2: CIR, 3: DebugH 306 capture_type : 3, 307 // [19:20], 0: Legacy, 1: HT, 2: VHT, 3: HE 308 preamble_type : 2, 309 // [21:23], 0: 1-stream, 1: 2-stream, ..., 7: 8-stream 310 nss : 3, 311 // [24:27], 0: invalid, 1: 1-chain, 2: 2-chain, etc. 312 num_chains : 3, 313 // [28:30], 0: 20 MHz, 1: 40 MHz, 2: 80 MHz, 3: 160 MHz 314 upload_pkt_bw : 3, // [31] 315 sw_peer_id_valid : 1; 316 uint16_t 317 sw_peer_id : 16; // [15:0] 318 uint16_t 319 phy_ppdu_id : 16; // [15:0] 320 }; 321 322 #define MAX_LUT_ENTRIES 140 /* For HKv2 136 is max */ 323 324 /** 325 * struct look_up_table - Placeholder for 2 asynchronous events (DBR and 326 * TXRX event) 327 * dbr_recv: Indicates whether WMI for DBR completion is received or not 328 * tx_recv: Indicates whether WMI for TX completion (or) WDI event for RX 329 * status is received or not 330 * data: pointer to CFR data that ucode DMAs to host memory 331 * data_len: length of CFR data DMAed by ucode 332 * dbr_ppdu_id: PPDU id retrieved from DBR completion WMI event 333 * tx_ppdu_id: PPDU id retrieved from WMI TX completion event (or) PPDU status 334 * TLV 335 * dbr_address: Physical address of the CFR data dump retrieved from DBR 336 * completion WMI event 337 * tx_address1: Physical address of the CFR data from TX/RX event 338 * tx_address2: Physical address of the CFR data from TX/RX event 339 * csi_cfr_header: CFR header constructed by host 340 * whal_cfir_enhanced_hdr: CFR header constructed by ucode 341 * tx_tstamp: Timestamp when TX/RX event was received 342 * dbr_tstamp: Timestamp when DBR completion event was received 343 * header_length: Length of header DMAed by ucode in words 344 * payload_length: Length of CFR payload 345 */ 346 struct look_up_table { 347 bool dbr_recv; 348 bool tx_recv; 349 uint8_t *data; /* capture payload */ 350 uint32_t data_len; /* capture len */ 351 uint16_t dbr_ppdu_id; /* ppdu id from dbr */ 352 uint16_t tx_ppdu_id; /* ppdu id from TX event */ 353 qdf_dma_addr_t dbr_address; /* capture len */ 354 uint32_t tx_address1; /* capture len */ 355 uint32_t tx_address2; /* capture len */ 356 struct csi_cfr_header header; 357 struct whal_cfir_dma_hdr dma_hdr; 358 uint64_t txrx_tstamp; 359 uint64_t dbr_tstamp; 360 uint32_t header_length; 361 uint32_t payload_length; 362 }; 363 364 struct unassoc_pool_entry { 365 struct qdf_mac_addr mac; 366 struct cfr_capture_params cfr_params; 367 bool is_valid; 368 }; 369 370 #ifdef WLAN_ENH_CFR_ENABLE 371 /** 372 * struct ta_ra_cfr_cfg - structure to store configuration of 16 groups in 373 * M_TA_RA mode 374 * filter_group_id: Filter group number for which the below filters needs to be 375 * applied 376 * bw: CFR capture will be done for packets matching the bandwidths specified 377 * within this bitmask 378 * nss: CFR capture will be done for packets matching the Nss specified within 379 * this bitmask 380 * valid_ta: Ta_addr is valid if set 381 * valid_ta_mask: Ta_addr_mask is valid if set 382 * valid_ra: Ra_addr is valid if set 383 * valid_ra_mask: Ra_addr_mask is valid if set 384 * valid_bw_mask: Bandwidth is valid if set 385 * valid_nss_mask: NSS is valid if set 386 * valid_mgmt_subtype: Mgmt_subtype is valid if set 387 * valid_ctrl_subtype: Ctrl_subtype is valid if set 388 * valid_data_subtype: Data_subtype is valid if set 389 * mgmt_subtype_filter: Managments Packets matching the subtype filter 390 * categories will be filtered in by MAC for CFR capture. 391 * ctrl_subtype_filter: Control Packets matching the subtype filter 392 * categories will be filtered in by MAC for CFR capture. 393 * data_subtype_filter: Data Packets matching the subtype filter 394 * categories will be filtered in by MAC for CFR capture. 395 * tx_addr: Packets whose transmitter address matches (tx_addr & tx_addr_mask) 396 * will be filtered in by MAC 397 * tx_addr_mask: Packets whose transmitter address matches (tx_addr & 398 * tx_addr_mask) will be filtered in by MAC 399 * rx_addr: Packets whose receiver address matches (rx_addr & rx_addr_mask) 400 * will be filtered in by MAC 401 * rx_addr_mask: Packets whose receiver address matches (rx_addr & 402 * rx_addr_mask) will be filtered in by MAC 403 */ 404 struct ta_ra_cfr_cfg { 405 uint8_t filter_group_id; 406 uint16_t bw :6, 407 nss :8, 408 rsvd0 :2; 409 uint16_t valid_ta :1, 410 valid_ta_mask :1, 411 valid_ra :1, 412 valid_ra_mask :1, 413 valid_bw_mask :1, 414 valid_nss_mask :1, 415 valid_mgmt_subtype :1, 416 valid_ctrl_subtype :1, 417 valid_data_subtype :1, 418 rsvd1 :7; 419 uint16_t mgmt_subtype_filter; 420 uint16_t ctrl_subtype_filter; 421 uint16_t data_subtype_filter; 422 uint8_t tx_addr[QDF_MAC_ADDR_SIZE]; 423 uint8_t rx_addr[QDF_MAC_ADDR_SIZE]; 424 uint8_t tx_addr_mask[QDF_MAC_ADDR_SIZE]; 425 uint8_t rx_addr_mask[QDF_MAC_ADDR_SIZE]; 426 427 } qdf_packed; 428 429 /** 430 * struct cfr_rcc_param - structure to store cfr config param 431 * pdev_id: pdev_id for identifying the MAC 432 * vdev_id: vdev_id of current rcc configures 433 * srng_id: srng id of current rcc configures 434 * capture_duration: Capture Duration field for which CFR capture has to happen, 435 * in microsecond units 436 * capture_interval: Capture interval field which is time in between 437 * consecutive CFR capture, in microsecond units 438 * ul_mu_user_mask_lower: Bitfields indicates which of the users in the current 439 * UL MU transmission are enabled for CFR capture. 440 * ul_mu_user_mask_upper: This is continuation of the above lower mask. 441 * freeze_tlv_delay_cnt_en: Enable Freeze TLV delay counter in MAC 442 * freeze_tlv_delay_cnt_thr: Indicates the number of consecutive Rx packets to 443 * be skipped before CFR capture is enabled again. 444 * filter_group_bitmap: Bitfields set indicates which of the CFR group config is 445 * enabled 446 * m_directed_ftm: Filter Directed FTM ACK frames for CFR capture 447 * m_all_ftm_ack: Filter All FTM ACK frames for CFR capture 448 * m_ndpa_ndp_directed: Filter NDPA NDP Directed Frames for CFR capture 449 * m_ndpa_ndp_all: Filter all NDPA NDP for CFR capture 450 * m_ta_ra_filter: Filter Frames based on TA/RA/Subtype as provided in CFR Group 451 * config 452 * m_all_packet: Filter in All packets for CFR Capture 453 * en_ta_ra_filter_in_as_fp: Filter in frames as FP/MO in m_ta_ra_filter mode 454 * num_grp_tlvs: Indicates the number of groups in M_TA_RA mode, that have 455 * changes in the current commit session, use to construct WMI group TLV(s) 456 * curr: Placeholder for M_TA_RA group config in current commit session 457 * modified_in_curr_session: Bitmap indicating number of groups in M_TA_RA mode 458 * that have changed in current commit session. 459 * capture_count: After capture_count+1 number of captures, MAC stops RCC and 460 * waits for capture_interval duration before enabling again 461 * capture_intval_mode_sel: 0 indicates capture_duration mode, 1 indicates the 462 * capture_count mode. 463 */ 464 struct cfr_rcc_param { 465 uint8_t pdev_id; 466 uint8_t vdev_id; 467 uint8_t srng_id; 468 uint32_t capture_duration; 469 uint32_t capture_interval; 470 uint32_t ul_mu_user_mask_lower; 471 uint32_t ul_mu_user_mask_upper; 472 uint16_t freeze_tlv_delay_cnt_en :1, 473 freeze_tlv_delay_cnt_thr :8, 474 rsvd0 :7; 475 uint16_t filter_group_bitmap; 476 uint8_t m_directed_ftm : 1, 477 m_all_ftm_ack : 1, 478 m_ndpa_ndp_directed : 1, 479 m_ndpa_ndp_all : 1, 480 m_ta_ra_filter : 1, 481 m_all_packet : 1, 482 en_ta_ra_filter_in_as_fp : 1, 483 rsvd1 : 1; 484 uint8_t num_grp_tlvs; 485 486 struct ta_ra_cfr_cfg curr[MAX_TA_RA_ENTRIES]; 487 unsigned long modified_in_curr_session; 488 uint32_t capture_count :16, 489 capture_intval_mode_sel :1, 490 rsvd2 :15; 491 }; 492 #endif /* WLAN_ENH_CFR_ENABLE */ 493 494 /** 495 * struct nl_event_cb - nl event cb for cfr data 496 * vdev_id: vdev id 497 * pid: PID to which data is sent via unicast nl event 498 * cfr_nl_cb: callback to send nl event 499 */ 500 struct nl_event_cb { 501 uint8_t vdev_id; 502 uint32_t pid; 503 void (*cfr_nl_cb)(uint8_t vdev_id, uint32_t pid, 504 const void *data, uint32_t data_len); 505 }; 506 507 /** 508 * struct pdev_cfr - private pdev object for cfr 509 * pdev_obj: pointer to pdev object 510 * is_cfr_capable: flag to determine if cfr is enabled or not 511 * cfr_timer_enable: flag to enable/disable timer 512 * chip_type: chip type which is defined in enum cfrradiotype 513 * cfr_mem_chunk: Region of memory used for storing cfr data 514 * cfr_max_sta_count: Maximum stations supported in one-shot capture mode 515 * num_subbufs: No. of sub-buffers used in relayfs 516 * subbuf_size: Size of sub-buffer used in relayfs 517 * chan_ptr: Channel in relayfs 518 * dir_ptr: Parent directory of relayfs file 519 * lut: lookup table used to store asynchronous DBR and TX/RX events for 520 * correlation 521 * lut_num: Number of lut 522 * dbr_buf_size: Size of DBR completion buffer 523 * dbr_num_bufs: No. of DBR completions 524 * tx_evt_cnt: No. of TX completion events till CFR stop was issued 525 * total_tx_evt_cnt: No. of Tx completion events since wifi was up 526 * dbr_evt_cnt: No. of WMI DBR completion events 527 * release_cnt: No. of CFR data buffers relayed to userspace 528 * tx_peer_status_cfr_fail: No. of tx events without tx status set to 529 * PEER_CFR_CAPTURE_EVT_STATUS_MASK indicating CFR capture failure on a peer. 530 * tx_evt_status_cfr_fail: No. of tx events without tx status set to 531 * CFR_TX_EVT_STATUS_MASK indicating CFR capture status failure. 532 * tx_dbr_cookie_lookup_fail: No. of dbr cookie lookup failures during tx event 533 * process. 534 * rcc_param: Structure to store CFR config for the current commit session 535 * global: Structure to store accumulated CFR config 536 * rx_tlv_evt_cnt: Number of CFR WDI events from datapath 537 * lut_age_timer: Timer to flush pending TXRX/DBR events in lookup table 538 * lut_timer_init: flag to determine if lut_age_timer is initialized or not 539 * is_cfr_rcc_capable: Flag to determine if RCC is enabled or not. 540 * flush_dbr_cnt: No. of un-correlated DBR completions flushed when a newer PPDU 541 * is correlated successfully with newer DBR completion 542 * invalid_dma_length_cnt: No. of buffers for which CFR DMA header length (or) 543 * data length was invalid 544 * flush_timeout_dbr_cnt: No. of DBR completion flushed out in ageout logic 545 * clear_txrx_event: No. of PPDU status TLVs over-written in LUT 546 * last_success_tstamp: DBR timestamp which indicates that both DBR and TX/RX 547 * events have been received successfully. 548 * cfr_dma_aborts: No. of CFR DMA aborts in ucode 549 * is_cap_interval_mode_sel_support: flag to determine if target supports both 550 * is_mo_marking_support: flag to determine if MO marking is supported or not 551 * is_aoa_for_rcc_support: flag to determine if AoA is available for RCC or not 552 * capture_count and capture_duration modes with a nob provided to configure. 553 * unassoc_pool: Pool of un-associated clients used when capture method is 554 * CFR_CAPTURE_METHOD_PROBE_RESPONSE 555 * nl_cb: call back to register for nl event for cfr data 556 * lut_lock: Lock to protect access to cfr lookup table 557 * is_prevent_suspend: CFR wake lock acquired or not 558 * wake_lock: wake lock for cfr 559 * runtime_lock: runtime lock for cfr 560 * freq: current operating freq for which AoA Phase delta values reported by FW 561 * max_aoa_chains: Indicate the max number of chains to which target supports 562 * AoA data. 563 * phase_delta: per chain phase delta associated with 62 gain values reported by 564 * FW via WMI_PDEV_AOA_PHASEDELTA_EVENTID. 565 * ibf_cal_val: Per chain IBF cal value from FW. 566 */ 567 /* 568 * To be extended if we get more capbality info 569 * from FW's extended service ready event. 570 */ 571 struct pdev_cfr { 572 struct wlan_objmgr_pdev *pdev_obj; 573 uint8_t is_cfr_capable; 574 uint8_t cfr_timer_enable; 575 uint8_t chip_type; 576 struct cfr_wmi_host_mem_chunk cfr_mem_chunk; 577 uint16_t cfr_max_sta_count; 578 uint16_t cfr_current_sta_count; 579 uint32_t num_subbufs; 580 uint32_t subbuf_size; 581 qdf_streamfs_chan_t chan_ptr; 582 qdf_dentry_t dir_ptr; 583 struct look_up_table **lut; 584 uint32_t lut_num; 585 uint32_t dbr_buf_size; 586 uint32_t dbr_num_bufs; 587 uint32_t max_mu_users; 588 uint64_t tx_evt_cnt; 589 uint64_t total_tx_evt_cnt; 590 uint64_t dbr_evt_cnt; 591 uint64_t release_cnt; 592 uint64_t tx_peer_status_cfr_fail; 593 uint64_t tx_evt_status_cfr_fail; 594 uint64_t tx_dbr_cookie_lookup_fail; 595 #ifdef WLAN_ENH_CFR_ENABLE 596 struct cfr_rcc_param rcc_param; 597 struct ta_ra_cfr_cfg global[MAX_TA_RA_ENTRIES]; 598 uint64_t rx_tlv_evt_cnt; 599 qdf_timer_t lut_age_timer; 600 uint8_t lut_timer_init; 601 uint8_t is_cfr_rcc_capable; 602 uint64_t flush_dbr_cnt; 603 uint64_t invalid_dma_length_cnt; 604 uint64_t flush_timeout_dbr_cnt; 605 uint64_t clear_txrx_event; 606 uint64_t last_success_tstamp; 607 uint64_t cfr_dma_aborts; 608 uint8_t is_cap_interval_mode_sel_support; 609 uint8_t is_mo_marking_support; 610 uint8_t is_aoa_for_rcc_support; 611 #endif 612 struct unassoc_pool_entry unassoc_pool[MAX_CFR_ENABLED_CLIENTS]; 613 struct nl_event_cb nl_cb; 614 qdf_spinlock_t lut_lock; 615 #ifdef WLAN_CFR_PM 616 bool is_prevent_suspend; 617 qdf_wake_lock_t wake_lock; 618 qdf_runtime_lock_t runtime_lock; 619 #endif 620 #ifdef WLAN_ENH_CFR_ENABLE 621 uint32_t freq; 622 uint32_t max_aoa_chains; 623 uint16_t phase_delta[HOST_MAX_CHAINS][MAX_AGC_GAIN]; 624 uint32_t ibf_cal_val[HOST_MAX_CHAINS]; 625 #endif 626 }; 627 628 /** 629 * enum cfr_capt_status - CFR capture status 630 */ 631 enum cfr_capt_status { 632 /* Capture not in progress */ 633 PEER_CFR_CAPTURE_DISABLE, 634 /* Capture in progress */ 635 PEER_CFR_CAPTURE_ENABLE, 636 }; 637 638 /** 639 * struct peer_cfr - private peer object for cfr 640 * peer_obj: pointer to peer_obj 641 * request: Type of request (start/stop) 642 * bandwidth: bandwitdth of capture for this peer 643 * capture_method: enum determining type of cfr data capture. 644 * 0-Qos null data 645 */ 646 struct peer_cfr { 647 struct wlan_objmgr_peer *peer_obj; 648 u_int8_t request; /* start/stop */ 649 u_int8_t bandwidth; 650 u_int32_t period; 651 u_int8_t capture_method; 652 }; 653 654 /** 655 * cfr_initialize_pdev() - cfr initialize pdev 656 * @pdev: Pointer to pdev_obj 657 * 658 * Return: status of cfr pdev init 659 */ 660 QDF_STATUS cfr_initialize_pdev(struct wlan_objmgr_pdev *pdev); 661 662 /** 663 * cfr_deinitialize_pdev() - cfr deinitialize pdev 664 * @pdev: Pointer to pdev_obj 665 * 666 * Return: status of cfr pdev deinit 667 */ 668 QDF_STATUS cfr_deinitialize_pdev(struct wlan_objmgr_pdev *pdev); 669 670 /** 671 * wlan_cfr_init() - Global init for cfr. 672 * 673 * Return: status of global init pass/fail 674 */ 675 QDF_STATUS wlan_cfr_init(void); 676 677 /** 678 * wlan_cfr_deinit() - Global de-init for cfr. 679 * 680 * Return: status of global de-init pass/fail 681 */ 682 QDF_STATUS wlan_cfr_deinit(void); 683 684 /** 685 * wlan_cfr_pdev_open() - pdev_open function for cfr. 686 * @pdev: pointer to pdev object 687 * 688 * Return: status of pdev_open pass/fail 689 */ 690 QDF_STATUS wlan_cfr_pdev_open(struct wlan_objmgr_pdev *pdev); 691 692 /** 693 * wlan_cfr_pdev_close() - pdev_close function for cfr. 694 * @pdev: pointer to pdev object 695 * 696 * Return: status of pdev_close pass/fail 697 */ 698 QDF_STATUS wlan_cfr_pdev_close(struct wlan_objmgr_pdev *pdev); 699 700 /** 701 * count_set_bits() - function to count set bits in a bitmap 702 * @value: input bitmap 703 * 704 * Return: No. of set bits 705 */ 706 uint8_t count_set_bits(unsigned long value); 707 708 /** 709 * wlan_cfr_is_feature_disabled() - Check if cfr feature is disabled 710 * @pdev - the physical device object. 711 * 712 * Return : true if cfr is disabled, else false. 713 */ 714 bool wlan_cfr_is_feature_disabled(struct wlan_objmgr_pdev *pdev); 715 716 #ifdef WLAN_ENH_CFR_ENABLE 717 /** 718 * wlan_cfr_rx_tlv_process() - Process PPDU status TLVs and store info in 719 * lookup table 720 * @pdev_obj: PDEV object 721 * @nbuf: ppdu info 722 * 723 * Return: none 724 */ 725 void wlan_cfr_rx_tlv_process(struct wlan_objmgr_pdev *pdev, void *nbuf); 726 #endif 727 #endif 728