Utility for creating installable image for the NSLU2.
[openwrt/svn-archive/archive.git] / docs / wireless.tex
1 The WiFi settings are configured in the file \texttt{/etc/config/wireless}
2 (currently supported on Broadcom only). When booting the router for the first time
3 it should detect your card and create a sample configuration that looks like this:
4
5 \begin{Verbatim}
6 config wifi-device "wl0"
7 option type "broadcom"
8 option channel "5"
9
10 config wifi-iface
11 option device "wl0"
12 option mode "ap"
13 option ssid "OpenWrt"
14 option hidden "0"
15 option encryption "none"
16 \end{Verbatim}
17
18 There are two types of config sections in this file. The '\texttt{wifi-device}' refers to
19 the physical wifi interface and '\texttt{wifi-iface}' configures a virtual interface on top
20 of that (if supported by the driver).
21
22 \paragraph{Options for the \texttt{wifi-device}:}
23
24 \begin{itemize}
25 \item \texttt{type} \\
26 The driver to use for this interface.
27
28 \item \texttt{country} \\
29 The country code used to determine the regulatory settings.
30
31 \item \texttt{channel} \\
32 The wifi channel (1-14, depending on your country setting).
33
34 \item \texttt{maxassoc} \\
35 Maximum number of associated clients
36
37 \end{itemize}
38
39 \paragraph{Options for the \texttt{wifi-iface}:}
40
41 \begin{itemize}
42 \item \texttt{mode} \\
43 Operating mode:
44
45 \begin{itemize}
46 \item \texttt{ap} \\
47 Access point mode
48
49 \item \texttt{sta} \\
50 Client mode
51
52 \item \texttt{adhoc} \\
53 Ad-Hoc mode
54
55 \item \texttt{wds} \\
56 WDS point-to-point link
57
58 \end{itemize}
59 \item \texttt{network} \\
60 Selects the interface section from \texttt{/etc/config/network} to be
61 used with this interface
62
63 \item \texttt{encryption} \\
64 Encryption setting. Accepts the following values:
65
66 \begin{itemize}
67 \item \texttt{psk}, \texttt{psk2} \\
68 WPA(2) Pre-shared Key
69
70 \item \texttt{wpa}, \texttt{wpa2} \\
71 WPA(2) RADIUS
72
73 \end{itemize}
74
75 \item \texttt{key} (wpa and psk) \\
76 Either the WPA key (PSK mode) or the RADIUS shared secret (WPA RADIUS mode)
77
78 \item \texttt{server} (wpa) \\
79 The RADIUS server address
80
81 \item \texttt{port} (wpa) \\
82 The RADIUS server port
83
84 \end{itemize}
85
86 \paragraph{Limitations:}
87
88 \begin{itemize}
89 \item \textbf{Broadcom}: \\
90 Only the following mode combinations are supported:
91
92 \begin{itemize}
93 \item 1x \texttt{sta}, 0-3x \texttt{ap}
94 \item 1-4x \texttt{ap}
95 \item 1x \texttt{adhoc}
96 \end{itemize}
97
98 WDS links can only be used in pure AP mode and can't use WEP (except when sharing the
99 settings with the master interface, which is done automatically).
100
101 \end{itemize}
102
103