samsung-sm8650/android_kernel_samsung_sm8650-modules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4f48adea1829c310187bee88c26b7d6e8e65b51a
android_kernel_samsung_sm86…/spectral/dispatcher/inc/spectral_ioctl.h
Edayilliam Jayadev 17ecd7493a qcacmn: Enable Spectral feature for Pine 
1) Enable DDMA support, FFT bin length adjustment SWARs
2) Skip 16 bytes of padding added after Spectral summary report.
3) FFT report header length is 24 instead of 16 in Pine.
4) Max FFT size is changed to 10.

CRs-Fixed: 2608215
Change-Id: If32a8995f814140f5b61041031fb842d01d24c94
2020-02-01 06:25:04 -08:00

481 lines
20 KiB
C
Raw Blame History

/*
* Copyright (c) 2011, 2017-2020 The Linux Foundation. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
* above copyright notice and this permission notice appear in all
* copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
* WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
* AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
* PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef _SPECTRAL_IOCTL_H_
#define _SPECTRAL_IOCTL_H_
#include <wlan_dfs_ioctl.h>
#ifndef AH_MAX_CHAINS
#define AH_MAX_CHAINS 3
#endif
/*
* ioctl defines
*/
#define SPECTRAL_SET_CONFIG (DFS_LAST_IOCTL + 1)
#define SPECTRAL_GET_CONFIG (DFS_LAST_IOCTL + 2)
#define SPECTRAL_SHOW_INTERFERENCE (DFS_LAST_IOCTL + 3)
#define SPECTRAL_ENABLE_SCAN (DFS_LAST_IOCTL + 4)
#define SPECTRAL_DISABLE_SCAN (DFS_LAST_IOCTL + 5)
#define SPECTRAL_ACTIVATE_SCAN (DFS_LAST_IOCTL + 6)
#define SPECTRAL_STOP_SCAN (DFS_LAST_IOCTL + 7)
#define SPECTRAL_SET_DEBUG_LEVEL (DFS_LAST_IOCTL + 8)
#define SPECTRAL_IS_ACTIVE (DFS_LAST_IOCTL + 9)
#define SPECTRAL_IS_ENABLED (DFS_LAST_IOCTL + 10)
#define SPECTRAL_CLASSIFY_SCAN (DFS_LAST_IOCTL + 11)
#define SPECTRAL_GET_CLASSIFIER_CONFIG (DFS_LAST_IOCTL + 12)
#define SPECTRAL_EACS (DFS_LAST_IOCTL + 13)
#define SPECTRAL_ACTIVATE_FULL_SCAN (DFS_LAST_IOCTL + 14)
#define SPECTRAL_STOP_FULL_SCAN (DFS_LAST_IOCTL + 15)
#define SPECTRAL_GET_CAPABILITY_INFO (DFS_LAST_IOCTL + 16)
#define SPECTRAL_GET_DIAG_STATS (DFS_LAST_IOCTL + 17)
#define SPECTRAL_GET_CHAN_WIDTH (DFS_LAST_IOCTL + 18)
#define SPECTRAL_GET_CHANINFO (DFS_LAST_IOCTL + 19)
#define SPECTRAL_CLEAR_CHANINFO (DFS_LAST_IOCTL + 20)
#define SPECTRAL_SET_ICM_ACTIVE (DFS_LAST_IOCTL + 21)
#define SPECTRAL_GET_NOMINAL_NOISEFLOOR (DFS_LAST_IOCTL + 22)
#define SPECTRAL_GET_DEBUG_LEVEL (DFS_LAST_IOCTL + 23)
#define SPECTRAL_SET_DMA_DEBUG (DFS_LAST_IOCTL + 24)
/*
* ioctl parameter types
*/
enum spectral_params {
SPECTRAL_PARAM_FFT_PERIOD,
SPECTRAL_PARAM_SCAN_PERIOD,
SPECTRAL_PARAM_SCAN_COUNT,
SPECTRAL_PARAM_SHORT_REPORT,
SPECTRAL_PARAM_SPECT_PRI,
SPECTRAL_PARAM_FFT_SIZE,
SPECTRAL_PARAM_GC_ENA,
SPECTRAL_PARAM_RESTART_ENA,
SPECTRAL_PARAM_NOISE_FLOOR_REF,
SPECTRAL_PARAM_INIT_DELAY,
SPECTRAL_PARAM_NB_TONE_THR,
SPECTRAL_PARAM_STR_BIN_THR,
SPECTRAL_PARAM_WB_RPT_MODE,
SPECTRAL_PARAM_RSSI_RPT_MODE,
SPECTRAL_PARAM_RSSI_THR,
SPECTRAL_PARAM_PWR_FORMAT,
SPECTRAL_PARAM_RPT_MODE,
SPECTRAL_PARAM_BIN_SCALE,
SPECTRAL_PARAM_DBM_ADJ,
SPECTRAL_PARAM_CHN_MASK,
SPECTRAL_PARAM_ACTIVE,
SPECTRAL_PARAM_STOP,
SPECTRAL_PARAM_ENABLE,
SPECTRAL_PARAM_FREQUENCY,
SPECTRAL_PARAM_CHAN_FREQUENCY,
SPECTRAL_PARAM_CHAN_WIDTH,
SPECTRAL_PARAM_MAX,
};
/**
* enum spectral_scan_mode - Spectral scan mode
* @SPECTRAL_SCAN_MODE_NORMAL: Normal mode
* @SPECTRAL_SCAN_MODE_AGILE: Agile mode
*/
enum spectral_scan_mode {
SPECTRAL_SCAN_MODE_NORMAL,
SPECTRAL_SCAN_MODE_AGILE,
SPECTRAL_SCAN_MODE_MAX,
};
struct spectral_ioctl_params {
int16_t spectral_fft_period;
int16_t pectral_period;
int16_t spectral_count;
uint16_t spectral_short_report;
uint16_t spectral_pri;
};
/**
* spectral_cap_hw_gen: Definitions for the Spectral hardware generation.
* This corresponds to definitions in qca_wlan_vendor_spectral_scan_cap_hw_gen.
* @SPECTRAL_CAP_HW_GEN_1: Generation 1
* @SPECTRAL_CAP_HW_GEN_2: Generation 2
* @SPECTRAL_CAP_HW_GEN_3: Generation 3
*/
enum spectral_cap_hw_gen {
SPECTRAL_CAP_HW_GEN_1 = 0,
SPECTRAL_CAP_HW_GEN_2 = 1,
SPECTRAL_CAP_HW_GEN_3 = 2,
};
/**
* struct spectral_config - spectral config parameters
* @ss_fft_period: Skip interval for FFT reports
* @ss_period: Spectral scan period
* @ss_count: # of reports to return from ss_active
* @ss_short_report: Set to report only 1 set of FFT results
* @radar_bin_thresh_sel: Select threshold to classify strong bin for FFT
* @ss_spectral_pri: Priority, and are we doing a noise power cal ?
* @ss_fft_size: Defines the number of FFT data points to compute,
* defined as a log index num_fft_pts =
* 2^ss_fft_size
* @ss_gc_ena: Set, to enable targeted gain change before
* starting the spectral scan FFT
* @ss_restart_ena: Set, to enable abort of receive frames when in high
* priority and a spectral scan is queued
* @ss_noise_floor_ref: Noise floor reference number (signed) for the
* calculation of bin power (dBm) Though stored as an
* unsigned this should be treated as a signed 8-bit int.
* @ss_init_delay: Disallow spectral scan triggers after tx/rx packets
* by setting this delay value to roughly SIFS time
* period or greater Delay timer count in units of 0.25us
* @ss_nb_tone_thr: Number of strong bins (inclusive) per sub-channel,
* below which a signal is declared a narrowband tone
* @ss_str_bin_thr: Bin/max_bin ratio threshold over which a bin is
* declared strong (for spectral scan bandwidth analysis)
* @ss_wb_rpt_mode: Set this bit to report spectral scans as EXT_BLOCKER
* (phy_error=36), if none of the sub-channels are
* deemed narrowband
* @ss_rssi_rpt_mode: Set this bit to report spectral scans as EXT_BLOCKER
* (phy_error=36), if the ADC RSSI is below the
* threshold ss_rssi_thr
* @ss_rssi_thr: ADC RSSI must be greater than or equal to this
* threshold (signed Db) to ensure spectral scan
* reporting with normal phy error codes (please see
* ss_rssi_rpt_mode above).Though stored as an unsigned
* value, this should be treated as a signed 8-bit int
* @ss_pwr_format: Format of frequency bin magnitude for spectral scan
* triggered FFTs 0: linear magnitude
* 1: log magnitude (20*log10(lin_mag), 1/2 dB step size)
* @ss_rpt_mode: Format of per-FFT reports to software for spectral
* scan triggered FFTs
* 0: No FFT report (only pulse end summary)
* 1: 2-dword summary of metrics for each completed FFT
* 2: 2-dword summary + 1x-oversampled bins(in-band) per
* FFT
* 3: 2-dword summary + 2x-oversampled bins (all) per FFT
* @ss_bin_scale: Number of LSBs to shift out to scale the FFT bins
* for spectral scan triggered FFTs
* @ss_dbm_adj: Set (with ss_pwr_format=1), to report bin
* magnitudes
* converted to dBm power using the noisefloor
* calibration results
* @ss_chn_mask: Per chain enable mask to select input ADC for search
* FFT
* @ss_nf_cal: nf calibrated values for ctl+ext
* @ss_nf_pwr: nf pwr values for ctl+ext
* @ss_nf_temp_data: temperature data taken during nf scan
* @ss_frequency: This specifies the frequency span over which Spectral
* scan would be carried out. Its value depends on the
* Spectral scan mode.
* Normal mode:-
* Not applicable. Spectral scan would happen in the
* operating span.
* Agile mode:-
* Center frequency (in MHz) of the interested span
* or center frequency (in MHz) of any WLAN channel
* in the interested span.
*/
struct spectral_config {
uint16_t ss_fft_period;
uint16_t ss_period;
uint16_t ss_count;
uint16_t ss_short_report;
uint8_t radar_bin_thresh_sel;
uint16_t ss_spectral_pri;
uint16_t ss_fft_size;
uint16_t ss_gc_ena;
uint16_t ss_restart_ena;
uint16_t ss_noise_floor_ref;
uint16_t ss_init_delay;
uint16_t ss_nb_tone_thr;
uint16_t ss_str_bin_thr;
uint16_t ss_wb_rpt_mode;
uint16_t ss_rssi_rpt_mode;
uint16_t ss_rssi_thr;
uint16_t ss_pwr_format;
uint16_t ss_rpt_mode;
uint16_t ss_bin_scale;
uint16_t ss_dbm_adj;
uint16_t ss_chn_mask;
int8_t ss_nf_cal[AH_MAX_CHAINS * 2];
int8_t ss_nf_pwr[AH_MAX_CHAINS * 2];
int32_t ss_nf_temp_data;
uint32_t ss_frequency;
};
/**
* struct spectral_caps - Spectral capabilities structure
* @phydiag_cap: Phydiag capability
* @radar_cap: Radar detection capability
* @spectral_cap: Spectral capability
* @advncd_spectral_cap: Advanced spectral capability
* @hw_gen: Spectral hw generation as defined in spectral_cap_hw_gen
* @is_scaling_params_populated: indicates whether scaling params is populated
* @formula_id: formula_id
* @low_level_offset: low_level_offset
* @high_level_offset: high_level_offset
* @rssi_thr: rssi_thr
* @default_agc_max_gain: default_agc_max_gain
* @agile_spectral_cap: agile Spectral capability for 20/40/80
* @agile_spectral_cap_160: agile Spectral capability for 160 MHz
* @agile_spectral_cap_80p80: agile Spectral capability for 80p80
*/
struct spectral_caps {
uint8_t phydiag_cap;
uint8_t radar_cap;
uint8_t spectral_cap;
uint8_t advncd_spectral_cap;
uint32_t hw_gen;
bool is_scaling_params_populated;
uint16_t formula_id;
int16_t low_level_offset;
int16_t high_level_offset;
int16_t rssi_thr;
uint8_t default_agc_max_gain;
bool agile_spectral_cap;
bool agile_spectral_cap_160;
bool agile_spectral_cap_80p80;
};
#define SPECTRAL_IOCTL_PARAM_NOVAL (65535)
#define MAX_SPECTRAL_CHAINS (3)
#define MAX_NUM_BINS (1024)
#define MAX_NUM_BINS_PRI80 (1024)
#define MAX_NUM_BINS_SEC80 (520)
/* 5 categories x (lower + upper) bands */
#define MAX_INTERF 10
/**
* enum dcs_int_type - Interference type indicated by DCS
* @SPECTRAL_DCS_INT_NONE: No interference
* @SPECTRAL_DCS_INT_CW: CW interference
* @SPECTRAL_DCS_INT_WIFI: WLAN interference
*/
enum dcs_int_type {
SPECTRAL_DCS_INT_NONE,
SPECTRAL_DCS_INT_CW,
SPECTRAL_DCS_INT_WIFI
};
/**
* struct interf_rsp - Interference record
* @interf_type: eINTERF_TYPE giving type of interference
* @interf_min_freq: Minimum frequency in MHz at which interference has been
* found
* @interf_max_freq: Maximum frequency in MHz at which interference has been
* found
* @advncd_spectral_cap: Advanced spectral capability
*/
struct interf_rsp {
uint8_t interf_type;
uint16_t interf_min_freq;
uint16_t interf_max_freq;
} __packed;
/**
* struct interf_src_rsp - List of interference sources
* @count: Number of interference records
* @interf: Array of interference records
*/
struct interf_src_rsp {
uint16_t count;
struct interf_rsp interf[MAX_INTERF];
} __packed;
/**
* struct spectral_classifier_params - spectral classifier parameters
* @spectral_20_40_mode: Is AP in 20/40 mode?
* @spectral_dc_index: DC index
* @spectral_dc_in_mhz: DC in MHz
* @upper_chan_in_mhz: Upper channel in MHz
* @lower_chan_in_mhz: Lower channel in MHz
*/
struct spectral_classifier_params {
int spectral_20_40_mode;
int spectral_dc_index;
int spectral_dc_in_mhz;
int upper_chan_in_mhz;
int lower_chan_in_mhz;
} __packed;
/**
* struct spectral_samp_data - Spectral Analysis Messaging Protocol Data format
* @spectral_data_len: Indicates the bin size
* @spectral_data_len_sec80: Indicates the bin size for secondary 80 segment
* @spectral_rssi: Indicates RSSI
* @spectral_rssi_sec80: Indicates RSSI for secondary 80 segment
* @spectral_combined_rssi: Indicates combined RSSI from all antennas
* @spectral_upper_rssi: Indicates RSSI of upper band
* @spectral_lower_rssi: Indicates RSSI of lower band
* @spectral_chain_ctl_rssi: RSSI for control channel, for all antennas
* @spectral_chain_ext_rssi: RSSI for extension channel, for all antennas
* @spectral_max_scale: Indicates scale factor
* @spectral_bwinfo: Indicates bandwidth info
* @spectral_tstamp: Indicates timestamp
* @spectral_max_index: Indicates the index of max magnitude
* @spectral_max_index_sec80: Indicates the index of max magnitude for secondary
* 80 segment
* @spectral_max_mag: Indicates the maximum magnitude
* @spectral_max_mag_sec80: Indicates the maximum magnitude for secondary 80
* segment
* @spectral_max_exp: Indicates the max exp
* @spectral_last_tstamp: Indicates the last time stamp
* @spectral_upper_max_index: Indicates the index of max mag in upper band
* @spectral_lower_max_index: Indicates the index of max mag in lower band
* @spectral_nb_upper: Not Used
* @spectral_nb_lower: Not Used
* @classifier_params: Indicates classifier parameters
* @bin_pwr_count: Indicates the number of FFT bins
* @lb_edge_extrabins: Number of extra bins on left band edge
* @rb_edge_extrabins: Number of extra bins on right band edge
* @bin_pwr_count_sec80: Indicates the number of FFT bins in secondary 80
* segment
* @bin_pwr: Contains FFT magnitudes
* @bin_pwr_sec80: Contains FFT magnitudes for the secondary 80
* segment
* @interf_list: List of interfernce sources
* @noise_floor: Indicates the current noise floor
* @noise_floor_sec80: Indicates the current noise floor for secondary 80
* segment
* @ch_width: Channel width 20/40/80/160 MHz
* @spectral_mode: Spectral scan mode
* @spectral_pri80ind: Indication from hardware that the sample was
* received on the primary 80 MHz segment. If this
* is set when smode = SPECTRAL_SCAN_MODE_AGILE, it
* indicates that Spectral was carried out on pri80
* instead of the Agile frequency due to a
* channel switch - Software may choose
* to ignore the sample in this case.
* @spectral_pri80ind_sec80: Indication from hardware that the sample was
* received on the primary 80 MHz segment instead of
* the secondary 80 MHz segment due to a channel
* switch - Software may choose to ignore the sample
* if this is set. Applicable only if smode =
* SPECTRAL_SCAN_MODE_NORMAL and for 160/80+80 MHz
* Spectral operation.
* @last_raw_timestamp: Previous FFT report's raw timestamp. In case of
* 160Mhz it will be primary 80 segment's timestamp
* as both primary & secondary segment's timestamp
* are expected to be almost equal.
* @timestamp_war_offset: Offset calculated based on reset_delay and
* last_raw_timestamp. It will be added to
* raw_timestamp to get spectral_tstamp.
* @raw_timestamp: Actual FFT timestamp reported by HW on primary
* segment.
* @raw_timestamp_sec80: Actual FFT timestamp reported by HW on sec80 MHz
* segment.
* @reset_delay: Time gap between the last spectral report before
* reset and the end of reset. It is provided by FW
* via direct DMA framework.
* @target_reset_count: Indicates the number of times target went through
* reset routine after spectral was enabled.
*/
struct spectral_samp_data {
int16_t spectral_data_len;
int16_t spectral_data_len_sec80;
int16_t spectral_rssi;
int16_t spectral_rssi_sec80;
int8_t spectral_combined_rssi;
int8_t spectral_upper_rssi;
int8_t spectral_lower_rssi;
int8_t spectral_chain_ctl_rssi[MAX_SPECTRAL_CHAINS];
int8_t spectral_chain_ext_rssi[MAX_SPECTRAL_CHAINS];
uint8_t spectral_max_scale;
int16_t spectral_bwinfo;
int32_t spectral_tstamp;
int16_t spectral_max_index;
int16_t spectral_max_index_sec80;
int16_t spectral_max_mag;
int16_t spectral_max_mag_sec80;
uint8_t spectral_max_exp;
int32_t spectral_last_tstamp;
int16_t spectral_upper_max_index;
int16_t spectral_lower_max_index;
uint8_t spectral_nb_upper;
uint8_t spectral_nb_lower;
struct spectral_classifier_params classifier_params;
uint16_t bin_pwr_count;
/*
* For 11ac chipsets prior to AR900B version 2.0, a max of 512 bins are
* delivered. However, there can be additional bins reported for
* AR900B version 2.0 and QCA9984 as described next:
*
* AR900B version 2.0: An additional tone is processed on the right
* hand side in order to facilitate detection of radar pulses out to
* the extreme band-edge of the channel frequency.
* Since the HW design processes four tones at a time,
* this requires one additional Dword to be added to the
* search FFT report.
*
* QCA9984: When spectral_scan_rpt_mode=2, i.e 2-dword summary +
* 1x-oversampled bins (in-band) per FFT,
* then 8 more bins (4 more on left side and 4 more on right side)
* are added.
*/
uint8_t lb_edge_extrabins;
uint8_t rb_edge_extrabins;
uint16_t bin_pwr_count_sec80;
uint8_t bin_pwr[MAX_NUM_BINS_PRI80];
uint8_t bin_pwr_sec80[MAX_NUM_BINS_SEC80];
struct interf_src_rsp interf_list;
int16_t noise_floor;
int16_t noise_floor_sec80;
uint32_t ch_width;
uint8_t spectral_agc_total_gain;
uint8_t spectral_agc_total_gain_sec80;
uint8_t spectral_gainchange;
uint8_t spectral_gainchange_sec80;
enum spectral_scan_mode spectral_mode;
uint8_t spectral_pri80ind;
uint8_t spectral_pri80ind_sec80;
uint32_t last_raw_timestamp;
uint32_t timestamp_war_offset;
uint32_t raw_timestamp;
uint32_t raw_timestamp_sec80;
uint32_t reset_delay;
uint32_t target_reset_count;
uint32_t agile_ch_width;
} __packed;
/**
* struct spectral_samp_msg - Spectral SAMP message
* @signature: Validates the SAMP message
* @freq: Operating frequency in MHz
* @vhtop_ch_freq_seg1: VHT Segment 1 centre frequency in MHz
* @vhtop_ch_freq_seg2: VHT Segment 2 centre frequency in MHz
* @agile_freq: Center frequency in MHz of the entire span across which
* Agile Spectral is carried out. Applicable only for Agile
* Spectral samples.
* @freq_loading: How busy was the channel
* @dcs_enabled: Whether DCS is enabled
* @int_type: Interference type indicated by DCS
* @macaddr: Indicates the device interface
* @samp_data: SAMP Data
*/
struct spectral_samp_msg {
uint32_t signature;
uint16_t freq;
uint16_t vhtop_ch_freq_seg1;
uint16_t vhtop_ch_freq_seg2;
uint16_t agile_freq;
uint16_t freq_loading;
uint16_t dcs_enabled;
enum dcs_int_type int_type;
uint8_t macaddr[6];
struct spectral_samp_data samp_data;
} __packed;
#endif
Reference in New Issue View Git Blame Copy Permalink