206 lines · c
1/*2 * Copyright (c) 2013 Qualcomm Atheros, Inc.3 *4 * Permission to use, copy, modify, and/or distribute this software for any5 * purpose with or without fee is hereby granted, provided that the above6 * copyright notice and this permission notice appear in all copies.7 *8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.15 */16 17#ifndef SPECTRAL_H18#define SPECTRAL_H19 20#include "../spectral_common.h"21 22/* enum spectral_mode:23 *24 * @SPECTRAL_DISABLED: spectral mode is disabled25 * @SPECTRAL_BACKGROUND: hardware sends samples when it is not busy with26 * something else.27 * @SPECTRAL_MANUAL: spectral scan is enabled, triggering for samples28 * is performed manually.29 * @SPECTRAL_CHANSCAN: Like manual, but also triggered when changing channels30 * during a channel scan.31 */32enum spectral_mode {33 SPECTRAL_DISABLED = 0,34 SPECTRAL_BACKGROUND,35 SPECTRAL_MANUAL,36 SPECTRAL_CHANSCAN,37};38 39#define SPECTRAL_SCAN_BITMASK 0x1040/* Radar info packet format, used for DFS and spectral formats. */41struct ath_radar_info {42 u8 pulse_length_pri;43 u8 pulse_length_ext;44 u8 pulse_bw_info;45} __packed;46 47/* The HT20 spectral data has 4 bytes of additional information at it's end.48 *49 * [7:0]: all bins {max_magnitude[1:0], bitmap_weight[5:0]}50 * [7:0]: all bins max_magnitude[9:2]51 * [7:0]: all bins {max_index[5:0], max_magnitude[11:10]}52 * [3:0]: max_exp (shift amount to size max bin to 8-bit unsigned)53 */54struct ath_ht20_mag_info {55 u8 all_bins[3];56 u8 max_exp;57} __packed;58 59/* WARNING: don't actually use this struct! MAC may vary the amount of60 * data by -1/+2. This struct is for reference only.61 */62struct ath_ht20_fft_packet {63 u8 data[SPECTRAL_HT20_NUM_BINS];64 struct ath_ht20_mag_info mag_info;65 struct ath_radar_info radar_info;66} __packed;67 68#define SPECTRAL_HT20_TOTAL_DATA_LEN (sizeof(struct ath_ht20_fft_packet))69#define SPECTRAL_HT20_SAMPLE_LEN (sizeof(struct ath_ht20_mag_info) +\70 SPECTRAL_HT20_NUM_BINS)71 72/* Dynamic 20/40 mode:73 *74 * [7:0]: lower bins {max_magnitude[1:0], bitmap_weight[5:0]}75 * [7:0]: lower bins max_magnitude[9:2]76 * [7:0]: lower bins {max_index[5:0], max_magnitude[11:10]}77 * [7:0]: upper bins {max_magnitude[1:0], bitmap_weight[5:0]}78 * [7:0]: upper bins max_magnitude[9:2]79 * [7:0]: upper bins {max_index[5:0], max_magnitude[11:10]}80 * [3:0]: max_exp (shift amount to size max bin to 8-bit unsigned)81 */82struct ath_ht20_40_mag_info {83 u8 lower_bins[3];84 u8 upper_bins[3];85 u8 max_exp;86} __packed;87 88/* WARNING: don't actually use this struct! MAC may vary the amount of89 * data. This struct is for reference only.90 */91struct ath_ht20_40_fft_packet {92 u8 data[SPECTRAL_HT20_40_NUM_BINS];93 struct ath_ht20_40_mag_info mag_info;94 struct ath_radar_info radar_info;95} __packed;96 97struct ath_spec_scan_priv {98 struct ath_hw *ah;99 /* relay(fs) channel for spectral scan */100 struct rchan *rfs_chan_spec_scan;101 enum spectral_mode spectral_mode;102 struct ath_spec_scan spec_config;103};104 105#define SPECTRAL_HT20_40_TOTAL_DATA_LEN (sizeof(struct ath_ht20_40_fft_packet))106#define SPECTRAL_HT20_40_SAMPLE_LEN (sizeof(struct ath_ht20_40_mag_info) +\107 SPECTRAL_HT20_40_NUM_BINS)108 109#define SPECTRAL_SAMPLE_MAX_LEN SPECTRAL_HT20_40_SAMPLE_LEN110 111/* grabs the max magnitude from the all/upper/lower bins */112static inline u16 spectral_max_magnitude(u8 *bins)113{114 return (bins[0] & 0xc0) >> 6 |115 (bins[1] & 0xff) << 2 |116 (bins[2] & 0x03) << 10;117}118 119/* return the max magnitude from the all/upper/lower bins */120static inline u8 spectral_max_index(u8 *bins, int num_bins)121{122 s8 m = (bins[2] & 0xfc) >> 2;123 u8 zero_idx = num_bins / 2;124 125 /* It's a 5 bit signed int, remove its sign and use one's126 * complement interpretation to add the sign back to the 8127 * bit int128 */129 if (m & 0x20) {130 m &= ~0x20;131 m |= 0xe0;132 }133 134 /* Bring the zero point to the beginning135 * instead of the middle so that we can use136 * it for array lookup and that we don't deal137 * with negative values later138 */139 m += zero_idx;140 141 /* Sanity check to make sure index is within bounds */142 if (m < 0 || m > num_bins - 1)143 m = 0;144 145 return m;146}147 148static inline u8 spectral_max_index_ht40(u8 *bins)149{150 u8 idx;151 152 idx = spectral_max_index(bins, SPECTRAL_HT20_40_NUM_BINS);153 154 /* positive values and zero are starting at the beginning155 * of the data field.156 */157 return idx % (SPECTRAL_HT20_40_NUM_BINS / 2);158}159 160static inline u8 spectral_max_index_ht20(u8 *bins)161{162 return spectral_max_index(bins, SPECTRAL_HT20_NUM_BINS);163}164 165/* return the bitmap weight from the all/upper/lower bins */166static inline u8 spectral_bitmap_weight(u8 *bins)167{168 return bins[0] & 0x3f;169}170 171#ifdef CONFIG_ATH9K_COMMON_SPECTRAL172void ath9k_cmn_spectral_init_debug(struct ath_spec_scan_priv *spec_priv, struct dentry *debugfs_phy);173void ath9k_cmn_spectral_deinit_debug(struct ath_spec_scan_priv *spec_priv);174 175void ath9k_cmn_spectral_scan_trigger(struct ath_common *common,176 struct ath_spec_scan_priv *spec_priv);177int ath9k_cmn_spectral_scan_config(struct ath_common *common,178 struct ath_spec_scan_priv *spec_priv,179 enum spectral_mode spectral_mode);180int ath_cmn_process_fft(struct ath_spec_scan_priv *spec_priv, struct ieee80211_hdr *hdr,181 struct ath_rx_status *rs, u64 tsf);182#else183static inline void ath9k_cmn_spectral_init_debug(struct ath_spec_scan_priv *spec_priv,184 struct dentry *debugfs_phy)185{186}187 188static inline void ath9k_cmn_spectral_deinit_debug(struct ath_spec_scan_priv *spec_priv)189{190}191 192static inline void ath9k_cmn_spectral_scan_trigger(struct ath_common *common,193 struct ath_spec_scan_priv *spec_priv)194{195}196 197static inline int ath_cmn_process_fft(struct ath_spec_scan_priv *spec_priv,198 struct ieee80211_hdr *hdr,199 struct ath_rx_status *rs, u64 tsf)200{201 return 0;202}203#endif /* CONFIG_ATH9K_COMMON_SPECTRAL */204 205#endif /* SPECTRAL_H */206