Documente Academic
Documente Profesional
Documente Cultură
PRELIMINARY
March 2010
PRELIMINARY
Notice
The information in this document has been carefully reviewed and is believed to be accurate. Nonetheless,
this document is subject to change without notice, and Atheros Communications, Inc. (Atheros) assumes no
responsibility for any inaccuracies that may be contained in this document, and makes no commitment to
update or to keep current the contained information, or to notify a person or organization of any updates.
Atheros reserves the right to make changes, at any time, in order to improve reliability, function or design
and to attempt to supply the best product possible. Atheros does not represent that products described
herein are free from patent infringement or from any other third party right.
No part of this document may be reproduced, adapted or transmitted in any form or by any means,
electronic or mechanical, for any purpose, except as expressly set forth in a written agreement signed by
Atheros. Atheros or its affiliates may have patents or pending patent applications, trademarks, copyrights,
maskwork rights or other intellectual property rights that apply to the ideas, material and information
expressed herein. No license to such rights is provided except as expressly set forth in a written agreement
signed by Atheros.
ATHEROS MAKES NO WARRANTIES OF ANY KIND WITH REGARD TO THE CONTENT OF THIS
DOCUMENT. IN NO EVENT SHALL ATHEROS BE LIABLE FOR DIRECT, INDIRECT, SPECIAL,
INCIDENTAL SPECULATORY OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR
INABILITY TO USE THIS PRODUCT OR DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBLITY
OF SUCH DAMAGES. IN PARTICULAR, ATHEROS SHALL NOT HAVE LIABILITY FOR ANY
HARDWARE, SOFTWARE, OR DATA TRANSMITTED OR OTHERWISE USED WITH THE PRODUCT,
INCLUDING THE COSTS OF REPAIRING, REPLACING, INTEGRATING, INSTALLING OR
RECOVERING SUCH HARDWARE, SOFTWARE OR DATA. ATHEROS SPECIFICALLY DISCLAIMS THE
IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE AS
THEY MIGHT OTHERWISE APPLY TO THIS DOCUMENT AND TO THE IDEAS, MATERIAL AND
INFORMATION EXPRESSED HEREIN.
PRELIMINARY
Revision History
Revision
Description of Changes
March 2010
Add AR92x7 and WB197 information; added figure 2-7 for open
loop designs
June 2009
March 2010
iii
iii
PRELIMINARY
PRELIMINARY
Contents
Preface .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
1 Overview
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 2-9
2-10
2-12
2-13
2-14
ART Commands . . . . . . . . . . . . . . .
Toggle Mode (o) . . . . . . . . . . . . .
Load EEPROM Calibration (e). . . . .
Continuous Transmit Options (c) . . .
Power Control . . . . . . . . . . .
Continuous RF Receive Options (r) . .
Link Test (l) . . . . . . . . . . . . . . .
Throughput Menu (T) . . . . . . . . .
EEPROM Function (p) . . . . . . . . .
Switch Test Card (s) . . . . . . . . . . .
Manufacturing Test & Calibration (m)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-15
2-15
2-15
2-16
2-16
2-18
2-19
2-20
2-21
2-21
2-22
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2-5
2-5
2-6
2-6
2-7
2-7
2-8
2-9
Contents v
March 2010 v
PRELIMINARY
3-1
PRELIMINARY
Preface
This document is intended to provide a description of the installation and
operation of the Atheros Radio Test (ART) application.
ART is a manufacturing and radio evaluation tool that can be used with the
Atheros family of devices.
Chapter 2
Chapter 3
Audience
This document is intended for users of ART who will be performing radio
evaluation or setting up a manufacturing flow with the Atheros AR92xx and
later.
Preface
March 2010
vii
vii
PRELIMINARY
Additional Resources
Atheros Reference Design hardware, software, and documentation contain
proprietary information of Atheros Communications, Inc., and are provided
under a license agreement containing restrictions on use and disclosure, and
are also protected by copyright law. Reverse engineering of this hardware,
software, or documentation is prohibited.
These resources should be referenced regarding topics that are not addressed
in this document:
PRELIMINARY
Chapter
1
Overview
The AR92xx Atheros Radio Test (ART) is a tool used for radio evaluation and
manufacturing tests. It performs various transmission tests, receive and link
tests, and calibrates and tests adapters during a manufacturing flow.
NOTE: All information related to EEPROM for Reference Designs based on the
AR92xx, and unless otherwise specified, applies to the Flash memory in AR92xxAP
Access Point Reference Designs based on the AR92xx chipsets
AR92xx ART supports:
A utilities menu for register access and other miscellaneous utilities (see
Utility Menu (u) on page 2-23).
This version of ART supports only AR92xx. Older versions of ART must be
used for other adapters.
Overview
March 2010
1-1
1-1
1 Chapter
1-2
1-2
PRELIMINARY
PRELIMINARY
Chapter
2
ART Reference Guide for
AR92xx-Based Devices
The AR92xx Atheros Radio Test (ART) utility provides tests that can evaluate
the performance and functionality of Atheros AR92xx 802.11n chipsets. ART
serves as both an evaluation tool and a manufacturing test tool. This chapter
describes how to install and run ART.
Installation
NOTE: The ANWI driver with the ART 802.11n release must be used. If an ANWI
driver from a previous release is installed, it should be updated by running the install
batch file, installing the adapter and then rebooting the system, before the new
ANWI driver takes effect.
To install ART:
1. Copy files from the art\bin release directory to a directory on the system
that will contain the Atheros adapter. It is best to install ART before
installing the adapter.
2. Copy or refer to the ART driver release directory art_driver\bin. These
directories contain the Windows Vista driver and the Windows XP driver.
Both directories contain the driver and batch files needed to install the
driver for either operating system.
2-1
2-1
2 Chapter
PRELIMINARY
NOTE: The batch file assumes that Windows 2000 is installed in C:\winnt and
Windows XP is installed in C:\Windows. If this is not where the OS is installed,
change the batch file to copy to the system32\drivers and inf OS directories.
A scan for new hardware changes within Windows installs an instance of
Atheros AR5002 Anwi Diagnostics Kernel Driver, as shown in Figure 2-1
2-2
2-2
PRELIMINARY
Chapter
ART Operation
The current version of ART operates only within the Windows 2000,
Windows XP, or Windows Vista environment, and runs as a console mode
application. ART tests run with AR92xx adapters including APs. Client
adapters should be part of the system running ART. To run with an AP,
commands are sent from a Windows host machine to the AP over Ethernet.
To start the ART utility for client cards, enter the command ART on the
system containing the client adapter. Figure 2-2 shows the initial ART menu.
NOTE: ART checks whether the adapter has already been calibrated. If so, it
automatically loads the EEPROM settings on startup.
2-3
2-3
2 Chapter
PRELIMINARY
1.2.3.4 is the IP address of the remote stations and the ID identifies which .eep
file should be loaded for this card. \ctlprog programs CTLs from the target
power file into EEPROM, \targetprog programs the target powers into
EEPROM, \macprog allows reprogramming of the MAC address in
EEPROM, and \instance specifies which of the multiple cards in the system
ART should execute on.
2-4
2-4
See Example Run on page 2-8 for more details on the \remote option.
See Running ART with Multiple Radios on page 2-9 for more details on
the \instance option.
See Determining the .eep File to Use on page 2-12 for more details on
the \id option.
PRELIMINARY
Chapter
LAN
WLAN
Interface
Ethernet
Interface
Ethernet
Interface
WLAN
Interface
OS
OS
ART Utility
ART Client
HOST PC
AP
NOTE: Access point (AP) refers to Atheros Access Point Reference Designs.
2-5
2-5
2 Chapter
PRELIMINARY
AP Setup
Bringing up the ART utility on an AP requires:
1. An AP board with appropriate RF module. For example, PB42 or PB44
with an 802.11n MB board. RF module is embedded on AP91/AP93.
2. A serial port module for the JP1 connector.
3. A terminal system with terminal emulation software, such as
HyperTerminal or Minicom.
4. A straight through serial cable, male to female.
5. An ethernet cable.
6. A server system with a TFTP server to download ART client application.
Connect the ethernet ports of ethernet switch and AP WAN. Connect the
serial cable between the Terminal system and the AP. Set the properties of
serial port to baud rate: 115200, data bits: 8, parity: none, stop bits: 1, flow
control: none.
Network Addresses
The ART client communicates with the ART application running on a host PC
using TCP/IP sockets. Default ethernet MAC address that comes with our SW
releases are 00:03:7F:FF:FF:FE or 00:03:7F:FF:FF:FF. It may be necessary to
change these default address if you have another device connected in your
network with same address. MAC address can be modified at boot loader
prompt using a command provided with BSP.
Default ethernet IP address is 192.168.1.2. You can change it by using ifconfig
utility in Linux prompt. By default WAN interface is bridged with the LAN
and WLAN interfaces. Example command to change ethernet IP address
> ifconfig br0 10.10.12.242
This command changes the Ethernet IP address to 10.10.12.242.
2-6
2-6
PRELIMINARY
Chapter
Where x is either 1 or 2. Use 1 to connect to radio on PCI slot number zero and
use 2 to connect to radio on PCI slot 2. Default instance is 1.
2-7
2-7
2 Chapter
PRELIMINARY
Example Run
The example shown below is for an AP with IP Address 10.10.12.242
connected on radio of PCI slot number zero.
->art \remote=10.10.12.242 \instance=1\
Figure 2-4 shows the DOS console window that appears when the PC Host
ART utility is started. The error and debug messages printed by the ART
client appear on a hyper terminal.
2-8
2-8
PRELIMINARY
Chapter
Figure 2-5 shows the AP serial terminal window when the ART utility is started on the host.
2-9
2-9
2 Chapter
PRELIMINARY
subsystemID filename
0x309a ar9280nx_hb92_0.eep
#SiGe FEM
0x3099 ar9280nx_xb92_0.eep
#SiGe FEM
0x3091 ar9280ng_hb91.eep
0x3097 ar9280ng_xb91.eep
0x2091 ar9280ng_mb91.eep
0x2096 ar9280nx_mb92_1.eep
#SiGe FEM, xtalreg off
0xa094 ar9280apna_ap94.eep
#ap94 5G radio
0xa095 ar9280apng_ap94.eep
#ap94 2G radio
0x2093 ar9280ng_mb93.eep
0xa096 ar9280apna_ap96.eep
#ap96 5G radio
0xa097 ar9280apng_ap96.eep
#ap96 2G radio
0xa093 ar9283apng_ap93.eep
0x309d ar9280ng_hb93.eep
#olpc
0x309f ar9280ng_hb93_1x2.eep #olpc
0xa09b ar9283apng_ap93b.eep
0xa098 ar9280ng_mx96.eep
0xa099 ar9280na_mx96.eep
0x30a1 ar9285nx_hb95.eep
0x30a2 ar9285nx_xb95.eep
0x30a3 ar9280nx_dt92_0.eep
0xa091 ar9280apng_ap91.eep
0x30aa ar9285nx_wb0195sa.eep
0x30ab ar9285nx_wb0195da.eep
The channel, HT40, logging, and mode settings take effect at the initial
execution of ART. If any of these are changed within the application, then the
new value takes effect for the remainder of the ART session.
2-10
2-10
PRELIMINARY
Chapter
NOTE: The link test rate grouping must be set to Use Artsetup before the
RATE_MASKS will be applied.
Table 2-1. RATE_MASK Encoding Per Rate
Rate Encoding by Mode
Mask
802.11a
802.11g
HT20
HT40
0x01
6 Mbps
6 Mbps
MCS 0
MCS 0
0x02
9 Mbps
9 Mbps
MCS 1
MCS 1
0x04
12 Mbps
12 Mbps
MCS 2
MCS 2
0x08
18 Mbps
18 Mbps
MCS 3
MCS 3
0x10
24 Mbps
24 Mbps
MCS 4
MCS 4
0x20
36 Mbps
36 Mbps
MCS 5
MCS 5
0x40
48 Mbps
48 Mbps
MCS 6
MCS 6
0x80
54 Mbps
54 Mbps
MCS 7
MCS 7
0x100
N/A
1 Mbps Long
MCS 8
MCS 8
0x200
N/A
2 Mbps Long
MCS 9
MCS 9
0x400
N/A
2 Mbps Short
MCS 10
MCS 10
0x800
N/A
MCS 11
MCS 11
0x1000
N/A
MCS 12
MCS 12
0x2000
N/A
11 Mbps Long
MCS 13
MCS 13
0x4000
N/A
11 Mbps Short
MCS 14
MCS 14
0x8000
N/A
N/A
MCS 15
MCS 15
If an adapter has been calibrated with power tables, ART automatically loads
and runs with the EEPROM information. Cancel this automatic EEPROM
load by setting the flag EEPROM_LOAD_OVERRIDE.
The EEPROM contains adapter-specific settings needed for the adapter to
perform optimally. Before the adapter programs the EEPROM, it reads these
settings from the adapter-specific .eep file, and uses the setting CFG_TABLE
to associate the adapter subsystem ID with the appropriate .eep file. Using the
subsystem ID rather than the EEP lookup table (in the file artsetup.txt) allows
any adapter subsystem ID to associate to the correct configuration settings to
load in the absence of an EEPROM load. If the .eep files are resident in a
different directory, then the adapter uses the setting EEP_FILE_DIR to specify
an alternative.
2-11
2-11
2 Chapter
PRELIMINARY
Table 2-2. .eep Filenames for Atheros AR92xx based 802.11n Reference Designs
.eep Filename
Subsystem
ID
Reference Board Description
ar9280ng_mb91.eep
0x2091
ar9280nx_mb92_0.eep
0x2092
AR928xNX 2/5 GHz 802.11n Mini PCI Reference Design with FEM from
source 2
ar9280ng_mb93.eep
0x2093
ar9280nx_mb92.eep
0x2094
AR928xNX 2/5 GHz 802.11n Mini PCI Reference Design with FEM from
source 1
ar9287ng_mb97.eep
0x2099
ar9280ng_hb91.eep
0x3091
ar9280nx_hb92.eep
0x3092
AR928xNX 2/5 GHz 802.11n PCIE Half-Mini Card Reference Design with
FEM from source 1
ar9280ng_hb93.eep
0x3092
ar9280nx_xb92.eep
0x3096
AR928xNX 2/5 GHz 802.11n PCIE Reference Mini Card Design with FEM
from source 1
ar9280ng_xb91.eep
0x3097
ar9280nx_xb92_0.eep
0x3099
AR928xNX 2/5 GHz 802.11n PCIE Mini Card Reference Design with FEM
from source 2
ar9280nx_hb92_0.eep
0x309A
AR928xNX 2/5 GHz 802.11n PCIE Half-Mini Card Reference Design with
FEM from source 2
ar9285nx_hb95.eep
0x30A1
ar9285nx_xb95.eep
0x30A2
ar9280nx_dt92_0.eep
0x30A3
ar9287ng_hb97_0.eep
0x30A4
ar9285nx_wb0195sa.eep
0x30AA
ar9285nx_wb0195da.eep
0x30AB
ar9287ng_wb197.eep
0x30B0
2-12
2-12
PRELIMINARY
Chapter
Table 2-2. .eep Filenames for Atheros AR92xx based 802.11n Reference Designs (continued)
Subsystem
ID
Reference Board Description
.eep Filename
ar9280apng_ap91.eep
0xA091
ar9283apng_ap93.eep
0xA093
ar9280apna_ap94.eep
0xA094
5 GHz version of the .eep file for AR9002AP-4XHF Dual Band Dual
Concurrent AR7100-based AP with Fast Ethernet
ar9280apng_ap94.eep
0xA095
2 GHz version of the .eep file for AR9002AP-4XHF Dual Band Dual
Concurrent AR7100-based AP with Fast Ethernet
ar9280apna_ap96.eep
0xA096
5 GHz version of the .eep file for AR9002AP-4XHG Dual Band Dual
Concurrent AR7100-based AP with GB Ethernet
ar9280apng_ap96.eep
0xA097
2 GHz version of the .eep file for AR9002AP-4XHG Dual Band Dual
Concurrent AR7100-based AP with GB Ethernet
ar9280ng_mx96.eep
0xA098
2 GHz version of the .eep file for AR928x 4XN Dual Band Dual Concurrent
with customized Mini PCI signal interface
ar9280na_mx96.eep
0xA099
5 GHz version of the .eep file for AR928x 4XN Dual Band Dual Concurrent
with customized Mini PCI signal interface
ar9283apng_ap93b.eep
0xA09B
The command line option \ID overrides this mechanism and uses the
subsystem ID it is given on the command line as the lookup to the
CFG_TABLE entries.
2-13
2-13
2 Chapter
PRELIMINARY
The first subsection is for registers that are not mode-specific, and uses two
columns: one for the name of the field, and one for the value of the field.
The second subsection, identified by the @MODE: MODE_SPECFIC tag, is for
registers that change values between modes. It uses columns containing the
field name and values for 802.11a, 802.11a HT20/HT40, 802.11g, and 802.11g
HT20/HT40 modes. The 5th column, 11g turbo is present in the table for
backward compatibility but is not used by AR92xx adapters.
2-14
2-14
PRELIMINARY
Chapter
ART Commands
Once art.exe is executed, a menu with test options appears. To run a test, press
the character key assigned to the test option. For example, press c to run the
continuous transmit test.
============================================
| Test Harness Main Options:
|
|
c - (C)ontinuous transmit mode
|
|
r - Continuous RF (R)eceive mode
|
|
l - (L)ink test menu
|
|
t - (T)hroughput test menu
|
|
o - Toggle M(o)de
|
|
h - C(h)ain Menu
|
|
e - Load (E)EPROM Calibration
|
|
s - (S)witch test card
|
|
m - (M)anufacturing/Calibration Test
|
|
p - EE(P)ROM function
|
|
g - Enable lo(g)ging
|
|
u - (U)tility Menu
|
|
i - (N)oise Immunity Menu
|
|
q - (Q)uit
|
============================================
NOTE: The text on this menu applies to what action occurs if selecting the menu.
For example, when the menu states Load EEPROM, then the EEPROM values are not
currently loaded. When the menu states Ignore EEPROM, then the EEPROM values are
currently loaded.
2-15
2-15
2 Chapter
PRELIMINARY
Menu items in red are not always available and depend on which modes are
enabled. If HT40 mode is enabled, the ability to experiment with the control
and extension 20MHz sub-channels, is enabled. Interframe spacing control is
only available in FRAME mode and enables the user to control the output
duty cycle. In addition to allowing the user to control the duty cycle, FRAME
mode also differs from TX99 in that the packet size varies so that each of the
rates have the same transmit time per packet (i.e., slow rates send a smaller
packet than the faster rates).
Power Control
To obtain accurate power control within 0.5 dBm, ensure that the EEPROM
calibration information has been loaded from the main menu, then use the c
and f options from this menu. Once selected, the power value shown by the
software is the measurable power output by the reference design. To gain
accurate power output it is important that the EEPROM calibration
information be loaded. The calibration calculates which PDADC values will
produce the desired power level, then loads these values into the power table
in the device, where each entry is a step of 0.5 dBm. The software then points
to the appropriate entry in this table to set the power. Note that the maximum
power output will be limited by the capabilities of the adapter.
2-16
2-16
PRELIMINARY
Chapter
Figure 2-7 applies to AR92x7 and WB197 designs using an open-loop power
control scheme. The Tx power control algorithm adjusts the Tx gain based on
the chip temperature for systematic gain variations over temperature.
2-17
2-17
2 Chapter
PRELIMINARY
NOTE: This is not a data receive mode. Receive information is not reflected on
screen. It is intended for instrumentation measurement only.
=================================================================
| Continous RF Receive Options
|
|
p - Increase Center Frequency by 10 MHz (P inc by 100 MHz) |
|
l - Decrease Center Frequency by 10 MHz (L dec by 100 MHz) |
|
4 - Toggle HT40 Mode
|
|
i - Increase rx Gain (I inc by 10)
|
|
j - Decrease rx Gain (J dec by 10)
|
| ESC - exit
|
=================================================================
2-18
2-18
PRELIMINARY
Chapter
Menu items in red are not always available and depend on the whether HT40
has been enabled.
2-19
2-19
2 Chapter
PRELIMINARY
Menu items in red are not always available. If power override is off, the ability
to toggle external power is available, but not the ability to adjust gainI. If
power override is on, the ability to change gainI is available, but no external
power control. The ability to increment the fixed gain is only available when
dynamic optimization is inactive
NOTE: For the slower rates it is recommended to set the number of packets to 5000
for the test to complete in a reasonable amount of time.
2-20
2-20
PRELIMINARY
Chapter
NOTE: The Blank EEPROM programming mode (P) programs EEPROM locations 0
through 0xBE using the values in the file atheros-eep.txt and the subsystem ID
specified in the file artsetup.txt. The same functionality occurs when using the
\prog ART command line option.
NOTE: To load an EAR file into EEPROM, the adapter must be calibrated to set up the
EEPROM location that specifies the start of the EAR.
2-21
2-21
2 Chapter
PRELIMINARY
2-22
2-22
PRELIMINARY
Chapter
2-23
2-23
2 Chapter
2-24
2-24
PRELIMINARY
PRELIMINARY
Chapter
3
ART Extensions For
Command Line Testing
This chapter describes the extensions added to enable running of tests from
the command line.
Additional Commands
ART versions 2.5+ include tests that can run from the command line, and
therefore are incorporated into scripts for batch runs. These additional
command line options are supported:
C:\art> art \golden \txtest \rxtest \beacon=NN-NN-NN-NN-NN-NN
\tptestup \tptestdown \macaddr \ch=NNNNx,NNNNx \chain=0|1|2
\goldant=a|b|m \iterations=N \log
ART supports six test types: txtest, rxtest, tptest (up and down), macaddr,
beacon and SSID test. One, some, or all of these tests can be specified on the
command line and run one after the other. The order of the tests is fixed.
Changing the order of the tests on the command line does not change the
order in which the tests run. Table 3-1 on page 3-2 describes each command
line option.
3-1
3-1
3 Chapter
PRELIMINARY
Description
\golden
Make this station the golden unit for the transmit and receive link tests.
When in golden mode, other command line options are ignored and the
golden unit sits in an infinite loop waiting for connection from a device
under test (DUT).
\txtest
Perform a transmit link test, with this station (DUT) as the transmitter, and
another station running in golden mode as the receiver. The DUT displays
the test statistics accumulated by the golden receiver.
\rxtest
Perform a receive link test, with this station (DUT) as the receiver, and
another station running in golden mode as the transmitter. The DUT
displays the test statistics of the packets it receives.
\tptestdown
\macaddr
Perform a simple test on this stations wireless MAC address. This test
verifies that the MAC address lies within the range specified in the file
arttest.txt by the MAC_ADDRESS_MIN and MAC_ADDRESS_MAX
parameters.
\ch=NNNNx,NNNNx...
Specify a list of channels and modes to perform the command line tests
for. NNNN is the channel value in MHz and x is the mode. Specify any
number of channels (including modes). Each test on the command line
performs on every channel in the channel list.
a
802.11a
802.11b
802.11g
ofdm@2.4 GHz
802.11a Turbo
802.11g Turbo
\chain=0|1|2
Specify which antenna path to turn on. Valid selections for the AR5008
family requires that chain 0 must be turned on.
\goldant=a|b|m
Specify which antenna on the golden station to perform the test at.
Valid selections are:
3-2
3-2
Antenna A
Antenna B
Both A and B
PRELIMINARY
Chapter
Description
\ant=a|b|m
Specify which antenna on the DUT station to perform the test at.
Valid selections are:
a
Antenna A
Antenna B
Both A and B
\log=logfilename
\iterations=N
\backup=filename
\restore=filename
\eepcomp=value
\ssid=ssid_string
Look for beacons from the specified SSID string. Note that the string is
case sensitive. Compare RSSI of received beacons against threshold
specified in ARTTEST.TXT or on the command line. This command will
scan many frequencies as defined by the scanning command line option.
\scan=<fast|full>
Specifies which frequencies to look for beacons for the SSID command.
Fast scan for 2 GHz mode
\rssi=xx
\rdlt=xx
Set the RSSI delta between chains to compare against received packets.
\log=filename
\mode=<a|g>
5 GHz mode
2 GHz mode
3-3
3-3
3 Chapter
PRELIMINARY
Examples
The command line:
C:\art> art \txtest \rxtest \ch=5300a,2412b \ant=m \iterations=10
performs the transmit and receive test at channel 5300 in 802.11a mode, and at
2412 in 802.11b mode. Each test and each channel runs first on antenna A,
then on antenna B. Each transmit test and receive test runs for ten iterations.
The command:
C:\art> art \golden
causes this station to enter golden station mode, where it waits on a DUT to
initiate a transmit (Tx) or receive (Rx) test. It is not necessary to list any
channels for the golden station, because at the start of each test the DUT sends
the channel and test information to the golden unit.
The command:
C:\art> art \beacon=00-12-23-ab-cd-ef \ch=5280a
causes the station to listen on channel 5280 in mode 802.11a for beacons with
the BSSID of 00-12-34-ab-cd-ef.
The command:
c:\art> art \tptestup \tptestdown \ch=5360a,2412g \ant=m \goldant=m
performs the throughput uplink and downlink at channel 5360 in 802.11a and
at channel 2412 in 802.11g. Each test and each channel performs on each of the
DUT and golden antenna combinations.
Test Configurations
The tests described in Additional Commands are configured through
parameters specified in the file arttest.txt. This file controls parameters for
how the tests run and for the criteria to meet for the tests to pass. Table 3-2
describes these parameters.
Description
NUM_ITERATIONS
NUM_PACKETS
For the beacon test, this specifies how many beacons to receive. For the
transmit and link tests, this specifies how many packets per rate to transmit.
Valid values range from 1 to 100.
PACKET_SIZE
Specifies the size of each packet transmitted in the link tests. The beacon test
ignores this parameter.
TP_PACKET_SIZE
TP_RATE_MASK
Specifies which rates to perform the throughput test for. The rate mask uses the
format specified in RATE_MASK in the file artsetup.txt.
BEACON_TIMEOUT
Time in milliseconds that the beacon test should wait to receive the expected
number of beacons.
3-4
3-4
PRELIMINARY
Chapter
Description
TP_NUM_PACKETS
TP_CCK_NUM_PACKETS
Specifies the number of CCK packets to send during the throughput menu. For
speed reasons, it is sometimes a good idea to make this less than
TP_NUM_PACKETS.
5G_SIDE_CHANNEL
Specifies which frequency (in MHz) to use for the DUT to golden test
synchronization packets for 802.11a tests.
2G_SIDE_CHANNEL
Specifies which frequency (in MHz) to use for the DUT to golden test
synchronization packets for 802.11b tests.
MAC_ADDRESS_MIN
The minimum MAC address in the range used by the MAC address test.
Specify this in the format
NN-NN-NN-NN-NN-NN.
MAC_ADDRESS_MAX
Maximum MAC address in the range used by the MAC address test. Specify
this in the format
NN-NN-NN-NN-NN-NN.
PER_THRESHOLD
Specifies how many good packets, per rate, to receive in the link tests for the
test to pass. This parameter is ignored for the beacon test.
TP_THRESHOLD_11A
Specifies how many good OFDM packets per rate to receive in the throughput
tests for the test to pass.
TP_THRESHOLD_11B
Specifies how many good CCK packets per rate to receive in the throughput
tests for the test to pass.
PPM_MIN
The minimum acceptable PPM value, per iteration, for the test to pass. This
value is only used in the link tests, and is ignored in the beacon test.
PPM_MAX
The maximum acceptable PPM value, per iteration, for the test to pass. This
value is only used in the link tests, and is ignored for the beacon test.
RSSI_THRESHOLD_11a_antA
RSSI_THRESHOLD_11b_antA
RSSI_THRESHOLD_11g_antA
RSSI_THRESHOLD_11a_antB
RSSI_THRESHOLD_11b_antB
RSSI_THRESHOLD_11g_antB
CRC_THRESHOLD
Specifies the maximum number of packets with CRC errors, per iteration, to
receive for the test to pass. This value is only used in the link tests, and is
ignored for the beacon test.
BEACON_TIMEOUT
Specifies how long (in milliseconds) the beacon test should wait to receive the
required number of beacons before timing out in error. Calculate a reasonable
timeout value based on the number of beacons expected and the beacon
interval for the BSS. This value is only used in the beacon tests, and is ignored
for the link test.
EEP_SINGLE_LOCATION
3-5
3-5
COMPANY CONFIDENTIAL
Subject to Change without Notice