kernel: refresh 2.6.30 patches

[openwrt.git] / docs / wireless.tex

diff --git a/docs/wireless.tex b/docs/wireless.tex
index 0f87810..16dcd68 100644 (file)
--- a/docs/wireless.tex
+++ b/docs/wireless.tex
@@ -5,7 +5,7 @@ commented. This prevents unsecured sharing of the network over the wireless inte
 
 Each wireless driver has its own configuration script in \texttt{/lib/wifi/driver\_name.sh} which handles
 driver specific options and configurations. This script is also calling driver specific binaries like wlc for
 
 Each wireless driver has its own configuration script in \texttt{/lib/wifi/driver\_name.sh} which handles
 driver specific options and configurations. This script is also calling driver specific binaries like wlc for

-Broadcom, or hostapd and wpa\_supplicant for atheros.
+Broadcom, or hostapd and wpa\_supplicant for atheros and mac80211.

 
 The reason for using such architecture, is that it abstracts the driver configuration. 
 
 
 The reason for using such architecture, is that it abstracts the driver configuration. 
 


@@ -31,7 +31,7 @@ config wifi-iface
 config wifi-device      "wifi0"
     option type         "atheros"
     option channel      "5"
 config wifi-device      "wifi0"
     option type         "atheros"
     option channel      "5"

-    option agmode      "11g"
+    option hwmode      "11g"

 
 config wifi-iface
     option device       "wifi0"
 
 config wifi-iface
     option device       "wifi0"


@@ -98,19 +98,20 @@ config wifi-device    wifi device name
     option country    us, uk, fr, de, etc.
     option channel    1-14
     option maxassoc   1-128 (broadcom only)
     option country    us, uk, fr, de, etc.
     option channel    1-14
     option maxassoc   1-128 (broadcom only)

-    option distance   1-n
-    option agmode     11b, 11g, 11a, 11bg (atheros only)
+    option distance   1-n (meters)
+    option hwmode     11b, 11g, 11a, 11bg (atheros, mac80211)

     option rxantenna  0,1,2 (atheros, broadcom)
     option txantenna  0,1,2 (atheros, broadcom)
     option rxantenna  0,1,2 (atheros, broadcom)
     option txantenna  0,1,2 (atheros, broadcom)

+    option txpower  transmission power in dBm

 
 config wifi-iface
 
 config wifi-iface

-    option network  the interface you want wifi to bridge with 
+    option network  the interface you want wifi to bridge with

     option device   wifi0, wifi1, wifi2, wifiN
     option device   wifi0, wifi1, wifi2, wifiN

-    option mode     ap, sta, adhoc, monitor, or wds
-    option txpower  transmission power in dBm
+    option mode     ap, sta, adhoc, monitor, mesh, or wds
+    option txpower  (deprecated) transmission power in dBm

     option ssid     ssid name
     option bssid    bssid address
     option ssid     ssid name
     option bssid    bssid address

-    option encryption none, wep, psk, psk2, wpa, wpa2 
+    option encryption none, wep, psk, psk2, wpa, wpa2

     option key      encryption key
     option key1     key 1
     option key2     key 2
     option key      encryption key
     option key1     key 1
     option key2     key 2


@@ -119,7 +120,9 @@ config wifi-iface
     option server   ip address
     option port     port
     option hidden   0,1
     option server   ip address
     option port     port
     option hidden   0,1

-    option isolate  0,1
+    option isolate  0,1        (broadcom)
+    option doth     0,1        (atheros, broadcom)
+    option wmm      0,1        (atheros, broadcom)

 \end{Verbatim}
 
 \paragraph{Options for the \texttt{wifi-device}:}
 \end{Verbatim}
 
 \paragraph{Options for the \texttt{wifi-device}:}


@@ -135,22 +138,25 @@ config wifi-iface
         The wifi channel (e.g. 1-14, depending on your country setting).
 
     \item \texttt{maxassoc} \\
         The wifi channel (e.g. 1-14, depending on your country setting).
 
     \item \texttt{maxassoc} \\

-        Optional: Maximum number of associated clients. This feature is supported only on the broadcom chipset.
+        Optional: Maximum number of associated clients. This feature is supported only on the Broadcom chipsets.

 
     \item \texttt{distance} \\
 
     \item \texttt{distance} \\

-       Optional: Distance between the ap and the furthest client in meters. This feature is supported only on the atheros chipset.
+       Optional: Distance between the ap and the furthest client in meters. This feature is supported only on the Atheros chipsets.

 
        \item \texttt{mode} \\
 
        \item \texttt{mode} \\

-               The frequency band (\texttt{b}, \texttt{g}, \texttt{bg}, \texttt{a}). This feature is only supported on the atheros chipset.
+               The frequency band (\texttt{b}, \texttt{g}, \texttt{bg}, \texttt{a}). This feature is only supported on the Atheros chipsets.

 
     \item \texttt{diversity} \\
 
     \item \texttt{diversity} \\

-       Optional: Enable diversity for the Wi-Fi device. This feature is supported only on the atheros chipset.
+       Optional: Enable diversity for the Wi-Fi device. This feature is supported only on the Atheros chipsets.

 
     \item \texttt{rxantenna} \\
 
     \item \texttt{rxantenna} \\

-       Optional: Antenna identifier (0, 1 or 2) for reception. This feature is supported by atheros and some broadcom chipsets.
+       Optional: Antenna identifier (0, 1 or 2) for reception. This feature is supported by Atheros and some Broadcom chipsets.

 
     \item \texttt{txantenna} \\
 
     \item \texttt{txantenna} \\

-       Optional: Antenna identifier (0, 1 or 2) for emission. This feature is supported by atheros and some broadcom chipsets.
+       Optional: Antenna identifier (0, 1 or 2) for emission. This feature is supported by Atheros and some Broadcom chipsets.
+
+    \item \texttt{txpower}
+       Set the transmission power to be used. The amount is specified in dBm.

 
 \end{itemize}
 
 
 \end{itemize}
 


@@ -180,6 +186,9 @@ config wifi-iface
             \item \texttt{monitor} \\
                 Monitor mode
 
             \item \texttt{monitor} \\
                 Monitor mode
 

+           \item \texttt{mesh} \\
+               Mesh Point mode (802.11s)
+

             \item \texttt{wds} \\
                 WDS point-to-point link
 
             \item \texttt{wds} \\
                 WDS point-to-point link
 


@@ -192,7 +201,7 @@ config wifi-iface
        Set the BSSID address to be used for wds to set the mac address of the other wds unit.
 
     \item \texttt{txpower}
        Set the BSSID address to be used for wds to set the mac address of the other wds unit.
 
     \item \texttt{txpower}

-       Set the transmission power to be used. The amount is specified in dBm.
+       (Deprecated, set in wifi-device) Set the transmission power to be used. The amount is specified in dBm.

 
     \item \texttt{encryption} \\
         Encryption setting. Accepts the following values:
 
     \item \texttt{encryption} \\
         Encryption setting. Accepts the following values:


@@ -223,8 +232,34 @@ config wifi-iface
         Optional: Isolation is a mode usually set on hotspots that limits the clients to communicate only with the AP and not with other wireless clients.
         0 disables ap isolation (default); 1 enables ap isolation.
 
         Optional: Isolation is a mode usually set on hotspots that limits the clients to communicate only with the AP and not with other wireless clients.
         0 disables ap isolation (default); 1 enables ap isolation.
 

+    \item \texttt{doth} \\
+        Optional: Toggle 802.11h mode.
+        0 disables 802.11h (default); 1 enables it.
+
+    \item \texttt{wmm} \\
+        Optional: Toggle 802.11e mode.
+        0 disables 802.11e (default); 1 enables it.
+

 \end{itemize}
 
 \end{itemize}
 

+\paragraph{Mesh Point}
+
+Mesh Point (802.11s) is only supported by some mac80211 drivers. It requires the iw package
+to be installed to setup mesh links. OpenWrt creates mshN mesh point interfaces. A sample
+configuration looks like this:
+
+\begin{Verbatim}
+config wifi-device      "wlan0"
+    option type                "mac80211"
+    option channel      "5"
+
+config wifi-iface
+    option device       "wlan0"
+    option network     lan
+    option mode         "mesh"
+    option mesh_id     "OpenWrt"
+\end{Verbatim}
+

 \paragraph{Wireless Distribution System}
 
 WDS is a non-standard mode which will be working between two Broadcom devices for instance
 \paragraph{Wireless Distribution System}
 
 WDS is a non-standard mode which will be working between two Broadcom devices for instance


@@ -290,8 +325,8 @@ config wifi-iface
 
 OpenWrt supports both 802.1x client and Access Point
 configurations. 802.1x client is only working with
 
 OpenWrt supports both 802.1x client and Access Point
 configurations. 802.1x client is only working with

-Atheros or mac80211 drivers. Configuration only
-supports EAP types TLS, TTLS or PEAP.
+drivers supported by wpa-supplicant. Configuration
+only supports EAP types TLS, TTLS or PEAP.

 
 \subparagraph{EAP-TLS}
 
 
 \subparagraph{EAP-TLS}