users-guide.tex

Linux下wifi实现

  The following command retrieves the status of WMM support in the
  driver:
  \bv
  \cmd{iwpriv ath0 get\_wmm}\\
  \mytt{ath0\hspace{32pt}get\_wmm:1}
  \ev
\end{example}

\subsubsection{\mytt{cwmin} - WMM $\mathrm{CW}_{\mathrm{min}}$ Parameter}
\argdesc{3}{0}{Varies}{No}
This command sets the $\mathrm{CW}_{\mathrm{min}}$ WMM parameter for
either the AP or station parameter set.  A description of the AP and
station parameter set and their default values can be found in the WMM
standard.  The \mytt{cwmin} command must be followed by 3 values.  The
first value is the access class (AC) number as defined in
Table~\ref{tab:acvalues} taken from the WMM standard.  The second
value indicates whether the $\mathrm{CW}_{\mathrm{min}}$ value is
intended for the AP or station parameter set.  A value of 0 indicates
the $\mathrm{CW}_{\mathrm{min}}$ is for the AP parameter set.  A value
of 1 indicates the $\mathrm{CW}_{\mathrm{min}}$ is for the station
parameter set.  The third value is the actual value of the
$\mathrm{CW}_{\mathrm{min}}$ in units as described in the WMM
standard.
\begin{table}[h*]
  \centering
  \begin{tabular}{|c|l|} \hline
    AC Number & Access Class Description \\ \hline
    0 & BE - Best Effort \\
    1 & BK - Background \\
    2 & VI - Video \\
    3 & VO - Voice \\ \hline
  \end{tabular}
  \caption{Access class (AC) Values}
  \label{tab:acvalues}
\end{table}
\begin{example}
  The following command sets the $\mathrm{CW}_{\mathrm{min}}$ in the
  station parameter set for the VO AC to 2.
  \bv
  \cmd{iwpriv ath0 cwmin 3 1 2}
  \ev
\end{example}

\subsubsection{\mytt{get\_cwmin} - Get WMM $\mathrm{CW}_{\mathrm{min}}$ Parameter}
\argdesc{2}{1}{N/A}{No}
This command retrieves the $\mathrm{CW}_{\mathrm{min}}$ WMM parameter
for either the AP or station parameter set.  The \mytt{get\_cwmin}
command must be followed by 2 values.  The first value is the access
class (AC) number as defined in Table~\ref{tab:acvalues}.  The second
value indicates whether to retrieve the value from the AP or station
parameter set.  A value of 0 indicates the
$\mathrm{CW}_{\mathrm{min}}$ is from the AP parameter set.  A value of
1 indicates the $\mathrm{CW}_{\mathrm{min}}$ is from the station
parameter set.
\begin{example}
  The following command gets the $\mathrm{CW}_{\mathrm{min}}$ in the
  AP parameter set for the VI AC.
  \bv
  \cmd{iwpriv ath0 get\_cwmin 2 0}\\
  \mytt{ath0\hspace{32pt}get\_cwmax:4}
\ev
\end{example}

\subsubsection{\mytt{cwmax} - WMM $\mathrm{CW}_{\mathrm{max}}$ Parameter}
\argdesc{3}{0}{Varies}{No}
This command sets the $\mathrm{CW}_{\mathrm{max}}$ WMM parameter for
either the AP or station parameter set.  The \mytt{cwmax} command must
be followed by 3 values.  The first value is the access class (AC)
number as defined in Table~\ref{tab:acvalues}.  The second value
indicates whether the $\mathrm{CW}_{\mathrm{max}}$ value is intended
for the AP or station parameter set.  A value of 0 indicates the
$\mathrm{CW}_{\mathrm{max}}$ is for the AP parameter set.  A value of
1 indicates the $\mathrm{CW}_{\mathrm{max}}$ is for the station
parameter set.  The third value is the actual value of the
$\mathrm{CW}_{\mathrm{max}}$ in units as described in the WMM
standard.
\begin{example}
The following command sets the $\mathrm{CW}_{\mathrm{max}}$ in the
AP parameter set for the BK AC to 5.
\bv
\cmd{iwpriv ath0 cwmax 1 0 5}
\ev
\end{example}

\subsubsection{\mytt{get\_cwmax} - Get WMM $\mathrm{CW}_{\mathrm{max}}$ Parameter}
\argdesc{2}{1}{N/A}{No}
This command retrieves the $\mathrm{CW}_{\mathrm{max}}$ WMM parameter
for either the AP or station parameter set. The \mytt{get\_cwmax}
command must be followed by 2 values.  The first value is the access
class (AC) number as defined in Table~\ref{tab:acvalues}.  The second
value indicates whether to retrieve the value from the AP or Station
parameter set. A value of 0 indicates the $\mathrm{CW}_{\mathrm{max}}$
is from the AP parameter set.  A value of 1 indicates the
$\mathrm{CW}_{\mathrm{max}}$ is from the station parameter set.
\begin{example}
  The following command gets the $\mathrm{CW}_{\mathrm{max}}$ in the
  station parameter set for the BE AC.
  \bv
  \cmd{iwpriv ath0 get\_cwmax 0 1}\\
  \mytt{ath0\hspace{32pt}get\_cwmax:10}
  \ev
\end{example}

\subsubsection{\mytt{txoplimit} - WMM TxOp Limit Parameter}
\argdesc{3}{0}{Varies}{No}
This command sets the TxOp limit WMM parameter for either the AP or
station parameter set.  The \mytt{txoplimit} command must be followed
by 3 values.  The first value is the access class (AC) number as
defined in Table~\ref{tab:acvalues}.  The second value indicates
whether the TxOp limit is intended for the AP or station parameter
set.  A value of 0 indicates the TxOp limit is for the AP parameter
set.  A value of 1 indicates the TxOp limit is for the station
parameter set.  The third value is the actual value of the TxOp limit
in units as described in the WMM standard.
\begin{example}
  The following command sets the TxOp limit in the AP parameter set
  for the BE AC to 1024.
  \bv
  \cmd{iwpriv ath0 txoplimit 0 0 1024}
  \ev
\end{example}

\subsubsection{\mytt{get\_txoplimit} - Get WMM TxOp Limit Parameter}
\argdesc{2}{1}{N/A}{No}
This command retrieves the TxOp Limit WMM parameter for either the AP
or station parameter set. The \mytt{get\_txoplimit} command must be
followed by 2 values.  The first value is the access class (AC) number
as defined in Table~\ref{tab:acvalues}.  The second value indicates
whether to retrieve the value from the AP or station parameter set. A
value of 0 indicates the TxOp limit is from the AP parameter set.  A
value of 1 indicates the TxOp limit is from the station parameter set.
\begin{example}
  The following command gets the TxOp limit in the station parameter
  set for the BE AC.
  \bv
  \cmd{iwpriv ath0 get\_txoplimit 0 1}\\
  \mytt{ath0\hspace{32pt}get\_txoplimit:2048}
  \ev
\end{example}

\subsubsection{\mytt{aifs} - WMM AIFS Parameter}
\argdesc{3}{0}{Varies}{No}
This command sets the AIFS WMM parameter for either the AP or station
parameter set.  The \mytt{aifs} command must be followed by 3 values.
The first value is the access class (AC) number as defined in
Table~\ref{tab:acvalues}.  The second value indicates whether the AIFS
is intended for the AP or station parameter set.  A value of 0
indicates the AIFS is for the AP parameter set.  A value of 1
indicates the AIFS is for the station parameter set.  The third value
is the actual AIFS value in units as described in the WMM standard.
\begin{example}
  The following command sets the AIFS value in the AP parameter set
  for the BE AC to 3.
  \bv
  \cmd{iwpriv ath0 aifs 0 0 3}
  \ev
\end{example}

\subsubsection{\mytt{get\_aifs} - Get WMM AIFS Parameter}
\argdesc{2}{1}{N/A}{No}
This command retrieves the AIFS WMM parameter for either the AP
or station parameter set. The \mytt{get\_aifs} command must be
followed by 2 values.  The first value is the access class (AC) number
as defined in Table~\ref{tab:acvalues}.  The second value indicates
whether to retrieve the value from the AP or station parameter set. A
value of 0 indicates the AIFS value is from the AP parameter set.  A
value of 1 indicates the AIFS value is from the station parameter set.
\begin{example}
  The following command gets the AIFS value in the station parameter
  set for the BE AC.
  \bv
  \cmd{iwpriv ath0 get\_aifs 0 1}\\
  \mytt{ath0\hspace{32pt}get\_aifs:2}
  \ev
\end{example}

\subsubsection{\mytt{acm} - WMM ACM Bit Value}
\argdesc{3}{0}{Varies}{No}
This command sets the ACM bit value in the WMM parameters for the
station parameter set.  The \mytt{acm} command must be followed by 3
values.  The first value is the access class (AC) number as defined in
Table~\ref{tab:acvalues}.  The second value indicates the ACM bit
value is intended for the station parameter set.  Thus, the second
value should always be 1.  The third value is the desired ACM bit
value (either 0 or 1).
\begin{example}
  The following command sets the ACM bit to 1 in the station parameter
  set for the BE AC.
  \bv
  \cmd{iwpriv ath0 acm 0 1 1}
  \ev
\end{example}

\subsubsection{\mytt{get\_acm} - Get WMM ACM Bit Value}
\argdesc{2}{1}{N/A}{No}
This command retrieves the ACM bit value in the current station WMM
parameter set.  The \mytt{get\_acm} command must be followed by 2
values.  The first value is the access class (AC) number as defined in
Table~\ref{tab:acvalues}.  The second value indicates the ACM value is
from the station parameter set, thus the second value should be 1.
\begin{example}
  The following command gets the ACM bit value in the station
  parameter set for the BE AC.
  \bv
  \cmd{iwpriv ath0 get\_acm 0 1}\\
  \mytt{ath0\hspace{32pt}get\_acm:0}
  \ev
\end{example}

\subsubsection{\mytt{noackpolicy} - WMM NoAck Policy Bit Value}
\argdesc{3}{0}{Varies}{No}
This command sets the NoAck Policy bit value in the WMM parameters for
the AP parameter set.  The \mytt{noackpolicy} command must be followed
by 3 values.  The first value is the access class (AC) number as
defined in Table~\ref{tab:acvalues}.  The second value indicates the
NoAck policy bit value is intended for the AP parameter set.  Thus,
the second value should always be 0.  The third value is the desired
NoAck Policy bit value (either 0 or 1).
\begin{example}
  The following command sets the NoAck Policy bit to 1 in the AP
  parameter set for the BE AC.
  \bv
  \cmd{iwpriv ath0 noackpolicy 0 1 1}
  \ev
\end{example}

\subsubsection{\mytt{get\_noackpolicy} - Get WMM NoAck Policy Bit Value}
\argdesc{2}{1}{N/A}{No}
This command retrieves the NoAck Policy bit value in the current AP
WMM parameter set.  The \mytt{get\_noackpolicy} command must be
followed by 2 values.  The first value is the access class (AC) number
as defined in Table~\ref{tab:acvalues}.  The second value indicates
the NoAck policy value is from the AP parameter set, thus the second
value should be 0.
\begin{example}
  The following command gets the NoAck Policy bit value in the AP
  parameter set for the BE AC.
  \bv
  \cmd{iwpriv ath0 get\_noackpolicy 0 1}\\
  \mytt{ath0\hspace{32pt}get\_noackpolicy:0}
  \ev
\end{example}

\subsubsection{\mytt{ff} - Atheros Fast Frame Support Enable/Disable}
\argdesc{1}{0}{Enabled}{No}
This command enables or disables Atheros Fast Frame support. Passing a
value of 1 to the driver enables fast frames. Passing a value of 0 to
the driver disables fast frames.  By default, fast frames is enabled
\emph{if} the hardware supports fast frames.
\begin{example}
The following command disables Atheros Fast Frame support on
\mytt{ath0}.
\bv
\cmd{iwpriv ath0 ff 0}
\ev
\end{example}

\subsubsection{\mytt{get\_ff} - Get Atheros Fast Frame Support}
\argdesc{0}{1}{N/A}{No}
This command returns whether Atheros Fast Frame support is enabled or
disabled in the driver.
\begin{example}
The following command retrieves the status of Atheros Fast Frame
support in the driver:
\bv
\cmd{iwpriv ath0 get\_ff}\\
\mytt{ath0\hspace{32pt}get\_ff:1}
\ev
\end{example}

\subsubsection{\mytt{xr} - Atheros XR Support Enable/Disable}
\argdesc{1}{0}{Disabled}{No}
This command enables or disables Atheros XR support in the driver.
Passing a value of 1 to the driver enables XR support. Passing a value
of 0 to the driver disables XR support.
\begin{example}
The following command enables Atheros XR support in the driver:
\bv
\cmd{iwpriv ath0 xr 1}
\ev
\end{example}

\subsubsection{\mytt{get\_xr} - Get Atheros XR Support}
\argdesc{0}{1}{N/A}{No}
This command returns whether Atheros XR support is enabled or disabled
in the driver.
\begin{example}
The following command retrieves the status of Atheros XR support in
the driver:
\bv
\cmd{iwpriv ath0 get\_xr}\\
\mytt{ath0\hspace{32pt}get\_xr:1}
\ev
\end{example}

\subsubsection{\mytt{burst} - Atheros SuperA/G Bursting Support
  Enable/Disable}
\argdesc{1}{0}{Enabled}{No}
This command enables or disables Atheros SuperA/G bursting support in the driver.
Passing a value of 1 to the driver enables SuperG bursting. Passing a value
of 0 to the driver disables SuperA/G bursting.
\begin{example}
The following command disables Atheros SuperA/G bursting in the driver:
\bv
\cmd{iwpriv ath0 burst 0}
\ev
\end{example}

\subsubsection{\mytt{get\_burst} - Get Atheros SuperA/G Bursting
  Support}
\argdesc{0}{1}{N/A}{No}
This command returns whether Atheros SuperA/G bursting support is enabled or disabled
in the driver.
\begin{example}
The following command retrieves the status of Atheros SuperA/G bursting support in
the driver:
\bv
\cmd{iwpriv ath0 get\_burst}\\
\mytt{ath0\hspace{32pt}get\_burst:1}
\ev
\end{example}

\subsubsection{\mytt{ar} - Atheros SuperA/G Adaptive Radio (AR) Support Enable/Disable}
\argdesc{1}{0}{Enabled}{No}
This command enables or disables Atheros SuperA/G Adaptive Radio
(AR)support in the driver.  Passing a value of 1 to the driver enables
AR. Passing a value of 0 to the driver disables AR.
\begin{example}
The following command disables Atheros SuperA/G AR in the driver:
\bv
\cmd{iwpriv ath0 ar 0}
\ev
\end{example}

\subsubsection{\mytt{get\_ar} - Get Atheros SuperA/G Adaptive Radio
  (AR) Support}
\argdesc{0}{1}{N/A}{No}
This command returns whether Atheros SuperA/G AR support is enabled or disabled
in the driver.
\begin{example}
The following command retrieves the status of Atheros SuperA/G AR support in
the driver:
\bv
\cmd{iwpriv ath0 get\_ar}\\
\mytt{ath0\hspace{32pt}get\_ar:1}
\ev
\end{example}

\subsubsection{\mytt{compression} - Atheros SuperA/G Compression Support Enable/Disable}
\argdesc{1}{0}{Disabled}{No}
This command enables or disables Atheros SuperA/G compression in the
driver.  Passing a value of 1 to the driver enables hardware
compression. Passing a value of 0 to the driver disables hardware
compression.
\begin{example}
The following command disables Atheros SuperA/G hardware compression in the driver:
\bv