mirrors/madwifi
1
0
Fork 0
mirror of https://github.com/proski/madwifi synced 2024-11-22 14:31:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
4a596a2c5b
madwifi/ath/if_ath_radar.h
proski 02bac30645 More typo fixes 
git-svn-id: http://madwifi-project.org/svn/madwifi/trunk@3809 0192ed92-7a03-0410-a25b-9323aeb14dbd
2008-07-18 22:00:42 +00:00

192 lines
7.8 KiB
C
Raw Blame History

/*
* This software is distributed under the terms of the
* GNU General Public License ("GPL") version 2 as published by the Free
* Software Foundation.
*
* NO WARRANTY
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
* THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
* THE POSSIBILITY OF SUCH DAMAGES.
*
* $Id: if_ath_radar.h 2464 2007-06-15 22:51:56Z mtaylor $
*/
/*
* Definitions for the Atheros Wireless LAN controller driver.
*/
#ifndef _IF_ATH_RADAR_H
#define _IF_ATH_RADAR_H
/* AR5K_AR5212_PHY_ERR_FIL register definition taken from openhal */
#define AR5K_AR5212_PHY_ERR_FIL 0x810c
#define AR5K_AR5212_PHY_ERR_FIL_RADAR 0x00000020
/* AR5K_PHY_RADAR register definition reverse engineered with
* ATH_REVERSE_ENGINEERING. */
/* PHY radar detection register [5111+] */
#define AR5K_PHY_RADAR 0x9954
/* Radar enable ........ ........ ........ .......1 */
#define AR5K_PHY_RADAR_ENABLE 0x00000001
#define AR5K_PHY_RADAR_ENABLE_S 0
/* This is the value found on the card .1.111.1 .1.1.... 111....1 1...1...
at power on. */
#define AR5K_PHY_RADAR_PWONDEF_AR5213 0x5d50e188
/* This is the value found on the card .1.1.111 ..11...1 .1...1.1 1...11.1
after DFS is enabled */
#define AR5K_PHY_RADAR_ENABLED_AR5213 0x5731458d
/* Finite Impulse Response (FIR) filter .1111111 ........ ........ ........
* power out threshold.
* 7-bits signed integer, standard power range {-63..63} in 1 dBm units. */
#define AR5K_PHY_RADAR_FIRPWROUTTHR 0x7f000000
#define AR5K_PHY_RADAR_FIRPWROUTTHR_S 24
/* Radar RSSI/SNR threshold. ........ 111111.. ........ ........
* 6-bits unsigned integer, 1 dBm, range {0..63} in dBm units. */
#define AR5K_PHY_RADAR_RADARRSSITHR 0x00fc0000
#define AR5K_PHY_RADAR_RADARRSSITHR_S 18
/* Pulse height threshold ........ ......11 1111.... ........
* 6-bits unsigned integer, 1 dBm, range {0..63} in dBm units. */
#define AR5K_PHY_RADAR_PULSEHEIGHTTHR 0x0003f000
#define AR5K_PHY_RADAR_PULSEHEIGHTTHR_S 12
/* Pulse RSSI/SNR threshold ........ ........ ....1111 11......
* 6-bits unsigned integer, 1 dBm, range {0..63} in dBm units. */
#define AR5K_PHY_RADAR_PULSERSSITHR 0x00000fc0
#define AR5K_PHY_RADAR_PULSERSSITHR_S 6
/* Inband threshold ........ ........ ........ ..11111.
* 5-bits unsigned integer, 1/2 dBm, range {0..31} in 0.5 dBm units */
#define AR5K_PHY_RADAR_INBANDTHR 0x0000003e
#define AR5K_PHY_RADAR_INBANDTHR_S 1
/* This struct defines the supported PHY error detection parameters for radar
* pulse detection logic. Reference US patent US6891496 B2 for pseudocode for
* the chips' operations and pseudocode for how the parameters are used. */
typedef struct {
/* Finite Impulse Response (FIR) filter - power out threshold.
*
* If a signal is received with a pulse width that is too short,
* the AR chip cannot fine-adjust gain fast enough to get an accurate
* reading of RSSI. If this signal has an power value after filtering
* that exceeds a fixed threshold (rp_fir_filter_output_power_thr)
* and then drops by rp_pulse_height_thr then it may be considered a
* radar pulse.
*
* Reference: 405 in Figure 4A of US patent US6891496 B2.
* Default: Default value is -41dBm.
* Units: Signed integer, value in dBm {-63..63} in 1 dBm units. */
int32_t rp_fir_filter_output_power_thr;
/* Pulse height threshold
* This is delta between the max and min RSSI for short pulse radar
* bursts where AGC cannot be adjusted enough times to get an accurate
* sizing of the pulse.
*
* If a signal is received with a pulse width that is too short,
* the AR chip cannot fine-adjust gain fast enough to get an accurate
* reading of RSSI. If this signal has an power value after filtering
* that exceeds a fixed threshold (rp_fir_filter_output_power_thr)
* and then drops by rp_pulse_height_thr then it may be considered a
* radar pulse.
*
* Refernece: See Figure 4A.
* Default: value is 20 dBm.
* Units: Unsigned 6-bits, dBm range {0..63} in dBm units. */
int32_t rp_pulse_height_thr;
/* Radar RSSI/SNR threshold.
*
* This is the threshold that RSSI must exceed for the pulse when AGC
* is ok and we actually know the power of the signal (not the chip)
* and reach an initial peak greater than this threshold.
*
* For pulses long enough for AGC to be used to detect
* pulse width (approximately >3us), we will start counting the pulse
* width if it reaches this level as this may be the rise of a radar
* pulse.
*
* Reference: See 450 on Figure 4B in US patent US6891496 B2.
* Default: value is 12, or 6 dBm.
* Units: 6-bits, dBm range {0..63} in dBm units. */
int32_t rp_radar_rssi_thr;
/* Pulse RSSI/SNR threshold
*
* This is how much the RSSI of the pulse must drop, relative to
* rp_radar_rssi_thr before we will stop counting the pulse width.
*
* If we see a pulse reach rp_radar_rssi_thr we start thinking it might
* be radar, but if it subsequently reached
* (rp_radar_rssi_thr - rp_pulse_height_thr) and it wasn't part of a
* WLAN signal, then we would know it was radar.
*
* In other words, we are looking for a 6dBm drop in gain that happens
* after a pulse on the down swing as shown in figure 4A and 4B.
*
* Default: 22, or 11 dBm.
* Units: Unsigned 6-bits, dBm range {0..63} in dBm units. */
int32_t rp_pulse_rssi_thr;
/* Inband threshold.
* Units: Unsigned 5-bits, dBm range {0..31} in half dBm units. */
int32_t rp_inband_thr;
} RADAR_PARAM;
/* Any value in RADAR_PARAM can be set to this magic value in order to use
the default for that field */
#define RADAR_PARAM_USE_DEFAULT 0xffff
/* This is called on channel change to enable radar detection for 5211+ chips.
* NOTE: AR5210 doesn't have radar pulse detection support. */
int ath_radar_update(struct ath_softc *sc);
/* Returns true if radar detection is enabled. */
int ath_radar_is_enabled(struct ath_softc *sc);
/* Read the radar pulse detection parameters. */
void ath_radar_get_params(struct ath_softc *sc, RADAR_PARAM *rp);
/* Update the radar pulse detection parameters.
* If rp is NULL, defaults are used for all fields.
* If any member of rp is set to RADAR_PARAM_USE_DEFAULT, the default
* is used for that field. */
void ath_radar_set_params(struct ath_softc *sc, RADAR_PARAM *rp);
/* Update channel's DFS flags based upon whether DFS is required */
int ath_radar_correct_dfs_flags(struct ath_softc *sc, HAL_CHANNEL *hchan);
/* Returns true if DFS is required for the regulatory domain, country and
* combination in use. */
int ath_radar_is_dfs_required(struct ath_softc *sc, HAL_CHANNEL *hchan);
/* Maximum number of radar pulse recorded */
#define ATH_RADAR_PULSE_NR 100
/* init/done function for radar pulse stuff */
void ath_rp_init(struct ath_softc *sc);
void ath_rp_done(struct ath_softc *sc);
/* Record a radar pulse event in a circular array */
void ath_rp_record(struct ath_softc *sc,
u_int64_t tsf, u_int8_t rssi, u_int8_t width,
HAL_BOOL is_simulated);
/* Print the content of the radar pulse circular array */
void ath_rp_print(struct ath_softc *sc, int analyzed_pulses_only);
void ath_rp_print_mem(struct ath_softc *sc, int analyzed_pulses_only);
/* Empty the radar pulse circular array */
void ath_rp_flush(struct ath_softc *sc);
#endif /* #ifndef _IF_ATH_RADAR_H */
Reference in New Issue View Git Blame Copy Permalink