68e8e04e93
o major overhaul of the way channels are handled: channels are now
fully enumerated and uniquely identify the operating characteristics;
these changes are visible to user applications which require changes
o make scanning support independent of the state machine to enable
background scanning and roaming
o move scanning support into loadable modules based on the operating
mode to enable different policies and reduce the memory footprint
on systems w/ constrained resources
o add background scanning in station mode (no support for adhoc/ibss
mode yet)
o significantly speedup sta mode scanning with a variety of techniques
o add roaming support when background scanning is supported; for now
we use a simple algorithm to trigger a roam: we threshold the rssi
and tx rate, if either drops too low we try to roam to a new ap
o add tx fragmentation support
o add first cut at 802.11n support: this code works with forthcoming
drivers but is incomplete; it's included now to establish a baseline
for other drivers to be developed and for user applications
o adjust max_linkhdr et. al. to reflect 802.11 requirements; this eliminates
prepending mbufs for traffic generated locally
o add support for Atheros protocol extensions; mainly the fast frames
encapsulation (note this can be used with any card that can tx+rx
large frames correctly)
o add sta support for ap's that beacon both WPA1+2 support
o change all data types from bsd-style to posix-style
o propagate noise floor data from drivers to net80211 and on to user apps
o correct various issues in the sta mode state machine related to handling
authentication and association failures
o enable the addition of sta mode power save support for drivers that need
net80211 support (not in this commit)
o remove old WI compatibility ioctls (wicontrol is officially dead)
o change the data structures returned for get sta info and get scan
results so future additions will not break user apps
o fixed tx rate is now maintained internally as an ieee rate and not an
index into the rate set; this needs to be extended to deal with
multi-mode operation
o add extended channel specifications to radiotap to enable 11n sniffing
Drivers:
o ath: add support for bg scanning, tx fragmentation, fast frames,
dynamic turbo (lightly tested), 11n (sniffing only and needs
new hal)
o awi: compile tested only
o ndis: lightly tested
o ipw: lightly tested
o iwi: add support for bg scanning (well tested but may have some
rough edges)
o ral, ural, rum: add suppoort for bg scanning, calibrate rssi data
o wi: lightly tested
This work is based on contributions by Atheros, kmacy, sephe, thompsa,
mlaier, kevlo, and others. Much of the scanning work was supported by
Atheros. The 11n work was supported by Marvell.
280 lines
11 KiB
C
280 lines
11 KiB
C
/*-
|
|
* Copyright (c) 2001 Atsushi Onoe
|
|
* Copyright (c) 2002-2007 Sam Leffler, Errno Consulting
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, 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 DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
#ifndef _NET80211__IEEE80211_H_
|
|
#define _NET80211__IEEE80211_H_
|
|
|
|
enum ieee80211_phytype {
|
|
IEEE80211_T_DS, /* direct sequence spread spectrum */
|
|
IEEE80211_T_FH, /* frequency hopping */
|
|
IEEE80211_T_OFDM, /* frequency division multiplexing */
|
|
IEEE80211_T_TURBO, /* high rate OFDM, aka turbo mode */
|
|
IEEE80211_T_HT, /* high throughput, full GI */
|
|
};
|
|
#define IEEE80211_T_CCK IEEE80211_T_DS /* more common nomenclature */
|
|
|
|
/* XXX not really a mode; there are really multiple PHY's */
|
|
enum ieee80211_phymode {
|
|
IEEE80211_MODE_AUTO = 0, /* autoselect */
|
|
IEEE80211_MODE_11A = 1, /* 5GHz, OFDM */
|
|
IEEE80211_MODE_11B = 2, /* 2GHz, CCK */
|
|
IEEE80211_MODE_11G = 3, /* 2GHz, OFDM */
|
|
IEEE80211_MODE_FH = 4, /* 2GHz, GFSK */
|
|
IEEE80211_MODE_TURBO_A = 5, /* 5GHz, OFDM, 2x clock */
|
|
IEEE80211_MODE_TURBO_G = 6, /* 2GHz, OFDM, 2x clock */
|
|
IEEE80211_MODE_STURBO_A = 7, /* 5GHz, OFDM, 2x clock, static */
|
|
IEEE80211_MODE_11NA = 8, /* 5GHz, w/ HT */
|
|
IEEE80211_MODE_11NG = 9, /* 2GHz, w/ HT */
|
|
};
|
|
#define IEEE80211_MODE_MAX (IEEE80211_MODE_11NG+1)
|
|
|
|
enum ieee80211_opmode {
|
|
IEEE80211_M_STA = 1, /* infrastructure station */
|
|
IEEE80211_M_IBSS = 0, /* IBSS (adhoc) station */
|
|
IEEE80211_M_AHDEMO = 3, /* Old lucent compatible adhoc demo */
|
|
IEEE80211_M_HOSTAP = 6, /* Software Access Point */
|
|
IEEE80211_M_MONITOR = 8, /* Monitor mode */
|
|
IEEE80211_M_WDS = 2 /* WDS link */
|
|
};
|
|
#define IEEE80211_OPMODE_MAX (IEEE80211_M_MONITOR+1)
|
|
|
|
/*
|
|
* 802.11g/802.11n protection mode.
|
|
*/
|
|
enum ieee80211_protmode {
|
|
IEEE80211_PROT_NONE = 0, /* no protection */
|
|
IEEE80211_PROT_CTSONLY = 1, /* CTS to self */
|
|
IEEE80211_PROT_RTSCTS = 2, /* RTS-CTS */
|
|
};
|
|
|
|
/*
|
|
* Authentication mode.
|
|
*/
|
|
enum ieee80211_authmode {
|
|
IEEE80211_AUTH_NONE = 0,
|
|
IEEE80211_AUTH_OPEN = 1, /* open */
|
|
IEEE80211_AUTH_SHARED = 2, /* shared-key */
|
|
IEEE80211_AUTH_8021X = 3, /* 802.1x */
|
|
IEEE80211_AUTH_AUTO = 4, /* auto-select/accept */
|
|
/* NB: these are used only for ioctls */
|
|
IEEE80211_AUTH_WPA = 5, /* WPA/RSN w/ 802.1x/PSK */
|
|
};
|
|
|
|
/*
|
|
* Roaming mode is effectively who controls the operation
|
|
* of the 802.11 state machine when operating as a station.
|
|
* State transitions are controlled either by the driver
|
|
* (typically when management frames are processed by the
|
|
* hardware/firmware), the host (auto/normal operation of
|
|
* the 802.11 layer), or explicitly through ioctl requests
|
|
* when applications like wpa_supplicant want control.
|
|
*/
|
|
enum ieee80211_roamingmode {
|
|
IEEE80211_ROAMING_DEVICE= 0, /* driver/hardware control */
|
|
IEEE80211_ROAMING_AUTO = 1, /* 802.11 layer control */
|
|
IEEE80211_ROAMING_MANUAL= 2, /* application control */
|
|
};
|
|
|
|
/*
|
|
* Channels are specified by frequency and attributes.
|
|
*/
|
|
struct ieee80211_channel {
|
|
uint32_t ic_flags; /* see below */
|
|
uint16_t ic_freq; /* setting in Mhz */
|
|
uint8_t ic_ieee; /* IEEE channel number */
|
|
int8_t ic_maxregpower; /* maximum regulatory tx power in dBm */
|
|
int8_t ic_maxpower; /* maximum tx power in .5 dBm */
|
|
int8_t ic_minpower; /* minimum tx power in .5 dBm */
|
|
/* NB: hole, to be used for dfs */
|
|
};
|
|
|
|
#define IEEE80211_CHAN_MAX 255
|
|
#define IEEE80211_CHAN_BYTES 32 /* howmany(IEEE80211_CHAN_MAX, NBBY) */
|
|
#define IEEE80211_CHAN_ANY 0xffff /* token for ``any channel'' */
|
|
#define IEEE80211_CHAN_ANYC \
|
|
((struct ieee80211_channel *) IEEE80211_CHAN_ANY)
|
|
|
|
/* bits 0-3 are for private use by drivers */
|
|
/* channel attributes */
|
|
#define IEEE80211_CHAN_TURBO 0x00010 /* Turbo channel */
|
|
#define IEEE80211_CHAN_CCK 0x00020 /* CCK channel */
|
|
#define IEEE80211_CHAN_OFDM 0x00040 /* OFDM channel */
|
|
#define IEEE80211_CHAN_2GHZ 0x00080 /* 2 GHz spectrum channel. */
|
|
#define IEEE80211_CHAN_5GHZ 0x00100 /* 5 GHz spectrum channel */
|
|
#define IEEE80211_CHAN_PASSIVE 0x00200 /* Only passive scan allowed */
|
|
#define IEEE80211_CHAN_DYN 0x00400 /* Dynamic CCK-OFDM channel */
|
|
#define IEEE80211_CHAN_GFSK 0x00800 /* GFSK channel (FHSS PHY) */
|
|
#define IEEE80211_CHAN_GSM 0x01000 /* 900 MHz spectrum channel */
|
|
#define IEEE80211_CHAN_STURBO 0x02000 /* 11a static turbo channel only */
|
|
#define IEEE80211_CHAN_HALF 0x04000 /* Half rate channel */
|
|
#define IEEE80211_CHAN_QUARTER 0x08000 /* Quarter rate channel */
|
|
#define IEEE80211_CHAN_HT20 0x10000 /* HT 20 channel */
|
|
#define IEEE80211_CHAN_HT40U 0x20000 /* HT 40 channel w/ ext above */
|
|
#define IEEE80211_CHAN_HT40D 0x40000 /* HT 40 channel w/ ext below */
|
|
|
|
#define IEEE80211_CHAN_HT40 (IEEE80211_CHAN_HT40U | IEEE80211_CHAN_HT40D)
|
|
#define IEEE80211_CHAN_HT (IEEE80211_CHAN_HT20 | IEEE80211_CHAN_HT40)
|
|
|
|
/*
|
|
* Useful combinations of channel characteristics.
|
|
*/
|
|
#define IEEE80211_CHAN_FHSS \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_GFSK)
|
|
#define IEEE80211_CHAN_A \
|
|
(IEEE80211_CHAN_5GHZ | IEEE80211_CHAN_OFDM)
|
|
#define IEEE80211_CHAN_B \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_CCK)
|
|
#define IEEE80211_CHAN_PUREG \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_OFDM)
|
|
#define IEEE80211_CHAN_G \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_DYN)
|
|
#define IEEE80211_CHAN_108A \
|
|
(IEEE80211_CHAN_5GHZ | IEEE80211_CHAN_OFDM | IEEE80211_CHAN_TURBO)
|
|
#define IEEE80211_CHAN_108G \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_OFDM | IEEE80211_CHAN_TURBO)
|
|
#define IEEE80211_CHAN_ST \
|
|
(IEEE80211_CHAN_108A | IEEE80211_CHAN_STURBO)
|
|
|
|
#define IEEE80211_CHAN_ALL \
|
|
(IEEE80211_CHAN_2GHZ | IEEE80211_CHAN_5GHZ | IEEE80211_CHAN_GFSK | \
|
|
IEEE80211_CHAN_CCK | IEEE80211_CHAN_OFDM | IEEE80211_CHAN_DYN | \
|
|
IEEE80211_CHAN_HT)
|
|
#define IEEE80211_CHAN_ALLTURBO \
|
|
(IEEE80211_CHAN_ALL | IEEE80211_CHAN_TURBO | IEEE80211_CHAN_STURBO)
|
|
|
|
#define IEEE80211_IS_CHAN_FHSS(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_FHSS) == IEEE80211_CHAN_FHSS)
|
|
#define IEEE80211_IS_CHAN_A(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_A) == IEEE80211_CHAN_A)
|
|
#define IEEE80211_IS_CHAN_B(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_B) == IEEE80211_CHAN_B)
|
|
#define IEEE80211_IS_CHAN_PUREG(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_PUREG) == IEEE80211_CHAN_PUREG)
|
|
#define IEEE80211_IS_CHAN_G(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_G) == IEEE80211_CHAN_G)
|
|
#define IEEE80211_IS_CHAN_ANYG(_c) \
|
|
(IEEE80211_IS_CHAN_PUREG(_c) || IEEE80211_IS_CHAN_G(_c))
|
|
#define IEEE80211_IS_CHAN_ST(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_ST) == IEEE80211_CHAN_ST)
|
|
#define IEEE80211_IS_CHAN_108A(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_108A) == IEEE80211_CHAN_108A)
|
|
#define IEEE80211_IS_CHAN_108G(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_108G) == IEEE80211_CHAN_108G)
|
|
|
|
#define IEEE80211_IS_CHAN_2GHZ(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_2GHZ) != 0)
|
|
#define IEEE80211_IS_CHAN_5GHZ(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_5GHZ) != 0)
|
|
#define IEEE80211_IS_CHAN_PASSIVE(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_PASSIVE) != 0)
|
|
#define IEEE80211_IS_CHAN_OFDM(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_OFDM) != 0)
|
|
#define IEEE80211_IS_CHAN_CCK(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_CCK) != 0)
|
|
#define IEEE80211_IS_CHAN_GFSK(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_GFSK) != 0)
|
|
#define IEEE80211_IS_CHAN_TURBO(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_TURBO) != 0)
|
|
#define IEEE80211_IS_CHAN_STURBO(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_STURBO) != 0)
|
|
#define IEEE80211_IS_CHAN_DTURBO(_c) \
|
|
(((_c)->ic_flags & \
|
|
(IEEE80211_CHAN_TURBO | IEEE80211_CHAN_STURBO)) == IEEE80211_CHAN_TURBO)
|
|
#define IEEE80211_IS_CHAN_HALF(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HALF) != 0)
|
|
#define IEEE80211_IS_CHAN_QUARTER(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_QUARTER) != 0)
|
|
#define IEEE80211_IS_CHAN_FULL(_c) \
|
|
(((_c)->ic_flags & (IEEE80211_CHAN_QUARTER | IEEE80211_CHAN_HALF)) == 0)
|
|
#define IEEE80211_IS_CHAN_GSM(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_GSM) != 0)
|
|
#define IEEE80211_IS_CHAN_HT(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HT) != 0)
|
|
#define IEEE80211_IS_CHAN_HT20(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HT20) != 0)
|
|
#define IEEE80211_IS_CHAN_HT40(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HT40) != 0)
|
|
#define IEEE80211_IS_CHAN_HT40U(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HT40U) != 0)
|
|
#define IEEE80211_IS_CHAN_HT40D(_c) \
|
|
(((_c)->ic_flags & IEEE80211_CHAN_HT40D) != 0)
|
|
#define IEEE80211_IS_CHAN_HTA(_c) \
|
|
(IEEE80211_IS_CHAN_5GHZ(_c) && \
|
|
((_c)->ic_flags & IEEE80211_CHAN_HT) != 0)
|
|
#define IEEE80211_IS_CHAN_HTG(_c) \
|
|
(IEEE80211_IS_CHAN_2GHZ(_c) && \
|
|
((_c)->ic_flags & IEEE80211_CHAN_HT) != 0)
|
|
|
|
/* ni_chan encoding for FH phy */
|
|
#define IEEE80211_FH_CHANMOD 80
|
|
#define IEEE80211_FH_CHAN(set,pat) (((set)-1)*IEEE80211_FH_CHANMOD+(pat))
|
|
#define IEEE80211_FH_CHANSET(chan) ((chan)/IEEE80211_FH_CHANMOD+1)
|
|
#define IEEE80211_FH_CHANPAT(chan) ((chan)%IEEE80211_FH_CHANMOD)
|
|
|
|
/*
|
|
* 802.11 rate set.
|
|
*/
|
|
#define IEEE80211_RATE_SIZE 8 /* 802.11 standard */
|
|
#define IEEE80211_RATE_MAXSIZE 15 /* max rates we'll handle */
|
|
|
|
struct ieee80211_rateset {
|
|
uint8_t rs_nrates;
|
|
uint8_t rs_rates[IEEE80211_RATE_MAXSIZE];
|
|
};
|
|
|
|
/*
|
|
* 802.11n variant of ieee80211_rateset. Instead
|
|
* legacy rates the entries are MCS rates. We define
|
|
* the structure such that it can be used interchangeably
|
|
* with an ieee80211_rateset (modulo structure size).
|
|
*/
|
|
#define IEEE80211_HTRATE_MAXSIZE 127
|
|
|
|
struct ieee80211_htrateset {
|
|
uint8_t rs_nrates;
|
|
uint8_t rs_rates[IEEE80211_HTRATE_MAXSIZE];
|
|
};
|
|
|
|
/*
|
|
* Roaming state visible to user space. There are two
|
|
* thresholds that control whether roaming is considered;
|
|
* when either is exceeded the 802.11 layer will check
|
|
* the scan cache for another AP. If the cache is stale
|
|
* then a scan may be triggered.
|
|
*/
|
|
struct ieee80211_roam {
|
|
int8_t rssi11a; /* rssi thresh for 11a bss */
|
|
int8_t rssi11b; /* for 11g sta in 11b bss */
|
|
int8_t rssi11bOnly; /* for 11b sta */
|
|
uint8_t pad1;
|
|
uint8_t rate11a; /* rate thresh for 11a bss */
|
|
uint8_t rate11b; /* for 11g sta in 11b bss */
|
|
uint8_t rate11bOnly; /* for 11b sta */
|
|
uint8_t pad2;
|
|
};
|
|
#endif /* _NET80211__IEEE80211_H_ */
|