2 * Copyright (c) 2013 Qualcomm Atheros, Inc.
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 #include "../spectral_common.h"
22 /* enum spectral_mode:
24 * @SPECTRAL_DISABLED: spectral mode is disabled
25 * @SPECTRAL_BACKGROUND: hardware sends samples when it is not busy with
27 * @SPECTRAL_MANUAL: spectral scan is enabled, triggering for samples
28 * is performed manually.
29 * @SPECTRAL_CHANSCAN: Like manual, but also triggered when changing channels
30 * during a channel scan.
33 SPECTRAL_DISABLED = 0,
39 #define SPECTRAL_SCAN_BITMASK 0x10
40 /* Radar info packet format, used for DFS and spectral formats. */
41 struct ath_radar_info {
47 /* The HT20 spectral data has 4 bytes of additional information at it's end.
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)
54 struct ath_ht20_mag_info {
59 /* WARNING: don't actually use this struct! MAC may vary the amount of
60 * data by -1/+2. This struct is for reference only.
62 struct 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;
68 #define SPECTRAL_HT20_TOTAL_DATA_LEN (sizeof(struct ath_ht20_fft_packet))
70 /* Dynamic 20/40 mode:
72 * [7:0]: lower bins {max_magnitude[1:0], bitmap_weight[5:0]}
73 * [7:0]: lower bins max_magnitude[9:2]
74 * [7:0]: lower bins {max_index[5:0], max_magnitude[11:10]}
75 * [7:0]: upper bins {max_magnitude[1:0], bitmap_weight[5:0]}
76 * [7:0]: upper bins max_magnitude[9:2]
77 * [7:0]: upper bins {max_index[5:0], max_magnitude[11:10]}
78 * [3:0]: max_exp (shift amount to size max bin to 8-bit unsigned)
80 struct ath_ht20_40_mag_info {
86 /* WARNING: don't actually use this struct! MAC may vary the amount of
87 * data. This struct is for reference only.
89 struct ath_ht20_40_fft_packet {
90 u8 data[SPECTRAL_HT20_40_NUM_BINS];
91 struct ath_ht20_40_mag_info mag_info;
92 struct ath_radar_info radar_info;
95 struct ath_spec_scan_priv {
97 /* relay(fs) channel for spectral scan */
98 struct rchan *rfs_chan_spec_scan;
99 enum spectral_mode spectral_mode;
100 struct ath_spec_scan spec_config;
103 #define SPECTRAL_HT20_40_TOTAL_DATA_LEN (sizeof(struct ath_ht20_40_fft_packet))
105 /* grabs the max magnitude from the all/upper/lower bins */
106 static inline u16 spectral_max_magnitude(u8 *bins)
108 return (bins[0] & 0xc0) >> 6 |
109 (bins[1] & 0xff) << 2 |
110 (bins[2] & 0x03) << 10;
113 /* return the max magnitude from the all/upper/lower bins */
114 static inline u8 spectral_max_index(u8 *bins)
116 s8 m = (bins[2] & 0xfc) >> 2;
118 /* TODO: this still doesn't always report the right values ... */
127 /* return the bitmap weight from the all/upper/lower bins */
128 static inline u8 spectral_bitmap_weight(u8 *bins)
130 return bins[0] & 0x3f;
133 void ath9k_cmn_spectral_init_debug(struct ath_spec_scan_priv *spec_priv, struct dentry *debugfs_phy);
134 void ath9k_cmn_spectral_deinit_debug(struct ath_spec_scan_priv *spec_priv);
136 void ath9k_cmn_spectral_scan_trigger(struct ath_common *common,
137 struct ath_spec_scan_priv *spec_priv);
138 int ath9k_cmn_spectral_scan_config(struct ath_common *common,
139 struct ath_spec_scan_priv *spec_priv,
140 enum spectral_mode spectral_mode);
141 int ath_cmn_process_fft(struct ath_spec_scan_priv *spec_priv, struct ieee80211_hdr *hdr,
142 struct ath_rx_status *rs, u64 tsf);
144 #endif /* SPECTRAL_H */