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