1*5113495bSYour Name /*
2*5113495bSYour Name * Copyright (c) 2011,2017-2021 The Linux Foundation. All rights reserved.
3*5113495bSYour Name * Copyright (c) 2021-2024 Qualcomm Innovation Center, Inc. All rights reserved.
4*5113495bSYour Name *
5*5113495bSYour Name * Permission to use, copy, modify, and/or distribute this software for
6*5113495bSYour Name * any purpose with or without fee is hereby granted, provided that the
7*5113495bSYour Name * above copyright notice and this permission notice appear in all
8*5113495bSYour Name * copies.
9*5113495bSYour Name *
10*5113495bSYour Name * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11*5113495bSYour Name * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12*5113495bSYour Name * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13*5113495bSYour Name * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14*5113495bSYour Name * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15*5113495bSYour Name * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16*5113495bSYour Name * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17*5113495bSYour Name * PERFORMANCE OF THIS SOFTWARE.
18*5113495bSYour Name */
19*5113495bSYour Name
20*5113495bSYour Name #ifndef _TARGET_IF_SPECTRAL_H_
21*5113495bSYour Name #define _TARGET_IF_SPECTRAL_H_
22*5113495bSYour Name
23*5113495bSYour Name #include <wlan_objmgr_cmn.h>
24*5113495bSYour Name #include <wlan_objmgr_psoc_obj.h>
25*5113495bSYour Name #include <wlan_objmgr_pdev_obj.h>
26*5113495bSYour Name #include <wlan_objmgr_vdev_obj.h>
27*5113495bSYour Name #include <wlan_reg_services_api.h>
28*5113495bSYour Name #include <qdf_lock.h>
29*5113495bSYour Name #include <wlan_spectral_public_structs.h>
30*5113495bSYour Name #include <reg_services_public_struct.h>
31*5113495bSYour Name #ifdef DIRECT_BUF_RX_ENABLE
32*5113495bSYour Name #include <target_if_direct_buf_rx_api.h>
33*5113495bSYour Name #endif
34*5113495bSYour Name #ifdef WIN32
35*5113495bSYour Name #pragma pack(push, target_if_spectral, 1)
36*5113495bSYour Name #define __ATTRIB_PACK
37*5113495bSYour Name #else
38*5113495bSYour Name #ifndef __ATTRIB_PACK
39*5113495bSYour Name #define __ATTRIB_PACK __attribute__ ((packed))
40*5113495bSYour Name #endif
41*5113495bSYour Name #endif
42*5113495bSYour Name
43*5113495bSYour Name #include <spectral_defs_i.h>
44*5113495bSYour Name #include <wmi_unified_param.h>
45*5113495bSYour Name
46*5113495bSYour Name #define FREQ_OFFSET_10MHZ (10)
47*5113495bSYour Name #define FREQ_OFFSET_40MHZ (40)
48*5113495bSYour Name #define FREQ_OFFSET_80MHZ (80)
49*5113495bSYour Name #define FREQ_OFFSET_85MHZ (85)
50*5113495bSYour Name #ifndef SPECTRAL_USE_NL_BCAST
51*5113495bSYour Name #define SPECTRAL_USE_NL_BCAST (0)
52*5113495bSYour Name #endif
53*5113495bSYour Name
54*5113495bSYour Name #define STATUS_PASS 1
55*5113495bSYour Name #define STATUS_FAIL 0
56*5113495bSYour Name #undef spectral_dbg_line
57*5113495bSYour Name #define spectral_dbg_line() \
58*5113495bSYour Name spectral_debug("----------------------------------------------------")
59*5113495bSYour Name
60*5113495bSYour Name #undef spectral_ops_not_registered
61*5113495bSYour Name #define spectral_ops_not_registered(str) \
62*5113495bSYour Name spectral_info("SPECTRAL : %s not registered\n", (str))
63*5113495bSYour Name #undef not_yet_implemented
64*5113495bSYour Name #define not_yet_implemented() \
65*5113495bSYour Name spectral_info("SPECTRAL : %s : %d Not yet implemented\n", \
66*5113495bSYour Name __func__, __LINE__)
67*5113495bSYour Name
68*5113495bSYour Name #define SPECTRAL_HT20_NUM_BINS 56
69*5113495bSYour Name #define SPECTRAL_HT20_FFT_LEN 56
70*5113495bSYour Name #define SPECTRAL_HT20_DC_INDEX (SPECTRAL_HT20_FFT_LEN / 2)
71*5113495bSYour Name #define SPECTRAL_HT20_DATA_LEN 60
72*5113495bSYour Name #define SPECTRAL_HT20_TOTAL_DATA_LEN (SPECTRAL_HT20_DATA_LEN + 3)
73*5113495bSYour Name #define SPECTRAL_HT40_TOTAL_NUM_BINS 128
74*5113495bSYour Name #define SPECTRAL_HT40_DATA_LEN 135
75*5113495bSYour Name #define SPECTRAL_HT40_TOTAL_DATA_LEN (SPECTRAL_HT40_DATA_LEN + 3)
76*5113495bSYour Name #define SPECTRAL_HT40_FFT_LEN 128
77*5113495bSYour Name #define SPECTRAL_HT40_DC_INDEX (SPECTRAL_HT40_FFT_LEN / 2)
78*5113495bSYour Name
79*5113495bSYour Name /*
80*5113495bSYour Name * Used for the SWAR to obtain approximate combined rssi
81*5113495bSYour Name * in secondary 80Mhz segment
82*5113495bSYour Name */
83*5113495bSYour Name #define OFFSET_CH_WIDTH_20 65
84*5113495bSYour Name #define OFFSET_CH_WIDTH_40 62
85*5113495bSYour Name #define OFFSET_CH_WIDTH_80 56
86*5113495bSYour Name #define OFFSET_CH_WIDTH_160 50
87*5113495bSYour Name
88*5113495bSYour Name /* Min and max for relevant Spectral params */
89*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MIN_GEN2 (1)
90*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN2 (9)
91*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MIN_GEN3 (5)
92*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN3_DEFAULT (9)
93*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN3_QCN9000 (10)
94*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MIN_GEN3_BE (5)
95*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN3_BE (11)
96*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN3_BE_20MHZ (9)
97*5113495bSYour Name #define SPECTRAL_PARAM_FFT_SIZE_MAX_GEN3_BE_40MHZ (10)
98*5113495bSYour Name #define INVALID_FFT_SIZE (0xFFFF)
99*5113495bSYour Name #define SPECTRAL_PARAM_RPT_MODE_MIN (0)
100*5113495bSYour Name #define SPECTRAL_PARAM_RPT_MODE_MAX (3)
101*5113495bSYour Name #define SPECTRAL_PARAM_SCAN_COUNT_MAX_GEN3 (4095)
102*5113495bSYour Name #define SPECTRAL_PARAM_SCAN_COUNT_MAX_GEN3_BE (4095)
103*5113495bSYour Name #define SPECTRAL_DWORD_SIZE (4)
104*5113495bSYour Name
105*5113495bSYour Name #define MAX_FFTBIN_VALUE_LINEAR_MODE (U8_MAX)
106*5113495bSYour Name #define MAX_FFTBIN_VALUE_DBM_MODE (S8_MAX)
107*5113495bSYour Name #define MIN_FFTBIN_VALUE_DBM_MODE (S8_MIN)
108*5113495bSYour Name #define MAX_FFTBIN_VALUE (255)
109*5113495bSYour Name
110*5113495bSYour Name /* DBR ring debug size for Spectral */
111*5113495bSYour Name #define SPECTRAL_DBR_RING_DEBUG_SIZE 512
112*5113495bSYour Name
113*5113495bSYour Name #ifdef BIG_ENDIAN_HOST
114*5113495bSYour Name #define SPECTRAL_MESSAGE_COPY_CHAR_ARRAY(destp, srcp, len) do { \
115*5113495bSYour Name int j; \
116*5113495bSYour Name uint32_t *src, *dest; \
117*5113495bSYour Name src = (uint32_t *)(srcp); \
118*5113495bSYour Name dest = (uint32_t *)(destp); \
119*5113495bSYour Name for (j = 0; j < roundup((len), sizeof(uint32_t)) / 4; j++) { \
120*5113495bSYour Name *(dest + j) = qdf_le32_to_cpu(*(src + j)); \
121*5113495bSYour Name } \
122*5113495bSYour Name } while (0)
123*5113495bSYour Name #else
124*5113495bSYour Name #define SPECTRAL_MESSAGE_COPY_CHAR_ARRAY(destp, srcp, len) \
125*5113495bSYour Name OS_MEMCPY((destp), (srcp), (len));
126*5113495bSYour Name #endif
127*5113495bSYour Name
128*5113495bSYour Name #define DUMMY_NF_VALUE (-123)
129*5113495bSYour Name /* 5 categories x (lower + upper) bands */
130*5113495bSYour Name #define MAX_INTERF 10
131*5113495bSYour Name #define HOST_MAX_ANTENNA 3
132*5113495bSYour Name /* Mask for time stamp from descriptor */
133*5113495bSYour Name #define SPECTRAL_TSMASK 0xFFFFFFFF
134*5113495bSYour Name #define SPECTRAL_SIGNATURE 0xdeadbeef
135*5113495bSYour Name /* Signature to write onto spectral buffer and then later validate */
136*5113495bSYour Name #define MEM_POISON_SIGNATURE (htobe32(0xdeadbeef))
137*5113495bSYour Name
138*5113495bSYour Name /* START of spectral GEN II HW specific details */
139*5113495bSYour Name #define SPECTRAL_PHYERR_SIGNATURE_GEN2 0xbb
140*5113495bSYour Name #define TLV_TAG_SPECTRAL_SUMMARY_REPORT_GEN2 0xF9
141*5113495bSYour Name #define TLV_TAG_ADC_REPORT_GEN2 0xFA
142*5113495bSYour Name #define TLV_TAG_SEARCH_FFT_REPORT_GEN2 0xFB
143*5113495bSYour Name
144*5113495bSYour Name /*
145*5113495bSYour Name * The Maximum number of detector information to be filled in the SAMP msg
146*5113495bSYour Name * is 3, only for 165MHz case. For all other cases this value will be 1.
147*5113495bSYour Name */
148*5113495bSYour Name #define MAX_NUM_DEST_DETECTOR_INFO (3)
149*5113495bSYour Name #define MAX_DETECTORS_PER_PDEV (3)
150*5113495bSYour Name #define FFT_BIN_SIZE_1BYTE (1)
151*5113495bSYour Name
152*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
153*5113495bSYour Name /**
154*5113495bSYour Name * enum spectral_160mhz_report_delivery_state - 160 MHz state machine states
155*5113495bSYour Name * @SPECTRAL_REPORT_WAIT_PRIMARY80: Wait for primary80 report
156*5113495bSYour Name * @SPECTRAL_REPORT_WAIT_SECONDARY80: Wait for secondory 80 report
157*5113495bSYour Name */
158*5113495bSYour Name enum spectral_160mhz_report_delivery_state {
159*5113495bSYour Name SPECTRAL_REPORT_WAIT_PRIMARY80,
160*5113495bSYour Name SPECTRAL_REPORT_WAIT_SECONDARY80,
161*5113495bSYour Name };
162*5113495bSYour Name #else
163*5113495bSYour Name /**
164*5113495bSYour Name * enum spectral_160mhz_report_delivery_state - 160 MHz state machine states
165*5113495bSYour Name * @SPECTRAL_REPORT_WAIT_PRIMARY80: Wait for primary80 report
166*5113495bSYour Name * @SPECTRAL_REPORT_RX_PRIMARY80: Receive primary 80 report
167*5113495bSYour Name * @SPECTRAL_REPORT_WAIT_SECONDARY80: Wait for secondory 80 report
168*5113495bSYour Name * @SPECTRAL_REPORT_RX_SECONDARY80: Receive secondary 80 report
169*5113495bSYour Name */
170*5113495bSYour Name enum spectral_160mhz_report_delivery_state {
171*5113495bSYour Name SPECTRAL_REPORT_WAIT_PRIMARY80,
172*5113495bSYour Name SPECTRAL_REPORT_RX_PRIMARY80,
173*5113495bSYour Name SPECTRAL_REPORT_WAIT_SECONDARY80,
174*5113495bSYour Name SPECTRAL_REPORT_RX_SECONDARY80,
175*5113495bSYour Name };
176*5113495bSYour Name #endif /* OPTIMIZED_SAMP_MESSAGE */
177*5113495bSYour Name
178*5113495bSYour Name /**
179*5113495bSYour Name * enum spectral_freq_span_id - Spectral frequency span id
180*5113495bSYour Name * @SPECTRAL_FREQ_SPAN_ID_0: Frequency span 0
181*5113495bSYour Name * @SPECTRAL_FREQ_SPAN_ID_1: Frequency span 1
182*5113495bSYour Name * @SPECTRAL_FREQ_SPAN_ID_2: Frequency span 2
183*5113495bSYour Name */
184*5113495bSYour Name enum spectral_freq_span_id {
185*5113495bSYour Name SPECTRAL_FREQ_SPAN_ID_0,
186*5113495bSYour Name SPECTRAL_FREQ_SPAN_ID_1,
187*5113495bSYour Name SPECTRAL_FREQ_SPAN_ID_2,
188*5113495bSYour Name };
189*5113495bSYour Name
190*5113495bSYour Name /**
191*5113495bSYour Name * enum spectral_detector_id - Spectral detector id
192*5113495bSYour Name * @SPECTRAL_DETECTOR_ID_0: Spectral detector 0
193*5113495bSYour Name * @SPECTRAL_DETECTOR_ID_1: Spectral detector 1
194*5113495bSYour Name * @SPECTRAL_DETECTOR_ID_2: Spectral detector 2
195*5113495bSYour Name * @SPECTRAL_DETECTOR_ID_MAX: Max Spectral detector ID
196*5113495bSYour Name * @SPECTRAL_DETECTOR_ID_INVALID: Invalid Spectral detector ID
197*5113495bSYour Name */
198*5113495bSYour Name enum spectral_detector_id {
199*5113495bSYour Name SPECTRAL_DETECTOR_ID_0,
200*5113495bSYour Name SPECTRAL_DETECTOR_ID_1,
201*5113495bSYour Name SPECTRAL_DETECTOR_ID_2,
202*5113495bSYour Name SPECTRAL_DETECTOR_ID_MAX,
203*5113495bSYour Name SPECTRAL_DETECTOR_ID_INVALID = 0xff,
204*5113495bSYour Name };
205*5113495bSYour Name
206*5113495bSYour Name /**
207*5113495bSYour Name * struct spectral_search_fft_info_gen2 - spectral search fft report for gen2
208*5113495bSYour Name * @relpwr_db: Total bin power in db
209*5113495bSYour Name * @num_str_bins_ib: Number of strong bins
210*5113495bSYour Name * @base_pwr: Base power
211*5113495bSYour Name * @total_gain_info: Total gain
212*5113495bSYour Name * @fft_chn_idx: FFT chain on which report is originated
213*5113495bSYour Name * @avgpwr_db: Average power in db
214*5113495bSYour Name * @peak_mag: Peak power seen in the bins
215*5113495bSYour Name * @peak_inx: Index of bin holding peak power
216*5113495bSYour Name */
217*5113495bSYour Name struct spectral_search_fft_info_gen2 {
218*5113495bSYour Name uint32_t relpwr_db;
219*5113495bSYour Name uint32_t num_str_bins_ib;
220*5113495bSYour Name uint32_t base_pwr;
221*5113495bSYour Name uint32_t total_gain_info;
222*5113495bSYour Name uint32_t fft_chn_idx;
223*5113495bSYour Name uint32_t avgpwr_db;
224*5113495bSYour Name uint32_t peak_mag;
225*5113495bSYour Name int16_t peak_inx;
226*5113495bSYour Name };
227*5113495bSYour Name
228*5113495bSYour Name /*
229*5113495bSYour Name * XXX Check if we should be handling the endinness difference in some
230*5113495bSYour Name * other way opaque to the host
231*5113495bSYour Name */
232*5113495bSYour Name #ifdef BIG_ENDIAN_HOST
233*5113495bSYour Name
234*5113495bSYour Name /**
235*5113495bSYour Name * struct spectral_phyerr_tlv_gen2 - phyerr tlv info for big endian host
236*5113495bSYour Name * @signature: signature
237*5113495bSYour Name * @tag: tag
238*5113495bSYour Name * @length: length
239*5113495bSYour Name */
240*5113495bSYour Name struct spectral_phyerr_tlv_gen2 {
241*5113495bSYour Name uint8_t signature;
242*5113495bSYour Name uint8_t tag;
243*5113495bSYour Name uint16_t length;
244*5113495bSYour Name } __ATTRIB_PACK;
245*5113495bSYour Name
246*5113495bSYour Name #else
247*5113495bSYour Name
248*5113495bSYour Name /**
249*5113495bSYour Name * struct spectral_phyerr_tlv_gen2 - phyerr tlv info for little endian host
250*5113495bSYour Name * @length: length
251*5113495bSYour Name * @tag: tag
252*5113495bSYour Name * @signature: signature
253*5113495bSYour Name */
254*5113495bSYour Name struct spectral_phyerr_tlv_gen2 {
255*5113495bSYour Name uint16_t length;
256*5113495bSYour Name uint8_t tag;
257*5113495bSYour Name uint8_t signature;
258*5113495bSYour Name } __ATTRIB_PACK;
259*5113495bSYour Name
260*5113495bSYour Name #endif /* BIG_ENDIAN_HOST */
261*5113495bSYour Name
262*5113495bSYour Name /**
263*5113495bSYour Name * struct spectral_phyerr_hdr_gen2 - phyerr header for gen2 HW
264*5113495bSYour Name * @hdr_a: Header[0:31]
265*5113495bSYour Name * @hdr_b: Header[32:63]
266*5113495bSYour Name */
267*5113495bSYour Name struct spectral_phyerr_hdr_gen2 {
268*5113495bSYour Name uint32_t hdr_a;
269*5113495bSYour Name uint32_t hdr_b;
270*5113495bSYour Name };
271*5113495bSYour Name
272*5113495bSYour Name /*
273*5113495bSYour Name * Segment ID information for 80+80.
274*5113495bSYour Name *
275*5113495bSYour Name * If the HW micro-architecture specification extends this DWORD for other
276*5113495bSYour Name * purposes, then redefine+rename accordingly. For now, the specification
277*5113495bSYour Name * mentions only segment ID (though this doesn't require an entire DWORD)
278*5113495bSYour Name * without mention of any generic terminology for the DWORD, or any reservation.
279*5113495bSYour Name * We use nomenclature accordingly.
280*5113495bSYour Name */
281*5113495bSYour Name typedef uint32_t SPECTRAL_SEGID_INFO;
282*5113495bSYour Name
283*5113495bSYour Name /**
284*5113495bSYour Name * struct spectral_phyerr_fft_gen2 - fft info in phyerr event
285*5113495bSYour Name * @buf: fft report
286*5113495bSYour Name */
287*5113495bSYour Name struct spectral_phyerr_fft_gen2 {
288*5113495bSYour Name __QDF_DECLARE_FLEX_ARRAY(uint8_t, buf);
289*5113495bSYour Name };
290*5113495bSYour Name
291*5113495bSYour Name /**
292*5113495bSYour Name * struct spectral_process_phyerr_info_gen2 - Processed phyerr info structures
293*5113495bSYour Name * needed to fill SAMP params for gen2
294*5113495bSYour Name * @p_rfqual: Pointer to RF quality info
295*5113495bSYour Name * @p_sfft: Pointer to Search fft report info
296*5113495bSYour Name * @pfft: Pointer to FFT info in Phyerr event
297*5113495bSYour Name * @acs_stats: Pointer to ACS stats struct
298*5113495bSYour Name * @tsf64: 64 bit TSF value
299*5113495bSYour Name * @seg_id: Segment ID
300*5113495bSYour Name */
301*5113495bSYour Name struct spectral_process_phyerr_info_gen2 {
302*5113495bSYour Name struct target_if_spectral_rfqual_info *p_rfqual;
303*5113495bSYour Name struct spectral_search_fft_info_gen2 *p_sfft;
304*5113495bSYour Name struct spectral_phyerr_fft_gen2 *pfft;
305*5113495bSYour Name struct target_if_spectral_acs_stats *acs_stats;
306*5113495bSYour Name uint64_t tsf64;
307*5113495bSYour Name uint8_t seg_id;
308*5113495bSYour Name };
309*5113495bSYour Name
310*5113495bSYour Name /* END of spectral GEN II HW specific details */
311*5113495bSYour Name
312*5113495bSYour Name /* START of spectral GEN III HW specific details */
313*5113495bSYour Name
314*5113495bSYour Name #define get_bitfield(value, size, pos) \
315*5113495bSYour Name (((value) >> (pos)) & ((1 << (size)) - 1))
316*5113495bSYour Name #define unsigned_to_signed(value, width) \
317*5113495bSYour Name (((value) >= (1 << ((width) - 1))) ? \
318*5113495bSYour Name (value - (1 << (width))) : (value))
319*5113495bSYour Name
320*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_DETECTOR_ID_POS_GEN3 (29)
321*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_DETECTOR_ID_SIZE_GEN3 (2)
322*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_AGC_TOTAL_GAIN_POS_GEN3 (0)
323*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_AGC_TOTAL_GAIN_SIZE_GEN3 (8)
324*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_INBAND_PWR_DB_POS_GEN3 (18)
325*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_INBAND_PWR_DB_SIZE_GEN3 (10)
326*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_PRI80_POS_GEN3 (31)
327*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_A_PRI80_SIZE_GEN3 (1)
328*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_B_GAINCHANGE_POS_GEN3_V1 (30)
329*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_B_GAINCHANGE_SIZE_GEN3_V1 (1)
330*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_C_GAINCHANGE_POS_GEN3_V2 (16)
331*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_HDR_C_GAINCHANGE_SIZE_GEN3_V2 (1)
332*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_PAD_HDR_A_BLANKING_POS_GEN3_V2 (0)
333*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_PAD_HDR_A_BLANKING_SIZE_GEN3_V2 (32)
334*5113495bSYour Name #define SSCAN_SUMMARY_REPORT_PAD_HDR_A_BLANKING_TAG_GEN3_V2 (0xc0debeaf)
335*5113495bSYour Name #define SPECTRAL_REPORT_LTS_HDR_LENGTH_POS_GEN3 (0)
336*5113495bSYour Name #define SPECTRAL_REPORT_LTS_HDR_LENGTH_SIZE_GEN3 (16)
337*5113495bSYour Name #define SPECTRAL_REPORT_LTS_TAG_POS_GEN3 (16)
338*5113495bSYour Name #define SPECTRAL_REPORT_LTS_TAG_SIZE_GEN3 (8)
339*5113495bSYour Name #define SPECTRAL_REPORT_LTS_SIGNATURE_POS_GEN3 (24)
340*5113495bSYour Name #define SPECTRAL_REPORT_LTS_SIGNATURE_SIZE_GEN3 (8)
341*5113495bSYour Name #define FFT_REPORT_HDR_A_DETECTOR_ID_POS_GEN3 (0)
342*5113495bSYour Name #define FFT_REPORT_HDR_A_DETECTOR_ID_SIZE_GEN3 (2)
343*5113495bSYour Name #define FFT_REPORT_HDR_A_FFT_NUM_POS_GEN3 (2)
344*5113495bSYour Name #define FFT_REPORT_HDR_A_FFT_NUM_SIZE_GEN3 (3)
345*5113495bSYour Name #define FFT_REPORT_HDR_A_RADAR_CHECK_POS_GEN3_V1 (5)
346*5113495bSYour Name #define FFT_REPORT_HDR_A_RADAR_CHECK_SIZE_GEN3_V1 (12)
347*5113495bSYour Name #define FFT_REPORT_HDR_A_RADAR_CHECK_POS_GEN3_V2 (5)
348*5113495bSYour Name #define FFT_REPORT_HDR_A_RADAR_CHECK_SIZE_GEN3_V2 (14)
349*5113495bSYour Name #define FFT_REPORT_HDR_A_PEAK_INDEX_POS_GEN3_V1 (17)
350*5113495bSYour Name #define FFT_REPORT_HDR_A_PEAK_INDEX_SIZE_GEN3_V1 (11)
351*5113495bSYour Name #define FFT_REPORT_HDR_A_PEAK_INDEX_POS_GEN3_V2 (19)
352*5113495bSYour Name #define FFT_REPORT_HDR_A_PEAK_INDEX_SIZE_GEN3_V2 (11)
353*5113495bSYour Name #define FFT_REPORT_HDR_A_CHAIN_INDEX_POS_GEN3_V1 (28)
354*5113495bSYour Name #define FFT_REPORT_HDR_A_CHAIN_INDEX_SIZE_GEN3_V1 (3)
355*5113495bSYour Name #define FFT_REPORT_HDR_B_CHAIN_INDEX_POS_GEN3_V2 (0)
356*5113495bSYour Name #define FFT_REPORT_HDR_B_CHAIN_INDEX_SIZE_GEN3_V2 (3)
357*5113495bSYour Name #define FFT_REPORT_HDR_B_BASE_PWR_POS_GEN3_V1 (0)
358*5113495bSYour Name #define FFT_REPORT_HDR_B_BASE_PWR_SIZE_GEN3_V1 (9)
359*5113495bSYour Name #define FFT_REPORT_HDR_B_BASE_PWR_POS_GEN3_V2 (3)
360*5113495bSYour Name #define FFT_REPORT_HDR_B_BASE_PWR_SIZE_GEN3_V2 (9)
361*5113495bSYour Name #define FFT_REPORT_HDR_B_TOTAL_GAIN_POS_GEN3_V1 (9)
362*5113495bSYour Name #define FFT_REPORT_HDR_B_TOTAL_GAIN_SIZE_GEN3_V1 (8)
363*5113495bSYour Name #define FFT_REPORT_HDR_B_TOTAL_GAIN_POS_GEN3_V2 (12)
364*5113495bSYour Name #define FFT_REPORT_HDR_B_TOTAL_GAIN_SIZE_GEN3_V2 (8)
365*5113495bSYour Name #define FFT_REPORT_HDR_C_NUM_STRONG_BINS_POS_GEN3 (0)
366*5113495bSYour Name #define FFT_REPORT_HDR_C_NUM_STRONG_BINS_SIZE_GEN3 (8)
367*5113495bSYour Name #define FFT_REPORT_HDR_C_PEAK_MAGNITUDE_POS_GEN3 (8)
368*5113495bSYour Name #define FFT_REPORT_HDR_C_PEAK_MAGNITUDE_SIZE_GEN3 (10)
369*5113495bSYour Name #define FFT_REPORT_HDR_C_AVG_PWR_POS_GEN3 (18)
370*5113495bSYour Name #define FFT_REPORT_HDR_C_AVG_PWR_SIZE_GEN3 (7)
371*5113495bSYour Name #define FFT_REPORT_HDR_C_RELATIVE_PWR_POS_GEN3 (25)
372*5113495bSYour Name #define FFT_REPORT_HDR_C_RELATIVE_PWR_SIZE_GEN3 (7)
373*5113495bSYour Name
374*5113495bSYour Name #define SPECTRAL_PHYERR_SIGNATURE_GEN3 (0xFA)
375*5113495bSYour Name #define TLV_TAG_SPECTRAL_SUMMARY_REPORT_GEN3 (0x02)
376*5113495bSYour Name #define TLV_TAG_SEARCH_FFT_REPORT_GEN3 (0x03)
377*5113495bSYour Name #define SPECTRAL_PHYERR_TLVSIZE_GEN3 (4)
378*5113495bSYour Name
379*5113495bSYour Name #define NUM_SPECTRAL_DETECTORS_GEN3_V1 (3)
380*5113495bSYour Name #define NUM_SPECTRAL_DETECTORS_GEN3_V2 (2)
381*5113495bSYour Name #define FFT_REPORT_HEADER_LENGTH_GEN3_V2 (24)
382*5113495bSYour Name #define FFT_REPORT_HEADER_LENGTH_GEN3_V1 (16)
383*5113495bSYour Name #define NUM_PADDING_BYTES_SSCAN_SUMARY_REPORT_GEN3_V1 (0)
384*5113495bSYour Name #define NUM_PADDING_BYTES_SSCAN_SUMARY_REPORT_GEN3_V2 (16)
385*5113495bSYour Name
386*5113495bSYour Name #define SPECTRAL_PHYERR_HDR_LTS_POS \
387*5113495bSYour Name (offsetof(struct spectral_phyerr_fft_report_gen3, fft_hdr_lts))
388*5113495bSYour Name #define SPECTRAL_FFT_BINS_POS \
389*5113495bSYour Name (offsetof(struct spectral_phyerr_fft_report_gen3, buf))
390*5113495bSYour Name
391*5113495bSYour Name /**
392*5113495bSYour Name * struct phyerr_info - spectral search fft report for gen3
393*5113495bSYour Name * @data: handle to phyerror buffer
394*5113495bSYour Name * @datalen: length of phyerror buffer
395*5113495bSYour Name * @p_rfqual: rf quality matrices
396*5113495bSYour Name * @p_chaninfo: pointer to chaninfo
397*5113495bSYour Name * @tsf64: 64 bit TSF
398*5113495bSYour Name * @acs_stats: acs stats
399*5113495bSYour Name */
400*5113495bSYour Name struct phyerr_info {
401*5113495bSYour Name uint8_t *data;
402*5113495bSYour Name uint32_t datalen;
403*5113495bSYour Name struct target_if_spectral_rfqual_info *p_rfqual;
404*5113495bSYour Name struct target_if_spectral_chan_info *p_chaninfo;
405*5113495bSYour Name uint64_t tsf64;
406*5113495bSYour Name struct target_if_spectral_acs_stats *acs_stats;
407*5113495bSYour Name };
408*5113495bSYour Name
409*5113495bSYour Name /**
410*5113495bSYour Name * struct spectral_search_fft_info_gen3 - spectral search fft report for gen3
411*5113495bSYour Name * @timestamp: Timestamp at which fft report was generated
412*5113495bSYour Name * @last_raw_timestamp: Previous FFT report's raw timestamp
413*5113495bSYour Name * @adjusted_timestamp: Adjusted timestamp to account for target reset
414*5113495bSYour Name * @fft_detector_id: Which radio generated this report
415*5113495bSYour Name * @fft_num: The FFT count number. Set to 0 for short FFT.
416*5113495bSYour Name * @fft_radar_check: NA for spectral
417*5113495bSYour Name * @fft_peak_sidx: Index of bin with maximum power
418*5113495bSYour Name * @fft_chn_idx: Rx chain index
419*5113495bSYour Name * @fft_base_pwr_db: Base power in dB
420*5113495bSYour Name * @fft_total_gain_db: Total gain in dB
421*5113495bSYour Name * @fft_num_str_bins_ib: Number of strong bins in the report
422*5113495bSYour Name * @fft_peak_mag: Peak magnitude
423*5113495bSYour Name * @fft_avgpwr_db: Average power in dB
424*5113495bSYour Name * @fft_relpwr_db: Relative power in dB
425*5113495bSYour Name * @fft_bin_count: Number of FFT bins in the FFT report
426*5113495bSYour Name * @fft_bin_size: Size of one FFT bin in bytes
427*5113495bSYour Name * @bin_pwr_data: Contains FFT bins extracted from the report
428*5113495bSYour Name */
429*5113495bSYour Name struct spectral_search_fft_info_gen3 {
430*5113495bSYour Name uint32_t timestamp;
431*5113495bSYour Name uint32_t last_raw_timestamp;
432*5113495bSYour Name uint32_t adjusted_timestamp;
433*5113495bSYour Name uint32_t fft_detector_id;
434*5113495bSYour Name uint32_t fft_num;
435*5113495bSYour Name uint32_t fft_radar_check;
436*5113495bSYour Name int32_t fft_peak_sidx;
437*5113495bSYour Name uint32_t fft_chn_idx;
438*5113495bSYour Name uint32_t fft_base_pwr_db;
439*5113495bSYour Name uint32_t fft_total_gain_db;
440*5113495bSYour Name uint32_t fft_num_str_bins_ib;
441*5113495bSYour Name int32_t fft_peak_mag;
442*5113495bSYour Name uint32_t fft_avgpwr_db;
443*5113495bSYour Name uint32_t fft_relpwr_db;
444*5113495bSYour Name uint32_t fft_bin_count;
445*5113495bSYour Name uint8_t fft_bin_size;
446*5113495bSYour Name uint8_t *bin_pwr_data;
447*5113495bSYour Name };
448*5113495bSYour Name
449*5113495bSYour Name /**
450*5113495bSYour Name * struct spectral_phyerr_fft_report_gen3 - fft info in phyerr event
451*5113495bSYour Name * @fft_timestamp: Timestamp at which fft report was generated
452*5113495bSYour Name * @fft_hdr_lts: length, tag, signature fields
453*5113495bSYour Name * @hdr_a: Header[0:31]
454*5113495bSYour Name * @hdr_b: Header[32:63]
455*5113495bSYour Name * @hdr_c: Header[64:95]
456*5113495bSYour Name * @resv: Header[96:127]
457*5113495bSYour Name * @buf: fft bins
458*5113495bSYour Name */
459*5113495bSYour Name struct spectral_phyerr_fft_report_gen3 {
460*5113495bSYour Name uint32_t fft_timestamp;
461*5113495bSYour Name uint32_t fft_hdr_lts;
462*5113495bSYour Name uint32_t hdr_a;
463*5113495bSYour Name uint32_t hdr_b;
464*5113495bSYour Name uint32_t hdr_c;
465*5113495bSYour Name uint32_t resv;
466*5113495bSYour Name uint8_t buf[];
467*5113495bSYour Name } __ATTRIB_PACK;
468*5113495bSYour Name
469*5113495bSYour Name /**
470*5113495bSYour Name * struct sscan_report_fields_gen3 - Fields of spectral report
471*5113495bSYour Name * @sscan_agc_total_gain: The AGC total gain in DB.
472*5113495bSYour Name * @inband_pwr_db: The in-band power of the signal in 1/2 DB steps
473*5113495bSYour Name * @sscan_gainchange: This bit is set to 1 if a gainchange occurred during
474*5113495bSYour Name * the spectral scan FFT. Software may choose to
475*5113495bSYour Name * disregard the results.
476*5113495bSYour Name * @sscan_pri80: This is set to 1 to indicate that the Spectral scan was
477*5113495bSYour Name * performed on the pri80 segment. Software may choose to
478*5113495bSYour Name * disregard the FFT sample if this is set to 1 but detector ID
479*5113495bSYour Name * does not correspond to the ID for the pri80 segment.
480*5113495bSYour Name * @sscan_detector_id: Detector ID in Spectral scan report
481*5113495bSYour Name * @blanking_status: Indicates whether scan blanking was enabled during this
482*5113495bSYour Name * spectral report capture. This field is applicable only when scan blanking
483*5113495bSYour Name * feature is enabled. When scan blanking feature is disabled, this field
484*5113495bSYour Name * will be set to zero.
485*5113495bSYour Name */
486*5113495bSYour Name struct sscan_report_fields_gen3 {
487*5113495bSYour Name uint8_t sscan_agc_total_gain;
488*5113495bSYour Name int16_t inband_pwr_db;
489*5113495bSYour Name uint8_t sscan_gainchange;
490*5113495bSYour Name uint8_t sscan_pri80;
491*5113495bSYour Name uint8_t sscan_detector_id;
492*5113495bSYour Name uint8_t blanking_status;
493*5113495bSYour Name };
494*5113495bSYour Name
495*5113495bSYour Name /**
496*5113495bSYour Name * struct spectral_sscan_summary_report_gen3 - Spectral summary report
497*5113495bSYour Name * event
498*5113495bSYour Name * @sscan_timestamp: Timestamp at which fft report was generated
499*5113495bSYour Name * @sscan_hdr_lts: length, tag, signature fields
500*5113495bSYour Name * @hdr_a: Header[0:31]
501*5113495bSYour Name * @res1: Header[32:63]
502*5113495bSYour Name * @hdr_b: Header[64:95]
503*5113495bSYour Name * @hdr_c: Header[96:127]
504*5113495bSYour Name */
505*5113495bSYour Name struct spectral_sscan_summary_report_gen3 {
506*5113495bSYour Name u_int32_t sscan_timestamp;
507*5113495bSYour Name u_int32_t sscan_hdr_lts;
508*5113495bSYour Name u_int32_t hdr_a;
509*5113495bSYour Name u_int32_t res1;
510*5113495bSYour Name u_int32_t hdr_b;
511*5113495bSYour Name u_int32_t hdr_c;
512*5113495bSYour Name } __ATTRIB_PACK;
513*5113495bSYour Name
514*5113495bSYour Name /**
515*5113495bSYour Name * struct spectral_sscan_summary_report_padding_gen3_v2 - Spectral summary
516*5113495bSYour Name * report padding region
517*5113495bSYour Name * @hdr_a: Header[0:31]
518*5113495bSYour Name * @hdr_b: Header[32:63]
519*5113495bSYour Name * @hdr_c: Header[64:95]
520*5113495bSYour Name * @hdr_d: Header[96:127]
521*5113495bSYour Name */
522*5113495bSYour Name struct spectral_sscan_summary_report_padding_gen3_v2 {
523*5113495bSYour Name u_int32_t hdr_a;
524*5113495bSYour Name u_int32_t hdr_b;
525*5113495bSYour Name u_int32_t hdr_c;
526*5113495bSYour Name u_int32_t hdr_d;
527*5113495bSYour Name } __ATTRIB_PACK;
528*5113495bSYour Name
529*5113495bSYour Name #ifdef DIRECT_BUF_RX_ENABLE
530*5113495bSYour Name /**
531*5113495bSYour Name * struct spectral_report - spectral report
532*5113495bSYour Name * @data: Report buffer
533*5113495bSYour Name * @noisefloor: Noise floor values
534*5113495bSYour Name * @reset_delay: Time taken for warm reset in us
535*5113495bSYour Name * @cfreq1: center frequency 1
536*5113495bSYour Name * @cfreq2: center frequency 2
537*5113495bSYour Name * @ch_width: channel width
538*5113495bSYour Name */
539*5113495bSYour Name struct spectral_report {
540*5113495bSYour Name uint8_t *data;
541*5113495bSYour Name int32_t noisefloor[DBR_MAX_CHAINS];
542*5113495bSYour Name uint32_t reset_delay;
543*5113495bSYour Name uint32_t cfreq1;
544*5113495bSYour Name uint32_t cfreq2;
545*5113495bSYour Name uint32_t ch_width;
546*5113495bSYour Name };
547*5113495bSYour Name #endif
548*5113495bSYour Name /* END of spectral GEN III HW specific details */
549*5113495bSYour Name
550*5113495bSYour Name typedef signed char pwr_dbm;
551*5113495bSYour Name
552*5113495bSYour Name /**
553*5113495bSYour Name * enum spectral_gen - spectral hw generation
554*5113495bSYour Name * @SPECTRAL_GEN1 : spectral hw gen 1
555*5113495bSYour Name * @SPECTRAL_GEN2 : spectral hw gen 2
556*5113495bSYour Name * @SPECTRAL_GEN3 : spectral hw gen 3
557*5113495bSYour Name */
558*5113495bSYour Name enum spectral_gen {
559*5113495bSYour Name SPECTRAL_GEN1,
560*5113495bSYour Name SPECTRAL_GEN2,
561*5113495bSYour Name SPECTRAL_GEN3,
562*5113495bSYour Name };
563*5113495bSYour Name
564*5113495bSYour Name /**
565*5113495bSYour Name * enum spectral_fftbin_size_war - spectral fft bin size war
566*5113495bSYour Name * @SPECTRAL_FFTBIN_SIZE_NO_WAR: No WAR applicable for Spectral FFT bin size
567*5113495bSYour Name * @SPECTRAL_FFTBIN_SIZE_WAR_2BYTE_TO_1BYTE: Spectral FFT bin size: Retain only
568*5113495bSYour Name * least significant byte from 2 byte
569*5113495bSYour Name * FFT bin transferred by HW
570*5113495bSYour Name * @SPECTRAL_FFTBIN_SIZE_WAR_4BYTE_TO_1BYTE: Spectral FFT bin size: Retain only
571*5113495bSYour Name * least significant byte from 4 byte
572*5113495bSYour Name * FFT bin transferred by HW
573*5113495bSYour Name */
574*5113495bSYour Name enum spectral_fftbin_size_war {
575*5113495bSYour Name SPECTRAL_FFTBIN_SIZE_NO_WAR = 0,
576*5113495bSYour Name SPECTRAL_FFTBIN_SIZE_WAR_2BYTE_TO_1BYTE = 1,
577*5113495bSYour Name SPECTRAL_FFTBIN_SIZE_WAR_4BYTE_TO_1BYTE = 2,
578*5113495bSYour Name };
579*5113495bSYour Name
580*5113495bSYour Name /**
581*5113495bSYour Name * enum spectral_report_format_version - This represents the report format
582*5113495bSYour Name * version number within each Spectral generation.
583*5113495bSYour Name * @SPECTRAL_REPORT_FORMAT_VERSION_1 : version 1
584*5113495bSYour Name * @SPECTRAL_REPORT_FORMAT_VERSION_2 : version 2
585*5113495bSYour Name */
586*5113495bSYour Name enum spectral_report_format_version {
587*5113495bSYour Name SPECTRAL_REPORT_FORMAT_VERSION_1,
588*5113495bSYour Name SPECTRAL_REPORT_FORMAT_VERSION_2,
589*5113495bSYour Name };
590*5113495bSYour Name
591*5113495bSYour Name /**
592*5113495bSYour Name * struct spectral_fft_bin_len_adj_swar - Encapsulate information required for
593*5113495bSYour Name * Spectral FFT bin length adjusting software WARS.
594*5113495bSYour Name * @inband_fftbin_size_adj: Whether to carry out FFT bin size adjustment for
595*5113495bSYour Name * in-band report format. This would be required on some chipsets under the
596*5113495bSYour Name * following circumstances: In report mode 2 only the in-band bins are DMA'ed.
597*5113495bSYour Name * Scatter/gather is used. However, the HW generates all bins, not just in-band,
598*5113495bSYour Name * and reports the number of bins accordingly. The subsystem arranging for the
599*5113495bSYour Name * DMA cannot change this value. On such chipsets the adjustment required at the
600*5113495bSYour Name * host driver is to check if report format is 2, and if so halve the number of
601*5113495bSYour Name * bins reported to get the number actually DMA'ed.
602*5113495bSYour Name * @null_fftbin_adj: Whether to remove NULL FFT bins for report mode (1) in
603*5113495bSYour Name * which only summary of metrics for each completed FFT + spectral scan summary
604*5113495bSYour Name * report are to be provided. This would be required on some chipsets under the
605*5113495bSYour Name * following circumstances: In report mode 1, HW reports a length corresponding
606*5113495bSYour Name * to all bins, and provides bins with value 0. This is because the subsystem
607*5113495bSYour Name * arranging for the FFT information does not arrange for DMA of FFT bin values
608*5113495bSYour Name * (as expected), but cannot arrange for a smaller length to be reported by HW.
609*5113495bSYour Name * In these circumstances, the driver would have to disregard the NULL bins and
610*5113495bSYour Name * report a bin count of 0 to higher layers.
611*5113495bSYour Name * @packmode_fftbin_size_adj: Pack mode in HW refers to packing of each Spectral
612*5113495bSYour Name * FFT bin into 2 bytes. But due to a bug HW reports 2 times the expected length
613*5113495bSYour Name * when packmode is enabled. This SWAR compensates this bug by dividing the
614*5113495bSYour Name * length with 2.
615*5113495bSYour Name * @fftbin_size_war: Type of FFT bin size SWAR
616*5113495bSYour Name */
617*5113495bSYour Name struct spectral_fft_bin_len_adj_swar {
618*5113495bSYour Name u_int8_t inband_fftbin_size_adj;
619*5113495bSYour Name u_int8_t null_fftbin_adj;
620*5113495bSYour Name uint8_t packmode_fftbin_size_adj;
621*5113495bSYour Name enum spectral_fftbin_size_war fftbin_size_war;
622*5113495bSYour Name };
623*5113495bSYour Name
624*5113495bSYour Name /**
625*5113495bSYour Name * struct spectral_report_params - Parameters related to format of Spectral
626*5113495bSYour Name * report.
627*5113495bSYour Name * @version: This represents the report format version number within each
628*5113495bSYour Name * Spectral generation.
629*5113495bSYour Name * @ssummary_padding_bytes: Number of bytes of padding after Spectral summary
630*5113495bSYour Name * report
631*5113495bSYour Name * @fft_report_hdr_len: Number of bytes in the header of the FFT report. This
632*5113495bSYour Name * has to be subtracted from the length field of FFT report to find the length
633*5113495bSYour Name * of FFT bins.
634*5113495bSYour Name * @fragmentation_160: This indicates whether Spectral reports in 160/80p80 is
635*5113495bSYour Name * fragmented.
636*5113495bSYour Name * @detid_mode_table: Detector ID to Spectral scan mode table
637*5113495bSYour Name * @num_spectral_detectors: Total number of Spectral detectors
638*5113495bSYour Name * @marker: Describes the boundaries of pri80, 5 MHz and sec80 bins
639*5113495bSYour Name * @hw_fft_bin_width: FFT bin width reported by the HW
640*5113495bSYour Name */
641*5113495bSYour Name struct spectral_report_params {
642*5113495bSYour Name enum spectral_report_format_version version;
643*5113495bSYour Name uint8_t ssummary_padding_bytes;
644*5113495bSYour Name uint8_t fft_report_hdr_len;
645*5113495bSYour Name bool fragmentation_160[SPECTRAL_SCAN_MODE_MAX];
646*5113495bSYour Name enum spectral_scan_mode detid_mode_table[SPECTRAL_DETECTOR_ID_MAX];
647*5113495bSYour Name uint8_t num_spectral_detectors;
648*5113495bSYour Name struct spectral_fft_bin_markers_160_165mhz
649*5113495bSYour Name marker[SPECTRAL_SCAN_MODE_MAX];
650*5113495bSYour Name uint8_t hw_fft_bin_width;
651*5113495bSYour Name };
652*5113495bSYour Name
653*5113495bSYour Name /**
654*5113495bSYour Name * struct spectral_param_min_max - Spectral parameter minimum and maximum values
655*5113495bSYour Name * @fft_size_min: Minimum value of fft_size
656*5113495bSYour Name * @fft_size_max: Maximum value of fft_size for each BW
657*5113495bSYour Name * @scan_count_max: Maximum value of scan count
658*5113495bSYour Name */
659*5113495bSYour Name struct spectral_param_min_max {
660*5113495bSYour Name uint16_t fft_size_min;
661*5113495bSYour Name uint16_t fft_size_max[CH_WIDTH_MAX];
662*5113495bSYour Name uint16_t scan_count_max;
663*5113495bSYour Name };
664*5113495bSYour Name
665*5113495bSYour Name /**
666*5113495bSYour Name * struct spectral_timestamp_war - Spectral time stamp WAR related parameters
667*5113495bSYour Name * @timestamp_war_offset: Offset to be added to correct timestamp
668*5113495bSYour Name * @target_reset_count: Number of times target exercised the reset routine
669*5113495bSYour Name * @last_fft_timestamp: last fft report timestamp
670*5113495bSYour Name */
671*5113495bSYour Name struct spectral_timestamp_war {
672*5113495bSYour Name uint32_t timestamp_war_offset[SPECTRAL_SCAN_MODE_MAX];
673*5113495bSYour Name uint64_t target_reset_count;
674*5113495bSYour Name uint32_t last_fft_timestamp[SPECTRAL_SCAN_MODE_MAX];
675*5113495bSYour Name };
676*5113495bSYour Name
677*5113495bSYour Name #if ATH_PERF_PWR_OFFLOAD
678*5113495bSYour Name /**
679*5113495bSYour Name * enum target_if_spectral_info - Enumerations for specifying which spectral
680*5113495bSYour Name * information (among parameters and states)
681*5113495bSYour Name * is desired.
682*5113495bSYour Name * @TARGET_IF_SPECTRAL_INFO_ACTIVE: Indicated whether spectral is active
683*5113495bSYour Name * @TARGET_IF_SPECTRAL_INFO_ENABLED: Indicated whether spectral is enabled
684*5113495bSYour Name * @TARGET_IF_SPECTRAL_INFO_PARAMS: Config params
685*5113495bSYour Name */
686*5113495bSYour Name enum target_if_spectral_info {
687*5113495bSYour Name TARGET_IF_SPECTRAL_INFO_ACTIVE,
688*5113495bSYour Name TARGET_IF_SPECTRAL_INFO_ENABLED,
689*5113495bSYour Name TARGET_IF_SPECTRAL_INFO_PARAMS,
690*5113495bSYour Name };
691*5113495bSYour Name #endif /* ATH_PERF_PWR_OFFLOAD */
692*5113495bSYour Name
693*5113495bSYour Name /* forward declaration */
694*5113495bSYour Name struct target_if_spectral;
695*5113495bSYour Name
696*5113495bSYour Name /**
697*5113495bSYour Name * struct target_if_spectral_chan_info - Channel information
698*5113495bSYour Name * @center_freq1: center frequency 1 in MHz
699*5113495bSYour Name * @center_freq2: center frequency 2 in MHz -valid only for
700*5113495bSYour Name * 11ACVHT 80PLUS80 mode
701*5113495bSYour Name * @chan_width: channel width in MHz
702*5113495bSYour Name */
703*5113495bSYour Name struct target_if_spectral_chan_info {
704*5113495bSYour Name uint16_t center_freq1;
705*5113495bSYour Name uint16_t center_freq2;
706*5113495bSYour Name uint8_t chan_width;
707*5113495bSYour Name };
708*5113495bSYour Name
709*5113495bSYour Name /**
710*5113495bSYour Name * struct target_if_spectral_acs_stats - EACS stats from spectral samples
711*5113495bSYour Name * @nfc_ctl_rssi: Control chan rssi
712*5113495bSYour Name * @nfc_ext_rssi: Extension chan rssi
713*5113495bSYour Name * @ctrl_nf: Control chan Noise Floor
714*5113495bSYour Name * @ext_nf: Extension chan Noise Floor
715*5113495bSYour Name */
716*5113495bSYour Name struct target_if_spectral_acs_stats {
717*5113495bSYour Name int8_t nfc_ctl_rssi;
718*5113495bSYour Name int8_t nfc_ext_rssi;
719*5113495bSYour Name int8_t ctrl_nf;
720*5113495bSYour Name int8_t ext_nf;
721*5113495bSYour Name };
722*5113495bSYour Name
723*5113495bSYour Name /**
724*5113495bSYour Name * struct target_if_spectral_perchain_rssi_info - per chain rssi info
725*5113495bSYour Name * @rssi_pri20: Rssi of primary 20 Mhz
726*5113495bSYour Name * @rssi_sec20: Rssi of secondary 20 Mhz
727*5113495bSYour Name * @rssi_sec40: Rssi of secondary 40 Mhz
728*5113495bSYour Name * @rssi_sec80: Rssi of secondary 80 Mhz
729*5113495bSYour Name */
730*5113495bSYour Name struct target_if_spectral_perchain_rssi_info {
731*5113495bSYour Name int8_t rssi_pri20;
732*5113495bSYour Name int8_t rssi_sec20;
733*5113495bSYour Name int8_t rssi_sec40;
734*5113495bSYour Name int8_t rssi_sec80;
735*5113495bSYour Name };
736*5113495bSYour Name
737*5113495bSYour Name /**
738*5113495bSYour Name * struct target_if_spectral_rfqual_info - RF measurement information
739*5113495bSYour Name * @rssi_comb: RSSI Information
740*5113495bSYour Name * @pc_rssi_info: XXX : For now, we know we are getting information
741*5113495bSYour Name * for only 4 chains at max. For future extensions
742*5113495bSYour Name * use a define
743*5113495bSYour Name * @noise_floor: Noise floor information
744*5113495bSYour Name */
745*5113495bSYour Name struct target_if_spectral_rfqual_info {
746*5113495bSYour Name int8_t rssi_comb;
747*5113495bSYour Name struct target_if_spectral_perchain_rssi_info pc_rssi_info[4];
748*5113495bSYour Name int16_t noise_floor[4];
749*5113495bSYour Name };
750*5113495bSYour Name
751*5113495bSYour Name #define GET_TARGET_IF_SPECTRAL_OPS(spectral) \
752*5113495bSYour Name ((struct target_if_spectral_ops *)(&((spectral)->spectral_ops)))
753*5113495bSYour Name
754*5113495bSYour Name /**
755*5113495bSYour Name * struct target_if_spectral_ops - spectral low level ops table
756*5113495bSYour Name * @get_tsf64: Get 64 bit TSF value
757*5113495bSYour Name * @get_capability: Get capability info
758*5113495bSYour Name * @set_rxfilter: Set rx filter
759*5113495bSYour Name * @get_rxfilter: Get rx filter
760*5113495bSYour Name * @is_spectral_active: Check whether icm is active
761*5113495bSYour Name * @is_spectral_enabled: Check whether spectral is enabled
762*5113495bSYour Name * @start_spectral_scan: Start spectral scan
763*5113495bSYour Name * @stop_spectral_scan: Stop spectral scan
764*5113495bSYour Name * @get_extension_channel: Get extension channel
765*5113495bSYour Name * @get_ctl_noisefloor: Get control noise floor
766*5113495bSYour Name * @get_ext_noisefloor: Get extension noise floor
767*5113495bSYour Name * @configure_spectral: Set spectral configurations
768*5113495bSYour Name * @get_spectral_config: Get spectral configurations
769*5113495bSYour Name * @get_ent_spectral_mask: Get spectral mask
770*5113495bSYour Name * @get_mac_address: Get mac address
771*5113495bSYour Name * @get_current_channel: Get current channel
772*5113495bSYour Name * @reset_hw: Reset HW
773*5113495bSYour Name * @get_chain_noise_floor: Get Channel noise floor
774*5113495bSYour Name * @spectral_process_phyerr: Process phyerr event
775*5113495bSYour Name * @process_spectral_report: Process spectral report
776*5113495bSYour Name * @byte_swap_headers: Apply byte-swap on report headers
777*5113495bSYour Name * @byte_swap_fft_bins: Apply byte-swap on FFT bins
778*5113495bSYour Name */
779*5113495bSYour Name struct target_if_spectral_ops {
780*5113495bSYour Name uint64_t (*get_tsf64)(void *arg);
781*5113495bSYour Name uint32_t (*get_capability)(
782*5113495bSYour Name void *arg, enum spectral_capability_type type);
783*5113495bSYour Name uint32_t (*set_rxfilter)(void *arg, int rxfilter);
784*5113495bSYour Name uint32_t (*get_rxfilter)(void *arg);
785*5113495bSYour Name uint32_t (*is_spectral_active)(void *arg,
786*5113495bSYour Name enum spectral_scan_mode smode);
787*5113495bSYour Name uint32_t (*is_spectral_enabled)(void *arg,
788*5113495bSYour Name enum spectral_scan_mode smode);
789*5113495bSYour Name uint32_t (*start_spectral_scan)(void *arg,
790*5113495bSYour Name enum spectral_scan_mode smode,
791*5113495bSYour Name enum spectral_cp_error_code *err);
792*5113495bSYour Name uint32_t (*stop_spectral_scan)(void *arg,
793*5113495bSYour Name enum spectral_scan_mode smode);
794*5113495bSYour Name uint32_t (*get_extension_channel)(void *arg,
795*5113495bSYour Name enum spectral_scan_mode smode);
796*5113495bSYour Name int8_t (*get_ctl_noisefloor)(void *arg);
797*5113495bSYour Name int8_t (*get_ext_noisefloor)(void *arg);
798*5113495bSYour Name uint32_t (*configure_spectral)(
799*5113495bSYour Name void *arg,
800*5113495bSYour Name struct spectral_config *params,
801*5113495bSYour Name enum spectral_scan_mode smode);
802*5113495bSYour Name uint32_t (*get_spectral_config)(
803*5113495bSYour Name void *arg,
804*5113495bSYour Name struct spectral_config *params,
805*5113495bSYour Name enum spectral_scan_mode smode);
806*5113495bSYour Name uint32_t (*get_ent_spectral_mask)(void *arg);
807*5113495bSYour Name uint32_t (*get_mac_address)(void *arg, char *addr);
808*5113495bSYour Name uint32_t (*get_current_channel)(void *arg,
809*5113495bSYour Name enum spectral_scan_mode smode);
810*5113495bSYour Name uint32_t (*reset_hw)(void *arg);
811*5113495bSYour Name uint32_t (*get_chain_noise_floor)(void *arg, int16_t *nf_buf);
812*5113495bSYour Name int (*spectral_process_phyerr)(struct target_if_spectral *spectral,
813*5113495bSYour Name uint8_t *data, uint32_t datalen,
814*5113495bSYour Name struct target_if_spectral_rfqual_info *p_rfqual,
815*5113495bSYour Name struct target_if_spectral_chan_info *p_chaninfo,
816*5113495bSYour Name uint64_t tsf64,
817*5113495bSYour Name struct target_if_spectral_acs_stats *acs_stats);
818*5113495bSYour Name int (*process_spectral_report)(struct wlan_objmgr_pdev *pdev,
819*5113495bSYour Name void *payload);
820*5113495bSYour Name QDF_STATUS (*byte_swap_headers)(
821*5113495bSYour Name struct target_if_spectral *spectral,
822*5113495bSYour Name void *data);
823*5113495bSYour Name QDF_STATUS (*byte_swap_fft_bins)(
824*5113495bSYour Name const struct spectral_report_params *rparams,
825*5113495bSYour Name void *bin_pwr_data, size_t num_fftbins);
826*5113495bSYour Name };
827*5113495bSYour Name
828*5113495bSYour Name /**
829*5113495bSYour Name * struct target_if_spectral_stats - spectral stats info
830*5113495bSYour Name * @num_spectral_detects: Total num. of spectral detects
831*5113495bSYour Name * @total_phy_errors: Total number of phyerrors
832*5113495bSYour Name * @owl_phy_errors: Indicated phyerrors in old gen1 chipsets
833*5113495bSYour Name * @pri_phy_errors: Phyerrors in primary channel
834*5113495bSYour Name * @ext_phy_errors: Phyerrors in secondary channel
835*5113495bSYour Name * @dc_phy_errors: Phyerrors due to dc
836*5113495bSYour Name * @early_ext_phy_errors: Early secondary channel phyerrors
837*5113495bSYour Name * @bwinfo_errors: Bandwidth info errors
838*5113495bSYour Name * @datalen_discards: Invalid data length errors, seen in gen1 chipsets
839*5113495bSYour Name * @rssi_discards: Indicates reports dropped due to RSSI threshold
840*5113495bSYour Name * @last_reset_tstamp: Last reset time stamp
841*5113495bSYour Name */
842*5113495bSYour Name struct target_if_spectral_stats {
843*5113495bSYour Name uint32_t num_spectral_detects;
844*5113495bSYour Name uint32_t total_phy_errors;
845*5113495bSYour Name uint32_t owl_phy_errors;
846*5113495bSYour Name uint32_t pri_phy_errors;
847*5113495bSYour Name uint32_t ext_phy_errors;
848*5113495bSYour Name uint32_t dc_phy_errors;
849*5113495bSYour Name uint32_t early_ext_phy_errors;
850*5113495bSYour Name uint32_t bwinfo_errors;
851*5113495bSYour Name uint32_t datalen_discards;
852*5113495bSYour Name uint32_t rssi_discards;
853*5113495bSYour Name uint64_t last_reset_tstamp;
854*5113495bSYour Name };
855*5113495bSYour Name
856*5113495bSYour Name /**
857*5113495bSYour Name * struct target_if_spectral_event - spectral event structure
858*5113495bSYour Name * @se_ts: Original 15 bit recv timestamp
859*5113495bSYour Name * @se_full_ts: 64-bit full timestamp from interrupt time
860*5113495bSYour Name * @se_rssi: Rssi of spectral event
861*5113495bSYour Name * @se_bwinfo: Rssi of spectral event
862*5113495bSYour Name * @se_dur: Duration of spectral pulse
863*5113495bSYour Name * @se_chanindex: Channel of event
864*5113495bSYour Name * @se_list: List of spectral events
865*5113495bSYour Name */
866*5113495bSYour Name struct target_if_spectral_event {
867*5113495bSYour Name uint32_t se_ts;
868*5113495bSYour Name uint64_t se_full_ts;
869*5113495bSYour Name uint8_t se_rssi;
870*5113495bSYour Name uint8_t se_bwinfo;
871*5113495bSYour Name uint8_t se_dur;
872*5113495bSYour Name uint8_t se_chanindex;
873*5113495bSYour Name
874*5113495bSYour Name STAILQ_ENTRY(spectral_event) se_list;
875*5113495bSYour Name };
876*5113495bSYour Name
877*5113495bSYour Name /**
878*5113495bSYour Name * struct target_if_chain_noise_pwr_info - Noise power info for each channel
879*5113495bSYour Name * @rptcount: Count of reports in pwr array
880*5113495bSYour Name * @un_cal_nf: Uncalibrated noise floor
881*5113495bSYour Name * @factory_cal_nf: Noise floor as calibrated at the factory for module
882*5113495bSYour Name * @median_pwr: Median power (median of pwr array)
883*5113495bSYour Name * @pwr: Power reports
884*5113495bSYour Name */
885*5113495bSYour Name struct target_if_chain_noise_pwr_info {
886*5113495bSYour Name int rptcount;
887*5113495bSYour Name pwr_dbm un_cal_nf;
888*5113495bSYour Name pwr_dbm factory_cal_nf;
889*5113495bSYour Name pwr_dbm median_pwr;
890*5113495bSYour Name pwr_dbm pwr[];
891*5113495bSYour Name } __ATTRIB_PACK;
892*5113495bSYour Name
893*5113495bSYour Name /**
894*5113495bSYour Name * struct target_if_spectral_chan_stats - Channel information
895*5113495bSYour Name * @cycle_count: Cycle count
896*5113495bSYour Name * @channel_load: Channel load
897*5113495bSYour Name * @per: Period
898*5113495bSYour Name * @noisefloor: Noise floor
899*5113495bSYour Name * @comp_usablity: Computed usability
900*5113495bSYour Name * @maxregpower: Maximum allowed regulatary power
901*5113495bSYour Name * @comp_usablity_sec80: Computed usability of secondary 80 Mhz
902*5113495bSYour Name * @maxregpower_sec80: Max regulatory power in secondary 80 Mhz
903*5113495bSYour Name */
904*5113495bSYour Name struct target_if_spectral_chan_stats {
905*5113495bSYour Name int cycle_count;
906*5113495bSYour Name int channel_load;
907*5113495bSYour Name int per;
908*5113495bSYour Name int noisefloor;
909*5113495bSYour Name uint16_t comp_usablity;
910*5113495bSYour Name int8_t maxregpower;
911*5113495bSYour Name uint16_t comp_usablity_sec80;
912*5113495bSYour Name int8_t maxregpower_sec80;
913*5113495bSYour Name };
914*5113495bSYour Name
915*5113495bSYour Name #if ATH_PERF_PWR_OFFLOAD
916*5113495bSYour Name
917*5113495bSYour Name /**
918*5113495bSYour Name * struct target_if_spectral_cache - Cache used to minimize WMI operations
919*5113495bSYour Name * in offload architecture
920*5113495bSYour Name * @osc_spectral_enabled: Whether Spectral is enabled
921*5113495bSYour Name * @osc_spectral_active: Whether spectral is active
922*5113495bSYour Name * XXX: Ideally, we should NOT cache this
923*5113495bSYour Name * since the hardware can self clear the bit,
924*5113495bSYour Name * the firmware can possibly stop spectral due to
925*5113495bSYour Name * intermittent off-channel activity, etc
926*5113495bSYour Name * A WMI read command should be introduced to handle
927*5113495bSYour Name * this This will be discussed.
928*5113495bSYour Name * @osc_params: Spectral parameters
929*5113495bSYour Name * @osc_is_valid: Whether the cache is valid
930*5113495bSYour Name */
931*5113495bSYour Name struct target_if_spectral_cache {
932*5113495bSYour Name uint8_t osc_spectral_enabled;
933*5113495bSYour Name uint8_t osc_spectral_active;
934*5113495bSYour Name struct spectral_config osc_params;
935*5113495bSYour Name uint8_t osc_is_valid;
936*5113495bSYour Name };
937*5113495bSYour Name
938*5113495bSYour Name /**
939*5113495bSYour Name * struct target_if_spectral_param_state_info - Structure used to represent and
940*5113495bSYour Name * manage spectral information
941*5113495bSYour Name * (parameters and states)
942*5113495bSYour Name * @osps_lock: Lock to synchronize accesses to information
943*5113495bSYour Name * @osps_cache: Cacheable' information
944*5113495bSYour Name */
945*5113495bSYour Name struct target_if_spectral_param_state_info {
946*5113495bSYour Name qdf_spinlock_t osps_lock;
947*5113495bSYour Name struct target_if_spectral_cache osps_cache;
948*5113495bSYour Name /* XXX - Non-cacheable information goes here, in the future */
949*5113495bSYour Name };
950*5113495bSYour Name #endif /* ATH_PERF_PWR_OFFLOAD */
951*5113495bSYour Name
952*5113495bSYour Name struct vdev_spectral_configure_params;
953*5113495bSYour Name struct vdev_spectral_enable_params;
954*5113495bSYour Name
955*5113495bSYour Name /**
956*5113495bSYour Name * struct spectral_wmi_ops - structure used holding the operations
957*5113495bSYour Name * related to Spectral WMI
958*5113495bSYour Name * @wmi_spectral_configure_cmd_send: Configure Spectral parameters
959*5113495bSYour Name * @wmi_spectral_enable_cmd_send: Enable/Disable Spectral
960*5113495bSYour Name * @wmi_spectral_crash_inject: Inject FW crash
961*5113495bSYour Name * @wmi_extract_pdev_sscan_fw_cmd_fixed_param: Extract Fixed params from
962*5113495bSYour Name * start scan response event
963*5113495bSYour Name * @wmi_extract_pdev_sscan_fft_bin_index: Extract TLV which describes FFT
964*5113495bSYour Name * bin indices from start scan response event
965*5113495bSYour Name * @wmi_unified_register_event_handler: Register WMI event handler
966*5113495bSYour Name * @wmi_unified_unregister_event_handler: Unregister WMI event handler
967*5113495bSYour Name * @wmi_service_enabled: API to check whether a given WMI service is enabled
968*5113495bSYour Name * @extract_pdev_spectral_session_chan_info: Extract Spectral scan session
969*5113495bSYour Name * channel information
970*5113495bSYour Name * @extract_pdev_spectral_session_detector_info: Extract Spectral scan session
971*5113495bSYour Name * detector information
972*5113495bSYour Name * @extract_spectral_caps_fixed_param: Extract fixed parameters from Spectral
973*5113495bSYour Name * capabilities event
974*5113495bSYour Name * @extract_spectral_scan_bw_caps: Extract bandwidth capabilities from Spectral
975*5113495bSYour Name * capabilities event
976*5113495bSYour Name * @extract_spectral_fft_size_caps: Extract fft size capabilities from Spectral
977*5113495bSYour Name * capabilities event
978*5113495bSYour Name */
979*5113495bSYour Name struct spectral_wmi_ops {
980*5113495bSYour Name QDF_STATUS (*wmi_spectral_configure_cmd_send)(
981*5113495bSYour Name wmi_unified_t wmi_hdl,
982*5113495bSYour Name struct vdev_spectral_configure_params *param);
983*5113495bSYour Name QDF_STATUS (*wmi_spectral_enable_cmd_send)(
984*5113495bSYour Name wmi_unified_t wmi_hdl,
985*5113495bSYour Name struct vdev_spectral_enable_params *param);
986*5113495bSYour Name QDF_STATUS (*wmi_spectral_crash_inject)(
987*5113495bSYour Name wmi_unified_t wmi_handle, struct crash_inject *param);
988*5113495bSYour Name QDF_STATUS (*wmi_extract_pdev_sscan_fw_cmd_fixed_param)(
989*5113495bSYour Name wmi_unified_t wmi_handle, uint8_t *evt_buf,
990*5113495bSYour Name struct spectral_startscan_resp_params *param);
991*5113495bSYour Name QDF_STATUS (*wmi_extract_pdev_sscan_fft_bin_index)(
992*5113495bSYour Name wmi_unified_t wmi_handle, uint8_t *evt_buf,
993*5113495bSYour Name struct spectral_fft_bin_markers_160_165mhz *param);
994*5113495bSYour Name QDF_STATUS (*wmi_unified_register_event_handler)(
995*5113495bSYour Name wmi_unified_t wmi_handle,
996*5113495bSYour Name wmi_conv_event_id event_id,
997*5113495bSYour Name wmi_unified_event_handler handler_func,
998*5113495bSYour Name uint8_t rx_ctx);
999*5113495bSYour Name QDF_STATUS (*wmi_unified_unregister_event_handler)(
1000*5113495bSYour Name wmi_unified_t wmi_handle,
1001*5113495bSYour Name wmi_conv_event_id event_id);
1002*5113495bSYour Name bool (*wmi_service_enabled)(wmi_unified_t wmi_handle,
1003*5113495bSYour Name uint32_t service_id);
1004*5113495bSYour Name QDF_STATUS (*extract_pdev_spectral_session_chan_info)(
1005*5113495bSYour Name wmi_unified_t wmi_handle, void *event,
1006*5113495bSYour Name struct spectral_session_chan_info *chan_info);
1007*5113495bSYour Name QDF_STATUS (*extract_pdev_spectral_session_detector_info)(
1008*5113495bSYour Name wmi_unified_t wmi_handle, void *event,
1009*5113495bSYour Name struct spectral_session_det_info *det_info,
1010*5113495bSYour Name uint8_t det_info_idx);
1011*5113495bSYour Name QDF_STATUS (*extract_spectral_caps_fixed_param)(
1012*5113495bSYour Name wmi_unified_t wmi_handle, void *event,
1013*5113495bSYour Name struct spectral_capabilities_event_params *param);
1014*5113495bSYour Name QDF_STATUS (*extract_spectral_scan_bw_caps)(
1015*5113495bSYour Name wmi_unified_t wmi_handle, void *event,
1016*5113495bSYour Name struct spectral_scan_bw_capabilities *bw_caps);
1017*5113495bSYour Name QDF_STATUS (*extract_spectral_fft_size_caps)(
1018*5113495bSYour Name wmi_unified_t wmi_handle, void *event,
1019*5113495bSYour Name struct spectral_fft_size_capabilities *fft_size_caps);
1020*5113495bSYour Name };
1021*5113495bSYour Name
1022*5113495bSYour Name /**
1023*5113495bSYour Name * struct spectral_tgt_ops - structure used holding the operations
1024*5113495bSYour Name * related to target operations
1025*5113495bSYour Name * @tgt_get_psoc_from_scn_hdl: Function to get psoc from scn
1026*5113495bSYour Name */
1027*5113495bSYour Name struct spectral_tgt_ops {
1028*5113495bSYour Name struct wlan_objmgr_psoc *(*tgt_get_psoc_from_scn_hdl)(void *scn_handle);
1029*5113495bSYour Name };
1030*5113495bSYour Name
1031*5113495bSYour Name /**
1032*5113495bSYour Name * struct spectral_param_properties - structure holding Spectral
1033*5113495bSYour Name * parameter properties
1034*5113495bSYour Name * @supported: Parameter is supported or not
1035*5113495bSYour Name * @common_all_modes: Parameter should be common for all modes or not
1036*5113495bSYour Name */
1037*5113495bSYour Name struct spectral_param_properties {
1038*5113495bSYour Name bool supported;
1039*5113495bSYour Name bool common_all_modes;
1040*5113495bSYour Name };
1041*5113495bSYour Name
1042*5113495bSYour Name /**
1043*5113495bSYour Name * struct target_if_finite_spectral_scan_params - Parameters related to finite
1044*5113495bSYour Name * Spectral scan
1045*5113495bSYour Name * @finite_spectral_scan: Indicates the Spectrl scan is finite/infinite
1046*5113495bSYour Name * @num_reports_expected: Number of Spectral reports expected from target for a
1047*5113495bSYour Name * finite Spectral scan
1048*5113495bSYour Name */
1049*5113495bSYour Name struct target_if_finite_spectral_scan_params {
1050*5113495bSYour Name bool finite_spectral_scan;
1051*5113495bSYour Name uint32_t num_reports_expected;
1052*5113495bSYour Name };
1053*5113495bSYour Name
1054*5113495bSYour Name /**
1055*5113495bSYour Name * struct per_session_dest_det_info - Per-session Detector information to be
1056*5113495bSYour Name * filled to samp_detector_info
1057*5113495bSYour Name * @freq_span_id: Contiguous frequency span ID within the SAMP message
1058*5113495bSYour Name * @is_sec80: Indicates pri80/sec80 segment for 160/80p80 BW
1059*5113495bSYour Name * @det_id: Detector ID within samp_freq_span_info corresponding to
1060*5113495bSYour Name * freq_span_id
1061*5113495bSYour Name * @dest_start_bin_idx: Start index of FFT bins within SAMP msg's bin_pwr array
1062*5113495bSYour Name * @dest_end_bin_idx: End index of FFT bins within SAMP msg's bin_pwr array
1063*5113495bSYour Name * @lb_extrabins_start_idx: Left band edge extra bins start index
1064*5113495bSYour Name * @lb_extrabins_num: Number of left band edge extra bins
1065*5113495bSYour Name * @rb_extrabins_start_idx: Right band edge extra bins start index
1066*5113495bSYour Name * @rb_extrabins_num: Number of right band edge extra bins
1067*5113495bSYour Name * @start_freq: Indicates start frequency per-detector (in MHz)
1068*5113495bSYour Name * @end_freq: Indicates last frequency per-detector (in MHz)
1069*5113495bSYour Name * @src_start_bin_idx: Start index within the Spectral report's bin_pwr array,
1070*5113495bSYour Name * where the FFT bins corresponding to this dest_det_id start
1071*5113495bSYour Name */
1072*5113495bSYour Name struct per_session_dest_det_info {
1073*5113495bSYour Name uint8_t freq_span_id;
1074*5113495bSYour Name bool is_sec80;
1075*5113495bSYour Name uint8_t det_id;
1076*5113495bSYour Name uint16_t dest_start_bin_idx;
1077*5113495bSYour Name uint16_t dest_end_bin_idx;
1078*5113495bSYour Name uint16_t lb_extrabins_start_idx;
1079*5113495bSYour Name uint16_t lb_extrabins_num;
1080*5113495bSYour Name uint16_t rb_extrabins_start_idx;
1081*5113495bSYour Name uint16_t rb_extrabins_num;
1082*5113495bSYour Name uint32_t start_freq;
1083*5113495bSYour Name uint32_t end_freq;
1084*5113495bSYour Name uint16_t src_start_bin_idx;
1085*5113495bSYour Name };
1086*5113495bSYour Name
1087*5113495bSYour Name /**
1088*5113495bSYour Name * struct per_session_det_map - A map of per-session detector information,
1089*5113495bSYour Name * keyed by the detector id obtained from the Spectral FFT report, mapping to
1090*5113495bSYour Name * destination detector info in SAMP message.
1091*5113495bSYour Name * @dest_det_info: Struct containing per-session detector information
1092*5113495bSYour Name * @num_dest_det_info: Number of destination detectors to which information
1093*5113495bSYour Name * of this detector is to be filled
1094*5113495bSYour Name * @buf_type: Spectral message buffer type
1095*5113495bSYour Name * @send_to_upper_layers: Indicates whether to send SAMP msg to upper layers
1096*5113495bSYour Name * @det_map_valid: Indicates whether detector map is valid or not
1097*5113495bSYour Name */
1098*5113495bSYour Name struct per_session_det_map {
1099*5113495bSYour Name struct per_session_dest_det_info
1100*5113495bSYour Name dest_det_info[MAX_NUM_DEST_DETECTOR_INFO];
1101*5113495bSYour Name uint8_t num_dest_det_info;
1102*5113495bSYour Name enum spectral_msg_buf_type buf_type;
1103*5113495bSYour Name bool send_to_upper_layers;
1104*5113495bSYour Name bool det_map_valid[SPECTRAL_SCAN_MODE_MAX];
1105*5113495bSYour Name };
1106*5113495bSYour Name
1107*5113495bSYour Name /**
1108*5113495bSYour Name * struct per_session_report_info - Consists of per-session Spectral report
1109*5113495bSYour Name * information to be filled at report level in SAMP message.
1110*5113495bSYour Name * @pri20_freq: Primary 20MHz operating frequency in MHz
1111*5113495bSYour Name * @cfreq1: Centre frequency of the frequency span for 20/40/80 MHz BW.
1112*5113495bSYour Name * Segment 1 centre frequency in MHz for 80p80/160 BW.
1113*5113495bSYour Name * @cfreq2: For 80p80, indicates segment 2 centre frequency in MHz. For 160MHz,
1114*5113495bSYour Name * indicates the center frequency of 160MHz span.
1115*5113495bSYour Name * @operating_bw: Device's operating bandwidth.Valid values = enum phy_ch_width
1116*5113495bSYour Name * @sscan_cfreq1: Normal/Agile scan Centre frequency of the frequency span for
1117*5113495bSYour Name * 20/40/80 MHz BW. Center frequency of Primary Segment in MHz for 80p80/160 BW
1118*5113495bSYour Name * Based on Spectral scan mode.
1119*5113495bSYour Name * @sscan_cfreq2: For 80p80, Normal/Agile scan Center frequency for Sec80
1120*5113495bSYour Name * segment. For 160MHz, indicates the center frequency of 160MHz span. Based on
1121*5113495bSYour Name * spectral scan mode
1122*5113495bSYour Name * @sscan_bw: Normal/Agile Scan BW based on Spectral scan mode.
1123*5113495bSYour Name * Valid values = enum phy_ch_width
1124*5113495bSYour Name * @num_spans: Number of frequency spans
1125*5113495bSYour Name * @valid: Indicated whether report info is valid
1126*5113495bSYour Name */
1127*5113495bSYour Name struct per_session_report_info {
1128*5113495bSYour Name uint32_t pri20_freq;
1129*5113495bSYour Name uint32_t cfreq1;
1130*5113495bSYour Name uint32_t cfreq2;
1131*5113495bSYour Name enum phy_ch_width operating_bw;
1132*5113495bSYour Name uint32_t sscan_cfreq1;
1133*5113495bSYour Name uint32_t sscan_cfreq2;
1134*5113495bSYour Name enum phy_ch_width sscan_bw;
1135*5113495bSYour Name uint8_t num_spans;
1136*5113495bSYour Name bool valid;
1137*5113495bSYour Name };
1138*5113495bSYour Name
1139*5113495bSYour Name /**
1140*5113495bSYour Name * struct sscan_detector_list - Spectral scan Detector list, for given Spectral
1141*5113495bSYour Name * scan mode and operating BW
1142*5113495bSYour Name * @detectors: List of detectors
1143*5113495bSYour Name * @num_detectors: Number of detectors for given spectral scan mode, BW
1144*5113495bSYour Name * and target type
1145*5113495bSYour Name */
1146*5113495bSYour Name struct sscan_detector_list {
1147*5113495bSYour Name uint8_t detectors[SPECTRAL_DETECTOR_ID_MAX];
1148*5113495bSYour Name uint8_t num_detectors;
1149*5113495bSYour Name };
1150*5113495bSYour Name
1151*5113495bSYour Name /**
1152*5113495bSYour Name * struct spectral_supported_bws - Supported sscan bandwidths
1153*5113495bSYour Name * @supports_sscan_bw_5: 5 MHz bandwidth supported
1154*5113495bSYour Name * @supports_sscan_bw_10: 10 MHz bandwidth supported
1155*5113495bSYour Name * @supports_sscan_bw_20: 20 MHz bandwidth supported
1156*5113495bSYour Name * @supports_sscan_bw_40: 40 MHz bandwidth supported
1157*5113495bSYour Name * @supports_sscan_bw_80: 80 MHz bandwidth supported
1158*5113495bSYour Name * @supports_sscan_bw_160: 160 MHz bandwidth supported
1159*5113495bSYour Name * @supports_sscan_bw_80_80: 80+80 MHz bandwidth supported
1160*5113495bSYour Name * @supports_sscan_bw_320: 320 MHz bandwidth supported
1161*5113495bSYour Name * @reserved: reserved for future use
1162*5113495bSYour Name * @bandwidths: bitmap of supported sscan bandwidths. Make sure to maintain this
1163*5113495bSYour Name * bitmap in the increasing order of bandwidths.
1164*5113495bSYour Name */
1165*5113495bSYour Name struct spectral_supported_bws {
1166*5113495bSYour Name union {
1167*5113495bSYour Name struct {
1168*5113495bSYour Name uint32_t supports_sscan_bw_5:1,
1169*5113495bSYour Name supports_sscan_bw_10:1,
1170*5113495bSYour Name supports_sscan_bw_20:1,
1171*5113495bSYour Name supports_sscan_bw_40:1,
1172*5113495bSYour Name supports_sscan_bw_80:1,
1173*5113495bSYour Name supports_sscan_bw_160:1,
1174*5113495bSYour Name supports_sscan_bw_80_80:1,
1175*5113495bSYour Name supports_sscan_bw_320:1,
1176*5113495bSYour Name reserved:24;
1177*5113495bSYour Name };
1178*5113495bSYour Name uint32_t bandwidths;
1179*5113495bSYour Name };
1180*5113495bSYour Name };
1181*5113495bSYour Name
1182*5113495bSYour Name /**
1183*5113495bSYour Name * get_supported_sscan_bw_pos() - Get the position of a given sscan_bw inside
1184*5113495bSYour Name * the supported sscan bandwidths bitmap
1185*5113495bSYour Name * @sscan_bw: Spectral scan bandwidth
1186*5113495bSYour Name *
1187*5113495bSYour Name * Return: bit position for a valid sscan bandwidth, else -1
1188*5113495bSYour Name */
1189*5113495bSYour Name int get_supported_sscan_bw_pos(enum phy_ch_width sscan_bw);
1190*5113495bSYour Name
1191*5113495bSYour Name /**
1192*5113495bSYour Name * struct target_if_spectral - main spectral structure
1193*5113495bSYour Name * @pdev_obj: Pointer to pdev
1194*5113495bSYour Name * @spectral_ops: Target if internal Spectral low level operations table
1195*5113495bSYour Name * @capability: Spectral capabilities structure
1196*5113495bSYour Name * @properties: Spectral parameter properties per mode
1197*5113495bSYour Name * @spectral_lock: Lock used for internal Spectral operations
1198*5113495bSYour Name * @vdev_id: VDEV id for all spectral modes
1199*5113495bSYour Name * @spectral_curchan_radindex: Current channel spectral index
1200*5113495bSYour Name * @spectral_extchan_radindex: Extension channel spectral index
1201*5113495bSYour Name * @spectraldomain: Current Spectral domain
1202*5113495bSYour Name * @spectral_proc_phyerr: Flags to process for PHY errors
1203*5113495bSYour Name * @spectral_defaultparams: Default PHY params per Spectral stat
1204*5113495bSYour Name * @spectral_stats: Spectral related stats
1205*5113495bSYour Name * @events: Events structure
1206*5113495bSYour Name * @sc_spectral_ext_chan_ok: Can spectral be detected on the extension channel?
1207*5113495bSYour Name * @sc_spectral_combined_rssi_ok: Can use combined spectral RSSI?
1208*5113495bSYour Name * @sc_spectral_20_40_mode: Is AP in 20-40 mode?
1209*5113495bSYour Name * @sc_spectral_noise_pwr_cal: Noise power cal required?
1210*5113495bSYour Name * @sc_spectral_non_edma: Is the spectral capable device Non-EDMA?
1211*5113495bSYour Name * @upper_is_control: Upper segment is primary
1212*5113495bSYour Name * @upper_is_extension: Upper segment is secondary
1213*5113495bSYour Name * @lower_is_control: Lower segment is primary
1214*5113495bSYour Name * @lower_is_extension: Lower segment is secondary
1215*5113495bSYour Name * @sc_spectraltest_ieeechan: IEEE channel number to return to after a spectral
1216*5113495bSYour Name * mute test
1217*5113495bSYour Name * @spectral_numbins: Number of bins
1218*5113495bSYour Name * @spectral_fft_len: FFT length
1219*5113495bSYour Name * @spectral_data_len: Total phyerror report length
1220*5113495bSYour Name * @lb_edge_extrabins: Number of extra bins on left band edge
1221*5113495bSYour Name * @rb_edge_extrabins: Number of extra bins on right band edge
1222*5113495bSYour Name * @spectral_max_index_offset: Max FFT index offset (20 MHz mode)
1223*5113495bSYour Name * @spectral_upper_max_index_offset: Upper max FFT index offset (20/40 MHz mode)
1224*5113495bSYour Name * @spectral_lower_max_index_offset: Lower max FFT index offset (20/40 MHz mode)
1225*5113495bSYour Name * @spectral_dc_index: At which index DC is present
1226*5113495bSYour Name * @send_single_packet: Deprecated
1227*5113495bSYour Name * @spectral_sent_msg: Indicates whether we send report to upper layers
1228*5113495bSYour Name * @classify_scan:
1229*5113495bSYour Name * @classify_timer:
1230*5113495bSYour Name * @params: Spectral parameters
1231*5113495bSYour Name * @params_valid:
1232*5113495bSYour Name * @classifier_params:
1233*5113495bSYour Name * @last_capture_time: Indicates timestamp of previous report
1234*5113495bSYour Name * @num_spectral_data: Number of Spectral samples received in current session
1235*5113495bSYour Name * @total_spectral_data: Total number of Spectral samples received
1236*5113495bSYour Name * @max_rssi: Maximum RSSI
1237*5113495bSYour Name * @detects_control_channel: NA
1238*5113495bSYour Name * @detects_extension_channel: NA
1239*5113495bSYour Name * @detects_below_dc: NA
1240*5113495bSYour Name * @detects_above_dc: NA
1241*5113495bSYour Name * @sc_scanning: Indicates active wifi scan
1242*5113495bSYour Name * @sc_spectral_scan: Indicates active specral scan
1243*5113495bSYour Name * @sc_spectral_full_scan: Deprecated
1244*5113495bSYour Name * @scan_start_tstamp: Deprecated
1245*5113495bSYour Name * @last_tstamp: Deprecated
1246*5113495bSYour Name * @first_tstamp: Deprecated
1247*5113495bSYour Name * @spectral_samp_count: Deprecated
1248*5113495bSYour Name * @sc_spectral_samp_count: Deprecated
1249*5113495bSYour Name * @noise_pwr_reports_reqd: Number of noise power reports required
1250*5113495bSYour Name * @noise_pwr_reports_recv: Number of noise power reports received
1251*5113495bSYour Name * @noise_pwr_reports_lock: Lock used for Noise power report processing
1252*5113495bSYour Name * @noise_pwr_chain_ctl: Noise power report - control channel
1253*5113495bSYour Name * @noise_pwr_chain_ext: Noise power report - extension channel
1254*5113495bSYour Name * @tsf64: Latest TSF Value
1255*5113495bSYour Name * @param_info: Offload architecture Spectral parameter cache information
1256*5113495bSYour Name * @ch_width: Indicates Channel Width 20/40/80/160 MHz for each Spectral mode
1257*5113495bSYour Name * @sscan_width_configured: Whether user has configured sscan bandwidth
1258*5113495bSYour Name * @diag_stats: Diagnostic statistics
1259*5113495bSYour Name * @is_160_format: Indicates whether information provided by HW is in altered
1260*5113495bSYour Name * format for 802.11ac 160/80+80 MHz support (QCA9984 onwards)
1261*5113495bSYour Name * @is_lb_edge_extrabins_format: Indicates whether information provided by
1262*5113495bSYour Name * HW has 4 extra bins, at left band edge, for report mode 2
1263*5113495bSYour Name * @is_rb_edge_extrabins_format: Indicates whether information provided
1264*5113495bSYour Name * by HW has 4 extra bins, at right band edge, for report mode 2
1265*5113495bSYour Name * @is_sec80_rssi_war_required: Indicates whether the software workaround is
1266*5113495bSYour Name * required to obtain approximate combined RSSI for secondary 80Mhz segment
1267*5113495bSYour Name * @simctx: Spectral Simulation context
1268*5113495bSYour Name * @spectral_gen: Spectral hardware generation
1269*5113495bSYour Name * @hdr_sig_exp: Expected signature in PHYERR TLV header, for the given hardware
1270*5113495bSYour Name * generation
1271*5113495bSYour Name * @tag_sscan_summary_exp: Expected Spectral Scan Summary tag in PHYERR TLV
1272*5113495bSYour Name * header, for the given hardware generation
1273*5113495bSYour Name * @tag_sscan_fft_exp: Expected Spectral Scan FFT report tag in PHYERR TLV
1274*5113495bSYour Name * header, for the given hardware generation
1275*5113495bSYour Name * @tlvhdr_size: Expected PHYERR TLV header size, for the given hardware
1276*5113495bSYour Name * generation
1277*5113495bSYour Name * @nl_cb: Netlink callbacks
1278*5113495bSYour Name * @use_nl_bcast: Whether to use Netlink broadcast/unicast
1279*5113495bSYour Name * @send_phy_data: Send data to the application layer for a particular msg type
1280*5113495bSYour Name * @len_adj_swar: Spectral fft bin length adjustment SWAR related info
1281*5113495bSYour Name * @timestamp_war: Spectral time stamp WAR related info
1282*5113495bSYour Name * @state_160mhz_delivery: Delivery state for each spectral scan mode
1283*5113495bSYour Name * @dbr_ring_debug: Whether Spectral DBR ring debug is enabled
1284*5113495bSYour Name * @dbr_buff_debug: Whether Spectral DBR buffer debug is enabled
1285*5113495bSYour Name * @direct_dma_support: Whether Direct-DMA is supported on the current radio
1286*5113495bSYour Name * @prev_tstamp: Timestamp of the previously received sample, which has to be
1287*5113495bSYour Name * compared with the current tstamp to check descrepancy
1288*5113495bSYour Name * @rparams: Parameters related to Spectral report structure
1289*5113495bSYour Name * @param_min_max: Spectral parameter's minimum and maximum values
1290*5113495bSYour Name * @finite_scan: Parameters for finite Spectral scan
1291*5113495bSYour Name * @detector_list: Detector list for a given Spectral scan mode and channel
1292*5113495bSYour Name * width, based on the target type.
1293*5113495bSYour Name * @detector_list_lock: Lock to synchronize accesses to detector list
1294*5113495bSYour Name * @det_map: Map of per-session detector information keyed by the Spectral HW
1295*5113495bSYour Name * detector id.
1296*5113495bSYour Name * @session_det_map_lock: Lock to synchronize accesses to session detector map
1297*5113495bSYour Name * @report_info: Per session info to be filled at report level in SAMP message
1298*5113495bSYour Name * @session_report_info_lock: Lock to synchronize access to session report info
1299*5113495bSYour Name * @supported_bws: Supported sscan bandwidths for all sscan modes and
1300*5113495bSYour Name * operating widths
1301*5113495bSYour Name * @supported_sscan_bw_list: List of supported sscan widths for all sscan modes
1302*5113495bSYour Name * @data_stats: stats in Spectral data path
1303*5113495bSYour Name */
1304*5113495bSYour Name struct target_if_spectral {
1305*5113495bSYour Name struct wlan_objmgr_pdev *pdev_obj;
1306*5113495bSYour Name struct target_if_spectral_ops spectral_ops;
1307*5113495bSYour Name struct spectral_caps capability;
1308*5113495bSYour Name struct spectral_param_properties
1309*5113495bSYour Name properties[SPECTRAL_SCAN_MODE_MAX][SPECTRAL_PARAM_MAX];
1310*5113495bSYour Name qdf_spinlock_t spectral_lock;
1311*5113495bSYour Name uint8_t vdev_id[SPECTRAL_SCAN_MODE_MAX];
1312*5113495bSYour Name int16_t spectral_curchan_radindex;
1313*5113495bSYour Name int16_t spectral_extchan_radindex;
1314*5113495bSYour Name uint32_t spectraldomain;
1315*5113495bSYour Name uint32_t spectral_proc_phyerr;
1316*5113495bSYour Name struct spectral_config spectral_defaultparams;
1317*5113495bSYour Name struct target_if_spectral_stats spectral_stats;
1318*5113495bSYour Name struct target_if_spectral_event *events;
1319*5113495bSYour Name unsigned int sc_spectral_ext_chan_ok:1,
1320*5113495bSYour Name sc_spectral_combined_rssi_ok:1,
1321*5113495bSYour Name sc_spectral_20_40_mode:1,
1322*5113495bSYour Name sc_spectral_noise_pwr_cal:1,
1323*5113495bSYour Name sc_spectral_non_edma:1;
1324*5113495bSYour Name int upper_is_control;
1325*5113495bSYour Name int upper_is_extension;
1326*5113495bSYour Name int lower_is_control;
1327*5113495bSYour Name int lower_is_extension;
1328*5113495bSYour Name uint8_t sc_spectraltest_ieeechan;
1329*5113495bSYour Name int spectral_numbins;
1330*5113495bSYour Name int spectral_fft_len;
1331*5113495bSYour Name int spectral_data_len;
1332*5113495bSYour Name
1333*5113495bSYour Name /*
1334*5113495bSYour Name * For 11ac chipsets prior to AR900B version 2.0, a max of 512 bins are
1335*5113495bSYour Name * delivered. However, there can be additional bins reported for
1336*5113495bSYour Name * AR900B version 2.0 and QCA9984 as described next:
1337*5113495bSYour Name *
1338*5113495bSYour Name * AR900B version 2.0: An additional tone is processed on the right
1339*5113495bSYour Name * hand side in order to facilitate detection of radar pulses out to
1340*5113495bSYour Name * the extreme band-edge of the channel frequency. Since the HW design
1341*5113495bSYour Name * processes four tones at a time, this requires one additional Dword
1342*5113495bSYour Name * to be added to the search FFT report.
1343*5113495bSYour Name *
1344*5113495bSYour Name * QCA9984: When spectral_scan_rpt_mode = 2, i.e 2-dword summary +
1345*5113495bSYour Name * 1x-oversampled bins (in-band) per FFT, then 8 more bins
1346*5113495bSYour Name * (4 more on left side and 4 more on right side)are added.
1347*5113495bSYour Name */
1348*5113495bSYour Name
1349*5113495bSYour Name int lb_edge_extrabins;
1350*5113495bSYour Name int rb_edge_extrabins;
1351*5113495bSYour Name int spectral_max_index_offset;
1352*5113495bSYour Name int spectral_upper_max_index_offset;
1353*5113495bSYour Name int spectral_lower_max_index_offset;
1354*5113495bSYour Name int spectral_dc_index;
1355*5113495bSYour Name int send_single_packet;
1356*5113495bSYour Name int spectral_sent_msg;
1357*5113495bSYour Name int classify_scan;
1358*5113495bSYour Name qdf_timer_t classify_timer;
1359*5113495bSYour Name struct spectral_config params[SPECTRAL_SCAN_MODE_MAX];
1360*5113495bSYour Name bool params_valid[SPECTRAL_SCAN_MODE_MAX];
1361*5113495bSYour Name struct spectral_classifier_params classifier_params;
1362*5113495bSYour Name int last_capture_time;
1363*5113495bSYour Name int num_spectral_data;
1364*5113495bSYour Name int total_spectral_data;
1365*5113495bSYour Name int max_rssi;
1366*5113495bSYour Name int detects_control_channel;
1367*5113495bSYour Name int detects_extension_channel;
1368*5113495bSYour Name int detects_below_dc;
1369*5113495bSYour Name int detects_above_dc;
1370*5113495bSYour Name int sc_scanning;
1371*5113495bSYour Name int sc_spectral_scan;
1372*5113495bSYour Name int sc_spectral_full_scan;
1373*5113495bSYour Name uint64_t scan_start_tstamp;
1374*5113495bSYour Name uint32_t last_tstamp;
1375*5113495bSYour Name uint32_t first_tstamp;
1376*5113495bSYour Name uint32_t spectral_samp_count;
1377*5113495bSYour Name uint32_t sc_spectral_samp_count;
1378*5113495bSYour Name int noise_pwr_reports_reqd;
1379*5113495bSYour Name int noise_pwr_reports_recv;
1380*5113495bSYour Name qdf_spinlock_t noise_pwr_reports_lock;
1381*5113495bSYour Name struct target_if_chain_noise_pwr_info
1382*5113495bSYour Name *noise_pwr_chain_ctl[HOST_MAX_ANTENNA];
1383*5113495bSYour Name struct target_if_chain_noise_pwr_info
1384*5113495bSYour Name *noise_pwr_chain_ext[HOST_MAX_ANTENNA];
1385*5113495bSYour Name uint64_t tsf64;
1386*5113495bSYour Name #if ATH_PERF_PWR_OFFLOAD
1387*5113495bSYour Name struct target_if_spectral_param_state_info
1388*5113495bSYour Name param_info[SPECTRAL_SCAN_MODE_MAX];
1389*5113495bSYour Name #endif
1390*5113495bSYour Name enum phy_ch_width ch_width[SPECTRAL_SCAN_MODE_MAX];
1391*5113495bSYour Name bool sscan_width_configured[SPECTRAL_SCAN_MODE_MAX];
1392*5113495bSYour Name struct spectral_diag_stats diag_stats;
1393*5113495bSYour Name bool is_160_format;
1394*5113495bSYour Name bool is_lb_edge_extrabins_format;
1395*5113495bSYour Name bool is_rb_edge_extrabins_format;
1396*5113495bSYour Name bool is_sec80_rssi_war_required;
1397*5113495bSYour Name #ifdef QCA_SUPPORT_SPECTRAL_SIMULATION
1398*5113495bSYour Name void *simctx;
1399*5113495bSYour Name #endif
1400*5113495bSYour Name enum spectral_gen spectral_gen;
1401*5113495bSYour Name uint8_t hdr_sig_exp;
1402*5113495bSYour Name uint8_t tag_sscan_summary_exp;
1403*5113495bSYour Name uint8_t tag_sscan_fft_exp;
1404*5113495bSYour Name uint8_t tlvhdr_size;
1405*5113495bSYour Name struct spectral_nl_cb nl_cb;
1406*5113495bSYour Name bool use_nl_bcast;
1407*5113495bSYour Name int (*send_phy_data)(struct wlan_objmgr_pdev *pdev,
1408*5113495bSYour Name enum spectral_msg_type smsg_type);
1409*5113495bSYour Name struct spectral_fft_bin_len_adj_swar len_adj_swar;
1410*5113495bSYour Name struct spectral_timestamp_war timestamp_war;
1411*5113495bSYour Name enum spectral_160mhz_report_delivery_state
1412*5113495bSYour Name state_160mhz_delivery[SPECTRAL_SCAN_MODE_MAX];
1413*5113495bSYour Name bool dbr_ring_debug;
1414*5113495bSYour Name bool dbr_buff_debug;
1415*5113495bSYour Name bool direct_dma_support;
1416*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
1417*5113495bSYour Name uint32_t prev_tstamp[MAX_DETECTORS_PER_PDEV];
1418*5113495bSYour Name #else
1419*5113495bSYour Name uint32_t prev_tstamp;
1420*5113495bSYour Name #endif
1421*5113495bSYour Name struct spectral_report_params rparams;
1422*5113495bSYour Name struct spectral_param_min_max param_min_max;
1423*5113495bSYour Name struct target_if_finite_spectral_scan_params
1424*5113495bSYour Name finite_scan[SPECTRAL_SCAN_MODE_MAX];
1425*5113495bSYour Name struct sscan_detector_list
1426*5113495bSYour Name detector_list[SPECTRAL_SCAN_MODE_MAX][CH_WIDTH_MAX];
1427*5113495bSYour Name qdf_spinlock_t detector_list_lock;
1428*5113495bSYour Name struct per_session_det_map det_map[MAX_DETECTORS_PER_PDEV];
1429*5113495bSYour Name qdf_spinlock_t session_det_map_lock;
1430*5113495bSYour Name struct per_session_report_info report_info[SPECTRAL_SCAN_MODE_MAX];
1431*5113495bSYour Name qdf_spinlock_t session_report_info_lock;
1432*5113495bSYour Name struct spectral_supported_bws
1433*5113495bSYour Name supported_bws[SPECTRAL_SCAN_MODE_MAX][CH_WIDTH_MAX];
1434*5113495bSYour Name /* Whether a given sscan BW is supported on a given smode */
1435*5113495bSYour Name bool supported_sscan_bw_list[SPECTRAL_SCAN_MODE_MAX][CH_WIDTH_MAX];
1436*5113495bSYour Name struct spectral_data_stats data_stats;
1437*5113495bSYour Name };
1438*5113495bSYour Name
1439*5113495bSYour Name /**
1440*5113495bSYour Name * struct target_if_psoc_spectral - Target if psoc Spectral object
1441*5113495bSYour Name * @psoc_obj: psoc object
1442*5113495bSYour Name * @wmi_ops: Spectral WMI operations
1443*5113495bSYour Name */
1444*5113495bSYour Name struct target_if_psoc_spectral {
1445*5113495bSYour Name struct wlan_objmgr_psoc *psoc_obj;
1446*5113495bSYour Name struct spectral_wmi_ops wmi_ops;
1447*5113495bSYour Name };
1448*5113495bSYour Name
1449*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
1450*5113495bSYour Name /**
1451*5113495bSYour Name * struct target_if_samp_msg_params - Spectral Analysis Messaging Protocol
1452*5113495bSYour Name * data format
1453*5113495bSYour Name * @hw_detector_id: Spectral HW detector ID
1454*5113495bSYour Name * @rssi: Spectral RSSI
1455*5113495bSYour Name * @lower_rssi: RSSI of lower band
1456*5113495bSYour Name * @upper_rssi: RSSI of upper band
1457*5113495bSYour Name * @chain_ctl_rssi: RSSI for control channel, for all antennas
1458*5113495bSYour Name * @chain_ext_rssi: RSSI for extension channel, for all antennas
1459*5113495bSYour Name * @last_raw_timestamp: Previous FFT report's raw timestamp.
1460*5113495bSYour Name * @raw_timestamp: FFT timestamp reported by HW on primary segment.
1461*5113495bSYour Name * @timestamp: timestamp
1462*5113495bSYour Name * @reset_delay: Time gap between the last spectral report before reset and the
1463*5113495bSYour Name * end of reset.
1464*5113495bSYour Name * @max_mag: maximum magnitude
1465*5113495bSYour Name * @max_index: index of max magnitude
1466*5113495bSYour Name * @noise_floor: current noise floor
1467*5113495bSYour Name * @agc_total_gain: AGC total gain on primary channel
1468*5113495bSYour Name * @gainchange: Indicates a gainchange occurred during the spectral scan
1469*5113495bSYour Name * @pri80ind: Indication from hardware that the sample was received on the
1470*5113495bSYour Name * primary 80 MHz segment. If this is set when smode =
1471*5113495bSYour Name * SPECTRAL_SCAN_MODE_AGILE, it indicates that Spectral was carried
1472*5113495bSYour Name * out on pri80 instead of the Agile frequency due to a channel
1473*5113495bSYour Name * switch - Software may choose to ignore the sample in this case.
1474*5113495bSYour Name * @blanking_status: Indicates whether scan blanking was enabled during this
1475*5113495bSYour Name * spectral report capture.
1476*5113495bSYour Name * @bin_pwr_data: Contains FFT magnitudes
1477*5113495bSYour Name */
1478*5113495bSYour Name struct target_if_samp_msg_params {
1479*5113495bSYour Name uint8_t hw_detector_id;
1480*5113495bSYour Name int8_t rssi;
1481*5113495bSYour Name int8_t lower_rssi;
1482*5113495bSYour Name int8_t upper_rssi;
1483*5113495bSYour Name int8_t chain_ctl_rssi[HOST_MAX_ANTENNA];
1484*5113495bSYour Name int8_t chain_ext_rssi[HOST_MAX_ANTENNA];
1485*5113495bSYour Name uint32_t last_raw_timestamp;
1486*5113495bSYour Name uint32_t raw_timestamp;
1487*5113495bSYour Name uint32_t timestamp;
1488*5113495bSYour Name uint32_t reset_delay;
1489*5113495bSYour Name uint16_t max_mag;
1490*5113495bSYour Name uint16_t max_index;
1491*5113495bSYour Name int16_t noise_floor;
1492*5113495bSYour Name uint8_t agc_total_gain;
1493*5113495bSYour Name uint8_t gainchange;
1494*5113495bSYour Name uint8_t pri80ind;
1495*5113495bSYour Name uint8_t blanking_status;
1496*5113495bSYour Name uint8_t *bin_pwr_data;
1497*5113495bSYour Name };
1498*5113495bSYour Name
1499*5113495bSYour Name #else
1500*5113495bSYour Name /**
1501*5113495bSYour Name * struct target_if_samp_msg_params - Spectral Analysis Messaging Protocol
1502*5113495bSYour Name * data format
1503*5113495bSYour Name * @rssi: RSSI (except for secondary 80 segment)
1504*5113495bSYour Name * @rssi_sec80: RSSI for secondary 80 segment
1505*5113495bSYour Name * @lower_rssi: RSSI of lower band
1506*5113495bSYour Name * @upper_rssi: RSSI of upper band
1507*5113495bSYour Name * @chain_ctl_rssi: RSSI for control channel, for all antennas
1508*5113495bSYour Name * @chain_ext_rssi: RSSI for extension channel, for all antennas
1509*5113495bSYour Name * @bwinfo: bandwidth info
1510*5113495bSYour Name * @datalen: length of FFT data (except for secondary 80 segment)
1511*5113495bSYour Name * @datalen_sec80: length of FFT data for secondary 80 segment
1512*5113495bSYour Name * @tstamp: timestamp
1513*5113495bSYour Name * @last_tstamp: last time stamp
1514*5113495bSYour Name * @max_mag: maximum magnitude (except for secondary 80 segment)
1515*5113495bSYour Name * @max_mag_sec80: maximum magnitude for secondary 80 segment
1516*5113495bSYour Name * @max_index: index of max magnitude (except for secondary 80 segment)
1517*5113495bSYour Name * @max_index_sec80: index of max magnitude for secondary 80 segment
1518*5113495bSYour Name * @max_exp: max exp
1519*5113495bSYour Name * @peak: peak frequency (obsolete)
1520*5113495bSYour Name * @pwr_count: number of FFT bins (except for secondary 80 segment)
1521*5113495bSYour Name * @pwr_count_5mhz: number of FFT bins in extra 5 MHz in
1522*5113495bSYour Name * 165 MHz/restricted 80p80 mode
1523*5113495bSYour Name * @pwr_count_sec80: number of FFT bins in secondary 80 segment
1524*5113495bSYour Name * @nb_lower: This is deprecated
1525*5113495bSYour Name * @nb_upper: This is deprecated
1526*5113495bSYour Name * @max_upper_index: index of max mag in upper band
1527*5113495bSYour Name * @max_lower_index: index of max mag in lower band
1528*5113495bSYour Name * @bin_pwr_data: Contains FFT magnitudes (except for secondary 80 segment)
1529*5113495bSYour Name * @bin_pwr_data_5mhz: Contains FFT magnitudes for the extra 5 MHz
1530*5113495bSYour Name * in 165 MHz/restricted 80p80 mode
1531*5113495bSYour Name * @bin_pwr_data_sec80: Contains FFT magnitudes for the secondary 80 segment
1532*5113495bSYour Name * @freq: Center frequency of primary 20MHz channel in MHz
1533*5113495bSYour Name * @vhtop_ch_freq_seg1: VHT operation first segment center frequency in MHz
1534*5113495bSYour Name * @vhtop_ch_freq_seg2: VHT operation second segment center frequency in MHz
1535*5113495bSYour Name * @agile_freq1: Center frequency in MHz of the entire span(for 80+80 MHz
1536*5113495bSYour Name * agile Scan it is primary 80 MHz span) across which
1537*5113495bSYour Name * Agile Spectral is carried out. Applicable only for Agile
1538*5113495bSYour Name * Spectral samples.
1539*5113495bSYour Name * @agile_freq2: Center frequency in MHz of the secondary 80 MHz span
1540*5113495bSYour Name * across which Agile Spectral is carried out. Applicable
1541*5113495bSYour Name * only for Agile Spectral samples in 80+80 MHz mode.
1542*5113495bSYour Name * @freq_loading: spectral control duty cycles
1543*5113495bSYour Name * @noise_floor: current noise floor (except for secondary 80 segment)
1544*5113495bSYour Name * @noise_floor_sec80: current noise floor for secondary 80 segment
1545*5113495bSYour Name * @interf_list: List of interference sources
1546*5113495bSYour Name * @classifier_params: classifier parameters
1547*5113495bSYour Name * @sc: classifier parameters
1548*5113495bSYour Name * @agc_total_gain: AGC total gain on primary channel
1549*5113495bSYour Name * @agc_total_gain_sec80: AGC total gain on secondary channel
1550*5113495bSYour Name * @gainchange: Indicates a gainchange occurred during the spectral scan
1551*5113495bSYour Name * @gainchange_sec80: Indicates a gainchange occurred in the secondary
1552*5113495bSYour Name * channel during the spectral scan
1553*5113495bSYour Name * @smode: spectral scan mode
1554*5113495bSYour Name * @pri80ind: Indication from hardware that the sample was received on the
1555*5113495bSYour Name * primary 80 MHz segment. If this is set when smode =
1556*5113495bSYour Name * SPECTRAL_SCAN_MODE_AGILE, it indicates that Spectral was carried out on
1557*5113495bSYour Name * pri80 instead of the Agile frequency due to a channel switch - Software may
1558*5113495bSYour Name * choose to ignore the sample in this case.
1559*5113495bSYour Name * @pri80ind_sec80: Indication from hardware that the sample was received on the
1560*5113495bSYour Name * primary 80 MHz segment instead of the secondary 80 MHz segment due to a
1561*5113495bSYour Name * channel switch - Software may choose to ignore the sample if this is set.
1562*5113495bSYour Name * Applicable only if smode = SPECTRAL_SCAN_MODE_NORMAL and for 160/80+80 MHz
1563*5113495bSYour Name * Spectral operation and if the chipset supports fragmented 160/80+80 MHz
1564*5113495bSYour Name * operation.
1565*5113495bSYour Name * @last_raw_timestamp: Previous FFT report's raw timestamp. In case of 160MHz
1566*5113495bSYour Name * it will be primary 80 segment's timestamp as both primary & secondary
1567*5113495bSYour Name * segment's timestamps are expected to be almost equal
1568*5113495bSYour Name * @timestamp_war_offset: Offset calculated based on reset_delay and
1569*5113495bSYour Name * last_raw_stamp. It will be added to raw_timestamp to get tstamp.
1570*5113495bSYour Name * @raw_timestamp: FFT timestamp reported by HW on primary segment.
1571*5113495bSYour Name * @raw_timestamp_sec80: FFT timestamp reported by HW on secondary 80 segment.
1572*5113495bSYour Name * @reset_delay: Time gap between the last spectral report before reset and the
1573*5113495bSYour Name * end of reset.
1574*5113495bSYour Name * @target_reset_count: Indicates the the number of times the target went
1575*5113495bSYour Name * through reset routine after spectral was enabled.
1576*5113495bSYour Name */
1577*5113495bSYour Name struct target_if_samp_msg_params {
1578*5113495bSYour Name int8_t rssi;
1579*5113495bSYour Name int8_t rssi_sec80;
1580*5113495bSYour Name int8_t lower_rssi;
1581*5113495bSYour Name int8_t upper_rssi;
1582*5113495bSYour Name int8_t chain_ctl_rssi[HOST_MAX_ANTENNA];
1583*5113495bSYour Name int8_t chain_ext_rssi[HOST_MAX_ANTENNA];
1584*5113495bSYour Name uint16_t bwinfo;
1585*5113495bSYour Name uint16_t datalen;
1586*5113495bSYour Name uint16_t datalen_sec80;
1587*5113495bSYour Name uint32_t tstamp;
1588*5113495bSYour Name uint32_t last_tstamp;
1589*5113495bSYour Name uint16_t max_mag;
1590*5113495bSYour Name uint16_t max_mag_sec80;
1591*5113495bSYour Name uint16_t max_index;
1592*5113495bSYour Name uint16_t max_index_sec80;
1593*5113495bSYour Name uint8_t max_exp;
1594*5113495bSYour Name int peak;
1595*5113495bSYour Name int pwr_count;
1596*5113495bSYour Name int pwr_count_5mhz;
1597*5113495bSYour Name int pwr_count_sec80;
1598*5113495bSYour Name int8_t nb_lower;
1599*5113495bSYour Name int8_t nb_upper;
1600*5113495bSYour Name uint16_t max_lower_index;
1601*5113495bSYour Name uint16_t max_upper_index;
1602*5113495bSYour Name uint8_t *bin_pwr_data;
1603*5113495bSYour Name uint8_t *bin_pwr_data_5mhz;
1604*5113495bSYour Name uint8_t *bin_pwr_data_sec80;
1605*5113495bSYour Name uint16_t freq;
1606*5113495bSYour Name uint16_t vhtop_ch_freq_seg1;
1607*5113495bSYour Name uint16_t vhtop_ch_freq_seg2;
1608*5113495bSYour Name uint16_t agile_freq1;
1609*5113495bSYour Name uint16_t agile_freq2;
1610*5113495bSYour Name uint16_t freq_loading;
1611*5113495bSYour Name int16_t noise_floor;
1612*5113495bSYour Name int16_t noise_floor_sec80;
1613*5113495bSYour Name struct interf_src_rsp interf_list;
1614*5113495bSYour Name struct spectral_classifier_params classifier_params;
1615*5113495bSYour Name struct ath_softc *sc;
1616*5113495bSYour Name uint8_t agc_total_gain;
1617*5113495bSYour Name uint8_t agc_total_gain_sec80;
1618*5113495bSYour Name uint8_t gainchange;
1619*5113495bSYour Name uint8_t gainchange_sec80;
1620*5113495bSYour Name enum spectral_scan_mode smode;
1621*5113495bSYour Name uint8_t pri80ind;
1622*5113495bSYour Name uint8_t pri80ind_sec80;
1623*5113495bSYour Name uint32_t last_raw_timestamp;
1624*5113495bSYour Name uint32_t timestamp_war_offset;
1625*5113495bSYour Name uint32_t raw_timestamp;
1626*5113495bSYour Name uint32_t raw_timestamp_sec80;
1627*5113495bSYour Name uint32_t reset_delay;
1628*5113495bSYour Name uint32_t target_reset_count;
1629*5113495bSYour Name };
1630*5113495bSYour Name #endif
1631*5113495bSYour Name
1632*5113495bSYour Name /**
1633*5113495bSYour Name * struct target_if_spectral_agile_mode_cap - Structure to hold agile
1634*5113495bSYour Name * Spetcral scan capability
1635*5113495bSYour Name * @agile_spectral_cap: agile Spectral scan capability for 20/40/80 MHz
1636*5113495bSYour Name * @agile_spectral_cap_160: agile Spectral scan capability for 160 MHz
1637*5113495bSYour Name * @agile_spectral_cap_80p80: agile Spectral scan capability for 80+80 MHz
1638*5113495bSYour Name * @agile_spectral_cap_320: agile Spectral scan capability for 320 MHz
1639*5113495bSYour Name */
1640*5113495bSYour Name struct target_if_spectral_agile_mode_cap {
1641*5113495bSYour Name bool agile_spectral_cap;
1642*5113495bSYour Name bool agile_spectral_cap_160;
1643*5113495bSYour Name bool agile_spectral_cap_80p80;
1644*5113495bSYour Name bool agile_spectral_cap_320;
1645*5113495bSYour Name };
1646*5113495bSYour Name
1647*5113495bSYour Name #ifdef WLAN_CONV_SPECTRAL_ENABLE
1648*5113495bSYour Name /**
1649*5113495bSYour Name * target_if_spectral_dump_fft() - Dump Spectral FFT
1650*5113495bSYour Name * @pfft: Pointer to Spectral Phyerr FFT
1651*5113495bSYour Name * @fftlen: FFT length
1652*5113495bSYour Name *
1653*5113495bSYour Name * Return: Success or failure
1654*5113495bSYour Name */
1655*5113495bSYour Name int target_if_spectral_dump_fft(uint8_t *pfft, int fftlen);
1656*5113495bSYour Name
1657*5113495bSYour Name /**
1658*5113495bSYour Name * target_if_dbg_print_samp_param() - Print contents of SAMP struct
1659*5113495bSYour Name * @p: Pointer to SAMP message
1660*5113495bSYour Name *
1661*5113495bSYour Name * Return: Void
1662*5113495bSYour Name */
1663*5113495bSYour Name void target_if_dbg_print_samp_param(struct target_if_samp_msg_params *p);
1664*5113495bSYour Name
1665*5113495bSYour Name /**
1666*5113495bSYour Name * target_if_get_offset_swar_sec80() - Get offset for SWAR according to
1667*5113495bSYour Name * the channel width
1668*5113495bSYour Name * @channel_width: Channel width
1669*5113495bSYour Name *
1670*5113495bSYour Name * Return: Offset for SWAR
1671*5113495bSYour Name */
1672*5113495bSYour Name uint32_t target_if_get_offset_swar_sec80(uint32_t channel_width);
1673*5113495bSYour Name
1674*5113495bSYour Name /**
1675*5113495bSYour Name * target_if_sptrl_register_tx_ops() - Register Spectral target_if Tx Ops
1676*5113495bSYour Name * @tx_ops: Tx Ops
1677*5113495bSYour Name *
1678*5113495bSYour Name * Return: void
1679*5113495bSYour Name */
1680*5113495bSYour Name void target_if_sptrl_register_tx_ops(struct wlan_lmac_if_tx_ops *tx_ops);
1681*5113495bSYour Name
1682*5113495bSYour Name #ifndef OPTIMIZED_SAMP_MESSAGE
1683*5113495bSYour Name /**
1684*5113495bSYour Name * target_if_spectral_create_samp_msg() - Create the spectral samp message
1685*5113495bSYour Name * @spectral : Pointer to spectral internal structure
1686*5113495bSYour Name * @params : spectral samp message parameters
1687*5113495bSYour Name *
1688*5113495bSYour Name * API to create the spectral samp message
1689*5113495bSYour Name *
1690*5113495bSYour Name * Return: void
1691*5113495bSYour Name */
1692*5113495bSYour Name void target_if_spectral_create_samp_msg(
1693*5113495bSYour Name struct target_if_spectral *spectral,
1694*5113495bSYour Name struct target_if_samp_msg_params *params);
1695*5113495bSYour Name #endif
1696*5113495bSYour Name
1697*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
1698*5113495bSYour Name /**
1699*5113495bSYour Name * target_if_spectral_fill_samp_msg() - Fill the Spectral SAMP message
1700*5113495bSYour Name * @spectral : Pointer to spectral internal structure
1701*5113495bSYour Name * @params: Spectral SAMP message fields
1702*5113495bSYour Name *
1703*5113495bSYour Name * Fill the spectral SAMP message fields using params and detector map.
1704*5113495bSYour Name *
1705*5113495bSYour Name * Return: Success/Failure
1706*5113495bSYour Name */
1707*5113495bSYour Name QDF_STATUS target_if_spectral_fill_samp_msg(
1708*5113495bSYour Name struct target_if_spectral *spectral,
1709*5113495bSYour Name struct target_if_samp_msg_params *params);
1710*5113495bSYour Name #endif
1711*5113495bSYour Name
1712*5113495bSYour Name /**
1713*5113495bSYour Name * target_if_spectral_process_report_gen3() - Process spectral report for gen3
1714*5113495bSYour Name * @pdev: Pointer to pdev object
1715*5113495bSYour Name * @buf: Pointer to spectral report
1716*5113495bSYour Name *
1717*5113495bSYour Name * Process phyerror event for gen3
1718*5113495bSYour Name *
1719*5113495bSYour Name * Return: Success/Failure
1720*5113495bSYour Name */
1721*5113495bSYour Name int target_if_spectral_process_report_gen3(struct wlan_objmgr_pdev *pdev,
1722*5113495bSYour Name void *buf);
1723*5113495bSYour Name
1724*5113495bSYour Name /**
1725*5113495bSYour Name * target_if_process_phyerr_gen2() - Process PHY Error for gen2
1726*5113495bSYour Name * @spectral: Pointer to Spectral object
1727*5113495bSYour Name * @data: Pointer to phyerror event buffer
1728*5113495bSYour Name * @datalen: Data length
1729*5113495bSYour Name * @p_rfqual: RF quality info
1730*5113495bSYour Name * @p_chaninfo: Channel info
1731*5113495bSYour Name * @tsf64: 64 bit tsf timestamp
1732*5113495bSYour Name * @acs_stats: ACS stats
1733*5113495bSYour Name *
1734*5113495bSYour Name * Process PHY Error for gen2
1735*5113495bSYour Name *
1736*5113495bSYour Name * Return: Success/Failure
1737*5113495bSYour Name */
1738*5113495bSYour Name int target_if_process_phyerr_gen2(
1739*5113495bSYour Name struct target_if_spectral *spectral,
1740*5113495bSYour Name uint8_t *data,
1741*5113495bSYour Name uint32_t datalen, struct target_if_spectral_rfqual_info *p_rfqual,
1742*5113495bSYour Name struct target_if_spectral_chan_info *p_chaninfo,
1743*5113495bSYour Name uint64_t tsf64,
1744*5113495bSYour Name struct target_if_spectral_acs_stats *acs_stats);
1745*5113495bSYour Name
1746*5113495bSYour Name /**
1747*5113495bSYour Name * target_if_spectral_send_intf_found_msg() - Indicate to application layer that
1748*5113495bSYour Name * interference has been found
1749*5113495bSYour Name * @pdev: Pointer to pdev
1750*5113495bSYour Name * @cw_int: 1 if CW interference is found, 0 if WLAN interference is found
1751*5113495bSYour Name * @dcs_enabled: 1 if DCS is enabled, 0 if DCS is disabled
1752*5113495bSYour Name *
1753*5113495bSYour Name * Send message to application layer
1754*5113495bSYour Name * indicating that interference has been found
1755*5113495bSYour Name *
1756*5113495bSYour Name * Return: None
1757*5113495bSYour Name */
1758*5113495bSYour Name void target_if_spectral_send_intf_found_msg(
1759*5113495bSYour Name struct wlan_objmgr_pdev *pdev,
1760*5113495bSYour Name uint16_t cw_int, uint32_t dcs_enabled);
1761*5113495bSYour Name
1762*5113495bSYour Name /**
1763*5113495bSYour Name * target_if_stop_spectral_scan() - Stop spectral scan
1764*5113495bSYour Name * @pdev: Pointer to pdev object
1765*5113495bSYour Name * @smode: Spectral scan mode
1766*5113495bSYour Name * @err: Pointer to error code
1767*5113495bSYour Name *
1768*5113495bSYour Name * API to stop the current on-going spectral scan
1769*5113495bSYour Name *
1770*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
1771*5113495bSYour Name */
1772*5113495bSYour Name QDF_STATUS target_if_stop_spectral_scan(struct wlan_objmgr_pdev *pdev,
1773*5113495bSYour Name const enum spectral_scan_mode smode,
1774*5113495bSYour Name enum spectral_cp_error_code *err);
1775*5113495bSYour Name
1776*5113495bSYour Name /**
1777*5113495bSYour Name * target_if_spectral_get_vdev() - Get pointer to vdev to be used for Spectral
1778*5113495bSYour Name * operations
1779*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
1780*5113495bSYour Name * @smode: spectral scan mode
1781*5113495bSYour Name *
1782*5113495bSYour Name * Spectral operates on pdev. However, in order to retrieve some WLAN
1783*5113495bSYour Name * properties, a vdev is required. To facilitate this, the function returns the
1784*5113495bSYour Name * first vdev in our pdev. The caller should release the reference to the vdev
1785*5113495bSYour Name * once it is done using it.
1786*5113495bSYour Name * TODO: If the framework later provides an API to obtain the first active
1787*5113495bSYour Name * vdev, then it would be preferable to use this API.
1788*5113495bSYour Name *
1789*5113495bSYour Name * Return: Pointer to vdev on success, NULL on failure
1790*5113495bSYour Name */
1791*5113495bSYour Name struct wlan_objmgr_vdev *target_if_spectral_get_vdev(
1792*5113495bSYour Name struct target_if_spectral *spectral,
1793*5113495bSYour Name enum spectral_scan_mode smode);
1794*5113495bSYour Name
1795*5113495bSYour Name /**
1796*5113495bSYour Name * target_if_spectral_dump_hdr_gen2() - Dump Spectral header for gen2
1797*5113495bSYour Name * @phdr: Pointer to Spectral Phyerr Header
1798*5113495bSYour Name *
1799*5113495bSYour Name * Dump Spectral header
1800*5113495bSYour Name *
1801*5113495bSYour Name * Return: Success/Failure
1802*5113495bSYour Name */
1803*5113495bSYour Name int target_if_spectral_dump_hdr_gen2(struct spectral_phyerr_hdr_gen2 *phdr);
1804*5113495bSYour Name
1805*5113495bSYour Name /**
1806*5113495bSYour Name * target_if_get_combrssi_sec80_seg_gen2() - Get approximate combined RSSI
1807*5113495bSYour Name * for Secondary 80 segment
1808*5113495bSYour Name * @spectral: Pointer to spectral object
1809*5113495bSYour Name * @p_sfft_sec80: Pointer to search fft info of secondary 80 segment
1810*5113495bSYour Name *
1811*5113495bSYour Name * Get approximate combined RSSI for Secondary 80 segment
1812*5113495bSYour Name *
1813*5113495bSYour Name * Return: Combined RSSI for secondary 80Mhz segment
1814*5113495bSYour Name */
1815*5113495bSYour Name int8_t target_if_get_combrssi_sec80_seg_gen2(
1816*5113495bSYour Name struct target_if_spectral *spectral,
1817*5113495bSYour Name struct spectral_search_fft_info_gen2 *p_sfft_sec80);
1818*5113495bSYour Name
1819*5113495bSYour Name /**
1820*5113495bSYour Name * target_if_spectral_dump_tlv_gen2() - Dump Spectral TLV for gen2
1821*5113495bSYour Name * @ptlv: Pointer to Spectral Phyerr TLV
1822*5113495bSYour Name * @is_160_format: Indicates 160 format
1823*5113495bSYour Name *
1824*5113495bSYour Name * Dump Spectral TLV for gen2
1825*5113495bSYour Name *
1826*5113495bSYour Name * Return: Success/Failure
1827*5113495bSYour Name */
1828*5113495bSYour Name int target_if_spectral_dump_tlv_gen2(
1829*5113495bSYour Name struct spectral_phyerr_tlv_gen2 *ptlv, bool is_160_format);
1830*5113495bSYour Name
1831*5113495bSYour Name /**
1832*5113495bSYour Name * target_if_spectral_dump_phyerr_data_gen2() - Dump Spectral
1833*5113495bSYour Name * related PHY Error for gen2
1834*5113495bSYour Name * @data: Pointer to phyerror buffer
1835*5113495bSYour Name * @datalen: Data length
1836*5113495bSYour Name * @is_160_format: Indicates 160 format
1837*5113495bSYour Name *
1838*5113495bSYour Name * Dump Spectral related PHY Error for gen2
1839*5113495bSYour Name *
1840*5113495bSYour Name * Return: Success/Failure
1841*5113495bSYour Name */
1842*5113495bSYour Name int target_if_spectral_dump_phyerr_data_gen2(
1843*5113495bSYour Name uint8_t *data,
1844*5113495bSYour Name uint32_t datalen,
1845*5113495bSYour Name bool is_160_format);
1846*5113495bSYour Name
1847*5113495bSYour Name /**
1848*5113495bSYour Name * target_if_dbg_print_samp_msg() - Print contents of SAMP Message
1849*5113495bSYour Name * @pmsg: Pointer to SAMP message
1850*5113495bSYour Name *
1851*5113495bSYour Name * Print contents of SAMP Message
1852*5113495bSYour Name *
1853*5113495bSYour Name * Return: Void
1854*5113495bSYour Name */
1855*5113495bSYour Name void target_if_dbg_print_samp_msg(struct spectral_samp_msg *pmsg);
1856*5113495bSYour Name
1857*5113495bSYour Name /**
1858*5113495bSYour Name * get_target_if_spectral_handle_from_pdev() - Get handle to target_if internal
1859*5113495bSYour Name * Spectral data
1860*5113495bSYour Name * @pdev: Pointer to pdev
1861*5113495bSYour Name *
1862*5113495bSYour Name * Return: Handle to target_if internal Spectral data on success, NULL on
1863*5113495bSYour Name * failure
1864*5113495bSYour Name */
1865*5113495bSYour Name struct target_if_spectral *get_target_if_spectral_handle_from_pdev(
1866*5113495bSYour Name struct wlan_objmgr_pdev *pdev);
1867*5113495bSYour Name
1868*5113495bSYour Name /**
1869*5113495bSYour Name * get_target_if_spectral_handle_from_psoc() - Get handle to psoc target_if
1870*5113495bSYour Name * internal Spectral data
1871*5113495bSYour Name * @psoc: Pointer to psoc
1872*5113495bSYour Name *
1873*5113495bSYour Name * Return: Handle to target_if psoc internal Spectral data on success, NULL on
1874*5113495bSYour Name * failure
1875*5113495bSYour Name */
1876*5113495bSYour Name static inline
get_target_if_spectral_handle_from_psoc(struct wlan_objmgr_psoc * psoc)1877*5113495bSYour Name struct target_if_psoc_spectral *get_target_if_spectral_handle_from_psoc(
1878*5113495bSYour Name struct wlan_objmgr_psoc *psoc)
1879*5113495bSYour Name {
1880*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
1881*5113495bSYour Name struct target_if_psoc_spectral *psoc_spectral;
1882*5113495bSYour Name
1883*5113495bSYour Name if (!psoc) {
1884*5113495bSYour Name spectral_err("psoc is null");
1885*5113495bSYour Name return NULL;
1886*5113495bSYour Name }
1887*5113495bSYour Name
1888*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
1889*5113495bSYour Name if (!rx_ops) {
1890*5113495bSYour Name spectral_err("rx_ops is null");
1891*5113495bSYour Name return NULL;
1892*5113495bSYour Name }
1893*5113495bSYour Name
1894*5113495bSYour Name psoc_spectral = (struct target_if_psoc_spectral *)
1895*5113495bSYour Name rx_ops->sptrl_rx_ops.sptrlro_get_psoc_target_handle(psoc);
1896*5113495bSYour Name
1897*5113495bSYour Name return psoc_spectral;
1898*5113495bSYour Name }
1899*5113495bSYour Name
1900*5113495bSYour Name /**
1901*5113495bSYour Name * target_if_vdev_get_chan_freq() - Get vdev operating channel frequency
1902*5113495bSYour Name * @vdev: Pointer to vdev
1903*5113495bSYour Name *
1904*5113495bSYour Name * Get the operating channel frequency of a given vdev
1905*5113495bSYour Name *
1906*5113495bSYour Name * Return: Operating channel frequency of a vdev in MHz
1907*5113495bSYour Name */
1908*5113495bSYour Name static inline
target_if_vdev_get_chan_freq(struct wlan_objmgr_vdev * vdev)1909*5113495bSYour Name int16_t target_if_vdev_get_chan_freq(struct wlan_objmgr_vdev *vdev)
1910*5113495bSYour Name {
1911*5113495bSYour Name struct wlan_objmgr_psoc *psoc = NULL;
1912*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
1913*5113495bSYour Name
1914*5113495bSYour Name psoc = wlan_vdev_get_psoc(vdev);
1915*5113495bSYour Name if (!psoc) {
1916*5113495bSYour Name spectral_err("psoc is NULL");
1917*5113495bSYour Name return -EINVAL;
1918*5113495bSYour Name }
1919*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
1920*5113495bSYour Name if (!rx_ops) {
1921*5113495bSYour Name spectral_err("rx_ops is null");
1922*5113495bSYour Name return -EINVAL;
1923*5113495bSYour Name }
1924*5113495bSYour Name
1925*5113495bSYour Name return rx_ops->sptrl_rx_ops.sptrlro_vdev_get_chan_freq(
1926*5113495bSYour Name vdev);
1927*5113495bSYour Name }
1928*5113495bSYour Name
1929*5113495bSYour Name /**
1930*5113495bSYour Name * target_if_vdev_get_chan_freq_seg2() - Get center frequency of secondary 80 of
1931*5113495bSYour Name * given vdev
1932*5113495bSYour Name * @vdev: Pointer to vdev
1933*5113495bSYour Name *
1934*5113495bSYour Name * Get the center frequency of secondary 80 of given vdev
1935*5113495bSYour Name *
1936*5113495bSYour Name * Return: center frequency of secondary 80
1937*5113495bSYour Name */
1938*5113495bSYour Name static inline
target_if_vdev_get_chan_freq_seg2(struct wlan_objmgr_vdev * vdev)1939*5113495bSYour Name int16_t target_if_vdev_get_chan_freq_seg2(struct wlan_objmgr_vdev *vdev)
1940*5113495bSYour Name {
1941*5113495bSYour Name struct wlan_objmgr_psoc *psoc = NULL;
1942*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
1943*5113495bSYour Name
1944*5113495bSYour Name psoc = wlan_vdev_get_psoc(vdev);
1945*5113495bSYour Name if (!psoc) {
1946*5113495bSYour Name spectral_err("psoc is NULL");
1947*5113495bSYour Name return -EINVAL;
1948*5113495bSYour Name }
1949*5113495bSYour Name
1950*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
1951*5113495bSYour Name if (!rx_ops) {
1952*5113495bSYour Name spectral_err("rx_ops is null");
1953*5113495bSYour Name return -EINVAL;
1954*5113495bSYour Name }
1955*5113495bSYour Name
1956*5113495bSYour Name return rx_ops->sptrl_rx_ops.sptrlro_vdev_get_chan_freq_seg2(vdev);
1957*5113495bSYour Name }
1958*5113495bSYour Name
1959*5113495bSYour Name /**
1960*5113495bSYour Name * target_if_vdev_get_ch_width() - Get vdev operating channel bandwidth
1961*5113495bSYour Name * @vdev: Pointer to vdev
1962*5113495bSYour Name *
1963*5113495bSYour Name * Get the operating channel bandwidth of a given vdev
1964*5113495bSYour Name *
1965*5113495bSYour Name * Return: channel bandwidth enumeration corresponding to the vdev
1966*5113495bSYour Name */
1967*5113495bSYour Name static inline
target_if_vdev_get_ch_width(struct wlan_objmgr_vdev * vdev)1968*5113495bSYour Name enum phy_ch_width target_if_vdev_get_ch_width(struct wlan_objmgr_vdev *vdev)
1969*5113495bSYour Name {
1970*5113495bSYour Name struct wlan_objmgr_psoc *psoc = NULL;
1971*5113495bSYour Name enum phy_ch_width ch_width;
1972*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
1973*5113495bSYour Name
1974*5113495bSYour Name psoc = wlan_vdev_get_psoc(vdev);
1975*5113495bSYour Name if (!psoc) {
1976*5113495bSYour Name spectral_err("psoc is NULL");
1977*5113495bSYour Name return CH_WIDTH_INVALID;
1978*5113495bSYour Name }
1979*5113495bSYour Name
1980*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
1981*5113495bSYour Name if (!rx_ops) {
1982*5113495bSYour Name spectral_err("rx_ops is null");
1983*5113495bSYour Name return CH_WIDTH_INVALID;
1984*5113495bSYour Name }
1985*5113495bSYour Name
1986*5113495bSYour Name ch_width = rx_ops->sptrl_rx_ops.sptrlro_vdev_get_ch_width(vdev);
1987*5113495bSYour Name
1988*5113495bSYour Name if (ch_width == CH_WIDTH_160MHZ) {
1989*5113495bSYour Name int16_t cfreq2;
1990*5113495bSYour Name
1991*5113495bSYour Name cfreq2 = target_if_vdev_get_chan_freq_seg2(vdev);
1992*5113495bSYour Name if (cfreq2 < 0) {
1993*5113495bSYour Name spectral_err("Invalid value for cfreq2 %d", cfreq2);
1994*5113495bSYour Name return CH_WIDTH_INVALID;
1995*5113495bSYour Name }
1996*5113495bSYour Name
1997*5113495bSYour Name /* Use non zero cfreq2 to identify 80p80 */
1998*5113495bSYour Name if (cfreq2)
1999*5113495bSYour Name ch_width = CH_WIDTH_80P80MHZ;
2000*5113495bSYour Name }
2001*5113495bSYour Name
2002*5113495bSYour Name return ch_width;
2003*5113495bSYour Name }
2004*5113495bSYour Name
2005*5113495bSYour Name /**
2006*5113495bSYour Name * target_if_vdev_get_sec20chan_freq_mhz() - Get the frequency of secondary
2007*5113495bSYour Name * 20 MHz channel for a given vdev
2008*5113495bSYour Name * @vdev: Pointer to vdev
2009*5113495bSYour Name * @sec20chan_freq: Location to return secondary 20 MHz channel
2010*5113495bSYour Name *
2011*5113495bSYour Name * Get the frequency of secondary 20 MHz channel for a given vdev
2012*5113495bSYour Name *
2013*5113495bSYour Name * Return: 0 if 20 MHz channel was returned, negative errno otherwise
2014*5113495bSYour Name */
2015*5113495bSYour Name static inline
target_if_vdev_get_sec20chan_freq_mhz(struct wlan_objmgr_vdev * vdev,uint16_t * sec20chan_freq)2016*5113495bSYour Name int target_if_vdev_get_sec20chan_freq_mhz(
2017*5113495bSYour Name struct wlan_objmgr_vdev *vdev,
2018*5113495bSYour Name uint16_t *sec20chan_freq)
2019*5113495bSYour Name {
2020*5113495bSYour Name struct wlan_objmgr_psoc *psoc = NULL;
2021*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
2022*5113495bSYour Name
2023*5113495bSYour Name psoc = wlan_vdev_get_psoc(vdev);
2024*5113495bSYour Name if (!psoc) {
2025*5113495bSYour Name spectral_err("psoc is NULL");
2026*5113495bSYour Name return -EINVAL;
2027*5113495bSYour Name }
2028*5113495bSYour Name
2029*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
2030*5113495bSYour Name if (!rx_ops) {
2031*5113495bSYour Name spectral_err("rx_ops is null");
2032*5113495bSYour Name return -EINVAL;
2033*5113495bSYour Name }
2034*5113495bSYour Name
2035*5113495bSYour Name return rx_ops->sptrl_rx_ops.
2036*5113495bSYour Name sptrlro_vdev_get_sec20chan_freq_mhz(vdev, sec20chan_freq);
2037*5113495bSYour Name }
2038*5113495bSYour Name
2039*5113495bSYour Name /**
2040*5113495bSYour Name * target_if_spectral_is_feature_disabled_psoc() - Check if Spectral feature is
2041*5113495bSYour Name * disabled for a given psoc
2042*5113495bSYour Name * @psoc: Pointer to psoc
2043*5113495bSYour Name *
2044*5113495bSYour Name * Return: true or false
2045*5113495bSYour Name */
2046*5113495bSYour Name static inline
target_if_spectral_is_feature_disabled_psoc(struct wlan_objmgr_psoc * psoc)2047*5113495bSYour Name bool target_if_spectral_is_feature_disabled_psoc(struct wlan_objmgr_psoc *psoc)
2048*5113495bSYour Name {
2049*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
2050*5113495bSYour Name
2051*5113495bSYour Name if (!psoc) {
2052*5113495bSYour Name spectral_err("psoc is NULL");
2053*5113495bSYour Name return true;
2054*5113495bSYour Name }
2055*5113495bSYour Name
2056*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
2057*5113495bSYour Name if (!rx_ops) {
2058*5113495bSYour Name spectral_err("rx_ops is null");
2059*5113495bSYour Name return true;
2060*5113495bSYour Name }
2061*5113495bSYour Name
2062*5113495bSYour Name if (rx_ops->sptrl_rx_ops.
2063*5113495bSYour Name sptrlro_spectral_is_feature_disabled_psoc)
2064*5113495bSYour Name return rx_ops->sptrl_rx_ops.
2065*5113495bSYour Name sptrlro_spectral_is_feature_disabled_psoc(psoc);
2066*5113495bSYour Name
2067*5113495bSYour Name return true;
2068*5113495bSYour Name }
2069*5113495bSYour Name
2070*5113495bSYour Name /**
2071*5113495bSYour Name * target_if_spectral_is_feature_disabled_pdev() - Check if Spectral feature is
2072*5113495bSYour Name * disabled for a given pdev
2073*5113495bSYour Name * @pdev: Pointer to pdev
2074*5113495bSYour Name *
2075*5113495bSYour Name * Return: true or false
2076*5113495bSYour Name */
2077*5113495bSYour Name static inline
target_if_spectral_is_feature_disabled_pdev(struct wlan_objmgr_pdev * pdev)2078*5113495bSYour Name bool target_if_spectral_is_feature_disabled_pdev(struct wlan_objmgr_pdev *pdev)
2079*5113495bSYour Name {
2080*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
2081*5113495bSYour Name struct wlan_objmgr_psoc *psoc;
2082*5113495bSYour Name
2083*5113495bSYour Name if (!pdev) {
2084*5113495bSYour Name spectral_err("pdev is NULL");
2085*5113495bSYour Name return true;
2086*5113495bSYour Name }
2087*5113495bSYour Name
2088*5113495bSYour Name psoc = wlan_pdev_get_psoc(pdev);
2089*5113495bSYour Name if (!psoc) {
2090*5113495bSYour Name spectral_err("psoc is NULL");
2091*5113495bSYour Name return true;
2092*5113495bSYour Name }
2093*5113495bSYour Name
2094*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
2095*5113495bSYour Name if (!rx_ops) {
2096*5113495bSYour Name spectral_err("rx_ops is null");
2097*5113495bSYour Name return true;
2098*5113495bSYour Name }
2099*5113495bSYour Name
2100*5113495bSYour Name if (rx_ops->sptrl_rx_ops.
2101*5113495bSYour Name sptrlro_spectral_is_feature_disabled_pdev)
2102*5113495bSYour Name return rx_ops->sptrl_rx_ops.
2103*5113495bSYour Name sptrlro_spectral_is_feature_disabled_pdev(pdev);
2104*5113495bSYour Name
2105*5113495bSYour Name return true;
2106*5113495bSYour Name }
2107*5113495bSYour Name
2108*5113495bSYour Name /**
2109*5113495bSYour Name * target_if_spectral_set_rxchainmask() - Set Spectral Rx chainmask
2110*5113495bSYour Name * @pdev: Pointer to pdev
2111*5113495bSYour Name * @spectral_rx_chainmask: Spectral Rx chainmask
2112*5113495bSYour Name *
2113*5113495bSYour Name * Return: None
2114*5113495bSYour Name */
2115*5113495bSYour Name static inline
target_if_spectral_set_rxchainmask(struct wlan_objmgr_pdev * pdev,uint8_t spectral_rx_chainmask)2116*5113495bSYour Name void target_if_spectral_set_rxchainmask(struct wlan_objmgr_pdev *pdev,
2117*5113495bSYour Name uint8_t spectral_rx_chainmask)
2118*5113495bSYour Name {
2119*5113495bSYour Name struct wlan_objmgr_psoc *psoc = NULL;
2120*5113495bSYour Name struct target_if_spectral *spectral = NULL;
2121*5113495bSYour Name enum spectral_scan_mode smode = SPECTRAL_SCAN_MODE_NORMAL;
2122*5113495bSYour Name struct wlan_lmac_if_rx_ops *rx_ops;
2123*5113495bSYour Name
2124*5113495bSYour Name psoc = wlan_pdev_get_psoc(pdev);
2125*5113495bSYour Name if (!psoc) {
2126*5113495bSYour Name spectral_err("psoc is NULL");
2127*5113495bSYour Name return;
2128*5113495bSYour Name }
2129*5113495bSYour Name
2130*5113495bSYour Name rx_ops = wlan_psoc_get_lmac_if_rxops(psoc);
2131*5113495bSYour Name if (!rx_ops) {
2132*5113495bSYour Name spectral_err("rx_ops is null");
2133*5113495bSYour Name return;
2134*5113495bSYour Name }
2135*5113495bSYour Name
2136*5113495bSYour Name if (smode >= SPECTRAL_SCAN_MODE_MAX) {
2137*5113495bSYour Name spectral_err("Invalid Spectral mode %u", smode);
2138*5113495bSYour Name return;
2139*5113495bSYour Name }
2140*5113495bSYour Name
2141*5113495bSYour Name if (rx_ops->sptrl_rx_ops.
2142*5113495bSYour Name sptrlro_spectral_is_feature_disabled_pdev(pdev)) {
2143*5113495bSYour Name spectral_info("Spectral feature is disabled");
2144*5113495bSYour Name return;
2145*5113495bSYour Name }
2146*5113495bSYour Name
2147*5113495bSYour Name spectral = get_target_if_spectral_handle_from_pdev(pdev);
2148*5113495bSYour Name if (!spectral) {
2149*5113495bSYour Name spectral_err("Spectral target if object is null");
2150*5113495bSYour Name return;
2151*5113495bSYour Name }
2152*5113495bSYour Name
2153*5113495bSYour Name /* set chainmask for all the modes */
2154*5113495bSYour Name for (; smode < SPECTRAL_SCAN_MODE_MAX; smode++)
2155*5113495bSYour Name spectral->params[smode].ss_chn_mask = spectral_rx_chainmask;
2156*5113495bSYour Name }
2157*5113495bSYour Name
2158*5113495bSYour Name /**
2159*5113495bSYour Name * target_if_spectral_process_phyerr() - Process Spectral PHY error
2160*5113495bSYour Name * @pdev: Pointer to pdev
2161*5113495bSYour Name * @data: PHY error data received from FW
2162*5113495bSYour Name * @datalen: Length of data
2163*5113495bSYour Name * @p_rfqual: Pointer to RF Quality information
2164*5113495bSYour Name * @p_chaninfo: Pointer to channel information
2165*5113495bSYour Name * @tsf64: TSF time instance at which the Spectral sample was received
2166*5113495bSYour Name * @acs_stats: ACS stats
2167*5113495bSYour Name *
2168*5113495bSYour Name * Process Spectral PHY error by extracting necessary information from the data
2169*5113495bSYour Name * sent by FW, and send the extracted information to application layer.
2170*5113495bSYour Name *
2171*5113495bSYour Name * Return: None
2172*5113495bSYour Name */
2173*5113495bSYour Name static inline
target_if_spectral_process_phyerr(struct wlan_objmgr_pdev * pdev,uint8_t * data,uint32_t datalen,struct target_if_spectral_rfqual_info * p_rfqual,struct target_if_spectral_chan_info * p_chaninfo,uint64_t tsf64,struct target_if_spectral_acs_stats * acs_stats)2174*5113495bSYour Name void target_if_spectral_process_phyerr(
2175*5113495bSYour Name struct wlan_objmgr_pdev *pdev,
2176*5113495bSYour Name uint8_t *data, uint32_t datalen,
2177*5113495bSYour Name struct target_if_spectral_rfqual_info *p_rfqual,
2178*5113495bSYour Name struct target_if_spectral_chan_info *p_chaninfo,
2179*5113495bSYour Name uint64_t tsf64,
2180*5113495bSYour Name struct target_if_spectral_acs_stats *acs_stats)
2181*5113495bSYour Name {
2182*5113495bSYour Name struct target_if_spectral *spectral = NULL;
2183*5113495bSYour Name struct target_if_spectral_ops *p_sops = NULL;
2184*5113495bSYour Name
2185*5113495bSYour Name spectral = get_target_if_spectral_handle_from_pdev(pdev);
2186*5113495bSYour Name if (!spectral) {
2187*5113495bSYour Name spectral_err("Spectral target if object is null");
2188*5113495bSYour Name return;
2189*5113495bSYour Name }
2190*5113495bSYour Name
2191*5113495bSYour Name p_sops = GET_TARGET_IF_SPECTRAL_OPS(spectral);
2192*5113495bSYour Name if (!p_sops->spectral_process_phyerr) {
2193*5113495bSYour Name spectral_err("null spectral_process_phyerr");
2194*5113495bSYour Name return;
2195*5113495bSYour Name }
2196*5113495bSYour Name p_sops->spectral_process_phyerr(spectral, data, datalen,
2197*5113495bSYour Name p_rfqual, p_chaninfo,
2198*5113495bSYour Name tsf64, acs_stats);
2199*5113495bSYour Name }
2200*5113495bSYour Name
2201*5113495bSYour Name static QDF_STATUS
target_if_get_spectral_msg_type(enum spectral_scan_mode smode,enum spectral_msg_type * msg_type)2202*5113495bSYour Name target_if_get_spectral_msg_type(enum spectral_scan_mode smode,
2203*5113495bSYour Name enum spectral_msg_type *msg_type) {
2204*5113495bSYour Name
2205*5113495bSYour Name switch (smode) {
2206*5113495bSYour Name case SPECTRAL_SCAN_MODE_NORMAL:
2207*5113495bSYour Name *msg_type = SPECTRAL_MSG_NORMAL_MODE;
2208*5113495bSYour Name break;
2209*5113495bSYour Name
2210*5113495bSYour Name case SPECTRAL_SCAN_MODE_AGILE:
2211*5113495bSYour Name *msg_type = SPECTRAL_MSG_AGILE_MODE;
2212*5113495bSYour Name break;
2213*5113495bSYour Name
2214*5113495bSYour Name default:
2215*5113495bSYour Name spectral_err("Invalid spectral mode");
2216*5113495bSYour Name return QDF_STATUS_E_FAILURE;
2217*5113495bSYour Name }
2218*5113495bSYour Name
2219*5113495bSYour Name return QDF_STATUS_SUCCESS;
2220*5113495bSYour Name }
2221*5113495bSYour Name
2222*5113495bSYour Name static inline bool
is_ch_width_160_or_80p80(enum phy_ch_width ch_width)2223*5113495bSYour Name is_ch_width_160_or_80p80(enum phy_ch_width ch_width)
2224*5113495bSYour Name {
2225*5113495bSYour Name return (ch_width == CH_WIDTH_160MHZ || ch_width == CH_WIDTH_80P80MHZ);
2226*5113495bSYour Name }
2227*5113495bSYour Name
2228*5113495bSYour Name /**
2229*5113495bSYour Name * free_samp_msg_skb() - Free SAMP message skb
2230*5113495bSYour Name * @spectral: Pointer to Spectral
2231*5113495bSYour Name * @smode: Spectral Scan mode
2232*5113495bSYour Name *
2233*5113495bSYour Name * Free SAMP message skb, if error in report processing
2234*5113495bSYour Name *
2235*5113495bSYour Name * Return: void
2236*5113495bSYour Name */
2237*5113495bSYour Name static inline void
free_samp_msg_skb(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2238*5113495bSYour Name free_samp_msg_skb(struct target_if_spectral *spectral,
2239*5113495bSYour Name enum spectral_scan_mode smode)
2240*5113495bSYour Name {
2241*5113495bSYour Name enum spectral_msg_type smsg_type;
2242*5113495bSYour Name QDF_STATUS ret;
2243*5113495bSYour Name
2244*5113495bSYour Name if (smode >= SPECTRAL_SCAN_MODE_MAX) {
2245*5113495bSYour Name spectral_err_rl("Invalid Spectral mode %d", smode);
2246*5113495bSYour Name return;
2247*5113495bSYour Name }
2248*5113495bSYour Name
2249*5113495bSYour Name if (is_ch_width_160_or_80p80(spectral->ch_width[smode])) {
2250*5113495bSYour Name ret = target_if_get_spectral_msg_type(smode, &smsg_type);
2251*5113495bSYour Name if (QDF_IS_STATUS_ERROR(ret)) {
2252*5113495bSYour Name spectral_err("Failed to get spectral message type");
2253*5113495bSYour Name return;
2254*5113495bSYour Name }
2255*5113495bSYour Name spectral->nl_cb.free_sbuff(spectral->pdev_obj,
2256*5113495bSYour Name smsg_type);
2257*5113495bSYour Name }
2258*5113495bSYour Name }
2259*5113495bSYour Name
2260*5113495bSYour Name /**
2261*5113495bSYour Name * init_160mhz_delivery_state_machine() - Initialize 160MHz Spectral
2262*5113495bSYour Name * state machine
2263*5113495bSYour Name * @spectral: Pointer to Spectral
2264*5113495bSYour Name *
2265*5113495bSYour Name * Initialize 160MHz Spectral state machine
2266*5113495bSYour Name *
2267*5113495bSYour Name * Return: void
2268*5113495bSYour Name */
2269*5113495bSYour Name static inline void
init_160mhz_delivery_state_machine(struct target_if_spectral * spectral)2270*5113495bSYour Name init_160mhz_delivery_state_machine(struct target_if_spectral *spectral)
2271*5113495bSYour Name {
2272*5113495bSYour Name uint8_t smode;
2273*5113495bSYour Name
2274*5113495bSYour Name smode = 0;
2275*5113495bSYour Name for (; smode < SPECTRAL_SCAN_MODE_MAX; smode++)
2276*5113495bSYour Name spectral->state_160mhz_delivery[smode] =
2277*5113495bSYour Name SPECTRAL_REPORT_WAIT_PRIMARY80;
2278*5113495bSYour Name }
2279*5113495bSYour Name
2280*5113495bSYour Name /**
2281*5113495bSYour Name * reset_160mhz_delivery_state_machine() - Reset 160MHz Spectral state machine
2282*5113495bSYour Name * @spectral: Pointer to Spectral
2283*5113495bSYour Name * @smode: Spectral scan mode
2284*5113495bSYour Name *
2285*5113495bSYour Name * Reset 160MHz Spectral state machine
2286*5113495bSYour Name *
2287*5113495bSYour Name * Return: void
2288*5113495bSYour Name */
2289*5113495bSYour Name static inline void
reset_160mhz_delivery_state_machine(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2290*5113495bSYour Name reset_160mhz_delivery_state_machine(struct target_if_spectral *spectral,
2291*5113495bSYour Name enum spectral_scan_mode smode)
2292*5113495bSYour Name {
2293*5113495bSYour Name if (smode >= SPECTRAL_SCAN_MODE_MAX) {
2294*5113495bSYour Name spectral_err_rl("Invalid Spectral mode %d", smode);
2295*5113495bSYour Name return;
2296*5113495bSYour Name }
2297*5113495bSYour Name
2298*5113495bSYour Name free_samp_msg_skb(spectral, smode);
2299*5113495bSYour Name
2300*5113495bSYour Name if (is_ch_width_160_or_80p80(spectral->ch_width[smode])) {
2301*5113495bSYour Name spectral->state_160mhz_delivery[smode] =
2302*5113495bSYour Name SPECTRAL_REPORT_WAIT_PRIMARY80;
2303*5113495bSYour Name }
2304*5113495bSYour Name }
2305*5113495bSYour Name
2306*5113495bSYour Name /**
2307*5113495bSYour Name * is_secondaryseg_expected() - Is waiting for secondary 80 report
2308*5113495bSYour Name * @spectral: Pointer to Spectral
2309*5113495bSYour Name * @smode: Spectral scan mode
2310*5113495bSYour Name *
2311*5113495bSYour Name * Return true if secondary 80 report expected and mode is 160 MHz
2312*5113495bSYour Name *
2313*5113495bSYour Name * Return: true or false
2314*5113495bSYour Name */
2315*5113495bSYour Name static inline
is_secondaryseg_expected(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2316*5113495bSYour Name bool is_secondaryseg_expected(struct target_if_spectral *spectral,
2317*5113495bSYour Name enum spectral_scan_mode smode)
2318*5113495bSYour Name {
2319*5113495bSYour Name return
2320*5113495bSYour Name (is_ch_width_160_or_80p80(spectral->ch_width[smode]) &&
2321*5113495bSYour Name spectral->rparams.fragmentation_160[smode] &&
2322*5113495bSYour Name (spectral->state_160mhz_delivery[smode] ==
2323*5113495bSYour Name SPECTRAL_REPORT_WAIT_SECONDARY80));
2324*5113495bSYour Name }
2325*5113495bSYour Name
2326*5113495bSYour Name /**
2327*5113495bSYour Name * is_primaryseg_expected() - Is waiting for primary 80 report
2328*5113495bSYour Name * @spectral: Pointer to Spectral
2329*5113495bSYour Name * @smode: Spectral scan mode
2330*5113495bSYour Name *
2331*5113495bSYour Name * Return true if mode is 160 Mhz and primary 80 report expected or
2332*5113495bSYour Name * mode is not 160 Mhz
2333*5113495bSYour Name *
2334*5113495bSYour Name * Return: true or false
2335*5113495bSYour Name */
2336*5113495bSYour Name static inline
is_primaryseg_expected(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2337*5113495bSYour Name bool is_primaryseg_expected(struct target_if_spectral *spectral,
2338*5113495bSYour Name enum spectral_scan_mode smode)
2339*5113495bSYour Name {
2340*5113495bSYour Name return
2341*5113495bSYour Name (!is_ch_width_160_or_80p80(spectral->ch_width[smode]) ||
2342*5113495bSYour Name !spectral->rparams.fragmentation_160[smode] ||
2343*5113495bSYour Name (spectral->state_160mhz_delivery[smode] ==
2344*5113495bSYour Name SPECTRAL_REPORT_WAIT_PRIMARY80));
2345*5113495bSYour Name }
2346*5113495bSYour Name
2347*5113495bSYour Name #ifndef OPTIMIZED_SAMP_MESSAGE
2348*5113495bSYour Name /**
2349*5113495bSYour Name * is_primaryseg_rx_inprog() - Is primary 80 report processing is in progress
2350*5113495bSYour Name * @spectral: Pointer to Spectral
2351*5113495bSYour Name * @smode: Spectral scan mode
2352*5113495bSYour Name *
2353*5113495bSYour Name * Is primary 80 report processing is in progress
2354*5113495bSYour Name *
2355*5113495bSYour Name * Return: true or false
2356*5113495bSYour Name */
2357*5113495bSYour Name static inline
is_primaryseg_rx_inprog(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2358*5113495bSYour Name bool is_primaryseg_rx_inprog(struct target_if_spectral *spectral,
2359*5113495bSYour Name enum spectral_scan_mode smode)
2360*5113495bSYour Name {
2361*5113495bSYour Name return
2362*5113495bSYour Name (!is_ch_width_160_or_80p80(spectral->ch_width[smode]) ||
2363*5113495bSYour Name spectral->spectral_gen == SPECTRAL_GEN2 ||
2364*5113495bSYour Name (spectral->spectral_gen == SPECTRAL_GEN3 &&
2365*5113495bSYour Name (!spectral->rparams.fragmentation_160[smode] ||
2366*5113495bSYour Name spectral->state_160mhz_delivery[smode] ==
2367*5113495bSYour Name SPECTRAL_REPORT_RX_PRIMARY80)));
2368*5113495bSYour Name }
2369*5113495bSYour Name
2370*5113495bSYour Name /**
2371*5113495bSYour Name * is_secondaryseg_rx_inprog() - Is secondary80 report processing is in progress
2372*5113495bSYour Name * @spectral: Pointer to Spectral
2373*5113495bSYour Name * @smode: Spectral scan mode
2374*5113495bSYour Name *
2375*5113495bSYour Name * Is secondary 80 report processing is in progress
2376*5113495bSYour Name *
2377*5113495bSYour Name * Return: true or false
2378*5113495bSYour Name */
2379*5113495bSYour Name static inline
is_secondaryseg_rx_inprog(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2380*5113495bSYour Name bool is_secondaryseg_rx_inprog(struct target_if_spectral *spectral,
2381*5113495bSYour Name enum spectral_scan_mode smode)
2382*5113495bSYour Name {
2383*5113495bSYour Name return
2384*5113495bSYour Name (is_ch_width_160_or_80p80(spectral->ch_width[smode]) &&
2385*5113495bSYour Name (spectral->spectral_gen == SPECTRAL_GEN2 ||
2386*5113495bSYour Name ((spectral->spectral_gen == SPECTRAL_GEN3) &&
2387*5113495bSYour Name (!spectral->rparams.fragmentation_160[smode] ||
2388*5113495bSYour Name spectral->state_160mhz_delivery[smode] ==
2389*5113495bSYour Name SPECTRAL_REPORT_RX_SECONDARY80))));
2390*5113495bSYour Name }
2391*5113495bSYour Name #endif
2392*5113495bSYour Name
2393*5113495bSYour Name /**
2394*5113495bSYour Name * clamp_fft_bin_value() - Clamp the FFT bin value between min and max
2395*5113495bSYour Name * @fft_bin_value: FFT bin value as reported by HW
2396*5113495bSYour Name * @pwr_format: FFT bin format (linear or dBm format)
2397*5113495bSYour Name *
2398*5113495bSYour Name * Each FFT bin value is represented as an 8 bit integer in SAMP message. But
2399*5113495bSYour Name * depending on the configuration, the FFT bin value reported by HW might
2400*5113495bSYour Name * exceed 8 bits. Clamp the FFT bin value between the min and max value
2401*5113495bSYour Name * which can be represented by 8 bits. For linear mode, min and max FFT bin
2402*5113495bSYour Name * value which can be represented by 8 bit is 0 and U8_MAX respectively. For
2403*5113495bSYour Name * dBm mode, min and max FFT bin value which can be represented by 8 bit is
2404*5113495bSYour Name * S8_MIN and S8_MAX respectively.
2405*5113495bSYour Name *
2406*5113495bSYour Name * Return: Clamped FFT bin value
2407*5113495bSYour Name */
2408*5113495bSYour Name static inline uint8_t
clamp_fft_bin_value(uint16_t fft_bin_value,uint16_t pwr_format)2409*5113495bSYour Name clamp_fft_bin_value(uint16_t fft_bin_value, uint16_t pwr_format)
2410*5113495bSYour Name {
2411*5113495bSYour Name uint8_t clamped_fft_bin_value = 0;
2412*5113495bSYour Name
2413*5113495bSYour Name switch (pwr_format) {
2414*5113495bSYour Name case SPECTRAL_PWR_FORMAT_LINEAR:
2415*5113495bSYour Name if (qdf_unlikely(fft_bin_value > MAX_FFTBIN_VALUE_LINEAR_MODE))
2416*5113495bSYour Name clamped_fft_bin_value = MAX_FFTBIN_VALUE_LINEAR_MODE;
2417*5113495bSYour Name else
2418*5113495bSYour Name clamped_fft_bin_value = fft_bin_value;
2419*5113495bSYour Name break;
2420*5113495bSYour Name
2421*5113495bSYour Name case SPECTRAL_PWR_FORMAT_DBM:
2422*5113495bSYour Name if (qdf_unlikely((int16_t)fft_bin_value >
2423*5113495bSYour Name MAX_FFTBIN_VALUE_DBM_MODE))
2424*5113495bSYour Name clamped_fft_bin_value = MAX_FFTBIN_VALUE_DBM_MODE;
2425*5113495bSYour Name else if (qdf_unlikely((int16_t)fft_bin_value <
2426*5113495bSYour Name MIN_FFTBIN_VALUE_DBM_MODE))
2427*5113495bSYour Name clamped_fft_bin_value = MIN_FFTBIN_VALUE_DBM_MODE;
2428*5113495bSYour Name else
2429*5113495bSYour Name clamped_fft_bin_value = fft_bin_value;
2430*5113495bSYour Name break;
2431*5113495bSYour Name
2432*5113495bSYour Name default:
2433*5113495bSYour Name spectral_err_rl("Invalid pwr format: %d.", pwr_format);
2434*5113495bSYour Name return 0;
2435*5113495bSYour Name }
2436*5113495bSYour Name
2437*5113495bSYour Name return clamped_fft_bin_value;
2438*5113495bSYour Name }
2439*5113495bSYour Name
2440*5113495bSYour Name /**
2441*5113495bSYour Name * target_if_160mhz_delivery_state_change() - State transition for 160Mhz
2442*5113495bSYour Name * Spectral
2443*5113495bSYour Name * @spectral: Pointer to spectral object
2444*5113495bSYour Name * @smode: Spectral scan mode
2445*5113495bSYour Name * @detector_id: Detector id
2446*5113495bSYour Name *
2447*5113495bSYour Name * Move the states of state machine for 160MHz spectral scan report receive
2448*5113495bSYour Name *
2449*5113495bSYour Name * Return: QDF_STATUS
2450*5113495bSYour Name */
2451*5113495bSYour Name QDF_STATUS
2452*5113495bSYour Name target_if_160mhz_delivery_state_change(struct target_if_spectral *spectral,
2453*5113495bSYour Name enum spectral_scan_mode smode,
2454*5113495bSYour Name uint8_t detector_id);
2455*5113495bSYour Name
2456*5113495bSYour Name /**
2457*5113495bSYour Name * target_if_sops_is_spectral_enabled() - Get whether Spectral is enabled
2458*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2459*5113495bSYour Name * @smode: Spectral scan mode
2460*5113495bSYour Name *
2461*5113495bSYour Name * Function to check whether Spectral is enabled
2462*5113495bSYour Name *
2463*5113495bSYour Name * Return: True if Spectral is enabled, false if Spectral is not enabled
2464*5113495bSYour Name */
2465*5113495bSYour Name uint32_t target_if_sops_is_spectral_enabled(void *arg,
2466*5113495bSYour Name enum spectral_scan_mode smode);
2467*5113495bSYour Name
2468*5113495bSYour Name /**
2469*5113495bSYour Name * target_if_sops_is_spectral_active() - Get whether Spectral is active
2470*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2471*5113495bSYour Name * @smode: Spectral scan mode
2472*5113495bSYour Name *
2473*5113495bSYour Name * Function to check whether Spectral is active
2474*5113495bSYour Name *
2475*5113495bSYour Name * Return: True if Spectral is active, false if Spectral is not active
2476*5113495bSYour Name */
2477*5113495bSYour Name uint32_t target_if_sops_is_spectral_active(void *arg,
2478*5113495bSYour Name enum spectral_scan_mode smode);
2479*5113495bSYour Name
2480*5113495bSYour Name /**
2481*5113495bSYour Name * target_if_sops_start_spectral_scan() - Start Spectral scan
2482*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2483*5113495bSYour Name * @smode: Spectral scan mode
2484*5113495bSYour Name * @err: Pointer to error code
2485*5113495bSYour Name *
2486*5113495bSYour Name * Function to start spectral scan
2487*5113495bSYour Name *
2488*5113495bSYour Name * Return: 0 on success else failure
2489*5113495bSYour Name */
2490*5113495bSYour Name uint32_t target_if_sops_start_spectral_scan(void *arg,
2491*5113495bSYour Name enum spectral_scan_mode smode,
2492*5113495bSYour Name enum spectral_cp_error_code *err);
2493*5113495bSYour Name
2494*5113495bSYour Name /**
2495*5113495bSYour Name * target_if_sops_stop_spectral_scan() - Stop Spectral scan
2496*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2497*5113495bSYour Name * @smode: Spectral scan mode
2498*5113495bSYour Name *
2499*5113495bSYour Name * Function to stop spectral scan
2500*5113495bSYour Name *
2501*5113495bSYour Name * Return: 0 in case of success, -1 on failure
2502*5113495bSYour Name */
2503*5113495bSYour Name uint32_t target_if_sops_stop_spectral_scan(void *arg,
2504*5113495bSYour Name enum spectral_scan_mode smode);
2505*5113495bSYour Name
2506*5113495bSYour Name /**
2507*5113495bSYour Name * target_if_spectral_get_extension_channel() - Get the current Extension
2508*5113495bSYour Name * channel (in MHz)
2509*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2510*5113495bSYour Name * @smode: Spectral scan mode
2511*5113495bSYour Name *
2512*5113495bSYour Name * Return: Current Extension channel (in MHz) on success, 0 on failure or if
2513*5113495bSYour Name * extension channel is not present.
2514*5113495bSYour Name */
2515*5113495bSYour Name uint32_t
2516*5113495bSYour Name target_if_spectral_get_extension_channel(void *arg,
2517*5113495bSYour Name enum spectral_scan_mode smode);
2518*5113495bSYour Name
2519*5113495bSYour Name /**
2520*5113495bSYour Name * target_if_spectral_get_current_channel() - Get the current channel (in MHz)
2521*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2522*5113495bSYour Name * @smode: Spectral scan mode
2523*5113495bSYour Name *
2524*5113495bSYour Name * Return: Current channel (in MHz) on success, 0 on failure
2525*5113495bSYour Name */
2526*5113495bSYour Name uint32_t
2527*5113495bSYour Name target_if_spectral_get_current_channel(void *arg,
2528*5113495bSYour Name enum spectral_scan_mode smode);
2529*5113495bSYour Name
2530*5113495bSYour Name
2531*5113495bSYour Name /**
2532*5113495bSYour Name * target_if_spectral_reset_hw() - Reset the hardware
2533*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2534*5113495bSYour Name *
2535*5113495bSYour Name * This is only a placeholder since it is not currently required in the offload
2536*5113495bSYour Name * case.
2537*5113495bSYour Name *
2538*5113495bSYour Name * Return: 0
2539*5113495bSYour Name */
2540*5113495bSYour Name uint32_t target_if_spectral_reset_hw(void *arg);
2541*5113495bSYour Name
2542*5113495bSYour Name /**
2543*5113495bSYour Name * target_if_spectral_get_chain_noise_floor() - Get the Chain noise floor from
2544*5113495bSYour Name * Noisefloor history buffer
2545*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2546*5113495bSYour Name * @nf_buf: Pointer to buffer into which chain Noise Floor data should be copied
2547*5113495bSYour Name *
2548*5113495bSYour Name * This is only a placeholder since it is not currently required in the offload
2549*5113495bSYour Name * case.
2550*5113495bSYour Name *
2551*5113495bSYour Name * Return: 0
2552*5113495bSYour Name */
2553*5113495bSYour Name uint32_t target_if_spectral_get_chain_noise_floor(void *arg, int16_t *nf_buf);
2554*5113495bSYour Name
2555*5113495bSYour Name /**
2556*5113495bSYour Name * target_if_spectral_get_ext_noisefloor() - Get the extension channel
2557*5113495bSYour Name * noisefloor
2558*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2559*5113495bSYour Name *
2560*5113495bSYour Name * This is only a placeholder since it is not currently required in the offload
2561*5113495bSYour Name * case.
2562*5113495bSYour Name *
2563*5113495bSYour Name * Return: 0
2564*5113495bSYour Name */
2565*5113495bSYour Name int8_t target_if_spectral_get_ext_noisefloor(void *arg);
2566*5113495bSYour Name
2567*5113495bSYour Name /**
2568*5113495bSYour Name * target_if_spectral_get_ctl_noisefloor() - Get the control channel noisefloor
2569*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2570*5113495bSYour Name *
2571*5113495bSYour Name * This is only a placeholder since it is not currently required in the offload
2572*5113495bSYour Name * case.
2573*5113495bSYour Name *
2574*5113495bSYour Name * Return: 0
2575*5113495bSYour Name */
2576*5113495bSYour Name int8_t target_if_spectral_get_ctl_noisefloor(void *arg);
2577*5113495bSYour Name
2578*5113495bSYour Name /**
2579*5113495bSYour Name * target_if_spectral_get_capability() - Get whether a given Spectral hardware
2580*5113495bSYour Name * capability is available
2581*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2582*5113495bSYour Name * @type: Spectral hardware capability type
2583*5113495bSYour Name *
2584*5113495bSYour Name * Return: True if the capability is available, false if the capability is not
2585*5113495bSYour Name * available
2586*5113495bSYour Name */
2587*5113495bSYour Name uint32_t target_if_spectral_get_capability(
2588*5113495bSYour Name void *arg, enum spectral_capability_type type);
2589*5113495bSYour Name
2590*5113495bSYour Name /**
2591*5113495bSYour Name * target_if_spectral_set_rxfilter() - Set the RX Filter before Spectral start
2592*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2593*5113495bSYour Name * @rxfilter: Rx filter to be used
2594*5113495bSYour Name *
2595*5113495bSYour Name * Note: This is only a placeholder function. It is not currently required since
2596*5113495bSYour Name * FW should be taking care of setting the required filters.
2597*5113495bSYour Name *
2598*5113495bSYour Name * Return: 0
2599*5113495bSYour Name */
2600*5113495bSYour Name uint32_t target_if_spectral_set_rxfilter(void *arg, int rxfilter);
2601*5113495bSYour Name
2602*5113495bSYour Name /**
2603*5113495bSYour Name * target_if_spectral_sops_configure_params() - Configure user supplied Spectral
2604*5113495bSYour Name * parameters
2605*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2606*5113495bSYour Name * @params: Spectral parameters
2607*5113495bSYour Name * @smode: Spectral scan mode
2608*5113495bSYour Name *
2609*5113495bSYour Name * Return: 0 in case of success, -1 on failure
2610*5113495bSYour Name */
2611*5113495bSYour Name uint32_t target_if_spectral_sops_configure_params(
2612*5113495bSYour Name void *arg, struct spectral_config *params,
2613*5113495bSYour Name enum spectral_scan_mode smode);
2614*5113495bSYour Name
2615*5113495bSYour Name /**
2616*5113495bSYour Name * target_if_spectral_get_rxfilter() - Get the current RX Filter settings
2617*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2618*5113495bSYour Name *
2619*5113495bSYour Name * Note: This is only a placeholder function. It is not currently required since
2620*5113495bSYour Name * FW should be taking care of setting the required filters.
2621*5113495bSYour Name *
2622*5113495bSYour Name * Return: 0
2623*5113495bSYour Name */
2624*5113495bSYour Name uint32_t target_if_spectral_get_rxfilter(void *arg);
2625*5113495bSYour Name
2626*5113495bSYour Name /**
2627*5113495bSYour Name * target_if_pdev_spectral_deinit() - De-initialize target_if Spectral
2628*5113495bSYour Name * functionality for the given pdev
2629*5113495bSYour Name * @pdev: Pointer to pdev object
2630*5113495bSYour Name *
2631*5113495bSYour Name * Return: None
2632*5113495bSYour Name */
2633*5113495bSYour Name void target_if_pdev_spectral_deinit(struct wlan_objmgr_pdev *pdev);
2634*5113495bSYour Name
2635*5113495bSYour Name /**
2636*5113495bSYour Name * target_if_set_spectral_config() - Set spectral config
2637*5113495bSYour Name * @pdev: Pointer to pdev object
2638*5113495bSYour Name * @param: Spectral parameter id and value
2639*5113495bSYour Name * @smode: Spectral scan mode
2640*5113495bSYour Name * @err: Pointer to Spectral error code
2641*5113495bSYour Name *
2642*5113495bSYour Name * API to set spectral configurations
2643*5113495bSYour Name *
2644*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2645*5113495bSYour Name */
2646*5113495bSYour Name QDF_STATUS target_if_set_spectral_config(struct wlan_objmgr_pdev *pdev,
2647*5113495bSYour Name const struct spectral_cp_param *param,
2648*5113495bSYour Name const enum spectral_scan_mode smode,
2649*5113495bSYour Name enum spectral_cp_error_code *err);
2650*5113495bSYour Name
2651*5113495bSYour Name /**
2652*5113495bSYour Name * target_if_pdev_spectral_init() - Initialize target_if Spectral
2653*5113495bSYour Name * functionality for the given pdev
2654*5113495bSYour Name * @pdev: Pointer to pdev object
2655*5113495bSYour Name *
2656*5113495bSYour Name * Return: On success, pointer to Spectral target_if internal private data, on
2657*5113495bSYour Name * failure, NULL
2658*5113495bSYour Name */
2659*5113495bSYour Name void *target_if_pdev_spectral_init(struct wlan_objmgr_pdev *pdev);
2660*5113495bSYour Name
2661*5113495bSYour Name /**
2662*5113495bSYour Name * target_if_spectral_sops_get_params() - Get user configured Spectral
2663*5113495bSYour Name * parameters
2664*5113495bSYour Name * @arg: Pointer to handle for Spectral target_if internal private data
2665*5113495bSYour Name * @params: Pointer to buffer into which Spectral parameters should be copied
2666*5113495bSYour Name * @smode: Spectral scan mode
2667*5113495bSYour Name *
2668*5113495bSYour Name * Return: 0 in case of success, -1 on failure
2669*5113495bSYour Name */
2670*5113495bSYour Name uint32_t target_if_spectral_sops_get_params(
2671*5113495bSYour Name void *arg, struct spectral_config *params,
2672*5113495bSYour Name enum spectral_scan_mode smode);
2673*5113495bSYour Name
2674*5113495bSYour Name /**
2675*5113495bSYour Name * target_if_init_spectral_capability() - Initialize Spectral capability
2676*5113495bSYour Name *
2677*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
2678*5113495bSYour Name * @target_type: target type
2679*5113495bSYour Name *
2680*5113495bSYour Name * This is a workaround.
2681*5113495bSYour Name *
2682*5113495bSYour Name * Return: QDF_STATUS
2683*5113495bSYour Name */
2684*5113495bSYour Name QDF_STATUS
2685*5113495bSYour Name target_if_init_spectral_capability(struct target_if_spectral *spectral,
2686*5113495bSYour Name uint32_t target_type);
2687*5113495bSYour Name
2688*5113495bSYour Name /**
2689*5113495bSYour Name * target_if_start_spectral_scan() - Start spectral scan
2690*5113495bSYour Name * @pdev: Pointer to pdev object
2691*5113495bSYour Name * @vdev_id: VDEV id
2692*5113495bSYour Name * @smode: Spectral scan mode
2693*5113495bSYour Name * @err: Spectral error code
2694*5113495bSYour Name *
2695*5113495bSYour Name * API to start spectral scan
2696*5113495bSYour Name *
2697*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2698*5113495bSYour Name */
2699*5113495bSYour Name QDF_STATUS target_if_start_spectral_scan(struct wlan_objmgr_pdev *pdev,
2700*5113495bSYour Name uint8_t vdev_id,
2701*5113495bSYour Name enum spectral_scan_mode smode,
2702*5113495bSYour Name enum spectral_cp_error_code *err);
2703*5113495bSYour Name
2704*5113495bSYour Name /**
2705*5113495bSYour Name * target_if_get_spectral_config() - Get spectral configuration
2706*5113495bSYour Name * @pdev: Pointer to pdev object
2707*5113495bSYour Name * @param: Pointer to spectral_config structure in which the configuration
2708*5113495bSYour Name * should be returned
2709*5113495bSYour Name * @smode: Spectral scan mode
2710*5113495bSYour Name *
2711*5113495bSYour Name * API to get the current spectral configuration
2712*5113495bSYour Name *
2713*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2714*5113495bSYour Name */
2715*5113495bSYour Name QDF_STATUS target_if_get_spectral_config(struct wlan_objmgr_pdev *pdev,
2716*5113495bSYour Name struct spectral_config *param,
2717*5113495bSYour Name enum spectral_scan_mode smode);
2718*5113495bSYour Name
2719*5113495bSYour Name /**
2720*5113495bSYour Name * target_if_spectral_scan_enable_params() - Enable use of desired Spectral
2721*5113495bSYour Name * parameters
2722*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
2723*5113495bSYour Name * @spectral_params: Pointer to Spectral parameters
2724*5113495bSYour Name * @smode: Spectral scan mode
2725*5113495bSYour Name * @err: Spectral error code
2726*5113495bSYour Name *
2727*5113495bSYour Name * Enable use of desired Spectral parameters by configuring them into HW, and
2728*5113495bSYour Name * starting Spectral scan
2729*5113495bSYour Name *
2730*5113495bSYour Name * Return: 0 on success, 1 on failure
2731*5113495bSYour Name */
2732*5113495bSYour Name int target_if_spectral_scan_enable_params(
2733*5113495bSYour Name struct target_if_spectral *spectral,
2734*5113495bSYour Name struct spectral_config *spectral_params,
2735*5113495bSYour Name enum spectral_scan_mode smode,
2736*5113495bSYour Name enum spectral_cp_error_code *err);
2737*5113495bSYour Name
2738*5113495bSYour Name /**
2739*5113495bSYour Name * target_if_is_spectral_active() - Get whether Spectral is active
2740*5113495bSYour Name * @pdev: Pointer to pdev object
2741*5113495bSYour Name * @smode: Spectral scan mode
2742*5113495bSYour Name *
2743*5113495bSYour Name * Return: True if Spectral is active, false if Spectral is not active
2744*5113495bSYour Name */
2745*5113495bSYour Name bool target_if_is_spectral_active(struct wlan_objmgr_pdev *pdev,
2746*5113495bSYour Name enum spectral_scan_mode smode);
2747*5113495bSYour Name
2748*5113495bSYour Name /**
2749*5113495bSYour Name * target_if_is_spectral_enabled() - Get whether Spectral is enabled
2750*5113495bSYour Name * @pdev: Pointer to pdev object
2751*5113495bSYour Name * @smode: Spectral scan mode
2752*5113495bSYour Name *
2753*5113495bSYour Name * Return: True if Spectral is enabled, false if Spectral is not enabled
2754*5113495bSYour Name */
2755*5113495bSYour Name bool target_if_is_spectral_enabled(struct wlan_objmgr_pdev *pdev,
2756*5113495bSYour Name enum spectral_scan_mode smode);
2757*5113495bSYour Name
2758*5113495bSYour Name /**
2759*5113495bSYour Name * target_if_set_debug_level() - Set debug level for Spectral
2760*5113495bSYour Name * @pdev: Pointer to pdev object
2761*5113495bSYour Name * @debug_level: Debug level
2762*5113495bSYour Name *
2763*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2764*5113495bSYour Name *
2765*5113495bSYour Name */
2766*5113495bSYour Name QDF_STATUS target_if_set_debug_level(struct wlan_objmgr_pdev *pdev,
2767*5113495bSYour Name uint32_t debug_level);
2768*5113495bSYour Name
2769*5113495bSYour Name /**
2770*5113495bSYour Name * target_if_get_debug_level() - Get debug level for Spectral
2771*5113495bSYour Name * @pdev: Pointer to pdev object
2772*5113495bSYour Name *
2773*5113495bSYour Name * Return: Current debug level
2774*5113495bSYour Name */
2775*5113495bSYour Name uint32_t target_if_get_debug_level(struct wlan_objmgr_pdev *pdev);
2776*5113495bSYour Name
2777*5113495bSYour Name
2778*5113495bSYour Name /**
2779*5113495bSYour Name * target_if_get_spectral_capinfo() - Get Spectral capability information
2780*5113495bSYour Name * @pdev: Pointer to pdev object
2781*5113495bSYour Name * @scaps: Buffer into which data should be copied
2782*5113495bSYour Name *
2783*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2784*5113495bSYour Name */
2785*5113495bSYour Name QDF_STATUS target_if_get_spectral_capinfo(struct wlan_objmgr_pdev *pdev,
2786*5113495bSYour Name struct spectral_caps *scaps);
2787*5113495bSYour Name
2788*5113495bSYour Name
2789*5113495bSYour Name /**
2790*5113495bSYour Name * target_if_get_spectral_diagstats() - Get Spectral diagnostic statistics
2791*5113495bSYour Name * @pdev: Pointer to pdev object
2792*5113495bSYour Name * @stats: Buffer into which data should be copied
2793*5113495bSYour Name *
2794*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2795*5113495bSYour Name */
2796*5113495bSYour Name QDF_STATUS target_if_get_spectral_diagstats(struct wlan_objmgr_pdev *pdev,
2797*5113495bSYour Name struct spectral_diag_stats *stats);
2798*5113495bSYour Name
2799*5113495bSYour Name QDF_STATUS
2800*5113495bSYour Name target_if_160mhz_delivery_state_change(struct target_if_spectral *spectral,
2801*5113495bSYour Name enum spectral_scan_mode smode,
2802*5113495bSYour Name uint8_t detector_id);
2803*5113495bSYour Name
2804*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
2805*5113495bSYour Name /**
2806*5113495bSYour Name * target_if_spectral_get_num_fft_bins() - Get number of FFT bins from FFT size
2807*5113495bSYour Name * according to the Spectral report mode.
2808*5113495bSYour Name * @fft_size: FFT length
2809*5113495bSYour Name * @report_mode: Spectral report mode
2810*5113495bSYour Name *
2811*5113495bSYour Name * Get number of FFT bins from FFT size according to the Spectral
2812*5113495bSYour Name * report mode.
2813*5113495bSYour Name *
2814*5113495bSYour Name * Return: Number of FFT bins
2815*5113495bSYour Name */
2816*5113495bSYour Name static inline uint32_t
target_if_spectral_get_num_fft_bins(uint32_t fft_size,enum spectral_report_mode report_mode)2817*5113495bSYour Name target_if_spectral_get_num_fft_bins(uint32_t fft_size,
2818*5113495bSYour Name enum spectral_report_mode report_mode)
2819*5113495bSYour Name {
2820*5113495bSYour Name switch (report_mode) {
2821*5113495bSYour Name case SPECTRAL_REPORT_MODE_0:
2822*5113495bSYour Name case SPECTRAL_REPORT_MODE_1:
2823*5113495bSYour Name return 0;
2824*5113495bSYour Name case SPECTRAL_REPORT_MODE_2:
2825*5113495bSYour Name return (1 << (fft_size - 1));
2826*5113495bSYour Name case SPECTRAL_REPORT_MODE_3:
2827*5113495bSYour Name return (1 << fft_size);
2828*5113495bSYour Name default:
2829*5113495bSYour Name return -EINVAL;
2830*5113495bSYour Name }
2831*5113495bSYour Name }
2832*5113495bSYour Name #endif /* OPTIMIZED_SAMP_MESSAGE */
2833*5113495bSYour Name
2834*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
2835*5113495bSYour Name /**
2836*5113495bSYour Name * target_if_get_detector_chwidth() - Get per-detector bandwidth
2837*5113495bSYour Name * based on channel width and fragmentation.
2838*5113495bSYour Name * @ch_width: Spectral scan channel width
2839*5113495bSYour Name * @fragmentation_160: Target type has fragmentation or not
2840*5113495bSYour Name *
2841*5113495bSYour Name * Get per-detector BW.
2842*5113495bSYour Name *
2843*5113495bSYour Name * Return: detector BW
2844*5113495bSYour Name */
2845*5113495bSYour Name static inline
target_if_get_detector_chwidth(enum phy_ch_width ch_width,bool fragmentation_160)2846*5113495bSYour Name enum phy_ch_width target_if_get_detector_chwidth(enum phy_ch_width ch_width,
2847*5113495bSYour Name bool fragmentation_160)
2848*5113495bSYour Name {
2849*5113495bSYour Name return ((ch_width == CH_WIDTH_160MHZ && fragmentation_160) ?
2850*5113495bSYour Name CH_WIDTH_80MHZ : ((ch_width == CH_WIDTH_80P80MHZ) ?
2851*5113495bSYour Name CH_WIDTH_80MHZ : ch_width));
2852*5113495bSYour Name }
2853*5113495bSYour Name
2854*5113495bSYour Name /**
2855*5113495bSYour Name * target_if_spectral_set_start_end_freq() - Set start and end frequencies for
2856*5113495bSYour Name * a given center frequency
2857*5113495bSYour Name * @cfreq: Center frequency for which start and end freq need to be set
2858*5113495bSYour Name * @ch_width: Spectral scan Channel width
2859*5113495bSYour Name * @fragmentation_160: Target type has fragmentation or not
2860*5113495bSYour Name * @start_end_freq: Array containing start and end frequency of detector
2861*5113495bSYour Name *
2862*5113495bSYour Name * Set the start and end frequencies for given center frequency in destination
2863*5113495bSYour Name * detector info struct
2864*5113495bSYour Name *
2865*5113495bSYour Name * Return: void
2866*5113495bSYour Name */
2867*5113495bSYour Name static inline
target_if_spectral_set_start_end_freq(uint32_t cfreq,enum phy_ch_width ch_width,bool fragmentation_160,uint32_t * start_end_freq)2868*5113495bSYour Name void target_if_spectral_set_start_end_freq(uint32_t cfreq,
2869*5113495bSYour Name enum phy_ch_width ch_width,
2870*5113495bSYour Name bool fragmentation_160,
2871*5113495bSYour Name uint32_t *start_end_freq)
2872*5113495bSYour Name {
2873*5113495bSYour Name enum phy_ch_width det_ch_width;
2874*5113495bSYour Name
2875*5113495bSYour Name det_ch_width = target_if_get_detector_chwidth(ch_width,
2876*5113495bSYour Name fragmentation_160);
2877*5113495bSYour Name
2878*5113495bSYour Name start_end_freq[0] = cfreq - (wlan_reg_get_bw_value(det_ch_width) >> 1);
2879*5113495bSYour Name start_end_freq[1] = cfreq + (wlan_reg_get_bw_value(det_ch_width) >> 1);
2880*5113495bSYour Name }
2881*5113495bSYour Name #endif /* OPTIMIZED_SAMP_MESSAGE */
2882*5113495bSYour Name
2883*5113495bSYour Name #ifdef DIRECT_BUF_RX_ENABLE
2884*5113495bSYour Name /**
2885*5113495bSYour Name * target_if_consume_spectral_report_gen3() - Process fft report for gen3
2886*5113495bSYour Name * @spectral: Pointer to spectral object
2887*5113495bSYour Name * @report: Pointer to spectral report
2888*5113495bSYour Name *
2889*5113495bSYour Name * Process fft report for gen3
2890*5113495bSYour Name *
2891*5113495bSYour Name * Return: Success/Failure
2892*5113495bSYour Name */
2893*5113495bSYour Name int
2894*5113495bSYour Name target_if_consume_spectral_report_gen3(
2895*5113495bSYour Name struct target_if_spectral *spectral,
2896*5113495bSYour Name struct spectral_report *report);
2897*5113495bSYour Name #endif
2898*5113495bSYour Name
2899*5113495bSYour Name /**
2900*5113495bSYour Name * target_if_spectral_fw_hang() - Crash the FW from Spectral module
2901*5113495bSYour Name * @spectral: Pointer to Spectral LMAC object
2902*5113495bSYour Name *
2903*5113495bSYour Name * Return: QDF_STATUS of operation
2904*5113495bSYour Name */
2905*5113495bSYour Name QDF_STATUS target_if_spectral_fw_hang(struct target_if_spectral *spectral);
2906*5113495bSYour Name
2907*5113495bSYour Name /**
2908*5113495bSYour Name * target_if_spectral_finite_scan_update() - Update scan count for finite scan
2909*5113495bSYour Name * and stop Spectral scan when required
2910*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
2911*5113495bSYour Name * @smode: Spectral scan mode
2912*5113495bSYour Name *
2913*5113495bSYour Name * This API decrements the number of Spectral reports expected from target for
2914*5113495bSYour Name * a finite Spectral scan. When expected number of reports are received from
2915*5113495bSYour Name * target Spectral scan is stopped.
2916*5113495bSYour Name *
2917*5113495bSYour Name * Return: QDF_STATUS on success
2918*5113495bSYour Name */
2919*5113495bSYour Name QDF_STATUS
2920*5113495bSYour Name target_if_spectral_finite_scan_update(struct target_if_spectral *spectral,
2921*5113495bSYour Name enum spectral_scan_mode smode);
2922*5113495bSYour Name
2923*5113495bSYour Name /**
2924*5113495bSYour Name * target_if_spectral_is_finite_scan() - Check Spectral scan is finite/infinite
2925*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
2926*5113495bSYour Name * @smode: Spectral scan mode
2927*5113495bSYour Name * @finite_spectral_scan: location to store result
2928*5113495bSYour Name *
2929*5113495bSYour Name * API to check whether Spectral scan is finite/infinite for the give mode.
2930*5113495bSYour Name * A non zero scan count indicates that scan is finite. Scan count of 0
2931*5113495bSYour Name * indicates an infinite Spectral scan.
2932*5113495bSYour Name *
2933*5113495bSYour Name * Return: QDF_STATUS on success
2934*5113495bSYour Name */
2935*5113495bSYour Name QDF_STATUS
2936*5113495bSYour Name target_if_spectral_is_finite_scan(struct target_if_spectral *spectral,
2937*5113495bSYour Name enum spectral_scan_mode smode,
2938*5113495bSYour Name bool *finite_spectral_scan);
2939*5113495bSYour Name
2940*5113495bSYour Name #ifdef BIG_ENDIAN_HOST
2941*5113495bSYour Name /**
2942*5113495bSYour Name * target_if_byte_swap_spectral_headers_gen3() - Apply byte-swap on headers
2943*5113495bSYour Name * @spectral: Pointer to Spectral target_if internal private data
2944*5113495bSYour Name * @data: Pointer to the start of Spectral Scan Summary report
2945*5113495bSYour Name *
2946*5113495bSYour Name * This API is only required for Big-endian Host platforms.
2947*5113495bSYour Name * It applies 32-bit byte-swap on Spectral Scan Summary and Search FFT reports
2948*5113495bSYour Name * and copies them back to the source location.
2949*5113495bSYour Name * Padding bytes that lie between the reports won't be touched.
2950*5113495bSYour Name *
2951*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2952*5113495bSYour Name */
2953*5113495bSYour Name QDF_STATUS target_if_byte_swap_spectral_headers_gen3(
2954*5113495bSYour Name struct target_if_spectral *spectral,
2955*5113495bSYour Name void *data);
2956*5113495bSYour Name
2957*5113495bSYour Name /**
2958*5113495bSYour Name * target_if_byte_swap_spectral_fft_bins_gen3() - Apply byte-swap on FFT bins
2959*5113495bSYour Name * @rparams: Pointer to Spectral report parameters
2960*5113495bSYour Name * @bin_pwr_data: Pointer to the start of FFT bins
2961*5113495bSYour Name * @num_fftbins: Number of FFT bins
2962*5113495bSYour Name *
2963*5113495bSYour Name * This API is only required for Big-endian Host platforms.
2964*5113495bSYour Name * It applies pack-mode-aware byte-swap on the FFT bins as below:
2965*5113495bSYour Name * 1. pack-mode 0 (i.e., 1 FFT bin per DWORD):
2966*5113495bSYour Name * Reads the least significant 2 bytes of each DWORD, applies 16-bit
2967*5113495bSYour Name * byte-swap on that value, and copies it back to the source location.
2968*5113495bSYour Name * 2. pack-mode 1 (i.e., 2 FFT bins per DWORD):
2969*5113495bSYour Name * Reads each FFT bin, applies 16-bit byte-swap on that value,
2970*5113495bSYour Name * and copies it back to the source location.
2971*5113495bSYour Name * 3. pack-mode 2 (4 FFT bins per DWORD):
2972*5113495bSYour Name * Nothing
2973*5113495bSYour Name *
2974*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
2975*5113495bSYour Name */
2976*5113495bSYour Name QDF_STATUS target_if_byte_swap_spectral_fft_bins_gen3(
2977*5113495bSYour Name const struct spectral_report_params *rparams,
2978*5113495bSYour Name void *bin_pwr_data, size_t num_fftbins);
2979*5113495bSYour Name #endif /* BIG_ENDIAN_HOST */
2980*5113495bSYour Name
2981*5113495bSYour Name #ifdef OPTIMIZED_SAMP_MESSAGE
2982*5113495bSYour Name /**
2983*5113495bSYour Name * target_if_populate_fft_bins_info() - Populate the start and end bin
2984*5113495bSYour Name * indices, on per-detector level.
2985*5113495bSYour Name * @spectral: Pointer to target_if spectral internal structure
2986*5113495bSYour Name * @smode: Spectral scan mode
2987*5113495bSYour Name *
2988*5113495bSYour Name * Populate the start and end bin indices, on per-detector level.
2989*5113495bSYour Name *
2990*5113495bSYour Name * Return: Success/Failure
2991*5113495bSYour Name */
2992*5113495bSYour Name QDF_STATUS
2993*5113495bSYour Name target_if_populate_fft_bins_info(struct target_if_spectral *spectral,
2994*5113495bSYour Name enum spectral_scan_mode smode);
2995*5113495bSYour Name #else
2996*5113495bSYour Name static inline QDF_STATUS
target_if_populate_fft_bins_info(struct target_if_spectral * spectral,enum spectral_scan_mode smode)2997*5113495bSYour Name target_if_populate_fft_bins_info(struct target_if_spectral *spectral,
2998*5113495bSYour Name enum spectral_scan_mode smode)
2999*5113495bSYour Name {
3000*5113495bSYour Name return QDF_STATUS_SUCCESS;
3001*5113495bSYour Name }
3002*5113495bSYour Name #endif
3003*5113495bSYour Name
3004*5113495bSYour Name /**
3005*5113495bSYour Name * spectral_is_session_info_expected_from_target() - Check if spectral scan
3006*5113495bSYour Name * session is expected from target
3007*5113495bSYour Name * @pdev: pdev pointer
3008*5113495bSYour Name * @is_session_info_expected: Pointer to caller variable
3009*5113495bSYour Name *
3010*5113495bSYour Name * Return: QDF_STATUS of operation
3011*5113495bSYour Name */
3012*5113495bSYour Name QDF_STATUS
3013*5113495bSYour Name spectral_is_session_info_expected_from_target(struct wlan_objmgr_pdev *pdev,
3014*5113495bSYour Name bool *is_session_info_expected);
3015*5113495bSYour Name
3016*5113495bSYour Name #ifdef WIN32
3017*5113495bSYour Name #pragma pack(pop, target_if_spectral)
3018*5113495bSYour Name #endif
3019*5113495bSYour Name #ifdef __ATTRIB_PACK
3020*5113495bSYour Name #undef __ATTRIB_PACK
3021*5113495bSYour Name #endif
3022*5113495bSYour Name
3023*5113495bSYour Name /**
3024*5113495bSYour Name * target_if_spectral_copy_fft_bins() - Copy FFT bins from source buffer to
3025*5113495bSYour Name * destination buffer
3026*5113495bSYour Name * @spectral: Pointer to Spectral LMAC object
3027*5113495bSYour Name * @src_fft_buf: Pointer to source FFT buffer
3028*5113495bSYour Name * @dest_fft_buf: Pointer to destination FFT buffer
3029*5113495bSYour Name * @fft_bin_count: Number of FFT bins to copy
3030*5113495bSYour Name * @bytes_copied: Number of bytes copied by this API
3031*5113495bSYour Name * @pwr_format: Spectral FFT bin format (linear/dBm mode)
3032*5113495bSYour Name *
3033*5113495bSYour Name * Different targets supports different FFT bin widths. This API encapsulates
3034*5113495bSYour Name * all those details and copies 8-bit FFT value into the destination buffer.
3035*5113495bSYour Name * Also, this API takes care of handling big-endian mode.
3036*5113495bSYour Name * In essence, it does the following.
3037*5113495bSYour Name * - Read DWORDs one by one
3038*5113495bSYour Name * - Extract individual FFT bins out of it
3039*5113495bSYour Name * - Copy the FFT bin to destination buffer
3040*5113495bSYour Name *
3041*5113495bSYour Name * Return: QDF_STATUS_SUCCESS in case of success, else QDF_STATUS_E_FAILURE
3042*5113495bSYour Name */
3043*5113495bSYour Name QDF_STATUS
3044*5113495bSYour Name target_if_spectral_copy_fft_bins(struct target_if_spectral *spectral,
3045*5113495bSYour Name const void *src_fft_buf,
3046*5113495bSYour Name void *dest_fft_buf,
3047*5113495bSYour Name uint32_t fft_bin_count,
3048*5113495bSYour Name uint32_t *bytes_copied,
3049*5113495bSYour Name uint16_t pwr_format);
3050*5113495bSYour Name #endif /* WLAN_CONV_SPECTRAL_ENABLE */
3051*5113495bSYour Name
3052*5113495bSYour Name struct spectral_capabilities_event_params;
3053*5113495bSYour Name /**
3054*5113495bSYour Name * target_if_wmi_extract_spectral_caps_fixed_param() - Wrapper function to
3055*5113495bSYour Name * extract fixed params from Spectral capabilities WMI event
3056*5113495bSYour Name * @psoc: Pointer to psoc object
3057*5113495bSYour Name * @evt_buf: Event buffer
3058*5113495bSYour Name * @param: Spectral capabilities event parameters data structure to be filled
3059*5113495bSYour Name * by this API
3060*5113495bSYour Name *
3061*5113495bSYour Name * Return: QDF_STATUS of operation
3062*5113495bSYour Name */
3063*5113495bSYour Name QDF_STATUS target_if_wmi_extract_spectral_caps_fixed_param(
3064*5113495bSYour Name struct wlan_objmgr_psoc *psoc,
3065*5113495bSYour Name uint8_t *evt_buf,
3066*5113495bSYour Name struct spectral_capabilities_event_params *param);
3067*5113495bSYour Name
3068*5113495bSYour Name struct spectral_scan_bw_capabilities;
3069*5113495bSYour Name /**
3070*5113495bSYour Name * target_if_wmi_extract_spectral_scan_bw_caps() - Wrapper function to
3071*5113495bSYour Name * extract bandwidth capabilities from Spectral capabilities WMI event
3072*5113495bSYour Name * @psoc: Pointer to psoc object
3073*5113495bSYour Name * @evt_buf: Event buffer
3074*5113495bSYour Name * @bw_caps: Data structure to be filled by this API after extraction
3075*5113495bSYour Name *
3076*5113495bSYour Name * Return: QDF_STATUS of operation
3077*5113495bSYour Name */
3078*5113495bSYour Name QDF_STATUS
3079*5113495bSYour Name target_if_wmi_extract_spectral_scan_bw_caps(
3080*5113495bSYour Name struct wlan_objmgr_psoc *psoc,
3081*5113495bSYour Name uint8_t *evt_buf,
3082*5113495bSYour Name struct spectral_scan_bw_capabilities *bw_caps);
3083*5113495bSYour Name
3084*5113495bSYour Name struct spectral_fft_size_capabilities;
3085*5113495bSYour Name /**
3086*5113495bSYour Name * target_if_wmi_extract_spectral_fft_size_caps() - Wrapper function to
3087*5113495bSYour Name * extract fft size capabilities from Spectral capabilities WMI event
3088*5113495bSYour Name * @psoc: Pointer to psoc object
3089*5113495bSYour Name * @evt_buf: Event buffer
3090*5113495bSYour Name * @fft_size_caps: Data structure to be filled by this API after extraction
3091*5113495bSYour Name *
3092*5113495bSYour Name * Return: QDF_STATUS of operation
3093*5113495bSYour Name */
3094*5113495bSYour Name QDF_STATUS
3095*5113495bSYour Name target_if_wmi_extract_spectral_fft_size_caps(
3096*5113495bSYour Name struct wlan_objmgr_psoc *psoc,
3097*5113495bSYour Name uint8_t *evt_buf,
3098*5113495bSYour Name struct spectral_fft_size_capabilities *fft_size_caps);
3099*5113495bSYour Name #endif /* _TARGET_IF_SPECTRAL_H_ */
3100