KumiSystems/openwrtv4
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Updated content of wireless.tex, next version will have example configs

Browse source 
SVN-Revision: 6612
This commit is contained in:
Nicholas DePetrillo 2007-03-19 15:35:55 +00:00
parent 510db3b0a6
commit 62c5b1c4ef
1 changed files with 99 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

118
docs/wireless.tex
View file

@ -1,8 +1,9 @@
The WiFi settings are configured in the file \texttt{/etc/config/wireless} The WiFi settings are configured in the file \texttt{/etc/config/wireless}
(currently supported on Broadcom and Atheros). When booting the router for the first time (currently supported on Broadcom and Atheros). When booting the router for the first time
it should detect your card and create a sample configuration that looks like this: it should detect your card and create a sample configuration file. By default '\texttt{option network lan}' is
commented. This prevents unsecured sharing of the network over the wireless interface.
\paragraph{Sample Broadcom wireless config:} \paragraph{Generic Broadcom wireless config:}
\begin{Verbatim} \begin{Verbatim}
config wifi-device "wl0" config wifi-device "wl0"
@ -11,41 +12,97 @@ config wifi-device "wl0"
config wifi-iface config wifi-iface
option device "wl0" option device "wl0"
# option network lan
option mode "ap" option mode "ap"
option ssid "OpenWrt" option ssid "OpenWrt"
option hidden "0" option hidden "0"
option encryption "none" option encryption "none"
\end{Verbatim} \end{Verbatim}
\paragraph{Sample Atheros wireless config:} \paragraph{Generic Atheros wireless config:}
\begin{Verbatim} \begin{Verbatim}
config wifi-device "wifi0" config wifi-device "wifi0"
option type "atheros" option type "atheros"
option channel "5" option channel "5"
option mode "11g" option mode "11g"
config wifi-iface config wifi-iface
option device "wifi0" option device "wifi0"
# option network lan
option mode "ap" option mode "ap"
option ssid "OpenWrt" option ssid "OpenWrt"
option hidden "0" option hidden "0"
option encryption "none" option encryption "none"
\end{Verbatim} \end{Verbatim}
\paragraph{Generic multi-radio Atheros wireless conifg:}
\begin{Verbatim}
config wifi-device wifi0
option type atheros
option channel 1
config wifi-iface
option device wifi0
# option network lan
option mode ap
option ssid OpenWrt_private
option hidden 0
option encryption none
config wifi-device wifi1
option type atheros
option channel 11
config wifi-iface
option device wifi1
# option network lan
option mode ap
option ssid OpenWrt_public
option hidden 1
option encryption none
\end{Verbatim}
There are two types of config sections in this file. The '\texttt{wifi-device}' refers to There are two types of config sections in this file. The '\texttt{wifi-device}' refers to
the physical wifi interface and '\texttt{wifi-iface}' configures a virtual interface on top the physical wifi interface and '\texttt{wifi-iface}' configures a virtual interface on top
of that (if supported by the driver). of that (if supported by the driver).
A full outline of the wireless configuration file with description of each field:
\begin{Verbatim}
config wifi-device wifi device name
option type broadcom, atheros
option country us, uk, fr, de, etc.
option channel 1-14
option maxassoc 1-128 (broadcom only)
option distance 1-n
option mode 11b, 11g, 11a, 11bg (atheros only)
config wifi-iface
option network the interface you want wifi to bridge with
option device wifi0, wifi1, wifi2, wifiN
option mode ap, sta, adhoc, or wds
option ssid ssid name
option bssid bssid address
option encryption none, wep, psk, psk2, wpa, wpa2
option key encryption key
option key1 key 1
option key2 key 2
option key3 key 3
option key4 key 4
option server ip address
option port port
option hidden 0,1
option isolate 0,1
\end{Verbatim}
\paragraph{Options for the \texttt{wifi-device}:} \paragraph{Options for the \texttt{wifi-device}:}
\begin{itemize} \begin{itemize}
\item \texttt{type} \\ \item \texttt{type} \\
The driver to use for this interface. The driver to use for this interface.
\item \texttt{mode} \\
The frequency band (\texttt{b}, \texttt{g}, \texttt{bg}, \texttt{a})
\item \texttt{country} \\ \item \texttt{country} \\
The country code used to determine the regulatory settings. The country code used to determine the regulatory settings.
@ -53,13 +110,27 @@ of that (if supported by the driver).
The wifi channel (e.g. 1-14, depending on your country setting). The wifi channel (e.g. 1-14, depending on your country setting).
\item \texttt{maxassoc} \\ \item \texttt{maxassoc} \\
Maximum number of associated clients Optional: Maximum number of associated clients. This feature is supported only on the broadcom chipset.
\item \texttt{distance} \\
Optional: Distance between the ap and the furthest client in meters. This feature is supported only on the atheros chipset.
\item \texttt{mode} \\
The frequency band (\texttt{b}, \texttt{g}, \texttt{bg}, \texttt{a}). This feature is only supported on the atheros chipset.
\end{itemize} \end{itemize}
\paragraph{Options for the \texttt{wifi-iface}:} \paragraph{Options for the \texttt{wifi-iface}:}
\begin{itemize} \begin{itemize}
\item \texttt{network} \\
Selects the interface section from \texttt{/etc/config/network} to be
used with this interface
\item \texttt{device} \\
Set the wifi device name.
\item \texttt{mode} \\ \item \texttt{mode} \\
Operating mode: Operating mode:
@ -78,35 +149,47 @@ of that (if supported by the driver).
\end{itemize} \end{itemize}
\item \texttt{network} \\ \item \texttt{ssid}
Selects the interface section from \texttt{/etc/config/network} to be Set the SSID to be used on the wifi device.
used with this interface
\item \texttt{bssid}
Set the BSSID address to be used for wds to set the mac address of the other wds unit.
\item \texttt{encryption} \\ \item \texttt{encryption} \\
Encryption setting. Accepts the following values: Encryption setting. Accepts the following values:
\begin{itemize} \begin{itemize}
\item \texttt{none}
\item \texttt{wep}
\item \texttt{psk}, \texttt{psk2} \\ \item \texttt{psk}, \texttt{psk2} \\
WPA(2) Pre-shared Key WPA(2) Pre-shared Key
\item \texttt{wpa}, \texttt{wpa2} \\ \item \texttt{wpa}, \texttt{wpa2} \\
WPA(2) RADIUS WPA(2) RADIUS
\end{itemize} \end{itemize}
\item \texttt{key} (wpa and psk) \\ \item \texttt{key, key1, key2, key3, key4} (wep, wpa and psk) \\
Either the WPA key (PSK mode) or the RADIUS shared secret (WPA RADIUS mode) WEP key, WPA key (PSK mode) or the RADIUS shared secret (WPA RADIUS mode)
\item \texttt{server} (wpa) \\ \item \texttt{server} (wpa) \\
The RADIUS server address The RADIUS server ip address
\item \texttt{port} (wpa) \\ \item \texttt{port} (wpa) \\
The RADIUS server port The RADIUS server port
\item \texttt{hidden} \\
0 broadcasts the ssid; 1 disables broadcasting of the ssid
\item \texttt{isolate} \\
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.
\end{itemize} \end{itemize}
\paragraph{Limitations:} \paragraph{Limitations:}
There are certain limitations when combining modes.
Only the following mode combinations are supported: Only the following mode combinations are supported:
\begin{itemize} \begin{itemize}
@ -117,7 +200,7 @@ Only the following mode combinations are supported:
\item 1x \texttt{adhoc} \item 1x \texttt{adhoc}
\end{itemize} \end{itemize}
WDS links can only be used in pure AP mode and can't use WEP (except when sharing the WDS links can only be used in pure AP mode and cannot use WEP (except when sharing the
settings with the master interface, which is done automatically). settings with the master interface, which is done automatically).
\item \textbf{Atheros}: \\ \item \textbf{Atheros}: \\
@ -126,7 +209,4 @@ Only the following mode combinations are supported:
\item 1-4x \texttt{ap} \item 1-4x \texttt{ap}
\item 1x \texttt{adhoc} \item 1x \texttt{adhoc}
\end{itemize} \end{itemize}
\end{itemize} \end{itemize}