diff options
author | Felix Fietkau <nbd@openwrt.org> | 2006-10-16 02:38:08 +0000 |
---|---|---|
committer | Felix Fietkau <nbd@openwrt.org> | 2006-10-16 02:38:08 +0000 |
commit | 3cfe09bc994ea0426daf118526655a381bf0d229 (patch) | |
tree | 57753894055ab5794b027dbd1fb0ce0104860f19 /docs/wireless.tex | |
parent | 7f2f0bc577fafc6c17c8896b954fe2bf7948881a (diff) | |
download | upstream-3cfe09bc994ea0426daf118526655a381bf0d229.tar.gz upstream-3cfe09bc994ea0426daf118526655a381bf0d229.tar.bz2 upstream-3cfe09bc994ea0426daf118526655a381bf0d229.zip |
add documentation for /etc/config/wireless and improve formatting
git-svn-id: svn://svn.openwrt.org/openwrt/trunk@5149 3c298f89-4303-0410-b956-a3cf2f4a3e73
Diffstat (limited to 'docs/wireless.tex')
-rw-r--r-- | docs/wireless.tex | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/docs/wireless.tex b/docs/wireless.tex new file mode 100644 index 0000000000..279ee55158 --- /dev/null +++ b/docs/wireless.tex @@ -0,0 +1,103 @@ +The WiFi settings are configured in the file \texttt{/etc/config/wireless} +(currently supported on Broadcom only). When booting the router for the first time +it should detect your card and create a sample configuration that looks like this: + +\begin{Verbatim} +config wifi-device wl0 + option type broadcom + option channel 5 + +config wifi-iface + option device wl0 + option mode ap + option ssid OpenWrt + option hidden 0 + option encryption none +\end{Verbatim} + +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 +of that (if supported by the driver). + +\paragraph{Options for the \texttt{wifi-device}:} + +\begin{itemize} + \item \texttt{type} \\ + The driver to use for this interface. + + \item \texttt{country} \\ + The country code used to determine the regulatory settings. + + \item \texttt{channel} \\ + The wifi channel (1-14, depending on your country setting). + + \item \texttt{maxassoc} \\ + Maximum number of associated clients + +\end{itemize} + +\paragraph{Options for the \texttt{wifi-iface}:} + +\begin{itemize} + \item \texttt{mode} \\ + Operating mode: + + \begin{itemize} + \item \texttt{ap} \\ + Access point mode + + \item \texttt{sta} \\ + Client mode + + \item \texttt{adhoc} \\ + Ad-Hoc mode + + \item \texttt{wds} \\ + WDS point-to-point link + + \end{itemize} + \item \texttt{network} \\ + Selects the interface section from \texttt{/etc/config/network} to be + used with this interface + + \item \texttt{encryption} \\ + Encryption setting. Accepts the following values: + + \begin{itemize} + \item \texttt{psk}, \texttt{psk2} \\ + WPA(2) Pre-shared Key + + \item \texttt{wpa}, \texttt{wpa2} \\ + WPA(2) RADIUS + + \end{itemize} + + \item \texttt{key} (wpa and psk) \\ + Either the WPA key (PSK mode) or the RADIUS shared secret (WPA RADIUS mode) + + \item \texttt{server} (wpa) \\ + The RADIUS server address + + \item \texttt{port} (wpa) \\ + The RADIUS server port + +\end{itemize} + +\paragraph{Limitations:} + +\begin{itemize} + \item \textbf{Broadcom}: \\ + Only the following mode combinations are supported: + + \begin{itemize} + \item 1x \texttt{sta}, 0-3x \texttt{ap} + \item 1-4x \texttt{ap} + \item 1x \texttt{adhoc} + \end{itemize} + + WDS links can only be used in pure AP mode and can't use WEP (except when sharing the + settings with the master interface, which is done automatically). + +\end{itemize} + + |